@graphrefly/graphrefly 0.1.0

package/dist/patterns/reactive-layout/index.d.cts

@@ -0,0 +1,3 @@
+export { B as BlockAdapters, C as CanvasMeasureAdapter, a as CanvasMeasureAdapterOptions, b as CanvasModule, c as CharPosition, d as CliMeasureAdapter, e as CliMeasureAdapterOptions, f as ContentBlock, I as ImageMeasurer, g as ImageSizeAdapter, L as LayoutLine, h as LineBreaksResult, M as MeasuredBlock, j as MeasurementAdapter, N as NodeCanvasMeasureAdapter, P as PositionedBlock, k as PrecomputedAdapter, l as PrecomputedAdapterOptions, m as PreparedSegment, R as ReactiveBlockLayoutBundle, n as ReactiveBlockLayoutOptions, o as ReactiveLayoutBundle, p as ReactiveLayoutOptions, S as SegmentBreakKind, q as SegmentMeasureStats, r as SvgBoundsAdapter, s as SvgMeasurer, t as analyzeAndMeasure, u as computeBlockFlow, v as computeCharPositions, w as computeLineBreaks, x as computeTotalHeight, y as measureBlock, z as measureBlocks, A as reactiveBlockLayout, D as reactiveLayout } from '../../index-C3BMRmmp.cjs';
+import '../../meta-BsF6Sag9.cjs';
+import '../../graph-CL_ZDAj9.cjs';

package/dist/patterns/reactive-layout/index.d.ts

@@ -0,0 +1,3 @@
+export { B as BlockAdapters, C as CanvasMeasureAdapter, a as CanvasMeasureAdapterOptions, b as CanvasModule, c as CharPosition, d as CliMeasureAdapter, e as CliMeasureAdapterOptions, f as ContentBlock, I as ImageMeasurer, g as ImageSizeAdapter, L as LayoutLine, h as LineBreaksResult, M as MeasuredBlock, j as MeasurementAdapter, N as NodeCanvasMeasureAdapter, P as PositionedBlock, k as PrecomputedAdapter, l as PrecomputedAdapterOptions, m as PreparedSegment, R as ReactiveBlockLayoutBundle, n as ReactiveBlockLayoutOptions, o as ReactiveLayoutBundle, p as ReactiveLayoutOptions, S as SegmentBreakKind, q as SegmentMeasureStats, r as SvgBoundsAdapter, s as SvgMeasurer, t as analyzeAndMeasure, u as computeBlockFlow, v as computeCharPositions, w as computeLineBreaks, x as computeTotalHeight, y as measureBlock, z as measureBlocks, A as reactiveBlockLayout, D as reactiveLayout } from '../../index-B7eOdgEx.js';
+import '../../meta-BsF6Sag9.js';
+import '../../graph-D18qmsNm.js';

package/dist/patterns/reactive-layout/index.js

@@ -0,0 +1,38 @@
+import {
+  CanvasMeasureAdapter,
+  CliMeasureAdapter,
+  ImageSizeAdapter,
+  NodeCanvasMeasureAdapter,
+  PrecomputedAdapter,
+  SvgBoundsAdapter,
+  analyzeAndMeasure,
+  computeBlockFlow,
+  computeCharPositions,
+  computeLineBreaks,
+  computeTotalHeight,
+  measureBlock,
+  measureBlocks,
+  reactiveBlockLayout,
+  reactiveLayout
+} from "../../chunk-Z4Y4FMQN.js";
+import "../../chunk-6W5SGIGB.js";
+import "../../chunk-O3PI7W45.js";
+import "../../chunk-5X3LAO3B.js";
+export {
+  CanvasMeasureAdapter,
+  CliMeasureAdapter,
+  ImageSizeAdapter,
+  NodeCanvasMeasureAdapter,
+  PrecomputedAdapter,
+  SvgBoundsAdapter,
+  analyzeAndMeasure,
+  computeBlockFlow,
+  computeCharPositions,
+  computeLineBreaks,
+  computeTotalHeight,
+  measureBlock,
+  measureBlocks,
+  reactiveBlockLayout,
+  reactiveLayout
+};
+//# sourceMappingURL=index.js.map

