@diagrammo/dgmo 0.64.1 → 0.66.0

package/dist/chart-meta-CpicJ1kj.d.ts

@@ -0,0 +1,239 @@
+import './dgmo-router-EAW7XiBE.js';
+import { a as PaletteColors, T as TagGroup, D as DgmoError } from './tag-groups-NUA2F1I5.js';
+
+/** Convert hex (#RRGGBB or #RGB) to { h, s, l } with h in degrees, s/l as percentages. */
+declare function hexToHSL(hex: string): {
+    h: number;
+    s: number;
+    l: number;
+};
+/** Convert { h (degrees), s (%), l (%) } back to #RRGGBB hex string. */
+declare function hslToHex(h: number, s: number, l: number): string;
+/** Convert hex to "H S% L%" string for CSS custom properties. */
+declare function hexToHSLString(hex: string): string;
+/**
+ * Blend a color toward white (light mode quadrant fills).
+ * amount: 0 = original, 1 = white
+ */
+declare function tint(hex: string, amount: number): string;
+/**
+ * Blend a color toward a dark base (dark mode quadrant fills).
+ * amount: 0 = original, 1 = base
+ */
+declare function shade(hex: string, base: string, amount: number): string;
+/**
+ * Blend two hex colors by percentage.
+ * `pct` = 0 → 100% of `b`, `pct` = 100 → 100% of `a`.
+ *
+ * Used by all renderers for tinted fills and strokes.
+ */
+declare function mix(a: string, b: string, pct: number): string;
+/**
+ * Pick `lightText` or `darkText` for placement on top of `bg`.
+ *
+ * Three-tier decision:
+ *  1. **High-luminance fill (luminance > 0.55)** → `darkText`. Yellows, peaches,
+ *     light cyans — dark text reads better and a light cream on light yellow is
+ *     unreadable.
+ *  2. **Pastel fill (min RGB channel ≥ 100, luminance ≤ 0.55)** → defer to WCAG
+ *     ratio. Pastels have no near-zero channel and tend to read as "soft" —
+ *     dark text usually wins by ratio (catppuccin dark mauve `#cba6f7` min 166,
+ *     ratio 9.35:1; tokyo-night dark red `#f7768e` min 118, ratio 7.86:1; and
+ *     tokyo-night green `#9ece6a` min 106, ratio 11.4:1 all correctly pick dark).
+ *  3. **Saturated fill (min RGB < 100, luminance ≤ 0.55)** → `lightText`. At least
+ *     one channel near zero signals true saturation — gruvbox dark green
+ *     `#b8bb26` (min 38), blueprint blue `#1f5e8c` (min 31), bold red/blue
+ *     (min 0), solarized blue `#268bd2` (min 38). The user consistently
+ *     prefers light text on these for visual punch.
+ *
+ * `min RGB` discriminates pastel-vs-saturated more reliably than `max-min`
+ * (vibrance): tokyo-night and catppuccin dark are pastels with high max RGB,
+ * so vibrance alone misclassifies them as "saturated."
+ *
+ * Tinted fills (luminance ~0.7+ in light themes / ~0.02–0.14 in dark themes)
+ * are unambiguous in either branch; only fill-solid output shifts here.
+ */
+declare function contrastText(bg: string, lightText: string, darkText: string): string;
+declare function shapeFill(palette: PaletteColors, intent: string, isDark: boolean, opts?: {
+    mode?: 'solid' | 'outline' | undefined;
+}): string;
+/**
+ * Derive the 8-color series rotation from a palette's named colors, in the
+ * shared {@link CATEGORICAL_COLOR_ORDER} (RGB-seeded, max-contrast). Tag
+ * swatches and chart series colors thus share one canonical rotation.
+ */
+declare function getSeriesColors(palette: PaletteColors): string[];
+
+interface OrgNode {
+    readonly id: string;
+    readonly label: string;
+    readonly metadata: Readonly<Record<string, string>>;
+    readonly children: readonly OrgNode[];
+    readonly parentId: string | null;
+    readonly isContainer: boolean;
+    readonly lineNumber: number;
+    readonly color?: string;
+}
+interface ParsedOrg {
+    readonly title: string | null;
+    readonly titleLineNumber: number | null;
+    readonly roots: readonly OrgNode[];
+    readonly tagGroups: readonly TagGroup[];
+    readonly options: Readonly<Record<string, string>>;
+    /**
+     * Resolved layout direction (§7.5). `direction-lr` / `direction-tb` are a
+     * mutually-exclusive boolean pair (§1.9, last one wins). Defaults to 'TB',
+     * which is the orientation org charts have always rendered.
+     */
+    readonly direction: 'LR' | 'TB';
+    readonly diagnostics: readonly DgmoError[];
+    readonly error: string | null;
+}
+declare function parseOrg(content: string, palette?: PaletteColors): ParsedOrg;
+
+/**
+ * Substitute `start-date now` with the host-local resolved date.
+ * Pass the result to `encodeDiagramUrl` so the share-link captures
+ * the resolved date, not the literal token.
+ *
+ * Lines without `start-date now` (explicit-date lines, comments,
+ * other directives, activity lines containing the word "now") pass
+ * through verbatim.
+ */
+declare function normalizePertSourceForShare(dsl: string): string;
+
+/**
+ * Shared parser utilities — extracted from individual parsers to eliminate
+ * duplication of measureIndent, extractColor, header regexes, and
+ * pipe-metadata parsing.
+ */
+
+/**
+ * Complete set of recognized chart type identifiers.
+ *
+ * Derived from `chart-types.ts`, which is a leaf module — importing the
+ * chart-type *registry* here would be circular, since the registry imports
+ * every parser and 34 parsers import this file.
+ */
+declare const ALL_CHART_TYPES: ReadonlySet<string>;
+/**
+ * Cross-chart fill treatment (spec §1.9 fill family). Absent ⇒ the canonical
+ * 25% tint (`fill-tint` is the explicit spelling of that default).
+ */
+type FillMode = 'solid' | 'outline';
+/**
+ * Parse the first non-empty, non-comment line to extract chart type and optional title.
+ * The first token is matched against `ALL_CHART_TYPES`; the remainder is the title.
+ *
+ * Returns `null` if the first token is not a recognized chart type.
+ */
+declare function parseFirstLine(line: string): {
+    chartType: string;
+    title: string | undefined;
+} | null;
+
+/** Marker alphabet member for any variant. */
+type RaciMarker = 'R' | 'A' | 'S' | 'C' | 'I' | 'D';
+/** Variant identifier — selects alphabet + constraint rule set. */
+type RaciVariant = 'raci' | 'rasci' | 'daci';
+/**
+ * One `Role: <markers>` line under a task.
+ *
+ * `id` is the normalized role key — used by mutations to look up the
+ * cell and by validation to detect unknown roles. `displayName` is the
+ * first-seen casing/spacing for rendering.
+ */
+interface RaciRoleAssignment {
+    readonly id: string;
+    readonly displayName: string;
+    readonly markers: readonly RaciMarker[];
+    readonly lineNumber: number;
+    readonly endLineNumber: number;
+}
+/** One task — flush-left under a phase or directly under the chart. */
+interface RaciTask {
+    readonly id: string;
+    readonly displayName: string;
+    readonly description: string;
+    readonly roleAssignments: readonly RaciRoleAssignment[];
+    readonly lineNumber: number;
+    readonly endLineNumber: number;
+}
+/** Optional `[Phase Label]` group header — one level deep. */
+interface RaciPhase {
+    readonly id: string;
+    readonly displayName: string;
+    /** Optional palette color from a `[Label](color)` suffix on the bracket. */
+    readonly color?: string;
+    readonly tasks: readonly RaciTask[];
+    readonly lineNumber: number;
+    readonly endLineNumber: number;
+}
+/** Top-level parse result. */
+interface ParsedRaci {
+    readonly type: 'raci';
+    /** Optional title from the chart-type header line. */
+    readonly title?: string;
+    readonly titleLineNumber?: number;
+    /** Variant selected by directive, or by chart-type id when absent. */
+    readonly variant: RaciVariant;
+    /**
+     * Canonical column order. Populated either from an explicit
+     * `roles:` directive or, when absent, from first-seen role usage.
+     */
+    readonly roles: readonly string[];
+    /** Display name for each role (parallel to `roles`). */
+    readonly roleDisplayNames: readonly string[];
+    /**
+     * Optional per-role palette color from the `Cap blue` trailing-token
+     * suffix in the roles block (or the long pipe form `Cap | color: blue`).
+     * Parallel to `roles`; entries default to `undefined` (renderer falls
+     * back to the neutral column tint).
+     */
+    readonly roleColors: ReadonlyArray<string | undefined>;
+    readonly phases: readonly RaciPhase[];
+    /** Tasks declared without a parent phase. */
+    readonly tasksWithoutPhase: readonly RaciTask[];
+    readonly options: Readonly<Record<string, string>>;
+    readonly diagnostics: readonly DgmoError[];
+    readonly error: string | null;
+}
+
+/**
+ * Parse RACI/RASCI/DACI source. The leading chart-type id (if a
+ * recognized variant id) acts as a hint for default variant when the
+ * `variant` directive is absent.
+ */
+declare function parseRaci(content: string, palette?: PaletteColors): ParsedRaci;
+
+/**
+ * Async or sync file reader. Receives an absolute path, returns content.
+ * Throwing means "file not found".
+ */
+type ReadFileFn = (path: string) => string | Promise<string>;
+/** Tracks the original source file and line for an imported line. */
+interface ImportSource {
+    /** Absolute path of the file this line originates from */
+    filePath: string;
+    /** 1-based line number in the original (pre-resolution) source file */
+    sourceLine: number;
+}
+interface ResolveImportsResult {
+    content: string;
+    diagnostics: DgmoError[];
+    /** resolvedLine (1-based index) → originalLine (1-based) or null for inserted lines */
+    lineMap: (number | null)[];
+    /** resolvedLine (1-based index) → import source info or null for non-imported lines */
+    importSourceMap: (ImportSource | null)[];
+}
+/**
+ * Pre-processes org chart content, resolving `tags` and `import` directives.
+ *
+ * @param content   - Raw .dgmo file content
+ * @param filePath  - Absolute path of the file (for relative path resolution)
+ * @param readFileFn - Function to read files (sync or async)
+ * @returns Merged content with all imports resolved + diagnostics
+ */
+declare function resolveOrgImports(content: string, filePath: string, readFileFn: ReadFileFn): Promise<ResolveImportsResult>;
+
+export { ALL_CHART_TYPES as A, type FillMode as F, type ImportSource as I, type OrgNode as O, type ParsedOrg as P, type RaciMarker as R, type ParsedRaci as a, type RaciVariant as b, type RaciTask as c, type RaciPhase as d, type RaciRoleAssignment as e, type ReadFileFn as f, type ResolveImportsResult as g, contrastText as h, getSeriesColors as i, hexToHSL as j, hexToHSLString as k, hslToHex as l, mix as m, normalizePertSourceForShare as n, parseOrg as o, parseFirstLine as p, parseRaci as q, resolveOrgImports as r, shade as s, shapeFill as t, tint as u };

