@diagrammo/dgmo 0.89.0 → 0.91.0

package/dist/advanced.d.ts

@@ -1,13 +1,14 @@
 import { D as DgmoError, P as PaletteConfig, T as TagGroup, a as PaletteColors, C as CompactViewState, g as TagEntry } from './tag-groups-fgxWTyyB.js';
 export { h as DecodedDiagramUrl, c as DgmoSeverity, i as EncodeDiagramUrlOptions, j as EncodeDiagramUrlResult, k as autoTagColorCycle, l as decodeDiagramUrl, m as decodeViewState, n as encodeDiagramUrl, o as encodeViewState, f as formatDgmoError, p as makeDgmoError, r as resolveActiveTagGroup, q as resolveTagColor, s as resolveTagValue, t as tagAttrKey } from './tag-groups-fgxWTyyB.js';
-import { M as MapDataSource, P as ParsedMap, b as MapData, d as ResolvedMap, e as MapLayoutLegend, f as GeoExtent } from './d3-B6524aaP.js';
-export { A as AirportData, B as BoundaryTopology, G as Gazetteer, a as GazetteerEntry, g as MapDirectives, h as MapEdge, i as MapPoi, j as MapRegion, k as MapRoute, l as PoiPos, m as ProjectionFamily, R as RegionName, c as RegionNames, n as ResolvedEdge, o as ResolvedPoi, p as ResolvedRegion, q as ResolvedRoute, r as renderForExport } from './d3-B6524aaP.js';
-export { C as ChartTypeId, a as ChartTypeMeta, c as chartTypes, b as getAvailablePalettes, g as getPalette, i as isValidHex, d as registerPalette } from './chart-types-Bf8C5QQW.js';
-export { C as CHART_TYPE_DESCRIPTIONS, M as MapCompletionOptions, a as MapLocationMatch, b as MapPlaceCompletion, c as MapRegionCompletion, R as RenderCategory, T as Theme, g as chartTypeParsers, d as completeMapPlaces, e as completeMapRegions, h as getAllChartTypes, i as getRenderCategory, j as isExtendedChartType, k as knownChartTypeIds, p as palettes, f as parseDgmo, s as searchMapLocations, t as themes, f as validate } from './themes-CzuBdx1T.js';
+import { M as MapDataSource, b as MapData, P as ParsedMap, d as ResolvedMap, e as MapLayoutLegend, f as GeoExtent } from './d3-2S3PrXik.js';
+export { A as AirportData, B as BoundaryTopology, G as Gazetteer, a as GazetteerEntry, g as MapDirectives, h as MapEdge, i as MapPoi, j as MapRegion, k as MapRoute, l as PoiPos, m as ProjectionFamily, R as RegionName, c as RegionNames, n as ResolvedEdge, o as ResolvedPoi, p as ResolvedRegion, q as ResolvedRoute, r as renderForExport } from './d3-2S3PrXik.js';
+export { C as ChartTypeId, a as ChartTypeMeta, c as chartTypes, b as getAvailablePalettes, g as getPalette, i as isValidHex, d as registerPalette } from './chart-types-V2NcgN5O.js';
+import { c as InkPoint } from './themes-Cm2YBcT8.js';
+export { C as CHART_TYPE_DESCRIPTIONS, M as MapCompletionOptions, d as MapLocationMatch, e as MapPlaceCompletion, f as MapRegionCompletion, R as RenderCategory, T as Theme, l as chartTypeParsers, g as completeMapPlaces, h as completeMapRegions, m as getAllChartTypes, n as getRenderCategory, o as isExtendedChartType, q as knownChartTypeIds, p as palettes, k as parseDgmo, s as searchMapLocations, t as themes, k as validate } from './themes-Cm2YBcT8.js';
 import { Selection } from 'd3-selection';
 import * as d3Scale from 'd3-scale';
-import { P as ParsedOrg, F as FillMode, R as RaciMarker, a as ParsedRaci, b as RaciVariant, c as RaciTask } from './chart-meta-Bev5Ebjr.js';
-export { A as ALL_CHART_TYPES, I as ImportSource, O as OrgNode, d as RaciPhase, e as RaciRoleAssignment, f as ReadFileFn, g as ResolveImportsResult, h as contrastText, i as findOrgNodeIdByName, j as getSeriesColors, k as hexToHSL, l as hexToHSLString, m as hslToHex, n as mix, o as normalizePertSourceForShare, p as parseDgmoChartType, q as parseFirstLine, r as parseOrg, s as parseRaci, t as resolveOrgImports, u as shade, v as shapeFill, w as tint } from './chart-meta-Bev5Ebjr.js';
+import { P as ParsedOrg, F as FillMode, R as RaciMarker, a as ParsedRaci, b as RaciVariant, c as RaciTask } from './chart-meta-B_WTMP0y.js';
+export { A as ALL_CHART_TYPES, I as ImportSource, O as OrgNode, d as RaciPhase, e as RaciRoleAssignment, f as ReadFileFn, g as ResolveImportsResult, h as contrastText, i as findOrgNodeIdByName, j as getSeriesColors, k as hexToHSL, l as hexToHSLString, m as hslToHex, n as mix, o as normalizePertSourceForShare, p as parseDgmoChartType, q as parseFirstLine, r as parseOrg, s as parseRaci, t as resolveOrgImports, u as shade, v as shapeFill, w as tint } from './chart-meta-B_WTMP0y.js';
 import { GeoProjection } from 'd3-geo';
 
 /**
@@ -370,9 +371,16 @@ declare function renderQuadrant(container: HTMLDivElement, parsed: ParsedQuadran
  * Rust: 25`);
  * ```
  */
