@tienne/gestalt 0.87.0 → 0.89.0

package/dist/src/architecture/focus.js

@@ -0,0 +1,107 @@
+import { BAND_HEAD, BAND_TAIL } from './layout.js';
+/**
+ * 포커스 계산. 브라우저 스크립트에 이 소스를 그대로 싣고 단위 테스트도 같은 문자열을 실행해 검사한다.
+ * TS 함수를 따로 두면 두 구현이 어긋나도 테스트가 못 잡는다.
+ *
+ * focusSet(edges, id): id에서 화살표 방향으로 닿는 노드 전부(하류)와 id로 들어오는 쪽을 거슬러 닿는 노드 전부(상류).
+ *   하류에서 다시 상류로 꺾지 않는다. 그래서 같은 게이트웨이를 부르는 다른 앱은 빠진다.
+ *   돌려주는 edges는 위아래로 따라가며 밟은 선뿐이다.
+ * focusLayout(boxes, keep, top, gap): 남은 카드를 같은 열(x) 안에서 원래 위아래 순서대로 위에서부터 다시 쌓는다.
+ *   x는 그대로 두므로 레인 자리가 안 바뀐다.
+ * focusBandLayout(boxes, keep, top, gap, bandOf, shareOf): 여러 제품을 합친 그림이면 띠(맨 위 같이 씀, 그 아래 제품마다 전용)별로
+ *   나눠 쌓고 띠 자리까지 낸다. 서버의 stackBands와 같은 규칙이다. shareOf는 같이 쓰는 카드의 제품 수다.
+ */
+export const FOCUS_SOURCE = `
+var BAND_HEAD = ${BAND_HEAD}, BAND_TAIL = ${BAND_TAIL};
+function focusSet(edges, id) {
+  var out = {};
+  var inc = {};
+  edges.forEach(function (e) {
+    (out[e.from] = out[e.from] || []).push(e);
+    (inc[e.to] = inc[e.to] || []).push(e);
+  });
+  var nodes = {};
+  var kept = {};
+  nodes[id] = true;
+  function walk(index, next) {
+    var seen = {};
+    seen[id] = true;
+    var queue = [id];
+    while (queue.length) {
+      var at = queue.shift();
+      (index[at] || []).forEach(function (e) {
+        kept[e.id] = true;
+        var n = next(e);
+        nodes[n] = true;
+        if (!seen[n]) { seen[n] = true; queue.push(n); }
+      });
+    }
+  }
+  walk(out, function (e) { return e.to; });
+  walk(inc, function (e) { return e.from; });
+  return { nodes: Object.keys(nodes).sort(), edges: Object.keys(kept).sort() };
+}
+function focusLayout(boxes, keep, top, gap) {
+  var columns = {};
+  boxes.forEach(function (b) {
+    if (!keep[b.id]) return;
+    (columns[b.x] = columns[b.x] || []).push(b);
+  });
+  var pos = {};
+  Object.keys(columns).forEach(function (x) {
+    var col = columns[x];
+    col.sort(function (a, b) { return a.y - b.y || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0); });
+    var y = top;
+    col.forEach(function (b) {
+      pos[b.id] = { x: b.x, y: y, w: b.w, h: b.h };
+      y += b.h + gap;
+    });
+  });
+  return pos;
+}
+function focusBandLayout(boxes, keep, top, gap, bandOf, shareOf) {
+  var band = function (id) { return bandOf[id] === undefined ? 0 : bandOf[id]; };
+  var share = function (id) { return shareOf[id] || 0; };
+  var columns = {};
+  var counts = {};
+  boxes.forEach(function (b) {
+    if (!keep[b.id]) return;
+    (columns[b.x] = columns[b.x] || []).push(b);
+    counts[band(b.id)] = (counts[band(b.id)] || 0) + 1;
+  });
+  var order = Object.keys(counts).map(Number).sort(function (a, b) { return a - b; });
+  if (order.length < 2) return { pos: focusLayout(boxes, keep, top, gap) };
+  var height = {};
+  Object.keys(columns).forEach(function (x) {
+    order.forEach(function (k) {
+      var h = 0, n = 0;
+      columns[x].forEach(function (b) { if (band(b.id) === k) { h += b.h; n += 1; } });
+      if (n) height[k] = Math.max(height[k] || 0, h + gap * (n - 1));
+    });
+  });
+  var bands = [];
+  var bandTop = {};
+  var cursor = top;
+  order.forEach(function (k) {
+    var h = BAND_HEAD + height[k] + BAND_TAIL;
+    bands.push({ band: k, y: cursor, height: h });
+    bandTop[k] = cursor + BAND_HEAD;
+    cursor += h;
+  });
+  var pos = {};
+  Object.keys(columns).forEach(function (x) {
+    var col = columns[x];
+    order.forEach(function (k) {
+      var y = bandTop[k];
+      col.filter(function (b) { return band(b.id) === k; })
+        .sort(function (a, b) { return (k === 0 ? share(b.id) - share(a.id) : 0) || a.y - b.y || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0); })
+        .forEach(function (b) {
+          pos[b.id] = { x: b.x, y: y, w: b.w, h: b.h };
+          y += b.h + gap;
+        });
+    });
+  });
+  return { pos: pos, bands: bands, bottom: cursor };
+}
+`;
+//# sourceMappingURL=focus.js.map

