@take-out/helpers 0.0.35 → 0.0.37

package/dist/esm/storage/storage.test.js

@@ -0,0 +1,73 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { createStorage } from "./createStorage";
+import { getStorageDriver, setStorageDriver } from "./driver";
+describe("storage driver system", () => {
+  describe("driver initialization", () => {
+    it("getStorageDriver should return localStorage fallback on web", () => {
+      const driver = getStorageDriver();
+      typeof localStorage < "u" && expect(driver).toBeTruthy();
+    }), it("should use custom driver when set", () => {
+      const mockStorage = /* @__PURE__ */ new Map(), mockDriver = {
+        getItem: (key) => mockStorage.get(key) ?? null,
+        setItem: (key, value) => mockStorage.set(key, value),
+        removeItem: (key) => mockStorage.delete(key),
+        getAllKeys: () => Array.from(mockStorage.keys())
+      };
+      setStorageDriver(mockDriver);
+      const driver = getStorageDriver();
+      expect(driver).toBe(mockDriver);
+    });
+  }), describe("createStorage with driver", () => {
+    let mockStorage;
+    beforeEach(() => {
+      mockStorage = /* @__PURE__ */ new Map(), setStorageDriver({
+        getItem: (key) => mockStorage.get(key) ?? null,
+        setItem: (key, value) => mockStorage.set(key, value),
+        removeItem: (key) => mockStorage.delete(key),
+        getAllKeys: () => Array.from(mockStorage.keys())
+      });
+    }), it("should store and retrieve values", () => {
+      const storage = createStorage(`test-${Date.now()}-1`);
+      storage.set("token", "test-value"), expect(storage.get("token")).toBe("test-value");
+    }), it("should use namespace prefix", () => {
+      const namespace = `test-${Date.now()}-2`;
+      createStorage(namespace).set("key", "value"), expect(mockStorage.has(`${namespace}:key`)).toBe(!0);
+    }), it("should handle JSON serialization", () => {
+      const storage = createStorage(
+        `test-${Date.now()}-3`
+      ), obj = { name: "test", count: 42 };
+      storage.set("obj", obj), expect(storage.get("obj")).toEqual(obj);
+    }), it("should support raw string operations", () => {
+      const storage = createStorage(`test-${Date.now()}-4`);
+      storage.setItem("raw", "raw-value"), expect(storage.getItem("raw")).toBe("raw-value");
+    }), it("should return undefined for missing keys", () => {
+      const storage = createStorage(`test-${Date.now()}-5`);
+      expect(storage.get("missing")).toBeUndefined();
+    }), it("should support has() check", () => {
+      const storage = createStorage(`test-${Date.now()}-6`);
+      expect(storage.has("exists")).toBe(!1), storage.set("exists", "value"), expect(storage.has("exists")).toBe(!0);
+    }), it("should support remove()", () => {
+      const storage = createStorage(`test-${Date.now()}-7`);
+      storage.set("removable", "value"), expect(storage.has("removable")).toBe(!0), storage.remove("removable"), expect(storage.has("removable")).toBe(!1);
+    }), it("should list keys in namespace", () => {
+      const storage = createStorage(`test-${Date.now()}-8`);
+      storage.set("a", "1"), storage.set("b", "2"), storage.set("c", "3"), expect(storage.keys().sort()).toEqual(["a", "b", "c"]);
+    }), it("should clear only namespace keys", () => {
+      const ns1 = `test-${Date.now()}-9a`, ns2 = `test-${Date.now()}-9b`, storage1 = createStorage(ns1), storage2 = createStorage(ns2);
+      storage1.set("key", "value1"), storage2.set("key", "value2"), storage1.clear(), expect(storage1.has("key")).toBe(!1), expect(storage2.has("key")).toBe(!0);
+    });
+  }), describe("createStorage without driver (simulates native without setup)", () => {
+    it("should handle gracefully when operations fail", () => {
+      const storage = createStorage(`test-no-driver-${Date.now()}`);
+      expect(() => storage.get("key")).not.toThrow(), expect(() => storage.set("key", "value")).not.toThrow(), expect(() => storage.remove("key")).not.toThrow(), expect(() => storage.has("key")).not.toThrow(), expect(() => storage.keys()).not.toThrow(), expect(() => storage.clear()).not.toThrow(), expect(() => storage.getItem("key")).not.toThrow(), expect(() => storage.setItem("key", "value")).not.toThrow();
+    });
+  });
+});
+describe("auth storage requirements", () => {
+  it("storage must be initialized before auth client creates storage instances", () => {
+    expect(!0).toBe(!0);
+  }), it("native platforms require explicit storage driver setup", () => {
+    expect(!0).toBe(!0);
+  });
+});
+//# sourceMappingURL=storage.test.js.map

package/dist/esm/storage/storage.test.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/storage.test.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/storage/storage.test.mjs

