@l1yp/file-viewer 0.1.0

package/dist/composables/useFileViewer.d.ts

@@ -0,0 +1,428 @@
+/** A file opened in the side viewer: its display name, fetch/download URL, and highlight language. */
+export interface ViewerFile {
+    name: string;
+    /** Download endpoint URL — fetched as text and reused by the download button. Omit when `content` is set. */
+    url?: string;
+    /** highlight.js language id, '' for plain text, or 'markdown' (the panel renders markdown instead of highlighting). */
+    lang: string;
+    /** HTML document: the panel offers a render/source toggle, rendering the markup in a sandboxed iframe. */
+    html?: boolean;
+    /** SVG document: the panel offers a render/source toggle — render shows the picture, source the XML. */
+    svg?: boolean;
+    /** ZIP archive: the panel fetches the bytes and hands them to the in-browser archive browser. */
+    zip?: boolean;
+    /** 7z archive: the panel fetches the bytes and hands them to the in-browser 7z browser. */
+    sevenZip?: boolean;
+    /**
+     * tar-family ('tar': tar/gz/tgz/xz/txz/bz2/tbz2) or rar ('rar') archive: the panel hands the URL + this
+     * kind to the generic in-browser ArchiveBrowser, which decompresses the bytes and browses the entries.
+     */
+    archive?: 'tar' | 'rar';
+    /** Native binary object (.so/.dll): the panel hands the URL to the in-browser symbol browser. */
+    binobj?: boolean;
+    /** E-language (.e/.ec) project: the panel hands the URL to the in-browser EPL viewer (parse + decompile). */
+    epl?: boolean;
+    /** DICOM (.dcm) medical image: the panel hands the URL to the in-browser DICOM viewer. */
+    dicom?: boolean;
+    /** Word (.docx) document: the panel hands the URL to the in-browser Word viewer (docx-preview). */
+    docx?: boolean;
+    /** Excel (.xlsx/.xlsm) workbook: the panel hands the URL to the in-browser spreadsheet viewer (exceljs). */
+    xlsx?: boolean;
+    /** PowerPoint (.pptx/.pptm/.ppsx) deck: the panel hands the URL to the in-browser slide viewer (pptx-renderer). */
+    pptx?: boolean;
+    /** Rich Text (.rtf) document: the panel hands the URL to the in-browser rich-text viewer (hand-rolled RTF parser). */
+    rtf?: boolean;
+    /** PDF (.pdf) document: the panel hands the URL to the in-browser PDF viewer (pdfjs-dist). */
+    pdf?: boolean;
+    /** OPML / FreeMind (.opml/.mm) outline: the panel fetches the text and renders it as an interactive mind map. */
+    mindmap?: boolean;
+    /** XMind workbook (.xmind): the panel hands the URL to the in-browser XMind viewer (unzip → mind-map tree). */
+    xmind?: boolean;
+    /** Email (.eml) message: the panel hands the URL to the in-browser email viewer (MIME parser). */
+    eml?: boolean;
+    /** Web archive (.mht/.mhtml): the panel hands the URL to the in-browser web-archive viewer (MIME parser). */
+    mht?: boolean;
+    /** HAR (.har) capture: the panel hands the URL to the in-browser HAR viewer (hand-rolled JSON parser). */
+    har?: boolean;
+    /** SQLite database (.sqlite/.db/…): the panel hands the URL to the in-browser SQLite viewer (sql.js). */
+    sqlite?: boolean;
+    /** Certificate / key (.pem/.crt/.der/.csr/.p12/…): the panel hands the URL to the in-browser cert viewer (ASN.1/X.509). */
+    cert?: boolean;
+    /** Keystore (.jks/.keystore/.jceks + PKCS#12 .p12/.pfx): the panel hands the URL to the in-browser keystore viewer (sniffs format, parse + password decrypt). */
+    jks?: boolean;
+    /** Subtitle (.srt/.vtt/.ass/.ssa): the panel renders the fetched text as a parsed cue list (render/source toggle). */
+    subtitle?: boolean;
+    /** CSV / TSV (.csv/.tsv): the panel renders the fetched text as a parsed table (render/source toggle). */
+    csv?: boolean;
+    /** JSON Lines (.jsonl/.ndjson): the panel renders the fetched text as a record list — truncated rows, click to expand (render/source toggle). */
+    jsonl?: boolean;
+    /** Java bytecode (.class): the panel hands the URL to the in-browser class viewer (parse structure → fields/methods). */
+    javaClass?: boolean;
+    /** JVM heap dump (.hprof): the panel hands the URL to the in-browser HPROF viewer (stream-parse → class histogram + per-class object drill-in). */
+    hprof?: boolean;
+    /** Windows Installer (.msi/.msp/.msm): the panel hands the URL to the in-browser MSI viewer (OLE compound file → product identity + summary). */
+    msi?: boolean;
+    /** Windows app package (.appx/.msix/.appxbundle/.msixbundle): the panel hands the URL to the in-browser APPX viewer (unzip manifest → identity/deps/capabilities). */
+    appx?: boolean;
+    /** Font (.ttf/.otf/.woff/.woff2): the panel hands the URL to the in-browser font specimen (FontFace API). */
+    font?: boolean;
+    /** Jupyter Notebook (.ipynb): the panel hands the URL to the in-browser notebook viewer (hand-rolled JSON parser). */
+    ipynb?: boolean;
+    /** Geodata (.geojson/.kml/.gpx): the panel renders the fetched text as an offline SVG map (render/source toggle). */
+    geo?: boolean;
+    /** Audio (mp3/wav/flac/ogg/m4a/aac/opus, or .mid): the panel hands the URL to the in-browser audio player. */
+    audio?: boolean;
+    /** QQ Music encrypted audio (.mflac/.mgg/…): the panel hands the URL to the QMC player (decrypts in-browser, then plays). */
+    qmc?: boolean;
+    /** LRC lyrics (.lrc): the panel hands the URL to the lyrics viewer (self-fetches + sniffs GBK, then renders synced lines). */
+    lrc?: boolean;
+    /** Large text / `.log`: the panel hands the URL to the in-browser streaming log viewer (virtual-scrolled). */
+    log?: boolean;
+    /** 3D model (.stl/.obj/.ply/.glb/.gltf): the panel hands the URL to the in-browser three.js model viewer. */
+    model?: boolean;
+    /** Decoding image (TIFF/PSD/HEIC/RAW): the panel hands the URL + kind to the in-browser raster viewer. */
+    raster?: 'tiff' | 'psd' | 'heic' | 'raw';
+    /** E-book (EPUB/FB2/MOBI/DjVu): the panel hands the URL + kind to the in-browser e-book reader. */
+    ebook?: 'epub' | 'fb2' | 'mobi' | 'djvu';
+    /** Diagram (.drawio/.excalidraw): the panel renders the fetched text as an SVG (render/source toggle). */
+    diagram?: 'drawio' | 'excalidraw';
+    /** DXF (.dxf) CAD drawing: the panel hands the URL to the in-browser DXF viewer (parse → SVG, pan/zoom/layers). */
+    dxf?: boolean;
+    /**
+     * Raster image (png/jpg/…/svg-as-picture): rendered inline as a zoomable picture. The main FileChip flow
+     * routes images to the LIGHTBOX, so this is set only for archive entries (browsed inside the side viewer,
+     * where there is no lightbox) — see classifyViewerFile.
+     */
+    image?: boolean;
+    /** Video (mp4/webm/…): rendered inline with a native <video> player. Like {@link image}, set only for archive entries. */
+    video?: boolean;
+    /** Unpreviewable binary: the body shows a "can't preview — download" card. Set only for archive entries with no matching viewer. */
+    binary?: boolean;
+    /**
+     * Hex dump: the panel hands the URL to the in-browser hex viewer (offset + raw bytes + ASCII gutter). Never
+     * auto-detected — set only when the user picks "十六进制" from the unpreviewable-binary card's "open with"
+     * chooser (any bytes can be inspected this way), see FileViewerBody.
+     */
+    hex?: boolean;
+    /** File size in bytes (from the manifest) when known — drives the symbol browser's large-file gate. */
+    size?: number;
+    /** Inline text to render directly (e.g. a loaded skill's SKILL.md) — when set, the panel skips fetching. */
+    content?: string;
+}
+/** Clamp to a sane range: never narrower than MIN_WIDTH, and always leave ~320px for the conversation. */
+declare function setWidth(px: number): void;
+export declare function useFileViewer(): {
+    current: import("vue").Ref<{
+        name: string;
+        url?: string
+        /** highlight.js language id, '' for plain text, or 'markdown' (the panel renders markdown instead of highlighting). */
+         | undefined;
+        lang: string;
+        html?: boolean
+        /** SVG document: the panel offers a render/source toggle — render shows the picture, source the XML. */
+         | undefined;
+        svg?: boolean
+        /** ZIP archive: the panel fetches the bytes and hands them to the in-browser archive browser. */
+         | undefined;
+        zip?: boolean
+        /** 7z archive: the panel fetches the bytes and hands them to the in-browser 7z browser. */
+         | undefined;
+        sevenZip?: boolean
+        /**
+         * tar-family ('tar': tar/gz/tgz/xz/txz/bz2/tbz2) or rar ('rar') archive: the panel hands the URL + this
+         * kind to the generic in-browser ArchiveBrowser, which decompresses the bytes and browses the entries.
+         */
+         | undefined;
+        archive?: "tar" | "rar"
+        /** Native binary object (.so/.dll): the panel hands the URL to the in-browser symbol browser. */
+         | undefined;
+        binobj?: boolean
+        /** E-language (.e/.ec) project: the panel hands the URL to the in-browser EPL viewer (parse + decompile). */
+         | undefined;
+        epl?: boolean
+        /** DICOM (.dcm) medical image: the panel hands the URL to the in-browser DICOM viewer. */
+         | undefined;
+        dicom?: boolean
+        /** Word (.docx) document: the panel hands the URL to the in-browser Word viewer (docx-preview). */
+         | undefined;
+        docx?: boolean
+        /** Excel (.xlsx/.xlsm) workbook: the panel hands the URL to the in-browser spreadsheet viewer (exceljs). */
+         | undefined;
+        xlsx?: boolean
+        /** PowerPoint (.pptx/.pptm/.ppsx) deck: the panel hands the URL to the in-browser slide viewer (pptx-renderer). */
+         | undefined;
+        pptx?: boolean
+        /** Rich Text (.rtf) document: the panel hands the URL to the in-browser rich-text viewer (hand-rolled RTF parser). */
+         | undefined;
+        rtf?: boolean
+        /** PDF (.pdf) document: the panel hands the URL to the in-browser PDF viewer (pdfjs-dist). */
+         | undefined;
+        pdf?: boolean
+        /** OPML / FreeMind (.opml/.mm) outline: the panel fetches the text and renders it as an interactive mind map. */
+         | undefined;
+        mindmap?: boolean
+        /** XMind workbook (.xmind): the panel hands the URL to the in-browser XMind viewer (unzip → mind-map tree). */
+         | undefined;
+        xmind?: boolean
+        /** Email (.eml) message: the panel hands the URL to the in-browser email viewer (MIME parser). */
+         | undefined;
+        eml?: boolean
+        /** Web archive (.mht/.mhtml): the panel hands the URL to the in-browser web-archive viewer (MIME parser). */
+         | undefined;
+        mht?: boolean
+        /** HAR (.har) capture: the panel hands the URL to the in-browser HAR viewer (hand-rolled JSON parser). */
+         | undefined;
+        har?: boolean
+        /** SQLite database (.sqlite/.db/…): the panel hands the URL to the in-browser SQLite viewer (sql.js). */
+         | undefined;
+        sqlite?: boolean
+        /** Certificate / key (.pem/.crt/.der/.csr/.p12/…): the panel hands the URL to the in-browser cert viewer (ASN.1/X.509). */
+         | undefined;
+        cert?: boolean
+        /** Keystore (.jks/.keystore/.jceks + PKCS#12 .p12/.pfx): the panel hands the URL to the in-browser keystore viewer (sniffs format, parse + password decrypt). */
+         | undefined;
+        jks?: boolean
+        /** Subtitle (.srt/.vtt/.ass/.ssa): the panel renders the fetched text as a parsed cue list (render/source toggle). */
+         | undefined;
+        subtitle?: boolean
+        /** CSV / TSV (.csv/.tsv): the panel renders the fetched text as a parsed table (render/source toggle). */
+         | undefined;
+        csv?: boolean
+        /** JSON Lines (.jsonl/.ndjson): the panel renders the fetched text as a record list — truncated rows, click to expand (render/source toggle). */
+         | undefined;
+        jsonl?: boolean
+        /** Java bytecode (.class): the panel hands the URL to the in-browser class viewer (parse structure → fields/methods). */
+         | undefined;
+        javaClass?: boolean
+        /** JVM heap dump (.hprof): the panel hands the URL to the in-browser HPROF viewer (stream-parse → class histogram + per-class object drill-in). */
+         | undefined;
+        hprof?: boolean
+        /** Windows Installer (.msi/.msp/.msm): the panel hands the URL to the in-browser MSI viewer (OLE compound file → product identity + summary). */
+         | undefined;
+        msi?: boolean
+        /** Windows app package (.appx/.msix/.appxbundle/.msixbundle): the panel hands the URL to the in-browser APPX viewer (unzip manifest → identity/deps/capabilities). */
+         | undefined;
+        appx?: boolean
+        /** Font (.ttf/.otf/.woff/.woff2): the panel hands the URL to the in-browser font specimen (FontFace API). */
+         | undefined;
+        font?: boolean
+        /** Jupyter Notebook (.ipynb): the panel hands the URL to the in-browser notebook viewer (hand-rolled JSON parser). */
+         | undefined;
+        ipynb?: boolean
+        /** Geodata (.geojson/.kml/.gpx): the panel renders the fetched text as an offline SVG map (render/source toggle). */
+         | undefined;
+        geo?: boolean
+        /** Audio (mp3/wav/flac/ogg/m4a/aac/opus, or .mid): the panel hands the URL to the in-browser audio player. */
+         | undefined;
+        audio?: boolean
+        /** QQ Music encrypted audio (.mflac/.mgg/…): the panel hands the URL to the QMC player (decrypts in-browser, then plays). */
+         | undefined;
+        qmc?: boolean
+        /** LRC lyrics (.lrc): the panel hands the URL to the lyrics viewer (self-fetches + sniffs GBK, then renders synced lines). */
+         | undefined;
+        lrc?: boolean
+        /** Large text / `.log`: the panel hands the URL to the in-browser streaming log viewer (virtual-scrolled). */
+         | undefined;
+        log?: boolean
+        /** 3D model (.stl/.obj/.ply/.glb/.gltf): the panel hands the URL to the in-browser three.js model viewer. */
+         | undefined;
+        model?: boolean
+        /** Decoding image (TIFF/PSD/HEIC/RAW): the panel hands the URL + kind to the in-browser raster viewer. */
+         | undefined;
+        raster?: "tiff" | "psd" | "heic" | "raw"
+        /** E-book (EPUB/FB2/MOBI/DjVu): the panel hands the URL + kind to the in-browser e-book reader. */
+         | undefined;
+        ebook?: "epub" | "fb2" | "mobi" | "djvu"
+        /** Diagram (.drawio/.excalidraw): the panel renders the fetched text as an SVG (render/source toggle). */
+         | undefined;
+        diagram?: "drawio" | "excalidraw"
+        /** DXF (.dxf) CAD drawing: the panel hands the URL to the in-browser DXF viewer (parse → SVG, pan/zoom/layers). */
+         | undefined;
+        dxf?: boolean
+        /**
+         * Raster image (png/jpg/…/svg-as-picture): rendered inline as a zoomable picture. The main FileChip flow
+         * routes images to the LIGHTBOX, so this is set only for archive entries (browsed inside the side viewer,
+         * where there is no lightbox) — see classifyViewerFile.
+         */
+         | undefined;
+        image?: boolean
+        /** Video (mp4/webm/…): rendered inline with a native <video> player. Like {@link image}, set only for archive entries. */
+         | undefined;
+        video?: boolean
+        /** Unpreviewable binary: the body shows a "can't preview — download" card. Set only for archive entries with no matching viewer. */
+         | undefined;
+        binary?: boolean
+        /**
+         * Hex dump: the panel hands the URL to the in-browser hex viewer (offset + raw bytes + ASCII gutter). Never
+         * auto-detected — set only when the user picks "十六进制" from the unpreviewable-binary card's "open with"
+         * chooser (any bytes can be inspected this way), see FileViewerBody.
+         */
+         | undefined;
+        hex?: boolean
+        /** File size in bytes (from the manifest) when known — drives the symbol browser's large-file gate. */
+         | undefined;
+        size?: number
+        /** Inline text to render directly (e.g. a loaded skill's SKILL.md) — when set, the panel skips fetching. */
+         | undefined;
+        content?: string | undefined;
+    } | null, ViewerFile | {
+        name: string;
+        url?: string
+        /** highlight.js language id, '' for plain text, or 'markdown' (the panel renders markdown instead of highlighting). */
+         | undefined;
+        lang: string;
+        html?: boolean
+        /** SVG document: the panel offers a render/source toggle — render shows the picture, source the XML. */
+         | undefined;
+        svg?: boolean
+        /** ZIP archive: the panel fetches the bytes and hands them to the in-browser archive browser. */
+         | undefined;
+        zip?: boolean
+        /** 7z archive: the panel fetches the bytes and hands them to the in-browser 7z browser. */
+         | undefined;
+        sevenZip?: boolean
+        /**
+         * tar-family ('tar': tar/gz/tgz/xz/txz/bz2/tbz2) or rar ('rar') archive: the panel hands the URL + this
+         * kind to the generic in-browser ArchiveBrowser, which decompresses the bytes and browses the entries.
+         */
+         | undefined;
+        archive?: "tar" | "rar"
+        /** Native binary object (.so/.dll): the panel hands the URL to the in-browser symbol browser. */
+         | undefined;
+        binobj?: boolean
+        /** E-language (.e/.ec) project: the panel hands the URL to the in-browser EPL viewer (parse + decompile). */
+         | undefined;
+        epl?: boolean
+        /** DICOM (.dcm) medical image: the panel hands the URL to the in-browser DICOM viewer. */
+         | undefined;
+        dicom?: boolean
+        /** Word (.docx) document: the panel hands the URL to the in-browser Word viewer (docx-preview). */
+         | undefined;
+        docx?: boolean
+        /** Excel (.xlsx/.xlsm) workbook: the panel hands the URL to the in-browser spreadsheet viewer (exceljs). */
+         | undefined;
+        xlsx?: boolean
+        /** PowerPoint (.pptx/.pptm/.ppsx) deck: the panel hands the URL to the in-browser slide viewer (pptx-renderer). */
+         | undefined;
+        pptx?: boolean
+        /** Rich Text (.rtf) document: the panel hands the URL to the in-browser rich-text viewer (hand-rolled RTF parser). */
+         | undefined;
+        rtf?: boolean
+        /** PDF (.pdf) document: the panel hands the URL to the in-browser PDF viewer (pdfjs-dist). */
+         | undefined;
+        pdf?: boolean
+        /** OPML / FreeMind (.opml/.mm) outline: the panel fetches the text and renders it as an interactive mind map. */
+         | undefined;
+        mindmap?: boolean
+        /** XMind workbook (.xmind): the panel hands the URL to the in-browser XMind viewer (unzip → mind-map tree). */
+         | undefined;
+        xmind?: boolean
+        /** Email (.eml) message: the panel hands the URL to the in-browser email viewer (MIME parser). */
+         | undefined;
+        eml?: boolean
+        /** Web archive (.mht/.mhtml): the panel hands the URL to the in-browser web-archive viewer (MIME parser). */
+         | undefined;
+        mht?: boolean
+        /** HAR (.har) capture: the panel hands the URL to the in-browser HAR viewer (hand-rolled JSON parser). */
+         | undefined;
+        har?: boolean
+        /** SQLite database (.sqlite/.db/…): the panel hands the URL to the in-browser SQLite viewer (sql.js). */
+         | undefined;
+        sqlite?: boolean
+        /** Certificate / key (.pem/.crt/.der/.csr/.p12/…): the panel hands the URL to the in-browser cert viewer (ASN.1/X.509). */
+         | undefined;
+        cert?: boolean
+        /** Keystore (.jks/.keystore/.jceks + PKCS#12 .p12/.pfx): the panel hands the URL to the in-browser keystore viewer (sniffs format, parse + password decrypt). */
+         | undefined;
+        jks?: boolean
+        /** Subtitle (.srt/.vtt/.ass/.ssa): the panel renders the fetched text as a parsed cue list (render/source toggle). */
+         | undefined;
+        subtitle?: boolean
+        /** CSV / TSV (.csv/.tsv): the panel renders the fetched text as a parsed table (render/source toggle). */
+         | undefined;
+        csv?: boolean
+        /** JSON Lines (.jsonl/.ndjson): the panel renders the fetched text as a record list — truncated rows, click to expand (render/source toggle). */
+         | undefined;
+        jsonl?: boolean
+        /** Java bytecode (.class): the panel hands the URL to the in-browser class viewer (parse structure → fields/methods). */
+         | undefined;
+        javaClass?: boolean
+        /** JVM heap dump (.hprof): the panel hands the URL to the in-browser HPROF viewer (stream-parse → class histogram + per-class object drill-in). */
+         | undefined;
+        hprof?: boolean
+        /** Windows Installer (.msi/.msp/.msm): the panel hands the URL to the in-browser MSI viewer (OLE compound file → product identity + summary). */
+         | undefined;
+        msi?: boolean
+        /** Windows app package (.appx/.msix/.appxbundle/.msixbundle): the panel hands the URL to the in-browser APPX viewer (unzip manifest → identity/deps/capabilities). */
+         | undefined;
+        appx?: boolean
+        /** Font (.ttf/.otf/.woff/.woff2): the panel hands the URL to the in-browser font specimen (FontFace API). */
+         | undefined;
+        font?: boolean
+        /** Jupyter Notebook (.ipynb): the panel hands the URL to the in-browser notebook viewer (hand-rolled JSON parser). */
+         | undefined;
+        ipynb?: boolean
+        /** Geodata (.geojson/.kml/.gpx): the panel renders the fetched text as an offline SVG map (render/source toggle). */
+         | undefined;
+        geo?: boolean
+        /** Audio (mp3/wav/flac/ogg/m4a/aac/opus, or .mid): the panel hands the URL to the in-browser audio player. */
+         | undefined;
+        audio?: boolean
+        /** QQ Music encrypted audio (.mflac/.mgg/…): the panel hands the URL to the QMC player (decrypts in-browser, then plays). */
+         | undefined;
+        qmc?: boolean
+        /** LRC lyrics (.lrc): the panel hands the URL to the lyrics viewer (self-fetches + sniffs GBK, then renders synced lines). */
+         | undefined;
+        lrc?: boolean
+        /** Large text / `.log`: the panel hands the URL to the in-browser streaming log viewer (virtual-scrolled). */
+         | undefined;
+        log?: boolean
+        /** 3D model (.stl/.obj/.ply/.glb/.gltf): the panel hands the URL to the in-browser three.js model viewer. */
+         | undefined;
+        model?: boolean
+        /** Decoding image (TIFF/PSD/HEIC/RAW): the panel hands the URL + kind to the in-browser raster viewer. */
+         | undefined;
+        raster?: "tiff" | "psd" | "heic" | "raw"
+        /** E-book (EPUB/FB2/MOBI/DjVu): the panel hands the URL + kind to the in-browser e-book reader. */
+         | undefined;
+        ebook?: "epub" | "fb2" | "mobi" | "djvu"
+        /** Diagram (.drawio/.excalidraw): the panel renders the fetched text as an SVG (render/source toggle). */
+         | undefined;
+        diagram?: "drawio" | "excalidraw"
+        /** DXF (.dxf) CAD drawing: the panel hands the URL to the in-browser DXF viewer (parse → SVG, pan/zoom/layers). */
+         | undefined;
+        dxf?: boolean
+        /**
+         * Raster image (png/jpg/…/svg-as-picture): rendered inline as a zoomable picture. The main FileChip flow
+         * routes images to the LIGHTBOX, so this is set only for archive entries (browsed inside the side viewer,
+         * where there is no lightbox) — see classifyViewerFile.
+         */
+         | undefined;
+        image?: boolean
+        /** Video (mp4/webm/…): rendered inline with a native <video> player. Like {@link image}, set only for archive entries. */
+         | undefined;
+        video?: boolean
+        /** Unpreviewable binary: the body shows a "can't preview — download" card. Set only for archive entries with no matching viewer. */
+         | undefined;
+        binary?: boolean
+        /**
+         * Hex dump: the panel hands the URL to the in-browser hex viewer (offset + raw bytes + ASCII gutter). Never
+         * auto-detected — set only when the user picks "十六进制" from the unpreviewable-binary card's "open with"
+         * chooser (any bytes can be inspected this way), see FileViewerBody.
+         */
+         | undefined;
+        hex?: boolean
+        /** File size in bytes (from the manifest) when known — drives the symbol browser's large-file gate. */
+         | undefined;
+        size?: number
+        /** Inline text to render directly (e.g. a loaded skill's SKILL.md) — when set, the panel skips fetching. */
+         | undefined;
+        content?: string | undefined;
+    } | null>;
+    width: import("vue").Ref<number, number>;
+    setWidth: typeof setWidth;
+    isOpen: import("vue").ComputedRef<boolean>;
+    open(file: ViewerFile): void;
+    close(): void;
+};
+export {};

