@tienne/gestalt 0.101.1 → 0.103.0

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

@@ -0,0 +1,38 @@
+import { type BlockType } from './blocks.js';
+/** 템플릿이 요약 전에 따로 받아 둬야 하는 자료. 없으면 스킬이 먼저 받는다 */
+export declare const TEMPLATE_NEEDS: readonly ["comments"];
+export interface DigestTemplate {
+    id: string;
+    title: string;
+    description: string;
+    blocks: BlockType[];
+    needs: (typeof TEMPLATE_NEEDS)[number][];
+    order: number;
+    /** 요약 에이전트에게 넘기는 지시. frontmatter 아래 본문이다 */
+    prompt: string;
+    source: 'builtin' | 'user';
+    path: string;
+    /** 레포의 사용자 템플릿이 같은 id의 기본 템플릿을 대신했다 */
+    overridesBuiltin?: boolean;
+}
+export interface TemplateLoad {
+    templates: DigestTemplate[];
+    warnings: string[];
+}
+export declare function parseTemplate(content: string, source: DigestTemplate['source'], path: string): DigestTemplate;
+/**
+ * 기본 템플릿과 레포의 사용자 템플릿을 읽는다. 같은 id면 사용자 것이 이긴다.
+ * 깨진 파일은 건너뛰고 warnings에 적는다. 템플릿 하나가 깨졌다고 나머지를 못 쓰게 하지 않는다
+ */
+export declare function loadTemplates(builtinDir: string | null, repoRoot: string): TemplateLoad;
+/** 스킬 디렉토리 아래 video-digest 스킬의 기본 템플릿 자리 */
+export declare const builtinTemplatesDir: (skillsDir: string) => string;
+/**
+ * 기본 템플릿 폴더를 찾는다. config.skillsDir은 cwd에 plugin/skills가 있으면 그쪽으로 풀려서
+ * 남의 레포에서는 video-digest가 없을 수 있다. 그때는 패키지에 실린 폴더로 내려간다
+ */
+export declare function findBuiltinTemplatesDir(skillsDir?: string): string | null;
+export declare const loadDigestTemplates: (repoRoot: string, skillsDir?: string) => TemplateLoad;
+/** lint가 받는 꼴로 바꾼다 */
+export declare const templateMap: (templates: DigestTemplate[]) => Map<string, DigestTemplate>;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/digest/templates.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAM5E,gDAAgD;AAChD,eAAO,MAAM,cAAc,uBAAwB,CAAC;AA2BpD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAChC,IAAI,EAAE,MAAM,GACX,cAAc,CAahB;AAkCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAgBvF;AAED,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,KAAG,MACV,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzE;AAED,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,KAAG,YACd,CAAC;AAE9D,sBAAsB;AACtB,eAAO,MAAM,WAAW,GAAI,WAAW,cAAc,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAC1C,CAAC"}

package/dist/src/digest/templates.js

