@zombie-mermaid/svg-renderer 4.0.0 → 4.2.0

package/dist/index.d.cts

@@ -12,11 +12,13 @@ import { FlowchartRenderOptions } from '@zombie-mermaid/core';
 import { LayoutCache } from '@zombie-mermaid/core';
 import { LayoutOptions } from 'elkjs';
 import { MermaidGraph } from '@zombie-mermaid/core';
+import { PieChart } from '@zombie-mermaid/mermaid-parser';
 import { Point } from '@zombie-mermaid/core';
 import { PositionedClassDiagram } from '@zombie-mermaid/mermaid-parser';
 import { PositionedErDiagram } from '@zombie-mermaid/mermaid-parser';
 import { PositionedGraph } from '@zombie-mermaid/core';
 import { PositionedNode } from '@zombie-mermaid/core';
+import { PositionedPieChart } from '@zombie-mermaid/mermaid-parser';
 import { PositionedSequenceDiagram } from '@zombie-mermaid/mermaid-parser';
 import { PositionedXYChart } from '@zombie-mermaid/mermaid-parser';
 import { RenderOptions } from '@zombie-mermaid/core';
@@ -95,6 +97,14 @@ export declare function buildElkLeafNode(id: string, size: {
     height: number;
 }, label?: string): ElkNode;
 
+/**
+ * SVG `<style>` block for a diagram: core's `buildStyleBlock` plus, when
+ * `hasMonoFont` is set, the self-hosted mono font subset for the `.mono`
+ * rule. The subset lives here rather than in `core` because only SVG output
+ * embeds it (#1319).
+ */
+export declare function buildSvgStyleBlock(font: string, hasMonoFont: boolean, nonce?: string): string;
+
 /**
  * Layout id for the i-th note. A class id is a run of non-whitespace
  * (`\S+` in the parser), so an id containing a space can never collide
@@ -360,7 +370,7 @@ export declare function layoutErDiagramSync(diagram: ErDiagram, options?: ErRend
  * drop-in for it wherever the graph is a flowchart. Other diagram types that
  * share the engine (state, architecture) keep using `layoutGraphSync`.
  */
-export declare function layoutFlowchartSync(graph: MermaidGraph, options?: FlowchartRenderOptions): PositionedGraph;
+export declare function layoutFlowchartSync(rawGraph: MermaidGraph, options?: FlowchartRenderOptions): PositionedGraph;
 
 /**
  * Lay out a parsed MermaidGraph using ELK.js (synchronous).
@@ -368,6 +378,9 @@ export declare function layoutFlowchartSync(graph: MermaidGraph, options?: Flowc
  */
 export declare function layoutGraphSync(graph: MermaidGraph, options?: FlowchartRenderOptions): PositionedGraph;
 
+/** Lay out a parsed pie chart. Options are accepted for registry parity; none apply. */
+export declare function layoutPieChart(chart: PieChart, _options?: unknown): PositionedPieChart;
+
 /**
  * Lay out a parsed sequence diagram.
  * Returns a fully positioned diagram ready for SVG rendering.
@@ -398,6 +411,33 @@ export declare const NODE_PADDING: {
     readonly diamondExtra: 24;
 };
 
+/** Mermaid pieRenderer.ts constants (default config and default theme). */
+export declare const PIE: {
+    /** Frame height; the pie's own width equals it. */
+    readonly height: 450;
+    readonly margin: 40;
+    readonly legendRectSize: 18;
+    readonly legendSpacing: 4;
+    /** `pie.textPosition` default: label distance as a fraction of the radius. */
+    readonly textPosition: 0.75;
+    /** `pieOuterStrokeWidth`; the outline circle sits half of it outside the pie. */
+    readonly outerStrokeWidth: 2;
+    /** `pieTitleTextSize` */
+    readonly titleFontSize: 25;
+    /** `pieSectionTextSize` */
+    readonly sectionFontSize: 17;
+    /** `pieLegendTextSize` */
+    readonly legendFontSize: 17;
+    readonly fontWeight: 400;
+    /** Mermaid's `pie1`..`pie12` scale wraps after this many colours. */
+    readonly paletteSize: 12;
+    /** Slices below this percentage of the total are not drawn. */
+    readonly minPercent: 1;
+};
+
+/** CSS value for palette slot `index`: slot 0 follows `--accent` live. */
+export declare function pieColorValue(index: number, accent: string | undefined, bg: string): string;
+
 /**
  * Build the `d` attribute for an edge's routed points under `curve`.
  *
@@ -506,6 +546,16 @@ export declare function renderMermaidSVGAsync(text: string, options?: RenderOpti
 /** @deprecated Use `renderMermaidSVG` */
 export declare const renderMermaidSync: typeof renderMermaidSVG;
 