package/dist/patterns/reactive-layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/reactive-log-BfvfNWQh.d.cts

@@ -0,0 +1,137 @@
+import { Observable } from 'rxjs';
+import { i as Messages, N as Node } from './meta-BsF6Sag9.cjs';
+import { G as Graph, v as ObserveOptions } from './graph-CL_ZDAj9.cjs';
+
+/**
+ * Bridge a `Node<T>` to an RxJS `Observable<T>`.
+ *
+ * Emits the node's value on each `DATA` message. Maps `ERROR` to
+ * `subscriber.error()` and `COMPLETE` to `subscriber.complete()`.
+ * Protocol-internal signals (DIRTY, RESOLVED, PAUSE, etc.) are skipped.
+ *
+ * Unsubscribing the Observable unsubscribes the node.
+ */
+declare function toObservable<T>(node: Node<T>): Observable<T>;
+/**
+ * Bridge a `Node<T>` to an `Observable<Messages>` — raw message batches.
+ *
+ * Each emission is a full `[[Type, Data?], ...]` batch. The Observable
+ * terminates on ERROR or COMPLETE (the terminal batch is still emitted
+ * as the final `next()` before the Observable signal).
+ */
+declare function toMessages$<T>(node: Node<T>): Observable<Messages>;
+/**
+ * Observe a single node in a `Graph` as an `Observable<T>`.
+ *
+ * Equivalent to `toObservable(graph.resolve(path))` but routes through
+ * `graph.observe()` so actor guards are respected when provided.
+ */
+declare function observeNode$<T>(graph: Graph, path: string, options?: ObserveOptions): Observable<T>;
+/**
+ * Observe all nodes in a `Graph` as an `Observable<{ path, messages }>`.
+ *
+ * Each emission carries the qualified node path and the raw message batch.
+ * The Observable never self-completes (graphs are long-lived); dispose by
+ * unsubscribing.
+ */
+declare function observeGraph$(graph: Graph, options?: ObserveOptions): Observable<{
+    path: string;
+    messages: Messages;
+}>;
+
+/**
+ * Shared internals for roadmap §3.2 data structures (option B — versioned snapshots).
+ *
+ * @remarks
+ * Not re-exported from the package barrel; consumers use concrete factories
+ * (`reactiveMap`, …). Keeps `equals` / snapshot wiring consistent across
+ * collections without exposing a second public protocol.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+/**
+ * Immutable value paired with a monotonic version for {@link NodeOptions.equals}.
+ * Downstream nodes can treat unchanged versions as `RESOLVED`-eligible via `equals`.
+ *
+ * When the backing node has V0 versioning (GRAPHREFLY-SPEC §7), `v0` carries
+ * the node's identity (`id`) and version counter for diff-friendly observation
+ * and cross-snapshot dedup (roadmap §6.0b).
+ */
+type Versioned<T> = {
+    readonly version: number;
+    readonly value: T;
+    /** V0 identity from the backing node, when versioning is enabled. */
+    readonly v0?: {
+        readonly id: string;
+        readonly version: number;
+    };
+};
+
+type ReactiveLogSnapshot<T> = Versioned<{
+    entries: readonly T[];
+}>;
+type ReactiveLogOptions = {
+    name?: string;
+    maxSize?: number;
+};
+type ReactiveLogBundle<T> = {
+    /** Emits {@link ReactiveLogSnapshot} on each append/clear (two-phase). */
+    readonly entries: Node<ReactiveLogSnapshot<T>>;
+    append: (value: T) => void;
+    /** Push all values, trim once, emit one snapshot. */
+    appendMany: (values: readonly T[]) => void;
+    clear: () => void;
+    /** Remove the first `n` entries; emits snapshot. */
+    trimHead: (n: number) => void;
+    /** Last `n` entries (or fewer); updates when the log changes. */
+    tail: (n: number) => Node<readonly T[]>;
+};
+/**
+ * Creates an append-only reactive log with versioned tuple snapshots.
+ *
+ * @param initial - Optional seed entries (copied).
+ * @param options - Optional `name` for `describe()` / debugging.
+ * @returns Bundle with `entries` (state node), `append`, `clear`, and {@link ReactiveLogBundle.tail}.
+ *
+ * @remarks
+ * **Derived views:** {@link tail} and {@link logSlice} install an internal noop subscription so
+ * `get()` stays wired without an external sink; creating very many disposable derived nodes can
+ * retain subscriptions until the log bundle is unreachable.
+ *
+ * @example
+ * ```ts
+ * import { reactiveLog } from "@graphrefly/graphrefly-ts";
+ *
+ * const lg = reactiveLog<number>([1, 2], { name: "audit" });
+ * lg.append(3);
+ * lg.entries.subscribe((msgs) => console.log(msgs));
+ * ```
+ *
+ * @category extra
+ */
+declare function reactiveLog<T>(initial?: readonly T[], options?: ReactiveLogOptions): ReactiveLogBundle<T>;
+/**
+ * Builds a derived node for `entries.slice(start, stop)` (same semantics as `Array.prototype.slice`; `stop` exclusive).
+ *
+ * @param log - Log from {@link reactiveLog}.
+ * @param start - Start index (must be `>= 0`).
+ * @param stop - End index (exclusive); omit to slice to the end.
+ * @returns Derived node emitting the sliced readonly array.
+ *
+ * @example
+ * ```ts
+ * import { reactiveLog, logSlice } from "@graphrefly/graphrefly-ts";
+ *
+ * const lg = reactiveLog<number>([10, 20, 30, 40, 50]);
+ * const slice$ = logSlice(lg, 1, 4); // reactive view of [20, 30, 40]
+ * slice$.subscribe((msgs) => console.log(msgs));
+ *
+ * lg.append(60); // slice$ now reflects [20, 30, 40] (indices 1–3 of updated log)
+ * ```
+ *
+ * @category extra
+ */
+declare function logSlice<T>(log: ReactiveLogBundle<T>, start: number, stop?: number): Node<readonly T[]>;
+
+export { type ReactiveLogSnapshot as R, type Versioned as V, type ReactiveLogBundle as a, type ReactiveLogOptions as b, observeNode$ as c, toObservable as d, logSlice as l, observeGraph$ as o, reactiveLog as r, toMessages$ as t };

