hex-audit 0.6.3 → 0.8.0

package/dist/diagrams/excalidraw.js

@@ -0,0 +1,219 @@
+/**
+ * Scene → Excalidraw file (`.excalidraw`, opens in the dashboard, excalidraw.com
+ * and the VS Code extension). Text is bound inside its container, arrows are
+ * bound to shapes, and every element that stands for a protocol entity carries
+ * `customData.hexRef` so the dashboard can link it to code, notes and cards.
+ */
+import crypto from 'node:crypto';
+/** Excalifont: the hand-drawn default font in Excalidraw 0.18. */
+const FONT = 5;
+const ROUGHNESS = 1;
+const INK = '#1e293b';
+const SHAPE_STYLE = {
+    title: { stroke: INK, fill: 'transparent', width: 1 },
+    takeaway: { stroke: '#475569', fill: 'transparent', width: 1 },
+    actor: { stroke: '#4338ca', fill: '#e0e7ff', width: 2 },
+    holding: { stroke: '#b45309', fill: '#fef3c7', width: 2 },
+    function: { stroke: '#334155', fill: '#f1f5f9', width: 1 },
+    state: { stroke: '#0e7490', fill: '#ecfeff', width: 2 },
+    'state-terminal': { stroke: '#0e7490', fill: '#cffafe', width: 4 },
+    term: { stroke: '#4338ca', fill: '#eef2ff', width: 2 },
+    participant: { stroke: '#334155', fill: '#f8fafc', width: 2 },
+    header: { stroke: '#475569', fill: 'transparent', width: 1 },
+    cell: { stroke: '#cbd5e1', fill: 'transparent', width: 1 },
+    dot: { stroke: '#4338ca', fill: '#4338ca', width: 1 },
+    'worst-case': { stroke: '#9f1239', fill: 'transparent', width: 1 },
+    equation: { stroke: INK, fill: 'transparent', width: 1 },
+    risk: { stroke: '#dc2626', fill: '#fee2e2', width: 2, dash: true },
+    note: { stroke: '#64748b', fill: '#f8fafc', width: 1, dash: true },
+    'callout-risk': { stroke: '#dc2626', fill: '#dc2626', width: 1, font: '#ffffff' },
+    'callout-note': { stroke: '#64748b', fill: '#64748b', width: 1, font: '#ffffff' },
+    label: { stroke: INK, fill: 'transparent', width: 1 },
+};
+const ARROW_STYLE = {
+    move: { stroke: '#b45309', width: 2 },
+    transition: { stroke: '#0e7490', width: 2 },
+    increase: { stroke: '#047857', width: 2 },
+    decrease: { stroke: '#b91c1c', width: 2 },
+    set: { stroke: '#4338ca', width: 2 },
+    call: { stroke: INK, width: 2 },
+    callback: { stroke: '#7c3aed', width: 2, dash: 'dashed' },
+    oracle: { stroke: '#0369a1', width: 2, dash: 'dotted' },
+    transfer: { stroke: '#b45309', width: 2 },
+    state: { stroke: '#64748b', width: 1, dash: 'dotted' },
+    annotation: { stroke: '#dc2626', width: 1, dash: 'dashed' },
+    lifeline: { stroke: '#94a3b8', width: 1, dash: 'dashed' },
+    rule: { stroke: '#e2e8f0', width: 1 },
+};
+function stableId(ns, id) {
+    return crypto.createHash('sha1').update(`${ns}:${id}`).digest('base64url').slice(0, 20);
+}
+function seedOf(id) {
+    return parseInt(crypto.createHash('sha1').update(id).digest('hex').slice(0, 8), 16) % 2 ** 31;
+}
+function base(id, type, x, y, w, h) {
+    return {
+        id,
+        type,
+        x,
+        y,
+        width: w,
+        height: h,
+        angle: 0,
+        strokeColor: INK,
+        backgroundColor: 'transparent',
+        fillStyle: 'solid',
+        strokeWidth: 1,
+        strokeStyle: 'solid',
+        roughness: ROUGHNESS,
+        opacity: 100,
+        groupIds: [],
+        frameId: null,
+        roundness: null,
+        seed: seedOf(id),
+        version: 1,
+        versionNonce: seedOf(id + ':n'),
+        isDeleted: false,
+        boundElements: null,
+        updated: 1,
+        link: null,
+        locked: false,
+    };
+}
+function textEl(id, s, text, fontSize, color, containerId) {
+    return {
+        ...base(id, 'text', s.x, s.y, s.w, s.h),
+        strokeColor: color,
+        text,
+        originalText: text,
+        fontSize,
+        fontFamily: FONT,
+        textAlign: containerId ? 'center' : 'left',
+        verticalAlign: containerId ? 'middle' : 'top',
+        containerId,
+        autoResize: true,
+        lineHeight: 1.25,
+    };
+}
+export function toExcalidraw(scene, meta) {
+    const elements = [];
+    const shapeEl = new Map();
+    const ns = meta.name;
+    for (const s of scene.shapes) {
+        const st = SHAPE_STYLE[s.style];
+        const id = stableId(ns, `shape:${s.id}`);
+        if (s.kind === 'text') {
+            const t = textEl(id, s, s.label, s.fontSize, st.stroke, null);
+            if (s.style === 'title')
+                t.fontSize = s.fontSize;
+            if (s.ref)
+                t.customData = { hexRef: s.ref, hexNode: s.id };
+            elements.push(t);
+            shapeEl.set(s.id, t);
+            continue;
+        }
+        const el = {
+            ...base(id, s.kind === 'ellipse' ? 'ellipse' : 'rectangle', s.x, s.y, s.w, s.h),
+            strokeColor: st.stroke,
+            backgroundColor: st.fill,
+            strokeWidth: st.width,
+            strokeStyle: st.dash ? 'dashed' : 'solid',
+            roundness: s.kind === 'rect' ? { type: 3 } : null,
+            customData: { hexNode: s.id, ...(s.ref ? { hexRef: s.ref } : {}) },
+        };
+        elements.push(el);
+        shapeEl.set(s.id, el);
+        if (s.label) {
+            const tid = stableId(ns, `label:${s.id}`);
+            const lines = s.label.split('\n');
+            const th = Math.ceil(lines.length * s.fontSize * 1.25);
+            const tw = Math.ceil(Math.max(...lines.map((l) => l.length)) * s.fontSize * 0.6);
+            elements.push(textEl(tid, { x: s.x + (s.w - tw) / 2, y: s.y + (s.h - th) / 2, w: tw, h: th }, s.label, s.fontSize, st.font ?? INK, id));
+            el.boundElements = [{ id: tid, type: 'text' }];
+        }
+    }
+    for (const a of scene.arrows) {
+        const st = ARROW_STYLE[a.style];
+        const id = stableId(ns, `arrow:${a.id}`);
+        const [x0, y0] = a.points[0];
+        const rel = a.points.map(([x, y]) => [x - x0, y - y0]);
+        const xs = rel.map((p) => p[0]);
+        const ys = rel.map((p) => p[1]);
+        const el = {
+            ...base(id, a.line ? 'line' : 'arrow', x0, y0, Math.max(...xs) - Math.min(...xs), Math.max(...ys) - Math.min(...ys)),
+            strokeColor: st.stroke,
+            strokeWidth: st.width,
+            strokeStyle: st.dash ?? 'solid',
+            roughness: a.line ? 0 : ROUGHNESS,
+            roundness: a.points.length > 2 ? { type: 2 } : null,
+            points: rel,
+            lastCommittedPoint: null,
+            startArrowhead: null,
+            endArrowhead: a.line ? null : 'arrow',
+            ...(a.ref ? { customData: { hexRef: a.ref } } : {}),
+        };
+        if (!a.line) {
+            el.elbowed = false;
+            const from = a.from ? shapeEl.get(a.from) : undefined;
+            const to = a.to ? shapeEl.get(a.to) : undefined;
+            el.startBinding =
+                from && from.type !== 'text'
+                    ? { elementId: from.id, focus: a.startFocus ?? 0, gap: 6 }
+                    : null;
+            el.endBinding =
+                to && to.type !== 'text' ? { elementId: to.id, focus: a.endFocus ?? 0, gap: 6 } : null;
+            for (const end of [from, to]) {
+                if (end && end.type !== 'text')
+                    end.boundElements = [...(end.boundElements ?? []), { id, type: 'arrow' }];
+            }
+        }
+        elements.push(el);
+        if (a.label && !a.line) {
+            const tid = stableId(ns, `arrowlabel:${a.id}`);
+            const lines = a.label.split('\n');
+            const fs = 14;
+            const tw = Math.ceil(Math.max(...lines.map((l) => l.length)) * fs * 0.6);
+            const th = Math.ceil(lines.length * fs * 1.25);
+            const color = st.stroke === INK ? '#334155' : st.stroke;
+            if (a.labelCenter) {
+                // Free text at a point the layout chose (self-loops: beside the loop).
+                const [cx, cy] = a.labelCenter;
+                elements.push(textEl(tid, { x: cx - tw / 2, y: cy - th / 2, w: tw, h: th }, a.label, fs, color, null));
+            }
+            else if (a.labelAt !== undefined) {
+                // Free text near the start of the arrow, just above the line.
+                const [ax, ay] = a.points[0];
+                const [bx, by] = a.points[1];
+                const cx = ax + (bx - ax) * a.labelAt;
+                const cy = ay + (by - ay) * a.labelAt;
+                const big = 20;
+                elements.push(textEl(tid, {
+                    x: cx - (big * 0.6) / 2,
+                    y: cy - big * 1.25 - 2,
+                    w: Math.ceil(big * 0.6),
+                    h: Math.ceil(big * 1.25),
+                }, a.label, big, color, null));
+            }
+            else {
+                // Mid-point of the polyline's middle segment.
+                const mid = Math.floor((a.points.length - 1) / 2);
+                const [ax, ay] = a.points[mid];
+                const [bx, by] = a.points[mid + 1] ?? a.points[mid];
+                const cx = (ax + bx) / 2;
+                const cy = (ay + by) / 2;
+                elements.push(textEl(tid, { x: cx - tw / 2, y: cy - th / 2, w: tw, h: th }, a.label, fs, color, id));
+                el.boundElements = [{ id: tid, type: 'text' }];
+            }
+        }
+    }
+    return {
+        type: 'excalidraw',
+        version: 2,
+        source: 'https://github.com/andreitoma8/hex',
+        elements,
+        appState: { viewBackgroundColor: '#ffffff', gridSize: null },
+        files: {},
+        hex: { ...meta, edited: false },
+    };
+}
+//# sourceMappingURL=excalidraw.js.map

