@graphrefly/ts 0.0.0 → 0.0.1

package/dist/adapters/observe-storage.d.cts

@@ -1,12 +1,12 @@
-import { O as ObserveEvent, d as Graph } from '../graph-s23RbbFO.cjs';
+import { O as ObserveEvent, d as Graph } from '../graph-DCEWh4T2.cjs';
 import { d as AppendLogStorageTier } from '../append-log-DisvEReb.cjs';
 import { O as ObserveEventFrame } from '../observe-event-log-0SVsx7JG.cjs';
 export { c as ObserveEventLogPage } from '../observe-event-log-0SVsx7JG.cjs';
 import '../core/index.cjs';
-import '../types-bNMSWKqF.cjs';
-import '../messages-BZqrGGm1.cjs';
+import '../types-CcPIn7sy.cjs';
+import '../messages-CAzUPPJM.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-Ciu8SUnN.cjs';
+import '../describe-DYMw_l1C.cjs';
 
 /**
  * Graph-bound observe storage adapters.

package/dist/adapters/observe-storage.d.ts

@@ -1,12 +1,12 @@
-import { O as ObserveEvent, d as Graph } from '../graph-DfdF9zy4.js';
+import { O as ObserveEvent, d as Graph } from '../graph-D-1-SQeC.js';
 import { d as AppendLogStorageTier } from '../append-log-DzKMmjxx.js';
 import { O as ObserveEventFrame } from '../observe-event-log-Dnm76owp.js';
 export { c as ObserveEventLogPage } from '../observe-event-log-Dnm76owp.js';
 import '../core/index.js';
-import '../types-h12mNYbq.js';
-import '../messages-BZqrGGm1.js';
+import '../types-BsJvElYZ.js';
+import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-BZb7AS2y.js';
+import '../describe-BpyJuWkw.js';
 
 /**
  * Graph-bound observe storage adapters.

package/dist/adapters/observe-storage.js

@@ -4,6 +4,7 @@ import {
 import "../chunk-6PHB5CJS.js";
 import "../chunk-DKP56CSW.js";
 import "../chunk-4VLAQHZI.js";
+import "../chunk-DGUM43GV.js";
 
 // src/adapters/observe-storage.ts
 function attachObserveSink(graph, sink, opts = {}) {

package/dist/adapters/observe-storage.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/observe-storage.ts"],"sourcesContent":["/**\n * Graph-bound observe storage adapters.\n *\n * Passive storage lives under ../storage. This subpath owns bridges that need\n * Graph.observe() and therefore sit above both graph and passive storage (D125).\n */\n\nimport type { Graph } from \"../graph/graph.js\";\nimport type { ObserveEvent } from \"../graph/inspect.js\";\nimport type { AppendLogStorageTier } from \"../storage/append-log.js\";\nimport {\n\ttype ObserveEventFrame,\n\ttype ObserveEventLogPage,\n\tobserveEventFrame,\n} from \"../storage/observe-event-log.js\";\n\n/** Adapter-owned sink for observed graph events (D57/D74/D125). */\nexport interface ObserveSink<T = ObserveEvent> {\n\t/** Persist or forward one mapped observe event. Thenables are serialized in observe order. */\n\twrite(event: T): void | PromiseLike<void>;\n\t/** Optional adapter flush barrier. Runs after all earlier writes. */\n\tflush?(): void | PromiseLike<void>;\n\t/** Optional adapter rollback hook. Runs after all earlier writes. */\n\trollback?(): void | PromiseLike<void>;\n\t/** Optional adapter cleanup hook. Runs once after queued work drains. */\n\tdispose?(): void | PromiseLike<void>;\n}\n\n/** Error routing context for attachObserveSink lifecycle hooks. */\nexport interface ObserveSinkErrorContext<T = ObserveEvent> {\n\tphase: \"map\" | \"write\" | \"flush\" | \"rollback\" | \"dispose\";\n\tevent?: ObserveEvent;\n\tvalue?: T;\n}\n\n/** Queue-drain completion callback for observe-sink control calls (D75). */\nexport type ObserveSinkDone = () => void;\n\n/** Options for attaching a sink to the read-only observe egress (D74/D125). */\nexport interface AttachObserveSinkOptions<T = ObserveEvent> {\n\t/** Optional exact-id or subtree path filter; forwarded to `graph.observe(path?)`. */\n\tpath?: string;\n\t/** Optional projection/filter. Return `undefined` to drop an observed event. */\n\tmap?: (event: ObserveEvent) => T | undefined;\n\t/** Optional error hook for mapper, write, and lifecycle failures. */\n\tonError?: (error: unknown, ctx: ObserveSinkErrorContext<T>) => void;\n}\n\n/** Done-only callback control handle for an attached observe sink (D75). */\nexport interface ObserveSinkHandle {\n\tflush(done?: ObserveSinkDone): void;\n\trollback(done?: ObserveSinkDone): void;\n\tdispose(done?: ObserveSinkDone): void;\n}\n\ntype QueueItem<T> =\n\t| { kind: \"write\"; event: ObserveEvent; value: T }\n\t| { kind: \"flush\"; done?: ObserveSinkDone }\n\t| { kind: \"rollback\"; done?: ObserveSinkDone }\n\t| { kind: \"dispose\" };\n\n/** Options for persisting Graph.observe() events into an append log. */\nexport interface AttachObserveEventLogOptions<T = ObserveEvent> {\n\tpath?: string;\n\tstream?: string;\n\tmap?: (event: ObserveEvent) => T | undefined;\n\tonError?: (error: unknown, ctx: ObserveSinkErrorContext<ObserveEventFrame<T>>) => void;\n}\n\n/** Done-callback lifecycle handle for an attached observe-event log. */\nexport interface ObserveEventLogHandle extends ObserveSinkHandle {\n\tflush(done?: ObserveSinkDone): void;\n\trollback(done?: ObserveSinkDone): void;\n\tdispose(done?: ObserveSinkDone): void;\n}\n\nexport type { ObserveEventFrame, ObserveEventLogPage };\n\n/**\n * Attach adapter-owned storage to `Graph.observe()` read-only egress (D57/D74/D125). Writes are\n * serialized in observe order; lifecycle barriers drain the queue without mutating graph topology.\n */\nexport function attachObserveSink<T = ObserveEvent>(\n\tgraph: Graph,\n\tsink: ObserveSink<T>,\n\topts: AttachObserveSinkOptions<T> = {},\n): ObserveSinkHandle {\n\tconst { map, onError, path } = opts;\n\tconst queue: QueueItem<T>[] = [];\n\tconst disposeDone: ObserveSinkDone[] = [];\n\tlet draining = false;\n\tlet disposeRequested = false;\n\tlet disposed = false;\n\n\tfunction report(error: unknown, ctx: ObserveSinkErrorContext<T>): void {\n\t\tif (!onError) return;\n\t\ttry {\n\t\t\tonError(error, ctx);\n\t\t} catch {\n\t\t\t// Error routing is best-effort; never let adapter logging wedge the queue.\n\t\t}\n\t}\n\n\tfunction callDone(done?: ObserveSinkDone): void {\n\t\ttry {\n\t\t\tdone?.();\n\t\t} catch {\n\t\t\t// Completion callbacks are advisory only; never wedge the queue on observer code.\n\t\t}\n\t}\n\n\tfunction run(item: QueueItem<T>): void | PromiseLike<void> {\n\t\tswitch (item.kind) {\n\t\t\tcase \"write\":\n\t\t\t\treturn sink.write(item.value);\n\t\t\tcase \"flush\":\n\t\t\t\treturn sink.flush?.();\n\t\t\tcase \"rollback\":\n\t\t\t\treturn sink.rollback?.();\n\t\t\tcase \"dispose\":\n\t\t\t\treturn sink.dispose?.();\n\t\t}\n\t}\n\n\tfunction finish(item: QueueItem<T>): void {\n\t\tif (item.kind === \"dispose\") {\n\t\t\tdisposed = true;\n\t\t\tfor (const done of disposeDone.splice(0)) callDone(done);\n\t\t} else if (item.kind !== \"write\") {\n\t\t\tcallDone(item.done);\n\t\t}\n\t\tdraining = false;\n\t\tdrain();\n\t}\n\n\tfunction fail(item: QueueItem<T>, error: unknown): void {\n\t\tif (item.kind === \"write\")\n\t\t\treport(error, { phase: \"write\", event: item.event, value: item.value });\n\t\telse report(error, { phase: item.kind });\n\t\tfinish(item);\n\t}\n\n\tfunction chainThenable(item: QueueItem<T>, value: unknown): boolean {\n\t\tif ((typeof value !== \"object\" && typeof value !== \"function\") || value === null) return false;\n\n\t\tlet then: unknown;\n\t\ttry {\n\t\t\tthen = (value as { then?: unknown }).then;\n\t\t} catch (error) {\n\t\t\tfail(item, error);\n\t\t\treturn true;\n\t\t}\n\t\tif (typeof then !== \"function\") return false;\n\n\t\tlet settled = false;\n\t\tconst settle = (next: () => void) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tnext();\n\t\t};\n\t\ttry {\n\t\t\t(then as (onFulfilled: () => void, onRejected: (error: unknown) => void) => unknown).call(\n\t\t\t\tvalue,\n\t\t\t\t() => settle(() => finish(item)),\n\t\t\t\t(error) => settle(() => fail(item, error)),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tsettle(() => fail(item, error));\n\t\t}\n\t\treturn true;\n\t}\n\n\tfunction drain(): void {\n\t\tif (draining) return;\n\t\tconst item = queue.shift();\n\t\tif (!item) return;\n\t\tdraining = true;\n\t\tlet result: void | PromiseLike<void>;\n\t\ttry {\n\t\t\tresult = run(item);\n\t\t} catch (error) {\n\t\t\tfail(item, error);\n\t\t\treturn;\n\t\t}\n\t\tif (chainThenable(item, result)) return;\n\t\tfinish(item);\n\t}\n\n\tfunction enqueueBarrier(kind: \"flush\" | \"rollback\", done?: ObserveSinkDone): void {\n\t\tif (disposeRequested) {\n\t\t\tcallDone(done);\n\t\t\treturn;\n\t\t}\n\t\tqueue.push({ kind, done });\n\t\tdrain();\n\t}\n\n\tconst stop = graph.observe(path).subscribe((event) => {\n\t\tif (disposeRequested) return;\n\t\tlet value: T | undefined;\n\t\ttry {\n\t\t\tvalue = map ? map(event) : (event as unknown as T);\n\t\t} catch (error) {\n\t\t\treport(error, { phase: \"map\", event });\n\t\t\treturn;\n\t\t}\n\t\tif (value === undefined) return;\n\t\tqueue.push({ kind: \"write\", event, value });\n\t\tdrain();\n\t});\n\n\treturn {\n\t\tflush(done?: ObserveSinkDone): void {\n\t\t\tenqueueBarrier(\"flush\", done);\n\t\t},\n\t\trollback(done?: ObserveSinkDone): void {\n\t\t\tenqueueBarrier(\"rollback\", done);\n\t\t},\n\t\tdispose(done?: ObserveSinkDone): void {\n\t\t\tif (disposed) {\n\t\t\t\tcallDone(done);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (done) disposeDone.push(done);\n\t\t\tif (disposeRequested) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tdisposeRequested = true;\n\t\t\tstop();\n\t\t\tqueue.push({ kind: \"dispose\" });\n\t\t\tdrain();\n\t\t},\n\t};\n}\n\n/**\n * Persist Graph.observe() events to an append log. This is a graph-bound\n * adapter over passive storage frames, not graph restore or projection.\n */\nexport function attachObserveEventLog<T = ObserveEvent>(\n\tgraph: Graph,\n\tlog: AppendLogStorageTier<ObserveEventFrame<T>>,\n\topts: AttachObserveEventLogOptions<T> = {},\n): ObserveEventLogHandle {\n\treturn attachObserveSink<ObserveEventFrame<T>>(\n\t\tgraph,\n\t\t{ write: (frame) => log.append(frame).then(() => undefined) },\n\t\t{\n\t\t\tpath: opts.path,\n\t\t\tmap: (event) => {\n\t\t\t\tconst value = opts.map ? opts.map(event) : (event as unknown as T);\n\t\t\t\treturn value === undefined ? undefined : observeEventFrame(event, value, opts);\n\t\t\t},\n\t\t\tonError: opts.onError,\n\t\t},\n\t);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/adapters/observe-storage.ts"],"sourcesContent":["/**\n * Graph-bound observe storage adapters.\n *\n * Passive storage lives under ../storage. This subpath owns bridges that need\n * Graph.observe() and therefore sit above both graph and passive storage (D125).\n */\n\nimport type { Graph } from \"../graph/graph.js\";\nimport type { ObserveEvent } from \"../graph/inspect.js\";\nimport type { AppendLogStorageTier } from \"../storage/append-log.js\";\nimport {\n\ttype ObserveEventFrame,\n\ttype ObserveEventLogPage,\n\tobserveEventFrame,\n} from \"../storage/observe-event-log.js\";\n\n/** Adapter-owned sink for observed graph events (D57/D74/D125). */\nexport interface ObserveSink<T = ObserveEvent> {\n\t/** Persist or forward one mapped observe event. Thenables are serialized in observe order. */\n\twrite(event: T): void | PromiseLike<void>;\n\t/** Optional adapter flush barrier. Runs after all earlier writes. */\n\tflush?(): void | PromiseLike<void>;\n\t/** Optional adapter rollback hook. Runs after all earlier writes. */\n\trollback?(): void | PromiseLike<void>;\n\t/** Optional adapter cleanup hook. Runs once after queued work drains. */\n\tdispose?(): void | PromiseLike<void>;\n}\n\n/** Error routing context for attachObserveSink lifecycle hooks. */\nexport interface ObserveSinkErrorContext<T = ObserveEvent> {\n\tphase: \"map\" | \"write\" | \"flush\" | \"rollback\" | \"dispose\";\n\tevent?: ObserveEvent;\n\tvalue?: T;\n}\n\n/** Queue-drain completion callback for observe-sink control calls (D75). */\nexport type ObserveSinkDone = () => void;\n\n/** Options for attaching a sink to the read-only observe egress (D74/D125). */\nexport interface AttachObserveSinkOptions<T = ObserveEvent> {\n\t/** Optional exact-id or subtree path filter; forwarded to `graph.observe(path?)`. */\n\tpath?: string;\n\t/** Optional projection/filter. Return `undefined` to drop an observed event. */\n\tmap?: (event: ObserveEvent) => T | undefined;\n\t/** Optional error hook for mapper, write, and lifecycle failures. */\n\tonError?: (error: unknown, ctx: ObserveSinkErrorContext<T>) => void;\n}\n\n/** Done-only callback control handle for an attached observe sink (D75). */\nexport interface ObserveSinkHandle {\n\tflush(done?: ObserveSinkDone): void;\n\trollback(done?: ObserveSinkDone): void;\n\tdispose(done?: ObserveSinkDone): void;\n}\n\ntype QueueItem<T> =\n\t| { kind: \"write\"; event: ObserveEvent; value: T }\n\t| { kind: \"flush\"; done?: ObserveSinkDone }\n\t| { kind: \"rollback\"; done?: ObserveSinkDone }\n\t| { kind: \"dispose\" };\n\n/** Options for persisting Graph.observe() events into an append log. */\nexport interface AttachObserveEventLogOptions<T = ObserveEvent> {\n\tpath?: string;\n\tstream?: string;\n\tmap?: (event: ObserveEvent) => T | undefined;\n\tonError?: (error: unknown, ctx: ObserveSinkErrorContext<ObserveEventFrame<T>>) => void;\n}\n\n/** Done-callback lifecycle handle for an attached observe-event log. */\nexport interface ObserveEventLogHandle extends ObserveSinkHandle {\n\tflush(done?: ObserveSinkDone): void;\n\trollback(done?: ObserveSinkDone): void;\n\tdispose(done?: ObserveSinkDone): void;\n}\n\nexport type { ObserveEventFrame, ObserveEventLogPage };\n\n/**\n * Attach adapter-owned storage to `Graph.observe()` read-only egress (D57/D74/D125). Writes are\n * serialized in observe order; lifecycle barriers drain the queue without mutating graph topology.\n */\nexport function attachObserveSink<T = ObserveEvent>(\n\tgraph: Graph,\n\tsink: ObserveSink<T>,\n\topts: AttachObserveSinkOptions<T> = {},\n): ObserveSinkHandle {\n\tconst { map, onError, path } = opts;\n\tconst queue: QueueItem<T>[] = [];\n\tconst disposeDone: ObserveSinkDone[] = [];\n\tlet draining = false;\n\tlet disposeRequested = false;\n\tlet disposed = false;\n\n\tfunction report(error: unknown, ctx: ObserveSinkErrorContext<T>): void {\n\t\tif (!onError) return;\n\t\ttry {\n\t\t\tonError(error, ctx);\n\t\t} catch {\n\t\t\t// Error routing is best-effort; never let adapter logging wedge the queue.\n\t\t}\n\t}\n\n\tfunction callDone(done?: ObserveSinkDone): void {\n\t\ttry {\n\t\t\tdone?.();\n\t\t} catch {\n\t\t\t// Completion callbacks are advisory only; never wedge the queue on observer code.\n\t\t}\n\t}\n\n\tfunction run(item: QueueItem<T>): void | PromiseLike<void> {\n\t\tswitch (item.kind) {\n\t\t\tcase \"write\":\n\t\t\t\treturn sink.write(item.value);\n\t\t\tcase \"flush\":\n\t\t\t\treturn sink.flush?.();\n\t\t\tcase \"rollback\":\n\t\t\t\treturn sink.rollback?.();\n\t\t\tcase \"dispose\":\n\t\t\t\treturn sink.dispose?.();\n\t\t}\n\t}\n\n\tfunction finish(item: QueueItem<T>): void {\n\t\tif (item.kind === \"dispose\") {\n\t\t\tdisposed = true;\n\t\t\tfor (const done of disposeDone.splice(0)) callDone(done);\n\t\t} else if (item.kind !== \"write\") {\n\t\t\tcallDone(item.done);\n\t\t}\n\t\tdraining = false;\n\t\tdrain();\n\t}\n\n\tfunction fail(item: QueueItem<T>, error: unknown): void {\n\t\tif (item.kind === \"write\")\n\t\t\treport(error, { phase: \"write\", event: item.event, value: item.value });\n\t\telse report(error, { phase: item.kind });\n\t\tfinish(item);\n\t}\n\n\tfunction chainThenable(item: QueueItem<T>, value: unknown): boolean {\n\t\tif ((typeof value !== \"object\" && typeof value !== \"function\") || value === null) return false;\n\n\t\tlet then: unknown;\n\t\ttry {\n\t\t\tthen = (value as { then?: unknown }).then;\n\t\t} catch (error) {\n\t\t\tfail(item, error);\n\t\t\treturn true;\n\t\t}\n\t\tif (typeof then !== \"function\") return false;\n\n\t\tlet settled = false;\n\t\tconst settle = (next: () => void) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tnext();\n\t\t};\n\t\ttry {\n\t\t\t(then as (onFulfilled: () => void, onRejected: (error: unknown) => void) => unknown).call(\n\t\t\t\tvalue,\n\t\t\t\t() => settle(() => finish(item)),\n\t\t\t\t(error) => settle(() => fail(item, error)),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tsettle(() => fail(item, error));\n\t\t}\n\t\treturn true;\n\t}\n\n\tfunction drain(): void {\n\t\tif (draining) return;\n\t\tconst item = queue.shift();\n\t\tif (!item) return;\n\t\tdraining = true;\n\t\tlet result: void | PromiseLike<void>;\n\t\ttry {\n\t\t\tresult = run(item);\n\t\t} catch (error) {\n\t\t\tfail(item, error);\n\t\t\treturn;\n\t\t}\n\t\tif (chainThenable(item, result)) return;\n\t\tfinish(item);\n\t}\n\n\tfunction enqueueBarrier(kind: \"flush\" | \"rollback\", done?: ObserveSinkDone): void {\n\t\tif (disposeRequested) {\n\t\t\tcallDone(done);\n\t\t\treturn;\n\t\t}\n\t\tqueue.push({ kind, done });\n\t\tdrain();\n\t}\n\n\tconst stop = graph.observe(path).subscribe((event) => {\n\t\tif (disposeRequested) return;\n\t\tlet value: T | undefined;\n\t\ttry {\n\t\t\tvalue = map ? map(event) : (event as unknown as T);\n\t\t} catch (error) {\n\t\t\treport(error, { phase: \"map\", event });\n\t\t\treturn;\n\t\t}\n\t\tif (value === undefined) return;\n\t\tqueue.push({ kind: \"write\", event, value });\n\t\tdrain();\n\t});\n\n\treturn {\n\t\tflush(done?: ObserveSinkDone): void {\n\t\t\tenqueueBarrier(\"flush\", done);\n\t\t},\n\t\trollback(done?: ObserveSinkDone): void {\n\t\t\tenqueueBarrier(\"rollback\", done);\n\t\t},\n\t\tdispose(done?: ObserveSinkDone): void {\n\t\t\tif (disposed) {\n\t\t\t\tcallDone(done);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (done) disposeDone.push(done);\n\t\t\tif (disposeRequested) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tdisposeRequested = true;\n\t\t\tstop();\n\t\t\tqueue.push({ kind: \"dispose\" });\n\t\t\tdrain();\n\t\t},\n\t};\n}\n\n/**\n * Persist Graph.observe() events to an append log. This is a graph-bound\n * adapter over passive storage frames, not graph restore or projection.\n */\nexport function attachObserveEventLog<T = ObserveEvent>(\n\tgraph: Graph,\n\tlog: AppendLogStorageTier<ObserveEventFrame<T>>,\n\topts: AttachObserveEventLogOptions<T> = {},\n): ObserveEventLogHandle {\n\treturn attachObserveSink<ObserveEventFrame<T>>(\n\t\tgraph,\n\t\t{ write: (frame) => log.append(frame).then(() => undefined) },\n\t\t{\n\t\t\tpath: opts.path,\n\t\t\tmap: (event) => {\n\t\t\t\tconst value = opts.map ? opts.map(event) : (event as unknown as T);\n\t\t\t\treturn value === undefined ? undefined : observeEventFrame(event, value, opts);\n\t\t\t},\n\t\t\tonError: opts.onError,\n\t\t},\n\t);\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/react.cjs

@@ -0,0 +1,166 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/react.ts
+var react_exports = {};
+__export(react_exports, {
+  useNodeInput: () => useNodeInput,
+  useNodeRecord: () => useNodeRecord,
+  useNodeValue: () => useNodeValue
+});
+module.exports = __toCommonJS(react_exports);
+var import_react = require("react");
+
+// src/adapters/store.ts
+function nodeSnapshot(node) {
+  return node.cache;
+}
+function subscribeNodeValues(node, run, opts = {}) {
+  const read = opts.getSnapshot ?? (() => nodeSnapshot(node));
+  if (opts.immediate) run(read());
+  let subscribing = true;
+  const skipSynchronousHandshakeData = opts.changesOnly || opts.immediate;
+  const sink = (msg, delivery) => {
+    switch (msg[0]) {
+      case "DATA":
+        if (skipSynchronousHandshakeData && subscribing && delivery === void 0) {
+          return;
+        }
+        run(msg[1]);
+        return;
+      case "ERROR":
+        opts.onError?.(msg[1]);
+        return;
+      case "COMPLETE":
+        opts.onComplete?.();
+        return;
+    }
+  };
+  const unsubscribe = node.subscribe(sink);
+  subscribing = false;
+  return unsubscribe;
+}
+function externalStore(node, opts = {}) {
+  const read = opts.getSnapshot ?? (() => nodeSnapshot(node));
+  return {
+    getSnapshot: read,
+    getServerSnapshot: read,
+    subscribe: (onStoreChange) => subscribeNodeValues(node, () => onStoreChange(), {
+      changesOnly: true,
+      onError: opts.onError,
+      onComplete: opts.onComplete
+    })
+  };
+}
+function recordReadableStore(keysNode, factory, opts = {}) {
+  const read = () => {
+    const keys = keysNode.cache ?? [];
+    const out = {};
+    for (const key of keys) {
+      const nodes = factory(key);
+      const values = {};
+      for (const field of Object.keys(nodes)) {
+        values[field] = nodes[field].cache;
+      }
+      out[key] = values;
+    }
+    return out;
+  };
+  return {
+    get: read,
+    subscribe(run) {
+      const entryUnsubs = [];
+      const cleanupEntries = () => {
+        for (const unsub of entryUnsubs.splice(0)) unsub();
+      };
+      const sync = () => {
+        cleanupEntries();
+        for (const key of keysNode.cache ?? []) {
+          const nodes = factory(key);
+          for (const field of Object.keys(nodes)) {
+            entryUnsubs.push(
+              subscribeNodeValues(nodes[field], () => run(read()), {
+                changesOnly: true,
+                onError: opts.onError,
+                onComplete: opts.onComplete
+              })
+            );
+          }
+        }
+        run(read());
+      };
+      const keysUnsub = subscribeNodeValues(keysNode, sync, {
+        changesOnly: true,
+        onError: opts.onError,
+        onComplete: opts.onComplete
+      });
+      sync();
+      return () => {
+        keysUnsub();
+        cleanupEntries();
+      };
+    }
+  };
+}
+
+// src/adapters/react.ts
+function assertDataValue(value) {
+  if (value === void 0) {
+    throw new TypeError("useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value");
+  }
+}
+function useNodeValue(node) {
+  const store = (0, import_react.useMemo)(() => externalStore(node), [node]);
+  return (0, import_react.useSyncExternalStore)(store.subscribe, store.getSnapshot, store.getServerSnapshot);
+}
+function useNodeInput(node) {
+  const value = useNodeValue(node);
+  const setValue = (0, import_react.useCallback)(
+    (next) => {
+      assertDataValue(next);
+      node.set(next);
+    },
+    [node]
+  );
+  return [value, setValue];
+}
+function useNodeRecord(keysNode, factory) {
+  const store = (0, import_react.useMemo)(() => {
+    const recordStore = recordReadableStore(keysNode, factory);
+    let current = recordStore.get() ?? {};
+    return {
+      getSnapshot: () => current,
+      subscribe(onStoreChange) {
+        return recordStore.subscribe((next) => {
+          current = next ?? {};
+          onStoreChange();
+        });
+      }
+    };
+  }, [keysNode, factory]);
+  const getSnapshot = (0, import_react.useCallback)(() => store.getSnapshot(), [store]);
+  return (0, import_react.useSyncExternalStore)(store.subscribe, getSnapshot, getSnapshot);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useNodeInput,
+  useNodeRecord,
+  useNodeValue
+});
+//# sourceMappingURL=react.cjs.map

