@ansonlai/docx-redline-js 0.7.2 → 0.8.1

package/index.js

@@ -1,340 +1,349 @@
-/**
- * Standalone reconciliation entrypoint (no Word JS API dependencies).
- */
-
-// Adapters
-export { configureXmlProvider, parseOoxmlSafe } from './adapters/xml-adapter.js';
-export { configureLogger } from './adapters/logger.js';
-export { setDefaultAuthor, getDefaultAuthor, setPlatform, getPlatform } from './adapters/config.js';
-
-// Engine
-import {
-    applyRedlineToOxml as applyRedlineToOxmlEngine,
-    sanitizeAiResponse,
-    parseOoxml,
-    serializeOoxml
-} from './engine/oxml-engine.js';
-import { parseTable as parseMarkdownTable } from './pipeline/pipeline.js';
-import { wrapInDocumentFragment as wrapInDocumentFragmentShared } from './pipeline/serialization.js';
-import {
-    buildSingleLineListStructuralFallbackPlan,
-    executeSingleLineListStructuralFallback
-} from './orchestration/list-structural-fallback.js';
-import { withOoxmlSourceType } from './core/word-xml.js';
-export { containsTrackedChanges, getTrackedChangeAuthors } from './core/word-xml.js';
-export { validateRedlineOoxml } from './core/redline-validation.js';
-export { analyzeStructuredContent, planStructuredReplacement } from './pipeline/structured-content.js';
-
-/**
- * Standalone-safe redline wrapper.
- *
- * In non-Word runtimes, the engine can return `{ useNativeApi: true, hasChanges: true }`
- * without an OOXML payload for some format-only operations. Standalone callers cannot
- * complete that native fallback path, so normalize to a no-op with warnings.
- */
-export async function applyRedlineToOxml(oxml, originalText, modifiedText, options = {}) {
-    const result = await applyRedlineToOxmlEngine(oxml, originalText, modifiedText, options);
-    if (result?.useNativeApi && typeof result?.oxml !== 'string') {
-        const existingWarnings = Array.isArray(result?.warnings) ? result.warnings : [];
-        return withOoxmlSourceType({
-            ...result,
-            oxml,
-            hasChanges: false,
-            warnings: [
-                ...existingWarnings,
-                'Standalone mode cannot execute native Word API fallback for this operation.'
-            ]
-        });
-    }
-    return result;
-}
-
-/**
- * Reconciles a Markdown table against an OOXML scope.
- *
- * This centralizes table-specific validation + reconciliation so Word add-in
- * and browser modules can share the same entrypoint.
- *
- * @param {string} oxml - OOXML scope to reconcile (paragraph/range/table package)
- * @param {string} originalText - Original visible text in that scope
- * @param {string} markdownTable - Markdown table text
- * @param {Object} [options={}] - Reconciliation options forwarded to applyRedlineToOxml
- * @returns {Promise<{ oxml: string, hasChanges: boolean, warnings?: string[], isMarkdownTable: boolean, tableData?: Object }>}
- */
-export async function reconcileMarkdownTableOoxml(oxml, originalText, markdownTable, options = {}) {
-    const sourceOoxml = typeof oxml === 'string' ? oxml : '';
-    const tableText = typeof markdownTable === 'string' ? markdownTable : String(markdownTable || '');
-    let tableData;
-
-    try {
-        tableData = parseMarkdownTable(tableText);
-    } catch {
-        tableData = { headers: [], rows: [] };
-    }
-
-    const hasTableData = (tableData?.headers?.length || 0) > 0 || (tableData?.rows?.length || 0) > 0;
-    if (!hasTableData) {
-        return {
-            oxml: sourceOoxml,
-            hasChanges: false,
-            isMarkdownTable: false,
-            warnings: ['Could not parse Markdown table from input.']
-        };
-    }
-
-    const result = await applyRedlineToOxml(
-        sourceOoxml,
-        originalText || '',
-        tableText,
-        options
-    );
-
-    return {
-        ...result,
-        isMarkdownTable: true,
-        tableData
-    };
-}
-
-export { resolveParagraphRangeByRefs } from './core/paragraph-targeting.js';
-export { inferTableReplacementParagraphBlock, isLikelyStructuredTableSourceParagraph } from './core/table-targeting.js';
-
-/**
- * Applies redline reconciliation, then forces single-line structural list
- * conversion when the redline is a no-op on marker-prefixed list text.
- *
- * This is useful for inputs like `1. HEADER` where text diff is unchanged but
- * OOXML should convert plain text markers into real Word list structure.
- *
- * @param {string} oxml - Original OOXML
- * @param {string} originalText - Original visible text
- * @param {string} modifiedText - Proposed modified text
- * @param {Object} [options={}] - Reconciliation options
- * @param {boolean} [options.listFallbackAllowExistingList=true] - Allow fallback even when paragraph is already list-bound
- * @returns {Promise<{ oxml: string, hasChanges: boolean } & Record<string, any>>}
- */
-export async function applyRedlineToOxmlWithListFallback(oxml, originalText, modifiedText, options = {}) {
-    const allowExistingListForFallback = options.listFallbackAllowExistingList !== false;
-    const fallbackModifiedText = options.sanitizeInput === true ? sanitizeAiResponse(modifiedText) : modifiedText;
-    const sanitizationWarnings = fallbackModifiedText !== modifiedText
-        ? ['Input was sanitized; pass sanitizeInput: false to disable.']
-        : [];
-    const plan = buildSingleLineListStructuralFallbackPlan({
-        oxml,
-        originalText,
-        modifiedText: fallbackModifiedText,
-        allowExistingList: allowExistingListForFallback
-    });
-    const preferListFallback = options.preferListStructuralFallback !== false;
-    let preflightFallbackWarnings = [];
-
-    if (plan && preferListFallback) {
-        const fallbackResult = await executeSingleLineListStructuralFallback(plan, {
-            author: options.author,
-            generateRedlines: options.generateRedlines,
-            pipeline: options.listFallbackPipeline
-        });
-        if (fallbackResult?.hasChanges && fallbackResult?.oxml) {
-            const wrappedOxml = wrapInDocumentFragmentShared(fallbackResult.oxml, {
-                includeNumbering: fallbackResult.includeNumbering ?? true,
-                numberingXml: fallbackResult.numberingXml
-            });
-            const fallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
-            return withOoxmlSourceType({
-                oxml: wrappedOxml,
-                hasChanges: true,
-                warnings: [...sanitizationWarnings, ...fallbackWarnings],
-                listStructuralFallbackApplied: true,
-                listStructuralFallbackKey: fallbackResult.listStructuralFallbackKey || null,
-                listStructuralFallbackNumberingXml: fallbackResult.numberingXml || null
-            });
-        }
-        preflightFallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
-    }
-
-    const baseResult = await applyRedlineToOxml(oxml, originalText, modifiedText, options);
-
-    if (!plan) {
-        return {
-            ...baseResult,
-            warnings: [
-                ...(Array.isArray(baseResult?.warnings) ? baseResult.warnings : []),
-                ...preflightFallbackWarnings
-            ],
-            listStructuralFallbackApplied: false
-        };
-    }
-
-    if (preferListFallback) {
-        return {
-            ...baseResult,
-            warnings: [
-                ...(Array.isArray(baseResult?.warnings) ? baseResult.warnings : []),
-                ...preflightFallbackWarnings
-            ],
-            listStructuralFallbackApplied: false
-        };
-    }
-
-    if (baseResult?.hasChanges) {
-        return {
-            ...baseResult,
-            listStructuralFallbackApplied: false
-        };
-    }
-
-    const fallbackResult = await executeSingleLineListStructuralFallback(plan, {
-        author: options.author,
-        generateRedlines: options.generateRedlines,
-        pipeline: options.listFallbackPipeline
-    });
-    if (!fallbackResult?.hasChanges || !fallbackResult?.oxml) {
-        const existingWarnings = Array.isArray(baseResult?.warnings) ? baseResult.warnings : [];
-        const fallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
-        return {
-            ...baseResult,
-            warnings: [...existingWarnings, ...fallbackWarnings],
-            listStructuralFallbackApplied: false
-        };
-    }
-
-    const wrappedOxml = wrapInDocumentFragmentShared(fallbackResult.oxml, {
-        includeNumbering: fallbackResult.includeNumbering ?? true,
-        numberingXml: fallbackResult.numberingXml
-    });
-    const existingWarnings = Array.isArray(baseResult?.warnings) ? baseResult.warnings : [];
-    const fallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
-
-    return withOoxmlSourceType({
-        ...baseResult,
-        oxml: wrappedOxml,
-        hasChanges: true,
-        warnings: [...existingWarnings, ...preflightFallbackWarnings, ...fallbackWarnings],
-        listStructuralFallbackApplied: true,
-        listStructuralFallbackKey: fallbackResult.listStructuralFallbackKey || null,
-        listStructuralFallbackNumberingXml: fallbackResult.numberingXml || null
-    });
-}
-
-export { sanitizeAiResponse, parseOoxml, serializeOoxml };
-
-export {
-    createDynamicNumberingIdState,
-    reserveNextNumberingId,
-    reserveNextNumberingIdPair,
-    overwriteParagraphNumIds,
-    extractFirstParagraphNumId,
-    buildExplicitDecimalMultilevelNumberingXml,
-    remapNumberingPayloadForDocument,
-    mergeNumberingXmlBySchemaOrder
-} from './services/numbering-helpers.js';
-
-// Pipeline components
-export { ReconciliationPipeline } from './pipeline/pipeline.js';
-export { ingestOoxml } from './pipeline/ingestion.js';
-export {
-    ingestWordOoxmlToPlainText,
-    ingestWordOoxmlToMarkdown,
-    ingestWordOoxmlToPlainTextResult,
-    ingestWordOoxmlToMarkdownResult
-} from './pipeline/ingestion-export.js';
-export { extractCanonicalParagraphText, readCanonicalRunText, isNodeVisibleInRevisionView, extractParagraphRevisionSegments } from './core/paragraph-text.js';
-export { inspectDocumentParts } from './services/document-inspection.js';
-export {
-    buildRevisionTokenFraming,
-    computeRevisionToken,
-    computeRevisionTokenSync,
-    computeDocumentPartsRevisionToken,
-    validateRevisionToken,
-    areRevisionTokensEqual,
-    normalizeOpcEntryName,
-    extractDocumentPartsEntries
-} from './services/revision-token.js';
-export { preprocessMarkdown } from './pipeline/markdown-processor.js';
-export { serializeToOoxml, wrapInDocumentFragment } from './pipeline/serialization.js';
-
-// Comment engine
-export {
-    injectCommentsIntoOoxml,
-    injectCommentsIntoPackage,
-    buildCommentElement,
-    buildCommentsPartXml
-} from './services/comment-engine.js';
-export { applyCommentReplyToParts } from './services/comment-replies.js';
-export {
-    acceptTrackedChangesInOoxml,
-    rejectTrackedChangesInOoxml,
-    deleteCommentsByAuthorInOoxml
-} from './services/revision-comment-management.js';
-
-// Formatting removal utilities
-export {
-    removeFormattingFromRPr,
-    applyFormattingRemovalToOoxml,
-    applyHighlightToOoxml
-} from './engine/formatting-removal.js';
-
-// Table/list tools
-export { generateTableOoxml } from './services/table-reconciliation.js';
-export { NumberingService } from './services/numbering-service.js';
-export {
-    getBodyElementFromDocument,
-    insertBodyElementBeforeSectPr,
-    normalizeBodySectionOrderStandalone,
-    sanitizeNestedParagraphsInTables,
-    getPackagePartName,
-    extractReplacementNodesFromOoxml,
-    ensureNumberingArtifactsInZip,
-    ensureCommentsArtifactsInZip,
-    ensureCommentsExtendedArtifactsInZip,
-    validateDocxPackage
-} from './services/standalone-docx-plumbing.js';
-export { buildReconciliationPlan, RoutePlanKind, normalizeContentEscapesForRouting } from './orchestration/route-plan.js';
-export { parseMarkdownListContent, hasListItems } from './orchestration/list-parsing.js';
-export { buildListMarkdown, inferNumberingStyleFromMarker, normalizeListItemsWithLevels } from './orchestration/list-markdown.js';
-export {
-    buildSingleLineListStructuralFallbackPlan,
-    executeSingleLineListStructuralFallback,
-    resolveSingleLineListFallbackNumberingAction,
-    recordSingleLineListFallbackExplicitSequence,
-    clearSingleLineListFallbackExplicitSequence,
-    enforceListBindingOnParagraphNodes,
-    stripSingleLineListMarkerPrefix
-} from './orchestration/list-structural-fallback.js';
-
-// Core types/constants
-export { DiffOp, RunKind, ContainerKind, ContentType, NS_W, escapeXml } from './core/types.js';
-export { extractParagraphIdFromOoxml } from './core/ooxml-identifiers.js';
-export {
-    WORD_MAIN_NS,
-    getParagraphText,
-    getParagraphId,
-    createParagraphFingerprint,
-    getDocumentParagraphNodes,
-    normalizeWhitespaceForTargeting,
-    isMarkdownTableText,
-    parseParagraphReference,
-    stripLeadingParagraphMarker,
-    splitLeadingParagraphMarker,
-    findContainingWordElement,
-    findParagraphByReference,
-    findParagraphByStrictText,
-    findParagraphByBestTextMatch,
-    findStrictTargetCandidates,
-    resolveTargetParagraph,
-    buildTargetReferenceSnapshot,
-    resolveTargetParagraphWithSnapshot
-} from './core/paragraph-targeting.js';
-export { synthesizeTableMarkdownFromMultilineCellEdit } from './core/table-targeting.js';
-export {
-    getParagraphListInfo,
-    collectContiguousListParagraphBlock,
-    synthesizeExpandedListScopeEdit,
-    planListInsertionOnlyEdit,
-    stripRedundantLeadingListMarkers
-} from './core/list-targeting.js';
-export {
-    ReceiptCollector,
-    createEmptyReceipt,
-    reconcileReceiptsAgainstOutput
-} from './services/receipt-collector.js';
+/**
+ * Standalone reconciliation entrypoint (no Word JS API dependencies).
+ */
+
+// Adapters
+export { configureXmlProvider, parseOoxmlSafe } from './adapters/xml-adapter.js';
+export { configureLogger } from './adapters/logger.js';
+export { setDefaultAuthor, getDefaultAuthor, setPlatform, getPlatform } from './adapters/config.js';
+
+// Engine
+import {
+    applyRedlineToOxml as applyRedlineToOxmlEngine,
+    sanitizeAiResponse,
+    parseOoxml,
+    serializeOoxml
+} from './engine/oxml-engine.js';
+import { parseTable as parseMarkdownTable } from './pipeline/pipeline.js';
+import { wrapInDocumentFragment as wrapInDocumentFragmentShared } from './pipeline/serialization.js';
+import {
+    buildSingleLineListStructuralFallbackPlan,
+    executeSingleLineListStructuralFallback
+} from './orchestration/list-structural-fallback.js';
+import { withOoxmlSourceType } from './core/word-xml.js';
+export { containsTrackedChanges, getTrackedChangeAuthors } from './core/word-xml.js';
+export { validateRedlineOoxml } from './core/redline-validation.js';
+export { analyzeStructuredContent, planStructuredReplacement } from './pipeline/structured-content.js';
+
+/**
+ * Standalone-safe redline wrapper.
+ *
+ * In non-Word runtimes, the engine can return `{ useNativeApi: true, hasChanges: true }`
+ * without an OOXML payload for some format-only operations. Standalone callers cannot
+ * complete that native fallback path, so normalize to a no-op with warnings.
+ */
+export async function applyRedlineToOxml(oxml, originalText, modifiedText, options = {}) {
+    const result = await applyRedlineToOxmlEngine(oxml, originalText, modifiedText, options);
+    if (result?.useNativeApi && typeof result?.oxml !== 'string') {
+        const existingWarnings = Array.isArray(result?.warnings) ? result.warnings : [];
+        return withOoxmlSourceType({
+            ...result,
+            oxml,
+            hasChanges: false,
+            warnings: [
+                ...existingWarnings,
+                'Standalone mode cannot execute native Word API fallback for this operation.'
+            ]
+        });
+    }
+    return result;
+}
+
+/**
+ * Reconciles a Markdown table against an OOXML scope.
+ *
+ * This centralizes table-specific validation + reconciliation so Word add-in
+ * and browser modules can share the same entrypoint.
+ *
+ * @param {string} oxml - OOXML scope to reconcile (paragraph/range/table package)
+ * @param {string} originalText - Original visible text in that scope
+ * @param {string} markdownTable - Markdown table text
+ * @param {Object} [options={}] - Reconciliation options forwarded to applyRedlineToOxml
+ * @returns {Promise<{ oxml: string, hasChanges: boolean, warnings?: string[], isMarkdownTable: boolean, tableData?: Object }>}
+ */
+export async function reconcileMarkdownTableOoxml(oxml, originalText, markdownTable, options = {}) {
+    const sourceOoxml = typeof oxml === 'string' ? oxml : '';
+    const tableText = typeof markdownTable === 'string' ? markdownTable : String(markdownTable || '');
+    let tableData;
+
+    try {
+        tableData = parseMarkdownTable(tableText);
+    } catch {
+        tableData = { headers: [], rows: [] };
+    }
+
+    const hasTableData = (tableData?.headers?.length || 0) > 0 || (tableData?.rows?.length || 0) > 0;
+    if (!hasTableData) {
+        return {
+            oxml: sourceOoxml,
+            hasChanges: false,
+            isMarkdownTable: false,
+            warnings: ['Could not parse Markdown table from input.']
+        };
+    }
+
+    const result = await applyRedlineToOxml(
+        sourceOoxml,
+        originalText || '',
+        tableText,
+        options
+    );
+
+    return {
+        ...result,
+        isMarkdownTable: true,
+        tableData
+    };
+}
+
+export { resolveParagraphRangeByRefs } from './core/paragraph-targeting.js';
+export { inferTableReplacementParagraphBlock, isLikelyStructuredTableSourceParagraph } from './core/table-targeting.js';
+
+/**
+ * Applies redline reconciliation, then forces single-line structural list
+ * conversion when the redline is a no-op on marker-prefixed list text.
+ *
+ * This is useful for inputs like `1. HEADER` where text diff is unchanged but
+ * OOXML should convert plain text markers into real Word list structure.
+ *
+ * @param {string} oxml - Original OOXML
+ * @param {string} originalText - Original visible text
+ * @param {string} modifiedText - Proposed modified text
+ * @param {Object} [options={}] - Reconciliation options
+ * @param {boolean} [options.listFallbackAllowExistingList=true] - Allow fallback even when paragraph is already list-bound
+ * @returns {Promise<{ oxml: string, hasChanges: boolean } & Record<string, any>>}
+ */
+export async function applyRedlineToOxmlWithListFallback(oxml, originalText, modifiedText, options = {}) {
+    const allowExistingListForFallback = options.listFallbackAllowExistingList !== false;
+    const fallbackModifiedText = options.sanitizeInput === true ? sanitizeAiResponse(modifiedText) : modifiedText;
+    const sanitizationWarnings = fallbackModifiedText !== modifiedText
+        ? ['Input was sanitized; pass sanitizeInput: false to disable.']
+        : [];
+    const plan = buildSingleLineListStructuralFallbackPlan({
+        oxml,
+        originalText,
+        modifiedText: fallbackModifiedText,
+        allowExistingList: allowExistingListForFallback
+    });
+    const preferListFallback = options.preferListStructuralFallback !== false;
+    let preflightFallbackWarnings = [];
+
+    if (plan && preferListFallback) {
+        const fallbackResult = await executeSingleLineListStructuralFallback(plan, {
+            author: options.author,
+            generateRedlines: options.generateRedlines,
+            pipeline: options.listFallbackPipeline
+        });
+        if (fallbackResult?.hasChanges && fallbackResult?.oxml) {
+            const wrappedOxml = wrapInDocumentFragmentShared(fallbackResult.oxml, {
+                includeNumbering: fallbackResult.includeNumbering ?? true,
+                numberingXml: fallbackResult.numberingXml
+            });
+            const fallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
+            return withOoxmlSourceType({
+                oxml: wrappedOxml,
+                hasChanges: true,
+                warnings: [...sanitizationWarnings, ...fallbackWarnings],
+                listStructuralFallbackApplied: true,
+                listStructuralFallbackKey: fallbackResult.listStructuralFallbackKey || null,
+                listStructuralFallbackNumberingXml: fallbackResult.numberingXml || null
+            });
+        }
+        preflightFallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
+    }
+
+    const baseResult = await applyRedlineToOxml(oxml, originalText, modifiedText, options);
+
+    if (!plan) {
+        return {
+            ...baseResult,
+            warnings: [
+                ...(Array.isArray(baseResult?.warnings) ? baseResult.warnings : []),
+                ...preflightFallbackWarnings
+            ],
+            listStructuralFallbackApplied: false
+        };
+    }
+
+    if (preferListFallback) {
+        return {
+            ...baseResult,
+            warnings: [
+                ...(Array.isArray(baseResult?.warnings) ? baseResult.warnings : []),
+                ...preflightFallbackWarnings
+            ],
+            listStructuralFallbackApplied: false
+        };
+    }
+
+    if (baseResult?.hasChanges) {
+        return {
+            ...baseResult,
+            listStructuralFallbackApplied: false
+        };
+    }
+
+    const fallbackResult = await executeSingleLineListStructuralFallback(plan, {
+        author: options.author,
+        generateRedlines: options.generateRedlines,
+        pipeline: options.listFallbackPipeline
+    });
+    if (!fallbackResult?.hasChanges || !fallbackResult?.oxml) {
+        const existingWarnings = Array.isArray(baseResult?.warnings) ? baseResult.warnings : [];
+        const fallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
+        return {
+            ...baseResult,
+            warnings: [...existingWarnings, ...fallbackWarnings],
+            listStructuralFallbackApplied: false
+        };
+    }
+
+    const wrappedOxml = wrapInDocumentFragmentShared(fallbackResult.oxml, {
+        includeNumbering: fallbackResult.includeNumbering ?? true,
+        numberingXml: fallbackResult.numberingXml
+    });
+    const existingWarnings = Array.isArray(baseResult?.warnings) ? baseResult.warnings : [];
+    const fallbackWarnings = Array.isArray(fallbackResult?.warnings) ? fallbackResult.warnings : [];
+
+    return withOoxmlSourceType({
+        ...baseResult,
+        oxml: wrappedOxml,
+        hasChanges: true,
+        warnings: [...existingWarnings, ...preflightFallbackWarnings, ...fallbackWarnings],
+        listStructuralFallbackApplied: true,
+        listStructuralFallbackKey: fallbackResult.listStructuralFallbackKey || null,
+        listStructuralFallbackNumberingXml: fallbackResult.numberingXml || null
+    });
+}
+
+export { sanitizeAiResponse, parseOoxml, serializeOoxml };
+
+export {
+    createDynamicNumberingIdState,
+    reserveNextNumberingId,
+    reserveNextNumberingIdPair,
+    overwriteParagraphNumIds,
+    extractFirstParagraphNumId,
+    buildExplicitDecimalMultilevelNumberingXml,
+    remapNumberingPayloadForDocument,
+    mergeNumberingXmlBySchemaOrder
+} from './services/numbering-helpers.js';
+
+// Pipeline components
+export { ReconciliationPipeline } from './pipeline/pipeline.js';
+export { ingestOoxml } from './pipeline/ingestion.js';
+export {
+    ingestWordOoxmlToPlainText,
+    ingestWordOoxmlToMarkdown,
+    ingestWordOoxmlToPlainTextResult,
+    ingestWordOoxmlToMarkdownResult
+} from './pipeline/ingestion-export.js';
+export { extractCanonicalParagraphText, readCanonicalRunText, isNodeVisibleInRevisionView, extractParagraphRevisionSegments } from './core/paragraph-text.js';
+export { inspectDocumentParts } from './services/document-inspection.js';
+export {
+    buildRevisionTokenFraming,
+    computeRevisionToken,
+    computeRevisionTokenSync,
+    computeDocumentPartsRevisionToken,
+    validateRevisionToken,
+    areRevisionTokensEqual,
+    normalizeOpcEntryName,
+    extractDocumentPartsEntries
+} from './services/revision-token.js';
+export { preprocessMarkdown } from './pipeline/markdown-processor.js';
+export { serializeToOoxml, wrapInDocumentFragment } from './pipeline/serialization.js';
+
+// Comment engine
+export {
+    injectCommentsIntoOoxml,
+    injectCommentsIntoPackage,
+    buildCommentElement,
+    buildCommentsPartXml
+} from './services/comment-engine.js';
+export { applyCommentReplyToParts } from './services/comment-replies.js';
+export {
+    acceptTrackedChangesInOoxml,
+    rejectTrackedChangesInOoxml,
+    deleteCommentsByAuthorInOoxml
+} from './services/revision-comment-management.js';
+
+// Formatting removal utilities
+export {
+    removeFormattingFromRPr,
+    applyFormattingRemovalToOoxml,
+    applyHighlightToOoxml
+} from './engine/formatting-removal.js';
+
+// Table/list tools
+export { generateTableOoxml } from './services/table-reconciliation.js';
+export { NumberingService } from './services/numbering-service.js';
+export {
+    getBodyElementFromDocument,
+    insertBodyElementBeforeSectPr,
+    normalizeBodySectionOrderStandalone,
+    sanitizeNestedParagraphsInTables,
+    getPackagePartName,
+    extractReplacementNodesFromOoxml,
+    ensureNumberingArtifactsInZip,
+    ensureCommentsArtifactsInZip,
+    ensureCommentsExtendedArtifactsInZip,
+    repairKnownContentTypes,
+    validateDocxPackage
+} from './services/standalone-docx-plumbing.js';
+export { buildReconciliationPlan, RoutePlanKind, normalizeContentEscapesForRouting } from './orchestration/route-plan.js';
+export { parseMarkdownListContent, hasListItems } from './orchestration/list-parsing.js';
+export { buildListMarkdown, inferNumberingStyleFromMarker, normalizeListItemsWithLevels } from './orchestration/list-markdown.js';
+export {
+    buildSingleLineListStructuralFallbackPlan,
+    executeSingleLineListStructuralFallback,
+    resolveSingleLineListFallbackNumberingAction,
+    recordSingleLineListFallbackExplicitSequence,
+    clearSingleLineListFallbackExplicitSequence,
+    enforceListBindingOnParagraphNodes,
+    stripSingleLineListMarkerPrefix
+} from './orchestration/list-structural-fallback.js';
+
+// Core types/constants
+export { DiffOp, RunKind, ContainerKind, ContentType, NS_W, escapeXml } from './core/types.js';
+export { extractParagraphIdFromOoxml } from './core/ooxml-identifiers.js';
+export {
+    WORD_MAIN_NS,
+    getParagraphText,
+    getParagraphId,
+    createParagraphFingerprint,
+    getDocumentParagraphNodes,
+    normalizeWhitespaceForTargeting,
+    isMarkdownTableText,
+    parseParagraphReference,
+    stripLeadingParagraphMarker,
+    splitLeadingParagraphMarker,
+    findContainingWordElement,
+    findParagraphByReference,
+    findParagraphByStrictText,
+    findParagraphByBestTextMatch,
+    findStrictTargetCandidates,
+    resolveTargetParagraph,
+    buildTargetReferenceSnapshot,
+    resolveTargetParagraphWithSnapshot
+} from './core/paragraph-targeting.js';
+export { synthesizeTableMarkdownFromMultilineCellEdit } from './core/table-targeting.js';
+export {
+    getParagraphListInfo,
+    collectContiguousListParagraphBlock,
+    synthesizeExpandedListScopeEdit,
+    planListInsertionOnlyEdit,
+    stripRedundantLeadingListMarkers
+} from './core/list-targeting.js';
+export {
+    ReceiptCollector,
+    createEmptyReceipt,
+    reconcileReceiptsAgainstOutput
+} from './services/receipt-collector.js';
+
+// Universal Document Facade
+export {
+    DocxDocument,
+    openDocx,
+    computePackageRevisionToken
+} from './document/docx-document.js';
+