@graphrefly/graphrefly 0.45.0 → 0.46.0

package/dist/chunk-MLTPJMH6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/demo-shell/index.ts"],"sourcesContent":["/**\n * Three-pane demo shell (roadmap §7.2).\n *\n * A `Graph(\"demo-shell\")` that dogfoods reactive coordination for the\n * main/side split layout with synchronized cross-highlighting.\n *\n * **Zero framework dependency** — framework bindings wrap pane components only.\n * The shell graph is headless and fully testable.\n */\n\nimport { batch, node } from \"@graphrefly/pure-ts/core\";\nimport { Graph } from \"@graphrefly/pure-ts/graph\";\nimport { graphSpecToMermaid } from \"../../base/render/index.js\";\nimport type { MeasurementAdapter } from \"../reactive-layout/reactive-layout.js\";\nimport { analyzeAndMeasure, computeLineBreaks } from \"../reactive-layout/reactive-layout.js\";\n\n// ——————————————————————————————————————————————————————————\n//  Types\n// ——————————————————————————————————————————————————————————\n\n/** Identifies which pane is the source of a hover event. */\nexport type HoverPaneType = \"visual\" | \"graph\" | \"code\";\n\n/** Cross-highlighting hover target. `null` means nothing hovered. */\nexport type HoverTarget = { pane: HoverPaneType; id: string } | null;\n\n/** Which pane is full-screened (null = normal layout). */\nexport type FullscreenPane = \"main\" | \"graph\" | \"code\" | null;\n\n/**\n * Cross-referencing registry: maps node paths to code line numbers and\n * visual element selectors. Provided by each demo's `store.ts`.\n */\nexport type NodeRegistry = Map<string, { codeLine: number; visualSelector: string }>;\n\n/** Callbacks for cross-highlighting effect nodes. */\nexport type HighlightCallbacks = {\n\t/** Called when code-scroll highlight target changes. */\n\tcodeScroll?: (line: number | null) => void;\n\t/** Called when visual highlight target changes. */\n\tvisual?: (selector: string | null) => void;\n\t/** Called when graph highlight target changes. */\n\tgraph?: (nodeId: string | null) => void;\n};\n\n/** Label dimensions for graph node sizing. */\nexport type GraphLabelSize = { width: number; height: number };\n\n/** Options for {@link demoShell}. */\nexport type DemoShellOptions = {\n\t/** Initial main/side split ratio (0–1). Default: `0.65`. */\n\tmainRatio?: number;\n\t/** Initial graph/code vertical split in the side pane (0–1). Default: `0.5`. */\n\tsideSplit?: number;\n\t/** Initial viewport width in pixels. Default: `1280`. */\n\tviewportWidth?: number;\n\t/** Cross-referencing registry for hover→code/visual/graph mapping. */\n\tnodeRegistry?: NodeRegistry;\n\t/** Measurement adapter for layout engine integration. When provided, enables layout/* derived nodes. */\n\tadapter?: MeasurementAdapter;\n\t/** Font string for layout measurement. Default: `\"14px monospace\"`. */\n\tlayoutFont?: string;\n\t/** Callbacks for cross-highlighting effect nodes. When provided, creates effect nodes visible in describe(). */\n\tonHighlight?: HighlightCallbacks;\n};\n\n/** Return type of {@link demoShell}. */\nexport type DemoShellHandle = {\n\t/** The demo-shell graph. */\n\tgraph: Graph;\n\n\t// ── Convenience setters (shorthand for graph.set) ──────────\n\tsetMainRatio(ratio: number): void;\n\tsetSideSplit(ratio: number): void;\n\tsetFullscreen(pane: FullscreenPane): void;\n\tsetViewportWidth(width: number): void;\n\tsetHoverTarget(target: HoverTarget): void;\n\tsetDemoGraph(g: Graph | null): void;\n\tbumpGraphTick(): void;\n\tselectNode(path: string | null): void;\n\tsetMetaDebug(on: boolean): void;\n\t/** Set code text for layout/code-lines measurement (requires adapter). */\n\tsetCodeText(text: string): void;\n\t/** Atomic multi-set — wraps core `batch()` for glitch-free updates. */\n\tbatch(fn: () => void): void;\n\tdestroy(): void;\n};\n\n// ——————————————————————————————————————————————————————————\n//  Helpers\n// ——————————————————————————————————————————————————————————\n\nfunction clamp01(v: number): number {\n\treturn Math.max(0, Math.min(1, v));\n}\n\n// ——————————————————————————————————————————————————————————\n//  Factory\n// ——————————————————————————————————————————————————————————\n\n/**\n * Creates the three-pane demo shell graph (roadmap §7.2).\n *\n * All coordination is reactive — no polling, no imperative triggers.\n * Framework bindings subscribe to named nodes and drive `state` inputs.\n */\nexport function demoShell(opts?: DemoShellOptions): DemoShellHandle {\n\tconst mainRatioInit = clamp01(opts?.mainRatio ?? 0.65);\n\tconst sideSplitInit = clamp01(opts?.sideSplit ?? 0.5);\n\tconst viewportInit = Math.max(0, opts?.viewportWidth ?? 1280);\n\tconst registry = opts?.nodeRegistry ?? new Map();\n\tconst adapter = opts?.adapter ?? null;\n\tconst layoutFont = opts?.layoutFont ?? \"14px monospace\";\n\tconst onHighlight = opts?.onHighlight;\n\n\tconst g = new Graph(\"demo-shell\");\n\n\t// ── Layout state ─────────────────────────────────────\n\tconst paneMainRatio = node([], { ...{ name: \"pane/main-ratio\" }, initial: mainRatioInit });\n\tconst paneSideSplit = node([], { ...{ name: \"pane/side-split\" }, initial: sideSplitInit });\n\tconst paneFullscreen = node<FullscreenPane>([], {\n\t\t...{\n\t\t\tname: \"pane/fullscreen\",\n\t\t},\n\t\tinitial: null,\n\t});\n\tconst viewportWidth = node([], { ...{ name: \"viewport/width\" }, initial: viewportInit });\n\n\tg.add(paneMainRatio, { name: \"pane/main-ratio\" });\n\tg.add(paneSideSplit, { name: \"pane/side-split\" });\n\tg.add(paneFullscreen, { name: \"pane/fullscreen\" });\n\tg.add(viewportWidth, { name: \"viewport/width\" });\n\n\t// ── Derived pane dimensions ──────────────────────────\n\tconst paneMainWidth = node(\n\t\t[paneMainRatio, viewportWidth, paneFullscreen],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst r = data[0] as number;\n\t\t\tconst w = data[1] as number;\n\t\t\tconst fullscreen = data[2] as FullscreenPane;\n\t\t\tif (fullscreen === \"main\") actions.emit(w);\n\t\t\telse if (fullscreen === \"graph\" || fullscreen === \"code\") actions.emit(0);\n\t\t\telse actions.emit(Math.round(w * r));\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"pane/main-width\" } },\n\t);\n\n\tconst paneSideWidth = node(\n\t\t[paneMainWidth, viewportWidth, paneFullscreen],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst main = data[0] as number;\n\t\t\tconst w = data[1] as number;\n\t\t\tconst fullscreen = data[2] as FullscreenPane;\n\t\t\tif (fullscreen === \"main\") actions.emit(0);\n\t\t\telse if (fullscreen === \"graph\" || fullscreen === \"code\") actions.emit(w);\n\t\t\telse actions.emit(w - main);\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"pane/side-width\" } },\n\t);\n\n\tconst paneGraphHeight = node(\n\t\t[paneSideSplit, paneFullscreen],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst split = data[0] as number;\n\t\t\tconst fullscreen = data[1] as FullscreenPane;\n\t\t\tif (fullscreen === \"graph\") actions.emit(1);\n\t\t\telse if (fullscreen === \"code\") actions.emit(0);\n\t\t\telse if (fullscreen === \"main\") actions.emit(0);\n\t\t\telse actions.emit(clamp01(split));\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"pane/graph-height-ratio\" } },\n\t);\n\n\tconst paneCodeHeight = node(\n\t\t[paneGraphHeight, paneFullscreen],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst graphH = data[0] as number;\n\t\t\tconst fullscreen = data[1] as FullscreenPane;\n\t\t\tif (fullscreen === \"code\") actions.emit(1);\n\t\t\telse if (fullscreen === \"graph\" || fullscreen === \"main\") actions.emit(0);\n\t\t\telse actions.emit(1 - graphH);\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"pane/code-height-ratio\" } },\n\t);\n\n\tg.add(paneMainWidth, { name: \"pane/main-width\" });\n\tg.add(paneSideWidth, { name: \"pane/side-width\" });\n\tg.add(paneGraphHeight, { name: \"pane/graph-height-ratio\" });\n\tg.add(paneCodeHeight, { name: \"pane/code-height-ratio\" });\n\n\t// ── External graph observation ───────────────────────\n\tconst demoGraphRef = node<Graph | null>([], {\n\t\t...{\n\t\t\tname: \"demo/graph-ref\",\n\t\t},\n\t\tinitial: null,\n\t});\n\tconst demoGraphTick = node([], { ...{ name: \"demo/graph-tick\" }, initial: 0 });\n\n\tg.add(demoGraphRef, { name: \"demo/graph-ref\" });\n\tg.add(demoGraphTick, { name: \"demo/graph-tick\" });\n\n\tconst graphMermaid = node(\n\t\t[demoGraphRef, demoGraphTick],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst demo = data[0] as Graph | null;\n\t\t\tactions.emit(demo ? graphSpecToMermaid(demo.describe()) : \"\");\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"graph/mermaid\" } },\n\t);\n\n\tconst graphDescribe = node(\n\t\t[demoGraphRef, demoGraphTick],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst demo = data[0] as Graph | null;\n\t\t\tif (!demo) {\n\t\t\t\tactions.emit(null);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst { expand: _, ...snapshot } = demo.describe({ detail: \"standard\" });\n\t\t\tactions.emit(snapshot);\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"graph/describe\" } },\n\t);\n\n\tg.add(graphMermaid, { name: \"graph/mermaid\" });\n\tg.add(graphDescribe, { name: \"graph/describe\" });\n\n\t// ── Cross-highlighting ───────────────────────────────\n\tconst hoverTarget = node<HoverTarget>([], { ...{ name: \"hover/target\" }, initial: null });\n\tg.add(hoverTarget, { name: \"hover/target\" });\n\n\tconst highlightCodeScroll = node(\n\t\t[hoverTarget],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst t = data[0] as HoverTarget;\n\t\t\tif (!t) {\n\t\t\t\tactions.emit(null);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst entry = registry.get(t.id);\n\t\t\tactions.emit(entry ? entry.codeLine : null);\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"highlight/code-scroll\" } },\n\t);\n\n\tconst highlightVisual = node(\n\t\t[hoverTarget],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst t = data[0] as HoverTarget;\n\t\t\tif (!t) {\n\t\t\t\tactions.emit(null);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst entry = registry.get(t.id);\n\t\t\tactions.emit(entry ? entry.visualSelector : null);\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"highlight/visual\" } },\n\t);\n\n\tconst highlightGraph = node(\n\t\t[hoverTarget],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst t = data[0] as HoverTarget;\n\t\t\tactions.emit(t ? t.id : null);\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"highlight/graph\" } },\n\t);\n\n\tg.add(highlightCodeScroll, { name: \"highlight/code-scroll\" });\n\tg.add(highlightVisual, { name: \"highlight/visual\" });\n\tg.add(highlightGraph, { name: \"highlight/graph\" });\n\n\t// ── Cross-highlighting effect nodes (optional) ─────\n\t// Created when onHighlight callbacks are provided, making the full\n\t// source→derived→effect chain visible in describe()/graphSpecToMermaid().\n\n\tif (onHighlight?.codeScroll) {\n\t\tconst cb = onHighlight.codeScroll;\n\t\tconst applyCodeScroll = node(\n\t\t\t[highlightCodeScroll],\n\t\t\t(batchData, _actions, ctx) => {\n\t\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t\t);\n\t\t\t\tcb(data[0] as number | null);\n\t\t\t},\n\t\t\t{ describeKind: \"effect\" },\n\t\t);\n\t\tg.add(applyCodeScroll, { name: \"highlight/apply-code-scroll\" });\n\t}\n\n\tif (onHighlight?.visual) {\n\t\tconst cb = onHighlight.visual;\n\t\tconst applyVisual = node(\n\t\t\t[highlightVisual],\n\t\t\t(batchData, _actions, ctx) => {\n\t\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t\t);\n\t\t\t\tcb(data[0] as string | null);\n\t\t\t},\n\t\t\t{ describeKind: \"effect\" },\n\t\t);\n\t\tg.add(applyVisual, { name: \"highlight/apply-visual\" });\n\t}\n\n\tif (onHighlight?.graph) {\n\t\tconst cb = onHighlight.graph;\n\t\tconst applyGraph = node(\n\t\t\t[highlightGraph],\n\t\t\t(batchData, _actions, ctx) => {\n\t\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t\t);\n\t\t\t\tcb(data[0] as string | null);\n\t\t\t},\n\t\t\t{ describeKind: \"effect\" },\n\t\t);\n\t\tg.add(applyGraph, { name: \"highlight/apply-graph\" });\n\t}\n\n\t// ── Inspect panel ────────────────────────────────────\n\tconst inspectSelected = node<string | null>([], {\n\t\t...{\n\t\t\tname: \"inspect/selected-node\",\n\t\t},\n\t\tinitial: null,\n\t});\n\tg.add(inspectSelected, { name: \"inspect/selected-node\" });\n\n\tconst inspectNodeDetail = node(\n\t\t[inspectSelected, demoGraphRef, demoGraphTick],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst p = data[0] as string | null;\n\t\t\tconst demo = data[1] as Graph | null;\n\t\t\tif (!demo || !p) {\n\t\t\t\tactions.emit(null);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst snap = demo.describe({ detail: \"standard\" });\n\t\t\t\tconst nodeDesc = snap.nodes[p];\n\t\t\t\tif (!nodeDesc) {\n\t\t\t\t\tactions.emit(null);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tactions.emit({ path: p, ...nodeDesc });\n\t\t\t} catch {\n\t\t\t\tactions.emit(null);\n\t\t\t}\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"inspect/node-detail\" } },\n\t);\n\n\tconst inspectTraceLog = node(\n\t\t[demoGraphRef, demoGraphTick],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tconst demo = data[0] as Graph | null;\n\t\t\tactions.emit(demo ? demo.trace() : []);\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"inspect/trace-log\" } },\n\t);\n\n\tg.add(inspectNodeDetail, { name: \"inspect/node-detail\" });\n\tg.add(inspectTraceLog, { name: \"inspect/trace-log\" });\n\n\t// ── Meta debug toggle ────────────────────────────────\n\tconst metaDebug = node([], { ...{ name: \"meta/debug\" }, initial: false });\n\tg.add(metaDebug, { name: \"meta/debug\" });\n\n\tconst metaShellMermaid = node(\n\t\t[metaDebug, demoGraphTick],\n\t\t(batchData, actions, ctx) => {\n\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t);\n\t\t\tactions.emit((data[0] as boolean) ? graphSpecToMermaid(g.describe()) : \"\");\n\t\t},\n\t\t{ describeKind: \"derived\", ...{ name: \"meta/shell-mermaid\" } },\n\t);\n\tg.add(metaShellMermaid, { name: \"meta/shell-mermaid\" });\n\n\t// ── Layout engine integration (optional, requires adapter) ──\n\tconst codeTextNode = node([], { ...{ name: \"layout/code-text\" }, initial: \"\" });\n\tg.add(codeTextNode, { name: \"layout/code-text\" });\n\n\tif (adapter) {\n\t\tconst measureCache = new Map<string, Map<string, number>>();\n\n\t\tconst graphLabels = node(\n\t\t\t[graphDescribe],\n\t\t\t(batchData, actions, ctx) => {\n\t\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t\t);\n\t\t\t\tconst d = data[0] as { nodes: Record<string, { type: string }> } | null;\n\t\t\t\tif (!d) {\n\t\t\t\t\tactions.emit(new Map<string, GraphLabelSize>());\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst result = new Map<string, GraphLabelSize>();\n\t\t\t\tfor (const [name] of Object.entries(d.nodes)) {\n\t\t\t\t\tconst segments = analyzeAndMeasure(name, layoutFont, adapter, measureCache);\n\t\t\t\t\tconst lb = computeLineBreaks(segments, Infinity, adapter, layoutFont, measureCache);\n\t\t\t\t\tconst width = lb.lines.reduce((max, l) => Math.max(max, l.width), 0);\n\t\t\t\t\tconst height = lb.lineCount * 20; // line-height approximation\n\t\t\t\t\tresult.set(name, { width, height });\n\t\t\t\t}\n\t\t\t\tactions.emit(result);\n\t\t\t},\n\t\t\t{\n\t\t\t\tdescribeKind: \"derived\",\n\t\t\t\t...{\n\t\t\t\t\tname: \"layout/graph-labels\",\n\t\t\t\t\tequals: (a, b) => {\n\t\t\t\t\t\tif (a === b) return true;\n\t\t\t\t\t\tconst ma = a as Map<string, GraphLabelSize>;\n\t\t\t\t\t\tconst mb = b as Map<string, GraphLabelSize>;\n\t\t\t\t\t\tif (ma.size !== mb.size) return false;\n\t\t\t\t\t\tfor (const [k, v] of ma) {\n\t\t\t\t\t\t\tconst bv = mb.get(k);\n\t\t\t\t\t\t\tif (!bv || bv.width !== v.width || bv.height !== v.height) return false;\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t);\n\n\t\tconst codeLines = node(\n\t\t\t[codeTextNode, paneSideWidth],\n\t\t\t(batchData, actions, ctx) => {\n\t\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t\t);\n\t\t\t\tconst t = data[0] as string;\n\t\t\t\tif (!t) {\n\t\t\t\t\tactions.emit({ lineCount: 0, lines: [] });\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst segments = analyzeAndMeasure(t, layoutFont, adapter, measureCache);\n\t\t\t\tconst maxW = (data[1] as number) - 40; // side pane minus padding\n\t\t\t\tactions.emit(\n\t\t\t\t\tcomputeLineBreaks(segments, Math.max(100, maxW), adapter, layoutFont, measureCache),\n\t\t\t\t);\n\t\t\t},\n\t\t\t{ describeKind: \"derived\", name: \"layout/code-lines\" },\n\t\t);\n\n\t\tconst sideWidthHint = node(\n\t\t\t[graphLabels],\n\t\t\t(batchData, actions, ctx) => {\n\t\t\t\tconst data = batchData.map((batch, i) =>\n\t\t\t\t\tbatch != null && batch.length > 0 ? batch.at(-1) : ctx.prevData[i],\n\t\t\t\t);\n\t\t\t\tconst m = data[0] as Map<string, GraphLabelSize>;\n\t\t\t\tif (m.size === 0) {\n\t\t\t\t\tactions.emit(200);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tlet maxW = 0;\n\t\t\t\tfor (const { width } of m.values()) {\n\t\t\t\t\tif (width > maxW) maxW = width;\n\t\t\t\t}\n\t\t\t\t// widest label + padding (node box chrome + margin)\n\t\t\t\tactions.emit(Math.max(200, Math.round(maxW + 80)));\n\t\t\t},\n\t\t\t{ describeKind: \"derived\", name: \"layout/side-width-hint\" },\n\t\t);\n\n\t\tg.add(graphLabels, { name: \"layout/graph-labels\" });\n\t\tg.add(codeLines, { name: \"layout/code-lines\" });\n\t\tg.add(sideWidthHint, { name: \"layout/side-width-hint\" });\n\t}\n\n\t// ── Edges (explicit wiring for describe/graphSpecToMermaid) ───\n\n\t// ── Handle ───────────────────────────────────────────\n\tlet tickCounter = 0;\n\treturn {\n\t\tgraph: g,\n\t\tsetMainRatio(ratio: number) {\n\t\t\tg.set(\"pane/main-ratio\", clamp01(ratio));\n\t\t},\n\t\tsetSideSplit(ratio: number) {\n\t\t\tg.set(\"pane/side-split\", clamp01(ratio));\n\t\t},\n\t\tsetFullscreen(pane: FullscreenPane) {\n\t\t\tg.set(\"pane/fullscreen\", pane);\n\t\t},\n\t\tsetViewportWidth(width: number) {\n\t\t\tg.set(\"viewport/width\", Math.max(0, width));\n\t\t},\n\t\tsetHoverTarget(target: HoverTarget) {\n\t\t\tg.set(\"hover/target\", target);\n\t\t},\n\t\tsetDemoGraph(demo: Graph | null) {\n\t\t\tg.set(\"demo/graph-ref\", demo);\n\t\t},\n\t\tbumpGraphTick() {\n\t\t\tg.set(\"demo/graph-tick\", ++tickCounter);\n\t\t},\n\t\tselectNode(path: string | null) {\n\t\t\tg.set(\"inspect/selected-node\", path);\n\t\t},\n\t\tsetMetaDebug(on: boolean) {\n\t\t\tg.set(\"meta/debug\", on);\n\t\t},\n\t\tsetCodeText(text: string) {\n\t\t\tg.set(\"layout/code-text\", text);\n\t\t},\n\t\tbatch(fn: () => void) {\n\t\t\tbatch(fn);\n\t\t},\n\t\tdestroy() {\n\t\t\tg.destroy();\n\t\t},\n\t};\n}\n"],"mappings":"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","names":["batch"]}

