vizmatic 0.2.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -207,6 +207,8 @@ type ColorName = 'primary' | 'secondary' | 'positive' | 'warning' | 'critical' |
207
207
  declare function getColor(name: ColorName, c?: ThemeColors): string;
208
208
  /** Get a semantic color variant that remains readable as text in either theme. */
209
209
  declare function getReadableColor(name: ColorName, c: ThemeColors): string;
210
+ /** Apply an opacity multiplier to any CSS color accepted by parse-css-color. */
211
+ declare function withColorAlpha(color: string, opacity: number): string;
210
212
  /** Choose readable foreground text, compositing translucent backgrounds over their backdrop. */
211
213
  declare function getReadableTextColor(background: string, c: ThemeColors, backdrop?: string): string;
212
214
  /**
@@ -808,6 +810,9 @@ interface FlowProps {
808
810
  }
809
811
  declare function Flow({ stages, c, direction, gap, connectorLength, connectorTone, align, math, }: FlowProps): React.ReactElement;
810
812
 
813
+ type GraphRouting = 'dagre' | 'straight' | 'orthogonal';
814
+ type GraphPortSide = 'top' | 'right' | 'bottom' | 'left';
815
+
811
816
  interface LayeredNetworkLayer {
812
817
  title: string;
813
818
  nodes: string[];
@@ -842,6 +847,13 @@ interface GraphDiagramNode {
842
847
  group?: string;
843
848
  icon?: IconName | DiagramIconDefinition | React.ReactElement;
844
849
  iconSize?: number;
850
+ ports?: GraphDiagramPort[];
851
+ }
852
+ /** A fixed geometric connector anchor on a node boundary. Offset runs left to right or top to bottom. */
853
+ interface GraphDiagramPort {
854
+ id: string;
855
+ side: GraphPortSide;
856
+ offset?: number;
845
857
  }