package/dist/chart-meta.d.ts

@@ -0,0 +1,3 @@
+export { C as ChartTypeId, a as ChartTypeMeta, c as chartTypes, f as getAvailablePalettes, g as getPalette, l as parseDgmoChartType } from './dgmo-router-EAW7XiBE.js';
+export { A as ALL_CHART_TYPES, O as OrgNode, P as ParsedOrg, k as hexToHSLString, n as normalizePertSourceForShare, p as parseFirstLine, o as parseOrg, q as parseRaci, r as resolveOrgImports } from './chart-meta-CpicJ1kj.js';
+export { C as CompactViewState, h as DecodedDiagramUrl, i as EncodeDiagramUrlOptions, j as EncodeDiagramUrlResult, a as PaletteColors, l as decodeDiagramUrl, m as decodeViewState, n as encodeDiagramUrl, o as encodeViewState } from './tag-groups-NUA2F1I5.js';

package/dist/chart-meta.js

@@ -10,7 +10,7 @@ import {
 } from "./chunk-U7VO6JAA.js";
 import {
   parseDgmoChartType
-} from "./chunk-AA4M6F2P.js";
+} from "./chunk-BBY57XAA.js";
 import "./chunk-2CMM36O7.js";
 import "./chunk-A2RUBBVT.js";
 import "./chunk-JWJBWNQL.js";
