@graphrefly/graphrefly 0.45.0 → 0.47.0

package/dist/compat/vue/index.cjs

@@ -3,6 +3,10 @@ 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))
@@ -11,11 +15,105 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/compat/vue/index.ts
 var vue_exports = {};
+__export(vue_exports, {
+  useStore: () => useStore,
+  useSubscribe: () => useSubscribe,
+  useSubscribeRecord: () => useSubscribeRecord
+});
 module.exports = __toCommonJS(vue_exports);
-__reExport(vue_exports, require("@graphrefly/pure-ts/compat/vue"), module.exports);
+var import_core = require("@graphrefly/pure-ts/core");
+var import_vue = require("vue");
+function useSubscribe(node) {
+  const ref = (0, import_vue.shallowRef)(node.cache);
+  const unsub = node.subscribe(() => {
+    ref.value = node.cache;
+  });
+  if ((0, import_vue.getCurrentScope)()) {
+    (0, import_vue.onScopeDispose)(() => unsub());
+  } else if (typeof console !== "undefined") {
+    console.warn(
+      "[graphrefly-ts] useSubscribe called outside a Vue scope \u2014 subscription will not be auto-disposed."
+    );
+  }
+  return (0, import_vue.readonly)(ref);
+}
+function useStore(node) {
+  const inner = (0, import_vue.shallowRef)(node.cache);
+  const unsub = node.subscribe(() => {
+    inner.value = node.cache;
+  });
+  if ((0, import_vue.getCurrentScope)()) {
+    (0, import_vue.onScopeDispose)(() => unsub());
+  } else if (typeof console !== "undefined") {
+    console.warn(
+      "[graphrefly-ts] useStore called outside a Vue scope \u2014 subscription will not be auto-disposed."
+    );
+  }
+  return (0, import_vue.computed)({
+    get: () => inner.value,
+    set: (v) => {
+      node.down([[import_core.DIRTY], [import_core.DATA, v]]);
+    }
+  });
+}
+function useSubscribeRecord(keys, factory) {
+  const result = (0, import_vue.shallowRef)({});
+  const activeSubs = /* @__PURE__ */ new Map();
+  function flushResult() {
+    const snap = {};
+    for (const [key, entry] of activeSubs) {
+      snap[key] = { ...entry.values };
+    }
+    result.value = snap;
+  }
+  function sync(newKeys) {
+    for (const entry of activeSubs.values()) {
+      for (const unsub of entry.subs) unsub();
+    }
+    activeSubs.clear();
+    for (const key of newKeys) {
+      const nodes = factory(key);
+      const fields = Object.keys(nodes);
+      const values = {};
+      const subs = [];
+      for (const field of fields) {
+        const node = nodes[field];
+        values[field] = node.cache;
+        const unsub = node.subscribe(() => {
+          values[field] = node.cache;
+          flushResult();
+        });
+        subs.push(unsub);
+      }
+      activeSubs.set(key, { subs, values });
+    }
+    const snap = {};
+    for (const [key, entry] of activeSubs) {
+      snap[key] = { ...entry.values };
+    }
+    result.value = snap;
+  }
+  const readKeys = () => {
+    const current = typeof keys === "function" ? keys() : (0, import_vue.isRef)(keys) ? keys.value : keys;
+    return [...current ?? []];
+  };
+  (0, import_vue.watch)(readKeys, (newKeys) => sync(newKeys ?? []), { immediate: true });
+  if ((0, import_vue.getCurrentScope)()) {
+    (0, import_vue.onScopeDispose)(() => {
+      for (const entry of activeSubs.values()) {
+        for (const unsub of entry.subs) unsub();
+      }
+      activeSubs.clear();
+    });
+  } else if (typeof console !== "undefined") {
+    console.warn(
+      "[graphrefly-ts] useSubscribeRecord called outside a Vue scope \u2014 subscription will not be auto-disposed."
+    );
+  }
+  return (0, import_vue.readonly)(result);
+}
 //# sourceMappingURL=index.cjs.map