package/dist/chunk-N3SZ7BMH.js

@@ -0,0 +1,95 @@
+import {
+  __export
+} from "./chunk-AZDQPQ3V.js";
+
+// src/compat/svelte/index.ts
+var svelte_exports = {};
+__export(svelte_exports, {
+  useStore: () => useStore,
+  useSubscribe: () => useSubscribe,
+  useSubscribeRecord: () => useSubscribeRecord
+});
+import { DATA, DIRTY, RESOLVED } from "@graphrefly/pure-ts/core";
+function useSubscribe(node) {
+  return {
+    subscribe(run) {
+      const unsub = node.subscribe(() => {
+        run(node.cache);
+      });
+      run(node.cache);
+      return unsub;
+    }
+  };
+}
+function useStore(node) {
+  return {
+    subscribe(run) {
+      const unsub = node.subscribe(() => {
+        run(node.cache);
+      });
+      run(node.cache);
+      return unsub;
+    },
+    set(value) {
+      node.down([[DIRTY], [DATA, value]]);
+    },
+    update(updater) {
+      const next = updater(node.cache);
+      node.down([[DIRTY], [DATA, next]]);
+    }
+  };
+}
+function useSubscribeRecord(keysNode, factory) {
+  return {
+    subscribe(run) {
+      let entrySubs = [];
+      const cleanupEntries = () => {
+        for (const unsub of entrySubs) unsub();
+        entrySubs = [];
+      };
+      const buildSnapshot = () => {
+        const snap = {};
+        for (const key of keysNode.cache ?? []) {
+          const nodes = factory(key);
+          const values = {};
+          for (const field of Object.keys(nodes)) {
+            values[field] = nodes[field].cache;
+          }
+          snap[key] = values;
+        }
+        return snap;
+      };
+      const sync = (nextKeys) => {
+        cleanupEntries();
+        for (const key of nextKeys) {
+          const nodes = factory(key);
+          for (const field of Object.keys(nodes)) {
+            const unsub = nodes[field].subscribe(() => {
+              run(buildSnapshot());
+            });
+            entrySubs.push(unsub);
+          }
+        }
+        run(buildSnapshot());
+      };
+      const keysUnsub = keysNode.subscribe((msgs) => {
+        if (msgs.some((m) => m[0] === DATA || m[0] === RESOLVED)) {
+          sync(keysNode.cache ?? []);
+        }
+      });
+      sync(keysNode.cache ?? []);
+      return () => {
+        keysUnsub();
+        cleanupEntries();
+      };
+    }
+  };
+}
+
+export {
+  useSubscribe,
+  useStore,
+  useSubscribeRecord,
+  svelte_exports
+};
+//# sourceMappingURL=chunk-N3SZ7BMH.js.map

