@orz/ui-content 0.0.0-stage → 0.0.0

package/dist/attachment/viewer.js

@@ -0,0 +1,245 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from "@orz/ui/components/button";
+import { Dialog, DialogCloseButton, DialogContent, DialogTitle, } from "@orz/ui/components/dialog";
+import { cn } from "@orz/ui/lib/utils";
+import { ChevronLeftIcon, ChevronRightIcon, DownloadIcon, ExternalLinkIcon, FileIcon, MaximizeIcon, MinimizeIcon, } from "lucide-react";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import { formatSize, isHtmlFile, isImageFile, isTextFile, TEXT_PREVIEW_HARD_MAX_BYTES, TEXT_PREVIEW_MAX_BYTES, textPreviewGate, } from "../file-kind.js";
+import { Content, useContentDisplay } from "../registry.js";
+import { ContentTitleBar } from "../title-bar.js";
+import { DEFAULT_IMAGE_LOOK } from "./image-look.js";
+// Long enough to cover a pointer crossing the image between two controls,
+// short enough that leaving for good does not read as the viewer lagging.
+const RELEASE_DELAY = 400;
+const RELEASE_NOW = ["keydown", "pointerdown", "wheel"];
+const AttachmentViewerContext = createContext(null);
+const ViewerImageContext = createContext(null);
+/** What the image renderer needs from the viewer around it; null outside one. */
+export function useViewerImage() {
+    return useContext(ViewerImageContext);
+}
+/**
+ * Owns one viewer dialog for everything below it: link chips, inline images,
+ * list rows and document cards all open this one rather than mounting a
+ * dialog each. A nested provider shadows the outer one.
+ */
+export function AttachmentViewerProvider({ viewHref, group, textPreviewMaxBytes = TEXT_PREVIEW_MAX_BYTES, textPreviewHardMaxBytes = TEXT_PREVIEW_HARD_MAX_BYTES, imageLook, onImageLookChange, children, }) {
+    const [state, setState] = useState(null);
+    // Read at click time, so an inline `group` does not change `show` and
+    // re-render every chip that holds it.
+    const groupRef = useRef(group);
+    groupRef.current = group;
+    const open = useCallback((items, index) => setState({ items, index }), []);
+    const show = useCallback((file) => setState(groupRef.current?.(file) ?? { items: [file], index: 0 }), []);
+    const value = useMemo(() => ({
+        open,
+        show,
+        viewHref,
+        textPreviewMaxBytes,
+        textPreviewHardMaxBytes,
+    }), [open, show, viewHref, textPreviewMaxBytes, textPreviewHardMaxBytes]);
+    return (_jsxs(AttachmentViewerContext.Provider, { value: value, children: [children, _jsx(AttachmentViewer, { state: state, onNavigate: (index) => setState((prev) => (prev === null ? prev : { ...prev, index })), onClose: () => setState(null), imageLook: imageLook, onImageLookChange: onImageLookChange })] }));
+}
+/** The nearest provider's controls, or null outside one. */
+export function useAttachmentViewer() {
+    return useContext(AttachmentViewerContext);
+}
+/** Where an anchor to this file points: the provider's `viewHref`, else the file's `url`. */
+export function useViewHref(file) {
+    const viewer = useContext(AttachmentViewerContext);
+    return viewer?.viewHref?.(file) ?? file.url ?? "";
+}
+/**
+ * Whether the viewer has something to draw for this file, which is what
+ * decides if a plain click on it is hijacked into the viewer. Text needs a
+ * known size — a file whose size the app does not know yet stays a link
+ * until it does; a size past the limits still opens the viewer, which says
+ * why it shows nothing. HTML has no size cap: the browser streams it into
+ * the iframe instead of this tab highlighting it.
+ */
+export function useCanPreview(file) {
+    const display = useContentDisplay(file, "viewer");
+    if (display === null)
+        return false;
+    if (isTextFile(file) && !isHtmlFile(file))
+        return file.size !== undefined;
+    return true;
+}
+function useGate(file) {
+    const viewer = useContext(AttachmentViewerContext);
+    if (!isTextFile(file) || isHtmlFile(file) || file.size === undefined) {
+        return "auto";
+    }
+    return textPreviewGate({ ...file, size: file.size }, {
+        max: viewer?.textPreviewMaxBytes,
+        hardMax: viewer?.textPreviewHardMaxBytes,
+    });
+}
+/**
+ * A text file past the auto-preview size waits to be asked, and is then
+ * drawn: the code renderer draws text that large plain. Past the hard limit
+ * it never previews.
+ */
+function LargeTextPane({ gate, onPreview, }) {
+    const viewer = useContext(AttachmentViewerContext);
+    const hardMax = viewer?.textPreviewHardMaxBytes ?? TEXT_PREVIEW_HARD_MAX_BYTES;
+    return (_jsxs("div", { className: "flex flex-col items-center gap-3 py-16 text-sm text-muted-foreground", children: [_jsx(FileIcon, { className: "size-8" }), gate === "refuse" ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "font-medium text-foreground", children: "This file is too large to preview." }), _jsxs("span", { children: ["Previews stop at ", formatSize(hardMax), "."] })] })) : (_jsxs(_Fragment, { children: [_jsx("span", { className: "font-medium text-foreground", children: "Large files aren't previewed automatically." }), _jsx(Button, { variant: "outline", size: "sm", onClick: onPreview, children: "Preview anyway" })] }))] }));
+}
+/** Paging can land on types that only download — say so instead of a blank pane. */
+function DownloadOnlyPane({ file }) {
+    return (_jsxs("div", { className: "flex flex-col items-center gap-2 py-16 text-sm text-muted-foreground", children: [_jsx(FileIcon, { className: "size-8" }), _jsx("span", { className: "font-medium text-foreground", children: file.name }), _jsx("span", { children: "No inline preview for this file type." }), file.url !== undefined && (_jsxs("a", { href: file.url, download: file.name, className: "inline-flex items-center gap-1 font-medium text-foreground hover:underline", children: [_jsx(DownloadIcon, { className: "size-3.5" }), "Download"] }))] }));
+}
+function ViewerBody({ file, maximized, titleBar, }) {
+    const canPreview = useCanPreview(file);
+    const gate = useGate(file);
+    // For this opening only: the body is keyed by file.
+    const [asked, setAsked] = useState(false);
+    return (_jsx("div", { className: cn("min-h-0 overflow-auto", maximized ? "flex-1" : "max-h-[75vh]"), 
+        // A renderer in "viewer" placement no longer knows the pane it is drawn
+        // in, so the pane hands down the height it may fill.
+        style: {
+            "--attachment-pane-height": maximized ? "100%" : "75vh",
+        }, children: !canPreview ? (_jsx(DownloadOnlyPane, { file: file })) : gate === "refuse" || (gate === "ask" && !asked) ? (_jsx(LargeTextPane, { gate: gate, onPreview: () => setAsked(true) })) : (_jsx(ContentTitleBar, { source: file, target: titleBar, children: _jsx(Content, { source: file, placement: "viewer" }) })) }));
+}
+function ViewerFooter({ file }) {
+    const viewer = useContext(AttachmentViewerContext);
+    const tab = viewer?.viewHref?.(file);
+    return (_jsxs("div", { className: "flex items-center justify-between gap-3 text-xs text-muted-foreground", children: [_jsx("span", { className: "truncate", children: [
+                    file.mime,
+                    file.size !== undefined ? formatSize(file.size) : undefined,
+                ]
+                    .filter(Boolean)
+                    .join(" · ") }), _jsxs("span", { className: "flex shrink-0 items-center gap-3", children: [tab !== undefined && (_jsxs("a", { href: tab, target: "_blank", rel: "noopener noreferrer", className: "inline-flex items-center gap-1 font-medium hover:underline", children: [_jsx(ExternalLinkIcon, { className: "size-3.5" }), "Open in new tab"] })), file.url !== undefined && (_jsxs("a", { href: file.url, download: file.name, className: "inline-flex items-center gap-1 font-medium hover:underline", children: [_jsx(DownloadIcon, { className: "size-3.5" }), "Download"] }))] })] }));
+}
+function keepsArrowKeys(target) {
+    return (target instanceof HTMLElement &&
+        (target.isContentEditable ||
+            target.closest("input, textarea, select, video, audio") !== null));
+}
+/**
+ * The viewer dialog, controlled: one file at a time drawn by the registry in
+ * "viewer" placement, or a download pane when nothing can draw it. A set
+ * pages with ‹ › / arrow keys, and the controls live in the title bar, never
+ * floated over the content.
+ */
+export function AttachmentViewer({ state, onNavigate, onClose, imageLook, onImageLookChange, }) {
+    // "Maximize" fills the browser window without entering system fullscreen;
+    // the dialog stays a modal.
+    const [maximized, setMaximized] = useState(false);
+    const [titleBar, setTitleBar] = useState(null);
+    // Held here rather than in the image, so paging and reopening keep it.
+    const [ownLook, setOwnLook] = useState(DEFAULT_IMAGE_LOOK);
+    const look = imageLook ?? ownLook;
+    const lastHeight = useRef(null);
+    const file = state?.items[state.index];
+    const count = state?.items.length ?? 0;
+    const isImage = file !== undefined && isImageFile(file);
+    // Paging between images tweens from one's height to the next; from
+    // anything else, including a closed viewer, the image lands at once.
+    useEffect(() => {
+        if (!isImage)
+            lastHeight.current = null;
+    }, [isImage]);
+    // While the pointer is over − 100%▾ + or ‹ ›, the image keeps the height
+    // it had when the pointer arrived, and takes its own once the pointer
+    // leaves: the dialog is centred, so a height change slides the title bar
+    // out from under the pointer, and the next click on + lands on the image
+    // and toggles back to fit, or the next click on › misses. One region for
+    // both groups, so crossing the gap between them is not a leave. Listened
+    // to on the DOM rather than through React: the zoom controls are
+    // portalled in by the image renderer, so in React's tree they sit outside
+    // this region, while the zoom menu's items, portalled out to the body, sit
+    // inside it — and choosing Fit or 100% there should not be held. Leaving
+    // lets go only after RELEASE_DELAY, so a trip from one control to another
+    // the long way round, over the image, is not a leave either; a key, a
+    // press or a wheel in the meantime lets go at once, since the pointer is
+    // no longer travelling.
+    const [holdRegion, setHoldRegion] = useState(null);
+    const [held, setHeld] = useState(null);
+    useEffect(() => {
+        if (holdRegion === null)
+            return;
+        let pending;
+        const cancel = () => {
+            window.clearTimeout(pending);
+            pending = undefined;
+            for (const type of RELEASE_NOW)
+                window.removeEventListener(type, release, true);
+        };
+        const release = () => {
+            cancel();
+            setHeld(null);
+        };
+        const enter = (e) => {
+            if (e.pointerType !== "mouse")
+                return;
+            if (pending !== undefined)
+                cancel();
+            else
+                setHeld(lastHeight.current);
+        };
+        const leave = (e) => {
+            if (e.pointerType !== "mouse" || pending !== undefined)
+                return;
+            pending = window.setTimeout(release, RELEASE_DELAY);
+            for (const type of RELEASE_NOW)
+                window.addEventListener(type, release, {
+                    capture: true,
+                    passive: true,
+                });
+        };
+        holdRegion.addEventListener("pointerenter", enter);
+        holdRegion.addEventListener("pointerleave", leave);
+        return () => {
+            cancel();
+            holdRegion.removeEventListener("pointerenter", enter);
+            holdRegion.removeEventListener("pointerleave", leave);
+        };
+    }, [holdRegion]);
+    // Closing unmounts the region under the pointer, which never reports
+    // leaving it.
+    const open = file !== undefined;
+    useEffect(() => {
+        if (!open)
+            setHeld(null);
+    }, [open]);
+    const image = useMemo(() => ({
+        maximized,
+        look,
+        setLook: (next) => {
+            if (imageLook === undefined)
+                setOwnLook(next);
+            onImageLookChange?.(next);
+        },
+        lastHeight,
+        held,
+    }), [maximized, look, imageLook, onImageLookChange, held]);
+    const step = (delta) => {
+        if (state === null || count < 2)
+            return;
+        onNavigate((state.index + delta + count) % count);
+    };
+    return (_jsx(Dialog, { open: open, onOpenChange: (open) => {
+            if (!open)
+                onClose();
+        }, children: _jsx(DialogContent, { "aria-describedby": undefined, showCloseButton: false, onKeyDown: (e) => {
+                // A focused video seeks, and a field moves its caret, on the same
+                // keys: those belong to whatever the body drew.
+                if (e.defaultPrevented || keepsArrowKeys(e.target))
+                    return;
+                if (e.key === "ArrowLeft")
+                    step(-1);
+                if (e.key === "ArrowRight")
+                    step(1);
+            }, className: cn("flex flex-col bg-background", 
+            // Maximized: fill the viewport (clearing the centering translate)
+            // but stay a modal — Esc still closes it. sm:max-w-none is needed
+            // to beat the dialog's built-in sm:max-w-sm cap.
+            maximized
+                ? "top-0 left-0 h-full w-full max-w-none translate-x-0 translate-y-0 rounded-none sm:max-w-none"
+                : "sm:max-w-5xl"), children: file && (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex items-center gap-1", children: [_jsx(DialogTitle, { className: "min-w-0 flex-1 truncate", children: file.name }), _jsxs("span", { ref: setHoldRegion, 
+                                // Alone, the renderer's controls need no box; an empty one
+                                // would add a gap beside a lone file that shows none.
+                                className: cn("items-center gap-1", count > 1 ? "flex" : "contents"), children: [_jsx("span", { ref: setTitleBar, className: "contents" }), count > 1 && (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "previous attachment", onClick: () => step(-1), children: _jsx(ChevronLeftIcon, {}) }), _jsxs("span", { className: "text-xs whitespace-nowrap text-muted-foreground tabular-nums", children: [(state?.index ?? 0) + 1, " / ", count] }), _jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "next attachment", onClick: () => step(1), children: _jsx(ChevronRightIcon, {}) })] }))] }), _jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": maximized ? "restore size" : "maximize", onClick: () => setMaximized((m) => !m), children: maximized ? _jsx(MinimizeIcon, {}) : _jsx(MaximizeIcon, {}) }), _jsx(DialogCloseButton, {})] }), _jsx(ViewerImageContext.Provider, { value: image, children: _jsx(ViewerBody, { file: file, maximized: maximized, titleBar: titleBar }, `${state?.index}:${file.url ?? file.name}`) }), _jsx(ViewerFooter, { file: file })] })) }) }));
+}
+//# sourceMappingURL=viewer.js.map

