@tienne/gestalt 0.102.0 → 0.104.0

package/dist/src/digest/slice.js

@@ -0,0 +1,48 @@
+import { rangeSpan } from './reports.js';
+/** `90`, `1:30`, `1:02:03`을 초로 바꾼다. 꼴이 틀리면 null이다 */
+export function parseTimeArg(value) {
+    const v = value.trim();
+    if (/^\d+(\.\d+)?$/.test(v))
+        return Number(v);
+    const m = /^(?:(\d+):)?(\d{1,2}):(\d{2})$/.exec(v);
+    if (!m)
+        return null;
+    const [h, mm, ss] = [Number(m[1] ?? 0), Number(m[2]), Number(m[3])];
+    if (ss >= 60 || (m[1] !== undefined && mm >= 60))
+        return null;
+    return h * 3600 + mm * 60 + ss;
+}
+/** `1:30-5:00` 꼴 구간을 [시작, 끝) 초로 바꾼다 */
+export function parseRangeArg(value) {
+    const parts = value.split('-');
+    const from = parts.length === 2 ? parseTimeArg(parts[0]) : null;
+    const to = parts.length === 2 ? parseTimeArg(parts[1]) : null;
+    if (from === null || to === null) {
+        throw new Error(`구간은 시작-끝 꼴이어야 해요(예: 1:30-5:00, 90-300): ${value}`);
+    }
+    if (!Number.isInteger(from) || !Number.isInteger(to)) {
+        throw new Error(`구간은 초 단위 정수여야 해요: ${value}`);
+    }
+    if (from >= to)
+        throw new Error(`구간 시작이 끝보다 앞이어야 해요: ${value}`);
+    return [from, to];
+}
+/**
+ * 구간 리포트가 읽을 문장만 잘라 낸다. 출처는 원래 스크립트의 문장 번호를 가리켜야 해서
+ * i를 다시 매기지 않는다. 그래서 transcript.json 꼴이 아니라 따로 저장한다
+ */
+export function sliceTranscript(transcript, range) {
+    const span = rangeSpan(range, transcript.segments);
+    if (!span) {
+        throw new Error(`구간 ${range[0]}~${range[1]}초에 든 문장이 없어요. 영상 길이는 ${transcript.meta.durationSec}초예요`);
+    }
+    return {
+        slug: transcript.slug,
+        range: [range[0], range[1]],
+        from: span.from,
+        to: span.to,
+        segments: transcript.segments.slice(span.from, span.to + 1),
+    };
+}
+export const sliceFileName = (range) => `transcript.slice-${Math.floor(range[0])}-${Math.floor(range[1])}.json`;
+//# sourceMappingURL=slice.js.map

package/dist/src/digest/slice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice.js","sourceRoot":"","sources":["../../../src/digest/slice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,qDAAqD;AACrD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;IACtE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACjC,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,IAAI,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACpB,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAsB,EACtB,KAAgC;IAEhC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,wBAAwB,UAAU,CAAC,IAAI,CAAC,WAAW,KAAK,CACnF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAgC,EAAU,EAAE,CACxE,oBAAoB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC"}

package/dist/src/digest/store.d.ts

