@ai-matrx/print 0.6.2 → 0.7.0

package/dist/react.d.cts

@@ -1,5 +1,11 @@
 import * as React from 'react';
 
+interface DocumentNotice {
+    code: "frontmatter-invalid" | "setting-ignored" | "xref-unresolved" | "citation-unresolved" | "html-stripped" | "image-unavailable" | "glyph-substituted" | "empty-document";
+    message: string;
+    remedy: string;
+}
+
 /**
  * @ai-matrx/print/core — the Block Print contract & print-window composition.
  *
@@ -320,5 +326,22 @@ interface LabelSheetPreviewProps {
     className?: string;
 }
 declare function LabelSheetPreview({ template: t, labels, startAtLabel, showCaption, ecLevel, calibration, pageIndex, className, }: LabelSheetPreviewProps): React.JSX.Element;
+interface DocumentPrintPreviewProps {
+    /** Markdown source, frontmatter settings included. */
+    markdown: string;
+    /** File name / fallback title when the frontmatter has none. */
+    title?: string;
+    className?: string;
+    /** Called for every degraded or dropped piece (also listed in the panel). */
+    onNotice?: (notice: DocumentNotice) => void;
+}
+/**
+ * Print preview for a markdown document: the real PDF (the same file the PDF
+ * download gives you — pages, header/footer, TOC page numbers), a "Web" view
+ * of the HTML with a clickable TOC, and one-click export to PDF, Word, EPUB,
+ * HTML and Markdown. Everything comes from one parsed tree, so what you see
+ * is what every format contains. Engines load lazily on mount.
+ */
+declare function DocumentPrintPreview({ markdown, title, className, onNotice }: DocumentPrintPreviewProps): React.JSX.Element;
 
-export { LabelSheetPreview, type LabelSheetPreviewProps, PrintOptionsDialog, type PrintOptionsDialogProps, usePrintOptions };
+export { DocumentPrintPreview, type DocumentPrintPreviewProps, LabelSheetPreview, type LabelSheetPreviewProps, PrintOptionsDialog, type PrintOptionsDialogProps, usePrintOptions };

package/dist/react.d.ts

@@ -1,5 +1,11 @@
 import * as React from 'react';
 
+interface DocumentNotice {
+    code: "frontmatter-invalid" | "setting-ignored" | "xref-unresolved" | "citation-unresolved" | "html-stripped" | "image-unavailable" | "glyph-substituted" | "empty-document";
+    message: string;
+    remedy: string;
+}
+
 /**
  * @ai-matrx/print/core — the Block Print contract & print-window composition.
  *
@@ -320,5 +326,22 @@ interface LabelSheetPreviewProps {
     className?: string;
 }
 declare function LabelSheetPreview({ template: t, labels, startAtLabel, showCaption, ecLevel, calibration, pageIndex, className, }: LabelSheetPreviewProps): React.JSX.Element;
+interface DocumentPrintPreviewProps {
+    /** Markdown source, frontmatter settings included. */
+    markdown: string;
+    /** File name / fallback title when the frontmatter has none. */
+    title?: string;
+    className?: string;
+    /** Called for every degraded or dropped piece (also listed in the panel). */
+    onNotice?: (notice: DocumentNotice) => void;
+}
+/**
+ * Print preview for a markdown document: the real PDF (the same file the PDF
+ * download gives you — pages, header/footer, TOC page numbers), a "Web" view
+ * of the HTML with a clickable TOC, and one-click export to PDF, Word, EPUB,
+ * HTML and Markdown. Everything comes from one parsed tree, so what you see
+ * is what every format contains. Engines load lazily on mount.
+ */
+declare function DocumentPrintPreview({ markdown, title, className, onNotice }: DocumentPrintPreviewProps): React.JSX.Element;
 
-export { LabelSheetPreview, type LabelSheetPreviewProps, PrintOptionsDialog, type PrintOptionsDialogProps, usePrintOptions };
+export { DocumentPrintPreview, type DocumentPrintPreviewProps, LabelSheetPreview, type LabelSheetPreviewProps, PrintOptionsDialog, type PrintOptionsDialogProps, usePrintOptions };

package/dist/react.js

@@ -1537,7 +1537,124 @@ function LabelSheetPreview({
     }
   );
 }