@@ -42,7 +42,7 @@ import "./chunk-OLPWKS5L.js";
 import "./chunk-NMIWEUIG.js";
 import "./chunk-VXBEG3IB.js";
 import "./chunk-3TYUXC7D.js";
-import "./chunk-6BVIZW5N.js";
+import "./chunk-FLFBY5GN.js";
 import "./chunk-QMYJO4EL.js";
 import "./chunk-4GQ6I46C.js";
 import "./chunk-INLEOJIX.js";
@@ -59,7 +59,7 @@ import "./chunk-7TF3QOOD.js";
 import "./chunk-SR7NGZNM.js";
 import "./chunk-NXMESY4J.js";
 import "./chunk-EK4QX7NQ.js";
-import "./chunk-NKRVFQGO.js";
+import "./chunk-BDI25HWH.js";
 import "./chunk-QE4GTFZS.js";
 import "./chunk-7NK42OIB.js";
 import "./chunk-RRX4Z4TH.js";

package/dist/{charts-d3-ZTXJWEHI.js → charts-d3-I6OE5K3B.js}

@@ -2,16 +2,16 @@ import {
   D3_DATA_CHART_TYPES,
   renderDataChartD3,
   supportsD3DataChart
-} from "./chunk-7T3A2UK3.js";
-import "./chunk-CVVICCSB.js";
-import "./chunk-67D4MN2H.js";
-import "./chunk-6VJCURWU.js";
+} from "./chunk-5T7K6QND.js";
+import "./chunk-L65WI4HO.js";
+import "./chunk-LK6LTSLH.js";
+import "./chunk-J2EXBAPZ.js";
 import "./chunk-RU2HHHYA.js";
 import "./chunk-A4GOY3PE.js";
