@wonderwhy-er/desktop-commander 0.2.37 → 0.2.39

package/dist/tools/docx/ops/header-replace-text-exact.d.ts

@@ -1,13 +0,0 @@
-/**
- * Op: header_replace_text_exact
- *
- * Find ALL header XML files (word/header1.xml, header2.xml, …)
- * in the ZIP, locate the first paragraph matching exact trimmed text,
- * and replace its text minimally.
- *
- * This op modifies header XML files inside the ZIP — not document.xml body.
- * It receives the PizZip instance from the orchestrator.
- */
-import PizZip from 'pizzip';
-import type { HeaderReplaceTextExactOp, OpResult } from '../types.js';
-export declare function applyHeaderReplaceTextExact(_body: Element, op: HeaderReplaceTextExactOp, zip: PizZip): OpResult;

package/dist/tools/docx/ops/header-replace-text-exact.js

@@ -1,55 +0,0 @@
-/**
- * Op: header_replace_text_exact
- *
- * Find ALL header XML files (word/header1.xml, header2.xml, …)
- * in the ZIP, locate the first paragraph matching exact trimmed text,
- * and replace its text minimally.
- *
- * This op modifies header XML files inside the ZIP — not document.xml body.
- * It receives the PizZip instance from the orchestrator.
- */
-import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
-import { nodeListToArray, getParagraphText, setParagraphTextMinimal } from '../dom.js';
-export function applyHeaderReplaceTextExact(_body, op, zip) {
-    const target = op.from.trim();
-    let totalMatched = 0;
-    // Iterate over all files in word/ looking for header*.xml
-    const files = zip.folder('word');
-    if (!files) {
-        return { op, status: 'skipped', matched: 0, reason: 'no_word_folder' };
-    }
-    // PizZip file listing
-    const headerPattern = /^word\/header\d+\.xml$/;
-    const allFiles = Object.keys(zip.files);
-    const headerPaths = allFiles.filter((f) => headerPattern.test(f));
-    if (headerPaths.length === 0) {
-        return { op, status: 'skipped', matched: 0, reason: 'no_header_files' };
-    }
-    for (const headerPath of headerPaths) {
-        const entry = zip.file(headerPath);
-        if (!entry)
-            continue;
-        const xmlStr = entry.asText();
-        const dom = new DOMParser().parseFromString(xmlStr, 'application/xml');
-        // Find all w:p elements in the header
-        const paragraphs = dom.getElementsByTagName('w:p');
-        let modified = false;
-        for (const p of nodeListToArray(paragraphs)) {
-            const pEl = p;
-            if (getParagraphText(pEl).trim() === target) {
-                setParagraphTextMinimal(pEl, op.to);
-                totalMatched++;
-                modified = true;
-                break; // first match per header file
-            }
-        }
-        if (modified) {
-            const newXml = new XMLSerializer().serializeToString(dom);
-            zip.file(headerPath, newXml);
-        }
-    }
-    if (totalMatched === 0) {
-        return { op, status: 'skipped', matched: 0, reason: 'no_match_in_headers' };
-    }
-    return { op, status: 'applied', matched: totalMatched };
-}

package/dist/tools/docx/ops/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * Op dispatcher — routes each op to its implementation.
- *
- * Open/Closed Principle: adding a new op type requires only
- * a new file + one extra case here; existing ops stay untouched.
- */
-import PizZip from 'pizzip';
-import type { DocxOp, OpResult } from '../types.js';
-/**
- * Apply a single operation.
- *
- * @param body   The w:body element (for DOM-based body ops)
- * @param op     The operation descriptor
- * @param zip    Optional PizZip instance — required for ops that modify
- *               files outside word/document.xml (e.g. hyperlinks, headers)
- */
-export declare function applyOp(body: Element, op: DocxOp, zip?: PizZip): OpResult;

package/dist/tools/docx/ops/index.js

