@open-agreements/open-agreements 0.2.0

package/dist/core/recipe/computed.js

@@ -0,0 +1,225 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+const PrimitiveSchema = z.union([z.string(), z.boolean()]);
+const PrimitiveArraySchema = z.array(PrimitiveSchema).min(1);
+export const ComputedPredicateSchema = z.object({
+    field: z.string().min(1),
+    op: z.enum(['eq', 'neq', 'in', 'truthy', 'falsy', 'defined']),
+    value: z.union([PrimitiveSchema, PrimitiveArraySchema]).optional(),
+}).superRefine((predicate, ctx) => {
+    if ((predicate.op === 'eq' || predicate.op === 'neq') && predicate.value === undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['value'],
+            message: `Predicate op "${predicate.op}" requires a value`,
+        });
+    }
+    if (predicate.op === 'in') {
+        if (!Array.isArray(predicate.value) || predicate.value.length === 0) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['value'],
+                message: 'Predicate op "in" requires a non-empty array value',
+            });
+        }
+        return;
+    }
+    if ((predicate.op === 'truthy' || predicate.op === 'falsy' || predicate.op === 'defined') && predicate.value !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['value'],
+            message: `Predicate op "${predicate.op}" must not define a value`,
+        });
+    }
+});
+export const ComputedRuleSchema = z.object({
+    id: z.string().min(1),
+    description: z.string().optional(),
+    when_all: z.array(ComputedPredicateSchema).default([]),
+    when_any: z.array(ComputedPredicateSchema).default([]),
+    set_fill: z.record(z.string().min(1), PrimitiveSchema).default({}),
+    set_audit: z.record(z.string().min(1), PrimitiveSchema).default({}),
+}).superRefine((rule, ctx) => {
+    if (Object.keys(rule.set_fill).length === 0 && Object.keys(rule.set_audit).length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['set_fill'],
+            message: 'Each rule must define at least one assignment in set_fill or set_audit',
+        });
+    }
+});
+export const ComputedProfileSchema = z.object({
+    version: z.string().default('1.0'),
+    max_passes: z.number().int().min(1).max(20).default(4),
+    rules: z.array(ComputedRuleSchema).min(1),
+});
+function normalizeComparableValue(value) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    const normalized = value.trim();
+    if (normalized.toLowerCase() === 'true')
+        return true;
+    if (normalized.toLowerCase() === 'false')
+        return false;
+    return normalized;
+}
+function interpolate(value, state) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    if (!value.includes('${')) {
+        return value;
+    }
+    return value.replace(/\$\{([A-Za-z0-9_]+)\}/g, (_match, fieldName) => {
+        const fieldValue = state[fieldName];
+        return fieldValue === undefined ? '' : String(fieldValue);
+    });
+}
+function evaluatePredicate(predicate, state) {
+    const actualRaw = state[predicate.field];
+    const actual = normalizeComparableValue(actualRaw);
+    if (predicate.op === 'defined') {
+        return actualRaw !== undefined && actualRaw !== null && actualRaw !== '';
+    }
+    if (predicate.op === 'truthy') {
+        return Boolean(actualRaw);
+    }
+    if (predicate.op === 'falsy') {
+        return !actualRaw;
+    }
+    if (predicate.op === 'in') {
+        const candidates = predicate.value.map((entry) => normalizeComparableValue(entry));
+        return candidates.some((entry) => entry === actual);
+    }
+    const expected = normalizeComparableValue(predicate.value);
+    if (predicate.op === 'eq') {
+        return actual === expected;
+    }
+    return actual !== expected;
+}
+function matchRule(rule, state) {
+    const allPredicatesMatch = rule.when_all.length === 0
+        ? true
+        : rule.when_all.every((predicate) => evaluatePredicate(predicate, state));
+    if (!allPredicatesMatch) {
+        return false;
+    }
+    return rule.when_any.length === 0
+        ? true
+        : rule.when_any.some((predicate) => evaluatePredicate(predicate, state));
+}
+function computeDerivedValues(initialValues, finalValues) {
+    const result = {};
+    for (const [field, value] of Object.entries(finalValues)) {
+        if (!(field in initialValues) || initialValues[field] !== value) {
+            result[field] = value;
+        }
+    }
+    return result;
+}
+export function loadComputedProfile(recipeDir) {
+    const computedPath = join(recipeDir, 'computed.json');
+    if (!existsSync(computedPath)) {
+        return null;
+    }
+    const parsed = JSON.parse(readFileSync(computedPath, 'utf-8'));
+    return ComputedProfileSchema.parse(parsed);
+}
+export function evaluateComputedProfile(profile, inputValues) {
+    const fillValues = { ...inputValues };
+    const auditValues = {};
+    const combinedState = { ...fillValues };
+    const passes = [];
+    let stabilized = false;
+    for (let pass = 1; pass <= profile.max_passes; pass += 1) {
+        let passChanged = false;
+        const ruleTraces = [];
+        for (const rule of profile.rules) {
+            const matched = matchRule(rule, combinedState);
+            const assignments = [];
+            if (matched) {
+                for (const [field, assigned] of Object.entries(rule.set_fill)) {
+                    const resolved = interpolate(assigned, combinedState);
+                    const previous = fillValues[field];
+                    if (previous !== resolved) {
+                        fillValues[field] = resolved;
+                        combinedState[field] = resolved;
+                        assignments.push({ field, scope: 'fill', previous, next: resolved });
+                        passChanged = true;
+                    }
+                }
+                for (const [field, assigned] of Object.entries(rule.set_audit)) {
+                    const resolved = interpolate(assigned, combinedState);
+                    const previous = auditValues[field];
+                    if (previous !== resolved) {
+                        auditValues[field] = resolved;
+                        combinedState[field] = resolved;
+                        assignments.push({ field, scope: 'audit', previous, next: resolved });
+                        passChanged = true;
+                    }
+                }
+            }
+            ruleTraces.push({
+                rule_id: rule.id,
+                description: rule.description,
+                matched,
+                assignments,
+            });
+        }
+        passes.push({
+            pass,
+            changed: passChanged,
+            rules: ruleTraces,
+        });
+        if (!passChanged) {
+            stabilized = true;
+            break;
+        }
+    }
+    return {
+        fillValues,
+        auditValues,
+        passes,
+        stabilized,
+        maxPasses: profile.max_passes,
+    };
+}
+export function buildComputedArtifact(args) {
+    const { recipeId, inputValues, evaluated, profileVersion } = args;
+    return {
+        recipe_id: recipeId,
+        generated_at: new Date().toISOString(),
+        profile_present: true,
+        profile_version: profileVersion,
+        max_passes: evaluated.maxPasses,
+        stabilized: evaluated.stabilized,
+        pass_count: evaluated.passes.length,
+        inputs: inputValues,
+        final_fill_values: evaluated.fillValues,
+        derived_fill_values: computeDerivedValues(inputValues, evaluated.fillValues),
+        derived_audit_values: evaluated.auditValues,
+        passes: evaluated.passes,
+    };
+}
+export function buildPassthroughArtifact(args) {
+    return {
+        recipe_id: args.recipeId,
+        generated_at: new Date().toISOString(),
+        profile_present: false,
+        profile_version: null,
+        max_passes: 0,
+        stabilized: true,
+        pass_count: 0,
+        inputs: { ...args.inputValues },
+        final_fill_values: { ...args.inputValues },
+        derived_fill_values: {},
+        derived_audit_values: {},
+        passes: [],
+    };
+}
+export function writeComputedArtifact(outputPath, artifact) {
+    writeFileSync(outputPath, `${JSON.stringify(artifact, null, 2)}\n`, 'utf-8');
+}
+//# sourceMappingURL=computed.js.map

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

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

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

