@hncode/hncode 0.5.6 → 0.6.0

package/src/mermaid/css-colors.js

@@ -0,0 +1,153 @@
+// Generated by scripts/gen-css-colors.ts from https://drafts.csswg.org/css-color-4/ — do not edit.
+/** The CSS Color 4 named-color table: name → `#rrggbb`. */
+export const NAMED_COLORS = {
+    aliceblue: '#f0f8ff',
+    antiquewhite: '#faebd7',
+    aqua: '#00ffff',
+    aquamarine: '#7fffd4',
+    azure: '#f0ffff',
+    beige: '#f5f5dc',
+    bisque: '#ffe4c4',
+    black: '#000000',
+    blanchedalmond: '#ffebcd',
+    blue: '#0000ff',
+    blueviolet: '#8a2be2',
+    brown: '#a52a2a',
+    burlywood: '#deb887',
+    cadetblue: '#5f9ea0',
+    chartreuse: '#7fff00',
+    chocolate: '#d2691e',
+    coral: '#ff7f50',
+    cornflowerblue: '#6495ed',
+    cornsilk: '#fff8dc',
+    crimson: '#dc143c',
+    cyan: '#00ffff',
+    darkblue: '#00008b',
+    darkcyan: '#008b8b',
+    darkgoldenrod: '#b8860b',
+    darkgray: '#a9a9a9',
+    darkgreen: '#006400',
+    darkgrey: '#a9a9a9',
+    darkkhaki: '#bdb76b',
+    darkmagenta: '#8b008b',
+    darkolivegreen: '#556b2f',
+    darkorange: '#ff8c00',
+    darkorchid: '#9932cc',
+    darkred: '#8b0000',
+    darksalmon: '#e9967a',
+    darkseagreen: '#8fbc8f',
+    darkslateblue: '#483d8b',
+    darkslategray: '#2f4f4f',
+    darkslategrey: '#2f4f4f',
+    darkturquoise: '#00ced1',
+    darkviolet: '#9400d3',
+    deeppink: '#ff1493',
+    deepskyblue: '#00bfff',
+    dimgray: '#696969',
+    dimgrey: '#696969',
+    dodgerblue: '#1e90ff',
+    firebrick: '#b22222',
+    floralwhite: '#fffaf0',
+    forestgreen: '#228b22',
+    fuchsia: '#ff00ff',
+    gainsboro: '#dcdcdc',
+    ghostwhite: '#f8f8ff',
+    gold: '#ffd700',
+    goldenrod: '#daa520',
+    gray: '#808080',
+    green: '#008000',
+    greenyellow: '#adff2f',
+    grey: '#808080',
+    honeydew: '#f0fff0',
+    hotpink: '#ff69b4',
+    indianred: '#cd5c5c',
+    indigo: '#4b0082',
+    ivory: '#fffff0',
+    khaki: '#f0e68c',
+    lavender: '#e6e6fa',
+    lavenderblush: '#fff0f5',
+    lawngreen: '#7cfc00',
+    lemonchiffon: '#fffacd',
+    lightblue: '#add8e6',
+    lightcoral: '#f08080',
+    lightcyan: '#e0ffff',
+    lightgoldenrodyellow: '#fafad2',
+    lightgray: '#d3d3d3',
+    lightgreen: '#90ee90',
+    lightgrey: '#d3d3d3',
+    lightpink: '#ffb6c1',
+    lightsalmon: '#ffa07a',
+    lightseagreen: '#20b2aa',
+    lightskyblue: '#87cefa',
+    lightslategray: '#778899',
+    lightslategrey: '#778899',
+    lightsteelblue: '#b0c4de',
+    lightyellow: '#ffffe0',
+    lime: '#00ff00',
+    limegreen: '#32cd32',
+    linen: '#faf0e6',
+    magenta: '#ff00ff',
+    maroon: '#800000',
+    mediumaquamarine: '#66cdaa',
+    mediumblue: '#0000cd',
+    mediumorchid: '#ba55d3',
+    mediumpurple: '#9370db',
+    mediumseagreen: '#3cb371',
+    mediumslateblue: '#7b68ee',
+    mediumspringgreen: '#00fa9a',
+    mediumturquoise: '#48d1cc',
+    mediumvioletred: '#c71585',
+    midnightblue: '#191970',
+    mintcream: '#f5fffa',
+    mistyrose: '#ffe4e1',
+    moccasin: '#ffe4b5',
+    navajowhite: '#ffdead',
+    navy: '#000080',
+    oldlace: '#fdf5e6',
+    olive: '#808000',
+    olivedrab: '#6b8e23',
+    orange: '#ffa500',
+    orangered: '#ff4500',
+    orchid: '#da70d6',
+    palegoldenrod: '#eee8aa',
+    palegreen: '#98fb98',
+    paleturquoise: '#afeeee',
+    palevioletred: '#db7093',
+    papayawhip: '#ffefd5',
+    peachpuff: '#ffdab9',
+    peru: '#cd853f',
+    pink: '#ffc0cb',
+    plum: '#dda0dd',
+    powderblue: '#b0e0e6',
+    purple: '#800080',
+    rebeccapurple: '#663399',
+    red: '#ff0000',
+    rosybrown: '#bc8f8f',
+    royalblue: '#4169e1',
+    saddlebrown: '#8b4513',
+    salmon: '#fa8072',
+    sandybrown: '#f4a460',
+    seagreen: '#2e8b57',
+    seashell: '#fff5ee',
+    sienna: '#a0522d',
+    silver: '#c0c0c0',
+    skyblue: '#87ceeb',
+    slateblue: '#6a5acd',
+    slategray: '#708090',
+    slategrey: '#708090',
+    snow: '#fffafa',
+    springgreen: '#00ff7f',
+    steelblue: '#4682b4',
+    tan: '#d2b48c',
+    teal: '#008080',
+    thistle: '#d8bfd8',
+    tomato: '#ff6347',
+    turquoise: '#40e0d0',
+    violet: '#ee82ee',
+    wheat: '#f5deb3',
+    white: '#ffffff',
+    whitesmoke: '#f5f5f5',
+    yellow: '#ffff00',
+    yellowgreen: '#9acd32',
+};
+//# sourceMappingURL=css-colors.js.map

