dsh-convert-core 0.1.0-alpha.1

package/lib/media/binaries.js

@@ -0,0 +1,60 @@
+/**
+ * 外部二进制探测。
+ *
+ * 这个包与文档类转换器的根本差别就在这里:它需要 `ffmpeg`/`ffprobe`,转写档还需要
+ * `uvx`(用来按需拉起 faster-whisper / RapidOCR)。探测结果既用于 `probe()`(宿主上报能力),
+ * 也用于错误信息里给出**可操作**的安装命令 —— 缺依赖要吵,但不能静默降级。
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export const FFMPEG_HINT = '装 ffmpeg(含 ffprobe):macOS `brew install ffmpeg`,Debian/Ubuntu `apt install ffmpeg`。';
+export const UVX_HINT = '安装 uv(内含 uvx):`curl -LsSf https://astral.sh/uv/install.sh | sh`;或用 tools.uvxPath 指向已有的 uvx。';
+/** 每次都真跑一次 `-version`;调用方(宿主)自己缓存,别在这里藏状态。 */
+export async function probeTools(options = {}) {
+    const versions = {};
+    try {
+        const { stdout } = await execFileAsync('ffprobe', ['-version']);
+        const found = /ffprobe version (\S+)/.exec(stdout)?.[1];
+        if (found)
+            versions.ffprobe = found;
+    }
+    catch {
+        /* 缺失由调用方汇报 */
+    }
+    try {
+        const { stdout } = await execFileAsync('ffmpeg', ['-version']);
+        const found = /ffmpeg version (\S+)/.exec(stdout)?.[1];
+        if (found)
+            versions.ffmpeg = found;
+    }
+    catch {
+        /* 缺失由调用方汇报 */
+    }
+    try {
+        const uvx = options.uvxPath?.trim() || process.env.MEDIA_TO_MD_UVX?.trim() || 'uvx';
+        const { stdout } = await execFileAsync(uvx, ['--version']);
+        // `uvx --version` 形如 `uvx 0.11.6 (65950801c 2026-04-09 aarch64-apple-darwin)`,只取版本号。
+        const found = /(\d+\.\d+\.\d+)/.exec(stdout)?.[1];
+        if (found)
+            versions.uvx = found;
+    }
+    catch {
+        /* 可选依赖:只有转写/OCR 档才要求 */
+    }
+    return versions;
+}
+export async function runFfmpeg(args, options = {}) {
+    try {
+        const { stdout, stderr } = await execFileAsync('ffmpeg', args, { maxBuffer: 32 * 1024 * 1024 });
+        return { stdout, stderr };
+    }
+    catch (cause) {
+        if (options.allowFailure) {
+            const error = cause;
+            return { stdout: error.stdout ?? '', stderr: error.stderr ?? '' };
+        }
+        throw cause;
+    }
+}
+//# sourceMappingURL=binaries.js.map