@@ -0,0 +1,67 @@
+import { type Digest, type Transcript } from './schema.js';
+import { SLUG_PATTERN } from './schema-base.js';
+export { SLUG_PATTERN };
+export type RawRead = {
+    kind: 'missing';
+} | {
+    kind: 'invalid-json';
+    message: string;
+} | {
+    kind: 'ok';
+    value: unknown;
+};
+export type TranscriptRead = {
+    ok: true;
+    transcript: Transcript;
+} | {
+    ok: false;
+    code: 'TRANSCRIPT_NOT_FOUND' | 'TRANSCRIPT_INVALID';
+    message: string;
+};
+export declare function readRaw(path: string): RawRead;
+/** 저장소 바로 아래에서 slug 폴더가 아닌 자리. 사용자 템플릿이 여기 산다 */
+export declare const TEMPLATES_DIR_NAME = "templates";
+export declare function isValidSlug(slug: string): boolean;
+/**
+ * 제목을 ascii 소문자와 하이픈으로 줄이고 videoId를 끝에 붙인다.
+ * 한국어 제목은 남는 글자가 없어서 videoId만 남는다. 같은 제목의 다른 영상이 섞이지 않게 id는 항상 붙인다.
+ */
+export declare function slugFromMeta(videoIdOrName: string, title: string): string;
+/**
+ * 영상 요약 저장소: `<repoRoot>/.gestalt/digest/<slug>/`.
+ * `.gestalt/`는 gitignore 대상이라 프레임과 영상 캐시가 커밋에 딸려가지 않는다.
+ */
+export declare class DigestStore {
+    readonly root: string;
+    constructor(repoRoot: string);
+    templatesDir(): string;
+    /** slug는 경로 조각이라 패턴을 통과한 것만 받는다 */
+    dir(slug: string): string;
+    transcriptPath(slug: string): string;
+    digestPath(slug: string): string;
+    htmlPath(slug: string): string;
+    mdPath(slug: string): string;
+    framesDir(slug: string): string;
+    /** comments 명령이 받아 두는 댓글. 댓글 분석 템플릿이 읽는다 */
+    commentsPath(slug: string): string;
+    /** frames 명령이 받아 두는 저화질 영상. 다시 뽑을 때 또 받지 않으려고 둔다 */
+    videoCacheDir(slug: string): string;
+    /**
+     * 깨진 파일도 옮기지 않는다. validate나 render 같은 읽기 명령이 파일을 치우면
+     * 사용자는 왜 사라졌는지 모른다. ingest를 다시 돌리면 어차피 덮어쓴다
+     */
+    readTranscript(slug: string): TranscriptRead;
+    /**
+     * 요약은 세션이 손으로 쓰는 파일이라 깨져도 옮기지 않는다.
+     * 옮겨 버리면 validate 오류를 보고 고치려던 원본이 사라진다.
+     */
+    readDigestFile(slug: string): RawRead;
+    /** 없거나 형식이 틀리면 null. 이유가 필요하면 readDigestFile과 parseDigest를 쓴다 */
+    loadDigest(slug: string): Digest | null;
+    saveTranscript(transcript: Transcript): string;
+    saveDigest(digest: Digest): string;
+    saveHtml(slug: string, html: string): string;
+    saveMd(slug: string, md: string): string;
+    private writeText;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/src/digest/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/digest/store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgC,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,CAAC;AAIxB,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,sBAAsB,GAAG,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO7C;AAED,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAczE;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,QAAQ,EAAE,MAAM;IAK5B,YAAY,IAAI,MAAM;IAItB,mCAAmC;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/B,4CAA4C;IAC5C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC,oDAAoD;IACpD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAInC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IA4B5C;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC,iEAAiE;IACjE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvC,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAM9C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMlC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAIxC,OAAO,CAAC,SAAS;CAKlB"}

package/dist/src/digest/store.js

@@ -0,0 +1,152 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { writeJsonAtomic } from '../core/json-file.js';
+import { parseDigest, parseTranscript } from './schema.js';
+import { SLUG_PATTERN } from './schema-base.js';
+export { SLUG_PATTERN };
+const SLUG_MAX = 64;
+export function readRaw(path) {
+    if (!existsSync(path))
+        return { kind: 'missing' };
+    try {
+        return { kind: 'ok', value: JSON.parse(readFileSync(path, 'utf-8')) };
+    }
+    catch (e) {
+        return { kind: 'invalid-json', message: e instanceof Error ? e.message : String(e) };
+    }
+}
+/** 저장소 바로 아래에서 slug 폴더가 아닌 자리. 사용자 템플릿이 여기 산다 */
+export const TEMPLATES_DIR_NAME = 'templates';
+export function isValidSlug(slug) {
+    return SLUG_PATTERN.test(slug) && slug !== TEMPLATES_DIR_NAME;
+}
+/**
+ * 제목을 ascii 소문자와 하이픈으로 줄이고 videoId를 끝에 붙인다.
+ * 한국어 제목은 남는 글자가 없어서 videoId만 남는다. 같은 제목의 다른 영상이 섞이지 않게 id는 항상 붙인다.
+ */
+export function slugFromMeta(videoIdOrName, title) {
+    const tail = videoIdOrName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const head = title
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const room = SLUG_MAX - tail.length - 1;
+    const trimmed = room > 0 ? head.slice(0, room).replace(/-+$/, '') : '';
+    const slug = trimmed ? `${trimmed}-${tail}` : tail;
+    return slug || 'video';
+}
+/**
+ * 영상 요약 저장소: `<repoRoot>/.gestalt/digest/<slug>/`.
+ * `.gestalt/`는 gitignore 대상이라 프레임과 영상 캐시가 커밋에 딸려가지 않는다.
+ */
+export class DigestStore {
+    root;
+    constructor(repoRoot) {
+        // 외부 명령은 임시 cwd에서 돌아서 상대 경로를 넘기면 프레임 같은 산출물이 그 폴더에 쓰였다가 함께 지워진다
+        this.root = join(resolve(repoRoot), '.gestalt', 'digest');
+    }
+    templatesDir() {
+        return join(this.root, TEMPLATES_DIR_NAME);
+    }
+    /** slug는 경로 조각이라 패턴을 통과한 것만 받는다 */
+    dir(slug) {
+        if (!isValidSlug(slug))
+            throw new Error(`slug가 올바르지 않다: ${slug}`);
+        return join(this.root, slug);
+    }
+    transcriptPath(slug) {
+        return join(this.dir(slug), 'transcript.json');
+    }
+    digestPath(slug) {
+        return join(this.dir(slug), 'digest.json');
+    }
+    htmlPath(slug) {
+        return join(this.dir(slug), 'digest.html');
+    }
+    mdPath(slug) {
+        return join(this.dir(slug), 'digest.md');
+    }
+    framesDir(slug) {
+        return join(this.dir(slug), 'frames');
+    }
+    /** comments 명령이 받아 두는 댓글. 댓글 분석 템플릿이 읽는다 */
+    commentsPath(slug) {
+        return join(this.dir(slug), 'comments.json');
+    }
+    /** frames 명령이 받아 두는 저화질 영상. 다시 뽑을 때 또 받지 않으려고 둔다 */
+    videoCacheDir(slug) {
+        return join(this.dir(slug), 'cache');
+    }
+    /**
+     * 깨진 파일도 옮기지 않는다. validate나 render 같은 읽기 명령이 파일을 치우면
+     * 사용자는 왜 사라졌는지 모른다. ingest를 다시 돌리면 어차피 덮어쓴다
+     */
+    readTranscript(slug) {
+        const raw = readRaw(this.transcriptPath(slug));
+        const rerun = `gestalt digest ingest를 다시 돌려 주세요: ${slug}`;
+        if (raw.kind === 'missing') {
+            return {
+                ok: false,
+                code: 'TRANSCRIPT_NOT_FOUND',
+                message: `transcript.json이 없어요. 먼저 gestalt digest ingest를 돌려 주세요: ${slug}`,
+            };
+        }
+        if (raw.kind === 'invalid-json') {
+            return {
+                ok: false,
+                code: 'TRANSCRIPT_INVALID',
+                message: `transcript.json을 JSON으로 못 읽었어요(${raw.message}). ${rerun}`,
+            };
+        }
+        const parsed = parseTranscript(raw.value);
+        if (!parsed.ok) {
+            return {
+                ok: false,
+                code: 'TRANSCRIPT_INVALID',
+                message: `transcript.json 형식이 틀렸어요(${parsed.error.issues.slice(0, 3).join('; ')}). ${rerun}`,
+            };
+        }
+        return { ok: true, transcript: parsed.value };
+    }
+    /**
+     * 요약은 세션이 손으로 쓰는 파일이라 깨져도 옮기지 않는다.
+     * 옮겨 버리면 validate 오류를 보고 고치려던 원본이 사라진다.
+     */
+    readDigestFile(slug) {
+        return readRaw(this.digestPath(slug));
+    }
+    /** 없거나 형식이 틀리면 null. 이유가 필요하면 readDigestFile과 parseDigest를 쓴다 */
+    loadDigest(slug) {
+        const raw = this.readDigestFile(slug);
+        if (raw.kind !== 'ok')
+            return null;
+        const parsed = parseDigest(raw.value);
+        return parsed.ok ? parsed.value : null;
+    }
+    saveTranscript(transcript) {
+        const path = this.transcriptPath(transcript.slug);
+        writeJsonAtomic(path, transcript);
+        return path;
+    }
+    saveDigest(digest) {
+        const path = this.digestPath(digest.slug);
+        writeJsonAtomic(path, digest);
+        return path;
+    }
+    saveHtml(slug, html) {
+        return this.writeText(this.htmlPath(slug), slug, html);
+    }
+    saveMd(slug, md) {
+        return this.writeText(this.mdPath(slug), slug, md);
+    }
+    writeText(path, slug, content) {
+        mkdirSync(this.dir(slug), { recursive: true });
+        writeFileSync(path, content, 'utf-8');
+        return path;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/src/digest/store.js.map

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

package/dist/src/digest/svg.d.ts

@@ -0,0 +1,74 @@
+import type { Cite } from './schema.js';
+/**
+ * 확장 리포트와 대섹션 도식의 SVG를 그린다. 요약 층은 구조만 넘기고 좌표와 마크업은 여기서 정한다.
+ * 모델이 쓴 SVG를 그대로 실으면 스크립트나 외부 링크가 섞여 들어올 수 있어서 원문은 받지 않는다.
+ * 색은 CSS 변수를 쓰는 클래스로만 칠해 다크 모드를 따라간다
+ */
+export interface TreeNode {
+    label: string;
+    cite?: Cite;
+    children?: TreeNode[];
+}
+export interface SvgOptions {
+    /** cite.key 문장의 시작 시각. 있으면 노드에 data-sec을 달아 누르면 영상이 그 자리로 간다 */
+    sec?: (c: Cite) => number;
+}
+export declare const escapeXml: (s: string) => string;
+export declare function textWidth(text: string, fontSize?: number): number;
+/** maxPx 안에 들어오게 자른다. 잘랐으면 끝에 말줄임표를 붙인다 */
+export declare function fitLabel(text: string, maxPx?: number, fontSize?: number): {
+    text: string;
+    cut: boolean;
+};
+/**
+ * 왼쪽에서 오른쪽으로 펼친 트리. 잎마다 한 줄을 주고 부모는 첫 자식과 마지막 자식의 가운데에 둔다
+ */
+export declare function treeSvg(root: TreeNode, opts?: SvgOptions, ariaLabel?: string): string;
+export interface DiagramNode {
+    label: string;
+    cite?: Cite;
+}
+/** 단계 흐름. 넷까지는 가로로, 그보다 많으면 세로로 잇는다 */
+export declare function flowSvg(steps: DiagramNode[], opts?: SvgOptions, ariaLabel?: string): string;
+/**
+ * 순환. 상자를 타원 위에 12시부터 시계 방향으로 놓고 이웃끼리 타원 호로 잇는다.
+ * 상자 폭이 제각각이라 반지름은 공식으로 못 정하고 겹치지 않으면서 사이 호가 보일 때까지 키운다
+ */
+export declare function cycleSvg(steps: DiagramNode[], opts?: SvgOptions, ariaLabel?: string): string;
+export interface CompareColumn {
+    title: string;
+    items: DiagramNode[];
+}
+/** 비교. 열마다 머리 상자 아래로 항목을 쌓는다 */
+export declare function compareSvg(columns: CompareColumn[], opts?: SvgOptions, ariaLabel?: string): string;
+export interface TimelineEvent extends DiagramNode {
+    when: string;
+}
+/** 시점 글자는 WHEN_MAX(px) 폭까지 그리고 넘으면 말줄임으로 자른다. 줄 위 글자가 이웃 칸으로 넘어가면 어느 점의 시점인지 안 읽힌다 */
+export declare const WHEN_MAX = 120;
+/**
+ * 타임라인. 넷까지는 가로 줄 위에 시점, 아래에 상자를 두고 그보다 많으면 세로 줄 오른쪽에 시점과 상자를 둔다.
+ * 줄 끝 화살촉이 시간 방향이다
+ */
+export declare function timelineSvg(events: TimelineEvent[], opts?: SvgOptions, ariaLabel?: string): string;
+export interface MatrixAxis {
+    low: string;
+    high: string;
+}
+/**
+ * 2×2 매트릭스. cells는 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래 순서다.
+ * 세로축은 아래에서 위로, 가로축은 왼쪽에서 오른쪽으로 커진다
+ */
+export declare function matrixSvg(x: MatrixAxis, y: MatrixAxis, cells: DiagramNode[][], opts?: SvgOptions, ariaLabel?: string): string;
+/**
+ * 원인과 결과. 왼쪽 원인들이 가운데 현상으로 모이고 오른쪽 결과로 퍼진다.
+ * 아무 노드나 잇는 그래프는 받지 않는다. 자동 배치가 어렵고 선이 엉켜서다
+ */
+export declare function causalSvg(inputs: DiagramNode[], center: DiagramNode, outputs: DiagramNode[], opts?: SvgOptions, ariaLabel?: string): string;
+export interface BeforeAfterSide {
+    title?: string;
+    items: DiagramNode[];
+}
+/** 전후 비교. compare와 달리 두 칸 사이에 화살표를 그려 무엇이 바뀌었는지를 보인다 */
+export declare function beforeAfterSvg(before: BeforeAfterSide, after: BeforeAfterSide, opts?: SvgOptions, ariaLabel?: string): string;
+//# sourceMappingURL=svg.d.ts.map

package/dist/src/digest/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../../src/digest/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC;CAC3B;AAYD,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,MAMX,CAAC;AAW5B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,CAI/D;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAY,EACjB,QAAQ,SAAO,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAYhC;AAYD;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAE,UAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAkDzF;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AA2DD,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,GAAE,UAAe,EAAE,SAAS,SAAQ,GAAG,MAAM,CA8B9F;AAeD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,WAAW,EAAE,EACpB,IAAI,GAAE,UAAe,EACrB,SAAS,SAAQ,GAChB,MAAM,CAuER;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,gCAAgC;AAChC,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,GAAE,UAAe,EACrB,SAAS,SAAQ,GAChB,MAAM,CAiBR;AA0BD,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sFAAsF;AACtF,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EAAE,EACvB,IAAI,GAAE,UAAe,EACrB,SAAS,SAAS,GACjB,MAAM,CA6CR;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,KAAK,EAAE,WAAW,EAAE,EAAE,EACtB,IAAI,GAAE,UAAe,EACrB,SAAS,SAAS,GACjB,MAAM,CAiCR;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,EAAE,EACtB,IAAI,GAAE,UAAe,EACrB,SAAS,SAAQ,GAChB,MAAM,CA2BR;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,eAAe,EACtB,IAAI,GAAE,UAAe,EACrB,SAAS,SAAU,GAClB,MAAM,CAwBR"}