@diagrammo/dgmo 0.46.0 → 0.48.0

package/src/utils/text-measure.ts

@@ -1,122 +0,0 @@
-// ============================================================
-// Shared text measurement
-// ============================================================
-// One source of truth for "how wide is this string?" Before this
-// module, ~30 renderers/layouts each carried their own char-width
-// estimate (7.5px, 7px, 0.6·fontSize, 0.58, 0.55 …). The drift meant
-// the same label measured differently per chart type — a label could
-// fit inside an org node but overflow an infra node. All sizing,
-// wrapping, and truncation now route through the per-glyph table here.
-
-// Helvetica character width ratios (fraction of fontSize). Replaces the
-// naive `chars * 0.6 * fontSize` estimate with per-character widths.
-// prettier-ignore
-const CHAR_W: Record<string, number> = {
-  ' ':.28,'!': .28,'"': .36,'#': .56,'$': .56,'%': .89,'&': .67,"'":.19,
-  '(':.33,')':.33,'*': .39,'+':.58,',':.28,'-':.33,'.':.28,'/':.28,
-  '0':.56,'1':.56,'2':.56,'3':.56,'4':.56,'5':.56,'6':.56,'7':.56,'8':.56,'9':.56,
-  ':':.28,';':.28,'<':.58,'=':.58,'>':.58,'?':.56,'@':1.02,
-  A:.67,B:.67,C:.72,D:.72,E:.67,F:.61,G:.78,H:.72,I:.28,J:.50,K:.67,L:.56,M:.83,
-  N:.72,O:.78,P:.67,Q:.78,R:.72,S:.67,T:.61,U:.72,V:.67,W:.94,X:.67,Y:.67,Z:.61,
-  a:.56,b:.56,c:.50,d:.56,e:.56,f:.28,g:.56,h:.56,i:.22,j:.22,k:.50,l:.22,m:.83,
-  n:.56,o:.56,p:.56,q:.56,r:.33,s:.50,t:.28,u:.56,v:.50,w:.72,x:.50,y:.50,z:.50,
-};
-const DEFAULT_W = 0.56;
-
-/**
- * Average glyph-width ratio (fraction of fontSize). Only for the rare
- * call site that needs a single scalar (e.g. estimating a max char count
- * up front). Prefer {@link measureText} / {@link wrapTextToWidth} —
- * they account for actual glyph widths.
- */
-export const CHAR_WIDTH_RATIO = DEFAULT_W;
-
-/** Estimate rendered text width using Helvetica proportional character widths. */
-export function measureText(text: string, fontSize: number): number {
-  let w = 0;
-  for (let i = 0; i < text.length; i++) {
-    // charAt returns '' for out-of-bounds, never undefined.
-    w += (CHAR_W[text.charAt(i)] ?? DEFAULT_W) * fontSize;
-  }
-  return w;
-}
-
-/**
- * Truncate text with a trailing ellipsis to fit within maxWidth.
- * Returns the original text if it already fits, or '' if even the
- * ellipsis alone won't fit.
- */
-export function truncateText(
-  text: string,
-  fontSize: number,
-  maxWidth: number
-): string {
-  if (measureText(text, fontSize) <= maxWidth) return text;
-  const ellipsis = '…';
-  const ellipsisW = measureText(ellipsis, fontSize);
-  if (ellipsisW > maxWidth) return '';
-  let lo = 0;
-  let hi = text.length;
-  while (lo < hi) {
-    const mid = Math.ceil((lo + hi) / 2);
-    if (measureText(text.slice(0, mid), fontSize) + ellipsisW <= maxWidth) {
-      lo = mid;
-    } else {
-      hi = mid - 1;
-    }
-  }
-  return lo === 0 ? ellipsis : text.slice(0, lo) + ellipsis;
-}
-
-/**
- * Greedy word-wrap to a pixel width using accurate glyph measurement.
- *
- * - Splits on whitespace; a word that alone exceeds `maxWidth` is kept
- *   whole unless `hardBreak` is set, in which case it is broken at the
- *   character boundary that fits.
- * - Returns at least one line (`['']` for empty input).
- */
-export function wrapTextToWidth(
-  text: string,
-  fontSize: number,
-  maxWidth: number,
-  opts?: { hardBreak?: boolean }
-): string[] {
-  const words = text.split(/\s+/).filter((w) => w.length > 0);
-  if (words.length === 0) return [''];
-  const hardBreak = opts?.hardBreak ?? false;
-  const lines: string[] = [];
-  let current = '';
-  const pushWord = (word: string) => {
-    const test = current ? `${current} ${word}` : word;
-    if (measureText(test, fontSize) <= maxWidth || !current) {
-      current = test;
-    } else {
-      lines.push(current);
-      current = word;
-    }
-  };
-  for (const word of words) {
-    if (hardBreak && measureText(word, fontSize) > maxWidth) {
-      // Break the over-long word into width-fitting chunks.
-      if (current) {
-        lines.push(current);
-        current = '';
-      }
-      let chunk = '';
-      for (const ch of word) {
-        if (chunk && measureText(chunk + ch, fontSize) > maxWidth) {
-          lines.push(chunk);
-          chunk = ch;
-        } else {
-          chunk += ch;
-        }
-      }
-      current = chunk;
-      continue;
-    }
-    pushWord(word);
-  }
-  if (current) lines.push(current);
-  return lines.length > 0 ? lines : [''];
-}