package/dist/compat/vue/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/compat/vue/index.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/compat/vue\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,wBAAc,2CAFd;","names":[]}
+{"version":3,"sources":["../../../src/compat/vue/index.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Vue bindings — useStore / useSubscribe\n// ---------------------------------------------------------------------------\n// Bridges GraphReFly nodes into Vue reactivity. Works with any\n// Node<T>, including companion nodes (node.meta.status).\n//\n// Usage:\n//   import { useStore, useSubscribe } from '@graphrefly/graphrefly-ts/compat/vue';\n//   // Optional peer install (only for this adapter): pnpm add vue\n//   const count = useStore(counterNode);       // Ref<number | undefined> (read + write)\n//   const status = useSubscribe(wsStatusNode); // Readonly<Ref<string | undefined>>\n// ---------------------------------------------------------------------------\n\nimport { DATA, DIRTY, type Node } from \"@graphrefly/pure-ts/core\";\nimport {\n\tcomputed,\n\tgetCurrentScope,\n\tisRef,\n\tonScopeDispose,\n\ttype Ref,\n\treadonly,\n\tshallowRef,\n\ttype WatchSource,\n\twatch,\n} from \"vue\";\n\n/**\n * Subscribe to a read-only `Node<T>` as a Vue `Ref<T>`. Auto-unsubscribes on scope disposal.\n * Subscription lifecycle is tied to Vue scope disposal (not node terminal messages).\n */\nexport function useSubscribe<T>(node: Node<T>): Readonly<Ref<T | undefined | null>> {\n\tconst ref = shallowRef(node.cache) as Ref<T | undefined | null>;\n\n\tconst unsub = node.subscribe(() => {\n\t\tref.value = node.cache;\n\t});\n\n\tif (getCurrentScope()) {\n\t\tonScopeDispose(() => unsub());\n\t} else if (typeof console !== \"undefined\") {\n\t\tconsole.warn(\n\t\t\t\"[graphrefly-ts] useSubscribe called outside a Vue scope — subscription will not be auto-disposed.\",\n\t\t);\n\t}\n\n\treturn readonly(ref) as Readonly<Ref<T | undefined | null>>;\n}\n\n/**\n * Bind a writable `Node<T>` as a Vue `Ref<T>`. Reads and writes are bidirectional.\n * Value sets always dispatch `[[DIRTY], [DATA, value]]`, including `value === undefined`.\n * Subscription lifecycle is tied to Vue scope disposal (not node terminal messages).\n */\nexport function useStore<T>(node: Node<T>): Ref<T | undefined | null> {\n\tconst inner = shallowRef(node.cache) as Ref<T | undefined | null>;\n\n\tconst unsub = node.subscribe(() => {\n\t\tinner.value = node.cache;\n\t});\n\n\tif (getCurrentScope()) {\n\t\tonScopeDispose(() => unsub());\n\t} else if (typeof console !== \"undefined\") {\n\t\tconsole.warn(\n\t\t\t\"[graphrefly-ts] useStore called outside a Vue scope — subscription will not be auto-disposed.\",\n\t\t);\n\t}\n\n\treturn computed({\n\t\tget: () => inner.value,\n\t\tset: (v: T | undefined | null) => {\n\t\t\tnode.down([[DIRTY], [DATA, v]]);\n\t\t},\n\t});\n}\n\n/** Maps a key to an object of nodes. Used by `useSubscribeRecord` factory. */\nexport type NodeFactory<K, R extends Record<string, any>> = (key: K) => {\n\t[P in keyof R]: Node<R[P]>;\n};\n\n/**\n * Subscribe to a dynamic set of keyed node records. When keys change,\n * old subscriptions are torn down and new ones created automatically.\n * Must be called during Vue `setup()`.\n */\nexport function useSubscribeRecord<K extends string, R extends Record<string, any>>(\n\tkeys: WatchSource<K[] | undefined>,\n\tfactory: NodeFactory<K, R>,\n): Readonly<Ref<Record<K, R>>> {\n\tconst result = shallowRef<Record<K, R>>({} as Record<K, R>);\n\n\t// Track active subscriptions per key (strictly enclosed memory mapping)\n\tconst activeSubs = new Map<K, { subs: Array<() => void>; values: R }>();\n\tfunction flushResult() {\n\t\tconst snap = {} as Record<K, R>;\n\t\tfor (const [key, entry] of activeSubs) {\n\t\t\tsnap[key] = { ...entry.values };\n\t\t}\n\t\tresult.value = snap;\n\t}\n\n\tfunction sync(newKeys: K[]) {\n\t\tfor (const entry of activeSubs.values()) {\n\t\t\tfor (const unsub of entry.subs) unsub();\n\t\t}\n\t\tactiveSubs.clear();\n\n\t\tfor (const key of newKeys) {\n\t\t\tconst nodes = factory(key);\n\t\t\tconst fields = Object.keys(nodes) as (keyof R)[];\n\t\t\tconst values = {} as R;\n\t\t\tconst subs: Array<() => void> = [];\n\n\t\t\tfor (const field of fields) {\n\t\t\t\tconst node = nodes[field];\n\t\t\t\tvalues[field] = node.cache as R[keyof R];\n\t\t\t\tconst unsub = node.subscribe(() => {\n\t\t\t\t\tvalues[field] = node.cache as R[keyof R];\n\t\t\t\t\tflushResult();\n\t\t\t\t});\n\t\t\t\tsubs.push(unsub);\n\t\t\t}\n\n\t\t\tactiveSubs.set(key, { subs, values });\n\t\t}\n\n\t\tconst snap = {} as Record<K, R>;\n\t\tfor (const [key, entry] of activeSubs) {\n\t\t\tsnap[key] = { ...entry.values };\n\t\t}\n\t\tresult.value = snap;\n\t}\n\n\tconst readKeys = (): K[] => {\n\t\tconst current = typeof keys === \"function\" ? keys() : isRef(keys) ? keys.value : keys;\n\t\treturn [...(current ?? [])];\n\t};\n\n\twatch(readKeys, (newKeys) => sync(newKeys ?? []), { immediate: true });\n\n\tif (getCurrentScope()) {\n\t\tonScopeDispose(() => {\n\t\t\tfor (const entry of activeSubs.values()) {\n\t\t\t\tfor (const unsub of entry.subs) unsub();\n\t\t\t}\n\t\t\tactiveSubs.clear();\n\t\t});\n\t} else if (typeof console !== \"undefined\") {\n\t\tconsole.warn(\n\t\t\t\"[graphrefly-ts] useSubscribeRecord called outside a Vue scope — subscription will not be auto-disposed.\",\n\t\t);\n\t}\n\n\treturn readonly(result) as Readonly<Ref<Record<K, R>>>;\n}\n"],"mappings":"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","names":[]}