@@ -1,70 +0,0 @@
-/**
- * Op dispatcher — routes each op to its implementation.
- *
- * Open/Closed Principle: adding a new op type requires only
- * a new file + one extra case here; existing ops stay untouched.
- */
-import { applyReplaceParagraphTextExact } from './replace-paragraph-text-exact.js';
-import { applyReplaceParagraphAtBodyIndex } from './replace-paragraph-at-body-index.js';
-import { applySetColorForStyle } from './set-color-for-style.js';
-import { applySetColorForParagraphExact } from './set-color-for-paragraph-exact.js';
-import { applySetParagraphStyleAtBodyIndex } from './set-paragraph-style-at-body-index.js';
-import { applyInsertParagraphAfterText } from './insert-paragraph-after-text.js';
-import { applyDeleteParagraphAtBodyIndex } from './delete-paragraph-at-body-index.js';
-import { applyTableSetCellText } from './table-set-cell-text.js';
-import { applyReplaceTableCellText } from './replace-table-cell-text.js';
-import { applyReplaceHyperlinkUrl } from './replace-hyperlink-url.js';
-import { applyHeaderReplaceTextExact } from './header-replace-text-exact.js';
-import { applyInsertTable } from './insert-table-after-text.js';
-import { applyInsertImage } from './insert-image-after-text.js';
-/**
- * Apply a single operation.
- *
- * @param body   The w:body element (for DOM-based body ops)
- * @param op     The operation descriptor
- * @param zip    Optional PizZip instance — required for ops that modify
- *               files outside word/document.xml (e.g. hyperlinks, headers)
- */
-export function applyOp(body, op, zip) {
-    switch (op.type) {
-        case 'replace_paragraph_text_exact':
-            return applyReplaceParagraphTextExact(body, op);
-        case 'replace_paragraph_at_body_index':
-            return applyReplaceParagraphAtBodyIndex(body, op);
-        case 'set_color_for_style':
-            return applySetColorForStyle(body, op);
-        case 'set_color_for_paragraph_exact':
-            return applySetColorForParagraphExact(body, op);
-        case 'set_paragraph_style_at_body_index':
-            return applySetParagraphStyleAtBodyIndex(body, op);
-        case 'insert_paragraph_after_text':
-            return applyInsertParagraphAfterText(body, op);
-        case 'delete_paragraph_at_body_index':
-            return applyDeleteParagraphAtBodyIndex(body, op);
-        case 'table_set_cell_text':
-            return applyTableSetCellText(body, op);
-        case 'replace_table_cell_text':
-            return applyReplaceTableCellText(body, op);
-        case 'replace_hyperlink_url':
-            if (!zip)
-                return { op, status: 'skipped', matched: 0, reason: 'zip_required_for_hyperlink_op' };
-            return applyReplaceHyperlinkUrl(body, op, zip);
-        case 'header_replace_text_exact':
-            if (!zip)
-                return { op, status: 'skipped', matched: 0, reason: 'zip_required_for_header_op' };
-            return applyHeaderReplaceTextExact(body, op, zip);
-        case 'insert_table':
-            return applyInsertTable(body, op);
-        case 'insert_image':
-            if (!zip)
-                return { op, status: 'skipped', matched: 0, reason: 'zip_required_for_image_op' };
-            return applyInsertImage(body, op, zip);
-        default:
-            return {
-                op,
-                status: 'skipped',
-                matched: 0,
-                reason: `unknown_op_type: ${op.type}`,
-            };
-    }
-}

package/dist/tools/docx/ops/insert-image-after-text.d.ts

@@ -1,24 +0,0 @@
-/**
- * Op: insert_image
- *
- * Insert an image into the DOCX relative to a paragraph anchor.
- *
- * Supports two positioning modes:
- *   - `after`  — insert immediately AFTER the first paragraph matching text
- *   - `before` — insert immediately BEFORE the first paragraph matching text
- *
- * Exactly one of `after` or `before` must be provided.
- *
- * The image is read from disk, added to word/media/ in the ZIP,
- * and a w:drawing reference is created inside a new paragraph.
- *
- * Requires the PizZip instance because it modifies:
- *   - word/media/imageN.ext  (binary blob)
- *   - word/_rels/document.xml.rels  (relationship entry)
- *   - [Content_Types].xml  (content-type override)
- *
- * This is a structural op — increases bodyChildCount by 1.
- */
-import PizZip from 'pizzip';
-import type { InsertImageOp, OpResult } from '../types.js';
-export declare function applyInsertImage(body: Element, op: InsertImageOp, zip: PizZip): OpResult;

package/dist/tools/docx/ops/insert-image-after-text.js

