@tanstack/store 0.0.1 → 0.1.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/store",
   "author": "Tanner Linsley",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "license": "MIT",
   "repository": "tanstack/store",
   "homepage": "https://tanstack.com/store",
@@ -17,21 +17,35 @@
     "type": "github",
     "url": "https://github.com/sponsors/tannerlinsley"
   },
-  "module": "build/esm/index.js",
-  "main": "build/cjs/index.js",
-  "browser": "build/umd/index.production.js",
-  "types": "build/types/index.d.ts",
-  "engines": {
-    "node": ">=12"
+  "type": "module",
+  "types": "build/legacy/index.d.ts",
+  "main": "build/legacy/index.cjs",
+  "module": "build/legacy/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./build/modern/index.d.ts",
+        "default": "./build/modern/index.js"
+      },
+      "require": {
+        "types": "./build/modern/index.d.cts",
+        "default": "./build/modern/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
   },
+  "sideEffects": false,
   "files": [
-    "build/**",
+    "build",
     "src"
   ],
-  "sideEffects": false,
   "scripts": {
-    "build": "rollup --config rollup.config.js",
-    "test": "vitest",
-    "test:dev": "vitest --watch"
+    "clean": "rimraf ./build && rimraf ./coverage",
+    "test:eslint": "eslint --ext .ts,.tsx ./src",
+    "test:types": "tsc",
+    "test:lib": "vitest run --coverage",
+    "test:lib:dev": "pnpm run test:lib --watch",
+    "test:build": "publint --strict",
+    "build": "tsup"
   }
 }

package/src/__tests__/index.test.tsx

@@ -0,0 +1,83 @@
+import { describe, test, expect, vi } from 'vitest'
+import { Store } from '../index'
+
+describe('store', () => {
+  test(`should set the initial value`, () => {
+    const store = new Store(0)
+
+    expect(store.state).toEqual(0)
+  })
+
+  test(`basic subscriptions should work`, () => {
+    const store = new Store(0)
+
+    const subscription = vi.fn()
+
+    const unsub = store.subscribe(subscription)
+
+    store.setState(() => 1)
+
+    expect(store.state).toEqual(1)
+    expect(subscription).toHaveBeenCalled()
+
+    unsub()
+
+    store.setState(() => 2)
+
+    expect(store.state).toEqual(2)
+
+    expect(subscription).toHaveBeenCalledTimes(1)
+  })
+
+  test(`setState passes previous state`, () => {
+    const store = new Store(3)
+
+    store.setState((v) => v + 1)
+
+    expect(store.state).toEqual(4)
+  })
+
+  test(`updateFn acts as state transformer`, () => {
+    const store = new Store(1, {
+      updateFn: (v) => (updater) => Number(updater(v)),
+    })
+
+    store.setState((v) => `${v + 1}` as never)
+
+    expect(store.state).toEqual(2)
+
+    store.setState((v) => `${v + 2}` as never)
+
+    expect(store.state).toEqual(4)
+
+    expect(typeof store.state).toEqual('number')
+  })
+
+  test('Batch prevents listeners from being called during repeated setStates', () => {
+    const store = new Store(0)
+
+    const listener = vi.fn()
+
+    store.subscribe(listener)
+
+    store.batch(() => {
+      store.setState(() => 1)
+      store.setState(() => 2)
+      store.setState(() => 3)
+      store.setState(() => 4)
+    })
+
+    expect(store.state).toEqual(4)
+    // Listener is only called once because of batching
+    expect(listener).toHaveBeenCalledTimes(1)
+
+    store.setState(() => 1)
+    store.setState(() => 2)
+    store.setState(() => 3)
+    store.setState(() => 4)
+
+    expect(store.state).toEqual(4)
+    // Listener is called 4 times because of a lack of batching
+    expect(listener).toHaveBeenCalledTimes(5)
+  })
+})

package/build/cjs/index.js