package/dist/compat/vue/index.d.cts

@@ -1 +1,3 @@
-export * from '@graphrefly/pure-ts/compat/vue';
+import '@graphrefly/pure-ts/core';
+import 'vue';
+export { N as NodeFactory, u as useStore, a as useSubscribe, b as useSubscribeRecord } from '../../index-DeWbQzMe.cjs';

package/dist/compat/vue/index.d.ts

@@ -1 +1,3 @@
-export * from '@graphrefly/pure-ts/compat/vue';
+import '@graphrefly/pure-ts/core';
+import 'vue';
+export { N as NodeFactory, u as useStore, a as useSubscribe, b as useSubscribeRecord } from '../../index-DeWbQzMe.js';

package/dist/compat/vue/index.js

@@ -1,3 +1,12 @@
-// src/compat/vue/index.ts
-export * from "@graphrefly/pure-ts/compat/vue";
+import {
+  useStore,
+  useSubscribe,
+  useSubscribeRecord
+} from "../../chunk-PL5UDIQ5.js";
+import "../../chunk-AZDQPQ3V.js";
+export {
+  useStore,
+  useSubscribe,
+  useSubscribeRecord
+};
 //# sourceMappingURL=index.js.map

package/dist/compat/vue/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/compat/vue/index.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/compat/vue\";\n"],"mappings":";AAEA,cAAc;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/compat/zustand/index.cjs

@@ -3,6 +3,10 @@ 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))
@@ -11,11 +15,55 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/compat/zustand/index.ts
 var zustand_exports = {};
+__export(zustand_exports, {
+  create: () => create
+});
 module.exports = __toCommonJS(zustand_exports);
-__reExport(zustand_exports, require("@graphrefly/pure-ts/compat/zustand"), module.exports);
+var import_core = require("@graphrefly/pure-ts/core");
+var import_graph = require("@graphrefly/pure-ts/graph");
+var alwaysDiffer = () => false;
+function create(initializer) {
+  const g = new import_graph.Graph("zustand");
+  const s = (0, import_core.node)([], {
+    initial: void 0,
+    name: "state",
+    equals: alwaysDiffer
+  });
+  g.add(s, { name: "state" });
+  const getState = () => s.cache;
+  const setState = (partial, replace) => {
+    const prev = s.cache;
+    const next = typeof partial === "function" ? partial(prev) : partial;
+    s.emit(replace ? next : { ...prev, ...next });
+  };
+  const api = {
+    getState,
+    setState,
+    getInitialState: () => initialValue,
+    subscribe: (listener) => {
+      let initial = true;
+      let prev = s.cache;
+      return s.subscribe((msgs) => {
+        for (const [t, v] of msgs) {
+          if (t === import_core.DATA) {
+            if (initial) {
+              initial = false;
+              continue;
+            }
+            listener(v, prev);
+            prev = v;
+          }
+        }
+      });
+    },
+    destroy: g.destroy.bind(g)
+  };
+  const initialValue = initializer(setState, getState, api);
+  s.emit(initialValue);
+  return Object.assign(g, api);
+}
 //# sourceMappingURL=index.cjs.map