-import "./chunk-ES66QH6J.js";
-import "./chunk-Z5ID35YP.js";
-import "./chunk-SCJ7CAJF.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-FG24NXKN.js";
+import "./chunk-UTCPNJND.js";
+import "./chunk-3HOCNSPD.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-XC7BUB3P.js";
 import "./chunk-2CW5ZTNH.js";
 import "./chunk-MDI5FMWO.js";
@@ -26,4 +26,4 @@ export {
   renderDataChartD3,
   supportsD3DataChart
 };
-//# sourceMappingURL=charts-d3-ZTXJWEHI.js.map
+//# sourceMappingURL=charts-d3-I6OE5K3B.js.map

package/dist/{chunk-C6DMG2V6.js → chunk-27YPE7NO.js}

@@ -14,17 +14,17 @@ import {
 } from "./chunk-A4GOY3PE.js";
 import {
   renderIntegratedLegend
-} from "./chunk-RBAW7VUG.js";
+} from "./chunk-2EPV7CLY.js";
 import {
   FONT_FAMILY
-} from "./chunk-Z5ID35YP.js";
+} from "./chunk-UTCPNJND.js";
 import {
   LEGEND_HEIGHT
-} from "./chunk-SCJ7CAJF.js";
+} from "./chunk-3HOCNSPD.js";
 import {
   measureText,
   wrapTextToWidth
-} from "./chunk-4ASYQ347.js";
+} from "./chunk-MTGGOCND.js";
 import {
   fillModeFromOptions
 } from "./chunk-P2PUWV3Y.js";