package/src/mermaid/diagrams/class.js

@@ -0,0 +1,289 @@
+/**
+ * `classDiagram`: classes with member compartments and UML relations.
+ * Lenient: an unreadable statement is dropped and recorded in `warnings`.
+ *
+ * Compartments live on `Node.sections`: `[title, attrs, methods]`, where the
+ * title is the optional `«annotation»` line followed by the class name.
+ */
+import { Graph, MAX_MEMBERS, parseDir } from '../graph.js';
+import { asciiLower, cleanLabel, decodeHtmlEntities, displayGenerics, isIdChar } from '../labels.js';
+import { layoutClass } from '../layout.js';
+import { firstWord, headerKind, nonEmpty, parseClassAssign, parseClassDef, parseHref, quoteMask, splitColon, splitOnce, statementsOf, takeTags, words, } from '../statements.js';
+export const classDiagram = {
+    kind: 'class',
+    headers: ['classdiagram', 'classdiagram-v2'],
+    render(src) {
+        const graph = parseClass(src);
+        if (graph === null)
+            return null;
+        const canvas = layoutClass(graph);
+        if (canvas === null)
+            return null;
+        return { canvas, warnings: graph.warnings, classDefs: graph.classDefs };
+    },
+};
+/** Relation operators, longest-first so `--|>` wins over `--`. */
+const CLASS_OPS = [
+    ['<|--', 'triangle', 'none', 'solid'],
+    ['--|>', 'none', 'triangle', 'solid'],
+    ['<|..', 'triangle', 'none', 'dotted'],
+    ['..|>', 'none', 'triangle', 'dotted'],
+    ['*--', 'diamondFill', 'none', 'solid'],
+    ['--*', 'none', 'diamondFill', 'solid'],
+    ['o--', 'diamondOpen', 'none', 'solid'],
+    ['--o', 'none', 'diamondOpen', 'solid'],
+    ['<--', 'arrow', 'none', 'solid'],
+    ['-->', 'none', 'arrow', 'solid'],
+    ['<..', 'arrow', 'none', 'dotted'],
+    ['..>', 'none', 'arrow', 'dotted'],
+    ['--', 'none', 'none', 'solid'],
+    ['..', 'none', 'none', 'dotted'],
+];
+const MAX_CLASS_OP = 4;
+export function parseClass(src) {
+    const statements = statementsOf(src);
+    const kind = headerKind(statements);
+    if (kind === null || !classDiagram.headers.includes(kind))
+        return null;
+    const graph = new Graph();
+    /** Declare a class from an id token, attaching any `:::` tags it carries. */
+    const declare = (token) => {
+        const { id, classes } = takeTags(token);
+        const idx = graph.nodeIndex(id, null, 'rect');
+        if (idx !== null) {
+            graph.nodes[idx].sections ??= [[displayGenerics(id)], [], []];
+            for (const cls of classes)
+                graph.addClass(idx, cls);
+        }
+        return idx;
+    };
+    /** The open `{` body: a class index, `'skip'` for a dropped class, or none. */
+    let curClass = null;
+    /** `class A,B name` / `cssClass "A,B" name` assignments, applied post-walk. */
+    const classAssignments = [];
+    /** `link A "url"` / `click A href "url"` targets, applied post-walk. */
+    const hrefs = [];
+    for (const st of statements.slice(1)) {
+        if (curClass !== null) {
+            if (st === '}')
+                curClass = null;
+            else if (curClass !== 'skip')
+                pushMember(graph.nodes[curClass], st);
+            continue;
+        }
+        const first = asciiLower(firstWord(st));
+        if (first === 'direction') {
+            graph.dir = parseDir(words(st)[1] ?? '');
+            continue;
+        }
+        if (first === 'classdef') {
+            const def = parseClassDef(st.slice(firstWord(st).length));
+            if (def)
+                for (const name of def.names)
+                    graph.classDefs[name] = def.props;
+            continue;
+        }
+        if (['note', 'callback', 'style', 'namespace', '}'].includes(first)) {
+            continue;
+        }
+        if (first === 'link' || first === 'click') {
+            const target = parseHref(st.slice(firstWord(st).length));
+            if (target)
+                hrefs.push(target);
+            continue;
+        }
+        if (first === 'cssclass') {
+            const assign = parseClassAssign(st.slice(firstWord(st).length).replace(/"/g, ''));
+            if (assign)
+                classAssignments.push(assign);
+            else
+                graph.drop(st);
+            continue;
+        }
+        if (first === 'class') {
+            const rest = st.slice('class'.length).trim();
+            const open = rest.endsWith('{');
+            let name = open ? rest.slice(0, -1).trim() : rest;
+            // `class A["Label"]` (mermaid ≥10.1): the label titles the box, the id
+            // keys relations. Peel it before the space test — labels carry spaces.
+            let label = null;
+            const labeled = /^(\S+?)\[(.+)\](:::\S+)?$/.exec(name);
+            if (labeled) {
+                name = labeled[1] + (labeled[3] ?? '');
+                label = nonEmpty(cleanLabel(labeled[2]));
+            }
+            if (!open && /\s/.test(name)) {
+                // Class names carry no spaces, so `class Agent focus` is the
+                // assignment form, as in flowcharts.
+                const assign = parseClassAssign(name);
+                if (assign)
+                    classAssignments.push(assign);
+                else
+                    graph.drop(st);
+            }
+            else if (name === '' || /\s/.test(name)) {
+                // A bad declaration that opened a body swallows it whole; reading the
+                // members as top-level statements would misparse everything inside.
+                graph.drop(st);
+                if (open)
+                    curClass = 'skip';
+            }
+            else {
+                const idx = declare(name);
+                if (idx !== null && label !== null) {
+                    const node = graph.nodes[idx];
+                    node.label = label;
+                    // The name is the last title line (an annotation may precede it).
+                    const title = node.sections?.[0];
+                    if (title)
+                        title[title.length - 1] = label;
+                }
+                if (open)
+                    curClass = idx ?? 'skip';
+            }
+        }
+        else if (st.startsWith('<<')) {
+            const split = splitOnce(st.slice(2), '>>');
+            const name = split ? split[1].trim() : '';
+            if (split === null || name === '' || /\s/.test(name)) {
+                graph.drop(st);
+            }
+            else {
+                const idx = declare(name);
+                if (idx !== null)
+                    setAnnotation(graph.nodes[idx], split[0].trim());
+            }
+        }
+        else {
+            const rel = parseClassRelation(st);
+            if (rel !== null) {
+                const f = declare(rel.from);
+                const t = f === null ? null : declare(rel.to);
+                if (f !== null && t !== null) {
+                    graph.pushEdge({
+                        from: f,
+                        to: t,
+                        label: rel.label,
+                        cardFrom: rel.cardFrom,
+                        cardTo: rel.cardTo,
+                        headTo: rel.headTo,
+                        headFrom: rel.headFrom,
+                        line: rel.line,
+                    });
+                }
+            }
+            else {
+                const member = splitColon(st);
+                const id = member ? member[0].trim() : '';
+                const text = member ? member[1].trim() : '';
+                if (member === null || id === '' || /\s/.test(id) || text === '') {
+                    graph.drop(st);
+                }
+                else {
+                    const idx = declare(id);
+                    if (idx !== null)
+                        pushMember(graph.nodes[idx], text);
+                }
+            }
+        }
+        if (graph.truncated !== null) {
+            graph.warnings.push(`diagram truncated: ${graph.truncated}`);
+            break;
+        }
+    }
+    graph.applyClasses(classAssignments);
+    graph.applyHrefs(hrefs);
+    return graph.nodes.length === 0 ? null : graph;
+}
+/** Rewrite the title compartment as `«annotation»` over the class name. */
+function setAnnotation(node, annotation) {
+    ;
+    node.sections[0] = [`«${annotation}»`, displayGenerics(node.label)];
+}
+/** Add a member to the attribute or method compartment, eliding past the cap. */
+export function pushMember(node, raw) {
+    const sections = node.sections;
+    if (raw.startsWith('<<')) {
+        const split = splitOnce(raw.slice(2), '>>');
+        if (split)
+            setAnnotation(node, split[0].trim());
+        return;
+    }
+    const member = decodeHtmlEntities(displayGenerics(raw.trim()));
+    const list = member.includes('(') ? sections[2] : sections[1];
+    if (list.length < MAX_MEMBERS)
+        list.push(member);
+    else if (list.length === MAX_MEMBERS)
+        list.push('…');
+}
+function parseClassRelation(st) {
+    const chars = [...st];
+    // Skip quoted spans, or the `..` inside a cardinality like `"0..*"` would
+    // match the dotted-link operator.
+    const quoted = quoteMask(chars);
+    let found = null;
+    outer: for (let pos = 0; pos < chars.length; pos++) {
+        if (quoted[pos])
+            continue;
+        const tail = chars.slice(pos, pos + MAX_CLASS_OP).join('');
+        for (const [op, headFrom, headTo, line] of CLASS_OPS) {
+            if (!tail.startsWith(op))
+                continue;
+            // `o` is also an identifier character: skip a match glued to a name.
+            if (op.startsWith('o') && pos > 0 && isIdChar(chars[pos - 1]))
+                continue;
+            const after = chars[pos + [...op].length];
+            if (op.endsWith('o') && after !== undefined && isIdChar(after))
+                continue;
+            found = { pos, op, headFrom, headTo, line };
+            break outer;
+        }
+    }
+    if (!found)
+        return null;
+    const lhsRaw = chars.slice(0, found.pos).join('').trim();
+    const rhsRaw = chars
+        .slice(found.pos + [...found.op].length)
+        .join('')
+        .trim();
+    const [lhs, cardFrom] = stripCardinalitySuffix(lhsRaw);
+    const [rhs, cardTo] = stripCardinalityPrefix(rhsRaw);
+    const split = splitColon(rhs);
+    const toId = (split ? split[0] : rhs).trim();
+    const relLabel = split ? nonEmpty(decodeHtmlEntities(split[1].trim())) : null;
+    if (lhs === '' || toId === '' || /\s/.test(lhs) || /\s/.test(toId))
+        return null;
+    return {
+        from: lhs,
+        to: toId,
+        headFrom: found.headFrom,
+        headTo: found.headTo,
+        line: found.line,
+        label: relLabel,
+        cardFrom: cardFrom === '' ? undefined : cardFrom,
+        cardTo: cardTo === '' ? undefined : cardTo,
+    };
+}
+/** `Class "1"` — a quoted cardinality trailing the left-hand name. */
+function stripCardinalitySuffix(s) {
+    const t = s.trimEnd();
+    if (t.endsWith('"')) {
+        const rest = t.slice(0, -1);
+        const q = rest.lastIndexOf('"');
+        if (q !== -1)
+            return [rest.slice(0, q).trimEnd(), rest.slice(q + 1)];
+    }
+    return [t, ''];
+}
+/** `"0..*" Class` — a quoted cardinality leading the right-hand name. */
+function stripCardinalityPrefix(s) {
+    const t = s.trimStart();
+    if (t.startsWith('"')) {
+        const rest = t.slice(1);
+        const q = rest.indexOf('"');
+        if (q !== -1)
+            return [rest.slice(q + 1).trimStart(), rest.slice(0, q)];
+    }
+    return [t, ''];
+}
+//# sourceMappingURL=class.js.map

package/src/mermaid/diagrams/er.js

@@ -0,0 +1,201 @@
+/**
+ * `erDiagram`: entities with attribute compartments and crow's-foot
+ * relationships. Lenient: an unreadable statement is dropped and recorded in
+ * `warnings`.
+ *
+ * Entities use `Node.sections` as `[title, attrs]`.
+ */
+import { Graph, MAX_MEMBERS } from '../graph.js';
+import { cleanLabel, decodeHtmlEntities, displayGenerics } from '../labels.js';
+import { layoutClass } from '../layout.js';
+import { headerKind, nonEmpty, splitOnce, statementsOf, words } from '../statements.js';
+export const er = {
+    kind: 'er',
+    headers: ['erdiagram'],
+    render(src) {
+        const graph = parseEr(src);
+        if (graph === null)
+            return null;
+        const canvas = layoutClass(graph);
+        if (canvas === null)
+            return null;
+        return { canvas, warnings: graph.warnings, classDefs: graph.classDefs };
+    },
+};
+export function parseEr(src) {
+    const statements = statementsOf(src);
+    const kind = headerKind(statements);
+    if (kind === null || !er.headers.includes(kind))
+        return null;
+    const graph = new Graph();
+    /** The open `{` body: an entity index, `'skip'` for a dropped one, or none. */
+    let curEntity = null;
+    for (const st of statements.slice(1)) {
+        if (curEntity !== null) {
+            if (st === '}')
+                curEntity = null;
+            else if (curEntity !== 'skip')
+                pushErAttribute(graph.nodes[curEntity], st);
+            continue;
+        }
+        const rel = splitErRelationship(st);
+        if (rel) {
+            const tokens = erTokens(rel.rel);
+            const op = tokens.length === 3 ? parseErOp(tokens[1]) : null;
+            const f = op === null ? null : erEntity(graph, tokens[0]);
+            const t = f === null ? null : erEntity(graph, tokens[2]);
+            if (op === null || f === null || t === null) {
+                graph.drop(st);
+            }
+            else {
+                const relLabel = rel.label === null ? '' : cleanLabel(rel.label);
+                graph.pushEdge({
+                    from: f,
+                    to: t,
+                    label: nonEmpty(relLabel),
+                    cardFrom: op.cardL,
+                    cardTo: op.cardR,
+                    headTo: 'none',
+                    headFrom: 'none',
+                    line: op.line,
+                });
+            }
+        }
+        else {
+            const open = st.endsWith('{');
+            const decl = open ? st.slice(0, -1).trim() : st;
+            if (decl === '' || erTokens(decl).length !== 1) {
+                // A bad declaration that opened a body swallows it whole; reading the
+                // attributes as top-level statements would misparse everything inside.
+                graph.drop(st);
+                if (open)
+                    curEntity = 'skip';
+            }
+            else {
+                const idx = erEntity(graph, decl);
+                if (open)
+                    curEntity = idx ?? 'skip';
+            }
+        }
+        if (graph.truncated !== null) {
+            graph.warnings.push(`diagram truncated: ${graph.truncated}`);
+            break;
+        }
+    }
+    return graph.nodes.length === 0 ? null : graph;
+}
+/** Resolve an entity token (`NAME`, `"Quoted Name"` or `id[Label]`), keeping
+ * its title row fresh. A quoted name is its own identity; the quotes are not
+ * part of the title. */
+function erEntity(graph, token) {
+    const open = token.startsWith('"') ? -1 : token.indexOf('[');
+    let idx;
+    if (open !== -1) {
+        const id = token.slice(0, open);
+        if (!token.endsWith(']')) {
+            graph.warnings.push(`entity "${id}": alias is missing its closing \`]\``);
+        }
+        const label = cleanLabel(token.slice(open + 1).replace(/\]+$/, ''));
+        if (id === '' || label === '')
+            return null;
+        idx = graph.nodeLabel(id, label);
+    }
+    else if (token.startsWith('"')) {
+        const label = cleanLabel(token);
+        if (label === '')
+            return null;
+        idx = graph.nodeIndex(token, label, 'rect');
+    }
+    else {
+        idx = graph.nodeIndex(token, null, 'rect');
+    }
+    if (idx === null)
+        return null;
+    const node = graph.nodes[idx];
+    node.sections ??= [[], []];
+    node.sections[0] = [displayGenerics(node.label)];
+    return idx;
+}
+/** Whitespace tokens, quoted spans kept whole so aliases may contain spaces. */
+function erTokens(s) {
+    const out = [];
+    let cur = '';
+    let inQuotes = false;
+    for (const c of s) {
+        if (c === '"') {
+            inQuotes = !inQuotes;
+            cur += c;
+        }
+        else if (!inQuotes && /\s/.test(c)) {
+            if (cur !== '') {
+                out.push(cur);
+                cur = '';
+            }
+        }
+        else {
+            cur += c;
+        }
+    }
+    if (cur !== '')
+        out.push(cur);
+    return out;
+}
+function splitErRelationship(st) {
+    const split = splitOnce(st, ':');
+    const rel = split ? split[0] : st;
+    const label = split ? split[1].trim() : null;
+    return erTokens(rel).some((t) => parseErOp(t) !== null) ? { rel, label } : null;
+}
+const isAscii = (s) => {
+    for (let i = 0; i < s.length; i++)
+        if (s.charCodeAt(i) > 0x7f)
+            return false;
+    return true;
+};
+/** A crow's-foot operator: two cardinality glyphs around `--` or `..`. */
+function parseErOp(tok) {
+    if (tok.length !== 6 || !isAscii(tok))
+        return null;
+    const mid = tok.slice(2, 4);
+    const line = mid === '--' ? 'solid' : mid === '..' ? 'dotted' : null;
+    if (line === null)
+        return null;
+    const cardL = erCard(tok.slice(0, 2));
+    const cardR = erCard(tok.slice(4, 6));
+    return cardL === null || cardR === null ? null : { cardL, cardR, line };
+}
+function erCard(tok) {
+    switch (tok) {
+        case '|o':
+        case 'o|':
+            return '0..1';
+        case '||':
+            return '1';
+        case '}o':
+        case 'o{':
+            return '*';
+        case '}|':
+        case '|{':
+            return '1..*';
+        default:
+            return null;
+    }
+}
+/** ER attributes are `type name`; a trailing quoted comment is dropped. */
+export function pushErAttribute(node, raw) {
+    const attrs = node.sections[1];
+    const parts = [];
+    for (const tok of words(raw)) {
+        if (tok.startsWith('"'))
+            break;
+        parts.push(tok);
+    }
+    if (parts.length === 0)
+        return;
+    const line = decodeHtmlEntities(parts.join(' '));
+    if (attrs.length < MAX_MEMBERS)
+        attrs.push(line);
+    else if (attrs.length === MAX_MEMBERS)
+        attrs.push('…');
+}
+//# sourceMappingURL=er.js.map