@zombie-mermaid/svg-renderer 4.1.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';
@@ -376,6 +378,9 @@ export declare function layoutFlowchartSync(rawGraph: MermaidGraph, options?: Fl
  */
 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.
@@ -406,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`.
  *
@@ -514,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';
@@ -376,6 +378,9 @@ export declare function layoutFlowchartSync(rawGraph: MermaidGraph, options?: Fl
  */
 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.
@@ -406,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`.
  *
@@ -514,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.
  *