@@ -0,0 +1,79 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { createStorage } from "./createStorage.mjs";
+import { getStorageDriver, setStorageDriver } from "./driver.mjs";
+describe("storage driver system", () => {
+  describe("driver initialization", () => {
+    it("getStorageDriver should return localStorage fallback on web", () => {
+      const driver = getStorageDriver();
+      typeof localStorage < "u" && expect(driver).toBeTruthy();
+    }), it("should use custom driver when set", () => {
+      const mockStorage = /* @__PURE__ */new Map(),
+        mockDriver = {
+          getItem: key => mockStorage.get(key) ?? null,
+          setItem: (key, value) => mockStorage.set(key, value),
+          removeItem: key => mockStorage.delete(key),
+          getAllKeys: () => Array.from(mockStorage.keys())
+        };
+      setStorageDriver(mockDriver);
+      const driver = getStorageDriver();
+      expect(driver).toBe(mockDriver);
+    });
+  }), describe("createStorage with driver", () => {
+    let mockStorage;
+    beforeEach(() => {
+      mockStorage = /* @__PURE__ */new Map(), setStorageDriver({
+        getItem: key => mockStorage.get(key) ?? null,
+        setItem: (key, value) => mockStorage.set(key, value),
+        removeItem: key => mockStorage.delete(key),
+        getAllKeys: () => Array.from(mockStorage.keys())
+      });
+    }), it("should store and retrieve values", () => {
+      const storage = createStorage(`test-${Date.now()}-1`);
+      storage.set("token", "test-value"), expect(storage.get("token")).toBe("test-value");
+    }), it("should use namespace prefix", () => {
+      const namespace = `test-${Date.now()}-2`;
+      createStorage(namespace).set("key", "value"), expect(mockStorage.has(`${namespace}:key`)).toBe(!0);
+    }), it("should handle JSON serialization", () => {
+      const storage = createStorage(`test-${Date.now()}-3`),
+        obj = {
+          name: "test",
+          count: 42
+        };
+      storage.set("obj", obj), expect(storage.get("obj")).toEqual(obj);
+    }), it("should support raw string operations", () => {
+      const storage = createStorage(`test-${Date.now()}-4`);
+      storage.setItem("raw", "raw-value"), expect(storage.getItem("raw")).toBe("raw-value");
+    }), it("should return undefined for missing keys", () => {
+      const storage = createStorage(`test-${Date.now()}-5`);
+      expect(storage.get("missing")).toBeUndefined();
+    }), it("should support has() check", () => {
+      const storage = createStorage(`test-${Date.now()}-6`);
+      expect(storage.has("exists")).toBe(!1), storage.set("exists", "value"), expect(storage.has("exists")).toBe(!0);
+    }), it("should support remove()", () => {
+      const storage = createStorage(`test-${Date.now()}-7`);
+      storage.set("removable", "value"), expect(storage.has("removable")).toBe(!0), storage.remove("removable"), expect(storage.has("removable")).toBe(!1);
+    }), it("should list keys in namespace", () => {
+      const storage = createStorage(`test-${Date.now()}-8`);
+      storage.set("a", "1"), storage.set("b", "2"), storage.set("c", "3"), expect(storage.keys().sort()).toEqual(["a", "b", "c"]);
+    }), it("should clear only namespace keys", () => {
+      const ns1 = `test-${Date.now()}-9a`,
+        ns2 = `test-${Date.now()}-9b`,
+        storage1 = createStorage(ns1),
+        storage2 = createStorage(ns2);
+      storage1.set("key", "value1"), storage2.set("key", "value2"), storage1.clear(), expect(storage1.has("key")).toBe(!1), expect(storage2.has("key")).toBe(!0);
+    });
+  }), describe("createStorage without driver (simulates native without setup)", () => {
+    it("should handle gracefully when operations fail", () => {
+      const storage = createStorage(`test-no-driver-${Date.now()}`);
+      expect(() => storage.get("key")).not.toThrow(), expect(() => storage.set("key", "value")).not.toThrow(), expect(() => storage.remove("key")).not.toThrow(), expect(() => storage.has("key")).not.toThrow(), expect(() => storage.keys()).not.toThrow(), expect(() => storage.clear()).not.toThrow(), expect(() => storage.getItem("key")).not.toThrow(), expect(() => storage.setItem("key", "value")).not.toThrow();
+    });
+  });
+});
+describe("auth storage requirements", () => {
+  it("storage must be initialized before auth client creates storage instances", () => {
+    expect(!0).toBe(!0);
+  }), it("native platforms require explicit storage driver setup", () => {
+    expect(!0).toBe(!0);
+  });
+});
+//# sourceMappingURL=storage.test.mjs.map

package/dist/esm/storage/storage.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["beforeEach","describe","expect","it","createStorage","getStorageDriver","setStorageDriver","driver","localStorage","toBeTruthy","mockStorage","Map","mockDriver","getItem","key","get","setItem","value","set","removeItem","delete","getAllKeys","Array","from","keys","toBe","storage","Date","now","namespace","has","obj","name","count","toEqual","toBeUndefined","remove","sort","ns1","ns2","storage1","storage2","clear","not","toThrow"],"sources":["../../../src/storage/storage.test.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/storage/storage.test.native.js

@@ -0,0 +1,116 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { createStorage } from "./createStorage.native.js";
+import { getStorageDriver, setStorageDriver } from "./driver.native.js";
+describe("storage driver system", function () {
+  describe("driver initialization", function () {
+    it("getStorageDriver should return localStorage fallback on web", function () {
+      var driver = getStorageDriver();
+      typeof localStorage < "u" && expect(driver).toBeTruthy();
+    }), it("should use custom driver when set", function () {
+      var mockStorage = /* @__PURE__ */new Map(),
+        mockDriver = {
+          getItem: function (key) {
+            var _mockStorage_get;
+            return (_mockStorage_get = mockStorage.get(key)) !== null && _mockStorage_get !== void 0 ? _mockStorage_get : null;
+          },
+          setItem: function (key, value) {
+            return mockStorage.set(key, value);
+          },
+          removeItem: function (key) {
+            return mockStorage.delete(key);
+          },
+          getAllKeys: function () {
+            return Array.from(mockStorage.keys());
+          }
+        };
+      setStorageDriver(mockDriver);
+      var driver = getStorageDriver();
+      expect(driver).toBe(mockDriver);
+    });
+  }), describe("createStorage with driver", function () {
+    var mockStorage;
+    beforeEach(function () {
+      mockStorage = /* @__PURE__ */new Map();
+      var mockDriver = {
+        getItem: function (key) {
+          var _mockStorage_get;
+          return (_mockStorage_get = mockStorage.get(key)) !== null && _mockStorage_get !== void 0 ? _mockStorage_get : null;
+        },
+        setItem: function (key, value) {
+          return mockStorage.set(key, value);
+        },
+        removeItem: function (key) {
+          return mockStorage.delete(key);
+        },
+        getAllKeys: function () {
+          return Array.from(mockStorage.keys());
+        }
+      };
+      setStorageDriver(mockDriver);
+    }), it("should store and retrieve values", function () {
+      var storage = createStorage(`test-${Date.now()}-1`);
+      storage.set("token", "test-value"), expect(storage.get("token")).toBe("test-value");
+    }), it("should use namespace prefix", function () {
+      var namespace = `test-${Date.now()}-2`,
+        storage = createStorage(namespace);
+      storage.set("key", "value"), expect(mockStorage.has(`${namespace}:key`)).toBe(!0);
+    }), it("should handle JSON serialization", function () {
+      var storage = createStorage(`test-${Date.now()}-3`),
+        obj = {
+          name: "test",
+          count: 42
+        };
+      storage.set("obj", obj), expect(storage.get("obj")).toEqual(obj);
+    }), it("should support raw string operations", function () {
+      var storage = createStorage(`test-${Date.now()}-4`);
+      storage.setItem("raw", "raw-value"), expect(storage.getItem("raw")).toBe("raw-value");
+    }), it("should return undefined for missing keys", function () {
+      var storage = createStorage(`test-${Date.now()}-5`);
+      expect(storage.get("missing")).toBeUndefined();
+    }), it("should support has() check", function () {
+      var storage = createStorage(`test-${Date.now()}-6`);
+      expect(storage.has("exists")).toBe(!1), storage.set("exists", "value"), expect(storage.has("exists")).toBe(!0);
+    }), it("should support remove()", function () {
+      var storage = createStorage(`test-${Date.now()}-7`);
+      storage.set("removable", "value"), expect(storage.has("removable")).toBe(!0), storage.remove("removable"), expect(storage.has("removable")).toBe(!1);
+    }), it("should list keys in namespace", function () {
+      var storage = createStorage(`test-${Date.now()}-8`);
+      storage.set("a", "1"), storage.set("b", "2"), storage.set("c", "3"), expect(storage.keys().sort()).toEqual(["a", "b", "c"]);
+    }), it("should clear only namespace keys", function () {
+      var ns1 = `test-${Date.now()}-9a`,
+        ns2 = `test-${Date.now()}-9b`,
+        storage1 = createStorage(ns1),
+        storage2 = createStorage(ns2);
+      storage1.set("key", "value1"), storage2.set("key", "value2"), storage1.clear(), expect(storage1.has("key")).toBe(!1), expect(storage2.has("key")).toBe(!0);
+    });
+  }), describe("createStorage without driver (simulates native without setup)", function () {
+    it("should handle gracefully when operations fail", function () {
+      var storage = createStorage(`test-no-driver-${Date.now()}`);
+      expect(function () {
+        return storage.get("key");
+      }).not.toThrow(), expect(function () {
+        return storage.set("key", "value");
+      }).not.toThrow(), expect(function () {
+        return storage.remove("key");
+      }).not.toThrow(), expect(function () {
+        return storage.has("key");
+      }).not.toThrow(), expect(function () {
+        return storage.keys();
+      }).not.toThrow(), expect(function () {
+        return storage.clear();
+      }).not.toThrow(), expect(function () {
+        return storage.getItem("key");
+      }).not.toThrow(), expect(function () {
+        return storage.setItem("key", "value");
+      }).not.toThrow();
+    });
+  });
+});
+describe("auth storage requirements", function () {
+  it("storage must be initialized before auth client creates storage instances", function () {
+    expect(!0).toBe(!0);
+  }), it("native platforms require explicit storage driver setup", function () {
+    expect(!0).toBe(!0);
+  });
+});
+//# sourceMappingURL=storage.test.native.js.map

package/dist/esm/storage/storage.test.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["beforeEach","describe","expect","it","createStorage","getStorageDriver","setStorageDriver","driver","localStorage","toBeTruthy","mockStorage","Map","mockDriver","getItem","key","_mockStorage_get","get","setItem","value","set","removeItem","delete","getAllKeys","Array","from","keys","toBe","storage","Date","now","namespace","has","obj","name","count","toEqual","toBeUndefined","remove"],"sources":["../../../src/storage/storage.test.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@take-out/helpers",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "sideEffects": false,
   "type": "module",
   "source": "src/index.ts",

package/src/emitter.tsx

@@ -144,20 +144,30 @@ export const useEmitter = <E extends Emitter<any>>(
   }, [emitter, getCallback])
 }
 
