@epicbagel/saas-kit 1.2.3 → 1.4.0

package/dist/primitives/file-preview-internals.js

@@ -0,0 +1,20 @@
+"use client";
+"use client";
+import {
+  PreviewDialog,
+  PreviewLoading,
+  PreviewNotice,
+  PreviewStage
+} from "../chunk-2TKLS73N.js";
+import "../chunk-JTI4244T.js";
+import "../chunk-4HWCNRK4.js";
+import "../chunk-3QT5VYZ3.js";
+import "../chunk-KN4RPX35.js";
+import "../chunk-HQRWRRZJ.js";
+import "../chunk-G6SRSWXB.js";
+export {
+  PreviewDialog,
+  PreviewLoading,
+  PreviewNotice,
+  PreviewStage
+};

package/dist/primitives/file-preview.cjs

@@ -0,0 +1,327 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
+"use client";
+
+
+var _chunk4UUTKR3Vcjs = require('../chunk-4UUTKR3V.cjs');
+
+
+
+
+
+var _chunkGRY77463cjs = require('../chunk-GRY77463.cjs');
+require('../chunk-BTHYGHOH.cjs');
+require('../chunk-2BHI5ZWJ.cjs');
+require('../chunk-WDXEJDMO.cjs');
+
+
+var _chunkVLXPLKFRcjs = require('../chunk-VLXPLKFR.cjs');
+require('../chunk-VKIGJNJR.cjs');
+
+
+var _chunkKENBU3NVcjs = require('../chunk-KENBU3NV.cjs');
+require('../chunk-ELPV44S6.cjs');
+
+
+var _chunk373W6VADcjs = require('../chunk-373W6VAD.cjs');
+
+
+var _chunkT2ZFSPE4cjs = require('../chunk-T2ZFSPE4.cjs');
+
+
+var _chunkL4DH72UFcjs = require('../chunk-L4DH72UF.cjs');
+require('../chunk-4LXN6GLZ.cjs');
+require('../chunk-KWLSBTB2.cjs');
+
+// src/primitives/file-preview.tsx
+var _lucidereact = require('lucide-react');
+var _react = require('react');
+var _jsxruntime = require('react/jsx-runtime');
+var UNTYPED = /* @__PURE__ */ new Set([
+  "",
+  "application/octet-stream",
+  "binary/octet-stream",
+  "application/binary",
+  "application/unknown",
+  "application/x-download",
+  "application/force-download"
+]);
+var TYPE_KINDS = {
+  "application/pdf": "pdf",
+  "application/x-pdf": "pdf",
+  "image/apng": "image",
+  "image/avif": "image",
+  "image/bmp": "image",
+  "image/gif": "image",
+  "image/jpeg": "image",
+  "image/jpg": "image",
+  "image/pjpeg": "image",
+  "image/png": "image",
+  "image/svg+xml": "image",
+  "image/vnd.microsoft.icon": "image",
+  "image/webp": "image",
+  "image/x-icon": "image",
+  "text/markdown": "markdown",
+  "text/x-markdown": "markdown",
+  // RTF is text/*, but its source is control words, not the document.
+  "text/rtf": "none",
+  "application/ecmascript": "text",
+  "application/graphql": "text",
+  "application/javascript": "text",
+  "application/json": "text",
+  "application/sql": "text",
+  "application/toml": "text",
+  "application/typescript": "text",
+  "application/x-httpd-php": "text",
+  "application/x-javascript": "text",
+  "application/x-ndjson": "text",
+  "application/x-sh": "text",
+  "application/x-typescript": "text",
+  "application/x-yaml": "text",
+  "application/xml": "text",
+  "application/yaml": "text",
+  "audio/aac": "audio",
+  "audio/flac": "audio",
+  "audio/mp3": "audio",
+  "audio/mp4": "audio",
+  "audio/mpeg": "audio",
+  "audio/ogg": "audio",
+  "audio/opus": "audio",
+  "audio/wav": "audio",
+  "audio/wave": "audio",
+  "audio/webm": "audio",
+  "audio/x-flac": "audio",
+  "audio/x-m4a": "audio",
+  "audio/x-wav": "audio",
+  "video/mp4": "video",
+  "video/ogg": "video",
+  "video/quicktime": "video",
+  "video/webm": "video",
+  "video/x-m4v": "video"
+};
+var EXTENSION_KINDS = new Map(
+  [
+    ["pdf", "pdf"],
+    ["image", "apng avif bmp gif ico jfif jpeg jpg png svg webp"],
+    ["markdown", "markdown md mdown mkd"],
+    ["audio", "aac flac m4a mp3 oga ogg opus wav weba"],
+    ["video", "m4v mov mp4 ogv webm"],
+    [
+      "text",
+      "adoc bash bat c cc cfg cjs clj conf cpp cs css csv cts cxx dart diff env erl ex exs fish go gql graphql h hpp hs htm html ini java js json jsonc jsonl jsx kt kts less log lua mjs mts ndjson patch php pl properties ps1 py r rb rs rst sass scala scss sh sql srt svelte swift tex text toml ts tsv tsx txt vtt vue xml yaml yml zsh"
+    ]
+  ].flatMap(
+    ([kind, extensions]) => extensions.split(" ").map((extension) => [extension, kind])
+  )
+);
+function kindOfName(name) {
+  const base = _nullishCoalesce((_nullishCoalesce(name, () => ( ""))).trim().toLowerCase().split(/[\\/]/).pop(), () => ( ""));
+  const dot = base.lastIndexOf(".");
+  return dot >= 0 ? EXTENSION_KINDS.get(base.slice(dot + 1)) : void 0;
+}
+function kindOfType(type) {
+  const known = TYPE_KINDS[type];
+  if (known) return known;
+  if (type.startsWith("text/")) return "text";
+  if (/^application\/[\w.-]+\+(?:json|xml)$/.test(type)) return "text";
+  return void 0;
+}
+function filePreviewKind({ name, mediaType }) {
+  const type = (_nullishCoalesce(mediaType, () => ( ""))).split(";", 1)[0].trim().toLowerCase();
+  const byName = kindOfName(name);
+  if (UNTYPED.has(type)) return _nullishCoalesce(byName, () => ( "none"));
+  const byType = kindOfType(type);
+  if (byType === "text" && byName === "markdown") return "markdown";
+  if (byType) return byType;
+  return byName === "text" || byName === "markdown" ? byName : "none";
+}
+function FilePreview({
+  open,
+  onOpenChange,
+  title,
+  mediaType,
+  kind,
+  file,
+  src,
+  loading = false,
+  error,
+  onDownload,
+  downloading = false,
+  downloadLabel = "Download file",
+  fallback,
+  markdownComponents,
+  loadingLabel = "Loading preview\u2026",
+  unavailableLabel = "No preview for this file.",
+  failedLabel = "This file couldn't be shown here.",
+  truncatedLabel = "Showing the start of this file. Download it to see the rest."
+}) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _chunkGRY77463cjs.PreviewDialog,
+    {
+      open,
+      onOpenChange,
+      title,
+      onDownload,
+      downloading,
+      downloadLabel,
+      children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        FilePreviewBody,
+        {
+          kind: _nullishCoalesce(kind, () => ( filePreviewKind({ name: title, mediaType: _nullishCoalesce(mediaType, () => ( _optionalChain([file, 'optionalAccess', _ => _.type]))) }))),
+          title,
+          file: _nullishCoalesce(file, () => ( null)),
+          src: _nullishCoalesce(src, () => ( null)),
+          loading,
+          error: _nullishCoalesce(error, () => ( null)),
+          fallback,
+          download: onDownload ? (
+            // Under a muted message: the action keeps the foreground colour.
+            /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+              _chunkL4DH72UFcjs.Button,
+              {
+                type: "button",
+                variant: "outline",
+                size: "sm",
+                className: "text-foreground",
+                onClick: onDownload,
+                disabled: downloading,
+                children: [
+                  /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkT2ZFSPE4cjs.Icon, { icon: downloading ? _lucidereact.Loader2 : _lucidereact.Download, size: "sm", spin: downloading }),
+                  downloadLabel
+                ]
+              }
+            )
+          ) : null,
+          markdownComponents,
+          loadingLabel,
+          unavailableLabel,
+          failedLabel,
+          truncatedLabel
+        }
+      )
+    }
+  );
+}
+var TEXT_PREVIEW_LIMIT = 5e5;
+function NewTabLink({ node: _node, ...props }) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "a", { ...props, target: "_blank", rel: "noopener noreferrer" });
+}
+function startOf(text) {
+  if (text.length <= TEXT_PREVIEW_LIMIT) return { text, truncated: false };
+  const end = text.lastIndexOf("\n", TEXT_PREVIEW_LIMIT);
+  return { text: text.slice(0, end > 0 ? end : TEXT_PREVIEW_LIMIT), truncated: true };
+}
+function useFileText(file, src) {
+  const source = _nullishCoalesce(file, () => ( src));
+  const [read, setRead] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (!source) return void 0;
+    let current = true;
+    const controller = new AbortController();
+    const text = typeof source === "string" ? fetch(source, { signal: controller.signal }).then((response) => {
+      if (!response.ok) throw new Error(`HTTP ${response.status}`);
+      return response.text();
+    }) : source.text();
+    text.then(
+      (value) => {
+        if (current) setRead({ source, result: { status: "read", ...startOf(value) } });
+      },
+      () => {
+        if (current) setRead({ source, result: { status: "failed" } });
+      }
+    );
+    return () => {
+      current = false;
+      controller.abort();
+    };
+  }, [source]);
+  if (!source) return null;
+  return _optionalChain([read, 'optionalAccess', _2 => _2.source]) === source ? read.result : { status: "reading" };
+}
+function useObjectUrl(file, type) {
+  const [made, setMade] = _react.useState.call(void 0, null);
+  _react.useLayoutEffect.call(void 0, () => {
+    if (!file) return void 0;
+    const url = URL.createObjectURL(type && file.type !== type ? new Blob([file], { type }) : file);
+    setMade({ file, type, url });
+    return () => URL.revokeObjectURL(url);
+  }, [file, type]);
+  return file && _optionalChain([made, 'optionalAccess', _3 => _3.file]) === file && made.type === type ? made.url : null;
+}
+function FilePreviewBody({
+  kind,
+  title,
+  file,
+  src,
+  loading,
+  error,
+  fallback,
+  download,
+  markdownComponents,
+  loadingLabel,
+  unavailableLabel,
+  failedLabel,
+  truncatedLabel
+}) {
+  const ready = !loading && !error && kind !== "none";
+  const reads = kind === "text" || kind === "markdown";
+  const text = useFileText(ready && reads ? file : null, ready && reads ? src : null);
+  const objectUrl = useObjectUrl(ready && !reads ? file : null, kind === "pdf" ? "application/pdf" : void 0);
+  const pending = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewStage, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewLoading, { label: loadingLabel }) });
+  const failed = (message) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewStage, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewNotice, { icon: _lucidereact.FileWarning, alert: true, message, children: _nullishCoalesce(fallback, () => ( download)) }) });
+  if (loading) return pending;
+  if (error) return failed(error);
+  if (kind === "none" || !file && !src) {
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewStage, { children: _nullishCoalesce(fallback, () => ( /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewNotice, { icon: _lucidereact.FileQuestion, message: unavailableLabel, children: download }))) });
+  }
+  if (reads) {
+    if (!text || text.status === "reading") return pending;
+    if (text.status === "failed") return failed(failedLabel);
+    return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkGRY77463cjs.PreviewStage, { layout: "scroll", label: `Preview of ${title}`, children: [
+      text.truncated && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk373W6VADcjs.Text, { variant: "caption", marginBottom: "sm", children: truncatedLabel }),
+      kind === "markdown" ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkKENBU3NVcjs.LazyMarkdown, { components: { a: NewTabLink, ...markdownComponents }, children: text.text }) : (
+        // The theme's relaxed leading is a fixed 1.8rem, which spaces a
+        // file's small monospace lines apart; read it at 20px lines.
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkVLXPLKFRcjs.CodeBlock, { wrap: true, className: "[&>pre]:leading-5", children: text.text })
+      )
+    ] });
+  }
+  const url = file ? objectUrl : src;
+  if (!url) return pending;
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ShownFile, { kind, url, title, failed: failed(failedLabel) }, url);
+}
+function ShownFile({
+  kind,
+  url,
+  title,
+  failed
+}) {
+  const [broken, setBroken] = _react.useState.call(void 0, false);
+  if (broken) return failed;
+  const fail = () => setBroken(true);
+  const label = `Preview of ${title}`;
+  if (kind === "image") {
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewStage, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "flex h-full w-full items-center justify-center p-4", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk4UUTKR3Vcjs.Image, { src: url, alt: title, fit: "contain", radius: "sm", className: "max-h-full max-w-full", onError: fail }) }) });
+  }
+  if (kind === "audio") {
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewStage, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "w-full max-w-md p-6", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "audio", { src: url, controls: true, preload: "metadata", "aria-label": label, className: "w-full", onError: fail }) }) });
+  }
+  if (kind === "video") {
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewStage, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "flex h-full w-full items-center justify-center p-4", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      "video",
+      {
+        src: url,
+        controls: true,
+        playsInline: true,
+        preload: "metadata",
+        "aria-label": label,
+        className: "max-h-full max-w-full rounded-sm",
+        onError: fail
+      }
+    ) }) });
+  }
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGRY77463cjs.PreviewStage, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "iframe", { src: url, title: label, referrerPolicy: "no-referrer", className: "h-full w-full border-0 bg-background" }) });
+}
+
+
+
+exports.FilePreview = FilePreview; exports.filePreviewKind = filePreviewKind;