@@ -90,7 +90,8 @@ function computeCycleLayout(parsed, options) {
     const hasDesc = !hideDescriptions && node.description.length > 0;
     const labelWidth = Math.max(
       MIN_NODE_WIDTH,
-      measureText(node.label, LABEL_FONT_SIZE) + NODE_PAD_X * 2
+      // Node labels draw at 600; the description lines under them do not.
+      measureText(node.label, LABEL_FONT_SIZE, { bold: true }) + NODE_PAD_X * 2
     );
     if (circleNodes) {
       return computeCircleNodeDims(node, hasDesc);
@@ -351,7 +352,7 @@ function renderedDescNodeHeight(numLines, scale) {
 }
 var EDGE_LABEL_MAX_WIDTH = 197;
 function wrapEdgeLabelText(label, description, maxWidth = EDGE_LABEL_MAX_WIDTH) {
-  const labelLines = label ? wrapTextToWidth(label, EDGE_LABEL_FONT_SIZE, maxWidth) : [];
+  const labelLines = label ? wrapTextToWidth(label, EDGE_LABEL_FONT_SIZE, maxWidth, { bold: true }) : [];
   const descLines = [];
   for (const d of description) {
     descLines.push(...wrapTextToWidth(d, EDGE_LABEL_FONT_SIZE, maxWidth));
@@ -360,7 +361,9 @@ function wrapEdgeLabelText(label, description, maxWidth = EDGE_LABEL_MAX_WIDTH)
 }
 function computeCircleNodeDims(node, hasDesc) {
   if (!hasDesc) {
-    const textW = measureText(node.label, CIRCLE_LABEL_FONT_SIZE);
+    const textW = measureText(node.label, CIRCLE_LABEL_FONT_SIZE, {
+      bold: true
+    });
     const r2 = Math.max(MIN_CIRCLE_RADIUS, textW / 2 + CIRCLE_PAD);
     return { width: r2 * 2, height: r2 * 2, wrappedDesc: [] };
   }
@@ -370,7 +373,9 @@ function computeCircleNodeDims(node, hasDesc) {
     const totalLines = 1 + wrappedDesc2.length;
     const textBlockH = totalLines * DESC_LINE_HEIGHT + CIRCLE_PAD;
     if (textBlockH / 2 <= r * 0.85) {
-      const labelW = measureText(node.label, CIRCLE_LABEL_FONT_SIZE);
+      const labelW = measureText(node.label, CIRCLE_LABEL_FONT_SIZE, {
+        bold: true
+      });
       const labelY = -textBlockH / 2 + DESC_LINE_HEIGHT;
       const availW = 2 * Math.sqrt(Math.max(0, r * r - labelY * labelY));
       if (labelW <= availW - CIRCLE_PAD) {
@@ -492,7 +497,10 @@ function computeEdgePaths(layoutNodes, parsed, cx, cy, radius, isClockwise) {
     const lineCount = labelLines.length + descLines.length;
     let labelPxW = 0;
     for (const l of labelLines)
-      labelPxW = Math.max(labelPxW, measureText(l, EDGE_LABEL_FONT_SIZE));
+      labelPxW = Math.max(
+        labelPxW,
+        measureText(l, EDGE_LABEL_FONT_SIZE, { bold: true })
+      );
     for (const l of descLines)
       labelPxW = Math.max(labelPxW, measureText(l, EDGE_LABEL_FONT_SIZE));
     const { labelX, labelY, labelAngle } = computeEdgeLabelPosition(
@@ -596,7 +604,10 @@ function fitToCanvas(nodes, edges, parsed, _cx, _cy, radius, width, height, _isC
     );
     let textWidth = 0;
     for (const l of labelLines)
-      textWidth = Math.max(textWidth, measureText(l, EDGE_LABEL_FONT_SIZE));
+      textWidth = Math.max(
+        textWidth,
+        measureText(l, EDGE_LABEL_FONT_SIZE, { bold: true })
+      );
     for (const l of descLines)
       textWidth = Math.max(textWidth, measureText(l, EDGE_LABEL_FONT_SIZE));
     if (textWidth === 0) continue;
@@ -907,7 +918,12 @@ function renderCycle(container, parsed, palette, isDark, onClickItem, exportDims
     const lineCount = labelLines.length + descLines.length;
     let maxLineW = 0;
     for (const l of labelLines)
-      maxLineW = Math.max(maxLineW, measureText(l, scaledEdgeLabelFont));
+      maxLineW = Math.max(
+        maxLineW,
+        // The label block is drawn at 600, the description lines below at the
+        // default weight — so only these measure bold.
+        measureText(l, scaledEdgeLabelFont, { bold: true })
+      );
     for (const l of descLines)
       maxLineW = Math.max(maxLineW, measureText(l, scaledDescFont));
     const bgW = maxLineW + 12;
@@ -969,4 +985,4 @@ export {
   renderCycle,
   renderCycleForExport
 };
-//# sourceMappingURL=chunk-C6DMG2V6.js.map
+//# sourceMappingURL=chunk-27YPE7NO.js.map

package/dist/{chunk-RBAW7VUG.js → chunk-2EPV7CLY.js}

@@ -1,10 +1,9 @@
 import {
   computeLegendLayout
-} from "./chunk-ES66QH6J.js";
+} from "./chunk-FG24NXKN.js";
 import {
-  FONT_CENTRAL_DY,
   FONT_FAMILY
-} from "./chunk-Z5ID35YP.js";
+} from "./chunk-UTCPNJND.js";
 import {
   CONTROLS_ICON_PATH,
   LEGEND_DOT_R,
@@ -16,7 +15,7 @@ import {
   LEGEND_TOGGLE_OFF_OPACITY,
   legendChromeColors,
   measureLegendText
-} from "./chunk-SCJ7CAJF.js";
+} from "./chunk-3HOCNSPD.js";
 import {
   tagAttrKey
 } from "./chunk-MDI5FMWO.js";
@@ -25,9 +24,8 @@ import {
 } from "./chunk-42IT4BG2.js";
 
 // src/utils/legend-d3.ts
-var LEGEND_TEXT_DY = `${FONT_CENTRAL_DY}em`;
 function centerText(sel) {
-  return sel.attr("dy", LEGEND_TEXT_DY);
+  return sel.attr("dominant-baseline", "central");
 }
 function renderLegendD3(container, config, state, palette, isDark, callbacks, containerWidth) {
   const width = containerWidth ?? parseFloat(container.attr("width") || "800");
@@ -293,4 +291,4 @@ export {
   renderLegendD3,
   renderIntegratedLegend
 };
-//# sourceMappingURL=chunk-RBAW7VUG.js.map
+//# sourceMappingURL=chunk-2EPV7CLY.js.map

package/dist/{chunk-SCJ7CAJF.js → chunk-3HOCNSPD.js}

@@ -1,7 +1,7 @@
 import {
   measureText,
   truncateText
-} from "./chunk-4ASYQ347.js";
+} from "./chunk-MTGGOCND.js";
 import {
   mix
 } from "./chunk-42IT4BG2.js";
@@ -59,4 +59,4 @@ export {
   LEGEND_TOGGLE_OFF_OPACITY,
   LEGEND_GEAR_PILL_W
 };
-//# sourceMappingURL=chunk-SCJ7CAJF.js.map
+//# sourceMappingURL=chunk-3HOCNSPD.js.map