@shapeshift-labs/frontier-react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shapeshift Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# Frontier React
+
+React external-store hooks and adapters for Frontier state, cache, and CRDT surfaces.
+
+This package sits above the Frontier runtime packages. It gives React apps a small `useSyncExternalStore` bridge without making core Frontier packages depend on React.
+
+- npm: [`@shapeshift-labs/frontier-react`](https://www.npmjs.com/package/@shapeshift-labs/frontier-react)
+- source: [`siliconjungle/-shapeshift-labs-frontier-react`](https://github.com/siliconjungle/-shapeshift-labs-frontier-react)
+- license: MIT
+
+## Related Packages
+
+- [`@shapeshift-labs/frontier`](https://www.npmjs.com/package/@shapeshift-labs/frontier): core JSON diff/apply primitives used by the patch store.
+- [`@shapeshift-labs/frontier-state`](https://www.npmjs.com/package/@shapeshift-labs/frontier-state): patch-routed app-state engine.
+- [`@shapeshift-labs/frontier-state-cache`](https://www.npmjs.com/package/@shapeshift-labs/frontier-state-cache): normalized query/result cache.
+- [`@shapeshift-labs/frontier-crdt`](https://www.npmjs.com/package/@shapeshift-labs/frontier-crdt): CRDT document layer.
+- [`@shapeshift-labs/frontier-crdt-sync`](https://www.npmjs.com/package/@shapeshift-labs/frontier-crdt-sync): sync/repo/provider layer for CRDT documents.
+
+Package source repositories:
+
+- [`siliconjungle/-shapeshift-labs-frontier`](https://github.com/siliconjungle/-shapeshift-labs-frontier)
+- [`siliconjungle/-shapeshift-labs-frontier-state`](https://github.com/siliconjungle/-shapeshift-labs-frontier-state)
+- [`siliconjungle/-shapeshift-labs-frontier-state-cache`](https://github.com/siliconjungle/-shapeshift-labs-frontier-state-cache)
+- [`siliconjungle/-shapeshift-labs-frontier-crdt`](https://github.com/siliconjungle/-shapeshift-labs-frontier-crdt)
+- [`siliconjungle/-shapeshift-labs-frontier-crdt-sync`](https://github.com/siliconjungle/-shapeshift-labs-frontier-crdt-sync)
+- [`siliconjungle/-shapeshift-labs-frontier-react`](https://github.com/siliconjungle/-shapeshift-labs-frontier-react)
+
+## Install
+
+```sh
+npm install react @shapeshift-labs/frontier @shapeshift-labs/frontier-react
+```
+
+Install the Frontier packages you want to wrap separately, for example `@shapeshift-labs/frontier-state`, `@shapeshift-labs/frontier-state-cache`, or `@shapeshift-labs/frontier-crdt`.
+
+## Usage
+
+Patch store:
+
+```tsx
+import { createFrontierPatchStore, useFrontierStore } from '@shapeshift-labs/frontier-react';
+
+const store = createFrontierPatchStore({
+  todos: [{ id: 'a', text: 'Ship', done: false }]
+});
+
+function TodoCount() {
+  const count = useFrontierStore(store, (state) => state.todos.length);
+  return <span>{count}</span>;
+}
+
+store.update((state) => ({
+  ...state,
+  todos: state.todos.concat({ id: 'b', text: 'Document', done: false })
+}));
+```
+
+State engine:
+
+```tsx
+import { createStateEngine } from '@shapeshift-labs/frontier-state';
+import { createFrontierStateStore, useFrontierSelector } from '@shapeshift-labs/frontier-react';
+
+const engine = createStateEngine({ count: 0 });
+const store = createFrontierStateStore(engine);
+
+function Counter() {
+  const count = useFrontierSelector(store, (state) => state.count);
+  return <button onClick={() => engine.commit({ count: count + 1 })}>{count}</button>;
+}
+```
+
+Query cache:
+
+```tsx
+import { createQueryCache } from '@shapeshift-labs/frontier-state-cache';
+import { createFrontierQueryStore, useFrontierStore } from '@shapeshift-labs/frontier-react';
+
+const cache = createQueryCache();
+const todos = createFrontierQueryStore(cache, ['todos']);
+
+function Todos() {
+  const rows = useFrontierStore(todos) ?? [];
+  return rows.map((row) => <div key={row.id}>{row.text}</div>);
+}
+```
+
+CRDT state document:
+
+```tsx
+import { createCrdtStateEngine } from '@shapeshift-labs/frontier-crdt';
+import { createFrontierCrdtStore, useFrontierStore } from '@shapeshift-labs/frontier-react';
+
+const doc = createCrdtStateEngine({ actorId: 'alice' });
+const store = createFrontierCrdtStore(doc);
+
+function Title() {
+  const title = useFrontierStore(store, (state) => state?.title ?? '');
+  return <h1>{title}</h1>;
+}
+```
+
+## API
+
+```ts
+import {
+  createFrontierPatchStore,
+  createFrontierStoreAdapter,
+  createFrontierStateStore,
+  createFrontierQueryStore,
+  createFrontierEntityStore,
+  createFrontierCrdtStore,
+  useFrontierSnapshot,
+  useFrontierStore,
+  useFrontierSelector
+} from '@shapeshift-labs/frontier-react';
+```
+
+### `useFrontierStore(store, selector?, equals?)`
+
+Subscribes to a Frontier external store with React `useSyncExternalStore`. If a selector is supplied, the hook returns the selected value and reuses the previous selected value when `equals(previous, next)` returns true.
+
+### `useFrontierSelector(store, selector, equals?)`
+
+Alias for selected store reads. Use this when a component should render only from a small part of a larger Frontier snapshot.
+
+### `useFrontierSnapshot(store)`
+
+Returns the whole current snapshot from a Frontier external store.
+
+### `createFrontierPatchStore(initial, options?)`
+
+Creates a small immutable JSON store backed by Frontier `diff()` and `applyPatchImmutable()`.
+
+```ts
+const store = createFrontierPatchStore({ count: 0 });
+const patch = store.setSnapshot({ count: 1 });
+store.applyPatch(patch);
+```
+
+### `createFrontierStoreAdapter(source)`
+
+Adapts any structural source with `getSnapshot`, `get`, `value`, or `toJSON` plus `subscribe` or `watch` into the store shape consumed by the hooks.
+
+### `createFrontierStateStore(engine, options?)`
+
+Wraps a Frontier state engine-like object with `get()` and `watch()`.
+
+### `createFrontierQueryStore(cache, key)`
+
+Wraps a Frontier state-cache query using `getQueryData()` and `watchQuery()`.
+
+### `createFrontierEntityStore(cache, entity)`
+
+Wraps a Frontier state-cache entity using `getEntity()` and `watchEntity()`.
+
+### `createFrontierCrdtStore(doc, options?)`
+
+Wraps a CRDT state document-like object with `get()` or `toJSON()` and optional `watch()`.
+
+## Subpath Imports
+
+```ts
+import { createFrontierPatchStore } from '@shapeshift-labs/frontier-react/store';
+import { useFrontierStore } from '@shapeshift-labs/frontier-react/hooks';
+import { createFrontierQueryStore } from '@shapeshift-labs/frontier-react/adapters';
+```
+
+## Package Scope
+
+This package owns:
+
+- React `useSyncExternalStore` hooks for Frontier stores.
+- A tiny Frontier patch store for local React state.
+- Structural adapters for state engines, query caches, entities, and CRDT documents.
+- React-facing tests, fuzzers, and package-local benchmarks.
+
+It does not own:
+
+- Frontier diff/apply semantics.
+- State engine routing, query cache storage, CRDT documents, sync providers, WebSocket transports, rich text, or logging.
+- React components, styling, Suspense data loading, server components, router bindings, auth, or persistence.
+
+## TypeScript
+
+The package ships ESM JavaScript plus `.d.ts` declarations for root, `./store`, `./hooks`, and `./adapters`. React is a peer dependency, so apps keep control of their React version.
+
+## Validation
+
+```sh
+npm test
+npm run fuzz
+npm run bench
+npm run pack:dry
+```
+
+The package test suite covers root and subpath imports, patch-store commits, patch application, React hook rendering, state-engine adapters, query/entity cache adapters, CRDT document adapters, and randomized patch-store replay.
+
+## Benchmarks
+
+Run the package-local benchmark:
+
+```sh
+npm run bench
+```
+
+Latest local package benchmark on Node v26.1.0, darwin arm64, 7 rounds:
+
+| Fixture | Median | p95 |
+| --- | ---: | ---: |
+| React patch store replace, 1k rows one edit | 200.74 us | 214.39 us |
+| External store adapter notify 10 listeners | 0.07 us | 0.09 us |
+| State engine adapter snapshot read | 0.01 us | 0.01 us |
+
+These are Frontier-only package measurements, not competitor comparisons.
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

package/benchmarks/package-bench.mjs

@@ -0,0 +1,124 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { fileURLToPath } from 'node:url';
+import {
+  createFrontierPatchStore,
+  createFrontierStateStore,
+  createFrontierStoreAdapter
+} from '../dist/index.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const rootDir = path.resolve(__dirname, '..');
+const args = parseArgs(process.argv.slice(2));
+const rounds = readPositiveInt(args.rounds, 9);
+const outPath = args.out ? path.resolve(rootDir, args.out) : null;
+let sink = 0;
+
+const baseRows = Array.from({ length: 1000 }, (_value, index) => ({ id: `r${index}`, value: index, done: false }));
+const patchStore = createFrontierPatchStore({ rows: baseRows, tick: 0 });
+const adapterSource = createAdapterSource({ count: 0 });
+const adapter = createFrontierStoreAdapter(adapterSource);
+const stateStore = createFrontierStateStore(createStateEngineLike({ value: 0 }));
+
+const rows = [
+  runRow('React patch store replace, 1k rows one edit', 500, () => {
+    const current = patchStore.getSnapshot();
+    const rows = current.rows.slice();
+    rows[17] = { ...rows[17], done: !rows[17].done };
+    sink += patchStore.setSnapshot({ rows, tick: current.tick + 1 }).length;
+  }),
+  runRow('External store adapter notify 10 listeners', 50000, () => {
+    sink += adapterSource.emit();
+  }),
+  runRow('State engine adapter snapshot read', 200000, () => {
+    sink += stateStore.getSnapshot().value;
+  })
+];
+
+finish('@shapeshift-labs/frontier-react', rows);
+
+function measure(fn, inner) {
+  for (let i = 0; i < inner; i++) fn();
+  const samples = new Array(rounds);
+  for (let roundIndex = 0; roundIndex < rounds; roundIndex++) {
+    const start = performance.now();
+    for (let i = 0; i < inner; i++) fn();
+    samples[roundIndex] = ((performance.now() - start) * 1000) / inner;
+  }
+  samples.sort((left, right) => left - right);
+  return { median: percentile(samples, 0.5), p95: percentile(samples, 0.95) };
+}
+
+function runRow(name, inner, fn) {
+  const timing = measure(fn, inner);
+  return { fixture: name, medianUs: round(timing.median), p95Us: round(timing.p95) };
+}
+
+function createAdapterSource(initial) {
+  let value = initial;
+  const listeners = new Set();
+  for (let i = 0; i < 10; i++) listeners.add(() => { sink++; });
+  return {
+    getSnapshot: () => value,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    emit() {
+      value = { count: value.count + 1 };
+      for (const listener of listeners) listener();
+      return value.count;
+    }
+  };
+}
+
+function createStateEngineLike(initial) {
+  const listeners = new Set();
+  return {
+    get: () => initial,
+    watch(_path, listener) {
+      listeners.add(listener);
+      return { unsubscribe: () => listeners.delete(listener) };
+    }
+  };
+}
+
+function finish(packageName, rows) {
+  const report = {
+    package: packageName,
+    version: readPackageVersion(),
+    generatedAt: new Date().toISOString(),
+    node: process.version,
+    platform: process.platform + ' ' + process.arch,
+    rounds,
+    rows
+  };
+  if (outPath) {
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, JSON.stringify(report, null, 2) + '\n');
+  }
+  printReport(report);
+  if (sink === 42) console.log('sink=' + sink);
+}
+
+function printReport(report) {
+  console.log(report.package + ' package benchmark');
+  console.log('Node ' + report.node + ' on ' + report.platform + ', rounds=' + rounds);
+  console.log('These are Frontier-only package measurements, not competitor comparisons.');
+  console.log('');
+  console.log(padRight('Fixture', 48) + padLeft('Median', 12) + padLeft('p95', 11));
+  for (const row of report.rows) {
+    console.log(padRight(row.fixture, 48) + padLeft(formatUs(row.medianUs), 12) + padLeft(formatUs(row.p95Us), 11));
+  }
+  if (outPath) console.log('\nwrote ' + path.relative(rootDir, outPath));
+}
+
+function percentile(sorted, fraction) { return sorted[Math.min(sorted.length - 1, Math.max(0, Math.ceil(sorted.length * fraction) - 1))]; }
+function readPackageVersion() { return JSON.parse(fs.readFileSync(path.join(rootDir, 'package.json'), 'utf8')).version; }
+function parseArgs(argv) { const out = {}; for (let i = 0; i < argv.length; i++) { const arg = argv[i]; if (arg === '--rounds') out.rounds = argv[++i]; else if (arg === '--out') out.out = argv[++i]; else if (arg === '--help' || arg === '-h') { console.log('Usage: npm run bench -- [--rounds 9] [--out benchmarks/results/package-bench.json]'); process.exit(0); } else throw new Error('unknown argument: ' + arg); } return out; }
+function readPositiveInt(value, fallback) { if (value === undefined) return fallback; const number = Number(value); if (!Number.isInteger(number) || number <= 0) throw new Error('expected positive integer, got ' + value); return number; }
+function round(value) { return Math.round(value * 100) / 100; }
+function formatUs(value) { return value >= 1000 ? (value / 1000).toFixed(2) + ' ms' : value.toFixed(2) + ' us'; }
+function padRight(value, width) { return String(value).padEnd(width); }
+function padLeft(value, width) { return String(value).padStart(width); }

package/dist/adapters.d.ts

@@ -0,0 +1,6 @@
+import type { FrontierCrdtDocumentLike, FrontierEntityCacheLike, FrontierExternalStore, FrontierQueryCacheLike, FrontierStateEngineLike, FrontierStateStoreOptions } from './types.js';
+export declare function createFrontierStateStore<TSnapshot>(engine: FrontierStateEngineLike<TSnapshot>, options?: FrontierStateStoreOptions): FrontierExternalStore<TSnapshot>;
+export declare function createFrontierQueryStore<TSnapshot, TQueryKey>(cache: FrontierQueryCacheLike<TSnapshot, TQueryKey>, key: TQueryKey): FrontierExternalStore<TSnapshot | undefined>;
+export declare function createFrontierEntityStore<TSnapshot, TEntity>(cache: FrontierEntityCacheLike<TSnapshot, TEntity>, entity: TEntity): FrontierExternalStore<TSnapshot | undefined>;
+export declare function createFrontierCrdtStore<TSnapshot>(doc: FrontierCrdtDocumentLike<TSnapshot>, options?: FrontierStateStoreOptions): FrontierExternalStore<TSnapshot>;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,wBAAgB,wBAAwB,CAAC,SAAS,EAChD,MAAM,EAAE,uBAAuB,CAAC,SAAS,CAAC,EAC1C,OAAO,GAAE,yBAA8B,GACtC,qBAAqB,CAAC,SAAS,CAAC,CAMlC;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,EAC3D,KAAK,EAAE,sBAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,EACnD,GAAG,EAAE,SAAS,GACb,qBAAqB,CAAC,SAAS,GAAG,SAAS,CAAC,CAK9C;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,OAAO,EAC1D,KAAK,EAAE,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC,EAClD,MAAM,EAAE,OAAO,GACd,qBAAqB,CAAC,SAAS,GAAG,SAAS,CAAC,CAK9C;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAC/C,GAAG,EAAE,wBAAwB,CAAC,SAAS,CAAC,EACxC,OAAO,GAAE,yBAA8B,GACtC,qBAAqB,CAAC,SAAS,CAAC,CAUlC"}

package/dist/adapters.js

@@ -0,0 +1,35 @@
+import { createFrontierStoreAdapter, normalizeUnsubscribe } from './store.js';
+export function createFrontierStateStore(engine, options = {}) {
+    const path = options.path ?? '';
+    return createFrontierStoreAdapter({
+        getSnapshot: () => engine.get(),
+        subscribe: (listener) => normalizeUnsubscribe(engine.watch(path, listener))
+    });
+}
+export function createFrontierQueryStore(cache, key) {
+    return createFrontierStoreAdapter({
+        getSnapshot: () => cache.getQueryData(key),
+        subscribe: (listener) => normalizeUnsubscribe(cache.watchQuery(key, listener))
+    });
+}
+export function createFrontierEntityStore(cache, entity) {
+    return createFrontierStoreAdapter({
+        getSnapshot: () => cache.getEntity(entity),
+        subscribe: (listener) => normalizeUnsubscribe(cache.watchEntity(entity, listener))
+    });
+}
+export function createFrontierCrdtStore(doc, options = {}) {
+    const path = options.path ?? '';
+    return createFrontierStoreAdapter({
+        getSnapshot: () => {
+            if (typeof doc.get === 'function')
+                return doc.get();
+            if (typeof doc.toJSON === 'function')
+                return doc.toJSON();
+            throw new TypeError('Frontier CRDT store needs get() or toJSON()');
+        },
+        subscribe: (listener) => typeof doc.watch === 'function' ? normalizeUnsubscribe(doc.watch(path, listener)) : noop
+    });
+}
+function noop() { }
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAU9E,MAAM,UAAU,wBAAwB,CACtC,MAA0C,EAC1C,UAAqC,EAAE;IAEvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,OAAO,0BAA0B,CAAC;QAChC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE;QAC/B,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KAC5E,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAmD,EACnD,GAAc;IAEd,OAAO,0BAA0B,CAAC;QAChC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC;QAC1C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;KAC/E,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAkD,EAClD,MAAe;IAEf,OAAO,0BAA0B,CAAC;QAChC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAC1C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KACnF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,GAAwC,EACxC,UAAqC,EAAE;IAEvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,OAAO,0BAA0B,CAAC;QAChC,WAAW,EAAE,GAAG,EAAE;YAChB,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,UAAU;gBAAE,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC;YACpD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;YAC1D,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;QACrE,CAAC;QACD,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;KAClH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,KAAU,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,6 @@
+import type { FrontierEquality, FrontierExternalStore, FrontierSelector } from './types.js';
+export declare function useFrontierSnapshot<TSnapshot>(store: FrontierExternalStore<TSnapshot>): TSnapshot;
+export declare function useFrontierStore<TSnapshot>(store: FrontierExternalStore<TSnapshot>): TSnapshot;
+export declare function useFrontierStore<TSnapshot, TSelected>(store: FrontierExternalStore<TSnapshot>, selector: FrontierSelector<TSnapshot, TSelected>, equals?: FrontierEquality<TSelected>): TSelected;
+export declare function useFrontierSelector<TSnapshot, TSelected>(store: FrontierExternalStore<TSnapshot>, selector: FrontierSelector<TSnapshot, TSelected>, equals?: FrontierEquality<TSelected>): TSelected;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,KAAK,EAAE,qBAAqB,CAAC,SAAS,CAAC,GAAG,SAAS,CAEjG;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EACxC,KAAK,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACtC,SAAS,CAAC;AACb,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EACnD,KAAK,EAAE,qBAAqB,CAAC,SAAS,CAAC,EACvC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,EAChD,MAAM,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,SAAS,CAAC;AAiBb,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EACtD,KAAK,EAAE,qBAAqB,CAAC,SAAS,CAAC,EACvC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,EAChD,MAAM,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,SAAS,CAEX"}

package/dist/hooks.js

@@ -0,0 +1,26 @@
+import { useMemo, useSyncExternalStore } from 'react';
+const identity = (value) => value;
+export function useFrontierSnapshot(store) {
+    return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);
+}
+export function useFrontierStore(store, selector = identity, equals = Object.is) {
+    const getSelectedSnapshot = useMemo(() => createSelectedSnapshotReader(store.getSnapshot, selector, equals), [store, selector, equals]);
+    const getSelectedServerSnapshot = useMemo(() => createSelectedSnapshotReader(store.getServerSnapshot, selector, equals), [store, selector, equals]);
+    return useSyncExternalStore(store.subscribe, getSelectedSnapshot, getSelectedServerSnapshot);
+}
+export function useFrontierSelector(store, selector, equals) {
+    return useFrontierStore(store, selector, equals);
+}
+function createSelectedSnapshotReader(readSnapshot, selector, equals) {
+    let hasSelection = false;
+    let previousSelection;
+    return () => {
+        const nextSelection = selector(readSnapshot());
+        if (hasSelection && equals(previousSelection, nextSelection))
+            return previousSelection;
+        hasSelection = true;
+        previousSelection = nextSelection;
+        return nextSelection;
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAOtD,MAAM,QAAQ,GAAG,CAAI,KAAQ,EAAK,EAAE,CAAC,KAAK,CAAC;AAE3C,MAAM,UAAU,mBAAmB,CAAY,KAAuC;IACpF,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAC3F,CAAC;AAUD,MAAM,UAAU,gBAAgB,CAC9B,KAAuC,EACvC,WAAmD,QAAkD,EACrG,SAAsC,MAAM,CAAC,EAAE;IAE/C,MAAM,mBAAmB,GAAG,OAAO,CACjC,GAAG,EAAE,CAAC,4BAA4B,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,EACvE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAC1B,CAAC;IACF,MAAM,yBAAyB,GAAG,OAAO,CACvC,GAAG,EAAE,CAAC,4BAA4B,CAAC,KAAK,CAAC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,CAAC,EAC7E,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAC1B,CAAC;IACF,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAuC,EACvC,QAAgD,EAChD,MAAoC;IAEpC,OAAO,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,4BAA4B,CACnC,YAA6B,EAC7B,QAAgD,EAChD,MAAmC;IAEnC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,iBAA4B,CAAC;IACjC,OAAO,GAAG,EAAE;QACV,MAAM,aAAa,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/C,IAAI,YAAY,IAAI,MAAM,CAAC,iBAAkB,EAAE,aAAa,CAAC;YAAE,OAAO,iBAAkB,CAAC;QACzF,YAAY,GAAG,IAAI,CAAC;QACpB,iBAAiB,GAAG,aAAa,CAAC;QAClC,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { useFrontierSelector, useFrontierSnapshot, useFrontierStore } from './hooks.js';
+export { createFrontierPatchStore, createFrontierStoreAdapter, normalizeUnsubscribe } from './store.js';
+export { createFrontierCrdtStore, createFrontierEntityStore, createFrontierQueryStore, createFrontierStateStore } from './adapters.js';
+export type { FrontierCrdtDocumentLike, FrontierEntityCacheLike, FrontierEquality, FrontierExternalStore, FrontierJsonSnapshotUpdater, FrontierPatchStore, FrontierPatchStoreOptions, FrontierQueryCacheLike, FrontierSelector, FrontierSnapshotUpdater, FrontierStateEngineLike, FrontierStateStoreOptions, FrontierStoreAdapterSource, FrontierStoreListener, FrontierStoreUnsubscribe, FrontierSubscriptionHandle, FrontierWatchPath } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { useFrontierSelector, useFrontierSnapshot, useFrontierStore } from './hooks.js';
+export { createFrontierPatchStore, createFrontierStoreAdapter, normalizeUnsubscribe } from './store.js';
+export { createFrontierCrdtStore, createFrontierEntityStore, createFrontierQueryStore, createFrontierStateStore } from './adapters.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,eAAe,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,6 @@
+import type { JsonValue } from '@shapeshift-labs/frontier';
+import type { FrontierExternalStore, FrontierPatchStore, FrontierPatchStoreOptions, FrontierStoreAdapterSource, FrontierStoreUnsubscribe } from './types.js';
+export declare function createFrontierPatchStore<TSnapshot extends JsonValue>(initial: TSnapshot, options?: FrontierPatchStoreOptions<TSnapshot>): FrontierPatchStore<TSnapshot>;
+export declare function createFrontierStoreAdapter<TSnapshot>(source: FrontierStoreAdapterSource<TSnapshot>): FrontierExternalStore<TSnapshot>;
+export declare function normalizeUnsubscribe(value: unknown): FrontierStoreUnsubscribe;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAS,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAE1B,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,SAAS,EAClE,OAAO,EAAE,SAAS,EAClB,OAAO,GAAE,yBAAyB,CAAC,SAAS,CAAM,GACjD,kBAAkB,CAAC,SAAS,CAAC,CAqD/B;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAClD,MAAM,EAAE,0BAA0B,CAAC,SAAS,CAAC,GAC5C,qBAAqB,CAAC,SAAS,CAAC,CAWlC;AAUD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAQ7E"}

package/dist/store.js

@@ -0,0 +1,96 @@
+import { applyPatchImmutable, cloneJson, diff, equalsJsonFast } from '@shapeshift-labs/frontier';
+export function createFrontierPatchStore(initial, options = {}) {
+    const clone = options.clone ?? ((value) => cloneJson(value));
+    const equals = options.equals ?? ((left, right) => equalsJsonFast(left, right));
+    const recordPatches = options.recordPatches !== false;
+    const listeners = new Set();
+    const patchLog = [];
+    let snapshot = clone(initial);
+    function emit() {
+        const current = Array.from(listeners);
+        for (let i = 0; i < current.length; i++)
+            current[i]();
+    }
+    function commit(nextInput) {
+        const next = clone(nextInput);
+        if (equals(snapshot, next))
+            return [];
+        const patch = diff(snapshot, next);
+        snapshot = next;
+        if (recordPatches && patch.length > 0)
+            patchLog[patchLog.length] = patch;
+        emit();
+        return patch;
+    }
+    return {
+        getSnapshot: () => snapshot,
+        getServerSnapshot: () => snapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        setSnapshot(next) {
+            return commit(typeof next === 'function' ? next(snapshot) : next);
+        },
+        replace(next) {
+            return commit(next);
+        },
+        update(updater) {
+            return commit(updater(snapshot));
+        },
+        applyPatch(patch) {
+            if (patch.length === 0)
+                return snapshot;
+            snapshot = applyPatchImmutable(snapshot, patch);
+            if (recordPatches)
+                patchLog[patchLog.length] = patch;
+            emit();
+            return snapshot;
+        },
+        getPatchLog: () => patchLog,
+        clearPatchLog() {
+            patchLog.length = 0;
+        }
+    };
+}
+export function createFrontierStoreAdapter(source) {
+    const getSnapshot = resolveSnapshotReader(source);
+    return {
+        getSnapshot,
+        getServerSnapshot: source.getServerSnapshot ?? getSnapshot,
+        subscribe(listener) {
+            if (typeof source.subscribe === 'function')
+                return normalizeUnsubscribe(source.subscribe(listener));
+            if (typeof source.watch === 'function')
+                return normalizeUnsubscribe(source.watch('', listener));
+            return noop;
+        }
+    };
+}
+function resolveSnapshotReader(source) {
+    if (typeof source.getSnapshot === 'function')
+        return () => source.getSnapshot();
+    if (typeof source.get === 'function')
+        return () => source.get();
+    if (typeof source.value === 'function')
+        return () => source.value();
+    if (typeof source.toJSON === 'function')
+        return () => source.toJSON();
+    throw new TypeError('Frontier React store adapter source needs getSnapshot(), get(), value(), or toJSON()');
+}
+export function normalizeUnsubscribe(value) {
+    if (typeof value === 'function')
+        return value;
+    if (value !== null && typeof value === 'object') {
+        const subscription = value;
+        if (typeof subscription.unsubscribe === 'function')
+            return () => subscription.unsubscribe();
+        if (typeof subscription.dispose === 'function')
+            return () => subscription.dispose();
+    }
+    return noop;
+}
+function noop() { }
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import type { JsonValue, Patch } from '@shapeshift-labs/frontier';
+export type FrontierStoreListener = () => void;
+export type FrontierStoreUnsubscribe = () => void;
+export type FrontierEquality<T> = (previous: T, next: T) => boolean;
+export type FrontierSelector<TSnapshot, TSelected> = (snapshot: TSnapshot) => TSelected;
+export type FrontierSnapshotUpdater<T> = T | ((previous: T) => T);
+export type FrontierJsonSnapshotUpdater<T extends JsonValue> = T | ((previous: T) => T);
+export type FrontierWatchPath = string | readonly (string | number)[];
+export interface FrontierExternalStore<TSnapshot> {
+    getSnapshot(): TSnapshot;
+    getServerSnapshot(): TSnapshot;
+    subscribe(listener: FrontierStoreListener): FrontierStoreUnsubscribe;
+}
+export interface FrontierPatchStore<TSnapshot extends JsonValue> extends FrontierExternalStore<TSnapshot> {
+    setSnapshot(next: FrontierJsonSnapshotUpdater<TSnapshot>): Patch;
+    replace(next: TSnapshot): Patch;
+    update(updater: (previous: TSnapshot) => TSnapshot): Patch;
+    applyPatch(patch: Patch): TSnapshot;
+    getPatchLog(): readonly Patch[];
+    clearPatchLog(): void;
+}
+export interface FrontierPatchStoreOptions<TSnapshot extends JsonValue> {
+    clone?: (value: TSnapshot) => TSnapshot;
+    equals?: FrontierEquality<TSnapshot>;
+    recordPatches?: boolean;
+}
+export interface FrontierStoreAdapterSource<TSnapshot> {
+    getSnapshot?: () => TSnapshot;
+    getServerSnapshot?: () => TSnapshot;
+    get?: () => TSnapshot;
+    value?: () => TSnapshot;
+    toJSON?: () => TSnapshot;
+    subscribe?: (listener: FrontierStoreListener) => FrontierStoreUnsubscribe | FrontierSubscriptionHandle | void;
+    watch?: (path: FrontierWatchPath, listener: (...args: unknown[]) => void) => FrontierSubscriptionHandle | FrontierStoreUnsubscribe | void;
+}
+export interface FrontierSubscriptionHandle {
+    unsubscribe?: () => void;
+    dispose?: () => void;
+}
+export interface FrontierStateEngineLike<TSnapshot> {
+    get(): TSnapshot;
+    watch(path: FrontierWatchPath, listener: (...args: unknown[]) => void): FrontierSubscriptionHandle | FrontierStoreUnsubscribe | void;
+}
+export interface FrontierStateStoreOptions {
+    path?: FrontierWatchPath;
+}
+export interface FrontierQueryCacheLike<TSnapshot, TQueryKey = unknown> {
+    getQueryData(key: TQueryKey): TSnapshot | undefined;
+    watchQuery(key: TQueryKey, listener: (...args: unknown[]) => void): FrontierSubscriptionHandle | FrontierStoreUnsubscribe | void;
+}
+export interface FrontierEntityCacheLike<TSnapshot, TEntity = unknown> {
+    getEntity(entity: TEntity): TSnapshot | undefined;
+    watchEntity(entity: TEntity, listener: (...args: unknown[]) => void): FrontierSubscriptionHandle | FrontierStoreUnsubscribe | void;
+}
+export interface FrontierCrdtDocumentLike<TSnapshot> {
+    get?: () => TSnapshot;
+    toJSON?: () => TSnapshot;
+    watch?: (path: FrontierWatchPath, listener: (...args: unknown[]) => void) => FrontierSubscriptionHandle | FrontierStoreUnsubscribe | void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@shapeshift-labs/frontier-react",
+  "version": "0.1.0",
+  "description": "React external-store hooks and adapters for Frontier state, cache, and CRDT surfaces.",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/siliconjungle/-shapeshift-labs-frontier-react.git"
+  },
+  "homepage": "https://github.com/siliconjungle/-shapeshift-labs-frontier-react#readme",
+  "bugs": {
+    "url": "https://github.com/siliconjungle/-shapeshift-labs-frontier-react/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./store": {
+      "types": "./dist/store.d.ts",
+      "import": "./dist/store.js",
+      "default": "./dist/store.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks.d.ts",
+      "import": "./dist/hooks.js",
+      "default": "./dist/hooks.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters.d.ts",
+      "import": "./dist/adapters.js",
+      "default": "./dist/adapters.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "store": [
+        "./dist/store.d.ts"
+      ],
+      "hooks": [
+        "./dist/hooks.d.ts"
+      ],
+      "adapters": [
+        "./dist/adapters.d.ts"
+      ],
+      "*": [
+        "./dist/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "benchmarks/package-bench.mjs"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@shapeshift-labs/frontier": "^0.1.5"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1",
+    "react-test-renderer": "^18.3.1",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "npm run build && npm run typecheck && node test/smoke.mjs && node test/fuzz.mjs --cases 500",
+    "prepack": "npm run test",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/tsconfig.json --noEmit",
+    "fuzz": "npm run build && node test/fuzz.mjs",
+    "bench": "npm run build && node benchmarks/package-bench.mjs",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "keywords": [
+    "frontier",
+    "react",
+    "useSyncExternalStore",
+    "external-store",
+    "crdt",
+    "state"
+  ],
+  "author": "james addison"
+}