+// i think this was useSyncExternalStore but removed for concurrent rendering improvements
+// wondering if we could just always return a deferred value? or default to it?
+
 export const useEmitterValue = <E extends Emitter<any>>(
   emitter: E,
   options?: { disable?: boolean }
 ): EmitterType<E> => {
-  const [state, setState] = useState<EmitterType<E>>(emitter.value)
   const disabled = options?.disable
 
+  // use a function initializer to get current emitter value
+  const [state, setState] = useState<EmitterType<E>>(() => emitter.value)
+
   useLayoutEffect(() => {
     if (disabled) return
+
+    // sync immediately in case emitter changed between render and effect
     if (emitter.value !== state) {
       setState(emitter.value)
     }
+
     return emitter.listen(setState)
-  }, [disabled, emitter, state])
+    // intentionally omit state from deps - we only want to re-subscribe when emitter changes
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [disabled, emitter])
 
   return state
 }

package/src/storage/storage.test.ts

@@ -0,0 +1,172 @@
+import { beforeEach, describe, expect, it } from 'vitest'
+
+import { createStorage } from './createStorage'
+import { getStorageDriver, setStorageDriver } from './driver'
+
+// test the storage driver system to ensure it works correctly
+// this regression test validates that the storage system initializes properly
+// which is critical for native auth to work
+
+describe('storage driver system', () => {
+  describe('driver initialization', () => {
+    it('getStorageDriver should return localStorage fallback on web', () => {
+      // web environment has localStorage which should be used as fallback
+      const driver = getStorageDriver()
+      // in node/vitest environment, localStorage might not exist
+      // but if it does, the driver should work
+      if (typeof localStorage !== 'undefined') {
+        expect(driver).toBeTruthy()
+      }
+    })
+
+    it('should use custom driver when set', () => {
+      const mockStorage = new Map<string, string>()
+      const mockDriver = {
+        getItem: (key: string) => mockStorage.get(key) ?? null,
+        setItem: (key: string, value: string) => mockStorage.set(key, value),
+        removeItem: (key: string) => mockStorage.delete(key),
+        getAllKeys: () => Array.from(mockStorage.keys()),
+      }
+
+      setStorageDriver(mockDriver)
+      const driver = getStorageDriver()
+      expect(driver).toBe(mockDriver)
+    })
+  })
+
+  describe('createStorage with driver', () => {
+    let mockStorage: Map<string, string>
+
+    beforeEach(() => {
+      mockStorage = new Map<string, string>()
+      const mockDriver = {
+        getItem: (key: string) => mockStorage.get(key) ?? null,
+        setItem: (key: string, value: string) => mockStorage.set(key, value),
+        removeItem: (key: string) => mockStorage.delete(key),
+        getAllKeys: () => Array.from(mockStorage.keys()),
+      }
+      setStorageDriver(mockDriver)
+    })
+
+    it('should store and retrieve values', () => {
+      const storage = createStorage<'token', string>(`test-${Date.now()}-1`)
+      storage.set('token', 'test-value')
+      expect(storage.get('token')).toBe('test-value')
+    })
+
+    it('should use namespace prefix', () => {
+      const namespace = `test-${Date.now()}-2`
+      const storage = createStorage<'key', string>(namespace)
+      storage.set('key', 'value')
+
+      // verify the key in the underlying storage has the namespace prefix
+      expect(mockStorage.has(`${namespace}:key`)).toBe(true)
+    })
+
+    it('should handle JSON serialization', () => {
+      const storage = createStorage<'obj', { name: string; count: number }>(
+        `test-${Date.now()}-3`
+      )
+      const obj = { name: 'test', count: 42 }
+      storage.set('obj', obj)
+      expect(storage.get('obj')).toEqual(obj)
+    })
+
+    it('should support raw string operations', () => {
+      const storage = createStorage<'raw', string>(`test-${Date.now()}-4`)
+      storage.setItem('raw', 'raw-value')
+      expect(storage.getItem('raw')).toBe('raw-value')
+    })
+
+    it('should return undefined for missing keys', () => {
+      const storage = createStorage<'missing', string>(`test-${Date.now()}-5`)
+      expect(storage.get('missing')).toBeUndefined()
+    })
+
+    it('should support has() check', () => {
+      const storage = createStorage<'exists', string>(`test-${Date.now()}-6`)
+      expect(storage.has('exists')).toBe(false)
+      storage.set('exists', 'value')
+      expect(storage.has('exists')).toBe(true)
+    })
+
+    it('should support remove()', () => {
+      const storage = createStorage<'removable', string>(`test-${Date.now()}-7`)
+      storage.set('removable', 'value')
+      expect(storage.has('removable')).toBe(true)
+      storage.remove('removable')
+      expect(storage.has('removable')).toBe(false)
+    })
+
+    it('should list keys in namespace', () => {
+      const storage = createStorage<'a' | 'b' | 'c', string>(`test-${Date.now()}-8`)
+      storage.set('a', '1')
+      storage.set('b', '2')
+      storage.set('c', '3')
+      expect(storage.keys().sort()).toEqual(['a', 'b', 'c'])
+    })
+
+    it('should clear only namespace keys', () => {
+      const ns1 = `test-${Date.now()}-9a`
+      const ns2 = `test-${Date.now()}-9b`
+      const storage1 = createStorage<'key', string>(ns1)
+      const storage2 = createStorage<'key', string>(ns2)
+
+      storage1.set('key', 'value1')
+      storage2.set('key', 'value2')
+
+      storage1.clear()
+
+      expect(storage1.has('key')).toBe(false)
+      expect(storage2.has('key')).toBe(true)
+    })
+  })
+
+  describe('createStorage without driver (simulates native without setup)', () => {
+    // this test simulates what happens on native when setupStorage.native.ts
+    // is not imported before auth initialization
+
+    it('should handle gracefully when operations fail', () => {
+      // when driver returns null, operations should not throw
+      // they should just silently fail (return undefined, do nothing)
+      // this is the current behavior but we want to document it
+      const storage = createStorage<'key', string>(`test-no-driver-${Date.now()}`)
+
+      // these should not throw even without a driver
+      expect(() => storage.get('key')).not.toThrow()
+      expect(() => storage.set('key', 'value')).not.toThrow()
+      expect(() => storage.remove('key')).not.toThrow()
+      expect(() => storage.has('key')).not.toThrow()
+      expect(() => storage.keys()).not.toThrow()
+      expect(() => storage.clear()).not.toThrow()
+      expect(() => storage.getItem('key')).not.toThrow()
+      expect(() => storage.setItem('key', 'value')).not.toThrow()
+    })
+  })
+})
+
+describe('auth storage requirements', () => {
+  // these tests document the requirements for auth storage to work correctly
+
+  it('storage must be initialized before auth client creates storage instances', () => {
+    // the expo auth client creates storage at module load time:
+    // const expoStorage = createStorage('expo-auth-client')
+    //
+    // if setStorageDriver is not called before this, storage operations will fail
+    // this is why setupClient.ts must run before any auth code
+
+    // we verify this requirement is documented and understood
+    expect(true).toBe(true)
+  })
+
+  it('native platforms require explicit storage driver setup', () => {
+    // unlike web which has localStorage fallback, native platforms need
+    // MMKV or AsyncStorage to be configured via setStorageDriver()
+    //
+    // this happens in setupStorage.native.ts which must be imported
+    // before platformClient.native.ts creates its storage instance
+
+    // we verify this requirement is documented and understood
+    expect(true).toBe(true)
+  })
+})