-declare function render(content: string, options?: {
+declare function render(source: string, options?: {
     theme?: 'light' | 'dark' | 'transparent';
+    /** The caller's default palette id — the file's own `palette` line beats it. */
     palette?: string;
+    /**
+     * A palette id that beats the file's own `palette` line: a deliberate
+     * per-embed choice (a fence attribute, a CLI flag). Who wins, highest
+     * first: this, the file's palette, `palette`, Slate (#1035).
+     */
+    paletteOverride?: string;
     c4Level?: 'context' | 'containers' | 'components' | 'deployment';
     c4System?: string;
     c4Container?: string;
@@ -413,6 +421,21 @@ declare function render(content: string, options?: {
      */
     width?: number;
     height?: number;
+    /**
+     * Whiteboard images: turn an image ref — a relative path such as
+     * `board.assets/9f3c.webp`, or an `https://` URL — into an href (a data
+     * URI or a URL). When supplied its answer is final, and `undefined` draws
+     * a plain box labelled "image not uploaded". When omitted, `https://` refs
+     * pass through and everything else is that box. Never an error. Every
+     * other chart type ignores this option.
+     */
+    resolveImage?: (ref: string) => string | undefined;
+    /**
+     * Whiteboard sticky notes: `true` draws them and `false` hides them,
+     * whatever the board's `no-notes` says. Omitted, the directive decides.
+     * Every other chart type ignores this option.
+     */
+    showNotes?: boolean;
 }): Promise<{
     svg: string;
     diagnostics: DgmoError[];
@@ -2235,9 +2258,6 @@ interface BLCollapseResult {
  */
 declare function collapseBoxesAndLines(parsed: ParsedBoxesAndLines, collapsedGroups: Set<string>): BLCollapseResult;
 
-/** Closed shape lexicon — rectangle is the default and never written. */
-declare const SKETCH_SHAPE_KINDS: readonly ["rectangle", "database", "queue", "person", "document", "note"];
-type SketchShapeKind = (typeof SKETCH_SHAPE_KINDS)[number];
 /** Half-slot lattice position (spec §31.3). Box children are box-relative. */
 interface SketchAt {
     readonly c: number;
@@ -2248,10 +2268,9 @@ interface SketchNode {
     readonly id: string;
     readonly label: string;
     readonly alias?: string;
-    readonly shape: SketchShapeKind;
     /** null → flow auto-place at layout */
     readonly at: SketchAt | null;
-    /** tag metadata only (shape/at/alias are lifted out) */
+    /** tag metadata only (at/alias are lifted out) */
     readonly metadata: Record<string, string>;
     /** Free-text markdown description (indented `>` lines under the shape).
      *  Newline-joined; a small markdown subset renders in the card body. */
@@ -2326,7 +2345,6 @@ interface ParsedSketch {
     readonly diagnostics: readonly DgmoError[];
     readonly error: string | null;
 }
-declare function isSketchShapeKind(value: string): value is SketchShapeKind;
 
 declare function parseSketch(content: string, palette?: PaletteColors): ParsedSketch;
 
@@ -2360,7 +2378,6 @@ declare function sameSketch(a: ParsedSketch, b: ParsedSketch): boolean;
 interface SketchLayoutNode {
     readonly id: string;
     readonly label: string;
-    readonly shape: SketchShapeKind;
     readonly metadata: Record<string, string>;
     readonly description?: string;
     readonly boxLabel?: string;
@@ -2500,6 +2517,15 @@ interface SketchEdgeGeometry {
     /** Visible stroke path WITH crossing-hops, when this edge hops another. The
      *  renderer draws this if present; everything else still uses `d`. */
     dRender?: string;
+    /**
+     * Every point on THIS line where a hop is drawn — by this line over another,
+     * or by another over this one. Absent when there are none. A label must not
+     * sit on one (#1217); `sketchLabelSpot` is the shared rule.
+     */
+    hops?: {
+        x: number;
+        y: number;
+    }[];
     /**
      * The same cubic as four points — start, its handle, the end's handle, end.
      *
@@ -2577,6 +2603,20 @@ declare function sketchEdgeGeometry(layout: SketchEdgeBoard, offsets?: ReadonlyM
     dx: number;
     dy: number;
 }>): Array<SketchEdgeGeometry | null>;
+/**
+ * Where a line's label goes: the point on the line nearest its midpoint whose
+ * label box, `halfW` by `halfH` either side, clears every hop on the line.
+ * Returns `mid` when the line has no hops or nothing nearby is clear.
+ *
+ * 🔴 For the app's canvas, which puts a label at `mid` and sizes it itself.
+ * dgmo's own renderer needs no call: its declutter keeps a label off every
+ * other line, and a hop is always where another line crosses. Recomputing the
+ * hops in the app would drift the first time the clearance changed (#1217).
+ */
+declare function sketchLabelSpot(g: Pick<SketchEdgeGeometry, 'mid' | 'hops' | 'p0' | 'h0' | 'h1' | 'p1'>, halfW: number, halfH: number): {
+    x: number;
+    y: number;
+};
 /** Export wrapper — the b&l precedent (thin spread). */
 declare function renderSketchForExport(container: HTMLDivElement, parsed: ParsedSketch, layout: SketchLayout, palette: PaletteColors, isDark: boolean, options?: {
     exportDims?: {
@@ -2607,6 +2647,386 @@ interface SketchCollapseResult {
  */
 declare function collapseSketch(parsed: Pick<ParsedSketch, 'nodes' | 'edges' | 'boxes'>, collapsedLabels?: ReadonlySet<string>): SketchCollapseResult;
 
+/**
+ * Colour NAMES — never values. `ink` is the palette's text colour, so it flips
+ * near-black ↔ near-white with the theme; every other name takes the palette's
+ * own light or dark shade of that hue. `ink` is the default and never written
+ * on a shape, arrow or text line.
+ */
+declare const WHITEBOARD_COLORS: readonly ["ink", "red", "green", "blue", "teal", "purple", "orange", "yellow", "cyan", "gray"];
+type WhiteboardColor = (typeof WHITEBOARD_COLORS)[number];
+/** Boxed shapes — position + size + optional centred label. */
+declare const WHITEBOARD_SHAPE_KINDS: readonly ["rectangle", "ellipse", "database", "queue"];
+type WhiteboardShapeKind = (typeof WHITEBOARD_SHAPE_KINDS)[number];
+/** Every line-leading element keyword, in spec order. */
+declare const WHITEBOARD_ELEMENT_KEYWORDS: readonly ["rectangle", "ellipse", "database", "queue", "note", "arrow", "line", "text", "image", "ink"];
+/**
+ * Stroke styles for arrows and lines. `solid` is the default and never
+ * written; `style:` in source accepts only the other values.
+ */
+declare const WHITEBOARD_STROKE_STYLES: readonly ["solid", "dashed"];
+type WhiteboardStrokeStyle = (typeof WHITEBOARD_STROKE_STYLES)[number];
+/**
+ * How a boxed shape is filled. `tint` (a pale wash of its colour) is the
+ * default and never written; `solid` fills with the colour itself; `outline`
+ * leaves the inside empty, so whatever is behind shows through. The same
+ * three words as the other diagram types' `fill-*` family.
+ */
+declare const WHITEBOARD_FILLS: readonly ["tint", "solid", "outline"];
+type WhiteboardFill = (typeof WHITEBOARD_FILLS)[number];
+/**
+ * Which ends of an arrow carry a head. `end` (at `to:`) is the default and
+ * never written; `both` is written `heads: both`. A head at `from:` alone is
+ * never stored — the canvas swaps the ends and writes an `end` arrow.
+ */
+declare const WHITEBOARD_HEADS: readonly ["end", "both"];
+type WhiteboardHeads = (typeof WHITEBOARD_HEADS)[number];
+interface WhiteboardShape {
+    readonly kind: 'shape';
+    readonly shape: WhiteboardShapeKind;
+    /** Top-left corner, canvas px. */
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    /** Centred label; '' for none. */
+    readonly label: string;
+    readonly color: WhiteboardColor;
+    /** How the inside is filled; `tint` unless `fill:` says otherwise. */
+    readonly fill: WhiteboardFill;
+    readonly lineNumber: number;
+}
+/** A sticky note's size when `size:` is left off, px. */
+declare const WHITEBOARD_NOTE_WIDTH = 160;
+declare const WHITEBOARD_NOTE_HEIGHT = 99;
+/** A sticky note's colour when `color:` is left off. */
+declare const WHITEBOARD_NOTE_COLOR: WhiteboardColor;
+/**
+ * A sticky note: a tinted card with its text top-left, wrapped to the card.
+ * Notes are an overlay layer — `no-notes` (or the `showNotes` render option)
+ * hides every one. An arrow or line end inside a note attaches to it.
+ */
+interface WhiteboardNote {
+    readonly kind: 'note';
+    /** Top-left corner, canvas px. */
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    /** The note's text; '' for an empty note. */
+    readonly text: string;
+    readonly color: WhiteboardColor;
+    readonly lineNumber: number;
+}
+/** An arrow, point to point. Head at `to`. An end inside a shape attaches to it (`./geometry`). */
+interface WhiteboardArrow {
+    readonly kind: 'arrow';
+    readonly x1: number;
+    readonly y1: number;
+    readonly x2: number;
+    readonly y2: number;
+    /** Label at the midpoint; '' for none. */
+    readonly label: string;
+    readonly color: WhiteboardColor;
+    readonly style: WhiteboardStrokeStyle;
+    /** Which ends carry a head; `end` unless `heads: both`. */
+    readonly heads: WhiteboardHeads;
+    /**
+     * How far the middle of the drawn curve sits from the straight chord, px,
+     * to the right of travel from `from:` to `to:` on screen (y down); 0 is
+     * straight. One bend only: the connector is a quadratic curve.
+     */
+    readonly bend: number;
+    readonly lineNumber: number;
+}
+/** A free line: an arrow without a head. */
+interface WhiteboardLine {
+    readonly kind: 'line';
+    readonly x1: number;
+    readonly y1: number;
+    readonly x2: number;
+    readonly y2: number;
+    /** Label at the midpoint; '' for none. */
+    readonly label: string;
+    readonly color: WhiteboardColor;
+    readonly style: WhiteboardStrokeStyle;
+    /**
+     * How far the middle of the drawn curve sits from the straight chord, px,
+     * to the right of travel from `from:` to `to:` on screen (y down); 0 is
+     * straight. One bend only: the connector is a quadratic curve.
+     */
+    readonly bend: number;
+    readonly lineNumber: number;
+}
+/** Free text. `x`/`y` is the top-left of its first line. */
+interface WhiteboardText {
+    readonly kind: 'text';
+    readonly x: number;
+    readonly y: number;
+    readonly text: string;
+    readonly color: WhiteboardColor;
+    readonly lineNumber: number;
+}
+/**
+ * A pasted picture. `ref` is a relative path (`<diagram>.assets/<hash>.webp`)
+ * or an `https://` URL; the renderer asks the host to resolve it and draws a
+ * placeholder box when nobody can.
+ */
+interface WhiteboardImage {
+    readonly kind: 'image';
+    readonly ref: string;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly lineNumber: number;
+}
+/** One freehand stroke. `encoded` is kept verbatim so emit is byte-stable. */
+interface WhiteboardInk {
+    readonly kind: 'ink';
+    readonly color: WhiteboardColor;
+    /** Nominal pen diameter, px (may be fractional). */
+    readonly width: number;
+    readonly encoded: string;
+    readonly points: readonly InkPoint[];
+    readonly lineNumber: number;
+}
+type WhiteboardElement = WhiteboardShape | WhiteboardNote | WhiteboardArrow | WhiteboardLine | WhiteboardText | WhiteboardImage | WhiteboardInk;
+interface WhiteboardOptions {
+    /** §1.9 `no-title` — keep the title in the source, do not draw it. */
+    readonly noTitle: boolean;
+    /** `no-notes` — keep the sticky notes in the source, do not draw them. */
+    readonly noNotes: boolean;
+}
+interface ParsedWhiteboard {
+    readonly type: 'whiteboard';
+    readonly title: string | null;
+    readonly titleLineNumber: number | null;
+    /** Source order = draw order. */
+    readonly elements: readonly WhiteboardElement[];
+    readonly options: WhiteboardOptions;
+    readonly diagnostics: readonly DgmoError[];
+    readonly error: string | null;
+}
+declare function isWhiteboardColor(value: string): value is WhiteboardColor;
+declare function isWhiteboardShapeKind(value: string): value is WhiteboardShapeKind;
+
+/** Is `ref` a relative path or an https URL (the only two image forms)? */
+declare function isWhiteboardImageRef(ref: string): boolean;
+declare function parseWhiteboard(content: string, _palette?: PaletteColors): ParsedWhiteboard;
+
+/** One element's source — its line, plus body lines for a multi-line label. */
+declare function emitWhiteboardElement(el: WhiteboardElement): string;
+/** The whole board as canonical source, ending in a newline. */
+declare function emitWhiteboard(board: ParsedWhiteboard): string;
+/** Structural equality ignoring line numbers and decoded points. */
+declare function sameWhiteboard(a: ParsedWhiteboard, b: ParsedWhiteboard): boolean;
+
+/**
+ * Leg of a sticky note's folded corner: its top-right corner is cut on the
+ * diagonal this far along each edge. Shared by the renderer, the connector
+ * clip and the app canvas.
+ */
+declare function whiteboardNoteFold(width: number, height: number): number;
+/** An element a connector end can attach to: a shape or a sticky note. */
+type WhiteboardAttachable = WhiteboardShape | WhiteboardNote;
+interface WhiteboardPoint {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * A drawn connector, `x1 y1` the tail and `x2 y2` the head end. A bent
+ * connector also carries `cx cy`, the control point of the quadratic curve
+ * it is drawn along; a straight one has none.
+ */
+interface WhiteboardSegment {
+    readonly x1: number;
+    readonly y1: number;
+    readonly x2: number;
+    readonly y2: number;
+    readonly cx?: number;
+    readonly cy?: number;
+}
+/** Element indices of the shapes each end is attached to; -1 for a free end. */
+interface WhiteboardConnectorAttachments {
+    readonly from: number;
+    readonly to: number;
+}
+/** Whether `point` lies inside (or on) the shape's or note's drawn outline. */
+declare function whiteboardShapeContains(shape: WhiteboardAttachable, point: WhiteboardPoint): boolean;
+/**
+ * Index in `elements` of the topmost shape or sticky note containing `point`
+ * — the one latest in the file — or -1 when the point is on none.
+ */
+declare function whiteboardShapeAt(point: WhiteboardPoint, elements: readonly WhiteboardElement[]): number;
+/**
+ * Which shape each end of `connector` is attached to. An end attaches to the
+ * topmost shape containing it — unless the other end lies inside that same
+ * shape, in which case the end stays free.
+ */
+declare function whiteboardConnectorAttachments(connector: WhiteboardArrow | WhiteboardLine, elements: readonly WhiteboardElement[]): WhiteboardConnectorAttachments;
+/**
+ * The segment a connector is DRAWN along: each attached end aimed at its
+ * shape's centre — wherever inside the shape the stored point sits — then
+ * pulled back to where the segment first crosses that shape's outline, so an
+ * arrowhead sits on the border and a plain line meets the edge. Falls back to
+ * the stored segment when it has no length, or when clipping both ends would
+ * leave nothing (the ends' shapes overlap along it).
+ */
+declare function clipWhiteboardConnector(connector: WhiteboardArrow | WhiteboardLine, elements: readonly WhiteboardElement[]): WhiteboardSegment;
+/**
+ * Where a connector's bend handle sits: on the curve, halfway along it —
+ * `bend` px off the middle of the aimed chord. A straight connector's handle
+ * is the chord's midpoint.
+ */
+declare function whiteboardBendHandle(connector: WhiteboardArrow | WhiteboardLine, elements: readonly WhiteboardElement[]): WhiteboardPoint;
+/**
+ * The `bend:` that puts the handle nearest `p` — its signed distance from the
+ * aimed chord, rounded to a whole px. Callers snap small values to 0.
+ */
+declare function whiteboardBendFor(connector: WhiteboardArrow | WhiteboardLine, elements: readonly WhiteboardElement[], p: WhiteboardPoint): number;
+/**
+ * The point a connector's label is centred on: halfway along what is drawn —
+ * the segment's midpoint, or the curve's point at t = ½.
+ */
+declare function whiteboardSegmentMidpoint(s: WhiteboardSegment): WhiteboardPoint;
+
+interface WhiteboardRenderOptions {
+    /**
+     * Turn an image ref into an `href` (a data URI or a URL). When supplied, its
+     * answer is final: `undefined` draws the placeholder box. When omitted,
+     * `https://` refs pass through unchanged and anything else is a placeholder.
+     */
+    readonly resolveImage?: (ref: string) => string | undefined;
+    /**
+     * Draw the sticky notes, overriding the board's `no-notes` directive either
+     * way — the app's notes toggle and its export pass this. Omitted, the
+     * directive decides: notes show unless the board says `no-notes`. Hidden
+     * notes are left out entirely — not drawn, not counted in the crop — and so
+     * is every arrow or line with an end on one.
+     */
+    readonly showNotes?: boolean;
+}
+/**
+ * Whole-board indices of the elements a render draws, in order: every
+ * element, less the sticky notes when they are hidden (see
+ * {@link WhiteboardRenderOptions.showNotes}) and less every arrow or line with
+ * an end on a hidden note — a connector drawn from a note goes with it, label
+ * and all. Attachment is read on the WHOLE board, so an end the note held is
+ * not re-attached to whatever lies beneath it.
+ */
+declare function visibleWhiteboardIndices(parsed: ParsedWhiteboard, options?: Pick<WhiteboardRenderOptions, 'showNotes'>): number[];
+/**
+ * The elements a render draws, in order — {@link visibleWhiteboardIndices},
+ * as elements.
+ */
+declare function visibleWhiteboardElements(parsed: ParsedWhiteboard, options?: Pick<WhiteboardRenderOptions, 'showNotes'>): readonly WhiteboardElement[];
+/** Placeholder text for an image no host could resolve. */
+declare const IMAGE_NOT_UPLOADED = "image not uploaded";
+interface Bounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/** Content bounds of every drawn element, in canvas px. */
+declare function whiteboardBounds(parsed: ParsedWhiteboard, options?: Pick<WhiteboardRenderOptions, 'showNotes'>): Bounds;
+/** What to draw for a connector: one stroke (a line or a curve) and its heads. */
+interface WhiteboardConnectorPaint {
+    /** A straight stroke, coordinates rounded to 0.01 px. */
+    readonly line?: {
+        readonly x1: number;
+        readonly y1: number;
+        readonly x2: number;
+        readonly y2: number;
+    };
+    /** A curved stroke, as one `M … Q …` path. */
+    readonly path?: string;
+    /** Each head as a polygon `points` string, tip first. */
+    readonly heads: readonly string[];
+}
+/**
+ * The stroke and heads of a drawn connector — the renderer and the app canvas
+ * both draw from this, so they cannot disagree. The stroke stops at each
+ * head's base; a head on a curve points along the bit of curve it covers.
+ */
+declare function whiteboardConnectorPaint(s: WhiteboardSegment, heads: {
+    readonly start: boolean;
+    readonly end: boolean;
+}): WhiteboardConnectorPaint;
+/** The outline polygon perfect-freehand produces, as an SVG path. */
+declare function inkOutlinePath(points: readonly InkPoint[], width: number): string;
+declare function renderWhiteboard(container: HTMLDivElement, parsed: ParsedWhiteboard, palette: PaletteColors, isDark: boolean, options?: WhiteboardRenderOptions): void;
+
+/** Sticky note text font size, px — smaller than a shape label. */
+declare const WHITEBOARD_NOTE_FONT = 12;
+/** Smallest font a label shrinks to before it is cut, px. */
+declare const WHITEBOARD_LABEL_MIN_FONT = 9;
+/**
+ * What the wrap needs to know about a shape or sticky note: its kind and its
+ * width. A whole `WhiteboardShape` or `WhiteboardNote` fits.
+ */
+type WhiteboardLabelBox = Pick<WhiteboardShape, 'shape' | 'width'> | Pick<WhiteboardNote, 'kind' | 'width'>;
+/** Width a label wraps to inside `box`, px. */
+declare function whiteboardLabelWidth(box: WhiteboardLabelBox): number;
+/**
+ * How far a label's centre sits right of its box's centre, px (negative is
+ * left). A queue's readable body is off-centre — its front cap takes twice the
+ * room its back cap does — so its label moves left by half a cap. Every other
+ * shape's label is centred.
+ */
+declare function whiteboardLabelShift(box: WhiteboardLabelBox): number;
+/** What the fit needs: a label box plus its height. */
+type WhiteboardFitBox = WhiteboardLabelBox & Pick<WhiteboardShape, 'height'>;
+/** Height a label fits inside `box`, px — the box less its padding, an
+ *  ellipse's curve and a database's two caps. Never below zero. */
+declare function whiteboardLabelHeight(box: WhiteboardFitBox): number;
+/**
+ * The lines a shape label or a sticky note's text is drawn as: each written
+ * line wrapped to the inner width at its font — the label font for a shape,
+ * `WHITEBOARD_NOTE_FONT` for a note. An empty written line stays one empty
+ * drawn line. `''` gives `[]`.
+ */
+declare function wrapWhiteboardLabel(label: string, box: WhiteboardLabelBox): string[];
+/**
+ * The lines a shape label or a sticky note's text is DRAWN as, and the font
+ * they are drawn at. From the full size (`WHITEBOARD_LABEL_FONT`, a note's
+ * `WHITEBOARD_NOTE_FONT`) down to `WHITEBOARD_LABEL_MIN_FONT`, the first size
+ * whose wrap fits the inner box in both width and height wins. At the floor,
+ * a word wider than the box breaks inside itself, and lines past the last one
+ * that fits are dropped, the last kept line ending in `…`. At least one line
+ * is always kept. `''` gives no lines.
+ *
+ * A sticky note that overflows at the floor gives up most of its vertical
+ * padding first, and its last line needs only its own font height, so it
+ * shows as much text as the card can hold. `top` is how far below the note's
+ * top edge its text block starts; a shape centres its block and ignores it.
+ */
+declare function fitWhiteboardLabel(label: string, box: WhiteboardFitBox): {
+    lines: string[];
+    font: number;
+    top: number;
+};
+
+/** A database's (cylinder's) cap, half-height. */
+declare const CYLINDER_RY = 8;
+/**
+ * Half-width of a queue's end caps — a cylinder on its side (#654).
+ *
+ * The same deal as `CLOUD_BUMP`, on the other axis:
+ * `computeC4NodeDimensions` adds `QUEUE_CAP * 2` to the width, so the caps
+ * never sit under the name.
+ *
+ * 🔴 It was 8 and that was too shallow to READ — measured by rendering it,
+ * not by reasoning about it. `CARD_RADIUS` is 6, so an 8px cap on a 250px
+ * card is within a couple of pixels of the rounding every plain card already
+ * has, and the queue came out indistinguishable from a box with no override:
+ * the exact defect this change exists to fix, reintroduced at a smaller
+ * scale. A shape override has to be legible at a glance or it is not an
+ * override.
+ */
+declare const QUEUE_CAP = 16;
+
 declare const SKETCH_GEOMETRY: {
     /** px per grid cell (the dot-grid pitch) */
     readonly cellPx: 16;
@@ -6056,6 +6476,108 @@ interface BlockLayoutOptions {
 }
 declare function layoutBlock(grid: BlockGrid, opts?: BlockLayoutOptions): BlockLayoutResult;
 
+declare const FLOWCHART_STRUCTURE_CODE = "E_FLOWCHART_STRUCTURE";
+/**
+ * Hard-error diagnostics for a flowchart that breaks the structural rules
+ * above. Empty = structurally valid, or not enough graph to judge.
+ */
+declare function validateFlowchartStructure(dgmo: string): DgmoError[];
+interface DiagramValidation {
+    chartType: string | null;
+    /** Blocking: severity `error`, plus every invalid colour. */
+    errors: DgmoError[];
+    warnings: DgmoError[];
+}
+interface ValidateDiagramOptions {
+    /**
+     * Map data, for `map` sources. Place names, routes and references are
+     * resolved (and errored) only by `resolveMap`; without it a map is checked
+     * by the parser alone, which misses an unknown place. Supplied by the host
+     * because loading it differs between Node and the browser.
+     */
+    mapData?: MapData;
+}
+/** Every diagnostic an agent should hear about, split into blocking and not. */
+declare function validateDiagram(source: string, options?: ValidateDiagramOptions): DiagramValidation;
+/** The text both MCP servers return, and whether it is an error result. */
+declare function formatDiagramValidation(v: DiagramValidation): {
+    text: string;
+    isError: boolean;
+};
+
+/**
+ * Parse the `<!-- TYPE-ALIASES: a=b c=b ... -->` map. Grouped data-chart /
+ * matrix ids (line, pie, raci, …) share another id's documented block.
+ */
+declare function parseTypeAliases(markdown: string): Map<string, string>;
+/**
+ * Extract the universal color rule (the closed 11-name palette + the explicit
+ * "no hex / no CSS color names" guidance) from the language reference. It lives
+ * between `<!-- COLORS start -->` / `<!-- COLORS end -->` inside the
+ * ANTIPATTERNS block. Returned so per-type slices — which omit the ANTIPATTERNS
+ * core — can still carry the color contract for EVERY chart type. Returns null
+ * if the markers are absent (older bundled reference).
+ */
+declare function extractColorRule(markdown: string): string | null;
+/**
+ * Extract the universal "always title the diagram" rule (the `<!-- TITLE start -->`
+ * / `<!-- TITLE end -->` block inside the STYLING core). Like the color rule, it
+ * is prepended to EVERY per-type slice so the model is told to title every
+ * diagram regardless of type — the STYLING core itself never rides the slice.
+ * Returns null if the markers are absent (older bundled reference).
+ */
+declare function extractTitleRule(markdown: string): string | null;
+/**
+ * Extract the universal "categorize and color by a tag group" rule (the
+ * `<!-- CATEGORIZE start -->` / `<!-- CATEGORIZE end -->` block inside the
+ * STYLING core). Like the color + title rules it is prepended to EVERY per-type
+ * slice so the model is pushed to find a categorization axis and color by it for
+ * every diagram. Returns null if the markers are absent (older bundled reference).
+ */
+declare function extractCategorizeRule(markdown: string): string | null;
+/**
+ * Slice the per-type block for `chartType`, resolving aliases first. A block
+ * runs from just after its `<!-- TYPE:<id> -->` marker to the next TYPE marker
+ * or the next `^## ` (H2) heading, whichever comes first. The opening TYPE
+ * marker is a purely structural anchor — it is EXCLUDED from the returned slice
+ * so it never reaches a consumer (the model would otherwise echo it verbatim as
+ * the first line of its generated diagram). Returns null when no anchor resolves
+ * (the id has neither a literal marker nor an alias).
+ */
+declare function extractSection(markdown: string, chartType: string): string | null;
+/**
+ * A chart type's reference block with the universal rules in front: the
+ * closed colour set, always-title, categorize-and-colour. A per-type slice
+ * omits the cores those live in, so without this the model never sees them.
+ * TIPS delimiter comments are stripped so no scaffolding is echoed into a
+ * generated diagram. Null when the type has no documented block.
+ */
+declare function referenceForChartType(markdown: string, chartType: string): string | null;
+/**
+ * The chart types an agent may offer, as `list_chart_types` prints them.
+ * An `internal` type routes but is never offered (nobody hand-authors a
+ * live-link); a `beta` type is offered and marked, so a model choosing it on
+ * someone's behalf can say it is unfinished.
+ */
+declare function formatChartTypeList(): string;
+/**
+ * Whether a gallery example belongs to `chartType`. Names are paths relative
+ * to gallery/fixtures without `.dgmo`: `<type>` or `<type>-*` at the top
+ * level, or anything under a `<type>/` directory.
+ */
+declare function isExampleFor(name: string, chartType: string): boolean;
+/** Examples shown per call, so a type with many does not flood the context. */
+declare const EXAMPLES_SHOWN = 5;
+/**
+ * What `get_examples` returns. Without a chart type, the list of names; with
+ * one, up to EXAMPLES_SHOWN sources in dgmo fences. `read` returns a named
+ * example's source.
+ */
+declare function formatExamples(names: readonly string[], read: (name: string) => Promise<string> | string, chartType?: string): Promise<{
+    text: string;
+    isError: boolean;
+}>;
+
 /** True when the first non-blank/non-comment line declares `map`. */
 declare function looksLikeMap(content: string): boolean;
 declare function parseMap(content: string, palette?: PaletteColors): ParsedMap;
@@ -7272,4 +7794,56 @@ declare function uncoveredCharacters(text: string, coverage: FontCoverage): read
  */
 declare function fontPortabilityWarning(runs: readonly UncoveredRun[]): string | undefined;
 
-export { ARROW_DIAGNOSTIC_CODES, type Activation, type AncestorInfo, type ArcLink, type ArcNodeGroup, type BLCollapseResult, type BLEdge, type BLGroup, type BLLayoutEdge, type BLLayoutGroup, type BLLayoutNode, type BLLayoutResult, type BLNode, type BlipTrend, type BlockCell, type BlockGrid, type BlockLayoutItem, type BlockLayoutResult, type BlockNode, type BlockOptions, type BodyFigure, type BodyOptions, type BodyPart, type BracketMode, type BracketSide, type C4ArrowType, type C4DeploymentNode, type C4Element, type C4ElementType, type C4Group, type C4LayoutBoundary, type C4LayoutEdge, type C4LayoutNode, type C4LayoutResult, type C4LegendEntry, type C4LegendGroup, type C4Relationship, type C4Shape, type C4TagEntry, type C4TagGroup, CONTAINER_FILL_OPACITY, CONTAINER_STROKE_OPACITY, CONTAINER_STROKE_WIDTH, type ChartDataPoint, type ChartEra, type ChartType$1 as ChartType, type ClassLayoutEdge, type ClassLayoutNode, type ClassLayoutResult, type ClassMember, type ClassModifier, type ClassNode, type ClassRelationship, type ClockEntry, type ClockFace, type ClockZoneKind, type CodepointRange, type CollapsedMindmapResult, type CollapsedOrgResult, type CollapsedSitemapResult, type CollapsedView, CompactViewState, type ComputedInfraEdge, type ComputedInfraModel, type ComputedInfraNode, type ContextRelationship, type CountUnits, type CreateMapGeoQueryOptions, type CycleEdge, type CycleLayoutEdge, type CycleLayoutNode, type CycleLayoutResult, type CycleNode, type CycleRenderOptions, type D3ExportDimensions, DEFAULT_FONT_NAME, DgmoError, type DiagramSymbols, type Duration, type DurationUnit, type ERCardinality, type ERColumn, type ERConstraint, type ERLayoutEdge, type ERLayoutNode, type ERLayoutResult, type ERRelationship, type ERTable, type ElseIfBranch, type EventLineEra, type EventLineEvent, type EventLineFocus, type EventLineOptions, type ExpandedActivity, type ExtendedChartType, FONT_FAMILY, type FamilyChild, type FamilyChildEdge, type FamilyLayoutNode, type FamilyLayoutResult, type FamilyMarriageBar, type FamilyPerson, type FamilySex, type FamilyUnion, type FocusOrgResult, type FocusResult, type FocusTarget, type FontCoverage, type GanttDependency, type GanttEra, type GanttGroup, type GroupRow as GanttGroupRow, type GanttHolidays, type GanttInteractiveOptions, type LaneHeaderRow as GanttLaneHeaderRow, type GanttMarker, type GanttNode, type GanttOptions, type Row as GanttRow, type GanttTask, type TaskRow as GanttTaskRow, GeoExtent, type GetOrCreateNameResult, type GoalMode, type GoalOptions, type GraphDirection, type GraphEdge, type GraphGroup, type GraphNode, type GraphShape, DEFAULT_DIM_OPACITY as HOVER_DIM_OPACITY, INFRA_BEHAVIOR_KEYS, INVALID_COLOR_CODE, INVALID_CSS_COLOR_HEX, type InfraAvailabilityPercentiles, type InfraBehaviorKey, type InfraCbState, type InfraComputeParams, type InfraDiagnostic, type InfraEdge, type InfraGroup, type InfraLatencyPercentiles, type InfraLayoutEdge, type InfraLayoutGroup, type InfraLayoutNode, type InfraLayoutResult, type InfraLegendGroup, type InfraNode, type InfraPlaybackState, type InfraProperty, type InfraRole, type InfraTagGroup, type InlineSpan, type JourneyMapAnnotation, type JourneyMapInteractiveOptions, type JourneyMapLayout, type JourneyMapPersona, type JourneyMapPhase, type JourneyMapStep, type KanbanCard, type KanbanColumn, type KanbanTagEntry, type KanbanTagGroup, LEGEND_CAPSULE_PAD, LEGEND_DOT_R, LEGEND_ENTRY_DOT_GAP, LEGEND_ENTRY_FONT_SIZE, LEGEND_ENTRY_TRAIL, LEGEND_GEAR_PILL_W, LEGEND_GROUP_GAP, LEGEND_HEIGHT, LEGEND_MAX_ENTRY_ROWS, LEGEND_PILL_FONT_SIZE, LEGEND_PILL_PAD, type LayoutEdge, type LayoutGroup, type LayoutNode, type LayoutOptions$1 as LayoutOptions, type LayoutResult$1 as LayoutResult, type LegendCallbacks, type LegendConfig, type LegendControl, type LegendGroupData, type LegendHandle, type LegendLayout, type LegendMode, type LegendPalette, type LegendPosition, type LegendState, MapData, type MapExportDimensions, type MapGeoQuery, type MapLayout, type MapLayoutInset, type MapLayoutLeg, MapLayoutLegend, type MapLayoutPoi, type MapLayoutRegion, type MapLayoutStretch, type MapProjectionKind, type MapProjectionParams, type MapProjectionSpec, type MemberVisibility, type MindmapLayoutEdge, type MindmapLayoutNode, type MindmapLayoutResult, type MindmapNode, type MonteCarloResult, type NameEntry, type NearestCity, type NodeDetail, type OrgContainerBounds, type OrgLayoutEdge, type OrgLayoutNode, type OrgLayoutResult, PaletteColors, PaletteConfig, type ParseInArrowLabelResult, type ParsedBlock, type ParsedBody, type ParsedBoxesAndLines, type ParsedBracket, type ParsedC4, type ParsedChart, type ParsedClassDiagram, type ParsedClock, type ParsedCountdown, type ParsedCycle, type ParsedERDiagram, type ParsedEventLine, type ParsedExtendedChart, type ParsedFamily, type ParsedGantt, type ParsedGoal, type ParsedGraph, type ParsedInfra, type ParsedJourneyMap, type ParsedKanban, type ParsedLiveLink, ParsedMap, type ParsedMindmap, ParsedOrg, type ParsedPert, type ParsedPyramid, ParsedRaci, type ParsedRing, type ParsedSequenceDgmo, type ParsedSitemap, type ParsedSketch, type ParsedSwimlane, type ParsedTechRadar, type ParsedTreemap, type ParsedVersionControl, type ParsedVisualization, type ParsedWireframe, type ParticipantType, type PertActivity, type Anchor as PertAnchor, type PertDirection, type PertEdge, type PertGroup, type PertLayoutEdge, type PertLayoutGroup, type PertLayoutNode, type LayoutOverrides as PertLayoutOverrides, type LayoutResult as PertLayoutResult, type PertMilestone, type PertOptions, type PertRenderOptions, type PlaceResolution, type PlacedLabel, type ProjectedCity, type PyramidLayer, type QuadrantPosition, RACI_ERROR_CODES, VARIANTS as RACI_VARIANTS, RACI_WARNING_CODES, RECOGNIZED_COLOR_NAMES, RULE_COUNT, type RaciDragSource, type RaciInteractionHandlers, RaciMarker, RaciTask, RaciVariant, type RadialCell, type RadialLayoutResult, type RawMatch, type RawSeed, type RecurRule, type RegionToken, type RelationshipType, type RenderStep, type ResolvedActivity, type ResolvedGroup$1 as ResolvedGroup, ResolvedMap, type ResolvedPert, type ResolvedGroup as ResolvedPertGroup, type ResolvedSchedule, type ResolvedTask, type ResultCard, type ResultTokens, type RingLayer, type RoundMode, SKETCH_AUTO_LAYOUT_DEFAULTS, SKETCH_FOOT_H, SKETCH_FOOT_W, SKETCH_GEOMETRY, SKETCH_HALF_SLOT_X, SKETCH_HALF_SLOT_Y, SKETCH_SEP, SKETCH_SHAPE_KINDS, SKETCH_SLOT_X, SKETCH_SLOT_Y, SKETCH_VISUALS, ScaleContext, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceNote, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, type SimulateOptions, type SitemapContainerBounds, type SitemapDirection, type SitemapEdge, type SitemapLayoutEdge, type SitemapLayoutNode, type SitemapLayoutResult, type SitemapLegendEntry, type SitemapLegendGroup, type SitemapNode, type SketchAt, type SketchAutoLayoutFlags, type SketchBox, type SketchCollapseResult, type SketchEdge, type SketchEdgeBoard, type SketchEdgeGeometry, type SketchEdgeHeads, type SketchFillMode, type SketchLayout, type SketchLayoutBox, type SketchLayoutNode, type SketchLayoutOptions, type SketchNode, type SketchNodeColors, type SketchOptions, type SketchRenderOptions, type SketchShapeKind, type StateCollapseResult, type SwimEdge, type SwimEvent, type SwimLane, type SwimNode, type SwimPhase, type SwimShape, type LayoutBand as SwimlaneLayoutBand, type SwimlaneLayoutResult, TagEntry, TagGroup, type TechRadarBlip, type TechRadarLayoutPoint, type TechRadarQuadrant, type TechRadarRing, type ThemeFileResult, type TreemapCell, type TreemapColorMode, type TreemapLayoutResult, type TreemapNode, type TreemapOptions, type UncoveredRun, type VCBranch, type VCNode, type VCNote, type VCOptions, type VCRef, type VisualizationType, type WireframeElement, type WireframeElementType, type WireframeFormFactor, type WireframeLayout, type WireframeLayoutNode, type WorkWindow, type ZoneSuggestion, addDurationToDate, albersSkewFallback, analyzePert, applyCollapseProjection, applyGroupOrdering, applyPositionOverrides, atlasPalette, authoredCollapsedIds, blueprintPalette, breakAtoms, buildNoteMessageMap, buildRenderSequence, buildSimulationContext, buildTagLaneRowList, calculateSchedule, canonicalSketch, catppuccinPalette, clearEventLineMuted, collapseBoxesAndLines, collapseMindmapTree, collapseOrgTree, collapseSitemapTree, collapseSketch, collapseStateGroups, collectDiagramRoles, collectTasks, colorNames, computeActivations, computeCardArchive, computeCardMove, computeCycleLayout, computeInfra, computeInfraLegendGroups, computeLegendLayout, computeRadarLayout, computeTimeTicks, controlsGroupCapsuleWidth, createMapGeoQuery, createMapGeoQueryForLayout, displayName, emitSketch, extractSymbols$2 as extractClassSymbols, extractSymbols$1 as extractErSymbols, extractSymbols$3 as extractFlowchartSymbols, extractSymbols as extractInfraSymbols, extractPertSymbols, fitWrapped, focusBoxesAndLines, focusEventLine, focusOrgTree, fontPortabilityWarning, formatDateLabel, formatOffsetLabel, getExtendedChartLegendGroups, getLegendReservedHeight, getOrCreateName, getRadarGeometry, getSimpleChartLegendGroups, groupMessagesBySection, inferParticipantType, inferRoles, invalidColorDiagnostic, isArchiveColumn, isInvalidColorToken, isRecognizedColorName, isSequenceBlock, isSequenceNote, isSketchShapeKind, layoutBlock, layoutBoxesAndLines, layoutBracket, layoutC4Components, layoutC4Containers, layoutC4Context, layoutC4Deployment, layoutClassDiagram, layoutERDiagram, layoutFamily, layoutGraph, layoutInfra, layoutJourneyMap, layoutMap, layoutMindmap, layoutOrg, layoutPert, layoutSitemap, layoutSketch, layoutSwimlane, layoutTreemap, layoutTreemapRadial, layoutWireframe, legendEntryWidth, loadMapData, looksLikeClassDiagram, looksLikeERDiagram, looksLikeFlowchart, looksLikeMap, looksLikePert, looksLikeSequence, looksLikeSitemap, looksLikeState, mapBackgroundColor, mapContentAspect, mapExportDimensions, mapNeutralLandColor, measurePertAnalysisBlock, measureText, mulberry32, nearestNamedColor, nord, nordPalette, normalizeName, normalizePlace, orderArcNodes, parseAndLayoutInfra, parseBlock, parseBody, parseBoxesAndLines, parseBracket, parseC4, parseChart, parseClassDiagram, parseClock, parseCountdown, parseCycle, parseDataRowValues, parseERDiagram, parseEventLine, parseExtendedChart, parseFamily, parseFixedOffset, parseFlowchart, parseGantt, parseGoal, parseInArrowLabel, parseInfra, parseInlineMarkdown, parseJourneyMap, parseKanban, parseLiveLink, parseMap, parseMindmap, parsePert, parsePyramid, parseRing, parseSequenceDgmo, parseSequenceDgmo as parseSequenceDiagram, parseSitemap, parseSketch, parseState, parseSwimlane, parseTechRadar, parseTimelineDate, parseTreemap, parseVersionControl, parseVisualization, parseWireframe, cellAppendMarker as raciCellAppendMarker, cellCycle as raciCellCycle, cellRemove as raciCellRemove, cellReplace as raciCellReplace, rebuildMapProjection, relayoutPert, render, renderArcDiagram, renderBlock, renderBlockForExport, renderBody, renderBodyForExport, renderBoxesAndLines, renderBoxesAndLinesForExport, renderBracket, renderBracketForExport, renderC4ComponentsForExport, renderC4Containers, renderC4ContainersForExport, renderC4Context, renderC4ContextForExport, renderC4Deployment, renderC4DeploymentForExport, renderClassDiagram, renderClassDiagramForExport, renderClock, renderClockForExport, renderCountdown, renderCountdownForExport, renderCycle, renderCycleForExport, renderERDiagram, renderERDiagramForExport, renderEventLine, renderEventLineForExport, renderFamily, renderFamilyForExport, renderFlowchart, renderFlowchartForExport, renderGantt, renderGoal, renderGoalForExport, renderInfra, renderJourneyMap, renderJourneyMapForExport, renderKanban, renderKanbanForExport, renderLegendD3, renderLegendSvg, renderLegendSvgFromConfig, renderLiveLinkCard, renderMap, renderMapForExport, renderMapLayout, renderMindmap, renderMindmapForExport, renderOrg, renderOrgForExport, renderPert, renderPertAnalysisBlock, renderPertForExport, renderPyramid, renderPyramidForExport, renderQuadrant, renderQuadrantFocus, renderQuadrantFocusForExport, renderRaci, renderRaciForExport, renderRing, renderRingForExport, renderSequenceDiagram, renderSitemap, renderSitemapForExport, renderSketch, renderSketchForExport, renderSlopeChart, renderState, renderStateForExport, renderSwimlaneForExport, renderTechRadar, renderTechRadarForExport, renderTimeline, renderTreemap, renderTreemapForExport, renderTreemapRadial, renderTreemapRadialForExport, renderVenn, renderVersionControl, renderVersionControlForExport, renderWireframe, renderWordCloud, resolveColor, resolveColorWithDiagnostic, resolveMap, resolvePlace, resolveTaskName, rollUpContextRelationships, sameSketch, sampleBetaPert, searchZones, seriesColors, simulateCanonical, simulateFast, sketchColors, sketchContainerFill, sketchEdgeGeometry, sketchNeutralFill, sketchSlotToPx, slatePalette, startClocks, startCountdowns, targetToMs, textFromSvg, tickClocks, tickCountdowns, tidewaterPalette, tokyoNightPalette, truncateBareUrl, truncateText, uncoveredCharacters, validateComputed, validateInfra, validateLabelCharacters, validateThemeFile, wrapTextToWidth };
+declare const CLOUD_API = "https://api.diagrammo.app";
+interface CloudSpaceTarget {
+    /** A space API key (`dgmo_sk_…`). */
+    apiKey: string;
+    spaceId: string;
+    /** Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+}
+/** A diagram in a space; `folder` is its path from the space root, `''` at the root. */
+interface SpaceDiagramSummary {
+    id: string;
+    title: string;
+    folder: string;
+    chartType: string | null;
+    version: string | null;
+    updatedAt: number;
+}
+interface SpaceDiagram extends SpaceDiagramSummary {
+    source: string;
+}
+interface SpacePutResult {
+    action: 'created' | 'updated';
+    id: string;
+    title: string;
+    folder: string;
+    version: string | null;
+}
+/** Any failure; `status` is the Cloud's HTTP status when there was one. */
+declare class CloudSpaceError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/**
+ * Write `source` as the diagram titled `title` in `folder` (a path from the
+ * space root; omitted = the root): updates that diagram if it exists, else
+ * creates it, private. Re-sending the same bytes is a no-op on the server.
+ */
+declare function putSpaceDiagram(target: CloudSpaceTarget, diagram: {
+    source: string;
+    title: string;
+    folder?: string;
+}): Promise<SpacePutResult>;
+/** Read one diagram, by `id` or by `title` in `folder` (omitted = the root). */
+declare function getSpaceDiagram(target: CloudSpaceTarget, which: {
+    id: string;
+} | {
+    title: string;
+    folder?: string;
+}): Promise<SpaceDiagram>;
+/** Every diagram in the space, sorted by folder path then title. */
+declare function listSpaceDiagrams(target: CloudSpaceTarget): Promise<SpaceDiagramSummary[]>;
+
+export { ARROW_DIAGNOSTIC_CODES, type Activation, type AncestorInfo, type ArcLink, type ArcNodeGroup, type BLCollapseResult, type BLEdge, type BLGroup, type BLLayoutEdge, type BLLayoutGroup, type BLLayoutNode, type BLLayoutResult, type BLNode, type BlipTrend, type BlockCell, type BlockGrid, type BlockLayoutItem, type BlockLayoutResult, type BlockNode, type BlockOptions, type BodyFigure, type BodyOptions, type BodyPart, type BracketMode, type BracketSide, type C4ArrowType, type C4DeploymentNode, type C4Element, type C4ElementType, type C4Group, type C4LayoutBoundary, type C4LayoutEdge, type C4LayoutNode, type C4LayoutResult, type C4LegendEntry, type C4LegendGroup, type C4Relationship, type C4Shape, type C4TagEntry, type C4TagGroup, CLOUD_API, CONTAINER_FILL_OPACITY, CONTAINER_STROKE_OPACITY, CONTAINER_STROKE_WIDTH, CYLINDER_RY, type ChartDataPoint, type ChartEra, type ChartType$1 as ChartType, type ClassLayoutEdge, type ClassLayoutNode, type ClassLayoutResult, type ClassMember, type ClassModifier, type ClassNode, type ClassRelationship, type ClockEntry, type ClockFace, type ClockZoneKind, CloudSpaceError, type CloudSpaceTarget, type CodepointRange, type CollapsedMindmapResult, type CollapsedOrgResult, type CollapsedSitemapResult, type CollapsedView, CompactViewState, type ComputedInfraEdge, type ComputedInfraModel, type ComputedInfraNode, type ContextRelationship, type CountUnits, type CreateMapGeoQueryOptions, type CycleEdge, type CycleLayoutEdge, type CycleLayoutNode, type CycleLayoutResult, type CycleNode, type CycleRenderOptions, type D3ExportDimensions, DEFAULT_FONT_NAME, DgmoError, type DiagramSymbols, type DiagramValidation, type Duration, type DurationUnit, type ERCardinality, type ERColumn, type ERConstraint, type ERLayoutEdge, type ERLayoutNode, type ERLayoutResult, type ERRelationship, type ERTable, EXAMPLES_SHOWN, type ElseIfBranch, type EventLineEra, type EventLineEvent, type EventLineFocus, type EventLineOptions, type ExpandedActivity, type ExtendedChartType, FLOWCHART_STRUCTURE_CODE, FONT_FAMILY, type FamilyChild, type FamilyChildEdge, type FamilyLayoutNode, type FamilyLayoutResult, type FamilyMarriageBar, type FamilyPerson, type FamilySex, type FamilyUnion, type FocusOrgResult, type FocusResult, type FocusTarget, type FontCoverage, type GanttDependency, type GanttEra, type GanttGroup, type GroupRow as GanttGroupRow, type GanttHolidays, type GanttInteractiveOptions, type LaneHeaderRow as GanttLaneHeaderRow, type GanttMarker, type GanttNode, type GanttOptions, type Row as GanttRow, type GanttTask, type TaskRow as GanttTaskRow, GeoExtent, type GetOrCreateNameResult, type GoalMode, type GoalOptions, type GraphDirection, type GraphEdge, type GraphGroup, type GraphNode, type GraphShape, DEFAULT_DIM_OPACITY as HOVER_DIM_OPACITY, IMAGE_NOT_UPLOADED, INFRA_BEHAVIOR_KEYS, INVALID_COLOR_CODE, INVALID_CSS_COLOR_HEX, type InfraAvailabilityPercentiles, type InfraBehaviorKey, type InfraCbState, type InfraComputeParams, type InfraDiagnostic, type InfraEdge, type InfraGroup, type InfraLatencyPercentiles, type InfraLayoutEdge, type InfraLayoutGroup, type InfraLayoutNode, type InfraLayoutResult, type InfraLegendGroup, type InfraNode, type InfraPlaybackState, type InfraProperty, type InfraRole, type InfraTagGroup, type InlineSpan, type JourneyMapAnnotation, type JourneyMapInteractiveOptions, type JourneyMapLayout, type JourneyMapPersona, type JourneyMapPhase, type JourneyMapStep, type KanbanCard, type KanbanColumn, type KanbanTagEntry, type KanbanTagGroup, LEGEND_CAPSULE_PAD, LEGEND_DOT_R, LEGEND_ENTRY_DOT_GAP, LEGEND_ENTRY_FONT_SIZE, LEGEND_ENTRY_TRAIL, LEGEND_GEAR_PILL_W, LEGEND_GROUP_GAP, LEGEND_HEIGHT, LEGEND_MAX_ENTRY_ROWS, LEGEND_PILL_FONT_SIZE, LEGEND_PILL_PAD, type LayoutEdge, type LayoutGroup, type LayoutNode, type LayoutOptions$1 as LayoutOptions, type LayoutResult$1 as LayoutResult, type LegendCallbacks, type LegendConfig, type LegendControl, type LegendGroupData, type LegendHandle, type LegendLayout, type LegendMode, type LegendPalette, type LegendPosition, type LegendState, MapData, type MapExportDimensions, type MapGeoQuery, type MapLayout, type MapLayoutInset, type MapLayoutLeg, MapLayoutLegend, type MapLayoutPoi, type MapLayoutRegion, type MapLayoutStretch, type MapProjectionKind, type MapProjectionParams, type MapProjectionSpec, type MemberVisibility, type MindmapLayoutEdge, type MindmapLayoutNode, type MindmapLayoutResult, type MindmapNode, type MonteCarloResult, type NameEntry, type NearestCity, type NodeDetail, type OrgContainerBounds, type OrgLayoutEdge, type OrgLayoutNode, type OrgLayoutResult, PaletteColors, PaletteConfig, type ParseInArrowLabelResult, type ParsedBlock, type ParsedBody, type ParsedBoxesAndLines, type ParsedBracket, type ParsedC4, type ParsedChart, type ParsedClassDiagram, type ParsedClock, type ParsedCountdown, type ParsedCycle, type ParsedERDiagram, type ParsedEventLine, type ParsedExtendedChart, type ParsedFamily, type ParsedGantt, type ParsedGoal, type ParsedGraph, type ParsedInfra, type ParsedJourneyMap, type ParsedKanban, type ParsedLiveLink, ParsedMap, type ParsedMindmap, ParsedOrg, type ParsedPert, type ParsedPyramid, ParsedRaci, type ParsedRing, type ParsedSequenceDgmo, type ParsedSitemap, type ParsedSketch, type ParsedSwimlane, type ParsedTechRadar, type ParsedTreemap, type ParsedVersionControl, type ParsedVisualization, type ParsedWhiteboard, type ParsedWireframe, type ParticipantType, type PertActivity, type Anchor as PertAnchor, type PertDirection, type PertEdge, type PertGroup, type PertLayoutEdge, type PertLayoutGroup, type PertLayoutNode, type LayoutOverrides as PertLayoutOverrides, type LayoutResult as PertLayoutResult, type PertMilestone, type PertOptions, type PertRenderOptions, type PlaceResolution, type PlacedLabel, type ProjectedCity, type PyramidLayer, QUEUE_CAP, type QuadrantPosition, RACI_ERROR_CODES, VARIANTS as RACI_VARIANTS, RACI_WARNING_CODES, RECOGNIZED_COLOR_NAMES, RULE_COUNT, type RaciDragSource, type RaciInteractionHandlers, RaciMarker, RaciTask, RaciVariant, type RadialCell, type RadialLayoutResult, type RawMatch, type RawSeed, type RecurRule, type RegionToken, type RelationshipType, type RenderStep, type ResolvedActivity, type ResolvedGroup$1 as ResolvedGroup, ResolvedMap, type ResolvedPert, type ResolvedGroup as ResolvedPertGroup, type ResolvedSchedule, type ResolvedTask, type ResultCard, type ResultTokens, type RingLayer, type RoundMode, SKETCH_AUTO_LAYOUT_DEFAULTS, SKETCH_FOOT_H, SKETCH_FOOT_W, SKETCH_GEOMETRY, SKETCH_HALF_SLOT_X, SKETCH_HALF_SLOT_Y, SKETCH_SEP, SKETCH_SLOT_X, SKETCH_SLOT_Y, SKETCH_VISUALS, ScaleContext, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceNote, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, type SimulateOptions, type SitemapContainerBounds, type SitemapDirection, type SitemapEdge, type SitemapLayoutEdge, type SitemapLayoutNode, type SitemapLayoutResult, type SitemapLegendEntry, type SitemapLegendGroup, type SitemapNode, type SketchAt, type SketchAutoLayoutFlags, type SketchBox, type SketchCollapseResult, type SketchEdge, type SketchEdgeBoard, type SketchEdgeGeometry, type SketchEdgeHeads, type SketchFillMode, type SketchLayout, type SketchLayoutBox, type SketchLayoutNode, type SketchLayoutOptions, type SketchNode, type SketchNodeColors, type SketchOptions, type SketchRenderOptions, type SpaceDiagram, type SpaceDiagramSummary, type SpacePutResult, type StateCollapseResult, type SwimEdge, type SwimEvent, type SwimLane, type SwimNode, type SwimPhase, type SwimShape, type LayoutBand as SwimlaneLayoutBand, type SwimlaneLayoutResult, TagEntry, TagGroup, type TechRadarBlip, type TechRadarLayoutPoint, type TechRadarQuadrant, type TechRadarRing, type ThemeFileResult, type TreemapCell, type TreemapColorMode, type TreemapLayoutResult, type TreemapNode, type TreemapOptions, type UncoveredRun, type VCBranch, type VCNode, type VCNote, type VCOptions, type VCRef, type ValidateDiagramOptions, type VisualizationType, WHITEBOARD_COLORS, WHITEBOARD_ELEMENT_KEYWORDS, WHITEBOARD_FILLS, WHITEBOARD_HEADS, WHITEBOARD_LABEL_MIN_FONT, WHITEBOARD_NOTE_COLOR, WHITEBOARD_NOTE_FONT, WHITEBOARD_NOTE_HEIGHT, WHITEBOARD_NOTE_WIDTH, WHITEBOARD_SHAPE_KINDS, WHITEBOARD_STROKE_STYLES, type WhiteboardArrow, type WhiteboardAttachable, type WhiteboardColor, type WhiteboardConnectorAttachments, type WhiteboardConnectorPaint, type WhiteboardElement, type WhiteboardFill, type WhiteboardFitBox, type WhiteboardHeads, type WhiteboardImage, type WhiteboardInk, type WhiteboardLabelBox, type WhiteboardLine, type WhiteboardNote, type WhiteboardOptions, type WhiteboardPoint, type WhiteboardRenderOptions, type WhiteboardSegment, type WhiteboardShape, type WhiteboardShapeKind, type WhiteboardStrokeStyle, type WhiteboardText, type WireframeElement, type WireframeElementType, type WireframeFormFactor, type WireframeLayout, type WireframeLayoutNode, type WorkWindow, type ZoneSuggestion, addDurationToDate, albersSkewFallback, analyzePert, applyCollapseProjection, applyGroupOrdering, applyPositionOverrides, atlasPalette, authoredCollapsedIds, blueprintPalette, breakAtoms, buildNoteMessageMap, buildRenderSequence, buildSimulationContext, buildTagLaneRowList, calculateSchedule, canonicalSketch, catppuccinPalette, clearEventLineMuted, clipWhiteboardConnector, collapseBoxesAndLines, collapseMindmapTree, collapseOrgTree, collapseSitemapTree, collapseSketch, collapseStateGroups, collectDiagramRoles, collectTasks, colorNames, computeActivations, computeCardArchive, computeCardMove, computeCycleLayout, computeInfra, computeInfraLegendGroups, computeLegendLayout, computeRadarLayout, computeTimeTicks, controlsGroupCapsuleWidth, createMapGeoQuery, createMapGeoQueryForLayout, displayName, emitSketch, emitWhiteboard, emitWhiteboardElement, extractCategorizeRule, extractSymbols$2 as extractClassSymbols, extractColorRule, extractSymbols$1 as extractErSymbols, extractSymbols$3 as extractFlowchartSymbols, extractSymbols as extractInfraSymbols, extractPertSymbols, extractSection, extractTitleRule, fitWhiteboardLabel, fitWrapped, focusBoxesAndLines, focusEventLine, focusOrgTree, fontPortabilityWarning, formatChartTypeList, formatDateLabel, formatDiagramValidation, formatExamples, formatOffsetLabel, getExtendedChartLegendGroups, getLegendReservedHeight, getOrCreateName, getRadarGeometry, getSimpleChartLegendGroups, getSpaceDiagram, groupMessagesBySection, inferParticipantType, inferRoles, inkOutlinePath, invalidColorDiagnostic, isArchiveColumn, isExampleFor, isInvalidColorToken, isRecognizedColorName, isSequenceBlock, isSequenceNote, isWhiteboardColor, isWhiteboardImageRef, isWhiteboardShapeKind, layoutBlock, layoutBoxesAndLines, layoutBracket, layoutC4Components, layoutC4Containers, layoutC4Context, layoutC4Deployment, layoutClassDiagram, layoutERDiagram, layoutFamily, layoutGraph, layoutInfra, layoutJourneyMap, layoutMap, layoutMindmap, layoutOrg, layoutPert, layoutSitemap, layoutSketch, layoutSwimlane, layoutTreemap, layoutTreemapRadial, layoutWireframe, legendEntryWidth, listSpaceDiagrams, loadMapData, looksLikeClassDiagram, looksLikeERDiagram, looksLikeFlowchart, looksLikeMap, looksLikePert, looksLikeSequence, looksLikeSitemap, looksLikeState, mapBackgroundColor, mapContentAspect, mapExportDimensions, mapNeutralLandColor, measurePertAnalysisBlock, measureText, mulberry32, nearestNamedColor, nord, nordPalette, normalizeName, normalizePlace, orderArcNodes, parseAndLayoutInfra, parseBlock, parseBody, parseBoxesAndLines, parseBracket, parseC4, parseChart, parseClassDiagram, parseClock, parseCountdown, parseCycle, parseDataRowValues, parseERDiagram, parseEventLine, parseExtendedChart, parseFamily, parseFixedOffset, parseFlowchart, parseGantt, parseGoal, parseInArrowLabel, parseInfra, parseInlineMarkdown, parseJourneyMap, parseKanban, parseLiveLink, parseMap, parseMindmap, parsePert, parsePyramid, parseRing, parseSequenceDgmo, parseSequenceDgmo as parseSequenceDiagram, parseSitemap, parseSketch, parseState, parseSwimlane, parseTechRadar, parseTimelineDate, parseTreemap, parseTypeAliases, parseVersionControl, parseVisualization, parseWhiteboard, parseWireframe, putSpaceDiagram, cellAppendMarker as raciCellAppendMarker, cellCycle as raciCellCycle, cellRemove as raciCellRemove, cellReplace as raciCellReplace, rebuildMapProjection, referenceForChartType, relayoutPert, render, renderArcDiagram, renderBlock, renderBlockForExport, renderBody, renderBodyForExport, renderBoxesAndLines, renderBoxesAndLinesForExport, renderBracket, renderBracketForExport, renderC4ComponentsForExport, renderC4Containers, renderC4ContainersForExport, renderC4Context, renderC4ContextForExport, renderC4Deployment, renderC4DeploymentForExport, renderClassDiagram, renderClassDiagramForExport, renderClock, renderClockForExport, renderCountdown, renderCountdownForExport, renderCycle, renderCycleForExport, renderERDiagram, renderERDiagramForExport, renderEventLine, renderEventLineForExport, renderFamily, renderFamilyForExport, renderFlowchart, renderFlowchartForExport, renderGantt, renderGoal, renderGoalForExport, renderInfra, renderJourneyMap, renderJourneyMapForExport, renderKanban, renderKanbanForExport, renderLegendD3, renderLegendSvg, renderLegendSvgFromConfig, renderLiveLinkCard, renderMap, renderMapForExport, renderMapLayout, renderMindmap, renderMindmapForExport, renderOrg, renderOrgForExport, renderPert, renderPertAnalysisBlock, renderPertForExport, renderPyramid, renderPyramidForExport, renderQuadrant, renderQuadrantFocus, renderQuadrantFocusForExport, renderRaci, renderRaciForExport, renderRing, renderRingForExport, renderSequenceDiagram, renderSitemap, renderSitemapForExport, renderSketch, renderSketchForExport, renderSlopeChart, renderState, renderStateForExport, renderSwimlaneForExport, renderTechRadar, renderTechRadarForExport, renderTimeline, renderTreemap, renderTreemapForExport, renderTreemapRadial, renderTreemapRadialForExport, renderVenn, renderVersionControl, renderVersionControlForExport, renderWhiteboard, renderWireframe, renderWordCloud, resolveColor, resolveColorWithDiagnostic, resolveMap, resolvePlace, resolveTaskName, rollUpContextRelationships, sameSketch, sameWhiteboard, sampleBetaPert, searchZones, seriesColors, simulateCanonical, simulateFast, sketchColors, sketchContainerFill, sketchEdgeGeometry, sketchLabelSpot, sketchNeutralFill, sketchSlotToPx, slatePalette, startClocks, startCountdowns, targetToMs, textFromSvg, tickClocks, tickCountdowns, tidewaterPalette, tokyoNightPalette, truncateBareUrl, truncateText, uncoveredCharacters, validateComputed, validateDiagram, validateFlowchartStructure, validateInfra, validateLabelCharacters, validateThemeFile, visibleWhiteboardElements, visibleWhiteboardIndices, whiteboardBendFor, whiteboardBendHandle, whiteboardBounds, whiteboardConnectorAttachments, whiteboardConnectorPaint, whiteboardLabelHeight, whiteboardLabelShift, whiteboardLabelWidth, whiteboardNoteFold, whiteboardSegmentMidpoint, whiteboardShapeAt, whiteboardShapeContains, wrapTextToWidth, wrapWhiteboardLabel };