@@ -0,0 +1,125 @@
+import { existsSync, lstatSync, readdirSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import matter from 'gray-matter';
+import { z } from 'zod';
+import { BLOCK_TYPES, templateIdSchema } from './blocks.js';
+import { DigestStore } from './store.js';
+/** 템플릿 하나는 프롬프트 한 장이라 이보다 크면 잘못 넣은 파일로 본다 */
+const TEMPLATE_MAX_BYTES = 64 * 1024;
+/** 템플릿이 요약 전에 따로 받아 둬야 하는 자료. 없으면 스킬이 먼저 받는다 */
+export const TEMPLATE_NEEDS = ['comments'];
+// src/research/source-schema.ts와 같은 이유로 js 엔진을 막는다. 사용자 폴더 파일이라도 frontmatter가 코드로 돌면 안 된다
+const SAFE_MATTER_OPTIONS = {
+    engines: {
+        js: () => {
+            throw new Error('js frontmatter는 쓰지 않는다');
+        },
+        javascript: () => {
+            throw new Error('js frontmatter는 쓰지 않는다');
+        },
+    },
+};
+const frontmatterSchema = z.object({
+    id: templateIdSchema,
+    title: z.string().trim().min(1).max(40),
+    description: z.string().trim().min(1).max(200),
+    blocks: z
+        .array(z.enum(BLOCK_TYPES))
+        .min(1)
+        .transform((list) => [...new Set(list)]),
+    needs: z.array(z.enum(TEMPLATE_NEEDS)).default([]),
+    /** 탭과 메뉴에 놓이는 순서. 작을수록 앞이다 */
+    order: z.number().int().default(100),
+});
+export function parseTemplate(content, source, path) {
+    if (Buffer.byteLength(content, 'utf-8') > TEMPLATE_MAX_BYTES) {
+        throw new Error('템플릿이 64KB를 넘는다');
+    }
+    const parsed = matter(content, SAFE_MATTER_OPTIONS);
+    const fm = frontmatterSchema.safeParse(parsed.data);
+    if (!fm.success) {
+        const issues = fm.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`);
+        throw new Error(`frontmatter 형식 오류: ${issues.join('; ')}`);
+    }
+    const prompt = parsed.content.trim();
+    if (!prompt)
+        throw new Error('본문(요약 지시)이 비어 있다');
+    return { ...fm.data, prompt, source, path };
+}
+function readDir(dir, source, warnings) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const name of readdirSync(dir).sort()) {
+        if (!name.endsWith('.md'))
+            continue;
+        const path = join(dir, name);
+        // 심링크는 레포 밖 파일을 템플릿 지시로 끌어올 수 있어 따라가지 않는다
+        const st = lstatSync(path);
+        if (st.isSymbolicLink()) {
+            warnings.push(`${path}: 심링크라 건너뛰었다`);
+            continue;
+        }
+        if (!st.isFile())
+            continue;
+        if (st.size > TEMPLATE_MAX_BYTES) {
+            warnings.push(`${path}: 템플릿이 64KB를 넘어 건너뛰었다`);
+            continue;
+        }
+        try {
+            const t = parseTemplate(readFileSync(path, 'utf-8'), source, path);
+            // 파일 이름과 id가 다르면 템플릿을 찾을 때 둘 중 무엇을 써야 할지 헷갈린다
+            if (`${t.id}.md` !== name) {
+                warnings.push(`${path}: 파일 이름이 id(${t.id})와 달라 건너뛰었다`);
+                continue;
+            }
+            out.push(t);
+        }
+        catch (e) {
+            warnings.push(`${path}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return out;
+}
+/**
+ * 기본 템플릿과 레포의 사용자 템플릿을 읽는다. 같은 id면 사용자 것이 이긴다.
+ * 깨진 파일은 건너뛰고 warnings에 적는다. 템플릿 하나가 깨졌다고 나머지를 못 쓰게 하지 않는다
+ */
+export function loadTemplates(builtinDir, repoRoot) {
+    const warnings = [];
+    const byId = new Map();
+    if (builtinDir)
+        for (const t of readDir(builtinDir, 'builtin', warnings))
+            byId.set(t.id, t);
+    for (const t of readDir(new DigestStore(repoRoot).templatesDir(), 'user', warnings)) {
+        if (byId.has(t.id)) {
+            warnings.push(`${t.path}: 기본 템플릿 ${t.id}를 대신한다`);
+            byId.set(t.id, { ...t, overridesBuiltin: true });
+        }
+        else {
+            byId.set(t.id, t);
+        }
+    }
+    const templates = [...byId.values()].sort((a, b) => a.order - b.order || a.id.localeCompare(b.id));
+    return { templates, warnings };
+}
+/** 스킬 디렉토리 아래 video-digest 스킬의 기본 템플릿 자리 */
+export const builtinTemplatesDir = (skillsDir) => join(skillsDir, 'video-digest', 'templates');
+// src/digest와 dist/digest 둘 다 두 칸 위가 패키지 루트다
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+/**
+ * 기본 템플릿 폴더를 찾는다. config.skillsDir은 cwd에 plugin/skills가 있으면 그쪽으로 풀려서
+ * 남의 레포에서는 video-digest가 없을 수 있다. 그때는 패키지에 실린 폴더로 내려간다
+ */
+export function findBuiltinTemplatesDir(skillsDir) {
+    const candidates = [
+        skillsDir ? builtinTemplatesDir(skillsDir) : null,
+        builtinTemplatesDir(join(PACKAGE_ROOT, 'plugin', 'skills')),
+    ];
+    return candidates.find((d) => d !== null && existsSync(d)) ?? null;
+}
+export const loadDigestTemplates = (repoRoot, skillsDir) => loadTemplates(findBuiltinTemplatesDir(skillsDir), repoRoot);
+/** lint가 받는 꼴로 바꾼다 */
+export const templateMap = (templates) => new Map(templates.map((t) => [t.id, t]));
+//# sourceMappingURL=templates.js.map

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

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

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

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { type Transcript } from './schema.js';
+/**
+ * 스크립트 번역 한 벌. 세션이 쓰는 파일이라 영상 자막만큼 믿지 않는다.
+ * 번역문은 뷰어에 글자로만 나가고 HTML로 해석되지 않는다
+ */
+export declare const translationInputSchema: z.ZodObject<{
+    lang: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        i: z.ZodNumber;
+        translation: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        translation: string;
+        i: number;
+    }, {
+        translation: string;
+        i: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        translation: string;
+        i: number;
+    }[];
+    lang: string;
+}, {
+    items: {
+        translation: string;
+        i: number;
+    }[];
+    lang: string;
+}>;
+export type TranslationInput = z.infer<typeof translationInputSchema>;
+export interface TranslationResult {
+    transcript: Transcript;
+    applied: number;
+    /** 스크립트에 없는 문장 번호. 이 항목은 넣지 않는다 */
+    unknown: number[];
+    /** 번역이 안 붙은 문장 번호 */
+    missing: number[];
+}
+/**
+ * 번역을 문장 번호로 붙인다. 이미 다른 언어 번역이 붙어 있으면 통째로 갈아 끼운다.
+ * 언어가 섞이면 토글 하나로 어느 언어를 보는지 알 수 없어서다
+ */
+export declare function applyTranslation(transcript: Transcript, input: unknown): TranslationResult;
+//# sourceMappingURL=translate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../../src/digest/translate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAUjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA2B1F"}

package/dist/src/digest/translate.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { LANG_TAG_PATTERN } from './schema.js';
+/**
+ * 스크립트 번역 한 벌. 세션이 쓰는 파일이라 영상 자막만큼 믿지 않는다.
+ * 번역문은 뷰어에 글자로만 나가고 HTML로 해석되지 않는다
+ */
+export const translationInputSchema = z.object({
+    lang: z.string().regex(LANG_TAG_PATTERN, '언어 태그(ko, en, pt-BR) 꼴이어야 한다'),
+    items: z
+        .array(z.object({
+        i: z.number().int().nonnegative(),
+        translation: z.string().trim().min(1).max(2000),
+    }))
+        .min(1),
+});
+/**
+ * 번역을 문장 번호로 붙인다. 이미 다른 언어 번역이 붙어 있으면 통째로 갈아 끼운다.
+ * 언어가 섞이면 토글 하나로 어느 언어를 보는지 알 수 없어서다
+ */
+export function applyTranslation(transcript, input) {
+    const parsed = translationInputSchema.safeParse(input);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .slice(0, 3)
+            .map((i) => `${i.path.join('.') || '(루트)'}: ${i.message}`);
+        throw new Error(`번역 형식 오류: ${issues.join('; ')}`);
+    }
+    const { lang, items } = parsed.data;
+    const sameLang = transcript.meta.translationLang === lang;
+    const byIndex = new Map();
+    const unknown = [];
+    for (const item of items) {
+        if (item.i >= transcript.segments.length)
+            unknown.push(item.i);
+        else
+            byIndex.set(item.i, item.translation);
+    }
+    const segments = transcript.segments.map((s) => {
+        const next = byIndex.get(s.i) ?? (sameLang ? s.translation : undefined);
+        const { translation: _old, ...rest } = s;
+        return next === undefined ? rest : { ...rest, translation: next };
+    });
+    return {
+        transcript: { ...transcript, meta: { ...transcript.meta, translationLang: lang }, segments },
+        applied: byIndex.size,
+        unknown,
+        missing: segments.filter((s) => s.translation === undefined).map((s) => s.i),
+    };
+}
+//# sourceMappingURL=translate.js.map

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

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

package/dist/src/digest/viewer-js.d.ts

@@ -0,0 +1,4 @@
+export declare const VIEWER_JS: string;
+/** CSP script-src에 싣는 VIEWER_JS 해시. 렌더가 이 문자열을 그대로 인라인으로 싣는다 */
+export declare const VIEWER_JS_SHA256: string;
+//# sourceMappingURL=viewer-js.d.ts.map

package/dist/src/digest/viewer-js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-js.d.ts","sourceRoot":"","sources":["../../../src/digest/viewer-js.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,QAgsBrB,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,QAAkE,CAAC"}