package/dist/attachment/viewer.js.map

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

package/dist/file-kind.d.ts

@@ -0,0 +1,61 @@
+/**
+ * What kind of file a source is. Pure module (no React) so every renderer's `accepts` shares one
+ * answer — `hasGenericType`, "a declared content type outranks the filename", is the rule a second
+ * copy elsewhere would fork.
+ */
+/** Spelled as a file `ContentSource` spells it, so one passes straight in. */
+export type FileLike = {
+    name: string;
+    mime?: string;
+};
+export declare function isImageFile(file: FileLike): boolean;
+/** Text by declared type, or by filename when the type is generic. */
+export declare function isTextFile(file: FileLike): boolean;
+/**
+ * Files whose image-syntax reference embeds a document card rather than an
+ * `<img>`. Images keep winning ties like .svg, which is both.
+ */
+export declare function isTextEmbed(file: FileLike): boolean;
+export declare function isMarkdownFile(file: FileLike): boolean;
+/**
+ * A unified diff, by declared type, or by filename when the type is generic: a `.patch` someone
+ * uploaded as text/plain keeps the plain text view it asked for.
+ */
+export declare function isPatchFile(file: FileLike): boolean;
+export declare function isHtmlFile(file: FileLike): boolean;
+/** PDF by declared type, or by filename when the type is generic. */
+export declare function isPdfFile(file: FileLike): boolean;
+/** Archive by declared type, or by filename when the type is generic. */
+export declare function isArchiveFile(file: FileLike): boolean;
+/** Audio by declared type, or by filename when the type is generic. */
+export declare function isAudioFile(file: FileLike): boolean;
+/** Video by declared type, or by filename when the type is generic. */
+export declare function isVideoFile(file: FileLike): boolean;
+/**
+ * Highlighting a multi-megabyte file would freeze the tab (T-31), so bigger
+ * text files only preview when asked, and then as plain text.
+ */
+export declare const TEXT_PREVIEW_MAX_BYTES: number;
+/**
+ * Past this nothing previews. Measured in Chromium under load: plain text at
+ * 10 MiB blocked the tab for 1.5 s in its longest task, at 20 MiB for 2.9 s,
+ * at 50 MiB for 6.9 s.
+ */
+export declare const TEXT_PREVIEW_HARD_MAX_BYTES: number;
+export type TextPreviewLimits = {
+    /** Previews on its own up to this. Default `TEXT_PREVIEW_MAX_BYTES`. */
+    max?: number;
+    /** Never previews past this. Default `TEXT_PREVIEW_HARD_MAX_BYTES`. */
+    hardMax?: number;
+};
+/**
+ * Whether a text file of this size previews on its own, waits to be asked,
+ * or never previews. A patch skips the asking: its view is virtualized per
+ * file, and a 20 MiB one blocked the tab for 0.6 s at most where the code
+ * view took 10 s or more over 1 MiB of highlighted text.
+ */
+export declare function textPreviewGate(file: FileLike & {
+    size: number;
+}, { max, hardMax, }?: TextPreviewLimits): "auto" | "ask" | "refuse";
+export declare function formatSize(bytes: number): string;
+//# sourceMappingURL=file-kind.d.ts.map

