@ztwoint/z-ui 0.1.149 → 0.1.151

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

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

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-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.149",
+  "version": "0.1.151",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",