package/types/emitter.d.ts

@@ -20,6 +20,8 @@ export declare function createGlobalEmitter<T>(name: string, defaultValue: T, op
 export declare function createEmitter<T>(name: string, defaultValue: T, options?: CreateEmitterOpts<T>): Emitter<T>;
 export type EmitterType<E extends Emitter<any>> = E extends Emitter<infer Val> ? Val : never;
 export declare const useEmitter: <E extends Emitter<any>>(emitter: E, cb: (cb: EmitterType<E>) => void, args?: any[]) => void;
+// i think this was useSyncExternalStore but removed for concurrent rendering improvements
+// wondering if we could just always return a deferred value? or default to it?
 export declare const useEmitterValue: <E extends Emitter<any>>(emitter: E, options?: {
 	disable?: boolean;
 }) => EmitterType<E>;

package/types/emitter.d.ts.map

@@ -1,5 +1,5 @@
 {
-  "mappings": "AAUA,cAAc,KAAK,yBAAyB,OAAO;KAwB9C,eAAe,KAAK,kBAAkB,KAAK;CAC9C;AACD;KAEI,kBAAkB,KAAK;CAC1B;CACA,cAAcA,GAAG,GAAGC,GAAG;AACxB;AAED,OAAO,cAAM,cAAc,GAAG;CAC5B,QAAQ;CACR,OAAO;CACP,UAAU,eAAe;CAEzB,YAAYC,OAAO,GAAGC,UAAU,eAAe;CAK/C,SAAUC,aAAaC,IAAI;CAO3B,OAAQC,MAAM;CAqCd,iBAAgB,QAAQ;AAQzB;;AAGD,OAAO,iBAAS,oBAAoB,GAClCC,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAIX,OAAO,iBAAS,cAAc,GAC5BF,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAKX,YAAY,YAAY,UAAU,gBAChC,UAAU,cAAc,OAAO;AAEjC,OAAO,cAAM,aAAc,UAAU,cACnCC,SAAS,GACTC,KAAKC,IAAI,YAAY,aACrBC;AAeF,OAAO,cAAM,kBAAmB,UAAU,cACxCH,SAAS,GACTI,UAAU;CAAE;AAAmB,MAC9B,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCf,OAAO,cAAM;CAAsB,UAAU;CAAc,UAAU,YAAY;CAAI;EACnFJ,SAAS,GACTK,WAAWb,OAAO,MAAM,GACxBc,UAAU;CACR;CACA;AACD,GACDC,iBACC;AAgCH,OAAO,cAAM;OAA6B,mBAAmB;CAAgB;EAC3EC,UAAU,GACVC,WAAWC,WAAW,WAAW,KAAI,YAAY,EAAE,UAAU,GAC7DC,UAAU;CAAE;CAAmB,WAAWC,GAAG,GAAGC,GAAG;AAAe,MACjE;AAgDH,OAAO,cAAM,mBAAoB,UAAU,cACzCb,SAAS,QACNc,KAAKC,KAAK,YAAY,aAAaZ;AAKxC,OAAO,cAAM,oBAAqB,UAAU,cAC1CH,SAAS,QACN,GACHgB,WAAWC,OAAO,YAAY,OAAO,GACrCC,UAAU;CAAE;CAAmB;AAAgB,GAC/Cf,iBACG;AAUL,OAAO,iBAAS,wBAAwB,GACtCN,cACAC,cAAc,GACdqB,iBAAiB,KAAK,eAAe,IAAI,0BAEnC,QAAQ,KACbC,OAAO,kBAAkB;CAAE,QAAQ;CAAG;AAAkB,OAAM,IAAI",
+  "mappings": "AAUA,cAAc,KAAK,yBAAyB,OAAO;KAwB9C,eAAe,KAAK,kBAAkB,KAAK;CAC9C;AACD;KAEI,kBAAkB,KAAK;CAC1B;CACA,cAAcA,GAAG,GAAGC,GAAG;AACxB;AAED,OAAO,cAAM,cAAc,GAAG;CAC5B,QAAQ;CACR,OAAO;CACP,UAAU,eAAe;CAEzB,YAAYC,OAAO,GAAGC,UAAU,eAAe;CAK/C,SAAUC,aAAaC,IAAI;CAO3B,OAAQC,MAAM;CAqCd,iBAAgB,QAAQ;AAQzB;;AAGD,OAAO,iBAAS,oBAAoB,GAClCC,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAIX,OAAO,iBAAS,cAAc,GAC5BF,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAKX,YAAY,YAAY,UAAU,gBAChC,UAAU,cAAc,OAAO;AAEjC,OAAO,cAAM,aAAc,UAAU,cACnCC,SAAS,GACTC,KAAKC,IAAI,YAAY,aACrBC;;;AAkBF,OAAO,cAAM,kBAAmB,UAAU,cACxCH,SAAS,GACTI,UAAU;CAAE;AAAmB,MAC9B,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDf,OAAO,cAAM;CAAsB,UAAU;CAAc,UAAU,YAAY;CAAI;EACnFJ,SAAS,GACTK,WAAWb,OAAO,MAAM,GACxBc,UAAU;CACR;CACA;AACD,GACDC,iBACC;AAgCH,OAAO,cAAM;OAA6B,mBAAmB;CAAgB;EAC3EC,UAAU,GACVC,WAAWC,WAAW,WAAW,KAAI,YAAY,EAAE,UAAU,GAC7DC,UAAU;CAAE;CAAmB,WAAWC,GAAG,GAAGC,GAAG;AAAe,MACjE;AAgDH,OAAO,cAAM,mBAAoB,UAAU,cACzCb,SAAS,QACNc,KAAKC,KAAK,YAAY,aAAaZ;AAKxC,OAAO,cAAM,oBAAqB,UAAU,cAC1CH,SAAS,QACN,GACHgB,WAAWC,OAAO,YAAY,OAAO,GACrCC,UAAU;CAAE;CAAmB;AAAgB,GAC/Cf,iBACG;AAUL,OAAO,iBAAS,wBAAwB,GACtCN,cACAC,cAAc,GACdqB,iBAAiB,KAAK,eAAe,IAAI,0BAEnC,QAAQ,KACbC,OAAO,kBAAkB;CAAE,QAAQ;CAAG;AAAkB,OAAM,IAAI",
   "names": [
     "a: T",
     "b: T",
@@ -37,7 +37,7 @@
     "src/emitter.tsx"
   ],
   "sourcesContent": [
-    "import { dequal } from 'dequal'\nimport * as React from 'react'\nimport { use, useLayoutEffect, useState } from 'react'\n\nimport { handleAbortError } from './async/abortable'\nimport { DEBUG_LEVEL, EMPTY_ARRAY } from './constants'\nimport { AbortError } from './error/errors'\nimport { globalValue } from './global/globalValue'\nimport { createGlobalContext } from './react/createGlobalContext'\n\nimport type { JSX, PropsWithChildren } from 'react'\n\n// keeps a reference to the current value easily\n\n// TODO can replace with useEffectEvent\nfunction useGet<A>(\n  currentValue: A,\n  initialValue?: any,\n  forwardToFunction?: boolean\n): () => A {\n  const curRef = React.useRef<any>(initialValue ?? currentValue)\n\n  useLayoutEffect(() => {\n    curRef.current = currentValue\n  })\n\n  return React.useCallback(\n    forwardToFunction\n      ? (...args) => curRef.current?.apply(null, args)\n      : () => curRef.current,\n    []\n  )\n}\n\ntype EmitterOptions<T> = CreateEmitterOpts<T> & {\n  name: string\n}\n\ntype CreateEmitterOpts<T> = {\n  silent?: boolean\n  comparator?: (a: T, b: T) => boolean\n}\n\nexport class Emitter<const T> {\n  private disposables = new Set<(cb: any) => void>()\n  value: T\n  options?: EmitterOptions<T>\n\n  constructor(value: T, options?: EmitterOptions<T>) {\n    this.value = value\n    this.options = options\n  }\n\n  listen = (disposable: (cb: T) => void): (() => void) => {\n    this.disposables.add(disposable)\n    return (): void => {\n      this.disposables.delete(disposable)\n    }\n  }\n\n  emit = (next: T): void => {\n    if (process.env.NODE_ENV === 'development') {\n      setCache(this, next)\n    }\n    const compare = this.options?.comparator\n    if (compare) {\n      if (this.value && compare(this.value, next)) {\n        return\n      }\n    } else {\n      if (this.value === next) {\n        if (process.env.NODE_ENV === 'development') {\n          console.warn(\n            `[emitter] ${this.options?.name} no comparator option but received same value!\n            \nthis will emit the same value again, which can be desirable, but we warn to ensure it's not unintended:\n\n- if you want this behavior, add { comparator: isEqualNever }\n- if you want only non-equal values: { comparator: isEqualIdentity }\n- if you want only deeply non-equal values: { comparator: isEqualDeep }`\n          )\n        }\n      }\n    }\n    this.value = next\n    if (DEBUG_LEVEL > 1) {\n      if (!this.options?.silent) {\n        const name = this.options?.name\n        console.groupCollapsed(`📣 ${name}`)\n        console.info(next)\n        console.trace(`trace >`)\n        console.groupEnd()\n      }\n    }\n    this.disposables.forEach((cb) => cb(next))\n  }\n\n  nextValue = (): Promise<T> => {\n    return new Promise<T>((res) => {\n      const dispose = this.listen((val) => {\n        dispose()\n        res(val)\n      })\n    })\n  }\n}\n\n// just createEmitter but ensures it doesn't mess up on HMR\nexport function createGlobalEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  return globalValue(name, () => createEmitter(name, defaultValue, options))\n}\n\nexport function createEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  const existing = createOrUpdateCache(name, defaultValue) as T\n  return new Emitter<T>(existing || defaultValue, { name, ...options })\n}\n\nexport type EmitterType<E extends Emitter<any>> =\n  E extends Emitter<infer Val> ? Val : never\n\nexport const useEmitter = <E extends Emitter<any>>(\n  emitter: E,\n  cb: (cb: EmitterType<E>) => void,\n  args?: any[]\n): void => {\n  const getCallback = useGet(cb)\n\n  useLayoutEffect(() => {\n    return emitter.listen((val) => {\n      try {\n        getCallback()(val)\n      } catch (err) {\n        handleAbortError(err)\n      }\n    })\n  }, [emitter, getCallback])\n}\n\nexport const useEmitterValue = <E extends Emitter<any>>(\n  emitter: E,\n  options?: { disable?: boolean }\n): EmitterType<E> => {\n  const [state, setState] = useState<EmitterType<E>>(emitter.value)\n  const disabled = options?.disable\n\n  useLayoutEffect(() => {\n    if (disabled) return\n    if (emitter.value !== state) {\n      setState(emitter.value)\n    }\n    return emitter.listen(setState)\n  }, [disabled, emitter, state])\n\n  return state\n}\n\n/**\n * By default selectors run every render, as well as when emitters update. This is a change\n * from the previous behavior where they only ran when emitters changed value.\n *\n * The reason for this is because emitters capture the variables in scope of the component\n * each render already by using \"useGet\" by default, which makes them easier to use - you\n * don't need to pass an args[] array except for edge cases.\n *\n * Before explaining why we switched to the default, understand the different uses:\n *\n * - Default behavior - selector is updated every render, and ran every render, as well as\n *   when emitter value changes, so you basically are always up to date.\n *\n * - Set an args[] array as the fourth argument - this will stop the automatic capturing\n *   and instead update selector only when you change args[] yourself. This is good for when you\n *   want explicit control over re-selection and rendering.\n *\n * - With { lazy: true }, the selector only runs when the emitter value changes. If used with\n *   args[], you capture the context of the selector based on args[], if not, it's based on the\n *   current render.\n *\n * I made this change when we had 16 usages of useEmitterSelector and 100% of them are doing very\n * cheap calculations, so this feels like the right pattern. For the rare case of a heavy selector,\n * you have the option to control it.\n *\n */\nexport const useEmitterSelector = <E extends Emitter<any>, T extends EmitterType<E>, R>(\n  emitter: E,\n  selector: (value: T) => R,\n  options?: {\n    disable?: boolean\n    lazy?: boolean\n  },\n  args: any[] = EMPTY_ARRAY\n): R => {\n  const [state, setState] = useState<R>(() => selector(emitter.value))\n  const disabled = options?.disable\n  const getSelector = useGet(selector)\n\n  if (options?.lazy !== true) {\n    const next = selector(emitter.value)\n    if (next !== state) {\n      setState(next)\n    }\n  }\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useLayoutEffect(() => {\n    if (disabled) return\n    return emitter.listen((val) => {\n      try {\n        const selectorFn = args !== EMPTY_ARRAY ? selector : getSelector()\n        const next = selectorFn(val)\n        setState(next)\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    })\n  }, [disabled, emitter, getSelector, ...args])\n\n  return state\n}\n\nexport const useEmittersSelector = <const E extends readonly Emitter<any>[], R>(\n  emitters: E,\n  selector: (values: { [K in keyof E]: EmitterType<E[K]> }) => R,\n  options?: { disable?: boolean; isEqual?: (a: R, b: R) => boolean }\n): R => {\n  const getSelector = useGet(selector)\n  const disabled = options?.disable\n\n  const [state, setState] = useState<R>(() => {\n    const values = emitters.map((e) => e.value) as { [K in keyof E]: EmitterType<E[K]> }\n    return getSelector()(values)\n  })\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useLayoutEffect(() => {\n    if (disabled) {\n      return\n    }\n\n    const handler = () => {\n      const values = emitters.map((e) => e.value) as {\n        [K in keyof E]: EmitterType<E[K]>\n      }\n      try {\n        const next = getSelector()(values)\n        setState((prev) => {\n          if (options?.isEqual?.(prev, next)) {\n            return prev\n          }\n          if (dequal(prev, next)) {\n            return prev\n          }\n          return next\n        })\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    }\n\n    const disposals = emitters.map((emitter) => emitter.listen(handler))\n\n    return () => {\n      disposals.forEach((d) => d())\n    }\n  }, [disabled, getSelector, ...emitters])\n\n  return state\n}\n\nexport const createUseEmitter = <E extends Emitter<any>>(\n  emitter: E\n): ((cb: (val: EmitterType<E>) => void, args?: any[]) => void) => {\n  return (cb: (val: EmitterType<E>) => void, args?: any[]) =>\n    useEmitter(emitter, cb, args)\n}\n\nexport const createUseSelector = <E extends Emitter<any>>(\n  emitter: E\n): (<R>(\n  selector: (value: EmitterType<E>) => R,\n  options?: { disable?: boolean; lazy?: boolean },\n  args?: any[]\n) => R) => {\n  return <R,>(\n    selector: (value: EmitterType<E>) => R,\n    options?: { disable?: boolean; lazy?: boolean },\n    args?: any[]\n  ): R => {\n    return useEmitterSelector(emitter, selector, options, args)\n  }\n}\n\nexport function createContextualEmitter<T>(\n  name: string,\n  defaultValue: T,\n  defaultOptions?: Omit<EmitterOptions<T>, 'name'>\n): readonly [\n  () => Emitter<T>,\n  (props: PropsWithChildren<{ value?: T; silent?: boolean }>) => JSX.Element,\n] {\n  const id = Math.random().toString(36)\n  const EmitterContext = createGlobalContext<Emitter<T> | null>(\n    `contextual-emitter/${id}`,\n    null\n  )\n\n  const useContextEmitter = () => {\n    const emitter = use(EmitterContext)\n    if (!emitter) {\n      throw new Error('useContextEmitter must be used within an EmitterProvider')\n    }\n    return emitter\n  }\n\n  type ProvideEmitterProps = PropsWithChildren<{\n    value?: T\n    silent?: boolean\n  }>\n\n  const ProvideEmitter = (props: ProvideEmitterProps) => {\n    const { children, value, silent } = props\n    const [emitter] = useState(\n      () => new Emitter<T>(value ?? defaultValue, { name, silent, ...defaultOptions })\n    )\n\n    useLayoutEffect(() => {\n      if (value !== undefined && value !== emitter.value) {\n        emitter.emit(value)\n      }\n    }, [value, emitter])\n\n    return <EmitterContext.Provider value={emitter}>{children}</EmitterContext.Provider>\n  }\n\n  return [useContextEmitter, ProvideEmitter] as const\n}\n\nconst HMRCache =\n  process.env.NODE_ENV === 'development'\n    ? new Map<string, { originalDefaultValue: unknown; currentValue: unknown }>()\n    : null\n\nfunction setCache(emitter: Emitter<any>, value: unknown) {\n  const name = emitter.options?.name\n  if (!name) return\n  const cache = HMRCache?.get(name)\n  if (!cache) return\n  cache.currentValue = value\n}\n\nfunction createOrUpdateCache(name: string, defaultValueProp: unknown) {\n  const existing = HMRCache?.get(name)\n  const defaultValue = dequal(existing?.originalDefaultValue, defaultValueProp)\n    ? existing?.currentValue\n    : defaultValueProp\n\n  if (!existing) {\n    HMRCache?.set(name, {\n      originalDefaultValue: defaultValueProp,\n      currentValue: defaultValue,\n    })\n  }\n\n  return defaultValue\n}\n"
+    "import { dequal } from 'dequal'\nimport * as React from 'react'\nimport { use, useLayoutEffect, useState } from 'react'\n\nimport { handleAbortError } from './async/abortable'\nimport { DEBUG_LEVEL, EMPTY_ARRAY } from './constants'\nimport { AbortError } from './error/errors'\nimport { globalValue } from './global/globalValue'\nimport { createGlobalContext } from './react/createGlobalContext'\n\nimport type { JSX, PropsWithChildren } from 'react'\n\n// keeps a reference to the current value easily\n\n// TODO can replace with useEffectEvent\nfunction useGet<A>(\n  currentValue: A,\n  initialValue?: any,\n  forwardToFunction?: boolean\n): () => A {\n  const curRef = React.useRef<any>(initialValue ?? currentValue)\n\n  useLayoutEffect(() => {\n    curRef.current = currentValue\n  })\n\n  return React.useCallback(\n    forwardToFunction\n      ? (...args) => curRef.current?.apply(null, args)\n      : () => curRef.current,\n    []\n  )\n}\n\ntype EmitterOptions<T> = CreateEmitterOpts<T> & {\n  name: string\n}\n\ntype CreateEmitterOpts<T> = {\n  silent?: boolean\n  comparator?: (a: T, b: T) => boolean\n}\n\nexport class Emitter<const T> {\n  private disposables = new Set<(cb: any) => void>()\n  value: T\n  options?: EmitterOptions<T>\n\n  constructor(value: T, options?: EmitterOptions<T>) {\n    this.value = value\n    this.options = options\n  }\n\n  listen = (disposable: (cb: T) => void): (() => void) => {\n    this.disposables.add(disposable)\n    return (): void => {\n      this.disposables.delete(disposable)\n    }\n  }\n\n  emit = (next: T): void => {\n    if (process.env.NODE_ENV === 'development') {\n      setCache(this, next)\n    }\n    const compare = this.options?.comparator\n    if (compare) {\n      if (this.value && compare(this.value, next)) {\n        return\n      }\n    } else {\n      if (this.value === next) {\n        if (process.env.NODE_ENV === 'development') {\n          console.warn(\n            `[emitter] ${this.options?.name} no comparator option but received same value!\n            \nthis will emit the same value again, which can be desirable, but we warn to ensure it's not unintended:\n\n- if you want this behavior, add { comparator: isEqualNever }\n- if you want only non-equal values: { comparator: isEqualIdentity }\n- if you want only deeply non-equal values: { comparator: isEqualDeep }`\n          )\n        }\n      }\n    }\n    this.value = next\n    if (DEBUG_LEVEL > 1) {\n      if (!this.options?.silent) {\n        const name = this.options?.name\n        console.groupCollapsed(`📣 ${name}`)\n        console.info(next)\n        console.trace(`trace >`)\n        console.groupEnd()\n      }\n    }\n    this.disposables.forEach((cb) => cb(next))\n  }\n\n  nextValue = (): Promise<T> => {\n    return new Promise<T>((res) => {\n      const dispose = this.listen((val) => {\n        dispose()\n        res(val)\n      })\n    })\n  }\n}\n\n// just createEmitter but ensures it doesn't mess up on HMR\nexport function createGlobalEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  return globalValue(name, () => createEmitter(name, defaultValue, options))\n}\n\nexport function createEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  const existing = createOrUpdateCache(name, defaultValue) as T\n  return new Emitter<T>(existing || defaultValue, { name, ...options })\n}\n\nexport type EmitterType<E extends Emitter<any>> =\n  E extends Emitter<infer Val> ? Val : never\n\nexport const useEmitter = <E extends Emitter<any>>(\n  emitter: E,\n  cb: (cb: EmitterType<E>) => void,\n  args?: any[]\n): void => {\n  const getCallback = useGet(cb)\n\n  useLayoutEffect(() => {\n    return emitter.listen((val) => {\n      try {\n        getCallback()(val)\n      } catch (err) {\n        handleAbortError(err)\n      }\n    })\n  }, [emitter, getCallback])\n}\n\n// i think this was useSyncExternalStore but removed for concurrent rendering improvements\n// wondering if we could just always return a deferred value? or default to it?\n\nexport const useEmitterValue = <E extends Emitter<any>>(\n  emitter: E,\n  options?: { disable?: boolean }\n): EmitterType<E> => {\n  const disabled = options?.disable\n\n  // use a function initializer to get current emitter value\n  const [state, setState] = useState<EmitterType<E>>(() => emitter.value)\n\n  useLayoutEffect(() => {\n    if (disabled) return\n\n    // sync immediately in case emitter changed between render and effect\n    if (emitter.value !== state) {\n      setState(emitter.value)\n    }\n\n    return emitter.listen(setState)\n    // intentionally omit state from deps - we only want to re-subscribe when emitter changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [disabled, emitter])\n\n  return state\n}\n\n/**\n * By default selectors run every render, as well as when emitters update. This is a change\n * from the previous behavior where they only ran when emitters changed value.\n *\n * The reason for this is because emitters capture the variables in scope of the component\n * each render already by using \"useGet\" by default, which makes them easier to use - you\n * don't need to pass an args[] array except for edge cases.\n *\n * Before explaining why we switched to the default, understand the different uses:\n *\n * - Default behavior - selector is updated every render, and ran every render, as well as\n *   when emitter value changes, so you basically are always up to date.\n *\n * - Set an args[] array as the fourth argument - this will stop the automatic capturing\n *   and instead update selector only when you change args[] yourself. This is good for when you\n *   want explicit control over re-selection and rendering.\n *\n * - With { lazy: true }, the selector only runs when the emitter value changes. If used with\n *   args[], you capture the context of the selector based on args[], if not, it's based on the\n *   current render.\n *\n * I made this change when we had 16 usages of useEmitterSelector and 100% of them are doing very\n * cheap calculations, so this feels like the right pattern. For the rare case of a heavy selector,\n * you have the option to control it.\n *\n */\nexport const useEmitterSelector = <E extends Emitter<any>, T extends EmitterType<E>, R>(\n  emitter: E,\n  selector: (value: T) => R,\n  options?: {\n    disable?: boolean\n    lazy?: boolean\n  },\n  args: any[] = EMPTY_ARRAY\n): R => {\n  const [state, setState] = useState<R>(() => selector(emitter.value))\n  const disabled = options?.disable\n  const getSelector = useGet(selector)\n\n  if (options?.lazy !== true) {\n    const next = selector(emitter.value)\n    if (next !== state) {\n      setState(next)\n    }\n  }\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useLayoutEffect(() => {\n    if (disabled) return\n    return emitter.listen((val) => {\n      try {\n        const selectorFn = args !== EMPTY_ARRAY ? selector : getSelector()\n        const next = selectorFn(val)\n        setState(next)\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    })\n  }, [disabled, emitter, getSelector, ...args])\n\n  return state\n}\n\nexport const useEmittersSelector = <const E extends readonly Emitter<any>[], R>(\n  emitters: E,\n  selector: (values: { [K in keyof E]: EmitterType<E[K]> }) => R,\n  options?: { disable?: boolean; isEqual?: (a: R, b: R) => boolean }\n): R => {\n  const getSelector = useGet(selector)\n  const disabled = options?.disable\n\n  const [state, setState] = useState<R>(() => {\n    const values = emitters.map((e) => e.value) as { [K in keyof E]: EmitterType<E[K]> }\n    return getSelector()(values)\n  })\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useLayoutEffect(() => {\n    if (disabled) {\n      return\n    }\n\n    const handler = () => {\n      const values = emitters.map((e) => e.value) as {\n        [K in keyof E]: EmitterType<E[K]>\n      }\n      try {\n        const next = getSelector()(values)\n        setState((prev) => {\n          if (options?.isEqual?.(prev, next)) {\n            return prev\n          }\n          if (dequal(prev, next)) {\n            return prev\n          }\n          return next\n        })\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    }\n\n    const disposals = emitters.map((emitter) => emitter.listen(handler))\n\n    return () => {\n      disposals.forEach((d) => d())\n    }\n  }, [disabled, getSelector, ...emitters])\n\n  return state\n}\n\nexport const createUseEmitter = <E extends Emitter<any>>(\n  emitter: E\n): ((cb: (val: EmitterType<E>) => void, args?: any[]) => void) => {\n  return (cb: (val: EmitterType<E>) => void, args?: any[]) =>\n    useEmitter(emitter, cb, args)\n}\n\nexport const createUseSelector = <E extends Emitter<any>>(\n  emitter: E\n): (<R>(\n  selector: (value: EmitterType<E>) => R,\n  options?: { disable?: boolean; lazy?: boolean },\n  args?: any[]\n) => R) => {\n  return <R,>(\n    selector: (value: EmitterType<E>) => R,\n    options?: { disable?: boolean; lazy?: boolean },\n    args?: any[]\n  ): R => {\n    return useEmitterSelector(emitter, selector, options, args)\n  }\n}\n\nexport function createContextualEmitter<T>(\n  name: string,\n  defaultValue: T,\n  defaultOptions?: Omit<EmitterOptions<T>, 'name'>\n): readonly [\n  () => Emitter<T>,\n  (props: PropsWithChildren<{ value?: T; silent?: boolean }>) => JSX.Element,\n] {\n  const id = Math.random().toString(36)\n  const EmitterContext = createGlobalContext<Emitter<T> | null>(\n    `contextual-emitter/${id}`,\n    null\n  )\n\n  const useContextEmitter = () => {\n    const emitter = use(EmitterContext)\n    if (!emitter) {\n      throw new Error('useContextEmitter must be used within an EmitterProvider')\n    }\n    return emitter\n  }\n\n  type ProvideEmitterProps = PropsWithChildren<{\n    value?: T\n    silent?: boolean\n  }>\n\n  const ProvideEmitter = (props: ProvideEmitterProps) => {\n    const { children, value, silent } = props\n    const [emitter] = useState(\n      () => new Emitter<T>(value ?? defaultValue, { name, silent, ...defaultOptions })\n    )\n\n    useLayoutEffect(() => {\n      if (value !== undefined && value !== emitter.value) {\n        emitter.emit(value)\n      }\n    }, [value, emitter])\n\n    return <EmitterContext.Provider value={emitter}>{children}</EmitterContext.Provider>\n  }\n\n  return [useContextEmitter, ProvideEmitter] as const\n}\n\nconst HMRCache =\n  process.env.NODE_ENV === 'development'\n    ? new Map<string, { originalDefaultValue: unknown; currentValue: unknown }>()\n    : null\n\nfunction setCache(emitter: Emitter<any>, value: unknown) {\n  const name = emitter.options?.name\n  if (!name) return\n  const cache = HMRCache?.get(name)\n  if (!cache) return\n  cache.currentValue = value\n}\n\nfunction createOrUpdateCache(name: string, defaultValueProp: unknown) {\n  const existing = HMRCache?.get(name)\n  const defaultValue = dequal(existing?.originalDefaultValue, defaultValueProp)\n    ? existing?.currentValue\n    : defaultValueProp\n\n  if (!existing) {\n    HMRCache?.set(name, {\n      originalDefaultValue: defaultValueProp,\n      currentValue: defaultValue,\n    })\n  }\n\n  return defaultValue\n}\n"
   ],
   "version": 3
 }

package/types/storage/storage.test.d.ts

@@ -0,0 +1,3 @@
+export {};
+
+//# sourceMappingURL=storage.test.d.ts.map