@@ -1,128 +0,0 @@
-/**
- * Op: insert_image
- *
- * Insert an image into the DOCX relative to a paragraph anchor.
- *
- * Supports two positioning modes:
- *   - `after`  — insert immediately AFTER the first paragraph matching text
- *   - `before` — insert immediately BEFORE the first paragraph matching text
- *
- * Exactly one of `after` or `before` must be provided.
- *
- * The image is read from disk, added to word/media/ in the ZIP,
- * and a w:drawing reference is created inside a new paragraph.
- *
- * Requires the PizZip instance because it modifies:
- *   - word/media/imageN.ext  (binary blob)
- *   - word/_rels/document.xml.rels  (relationship entry)
- *   - [Content_Types].xml  (content-type override)
- *
- * This is a structural op — increases bodyChildCount by 1.
- */
-import fs from 'fs';
-import path from 'path';
-import { DOMParser } from '@xmldom/xmldom';
-import { getBodyChildren, getParagraphText } from '../dom.js';
-import { addImageRelationship, ensureContentType } from '../relationships.js';
-import { escapeXmlAttr } from '../builders/utils.js';
-import { pixelsToEmu, DEFAULT_IMAGE_WIDTH, DEFAULT_IMAGE_HEIGHT, NAMESPACES } from '../constants.js';
-// ─── Op implementation ───────────────────────────────────────────────
-export function applyInsertImage(body, op, zip) {
-    // ── Validate anchor ─────────────────────────────────────────────
-    const anchorText = op.before ?? op.after;
-    const position = op.before ? 'before' : 'after';
-    if (!anchorText) {
-        return { op, status: 'skipped', matched: 0, reason: 'no_anchor: provide "after" or "before"' };
-    }
-    // ── Validate image file exists ──────────────────────────────────
-    const imgPath = op.imagePath;
-    if (!fs.existsSync(imgPath)) {
-        return { op, status: 'skipped', matched: 0, reason: `image_not_found: ${imgPath}` };
-    }
-    // ── Find target paragraph ───────────────────────────────────────
-    const children = getBodyChildren(body);
-    const target = anchorText.trim();
-    for (let i = 0; i < children.length; i++) {
-        const child = children[i];
-        if (child.nodeName !== 'w:p')
-            continue;
-        if (getParagraphText(child).trim() === target) {
-            const doc = body.ownerDocument;
-            if (!doc)
-                return { op, status: 'skipped', matched: 0, reason: 'no_owner_document' };
-            // ── Read image (sync) ────────────────────────────────────
-            const imgBuffer = fs.readFileSync(imgPath);
-            const ext = path.extname(imgPath).toLowerCase();
-            const baseName = path.basename(imgPath);
-            // ── Find next available media filename ────────────────────
-            let mediaIndex = 1;
-            while (zip.file(`word/media/image${mediaIndex}${ext}`)) {
-                mediaIndex++;
-            }
-            const mediaFileName = `image${mediaIndex}${ext}`;
-            // ── Add image to ZIP ──────────────────────────────────────
-            zip.file(`word/media/${mediaFileName}`, imgBuffer);
-            // ── Add relationship ─────────────────────────────────────
-            const rId = addImageRelationship(zip, mediaFileName);
-            // ── Ensure Content_Types entry ───────────────────────────
-            ensureContentType(zip, ext);
-            // ── Compute dimensions (EMU) ─────────────────────────────
-            const widthPx = op.width ?? DEFAULT_IMAGE_WIDTH;
-            const heightPx = op.height ?? DEFAULT_IMAGE_HEIGHT;
-            const widthEmu = pixelsToEmu(widthPx);
-            const heightEmu = pixelsToEmu(heightPx);
-            // ── Build drawing XML ────────────────────────────────────
-            const altText = op.altText ?? baseName;
-            const drawingXmlStr = buildDrawingXml(rId, widthEmu, heightEmu, altText, mediaFileName);
-            // ── Parse drawing XML into a paragraph ───────────────────
-            const drawingFragment = new DOMParser().parseFromString(`<w:p xmlns:w="${NAMESPACES.W}">` +
-                `<w:r>${drawingXmlStr}</w:r></w:p>`, 'application/xml');
-            const imgP = doc.importNode(drawingFragment.documentElement, true);
-            // ── Insert at the correct position ──────────────────────
-            if (position === 'before') {
-                // Insert BEFORE the matched paragraph
-                body.insertBefore(imgP, child);
-            }
-            else {
-                // Insert AFTER the matched paragraph
-                const nextSibling = child.nextSibling;
-                if (nextSibling) {
-                    body.insertBefore(imgP, nextSibling);
-                }
-                else {
-                    body.appendChild(imgP);
-                }
-            }
-            return { op, status: 'applied', matched: 1 };
-        }
-    }
-    return { op, status: 'skipped', matched: 0, reason: 'no_match' };
-}
-// ─── Drawing XML builder (shared with builders/image.ts) ────────────────
-function buildDrawingXml(rId, widthEmu, heightEmu, altText, fileName) {
-    return (`<w:drawing xmlns:w="${NAMESPACES.W}">` +
-        `<wp:inline distT="0" distB="0" distL="0" distR="0" ` +
-        `xmlns:wp="${NAMESPACES.WP}">` +
-        `<wp:extent cx="${widthEmu}" cy="${heightEmu}"/>` +
-        `<wp:docPr id="1" name="${fileName}" descr="${escapeXmlAttr(altText)}"/>` +
-        `<a:graphic xmlns:a="${NAMESPACES.A}">` +
-        `<a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/picture">` +
-        `<pic:pic xmlns:pic="${NAMESPACES.PIC}">` +
-        `<pic:nvPicPr>` +
-        `<pic:cNvPr id="0" name="${fileName}" descr="${escapeXmlAttr(altText)}"/>` +
-        `<pic:cNvPicPr/>` +
-        `</pic:nvPicPr>` +
-        `<pic:blipFill>` +
-        `<a:blip r:embed="${rId}" xmlns:r="${NAMESPACES.R}"/>` +
-        `<a:stretch><a:fillRect/></a:stretch>` +
-        `</pic:blipFill>` +
-        `<pic:spPr>` +
-        `<a:xfrm><a:off x="0" y="0"/><a:ext cx="${widthEmu}" cy="${heightEmu}"/></a:xfrm>` +
-        `<a:prstGeom prst="rect"><a:avLst/></a:prstGeom>` +
-        `</pic:spPr>` +
-        `</pic:pic>` +
-        `</a:graphicData>` +
-        `</a:graphic>` +
-        `</wp:inline>` +
-        `</w:drawing>`);
-}

