open-agreements 0.1.0

package/dist/core/metadata.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+export const LicenseEnum = z.enum(['CC-BY-4.0', 'CC0-1.0', 'CC-BY-ND-4.0']);
+export const FieldDefinitionSchema = z.object({
+    name: z.string(),
+    type: z.enum(['string', 'date', 'number', 'boolean', 'enum']),
+    description: z.string(),
+    required: z.boolean(),
+    default: z.string().optional(),
+    options: z.array(z.string()).optional(),
+    section: z.string().optional(),
+}).refine((f) => f.type !== 'enum' || (f.options !== undefined && f.options.length > 0), { message: 'Fields with type "enum" must have a non-empty options array' }).refine((f) => {
+    if (f.default === undefined)
+        return true;
+    if (f.type === 'number')
+        return !isNaN(Number(f.default));
+    if (f.type === 'boolean')
+        return f.default === 'true' || f.default === 'false';
+    return true;
+}, { message: 'Default value must be valid for the declared field type' });
+export const TemplateMetadataSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    source_url: z.string().url(),
+    version: z.string(),
+    license: LicenseEnum,
+    allow_derivatives: z.boolean(),
+    attribution_text: z.string(),
+    fields: z.array(FieldDefinitionSchema),
+});
+// --- External template schemas ---
+export const ExternalMetadataSchema = TemplateMetadataSchema.extend({
+    source_sha256: z.string(),
+});
+// --- Recipe schemas ---
+export const CleanConfigSchema = z.object({
+    removeFootnotes: z.boolean().default(false),
+    removeParagraphPatterns: z.array(z.string()).default([]),
+});
+export const RecipeMetadataSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    source_url: z.string().url(),
+    source_version: z.string(),
+    license_note: z.string(),
+    optional: z.boolean().default(false),
+    source_sha256: z.string().optional(),
+    fields: z.array(FieldDefinitionSchema).default([]),
+});
+// --- Template loaders ---
+export function loadMetadata(templateDir) {
+    const metadataPath = join(templateDir, 'metadata.yaml');
+    const raw = readFileSync(metadataPath, 'utf-8');
+    const parsed = yaml.load(raw);
+    return TemplateMetadataSchema.parse(parsed);
+}
+export function validateMetadata(templateDir) {
+    try {
+        loadMetadata(templateDir);
+        return { valid: true, errors: [] };
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            return {
+                valid: false,
+                errors: err.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+            };
+        }
+        return { valid: false, errors: [err.message] };
+    }
+}
+// --- External template loaders ---
+export function loadExternalMetadata(externalDir) {
+    const metadataPath = join(externalDir, 'metadata.yaml');
+    const raw = readFileSync(metadataPath, 'utf-8');
+    const parsed = yaml.load(raw);
+    return ExternalMetadataSchema.parse(parsed);
+}
+export function validateExternalMetadata(externalDir) {
+    try {
+        loadExternalMetadata(externalDir);
+        return { valid: true, errors: [] };
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            return {
+                valid: false,
+                errors: err.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+            };
+        }
+        return { valid: false, errors: [err.message] };
+    }
+}
+// --- Recipe loaders ---
+export function loadRecipeMetadata(recipeDir) {
+    const metadataPath = join(recipeDir, 'metadata.yaml');
+    const raw = readFileSync(metadataPath, 'utf-8');
+    const parsed = yaml.load(raw);
+    return RecipeMetadataSchema.parse(parsed);
+}
+export function loadCleanConfig(recipeDir) {
+    const cleanPath = join(recipeDir, 'clean.json');
+    if (!existsSync(cleanPath)) {
+        return { removeFootnotes: false, removeParagraphPatterns: [] };
+    }
+    const raw = readFileSync(cleanPath, 'utf-8');
+    return CleanConfigSchema.parse(JSON.parse(raw));
+}
+export function validateRecipeMetadata(recipeDir) {
+    try {
+        loadRecipeMetadata(recipeDir);
+        return { valid: true, errors: [] };
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            return {
+                valid: false,
+                errors: err.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+            };
+        }
+        return { valid: false, errors: [err.message] };
+    }
+}
+//# sourceMappingURL=metadata.js.map

