@principal-ai/subsystems-react 0.17.0

package/dist/subsystem/SubsystemComponentGraph.d.ts

@@ -0,0 +1,96 @@
+/**
+ * SubsystemComponentGraph — a clickable, read-only React Flow component graph
+ * for a subsystem snapshot.
+ *
+ * Nodes are positioned with ELK auto-layout (layered, minimized crossings,
+ * process-aware compound groups). Components sharing a `process` render
+ * inside one labeled boundary frame; nodes without one sit outside every
+ * boundary. Clicking a component invokes `onSelect`.
+ *
+ * This is a focused fork of the package's `GraphRenderer` pipeline (same ELK
+ * edge routing, delayed fitView, Background/Controls/MiniMap, node/edge type
+ * 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 { SubsystemOpenFileOptions } from './declarationRef';
+import type { ComponentVerificationState } from './ComponentDeclaration';
+/** Context passed to `renderThroughlineViewer` when a flow/step is focused. */
+export interface ThroughlineViewerContext {
+    throughline: SubsystemThroughline;
+    /** Focused step index; `null` means the whole flow (no specific step). */
+    stepIndex: number | null;
+}
+export interface SubsystemComponentGraphProps {
+    components: SubsystemComponent[];
+    edges: SubsystemComponentEdge[];
+    /**
+     * 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`);
+     * clicking a flow row toggles its steps; clicking a step focuses that
+     * step's edge and (when `renderThroughlineViewer` 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[];
+    onSelect?: (componentId: string) => void;
+    /** Called when an edge is clicked (relationship / mechanism + refs seam). */
+    onEdgeSelect?: (edge: SubsystemComponentEdge) => void;
+    /** Upper bound for node width in px; nodes grow with content up to this,
+     *  then the name wraps. Defaults to 300 for components (320 for packages). */
+    maxNodeWidth?: number;
+    /** Show edge labels (mechanism names) on the graph. @default true */
+    showEdgeLabels?: boolean;
+    /** Subsystem title displayed in the sidebar. */
+    title?: string;
+    /**
+     * Suppresses the sidebar entirely (title, description, file tree,
+     * throughlines) for graph-only embeds. Pair with `graphTitle` to keep the
+     * subsystem name visible as an overlay on the canvas.
+     */
+    hideSidebar?: boolean;
+    /**
+     * Subsystem title rendered as a non-interactive overlay chip on the graph
+     * canvas (top-center). Does not trigger the sidebar — for graph-only
+     * embeds that still need to name what they show.
+     */
+    graphTitle?: string;
+    /** Markdown description rendered in the sidebar. */
+    description?: string;
+    /** Rendered over the graph canvas only (not the title/legend sidebar). */
+    canvasOverlay?: ReactNode;
+    /** Extra controls at the top of the title/legend sidebar. */
+    sidebarExtra?: ReactNode;
+    /** Rendered in the sidebar under the description (e.g. selection inspector). */
+    sidebarAfterDescription?: ReactNode;
+    /**
+     * Host-injected reader/renderer for the bottom file drawer, keyed by
+     * repo-root-relative path. Opening happens on declaration/file-tree clicks.
+     * Keeps this package free of fs and code-view dependencies.
+     */
+    renderFileViewer?: (file: string, opts?: SubsystemOpenFileOptions) => ReactNode;
+    /**
+     * Host-injected multi-snippet viewer for a focused throughline. 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;
+    /**
+     * Legacy component-keyed variant, kept for backward compatibility. When
+     * `renderFileViewer` is absent, drawer content resolves via the first
+     * component whose `file` matches the opened path.
+     */
+    renderFileView?: (component: SubsystemComponent) => ReactNode;
+    /**
+     * Called when a file in the sidebar file tree is clicked (repo-root-relative
+     * path). The tree is derived from the components' `file` values.
+     */
+    onFileSelect?: (file: string) => void;
+    /** Verify the selected component against graphify (declaration panel). */
+    onVerifyComponent?: (componentId: string) => void;
+    /** Live verification status for the selected component. */
+    componentVerification?: ComponentVerificationState | null;
+}
+export declare function SubsystemComponentGraph(props: SubsystemComponentGraphProps): import("react").JSX.Element;
+//# sourceMappingURL=SubsystemComponentGraph.d.ts.map

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

@@ -0,0 +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;AAUzE,+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,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,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;AAu7CD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,+BAsC1E"}