@weasel-js/prefs 1.9.4 → 1.10.1

package/dist/react.js

@@ -1,6 +1,6 @@
+import { openPrefsCacheSync, createPrefsStore } from './chunk-ASSX3JHY.js';
 import { useCallback, useSyncExternalStore } from 'react';
 
-// src/hooks.ts
 function usePref(store, path) {
   const subscribe = useCallback((onChange) => store.subscribe(onChange), [store]);
   const getSnapshot = () => store.get(path);
@@ -21,14 +21,86 @@ function usePrefsValues(store) {
   const values = useSyncExternalStore(subscribe, store.values, store.values);
   const unset = useSyncExternalStore(subscribe, store.unset, store.unset);
   const stored = useSyncExternalStore(subscribe, store.stored, store.stored);
+  const loci = useSyncExternalStore(subscribe, store.loci, store.loci);
   const set = useCallback(
     (path, value) => store.set(path, value),
     [store]
   );
   const reset = useCallback((path) => store.reset(path), [store]);
-  return { values, set, unset, stored, reset };
+  const split = useCallback((path, by) => store.split(path, by), [store]);
+  const join = useCallback((path, by) => store.join(path, by), [store]);
+  const setAt = useCallback(
+    (path, value, at) => store.set(path, value, { at }),
+    [store]
+  );
+  return { values, set, unset, stored, reset, loci, split, join, setAt };
+}
+var shared = /* @__PURE__ */ new WeakMap();
+function sharedAt(storage, prefix) {
+  let byPrefix = shared.get(storage);
+  if (!byPrefix) shared.set(storage, byPrefix = /* @__PURE__ */ new Map());
+  let entry = byPrefix.get(prefix);
+  if (!entry) byPrefix.set(prefix, entry = { open: null, bySchema: /* @__PURE__ */ new Map() });
+  return entry;
+}
+function heldAt(at, schema) {
+  let entry = at.bySchema.get(schema);
+  if (!entry) at.bySchema.set(schema, entry = { store: null, holders: 0 });
+  return entry;
+}
+var lent = (cache) => Object.create(cache, {
+  close: {
+    value: async () => {
+      await cache.flush();
+    }
+  }
+});
+function closeUnheldSoon(storage, prefix, schema, entry) {
+  queueMicrotask(() => {
+    if (entry.holders > 0) return;
+    void entry.store?.close();
+    entry.store = null;
+    const byPrefix = shared.get(storage);
+    const at = byPrefix?.get(prefix);
+    if (!at || !byPrefix) return;
+    if (at.bySchema.get(schema) === entry) at.bySchema.delete(schema);
+    if (at.bySchema.size > 0) return;
+    at.open?.stop();
+    void at.open?.cache.close();
+    byPrefix.delete(prefix);
+  });
+}
+function acquire(schema, options) {
+  const { storage, prefix } = options;
+  const at = sharedAt(storage, prefix);
+  const entry = heldAt(at, schema);
+  if (!entry.store) {
+    at.open ??= openPrefsCacheSync(options);
+    entry.store = createPrefsStore(
+      schema,
+      lent(at.open.cache),
+      options.validators,
+      void 0,
+      options.migrations?.length ?? 0,
+      options.blends
+    );
+    if (entry.holders === 0) closeUnheldSoon(storage, prefix, schema, entry);
+  }
+  return entry.store;
+}
+function usePrefsStore(schema, options) {
+  const { storage, prefix } = options;
+  const hold = useCallback(() => {
+    const entry = heldAt(sharedAt(storage, prefix), schema);
+    entry.holders++;
+    return () => {
+      if (--entry.holders === 0) closeUnheldSoon(storage, prefix, schema, entry);
+    };
+  }, [storage, prefix, schema]);
+  const current = () => acquire(schema, options);
+  return useSyncExternalStore(hold, current, current);
 }
 
-export { usePref, usePrefsValues };
+export { usePref, usePrefsStore, usePrefsValues };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks.ts"],"names":[],"mappings":";;;AAMO,SAAS,OAAA,CACd,OACA,IAAA,EAIA;AACA,EAAA,MAAM,SAAA,GAAY,WAAA,CAAY,CAAC,QAAA,KAAyB,KAAA,CAAM,UAAU,QAAQ,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAC1F,EAAA,MAAM,WAAA,GAAc,MAAM,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AACxC,EAAA,MAAM,KAAA,GAAQ,oBAAA,CAAqB,SAAA,EAAW,WAAA,EAAa,WAAW,CAAA;AACtE,EAAA,MAAM,GAAA,GAAM,WAAA;AAAA,IACV,CAAC,IAAA,KAA+E;AAC9E,MAAA,KAAA,CAAM,GAAA;AAAA,QACJ,IAAA;AAAA,QACA,OAAO,SAAS,UAAA,GACX,IAAA,CAAwD,MAAM,GAAA,CAAI,IAAI,CAAC,CAAA,GACxE;AAAA,OACN;AAAA,IACF,CAAA;AAAA,IACA,CAAC,OAAO,IAAI;AAAA,GACd;AACA,EAAA,OAAO,CAAC,OAAO,GAAG,CAAA;AACpB;AAKO,SAAS,eAAoC,KAAA,EAMlD;AACA,EAAA,MAAM,SAAA,GAAY,WAAA,CAAY,CAAC,QAAA,KAAyB,KAAA,CAAM,UAAU,QAAQ,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAC1F,EAAA,MAAM,SAAS,oBAAA,CAAqB,SAAA,EAAW,KAAA,CAAM,MAAA,EAAQ,MAAM,MAAM,CAAA;AACzE,EAAA,MAAM,QAAQ,oBAAA,CAAqB,SAAA,EAAW,KAAA,CAAM,KAAA,EAAO,MAAM,KAAK,CAAA;AACtE,EAAA,MAAM,SAAS,oBAAA,CAAqB,SAAA,EAAW,KAAA,CAAM,MAAA,EAAQ,MAAM,MAAM,CAAA;AACzE,EAAA,MAAM,GAAA,GAAM,WAAA;AAAA,IACV,CAAC,IAAA,EAAc,KAAA,KAAmB,KAAA,CAAM,GAAA,CAAI,MAAqB,KAAc,CAAA;AAAA,IAC/E,CAAC,KAAK;AAAA,GACR;AACA,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,CAAC,IAAA,KAAkB,KAAA,CAAM,MAAM,IAAI,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AACvE,EAAA,OAAO,EAAE,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAO,QAAQ,KAAA,EAAM;AAC7C","file":"react.js","sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\nimport type { PrefPath, PrefValueAt } from './paths';\nimport type { PrefGroup } from './groups';\nimport type { PrefsStore } from './store';\n\n/** One leaf of `store`, as React state. */\nexport function usePref<S extends PrefGroup, P extends PrefPath<S>>(\n  store: PrefsStore<S>,\n  path: P,\n): [\n  PrefValueAt<S, P>,\n  (next: PrefValueAt<S, P> | ((prev: PrefValueAt<S, P>) => PrefValueAt<S, P>)) => void,\n] {\n  const subscribe = useCallback((onChange: () => void) => store.subscribe(onChange), [store]);\n  const getSnapshot = () => store.get(path);\n  const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  const set = useCallback(\n    (next: PrefValueAt<S, P> | ((prev: PrefValueAt<S, P>) => PrefValueAt<S, P>)) => {\n      store.set(\n        path,\n        typeof next === 'function'\n          ? (next as (prev: PrefValueAt<S, P>) => PrefValueAt<S, P>)(store.get(path))\n          : next,\n      );\n    },\n    [store, path],\n  );\n  return [value, set];\n}\n\n/** The whole of `store` as React state, shaped for `PrefsForm`: `values`,\n *  `onChange={set}`, `auto={unset}`, and `reset` for `onAutoChange`. `stored`\n *  is `store.stored()`. */\nexport function usePrefsValues<S extends PrefGroup>(store: PrefsStore<S>): {\n  values: Record<string, unknown>;\n  set: (path: string, value: unknown) => void;\n  unset: ReadonlySet<string>;\n  stored: Record<string, unknown>;\n  reset: (path?: string) => void;\n} {\n  const subscribe = useCallback((onChange: () => void) => store.subscribe(onChange), [store]);\n  const values = useSyncExternalStore(subscribe, store.values, store.values);\n  const unset = useSyncExternalStore(subscribe, store.unset, store.unset);\n  const stored = useSyncExternalStore(subscribe, store.stored, store.stored);\n  const set = useCallback(\n    (path: string, value: unknown) => store.set(path as PrefPath<S>, value as never),\n    [store],\n  );\n  const reset = useCallback((path?: string) => store.reset(path), [store]);\n  return { values, set, unset, stored, reset };\n}\n"]}
+{"version":3,"sources":["../src/hooks.ts","../src/usePrefsStore.ts"],"names":["useCallback","useSyncExternalStore"],"mappings":"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","file":"react.js","sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\nimport type { PrefPath, PrefValueAt } from './paths';\nimport type { PrefGroup } from './groups';\nimport type { PrefLocus, PrefSelection } from './locus';\nimport type { PrefsStore } from './store';\n\n/** One leaf of `store`, as React state. */\nexport function usePref<S extends PrefGroup, P extends PrefPath<S>>(\n  store: PrefsStore<S>,\n  path: P,\n): [\n  PrefValueAt<S, P>,\n  (next: PrefValueAt<S, P> | ((prev: PrefValueAt<S, P>) => PrefValueAt<S, P>)) => void,\n] {\n  const subscribe = useCallback((onChange: () => void) => store.subscribe(onChange), [store]);\n  const getSnapshot = () => store.get(path);\n  const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  const set = useCallback(\n    (next: PrefValueAt<S, P> | ((prev: PrefValueAt<S, P>) => PrefValueAt<S, P>)) => {\n      store.set(\n        path,\n        typeof next === 'function'\n          ? (next as (prev: PrefValueAt<S, P>) => PrefValueAt<S, P>)(store.get(path))\n          : next,\n      );\n    },\n    [store, path],\n  );\n  return [value, set];\n}\n\n/** The whole of `store` as React state, shaped for `PrefsForm`: `values`,\n *  `onChange={set}`, `auto={unset}`, and `reset` for `onAutoChange`; for its\n *  split values, `loci`, `onSplit={split}`, `onJoin={join}`, and\n *  `onChangeAt={setAt}`. `stored` is `store.stored()`. */\nexport function usePrefsValues<S extends PrefGroup>(store: PrefsStore<S>): {\n  values: Record<string, unknown>;\n  set: (path: string, value: unknown) => void;\n  unset: ReadonlySet<string>;\n  stored: Record<string, unknown>;\n  reset: (path?: string) => void;\n  loci: ReadonlyMap<string, PrefLocus>;\n  split: (path: string, by: string) => void;\n  join: (path: string, by: string) => void;\n  setAt: (path: string, value: unknown, at: PrefSelection) => void;\n} {\n  const subscribe = useCallback((onChange: () => void) => store.subscribe(onChange), [store]);\n  const values = useSyncExternalStore(subscribe, store.values, store.values);\n  const unset = useSyncExternalStore(subscribe, store.unset, store.unset);\n  const stored = useSyncExternalStore(subscribe, store.stored, store.stored);\n  const loci = useSyncExternalStore(subscribe, store.loci, store.loci);\n  const set = useCallback(\n    (path: string, value: unknown) => store.set(path as PrefPath<S>, value as never),\n    [store],\n  );\n  const reset = useCallback((path?: string) => store.reset(path), [store]);\n  const split = useCallback((path: string, by: string) => store.split(path as PrefPath<S>, by), [store]);\n  const join = useCallback((path: string, by: string) => store.join(path as PrefPath<S>, by), [store]);\n  const setAt = useCallback(\n    (path: string, value: unknown, at: PrefSelection) => store.set(path as PrefPath<S>, value as never, { at }),\n    [store],\n  );\n  return { values, set, unset, stored, reset, loci, split, join, setAt };\n}\n","import type { OwnedRecordCache, StorageAdapter, SyncStorageAdapter } from '@weasel-js/storage';\nimport { useCallback, useSyncExternalStore } from 'react';\nimport type { PrefGroup } from './groups';\nimport { openPrefsCacheSync, type PrefsOptions } from './open';\nimport { createPrefsStore, type PrefsStore } from './store';\n\n/** The store open for one schema, and how many mounted components hold it. */\ninterface Held {\n  store: PrefsStore<PrefGroup> | null;\n  holders: number;\n}\n\n/** The one cache open on a prefix, and a store over it for each schema in use. */\ninterface Shared {\n  open: { cache: OwnedRecordCache; stop: () => void } | null;\n  bySchema: Map<PrefGroup, Held>;\n}\n\ntype SyncOptions = PrefsOptions & { storage: SyncStorageAdapter };\n\nconst shared = new WeakMap<StorageAdapter, Map<string, Shared>>();\n\nfunction sharedAt(storage: StorageAdapter, prefix: string): Shared {\n  let byPrefix = shared.get(storage);\n  if (!byPrefix) shared.set(storage, (byPrefix = new Map()));\n  let entry = byPrefix.get(prefix);\n  if (!entry) byPrefix.set(prefix, (entry = { open: null, bySchema: new Map() }));\n  return entry;\n}\n\nfunction heldAt(at: Shared, schema: PrefGroup): Held {\n  let entry = at.bySchema.get(schema);\n  if (!entry) at.bySchema.set(schema, (entry = { store: null, holders: 0 }));\n  return entry;\n}\n\n/** `cache` for one store among several: closing it sends queued writes and\n *  leaves the cache open for the others. */\nconst lent = (cache: OwnedRecordCache): OwnedRecordCache =>\n  Object.create(cache, {\n    close: {\n      value: async (): Promise<void> => {\n        await cache.flush();\n      },\n    },\n  }) as OwnedRecordCache;\n\n/** Close a store nothing holds, and the cache once no store is over it, a\n *  microtask on: after the remount StrictMode and fast refresh make in the\n *  same tick, which holds it again. */\nfunction closeUnheldSoon(storage: StorageAdapter, prefix: string, schema: PrefGroup, entry: Held): void {\n  queueMicrotask(() => {\n    if (entry.holders > 0) return;\n    void entry.store?.close();\n    entry.store = null;\n    const byPrefix = shared.get(storage);\n    const at = byPrefix?.get(prefix);\n    if (!at || !byPrefix) return;\n    if (at.bySchema.get(schema) === entry) at.bySchema.delete(schema);\n    if (at.bySchema.size > 0) return;\n    at.open?.stop();\n    // `close` sends queued writes before its first await, and a sync adapter's\n    // write lands in that call, so a cache opened next reads them.\n    void at.open?.cache.close();\n    byPrefix.delete(prefix);\n  });\n}\n\nfunction acquire<S extends PrefGroup>(schema: S, options: SyncOptions): PrefsStore<S> {\n  const { storage, prefix } = options;\n  const at = sharedAt(storage, prefix);\n  const entry = heldAt(at, schema);\n  if (!entry.store) {\n    at.open ??= openPrefsCacheSync(options);\n    entry.store = createPrefsStore(\n      schema,\n      lent(at.open.cache),\n      options.validators,\n      undefined,\n      options.migrations?.length ?? 0,\n      options.blends,\n    ) as unknown as PrefsStore<PrefGroup>;\n    // Opened by a render that may never mount.\n    if (entry.holders === 0) closeUnheldSoon(storage, prefix, schema, entry);\n  }\n  return entry.store as unknown as PrefsStore<S>;\n}\n\n/**\n * A store for `schema`, open while the component is mounted: opened during\n * the first render, so that render has values, and closed, with its queued\n * writes sent, when the component unmounts.\n *\n * Components naming the same `storage`, `prefix`, and `schema` share one\n * store, which closes when the last of them unmounts. Components naming the\n * same `storage` and `prefix` with different schemas each get a store of\n * their own over the same records, so a write through one is read by the\n * others at once, and each hears it as a `local` change. They must pass the\n * same `migrations`: the records are migrated once, when the first opens.\n *\n * `storage` and `schema` are compared by identity and `prefix` by value, so\n * keep the first two out of the render body. A change to any of the three\n * closes the store and returns the one for the new three. The `options`\n * object itself may be new every render: `migrations` and `validators` are\n * read when a store opens, and a change to either alone opens nothing.\n */\nexport function usePrefsStore<S extends PrefGroup>(schema: S, options: SyncOptions): PrefsStore<S> {\n  const { storage, prefix } = options;\n  const hold = useCallback(() => {\n    const entry = heldAt(sharedAt(storage, prefix), schema);\n    entry.holders++;\n    return () => {\n      if (--entry.holders === 0) closeUnheldSoon(storage, prefix, schema, entry);\n    };\n  }, [storage, prefix, schema]);\n  // Read again once held, so a store closed between render and mount is\n  // replaced before anything uses it.\n  const current = () => acquire(schema, options);\n  return useSyncExternalStore(hold, current, current);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/prefs",
-  "version": "1.9.4",
+  "version": "1.10.1",
   "description": "A preferences schema, a store that loads, validates, migrates and persists values against it, and React hooks over the store.",
   "license": "MIT",
   "type": "module",
@@ -41,9 +41,10 @@
     "build": "tsup"
   },
   "dependencies": {
-    "@weasel-js/quantity": "1.9.4",
-    "@weasel-js/registry": "1.9.4",
-    "@weasel-js/storage": "1.9.4"
+    "@weasel-js/paint": "1.10.1",
+    "@weasel-js/quantity": "1.10.1",
+    "@weasel-js/registry": "1.10.1",
+    "@weasel-js/storage": "1.10.1"
   },
   "peerDependencies": {
     "react": ">=18"