@lytjs/reactivity 5.0.0 → 6.0.0

package/dist/types/signal.d.ts

@@ -1,87 +0,0 @@
-/**
- * Lyt.js Signal 响应式系统
- *
- * 基于 Signal 的细粒度响应式实现（类似 Solid.js / Angular Signals / Preact Signals）。
- * 纯原生零依赖实现，无 DOM / 浏览器 API 依赖。
- *
- * 核心概念：
- *   - Signal: 可写信号，存储值并在变化时通知订阅者
- *   - ComputedSignal: 只读计算信号，自动追踪依赖并惰性求值
- *   - Effect: 副作用，自动追踪依赖并在变化时重新执行
- *   - Batch: 批量更新，延迟通知直到最外层 batch 完成
- *   - Untrack: 在不创建订阅的情况下读取信号
- */
-/** Signal 只读接口 — 调用即读取值 */
-export interface Signal<T> {
-    (): T;
-}
-/** WritableSignal — 可写信号，支持 set / update / dispose */
-export interface WritableSignal<T> extends Signal<T> {
-    set(value: T): void;
-    update(fn: (prev: T) => T): void;
-    /** 销毁信号，释放所有订阅者 */
-    dispose(): void;
-    /** 内部订阅方法（由 Dependency 接口使用） */
-    _subscribe(subscriber: Subscriber): void;
-    /** 内部取消订阅方法（由 Dependency 接口使用） */
-    _unsubscribe(subscriber: Subscriber): void;
-}
-/** ComputedSignal — 只读计算信号 */
-export interface ComputedSignal<T> extends Signal<T> {
-    /** 内部订阅方法（由 Dependency 接口使用） */
-    _subscribe(subscriber: Subscriber): void;
-    /** 内部取消订阅方法（由 Dependency 接口使用） */
-    _unsubscribe(subscriber: Subscriber): void;
-    /** 通知订阅者其依赖已变化 */
-    notify(): void;
-    /** 标记订阅者需要重新计算/执行 */
-    _dirty: boolean;
-}
-/** Effect 清理回调 */
-export type EffectCleanup = () => void;
-/** 订阅者接口（effect 或 computed） */
-interface Subscriber {
-    /** 通知订阅者其依赖已变化 */
-    notify(): void;
-    /** 标记订阅者需要重新计算/执行 */
-    _dirty: boolean;
-}
-/**
- * 创建一个可写信号
- *
- * @param initialValue 初始值
- * @returns WritableSignal 实例
- */
-export declare function signal<T>(initialValue: T): WritableSignal<T>;
-/**
- * 创建一个计算信号（只读、惰性求值）
- *
- * @param fn 计算函数
- * @returns ComputedSignal 实例
- */
-export declare function computed<T>(fn: () => T): ComputedSignal<T>;
-/**
- * 创建副作用
- *
- * @param fn 副作用函数，接收 onCleanup 回调
- * @returns dispose 函数，调用后停止副作用
- */
-export declare function effect(fn: (onCleanup: (cleanup: EffectCleanup) => void) => void): () => void;
-/**
- * 批量更新
- *
- * 在 batch 内的 signal 更新不会立即触发 effect，
- * 而是延迟到最外层 batch 完成后统一执行。
- *
- * @param fn 批量操作函数
- */
-export declare function batch(fn: () => void): void;
-/**
- * 在不创建订阅的情况下执行函数
- *
- * @param fn 要执行的函数
- * @returns 函数返回值
- */
-export declare function untrack<T>(fn: () => T): T;
-export {};
-//# sourceMappingURL=signal.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,2BAA2B;AAC3B,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,IAAI,CAAC,CAAA;CACN;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IAClD,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAChC,mBAAmB;IACnB,OAAO,IAAI,IAAI,CAAA;IACf,gCAAgC;IAChC,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;IACxC,kCAAkC;IAClC,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;CAC3C;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IAClD,gCAAgC;IAChC,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;IACxC,kCAAkC;IAClC,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1C,kBAAkB;IAClB,MAAM,IAAI,IAAI,CAAA;IACd,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,kBAAkB;AAClB,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAA;AAEtC,+BAA+B;AAC/B,UAAU,UAAU;IAClB,kBAAkB;IAClB,MAAM,IAAI,IAAI,CAAA;IACd,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAA;CAChB;AAiCD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAsC5D;AAMD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAgE1D;AAMD;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,KAAK,IAAI,GACxD,MAAM,IAAI,CA6DZ;AAMD;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAU1C;AA4BD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQzC"}

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"}