package/src/utils/title-constants.ts

@@ -1,24 +0,0 @@
-// ============================================================
-// Shared chart title constants
-// All renderers import from here to stay in sync.
-// ============================================================
-
-export const TITLE_FONT_SIZE = 20;
-export const TITLE_FONT_WEIGHT = '700';
-export const TITLE_Y = 30;
-export const TITLE_OFFSET = 40;
-
-// Caption — supplementary banner text. The pert renderer wraps caption
-// content in a node-styled rectangle below the diagram body; backward-
-// anchor annotations still render as a free-floating italic line below
-// the title. Pixel `dy` (not `'1.2em'`) so layout math and rendered text
-// never drift between JSDOM and resvg.
-export const CAPTION_FONT_SIZE = 13;
-export const CAPTION_FONT_WEIGHT = '400';
-export const CAPTION_LINE_HEIGHT = 18;
-export const CAPTION_TOP_GAP = 12;
-// Inner padding for the caption rectangle. X = horizontal inset from
-// rect edge to bullet glyph; Y = vertical inset from rect top to first
-// baseline.
-export const CAPTION_BOX_PADDING_X = 16;
-export const CAPTION_BOX_PADDING_Y = 12;

package/src/utils/visual-conventions.ts

@@ -1,61 +0,0 @@
-// ============================================================
-// Visual conventions — shared card/group/collapse constants (Story 111.1)
-// ============================================================
-//
-// Single source of truth for the structured-diagram visual constants described
-// in docs/architecture/diagram-visual-conventions.md. Before this module these
-// values were re-declared in every renderer (NODE_STROKE_WIDTH in 13 files,
-// HEADER_HEIGHT in 12, ...), so a convention change meant editing N files and
-// hoping the snapshots agreed.
-//
-// Two tiers, because the renderers do NOT all agree:
-//
-//   1. UNIVERSAL — identical at every call site. Import these everywhere; never
-//      re-declare. Changing one of these is a deliberate cross-chart change.
-//
-//   2. CONVENTION DEFAULTS — the org/sitemap baseline from the convention. Most
-//      card-shaped renderers match these and should import them. A few have a
-//      DOCUMENTED intentional deviation and keep a local override (with a
-//      comment saying why):
-//        - infra: META_FONT_SIZE 10 / META_LINE_HEIGHT 14 (denser meta rows)
-//        - boxes-and-lines: COLLAPSE_BAR_HEIGHT 4 / SEPARATOR_GAP 4
-//        - cycle, raci: HEADER_HEIGHT 36 (not label+meta cards)
-//      Those overrides are the exception that proves the rule — they stay local
-//      and visible, not hidden inside a re-declared full constant set.
-
-// ── Universal (same value at every site) ──
-
-/** Node card + group border stroke width. */
-export const NODE_STROKE_WIDTH = 1.5;
-/** Edge / connector stroke width. */
-export const EDGE_STROKE_WIDTH = 1.5;
-/** Node card corner radius. */
-export const CARD_RADIUS = 6;
-/** Group / container corner radius. */
-export const CONTAINER_RADIUS = 8;
-/** Collapse accent bar horizontal inset from the card edges. */
-export const COLLAPSE_BAR_INSET = 0;
-
-// ── Convention defaults (org/sitemap baseline; see deviations above) ──
-
-/** Node card header band height. */
-export const HEADER_HEIGHT = 28;
-/** Node card label font size. */
-export const LABEL_FONT_SIZE = 13;
-/** Node card metadata-row font size. */
-export const META_FONT_SIZE = 11;
-/** Node card metadata-row line height. */
-export const META_LINE_HEIGHT = 16;
-/** Gap between the header separator and the first metadata row. */
-export const SEPARATOR_GAP = 6;
-/** Collapse accent bar height. */
-export const COLLAPSE_BAR_HEIGHT = 6;
-
-/** Group / container reserved header band height. */
-export const CONTAINER_HEADER_HEIGHT = 28;
-/** Group / container label font size. */
-export const CONTAINER_LABEL_FONT_SIZE = 13;
-/** Group / container metadata-row font size. */
-export const CONTAINER_META_FONT_SIZE = 11;
-/** Group / container metadata-row line height. */
-export const CONTAINER_META_LINE_HEIGHT = 16;

