@principal-ai/subsystems-react 0.23.1 → 0.23.3

package/dist/subsystem/model.d.ts

@@ -278,25 +278,49 @@ export declare function deriveNameFromSymbol(symbol: string | undefined, constru
 export declare function formatPurl(purl: string): string;
 export type SubsystemGraphNodeType = 'subsystem-component' | 'subsystem-group';
 /**
- * One boundary region — either a process (runtime deployment unit) or a
- * module (source file). Nodes without that field sit outside those frames.
+ * One boundary region — process (runtime), module (source file), or package
+ * (repo identity from `purl`). Nodes without that membership sit outside
+ * those frames. Package frames are derived from `purl` (no separate field);
+ * they only appear when the graph spans multiple repos (by default).
  */
 export interface SubsystemProcessRegion {
-    /** Discriminator — which field produced this region. */
-    kind: 'process' | 'module';
-    /** The `process` or `module` value (e.g. `principal-studio/host`, `src/a.ts`). */
+    /** Discriminator — which field / identity produced this region. */
+    kind: 'process' | 'module' | 'package';
+    /** The `process` / `module` value, or purl repo key for packages. */
     key: string;
     /** Display label for the boundary frame. */
     label: string;
     /** Component ids that are members of this region. */
     memberIds: string[];
 }
+/** Options for which boundary frames are kept. */
+export interface BoundaryFrameOptions {
+    /**
+     * Keep 1-member process / module / package frames. Default false
+     * (singleton rule — frames need 2+ members).
+     */
+    showSingletonFrames?: boolean;
+    /**
+     * When package frames are drawn from component `purl`s.
+     * - `multi-repo` (default): only when 2+ distinct repo purls
+     * - `always`: frame every multi-member package even in a single-repo graph
+     * - `never`: no package frames
+     */
+    packageFrames?: 'multi-repo' | 'always' | 'never';
+}
 /** React Flow id for a process boundary group node. */
 export declare function processGroupNodeId(processKey: string): string;
 /** React Flow id for a module boundary group node. */
 export declare function moduleGroupNodeId(moduleKey: string): string;
-/** React Flow id for a boundary group of either kind. */
+/** React Flow id for a package (repo) boundary group node. */
+export declare function packageGroupNodeId(packageKey: string): string;
+/** React Flow id for a boundary group of any kind. */
 export declare function boundaryGroupNodeId(region: Pick<SubsystemProcessRegion, 'kind' | 'key'>): string;
+/**
+ * Repo/package key used for package frames — `purl` with fragment stripped.
+ * Externals and custom entities are not package-frame members.
+ */
+export declare function componentPackageKey(c: Pick<SubsystemComponent, 'purl' | 'construct'>): string | undefined;
 /**
  * Derive process boundary regions — one per distinct non-empty `process`
  * value, in first-appearance order.
@@ -308,23 +332,31 @@ export declare function getSubsystemRegions(doc: Pick<SubsystemModelDocument, 'c
  */
 export declare function getSubsystemModuleRegions(doc: Pick<SubsystemModelDocument, 'components'>): SubsystemProcessRegion[];
 /**
- * One compound frame for ELK / React Flow — module frames may nest under a
- * process frame via `parentId`.
+ * Derive package (repo) boundary regions from component `purl`s — one per
+ * distinct repo key. Does not apply multi-repo / singleton filters; callers
+ * decide via {@link buildBoundaryLayoutGroups}.
+ */
+export declare function getSubsystemPackageRegions(doc: Pick<SubsystemModelDocument, 'components'>): SubsystemProcessRegion[];
+/**
+ * One compound frame for ELK / React Flow — modules nest under processes,
+ * processes under packages, when membership is shared.
  */
 export interface BoundaryLayoutGroup {
     id: string;
     memberIds: string[];
-    /** When set, this group is a child of another boundary group (process). */
+    /** When set, this group is a child of another boundary group. */
     parentId?: string;
     region: SubsystemProcessRegion;
 }
 /**
- * Build the process → module → leaf group tree for layout.
- * Multi-member modules nest under a process when every member shares that
- * process; process ELK children are nested module group ids plus any
- * process members that are not inside a kept module frame.
+ * Build the package → process → module → leaf group tree for layout.
+ *
+ * Package frames come from `purl` (no separate component field). By default
+ * they only appear when the graph spans 2+ distinct repos. Multi-member
+ * modules nest under a process when every member shares that process;
+ * processes nest under a package the same way.
  */
-export declare function buildBoundaryLayoutGroups(doc: Pick<SubsystemModelDocument, 'components'>): BoundaryLayoutGroup[];
+export declare function buildBoundaryLayoutGroups(doc: Pick<SubsystemModelDocument, 'components'>, opts?: BoundaryFrameOptions): BoundaryLayoutGroup[];
 export interface SubsystemGraphNodeData extends Record<string, unknown> {
     component: SubsystemComponent;
     /** Set while a file is open in the drawer: true if this node's component
@@ -368,6 +400,11 @@ export declare function packageColor(name: string): string;
  *  are the only surface using it, but pick a distinct value if roles ever
  *  take over node borders. */
 export declare const ROLE_COLOR: Record<SubsystemComponentRole, string>;
+/**
+ * Brand color for the left construct/stereotype badge when a framework owns
+ * the label (e.g. `react · component`). Node border stays construct-colored.
+ */
+export declare const FRAMEWORK_BADGE_COLOR: Record<string, string>;
 export declare const ROLE_LABEL: Record<SubsystemComponentRole, string>;
 /** Right-badge accent for `proposed: true` (no role, or combined with role). */
 export declare const PROPOSED_COLOR = "#b8860b";
@@ -414,6 +451,15 @@ export declare function constructBadgeLabel(component: {
     stereotype?: string;
     entityKind?: string;
 }): string;
+/**
+ * Left-badge accent: framework brand when the badge shows a framework
+ * stereotype (e.g. React cyan for `react · component`); otherwise null so
+ * the caller falls back to construct color. Border stays construct-colored.
+ */
+export declare function constructBadgeColor(component: {
+    framework?: string;
+    stereotype?: string;
+}): string | null;
 /** Default CSS floor for component nodes (padding aside). */
 export declare const NODE_CSS_MIN_WIDTH = 150;
 /** Inset of each top badge from the node edge (`left` / `right` style). */
@@ -437,21 +483,21 @@ export declare function nodeMinWidthForBadges(component: {
 /**
  * Convert a subsystem graph document into React Flow nodes. Components that
  * carry a `module` get a `parentId` pointing at their module frame
- * (`module:<path>`); otherwise a `process` stamps `process:<process>`. Module
- * frames may themselves nest under a process frame (stamped on the group node
- * in `buildSubsystemGraph`). Nodes without either stay top-level. The initial
- * grid clusters by `module ?? process ?? purl`; ELK then refines with compound
- * layout.
+ * (`module:<path>`); otherwise a `process` stamps `process:<process>`.
+ * Package (`purl`) parents are stamped later in `buildSubsystemGraph` only
+ * when package frames are kept. Module frames may nest under process →
+ * package. The initial grid clusters by `module ?? process ?? purl`; ELK
+ * then refines with compound layout.
  */
 export declare function convertSubsystemToNodes(doc: SubsystemModelDocument, opts?: {
     maxNodeWidth?: number;
 }): SubsystemGraphNode[];
 /**
- * Convert boundary regions into React Flow parent (group) nodes. Module
- * frames that share a process nest under that process via `parentId`.
+ * Convert boundary regions into React Flow parent (group) nodes. Nesting
+ * (package → process → module) is stamped via `parentId` on groups.
  * Positions/sizes are placeholders — ELK compound layout overwrites them.
  */
-export declare function convertSubsystemToGroups(doc: Pick<SubsystemModelDocument, 'components'>): SubsystemGraphNode[];
+export declare function convertSubsystemToGroups(doc: Pick<SubsystemModelDocument, 'components'>, opts?: BoundaryFrameOptions): SubsystemGraphNode[];
 /**
  * Convert a subsystem graph document into React Flow edges. Edges whose target
  * is an external label (not a component id) point at a synthetic stub so the
@@ -470,7 +516,7 @@ export declare function buildSubsystemGraph(doc: SubsystemModelDocument, opts?:
     showEdgeLabels?: boolean;
     measuredWidths?: Map<string, number>;
     measuredHeights?: Map<string, number>;
-}): Promise<{
+} & BoundaryFrameOptions): Promise<{
     nodes: SubsystemGraphNode[];
     edges: SubsystemGraphEdge[];
     regions: SubsystemProcessRegion[];

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

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/subsystem/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/subsystem/model.ts"],"names":[],"mappings":"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"}

package/dist/subsystem/model.js

@@ -13,6 +13,7 @@
  */
 import { MarkerType, } from '@xyflow/react';
 import { computeElkLayout, calculatePathLength } from '../utils/elkLayout';
+import { purlOwnerName, purlRepoKey } from './paths';
 /** Stable id for a derived graph edge from a relation or walkthrough hop. */
 export function derivedGraphEdgeId(from, to, mechanism) {
     return `${from}--${mechanism}-->${to}`;
@@ -123,11 +124,32 @@ export function processGroupNodeId(processKey) {
 export function moduleGroupNodeId(moduleKey) {
     return `module:${moduleKey}`;
 }
-/** React Flow id for a boundary group of either kind. */
+/** React Flow id for a package (repo) boundary group node. */
+export function packageGroupNodeId(packageKey) {
+    return `package:${packageKey}`;
+}
+/** React Flow id for a boundary group of any kind. */
 export function boundaryGroupNodeId(region) {
-    return region.kind === 'module'
-        ? moduleGroupNodeId(region.key)
-        : processGroupNodeId(region.key);
+    if (region.kind === 'module')
+        return moduleGroupNodeId(region.key);
+    if (region.kind === 'package')
+        return packageGroupNodeId(region.key);
+    return processGroupNodeId(region.key);
+}
+/**
+ * Repo/package key used for package frames — `purl` with fragment stripped.
+ * Externals and custom entities are not package-frame members.
+ */
+export function componentPackageKey(c) {
+    if (c.construct === 'external' || c.construct === 'custom_entity')
+        return undefined;
+    const key = purlRepoKey(c.purl);
+    if (!key || key === 'external')
+        return undefined;
+    return key;
+}
+function packageRegionLabel(packageKey) {
+    return purlOwnerName(packageKey) ?? formatPurl(packageKey);
 }
 /**
  * Derive process boundary regions — one per distinct non-empty `process`
@@ -172,22 +194,66 @@ export function getSubsystemModuleRegions(doc) {
     }));
 }
 /**
- * Build the process → module → leaf group tree for layout.
- * Multi-member modules nest under a process when every member shares that
- * process; process ELK children are nested module group ids plus any
- * process members that are not inside a kept module frame.
+ * Derive package (repo) boundary regions from component `purl`s — one per
+ * distinct repo key. Does not apply multi-repo / singleton filters; callers
+ * decide via {@link buildBoundaryLayoutGroups}.
  */
-export function buildBoundaryLayoutGroups(doc) {
+export function getSubsystemPackageRegions(doc) {
+    const byPackage = new Map();
+    for (const c of doc.components) {
+        const key = componentPackageKey(c);
+        if (!key)
+            continue;
+        const list = byPackage.get(key) ?? [];
+        list.push(c.id);
+        byPackage.set(key, list);
+    }
+    return [...byPackage.entries()].map(([key, memberIds]) => ({
+        kind: 'package',
+        key,
+        label: packageRegionLabel(key),
+        memberIds,
+    }));
+}
+function keepRegion(r, showSingletons) {
+    return showSingletons || r.memberIds.length >= 2;
+}
+/**
+ * Build the package → process → module → leaf group tree for layout.
+ *
+ * Package frames come from `purl` (no separate component field). By default
+ * they only appear when the graph spans 2+ distinct repos. Multi-member
+ * modules nest under a process when every member shares that process;
+ * processes nest under a package the same way.
+ */
+export function buildBoundaryLayoutGroups(doc, opts = {}) {
+    const showSingletons = opts.showSingletonFrames === true;
+    const packageMode = opts.packageFrames ?? 'multi-repo';
     const byId = new Map(doc.components.map((c) => [c.id, c]));
-    const modules = getSubsystemModuleRegions(doc).filter((r) => r.memberIds.length >= 2);
-    const processes = getSubsystemRegions(doc).filter((r) => r.memberIds.length >= 2);
+    const allPackages = getSubsystemPackageRegions(doc);
+    const packageEligible = packageMode === 'always'
+        ? true
+        : packageMode === 'never'
+            ? false
+            : allPackages.length >= 2;
+    const packages = packageEligible
+        ? allPackages.filter((r) => keepRegion(r, showSingletons))
+        : [];
+    const keptPackageKeys = new Set(packages.map((r) => r.key));
+    const modules = getSubsystemModuleRegions(doc).filter((r) => keepRegion(r, showSingletons));
+    const processes = getSubsystemRegions(doc).filter((r) => keepRegion(r, showSingletons));
     const keptProcessKeys = new Set(processes.map((r) => r.key));
     const moduleGroups = modules.map((r) => {
         const processesOfMembers = new Set();
+        const packagesOfMembers = new Set();
         for (const id of r.memberIds) {
-            const p = byId.get(id)?.process?.trim();
+            const c = byId.get(id);
+            const p = c?.process?.trim();
             if (p)
                 processesOfMembers.add(p);
+            const pkg = c ? componentPackageKey(c) : undefined;
+            if (pkg)
+                packagesOfMembers.add(pkg);
         }
         let parentId;
         if (processesOfMembers.size === 1) {
@@ -195,6 +261,11 @@ export function buildBoundaryLayoutGroups(doc) {
             if (keptProcessKeys.has(p))
                 parentId = processGroupNodeId(p);
         }
+        if (!parentId && packagesOfMembers.size === 1) {
+            const pkg = [...packagesOfMembers][0];
+            if (keptPackageKeys.has(pkg))
+                parentId = packageGroupNodeId(pkg);
+        }
         return {
             id: moduleGroupNodeId(r.key),
             memberIds: [...r.memberIds],
@@ -212,13 +283,51 @@ export function buildBoundaryLayoutGroups(doc) {
                 return true;
             return !nestedModuleKeys.has(mod);
         });
+        const packagesOfMembers = new Set();
+        for (const id of r.memberIds) {
+            const c = byId.get(id);
+            const pkg = c ? componentPackageKey(c) : undefined;
+            if (pkg)
+                packagesOfMembers.add(pkg);
+        }
+        let parentId;
+        if (packagesOfMembers.size === 1) {
+            const pkg = [...packagesOfMembers][0];
+            if (keptPackageKeys.has(pkg))
+                parentId = packageGroupNodeId(pkg);
+        }
         return {
             id: processId,
             memberIds: [...nestedModules.map((m) => m.id), ...directLeaves],
+            parentId,
             region: r,
         };
     });
-    return [...moduleGroups, ...processGroups];
+    const packageGroups = packages.map((r) => {
+        const packageId = packageGroupNodeId(r.key);
+        const nestedProcesses = processGroups.filter((p) => p.parentId === packageId);
+        const nestedModules = moduleGroups.filter((m) => m.parentId === packageId);
+        const claimed = new Set();
+        for (const p of nestedProcesses) {
+            for (const id of p.region.memberIds)
+                claimed.add(id);
+        }
+        for (const m of nestedModules) {
+            for (const id of m.region.memberIds)
+                claimed.add(id);
+        }
+        const directLeaves = r.memberIds.filter((id) => !claimed.has(id));
+        return {
+            id: packageId,
+            memberIds: [
+                ...nestedProcesses.map((p) => p.id),
+                ...nestedModules.map((m) => m.id),
+                ...directLeaves,
+            ],
+            region: r,
+        };
+    });
+    return [...moduleGroups, ...processGroups, ...packageGroups];
 }
 export const MECHANISM_COLOR = {
     imports: '#0893d2',
@@ -297,6 +406,13 @@ export const ROLE_COLOR = {
     entry: '#ff6b35',
     service: '#0893d2', // blue — external system
 };
+/**
+ * Brand color for the left construct/stereotype badge when a framework owns
+ * the label (e.g. `react · component`). Node border stays construct-colored.
+ */
+export const FRAMEWORK_BADGE_COLOR = {
+    react: '#61dafb', // React cyan
+};
 export const ROLE_LABEL = {
     entry: 'entry',
     service: 'service',
@@ -375,14 +491,24 @@ export function constructBadgeLabel(component) {
         return component.stereotype;
     return constructLabel ?? '';
 }
+/**
+ * Left-badge accent: framework brand when the badge shows a framework
+ * stereotype (e.g. React cyan for `react · component`); otherwise null so
+ * the caller falls back to construct color. Border stays construct-colored.
+ */
+export function constructBadgeColor(component) {
+    if (component.framework == null || component.stereotype == null)
+        return null;
+    return FRAMEWORK_BADGE_COLOR[component.framework] ?? null;
+}
 /** Default CSS floor for component nodes (padding aside). */
 export const NODE_CSS_MIN_WIDTH = 150;
 /** Inset of each top badge from the node edge (`left` / `right` style). */
 export const BADGE_EDGE_INSET = 5;
 /** Minimum gap between left construct badge and right role badge. */
 const BADGE_PAIR_GAP = 8;
-/** Badge box chrome: padding 5+5 + border 1+1. */
-const BADGE_BOX_CHROME = 12;
+/** Badge box chrome: padding 8+8 + border 2+2. */
+const BADGE_BOX_CHROME = 20;
 /** Approx monospace uppercase width incl. letter-spacing (~0.5px). */
 const BADGE_CHAR_WIDTH = 8;
 /** Estimated rendered width of a top tab badge label. */
@@ -411,11 +537,11 @@ export function nodeMinWidthForBadges(component) {
 /**
  * Convert a subsystem graph document into React Flow nodes. Components that
  * carry a `module` get a `parentId` pointing at their module frame
- * (`module:<path>`); otherwise a `process` stamps `process:<process>`. Module
- * frames may themselves nest under a process frame (stamped on the group node
- * in `buildSubsystemGraph`). Nodes without either stay top-level. The initial
- * grid clusters by `module ?? process ?? purl`; ELK then refines with compound
- * layout.
+ * (`module:<path>`); otherwise a `process` stamps `process:<process>`.
+ * Package (`purl`) parents are stamped later in `buildSubsystemGraph` only
+ * when package frames are kept. Module frames may nest under process →
+ * package. The initial grid clusters by `module ?? process ?? purl`; ELK
+ * then refines with compound layout.
  */
 export function convertSubsystemToNodes(doc, opts = {}) {
     const { maxNodeWidth } = opts;
@@ -477,12 +603,12 @@ export function convertSubsystemToNodes(doc, opts = {}) {
     return nodes;
 }
 /**
- * Convert boundary regions into React Flow parent (group) nodes. Module
- * frames that share a process nest under that process via `parentId`.
+ * Convert boundary regions into React Flow parent (group) nodes. Nesting
+ * (package → process → module) is stamped via `parentId` on groups.
  * Positions/sizes are placeholders — ELK compound layout overwrites them.
  */
-export function convertSubsystemToGroups(doc) {
-    return buildBoundaryLayoutGroups(doc).map((g) => ({
+export function convertSubsystemToGroups(doc, opts = {}) {
+    return buildBoundaryLayoutGroups(doc, opts).map((g) => ({
         id: g.id,
         type: 'subsystem-group',
         position: { x: 0, y: 0 },
@@ -541,33 +667,39 @@ export function subsystemGraphLayoutKey(doc) {
  * layered with minimized crossings.
  */
 export async function buildSubsystemGraph(doc, opts = {}) {
-    const { maxNodeWidth, showEdgeLabels, measuredWidths, measuredHeights } = opts;
+    const { maxNodeWidth, showEdgeLabels, measuredWidths, measuredHeights, showSingletonFrames, packageFrames, } = opts;
+    const frameOpts = { showSingletonFrames, packageFrames };
     const nodes = convertSubsystemToNodes(doc, { maxNodeWidth });
     const edges = convertSubsystemToEdges(doc);
-    // Nested boundary tree: process → module → leaves (when both fields set).
-    const layoutGroups = buildBoundaryLayoutGroups(doc);
+    // Nested boundary tree: package → process → module → leaves.
+    const layoutGroups = buildBoundaryLayoutGroups(doc, frameOpts);
     const regions = layoutGroups.map((g) => g.region);
     const regionIds = new Set(layoutGroups.map((g) => g.id));
     const byId = new Map(doc.components.map((c) => [c.id, c]));
-    // Drop leaf parentIds that point at singleton / missing frames; fall back
-    // from a dropped module frame to a kept process frame when possible.
+    // Resolve leaf parentIds against kept frames: module → process → package.
+    // Stamp package parents here (not in convertSubsystemToNodes) so single-repo
+    // graphs never provisionally parent under a package that will be dropped.
     for (const n of nodes) {
         if (n.type !== 'subsystem-component')
             continue;
         const parentId = n.parentId;
-        if (!parentId)
-            continue;
-        if (regionIds.has(parentId))
+        if (parentId && regionIds.has(parentId))
             continue;
-        const comp = n.data.component;
-        const processKey = comp?.process?.trim() || byId.get(n.id)?.process?.trim();
+        const comp = n.data.component ?? byId.get(n.id);
+        const processKey = comp?.process?.trim();
         const processId = processKey ? processGroupNodeId(processKey) : undefined;
         if (processId && regionIds.has(processId)) {
             n.parentId = processId;
+            continue;
         }
-        else {
-            delete n.parentId;
+        const packageKey = comp ? componentPackageKey(comp) : undefined;
+        const packageId = packageKey ? packageGroupNodeId(packageKey) : undefined;
+        if (packageId && regionIds.has(packageId)) {
+            n.parentId = packageId;
+            continue;
         }
+        if (parentId)
+            delete n.parentId;
     }
     // External edge targets that aren't real components → create stub nodes so
     // cross-package edges have something to land on.
@@ -640,7 +772,8 @@ export async function buildSubsystemGraph(doc, opts = {}) {
                 })),
             });
             const builtGroupIds = new Set(result.groupBounds.keys());
-            // Parents before children — process frames, then nested module frames.
+            // Parents before children — package, then process, then module frames.
+            const packageGroupNodes = [];
             const processGroupNodes = [];
             const moduleGroupNodes = [];
             for (const g of layoutGroups) {
@@ -657,7 +790,9 @@ export async function buildSubsystemGraph(doc, opts = {}) {
                     ...(parentId ? { parentId } : {}),
                     data: { region: g.region },
                 };
-                if (g.region.kind === 'process')
+                if (g.region.kind === 'package')
+                    packageGroupNodes.push(group);
+                else if (g.region.kind === 'process')
                     processGroupNodes.push(group);
                 else
                     moduleGroupNodes.push(group);
@@ -672,6 +807,7 @@ export async function buildSubsystemGraph(doc, opts = {}) {
                 }
             }
             placedNodes = [
+                ...packageGroupNodes,
                 ...processGroupNodes,
                 ...moduleGroupNodes,
                 ...result.nodes,
@@ -684,6 +820,7 @@ export async function buildSubsystemGraph(doc, opts = {}) {
             // Fall back to the (unpositioned) grid if ELK is unavailable — still
             // emit multi-member frames so parentId targets exist.
             console.warn('[subsystem-graph] ELK layout failed, using manual positions:', err);
+            const packageGroupNodes = [];
             const processGroupNodes = [];
             const moduleGroupNodes = [];
             for (const g of layoutGroups) {
@@ -696,12 +833,19 @@ export async function buildSubsystemGraph(doc, opts = {}) {
                     ...(g.parentId ? { parentId: g.parentId } : {}),
                     data: { region: g.region },
                 };
-                if (g.region.kind === 'process')
+                if (g.region.kind === 'package')
+                    packageGroupNodes.push(group);
+                else if (g.region.kind === 'process')
                     processGroupNodes.push(group);
                 else
                     moduleGroupNodes.push(group);
             }
-            placedNodes = [...processGroupNodes, ...moduleGroupNodes, ...nodes];
+            placedNodes = [
+                ...packageGroupNodes,
+                ...processGroupNodes,
+                ...moduleGroupNodes,
+                ...nodes,
+            ];
         }
     }
     // Stamp ELK-computed label midpoints onto edge data so the overlay can