package/dist/adapters/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/react.ts","../../src/adapters/store.ts"],"sourcesContent":["/**\n * React node bindings for GraphReFly (D238).\n *\n * React is imported only from this focused subpath. The dependency-free\n * `@graphrefly/ts/adapters` barrel keeps the framework-neutral store contract.\n */\n\nimport { useCallback, useMemo, useSyncExternalStore } from \"react\";\nimport type { Node } from \"../node/node.js\";\nimport { externalStore, recordReadableStore, type WritableNode } from \"./store.js\";\n\nfunction assertDataValue(value: unknown): void {\n\tif (value === undefined) {\n\t\tthrow new TypeError(\"useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value\");\n\t}\n}\n\n/** Read a GraphReFly node through React's useSyncExternalStore contract. */\nexport function useNodeValue<T>(node: Node<T>): T | undefined {\n\tconst store = useMemo(() => externalStore(node), [node]);\n\treturn useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);\n}\n\n/**\n * Bind a writable GraphReFly node as `[value, setValue]`.\n *\n * The setter identity is stable for a stable node identity, and writes through\n * the node's reactive DATA boundary rather than a presentation-owned trigger.\n */\nexport function useNodeInput<T>(\n\tnode: WritableNode<T>,\n): readonly [T | undefined, (value: T) => void] {\n\tconst value = useNodeValue(node);\n\tconst setValue = useCallback(\n\t\t(next: T) => {\n\t\t\tassertDataValue(next);\n\t\t\tnode.set(next);\n\t\t},\n\t\t[node],\n\t);\n\treturn [value, setValue] as const;\n}\n\n/**\n * Read a keyed record of nodes.\n *\n * `factory` must have stable identity. Recreating it on every render forces the\n * record subscription graph to rebuild on every render.\n */\nexport function useNodeRecord<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: (key: K) => { [P in keyof R]: Node<R[P]> },\n): Record<K, R> {\n\tconst store = useMemo(() => {\n\t\tconst recordStore = recordReadableStore(keysNode, factory);\n\t\tlet current = recordStore.get() ?? ({} as Record<K, R>);\n\t\treturn {\n\t\t\tgetSnapshot: () => current,\n\t\t\tsubscribe(onStoreChange: () => void) {\n\t\t\t\treturn recordStore.subscribe((next) => {\n\t\t\t\t\tcurrent = next ?? ({} as Record<K, R>);\n\t\t\t\t\tonStoreChange();\n\t\t\t\t});\n\t\t\t},\n\t\t};\n\t}, [keysNode, factory]);\n\tconst getSnapshot = useCallback(() => store.getSnapshot(), [store]);\n\treturn useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);\n}\n","/**\n * Framework-neutral store adapters.\n *\n * Focused framework bindings build on this tiny Node-facing layer without\n * importing framework packages into the dependency-free adapters barrel\n * (D125/D238).\n */\n\nimport type { DeliveryMeta, Sink } from \"../ctx/types.js\";\nimport type { Node } from \"../node/node.js\";\n\n/** A minimal readable store contract shared by Svelte/Nanostores-style adapters. */\nexport interface ReadableStore<T> {\n\tget(): T | undefined;\n\tsubscribe(run: (value: T | undefined) => void): () => void;\n}\n\n/** A minimal writable store contract over a clean-slate writable node. */\nexport interface WritableStore<T> extends ReadableStore<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** React `useSyncExternalStore`-compatible shape, without importing React. */\nexport interface ExternalStore<T> {\n\tgetSnapshot(): T | undefined;\n\tgetServerSnapshot(): T | undefined;\n\tsubscribe(onStoreChange: () => void): () => void;\n}\n\n/** Object-of-nodes factory used by record subscription adapters. */\nexport type NodeRecordFactory<K extends string, R extends Record<string, unknown>> = (key: K) => {\n\t[P in keyof R]: Node<R[P]>;\n};\n\n/** Zustand-compatible store API over a caller-owned clean-slate state node. */\nexport interface ZustandStoreApi<T extends object> {\n\tgetState(): T;\n\tsetState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean): void;\n\tgetInitialState(): T;\n\tsubscribe(listener: (state: T, prevState: T) => void): () => void;\n\tdestroy(): void;\n}\n\n/** Jotai-style atom facade over a caller-owned node. */\nexport interface JotaiAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Jotai-style atom facade over a caller-owned writable node. */\nexport interface WritableJotaiAtom<T> extends JotaiAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** Nanostores-style atom facade over a caller-owned node. */\nexport interface NanoAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\tlisten(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Nanostores-style atom facade over a caller-owned writable node. */\nexport interface WritableNanoAtom<T> extends NanoAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** TC39-Signals-style facade over a caller-owned node. */\nexport interface SignalLike<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable TC39-Signals-style facade over a caller-owned writable node. */\nexport interface WritableSignalLike<T> extends SignalLike<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\nexport interface SubscribeValuesOptions<T> {\n\t/** Emit the current cache snapshot immediately. `undefined` means SENTINEL/no DATA. */\n\timmediate?: boolean;\n\t/** Suppress synchronous push-on-subscribe/replay DATA. Useful for change-only store listeners. */\n\tchangesOnly?: boolean;\n\tonError?: (error: unknown) => void;\n\tonComplete?: () => void;\n\t/** Custom cache reader for wrappers that keep their own snapshot object. */\n\tgetSnapshot?: () => T | undefined;\n}\n\nexport interface WritableNode<T> extends Node<T> {\n\tset(value: T): void;\n}\n\nexport interface WritableStoreOptions<T> extends SubscribeValuesOptions<T> {\n\t/** Override writes for adapters that need a framework-owned reducer. */\n\twrite?: (node: WritableNode<T>, value: T) => void;\n}\n\n/** Read a node cache without activating it. */\nexport function nodeSnapshot<T>(node: Node<T>): T | undefined {\n\treturn node.cache as T | undefined;\n}\n\n/**\n * Subscribe to DATA values from a Node. Protocol internals stay below the adapter boundary:\n * DATA drives value listeners, ERROR/COMPLETE route to optional lifecycle callbacks.\n */\nexport function subscribeNodeValues<T>(\n\tnode: Node<T>,\n\trun: (value: T | undefined) => void,\n\topts: SubscribeValuesOptions<T> = {},\n): () => void {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tif (opts.immediate) run(read());\n\n\tlet subscribing = true;\n\tconst skipSynchronousHandshakeData = opts.changesOnly || opts.immediate;\n\tconst sink: Sink = (msg, delivery?: DeliveryMeta) => {\n\t\tswitch (msg[0]) {\n\t\t\tcase \"DATA\":\n\t\t\t\tif (skipSynchronousHandshakeData && subscribing && delivery === undefined) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\trun(msg[1] as T);\n\t\t\t\treturn;\n\t\t\tcase \"ERROR\":\n\t\t\t\topts.onError?.(msg[1]);\n\t\t\t\treturn;\n\t\t\tcase \"COMPLETE\":\n\t\t\t\topts.onComplete?.();\n\t\t\t\treturn;\n\t\t}\n\t};\n\tconst unsubscribe = node.subscribe(sink);\n\tsubscribing = false;\n\treturn unsubscribe;\n}\n\n/** Build a Svelte/Nanostores-style readable store from a clean-slate Node. */\nexport function readableStore<T>(\n\tnode: Node<T>,\n\topts: SubscribeValuesOptions<T> = {},\n): ReadableStore<T> {\n\treturn {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t};\n}\n\nfunction hasWritableSet<T>(node: Node<T>): node is WritableNode<T> {\n\treturn typeof (node as { set?: unknown }).set === \"function\";\n}\n\nfunction defaultWrite<T>(node: WritableNode<T>, value: T): void {\n\tnode.set(value);\n}\n\n/** Build a writable store over a StateNode or compatible clean-slate writable Node. */\nexport function writableStore<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> = {},\n): WritableStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"writableStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\treturn {\n\t\tget: read,\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t\tset: (value) => write(writable, value),\n\t\tupdate: (fn) => write(writable, fn(read())),\n\t};\n}\n\n/** Build the tiny shape React's `useSyncExternalStore` expects, without importing React. */\nexport function externalStore<T>(\n\tnode: Node<T>,\n\topts: Pick<SubscribeValuesOptions<T>, \"getSnapshot\" | \"onError\" | \"onComplete\"> = {},\n): ExternalStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\treturn {\n\t\tgetSnapshot: read,\n\t\tgetServerSnapshot: read,\n\t\tsubscribe: (onStoreChange) =>\n\t\t\tsubscribeNodeValues(node, () => onStoreChange(), {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t}),\n\t};\n}\n\n/** Build a framework-neutral keyed record store for focused framework record bindings. */\nexport function recordReadableStore<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: NodeRecordFactory<K, R>,\n\topts: SubscribeValuesOptions<Record<K, R>> = {},\n): ReadableStore<Record<K, R>> {\n\tconst read = () => {\n\t\tconst keys = keysNode.cache ?? [];\n\t\tconst out = {} as Record<K, R>;\n\t\tfor (const key of keys) {\n\t\t\tconst nodes = factory(key);\n\t\t\tconst values = {} as R;\n\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\tvalues[field] = nodes[field].cache as R[keyof R];\n\t\t\t}\n\t\t\tout[key] = values;\n\t\t}\n\t\treturn out;\n\t};\n\n\treturn {\n\t\tget: read,\n\t\tsubscribe(run) {\n\t\t\tconst entryUnsubs: Array<() => void> = [];\n\t\t\tconst cleanupEntries = () => {\n\t\t\t\tfor (const unsub of entryUnsubs.splice(0)) unsub();\n\t\t\t};\n\t\t\tconst sync = () => {\n\t\t\t\tcleanupEntries();\n\t\t\t\tfor (const key of keysNode.cache ?? []) {\n\t\t\t\t\tconst nodes = factory(key);\n\t\t\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\t\t\tentryUnsubs.push(\n\t\t\t\t\t\t\tsubscribeNodeValues(nodes[field], () => run(read()), {\n\t\t\t\t\t\t\t\tchangesOnly: true,\n\t\t\t\t\t\t\t\tonError: opts.onError,\n\t\t\t\t\t\t\t\tonComplete: opts.onComplete,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\trun(read());\n\t\t\t};\n\t\t\tconst keysUnsub = subscribeNodeValues(keysNode, sync, {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t});\n\t\t\tsync();\n\t\t\treturn () => {\n\t\t\t\tkeysUnsub();\n\t\t\t\tcleanupEntries();\n\t\t\t};\n\t\t},\n\t};\n}\n\n/** Build a Zustand-compatible StoreApi over a caller-owned clean-slate state node. */\nexport function zustandStore<T extends object>(\n\tnode: WritableNode<T>,\n\tinitialState?: T,\n\topts?: WritableStoreOptions<T>,\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T | undefined,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T = nodeSnapshot(node) as T,\n\topts: WritableStoreOptions<T> = {},\n): ZustandStoreApi<T> {\n\tconst listeners = new Set<() => void>();\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"zustandStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\tconst api: ZustandStoreApi<T> = {\n\t\tgetState: () => read() as T,\n\t\tsetState(partial, replace) {\n\t\t\tconst prev = api.getState();\n\t\t\tconst next = typeof partial === \"function\" ? partial(prev) : partial;\n\t\t\twrite(writable, replace ? (next as T) : ({ ...prev, ...next } as T));\n\t\t},\n\t\tgetInitialState: () => initialState,\n\t\tsubscribe(listener) {\n\t\t\tlet prev = api.getState();\n\t\t\tconst unsub = subscribeNodeValues(\n\t\t\t\tnode,\n\t\t\t\t(value) => {\n\t\t\t\t\tconst next = value as T;\n\t\t\t\t\tlistener(next, prev);\n\t\t\t\t\tprev = next;\n\t\t\t\t},\n\t\t\t\t{ changesOnly: true, onError: opts.onError, onComplete: opts.onComplete },\n\t\t\t);\n\t\t\tlisteners.add(unsub);\n\t\t\treturn () => {\n\t\t\t\tif (!listeners.delete(unsub)) return;\n\t\t\t\tunsub();\n\t\t\t};\n\t\t},\n\t\tdestroy() {\n\t\t\tfor (const unsub of [...listeners]) {\n\t\t\t\tlisteners.delete(unsub);\n\t\t\t\tunsub();\n\t\t\t}\n\t\t},\n\t};\n\treturn api;\n}\n\n/** Build a Jotai-style atom facade over a caller-owned node. */\nexport function jotaiAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableJotaiAtom<T>;\nexport function jotaiAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): JotaiAtom<T>;\nexport function jotaiAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): JotaiAtom<T> | WritableJotaiAtom<T> {\n\tconst base: JotaiAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a Nanostores-style atom facade over a caller-owned node. */\nexport function nanoAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableNanoAtom<T>;\nexport function nanoAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): NanoAtom<T>;\nexport function nanoAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): NanoAtom<T> | WritableNanoAtom<T> {\n\tconst base: NanoAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { immediate: true, ...opts }),\n\t\tlisten: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a TC39-Signals-style facade over a caller-owned node. */\nexport function signalFromNode<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableSignalLike<T>;\nexport function signalFromNode<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): SignalLike<T>;\nexport function signalFromNode<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): SignalLike<T> | WritableSignalLike<T> {\n\tconst base: SignalLike<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/react.d.cts

@@ -0,0 +1,31 @@
+import { N as Node } from '../types-CcPIn7sy.cjs';
+import { W as WritableNode } from '../store-CNJwmT-h.cjs';
+import '../messages-CAzUPPJM.cjs';
+
+/**
+ * React node bindings for GraphReFly (D238).
+ *
+ * React is imported only from this focused subpath. The dependency-free
+ * `@graphrefly/ts/adapters` barrel keeps the framework-neutral store contract.
+ */
+
+/** Read a GraphReFly node through React's useSyncExternalStore contract. */
+declare function useNodeValue<T>(node: Node<T>): T | undefined;
+/**
+ * Bind a writable GraphReFly node as `[value, setValue]`.
+ *
+ * The setter identity is stable for a stable node identity, and writes through
+ * the node's reactive DATA boundary rather than a presentation-owned trigger.
+ */
+declare function useNodeInput<T>(node: WritableNode<T>): readonly [T | undefined, (value: T) => void];
+/**
+ * Read a keyed record of nodes.
+ *
+ * `factory` must have stable identity. Recreating it on every render forces the
+ * record subscription graph to rebuild on every render.
+ */
+declare function useNodeRecord<K extends string, R extends Record<string, unknown>>(keysNode: Node<readonly K[]>, factory: (key: K) => {
+    [P in keyof R]: Node<R[P]>;
+}): Record<K, R>;
+
+export { useNodeInput, useNodeRecord, useNodeValue };

package/dist/adapters/react.d.ts

@@ -0,0 +1,31 @@
+import { N as Node } from '../types-BsJvElYZ.js';
+import { W as WritableNode } from '../store-C-joM4gh.js';
+import '../messages-CAzUPPJM.js';
+
+/**
+ * React node bindings for GraphReFly (D238).
+ *
+ * React is imported only from this focused subpath. The dependency-free
+ * `@graphrefly/ts/adapters` barrel keeps the framework-neutral store contract.
+ */
+
+/** Read a GraphReFly node through React's useSyncExternalStore contract. */
+declare function useNodeValue<T>(node: Node<T>): T | undefined;
+/**
+ * Bind a writable GraphReFly node as `[value, setValue]`.
+ *
+ * The setter identity is stable for a stable node identity, and writes through
+ * the node's reactive DATA boundary rather than a presentation-owned trigger.
+ */
+declare function useNodeInput<T>(node: WritableNode<T>): readonly [T | undefined, (value: T) => void];
+/**
+ * Read a keyed record of nodes.
+ *
+ * `factory` must have stable identity. Recreating it on every render forces the
+ * record subscription graph to rebuild on every render.
+ */
+declare function useNodeRecord<K extends string, R extends Record<string, unknown>>(keysNode: Node<readonly K[]>, factory: (key: K) => {
+    [P in keyof R]: Node<R[P]>;
+}): Record<K, R>;
+
+export { useNodeInput, useNodeRecord, useNodeValue };

package/dist/adapters/react.js

@@ -0,0 +1,51 @@
+import {
+  externalStore,
+  recordReadableStore
+} from "../chunk-H75VXTGT.js";
+import "../chunk-DGUM43GV.js";
+
+// src/adapters/react.ts
+import { useCallback, useMemo, useSyncExternalStore } from "react";
+function assertDataValue(value) {
+  if (value === void 0) {
+    throw new TypeError("useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value");
+  }
+}
+function useNodeValue(node) {
+  const store = useMemo(() => externalStore(node), [node]);
+  return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);
+}
+function useNodeInput(node) {
+  const value = useNodeValue(node);
+  const setValue = useCallback(
+    (next) => {
+      assertDataValue(next);
+      node.set(next);
+    },
+    [node]
+  );
+  return [value, setValue];
+}
+function useNodeRecord(keysNode, factory) {
+  const store = useMemo(() => {
+    const recordStore = recordReadableStore(keysNode, factory);
+    let current = recordStore.get() ?? {};
+    return {
+      getSnapshot: () => current,
+      subscribe(onStoreChange) {
+        return recordStore.subscribe((next) => {
+          current = next ?? {};
+          onStoreChange();
+        });
+      }
+    };
+  }, [keysNode, factory]);
+  const getSnapshot = useCallback(() => store.getSnapshot(), [store]);
+  return useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
+}
+export {
+  useNodeInput,
+  useNodeRecord,
+  useNodeValue
+};
+//# sourceMappingURL=react.js.map

package/dist/adapters/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/react.ts"],"sourcesContent":["/**\n * React node bindings for GraphReFly (D238).\n *\n * React is imported only from this focused subpath. The dependency-free\n * `@graphrefly/ts/adapters` barrel keeps the framework-neutral store contract.\n */\n\nimport { useCallback, useMemo, useSyncExternalStore } from \"react\";\nimport type { Node } from \"../node/node.js\";\nimport { externalStore, recordReadableStore, type WritableNode } from \"./store.js\";\n\nfunction assertDataValue(value: unknown): void {\n\tif (value === undefined) {\n\t\tthrow new TypeError(\"useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value\");\n\t}\n}\n\n/** Read a GraphReFly node through React's useSyncExternalStore contract. */\nexport function useNodeValue<T>(node: Node<T>): T | undefined {\n\tconst store = useMemo(() => externalStore(node), [node]);\n\treturn useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);\n}\n\n/**\n * Bind a writable GraphReFly node as `[value, setValue]`.\n *\n * The setter identity is stable for a stable node identity, and writes through\n * the node's reactive DATA boundary rather than a presentation-owned trigger.\n */\nexport function useNodeInput<T>(\n\tnode: WritableNode<T>,\n): readonly [T | undefined, (value: T) => void] {\n\tconst value = useNodeValue(node);\n\tconst setValue = useCallback(\n\t\t(next: T) => {\n\t\t\tassertDataValue(next);\n\t\t\tnode.set(next);\n\t\t},\n\t\t[node],\n\t);\n\treturn [value, setValue] as const;\n}\n\n/**\n * Read a keyed record of nodes.\n *\n * `factory` must have stable identity. Recreating it on every render forces the\n * record subscription graph to rebuild on every render.\n */\nexport function useNodeRecord<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: (key: K) => { [P in keyof R]: Node<R[P]> },\n): Record<K, R> {\n\tconst store = useMemo(() => {\n\t\tconst recordStore = recordReadableStore(keysNode, factory);\n\t\tlet current = recordStore.get() ?? ({} as Record<K, R>);\n\t\treturn {\n\t\t\tgetSnapshot: () => current,\n\t\t\tsubscribe(onStoreChange: () => void) {\n\t\t\t\treturn recordStore.subscribe((next) => {\n\t\t\t\t\tcurrent = next ?? ({} as Record<K, R>);\n\t\t\t\t\tonStoreChange();\n\t\t\t\t});\n\t\t\t},\n\t\t};\n\t}, [keysNode, factory]);\n\tconst getSnapshot = useCallback(() => store.getSnapshot(), [store]);\n\treturn useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);\n}\n"],"mappings":";;;;;;;AAOA,SAAS,aAAa,SAAS,4BAA4B;AAI3D,SAAS,gBAAgB,OAAsB;AAC9C,MAAI,UAAU,QAAW;AACxB,UAAM,IAAI,UAAU,wEAAwE;AAAA,EAC7F;AACD;AAGO,SAAS,aAAgB,MAA8B;AAC7D,QAAM,QAAQ,QAAQ,MAAM,cAAc,IAAI,GAAG,CAAC,IAAI,CAAC;AACvD,SAAO,qBAAqB,MAAM,WAAW,MAAM,aAAa,MAAM,iBAAiB;AACxF;AAQO,SAAS,aACf,MAC+C;AAC/C,QAAM,QAAQ,aAAa,IAAI;AAC/B,QAAM,WAAW;AAAA,IAChB,CAAC,SAAY;AACZ,sBAAgB,IAAI;AACpB,WAAK,IAAI,IAAI;AAAA,IACd;AAAA,IACA,CAAC,IAAI;AAAA,EACN;AACA,SAAO,CAAC,OAAO,QAAQ;AACxB;AAQO,SAAS,cACf,UACA,SACe;AACf,QAAM,QAAQ,QAAQ,MAAM;AAC3B,UAAM,cAAc,oBAAoB,UAAU,OAAO;AACzD,QAAI,UAAU,YAAY,IAAI,KAAM,CAAC;AACrC,WAAO;AAAA,MACN,aAAa,MAAM;AAAA,MACnB,UAAU,eAA2B;AACpC,eAAO,YAAY,UAAU,CAAC,SAAS;AACtC,oBAAU,QAAS,CAAC;AACpB,wBAAc;AAAA,QACf,CAAC;AAAA,MACF;AAAA,IACD;AAAA,EACD,GAAG,CAAC,UAAU,OAAO,CAAC;AACtB,QAAM,cAAc,YAAY,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC;AAClE,SAAO,qBAAqB,MAAM,WAAW,aAAa,WAAW;AACtE;","names":[]}

