wevu 7.2.1 → 7.3.0

package/dist/dev/reactivity/asyncDerivation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"asyncDerivation.mjs","names":[],"sources":["../../../src/reactivity/asyncDerivation.ts"],"sourcesContent":["import { AbortControllerPolyfill } from '@wevu/web-apis/abort'\nimport { batch, onScopeDispose, runWithoutTracking } from './core'\nimport { reactive } from './reactive'\nimport { readonly } from './readonly'\n\n/** 异步派生状态的生命周期阶段。 */\nexport type AsyncDerivationStatus\n  = | 'idle'\n    | 'initial-pending'\n    | 'ready'\n    | 'refreshing'\n    | 'error'\n    | 'disposed'\n\n/** 传给异步加载函数的当前任务上下文。 */\nexport interface AsyncDerivationContext {\n  readonly signal: AbortSignal\n}\n\n/** `useAsyncDerivation()` 的配置。 */\nexport interface UseAsyncDerivationOptions {\n  immediate?: boolean\n}\n\ntype AsyncDerivationIdleState<TStatus extends 'idle' | 'initial-pending' | 'disposed'> = Readonly<{\n  status: TStatus\n  value: undefined\n  error: undefined\n}>\n\ntype AsyncDerivationReadyState<T, TStatus extends 'ready' | 'refreshing'> = Readonly<{\n  status: TStatus\n  value: T\n  error: undefined\n}>\n\ntype AsyncDerivationErrorState<T> = Readonly<{\n  status: 'error'\n  value: T | undefined\n  error: unknown\n}>\n\n/** 模板可观察的只读异步派生状态。 */\nexport type AsyncDerivationState<T>\n  = | AsyncDerivationIdleState<'idle'>\n    | AsyncDerivationIdleState<'initial-pending'>\n    | AsyncDerivationIdleState<'disposed'>\n    | AsyncDerivationReadyState<T, 'ready'>\n    | AsyncDerivationReadyState<T, 'refreshing'>\n    | AsyncDerivationErrorState<T>\n\ntype AsyncDerivationControls = Readonly<{\n  refresh: () => Promise<void>\n  dispose: () => void\n}>\n\n/** 异步派生状态及其非枚举控制方法。 */\nexport type AsyncDerivation<T> = AsyncDerivationState<T> & AsyncDerivationControls\n\ninterface MutableAsyncDerivationState<T> {\n  status: AsyncDerivationStatus\n  value: T | undefined\n  error: unknown\n}\n\ninterface AsyncDerivationCycle {\n  readonly promise: Promise<void>\n  readonly resolve: () => void\n}\n\nconst RESOLVED_PROMISE: Promise<void> = Promise.resolve()\n\nfunction createAsyncDerivationCycle(): AsyncDerivationCycle {\n  let resolve!: () => void\n  const promise = new Promise<void>((settle) => {\n    resolve = settle\n  })\n  return { promise, resolve }\n}\n\n/**\n * 创建面向静态 WXML 数据绑定的异步派生状态。\n * 加载错误通过 `status` 与 `error` 暴露，`refresh()` 始终正常完成。\n */\nexport function useAsyncDerivation<T>(\n  loader: (context: AsyncDerivationContext) => T | PromiseLike<T>,\n  options: UseAsyncDerivationOptions = {},\n): AsyncDerivation<T> {\n  const storage: MutableAsyncDerivationState<T> = {\n    status: 'idle',\n    value: undefined,\n    error: undefined,\n  }\n  const state = reactive(storage)\n  let activeController: AbortController | undefined\n  let activeCycle: AsyncDerivationCycle | undefined\n  let generation = 0\n  let hasValue = false\n  let disposed = false\n\n  function settleLatestCycle(completedGeneration: number) {\n    if (disposed || completedGeneration !== generation) {\n      return\n    }\n    const cycle = activeCycle\n    activeCycle = undefined\n    cycle?.resolve()\n  }\n\n  function commitValue(completedGeneration: number, value: T) {\n    if (disposed || completedGeneration !== generation) {\n      return\n    }\n    activeController = undefined\n    hasValue = true\n    try {\n      batch(() => {\n        state.status = 'ready'\n        state.value = value\n        state.error = undefined\n      })\n    }\n    finally {\n      settleLatestCycle(completedGeneration)\n    }\n  }\n\n  function commitError(completedGeneration: number, error: unknown) {\n    if (disposed || completedGeneration !== generation) {\n      return\n    }\n    activeController = undefined\n    try {\n      batch(() => {\n        state.status = 'error'\n        state.error = error\n        if (!hasValue) {\n          state.value = undefined\n        }\n      })\n    }\n    finally {\n      settleLatestCycle(completedGeneration)\n    }\n  }\n\n  function refresh(): Promise<void> {\n    if (disposed) {\n      return RESOLVED_PROMISE\n    }\n\n    const cycle = activeCycle ?? createAsyncDerivationCycle()\n    activeCycle = cycle\n    const currentGeneration = ++generation\n    const previousController = activeController\n    // eslint-disable-next-line mini-program/no-implicit-runtime-polyfill -- 缺失宿主实现时显式回退兼容层。\n    const Controller = typeof AbortController === 'function' ? AbortController : AbortControllerPolyfill\n    const controller = new Controller() as unknown as AbortController\n    activeController = controller\n    try {\n      previousController?.abort()\n    }\n    catch {\n      // 原生 EventTarget 不把 abort listener 异常传播给调用者，兼容实现保持相同控制流。\n    }\n\n    if (disposed || currentGeneration !== generation) {\n      return cycle.promise\n    }\n\n    batch(() => {\n      state.status = hasValue ? 'refreshing' : 'initial-pending'\n      state.error = undefined\n    })\n\n    if (disposed || currentGeneration !== generation) {\n      return cycle.promise\n    }\n\n    runWithoutTracking(() => {\n      // 自有 Promise 避免原生 Promise 的身份快路径把 then 访问移出收养边界。\n      const task = new Promise<T>((resolve) => {\n        resolve(loader({ signal: controller.signal }))\n      })\n      void task.then(\n        value => commitValue(currentGeneration, value),\n        error => commitError(currentGeneration, error),\n      ).catch((error) => {\n        // 观察者异常交给宿主报告，不改写加载结果，也不阻塞 refresh 的完成。\n        setTimeout(() => {\n          throw error\n        }, 0)\n      })\n    })\n    return cycle.promise\n  }\n\n  function dispose() {\n    if (disposed) {\n      return\n    }\n    disposed = true\n    generation += 1\n    const controller = activeController\n    activeController = undefined\n    try {\n      controller?.abort()\n    }\n    catch {\n      // dispose 必须完成状态清理和 waiter 结算，不能被 listener 异常中断。\n    }\n    try {\n      batch(() => {\n        state.status = 'disposed'\n        state.value = undefined\n        state.error = undefined\n      })\n    }\n    finally {\n      hasValue = false\n      const cycle = activeCycle\n      activeCycle = undefined\n      cycle?.resolve()\n    }\n  }\n\n  Object.defineProperties(storage, {\n    refresh: {\n      value: refresh,\n    },\n    dispose: {\n      value: dispose,\n    },\n  })\n\n  const result = readonly(state) as AsyncDerivation<T>\n  onScopeDispose(dispose)\n  if (options.immediate ?? true) {\n    void refresh()\n  }\n  return result\n}\n"],"mappings":";;;;;;AAsEA,MAAM,mBAAkC,QAAQ,QAAQ;AAExD,SAAS,6BAAmD;CAC1D,IAAI;CAIJ,OAAO;EAAE,aAHW,SAAe,WAAW;GAC5C,UAAU;EACZ,CACe;EAAG;CAAQ;AAC5B;;;;;AAMA,SAAgB,mBACd,QACA,UAAqC,CAAC,GAClB;;CACpB,MAAM,UAA0C;EAC9C,QAAQ;EACR,OAAO;EACP,OAAO;CACT;CACA,MAAM,QAAQ,SAAS,OAAO;CAC9B,IAAI;CACJ,IAAI;CACJ,IAAI,aAAa;CACjB,IAAI,WAAW;CACf,IAAI,WAAW;CAEf,SAAS,kBAAkB,qBAA6B;EACtD,IAAI,YAAY,wBAAwB,YACtC;EAEF,MAAM,QAAQ;EACd,cAAc;EACd,4CAAO,QAAQ;CACjB;CAEA,SAAS,YAAY,qBAA6B,OAAU;EAC1D,IAAI,YAAY,wBAAwB,YACtC;EAEF,mBAAmB;EACnB,WAAW;EACX,IAAI;GACF,YAAY;IACV,MAAM,SAAS;IACf,MAAM,QAAQ;IACd,MAAM,QAAQ;GAChB,CAAC;EACH,UACQ;GACN,kBAAkB,mBAAmB;EACvC;CACF;CAEA,SAAS,YAAY,qBAA6B,OAAgB;EAChE,IAAI,YAAY,wBAAwB,YACtC;EAEF,mBAAmB;EACnB,IAAI;GACF,YAAY;IACV,MAAM,SAAS;IACf,MAAM,QAAQ;IACd,IAAI,CAAC,UACH,MAAM,QAAQ;GAElB,CAAC;EACH,UACQ;GACN,kBAAkB,mBAAmB;EACvC;CACF;CAEA,SAAS,UAAyB;;EAChC,IAAI,UACF,OAAO;EAGT,MAAM,wBAAQ,kEAAe,2BAA2B;EACxD,cAAc;EACd,MAAM,oBAAoB,EAAE;EAC5B,MAAM,qBAAqB;EAG3B,MAAM,aAAa,KADA,OAAO,oBAAoB,aAAa,kBAAkB,yBAC3C;EAClC,mBAAmB;EACnB,IAAI;GACF,mFAAoB,MAAM;EAC5B,kBACM,CAEN;EAEA,IAAI,YAAY,sBAAsB,YACpC,OAAO,MAAM;EAGf,YAAY;GACV,MAAM,SAAS,WAAW,eAAe;GACzC,MAAM,QAAQ;EAChB,CAAC;EAED,IAAI,YAAY,sBAAsB,YACpC,OAAO,MAAM;EAGf,yBAAyB;GAKvB,AAAK,IAHY,SAAY,YAAY;IACvC,QAAQ,OAAO,EAAE,QAAQ,WAAW,OAAO,CAAC,CAAC;GAC/C,CACQ,CAAC,CAAC,MACR,UAAS,YAAY,mBAAmB,KAAK,IAC7C,UAAS,YAAY,mBAAmB,KAAK,CAC/C,CAAC,CAAC,OAAO,UAAU;IAEjB,iBAAiB;KACf,MAAM;IACR,GAAG,CAAC;GACN,CAAC;EACH,CAAC;EACD,OAAO,MAAM;CACf;CAEA,SAAS,UAAU;EACjB,IAAI,UACF;EAEF,WAAW;EACX,cAAc;EACd,MAAM,aAAa;EACnB,mBAAmB;EACnB,IAAI;GACF,2DAAY,MAAM;EACpB,mBACM,CAEN;EACA,IAAI;GACF,YAAY;IACV,MAAM,SAAS;IACf,MAAM,QAAQ;IACd,MAAM,QAAQ;GAChB,CAAC;EACH,UACQ;GACN,WAAW;GACX,MAAM,QAAQ;GACd,cAAc;GACd,4CAAO,QAAQ;EACjB;CACF;CAEA,OAAO,iBAAiB,SAAS;EAC/B,SAAS,EACP,OAAO,QACT;EACA,SAAS,EACP,OAAO,QACT;CACF,CAAC;CAED,MAAM,SAAS,SAAS,KAAK;CAC7B,eAAe,OAAO;CACtB,0BAAI,QAAQ,4EAAa,MACvB,AAAK,QAAQ;CAEf,OAAO;AACT"}
+{"version":3,"file":"asyncDerivation.mjs","names":[],"sources":["../../../src/reactivity/asyncDerivation.ts"],"sourcesContent":["import { AbortControllerPolyfill } from '@wevu/web-apis/abort'\nimport { batch, onScopeDispose, runWithoutTracking } from './core'\nimport { reactive } from './reactive'\nimport { readonly } from './readonly'\n\n/** 异步派生状态的生命周期阶段。 */\nexport type AsyncDerivationStatus\n  = | 'idle'\n    | 'initial-pending'\n    | 'ready'\n    | 'refreshing'\n    | 'error'\n    | 'disposed'\n\n/** 传给异步加载函数的当前任务上下文。 */\nexport interface AsyncDerivationContext {\n  readonly signal: AbortSignal\n}\n\n/** `useAsyncDerivation()` 的配置。 */\nexport interface UseAsyncDerivationOptions {\n  immediate?: boolean\n}\n\ntype AsyncDerivationIdleState<TStatus extends 'idle' | 'initial-pending' | 'disposed'> = Readonly<{\n  status: TStatus\n  value: undefined\n  error: undefined\n}>\n\ntype AsyncDerivationReadyState<T, TStatus extends 'ready' | 'refreshing'> = Readonly<{\n  status: TStatus\n  value: T\n  error: undefined\n}>\n\ntype AsyncDerivationErrorState<T> = Readonly<{\n  status: 'error'\n  value: T | undefined\n  error: unknown\n}>\n\n/** 模板可观察的只读异步派生状态。 */\nexport type AsyncDerivationState<T>\n  = | AsyncDerivationIdleState<'idle'>\n    | AsyncDerivationIdleState<'initial-pending'>\n    | AsyncDerivationIdleState<'disposed'>\n    | AsyncDerivationReadyState<T, 'ready'>\n    | AsyncDerivationReadyState<T, 'refreshing'>\n    | AsyncDerivationErrorState<T>\n\ntype AsyncDerivationControls = Readonly<{\n  refresh: () => Promise<void>\n  dispose: () => void\n}>\n\n/** 异步派生状态及其非枚举控制方法。 */\nexport type AsyncDerivation<T> = AsyncDerivationState<T> & AsyncDerivationControls\n\ninterface MutableAsyncDerivationState<T> {\n  status: AsyncDerivationStatus\n  value: T | undefined\n  error: unknown\n}\n\ninterface AsyncDerivationCycle {\n  readonly promise: Promise<void>\n  readonly resolve: () => void\n}\n\nconst RESOLVED_PROMISE: Promise<void> = Promise.resolve()\n\nfunction createAsyncDerivationCycle(): AsyncDerivationCycle {\n  let resolve!: () => void\n  const promise = new Promise<void>((settle) => {\n    resolve = settle\n  })\n  return { promise, resolve }\n}\n\n/**\n * 创建面向静态 WXML 数据绑定的异步派生状态。\n * 加载错误通过 `status` 与 `error` 暴露，`refresh()` 始终正常完成。\n */\nexport function useAsyncDerivation<T>(\n  loader: (context: AsyncDerivationContext) => T | PromiseLike<T>,\n  options: UseAsyncDerivationOptions = {},\n): AsyncDerivation<T> {\n  const storage: MutableAsyncDerivationState<T> = {\n    status: 'idle',\n    value: undefined,\n    error: undefined,\n  }\n  const state = reactive(storage)\n  let activeController: AbortController | undefined\n  let activeCycle: AsyncDerivationCycle | undefined\n  let generation = 0\n  let hasValue = false\n  let disposed = false\n\n  function settleLatestCycle(completedGeneration: number) {\n    if (disposed || completedGeneration !== generation) {\n      return\n    }\n    const cycle = activeCycle\n    activeCycle = undefined\n    cycle?.resolve()\n  }\n\n  function commitValue(completedGeneration: number, value: T) {\n    if (disposed || completedGeneration !== generation) {\n      return\n    }\n    activeController = undefined\n    hasValue = true\n    try {\n      batch(() => {\n        state.status = 'ready'\n        state.value = value\n        state.error = undefined\n      })\n    }\n    finally {\n      settleLatestCycle(completedGeneration)\n    }\n  }\n\n  function commitError(completedGeneration: number, error: unknown) {\n    if (disposed || completedGeneration !== generation) {\n      return\n    }\n    activeController = undefined\n    try {\n      batch(() => {\n        state.status = 'error'\n        state.error = error\n        if (!hasValue) {\n          state.value = undefined\n        }\n      })\n    }\n    finally {\n      settleLatestCycle(completedGeneration)\n    }\n  }\n\n  function refresh(): Promise<void> {\n    if (disposed) {\n      return RESOLVED_PROMISE\n    }\n\n    const cycle = activeCycle ?? createAsyncDerivationCycle()\n    activeCycle = cycle\n    const currentGeneration = ++generation\n    const previousController = activeController\n    // eslint-disable-next-line mini-program/no-implicit-runtime-polyfill -- 缺失宿主实现时显式回退兼容层。\n    const Controller = typeof AbortController === 'function' ? AbortController : AbortControllerPolyfill\n    const controller = new Controller() as unknown as AbortController\n    activeController = controller\n    try {\n      previousController?.abort()\n    }\n    catch {\n      // 原生 EventTarget 不把 abort listener 异常传播给调用者，兼容实现保持相同控制流。\n    }\n\n    if (disposed || currentGeneration !== generation) {\n      return cycle.promise\n    }\n\n    batch(() => {\n      state.status = hasValue ? 'refreshing' : 'initial-pending'\n      state.error = undefined\n    })\n\n    if (disposed || currentGeneration !== generation) {\n      return cycle.promise\n    }\n\n    runWithoutTracking(() => {\n      // 自有 Promise 避免原生 Promise 的身份快路径把 then 访问移出收养边界。\n      const task = new Promise<T>((resolve) => {\n        resolve(loader({ signal: controller.signal }))\n      })\n      void task.then(\n        value => commitValue(currentGeneration, value),\n        error => commitError(currentGeneration, error),\n      ).catch((error) => {\n        // 观察者异常交给宿主报告，不改写加载结果，也不阻塞 refresh 的完成。\n        setTimeout(() => {\n          throw error\n        }, 0)\n      })\n    })\n    return cycle.promise\n  }\n\n  function dispose() {\n    if (disposed) {\n      return\n    }\n    disposed = true\n    generation += 1\n    const controller = activeController\n    activeController = undefined\n    try {\n      controller?.abort()\n    }\n    catch {\n      // dispose 必须完成状态清理和 waiter 结算，不能被 listener 异常中断。\n    }\n    try {\n      batch(() => {\n        state.status = 'disposed'\n        state.value = undefined\n        state.error = undefined\n      })\n    }\n    finally {\n      hasValue = false\n      const cycle = activeCycle\n      activeCycle = undefined\n      cycle?.resolve()\n    }\n  }\n\n  Object.defineProperties(storage, {\n    refresh: {\n      value: refresh,\n    },\n    dispose: {\n      value: dispose,\n    },\n  })\n\n  const result = readonly(state) as AsyncDerivation<T>\n  onScopeDispose(dispose)\n  if (options.immediate ?? true) {\n    void refresh()\n  }\n  return result\n}\n"],"mappings":";;;;;;AAsEA,MAAM,mBAAkC,QAAQ,QAAQ;AAExD,SAAS,6BAAmD;CAC1D,IAAI;CAIJ,OAAO;EAAE,aAHW,SAAe,WAAW;GAC5C,UAAU;EACZ,CACe;EAAG;CAAQ;AAC5B;;;;;AAMA,SAAgB,mBACd,QACA,UAAqC,CAAC,GAClB;CACpB,MAAM,UAA0C;EAC9C,QAAQ;EACR,OAAO;EACP,OAAO;CACT;CACA,MAAM,QAAQ,SAAS,OAAO;CAC9B,IAAI;CACJ,IAAI;CACJ,IAAI,aAAa;CACjB,IAAI,WAAW;CACf,IAAI,WAAW;CAEf,SAAS,kBAAkB,qBAA6B;EACtD,IAAI,YAAY,wBAAwB,YACtC;EAEF,MAAM,QAAQ;EACd,cAAc;EACd,OAAO,QAAQ;CACjB;CAEA,SAAS,YAAY,qBAA6B,OAAU;EAC1D,IAAI,YAAY,wBAAwB,YACtC;EAEF,mBAAmB;EACnB,WAAW;EACX,IAAI;GACF,YAAY;IACV,MAAM,SAAS;IACf,MAAM,QAAQ;IACd,MAAM,QAAQ;GAChB,CAAC;EACH,UACQ;GACN,kBAAkB,mBAAmB;EACvC;CACF;CAEA,SAAS,YAAY,qBAA6B,OAAgB;EAChE,IAAI,YAAY,wBAAwB,YACtC;EAEF,mBAAmB;EACnB,IAAI;GACF,YAAY;IACV,MAAM,SAAS;IACf,MAAM,QAAQ;IACd,IAAI,CAAC,UACH,MAAM,QAAQ;GAElB,CAAC;EACH,UACQ;GACN,kBAAkB,mBAAmB;EACvC;CACF;CAEA,SAAS,UAAyB;EAChC,IAAI,UACF,OAAO;EAGT,MAAM,QAAQ,eAAe,2BAA2B;EACxD,cAAc;EACd,MAAM,oBAAoB,EAAE;EAC5B,MAAM,qBAAqB;EAG3B,MAAM,aAAa,KADA,OAAO,oBAAoB,aAAa,kBAAkB,yBAC3C;EAClC,mBAAmB;EACnB,IAAI;GACF,oBAAoB,MAAM;EAC5B,QACM,CAEN;EAEA,IAAI,YAAY,sBAAsB,YACpC,OAAO,MAAM;EAGf,YAAY;GACV,MAAM,SAAS,WAAW,eAAe;GACzC,MAAM,QAAQ;EAChB,CAAC;EAED,IAAI,YAAY,sBAAsB,YACpC,OAAO,MAAM;EAGf,yBAAyB;GAKvB,AAAK,IAHY,SAAY,YAAY;IACvC,QAAQ,OAAO,EAAE,QAAQ,WAAW,OAAO,CAAC,CAAC;GAC/C,CACQ,CAAC,CAAC,MACR,UAAS,YAAY,mBAAmB,KAAK,IAC7C,UAAS,YAAY,mBAAmB,KAAK,CAC/C,CAAC,CAAC,OAAO,UAAU;IAEjB,iBAAiB;KACf,MAAM;IACR,GAAG,CAAC;GACN,CAAC;EACH,CAAC;EACD,OAAO,MAAM;CACf;CAEA,SAAS,UAAU;EACjB,IAAI,UACF;EAEF,WAAW;EACX,cAAc;EACd,MAAM,aAAa;EACnB,mBAAmB;EACnB,IAAI;GACF,YAAY,MAAM;EACpB,QACM,CAEN;EACA,IAAI;GACF,YAAY;IACV,MAAM,SAAS;IACf,MAAM,QAAQ;IACd,MAAM,QAAQ;GAChB,CAAC;EACH,UACQ;GACN,WAAW;GACX,MAAM,QAAQ;GACd,cAAc;GACd,OAAO,QAAQ;EACjB;CACF;CAEA,OAAO,iBAAiB,SAAS;EAC/B,SAAS,EACP,OAAO,QACT;EACA,SAAS,EACP,OAAO,QACT;CACF,CAAC;CAED,MAAM,SAAS,SAAS,KAAK;CAC7B,eAAe,OAAO;CACtB,IAAI,QAAQ,aAAa,MACvB,AAAK,QAAQ;CAEf,OAAO;AACT"}