package/dist/diagrams/excalidraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excalidraw.js","sourceRoot":"","sources":["../../src/diagrams/excalidraw.ts"],"names":[],"mappings":"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"}

package/dist/diagrams/layout.d.ts

@@ -0,0 +1,48 @@
+import type { DiagramSpec } from '../types/index.js';
+export type ShapeStyle = 'title' | 'takeaway' | 'actor' | 'holding' | 'function' | 'state' | 'state-terminal' | 'term' | 'participant' | 'header' | 'cell' | 'dot' | 'worst-case' | 'equation' | 'risk' | 'note' | 'callout-risk' | 'callout-note' | 'label';
+export type ArrowStyle = 'move' | 'transition' | 'increase' | 'decrease' | 'set' | 'call' | 'callback' | 'oracle' | 'transfer' | 'state' | 'annotation' | 'lifeline' | 'rule';
+export interface Shape {
+    id: string;
+    kind: 'rect' | 'ellipse' | 'text';
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    label: string;
+    style: ShapeStyle;
+    fontSize: number;
+    ref?: string;
+}
+export interface Arrow {
+    id: string;
+    from?: string;
+    to?: string;
+    /** Absolute points, at least two. */
+    points: Array<[number, number]>;
+    label?: string;
+    style: ArrowStyle;
+    /** Plain line (no arrowhead): lifelines and matrix rules. */
+    line?: boolean;
+    /**
+     * Place the label as free text at this fraction along the first segment
+     * (0 = start) instead of binding it to the arrow's midpoint. Used where many
+     * arrows cross in the middle (accounting).
+     */
+    labelAt?: number;
+    /** Free label centred at this point (self-loops put it beside the loop). */
+    labelCenter?: [number, number];
+    /** Excalidraw binding focus (-1..1) at each end; spreads arrows that share a box. */
+    startFocus?: number;
+    endFocus?: number;
+    ref?: string;
+}
+export interface Scene {
+    shapes: Shape[];
+    arrows: Arrow[];
+    width: number;
+    height: number;
+}
+export declare function wrap(text: string, maxChars: number): string[];
+/** Lay out a spec: header (title + takeaway) above the type-specific body. */
+export declare function layoutDiagram(spec: DiagramSpec): Scene;
+//# sourceMappingURL=layout.d.ts.map

package/dist/diagrams/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/diagrams/layout.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,UAAU,GACV,OAAO,GACP,SAAS,GACT,UAAU,GACV,OAAO,GACP,gBAAgB,GAChB,MAAM,GACN,aAAa,GACb,QAAQ,GACR,MAAM,GACN,KAAK,GACL,YAAY,GACZ,UAAU,GACV,MAAM,GACN,MAAM,GACN,cAAc,GACd,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,YAAY,GACZ,UAAU,GACV,UAAU,GACV,KAAK,GACL,MAAM,GACN,UAAU,GACV,QAAQ,GACR,UAAU,GACV,OAAO,GACP,YAAY,GACZ,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAa7D;AAupBD,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,KAAK,CAmEtD"}