@graphrefly/graphrefly 0.25.0 → 0.26.0

package/dist/core/index.d.cts

@@ -1,3 +1,3 @@
-export { A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, F as FnCtx, G as GlobalInspectorEvent, j as GlobalInspectorHook, k as GraphReFlyConfig, l as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, t as Messages, N as Node, b as NodeActions, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, x as NodeFnCleanup, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, a as NodeOptions, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, P as NodeVersionInfo, Q as OnMessageHandler, R as OnSubscribeHandler, S as PAUSE, T as PolicyAllow, U as PolicyDeny, V as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from '../node-B-f-Lu-k.cjs';
-export { A as AutoTrackOptions, D as DerivedFn, a as DynamicFn, E as EffectFn, P as PipeOperator, b as ProducerFn, T as TrackFn, c as autoTrackNode, d as batch, e as derived, f as downWithBatch, g as dynamicNode, h as effect, j as isBatching, m as monotonicNs, p as pipe, k as producer, s as state, w as wallClockNs } from '../index-BJB7t9gg.cjs';
-export { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from '../meta-DWbkoq1s.cjs';
+export { A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, F as FnCtx, j as GlobalInspectorEvent, k as GlobalInspectorHook, l as GraphReFlyConfig, G as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, t as Messages, N as Node, b as NodeActions, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, x as NodeFnCleanup, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, a as NodeOptions, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, Q as NodeVersionInfo, R as OnMessageHandler, S as OnSubscribeHandler, T as PAUSE, U as PolicyAllow, V as PolicyDeny, P as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from '../node-C_IBuvX2.cjs';
+export { A as AutoTrackOptions, D as DerivedFn, a as DynamicFn, E as EffectFn, P as PipeOperator, b as ProducerFn, T as TrackFn, c as autoTrackNode, d as batch, e as derived, f as downWithBatch, g as dynamicNode, h as effect, j as isBatching, m as monotonicNs, p as pipe, k as producer, s as state, w as wallClockNs } from '../index-C0ZXMaXO.cjs';
+export { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from '../meta-C0-8XW6Q.cjs';

package/dist/core/index.d.ts

@@ -1,3 +1,3 @@
-export { A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, F as FnCtx, G as GlobalInspectorEvent, j as GlobalInspectorHook, k as GraphReFlyConfig, l as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, t as Messages, N as Node, b as NodeActions, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, x as NodeFnCleanup, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, a as NodeOptions, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, P as NodeVersionInfo, Q as OnMessageHandler, R as OnSubscribeHandler, S as PAUSE, T as PolicyAllow, U as PolicyDeny, V as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from '../node-B-f-Lu-k.js';
-export { A as AutoTrackOptions, D as DerivedFn, a as DynamicFn, E as EffectFn, P as PipeOperator, b as ProducerFn, T as TrackFn, c as autoTrackNode, d as batch, e as derived, f as downWithBatch, g as dynamicNode, h as effect, j as isBatching, m as monotonicNs, p as pipe, k as producer, s as state, w as wallClockNs } from '../index-C-TXEa7C.js';
-export { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from '../meta-CnkLA_43.js';
+export { A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, F as FnCtx, j as GlobalInspectorEvent, k as GlobalInspectorHook, l as GraphReFlyConfig, G as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, t as Messages, N as Node, b as NodeActions, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, x as NodeFnCleanup, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, a as NodeOptions, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, Q as NodeVersionInfo, R as OnMessageHandler, S as OnSubscribeHandler, T as PAUSE, U as PolicyAllow, V as PolicyDeny, P as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from '../node-C_IBuvX2.js';
+export { A as AutoTrackOptions, D as DerivedFn, a as DynamicFn, E as EffectFn, P as PipeOperator, b as ProducerFn, T as TrackFn, c as autoTrackNode, d as batch, e as derived, f as downWithBatch, g as dynamicNode, h as effect, j as isBatching, m as monotonicNs, p as pipe, k as producer, s as state, w as wallClockNs } from '../index-CY2TljO4.js';
+export { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from '../meta-BGqSZ7mt.js';

package/dist/core/index.js

@@ -1,33 +1,12 @@
-import "../chunk-QOWVNWOC.js";
+import "../chunk-3ZWCKRHX.js";
 import {
   resolveDescribeFields
-} from "../chunk-H4RVA4VE.js";
+} from "../chunk-VYPWMZ6H.js";
 import {
-  COMPLETE,
-  COMPLETE_MSG,
-  COMPLETE_ONLY_BATCH,
-  DATA,
   DEFAULT_ACTOR,
-  DIRTY,
-  DIRTY_MSG,
-  DIRTY_ONLY_BATCH,
-  ERROR,
   GraphReFlyConfig,
   GuardDenied,
-  INVALIDATE,
-  INVALIDATE_MSG,
-  INVALIDATE_ONLY_BATCH,
   NodeImpl,
-  PAUSE,
-  RESOLVED,
-  RESOLVED_MSG,
-  RESOLVED_ONLY_BATCH,
-  RESUME,
-  START,
-  START_MSG,
-  TEARDOWN,
-  TEARDOWN_MSG,
-  TEARDOWN_ONLY_BATCH,
   accessHintForGuard,
   advanceVersion,
   autoTrackNode,
@@ -52,7 +31,30 @@ import {
   registerBuiltins,
   state,
   wallClockNs
-} from "../chunk-5DJTTKX3.js";
+} from "../chunk-PHOUUNK7.js";
+import {
+  COMPLETE,
+  COMPLETE_MSG,
+  COMPLETE_ONLY_BATCH,
+  DATA,
+  DIRTY,
+  DIRTY_MSG,
+  DIRTY_ONLY_BATCH,
+  ERROR,
+  INVALIDATE,
+  INVALIDATE_MSG,
+  INVALIDATE_ONLY_BATCH,
+  PAUSE,
+  RESOLVED,
+  RESOLVED_MSG,
+  RESOLVED_ONLY_BATCH,
+  RESUME,
+  START,
+  START_MSG,
+  TEARDOWN,
+  TEARDOWN_MSG,
+  TEARDOWN_ONLY_BATCH
+} from "../chunk-SX52TAR4.js";
 export {
   COMPLETE,
   COMPLETE_MSG,

package/dist/demo-shell-26p5fVxn.d.cts

@@ -0,0 +1,102 @@
+import { G as Graph } from './graph-6tZ5jEzr.cjs';
+import { M as MeasurementAdapter } from './reactive-layout-BaOQefHu.cjs';
+
+/**
+ * Three-pane demo shell (roadmap §7.2).
+ *
+ * A `Graph("demo-shell")` that dogfoods reactive coordination for the
+ * main/side split layout with synchronized cross-highlighting.
+ *
+ * **Zero framework dependency** — framework bindings wrap pane components only.
+ * The shell graph is headless and fully testable.
+ */
+
+/** Identifies which pane is the source of a hover event. */
+type HoverPaneType = "visual" | "graph" | "code";
+/** Cross-highlighting hover target. `null` means nothing hovered. */
+type HoverTarget = {
+    pane: HoverPaneType;
+    id: string;
+} | null;
+/** Which pane is full-screened (null = normal layout). */
+type FullscreenPane = "main" | "graph" | "code" | null;
+/**
+ * Cross-referencing registry: maps node paths to code line numbers and
+ * visual element selectors. Provided by each demo's `store.ts`.
+ */
+type NodeRegistry = Map<string, {
+    codeLine: number;
+    visualSelector: string;
+}>;
+/** Callbacks for cross-highlighting effect nodes. */
+type HighlightCallbacks = {
+    /** Called when code-scroll highlight target changes. */
+    codeScroll?: (line: number | null) => void;
+    /** Called when visual highlight target changes. */
+    visual?: (selector: string | null) => void;
+    /** Called when graph highlight target changes. */
+    graph?: (nodeId: string | null) => void;
+};
+/** Label dimensions for graph node sizing. */
+type GraphLabelSize = {
+    width: number;
+    height: number;
+};
+/** Options for {@link demoShell}. */
+type DemoShellOptions = {
+    /** Initial main/side split ratio (0–1). Default: `0.65`. */
+    mainRatio?: number;
+    /** Initial graph/code vertical split in the side pane (0–1). Default: `0.5`. */
+    sideSplit?: number;
+    /** Initial viewport width in pixels. Default: `1280`. */
+    viewportWidth?: number;
+    /** Cross-referencing registry for hover→code/visual/graph mapping. */
+    nodeRegistry?: NodeRegistry;
+    /** Measurement adapter for layout engine integration. When provided, enables layout/* derived nodes. */
+    adapter?: MeasurementAdapter;
+    /** Font string for layout measurement. Default: `"14px monospace"`. */
+    layoutFont?: string;
+    /** Callbacks for cross-highlighting effect nodes. When provided, creates effect nodes visible in describe(). */
+    onHighlight?: HighlightCallbacks;
+};
+/** Return type of {@link demoShell}. */
+type DemoShellHandle = {
+    /** The demo-shell graph. */
+    graph: Graph;
+    setMainRatio(ratio: number): void;
+    setSideSplit(ratio: number): void;
+    setFullscreen(pane: FullscreenPane): void;
+    setViewportWidth(width: number): void;
+    setHoverTarget(target: HoverTarget): void;
+    setDemoGraph(g: Graph | null): void;
+    bumpGraphTick(): void;
+    selectNode(path: string | null): void;
+    setMetaDebug(on: boolean): void;
+    /** Set code text for layout/code-lines measurement (requires adapter). */
+    setCodeText(text: string): void;
+    /** Atomic multi-set — wraps core `batch()` for glitch-free updates. */
+    batch(fn: () => void): void;
+    destroy(): void;
+};
+/**
+ * Creates the three-pane demo shell graph (roadmap §7.2).
+ *
+ * All coordination is reactive — no polling, no imperative triggers.
+ * Framework bindings subscribe to named nodes and drive `state` inputs.
+ */
+declare function demoShell(opts?: DemoShellOptions): DemoShellHandle;
+
+type demoShell$1_DemoShellHandle = DemoShellHandle;
+type demoShell$1_DemoShellOptions = DemoShellOptions;
+type demoShell$1_FullscreenPane = FullscreenPane;
+type demoShell$1_GraphLabelSize = GraphLabelSize;
+type demoShell$1_HighlightCallbacks = HighlightCallbacks;
+type demoShell$1_HoverPaneType = HoverPaneType;
+type demoShell$1_HoverTarget = HoverTarget;
+type demoShell$1_NodeRegistry = NodeRegistry;
+declare const demoShell$1_demoShell: typeof demoShell;
+declare namespace demoShell$1 {
+  export { type demoShell$1_DemoShellHandle as DemoShellHandle, type demoShell$1_DemoShellOptions as DemoShellOptions, type demoShell$1_FullscreenPane as FullscreenPane, type demoShell$1_GraphLabelSize as GraphLabelSize, type demoShell$1_HighlightCallbacks as HighlightCallbacks, type demoShell$1_HoverPaneType as HoverPaneType, type demoShell$1_HoverTarget as HoverTarget, type demoShell$1_NodeRegistry as NodeRegistry, demoShell$1_demoShell as demoShell };
+}
+
+export { type DemoShellHandle as D, type FullscreenPane as F, type GraphLabelSize as G, type HighlightCallbacks as H, type NodeRegistry as N, type DemoShellOptions as a, type HoverPaneType as b, type HoverTarget as c, demoShell$1 as d, demoShell as e };

package/dist/demo-shell-DEp-nMTl.d.ts

@@ -0,0 +1,102 @@
+import { G as Graph } from './graph-DQ69XU0g.js';
+import { M as MeasurementAdapter } from './reactive-layout-D9gejYXE.js';
+
+/**
+ * Three-pane demo shell (roadmap §7.2).
+ *
+ * A `Graph("demo-shell")` that dogfoods reactive coordination for the
+ * main/side split layout with synchronized cross-highlighting.
+ *
+ * **Zero framework dependency** — framework bindings wrap pane components only.
+ * The shell graph is headless and fully testable.
+ */
+
+/** Identifies which pane is the source of a hover event. */
+type HoverPaneType = "visual" | "graph" | "code";
+/** Cross-highlighting hover target. `null` means nothing hovered. */
+type HoverTarget = {
+    pane: HoverPaneType;
+    id: string;
+} | null;
+/** Which pane is full-screened (null = normal layout). */
+type FullscreenPane = "main" | "graph" | "code" | null;
+/**
+ * Cross-referencing registry: maps node paths to code line numbers and
+ * visual element selectors. Provided by each demo's `store.ts`.
+ */
+type NodeRegistry = Map<string, {
+    codeLine: number;
+    visualSelector: string;
+}>;
+/** Callbacks for cross-highlighting effect nodes. */
+type HighlightCallbacks = {
+    /** Called when code-scroll highlight target changes. */
+    codeScroll?: (line: number | null) => void;
+    /** Called when visual highlight target changes. */
+    visual?: (selector: string | null) => void;
+    /** Called when graph highlight target changes. */
+    graph?: (nodeId: string | null) => void;
+};
+/** Label dimensions for graph node sizing. */
+type GraphLabelSize = {
+    width: number;
+    height: number;
+};
+/** Options for {@link demoShell}. */
+type DemoShellOptions = {
+    /** Initial main/side split ratio (0–1). Default: `0.65`. */
+    mainRatio?: number;
+    /** Initial graph/code vertical split in the side pane (0–1). Default: `0.5`. */
+    sideSplit?: number;
+    /** Initial viewport width in pixels. Default: `1280`. */
+    viewportWidth?: number;
+    /** Cross-referencing registry for hover→code/visual/graph mapping. */
+    nodeRegistry?: NodeRegistry;
+    /** Measurement adapter for layout engine integration. When provided, enables layout/* derived nodes. */
+    adapter?: MeasurementAdapter;
+    /** Font string for layout measurement. Default: `"14px monospace"`. */
+    layoutFont?: string;
+    /** Callbacks for cross-highlighting effect nodes. When provided, creates effect nodes visible in describe(). */
+    onHighlight?: HighlightCallbacks;
+};
+/** Return type of {@link demoShell}. */
+type DemoShellHandle = {
+    /** The demo-shell graph. */
+    graph: Graph;
+    setMainRatio(ratio: number): void;
+    setSideSplit(ratio: number): void;
+    setFullscreen(pane: FullscreenPane): void;
+    setViewportWidth(width: number): void;
+    setHoverTarget(target: HoverTarget): void;
+    setDemoGraph(g: Graph | null): void;
+    bumpGraphTick(): void;
+    selectNode(path: string | null): void;
+    setMetaDebug(on: boolean): void;
+    /** Set code text for layout/code-lines measurement (requires adapter). */
+    setCodeText(text: string): void;
+    /** Atomic multi-set — wraps core `batch()` for glitch-free updates. */
+    batch(fn: () => void): void;
+    destroy(): void;
+};
+/**
+ * Creates the three-pane demo shell graph (roadmap §7.2).
+ *
+ * All coordination is reactive — no polling, no imperative triggers.
+ * Framework bindings subscribe to named nodes and drive `state` inputs.
+ */
+declare function demoShell(opts?: DemoShellOptions): DemoShellHandle;
+
+type demoShell$1_DemoShellHandle = DemoShellHandle;
+type demoShell$1_DemoShellOptions = DemoShellOptions;
+type demoShell$1_FullscreenPane = FullscreenPane;
+type demoShell$1_GraphLabelSize = GraphLabelSize;
+type demoShell$1_HighlightCallbacks = HighlightCallbacks;
+type demoShell$1_HoverPaneType = HoverPaneType;
+type demoShell$1_HoverTarget = HoverTarget;
+type demoShell$1_NodeRegistry = NodeRegistry;
+declare const demoShell$1_demoShell: typeof demoShell;
+declare namespace demoShell$1 {
+  export { type demoShell$1_DemoShellHandle as DemoShellHandle, type demoShell$1_DemoShellOptions as DemoShellOptions, type demoShell$1_FullscreenPane as FullscreenPane, type demoShell$1_GraphLabelSize as GraphLabelSize, type demoShell$1_HighlightCallbacks as HighlightCallbacks, type demoShell$1_HoverPaneType as HoverPaneType, type demoShell$1_HoverTarget as HoverTarget, type demoShell$1_NodeRegistry as NodeRegistry, demoShell$1_demoShell as demoShell };
+}
+
+export { type DemoShellHandle as D, type FullscreenPane as F, type GraphLabelSize as G, type HighlightCallbacks as H, type NodeRegistry as N, type DemoShellOptions as a, type HoverPaneType as b, type HoverTarget as c, demoShell$1 as d, demoShell as e };