package/dist/dev/reactivity/computed.d.mts

@@ -0,0 +1,25 @@
+import { Ref } from "./ref.mjs";
+//#region src/reactivity/computed.d.ts
+export type ComputedGetter<T> = () => T;
+export type ComputedSetter<T> = (value: T) => void;
+declare const computedBrand: unique symbol;
+declare const writableComputedBrand: unique symbol;
+interface BaseComputedRef<T, S = T> extends Ref<T, S> {
+  [key: symbol]: any;
+}
+export interface ComputedRef<T = any> extends BaseComputedRef<T> {
+  readonly [computedBrand]: true;
+  readonly value: T;
+}
+export interface WritableComputedRef<T, S = T> extends BaseComputedRef<T, S> {
+  readonly [writableComputedBrand]: true;
+  value: T;
+}
+export interface WritableComputedOptions<T> {
+  get: ComputedGetter<T>;
+  set: ComputedSetter<T>;
+}
+export declare function computed<T>(getter: ComputedGetter<T>): ComputedRef<T>;
+export declare function computed<T>(options: WritableComputedOptions<T>): WritableComputedRef<T>;
+//#endregion
+//# sourceMappingURL=computed.d.mts.map

package/dist/dev/reactivity/core.d.mts

@@ -0,0 +1,35 @@
+//#region src/reactivity/core.d.ts
+export type EffectScheduler = () => void;
+export type Dep = Set<ReactiveEffect>;
+export interface ReactiveEffect<T = any> {
+  (): T;
+  deps: Dep[];
+  scheduler?: EffectScheduler;
+  active: boolean;
+  _running: boolean;
+  _fn: () => T;
+  _computed?: boolean;
+  onStop?: () => void;
+}
+export declare function startBatch(): void;
+export declare function endBatch(): void;
+export declare function batch<T>(fn: () => T): T;
+export declare function stop(runner: ReactiveEffect): void;
+export interface EffectScope {
+  active: boolean;
+  effects: ReactiveEffect[];
+  cleanups: (() => void)[];
+  run: <T>(fn: () => T) => T | undefined;
+  stop: () => void;
+}
+export declare function effectScope(detached?: boolean): EffectScope;
+export declare function getCurrentScope(): EffectScope | undefined;
+export declare function onScopeDispose(fn: () => void): void;
+export interface EffectOptions {
+  scheduler?: EffectScheduler;
+  lazy?: boolean;
+  onStop?: () => void;
+}
+export declare function effect<T = any>(fn: () => T, options?: EffectOptions): ReactiveEffect<T>;
+//#endregion
+//# sourceMappingURL=core.d.mts.map

