studiograph 1.3.48-next.21 → 1.3.48-next.211

package/dist/services/artifact-render-export.js

@@ -0,0 +1,467 @@
+import { PassThrough } from 'stream';
+import archiver from 'archiver';
+import { PDFDocument } from 'pdf-lib';
+import { artifactExportFilename, buildArtifactHtmlExport } from '../core/artifact-export.js';
+import { artifactLibrarySourcesForBundle } from './artifact-library-sources.js';
+export class ArtifactRenderExportUnavailableError extends Error {
+    constructor(message = 'Artifact rendering is unavailable because the Playwright browser runtime is not installed.') {
+        super(message);
+        this.name = 'ArtifactRenderExportUnavailableError';
+    }
+}
+function renderViewport(bundle) {
+    return bundle.display?.fullscreenViewport ?? bundle.viewport;
+}
+function pdfPageSize(bundle) {
+    const viewport = renderViewport(bundle);
+    return {
+        width: `${Math.max(1, Math.round(viewport.width))}px`,
+        height: `${Math.max(1, Math.round(viewport.height))}px`,
+    };
+}
+function pdfPageOptions(size) {
+    return {
+        width: `${Math.max(1, Math.round(size.width))}px`,
+        height: `${Math.max(1, Math.round(size.height))}px`,
+        printBackground: true,
+        preferCSSPageSize: false,
+        margin: { top: '0px', right: '0px', bottom: '0px', left: '0px' },
+    };
+}
+async function renderedPdfPageSize(page, bundle) {
+    const fallback = pdfPageSize(bundle);
+    if (bundle.viewport.mode !== 'paged')
+        return fallback;
+    try {
+        const box = await page.locator(artifactFrameSelector(bundle)).first().boundingBox();
+        if (box && box.width > 0 && box.height > 0) {
+            return {
+                width: `${Math.max(1, Math.round(box.width))}px`,
+                height: `${Math.max(1, Math.round(box.height))}px`,
+            };
+        }
+    }
+    catch {
+        // Fall through to the declared viewport if the artifact has no measurable page.
+    }
+    return fallback;
+}
+function renderBackground(bundle) {
+    return bundle.display?.background === 'transparent' ? 'transparent' : '#ffffff';
+}
+function withoutExtension(filename, extension) {
+    return filename.toLowerCase().endsWith(`.${extension}`)
+        ? filename.slice(0, -extension.length - 1)
+        : filename;
+}
+export function artifactPngArchiveFilename(bundle) {
+    return `${withoutExtension(artifactExportFilename(bundle, 'png'), 'png')}.zip`;
+}
+export function artifactPngFrameFilename(bundle, index, count) {
+    const base = withoutExtension(artifactExportFilename(bundle, 'png'), 'png');
+    const pad = String(Math.max(1, count)).length;
+    return `${base}-${String(index + 1).padStart(pad, '0')}.png`;
+}
+export function nameArtifactPngFiles(bundle, files) {
+    return files.map((file, index) => ({
+        ...file,
+        filename: artifactPngFrameFilename(bundle, index, files.length),
+    }));
+}
+/** Zip an arbitrary set of named byte entries. Backing primitive for both the
+ *  multi-PNG archive and the self-contained HTML-export bundle. */
+export async function zipArtifactFiles(files) {
+    return await new Promise((resolve, reject) => {
+        const archive = archiver('zip', { zlib: { level: 6 } });
+        const stream = new PassThrough();
+        const chunks = [];
+        stream.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+        stream.on('end', () => resolve(Buffer.concat(chunks)));
+        stream.on('error', reject);
+        archive.on('warning', () => { });
+        archive.on('error', reject);
+        archive.pipe(stream);
+        for (const file of files) {
+            archive.append(file.bytes, { name: file.filename });
+        }
+        void archive.finalize();
+    });
+}
+/** @deprecated naming — use {@link zipArtifactFiles}. Kept for callers. */
+export async function zipArtifactPngFiles(files) {
+    return zipArtifactFiles(files);
+}
+function artifactFrameSelector(bundle) {
+    return bundle.display?.controls?.stepper?.selector ?? '[data-artifact-frame], [data-artifact-page], .page';
+}
+async function artifactFrameBoxes(page, bundle) {
+    const frameSelector = artifactFrameSelector(bundle);
+    let frameCount = 0;
+    try {
+        frameCount = await page.locator(frameSelector).count();
+    }
+    catch {
+        frameCount = 0;
+    }
+    if (frameCount <= 0)
+        return [];
+    const frames = page.locator(frameSelector);
+    const boxes = [];
+    for (let index = 0; index < frameCount; index += 1) {
+        const box = await frames.nth(index).boundingBox().catch(() => null);
+        if (!box || box.width <= 0 || box.height <= 0)
+            continue;
+        boxes.push({
+            index,
+            x: box.x,
+            y: box.y,
+            width: box.width,
+            height: box.height,
+        });
+    }
+    return boxes;
+}
+function requestIsAllowed(url, baseUrl) {
+    if (url.startsWith('about:') || url.startsWith('data:') || url.startsWith('blob:'))
+        return true;
+    if (!baseUrl)
+        return false;
+    try {
+        const requested = new URL(url);
+        const base = new URL(baseUrl);
+        return requested.origin === base.origin && requested.pathname.startsWith('/api/assets/');
+    }
+    catch {
+        return false;
+    }
+}
+function isMissingBrowserError(err) {
+    const message = err instanceof Error ? err.message : String(err ?? '');
+    return /Executable doesn't exist|browserType\.launch|Host system is missing|Chromium distribution/i.test(message);
+}
+async function launchChromium(playwright) {
+    const options = {
+        headless: true,
+        args: ['--no-sandbox', '--disable-dev-shm-usage'],
+    };
+    try {
+        return await playwright.chromium.launch(options);
+    }
+    catch (err) {
+        if (!isMissingBrowserError(err))
+            throw err;
+        try {
+            return await playwright.chromium.launch({ ...options, channel: 'chrome' });
+        }
+        catch (fallbackErr) {
+            const message = fallbackErr instanceof Error ? fallbackErr.message : String(fallbackErr ?? '');
+            throw new ArtifactRenderExportUnavailableError(`${message}. Install the Playwright Chromium runtime with: npx playwright install chromium`);
+        }
+    }
+}
+function screenshotOptions(format, quality) {
+    return format === 'jpeg'
+        ? { type: 'jpeg', quality: Math.max(1, Math.min(100, quality ?? 76)) }
+        : { type: 'png' };
+}
+function imagePayload(bytes, format) {
+    const buffer = Buffer.from(bytes);
+    const mimeType = format === 'jpeg' ? 'image/jpeg' : 'image/png';
+    return {
+        mimeType,
+        byteLength: buffer.length,
+        dataUrl: `data:${mimeType};base64,${buffer.toString('base64')}`,
+    };
+}
+export async function withRenderedArtifact(bundle, options, callback) {
+    let playwright;
+    try {
+        playwright = await import('playwright');
+    }
+    catch (err) {
+        throw new ArtifactRenderExportUnavailableError(err?.message);
+    }
+    let browser = null;
+    try {
+        const viewport = renderViewport(bundle);
+        const context = options.context ?? 'fullscreen';
+        browser = await launchChromium(playwright);
+        const page = await browser.newPage({
+            viewport: {
+                width: Math.max(1, Math.round(viewport.width)),
+                height: Math.max(1, Math.round(viewport.height)),
+            },
+            deviceScaleFactor: 1,
+        });
+        await options.onPage?.(page);
+        page.setDefaultTimeout(options.timeoutMs ?? 15_000);
+        await page.route('**/*', (route) => {
+            if (requestIsAllowed(route.request().url(), options.baseUrl)) {
+                void route.continue();
+            }
+            else {
+                void route.abort();
+            }
+        });
+        const html = buildArtifactHtmlExport(bundle, {
+            context,
+            baseHref: options.baseUrl ? `${options.baseUrl.replace(/\/+$/, '')}/` : undefined,
+            includeRenderHostStyles: context === 'fullscreen' || context === 'export',
+            librarySources: artifactLibrarySourcesForBundle(bundle),
+            assetToken: options.assetToken,
+        });
+        await page.setContent(html, { waitUntil: 'networkidle', timeout: options.timeoutMs ?? 15_000 });
+        await page.evaluate(({ background, context }) => {
+            const doc = globalThis.document;
+            doc.documentElement.style.background = background;
+            doc.body.style.background = background;
+            if (context === 'fullscreen') {
+                const frames = Array.from(doc.querySelectorAll('[data-artifact-frame]'));
+                frames.forEach((frame, index) => {
+                    frame.toggleAttribute('data-studiograph-active-frame', index === 0);
+                    frame.setAttribute('aria-hidden', index === 0 ? 'false' : 'true');
+                });
+            }
+        }, { background: renderBackground(bundle), context });
+        await page.evaluate(async () => {
+            const win = globalThis;
+            await (win.__STUDIOGRAPH_ARTIFACT_LIBRARIES_READY__ || Promise.resolve());
+            await new Promise((resolve) => {
+                win.requestAnimationFrame(() => win.requestAnimationFrame(() => resolve()));
+            });
+        });
+        return await callback(page);
+    }
+    catch (err) {
+        if (err instanceof ArtifactRenderExportUnavailableError)
+            throw err;
+        if (isMissingBrowserError(err)) {
+            throw new ArtifactRenderExportUnavailableError(`${err.message}. Install the Playwright Chromium runtime with: npx playwright install chromium`);
+        }
+        throw err;
+    }
+    finally {
+        await browser?.close().catch(() => { });
+    }
+}
+export async function renderArtifactPng(bundle, options = {}) {
+    const files = await renderArtifactPngFiles(bundle, options);
+    return files[0]?.bytes ?? Buffer.alloc(0);
+}
+export async function renderArtifactPngFiles(bundle, options = {}) {
+    return withRenderedArtifact(bundle, { ...options, context: 'export' }, async (page) => {
+        const boxes = await artifactFrameBoxes(page, bundle);
+        if (boxes.length > 0) {
+            const files = [];
+            const frames = page.locator(artifactFrameSelector(bundle));
+            for (const box of boxes) {
+                const bytes = await frames.nth(box.index).screenshot({
+                    type: 'png',
+                    animations: 'disabled',
+                    scale: 'css',
+                });
+                files.push({ index: box.index, bytes: Buffer.from(bytes) });
+            }
+            if (files.length > 0)
+                return files;
+        }
+        const bytes = await page.screenshot({
+            type: 'png',
+            fullPage: true,
+            animations: 'disabled',
+            scale: 'css',
+        });
+        return [{ index: 0, bytes: Buffer.from(bytes) }];
+    });
+}
+async function mergePdfPages(files) {
+    if (files.length === 1)
+        return files[0] ?? Buffer.alloc(0);
+    const merged = await PDFDocument.create();
+    for (const bytes of files) {
+        const source = await PDFDocument.load(bytes);
+        const pages = await merged.copyPages(source, source.getPageIndices());
+        for (const page of pages)
+            merged.addPage(page);
+    }
+    return Buffer.from(await merged.save());
+}
+async function renderArtifactPdfFrame(page, box, background) {
+    await page.evaluate(({ frame, bg }) => {
+        const doc = globalThis.document;
+        let style = doc.getElementById('studiograph-artifact-pdf-frame-style');
+        if (!style) {
+            style = doc.createElement('style');
+            style.id = 'studiograph-artifact-pdf-frame-style';
+            doc.head.appendChild(style);
+        }
+        const width = Math.max(1, Math.round(frame.width));
+        const height = Math.max(1, Math.round(frame.height));
+        style.textContent = `
+@media print {
+  html,
+  body {
+    margin: 0 !important;
+    padding: 0 !important;
+    width: ${width}px !important;
+    height: ${height}px !important;
+    min-width: ${width}px !important;
+    min-height: ${height}px !important;
+    overflow: hidden !important;
+    background: ${bg} !important;
+  }
+  body {
+    transform: translate(${-frame.x}px, ${-frame.y}px) !important;
+    transform-origin: 0 0 !important;
+  }
+}`;
+    }, { frame: box, bg: background });
+    const bytes = await page.pdf(pdfPageOptions(box));
+    return Buffer.from(bytes);
+}
+export async function renderArtifactPdf(bundle, options = {}) {
+    return withRenderedArtifact(bundle, { ...options, context: 'export' }, async (page) => {
+        const boxes = await artifactFrameBoxes(page, bundle);
+        if (boxes.length > 0) {
+            const background = renderBackground(bundle);
+            const files = [];
+            for (const box of boxes) {
+                files.push(await renderArtifactPdfFrame(page, box, background));
+            }
+            return mergePdfPages(files);
+        }
+        const size = await renderedPdfPageSize(page, bundle);
+        const bytes = await page.pdf({
+            ...size,
+            printBackground: true,
+            preferCSSPageSize: false,
+            margin: { top: '0px', right: '0px', bottom: '0px', left: '0px' },
+        });
+        return Buffer.from(bytes);
+    });
+}
+export async function inspectArtifactRender(bundle, options = {}) {
+    const context = options.context ?? 'editor';
+    const frameSelector = options.frameSelector ?? artifactFrameSelector(bundle);
+    const screenshotFormat = options.screenshotFormat ?? 'jpeg';
+    const includePageScreenshot = options.includePageScreenshot !== false;
+    const includeFrameScreenshots = options.includeFrameScreenshots !== false;
+    const maxFrames = Math.max(0, Math.min(24, Math.round(options.maxFrames ?? 6)));
+    const requestedIndexes = options.frameIndexes
+        ?.filter(Number.isFinite)
+        .map((index) => Math.max(0, Math.floor(index)));
+    const consoleMessages = [];
+    const pageErrors = [];
+    const requestFailures = [];
+    return withRenderedArtifact(bundle, {
+        ...options,
+        context,
+        onPage: (page) => {
+            page.on('console', (message) => {
+                consoleMessages.push({ type: message.type(), text: message.text().slice(0, 1000) });
+            });
+            page.on('pageerror', (error) => {
+                pageErrors.push(error.message.slice(0, 1000));
+            });
+            page.on('requestfailed', (request) => {
+                const url = request.url();
+                if (url.startsWith('about:') || url.startsWith('data:'))
+                    return;
+                requestFailures.push({
+                    url: url.slice(0, 1000),
+                    errorText: request.failure()?.errorText ?? 'request failed',
+                });
+            });
+            return options.onPage?.(page);
+        },
+    }, async (page) => {
+        await page.waitForLoadState('networkidle', { timeout: options.timeoutMs ?? 15_000 }).catch(() => { });
+        const pageScreenshot = includePageScreenshot
+            ? imagePayload(await page.screenshot({
+                ...screenshotOptions(screenshotFormat, options.jpegQuality),
+                fullPage: true,
+                animations: 'disabled',
+                scale: 'css',
+            }), screenshotFormat)
+            : undefined;
+        const metrics = await page.evaluate((selector) => {
+            const doc = globalThis.document;
+            const body = doc.body;
+            const root = doc.documentElement;
+            const frames = Array.from(doc.querySelectorAll(selector)).map((el, index) => {
+                const rect = el.getBoundingClientRect();
+                return {
+                    index,
+                    tagName: el.tagName.toLowerCase(),
+                    id: el.id || undefined,
+                    className: typeof el.className === 'string' ? el.className || undefined : undefined,
+                    textSnippet: ((el.textContent ?? '').replace(/\s+/g, ' ').trim()).slice(0, 500) || undefined,
+                    rect: {
+                        x: Math.round((rect.x + Number.EPSILON) * 100) / 100,
+                        y: Math.round((rect.y + Number.EPSILON) * 100) / 100,
+                        width: Math.round((rect.width + Number.EPSILON) * 100) / 100,
+                        height: Math.round((rect.height + Number.EPSILON) * 100) / 100,
+                    },
+                };
+            });
+            return {
+                documentSize: {
+                    width: Math.max(body?.scrollWidth ?? 0, root?.scrollWidth ?? 0, root?.clientWidth ?? 0),
+                    height: Math.max(body?.scrollHeight ?? 0, root?.scrollHeight ?? 0, root?.clientHeight ?? 0),
+                },
+                bodyTextSnippet: ((body?.textContent ?? '').replace(/\s+/g, ' ').trim()).slice(0, 1200),
+                frames,
+            };
+        }, frameSelector);
+        const frameIndexes = (requestedIndexes && requestedIndexes.length > 0)
+            ? requestedIndexes.slice(0, maxFrames)
+            : metrics.frames.slice(0, maxFrames).map((frame) => frame.index);
+        const frameIndexSet = new Set(frameIndexes);
+        const frames = [];
+        for (const frame of metrics.frames) {
+            if (!frameIndexSet.has(frame.index)) {
+                frames.push(frame);
+                continue;
+            }
+            if (!includeFrameScreenshots || frame.rect.width <= 0 || frame.rect.height <= 0) {
+                frames.push(frame);
+                continue;
+            }
+            try {
+                const bytes = await page.locator(frameSelector).nth(frame.index).screenshot({
+                    ...screenshotOptions(screenshotFormat, options.jpegQuality),
+                    animations: 'disabled',
+                    scale: 'css',
+                });
+                frames.push({ ...frame, screenshot: imagePayload(bytes, screenshotFormat) });
+            }
+            catch (err) {
+                frames.push({
+                    ...frame,
+                    screenshotError: err instanceof Error ? err.message.slice(0, 1000) : String(err).slice(0, 1000),
+                });
+            }
+        }
+        const viewport = renderViewport(bundle);
+        return {
+            artifactId: bundle.artifactId,
+            title: bundle.title,
+            kind: bundle.kind,
+            context,
+            viewport: {
+                width: Math.max(1, Math.round(viewport.width)),
+                height: Math.max(1, Math.round(viewport.height)),
+            },
+            documentSize: metrics.documentSize,
+            frameSelector,
+            frameCount: metrics.frames.length,
+            bodyTextSnippet: metrics.bodyTextSnippet,
+            console: consoleMessages,
+            pageErrors,
+            requestFailures,
+            ...(pageScreenshot ? { screenshot: pageScreenshot } : {}),
+            frames,
+        };
+    });
+}
+//# sourceMappingURL=artifact-render-export.js.map

