@crazyhappyone/auto-graph 0.0.21 → 0.1.1

package/dist/index.d.cts

@@ -80,6 +80,14 @@ interface Diagnostic {
     path?: DiagnosticPathSegment[];
     detail?: JsonObject;
 }
+/**
+ * Diagnostic codes that indicate the solver produced a degraded
+ * (non-deliverable) layout.  Downstream consumers can gate on the
+ * {@link CoordinatedDiagram.degraded} flag or use the
+ * {@link SolveDiagramOptions.strict} option to promote these to
+ * errors.
+ */
+declare const DELIVERABILITY_DIAGNOSTIC_CODES: ReadonlySet<string>;
 
 interface TextStyleOptions {
     fontFamily: string;
@@ -180,6 +188,23 @@ interface LabelLayout {
     };
     diagnostics: Diagnostic[];
 }
+type TextSurfaceKind = "node-label" | "group-label" | "port-label" | "edge-label" | "compartment-row" | "swimlane-label" | "frame-title";
+interface SolvedTextAnnotation {
+    text: string;
+    ownerId: string;
+    surfaceKind: TextSurfaceKind;
+    surfaceIndex?: number;
+    box: Box;
+    anchor: Box | {
+        x: number;
+        y: number;
+    };
+    paddings: Insets;
+    lines: LabelLayout["lines"];
+    fontFamily: string;
+    fontSize: number;
+    textBackend?: LabelLayout["textBackend"];
+}
 
 type NodeShape = "rectangle" | "rounded-rectangle" | "ellipse" | "diamond" | "parallelogram" | "hexagon" | "cylinder";
 interface Label {
@@ -231,6 +256,72 @@ type PortKind = "proxy" | "flow";
 interface VisualStyle {
     fill?: string;
     stroke?: string;
+    fontFamily?: string;
+    fontSize?: number;
+}
+interface EvidenceCell {
+    text: string;
+    style?: VisualStyle;
+}
+interface EvidenceTextLayout {
+    lines: string[];
+}
+interface MatrixBlock {
+    id: string;
+    rows: string[];
+    cols: string[];
+    cells: EvidenceCell[][];
+    position?: Point;
+    size?: Size;
+    style?: VisualStyle;
+}
+interface CoordinatedMatrixBlock extends MatrixBlock {
+    box: Box;
+    columnLabelLayouts?: EvidenceTextLayout[];
+    rowLabelLayouts?: EvidenceTextLayout[];
+    cellLabelLayouts?: EvidenceTextLayout[][];
+}
+interface TableColumn {
+    id: string;
+    label: Label;
+}
+interface TableRow {
+    id: string;
+    cells: Record<string, EvidenceCell>;
+}
+interface TableBlock {
+    id: string;
+    columns: TableColumn[];
+    rows: TableRow[];
+    position?: Point;
+    size?: Size;
+    style?: VisualStyle;
+}
+interface CoordinatedTableBlock extends TableBlock {
+    box: Box;
+    columnXOffsets: number[];
+    columnLabelLayouts?: EvidenceTextLayout[];
+    cellLabelLayouts?: EvidenceTextLayout[][];
+}
+type EvidencePanelKind = "legend" | "rule" | "note" | "verification";
+interface EvidencePanelItem {
+    id?: string;
+    label: Label;
+    detail?: Label;
+    style?: VisualStyle;
+}
+interface EvidencePanel {
+    id: string;
+    kind: EvidencePanelKind;
+    items: EvidencePanelItem[];
+    position?: Point;
+    size?: Size;
+    style?: VisualStyle;
+}
+interface CoordinatedEvidencePanel extends EvidencePanel {
+    box: Box;
+    titleLayout?: EvidenceTextLayout;
+    itemLayouts?: EvidenceTextLayout[];
 }
 interface NodePort {
     id: string;
@@ -278,6 +369,9 @@ interface IntentGroup {
     nodeIds?: string[];
     groupIds?: string[];
     padding?: Insets;
+    headerHeight?: number;
+    labelPosition?: "top" | "inside" | "outside";
+    direction?: "horizontal" | "vertical";
     metadata?: JsonObject;
 }
 interface NormalizedGroup {
@@ -286,6 +380,9 @@ interface NormalizedGroup {
     nodeIds: string[];
     groupIds: string[];
     padding: Insets;
+    headerHeight?: number;
+    labelPosition?: "top" | "inside" | "outside";
+    direction?: "horizontal" | "vertical";
     metadata?: JsonObject;
     labelLayout?: LabelLayout;
 }
@@ -293,24 +390,34 @@ interface CoordinatedGroup extends NormalizedGroup {
     box: Box;
 }
 type SwimlaneOrientation = "vertical" | "horizontal";
+type SwimlaneLayout = "overlay" | "contract";
 interface SwimlaneLane {
     id: string;
     label?: Label;
     children: string[];
     box?: Box;
+    headerBox?: Box;
+    contentBox?: Box;
 }
 interface Swimlane {
     id: string;
     label?: Label;
     orientation: SwimlaneOrientation;
+    layout?: SwimlaneLayout;
     lanes: SwimlaneLane[];
     box?: Box;
+    headerHeight?: number;
+    padding?: number;
 }
 interface DiagramFrame {
     kind: string;
     context?: string;
     name?: string;
     titleTab: string;
+    headerHeight?: number;
+    padding?: number | Insets;
+    labelPosition?: "top" | "inside" | "outside";
+    direction?: "horizontal" | "vertical";
     style?: VisualStyle;
 }
 interface CoordinatedFrame extends DiagramFrame {
@@ -326,6 +433,8 @@ interface LayoutLock {
 interface ConstraintSolverInput {
     direction: DiagramDirection;
     overlapSpacing?: number;
+    minSiblingGap?: number;
+    distributeContainedChildren?: boolean;
     boxes: ReadonlyMap<string, Box>;
     nodes: readonly NormalizedNode[];
     groups: readonly NormalizedGroup[];
@@ -349,6 +458,9 @@ interface IntentDiagram {
     edges?: IntentEdge[];
     groups?: IntentGroup[];
     swimlanes?: Swimlane[];
+    matrices?: MatrixBlock[];
+    tables?: TableBlock[];
+    evidencePanels?: EvidencePanel[];
     constraints?: Constraint[];
     frame?: DiagramFrame;
     metadata?: DiagramMetadata;
@@ -361,6 +473,9 @@ interface NormalizedDiagram {
     edges: NormalizedEdge[];
     groups: NormalizedGroup[];
     swimlanes?: Swimlane[];
+    matrices?: MatrixBlock[];
+    tables?: TableBlock[];
+    evidencePanels?: EvidencePanel[];
     constraints: Constraint[];
     diagnostics: Diagnostic[];
     frame?: DiagramFrame;
@@ -374,7 +489,13 @@ interface CoordinatedDiagram {
     edges: CoordinatedEdge[];
     groups: CoordinatedGroup[];
     swimlanes?: Swimlane[];
+    matrices?: CoordinatedMatrixBlock[];
+    tables?: CoordinatedTableBlock[];
+    evidencePanels?: CoordinatedEvidencePanel[];
+    textAnnotations?: SolvedTextAnnotation[];
     diagnostics: Diagnostic[];
+    /** True when any deliverability-breaking diagnostic was emitted. */
+    degraded: boolean;
     bounds: Box;
     frame?: CoordinatedFrame;
     metadata?: DiagramMetadata;
@@ -566,6 +687,7 @@ interface RouteEdgeInput {
     sourceAnchor?: AnchorName;
     targetAnchor?: AnchorName;
     obstacles?: readonly Box[];
+    hardObstacles?: readonly Box[];
 }
 interface RouteEdgeResult {
     points: Point[];
@@ -589,12 +711,37 @@ interface SolveDiagramOptions {
     routeKind?: RouteKind;
     obstacleMargin?: number | Insets;
     overlapSpacing?: number;
+    minLaneGutter?: number;
+    prefitLabelSize?: boolean;
+    minSiblingGap?: number;
+    distributeContainedChildren?: boolean;
+    pageBounds?: {
+        width: number;
+        height: number;
+    };
+    maxStackDepth?: number;
+    preferredAspectRatio?: number;
     portShifting?: PortShiftingOptions;
+    cjkFontFamily?: string | false;
+    minCjkFontSize?: number | false;
+    textMeasurer?: TextMeasurer;
+    /** When true, promote deliverability-breaking diagnostics to errors. */
+    strict?: boolean;
 }
 interface PortShiftingOptions {
     enabled?: boolean;
     spacing?: number;
 }
 declare function solveDiagram(diagram: NormalizedDiagram, options?: SolveDiagramOptions): CoordinatedDiagram;
-
-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 CoordinatedFrame, type CoordinatedGroup, type CoordinatedNode, type CoordinatedPort, DEFAULT_CANONICAL_PRECISION, DEFAULT_DSL_MAX_BYTES, 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 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 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 Swimlane, type SwimlaneLane, type SwimlaneOrientation, type TextCursor, type TextLayout, type TextLayoutLine, type TextMeasurementBackend, type TextMeasurer, type TextStyleOptions, 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, sortDslDiagnostics, stringifyCanonical, toCanvasFont, unionBoxes, validateBox, validateTextStyle };
+/**
+ * Convenience wrapper around {@link solveDiagram} that enables
+ * {@link SolveDiagramOptions.prefitLabelSize} by default so node sizes are
+ * expanded to fit their label text.  Direct callers of `solveDiagram` who
+ * pass hard-coded `NormalizedNode.size` values without a `labelLayout`
+ * often see truncated labels; this wrapper avoids that trap.
+ *
+ * @see SolveDiagramOptions.prefitLabelSize
+ */
+declare function solveDiagramSafe(diagram: NormalizedDiagram, options?: SolveDiagramOptions): CoordinatedDiagram;
+
+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 };

package/dist/index.d.ts

@@ -80,6 +80,14 @@ interface Diagnostic {
     path?: DiagnosticPathSegment[];
     detail?: JsonObject;
 }
+/**
+ * Diagnostic codes that indicate the solver produced a degraded
+ * (non-deliverable) layout.  Downstream consumers can gate on the
+ * {@link CoordinatedDiagram.degraded} flag or use the
+ * {@link SolveDiagramOptions.strict} option to promote these to
+ * errors.
+ */
+declare const DELIVERABILITY_DIAGNOSTIC_CODES: ReadonlySet<string>;
 
 interface TextStyleOptions {
     fontFamily: string;
@@ -180,6 +188,23 @@ interface LabelLayout {
     };
     diagnostics: Diagnostic[];
 }
+type TextSurfaceKind = "node-label" | "group-label" | "port-label" | "edge-label" | "compartment-row" | "swimlane-label" | "frame-title";
+interface SolvedTextAnnotation {
+    text: string;
+    ownerId: string;
+    surfaceKind: TextSurfaceKind;
+    surfaceIndex?: number;
+    box: Box;
+    anchor: Box | {
+        x: number;
+        y: number;
+    };
+    paddings: Insets;
+    lines: LabelLayout["lines"];
+    fontFamily: string;
+    fontSize: number;
+    textBackend?: LabelLayout["textBackend"];
+}
 
 type NodeShape = "rectangle" | "rounded-rectangle" | "ellipse" | "diamond" | "parallelogram" | "hexagon" | "cylinder";
 interface Label {
@@ -231,6 +256,72 @@ type PortKind = "proxy" | "flow";
 interface VisualStyle {
     fill?: string;
     stroke?: string;
+    fontFamily?: string;
+    fontSize?: number;
+}
+interface EvidenceCell {
+    text: string;
+    style?: VisualStyle;
+}
+interface EvidenceTextLayout {
+    lines: string[];
+}
+interface MatrixBlock {
+    id: string;
+    rows: string[];
+    cols: string[];
+    cells: EvidenceCell[][];
+    position?: Point;
+    size?: Size;
+    style?: VisualStyle;
+}
+interface CoordinatedMatrixBlock extends MatrixBlock {
+    box: Box;
+    columnLabelLayouts?: EvidenceTextLayout[];
+    rowLabelLayouts?: EvidenceTextLayout[];
+    cellLabelLayouts?: EvidenceTextLayout[][];
+}
+interface TableColumn {
+    id: string;
+    label: Label;
+}
+interface TableRow {
+    id: string;
+    cells: Record<string, EvidenceCell>;
+}
+interface TableBlock {
+    id: string;
+    columns: TableColumn[];
+    rows: TableRow[];
+    position?: Point;
+    size?: Size;
+    style?: VisualStyle;
+}
+interface CoordinatedTableBlock extends TableBlock {
+    box: Box;
+    columnXOffsets: number[];
+    columnLabelLayouts?: EvidenceTextLayout[];
+    cellLabelLayouts?: EvidenceTextLayout[][];
+}
+type EvidencePanelKind = "legend" | "rule" | "note" | "verification";
+interface EvidencePanelItem {
+    id?: string;
+    label: Label;
+    detail?: Label;
+    style?: VisualStyle;
+}
+interface EvidencePanel {
+    id: string;
+    kind: EvidencePanelKind;
+    items: EvidencePanelItem[];
+    position?: Point;
+    size?: Size;
+    style?: VisualStyle;
+}
+interface CoordinatedEvidencePanel extends EvidencePanel {
+    box: Box;
+    titleLayout?: EvidenceTextLayout;
+    itemLayouts?: EvidenceTextLayout[];
 }
 interface NodePort {
     id: string;
@@ -278,6 +369,9 @@ interface IntentGroup {
     nodeIds?: string[];
     groupIds?: string[];
     padding?: Insets;
+    headerHeight?: number;
+    labelPosition?: "top" | "inside" | "outside";
+    direction?: "horizontal" | "vertical";
     metadata?: JsonObject;
 }
 interface NormalizedGroup {
@@ -286,6 +380,9 @@ interface NormalizedGroup {
     nodeIds: string[];
     groupIds: string[];
     padding: Insets;
+    headerHeight?: number;
+    labelPosition?: "top" | "inside" | "outside";
+    direction?: "horizontal" | "vertical";
     metadata?: JsonObject;
     labelLayout?: LabelLayout;
 }
@@ -293,24 +390,34 @@ interface CoordinatedGroup extends NormalizedGroup {
     box: Box;
 }
 type SwimlaneOrientation = "vertical" | "horizontal";
+type SwimlaneLayout = "overlay" | "contract";
 interface SwimlaneLane {
     id: string;
     label?: Label;
     children: string[];
     box?: Box;
+    headerBox?: Box;
+    contentBox?: Box;
 }
 interface Swimlane {
     id: string;
     label?: Label;
     orientation: SwimlaneOrientation;
+    layout?: SwimlaneLayout;
     lanes: SwimlaneLane[];
     box?: Box;
+    headerHeight?: number;
+    padding?: number;
 }
 interface DiagramFrame {
     kind: string;
     context?: string;
     name?: string;
     titleTab: string;
+    headerHeight?: number;
+    padding?: number | Insets;
+    labelPosition?: "top" | "inside" | "outside";
+    direction?: "horizontal" | "vertical";
     style?: VisualStyle;
 }
 interface CoordinatedFrame extends DiagramFrame {
@@ -326,6 +433,8 @@ interface LayoutLock {
 interface ConstraintSolverInput {
     direction: DiagramDirection;
     overlapSpacing?: number;
+    minSiblingGap?: number;
+    distributeContainedChildren?: boolean;
     boxes: ReadonlyMap<string, Box>;
     nodes: readonly NormalizedNode[];
     groups: readonly NormalizedGroup[];
@@ -349,6 +458,9 @@ interface IntentDiagram {
     edges?: IntentEdge[];
     groups?: IntentGroup[];
     swimlanes?: Swimlane[];
+    matrices?: MatrixBlock[];
+    tables?: TableBlock[];
+    evidencePanels?: EvidencePanel[];
     constraints?: Constraint[];
     frame?: DiagramFrame;
     metadata?: DiagramMetadata;
@@ -361,6 +473,9 @@ interface NormalizedDiagram {
     edges: NormalizedEdge[];
     groups: NormalizedGroup[];
     swimlanes?: Swimlane[];
+    matrices?: MatrixBlock[];
+    tables?: TableBlock[];
+    evidencePanels?: EvidencePanel[];
     constraints: Constraint[];
     diagnostics: Diagnostic[];
     frame?: DiagramFrame;
@@ -374,7 +489,13 @@ interface CoordinatedDiagram {
     edges: CoordinatedEdge[];
     groups: CoordinatedGroup[];
     swimlanes?: Swimlane[];
+    matrices?: CoordinatedMatrixBlock[];
+    tables?: CoordinatedTableBlock[];
+    evidencePanels?: CoordinatedEvidencePanel[];
+    textAnnotations?: SolvedTextAnnotation[];
     diagnostics: Diagnostic[];
+    /** True when any deliverability-breaking diagnostic was emitted. */
+    degraded: boolean;
     bounds: Box;
     frame?: CoordinatedFrame;
     metadata?: DiagramMetadata;
@@ -566,6 +687,7 @@ interface RouteEdgeInput {
     sourceAnchor?: AnchorName;
     targetAnchor?: AnchorName;
     obstacles?: readonly Box[];
+    hardObstacles?: readonly Box[];
 }
 interface RouteEdgeResult {
     points: Point[];
@@ -589,12 +711,37 @@ interface SolveDiagramOptions {
     routeKind?: RouteKind;
     obstacleMargin?: number | Insets;
     overlapSpacing?: number;
+    minLaneGutter?: number;
+    prefitLabelSize?: boolean;
+    minSiblingGap?: number;
+    distributeContainedChildren?: boolean;
+    pageBounds?: {
+        width: number;
+        height: number;
+    };
+    maxStackDepth?: number;
+    preferredAspectRatio?: number;
     portShifting?: PortShiftingOptions;
+    cjkFontFamily?: string | false;
+    minCjkFontSize?: number | false;
+    textMeasurer?: TextMeasurer;
+    /** When true, promote deliverability-breaking diagnostics to errors. */
+    strict?: boolean;
 }
 interface PortShiftingOptions {
     enabled?: boolean;
     spacing?: number;
 }
 declare function solveDiagram(diagram: NormalizedDiagram, options?: SolveDiagramOptions): CoordinatedDiagram;
-
-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 CoordinatedFrame, type CoordinatedGroup, type CoordinatedNode, type CoordinatedPort, DEFAULT_CANONICAL_PRECISION, DEFAULT_DSL_MAX_BYTES, 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 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 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 Swimlane, type SwimlaneLane, type SwimlaneOrientation, type TextCursor, type TextLayout, type TextLayoutLine, type TextMeasurementBackend, type TextMeasurer, type TextStyleOptions, 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, sortDslDiagnostics, stringifyCanonical, toCanvasFont, unionBoxes, validateBox, validateTextStyle };
+/**
+ * Convenience wrapper around {@link solveDiagram} that enables
+ * {@link SolveDiagramOptions.prefitLabelSize} by default so node sizes are
+ * expanded to fit their label text.  Direct callers of `solveDiagram` who
+ * pass hard-coded `NormalizedNode.size` values without a `labelLayout`
+ * often see truncated labels; this wrapper avoids that trap.
+ *
+ * @see SolveDiagramOptions.prefitLabelSize
+ */
+declare function solveDiagramSafe(diagram: NormalizedDiagram, options?: SolveDiagramOptions): CoordinatedDiagram;
+
+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 };