package/dist/adapters/solid.cjs

@@ -0,0 +1,157 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/solid.ts
+var solid_exports = {};
+__export(solid_exports, {
+  createNodeInput: () => createNodeInput,
+  createNodeRecord: () => createNodeRecord,
+  createNodeValue: () => createNodeValue
+});
+module.exports = __toCommonJS(solid_exports);
+var import_solid_js = require("solid-js");
+
+// src/adapters/store.ts
+function nodeSnapshot(node) {
+  return node.cache;
+}
+function subscribeNodeValues(node, run, opts = {}) {
+  const read = opts.getSnapshot ?? (() => nodeSnapshot(node));
+  if (opts.immediate) run(read());
+  let subscribing = true;
+  const skipSynchronousHandshakeData = opts.changesOnly || opts.immediate;
+  const sink = (msg, delivery) => {
+    switch (msg[0]) {
+      case "DATA":
+        if (skipSynchronousHandshakeData && subscribing && delivery === void 0) {
+          return;
+        }
+        run(msg[1]);
+        return;
+      case "ERROR":
+        opts.onError?.(msg[1]);
+        return;
+      case "COMPLETE":
+        opts.onComplete?.();
+        return;
+    }
+  };
+  const unsubscribe = node.subscribe(sink);
+  subscribing = false;
+  return unsubscribe;
+}
+function readableStore(node, opts = {}) {
+  return {
+    get: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),
+    subscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts })
+  };
+}
+function recordReadableStore(keysNode, factory, opts = {}) {
+  const read = () => {
+    const keys = keysNode.cache ?? [];
+    const out = {};
+    for (const key of keys) {
+      const nodes = factory(key);
+      const values = {};
+      for (const field of Object.keys(nodes)) {
+        values[field] = nodes[field].cache;
+      }
+      out[key] = values;
+    }
+    return out;
+  };
+  return {
+    get: read,
+    subscribe(run) {
+      const entryUnsubs = [];
+      const cleanupEntries = () => {
+        for (const unsub of entryUnsubs.splice(0)) unsub();
+      };
+      const sync = () => {
+        cleanupEntries();
+        for (const key of keysNode.cache ?? []) {
+          const nodes = factory(key);
+          for (const field of Object.keys(nodes)) {
+            entryUnsubs.push(
+              subscribeNodeValues(nodes[field], () => run(read()), {
+                changesOnly: true,
+                onError: opts.onError,
+                onComplete: opts.onComplete
+              })
+            );
+          }
+        }
+        run(read());
+      };
+      const keysUnsub = subscribeNodeValues(keysNode, sync, {
+        changesOnly: true,
+        onError: opts.onError,
+        onComplete: opts.onComplete
+      });
+      sync();
+      return () => {
+        keysUnsub();
+        cleanupEntries();
+      };
+    }
+  };
+}
+
+// src/adapters/solid.ts
+function assertDataValue(value) {
+  if (value === void 0) {
+    throw new TypeError(
+      "createNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value"
+    );
+  }
+}
+function bindReadable(store) {
+  const [value, setValue] = (0, import_solid_js.createSignal)(store.get());
+  const unsubscribe = store.subscribe((next) => {
+    setValue(() => next);
+  });
+  (0, import_solid_js.onCleanup)(unsubscribe);
+  return value;
+}
+function createNodeValue(node) {
+  return bindReadable(readableStore(node));
+}
+function createNodeInput(node) {
+  return [
+    createNodeValue(node),
+    (value) => {
+      assertDataValue(value);
+      node.set(value);
+    }
+  ];
+}
+function createNodeRecord(keysNode, factory) {
+  const store = recordReadableStore(keysNode, factory);
+  return bindReadable({
+    get: () => store.get() ?? {},
+    subscribe: (run) => store.subscribe((value) => run(value ?? {}))
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createNodeInput,
+  createNodeRecord,
+  createNodeValue
+});
+//# sourceMappingURL=solid.cjs.map

package/dist/adapters/solid.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/solid.ts","../../src/adapters/store.ts"],"sourcesContent":["/**\n * Solid node bindings for GraphReFly (D238).\n *\n * Solid is imported only from this focused subpath.\n */\n\nimport { type Accessor, createSignal, onCleanup } from \"solid-js\";\nimport type { Node } from \"../node/node.js\";\nimport { readableStore, recordReadableStore, type WritableNode } from \"./store.js\";\n\nfunction assertDataValue(value: unknown): void {\n\tif (value === undefined) {\n\t\tthrow new TypeError(\n\t\t\t\"createNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value\",\n\t\t);\n\t}\n}\n\nfunction bindReadable<T>(store: { get(): T; subscribe(run: (value: T) => void): () => void }) {\n\tconst [value, setValue] = createSignal<T>(store.get());\n\tconst unsubscribe = store.subscribe((next) => {\n\t\tsetValue(() => next);\n\t});\n\tonCleanup(unsubscribe);\n\treturn value;\n}\n\n/** Read a GraphReFly node as a Solid accessor. */\nexport function createNodeValue<T>(node: Node<T>): Accessor<T | undefined> {\n\treturn bindReadable(readableStore(node));\n}\n\n/** Bind a writable GraphReFly node as `[valueAccessor, setValue]`. */\nexport function createNodeInput<T>(\n\tnode: WritableNode<T>,\n): readonly [Accessor<T | undefined>, (value: T) => void] {\n\treturn [\n\t\tcreateNodeValue(node),\n\t\t(value: T) => {\n\t\t\tassertDataValue(value);\n\t\t\tnode.set(value);\n\t\t},\n\t] as const;\n}\n\n/**\n * Read a keyed record of nodes as a Solid accessor.\n *\n * `factory` must have stable identity; callers should define it outside render\n * churn or memoize it in their component setup.\n */\nexport function createNodeRecord<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: (key: K) => { [P in keyof R]: Node<R[P]> },\n): Accessor<Record<K, R>> {\n\tconst store = recordReadableStore(keysNode, factory);\n\treturn bindReadable({\n\t\tget: () => store.get() ?? ({} as Record<K, R>),\n\t\tsubscribe: (run) => store.subscribe((value) => run(value ?? ({} as Record<K, R>))),\n\t});\n}\n","/**\n * Framework-neutral store adapters.\n *\n * Focused framework bindings build on this tiny Node-facing layer without\n * importing framework packages into the dependency-free adapters barrel\n * (D125/D238).\n */\n\nimport type { DeliveryMeta, Sink } from \"../ctx/types.js\";\nimport type { Node } from \"../node/node.js\";\n\n/** A minimal readable store contract shared by Svelte/Nanostores-style adapters. */\nexport interface ReadableStore<T> {\n\tget(): T | undefined;\n\tsubscribe(run: (value: T | undefined) => void): () => void;\n}\n\n/** A minimal writable store contract over a clean-slate writable node. */\nexport interface WritableStore<T> extends ReadableStore<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** React `useSyncExternalStore`-compatible shape, without importing React. */\nexport interface ExternalStore<T> {\n\tgetSnapshot(): T | undefined;\n\tgetServerSnapshot(): T | undefined;\n\tsubscribe(onStoreChange: () => void): () => void;\n}\n\n/** Object-of-nodes factory used by record subscription adapters. */\nexport type NodeRecordFactory<K extends string, R extends Record<string, unknown>> = (key: K) => {\n\t[P in keyof R]: Node<R[P]>;\n};\n\n/** Zustand-compatible store API over a caller-owned clean-slate state node. */\nexport interface ZustandStoreApi<T extends object> {\n\tgetState(): T;\n\tsetState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean): void;\n\tgetInitialState(): T;\n\tsubscribe(listener: (state: T, prevState: T) => void): () => void;\n\tdestroy(): void;\n}\n\n/** Jotai-style atom facade over a caller-owned node. */\nexport interface JotaiAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Jotai-style atom facade over a caller-owned writable node. */\nexport interface WritableJotaiAtom<T> extends JotaiAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** Nanostores-style atom facade over a caller-owned node. */\nexport interface NanoAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\tlisten(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Nanostores-style atom facade over a caller-owned writable node. */\nexport interface WritableNanoAtom<T> extends NanoAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** TC39-Signals-style facade over a caller-owned node. */\nexport interface SignalLike<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable TC39-Signals-style facade over a caller-owned writable node. */\nexport interface WritableSignalLike<T> extends SignalLike<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\nexport interface SubscribeValuesOptions<T> {\n\t/** Emit the current cache snapshot immediately. `undefined` means SENTINEL/no DATA. */\n\timmediate?: boolean;\n\t/** Suppress synchronous push-on-subscribe/replay DATA. Useful for change-only store listeners. */\n\tchangesOnly?: boolean;\n\tonError?: (error: unknown) => void;\n\tonComplete?: () => void;\n\t/** Custom cache reader for wrappers that keep their own snapshot object. */\n\tgetSnapshot?: () => T | undefined;\n}\n\nexport interface WritableNode<T> extends Node<T> {\n\tset(value: T): void;\n}\n\nexport interface WritableStoreOptions<T> extends SubscribeValuesOptions<T> {\n\t/** Override writes for adapters that need a framework-owned reducer. */\n\twrite?: (node: WritableNode<T>, value: T) => void;\n}\n\n/** Read a node cache without activating it. */\nexport function nodeSnapshot<T>(node: Node<T>): T | undefined {\n\treturn node.cache as T | undefined;\n}\n\n/**\n * Subscribe to DATA values from a Node. Protocol internals stay below the adapter boundary:\n * DATA drives value listeners, ERROR/COMPLETE route to optional lifecycle callbacks.\n */\nexport function subscribeNodeValues<T>(\n\tnode: Node<T>,\n\trun: (value: T | undefined) => void,\n\topts: SubscribeValuesOptions<T> = {},\n): () => void {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tif (opts.immediate) run(read());\n\n\tlet subscribing = true;\n\tconst skipSynchronousHandshakeData = opts.changesOnly || opts.immediate;\n\tconst sink: Sink = (msg, delivery?: DeliveryMeta) => {\n\t\tswitch (msg[0]) {\n\t\t\tcase \"DATA\":\n\t\t\t\tif (skipSynchronousHandshakeData && subscribing && delivery === undefined) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\trun(msg[1] as T);\n\t\t\t\treturn;\n\t\t\tcase \"ERROR\":\n\t\t\t\topts.onError?.(msg[1]);\n\t\t\t\treturn;\n\t\t\tcase \"COMPLETE\":\n\t\t\t\topts.onComplete?.();\n\t\t\t\treturn;\n\t\t}\n\t};\n\tconst unsubscribe = node.subscribe(sink);\n\tsubscribing = false;\n\treturn unsubscribe;\n}\n\n/** Build a Svelte/Nanostores-style readable store from a clean-slate Node. */\nexport function readableStore<T>(\n\tnode: Node<T>,\n\topts: SubscribeValuesOptions<T> = {},\n): ReadableStore<T> {\n\treturn {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t};\n}\n\nfunction hasWritableSet<T>(node: Node<T>): node is WritableNode<T> {\n\treturn typeof (node as { set?: unknown }).set === \"function\";\n}\n\nfunction defaultWrite<T>(node: WritableNode<T>, value: T): void {\n\tnode.set(value);\n}\n\n/** Build a writable store over a StateNode or compatible clean-slate writable Node. */\nexport function writableStore<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> = {},\n): WritableStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"writableStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\treturn {\n\t\tget: read,\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t\tset: (value) => write(writable, value),\n\t\tupdate: (fn) => write(writable, fn(read())),\n\t};\n}\n\n/** Build the tiny shape React's `useSyncExternalStore` expects, without importing React. */\nexport function externalStore<T>(\n\tnode: Node<T>,\n\topts: Pick<SubscribeValuesOptions<T>, \"getSnapshot\" | \"onError\" | \"onComplete\"> = {},\n): ExternalStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\treturn {\n\t\tgetSnapshot: read,\n\t\tgetServerSnapshot: read,\n\t\tsubscribe: (onStoreChange) =>\n\t\t\tsubscribeNodeValues(node, () => onStoreChange(), {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t}),\n\t};\n}\n\n/** Build a framework-neutral keyed record store for focused framework record bindings. */\nexport function recordReadableStore<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: NodeRecordFactory<K, R>,\n\topts: SubscribeValuesOptions<Record<K, R>> = {},\n): ReadableStore<Record<K, R>> {\n\tconst read = () => {\n\t\tconst keys = keysNode.cache ?? [];\n\t\tconst out = {} as Record<K, R>;\n\t\tfor (const key of keys) {\n\t\t\tconst nodes = factory(key);\n\t\t\tconst values = {} as R;\n\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\tvalues[field] = nodes[field].cache as R[keyof R];\n\t\t\t}\n\t\t\tout[key] = values;\n\t\t}\n\t\treturn out;\n\t};\n\n\treturn {\n\t\tget: read,\n\t\tsubscribe(run) {\n\t\t\tconst entryUnsubs: Array<() => void> = [];\n\t\t\tconst cleanupEntries = () => {\n\t\t\t\tfor (const unsub of entryUnsubs.splice(0)) unsub();\n\t\t\t};\n\t\t\tconst sync = () => {\n\t\t\t\tcleanupEntries();\n\t\t\t\tfor (const key of keysNode.cache ?? []) {\n\t\t\t\t\tconst nodes = factory(key);\n\t\t\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\t\t\tentryUnsubs.push(\n\t\t\t\t\t\t\tsubscribeNodeValues(nodes[field], () => run(read()), {\n\t\t\t\t\t\t\t\tchangesOnly: true,\n\t\t\t\t\t\t\t\tonError: opts.onError,\n\t\t\t\t\t\t\t\tonComplete: opts.onComplete,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\trun(read());\n\t\t\t};\n\t\t\tconst keysUnsub = subscribeNodeValues(keysNode, sync, {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t});\n\t\t\tsync();\n\t\t\treturn () => {\n\t\t\t\tkeysUnsub();\n\t\t\t\tcleanupEntries();\n\t\t\t};\n\t\t},\n\t};\n}\n\n/** Build a Zustand-compatible StoreApi over a caller-owned clean-slate state node. */\nexport function zustandStore<T extends object>(\n\tnode: WritableNode<T>,\n\tinitialState?: T,\n\topts?: WritableStoreOptions<T>,\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T | undefined,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T = nodeSnapshot(node) as T,\n\topts: WritableStoreOptions<T> = {},\n): ZustandStoreApi<T> {\n\tconst listeners = new Set<() => void>();\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"zustandStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\tconst api: ZustandStoreApi<T> = {\n\t\tgetState: () => read() as T,\n\t\tsetState(partial, replace) {\n\t\t\tconst prev = api.getState();\n\t\t\tconst next = typeof partial === \"function\" ? partial(prev) : partial;\n\t\t\twrite(writable, replace ? (next as T) : ({ ...prev, ...next } as T));\n\t\t},\n\t\tgetInitialState: () => initialState,\n\t\tsubscribe(listener) {\n\t\t\tlet prev = api.getState();\n\t\t\tconst unsub = subscribeNodeValues(\n\t\t\t\tnode,\n\t\t\t\t(value) => {\n\t\t\t\t\tconst next = value as T;\n\t\t\t\t\tlistener(next, prev);\n\t\t\t\t\tprev = next;\n\t\t\t\t},\n\t\t\t\t{ changesOnly: true, onError: opts.onError, onComplete: opts.onComplete },\n\t\t\t);\n\t\t\tlisteners.add(unsub);\n\t\t\treturn () => {\n\t\t\t\tif (!listeners.delete(unsub)) return;\n\t\t\t\tunsub();\n\t\t\t};\n\t\t},\n\t\tdestroy() {\n\t\t\tfor (const unsub of [...listeners]) {\n\t\t\t\tlisteners.delete(unsub);\n\t\t\t\tunsub();\n\t\t\t}\n\t\t},\n\t};\n\treturn api;\n}\n\n/** Build a Jotai-style atom facade over a caller-owned node. */\nexport function jotaiAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableJotaiAtom<T>;\nexport function jotaiAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): JotaiAtom<T>;\nexport function jotaiAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): JotaiAtom<T> | WritableJotaiAtom<T> {\n\tconst base: JotaiAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a Nanostores-style atom facade over a caller-owned node. */\nexport function nanoAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableNanoAtom<T>;\nexport function nanoAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): NanoAtom<T>;\nexport function nanoAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): NanoAtom<T> | WritableNanoAtom<T> {\n\tconst base: NanoAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { immediate: true, ...opts }),\n\t\tlisten: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a TC39-Signals-style facade over a caller-owned node. */\nexport function signalFromNode<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableSignalLike<T>;\nexport function signalFromNode<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): SignalLike<T>;\nexport function signalFromNode<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): SignalLike<T> | WritableSignalLike<T> {\n\tconst base: SignalLike<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n"],"mappings":"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","names":[]}