@principal-ai/subsystems-react 0.53.0 → 0.53.2

package/dist/subsystem/C4Graph.d.ts

@@ -11,11 +11,20 @@
  * drawers, no trail playback.
  */
 /// <reference types="react" />
+import type { CompoundGroupDef, ElkLayoutResult } from '../utils/elkLayout';
+import { type C4Group } from './c4';
 import type { C4Model } from './c4';
 export interface C4GraphProps {
     model: C4Model;
-    title?: string;
     onSelectNode?: (id: string | null) => void;
+    /**
+     * Drill-down. Called from the expand affordance on a container card; the host
+     * sets `openContainerId` on the model to swap the box for a frame with its
+     * components inside.
+     */
+    onOpenContainer?: (id: string) => void;
+    /** Called from the collapse affordance inside an opened container frame. */
+    onCloseContainer?: () => void;
     /**
      * Breathing room around each card, in flow px, applied as ELK spacing (not by
      * inflating the node box — that left the edge lines starting short of the
@@ -24,5 +33,86 @@ export interface C4GraphProps {
      */
     gutter?: number;
 }
+/** Flow-space rect of a box node or a frame, for the drill-down morph. */
+interface FlowRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A frame's growth for the drill-down morph: its flow rect before → after. */
+interface FrameGrow {
+    from: FlowRect;
+    to: FlowRect;
+}
+/**
+ * Whether committing a layout should also move the camera.
+ *
+ * A morph — a commit that has rects to FLIP from — must not. Every element
+ * already on screen is sliding from the rect the reader last saw it at, and that
+ * anchoring *is* the morph; a viewport move on top of it makes each card's
+ * on-screen path the sum of two independent animations, so nothing lands where
+ * the FLIP said it would. `CAMERA_MS` also outlasts `MORPH_MS`, so the camera
+ * would still be drifting for 100ms after the cards had settled — which is what
+ * reads as the cards "still moving".
+ *
+ * A commit with no `grows` is a genuine change: the first paint, a new system, a
+ * different element set, or the grid fallback after an ELK failure. There is no
+ * continuity to preserve there and the content may genuinely not be on screen, so
+ * fit.
+ *
+ * An *empty* map fits for the same reason — no element is anchoring, so there is
+ * nothing a camera move could contradict. Testing the size rather than the
+ * identity keeps that total over the whole input domain instead of leaning on a
+ * caller convention (`growsFor` happens to hand back `null` rather than an empty
+ * map, but nothing forces it to).
+ *
+ * @param grows the rects to animate from, exactly as `injectGrow` received them.
+ */
+export declare function shouldRefitCamera(grows: Map<string, FrameGrow> | null): boolean;
+/**
+ * Whether a card shows its description line.
+ *
+ * Off for the whole morph: the card is resizing under it, so the line would slide
+ * across a moving box.
+ *
+ * And off for good once the container is grown, which is the half that is easy to
+ * get wrong. `settled` alone is not enough — the line comes back the moment the
+ * grow finishes, straight into the space the components now occupy. ELK reserves
+ * header chrome only (`padTop`), never a description, so the returning line does
+ * not push the internals down; it lands on top of the first component.
+ */
+export declare function showDescriptionFor(open: boolean | undefined, settled: boolean | undefined): boolean;
+/**
+ * `groupBounds` with every entry in absolute flow coordinates.
+ *
+ * `result.groupBounds` is absolute for a root-level group and *parent-relative*
+ * for a nested one — two spaces in one map, which is the same trap as
+ * `result.nodes`. The opened container is nested (inside the system frame), and
+ * `containerRect` reads this map before the node box, so an unrebased entry would
+ * be handed to the morph offset by the frame's origin: the container would glide
+ * to a place it was never drawn.
+ */
+export declare function rebaseGroupBoundsAbsolute(result: Pick<ElkLayoutResult, 'absoluteRects' | 'groupBounds'>): Map<string, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+/**
+ * The compound groups one open state hands to ELK: the frames it draws, and the
+ * group defs that make ELK lay them out.
+ *
+ * Exported because the nesting here is the load-bearing part and it is invisible
+ * from the rendered output. The opened container sits *inside* the system frame, so
+ * the frame is the origin its contents are laid out from — as a sibling, or as a
+ * flat union, the frame has no stable corner and the whole boundary slides as
+ * ELK re-places its members.
+ */
+export declare function c4GroupDefs(model: C4Model, openId: string | null): {
+    frames: C4Group[];
+    groups: CompoundGroupDef[];
+};
 export declare function C4Graph(props: C4GraphProps): import("react").JSX.Element;
+export {};
 //# sourceMappingURL=C4Graph.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"C4Graph.d.ts","sourceRoot":"","sources":["../../src/subsystem/C4Graph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;;AAuBH,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4tBD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,+BAM1C"}
+{"version":3,"file":"C4Graph.d.ts","sourceRoot":"","sources":["../../src/subsystem/C4Graph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;;AAmBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAKnE,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA8UD,0EAA0E;AAC1E,UAAU,QAAQ;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAE1E,+EAA+E;AAC/E,UAAU,SAAS;IAAG,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE;AAEpD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,OAAO,CAE/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAEnG;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,GAAG,aAAa,CAAC,GAC7D,GAAG,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAUtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB;IAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CA2CnD;AAm0BD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,+BAM1C"}