package/dist/core/metadata.js.map

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

package/dist/core/recipe/cleaner.d.ts

@@ -0,0 +1,13 @@
+import type { CleanConfig } from '../metadata.js';
+/**
+ * Clean a DOCX document by removing footnotes and pattern-matched paragraphs.
+ * Operates at the OOXML level to preserve formatting of retained content.
+ *
+ * Processes all general OOXML text parts (document, headers, footers, endnotes).
+ * Footnotes.xml is handled separately with its separator/continuationSeparator logic.
+ *
+ * Note: Internal helpers use `any` for DOM nodes because @xmldom/xmldom's types
+ * are incompatible with the global DOM types (missing EventTarget methods).
+ */
+export declare function cleanDocument(inputPath: string, outputPath: string, config: CleanConfig): Promise<string>;
+//# sourceMappingURL=cleaner.d.ts.map

package/dist/core/recipe/cleaner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleaner.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/cleaner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/core/recipe/cleaner.js

@@ -0,0 +1,106 @@
+import AdmZip from 'adm-zip';
+import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
+import { enumerateTextParts, getGeneralTextPartNames } from './ooxml-parts.js';
+const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
+/**
+ * Clean a DOCX document by removing footnotes and pattern-matched paragraphs.
+ * Operates at the OOXML level to preserve formatting of retained content.
+ *
+ * Processes all general OOXML text parts (document, headers, footers, endnotes).
+ * Footnotes.xml is handled separately with its separator/continuationSeparator logic.
+ *
+ * Note: Internal helpers use `any` for DOM nodes because @xmldom/xmldom's types
+ * are incompatible with the global DOM types (missing EventTarget methods).
+ */
+export async function cleanDocument(inputPath, outputPath, config) {
+    const zip = new AdmZip(inputPath);
+    const parser = new DOMParser();
+    const serializer = new XMLSerializer();
+    const parts = enumerateTextParts(zip);
+    const generalParts = getGeneralTextPartNames(parts);
+    // Clean all general text parts (document, headers, footers, endnotes)
+    for (const partName of generalParts) {
+        const entry = zip.getEntry(partName);
+        if (!entry)
+            continue;
+        const xml = entry.getData().toString('utf-8');
+        const doc = parser.parseFromString(xml, 'text/xml');
+        if (config.removeFootnotes) {
+            removeFootnoteReferences(doc);
+        }
+        if (config.removeParagraphPatterns.length > 0) {
+            removeParagraphsByPattern(doc, config.removeParagraphPatterns);
+        }
+        zip.updateFile(partName, Buffer.from(serializer.serializeToString(doc), 'utf-8'));
+    }
+    // Clean footnotes.xml separately (has separator/continuationSeparator logic)
+    if (config.removeFootnotes && parts.footnotes) {
+        const footnotesEntry = zip.getEntry(parts.footnotes);
+        if (footnotesEntry) {
+            const xml = footnotesEntry.getData().toString('utf-8');
+            const doc = parser.parseFromString(xml, 'text/xml');
+            removeNormalFootnotes(doc);
+            zip.updateFile(parts.footnotes, Buffer.from(serializer.serializeToString(doc), 'utf-8'));
+        }
+    }
+    zip.writeZip(outputPath);
+    return outputPath;
+}
+/* eslint-disable @typescript-eslint/no-explicit-any --
+   @xmldom/xmldom types are incompatible with global DOM types */
+function removeFootnoteReferences(doc) {
+    const refs = doc.getElementsByTagNameNS(W_NS, 'footnoteReference');
+    const runsToRemove = [];
+    for (let i = 0; i < refs.length; i++) {
+        let node = refs[i];
+        while (node && !(node.localName === 'r' && node.namespaceURI === W_NS)) {
+            node = node.parentNode;
+        }
+        if (node) {
+            runsToRemove.push(node);
+        }
+    }
+    for (const run of runsToRemove) {
+        run.parentNode?.removeChild(run);
+    }
+}
+function removeNormalFootnotes(doc) {
+    const footnotes = doc.getElementsByTagNameNS(W_NS, 'footnote');
+    const toRemove = [];
+    for (let i = 0; i < footnotes.length; i++) {
+        const fn = footnotes[i];
+        const fnType = fn.getAttributeNS(W_NS, 'type');
+        if (fnType !== 'separator' && fnType !== 'continuationSeparator') {
+            toRemove.push(fn);
+        }
+    }
+    for (const fn of toRemove) {
+        fn.parentNode?.removeChild(fn);
+    }
+}
+function removeParagraphsByPattern(doc, patterns) {
+    const regexes = patterns.map((p) => new RegExp(p, 'i'));
+    const paragraphs = doc.getElementsByTagNameNS(W_NS, 'p');
+    const toRemove = [];
+    for (let i = 0; i < paragraphs.length; i++) {
+        const para = paragraphs[i];
+        const text = extractParagraphText(para);
+        if (text && regexes.some((r) => r.test(text))) {
+            toRemove.push(para);
+        }
+    }
+    for (const para of toRemove) {
+        para.parentNode?.removeChild(para);
+    }
+}
+function extractParagraphText(para) {
+    if (!para.getElementsByTagNameNS)
+        return '';
+    const textElements = para.getElementsByTagNameNS(W_NS, 't');
+    const parts = [];
+    for (let i = 0; i < textElements.length; i++) {
+        parts.push(textElements[i].textContent ?? '');
+    }
+    return parts.join('').trim();
+}
+//# sourceMappingURL=cleaner.js.map

