@tanstack/store 0.0.1-beta.89 → 0.0.1

package/build/cjs/index.js

@@ -1,5 +1,5 @@
 /**
- * store
+ * @tanstack/store/src/index.ts
  *
  * Copyright (c) TanStack
  *
@@ -14,14 +14,12 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 class Store {
   listeners = new Set();
-  #batching = false;
-  #flushing = 0;
+  _batching = false;
+  _flushing = 0;
+  _nextPriority = null;
   constructor(initialState, options) {
     this.state = initialState;
     this.options = options;
-    if (this.options?.onUpdate) {
-      this.subscribe(this.options?.onUpdate);
-    }
   }
   subscribe = listener => {
     this.listeners.add(listener);
@@ -31,25 +29,42 @@ class Store {
       unsub?.();
     };
   };
-  setState = updater => {
+  setState = (updater, opts) => {
     const previous = this.state;
     this.state = this.options?.updateFn ? this.options.updateFn(previous)(updater) : updater(previous);
-    this.#flush();
+    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;
+  _flush = () => {
+    if (this._batching) return;
+    const flushId = ++this._flushing;
     this.listeners.forEach(listener => {
-      if (this.#flushing !== flushId) return;
-      listener();
+      if (this._flushing !== flushId) return;
+      listener({
+        priority: this._nextPriority ?? 'high'
+      });
     });
   };
   batch = cb => {
-    if (this.#batching) return cb();
-    this.#batching = true;
+    if (this._batching) return cb();
+    this._batching = true;
     cb();
-    this.#batching = false;
-    this.#flush();
+    this._batching = false;
+    this._flush();
   };
 }
 

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["export type AnyUpdater = (...args: any[]) => any\n\nexport type Listener = () => void\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?: () => void\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\n  constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {\n    this.state = initialState\n    this.options = options\n    if (this.options?.onUpdate) {\n      this.subscribe(this.options?.onUpdate)\n    }\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 = (updater: TUpdater) => {\n    const previous = this.state\n    this.state = this.options?.updateFn\n      ? this.options.updateFn(previous)(updater)\n      : (updater as any)(previous)\n\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    })\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","constructor","initialState","options","state","onUpdate","subscribe","listener","add","unsub","onSubscribe","delete","setState","updater","previous","updateFn","flushId","forEach","batch","cb"],"mappings":";;;;;;;;;;;;;;AAgBO,MAAMA,KAAK,CAGhB;EACAC,SAAS,GAAG,IAAIC,GAAG,EAAY,CAAA;EAG/B,SAAS,GAAG,KAAK,CAAA;EACjB,SAAS,GAAG,CAAC,CAAA;AAEbC,EAAAA,WAAW,CAACC,YAAoB,EAAEC,OAAwC,EAAE;IAC1E,IAAI,CAACC,KAAK,GAAGF,YAAY,CAAA;IACzB,IAAI,CAACC,OAAO,GAAGA,OAAO,CAAA;AACtB,IAAA,IAAI,IAAI,CAACA,OAAO,EAAEE,QAAQ,EAAE;MAC1B,IAAI,CAACC,SAAS,CAAC,IAAI,CAACH,OAAO,EAAEE,QAAQ,CAAC,CAAA;AACxC,KAAA;AACF,GAAA;EAEAC,SAAS,GAAIC,QAAkB,IAAK;AAClC,IAAA,IAAI,CAACR,SAAS,CAACS,GAAG,CAACD,QAAQ,CAAC,CAAA;IAC5B,MAAME,KAAK,GAAG,IAAI,CAACN,OAAO,EAAEO,WAAW,GAAGH,QAAQ,EAAE,IAAI,CAAC,CAAA;AACzD,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,CAACR,SAAS,CAACY,MAAM,CAACJ,QAAQ,CAAC,CAAA;AAC/BE,MAAAA,KAAK,IAAI,CAAA;KACV,CAAA;GACF,CAAA;EAEDG,QAAQ,GAAIC,OAAiB,IAAK;AAChC,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,CAACD,OAAO,CAAC,GACvCA,OAAO,CAASC,QAAQ,CAAC,CAAA;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAA;GACd,CAAA;EAED,MAAM,GAAG,MAAM;AACb,IAAA,IAAI,IAAI,CAAC,SAAS,EAAE,OAAA;AACpB,IAAA,MAAME,OAAO,GAAG,EAAE,IAAI,CAAC,SAAS,CAAA;AAChC,IAAA,IAAI,CAACjB,SAAS,CAACkB,OAAO,CAAEV,QAAQ,IAAK;AACnC,MAAA,IAAI,IAAI,CAAC,SAAS,KAAKS,OAAO,EAAE,OAAA;AAChCT,MAAAA,QAAQ,EAAE,CAAA;AACZ,KAAC,CAAC,CAAA;GACH,CAAA;EAEDW,KAAK,GAAIC,EAAc,IAAK;AAC1B,IAAA,IAAI,IAAI,CAAC,SAAS,EAAE,OAAOA,EAAE,EAAE,CAAA;AAC/B,IAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;AACrBA,IAAAA,EAAE,EAAE,CAAA;AACJ,IAAA,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACtB,IAAI,CAAC,MAAM,EAAE,CAAA;GACd,CAAA;AACH;;;;"}
+{"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,5 +1,5 @@
 /**
- * store
+ * @tanstack/store/src/index.ts
  *
  * Copyright (c) TanStack
  *
@@ -10,14 +10,12 @@
  */
 class Store {
   listeners = new Set();
-  #batching = false;
-  #flushing = 0;
+  _batching = false;
+  _flushing = 0;
+  _nextPriority = null;
   constructor(initialState, options) {
     this.state = initialState;
     this.options = options;
-    if (this.options?.onUpdate) {
-      this.subscribe(this.options?.onUpdate);
-    }
   }
   subscribe = listener => {
     this.listeners.add(listener);
@@ -27,25 +25,42 @@ class Store {
       unsub?.();
     };
   };
-  setState = updater => {
+  setState = (updater, opts) => {
     const previous = this.state;
     this.state = this.options?.updateFn ? this.options.updateFn(previous)(updater) : updater(previous);
-    this.#flush();
+    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;
+  _flush = () => {
+    if (this._batching) return;
+    const flushId = ++this._flushing;
     this.listeners.forEach(listener => {
-      if (this.#flushing !== flushId) return;
-      listener();
+      if (this._flushing !== flushId) return;
+      listener({
+        priority: this._nextPriority ?? 'high'
+      });
     });
   };
   batch = cb => {
-    if (this.#batching) return cb();
-    this.#batching = true;
+    if (this._batching) return cb();
+    this._batching = true;
     cb();
-    this.#batching = false;
-    this.#flush();
+    this._batching = false;
+    this._flush();
   };
 }
 

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["export type AnyUpdater = (...args: any[]) => any\n\nexport type Listener = () => void\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?: () => void\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\n  constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {\n    this.state = initialState\n    this.options = options\n    if (this.options?.onUpdate) {\n      this.subscribe(this.options?.onUpdate)\n    }\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 = (updater: TUpdater) => {\n    const previous = this.state\n    this.state = this.options?.updateFn\n      ? this.options.updateFn(previous)(updater)\n      : (updater as any)(previous)\n\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    })\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","constructor","initialState","options","state","onUpdate","subscribe","listener","add","unsub","onSubscribe","delete","setState","updater","previous","updateFn","flushId","forEach","batch","cb"],"mappings":";;;;;;;;;;AAgBO,MAAMA,KAAK,CAGhB;EACAC,SAAS,GAAG,IAAIC,GAAG,EAAY,CAAA;EAG/B,SAAS,GAAG,KAAK,CAAA;EACjB,SAAS,GAAG,CAAC,CAAA;AAEbC,EAAAA,WAAW,CAACC,YAAoB,EAAEC,OAAwC,EAAE;IAC1E,IAAI,CAACC,KAAK,GAAGF,YAAY,CAAA;IACzB,IAAI,CAACC,OAAO,GAAGA,OAAO,CAAA;AACtB,IAAA,IAAI,IAAI,CAACA,OAAO,EAAEE,QAAQ,EAAE;MAC1B,IAAI,CAACC,SAAS,CAAC,IAAI,CAACH,OAAO,EAAEE,QAAQ,CAAC,CAAA;AACxC,KAAA;AACF,GAAA;EAEAC,SAAS,GAAIC,QAAkB,IAAK;AAClC,IAAA,IAAI,CAACR,SAAS,CAACS,GAAG,CAACD,QAAQ,CAAC,CAAA;IAC5B,MAAME,KAAK,GAAG,IAAI,CAACN,OAAO,EAAEO,WAAW,GAAGH,QAAQ,EAAE,IAAI,CAAC,CAAA;AACzD,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,CAACR,SAAS,CAACY,MAAM,CAACJ,QAAQ,CAAC,CAAA;AAC/BE,MAAAA,KAAK,IAAI,CAAA;KACV,CAAA;GACF,CAAA;EAEDG,QAAQ,GAAIC,OAAiB,IAAK;AAChC,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,CAACD,OAAO,CAAC,GACvCA,OAAO,CAASC,QAAQ,CAAC,CAAA;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAA;GACd,CAAA;EAED,MAAM,GAAG,MAAM;AACb,IAAA,IAAI,IAAI,CAAC,SAAS,EAAE,OAAA;AACpB,IAAA,MAAME,OAAO,GAAG,EAAE,IAAI,CAAC,SAAS,CAAA;AAChC,IAAA,IAAI,CAACjB,SAAS,CAACkB,OAAO,CAAEV,QAAQ,IAAK;AACnC,MAAA,IAAI,IAAI,CAAC,SAAS,KAAKS,OAAO,EAAE,OAAA;AAChCT,MAAAA,QAAQ,EAAE,CAAA;AACZ,KAAC,CAAC,CAAA;GACH,CAAA;EAEDW,KAAK,GAAIC,EAAc,IAAK;AAC1B,IAAA,IAAI,IAAI,CAAC,SAAS,EAAE,OAAOA,EAAE,EAAE,CAAA;AAC/B,IAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;AACrBA,IAAAA,EAAE,EAAE,CAAA;AACJ,IAAA,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACtB,IAAI,CAAC,MAAM,EAAE,CAAA;GACd,CAAA;AACH;;;;"}
+{"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/stats-html.html

@@ -4024,7 +4024,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.production.js","children":[{"name":"packages/store/src/index.ts","uid":"b161-1"}]}],"isRoot":true},"nodeParts":{"b161-1":{"renderedLength":1096,"gzipLength":376,"brotliLength":0,"mainUid":"b161-0"}},"nodeMetas":{"b161-0":{"id":"/packages/store/src/index.ts","moduleParts":{"index.production.js":"b161-1"},"imported":[],"importedBy":[],"isEntry":true}},"env":{"rollup":"2.79.1"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.production.js","children":[{"name":"packages/store/src/index.ts","uid":"1b85-1"}]}],"isRoot":true},"nodeParts":{"1b85-1":{"renderedLength":1603,"gzipLength":519,"brotliLength":0,"mainUid":"1b85-0"}},"nodeMetas":{"1b85-0":{"id":"/packages/store/src/index.ts","moduleParts":{"index.production.js":"1b85-1"},"imported":[],"importedBy":[],"isEntry":true}},"env":{"rollup":"2.79.1"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/build/stats-react.json

@@ -8,7 +8,7 @@
         "children": [
           {
             "name": "packages/store/src/index.ts",
-            "uid": "b161-3"
+            "uid": "1b85-3"
           }
         ]
       }
@@ -16,18 +16,18 @@
     "isRoot": true
   },
   "nodeParts": {
-    "b161-3": {
-      "renderedLength": 1096,
-      "gzipLength": 376,
+    "1b85-3": {
+      "renderedLength": 1603,
+      "gzipLength": 519,
       "brotliLength": 0,
-      "mainUid": "b161-2"
+      "mainUid": "1b85-2"
     }
   },
   "nodeMetas": {
-    "b161-2": {
+    "1b85-2": {
       "id": "/packages/store/src/index.ts",
       "moduleParts": {
-        "index.production.js": "b161-3"
+        "index.production.js": "1b85-3"
       },
       "imported": [],
       "importedBy": [],

package/build/types/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * store
+ * @tanstack/store/src/index.ts
  *
  * Copyright (c) TanStack
  *
@@ -9,21 +9,32 @@
  * @license MIT
  */
 type AnyUpdater = (...args: any[]) => any;
-type Listener = () => void;
+type Listener = (opts: {
+    priority: Priority;
+}) => void;
+type Priority = 'high' | 'low';
 interface StoreOptions<TState, TUpdater extends AnyUpdater = (cb: TState) => TState> {
     updateFn?: (previous: TState) => (updater: TUpdater) => TState;
     onSubscribe?: (listener: Listener, store: Store<TState, TUpdater>) => () => void;
-    onUpdate?: () => void;
+    onUpdate?: (opts: {
+        priority: Priority;
+    }) => void;
+    defaultPriority?: Priority;
 }
 declare class Store<TState, TUpdater extends AnyUpdater = (cb: TState) => TState> {
-    #private;
     listeners: Set<Listener>;
     state: TState;
     options?: StoreOptions<TState, TUpdater>;
+    _batching: boolean;
+    _flushing: number;
+    _nextPriority: null | Priority;
     constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>);
     subscribe: (listener: Listener) => () => void;
-    setState: (updater: TUpdater) => void;
+    setState: (updater: TUpdater, opts?: {
+        priority: Priority;
+    }) => void;
+    _flush: () => void;
     batch: (cb: () => void) => void;
 }
 
-export { AnyUpdater, Listener, Store };
+export { AnyUpdater, Listener, Priority, Store };

package/build/umd/index.development.js

@@ -1,5 +1,5 @@
 /**
- * store
+ * @tanstack/store/src/index.ts
  *
  * Copyright (c) TanStack
  *
@@ -16,14 +16,12 @@
 
   class Store {
     listeners = new Set();
-    #batching = false;
-    #flushing = 0;
+    _batching = false;
+    _flushing = 0;
+    _nextPriority = null;
     constructor(initialState, options) {
       this.state = initialState;
       this.options = options;
-      if (this.options?.onUpdate) {
-        this.subscribe(this.options?.onUpdate);
-      }
     }
     subscribe = listener => {
       this.listeners.add(listener);
@@ -33,25 +31,42 @@
         unsub?.();
       };
     };
-    setState = updater => {
+    setState = (updater, opts) => {
       const previous = this.state;
       this.state = this.options?.updateFn ? this.options.updateFn(previous)(updater) : updater(previous);
-      this.#flush();
+      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;
+    _flush = () => {
+      if (this._batching) return;
+      const flushId = ++this._flushing;
       this.listeners.forEach(listener => {
-        if (this.#flushing !== flushId) return;
-        listener();
+        if (this._flushing !== flushId) return;
+        listener({
+          priority: this._nextPriority ?? 'high'
+        });
       });
     };
     batch = cb => {
-      if (this.#batching) return cb();
-      this.#batching = true;
+      if (this._batching) return cb();
+      this._batching = true;
       cb();
-      this.#batching = false;
-      this.#flush();
+      this._batching = false;
+      this._flush();
     };
   }
 

package/build/umd/index.development.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.development.js","sources":["../../src/index.ts"],"sourcesContent":["export type AnyUpdater = (...args: any[]) => any\n\nexport type Listener = () => void\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?: () => void\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\n  constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {\n    this.state = initialState\n    this.options = options\n    if (this.options?.onUpdate) {\n      this.subscribe(this.options?.onUpdate)\n    }\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 = (updater: TUpdater) => {\n    const previous = this.state\n    this.state = this.options?.updateFn\n      ? this.options.updateFn(previous)(updater)\n      : (updater as any)(previous)\n\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    })\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","constructor","initialState","options","state","onUpdate","subscribe","listener","add","unsub","onSubscribe","delete","setState","updater","previous","updateFn","flushId","forEach","batch","cb"],"mappings":";;;;;;;;;;;;;;;;EAgBO,MAAMA,KAAK,CAGhB;IACAC,SAAS,GAAG,IAAIC,GAAG,EAAY,CAAA;IAG/B,SAAS,GAAG,KAAK,CAAA;IACjB,SAAS,GAAG,CAAC,CAAA;EAEbC,EAAAA,WAAW,CAACC,YAAoB,EAAEC,OAAwC,EAAE;MAC1E,IAAI,CAACC,KAAK,GAAGF,YAAY,CAAA;MACzB,IAAI,CAACC,OAAO,GAAGA,OAAO,CAAA;EACtB,IAAA,IAAI,IAAI,CAACA,OAAO,EAAEE,QAAQ,EAAE;QAC1B,IAAI,CAACC,SAAS,CAAC,IAAI,CAACH,OAAO,EAAEE,QAAQ,CAAC,CAAA;EACxC,KAAA;EACF,GAAA;IAEAC,SAAS,GAAIC,QAAkB,IAAK;EAClC,IAAA,IAAI,CAACR,SAAS,CAACS,GAAG,CAACD,QAAQ,CAAC,CAAA;MAC5B,MAAME,KAAK,GAAG,IAAI,CAACN,OAAO,EAAEO,WAAW,GAAGH,QAAQ,EAAE,IAAI,CAAC,CAAA;EACzD,IAAA,OAAO,MAAM;EACX,MAAA,IAAI,CAACR,SAAS,CAACY,MAAM,CAACJ,QAAQ,CAAC,CAAA;EAC/BE,MAAAA,KAAK,IAAI,CAAA;OACV,CAAA;KACF,CAAA;IAEDG,QAAQ,GAAIC,OAAiB,IAAK;EAChC,IAAA,MAAMC,QAAQ,GAAG,IAAI,CAACV,KAAK,CAAA;MAC3B,IAAI,CAACA,KAAK,GAAG,IAAI,CAACD,OAAO,EAAEY,QAAQ,GAC/B,IAAI,CAACZ,OAAO,CAACY,QAAQ,CAACD,QAAQ,CAAC,CAACD,OAAO,CAAC,GACvCA,OAAO,CAASC,QAAQ,CAAC,CAAA;MAE9B,IAAI,CAAC,MAAM,EAAE,CAAA;KACd,CAAA;IAED,MAAM,GAAG,MAAM;EACb,IAAA,IAAI,IAAI,CAAC,SAAS,EAAE,OAAA;EACpB,IAAA,MAAME,OAAO,GAAG,EAAE,IAAI,CAAC,SAAS,CAAA;EAChC,IAAA,IAAI,CAACjB,SAAS,CAACkB,OAAO,CAAEV,QAAQ,IAAK;EACnC,MAAA,IAAI,IAAI,CAAC,SAAS,KAAKS,OAAO,EAAE,OAAA;EAChCT,MAAAA,QAAQ,EAAE,CAAA;EACZ,KAAC,CAAC,CAAA;KACH,CAAA;IAEDW,KAAK,GAAIC,EAAc,IAAK;EAC1B,IAAA,IAAI,IAAI,CAAC,SAAS,EAAE,OAAOA,EAAE,EAAE,CAAA;EAC/B,IAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;EACrBA,IAAAA,EAAE,EAAE,CAAA;EACJ,IAAA,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;MACtB,IAAI,CAAC,MAAM,EAAE,CAAA;KACd,CAAA;EACH;;;;;;;;;;"}
+{"version":3,"file":"index.development.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":";;;;;;;;;;;;;;;;EAmBO,MAAMA,KAAK,CAGhB;EACAC,EAAAA,SAAS,GAAG,IAAIC,GAAG,EAAY,CAAA;EAG/BC,EAAAA,SAAS,GAAG,KAAK,CAAA;EACjBC,EAAAA,SAAS,GAAG,CAAC,CAAA;EACbC,EAAAA,aAAa,GAAoB,IAAI,CAAA;EAErCC,EAAAA,WAAWA,CAACC,YAAoB,EAAEC,OAAwC,EAAE;MAC1E,IAAI,CAACC,KAAK,GAAGF,YAAY,CAAA;MACzB,IAAI,CAACC,OAAO,GAAGA,OAAO,CAAA;EACxB,GAAA;IAEAE,SAAS,GAAIC,QAAkB,IAAK;EAClC,IAAA,IAAI,CAACV,SAAS,CAACW,GAAG,CAACD,QAAQ,CAAC,CAAA;MAC5B,MAAME,KAAK,GAAG,IAAI,CAACL,OAAO,EAAEM,WAAW,GAAGH,QAAQ,EAAE,IAAI,CAAC,CAAA;EACzD,IAAA,OAAO,MAAM;EACX,MAAA,IAAI,CAACV,SAAS,CAACc,MAAM,CAACJ,QAAQ,CAAC,CAAA;EAC/BE,MAAAA,KAAK,IAAI,CAAA;OACV,CAAA;KACF,CAAA;EAEDG,EAAAA,QAAQ,GAAGA,CACTC,OAAiB,EACjBC,IAEC,KACE;EACH,IAAA,MAAMC,QAAQ,GAAG,IAAI,CAACV,KAAK,CAAA;MAC3B,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;EAE9B,IAAA,MAAME,QAAQ,GAAGH,IAAI,EAAEG,QAAQ,IAAI,IAAI,CAACb,OAAO,EAAEc,eAAe,IAAI,MAAM,CAAA;EAC1E,IAAA,IAAI,IAAI,CAACjB,aAAa,KAAK,IAAI,EAAE;QAC/B,IAAI,CAACA,aAAa,GAAGgB,QAAQ,CAAA;EAC/B,KAAC,MAAM,IAAI,IAAI,CAAChB,aAAa,KAAK,MAAM,EAAE;QACxC,IAAI,CAACA,aAAa,GAAGgB,QAAQ,CAAA;EAC/B,KAAC,MAAM;QACL,IAAI,CAAChB,aAAa,GAAG,IAAI,CAACG,OAAO,EAAEc,eAAe,IAAI,MAAM,CAAA;EAC9D,KAAA;;EAEA;EACA,IAAA,IAAI,CAACd,OAAO,EAAEe,QAAQ,GAAG;QACvBF,QAAQ,EAAE,IAAI,CAAChB,aAAAA;EACjB,KAAC,CAAC,CAAA;;EAEF;MACA,IAAI,CAACmB,MAAM,EAAE,CAAA;KACd,CAAA;IAEDA,MAAM,GAAGA,MAAM;MACb,IAAI,IAAI,CAACrB,SAAS,EAAE,OAAA;EACpB,IAAA,MAAMsB,OAAO,GAAG,EAAE,IAAI,CAACrB,SAAS,CAAA;EAChC,IAAA,IAAI,CAACH,SAAS,CAACyB,OAAO,CAAEf,QAAQ,IAAK;EACnC,MAAA,IAAI,IAAI,CAACP,SAAS,KAAKqB,OAAO,EAAE,OAAA;EAChCd,MAAAA,QAAQ,CAAC;EACPU,QAAAA,QAAQ,EAAE,IAAI,CAAChB,aAAa,IAAI,MAAA;EAClC,OAAC,CAAC,CAAA;EACJ,KAAC,CAAC,CAAA;KACH,CAAA;IAEDsB,KAAK,GAAIC,EAAc,IAAK;EAC1B,IAAA,IAAI,IAAI,CAACzB,SAAS,EAAE,OAAOyB,EAAE,EAAE,CAAA;MAC/B,IAAI,CAACzB,SAAS,GAAG,IAAI,CAAA;EACrByB,IAAAA,EAAE,EAAE,CAAA;MACJ,IAAI,CAACzB,SAAS,GAAG,KAAK,CAAA;MACtB,IAAI,CAACqB,MAAM,EAAE,CAAA;KACd,CAAA;EACH;;;;;;;;;;"}

package/build/umd/index.production.js

@@ -1,5 +1,5 @@
 /**
- * store
+ * @tanstack/store/src/index.ts
  *
  * Copyright (c) TanStack
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-!function(t,s){"object"==typeof exports&&"undefined"!=typeof module?s(exports):"function"==typeof define&&define.amd?define(["exports"],s):s((t="undefined"!=typeof globalThis?globalThis:t||self).Store={})}(this,(function(t){"use strict";t.Store=class{listeners=new Set;#t=!1;#s=0;constructor(t,s){this.state=t,this.options=s,this.options?.onUpdate&&this.subscribe(this.options?.onUpdate)}subscribe=t=>{this.listeners.add(t);const s=this.options?.onSubscribe?.(t,this);return()=>{this.listeners.delete(t),s?.()}};setState=t=>{const s=this.state;this.state=this.options?.updateFn?this.options.updateFn(s)(t):t(s),this.#e()};#e=()=>{if(this.#t)return;const t=++this.#s;this.listeners.forEach((s=>{this.#s===t&&s()}))};batch=t=>{if(this.#t)return t();this.#t=!0,t(),this.#t=!1,this.#e()}},Object.defineProperty(t,"__esModule",{value:!0})}));
+!function(t,i){"object"==typeof exports&&"undefined"!=typeof module?i(exports):"function"==typeof define&&define.amd?define(["exports"],i):i((t="undefined"!=typeof globalThis?globalThis:t||self).Store={})}(this,(function(t){"use strict";t.Store=class{listeners=new Set;_batching=!1;_flushing=0;_nextPriority=null;constructor(t,i){this.state=t,this.options=i}subscribe=t=>{this.listeners.add(t);const i=this.options?.onSubscribe?.(t,this);return()=>{this.listeners.delete(t),i?.()}};setState=(t,i)=>{const s=this.state;this.state=this.options?.updateFn?this.options.updateFn(s)(t):t(s);const e=i?.priority??this.options?.defaultPriority??"high";null===this._nextPriority||"high"===this._nextPriority?this._nextPriority=e:this._nextPriority=this.options?.defaultPriority??"high",this.options?.onUpdate?.({priority:this._nextPriority}),this._flush()};_flush=()=>{if(this._batching)return;const t=++this._flushing;this.listeners.forEach((i=>{this._flushing===t&&i({priority:this._nextPriority??"high"})}))};batch=t=>{if(this._batching)return t();this._batching=!0,t(),this._batching=!1,this._flush()}},Object.defineProperty(t,"__esModule",{value:!0})}));
 //# sourceMappingURL=index.production.js.map

package/build/umd/index.production.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.production.js","sources":["../../src/index.ts"],"sourcesContent":["export type AnyUpdater = (...args: any[]) => any\n\nexport type Listener = () => void\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?: () => void\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\n  constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {\n    this.state = initialState\n    this.options = options\n    if (this.options?.onUpdate) {\n      this.subscribe(this.options?.onUpdate)\n    }\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 = (updater: TUpdater) => {\n    const previous = this.state\n    this.state = this.options?.updateFn\n      ? this.options.updateFn(previous)(updater)\n      : (updater as any)(previous)\n\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    })\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":["listeners","Set","batching","flushing","constructor","initialState","options","this","state","onUpdate","subscribe","listener","add","unsub","onSubscribe","delete","setState","updater","previous","updateFn","flush","flushId","forEach","batch","cb"],"mappings":";;;;;;;;;;qPAgBO,MAILA,UAAY,IAAIC,IAGhBC,IAAY,EACZC,GAAY,EAEZC,YAAYC,EAAsBC,GAChCC,KAAKC,MAAQH,EACbE,KAAKD,QAAUA,EACXC,KAAKD,SAASG,UAChBF,KAAKG,UAAUH,KAAKD,SAASG,SAEjC,CAEAC,UAAaC,IACXJ,KAAKP,UAAUY,IAAID,GACnB,MAAME,EAAQN,KAAKD,SAASQ,cAAcH,EAAUJ,MACpD,MAAO,KACLA,KAAKP,UAAUe,OAAOJ,GACtBE,KAAS,CACV,EAGHG,SAAYC,IACV,MAAMC,EAAWX,KAAKC,MACtBD,KAAKC,MAAQD,KAAKD,SAASa,SACvBZ,KAAKD,QAAQa,SAASD,EAAtBX,CAAgCU,GAC/BA,EAAgBC,GAErBX,MAAKa,GAAQ,EAGfA,GAAS,KACP,GAAIb,MAAKL,EAAW,OACpB,MAAMmB,IAAYd,MAAKJ,EACvBI,KAAKP,UAAUsB,SAASX,IAClBJ,MAAKJ,IAAckB,GACvBV,GAAU,GACV,EAGJY,MAASC,IACP,GAAIjB,MAAKL,EAAW,OAAOsB,IAC3BjB,MAAKL,GAAY,EACjBsB,IACAjB,MAAKL,GAAY,EACjBK,MAAKa,GAAQ"}
+{"version":3,"file":"index.production.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":["listeners","Set","_batching","_flushing","_nextPriority","constructor","initialState","options","this","state","subscribe","listener","add","unsub","onSubscribe","delete","setState","updater","opts","previous","updateFn","priority","defaultPriority","onUpdate","_flush","flushId","forEach","batch","cb"],"mappings":";;;;;;;;;;qPAmBO,MAILA,UAAY,IAAIC,IAGhBC,WAAY,EACZC,UAAY,EACZC,cAAiC,KAEjCC,YAAYC,EAAsBC,GAChCC,KAAKC,MAAQH,EACbE,KAAKD,QAAUA,CACjB,CAEAG,UAAaC,IACXH,KAAKR,UAAUY,IAAID,GACnB,MAAME,EAAQL,KAAKD,SAASO,cAAcH,EAAUH,MACpD,MAAO,KACLA,KAAKR,UAAUe,OAAOJ,GACtBE,KAAS,CACV,EAGHG,SAAWA,CACTC,EACAC,KAIA,MAAMC,EAAWX,KAAKC,MACtBD,KAAKC,MAAQD,KAAKD,SAASa,SACvBZ,KAAKD,QAAQa,SAASD,EAAtBX,CAAgCS,GAC/BA,EAAgBE,GAErB,MAAME,EAAWH,GAAMG,UAAYb,KAAKD,SAASe,iBAAmB,OACzC,OAAvBd,KAAKJ,eAEyB,SAAvBI,KAAKJ,cADdI,KAAKJ,cAAgBiB,EAIrBb,KAAKJ,cAAgBI,KAAKD,SAASe,iBAAmB,OAIxDd,KAAKD,SAASgB,WAAW,CACvBF,SAAUb,KAAKJ,gBAIjBI,KAAKgB,QAAQ,EAGfA,OAASA,KACP,GAAIhB,KAAKN,UAAW,OACpB,MAAMuB,IAAYjB,KAAKL,UACvBK,KAAKR,UAAU0B,SAASf,IAClBH,KAAKL,YAAcsB,GACvBd,EAAS,CACPU,SAAUb,KAAKJ,eAAiB,QAChC,GACF,EAGJuB,MAASC,IACP,GAAIpB,KAAKN,UAAW,OAAO0B,IAC3BpB,KAAKN,WAAY,EACjB0B,IACApB,KAAKN,WAAY,EACjBM,KAAKgB,QAAQ"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/store",
   "author": "Tanner Linsley",
-  "version": "0.0.1-beta.89",
+  "version": "0.0.1",
   "license": "MIT",
   "repository": "tanstack/store",
   "homepage": "https://tanstack.com/store",
@@ -30,6 +30,8 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "build": "rollup --config rollup.config.js"
+    "build": "rollup --config rollup.config.js",
+    "test": "vitest",
+    "test:dev": "vitest --watch"
   }
 }

package/src/index.ts

@@ -1,6 +1,8 @@
 export type AnyUpdater = (...args: any[]) => any
 
-export type Listener = () => void
+export type Listener = (opts: { priority: Priority }) => void
+
+export type Priority = 'high' | 'low'
 
 interface StoreOptions<
   TState,
@@ -11,7 +13,8 @@ interface StoreOptions<
     listener: Listener,
     store: Store<TState, TUpdater>,
   ) => () => void
-  onUpdate?: () => void
+  onUpdate?: (opts: { priority: Priority }) => void
+  defaultPriority?: Priority
 }
 
 export class Store<
@@ -21,15 +24,13 @@ export class Store<
   listeners = new Set<Listener>()
   state: TState
   options?: StoreOptions<TState, TUpdater>
-  #batching = false
-  #flushing = 0
+  _batching = false
+  _flushing = 0
+  _nextPriority: null | Priority = null
 
   constructor(initialState: TState, options?: StoreOptions<TState, TUpdater>) {
     this.state = initialState
     this.options = options
-    if (this.options?.onUpdate) {
-      this.subscribe(this.options?.onUpdate)
-    }
   }
 
   subscribe = (listener: Listener) => {
@@ -41,29 +42,51 @@ export class Store<
     }
   }
 
-  setState = (updater: TUpdater) => {
+  setState = (
+    updater: TUpdater,
+    opts?: {
+      priority: Priority
+    },
+  ) => {
     const previous = this.state
     this.state = this.options?.updateFn
       ? this.options.updateFn(previous)(updater)
       : (updater as any)(previous)
 
-    this.#flush()
+    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
+  _flush = () => {
+    if (this._batching) return
+    const flushId = ++this._flushing
     this.listeners.forEach((listener) => {
-      if (this.#flushing !== flushId) return
-      listener()
+      if (this._flushing !== flushId) return
+      listener({
+        priority: this._nextPriority ?? 'high',
+      })
     })
   }
 
   batch = (cb: () => void) => {
-    if (this.#batching) return cb()
-    this.#batching = true
+    if (this._batching) return cb()
+    this._batching = true
     cb()
-    this.#batching = false
-    this.#flush()
+    this._batching = false
+    this._flush()
   }
 }