package/dist/services/artifact-render-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-render-export.js","sourceRoot":"","sources":["../../src/services/artifact-render-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,MAAM,OAAO,oCAAqC,SAAQ,KAAK;IAC7D,YAAY,OAAO,GAAG,4FAA4F;QAChH,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sCAAsC,CAAC;IACrD,CAAC;CACF;AA0ED,SAAS,cAAc,CAAC,MAAsB;IAC5C,OAAO,MAAM,CAAC,OAAO,EAAE,kBAAkB,IAAI,MAAM,CAAC,QAAQ,CAAC;AAC/D,CAAC;AAED,SAAS,WAAW,CAAC,MAAsB;IACzC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO;QACL,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI;QACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAuC;IAC7D,OAAO;QACL,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI;QACjD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI;QACnD,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,KAAK;QACxB,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;KACjE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,IAA+B,EAC/B,MAAsB;IAEtB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;QACpF,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO;gBACL,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI;gBAChD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI;aACnD,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;IAClF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAsB;IAC9C,OAAO,MAAM,CAAC,OAAO,EAAE,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,SAAiB;IAC3D,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;QACrD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1C,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAsB;IAC/D,OAAO,GAAG,gBAAgB,CAAC,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAsB,EAAE,KAAa,EAAE,KAAa;IAC3F,MAAM,IAAI,GAAG,gBAAgB,CAAC,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAsB,EAAE,KAA8B;IACzF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,IAAI;QACP,QAAQ,EAAE,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;KAChE,CAAC,CAAC,CAAC;AACN,CAAC;AAED;mEACmE;AACnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiD;IACtF,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAiD;IACzF,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAsB;IACnD,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,oDAAoD,CAAC;AAC7G,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,IAA+B,EAC/B,MAAsB;IAEtB,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QACxD,KAAK,CAAC,IAAI,CAAC;YACT,KAAK;YACL,CAAC,EAAE,GAAG,CAAC,CAAC;YACR,CAAC,EAAE,GAAG,CAAC,CAAC;YACR,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,OAAgB;IACrD,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAChG,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAY;IACzC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACvE,OAAO,4FAA4F,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,UAAuC;IACnE,MAAM,OAAO,GAAG;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,cAAc,EAAE,yBAAyB,CAAC;KAClD,CAAC;IACF,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,WAAW,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YAC/F,MAAM,IAAI,oCAAoC,CAC5C,GAAG,OAAO,iFAAiF,CAC5F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAsB,EAAE,OAAgB;IACjE,OAAO,MAAM,KAAK,MAAM;QACtB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,EAAE;QACtE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,YAAY,CAAC,KAA0B,EAAE,MAAsB;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;IAChE,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,OAAO,EAAE,QAAQ,QAAQ,WAAW,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAsB,EACtB,OAAoC,EACpC,QAAyD;IAEzD,IAAI,UAAuC,CAAC;IAC5C,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,oCAAoC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,OAAO,GAAwC,IAAI,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC;QAChD,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC;YACjC,QAAQ,EAAE;gBACR,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC9C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;aACjD;YACD,iBAAiB,EAAE,CAAC;SACrB,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7D,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,EAAE;YAC3C,OAAO;YACP,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YACjF,uBAAuB,EAAE,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,QAAQ;YACzE,cAAc,EAAE,+BAA+B,CAAC,MAAM,CAAC;YACvD,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC;QAChG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE;YAC9C,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;YACzC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;YACvC,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAU,CAAC;gBAClF,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;oBAC9B,KAAK,CAAC,eAAe,CAAC,+BAA+B,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;oBACpE,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBACpE,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,EAAE,EAAE,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,GAAG,GAAG,UAAiB,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,wCAAwC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1E,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,GAAG,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,YAAY,oCAAoC;YAAE,MAAM,GAAG,CAAC;QACnE,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,oCAAoC,CAAC,GAAG,GAAG,CAAC,OAAO,iFAAiF,CAAC,CAAC;QAClJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAsB,EACtB,UAAuC,EAAE;IAEzC,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAsB,EACtB,UAAuC,EAAE;IAEzC,OAAO,oBAAoB,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACpF,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAA4B,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3D,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;oBACnD,IAAI,EAAE,KAAK;oBACX,UAAU,EAAE,UAAU;oBACtB,KAAK,EAAE,KAAK;iBACN,CAAC,CAAC;gBACV,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;QACrC,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC;YAClC,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,UAAU;YACtB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAAe;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACtE,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,IAA+B,EAC/B,GAAqB,EACrB,UAAkB;IAElB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE;QACpC,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;QACzC,IAAI,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC,sCAAsC,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACnC,KAAK,CAAC,EAAE,GAAG,sCAAsC,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,WAAW,GAAG;;;;;;aAMX,KAAK;cACJ,MAAM;iBACH,KAAK;kBACJ,MAAM;;kBAEN,EAAE;;;2BAGO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;;EAGhD,CAAC;IACD,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAEnC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAsB,EACtB,UAAuC,EAAE;IAEzC,OAAO,oBAAoB,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACpF,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,MAAM,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;YAC3B,GAAG,IAAI;YACP,eAAe,EAAE,IAAI;YACrB,iBAAiB,EAAE,KAAK;YACxB,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;SACjE,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAsB,EACtB,UAAkC,EAAE;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7E,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC;IAC5D,MAAM,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,KAAK,KAAK,CAAC;IACtE,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,KAAK,KAAK,CAAC;IAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY;QAC3C,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;SACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,eAAe,GAAwC,EAAE,CAAC;IAChE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,eAAe,GAAgD,EAAE,CAAC;IAExE,OAAO,oBAAoB,CAAC,MAAM,EAAE;QAClC,GAAG,OAAO;QACV,OAAO;QACP,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBAC7B,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACtF,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC7B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;gBACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC1B,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;oBAAE,OAAO;gBAChE,eAAe,CAAC,IAAI,CAAC;oBACnB,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;oBACvB,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,IAAI,gBAAgB;iBAC5D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;KACF,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAChB,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAErG,MAAM,cAAc,GAAG,qBAAqB;YAC1C,CAAC,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC;gBACnC,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,OAAO,CAAC,WAAW,CAAC;gBAC3D,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,UAAU;gBACtB,KAAK,EAAE,KAAK;aACN,CAAC,EAAE,gBAAgB,CAAC;YAC5B,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC/C,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;YACzC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,CAAC;YACjC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAO,EAAE,KAAK,EAAE,EAAE;gBAC/E,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;gBACxC,OAAO;oBACL,KAAK;oBACL,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE;oBACjC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,SAAS;oBACtB,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS;oBACnF,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,SAAS;oBAC5F,IAAI,EAAE;wBACJ,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;wBACpD,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;wBACpD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;wBAC5D,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;qBAC/D;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO;gBACL,YAAY,EAAE;oBACZ,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC;oBACvF,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,IAAI,CAAC,CAAC;iBAC5F;gBACD,eAAe,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;gBACvF,MAAM;aACP,CAAC;QACJ,CAAC,EAAE,aAAa,CAAC,CAAC;QAElB,MAAM,YAAY,GAAG,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YACpE,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;YACtC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAE5C,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,uBAAuB,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBAChF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;oBAC1E,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,OAAO,CAAC,WAAW,CAAC;oBAC3D,UAAU,EAAE,UAAU;oBACtB,KAAK,EAAE,KAAK;iBACN,CAAC,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC;oBACV,GAAG,KAAK;oBACR,eAAe,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;iBAChG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO;YACP,QAAQ,EAAE;gBACR,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC9C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;aACjD;YACD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,aAAa;YACb,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;YACjC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,OAAO,EAAE,eAAe;YACxB,UAAU;YACV,eAAe;YACf,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/services/asset-caption-service.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Asset caption + OCR service (P3b — indexing pillar).
+ *
+ * Turns an image asset's bytes into searchable text: a concise factual
+ * description plus an OCR transcription of any legible text. The sweep
+ * (asset-index-sweep.ts) stores that text in `assets.db.caption`, keyed by the
+ * immutable assetId (asset-as-embed, decision D1 — DB column, no sidecar), and
+ * folds it into the search text of every entry that embeds the image, so a
+ * captioned image becomes findable by its content, not just its filename.
+ *
+ * This module owns ONLY the model call + the bounded fan-out. It does NOT touch
+ * disk, git, or LanceDB — the sweep wires those so the service stays a pure,
+ * unit-testable transform over `(bytes) → text`.
+ *
+ * Guardrails (decision A3 + Codex):
+ *  - **Bounded concurrency** (default 2): vision is not a free background
+ *    service; a bulk import / first-boot migration must not fan out unbounded.
+ *  - **Per-call timeout**: a hung provider call can't wedge the pool.
+ *  - **Retry cap → permanent `failed`**: transient errors retry up to a cap,
+ *    then the asset is honestly marked filename-only.
+ *  - **Failure isolation**: one image's failure never aborts the batch.
+ *  - **Gateway degrade (option a)**: `completeSimple()` cannot reach the
+ *    Studiograph Credits gateway (it routes through its own client), so in
+ *    gateway mode captioning is skipped and the image stays honestly
+ *    filename-only — NOT routed through the gateway here.
+ */
+/** Model coordinates resolved by the caller (orchestrator pattern). */
+export interface CaptionModelConfig {
+    provider: string;
+    modelId: string;
+    apiKey: string;
+}
+/** Outcome of a single caption attempt. */
+export interface CaptionResult {
+    /** `full` = caption text produced; `failed` = honest filename-only. */
+    status: 'full' | 'failed';
+    /** The caption + OCR text (present only when status === 'full'). */
+    text?: string;
+    /** Machine-readable reason when failed (gateway | no-vision | no-api-key | error | timeout | empty). */
+    reason?: string;
+}
+/**
+ * Minimal stand-in for pi-ai's `completeSimple`. Injectable so tests exercise
+ * the retry / timeout / concurrency logic without a live provider.
+ */
+export type CaptionCompleteFn = (model: unknown, context: unknown, options: {
+    apiKey: string;
+    maxTokens?: number;
+}) => Promise<{
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    stopReason?: string;
+    errorMessage?: string;
+}>;
+export interface CaptionOptions {
+    /** Per-call wall-clock budget. Default 60s. */
+    timeoutMs?: number;
+    /** Total attempts per image (initial + retries). Default 2. */
+    maxAttempts?: number;
+    /** Max caption tokens. Default 1024. */
+    maxTokens?: number;
+    /** Bytes above which the image is skipped (filename-only) instead of sent. */
+    maxBytes?: number;
+    /** Override the model call (tests). Defaults to pi-ai `completeSimple`. */
+    completeFn?: CaptionCompleteFn;
+}
+/** Bounded caption fan-out — vision is metered, keep it small (A3). */
+export declare const DEFAULT_CAPTION_CONCURRENCY = 2;
+/**
+ * Is captioning reachable for this model config right now? Separate from
+ * `supportsVision` because the gateway IS vision-capable yet unreachable via
+ * `completeSimple` (decision A6 + the gateway-degrade note).
+ */
+export declare function canCaption(config: CaptionModelConfig): {
+    ok: boolean;
+    reason?: string;
+};
+/**
+ * Caption + OCR a single image. Gated by `canCaption`; never throws — a
+ * permanent failure resolves to `{ status: 'failed', reason }` so the caller
+ * can record honest index state.
+ */
+export declare function captionImage(buffer: Buffer, mimeType: string, config: CaptionModelConfig, opts?: CaptionOptions): Promise<CaptionResult>;
+/** One image to caption, paired with a caller-chosen key (e.g. entity id). */
+export interface CaptionJob {
+    key: string;
+    buffer: Buffer;
+    mimeType: string;
+}
+/** A caption result tagged with its job key. */
+export interface CaptionBatchResult extends CaptionResult {
+    key: string;
+}
+/**
+ * Caption a batch of images with bounded concurrency and full failure
+ * isolation — a single image throwing or timing out never sinks the batch.
+ * Results come back in input order, each tagged with its job key.
+ */
+export declare function captionImages(jobs: CaptionJob[], config: CaptionModelConfig, opts?: CaptionOptions & {
+    concurrency?: number;
+}): Promise<CaptionBatchResult[]>;