package/dist/tools/docx/ops/insert-paragraph-after-text.d.ts

@@ -1,12 +0,0 @@
-/**
- * Op: insert_paragraph_after_text
- *
- * Find the FIRST paragraph whose trimmed text === `after`, then insert
- * a new w:p immediately after it.  Optionally applies a style to the
- * new paragraph.
- *
- * NOTE: This is a structural op — it increases bodyChildCount by 1.
- * The orchestrator must account for this when validating invariants.
- */
-import type { InsertParagraphAfterTextOp, OpResult } from '../types.js';
-export declare function applyInsertParagraphAfterText(body: Element, op: InsertParagraphAfterTextOp): OpResult;

package/dist/tools/docx/ops/insert-paragraph-after-text.js

@@ -1,74 +0,0 @@
-/**
- * Op: insert_paragraph_after_text
- *
- * Find the FIRST paragraph whose trimmed text === `after`, then insert
- * a new w:p immediately after it.  Optionally applies a style to the
- * new paragraph.
- *
- * NOTE: This is a structural op — it increases bodyChildCount by 1.
- * The orchestrator must account for this when validating invariants.
- */
-import { getBodyChildren, getParagraphText } from '../dom.js';
-export function applyInsertParagraphAfterText(body, op) {
-    const children = getBodyChildren(body);
-    const target = op.after.trim();
-    // Special case: if document is empty, append the paragraph
-    if (children.length === 0) {
-        const doc = body.ownerDocument;
-        if (!doc)
-            return { op, status: 'skipped', matched: 0, reason: 'no_owner_document' };
-        const newP = doc.createElement('w:p');
-        if (op.style) {
-            const pPr = doc.createElement('w:pPr');
-            const pStyle = doc.createElement('w:pStyle');
-            pStyle.setAttribute('w:val', op.style);
-            pPr.appendChild(pStyle);
-            newP.appendChild(pPr);
-        }
-        const newR = doc.createElement('w:r');
-        const newT = doc.createElement('w:t');
-        newT.setAttribute('xml:space', 'preserve');
-        newT.textContent = op.text;
-        newR.appendChild(newT);
-        newP.appendChild(newR);
-        body.appendChild(newP);
-        return { op, status: 'applied', matched: 0, reason: 'empty_document_append' };
-    }
-    // Normal case: find matching paragraph
-    for (let i = 0; i < children.length; i++) {
-        const child = children[i];
-        if (child.nodeName !== 'w:p')
-            continue;
-        if (getParagraphText(child).trim() === target) {
-            const doc = body.ownerDocument;
-            if (!doc)
-                return { op, status: 'skipped', matched: 0, reason: 'no_owner_document' };
-            // Build new paragraph: <w:p><w:r><w:t>text</w:t></w:r></w:p>
-            const newP = doc.createElement('w:p');
-            // Optionally set style
-            if (op.style) {
-                const pPr = doc.createElement('w:pPr');
-                const pStyle = doc.createElement('w:pStyle');
-                pStyle.setAttribute('w:val', op.style);
-                pPr.appendChild(pStyle);
-                newP.appendChild(pPr);
-            }
-            const newR = doc.createElement('w:r');
-            const newT = doc.createElement('w:t');
-            newT.setAttribute('xml:space', 'preserve');
-            newT.textContent = op.text;
-            newR.appendChild(newT);
-            newP.appendChild(newR);
-            // Insert after the matched child
-            const nextSibling = child.nextSibling;
-            if (nextSibling) {
-                body.insertBefore(newP, nextSibling);
-            }
-            else {
-                body.appendChild(newP);
-            }
-            return { op, status: 'applied', matched: 1 };
-        }
-    }
-    return { op, status: 'skipped', matched: 0, reason: 'no_match' };
-}

