@usejunior/docx-core 0.14.0 → 0.16.0

package/dist/format-detection.js

@@ -1,339 +0,0 @@
-/**
- * Format Change Detection Module
- *
- * Detects formatting changes (bold, italic, font size, etc.) between
- * documents after LCS comparison. Runs on atoms marked as Equal to
- * identify text that matches but has different formatting.
- *
- * Pipeline position:
- * LCS() → FlattenToAtomList() → detectMovesInAtomList() → detectFormatChangesInAtomList() → CoalesceRecurse()
- *
- * @see design.md Decision 10: Format Change Detection as Post-LCS Phase
- */
-import { CorrelationStatus, DEFAULT_FORMAT_DETECTION_SETTINGS, RUN_PROPERTY_FRIENDLY_NAMES, } from './core-types.js';
-import { getLeafText, childElements } from './primitives/index.js';
-import { parseXml } from './primitives/xml.js';
-// =============================================================================
-// Run Property Extraction
-// =============================================================================
-/**
- * Extract run properties (w:rPr) from an atom's ancestor elements.
- *
- * Finds the w:r (run) element in ancestors and extracts its w:rPr child.
- *
- * @param atom - The atom to extract properties from
- * @returns The w:rPr element, or null if not found
- *
- * @example
- * // For an atom inside <w:r><w:rPr><w:b/></w:rPr><w:t>text</w:t></w:r>
- * // Returns the <w:rPr><w:b/></w:rPr> element
- */
-export function getRunPropertiesFromAtom(atom) {
-    // Find the w:r ancestor element
-    const runElement = atom.ancestorElements?.find((a) => a.tagName === 'w:r');
-    if (!runElement) {
-        return null;
-    }
-    // Get the rPr child element
-    for (const child of childElements(runElement)) {
-        if (child.tagName === 'w:rPr')
-            return child;
-    }
-    return null;
-}
-function extractNormalizedProperties(rPr) {
-    if (!rPr) {
-        return { children: [] };
-    }
-    const normalizedChildren = childElements(rPr)
-        // Remove revision tracking elements
-        .filter((e) => e.tagName !== 'w:rPrChange')
-        // Sort by tag name for deterministic comparison
-        .sort((a, b) => a.tagName.localeCompare(b.tagName))
-        // Normalize each child
-        .map((e) => {
-        const attrs = [];
-        for (let i = 0; i < e.attributes.length; i++) {
-            const attr = e.attributes[i];
-            attrs.push([attr.name, attr.value]);
-        }
-        attrs.sort(([a], [b]) => a.localeCompare(b));
-        const text = getLeafText(e);
-        const prop = { tagName: e.tagName, attrs };
-        if (text !== undefined)
-            prop.text = text;
-        return prop;
-    });
-    return { children: normalizedChildren };
-}
-// =============================================================================
-// Run Property Comparison
-// =============================================================================
-/**
- * Serialize normalized properties to a string for comparison.
- */
-function serializeNormalizedProperties(rPr) {
-    const parts = [];
-    for (const child of rPr.children) {
-        const attrs = child.attrs
-            .map(([k, v]) => `${k}="${v}"`)
-            .join(' ');
-        const textPart = child.text ? `|${child.text}` : '';
-        parts.push(`<${child.tagName} ${attrs}${textPart}/>`);
-    }
-    return parts.join('');
-}
-/**
- * Check if two run properties are equal after normalization.
- */
-export function areRunPropertiesEqual(rPr1, rPr2) {
-    const norm1 = extractNormalizedProperties(rPr1);
-    const norm2 = extractNormalizedProperties(rPr2);
-    return serializeNormalizedProperties(norm1) === serializeNormalizedProperties(norm2);
-}
-// Keep legacy overload for callers that pass WmlElement (= Element)
-export { areRunPropertiesEqual as areNormalizedRunPropertiesEqual };
-// =============================================================================
-// Changed Property Detection
-// =============================================================================
-/**
- * Get the set of property tag names from a normalized rPr.
- */
-function getPropertyTagNames(rPr) {
-    return new Set(rPr.children.map((c) => c.tagName));
-}
-/**
- * Find a property element by tag name in a normalized rPr.
- */
-function findPropertyByTag(rPr, tagName) {
-    return rPr.children.find((c) => c.tagName === tagName);
-}
-/**
- * Check if two property elements have the same value.
- */
-function arePropertiesValueEqual(prop1, prop2) {
-    if (!prop1 && !prop2)
-        return true;
-    if (!prop1 || !prop2)
-        return false;
-    const str1 = serializeNormalizedProperties({ children: [prop1] });
-    const str2 = serializeNormalizedProperties({ children: [prop2] });
-    return str1 === str2;
-}
-/**
- * Get the list of property names that changed between two run properties.
- *
- * Returns friendly names (e.g., "bold", "italic") when available,
- * otherwise returns the OOXML tag name.
- *
- * @param oldRPr - Old run properties element (or null)
- * @param newRPr - New run properties element (or null)
- * @returns Array of changed property names
- */
-export function getChangedPropertyNames(oldRPr, newRPr) {
-    const changed = [];
-    const normalizedOld = extractNormalizedProperties(oldRPr);
-    const normalizedNew = extractNormalizedProperties(newRPr);
-    const oldTags = getPropertyTagNames(normalizedOld);
-    const newTags = getPropertyTagNames(normalizedNew);
-    // All unique tags from both
-    const allTags = new Set([...oldTags, ...newTags]);
-    for (const tag of allTags) {
-        const oldProp = findPropertyByTag(normalizedOld, tag);
-        const newProp = findPropertyByTag(normalizedNew, tag);
-        if (!arePropertiesValueEqual(oldProp, newProp)) {
-            // Use friendly name if available
-            const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-            changed.push(friendlyName);
-        }
-    }
-    return changed.sort();
-}
-/**
- * Categorize changed properties into added, removed, and modified.
- *
- * @param oldRPr - Old run properties element (or null)
- * @param newRPr - New run properties element (or null)
- * @returns Object with added, removed, and changed arrays
- */
-export function categorizePropertyChanges(oldRPr, newRPr) {
-    const added = [];
-    const removed = [];
-    const changed = [];
-    const normalizedOld = extractNormalizedProperties(oldRPr);
-    const normalizedNew = extractNormalizedProperties(newRPr);
-    const oldTags = getPropertyTagNames(normalizedOld);
-    const newTags = getPropertyTagNames(normalizedNew);
-    // Check for added properties (in new but not old)
-    for (const tag of newTags) {
-        if (!oldTags.has(tag)) {
-            const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-            added.push(friendlyName);
-        }
-    }
-    // Check for removed properties (in old but not new)
-    for (const tag of oldTags) {
-        if (!newTags.has(tag)) {
-            const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-            removed.push(friendlyName);
-        }
-    }
-    // Check for changed properties (in both but different value)
-    for (const tag of oldTags) {
-        if (newTags.has(tag)) {
-            const oldProp = findPropertyByTag(normalizedOld, tag);
-            const newProp = findPropertyByTag(normalizedNew, tag);
-            if (!arePropertiesValueEqual(oldProp, newProp)) {
-                const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-                changed.push(friendlyName);
-            }
-        }
-    }
-    return {
-        added: added.sort(),
-        removed: removed.sort(),
-        changed: changed.sort(),
-    };
-}
-// =============================================================================
-// Main Algorithm
-// =============================================================================
-/**
- * Detect format changes in a flat list of atoms.
- *
- * Runs after LCS and move detection to identify Equal atoms where the text
- * matches but formatting differs. Updates atoms in place with format change status.
- *
- * @param atoms - The atom list to process (modified in place)
- * @param settings - Format detection settings (optional, uses defaults)
- */
-export function detectFormatChangesInAtomList(atoms, settings = DEFAULT_FORMAT_DETECTION_SETTINGS) {
-    if (!settings.detectFormatChanges) {
-        return;
-    }
-    for (const atom of atoms) {
-        // Only check Equal atoms that have a "before" reference
-        if (atom.correlationStatus !== CorrelationStatus.Equal) {
-            continue;
-        }
-        if (!atom.comparisonUnitAtomBefore) {
-            continue;
-        }
-        // Extract rPr from both documents
-        const oldRPr = getRunPropertiesFromAtom(atom.comparisonUnitAtomBefore);
-        const newRPr = getRunPropertiesFromAtom(atom);
-        // Compare run properties
-        if (!areRunPropertiesEqual(oldRPr, newRPr)) {
-            atom.correlationStatus = CorrelationStatus.FormatChanged;
-            atom.formatChange = {
-                oldRunProperties: oldRPr,
-                newRunProperties: newRPr,
-                changedProperties: getChangedPropertyNames(oldRPr, newRPr),
-            };
-        }
-    }
-}
-/**
- * Merge format change markup into a run's existing rPr element.
- *
- * Adds the w:rPrChange element as the last child of w:rPr.
- *
- * @param runElement - The w:r element to modify
- * @param rPrChange - The w:rPrChange element to insert
- */
-export function mergeFormatChangeIntoRun(runElement, rPrChange) {
-    if (runElement.tagName !== 'w:r') {
-        return;
-    }
-    // Find existing rPr
-    let rPr = null;
-    for (const child of childElements(runElement)) {
-        if (child.tagName === 'w:rPr') {
-            rPr = child;
-            break;
-        }
-    }
-    if (!rPr) {
-        // Create rPr as first child
-        const doc = runElement.ownerDocument;
-        rPr = doc.createElementNS('http://schemas.openxmlformats.org/wordprocessingml/2006/main', 'w:rPr');
-        runElement.insertBefore(rPr, runElement.firstChild);
-    }
-    // Add rPrChange as last child of rPr
-    rPr.appendChild(rPrChange);
-}
-// =============================================================================
-// Paragraph Property Change Support (Future Enhancement)
-// =============================================================================
-/**
- * Extract paragraph properties (w:pPr) from an element.
- *
- * @param paragraphElement - The w:p element
- * @returns The w:pPr element, or null if not found
- */
-export function getParagraphProperties(paragraphElement) {
-    if (paragraphElement.tagName !== 'w:p') {
-        return null;
-    }
-    for (const child of childElements(paragraphElement)) {
-        if (child.tagName === 'w:pPr')
-            return child;
-    }
-    return null;
-}
-/**
- * Paragraph property friendly names.
- */
-export const PARAGRAPH_PROPERTY_FRIENDLY_NAMES = {
-    'w:jc': 'alignment',
-    'w:ind': 'indentation',
-    'w:spacing': 'spacing',
-    'w:pStyle': 'style',
-    'w:numPr': 'numbering',
-    'w:pBdr': 'borders',
-    'w:shd': 'shading',
-    'w:tabs': 'tabs',
-    'w:keepNext': 'keepWithNext',
-    'w:keepLines': 'keepLinesTogether',
-    'w:pageBreakBefore': 'pageBreakBefore',
-    'w:widowControl': 'widowControl',
-    'w:outlineLvl': 'outlineLevel',
-};
-// =============================================================================
-// Legacy API — kept for backward compatibility during migration
-// =============================================================================
-/**
- * @deprecated Use areRunPropertiesEqual directly with Element params
- */
-export function normalizeRunProperties(rPr) {
-    return extractNormalizedProperties(rPr);
-}
-/**
- * @deprecated Use getParagraphProperties directly
- */
-export function normalizeParagraphProperties(pPr) {
-    return extractNormalizedProperties(pPr);
-}
-/**
- * @deprecated Removed — use generateFormatChangeMarkup with DOM approach
- */
-export function generateFormatChangeMarkup(formatChange, options) {
-    const doc = parseXml('<root/>');
-    const dateStr = options.dateTime.toISOString();
-    const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
-    const rPrChange = doc.createElementNS(W_NS, 'w:rPrChange');
-    rPrChange.setAttribute('w:id', options.id.toString());
-    rPrChange.setAttribute('w:author', options.author);
-    rPrChange.setAttribute('w:date', dateStr);
-    const rPr = doc.createElementNS(W_NS, 'w:rPr');
-    rPrChange.appendChild(rPr);
-    if (formatChange.oldRunProperties) {
-        for (const child of childElements(formatChange.oldRunProperties)) {
-            if (child.tagName === 'w:rPrChange')
-                continue;
-            rPr.appendChild(child.cloneNode(true));
-        }
-    }
-    return rPrChange;
-}
-//# sourceMappingURL=format-detection.js.map

