@crazyhappyone/auto-graph 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -434,7 +434,7 @@ interface ConstraintSolverInput {
     direction: DiagramDirection;
     overlapSpacing?: number;
     minSiblingGap?: number;
-    distributeContainedChildren?: boolean;
+    distributeContainedChildren?: boolean | "spread";
     boxes: ReadonlyMap<string, Box>;
     nodes: readonly NormalizedNode[];
     groups: readonly NormalizedGroup[];
@@ -448,6 +448,19 @@ interface ConstraintSolverResult {
 
 declare function applyLayoutConstraints(input: ConstraintSolverInput): ConstraintSolverResult;
 
+interface QualityMetric {
+    readonly kind: QualityMetricKind;
+    readonly value: number;
+    readonly label: string;
+}
+type QualityMetricKind = "node-overlap" | "edge-crossing" | "bend-count" | "route-backtrack" | "label-collision";
+interface QualityReport {
+    readonly metrics: QualityMetric[];
+    /** Aggregate score 0–100 (higher = better). */
+    readonly score: number;
+    readonly diagnostics: Diagnostic[];
+}
+
 type DiagramStage = "intent" | "normalized" | "coordinated";
 type DiagramMetadata = JsonObject;
 interface IntentDiagram {
@@ -499,6 +512,7 @@ interface CoordinatedDiagram {
     bounds: Box;
     frame?: CoordinatedFrame;
     metadata?: DiagramMetadata;
+    qualityReport?: QualityReport;
 }
 
 type DslDiagnosticLayer = "parse" | "validate" | "solve" | "export" | "io";
@@ -568,6 +582,8 @@ interface ExportResult {
 }
 interface ExportOptions {
     title?: string;
+    /** Padding around diagram bounds for viewport metadata, in pixels. */
+    viewportPadding?: number;
 }
 
 declare function resolveOutputFormat(cliFormat?: string, dslFormat?: DslOutputFormat): {
@@ -597,6 +613,11 @@ declare function boxCenter(box: Box): Point;
 declare function expandBox(box: Box, margin: number | Insets): Box;
 declare function unionBoxes(boxes: readonly Box[]): Box;
 declare function intersectsAabb(a: Box, b: Box): boolean;
+/**
+ * Area of overlap between two boxes, in square pixels.
+ * Returns 0 when the boxes do not intersect.
+ */
+declare function overlapArea(first: Box, second: Box): number;
 
 interface LabelFitOptions {
     font: TextStyleOptions;
@@ -648,12 +669,27 @@ interface ShapeGeometry {
 declare function computeShapeGeometry(input: ShapeGeometryInput): ShapeGeometry;
 declare function getEdgePort(geometry: ShapeGeometry, toward: Point, preferredAnchor?: AnchorName): Point;
 
+interface BoxSpatialIndexEntry {
+    id: string;
+    box: Box;
+}
+interface BoxSpatialIndex {
+    cellSize: number;
+    entries: ReadonlyMap<string, Box>;
+    cells: ReadonlyMap<string, readonly string[]>;
+}
+declare function createBoxSpatialIndex(entries: Iterable<BoxSpatialIndexEntry>, cellSize?: number): BoxSpatialIndex;
+declare function queryBoxSpatialIndex(index: BoxSpatialIndex, box: Box): BoxSpatialIndexEntry[];
+declare function querySegmentSpatialIndex(index: BoxSpatialIndex, start: Point, end: Point): BoxSpatialIndexEntry[];
+declare function expandBoxForQuery(box: Box, margin: number): Box;
+
 interface DagreLayoutOptions {
     nodesep: number;
     ranksep: number;
     edgesep: number;
     marginx: number;
     marginy: number;
+    componentGap: number;
     ranker: "network-simplex" | "tight-tree" | "longest-path";
 }
 interface DagreLayoutNode {
@@ -677,6 +713,7 @@ interface InitialLayoutResult {
 }
 
 declare function runDagreInitialLayout(input: DagreLayoutInput): InitialLayoutResult;
+declare function runComponentAwareDagreInitialLayout(input: DagreLayoutInput): InitialLayoutResult;
 
 type RouteKind = "orthogonal" | "straight" | "obstacle-avoiding";
 interface RouteEdgeInput {
@@ -688,6 +725,8 @@ interface RouteEdgeInput {
     targetAnchor?: AnchorName;
     obstacles?: readonly Box[];
     hardObstacles?: readonly Box[];
+    obstacleIndex?: BoxSpatialIndex;
+    hardObstacleIndex?: BoxSpatialIndex;
     /** Maximum greedy rerouting iterations (default 5). */
     maxRoutingAttempts?: number;
 }
@@ -709,16 +748,21 @@ type CanonicalJson = null | boolean | number | string | CanonicalJson[] | {
 declare function canonicalize(value: unknown, options?: CanonicalizeOptions): CanonicalJson;
 declare function stringifyCanonical(value: unknown, precision?: number): string;
 
+type InitialLayoutMode = "dagre" | "positions";
 interface SolveDiagramOptions {
+    /** Selects the seed coordinates before constraints, routing, and export. */
+    initialLayout?: InitialLayoutMode;
     routeKind?: RouteKind;
     obstacleMargin?: number | Insets;
+    /** When true, compute quality score after solving (Issue #54, 方案 E). */
+    qualityScore?: boolean;
     /** Extra horizontal/vertical clearance reserved around nodes for edge corridors. */
     routingGutter?: number;
     overlapSpacing?: number;
     minLaneGutter?: number;
     prefitLabelSize?: boolean;
     minSiblingGap?: number;
-    distributeContainedChildren?: boolean;
+    distributeContainedChildren?: boolean | "spread";
     pageBounds?: {
         width: number;
         height: number;
@@ -753,5 +797,73 @@ declare function solveDiagram(diagram: NormalizedDiagram, options?: SolveDiagram
  * @see SolveDiagramOptions.prefitLabelSize
  */
 declare function solveDiagramSafe(diagram: NormalizedDiagram, options?: SolveDiagramOptions): CoordinatedDiagram;
+/**
+ * Build the default layout pipeline. Currently wraps `solveDiagram` in
+ * a single mega-phase so custom callers can replace individual phases
+ * (e.g. "initial-layout", "route-edges") without touching the rest.
+ *
+ * Individual phases will be extracted from the mega-phase in follow-up
+ * PRs for 方案 A (recursive layout) and 方案 B (corner-graph A*).
+ */
+declare function createDefaultPipeline(): LayoutPipeline;
+
+/** Shared mutable state flowing through every pipeline phase. */
+interface LayoutState {
+    diagram: NormalizedDiagram;
+    options: SolveDiagramOptions;
+    nodes: NormalizedNode[];
+    edges: NormalizedEdge[];
+    groups: NormalizedGroup[];
+    swimlanes: Swimlane[];
+    constraints: Constraint[];
+    boxes: Map<string, Box>;
+    locks: Map<string, LayoutLock>;
+    nodeGeometry: Map<string, ShapeGeometry>;
+    coordinatedNodes: CoordinatedNode[];
+    coordinatedEdges: CoordinatedEdge[];
+    coordinatedGroups: CoordinatedGroup[];
+    coordinatedMatrices: CoordinatedMatrixBlock[];
+    coordinatedTables: CoordinatedTableBlock[];
+    coordinatedEvidencePanels: CoordinatedEvidencePanel[];
+    frame?: CoordinatedFrame;
+    baseTextAnnotations: SolvedTextAnnotation[];
+    edgeTextAnnotations: SolvedTextAnnotation[];
+    contentBounds: Box;
+    bounds: Box;
+    degraded: boolean;
+    diagnostics: Diagnostic[];
+    qualityReport?: QualityReport;
+    phaseTrace: PhaseTraceEntry[];
+}
+interface PhaseTraceEntry {
+    phase: string;
+    durationMs: number;
+    diagnosticsAdded: number;
+}
+/** A single pipeline phase — mutates `state` in-place. */
+interface LayoutPhase {
+    readonly name: string;
+    run(state: LayoutState): void;
+}
+
+/**
+ * Pluggable layout pipeline (Issue #54, 方案 D).
+ *
+ * Phases run sequentially, each mutating the shared LayoutState.
+ * Custom pipelines are built with the fluent builder API:
+ *
+ *   new LayoutPipeline()
+ *     .addPhase(myPhase)
+ *     .addBefore("apply-constraints", prePhase)
+ *     .run(diagram, options);
+ */
+declare class LayoutPipeline {
+    private phases;
+    addPhase(phase: LayoutPhase): this;
+    addBefore(refName: string, phase: LayoutPhase): this;
+    addAfter(refName: string, phase: LayoutPhase): this;
+    replacePhase(name: string, phase: LayoutPhase): this;
+    run(state: LayoutState): void;
+}
 
-export { type AlignConstraint, type AlignmentAxis, type AnchorName, type AnchorPoint, type Arrowhead, type Box, type CanonicalJson, type CanonicalizeOptions, type Constraint, type ConstraintBase, type ConstraintSolverInput, type ConstraintSolverResult, type ConstraintTarget, type ConstraintTargetKind, type ContainerGeometry, type ContainerGeometryInput, type ContainmentConstraint, type CoordinatedDiagram, type CoordinatedEdge, type CoordinatedEvidencePanel, type CoordinatedFrame, type CoordinatedGroup, type CoordinatedMatrixBlock, type CoordinatedNode, type CoordinatedPort, type CoordinatedTableBlock, DEFAULT_CANONICAL_PRECISION, DEFAULT_DSL_MAX_BYTES, DELIVERABILITY_DIAGNOSTIC_CODES, type DagreLayoutEdge, type DagreLayoutInput, type DagreLayoutNode, type DagreLayoutOptions, type DefaultTextMeasurerOptions, DeterministicTextMeasurer, type Diagnostic, type DiagnosticPathSegment, type DiagnosticSeverity, type DiagramDirection, type DiagramFrame, type DiagramMetadata, type DiagramStage, type DistributeConstraint, type DistributionAxis, type DslDiagnostic, type DslDiagnosticLayer, type DslOutputFormat, type EdgeArrowhead, type EdgeEndpoint, type EdgeStrokeStyle, type EvidenceCell, type EvidencePanel, type EvidencePanelItem, type EvidencePanelKind, type EvidenceTextLayout, type ExactPositionConstraint, type ExportFormat, type ExportOptions, type ExportResult, type InitialLayoutResult, type Insets, type IntentDiagram, type IntentEdge, type IntentGroup, type IntentNode, type JsonObject, type JsonPrimitive, type JsonValue, type Label, type LabelFitOptions, LabelFitter, type LabelLayout, type LabelLineLayout, type LayoutLock, type LayoutLockSource, type MatrixBlock, type NodeBase, type NodeCompartments, type NodePort, type NodeShape, type NormalizeDiagramDslOptions, type NormalizeDiagramDslResult, type NormalizedDiagram, type NormalizedEdge, type NormalizedGroup, type NormalizedNode, type ParseDiagramDslOptions, type ParseDiagramDslResult, type ParsedEdgeShorthand, type Point, type PortKind, type PortShiftingOptions, type PortSide, type PreparedText, PretextTextMeasurer, type RelativePositionConstraint, type RelativePositionRelation, type RenderDiagramDslOptions, type RenderDiagramDslResult, type RouteEdgeInput, type RouteEdgeResult, type RouteKind, type ShapeGeometry, type ShapeGeometryInput, type Size, type SolveDiagramOptions, type SolvedTextAnnotation, type Swimlane, type SwimlaneLane, type SwimlaneLayout, type SwimlaneOrientation, type TableBlock, type TableColumn, type TableRow, type TextCursor, type TextLayout, type TextLayoutLine, type TextMeasurementBackend, type TextMeasurer, type TextStyleOptions, type TextSurfaceKind, type VisualStyle, applyLayoutConstraints, assertFiniteNonNegative, assertFinitePositive, boxCenter, canonicalize, computeArrowhead, computeContainerGeometry, computeShapeGeometry, createDefaultTextMeasurer, expandBox, exportExcalidraw, exportSvg, fitLabel, getEdgePort, installNodeCanvasRuntime, intersectsAabb, isPretextRuntimeAvailable, normalizeDiagramDsl, normalizeInsets, parseDiagramDsl, parseEdgeShorthand, renderDiagramDsl, resolveLineHeight, resolveOutputFormat, routeEdge, runDagreInitialLayout, simplifyRoute, solveDiagram, solveDiagramSafe, sortDslDiagnostics, stringifyCanonical, toCanvasFont, unionBoxes, validateBox, validateTextStyle };
+export { type AlignConstraint, type AlignmentAxis, type AnchorName, type AnchorPoint, type Arrowhead, type Box, type BoxSpatialIndex, type BoxSpatialIndexEntry, type CanonicalJson, type CanonicalizeOptions, type Constraint, type ConstraintBase, type ConstraintSolverInput, type ConstraintSolverResult, type ConstraintTarget, type ConstraintTargetKind, type ContainerGeometry, type ContainerGeometryInput, type ContainmentConstraint, type CoordinatedDiagram, type CoordinatedEdge, type CoordinatedEvidencePanel, type CoordinatedFrame, type CoordinatedGroup, type CoordinatedMatrixBlock, type CoordinatedNode, type CoordinatedPort, type CoordinatedTableBlock, DEFAULT_CANONICAL_PRECISION, DEFAULT_DSL_MAX_BYTES, DELIVERABILITY_DIAGNOSTIC_CODES, type DagreLayoutEdge, type DagreLayoutInput, type DagreLayoutNode, type DagreLayoutOptions, type DefaultTextMeasurerOptions, DeterministicTextMeasurer, type Diagnostic, type DiagnosticPathSegment, type DiagnosticSeverity, type DiagramDirection, type DiagramFrame, type DiagramMetadata, type DiagramStage, type DistributeConstraint, type DistributionAxis, type DslDiagnostic, type DslDiagnosticLayer, type DslOutputFormat, type EdgeArrowhead, type EdgeEndpoint, type EdgeStrokeStyle, type EvidenceCell, type EvidencePanel, type EvidencePanelItem, type EvidencePanelKind, type EvidenceTextLayout, type ExactPositionConstraint, type ExportFormat, type ExportOptions, type ExportResult, type InitialLayoutMode, type InitialLayoutResult, type Insets, type IntentDiagram, type IntentEdge, type IntentGroup, type IntentNode, type JsonObject, type JsonPrimitive, type JsonValue, type Label, type LabelFitOptions, LabelFitter, type LabelLayout, type LabelLineLayout, type LayoutLock, type LayoutLockSource, type LayoutPhase, LayoutPipeline, type LayoutState, type MatrixBlock, type NodeBase, type NodeCompartments, type NodePort, type NodeShape, type NormalizeDiagramDslOptions, type NormalizeDiagramDslResult, type NormalizedDiagram, type NormalizedEdge, type NormalizedGroup, type NormalizedNode, type ParseDiagramDslOptions, type ParseDiagramDslResult, type ParsedEdgeShorthand, type PhaseTraceEntry, type Point, type PortKind, type PortShiftingOptions, type PortSide, type PreparedText, PretextTextMeasurer, type RelativePositionConstraint, type RelativePositionRelation, type RenderDiagramDslOptions, type RenderDiagramDslResult, type RouteEdgeInput, type RouteEdgeResult, type RouteKind, type ShapeGeometry, type ShapeGeometryInput, type Size, type SolveDiagramOptions, type SolvedTextAnnotation, type Swimlane, type SwimlaneLane, type SwimlaneLayout, type SwimlaneOrientation, type TableBlock, type TableColumn, type TableRow, type TextCursor, type TextLayout, type TextLayoutLine, type TextMeasurementBackend, type TextMeasurer, type TextStyleOptions, type TextSurfaceKind, type VisualStyle, applyLayoutConstraints, assertFiniteNonNegative, assertFinitePositive, boxCenter, canonicalize, computeArrowhead, computeContainerGeometry, computeShapeGeometry, createBoxSpatialIndex, createDefaultPipeline, createDefaultTextMeasurer, expandBox, expandBoxForQuery, exportExcalidraw, exportSvg, fitLabel, getEdgePort, installNodeCanvasRuntime, intersectsAabb, isPretextRuntimeAvailable, normalizeDiagramDsl, normalizeInsets, overlapArea, parseDiagramDsl, parseEdgeShorthand, queryBoxSpatialIndex, querySegmentSpatialIndex, renderDiagramDsl, resolveLineHeight, resolveOutputFormat, routeEdge, runComponentAwareDagreInitialLayout, runDagreInitialLayout, simplifyRoute, solveDiagram, solveDiagramSafe, sortDslDiagnostics, stringifyCanonical, toCanvasFont, unionBoxes, validateBox, validateTextStyle };

package/dist/index.d.ts

@@ -434,7 +434,7 @@ interface ConstraintSolverInput {
     direction: DiagramDirection;
     overlapSpacing?: number;
     minSiblingGap?: number;
-    distributeContainedChildren?: boolean;
+    distributeContainedChildren?: boolean | "spread";
     boxes: ReadonlyMap<string, Box>;
     nodes: readonly NormalizedNode[];
     groups: readonly NormalizedGroup[];
@@ -448,6 +448,19 @@ interface ConstraintSolverResult {
 
 declare function applyLayoutConstraints(input: ConstraintSolverInput): ConstraintSolverResult;
 
+interface QualityMetric {
+    readonly kind: QualityMetricKind;
+    readonly value: number;
+    readonly label: string;
+}
+type QualityMetricKind = "node-overlap" | "edge-crossing" | "bend-count" | "route-backtrack" | "label-collision";
+interface QualityReport {
+    readonly metrics: QualityMetric[];
+    /** Aggregate score 0–100 (higher = better). */
+    readonly score: number;
+    readonly diagnostics: Diagnostic[];
+}
+
 type DiagramStage = "intent" | "normalized" | "coordinated";
 type DiagramMetadata = JsonObject;
 interface IntentDiagram {
@@ -499,6 +512,7 @@ interface CoordinatedDiagram {
     bounds: Box;
     frame?: CoordinatedFrame;
     metadata?: DiagramMetadata;
+    qualityReport?: QualityReport;
 }
 
 type DslDiagnosticLayer = "parse" | "validate" | "solve" | "export" | "io";
@@ -568,6 +582,8 @@ interface ExportResult {
 }
 interface ExportOptions {
     title?: string;
+    /** Padding around diagram bounds for viewport metadata, in pixels. */
+    viewportPadding?: number;
 }
 
 declare function resolveOutputFormat(cliFormat?: string, dslFormat?: DslOutputFormat): {
@@ -597,6 +613,11 @@ declare function boxCenter(box: Box): Point;
 declare function expandBox(box: Box, margin: number | Insets): Box;
 declare function unionBoxes(boxes: readonly Box[]): Box;
 declare function intersectsAabb(a: Box, b: Box): boolean;
+/**
+ * Area of overlap between two boxes, in square pixels.
+ * Returns 0 when the boxes do not intersect.
+ */
+declare function overlapArea(first: Box, second: Box): number;
 
 interface LabelFitOptions {
     font: TextStyleOptions;
@@ -648,12 +669,27 @@ interface ShapeGeometry {
 declare function computeShapeGeometry(input: ShapeGeometryInput): ShapeGeometry;
 declare function getEdgePort(geometry: ShapeGeometry, toward: Point, preferredAnchor?: AnchorName): Point;
 
+interface BoxSpatialIndexEntry {
+    id: string;
+    box: Box;
+}
+interface BoxSpatialIndex {
+    cellSize: number;
+    entries: ReadonlyMap<string, Box>;
+    cells: ReadonlyMap<string, readonly string[]>;
+}
+declare function createBoxSpatialIndex(entries: Iterable<BoxSpatialIndexEntry>, cellSize?: number): BoxSpatialIndex;
+declare function queryBoxSpatialIndex(index: BoxSpatialIndex, box: Box): BoxSpatialIndexEntry[];
+declare function querySegmentSpatialIndex(index: BoxSpatialIndex, start: Point, end: Point): BoxSpatialIndexEntry[];
+declare function expandBoxForQuery(box: Box, margin: number): Box;
+
 interface DagreLayoutOptions {
     nodesep: number;
     ranksep: number;
     edgesep: number;
     marginx: number;
     marginy: number;
+    componentGap: number;
     ranker: "network-simplex" | "tight-tree" | "longest-path";
 }
 interface DagreLayoutNode {
@@ -677,6 +713,7 @@ interface InitialLayoutResult {
 }
 
 declare function runDagreInitialLayout(input: DagreLayoutInput): InitialLayoutResult;
+declare function runComponentAwareDagreInitialLayout(input: DagreLayoutInput): InitialLayoutResult;
 
 type RouteKind = "orthogonal" | "straight" | "obstacle-avoiding";
 interface RouteEdgeInput {
@@ -688,6 +725,8 @@ interface RouteEdgeInput {
     targetAnchor?: AnchorName;
     obstacles?: readonly Box[];
     hardObstacles?: readonly Box[];
+    obstacleIndex?: BoxSpatialIndex;
+    hardObstacleIndex?: BoxSpatialIndex;
     /** Maximum greedy rerouting iterations (default 5). */
     maxRoutingAttempts?: number;
 }
@@ -709,16 +748,21 @@ type CanonicalJson = null | boolean | number | string | CanonicalJson[] | {
 declare function canonicalize(value: unknown, options?: CanonicalizeOptions): CanonicalJson;
 declare function stringifyCanonical(value: unknown, precision?: number): string;
 
+type InitialLayoutMode = "dagre" | "positions";
 interface SolveDiagramOptions {
+    /** Selects the seed coordinates before constraints, routing, and export. */
+    initialLayout?: InitialLayoutMode;
     routeKind?: RouteKind;
     obstacleMargin?: number | Insets;
+    /** When true, compute quality score after solving (Issue #54, 方案 E). */
+    qualityScore?: boolean;
     /** Extra horizontal/vertical clearance reserved around nodes for edge corridors. */
     routingGutter?: number;
     overlapSpacing?: number;
     minLaneGutter?: number;
     prefitLabelSize?: boolean;
     minSiblingGap?: number;
-    distributeContainedChildren?: boolean;
+    distributeContainedChildren?: boolean | "spread";
     pageBounds?: {
         width: number;
         height: number;
@@ -753,5 +797,73 @@ declare function solveDiagram(diagram: NormalizedDiagram, options?: SolveDiagram
  * @see SolveDiagramOptions.prefitLabelSize
  */
 declare function solveDiagramSafe(diagram: NormalizedDiagram, options?: SolveDiagramOptions): CoordinatedDiagram;
+/**
+ * Build the default layout pipeline. Currently wraps `solveDiagram` in
+ * a single mega-phase so custom callers can replace individual phases
+ * (e.g. "initial-layout", "route-edges") without touching the rest.
+ *
+ * Individual phases will be extracted from the mega-phase in follow-up
+ * PRs for 方案 A (recursive layout) and 方案 B (corner-graph A*).
+ */
+declare function createDefaultPipeline(): LayoutPipeline;
+
+/** Shared mutable state flowing through every pipeline phase. */
+interface LayoutState {
+    diagram: NormalizedDiagram;
+    options: SolveDiagramOptions;
+    nodes: NormalizedNode[];
+    edges: NormalizedEdge[];
+    groups: NormalizedGroup[];
+    swimlanes: Swimlane[];
+    constraints: Constraint[];
+    boxes: Map<string, Box>;
+    locks: Map<string, LayoutLock>;
+    nodeGeometry: Map<string, ShapeGeometry>;
+    coordinatedNodes: CoordinatedNode[];
+    coordinatedEdges: CoordinatedEdge[];
+    coordinatedGroups: CoordinatedGroup[];
+    coordinatedMatrices: CoordinatedMatrixBlock[];
+    coordinatedTables: CoordinatedTableBlock[];
+    coordinatedEvidencePanels: CoordinatedEvidencePanel[];
+    frame?: CoordinatedFrame;
+    baseTextAnnotations: SolvedTextAnnotation[];
+    edgeTextAnnotations: SolvedTextAnnotation[];
+    contentBounds: Box;
+    bounds: Box;
+    degraded: boolean;
+    diagnostics: Diagnostic[];
+    qualityReport?: QualityReport;
+    phaseTrace: PhaseTraceEntry[];
+}
+interface PhaseTraceEntry {
+    phase: string;
+    durationMs: number;
+    diagnosticsAdded: number;
+}
+/** A single pipeline phase — mutates `state` in-place. */
+interface LayoutPhase {
+    readonly name: string;
+    run(state: LayoutState): void;
+}
+
+/**
+ * Pluggable layout pipeline (Issue #54, 方案 D).
+ *
+ * Phases run sequentially, each mutating the shared LayoutState.
+ * Custom pipelines are built with the fluent builder API:
+ *
+ *   new LayoutPipeline()
+ *     .addPhase(myPhase)
+ *     .addBefore("apply-constraints", prePhase)
+ *     .run(diagram, options);
+ */
+declare class LayoutPipeline {
+    private phases;
+    addPhase(phase: LayoutPhase): this;
+    addBefore(refName: string, phase: LayoutPhase): this;
+    addAfter(refName: string, phase: LayoutPhase): this;
+    replacePhase(name: string, phase: LayoutPhase): this;
+    run(state: LayoutState): void;
+}
 
-export { type AlignConstraint, type AlignmentAxis, type AnchorName, type AnchorPoint, type Arrowhead, type Box, type CanonicalJson, type CanonicalizeOptions, type Constraint, type ConstraintBase, type ConstraintSolverInput, type ConstraintSolverResult, type ConstraintTarget, type ConstraintTargetKind, type ContainerGeometry, type ContainerGeometryInput, type ContainmentConstraint, type CoordinatedDiagram, type CoordinatedEdge, type CoordinatedEvidencePanel, type CoordinatedFrame, type CoordinatedGroup, type CoordinatedMatrixBlock, type CoordinatedNode, type CoordinatedPort, type CoordinatedTableBlock, DEFAULT_CANONICAL_PRECISION, DEFAULT_DSL_MAX_BYTES, DELIVERABILITY_DIAGNOSTIC_CODES, type DagreLayoutEdge, type DagreLayoutInput, type DagreLayoutNode, type DagreLayoutOptions, type DefaultTextMeasurerOptions, DeterministicTextMeasurer, type Diagnostic, type DiagnosticPathSegment, type DiagnosticSeverity, type DiagramDirection, type DiagramFrame, type DiagramMetadata, type DiagramStage, type DistributeConstraint, type DistributionAxis, type DslDiagnostic, type DslDiagnosticLayer, type DslOutputFormat, type EdgeArrowhead, type EdgeEndpoint, type EdgeStrokeStyle, type EvidenceCell, type EvidencePanel, type EvidencePanelItem, type EvidencePanelKind, type EvidenceTextLayout, type ExactPositionConstraint, type ExportFormat, type ExportOptions, type ExportResult, type InitialLayoutResult, type Insets, type IntentDiagram, type IntentEdge, type IntentGroup, type IntentNode, type JsonObject, type JsonPrimitive, type JsonValue, type Label, type LabelFitOptions, LabelFitter, type LabelLayout, type LabelLineLayout, type LayoutLock, type LayoutLockSource, type MatrixBlock, type NodeBase, type NodeCompartments, type NodePort, type NodeShape, type NormalizeDiagramDslOptions, type NormalizeDiagramDslResult, type NormalizedDiagram, type NormalizedEdge, type NormalizedGroup, type NormalizedNode, type ParseDiagramDslOptions, type ParseDiagramDslResult, type ParsedEdgeShorthand, type Point, type PortKind, type PortShiftingOptions, type PortSide, type PreparedText, PretextTextMeasurer, type RelativePositionConstraint, type RelativePositionRelation, type RenderDiagramDslOptions, type RenderDiagramDslResult, type RouteEdgeInput, type RouteEdgeResult, type RouteKind, type ShapeGeometry, type ShapeGeometryInput, type Size, type SolveDiagramOptions, type SolvedTextAnnotation, type Swimlane, type SwimlaneLane, type SwimlaneLayout, type SwimlaneOrientation, type TableBlock, type TableColumn, type TableRow, type TextCursor, type TextLayout, type TextLayoutLine, type TextMeasurementBackend, type TextMeasurer, type TextStyleOptions, type TextSurfaceKind, type VisualStyle, applyLayoutConstraints, assertFiniteNonNegative, assertFinitePositive, boxCenter, canonicalize, computeArrowhead, computeContainerGeometry, computeShapeGeometry, createDefaultTextMeasurer, expandBox, exportExcalidraw, exportSvg, fitLabel, getEdgePort, installNodeCanvasRuntime, intersectsAabb, isPretextRuntimeAvailable, normalizeDiagramDsl, normalizeInsets, parseDiagramDsl, parseEdgeShorthand, renderDiagramDsl, resolveLineHeight, resolveOutputFormat, routeEdge, runDagreInitialLayout, simplifyRoute, solveDiagram, solveDiagramSafe, sortDslDiagnostics, stringifyCanonical, toCanvasFont, unionBoxes, validateBox, validateTextStyle };
+export { type AlignConstraint, type AlignmentAxis, type AnchorName, type AnchorPoint, type Arrowhead, type Box, type BoxSpatialIndex, type BoxSpatialIndexEntry, type CanonicalJson, type CanonicalizeOptions, type Constraint, type ConstraintBase, type ConstraintSolverInput, type ConstraintSolverResult, type ConstraintTarget, type ConstraintTargetKind, type ContainerGeometry, type ContainerGeometryInput, type ContainmentConstraint, type CoordinatedDiagram, type CoordinatedEdge, type CoordinatedEvidencePanel, type CoordinatedFrame, type CoordinatedGroup, type CoordinatedMatrixBlock, type CoordinatedNode, type CoordinatedPort, type CoordinatedTableBlock, DEFAULT_CANONICAL_PRECISION, DEFAULT_DSL_MAX_BYTES, DELIVERABILITY_DIAGNOSTIC_CODES, type DagreLayoutEdge, type DagreLayoutInput, type DagreLayoutNode, type DagreLayoutOptions, type DefaultTextMeasurerOptions, DeterministicTextMeasurer, type Diagnostic, type DiagnosticPathSegment, type DiagnosticSeverity, type DiagramDirection, type DiagramFrame, type DiagramMetadata, type DiagramStage, type DistributeConstraint, type DistributionAxis, type DslDiagnostic, type DslDiagnosticLayer, type DslOutputFormat, type EdgeArrowhead, type EdgeEndpoint, type EdgeStrokeStyle, type EvidenceCell, type EvidencePanel, type EvidencePanelItem, type EvidencePanelKind, type EvidenceTextLayout, type ExactPositionConstraint, type ExportFormat, type ExportOptions, type ExportResult, type InitialLayoutMode, type InitialLayoutResult, type Insets, type IntentDiagram, type IntentEdge, type IntentGroup, type IntentNode, type JsonObject, type JsonPrimitive, type JsonValue, type Label, type LabelFitOptions, LabelFitter, type LabelLayout, type LabelLineLayout, type LayoutLock, type LayoutLockSource, type LayoutPhase, LayoutPipeline, type LayoutState, type MatrixBlock, type NodeBase, type NodeCompartments, type NodePort, type NodeShape, type NormalizeDiagramDslOptions, type NormalizeDiagramDslResult, type NormalizedDiagram, type NormalizedEdge, type NormalizedGroup, type NormalizedNode, type ParseDiagramDslOptions, type ParseDiagramDslResult, type ParsedEdgeShorthand, type PhaseTraceEntry, type Point, type PortKind, type PortShiftingOptions, type PortSide, type PreparedText, PretextTextMeasurer, type RelativePositionConstraint, type RelativePositionRelation, type RenderDiagramDslOptions, type RenderDiagramDslResult, type RouteEdgeInput, type RouteEdgeResult, type RouteKind, type ShapeGeometry, type ShapeGeometryInput, type Size, type SolveDiagramOptions, type SolvedTextAnnotation, type Swimlane, type SwimlaneLane, type SwimlaneLayout, type SwimlaneOrientation, type TableBlock, type TableColumn, type TableRow, type TextCursor, type TextLayout, type TextLayoutLine, type TextMeasurementBackend, type TextMeasurer, type TextStyleOptions, type TextSurfaceKind, type VisualStyle, applyLayoutConstraints, assertFiniteNonNegative, assertFinitePositive, boxCenter, canonicalize, computeArrowhead, computeContainerGeometry, computeShapeGeometry, createBoxSpatialIndex, createDefaultPipeline, createDefaultTextMeasurer, expandBox, expandBoxForQuery, exportExcalidraw, exportSvg, fitLabel, getEdgePort, installNodeCanvasRuntime, intersectsAabb, isPretextRuntimeAvailable, normalizeDiagramDsl, normalizeInsets, overlapArea, parseDiagramDsl, parseEdgeShorthand, queryBoxSpatialIndex, querySegmentSpatialIndex, renderDiagramDsl, resolveLineHeight, resolveOutputFormat, routeEdge, runComponentAwareDagreInitialLayout, runDagreInitialLayout, simplifyRoute, solveDiagram, solveDiagramSafe, sortDslDiagnostics, stringifyCanonical, toCanvasFont, unionBoxes, validateBox, validateTextStyle };