package/dist/tools/docx/ops/insert-table-after-text.d.ts

@@ -1,19 +0,0 @@
-/**
- * Op: insert_table
- *
- * Insert a new w:tbl (table) relative to a paragraph anchor.
- *
- * Supports two positioning modes:
- *   - `after`  — insert immediately AFTER the first paragraph matching text
- *   - `before` — insert immediately BEFORE the first paragraph matching text
- *
- * Exactly one of `after` or `before` must be provided.
- *
- * Accepts `headers` (optional) and `rows` as string arrays.
- * Optionally accepts `colWidths` (array of numbers in twips).
- *
- * This is a structural op — increases bodyChildCount by 1.
- * The orchestrator must account for this when validating invariants.
- */
-import type { InsertTableOp, OpResult } from '../types.js';
-export declare function applyInsertTable(body: Element, op: InsertTableOp): OpResult;

package/dist/tools/docx/ops/insert-table-after-text.js

@@ -1,57 +0,0 @@
-/**
- * Op: insert_table
- *
- * Insert a new w:tbl (table) relative to a paragraph anchor.
- *
- * Supports two positioning modes:
- *   - `after`  — insert immediately AFTER the first paragraph matching text
- *   - `before` — insert immediately BEFORE the first paragraph matching text
- *
- * Exactly one of `after` or `before` must be provided.
- *
- * Accepts `headers` (optional) and `rows` as string arrays.
- * Optionally accepts `colWidths` (array of numbers in twips).
- *
- * This is a structural op — increases bodyChildCount by 1.
- * The orchestrator must account for this when validating invariants.
- */
-import { getBodyChildren, getParagraphText } from '../dom.js';
-import { buildTable } from '../builders/index.js';
-// ─── Op implementation ───────────────────────────────────────────────
-export function applyInsertTable(body, op) {
-    // Determine anchor text and position
-    const anchorText = op.before ?? op.after;
-    const position = op.before ? 'before' : 'after';
-    if (!anchorText) {
-        return { op, status: 'skipped', matched: 0, reason: 'no_anchor: provide "after" or "before"' };
-    }
-    const children = getBodyChildren(body);
-    const target = anchorText.trim();
-    for (let i = 0; i < children.length; i++) {
-        const child = children[i];
-        if (child.nodeName !== 'w:p')
-            continue;
-        if (getParagraphText(child).trim() === target) {
-            const doc = body.ownerDocument;
-            if (!doc)
-                return { op, status: 'skipped', matched: 0, reason: 'no_owner_document' };
-            const tbl = buildTable(doc, op);
-            if (position === 'before') {
-                // Insert BEFORE the matched paragraph
-                body.insertBefore(tbl, child);
-            }
-            else {
-                // Insert AFTER the matched paragraph
-                const nextSibling = child.nextSibling;
-                if (nextSibling) {
-                    body.insertBefore(tbl, nextSibling);
-                }
-                else {
-                    body.appendChild(tbl);
-                }
-            }
-            return { op, status: 'applied', matched: 1 };
-        }
-    }
-    return { op, status: 'skipped', matched: 0, reason: 'no_match' };
-}

