pretext-pdf 1.1.1 → 1.7.0

package/dist/validate/index.js

@@ -0,0 +1,279 @@
+import { PretextPdfError } from '../errors.js';
+import { ALLOWED_PROPS, ALLOWED_PROPS_SUB } from '../allowed-props.js';
+import { ELEMENT_TYPES } from '../element-types.js';
+import { findPlugin, runPluginValidate } from '../plugin-registry.js';
+import { BUNDLED_FAMILIES, assertDepthOk, assertUnknownProps, formatErrors, } from './helpers.js';
+import { validateDocumentLevel } from './document.js';
+import { validateFontReferences } from './fonts.js';
+import { isValidPdfDocumentLike, parseValidationErrorsStructured } from './errors.js';
+import { validateParagraph, validateHeading, validateRichParagraph, validateBlockquote, validateCallout, validateCode, } from './elements/text.js';
+import { validateTable } from './elements/table.js';
+import { validateList } from './elements/list.js';
+import { validateImage, validateSvg, validateQrCode, validateBarcode, validateChart, } from './elements/media.js';
+import { validateSpacer, validateHr, validateToc, validateComment, } from './elements/structural-simple.js';
+import { validateFormField, validateFootnoteDef, validateFloatGroup, } from './elements/forms-floats.js';
+/**
+ * Validate a PdfDocument and throw a {@link PretextPdfError} if any errors are found.
+ * @public
+ */
+export function validate(doc, options) {
+    const strict = options?.strict ?? false;
+    const errors = [];
+    // Plugin pre-flight: enforce type string safety and no collision with built-ins
+    for (const plugin of options?.plugins ?? []) {
+        if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(plugin.type)) {
+            throw new PretextPdfError('VALIDATION_ERROR', `Plugin type '${plugin.type}' is invalid. Must start with a letter and contain only letters, digits, hyphens, or underscores.`);
+        }
+        if (ELEMENT_TYPES.includes(plugin.type)) {
+            throw new PretextPdfError('VALIDATION_ERROR', `Plugin type '${plugin.type}' collides with a built-in element type. Choose a different type string.`);
+        }
+    }
+    // Strict: check doc-level properties
+    if (strict) {
+        assertUnknownProps(doc, ALLOWED_PROPS_SUB['document'], 'doc', errors);
+    }
+    // content must be a non-empty array
+    if (!Array.isArray(doc.content) || doc.content.length === 0) {
+        throw new PretextPdfError('VALIDATION_ERROR', 'document.content must be a non-empty array');
+    }
+    // memory guard
+    if (doc.content.length > 50_000) {
+        throw new PretextPdfError('VALIDATION_ERROR', `document.content has ${doc.content.length} elements (hard limit: 50,000). Split into multiple documents.`);
+    }
+    if (doc.content.length > 10_000) {
+        ;
+        (options?.logger?.warn ?? console.warn)(`[pretext-pdf] Performance advisory: document.content has ${doc.content.length} elements (recommended max: 10,000). Large documents may be slow.`);
+    }
+    // Document-level checks (pageSize, margins, fonts, header/footer,
+    // defaultParagraphStyle, sections, watermark, encryption, signature,
+    // bookmarks, hyphenation, metadata). Extracted to validate/document.ts in
+    // v1.5.0 item A; order, error codes, and messages preserved bit-exact.
+    // The ctx is constructed early so doc-level checks share the same errors[]
+    // accumulator and strict flag used by element validators below.
+    const loadedFamilies = new Set();
+    const seen = new WeakSet();
+    const ctx = {
+        errors,
+        strict,
+        loadedFamilies,
+        seen,
+        options,
+    };
+    validateDocumentLevel(doc, ctx);
+    // validate each content element
+    // Populate loadedFamilies AFTER document-level checks succeed (validateFontSpec
+    // would have thrown above on any invalid font.family). Element validators
+    // and validateFontReferences both read from this Set via ctx.
+    for (const family of BUNDLED_FAMILIES)
+        loadedFamilies.add(family);
+    for (const f of doc.fonts ?? [])
+        loadedFamilies.add(f.family);
+    // Check for duplicate form field names
+    const formFieldNames = new Set();
+    for (const el of doc.content) {
+        if (el.type === 'form-field') {
+            if (formFieldNames.has(el.name)) {
+                throw new PretextPdfError('FORM_FIELD_NAME_DUPLICATE', `Duplicate form field name: "${el.name}". Each form field must have a unique name.`);
+            }
+            formFieldNames.add(el.name);
+        }
+    }
+    // ctx (with errors/strict/loadedFamilies/seen/options) was constructed
+    // above so document-level checks and element validators share the same
+    // ValidationContext. The per-call `seen` WeakSet keeps concurrent
+    // validate() calls isolated on multi-document servers (see withCycleGuard
+    // docblock for the race-condition rationale).
+    for (let i = 0; i < doc.content.length; i++) {
+        validateElement(doc.content[i], i, 0, ctx);
+    }
+    // ── Footnote ref/def cross-validation ─────────────────────────────────────
+    const footnoteDefIds = new Map(); // id → content index
+    const footnoteRefIds = new Set();
+    // Collect all def ids
+    for (let i = 0; i < doc.content.length; i++) {
+        const el = doc.content[i];
+        if (el.type === 'footnote-def') {
+            if (footnoteDefIds.has(el.id)) {
+                throw new PretextPdfError('FOOTNOTE_DEF_DUPLICATE', `content[${i}] (footnote-def): duplicate id "${el.id}". Each footnote must have a unique id.`);
+            }
+            footnoteDefIds.set(el.id, i);
+        }
+    }
+    // Collect all ref ids from rich-paragraph spans
+    for (const el of doc.content) {
+        if (el.type === 'rich-paragraph') {
+            for (const span of el.spans) {
+                if (span.footnoteRef) {
+                    footnoteRefIds.add(span.footnoteRef);
+                }
+            }
+        }
+    }
+    // Orphaned ref: ref id with no matching def
+    for (const refId of footnoteRefIds) {
+        if (!footnoteDefIds.has(refId)) {
+            throw new PretextPdfError('FOOTNOTE_REF_ORPHANED', `A rich-paragraph span references footnote id "${refId}" but no footnote-def with that id exists in doc.content.`);
+        }
+    }
+    // Orphaned def: def id never referenced
+    for (const [defId] of footnoteDefIds) {
+        if (!footnoteRefIds.has(defId)) {
+            throw new PretextPdfError('FOOTNOTE_DEF_ORPHANED', `footnote-def "${defId}" is defined but never referenced by any rich-paragraph span.`);
+        }
+    }
+    // validate all font references are loadable
+    validateFontReferences(doc, loadedFamilies);
+    // Throw collected strict validation errors
+    if (errors.length > 0) {
+        const msg = formatErrors(errors);
+        throw new PretextPdfError('VALIDATION_ERROR', msg);
+    }
+}
+/**
+ * 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 function validateDocument(doc, options) {
+    if (!isValidPdfDocumentLike(doc)) {
+        return { valid: false, errors: [{ path: 'document', message: 'Document must be a non-null object', severity: 'error', code: 'VALIDATION_ERROR' }], errorCount: 1, warningCount: 0 };
+    }
+    try {
+        validate(doc, { strict: options?.strict ?? false, ...(options?.logger !== undefined ? { logger: options.logger } : {}) });
+        return { valid: true, errors: [], errorCount: 0, warningCount: 0 };
+    }
+    catch (err) {
+        if (err instanceof PretextPdfError) {
+            const errors = parseValidationErrorsStructured(err.message, err.code);
+            const warnings = errors.filter((e) => e.severity === 'warning');
+            const warningCount = warnings.length;
+            const headerMatch = err.message.match(/^Strict validation failed \((\d+) issue/);
+            const errorCount = headerMatch?.[1] != null ? parseInt(headerMatch[1], 10) : errors.filter((e) => e.severity === 'error').length;
+            return { valid: false, errors, errorCount, warningCount };
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        return { valid: false, errors: [{ path: 'document', message: `Unexpected validation error: ${msg}`, severity: 'error', code: 'VALIDATION_ERROR' }], errorCount: 1, warningCount: 0 };
+    }
+}
+/**
+ * Element-level dispatch. Order of checks (depth guard → type check → toc-entry
+ * rejection → cycle guard → strict-props → switch) is preserved bit-exact from
+ * the pre-split implementation.
+ */
+function validateElement(el, index, depth, ctx) {
+    const prefix = `content[${index}]`;
+    // Depth cap: fires before any per-type logic runs, including for plugin
+    // elements that do not open their own withCycleGuard scope.
+    assertDepthOk(depth, prefix);
+    if (!el || typeof el !== 'object' || !('type' in el)) {
+        throw new PretextPdfError('VALIDATION_ERROR', `${prefix}: each element must have a 'type' field`);
+    }
+    // Reject the internal TOC entry type before normal element handling.
+    // TocEntryElement is synthesized internally during the measurement pass and
+    // is not part of the public ContentElement union, so users must not supply it.
+    if (el.type === 'toc-entry') {
+        throw new PretextPdfError('VALIDATION_ERROR', `${prefix}: 'toc-entry' is an internal type and cannot be used in document content`);
+    }
+    // Cycle guard is owned by the per-type validators (validateList opens its
+    // own withCycleGuard scope at the top of list.ts, validateFloatGroup does
+    // the same in forms-floats.ts). An outer guard here would run a no-op body
+    // and finally-delete the element from `seen` BEFORE the inner guard adds
+    // it, so it never actually protected anything. Removed in v1.4.1 (M1).
+    // Strict: check element properties match allowed set for type
+    if (ctx.strict) {
+        const allowed = ALLOWED_PROPS[el.type];
+        if (allowed) {
+            assertUnknownProps(el, allowed, prefix, ctx.errors);
+        }
+    }
+    switch (el.type) {
+        case 'paragraph':
+            validateParagraph(el, prefix, ctx);
+            break;
+        case 'heading':
+            validateHeading(el, prefix, ctx);
+            break;
+        case 'spacer':
+            validateSpacer(el, prefix, ctx);
+            break;
+        case 'table':
+            validateTable(el, prefix, depth, ctx);
+            break;
+        case 'image':
+            validateImage(el, prefix, ctx);
+            break;
+        case 'svg':
+            validateSvg(el, prefix, ctx);
+            break;
+        case 'qr-code':
+            validateQrCode(el, prefix, ctx);
+            break;
+        case 'barcode':
+            validateBarcode(el, prefix, ctx);
+            break;
+        case 'chart':
+            validateChart(el, prefix, ctx);
+            break;
+        case 'list':
+            validateList(el, prefix, depth, ctx);
+            break;
+        case 'hr':
+            validateHr(el, prefix, ctx);
+            break;
+        case 'page-break': /* no fields to validate */ break;
+        case 'rich-paragraph':
+            validateRichParagraph(el, prefix, depth, ctx);
+            break;
+        case 'code':
+            validateCode(el, prefix, ctx);
+            break;
+        case 'blockquote':
+            validateBlockquote(el, prefix, ctx);
+            break;
+        case 'callout':
+            validateCallout(el, prefix, ctx);
+            break;
+        case 'toc':
+            validateToc(el, prefix, ctx);
+            break;
+        case 'comment':
+            validateComment(el, prefix, ctx);
+            break;
+        case 'form-field':
+            validateFormField(el, prefix, ctx);
+            break;
+        case 'footnote-def':
+            validateFootnoteDef(el, prefix, ctx);
+            break;
+        case 'float-group':
+            validateFloatGroup(el, prefix, depth, ctx);
+            break;
+        default: {
+            const type = el.type;
+            const plugins = ctx.options?.plugins ?? [];
+            const plugin = findPlugin(plugins, String(type));
+            if (plugin) {
+                let rejection;
+                try {
+                    rejection = runPluginValidate(plugin, el);
+                }
+                catch (err) {
+                    throw new PretextPdfError('VALIDATION_ERROR', `${prefix} (${String(type)}): plugin validate hook threw: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                if (rejection) {
+                    throw new PretextPdfError('VALIDATION_ERROR', `${prefix} (${String(type)}): ${rejection}`);
+                }
+                break;
+            }
+            const validList = ELEMENT_TYPES.map(t => `'${t}'`).join(', ');
+            throw new PretextPdfError('VALIDATION_ERROR', `${prefix}: unknown element type '${String(type)}'. Valid types: ${validList}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/validate/index.js.map

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

package/dist/validate.d.ts

@@ -1,22 +1,10 @@
-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.
+ * src/validate.ts — legacy shim, re-exports the new validate/ module.
  *
- * @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
+ * Original (1834L) was split into validate/{index,helpers,fonts,errors}.ts +
+ * validate/elements/* in v1.4.0 #11a. This shim exists for one release so
+ * external callers importing from 'pretext-pdf/dist/validate.js' (or the
+ * source path) continue to work; it will be deleted in step 3 of the split.
  */
-export declare function validateDocument(doc: unknown, options?: {
-    strict?: boolean;
-    logger?: Logger;
-}): ValidationResult;
+export * from './validate/index.js';
 //# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA4C,aAAa,EAAmB,gBAAgB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AA6IjJ;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAwXxE;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,CAgBlB"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,qBAAqB,CAAA"}