package/dist/composables/useFileViewer.js

@@ -0,0 +1,27 @@
+import { computed as e, ref as t } from "vue";
+//#region src/composables/useFileViewer.ts
+var n = t(null), r = 360, i = 760;
+function a() {
+	return typeof window > "u" ? 680 : Math.min(i, Math.max(r, Math.round(window.innerWidth * .42)));
+}
+var o = t(a());
+function s(e) {
+	let t = typeof window < "u" ? Math.max(r, window.innerWidth - 320) : 900;
+	o.value = Math.min(t, Math.max(r, Math.round(e)));
+}
+function c() {
+	return {
+		current: n,
+		width: o,
+		setWidth: s,
+		isOpen: e(() => n.value !== null),
+		open(e) {
+			n.value = e;
+		},
+		close() {
+			n.value = null;
+		}
+	};
+}
+//#endregion
+export { c as useFileViewer };

package/dist/composables/useLightbox.d.ts

@@ -0,0 +1,33 @@
+/** Media shown full-screen in the lightbox: its source URL, an alt/title, and the kind to render. */
+export interface LightboxImage {
+    src: string;
+    alt?: string;
+    /** 'video' fetches the source and plays it in a <video> (blob-backed); default 'image' shows an <img>. */
+    kind?: 'image' | 'video';
+    /** A "long image" (tall screenshot): show it at a readable width inside a vertical-scroll frame, not letterboxed. */
+    long?: boolean;
+}
+export declare function useLightbox(): {
+    current: import("vue").Ref<{
+        src: string;
+        alt?: string
+        /** 'video' fetches the source and plays it in a <video> (blob-backed); default 'image' shows an <img>. */
+         | undefined;
+        kind?: "image" | "video"
+        /** A "long image" (tall screenshot): show it at a readable width inside a vertical-scroll frame, not letterboxed. */
+         | undefined;
+        long?: boolean | undefined;
+    } | null, LightboxImage | {
+        src: string;
+        alt?: string
+        /** 'video' fetches the source and plays it in a <video> (blob-backed); default 'image' shows an <img>. */
+         | undefined;
+        kind?: "image" | "video"
+        /** A "long image" (tall screenshot): show it at a readable width inside a vertical-scroll frame, not letterboxed. */
+         | undefined;
+        long?: boolean | undefined;
+    } | null>;
+    isOpen: import("vue").ComputedRef<boolean>;
+    open(img: LightboxImage): void;
+    close(): void;
+};