package/dist/tools/docx/ops/replace-hyperlink-url.d.ts

@@ -1,12 +0,0 @@
-/**
- * Op: replace_hyperlink_url
- *
- * Find all hyperlink relationships in word/_rels/document.xml.rels
- * whose Target matches `oldUrl` and replace with `newUrl`.
- *
- * This op modifies the .rels file inside the ZIP — not document.xml body.
- * It receives the PizZip instance from the orchestrator.
- */
-import PizZip from 'pizzip';
-import type { ReplaceHyperlinkUrlOp, OpResult } from '../types.js';
-export declare function applyReplaceHyperlinkUrl(_body: Element, op: ReplaceHyperlinkUrlOp, zip: PizZip): OpResult;

package/dist/tools/docx/ops/replace-hyperlink-url.js

@@ -1,37 +0,0 @@
-/**
- * Op: replace_hyperlink_url
- *
- * Find all hyperlink relationships in word/_rels/document.xml.rels
- * whose Target matches `oldUrl` and replace with `newUrl`.
- *
- * This op modifies the .rels file inside the ZIP — not document.xml body.
- * It receives the PizZip instance from the orchestrator.
- */
-import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
-import { nodeListToArray } from '../dom.js';
-export function applyReplaceHyperlinkUrl(_body, op, zip) {
-    const relsPath = 'word/_rels/document.xml.rels';
-    const relsEntry = zip.file(relsPath);
-    if (!relsEntry) {
-        return { op, status: 'skipped', matched: 0, reason: 'no_rels_file' };
-    }
-    const relsXml = relsEntry.asText();
-    const relsDom = new DOMParser().parseFromString(relsXml, 'application/xml');
-    const relationships = relsDom.getElementsByTagName('Relationship');
-    let matched = 0;
-    for (const rel of nodeListToArray(relationships)) {
-        const relEl = rel;
-        const target = relEl.getAttribute('Target');
-        if (target === op.oldUrl) {
-            relEl.setAttribute('Target', op.newUrl);
-            matched++;
-        }
-    }
-    if (matched === 0) {
-        return { op, status: 'skipped', matched: 0, reason: 'url_not_found' };
-    }
-    // Write modified .rels back to zip
-    const newRelsXml = new XMLSerializer().serializeToString(relsDom);
-    zip.file(relsPath, newRelsXml);
-    return { op, status: 'applied', matched };
-}

package/dist/tools/docx/ops/replace-paragraph-at-body-index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Op: replace_paragraph_at_body_index
- *
- * Target the child of w:body at the given bodyChildIndex.
- * If it is not a w:p → skip with reason "not_a_paragraph".
- * Otherwise apply the same minimal text replacement.
- */
-import type { ReplaceParagraphAtBodyIndexOp, OpResult } from '../types.js';
-export declare function applyReplaceParagraphAtBodyIndex(body: Element, op: ReplaceParagraphAtBodyIndexOp): OpResult;

package/dist/tools/docx/ops/replace-paragraph-at-body-index.js

@@ -1,25 +0,0 @@
-/**
- * Op: replace_paragraph_at_body_index
- *
- * Target the child of w:body at the given bodyChildIndex.
- * If it is not a w:p → skip with reason "not_a_paragraph".
- * Otherwise apply the same minimal text replacement.
- */
-import { getBodyChildren, setParagraphTextMinimal } from '../dom.js';
-export function applyReplaceParagraphAtBodyIndex(body, op) {
-    const children = getBodyChildren(body);
-    if (op.bodyChildIndex < 0 || op.bodyChildIndex >= children.length) {
-        return {
-            op,
-            status: 'skipped',
-            matched: 0,
-            reason: `bodyChildIndex ${op.bodyChildIndex} out of range (0..${children.length - 1})`,
-        };
-    }
-    const child = children[op.bodyChildIndex];
-    if (child.nodeName !== 'w:p') {
-        return { op, status: 'skipped', matched: 0, reason: 'not_a_paragraph' };
-    }
-    setParagraphTextMinimal(child, op.to);
-    return { op, status: 'applied', matched: 1 };
-}

package/dist/tools/docx/ops/replace-paragraph-text-exact.d.ts

