agentic-mermaid 0.4.1 → 0.5.3

package/dist/browser-lazy/index.d.ts

@@ -142,7 +142,7 @@ declare const EXACT_ROLE_STYLE_CONTRACT: Readonly<{
     }>;
     readonly bar: Readonly<{
         properties: readonly ["fillColor", "borderColor", "strokeColor", "lineWidth"];
-        bindingFamilies: readonly ["xychart"];
+        bindingFamilies: readonly ["xychart", "sankey", "treemap"];
     }>;
     readonly series: Readonly<{
         properties: readonly ["borderColor", "strokeColor", "lineWidth"];
@@ -150,7 +150,7 @@ declare const EXACT_ROLE_STYLE_CONTRACT: Readonly<{
     }>;
     readonly point: Readonly<{
         properties: readonly ["fillColor", "borderColor", "strokeColor", "lineWidth"];
-        bindingFamilies: readonly ["radar"];
+        bindingFamilies: readonly ["radar", "xychart"];
     }>;
     readonly task: Readonly<{
         properties: readonly ["fillColor", "borderColor", "strokeColor", "lineWidth", "cue"];
@@ -172,15 +172,6 @@ type RoleStyles = {
     [Role in ExactStyleSceneRole]?: Readonly<RoleStyleFor<Role>>;
 };
 
-/**
- * Stable role vocabulary shared by every Scene backend.  Built-in roles keep
- * their existing rendering policy, while extensions must use a namespace
- * (`vendor:role`) so they cannot accidentally acquire new core semantics.
- */
-
-type CoreSceneRole = 'node' | 'edge' | 'edge-label' | 'group' | 'group-header' | 'label' | 'title' | 'defs' | 'prelude' | 'chrome';
-type BuiltinSceneRole = CoreSceneRole | 'actor' | 'lifeline' | 'activation' | 'message' | 'block' | 'note' | 'class-box' | 'member' | 'entity' | 'attribute' | 'relationship' | 'cardinality' | 'pie-slice' | 'legend' | 'bar' | 'series' | 'point' | 'axis' | 'grid' | 'plate' | 'section' | 'task' | 'milestone' | 'marker-line' | 'rail' | 'period' | 'event' | 'score' | 'actor-pill' | 'service' | 'junction' | 'icon';
-
 type BrandConstraintAction = 'warn' | 'error';
 type BrandConstraintFieldDescriptor = {
     readonly kind: 'role';
@@ -252,6 +243,261 @@ type BrandConstraint = {
     } & ConstraintPayload<Kind>>;
 }[BrandConstraintKind];
 
+/**
+ * One authority for the public palette vocabulary. The runtime validator,
+ * TypeScript type, JSON Schema, and generated field reference all project
+ * from this record.
+ */
+declare const STYLE_COLOR_TOKEN_DESCRIPTORS: {
+    readonly bg: {
+        readonly description: "Diagram page background.";
+    };
+    readonly fg: {
+        readonly description: "Primary text and foreground paint.";
+    };
+    readonly line: {
+        readonly description: "Connector and secondary line paint.";
+    };
+    readonly accent: {
+        readonly description: "Accent paint for emphasis and data series.";
+    };
+    readonly muted: {
+        readonly description: "Muted text and secondary data paint.";
+    };
+    readonly surface: {
+        readonly description: "Node and group surface fill.";
+    };
+    readonly border: {
+        readonly description: "Node and group border paint.";
+    };
+};
+type StyleColors = {
+    -readonly [Key in keyof typeof STYLE_COLOR_TOKEN_DESCRIPTORS]?: string;
+};
+declare const SEMANTIC_BINDING_CHANNELS: readonly ["category"];
+type SemanticBindingChannel = typeof SEMANTIC_BINDING_CHANNELS[number];
+interface SemanticBinding {
+    readonly channel: SemanticBindingChannel;
+    readonly value: string;
+    readonly slot: string;
+    readonly role?: BindableSceneRole;
+}
+type SemanticSlots = Readonly<Record<string, Readonly<RoleStyleSpec>>>;
+/**
+ * One authority for every public StyleSpec field and constraint. Keep
+ * renderer-private face defaults out of this manifest: they are not part of
+ * the external style contract.
+ */
+declare const STYLE_SPEC_FIELD_DESCRIPTORS: {
+    readonly formatVersion: {
+        readonly kind: "const";
+        readonly value: 1;
+        readonly group: "metadata";
+        readonly description: "Persisted wire-format version. Optional on input and normalized to 1 on output.";
+    };
+    readonly $schema: {
+        readonly kind: "string";
+        readonly group: "metadata";
+        readonly description: "Optional JSON Schema pointer for file-backed styles; ignored while rendering.";
+    };
+    readonly name: {
+        readonly kind: "string";
+        readonly group: "metadata";
+        readonly description: "Canonical look:name or palette:name identity; required only when registering a style.";
+    };
+    readonly blurb: {
+        readonly kind: "string";
+        readonly group: "metadata";
+        readonly description: "Short human-readable description used by discovery surfaces.";
+    };
+    readonly colors: {
+        readonly kind: "colors";
+        readonly group: "palette";
+        readonly description: "Partial palette of safe, non-fetching CSS color tokens.";
+    };
+    readonly font: {
+        readonly kind: "string";
+        readonly runtimeValidator: "safeCssFontFamily";
+        readonly group: "typography";
+        readonly description: "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.";
+    };
+    readonly roles: {
+        readonly kind: "roles";
+        readonly group: "roles";
+        readonly description: "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.";
+    };
+    readonly semanticSlots: {
+        readonly kind: "semanticSlots";
+        readonly group: "policy";
+        readonly description: "Named brand-neutral role-style slots selected by semantic bindings.";
+    };
+    readonly bindings: {
+        readonly kind: "bindings";
+        readonly group: "policy";
+        readonly description: "Ordered equality bindings from authored/domain meaning to semantic slots.";
+    };
+    readonly constraints: {
+        readonly kind: "constraints";
+        readonly group: "policy";
+        readonly description: "Closed inspect-only brand constraints with warn or error actions.";
+    };
+    readonly stroke: {
+        readonly kind: "enum";
+        readonly values: readonly ["crisp", "jittered", "freehand"];
+        readonly group: "stroke";
+        readonly description: "Stroke treatment; crisp is the default renderer.";
+    };
+    readonly roughness: {
+        readonly kind: "number";
+        readonly minimum: 0;
+        readonly maximum: 10;
+        readonly expected: "between 0 and 10";
+        readonly group: "stroke";
+        readonly description: "Rough.js stroke irregularity.";
+    };
+    readonly bowing: {
+        readonly kind: "number";
+        readonly minimum: 0;
+        readonly maximum: 10;
+        readonly expected: "between 0 and 10";
+        readonly group: "stroke";
+        readonly description: "Rough.js line bowing.";
+    };
+    readonly passes: {
+        readonly kind: "integer";
+        readonly minimum: 1;
+        readonly maximum: 8;
+        readonly expected: "an integer from 1 through 8";
+        readonly group: "stroke";
+        readonly description: "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.";
+    };
+    readonly strokeWidth: {
+        readonly kind: "number";
+        readonly exclusiveMinimum: 0;
+        readonly maximum: 20;
+        readonly expected: "greater than 0 and at most 20";
+        readonly group: "stroke";
+        readonly description: "Base stroke width in SVG user units.";
+    };
+    readonly fill: {
+        readonly kind: "enum";
+        readonly values: readonly ["none", "hachure", "solid", "wash"];
+        readonly group: "fill";
+        readonly description: "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.";
+    };
+    readonly hachureAngle: {
+        readonly kind: "number";
+        readonly minimum: -360;
+        readonly maximum: 360;
+        readonly expected: "between -360 and 360";
+        readonly group: "fill";
+        readonly description: "Hachure line angle in degrees; requires fill hachure in the final stack.";
+    };
+    readonly hachureGap: {
+        readonly kind: "number";
+        readonly exclusiveMinimum: 0;
+        readonly maximum: 100;
+        readonly expected: "greater than 0 and at most 100";
+        readonly group: "fill";
+        readonly description: "Gap between hachure lines; requires fill hachure in the final stack.";
+    };
+    readonly fillWeight: {
+        readonly kind: "number";
+        readonly exclusiveMinimum: 0;
+        readonly maximum: 20;
+        readonly expected: "greater than 0 and at most 20";
+        readonly group: "fill";
+        readonly description: "Hachure line weight; requires fill hachure in the final stack.";
+    };
+    readonly washOpacity: {
+        readonly kind: "number";
+        readonly minimum: 0;
+        readonly maximum: 1;
+        readonly expected: "between 0 and 1";
+        readonly group: "fill";
+        readonly description: "Watercolor glaze opacity; requires fill wash in the final stack.";
+    };
+    readonly washEdge: {
+        readonly kind: "number";
+        readonly minimum: 0;
+        readonly maximum: 1;
+        readonly expected: "between 0 and 1";
+        readonly group: "fill";
+        readonly description: "Watercolor edge-darkening opacity; requires fill wash in the final stack.";
+    };
+    readonly backdrop: {
+        readonly kind: "enum";
+        readonly values: readonly ["plain", "paper-ruled", "grid"];
+        readonly group: "page";
+        readonly description: "Flat page furniture drawn behind the diagram.";
+    };
+    readonly intent: {
+        readonly kind: "enum";
+        readonly values: readonly ["premium", "draft", "lofi"];
+        readonly group: "advisory";
+        readonly description: "Advisory intent metadata for pickers and quality tooling.";
+    };
+    readonly mono: {
+        readonly kind: "boolean";
+        readonly group: "advisory";
+        readonly description: "Advisory monochrome contract: express tone through shading and weight.";
+    };
+};
+type DescriptorValue<Descriptor> = Descriptor extends {
+    readonly kind: 'const';
+    readonly value: infer Value;
+} ? Value : Descriptor extends {
+    readonly kind: 'string';
+} ? string : Descriptor extends {
+    readonly kind: 'boolean';
+} ? boolean : Descriptor extends {
+    readonly kind: 'number' | 'integer';
+} ? number : Descriptor extends {
+    readonly kind: 'enum';
+    readonly values: readonly (infer Value)[];
+} ? Value : Descriptor extends {
+    readonly kind: 'colors';
+} ? StyleColors : Descriptor extends {
+    readonly kind: 'roles';
+} ? RoleStyles : Descriptor extends {
+    readonly kind: 'semanticSlots';
+} ? SemanticSlots : Descriptor extends {
+    readonly kind: 'bindings';
+} ? readonly SemanticBinding[] : Descriptor extends {
+    readonly kind: 'constraints';
+} ? readonly BrandConstraint[] : never;
+/** A partial, composable public description of how diagrams look. */
+type StyleSpec = {
+    -readonly [Key in keyof typeof STYLE_SPEC_FIELD_DESCRIPTORS]?: DescriptorValue<(typeof STYLE_SPEC_FIELD_DESCRIPTORS)[Key]>;
+};
+
+/** What RenderOptions.style accepts: a registered name, an inline spec, or a
+ *  stack of either (merged left → right). */
+type StyleInput = string | StyleSpec;
+
+/**
+ * Stable role vocabulary shared by every Scene backend.  Built-in roles keep
+ * their existing rendering policy, while extensions must use a namespace
+ * (`vendor:role`) so they cannot accidentally acquire new core semantics.
+ */
+
+type CoreSceneRole = 'node' | 'edge' | 'edge-label' | 'group' | 'group-header' | 'label' | 'title' | 'defs' | 'prelude' | 'chrome';
+type BuiltinSceneRole = CoreSceneRole | 'actor' | 'lifeline' | 'activation' | 'message' | 'block' | 'note' | 'class-box' | 'member' | 'entity' | 'attribute' | 'relationship' | 'cardinality' | 'pie-slice' | 'legend' | 'bar' | 'series' | 'point' | 'axis' | 'grid' | 'plate' | 'section' | 'task' | 'milestone' | 'marker-line' | 'rail' | 'period' | 'event' | 'score' | 'actor-pill' | 'service' | 'junction' | 'icon';
+
+interface GraphLayoutDecision {
+    readonly requested: 'elk' | 'agentic';
+    readonly fallback: 'none' | 'elk';
+    readonly selected: 'elk' | 'agentic';
+    readonly reason?: string;
+    readonly attempts: readonly {
+        readonly backend: 'elk' | 'agentic';
+        readonly outcome: 'selected' | 'unsupported' | 'candidate-rejected';
+        readonly reason?: string;
+    }[];
+    readonly implementation: string;
+    readonly role?: 'primary' | 'companion';
+}
+
 type MermaidConfigScalar = string | number | boolean | null;
 type MermaidConfigValue = MermaidConfigScalar | MermaidConfigValue[] | MermaidConfigMap;
 interface MermaidConfigMap {
@@ -265,7 +511,7 @@ interface TimelineRuntimeConfig extends MermaidConfigMap {
     sectionFills?: string[];
     sectionColours?: string[];
 }
-/** Mermaid stateDiagram config. Faithful ELK/measured-text fields are wired; legacy fields warn. */
+/** Mermaid stateDiagram config. Faithful ELK/measured-text fields are wired; unsupported fields warn. */
 interface StateRuntimeConfig extends MermaidConfigMap {
     titleTopMargin?: number;
     arrowMarkerAbsolute?: boolean;
@@ -287,6 +533,11 @@ interface StateRuntimeConfig extends MermaidConfigMap {
     compositTitleSize?: number;
     radius?: number;
     defaultRenderer?: 'dagre-d3' | 'dagre-wrapper' | 'elk';
+    layout?: string;
+    look?: string;
+    minNodeWidth?: number;
+    theme?: string;
+    wrappingWidth?: number;
 }
 interface XyChartRuntimeConfig extends MermaidConfigMap {
     width?: number;
@@ -298,6 +549,7 @@ interface XyChartRuntimeConfig extends MermaidConfigMap {
     chartOrientation?: 'vertical' | 'horizontal';
     plotReservedSpacePercent?: number;
     showDataLabel?: boolean;
+    showDataLabelOutsideBar?: boolean;
     showTitle?: boolean;
     showLegend?: boolean;
     legendFontSize?: number;
@@ -313,6 +565,20 @@ interface PieRuntimeConfig extends MermaidConfigMap {
     useMaxWidth?: boolean;
     useWidth?: number;
 }
+interface SankeyRuntimeConfig extends MermaidConfigMap {
+    width?: number;
+    height?: number;
+    linkColor?: 'source' | 'target' | 'gradient' | string;
+    nodeAlignment?: 'justify' | 'center' | 'left' | 'right';
+    showValues?: boolean;
+    prefix?: string;
+    suffix?: string;
+    labelStyle?: 'legacy' | 'outlined';
+    nodeWidth?: number;
+    nodePadding?: number;
+    nodeColors?: Record<string, string>;
+    useMaxWidth?: boolean;
+}
 interface RadarRuntimeConfig extends MermaidConfigMap {
     width?: number;
     height?: number;
@@ -412,7 +678,7 @@ interface GitGraphRuntimeConfig extends MermaidConfigMap {
  * nodeSpacing/rankSpacing are wired into the ELK layout
  * (src/class/layout.ts resolveClassRenderOptions); every other documented
  * key is accepted for config-shape compatibility and named by verify's
- * INEFFECTIVE_CONFIG lint (CLASS_NOOP_CONFIG_FIELDS in src/agent/verify.ts).
+ * INEFFECTIVE_CONFIG lint (the family's config.noopKeys in src/agent/families.ts).
  */
 interface ClassRuntimeConfig extends MermaidConfigMap {
     nodeSpacing?: number;
@@ -432,7 +698,7 @@ interface ClassRuntimeConfig extends MermaidConfigMap {
  * Mermaid's documented er config shape (wire-or-warn, P4): layoutDirection +
  * nodeSpacing/rankSpacing are wired (src/er/layout.ts
  * applyErFrontmatterConfig); the rest emit INEFFECTIVE_CONFIG
- * (ER_NOOP_CONFIG_FIELDS in src/agent/verify.ts).
+ * (the family's config.noopKeys in src/agent/families.ts).
  */
 interface ErRuntimeConfig extends MermaidConfigMap {
     layoutDirection?: string;
@@ -452,8 +718,8 @@ interface ErRuntimeConfig extends MermaidConfigMap {
  * iconSize, fontSize, nodeSeparation, and idealEdgeLengthMultiplier are wired
  * (src/architecture/config.ts); the fcose simulation knobs — edgeElasticity,
  * numIter, seed, randomize — have no meaning in the deterministic layout and
- * emit INEFFECTIVE_CONFIG (ARCHITECTURE_NOOP_CONFIG_FIELDS in
- * src/architecture/config.ts).
+ * emit INEFFECTIVE_CONFIG (the family's config.noopKeys in
+ * src/agent/families.ts).
  */
 interface ArchitectureRuntimeConfig extends MermaidConfigMap {
     padding?: number;
@@ -471,8 +737,8 @@ interface ArchitectureRuntimeConfig extends MermaidConfigMap {
  * nodeSpacing/rankSpacing/wrappingWidth are wired
  * (src/flowchart-config.ts resolveFlowchartRenderOptions); every other
  * documented key is accepted for config-shape compatibility and named by
- * verify's INEFFECTIVE_CONFIG lint (FLOWCHART_NOOP_CONFIG_FIELDS in
- * src/flowchart-config.ts).
+ * verify's INEFFECTIVE_CONFIG lint (the family's config.noopKeys in
+ * src/agent/families.ts).
  */
 interface FlowchartRuntimeConfig extends MermaidConfigMap {
     nodeSpacing?: number;
@@ -494,8 +760,8 @@ interface FlowchartRuntimeConfig extends MermaidConfigMap {
  * and showSequenceNumbers are wired (src/sequence/config.ts
  * resolveSequenceConfig → src/sequence/layout.ts); every other documented key
  * is accepted for config-shape compatibility and named by verify's
- * INEFFECTIVE_CONFIG lint (SEQUENCE_NOOP_CONFIG_FIELDS in
- * src/sequence/config.ts).
+ * INEFFECTIVE_CONFIG lint (the family's config.noopKeys in
+ * src/agent/families.ts).
  */
 interface SequenceRuntimeConfig extends MermaidConfigMap {
     actorMargin?: number;
@@ -531,261 +797,53 @@ interface SequenceRuntimeConfig extends MermaidConfigMap {
     messageFontFamily?: string;
     messageFontWeight?: string | number;
 }
-interface MermaidRuntimeConfig extends MermaidConfigMap {
-    theme?: string;
-    fontFamily?: string;
-    themeVariables?: MermaidThemeVariables;
-    flowchart?: FlowchartRuntimeConfig;
-    state?: StateRuntimeConfig;
-    timeline?: TimelineRuntimeConfig;
-    journey?: JourneyRuntimeConfig;
-    xyChart?: XyChartRuntimeConfig;
-    pie?: PieRuntimeConfig;
-    quadrantChart?: QuadrantRuntimeConfig;
-    radar?: RadarRuntimeConfig;
-    gantt?: GanttRuntimeConfig;
-    sequence?: SequenceRuntimeConfig;
-    class?: ClassRuntimeConfig;
-    er?: ErRuntimeConfig;
-    architecture?: ArchitectureRuntimeConfig;
-    mindmap?: MindmapRuntimeConfig;
-    gitGraph?: GitGraphRuntimeConfig;
-    useMaxWidth?: boolean;
-    useWidth?: number;
-    themeCSS?: string;
-}
-
-/**
- * One authority for the public palette vocabulary. The runtime validator,
- * TypeScript type, JSON Schema, and generated field reference all project
- * from this record.
- */
-declare const STYLE_COLOR_TOKEN_DESCRIPTORS: {
-    readonly bg: {
-        readonly description: "Diagram page background.";
-    };
-    readonly fg: {
-        readonly description: "Primary text and foreground paint.";
-    };
-    readonly line: {
-        readonly description: "Connector and secondary line paint.";
-    };
-    readonly accent: {
-        readonly description: "Accent paint for emphasis and data series.";
-    };
-    readonly muted: {
-        readonly description: "Muted text and secondary data paint.";
-    };
-    readonly surface: {
-        readonly description: "Node and group surface fill.";
-    };
-    readonly border: {
-        readonly description: "Node and group border paint.";
-    };
-};
-type StyleColors = {
-    -readonly [Key in keyof typeof STYLE_COLOR_TOKEN_DESCRIPTORS]?: string;
-};
-declare const SEMANTIC_BINDING_CHANNELS: readonly ["category"];
-type SemanticBindingChannel = typeof SEMANTIC_BINDING_CHANNELS[number];
-interface SemanticBinding {
-    readonly channel: SemanticBindingChannel;
-    readonly value: string;
-    readonly slot: string;
-    readonly role?: BindableSceneRole;
+/** C4 spacing is pixel-space; terminal layout allocates its own cell geometry. */
+interface C4RuntimeConfig extends MermaidConfigMap {
+    /** Reflow budget in pixels; minimum legible geometry may exceed it with a diagnostic. */
+    maxWidth?: number;
+    /** Compact independently measured pixel and terminal layouts. */
+    compact?: boolean;
+    /** Automatic semantic type legend; authored legend directives remain independent. */
+    typeLegend?: boolean;
+    diagramMarginX?: number;
+    diagramMarginY?: number;
+    c4ShapeMargin?: number;
+    c4ShapePadding?: number;
+    width?: number;
+    height?: number;
+    boxMargin?: number;
+    nextLinePaddingX?: number;
+    c4ShapeInRow?: number;
+    c4BoundaryInRow?: number;
+    wrap?: boolean;
+    wrapPadding?: number;
+    useMaxWidth?: boolean;
+}
+interface MermaidRuntimeConfig extends MermaidConfigMap {
+    theme?: string;
+    fontFamily?: string;
+    themeVariables?: MermaidThemeVariables;
+    flowchart?: FlowchartRuntimeConfig;
+    state?: StateRuntimeConfig;
+    timeline?: TimelineRuntimeConfig;
+    journey?: JourneyRuntimeConfig;
+    xyChart?: XyChartRuntimeConfig;
+    pie?: PieRuntimeConfig;
+    quadrantChart?: QuadrantRuntimeConfig;
+    radar?: RadarRuntimeConfig;
+    sankey?: SankeyRuntimeConfig;
+    c4?: C4RuntimeConfig;
+    gantt?: GanttRuntimeConfig;
+    sequence?: SequenceRuntimeConfig;
+    class?: ClassRuntimeConfig;
+    er?: ErRuntimeConfig;
+    architecture?: ArchitectureRuntimeConfig;
+    mindmap?: MindmapRuntimeConfig;
+    gitGraph?: GitGraphRuntimeConfig;
+    useMaxWidth?: boolean;
+    useWidth?: number;
+    themeCSS?: string;
 }
-type SemanticSlots = Readonly<Record<string, Readonly<RoleStyleSpec>>>;
-/**
- * One authority for every public StyleSpec field and constraint. Keep
- * renderer-private face defaults out of this manifest: they are not part of
- * the external style contract.
- */
-declare const STYLE_SPEC_FIELD_DESCRIPTORS: {
-    readonly formatVersion: {
-        readonly kind: "const";
-        readonly value: 1;
-        readonly group: "metadata";
-        readonly description: "Persisted wire-format version. Optional on input and normalized to 1 on output.";
-    };
-    readonly $schema: {
-        readonly kind: "string";
-        readonly group: "metadata";
-        readonly description: "Optional JSON Schema pointer for file-backed styles; ignored while rendering.";
-    };
-    readonly name: {
-        readonly kind: "string";
-        readonly group: "metadata";
-        readonly description: "Canonical look:name or palette:name identity; required only when registering a style.";
-    };
-    readonly blurb: {
-        readonly kind: "string";
-        readonly group: "metadata";
-        readonly description: "Short human-readable description used by discovery surfaces.";
-    };
-    readonly colors: {
-        readonly kind: "colors";
-        readonly group: "palette";
-        readonly description: "Partial palette of safe, non-fetching CSS color tokens.";
-    };
-    readonly font: {
-        readonly kind: "string";
-        readonly runtimeValidator: "safeCssFontFamily";
-        readonly group: "typography";
-        readonly description: "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.";
-    };
-    readonly roles: {
-        readonly kind: "roles";
-        readonly group: "roles";
-        readonly description: "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.";
-    };
-    readonly semanticSlots: {
-        readonly kind: "semanticSlots";
-        readonly group: "policy";
-        readonly description: "Named brand-neutral role-style slots selected by semantic bindings.";
-    };
-    readonly bindings: {
-        readonly kind: "bindings";
-        readonly group: "policy";
-        readonly description: "Ordered equality bindings from authored/domain meaning to semantic slots.";
-    };
-    readonly constraints: {
-        readonly kind: "constraints";
-        readonly group: "policy";
-        readonly description: "Closed inspect-only brand constraints with warn or error actions.";
-    };
-    readonly stroke: {
-        readonly kind: "enum";
-        readonly values: readonly ["crisp", "jittered", "freehand"];
-        readonly group: "stroke";
-        readonly description: "Stroke treatment; crisp is the default renderer.";
-    };
-    readonly roughness: {
-        readonly kind: "number";
-        readonly minimum: 0;
-        readonly maximum: 10;
-        readonly expected: "between 0 and 10";
-        readonly group: "stroke";
-        readonly description: "Rough.js stroke irregularity.";
-    };
-    readonly bowing: {
-        readonly kind: "number";
-        readonly minimum: 0;
-        readonly maximum: 10;
-        readonly expected: "between 0 and 10";
-        readonly group: "stroke";
-        readonly description: "Rough.js line bowing.";
-    };
-    readonly passes: {
-        readonly kind: "integer";
-        readonly minimum: 1;
-        readonly maximum: 8;
-        readonly expected: "an integer from 1 through 8";
-        readonly group: "stroke";
-        readonly description: "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.";
-    };
-    readonly strokeWidth: {
-        readonly kind: "number";
-        readonly exclusiveMinimum: 0;
-        readonly maximum: 20;
-        readonly expected: "greater than 0 and at most 20";
-        readonly group: "stroke";
-        readonly description: "Base stroke width in SVG user units.";
-    };
-    readonly fill: {
-        readonly kind: "enum";
-        readonly values: readonly ["none", "hachure", "solid", "wash"];
-        readonly group: "fill";
-        readonly description: "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.";
-    };
-    readonly hachureAngle: {
-        readonly kind: "number";
-        readonly minimum: -360;
-        readonly maximum: 360;
-        readonly expected: "between -360 and 360";
-        readonly group: "fill";
-        readonly description: "Hachure line angle in degrees; requires fill hachure in the final stack.";
-    };
-    readonly hachureGap: {
-        readonly kind: "number";
-        readonly exclusiveMinimum: 0;
-        readonly maximum: 100;
-        readonly expected: "greater than 0 and at most 100";
-        readonly group: "fill";
-        readonly description: "Gap between hachure lines; requires fill hachure in the final stack.";
-    };
-    readonly fillWeight: {
-        readonly kind: "number";
-        readonly exclusiveMinimum: 0;
-        readonly maximum: 20;
-        readonly expected: "greater than 0 and at most 20";
-        readonly group: "fill";
-        readonly description: "Hachure line weight; requires fill hachure in the final stack.";
-    };
-    readonly washOpacity: {
-        readonly kind: "number";
-        readonly minimum: 0;
-        readonly maximum: 1;
-        readonly expected: "between 0 and 1";
-        readonly group: "fill";
-        readonly description: "Watercolor glaze opacity; requires fill wash in the final stack.";
-    };
-    readonly washEdge: {
-        readonly kind: "number";
-        readonly minimum: 0;
-        readonly maximum: 1;
-        readonly expected: "between 0 and 1";
-        readonly group: "fill";
-        readonly description: "Watercolor edge-darkening opacity; requires fill wash in the final stack.";
-    };
-    readonly backdrop: {
-        readonly kind: "enum";
-        readonly values: readonly ["plain", "paper-ruled", "grid"];
-        readonly group: "page";
-        readonly description: "Flat page furniture drawn behind the diagram.";
-    };
-    readonly intent: {
-        readonly kind: "enum";
-        readonly values: readonly ["premium", "draft", "lofi"];
-        readonly group: "advisory";
-        readonly description: "Advisory intent metadata for pickers and quality tooling.";
-    };
-    readonly mono: {
-        readonly kind: "boolean";
-        readonly group: "advisory";
-        readonly description: "Advisory monochrome contract: express tone through shading and weight.";
-    };
-};
-type DescriptorValue<Descriptor> = Descriptor extends {
-    readonly kind: 'const';
-    readonly value: infer Value;
-} ? Value : Descriptor extends {
-    readonly kind: 'string';
-} ? string : Descriptor extends {
-    readonly kind: 'boolean';
-} ? boolean : Descriptor extends {
-    readonly kind: 'number' | 'integer';
-} ? number : Descriptor extends {
-    readonly kind: 'enum';
-    readonly values: readonly (infer Value)[];
-} ? Value : Descriptor extends {
-    readonly kind: 'colors';
-} ? StyleColors : Descriptor extends {
-    readonly kind: 'roles';
-} ? RoleStyles : Descriptor extends {
-    readonly kind: 'semanticSlots';
-} ? SemanticSlots : Descriptor extends {
-    readonly kind: 'bindings';
-} ? readonly SemanticBinding[] : Descriptor extends {
-    readonly kind: 'constraints';
-} ? readonly BrandConstraint[] : never;
-/** A partial, composable public description of how diagrams look. */
-type StyleSpec = {
-    -readonly [Key in keyof typeof STYLE_SPEC_FIELD_DESCRIPTORS]?: DescriptorValue<(typeof STYLE_SPEC_FIELD_DESCRIPTORS)[Key]>;
-};
-
-/** What RenderOptions.style accepts: a registered name, an inline spec, or a
- *  stack of either (merged left → right). */
-type StyleInput = string | StyleSpec;
 
 interface ArchitectureVisualConfig {
     groupHeaderHeight: number;
@@ -840,7 +898,26 @@ interface ConfigDiagnostic {
     field: string;
     message: string;
 }
+interface GraphLayoutHints {
+    /** Ordered ELK partitions; unlisted nodes use partition zero. These are relative ranks, not pixel coordinates. */
+    ranks?: Record<string, number>;
+    /** Preferred consecutive model order within one container; geometry remains certified. */
+    adjacent?: readonly (readonly string[])[];
+    /** Authored edge IDs or from->to / from->to#k occurrence IDs to prioritize for short routes. */
+    shortEdges?: readonly string[];
+}
+interface GraphLayoutOptions {
+    backend: 'elk' | 'agentic';
+    /** Agentic may explicitly fall back to ELK; omitted means none. */
+    fallback?: 'none' | 'elk';
+}
 interface RenderOptions {
+    /** Explicit deterministic Flowchart/State placement preferences; included in render receipts. */
+    layoutHints?: GraphLayoutHints;
+    /** Graph geometry producer; omitted preserves the existing ELK pipeline. */
+    graphLayout?: GraphLayoutOptions;
+    /** Require complete native layout evidence, or report explicit limitations. */
+    layoutSafety?: 'report' | 'strict';
     /** Background color → CSS variable --bg. Default: '#FFFFFF' */
     bg?: string;
     /** Foreground / primary text color → CSS variable --fg. Default: '#27272A' */
@@ -894,6 +971,21 @@ interface RenderOptions {
         /** Nest namespace compounds (default true); false lays them out compactly as siblings. */
         hierarchicalNamespaces?: boolean;
     };
+    /** Opt-in graphical Kanban layout controls; source order and card membership remain unchanged. */
+    kanban?: {
+        /** Wrap whole columns into rows within this best-effort pixel width, retaining readable column widths. */
+        maxWidth?: number;
+    };
+    /** Opt-in graphical fitting; selected typography and slice meaning are retained. */
+    pie?: {
+        /** Best-effort pixel width; explicit legend placement retains precedence. */
+        maxWidth?: number;
+    };
+    /** Opt-in graphical fitting; authored frames and radar scale meaning are retained. */
+    radar?: {
+        /** Best-effort pixel width with a bounded plot/legend arrangement search. */
+        maxWidth?: number;
+    };
     /** Family-specific SVG renderer options for architecture-beta diagrams. */
     architecture?: {
         visual?: ArchitectureVisualOverrides;
@@ -1000,6 +1092,181 @@ interface RenderOptions {
     seed?: number;
 }
 
+interface PaintViewport {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+interface PaintCertificationIssue {
+    readonly code: 'UNMEASURED_PAINT' | 'UNPREPARED_TEXT' | 'CONDITIONAL_PAINT' | 'LABEL_CONTAINMENT' | 'TEXT_OCCLUDED' | 'CHECK_BUDGET' | 'OUTPUT_SCOPE' | 'POTENTIAL_OCCLUSION' | 'MARKER_OCCLUDED' | 'CONNECTOR_CARD_CROSSING';
+    readonly id?: string;
+    readonly by?: string;
+    readonly message: string;
+}
+interface PaintLayoutCertification {
+    readonly version: 1;
+    readonly unit: 'px';
+    readonly scope: 'native-scene';
+    readonly status: 'passed' | 'failed' | 'unverified';
+    /** Digest of the final secured SVG this proof was issued with. Its shape,
+     * text and connector elements are written from the fields the proof reads;
+     * the document passes after the backend resolve colour variables, fit
+     * uncalibrated host fonts, namespace ids and scope styles, and the security
+     * policy may remove content it does not admit. */
+    readonly outputDigest?: string;
+    readonly viewport: PaintViewport;
+    readonly attempts: 1 | 2;
+    readonly repairs: readonly 'expand-viewport'[];
+    readonly coverage: {
+        readonly measured: number;
+        readonly unmeasured: number;
+        readonly preparedText: number;
+        readonly fallbackText: number;
+        readonly conditional: number;
+    };
+    readonly checks: {
+        readonly primitives: number;
+        readonly labels: number;
+        readonly occlusionPairs: number;
+        readonly maxOcclusionPairs: number;
+        readonly operations: number;
+        readonly maxOperations: number;
+        readonly markers: number;
+    };
+    readonly issues: readonly PaintCertificationIssue[];
+    readonly limitations: readonly string[];
+}
+
+type TerminalCertificationStatus = 'passed' | 'failed' | 'unverified';
+interface TerminalLayoutCertificationIssue {
+    readonly code: string;
+    readonly status: Exclude<TerminalCertificationStatus, 'passed'>;
+    readonly message: string;
+    readonly elementId?: string;
+    readonly cell?: Readonly<{
+        column: number;
+        row: number;
+    }>;
+}
+interface TerminalLayoutCertification {
+    readonly version: 1;
+    readonly unit: 'cell';
+    readonly scope: 'terminal-cells';
+    readonly status: TerminalCertificationStatus;
+    /** Digest of the exact encoded text returned to this caller, not source/model data. */
+    readonly outputDigest?: string;
+    readonly bounds?: Readonly<{
+        width: number;
+        height: number;
+    }>;
+    readonly coverage: Readonly<{
+        cells: number;
+        graphemes: number;
+        ownedCells: number;
+        unownedCells: number;
+        textAllocations: number;
+        textClusters: number;
+        identities: number;
+        ports: number;
+        markerContracts: number;
+    }>;
+    readonly budget: Readonly<{
+        operations: number;
+        maxOperations: number;
+        outputCodeUnits: number;
+        maxOutputCodeUnits: number;
+        exhausted: boolean;
+        issuesTruncated: boolean;
+        projectionsTruncated: boolean;
+    }>;
+    readonly issues: readonly TerminalLayoutCertificationIssue[];
+    /** Native representation choices are reported separately from cell-layout correctness. */
+    readonly projections: readonly Readonly<{
+        feature: string;
+        message: string;
+    }>[];
+    readonly limitations: readonly string[];
+}
+
+/** Versioned, deterministic capability negotiation for hosts and receipts. */
+declare const CAPABILITY_NEGOTIATION_VERSION: 1;
+type CapabilityId = `${string}:${string}`;
+type CapabilityRequirementLevel = 'required' | 'preferred' | 'optional';
+interface CapabilityResolution {
+    id: CapabilityId;
+    range: string;
+    level: CapabilityRequirementLevel;
+    status: 'selected' | 'unsupported' | 'incompatible';
+    version?: string;
+}
+interface CapabilityDecision {
+    version: typeof CAPABILITY_NEGOTIATION_VERSION;
+    accepted: boolean;
+    resolutions: readonly CapabilityResolution[];
+}
+
+/** Closed first-party output vocabulary shared by render and negotiation. */
+declare const RENDER_OUTPUTS: readonly ["svg", "png", "ascii", "unicode", "html", "layout"];
+type RenderOutput = typeof RENDER_OUTPUTS[number];
+
+/** Trusted pixel metrics. Executable profiles never enter diagram/config data. */
+interface TextMeasurementProfileIdentity {
+    readonly id: string;
+    readonly version: string;
+}
+
+declare const RENDER_CONTRACT_VERSION: 2;
+
+interface RenderRequestReceipt {
+    /** Actual graph geometry decisions, retained outside caller-owned metadata. */
+    layoutDecisions?: readonly GraphLayoutDecision[];
+    /** Bounded evidence from the actual pixel or terminal-cell projection. */
+    layoutCertification?: PaintLayoutCertification | TerminalLayoutCertification;
+    version: typeof RENDER_CONTRACT_VERSION;
+    output: RenderOutput;
+    sharedRequestDigest: string;
+    requestDigest: string;
+    appearanceDigest: string;
+    capabilityDecision: CapabilityDecision;
+    /** Request-resolution and output-policy decisions. */
+    diagnostics?: readonly RenderArtifactDiagnostic[];
+    /** Digest of the secured graphical projection emitted by this execution. */
+    graphicalProjectionDigest?: string;
+    /** Family/backend selected at execution, including trusted host policy. */
+    executionDecision?: RenderExecutionDecision;
+    /** Pixel metrics used by graphical outputs; contains no executable host inputs. */
+    textMeasurement?: TextMeasurementProfileIdentity;
+}
+interface RenderExecutionDecision {
+    readonly family: {
+        readonly id: string;
+        readonly version: string;
+    };
+    readonly backend: {
+        readonly mode: 'scene';
+        readonly requestedId: string;
+        readonly selectedId: string;
+        readonly version: string;
+        readonly hostPolicy: boolean;
+    } | {
+        readonly mode: 'family-svg';
+    };
+    readonly digest: string;
+    readonly textMeasurement?: TextMeasurementProfileIdentity;
+}
+interface RenderArtifactDiagnostic {
+    readonly code: string;
+    readonly message?: string;
+    readonly reference?: string;
+    readonly feature?: string;
+}
+
+interface RenderedSvg {
+    readonly svg: string;
+    readonly receipt: RenderRequestReceipt;
+}
+
 declare class BrowserFamilyDetectionError extends Error {
     readonly code = "UNSUPPORTED_FAMILY";
     constructor(firstLine: string);
@@ -1008,5 +1275,7 @@ declare class BrowserFamilyDetectionError extends Error {
  * The classic synchronous `agentic-mermaid/browser` entry remains available
  * for script-tag consumers that prefer one all-in-one file. */
 declare function renderMermaidSVGAsync(source: string, options?: RenderOptions): Promise<string>;
+/** Receipt-bearing lazy rendering retains the complete canonical contract. */
+declare function renderMermaidSVGWithReceiptAsync(source: string, options?: RenderOptions): Promise<RenderedSvg>;
 
-export { BrowserFamilyDetectionError, type RenderOptions, renderMermaidSVGAsync };
+export { BrowserFamilyDetectionError, type RenderOptions, renderMermaidSVGAsync, renderMermaidSVGWithReceiptAsync };