package/dist/file-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-kind.d.ts","sourceRoot":"","sources":["../src/file-kind.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAmCvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAMnD;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAKlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAItD;AAKD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAInD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAIlD;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAIjD;AA8BD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAIrD;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAInD;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAInD;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAAmB,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACjC,EACE,GAA4B,EAC5B,OAAqC,GACtC,GAAE,iBAAsB,GACxB,MAAM,GAAG,KAAK,GAAG,QAAQ,CAI3B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUhD"}

package/dist/file-kind.js

@@ -0,0 +1,166 @@
+/**
+ * What kind of file a source is. Pure module (no React) so every renderer's `accepts` shares one
+ * answer — `hasGenericType`, "a declared content type outranks the filename", is the rule a second
+ * copy elsewhere would fork.
+ */
+const IMAGE_EXTENSION = /\.(png|jpe?g|gif|webp|avif|svg)$/i;
+// Text formats the CLI/browser labels with an application/* type.
+const TEXT_APPLICATION_TYPES = new Set([
+    "application/json",
+    "application/ld+json",
+    "application/x-ndjson",
+    "application/xml",
+    "application/yaml",
+    "application/x-yaml",
+    "application/toml",
+    "application/javascript",
+    "application/x-javascript",
+    "application/typescript",
+    "application/sql",
+    "application/x-sh",
+]);
+// The CLI's extension→mime table only covers a handful of formats, so code
+// files usually upload as application/octet-stream and only the filename
+// says they are text.
+const TEXT_EXTENSION = /\.(txt|log|md|markdown|csv|tsv|json|jsonc|json5|jsonl|ndjson|ya?ml|toml|ini|cfg|conf|env|xml|html?|css|scss|less|diff|patch|ts|tsx|mts|cts|js|jsx|mjs|cjs|py|rb|rs|go|java|kt|kts|c|h|cpp|hpp|cc|hh|cs|php|swift|scala|clj|ex|exs|erl|hs|ml|lua|pl|r|jl|nix|zig|sql|graphql|proto|sh|bash|zsh|fish|ps1|bat|cmd|vue|svelte|astro|tex|lock|mmd|mermaid)$/i;
+/** The bare type: `Text/HTML; charset=utf-8` and `text/html` are one type. */
+function mimeOf(file) {
+    return (file.mime ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
+}
+function hasGenericType(mime) {
+    return mime === "" || mime === "application/octet-stream";
+}
+export function isImageFile(file) {
+    const type = mimeOf(file);
+    if (type.startsWith("image/"))
+        return true;
+    // Uploads that arrived without a real content type (the CLI sent
+    // application/octet-stream until T-27's hotfix) fall back to the filename.
+    return hasGenericType(type) && IMAGE_EXTENSION.test(file.name);
+}
+/** Text by declared type, or by filename when the type is generic. */
+export function isTextFile(file) {
+    const type = mimeOf(file);
+    if (type.startsWith("text/"))
+        return true;
+    if (TEXT_APPLICATION_TYPES.has(type))
+        return true;
+    return hasGenericType(type) && TEXT_EXTENSION.test(file.name);
+}
+/**
+ * Files whose image-syntax reference embeds a document card rather than an
+ * `<img>`. Images keep winning ties like .svg, which is both.
+ */
+export function isTextEmbed(file) {
+    return !isImageFile(file) && isTextFile(file);
+}
+export function isMarkdownFile(file) {
+    return (mimeOf(file) === "text/markdown" || /\.(md|markdown)$/i.test(file.name));
+}
+// What browsers on Linux declare for .patch and .diff, from shared-mime-info.
+const PATCH_TYPES = new Set(["text/x-patch", "text/x-diff"]);
+/**
+ * A unified diff, by declared type, or by filename when the type is generic: a `.patch` someone
+ * uploaded as text/plain keeps the plain text view it asked for.
+ */
+export function isPatchFile(file) {
+    const type = mimeOf(file);
+    if (PATCH_TYPES.has(type))
+        return true;
+    return hasGenericType(type) && /\.(patch|diff)$/i.test(file.name);
+}
+export function isHtmlFile(file) {
+    const type = mimeOf(file);
+    if (type === "text/html" || type === "application/xhtml+xml")
+        return true;
+    return hasGenericType(type) && /\.(html?|xhtml)$/i.test(file.name);
+}
+/** PDF by declared type, or by filename when the type is generic. */
+export function isPdfFile(file) {
+    const type = mimeOf(file);
+    if (type === "application/pdf")
+        return true;
+    return hasGenericType(type) && /\.pdf$/i.test(file.name);
+}
+// Archive types as the CLI, the browser and the common upload tools spell
+// them; the same format arrives under several names depending on which one
+// did the labelling.
+const ARCHIVE_TYPES = new Set([
+    "application/zip",
+    "application/x-zip-compressed",
+    "application/gzip",
+    "application/x-gzip",
+    "application/x-tar",
+    "application/x-7z-compressed",
+    "application/vnd.rar",
+    "application/x-rar-compressed",
+    "application/x-bzip2",
+    "application/x-xz",
+    "application/zstd",
+]);
+const ARCHIVE_EXTENSION = /\.(zip|tar|gz|tgz|bz2|tbz|tbz2|xz|txz|7z|rar|zst)$/i;
+const AUDIO_EXTENSION = /\.(mp3|wav|ogg|oga|m4a|aac|flac|opus|wma|aif|aiff)$/i;
+/**
+ * `ts` is deliberately missing: it is MPEG transport stream and TypeScript
+ * both, and TEXT_EXTENSION claims it. A source file the CLI uploaded as
+ * application/octet-stream must not come back as a video.
+ */
+const VIDEO_EXTENSION = /\.(mp4|m4v|webm|mov|mkv|avi|wmv|flv|mpg|mpeg)$/i;
+/** Archive by declared type, or by filename when the type is generic. */
+export function isArchiveFile(file) {
+    const type = mimeOf(file);
+    if (ARCHIVE_TYPES.has(type))
+        return true;
+    return hasGenericType(type) && ARCHIVE_EXTENSION.test(file.name);
+}
+/** Audio by declared type, or by filename when the type is generic. */
+export function isAudioFile(file) {
+    const type = mimeOf(file);
+    if (type.startsWith("audio/"))
+        return true;
+    return hasGenericType(type) && AUDIO_EXTENSION.test(file.name);
+}
+/** Video by declared type, or by filename when the type is generic. */
+export function isVideoFile(file) {
+    const type = mimeOf(file);
+    if (type.startsWith("video/"))
+        return true;
+    return hasGenericType(type) && VIDEO_EXTENSION.test(file.name);
+}
+/**
+ * Highlighting a multi-megabyte file would freeze the tab (T-31), so bigger
+ * text files only preview when asked, and then as plain text.
+ */
+export const TEXT_PREVIEW_MAX_BYTES = 1024 * 1024;
+/**
+ * Past this nothing previews. Measured in Chromium under load: plain text at
+ * 10 MiB blocked the tab for 1.5 s in its longest task, at 20 MiB for 2.9 s,
+ * at 50 MiB for 6.9 s.
+ */
+export const TEXT_PREVIEW_HARD_MAX_BYTES = 10 * 1024 * 1024;
+/**
+ * Whether a text file of this size previews on its own, waits to be asked,
+ * or never previews. A patch skips the asking: its view is virtualized per
+ * file, and a 20 MiB one blocked the tab for 0.6 s at most where the code
+ * view took 10 s or more over 1 MiB of highlighted text.
+ */
+export function textPreviewGate(file, { max = TEXT_PREVIEW_MAX_BYTES, hardMax = TEXT_PREVIEW_HARD_MAX_BYTES, } = {}) {
+    if (file.size > hardMax)
+        return "refuse";
+    if (file.size <= max || isPatchFile(file))
+        return "auto";
+    return "ask";
+}
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ["KB", "MB", "GB"];
+    let value = bytes / 1024;
+    let i = 0;
+    while (value >= 1024 && i < units.length - 1) {
+        value /= 1024;
+        i++;
+    }
+    return `${value >= 10 ? Math.round(value) : value.toFixed(1)} ${units[i]}`;
+}
+//# sourceMappingURL=file-kind.js.map