package/dist/composables/useLightbox.js

@@ -0,0 +1,17 @@
+import { computed as e, ref as t } from "vue";
+//#region src/composables/useLightbox.ts
+var n = t(null);
+function r() {
+	return {
+		current: n,
+		isOpen: e(() => n.value !== null),
+		open(e) {
+			e.src && (n.value = e);
+		},
+		close() {
+			n.value = null;
+		}
+	};
+}
+//#endregion
+export { r as useLightbox };

package/dist/composables/useLogRules.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A single line-coloring rule for the log viewer: match lines by substring or regex, then paint their
+ * background and/or text. Rules apply top-to-bottom, first match wins (see LogViewer's `styleFor`).
+ */
+export interface ColorRule {
+    id: string;
+    pattern: string;
+    regex: boolean;
+    caseSensitive: boolean;
+    bgOn: boolean;
+    bg: string;
+    fgOn: boolean;
+    fg: string;
+    enabled: boolean;
+}
+export declare function defaultRule(): ColorRule;
+/**
+ * Persisted, browser-global line-coloring rules for the log viewer. A singleton (like {@link useListPrefs})
+ * so the set sticks across navigation and reloads; every mutation reassigns/deep-touches `rules` so the
+ * watcher writes through to localStorage.
+ */
+export declare function useLogRules(): {
+    rules: import("vue").Ref<{
+        id: string;
+        pattern: string;
+        regex: boolean;
+        caseSensitive: boolean;
+        bgOn: boolean;
+        bg: string;
+        fgOn: boolean;
+        fg: string;
+        enabled: boolean;
+    }[], ColorRule[] | {
+        id: string;
+        pattern: string;
+        regex: boolean;
+        caseSensitive: boolean;
+        bgOn: boolean;
+        bg: string;
+        fgOn: boolean;
+        fg: string;
+        enabled: boolean;
+    }[]>;
+    add: () => void;
+    remove: (id: string) => void;
+    move: (id: string, dir: -1 | 1) => void;
+};

package/dist/composables/useLogRules.js

@@ -0,0 +1,74 @@
+import { ref as e, watch as t } from "vue";
+//#region src/composables/useLogRules.ts
+var n = "viewer-log-color-rules";
+function r() {
+	try {
+		return crypto.randomUUID();
+	} catch {
+		return "r" + Date.now().toString(36) + Math.floor(Math.random() * 1e9).toString(36);
+	}
+}
+function i() {
+	return {
+		id: r(),
+		pattern: "",
+		regex: !1,
+		caseSensitive: !1,
+		bgOn: !0,
+		bg: "#fde68a",
+		fgOn: !1,
+		fg: "#111827",
+		enabled: !0
+	};
+}
+function a(e) {
+	if (!e || typeof e != "object") return null;
+	let t = e, n = i();
+	return {
+		id: typeof t.id == "string" ? t.id : n.id,
+		pattern: typeof t.pattern == "string" ? t.pattern : "",
+		regex: !!t.regex,
+		caseSensitive: !!t.caseSensitive,
+		bgOn: t.bgOn !== !1,
+		bg: typeof t.bg == "string" ? t.bg : n.bg,
+		fgOn: !!t.fgOn,
+		fg: typeof t.fg == "string" ? t.fg : n.fg,
+		enabled: t.enabled !== !1
+	};
+}
+function o() {
+	if (typeof localStorage < "u") try {
+		let e = localStorage.getItem(n);
+		if (e) {
+			let t = JSON.parse(e);
+			if (Array.isArray(t)) return t.map(a).filter((e) => e !== null);
+		}
+	} catch {}
+	return [];
+}
+var s = e(o());
+t(s, (e) => {
+	if (typeof localStorage < "u") try {
+		localStorage.setItem(n, JSON.stringify(e));
+	} catch {}
+}, { deep: !0 });
+function c() {
+	function e() {
+		s.value = [...s.value, i()];
+	}
+	function t(e) {
+		s.value = s.value.filter((t) => t.id !== e);
+	}
+	function n(e, t) {
+		let n = [...s.value], r = n.findIndex((t) => t.id === e), i = r + t;
+		r < 0 || i < 0 || i >= n.length || ([n[r], n[i]] = [n[i], n[r]], s.value = n);
+	}
+	return {
+		rules: s,
+		add: e,
+		remove: t,
+		move: n
+	};
+}
+//#endregion
+export { c as useLogRules };