@tienne/gestalt 0.96.0 → 0.98.0

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

@@ -0,0 +1,297 @@
+import { buildGraph, handlersOf, isSurface, kindOf, moduleUses } from './drilldown.js';
+import { columnsOf, stepPathOf } from './flow-layout.js';
+export const BLUEPRINT_ROWS = [
+    'customer',
+    'frontstage',
+    'backstage',
+    'support',
+];
+export const BLUEPRINT_ROW_TEXT = {
+    customer: '고객 행동',
+    frontstage: '프론트스테이지',
+    backstage: '백스테이지',
+    support: '지원',
+};
+export const BLUEPRINT_VISIBILITY_TEXT = '가시선';
+export const BLUEPRINT_VISIBILITY_NOTE = '위는 고객에게 보이고 아래는 안 보여요';
+/** 근거 있는 연결이 없는 칸에 찍는 글자. 비워 두면 그리다 빠뜨린 칸과 구분이 안 된다 */
+export const BLUEPRINT_EMPTY_TEXT = '—';
+/** 블루프린트 한 장의 예산. 단계 4~6열이 한눈에 읽히는 폭이라 넘으면 경고로 흐름을 나누라고 알린다 */
+export const BLUEPRINT_BUDGET = { stages: 6 };
+/** 칸 하나에 보이는 카드 수. 넘는 몫은 +N으로 접는다 */
+export const BLUEPRINT_CARDS_PER_CELL = 3;
+const SUPPORT_KINDS = new Set([
+    'db_table',
+    'datastore',
+    'external_service',
+    'topic',
+    'job',
+]);
+/** 단계가 가리킨 노드가 어느 층에 서는지. feature와 micro_app은 화면 여럿을 묶은 노드라 한 단계의 칸에 세우지 않고 뺀다 */
+function refRow(n) {
+    if (n.kind === 'screen' || n.kind === 'skill')
+        return 'frontstage';
+    if (n.kind === 'endpoint' || n.kind === 'agent')
+        return 'backstage';
+    if (n.kind === 'component') {
+        const rc = n.renderClass ?? 'service';
+        if (rc === 'client' || rc === 'actor')
+            return 'frontstage';
+        if (rc === 'queue' || rc === 'store' || rc === 'external')
+            return 'support';
+        return 'backstage';
+    }
+    return undefined;
+}
+function isSupport(n) {
+    if (n === undefined)
+        return false;
+    if (SUPPORT_KINDS.has(n.kind))
+        return true;
+    return (n.kind === 'component' &&
+        (n.renderClass === 'queue' || n.renderClass === 'store' || n.renderClass === 'external'));
+}
+const docOnlyStep = (s) => s.evidence.every((ev) => ev.type !== 'code' && ev.type !== 'spec');
+/** 칸 하나를 모은다. 같은 것이 여러 길로 들어오면 하나로 두고 실선 길이 하나라도 있으면 실선으로 본다 */
+class Cell {
+    byId = new Map();
+    add(type, id, docOnly) {
+        const key = `${type}\u0000${id}`;
+        const prev = this.byId.get(key);
+        if (prev === undefined)
+            this.byId.set(key, { type, id, docOnly });
+        else if (!docOnly)
+            prev.docOnly = false;
+    }
+    list() {
+        return [...this.byId.values()];
+    }
+}
+/**
+ * 흐름 하나를 블루프린트 칸으로 나눈다. 열은 정상 흐름 단계의 열이고 행은 층이다.
+ * 노드 칸은 단계 refs와 그려지는 엣지만 따라 채운다. 근거 있는 연결이 없으면 칸은 빈다
+ */
+export function deriveBlueprint(flow, src) {
+    const steps = flow.steps.filter((s) => src.drawableStepIds.has(s.id));
+    const stepIds = new Set(steps.map((s) => s.id));
+    const transitions = flow.transitions.filter((t) => src.drawableTransitionIds.has(t.id) && stepIds.has(t.from) && stepIds.has(t.to));
+    const pathOf = stepPathOf(transitions);
+    const { column } = columnsOf(steps, transitions, (id) => pathOf(id) === 'main');
+    const kept = steps.filter((s) => s.kind !== 'decision' && pathOf(s.id) === 'main');
+    const order = [...new Set(kept.map((s) => column.get(s.id)))].sort((a, b) => a - b);
+    const actorKind = new Map(flow.actors.map((a) => [a.id, a.kind]));
+    const customer = flow.actors.find((a) => a.kind === 'person')?.id;
+    const g = buildGraph({
+        ir: { nodes: [...src.nodes], edges: [...src.edges] },
+        drawableNodeIds: src.drawableNodeIds,
+        drawableEdgeIds: src.drawableEdgeIds,
+    });
+    const walked = new Set();
+    const engines = moduleUses(g);
+    const columns = order.map((col) => {
+        const colSteps = kept.filter((s) => column.get(s.id) === col);
+        const cells = {
+            customer: new Cell(),
+            frontstage: new Cell(),
+            backstage: new Cell(),
+            support: new Cell(),
+        };
+        for (const s of colSteps) {
+            const doc = docOnlyStep(s);
+            if (s.actor === customer)
+                cells.customer.add('step', s.id, doc);
+            else if (actorKind.get(s.actor) === 'person')
+                cells.frontstage.add('step', s.id, doc);
+            else
+                cells.backstage.add('step', s.id, doc);
+            for (const id of s.refs ?? []) {
+                const n = g.nodeById.get(id);
+                if (n === undefined)
+                    continue;
+                const row = refRow(n);
+                if (row !== undefined)
+                    cells[row].add('node', id, doc);
+            }
+        }
+        const nodeItems = (row) => cells[row].list().filter((it) => it.type === 'node');
+        const viaEdge = (from, e) => from.docOnly || e.lineStyle === 'dashed';
+        // 화면과 스킬, 에이전트가 부르는 API와 MCP 도구는 고객이 못 보는 쪽이다
+        for (const from of [...nodeItems('frontstage'), ...nodeItems('backstage')]) {
+            if (!isSurface(g, from.id) && kindOf(g, from.id) !== 'agent')
+                continue;
+            for (const e of g.edges) {
+                if (e.kind !== 'calls' || e.from !== from.id || kindOf(g, e.to) !== 'endpoint')
+                    continue;
+                cells.backstage.add('node', e.to, viaEdge(from, e));
+                walked.add(e.id);
+            }
+        }
+        // 지원은 백스테이지가 기대는 것이다. 엔드포인트를 처리하는 모듈과 그 모듈이 같은 프로세스에서 쓰는 모듈에서 저장소, 외부 서비스, 큐와 잡으로 나간다
+        const modules = new Map();
+        const reachModule = (id, docOnly) => {
+            const prev = modules.get(id);
+            if (prev !== undefined && (prev === false || docOnly))
+                return false;
+            modules.set(id, docOnly);
+            return true;
+        };
+        const queue = [];
+        const sources = [];
+        for (const it of nodeItems('backstage')) {
+            if (kindOf(g, it.id) === 'endpoint') {
+                for (const h of handlersOf(g, it.id)) {
+                    walked.add(h.id);
+                    if (reachModule(h.to, viaEdge(it, h)))
+                        queue.push(h.to);
+                }
+            }
+            else if (kindOf(g, it.id) === 'component') {
+                sources.push(it);
+            }
+        }
+        while (queue.length > 0) {
+            const at = queue.shift();
+            const doc = modules.get(at);
+            for (const u of engines) {
+                if (u.from !== at)
+                    continue;
+                walked.add(u.id);
+                if (reachModule(u.to, doc || u.lineStyle === 'dashed'))
+                    queue.push(u.to);
+            }
+        }
+        for (const [id, docOnly] of [...modules].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
+            sources.push({ type: 'node', id, docOnly });
+        }
+        for (const from of sources) {
+            for (const e of g.edges) {
+                if (e.from !== from.id || !isSupport(g.nodeById.get(e.to)))
+                    continue;
+                cells.support.add('node', e.to, viaEdge(from, e));
+                walked.add(e.id);
+            }
+        }
+        return {
+            steps: colSteps.map((s) => s.id),
+            cells: {
+                customer: cells.customer.list(),
+                frontstage: cells.frontstage.list(),
+                backstage: cells.backstage.list(),
+                support: cells.support.list(),
+            },
+        };
+    });
+    return {
+        flowId: flow.id,
+        ...(customer !== undefined ? { customer } : {}),
+        columns,
+        edges: [...walked].sort(),
+    };
+}
+export function blueprintCounts(model) {
+    return { stages: model.columns.length };
+}
+/** 예산을 넘은 항목을 사람이 읽는 글로. 안 넘었으면 빈 배열이다 */
+export function blueprintOverBudget(counts) {
+    return counts.stages > BLUEPRINT_BUDGET.stages
+        ? [`단계 ${counts.stages}열 (예산 ${BLUEPRINT_BUDGET.stages})`]
+        : [];
+}
+/**
+ * 열 머리 글자. 단계에 상태가 있으면 그 상태 이름, 없으면 첫 단계 이름이다.
+ * 공유본에서는 가린 흐름을 넘겨 가린 글자가 찍힌다
+ */
+export function blueprintStageTitle(flow, col) {
+    const byId = new Map(flow.steps.map((s) => [s.id, s]));
+    const steps = col.steps.map((id) => byId.get(id)).filter((s) => !!s);
+    const withState = [...steps].reverse().find((s) => s.state !== undefined);
+    if (withState !== undefined)
+        return flow.stateLabels?.[withState.state] ?? withState.state;
+    return steps[0]?.label ?? '';
+}
+// 칸 크기는 글자 길이와 무관하게 고정이다. 공유본에서 가린 글자 폭 때문에 그림이 움직이지 않게 하려고다
+export const BLUEPRINT_HEAD_W = 120;
+export const BLUEPRINT_COL_W = 216;
+const COL_GAP = 12;
+const STAGE_H = 48;
+export const BLUEPRINT_CARD_H = 44;
+const CARD_GAP = 8;
+const CARD_INSET = 10;
+const ROW_PAD = 14;
+const MORE_H = 20;
+const EMPTY_H = 28;
+const LINE_GAP = 16;
+const VISIBILITY_GAP = 40;
+function cellContent(items) {
+    if (items === 0)
+        return EMPTY_H;
+    const shown = Math.min(items, BLUEPRINT_CARDS_PER_CELL);
+    return (shown * BLUEPRINT_CARD_H +
+        (shown - 1) * CARD_GAP +
+        (items > BLUEPRINT_CARDS_PER_CELL ? CARD_GAP + MORE_H : 0));
+}
+/** 격자 좌표. 열은 같은 폭, 행 높이는 그 행에서 가장 많이 찬 칸에 맞춘다 */
+export function computeBlueprintLayout(model) {
+    const n = model.columns.length;
+    const colX = (i) => BLUEPRINT_HEAD_W + i * (BLUEPRINT_COL_W + COL_GAP);
+    const width = BLUEPRINT_HEAD_W + n * BLUEPRINT_COL_W + Math.max(0, n - 1) * COL_GAP;
+    const stages = model.columns.map((_, i) => ({
+        x: colX(i),
+        y: 0,
+        width: BLUEPRINT_COL_W,
+        height: STAGE_H,
+    }));
+    const rows = [];
+    const lines = [];
+    const cells = [];
+    const gapAfter = {
+        customer: { role: 'interaction', gap: LINE_GAP },
+        frontstage: { role: 'visibility', gap: VISIBILITY_GAP },
+        backstage: { role: 'internal', gap: LINE_GAP },
+    };
+    let y = STAGE_H + 8;
+    for (const row of BLUEPRINT_ROWS) {
+        const content = Math.max(EMPTY_H, ...model.columns.map((c) => cellContent(c.cells[row].length)));
+        const height = content + ROW_PAD * 2;
+        rows.push({ row, y, height });
+        model.columns.forEach((c, i) => {
+            const items = c.cells[row];
+            const x = colX(i);
+            const shown = items.slice(0, BLUEPRINT_CARDS_PER_CELL);
+            const hidden = items.slice(BLUEPRINT_CARDS_PER_CELL);
+            const cards = shown.map((item, k) => ({
+                item,
+                x: x + CARD_INSET,
+                y: y + ROW_PAD + k * (BLUEPRINT_CARD_H + CARD_GAP),
+                width: BLUEPRINT_COL_W - CARD_INSET * 2,
+                height: BLUEPRINT_CARD_H,
+            }));
+            cells.push({
+                row,
+                column: i,
+                x,
+                y,
+                width: BLUEPRINT_COL_W,
+                height,
+                cards,
+                hidden,
+                ...(hidden.length > 0
+                    ? {
+                        moreAt: {
+                            x: x + CARD_INSET,
+                            y: y + ROW_PAD + shown.length * (BLUEPRINT_CARD_H + CARD_GAP),
+                        },
+                    }
+                    : {}),
+            });
+        });
+        y += height;
+        const after = gapAfter[row];
+        if (after !== undefined) {
+            lines.push({ role: after.role, y: y + after.gap / 2 });
+            y += after.gap;
+        }
+    }
+    return { width, height: y, stages, rows, lines, cells };
+}
+//# sourceMappingURL=blueprint-layout.js.map

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

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