@@ -0,0 +1,17 @@
+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 type { CleanResult, CleanOptions } from './cleaner.js';
+export { patchDocument } from './patcher.js';
+export { verifyOutput, normalizeText, extractAllText } from './verifier.js';
+export { ensureSourceDocx } from './downloader.js';
+export { checkRecipeSourceDrift, computeSourceStructureSignature } from './source-drift.js';
+export { enumerateTextParts, getGeneralTextPartNames } from './ooxml-parts.js';
+export type { OoxmlTextParts } from './ooxml-parts.js';
+export type { RecipeRunOptions, RecipeRunResult, VerifyResult, VerifyCheck } from './types.js';
+export type { ComputedArtifact, ComputedProfile } from './computed.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":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8EnF;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,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,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAC5F,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;AAC/F,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/recipe/index.js

@@ -0,0 +1,90 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadRecipeMetadata, loadCleanConfig, loadNormalizeConfig } from '../metadata.js';
+import { resolveRecipeDir } from '../../utils/paths.js';
+import { verifyOutput } from './verifier.js';
+import { ensureSourceDocx } from './downloader.js';
+import { loadComputedProfile, evaluateComputedProfile, buildComputedArtifact, buildPassthroughArtifact, writeComputedArtifact, } from './computed.js';
+import { normalizeBracketArtifacts } from './bracket-normalizer.js';
+import { runFillPipeline } from '../unified-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, computedOutPath } = options;
+    const recipeDir = resolveRecipeDir(recipeId);
+    const metadata = loadRecipeMetadata(recipeDir);
+    const cleanConfig = loadCleanConfig(recipeDir);
+    const normalizeConfig = loadNormalizeConfig(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'));
+    const replacementFieldNames = new Set();
+    for (const replacement of Object.values(replacements)) {
+        for (const match of replacement.matchAll(/\{([a-zA-Z0-9_]+)\}/g)) {
+            replacementFieldNames.add(match[1]);
+        }
+    }
+    const inputValues = { ...values };
+    const computedProfile = loadComputedProfile(recipeDir);
+    const computedEvaluation = computedProfile ? evaluateComputedProfile(computedProfile, inputValues) : null;
+    const effectiveValues = computedEvaluation ? computedEvaluation.fillValues : inputValues;
+    const verificationValues = {};
+    for (const field of metadata.fields) {
+        if (!replacementFieldNames.has(field.name)) {
+            continue;
+        }
+        const value = effectiveValues[field.name];
+        if (typeof value === 'string') {
+            verificationValues[field.name] = value;
+        }
+    }
+    const computedArtifact = computedEvaluation && computedProfile
+        ? buildComputedArtifact({
+            recipeId,
+            inputValues,
+            evaluated: computedEvaluation,
+            profileVersion: computedProfile.version,
+        })
+        : (computedOutPath ? buildPassthroughArtifact({ recipeId, inputValues }) : undefined);
+    if (computedOutPath && computedArtifact) {
+        writeComputedArtifact(computedOutPath, computedArtifact);
+    }
+    const shouldNormalizeBracketArtifacts = options.normalizeBracketArtifacts ?? recipeId === 'nvca-stock-purchase-agreement';
+    const result = await runFillPipeline({
+        inputPath,
+        outputPath,
+        values: effectiveValues,
+        fields: metadata.fields,
+        requiredFieldNames: metadata.required_fields,
+        cleanPatch: { cleanConfig, replacements },
+        postProcess: shouldNormalizeBracketArtifacts
+            ? async (outputDocPath) => {
+                await normalizeBracketArtifacts(outputDocPath, outputDocPath, {
+                    rules: normalizeConfig.paragraph_rules,
+                    fieldValues: effectiveValues,
+                });
+            }
+            : undefined,
+        verify: (p) => verifyOutput(p, verificationValues, replacements, cleanConfig),
+        keepIntermediate,
+    });
+    return {
+        outputPath: result.outputPath,
+        metadata,
+        fieldsUsed: result.fieldsUsed,
+        stages: result.stages,
+        computedArtifact,
+        computedOutPath,
+    };
+}
+export { cleanDocument } from './cleaner.js';
+export { patchDocument } from './patcher.js';
+export { verifyOutput, normalizeText, extractAllText } from './verifier.js';
+export { ensureSourceDocx } from './downloader.js';
+export { checkRecipeSourceDrift, computeSourceStructureSignature } from './source-drift.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,34 @@
+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.
+ *
+ * Supports three key syntax types:
+ * - Simple: "search text" → replaces all occurrences
+ * - Context: "label > placeholder" → replaces placeholder only in matching table rows
+ * - Nth: "text#N" → replaces only the Nth occurrence across the document
+ *
+ * Processing order: context keys first, nth keys second, simple keys last.
+ * This ensures qualified rules claim their targets before simple rules sweep up the rest.
+ */
+export interface PatchOptions {
+    /** Hex color (e.g. "000000") to apply to replacement text. When set, the
+     *  patcher explicitly sets <w:color> on runs that receive replacement text,
+     *  overriding any inherited placeholder styling (e.g. gray). */
+    replacementColor?: string;
+}
+export declare function patchDocument(inputPath: string, outputPath: string, replacements: Record<string, string>, options?: PatchOptions): Promise<string>;
+/**
+ * Get the text content of the first table cell (label cell) in the same row
+ * as the paragraph. Returns null if the paragraph is not inside a table cell.
+ */
+export declare function getTableRowContext(para: Element): string | null;
+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;AAwB9D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B;;oEAEgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CA+HjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAwB/D;AA0BD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAO/C;AAuFD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAcvD"}