package/dist/dev/reactivity/core.mjs

@@ -1,5 +1,5 @@
 import { queueJob } from "../scheduler.mjs";
-import _defineProperty from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/defineProperty.mjs";
+import _defineProperty from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.mjs";
 
 //#region src/reactivity/core.ts
 const targetMap = /* @__PURE__ */ new WeakMap();
@@ -96,11 +96,10 @@ function cleanupEffect(effect) {
 	deps.length = 0;
 }
 function stop(runner) {
-	var _runner$onStop;
 	if (!runner.active) return;
 	runner.active = false;
 	cleanupEffect(runner);
-	(_runner$onStop = runner.onStop) === null || _runner$onStop === void 0 || _runner$onStop.call(runner);
+	runner.onStop?.();
 }
 var EffectScopeImpl = class {
 	constructor(detached = false) {
@@ -166,8 +165,7 @@ var EffectScopeImpl = class {
 				scopes.length = 0;
 			}
 		} finally {
-			var _this$parent;
-			if ((_this$parent = this.parent) === null || _this$parent === void 0 ? void 0 : _this$parent.scopes) {
+			if (this.parent?.scopes) {
 				const index = this.parent.scopes.indexOf(this);
 				if (index >= 0) this.parent.scopes.splice(index, 1);
 			}
@@ -184,7 +182,7 @@ function getCurrentScope() {
 	return activeEffectScope;
 }
 function onScopeDispose(fn) {
-	if (activeEffectScope === null || activeEffectScope === void 0 ? void 0 : activeEffectScope.active) activeEffectScope.cleanups.push(fn);
+	if (activeEffectScope?.active) activeEffectScope.cleanups.push(fn);
 }
 /**
 * 在不把读取记录到当前副作用的情况下执行函数。
@@ -222,9 +220,8 @@ function createReactiveEffect(fn, options = {}) {
 			activeEffect = effect;
 			return fn();
 		} finally {
-			var _effectStack;
 			effectStack.pop();
-			activeEffect = (_effectStack = effectStack[effectStack.length - 1]) !== null && _effectStack !== void 0 ? _effectStack : null;
+			activeEffect = effectStack[effectStack.length - 1] ?? null;
 			effect._running = false;
 			activeEffectScope = previousScope;
 			shouldTrack = previousShouldTrack;

package/dist/dev/reactivity/core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"core.mjs","names":[],"sources":["../../../src/reactivity/core.ts"],"sourcesContent":["import { queueJob } from '../scheduler'\n\nexport type EffectScheduler = () => void\n\nexport type Dep = Set<ReactiveEffect>\n\nexport interface ReactiveEffect<T = any> {\n  (): T\n  deps: Dep[]\n  scheduler?: EffectScheduler\n  active: boolean\n  _running: boolean\n  _fn: () => T\n  _computed?: boolean\n  onStop?: () => void\n}\n\nconst targetMap = new WeakMap<object, Map<PropertyKey, Dep>>()\n\nlet activeEffect: ReactiveEffect | null = null\nconst effectStack: ReactiveEffect[] = []\nlet shouldTrack = true\nlet activeEffectScope: EffectScopeImpl | undefined\n\nlet batchDepth = 0\nlet isFlushingBatch = false\nconst batchedEffects = new Set<ReactiveEffect>()\nconst batchedCallbacks = new Set<() => void>()\n\nfunction runScheduledEffect(ef: ReactiveEffect) {\n  if (!ef.active) {\n    return\n  }\n  if (ef.scheduler) {\n    const previousScope = activeEffectScope\n    activeEffectScope = (ef as ScopedReactiveEffect)._scope\n    try {\n      ef.scheduler()\n    }\n    finally {\n      activeEffectScope = previousScope\n    }\n    return\n  }\n  ef()\n}\n\n/** 在当前批次的同步副作用全部完成后执行包内通知。 */\nexport function queueBatchCallback(callback: () => void) {\n  if (batchDepth > 0 || isFlushingBatch) {\n    batchedCallbacks.add(callback)\n    return\n  }\n  batchedCallbacks.delete(callback)\n  callback()\n}\n\nexport function startBatch() {\n  batchDepth++\n}\n\nfunction takeBatchedEffect(effects: Set<ReactiveEffect>): ReactiveEffect | undefined {\n  const next = effects.values().next()\n  if (next.done) {\n    return undefined\n  }\n  effects.delete(next.value)\n  return next.value\n}\n\nfunction flushBatchedEffects() {\n  let firstError: unknown\n  let hasError = false\n  isFlushingBatch = true\n  try {\n    while (batchedEffects.size) {\n      const effect = takeBatchedEffect(batchedEffects)\n      if (!effect) {\n        continue\n      }\n      try {\n        runScheduledEffect(effect)\n      }\n      catch (error) {\n        if (!hasError) {\n          firstError = error\n          hasError = true\n        }\n      }\n    }\n  }\n  finally {\n    isFlushingBatch = false\n  }\n  // 通知属于已完成批次之后的操作，保留订阅回调内同步变更的重入保护。\n  while (batchedCallbacks.size) {\n    const callback = batchedCallbacks.values().next().value!\n    batchedCallbacks.delete(callback)\n    try {\n      callback()\n    }\n    catch (error) {\n      if (!hasError) {\n        firstError = error\n        hasError = true\n      }\n    }\n  }\n  if (hasError) {\n    throw firstError\n  }\n}\n\nexport function endBatch() {\n  if (batchDepth === 0) {\n    return\n  }\n  batchDepth--\n  if (batchDepth === 0 && !isFlushingBatch) {\n    flushBatchedEffects()\n  }\n}\n\nexport function batch<T>(fn: () => T): T {\n  startBatch()\n  try {\n    return fn()\n  }\n  finally {\n    endBatch()\n  }\n}\n\nfunction cleanupEffect(effect: ReactiveEffect) {\n  const { deps } = effect\n  for (let i = 0; i < deps.length; i++) {\n    deps[i].delete(effect)\n  }\n  deps.length = 0\n}\n\nexport function stop(runner: ReactiveEffect) {\n  if (!runner.active) {\n    return\n  }\n  runner.active = false\n  cleanupEffect(runner)\n  runner.onStop?.()\n}\n\nexport interface EffectScope {\n  active: boolean\n  effects: ReactiveEffect[]\n  cleanups: (() => void)[]\n  run: <T>(fn: () => T) => T | undefined\n  stop: () => void\n}\n\nclass EffectScopeImpl implements EffectScope {\n  active = true\n  effects: ReactiveEffect[] = []\n  cleanups: (() => void)[] = []\n  private parent: EffectScopeImpl | undefined\n  private scopes: EffectScopeImpl[] | undefined\n\n  constructor(private detached = false) {\n    if (!detached && activeEffectScope) {\n      if (!activeEffectScope.active) {\n        this.active = false\n        return\n      }\n      this.parent = activeEffectScope\n      ;(activeEffectScope.scopes ||= []).push(this)\n    }\n  }\n\n  run<T>(fn: () => T): T | undefined {\n    if (!this.active) {\n      return\n    }\n    const prev = activeEffectScope\n    // eslint-disable-next-line ts/no-this-alias -- 允许 this 临时别名\n    activeEffectScope = this\n    try {\n      return fn()\n    }\n    finally {\n      activeEffectScope = prev\n    }\n  }\n\n  stop(): void {\n    if (!this.active) {\n      return\n    }\n    this.active = false\n    const prev = activeEffectScope\n    // eslint-disable-next-line ts/no-this-alias -- teardown 期间需要把新建 scope 绑定到当前停止中的 scope\n    activeEffectScope = this\n\n    let firstError: unknown\n    let hasError = false\n    const recordError = (error: unknown) => {\n      if (hasError) {\n        return\n      }\n      firstError = error\n      hasError = true\n    }\n\n    try {\n      const effects = this.effects.splice(0)\n      for (const effect of effects) {\n        try {\n          stop(effect)\n        }\n        catch (error) {\n          recordError(error)\n        }\n      }\n\n      const cleanups = this.cleanups.splice(0)\n      for (const cleanup of cleanups) {\n        try {\n          cleanup()\n        }\n        catch (error) {\n          recordError(error)\n        }\n      }\n\n      const scopes = this.scopes\n      this.scopes = undefined\n      if (scopes) {\n        for (const scope of scopes) {\n          try {\n            scope.stop()\n          }\n          catch (error) {\n            recordError(error)\n          }\n        }\n        scopes.length = 0\n      }\n    }\n    finally {\n      if (this.parent?.scopes) {\n        const index = this.parent.scopes.indexOf(this)\n        if (index >= 0) {\n          this.parent.scopes.splice(index, 1)\n        }\n      }\n      this.parent = undefined\n      activeEffectScope = prev\n    }\n\n    if (hasError) {\n      throw firstError\n    }\n  }\n}\n\ninterface ScopedReactiveEffect<T = any> extends ReactiveEffect<T> {\n  _scope: EffectScopeImpl | undefined\n}\n\nexport function effectScope(detached = false): EffectScope {\n  return new EffectScopeImpl(detached)\n}\n\nexport function getCurrentScope(): EffectScope | undefined {\n  return activeEffectScope\n}\n\nexport function onScopeDispose(fn: () => void): void {\n  if (activeEffectScope?.active) {\n    activeEffectScope.cleanups.push(fn)\n  }\n}\n\n/**\n * 在不把读取记录到当前副作用的情况下执行函数。\n * 函数内部主动运行的新副作用仍会正常收集自己的依赖。\n */\nexport function runWithoutTracking<T>(fn: () => T): T {\n  const previousShouldTrack = shouldTrack\n  shouldTrack = false\n  try {\n    return fn()\n  }\n  finally {\n    shouldTrack = previousShouldTrack\n  }\n}\n\nfunction recordEffectScope(effect: ReactiveEffect) {\n  if (!activeEffectScope) {\n    return\n  }\n  if (activeEffectScope.active) {\n    activeEffectScope.effects.push(effect)\n    return\n  }\n  stop(effect)\n}\n\nexport interface EffectOptions {\n  scheduler?: EffectScheduler\n  lazy?: boolean\n  onStop?: () => void\n}\n\nexport function createReactiveEffect<T>(fn: () => T, options: EffectOptions = {}): ReactiveEffect<T> {\n  const effect = function reactiveEffect() {\n    if (!effect.active) {\n      return fn()\n    }\n    if (effect._running) {\n      return fn()\n    }\n    cleanupEffect(effect)\n    const previousScope = activeEffectScope\n    activeEffectScope = effect._scope\n    const previousShouldTrack = shouldTrack\n    try {\n      shouldTrack = true\n      effect._running = true\n      effectStack.push(effect)\n      activeEffect = effect\n      return fn()\n    }\n    finally {\n      effectStack.pop()\n      activeEffect = effectStack[effectStack.length - 1] ?? null\n      effect._running = false\n      activeEffectScope = previousScope\n      shouldTrack = previousShouldTrack\n    }\n  } as ScopedReactiveEffect<T>\n\n  effect.deps = []\n  effect.scheduler = options.scheduler\n  effect.onStop = options.onStop\n  effect.active = true\n  effect._running = false\n  effect._fn = fn\n  effect._scope = activeEffectScope\n\n  return effect\n}\n\nfunction createEffect<T>(\n  fn: () => T,\n  options: EffectOptions,\n  computed: boolean,\n): ReactiveEffect<T> {\n  const runner = createReactiveEffect(fn, options)\n  runner._computed = computed\n  recordEffectScope(runner)\n  if (!options.lazy) {\n    runner()\n  }\n  return runner\n}\n\nexport function effect<T = any>(fn: () => T, options: EffectOptions = {}): ReactiveEffect<T> {\n  return createEffect(fn, options, false)\n}\n\nexport function createComputedEffect<T>(\n  fn: () => T,\n  options: EffectOptions = {},\n): ReactiveEffect<T> {\n  return createEffect(fn, options, true)\n}\n\nexport function track(target: object, key: PropertyKey) {\n  if (!shouldTrack || !activeEffect) {\n    return\n  }\n  let depsMap = targetMap.get(target)\n  if (!depsMap) {\n    depsMap = new Map()\n    targetMap.set(target, depsMap)\n  }\n  let dep = depsMap.get(key)\n  if (!dep) {\n    dep = new Set()\n    depsMap.set(key, dep)\n  }\n  if (!dep.has(activeEffect)) {\n    dep.add(activeEffect)\n    activeEffect.deps.push(dep)\n  }\n}\n\nfunction scheduleEffect(ef: ReactiveEffect) {\n  if (ef._running) {\n    return\n  }\n  // 计算属性只同步失效缓存，普通消费者仍由批处理队列合并。\n  if (ef._computed) {\n    runScheduledEffect(ef)\n    return\n  }\n  if (batchDepth > 0 || isFlushingBatch) {\n    batchedEffects.add(ef)\n    return\n  }\n  runScheduledEffect(ef)\n}\n\nexport function trigger(target: object, key: PropertyKey) {\n  const depsMap = targetMap.get(target)\n  if (!depsMap) {\n    return\n  }\n  const effects = depsMap.get(key)\n  if (!effects) {\n    return\n  }\n  const effectsToRun = new Set<ReactiveEffect>()\n  effects.forEach((ef) => {\n    if (ef !== activeEffect) {\n      effectsToRun.add(ef)\n    }\n  })\n  effectsToRun.forEach(scheduleEffect)\n}\n\nexport function trackEffects(dep: Dep) {\n  if (!shouldTrack || !activeEffect) {\n    return\n  }\n  if (!dep.has(activeEffect)) {\n    dep.add(activeEffect)\n    activeEffect.deps.push(dep)\n  }\n}\n\nexport function triggerEffects(dep: Dep) {\n  // 迭代时复制依赖集合，避免遍历过程中被重新加入导致死循环。\n  const effectsToRun = new Set(dep)\n  effectsToRun.forEach(scheduleEffect)\n}\n\n// 导出队列调度工具，供 watch/watchEffect 等高层 API 复用同一批处理逻辑\nexport { queueJob }\n"],"mappings":"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"}
+{"version":3,"file":"core.mjs","names":[],"sources":["../../../src/reactivity/core.ts"],"sourcesContent":["import { queueJob } from '../scheduler'\n\nexport type EffectScheduler = () => void\n\nexport type Dep = Set<ReactiveEffect>\n\nexport interface ReactiveEffect<T = any> {\n  (): T\n  deps: Dep[]\n  scheduler?: EffectScheduler\n  active: boolean\n  _running: boolean\n  _fn: () => T\n  _computed?: boolean\n  onStop?: () => void\n}\n\nconst targetMap = new WeakMap<object, Map<PropertyKey, Dep>>()\n\nlet activeEffect: ReactiveEffect | null = null\nconst effectStack: ReactiveEffect[] = []\nlet shouldTrack = true\nlet activeEffectScope: EffectScopeImpl | undefined\n\nlet batchDepth = 0\nlet isFlushingBatch = false\nconst batchedEffects = new Set<ReactiveEffect>()\nconst batchedCallbacks = new Set<() => void>()\n\nfunction runScheduledEffect(ef: ReactiveEffect) {\n  if (!ef.active) {\n    return\n  }\n  if (ef.scheduler) {\n    const previousScope = activeEffectScope\n    activeEffectScope = (ef as ScopedReactiveEffect)._scope\n    try {\n      ef.scheduler()\n    }\n    finally {\n      activeEffectScope = previousScope\n    }\n    return\n  }\n  ef()\n}\n\n/** 在当前批次的同步副作用全部完成后执行包内通知。 */\nexport function queueBatchCallback(callback: () => void) {\n  if (batchDepth > 0 || isFlushingBatch) {\n    batchedCallbacks.add(callback)\n    return\n  }\n  batchedCallbacks.delete(callback)\n  callback()\n}\n\nexport function startBatch() {\n  batchDepth++\n}\n\nfunction takeBatchedEffect(effects: Set<ReactiveEffect>): ReactiveEffect | undefined {\n  const next = effects.values().next()\n  if (next.done) {\n    return undefined\n  }\n  effects.delete(next.value)\n  return next.value\n}\n\nfunction flushBatchedEffects() {\n  let firstError: unknown\n  let hasError = false\n  isFlushingBatch = true\n  try {\n    while (batchedEffects.size) {\n      const effect = takeBatchedEffect(batchedEffects)\n      if (!effect) {\n        continue\n      }\n      try {\n        runScheduledEffect(effect)\n      }\n      catch (error) {\n        if (!hasError) {\n          firstError = error\n          hasError = true\n        }\n      }\n    }\n  }\n  finally {\n    isFlushingBatch = false\n  }\n  // 通知属于已完成批次之后的操作，保留订阅回调内同步变更的重入保护。\n  while (batchedCallbacks.size) {\n    const callback = batchedCallbacks.values().next().value!\n    batchedCallbacks.delete(callback)\n    try {\n      callback()\n    }\n    catch (error) {\n      if (!hasError) {\n        firstError = error\n        hasError = true\n      }\n    }\n  }\n  if (hasError) {\n    throw firstError\n  }\n}\n\nexport function endBatch() {\n  if (batchDepth === 0) {\n    return\n  }\n  batchDepth--\n  if (batchDepth === 0 && !isFlushingBatch) {\n    flushBatchedEffects()\n  }\n}\n\nexport function batch<T>(fn: () => T): T {\n  startBatch()\n  try {\n    return fn()\n  }\n  finally {\n    endBatch()\n  }\n}\n\nfunction cleanupEffect(effect: ReactiveEffect) {\n  const { deps } = effect\n  for (let i = 0; i < deps.length; i++) {\n    deps[i].delete(effect)\n  }\n  deps.length = 0\n}\n\nexport function stop(runner: ReactiveEffect) {\n  if (!runner.active) {\n    return\n  }\n  runner.active = false\n  cleanupEffect(runner)\n  runner.onStop?.()\n}\n\nexport interface EffectScope {\n  active: boolean\n  effects: ReactiveEffect[]\n  cleanups: (() => void)[]\n  run: <T>(fn: () => T) => T | undefined\n  stop: () => void\n}\n\nclass EffectScopeImpl implements EffectScope {\n  active = true\n  effects: ReactiveEffect[] = []\n  cleanups: (() => void)[] = []\n  private parent: EffectScopeImpl | undefined\n  private scopes: EffectScopeImpl[] | undefined\n\n  constructor(private detached = false) {\n    if (!detached && activeEffectScope) {\n      if (!activeEffectScope.active) {\n        this.active = false\n        return\n      }\n      this.parent = activeEffectScope\n      ;(activeEffectScope.scopes ||= []).push(this)\n    }\n  }\n\n  run<T>(fn: () => T): T | undefined {\n    if (!this.active) {\n      return\n    }\n    const prev = activeEffectScope\n    // eslint-disable-next-line ts/no-this-alias -- 允许 this 临时别名\n    activeEffectScope = this\n    try {\n      return fn()\n    }\n    finally {\n      activeEffectScope = prev\n    }\n  }\n\n  stop(): void {\n    if (!this.active) {\n      return\n    }\n    this.active = false\n    const prev = activeEffectScope\n    // eslint-disable-next-line ts/no-this-alias -- teardown 期间需要把新建 scope 绑定到当前停止中的 scope\n    activeEffectScope = this\n\n    let firstError: unknown\n    let hasError = false\n    const recordError = (error: unknown) => {\n      if (hasError) {\n        return\n      }\n      firstError = error\n      hasError = true\n    }\n\n    try {\n      const effects = this.effects.splice(0)\n      for (const effect of effects) {\n        try {\n          stop(effect)\n        }\n        catch (error) {\n          recordError(error)\n        }\n      }\n\n      const cleanups = this.cleanups.splice(0)\n      for (const cleanup of cleanups) {\n        try {\n          cleanup()\n        }\n        catch (error) {\n          recordError(error)\n        }\n      }\n\n      const scopes = this.scopes\n      this.scopes = undefined\n      if (scopes) {\n        for (const scope of scopes) {\n          try {\n            scope.stop()\n          }\n          catch (error) {\n            recordError(error)\n          }\n        }\n        scopes.length = 0\n      }\n    }\n    finally {\n      if (this.parent?.scopes) {\n        const index = this.parent.scopes.indexOf(this)\n        if (index >= 0) {\n          this.parent.scopes.splice(index, 1)\n        }\n      }\n      this.parent = undefined\n      activeEffectScope = prev\n    }\n\n    if (hasError) {\n      throw firstError\n    }\n  }\n}\n\ninterface ScopedReactiveEffect<T = any> extends ReactiveEffect<T> {\n  _scope: EffectScopeImpl | undefined\n}\n\nexport function effectScope(detached = false): EffectScope {\n  return new EffectScopeImpl(detached)\n}\n\nexport function getCurrentScope(): EffectScope | undefined {\n  return activeEffectScope\n}\n\nexport function onScopeDispose(fn: () => void): void {\n  if (activeEffectScope?.active) {\n    activeEffectScope.cleanups.push(fn)\n  }\n}\n\n/**\n * 在不把读取记录到当前副作用的情况下执行函数。\n * 函数内部主动运行的新副作用仍会正常收集自己的依赖。\n */\nexport function runWithoutTracking<T>(fn: () => T): T {\n  const previousShouldTrack = shouldTrack\n  shouldTrack = false\n  try {\n    return fn()\n  }\n  finally {\n    shouldTrack = previousShouldTrack\n  }\n}\n\nfunction recordEffectScope(effect: ReactiveEffect) {\n  if (!activeEffectScope) {\n    return\n  }\n  if (activeEffectScope.active) {\n    activeEffectScope.effects.push(effect)\n    return\n  }\n  stop(effect)\n}\n\nexport interface EffectOptions {\n  scheduler?: EffectScheduler\n  lazy?: boolean\n  onStop?: () => void\n}\n\nexport function createReactiveEffect<T>(fn: () => T, options: EffectOptions = {}): ReactiveEffect<T> {\n  const effect = function reactiveEffect() {\n    if (!effect.active) {\n      return fn()\n    }\n    if (effect._running) {\n      return fn()\n    }\n    cleanupEffect(effect)\n    const previousScope = activeEffectScope\n    activeEffectScope = effect._scope\n    const previousShouldTrack = shouldTrack\n    try {\n      shouldTrack = true\n      effect._running = true\n      effectStack.push(effect)\n      activeEffect = effect\n      return fn()\n    }\n    finally {\n      effectStack.pop()\n      activeEffect = effectStack[effectStack.length - 1] ?? null\n      effect._running = false\n      activeEffectScope = previousScope\n      shouldTrack = previousShouldTrack\n    }\n  } as ScopedReactiveEffect<T>\n\n  effect.deps = []\n  effect.scheduler = options.scheduler\n  effect.onStop = options.onStop\n  effect.active = true\n  effect._running = false\n  effect._fn = fn\n  effect._scope = activeEffectScope\n\n  return effect\n}\n\nfunction createEffect<T>(\n  fn: () => T,\n  options: EffectOptions,\n  computed: boolean,\n): ReactiveEffect<T> {\n  const runner = createReactiveEffect(fn, options)\n  runner._computed = computed\n  recordEffectScope(runner)\n  if (!options.lazy) {\n    runner()\n  }\n  return runner\n}\n\nexport function effect<T = any>(fn: () => T, options: EffectOptions = {}): ReactiveEffect<T> {\n  return createEffect(fn, options, false)\n}\n\nexport function createComputedEffect<T>(\n  fn: () => T,\n  options: EffectOptions = {},\n): ReactiveEffect<T> {\n  return createEffect(fn, options, true)\n}\n\nexport function track(target: object, key: PropertyKey) {\n  if (!shouldTrack || !activeEffect) {\n    return\n  }\n  let depsMap = targetMap.get(target)\n  if (!depsMap) {\n    depsMap = new Map()\n    targetMap.set(target, depsMap)\n  }\n  let dep = depsMap.get(key)\n  if (!dep) {\n    dep = new Set()\n    depsMap.set(key, dep)\n  }\n  if (!dep.has(activeEffect)) {\n    dep.add(activeEffect)\n    activeEffect.deps.push(dep)\n  }\n}\n\nfunction scheduleEffect(ef: ReactiveEffect) {\n  if (ef._running) {\n    return\n  }\n  // 计算属性只同步失效缓存，普通消费者仍由批处理队列合并。\n  if (ef._computed) {\n    runScheduledEffect(ef)\n    return\n  }\n  if (batchDepth > 0 || isFlushingBatch) {\n    batchedEffects.add(ef)\n    return\n  }\n  runScheduledEffect(ef)\n}\n\nexport function trigger(target: object, key: PropertyKey) {\n  const depsMap = targetMap.get(target)\n  if (!depsMap) {\n    return\n  }\n  const effects = depsMap.get(key)\n  if (!effects) {\n    return\n  }\n  const effectsToRun = new Set<ReactiveEffect>()\n  effects.forEach((ef) => {\n    if (ef !== activeEffect) {\n      effectsToRun.add(ef)\n    }\n  })\n  effectsToRun.forEach(scheduleEffect)\n}\n\nexport function trackEffects(dep: Dep) {\n  if (!shouldTrack || !activeEffect) {\n    return\n  }\n  if (!dep.has(activeEffect)) {\n    dep.add(activeEffect)\n    activeEffect.deps.push(dep)\n  }\n}\n\nexport function triggerEffects(dep: Dep) {\n  // 迭代时复制依赖集合，避免遍历过程中被重新加入导致死循环。\n  const effectsToRun = new Set(dep)\n  effectsToRun.forEach(scheduleEffect)\n}\n\n// 导出队列调度工具，供 watch/watchEffect 等高层 API 复用同一批处理逻辑\nexport { queueJob }\n"],"mappings":"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"}

package/dist/dev/reactivity/index.d.mts

@@ -0,0 +1,16 @@
+import { AsyncDerivation, AsyncDerivationContext, AsyncDerivationState, AsyncDerivationStatus, UseAsyncDerivationOptions, useAsyncDerivation } from "./asyncDerivation.mjs";
+import { CustomRefFactory, CustomRefOptions, CustomRefSource, MaybeRef, MaybeRefOrGetter, Ref, ShallowRef, customRef, isRef, ref, toValue, unref } from "./ref.mjs";
+import { ComputedGetter, ComputedRef, ComputedSetter, WritableComputedOptions, WritableComputedRef, computed } from "./computed.mjs";
+import { EffectScope, batch, effect, effectScope, endBatch, getCurrentScope, onScopeDispose, startBatch, stop } from "./core.mjs";
+import { MutationKind, MutationOp, MutationRecord, addMutationRecorder, removeMutationRecorder } from "./reactive/mutation.mjs";
+import { PrelinkReactiveTreeOptions, prelinkReactiveTree, touchReactive } from "./reactive/patch.mjs";
+import { isShallowReactive, shallowReactive } from "./reactive/shallow.mjs";
+import { toRaw } from "./reactive/shared.mjs";
+import { getReactiveVersion, isRaw, isReactive, markRaw, reactive } from "./reactive.mjs";
+import { isProxy, isReadonly, readonly, shallowReadonly } from "./readonly.mjs";
+import { isShallowRef, shallowRef, triggerRef } from "./shallowRef.mjs";
+import { ToRefs, toRef, toRefs } from "./toRefs.mjs";
+import { traverse } from "./traverse.mjs";
+import { MapSources, MaybeUndefined, MultiWatchSources, OnCleanup, WatchCallback, WatchEffect, WatchEffectOptions, WatchMultiSources, WatchOptions, WatchScheduler, WatchSource, WatchSourceValue, WatchSources, WatchStopHandle, getDeepWatchStrategy, setDeepWatchStrategy } from "./watch/types.mjs";
+import { watch, watchEffect, watchPostEffect, watchSyncEffect } from "./watch.mjs";
+export { type AsyncDerivation, type AsyncDerivationContext, type AsyncDerivationState, type AsyncDerivationStatus, type ComputedGetter, type ComputedRef, type ComputedSetter, type CustomRefFactory, type CustomRefOptions, type CustomRefSource, type EffectScope, type MapSources, type MaybeRef, type MaybeRefOrGetter, type MaybeUndefined, type MultiWatchSources, type MutationKind, type MutationOp, type MutationRecord, type OnCleanup, type PrelinkReactiveTreeOptions, type Ref, type ShallowRef, type ToRefs, type UseAsyncDerivationOptions, type WatchCallback, type WatchEffect, type WatchEffectOptions, type WatchMultiSources, type WatchOptions, type WatchScheduler, type WatchSource, type WatchSourceValue, type WatchSources, type WatchStopHandle, type WritableComputedOptions, type WritableComputedRef, addMutationRecorder, batch, computed, customRef, effect, effectScope, endBatch, getCurrentScope, getDeepWatchStrategy, getReactiveVersion, isProxy, isRaw, isReactive, isReadonly, isRef, isShallowReactive, isShallowRef, markRaw, onScopeDispose, prelinkReactiveTree, reactive, readonly, ref, removeMutationRecorder, setDeepWatchStrategy, shallowReactive, shallowReadonly, shallowRef, startBatch, stop, toRaw, toRef, toRefs, toValue, touchReactive, traverse, triggerRef, unref, useAsyncDerivation, watch, watchEffect, watchPostEffect, watchSyncEffect };

package/dist/dev/reactivity/reactive/mutation.d.mts

@@ -0,0 +1,21 @@
+//#region src/reactivity/reactive/mutation.d.ts
+export type MutationOp = 'set' | 'delete';
+export type MutationKind = 'property' | 'array';
+export interface MutationRecord {
+  root: object;
+  kind: MutationKind;
+  op: MutationOp;
+  /**
+   * 点路径（例如 `a.b.c`）；当路径不可靠时为 undefined。
+   */
+  path?: string;
+  /**
+   * 当路径不唯一时回退使用的顶层键列表。
+   */
+  fallbackTopKeys?: string[];
+}
+type MutationRecorder = (record: MutationRecord) => void;
+export declare function addMutationRecorder(recorder: MutationRecorder): void;
+export declare function removeMutationRecorder(recorder: MutationRecorder): void;
+//#endregion
+//# sourceMappingURL=mutation.d.mts.map

package/dist/dev/reactivity/reactive/patch.d.mts

@@ -0,0 +1,18 @@
+//#region src/reactivity/reactive/patch.d.ts
+export interface PrelinkReactiveTreeOptions {
+  shouldIncludeTopKey?: (key: string) => boolean;
+  maxDepth?: number;
+  maxKeys?: number;
+}
+/**
+ * 预链接响应式树结构，供运行时差量路径追踪使用。
+ * @internal
+ */
+export declare function prelinkReactiveTree(root: object, options?: PrelinkReactiveTreeOptions): void;
+/**
+ * 让 effect 订阅整个对象的“版本号”，无需深度遍历即可对任何字段变化做出响应。
+ * @internal
+ */
+export declare function touchReactive(target: object): void;
+//#endregion
+//# sourceMappingURL=patch.d.mts.map

package/dist/dev/reactivity/reactive/patch.mjs

@@ -11,9 +11,9 @@ function prelinkReactiveTree(root, options) {
 	const rootRaw = toRaw(root);
 	rawPathMap.set(rootRaw, "");
 	indexPatchNode(rootRaw, rootRaw);
-	const shouldIncludeTopKey = options === null || options === void 0 ? void 0 : options.shouldIncludeTopKey;
-	const maxDepth = typeof (options === null || options === void 0 ? void 0 : options.maxDepth) === "number" ? Math.max(0, Math.floor(options.maxDepth)) : Number.POSITIVE_INFINITY;
-	const maxKeys = typeof (options === null || options === void 0 ? void 0 : options.maxKeys) === "number" ? Math.max(0, Math.floor(options.maxKeys)) : Number.POSITIVE_INFINITY;
+	const shouldIncludeTopKey = options?.shouldIncludeTopKey;
+	const maxDepth = typeof options?.maxDepth === "number" ? Math.max(0, Math.floor(options.maxDepth)) : Number.POSITIVE_INFINITY;
+	const maxKeys = typeof options?.maxKeys === "number" ? Math.max(0, Math.floor(options.maxKeys)) : Number.POSITIVE_INFINITY;
 	const visited = /* @__PURE__ */ new WeakSet();
 	const stack = [{
 		current: rootRaw,

package/dist/dev/reactivity/reactive/patch.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"patch.mjs","names":[],"sources":["../../../../src/reactivity/reactive/patch.ts"],"sourcesContent":["import { track } from '../core'\nimport {\n  adoptReactiveRoot,\n  indexPatchNode,\n  rawMultiParentSet,\n  rawParentMap,\n  rawParentsMap,\n  rawPathMap,\n  rawRootMap,\n  rawVersionMap,\n  recordParentLink,\n  rootPatchNodesMap,\n} from './patchState'\nimport { isObject, ReactiveFlags, toRaw, VERSION_KEY } from './shared'\n\nexport interface PrelinkReactiveTreeOptions {\n  shouldIncludeTopKey?: (key: string) => boolean\n  maxDepth?: number\n  maxKeys?: number\n}\n\n/**\n * 预链接响应式树结构，供运行时差量路径追踪使用。\n * @internal\n */\nexport function prelinkReactiveTree(root: object, options?: PrelinkReactiveTreeOptions) {\n  const rootRaw = toRaw(root as any) as object\n  rawPathMap.set(rootRaw, '')\n  indexPatchNode(rootRaw, rootRaw)\n\n  const shouldIncludeTopKey = options?.shouldIncludeTopKey\n  const maxDepth = typeof options?.maxDepth === 'number' ? Math.max(0, Math.floor(options!.maxDepth!)) : Number.POSITIVE_INFINITY\n  const maxKeys = typeof options?.maxKeys === 'number' ? Math.max(0, Math.floor(options!.maxKeys!)) : Number.POSITIVE_INFINITY\n\n  const visited = new WeakSet<object>()\n  const stack: Array<{ current: object, path: string, depth: number }> = [{ current: rootRaw, path: '', depth: 0 }]\n  let indexed = 0\n\n  while (stack.length) {\n    const node = stack.pop()!\n    if (visited.has(node.current)) {\n      continue\n    }\n    visited.add(node.current)\n    rawPathMap.set(node.current, node.path)\n    indexPatchNode(rootRaw, node.current)\n    indexed += 1\n    if (indexed >= maxKeys) {\n      continue\n    }\n\n    if (node.depth >= maxDepth) {\n      continue\n    }\n    if (Array.isArray(node.current)) {\n      // 数组不预先展开子元素：大列表场景避免 O(n) 初始化开销。\n      continue\n    }\n\n    const entries = Object.entries(node.current as any)\n    for (const [key, value] of entries) {\n      if (node.path === '' && shouldIncludeTopKey && !shouldIncludeTopKey(key)) {\n        continue\n      }\n      if (!isObject(value)) {\n        continue\n      }\n      if ((value as any)[ReactiveFlags.SKIP]) {\n        continue\n      }\n      const childRaw = toRaw(value as any) as object\n      adoptReactiveRoot(childRaw, node.current)\n      recordParentLink(childRaw, node.current, key)\n      if (!rawMultiParentSet.has(childRaw)) {\n        const childPath = node.path ? `${node.path}.${key}` : key\n        rawPathMap.set(childRaw, childPath)\n      }\n      indexPatchNode(rootRaw, childRaw)\n      stack.push({ current: childRaw, path: node.path ? `${node.path}.${key}` : key, depth: node.depth + 1 })\n    }\n  }\n}\n\n/**\n * 清理预链接阶段建立的路径与父子索引。\n * @internal\n */\nexport function clearPatchIndices(root: object) {\n  const rootRaw = toRaw(root as any) as object\n  const nodes = rootPatchNodesMap.get(rootRaw)\n  if (!nodes) {\n    rawPathMap.delete(rootRaw)\n    return\n  }\n\n  for (const node of nodes) {\n    rawParentMap.delete(node)\n    rawParentsMap.delete(node)\n    rawPathMap.delete(node)\n    rawMultiParentSet.delete(node)\n    rawRootMap.delete(node)\n    rawVersionMap.delete(node)\n  }\n\n  rootPatchNodesMap.delete(rootRaw)\n}\n\n/**\n * 让 effect 订阅整个对象的“版本号”，无需深度遍历即可对任何字段变化做出响应。\n * @internal\n */\nexport function touchReactive(target: object) {\n  const raw = toRaw(target as any) as object\n  track(raw, VERSION_KEY)\n}\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,oBAAoB,MAAc,SAAsC;CACtF,MAAM,UAAU,MAAM,IAAW;CACjC,WAAW,IAAI,SAAS,EAAE;CAC1B,eAAe,SAAS,OAAO;CAE/B,MAAM,wEAAsB,QAAS;CACrC,MAAM,WAAW,0DAAO,QAAS,cAAa,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,QAAS,QAAS,CAAC,IAAI,OAAO;CAC9G,MAAM,UAAU,0DAAO,QAAS,aAAY,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,QAAS,OAAQ,CAAC,IAAI,OAAO;CAE3G,MAAM,0BAAU,IAAI,QAAgB;CACpC,MAAM,QAAiE,CAAC;EAAE,SAAS;EAAS,MAAM;EAAI,OAAO;CAAE,CAAC;CAChH,IAAI,UAAU;CAEd,OAAO,MAAM,QAAQ;EACnB,MAAM,OAAO,MAAM,IAAI;EACvB,IAAI,QAAQ,IAAI,KAAK,OAAO,GAC1B;EAEF,QAAQ,IAAI,KAAK,OAAO;EACxB,WAAW,IAAI,KAAK,SAAS,KAAK,IAAI;EACtC,eAAe,SAAS,KAAK,OAAO;EACpC,WAAW;EACX,IAAI,WAAW,SACb;EAGF,IAAI,KAAK,SAAS,UAChB;EAEF,IAAI,MAAM,QAAQ,KAAK,OAAO,GAE5B;EAGF,MAAM,UAAU,OAAO,QAAQ,KAAK,OAAc;EAClD,KAAK,MAAM,CAAC,KAAK,UAAU,SAAS;GAClC,IAAI,KAAK,SAAS,MAAM,uBAAuB,CAAC,oBAAoB,GAAG,GACrE;GAEF,IAAI,CAAC,SAAS,KAAK,GACjB;GAEF,IAAK,mBACH;GAEF,MAAM,WAAW,MAAM,KAAY;GACnC,kBAAkB,UAAU,KAAK,OAAO;GACxC,iBAAiB,UAAU,KAAK,SAAS,GAAG;GAC5C,IAAI,CAAC,kBAAkB,IAAI,QAAQ,GAAG;IACpC,MAAM,YAAY,KAAK,OAAO,GAAG,KAAK,KAAK,GAAG,QAAQ;IACtD,WAAW,IAAI,UAAU,SAAS;GACpC;GACA,eAAe,SAAS,QAAQ;GAChC,MAAM,KAAK;IAAE,SAAS;IAAU,MAAM,KAAK,OAAO,GAAG,KAAK,KAAK,GAAG,QAAQ;IAAK,OAAO,KAAK,QAAQ;GAAE,CAAC;EACxG;CACF;AACF;;;;;AAMA,SAAgB,kBAAkB,MAAc;CAC9C,MAAM,UAAU,MAAM,IAAW;CACjC,MAAM,QAAQ,kBAAkB,IAAI,OAAO;CAC3C,IAAI,CAAC,OAAO;EACV,WAAW,OAAO,OAAO;EACzB;CACF;CAEA,KAAK,MAAM,QAAQ,OAAO;EACxB,aAAa,OAAO,IAAI;EACxB,cAAc,OAAO,IAAI;EACzB,WAAW,OAAO,IAAI;EACtB,kBAAkB,OAAO,IAAI;EAC7B,WAAW,OAAO,IAAI;EACtB,cAAc,OAAO,IAAI;CAC3B;CAEA,kBAAkB,OAAO,OAAO;AAClC;;;;;AAMA,SAAgB,cAAc,QAAgB;CAC5C,MAAM,MAAM,MAAM,MAAa;CAC/B,MAAM,KAAK,WAAW;AACxB"}
+{"version":3,"file":"patch.mjs","names":[],"sources":["../../../../src/reactivity/reactive/patch.ts"],"sourcesContent":["import { track } from '../core'\nimport {\n  adoptReactiveRoot,\n  indexPatchNode,\n  rawMultiParentSet,\n  rawParentMap,\n  rawParentsMap,\n  rawPathMap,\n  rawRootMap,\n  rawVersionMap,\n  recordParentLink,\n  rootPatchNodesMap,\n} from './patchState'\nimport { isObject, ReactiveFlags, toRaw, VERSION_KEY } from './shared'\n\nexport interface PrelinkReactiveTreeOptions {\n  shouldIncludeTopKey?: (key: string) => boolean\n  maxDepth?: number\n  maxKeys?: number\n}\n\n/**\n * 预链接响应式树结构，供运行时差量路径追踪使用。\n * @internal\n */\nexport function prelinkReactiveTree(root: object, options?: PrelinkReactiveTreeOptions) {\n  const rootRaw = toRaw(root as any) as object\n  rawPathMap.set(rootRaw, '')\n  indexPatchNode(rootRaw, rootRaw)\n\n  const shouldIncludeTopKey = options?.shouldIncludeTopKey\n  const maxDepth = typeof options?.maxDepth === 'number' ? Math.max(0, Math.floor(options!.maxDepth!)) : Number.POSITIVE_INFINITY\n  const maxKeys = typeof options?.maxKeys === 'number' ? Math.max(0, Math.floor(options!.maxKeys!)) : Number.POSITIVE_INFINITY\n\n  const visited = new WeakSet<object>()\n  const stack: Array<{ current: object, path: string, depth: number }> = [{ current: rootRaw, path: '', depth: 0 }]\n  let indexed = 0\n\n  while (stack.length) {\n    const node = stack.pop()!\n    if (visited.has(node.current)) {\n      continue\n    }\n    visited.add(node.current)\n    rawPathMap.set(node.current, node.path)\n    indexPatchNode(rootRaw, node.current)\n    indexed += 1\n    if (indexed >= maxKeys) {\n      continue\n    }\n\n    if (node.depth >= maxDepth) {\n      continue\n    }\n    if (Array.isArray(node.current)) {\n      // 数组不预先展开子元素：大列表场景避免 O(n) 初始化开销。\n      continue\n    }\n\n    const entries = Object.entries(node.current as any)\n    for (const [key, value] of entries) {\n      if (node.path === '' && shouldIncludeTopKey && !shouldIncludeTopKey(key)) {\n        continue\n      }\n      if (!isObject(value)) {\n        continue\n      }\n      if ((value as any)[ReactiveFlags.SKIP]) {\n        continue\n      }\n      const childRaw = toRaw(value as any) as object\n      adoptReactiveRoot(childRaw, node.current)\n      recordParentLink(childRaw, node.current, key)\n      if (!rawMultiParentSet.has(childRaw)) {\n        const childPath = node.path ? `${node.path}.${key}` : key\n        rawPathMap.set(childRaw, childPath)\n      }\n      indexPatchNode(rootRaw, childRaw)\n      stack.push({ current: childRaw, path: node.path ? `${node.path}.${key}` : key, depth: node.depth + 1 })\n    }\n  }\n}\n\n/**\n * 清理预链接阶段建立的路径与父子索引。\n * @internal\n */\nexport function clearPatchIndices(root: object) {\n  const rootRaw = toRaw(root as any) as object\n  const nodes = rootPatchNodesMap.get(rootRaw)\n  if (!nodes) {\n    rawPathMap.delete(rootRaw)\n    return\n  }\n\n  for (const node of nodes) {\n    rawParentMap.delete(node)\n    rawParentsMap.delete(node)\n    rawPathMap.delete(node)\n    rawMultiParentSet.delete(node)\n    rawRootMap.delete(node)\n    rawVersionMap.delete(node)\n  }\n\n  rootPatchNodesMap.delete(rootRaw)\n}\n\n/**\n * 让 effect 订阅整个对象的“版本号”，无需深度遍历即可对任何字段变化做出响应。\n * @internal\n */\nexport function touchReactive(target: object) {\n  const raw = toRaw(target as any) as object\n  track(raw, VERSION_KEY)\n}\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,oBAAoB,MAAc,SAAsC;CACtF,MAAM,UAAU,MAAM,IAAW;CACjC,WAAW,IAAI,SAAS,EAAE;CAC1B,eAAe,SAAS,OAAO;CAE/B,MAAM,sBAAsB,SAAS;CACrC,MAAM,WAAW,OAAO,SAAS,aAAa,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,QAAS,QAAS,CAAC,IAAI,OAAO;CAC9G,MAAM,UAAU,OAAO,SAAS,YAAY,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,QAAS,OAAQ,CAAC,IAAI,OAAO;CAE3G,MAAM,0BAAU,IAAI,QAAgB;CACpC,MAAM,QAAiE,CAAC;EAAE,SAAS;EAAS,MAAM;EAAI,OAAO;CAAE,CAAC;CAChH,IAAI,UAAU;CAEd,OAAO,MAAM,QAAQ;EACnB,MAAM,OAAO,MAAM,IAAI;EACvB,IAAI,QAAQ,IAAI,KAAK,OAAO,GAC1B;EAEF,QAAQ,IAAI,KAAK,OAAO;EACxB,WAAW,IAAI,KAAK,SAAS,KAAK,IAAI;EACtC,eAAe,SAAS,KAAK,OAAO;EACpC,WAAW;EACX,IAAI,WAAW,SACb;EAGF,IAAI,KAAK,SAAS,UAChB;EAEF,IAAI,MAAM,QAAQ,KAAK,OAAO,GAE5B;EAGF,MAAM,UAAU,OAAO,QAAQ,KAAK,OAAc;EAClD,KAAK,MAAM,CAAC,KAAK,UAAU,SAAS;GAClC,IAAI,KAAK,SAAS,MAAM,uBAAuB,CAAC,oBAAoB,GAAG,GACrE;GAEF,IAAI,CAAC,SAAS,KAAK,GACjB;GAEF,IAAK,mBACH;GAEF,MAAM,WAAW,MAAM,KAAY;GACnC,kBAAkB,UAAU,KAAK,OAAO;GACxC,iBAAiB,UAAU,KAAK,SAAS,GAAG;GAC5C,IAAI,CAAC,kBAAkB,IAAI,QAAQ,GAAG;IACpC,MAAM,YAAY,KAAK,OAAO,GAAG,KAAK,KAAK,GAAG,QAAQ;IACtD,WAAW,IAAI,UAAU,SAAS;GACpC;GACA,eAAe,SAAS,QAAQ;GAChC,MAAM,KAAK;IAAE,SAAS;IAAU,MAAM,KAAK,OAAO,GAAG,KAAK,KAAK,GAAG,QAAQ;IAAK,OAAO,KAAK,QAAQ;GAAE,CAAC;EACxG;CACF;AACF;;;;;AAMA,SAAgB,kBAAkB,MAAc;CAC9C,MAAM,UAAU,MAAM,IAAW;CACjC,MAAM,QAAQ,kBAAkB,IAAI,OAAO;CAC3C,IAAI,CAAC,OAAO;EACV,WAAW,OAAO,OAAO;EACzB;CACF;CAEA,KAAK,MAAM,QAAQ,OAAO;EACxB,aAAa,OAAO,IAAI;EACxB,cAAc,OAAO,IAAI;EACzB,WAAW,OAAO,IAAI;EACtB,kBAAkB,OAAO,IAAI;EAC7B,WAAW,OAAO,IAAI;EACtB,cAAc,OAAO,IAAI;CAC3B;CAEA,kBAAkB,OAAO,OAAO;AAClC;;;;;AAMA,SAAgB,cAAc,QAAgB;CAC5C,MAAM,MAAM,MAAM,MAAa;CAC/B,MAAM,KAAK,WAAW;AACxB"}

package/dist/dev/reactivity/reactive/patchState.mjs

@@ -20,20 +20,17 @@ function indexPatchNode(root, node) {
 	getRootPatchNodes(root).add(node);
 }
 function bumpRawVersion(target) {
-	var _rawVersionMap$get;
-	rawVersionMap.set(target, ((_rawVersionMap$get = rawVersionMap.get(target)) !== null && _rawVersionMap$get !== void 0 ? _rawVersionMap$get : 0) + 1);
+	rawVersionMap.set(target, (rawVersionMap.get(target) ?? 0) + 1);
 }
 function getRawVersion(target) {
-	var _rawVersionMap$get2;
-	return (_rawVersionMap$get2 = rawVersionMap.get(target)) !== null && _rawVersionMap$get2 !== void 0 ? _rawVersionMap$get2 : 0;
+	return rawVersionMap.get(target) ?? 0;
 }
 /**
 * 将尚未归属父状态树的响应式节点接入父级根节点。
 * @internal
 */
 function adoptReactiveRoot(child, parent) {
-	var _rawRootMap$get;
-	const parentRoot = (_rawRootMap$get = rawRootMap.get(parent)) !== null && _rawRootMap$get !== void 0 ? _rawRootMap$get : parent;
+	const parentRoot = rawRootMap.get(parent) ?? parent;
 	const existingRoot = rawRootMap.get(child);
 	if (!existingRoot || existingRoot === child || existingRoot === parent) rawRootMap.set(child, parentRoot);
 }
@@ -89,8 +86,7 @@ function recordParentLink(child, parent, key) {
 		return;
 	}
 	if (mutationRecorders.size) {
-		var _rawRootMap$get2;
-		const root = (_rawRootMap$get2 = rawRootMap.get(parent)) !== null && _rawRootMap$get2 !== void 0 ? _rawRootMap$get2 : parent;
+		const root = rawRootMap.get(parent) ?? parent;
 		indexPatchNode(root, parent);
 		indexPatchNode(root, child);
 	}

package/dist/dev/reactivity/reactive/patchState.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"patchState.mjs","names":[],"sources":["../../../../src/reactivity/reactive/patchState.ts"],"sourcesContent":["import { mutationRecorders } from './mutation'\n\nexport const rawRootMap = new WeakMap<object, object>()\nexport const rawVersionMap = new WeakMap<object, number>()\nexport const rawParentMap = new WeakMap<object, { parent: object, key: PropertyKey }>()\nexport const rawParentsMap = new WeakMap<object, Map<object, Set<PropertyKey>>>()\nexport const rawMultiParentSet = new WeakSet<object>()\nexport const rawPathMap = new WeakMap<object, string>()\nexport const rootPatchNodesMap = new WeakMap<object, Set<object>>()\n\nfunction getRootPatchNodes(root: object) {\n  let nodes = rootPatchNodesMap.get(root)\n  if (!nodes) {\n    nodes = new Set()\n    rootPatchNodesMap.set(root, nodes)\n  }\n  return nodes\n}\n\nexport function indexPatchNode(root: object, node: object) {\n  getRootPatchNodes(root).add(node)\n}\n\nexport function bumpRawVersion(target: object) {\n  rawVersionMap.set(target, (rawVersionMap.get(target) ?? 0) + 1)\n}\n\nexport function getRawVersion(target: object) {\n  return rawVersionMap.get(target) ?? 0\n}\n\n/**\n * 将尚未归属父状态树的响应式节点接入父级根节点。\n * @internal\n */\nexport function adoptReactiveRoot(child: object, parent: object) {\n  const parentRoot = rawRootMap.get(parent) ?? parent\n  const existingRoot = rawRootMap.get(child)\n  if (!existingRoot || existingRoot === child || existingRoot === parent) {\n    rawRootMap.set(child, parentRoot)\n  }\n}\n\nexport function bumpAncestorVersions(target: object) {\n  const visited = new Set<object>()\n  const stack: object[] = [target]\n  for (let i = 0; i < 2000 && stack.length; i++) {\n    const current = stack.pop()!\n    const parents = rawParentsMap.get(current)\n    if (!parents) {\n      continue\n    }\n    for (const parent of parents.keys()) {\n      if (visited.has(parent)) {\n        continue\n      }\n      visited.add(parent)\n      bumpRawVersion(parent)\n      stack.push(parent)\n    }\n  }\n}\n\nfunction refreshPathUniqueness(child: object) {\n  const parents = rawParentsMap.get(child)\n  if (!parents) {\n    rawMultiParentSet.delete(child)\n    rawParentMap.delete(child)\n    return\n  }\n\n  let uniqueParent: object | undefined\n  let uniqueKey: PropertyKey | undefined\n  let total = 0\n  for (const [parent, keys] of parents) {\n    for (const k of keys) {\n      total += 1\n      if (total > 1) {\n        break\n      }\n      uniqueParent = parent\n      uniqueKey = k\n    }\n    if (total > 1) {\n      break\n    }\n  }\n\n  if (total === 1 && uniqueParent && uniqueKey) {\n    rawMultiParentSet.delete(child)\n    rawParentMap.set(child, { parent: uniqueParent, key: uniqueKey })\n    return\n  }\n\n  rawMultiParentSet.add(child)\n  rawParentMap.delete(child)\n}\n\nexport function recordParentLink(child: object, parent: object, key: PropertyKey) {\n  if (typeof key !== 'string') {\n    rawMultiParentSet.add(child)\n    rawParentMap.delete(child)\n    return\n  }\n\n  if (mutationRecorders.size) {\n    const root = rawRootMap.get(parent) ?? parent\n    indexPatchNode(root, parent)\n    indexPatchNode(root, child)\n  }\n\n  let parents = rawParentsMap.get(child)\n  if (!parents) {\n    parents = new Map()\n    rawParentsMap.set(child, parents)\n  }\n\n  let keys = parents.get(parent)\n  if (!keys) {\n    keys = new Set()\n    parents.set(parent, keys)\n  }\n\n  keys.add(key)\n  refreshPathUniqueness(child)\n}\n\nexport function removeParentLink(child: object, parent: object, key: PropertyKey) {\n  const parents = rawParentsMap.get(child)\n  if (!parents) {\n    return\n  }\n  const keys = parents.get(parent)\n  if (!keys) {\n    return\n  }\n  keys.delete(key)\n  if (!keys.size) {\n    parents.delete(parent)\n  }\n  if (!parents.size) {\n    rawParentsMap.delete(child)\n  }\n  refreshPathUniqueness(child)\n}\n\nexport function resolvePathToTarget(root: object, target: object): string[] | undefined {\n  if (target === root) {\n    return []\n  }\n  if (rawMultiParentSet.has(target)) {\n    return undefined\n  }\n  const segments: string[] = []\n  let current: object = target\n  for (let i = 0; i < 2000; i++) {\n    if (current === root) {\n      return segments.reverse()\n    }\n    if (rawMultiParentSet.has(current)) {\n      return undefined\n    }\n    const info = rawParentMap.get(current)\n    if (!info) {\n      return undefined\n    }\n    if (typeof info.key !== 'string') {\n      return undefined\n    }\n    segments.push(info.key)\n    current = info.parent\n  }\n  return undefined\n}\n"],"mappings":"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"}
+{"version":3,"file":"patchState.mjs","names":[],"sources":["../../../../src/reactivity/reactive/patchState.ts"],"sourcesContent":["import { mutationRecorders } from './mutation'\n\nexport const rawRootMap = new WeakMap<object, object>()\nexport const rawVersionMap = new WeakMap<object, number>()\nexport const rawParentMap = new WeakMap<object, { parent: object, key: PropertyKey }>()\nexport const rawParentsMap = new WeakMap<object, Map<object, Set<PropertyKey>>>()\nexport const rawMultiParentSet = new WeakSet<object>()\nexport const rawPathMap = new WeakMap<object, string>()\nexport const rootPatchNodesMap = new WeakMap<object, Set<object>>()\n\nfunction getRootPatchNodes(root: object) {\n  let nodes = rootPatchNodesMap.get(root)\n  if (!nodes) {\n    nodes = new Set()\n    rootPatchNodesMap.set(root, nodes)\n  }\n  return nodes\n}\n\nexport function indexPatchNode(root: object, node: object) {\n  getRootPatchNodes(root).add(node)\n}\n\nexport function bumpRawVersion(target: object) {\n  rawVersionMap.set(target, (rawVersionMap.get(target) ?? 0) + 1)\n}\n\nexport function getRawVersion(target: object) {\n  return rawVersionMap.get(target) ?? 0\n}\n\n/**\n * 将尚未归属父状态树的响应式节点接入父级根节点。\n * @internal\n */\nexport function adoptReactiveRoot(child: object, parent: object) {\n  const parentRoot = rawRootMap.get(parent) ?? parent\n  const existingRoot = rawRootMap.get(child)\n  if (!existingRoot || existingRoot === child || existingRoot === parent) {\n    rawRootMap.set(child, parentRoot)\n  }\n}\n\nexport function bumpAncestorVersions(target: object) {\n  const visited = new Set<object>()\n  const stack: object[] = [target]\n  for (let i = 0; i < 2000 && stack.length; i++) {\n    const current = stack.pop()!\n    const parents = rawParentsMap.get(current)\n    if (!parents) {\n      continue\n    }\n    for (const parent of parents.keys()) {\n      if (visited.has(parent)) {\n        continue\n      }\n      visited.add(parent)\n      bumpRawVersion(parent)\n      stack.push(parent)\n    }\n  }\n}\n\nfunction refreshPathUniqueness(child: object) {\n  const parents = rawParentsMap.get(child)\n  if (!parents) {\n    rawMultiParentSet.delete(child)\n    rawParentMap.delete(child)\n    return\n  }\n\n  let uniqueParent: object | undefined\n  let uniqueKey: PropertyKey | undefined\n  let total = 0\n  for (const [parent, keys] of parents) {\n    for (const k of keys) {\n      total += 1\n      if (total > 1) {\n        break\n      }\n      uniqueParent = parent\n      uniqueKey = k\n    }\n    if (total > 1) {\n      break\n    }\n  }\n\n  if (total === 1 && uniqueParent && uniqueKey) {\n    rawMultiParentSet.delete(child)\n    rawParentMap.set(child, { parent: uniqueParent, key: uniqueKey })\n    return\n  }\n\n  rawMultiParentSet.add(child)\n  rawParentMap.delete(child)\n}\n\nexport function recordParentLink(child: object, parent: object, key: PropertyKey) {\n  if (typeof key !== 'string') {\n    rawMultiParentSet.add(child)\n    rawParentMap.delete(child)\n    return\n  }\n\n  if (mutationRecorders.size) {\n    const root = rawRootMap.get(parent) ?? parent\n    indexPatchNode(root, parent)\n    indexPatchNode(root, child)\n  }\n\n  let parents = rawParentsMap.get(child)\n  if (!parents) {\n    parents = new Map()\n    rawParentsMap.set(child, parents)\n  }\n\n  let keys = parents.get(parent)\n  if (!keys) {\n    keys = new Set()\n    parents.set(parent, keys)\n  }\n\n  keys.add(key)\n  refreshPathUniqueness(child)\n}\n\nexport function removeParentLink(child: object, parent: object, key: PropertyKey) {\n  const parents = rawParentsMap.get(child)\n  if (!parents) {\n    return\n  }\n  const keys = parents.get(parent)\n  if (!keys) {\n    return\n  }\n  keys.delete(key)\n  if (!keys.size) {\n    parents.delete(parent)\n  }\n  if (!parents.size) {\n    rawParentsMap.delete(child)\n  }\n  refreshPathUniqueness(child)\n}\n\nexport function resolvePathToTarget(root: object, target: object): string[] | undefined {\n  if (target === root) {\n    return []\n  }\n  if (rawMultiParentSet.has(target)) {\n    return undefined\n  }\n  const segments: string[] = []\n  let current: object = target\n  for (let i = 0; i < 2000; i++) {\n    if (current === root) {\n      return segments.reverse()\n    }\n    if (rawMultiParentSet.has(current)) {\n      return undefined\n    }\n    const info = rawParentMap.get(current)\n    if (!info) {\n      return undefined\n    }\n    if (typeof info.key !== 'string') {\n      return undefined\n    }\n    segments.push(info.key)\n    current = info.parent\n  }\n  return undefined\n}\n"],"mappings":"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"}

package/dist/dev/reactivity/reactive/shallow.d.mts

@@ -0,0 +1,22 @@
+//#region src/reactivity/reactive/shallow.d.ts
+/**
+ * 创建一个浅层响应式代理：仅跟踪第一层属性变更，不深度递归嵌套对象。
+ *
+ * @param target 待转换的对象
+ * @returns 浅层响应式代理
+ *
+ * @example
+ * ```ts
+ * const state = shallowReactive({ nested: { count: 0 } })
+ *
+ * state.nested.count++ // 不会触发 effect（嵌套对象未深度代理）
+ * state.nested = { count: 1 } // 会触发 effect（顶层属性变更）
+ * ```
+ */
+export declare function shallowReactive<T extends object>(target: T): T;
+/**
+ * 判断一个值是否为 shallowReactive 创建的浅层响应式对象
+ */
+export declare function isShallowReactive(value: unknown): boolean;
+//#endregion
+//# sourceMappingURL=shallow.d.mts.map

package/dist/dev/reactivity/reactive/shared.d.mts

@@ -0,0 +1,4 @@
+//#region src/reactivity/reactive/shared.d.ts
+export declare function toRaw<T>(observed: T): T;
+//#endregion
+//# sourceMappingURL=shared.d.mts.map

package/dist/dev/reactivity/reactive/shared.mjs

@@ -31,8 +31,7 @@ function isArrayIndexKey(key) {
 	return Number.isInteger(n) && n >= 0 && String(n) === key;
 }
 function toRaw(observed) {
-	var _ReactiveFlags$RAW;
-	return (_ReactiveFlags$RAW = observed === null || observed === void 0 ? void 0 : observed["__r_raw"]) !== null && _ReactiveFlags$RAW !== void 0 ? _ReactiveFlags$RAW : observed;
+	return observed?.["__r_raw"] ?? observed;
 }
 
 //#endregion

package/dist/dev/reactivity/reactive/shared.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"shared.mjs","names":[],"sources":["../../../../src/reactivity/reactive/shared.ts"],"sourcesContent":["export enum ReactiveFlags {\n  IS_REACTIVE = '__r_isReactive',\n  IS_READONLY = '__r_isReadonly',\n  RAW = '__r_raw',\n  SKIP = '__r_skip', // 标记此对象无需转换为响应式（用于 markRaw）\n}\n\nexport enum TargetType {\n  INVALID = 0,\n  COMMON = 1,\n}\n\nexport function isObject(value: unknown): value is object {\n  return typeof value === 'object' && value !== null\n}\n\nexport function hasOwn(source: object, key: PropertyKey) {\n  return Object.prototype.hasOwnProperty.call(source, key)\n}\n\nexport function toRawType(value: unknown) {\n  return Object.prototype.toString.call(value).slice(8, -1)\n}\n\nfunction targetTypeMap(rawType: string) {\n  switch (rawType) {\n    case 'Object':\n    case 'Array':\n      return TargetType.COMMON\n    case 'Map':\n    case 'Set':\n    case 'WeakMap':\n    case 'WeakSet':\n      // TODO: 后续如需支持集合响应式，需要引入专门的 collection handlers。\n      return TargetType.INVALID\n    default:\n      return TargetType.INVALID\n  }\n}\n\nexport function getTargetType(value: object) {\n  return (value as any)[ReactiveFlags.SKIP]\n    ? TargetType.INVALID\n    : targetTypeMap(toRawType(value))\n}\n\n// 版本键（VERSION_KEY）表示“任意字段发生变化”，用于订阅整体版本避免深度遍历跟踪\nexport const VERSION_KEY: unique symbol = Symbol('wevu.version')\n\nexport function isArrayIndexKey(key: string) {\n  if (!key) {\n    return false\n  }\n  const code0 = key.charCodeAt(0)\n  if (code0 < 48 || code0 > 57) {\n    return false\n  }\n  const n = Number(key)\n  return Number.isInteger(n) && n >= 0 && String(n) === key\n}\n\nexport function toRaw<T>(observed: T): T {\n  return ((observed as any)?.[ReactiveFlags.RAW] ?? observed) as T\n}\n"],"mappings":";AAYA,SAAgB,SAAS,OAAiC;CACxD,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAgB,OAAO,QAAgB,KAAkB;CACvD,OAAO,OAAO,UAAU,eAAe,KAAK,QAAQ,GAAG;AACzD;AAEA,SAAgB,UAAU,OAAgB;CACxC,OAAO,OAAO,UAAU,SAAS,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;AAC1D;AAEA,SAAS,cAAc,SAAiB;CACtC,QAAQ,SAAR;EACE,KAAK;EACL,KAAK,SACH;EACF,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,WAEH;EACF,SACE;CACJ;AACF;AAEA,SAAgB,cAAc,OAAe;CAC3C,OAAQ,wBAEJ,cAAc,UAAU,KAAK,CAAC;AACpC;AAGA,MAAa,cAA6B,OAAO,cAAc;AAE/D,SAAgB,gBAAgB,KAAa;CAC3C,IAAI,CAAC,KACH,OAAO;CAET,MAAM,QAAQ,IAAI,WAAW,CAAC;CAC9B,IAAI,QAAQ,MAAM,QAAQ,IACxB,OAAO;CAET,MAAM,IAAI,OAAO,GAAG;CACpB,OAAO,OAAO,UAAU,CAAC,KAAK,KAAK,KAAK,OAAO,CAAC,MAAM;AACxD;AAEA,SAAgB,MAAS,UAAgB;;CACvC,iFAAS,sFAAyC;AACpD"}
+{"version":3,"file":"shared.mjs","names":[],"sources":["../../../../src/reactivity/reactive/shared.ts"],"sourcesContent":["export enum ReactiveFlags {\n  IS_REACTIVE = '__r_isReactive',\n  IS_READONLY = '__r_isReadonly',\n  RAW = '__r_raw',\n  SKIP = '__r_skip', // 标记此对象无需转换为响应式（用于 markRaw）\n}\n\nexport enum TargetType {\n  INVALID = 0,\n  COMMON = 1,\n}\n\nexport function isObject(value: unknown): value is object {\n  return typeof value === 'object' && value !== null\n}\n\nexport function hasOwn(source: object, key: PropertyKey) {\n  return Object.prototype.hasOwnProperty.call(source, key)\n}\n\nexport function toRawType(value: unknown) {\n  return Object.prototype.toString.call(value).slice(8, -1)\n}\n\nfunction targetTypeMap(rawType: string) {\n  switch (rawType) {\n    case 'Object':\n    case 'Array':\n      return TargetType.COMMON\n    case 'Map':\n    case 'Set':\n    case 'WeakMap':\n    case 'WeakSet':\n      // TODO: 后续如需支持集合响应式，需要引入专门的 collection handlers。\n      return TargetType.INVALID\n    default:\n      return TargetType.INVALID\n  }\n}\n\nexport function getTargetType(value: object) {\n  return (value as any)[ReactiveFlags.SKIP]\n    ? TargetType.INVALID\n    : targetTypeMap(toRawType(value))\n}\n\n// 版本键（VERSION_KEY）表示“任意字段发生变化”，用于订阅整体版本避免深度遍历跟踪\nexport const VERSION_KEY: unique symbol = Symbol('wevu.version')\n\nexport function isArrayIndexKey(key: string) {\n  if (!key) {\n    return false\n  }\n  const code0 = key.charCodeAt(0)\n  if (code0 < 48 || code0 > 57) {\n    return false\n  }\n  const n = Number(key)\n  return Number.isInteger(n) && n >= 0 && String(n) === key\n}\n\nexport function toRaw<T>(observed: T): T {\n  return ((observed as any)?.[ReactiveFlags.RAW] ?? observed) as T\n}\n"],"mappings":";AAYA,SAAgB,SAAS,OAAiC;CACxD,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAgB,OAAO,QAAgB,KAAkB;CACvD,OAAO,OAAO,UAAU,eAAe,KAAK,QAAQ,GAAG;AACzD;AAEA,SAAgB,UAAU,OAAgB;CACxC,OAAO,OAAO,UAAU,SAAS,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;AAC1D;AAEA,SAAS,cAAc,SAAiB;CACtC,QAAQ,SAAR;EACE,KAAK;EACL,KAAK,SACH;EACF,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,WAEH;EACF,SACE;CACJ;AACF;AAEA,SAAgB,cAAc,OAAe;CAC3C,OAAQ,wBAEJ,cAAc,UAAU,KAAK,CAAC;AACpC;AAGA,MAAa,cAA6B,OAAO,cAAc;AAE/D,SAAgB,gBAAgB,KAAa;CAC3C,IAAI,CAAC,KACH,OAAO;CAET,MAAM,QAAQ,IAAI,WAAW,CAAC;CAC9B,IAAI,QAAQ,MAAM,QAAQ,IACxB,OAAO;CAET,MAAM,IAAI,OAAO,GAAG;CACpB,OAAO,OAAO,UAAU,CAAC,KAAK,KAAK,KAAK,OAAO,CAAC,MAAM;AACxD;AAEA,SAAgB,MAAS,UAAgB;CACvC,OAAS,yBAAyC;AACpD"}

package/dist/dev/reactivity/reactive.d.mts

@@ -0,0 +1,42 @@
+import { MutationKind, MutationOp, MutationRecord, addMutationRecorder, removeMutationRecorder } from "./reactive/mutation.mjs";
+import { PrelinkReactiveTreeOptions, prelinkReactiveTree, touchReactive } from "./reactive/patch.mjs";
+import { isShallowReactive, shallowReactive } from "./reactive/shallow.mjs";
+import { toRaw } from "./reactive/shared.mjs";
+//#region src/reactivity/reactive.d.ts
+/**
+ * 读取响应式版本号（框架内部调试能力）。
+ * @internal
+ */
+export declare function getReactiveVersion(target: object): number;
+export declare function reactive<T extends object>(target: T): T;
+export declare function isReactive(value: unknown): boolean;
+/**
+ * 标记对象为“原始”状态，后续不会被转换为响应式，返回原对象本身。
+ *
+ * @param value 需要标记的对象
+ * @returns 带有跳过标记的原对象
+ *
+ * @example
+ * ```ts
+ * const foo = markRaw({
+ *   nested: {}
+ * })
+ *
+ * const state = reactive({
+ *   foo
+ * })
+ *
+ * state.foo // 不是响应式对象
+ * ```
+ */
+export declare function markRaw<T extends object>(value: T): T;
+/**
+ * 判断某个值是否被标记为原始（即不应转换为响应式）。
+ *
+ * @param value 待检测的值
+ * @returns 若含有跳过标记则返回 true
+ */
+export declare function isRaw(value: unknown): boolean;
+//#endregion
+export { type MutationKind, type MutationOp, type MutationRecord, type PrelinkReactiveTreeOptions, addMutationRecorder, isShallowReactive, prelinkReactiveTree, removeMutationRecorder, shallowReactive, toRaw, touchReactive };
+//# sourceMappingURL=reactive.d.mts.map

package/dist/dev/reactivity/reactive.mjs

@@ -16,25 +16,22 @@ function getReactiveVersion(target) {
 	return getRawVersion(raw);
 }
 function emitMutation(target, key, op) {
-	var _rawRootMap$get;
 	if (!mutationRecorders.size) return;
 	if (typeof key !== "string") return;
 	if (key.startsWith("__r_")) return;
-	const root = (_rawRootMap$get = rawRootMap.get(target)) !== null && _rawRootMap$get !== void 0 ? _rawRootMap$get : target;
+	const root = rawRootMap.get(target) ?? target;
 	const kind = Array.isArray(target) && (key === "length" || isArrayIndexKey(key)) ? "array" : "property";
 	const baseSegments = resolvePathToTarget(root, target);
 	if (!baseSegments) {
 		const fallback = /* @__PURE__ */ new Set();
 		const parents = rawParentsMap.get(target);
 		if (parents) for (const [parent, keys] of parents) {
-			var _resolvePathToTarget;
 			const parentPath = rawPathMap.get(parent);
 			const topFromParentPath = parentPath ? parentPath.split(".", 1)[0] : void 0;
-			const topFromResolve = !topFromParentPath ? (_resolvePathToTarget = resolvePathToTarget(root, parent)) === null || _resolvePathToTarget === void 0 ? void 0 : _resolvePathToTarget[0] : void 0;
+			const topFromResolve = !topFromParentPath ? resolvePathToTarget(root, parent)?.[0] : void 0;
 			for (const k of keys) {
-				var _ref;
 				if (typeof k !== "string") continue;
-				fallback.add((_ref = topFromParentPath !== null && topFromParentPath !== void 0 ? topFromParentPath : topFromResolve) !== null && _ref !== void 0 ? _ref : k);
+				fallback.add(topFromParentPath ?? topFromResolve ?? k);
 			}
 		}
 		else fallback.add(key);
@@ -74,9 +71,8 @@ const mutableHandlers = {
 		const res = Reflect.get(target, key, receiver);
 		track(target, key);
 		if (isObject(res)) {
-			var _ReactiveFlags$RAW;
 			if (res["__r_skip"]) return res;
-			const childRaw = (_ReactiveFlags$RAW = res === null || res === void 0 ? void 0 : res["__r_raw"]) !== null && _ReactiveFlags$RAW !== void 0 ? _ReactiveFlags$RAW : res;
+			const childRaw = res?.["__r_raw"] ?? res;
 			adoptReactiveRoot(childRaw, target);
 			recordParentLink(childRaw, target, key);
 			const parentPath = rawPathMap.get(target);
@@ -132,8 +128,7 @@ const mutableHandlers = {
 		const oldValue = hadKey ? target[key] : void 0;
 		const result = Reflect.deleteProperty(target, key);
 		if (hadKey && result) {
-			var _ReactiveFlags$RAW2;
-			const oldRaw = isObject(oldValue) ? (_ReactiveFlags$RAW2 = oldValue === null || oldValue === void 0 ? void 0 : oldValue["__r_raw"]) !== null && _ReactiveFlags$RAW2 !== void 0 ? _ReactiveFlags$RAW2 : oldValue : void 0;
+			const oldRaw = isObject(oldValue) ? oldValue?.["__r_raw"] ?? oldValue : void 0;
 			if (oldRaw) removeParentLink(oldRaw, target, key);
 			batch(() => {
 				trigger(target, key);