feat!: deprecate alias exports in favor of original function names (#5009)

9romise · web-flow · commit e5f74fb454d1 · 2025-09-10T04:24:38.000Z
diff --git a/packages/core/computedAsync/index.ts b/packages/core/computedAsync/index.ts
@@ -160,5 +160,5 @@ export function computedAsync<T>(
   }
 }
 
-// alias
-export { computedAsync as asyncComputed }
+/** @deprecated use `computedAsync` instead */
+export const asyncComputed = computedAsync
diff --git a/packages/core/onClickOutside/directive.ts b/packages/core/onClickOutside/directive.ts
@@ -35,5 +35,5 @@ export const vOnClickOutside: ObjectDirective<
   },
 }
 
-// alias
-export { vOnClickOutside as VOnClickOutside }
+/** @deprecated use `vOnClickOutside` instead */
+export const VOnClickOutside = vOnClickOutside
diff --git a/packages/core/onLongPress/directive.ts b/packages/core/onLongPress/directive.ts
@@ -21,5 +21,5 @@ export const vOnLongPress: ObjectDirective<
   },
 }
 
-// alias
-export { vOnLongPress as VOnLongPress }
+/** @deprecated use `vOnLongPress` instead */
+export const VOnLongPress = vOnLongPress
diff --git a/packages/math/logicAnd/index.ts b/packages/math/logicAnd/index.ts
@@ -12,5 +12,5 @@ export function logicAnd(...args: MaybeRefOrGetter<any>[]): ComputedRef<boolean>
   return computed(() => args.every(i => toValue(i)))
 }
 
-// alias
-export { logicAnd as and }
+/** @deprecated use `logicAnd` instead */
+export const and = logicAnd
diff --git a/packages/math/logicNot/index.ts b/packages/math/logicNot/index.ts
@@ -12,5 +12,5 @@ export function logicNot(v: MaybeRefOrGetter<any>): ComputedRef<boolean> {
   return computed(() => !toValue(v))
 }
 
-// alias
-export { logicNot as not }
+/** @deprecated use `logicNot` instead */
+export const not = logicNot
diff --git a/packages/math/logicOr/index.ts b/packages/math/logicOr/index.ts
@@ -12,5 +12,5 @@ export function logicOr(...args: MaybeRefOrGetter<any>[]): ComputedRef<boolean>
   return computed(() => args.some(i => toValue(i)))
 }
 
-// alias
-export { logicOr as or }
+/** @deprecated use `logicOr` instead */
+export const or = logicOr
diff --git a/packages/shared/computedEager/index.ts b/packages/shared/computedEager/index.ts
@@ -31,5 +31,5 @@ export function computedEager<T>(fn: () => T, options?: ComputedEagerOptions): C
   return readonly(result)
 }
 
-// alias
-export { computedEager as eagerComputed }
+/** @deprecated use `computedEager` instead */
+export const eagerComputed = computedEager
diff --git a/packages/shared/computedWithControl/index.ts b/packages/shared/computedWithControl/index.ts
@@ -75,5 +75,5 @@ export function computedWithControl<T, S>(
   return result
 }
 
-// alias
-export { computedWithControl as controlledComputed }
+/** @deprecated use `computedWithControl` instead */
+export const controlledComputed = computedWithControl
diff --git a/packages/shared/reactify/index.ts b/packages/shared/reactify/index.ts
@@ -36,7 +36,5 @@ export function reactify<T extends AnyFn, K extends boolean = true>(fn: T, optio
   } as any
 }
 
-// alias
-export {
-  reactify as createReactiveFn,
-}
+/** @deprecated use `reactify` instead */
+export const createReactiveFn = reactify
diff --git a/packages/shared/refAutoReset/index.ts b/packages/shared/refAutoReset/index.ts
@@ -43,5 +43,5 @@ export function refAutoReset<T>(defaultValue: MaybeRefOrGetter<T>, afterMs: Mayb
   })
 }
 
-// alias
-export { refAutoReset as autoResetRef }
+/** @deprecated use `refAutoReset` instead */
+export const autoResetRef = refAutoReset
diff --git a/packages/shared/refDebounced/index.ts b/packages/shared/refDebounced/index.ts
@@ -22,8 +22,7 @@ export function refDebounced<T>(value: Ref<T>, ms: MaybeRefOrGetter<number> = 20
   return shallowReadonly(debounced)
 }
 
-// alias
-export {
-  refDebounced as debouncedRef,
-  refDebounced as useDebounce,
-}
+/** @deprecated use `refDebounced` instead */
+export const debouncedRef = refDebounced
+/** @deprecated use `refDebounced` instead */
+export const useDebounce = refDebounced
diff --git a/packages/shared/refThrottled/index.ts b/packages/shared/refThrottled/index.ts
@@ -28,8 +28,7 @@ export function refThrottled<T = any>(value: Ref<T>, delay = 200, trailing = tru
   return throttled as Ref<T>
 }
 
-// alias
-export {
-  refThrottled as throttledRef,
-  refThrottled as useThrottle,
-}
+/** @deprecated use `refThrottled` instead */
+export const throttledRef = refThrottled
+/** @deprecated use `refThrottled` instead */
+export const useThrottle = refThrottled
diff --git a/packages/shared/refWithControl/index.ts b/packages/shared/refWithControl/index.ts
@@ -104,7 +104,5 @@ export function refWithControl<T>(
   )
 }
 
