@tanstack/store 0.8.1 → 0.9.1

package/dist/esm/index.d.ts

@@ -1,5 +1,4 @@
-export * from './derived.js';
-export * from './effect.js';
-export * from './store.js';
 export * from './types.js';
-export * from './scheduler.js';
+export * from './atom.js';
+export * from './store.js';
+export * from './batch.js';

package/dist/esm/index.js

@@ -1,17 +1,14 @@
-import { Derived } from "./derived.js";
-import { Effect } from "./effect.js";
-import { Store } from "./store.js";
-import { isUpdaterFunction } from "./types.js";
-import { __depsThatHaveWrittenThisTick, __derivedToStore, __flush, __storeToDerived, batch } from "./scheduler.js";
+import { createAsyncAtom, createAtom, flush, toObserver } from "./atom.js";
+import { ReadonlyStore, Store, createStore } from "./store.js";
+import { batch } from "./batch.js";
 export {
-  Derived,
-  Effect,
+  ReadonlyStore,
   Store,
-  __depsThatHaveWrittenThisTick,
-  __derivedToStore,
-  __flush,
-  __storeToDerived,
   batch,
-  isUpdaterFunction
+  createAsyncAtom,
+  createAtom,
+  createStore,
+  flush,
+  toObserver
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/esm/store.d.ts

@@ -1,31 +1,20 @@
-import { AnyUpdater, Listener } from './types.js';
-export interface StoreOptions<TState, TUpdater extends AnyUpdater = (cb: TState) => TState> {
-    /**
-     * Replace the default update function with a custom one.
-     */
-    updateFn?: (previous: TState) => (updater: TUpdater) => TState;
-    /**
-     * Called when a listener subscribes to the store.
-     *
-     * @return a function to unsubscribe the listener
-     */
-    onSubscribe?: (listener: Listener<TState>, store: Store<TState, TUpdater>) => () => void;
-    /**
-     * Called after the state has been updated, used to derive other state.
-     */
-    onUpdate?: () => void;
+import { Observer, Subscription } from './types.js';
+export declare class Store<T> {
+    private atom;
+    constructor(getValue: (prev?: NoInfer<T>) => T);
+    constructor(initialValue: T);
+    setState(updater: (prev: T) => T): void;
+    get state(): T;
+    get(): T;
+    subscribe(observerOrFn: Observer<T> | ((value: T) => void)): Subscription;
 }
-export declare class Store<TState, TUpdater extends AnyUpdater = (cb: TState) => TState> {
-    listeners: Set<Listener<TState>>;
-    state: TState;
-    prevState: TState;
-    options?: StoreOptions<TState, TUpdater>;
-    constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>);
-    subscribe: (listener: Listener<TState>) => () => void;
-    /**
-     * Update the store state safely with improved type checking
-     */
-    setState(updater: (prevState: TState) => TState): void;
-    setState(updater: TState): void;
-    setState(updater: TUpdater): void;
+export declare class ReadonlyStore<T> implements Omit<Store<T>, 'setState'> {
+    private atom;
+    constructor(getValue: (prev?: NoInfer<T>) => T);
+    constructor(initialValue: T);
+    get state(): T;
+    get(): T;
+    subscribe(observerOrFn: Observer<T> | ((value: T) => void)): Subscription;
 }
+export declare function createStore<T>(getValue: (prev?: NoInfer<T>) => T): ReadonlyStore<T>;
+export declare function createStore<T>(initialValue: T): Store<T>;

package/dist/esm/store.js

@@ -1,38 +1,48 @@
-import { __flush } from "./scheduler.js";
-import { isUpdaterFunction } from "./types.js";
+import { createAtom, toObserver } from "./atom.js";
 class Store {
-  constructor(initialState, options) {
-    this.listeners = /* @__PURE__ */ new Set();
-    this.subscribe = (listener) => {
-      var _a, _b;
-      this.listeners.add(listener);
-      const unsub = (_b = (_a = this.options) == null ? void 0 : _a.onSubscribe) == null ? void 0 : _b.call(_a, listener, this);
-      return () => {
-        this.listeners.delete(listener);
-        unsub == null ? void 0 : unsub();
-      };
-    };
-    this.prevState = initialState;
-    this.state = initialState;
-    this.options = options;
+  constructor(valueOrFn) {
+    this.atom = createAtom(
+      valueOrFn
+    );
   }
   setState(updater) {
-    var _a, _b, _c;
-    this.prevState = this.state;
-    if ((_a = this.options) == null ? void 0 : _a.updateFn) {
-      this.state = this.options.updateFn(this.prevState)(updater);
-    } else {
-      if (isUpdaterFunction(updater)) {
-        this.state = updater(this.prevState);
-      } else {
-        this.state = updater;
-      }
-    }
-    (_c = (_b = this.options) == null ? void 0 : _b.onUpdate) == null ? void 0 : _c.call(_b);
-    __flush(this);
+    this.atom.set(updater);
   }
+  get state() {
+    return this.atom.get();
+  }
+  get() {
+    return this.state;
+  }
+  subscribe(observerOrFn) {
+    return this.atom.subscribe(toObserver(observerOrFn));
+  }
+}
+class ReadonlyStore {
+  constructor(valueOrFn) {
+    this.atom = createAtom(
+      valueOrFn
+    );
+  }
+  get state() {
+    return this.atom.get();
+  }
+  get() {
+    return this.state;
+  }
+  subscribe(observerOrFn) {
+    return this.atom.subscribe(toObserver(observerOrFn));
+  }
+}
+function createStore(valueOrFn) {
+  if (typeof valueOrFn === "function") {
+    return new ReadonlyStore(valueOrFn);
+  }
+  return new Store(valueOrFn);
 }
 export {
-  Store
+  ReadonlyStore,
+  Store,
+  createStore
 };
 //# sourceMappingURL=store.js.map

package/dist/esm/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sources":["../../src/store.ts"],"sourcesContent":["import { __flush } from './scheduler'\nimport { isUpdaterFunction } from './types'\nimport type { AnyUpdater, Listener, Updater } from './types'\n\nexport interface StoreOptions<\n  TState,\n  TUpdater extends AnyUpdater = (cb: TState) => TState,\n> {\n  /**\n   * Replace the default update function with a custom one.\n   */\n  updateFn?: (previous: TState) => (updater: TUpdater) => TState\n  /**\n   * Called when a listener subscribes to the store.\n   *\n   * @return a function to unsubscribe the listener\n   */\n  onSubscribe?: (\n    listener: Listener<TState>,\n    store: Store<TState, TUpdater>,\n  ) => () => void\n  /**\n   * Called after the state has been updated, used to derive other state.\n   */\n  onUpdate?: () => void\n}\n\nexport class Store<\n  TState,\n  TUpdater extends AnyUpdater = (cb: TState) => TState,\n> {\n  listeners = new Set<Listener<TState>>()\n  state: TState\n  prevState: TState\n  options?: StoreOptions<TState, TUpdater>\n\n  constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {\n    this.prevState = initialState\n    this.state = initialState\n    this.options = options\n  }\n\n  subscribe = (listener: Listener<TState>) => {\n    this.listeners.add(listener)\n    const unsub = this.options?.onSubscribe?.(listener, this)\n    return () => {\n      this.listeners.delete(listener)\n      unsub?.()\n    }\n  }\n\n  /**\n   * Update the store state safely with improved type checking\n   */\n  setState(updater: (prevState: TState) => TState): void\n  setState(updater: TState): void\n  setState(updater: TUpdater): void\n  setState(updater: Updater<TState> | TUpdater): void {\n    this.prevState = this.state\n\n    if (this.options?.updateFn) {\n      this.state = this.options.updateFn(this.prevState)(updater as TUpdater)\n    } else {\n      if (isUpdaterFunction(updater)) {\n        this.state = updater(this.prevState)\n      } else {\n        this.state = updater as TState\n      }\n    }\n\n    // Always run onUpdate, regardless of batching\n    this.options?.onUpdate?.()\n\n    // Attempt to flush\n    __flush(this as never)\n  }\n}\n"],"names":[],"mappings":";;AA2BO,MAAM,MAGX;AAAA,EAMA,YAAY,cAAsB,SAA0C;AAL5E,SAAA,gCAAgB,IAAA;AAWhB,SAAA,YAAY,CAAC,aAA+B;;AAC1C,WAAK,UAAU,IAAI,QAAQ;AAC3B,YAAM,SAAQ,gBAAK,YAAL,mBAAc,gBAAd,4BAA4B,UAAU;AACpD,aAAO,MAAM;AACX,aAAK,UAAU,OAAO,QAAQ;AAC9B;AAAA,MACF;AAAA,IACF;AAZE,SAAK,YAAY;AACjB,SAAK,QAAQ;AACb,SAAK,UAAU;AAAA,EACjB;AAAA,EAiBA,SAAS,SAA2C;;AAClD,SAAK,YAAY,KAAK;AAEtB,SAAI,UAAK,YAAL,mBAAc,UAAU;AAC1B,WAAK,QAAQ,KAAK,QAAQ,SAAS,KAAK,SAAS,EAAE,OAAmB;AAAA,IACxE,OAAO;AACL,UAAI,kBAAkB,OAAO,GAAG;AAC9B,aAAK,QAAQ,QAAQ,KAAK,SAAS;AAAA,MACrC,OAAO;AACL,aAAK,QAAQ;AAAA,MACf;AAAA,IACF;AAGA,qBAAK,YAAL,mBAAc,aAAd;AAGA,YAAQ,IAAa;AAAA,EACvB;AACF;"}
+{"version":3,"file":"store.js","sources":["../../src/store.ts"],"sourcesContent":["import { createAtom, toObserver } from './atom'\nimport type { Atom, Observer, Subscription } from './types'\n\nexport class Store<T> {\n  private atom: Atom<T>\n  constructor(getValue: (prev?: NoInfer<T>) => T)\n  constructor(initialValue: T)\n  constructor(valueOrFn: T | ((prev?: T) => T)) {\n    // createAtom has overloads that return ReadonlyAtom<T> for functions and Atom<T> for values\n    // Store always needs Atom<T> for setState, so we assert the return type\n    this.atom = createAtom(\n      valueOrFn as T | ((prev?: NoInfer<T>) => T),\n    ) as Atom<T>\n  }\n  public setState(updater: (prev: T) => T) {\n    this.atom.set(updater)\n  }\n  public get state() {\n    return this.atom.get()\n  }\n  public get() {\n    return this.state\n  }\n  public subscribe(\n    observerOrFn: Observer<T> | ((value: T) => void),\n  ): Subscription {\n    return this.atom.subscribe(toObserver(observerOrFn))\n  }\n}\n\nexport class ReadonlyStore<T> implements Omit<Store<T>, 'setState'> {\n  private atom: Atom<T>\n  constructor(getValue: (prev?: NoInfer<T>) => T)\n  constructor(initialValue: T)\n  constructor(valueOrFn: T | ((prev?: T) => T)) {\n    // createAtom has overloads that return ReadonlyAtom<T> for functions and Atom<T> for values\n    // Store always needs Atom<T> for setState, so we assert the return type\n    this.atom = createAtom(\n      valueOrFn as T | ((prev?: NoInfer<T>) => T),\n    ) as Atom<T>\n  }\n  public get state() {\n    return this.atom.get()\n  }\n  public get() {\n    return this.state\n  }\n  public subscribe(\n    observerOrFn: Observer<T> | ((value: T) => void),\n  ): Subscription {\n    return this.atom.subscribe(toObserver(observerOrFn))\n  }\n}\n\nexport function createStore<T>(\n  getValue: (prev?: NoInfer<T>) => T,\n): ReadonlyStore<T>\nexport function createStore<T>(initialValue: T): Store<T>\nexport function createStore<T>(\n  valueOrFn: T | ((prev?: T) => T),\n): Store<T> | ReadonlyStore<T> {\n  if (typeof valueOrFn === 'function') {\n    return new ReadonlyStore(valueOrFn as (prev?: NoInfer<T>) => T)\n  }\n  return new Store(valueOrFn)\n}\n"],"names":[],"mappings":";AAGO,MAAM,MAAS;AAAA,EAIpB,YAAY,WAAkC;AAG5C,SAAK,OAAO;AAAA,MACV;AAAA,IAAA;AAAA,EAEJ;AAAA,EACO,SAAS,SAAyB;AACvC,SAAK,KAAK,IAAI,OAAO;AAAA,EACvB;AAAA,EACA,IAAW,QAAQ;AACjB,WAAO,KAAK,KAAK,IAAA;AAAA,EACnB;AAAA,EACO,MAAM;AACX,WAAO,KAAK;AAAA,EACd;AAAA,EACO,UACL,cACc;AACd,WAAO,KAAK,KAAK,UAAU,WAAW,YAAY,CAAC;AAAA,EACrD;AACF;AAEO,MAAM,cAAuD;AAAA,EAIlE,YAAY,WAAkC;AAG5C,SAAK,OAAO;AAAA,MACV;AAAA,IAAA;AAAA,EAEJ;AAAA,EACA,IAAW,QAAQ;AACjB,WAAO,KAAK,KAAK,IAAA;AAAA,EACnB;AAAA,EACO,MAAM;AACX,WAAO,KAAK;AAAA,EACd;AAAA,EACO,UACL,cACc;AACd,WAAO,KAAK,KAAK,UAAU,WAAW,YAAY,CAAC;AAAA,EACrD;AACF;AAMO,SAAS,YACd,WAC6B;AAC7B,MAAI,OAAO,cAAc,YAAY;AACnC,WAAO,IAAI,cAAc,SAAqC;AAAA,EAChE;AACA,SAAO,IAAI,MAAM,SAAS;AAC5B;"}

package/dist/esm/types.d.ts

@@ -1,23 +1,50 @@
-/**
- * @private
- */
-export type AnyUpdater = (prev: any) => any;
-/**
- * Type-safe updater that can be either a function or direct value
- */
-export type Updater<T> = ((prev: T) => T) | T;
-/**
- * @private
- */
-export interface ListenerValue<T> {
-    readonly prevVal: T;
-    readonly currentVal: T;
+import { ReactiveNode } from './alien.js';
+export type Selection<TSelected> = Readable<TSelected>;
+export interface InteropSubscribable<T> {
+    subscribe: (observer: Observer<T>) => Subscription;
+}
+export type Observer<T> = {
+    next?: (value: T) => void;
+    error?: (err: unknown) => void;
+    complete?: () => void;
+};
+export interface Subscription {
+    unsubscribe: () => void;
+}
+export interface Subscribable<T> extends InteropSubscribable<T> {
+    subscribe: ((observer: Observer<T>) => Subscription) & ((next: (value: T) => void, error?: (error: any) => void, complete?: () => void) => Subscription);
+}
+export interface Readable<T> extends Subscribable<T> {
+    get: () => T;
+}
+export interface BaseAtom<T> extends Subscribable<T>, Readable<T> {
+}
+export interface InternalBaseAtom<T> extends Subscribable<T>, Readable<T> {
+    /** @internal */
+    _snapshot: T;
+    /** @internal */
+    _update: (getValue?: T | ((snapshot: T) => T)) => boolean;
+}
+export interface Atom<T> extends BaseAtom<T> {
+    /** Sets the value of the atom using a function. */
+    set: ((fn: (prevVal: T) => T) => void) & ((value: T) => void);
+}
+export interface AtomOptions<T> {
+    compare?: (prev: T, next: T) => boolean;
+}
+export type AnyAtom = BaseAtom<any>;
+export interface InternalReadonlyAtom<T> extends InternalBaseAtom<T>, ReactiveNode {
 }
 /**
- * @private
- */
-export type Listener<T> = (value: ListenerValue<T>) => void;
-/**
- * Type guard to check if updater is a function
+ * An atom that is read-only and cannot be set.
+ *
+ * @example
+ *
+ * ```ts
+ * const atom = createAtom(() => 42);
+ * // @ts-expect-error - Cannot set a readonly atom
+ * atom.set(43);
+ * ```
  */
-export declare function isUpdaterFunction<T>(updater: Updater<T>): updater is (prev: T) => T;
+export interface ReadonlyAtom<T> extends BaseAtom<T> {
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/store",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "Framework agnostic type-safe store w/ reactive framework adapters",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "src"
   ],
   "devDependencies": {
-    "@angular/core": "^19.2.15",
+    "@angular/core": "^21.1.2",
     "@preact/signals": "^1.3.2",
     "solid-js": "^1.9.9",
     "vue": "^3.5.22"
@@ -50,11 +50,10 @@
     "clean": "premove ./dist ./coverage",
     "test:eslint": "eslint ./src ./tests",
     "test:types": "pnpm run \"/^test:types:ts[0-9]{2}$/\"",
-    "test:types:ts50": "node ../../node_modules/typescript50/lib/tsc.js",
-    "test:types:ts51": "node ../../node_modules/typescript51/lib/tsc.js",
-    "test:types:ts52": "node ../../node_modules/typescript52/lib/tsc.js",
-    "test:types:ts53": "node ../../node_modules/typescript53/lib/tsc.js",
-    "test:types:ts54": "tsc",
+    "test:types:ts56": "node ../../node_modules/typescript56/lib/tsc.js",
+    "test:types:ts57": "node ../../node_modules/typescript57/lib/tsc.js",
+    "test:types:ts58": "node ../../node_modules/typescript58/lib/tsc.js",
+    "test:types:ts59": "tsc",
     "test:lib": "vitest",
     "test:bench": "vitest bench",
     "test:lib:dev": "pnpm run test:lib --watch",