package/dist/format-detection.js.map

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

package/dist/generation/recipes.d.ts

@@ -1,144 +0,0 @@
-/**
- * Legal-document recipes.
- *
- * Pure functions producing spec nodes from options — no own OOXML
- * representation, no compiler hooks. Everything a recipe returns is built
- * from the paragraph/table grammar, so its output is inlineable anywhere a
- * BlockSpec is accepted and serializes through exactly the emitters the
- * rest of the document uses. Signature lines are bottom-bordered cells, not
- * VML shapes: Pages and Google Docs mangle VML, borders survive everywhere.
- */
-import type { BlockSpec, HighlightColor, TableSpec } from './types.js';
-/** A value cell that can be flagged as an unfilled fillable placeholder. */
-type FillableValue = {
-    fillable?: boolean;
-};
-export type CoverTermRow = {
-    label: string;
-    value: string;
-} & FillableValue;
-export type CoverTermGroupRow = {
-    group: string;
-};
-export type CoverTermSubrow = {
-    label: string;
-    value: string;
-    subrow: true;
-} & FillableValue;
-export type CoverTermEntry = CoverTermRow | CoverTermGroupRow | CoverTermSubrow;
-export type CoverTermsOptions = {
-    /** Plain rows, group headers, and subrows rendered in declaration order. */
-    terms: CoverTermEntry[];
-    /** Two-column widths in twips; defaults to a 2880/6480 split of a 6.5" body. */
-    columnWidthsTwips?: [number, number];
-    /** Heading text for a shaded full-width header row; omitted when absent. */
-    title?: string;
-    /** Table border style; defaults to the historical full grid. */
-    borderMode?: 'grid' | 'horizontal-rules';
-    /** Optional minimum row height applied to term/group/sub rows, not the title row. */
-    rowHeightTwips?: number;
-    /** Optional uniform cell padding applied to every cover-terms cell. */
-    cellPaddingTwips?: number;
-    /**
-     * Optional non-uniform cell margins. When set it supersedes `cellPaddingTwips`
-     * for every cover-terms cell (the subrow label indent is still added on top of
-     * the resulting `left`).
-     */
-    cellMarginsTwips?: {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
-    /** Body font applied to every label/value/group run; default inherits Normal. */
-    fontFamily?: string;
-    /** Point size for plain-row and group runs; default inherits Normal. */
-    sizePt?: number;
-    /** Point size for subrow runs; defaults to `sizePt`. */
-    subrowSizePt?: number;
-    /** Text color for plain-row labels/values (six-hex, no '#'); default unset. */
-    textColorHex?: string;
-    /** Text color for group-row labels; defaults to `textColorHex`. */
-    groupColorHex?: string;
-    /** Text color for subrow labels and values; defaults to mid-gray. */
-    subrowColorHex?: string;
-    /** Highlight applied to a value flagged `fillable`; defaults to `yellow`. */
-    fillableHighlight?: HighlightColor;
-    /**
-     * Extra left indent on subrow label cells, added on top of `cellPaddingTwips`
-     * (so the label sits further right than a normal row). Defaults to 240 twips.
-     */
-    subrowLabelIndentTwips?: number;
-    /** Color (six-hex, no '#') for the table's single-style borders. Default 'auto'. */
-    ruleColorHex?: string;
-    /** Weight in eighths of a point for the single-style borders. Default 4 (0.5pt). */
-    ruleSizeEighthPt?: number;
-};
-/**
- * A fixed-layout two-column label/value table for cover-terms blocks
- * (scenario SDX-GEN-070), with optional house-style grouped/sub rows
- * (SDX-GEN-106) and run styling + fillable placeholders (SDX-GEN-110).
- */
-export declare function coverTermsTable(options: CoverTermsOptions): TableSpec;
-export type SignatureBlockOptions = {
-    parties: Array<{
-        /** Party heading above the signature line, e.g. the company name. */
-        party: string;
-        /** Signatory name printed under the line. */
-        name: string;
-        title?: string;
-        /** Label for the date row; defaults to 'Date:'. */
-        dateLabel?: string;
-        /** Override block `fillable` for this party's Print Name (oa-stacked-ruled). Default: `fillable`. */
-        nameFillable?: boolean;
-        /** Override block `fillable` for this party's Title (oa-stacked-ruled). Default: `fillable`. */
-        titleFillable?: boolean;
-    }>;
-    /** Signature-line column width in twips; defaults to 4320 (3"). Single-column only. */
-    lineWidthTwips?: number;
-    /** Layout selector. Defaults to 'single-column' (the historical behavior). */
-    layout?: 'single-column' | 'two-column' | 'oa-stacked-ruled';
-    /** Total grid width in twips, split across the two signer columns. Defaults to 9360 (6.5" body). */
-    totalWidthTwips?: number;
-    /** Center gutter column width between the two signer cells. Defaults to 360 (0.25"). */
-    gutterTwips?: number;
-    /** Color for the muted party header and field captions. Defaults to '595959'. */
-    headerColorHex?: string;
-    /** Captions for the four ruled lines. Defaults to ['Signature', 'Print Name', 'Title', 'Date']. */
-    ruledLineLabels?: [string, string, string, string];
-    /** Width of the left label column in twips. Defaults to 1800 (1.25"). */
-    labelColumnTwips?: number;
-    /** Minimum signing-row height in twips (room to sign). Defaults to 620. */
-    ruledRowHeightTwips?: number;
-    /** Which fields render, in order. Defaults to all four. */
-    fields?: Array<'signature' | 'printName' | 'title' | 'date'>;
-    /** Body font for the OA signature header + labels + values. */
-    fontFamily?: string;
-    /** Mark pre-filled values (printName/title) as fillable -> highlight + bold. */
-    fillable?: boolean;
-    /** Highlight for fillable values; defaults to `yellow`. */
-    fillableHighlight?: HighlightColor;
-    /** Bold the centered party header (oa-stacked-ruled). Default false. */
-    headerBold?: boolean;
-    /** Party-header point size (oa-stacked-ruled). Default: inherit Normal. */
-    headerSizePt?: number;
-    /** Color (six-hex) for the ruled signing line (oa-stacked-ruled). Default 'auto'. */
-    lineColorHex?: string;
-    /** Ruled signing-line weight in eighths of a point (oa-stacked-ruled). Default 4. */
-    lineSizeEighthPt?: number;
-};
-/**
- * Signature blocks rendered as borderless tables whose content cells carry
- * only bottom borders — the signature lines. No VML, no images.
- *
- * - `single-column` (default): the historical stacked block — one table per
- *   party, a bottom-bordered line then name/title/date rows (SDX-GEN-071).
- * - `two-column`: a paired signing grid, two signers per row, each a centered
- *   muted header over ruled Signature/Print Name/Title/Date lines with captions
- *   beneath (SDX-GEN-109).
- * - `oa-stacked-ruled`: per party, a centered muted-caps header over a
- *   label-column / ruled-line table with tall signing rows (SDX-GEN-111).
- */
-export declare function signatureBlock(options: SignatureBlockOptions): BlockSpec[];
-export {};
-//# sourceMappingURL=recipes.d.ts.map

package/dist/generation/recipes.d.ts.map

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