package/dist/src/architecture/delta-renderer.d.ts

@@ -0,0 +1,35 @@
+import type { RoutedCanvas } from './canvas-geometry.js';
+import { type ArchitectureDelta, type DeltaChange, type DeltaScope } from './delta.js';
+import { type LayoutResult } from './layout.js';
+import type { ArchitectureEdge } from './types.js';
+type Panel = 'before' | 'after';
+/** 합집합 위의 선 하나. 끝점이 같으면 두 패널이 같은 경로를 쓴다. 다시 이은 선은 패널마다 따로 둔다 */
+interface DeltaRoute {
+    key: string;
+    edgeId: string;
+    panel: Panel | 'both';
+    edge: ArchitectureEdge;
+    changes: DeltaChange[];
+}
+export interface DeltaLayout {
+    layout: LayoutResult;
+    canvas: RoutedCanvas;
+    routes: DeltaRoute[];
+}
+/**
+ * 두 패널이 같이 쓰는 좌표. 합집합에 배치를 한 번만 돌린다.
+ * 패널마다 따로 돌리면 바뀌지 않은 노드까지 자리가 흔들려 없는 이동이 생긴 것처럼 읽힌다
+ */
+export declare function computeDeltaLayout(delta: ArchitectureDelta, scope: DeltaScope): Promise<DeltaLayout>;
+/**
+ * 공유본 배치. 가린 사본도 노드와 선 구성이 같으면 비공개본 좌표를 그대로 쓴다.
+ * 카드 폭이 원문 이름으로 잡히는 건 메인 공유본과 같은 기준이다. 구성이 다르면 다시 배치한다
+ */
+export declare function reuseDeltaLayout(base: DeltaLayout, delta: ArchitectureDelta, scope: DeltaScope): Promise<DeltaLayout>;
+export interface RenderDeltaOptions {
+    audience: 'private' | 'shared';
+}
+/** 이전 | 변경 목록 | 이번 세 칸. 정적 페이지라 스크립트는 테마 고정 한 줄뿐이다 */
+export declare function renderDeltaHtml(delta: ArchitectureDelta, scope: DeltaScope, laid: DeltaLayout, opts: RenderDeltaOptions): string;
+export {};
+//# sourceMappingURL=delta-renderer.d.ts.map

package/dist/src/architecture/delta-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-renderer.d.ts","sourceRoot":"","sources":["../../../src/architecture/delta-renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAUL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAGrE,KAAK,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhC,gEAAgE;AAChE,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAoED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,WAAW,CAAC,CAuCtB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,WAAW,CAAC,CActB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;CAChC;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAwCR"}