@@ -1,72 +0,0 @@
-/**
- * @tanstack/store/src/index.ts
- *
- * Copyright (c) TanStack
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE.md file in the root directory of this source tree.
- *
- * @license MIT
- */
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-class Store {
-  listeners = new Set();
-  _batching = false;
-  _flushing = 0;
-  _nextPriority = null;
-  constructor(initialState, options) {
-    this.state = initialState;
-    this.options = options;
-  }
-  subscribe = listener => {
-    this.listeners.add(listener);
-    const unsub = this.options?.onSubscribe?.(listener, this);
-    return () => {
-      this.listeners.delete(listener);
-      unsub?.();
-    };
-  };
-  setState = (updater, opts) => {
-    const previous = this.state;
-    this.state = this.options?.updateFn ? this.options.updateFn(previous)(updater) : updater(previous);
-    const priority = opts?.priority ?? this.options?.defaultPriority ?? 'high';
-    if (this._nextPriority === null) {
-      this._nextPriority = priority;
-    } else if (this._nextPriority === 'high') {
-      this._nextPriority = priority;
-    } else {
-      this._nextPriority = this.options?.defaultPriority ?? 'high';
-    }
-
-    // Always run onUpdate, regardless of batching
-    this.options?.onUpdate?.({
-      priority: this._nextPriority
-    });
-
-    // Attempt to flush
-    this._flush();
-  };
-  _flush = () => {
-    if (this._batching) return;
-    const flushId = ++this._flushing;
-    this.listeners.forEach(listener => {
-      if (this._flushing !== flushId) return;
-      listener({
-        priority: this._nextPriority ?? 'high'
-      });
-    });
-  };
-  batch = cb => {
-    if (this._batching) return cb();
-    this._batching = true;
-    cb();
-    this._batching = false;
-    this._flush();
-  };
-}
-
-exports.Store = Store;
-//# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["export type AnyUpdater = (...args: any[]) => any\n\nexport type Listener = (opts: { priority: Priority }) => void\n\nexport type Priority = 'high' | 'low'\n\ninterface StoreOptions<\n  TState,\n  TUpdater extends AnyUpdater = (cb: TState) => TState,\n> {\n  updateFn?: (previous: TState) => (updater: TUpdater) => TState\n  onSubscribe?: (\n    listener: Listener,\n    store: Store<TState, TUpdater>,\n  ) => () => void\n  onUpdate?: (opts: { priority: Priority }) => void\n  defaultPriority?: Priority\n}\n\nexport class Store<\n  TState,\n  TUpdater extends AnyUpdater = (cb: TState) => TState,\n> {\n  listeners = new Set<Listener>()\n  state: TState\n  options?: StoreOptions<TState, TUpdater>\n  _batching = false\n  _flushing = 0\n  _nextPriority: null | Priority = null\n\n  constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {\n    this.state = initialState\n    this.options = options\n  }\n\n  subscribe = (listener: Listener) => {\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  setState = (\n    updater: TUpdater,\n    opts?: {\n      priority: Priority\n    },\n  ) => {\n    const previous = this.state\n    this.state = this.options?.updateFn\n      ? this.options.updateFn(previous)(updater)\n      : (updater as any)(previous)\n\n    const priority = opts?.priority ?? this.options?.defaultPriority ?? 'high'\n    if (this._nextPriority === null) {\n      this._nextPriority = priority\n    } else if (this._nextPriority === 'high') {\n      this._nextPriority = priority\n    } else {\n      this._nextPriority = this.options?.defaultPriority ?? 'high'\n    }\n\n    // Always run onUpdate, regardless of batching\n    this.options?.onUpdate?.({\n      priority: this._nextPriority,\n    })\n\n    // Attempt to flush\n    this._flush()\n  }\n\n  _flush = () => {\n    if (this._batching) return\n    const flushId = ++this._flushing\n    this.listeners.forEach((listener) => {\n      if (this._flushing !== flushId) return\n      listener({\n        priority: this._nextPriority ?? 'high',\n      })\n    })\n  }\n\n  batch = (cb: () => void) => {\n    if (this._batching) return cb()\n    this._batching = true\n    cb()\n    this._batching = false\n    this._flush()\n  }\n}\n"],"names":["Store","listeners","Set","_batching","_flushing","_nextPriority","constructor","initialState","options","state","subscribe","listener","add","unsub","onSubscribe","delete","setState","updater","opts","previous","updateFn","priority","defaultPriority","onUpdate","_flush","flushId","forEach","batch","cb"],"mappings":";;;;;;;;;;;;;;AAmBO,MAAMA,KAAK,CAGhB;AACAC,EAAAA,SAAS,GAAG,IAAIC,GAAG,EAAY,CAAA;AAG/BC,EAAAA,SAAS,GAAG,KAAK,CAAA;AACjBC,EAAAA,SAAS,GAAG,CAAC,CAAA;AACbC,EAAAA,aAAa,GAAoB,IAAI,CAAA;AAErCC,EAAAA,WAAWA,CAACC,YAAoB,EAAEC,OAAwC,EAAE;IAC1E,IAAI,CAACC,KAAK,GAAGF,YAAY,CAAA;IACzB,IAAI,CAACC,OAAO,GAAGA,OAAO,CAAA;AACxB,GAAA;EAEAE,SAAS,GAAIC,QAAkB,IAAK;AAClC,IAAA,IAAI,CAACV,SAAS,CAACW,GAAG,CAACD,QAAQ,CAAC,CAAA;IAC5B,MAAME,KAAK,GAAG,IAAI,CAACL,OAAO,EAAEM,WAAW,GAAGH,QAAQ,EAAE,IAAI,CAAC,CAAA;AACzD,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,CAACV,SAAS,CAACc,MAAM,CAACJ,QAAQ,CAAC,CAAA;AAC/BE,MAAAA,KAAK,IAAI,CAAA;KACV,CAAA;GACF,CAAA;AAEDG,EAAAA,QAAQ,GAAGA,CACTC,OAAiB,EACjBC,IAEC,KACE;AACH,IAAA,MAAMC,QAAQ,GAAG,IAAI,CAACV,KAAK,CAAA;IAC3B,IAAI,CAACA,KAAK,GAAG,IAAI,CAACD,OAAO,EAAEY,QAAQ,GAC/B,IAAI,CAACZ,OAAO,CAACY,QAAQ,CAACD,QAAQ,CAAC,CAACF,OAAO,CAAC,GACvCA,OAAO,CAASE,QAAQ,CAAC,CAAA;AAE9B,IAAA,MAAME,QAAQ,GAAGH,IAAI,EAAEG,QAAQ,IAAI,IAAI,CAACb,OAAO,EAAEc,eAAe,IAAI,MAAM,CAAA;AAC1E,IAAA,IAAI,IAAI,CAACjB,aAAa,KAAK,IAAI,EAAE;MAC/B,IAAI,CAACA,aAAa,GAAGgB,QAAQ,CAAA;AAC/B,KAAC,MAAM,IAAI,IAAI,CAAChB,aAAa,KAAK,MAAM,EAAE;MACxC,IAAI,CAACA,aAAa,GAAGgB,QAAQ,CAAA;AAC/B,KAAC,MAAM;MACL,IAAI,CAAChB,aAAa,GAAG,IAAI,CAACG,OAAO,EAAEc,eAAe,IAAI,MAAM,CAAA;AAC9D,KAAA;;AAEA;AACA,IAAA,IAAI,CAACd,OAAO,EAAEe,QAAQ,GAAG;MACvBF,QAAQ,EAAE,IAAI,CAAChB,aAAAA;AACjB,KAAC,CAAC,CAAA;;AAEF;IACA,IAAI,CAACmB,MAAM,EAAE,CAAA;GACd,CAAA;EAEDA,MAAM,GAAGA,MAAM;IACb,IAAI,IAAI,CAACrB,SAAS,EAAE,OAAA;AACpB,IAAA,MAAMsB,OAAO,GAAG,EAAE,IAAI,CAACrB,SAAS,CAAA;AAChC,IAAA,IAAI,CAACH,SAAS,CAACyB,OAAO,CAAEf,QAAQ,IAAK;AACnC,MAAA,IAAI,IAAI,CAACP,SAAS,KAAKqB,OAAO,EAAE,OAAA;AAChCd,MAAAA,QAAQ,CAAC;AACPU,QAAAA,QAAQ,EAAE,IAAI,CAAChB,aAAa,IAAI,MAAA;AAClC,OAAC,CAAC,CAAA;AACJ,KAAC,CAAC,CAAA;GACH,CAAA;EAEDsB,KAAK,GAAIC,EAAc,IAAK;AAC1B,IAAA,IAAI,IAAI,CAACzB,SAAS,EAAE,OAAOyB,EAAE,EAAE,CAAA;IAC/B,IAAI,CAACzB,SAAS,GAAG,IAAI,CAAA;AACrByB,IAAAA,EAAE,EAAE,CAAA;IACJ,IAAI,CAACzB,SAAS,GAAG,KAAK,CAAA;IACtB,IAAI,CAACqB,MAAM,EAAE,CAAA;GACd,CAAA;AACH;;;;"}

