@lytjs/reactivity 5.0.1 → 6.4.0

package/dist/types/watch.d.ts

@@ -1,125 +0,0 @@
-/**
- * Lyt.js 响应式系统 — 侦听器（Watch）
- *
- * watch 和 watchEffect 用于观察响应式数据的变化并执行副作用。
- *
- * watch:
- *   - 显式指定侦听源（ref/reactive/getter/数组）
- *   - 回调接收新值和旧值
- *   - 默认懒执行（不会立即执行回调）
- *
- * watchEffect:
- *   - 自动收集依赖（不需要显式指定源）
- *   - 立即执行一次
- *   - 回调不接收参数
- *
- * nextTick:
- *   - 在下一个微任务中执行回调
- *   - 等待 DOM 更新后执行
- */
-import { Ref } from './ref';
-import { nextTick as schedulerNextTick } from '@lytjs/common';
-/** watch 回调函数类型 */
-export type WatchCallback<T = any, O = T> = (newValue: T, oldValue: O, onCleanup: (cleanupFn: () => void) => void) => void;
-/** watch 源类型：可以是 ref、reactive 对象、getter 函数或它们的数组 */
-export type WatchSource<T = any> = Ref<T> | (() => T) | {
-    [key: string]: any;
-};
-/** watch 选项 */
-export interface WatchOptions {
-    /** 是否立即执行回调（默认 false） */
-    immediate?: boolean;
-    /** 是否深度侦听（默认 true，对 reactive 对象自动开启） */
-    deep?: boolean;
-    /** 是否在组件卸载时自动停止（预留） */
-    flush?: 'pre' | 'post' | 'sync';
-}
-/** watchEffect 选项 */
-export interface WatchEffectOptions {
-    /** 副作用执行前的回调 */
-    onTrack?: (event: any) => void;
-    /** 副作用触发时的回调 */
-    onTrigger?: (event: any) => void;
-    /** 刷新时机 */
-    flush?: 'pre' | 'post' | 'sync';
-}
-/** watch 停止句柄 */
-export type WatchStopHandle = () => void;
-/**
- * 侦听一个或多个响应式数据源，并在数据变化时执行回调
- *
- * @param source - 侦听源（ref / reactive / getter / 数组）
- * @param cb - 变化时的回调函数，接收 (newValue, oldValue, onCleanup)
- * @param options - 配置选项
- * @returns 停止侦听的函数
- *
- * @example
- * ```ts
- * // 侦听 ref
- * const count = ref(0)
- * const stop = watch(count, (newVal, oldVal) => {
- *   console.log(`count: ${oldVal} -> ${newVal}`)
- * })
- * count.value++  // 输出: count: 0 -> 1
- * stop()  // 停止侦听
- *
- * // 侦听 getter
- * watch(
- *   () => state.count + state.name,
- *   (newVal, oldVal) => console.log(newVal, oldVal)
- * )
- *
- * // 侦听多个源
- * watch([count, name], ([newCount, newName], [oldCount, oldName]) => {
- *   console.log(newCount, newName)
- * })
- *
- * // 立即执行
- * watch(count, (val) => console.log(val), { immediate: true })
- * ```
- */
-export declare function watch<T = any>(source: WatchSource<T> | WatchSource<T>[], cb: WatchCallback<T>, options?: WatchOptions): WatchStopHandle;
-/**
- * 立即运行一个函数，同时响应式地追踪其依赖
- * 当依赖变化时自动重新执行
- *
- * @param fn - 要执行的副作用函数
- * @param options - 配置选项
- * @returns 停止侦听的函数
- *
- * @example
- * ```ts
- * const count = ref(0)
- * const stop = watchEffect(() => {
- *   console.log(`count is: ${count.value}`)
- * })
- * // 立即输出: count is: 0
- * count.value++  // 输出: count is: 1
- * stop()  // 停止侦听
- *
- * // 带清理函数
- * watchEffect((onCleanup) => {
- *   const timer = setInterval(() => console.log('tick'), 1000)
- *   onCleanup(() => clearInterval(timer))  // 依赖变化时清理
- * })
- * ```
- */
-export declare function watchEffect(fn: (onCleanup: (cleanupFn: () => void) => void) => void, options?: WatchEffectOptions): WatchStopHandle;
-/**
- * 在下一个微任务中执行回调
- * 等待当前所有响应式更新完成后再执行
- *
- * @returns Promise
- *
- * @example
- * ```ts
- * await nextTick()
- * // 此时 DOM 已更新完毕
- *
- * nextTick().then(() => {
- *   console.log('更新完成')
- * })
- * ```
- */
-export { schedulerNextTick as nextTick };
-//# sourceMappingURL=watch.d.ts.map

package/dist/types/watch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,EAAS,GAAG,EAAS,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAY,QAAQ,IAAI,iBAAiB,EAAY,MAAM,eAAe,CAAC;AAIlF,mBAAmB;AACnB,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAC1C,QAAQ,EAAE,CAAC,EACX,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,KACvC,IAAI,CAAC;AAEV,oDAAoD;AACpD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,IAC3B,GAAG,CAAC,CAAC,CAAC,GACN,CAAC,MAAM,CAAC,CAAC,GACT;IACE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEN,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uBAAuB;IACvB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CACjC;AAED,qBAAqB;AACrB,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,gBAAgB;IAChB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACjC,WAAW;IACX,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CACjC;AAED,iBAAiB;AACjB,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAuEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,KAAK,CAAC,CAAC,GAAG,GAAG,EAC3B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EACzC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,eAAe,CAqFjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,EACxD,OAAO,GAAE,kBAAuB,GAC/B,eAAe,CAuCjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,iBAAiB,IAAI,QAAQ,EAAE,CAAC"}