@principal-ai/subsystems-react 0.20.5 → 0.21.0

package/dist/subsystem/SubsystemComponentGraph.d.ts

@@ -12,28 +12,29 @@
  * injection, onNodeClick) adapted to the subsystem model — read-only.
  */
 import type { ReactNode } from 'react';
-import { type SubsystemComponentEdge, type SubsystemComponent, type SubsystemThroughline } from './model';
+import { type SubsystemComponentEdge, type SubsystemComponent, type SubsystemRelation, type SubsystemWalkthrough } from './model';
 import type { SubsystemOpenFileOptions } from './declarationRef';
 import type { ComponentVerificationState } from './ComponentDeclaration';
-/** Context passed to `renderThroughlineViewer` when a flow/step is focused. */
-export interface ThroughlineViewerContext {
-    throughline: SubsystemThroughline;
+/** Context passed to `renderWalkthroughViewer` when a flow/step is focused. */
+export interface WalkthroughViewerContext {
+    walkthrough: SubsystemWalkthrough;
     /** Focused step index; `null` means the whole flow (no specific step). */
     stepIndex: number | null;
 }
 export interface SubsystemComponentGraphProps {
     components: SubsystemComponent[];
-    edges: SubsystemComponentEdge[];
+    /** Topology relations (structural / module / type). Display edges are derived with walkthrough hops. */
+    relations: SubsystemRelation[];
     /**
-     * Ordered execution stories over the graph's edges — one throughline per
-     * flow. When present the sidebar's bottom half offers a Files/Flows toggle:
-     * the flows panel lists each throughline's steps (`symbol` or `file:line`);
+     * Ordered runtime walkthroughs — one walkthrough per flow. When present the
+     * sidebar's bottom half offers a Files/Walkthroughs toggle:
+     * the flows panel lists each walkthrough's steps (`symbol` or `file:line`);
      * clicking a flow row toggles its steps; clicking a step focuses that
-     * step's edge and (when `renderThroughlineViewer` is set) opens the bottom
+     * step's edge and (when `renderWalkthroughViewer` is set) opens the bottom
      * drawer on that flow's snippets. Opened flows stay on the canvas
      * (unselected ones dimmed); everything else is hidden.
      */
-    throughlines?: SubsystemThroughline[];
+    walkthroughs?: SubsystemWalkthrough[];
     onSelect?: (componentId: string) => void;
     /** Called when an edge is clicked (relationship / mechanism + refs seam). */
     onEdgeSelect?: (edge: SubsystemComponentEdge) => void;
@@ -46,29 +47,29 @@ export interface SubsystemComponentGraphProps {
     title?: string;
     /**
      * Suppresses the sidebar entirely (title, description, file tree,
-     * throughlines) for graph-only embeds. Pair with `graphTitle` to keep the
+     * walkthroughs) for graph-only embeds. Pair with `graphTitle` to keep the
      * subsystem name visible as an overlay on the canvas.
      */
     hideSidebar?: boolean;
     /**
-     * How throughline step highlighting behaves on the canvas.
+     * How walkthrough step highlighting behaves on the canvas.
      * - `focus` (default): zoom to the step, hide non-participants, open drawer
      * - `dim`: keep the full graph, dim non-participants (same as hovering a step)
      */
-    throughlineStepMode?: 'focus' | 'dim';
+    walkthroughStepMode?: 'focus' | 'dim';
     /**
-     * When true, cycles throughline steps automatically using `dim` highlighting
-     * (no zoom, no drawer). Loops across all throughlines that have steps.
+     * When true, cycles walkthrough steps automatically using `dim` highlighting
+     * (no zoom, no drawer). Loops across all walkthroughs that have steps.
      * Useful for graph-only embeds (`hideSidebar`).
      */
-    autoPlayThroughlines?: boolean;
+    autoPlayWalkthroughs?: boolean;
     /** Pause between autoplay steps in ms. @default 2500 */
-    throughlineAutoPlayIntervalMs?: number;
+    walkthroughAutoPlayIntervalMs?: number;
     /**
-     * When false, focusing a throughline/step does not call `fitView`.
+     * When false, focusing a walkthrough/step does not call `fitView`.
      * @default true
      */
-    zoomOnThroughlineFocus?: boolean;
+    zoomOnWalkthroughFocus?: boolean;
     /**
      * Subsystem title rendered as a non-interactive overlay chip on the graph
      * canvas (top-center). Does not trigger the sidebar — for graph-only
@@ -76,11 +77,11 @@ export interface SubsystemComponentGraphProps {
      */
     graphTitle?: string;
     /**
-     * When true, shows the active throughline's title as a non-interactive
+     * When true, shows the active walkthrough's title as a non-interactive
      * overlay chip on the canvas (under `graphTitle` when both are set).
-     * Uses the focused or hover-highlighted throughline.
+     * Uses the focused or hover-highlighted walkthrough.
      */
-    showThroughlineTitle?: boolean;
+    showWalkthroughTitle?: boolean;
     /** Markdown description rendered in the sidebar. */
     description?: string;
     /** Rendered over the graph canvas only (not the title/legend sidebar). */
@@ -96,11 +97,11 @@ export interface SubsystemComponentGraphProps {
      */
     renderFileViewer?: (file: string, opts?: SubsystemOpenFileOptions) => ReactNode;
     /**
-     * Host-injected multi-snippet viewer for a focused throughline. When set,
+     * Host-injected multi-snippet viewer for a focused walkthrough. When set,
      * clicking a flow step opens the bottom drawer with this content and
      * updates it as the focused step changes.
      */
-    renderThroughlineViewer?: (ctx: ThroughlineViewerContext) => ReactNode;
+    renderWalkthroughViewer?: (ctx: WalkthroughViewerContext) => ReactNode;
     /**
      * Legacy component-keyed variant, kept for backward compatibility. When
      * `renderFileViewer` is absent, drawer content resolves via the first

package/dist/subsystem/SubsystemComponentGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubsystemComponentGraph.d.ts","sourceRoot":"","sources":["../../src/subsystem/SubsystemComponentGraph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAiC,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBtE,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAEvB,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAKjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAYzE,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,oBAAoB,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAMD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACtD;kFAC8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,gFAAgF;IAChF,uBAAuB,CAAC,EAAE,SAAS,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,KAAK,SAAS,CAAC;IAChF;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,SAAS,CAAC;IACvE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,SAAS,CAAC;IAC9D;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,2DAA2D;IAC3D,qBAAqB,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC3D;AAo+DD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,+BAsC1E"}
+{"version":3,"file":"SubsystemComponentGraph.d.ts","sourceRoot":"","sources":["../../src/subsystem/SubsystemComponentGraph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAiC,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBtE,OAAO,EAOL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAKjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAYzE,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,oBAAoB,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAMD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,wGAAwG;IACxG,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACtD;kFAC8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,gFAAgF;IAChF,uBAAuB,CAAC,EAAE,SAAS,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,KAAK,SAAS,CAAC;IAChF;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,SAAS,CAAC;IACvE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,SAAS,CAAC;IAC9D;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,2DAA2D;IAC3D,qBAAqB,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC3D;AA8/DD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,+BAsC1E"}