package/build/esm/index.js

@@ -1,68 +0,0 @@
-/**
- * @tanstack/store/src/index.ts
- *
- * Copyright (c) TanStack
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE.md file in the root directory of this source tree.
- *
- * @license MIT
- */
-class Store {
-  listeners = new Set();
-  _batching = false;
-  _flushing = 0;
-  _nextPriority = null;
-  constructor(initialState, options) {
-    this.state = initialState;
-    this.options = options;
-  }
-  subscribe = listener => {
-    this.listeners.add(listener);
-    const unsub = this.options?.onSubscribe?.(listener, this);
-    return () => {
-      this.listeners.delete(listener);
-      unsub?.();
-    };
-  };
-  setState = (updater, opts) => {
-    const previous = this.state;
-    this.state = this.options?.updateFn ? this.options.updateFn(previous)(updater) : updater(previous);
-    const priority = opts?.priority ?? this.options?.defaultPriority ?? 'high';
-    if (this._nextPriority === null) {
-      this._nextPriority = priority;
-    } else if (this._nextPriority === 'high') {
-      this._nextPriority = priority;
-    } else {
-      this._nextPriority = this.options?.defaultPriority ?? 'high';
-    }
-
-    // Always run onUpdate, regardless of batching
-    this.options?.onUpdate?.({
-      priority: this._nextPriority
-    });
-
-    // Attempt to flush
-    this._flush();
-  };
-  _flush = () => {
-    if (this._batching) return;
-    const flushId = ++this._flushing;
-    this.listeners.forEach(listener => {
-      if (this._flushing !== flushId) return;
-      listener({
-        priority: this._nextPriority ?? 'high'
-      });
-    });
-  };
-  batch = cb => {
-    if (this._batching) return cb();
-    this._batching = true;
-    cb();
-    this._batching = false;
-    this._flush();
-  };
-}
-
-export { Store };
-//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["export type AnyUpdater = (...args: any[]) => any\n\nexport type Listener = (opts: { priority: Priority }) => void\n\nexport type Priority = 'high' | 'low'\n\ninterface StoreOptions<\n  TState,\n  TUpdater extends AnyUpdater = (cb: TState) => TState,\n> {\n  updateFn?: (previous: TState) => (updater: TUpdater) => TState\n  onSubscribe?: (\n    listener: Listener,\n    store: Store<TState, TUpdater>,\n  ) => () => void\n  onUpdate?: (opts: { priority: Priority }) => void\n  defaultPriority?: Priority\n}\n\nexport class Store<\n  TState,\n  TUpdater extends AnyUpdater = (cb: TState) => TState,\n> {\n  listeners = new Set<Listener>()\n  state: TState\n  options?: StoreOptions<TState, TUpdater>\n  _batching = false\n  _flushing = 0\n  _nextPriority: null | Priority = null\n\n  constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {\n    this.state = initialState\n    this.options = options\n  }\n\n  subscribe = (listener: Listener) => {\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  setState = (\n    updater: TUpdater,\n    opts?: {\n      priority: Priority\n    },\n  ) => {\n    const previous = this.state\n    this.state = this.options?.updateFn\n      ? this.options.updateFn(previous)(updater)\n      : (updater as any)(previous)\n\n    const priority = opts?.priority ?? this.options?.defaultPriority ?? 'high'\n    if (this._nextPriority === null) {\n      this._nextPriority = priority\n    } else if (this._nextPriority === 'high') {\n      this._nextPriority = priority\n    } else {\n      this._nextPriority = this.options?.defaultPriority ?? 'high'\n    }\n\n    // Always run onUpdate, regardless of batching\n    this.options?.onUpdate?.({\n      priority: this._nextPriority,\n    })\n\n    // Attempt to flush\n    this._flush()\n  }\n\n  _flush = () => {\n    if (this._batching) return\n    const flushId = ++this._flushing\n    this.listeners.forEach((listener) => {\n      if (this._flushing !== flushId) return\n      listener({\n        priority: this._nextPriority ?? 'high',\n      })\n    })\n  }\n\n  batch = (cb: () => void) => {\n    if (this._batching) return cb()\n    this._batching = true\n    cb()\n    this._batching = false\n    this._flush()\n  }\n}\n"],"names":["Store","listeners","Set","_batching","_flushing","_nextPriority","constructor","initialState","options","state","subscribe","listener","add","unsub","onSubscribe","delete","setState","updater","opts","previous","updateFn","priority","defaultPriority","onUpdate","_flush","flushId","forEach","batch","cb"],"mappings":";;;;;;;;;;AAmBO,MAAMA,KAAK,CAGhB;AACAC,EAAAA,SAAS,GAAG,IAAIC,GAAG,EAAY,CAAA;AAG/BC,EAAAA,SAAS,GAAG,KAAK,CAAA;AACjBC,EAAAA,SAAS,GAAG,CAAC,CAAA;AACbC,EAAAA,aAAa,GAAoB,IAAI,CAAA;AAErCC,EAAAA,WAAWA,CAACC,YAAoB,EAAEC,OAAwC,EAAE;IAC1E,IAAI,CAACC,KAAK,GAAGF,YAAY,CAAA;IACzB,IAAI,CAACC,OAAO,GAAGA,OAAO,CAAA;AACxB,GAAA;EAEAE,SAAS,GAAIC,QAAkB,IAAK;AAClC,IAAA,IAAI,CAACV,SAAS,CAACW,GAAG,CAACD,QAAQ,CAAC,CAAA;IAC5B,MAAME,KAAK,GAAG,IAAI,CAACL,OAAO,EAAEM,WAAW,GAAGH,QAAQ,EAAE,IAAI,CAAC,CAAA;AACzD,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,CAACV,SAAS,CAACc,MAAM,CAACJ,QAAQ,CAAC,CAAA;AAC/BE,MAAAA,KAAK,IAAI,CAAA;KACV,CAAA;GACF,CAAA;AAEDG,EAAAA,QAAQ,GAAGA,CACTC,OAAiB,EACjBC,IAEC,KACE;AACH,IAAA,MAAMC,QAAQ,GAAG,IAAI,CAACV,KAAK,CAAA;IAC3B,IAAI,CAACA,KAAK,GAAG,IAAI,CAACD,OAAO,EAAEY,QAAQ,GAC/B,IAAI,CAACZ,OAAO,CAACY,QAAQ,CAACD,QAAQ,CAAC,CAACF,OAAO,CAAC,GACvCA,OAAO,CAASE,QAAQ,CAAC,CAAA;AAE9B,IAAA,MAAME,QAAQ,GAAGH,IAAI,EAAEG,QAAQ,IAAI,IAAI,CAACb,OAAO,EAAEc,eAAe,IAAI,MAAM,CAAA;AAC1E,IAAA,IAAI,IAAI,CAACjB,aAAa,KAAK,IAAI,EAAE;MAC/B,IAAI,CAACA,aAAa,GAAGgB,QAAQ,CAAA;AAC/B,KAAC,MAAM,IAAI,IAAI,CAAChB,aAAa,KAAK,MAAM,EAAE;MACxC,IAAI,CAACA,aAAa,GAAGgB,QAAQ,CAAA;AAC/B,KAAC,MAAM;MACL,IAAI,CAAChB,aAAa,GAAG,IAAI,CAACG,OAAO,EAAEc,eAAe,IAAI,MAAM,CAAA;AAC9D,KAAA;;AAEA;AACA,IAAA,IAAI,CAACd,OAAO,EAAEe,QAAQ,GAAG;MACvBF,QAAQ,EAAE,IAAI,CAAChB,aAAAA;AACjB,KAAC,CAAC,CAAA;;AAEF;IACA,IAAI,CAACmB,MAAM,EAAE,CAAA;GACd,CAAA;EAEDA,MAAM,GAAGA,MAAM;IACb,IAAI,IAAI,CAACrB,SAAS,EAAE,OAAA;AACpB,IAAA,MAAMsB,OAAO,GAAG,EAAE,IAAI,CAACrB,SAAS,CAAA;AAChC,IAAA,IAAI,CAACH,SAAS,CAACyB,OAAO,CAAEf,QAAQ,IAAK;AACnC,MAAA,IAAI,IAAI,CAACP,SAAS,KAAKqB,OAAO,EAAE,OAAA;AAChCd,MAAAA,QAAQ,CAAC;AACPU,QAAAA,QAAQ,EAAE,IAAI,CAAChB,aAAa,IAAI,MAAA;AAClC,OAAC,CAAC,CAAA;AACJ,KAAC,CAAC,CAAA;GACH,CAAA;EAEDsB,KAAK,GAAIC,EAAc,IAAK;AAC1B,IAAA,IAAI,IAAI,CAACzB,SAAS,EAAE,OAAOyB,EAAE,EAAE,CAAA;IAC/B,IAAI,CAACzB,SAAS,GAAG,IAAI,CAAA;AACrByB,IAAAA,EAAE,EAAE,CAAA;IACJ,IAAI,CAACzB,SAAS,GAAG,KAAK,CAAA;IACtB,IAAI,CAACqB,MAAM,EAAE,CAAA;GACd,CAAA;AACH;;;;"}