@tienne/gestalt 0.88.0 → 0.89.0

package/dist/src/architecture/dataflow-layout.js

@@ -0,0 +1,229 @@
+import { measureNode, textUnits } from './layout.js';
+import { chipTextOverride, displayKindOf, } from './types.js';
+// dataflow는 데이터가 왼쪽에서 오른쪽으로 옮겨 간다. 열은 출발점에서 몇 번 건너왔는지다
+const MIN_GAP = 96;
+const LABEL_PAD = 40;
+const LABEL_CHAR = 7;
+const ROW_GAP = 28;
+const PARALLEL = 18;
+const BACK_DROP = 44;
+const BACK_STEP = 18;
+const SELF_DROP = 34;
+const SELF_SPAN = 32;
+const ARROW = 8;
+const TAIL = 24;
+function round2(v) {
+    return Math.round(v * 100) / 100;
+}
+function pt(p) {
+    return `${round2(p[0])} ${round2(p[1])}`;
+}
+/** x가 한 방향으로만 늘어나는 3차 베지어에서 주어진 x의 y. 이분법이라 같은 입력이면 같은 값이다 */
+function bezierYAt(p0, c1, c2, p3, x) {
+    const at = (t, i) => {
+        const u = 1 - t;
+        return u * u * u * p0[i] + 3 * u * u * t * c1[i] + 3 * u * t * t * c2[i] + t * t * t * p3[i];
+    };
+    let lo = 0;
+    let hi = 1;
+    for (let i = 0; i < 40; i++) {
+        const mid = (lo + hi) / 2;
+        if (at(mid, 0) < x)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    return at((lo + hi) / 2, 1);
+}
+/** 끝 접선 방향으로 화살촉을 세운다. 뒤로 가는 선은 아래에서 올라와 닿으므로 방향을 계산으로 구한다 */
+function tipOf(from, to) {
+    const dx = to[0] - from[0];
+    const dy = to[1] - from[1];
+    const len = Math.hypot(dx, dy) || 1;
+    const ux = dx / len;
+    const uy = dy / len;
+    const bx = to[0] - ux * ARROW;
+    const by = to[1] - uy * ARROW;
+    const wing = (s) => `${round2(bx - uy * (ARROW / 2) * s)},${round2(by + ux * (ARROW / 2) * s)}`;
+    return [`${round2(to[0])},${round2(to[1])}`, wing(1), wing(-1)];
+}
+/**
+ * 그릴 메시지만 받아 좌표를 정한다. 같은 입력이면 같은 좌표가 나온다.
+ * 열은 되돌아가는 선을 뺀 뒤 가장 긴 경로로 정한다. 같은 열 안 순서는 participants, 없으면 처음 나온 순서다
+ */
+export function computeDataflowLayout(projection, drawn, nodeById) {
+    const messages = projection.messages.filter((m) => drawn.has(m.id));
+    const order = [];
+    const add = (id) => {
+        if (!order.includes(id) && nodeById.has(id))
+            order.push(id);
+    };
+    const used = new Set(messages.flatMap((m) => [m.from, m.to]));
+    for (const id of projection.participants ?? [])
+        if (used.has(id))
+            add(id);
+    for (const m of messages) {
+        add(m.from);
+        add(m.to);
+    }
+    // 되돌아가는 선 찾기. 순서대로 깊이 우선으로 돌며 스택 위 노드로 가는 선을 뒤로 가는 선으로 본다
+    const out = new Map(order.map((id) => [id, []]));
+    for (const m of messages) {
+        if (m.from !== m.to && !out.get(m.from).includes(m.to))
+            out.get(m.from).push(m.to);
+    }
+    const back = new Set();
+    const state = new Map();
+    const visit = (id) => {
+        state.set(id, 'open');
+        for (const to of out.get(id)) {
+            const s = state.get(to);
+            if (s === 'open')
+                back.add(`${id}\u0000${to}`);
+            else if (s === undefined)
+                visit(to);
+        }
+        state.set(id, 'done');
+    };
+    for (const id of order)
+        if (!state.has(id))
+            visit(id);
+    const rank = new Map(order.map((id) => [id, 0]));
+    // 앞으로 가는 선만 남기면 순환이 없다. 노드 수만큼 돌면 가장 긴 경로가 정해진다
+    for (let pass = 0; pass < order.length; pass++) {
+        let changed = false;
+        for (const id of order) {
+            for (const to of out.get(id)) {
+                if (back.has(`${id}\u0000${to}`))
+                    continue;
+                const r = rank.get(id) + 1;
+                if (r > rank.get(to)) {
+                    rank.set(to, r);
+                    changed = true;
+                }
+            }
+        }
+        if (!changed)
+            break;
+    }
+    const sizes = new Map(order.map((id) => {
+        const n = nodeById.get(id);
+        const chip = chipTextOverride(n);
+        return [
+            id,
+            measureNode(n.label, n.displayName, n.displayNameInferred, displayKindOf(n), {
+                ...(chip !== undefined ? { chip } : {}),
+            }),
+        ];
+    }));
+    const maxRank = Math.max(0, ...rank.values());
+    const columns = Array.from({ length: maxRank + 1 }, () => []);
+    for (const id of order)
+        columns[rank.get(id)].push(id);
+    const colWidth = columns.map((ids) => Math.max(0, ...ids.map((id) => sizes.get(id).width)));
+    // 열을 건너뛰는 선도 라벨은 출발 열 바로 뒤 틈에 앉으므로 그 틈 너비에 같이 센다
+    const gapAfter = columns.slice(0, -1).map((_, r) => {
+        const label = messages
+            .filter((m) => rank.get(m.from) === r && rank.get(m.to) > r)
+            .reduce((w, m) => Math.max(w, textUnits(m.label) * LABEL_CHAR), 0);
+        return Math.max(MIN_GAP, label + LABEL_PAD);
+    });
+    const colX = [];
+    columns.forEach((_, r) => {
+        colX.push(r === 0 ? 0 : colX[r - 1] + colWidth[r - 1] + gapAfter[r - 1]);
+    });
+    const colHeight = columns.map((ids) => ids.reduce((h, id) => h + sizes.get(id).height, 0) + Math.max(0, ids.length - 1) * ROW_GAP);
+    const tallest = Math.max(0, ...colHeight);
+    const box = new Map();
+    columns.forEach((ids, r) => {
+        let y = (tallest - colHeight[r]) / 2;
+        for (const id of ids) {
+            const s = sizes.get(id);
+            box.set(id, {
+                id,
+                x: round2(colX[r] + (colWidth[r] - s.width) / 2),
+                y: round2(y),
+                width: s.width,
+                height: s.height,
+            });
+            y += s.height + ROW_GAP;
+        }
+    });
+    // 같은 두 노드 사이 선이 여럿이면 끝점을 위아래로 벌린다
+    const pairCount = new Map();
+    const pairSeen = new Map();
+    for (const m of messages) {
+        const k = `${m.from}\u0000${m.to}`;
+        pairCount.set(k, (pairCount.get(k) ?? 0) + 1);
+    }
+    let bottom = tallest;
+    const right = Math.max(0, ...[...box.values()].map((b) => b.x + b.width));
+    let backLane = 0;
+    const edges = messages.map((m) => {
+        const k = `${m.from}\u0000${m.to}`;
+        const nth = pairSeen.get(k) ?? 0;
+        pairSeen.set(k, nth + 1);
+        const shift = (nth - (pairCount.get(k) - 1) / 2) * PARALLEL;
+        const a = box.get(m.from);
+        const b = box.get(m.to);
+        if (m.from === m.to) {
+            // 열 사이 틈은 옆 선 라벨 자리라서 자기 자신으로 가는 선은 카드 오른쪽 아래로 돈다
+            const x = a.x + a.width - 12 + shift;
+            const y = a.y + a.height;
+            const p0 = [x - SELF_SPAN, y];
+            const c1 = [x - SELF_SPAN - 6, y + SELF_DROP];
+            const c2 = [x + 6, y + SELF_DROP];
+            const p3 = [x, y];
+            bottom = Math.max(bottom, y + SELF_DROP + 16);
+            return {
+                id: m.id,
+                d: `M${pt(p0)}C${pt(c1)} ${pt(c2)} ${pt(p3)}`,
+                tip: tipOf(c2, p3),
+                labelX: round2(x - SELF_SPAN / 2),
+                labelY: round2(y + SELF_DROP + 10),
+            };
+        }
+        if (rank.get(m.to) > rank.get(m.from)) {
+            const p0 = [a.x + a.width, a.y + a.height / 2 + shift];
+            const p3 = [b.x, b.y + b.height / 2 + shift];
+            const c = Math.max(40, (p3[0] - p0[0]) / 2);
+            const c1 = [p0[0] + c, p0[1]];
+            const c2 = [p3[0] - c, p3[1]];
+            const from = rank.get(m.from);
+            // 가운데 열 카드 위에 라벨이 앉지 않게, 열을 건너뛰는 선은 출발 열 바로 뒤 틈에서 선 위에 단다
+            const labelX = rank.get(m.to) - from > 1
+                ? colX[from] + colWidth[from] + gapAfter[from] / 2
+                : (p0[0] + p3[0]) / 2;
+            return {
+                id: m.id,
+                d: `M${pt(p0)}C${pt(c1)} ${pt(c2)} ${pt(p3)}`,
+                tip: tipOf(c2, p3),
+                labelX: round2(labelX),
+                labelY: round2(bezierYAt(p0, c1, c2, p3, labelX) - 5),
+            };
+        }
+        // 되돌아가거나 같은 열로 가는 선은 카드 아래로 돌아 들어간다. 겹치지 않게 한 줄씩 더 내려간다
+        const p0 = [a.x + a.width / 2 + shift, a.y + a.height];
+        const p3 = [b.x + b.width / 2 + shift, b.y + b.height];
+        const depth = Math.max(p0[1], p3[1]) + BACK_DROP + backLane * BACK_STEP;
+        backLane += 1;
+        const c1 = [p0[0], depth];
+        const c2 = [p3[0], depth];
+        const midY = (p0[1] + 6 * depth + p3[1]) / 8;
+        bottom = Math.max(bottom, midY + 16);
+        return {
+            id: m.id,
+            d: `M${pt(p0)}C${pt(c1)} ${pt(c2)} ${pt(p3)}`,
+            tip: tipOf(c2, p3),
+            labelX: round2((p0[0] + p3[0]) / 2),
+            labelY: round2(midY - 6),
+        };
+    });
+    return {
+        width: round2(right),
+        height: round2(bottom + TAIL),
+        cards: order.map((id) => box.get(id)),
+        edges,
+    };
+}
+//# sourceMappingURL=dataflow-layout.js.map

package/dist/src/architecture/dataflow-layout.js.map

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

package/dist/src/architecture/doc-fresh.d.ts

@@ -0,0 +1,31 @@
+/** 마지막 손댄 날이 이보다 오래되면 오래된 문서로 본다 */
+export declare const DEFAULT_AGED_DAYS = 180;
+interface Dated {
+    repoId: string;
+    path: string;
+    updatedAt?: string;
+    committedAt?: string;
+}
+export interface FreshnessSummary {
+    dated: number;
+    undated: number;
+    agedDays: number;
+    aged: number;
+    /** 머리줄 수정일이 마지막 커밋보다 한참 앞선 문서 수 */
+    headerBehind: number;
+    /** 마지막 손댄 달별 문서 수. 키는 `YYYY-MM` */
+    byMonth: Record<string, number>;
+    /** 오래된 순 앞쪽 몇 개. `<repoId>/<path>` */
+    oldest: {
+        doc: string;
+        date: string;
+    }[];
+}
+/** 레포 안 파일마다 마지막 커밋 날짜(`YYYY-MM-DD`). 키는 root 기준 경로다. git 레포가 아니면 비운다 */
+export declare function docCommitDates(root: string): Map<string, string>;
+/** 머리줄 수정일과 커밋 날짜 중 늦은 쪽. 형식만 고친 커밋이 있어도 오래됐다고 잘못 몰지 않으려고 늦은 쪽을 본다 */
+export declare function lastTouched(d: Dated): string | undefined;
+export declare function isAged(d: Dated, now: string, days?: number): boolean;
+export declare function summarizeFreshness(docs: readonly Dated[], now: string, days?: number): FreshnessSummary;
+export {};
+//# sourceMappingURL=doc-fresh.d.ts.map

package/dist/src/architecture/doc-fresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-fresh.d.ts","sourceRoot":"","sources":["../../../src/architecture/doc-fresh.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAKrC,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,sCAAsC;IACtC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzC;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiChE;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAIxD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAoB,GAAG,OAAO,CAI/E;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,KAAK,EAAE,EACtB,GAAG,EAAE,MAAM,EACX,IAAI,SAAoB,GACvB,gBAAgB,CA4BlB"}

package/dist/src/architecture/doc-fresh.js

@@ -0,0 +1,84 @@
+import { execFileSync } from 'node:child_process';
+/** 마지막 손댄 날이 이보다 오래되면 오래된 문서로 본다 */
+export const DEFAULT_AGED_DAYS = 180;
+/** 머리줄 수정일이 커밋보다 이만큼 뒤처지면 머리줄을 안 고치고 내용만 바꾼 문서로 본다 */
+const HEADER_BEHIND_DAYS = 30;
+const DAY_MS = 86_400_000;
+/** 레포 안 파일마다 마지막 커밋 날짜(`YYYY-MM-DD`). 키는 root 기준 경로다. git 레포가 아니면 비운다 */
+export function docCommitDates(root) {
+    const out = new Map();
+    let log;
+    try {
+        log = execFileSync('git', [
+            '-C',
+            root,
+            // 끄지 않으면 한글 파일 이름이 8진수 이스케이프로 나와 스캔 경로와 안 맞는다
+            '-c',
+            'core.quotepath=off',
+            'log',
+            // 이름 바꾸기 감지가 내용을 비교하느라 blob 없이 받은 레포에서는 blob을 하나씩 받아와 분 단위로 늘어진다
+            '--no-renames',
+            '--format=%x00%cs',
+            '--name-only',
+            '--relative',
+            '--',
+            '*.md',
+        ], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'], maxBuffer: 256 * 1024 * 1024 });
+    }
+    catch {
+        return out;
+    }
+    // 최신 커밋부터 나오므로 처음 본 날짜가 마지막 커밋이다
+    let date = '';
+    for (const line of log.split('\n')) {
+        if (line.startsWith('\0'))
+            date = line.slice(1);
+        else if (line !== '' && !out.has(line))
+            out.set(line, date);
+    }
+    return out;
+}
+/** 머리줄 수정일과 커밋 날짜 중 늦은 쪽. 형식만 고친 커밋이 있어도 오래됐다고 잘못 몰지 않으려고 늦은 쪽을 본다 */
+export function lastTouched(d) {
+    if (d.updatedAt === undefined)
+        return d.committedAt;
+    if (d.committedAt === undefined)
+        return d.updatedAt;
+    return d.updatedAt > d.committedAt ? d.updatedAt : d.committedAt;
+}
+export function isAged(d, now, days = DEFAULT_AGED_DAYS) {
+    const last = lastTouched(d);
+    if (last === undefined)
+        return false;
+    return Date.parse(now) - Date.parse(last) > days * DAY_MS;
+}
+export function summarizeFreshness(docs, now, days = DEFAULT_AGED_DAYS) {
+    const byMonth = {};
+    const dated = [];
+    let aged = 0;
+    let headerBehind = 0;
+    for (const d of docs) {
+        const last = lastTouched(d);
+        if (last === undefined)
+            continue;
+        dated.push({ doc: `${d.repoId}/${d.path}`, date: last });
+        byMonth[last.slice(0, 7)] = (byMonth[last.slice(0, 7)] ?? 0) + 1;
+        if (isAged(d, now, days))
+            aged++;
+        if (d.updatedAt !== undefined &&
+            d.committedAt !== undefined &&
+            Date.parse(d.committedAt) - Date.parse(d.updatedAt) > HEADER_BEHIND_DAYS * DAY_MS)
+            headerBehind++;
+    }
+    dated.sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : a.doc < b.doc ? -1 : 1));
+    return {
+        dated: dated.length,
+        undated: docs.length - dated.length,
+        agedDays: days,
+        aged,
+        headerBehind,
+        byMonth: Object.fromEntries(Object.entries(byMonth).sort(([a], [b]) => (a < b ? -1 : 1))),
+        oldest: dated.slice(0, 10),
+    };
+}
+//# sourceMappingURL=doc-fresh.js.map