package/dist/core/recipe/cleaner.js.map

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

package/dist/core/recipe/downloader.d.ts

@@ -0,0 +1,8 @@
+import type { RecipeMetadata } from '../metadata.js';
+/**
+ * Ensure the source DOCX for a recipe is available locally.
+ * Downloads from source_url on first use, caches in ~/.open-agreements/cache/<recipe-id>/source.docx.
+ * Verifies SHA-256 integrity when source_sha256 is set in metadata.
+ */
+export declare function ensureSourceDocx(recipeId: string, metadata: RecipeMetadata): Promise<string>;
+//# sourceMappingURL=downloader.d.ts.map

package/dist/core/recipe/downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/downloader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAarD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDlG"}

package/dist/core/recipe/downloader.js

@@ -0,0 +1,58 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { createHash } from 'node:crypto';
+const CACHE_ROOT = join(homedir(), '.open-agreements', 'cache');
+function getCachePath(recipeId) {
+    return join(CACHE_ROOT, recipeId, 'source.docx');
+}
+function verifyHash(buf, expected) {
+    const actual = createHash('sha256').update(buf).digest('hex');
+    return actual === expected;
+}
+/**
+ * Ensure the source DOCX for a recipe is available locally.
+ * Downloads from source_url on first use, caches in ~/.open-agreements/cache/<recipe-id>/source.docx.
+ * Verifies SHA-256 integrity when source_sha256 is set in metadata.
+ */
+export async function ensureSourceDocx(recipeId, metadata) {
+    const cachePath = getCachePath(recipeId);
+    // Check cached file
+    if (existsSync(cachePath)) {
+        if (metadata.source_sha256) {
+            const buf = readFileSync(cachePath);
+            if (verifyHash(buf, metadata.source_sha256)) {
+                return cachePath;
+            }
+            console.log(`Cached file for ${recipeId} failed integrity check, re-downloading...`);
+        }
+        else {
+            return cachePath;
+        }
+    }
+    // Download
+    console.log(`Downloading ${metadata.name} from ${metadata.source_url}...`);
+    const response = await fetch(metadata.source_url);
+    if (!response.ok) {
+        throw new Error(`Failed to download ${recipeId}: HTTP ${response.status} ${response.statusText}\n` +
+            `  URL: ${metadata.source_url}`);
+    }
+    const buf = Buffer.from(await response.arrayBuffer());
+    // Verify hash if available
+    if (metadata.source_sha256) {
+        if (!verifyHash(buf, metadata.source_sha256)) {
+            const actual = createHash('sha256').update(buf).digest('hex');
+            throw new Error(`Integrity check failed for ${recipeId}: downloaded file hash does not match.\n` +
+                `  Expected SHA-256: ${metadata.source_sha256}\n` +
+                `  Actual SHA-256:   ${actual}\n` +
+                `  URL: ${metadata.source_url}`);
+        }
+    }
+    // Write to cache
+    const cacheDir = join(CACHE_ROOT, recipeId);
+    mkdirSync(cacheDir, { recursive: true });
+    writeFileSync(cachePath, buf);
+    console.log(`Cached: ${cachePath}`);
+    return cachePath;
+}
+//# sourceMappingURL=downloader.js.map