package/dist/compat/zustand/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/compat/zustand/index.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/compat/zustand\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,4BAAc,+CAFd;","names":[]}
+{"version":3,"sources":["../../../src/compat/zustand/index.ts"],"sourcesContent":["import { DATA, node as nodeFactory } from \"@graphrefly/pure-ts/core\";\nimport { Graph } from \"@graphrefly/pure-ts/graph\";\n\n// Zustand fires listeners on every setState, regardless of reference\n// equality. Configure the state node with a permissive equals so every\n// emit produces DATA (not RESOLVED). Diamond coordination still works\n// because `n.emit` routes through the framed pipeline which auto-\n// prefixes `[DIRTY]`.\nconst alwaysDiffer = () => false;\n\n/** Zustand-compatible Store API. */\nexport interface StoreApi<T> {\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/** Function type for initializing the store. */\nexport type StateCreator<T> = (\n\tset: StoreApi<T>[\"setState\"],\n\tget: StoreApi<T>[\"getState\"],\n\tapi: StoreApi<T>,\n) => T;\n\n/**\n * Creates a Zustand-compatible store backed by a GraphReFly state node.\n * returns an object that is both a Graph and a StoreApi.\n *\n * @example\n * ```ts\n * const store = create((set) => ({\n *   count: 0,\n *   inc: () => set((s) => ({ count: s.count + 1 }))\n * }));\n * store.getState().inc();\n * ```\n *\n * @category compat\n */\nexport function create<T extends object>(initializer: StateCreator<T>): Graph & StoreApi<T> {\n\tconst g = new Graph(\"zustand\");\n\tconst s = nodeFactory<T>([], {\n\t\tinitial: undefined as unknown as T,\n\t\tname: \"state\",\n\t\tequals: alwaysDiffer,\n\t});\n\tg.add(s, { name: \"state\" });\n\n\t// `getState` and `setState` read/write through `s` directly — the single\n\t// source of truth. `s.cache` is `undefined` (SENTINEL) until `emit()` is\n\t// called, but action closures (e.g. `inc: () => set(...)`) are only ever\n\t// invoked after initialization, so `s.cache` is valid by that time.\n\tconst getState = () => s.cache as T;\n\tconst setState = (partial: any, replace?: boolean): void => {\n\t\tconst prev = s.cache as T;\n\t\tconst next = typeof partial === \"function\" ? partial(prev) : partial;\n\t\t// `n.emit` goes through `_actionEmit` → `bundle()`, which auto-\n\t\t// prefixes `[DIRTY]` so diamond legs coordinate under downstream\n\t\t// composition. The `alwaysDiffer` equals keeps zustand's \"fire\n\t\t// on every setState\" semantics.\n\t\ts.emit(replace ? next : { ...prev, ...next });\n\t};\n\n\tconst api: StoreApi<T> = {\n\t\tgetState,\n\t\tsetState,\n\t\tgetInitialState: () => initialValue,\n\t\tsubscribe: (listener) => {\n\t\t\t// Skip the initial push-on-subscribe DATA — zustand subscribe fires on changes only.\n\t\t\tlet initial = true;\n\t\t\tlet prev = s.cache as T;\n\t\t\treturn s.subscribe((msgs) => {\n\t\t\t\tfor (const [t, v] of msgs) {\n\t\t\t\t\tif (t === DATA) {\n\t\t\t\t\t\tif (initial) {\n\t\t\t\t\t\t\tinitial = false;\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tlistener(v as T, prev);\n\t\t\t\t\t\tprev = v as T;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tdestroy: g.destroy.bind(g),\n\t};\n\n\tconst initialValue = initializer(setState, getState, api);\n\ts.emit(initialValue);\n\n\treturn Object.assign(g, api);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA0C;AAC1C,mBAAsB;AAOtB,IAAM,eAAe,MAAM;AAiCpB,SAAS,OAAyB,aAAmD;AAC3F,QAAM,IAAI,IAAI,mBAAM,SAAS;AAC7B,QAAM,QAAI,YAAAA,MAAe,CAAC,GAAG;AAAA,IAC5B,SAAS;AAAA,IACT,MAAM;AAAA,IACN,QAAQ;AAAA,EACT,CAAC;AACD,IAAE,IAAI,GAAG,EAAE,MAAM,QAAQ,CAAC;AAM1B,QAAM,WAAW,MAAM,EAAE;AACzB,QAAM,WAAW,CAAC,SAAc,YAA4B;AAC3D,UAAM,OAAO,EAAE;AACf,UAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,IAAI,IAAI;AAK7D,MAAE,KAAK,UAAU,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC;AAAA,EAC7C;AAEA,QAAM,MAAmB;AAAA,IACxB;AAAA,IACA;AAAA,IACA,iBAAiB,MAAM;AAAA,IACvB,WAAW,CAAC,aAAa;AAExB,UAAI,UAAU;AACd,UAAI,OAAO,EAAE;AACb,aAAO,EAAE,UAAU,CAAC,SAAS;AAC5B,mBAAW,CAAC,GAAG,CAAC,KAAK,MAAM;AAC1B,cAAI,MAAM,kBAAM;AACf,gBAAI,SAAS;AACZ,wBAAU;AACV;AAAA,YACD;AACA,qBAAS,GAAQ,IAAI;AACrB,mBAAO;AAAA,UACR;AAAA,QACD;AAAA,MACD,CAAC;AAAA,IACF;AAAA,IACA,SAAS,EAAE,QAAQ,KAAK,CAAC;AAAA,EAC1B;AAEA,QAAM,eAAe,YAAY,UAAU,UAAU,GAAG;AACxD,IAAE,KAAK,YAAY;AAEnB,SAAO,OAAO,OAAO,GAAG,GAAG;AAC5B;","names":["nodeFactory"]}

package/dist/compat/zustand/index.d.cts

@@ -1 +1,2 @@
-export * from '@graphrefly/pure-ts/compat/zustand';
+import '@graphrefly/pure-ts/graph';
+export { S as StateCreator, a as StoreApi, c as create } from '../../index-CDfk6jHN.cjs';

package/dist/compat/zustand/index.d.ts

@@ -1 +1,2 @@
-export * from '@graphrefly/pure-ts/compat/zustand';
+import '@graphrefly/pure-ts/graph';
+export { S as StateCreator, a as StoreApi, c as create } from '../../index-CDfk6jHN.js';

package/dist/compat/zustand/index.js

@@ -1,3 +1,8 @@
-// src/compat/zustand/index.ts
-export * from "@graphrefly/pure-ts/compat/zustand";
+import {
+  create
+} from "../../chunk-255UCBG4.js";
+import "../../chunk-AZDQPQ3V.js";
+export {
+  create
+};
 //# sourceMappingURL=index.js.map

package/dist/compat/zustand/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/compat/zustand/index.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/compat/zustand\";\n"],"mappings":";AAEA,cAAc;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/distill-De6Rnn15.d.cts

