Render, verify, describe, and safely edit Mermaid diagrams through MCP.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Author a new Mermaid diagram from blank by folding a list of structured ops over an empty diagram of `family`. The declarative counterpart to hand-writing source. Returns the same envelope as `mutate`: { ok, family, source, verify } or { ok:false, family, opIndex, error }. Call `describe_sdk` for the family before authoring unfamiliar ops.
Non-empty ordered list of ops; each is { kind, ...fields }.
Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph, radar).
Author a new Mermaid diagram from blank by folding a list of structured ops over an empty diagram of `family`. The declarative counterpart to hand-writing source. Returns the same envelope as `mutate`: { ok, family, source, verify } or { ok:false, family, opIndex, error }. Call `describe_sdk` for the family before authoring unfamiliar ops.
| Argument | Type | Description |
|---|---|---|
| ops* | array | Non-empty ordered list of ops; each is { kind, ...fields }. |
| family* | string | Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph, radar). |
{
"type": "object",
"required": [
"family",
"ops"
],
"properties": {
"ops": {
"type": "array",
"items": {
"type": "object"
},
"minItems": 1,
"description": "Non-empty ordered list of ops; each is { kind, ...fields }."
},
"family": {
"type": "string",
"description": "Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph, radar)."
}
},
"additionalProperties": false
}Describe a Mermaid diagram. format=text returns { ok, text } with one or two summary sentences; format=json returns { ok, tree } with the AX tree; format=facts returns { ok, facts } with deterministic semantic fact lines for machine checking (for example edge A -> B : label, member Duck +quack()).
| Argument | Type | Description |
|---|---|---|
| format | string | text (default), json AX tree, or facts semantic read-back. |
| source* | string | Mermaid source. |
{
"type": "object",
"required": [
"source"
],
"properties": {
"format": {
"enum": [
"text",
"json",
"facts"
],
"type": "string",
"description": "text (default), json AX tree, or facts semantic read-back."
},
"source": {
"type": "string",
"description": "Mermaid source."
}
},
"additionalProperties": false
}Return version-matched mutation operations for one diagram family. Use detail=signatures for the compact op menu or detail=fields (default) for exact field types, required flags, enum values, defaults, and constraints. Call this before build, mutate, or execute when the family schema is not already known.
| Argument | Type | Description |
|---|---|---|
| detail | string | signatures for a compact menu; fields for the complete schema (default). |
| family* | string | Diagram family whose mutation operations are needed. |
{
"type": "object",
"required": [
"family"
],
"properties": {
"detail": {
"enum": [
"signatures",
"fields"
],
"type": "string",
"description": "signatures for a compact menu; fields for the complete schema (default)."
},
"family": {
"enum": [
"flowchart",
"state",
"sequence",
"timeline",
"class",
"er",
"journey",
"architecture",
"xychart",
"pie",
"quadrant",
"gantt",
"mindmap",
"gitgraph",
"radar"
],
"type": "string",
"description": "Diagram family whose mutation operations are needed."
}
},
"additionalProperties": false
}Run JavaScript in an isolated sandbox; return a value. One call composes edits. Submit JavaScript; declaration types are guidance. No promises, async/await, dynamic import, or type annotations. Hosted note: execute runs in an on-demand isolate and costs more than the direct render_svg/render_ascii/render_png/verify/describe tools — prefer those for plain render/verify calls. For straightforward structured edits, prefer the declarative mutate/build tools; reserve execute for logic the ops don't express. Hosted mermaid.renderMermaidSVG*, renderMermaidASCII*, and layoutMermaidWithReceipt calls force security:'strict' and embedFontImport:false; caller code cannot weaken that host policy. SDK declaration: type DiagramKind = 'flowchart' | 'state' | 'sequence' | 'timeline' | 'class' | 'er' | 'journey' | 'architecture' | 'xychart' | 'pie' | 'quadrant' | 'gantt' | 'mindmap' | 'gitgraph' | 'radar' type MutationOp = { kind: string; [field: string]: unknown } type Result<T, E = { code: string; message: string }> = { ok: true; value: T } | { ok: false; error: E } interface SourceLocation { readonly line: number; readonly col: number } interface SourceMapSpans { readonly preserved: PreservedSourceSpans; readonly nodes: ReadonlyMap<string, SourceSpan>; readonly edges: ReadonlyMap<string, SourceSpan>; readonly groups: ReadonlyMap<string, SourceSpan>; readonly labels: ReadonlyMap<string, SourceSpan> } interface SourceMap { readonly nodes: ReadonlyMap<string, SourceLocation>; readonly edges: ReadonlyMap<string, SourceLocation>; readonly groups: ReadonlyMap<string, SourceLocation>; readonly labels: ReadonlyMap<string, SourceLocation>; readonly spans?: SourceMapSpans } interface ValidDiagram { readonly kind: DiagramKind; readonly source: SourceMap } type ExternalFamilyId = `family:${string}` interface ExtensionCompatibility { readonly [contract: string]: string | undefined readonly core?: string readonly scene?: string } interface ExtensionProvenance { readonly owner: string; readonly source: string; readonly reference?: string } interface ExtensionIdentity<Kind extends string = string> { readonly id: `${Kind}:${string}` readonly kind: Kind readonly version: string readonly compatibility: ExtensionCompatibility readonly provenance: ExtensionProvenance } interface SourceSpanPoint { readonly offset: number; readonly line: number; readonly col: number } interface SourceSpan { readonly start: SourceSpanPoint; readonly end: SourceSpanPoint } interface PreservedSourceSpans { readonly source: SourceSpan readonly wrapper?: SourceSpan readonly frontmatter?: SourceSpan readonly initDirectives?: readonly SourceSpan[] readonly accessibilityDirectives?: readonly SourceSpan[] readonly header: SourceSpan readonly body: SourceSpan } interface SourcePreservationReceipt { readonly version: 1 readonly classification: 'unsupported' | 'inventory-only' | 'unknown' readonly source: string readonly header: string readonly upstreamFamilyId?: string readonly mermaidVersion: string readonly spans?: PreservedSourceSpans } interface ParseError { readonly code: string readonly message: string readonly line?: number readonly col?: number readonly preservation?: SourcePreservationReceipt readonly help?: string } interface ExtensionValidDiagram { readonly kind: ExternalFamilyId readonly descriptorIdentity: ExtensionIdentity<'family'> readonly source: SourceMap } interface PreservedValidDiagram { readonly kind: ExternalFamilyId readonly source: SourceMap readonly body: { readonly kind: 'preserved' readonly representation: 'opaque' | 'unknown' readonly source: string readonly preservation: SourcePreservationReceipt readonly spans: PreservedSourceSpans readonly diagnostic: { readonly code: 'UNSUPPORTED_FAMILY' | 'UNKNOWN_HEADER' | 'FAMILY_DESCRIPTOR_MISMATCH' readonly message: string readonly help: string } } } type ParsedDiagram = ValidDiagram | ExtensionValidDiagram | PreservedValidDiagram type RenderedRegionKind='node'|'edge'|'label'|'canvas'|'group'|'cluster'|'lane'|'band'|'compartment'|'plot'|'ring' type DiagramActionSecurity='safe'|'unsafe'|'source-only'|'unsupported' interface RenderedRegion { id:string;kind:RenderedRegionKind;elementId?:string;parentId?:string;bounds:{x:number;y:number;w:number;h:number};sourceLine?:number } interface DiagramActionRecord { id?:string;regionId?:string;family:DiagramKind;target:string;action:'href'|'call'|'callback';raw:string;line?:number;href?:string;security:DiagramActionSecurity;executable:false;message?:string } interface RenderedLayout { version: 1; kind: DiagramKind | ExternalFamilyId; bounds: { w: number; h: number }; nodes: unknown[]; edges: unknown[]; groups: unknown[]; regions?: RenderedRegion[]; actions?: DiagramActionRecord[] } interface VerifyResult { ok: boolean; warnings: unknown[]; layout: RenderedLayout } type CheckMermaidSpec = string[] | { include?: string[]; exclude?: string[]; exact?: boolean } interface CheckMermaidResult { ok: boolean; missing: string[]; unexpected: string[]; facts: string[] } type MermaidConfigScalar = string | number | boolean | null type MermaidConfigValue = MermaidConfigScalar | MermaidConfigValue[] | { [key: string]: MermaidConfigValue | undefined } type MermaidRuntimeConfig = { [key: string]: MermaidConfigValue | undefined } interface StyleColors {bg?:string;fg?:string;line?:string;accent?:string;muted?:string;surface?:string;border?:string} type SceneStyleRole="node"|"edge"|"edge-label"|"group"|"group-header"|"label"|"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"|"title"|"defs"|"prelude"|"chrome" type ExactSceneStyleRole="node"|"edge"|"group"|"group-header"|"label"|"actor"|"relationship"|"pie-slice"|"legend"|"bar"|"series"|"point"|"task"|"milestone" type BindableSceneStyleRole="group-header"|"actor"|"relationship"|"pie-slice"|"legend"|"bar"|"series"|"point"|"task"|"milestone" type RoleStyleSpec={"fontFamily"?:string;"fontSize"?:number;"fontWeight"?:number;"letterSpacing"?:number;"textTransform"?:"uppercase"|"lowercase"|"capitalize";"textColor"?:string;"paddingX"?:number;"paddingY"?:number;"cornerRadius"?:number;"lineWidth"?:number;"bendRadius"?:number;"fillColor"?:string;"borderColor"?:string;"strokeColor"?:string;"headerFillColor"?:string;"cue"?:"none"|"outline"|"double-line"|"pattern"} type RoleStyleFor<R extends ExactSceneStyleRole>=R extends "node"|"actor"?Pick<RoleStyleSpec,"borderColor"|"cornerRadius"|"fillColor"|"fontSize"|"fontWeight"|"letterSpacing"|"lineWidth"|"paddingX"|"paddingY"|"textColor"|"textTransform">:R extends "edge"|"relationship"?Pick<RoleStyleSpec,"bendRadius"|"fontSize"|"fontWeight"|"letterSpacing"|"lineWidth"|"strokeColor"|"textColor"|"textTransform">:R extends "group"?Pick<RoleStyleSpec,"borderColor"|"cornerRadius"|"fillColor"|"fontFamily"|"fontSize"|"fontWeight"|"headerFillColor"|"letterSpacing"|"lineWidth"|"paddingX"|"paddingY"|"textColor"|"textTransform">:R extends "group-header"?Pick<RoleStyleSpec,"borderColor"|"cue"|"fillColor"|"fontFamily"|"fontSize"|"fontWeight"|"letterSpacing"|"lineWidth"|"strokeColor"|"textColor"|"textTransform">:R extends "label"?Pick<RoleStyleSpec,"fontSize"|"fontWeight"|"letterSpacing"|"textColor"|"textTransform">:R extends "pie-slice"|"task"|"milestone"?Pick<RoleStyleSpec,"borderColor"|"cue"|"fillColor"|"lineWidth"|"strokeColor">:R extends "legend"?Pick<RoleStyleSpec,"borderColor"|"fillColor"|"lineWidth"|"strokeColor"|"textColor">:R extends "bar"|"point"?Pick<RoleStyleSpec,"borderColor"|"fillColor"|"lineWidth"|"strokeColor">:R extends "series"?Pick<RoleStyleSpec,"borderColor"|"lineWidth"|"strokeColor">:never type RoleStyles={[R in ExactSceneStyleRole]?:Readonly<RoleStyleFor<R>>} type SemanticBindingChannel="category" interface SemanticBinding {channel:SemanticBindingChannel;value:string;slot:string;role?:BindableSceneStyleRole} type BrandConstraint={kind:"contrast";action:'warn'|'error';role?:SceneStyleRole;minimum?:number}|{kind:"accent-area";action:'warn'|'error';maxFraction:number}|{kind:"mono-role";action:'warn'|'error';role:SceneStyleRole} interface StyleSpec {"formatVersion"?:1;"$schema"?:string;"name"?:string;"blurb"?:string;"colors"?:StyleColors;"font"?:string;"roles"?:RoleStyles;"semanticSlots"?:Readonly<Record<string,Readonly<RoleStyleSpec>>>;"bindings"?:readonly SemanticBinding[];"constraints"?:readonly BrandConstraint[];"stroke"?:"crisp"|"jittered"|"freehand";"roughness"?:number;"bowing"?:number;"passes"?:number;"strokeWidth"?:number;"fill"?:"none"|"hachure"|"solid"|"wash";"hachureAngle"?:number;"hachureGap"?:number;"fillWeight"?:number;"washOpacity"?:number;"washEdge"?:number;"backdrop"?:"plain"|"paper-ruled"|"grid";"intent"?:"premium"|"draft"|"lofi";"mono"?:boolean} type StyleInput=string|StyleSpec type ArchitectureVisualOverrides = Readonly<Record<string, unknown>> interface SharedRenderOptions { bg?:string;fg?:string;line?:string;accent?:string;muted?:string;surface?:string;border?:string;font?:string;style?:StyleInput | StyleInput[];padding?:number;nodeSpacing?:number;layerSpacing?:number;wrappingWidth?:number;componentSpacing?:number;transparent?:boolean;interactive?:boolean;shadow?:boolean;class?:{ hierarchicalNamespaces?:boolean };architecture?:{ visual?:ArchitectureVisualOverrides };timeline?:{ maxWidth?:number };journey?:{ experienceCurve?:boolean };gantt?:{ dependencyArrows?:boolean; criticalPath?:boolean };mermaidConfig?:MermaidRuntimeConfig;embedFontImport?:boolean;compact?:boolean;idPrefix?:string;security?:'default' | 'strict';ganttToday?:string;seed?:number;} interface ConfigDiagnostic { code: 'INEFFECTIVE_CONFIG'; field: string; message: string } interface TerminalProjectionDiagnostic { code: string; feature: string; message: string } interface SvgRenderOptions extends SharedRenderOptions { onConfigDiagnostic?:(diagnostic: ConfigDiagnostic) => void;} interface AsciiRenderOptions extends SharedRenderOptions { useAscii?:boolean;paddingX?:number;paddingY?:number;boxBorderPadding?:number;colorMode?:'auto' | 'none' | 'ansi16' | 'ansi256' | 'truecolor' | 'html';theme?:{ fg?:string; border?:string; line?:string; arrow?:string; accent?:string; bg?:string; corner?:string; junction?:string };maxWidth?:number;targetWidth?:number;onConfigDiagnostic?:(diagnostic: ConfigDiagnostic) => void;onProjectionDiagnostic?:(diagnostic: TerminalProjectionDiagnostic) => void;} interface LayoutRenderOptions extends SharedRenderOptions { debug?:boolean;regions?:boolean;actions?:boolean;onConfigDiagnostic?:(diagnostic: ConfigDiagnostic) => void;} interface RenderArtifactDiagnostic { code: string; message?: string; reference?: string; feature?: string; input?: string; canonicalId?: string; removal?: { release: string; date: string } } interface CapabilityResolution { readonly id: `${string}:${string}`; readonly range: string; readonly level: 'required' | 'preferred' | 'optional'; readonly status: 'selected' | 'unsupported' | 'incompatible'; readonly version?: string } interface CapabilityDecision { readonly version: 1; readonly accepted: boolean; readonly resolutions: readonly CapabilityResolution[] } 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;} interface RenderRequestReceipt { version: 2; output: 'svg' | 'png' | 'ascii' | 'unicode' | 'html' | 'layout'; sharedRequestDigest: string; requestDigest: string; appearanceDigest: string; capabilityDecision: CapabilityDecision; diagnostics?: readonly RenderArtifactDiagnostic[]; graphicalProjectionDigest?: string; executionDecision?: RenderExecutionDecision } interface RenderedSvg { svg: string; receipt: RenderRequestReceipt } interface RenderedAscii { text: string; receipt: RenderRequestReceipt; terminalStyle: Record<string, unknown>; outputPolicy: Record<string, unknown> } interface RenderedLayoutArtifact { layout: VerifyResult['layout']; receipt: RenderRequestReceipt } declare const mermaid: { parseRegisteredMermaid(source: string): Result<ParsedDiagram, ParseError[]> createMermaid(kind: DiagramKind, opts?: { direction?: 'TD' | 'TB' | 'LR' | 'BT' | 'RL' }): ValidDiagram buildMermaid(kind: DiagramKind, ops: MutationOp[], opts?: { direction?: 'TD' | 'TB' | 'LR' | 'BT' | 'RL' }): Result<ValidDiagram, { code: string; message: string; opIndex: number }> asFlowchart(diagram: ValidDiagram): ValidDiagram | null asState(diagram: ValidDiagram): ValidDiagram | null asSequence(diagram: ValidDiagram): ValidDiagram | null asTimeline(diagram: ValidDiagram): ValidDiagram | null asClass(diagram: ValidDiagram): ValidDiagram | null asEr(diagram: ValidDiagram): ValidDiagram | null asJourney(diagram: ValidDiagram): ValidDiagram | null asArchitecture(diagram: ValidDiagram): ValidDiagram | null asXyChart(diagram: ValidDiagram): ValidDiagram | null asPie(diagram: ValidDiagram): ValidDiagram | null asQuadrant(diagram: ValidDiagram): ValidDiagram | null asGantt(diagram: ValidDiagram): ValidDiagram | null asMindmap(diagram: ValidDiagram): ValidDiagram | null asGitGraph(diagram: ValidDiagram): ValidDiagram | null asRadar(diagram: ValidDiagram): ValidDiagram | null mutate(diagram: ValidDiagram, op: MutationOp): Result<ValidDiagram> verifyMermaid(input: ParsedDiagram | string, opts?: { suppress?: string[]; labelCharCap?: number; renderOptions?: SharedRenderOptions }): VerifyResult analyzeMermaid(diagram: ValidDiagram): Record<string, unknown> analyzeMermaidSource(source: string): Result<Record<string, unknown>> describeMermaidFacts(diagram: ValidDiagram): string[] describeMermaidFactsSource(source: string): Result<string[]> checkMermaid(diagram: ValidDiagram, spec: CheckMermaidSpec): CheckMermaidResult checkMermaidSource(source: string, spec: CheckMermaidSpec): Result<CheckMermaidResult> serializeMermaid(diagram: ParsedDiagram): string renderMermaidSVG(input: ParsedDiagram | string, opts?: SvgRenderOptions): string renderMermaidSVGWithReceipt(input: ParsedDiagram | string, opts?: SvgRenderOptions): RenderedSvg renderMermaidASCII(input: ParsedDiagram | string, opts?: AsciiRenderOptions): string renderMermaidASCIIWithReceipt(input: ParsedDiagram | string, opts?: AsciiRenderOptions): RenderedAscii layoutMermaidWithReceipt(input: ParsedDiagram | string, opts?: LayoutRenderOptions): RenderedLayoutArtifact describeOps(family: DiagramKind): Record<string, { name: string; required: boolean; type: string; note?: string }[]> opSignatures(family: DiagramKind): string[] }
Apply a list of structured edit ops to an existing Mermaid `source` and return the edited diagram. This is the declarative counterpart to `execute`: plain JSON in, plain JSON out, no sandbox. Prefer it for straightforward edits; reserve `execute` for logic the ops don't express. Returns { ok, family, source, verify:{ ok, warnings } } on success, or { ok:false, family, opIndex, error } — where `error` names the offending field and lists the valid ones — when an op is malformed or cannot apply. Ops apply in order and are all-or-nothing: the first failing op stops the batch (its position is `opIndex`) and the input is left untouched. Each op is { "kind": <op>, …fields }. Call `describe_sdk` for the detected family before authoring unfamiliar ops; it returns compact signatures or exact field types, enum values, defaults, and constraints.
| Argument | Type | Description |
|---|---|---|
| ops* | array | Non-empty ordered list of edit ops; each is { kind, ...fields }. |
| source* | string | Mermaid source to edit. |
{
"type": "object",
"required": [
"source",
"ops"
],
"properties": {
"ops": {
"type": "array",
"items": {
"type": "object"
},
"minItems": 1,
"description": "Non-empty ordered list of edit ops; each is { kind, ...fields }."
},
"source": {
"type": "string",
"description": "Mermaid source to edit."
}
},
"additionalProperties": false
}Render a Mermaid source string to text. Returns { ok, text }. useAscii true → plain ASCII (+,-,|); false/absent → Unicode box drawing (┌,─,│). targetWidth sets a hard terminal display-cell bound; impossible bounds return a typed error.
| Argument | Type | Description |
|---|---|---|
| source* | string | Mermaid source. |
| options | object | Shared advanced RenderOptions object, including style/palette/config/security. |
| useAscii | boolean | true = ASCII characters, false = Unicode (default). |
| targetWidth | integer | Hard maximum line width in terminal display cells. |
{
"type": "object",
"required": [
"source"
],
"properties": {
"source": {
"type": "string",
"description": "Mermaid source."
},
"options": {
"$id": "https://agentic-mermaid.dev/schemas/render-options.schema.json",
"type": "object",
"$defs": {
"jsonValue": {
"anyOf": [
{
"type": "null"
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/jsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/jsonValue"
}
}
],
"description": "A finite, acyclic JSON value without prototype keys.",
"x-agentic-mermaid-validation-expectation": "a finite, acyclic JSON value without prototype keys"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"bg": {
"type": "string",
"default": "#FFFFFF",
"description": "Background color or CSS variable.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"fg": {
"type": "string",
"default": "#27272A",
"description": "Primary foreground and text color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"font": {
"type": "string",
"default": "Inter",
"description": "CSS font family or stack.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "the host terminal owns the font face",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"line": {
"type": "string",
"description": "Connector and secondary-line color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"seed": {
"type": "number",
"default": 0,
"description": "Deterministic re-roll seed for stochastic Styles.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink"
},
"class": {
"type": "object",
"properties": {
"hierarchicalNamespaces": {
"type": "boolean",
"default": true,
"description": "Nest namespace compounds."
}
},
"description": "Class-diagram rendering controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "this option configures graphical class layout",
"x-agentic-mermaid-applicable-builtin-families": [
"class"
]
},
"gantt": {
"type": "object",
"properties": {
"criticalPath": {
"type": "boolean",
"default": false,
"description": "Emphasize critical-path tasks and connectors."
},
"dependencyArrows": {
"type": "boolean",
"default": false,
"description": "Draw scheduled dependency connectors."
}
},
"description": "Gantt dependency and critical-path overlays.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "graphical Gantt connector emphasis is not represented in cells",
"x-agentic-mermaid-applicable-builtin-families": [
"gantt"
]
},
"muted": {
"type": "string",
"description": "Secondary text and label color.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal themes have no dedicated muted-text role",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"style": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"description": "Registered Style or Palette name."
},
{
"type": "object",
"properties": {
"fill": {
"enum": [
"none",
"hachure",
"solid",
"wash"
],
"type": "string",
"description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends."
},
"font": {
"type": "string",
"description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"mono": {
"type": "boolean",
"description": "Advisory monochrome contract: express tone through shading and weight."
},
"name": {
"type": "string",
"description": "Canonical look:name or palette:name identity; required only when registering a style."
},
"blurb": {
"type": "string",
"description": "Short human-readable description used by discovery surfaces."
},
"roles": {
"type": "object",
"properties": {
"bar": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"edge": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
},
"node": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"task": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"actor": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"group": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 13,
"additionalProperties": false
},
"label": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 5,
"additionalProperties": false
},
"point": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"legend": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"series": {
"type": "object",
"properties": {
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 3,
"additionalProperties": false
},
"milestone": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"pie-slice": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"group-header": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"relationship": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
}
},
"description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.",
"additionalProperties": false
},
"bowing": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js line bowing."
},
"colors": {
"type": "object",
"properties": {
"bg": {
"type": "string",
"description": "Diagram page background. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"fg": {
"type": "string",
"description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"line": {
"type": "string",
"description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"muted": {
"type": "string",
"description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"accent": {
"type": "string",
"description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"border": {
"type": "string",
"description": "Node and group border paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"surface": {
"type": "string",
"description": "Node and group surface fill. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
}
},
"description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.",
"maxProperties": 7,
"additionalProperties": false
},
"intent": {
"enum": [
"premium",
"draft",
"lofi"
],
"type": "string",
"description": "Advisory intent metadata for pickers and quality tooling."
},
"passes": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke."
},
"stroke": {
"enum": [
"crisp",
"jittered",
"freehand"
],
"type": "string",
"description": "Stroke treatment; crisp is the default renderer."
},
"$schema": {
"type": "string",
"description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering."
},
"backdrop": {
"enum": [
"plain",
"paper-ruled",
"grid"
],
"type": "string",
"description": "Flat page furniture drawn behind the diagram."
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"channel",
"value",
"slot"
],
"properties": {
"role": {
"enum": [
"group-header",
"actor",
"relationship",
"pie-slice",
"legend",
"bar",
"series",
"point",
"task",
"milestone"
],
"type": "string"
},
"slot": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"value": {
"type": "string",
"pattern": "^[^\\r\\n\\u0000]+$",
"maxLength": 256,
"minLength": 1
},
"channel": {
"enum": [
"category"
],
"type": "string"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"maxItems": 4096,
"description": "Ordered equality bindings from authored/domain meaning to semantic slots."
},
"washEdge": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor edge-darkening opacity; requires fill wash in the final stack."
},
"roughness": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js stroke irregularity."
},
"fillWeight": {
"type": "number",
"maximum": 20,
"description": "Hachure line weight; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"hachureGap": {
"type": "number",
"maximum": 100,
"description": "Gap between hachure lines; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"constraints": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"action"
],
"properties": {
"kind": {
"const": "contrast"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"minimum": {
"type": "number",
"maximum": 21,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"maxFraction"
],
"properties": {
"kind": {
"const": "accent-area"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"maxFraction": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"role"
],
"properties": {
"kind": {
"const": "mono-role"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 4096,
"description": "Closed inspect-only brand constraints with warn or error actions."
},
"strokeWidth": {
"type": "number",
"maximum": 20,
"description": "Base stroke width in SVG user units.",
"exclusiveMinimum": 0
},
"washOpacity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor glaze opacity; requires fill wash in the final stack."
},
"hachureAngle": {
"type": "number",
"maximum": 360,
"minimum": -360,
"description": "Hachure line angle in degrees; requires fill hachure in the final stack."
},
"formatVersion": {
"const": 1,
"description": "Persisted wire-format version. Optional on input and normalized to 1 on output."
},
"semanticSlots": {
"type": "object",
"description": "Named brand-neutral role-style slots selected by semantic bindings.",
"maxProperties": 4096,
"propertyNames": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"additionalProperties": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 16,
"additionalProperties": false
}
}
},
"description": "A partial declarative style record for Agentic Mermaid rendering. All fields, including formatVersion, are optional on input; resolved and registered specs normalize formatVersion to 1.",
"maxProperties": 24,
"additionalProperties": false
}
],
"x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"description": "Registered Style or Palette name."
},
{
"type": "object",
"properties": {
"fill": {
"enum": [
"none",
"hachure",
"solid",
"wash"
],
"type": "string",
"description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends."
},
"font": {
"type": "string",
"description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"mono": {
"type": "boolean",
"description": "Advisory monochrome contract: express tone through shading and weight."
},
"name": {
"type": "string",
"description": "Canonical look:name or palette:name identity; required only when registering a style."
},
"blurb": {
"type": "string",
"description": "Short human-readable description used by discovery surfaces."
},
"roles": {
"type": "object",
"properties": {
"bar": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"edge": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
},
"node": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"task": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"actor": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"group": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 13,
"additionalProperties": false
},
"label": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 5,
"additionalProperties": false
},
"point": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"legend": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"series": {
"type": "object",
"properties": {
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 3,
"additionalProperties": false
},
"milestone": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"pie-slice": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"group-header": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"relationship": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
}
},
"description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.",
"additionalProperties": false
},
"bowing": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js line bowing."
},
"colors": {
"type": "object",
"properties": {
"bg": {
"type": "string",
"description": "Diagram page background. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"fg": {
"type": "string",
"description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"line": {
"type": "string",
"description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"muted": {
"type": "string",
"description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"accent": {
"type": "string",
"description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"border": {
"type": "string",
"description": "Node and group border paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"surface": {
"type": "string",
"description": "Node and group surface fill. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
}
},
"description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.",
"maxProperties": 7,
"additionalProperties": false
},
"intent": {
"enum": [
"premium",
"draft",
"lofi"
],
"type": "string",
"description": "Advisory intent metadata for pickers and quality tooling."
},
"passes": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke."
},
"stroke": {
"enum": [
"crisp",
"jittered",
"freehand"
],
"type": "string",
"description": "Stroke treatment; crisp is the default renderer."
},
"$schema": {
"type": "string",
"description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering."
},
"backdrop": {
"enum": [
"plain",
"paper-ruled",
"grid"
],
"type": "string",
"description": "Flat page furniture drawn behind the diagram."
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"channel",
"value",
"slot"
],
"properties": {
"role": {
"enum": [
"group-header",
"actor",
"relationship",
"pie-slice",
"legend",
"bar",
"series",
"point",
"task",
"milestone"
],
"type": "string"
},
"slot": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"value": {
"type": "string",
"pattern": "^[^\\r\\n\\u0000]+$",
"maxLength": 256,
"minLength": 1
},
"channel": {
"enum": [
"category"
],
"type": "string"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"maxItems": 4096,
"description": "Ordered equality bindings from authored/domain meaning to semantic slots."
},
"washEdge": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor edge-darkening opacity; requires fill wash in the final stack."
},
"roughness": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js stroke irregularity."
},
"fillWeight": {
"type": "number",
"maximum": 20,
"description": "Hachure line weight; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"hachureGap": {
"type": "number",
"maximum": 100,
"description": "Gap between hachure lines; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"constraints": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"action"
],
"properties": {
"kind": {
"const": "contrast"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"minimum": {
"type": "number",
"maximum": 21,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"maxFraction"
],
"properties": {
"kind": {
"const": "accent-area"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"maxFraction": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"role"
],
"properties": {
"kind": {
"const": "mono-role"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 4096,
"description": "Closed inspect-only brand constraints with warn or error actions."
},
"strokeWidth": {
"type": "number",
"maximum": 20,
"description": "Base stroke width in SVG user units.",
"exclusiveMinimum": 0
},
"washOpacity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor glaze opacity; requires fill wash in the final stack."
},
"hachureAngle": {
"type": "number",
"maximum": 360,
"minimum": -360,
"description": "Hachure line angle in degrees; requires fill hachure in the final stack."
},
"formatVersion": {
"const": 1,
"description": "Persisted wire-format version. Optional on input and normalized to 1 on output."
},
"semanticSlots": {
"type": "object",
"description": "Named brand-neutral role-style slots selected by semantic bindings.",
"maxProperties": 4096,
"propertyNames": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"additionalProperties": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 16,
"additionalProperties": false
}
}
},
"description": "A partial declarative style record for Agentic Mermaid rendering. All fields, including formatVersion, are optional on input; resolved and registered specs normalize formatVersion to 1.",
"maxProperties": 24,
"additionalProperties": false
}
],
"x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec"
},
"description": "Style stack merged from left to right."
}
],
"description": "A registered name, inline StyleSpec, or left-to-right stack of either.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "styleInput"
},
"accent": {
"type": "string",
"description": "Arrowhead, highlight, and data accent color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"border": {
"type": "string",
"description": "Node and group border color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"shadow": {
"type": "boolean",
"default": false,
"description": "Paint explicit drop shadows on node shapes.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "elevation projects to borders and labels",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"sequence",
"timeline",
"class",
"er",
"journey",
"xychart",
"pie",
"quadrant",
"gantt",
"mindmap",
"gitgraph"
]
},
"compact": {
"type": "boolean",
"default": false,
"description": "Compact SVG serialization while preserving agent hooks.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "compact controls SVG serialization"
},
"journey": {
"type": "object",
"properties": {
"experienceCurve": {
"type": "boolean",
"default": true,
"description": "Connect journey score markers with an experience curve."
}
},
"description": "User-journey graphical controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "experience curves are graphical-only",
"x-agentic-mermaid-applicable-builtin-families": [
"journey"
]
},
"padding": {
"type": "number",
"default": 40,
"minimum": 0,
"description": "Canvas padding in SVG user units.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses paddingX, paddingY, and boxBorderPadding",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"architecture"
]
},
"surface": {
"type": "string",
"description": "Node and group surface color.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal cells do not paint graphical surfaces",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"idPrefix": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"description": "Non-empty namespace for generated SVG definition IDs and local references.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output has no SVG definition ids"
},
"security": {
"enum": [
"default",
"strict"
],
"type": "string",
"default": "default",
"description": "Active SVG content is rejected in every mode; strict additionally rejects every external reference. Raw Mermaid themeCSS is rejected in both modes.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal text has its own control-character and HTML-color safety projection"
},
"timeline": {
"type": "object",
"properties": {
"maxWidth": {
"type": "number",
"description": "Best-effort width budget for horizontal timelines.",
"exclusiveMinimum": 0
}
},
"description": "Timeline layout controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth",
"x-agentic-mermaid-applicable-builtin-families": [
"timeline"
]
},
"ganttToday": {
"type": "string",
"description": "Explicit deterministic date for the Gantt today marker.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-applicable-builtin-families": [
"gantt"
]
},
"interactive": {
"type": "boolean",
"default": false,
"description": "Enable hover tooltips for supported chart data points.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal output is a static semantic projection",
"x-agentic-mermaid-applicable-builtin-families": [
"xychart",
"pie",
"quadrant"
]
},
"nodeSpacing": {
"type": "number",
"default": 24,
"minimum": 0,
"description": "Horizontal spacing between sibling nodes.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"class",
"er",
"architecture"
]
},
"transparent": {
"type": "boolean",
"default": false,
"description": "Omit the painted SVG canvas background.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal output has no painted canvas background"
},
"architecture": {
"type": "object",
"properties": {
"visual": {
"type": "object",
"properties": {
"edgeText": {
"type": "string",
"description": "Architecture connector-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"iconSize": {
"type": "number",
"description": "Architecture group icon size.",
"exclusiveMinimum": 0
},
"groupFont": {
"type": "string",
"description": "Architecture group-label font family.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"groupText": {
"type": "string",
"description": "Architecture group-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeStroke": {
"type": "string",
"description": "Architecture connector color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupBorder": {
"type": "string",
"description": "Architecture group border color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"serviceText": {
"type": "string",
"description": "Architecture service-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeFontSize": {
"type": "number",
"description": "Architecture connector-label font size.",
"exclusiveMinimum": 0
},
"groupSurface": {
"type": "string",
"description": "Architecture group surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture connector width."
},
"groupFontSize": {
"type": "number",
"description": "Architecture group-label font size.",
"exclusiveMinimum": 0
},
"groupPaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding inside architecture groups."
},
"groupPaddingY": {
"type": "number",
"minimum": 0,
"description": "Vertical padding inside architecture groups."
},
"serviceBorder": {
"type": "string",
"description": "Architecture service border color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeBendRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture connector bend radius."
},
"edgeFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture connector-label font weight."
},
"groupLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture group border width."
},
"serviceSurface": {
"type": "string",
"description": "Architecture service surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture group-label font weight."
},
"serviceFontSize": {
"type": "number",
"description": "Architecture service-label font size.",
"exclusiveMinimum": 0
},
"serviceIconSize": {
"type": "number",
"description": "Architecture service icon size.",
"exclusiveMinimum": 0
},
"servicePaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding inside architecture services."
},
"servicePaddingY": {
"type": "number",
"minimum": 0,
"description": "Vertical padding inside architecture services."
},
"serviceLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture service border width."
},
"edgeLetterSpacing": {
"type": "number",
"description": "Architecture connector-label letter spacing."
},
"edgeTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture connector-label text transform."
},
"groupCornerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture group corner radius."
},
"groupHeaderHeight": {
"type": "number",
"description": "Architecture group-header height.",
"exclusiveMinimum": 0
},
"serviceFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture service-label font weight."
},
"groupHeaderSurface": {
"type": "string",
"description": "Architecture group-header surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupLabelPaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding around architecture group labels."
},
"groupLetterSpacing": {
"type": "number",
"description": "Architecture group-label letter spacing."
},
"groupTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture group-label text transform."
},
"junctionInnerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture junction inner radius."
},
"junctionOuterRadius": {
"type": "number",
"description": "Architecture junction outer radius.",
"exclusiveMinimum": 0
},
"serviceCornerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture service corner radius."
},
"serviceLetterSpacing": {
"type": "number",
"description": "Architecture service-label letter spacing."
},
"serviceTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture service-label text transform."
}
},
"description": "Sparse architecture visual overrides merged over resolved defaults.",
"additionalProperties": false,
"x-agentic-mermaid-runtime-validator": "architectureVisual"
}
},
"description": "Architecture renderer visual metric and paint overrides.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "this option configures graphical architecture rendering",
"x-agentic-mermaid-applicable-builtin-families": [
"architecture"
]
},
"layerSpacing": {
"type": "number",
"default": 40,
"minimum": 0,
"description": "Vertical spacing between graph layers.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"class",
"er",
"architecture"
]
},
"mermaidConfig": {
"type": "object",
"description": "Mermaid-style recursive runtime configuration.",
"additionalProperties": {
"$ref": "#/$defs/jsonValue"
},
"x-agentic-mermaid-terminal": "consumed"
},
"wrappingWidth": {
"type": "number",
"description": "Flowchart measured-label wrapping budget in pixels.",
"exclusiveMinimum": 0,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart"
]
},
"embedFontImport": {
"type": "boolean",
"default": false,
"description": "Embed the Google Fonts import in SVG styles; PNG forces this off for offline rasterization.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output embeds no web-font import"
},
"componentSpacing": {
"type": "number",
"minimum": 0,
"description": "Spacing between disconnected graph components for compatible extension families; no built-in family currently consumes it.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": []
}
},
"description": "Shared advanced RenderOptions object, including style/palette/config/security.",
"additionalProperties": false
},
"useAscii": {
"type": "boolean",
"description": "true = ASCII characters, false = Unicode (default)."
},
"targetWidth": {
"type": "integer",
"minimum": 1,
"description": "Hard maximum line width in terminal display cells."
}
},
"additionalProperties": false
}Rasterize a Mermaid source string to PNG. Returns { ok, png_base64 }. Hosted rendering uses resvg-wasm with bundled fonts; bytes may differ from the local napi renderer, so hosted PNG is a convenience surface, not part of the byte-determinism contract. For file/URL artifacts use the local stdio server.
| Argument | Type | Description |
|---|---|---|
| fitTo | object | Exactly one output width or height constraint. |
| scale | number | Positive output scale used when no fitTo constraint is supplied. |
| source* | string | Mermaid source. |
| options | object | Shared advanced RenderOptions object. |
| background | string | Portable basic color or hex color painted behind the raster artifact. |
{
"type": "object",
"required": [
"source"
],
"properties": {
"fitTo": {
"type": "object",
"oneOf": [
{
"required": [
"width"
]
},
{
"required": [
"height"
]
}
],
"properties": {
"width": {
"type": "integer",
"minimum": 1,
"description": "Exact output width in integer pixels."
},
"height": {
"type": "integer",
"minimum": 1,
"description": "Exact output height in integer pixels."
}
},
"description": "Exactly one output width or height constraint.",
"additionalProperties": false,
"x-agentic-mermaid-scope": "portable",
"x-agentic-mermaid-receipt": "included"
},
"scale": {
"type": "number",
"default": 2,
"description": "Positive output scale used when no fitTo constraint is supplied.",
"exclusiveMinimum": 0,
"x-agentic-mermaid-scope": "portable",
"x-agentic-mermaid-receipt": "included"
},
"source": {
"type": "string",
"description": "Mermaid source."
},
"options": {
"$id": "https://agentic-mermaid.dev/schemas/render-options.schema.json",
"type": "object",
"$defs": {
"jsonValue": {
"anyOf": [
{
"type": "null"
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/jsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/jsonValue"
}
}
],
"description": "A finite, acyclic JSON value without prototype keys.",
"x-agentic-mermaid-validation-expectation": "a finite, acyclic JSON value without prototype keys"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"bg": {
"type": "string",
"default": "#FFFFFF",
"description": "Background color or CSS variable.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"fg": {
"type": "string",
"default": "#27272A",
"description": "Primary foreground and text color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"font": {
"type": "string",
"default": "Inter",
"description": "CSS font family or stack.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "the host terminal owns the font face",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"line": {
"type": "string",
"description": "Connector and secondary-line color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"seed": {
"type": "number",
"default": 0,
"description": "Deterministic re-roll seed for stochastic Styles.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink"
},
"class": {
"type": "object",
"properties": {
"hierarchicalNamespaces": {
"type": "boolean",
"default": true,
"description": "Nest namespace compounds."
}
},
"description": "Class-diagram rendering controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "this option configures graphical class layout",
"x-agentic-mermaid-applicable-builtin-families": [
"class"
]
},
"gantt": {
"type": "object",
"properties": {
"criticalPath": {
"type": "boolean",
"default": false,
"description": "Emphasize critical-path tasks and connectors."
},
"dependencyArrows": {
"type": "boolean",
"default": false,
"description": "Draw scheduled dependency connectors."
}
},
"description": "Gantt dependency and critical-path overlays.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "graphical Gantt connector emphasis is not represented in cells",
"x-agentic-mermaid-applicable-builtin-families": [
"gantt"
]
},
"muted": {
"type": "string",
"description": "Secondary text and label color.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal themes have no dedicated muted-text role",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"style": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"description": "Registered Style or Palette name."
},
{
"type": "object",
"properties": {
"fill": {
"enum": [
"none",
"hachure",
"solid",
"wash"
],
"type": "string",
"description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends."
},
"font": {
"type": "string",
"description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"mono": {
"type": "boolean",
"description": "Advisory monochrome contract: express tone through shading and weight."
},
"name": {
"type": "string",
"description": "Canonical look:name or palette:name identity; required only when registering a style."
},
"blurb": {
"type": "string",
"description": "Short human-readable description used by discovery surfaces."
},
"roles": {
"type": "object",
"properties": {
"bar": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"edge": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
},
"node": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"task": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"actor": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"group": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 13,
"additionalProperties": false
},
"label": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 5,
"additionalProperties": false
},
"point": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"legend": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"series": {
"type": "object",
"properties": {
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 3,
"additionalProperties": false
},
"milestone": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"pie-slice": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"group-header": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"relationship": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
}
},
"description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.",
"additionalProperties": false
},
"bowing": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js line bowing."
},
"colors": {
"type": "object",
"properties": {
"bg": {
"type": "string",
"description": "Diagram page background. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"fg": {
"type": "string",
"description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"line": {
"type": "string",
"description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"muted": {
"type": "string",
"description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"accent": {
"type": "string",
"description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"border": {
"type": "string",
"description": "Node and group border paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"surface": {
"type": "string",
"description": "Node and group surface fill. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
}
},
"description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.",
"maxProperties": 7,
"additionalProperties": false
},
"intent": {
"enum": [
"premium",
"draft",
"lofi"
],
"type": "string",
"description": "Advisory intent metadata for pickers and quality tooling."
},
"passes": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke."
},
"stroke": {
"enum": [
"crisp",
"jittered",
"freehand"
],
"type": "string",
"description": "Stroke treatment; crisp is the default renderer."
},
"$schema": {
"type": "string",
"description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering."
},
"backdrop": {
"enum": [
"plain",
"paper-ruled",
"grid"
],
"type": "string",
"description": "Flat page furniture drawn behind the diagram."
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"channel",
"value",
"slot"
],
"properties": {
"role": {
"enum": [
"group-header",
"actor",
"relationship",
"pie-slice",
"legend",
"bar",
"series",
"point",
"task",
"milestone"
],
"type": "string"
},
"slot": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"value": {
"type": "string",
"pattern": "^[^\\r\\n\\u0000]+$",
"maxLength": 256,
"minLength": 1
},
"channel": {
"enum": [
"category"
],
"type": "string"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"maxItems": 4096,
"description": "Ordered equality bindings from authored/domain meaning to semantic slots."
},
"washEdge": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor edge-darkening opacity; requires fill wash in the final stack."
},
"roughness": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js stroke irregularity."
},
"fillWeight": {
"type": "number",
"maximum": 20,
"description": "Hachure line weight; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"hachureGap": {
"type": "number",
"maximum": 100,
"description": "Gap between hachure lines; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"constraints": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"action"
],
"properties": {
"kind": {
"const": "contrast"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"minimum": {
"type": "number",
"maximum": 21,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"maxFraction"
],
"properties": {
"kind": {
"const": "accent-area"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"maxFraction": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"role"
],
"properties": {
"kind": {
"const": "mono-role"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 4096,
"description": "Closed inspect-only brand constraints with warn or error actions."
},
"strokeWidth": {
"type": "number",
"maximum": 20,
"description": "Base stroke width in SVG user units.",
"exclusiveMinimum": 0
},
"washOpacity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor glaze opacity; requires fill wash in the final stack."
},
"hachureAngle": {
"type": "number",
"maximum": 360,
"minimum": -360,
"description": "Hachure line angle in degrees; requires fill hachure in the final stack."
},
"formatVersion": {
"const": 1,
"description": "Persisted wire-format version. Optional on input and normalized to 1 on output."
},
"semanticSlots": {
"type": "object",
"description": "Named brand-neutral role-style slots selected by semantic bindings.",
"maxProperties": 4096,
"propertyNames": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"additionalProperties": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 16,
"additionalProperties": false
}
}
},
"description": "A partial declarative style record for Agentic Mermaid rendering. All fields, including formatVersion, are optional on input; resolved and registered specs normalize formatVersion to 1.",
"maxProperties": 24,
"additionalProperties": false
}
],
"x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"description": "Registered Style or Palette name."
},
{
"type": "object",
"properties": {
"fill": {
"enum": [
"none",
"hachure",
"solid",
"wash"
],
"type": "string",
"description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends."
},
"font": {
"type": "string",
"description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"mono": {
"type": "boolean",
"description": "Advisory monochrome contract: express tone through shading and weight."
},
"name": {
"type": "string",
"description": "Canonical look:name or palette:name identity; required only when registering a style."
},
"blurb": {
"type": "string",
"description": "Short human-readable description used by discovery surfaces."
},
"roles": {
"type": "object",
"properties": {
"bar": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"edge": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
},
"node": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"task": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"actor": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"group": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 13,
"additionalProperties": false
},
"label": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 5,
"additionalProperties": false
},
"point": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"legend": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"series": {
"type": "object",
"properties": {
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 3,
"additionalProperties": false
},
"milestone": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"pie-slice": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"group-header": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"relationship": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
}
},
"description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.",
"additionalProperties": false
},
"bowing": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js line bowing."
},
"colors": {
"type": "object",
"properties": {
"bg": {
"type": "string",
"description": "Diagram page background. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"fg": {
"type": "string",
"description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"line": {
"type": "string",
"description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"muted": {
"type": "string",
"description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"accent": {
"type": "string",
"description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"border": {
"type": "string",
"description": "Node and group border paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"surface": {
"type": "string",
"description": "Node and group surface fill. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
}
},
"description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.",
"maxProperties": 7,
"additionalProperties": false
},
"intent": {
"enum": [
"premium",
"draft",
"lofi"
],
"type": "string",
"description": "Advisory intent metadata for pickers and quality tooling."
},
"passes": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke."
},
"stroke": {
"enum": [
"crisp",
"jittered",
"freehand"
],
"type": "string",
"description": "Stroke treatment; crisp is the default renderer."
},
"$schema": {
"type": "string",
"description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering."
},
"backdrop": {
"enum": [
"plain",
"paper-ruled",
"grid"
],
"type": "string",
"description": "Flat page furniture drawn behind the diagram."
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"channel",
"value",
"slot"
],
"properties": {
"role": {
"enum": [
"group-header",
"actor",
"relationship",
"pie-slice",
"legend",
"bar",
"series",
"point",
"task",
"milestone"
],
"type": "string"
},
"slot": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"value": {
"type": "string",
"pattern": "^[^\\r\\n\\u0000]+$",
"maxLength": 256,
"minLength": 1
},
"channel": {
"enum": [
"category"
],
"type": "string"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"maxItems": 4096,
"description": "Ordered equality bindings from authored/domain meaning to semantic slots."
},
"washEdge": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor edge-darkening opacity; requires fill wash in the final stack."
},
"roughness": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js stroke irregularity."
},
"fillWeight": {
"type": "number",
"maximum": 20,
"description": "Hachure line weight; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"hachureGap": {
"type": "number",
"maximum": 100,
"description": "Gap between hachure lines; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"constraints": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"action"
],
"properties": {
"kind": {
"const": "contrast"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"minimum": {
"type": "number",
"maximum": 21,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"maxFraction"
],
"properties": {
"kind": {
"const": "accent-area"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"maxFraction": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"role"
],
"properties": {
"kind": {
"const": "mono-role"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 4096,
"description": "Closed inspect-only brand constraints with warn or error actions."
},
"strokeWidth": {
"type": "number",
"maximum": 20,
"description": "Base stroke width in SVG user units.",
"exclusiveMinimum": 0
},
"washOpacity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor glaze opacity; requires fill wash in the final stack."
},
"hachureAngle": {
"type": "number",
"maximum": 360,
"minimum": -360,
"description": "Hachure line angle in degrees; requires fill hachure in the final stack."
},
"formatVersion": {
"const": 1,
"description": "Persisted wire-format version. Optional on input and normalized to 1 on output."
},
"semanticSlots": {
"type": "object",
"description": "Named brand-neutral role-style slots selected by semantic bindings.",
"maxProperties": 4096,
"propertyNames": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"additionalProperties": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 16,
"additionalProperties": false
}
}
},
"description": "A partial declarative style record for Agentic Mermaid rendering. All fields, including formatVersion, are optional on input; resolved and registered specs normalize formatVersion to 1.",
"maxProperties": 24,
"additionalProperties": false
}
],
"x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec"
},
"description": "Style stack merged from left to right."
}
],
"description": "A registered name, inline StyleSpec, or left-to-right stack of either.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "styleInput"
},
"accent": {
"type": "string",
"description": "Arrowhead, highlight, and data accent color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"border": {
"type": "string",
"description": "Node and group border color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"shadow": {
"type": "boolean",
"default": false,
"description": "Paint explicit drop shadows on node shapes.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "elevation projects to borders and labels",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"sequence",
"timeline",
"class",
"er",
"journey",
"xychart",
"pie",
"quadrant",
"gantt",
"mindmap",
"gitgraph"
]
},
"compact": {
"type": "boolean",
"default": false,
"description": "Compact SVG serialization while preserving agent hooks.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "compact controls SVG serialization"
},
"journey": {
"type": "object",
"properties": {
"experienceCurve": {
"type": "boolean",
"default": true,
"description": "Connect journey score markers with an experience curve."
}
},
"description": "User-journey graphical controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "experience curves are graphical-only",
"x-agentic-mermaid-applicable-builtin-families": [
"journey"
]
},
"padding": {
"type": "number",
"default": 40,
"minimum": 0,
"description": "Canvas padding in SVG user units.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses paddingX, paddingY, and boxBorderPadding",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"architecture"
]
},
"surface": {
"type": "string",
"description": "Node and group surface color.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal cells do not paint graphical surfaces",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"idPrefix": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"description": "Non-empty namespace for generated SVG definition IDs and local references.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output has no SVG definition ids"
},
"security": {
"enum": [
"default",
"strict"
],
"type": "string",
"default": "default",
"description": "Active SVG content is rejected in every mode; strict additionally rejects every external reference. Raw Mermaid themeCSS is rejected in both modes.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal text has its own control-character and HTML-color safety projection"
},
"timeline": {
"type": "object",
"properties": {
"maxWidth": {
"type": "number",
"description": "Best-effort width budget for horizontal timelines.",
"exclusiveMinimum": 0
}
},
"description": "Timeline layout controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth",
"x-agentic-mermaid-applicable-builtin-families": [
"timeline"
]
},
"ganttToday": {
"type": "string",
"description": "Explicit deterministic date for the Gantt today marker.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-applicable-builtin-families": [
"gantt"
]
},
"interactive": {
"type": "boolean",
"default": false,
"description": "Enable hover tooltips for supported chart data points.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal output is a static semantic projection",
"x-agentic-mermaid-applicable-builtin-families": [
"xychart",
"pie",
"quadrant"
]
},
"nodeSpacing": {
"type": "number",
"default": 24,
"minimum": 0,
"description": "Horizontal spacing between sibling nodes.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"class",
"er",
"architecture"
]
},
"transparent": {
"type": "boolean",
"default": false,
"description": "Omit the painted SVG canvas background.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal output has no painted canvas background"
},
"architecture": {
"type": "object",
"properties": {
"visual": {
"type": "object",
"properties": {
"edgeText": {
"type": "string",
"description": "Architecture connector-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"iconSize": {
"type": "number",
"description": "Architecture group icon size.",
"exclusiveMinimum": 0
},
"groupFont": {
"type": "string",
"description": "Architecture group-label font family.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"groupText": {
"type": "string",
"description": "Architecture group-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeStroke": {
"type": "string",
"description": "Architecture connector color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupBorder": {
"type": "string",
"description": "Architecture group border color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"serviceText": {
"type": "string",
"description": "Architecture service-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeFontSize": {
"type": "number",
"description": "Architecture connector-label font size.",
"exclusiveMinimum": 0
},
"groupSurface": {
"type": "string",
"description": "Architecture group surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture connector width."
},
"groupFontSize": {
"type": "number",
"description": "Architecture group-label font size.",
"exclusiveMinimum": 0
},
"groupPaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding inside architecture groups."
},
"groupPaddingY": {
"type": "number",
"minimum": 0,
"description": "Vertical padding inside architecture groups."
},
"serviceBorder": {
"type": "string",
"description": "Architecture service border color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeBendRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture connector bend radius."
},
"edgeFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture connector-label font weight."
},
"groupLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture group border width."
},
"serviceSurface": {
"type": "string",
"description": "Architecture service surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture group-label font weight."
},
"serviceFontSize": {
"type": "number",
"description": "Architecture service-label font size.",
"exclusiveMinimum": 0
},
"serviceIconSize": {
"type": "number",
"description": "Architecture service icon size.",
"exclusiveMinimum": 0
},
"servicePaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding inside architecture services."
},
"servicePaddingY": {
"type": "number",
"minimum": 0,
"description": "Vertical padding inside architecture services."
},
"serviceLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture service border width."
},
"edgeLetterSpacing": {
"type": "number",
"description": "Architecture connector-label letter spacing."
},
"edgeTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture connector-label text transform."
},
"groupCornerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture group corner radius."
},
"groupHeaderHeight": {
"type": "number",
"description": "Architecture group-header height.",
"exclusiveMinimum": 0
},
"serviceFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture service-label font weight."
},
"groupHeaderSurface": {
"type": "string",
"description": "Architecture group-header surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupLabelPaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding around architecture group labels."
},
"groupLetterSpacing": {
"type": "number",
"description": "Architecture group-label letter spacing."
},
"groupTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture group-label text transform."
},
"junctionInnerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture junction inner radius."
},
"junctionOuterRadius": {
"type": "number",
"description": "Architecture junction outer radius.",
"exclusiveMinimum": 0
},
"serviceCornerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture service corner radius."
},
"serviceLetterSpacing": {
"type": "number",
"description": "Architecture service-label letter spacing."
},
"serviceTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture service-label text transform."
}
},
"description": "Sparse architecture visual overrides merged over resolved defaults.",
"additionalProperties": false,
"x-agentic-mermaid-runtime-validator": "architectureVisual"
}
},
"description": "Architecture renderer visual metric and paint overrides.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "this option configures graphical architecture rendering",
"x-agentic-mermaid-applicable-builtin-families": [
"architecture"
]
},
"layerSpacing": {
"type": "number",
"default": 40,
"minimum": 0,
"description": "Vertical spacing between graph layers.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"class",
"er",
"architecture"
]
},
"mermaidConfig": {
"type": "object",
"description": "Mermaid-style recursive runtime configuration.",
"additionalProperties": {
"$ref": "#/$defs/jsonValue"
},
"x-agentic-mermaid-terminal": "consumed"
},
"wrappingWidth": {
"type": "number",
"description": "Flowchart measured-label wrapping budget in pixels.",
"exclusiveMinimum": 0,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart"
]
},
"embedFontImport": {
"type": "boolean",
"default": false,
"description": "Embed the Google Fonts import in SVG styles; PNG forces this off for offline rasterization.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output embeds no web-font import"
},
"componentSpacing": {
"type": "number",
"minimum": 0,
"description": "Spacing between disconnected graph components for compatible extension families; no built-in family currently consumes it.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": []
}
},
"description": "Shared advanced RenderOptions object.",
"additionalProperties": false
},
"background": {
"type": "string",
"pattern": "^\\s*(?:#[0-9A-Fa-f]{3,4}|#[0-9A-Fa-f]{6}|#[0-9A-Fa-f]{8}|[tT][rR][aA][nN][sS][pP][aA][rR][eE][nN][tT]|[bB][lL][aA][cC][kK]|[sS][iI][lL][vV][eE][rR]|[gG][rR][aA][yY]|[gG][rR][eE][yY]|[wW][hH][iI][tT][eE]|[mM][aA][rR][oO][oO][nN]|[rR][eE][dD]|[pP][uU][rR][pP][lL][eE]|[fF][uU][cC][hH][sS][iI][aA]|[gG][rR][eE][eE][nN]|[lL][iI][mM][eE]|[oO][lL][iI][vV][eE]|[yY][eE][lL][lL][oO][wW]|[nN][aA][vV][yY]|[bB][lL][uU][eE]|[tT][eE][aA][lL]|[aA][qQ][uU][aA]|[oO][rR][aA][nN][gG][eE])\\s*$",
"minLength": 1,
"description": "Portable basic color or hex color painted behind the raster artifact.",
"x-agentic-mermaid-scope": "portable",
"x-agentic-mermaid-receipt": "included",
"x-agentic-mermaid-runtime-validator": "portablePngBackground"
}
},
"additionalProperties": false
}Render a Mermaid source string to themeable SVG. Returns { ok, svg }. Layout is deterministic: identical input produces identical geometry. The hosted boundary forces security:'strict' and embedFontImport:false.
| Argument | Type | Description |
|---|---|---|
| source* | string | Mermaid source. |
| options | object | Shared advanced RenderOptions object. Styles accept a registered Look (crisp, hand-drawn, excalidraw, pen-and-ink, freehand, watercolor, blueprint, look:tufte, accessible-high-contrast, patent-drawing, status-dashboard, ops-schematic, chalkboard, risograph, architectural-plan, publication-figure), Palette (paper, dusk, zinc-light, zinc-dark, tokyo-night, tokyo-night-storm, tokyo-night-light, catppuccin-mocha, catppuccin-latte, nord, nord-light, dracula, github-light, github-dark, solarized-light, solarized-dark, one-dark, salmon, salmon-dark, tufte-dark), inline record, or left-to-right stack. |
{
"type": "object",
"required": [
"source"
],
"properties": {
"source": {
"type": "string",
"description": "Mermaid source."
},
"options": {
"$id": "https://agentic-mermaid.dev/schemas/render-options.schema.json",
"type": "object",
"$defs": {
"jsonValue": {
"anyOf": [
{
"type": "null"
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/jsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/jsonValue"
}
}
],
"description": "A finite, acyclic JSON value without prototype keys.",
"x-agentic-mermaid-validation-expectation": "a finite, acyclic JSON value without prototype keys"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"bg": {
"type": "string",
"default": "#FFFFFF",
"description": "Background color or CSS variable.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"fg": {
"type": "string",
"default": "#27272A",
"description": "Primary foreground and text color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"font": {
"type": "string",
"default": "Inter",
"description": "CSS font family or stack.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "the host terminal owns the font face",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"line": {
"type": "string",
"description": "Connector and secondary-line color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"seed": {
"type": "number",
"default": 0,
"description": "Deterministic re-roll seed for stochastic Styles.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink"
},
"class": {
"type": "object",
"properties": {
"hierarchicalNamespaces": {
"type": "boolean",
"default": true,
"description": "Nest namespace compounds."
}
},
"description": "Class-diagram rendering controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "this option configures graphical class layout",
"x-agentic-mermaid-applicable-builtin-families": [
"class"
]
},
"gantt": {
"type": "object",
"properties": {
"criticalPath": {
"type": "boolean",
"default": false,
"description": "Emphasize critical-path tasks and connectors."
},
"dependencyArrows": {
"type": "boolean",
"default": false,
"description": "Draw scheduled dependency connectors."
}
},
"description": "Gantt dependency and critical-path overlays.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "graphical Gantt connector emphasis is not represented in cells",
"x-agentic-mermaid-applicable-builtin-families": [
"gantt"
]
},
"muted": {
"type": "string",
"description": "Secondary text and label color.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal themes have no dedicated muted-text role",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"style": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"description": "Registered Style or Palette name."
},
{
"type": "object",
"properties": {
"fill": {
"enum": [
"none",
"hachure",
"solid",
"wash"
],
"type": "string",
"description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends."
},
"font": {
"type": "string",
"description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"mono": {
"type": "boolean",
"description": "Advisory monochrome contract: express tone through shading and weight."
},
"name": {
"type": "string",
"description": "Canonical look:name or palette:name identity; required only when registering a style."
},
"blurb": {
"type": "string",
"description": "Short human-readable description used by discovery surfaces."
},
"roles": {
"type": "object",
"properties": {
"bar": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"edge": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
},
"node": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"task": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"actor": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"group": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 13,
"additionalProperties": false
},
"label": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 5,
"additionalProperties": false
},
"point": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"legend": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"series": {
"type": "object",
"properties": {
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 3,
"additionalProperties": false
},
"milestone": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"pie-slice": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"group-header": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"relationship": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
}
},
"description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.",
"additionalProperties": false
},
"bowing": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js line bowing."
},
"colors": {
"type": "object",
"properties": {
"bg": {
"type": "string",
"description": "Diagram page background. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"fg": {
"type": "string",
"description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"line": {
"type": "string",
"description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"muted": {
"type": "string",
"description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"accent": {
"type": "string",
"description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"border": {
"type": "string",
"description": "Node and group border paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"surface": {
"type": "string",
"description": "Node and group surface fill. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
}
},
"description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.",
"maxProperties": 7,
"additionalProperties": false
},
"intent": {
"enum": [
"premium",
"draft",
"lofi"
],
"type": "string",
"description": "Advisory intent metadata for pickers and quality tooling."
},
"passes": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke."
},
"stroke": {
"enum": [
"crisp",
"jittered",
"freehand"
],
"type": "string",
"description": "Stroke treatment; crisp is the default renderer."
},
"$schema": {
"type": "string",
"description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering."
},
"backdrop": {
"enum": [
"plain",
"paper-ruled",
"grid"
],
"type": "string",
"description": "Flat page furniture drawn behind the diagram."
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"channel",
"value",
"slot"
],
"properties": {
"role": {
"enum": [
"group-header",
"actor",
"relationship",
"pie-slice",
"legend",
"bar",
"series",
"point",
"task",
"milestone"
],
"type": "string"
},
"slot": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"value": {
"type": "string",
"pattern": "^[^\\r\\n\\u0000]+$",
"maxLength": 256,
"minLength": 1
},
"channel": {
"enum": [
"category"
],
"type": "string"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"maxItems": 4096,
"description": "Ordered equality bindings from authored/domain meaning to semantic slots."
},
"washEdge": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor edge-darkening opacity; requires fill wash in the final stack."
},
"roughness": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js stroke irregularity."
},
"fillWeight": {
"type": "number",
"maximum": 20,
"description": "Hachure line weight; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"hachureGap": {
"type": "number",
"maximum": 100,
"description": "Gap between hachure lines; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"constraints": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"action"
],
"properties": {
"kind": {
"const": "contrast"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"minimum": {
"type": "number",
"maximum": 21,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"maxFraction"
],
"properties": {
"kind": {
"const": "accent-area"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"maxFraction": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"role"
],
"properties": {
"kind": {
"const": "mono-role"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 4096,
"description": "Closed inspect-only brand constraints with warn or error actions."
},
"strokeWidth": {
"type": "number",
"maximum": 20,
"description": "Base stroke width in SVG user units.",
"exclusiveMinimum": 0
},
"washOpacity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor glaze opacity; requires fill wash in the final stack."
},
"hachureAngle": {
"type": "number",
"maximum": 360,
"minimum": -360,
"description": "Hachure line angle in degrees; requires fill hachure in the final stack."
},
"formatVersion": {
"const": 1,
"description": "Persisted wire-format version. Optional on input and normalized to 1 on output."
},
"semanticSlots": {
"type": "object",
"description": "Named brand-neutral role-style slots selected by semantic bindings.",
"maxProperties": 4096,
"propertyNames": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"additionalProperties": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 16,
"additionalProperties": false
}
}
},
"description": "A partial declarative style record for Agentic Mermaid rendering. All fields, including formatVersion, are optional on input; resolved and registered specs normalize formatVersion to 1.",
"maxProperties": 24,
"additionalProperties": false
}
],
"x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"description": "Registered Style or Palette name."
},
{
"type": "object",
"properties": {
"fill": {
"enum": [
"none",
"hachure",
"solid",
"wash"
],
"type": "string",
"description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends."
},
"font": {
"type": "string",
"description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"mono": {
"type": "boolean",
"description": "Advisory monochrome contract: express tone through shading and weight."
},
"name": {
"type": "string",
"description": "Canonical look:name or palette:name identity; required only when registering a style."
},
"blurb": {
"type": "string",
"description": "Short human-readable description used by discovery surfaces."
},
"roles": {
"type": "object",
"properties": {
"bar": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"edge": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
},
"node": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"task": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"actor": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"group": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 13,
"additionalProperties": false
},
"label": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 5,
"additionalProperties": false
},
"point": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"legend": {
"type": "object",
"properties": {
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"series": {
"type": "object",
"properties": {
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 3,
"additionalProperties": false
},
"milestone": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"pie-slice": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 5,
"additionalProperties": false
},
"group-header": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 11,
"additionalProperties": false
},
"relationship": {
"type": "object",
"properties": {
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
}
},
"maxProperties": 8,
"additionalProperties": false
}
},
"description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.",
"additionalProperties": false
},
"bowing": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js line bowing."
},
"colors": {
"type": "object",
"properties": {
"bg": {
"type": "string",
"description": "Diagram page background. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"fg": {
"type": "string",
"description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"line": {
"type": "string",
"description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"muted": {
"type": "string",
"description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"accent": {
"type": "string",
"description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"border": {
"type": "string",
"description": "Node and group border paint. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
},
"surface": {
"type": "string",
"description": "Node and group surface fill. Must be a safe, non-fetching CSS color.",
"x-agentic-mermaid-runtime-validator": "safeCssColor"
}
},
"description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.",
"maxProperties": 7,
"additionalProperties": false
},
"intent": {
"enum": [
"premium",
"draft",
"lofi"
],
"type": "string",
"description": "Advisory intent metadata for pickers and quality tooling."
},
"passes": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke."
},
"stroke": {
"enum": [
"crisp",
"jittered",
"freehand"
],
"type": "string",
"description": "Stroke treatment; crisp is the default renderer."
},
"$schema": {
"type": "string",
"description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering."
},
"backdrop": {
"enum": [
"plain",
"paper-ruled",
"grid"
],
"type": "string",
"description": "Flat page furniture drawn behind the diagram."
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"channel",
"value",
"slot"
],
"properties": {
"role": {
"enum": [
"group-header",
"actor",
"relationship",
"pie-slice",
"legend",
"bar",
"series",
"point",
"task",
"milestone"
],
"type": "string"
},
"slot": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"value": {
"type": "string",
"pattern": "^[^\\r\\n\\u0000]+$",
"maxLength": 256,
"minLength": 1
},
"channel": {
"enum": [
"category"
],
"type": "string"
}
},
"maxProperties": 4,
"additionalProperties": false
},
"maxItems": 4096,
"description": "Ordered equality bindings from authored/domain meaning to semantic slots."
},
"washEdge": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor edge-darkening opacity; requires fill wash in the final stack."
},
"roughness": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rough.js stroke irregularity."
},
"fillWeight": {
"type": "number",
"maximum": 20,
"description": "Hachure line weight; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"hachureGap": {
"type": "number",
"maximum": 100,
"description": "Gap between hachure lines; requires fill hachure in the final stack.",
"exclusiveMinimum": 0
},
"constraints": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"action"
],
"properties": {
"kind": {
"const": "contrast"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"minimum": {
"type": "number",
"maximum": 21,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"maxFraction"
],
"properties": {
"kind": {
"const": "accent-area"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
},
"maxFraction": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"action",
"role"
],
"properties": {
"kind": {
"const": "mono-role"
},
"role": {
"enum": [
"node",
"edge",
"edge-label",
"group",
"group-header",
"label",
"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",
"title",
"defs",
"prelude",
"chrome"
],
"type": "string"
},
"action": {
"enum": [
"warn",
"error"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 4096,
"description": "Closed inspect-only brand constraints with warn or error actions."
},
"strokeWidth": {
"type": "number",
"maximum": 20,
"description": "Base stroke width in SVG user units.",
"exclusiveMinimum": 0
},
"washOpacity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Watercolor glaze opacity; requires fill wash in the final stack."
},
"hachureAngle": {
"type": "number",
"maximum": 360,
"minimum": -360,
"description": "Hachure line angle in degrees; requires fill hachure in the final stack."
},
"formatVersion": {
"const": 1,
"description": "Persisted wire-format version. Optional on input and normalized to 1 on output."
},
"semanticSlots": {
"type": "object",
"description": "Named brand-neutral role-style slots selected by semantic bindings.",
"maxProperties": 4096,
"propertyNames": {
"not": {
"enum": [
"__proto__",
"constructor",
"prototype"
]
},
"pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
},
"additionalProperties": {
"type": "object",
"properties": {
"cue": {
"enum": [
"none",
"outline",
"double-line",
"pattern"
],
"type": "string",
"description": "Non-color semantic cue on roles whose family renderer exposes a cue projection."
},
"fontSize": {
"type": "number",
"maximum": 256,
"minimum": 1,
"description": "Font size in SVG user units."
},
"paddingX": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Horizontal role padding."
},
"paddingY": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Vertical role padding."
},
"fillColor": {
"type": "string",
"description": "Surface fill paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"lineWidth": {
"type": "number",
"maximum": 20,
"description": "Border or connector width.",
"exclusiveMinimum": 0
},
"textColor": {
"type": "string",
"description": "Text paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"bendRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable connector bend radius."
},
"fontFamily": {
"type": "string",
"description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"fontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "CSS numeric font weight."
},
"borderColor": {
"type": "string",
"description": "Border paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"strokeColor": {
"type": "string",
"description": "Connector stroke paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
},
"cornerRadius": {
"type": "number",
"maximum": 256,
"minimum": 0,
"description": "Applicable corner radius."
},
"letterSpacing": {
"type": "number",
"maximum": 4,
"minimum": -2,
"description": "Letter spacing in SVG user units."
},
"textTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Text transformation."
},
"headerFillColor": {
"type": "string",
"description": "Group header surface paint.",
"x-agentic-mermaid-runtime-validator": "safeStylePaint"
}
},
"maxProperties": 16,
"additionalProperties": false
}
}
},
"description": "A partial declarative style record for Agentic Mermaid rendering. All fields, including formatVersion, are optional on input; resolved and registered specs normalize formatVersion to 1.",
"maxProperties": 24,
"additionalProperties": false
}
],
"x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec"
},
"description": "Style stack merged from left to right."
}
],
"description": "A registered name, inline StyleSpec, or left-to-right stack of either.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "styleInput"
},
"accent": {
"type": "string",
"description": "Arrowhead, highlight, and data accent color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"border": {
"type": "string",
"description": "Node and group border color.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"shadow": {
"type": "boolean",
"default": false,
"description": "Paint explicit drop shadows on node shapes.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "elevation projects to borders and labels",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"sequence",
"timeline",
"class",
"er",
"journey",
"xychart",
"pie",
"quadrant",
"gantt",
"mindmap",
"gitgraph"
]
},
"compact": {
"type": "boolean",
"default": false,
"description": "Compact SVG serialization while preserving agent hooks.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "compact controls SVG serialization"
},
"journey": {
"type": "object",
"properties": {
"experienceCurve": {
"type": "boolean",
"default": true,
"description": "Connect journey score markers with an experience curve."
}
},
"description": "User-journey graphical controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "experience curves are graphical-only",
"x-agentic-mermaid-applicable-builtin-families": [
"journey"
]
},
"padding": {
"type": "number",
"default": 40,
"minimum": 0,
"description": "Canvas padding in SVG user units.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses paddingX, paddingY, and boxBorderPadding",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"architecture"
]
},
"surface": {
"type": "string",
"description": "Node and group surface color.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal cells do not paint graphical surfaces",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"idPrefix": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"description": "Non-empty namespace for generated SVG definition IDs and local references.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output has no SVG definition ids"
},
"security": {
"enum": [
"default",
"strict"
],
"type": "string",
"default": "default",
"description": "Active SVG content is rejected in every mode; strict additionally rejects every external reference. Raw Mermaid themeCSS is rejected in both modes.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal text has its own control-character and HTML-color safety projection"
},
"timeline": {
"type": "object",
"properties": {
"maxWidth": {
"type": "number",
"description": "Best-effort width budget for horizontal timelines.",
"exclusiveMinimum": 0
}
},
"description": "Timeline layout controls.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth",
"x-agentic-mermaid-applicable-builtin-families": [
"timeline"
]
},
"ganttToday": {
"type": "string",
"description": "Explicit deterministic date for the Gantt today marker.",
"x-agentic-mermaid-terminal": "consumed",
"x-agentic-mermaid-applicable-builtin-families": [
"gantt"
]
},
"interactive": {
"type": "boolean",
"default": false,
"description": "Enable hover tooltips for supported chart data points.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal output is a static semantic projection",
"x-agentic-mermaid-applicable-builtin-families": [
"xychart",
"pie",
"quadrant"
]
},
"nodeSpacing": {
"type": "number",
"default": 24,
"minimum": 0,
"description": "Horizontal spacing between sibling nodes.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"class",
"er",
"architecture"
]
},
"transparent": {
"type": "boolean",
"default": false,
"description": "Omit the painted SVG canvas background.",
"x-agentic-mermaid-terminal": "projected",
"x-agentic-mermaid-terminal-note": "terminal output has no painted canvas background"
},
"architecture": {
"type": "object",
"properties": {
"visual": {
"type": "object",
"properties": {
"edgeText": {
"type": "string",
"description": "Architecture connector-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"iconSize": {
"type": "number",
"description": "Architecture group icon size.",
"exclusiveMinimum": 0
},
"groupFont": {
"type": "string",
"description": "Architecture group-label font family.",
"x-agentic-mermaid-runtime-validator": "safeCssFontFamily"
},
"groupText": {
"type": "string",
"description": "Architecture group-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeStroke": {
"type": "string",
"description": "Architecture connector color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupBorder": {
"type": "string",
"description": "Architecture group border color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"serviceText": {
"type": "string",
"description": "Architecture service-label color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeFontSize": {
"type": "number",
"description": "Architecture connector-label font size.",
"exclusiveMinimum": 0
},
"groupSurface": {
"type": "string",
"description": "Architecture group surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture connector width."
},
"groupFontSize": {
"type": "number",
"description": "Architecture group-label font size.",
"exclusiveMinimum": 0
},
"groupPaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding inside architecture groups."
},
"groupPaddingY": {
"type": "number",
"minimum": 0,
"description": "Vertical padding inside architecture groups."
},
"serviceBorder": {
"type": "string",
"description": "Architecture service border color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"edgeBendRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture connector bend radius."
},
"edgeFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture connector-label font weight."
},
"groupLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture group border width."
},
"serviceSurface": {
"type": "string",
"description": "Architecture service surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture group-label font weight."
},
"serviceFontSize": {
"type": "number",
"description": "Architecture service-label font size.",
"exclusiveMinimum": 0
},
"serviceIconSize": {
"type": "number",
"description": "Architecture service icon size.",
"exclusiveMinimum": 0
},
"servicePaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding inside architecture services."
},
"servicePaddingY": {
"type": "number",
"minimum": 0,
"description": "Vertical padding inside architecture services."
},
"serviceLineWidth": {
"type": "number",
"minimum": 0,
"description": "Architecture service border width."
},
"edgeLetterSpacing": {
"type": "number",
"description": "Architecture connector-label letter spacing."
},
"edgeTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture connector-label text transform."
},
"groupCornerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture group corner radius."
},
"groupHeaderHeight": {
"type": "number",
"description": "Architecture group-header height.",
"exclusiveMinimum": 0
},
"serviceFontWeight": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Architecture service-label font weight."
},
"groupHeaderSurface": {
"type": "string",
"description": "Architecture group-header surface color.",
"x-agentic-mermaid-runtime-validator": "safeCssPaint"
},
"groupLabelPaddingX": {
"type": "number",
"minimum": 0,
"description": "Horizontal padding around architecture group labels."
},
"groupLetterSpacing": {
"type": "number",
"description": "Architecture group-label letter spacing."
},
"groupTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture group-label text transform."
},
"junctionInnerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture junction inner radius."
},
"junctionOuterRadius": {
"type": "number",
"description": "Architecture junction outer radius.",
"exclusiveMinimum": 0
},
"serviceCornerRadius": {
"type": "number",
"minimum": 0,
"description": "Architecture service corner radius."
},
"serviceLetterSpacing": {
"type": "number",
"description": "Architecture service-label letter spacing."
},
"serviceTextTransform": {
"enum": [
"uppercase",
"lowercase",
"capitalize"
],
"type": "string",
"description": "Architecture service-label text transform."
}
},
"description": "Sparse architecture visual overrides merged over resolved defaults.",
"additionalProperties": false,
"x-agentic-mermaid-runtime-validator": "architectureVisual"
}
},
"description": "Architecture renderer visual metric and paint overrides.",
"additionalProperties": false,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "this option configures graphical architecture rendering",
"x-agentic-mermaid-applicable-builtin-families": [
"architecture"
]
},
"layerSpacing": {
"type": "number",
"default": 40,
"minimum": 0,
"description": "Vertical spacing between graph layers.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart",
"state",
"class",
"er",
"architecture"
]
},
"mermaidConfig": {
"type": "object",
"description": "Mermaid-style recursive runtime configuration.",
"additionalProperties": {
"$ref": "#/$defs/jsonValue"
},
"x-agentic-mermaid-terminal": "consumed"
},
"wrappingWidth": {
"type": "number",
"description": "Flowchart measured-label wrapping budget in pixels.",
"exclusiveMinimum": 0,
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth",
"x-agentic-mermaid-applicable-builtin-families": [
"flowchart"
]
},
"embedFontImport": {
"type": "boolean",
"default": false,
"description": "Embed the Google Fonts import in SVG styles; PNG forces this off for offline rasterization.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal output embeds no web-font import"
},
"componentSpacing": {
"type": "number",
"minimum": 0,
"description": "Spacing between disconnected graph components for compatible extension families; no built-in family currently consumes it.",
"x-agentic-mermaid-terminal": "not-applicable",
"x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract",
"x-agentic-mermaid-applicable-builtin-families": []
}
},
"description": "Shared advanced RenderOptions object. Styles accept a registered Look (crisp, hand-drawn, excalidraw, pen-and-ink, freehand, watercolor, blueprint, look:tufte, accessible-high-contrast, patent-drawing, status-dashboard, ops-schematic, chalkboard, risograph, architectural-plan, publication-figure), Palette (paper, dusk, zinc-light, zinc-dark, tokyo-night, tokyo-night-storm, tokyo-night-light, catppuccin-mocha, catppuccin-latte, nord, nord-light, dracula, github-light, github-dark, solarized-light, solarized-dark, one-dark, salmon, salmon-dark, tufte-dark), inline record, or left-to-right stack.",
"additionalProperties": false
}
},
"additionalProperties": false
}Parse and verify a Mermaid diagram without rendering it. Returns { ok, family, summary, warnings, layout: { bounds, nodes, edges } } for valid diagrams and { ok: false, errors } for parse failures. `family` is the detected diagram family and `summary` a one-line description — check them: ok:true only means the diagram is structurally valid, not that it is the kind you intended. Warnings use the layout-rubric codes.
| Argument | Type | Description |
|---|---|---|
| source* | string | Mermaid source. |
{
"type": "object",
"required": [
"source"
],
"properties": {
"source": {
"type": "string",
"description": "Mermaid source."
}
},
"additionalProperties": false
}| Argument | Type | Description |
|---|---|---|
| code* | string | JavaScript to execute; mermaid.* SDK is global. |
| timeoutMs | integer | Optional CPU-time budget (default 5000ms, max 30000ms). |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "JavaScript to execute; mermaid.* SDK is global."
},
"timeoutMs": {
"type": "integer",
"minimum": 1,
"description": "Optional CPU-time budget (default 5000ms, max 30000ms)."
}
},
"additionalProperties": false
}