package/dist/core/recipe/downloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloader.js","sourceRoot":"","sources":["../../../src/core/recipe/downloader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAEhE,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,QAAgB;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,MAAM,KAAK,QAAQ,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAwB;IAC/E,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEzC,oBAAoB;IACpB,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YACpC,IAAI,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5C,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,4CAA4C,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,WAAW;IACX,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,UAAU,KAAK,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,UAAU,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,IAAI;YAClF,UAAU,QAAQ,CAAC,UAAU,EAAE,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAEtD,2BAA2B;IAC3B,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9D,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,0CAA0C;gBAChF,uBAAuB,QAAQ,CAAC,aAAa,IAAI;gBACjD,uBAAuB,MAAM,IAAI;gBACjC,UAAU,QAAQ,CAAC,UAAU,EAAE,CAChC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;IAEpC,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { RecipeRunOptions, RecipeRunResult } from './types.js';
+/**
+ * Run the full recipe pipeline: clean → patch → fill → verify.
+ * If no inputPath is provided, auto-downloads the source document from source_url.
+ */
+export declare function runRecipe(options: RecipeRunOptions): Promise<RecipeRunResult>;
+export { cleanDocument } from './cleaner.js';
+export { patchDocument } from './patcher.js';
+export { verifyOutput, normalizeText, extractAllText } from './verifier.js';
+export { ensureSourceDocx } from './downloader.js';
+export { enumerateTextParts, getGeneralTextPartNames } from './ooxml-parts.js';
+export type { OoxmlTextParts } from './ooxml-parts.js';
+export type { RecipeRunOptions, RecipeRunResult, VerifyResult, VerifyCheck } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkFnF;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/recipe/index.js

@@ -0,0 +1,91 @@
+import { mkdtempSync, copyFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { loadRecipeMetadata, loadCleanConfig } from '../metadata.js';
+import { resolveRecipeDir } from '../../utils/paths.js';
+import { cleanDocument } from './cleaner.js';
+import { patchDocument } from './patcher.js';
+import { verifyOutput } from './verifier.js';
+import { ensureSourceDocx } from './downloader.js';
+import { prepareFillData, fillDocx } from '../fill-pipeline.js';
+/**
+ * Run the full recipe pipeline: clean → patch → fill → verify.
+ * If no inputPath is provided, auto-downloads the source document from source_url.
+ */
+export async function runRecipe(options) {
+    const { recipeId, outputPath, values, keepIntermediate } = options;
+    const recipeDir = resolveRecipeDir(recipeId);
+    const metadata = loadRecipeMetadata(recipeDir);
+    const cleanConfig = loadCleanConfig(recipeDir);
+    // Resolve input: explicit path or auto-download
+    const inputPath = options.inputPath ?? await ensureSourceDocx(recipeId, metadata);
+    // Load replacements.json
+    const replacementsPath = join(recipeDir, 'replacements.json');
+    const replacements = JSON.parse(readFileSync(replacementsPath, 'utf-8'));
+    // Create temp directory for intermediate files
+    const tempDir = mkdtempSync(join(tmpdir(), `recipe-${recipeId}-`));
+    const stages = {
+        clean: '',
+        patch: '',
+        fill: '',
+    };
+    try {
+        // Copy input to temp dir
+        const sourcePath = join(tempDir, 'source.docx');
+        copyFileSync(inputPath, 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 });
+        }
+    }
+}
+export { cleanDocument } from './cleaner.js';
+export { patchDocument } from './patcher.js';
+export { verifyOutput, normalizeText, extractAllText } from './verifier.js';
+export { ensureSourceDocx } from './downloader.js';
+export { enumerateTextParts, getGeneralTextPartNames } from './ooxml-parts.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/recipe/ooxml-parts.d.ts