package/dist/reactive-log-ohLmTXoZ.d.ts

@@ -0,0 +1,137 @@
+import { Observable } from 'rxjs';
+import { i as Messages, N as Node } from './meta-BsF6Sag9.js';
+import { G as Graph, v as ObserveOptions } from './graph-D18qmsNm.js';
+
+/**
+ * Bridge a `Node<T>` to an RxJS `Observable<T>`.
+ *
+ * Emits the node's value on each `DATA` message. Maps `ERROR` to
+ * `subscriber.error()` and `COMPLETE` to `subscriber.complete()`.
+ * Protocol-internal signals (DIRTY, RESOLVED, PAUSE, etc.) are skipped.
+ *
+ * Unsubscribing the Observable unsubscribes the node.
+ */
+declare function toObservable<T>(node: Node<T>): Observable<T>;
+/**
+ * Bridge a `Node<T>` to an `Observable<Messages>` — raw message batches.
+ *
+ * Each emission is a full `[[Type, Data?], ...]` batch. The Observable
+ * terminates on ERROR or COMPLETE (the terminal batch is still emitted
+ * as the final `next()` before the Observable signal).
+ */
+declare function toMessages$<T>(node: Node<T>): Observable<Messages>;
+/**
+ * Observe a single node in a `Graph` as an `Observable<T>`.
+ *
+ * Equivalent to `toObservable(graph.resolve(path))` but routes through
+ * `graph.observe()` so actor guards are respected when provided.
+ */
+declare function observeNode$<T>(graph: Graph, path: string, options?: ObserveOptions): Observable<T>;
+/**
+ * Observe all nodes in a `Graph` as an `Observable<{ path, messages }>`.
+ *
+ * Each emission carries the qualified node path and the raw message batch.
+ * The Observable never self-completes (graphs are long-lived); dispose by
+ * unsubscribing.
+ */
+declare function observeGraph$(graph: Graph, options?: ObserveOptions): Observable<{
+    path: string;
+    messages: Messages;
+}>;
+
+/**
+ * Shared internals for roadmap §3.2 data structures (option B — versioned snapshots).
+ *
+ * @remarks
+ * Not re-exported from the package barrel; consumers use concrete factories
+ * (`reactiveMap`, …). Keeps `equals` / snapshot wiring consistent across
+ * collections without exposing a second public protocol.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+/**
+ * Immutable value paired with a monotonic version for {@link NodeOptions.equals}.
+ * Downstream nodes can treat unchanged versions as `RESOLVED`-eligible via `equals`.
+ *
+ * When the backing node has V0 versioning (GRAPHREFLY-SPEC §7), `v0` carries
+ * the node's identity (`id`) and version counter for diff-friendly observation
+ * and cross-snapshot dedup (roadmap §6.0b).
+ */
+type Versioned<T> = {
+    readonly version: number;
+    readonly value: T;
+    /** V0 identity from the backing node, when versioning is enabled. */
+    readonly v0?: {
+        readonly id: string;
+        readonly version: number;
+    };
+};
+
+type ReactiveLogSnapshot<T> = Versioned<{
+    entries: readonly T[];
+}>;
+type ReactiveLogOptions = {
+    name?: string;
+    maxSize?: number;
+};
+type ReactiveLogBundle<T> = {
+    /** Emits {@link ReactiveLogSnapshot} on each append/clear (two-phase). */
+    readonly entries: Node<ReactiveLogSnapshot<T>>;
+    append: (value: T) => void;
+    /** Push all values, trim once, emit one snapshot. */
+    appendMany: (values: readonly T[]) => void;
+    clear: () => void;
+    /** Remove the first `n` entries; emits snapshot. */
+    trimHead: (n: number) => void;
+    /** Last `n` entries (or fewer); updates when the log changes. */
+    tail: (n: number) => Node<readonly T[]>;
+};
+/**
+ * Creates an append-only reactive log with versioned tuple snapshots.
+ *
+ * @param initial - Optional seed entries (copied).
+ * @param options - Optional `name` for `describe()` / debugging.
+ * @returns Bundle with `entries` (state node), `append`, `clear`, and {@link ReactiveLogBundle.tail}.
+ *
+ * @remarks
+ * **Derived views:** {@link tail} and {@link logSlice} install an internal noop subscription so
+ * `get()` stays wired without an external sink; creating very many disposable derived nodes can
+ * retain subscriptions until the log bundle is unreachable.
+ *
+ * @example
+ * ```ts
+ * import { reactiveLog } from "@graphrefly/graphrefly-ts";
+ *
+ * const lg = reactiveLog<number>([1, 2], { name: "audit" });
+ * lg.append(3);
+ * lg.entries.subscribe((msgs) => console.log(msgs));
+ * ```
+ *
+ * @category extra
+ */
+declare function reactiveLog<T>(initial?: readonly T[], options?: ReactiveLogOptions): ReactiveLogBundle<T>;
+/**
+ * Builds a derived node for `entries.slice(start, stop)` (same semantics as `Array.prototype.slice`; `stop` exclusive).
+ *
+ * @param log - Log from {@link reactiveLog}.
+ * @param start - Start index (must be `>= 0`).
+ * @param stop - End index (exclusive); omit to slice to the end.
+ * @returns Derived node emitting the sliced readonly array.
+ *
+ * @example
+ * ```ts
+ * import { reactiveLog, logSlice } from "@graphrefly/graphrefly-ts";
+ *
+ * const lg = reactiveLog<number>([10, 20, 30, 40, 50]);
+ * const slice$ = logSlice(lg, 1, 4); // reactive view of [20, 30, 40]
+ * slice$.subscribe((msgs) => console.log(msgs));
+ *
+ * lg.append(60); // slice$ now reflects [20, 30, 40] (indices 1–3 of updated log)
+ * ```
+ *
+ * @category extra
+ */
+declare function logSlice<T>(log: ReactiveLogBundle<T>, start: number, stop?: number): Node<readonly T[]>;
+
+export { type ReactiveLogSnapshot as R, type Versioned as V, type ReactiveLogBundle as a, type ReactiveLogOptions as b, observeNode$ as c, toObservable as d, logSlice as l, observeGraph$ as o, reactiveLog as r, toMessages$ as t };