package/dist/file-kind.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { type FileLike, formatSize, isArchiveFile, isAudioFile, isHtmlFile, isImageFile, isMarkdownFile, isPatchFile, isPdfFile, isTextEmbed, isTextFile, isVideoFile, TEXT_PREVIEW_HARD_MAX_BYTES, TEXT_PREVIEW_MAX_BYTES, type TextPreviewLimits, textPreviewGate, } from "./file-kind.ts";
+export { Content, ContentFallback, ContentRenderers, useContentDepth, useContentDisplay, useContentDisplayOf, useContentMaxDepth, } from "./registry.tsx";
+export { type SourceText, useSourceText } from "./source-text.ts";
+export { ContentTitleBar, useContentTitleBar } from "./title-bar.tsx";
+export type { ContentDisplay, ContentProps, ContentRenderer, ContentSource, Placement, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,2BAA2B,EAC3B,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACtE,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { formatSize, isArchiveFile, isAudioFile, isHtmlFile, isImageFile, isMarkdownFile, isPatchFile, isPdfFile, isTextEmbed, isTextFile, isVideoFile, TEXT_PREVIEW_HARD_MAX_BYTES, TEXT_PREVIEW_MAX_BYTES, textPreviewGate, } from "./file-kind.js";
+export { Content, ContentFallback, ContentRenderers, useContentDepth, useContentDisplay, useContentDisplayOf, useContentMaxDepth, } from "./registry.js";
+export { useSourceText } from "./source-text.js";
+export { ContentTitleBar, useContentTitleBar } from "./title-bar.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,2BAA2B,EAC3B,sBAAsB,EAEtB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAgB,CAAC;AACxB,OAAO,EAAmB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAiB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,44 @@
+import { type ReactNode } from "react";
+import type { ContentDisplay, ContentProps, ContentRenderer, ContentSource, Placement } from "./types.ts";
+/**
+ * The fallback, as a component, for renderers that decide to step aside: a plain `<pre><code>`
+ * for inline text, and a download link (or the bare name when there is no `url`) for a file.
+ */
+export declare function ContentFallback({ source, className }: ContentProps): import("react").JSX.Element;
+/**
+ * Registers renderers for every `<Content>` below. The list is ordered and the first renderer
+ * that accepts a source draws it, so a narrow renderer goes before a broad one. A nested provider
+ * puts its renderers in front of the outer ones.
+ *
+ * Keep `renderers` stable (a module constant or a memo): a new array rebuilds every `Next`, and
+ * React remounts whatever the renderers drew.
+ */
+export declare function ContentRenderers({ renderers, maxDepth, children, }: {
+    renderers: readonly ContentRenderer[];
+    /** Read by renderers that limit nesting (`useContentMaxDepth`); `<Content>` does not enforce it. */
+    maxDepth?: number;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Draws a source with the first registered renderer that accepts it, or the fallback.
+ *
+ * A file source a renderer draws raises `useContentDepth()` by one for everything below it, once
+ * per `<Content>`: a renderer that wraps the file and hands it on through `Next` does not count
+ * it twice.
+ */
+export declare function Content(props: ContentProps): import("react").JSX.Element;
+/**
+ * How the renderer that would draw this source lays out, without rendering anything: `"block"`,
+ * `"inline"`, or `null` when nothing registered accepts it.
+ */
+export declare function useContentDisplay(source: ContentSource, placement: Placement): ContentDisplay | null;
+/**
+ * `useContentDisplay` as a function, for a caller that asks about a varying number of sources in
+ * one render, such as a paragraph checking each of its images.
+ */
+export declare function useContentDisplayOf(): (source: ContentSource, placement: Placement) => ContentDisplay | null;
+/** How many file sources, each drawn by a renderer, enclose this point. */
+export declare function useContentDepth(): number;
+/** The nearest `<ContentRenderers maxDepth>`, for renderers that limit nesting. */
+export declare function useContentMaxDepth(): number | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACV,MAAM,YAAY,CAAC;AASpB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,YAAY,+BAsBlE;AAqCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,+BAoBA;AAUD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,+BAa1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,GACnB,cAAc,GAAG,IAAI,CAEvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,CACrC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,KACjB,cAAc,GAAG,IAAI,CASzB;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvD"}