package/dist/src/architecture/doc-fresh.js.map

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

package/dist/src/architecture/doc-link.d.ts

@@ -0,0 +1,84 @@
+import type { ScannedDoc } from './doc-scan.js';
+import type { OwnerMatch } from './codeowners.js';
+import type { ArchitectureIr, ArchitectureNode, DocInfo } from './types.js';
+/** 가리킨 파일이 클론에 있는지와 마지막 커밋 날짜. 클론이 없는 레포면 undefined */
+export type FileFacts = (repoName: string, path: string) => {
+    exists: boolean;
+    committedAt?: string;
+} | undefined;
+export interface LinkDocsOptions {
+    /** 문서가 적은 레포 이름 → 기술 IR의 repo id. 비면 repos[].name이나 id가 같은 레포를 쓴다 */
+    repoAliases?: Record<string, string>;
+    /** 화면 색인으로 쓸 design_screen의 `<repoId>/<경로 접두>`. 비면 화면은 잇지 않는다 */
+    screenIndexPrefixes?: string[];
+    fileFacts?: FileFacts;
+    /** 레포 이름과 경로 → CODEOWNERS 담당. 주면 기술 노드와 문서에 담당을 달고 소유 신호를 센다 */
+    ownersOf?: (repoName: string, path: string) => OwnerMatch | undefined;
+    generatedAt: string;
+}
+export interface OwnershipCount {
+    total: number;
+    owned: number;
+    /** 레포 전체 기본 담당(`*`)에만 걸린 수. owned에 들어 있다 */
+    catchAllOnly: number;
+}
+export interface KnowledgeLinkSignals {
+    coverage: Record<string, {
+        total: number;
+        covered: number;
+    }>;
+    /** 문서가 하나도 안 붙은 기술 노드 */
+    uncovered: string[];
+    /** 문서 날짜보다 가리킨 파일 커밋이 늦은 문서 */
+    stale: {
+        doc: string;
+        updatedAt: string;
+        newestRef: string;
+    }[];
+    /** 문서가 말한 API 중 기술 그림 엔드포인트에 없는 것 */
+    apiMismatches: {
+        doc: string;
+        api: string;
+        line: number;
+    }[];
+    screensOnlyInCode: string[];
+    screensOnlyInIndex: string[];
+    links: {
+        total: number;
+        broken: number;
+        branchOnly: number;
+        pinned: number;
+        unchecked: number;
+    };
+    linkedDocs: number;
+    describes: number;
+    /** 문서 전체의 담당별 열린 구멍 수. 구멍에 담당이 없으면 문서 담당으로, 그것도 없으면 '(담당 없음)'으로 센다 */
+    gapsByOwner: Record<string, number>;
+    /** ownersOf를 줬을 때만. tech는 문서가 붙어야 할 kind만 센다 */
+    ownership?: {
+        tech: OwnershipCount;
+        docs: OwnershipCount;
+        unownedTech: string[];
+    };
+}
+export interface LinkDocsResult {
+    ir: ArchitectureIr;
+    signals: KnowledgeLinkSignals;
+    /** 링크 상태를 다시 센 문서 정보. 문서 지도 초안에 되돌려 쓴다 */
+    docInfo: Map<string, DocInfo>;
+    /** CODEOWNERS로 찾은 문서 담당. 문서 지도 초안에 되돌려 쓴다 */
+    docOwners: Map<string, string[]>;
+}
+/** `repo:path:line` 근거를 레포와 경로로 나눈다 */
+export declare function splitCodeLocation(location: string): {
+    repo: string;
+    path: string;
+} | undefined;
+/** 화면 label `[app] /route · Name`에서 라우트만 뽑는다 */
+export declare function screenRouteOf(node: Pick<ArchitectureNode, 'label'>): string | undefined;
+/**
+ * 기술 그림에 문서를 엮는다. 문서가 가리킨 코드 파일, 문서가 말한 API, 화면 색인의 라우트로 잇고
+ * 이어진 문서만 기술 IR에 얹어 knowledge-link IR을 만든다. 잇지 못한 쪽은 신호로 돌려준다
+ */
+export declare function linkDocs(tech: ArchitectureIr, knowledge: ArchitectureIr, scanned: readonly ScannedDoc[], options: LinkDocsOptions): LinkDocsResult;
+//# sourceMappingURL=doc-link.d.ts.map

package/dist/src/architecture/doc-link.d.ts.map

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