@@ -0,0 +1,48 @@
+import { Node } from '@graphrefly/pure-ts/core';
+import { ReactiveMapBundle, NodeInput, ReactiveMapOptions } from '@graphrefly/pure-ts/extra';
+
+/**
+ * Budget-constrained reactive memory composition (roadmap §3.2b).
+ *
+ * Moved to base/composition/distill.ts during cleave A2.
+ */
+
+type Extraction<TMem> = {
+    upsert: Array<{
+        key: string;
+        value: TMem;
+    }>;
+    remove?: string[];
+};
+type DistillOptions<TMem> = {
+    score: (mem: TMem, context: unknown) => number;
+    cost: (mem: TMem) => number;
+    budget?: number;
+    evict?: (key: string, mem: TMem) => boolean | Node<boolean>;
+    consolidate?: (entries: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
+    consolidateTrigger?: NodeInput<unknown>;
+    context?: NodeInput<unknown>;
+    mapOptions?: ReactiveMapOptions<string, TMem>;
+};
+type DistillBundle<TMem> = {
+    store: ReactiveMapBundle<string, TMem>;
+    compact: Node<Array<{
+        key: string;
+        value: TMem;
+        score: number;
+    }>>;
+    size: Node<number>;
+};
+/**
+ * Budget-constrained reactive memory composition.
+ *
+ * **Tier 1.5.4 (Session A.5 lock, 2026-04-27):** `extractFn` receives the
+ * source and existing-store as `Node`s. Distill calls `extractFn` ONCE at
+ * wiring time and consumes the returned stream of extractions. The user
+ * controls reactive composition — wrap with `switchMap` for cancel-on-new-input,
+ * `mergeMap` for parallel, `derived` for sync transforms. See COMPOSITION-GUIDE
+ * §40 for the recipe.
+ */
+declare function distill<TRaw, TMem>(source: NodeInput<TRaw>, extractFn: (raw: Node<TRaw>, existing: Node<ReadonlyMap<string, TMem>>) => NodeInput<Extraction<TMem>>, opts: DistillOptions<TMem>): DistillBundle<TMem>;
+
+export { type DistillBundle as D, type Extraction as E, type DistillOptions as a, distill as d };

package/dist/distill-De6Rnn15.d.ts

@@ -0,0 +1,48 @@
+import { Node } from '@graphrefly/pure-ts/core';
+import { ReactiveMapBundle, NodeInput, ReactiveMapOptions } from '@graphrefly/pure-ts/extra';
+
+/**
+ * Budget-constrained reactive memory composition (roadmap §3.2b).
+ *
+ * Moved to base/composition/distill.ts during cleave A2.
+ */
+
+type Extraction<TMem> = {
+    upsert: Array<{
+        key: string;
+        value: TMem;
+    }>;
+    remove?: string[];
+};
+type DistillOptions<TMem> = {
+    score: (mem: TMem, context: unknown) => number;
+    cost: (mem: TMem) => number;
+    budget?: number;
+    evict?: (key: string, mem: TMem) => boolean | Node<boolean>;
+    consolidate?: (entries: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
+    consolidateTrigger?: NodeInput<unknown>;
+    context?: NodeInput<unknown>;
+    mapOptions?: ReactiveMapOptions<string, TMem>;
+};
+type DistillBundle<TMem> = {
+    store: ReactiveMapBundle<string, TMem>;
+    compact: Node<Array<{
+        key: string;
+        value: TMem;
+        score: number;
+    }>>;
+    size: Node<number>;
+};
+/**
+ * Budget-constrained reactive memory composition.
+ *
+ * **Tier 1.5.4 (Session A.5 lock, 2026-04-27):** `extractFn` receives the
+ * source and existing-store as `Node`s. Distill calls `extractFn` ONCE at
+ * wiring time and consumes the returned stream of extractions. The user
+ * controls reactive composition — wrap with `switchMap` for cancel-on-new-input,
+ * `mergeMap` for parallel, `derived` for sync transforms. See COMPOSITION-GUIDE
+ * §40 for the recipe.
+ */
+declare function distill<TRaw, TMem>(source: NodeInput<TRaw>, extractFn: (raw: Node<TRaw>, existing: Node<ReadonlyMap<string, TMem>>) => NodeInput<Extraction<TMem>>, opts: DistillOptions<TMem>): DistillBundle<TMem>;
+
+export { type DistillBundle as D, type Extraction as E, type DistillOptions as a, distill as d };

package/dist/external-register-CWyroXb_.d.cts

@@ -0,0 +1,138 @@
+import { NodeOptions, Node } from '@graphrefly/pure-ts/core';
+
+/**
+ * External-register helpers — the common `register({emit, error, complete})`
+ * contract shared by webhook, MCP, syslog, StatsD, OTel and other callback-
+ * based integrations. Absorbs the `active` flag that every such adapter needs
+ * to guard against emits after teardown (§5.10 boundary pattern).
+ *
+ * Two shapes:
+ *
+ * - {@link externalProducer} — single channel. Lazy activation: the register
+ *   fn runs when the node gains its first subscriber; its returned cleanup
+ *   runs on deactivation.
+ *
+ * - {@link externalBundle} — multiple named channels. Eager activation: the
+ *   register fn runs at bundle construction time so externally-owned servers
+ *   (HTTP endpoints, UDP sockets) start accepting traffic immediately. A
+ *   shared refcount fires the returned cleanup once every channel has fully
+ *   torn down.
+ */
+
+type ExtraOpts = Omit<NodeOptions<unknown>, "describeKind">;
+/**
+ * Standard emit-triad passed to a single-channel external registrar.
+ *
+ * Post-teardown calls on any of these are automatically no-ops — the
+ * registrar does not need its own guard flag.
+ *
+ * @category extra
+ */
+type EmitTriad<T> = {
+    /** Emit a value as `DATA`. */
+    emit: (value: T) => void;
+    /** Terminate with `ERROR`. Subsequent `emit` / `error` / `complete` are ignored. */
+    error: (err: unknown) => void;
+    /** Terminate with `COMPLETE`. Subsequent `emit` / `error` / `complete` are ignored. */
+    complete: () => void;
+};
+/**
+ * Multi-channel emit bundle. Each declared channel name maps to an emit fn;
+ * `error` and `complete` terminate every channel atomically.
+ *
+ * @category extra
+ */
+type BundleTriad<TChannels extends Record<string, unknown>> = {
+    [K in keyof TChannels]: (value: TChannels[K]) => void;
+} & {
+    /** Terminate every channel with `ERROR`. */
+    error: (err: unknown) => void;
+    /** Terminate every channel with `COMPLETE`. */
+    complete: () => void;
+};
+/**
+ * Generic external registrator contract. The caller installs handlers into a
+ * third-party library / framework / server and optionally returns a cleanup
+ * callback. Returning `undefined` / `void` is equivalent to a no-op cleanup.
+ *
+ * @category extra
+ */
+type ExternalRegister<H> = (handlers: H) => (() => void) | undefined;
+/**
+ * Wraps a callback-style external integration as a reactive source.
+ *
+ * The registrar installs the supplied `emit` / `error` / `complete` handlers
+ * into the external SDK; post-teardown calls are silently dropped. Synchronous
+ * exceptions thrown by the registrar surface as terminal `ERROR`.
+ *
+ * @param register - Installs handlers. Optionally returns a cleanup fn.
+ * @param opts - Node options (name, equals, resubscribable, ...).
+ *
+ * @example
+ * ```ts
+ * import { externalProducer } from "@graphrefly/graphrefly-ts";
+ *
+ * const hook$ = externalProducer<Payload>(({ emit, error }) => {
+ *   const id = transport.onMessage((raw) => {
+ *     try { emit(parse(raw)); } catch (e) { error(e); }
+ *   });
+ *   return () => transport.off(id);
+ * });
+ * ```
+ *
+ * @category extra
+ */
+declare function externalProducer<T = unknown>(register: ExternalRegister<EmitTriad<T>>, opts?: ExtraOpts): Node<T>;
+/**
+ * Options for {@link externalBundle}.
+ *
+ * @category extra
+ */
+type ExternalBundleOptions<TChannels extends Record<string, unknown>> = {
+    /** Base name prefix for channel nodes; each node is named `${name}::${channel}`. */
+    name?: string;
+    /** Per-channel node options (equals, resubscribable, ...). */
+    channelOpts?: {
+        [K in keyof TChannels]?: ExtraOpts;
+    };
+};
+/**
+ * Multi-channel variant — one `Node<T>` per named channel, sharing a single
+ * registrar. Activation is eager: the registrar runs at construction time so
+ * externally-owned servers (HTTP, UDP, queue consumers) can start accepting
+ * traffic immediately. The returned cleanup fires once every channel has been
+ * subscribed and then fully deactivated (refcount-on-teardown).
+ *
+ * Any call to `error` or `complete` propagates to every channel atomically.
+ *
+ * @param register - Installs handlers for each channel plus shared error/complete.
+ * @param channels - Ordered channel names; determines the returned object shape.
+ * @param opts - Optional name prefix and per-channel node options.
+ *
+ * @example
+ * ```ts
+ * import { externalBundle } from "@graphrefly/graphrefly-ts";
+ *
+ * type OTelChannels = { traces: Span; metrics: Metric; logs: LogRec };
+ * const otel = externalBundle<OTelChannels>(
+ *   ({ traces, metrics, logs, error }) => {
+ *     app.post("/v1/traces",  (req, res) => { traces(req.body);  res.sendStatus(200); });
+ *     app.post("/v1/metrics", (req, res) => { metrics(req.body); res.sendStatus(200); });
+ *     app.post("/v1/logs",    (req, res) => { logs(req.body);    res.sendStatus(200); });
+ *     server.on("error", error);
+ *     return () => server.close();
+ *   },
+ *   ["traces", "metrics", "logs"],
+ * );
+ * otel.traces.subscribe(...);
+ * ```
+ *
+ * @category extra
+ */
+declare function externalBundle<TChannels extends Record<string, unknown>>(register: ExternalRegister<BundleTriad<TChannels>>, channels: readonly (keyof TChannels & string)[], opts?: ExternalBundleOptions<TChannels>): {
+    [K in keyof TChannels]: Node<TChannels[K]>;
+} & {
+    dispose(): void;
+};
+
+export { type BundleTriad as B, type EmitTriad as E, type ExternalBundleOptions as a, type ExternalRegister as b, externalProducer as c, externalBundle as e };

package/dist/external-register-CWyroXb_.d.ts

@@ -0,0 +1,138 @@
+import { NodeOptions, Node } from '@graphrefly/pure-ts/core';
+
+/**
+ * External-register helpers — the common `register({emit, error, complete})`
+ * contract shared by webhook, MCP, syslog, StatsD, OTel and other callback-
+ * based integrations. Absorbs the `active` flag that every such adapter needs
+ * to guard against emits after teardown (§5.10 boundary pattern).
+ *
+ * Two shapes:
+ *
+ * - {@link externalProducer} — single channel. Lazy activation: the register
+ *   fn runs when the node gains its first subscriber; its returned cleanup
+ *   runs on deactivation.
+ *
+ * - {@link externalBundle} — multiple named channels. Eager activation: the
+ *   register fn runs at bundle construction time so externally-owned servers
+ *   (HTTP endpoints, UDP sockets) start accepting traffic immediately. A
+ *   shared refcount fires the returned cleanup once every channel has fully
+ *   torn down.
+ */
+
+type ExtraOpts = Omit<NodeOptions<unknown>, "describeKind">;
+/**
+ * Standard emit-triad passed to a single-channel external registrar.
+ *
+ * Post-teardown calls on any of these are automatically no-ops — the
+ * registrar does not need its own guard flag.
+ *
+ * @category extra
+ */
+type EmitTriad<T> = {
+    /** Emit a value as `DATA`. */
+    emit: (value: T) => void;
+    /** Terminate with `ERROR`. Subsequent `emit` / `error` / `complete` are ignored. */
+    error: (err: unknown) => void;
+    /** Terminate with `COMPLETE`. Subsequent `emit` / `error` / `complete` are ignored. */
+    complete: () => void;
+};
+/**
+ * Multi-channel emit bundle. Each declared channel name maps to an emit fn;
+ * `error` and `complete` terminate every channel atomically.
+ *
+ * @category extra
+ */
+type BundleTriad<TChannels extends Record<string, unknown>> = {
+    [K in keyof TChannels]: (value: TChannels[K]) => void;
+} & {
+    /** Terminate every channel with `ERROR`. */
+    error: (err: unknown) => void;
+    /** Terminate every channel with `COMPLETE`. */
+    complete: () => void;
+};
+/**
+ * Generic external registrator contract. The caller installs handlers into a
+ * third-party library / framework / server and optionally returns a cleanup
+ * callback. Returning `undefined` / `void` is equivalent to a no-op cleanup.
+ *
+ * @category extra
+ */
+type ExternalRegister<H> = (handlers: H) => (() => void) | undefined;
+/**
+ * Wraps a callback-style external integration as a reactive source.
+ *
+ * The registrar installs the supplied `emit` / `error` / `complete` handlers
+ * into the external SDK; post-teardown calls are silently dropped. Synchronous
+ * exceptions thrown by the registrar surface as terminal `ERROR`.
+ *
+ * @param register - Installs handlers. Optionally returns a cleanup fn.
+ * @param opts - Node options (name, equals, resubscribable, ...).
+ *
+ * @example
+ * ```ts
+ * import { externalProducer } from "@graphrefly/graphrefly-ts";
+ *
+ * const hook$ = externalProducer<Payload>(({ emit, error }) => {
+ *   const id = transport.onMessage((raw) => {
+ *     try { emit(parse(raw)); } catch (e) { error(e); }
+ *   });
+ *   return () => transport.off(id);
+ * });
+ * ```
+ *
+ * @category extra
+ */
+declare function externalProducer<T = unknown>(register: ExternalRegister<EmitTriad<T>>, opts?: ExtraOpts): Node<T>;
+/**
+ * Options for {@link externalBundle}.
+ *
+ * @category extra
+ */
+type ExternalBundleOptions<TChannels extends Record<string, unknown>> = {
+    /** Base name prefix for channel nodes; each node is named `${name}::${channel}`. */
+    name?: string;
+    /** Per-channel node options (equals, resubscribable, ...). */
+    channelOpts?: {
+        [K in keyof TChannels]?: ExtraOpts;
+    };
+};
+/**
+ * Multi-channel variant — one `Node<T>` per named channel, sharing a single
+ * registrar. Activation is eager: the registrar runs at construction time so
+ * externally-owned servers (HTTP, UDP, queue consumers) can start accepting
+ * traffic immediately. The returned cleanup fires once every channel has been
+ * subscribed and then fully deactivated (refcount-on-teardown).
+ *
+ * Any call to `error` or `complete` propagates to every channel atomically.
+ *
+ * @param register - Installs handlers for each channel plus shared error/complete.
+ * @param channels - Ordered channel names; determines the returned object shape.
+ * @param opts - Optional name prefix and per-channel node options.
+ *
+ * @example
+ * ```ts
+ * import { externalBundle } from "@graphrefly/graphrefly-ts";
+ *
+ * type OTelChannels = { traces: Span; metrics: Metric; logs: LogRec };
+ * const otel = externalBundle<OTelChannels>(
+ *   ({ traces, metrics, logs, error }) => {
+ *     app.post("/v1/traces",  (req, res) => { traces(req.body);  res.sendStatus(200); });
+ *     app.post("/v1/metrics", (req, res) => { metrics(req.body); res.sendStatus(200); });
+ *     app.post("/v1/logs",    (req, res) => { logs(req.body);    res.sendStatus(200); });
+ *     server.on("error", error);
+ *     return () => server.close();
+ *   },
+ *   ["traces", "metrics", "logs"],
+ * );
+ * otel.traces.subscribe(...);
+ * ```
+ *
+ * @category extra
+ */
+declare function externalBundle<TChannels extends Record<string, unknown>>(register: ExternalRegister<BundleTriad<TChannels>>, channels: readonly (keyof TChannels & string)[], opts?: ExternalBundleOptions<TChannels>): {
+    [K in keyof TChannels]: Node<TChannels[K]>;
+} & {
+    dispose(): void;
+};
+
+export { type BundleTriad as B, type EmitTriad as E, type ExternalBundleOptions as a, type ExternalRegister as b, externalProducer as c, externalBundle as e };