package/src/utils/wrapped-desc.ts

@@ -1,87 +0,0 @@
-// ============================================================
-// Wrapped Description — shared bullet-aware text wrapping
-// ============================================================
-
-/**
- * One rendered description line. `kind` controls horizontal placement and
- * whether the renderer draws a bullet glyph:
- *  - `plain`        — flush left at the description's left edge
- *  - `bullet-first` — "•" drawn at the left edge, body text at the bullet column
- *  - `bullet-cont`  — body continuation at the bullet column (no glyph)
- *
- * Splitting first-line bullet rendering into separate text elements lets
- * continuation lines align exactly under the first word past the bullet,
- * regardless of font-width estimation drift.
- */
-export interface WrappedDescLine {
-  text: string;
-  kind: 'plain' | 'bullet-first' | 'bullet-cont';
-}
-
-/** Bullet prefix that triggers split-rendering with a hanging body column. */
-export const BULLET_PREFIX = '• ';
-/** Equivalent body-column width in characters (subtracted from wrap width). */
-export const BULLET_INDENT_CHARS = 2;
-
-/**
- * Optional measurer — returns the *display* length of a string in characters.
- * Defaults to `s.length`. Pass a markdown-aware function (stripping link
- * targets, emphasis markers, etc.) when wrapping rich text so the wrap
- * boundary matches what the user will actually see.
- */
-export type LengthFn = (s: string) => number;
-
-/**
- * Word-wrap description lines. Bullet lines (starting with "• ") are split
- * so the renderer can place the "•" glyph at the description's left edge and
- * the body text at a fixed bullet-body column — continuation lines align
- * exactly under the first word past the bullet without depending on
- * font-width estimation.
- */
-export function wrapDescriptionLines(
-  lines: string[],
-  charsPerLine: number,
-  lengthFn: LengthFn = (s) => s.length
-): WrappedDescLine[] {
-  const result: WrappedDescLine[] = [];
-  for (const line of lines) {
-    if (!line.startsWith(BULLET_PREFIX)) {
-      const wrapped = wrapPlainLine(line, charsPerLine, lengthFn);
-      for (const w of wrapped) result.push({ text: w, kind: 'plain' });
-      continue;
-    }
-    // Strip "• " — the renderer draws the bullet glyph; we only wrap the body.
-    const body = line.slice(BULLET_PREFIX.length);
-    const bodyLimit = Math.max(8, charsPerLine - BULLET_INDENT_CHARS);
-    const wrapped = wrapPlainLine(body, bodyLimit, lengthFn);
-    wrapped.forEach((w, i) => {
-      result.push({ text: w, kind: i === 0 ? 'bullet-first' : 'bullet-cont' });
-    });
-  }
-  return result;
-}
-
-/**
- * Greedy word-wrap of a single string at the given character limit.
- * Long words are kept whole even if they exceed the limit (no mid-word break).
- */
-function wrapPlainLine(
-  line: string,
-  charsPerLine: number,
-  lengthFn: LengthFn
-): string[] {
-  const words = line.split(/\s+/);
-  const result: string[] = [];
-  let current = '';
-  for (const word of words) {
-    const test = current ? `${current} ${word}` : word;
-    if (lengthFn(test) > charsPerLine && current) {
-      result.push(current);
-      current = word;
-    } else {
-      current = test;
-    }
-  }
-  if (current) result.push(current);
-  return result;
-}

package/src/venn/parser.ts

@@ -1,18 +0,0 @@
-// ============================================================
-// venn parser door — Story 109.2 (arch-review).
-//
-// The six visualizations share one parse state machine (visualizations/parse.ts);
-// this is venn's typed entry point into it, returning the narrowed
-// ParsedVenn shape. The registry binds the 'venn' chart type to this door.
-// ============================================================
-
-import type { PaletteColors } from '../palettes';
-import { parseVisualization } from '../visualizations/parse';
-import type { ParsedVenn } from '../visualizations/types';
-
-export function parseVenn(
-  content: string,
-  palette?: PaletteColors
-): ParsedVenn {
-  return parseVisualization(content, palette) as ParsedVenn;
-}