+var EXPORT_BUTTONS = [
+  { format: "pdf", label: "PDF" },
+  { format: "docx", label: "Word" },
+  { format: "epub", label: "EPUB" },
+  { format: "html", label: "HTML" },
+  { format: "markdown", label: "Markdown" }
+];
+function DocumentPrintPreview({ markdown, title, className, onNotice }) {
+  const [view, setView] = useState("pages");
+  const [pdf, setPdf] = useState(null);
+  const [html, setHtml] = useState("");
+  const [notices, setNotices] = useState([]);
+  const [summary, setSummary] = useState("");
+  const [error, setError] = useState(null);
+  const [busy, setBusy] = useState("render");
+  const noticeRef = React.useRef(onNotice);
+  noticeRef.current = onNotice;
+  const frameRef = React.useRef(null);
+  useEffect(() => {
+    let cancelled = false;
+    let url = null;
+    setBusy("render");
+    const timer = setTimeout(async () => {
+      try {
+        const doc = await import("@ai-matrx/print/document");
+        const exp = await doc.exportDocument(markdown, "pdf", { title });
+        if (cancelled) return;
+        url = URL.createObjectURL(new Blob([exp.bytes], { type: "application/pdf" }));
+        const images = await doc.resolveDocumentImages(exp.tree);
+        if (cancelled) return;
+        setPdf({ url, pages: exp.pageCount ?? 0 });
+        setHtml(doc.documentToHtml(exp.tree, { images }));
+        const s = exp.tree.settings;
+        setSummary(
+          [
+            doc.PAGE_SIZES[s.page.size].label,
+            s.page.orientation === "landscape" ? "Landscape" : "Portrait",
+            exp.tree.figures.length ? `${exp.tree.figures.length} figure${exp.tree.figures.length === 1 ? "" : "s"}` : "",
+            exp.tree.tables.length ? `${exp.tree.tables.length} table${exp.tree.tables.length === 1 ? "" : "s"}` : "",
+            exp.tree.bibliography.length ? `${exp.tree.bibliography.length} reference${exp.tree.bibliography.length === 1 ? "" : "s"}` : ""
+          ].filter(Boolean).join(" \xB7 ")
+        );
+        setNotices(exp.notices);
+        for (const n of exp.notices) noticeRef.current?.(n);
+        setError(null);
+      } catch (err) {
+        if (!cancelled) setError(err instanceof Error ? err.message : String(err));
+      } finally {
+        if (!cancelled) setBusy(null);
+      }
+    }, 350);
+    return () => {
+      cancelled = true;
+      clearTimeout(timer);
+      if (url) URL.revokeObjectURL(url);
+    };
+  }, [markdown, title]);
+  const download = async (format) => {
+    setBusy(format);
+    try {
+      const doc = await import("@ai-matrx/print/document");
+      const exp = await doc.exportDocument(markdown, format, { title });
+      doc.downloadDocumentExport(exp);
+      setError(null);
+    } catch (err) {
+      setError(`${format.toUpperCase()} export failed: ${err instanceof Error ? err.message : String(err)}`);
+    } finally {
+      setBusy(null);
+    }
+  };
+  const print = () => {
+    if (!pdf) return;
+    try {
+      frameRef.current?.contentWindow?.print();
+    } catch {
+      window.open(pdf.url, "_blank", "noopener");
+    }
+  };
+  const btn = "inline-flex h-7 items-center gap-1 rounded-md border border-border bg-background px-2.5 text-xs font-medium text-foreground hover:bg-accent disabled:opacity-50";
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex min-h-0 flex-1 flex-col", className), "data-testid": "document-print-preview", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2 border-b border-border px-3 py-1.5 text-xs", children: [
+      /* @__PURE__ */ jsx("div", { className: "inline-flex overflow-hidden rounded-md border border-border", role: "tablist", children: ["pages", "web"].map((v) => /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          role: "tab",
+          "aria-selected": view === v,
+          onClick: () => setView(v),
+          className: cn("px-2.5 py-1 text-xs", view === v ? "bg-accent font-medium text-foreground" : "text-muted-foreground"),
+          children: v === "pages" ? "Pages" : "Web"
+        },
+        v
+      )) }),
+      /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", "data-testid": "document-print-summary", children: busy === "render" && !pdf ? "Laying out pages\u2026" : `${pdf?.pages ?? 0} page${pdf?.pages === 1 ? "" : "s"}${summary ? ` \xB7 ${summary}` : ""}` }),
+      /* @__PURE__ */ jsxs("div", { className: "ml-auto flex flex-wrap items-center gap-1.5", children: [
+        /* @__PURE__ */ jsx("button", { type: "button", className: btn, onClick: print, disabled: !pdf, children: "Print" }),
+        EXPORT_BUTTONS.map((b) => /* @__PURE__ */ jsx("button", { type: "button", className: btn, onClick: () => void download(b.format), disabled: busy === b.format, children: busy === b.format ? "Saving\u2026" : b.label }, b.format))
+      ] })
+    ] }),
+    error && /* @__PURE__ */ jsx("p", { className: "border-b border-border bg-destructive/10 px-3 py-1.5 text-xs text-destructive", children: error }),
+    notices.length > 0 && /* @__PURE__ */ jsxs("details", { className: "border-b border-border px-3 py-1.5 text-xs", children: [
+      /* @__PURE__ */ jsxs("summary", { className: "cursor-pointer text-amber-700 dark:text-amber-400", children: [
+        notices.length,
+        " thing",
+        notices.length === 1 ? "" : "s",
+        " to fix before printing"
+      ] }),
+      /* @__PURE__ */ jsx("ul", { className: "mt-1 space-y-1", children: notices.map((n, i) => /* @__PURE__ */ jsxs("li", { children: [
+        /* @__PURE__ */ jsx("span", { className: "text-foreground", children: n.message }),
+        " ",
+        /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: n.remedy })
+      ] }, i)) })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "min-h-0 flex-1 bg-muted/40", children: view === "pages" ? pdf ? /* @__PURE__ */ jsx("iframe", { ref: frameRef, title: "Print preview", src: pdf.url, className: "h-full min-h-[480px] w-full border-0" }) : /* @__PURE__ */ jsx("p", { className: "p-8 text-center text-xs text-muted-foreground", children: error ? "No preview." : "Laying out pages\u2026" }) : /* @__PURE__ */ jsx("iframe", { title: "Web preview", srcDoc: html, sandbox: "allow-same-origin", className: "h-full min-h-[480px] w-full border-0 bg-white" }) })
+  ] });
+}
 export {
+  DocumentPrintPreview,
   LabelSheetPreview,
   PrintOptionsDialog,
   usePrintOptions