A
licenseNot graded
qualityD
maintenanceProvides MCP tools to validate Mermaid diagram syntax, render diagrams to SVG, and get documentation links.
75
16
MIT
Agentic Mermaid
Server Details
Render, verify, describe, and safely edit Mermaid diagrams through MCP.
If you are the author of this connector, you can claim ownership with GitHub, an HTTP challenge, or a DNS record. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- adewale/agentic-mermaid
- GitHub Stars
- 10
Available Tools
9 toolsbuildBuild Mermaid diagramARead-onlyIdempotentInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ops | Yes | Non-empty ordered list of ops; each is { kind, ...fields }. | |
| family | Yes | Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph, radar). |
TDQS
A4.5/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses the return envelope in both success and failure cases, and notes a prerequisite (`describe_sdk`). Annotations already indicate readOnly, idempotent, and non-destructive behavior, so the description adds value by explaining the process of folding ops and the exact response shape.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three sentences long, front-loaded with the primary action, and each sentence earns its place: the core action, a clarifying analog, and the return/usage caveat. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, but the description fully covers the return values, error format, and necessary prerequisites. With only two parameters and good annotations, the description gives the agent enough to understand behavior and integration with siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds meaning by explaining that ops are 'folded' over an empty diagram, giving operational context beyond the schema's listing of `{ kind, ...fields }`. It also clarifies the role of `family` by naming it as the diagram type.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: author a new Mermaid diagram from blank using structured ops. It distinguishes itself from siblings by being 'the declarative counterpart to hand-writing source' and returns the same envelope as `mutate`, implying a different operation from that mutation tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use this tool: when authoring a new diagram declaratively via ops rather than writing source directly. It also advises calling `describe_sdk` for unfamiliar ops. It does not explicitly name alternatives, but the reference to `mutate` and the broader sibling list provide enough context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
describeDescribe Mermaid diagramARead-onlyIdempotentInspect
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()).
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | text (default), json AX tree, or facts semantic read-back. | |
| source | Yes | Mermaid source. |
TDQS
A4.3/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish read-only/idempotent behavior. The description adds value by disclosing the exact response shapes for each format and the deterministic nature of facts, which is beyond annotation coverage. No contradiction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three compact sentences, front-loaded with the verb+resource, and every clause adds functional detail (format behaviors, response shapes, example). No fluff.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simple 2-parameter schema and idempotent/read-only annotations, the description fully covers expected behavior for all three formats, including return shapes. No output schema is present, so this return-shape documentation is essential and sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema covers 100% of parameters, so baseline is 3. The description goes beyond schema by spelling out return objects for each format and giving a concrete fact example, though it does not add much to the 'source' parameter beyond schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource ('Describe a Mermaid diagram') and the format parameter clarifies three distinct output modes. This clearly differentiates from siblings like describe_sdk and render_*.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines3/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear format-specific use context (e.g., facts for machine checking) but never explicitly states when to choose this tool over sibling tools such as render_* or verify. Usage is implied rather than directly contrasted.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
describe_sdkDescribe Mermaid SDK operationsARead-onlyIdempotentInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| detail | No | signatures for a compact menu; fields for the complete schema (default). | |
| family | Yes | Diagram family whose mutation operations are needed. |
TDQS
A4.6/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare the tool as read-only, idempotent, and non-destructive, so the description does not need to repeat that. It adds useful behavioral context by describing the two output modes and the version-matched nature of the returned operations, which goes beyond the basic safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three sentences long and every sentence earns its place: the first defines the core action, the second explains parameter choices, and the third gives invocation context. It is well-front-loaded and free of redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of an output schema, the description does a good job of outlining what information will be returned (field types, required flags, enum values, defaults, constraints) and when to call it. However, it does not specify the exact return format (e.g., JSON), which is a minor gap for an agent that needs to parse the response.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already covers both parameters fully (100% schema description coverage), so the baseline is 3. The description enhances this by explicitly explaining the purpose of each 'detail' value and how they change the output, which helps the agent choose correctly.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool returns version-matched mutation operations for a specific diagram family. It distinguishes itself from the sibling tools by explicitly positioning it as a prerequisite for build, mutate, or execute, and the name 'describe_sdk' differentiates it from the generic 'describe' sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit guidance is provided: 'Call this before build, mutate, or execute when the family schema is not already known.' It also instructs when to use each detail mode ('signatures' for compact menu, 'fields' for exact types), making the usage context clear and actionable.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
executeExecute Mermaid SDK codeARead-onlyInspect
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 {
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 "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>} 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>>;"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 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 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[] }
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | JavaScript to execute; mermaid.* SDK is global. | |
| timeoutMs | No | Optional CPU-time budget (default 5000ms, max 30000ms). |
TDQS
A4.7/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=true, but the description adds substantial behavioral context: the sandbox is isolated, one call composes edits, promises/async/await/dynamic import/type annotations are unsupported, hosted runs cost more, and host policies force security:'strict' and embedFontImport:false. This goes far beyond what annotations provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness3/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The human-readable prose is concise, front-loaded, and well-structured. However, the SDK type declaration is extremely long and could overwhelm the model context for a tool-selection task. While useful as reference, it is not concise and includes many details that are not necessary for deciding when to invoke this tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
This is a complex code-execution tool with no output schema. The description covers environment constraints, security policy, cost trade-offs, alternatives, and API surface. It gives an agent everything needed to determine if and how to use execute correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage for both parameters, so the baseline is 3. The description adds meaningful semantics for the 'code' parameter by documenting the complete mermaid.* SDK surface, which tells the agent what methods and types are available during execution. This is extra value beyond basic parameter descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and resource: 'Run JavaScript in an isolated sandbox; return a value.' It clearly distinguishes the tool from siblings by stating that direct render/verify and declarative mutate/build tools should be preferred for simpler operations, positioning execute as the escape hatch for complex logic.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit when-to-use and when-not-to-use guidance, naming alternatives: 'prefer those for plain render/verify calls' and 'prefer the declarative mutate/build tools; reserve execute for logic the ops don't express.' This is exactly the kind of clear decision-making context needed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mutateEdit Mermaid diagramARead-onlyIdempotentInspect
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": , …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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ops | Yes | Non-empty ordered list of edit ops; each is { kind, ...fields }. | |
| source | Yes | Mermaid source to edit. |
TDQS
A5/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Even though annotations already declare the tool read-only and idempotent, the description adds crucial behavioral details: ops apply in order, are all-or-nothing, the first failing op stops the batch, and the input is left untouched. It also specifies the exact error shape and that `opIndex` indicates the failing op. No contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Every sentence contributes unique information: purpose, relationship to `execute`, usage guidance, return/error behavior, and op format. The description is detailed but tightly structured, front-loaded with the core purpose and followed by necessary qualifications.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description fully specifies success and failure return shapes, the meaning of `opIndex`, and the all-or-nothing behavior. It also references `describe_sdk` for op signatures, making it complete for a complex mutation tool with a generic item schema. Sibling tool distinctions are clearly handled.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters5/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema only defines `source` and `ops` generically, but the description adds essential semantics: each op is `{ kind, ...fields }`, ops are ordered, and the batch is atomic. It also explains how the parameters relate to the output and error handling, going well beyond the schema's coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description leads with a specific verb and resource: 'Apply a list of structured edit ops to an existing Mermaid source and return the edited diagram.' It clearly distinguishes itself from the sibling `execute` by calling itself the declarative counterpart, making its role unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit guidance is provided: prefer `mutate` for straightforward edits and reserve `execute` for logic the ops don't express. It also advises calling `describe_sdk` before authoring unfamiliar ops, giving clear when-to-use and when-not-to-use instructions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
render_asciiRender Mermaid as textARead-onlyIdempotentInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | Mermaid source. | |
| options | No | Shared advanced RenderOptions object, including style/palette/config/security. | |
| useAscii | No | true = ASCII characters, false = Unicode (default). | |
| targetWidth | No | Hard maximum line width in terminal display cells. |
TDQS
A4.6/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and idempotentHint=true, lowering the burden. The description adds valuable behavioral context: return shape, concrete ASCII vs Unicode glyphs (+,-,| vs ┌,─,│), default behavior when useAscii is absent, and a typed error for impossible targetWidth bounds. There is no contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, front-loaded with the core purpose, and each subsequent sentence adds essential behavioral detail. No filler or repetition of schema content; it is efficiently structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema, so the description properly covers return shape and error behavior. It does not explain the extensive options object, but the schema already does, and the most terminal-relevant options (useAscii, targetWidth) are highlighted. This is complete enough for an agent to use the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds meaningful details beyond the schema: it shows exact ASCII characters, specifies that absent useAscii defaults to Unicode, and reveals the error condition for targetWidth. These enrich the schema's brief descriptions without redundancy.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with 'Render a Mermaid source string to text,' clearly identifying the verb, resource, and output format. It distinguishes from sibling renderers (render_png/render_svg) by specifically targeting text output and even states the return shape ({ ok, text }).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not explicitly name alternatives, but phrases like 'to text' and 'terminal display-cell bound' make the intended context (plain text/terminal rendering) very clear. It stops short of explicitly saying 'use this instead of render_png/render_svg,' so it is not a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
render_pngRender Mermaid as PNGARead-onlyIdempotentInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fitTo | No | Exactly one output width or height constraint. | |
| scale | No | Positive output scale used when no fitTo constraint is supplied. | |
| source | Yes | Mermaid source. | |
| options | No | Shared advanced RenderOptions object. | |
| background | No | Portable basic color or hex color painted behind the raster artifact. |
TDQS
A4.2/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish read-only, idempotent, non-destructive behavior. The description adds valuable context: hosted rendering uses resvg-wasm with bundled fonts, bytes may differ from the local napi renderer, and the return shape is { ok, png_base64 }. This goes beyond the annotations without contradicting them.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three sentences with no fluff. The first sentence states the core purpose and return format, the second adds a critical determinism caveat, and the third points to an alternative for different artifact types. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the absence of an output schema, the description usefully states the return shape. It also covers the hosted/local distinction and determinism caveat. The schema is very rich and already documents all parameters. Minor gaps remain (e.g., error behavior, size limits), but overall the description is complete enough for an agent to invoke and interpret results.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so each parameter already has a description. The tool description adds little new parameter-level meaning beyond confirming the source is a string and mentioning a distinction for file/URL artifacts. Since the schema carries the parameter burden, a baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb+resource: 'Rasterize a Mermaid source string to PNG.' It also states the return shape '{ ok, png_base64 }' and explicitly distinguishes this tool from image-byte determinism and the local stdio server, making its scope clear relative to sibling tools like render_svg and render_ascii.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear context: this is the hosted PNG renderer for Mermaid source strings, and it warns that hosted output is not part of the byte-determinism contract. It also provides an exclusion: 'For file/URL artifacts use the local stdio server.' It doesn't explicitly name sibling tools like render_svg, but the guidance is sufficient for most selection decisions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
render_svgRender Mermaid as SVGARead-onlyIdempotentInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | Mermaid source. | |
| options | No | 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. |
TDQS
A4.4/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false. The description adds meaningful behavioral details beyond those: deterministic layout ('identical input produces identical geometry') and hosted-boundary constraints ('forces security:\'strict\' and embedFontImport:false'). No contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three tight sentences: purpose, return shape, and behavioral constraints. It is front-loaded with the action and avoids redundant restatement of the title or annotations.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with a very large options schema, the description captures the core behavior, return shape, determinism, and security constraints. It does not cover error behavior or supported Mermaid families, but the schema and annotations compensate for most gaps, and the absence of an output schema is mitigated by the explicit { ok, svg } return note.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds only the phrase 'source string' and 'themeable SVG,' while the schema fully documents both parameters and all nested option properties. No additional semantic value is provided beyond what the schema already contains.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and resource: 'Render a Mermaid source string to themeable SVG.' It also names the return shape ({ ok, svg }), clearly distinguishing this tool from sibling renderers like render_ascii and render_png by output format.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear context that this tool produces SVG output, which differentiates it from ASCII and PNG rendering siblings. It does not explicitly name alternatives or provide when-to-use/when-not-to-use guidance, but the output-type framing is sufficient for basic selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
verifyVerify Mermaid diagramARead-onlyIdempotentInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | Mermaid source. |
TDQS
A4.5/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description goes beyond annotations by specifying the exact return shape for both success and failure, and it discloses a non-obvious behavioral nuance: ok:true does not guarantee the diagram is the intended type. This is critical for correct use and is not captured by the readOnly/idempotent hints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and well-structured: it starts with the primary action, then the return format, and then the key caveat about interpretation. Every sentence earns its place without redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter tool with no output schema, the description is complete. It explains the return values, the distinction between structural validity and intent, and the warning codes. No critical information is missing for an agent to decide when and how to use this tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers the single parameter 'source' with a description ('Mermaid source'), so schema coverage is 100%. The tool description adds no additional parameter semantics beyond what is in the schema, hence the baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Parse and verify a Mermaid diagram without rendering it,' which pairs a specific verb with a resource and scope. It distinguishes itself from sibling render tools by explicitly excluding rendering, making its purpose unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear context for when to use this tool (verifying without rendering) and provides important guidance on interpreting the ok flag (check family and summary, as ok:true only means structural validity). It does not explicitly name alternatives, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
6 tool updates
- Changed
build3 fields changed- changed
Input schema / properties / family / descriptionPrevious value: -"Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph)."New value: +"Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph, radar)." - changed
Input schema / properties / ops / descriptionPrevious value: -"Ordered list of ops; each is { kind, ...fields }."New value: +"Non-empty ordered list of ops; each is { kind, ...fields }." - added
Input schema / properties / ops / minItemsAdded value: +1
- Changed
describe_sdk1 field changed- changed
Input schema / properties / family / enumPrevious value: -[ - "flowchart", - "state", - "sequence", - "timeline", - "class", - "er", - "journey", - "architecture", - "xychart", - "pie", - "quadrant", - "gantt", - "mindmap", - "gitgraph" -]New value: +[ + "flowchart", + "state", + "sequence", + "timeline", + "class", + "er", + "journey", + "architecture", + "xychart", + "pie", + "quadrant", + "gantt", + "mindmap", + "gitgraph", + "radar" +]
- Changed
mutate2 fields changed- changed
Input schema / properties / ops / descriptionPrevious value: -"Ordered list of edit ops; each is { kind, ...fields }."New value: +"Non-empty ordered list of edit ops; each is { kind, ...fields }." - added
Input schema / properties / ops / minItemsAdded value: +1
- Changed
render_ascii5 fields changed- changed
Input schema / properties / options / properties / embedFontImport / defaultPrevious value: -trueNew value: +false - removed
Input schema / properties / options / properties / idPrefix / defaultRemoved value: -"" - changed
Input schema / properties / options / properties / idPrefix / descriptionPrevious value: -"Namespace generated SVG definition IDs and local references."New value: +"Non-empty namespace for generated SVG definition IDs and local references." - changed
Input schema / properties / options / properties / idPrefix / patternPrevious value: -"^[A-Za-z0-9_.:-]*$"New value: +"^[A-Za-z0-9_.:-]+$" - changed
Input schema / properties / options / properties / style / anyOfPrevious value: -[ - { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - { - "description": "Style stack merged from left to right.", - "items": { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - "type": "array" - } -]New value: +[ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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, + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "bindings": { + "description": "Ordered equality bindings from authored/domain meaning to semantic slots.", + "items": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "channel": { + "enum": [ + "category" + ], + "type": "string" + }, + "role": { + "enum": [ + "group-header", + "actor", + "relationship", + "pie-slice", + "legend", + "bar", + "series", + "point", + "task", + "milestone" + ], + "type": "string" + }, + "slot": { + "not": { + "enum": [ + "__proto__", + "constructor", + "prototype" + ] + }, + "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$", + "type": "string" + }, + "value": { + "maxLength": 256, + "minLength": 1, + "pattern": "^[^\\r\\n\\u0000]+$", + "type": "string" + } + }, + "required": [ + "channel", + "value", + "slot" + ], + "type": "object" + }, + "maxItems": 4096, + "type": "array" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "maxProperties": 7, + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "constraints": { + "description": "Closed inspect-only brand constraints with warn or error actions.", + "items": { + "oneOf": [ + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "contrast" + }, + "minimum": { + "maximum": 21, + "minimum": 1, + "type": "number" + }, + "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" + } + }, + "required": [ + "kind", + "action" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "accent-area" + }, + "maxFraction": { + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "required": [ + "kind", + "action", + "maxFraction" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "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" + } + }, + "required": [ + "kind", + "action", + "role" + ], + "type": "object" + } + ] + }, + "maxItems": 4096, + "type": "array" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roles": { + "additionalProperties": false, + "description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.", + "properties": { + "actor": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "bar": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "edge": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group": { + "additionalProperties": false, + "maxProperties": 13, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group-header": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "label": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "legend": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "milestone": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "node": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "pie-slice": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "point": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "relationship": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "series": { + "additionalProperties": false, + "maxProperties": 3, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "task": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "semanticSlots": { + "additionalProperties": { + "additionalProperties": false, + "maxProperties": 16, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "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}$" + }, + "type": "object" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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, + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "bindings": { + "description": "Ordered equality bindings from authored/domain meaning to semantic slots.", + "items": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "channel": { + "enum": [ + "category" + ], + "type": "string" + }, + "role": { + "enum": [ + "group-header", + "actor", + "relationship", + "pie-slice", + "legend", + "bar", + "series", + "point", + "task", + "milestone" + ], + "type": "string" + }, + "slot": { + "not": { + "enum": [ + "__proto__", + "constructor", + "prototype" + ] + }, + "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$", + "type": "string" + }, + "value": { + "maxLength": 256, + "minLength": 1, + "pattern": "^[^\\r\\n\\u0000]+$", + "type": "string" + } + }, + "required": [ + "channel", + "value", + "slot" + ], + "type": "object" + }, + "maxItems": 4096, + "type": "array" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "maxProperties": 7, + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "constraints": { + "description": "Closed inspect-only brand constraints with warn or error actions.", + "items": { + "oneOf": [ + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "contrast" + }, + "minimum": { + "maximum": 21, + "minimum": 1, + "type": "number" + }, + "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" + } + }, + "required": [ + "kind", + "action" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "accent-area" + }, + "maxFraction": { + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "required": [ + "kind", + "action", + "maxFraction" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "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" + } + }, + "required": [ + "kind", + "action", + "role" + ], + "type": "object" + } + ] + }, + "maxItems": 4096, + "type": "array" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roles": { + "additionalProperties": false, + "description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.", + "properties": { + "actor": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "bar": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "edge": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group": { + "additionalProperties": false, + "maxProperties": 13, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group-header": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "label": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "legend": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "milestone": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "node": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "pie-slice": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "point": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "relationship": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "series": { + "additionalProperties": false, + "maxProperties": 3, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "task": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "semanticSlots": { + "additionalProperties": { + "additionalProperties": false, + "maxProperties": 16, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "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}$" + }, + "type": "object" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } +]
- Changed
render_png8 fields changed- changed
Input schema / properties / options / descriptionPrevious value: -"Shared advanced RenderOptions object; compatibility convenience fields above override matching values."New value: +"Shared advanced RenderOptions object." - changed
Input schema / properties / options / properties / embedFontImport / defaultPrevious value: -trueNew value: +false - removed
Input schema / properties / options / properties / idPrefix / defaultRemoved value: -"" - changed
Input schema / properties / options / properties / idPrefix / descriptionPrevious value: -"Namespace generated SVG definition IDs and local references."New value: +"Non-empty namespace for generated SVG definition IDs and local references." - changed
Input schema / properties / options / properties / idPrefix / patternPrevious value: -"^[A-Za-z0-9_.:-]*$"New value: +"^[A-Za-z0-9_.:-]+$" - changed
Input schema / properties / options / properties / style / anyOfPrevious value: -[ - { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - { - "description": "Style stack merged from left to right.", - "items": { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - "type": "array" - } -]New value: +[ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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, + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "bindings": { + "description": "Ordered equality bindings from authored/domain meaning to semantic slots.", + "items": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "channel": { + "enum": [ + "category" + ], + "type": "string" + }, + "role": { + "enum": [ + "group-header", + "actor", + "relationship", + "pie-slice", + "legend", + "bar", + "series", + "point", + "task", + "milestone" + ], + "type": "string" + }, + "slot": { + "not": { + "enum": [ + "__proto__", + "constructor", + "prototype" + ] + }, + "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$", + "type": "string" + }, + "value": { + "maxLength": 256, + "minLength": 1, + "pattern": "^[^\\r\\n\\u0000]+$", + "type": "string" + } + }, + "required": [ + "channel", + "value", + "slot" + ], + "type": "object" + }, + "maxItems": 4096, + "type": "array" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "maxProperties": 7, + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "constraints": { + "description": "Closed inspect-only brand constraints with warn or error actions.", + "items": { + "oneOf": [ + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "contrast" + }, + "minimum": { + "maximum": 21, + "minimum": 1, + "type": "number" + }, + "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" + } + }, + "required": [ + "kind", + "action" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "accent-area" + }, + "maxFraction": { + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "required": [ + "kind", + "action", + "maxFraction" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "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" + } + }, + "required": [ + "kind", + "action", + "role" + ], + "type": "object" + } + ] + }, + "maxItems": 4096, + "type": "array" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roles": { + "additionalProperties": false, + "description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.", + "properties": { + "actor": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "bar": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "edge": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group": { + "additionalProperties": false, + "maxProperties": 13, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group-header": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "label": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "legend": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "milestone": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "node": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "pie-slice": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "point": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "relationship": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "series": { + "additionalProperties": false, + "maxProperties": 3, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "task": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "semanticSlots": { + "additionalProperties": { + "additionalProperties": false, + "maxProperties": 16, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "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}$" + }, + "type": "object" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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, + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "bindings": { + "description": "Ordered equality bindings from authored/domain meaning to semantic slots.", + "items": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "channel": { + "enum": [ + "category" + ], + "type": "string" + }, + "role": { + "enum": [ + "group-header", + "actor", + "relationship", + "pie-slice", + "legend", + "bar", + "series", + "point", + "task", + "milestone" + ], + "type": "string" + }, + "slot": { + "not": { + "enum": [ + "__proto__", + "constructor", + "prototype" + ] + }, + "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$", + "type": "string" + }, + "value": { + "maxLength": 256, + "minLength": 1, + "pattern": "^[^\\r\\n\\u0000]+$", + "type": "string" + } + }, + "required": [ + "channel", + "value", + "slot" + ], + "type": "object" + }, + "maxItems": 4096, + "type": "array" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "maxProperties": 7, + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "constraints": { + "description": "Closed inspect-only brand constraints with warn or error actions.", + "items": { + "oneOf": [ + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "contrast" + }, + "minimum": { + "maximum": 21, + "minimum": 1, + "type": "number" + }, + "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" + } + }, + "required": [ + "kind", + "action" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "accent-area" + }, + "maxFraction": { + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "required": [ + "kind", + "action", + "maxFraction" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "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" + } + }, + "required": [ + "kind", + "action", + "role" + ], + "type": "object" + } + ] + }, + "maxItems": 4096, + "type": "array" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roles": { + "additionalProperties": false, + "description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.", + "properties": { + "actor": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "bar": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "edge": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group": { + "additionalProperties": false, + "maxProperties": 13, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group-header": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "label": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "legend": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "milestone": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "node": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "pie-slice": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "point": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "relationship": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "series": { + "additionalProperties": false, + "maxProperties": 3, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "task": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "semanticSlots": { + "additionalProperties": { + "additionalProperties": false, + "maxProperties": 16, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "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}$" + }, + "type": "object" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } +] - removed
Input schema / properties / seedRemoved value: -{ - "default": 0, - "description": "Deterministic re-roll seed for stochastic Styles.", - "type": "number", - "x-agentic-mermaid-terminal": "not-applicable", - "x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink" -} - removed
Input schema / properties / styleRemoved value: -{ - "anyOf": [ - { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - { - "description": "Style stack merged from left to right.", - "items": { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - "type": "array" - } - ], - "description": "A registered name, inline StyleSpec, or left-to-right stack of either.", - "x-agentic-mermaid-runtime-validator": "styleInput", - "x-agentic-mermaid-terminal": "consumed" -}
- Changed
render_svg11 fields changed- removed
Input schema / properties / bgRemoved value: -{ - "default": "#FFFFFF", - "description": "Background color or CSS variable.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssPaint", - "x-agentic-mermaid-terminal": "consumed" -} - removed
Input schema / properties / fgRemoved value: -{ - "default": "#27272A", - "description": "Primary foreground and text color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssPaint", - "x-agentic-mermaid-terminal": "consumed" -} - changed
Input schema / properties / options / descriptionPrevious value: -"Shared advanced RenderOptions object; compatibility conveniences override matching values. 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, palette:tufte, tufte-dark), inline record, or left-to-right stack."New value: +"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." - changed
Input schema / properties / options / properties / embedFontImport / defaultPrevious value: -trueNew value: +false - removed
Input schema / properties / options / properties / idPrefix / defaultRemoved value: -"" - changed
Input schema / properties / options / properties / idPrefix / descriptionPrevious value: -"Namespace generated SVG definition IDs and local references."New value: +"Non-empty namespace for generated SVG definition IDs and local references." - changed
Input schema / properties / options / properties / idPrefix / patternPrevious value: -"^[A-Za-z0-9_.:-]*$"New value: +"^[A-Za-z0-9_.:-]+$" - changed
Input schema / properties / options / properties / style / anyOfPrevious value: -[ - { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - { - "description": "Style stack merged from left to right.", - "items": { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - "type": "array" - } -]New value: +[ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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, + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "bindings": { + "description": "Ordered equality bindings from authored/domain meaning to semantic slots.", + "items": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "channel": { + "enum": [ + "category" + ], + "type": "string" + }, + "role": { + "enum": [ + "group-header", + "actor", + "relationship", + "pie-slice", + "legend", + "bar", + "series", + "point", + "task", + "milestone" + ], + "type": "string" + }, + "slot": { + "not": { + "enum": [ + "__proto__", + "constructor", + "prototype" + ] + }, + "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$", + "type": "string" + }, + "value": { + "maxLength": 256, + "minLength": 1, + "pattern": "^[^\\r\\n\\u0000]+$", + "type": "string" + } + }, + "required": [ + "channel", + "value", + "slot" + ], + "type": "object" + }, + "maxItems": 4096, + "type": "array" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "maxProperties": 7, + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "constraints": { + "description": "Closed inspect-only brand constraints with warn or error actions.", + "items": { + "oneOf": [ + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "contrast" + }, + "minimum": { + "maximum": 21, + "minimum": 1, + "type": "number" + }, + "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" + } + }, + "required": [ + "kind", + "action" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "accent-area" + }, + "maxFraction": { + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "required": [ + "kind", + "action", + "maxFraction" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "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" + } + }, + "required": [ + "kind", + "action", + "role" + ], + "type": "object" + } + ] + }, + "maxItems": 4096, + "type": "array" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roles": { + "additionalProperties": false, + "description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.", + "properties": { + "actor": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "bar": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "edge": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group": { + "additionalProperties": false, + "maxProperties": 13, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group-header": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "label": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "legend": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "milestone": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "node": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "pie-slice": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "point": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "relationship": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "series": { + "additionalProperties": false, + "maxProperties": 3, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "task": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "semanticSlots": { + "additionalProperties": { + "additionalProperties": false, + "maxProperties": 16, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "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}$" + }, + "type": "object" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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, + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "bindings": { + "description": "Ordered equality bindings from authored/domain meaning to semantic slots.", + "items": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "channel": { + "enum": [ + "category" + ], + "type": "string" + }, + "role": { + "enum": [ + "group-header", + "actor", + "relationship", + "pie-slice", + "legend", + "bar", + "series", + "point", + "task", + "milestone" + ], + "type": "string" + }, + "slot": { + "not": { + "enum": [ + "__proto__", + "constructor", + "prototype" + ] + }, + "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$", + "type": "string" + }, + "value": { + "maxLength": 256, + "minLength": 1, + "pattern": "^[^\\r\\n\\u0000]+$", + "type": "string" + } + }, + "required": [ + "channel", + "value", + "slot" + ], + "type": "object" + }, + "maxItems": 4096, + "type": "array" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "maxProperties": 7, + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "constraints": { + "description": "Closed inspect-only brand constraints with warn or error actions.", + "items": { + "oneOf": [ + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "contrast" + }, + "minimum": { + "maximum": 21, + "minimum": 1, + "type": "number" + }, + "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" + } + }, + "required": [ + "kind", + "action" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "kind": { + "const": "accent-area" + }, + "maxFraction": { + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "required": [ + "kind", + "action", + "maxFraction" + ], + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "action": { + "enum": [ + "warn", + "error" + ], + "type": "string" + }, + "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" + } + }, + "required": [ + "kind", + "action", + "role" + ], + "type": "object" + } + ] + }, + "maxItems": 4096, + "type": "array" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roles": { + "additionalProperties": false, + "description": "Partial semantic SceneRole defaults. Family-authored styling remains authoritative.", + "properties": { + "actor": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "bar": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "edge": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group": { + "additionalProperties": false, + "maxProperties": 13, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "group-header": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "label": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "legend": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "milestone": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "node": { + "additionalProperties": false, + "maxProperties": 11, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "pie-slice": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "point": { + "additionalProperties": false, + "maxProperties": 4, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "relationship": { + "additionalProperties": false, + "maxProperties": 8, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object" + }, + "series": { + "additionalProperties": false, + "maxProperties": 3, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + }, + "task": { + "additionalProperties": false, + "maxProperties": 5, + "properties": { + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "semanticSlots": { + "additionalProperties": { + "additionalProperties": false, + "maxProperties": 16, + "properties": { + "bendRadius": { + "description": "Applicable connector bend radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "borderColor": { + "description": "Border paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "cornerRadius": { + "description": "Applicable corner radius.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "cue": { + "description": "Non-color semantic cue on roles whose family renderer exposes a cue projection.", + "enum": [ + "none", + "outline", + "double-line", + "pattern" + ], + "type": "string" + }, + "fillColor": { + "description": "Surface fill paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "fontFamily": { + "description": "Safe font family/stack for roles whose descriptor exposes family-specific typography.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "fontSize": { + "description": "Font size in SVG user units.", + "maximum": 256, + "minimum": 1, + "type": "number" + }, + "fontWeight": { + "description": "CSS numeric font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "headerFillColor": { + "description": "Group header surface paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "letterSpacing": { + "description": "Letter spacing in SVG user units.", + "maximum": 4, + "minimum": -2, + "type": "number" + }, + "lineWidth": { + "description": "Border or connector width.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "paddingX": { + "description": "Horizontal role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "paddingY": { + "description": "Vertical role padding.", + "maximum": 256, + "minimum": 0, + "type": "number" + }, + "strokeColor": { + "description": "Connector stroke paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textColor": { + "description": "Text paint.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeStylePaint" + }, + "textTransform": { + "description": "Text transformation.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "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}$" + }, + "type": "object" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } +] - removed
Input schema / properties / seedRemoved value: -{ - "default": 0, - "description": "Deterministic re-roll seed for stochastic Styles.", - "type": "number", - "x-agentic-mermaid-terminal": "not-applicable", - "x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink" -} - removed
Input schema / properties / styleRemoved value: -{ - "anyOf": [ - { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - { - "description": "Style stack merged from left to right.", - "items": { - "anyOf": [ - { - "description": "Registered Style or Palette name.", - "type": "string" - }, - { - "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.", - "properties": { - "$schema": { - "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", - "type": "string" - }, - "backdrop": { - "description": "Flat page furniture drawn behind the diagram.", - "enum": [ - "plain", - "paper-ruled", - "grid" - ], - "type": "string" - }, - "blurb": { - "description": "Short human-readable description used by discovery surfaces.", - "type": "string" - }, - "bowing": { - "description": "Rough.js line bowing.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "colors": { - "additionalProperties": false, - "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", - "properties": { - "accent": { - "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "bg": { - "description": "Diagram page background. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "border": { - "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "fg": { - "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "line": { - "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "muted": { - "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - }, - "surface": { - "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssColor" - } - }, - "type": "object" - }, - "fill": { - "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", - "enum": [ - "none", - "hachure", - "solid", - "wash" - ], - "type": "string" - }, - "fillWeight": { - "description": "Hachure line weight; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "font": { - "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", - "type": "string", - "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" - }, - "formatVersion": { - "const": 1, - "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." - }, - "hachureAngle": { - "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", - "maximum": 360, - "minimum": -360, - "type": "number" - }, - "hachureGap": { - "description": "Gap between hachure lines; requires fill hachure in the final stack.", - "exclusiveMinimum": 0, - "maximum": 100, - "type": "number" - }, - "intent": { - "description": "Advisory intent metadata for pickers and quality tooling.", - "enum": [ - "premium", - "draft", - "lofi" - ], - "type": "string" - }, - "mono": { - "description": "Advisory monochrome contract: express tone through shading and weight.", - "type": "boolean" - }, - "name": { - "description": "Canonical look:name or palette:name identity; required only when registering a style.", - "type": "string" - }, - "passes": { - "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", - "maximum": 8, - "minimum": 1, - "type": "integer" - }, - "roughness": { - "description": "Rough.js stroke irregularity.", - "maximum": 10, - "minimum": 0, - "type": "number" - }, - "stroke": { - "description": "Stroke treatment; crisp is the default renderer.", - "enum": [ - "crisp", - "jittered", - "freehand" - ], - "type": "string" - }, - "strokeWidth": { - "description": "Base stroke width in SVG user units.", - "exclusiveMinimum": 0, - "maximum": 20, - "type": "number" - }, - "washEdge": { - "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "washOpacity": { - "description": "Watercolor glaze opacity; requires fill wash in the final stack.", - "maximum": 1, - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - ], - "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" - }, - "type": "array" - } - ], - "description": "Style: 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, palette:tufte, tufte-dark), inline record, or left-to-right stack.", - "x-agentic-mermaid-runtime-validator": "styleInput", - "x-agentic-mermaid-terminal": "consumed" -} - removed
Input schema / properties / themeRemoved value: -{ - "deprecated": true, - "description": "Deprecated compatibility input (one of: 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, tufte-dark); use style with a Palette name.", - "enum": [ - "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", - "tufte-dark" - ], - "type": "string", - "x-agentic-mermaid-diagnostic": { - "code": "THEME_INPUT_DEPRECATED", - "message": "The render_svg theme field is a legacy compatibility input; use style with a Palette name instead.", - "removal": { - "date": "2027-01-31", - "release": "0.3.0" - } - } -}
9 tool updates
- Changed
build1 field changed- added
Input schema / additionalPropertiesAdded value: +false
- Changed
describe1 field changed- added
Input schema / additionalPropertiesAdded value: +false
- Changed
describe_sdk1 field changed- added
Input schema / additionalPropertiesAdded value: +false
- Changed
execute1 field changed- added
Input schema / additionalPropertiesAdded value: +false
- Changed
mutate1 field changed- added
Input schema / additionalPropertiesAdded value: +false
- Changed
render_ascii2 fields changed- added
Input schema / additionalPropertiesAdded value: +false - added
Input schema / properties / optionsAdded value: +{ + "$defs": { + "jsonValue": { + "anyOf": [ + { + "type": "null" + }, + { + "type": "string" + }, + { + "type": "number" + }, + { + "type": "boolean" + }, + { + "items": { + "$ref": "#/$defs/jsonValue" + }, + "type": "array" + }, + { + "additionalProperties": { + "$ref": "#/$defs/jsonValue" + }, + "type": "object" + } + ], + "description": "A finite, acyclic JSON value without prototype keys.", + "x-agentic-mermaid-validation-expectation": "a finite, acyclic JSON value without prototype keys" + } + }, + "$id": "https://agentic-mermaid.dev/schemas/render-options.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "description": "Shared advanced RenderOptions object, including style/palette/config/security.", + "properties": { + "accent": { + "description": "Arrowhead, highlight, and data accent color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "architecture": { + "additionalProperties": false, + "description": "Architecture renderer visual metric and paint overrides.", + "properties": { + "visual": { + "additionalProperties": false, + "description": "Sparse architecture visual overrides merged over resolved defaults.", + "properties": { + "edgeBendRadius": { + "description": "Architecture connector bend radius.", + "minimum": 0, + "type": "number" + }, + "edgeFontSize": { + "description": "Architecture connector-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "edgeFontWeight": { + "description": "Architecture connector-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "edgeLetterSpacing": { + "description": "Architecture connector-label letter spacing.", + "type": "number" + }, + "edgeLineWidth": { + "description": "Architecture connector width.", + "minimum": 0, + "type": "number" + }, + "edgeStroke": { + "description": "Architecture connector color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "edgeText": { + "description": "Architecture connector-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "edgeTextTransform": { + "description": "Architecture connector-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + }, + "groupBorder": { + "description": "Architecture group border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupCornerRadius": { + "description": "Architecture group corner radius.", + "minimum": 0, + "type": "number" + }, + "groupFont": { + "description": "Architecture group-label font family.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "groupFontSize": { + "description": "Architecture group-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "groupFontWeight": { + "description": "Architecture group-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "groupHeaderHeight": { + "description": "Architecture group-header height.", + "exclusiveMinimum": 0, + "type": "number" + }, + "groupHeaderSurface": { + "description": "Architecture group-header surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupLabelPaddingX": { + "description": "Horizontal padding around architecture group labels.", + "minimum": 0, + "type": "number" + }, + "groupLetterSpacing": { + "description": "Architecture group-label letter spacing.", + "type": "number" + }, + "groupLineWidth": { + "description": "Architecture group border width.", + "minimum": 0, + "type": "number" + }, + "groupPaddingX": { + "description": "Horizontal padding inside architecture groups.", + "minimum": 0, + "type": "number" + }, + "groupPaddingY": { + "description": "Vertical padding inside architecture groups.", + "minimum": 0, + "type": "number" + }, + "groupSurface": { + "description": "Architecture group surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupText": { + "description": "Architecture group-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupTextTransform": { + "description": "Architecture group-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + }, + "iconSize": { + "description": "Architecture group icon size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "junctionInnerRadius": { + "description": "Architecture junction inner radius.", + "minimum": 0, + "type": "number" + }, + "junctionOuterRadius": { + "description": "Architecture junction outer radius.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceBorder": { + "description": "Architecture service border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceCornerRadius": { + "description": "Architecture service corner radius.", + "minimum": 0, + "type": "number" + }, + "serviceFontSize": { + "description": "Architecture service-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceFontWeight": { + "description": "Architecture service-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "serviceIconSize": { + "description": "Architecture service icon size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceLetterSpacing": { + "description": "Architecture service-label letter spacing.", + "type": "number" + }, + "serviceLineWidth": { + "description": "Architecture service border width.", + "minimum": 0, + "type": "number" + }, + "servicePaddingX": { + "description": "Horizontal padding inside architecture services.", + "minimum": 0, + "type": "number" + }, + "servicePaddingY": { + "description": "Vertical padding inside architecture services.", + "minimum": 0, + "type": "number" + }, + "serviceSurface": { + "description": "Architecture service surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceText": { + "description": "Architecture service-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceTextTransform": { + "description": "Architecture service-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object", + "x-agentic-mermaid-runtime-validator": "architectureVisual" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "this option configures graphical architecture rendering" + }, + "bg": { + "default": "#FFFFFF", + "description": "Background color or CSS variable.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "border": { + "description": "Node and group border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "class": { + "additionalProperties": false, + "description": "Class-diagram rendering controls.", + "properties": { + "hierarchicalNamespaces": { + "default": true, + "description": "Nest namespace compounds.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "class" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "this option configures graphical class layout" + }, + "compact": { + "default": false, + "description": "Compact SVG serialization while preserving agent hooks.", + "type": "boolean", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "compact controls SVG serialization" + }, + "componentSpacing": { + "description": "Spacing between disconnected graph components for compatible extension families; no built-in family currently consumes it.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "embedFontImport": { + "default": true, + "description": "Embed the Google Fonts import in SVG styles; PNG forces this off for offline rasterization.", + "type": "boolean", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output embeds no web-font import" + }, + "fg": { + "default": "#27272A", + "description": "Primary foreground and text color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "font": { + "default": "Inter", + "description": "CSS font family or stack.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "the host terminal owns the font face" + }, + "gantt": { + "additionalProperties": false, + "description": "Gantt dependency and critical-path overlays.", + "properties": { + "criticalPath": { + "default": false, + "description": "Emphasize critical-path tasks and connectors.", + "type": "boolean" + }, + "dependencyArrows": { + "default": false, + "description": "Draw scheduled dependency connectors.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "gantt" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "graphical Gantt connector emphasis is not represented in cells" + }, + "ganttToday": { + "description": "Explicit deterministic date for the Gantt today marker.", + "type": "string", + "x-agentic-mermaid-applicable-builtin-families": [ + "gantt" + ], + "x-agentic-mermaid-terminal": "consumed" + }, + "idPrefix": { + "default": "", + "description": "Namespace generated SVG definition IDs and local references.", + "pattern": "^[A-Za-z0-9_.:-]*$", + "type": "string", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output has no SVG definition ids" + }, + "interactive": { + "default": false, + "description": "Enable hover tooltips for supported chart data points.", + "type": "boolean", + "x-agentic-mermaid-applicable-builtin-families": [ + "xychart", + "pie", + "quadrant" + ], + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal output is a static semantic projection" + }, + "journey": { + "additionalProperties": false, + "description": "User-journey graphical controls.", + "properties": { + "experienceCurve": { + "default": true, + "description": "Connect journey score markers with an experience curve.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "journey" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "experience curves are graphical-only" + }, + "layerSpacing": { + "default": 40, + "description": "Vertical spacing between graph layers.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "class", + "er", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "line": { + "description": "Connector and secondary-line color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "mermaidConfig": { + "additionalProperties": { + "$ref": "#/$defs/jsonValue" + }, + "description": "Mermaid-style recursive runtime configuration.", + "type": "object", + "x-agentic-mermaid-terminal": "consumed" + }, + "muted": { + "description": "Secondary text and label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal themes have no dedicated muted-text role" + }, + "nodeSpacing": { + "default": 24, + "description": "Horizontal spacing between sibling nodes.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "class", + "er", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "padding": { + "default": 40, + "description": "Canvas padding in SVG user units.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses paddingX, paddingY, and boxBorderPadding" + }, + "security": { + "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.", + "enum": [ + "default", + "strict" + ], + "type": "string", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal text has its own control-character and HTML-color safety projection" + }, + "seed": { + "default": 0, + "description": "Deterministic re-roll seed for stochastic Styles.", + "type": "number", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink" + }, + "shadow": { + "default": false, + "description": "Paint explicit drop shadows on node shapes.", + "type": "boolean", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "sequence", + "timeline", + "class", + "er", + "journey", + "xychart", + "pie", + "quadrant", + "gantt", + "mindmap", + "gitgraph" + ], + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "elevation projects to borders and labels" + }, + "style": { + "anyOf": [ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } + ], + "description": "A registered name, inline StyleSpec, or left-to-right stack of either.", + "x-agentic-mermaid-runtime-validator": "styleInput", + "x-agentic-mermaid-terminal": "consumed" + }, + "surface": { + "description": "Node and group surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal cells do not paint graphical surfaces" + }, + "timeline": { + "additionalProperties": false, + "description": "Timeline layout controls.", + "properties": { + "maxWidth": { + "description": "Best-effort width budget for horizontal timelines.", + "exclusiveMinimum": 0, + "type": "number" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "timeline" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth" + }, + "transparent": { + "default": false, + "description": "Omit the painted SVG canvas background.", + "type": "boolean", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal output has no painted canvas background" + }, + "wrappingWidth": { + "description": "Flowchart measured-label wrapping budget in pixels.", + "exclusiveMinimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth" + } + }, + "type": "object" +}
- Changed
render_png22 fields changed- added
Input schema / additionalPropertiesAdded value: +false - changed
Input schema / properties / background / descriptionPrevious value: -"CSS color string (default 'white')."New value: +"Portable basic color or hex color painted behind the raster artifact." - added
Input schema / properties / background / minLengthAdded value: +1 - added
Input schema / properties / background / patternAdded value: +"^\\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*$" - added
Input schema / properties / background / x-agentic-mermaid-receiptAdded value: +"included" - added
Input schema / properties / background / x-agentic-mermaid-runtime-validatorAdded value: +"portablePngBackground" - added
Input schema / properties / background / x-agentic-mermaid-scopeAdded value: +"portable" - added
Input schema / properties / fitToAdded value: +{ + "additionalProperties": false, + "description": "Exactly one output width or height constraint.", + "oneOf": [ + { + "required": [ + "width" + ] + }, + { + "required": [ + "height" + ] + } + ], + "properties": { + "height": { + "description": "Exact output height in integer pixels.", + "minimum": 1, + "type": "integer" + }, + "width": { + "description": "Exact output width in integer pixels.", + "minimum": 1, + "type": "integer" + } + }, + "type": "object", + "x-agentic-mermaid-receipt": "included", + "x-agentic-mermaid-scope": "portable" +} - added
Input schema / properties / optionsAdded value: +{ + "$defs": { + "jsonValue": { + "anyOf": [ + { + "type": "null" + }, + { + "type": "string" + }, + { + "type": "number" + }, + { + "type": "boolean" + }, + { + "items": { + "$ref": "#/$defs/jsonValue" + }, + "type": "array" + }, + { + "additionalProperties": { + "$ref": "#/$defs/jsonValue" + }, + "type": "object" + } + ], + "description": "A finite, acyclic JSON value without prototype keys.", + "x-agentic-mermaid-validation-expectation": "a finite, acyclic JSON value without prototype keys" + } + }, + "$id": "https://agentic-mermaid.dev/schemas/render-options.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "description": "Shared advanced RenderOptions object; compatibility convenience fields above override matching values.", + "properties": { + "accent": { + "description": "Arrowhead, highlight, and data accent color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "architecture": { + "additionalProperties": false, + "description": "Architecture renderer visual metric and paint overrides.", + "properties": { + "visual": { + "additionalProperties": false, + "description": "Sparse architecture visual overrides merged over resolved defaults.", + "properties": { + "edgeBendRadius": { + "description": "Architecture connector bend radius.", + "minimum": 0, + "type": "number" + }, + "edgeFontSize": { + "description": "Architecture connector-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "edgeFontWeight": { + "description": "Architecture connector-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "edgeLetterSpacing": { + "description": "Architecture connector-label letter spacing.", + "type": "number" + }, + "edgeLineWidth": { + "description": "Architecture connector width.", + "minimum": 0, + "type": "number" + }, + "edgeStroke": { + "description": "Architecture connector color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "edgeText": { + "description": "Architecture connector-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "edgeTextTransform": { + "description": "Architecture connector-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + }, + "groupBorder": { + "description": "Architecture group border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupCornerRadius": { + "description": "Architecture group corner radius.", + "minimum": 0, + "type": "number" + }, + "groupFont": { + "description": "Architecture group-label font family.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "groupFontSize": { + "description": "Architecture group-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "groupFontWeight": { + "description": "Architecture group-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "groupHeaderHeight": { + "description": "Architecture group-header height.", + "exclusiveMinimum": 0, + "type": "number" + }, + "groupHeaderSurface": { + "description": "Architecture group-header surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupLabelPaddingX": { + "description": "Horizontal padding around architecture group labels.", + "minimum": 0, + "type": "number" + }, + "groupLetterSpacing": { + "description": "Architecture group-label letter spacing.", + "type": "number" + }, + "groupLineWidth": { + "description": "Architecture group border width.", + "minimum": 0, + "type": "number" + }, + "groupPaddingX": { + "description": "Horizontal padding inside architecture groups.", + "minimum": 0, + "type": "number" + }, + "groupPaddingY": { + "description": "Vertical padding inside architecture groups.", + "minimum": 0, + "type": "number" + }, + "groupSurface": { + "description": "Architecture group surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupText": { + "description": "Architecture group-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupTextTransform": { + "description": "Architecture group-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + }, + "iconSize": { + "description": "Architecture group icon size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "junctionInnerRadius": { + "description": "Architecture junction inner radius.", + "minimum": 0, + "type": "number" + }, + "junctionOuterRadius": { + "description": "Architecture junction outer radius.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceBorder": { + "description": "Architecture service border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceCornerRadius": { + "description": "Architecture service corner radius.", + "minimum": 0, + "type": "number" + }, + "serviceFontSize": { + "description": "Architecture service-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceFontWeight": { + "description": "Architecture service-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "serviceIconSize": { + "description": "Architecture service icon size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceLetterSpacing": { + "description": "Architecture service-label letter spacing.", + "type": "number" + }, + "serviceLineWidth": { + "description": "Architecture service border width.", + "minimum": 0, + "type": "number" + }, + "servicePaddingX": { + "description": "Horizontal padding inside architecture services.", + "minimum": 0, + "type": "number" + }, + "servicePaddingY": { + "description": "Vertical padding inside architecture services.", + "minimum": 0, + "type": "number" + }, + "serviceSurface": { + "description": "Architecture service surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceText": { + "description": "Architecture service-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceTextTransform": { + "description": "Architecture service-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object", + "x-agentic-mermaid-runtime-validator": "architectureVisual" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "this option configures graphical architecture rendering" + }, + "bg": { + "default": "#FFFFFF", + "description": "Background color or CSS variable.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "border": { + "description": "Node and group border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "class": { + "additionalProperties": false, + "description": "Class-diagram rendering controls.", + "properties": { + "hierarchicalNamespaces": { + "default": true, + "description": "Nest namespace compounds.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "class" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "this option configures graphical class layout" + }, + "compact": { + "default": false, + "description": "Compact SVG serialization while preserving agent hooks.", + "type": "boolean", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "compact controls SVG serialization" + }, + "componentSpacing": { + "description": "Spacing between disconnected graph components for compatible extension families; no built-in family currently consumes it.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "embedFontImport": { + "default": true, + "description": "Embed the Google Fonts import in SVG styles; PNG forces this off for offline rasterization.", + "type": "boolean", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output embeds no web-font import" + }, + "fg": { + "default": "#27272A", + "description": "Primary foreground and text color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "font": { + "default": "Inter", + "description": "CSS font family or stack.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "the host terminal owns the font face" + }, + "gantt": { + "additionalProperties": false, + "description": "Gantt dependency and critical-path overlays.", + "properties": { + "criticalPath": { + "default": false, + "description": "Emphasize critical-path tasks and connectors.", + "type": "boolean" + }, + "dependencyArrows": { + "default": false, + "description": "Draw scheduled dependency connectors.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "gantt" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "graphical Gantt connector emphasis is not represented in cells" + }, + "ganttToday": { + "description": "Explicit deterministic date for the Gantt today marker.", + "type": "string", + "x-agentic-mermaid-applicable-builtin-families": [ + "gantt" + ], + "x-agentic-mermaid-terminal": "consumed" + }, + "idPrefix": { + "default": "", + "description": "Namespace generated SVG definition IDs and local references.", + "pattern": "^[A-Za-z0-9_.:-]*$", + "type": "string", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output has no SVG definition ids" + }, + "interactive": { + "default": false, + "description": "Enable hover tooltips for supported chart data points.", + "type": "boolean", + "x-agentic-mermaid-applicable-builtin-families": [ + "xychart", + "pie", + "quadrant" + ], + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal output is a static semantic projection" + }, + "journey": { + "additionalProperties": false, + "description": "User-journey graphical controls.", + "properties": { + "experienceCurve": { + "default": true, + "description": "Connect journey score markers with an experience curve.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "journey" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "experience curves are graphical-only" + }, + "layerSpacing": { + "default": 40, + "description": "Vertical spacing between graph layers.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "class", + "er", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "line": { + "description": "Connector and secondary-line color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "mermaidConfig": { + "additionalProperties": { + "$ref": "#/$defs/jsonValue" + }, + "description": "Mermaid-style recursive runtime configuration.", + "type": "object", + "x-agentic-mermaid-terminal": "consumed" + }, + "muted": { + "description": "Secondary text and label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal themes have no dedicated muted-text role" + }, + "nodeSpacing": { + "default": 24, + "description": "Horizontal spacing between sibling nodes.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "class", + "er", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "padding": { + "default": 40, + "description": "Canvas padding in SVG user units.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses paddingX, paddingY, and boxBorderPadding" + }, + "security": { + "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.", + "enum": [ + "default", + "strict" + ], + "type": "string", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal text has its own control-character and HTML-color safety projection" + }, + "seed": { + "default": 0, + "description": "Deterministic re-roll seed for stochastic Styles.", + "type": "number", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink" + }, + "shadow": { + "default": false, + "description": "Paint explicit drop shadows on node shapes.", + "type": "boolean", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "sequence", + "timeline", + "class", + "er", + "journey", + "xychart", + "pie", + "quadrant", + "gantt", + "mindmap", + "gitgraph" + ], + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "elevation projects to borders and labels" + }, + "style": { + "anyOf": [ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } + ], + "description": "A registered name, inline StyleSpec, or left-to-right stack of either.", + "x-agentic-mermaid-runtime-validator": "styleInput", + "x-agentic-mermaid-terminal": "consumed" + }, + "surface": { + "description": "Node and group surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal cells do not paint graphical surfaces" + }, + "timeline": { + "additionalProperties": false, + "description": "Timeline layout controls.", + "properties": { + "maxWidth": { + "description": "Best-effort width budget for horizontal timelines.", + "exclusiveMinimum": 0, + "type": "number" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "timeline" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth" + }, + "transparent": { + "default": false, + "description": "Omit the painted SVG canvas background.", + "type": "boolean", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal output has no painted canvas background" + }, + "wrappingWidth": { + "description": "Flowchart measured-label wrapping budget in pixels.", + "exclusiveMinimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth" + } + }, + "type": "object" +} - added
Input schema / properties / scale / defaultAdded value: +2 - changed
Input schema / properties / scale / descriptionPrevious value: -"Output scale multiplier (default 2 — retina; clamped to 0.1–8)."New value: +"Positive output scale used when no fitTo constraint is supplied." - added
Input schema / properties / scale / exclusiveMinimumAdded value: +0 - added
Input schema / properties / scale / x-agentic-mermaid-receiptAdded value: +"included" - added
Input schema / properties / scale / x-agentic-mermaid-scopeAdded value: +"portable" - added
Input schema / properties / seed / defaultAdded value: +0 - changed
Input schema / properties / seed / descriptionPrevious value: -"Ink seed for styled looks."New value: +"Deterministic re-roll seed for stochastic Styles." - added
Input schema / properties / seed / x-agentic-mermaid-terminalAdded value: +"not-applicable" - added
Input schema / properties / seed / x-agentic-mermaid-terminal-noteAdded value: +"terminal glyph geometry is deterministic and has no stochastic ink" - added
Input schema / properties / style / anyOfAdded value: +[ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } +] - changed
Input schema / properties / style / descriptionPrevious value: -"Style name | record | stack (same as render_svg). Hosted rasterization bundles the built-in style faces; custom unbundled fonts use Inter with DejaVu per-glyph fallback."New value: +"A registered name, inline StyleSpec, or left-to-right stack of either." - added
Input schema / properties / style / x-agentic-mermaid-runtime-validatorAdded value: +"styleInput" - added
Input schema / properties / style / x-agentic-mermaid-terminalAdded value: +"consumed"
- Changed
render_svg22 fields changed- added
Input schema / additionalPropertiesAdded value: +false - added
Input schema / properties / bg / defaultAdded value: +"#FFFFFF" - changed
Input schema / properties / bg / descriptionPrevious value: -"Background CSS color (overrides theme)."New value: +"Background color or CSS variable." - added
Input schema / properties / bg / x-agentic-mermaid-runtime-validatorAdded value: +"safeCssPaint" - added
Input schema / properties / bg / x-agentic-mermaid-terminalAdded value: +"consumed" - added
Input schema / properties / fg / defaultAdded value: +"#27272A" - changed
Input schema / properties / fg / descriptionPrevious value: -"Foreground CSS color (overrides theme)."New value: +"Primary foreground and text color." - added
Input schema / properties / fg / x-agentic-mermaid-runtime-validatorAdded value: +"safeCssPaint" - added
Input schema / properties / fg / x-agentic-mermaid-terminalAdded value: +"consumed" - added
Input schema / properties / optionsAdded value: +{ + "$defs": { + "jsonValue": { + "anyOf": [ + { + "type": "null" + }, + { + "type": "string" + }, + { + "type": "number" + }, + { + "type": "boolean" + }, + { + "items": { + "$ref": "#/$defs/jsonValue" + }, + "type": "array" + }, + { + "additionalProperties": { + "$ref": "#/$defs/jsonValue" + }, + "type": "object" + } + ], + "description": "A finite, acyclic JSON value without prototype keys.", + "x-agentic-mermaid-validation-expectation": "a finite, acyclic JSON value without prototype keys" + } + }, + "$id": "https://agentic-mermaid.dev/schemas/render-options.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "description": "Shared advanced RenderOptions object; compatibility conveniences override matching values. 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, palette:tufte, tufte-dark), inline record, or left-to-right stack.", + "properties": { + "accent": { + "description": "Arrowhead, highlight, and data accent color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "architecture": { + "additionalProperties": false, + "description": "Architecture renderer visual metric and paint overrides.", + "properties": { + "visual": { + "additionalProperties": false, + "description": "Sparse architecture visual overrides merged over resolved defaults.", + "properties": { + "edgeBendRadius": { + "description": "Architecture connector bend radius.", + "minimum": 0, + "type": "number" + }, + "edgeFontSize": { + "description": "Architecture connector-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "edgeFontWeight": { + "description": "Architecture connector-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "edgeLetterSpacing": { + "description": "Architecture connector-label letter spacing.", + "type": "number" + }, + "edgeLineWidth": { + "description": "Architecture connector width.", + "minimum": 0, + "type": "number" + }, + "edgeStroke": { + "description": "Architecture connector color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "edgeText": { + "description": "Architecture connector-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "edgeTextTransform": { + "description": "Architecture connector-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + }, + "groupBorder": { + "description": "Architecture group border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupCornerRadius": { + "description": "Architecture group corner radius.", + "minimum": 0, + "type": "number" + }, + "groupFont": { + "description": "Architecture group-label font family.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "groupFontSize": { + "description": "Architecture group-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "groupFontWeight": { + "description": "Architecture group-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "groupHeaderHeight": { + "description": "Architecture group-header height.", + "exclusiveMinimum": 0, + "type": "number" + }, + "groupHeaderSurface": { + "description": "Architecture group-header surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupLabelPaddingX": { + "description": "Horizontal padding around architecture group labels.", + "minimum": 0, + "type": "number" + }, + "groupLetterSpacing": { + "description": "Architecture group-label letter spacing.", + "type": "number" + }, + "groupLineWidth": { + "description": "Architecture group border width.", + "minimum": 0, + "type": "number" + }, + "groupPaddingX": { + "description": "Horizontal padding inside architecture groups.", + "minimum": 0, + "type": "number" + }, + "groupPaddingY": { + "description": "Vertical padding inside architecture groups.", + "minimum": 0, + "type": "number" + }, + "groupSurface": { + "description": "Architecture group surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupText": { + "description": "Architecture group-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "groupTextTransform": { + "description": "Architecture group-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + }, + "iconSize": { + "description": "Architecture group icon size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "junctionInnerRadius": { + "description": "Architecture junction inner radius.", + "minimum": 0, + "type": "number" + }, + "junctionOuterRadius": { + "description": "Architecture junction outer radius.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceBorder": { + "description": "Architecture service border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceCornerRadius": { + "description": "Architecture service corner radius.", + "minimum": 0, + "type": "number" + }, + "serviceFontSize": { + "description": "Architecture service-label font size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceFontWeight": { + "description": "Architecture service-label font weight.", + "maximum": 1000, + "minimum": 1, + "type": "number" + }, + "serviceIconSize": { + "description": "Architecture service icon size.", + "exclusiveMinimum": 0, + "type": "number" + }, + "serviceLetterSpacing": { + "description": "Architecture service-label letter spacing.", + "type": "number" + }, + "serviceLineWidth": { + "description": "Architecture service border width.", + "minimum": 0, + "type": "number" + }, + "servicePaddingX": { + "description": "Horizontal padding inside architecture services.", + "minimum": 0, + "type": "number" + }, + "servicePaddingY": { + "description": "Vertical padding inside architecture services.", + "minimum": 0, + "type": "number" + }, + "serviceSurface": { + "description": "Architecture service surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceText": { + "description": "Architecture service-label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint" + }, + "serviceTextTransform": { + "description": "Architecture service-label text transform.", + "enum": [ + "uppercase", + "lowercase", + "capitalize" + ], + "type": "string" + } + }, + "type": "object", + "x-agentic-mermaid-runtime-validator": "architectureVisual" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "this option configures graphical architecture rendering" + }, + "bg": { + "default": "#FFFFFF", + "description": "Background color or CSS variable.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "border": { + "description": "Node and group border color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "class": { + "additionalProperties": false, + "description": "Class-diagram rendering controls.", + "properties": { + "hierarchicalNamespaces": { + "default": true, + "description": "Nest namespace compounds.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "class" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "this option configures graphical class layout" + }, + "compact": { + "default": false, + "description": "Compact SVG serialization while preserving agent hooks.", + "type": "boolean", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "compact controls SVG serialization" + }, + "componentSpacing": { + "description": "Spacing between disconnected graph components for compatible extension families; no built-in family currently consumes it.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "embedFontImport": { + "default": true, + "description": "Embed the Google Fonts import in SVG styles; PNG forces this off for offline rasterization.", + "type": "boolean", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output embeds no web-font import" + }, + "fg": { + "default": "#27272A", + "description": "Primary foreground and text color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "font": { + "default": "Inter", + "description": "CSS font family or stack.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "the host terminal owns the font face" + }, + "gantt": { + "additionalProperties": false, + "description": "Gantt dependency and critical-path overlays.", + "properties": { + "criticalPath": { + "default": false, + "description": "Emphasize critical-path tasks and connectors.", + "type": "boolean" + }, + "dependencyArrows": { + "default": false, + "description": "Draw scheduled dependency connectors.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "gantt" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "graphical Gantt connector emphasis is not represented in cells" + }, + "ganttToday": { + "description": "Explicit deterministic date for the Gantt today marker.", + "type": "string", + "x-agentic-mermaid-applicable-builtin-families": [ + "gantt" + ], + "x-agentic-mermaid-terminal": "consumed" + }, + "idPrefix": { + "default": "", + "description": "Namespace generated SVG definition IDs and local references.", + "pattern": "^[A-Za-z0-9_.:-]*$", + "type": "string", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output has no SVG definition ids" + }, + "interactive": { + "default": false, + "description": "Enable hover tooltips for supported chart data points.", + "type": "boolean", + "x-agentic-mermaid-applicable-builtin-families": [ + "xychart", + "pie", + "quadrant" + ], + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal output is a static semantic projection" + }, + "journey": { + "additionalProperties": false, + "description": "User-journey graphical controls.", + "properties": { + "experienceCurve": { + "default": true, + "description": "Connect journey score markers with an experience curve.", + "type": "boolean" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "journey" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "experience curves are graphical-only" + }, + "layerSpacing": { + "default": 40, + "description": "Vertical spacing between graph layers.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "class", + "er", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "line": { + "description": "Connector and secondary-line color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "consumed" + }, + "mermaidConfig": { + "additionalProperties": { + "$ref": "#/$defs/jsonValue" + }, + "description": "Mermaid-style recursive runtime configuration.", + "type": "object", + "x-agentic-mermaid-terminal": "consumed" + }, + "muted": { + "description": "Secondary text and label color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal themes have no dedicated muted-text role" + }, + "nodeSpacing": { + "default": 24, + "description": "Horizontal spacing between sibling nodes.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "class", + "er", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal layout has a cell-grid spacing contract" + }, + "padding": { + "default": 40, + "description": "Canvas padding in SVG user units.", + "minimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "architecture" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses paddingX, paddingY, and boxBorderPadding" + }, + "security": { + "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.", + "enum": [ + "default", + "strict" + ], + "type": "string", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal text has its own control-character and HTML-color safety projection" + }, + "seed": { + "default": 0, + "description": "Deterministic re-roll seed for stochastic Styles.", + "type": "number", + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal glyph geometry is deterministic and has no stochastic ink" + }, + "shadow": { + "default": false, + "description": "Paint explicit drop shadows on node shapes.", + "type": "boolean", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart", + "state", + "sequence", + "timeline", + "class", + "er", + "journey", + "xychart", + "pie", + "quadrant", + "gantt", + "mindmap", + "gitgraph" + ], + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "elevation projects to borders and labels" + }, + "style": { + "anyOf": [ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } + ], + "description": "A registered name, inline StyleSpec, or left-to-right stack of either.", + "x-agentic-mermaid-runtime-validator": "styleInput", + "x-agentic-mermaid-terminal": "consumed" + }, + "surface": { + "description": "Node and group surface color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssPaint", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal cells do not paint graphical surfaces" + }, + "timeline": { + "additionalProperties": false, + "description": "Timeline layout controls.", + "properties": { + "maxWidth": { + "description": "Best-effort width budget for horizontal timelines.", + "exclusiveMinimum": 0, + "type": "number" + } + }, + "type": "object", + "x-agentic-mermaid-applicable-builtin-families": [ + "timeline" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth" + }, + "transparent": { + "default": false, + "description": "Omit the painted SVG canvas background.", + "type": "boolean", + "x-agentic-mermaid-terminal": "projected", + "x-agentic-mermaid-terminal-note": "terminal output has no painted canvas background" + }, + "wrappingWidth": { + "description": "Flowchart measured-label wrapping budget in pixels.", + "exclusiveMinimum": 0, + "type": "number", + "x-agentic-mermaid-applicable-builtin-families": [ + "flowchart" + ], + "x-agentic-mermaid-terminal": "not-applicable", + "x-agentic-mermaid-terminal-note": "terminal output uses maxWidth or targetWidth" + } + }, + "type": "object" +} - added
Input schema / properties / seed / defaultAdded value: +0 - changed
Input schema / properties / seed / descriptionPrevious value: -"Re-rolls ink wobble of styled looks; never moves layout."New value: +"Deterministic re-roll seed for stochastic Styles." - added
Input schema / properties / seed / x-agentic-mermaid-terminalAdded value: +"not-applicable" - added
Input schema / properties / seed / x-agentic-mermaid-terminal-noteAdded value: +"terminal glyph geometry is deterministic and has no stochastic ink" - added
Input schema / properties / style / anyOfAdded value: +[ + { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + { + "description": "Style stack merged from left to right.", + "items": { + "anyOf": [ + { + "description": "Registered Style or Palette name.", + "type": "string" + }, + { + "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.", + "properties": { + "$schema": { + "description": "Optional JSON Schema pointer for file-backed styles; ignored while rendering.", + "type": "string" + }, + "backdrop": { + "description": "Flat page furniture drawn behind the diagram.", + "enum": [ + "plain", + "paper-ruled", + "grid" + ], + "type": "string" + }, + "blurb": { + "description": "Short human-readable description used by discovery surfaces.", + "type": "string" + }, + "bowing": { + "description": "Rough.js line bowing.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "colors": { + "additionalProperties": false, + "description": "Partial palette of safe, non-fetching CSS color tokens. Runtime validation applies the stricter safe-color policy.", + "properties": { + "accent": { + "description": "Accent paint for emphasis and data series. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "bg": { + "description": "Diagram page background. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "border": { + "description": "Node and group border paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "fg": { + "description": "Primary text and foreground paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "line": { + "description": "Connector and secondary line paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "muted": { + "description": "Muted text and secondary data paint. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + }, + "surface": { + "description": "Node and group surface fill. Must be a safe, non-fetching CSS color.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssColor" + } + }, + "type": "object" + }, + "fill": { + "description": "Fill policy for rough/hybrid rendering; none and solid require a final stack that activates one of those backends.", + "enum": [ + "none", + "hachure", + "solid", + "wash" + ], + "type": "string" + }, + "fillWeight": { + "description": "Hachure line weight; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "font": { + "description": "Safe, non-fetching CSS font family or stack; the rendering environment supplies the font face.", + "type": "string", + "x-agentic-mermaid-runtime-validator": "safeCssFontFamily" + }, + "formatVersion": { + "const": 1, + "description": "Persisted wire-format version. Optional on input and normalized to 1 on output." + }, + "hachureAngle": { + "description": "Hachure line angle in degrees; requires fill hachure in the final stack.", + "maximum": 360, + "minimum": -360, + "type": "number" + }, + "hachureGap": { + "description": "Gap between hachure lines; requires fill hachure in the final stack.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" + }, + "intent": { + "description": "Advisory intent metadata for pickers and quality tooling.", + "enum": [ + "premium", + "draft", + "lofi" + ], + "type": "string" + }, + "mono": { + "description": "Advisory monochrome contract: express tone through shading and weight.", + "type": "boolean" + }, + "name": { + "description": "Canonical look:name or palette:name identity; required only when registering a style.", + "type": "string" + }, + "passes": { + "description": "Number of sketch strokes; 1 is single-pass and 2 is the usual double stroke.", + "maximum": 8, + "minimum": 1, + "type": "integer" + }, + "roughness": { + "description": "Rough.js stroke irregularity.", + "maximum": 10, + "minimum": 0, + "type": "number" + }, + "stroke": { + "description": "Stroke treatment; crisp is the default renderer.", + "enum": [ + "crisp", + "jittered", + "freehand" + ], + "type": "string" + }, + "strokeWidth": { + "description": "Base stroke width in SVG user units.", + "exclusiveMinimum": 0, + "maximum": 20, + "type": "number" + }, + "washEdge": { + "description": "Watercolor edge-darkening opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + }, + "washOpacity": { + "description": "Watercolor glaze opacity; requires fill wash in the final stack.", + "maximum": 1, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + } + ], + "x-agentic-mermaid-validation-expectation": "a registered Style name or StyleSpec" + }, + "type": "array" + } +] - changed
Input schema / properties / style / descriptionPrevious value: -"Style: a name (one of: tufte, hand-drawn, excalidraw, pen-and-ink, freehand, watercolor, blueprint, accessible-high-contrast, patent-drawing, status-dashboard, ops-schematic, chalkboard, risograph, architectural-plan, cupertino, publication-figure; or any theme name), an inline style record, or an array stack merged left → right. A colors-only style is a theme."New value: +"Style: 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, palette:tufte, tufte-dark), inline record, or left-to-right stack." - added
Input schema / properties / style / x-agentic-mermaid-runtime-validatorAdded value: +"styleInput" - added
Input schema / properties / style / x-agentic-mermaid-terminalAdded value: +"consumed" - added
Input schema / properties / theme / deprecatedAdded value: +true - changed
Input schema / properties / theme / descriptionPrevious value: -"Named theme (one of: 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, tufte-dark)."New value: +"Deprecated compatibility input (one of: 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, tufte-dark); use style with a Palette name." - added
Input schema / properties / theme / enumAdded value: +[ + "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", + "tufte-dark" +] - added
Input schema / properties / theme / x-agentic-mermaid-diagnosticAdded value: +{ + "code": "THEME_INPUT_DEPRECATED", + "message": "The render_svg theme field is a legacy compatibility input; use style with a Palette name instead.", + "removal": { + "date": "2027-01-31", + "release": "0.3.0" + } +}
- Changed
verify1 field changed- added
Input schema / additionalPropertiesAdded value: +false
1 tool update
- Changed
execute2 fields changed- added
Input schema / properties / timeoutMs / minimumAdded value: +1 - changed
Input schema / properties / timeoutMs / typePrevious value: -"number"New value: +"integer"
2 tool updates
- Added
describe_sdk - Changed
render_svg1 field changed- changed
Input schema / properties / style / descriptionPrevious value: -"Style: a name (hand-drawn, excalidraw, pen-and-ink, freehand, watercolor, blueprint, tufte, accessible-high-contrast, patent-drawing, status-dashboard, ops-schematic, chalkboard, risograph, architectural-plan, publication-figure, or any theme name), an inline style record, or an array stack merged left → right. A colors-only style is a theme."New value: +"Style: a name (one of: tufte, hand-drawn, excalidraw, pen-and-ink, freehand, watercolor, blueprint, accessible-high-contrast, patent-drawing, status-dashboard, ops-schematic, chalkboard, risograph, architectural-plan, cupertino, publication-figure; or any theme name), an inline style record, or an array stack merged left → right. A colors-only style is a theme."
3 tool updates
- Changed
build1 field changed- changed
Input schema / properties / family / descriptionPrevious value: -"Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt)."New value: +"Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph)."
- Changed
render_ascii1 field changed- added
Input schema / properties / targetWidthAdded value: +{ + "description": "Hard maximum line width in terminal display cells.", + "minimum": 1, + "type": "integer" +}
- Changed
render_png1 field changed- changed
Input schema / properties / style / descriptionPrevious value: -"Style name | record | stack (same as render_svg). Hosted rasterization bundles the built-in style faces; custom unbundled fonts fall back to DejaVu."New value: +"Style name | record | stack (same as render_svg). Hosted rasterization bundles the built-in style faces; custom unbundled fonts use Inter with DejaVu per-glyph fallback."
8 tool updates
- First observed
build - First observed
describe - First observed
execute - First observed
mutate - First observed
render_ascii - First observed
render_png - First observed
render_svg - First observed
verify
Frequently Asked Questions
Claiming proves that you control a remote MCP connector. It does not move, proxy, or interrupt the server.
Open the connector listing, choose Claim ownership, and sign in to Glama.
Complete one verification method:
GitHub identity — fastest for official registry listings. For a namespace such as
io.github.alice/server, link the matching GitHub user, then choose Claim with GitHub. An organization namespace such asio.github.acme/serveralso needs that organization to have installed the Glama AI GitHub App and approved its permissions, because GitHub discloses organization membership only to apps it has installed. Use HTTP or DNS when it has not.HTTP challenge — works when you can deploy a public file. Generate a token, publish the exact JSON Glama shows at
/.well-known/glama.jsonon the same origin as the connector, then choose Check HTTP challenge.DNS challenge — works when you control DNS but cannot change the server. Generate a token, create the exact TXT record Glama shows, wait for it to propagate, then choose Check DNS challenge.
After verification, Glama sends a confirmation email and gives you access to listing details, thumbnails, health checks, and analytics. Keep the HTTP file or DNS record in place: Glama periodically checks it and ownership remains verified while the token is discoverable.
The HTTP ownership file has this structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"claim": "glama_claim_..."
}Claim tokens are opaque, stable, and bound to the signed-in Glama account. They contain no email address or other personal information. If Glama can no longer discover a verified HTTP or DNS token, it starts a seven-day grace period before removing claim-based access. Restore the same token during that period to keep ownership verified. Never publish an email address, Glama session token, GitHub token, or connector credential as ownership proof.
If verification fails, confirm that you copied the current token exactly. The HTTP file must be public, return valid JSON with a successful HTTP response, and stay on the connector's origin. DNS changes may need more time to propagate. A claim cannot transfer to a different origin or hostname: if the connector target changes, Glama starts the grace period and the new target must be claimed separately after the previous claim is released.
For a connector linked to the official MCP Registry, registry updates continue to replace its name, description, and URL by default. After claiming, open Manage connector and enable Use Glama listing details as the source of truth if edits made on Glama should be preserved. Categories and thumbnails are always managed on Glama; registry linkage and technical connection settings continue to sync.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
To improve your MCP server's ranking:
Claim ownership of the server listing
Complete the server profile with an accurate description and thumbnail
Provide a test profile so Glama can connect to and evaluate the server
Keep tool definitions clear and complete to earn a high Tool Definition Quality Score (TDQS)
Route real usage through the Glama Gateway; more recorded successful server uses also improve the ranking
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Connectors
Create and manage Mermaid.js flowcharts and diagrams with AI agents via MCP.
Create, validate, edit, export (markdown/svg/png/mermaid), and search JSON Canvas files.
Generate org charts, MCD/ERD data models, and C4 architecture diagrams — pilot OrgGen AI via MCP.
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI to create, edit, and manage Mermaid diagrams via MCP, with real-time preview in a browser-based editor.3-
- AlicenseAqualityCmaintenanceMCP server for rendering diagrams (Mermaid, Graphviz, PlantUML, D2) via Kroki. Provides tools to render diagrams and list available engines.210MIT
- AlicenseAqualityAmaintenanceMCP Server to previewing mermaid diagrams. https://github.com/veelenga/claude-mermaid/2536203MIT
Try in Browser
Glama MCP Gateway
Add one secure layer between your agents and this server.
TDQS
A4.4/5.0
Disambiguation4/5
Most tools have clear, distinct purposes: build and mutate are separated by create-vs-edit, describe and verify are separated by semantic-explain-vs-validate, and render_* variants differ by output format. The only potential ambiguity is between execute and build/mutate, but the descriptions explicitly steer users away from execute for straightforward structured edits.
Naming Consistency3/5
Tool names mix two conventions: bare verbs (build, describe, execute, mutate, verify) and verb_noun with underscore (describe_sdk, render_ascii, render_png, render_svg). While readable and lower-case throughout, the inconsistency prevents a higher score.
Tool Count5/5
9 tools is well within the 3-15 sweet spot and covers the domain of diagram authoring, editing, inspecting, verifying, and rendering without bloat. Each tool earns its place: build/mutate/execute for editing, describe/verify for analysis, render_* for output, and describe_sdk for schema discovery.
Completeness5/5
The tool set forms a complete lifecycle: create (build), edit (mutate, execute), inspect (describe, verify), and output (render_svg/png/ascii). describe_sdk provides schema discovery so agents can author valid operations. There are no obvious dead ends; even unsupported families are handled gracefully in the broader SDK design.