@echojs-ecosystem/store 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+<div align="center">
+
+# @echojs-ecosystem/store
+
+**Structured client state on signals — actions, selectors, and extensions.**
+
+[![npm](https://img.shields.io/npm/v/@echojs-ecosystem/store)](https://www.npmjs.com/package/@echojs-ecosystem/store)
+[![docs](https://img.shields.io/badge/docs-echojs.dev-blue)](https://echojs.dev/docs/packages/store)
+
+</div>
+
+---
+
+Minimal store layer on [`@echojs-ecosystem/reactivity`](https://www.npmjs.com/package/@echojs-ecosystem/reactivity). Framework-agnostic, SSR-friendly — no `localStorage`, no UI bindings. Persistence lives in [`@echojs-ecosystem/persist`](https://www.npmjs.com/package/@echojs-ecosystem/persist).
+
+## Features
+
+- **`createStore`** — `value`, `set`, `update`, `reset`, `subscribe`
+- **Events** — `changed`, `reseted` watchers
+- **`.extend()`** — compose actions, debug, readonly, persist adapters
+- **`select` / `combine`** — derived readonly stores
+- **`withActions`** — typed action factories
+
+## Install
+
+```bash
+npm install @echojs-ecosystem/store @echojs-ecosystem/reactivity
+```
+
+## Quick start
+
+```ts
+import { createStore, withActions, select } from "@echojs-ecosystem/store";
+
+const counter = createStore(0, { name: "counter" }).extend(
+  withActions({
+    increment: (store) => () => store.update((v) => v + 1),
+    add: (store) => (n: number) => store.update((v) => v + n),
+  }),
+);
+
+counter.increment();
+counter.subscribe((value, prev) => console.log({ value, prev }));
+
+const $isPositive = select(counter, (v) => v > 0);
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `createStore` | Mutable store |
+| `select` | Derived readonly store |
+| `combine` | Merge multiple stores |
+| `withActions` | Action extension |
+| `withDebug` / `withReadonly` / `readonly` | Debug & immutability |
+| `batch` | Re-export from `@echojs-ecosystem/reactivity` |
+
+## Persistence
+
+```ts
+import { withLocalStorage } from "@echojs-ecosystem/persist";
+
+const theme = createStore("dark").extend(withLocalStorage({ key: "theme", version: 1 }));
+```
+
+## Documentation
+
+[echojs.dev/docs/packages/store](https://echojs.dev/docs/packages/store)

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { Signal, ReadonlySignal } from '@echojs-ecosystem/reactivity';
+export { batch } from '@echojs-ecosystem/reactivity';
+
+type EqualsFn<T> = (a: T, b: T) => boolean;
+type EqualsOption<T> = false | EqualsFn<T>;
+type StoreOptions<State> = {
+    name?: string;
+    equals?: EqualsOption<State>;
+};
+type StoreEventPayload<State> = {
+    value: State;
+    prevValue: State;
+};
+type StoreEvent<Payload> = {
+    watch(listener: (payload: Payload) => void): () => void;
+    emit(payload: Payload): void;
+};
+type StoreExtension<State, Result extends object> = (store: Store<State>) => Result;
+type ExtensionResult<Ext> = Ext extends StoreExtension<any, infer Result> ? Result : never;
+type Store<State> = {
+    kind: "store";
+    name?: string;
+    value(): State;
+    set(value: State): void;
+    update(updater: (value: State) => State): void;
+    reset(): void;
+    $value: Signal<State>;
+    changed: StoreEvent<StoreEventPayload<State>>;
+    reseted: StoreEvent<StoreEventPayload<State>>;
+    subscribe(listener: (value: State, prevValue: State) => void): () => void;
+    extend<Ext extends StoreExtension<State, any>>(extension: Ext): Store<State> & ExtensionResult<Ext>;
+};
+type ReadonlyStore<State> = {
+    kind: "readonly-store";
+    name?: string;
+    value(): State;
+    $value: ReadonlySignal<State>;
+    changed: StoreEvent<StoreEventPayload<State>>;
+    subscribe(listener: (value: State, prevValue: State) => void): () => void;
+};
+type SourceValues<Sources> = {
+    [K in keyof Sources]: Sources[K] extends Store<infer V> ? V : Sources[K] extends ReadonlyStore<infer V> ? V : never;
+};
+type CombineOptions<Result> = {
+    name?: string;
+    equals?: EqualsOption<Result>;
+};
+type SelectOptions<Selected> = {
+    name?: string;
+    equals?: EqualsOption<Selected>;
+};
+
+declare const createStore: <State>(initialState: State, options?: StoreOptions<State>) => Store<State>;
+
+declare const select: <State, Selected>(store: Store<State>, selector: (state: State) => Selected, options?: SelectOptions<Selected>) => ReadonlyStore<Selected>;
+
+type SourceStore = Store<unknown> | ReadonlyStore<unknown>;
+declare const combine: <Sources extends Record<string, SourceStore>, Result>(sources: Sources, combiner: (values: SourceValues<Sources>) => Result, options?: CombineOptions<Result>) => ReadonlyStore<Result>;
+
+declare const withActions: <State, const Actions extends Record<string, (store: Store<State>) => unknown>>(actions: Actions) => StoreExtension<State, { [K in keyof Actions]: ReturnType<Actions[K]>; }>;
+
+type WithDebugResult = {
+    debugName?: string;
+};
+declare const withDebug: <State>() => StoreExtension<State, WithDebugResult>;
+
+declare const withReadonly: <State>() => StoreExtension<State, Record<string, never>>;
+
+declare const readonly: <State>(store: Store<State>) => ReadonlyStore<State>;
+
+export { type CombineOptions, type EqualsOption, type ExtensionResult, type ReadonlyStore, type SelectOptions, type SourceValues, type Store, type StoreEvent, type StoreEventPayload, type StoreExtension, type StoreOptions, combine, createStore, readonly, select, withActions, withDebug, withReadonly };

package/dist/index.js

@@ -0,0 +1,257 @@
+import { signal, computed, effect } from '@echojs-ecosystem/reactivity';
+export { batch } from '@echojs-ecosystem/reactivity';
+
+// src/index.ts
+var applyStoreUpdate = (internals, $value, next) => {
+  const prev = $value.peek();
+  if (internals.equals(prev, next)) {
+    return;
+  }
+  $value.set(next);
+  internals.notifyChanged(next, prev);
+};
+
+// src/assert-extension-keys.ts
+var STORE_RESERVED_KEYS = /* @__PURE__ */ new Set([
+  "kind",
+  "name",
+  "value",
+  "set",
+  "update",
+  "reset",
+  "$value",
+  "changed",
+  "reseted",
+  "subscribe",
+  "extend"
+]);
+var assertExtensionKeys = (store, extension) => {
+  for (const key of Object.keys(extension)) {
+    if (STORE_RESERVED_KEYS.has(key) || key in store) {
+      throw new Error(`Store extension conflict: key "${key}" already exists`);
+    }
+  }
+};
+
+// src/attach-extend.ts
+var attachExtend = (store) => {
+  store.extend = (extension) => {
+    const extensionResult = extension(store);
+    assertExtensionKeys(store, extensionResult);
+    Object.assign(store, extensionResult);
+    return store;
+  };
+};
+
+// src/create-store-event.ts
+var createStoreEvent = () => {
+  const listeners = /* @__PURE__ */ new Set();
+  return {
+    watch(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    emit(payload) {
+      for (const listener of listeners) {
+        listener(payload);
+      }
+    }
+  };
+};
+
+// src/resolve-equals.ts
+var resolveEquals = (equals) => {
+  if (equals === false) {
+    return () => false;
+  }
+  if (equals) {
+    return equals;
+  }
+  return Object.is;
+};
+
+// src/create-store-internals.ts
+var createStoreInternals = (initialState, equalsOption) => {
+  const equals = resolveEquals(equalsOption);
+  const changed = createStoreEvent();
+  const reseted = createStoreEvent();
+  const listeners = /* @__PURE__ */ new Set();
+  const notifyChanged = (value, prevValue) => {
+    changed.emit({ value, prevValue });
+    for (const listener of listeners) {
+      listener(value, prevValue);
+    }
+  };
+  return {
+    initialState,
+    equals,
+    changed,
+    reseted,
+    listeners,
+    notifyChanged
+  };
+};
+
+// src/create-store.ts
+var createStore = (initialState, options) => {
+  const internals = createStoreInternals(initialState, options?.equals);
+  const $value = signal(initialState);
+  const store = {
+    kind: "store",
+    name: options?.name,
+    $value,
+    changed: internals.changed,
+    reseted: internals.reseted,
+    value() {
+      return $value.value();
+    },
+    set(value) {
+      applyStoreUpdate(internals, $value, value);
+    },
+    update(updater) {
+      const prev = $value.peek();
+      applyStoreUpdate(internals, $value, updater(prev));
+    },
+    reset() {
+      const prev = $value.peek();
+      const next = internals.initialState;
+      internals.reseted.emit({ value: next, prevValue: prev });
+      applyStoreUpdate(internals, $value, next);
+    },
+    subscribe(listener) {
+      internals.listeners.add(listener);
+      return () => {
+        internals.listeners.delete(listener);
+      };
+    },
+    extend() {
+      throw new Error("extend() is not initialized");
+    }
+  };
+  attachExtend(store);
+  return store;
+};
+var createDerivedReadonlyStore = (read, options) => {
+  const equals = resolveEquals(options?.equals);
+  const $value = computed(read);
+  const changed = createStoreEvent();
+  const listeners = /* @__PURE__ */ new Set();
+  let prev = read();
+  effect(() => {
+    const next = read();
+    if (equals(prev, next)) {
+      return;
+    }
+    const previous = prev;
+    prev = next;
+    changed.emit({ value: next, prevValue: previous });
+    for (const listener of listeners) {
+      listener(next, previous);
+    }
+  });
+  return {
+    kind: "readonly-store",
+    name: options?.name,
+    $value,
+    changed,
+    value() {
+      return $value.value();
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+
+// src/select.ts
+var select = (store, selector, options) => {
+  return createDerivedReadonlyStore(() => selector(store.value()), {
+    name: options?.name,
+    equals: options?.equals
+  });
+};
+
+// src/combine.ts
+var combine = (sources, combiner, options) => {
+  const entries = Object.entries(sources);
+  const readSources = () => {
+    const values = {};
+    for (const [key, source] of entries) {
+      values[key] = source.value();
+    }
+    return values;
+  };
+  return createDerivedReadonlyStore(() => combiner(readSources()), {
+    name: options?.name,
+    equals: options?.equals
+  });
+};
+
+// src/with-actions.ts
+var withActions = (actions) => {
+  return (store) => {
+    const result = {};
+    for (const key of Object.keys(actions)) {
+      const factory = actions[key];
+      if (!factory) continue;
+      result[key] = factory(store);
+    }
+    return result;
+  };
+};
+
+// src/with-debug.ts
+var withDebug = () => {
+  return (store) => {
+    const debugName = store.name ?? "anonymous";
+    store.changed.watch(({ value, prevValue }) => {
+      if (typeof console !== "undefined" && typeof console.log === "function") {
+        console.log(`[store:${debugName}]`, { prevValue, value });
+      }
+    });
+    return { debugName };
+  };
+};
+
+// src/with-readonly.ts
+var withReadonly = () => {
+  return (store) => {
+    const mutating = ["set", "update", "reset"];
+    for (const key of mutating) {
+      if (key in store) {
+        store[key] = () => {
+          throw new Error(`Store is readonly: cannot call ${key}()`);
+        };
+      }
+    }
+    store.kind = "readonly-store";
+    return {};
+  };
+};
+
+// src/to-readonly-store.ts
+var toReadonlyStore = (store) => {
+  const readonlyStore = {
+    kind: "readonly-store",
+    name: store.name,
+    value: () => store.value(),
+    $value: store.$value,
+    changed: store.changed,
+    subscribe: (listener) => store.subscribe(listener)
+  };
+  return readonlyStore;
+};
+
+// src/readonly.ts
+var readonly = (store) => {
+  return toReadonlyStore(store);
+};
+
+export { combine, createStore, readonly, select, withActions, withDebug, withReadonly };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/apply-store-update.ts","../src/assert-extension-keys.ts","../src/attach-extend.ts","../src/create-store-event.ts","../src/resolve-equals.ts","../src/create-store-internals.ts","../src/create-store.ts","../src/create-derived-readonly-store.ts","../src/select.ts","../src/combine.ts","../src/with-actions.ts","../src/with-debug.ts","../src/with-readonly.ts","../src/to-readonly-store.ts","../src/readonly.ts"],"names":["signal"],"mappings":"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","file":"index.js","sourcesContent":["import { signal } from \"@echojs-ecosystem/reactivity\";\n\nimport type { StoreInternals } from \"./create-store-internals\";\n\nexport const applyStoreUpdate = <State>(\n  internals: StoreInternals<State>,\n  $value: ReturnType<typeof signal<State>>,\n  next: State,\n): void => {\n  const prev = $value.peek() as State;\n  if (internals.equals(prev, next)) {\n    return;\n  }\n  $value.set(next);\n  internals.notifyChanged(next, prev);\n};\n","const STORE_RESERVED_KEYS = new Set([\n  \"kind\",\n  \"name\",\n  \"value\",\n  \"set\",\n  \"update\",\n  \"reset\",\n  \"$value\",\n  \"changed\",\n  \"reseted\",\n  \"subscribe\",\n  \"extend\",\n]);\n\nexport const assertExtensionKeys = (store: object, extension: object): void => {\n  for (const key of Object.keys(extension)) {\n    if (STORE_RESERVED_KEYS.has(key) || key in store) {\n      throw new Error(`Store extension conflict: key \"${key}\" already exists`);\n    }\n  }\n};\n","import { assertExtensionKeys } from \"./assert-extension-keys\";\nimport type { ExtensionResult, Store, StoreExtension } from \"./types\";\n\nexport const attachExtend = <State>(store: Store<State>): void => {\n  store.extend = <Ext extends StoreExtension<State, any>>(extension: Ext) => {\n    const extensionResult = extension(store);\n    assertExtensionKeys(store, extensionResult);\n    Object.assign(store, extensionResult);\n    return store as Store<State> & ExtensionResult<Ext>;\n  };\n};\n","import type { StoreEvent } from \"./types\";\n\nexport const createStoreEvent = <Payload>(): StoreEvent<Payload> => {\n  const listeners = new Set<(payload: Payload) => void>();\n\n  return {\n    watch(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    emit(payload) {\n      for (const listener of listeners) {\n        listener(payload);\n      }\n    },\n  };\n};\n","import type { EqualsFn, EqualsOption } from \"./types\";\n\nexport const resolveEquals = <T>(equals?: EqualsOption<T>): EqualsFn<T> => {\n  if (equals === false) {\n    return () => false;\n  }\n  if (equals) {\n    return equals;\n  }\n  return Object.is;\n};\n","import { createStoreEvent } from \"./create-store-event\";\nimport { resolveEquals } from \"./resolve-equals\";\nimport type { EqualsFn, EqualsOption, StoreEvent, StoreEventPayload } from \"./types\";\n\nexport type StoreInternals<State> = {\n  initialState: State;\n  equals: EqualsFn<State>;\n  changed: StoreEvent<StoreEventPayload<State>>;\n  reseted: StoreEvent<StoreEventPayload<State>>;\n  listeners: Set<(value: State, prevValue: State) => void>;\n  notifyChanged(value: State, prevValue: State): void;\n};\n\nexport const createStoreInternals = <State>(\n  initialState: State,\n  equalsOption?: EqualsOption<State>,\n): StoreInternals<State> => {\n  const equals = resolveEquals(equalsOption);\n  const changed = createStoreEvent<StoreEventPayload<State>>();\n  const reseted = createStoreEvent<StoreEventPayload<State>>();\n  const listeners = new Set<(value: State, prevValue: State) => void>();\n\n  const notifyChanged = (value: State, prevValue: State) => {\n    changed.emit({ value, prevValue });\n    for (const listener of listeners) {\n      listener(value, prevValue);\n    }\n  };\n\n  return {\n    initialState,\n    equals,\n    changed,\n    reseted,\n    listeners,\n    notifyChanged,\n  };\n};\n","import { signal } from \"@echojs-ecosystem/reactivity\";\n\nimport { applyStoreUpdate } from \"./apply-store-update\";\nimport { attachExtend } from \"./attach-extend\";\nimport { createStoreInternals } from \"./create-store-internals\";\nimport type { Store, StoreOptions } from \"./types\";\n\nexport const createStore = <State>(\n  initialState: State,\n  options?: StoreOptions<State>,\n): Store<State> => {\n  const internals = createStoreInternals(initialState, options?.equals);\n  const $value = signal(initialState);\n\n  const store: Store<State> = {\n    kind: \"store\",\n    name: options?.name,\n    $value,\n    changed: internals.changed,\n    reseted: internals.reseted,\n\n    value() {\n      return $value.value() as State;\n    },\n\n    set(value) {\n      applyStoreUpdate(internals, $value, value);\n    },\n\n    update(updater) {\n      const prev = $value.peek() as State;\n      applyStoreUpdate(internals, $value, updater(prev));\n    },\n\n    reset() {\n      const prev = $value.peek() as State;\n      const next = internals.initialState;\n      internals.reseted.emit({ value: next, prevValue: prev });\n      applyStoreUpdate(internals, $value, next);\n    },\n\n    subscribe(listener) {\n      internals.listeners.add(listener);\n      return () => {\n        internals.listeners.delete(listener);\n      };\n    },\n\n    extend() {\n      throw new Error(\"extend() is not initialized\");\n    },\n  };\n\n  attachExtend(store);\n  return store;\n};\n","import { computed, effect } from \"@echojs-ecosystem/reactivity\";\n\nimport { createStoreEvent } from \"./create-store-event\";\nimport { resolveEquals } from \"./resolve-equals\";\nimport type { EqualsOption, ReadonlyStore, StoreEventPayload } from \"./types\";\n\nexport const createDerivedReadonlyStore = <Selected>(\n  read: () => Selected,\n  options?: {\n    name?: string;\n    equals?: EqualsOption<Selected>;\n  },\n): ReadonlyStore<Selected> => {\n  const equals = resolveEquals(options?.equals);\n  const $value = computed(read);\n  const changed = createStoreEvent<StoreEventPayload<Selected>>();\n  const listeners = new Set<(value: Selected, prevValue: Selected) => void>();\n\n  let prev = read();\n\n  effect(() => {\n    const next = read();\n    if (equals(prev, next)) {\n      return;\n    }\n    const previous = prev;\n    prev = next;\n    changed.emit({ value: next, prevValue: previous });\n    for (const listener of listeners) {\n      listener(next, previous);\n    }\n  });\n\n  return {\n    kind: \"readonly-store\",\n    name: options?.name,\n    $value,\n    changed,\n    value() {\n      return $value.value() as Selected;\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n};\n","import { createDerivedReadonlyStore } from \"./create-derived-readonly-store\";\nimport type { ReadonlyStore, SelectOptions, Store } from \"./types\";\n\nexport const select = <State, Selected>(\n  store: Store<State>,\n  selector: (state: State) => Selected,\n  options?: SelectOptions<Selected>,\n): ReadonlyStore<Selected> => {\n  return createDerivedReadonlyStore(() => selector(store.value()), {\n    name: options?.name,\n    equals: options?.equals,\n  });\n};\n","import { createDerivedReadonlyStore } from \"./create-derived-readonly-store\";\nimport type { CombineOptions, ReadonlyStore, SourceValues, Store } from \"./types\";\n\ntype SourceStore = Store<unknown> | ReadonlyStore<unknown>;\n\nexport const combine = <Sources extends Record<string, SourceStore>, Result>(\n  sources: Sources,\n  combiner: (values: SourceValues<Sources>) => Result,\n  options?: CombineOptions<Result>,\n): ReadonlyStore<Result> => {\n  const entries = Object.entries(sources) as [keyof Sources, SourceStore][];\n\n  const readSources = (): SourceValues<Sources> => {\n    const values = {} as SourceValues<Sources>;\n    for (const [key, source] of entries) {\n      values[key] = source.value() as SourceValues<Sources>[typeof key];\n    }\n    return values;\n  };\n\n  return createDerivedReadonlyStore(() => combiner(readSources()), {\n    name: options?.name,\n    equals: options?.equals,\n  });\n};\n","import type { Store, StoreExtension } from \"./types\";\n\nexport const withActions = <\n  State,\n  const Actions extends Record<string, (store: Store<State>) => unknown>,\n>(\n  actions: Actions,\n): StoreExtension<\n  State,\n  { [K in keyof Actions]: ReturnType<Actions[K]> }\n> => {\n  return (store) => {\n    const result = {} as { [K in keyof Actions]: ReturnType<Actions[K]> };\n    for (const key of Object.keys(actions) as (keyof Actions)[]) {\n      const factory = actions[key];\n      if (!factory) continue;\n      result[key] = factory(store) as ReturnType<Actions[typeof key]>;\n    }\n    return result;\n  };\n};\n","import type { StoreExtension } from \"./types\";\n\nexport type WithDebugResult = {\n  debugName?: string;\n};\n\nexport const withDebug = <State>(): StoreExtension<State, WithDebugResult> => {\n  return (store) => {\n    const debugName = store.name ?? \"anonymous\";\n\n    store.changed.watch(({ value, prevValue }) => {\n      if (typeof console !== \"undefined\" && typeof console.log === \"function\") {\n        console.log(`[store:${debugName}]`, { prevValue, value });\n      }\n    });\n\n    return { debugName };\n  };\n};\n","import type { StoreExtension } from \"./types\";\n\nexport const withReadonly = <State>(): StoreExtension<State, Record<string, never>> => {\n  return (store) => {\n    const mutating = [\"set\", \"update\", \"reset\"] as const;\n    for (const key of mutating) {\n      if (key in store) {\n        (store as Record<string, unknown>)[key] = () => {\n          throw new Error(`Store is readonly: cannot call ${key}()`);\n        };\n      }\n    }\n    (store as { kind: string }).kind = \"readonly-store\";\n    return {};\n  };\n};\n","import type { ReadonlyStore, Store } from \"./types\";\n\nexport const toReadonlyStore = <State>(store: Store<State>): ReadonlyStore<State> => {\n  const readonlyStore: ReadonlyStore<State> = {\n    kind: \"readonly-store\",\n    name: store.name,\n    value: () => store.value(),\n    $value: store.$value,\n    changed: store.changed,\n    subscribe: (listener) => store.subscribe(listener),\n  };\n  return readonlyStore;\n};\n","import { toReadonlyStore } from \"./to-readonly-store\";\nimport type { ReadonlyStore, Store } from \"./types\";\n\nexport const readonly = <State>(store: Store<State>): ReadonlyStore<State> => {\n  return toReadonlyStore(store);\n};\n"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@echojs-ecosystem/store",
+  "version": "0.1.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./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 run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@echojs-ecosystem/reactivity": "workspace:*"
+  },
+  "devDependencies": {
+    "@echojs-ecosystem/oxc-config": "workspace:*",
+    "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/store"
+  }
+}