@ai-matrx/print 0.7.0 → 0.8.0

package/dist/react.d.cts

@@ -1,7 +1,34 @@
 import * as React from 'react';
 
+/** CSL-JSON name (the citation-style-language standard item shape). */
+interface CslName {
+    family?: string | undefined;
+    given?: string | undefined;
+    literal?: string | undefined;
+}
+/** A CSL-JSON reference item (the subset the three built-in styles read). */
+interface CslItem {
+    id: string;
+    type?: string | undefined;
+    title?: string | undefined;
+    author?: CslName[] | undefined;
+    editor?: CslName[] | undefined;
+    issued?: {
+        "date-parts"?: Array<Array<number | string>> | undefined;
+        literal?: string | undefined;
+    } | undefined;
+    "container-title"?: string | undefined;
+    publisher?: string | undefined;
+    "publisher-place"?: string | undefined;
+    volume?: string | number | undefined;
+    issue?: string | number | undefined;
+    page?: string | undefined;
+    edition?: string | number | undefined;
+    URL?: string | undefined;
+    DOI?: string | undefined;
+}
 interface DocumentNotice {
-    code: "frontmatter-invalid" | "setting-ignored" | "xref-unresolved" | "citation-unresolved" | "html-stripped" | "image-unavailable" | "glyph-substituted" | "empty-document";
+    code: "frontmatter-invalid" | "setting-ignored" | "xref-unresolved" | "citation-unresolved" | "html-stripped" | "image-unavailable" | "glyph-substituted" | "content-lost" | "math-error" | "empty-document";
     message: string;
     remedy: string;
 }
@@ -334,6 +361,11 @@ interface DocumentPrintPreviewProps {
     className?: string;
     /** Called for every degraded or dropped piece (also listed in the panel). */
     onNotice?: (notice: DocumentNotice) => void;
+    /**
+     * Resolves citation keys the document's frontmatter does not define
+     * (e.g. `[@research:<id>]`, `[@file:<id>]`) to CSL-JSON references.
+     */
+    resolveReferences?: (keys: string[]) => Promise<CslItem[]>;
 }
 /**
  * Print preview for a markdown document: the real PDF (the same file the PDF
@@ -342,6 +374,6 @@ interface DocumentPrintPreviewProps {
  * 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;
+declare function DocumentPrintPreview({ markdown, title, className, onNotice, resolveReferences }: DocumentPrintPreviewProps): React.JSX.Element;
 
 export { DocumentPrintPreview, type DocumentPrintPreviewProps, LabelSheetPreview, type LabelSheetPreviewProps, PrintOptionsDialog, type PrintOptionsDialogProps, usePrintOptions };

package/dist/react.d.ts

@@ -1,7 +1,34 @@
 import * as React from 'react';
 
+/** CSL-JSON name (the citation-style-language standard item shape). */
+interface CslName {
+    family?: string | undefined;
+    given?: string | undefined;
+    literal?: string | undefined;
+}
+/** A CSL-JSON reference item (the subset the three built-in styles read). */
+interface CslItem {
+    id: string;
+    type?: string | undefined;
+    title?: string | undefined;
+    author?: CslName[] | undefined;
+    editor?: CslName[] | undefined;
+    issued?: {
+        "date-parts"?: Array<Array<number | string>> | undefined;
+        literal?: string | undefined;
+    } | undefined;
+    "container-title"?: string | undefined;
+    publisher?: string | undefined;
+    "publisher-place"?: string | undefined;
+    volume?: string | number | undefined;
+    issue?: string | number | undefined;
+    page?: string | undefined;
+    edition?: string | number | undefined;
+    URL?: string | undefined;
+    DOI?: string | undefined;
+}
 interface DocumentNotice {
-    code: "frontmatter-invalid" | "setting-ignored" | "xref-unresolved" | "citation-unresolved" | "html-stripped" | "image-unavailable" | "glyph-substituted" | "empty-document";
+    code: "frontmatter-invalid" | "setting-ignored" | "xref-unresolved" | "citation-unresolved" | "html-stripped" | "image-unavailable" | "glyph-substituted" | "content-lost" | "math-error" | "empty-document";
     message: string;
     remedy: string;
 }
@@ -334,6 +361,11 @@ interface DocumentPrintPreviewProps {
     className?: string;
     /** Called for every degraded or dropped piece (also listed in the panel). */
     onNotice?: (notice: DocumentNotice) => void;
+    /**
+     * Resolves citation keys the document's frontmatter does not define
+     * (e.g. `[@research:<id>]`, `[@file:<id>]`) to CSL-JSON references.
+     */
+    resolveReferences?: (keys: string[]) => Promise<CslItem[]>;
 }
 /**
  * Print preview for a markdown document: the real PDF (the same file the PDF
@@ -342,6 +374,6 @@ interface DocumentPrintPreviewProps {
  * 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;
+declare function DocumentPrintPreview({ markdown, title, className, onNotice, resolveReferences }: DocumentPrintPreviewProps): React.JSX.Element;
 
 export { DocumentPrintPreview, type DocumentPrintPreviewProps, LabelSheetPreview, type LabelSheetPreviewProps, PrintOptionsDialog, type PrintOptionsDialogProps, usePrintOptions };

package/dist/react.js

@@ -1544,7 +1544,7 @@ var EXPORT_BUTTONS = [
   { format: "html", label: "HTML" },
   { format: "markdown", label: "Markdown" }
 ];
-function DocumentPrintPreview({ markdown, title, className, onNotice }) {
+function DocumentPrintPreview({ markdown, title, className, onNotice, resolveReferences }) {
   const [view, setView] = useState("pages");
   const [pdf, setPdf] = useState(null);
   const [html, setHtml] = useState("");
@@ -1562,7 +1562,7 @@ function DocumentPrintPreview({ markdown, title, className, onNotice }) {
     const timer = setTimeout(async () => {
       try {
         const doc = await import("@ai-matrx/print/document");
-        const exp = await doc.exportDocument(markdown, "pdf", { title });
+        const exp = await doc.exportDocument(markdown, "pdf", { title, resolveReferences });
         if (cancelled) return;
         url = URL.createObjectURL(new Blob([exp.bytes], { type: "application/pdf" }));
         const images = await doc.resolveDocumentImages(exp.tree);
@@ -1593,12 +1593,12 @@ function DocumentPrintPreview({ markdown, title, className, onNotice }) {
       clearTimeout(timer);
       if (url) URL.revokeObjectURL(url);
     };
-  }, [markdown, title]);
+  }, [markdown, title, resolveReferences]);
   const download = async (format) => {
     setBusy(format);
     try {
       const doc = await import("@ai-matrx/print/document");
-      const exp = await doc.exportDocument(markdown, format, { title });
+      const exp = await doc.exportDocument(markdown, format, { title, resolveReferences });
       doc.downloadDocumentExport(exp);
       setError(null);
     } catch (err) {