package/package.json

@@ -0,0 +1,256 @@
+{
+	"name": "@graphrefly/graphrefly",
+	"version": "0.1.0",
+	"packageManager": "pnpm@10.32.1+sha512.a706938f0e89ac1456b6563eab4edf1d1faf3368d1191fc5c59790e96dc918e4456ab2e67d613de1043d2e8c81f87303e6b40d4ffeca9df15ef1ad567348f2be",
+	"description": "Reactive graph protocol for human + LLM co-operation. Composable nodes, glitch-free diamond resolution, two-phase push, framework adapters (React/Vue/Svelte/Solid/NestJS), durable streaming. Zero dependencies.",
+	"type": "module",
+	"sideEffects": false,
+	"main": "dist/index.cjs",
+	"module": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		},
+		"./core": {
+			"import": {
+				"types": "./dist/core/index.d.ts",
+				"default": "./dist/core/index.js"
+			},
+			"require": {
+				"types": "./dist/core/index.d.cts",
+				"default": "./dist/core/index.cjs"
+			}
+		},
+		"./extra": {
+			"import": {
+				"types": "./dist/extra/index.d.ts",
+				"default": "./dist/extra/index.js"
+			},
+			"require": {
+				"types": "./dist/extra/index.d.cts",
+				"default": "./dist/extra/index.cjs"
+			}
+		},
+		"./graph": {
+			"import": {
+				"types": "./dist/graph/index.d.ts",
+				"default": "./dist/graph/index.js"
+			},
+			"require": {
+				"types": "./dist/graph/index.d.cts",
+				"default": "./dist/graph/index.cjs"
+			}
+		},
+		"./compat": {
+			"import": {
+				"types": "./dist/compat/index.d.ts",
+				"default": "./dist/compat/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/index.d.cts",
+				"default": "./dist/compat/index.cjs"
+			}
+		},
+		"./compat/jotai": {
+			"import": {
+				"types": "./dist/compat/jotai/index.d.ts",
+				"default": "./dist/compat/jotai/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/jotai/index.d.cts",
+				"default": "./dist/compat/jotai/index.cjs"
+			}
+		},
+		"./compat/zustand": {
+			"import": {
+				"types": "./dist/compat/zustand/index.d.ts",
+				"default": "./dist/compat/zustand/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/zustand/index.d.cts",
+				"default": "./dist/compat/zustand/index.cjs"
+			}
+		},
+		"./compat/react": {
+			"import": {
+				"types": "./dist/compat/react/index.d.ts",
+				"default": "./dist/compat/react/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/react/index.d.cts",
+				"default": "./dist/compat/react/index.cjs"
+			}
+		},
+		"./compat/vue": {
+			"import": {
+				"types": "./dist/compat/vue/index.d.ts",
+				"default": "./dist/compat/vue/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/vue/index.d.cts",
+				"default": "./dist/compat/vue/index.cjs"
+			}
+		},
+		"./compat/svelte": {
+			"import": {
+				"types": "./dist/compat/svelte/index.d.ts",
+				"default": "./dist/compat/svelte/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/svelte/index.d.cts",
+				"default": "./dist/compat/svelte/index.cjs"
+			}
+		},
+		"./compat/solid": {
+			"import": {
+				"types": "./dist/compat/solid/index.d.ts",
+				"default": "./dist/compat/solid/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/solid/index.d.cts",
+				"default": "./dist/compat/solid/index.cjs"
+			}
+		},
+		"./compat/nestjs": {
+			"import": {
+				"types": "./dist/compat/nestjs/index.d.ts",
+				"default": "./dist/compat/nestjs/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/nestjs/index.d.cts",
+				"default": "./dist/compat/nestjs/index.cjs"
+			}
+		},
+		"./reactive-layout": {
+			"import": {
+				"types": "./dist/patterns/reactive-layout/index.d.ts",
+				"default": "./dist/patterns/reactive-layout/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/reactive-layout/index.d.cts",
+				"default": "./dist/patterns/reactive-layout/index.cjs"
+			}
+		}
+	},
+	"files": [
+		"dist",
+		"LICENSE"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"prepublishOnly": "pnpm run build",
+		"docs:dev": "pnpm --dir website dev",
+		"docs:build": "pnpm --dir website build",
+		"docs:preview": "pnpm --dir website preview",
+		"build": "tsup",
+		"test": "vitest run",
+		"bench": "vitest bench",
+		"bench:baseline": "vitest bench --outputJson benchmarks/vitest-baseline.json",
+		"test:watch": "vitest",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"format": "biome format --write ."
+	},
+	"keywords": [
+		"reactive",
+		"graph",
+		"state-management",
+		"signals",
+		"streaming",
+		"llm",
+		"ai-agents",
+		"observable",
+		"derived-state",
+		"diamond-resolution",
+		"orchestration",
+		"durable-workflow",
+		"callbag",
+		"framework-agnostic",
+		"react",
+		"vue",
+		"svelte",
+		"solid",
+		"nestjs",
+		"zero-dependency"
+	],
+	"license": "MIT",
+	"peerDependencies": {
+		"react": ">=18",
+		"react-dom": ">=18",
+		"solid-js": ">=1",
+		"svelte": ">=4",
+		"vue": ">=3",
+		"@nestjs/common": ">=10",
+		"rxjs": ">=7"
+	},
+	"peerDependenciesMeta": {
+		"react": {
+			"optional": true
+		},
+		"react-dom": {
+			"optional": true
+		},
+		"solid-js": {
+			"optional": true
+		},
+		"svelte": {
+			"optional": true
+		},
+		"vue": {
+			"optional": true
+		},
+		"@nestjs/common": {
+			"optional": true
+		},
+		"rxjs": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/commit-analyzer": "^13.0.0",
+		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/github": "^11.0.0",
+		"@semantic-release/npm": "^12.0.0",
+		"@semantic-release/release-notes-generator": "^14.0.1",
+		"@biomejs/biome": "2.4.6",
+		"@nestjs/common": "^11.1.17",
+		"@nestjs/core": "^11.1.17",
+		"@nestjs/testing": "^11.1.17",
+		"@solidjs/testing-library": "^0.8.10",
+		"@testing-library/react": "^16.3.2",
+		"@testing-library/svelte": "^5.3.1",
+		"@testing-library/vue": "^8.1.0",
+		"@types/node": "^25.5.0",
+		"@types/react": "^19.2.14",
+		"@types/react-dom": "^19.2.3",
+		"jsdom": "^29.0.1",
+		"react": "^19.2.4",
+		"react-dom": "^19.2.4",
+		"reflect-metadata": "^0.2.2",
+		"rxjs": "^7.8.2",
+		"solid-js": "^1.9.12",
+		"svelte": "^5.55.1",
+		"semantic-release": "^24.0.0",
+		"tsup": "^8.5.1",
+		"typescript": "^5.7.0",
+		"vitest": "^3.0.0",
+		"vue": "^3.5.31"
+	},
+	"pnpm": {
+		"onlyBuiltDependencies": [
+			"@biomejs/biome",
+			"esbuild"
+		]
+	}
+}