package/dist/src/architecture/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../../src/architecture/focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;kBACV,SAAS,iBAAiB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FpD,CAAC"}

package/dist/src/architecture/global-context.d.ts

@@ -0,0 +1,23 @@
+import { type ExecGit } from '../utils/claude-projects.js';
+import type { Visibility } from './types.js';
+export interface ContextCandidate {
+    via: 'repo' | 'global';
+    /** 세션이 그대로 읽을 수 있게 절대경로로 둔다 */
+    identifier: string;
+    exists: boolean;
+    visibility: Visibility;
+}
+export interface CollectGlobalContextOptions {
+    repoRoot: string;
+    /** 기본값은 os.homedir(). 테스트에서 주입한다 */
+    homeDir?: string;
+    /** 기본값은 `<homeDir>/.claude/projects` */
+    projectsRoot?: string;
+    execGit?: ExecGit;
+}
+/**
+ * 아키텍처 뷰를 그리기 전에 세션이 읽어볼 만한 맥락 파일 후보를 모은다. 본문은 읽지 않는다.
+ * 레포 밖 홈 디렉토리 파일은 private이다. 개인 메모가 공유 HTML로 새지 않게 출처에서부터 표시한다.
+ */
+export declare function collectGlobalContext(opts: CollectGlobalContextOptions): ContextCandidate[];
+//# sourceMappingURL=global-context.d.ts.map

package/dist/src/architecture/global-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-context.d.ts","sourceRoot":"","sources":["../../../src/architecture/global-context.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;IACvB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAqBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,2BAA2B,GAAG,gBAAgB,EAAE,CAkC1F"}

package/dist/src/architecture/global-context.js

@@ -0,0 +1,67 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { findClaudeProjectMemoryDirs } from '../utils/claude-projects.js';
+function isFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function listMarkdown(dir, recursive) {
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir, { recursive, withFileTypes: true })
+            .filter((d) => d.isFile() && d.name.endsWith('.md'))
+            .map((d) => join(d.parentPath, d.name));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 아키텍처 뷰를 그리기 전에 세션이 읽어볼 만한 맥락 파일 후보를 모은다. 본문은 읽지 않는다.
+ * 레포 밖 홈 디렉토리 파일은 private이다. 개인 메모가 공유 HTML로 새지 않게 출처에서부터 표시한다.
+ */
+export function collectGlobalContext(opts) {
+    const { repoRoot } = opts;
+    const homeDir = opts.homeDir ?? homedir();
+    const projectsRoot = opts.projectsRoot ?? join(homeDir, '.claude', 'projects');
+    const candidates = [];
+    const fixed = (via, path, visibility) => candidates.push({ via, identifier: path, exists: isFile(path), visibility });
+    fixed('repo', join(repoRoot, 'CLAUDE.md'), 'public');
+    fixed('repo', join(repoRoot, 'AGENTS.md'), 'public');
+    fixed('repo', join(repoRoot, '.gestalt', 'memory.json'), 'public');
+    for (const path of listMarkdown(join(repoRoot, 'docs'), true)) {
+        candidates.push({ via: 'repo', identifier: path, exists: true, visibility: 'public' });
+    }
+    fixed('global', join(homeDir, '.claude', 'CLAUDE.md'), 'private');
+    const { memoryDirs } = findClaudeProjectMemoryDirs({
+        repoRoot,
+        projectsRoot,
+        execGit: opts.execGit,
+    });
+    for (const dir of memoryDirs) {
+        for (const path of listMarkdown(dir, false)) {
+            candidates.push({ via: 'global', identifier: path, exists: true, visibility: 'private' });
+        }
+    }
+    // 홈 디렉토리 안에서 레포를 연 경우 같은 파일이 두 번 잡힐 수 있다. 먼저 넣은 repo 쪽을 남긴다
+    const unique = new Map();
+    for (const c of candidates) {
+        if (!unique.has(c.identifier))
+            unique.set(c.identifier, c);
+    }
+    return [...unique.values()].sort(compareCandidate);
+}
+function compareCandidate(a, b) {
+    if (a.via !== b.via)
+        return a.via === 'repo' ? -1 : 1;
+    if (a.identifier === b.identifier)
+        return 0;
+    return a.identifier < b.identifier ? -1 : 1;
+}
+//# sourceMappingURL=global-context.js.map