package/lib/media/binaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaries.js","sourceRoot":"","sources":["../../src/media/binaries.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAQzC,MAAM,CAAC,MAAM,WAAW,GAAG,qFAAqF,CAAA;AAChH,MAAM,CAAC,MAAM,QAAQ,GAAG,6FAA6F,CAAA;AAMrH,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAwB,EAAE;IACzD,MAAM,QAAQ,GAAiB,EAAE,CAAA;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;QAC/D,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACvD,IAAI,KAAK;YAAE,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;QAC9D,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACtD,IAAI,KAAK;YAAE,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,KAAK,CAAA;QACnF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;QAC1D,qFAAqF;QACrF,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACjD,IAAI,KAAK;YAAE,QAAQ,CAAC,GAAG,GAAG,KAAK,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,UAAsC,EAAE;IACtF,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAA;QAC/F,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,KAA6C,CAAA;YAC3D,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAA;QACnE,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/lib/media/convert.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 主编排:一个本地文件 → 知识就绪 Markdown + 本地图片。
+ *
+ * 档位规则(刻意保持简单可预测):
+ *
+ * | mode            | 字幕 | 转写 | 说明 |
+ * | --------------- | ---- | ---- | ---- |
+ * | `auto`(默认)  | 优先 | 仅当允许下载模型 | 有字幕就绝不碰模型 |
+ * | `subtitle-only` | 只用 | 永不 | 拿不到字幕就是"没有逐字稿",不报错 |
+ * | `transcribe`    | 跳过 | 强制 | 必须允许下载模型 |
+ * | `frames-only`   | 跳过 | 跳过 | 只要关键帧(连 OCR 也要显式开) |
+ */
+import { type MediaToMarkdownOptions, type MediaToMarkdownResult } from './types.js';
+export declare const VIDEO_EXTENSIONS: string[];
+export declare const AUDIO_EXTENSIONS: string[];
+export declare const IMAGE_EXTENSIONS: string[];
+export declare const MEDIA_EXTENSIONS: string[];
+export declare function convertMedia(options: MediaToMarkdownOptions): Promise<MediaToMarkdownResult>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/media/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/media/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAE3B,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,gBAAgB,UAE5B,CAAA;AACD,eAAO,MAAM,gBAAgB,UAE5B,CAAA;AACD,eAAO,MAAM,gBAAgB,UAE5B,CAAA;AACD,eAAO,MAAM,gBAAgB,UAAkE,CAAA;AA2B/F,wBAAsB,YAAY,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8JlG"}

package/lib/media/convert.js