-/**
- * Alias for `refWithControl`
- */
+/** @deprecated use `refWithControl` instead */
 export const controlledRef = refWithControl
diff --git a/packages/shared/watchDebounced/index.ts b/packages/shared/watchDebounced/index.ts
@@ -34,5 +34,5 @@ export function watchDebounced<Immediate extends Readonly<boolean> = false>(
   )
 }
 
-// alias
-export { watchDebounced as debouncedWatch }
+/** @deprecated use `watchDebounced` instead */
+export const debouncedWatch = watchDebounced
diff --git a/packages/shared/watchIgnorable/index.ts b/packages/shared/watchIgnorable/index.ts
@@ -129,5 +129,5 @@ export function watchIgnorable<Immediate extends Readonly<boolean> = false>(
   return { stop, ignoreUpdates, ignorePrevAsyncUpdates }
 }
 
-// alias
-export { watchIgnorable as ignorableWatch }
+/** @deprecated use `watchIgnorable` instead */
+export const ignorableWatch = watchIgnorable
diff --git a/packages/shared/watchPausable/index.ts b/packages/shared/watchPausable/index.ts
@@ -37,5 +37,5 @@ export function watchPausable<Immediate extends Readonly<boolean> = false>(
   return { stop, pause, resume, isActive }
 }
 
-// alias
-export { watchPausable as pausableWatch }
+/** @deprecated use `watchPausable` instead */
+export const pausableWatch = watchPausable
diff --git a/packages/shared/watchThrottled/index.ts b/packages/shared/watchThrottled/index.ts
@@ -37,5 +37,5 @@ export function watchThrottled<Immediate extends Readonly<boolean> = false>(
   )
 }
 
-// alias
-export { watchThrottled as throttledWatch }
+/** @deprecated use `watchThrottled` instead */
+export const throttledWatch = watchThrottled

Original file line number	Diff line number	Diff line change
`@@ -160,5 +160,5 @@ export function computedAsync<T>(`
`160`	`160`	`}`
`161`	`161`	`}`
`162`	`162`
`163`		`-// alias`
`164`		`-export { computedAsync as asyncComputed }`
	`163`	+/** @deprecated use `computedAsync` instead */
	`164`	`+export const asyncComputed = computedAsync`
Original file line number	Diff line number	Diff line change
`@@ -35,5 +35,5 @@ export const vOnClickOutside: ObjectDirective<`
`35`	`35`	`},`
`36`	`36`	`}`
`37`	`37`
`38`		`-// alias`
`39`		`-export { vOnClickOutside as VOnClickOutside }`
	`38`	+/** @deprecated use `vOnClickOutside` instead */
	`39`	`+export const VOnClickOutside = vOnClickOutside`
Original file line number	Diff line number	Diff line change
`@@ -21,5 +21,5 @@ export const vOnLongPress: ObjectDirective<`
`21`	`21`	`},`
`22`	`22`	`}`
`23`	`23`
`24`		`-// alias`
`25`		`-export { vOnLongPress as VOnLongPress }`
	`24`	+/** @deprecated use `vOnLongPress` instead */
	`25`	`+export const VOnLongPress = vOnLongPress`
Original file line number	Diff line number	Diff line change
`@@ -12,5 +12,5 @@ export function logicAnd(...args: MaybeRefOrGetter<any>[]): ComputedRef<boolean>`
`12`	`12`	`return computed(() => args.every(i => toValue(i)))`
`13`	`13`	`}`
`14`	`14`
`15`		`-// alias`
`16`		`-export { logicAnd as and }`
	`15`	+/** @deprecated use `logicAnd` instead */
	`16`	`+export const and = logicAnd`
Original file line number	Diff line number	Diff line change
`@@ -31,5 +31,5 @@ export function computedEager<T>(fn: () => T, options?: ComputedEagerOptions): C`
`31`	`31`	`return readonly(result)`
`32`	`32`	`}`
`33`	`33`
`34`		`-// alias`
`35`		`-export { computedEager as eagerComputed }`
	`34`	+/** @deprecated use `computedEager` instead */
	`35`	`+export const eagerComputed = computedEager`
Original file line number	Diff line number	Diff line change
`@@ -75,5 +75,5 @@ export function computedWithControl<T, S>(`
`75`	`75`	`return result`
`76`	`76`	`}`
`77`	`77`
`78`		`-// alias`
`79`		`-export { computedWithControl as controlledComputed }`
	`78`	+/** @deprecated use `computedWithControl` instead */
	`79`	`+export const controlledComputed = computedWithControl`
Original file line number	Diff line number	Diff line change
`@@ -36,7 +36,5 @@ export function reactify<T extends AnyFn, K extends boolean = true>(fn: T, optio`
`36`	`36`	`} as any`
`37`	`37`	`}`
`38`	`38`
`39`		`-// alias`
`40`		`-export {`
`41`		`- reactify as createReactiveFn,`
`42`		`-}`
	`39`	+/** @deprecated use `reactify` instead */
	`40`	`+export const createReactiveFn = reactify`
Original file line number	Diff line number	Diff line change
`@@ -43,5 +43,5 @@ export function refAutoReset<T>(defaultValue: MaybeRefOrGetter<T>, afterMs: Mayb`
`43`	`43`	`})`
`44`	`44`	`}`
`45`	`45`
`46`		`-// alias`
`47`		`-export { refAutoReset as autoResetRef }`
	`46`	+/** @deprecated use `refAutoReset` instead */
	`47`	`+export const autoResetRef = refAutoReset`