package/dist/src/architecture/global-context.js.map

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

package/dist/src/architecture/html-client.d.ts

@@ -0,0 +1,35 @@
+import { type LaneId } from './layout.js';
+export interface ClientConstants {
+    kindShort: Record<string, string>;
+    /** 호스트 micro_app 칩 글자 */
+    hostShort: string;
+    kindText: Record<string, string>;
+    evidenceText: Record<string, string>;
+    laneTitles: Record<LaneId, string>;
+    inferredBadge: string;
+    platformChip: Record<string, string>;
+    platformName: Record<string, string>;
+    webHostingChip: Record<string, string>;
+    webHostingName: Record<string, string>;
+    /** 평면 그림에서 오른쪽에서 왼쪽으로 그리는 엣지 kind */
+    backwardKinds: string[];
+    /** component를 쓸 수 있는 어휘면 true. 그때만 component 처리 코드를 싣는다 */
+    components?: boolean;
+    /** service 없는 흐름이 있으면 true. 전체 레벨의 흐름 단추가 그 흐름을 연다 */
+    rootFlows?: boolean;
+    /** 질문별 그림이 있으면 true. 메시지 서랍과 그림 단추 코드를 싣는다 */
+    views?: boolean;
+    /** 근거가 섞인 묶음 선이 있으면 true. 묶음 이름과 배지에 섞였다는 표시를 다는 코드를 싣는다 */
+    mixedBundles?: boolean;
+    /** 지식 문서 팩을 쓰면 true. 서랍에 문서 정보를 그리는 코드를 싣는다 */
+    docs?: boolean;
+}
+export declare const THEME_STORAGE_KEY = "gestalt-architecture-theme";
+export declare const THEME_BOOT_SCRIPT = "(function () {\n  try {\n    var t = localStorage.getItem('gestalt-architecture-theme');\n    if (t === 'light' || t === 'dark') document.documentElement.setAttribute('data-theme', t);\n  } catch (e) {}\n})();";
+/**
+ * 페이지 동작 전부. 화면 이동, 확대와 이동, 서랍, 검색, 팝오버, 두 항목 화면을 맡는다.
+ * 문자열은 전부 textContent로만 넣는다. 근거 문자열은 외부 출처에서 온 값이라 HTML로 해석하면 스크립트가 실행될 수 있다.
+ * 템플릿 문자열 안이라 정규식과 문자열의 백슬래시는 두 번 적어야 브라우저에 한 번 남는다.
+ */
+export declare function renderClientScript(c: ClientConstants): string;
+//# sourceMappingURL=html-client.d.ts.map

package/dist/src/architecture/html-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-client.d.ts","sourceRoot":"","sources":["../../../src/architecture/html-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,qCAAqC;IACrC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA8MD,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAI9D,eAAO,MAAM,iBAAiB,sNAKxB,CAAC;AAEP;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAomD7D"}