@echojs-ecosystem/reactivity 0.1.0

package/README.md

@@ -0,0 +1,78 @@
+<div align="center">
+
+# @echojs-ecosystem/reactivity
+
+**Fine-grained reactive primitives — signals, computed, effects, and batching.**
+
+[![npm](https://img.shields.io/npm/v/@echojs-ecosystem/reactivity)](https://www.npmjs.com/package/@echojs-ecosystem/reactivity)
+[![docs](https://img.shields.io/badge/docs-echojs.dev-blue)](https://echojs.dev/docs/packages/reactivity)
+
+</div>
+
+---
+
+The reactive foundation of EchoJS. Built on a fast signal engine, wrapped in a **strict, object-oriented API** that encourages predictable updates and immutable patterns.
+
+## Features
+
+- **`signal`** — writable cells with `.value()`, `.set()`, `.update()`, `.peek()`, `.subscribe()`
+- **`computed`** — lazy derived values with automatic dependency tracking
+- **`effect` / `scope`** — side effects with automatic cleanup
+- **`batch`** — coalesce multiple writes into one notification wave
+- **`DeepReadonly`** — object reads cannot be mutated through `.value()`; use `.set()` / `.update()`
+
+## Install
+
+```bash
+npm install @echojs-ecosystem/reactivity
+# bun add @echojs-ecosystem/reactivity
+# pnpm add @echojs-ecosystem/reactivity
+```
+
+## Quick start
+
+```ts
+import { signal, computed, effect, batch } from "@echojs-ecosystem/reactivity";
+
+const $count = signal(0);
+const $double = computed(() => $count.value() * 2);
+
+effect(() => {
+  console.log("count:", $count.value(), "double:", $double.value());
+});
+
+batch(() => {
+  $count.set(1);
+  $count.update((n) => n + 1);
+});
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `signal(initial)` | Writable reactive cell |
+| `computed(getter)` | Readonly derived signal |
+| `effect(fn)` | Runs immediately, re-runs on dependency changes; returns disposer |
+| `scope(fn)` | Effect scope — nested effects cleaned up together |
+| `batch(fn)` | Defer reactions until the batch completes |
+| `readonly($sig)` | Readonly facade without `.set()` / `.update()` |
+| `isSignal` / `isReadonlySignal` | Runtime type guards |
+
+### Design notes
+
+- **Write only via `.set()` / `.update()`** — no public `trigger()` API
+- **`subscribe()`** fires on changes only, not on initial subscribe
+- **Dev mode** deep-freezes object/array values written to signals
+
+## Related packages
+
+| Package | Role |
+|---------|------|
+| [`@echojs-ecosystem/hyperdom`](https://www.npmjs.com/package/@echojs-ecosystem/hyperdom) | DOM views wired to signals |
+| [`@echojs-ecosystem/store`](https://www.npmjs.com/package/@echojs-ecosystem/store) | Structured app state on top of signals |
+| [`@echojs-ecosystem/framework`](https://www.npmjs.com/package/@echojs-ecosystem/framework) | Meta-package — entire ecosystem via subpath imports |
+
+## Documentation
+
+[echojs.dev/docs/packages/reactivity](https://echojs.dev/docs/packages/reactivity)

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+declare const batch: <T>(fn: () => T) => T;
+
+type CleanupFn = () => void;
+declare const cleanup: (fn: CleanupFn) => void;
+
+type DeepReadonly<T> = T extends (...args: any[]) => any ? T : T extends readonly (infer U)[] ? readonly DeepReadonly<U>[] : T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
+type ReadValue<T> = T extends object ? DeepReadonly<T> : T;
+interface ReadonlySignal<T> {
+    value(): ReadValue<T>;
+    peek(): ReadValue<T>;
+    subscribe(fn: () => void): () => void;
+}
+interface Signal<T> extends ReadonlySignal<T> {
+    set(next: T): void;
+    update(fn: (prev: T) => T): void;
+    readonly(): ReadonlySignal<T>;
+}
+
+declare const computed: <T>(getter: () => T) => ReadonlySignal<T>;
+
+declare const effect: (fn: () => void) => (() => void);
+
+declare const readonly: <T>(sig: Signal<T> | ReadonlySignal<T>) => ReadonlySignal<T>;
+
+declare const scope: (fn: () => void) => (() => void);
+
+declare const signal: <T>(initial: T) => Signal<T>;
+
+declare const isSignal: (value: unknown) => value is Signal<unknown> | ReadonlySignal<unknown>;
+declare const isReadonlySignal: (value: unknown) => value is ReadonlySignal<unknown>;
+
+export { type DeepReadonly, type ReadValue, type ReadonlySignal, type Signal, batch, cleanup, computed, effect, isReadonlySignal, isSignal, readonly, scope, signal };

package/dist/index.js

@@ -0,0 +1,250 @@
+import { startBatch, endBatch, computed as computed$1, effect as effect$1, effectScope, signal as signal$1, setActiveSub } from 'alien-signals';
+
+// src/utils.ts
+var isObjectLike = (value) => {
+  return typeof value === "object" && value !== null;
+};
+var isFunction = (value) => {
+  return typeof value === "function";
+};
+var createAlienSignal = (initial) => {
+  return signal$1(initial);
+};
+var createAlienComputed = (getter) => {
+  return computed$1(getter);
+};
+var createAlienEffect = (fn) => {
+  return effect$1(fn);
+};
+var createAlienScope = (fn) => {
+  return effectScope(fn);
+};
+var batch = (fn) => {
+  startBatch();
+  try {
+    return fn();
+  } finally {
+    endBatch();
+  }
+};
+var untrack = (fn) => {
+  const prev = setActiveSub(void 0);
+  try {
+    return fn();
+  } finally {
+    setActiveSub(prev);
+  }
+};
+
+// src/batch.ts
+var batch2 = (fn) => {
+  if (!isFunction(fn)) {
+    throw new TypeError("batch(fn) expects a function");
+  }
+  return batch(fn);
+};
+
+// src/cleanup.ts
+var currentBucket;
+var __withCleanupBucket = (bucket, fn) => {
+  const prev = currentBucket;
+  currentBucket = bucket;
+  try {
+    return fn();
+  } finally {
+    currentBucket = prev;
+  }
+};
+var __runCleanupBucket = (bucket) => {
+  for (let i = bucket.length - 1; i >= 0; i--) {
+    try {
+      bucket[i]?.();
+    } catch {
+    }
+  }
+  bucket.length = 0;
+};
+var cleanup = (fn) => {
+  if (!isFunction(fn)) {
+    throw new TypeError("cleanup(fn) expects a function");
+  }
+  if (!currentBucket) {
+    throw new Error("cleanup(fn) must be called inside scope()");
+  }
+  currentBucket.push(fn);
+};
+var __wrapDisposerWithCleanup = (dispose, bucket) => {
+  let disposed = false;
+  return () => {
+    if (disposed) return;
+    disposed = true;
+    try {
+      dispose();
+    } finally {
+      __runCleanupBucket(bucket);
+    }
+  };
+};
+
+// src/subscribe.ts
+var createSubscribe = (readTracked) => {
+  return (fn) => {
+    if (!isFunction(fn)) {
+      throw new TypeError("subscribe(fn) expects a function");
+    }
+    let inited = false;
+    let prev;
+    const stop = createAlienEffect(() => {
+      const next = readTracked();
+      if (!inited) {
+        inited = true;
+        prev = next;
+        return;
+      }
+      if (Object.is(prev, next)) return;
+      prev = next;
+      fn();
+    });
+    return stop;
+  };
+};
+
+// src/internals/guards.ts
+var kSignalBrand = /* @__PURE__ */ Symbol.for("echojs-ecosystem.reactivity.signal");
+var kReadonlyBrand = /* @__PURE__ */ Symbol.for("echojs-ecosystem.reactivity.readonlySignal");
+var brandWritable = (obj) => {
+  Object.defineProperty(obj, kSignalBrand, { value: true });
+  return obj;
+};
+var brandReadonly = (obj) => {
+  Object.defineProperty(obj, kSignalBrand, { value: true });
+  Object.defineProperty(obj, kReadonlyBrand, { value: true });
+  return obj;
+};
+var isBrandedSignal = (value) => {
+  return typeof value === "object" && value !== null && value[kSignalBrand] === true;
+};
+var isBrandedReadonlySignal = (value) => {
+  return typeof value === "object" && value !== null && value[kSignalBrand] === true && value[kReadonlyBrand] === true;
+};
+
+// src/computed.ts
+var computed = (getter) => {
+  if (!isFunction(getter)) {
+    throw new TypeError("computed(getter) expects a function");
+  }
+  const engine = createAlienComputed(() => getter());
+  const readTracked = () => engine();
+  const readUntracked = () => untrack(() => engine());
+  const subscribe = createSubscribe(readTracked);
+  return brandReadonly({
+    value: () => readTracked(),
+    peek: () => readUntracked(),
+    subscribe
+  });
+};
+
+// src/effect.ts
+var effect = (fn) => {
+  if (!isFunction(fn)) {
+    throw new TypeError("effect(fn) expects a function");
+  }
+  return createAlienEffect(fn);
+};
+
+// src/readonly.ts
+var readonly = (sig) => {
+  if (!isFunction(sig.set)) return sig;
+  if (!isFunction(sig.readonly)) return sig.readonly();
+  return brandReadonly({
+    value: () => sig.value(),
+    peek: () => sig.peek(),
+    subscribe: (fn) => sig.subscribe(fn)
+  });
+};
+
+// src/scope.ts
+var scope = (fn) => {
+  if (!isFunction(fn)) {
+    throw new TypeError("scope(fn) expects a function");
+  }
+  const bucket = [];
+  const dispose = createAlienScope(() => __withCleanupBucket(bucket, fn));
+  return __wrapDisposerWithCleanup(dispose, bucket);
+};
+
+// src/freeze.ts
+var DEV = (() => {
+  const env = globalThis?.process?.env;
+  const nodeEnv = env?.NODE_ENV;
+  return nodeEnv !== "production";
+})();
+var deepFreezeImpl = (value, seen) => {
+  if (!isObjectLike(value)) return;
+  if (Object.isFrozen(value)) return;
+  if (seen.has(value)) return;
+  seen.add(value);
+  const keys = Object.keys(value);
+  for (const k of keys) {
+    deepFreezeImpl(value[k], seen);
+  }
+  Object.freeze(value);
+};
+var freezeIfDev = (value) => {
+  if (!DEV) return value;
+  if (!isObjectLike(value)) return value;
+  deepFreezeImpl(value, /* @__PURE__ */ new WeakSet());
+  return value;
+};
+
+// src/signal.ts
+var createReadonlySignalFacade = (impl) => {
+  return brandReadonly({
+    value: impl.value,
+    peek: impl.peek,
+    subscribe: impl.subscribe
+  });
+};
+var signalImpl = (...args) => {
+  if (args.length === 0) {
+    throw new TypeError("signal(initial) expects 1 argument");
+  }
+  const initial = args[0];
+  const engine = createAlienSignal(freezeIfDev(initial));
+  const readTracked = () => engine();
+  const readUntracked = () => untrack(() => engine());
+  const subscribe = createSubscribe(readTracked);
+  const readonlyFacade = createReadonlySignalFacade({
+    value: () => readTracked(),
+    peek: () => readUntracked(),
+    subscribe
+  });
+  const writable = brandWritable({
+    value: () => readTracked(),
+    peek: () => readUntracked(),
+    subscribe,
+    set: (next) => {
+      engine(freezeIfDev(next));
+    },
+    update: (fn) => {
+      const prev = readUntracked();
+      const next = fn(prev);
+      engine(freezeIfDev(next));
+    },
+    readonly: () => readonlyFacade
+  });
+  return writable;
+};
+var signal = signalImpl;
+
+// src/public-guards.ts
+var isSignal = (value) => {
+  return isBrandedSignal(value);
+};
+var isReadonlySignal = (value) => {
+  return isBrandedReadonlySignal(value);
+};
+
+export { batch2 as batch, cleanup, computed, effect, isReadonlySignal, isSignal, readonly, scope, signal };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/internals/alien.ts","../src/batch.ts","../src/cleanup.ts","../src/subscribe.ts","../src/internals/guards.ts","../src/computed.ts","../src/effect.ts","../src/readonly.ts","../src/scope.ts","../src/freeze.ts","../src/signal.ts","../src/public-guards.ts"],"names":["alienSignal","alienComputed","alienEffect","alienEffectScope","alienStartBatch","alienEndBatch","alienSetActiveSub","batch"],"mappings":"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","file":"index.js","sourcesContent":["export type AnyFn = (...args: any[]) => any;\n\nexport const isObjectLike = (value: unknown): value is Record<string, unknown> => {\n  return typeof value === \"object\" && value !== null;\n};\n\nexport const isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (!isObjectLike(value)) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nexport const isFunction = (value: unknown): value is Function => {\n  return typeof value === \"function\";\n};\n","import {\n  computed as alienComputed,\n  effect as alienEffect,\n  effectScope as alienEffectScope,\n  endBatch as alienEndBatch,\n  setActiveSub as alienSetActiveSub,\n  signal as alienSignal,\n  startBatch as alienStartBatch,\n} from \"alien-signals\";\n\nexport type Disposer = () => void;\n\nexport const createAlienSignal = <T>(initial: T) => {\n  return alienSignal(initial);\n};\n\nexport const createAlienComputed = <T>(getter: (prev?: T) => T) => {\n  return alienComputed(getter);\n};\n\nexport const createAlienEffect = (fn: () => void): Disposer => {\n  return alienEffect(fn);\n};\n\nexport const createAlienScope = (fn: () => void): Disposer => {\n  return alienEffectScope(fn);\n};\n\nexport const batch = <T>(fn: () => T): T => {\n  alienStartBatch();\n  try {\n    return fn();\n  } finally {\n    alienEndBatch();\n  }\n};\n\nexport const untrack = <T>(fn: () => T): T => {\n  const prev = alienSetActiveSub(undefined);\n  try {\n    return fn();\n  } finally {\n    alienSetActiveSub(prev);\n  }\n};\n","import { isFunction } from \"./utils\";\nimport { batch as alienBatch } from \"./internals/alien.js\";\n\nexport const batch = <T>(fn: () => T): T => {\n  if (!isFunction(fn)) {\n    throw new TypeError(\"batch(fn) expects a function\");\n  }\n  return alienBatch(fn);\n};\n","import { isFunction } from \"./utils\";\nimport type { Disposer } from \"./internals/alien.js\";\n\ntype CleanupFn = () => void;\n\nlet currentBucket: CleanupFn[] | undefined;\n\nexport const __withCleanupBucket = <T>(bucket: CleanupFn[], fn: () => T): T => {\n  const prev = currentBucket;\n  currentBucket = bucket;\n  try {\n    return fn();\n  } finally {\n    currentBucket = prev;\n  }\n};\n\nexport const __runCleanupBucket = (bucket: CleanupFn[]): void => {\n  for (let i = bucket.length - 1; i >= 0; i--) {\n    try {\n      bucket[i]?.();\n    } catch {\n      // best-effort cleanup: userland errors shouldn't break disposal\n    }\n  }\n  bucket.length = 0;\n};\n\nexport const cleanup = (fn: CleanupFn): void => {\n  if (!isFunction(fn)) {\n    throw new TypeError(\"cleanup(fn) expects a function\");\n  }\n  if (!currentBucket) {\n    throw new Error(\"cleanup(fn) must be called inside scope()\");\n  }\n  currentBucket.push(fn);\n};\n\nexport const __wrapDisposerWithCleanup = (dispose: Disposer, bucket: CleanupFn[]): Disposer => {\n  let disposed = false;\n  return () => {\n    if (disposed) return;\n    disposed = true;\n    try {\n      dispose();\n    } finally {\n      __runCleanupBucket(bucket);\n    }\n  };\n};\n","import { createAlienEffect, type Disposer } from \"./internals/alien.js\";\nimport { isFunction } from \"./utils\";\n\nexport const createSubscribe = (readTracked: () => unknown): ((fn: () => void) => Disposer) => {\n  return (fn) => {\n    if (!isFunction(fn)) {\n      throw new TypeError(\"subscribe(fn) expects a function\");\n    }\n\n    let inited = false;\n    let prev: unknown;\n\n    const stop = createAlienEffect(() => {\n      const next = readTracked();\n\n      if (!inited) {\n        inited = true;\n        prev = next;\n        return;\n      }\n\n      if (Object.is(prev, next)) return;\n      prev = next;\n      fn();\n    });\n\n    return stop;\n  };\n};\n","const kSignalBrand: unique symbol = Symbol.for(\"echojs-ecosystem.reactivity.signal\");\nconst kReadonlyBrand: unique symbol = Symbol.for(\"echojs-ecosystem.reactivity.readonlySignal\");\n\nexport type BrandedSignal = {\n  [kSignalBrand]: true;\n  [kReadonlyBrand]?: true;\n};\n\nexport const brandWritable = <T extends object>(obj: T): T & BrandedSignal => {\n  Object.defineProperty(obj, kSignalBrand, { value: true });\n  return obj as T & BrandedSignal;\n};\n\nexport const brandReadonly = <T extends object>(obj: T): T & BrandedSignal => {\n  Object.defineProperty(obj, kSignalBrand, { value: true });\n  Object.defineProperty(obj, kReadonlyBrand, { value: true });\n  return obj as T & BrandedSignal;\n};\n\nexport const isBrandedSignal = (value: unknown): value is BrandedSignal => {\n  return typeof value === \"object\" && value !== null && (value as any)[kSignalBrand] === true;\n};\n\nexport const isBrandedReadonlySignal = (value: unknown): value is BrandedSignal => {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as any)[kSignalBrand] === true &&\n    (value as any)[kReadonlyBrand] === true\n  );\n};\n","import { createSubscribe } from \"./subscribe\";\nimport { createAlienComputed, untrack } from \"./internals/alien.js\";\nimport { brandReadonly } from \"./internals/guards.js\";\nimport type { ReadonlySignal, ReadValue } from \"./types\";\nimport { isFunction } from \"./utils\";\n\nexport const computed = <T>(getter: () => T): ReadonlySignal<T> => {\n  if (!isFunction(getter)) {\n    throw new TypeError(\"computed(getter) expects a function\");\n  }\n\n  const engine = createAlienComputed<T>(() => getter());\n\n  const readTracked = (): T => engine();\n  const readUntracked = (): T => untrack(() => engine());\n\n  const subscribe = createSubscribe(readTracked);\n\n  return brandReadonly({\n    value: () => readTracked() as ReadValue<T>,\n    peek: () => readUntracked() as ReadValue<T>,\n    subscribe,\n  }) as ReadonlySignal<T>;\n};\n","import { isFunction } from \"./utils\";\nimport { createAlienEffect } from \"./internals/alien.js\";\n\nexport const effect = (fn: () => void): (() => void) => {\n  if (!isFunction(fn)) {\n    throw new TypeError(\"effect(fn) expects a function\");\n  }\n  return createAlienEffect(fn);\n};\n","import { brandReadonly } from \"./internals/guards.js\";\nimport type { ReadonlySignal, Signal } from \"./types\";\nimport { isFunction } from \"./utils\";\n\nexport const readonly = <T>(sig: Signal<T> | ReadonlySignal<T>): ReadonlySignal<T> => {\n  if (!isFunction((sig as any).set)) return sig as ReadonlySignal<T>;\n  if (!isFunction((sig as any).readonly)) return (sig as Signal<T>).readonly();\n\n  return brandReadonly({\n    value: () => sig.value(),\n    peek: () => sig.peek(),\n    subscribe: (fn: () => void) => sig.subscribe(fn),\n  }) as ReadonlySignal<T>;\n};\n","import { createAlienScope } from \"./internals/alien.js\";\nimport { __withCleanupBucket, __wrapDisposerWithCleanup } from \"./cleanup\";\nimport { isFunction } from \"./utils\";\n\nexport const scope = (fn: () => void): (() => void) => {\n  if (!isFunction(fn)) {\n    throw new TypeError(\"scope(fn) expects a function\");\n  }\n\n  const bucket: Array<() => void> = [];\n  const dispose = createAlienScope(() => __withCleanupBucket(bucket, fn));\n  return __wrapDisposerWithCleanup(dispose, bucket);\n};\n","import { isObjectLike } from \"./utils\";\n\nconst DEV = ((): boolean => {\n  const env = (globalThis as any)?.process?.env;\n  const nodeEnv = env?.NODE_ENV;\n  return nodeEnv !== \"production\";\n})();\n\nconst deepFreezeImpl = (value: unknown, seen: WeakSet<object>): void => {\n  if (!isObjectLike(value)) return;\n  if (Object.isFrozen(value)) return;\n  if (seen.has(value)) return;\n  seen.add(value);\n\n  const keys = Object.keys(value);\n  for (const k of keys) {\n    deepFreezeImpl((value as any)[k], seen);\n  }\n\n  Object.freeze(value);\n};\n\nexport const freezeIfDev = <T>(value: T): T => {\n  if (!DEV) return value;\n  if (!isObjectLike(value)) return value;\n\n  deepFreezeImpl(value, new WeakSet());\n  return value;\n};\n\nexport const __isDevModeForTests = (): boolean => {\n  return DEV;\n};\n","import { freezeIfDev } from \"./freeze\";\nimport { createSubscribe } from \"./subscribe\";\nimport { createAlienSignal, untrack } from \"./internals/alien.js\";\nimport { brandReadonly, brandWritable } from \"./internals/guards.js\";\nimport type { ReadonlySignal, ReadValue, Signal } from \"./types\";\nimport { isFunction } from \"./utils\";\n\nexport const createReadonlySignalFacade = <T>(impl: {\n  value(): ReadValue<T>;\n  peek(): ReadValue<T>;\n  subscribe(fn: () => void): () => void;\n}): ReadonlySignal<T> => {\n  return brandReadonly({\n    value: impl.value,\n    peek: impl.peek,\n    subscribe: impl.subscribe,\n  });\n};\n\nconst signalImpl = <T>(...args: [initial: T] | []): Signal<T> => {\n  if (args.length === 0) {\n    throw new TypeError(\"signal(initial) expects 1 argument\");\n  }\n\n  const initial = args[0] as T;\n  const engine = createAlienSignal(freezeIfDev(initial));\n\n  const readTracked = (): T => engine();\n  const readUntracked = (): T => untrack(() => engine());\n\n  const subscribe = createSubscribe(readTracked);\n\n  const readonlyFacade = createReadonlySignalFacade<T>({\n    value: () => readTracked() as ReadValue<T>,\n    peek: () => readUntracked() as ReadValue<T>,\n    subscribe,\n  });\n\n  const writable: Signal<T> = brandWritable({\n    value: () => readTracked() as ReadValue<T>,\n    peek: () => readUntracked() as ReadValue<T>,\n    subscribe,\n    set: (next: T) => {\n      engine(freezeIfDev(next));\n    },\n    update: (fn: (prev: T) => T) => {\n      const prev = readUntracked();\n      const next = fn(prev);\n      engine(freezeIfDev(next));\n    },\n    readonly: () => readonlyFacade,\n  });\n\n  return writable;\n};\n\nexport const signal = signalImpl as <T>(initial: T) => Signal<T>;\n","import { isBrandedReadonlySignal, isBrandedSignal } from \"./internals/guards.js\";\nimport type { ReadonlySignal, Signal } from \"./types\";\n\nexport const isSignal = (value: unknown): value is Signal<unknown> | ReadonlySignal<unknown> => {\n  return isBrandedSignal(value);\n};\n\nexport const isReadonlySignal = (value: unknown): value is ReadonlySignal<unknown> => {\n  return isBrandedReadonlySignal(value);\n};\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@echojs-ecosystem/reactivity",
+  "version": "0.1.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.typing.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.typing.json --noEmit",
+    "test:types": "tsc -p tsconfig.typing.json --noEmit",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest ui"
+  },
+  "dependencies": {
+    "alien-signals": "^3.1.2"
+  },
+  "devDependencies": {
+    "@echojs-ecosystem/oxc-config": "workspace:*",
+    "oxlint": "^1.60.0",
+    "typescript": "5.9.2",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/echojs-ecosystem/echojs-core.git",
+    "directory": "packages/reactivity"
+  }
+}