@@ -1,21 +0,0 @@
-/**
- * Op: replace_paragraph_text_exact
- *
- * Find FIRST paragraph whose trimmed text === `from` **anywhere in the body**,
- * including paragraphs inside table cells, content controls, etc.
- *
- * Replacement behavior:
- * - Replaces the matched paragraph's text while preserving all its run styles
- * - Preserves all other paragraphs in the same cell (if the paragraph is in a table cell)
- * - Preserves paragraph properties (w:pPr) and run properties (w:rPr)
- *
- * This is useful when you want to replace a specific paragraph by its exact text,
- * especially in table cells where you want to replace one paragraph while keeping
- * others intact. For example, replacing "LAWN AND LANDSCAPE" with "EARTH AND MOUNTAIN"
- * in a cell that also contains a subtitle paragraph will preserve the subtitle.
- *
- * Note: For replacing entire cell content (matching by full cell text), use
- * `replace_table_cell_text` instead.
- */
-import type { ReplaceParagraphTextExactOp, OpResult } from '../types.js';
-export declare function applyReplaceParagraphTextExact(body: Element, op: ReplaceParagraphTextExactOp): OpResult;

package/dist/tools/docx/ops/replace-paragraph-text-exact.js

@@ -1,36 +0,0 @@
-/**
- * Op: replace_paragraph_text_exact
- *
- * Find FIRST paragraph whose trimmed text === `from` **anywhere in the body**,
- * including paragraphs inside table cells, content controls, etc.
- *
- * Replacement behavior:
- * - Replaces the matched paragraph's text while preserving all its run styles
- * - Preserves all other paragraphs in the same cell (if the paragraph is in a table cell)
- * - Preserves paragraph properties (w:pPr) and run properties (w:rPr)
- *
- * This is useful when you want to replace a specific paragraph by its exact text,
- * especially in table cells where you want to replace one paragraph while keeping
- * others intact. For example, replacing "LAWN AND LANDSCAPE" with "EARTH AND MOUNTAIN"
- * in a cell that also contains a subtitle paragraph will preserve the subtitle.
- *
- * Note: For replacing entire cell content (matching by full cell text), use
- * `replace_table_cell_text` instead.
- */
-import { getParagraphText, setParagraphTextPreservingStyles } from '../dom.js';
-export function applyReplaceParagraphTextExact(body, op) {
-    const target = op.from.trim();
-    // Traverse **all** paragraphs in the body, not just direct body children.
-    // This includes paragraphs inside table cells, content controls, etc.
-    const paragraphs = body.getElementsByTagName('w:p');
-    for (let i = 0; i < paragraphs.length; i++) {
-        const p = paragraphs.item(i);
-        const paragraphText = getParagraphText(p).trim();
-        if (paragraphText === target) {
-            // Preserve all run styles (colors, bold, italic, etc.) when replacing
-            setParagraphTextPreservingStyles(p, op.to);
-            return { op, status: 'applied', matched: 1 };
-        }
-    }
-    return { op, status: 'skipped', matched: 0, reason: 'no_match' };
-}

package/dist/tools/docx/ops/replace-table-cell-text.d.ts

@@ -1,25 +0,0 @@
-/**
- * Op: replace_table_cell_text
- *
- * Goal: Replace the "logical value" of a cell while preserving layout and styles.
- *
- * Matching strategy (tried in order):
- * 1. Match by full cell text (all paragraphs joined with spaces)
- * 2. Match by first paragraph text only
- *
- * When the caller passes FULL cell text in `from` / `to` (common for LLMs), we
- * interpret the change like this:
- *
- *   from: "<OLD_TITLE> <SUBTITLE ...>"
- *   to:   "<NEW_TITLE> <SUBTITLE ...>"
- *
- * i.e. only the *title* (first paragraph) changed, the rest of the cell content
- * stayed the same. We detect the unchanged suffix and compute NEW_TITLE by
- * stripping that suffix from `to`. Then we only change the first paragraph text,
- * keeping all other paragraphs (subtitle, etc.) exactly as they were.
- *
- * If we cannot safely detect that pattern, we fall back to treating `from`/`to`
- * as simple first‑paragraph values.
- */
-import type { ReplaceTableCellTextOp, OpResult } from '../types.js';
-export declare function applyReplaceTableCellText(body: Element, op: ReplaceTableCellTextOp): OpResult;