pretext-pdf 1.1.0 → 1.6.0

package/dist/validate/errors.js

@@ -0,0 +1,43 @@
+export function isValidPdfDocumentLike(doc) {
+    return doc !== null && typeof doc === 'object' && !Array.isArray(doc);
+}
+/** Parse a PretextPdfError message into structured ValidationError entries */
+export function parseValidationErrorsStructured(message, code) {
+    if (message.startsWith('Strict validation failed')) {
+        const lines = message
+            .split('\n')
+            .slice(1) // skip "Strict validation failed (N issues):" header
+            .filter(l => Boolean(l.trim()) && !l.startsWith('...'));
+        return lines.map(line => {
+            const colonIdx = line.indexOf(':');
+            const path = colonIdx > 0 ? line.slice(0, colonIdx).trim() : 'document';
+            const rest = colonIdx > 0 ? line.slice(colonIdx + 1).trim() : line.trim();
+            const suggMatch = rest.match(/did you mean "([^"]+)"/);
+            const suggestion = suggMatch ? suggMatch[1] : undefined;
+            const isUnknown = rest.includes('unknown property');
+            const unknownProp = isUnknown ? (/\.([^.[]+)$/.exec(path)?.[1] ?? path) : undefined;
+            return {
+                path,
+                message: rest,
+                code: 'UNKNOWN_PROPERTY',
+                severity: 'error',
+                ...(unknownProp !== undefined && { unknownProp }),
+                ...(suggestion !== undefined && { suggestion }),
+            };
+        });
+    }
+    const colonIdx = message.indexOf(':');
+    // A valid path (e.g. "content[0] (paragraph) spans[0].href") never contains ". " (period + space).
+    // Prose fragments like "margins.left must be a non-negative finite number. Got" do, so we reject them.
+    const candidate = message.slice(0, colonIdx).trim();
+    const hasPathPrefix = colonIdx > 0 && !/\. /.test(candidate);
+    const path = hasPathPrefix ? candidate : 'document';
+    const msgText = hasPathPrefix ? message.slice(colonIdx + 1).trim() : message;
+    return [{
+            path,
+            message: msgText,
+            code: code,
+            severity: 'error',
+        }];
+}
+//# sourceMappingURL=errors.js.map

package/dist/validate/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/validate/errors.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,OAAO,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;AACvE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,+BAA+B,CAAC,OAAe,EAAE,IAAY;IAC3E,IAAI,OAAO,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,OAAO;aAClB,KAAK,CAAC,IAAI,CAAC;aACX,KAAK,CAAC,CAAC,CAAC,CAAC,qDAAqD;aAC9D,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;QACzD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAA;YACvE,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;YACzE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;YACtD,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACvD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;YACnD,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACnF,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,kBAAkB;gBACxB,QAAQ,EAAE,OAAgB;gBAC1B,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;gBACjD,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;aAChD,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACrC,mGAAmG;IACnG,uGAAuG;IACvG,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;IACnD,MAAM,aAAa,GAAG,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC5D,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAA;IACnD,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;IAC5E,OAAO,CAAC;YACN,IAAI;YACJ,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,IAAiB;YACvB,QAAQ,EAAE,OAAgB;SAC3B,CAAC,CAAA;AACJ,CAAC"}

