open-agreements 0.1.0

package/dist/core/engine.js

@@ -0,0 +1,149 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadMetadata } from './metadata.js';
+import { prepareFillData, fillDocx } from './fill-pipeline.js';
+import { verifyTemplateFill } from './fill-utils.js';
+/**
+ * Compute display fields for radio/checkbox groups in table rows.
+ * docx-templates only allows one {IF} per table row, so multi-option rows
+ * use a single computed display tag that the engine populates from input fields.
+ *
+ * This is template-specific logic — only activates when metadata declares
+ * the relevant display field names.
+ */
+function computeDisplayFields(data, fieldNames) {
+    const str = (key) => String(data[key] ?? '');
+    const bool = (key) => data[key] === true;
+    // Order Date: "Date of last signature" or custom date
+    if (fieldNames.has('order_date_display') && !data['order_date_display']) {
+        data['order_date_display'] = bool('order_date_is_last_signature')
+            ? '( x )\tDate of last signature on this Order Form'
+            : `( x )\t${str('custom_order_date')}`;
+    }
+    // Pilot fee: paid or free trial
+    if (fieldNames.has('pilot_fee_display') && !data['pilot_fee_display']) {
+        data['pilot_fee_display'] = bool('pilot_is_free')
+            ? '( x )\tFree trial'
+            : `( x )\tFee for Pilot Period: ${str('pilot_fee')}`;
+    }
+    // Cloud Service Fees: build from selected checkboxes
+    if (fieldNames.has('fees_display') && !data['fees_display']) {
+        const lines = [];
+        if (bool('fee_is_per_unit')) {
+            lines.push(`[ x ] ${str('fees')} per ${str('fee_unit')}`);
+        }
+        if (bool('fee_is_other')) {
+            lines.push(`[ x ] Other fee structure: ${str('other_fee_structure')}`);
+        }
+        if (bool('fee_may_increase')) {
+            lines.push(`[ x ] Fees may increase up to ${str('fee_increase_cap_pct')}% per renewal`);
+        }
+        if (bool('fee_will_increase')) {
+            lines.push(`[ x ] Fees will increase ${str('fee_increase_fixed_pct')}% per renewal`);
+        }
+        if (bool('fee_inclusive_of_taxes')) {
+            lines.push('[ x ] Fees are inclusive of taxes (modifies Standard Terms Section 4.1)');
+        }
+        data['fees_display'] = lines.join('\n');
+    }
+    // Payment Process: invoice or automatic
+    if (fieldNames.has('payment_display') && !data['payment_display']) {
+        if (bool('payment_by_invoice')) {
+            const freq = str('payment_frequency');
+            const days = str('payment_terms_days');
+            const from = str('payment_due_from');
+            data['payment_display'] =
+                `( x )\tPay by invoice\n` +
+                    `Provider will invoice Customer ${freq}.\n` +
+                    `Customer will pay each invoice within ${days} days of ${from}.`;
+        }
+        else {
+            const freq = str('payment_frequency');
+            data['payment_display'] =
+                `( x )\tAutomatic payment\n` +
+                    `Customer authorizes Provider to charge the payment method on file ${freq}.`;
+        }
+    }
+    // Auto-renewal
+    if (fieldNames.has('auto_renewal_display') && !data['auto_renewal_display']) {
+        if (bool('auto_renew')) {
+            const days = str('non_renewal_notice_days');
+            data['auto_renewal_display'] =
+                `( x )\tNon-Renewal Notice Date is ${days} days before the end of the current Subscription Period.`;
+        }
+        else {
+            data['auto_renewal_display'] = '( x )\tThis Order does not automatically renew.';
+        }
+    }
+    // Effective Date
+    if (fieldNames.has('effective_date_display') && !data['effective_date_display']) {
+        data['effective_date_display'] = bool('effective_date_is_last_signature')
+            ? '( x )\tDate of last Cover Page signature'
+            : `( x )\t${str('custom_effective_date')}`;
+    }
+    // Covered Claims
+    if (fieldNames.has('covered_claims_display') && !data['covered_claims_display']) {
+        const lines = [];
+        if (bool('has_provider_covered_claims')) {
+            lines.push('[ x ] Provider Covered Claims: [Any action, proceeding, or claim that the Cloud Service, when used by Customer as permitted under the Agreement, infringes or misappropriates a third party\u2019s intellectual property rights.]');
+        }
+        if (bool('has_customer_covered_claims')) {
+            lines.push('[ x ] Customer Covered Claims: [Any action, proceeding, or claim that (1) the Customer Content, when used according to the Agreement, infringes or misappropriates a third party\u2019s intellectual property rights; or (2) results from the Customer\u2019s breach of Section 2.4.]');
+        }
+        data['covered_claims_display'] = lines.join('\n');
+    }
+    // General Cap Amount
+    if (fieldNames.has('general_cap_display') && !data['general_cap_display']) {
+        if (bool('general_cap_is_multiplier')) {
+            data['general_cap_display'] = `( x )\t${str('general_cap_multiplier')}x the Fees paid or payable by Customer in the 12 month period immediately preceding the claim`;
+        }
+        else if (bool('general_cap_is_dollar')) {
+            data['general_cap_display'] = `( x )\t$${str('general_cap_dollar')}`;
+        }
+        else if (bool('general_cap_is_greater_of')) {
+            data['general_cap_display'] = `( x )\tThe greater of $${str('general_cap_greater_dollar')} or ${str('general_cap_greater_multiplier')}x the Fees paid or payable by Customer in the 12 month period immediately preceding the claim`;
+        }
+    }
+}
+export async function fillTemplate(options) {
+    const { templateDir, values, outputPath } = options;
+    const metadata = loadMetadata(templateDir);
+    const fieldNames = new Set(metadata.fields.map((f) => f.name));
+    // Prepare data using shared pipeline (defaults, booleans, display fields)
+    const data = prepareFillData({
+        values,
+        fields: metadata.fields,
+        useBlankPlaceholder: false,
+        coerceBooleans: true,
+        computeDisplayFields: (d) => computeDisplayFields(d, fieldNames),
+    });
+    const templatePath = join(templateDir, 'template.docx');
+    const templateBuf = readFileSync(templatePath);
+    // Warn about unknown keys not in metadata
+    const unknownKeys = Object.keys(data).filter((k) => !fieldNames.has(k));
+    if (unknownKeys.length > 0) {
+        console.warn(`Warning: unknown field(s) not in metadata: ${unknownKeys.join(', ')}`);
+    }
+    // Fill document using shared pipeline (currency sanitization + createReport)
+    const output = await fillDocx({
+        templateBuffer: templateBuf,
+        data,
+        fixSmartQuotes: true,
+    });
+    writeFileSync(outputPath, output);
+    // Verify output — warnings only, does not throw
+    const verifyResult = verifyTemplateFill(outputPath);
+    if (!verifyResult.passed) {
+        const failures = verifyResult.checks
+            .filter((c) => !c.passed)
+            .map((c) => `${c.name}: ${c.details ?? 'failed'}`)
+            .join('; ');
+        console.warn(`Warning: verification issues: ${failures}`);
+    }
+    return {
+        outputPath,
+        metadata,
+        fieldsUsed: Object.keys(data),
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/core/engine.js.map

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

package/dist/core/external/index.d.ts

@@ -0,0 +1,8 @@
+import type { ExternalFillOptions, ExternalFillResult } from './types.js';
+/**
+ * Run the external fill pipeline: integrity check → clean → patch → fill → verify.
+ * Uses the local DOCX file from the external/ directory (never modifies the original).
+ */
+export declare function runExternalFill(options: ExternalFillOptions): Promise<ExternalFillResult>;
+export type { ExternalFillOptions, ExternalFillResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/external/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/external/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6F/F;AAED,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/external/index.js

@@ -0,0 +1,92 @@
+import { mkdtempSync, copyFileSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { createHash } from 'node:crypto';
+import { loadExternalMetadata, loadCleanConfig } from '../metadata.js';
+import { resolveExternalDir } from '../../utils/paths.js';
+import { cleanDocument } from '../recipe/cleaner.js';
+import { patchDocument } from '../recipe/patcher.js';
+import { verifyOutput } from '../recipe/verifier.js';
+import { prepareFillData, fillDocx } from '../fill-pipeline.js';
+/**
+ * Run the external fill pipeline: integrity check → clean → patch → fill → verify.
+ * Uses the local DOCX file from the external/ directory (never modifies the original).
+ */
+export async function runExternalFill(options) {
+    const { externalId, outputPath, values, keepIntermediate } = options;
+    const externalDir = resolveExternalDir(externalId);
+    const metadata = loadExternalMetadata(externalDir);
+    // SHA-256 integrity check
+    const docxPath = join(externalDir, 'template.docx');
+    const docxBuf = readFileSync(docxPath);
+    const actualHash = createHash('sha256').update(docxBuf).digest('hex');
+    if (actualHash !== metadata.source_sha256) {
+        throw new Error(`Integrity check failed for "${externalId}": DOCX has been modified.\n` +
+            `  Expected SHA-256: ${metadata.source_sha256}\n` +
+            `  Actual SHA-256:   ${actualHash}`);
+    }
+    // CC-BY-ND redistribution warning
+    console.log(`\nNote: This is an external document (${metadata.license}). ` +
+        `You may fill it for your own use, but do not redistribute modified versions.\n` +
+        `See: ${metadata.source_url}\n`);
+    // Load clean config and replacements
+    const cleanConfig = loadCleanConfig(externalDir);
+    const replacementsPath = join(externalDir, 'replacements.json');
+    const replacements = JSON.parse(readFileSync(replacementsPath, 'utf-8'));
+    // Create temp directory for intermediate files
+    const tempDir = mkdtempSync(join(tmpdir(), `external-${externalId}-`));
+    const stages = { clean: '', patch: '', fill: '' };
+    try {
+        // Copy source to temp dir
+        const sourcePath = join(tempDir, 'source.docx');
+        copyFileSync(docxPath, sourcePath);
+        // Stage 1: Clean
+        const cleanedPath = join(tempDir, 'cleaned.docx');
+        await cleanDocument(sourcePath, cleanedPath, cleanConfig);
+        stages.clean = cleanedPath;
+        // Stage 2: Patch (replace [brackets] with {template_tags})
+        const patchedPath = join(tempDir, 'patched.docx');
+        await patchDocument(cleanedPath, patchedPath, replacements);
+        stages.patch = patchedPath;
+        // Stage 3: Fill (render template tags with values)
+        const fillData = prepareFillData({
+            values,
+            fields: metadata.fields,
+            useBlankPlaceholder: true,
+        });
+        const filledPath = join(tempDir, 'filled.docx');
+        const templateBuf = readFileSync(patchedPath);
+        const filledBuf = await fillDocx({
+            templateBuffer: templateBuf,
+            data: fillData,
+        });
+        writeFileSync(filledPath, filledBuf);
+        stages.fill = filledPath;
+        // Stage 4: Verify
+        const verifyResult = await verifyOutput(filledPath, values, replacements, cleanConfig);
+        if (!verifyResult.passed) {
+            const failures = verifyResult.checks
+                .filter((c) => !c.passed)
+                .map((c) => `${c.name}: ${c.details ?? 'failed'}`)
+                .join('; ');
+            console.warn(`Warning: verification issues: ${failures}`);
+        }
+        // Copy final output to destination
+        copyFileSync(filledPath, outputPath);
+        if (keepIntermediate) {
+            console.log(`Intermediate files preserved at: ${tempDir}`);
+        }
+        return {
+            outputPath,
+            metadata,
+            fieldsUsed: Object.keys(values),
+            stages,
+        };
+    }
+    finally {
+        if (!keepIntermediate) {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/external/index.js.map

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

package/dist/core/external/types.d.ts

@@ -0,0 +1,18 @@
+import type { ExternalMetadata } from '../metadata.js';
+export interface ExternalFillOptions {
+    externalId: string;
+    outputPath: string;
+    values: Record<string, string>;
+    keepIntermediate?: boolean;
+}
+export interface ExternalFillResult {
+    outputPath: string;
+    metadata: ExternalMetadata;
+    fieldsUsed: string[];
+    stages: {
+        clean: string;
+        patch: string;
+        fill: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/external/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/external/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/core/external/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/external/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/external/types.ts"],"names":[],"mappings":""}

package/dist/core/fill-pipeline.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared fill pipeline used by all three fill paths (template, external, recipe).
+ * Centralizes: defaults, boolean coercion, display fields, currency sanitization,
+ * drafting note removal, and the docx-templates createReport() call.
+ */
+import type { FieldDefinition } from './metadata.js';
+export interface PrepareFillDataOptions {
+    /** User-provided values. */
+    values: Record<string, string | boolean>;
+    /** Field definitions from metadata. */
+    fields: FieldDefinition[];
+    /**
+     * When true, unfilled optional fields default to BLANK_PLACEHOLDER ('_______')
+     * so omissions are visible. When false, they default to '' (empty string).
+     * Recipes and external use true; templates use false.
+     */
+    useBlankPlaceholder?: boolean;
+    /** Coerce boolean-typed fields to actual JS booleans for IF conditions. */
+    coerceBooleans?: boolean;
+    /**
+     * Optional callback for computing display fields (template-specific).
+     * Called after defaults and boolean coercion are applied.
+     */
+    computeDisplayFields?: (data: Record<string, string | boolean>) => void;
+}
+export interface FillDocxOptions {
+    /** Template DOCX buffer (already patched with {tags}). */
+    templateBuffer: Buffer;
+    /** Prepared fill data from prepareFillData(). */
+    data: Record<string, string | boolean>;
+    /** Apply docx-templates smart quote normalization. */
+    fixSmartQuotes?: boolean;
+    /**
+     * Regex patterns for paragraphs to remove before filling.
+     * Paragraphs whose text matches any pattern are stripped from the DOCX.
+     * If a matched paragraph is the only content in a table row, the entire
+     * row is removed to avoid empty highlighted rows.
+     *
+     * Default: `[/\bDrafting note\b/i]` — removes Common Paper drafting notes.
+     * Pass `[]` to disable.
+     */
+    stripParagraphPatterns?: RegExp[];
+}
+/**
+ * Prepare fill data with all normalization steps:
+ * 1. Validate required fields are present
+ * 2. Apply defaults for optional fields not provided
+ * 3. Coerce boolean fields (optional)
+ * 4. Compute display fields (optional, template-specific)
+ */
+export declare function prepareFillData(options: PrepareFillDataOptions): Record<string, string | boolean>;
+/**
+ * Fill a DOCX template with prepared data:
+ * 1. Strip drafting note paragraphs (configurable, on by default)
+ * 2. Strip highlighting from runs with filled fields (unfilled keep their highlight)
+ * 3. Sanitize currency values by scanning the template buffer for ${field} patterns
+ * 4. Call docx-templates createReport() with standard delimiters
+ * 5. Return the filled buffer
+ */
+export declare function fillDocx(options: FillDocxOptions): Promise<Uint8Array>;
+//# sourceMappingURL=fill-pipeline.d.ts.map

package/dist/core/fill-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill-pipeline.d.ts","sourceRoot":"","sources":["../../src/core/fill-pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAEzC,uCAAuC;IACvC,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC;CACzE;AAED,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAEvC,sDAAsD;IACtD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAKD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CA2CjG;AAkND;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAmC5E"}

package/dist/core/fill-pipeline.js

@@ -0,0 +1,279 @@
+/**
+ * Shared fill pipeline used by all three fill paths (template, external, recipe).
+ * Centralizes: defaults, boolean coercion, display fields, currency sanitization,
+ * drafting note removal, and the docx-templates createReport() call.
+ */
+import AdmZip from 'adm-zip';
+import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
+import { createReport } from 'docx-templates';
+import { sanitizeCurrencyValuesFromDocx, BLANK_PLACEHOLDER } from './fill-utils.js';
+import { enumerateTextParts, getGeneralTextPartNames } from './recipe/ooxml-parts.js';
+const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
+/** Default patterns for paragraphs stripped before filling. */
+const DEFAULT_STRIP_PATTERNS = [/\bDrafting note\b/i];
+/**
+ * Prepare fill data with all normalization steps:
+ * 1. Validate required fields are present
+ * 2. Apply defaults for optional fields not provided
+ * 3. Coerce boolean fields (optional)
+ * 4. Compute display fields (optional, template-specific)
+ */
+export function prepareFillData(options) {
+    const { values, fields, useBlankPlaceholder = false, coerceBooleans = false, computeDisplayFields, } = options;
+    // Validate required fields
+    const missing = fields
+        .filter((f) => f.required && !(f.name in values))
+        .map((f) => f.name);
+    if (missing.length > 0) {
+        throw new Error(`Missing required fields: ${missing.join(', ')}`);
+    }
+    // Apply defaults for optional fields
+    const defaultValue = useBlankPlaceholder ? BLANK_PLACEHOLDER : '';
+    const data = { ...values };
+    for (const field of fields) {
+        if (!(field.name in data)) {
+            data[field.name] = field.default ?? defaultValue;
+        }
+    }
+    // Coerce boolean fields to actual JS booleans.
+    // docx-templates evaluates {IF field} in JS context where "false" is truthy.
+    if (coerceBooleans) {
+        for (const field of fields) {
+            if (field.type === 'boolean' && field.name in data) {
+                const v = data[field.name];
+                data[field.name] = v === true || v === 'true';
+            }
+        }
+    }
+    // Compute display fields (template-specific: radio/checkbox groups)
+    if (computeDisplayFields) {
+        computeDisplayFields(data);
+    }
+    return data;
+}
+/* eslint-disable @typescript-eslint/no-explicit-any --
+   @xmldom/xmldom types are incompatible with global DOM types */
+/**
+ * Extract paragraph text by concatenating all <w:t> elements.
+ */
+function extractParagraphText(para) {
+    if (!para.getElementsByTagNameNS)
+        return '';
+    const tElements = para.getElementsByTagNameNS(W_NS, 't');
+    const parts = [];
+    for (let i = 0; i < tElements.length; i++) {
+        parts.push(tElements[i].textContent ?? '');
+    }
+    return parts.join('').trim();
+}
+/**
+ * Check if a table row contains ONLY paragraphs that match the strip patterns
+ * (or are empty). If so, the entire row can be safely removed.
+ */
+function isRowOnlyDraftingNotes(tr, patterns) {
+    const paras = tr.getElementsByTagNameNS(W_NS, 'p');
+    if (paras.length === 0)
+        return false;
+    for (let i = 0; i < paras.length; i++) {
+        const text = extractParagraphText(paras[i]);
+        if (text === '')
+            continue; // empty paragraphs are fine to remove
+        if (!patterns.some((r) => r.test(text)))
+            return false; // non-matching content
+    }
+    return true;
+}
+/**
+ * Remove paragraphs matching the given patterns from a DOCX buffer.
+ * If a matched paragraph is the sole content of a table row, the entire
+ * row is removed (avoids empty highlighted rows in Common Paper docs).
+ *
+ * Returns a new DOCX buffer with the paragraphs removed.
+ */
+function stripParagraphs(docxBuffer, patterns) {
+    if (patterns.length === 0)
+        return docxBuffer;
+    const zip = new AdmZip(docxBuffer);
+    const parser = new DOMParser();
+    const serializer = new XMLSerializer();
+    const parts = enumerateTextParts(zip);
+    const partNames = getGeneralTextPartNames(parts);
+    let modified = false;
+    for (const partName of partNames) {
+        const entry = zip.getEntry(partName);
+        if (!entry)
+            continue;
+        const xml = entry.getData().toString('utf-8');
+        const doc = parser.parseFromString(xml, 'text/xml');
+        // Collect table rows to remove (whole row when only drafting notes)
+        const rowsToRemove = new Set();
+        // Collect standalone paragraphs to remove
+        const parasToRemove = [];
+        const allParagraphs = doc.getElementsByTagNameNS(W_NS, 'p');
+        for (let i = 0; i < allParagraphs.length; i++) {
+            const para = allParagraphs[i];
+            const text = extractParagraphText(para);
+            if (!text || !patterns.some((r) => r.test(text)))
+                continue;
+            // Walk up to find if this is inside a table cell
+            let node = para.parentNode;
+            let inTableCell = false;
+            let tableRow = null;
+            while (node) {
+                if (node.localName === 'tc' && node.namespaceURI === W_NS) {
+                    inTableCell = true;
+                }
+                if (node.localName === 'tr' && node.namespaceURI === W_NS) {
+                    tableRow = node;
+                    break;
+                }
+                node = node.parentNode;
+            }
+            if (inTableCell && tableRow && isRowOnlyDraftingNotes(tableRow, patterns)) {
+                rowsToRemove.add(tableRow);
+            }
+            else {
+                parasToRemove.push(para);
+            }
+        }
+        if (rowsToRemove.size > 0 || parasToRemove.length > 0) {
+            modified = true;
+            for (const row of rowsToRemove) {
+                row.parentNode?.removeChild(row);
+            }
+            for (const para of parasToRemove) {
+                para.parentNode?.removeChild(para);
+            }
+            // Update the zip entry
+            const outXml = serializer.serializeToString(doc);
+            zip.updateFile(partName, Buffer.from(outXml, 'utf-8'));
+        }
+    }
+    if (!modified)
+        return docxBuffer;
+    // Rebuild the zip from scratch (adm-zip data descriptor workaround)
+    const outZip = new AdmZip();
+    for (const entry of zip.getEntries()) {
+        outZip.addFile(entry.entryName, entry.getData());
+    }
+    return outZip.toBuffer();
+}
+/**
+ * Extract all text from a run (<w:r>) by concatenating its <w:t> elements.
+ */
+function extractRunText(run) {
+    const tElements = run.getElementsByTagNameNS(W_NS, 't');
+    const parts = [];
+    for (let i = 0; i < tElements.length; i++) {
+        parts.push(tElements[i].textContent ?? '');
+    }
+    return parts.join('');
+}
+/**
+ * Remove <w:highlight> elements only from runs whose template tags
+ * are being filled with non-empty values. Unfilled fields keep their
+ * yellow highlighting so users can see what still needs attention.
+ *
+ * Works by finding runs containing {field_name} tags, checking whether
+ * the corresponding field has a non-empty value in the data, and only
+ * stripping the highlight if it does.
+ */
+function stripFilledHighlighting(docxBuffer, filledFields) {
+    if (filledFields.size === 0)
+        return docxBuffer;
+    const zip = new AdmZip(docxBuffer);
+    const parser = new DOMParser();
+    const serializer = new XMLSerializer();
+    const parts = enumerateTextParts(zip);
+    const partNames = getGeneralTextPartNames(parts);
+    // Match {field_name} but not {IF ...} or {END-IF ...} etc.
+    const tagPattern = /\{(\w+)\}/g;
+    let modified = false;
+    for (const partName of partNames) {
+        const entry = zip.getEntry(partName);
+        if (!entry)
+            continue;
+        const xml = entry.getData().toString('utf-8');
+        const doc = parser.parseFromString(xml, 'text/xml');
+        const allRuns = doc.getElementsByTagNameNS(W_NS, 'r');
+        const toRemove = [];
+        for (let i = 0; i < allRuns.length; i++) {
+            const run = allRuns[i];
+            const rPr = run.getElementsByTagNameNS(W_NS, 'rPr');
+            if (rPr.length === 0)
+                continue;
+            const highlights = rPr[0].getElementsByTagNameNS(W_NS, 'highlight');
+            if (highlights.length === 0)
+                continue;
+            // Check if this run's text contains a tag for a filled field
+            const runText = extractRunText(run);
+            let hasFilled = false;
+            let match;
+            tagPattern.lastIndex = 0;
+            while ((match = tagPattern.exec(runText)) !== null) {
+                if (filledFields.has(match[1])) {
+                    hasFilled = true;
+                    break;
+                }
+            }
+            if (hasFilled) {
+                for (let j = 0; j < highlights.length; j++) {
+                    toRemove.push(highlights[j]);
+                }
+            }
+        }
+        if (toRemove.length > 0) {
+            modified = true;
+            for (const el of toRemove) {
+                el.parentNode?.removeChild(el);
+            }
+            const outXml = serializer.serializeToString(doc);
+            zip.updateFile(partName, Buffer.from(outXml, 'utf-8'));
+        }
+    }
+    if (!modified)
+        return docxBuffer;
+    const outZip = new AdmZip();
+    for (const entry of zip.getEntries()) {
+        outZip.addFile(entry.entryName, entry.getData());
+    }
+    return outZip.toBuffer();
+}
+/**
+ * Fill a DOCX template with prepared data:
+ * 1. Strip drafting note paragraphs (configurable, on by default)
+ * 2. Strip highlighting from runs with filled fields (unfilled keep their highlight)
+ * 3. Sanitize currency values by scanning the template buffer for ${field} patterns
+ * 4. Call docx-templates createReport() with standard delimiters
+ * 5. Return the filled buffer
+ */
+export async function fillDocx(options) {
+    const { data, fixSmartQuotes = false, stripParagraphPatterns = DEFAULT_STRIP_PATTERNS, } = options;
+    let { templateBuffer } = options;
+    // Step 1: Strip drafting notes (and other configured patterns)
+    if (stripParagraphPatterns.length > 0) {
+        templateBuffer = stripParagraphs(templateBuffer, stripParagraphPatterns);
+    }
+    // Step 2: Strip highlighting only from fields that have non-empty values.
+    // Unfilled fields keep their yellow highlight as a visual cue.
+    const filledFields = new Set();
+    for (const [key, val] of Object.entries(data)) {
+        if (typeof val === 'string' && val !== '' && val !== BLANK_PLACEHOLDER) {
+            filledFields.add(key);
+        }
+        else if (typeof val === 'boolean') {
+            filledFields.add(key); // booleans are always "filled"
+        }
+    }
+    templateBuffer = stripFilledHighlighting(templateBuffer, filledFields);
+    // Step 3: Strip leading $ from values where the template has ${ before the tag
+    const sanitizedData = sanitizeCurrencyValuesFromDocx(data, templateBuffer);
+    // Step 4: Fill template
+    return createReport({
+        template: templateBuffer,
+        data: sanitizedData,
+        cmdDelimiter: ['{', '}'],
+        fixSmartQuotes,
+    });
+}
+//# sourceMappingURL=fill-pipeline.js.map