@overtone-art/canvas-editor-core 0.2.7 → 0.2.8

package/dist/node.d.mts

@@ -1,6 +1,55 @@
-import { c as EditorState } from './types-bOY7oYVq.mjs';
+import { c as EditorState } from './types-D60CfxL9.mjs';
 import 'fabric';
 
+interface PrintPdfOptions {
+    /** Rasterization density. Defaults to the document DPI, or 300. */
+    dpi?: number;
+    /** Bleed on every edge, in inches. Defaults to 0.125in. */
+    bleed?: number;
+    /** Space outside bleed reserved for printer marks, in inches. Defaults to 0.25in. */
+    marksMargin?: number;
+    trimMarks?: boolean;
+    registrationMarks?: boolean;
+    /** Optional safe-area inset in inches for preflight warnings. */
+    safeArea?: number;
+    /** Sharp built-in `cmyk` profile or an absolute path to a custom ICC profile. */
+    iccProfile?: string;
+    /** Ceiling on the rasterized bleed image, in pixels. Defaults to 250 megapixels. */
+    maxPixels?: number;
+    outputConditionIdentifier?: string;
+    title?: string;
+    allowImageUrl?: NodeRenderOptions['allowImageUrl'];
+    /** Preserve SVG shapes/text over a CMYK bleed raster. Defaults to `vector`. */
+    rendering?: 'vector' | 'raster';
+    /** PDFKit font registrations keyed by the exact SVG font-family name. */
+    fontFiles?: Record<string, string | Uint8Array>;
+    /** Convert text backed by `fontFiles` into glyph paths. Defaults to true. */
+    outlineFonts?: boolean;
+}
+interface PrintPdfResult {
+    format: 'pdf';
+    mimeType: 'application/pdf';
+    data: Uint8Array;
+    standard: 'PDF/X-4';
+    colourSpace: 'CMYK';
+    rendering: 'vector' | 'raster';
+    outlinedFonts: string[];
+    unoutlinedFonts: string[];
+    dpi: number;
+    trimWidthPoints: number;
+    trimHeightPoints: number;
+    bleedPoints: number;
+    warnings: string[];
+}
+/**
+ * Render an EditorState into a print-production PDF/X-4 file.
+ *
+ * The design is rasterized at the requested density, converted through Sharp's
+ * CMYK ICC pipeline, edge-extended into bleed, and embedded with output intent,
+ * trim/bleed boxes, XMP identification, and optional printer marks.
+ */
+declare function renderPrintPdf(state: EditorState, options?: PrintPdfOptions): Promise<PrintPdfResult>;
+
 interface NodeRenderOptions {
     format?: 'png' | 'jpeg' | 'webp' | 'svg';
     multiplier?: number;
@@ -34,4 +83,4 @@ declare function renderMockupStateBatch(states: EditorState[], options?: NodeRen
     concurrency?: number;
 }): Promise<NodeRenderResult[]>;
 
-export { type NodeRenderOptions, type NodeRenderResult, renderEditorState, renderEditorStateBatch, renderMockupState, renderMockupStateBatch };
+export { type NodeRenderOptions, type NodeRenderResult, type PrintPdfOptions, type PrintPdfResult, renderEditorState, renderEditorStateBatch, renderMockupState, renderMockupStateBatch, renderPrintPdf };

package/dist/node.d.ts

@@ -1,6 +1,55 @@
-import { c as EditorState } from './types-bOY7oYVq.js';
+import { c as EditorState } from './types-D60CfxL9.js';
 import 'fabric';
 
+interface PrintPdfOptions {
+    /** Rasterization density. Defaults to the document DPI, or 300. */
+    dpi?: number;
+    /** Bleed on every edge, in inches. Defaults to 0.125in. */
+    bleed?: number;
+    /** Space outside bleed reserved for printer marks, in inches. Defaults to 0.25in. */
+    marksMargin?: number;
+    trimMarks?: boolean;
+    registrationMarks?: boolean;
+    /** Optional safe-area inset in inches for preflight warnings. */
+    safeArea?: number;
+    /** Sharp built-in `cmyk` profile or an absolute path to a custom ICC profile. */
+    iccProfile?: string;
+    /** Ceiling on the rasterized bleed image, in pixels. Defaults to 250 megapixels. */
+    maxPixels?: number;
+    outputConditionIdentifier?: string;
+    title?: string;
+    allowImageUrl?: NodeRenderOptions['allowImageUrl'];
+    /** Preserve SVG shapes/text over a CMYK bleed raster. Defaults to `vector`. */
+    rendering?: 'vector' | 'raster';
+    /** PDFKit font registrations keyed by the exact SVG font-family name. */
+    fontFiles?: Record<string, string | Uint8Array>;
+    /** Convert text backed by `fontFiles` into glyph paths. Defaults to true. */
+    outlineFonts?: boolean;
+}
+interface PrintPdfResult {
+    format: 'pdf';
+    mimeType: 'application/pdf';
+    data: Uint8Array;
+    standard: 'PDF/X-4';
+    colourSpace: 'CMYK';
+    rendering: 'vector' | 'raster';
+    outlinedFonts: string[];
+    unoutlinedFonts: string[];
+    dpi: number;
+    trimWidthPoints: number;
+    trimHeightPoints: number;
+    bleedPoints: number;
+    warnings: string[];
+}
+/**
+ * Render an EditorState into a print-production PDF/X-4 file.
+ *
+ * The design is rasterized at the requested density, converted through Sharp's
+ * CMYK ICC pipeline, edge-extended into bleed, and embedded with output intent,
+ * trim/bleed boxes, XMP identification, and optional printer marks.
+ */
+declare function renderPrintPdf(state: EditorState, options?: PrintPdfOptions): Promise<PrintPdfResult>;
+
 interface NodeRenderOptions {
     format?: 'png' | 'jpeg' | 'webp' | 'svg';
     multiplier?: number;
@@ -34,4 +83,4 @@ declare function renderMockupStateBatch(states: EditorState[], options?: NodeRen
     concurrency?: number;
 }): Promise<NodeRenderResult[]>;
 
-export { type NodeRenderOptions, type NodeRenderResult, renderEditorState, renderEditorStateBatch, renderMockupState, renderMockupStateBatch };
+export { type NodeRenderOptions, type NodeRenderResult, type PrintPdfOptions, type PrintPdfResult, renderEditorState, renderEditorStateBatch, renderMockupState, renderMockupStateBatch, renderPrintPdf };