package/dist/validate/fonts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * validate/fonts.ts — Whole-document font reference validation.
+ * Extracted from src/validate.ts (#11a).
+ *
+ * Validates that every font family referenced anywhere in the document
+ * is either bundled (Inter) or present in doc.fonts. Catches problems early
+ * instead of silently falling back or dropping content.
+ */
+import type { PdfDocument } from '../types.js';
+export declare function validateFontReferences(doc: PdfDocument, loadedFamilies: Set<string>): void;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/validate/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/validate/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAI9C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAmI1F"}

package/dist/validate/fonts.js

@@ -0,0 +1,118 @@
+import { PretextPdfError } from '../errors.js';
+import { BUNDLED_VARIANTS } from './helpers.js';
+export function validateFontReferences(doc, loadedFamilies) {
+    const defaultFamily = doc.defaultFont ?? 'Inter';
+    // Build a variant-level set for italic checks: "Family-weight-style"
+    const loadedVariants = new Set(BUNDLED_VARIANTS);
+    for (const f of doc.fonts ?? []) {
+        loadedVariants.add(`${f.family}-${f.weight ?? 400}-${f.style ?? 'normal'}`);
+    }
+    const requireFamily = (family, context) => {
+        if (!/^[a-zA-Z0-9 ._+\-]+$/.test(family)) {
+            throw new PretextPdfError('VALIDATION_ERROR', `${context}: font family name "${family}" contains invalid characters. Use only letters, digits, spaces, hyphens, and underscores.`);
+        }
+        if (!loadedFamilies.has(family)) {
+            throw new PretextPdfError('FONT_NOT_LOADED', `${context}: font family '${family}' is not loaded. Add { family: '${family}', src: '/path/to.ttf' } to doc.fonts, or remove the fontFamily reference to use the default ('${defaultFamily}').`);
+        }
+    };
+    const requireVariant = (family, weight, style, context) => {
+        const key = `${family}-${weight}-${style}`;
+        if (!loadedVariants.has(key)) {
+            if (style === 'italic') {
+                throw new PretextPdfError('ITALIC_FONT_NOT_LOADED', `${context}: fontStyle 'italic' requires an italic font variant. Add { family: '${family}', weight: ${weight}, style: 'italic', src: '/path/to-italic.ttf' } to doc.fonts.`);
+            }
+            throw new PretextPdfError('FONT_NOT_LOADED', `${context}: font variant '${key}' is not loaded. Add a matching FontSpec to doc.fonts.`);
+        }
+    };
+    // 1. defaultFont must be loadable
+    requireFamily(defaultFamily, `doc.defaultFont '${defaultFamily}'`);
+    // 2. header / footer fontFamily + fontWeight variant
+    for (const [spec, label] of [[doc.header, 'doc.header'], [doc.footer, 'doc.footer']]) {
+        if (!spec)
+            continue;
+        if (spec.fontFamily)
+            requireFamily(spec.fontFamily, `${label}.fontFamily`);
+        if ((spec.fontWeight ?? 400) === 700) {
+            const family = spec.fontFamily ?? defaultFamily;
+            requireVariant(family, 700, 'normal', `${label} fontWeight:700`);
+        }
+    }
+    // 2b. watermark fontFamily (text watermark only)
+    if (doc.watermark?.text) {
+        if (doc.watermark.fontFamily)
+            requireFamily(doc.watermark.fontFamily, 'doc.watermark.fontFamily');
+        if ((doc.watermark.fontWeight ?? 400) === 700) {
+            const family = doc.watermark.fontFamily ?? defaultFamily;
+            requireVariant(family, 700, 'normal', 'doc.watermark fontWeight:700');
+        }
+    }
+    // 3. content elements
+    for (let i = 0; i < doc.content.length; i++) {
+        const el = doc.content[i];
+        const prefix = `content[${i}]`;
+        if (el.type === 'paragraph') {
+            if (el.fontFamily)
+                requireFamily(el.fontFamily, `${prefix} (paragraph).fontFamily`);
+            if ((el.fontWeight ?? 400) === 700) {
+                const family = el.fontFamily ?? defaultFamily;
+                requireVariant(family, 700, 'normal', `${prefix} (paragraph) fontWeight:700`);
+            }
+        }
+        if (el.type === 'heading') {
+            if (el.fontFamily)
+                requireFamily(el.fontFamily, `${prefix} (heading).fontFamily`);
+            const family = el.fontFamily ?? defaultFamily;
+            const weight = el.fontWeight ?? 700;
+            requireVariant(family, weight, 'normal', `${prefix} (heading) fontWeight:${weight}`);
+        }
+        if (el.type === 'list') {
+            for (let ii = 0; ii < el.items.length; ii++) {
+                const item = el.items[ii];
+                if ((item.fontWeight ?? 400) === 700) {
+                    requireVariant(defaultFamily, 700, 'normal', `${prefix} (list) items[${ii}] fontWeight:700`);
+                }
+            }
+        }
+        if (el.type === 'table') {
+            for (let ri = 0; ri < el.rows.length; ri++) {
+                for (let ci = 0; ci < el.rows[ri].cells.length; ci++) {
+                    const cell = el.rows[ri].cells[ci];
+                    if (cell.fontFamily)
+                        requireFamily(cell.fontFamily, `${prefix} (table) rows[${ri}].cells[${ci}].fontFamily`);
+                    if ((cell.fontWeight ?? 400) === 700) {
+                        const family = cell.fontFamily ?? defaultFamily;
+                        requireVariant(family, 700, 'normal', `${prefix} (table) rows[${ri}].cells[${ci}] fontWeight:700`);
+                    }
+                }
+            }
+        }
+        if (el.type === 'rich-paragraph') {
+            for (let si = 0; si < el.spans.length; si++) {
+                const span = el.spans[si];
+                const spanFamily = span.fontFamily ?? defaultFamily;
+                const spanWeight = span.fontWeight ?? 400;
+                const spanStyle = span.fontStyle ?? 'normal';
+                if (span.fontFamily)
+                    requireFamily(span.fontFamily, `${prefix} (rich-paragraph) spans[${si}].fontFamily`);
+                if (spanStyle === 'italic') {
+                    requireVariant(spanFamily, spanWeight, 'italic', `${prefix} (rich-paragraph) spans[${si}]`);
+                }
+            }
+        }
+        if (el.type === 'blockquote') {
+            if (el.fontFamily)
+                requireFamily(el.fontFamily, `${prefix} (blockquote).fontFamily`);
+            const family = el.fontFamily ?? defaultFamily;
+            const weight = el.fontWeight ?? 400;
+            const style = el.fontStyle ?? 'normal';
+            if (style === 'italic') {
+                requireVariant(family, weight, 'italic', `${prefix} (blockquote) fontStyle:italic`);
+            }
+            else if (weight === 700) {
+                requireVariant(family, 700, 'normal', `${prefix} (blockquote) fontWeight:700`);
+            }
+        }
+        // code.fontFamily already validated against loadedFamilies in validateElement
+    }
+}
+//# sourceMappingURL=fonts.js.map

package/dist/validate/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../src/validate/fonts.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,UAAU,sBAAsB,CAAC,GAAgB,EAAE,cAA2B;IAClF,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,IAAI,OAAO,CAAA;IAEhD,qEAAqE;IACrE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAA;IACxD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QAChC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAA;IAC7E,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,OAAe,EAAE,EAAE;QACxD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,eAAe,CACvB,kBAAkB,EAClB,GAAG,OAAO,uBAAuB,MAAM,4FAA4F,CACpI,CAAA;QACH,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CACvB,iBAAiB,EACjB,GAAG,OAAO,kBAAkB,MAAM,mCAAmC,MAAM,kGAAkG,aAAa,KAAK,CAChM,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,MAAiB,EAAE,KAA0B,EAAE,OAAe,EAAE,EAAE;QACxG,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,KAAK,EAAE,CAAA;QAC1C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvB,MAAM,IAAI,eAAe,CACvB,wBAAwB,EACxB,GAAG,OAAO,wEAAwE,MAAM,cAAc,MAAM,+DAA+D,CAC5K,CAAA;YACH,CAAC;YACD,MAAM,IAAI,eAAe,CACvB,iBAAiB,EACjB,GAAG,OAAO,mBAAmB,GAAG,wDAAwD,CACzF,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IAED,kCAAkC;IAClC,aAAa,CAAC,aAAa,EAAE,oBAAoB,aAAa,GAAG,CAAC,CAAA;IAElE,qDAAqD;IACrD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAU,EAAE,CAAC;QAC9F,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,IAAI,IAAI,CAAC,UAAU;YAAE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,aAAa,CAAC,CAAA;QAC1E,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,aAAa,CAAA;YAC/C,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,iBAAiB,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,IAAI,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,SAAS,CAAC,UAAU;YAAE,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE,0BAA0B,CAAC,CAAA;QACjG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,aAAa,CAAA;YACxD,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,8BAA8B,CAAC,CAAA;QACvE,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,CAAA;QAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAA;QAE9B,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC5B,IAAI,EAAE,CAAC,UAAU;gBAAE,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,MAAM,yBAAyB,CAAC,CAAA;YACnF,IAAI,CAAC,EAAE,CAAC,UAAU,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,IAAI,aAAa,CAAA;gBAC7C,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,6BAA6B,CAAC,CAAA;YAC/E,CAAC;QACH,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,EAAE,CAAC,UAAU;gBAAE,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,MAAM,uBAAuB,CAAC,CAAA;YACjF,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,IAAI,aAAa,CAAA;YAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,IAAI,GAAG,CAAA;YACnC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,yBAAyB,MAAM,EAAE,CAAC,CAAA;QACtF,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACvB,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAE,CAAA;gBAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;oBACrC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,EAAE,kBAAkB,CAAC,CAAA;gBAC9F,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACxB,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBAC3C,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;oBACtD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,KAAK,CAAC,EAAE,CAAE,CAAA;oBACpC,IAAI,IAAI,CAAC,UAAU;wBAAE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,iBAAiB,EAAE,WAAW,EAAE,cAAc,CAAC,CAAA;oBAC5G,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;wBACrC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,aAAa,CAAA;wBAC/C,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAA;oBACpG,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACjC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAE,CAAA;gBAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,aAAa,CAAA;gBACnD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAA;gBACzC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAA;gBAC5C,IAAI,IAAI,CAAC,UAAU;oBAAE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,2BAA2B,EAAE,cAAc,CAAC,CAAA;gBACzG,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAC3B,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,MAAM,2BAA2B,EAAE,GAAG,CAAC,CAAA;gBAC7F,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC7B,IAAI,EAAE,CAAC,UAAU;gBAAE,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,MAAM,0BAA0B,CAAC,CAAA;YACpF,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,IAAI,aAAa,CAAA;YAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,IAAI,GAAG,CAAA;YACnC,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,IAAI,QAAQ,CAAA;YACtC,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,gCAAgC,CAAC,CAAA;YACrF,CAAC;iBAAM,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC1B,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,8BAA8B,CAAC,CAAA;YAChF,CAAC;QACH,CAAC;QAED,8EAA8E;IAChF,CAAC;AACH,CAAC"}

package/dist/validate/helpers.d.ts

@@ -0,0 +1,76 @@
+/**
+ * validate/helpers.ts — Pure helpers + shared regex + ValidationContext type.
+ * Extracted from src/validate.ts during the v1.4.0 god-file split (#11a).
+ * No behavior changes — every error code, message, and order preserved.
+ */
+import type { FontSpec, RenderOptions } from '../types.js';
+export declare const MAX_VALIDATION_DEPTH = 32;
+/**
+ * ValidationContext — threaded through every element validator.
+ *
+ * Replaces the free-floating module-level closures that previously lived
+ * inside validate()'s function body. Created once at the top of validate()
+ * so concurrent validate() calls on a multi-document server cannot share
+ * state (see withCycleGuard docblock for the race-condition rationale).
+ */
+export interface ValidationContext {
+    /** Strict-mode accumulator for unknown-property errors */
+    errors: string[];
+    /** Whether strict validation is active for this call */
+    strict: boolean;
+    /** Loaded font families (bundled + doc.fonts), used by element validators */
+    loadedFamilies: Set<string>;
+    /** Per-call cycle-detection set — MUST NOT be shared across validate() calls */
+    seen: WeakSet<object>;
+    /** Original RenderOptions, used for plugin lookups in the default switch arm */
+    options?: RenderOptions | undefined;
+}
+/**
+ * Cycle/depth guard for recursive validation.
+ *
+ * The `seen` WeakSet MUST be created per top-level validate() call and threaded
+ * through the recursion. A module-scoped WeakSet would race under concurrent
+ * validate() calls on a multi-document server: two parallel calls touching the
+ * same node reference would see each other's "in progress" mark and throw a
+ * false-positive cyclic-reference error.
+ */
+export declare function withCycleGuard<T extends object>(seen: WeakSet<object>, node: T, depth: number, path: string, fn: () => void): void;
+/**
+ * Lightweight depth-only check used at the top of validateElement so the
+ * MAX_VALIDATION_DEPTH = 32 cap fires even when entering elements whose
+ * recursive validator does not itself open a withCycleGuard scope (e.g. an
+ * unrecognised plugin element). The full cycle/depth guard is still applied
+ * by the inner withCycleGuard calls for container elements.
+ */
+export declare function assertDepthOk(depth: number, path: string): void;
+/**
+ * RTL strong bidi characters — Bidi_Class=R or AL per UAX #9.
+ * See src/validate.ts (pre-split) for full block list. Range preserved bit-exact.
+ */
+export declare const RTL_REGEX: RegExp;
+/** Valid 6-digit hex color */
+export declare const HEX_COLOR_REGEX: RegExp;
+/** Allowed URL schemes for hyperlinks — blocks javascript:, data:, vbscript: */
+export declare const SAFE_URL_SCHEME: RegExp;
+/** BCP47 language tag pattern for hyphenation.language — prevents dynamic-import path injection */
+export declare const LANGUAGE_TAG_REGEX: RegExp;
+/** Valid column width: positive number OR '2*', '*', '1.5*' format */
+export declare const STAR_WIDTH_REGEX: RegExp;
+/** Families always available without explicit doc.fonts entry */
+export declare const BUNDLED_FAMILIES: Set<string>;
+/** Font variants (family-weight-style) always available without explicit doc.fonts entry */
+export declare const BUNDLED_VARIANTS: Set<string>;
+/** Accumulate unknown property errors for an object */
+export declare function assertUnknownProps(obj: unknown, allowed: Set<string>, path: string, errors: string[]): void;
+/** Format accumulated errors into a single message (cap at 20 errors) */
+export declare function formatErrors(errors: string[]): string;
+/** Returns true if the string looks like a URL (scheme://... or a known scheme prefix) */
+export declare function looksLikeUrl(src: string): boolean;
+/** Validate a hyperlink URL — throws VALIDATION_ERROR for unsafe schemes */
+export declare function validateUrl(url: string, prefix: string): void;
+/** Validate a metadata string field — rejects control chars and enforces length */
+export declare function validateMetadataString(value: string, fieldName: string): void;
+/** Validate a single FontSpec entry from doc.fonts */
+export declare function validateFontSpec(font: FontSpec): void;
+export type { RenderOptions };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/validate/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/validate/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,wDAAwD;IACxD,MAAM,EAAE,OAAO,CAAA;IACf,6EAA6E;IAC7E,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC3B,gFAAgF;IAChF,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACrB,gFAAgF;IAChF,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,IAAI,GACb,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAyJ,CAAA;AAE/K,8BAA8B;AAC9B,eAAO,MAAM,eAAe,QAAsB,CAAA;AAElD,gFAAgF;AAChF,eAAO,MAAM,eAAe,QAA4B,CAAA;AAExD,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,QAAwC,CAAA;AAEvE,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,QAAqB,CAAA;AAElD,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,aAAqB,CAAA;AAElD,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,aAA4F,CAAA;AAqCzH,uDAAuD;AACvD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAUN;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAMrD;AAOD,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO7D;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO7E;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAuBrD;AAGD,YAAY,EAAE,aAAa,EAAE,CAAA"}

package/dist/validate/helpers.js

@@ -0,0 +1,169 @@
+import { PretextPdfError } from '../errors.js';
+// ── Cycle Detection & Depth Guards ─────────────────────────────────────────
+export const MAX_VALIDATION_DEPTH = 32;
+/**
+ * Cycle/depth guard for recursive validation.
+ *
+ * The `seen` WeakSet MUST be created per top-level validate() call and threaded
+ * through the recursion. A module-scoped WeakSet would race under concurrent
+ * validate() calls on a multi-document server: two parallel calls touching the
+ * same node reference would see each other's "in progress" mark and throw a
+ * false-positive cyclic-reference error.
+ */
+export function withCycleGuard(seen, node, depth, path, fn) {
+    if (depth > MAX_VALIDATION_DEPTH) {
+        throw new PretextPdfError('VALIDATION_ERROR', `${path}: nesting depth exceeds ${MAX_VALIDATION_DEPTH}`);
+    }
+    if (seen.has(node)) {
+        throw new PretextPdfError('VALIDATION_ERROR', `${path}: cyclic reference detected`);
+    }
+    seen.add(node);
+    try {
+        fn();
+    }
+    finally {
+        seen.delete(node);
+    }
+}
+/**
+ * Lightweight depth-only check used at the top of validateElement so the
+ * MAX_VALIDATION_DEPTH = 32 cap fires even when entering elements whose
+ * recursive validator does not itself open a withCycleGuard scope (e.g. an
+ * unrecognised plugin element). The full cycle/depth guard is still applied
+ * by the inner withCycleGuard calls for container elements.
+ */
+export function assertDepthOk(depth, path) {
+    if (depth > MAX_VALIDATION_DEPTH) {
+        throw new PretextPdfError('VALIDATION_ERROR', `${path}: nesting depth exceeds ${MAX_VALIDATION_DEPTH}`);
+    }
+}
+/**
+ * RTL strong bidi characters — Bidi_Class=R or AL per UAX #9.
+ * See src/validate.ts (pre-split) for full block list. Range preserved bit-exact.
+ */
+export const RTL_REGEX = /[֐-ࣿיִ-ﭏﭐ-﷿ﹰ-\u{10800}-\u{10CFF}\u{10D00}-\u{10D3F}\u{10E80}-\u{10EFF}\u{10F30}-\u{10FFF}\u{1E800}-\u{1E95F}\u{1EC70}-\u{1ECBF}\u{1EE00}-\u{1EEFF}]/u;
+/** Valid 6-digit hex color */
+export const HEX_COLOR_REGEX = /^#[0-9A-Fa-f]{6}$/;
+/** Allowed URL schemes for hyperlinks — blocks javascript:, data:, vbscript: */
+export const SAFE_URL_SCHEME = /^(https?|mailto|ftp|#)/i;
+/** BCP47 language tag pattern for hyphenation.language — prevents dynamic-import path injection */
+export const LANGUAGE_TAG_REGEX = /^[a-zA-Z]{2,8}(-[a-zA-Z0-9]{2,8})*$/;
+/** Valid column width: positive number OR '2*', '*', '1.5*' format */
+export const STAR_WIDTH_REGEX = /^(\d*\.?\d+)?\*$/;
+/** Families always available without explicit doc.fonts entry */
+export const BUNDLED_FAMILIES = new Set(['Inter']);
+/** Font variants (family-weight-style) always available without explicit doc.fonts entry */
+export const BUNDLED_VARIANTS = new Set(['Inter-400-normal', 'Inter-700-normal', 'Inter-400-italic', 'Inter-700-italic']);
+/** Levenshtein distance, returns 999 if result would exceed 2 */
+function levenshteinDist(a, b) {
+    if (a === b)
+        return 0;
+    if (Math.abs(a.length - b.length) > 2)
+        return 999;
+    const m = a.length;
+    const n = b.length;
+    const prev = Array(n + 1)
+        .fill(0)
+        .map((_, j) => j);
+    const curr = Array(n + 1).fill(0);
+    for (let i = 1; i <= m; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+        }
+        for (let j = 0; j <= n; j++)
+            prev[j] = curr[j];
+    }
+    return prev[n] > 2 ? 999 : prev[n];
+}
+/** Find closest match with edit distance <= 2 */
+function closestMatch(prop, allowed) {
+    let best = null;
+    let bestDist = 999;
+    for (const candidate of allowed) {
+        const d = levenshteinDist(prop, candidate);
+        if (d > 0 && d <= 2 && d < bestDist) {
+            best = candidate;
+            bestDist = d;
+        }
+    }
+    return best;
+}
+/** Accumulate unknown property errors for an object */
+export function assertUnknownProps(obj, allowed, path, errors) {
+    // Type guard first — narrows `obj` to a non-null object below.
+    if (obj === null || typeof obj !== 'object' || Array.isArray(obj))
+        return;
+    for (const key of Object.keys(obj)) {
+        if (!allowed.has(key)) {
+            const suggestion = closestMatch(key, allowed);
+            const hint = suggestion ? `; did you mean "${suggestion}"` : '';
+            errors.push(`${path}.${key}: unknown property${hint}`);
+        }
+    }
+}
+/** Format accumulated errors into a single message (cap at 20 errors) */
+export function formatErrors(errors) {
+    if (errors.length === 0)
+        return '';
+    const header = `Strict validation failed (${errors.length} issue${errors.length === 1 ? '' : 's'}):\n`;
+    const msgs = errors.slice(0, 20);
+    const suffix = errors.length > 20 ? `\n... and ${errors.length - 20} more error(s)` : '';
+    return header + msgs.join('\n') + suffix;
+}
+// URL-shaped detection used by validators that accept either a file path
+// or a remote URL (image src, watermark image). Matches the runtime SSRF
+// guard's posture so validate-only callers catch unsafe schemes pre-render.
+const URL_LIKE_PREFIXES = ['data:', 'javascript:', 'vbscript:', 'blob:', 'about:', 'file:'];
+/** Returns true if the string looks like a URL (scheme://... or a known scheme prefix) */
+export function looksLikeUrl(src) {
+    const lc = src.toLowerCase();
+    if (URL_LIKE_PREFIXES.some(p => lc.startsWith(p)))
+        return true;
+    // Generic scheme test: any `scheme://...` form (http, https, ftp, gopher, …)
+    return /^[a-z][a-z0-9+.-]*:\/\//.test(lc);
+}
+/** Validate a hyperlink URL — throws VALIDATION_ERROR for unsafe schemes */
+export function validateUrl(url, prefix) {
+    if (!SAFE_URL_SCHEME.test(url)) {
+        throw new PretextPdfError('VALIDATION_ERROR', `${prefix}: URL scheme not allowed — only http, https, mailto, ftp, and anchor (#) links are permitted. Got: "${url.slice(0, 60)}"`);
+    }
+}
+/** Validate a metadata string field — rejects control chars and enforces length */
+export function validateMetadataString(value, fieldName) {
+    if (value.length > 1000) {
+        throw new PretextPdfError('VALIDATION_ERROR', `metadata.${fieldName} must not exceed 1000 characters`);
+    }
+    if (/[\x00\r\n]/.test(value)) {
+        throw new PretextPdfError('VALIDATION_ERROR', `metadata.${fieldName} must not contain null bytes or newline characters`);
+    }
+}
+/** Validate a single FontSpec entry from doc.fonts */
+export function validateFontSpec(font) {
+    if (!font.family || typeof font.family !== 'string') {
+        throw new PretextPdfError('VALIDATION_ERROR', `FontSpec: 'family' must be a non-empty string`);
+    }
+    if (font.weight !== undefined && ![400, 700].includes(font.weight)) {
+        throw new PretextPdfError('VALIDATION_ERROR', `FontSpec '${font.family}': 'weight' must be 400 or 700`);
+    }
+    if (font.style !== undefined && !['normal', 'italic'].includes(font.style)) {
+        throw new PretextPdfError('VALIDATION_ERROR', `FontSpec '${font.family}': 'style' must be 'normal' or 'italic'`);
+    }
+    if (font.src === undefined || font.src === null) {
+        throw new PretextPdfError('VALIDATION_ERROR', `FontSpec '${font.family}': 'src' is required (file path or Uint8Array)`);
+    }
+    // If src is a string, ensure it's not a dangerous URL — only 'bundled' or file paths allowed
+    if (typeof font.src === 'string' && font.src !== 'bundled') {
+        try {
+            const parsed = new URL(font.src);
+            throw new PretextPdfError('VALIDATION_ERROR', `FontSpec '${font.family}': 'src' contains a URL (${parsed.protocol}) — use 'bundled', a file path, or Uint8Array instead`);
+        }
+        catch (err) {
+            // new URL() throws if string is not a valid URL, which is expected for file paths
+            if (err instanceof PretextPdfError)
+                throw err;
+        }
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/validate/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/validate/helpers.ts"],"names":[],"mappings":"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"}

package/dist/validate/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * validate/index.ts — Orchestrator + public validate() / validateDocument().
+ *
+ * Top-level orchestration: plugin pre-flight, doc-shape guards, memory caps,
+ * ValidationContext construction, document-level check dispatch (delegated to
+ * ./document.ts), per-element dispatch (delegated to ./elements/*), footnote
+ * cross-validation, and the strict-error flush. Every error code/message is
+ * preserved bit-exact from the pre-split src/validate.ts.
+ *
+ * Extracted in v1.4.0 #11a — the original src/validate.ts was 1834 lines and
+ * is now a thin re-export barrel pointing here. In v1.5.0 item A the inline
+ * document-level checks (pageSize, margins, fonts, header/footer,
+ * defaultParagraphStyle, sections, watermark, encryption, signature,
+ * bookmarks, hyphenation, metadata) were extracted into ./document.ts.
+ */
+import type { PdfDocument, RenderOptions, ValidationResult, Logger } from '../types.js';
+/**
+ * Validate a PdfDocument and throw a {@link PretextPdfError} if any errors are found.
+ * @public
+ */
+export declare function validate(doc: PdfDocument, options?: RenderOptions): void;
+/**
+ * Validate a pretext-pdf document and return a structured result instead of throwing.
+ *
+ * Use this when you want to inspect all validation errors programmatically.
+ * The existing {@link validate} function throws on first error and is unchanged.
+ *
+ * @param doc - The document to validate (typed as `unknown` to accept unverified input)
+ * @param options - `{ strict?: boolean; logger?: Logger }` — strict defaults to false (matches render() behavior); logger routes diagnostic warnings away from console.warn
+ * @returns {@link ValidationResult} with `valid`, `errors[]`, and `errorCount`
+ * @public
+ */
+export declare function validateDocument(doc: unknown, options?: {
+    strict?: boolean;
+    logger?: Logger;
+}): ValidationResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/validate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EACV,WAAW,EAEX,aAAa,EACb,gBAAgB,EAChB,MAAM,EACP,MAAM,aAAa,CAAA;AA6CpB;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CA+HxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,gBAAgB,CAmBlB"}