846
858
  interface DiagramIconRenderProps {
847
859
  c: ThemeColors;
@@ -879,6 +891,10 @@ interface GraphDiagramEdge {
879
891
  arrow?: GraphDiagramEdgeArrow;
880
892
  href?: string;
881
893
  title?: string;
894
+ fromPort?: string;
895
+ toPort?: string;
896
+ fromSide?: GraphPortSide;
897
+ toSide?: GraphPortSide;
882
898
  }
883
899
  interface GraphDiagramProps {
884
900
  nodes: GraphDiagramNode[];
@@ -898,6 +914,10 @@ interface GraphDiagramProps {
898
914
  nodeGap?: number;
899
915
  rankGap?: number;
900
916
  edgeGap?: number;
917
+ /** Dagre retains existing routes. Orthogonal routes avoid node boxes and group headers. */
918
+ routing?: GraphRouting;
919
+ /** Minimum node clearance in logical pixels for orthogonal routing. */
920
+ routingClearance?: number;
901
921
  sizing?: 'content' | 'fixed';
902
922
  iconSize?: number;
903
923
  id?: string;
@@ -905,7 +925,7 @@ interface GraphDiagramProps {
905
925
  title?: string;
906
926
  description?: string;
907
927
  }
908
- declare function GraphDiagram({ nodes, edges, groups, c, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, layout: requestedLayout, direction, nodeGap, rankGap, edgeGap, sizing, iconSize, id, ariaLabel, title, description, }: GraphDiagramProps): React.ReactElement;
928
+ declare function GraphDiagram({ nodes, edges, groups, c, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, layout: requestedLayout, direction, nodeGap, rankGap, edgeGap, routing, routingClearance, sizing, iconSize, id, ariaLabel, title, description, }: GraphDiagramProps): React.ReactElement;
909
929
  interface TreeNodeSpec {
910
930
  label: React.ReactNode;
911
931
  id?: string;
@@ -1117,11 +1137,13 @@ interface DataflowDiagramProps extends DataflowSpec {
1117
1137
  nodeGap?: number;
1118
1138
  rankGap?: number;
1119
1139
  edgeGap?: number;
1140
+ routing?: GraphDiagramProps['routing'];
1141
+ routingClearance?: GraphDiagramProps['routingClearance'];
1120
1142
  sizing?: GraphDiagramProps['sizing'];
1121
1143
  iconSize?: number;
1122
1144
  }
1123
1145
  /** Render typed dataflow nodes and edges through the existing GraphDiagram. */
1124
- declare function DataflowDiagram({ c, nodes, edges, boundaries, ariaLabel, id, title, description, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, direction, nodeGap, rankGap, edgeGap, sizing, iconSize, }: DataflowDiagramProps): React.ReactElement;
1146
+ declare function DataflowDiagram({ c, nodes, edges, boundaries, ariaLabel, id, title, description, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, direction, nodeGap, rankGap, edgeGap, routing, routingClearance, sizing, iconSize, }: DataflowDiagramProps): React.ReactElement;
1125
1147
 
1126
1148
  /** Deployment boundary kinds understood by {@link DeploymentDiagram}. */
1127
1149
  type DeploymentBoundaryKind = 'region' | 'zone' | 'vpc' | 'subnet' | 'namespace' | 'host' | 'cluster' | 'trust';
@@ -1136,6 +1158,8 @@ interface DeploymentPort {
1136
1158
  protocol?: string;
1137
1159
  label?: string;
1138
1160
  direction?: DeploymentPortDirection;
1161
+ side?: GraphPortSide;
1162
+ offset?: number;
1139
1163
  }
1140
1164
  type DeploymentPortInput = DeploymentPort | string | number;
1141
1165
  /** A nested infrastructure or trust boundary. */
@@ -1149,7 +1173,7 @@ interface DeploymentBoundary {
1149
1173
  muted?: boolean;
1150
1174
  }
1151
1175
  /** A typed service, workload, host, or external endpoint. */
1152
- interface DeploymentNode extends Omit<GraphDiagramNode, 'label' | 'detail' | 'group' | 'icon'> {
1176
+ interface DeploymentNode extends Omit<GraphDiagramNode, 'label' | 'detail' | 'group' | 'icon' | 'ports'> {
1153
1177
  id: string;
1154
1178
  label: React.ReactNode;
1155
1179
  detail?: React.ReactNode;
@@ -1160,7 +1184,7 @@ interface DeploymentNode extends Omit<GraphDiagramNode, 'label' | 'detail' | 'gr
1160
1184
  }
1161
1185
  type DeploymentConnectionKind = 'ingress' | 'egress' | 'internal' | 'cross-boundary';
1162
1186
  /** A typed network relationship between two deployment nodes. */
1163
- interface DeploymentConnection extends Omit<GraphDiagramEdge, 'from' | 'to' | 'label' | 'kind' | 'style' | 'arrow'> {
1187
+ interface DeploymentConnection extends Omit<GraphDiagramEdge, 'from' | 'to' | 'label' | 'kind' | 'style' | 'arrow' | 'fromPort' | 'toPort'> {
1164
1188
  id?: string;
1165
1189
  from: string;
1166
1190
  to: string;
@@ -1431,7 +1455,7 @@ interface ChartFrameProps {
1431
1455
  padding?: number;
1432
1456
  }
1433
1457
  declare function createPlotArea(width: number, height: number, margin: ChartMargins): PlotArea;
1434
- declare function ChartFrame({ children, c, title, subtitle, legend, footer, width, height, padding, }: ChartFrameProps): React.ReactElement;
1458
+ declare function ChartFrame(props: ChartFrameProps): React.ReactElement;
1435
1459
  interface DonutChartSegment {
1436
1460
  label: string;
1437
1461
  value: number;
@@ -1453,6 +1477,21 @@ interface DonutChartProps {
1453
1477
  showLegend?: boolean;
1454
1478
  footer?: string;
1455
1479
  }
1480
+ /** Pie chart values must be finite, non-negative counts. Zero-valued slices are omitted. */
1481
+ interface PieChartProps {
1482
+ segments: DonutChartSegment[];
1483
+ c: ThemeColors;
1484
+ title?: string;
1485
+ subtitle?: string;
1486
+ width?: number;
1487
+ height?: number;
1488
+ size?: number;
1489
+ format?: ChartValueFormat;
1490
+ showLegend?: boolean;
1491
+ footer?: string;
1492
+ }
1493
+ /** A categorical part-to-whole chart with a full circular radius. */
1494
+ declare function PieChart({ segments, c, title, subtitle, width, height, size, format, showLegend, footer, }: PieChartProps): React.ReactElement;
1456
1495
  declare function DonutChart({ segments, c, title, subtitle, width, height, size, thickness, format, centerLabel, centerValue, showLegend, footer, }: DonutChartProps): React.ReactElement;
1457
1496
  interface BarChartDatum {
1458
1497
  label: string;
@@ -1492,6 +1531,20 @@ interface BarChartProps {
1492
1531
  footer?: string;
1493
1532
  }
1494
1533
  declare function BarChart({ data, c, title, subtitle, width, height, min, max, format, showGrid, showValues, yAxisLabel, footer, }: BarChartProps): React.ReactElement;
1534
+ interface ParetoBarChartProps {
1535
+ data: BarChartDatum[];
1536
+ c: ThemeColors;
1537
+ title?: string;
1538
+ subtitle?: string;
1539
+ width?: number;
1540
+ height?: number;
1541
+ format?: ChartValueFormat;
1542
+ showGrid?: boolean;
1543
+ showValues?: boolean;
1544
+ footer?: string;
1545
+ }
1546
+ /** A classic Pareto chart: stable descending bars with a cumulative percentage line. */
1547
+ declare function ParetoBarChart({ data, c, title, subtitle, width, height, format, showGrid, showValues, footer, }: ParetoBarChartProps): React.ReactElement;
1495
1548
  interface LineChartSeries {
1496
1549
  name: string;
1497
1550
  points: number[];
@@ -1672,6 +1725,26 @@ interface LegendProps {
1672
1725
  }
1673
1726
  declare function Legend({ items, c, title }: LegendProps): React.ReactElement;
1674
1727
 
1728
+ declare const CANVAS_ITEM_COMPONENT: unique symbol;
1729
+ interface BoardProps {
1730
+ children?: React.ReactNode;
1731
+ c: ThemeColors;
1732
+ width?: number;
1733
+ height?: number;
1734
+ background?: string;
1735
+ }
1736
+ interface CanvasItemProps {
1737
+ children?: React.ReactNode;
1738
+ x: number;
1739
+ y: number;
1740
+ width?: number;
1741
+ height?: number;
1742
+ }
1743
+ /** A fixed canvas for freely positioned, composable visuals. */
1744
+ declare function Board({ children, c, width, height, background }: BoardProps): React.ReactElement;
1745
+ /** Positions an item in Board coordinates and supplies its size to the child. */
1746
+ declare function CanvasItem({ children, x, y, width, height }: CanvasItemProps): React.ReactElement;
1747
+
1675
1748
  /**
1676
1749
  * Vizmatic — Brand
1677
1750
  *
@@ -2048,7 +2121,7 @@ declare function importD2Graph(source: string): GraphImportResult;
2048
2121
 
2049
2122
  type DiagnosticSeverity = 'error' | 'warning' | 'info';
2050
2123
  /** Stable identifiers emitted by the visual checker. Add codes without changing existing meanings. */
2051
- declare const CHECK_DIAGNOSTIC_CODES: readonly ["accessibility.low_contrast", "api.unsupported_prop", "asset.warning", "frame.load_error", "frame.unknown_preset", "layout.auto_size", "layout.connector_congestion", "layout.overflow", "layout.text_overlap", "layout.whitespace_imbalance", "readability.small_text", "render.error", "render.warning", "style.unsupported"];
2124
+ declare const CHECK_DIAGNOSTIC_CODES: readonly ["accessibility.low_contrast", "api.unsupported_prop", "asset.warning", "frame.load_error", "frame.unknown_preset", "layout.auto_size", "layout.connector_congestion", "layout.connector_unroutable", "layout.overflow", "layout.text_overlap", "layout.whitespace_imbalance", "readability.small_text", "render.error", "render.warning", "style.unsupported"];
2052
2125
  type CheckDiagnosticCode = typeof CHECK_DIAGNOSTIC_CODES[number];
2053
2126
  interface CheckDiagnosticLocation {
2054
2127
  /** React element path for diagnostics collected before layout. */
@@ -2143,4 +2216,4 @@ interface CheckFrameReport {
2143
2216
  */
2144
2217
  declare function checkFrame(input: CheckFrameInput, options?: CheckOptions): Promise<CheckFrameReport>;
2145
2218
 
2146
- export { type AnimatedScene, type AnimationCadenceAnalysis, type AnimationDefinition, type AnimationEasing, type AnimationEasingName, type AnimationFrameContext, type AnimationHoldStep, type AnimationInterpolator, type AnimationKeyframeStep, type AnimationOptions, type AnimationOutput, type AnimationOverflowContext, type AnimationParallelStep, type AnimationParallelTracks, type AnimationPropertyStep, type AnimationTimelineStep, type AnimationTweenStep, Arrow, ArrowMarkerDef, AxisPlot, type AxisPlotPath, type AxisPlotPoint, type AxisPlotVector, Badge, BadgePill, BarChart, type BarChartDatum, Box, CHECK_DIAGNOSTIC_CODES, CalloutCard, Canvas, CanvasOverflowError, Card, ChartFrame, type ChartLegendItem, type ChartMargins, type ChartValueFormat, type CheckAutoSize, type CheckAutoSizeAxes, type CheckDiagnostic, type CheckDiagnosticCode, type CheckDiagnosticCounts, type CheckDiagnosticLocation, type CheckFailurePolicy, type CheckFrameInput, type CheckFrameReport, type CheckOptions, type CheckThemeReport, CodeBlock, type CodeLineSpec, type ColorName, Column, Comparison, type ComparisonSideSpec, Connector, type CropMode, type CropRegion, DashedLine, DataTable, type DataflowBoundary, DataflowDiagram, type DataflowDiagramProps, type DataflowEdge, type DataflowEdgeMode, type DataflowNode, type DataflowNodeKind, type DataflowSchema, type DataflowSchemaDefinition, type DataflowSchemaField, type DefinedAnimation, type DeploymentBoundary, type DeploymentBoundaryKind, type DeploymentConnection, type DeploymentConnectionKind, DeploymentDiagram, type DeploymentDiagramProps, type DeploymentNode, type DeploymentNodeKind, type DeploymentPort, type DeploymentPortDirection, type DeploymentPortInput, DetailList, type DiagnosticSeverity, type DiagramIconDefinition, type DiagramIconRenderProps, DonutChart, type DonutChartSegment, DotPoint, EquationCard, Flow, FlowArrow, type FlowStageSpec, GradientChip, GraphDiagram, type GraphDiagramEdge, type GraphDiagramEdgeArrow, type GraphDiagramEdgeKind, type GraphDiagramEdgeStyle, type GraphDiagramGroup, type GraphDiagramNode, type GraphDiagramProps, type GraphImportDiagnostic, type GraphImportDiagnosticCode, type GraphImportDirection, type GraphImportGraph, type GraphImportResult, type GraphImportSource, Grid, type GridCell, Heatmap, Icon, type IconName, type IconProps, type IllustrationBuilder, type IntervalDatum, IntervalPlot, KeyValueList, type KeyValueRow, LayeredNetwork, type LayeredNetworkLayer, Legend, type LegendItem, LineChart, type LineChartSeries, MathText, Matrix, MetricCard, MiniBarChart, type MiniBarDatum, type OverflowResult, Panel, ParetoChart, type ParetoChartProps, type ParetoObjective, type ParetoXScale, Pipeline, type PipelineStage, type PlotArea, ProgressList, ProgressRow, type ProgressRowSpec, QuadrantChart, type QuadrantChartProps, type QuadrantRegion, type RenderBackground, type RenderOptions, type RenderOutput, Row, type SampleAnimationOptions, type SampledAnimationFrame, ScatterPlot, type ScatterPoint, Scene, type SequenceActivation, SequenceDiagram, type SequenceDiagramProps, type SequenceFragment, type SequenceFragmentBranch, type SequenceFragmentKind, type SequenceItem, type SequenceMessage, type SequenceMessageKind, type SequenceNote, type SequenceParticipant, type SequenceParticipantKind, Stack, StackedBar, type StackedBarSegment, type StatusKind, StatusList, StatusRow, type StatusRowSpec, StepCard, SvgFrame, SvgMathText, SvgPoint, type TensorDimension, type TensorShape, type TensorShapeObject, TextLabel, type ThemeColors, type ThemeMode, type ThemePreset, Tile, TileGrid, type TileSpec, TiledMatrix, type TiledMatrixRegion, Timeline, type TimelineEventSpec, TitleBar, type ToneName, ToneStrip, type TransformerBlock, type TransformerBlockKind, type TransformerRoute, type TransformerRouteKind, TransformerTopology, type TransformerTopologyProps, type TransitionType, TreeDiagram, type TreeNodeSpec, ValuePill, VectorArrow, VectorSegment, Watermark, type WatermarkElementProps, type WatermarkImageOptions, type WatermarkInput, type WatermarkOptions, type WatermarkPosition, WindowFrame, analyzeAnimationCadence, canvas, checkFrame, colors, createPlotArea, cropPixels, defineAnimation, defineDiagramIcon, defineIconRegistry, defineIllustration, detectBackgroundColor, detectContentBounds, detectOverflow, formatMathText, formatTensorShape, getColor, getFonts, getGradient, getReadableColor, getReadableTextColor, getReadableToneColor, getStyles, getThemeColors, getToneColor, getToneFill, getToneGradient, gradients, heatColor, hold, importD2Graph, importMermaidGraph, keyframe, loadAdditionalAsset, normalizeWatermark, parallel, renderAnimatedGif, renderAnimatedGifWithOutput, renderAnimationGif, renderAnimationGifWithOutput, renderToBuffer, renderToPng, renderToPngWithOutput, renderToSvg, sampleAnimation, sampleAnimationFrames, styles, toneGradients, tween, typography, wrapWithBrand, wrapWithWatermark };
2219
+ export { type AnimatedScene, type AnimationCadenceAnalysis, type AnimationDefinition, type AnimationEasing, type AnimationEasingName, type AnimationFrameContext, type AnimationHoldStep, type AnimationInterpolator, type AnimationKeyframeStep, type AnimationOptions, type AnimationOutput, type AnimationOverflowContext, type AnimationParallelStep, type AnimationParallelTracks, type AnimationPropertyStep, type AnimationTimelineStep, type AnimationTweenStep, Arrow, ArrowMarkerDef, AxisPlot, type AxisPlotPath, type AxisPlotPoint, type AxisPlotVector, Badge, BadgePill, BarChart, type BarChartDatum, Board, type BoardProps, Box, CANVAS_ITEM_COMPONENT, CHECK_DIAGNOSTIC_CODES, CalloutCard, Canvas, CanvasItem, type CanvasItemProps, CanvasOverflowError, Card, ChartFrame, type ChartLegendItem, type ChartMargins, type ChartValueFormat, type CheckAutoSize, type CheckAutoSizeAxes, type CheckDiagnostic, type CheckDiagnosticCode, type CheckDiagnosticCounts, type CheckDiagnosticLocation, type CheckFailurePolicy, type CheckFrameInput, type CheckFrameReport, type CheckOptions, type CheckThemeReport, CodeBlock, type CodeLineSpec, type ColorName, Column, Comparison, type ComparisonSideSpec, Connector, type CropMode, type CropRegion, DashedLine, DataTable, type DataflowBoundary, DataflowDiagram, type DataflowDiagramProps, type DataflowEdge, type DataflowEdgeMode, type DataflowNode, type DataflowNodeKind, type DataflowSchema, type DataflowSchemaDefinition, type DataflowSchemaField, type DefinedAnimation, type DeploymentBoundary, type DeploymentBoundaryKind, type DeploymentConnection, type DeploymentConnectionKind, DeploymentDiagram, type DeploymentDiagramProps, type DeploymentNode, type DeploymentNodeKind, type DeploymentPort, type DeploymentPortDirection, type DeploymentPortInput, DetailList, type DiagnosticSeverity, type DiagramIconDefinition, type DiagramIconRenderProps, DonutChart, type DonutChartSegment, DotPoint, EquationCard, Flow, FlowArrow, type FlowStageSpec, GradientChip, GraphDiagram, type GraphDiagramEdge, type GraphDiagramEdgeArrow, type GraphDiagramEdgeKind, type GraphDiagramEdgeStyle, type GraphDiagramGroup, type GraphDiagramNode, type GraphDiagramPort, type GraphDiagramProps, type GraphImportDiagnostic, type GraphImportDiagnosticCode, type GraphImportDirection, type GraphImportGraph, type GraphImportResult, type GraphImportSource, type GraphPortSide, type GraphRouting, Grid, type GridCell, Heatmap, Icon, type IconName, type IconProps, type IllustrationBuilder, type IntervalDatum, IntervalPlot, KeyValueList, type KeyValueRow, LayeredNetwork, type LayeredNetworkLayer, Legend, type LegendItem, LineChart, type LineChartSeries, MathText, Matrix, MetricCard, MiniBarChart, type MiniBarDatum, type OverflowResult, Panel, ParetoBarChart, type ParetoBarChartProps, ParetoChart, type ParetoChartProps, type ParetoObjective, type ParetoXScale, PieChart, type PieChartProps, Pipeline, type PipelineStage, type PlotArea, ProgressList, ProgressRow, type ProgressRowSpec, QuadrantChart, type QuadrantChartProps, type QuadrantRegion, type RenderBackground, type RenderOptions, type RenderOutput, Row, type SampleAnimationOptions, type SampledAnimationFrame, ScatterPlot, type ScatterPoint, Scene, type SequenceActivation, SequenceDiagram, type SequenceDiagramProps, type SequenceFragment, type SequenceFragmentBranch, type SequenceFragmentKind, type SequenceItem, type SequenceMessage, type SequenceMessageKind, type SequenceNote, type SequenceParticipant, type SequenceParticipantKind, Stack, StackedBar, type StackedBarSegment, type StatusKind, StatusList, StatusRow, type StatusRowSpec, StepCard, SvgFrame, SvgMathText, SvgPoint, type TensorDimension, type TensorShape, type TensorShapeObject, TextLabel, type ThemeColors, type ThemeMode, type ThemePreset, Tile, TileGrid, type TileSpec, TiledMatrix, type TiledMatrixRegion, Timeline, type TimelineEventSpec, TitleBar, type ToneName, ToneStrip, type TransformerBlock, type TransformerBlockKind, type TransformerRoute, type TransformerRouteKind, TransformerTopology, type TransformerTopologyProps, type TransitionType, TreeDiagram, type TreeNodeSpec, ValuePill, VectorArrow, VectorSegment, Watermark, type WatermarkElementProps, type WatermarkImageOptions, type WatermarkInput, type WatermarkOptions, type WatermarkPosition, WindowFrame, analyzeAnimationCadence, canvas, checkFrame, colors, createPlotArea, cropPixels, defineAnimation, defineDiagramIcon, defineIconRegistry, defineIllustration, detectBackgroundColor, detectContentBounds, detectOverflow, formatMathText, formatTensorShape, getColor, getFonts, getGradient, getReadableColor, getReadableTextColor, getReadableToneColor, getStyles, getThemeColors, getToneColor, getToneFill, getToneGradient, gradients, heatColor, hold, importD2Graph, importMermaidGraph, keyframe, loadAdditionalAsset, normalizeWatermark, parallel, renderAnimatedGif, renderAnimatedGifWithOutput, renderAnimationGif, renderAnimationGifWithOutput, renderToBuffer, renderToPng, renderToPngWithOutput, renderToSvg, sampleAnimation, sampleAnimationFrames, styles, toneGradients, tween, typography, withColorAlpha, wrapWithBrand, wrapWithWatermark };
package/dist/index.d.ts CHANGED
@@ -207,6 +207,8 @@ type ColorName = 'primary' | 'secondary' | 'positive' | 'warning' | 'critical' |
207
207
  declare function getColor(name: ColorName, c?: ThemeColors): string;
208
208
  /** Get a semantic color variant that remains readable as text in either theme. */
209
209
  declare function getReadableColor(name: ColorName, c: ThemeColors): string;
210
+ /** Apply an opacity multiplier to any CSS color accepted by parse-css-color. */
211
+ declare function withColorAlpha(color: string, opacity: number): string;
210
212
  /** Choose readable foreground text, compositing translucent backgrounds over their backdrop. */
211
213
  declare function getReadableTextColor(background: string, c: ThemeColors, backdrop?: string): string;
212
214
  /**
@@ -808,6 +810,9 @@ interface FlowProps {
808
810
  }
809
811
  declare function Flow({ stages, c, direction, gap, connectorLength, connectorTone, align, math, }: FlowProps): React.ReactElement;
810
812
 
813
+ type GraphRouting = 'dagre' | 'straight' | 'orthogonal';
814
+ type GraphPortSide = 'top' | 'right' | 'bottom' | 'left';
815
+
811
816
  interface LayeredNetworkLayer {
812
817
  title: string;
813
818
  nodes: string[];
@@ -842,6 +847,13 @@ interface GraphDiagramNode {
842
847
  group?: string;
843
848
  icon?: IconName | DiagramIconDefinition | React.ReactElement;
844
849
  iconSize?: number;
850
+ ports?: GraphDiagramPort[];
851
+ }
852
+ /** A fixed geometric connector anchor on a node boundary. Offset runs left to right or top to bottom. */
853
+ interface GraphDiagramPort {
854
+ id: string;
855
+ side: GraphPortSide;
856
+ offset?: number;
845
857
  }
846
858
  interface DiagramIconRenderProps {
847
859
  c: ThemeColors;
@@ -879,6 +891,10 @@ interface GraphDiagramEdge {
879
891
  arrow?: GraphDiagramEdgeArrow;
880
892
  href?: string;
881
893
  title?: string;
894
+ fromPort?: string;
895
+ toPort?: string;
896
+ fromSide?: GraphPortSide;
897
+ toSide?: GraphPortSide;
882
898
  }
883
899
  interface GraphDiagramProps {
884
900
  nodes: GraphDiagramNode[];
@@ -898,6 +914,10 @@ interface GraphDiagramProps {
898
914
  nodeGap?: number;
899
915
  rankGap?: number;
900
916
  edgeGap?: number;
917
+ /** Dagre retains existing routes. Orthogonal routes avoid node boxes and group headers. */
918
+ routing?: GraphRouting;
919
+ /** Minimum node clearance in logical pixels for orthogonal routing. */
920
+ routingClearance?: number;
901
921
  sizing?: 'content' | 'fixed';
902
922
  iconSize?: number;
903
923
  id?: string;
@@ -905,7 +925,7 @@ interface GraphDiagramProps {
905
925
  title?: string;
906
926
  description?: string;
907
927
  }
908
- declare function GraphDiagram({ nodes, edges, groups, c, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, layout: requestedLayout, direction, nodeGap, rankGap, edgeGap, sizing, iconSize, id, ariaLabel, title, description, }: GraphDiagramProps): React.ReactElement;
928
+ declare function GraphDiagram({ nodes, edges, groups, c, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, layout: requestedLayout, direction, nodeGap, rankGap, edgeGap, routing, routingClearance, sizing, iconSize, id, ariaLabel, title, description, }: GraphDiagramProps): React.ReactElement;
909
929
  interface TreeNodeSpec {
910
930
  label: React.ReactNode;
911
931
  id?: string;
@@ -1117,11 +1137,13 @@ interface DataflowDiagramProps extends DataflowSpec {
1117
1137
  nodeGap?: number;
1118
1138
  rankGap?: number;
1119
1139
  edgeGap?: number;
1140
+ routing?: GraphDiagramProps['routing'];
1141
+ routingClearance?: GraphDiagramProps['routingClearance'];
1120
1142
  sizing?: GraphDiagramProps['sizing'];
1121
1143
  iconSize?: number;
1122
1144
  }
1123
1145
  /** Render typed dataflow nodes and edges through the existing GraphDiagram. */
1124
- declare function DataflowDiagram({ c, nodes, edges, boundaries, ariaLabel, id, title, description, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, direction, nodeGap, rankGap, edgeGap, sizing, iconSize, }: DataflowDiagramProps): React.ReactElement;
1146
+ declare function DataflowDiagram({ c, nodes, edges, boundaries, ariaLabel, id, title, description, width, height, nodeWidth, nodeHeight, labelFontSize, detailFontSize, arrowSize, padding, direction, nodeGap, rankGap, edgeGap, routing, routingClearance, sizing, iconSize, }: DataflowDiagramProps): React.ReactElement;
1125
1147
 
1126
1148
  /** Deployment boundary kinds understood by {@link DeploymentDiagram}. */
1127
1149
  type DeploymentBoundaryKind = 'region' | 'zone' | 'vpc' | 'subnet' | 'namespace' | 'host' | 'cluster' | 'trust';
@@ -1136,6 +1158,8 @@ interface DeploymentPort {
1136
1158
  protocol?: string;
1137
1159
  label?: string;
1138
1160
  direction?: DeploymentPortDirection;
1161
+ side?: GraphPortSide;
1162
+ offset?: number;
1139
1163
  }
1140
1164
  type DeploymentPortInput = DeploymentPort | string | number;
1141
1165
  /** A nested infrastructure or trust boundary. */
@@ -1149,7 +1173,7 @@ interface DeploymentBoundary {
1149
1173
  muted?: boolean;
1150
1174
  }
1151
1175
  /** A typed service, workload, host, or external endpoint. */
1152
- interface DeploymentNode extends Omit<GraphDiagramNode, 'label' | 'detail' | 'group' | 'icon'> {
1176
+ interface DeploymentNode extends Omit<GraphDiagramNode, 'label' | 'detail' | 'group' | 'icon' | 'ports'> {
1153
1177
  id: string;
1154
1178
  label: React.ReactNode;
1155
1179
  detail?: React.ReactNode;
@@ -1160,7 +1184,7 @@ interface DeploymentNode extends Omit<GraphDiagramNode, 'label' | 'detail' | 'gr
1160
1184
  }
1161
1185
  type DeploymentConnectionKind = 'ingress' | 'egress' | 'internal' | 'cross-boundary';
1162
1186
  /** A typed network relationship between two deployment nodes. */
1163
- interface DeploymentConnection extends Omit<GraphDiagramEdge, 'from' | 'to' | 'label' | 'kind' | 'style' | 'arrow'> {
1187
+ interface DeploymentConnection extends Omit<GraphDiagramEdge, 'from' | 'to' | 'label' | 'kind' | 'style' | 'arrow' | 'fromPort' | 'toPort'> {
1164
1188
  id?: string;
1165
1189
  from: string;
1166
1190
  to: string;
@@ -1431,7 +1455,7 @@ interface ChartFrameProps {
1431
1455
  padding?: number;
1432
1456
  }
1433
1457
  declare function createPlotArea(width: number, height: number, margin: ChartMargins): PlotArea;
1434
- declare function ChartFrame({ children, c, title, subtitle, legend, footer, width, height, padding, }: ChartFrameProps): React.ReactElement;
1458
+ declare function ChartFrame(props: ChartFrameProps): React.ReactElement;
1435
1459
  interface DonutChartSegment {
1436
1460
  label: string;
1437
1461
  value: number;
@@ -1453,6 +1477,21 @@ interface DonutChartProps {
1453
1477
  showLegend?: boolean;
1454
1478
  footer?: string;
1455
1479
  }
1480
+ /** Pie chart values must be finite, non-negative counts. Zero-valued slices are omitted. */
1481
+ interface PieChartProps {
1482
+ segments: DonutChartSegment[];
1483
+ c: ThemeColors;
1484
+ title?: string;
1485
+ subtitle?: string;
1486
+ width?: number;
1487
+ height?: number;
1488
+ size?: number;
1489
+ format?: ChartValueFormat;
1490
+ showLegend?: boolean;
1491
+ footer?: string;
1492
+ }
1493
+ /** A categorical part-to-whole chart with a full circular radius. */
1494
+ declare function PieChart({ segments, c, title, subtitle, width, height, size, format, showLegend, footer, }: PieChartProps): React.ReactElement;
1456
1495
  declare function DonutChart({ segments, c, title, subtitle, width, height, size, thickness, format, centerLabel, centerValue, showLegend, footer, }: DonutChartProps): React.ReactElement;
1457
1496
  interface BarChartDatum {
1458
1497
  label: string;
@@ -1492,6 +1531,20 @@ interface BarChartProps {
1492
1531
  footer?: string;
1493
1532
  }
1494
1533
  declare function BarChart({ data, c, title, subtitle, width, height, min, max, format, showGrid, showValues, yAxisLabel, footer, }: BarChartProps): React.ReactElement;
1534
+ interface ParetoBarChartProps {
1535
+ data: BarChartDatum[];
1536
+ c: ThemeColors;
1537
+ title?: string;
1538
+ subtitle?: string;
1539
+ width?: number;
1540
+ height?: number;
1541
+ format?: ChartValueFormat;
1542
+ showGrid?: boolean;
1543
+ showValues?: boolean;
1544
+ footer?: string;
1545
+ }
1546
+ /** A classic Pareto chart: stable descending bars with a cumulative percentage line. */
1547
+ declare function ParetoBarChart({ data, c, title, subtitle, width, height, format, showGrid, showValues, footer, }: ParetoBarChartProps): React.ReactElement;
1495
1548
  interface LineChartSeries {
1496
1549
  name: string;
1497
1550
  points: number[];
@@ -1672,6 +1725,26 @@ interface LegendProps {
1672
1725
  }
1673
1726
  declare function Legend({ items, c, title }: LegendProps): React.ReactElement;
1674
1727
 
1728
+ declare const CANVAS_ITEM_COMPONENT: unique symbol;
1729
+ interface BoardProps {
1730
+ children?: React.ReactNode;
1731
+ c: ThemeColors;
1732
+ width?: number;
1733
+ height?: number;
1734
+ background?: string;
1735
+ }
1736
+ interface CanvasItemProps {
1737
+ children?: React.ReactNode;
1738
+ x: number;
1739
+ y: number;
1740
+ width?: number;
1741
+ height?: number;
1742
+ }
1743
+ /** A fixed canvas for freely positioned, composable visuals. */
1744
+ declare function Board({ children, c, width, height, background }: BoardProps): React.ReactElement;
1745
+ /** Positions an item in Board coordinates and supplies its size to the child. */
1746
+ declare function CanvasItem({ children, x, y, width, height }: CanvasItemProps): React.ReactElement;
1747
+
1675
1748
  /**
1676
1749
  * Vizmatic — Brand
1677
1750
  *
@@ -2048,7 +2121,7 @@ declare function importD2Graph(source: string): GraphImportResult;
2048
2121
 
2049
2122
  type DiagnosticSeverity = 'error' | 'warning' | 'info';
2050
2123
  /** Stable identifiers emitted by the visual checker. Add codes without changing existing meanings. */
2051
- declare const CHECK_DIAGNOSTIC_CODES: readonly ["accessibility.low_contrast", "api.unsupported_prop", "asset.warning", "frame.load_error", "frame.unknown_preset", "layout.auto_size", "layout.connector_congestion", "layout.overflow", "layout.text_overlap", "layout.whitespace_imbalance", "readability.small_text", "render.error", "render.warning", "style.unsupported"];
2124
+ declare const CHECK_DIAGNOSTIC_CODES: readonly ["accessibility.low_contrast", "api.unsupported_prop", "asset.warning", "frame.load_error", "frame.unknown_preset", "layout.auto_size", "layout.connector_congestion", "layout.connector_unroutable", "layout.overflow", "layout.text_overlap", "layout.whitespace_imbalance", "readability.small_text", "render.error", "render.warning", "style.unsupported"];
2052
2125
  type CheckDiagnosticCode = typeof CHECK_DIAGNOSTIC_CODES[number];
2053
2126
  interface CheckDiagnosticLocation {
2054
2127
  /** React element path for diagnostics collected before layout. */
@@ -2143,4 +2216,4 @@ interface CheckFrameReport {
2143
2216
  */
2144
2217
  declare function checkFrame(input: CheckFrameInput, options?: CheckOptions): Promise<CheckFrameReport>;
2145
2218
 
2146
- export { type AnimatedScene, type AnimationCadenceAnalysis, type AnimationDefinition, type AnimationEasing, type AnimationEasingName, type AnimationFrameContext, type AnimationHoldStep, type AnimationInterpolator, type AnimationKeyframeStep, type AnimationOptions, type AnimationOutput, type AnimationOverflowContext, type AnimationParallelStep, type AnimationParallelTracks, type AnimationPropertyStep, type AnimationTimelineStep, type AnimationTweenStep, Arrow, ArrowMarkerDef, AxisPlot, type AxisPlotPath, type AxisPlotPoint, type AxisPlotVector, Badge, BadgePill, BarChart, type BarChartDatum, Box, CHECK_DIAGNOSTIC_CODES, CalloutCard, Canvas, CanvasOverflowError, Card, ChartFrame, type ChartLegendItem, type ChartMargins, type ChartValueFormat, type CheckAutoSize, type CheckAutoSizeAxes, type CheckDiagnostic, type CheckDiagnosticCode, type CheckDiagnosticCounts, type CheckDiagnosticLocation, type CheckFailurePolicy, type CheckFrameInput, type CheckFrameReport, type CheckOptions, type CheckThemeReport, CodeBlock, type CodeLineSpec, type ColorName, Column, Comparison, type ComparisonSideSpec, Connector, type CropMode, type CropRegion, DashedLine, DataTable, type DataflowBoundary, DataflowDiagram, type DataflowDiagramProps, type DataflowEdge, type DataflowEdgeMode, type DataflowNode, type DataflowNodeKind, type DataflowSchema, type DataflowSchemaDefinition, type DataflowSchemaField, type DefinedAnimation, type DeploymentBoundary, type DeploymentBoundaryKind, type DeploymentConnection, type DeploymentConnectionKind, DeploymentDiagram, type DeploymentDiagramProps, type DeploymentNode, type DeploymentNodeKind, type DeploymentPort, type DeploymentPortDirection, type DeploymentPortInput, DetailList, type DiagnosticSeverity, type DiagramIconDefinition, type DiagramIconRenderProps, DonutChart, type DonutChartSegment, DotPoint, EquationCard, Flow, FlowArrow, type FlowStageSpec, GradientChip, GraphDiagram, type GraphDiagramEdge, type GraphDiagramEdgeArrow, type GraphDiagramEdgeKind, type GraphDiagramEdgeStyle, type GraphDiagramGroup, type GraphDiagramNode, type GraphDiagramProps, type GraphImportDiagnostic, type GraphImportDiagnosticCode, type GraphImportDirection, type GraphImportGraph, type GraphImportResult, type GraphImportSource, Grid, type GridCell, Heatmap, Icon, type IconName, type IconProps, type IllustrationBuilder, type IntervalDatum, IntervalPlot, KeyValueList, type KeyValueRow, LayeredNetwork, type LayeredNetworkLayer, Legend, type LegendItem, LineChart, type LineChartSeries, MathText, Matrix, MetricCard, MiniBarChart, type MiniBarDatum, type OverflowResult, Panel, ParetoChart, type ParetoChartProps, type ParetoObjective, type ParetoXScale, Pipeline, type PipelineStage, type PlotArea, ProgressList, ProgressRow, type ProgressRowSpec, QuadrantChart, type QuadrantChartProps, type QuadrantRegion, type RenderBackground, type RenderOptions, type RenderOutput, Row, type SampleAnimationOptions, type SampledAnimationFrame, ScatterPlot, type ScatterPoint, Scene, type SequenceActivation, SequenceDiagram, type SequenceDiagramProps, type SequenceFragment, type SequenceFragmentBranch, type SequenceFragmentKind, type SequenceItem, type SequenceMessage, type SequenceMessageKind, type SequenceNote, type SequenceParticipant, type SequenceParticipantKind, Stack, StackedBar, type StackedBarSegment, type StatusKind, StatusList, StatusRow, type StatusRowSpec, StepCard, SvgFrame, SvgMathText, SvgPoint, type TensorDimension, type TensorShape, type TensorShapeObject, TextLabel, type ThemeColors, type ThemeMode, type ThemePreset, Tile, TileGrid, type TileSpec, TiledMatrix, type TiledMatrixRegion, Timeline, type TimelineEventSpec, TitleBar, type ToneName, ToneStrip, type TransformerBlock, type TransformerBlockKind, type TransformerRoute, type TransformerRouteKind, TransformerTopology, type TransformerTopologyProps, type TransitionType, TreeDiagram, type TreeNodeSpec, ValuePill, VectorArrow, VectorSegment, Watermark, type WatermarkElementProps, type WatermarkImageOptions, type WatermarkInput, type WatermarkOptions, type WatermarkPosition, WindowFrame, analyzeAnimationCadence, canvas, checkFrame, colors, createPlotArea, cropPixels, defineAnimation, defineDiagramIcon, defineIconRegistry, defineIllustration, detectBackgroundColor, detectContentBounds, detectOverflow, formatMathText, formatTensorShape, getColor, getFonts, getGradient, getReadableColor, getReadableTextColor, getReadableToneColor, getStyles, getThemeColors, getToneColor, getToneFill, getToneGradient, gradients, heatColor, hold, importD2Graph, importMermaidGraph, keyframe, loadAdditionalAsset, normalizeWatermark, parallel, renderAnimatedGif, renderAnimatedGifWithOutput, renderAnimationGif, renderAnimationGifWithOutput, renderToBuffer, renderToPng, renderToPngWithOutput, renderToSvg, sampleAnimation, sampleAnimationFrames, styles, toneGradients, tween, typography, wrapWithBrand, wrapWithWatermark };
2219
+ export { type AnimatedScene, type AnimationCadenceAnalysis, type AnimationDefinition, type AnimationEasing, type AnimationEasingName, type AnimationFrameContext, type AnimationHoldStep, type AnimationInterpolator, type AnimationKeyframeStep, type AnimationOptions, type AnimationOutput, type AnimationOverflowContext, type AnimationParallelStep, type AnimationParallelTracks, type AnimationPropertyStep, type AnimationTimelineStep, type AnimationTweenStep, Arrow, ArrowMarkerDef, AxisPlot, type AxisPlotPath, type AxisPlotPoint, type AxisPlotVector, Badge, BadgePill, BarChart, type BarChartDatum, Board, type BoardProps, Box, CANVAS_ITEM_COMPONENT, CHECK_DIAGNOSTIC_CODES, CalloutCard, Canvas, CanvasItem, type CanvasItemProps, CanvasOverflowError, Card, ChartFrame, type ChartLegendItem, type ChartMargins, type ChartValueFormat, type CheckAutoSize, type CheckAutoSizeAxes, type CheckDiagnostic, type CheckDiagnosticCode, type CheckDiagnosticCounts, type CheckDiagnosticLocation, type CheckFailurePolicy, type CheckFrameInput, type CheckFrameReport, type CheckOptions, type CheckThemeReport, CodeBlock, type CodeLineSpec, type ColorName, Column, Comparison, type ComparisonSideSpec, Connector, type CropMode, type CropRegion, DashedLine, DataTable, type DataflowBoundary, DataflowDiagram, type DataflowDiagramProps, type DataflowEdge, type DataflowEdgeMode, type DataflowNode, type DataflowNodeKind, type DataflowSchema, type DataflowSchemaDefinition, type DataflowSchemaField, type DefinedAnimation, type DeploymentBoundary, type DeploymentBoundaryKind, type DeploymentConnection, type DeploymentConnectionKind, DeploymentDiagram, type DeploymentDiagramProps, type DeploymentNode, type DeploymentNodeKind, type DeploymentPort, type DeploymentPortDirection, type DeploymentPortInput, DetailList, type DiagnosticSeverity, type DiagramIconDefinition, type DiagramIconRenderProps, DonutChart, type DonutChartSegment, DotPoint, EquationCard, Flow, FlowArrow, type FlowStageSpec, GradientChip, GraphDiagram, type GraphDiagramEdge, type GraphDiagramEdgeArrow, type GraphDiagramEdgeKind, type GraphDiagramEdgeStyle, type GraphDiagramGroup, type GraphDiagramNode, type GraphDiagramPort, type GraphDiagramProps, type GraphImportDiagnostic, type GraphImportDiagnosticCode, type GraphImportDirection, type GraphImportGraph, type GraphImportResult, type GraphImportSource, type GraphPortSide, type GraphRouting, Grid, type GridCell, Heatmap, Icon, type IconName, type IconProps, type IllustrationBuilder, type IntervalDatum, IntervalPlot, KeyValueList, type KeyValueRow, LayeredNetwork, type LayeredNetworkLayer, Legend, type LegendItem, LineChart, type LineChartSeries, MathText, Matrix, MetricCard, MiniBarChart, type MiniBarDatum, type OverflowResult, Panel, ParetoBarChart, type ParetoBarChartProps, ParetoChart, type ParetoChartProps, type ParetoObjective, type ParetoXScale, PieChart, type PieChartProps, Pipeline, type PipelineStage, type PlotArea, ProgressList, ProgressRow, type ProgressRowSpec, QuadrantChart, type QuadrantChartProps, type QuadrantRegion, type RenderBackground, type RenderOptions, type RenderOutput, Row, type SampleAnimationOptions, type SampledAnimationFrame, ScatterPlot, type ScatterPoint, Scene, type SequenceActivation, SequenceDiagram, type SequenceDiagramProps, type SequenceFragment, type SequenceFragmentBranch, type SequenceFragmentKind, type SequenceItem, type SequenceMessage, type SequenceMessageKind, type SequenceNote, type SequenceParticipant, type SequenceParticipantKind, Stack, StackedBar, type StackedBarSegment, type StatusKind, StatusList, StatusRow, type StatusRowSpec, StepCard, SvgFrame, SvgMathText, SvgPoint, type TensorDimension, type TensorShape, type TensorShapeObject, TextLabel, type ThemeColors, type ThemeMode, type ThemePreset, Tile, TileGrid, type TileSpec, TiledMatrix, type TiledMatrixRegion, Timeline, type TimelineEventSpec, TitleBar, type ToneName, ToneStrip, type TransformerBlock, type TransformerBlockKind, type TransformerRoute, type TransformerRouteKind, TransformerTopology, type TransformerTopologyProps, type TransitionType, TreeDiagram, type TreeNodeSpec, ValuePill, VectorArrow, VectorSegment, Watermark, type WatermarkElementProps, type WatermarkImageOptions, type WatermarkInput, type WatermarkOptions, type WatermarkPosition, WindowFrame, analyzeAnimationCadence, canvas, checkFrame, colors, createPlotArea, cropPixels, defineAnimation, defineDiagramIcon, defineIconRegistry, defineIllustration, detectBackgroundColor, detectContentBounds, detectOverflow, formatMathText, formatTensorShape, getColor, getFonts, getGradient, getReadableColor, getReadableTextColor, getReadableToneColor, getStyles, getThemeColors, getToneColor, getToneFill, getToneGradient, gradients, heatColor, hold, importD2Graph, importMermaidGraph, keyframe, loadAdditionalAsset, normalizeWatermark, parallel, renderAnimatedGif, renderAnimatedGifWithOutput, renderAnimationGif, renderAnimationGifWithOutput, renderToBuffer, renderToPng, renderToPngWithOutput, renderToSvg, sampleAnimation, sampleAnimationFrames, styles, toneGradients, tween, typography, withColorAlpha, wrapWithBrand, wrapWithWatermark };