package/dist/chunk-N3SZ7BMH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compat/svelte/index.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Svelte bindings — useSubscribe / useStore\n// ---------------------------------------------------------------------------\n// Bridges GraphReFly nodes into Svelte's store contract. Works with any\n// Node<T>, including companion nodes (node.meta.status).\n//\n// Usage:\n//   import { useSubscribe, useStore } from '@graphrefly/graphrefly-ts/compat/svelte';\n//   // Optional peer install (only for this adapter): pnpm add svelte\n//   const status = useSubscribe(wsStatusNode);   // Svelte readable store\n//   const count = useStore(countNode);           // Svelte writable store\n//   // In template: $status, $count\n//   // $count = 42\n// ---------------------------------------------------------------------------\n\nimport { DATA, DIRTY, type Messages, type Node, RESOLVED } from \"@graphrefly/pure-ts/core\";\n\n/** Svelte store contract — implements the minimal `subscribe` method. */\nexport interface SvelteReadable<T> {\n\tsubscribe(run: (value: T) => void): () => void;\n}\n\n/** Svelte writable store contract. */\nexport interface SvelteWritable<T> extends SvelteReadable<T> {\n\tset(value: T): void;\n\tupdate(updater: (value: T) => T): void;\n}\n\n/**\n * Subscribe to a `Node<T>` as a Svelte readable store (implements Svelte store contract).\n * Subscription lifecycle is tied to Svelte store unsubscription (not node terminal messages).\n */\nexport function useSubscribe<T>(node: Node<T>): SvelteReadable<T | undefined | null> {\n\treturn {\n\t\tsubscribe(run: (value: T | undefined | null) => void): () => void {\n\t\t\tconst unsub = node.subscribe(() => {\n\t\t\t\trun(node.cache);\n\t\t\t});\n\t\t\trun(node.cache);\n\t\t\treturn unsub;\n\t\t},\n\t};\n}\n\n/**\n * Bind a writable `Node<T>` as a Svelte writable store.\n * Reads and writes adapt seamlessly.\n * Setter/update always forward `[[DIRTY], [DATA, value]]`, including `value === undefined`.\n * Subscription lifecycle is tied to Svelte store unsubscription (not node terminal messages).\n */\nexport function useStore<T>(node: Node<T>): SvelteWritable<T | undefined | null> {\n\treturn {\n\t\tsubscribe(run: (value: T | undefined | null) => void): () => void {\n\t\t\tconst unsub = node.subscribe(() => {\n\t\t\t\trun(node.cache);\n\t\t\t});\n\t\t\trun(node.cache);\n\t\t\treturn unsub;\n\t\t},\n\t\tset(value: T | undefined | null) {\n\t\t\tnode.down([[DIRTY], [DATA, value]]);\n\t\t},\n\t\tupdate(updater: (value: T | undefined | null) => T | undefined | null) {\n\t\t\tconst next = updater(node.cache);\n\t\t\tnode.down([[DIRTY], [DATA, next]]);\n\t\t},\n\t};\n}\n\n/** Maps a key to an object of nodes. Used by `useSubscribeRecord`. */\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 keyed record of nodes as a Svelte readable store.\n * Re-subscribes all per-key fields whenever `keysNode` changes.\n * Key re-sync is gated to settled batches (`messageTier >= 3`) to avoid DIRTY-phase churn.\n */\nexport function useSubscribeRecord<K extends string, R extends Record<string, any>>(\n\tkeysNode: Node<K[]>,\n\tfactory: NodeFactory<K, R>,\n): SvelteReadable<Record<K, R>> {\n\treturn {\n\t\tsubscribe(run: (value: Record<K, R>) => void): () => void {\n\t\t\tlet entrySubs: Array<() => void> = [];\n\n\t\t\tconst cleanupEntries = () => {\n\t\t\t\tfor (const unsub of entrySubs) unsub();\n\t\t\t\tentrySubs = [];\n\t\t\t};\n\n\t\t\tconst buildSnapshot = (): Record<K, R> => {\n\t\t\t\tconst snap = {} as Record<K, R>;\n\t\t\t\tfor (const key of keysNode.cache ?? []) {\n\t\t\t\t\tconst nodes = factory(key);\n\t\t\t\t\tconst values = {} as R;\n\t\t\t\t\tfor (const field of Object.keys(nodes) as (keyof R)[]) {\n\t\t\t\t\t\tvalues[field] = nodes[field].cache as R[keyof R];\n\t\t\t\t\t}\n\t\t\t\t\tsnap[key] = values;\n\t\t\t\t}\n\t\t\t\treturn snap;\n\t\t\t};\n\n\t\t\tconst sync = (nextKeys: K[]) => {\n\t\t\t\tcleanupEntries();\n\t\t\t\tfor (const key of nextKeys) {\n\t\t\t\t\tconst nodes = factory(key);\n\t\t\t\t\tfor (const field of Object.keys(nodes) as (keyof R)[]) {\n\t\t\t\t\t\tconst unsub = nodes[field].subscribe(() => {\n\t\t\t\t\t\t\trun(buildSnapshot());\n\t\t\t\t\t\t});\n\t\t\t\t\t\tentrySubs.push(unsub);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\trun(buildSnapshot());\n\t\t\t};\n\n\t\t\tconst keysUnsub = keysNode.subscribe((msgs: Messages) => {\n\t\t\t\tif (msgs.some((m) => m[0] === DATA || m[0] === RESOLVED)) {\n\t\t\t\t\tsync(keysNode.cache ?? []);\n\t\t\t\t}\n\t\t\t});\n\t\t\tsync(keysNode.cache ?? []);\n\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"],"mappings":";;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAeA,SAAS,MAAM,OAAiC,gBAAgB;AAiBzD,SAAS,aAAgB,MAAqD;AACpF,SAAO;AAAA,IACN,UAAU,KAAwD;AACjE,YAAM,QAAQ,KAAK,UAAU,MAAM;AAClC,YAAI,KAAK,KAAK;AAAA,MACf,CAAC;AACD,UAAI,KAAK,KAAK;AACd,aAAO;AAAA,IACR;AAAA,EACD;AACD;AAQO,SAAS,SAAY,MAAqD;AAChF,SAAO;AAAA,IACN,UAAU,KAAwD;AACjE,YAAM,QAAQ,KAAK,UAAU,MAAM;AAClC,YAAI,KAAK,KAAK;AAAA,MACf,CAAC;AACD,UAAI,KAAK,KAAK;AACd,aAAO;AAAA,IACR;AAAA,IACA,IAAI,OAA6B;AAChC,WAAK,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;AAAA,IACnC;AAAA,IACA,OAAO,SAAgE;AACtE,YAAM,OAAO,QAAQ,KAAK,KAAK;AAC/B,WAAK,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AAAA,IAClC;AAAA,EACD;AACD;AAYO,SAAS,mBACf,UACA,SAC+B;AAC/B,SAAO;AAAA,IACN,UAAU,KAAgD;AACzD,UAAI,YAA+B,CAAC;AAEpC,YAAM,iBAAiB,MAAM;AAC5B,mBAAW,SAAS,UAAW,OAAM;AACrC,oBAAY,CAAC;AAAA,MACd;AAEA,YAAM,gBAAgB,MAAoB;AACzC,cAAM,OAAO,CAAC;AACd,mBAAW,OAAO,SAAS,SAAS,CAAC,GAAG;AACvC,gBAAM,QAAQ,QAAQ,GAAG;AACzB,gBAAM,SAAS,CAAC;AAChB,qBAAW,SAAS,OAAO,KAAK,KAAK,GAAkB;AACtD,mBAAO,KAAK,IAAI,MAAM,KAAK,EAAE;AAAA,UAC9B;AACA,eAAK,GAAG,IAAI;AAAA,QACb;AACA,eAAO;AAAA,MACR;AAEA,YAAM,OAAO,CAAC,aAAkB;AAC/B,uBAAe;AACf,mBAAW,OAAO,UAAU;AAC3B,gBAAM,QAAQ,QAAQ,GAAG;AACzB,qBAAW,SAAS,OAAO,KAAK,KAAK,GAAkB;AACtD,kBAAM,QAAQ,MAAM,KAAK,EAAE,UAAU,MAAM;AAC1C,kBAAI,cAAc,CAAC;AAAA,YACpB,CAAC;AACD,sBAAU,KAAK,KAAK;AAAA,UACrB;AAAA,QACD;AACA,YAAI,cAAc,CAAC;AAAA,MACpB;AAEA,YAAM,YAAY,SAAS,UAAU,CAAC,SAAmB;AACxD,YAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,QAAQ,EAAE,CAAC,MAAM,QAAQ,GAAG;AACzD,eAAK,SAAS,SAAS,CAAC,CAAC;AAAA,QAC1B;AAAA,MACD,CAAC;AACD,WAAK,SAAS,SAAS,CAAC,CAAC;AAEzB,aAAO,MAAM;AACZ,kBAAU;AACV,uBAAe;AAAA,MAChB;AAAA,IACD;AAAA,EACD;AACD;","names":[]}