@@ -0,0 +1,210 @@
+/**
+ * 主编排:一个本地文件 → 知识就绪 Markdown + 本地图片。
+ *
+ * 档位规则(刻意保持简单可预测):
+ *
+ * | mode            | 字幕 | 转写 | 说明 |
+ * | --------------- | ---- | ---- | ---- |
+ * | `auto`(默认)  | 优先 | 仅当允许下载模型 | 有字幕就绝不碰模型 |
+ * | `subtitle-only` | 只用 | 永不 | 拿不到字幕就是"没有逐字稿",不报错 |
+ * | `transcribe`    | 跳过 | 强制 | 必须允许下载模型 |
+ * | `frames-only`   | 跳过 | 跳过 | 只要关键帧(连 OCR 也要显式开) |
+ */
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { mkdtemp, readFile, rm, stat } from 'node:fs/promises';
+import { basename, extname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { probeTools, runFfmpeg, FFMPEG_HINT } from './binaries.js';
+import { buildMarkdown } from './markdown.js';
+import { extractKeyframes, extractSubtitles, parseSrt, probeMedia } from './media.js';
+import { describeModel, ocrImages, transcribe } from './models.js';
+import { MediaToMarkdownError, } from './types.js';
+export const VIDEO_EXTENSIONS = [
+    '.mp4', '.m4v', '.mov', '.mkv', '.webm', '.avi', '.flv', '.wmv', '.mpg', '.mpeg', '.ogv',
+];
+export const AUDIO_EXTENSIONS = [
+    '.mp3', '.m4a', '.wav', '.aac', '.flac', '.ogg', '.opus', '.aiff', '.aif', '.amr', '.wma',
+];
+export const IMAGE_EXTENSIONS = [
+    '.png', '.jpg', '.jpeg', '.webp', '.gif', '.bmp', '.tif', '.tiff', '.heic',
+];
+export const MEDIA_EXTENSIONS = [...VIDEO_EXTENSIONS, ...AUDIO_EXTENSIONS, ...IMAGE_EXTENSIONS];
+const IMAGE_MAGIC = [
+    { test: data => data.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])), extension: 'png', contentType: 'image/png' },
+    { test: data => data[0] === 0xff && data[1] === 0xd8, extension: 'jpg', contentType: 'image/jpeg' },
+    { test: data => data.subarray(0, 3).toString('latin1') === 'GIF', extension: 'gif', contentType: 'image/gif' },
+    { test: data => data.subarray(0, 4).toString('latin1') === 'RIFF' && data.subarray(8, 12).toString('latin1') === 'WEBP', extension: 'webp', contentType: 'image/webp' },
+    { test: data => data.subarray(0, 2).toString('latin1') === 'BM', extension: 'bmp', contentType: 'image/bmp' },
+];
+async function sha256OfFile(file) {
+    const hash = createHash('sha256');
+    await new Promise((resolve, reject) => {
+        createReadStream(file)
+            .on('data', chunk => hash.update(chunk))
+            .on('error', reject)
+            .on('end', () => resolve());
+    });
+    return `sha256:${hash.digest('hex')}`;
+}
+function progressReporter(options) {
+    return (stage, progress, message) => {
+        options.onProgress?.({ stage, progress, ...(message ? { message } : {}) });
+    };
+}
+export async function convertMedia(options) {
+    const file = options.file;
+    const fileInfo = await stat(file).catch(() => undefined);
+    if (!fileInfo?.isFile()) {
+        throw new MediaToMarkdownError('INPUT_NOT_A_FILE', `输入不是文件:${file}`);
+    }
+    const versions = await probeTools({ ...(options.tools?.uvxPath ? { uvxPath: options.tools.uvxPath } : {}) });
+    if (!versions.ffmpeg || !versions.ffprobe) {
+        const missing = [!versions.ffprobe ? 'ffprobe' : null, !versions.ffmpeg ? 'ffmpeg' : null].filter(Boolean).join('、');
+        throw new MediaToMarkdownError('DEPENDENCY_MISSING', `缺少外部二进制:${missing}`, FFMPEG_HINT);
+    }
+    const extension = extname(file).toLowerCase();
+    const title = options.title?.trim() || basename(file, extname(file));
+    const mode = options.mode ?? 'auto';
+    const report = progressReporter(options);
+    const warnings = [];
+    const scratch = await mkdtemp(join(tmpdir(), 'media-to-md-'));
+    const dependencyVersions = { ffmpeg: versions.ffmpeg };
+    if (versions.uvx)
+        dependencyVersions.uvx = versions.uvx;
+    const externalId = await sha256OfFile(file);
+    try {
+        /* ------------------------------ 图片档 ------------------------------ */
+        if (IMAGE_EXTENSIONS.includes(extension)) {
+            report('probing', null, '读取图片');
+            const bytes = await readFile(file);
+            const magic = IMAGE_MAGIC.find(entry => entry.test(bytes));
+            const assetExtension = magic?.extension ?? (extension.replace('.', '') || 'bin');
+            const rel = `assets/image-${createHash('sha1').update(bytes).digest('hex').slice(0, 12)}.${assetExtension}`;
+            let ocrText = '';
+            if (options.imageOcr) {
+                report('ocr', null, '本地 OCR');
+                const ocr = await ocrImages([file], options.tools, options.signal);
+                warnings.push(...ocr.warnings);
+                ocrText = (ocr.entries[0]?.text ?? '').trim();
+                warnings.push({ code: 'IMAGE_OCR_ENABLED', message: '已显式开启图片 OCR(imageOcr=true)。' });
+            }
+            else {
+                warnings.push({ code: 'IMAGE_OCR_SKIPPED', message: '未做图片 OCR:图片直接收录、靠多模态召回;如需文字请设 imageOcr=true。' });
+            }
+            const meta = {
+                sourceFormat: 'image',
+                containerExtension: assetExtension,
+                durationSeconds: 0,
+                sizeBytes: fileInfo.size,
+                hasVideo: false,
+                hasAudio: false,
+                hasSubtitleTrack: false,
+                transcriptSource: 'none',
+            };
+            return {
+                title: title.slice(0, 300),
+                markdown: buildMarkdown({ title, meta, frames: [], cues: [], image: { rel, ocrText } }),
+                assets: [{ rel, data: bytes, ...(magic ? { contentType: magic.contentType } : {}) }],
+                meta,
+                transcript: { source: 'none', cues: [] },
+                warnings,
+                dependencyVersions,
+                externalId,
+            };
+        }
+        /* ------------------------------ 音视频档 ------------------------------ */
+        report('probing', 0.05, '探测媒体信息');
+        const probe = await probeMedia(file, options.signal);
+        const sourceFormat = probe.hasVideo ? 'video' : 'audio';
+        let frames = [];
+        if (probe.hasVideo) {
+            report('frames', 0.2, mode === 'frames-only' ? '抽取关键帧(只要帧)' : '抽取关键帧');
+            frames = await extractKeyframes(file, probe.durationSeconds, scratch, options.frames ?? {}, options.signal);
+        }
+        if (frames.length > 0) {
+            warnings.push({ code: 'KEYFRAMES_EXTRACTED', message: `已抽出 ${frames.length} 个关键帧并落地为 assets/。` });
+        }
+        let frameOcr = new Map();
+        if (options.ocrFrames && frames.length > 0) {
+            report('ocr', 0.35, '关键帧画面文字 OCR');
+            // OCR 读的是落盘的真实路径(scratch 下),结果再按顺序映射回 rel。
+            const ocr = await ocrImages(frames.map(frame => frame.sourcePath), options.tools, options.signal);
+            warnings.push(...ocr.warnings);
+            const bySourcePath = new Map(ocr.entries.map(entry => [entry.path, entry.text.trim()]));
+            frameOcr = new Map(frames
+                .map(frame => [frame.rel, bySourcePath.get(frame.sourcePath) ?? ''])
+                .filter(([, text]) => text.length > 0));
+        }
+        let cues = [];
+        let transcriptSource = 'none';
+        if (mode !== 'frames-only') {
+            report('subtitles', 0.45, '查找字幕轨');
+            const subtitleText = await extractSubtitles(file, probe, scratch, options.signal);
+            if (subtitleText) {
+                cues = parseSrt(subtitleText);
+                transcriptSource = 'subtitle';
+                warnings.push({ code: 'SUBTITLE_USED', message: `使用字幕轨/旁挂字幕(${cues.length} 条),未下载任何转写模型。` });
+            }
+            else if (!probe.hasAudio) {
+                warnings.push({ code: 'NO_AUDIO_TRACK', message: '该文件没有音频轨,也没有字幕。' });
+            }
+            else if (mode === 'subtitle-only') {
+                warnings.push({ code: 'SUBTITLE_MISSING', message: '没有可用字幕;subtitle-only 档不做转写。' });
+            }
+            else {
+                const asr = options.asr ?? {};
+                const model = asr.model?.trim() || 'small';
+                const mayDownload = asr.allowModelDownload === true || isLocalModelPath(model);
+                if (mode === 'auto' && !mayDownload) {
+                    throw new MediaToMarkdownError('ASR_MODEL_REQUIRED', `无字幕,转写需要下载本地 whisper 模型(${model},${describeModel(model)});当前未允许下载,已放弃转换。`, '确认后设 allowModelDownload=true 重试;中文建议 model=large-v3-turbo、language=zh。也可以先用 ffmpeg 抽字幕轨,或改用带字幕的来源。');
+                }
+                report('transcribing', 0.6, '本地转写(首次会下载模型)');
+                const audio = join(scratch, 'audio-16k.wav');
+                await runFfmpeg(['-hide_banner', '-loglevel', 'error', '-y', '-i', file, '-vn', '-ac', '1', '-ar', '16000', '-c:a', 'pcm_s16le', audio]);
+                const result = await transcribe(audio, scratch, asr, options.tools, options.signal);
+                cues = result.cues;
+                transcriptSource = cues.length > 0 ? 'transcription' : 'none';
+                warnings.push({
+                    code: 'ASR_LOCAL',
+                    message: `无字幕,已用本地 faster-whisper(${result.model},语言 ${result.language ?? 'auto'})转写;音频未离开本机。`,
+                });
+            }
+        }
+        report('assembling', 0.9, '装配 Markdown');
+        const meta = {
+            sourceFormat,
+            containerExtension: extension.replace('.', ''),
+            durationSeconds: probe.durationSeconds,
+            sizeBytes: probe.sizeBytes,
+            ...(probe.width ? { width: probe.width } : {}),
+            ...(probe.height ? { height: probe.height } : {}),
+            ...(probe.fps ? { fps: probe.fps } : {}),
+            ...(probe.videoCodec ? { videoCodec: probe.videoCodec } : {}),
+            ...(probe.audioCodec ? { audioCodec: probe.audioCodec } : {}),
+            hasVideo: probe.hasVideo,
+            hasAudio: probe.hasAudio,
+            hasSubtitleTrack: probe.hasSubtitleTrack,
+            transcriptSource,
+        };
+        return {
+            title: title.slice(0, 300),
+            markdown: buildMarkdown({ title, meta, frames, cues, frameOcr }),
+            assets: frames.map(frame => ({ rel: frame.rel, data: frame.data, contentType: 'image/jpeg' })),
+            meta,
+            transcript: { source: transcriptSource, cues },
+            warnings,
+            dependencyVersions,
+            externalId,
+        };
+    }
+    finally {
+        if (!options.keepScratch)
+            await rm(scratch, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+/** 模型名看着像路径(本地目录)时不视为需要下载。 */
+function isLocalModelPath(model) {
+    return model.includes('/') || model.startsWith('.') || model.startsWith('~');
+}
+//# sourceMappingURL=convert.js.map

package/lib/media/convert.js.map

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

package/lib/media/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * media-to-md —— 本地音视频 / 图片 → Markdown + 本地图片。
+ *
+ * 纯本地:不调用云端 API、不调用大模型。两个专用小模型(whisper 语音识别、RapidOCR
+ * 画面文字)都是可选档位,是否允许下载由调用方显式决定。
+ *
+ * ```ts
+ * import { convertMedia } from 'dsh-convert-core/media'
+ *
+ * const result = await convertMedia({
+ *   file: '/abs/path/clip.mp4',
+ *   mode: 'auto',
+ *   asr: { model: 'large-v3-turbo', language: 'zh', allowModelDownload: true },
+ *   frames: { samples: 12, maxFrames: 40, sceneThreshold: 0.3 },
+ *   onProgress: p => console.log(p.stage, p.progress),
+ * })
+ * // result.markdown / result.assets / result.warnings / result.meta
+ * ```
+ */
+export { convertMedia, MEDIA_EXTENSIONS, VIDEO_EXTENSIONS, AUDIO_EXTENSIONS, IMAGE_EXTENSIONS } from './convert.js';
+export { convertScannedDocument } from './scanned.js';
+export { probeTools, FFMPEG_HINT, UVX_HINT, type ToolVersions } from './binaries.js';
+export { probeMedia, extractKeyframes, extractSubtitles, parseSrt, type MediaProbe, type ExtractedFrame } from './media.js';
+export { transcribe, ocrImages, ASR_MODEL_SIZES, describeModel, type TranscriptionResult, type OcrEntry } from './models.js';
+export { buildMarkdown, buildScannedMarkdown, formatClock, type BuildMarkdownInput, type BuildScannedMarkdownInput } from './markdown.js';
+export { MediaToMarkdownError, type MediaAsset, type MediaAsrOptions, type MediaCue, type MediaFrameOptions, type MediaMeta, type MediaMode, type MediaSourceFormat, type MediaToMarkdownOptions, type MediaToMarkdownProgress, type MediaToMarkdownResult, type MediaToolOptions, type MediaWarning, type ScannedPage, type ScannedPdfOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACnH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3H,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC5H,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,eAAe,CAAA;AACzI,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAA"}

package/lib/media/index.js

@@ -0,0 +1,27 @@
+/**
+ * media-to-md —— 本地音视频 / 图片 → Markdown + 本地图片。
+ *
+ * 纯本地:不调用云端 API、不调用大模型。两个专用小模型(whisper 语音识别、RapidOCR
+ * 画面文字)都是可选档位,是否允许下载由调用方显式决定。
+ *
+ * ```ts
+ * import { convertMedia } from 'dsh-convert-core/media'
+ *
+ * const result = await convertMedia({
+ *   file: '/abs/path/clip.mp4',
+ *   mode: 'auto',
+ *   asr: { model: 'large-v3-turbo', language: 'zh', allowModelDownload: true },
+ *   frames: { samples: 12, maxFrames: 40, sceneThreshold: 0.3 },
+ *   onProgress: p => console.log(p.stage, p.progress),
+ * })
+ * // result.markdown / result.assets / result.warnings / result.meta
+ * ```
+ */
+export { convertMedia, MEDIA_EXTENSIONS, VIDEO_EXTENSIONS, AUDIO_EXTENSIONS, IMAGE_EXTENSIONS } from './convert.js';
+export { convertScannedDocument } from './scanned.js';
+export { probeTools, FFMPEG_HINT, UVX_HINT } from './binaries.js';
+export { probeMedia, extractKeyframes, extractSubtitles, parseSrt } from './media.js';
+export { transcribe, ocrImages, ASR_MODEL_SIZES, describeModel } from './models.js';
+export { buildMarkdown, buildScannedMarkdown, formatClock } from './markdown.js';
+export { MediaToMarkdownError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/lib/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACnH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAA;AACpF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAwC,MAAM,YAAY,CAAA;AAC3H,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAA2C,MAAM,aAAa,CAAA;AAC5H,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAA2D,MAAM,eAAe,CAAA;AACzI,OAAO,EACL,oBAAoB,GAerB,MAAM,YAAY,CAAA"}

package/lib/media/markdown.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Markdown 装配 —— 纯模板,零模型、零网络。
+ *
+ * 产物只返回**正文**:front matter 是宿主的契约(转换内核自己写,CLI 自己写),
+ * 这个包不该替宿主决定 front matter 字段。
+ */
+import type { ExtractedFrame } from './media.js';
+import type { MediaCue, MediaMeta } from './types.js';
+export declare function formatClock(seconds: number): string;
+export interface BuildMarkdownInput {
+    title: string;
+    meta: MediaMeta;
+    frames: ExtractedFrame[];
+    cues: MediaCue[];
+    /** 关键帧 rel → 画面文字(仅在开启帧 OCR 时非空)。 */
+    frameOcr?: Map<string, string>;
+    /** 图片输入的资产与文字。 */
+    image?: {
+        rel: string;
+        ocrText: string;
+    };
+}
+export declare function buildMarkdown(input: BuildMarkdownInput): string;
+export interface BuildScannedMarkdownInput {
+    title: string;
+    totalPages: number;
+    pageImages: boolean;
+    pages: Array<{
+        index: number;
+        rel: string;
+        text: string;
+    }>;
+}
+/**
+ * 扫描档的 Markdown:逐页一节,页内先图后文。
+ *
+ * 不承诺版面顺序与表格结构 —— 这一档只负责"把图片页里的字读出来"。
+ */
+export declare function buildScannedMarkdown(input: BuildScannedMarkdownInput): string;
+//# sourceMappingURL=markdown.d.ts.map

package/lib/media/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/media/markdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAErD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,IAAI,EAAE,QAAQ,EAAE,CAAA;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,kBAAkB;IAClB,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CACzC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA2C/D;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAgB7E"}

package/lib/media/markdown.js

@@ -0,0 +1,89 @@
+/**
+ * Markdown 装配 —— 纯模板,零模型、零网络。
+ *
+ * 产物只返回**正文**:front matter 是宿主的契约(转换内核自己写,CLI 自己写),
+ * 这个包不该替宿主决定 front matter 字段。
+ */
+export function formatClock(seconds) {
+    const total = Math.max(0, Math.floor(seconds));
+    const hours = Math.floor(total / 3600);
+    const minutes = Math.floor((total % 3600) / 60);
+    const secs = total % 60;
+    const mm = String(minutes).padStart(2, '0');
+    const ss = String(secs).padStart(2, '0');
+    return hours > 0 ? `${String(hours).padStart(2, '0')}:${mm}:${ss}` : `${mm}:${ss}`;
+}
+export function buildMarkdown(input) {
+    const { title, meta, frames, cues, image } = input;
+    const frameOcr = input.frameOcr ?? new Map();
+    const lines = [`# ${title}`, ''];
+    const facts = [
+        meta.durationSeconds > 0 ? `时长 ${formatClock(meta.durationSeconds)}` : null,
+        meta.width && meta.height ? `${meta.width}×${meta.height}` : null,
+        meta.videoCodec ?? null,
+        meta.audioCodec ? `音频 ${meta.audioCodec}` : null,
+    ].filter((value) => value !== null);
+    if (facts.length > 0)
+        lines.push(`> ${facts.join(' · ')}`, '');
+    if (image) {
+        lines.push(`![${title}](${image.rel})`, '');
+        if (image.ocrText)
+            lines.push('## 画面文字', '', image.ocrText, '');
+        else
+            lines.push('_图片已原样收录(未做 OCR);以多模态方式参与召回。_', '');
+    }
+    if (frames.length > 0) {
+        lines.push('## 时间轴', '');
+        for (const [index, frame] of frames.entries()) {
+            const start = frame.seconds;
+            const end = index + 1 < frames.length ? frames[index + 1].seconds : Number.POSITIVE_INFINITY;
+            lines.push(`### ${formatClock(start)}`, '', `![${formatClock(start)}](${frame.rel})`, '');
+            const ocr = frameOcr.get(frame.rel);
+            if (ocr)
+                lines.push('**画面文字**', '', ocr, '');
+            const inWindow = cues.filter(cue => cue.seconds >= start - 0.01 && cue.seconds < end);
+            for (const cue of inWindow)
+                lines.push(`- \`${formatClock(cue.seconds)}\` ${cue.text}`);
+            if (inWindow.length > 0)
+                lines.push('');
+        }
+    }
+    if (!image) {
+        lines.push('## 逐字稿', '');
+        if (cues.length === 0) {
+            lines.push(meta.transcriptSource === 'none' ? '_没有字幕轨,也未开启本地转写。_' : '_未识别到可用语音内容。_', '');
+        }
+        else {
+            for (const cue of cues)
+                lines.push(`- \`${formatClock(cue.seconds)}\` ${cue.text}`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * 扫描档的 Markdown:逐页一节,页内先图后文。
+ *
+ * 不承诺版面顺序与表格结构 —— 这一档只负责"把图片页里的字读出来"。
+ */
+export function buildScannedMarkdown(input) {
+    const { title, totalPages, pageImages, pages } = input;
+    const lines = [`# ${title}`, ''];
+    const facts = [`共 ${totalPages} 页`, `已识别 ${pages.length} 页`, '本地 OCR(轻量档,无版面还原)'];
+    lines.push(`> ${facts.join(' · ')}`, '');
+    if (pages.length === 0) {
+        lines.push('_没有可识别的页面。_', '');
+        return lines.join('\n');
+    }
+    for (const page of pages) {
+        lines.push(`## 第 ${page.index} 页`, '');
+        if (pageImages)
+            lines.push(`![第 ${page.index} 页](${page.rel})`, '');
+        if (page.text.trim())
+            lines.push(page.text.trim(), '');
+        else
+            lines.push('_本页未识别到文字。_', '');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=markdown.js.map

package/lib/media/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/media/markdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAC/C,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAA;IACvB,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC3C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACxC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAA;AACpF,CAAC;AAaD,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,GAAG,EAAkB,CAAA;IAC5D,MAAM,KAAK,GAAa,CAAC,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IAE1C,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAC3E,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;QACjE,IAAI,CAAC,UAAU,IAAI,IAAI;QACvB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI;KACjD,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAA;IACpD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9D,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,KAAK,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;QAC3C,IAAI,KAAK,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;;YAC1D,KAAK,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QACxB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAA;YAC3B,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAA;YAC7F,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,WAAW,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;YACzF,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACnC,IAAI,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAA;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,KAAK,GAAG,IAAI,IAAI,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,CAAA;YACrF,KAAK,MAAM,GAAG,IAAI,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;YACvF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;QAC1F,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;YACnF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IACtD,MAAM,KAAK,GAAa,CAAC,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAG,CAAC,KAAK,UAAU,IAAI,EAAE,OAAO,KAAK,CAAC,MAAM,IAAI,EAAE,mBAAmB,CAAC,CAAA;IACjF,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;QAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAA;QACtC,IAAI,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;QACnE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;;YACjD,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/lib/media/media.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 媒体探测、关键帧与字幕 —— 全部走 ffmpeg/ffprobe,不含任何模型。
+ */
+import { type MediaCue, type MediaFrameOptions } from './types.js';
+export interface MediaStream {
+    codec_type?: string;
+    codec_name?: string;
+    width?: number;
+    height?: number;
+    r_frame_rate?: string;
+}
+export interface MediaProbe {
+    durationSeconds: number;
+    sizeBytes: number;
+    hasVideo: boolean;
+    hasAudio: boolean;
+    hasSubtitleTrack: boolean;
+    width?: number;
+    height?: number;
+    fps?: number;
+    videoCodec?: string;
+    audioCodec?: string;
+}
+export declare function probeMedia(file: string, signal?: AbortSignal): Promise<MediaProbe>;
+export interface ExtractedFrame {
+    /** 产物内相对路径(含 `assets/` 前缀),写进 Markdown 用。 */
+    rel: string;
+    /** 落盘的真实路径(scratch 下),给 OCR 之类的后续步骤用。 */
+    sourcePath: string;
+    data: Buffer;
+    seconds: number;
+}
+/**
+ * 均匀采样 + 场景变化两路合并,再按内容 sha1 去重。
+ *
+ * 只靠 `scene` 检测会漏内容:口播/图文类视频几乎没有硬切,阈值再低也可能只出 1 帧
+ * (实测:一个 3 段画面的测试视频,阈值降到 0.1 仍然只有 1 帧)。只靠均匀采样又会漏掉
+ * 真正的画面切换。两路都跑,按时间排序、近邻合并、内容去重。
+ */
+export declare function extractKeyframes(file: string, durationSeconds: number, scratch: string, options?: MediaFrameOptions, signal?: AbortSignal): Promise<ExtractedFrame[]>;
+/** 内嵌字幕轨优先,没有再看同名旁挂 `.srt`。 */
+export declare function extractSubtitles(file: string, probe: MediaProbe, scratch: string, signal?: AbortSignal): Promise<string | undefined>;
+/** 极简 SRT 解析:取起止时间与文本,顺带去掉自动字幕常见的滚动重复行。 */
+export declare function parseSrt(source: string): MediaCue[];
+//# sourceMappingURL=media.d.ts.map

package/lib/media/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/media/media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAwB,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAKxF,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,gBAAgB,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+BxF;AAED,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAUD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CAwD3B;AAED,+BAA+B;AAC/B,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB1I;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAoBnD"}