package/dist/primitives/file-preview.d.cts

@@ -0,0 +1,92 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { MarkdownComponents } from './markdown.cjs';
+import 'react-markdown';
+import './rich-text.cjs';
+
+/**
+ * How FilePreview shows a file: in the browser's PDF viewer (`pdf`), as an
+ * image, as text (plain text, CSV, JSON, code), as rendered Markdown, or in
+ * an audio or video player. `none` has no preview (Office documents,
+ * archives, anything else), so the dialog offers the download instead.
+ */
+type FilePreviewKind = "pdf" | "image" | "text" | "markdown" | "audio" | "video" | "none";
+/** What `filePreviewKind` reads: a chat attachment, a stored file record, `{ name: file.name, mediaType: file.type }`. */
+interface FilePreviewFile {
+    /** The file's name, extension included. */
+    name?: string | null;
+    /** Its media type, as the browser, the upload or the server reported it. */
+    mediaType?: string | null;
+}
+/**
+ * How FilePreview would show a file, from its media type and its name: the
+ * type when it says something, the extension when it is missing or generic
+ * (`application/octet-stream`). Text named as Markdown is Markdown, since
+ * many systems report a `.md` file as `text/plain`, and a name that says text
+ * wins over a type with no preview, since Windows reports a `.csv` as
+ * `application/vnd.ms-excel`. Use it to decide whether to open a preview at
+ * all, or to label the action that opens a file.
+ */
+declare function filePreviewKind({ name, mediaType }: FilePreviewFile): FilePreviewKind;
+interface FilePreviewProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** The file's name: the dialog's title, and how its type is told when `mediaType` doesn't say. */
+    title: string;
+    /** The file's media type. Defaults to `file`'s own. */
+    mediaType?: string | null;
+    /** How to show it, when the host knows better than the name and the type. Defaults to `filePreviewKind()` of both. */
+    kind?: FilePreviewKind;
+    /**
+     * The file itself, fetched however the host's authentication needs. Text
+     * is read from it; a PDF, image or media file plays from an object URL
+     * the dialog makes and revokes. Takes precedence over `src`.
+     */
+    file?: Blob | null;
+    /**
+     * A URL the browser can load instead: short-lived or otherwise safe, as
+     * for `DocumentPreview`. Text and Markdown are fetched from it, so it must
+     * allow that (the same origin, or CORS).
+     */
+    src?: string | null;
+    /** The host is still fetching the file. */
+    loading?: boolean;
+    /** The host couldn't get the file: shown in place of the preview. */
+    error?: string | null;
+    onDownload?: () => void;
+    downloading?: boolean;
+    /** Names the download action, in the header and under a message. Defaults to "Download file". */
+    downloadLabel?: string;
+    /**
+     * Replaces the message (and its download action) shown when there is no
+     * preview, and goes under an error in place of the download action.
+     */
+    fallback?: ReactNode;
+    /** Per-element overrides for a Markdown file (`h1`, `a`, `code`, …). */
+    markdownComponents?: MarkdownComponents;
+    /** Defaults to "Loading preview…". */
+    loadingLabel?: string;
+    /** Shown when there is no preview: a type that has none, or nothing to show. Defaults to "No preview for this file." */
+    unavailableLabel?: string;
+    /** Shown when the file can't be read, shown or played. Defaults to "This file couldn't be shown here." */
+    failedLabel?: string;
+    /** Shown over a text file too long to show whole. Defaults to "Showing the start of this file. Download it to see the rest." */
+    truncatedLabel?: string;
+}
+/**
+ * A file in the kit's preview dialog (the same dialog as `DocumentPreview`),
+ * each type shown its own way: a PDF in the browser's viewer, an image, text
+ * (plain text, CSV, JSON, code) as it is, Markdown rendered through
+ * `LazyMarkdown`, and audio or video in the browser's player. Anything else
+ * (Office documents, archives) shows a message and the download.
+ *
+ * Presentation only: the host fetches the file with whatever authentication
+ * it needs and hands over the `Blob`, or a safe URL as `src`. A PDF from a
+ * `Blob` is always shown as `application/pdf`, whatever type the blob
+ * carries, so a file can never render as a page of the host's origin. Raw
+ * HTML in Markdown is ignored and its links open in a new tab; text is
+ * never interpreted.
+ */
+declare function FilePreview({ open, onOpenChange, title, mediaType, kind, file, src, loading, error, onDownload, downloading, downloadLabel, fallback, markdownComponents, loadingLabel, unavailableLabel, failedLabel, truncatedLabel, }: FilePreviewProps): react_jsx_runtime.JSX.Element;
+
+export { FilePreview, type FilePreviewFile, type FilePreviewKind, type FilePreviewProps, filePreviewKind };

