@zombie-mermaid/mermaid-parser 4.0.0 → 4.2.0

package/dist/index.d.cts

@@ -5,6 +5,7 @@ import { NodeShape } from '@zombie-mermaid/core';
 import { Point } from '@zombie-mermaid/core';
 import { Statement } from '@zombie-mermaid/core';
 import { StyleDirectives } from '@zombie-mermaid/core';
+import { toDirection } from '@zombie-mermaid/core';
 
 /** Narrow rectangle on a lifeline showing active processing */
 export declare interface Activation {
@@ -655,6 +656,21 @@ export declare function parseExpandedMeta(body: string): ExpandedNodeMeta;
  */
 export declare function parseGenericTypes(input: string): string;
 
+/**
+ * Parse Mermaid text into a logical graph structure.
+ * Auto-detects diagram type (flowchart or state diagram).
+ * Throws on invalid/unsupported input.
+ */
+export declare function parseMermaid(text: string): MermaidGraph;
+
+/**
+ * Parse Mermaid pie chart source text.
+ *
+ * Throws `Line N: …` errors (the shape the MCP diagnostics expect) for
+ * anything Mermaid's own parser would reject.
+ */
+export declare function parsePieChart(text: string): PieChart;
+
 /**
  * Parse a Mermaid sequence diagram.
  * Expects the first line to be "sequenceDiagram".
@@ -682,6 +698,32 @@ export declare interface ParticipantBox {
     actorIds: string[];
 }
 
+/** A parsed Mermaid pie chart. */
+export declare interface PieChart {
+    /** `title …`, either on the `pie` header line or on its own line. */
+    title?: string;
+    /** `accTitle: …` accessible title. */
+    accTitle?: string;
+    /** `accDescr: …` or multi-line `accDescr { … }` accessible description. */
+    accDescr?: string;
+    /** `pie showData` — show each slice's raw value next to its legend label. */
+    showData: boolean;
+    /**
+     * Slices in source order. A label that repeats keeps its first value and
+     * position; later duplicates are ignored, as in Mermaid. May be empty:
+     * Mermaid accepts a bare `pie` with no slices.
+     */
+    slices: PieSlice[];
+}
+
+/** One slice of a pie chart, in source order. */
+export declare interface PieSlice {
+    /** Slice label, with its surrounding quotes removed and escapes resolved. */
+    label: string;
+    /** Slice value. Never negative; zero is allowed (Mermaid accepts it). */
+    value: number;
+}
+
 export declare interface PlotArea {
     x: number;
     y: number;
@@ -979,6 +1021,72 @@ export declare interface PositionedParticipantBox {
     height: number;
 }
 
+export declare interface PositionedPieChart {
+    width: number;
+    height: number;
+    /** Pie centre. */
+    cx: number;
+    cy: number;
+    /** Slice radius. */
+    radius: number;
+    /** Radius of the outline circle drawn around the pie. */
+    outerRadius: number;
+    /** Title text and its anchor (text-anchor middle, alphabetic baseline). */
+    title?: {
+        text: string;
+        x: number;
+        y: number;
+    };
+    /** Drawn slices, in source order. */
+    slices: PositionedPieSlice[];
+    /** Legend rows, one per parsed slice, in source order. */
+    legend: PositionedPieLegendItem[];
+    /** `accTitle`, carried through for the SVG accessible name. */
+    accTitle?: string;
+    /** `accDescr`, carried through for the SVG `<desc>`. */
+    accDescr?: string;
+}
+
+/** One legend row: a colour swatch and its label. Every slice gets one. */
+export declare interface PositionedPieLegendItem {
+    /** Row text: the label, or `label [value]` when `showData` is on. */
+    text: string;
+    colorIndex: number;
+    /** Top-left corner of the square swatch. */
+    x: number;
+    y: number;
+    /** Swatch side length. */
+    size: number;
+    /** Text anchor (text-anchor start, alphabetic baseline). */
+    textX: number;
+    textY: number;
+}
+
+/** One drawn slice. Slices under 1% of the total are never positioned. */
+export declare interface PositionedPieSlice {
+    /** Slice label (as parsed). */
+    label: string;
+    /** Slice value (as parsed). */
+    value: number;
+    /**
+     * Palette slot: the slice's index among *all* slices in source order,
+     * modulo 12 — Mermaid's `pie1`..`pie12` colour scale is keyed by every
+     * label, including slices too small to draw, and wraps after 12.
+     */
+    colorIndex: number;
+    /** Start angle, radians clockwise from 12 o'clock. */
+    startAngle: number;
+    /** End angle, radians clockwise from 12 o'clock. */
+    endAngle: number;
+    /** SVG path data for the wedge (or full circle for a 100% slice). */
+    path: string;
+    /** Percentage label, `((value / total) * 100).toFixed(0) + '%'` as in Mermaid. */
+    percentText: string;
+    /** Anchor of the percentage label (text-anchor middle, alphabetic baseline). */
+    labelX: number;
+    labelY: number;
+}
+
 export declare interface PositionedSequenceDiagram {
     width: number;
     height: number;
@@ -1071,6 +1179,8 @@ export declare interface SequenceDiagram {
  */
 export declare function toBlockType(value: string): Block['type'];
 
+export { toDirection }
+
 /** Greedy word wrap; a word longer than `width` stays on its own line. */
 export declare function wrapC4Text(text: string, width: number): string[];
 

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { NodeShape } from '@zombie-mermaid/core';
 import { Point } from '@zombie-mermaid/core';
 import { Statement } from '@zombie-mermaid/core';
 import { StyleDirectives } from '@zombie-mermaid/core';
+import { toDirection } from '@zombie-mermaid/core';
 
 /** Narrow rectangle on a lifeline showing active processing */
 export declare interface Activation {
@@ -655,6 +656,21 @@ export declare function parseExpandedMeta(body: string): ExpandedNodeMeta;
  */
 export declare function parseGenericTypes(input: string): string;
 
+/**
+ * Parse Mermaid text into a logical graph structure.
+ * Auto-detects diagram type (flowchart or state diagram).
+ * Throws on invalid/unsupported input.
+ */
+export declare function parseMermaid(text: string): MermaidGraph;
+
+/**
+ * Parse Mermaid pie chart source text.
+ *
+ * Throws `Line N: …` errors (the shape the MCP diagnostics expect) for
+ * anything Mermaid's own parser would reject.
+ */
+export declare function parsePieChart(text: string): PieChart;
+
 /**
  * Parse a Mermaid sequence diagram.
  * Expects the first line to be "sequenceDiagram".
@@ -682,6 +698,32 @@ export declare interface ParticipantBox {
     actorIds: string[];
 }
 
+/** A parsed Mermaid pie chart. */
+export declare interface PieChart {
+    /** `title …`, either on the `pie` header line or on its own line. */
+    title?: string;
+    /** `accTitle: …` accessible title. */
+    accTitle?: string;
+    /** `accDescr: …` or multi-line `accDescr { … }` accessible description. */
+    accDescr?: string;
+    /** `pie showData` — show each slice's raw value next to its legend label. */
+    showData: boolean;
+    /**
+     * Slices in source order. A label that repeats keeps its first value and
+     * position; later duplicates are ignored, as in Mermaid. May be empty:
+     * Mermaid accepts a bare `pie` with no slices.
+     */
+    slices: PieSlice[];
+}
+
+/** One slice of a pie chart, in source order. */
+export declare interface PieSlice {
+    /** Slice label, with its surrounding quotes removed and escapes resolved. */
+    label: string;
+    /** Slice value. Never negative; zero is allowed (Mermaid accepts it). */
+    value: number;
+}
+
 export declare interface PlotArea {
     x: number;
     y: number;
@@ -979,6 +1021,72 @@ export declare interface PositionedParticipantBox {
     height: number;
 }
 
+export declare interface PositionedPieChart {
+    width: number;
+    height: number;
+    /** Pie centre. */
+    cx: number;
+    cy: number;
+    /** Slice radius. */
+    radius: number;
+    /** Radius of the outline circle drawn around the pie. */
+    outerRadius: number;
+    /** Title text and its anchor (text-anchor middle, alphabetic baseline). */
+    title?: {
+        text: string;
+        x: number;
+        y: number;
+    };
+    /** Drawn slices, in source order. */
+    slices: PositionedPieSlice[];
+    /** Legend rows, one per parsed slice, in source order. */
+    legend: PositionedPieLegendItem[];
+    /** `accTitle`, carried through for the SVG accessible name. */
+    accTitle?: string;
+    /** `accDescr`, carried through for the SVG `<desc>`. */
+    accDescr?: string;
+}
+
+/** One legend row: a colour swatch and its label. Every slice gets one. */
+export declare interface PositionedPieLegendItem {
+    /** Row text: the label, or `label [value]` when `showData` is on. */
+    text: string;
+    colorIndex: number;
+    /** Top-left corner of the square swatch. */
+    x: number;
+    y: number;
+    /** Swatch side length. */
+    size: number;
+    /** Text anchor (text-anchor start, alphabetic baseline). */
+    textX: number;
+    textY: number;
+}
+
+/** One drawn slice. Slices under 1% of the total are never positioned. */
+export declare interface PositionedPieSlice {
+    /** Slice label (as parsed). */
+    label: string;
+    /** Slice value (as parsed). */
+    value: number;
+    /**
+     * Palette slot: the slice's index among *all* slices in source order,
+     * modulo 12 — Mermaid's `pie1`..`pie12` colour scale is keyed by every
+     * label, including slices too small to draw, and wraps after 12.
+     */
+    colorIndex: number;
+    /** Start angle, radians clockwise from 12 o'clock. */
+    startAngle: number;
+    /** End angle, radians clockwise from 12 o'clock. */
+    endAngle: number;
+    /** SVG path data for the wedge (or full circle for a 100% slice). */
+    path: string;
+    /** Percentage label, `((value / total) * 100).toFixed(0) + '%'` as in Mermaid. */
+    percentText: string;
+    /** Anchor of the percentage label (text-anchor middle, alphabetic baseline). */
+    labelX: number;
+    labelY: number;
+}
+
 export declare interface PositionedSequenceDiagram {
     width: number;
     height: number;
@@ -1071,6 +1179,8 @@ export declare interface SequenceDiagram {
  */
 export declare function toBlockType(value: string): Block['type'];
 
+export { toDirection }
+
 /** Greedy word wrap; a word longer than `width` stays on its own line. */
 export declare function wrapC4Text(text: string, width: number): string[];