@ztwoint/z-ui 0.1.148 → 0.1.151

package/dist/components/pdf-preview/pdf-preview.hook.js

@@ -1,69 +1,74 @@
-import { useRef as c, useState as h, useCallback as R, useEffect as x } from "react";
-function A(t) {
-  if (typeof t == "string")
+import { useRef as l, useState as U, useCallback as g, useEffect as q } from "react";
+import { injectPdfTitle as z } from "./pdf-title-injector.js";
+function G(r) {
+  if (typeof r == "string")
     try {
-      const n = new URL(t, "http://localhost").pathname.split("/").pop();
+      const n = new URL(r, "http://localhost").pathname.split("/").pop();
       if (n && n.endsWith(".pdf")) return decodeURIComponent(n);
     } catch {
     }
-  return t instanceof File ? t.name : "PDF Preview";
+  return r instanceof File ? r.name : "PDF Preview";
 }
-function W(t) {
-  const { src: u, open: n, onOpenChange: a, onError: L, onLoad: P } = t, i = c(u);
-  i.current = u;
-  const f = c(P);
+function K(r) {
+  const { src: a, open: n, onOpenChange: i, onError: w, onLoad: P, downloadFilename: C } = r, u = l(a);
+  u.current = a;
+  const f = l(P);
   f.current = P;
-  const d = c(L);
-  d.current = L;
-  const [k, w] = h(!1), [O, p] = h("idle"), [S, b] = h(null), [j, g] = h(null), v = c(null), m = c(null), y = n !== void 0, C = y ? n : k, o = R(() => {
-    v.current && (URL.revokeObjectURL(v.current), v.current = null);
-  }, []), U = R(async () => {
-    var l, E, F;
-    (l = m.current) == null || l.abort();
+  const d = l(w);
+  d.current = w;
+  const L = l(C);
+  L.current = C;
+  const [O, S] = U(!1), [T, p] = U("idle"), [B, m] = U(null), [D, h] = U(null), b = l(null), v = l(null), y = n !== void 0, F = y ? n : O, o = g(() => {
+    b.current && (URL.revokeObjectURL(b.current), b.current = null);
+  }, []), R = g(async () => {
+    var c, E, j;
+    (c = v.current) == null || c.abort();
     const e = new AbortController();
-    m.current = e, p("loading"), g(null), b(null), o();
+    v.current = e, p("loading"), h(null), m(null), o();
     try {
-      let r;
-      if (typeof i.current == "function" ? r = await i.current(e.signal) : r = i.current, e.signal.aborted) return;
-      if (typeof r == "string")
-        b(r);
+      let t;
+      if (typeof u.current == "function" ? t = await u.current(e.signal) : t = u.current, e.signal.aborted) return;
+      if (typeof t == "string")
+        m(t);
       else {
-        const s = URL.createObjectURL(r);
-        v.current = s, b(s);
+        const s = L.current || (t instanceof File ? t.name : null), W = s ? await z(t, s) : t;
+        if (e.signal.aborted) return;
+        const k = URL.createObjectURL(W);
+        b.current = k, m(k);
       }
       p("ready"), (E = f.current) == null || E.call(f);
-    } catch (r) {
+    } catch (t) {
       if (e.signal.aborted) return;
       const s = {
-        message: r instanceof Error ? r.message : "Failed to load PDF",
-        cause: r
+        message: t instanceof Error ? t.message : "Failed to load PDF",
+        cause: t
       };
-      g(s), p("error"), (F = d.current) == null || F.call(d, s);
+      h(s), p("error"), (j = d.current) == null || j.call(d, s);
     }
-  }, [o]), D = R(
+  }, [o]), I = g(
     (e) => {
-      var l;
-      y || w(e), a == null || a(e), e || ((l = m.current) == null || l.abort(), p("idle"), b(null), g(null), o());
+      var c;
+      y || S(e), i == null || i(e), e || ((c = v.current) == null || c.abort(), p("idle"), m(null), h(null), o());
     },
-    [y, a, o]
+    [y, i, o]
   );
-  x(() => (C && U(), () => {
+  q(() => (F && R(), () => {
     var e;
-    (e = m.current) == null || e.abort(), o();
-  }), [C, U, o]);
-  const I = R(() => {
-    U();
-  }, [U]), T = A(u);
+    (e = v.current) == null || e.abort(), o();
+  }), [F, R, o]);
+  const x = g(() => {
+    R();
+  }, [R]), A = G(a);
   return {
-    open: C,
-    handleOpenChange: D,
-    status: O,
-    resolvedUrl: S,
-    error: j,
-    retry: I,
-    resolvedTitle: T
+    open: F,
+    handleOpenChange: I,
+    status: T,
+    resolvedUrl: B,
+    error: D,
+    retry: x,
+    resolvedTitle: A
   };
 }
 export {
-  W as usePdfPreview
+  K as usePdfPreview
 };

package/dist/components/pdf-preview/pdf-preview.js

@@ -1,71 +1,76 @@
 import { jsxs as P, jsx as o } from "react/jsx-runtime";
-import * as v from "react";
-import { cn as j } from "../../lib/utils.js";
-import { Z2Dialog as L, Z2DialogTrigger as O, Z2DialogContent as U, Z2DialogTitle as W } from "../dialog/dialog.js";
-import { PDF_PREVIEW_DEFAULTS as m, pdfDialogContentVariants as z } from "./pdf-preview.const.js";
-import { usePdfPreview as A } from "./pdf-preview.hook.js";
-import { PdfToolbar as F } from "./components/pdf-toolbar.js";
-import { PdfViewer as I } from "./components/pdf-viewer.js";
-import { PdfLoadingState as $ } from "./components/pdf-loading-state.js";
+import * as y from "react";
+import { cn as _ } from "../../lib/utils.js";
+import { Z2Dialog as j, Z2DialogTrigger as L, Z2DialogContent as O, Z2DialogTitle as U } from "../dialog/dialog.js";
+import { PDF_PREVIEW_DEFAULTS as c, pdfDialogContentVariants as $ } from "./pdf-preview.const.js";
+import { usePdfPreview as z } from "./pdf-preview.hook.js";
+import { PdfToolbar as A } from "./components/pdf-toolbar.js";
+import { PdfViewer as F } from "./components/pdf-viewer.js";
+import { PdfLoadingState as I } from "./components/pdf-loading-state.js";
 import { PdfErrorState as q } from "./components/pdf-error-state.js";
 const B = ({
-  src: y,
-  title: w,
-  size: D = m.size,
+  src: w,
+  title: u,
+  size: D = c.size,
   open: C,
   onOpenChange: E,
   disabled: t = !1,
-  showToolbar: c = m.showToolbar,
-  showDownload: T = m.showDownload,
-  downloadFilename: u,
-  onDownload: l,
+  showToolbar: g = c.showToolbar,
+  showDownload: T = c.showDownload,
+  downloadFilename: f,
+  onDownload: d,
   loadingContent: b,
-  errorContent: n,
-  renderPdf: g,
+  errorContent: i,
+  renderPdf: h,
   className: N,
   viewerClassName: Z,
   onError: k,
   onLoad: x,
-  children: h
+  children: v
 }) => {
-  const { open: f, handleOpenChange: d, status: a, resolvedUrl: e, error: s, retry: R, resolvedTitle: S } = A({
-    src: y,
+  const { open: l, handleOpenChange: s, status: a, resolvedUrl: r, error: p, retry: R, resolvedTitle: S } = z({
+    src: w,
     open: C,
     onOpenChange: E,
     onError: k,
-    onLoad: x
-  }), i = w || S, V = v.useCallback(() => {
-    if (!e)
+    onLoad: x,
+    downloadFilename: (() => {
+      const e = f || u;
+      if (e)
+        return e.endsWith(".pdf") ? e : `${e}.pdf`;
+    })()
+  }), n = u || S, V = y.useCallback(() => {
+    if (!r)
       return;
-    l && l();
-    const r = document.createElement("a");
-    r.href = e;
-    const p = u || i || "document.pdf";
-    r.download = p.endsWith(".pdf") ? p : `${p}.pdf`, r.target = "_blank", r.rel = "noopener noreferrer", document.body.appendChild(r), r.click(), document.body.removeChild(r);
-  }, [l, e, u, i]), _ = () => a === "idle" || a === "loading" ? b || /* @__PURE__ */ o($, {}) : a === "error" && s ? n ? typeof n == "function" ? n(s) : n : /* @__PURE__ */ o(q, { error: s, onRetry: R }) : a === "ready" && e ? g ? g(e) : /* @__PURE__ */ o(I, { url: e, title: i, className: Z }) : null;
-  return v.useEffect(() => {
-    t && f && d(!1);
-  }, [t, f, d]), // Z2Dialog wraps Radix Dialog — manages focus trapping, escape key, and overlay click-to-close
-  /* @__PURE__ */ P(L, { open: t ? !1 : f, onOpenChange: t ? void 0 : d, children: [
-    h && /* @__PURE__ */ o(O, { asChild: !0, disabled: t, "data-slot": "pdf-preview-trigger", children: h }),
+    d && d();
+    const e = document.createElement("a");
+    e.href = r;
+    const m = f || n || "document.pdf";
+    e.download = m.endsWith(".pdf") ? m : `${m}.pdf`, e.target = "_blank", e.rel = "noopener noreferrer", document.body.appendChild(e), e.click(), document.body.removeChild(e);
+  }, [d, r, f, n]), W = () => a === "idle" || a === "loading" ? b || /* @__PURE__ */ o(I, {}) : a === "error" && p ? i ? typeof i == "function" ? i(p) : i : /* @__PURE__ */ o(q, { error: p, onRetry: R }) : a === "ready" && r ? h ? h(r) : /* @__PURE__ */ o(F, { url: r, title: n, className: Z }) : null;
+  return y.useEffect(() => {
+    t && l && s(!1);
+  }, [t, l, s]), // Z2Dialog wraps Radix Dialog — manages focus trapping, escape key, and overlay click-to-close
+  /* @__PURE__ */ P(j, { open: t ? !1 : l, onOpenChange: t ? void 0 : s, children: [
+    v && /* @__PURE__ */ o(L, { asChild: !0, disabled: t, "data-slot": "pdf-preview-trigger", children: v }),
     /* @__PURE__ */ P(
-      U,
+      O,
       {
         "data-slot": "pdf-preview-content",
-        className: j(z({ size: D }), N),
+        className: _($({ size: D }), N),
         "aria-describedby": void 0,
         children: [
-          c && /* @__PURE__ */ o(
-            F,
+          g && /* @__PURE__ */ o(
+            A,
             {
-              title: i,
+              title: n,
               showDownload: T,
               onDownload: V,
-              downloadDisabled: !e
+              downloadDisabled: !r
             }
           ),
-          !c && /* @__PURE__ */ o(W, { className: "sr-only", children: i }),
-          _()
+          !g && /* @__PURE__ */ o(U, { className: "sr-only", children: n }),
+          W()
         ]
       }
     )

package/dist/components/pdf-preview/pdf-preview.type.d.ts

@@ -69,6 +69,9 @@ export interface UsePdfPreviewProps {
     onOpenChange?: (open: boolean) => void;
     onError?: (error: PdfPreviewError) => void;
     onLoad?: () => void;
+    /** Filename appended as a URL fragment to blob URLs so the browser's
+     *  built-in PDF viewer uses it for "Save As" instead of the blob UUID. */
+    downloadFilename?: string;
 }
 /** Return value of usePdfPreview — provides state and handlers to the main component. */
 export interface UsePdfPreviewReturn {

package/dist/components/pdf-preview/pdf-title-injector.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Injects a /Title into a PDF's metadata via an incremental update.
+ *
+ * ## Problem
+ * When displaying a PDF via a blob URL (`blob:http://.../<uuid>`), Chrome's
+ * built-in PDF viewer (PDFium) shows the blob UUID as the document name in
+ * the toolbar — e.g. "f48f9554-646a-4...". There is no standard web API to
+ * control this; the File constructor name, URL fragments (#filename=), and
+ * Content-Disposition headers are all ignored for blob URLs.
+ *
+ * ## Solution
+ * Chrome's PDF viewer reads the `/Title` field from the PDF's Info dictionary
+ * and displays it in the toolbar when present. This function appends a new
+ * Info dictionary object containing the desired title using a PDF incremental
+ * update — the original content is never modified, only ~200 bytes are
+ * appended at the end. This keeps it fast even for large PDFs (50MB+ with
+ * heavy images), since we never re-parse or re-serialize the PDF body.
+ *
+ * ## What it covers
+ * - Chrome toolbar title: Shows the injected /Title instead of the UUID
+ * - Download button: Handled separately by the component via <a download="filename">
+ *
+ * ## What it does NOT cover
+ * - Ctrl+S "Save As" filename: Chrome still derives this from the blob URL,
+ *   not the PDF metadata. Only a Service Worker + Cache API approach can fix
+ *   this (see https://stackoverflow.com/q/53548182), which is too complex
+ *   for this use case.
+ *
+ * ## Edge cases (falls back silently to original blob — UUID shown)
+ * - Password-protected / encrypted PDFs: The appended Info dictionary is
+ *   unencrypted, which Chrome may ignore. For full encrypted PDF support,
+ *   use `pdf-lib` (lazy-loaded via `await import('pdf-lib')`) which
+ *   understands PDF encryption and can set metadata correctly.
+ * - PDFs with cross-reference streams (PDF 1.5+): Works if `/Size` appears
+ *   in plain text within the xref stream object dictionary (most common).
+ *   May fail on heavily compressed xref streams where `/Size` is not
+ *   visible as plain text.
+ * - Malformed or non-PDF blobs: Regex finds no `startxref` → returns
+ *   original blob unchanged.
+ *
+ * ## Performance
+ * - Reads the blob once as ArrayBuffer (already in memory from the fetch)
+ * - Decodes to string for two regex searches (`/Size`, `startxref`)
+ * - Appends ~200 bytes (new object + xref + trailer)
+ * - No re-parsing, no re-serialization of the PDF body
+ * - Significantly lighter than pdf-lib which parses + rewrites everything
+ */
+export declare function injectPdfTitle(blob: Blob, title: string): Promise<Blob>;

package/dist/components/pdf-preview/pdf-title-injector.js

@@ -0,0 +1,39 @@
+async function O(t, r) {
+  try {
+    const n = await t.arrayBuffer(), e = new Uint8Array(n), s = new TextDecoder("latin1").decode(e), i = s.lastIndexOf("startxref");
+    if (i === -1) return t;
+    const y = s.substring(i + 9).trim(), f = parseInt(y, 10);
+    if (isNaN(f)) return t;
+    const o = s.match(/\/Size\s+(\d+)/g);
+    if (!o) return t;
+    const d = o[o.length - 1].match(/\d+/);
+    if (!d) return t;
+    const l = parseInt(d[0], 10), c = l, w = l + 1, $ = F(r), p = e[e.length - 1], x = p !== 10 && p !== 13 ? `
+` : "", S = new TextEncoder(), j = S.encode(x), h = e.length + j.length, g = `${c} 0 obj
+<< /Title ${$} >>
+endobj
+`, z = S.encode(g), B = h + z.length, I = String(h).padStart(10, "0"), T = `xref
+${c} 1
+${I} 00000 n\r
+`, m = `trailer
+<< /Size ${w} /Info ${c} 0 R /Prev ${f} >>
+startxref
+${B}
+%%EOF
+`, E = x + g + T + m, u = new TextEncoder().encode(E), a = new Uint8Array(e.length + u.length);
+    return a.set(e), a.set(u, e.length), new Blob([a], { type: "application/pdf" });
+  } catch {
+    return t;
+  }
+}
+function F(t) {
+  let r = "FEFF";
+  for (let n = 0; n < t.length; n++) {
+    const e = t.charCodeAt(n);
+    r += e.toString(16).padStart(4, "0").toUpperCase();
+  }
+  return `<${r}>`;
+}
+export {
+  O as injectPdfTitle
+};

package/dist/types/components/pdf-preview/pdf-preview.type.d.ts

@@ -69,6 +69,9 @@ export interface UsePdfPreviewProps {
     onOpenChange?: (open: boolean) => void;
     onError?: (error: PdfPreviewError) => void;
     onLoad?: () => void;
+    /** Filename appended as a URL fragment to blob URLs so the browser's
+     *  built-in PDF viewer uses it for "Save As" instead of the blob UUID. */
+    downloadFilename?: string;
 }
 /** Return value of usePdfPreview — provides state and handlers to the main component. */
 export interface UsePdfPreviewReturn {

package/dist/types/components/pdf-preview/pdf-title-injector.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Injects a /Title into a PDF's metadata via an incremental update.
+ *
+ * ## Problem
+ * When displaying a PDF via a blob URL (`blob:http://.../<uuid>`), Chrome's
+ * built-in PDF viewer (PDFium) shows the blob UUID as the document name in
+ * the toolbar — e.g. "f48f9554-646a-4...". There is no standard web API to
+ * control this; the File constructor name, URL fragments (#filename=), and
+ * Content-Disposition headers are all ignored for blob URLs.
+ *
+ * ## Solution
+ * Chrome's PDF viewer reads the `/Title` field from the PDF's Info dictionary
+ * and displays it in the toolbar when present. This function appends a new
+ * Info dictionary object containing the desired title using a PDF incremental
+ * update — the original content is never modified, only ~200 bytes are
+ * appended at the end. This keeps it fast even for large PDFs (50MB+ with
+ * heavy images), since we never re-parse or re-serialize the PDF body.
+ *
+ * ## What it covers
+ * - Chrome toolbar title: Shows the injected /Title instead of the UUID
+ * - Download button: Handled separately by the component via <a download="filename">
+ *
+ * ## What it does NOT cover
+ * - Ctrl+S "Save As" filename: Chrome still derives this from the blob URL,
+ *   not the PDF metadata. Only a Service Worker + Cache API approach can fix
+ *   this (see https://stackoverflow.com/q/53548182), which is too complex
+ *   for this use case.
+ *
+ * ## Edge cases (falls back silently to original blob — UUID shown)
+ * - Password-protected / encrypted PDFs: The appended Info dictionary is
+ *   unencrypted, which Chrome may ignore. For full encrypted PDF support,
+ *   use `pdf-lib` (lazy-loaded via `await import('pdf-lib')`) which
+ *   understands PDF encryption and can set metadata correctly.
+ * - PDFs with cross-reference streams (PDF 1.5+): Works if `/Size` appears
+ *   in plain text within the xref stream object dictionary (most common).
+ *   May fail on heavily compressed xref streams where `/Size` is not
+ *   visible as plain text.
+ * - Malformed or non-PDF blobs: Regex finds no `startxref` → returns
+ *   original blob unchanged.
+ *
+ * ## Performance
+ * - Reads the blob once as ArrayBuffer (already in memory from the fetch)
+ * - Decodes to string for two regex searches (`/Size`, `startxref`)
+ * - Appends ~200 bytes (new object + xref + trailer)
+ * - No re-parsing, no re-serialization of the PDF body
+ * - Significantly lighter than pdf-lib which parses + rewrites everything
+ */
+export declare function injectPdfTitle(blob: Blob, title: string): Promise<Blob>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ztwoint/z-ui",
-  "version": "0.1.148",
+  "version": "0.1.151",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",