@@ -0,0 +1,21 @@
+import AdmZip from 'adm-zip';
+export interface OoxmlTextParts {
+    document: string | null;
+    headers: string[];
+    footers: string[];
+    endnotes: string | null;
+    footnotes: string | null;
+}
+/**
+ * Enumerate all OOXML text parts present in a DOCX zip.
+ */
+export declare function enumerateTextParts(zip: AdmZip): OoxmlTextParts;
+/**
+ * Return a flat list of part names that should be processed by the patcher,
+ * cleaner (for footnote refs and paragraph patterns), verifier, and scanner.
+ *
+ * Excludes footnotes.xml because it has separator/continuationSeparator logic
+ * that requires special handling in the cleaner.
+ */
+export declare function getGeneralTextPartNames(parts: OoxmlTextParts): string[];
+//# sourceMappingURL=ooxml-parts.d.ts.map

package/dist/core/recipe/ooxml-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ooxml-parts.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/ooxml-parts.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAa9D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAOvE"}

package/dist/core/recipe/ooxml-parts.js

@@ -0,0 +1,33 @@
+/**
+ * Enumerate all OOXML text parts present in a DOCX zip.
+ */
+export function enumerateTextParts(zip) {
+    const entries = zip.getEntries().map((e) => e.entryName);
+    const headerPattern = /^word\/header\d+\.xml$/;
+    const footerPattern = /^word\/footer\d+\.xml$/;
+    return {
+        document: entries.includes('word/document.xml') ? 'word/document.xml' : null,
+        headers: entries.filter((e) => headerPattern.test(e)).sort(),
+        footers: entries.filter((e) => footerPattern.test(e)).sort(),
+        endnotes: entries.includes('word/endnotes.xml') ? 'word/endnotes.xml' : null,
+        footnotes: entries.includes('word/footnotes.xml') ? 'word/footnotes.xml' : null,
+    };
+}
+/**
+ * Return a flat list of part names that should be processed by the patcher,
+ * cleaner (for footnote refs and paragraph patterns), verifier, and scanner.
+ *
+ * Excludes footnotes.xml because it has separator/continuationSeparator logic
+ * that requires special handling in the cleaner.
+ */
+export function getGeneralTextPartNames(parts) {
+    const names = [];
+    if (parts.document)
+        names.push(parts.document);
+    names.push(...parts.headers);
+    names.push(...parts.footers);
+    if (parts.endnotes)
+        names.push(parts.endnotes);
+    return names;
+}
+//# sourceMappingURL=ooxml-parts.js.map

package/dist/core/recipe/ooxml-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ooxml-parts.js","sourceRoot":"","sources":["../../../src/core/recipe/ooxml-parts.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,wBAAwB,CAAC;IAC/C,MAAM,aAAa,GAAG,wBAAwB,CAAC;IAE/C,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI;QAC5E,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QAC5D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QAC5D,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI;QAC5E,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI;KAChF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAqB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/recipe/patcher.d.ts

@@ -0,0 +1,17 @@
+import type { Element } from '@xmldom/xmldom';
+/**
+ * Patch a DOCX document by replacing bracketed placeholders with template tags.
+ * Uses a char_map algorithm to handle cross-run replacements where Word splits
+ * placeholder text across multiple XML run elements.
+ *
+ * Processes all general OOXML text parts (document, headers, footers, endnotes).
+ */
+export declare function patchDocument(inputPath: string, outputPath: string, replacements: Record<string, string>): Promise<string>;
+export declare function getRunText(run: Element): string;
+/**
+ * Check if a run is safe to remove when its text is empty.
+ * Returns true only if all element children are <w:rPr> or <w:t>.
+ * Returns false if the run contains drawings, fields, breaks, or other non-text elements.
+ */
+export declare function isRunSafeToRemove(run: Element): boolean;
+//# sourceMappingURL=patcher.d.ts.map

package/dist/core/recipe/patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patcher.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/patcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,OAAO,EAAQ,MAAM,gBAAgB,CAAC;AAsB9D;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAiBD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAO/C;AAiDD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAcvD"}