@signiphi/pdf-compose 0.1.0-beta.6 → 0.1.0-beta.8

package/dist/styles/index.css

@@ -311,6 +311,9 @@
 .signiphi-pdf-compose:not(#\#):not(#\#):not(#\#):not(#\#) .collapse {
   visibility: collapse;
 }
+.signiphi-pdf-compose:not(#\#):not(#\#):not(#\#):not(#\#) .visible {
+  visibility: visible;
+}
 .signiphi-pdf-compose:not(#\#):not(#\#):not(#\#):not(#\#) .absolute {
   position: absolute;
 }

package/dist/styles/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/markdown-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAmmBhD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAI9D"}
+{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiqBhD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAI9D"}

package/dist/utils/markdown-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-validator.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAKlF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,yBAAyB,EAAE,CAAC;IACvC,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CAwI3E"}
+{"version":3,"file":"markdown-validator.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAKlF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,yBAAyB,EAAE,CAAC;IACvC,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CA6I3E"}

package/dist/utils/markdown-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-writer.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiQhD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAMzD"}
+{"version":3,"file":"markdown-writer.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA6RhD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAMzD"}

package/dist/utils/pdf-generator.d.ts

@@ -1,10 +1,53 @@
+import type { Color } from 'pdf-lib';
 import type { JSONContent } from '@tiptap/core';
 import { type FormFieldPosition, type DocumentGeneratorField } from '../types';
+/**
+ * Optional brand colors for the PDF renderer (hex strings, e.g. "#161848").
+ * Every value is optional; omitted values fall back to the classic gray/black
+ * output, so existing consumers are unaffected.
+ */
+export interface PdfTheme {
+    /** Table-header fill, panel dark-header fill, horizontal rules, page-header text. */
+    primaryColor?: string;
+    /** Rule under the repeating page header. */
+    accentColor?: string;
+    /** Table and panel border lines. */
+    borderColor?: string;
+}
+/** Repeating page-header text, drawn inside the top margin of every page. */
+export interface PdfPageHeader {
+    /** Bold, primary-colored, left-aligned (e.g. marina name). */
+    left?: string;
+    /** Small gray, right-aligned (e.g. document title / number). */
+    right?: string;
+    /** Skip page 1 — for documents whose body already opens with a letterhead. */
+    skipFirstPage?: boolean;
+}
+/** Repeating page-footer text, drawn next to the existing page number. */
+export interface PdfPageFooter {
+    /** Small gray, left-aligned (e.g. contact line). */
+    left?: string;
+}
+interface ResolvedTheme {
+    tableHeaderBg: Color;
+    tableHeaderText: Color;
+    tableBorder: Color;
+    panelDarkHeaderBg: Color;
+    panelDarkHeaderText: Color;
+    panelBorder: Color;
+    rule: Color;
+    pageHeaderText: Color;
+    pageHeaderRule: Color;
+}
+/** Resolve a caller theme onto the classic defaults (exported for tests). */
+export declare function resolveTheme(theme?: PdfTheme): ResolvedTheme;
 export interface PdfGenerationResult {
-    pdfBytes: Uint8Array;
+    pdfBytes: Uint8Array<ArrayBuffer>;
     fieldPositions: Map<string, FormFieldPosition>;
     /** Non-fatal warnings about fields that failed to create */
     fieldWarnings?: string[];
+    /** Non-fatal warnings about images that failed to load/embed */
+    imageWarnings?: string[];
 }
 export interface PdfGenerationOptions {
     /** Draw visual placeholder boxes for fields in the PDF (default: false) */
@@ -13,6 +56,12 @@ export interface PdfGenerationOptions {
     embedFormFields?: boolean;
     /** Fields data for form field creation (required when embedFormFields is true) */
     fields?: DocumentGeneratorField[];
+    /** Brand colors; omitted values keep the classic gray/black output */
+    theme?: PdfTheme;
+    /** Repeating page header (drawn in the top margin of every page) */
+    header?: PdfPageHeader;
+    /** Repeating page footer (drawn next to the page number) */
+    footer?: PdfPageFooter;
 }
 /**
  * Generate a PDF from TipTap JSON content.
@@ -24,4 +73,5 @@ export interface PdfGenerationOptions {
  * into the PDF for downstream consumption (e.g. pdf-signer).
  */
 export declare function generatePdfFromContent(content: JSONContent, options?: PdfGenerationOptions): Promise<PdfGenerationResult>;
+export {};
 //# sourceMappingURL=pdf-generator.d.ts.map

package/dist/utils/pdf-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdf-generator.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAiB,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AA4jD9F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,UAAU,CAAC;IACrB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kFAAkF;IAClF,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAsE9B"}
+{"version":3,"file":"pdf-generator.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAiB,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAe9F;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAa;IACrB,aAAa,EAAE,KAAK,CAAC;IACrB,eAAe,EAAE,KAAK,CAAC;IACvB,WAAW,EAAE,KAAK,CAAC;IACnB,iBAAiB,EAAE,KAAK,CAAC;IACzB,mBAAmB,EAAE,KAAK,CAAC;IAC3B,WAAW,EAAE,KAAK,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC;IACZ,cAAc,EAAE,KAAK,CAAC;IACtB,cAAc,EAAE,KAAK,CAAC;CACvB;AAkBD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,aAAa,CAe5D;AA8rDD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAClC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kFAAkF;IAClF,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC,sEAAsE;IACtE,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAyH9B"}

package/dist/utils/template-pipeline.d.ts

@@ -1,6 +1,23 @@
 import type { JSONContent } from '@tiptap/core';
+import type { PdfTheme, PdfPageHeader, PdfPageFooter } from './pdf-generator';
 export interface HeadlessPdfResult {
-    pdfBytes: Uint8Array;
+    pdfBytes: Uint8Array<ArrayBuffer>;
+    /** Non-fatal warnings about images that failed to load/embed */
+    imageWarnings?: string[];
+}
+/**
+ * Presentation options for headless generation. All optional — omitting them
+ * reproduces the classic output exactly (backward compatible).
+ */
+export interface HeadlessPdfOptions {
+    /** Brand colors (table headers, panel headers, rules) */
+    theme?: PdfTheme;
+    /** Repeating page header (top margin of every page) */
+    header?: PdfPageHeader;
+    /** Repeating page footer (next to the page number) */
+    footer?: PdfPageFooter;
+    /** Draw visual placeholder boxes for fields (default: false) */
+    drawFieldPlaceholders?: boolean;
 }
 /**
  * Generate a PDF from TipTap JSON content with variable values applied.
@@ -8,7 +25,7 @@ export interface HeadlessPdfResult {
  * Pipeline: expand repeats -> suppress zeros -> replace variables -> render PDF.
  * Pure function — no React, no DOM, no editor instance required.
  */
-export declare function generatePdfFromTiptap(content: JSONContent, values: Record<string, string>): Promise<HeadlessPdfResult>;
+export declare function generatePdfFromTiptap(content: JSONContent, values: Record<string, string>, options?: HeadlessPdfOptions): Promise<HeadlessPdfResult>;
 /**
  * Generate a PDF from extended markdown with variable values applied.
  *
@@ -17,5 +34,5 @@ export declare function generatePdfFromTiptap(content: JSONContent, values: Reco
  *
  * Pure function — no React, no DOM, no editor instance required.
  */
-export declare function generatePdfFromMarkdown(markdown: string, values: Record<string, string>): Promise<HeadlessPdfResult>;
+export declare function generatePdfFromMarkdown(markdown: string, values: Record<string, string>, options?: HeadlessPdfOptions): Promise<HeadlessPdfResult>;
 //# sourceMappingURL=template-pipeline.d.ts.map

package/dist/utils/template-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-pipeline.d.ts","sourceRoot":"","sources":["../../src/utils/template-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAa5B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}
+{"version":3,"file":"template-pipeline.d.ts","sourceRoot":"","sources":["../../src/utils/template-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG9E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAClC,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,sDAAsD;IACtD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAiB5B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}

package/dist/utils/variable-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variable-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/variable-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,WAAW,GAAG,yBAAyB,EAAE,CAuB7F;AAeD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,WAAW,CAuBb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,WAAW,CAgDb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA+F1D"}
+{"version":3,"file":"variable-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/variable-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,WAAW,GAAG,yBAAyB,EAAE,CAuB7F;AAeD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,WAAW,CA+Bb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,WAAW,CAgDb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA+F1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signiphi/pdf-compose",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.8",
   "description": "Markdown-based document composer with field placeholders for the signiphi signing pipeline",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,7 +16,11 @@
       "require": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./styles": "./dist/styles/index.css",
+    "./styles": {
+      "types": "./dist/styles/index.d.ts",
+      "import": "./dist/styles/index.css",
+      "default": "./dist/styles/index.css"
+    },
     "./styles/source": "./src/styles/index.css",
     "./src/styles/index.css": "./src/styles/index.css",
     "./dist/styles/index.css": "./dist/styles/index.css"
@@ -27,9 +31,10 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup && tsc --emitDeclarationOnly --declaration --outDir dist && node -e \"require('fs').mkdirSync('dist/styles', {recursive: true})\" && postcss src/styles/index.css -o dist/styles/index.css",
-    "dev": "tsup --watch",
-    "type-check": "tsc --noEmit"
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --outDir dist && node -e \"require('fs').mkdirSync('dist/styles', {recursive: true})\" && postcss src/styles/index.css -o dist/styles/index.css && node -e \"require('fs').copyFileSync('src/styles/index.d.ts','dist/styles/index.d.ts')\"",
+    "dev": "tsup --watch --no-clean",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run"
   },
   "keywords": [
     "pdf",
@@ -91,6 +96,7 @@
     "postcss-preset-env": "^10.4.0",
     "tailwindcss": "^4.1.4",
     "tsup": "^8.3.5",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
   }
 }

package/src/styles/index.d.ts

@@ -0,0 +1 @@
+export {};