package/dist/primitives/file-preview.d.ts

@@ -0,0 +1,92 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { MarkdownComponents } from './markdown.js';
+import 'react-markdown';
+import './rich-text.js';
+
+/**
+ * How FilePreview shows a file: in the browser's PDF viewer (`pdf`), as an
+ * image, as text (plain text, CSV, JSON, code), as rendered Markdown, or in
+ * an audio or video player. `none` has no preview (Office documents,
+ * archives, anything else), so the dialog offers the download instead.
+ */
+type FilePreviewKind = "pdf" | "image" | "text" | "markdown" | "audio" | "video" | "none";
+/** What `filePreviewKind` reads: a chat attachment, a stored file record, `{ name: file.name, mediaType: file.type }`. */
+interface FilePreviewFile {
+    /** The file's name, extension included. */
+    name?: string | null;
+    /** Its media type, as the browser, the upload or the server reported it. */
+    mediaType?: string | null;
+}
+/**
+ * How FilePreview would show a file, from its media type and its name: the
+ * type when it says something, the extension when it is missing or generic
+ * (`application/octet-stream`). Text named as Markdown is Markdown, since
+ * many systems report a `.md` file as `text/plain`, and a name that says text
+ * wins over a type with no preview, since Windows reports a `.csv` as
+ * `application/vnd.ms-excel`. Use it to decide whether to open a preview at
+ * all, or to label the action that opens a file.
+ */
+declare function filePreviewKind({ name, mediaType }: FilePreviewFile): FilePreviewKind;
+interface FilePreviewProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** The file's name: the dialog's title, and how its type is told when `mediaType` doesn't say. */
+    title: string;
+    /** The file's media type. Defaults to `file`'s own. */
+    mediaType?: string | null;
+    /** How to show it, when the host knows better than the name and the type. Defaults to `filePreviewKind()` of both. */
+    kind?: FilePreviewKind;
+    /**
+     * The file itself, fetched however the host's authentication needs. Text
+     * is read from it; a PDF, image or media file plays from an object URL
+     * the dialog makes and revokes. Takes precedence over `src`.
+     */
+    file?: Blob | null;
+    /**
+     * A URL the browser can load instead: short-lived or otherwise safe, as
+     * for `DocumentPreview`. Text and Markdown are fetched from it, so it must
+     * allow that (the same origin, or CORS).
+     */
+    src?: string | null;
+    /** The host is still fetching the file. */
+    loading?: boolean;
+    /** The host couldn't get the file: shown in place of the preview. */
+    error?: string | null;
+    onDownload?: () => void;
+    downloading?: boolean;
+    /** Names the download action, in the header and under a message. Defaults to "Download file". */
+    downloadLabel?: string;
+    /**
+     * Replaces the message (and its download action) shown when there is no
+     * preview, and goes under an error in place of the download action.
+     */
+    fallback?: ReactNode;
+    /** Per-element overrides for a Markdown file (`h1`, `a`, `code`, …). */
+    markdownComponents?: MarkdownComponents;
+    /** Defaults to "Loading preview…". */
+    loadingLabel?: string;
+    /** Shown when there is no preview: a type that has none, or nothing to show. Defaults to "No preview for this file." */
+    unavailableLabel?: string;
+    /** Shown when the file can't be read, shown or played. Defaults to "This file couldn't be shown here." */
+    failedLabel?: string;
+    /** Shown over a text file too long to show whole. Defaults to "Showing the start of this file. Download it to see the rest." */
+    truncatedLabel?: string;
+}
+/**
+ * A file in the kit's preview dialog (the same dialog as `DocumentPreview`),
+ * each type shown its own way: a PDF in the browser's viewer, an image, text
+ * (plain text, CSV, JSON, code) as it is, Markdown rendered through
+ * `LazyMarkdown`, and audio or video in the browser's player. Anything else
+ * (Office documents, archives) shows a message and the download.
+ *
+ * Presentation only: the host fetches the file with whatever authentication
+ * it needs and hands over the `Blob`, or a safe URL as `src`. A PDF from a
+ * `Blob` is always shown as `application/pdf`, whatever type the blob
+ * carries, so a file can never render as a page of the host's origin. Raw
+ * HTML in Markdown is ignored and its links open in a new tab; text is
+ * never interpreted.
+ */
+declare function FilePreview({ open, onOpenChange, title, mediaType, kind, file, src, loading, error, onDownload, downloading, downloadLabel, fallback, markdownComponents, loadingLabel, unavailableLabel, failedLabel, truncatedLabel, }: FilePreviewProps): react_jsx_runtime.JSX.Element;
+
+export { FilePreview, type FilePreviewFile, type FilePreviewKind, type FilePreviewProps, filePreviewKind };