+/**
+ * Render a positioned pie chart as an SVG string.
+ *
+ * The accessible name is `title` (from `options.title`) when given,
+ * otherwise the chart's own `accTitle`; `accDescr` becomes the root
+ * `<desc>`. Both are dropped when `decorative` is set — see svgOpenTag() in
+ * packages/core/src/theme.ts.
+ */
+export declare function renderPieSvg(chart: PositionedPieChart, colors: DiagramColors, font?: string, transparent?: boolean, embedSource?: string, title?: string, decorative?: boolean, emit?: SvgEmitOptions): string;
+
 /**
  * Render a positioned sequence diagram as an SVG string.
  *

package/dist/index.d.ts

@@ -12,11 +12,13 @@ import { FlowchartRenderOptions } from '@zombie-mermaid/core';
 import { LayoutCache } from '@zombie-mermaid/core';
 import { LayoutOptions } from 'elkjs';
 import { MermaidGraph } from '@zombie-mermaid/core';
+import { PieChart } from '@zombie-mermaid/mermaid-parser';
 import { Point } from '@zombie-mermaid/core';
 import { PositionedClassDiagram } from '@zombie-mermaid/mermaid-parser';
 import { PositionedErDiagram } from '@zombie-mermaid/mermaid-parser';
 import { PositionedGraph } from '@zombie-mermaid/core';
 import { PositionedNode } from '@zombie-mermaid/core';
+import { PositionedPieChart } from '@zombie-mermaid/mermaid-parser';
 import { PositionedSequenceDiagram } from '@zombie-mermaid/mermaid-parser';
 import { PositionedXYChart } from '@zombie-mermaid/mermaid-parser';
 import { RenderOptions } from '@zombie-mermaid/core';
@@ -95,6 +97,14 @@ export declare function buildElkLeafNode(id: string, size: {
     height: number;
 }, label?: string): ElkNode;
 
+/**
+ * SVG `<style>` block for a diagram: core's `buildStyleBlock` plus, when
+ * `hasMonoFont` is set, the self-hosted mono font subset for the `.mono`
+ * rule. The subset lives here rather than in `core` because only SVG output
+ * embeds it (#1319).
+ */
+export declare function buildSvgStyleBlock(font: string, hasMonoFont: boolean, nonce?: string): string;
+
 /**
  * Layout id for the i-th note. A class id is a run of non-whitespace
  * (`\S+` in the parser), so an id containing a space can never collide
@@ -360,7 +370,7 @@ export declare function layoutErDiagramSync(diagram: ErDiagram, options?: ErRend
  * drop-in for it wherever the graph is a flowchart. Other diagram types that
  * share the engine (state, architecture) keep using `layoutGraphSync`.
  */
-export declare function layoutFlowchartSync(graph: MermaidGraph, options?: FlowchartRenderOptions): PositionedGraph;
+export declare function layoutFlowchartSync(rawGraph: MermaidGraph, options?: FlowchartRenderOptions): PositionedGraph;
 
 /**
  * Lay out a parsed MermaidGraph using ELK.js (synchronous).
@@ -368,6 +378,9 @@ export declare function layoutFlowchartSync(graph: MermaidGraph, options?: Flowc
  */
 export declare function layoutGraphSync(graph: MermaidGraph, options?: FlowchartRenderOptions): PositionedGraph;
 
+/** Lay out a parsed pie chart. Options are accepted for registry parity; none apply. */
+export declare function layoutPieChart(chart: PieChart, _options?: unknown): PositionedPieChart;
+
 /**
  * Lay out a parsed sequence diagram.
  * Returns a fully positioned diagram ready for SVG rendering.
@@ -398,6 +411,33 @@ export declare const NODE_PADDING: {
     readonly diamondExtra: 24;
 };
 
+/** Mermaid pieRenderer.ts constants (default config and default theme). */
+export declare const PIE: {
+    /** Frame height; the pie's own width equals it. */
+    readonly height: 450;
+    readonly margin: 40;
+    readonly legendRectSize: 18;
+    readonly legendSpacing: 4;
+    /** `pie.textPosition` default: label distance as a fraction of the radius. */
+    readonly textPosition: 0.75;
+    /** `pieOuterStrokeWidth`; the outline circle sits half of it outside the pie. */
+    readonly outerStrokeWidth: 2;
+    /** `pieTitleTextSize` */
+    readonly titleFontSize: 25;
+    /** `pieSectionTextSize` */
+    readonly sectionFontSize: 17;
+    /** `pieLegendTextSize` */
+    readonly legendFontSize: 17;
+    readonly fontWeight: 400;
+    /** Mermaid's `pie1`..`pie12` scale wraps after this many colours. */
+    readonly paletteSize: 12;
+    /** Slices below this percentage of the total are not drawn. */
+    readonly minPercent: 1;
+};
+
+/** CSS value for palette slot `index`: slot 0 follows `--accent` live. */
+export declare function pieColorValue(index: number, accent: string | undefined, bg: string): string;
+
 /**
  * Build the `d` attribute for an edge's routed points under `curve`.
  *
@@ -506,6 +546,16 @@ export declare function renderMermaidSVGAsync(text: string, options?: RenderOpti
 /** @deprecated Use `renderMermaidSVG` */
 export declare const renderMermaidSync: typeof renderMermaidSVG;
 
+/**
+ * Render a positioned pie chart as an SVG string.
+ *
+ * The accessible name is `title` (from `options.title`) when given,
+ * otherwise the chart's own `accTitle`; `accDescr` becomes the root
+ * `<desc>`. Both are dropped when `decorative` is set — see svgOpenTag() in
+ * packages/core/src/theme.ts.
+ */
+export declare function renderPieSvg(chart: PositionedPieChart, colors: DiagramColors, font?: string, transparent?: boolean, embedSource?: string, title?: string, decorative?: boolean, emit?: SvgEmitOptions): string;
+
 /**
  * Render a positioned sequence diagram as an SVG string.
  *