docxmlater 10.4.1 → 11.0.4

package/dist/types/settings-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-types.d.ts","sourceRoot":"","sources":["../../src/types/settings-types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,MAAM,WAAW,oBAAoB;IACnC,0BAA0B,EAAE,OAAO,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAKD,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAKD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"settings-types.d.ts","sourceRoot":"","sources":["../../src/types/settings-types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC3D,WAAW,EAAE,OAAO,CAAC;IAQrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAWd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,MAAM,WAAW,oBAAoB;IACnC,0BAA0B,EAAE,OAAO,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAM5B,UAAU,CAAC,EAAE,OAAO,CAAC;IAKrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAKD,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAKD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/settings-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings-types.js","sourceRoot":"","sources":["../../src/types/settings-types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Shared type definitions for document settings (settings.xml)\n *\n * These types are used by both Document.ts (in-memory state) and\n * DocumentGenerator.ts (XML generation) to ensure consistency.\n */\n\n/**\n * Document protection settings per ECMA-376 CT_DocProtect\n */\nexport interface DocumentProtection {\n  edit: 'readOnly' | 'comments' | 'trackedChanges' | 'forms';\n  enforcement: boolean;\n  cryptProviderType?: string;\n  cryptAlgorithmClass?: string;\n  cryptAlgorithmType?: string;\n  cryptAlgorithmSid?: number;\n  cryptSpinCount?: number;\n  hash?: string;\n  salt?: string;\n}\n\n/**\n * Revision view settings per ECMA-376 CT_TrackChangesView\n */\nexport interface RevisionViewSettings {\n  showInsertionsAndDeletions: boolean;\n  showFormatting: boolean;\n  showInkAnnotations: boolean;\n}\n\n/**\n * Track changes and related settings passed to DocumentGenerator.generateSettings()\n */\nexport interface TrackChangesSettings {\n  trackChangesEnabled?: boolean;\n  trackFormatting?: boolean;\n  revisionView?: RevisionViewSettings;\n  rsidRoot?: string;\n  rsids?: string[];\n  documentProtection?: DocumentProtection;\n}\n\n/**\n * Information about webSettings.xml per ECMA-376 CT_WebSettings\n */\nexport interface WebSettingsInfo {\n  divCount: number;\n  optimizeForBrowser: boolean;\n  allowPNG: boolean;\n  relyOnVML: boolean;\n  doNotRelyOnCSS: boolean;\n  doNotSaveAsSingleFile: boolean;\n  doNotOrganizeInFolder: boolean;\n  doNotUseLongFileNames: boolean;\n  pixelsPerInch?: number;\n  targetScreenSz?: string;\n  encoding?: string;\n}\n"]}
+{"version":3,"file":"settings-types.js","sourceRoot":"","sources":["../../src/types/settings-types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Shared type definitions for document settings (settings.xml)\n *\n * These types are used by both Document.ts (in-memory state) and\n * DocumentGenerator.ts (XML generation) to ensure consistency.\n */\n\n/**\n * Document protection settings per ECMA-376 CT_DocProtect\n */\nexport interface DocumentProtection {\n  edit: 'readOnly' | 'comments' | 'trackedChanges' | 'forms';\n  enforcement: boolean;\n  /**\n   * `w:formatting` per CT_DocProtect §17.15.1.29 — when true, formatting\n   * changes are still allowed even when edit protection is enforced.\n   * Directly relevant to the tracked-changes workflow: combined with\n   * `edit: 'trackedChanges'`, this forces all content edits to be tracked\n   * while still permitting formatting adjustments.\n   */\n  formatting?: boolean;\n  cryptProviderType?: string;\n  cryptAlgorithmClass?: string;\n  cryptAlgorithmType?: string;\n  cryptAlgorithmSid?: number;\n  cryptSpinCount?: number;\n  hash?: string;\n  salt?: string;\n  /**\n   * Modern crypto attributes per ISO/IEC 29500-4 §13 (Word 2013+):\n   * - `algorithmName` names the strong hash algorithm (e.g. \"SHA-512\"),\n   *   replacing the legacy `cryptAlgorithmSid` lookup-table reference.\n   * - `hashValue` is the base64-encoded password hash.\n   * - `saltValue` is the base64-encoded salt.\n   *\n   * These are emitted alongside / instead of the legacy `hash` / `salt`\n   * / `cryptAlgorithmSid` attributes. Previously dropped on round-trip.\n   */\n  algorithmName?: string;\n  hashValue?: string;\n  saltValue?: string;\n}\n\n/**\n * Revision view settings per ECMA-376 CT_TrackChangesView\n */\nexport interface RevisionViewSettings {\n  showInsertionsAndDeletions: boolean;\n  showFormatting: boolean;\n  showInkAnnotations: boolean;\n  /**\n   * `w:markup` per CT_TrackChangesView §17.15.1.77 — when false, all\n   * revision markup is hidden in the reviewer pane (no balloons, no\n   * strikethrough/inserted styling). Defaults to true when absent.\n   */\n  showMarkup?: boolean;\n  /**\n   * `w:comments` per CT_TrackChangesView §17.15.1.77 — when false,\n   * comment balloons are hidden. Defaults to true when absent.\n   */\n  showComments?: boolean;\n}\n\n/**\n * Track changes and related settings passed to DocumentGenerator.generateSettings()\n */\nexport interface TrackChangesSettings {\n  trackChangesEnabled?: boolean;\n  trackFormatting?: boolean;\n  revisionView?: RevisionViewSettings;\n  rsidRoot?: string;\n  rsids?: string[];\n  documentProtection?: DocumentProtection;\n}\n\n/**\n * Information about webSettings.xml per ECMA-376 CT_WebSettings\n */\nexport interface WebSettingsInfo {\n  divCount: number;\n  optimizeForBrowser: boolean;\n  allowPNG: boolean;\n  relyOnVML: boolean;\n  doNotRelyOnCSS: boolean;\n  doNotSaveAsSingleFile: boolean;\n  doNotOrganizeInFolder: boolean;\n  doNotUseLongFileNames: boolean;\n  pixelsPerInch?: number;\n  targetScreenSz?: string;\n  encoding?: string;\n}\n"]}

package/dist/utils/KeyedRegistry.d.ts

@@ -0,0 +1,13 @@
+export declare class KeyedRegistry<V> {
+    private readonly label;
+    private readonly entries;
+    constructor(label: string);
+    register(key: string, value: V): void;
+    unregister(key: string): boolean;
+    has(key: string): boolean;
+    get(key: string): V | undefined;
+    keys(): string[];
+    values(): V[];
+    clear(): void;
+}
+//# sourceMappingURL=KeyedRegistry.d.ts.map

package/dist/utils/KeyedRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyedRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/KeyedRegistry.ts"],"names":[],"mappings":"AAKA,qBAAa,aAAa,CAAC,CAAC;IAGd,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEnB,KAAK,EAAE,MAAM;IAE1C,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAOrC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI/B,IAAI,IAAI,MAAM,EAAE;IAIhB,MAAM,IAAI,CAAC,EAAE;IAIb,KAAK,IAAI,IAAI;CAGd"}

package/dist/utils/KeyedRegistry.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyedRegistry = void 0;
+class KeyedRegistry {
+    label;
+    entries = new Map();
+    constructor(label) {
+        this.label = label;
+    }
+    register(key, value) {
+        if (this.entries.has(key)) {
+            throw new Error(`${this.label}: "${key}" is already registered`);
+        }
+        this.entries.set(key, value);
+    }
+    unregister(key) {
+        return this.entries.delete(key);
+    }
+    has(key) {
+        return this.entries.has(key);
+    }
+    get(key) {
+        return this.entries.get(key);
+    }
+    keys() {
+        return [...this.entries.keys()];
+    }
+    values() {
+        return [...this.entries.values()];
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+exports.KeyedRegistry = KeyedRegistry;
+//# sourceMappingURL=KeyedRegistry.js.map

package/dist/utils/KeyedRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyedRegistry.js","sourceRoot":"","sources":["../../src/utils/KeyedRegistry.ts"],"names":[],"mappings":";;;AAKA,MAAa,aAAa;IAGK;IAFZ,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IAEhD,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C,QAAQ,CAAC,GAAW,EAAE,KAAQ;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,MAAM,GAAG,yBAAyB,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAnCD,sCAmCC","sourcesContent":["/**\n * Map-backed keyed registry shared by ElementRegistry and ValidationRuleRegistry.\n * Throws on duplicate `register()` so callers cannot silently overwrite a\n * pre-existing entry.\n */\nexport class KeyedRegistry<V> {\n  private readonly entries = new Map<string, V>();\n\n  constructor(private readonly label: string) {}\n\n  register(key: string, value: V): void {\n    if (this.entries.has(key)) {\n      throw new Error(`${this.label}: \"${key}\" is already registered`);\n    }\n    this.entries.set(key, value);\n  }\n\n  unregister(key: string): boolean {\n    return this.entries.delete(key);\n  }\n\n  has(key: string): boolean {\n    return this.entries.has(key);\n  }\n\n  get(key: string): V | undefined {\n    return this.entries.get(key);\n  }\n\n  keys(): string[] {\n    return [...this.entries.keys()];\n  }\n\n  values(): V[] {\n    return [...this.entries.values()];\n  }\n\n  clear(): void {\n    this.entries.clear();\n  }\n}\n"]}

package/dist/utils/corruptionDetection.d.ts

@@ -1,4 +1,4 @@
-import { Paragraph } from '../elements/Paragraph';
+import { Paragraph } from '../elements/Paragraph.js';
 interface DocumentLike {
     getAllParagraphs?(): Paragraph[];
 }

package/dist/utils/corruptionDetection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"corruptionDetection.d.ts","sourceRoot":"","sources":["../../src/utils/corruptionDetection.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIlD,UAAU,YAAY;IACpB,gBAAgB,CAAC,IAAI,SAAS,EAAE,CAAC;CAClC;AAKD,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,UAAU,GACV,UAAU,GACV,OAAO,CAAC;AAKZ,MAAM,WAAW,kBAAkB;IAEjC,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IAEb,cAAc,EAAE,cAAc,CAAC;IAE/B,YAAY,EAAE,MAAM,CAAC;IAErB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,gBAAgB;IAE/B,WAAW,EAAE,OAAO,CAAC;IAErB,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAwBD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAkE9E;AAKD,UAAU,oBAAoB;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAoBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA4DzE;AAiBD,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAiDD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWpD"}
+{"version":3,"file":"corruptionDetection.d.ts","sourceRoot":"","sources":["../../src/utils/corruptionDetection.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAIrD,UAAU,YAAY;IACpB,gBAAgB,CAAC,IAAI,SAAS,EAAE,CAAC;CAClC;AAKD,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,UAAU,GACV,UAAU,GACV,OAAO,CAAC;AAKZ,MAAM,WAAW,kBAAkB;IAEjC,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IAEb,cAAc,EAAE,cAAc,CAAC;IAE/B,YAAY,EAAE,MAAM,CAAC;IAErB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,gBAAgB;IAE/B,WAAW,EAAE,OAAO,CAAC;IAErB,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAwBD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAkE9E;AAKD,UAAU,oBAAoB;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAoBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA4DzE;AAiBD,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAiDD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWpD"}

package/dist/utils/corruptionDetection.js

@@ -4,8 +4,8 @@ exports.detectCorruptionInDocument = detectCorruptionInDocument;
 exports.detectCorruptionInText = detectCorruptionInText;
 exports.suggestFix = suggestFix;
 exports.looksCorrupted = looksCorrupted;
-const Paragraph_1 = require("../elements/Paragraph");
-const Run_1 = require("../elements/Run");
+const Paragraph_js_1 = require("../elements/Paragraph.js");
+const Run_js_1 = require("../elements/Run.js");
 function detectCorruptionInDocument(doc) {
     const locations = [];
     const stats = {
@@ -17,13 +17,13 @@ function detectCorruptionInDocument(doc) {
     const paragraphs = doc.getAllParagraphs ? doc.getAllParagraphs() : [];
     for (let pIdx = 0; pIdx < paragraphs.length; pIdx++) {
         const paragraph = paragraphs[pIdx];
-        if (!paragraph || !(paragraph instanceof Paragraph_1.Paragraph)) {
+        if (!paragraph || !(paragraph instanceof Paragraph_js_1.Paragraph)) {
             continue;
         }
         const runs = paragraph.getRuns();
         for (let rIdx = 0; rIdx < runs.length; rIdx++) {
             const run = runs[rIdx];
-            if (!run || !(run instanceof Run_1.Run)) {
+            if (!run || !(run instanceof Run_js_1.Run)) {
                 continue;
             }
             const text = run.getText();

package/dist/utils/corruptionDetection.js.map

@@ -1 +1 @@
-{"version":3,"file":"corruptionDetection.js","sourceRoot":"","sources":["../../src/utils/corruptionDetection.ts"],"names":[],"mappings":";;AAsFA,gEAkEC;AA6BD,wDA4DC;AAiBD,gCA2BC;AAiDD,wCAWC;AAjVD,qDAAkD;AAClD,yCAAsC;AA6EtC,SAAgB,0BAA0B,CAAC,GAAiB;IAC1D,MAAM,SAAS,GAAyB,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG;QACZ,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,KAAK,EAAE,CAAC;KACT,CAAC;IAGF,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAGtE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,YAAY,qBAAS,CAAC,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QAGD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAGjC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,YAAY,SAAG,CAAC,EAAE,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YAGD,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAEhD,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC3B,SAAS,CAAC,IAAI,CAAC;oBACb,cAAc,EAAE,IAAI;oBACpB,QAAQ,EAAE,IAAI;oBACd,IAAI,EAAE,IAAI;oBACV,cAAc,EAAE,UAAU,CAAC,IAAI;oBAC/B,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;gBAGH,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa;oBAAE,KAAK,CAAC,UAAU,EAAE,CAAC;qBACrD,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU;oBAAE,KAAK,CAAC,OAAO,EAAE,CAAC;qBACpD,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU;oBAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;qBACrD,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO;oBAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAGD,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAElD,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;QACjC,cAAc,EAAE,SAAS,CAAC,MAAM;QAChC,SAAS;QACT,OAAO;QACP,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AA6BD,SAAgB,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACjF,CAAC;IAED,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,WAAW,GAAG,KAAK,CAAC;IAIxB,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;IACtD,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAID,MAAM,aAAa,GAAG,qBAAqB,CAAC;IAC5C,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAMD,MAAM,uBAAuB,GAC3B,oFAAoF,CAAC;IACvF,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IAGD,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAExF,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;IAGD,IAAI,IAAoB,CAAC;IACzB,IAAI,aAAa,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,EAAE,CAAC;QAEjD,IAAI,GAAG,aAAa,CAAC;IACvB,CAAC;SAAM,IAAI,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,GAAG,UAAU,CAAC;IACpB,CAAC;SAAM,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,GAAG,OAAO,CAAC;IACjB,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,IAAI,GAAG,aAAa,CAAC;IACvB,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,IAAI,GAAG,UAAU,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAEtC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACnD,CAAC;AAiBD,SAAgB,UAAU,CAAC,aAAqB;IAC9C,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,GAAG,aAAa,CAAC;IAG5B,OAAO,GAAG,OAAO;SACd,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAI1B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAG9C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAG1C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAE9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAKD,SAAS,eAAe,CACtB,SAA+B,EAC/B,KAA+E;IAE/E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,4CAA4C,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,8CAA8C,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAEpC,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,UAAU,cAAc,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,QAAQ,cAAc,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,KAAK,cAAc,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAE1F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAUD,SAAgB,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAGD,OAAO,CACL,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QACnC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/B,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Corruption Detection - Utilities to detect and diagnose XML corruption in documents\n *\n * This module helps users identify when they've accidentally passed XML-like strings\n * to text methods instead of using the proper API. This is a common mistake that\n * results in escaped XML tags being displayed as literal text in Word.\n */\n\nimport { Paragraph } from '../elements/Paragraph';\nimport { Run } from '../elements/Run';\n\n/** Minimal interface for document corruption scanning (avoids circular import) */\ninterface DocumentLike {\n  getAllParagraphs?(): Paragraph[];\n}\n\n/**\n * Types of corruption that can be detected\n */\nexport type CorruptionType =\n  | 'escaped-xml' // &lt;w:t&gt; style escaping\n  | 'xml-tags' // <w:t> tags in text\n  | 'entities' // &quot; &apos; etc.\n  | 'mixed'; // Multiple types\n\n/**\n * Location of corruption within a document\n */\nexport interface CorruptionLocation {\n  /** Index of the paragraph containing corruption */\n  paragraphIndex: number;\n  /** Index of the run within the paragraph */\n  runIndex: number;\n  /** The corrupted text content */\n  text: string;\n  /** Type of corruption detected */\n  corruptionType: CorruptionType;\n  /** Suggested fix for the corruption */\n  suggestedFix: string;\n  /** Length of corrupted text */\n  length: number;\n}\n\n/**\n * Comprehensive corruption report for a document\n */\nexport interface CorruptionReport {\n  /** Whether any corruption was found */\n  isCorrupted: boolean;\n  /** Total number of corrupted locations */\n  totalLocations: number;\n  /** Detailed list of corruption locations */\n  locations: CorruptionLocation[];\n  /** Human-readable summary */\n  summary: string;\n  /** Statistics about corruption types */\n  statistics: {\n    escapedXml: number;\n    xmlTags: number;\n    entities: number;\n    mixed: number;\n  };\n}\n\n/**\n * Detects XML corruption in a document\n *\n * Scans all paragraphs and runs to find text that contains escaped XML\n * or XML-like patterns that suggest the user passed XML strings to text methods.\n *\n * @param doc - The document to scan\n * @returns Corruption report with locations and suggested fixes\n *\n * @example\n * ```typescript\n * const doc = await Document.load('corrupted.docx');\n * const report = detectCorruptionInDocument(doc);\n *\n * if (report.isCorrupted) {\n *   console.log(report.summary);\n *   report.locations.forEach(loc => {\n *     console.log(`Paragraph ${loc.paragraphIndex}, Run ${loc.runIndex}: ${loc.suggestedFix}`);\n *   });\n * }\n * ```\n */\nexport function detectCorruptionInDocument(doc: DocumentLike): CorruptionReport {\n  const locations: CorruptionLocation[] = [];\n  const stats = {\n    escapedXml: 0,\n    xmlTags: 0,\n    entities: 0,\n    mixed: 0,\n  };\n\n  // Get all paragraphs from the document\n  const paragraphs = doc.getAllParagraphs ? doc.getAllParagraphs() : [];\n\n  // Scan each paragraph\n  for (let pIdx = 0; pIdx < paragraphs.length; pIdx++) {\n    const paragraph = paragraphs[pIdx];\n    if (!paragraph || !(paragraph instanceof Paragraph)) {\n      continue;\n    }\n\n    // Get runs from paragraph\n    const runs = paragraph.getRuns();\n\n    // Scan each run\n    for (let rIdx = 0; rIdx < runs.length; rIdx++) {\n      const run = runs[rIdx];\n      if (!run || !(run instanceof Run)) {\n        continue;\n      }\n\n      const text = run.getText();\n      if (!text || text.length === 0) {\n        continue;\n      }\n\n      // Check for corruption in this text\n      const corruption = detectCorruptionInText(text);\n\n      if (corruption.isCorrupted) {\n        locations.push({\n          paragraphIndex: pIdx,\n          runIndex: rIdx,\n          text: text,\n          corruptionType: corruption.type,\n          suggestedFix: corruption.suggestedFix,\n          length: text.length,\n        });\n\n        // Update statistics\n        if (corruption.type === 'escaped-xml') stats.escapedXml++;\n        else if (corruption.type === 'xml-tags') stats.xmlTags++;\n        else if (corruption.type === 'entities') stats.entities++;\n        else if (corruption.type === 'mixed') stats.mixed++;\n      }\n    }\n  }\n\n  // Generate summary\n  const summary = generateSummary(locations, stats);\n\n  return {\n    isCorrupted: locations.length > 0,\n    totalLocations: locations.length,\n    locations,\n    summary,\n    statistics: stats,\n  };\n}\n\n/**\n * Internal result from text corruption detection\n */\ninterface TextCorruptionResult {\n  isCorrupted: boolean;\n  type: CorruptionType;\n  suggestedFix: string;\n}\n\n/**\n * Detects XML corruption in a single text string\n *\n * Checks for common patterns that indicate the user passed XML strings\n * instead of plain text.\n *\n * @param text - Text to check\n * @returns True if corruption detected\n *\n * @example\n * ```typescript\n * const corrupted = detectCorruptionInText('Hello &lt;w:t&gt;World');\n * // Returns: true\n *\n * const clean = detectCorruptionInText('Hello World');\n * // Returns: false\n * ```\n */\nexport function detectCorruptionInText(text: string): TextCorruptionResult {\n  if (!text || typeof text !== 'string') {\n    return { isCorrupted: false, type: 'mixed', suggestedFix: String(text || '') };\n  }\n\n  let hasEscapedXml = false;\n  let hasXmlTags = false;\n  let hasEntities = false;\n\n  // Pattern 1: Escaped XML tags (most common corruption)\n  // Matches: &lt;w:t&gt;, &lt;/w:t&gt;, &lt;w:r&gt;, etc.\n  const escapedXmlPattern = /&lt;\\/?w:[a-z]+[^&]*&gt;/i;\n  if (escapedXmlPattern.test(text)) {\n    hasEscapedXml = true;\n  }\n\n  // Pattern 2: Raw XML tags (less common, but possible)\n  // Matches: <w:t>, </w:t>, <w:r>, etc.\n  const xmlTagPattern = /<\\/?w:[a-z]+[^>]*>/i;\n  if (xmlTagPattern.test(text)) {\n    hasXmlTags = true;\n  }\n\n  // Pattern 3: Escaped entities combined with Word XML attributes\n  // ONLY flag if we see Word-specific patterns, not just any entities\n  // This avoids false positives from legitimate escaped characters\n  // Matches all OOXML namespaces: w: (word), a: (drawingML), pic: (picture), r: (relationships), wp: (word drawing)\n  const wordXmlAttributePattern =\n    /(&lt;(?:w|a|r|pic|wp|m|mc|wpc|wps|wpg|c|dgm|o|v):|xml:space=&quot;preserve&quot;)/i;\n  if (wordXmlAttributePattern.test(text)) {\n    hasEntities = true;\n  }\n\n  // Determine corruption type\n  const corruptionCount = [hasEscapedXml, hasXmlTags, hasEntities].filter(Boolean).length;\n\n  if (corruptionCount === 0) {\n    return { isCorrupted: false, type: 'mixed', suggestedFix: text };\n  }\n\n  // More precise type detection - check primary indicator first\n  let type: CorruptionType;\n  if (hasEscapedXml && (hasEntities || hasXmlTags)) {\n    // Escaped XML combined with other patterns - this is the classic corruption case\n    type = 'escaped-xml';\n  } else if (hasXmlTags && hasEntities) {\n    type = 'xml-tags';\n  } else if (corruptionCount > 1) {\n    type = 'mixed';\n  } else if (hasEscapedXml) {\n    type = 'escaped-xml';\n  } else if (hasXmlTags) {\n    type = 'xml-tags';\n  } else {\n    type = 'entities';\n  }\n\n  const suggestedFix = suggestFix(text);\n\n  return { isCorrupted: true, type, suggestedFix };\n}\n\n/**\n * Suggests a fix for corrupted text\n *\n * Attempts to clean XML patterns from text to restore the intended content.\n * Uses the same cleaning logic as cleanXmlFromText() from validation.ts.\n *\n * @param corruptedText - Text containing XML corruption\n * @returns Cleaned text with XML patterns removed\n *\n * @example\n * ```typescript\n * const fixed = suggestFix('Hello &lt;w:t&gt;World&lt;/w:t&gt;');\n * // Returns: 'Hello World'\n * ```\n */\nexport function suggestFix(corruptedText: string): string {\n  if (!corruptedText || typeof corruptedText !== 'string') {\n    return corruptedText;\n  }\n\n  let cleaned = corruptedText;\n\n  // Step 1: Unescape XML entities first\n  cleaned = cleaned\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&apos;/g, \"'\")\n    .replace(/&amp;/g, '&');\n\n  // Step 2: Remove Word XML tags\n  // Matches: <w:t xml:space=\"preserve\">, </w:t>, <w:r>, etc.\n  cleaned = cleaned.replace(/<w:[^>]+>/g, '');\n  cleaned = cleaned.replace(/<\\/w:[^>]+>/g, '');\n\n  // Step 3: Remove any remaining XML-like tags\n  cleaned = cleaned.replace(/<[^>]+>/g, '');\n\n  // Step 4: Clean up whitespace\n  cleaned = cleaned.replace(/\\s+/g, ' ').trim();\n\n  return cleaned;\n}\n\n/**\n * Generates a human-readable summary of corruption\n */\nfunction generateSummary(\n  locations: CorruptionLocation[],\n  stats: { escapedXml: number; xmlTags: number; entities: number; mixed: number }\n): string {\n  if (locations.length === 0) {\n    return 'No corruption detected. Document is clean.';\n  }\n\n  const lines: string[] = [];\n  lines.push(`Found ${locations.length} corrupted text location(s) in the document.`);\n  lines.push('');\n  lines.push('Corruption breakdown:');\n\n  if (stats.escapedXml > 0) {\n    lines.push(`  - Escaped XML: ${stats.escapedXml} location(s)`);\n  }\n  if (stats.xmlTags > 0) {\n    lines.push(`  - XML Tags: ${stats.xmlTags} location(s)`);\n  }\n  if (stats.entities > 0) {\n    lines.push(`  - XML Entities: ${stats.entities} location(s)`);\n  }\n  if (stats.mixed > 0) {\n    lines.push(`  - Mixed: ${stats.mixed} location(s)`);\n  }\n\n  lines.push('');\n  lines.push('This corruption typically occurs when XML strings are passed to text methods.');\n  lines.push('Instead of: paragraph.addText(\"Text<w:t>1</w:t>\")');\n  lines.push('Use: paragraph.addText(\"Text\"); paragraph.addText(\"1\");');\n  lines.push('');\n  lines.push('To automatically clean text, use: new Run(text, { cleanXmlFromText: true })');\n\n  return lines.join('\\n');\n}\n\n/**\n * Checks if text looks like it might be corrupted (less strict check)\n *\n * This is a quick check that can be used for warnings without full analysis.\n *\n * @param text - Text to check\n * @returns True if text might be corrupted\n */\nexport function looksCorrupted(text: string): boolean {\n  if (!text || typeof text !== 'string') {\n    return false;\n  }\n\n  // Quick regex checks for common corruption patterns\n  return (\n    /&lt;\\/?(w|r|p):[a-z]+/i.test(text) ||\n    /<\\/?(w|r|p):[a-z]+/i.test(text) ||\n    /xml:space=&quot;/i.test(text)\n  );\n}\n"]}
+{"version":3,"file":"corruptionDetection.js","sourceRoot":"","sources":["../../src/utils/corruptionDetection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Corruption Detection - Utilities to detect and diagnose XML corruption in documents\n *\n * This module helps users identify when they've accidentally passed XML-like strings\n * to text methods instead of using the proper API. This is a common mistake that\n * results in escaped XML tags being displayed as literal text in Word.\n */\n\nimport { Paragraph } from '../elements/Paragraph.js';\nimport { Run } from '../elements/Run.js';\n\n/** Minimal interface for document corruption scanning (avoids circular import) */\ninterface DocumentLike {\n  getAllParagraphs?(): Paragraph[];\n}\n\n/**\n * Types of corruption that can be detected\n */\nexport type CorruptionType =\n  | 'escaped-xml' // &lt;w:t&gt; style escaping\n  | 'xml-tags' // <w:t> tags in text\n  | 'entities' // &quot; &apos; etc.\n  | 'mixed'; // Multiple types\n\n/**\n * Location of corruption within a document\n */\nexport interface CorruptionLocation {\n  /** Index of the paragraph containing corruption */\n  paragraphIndex: number;\n  /** Index of the run within the paragraph */\n  runIndex: number;\n  /** The corrupted text content */\n  text: string;\n  /** Type of corruption detected */\n  corruptionType: CorruptionType;\n  /** Suggested fix for the corruption */\n  suggestedFix: string;\n  /** Length of corrupted text */\n  length: number;\n}\n\n/**\n * Comprehensive corruption report for a document\n */\nexport interface CorruptionReport {\n  /** Whether any corruption was found */\n  isCorrupted: boolean;\n  /** Total number of corrupted locations */\n  totalLocations: number;\n  /** Detailed list of corruption locations */\n  locations: CorruptionLocation[];\n  /** Human-readable summary */\n  summary: string;\n  /** Statistics about corruption types */\n  statistics: {\n    escapedXml: number;\n    xmlTags: number;\n    entities: number;\n    mixed: number;\n  };\n}\n\n/**\n * Detects XML corruption in a document\n *\n * Scans all paragraphs and runs to find text that contains escaped XML\n * or XML-like patterns that suggest the user passed XML strings to text methods.\n *\n * @param doc - The document to scan\n * @returns Corruption report with locations and suggested fixes\n *\n * @example\n * ```typescript\n * const doc = await Document.load('corrupted.docx');\n * const report = detectCorruptionInDocument(doc);\n *\n * if (report.isCorrupted) {\n *   console.log(report.summary);\n *   report.locations.forEach(loc => {\n *     console.log(`Paragraph ${loc.paragraphIndex}, Run ${loc.runIndex}: ${loc.suggestedFix}`);\n *   });\n * }\n * ```\n */\nexport function detectCorruptionInDocument(doc: DocumentLike): CorruptionReport {\n  const locations: CorruptionLocation[] = [];\n  const stats = {\n    escapedXml: 0,\n    xmlTags: 0,\n    entities: 0,\n    mixed: 0,\n  };\n\n  // Get all paragraphs from the document\n  const paragraphs = doc.getAllParagraphs ? doc.getAllParagraphs() : [];\n\n  // Scan each paragraph\n  for (let pIdx = 0; pIdx < paragraphs.length; pIdx++) {\n    const paragraph = paragraphs[pIdx];\n    if (!paragraph || !(paragraph instanceof Paragraph)) {\n      continue;\n    }\n\n    // Get runs from paragraph\n    const runs = paragraph.getRuns();\n\n    // Scan each run\n    for (let rIdx = 0; rIdx < runs.length; rIdx++) {\n      const run = runs[rIdx];\n      if (!run || !(run instanceof Run)) {\n        continue;\n      }\n\n      const text = run.getText();\n      if (!text || text.length === 0) {\n        continue;\n      }\n\n      // Check for corruption in this text\n      const corruption = detectCorruptionInText(text);\n\n      if (corruption.isCorrupted) {\n        locations.push({\n          paragraphIndex: pIdx,\n          runIndex: rIdx,\n          text: text,\n          corruptionType: corruption.type,\n          suggestedFix: corruption.suggestedFix,\n          length: text.length,\n        });\n\n        // Update statistics\n        if (corruption.type === 'escaped-xml') stats.escapedXml++;\n        else if (corruption.type === 'xml-tags') stats.xmlTags++;\n        else if (corruption.type === 'entities') stats.entities++;\n        else if (corruption.type === 'mixed') stats.mixed++;\n      }\n    }\n  }\n\n  // Generate summary\n  const summary = generateSummary(locations, stats);\n\n  return {\n    isCorrupted: locations.length > 0,\n    totalLocations: locations.length,\n    locations,\n    summary,\n    statistics: stats,\n  };\n}\n\n/**\n * Internal result from text corruption detection\n */\ninterface TextCorruptionResult {\n  isCorrupted: boolean;\n  type: CorruptionType;\n  suggestedFix: string;\n}\n\n/**\n * Detects XML corruption in a single text string\n *\n * Checks for common patterns that indicate the user passed XML strings\n * instead of plain text.\n *\n * @param text - Text to check\n * @returns True if corruption detected\n *\n * @example\n * ```typescript\n * const corrupted = detectCorruptionInText('Hello &lt;w:t&gt;World');\n * // Returns: true\n *\n * const clean = detectCorruptionInText('Hello World');\n * // Returns: false\n * ```\n */\nexport function detectCorruptionInText(text: string): TextCorruptionResult {\n  if (!text || typeof text !== 'string') {\n    return { isCorrupted: false, type: 'mixed', suggestedFix: String(text || '') };\n  }\n\n  let hasEscapedXml = false;\n  let hasXmlTags = false;\n  let hasEntities = false;\n\n  // Pattern 1: Escaped XML tags (most common corruption)\n  // Matches: &lt;w:t&gt;, &lt;/w:t&gt;, &lt;w:r&gt;, etc.\n  const escapedXmlPattern = /&lt;\\/?w:[a-z]+[^&]*&gt;/i;\n  if (escapedXmlPattern.test(text)) {\n    hasEscapedXml = true;\n  }\n\n  // Pattern 2: Raw XML tags (less common, but possible)\n  // Matches: <w:t>, </w:t>, <w:r>, etc.\n  const xmlTagPattern = /<\\/?w:[a-z]+[^>]*>/i;\n  if (xmlTagPattern.test(text)) {\n    hasXmlTags = true;\n  }\n\n  // Pattern 3: Escaped entities combined with Word XML attributes\n  // ONLY flag if we see Word-specific patterns, not just any entities\n  // This avoids false positives from legitimate escaped characters\n  // Matches all OOXML namespaces: w: (word), a: (drawingML), pic: (picture), r: (relationships), wp: (word drawing)\n  const wordXmlAttributePattern =\n    /(&lt;(?:w|a|r|pic|wp|m|mc|wpc|wps|wpg|c|dgm|o|v):|xml:space=&quot;preserve&quot;)/i;\n  if (wordXmlAttributePattern.test(text)) {\n    hasEntities = true;\n  }\n\n  // Determine corruption type\n  const corruptionCount = [hasEscapedXml, hasXmlTags, hasEntities].filter(Boolean).length;\n\n  if (corruptionCount === 0) {\n    return { isCorrupted: false, type: 'mixed', suggestedFix: text };\n  }\n\n  // More precise type detection - check primary indicator first\n  let type: CorruptionType;\n  if (hasEscapedXml && (hasEntities || hasXmlTags)) {\n    // Escaped XML combined with other patterns - this is the classic corruption case\n    type = 'escaped-xml';\n  } else if (hasXmlTags && hasEntities) {\n    type = 'xml-tags';\n  } else if (corruptionCount > 1) {\n    type = 'mixed';\n  } else if (hasEscapedXml) {\n    type = 'escaped-xml';\n  } else if (hasXmlTags) {\n    type = 'xml-tags';\n  } else {\n    type = 'entities';\n  }\n\n  const suggestedFix = suggestFix(text);\n\n  return { isCorrupted: true, type, suggestedFix };\n}\n\n/**\n * Suggests a fix for corrupted text\n *\n * Attempts to clean XML patterns from text to restore the intended content.\n * Uses the same cleaning logic as cleanXmlFromText() from validation.ts.\n *\n * @param corruptedText - Text containing XML corruption\n * @returns Cleaned text with XML patterns removed\n *\n * @example\n * ```typescript\n * const fixed = suggestFix('Hello &lt;w:t&gt;World&lt;/w:t&gt;');\n * // Returns: 'Hello World'\n * ```\n */\nexport function suggestFix(corruptedText: string): string {\n  if (!corruptedText || typeof corruptedText !== 'string') {\n    return corruptedText;\n  }\n\n  let cleaned = corruptedText;\n\n  // Step 1: Unescape XML entities first\n  cleaned = cleaned\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&apos;/g, \"'\")\n    .replace(/&amp;/g, '&');\n\n  // Step 2: Remove Word XML tags\n  // Matches: <w:t xml:space=\"preserve\">, </w:t>, <w:r>, etc.\n  cleaned = cleaned.replace(/<w:[^>]+>/g, '');\n  cleaned = cleaned.replace(/<\\/w:[^>]+>/g, '');\n\n  // Step 3: Remove any remaining XML-like tags\n  cleaned = cleaned.replace(/<[^>]+>/g, '');\n\n  // Step 4: Clean up whitespace\n  cleaned = cleaned.replace(/\\s+/g, ' ').trim();\n\n  return cleaned;\n}\n\n/**\n * Generates a human-readable summary of corruption\n */\nfunction generateSummary(\n  locations: CorruptionLocation[],\n  stats: { escapedXml: number; xmlTags: number; entities: number; mixed: number }\n): string {\n  if (locations.length === 0) {\n    return 'No corruption detected. Document is clean.';\n  }\n\n  const lines: string[] = [];\n  lines.push(`Found ${locations.length} corrupted text location(s) in the document.`);\n  lines.push('');\n  lines.push('Corruption breakdown:');\n\n  if (stats.escapedXml > 0) {\n    lines.push(`  - Escaped XML: ${stats.escapedXml} location(s)`);\n  }\n  if (stats.xmlTags > 0) {\n    lines.push(`  - XML Tags: ${stats.xmlTags} location(s)`);\n  }\n  if (stats.entities > 0) {\n    lines.push(`  - XML Entities: ${stats.entities} location(s)`);\n  }\n  if (stats.mixed > 0) {\n    lines.push(`  - Mixed: ${stats.mixed} location(s)`);\n  }\n\n  lines.push('');\n  lines.push('This corruption typically occurs when XML strings are passed to text methods.');\n  lines.push('Instead of: paragraph.addText(\"Text<w:t>1</w:t>\")');\n  lines.push('Use: paragraph.addText(\"Text\"); paragraph.addText(\"1\");');\n  lines.push('');\n  lines.push('To automatically clean text, use: new Run(text, { cleanXmlFromText: true })');\n\n  return lines.join('\\n');\n}\n\n/**\n * Checks if text looks like it might be corrupted (less strict check)\n *\n * This is a quick check that can be used for warnings without full analysis.\n *\n * @param text - Text to check\n * @returns True if text might be corrupted\n */\nexport function looksCorrupted(text: string): boolean {\n  if (!text || typeof text !== 'string') {\n    return false;\n  }\n\n  // Quick regex checks for common corruption patterns\n  return (\n    /&lt;\\/?(w|r|p):[a-z]+/i.test(text) ||\n    /<\\/?(w|r|p):[a-z]+/i.test(text) ||\n    /xml:space=&quot;/i.test(text)\n  );\n}\n"]}

package/dist/utils/deepEqual.d.ts

@@ -0,0 +1,2 @@
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=deepEqual.d.ts.map

package/dist/utils/deepEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepEqual.d.ts","sourceRoot":"","sources":["../../src/utils/deepEqual.ts"],"names":[],"mappings":"AAYA,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA6CzD"}

package/dist/utils/deepEqual.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepEqual = deepEqual;
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a === 'number' && typeof b === 'number' && Number.isNaN(a) && Number.isNaN(b)) {
+        return true;
+    }
+    if (a == null || b == null)
+        return a === b;
+    const typeA = typeof a;
+    const typeB = typeof b;
+    if (typeA !== typeB)
+        return false;
+    if (typeA !== 'object')
+        return false;
+    if (a instanceof Date || b instanceof Date) {
+        return a instanceof Date && b instanceof Date && a.getTime() === b.getTime();
+    }
+    const aIsArr = Array.isArray(a);
+    const bIsArr = Array.isArray(b);
+    if (aIsArr !== bIsArr)
+        return false;
+    if (aIsArr && bIsArr) {
+        const arrA = a;
+        const arrB = b;
+        if (arrA.length !== arrB.length)
+            return false;
+        for (let i = 0; i < arrA.length; i++) {
+            if (!deepEqual(arrA[i], arrB[i]))
+                return false;
+        }
+        return true;
+    }
+    const objA = a;
+    const objB = b;
+    const keysA = Object.keys(objA);
+    const keysB = Object.keys(objB);
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const k of keysA) {
+        if (!Object.prototype.hasOwnProperty.call(objB, k))
+            return false;
+        if (!deepEqual(objA[k], objB[k]))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=deepEqual.js.map

package/dist/utils/deepEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepEqual.js","sourceRoot":"","sources":["../../src/utils/deepEqual.ts"],"names":[],"mappings":";;AAYA,8BA6CC;AA7CD,SAAgB,SAAS,CAAC,CAAU,EAAE,CAAU;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAIzB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAGrC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QAC3C,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/E,CAAC;IAGD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,CAAC,CAAC;QACf,MAAM,IAAI,GAAG,CAAC,CAAC;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,IAAI,GAAG,CAA4B,CAAC;IAC1C,MAAM,IAAI,GAAG,CAA4B,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACjE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Structural equality check for OOXML formatting objects.\n *\n * Replaces `JSON.stringify(a) === JSON.stringify(b)` in hot equality paths\n * (paragraph property merging, tracking-context consolidation). Avoids\n * allocating two large strings per comparison and short-circuits on the\n * first inequality.\n *\n * Handles the value shapes seen in formatting objects: primitives, plain\n * objects, arrays, Date, null/undefined. Symbols and class instances are\n * not part of the formatting model and are compared by reference.\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  // NaN === NaN is false in JS; treat structurally as equal so a parse\n  // failure that produced two NaNs in equivalent slots doesn't dirty the\n  // tracking-context consolidation pass.\n  if (typeof a === 'number' && typeof b === 'number' && Number.isNaN(a) && Number.isNaN(b)) {\n    return true;\n  }\n  if (a == null || b == null) return a === b;\n\n  const typeA = typeof a;\n  const typeB = typeof b;\n  if (typeA !== typeB) return false;\n  if (typeA !== 'object') return false;\n\n  // Date values\n  if (a instanceof Date || b instanceof Date) {\n    return a instanceof Date && b instanceof Date && a.getTime() === b.getTime();\n  }\n\n  // Arrays: same length, element-wise equality.\n  const aIsArr = Array.isArray(a);\n  const bIsArr = Array.isArray(b);\n  if (aIsArr !== bIsArr) return false;\n  if (aIsArr && bIsArr) {\n    const arrA = a;\n    const arrB = b;\n    if (arrA.length !== arrB.length) return false;\n    for (let i = 0; i < arrA.length; i++) {\n      if (!deepEqual(arrA[i], arrB[i])) return false;\n    }\n    return true;\n  }\n\n  // Plain objects: same key set, deep-equal values.\n  const objA = a as Record<string, unknown>;\n  const objB = b as Record<string, unknown>;\n  const keysA = Object.keys(objA);\n  const keysB = Object.keys(objB);\n  if (keysA.length !== keysB.length) return false;\n  for (const k of keysA) {\n    if (!Object.prototype.hasOwnProperty.call(objB, k)) return false;\n    if (!deepEqual(objA[k], objB[k])) return false;\n  }\n  return true;\n}\n"]}

package/dist/utils/list-detection.d.ts

@@ -1,5 +1,5 @@
-import type { Paragraph } from '../elements/Paragraph';
-import type { ListCategory, ListDetectionResult, NumberFormat, BulletFormat } from '../types/list-types';
+import type { Paragraph } from '../elements/Paragraph.js';
+import type { ListCategory, ListDetectionResult, NumberFormat, BulletFormat } from '../types/list-types.js';
 export declare const TYPED_LIST_PATTERNS: Record<string, RegExp>;
 export declare const PATTERN_TO_CATEGORY: Record<string, ListCategory>;
 export declare const FORMAT_TO_LEVEL: Record<string, number>;

package/dist/utils/list-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-detection.d.ts","sourceRoot":"","sources":["../../src/utils/list-detection.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACb,MAAM,qBAAqB,CAAC;AAU7B,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWtD,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAQ5D,CAAC;AASF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASlD,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGhE;AAoBD,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGrE;AAOD,wBAAgB,iCAAiC,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAGrF;AAWD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC;IAC3C,QAAQ,EAAE,YAAY,CAAC;CACxB,CAwBA;AAKD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAGpE;AAKD,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,mBAAmB,CA+CxE;AAMD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE;IAAE,SAAS,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAC7D;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiCxC;AAMD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAYlF"}
+{"version":3,"file":"list-detection.d.ts","sourceRoot":"","sources":["../../src/utils/list-detection.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACb,MAAM,wBAAwB,CAAC;AAUhC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWtD,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAQ5D,CAAC;AASF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASlD,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGhE;AAoBD,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGrE;AAOD,wBAAgB,iCAAiC,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAGrF;AAWD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC;IAC3C,QAAQ,EAAE,YAAY,CAAC;CACxB,CAwBA;AAKD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAGpE;AAKD,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,mBAAmB,CA+CxE;AAMD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE;IAAE,SAAS,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAC7D;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiCxC;AAMD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAYlF"}

package/dist/utils/list-detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-detection.js","sourceRoot":"","sources":["../../src/utils/list-detection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * List Detection Utilities for docxmlater\n *\n * Provides functions to detect typed list prefixes and analyze\n * paragraph list properties.\n */\n\nimport type { Paragraph } from '../elements/Paragraph';\nimport type {\n  ListCategory,\n  ListDetectionResult,\n  NumberFormat,\n  BulletFormat,\n} from '../types/list-types';\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\n/**\n * Regex patterns for typed list prefixes.\n * Order matters: more specific patterns first.\n */\nexport const TYPED_LIST_PATTERNS: Record<string, RegExp> = {\n  // Numbered patterns (capture the marker for validation)\n  decimal: /^(\\d+)[.)]\\s+/,\n  lowerLetter: /^([a-z])[.)]\\s+/,\n  upperLetter: /^([A-Z])[.)]\\s+/,\n  lowerRoman: /^((?:i{1,3}|iv|vi{0,3}|ix|x{1,3}))[.)]\\s+/i,\n\n  // Bullet patterns\n  bullet: /^[•●○◦▪■□]\\s+/,\n  dash: /^[-–—]\\s+/,\n  arrow: /^[►▸▶→]\\s+/,\n};\n\n/** Map pattern names to categories */\nexport const PATTERN_TO_CATEGORY: Record<string, ListCategory> = {\n  decimal: 'numbered',\n  lowerLetter: 'numbered',\n  upperLetter: 'numbered',\n  lowerRoman: 'numbered',\n  bullet: 'bullet',\n  dash: 'bullet',\n  arrow: 'bullet',\n};\n\n/**\n * Map typed prefix format to Word numbering level.\n * Word's default multilevel list uses:\n *   Level 0: 1., 2., 3. (decimal)\n *   Level 1: a., b., c. (lowerLetter)\n *   Level 2: i., ii., iii. (lowerRoman)\n */\nexport const FORMAT_TO_LEVEL: Record<string, number> = {\n  decimal: 0, // 1., 2., 3.\n  lowerLetter: 1, // a., b., c.\n  upperLetter: 1, // A., B., C.\n  lowerRoman: 2, // i., ii., iii.\n  upperRoman: 2, // I., II., III.\n  bullet: 0, // Top-level bullet (filled circle)\n  dash: 0, // Top-level dash marker\n  arrow: 0, // Top-level arrow marker\n};\n\n/**\n * Get the Word numbering level for a given format.\n * Returns 0 (top level) for decimal or unknown formats.\n */\nexport function getLevelFromFormat(format: string | null): number {\n  if (!format) return 0;\n  return FORMAT_TO_LEVEL[format] ?? 0;\n}\n\n/**\n * Word standard indentation values in twips.\n * Level 0: 720 twips (0.5 inch) left indent\n * Level 1: 1080 twips (0.75 inch) left indent\n * Level 2: 1440 twips (1 inch) left indent\n * Each subsequent level adds 360 twips.\n */\nconst WORD_BASE_INDENT = 720;\nconst INDENT_PER_LEVEL = 360;\n\n// =============================================================================\n// CORE DETECTION FUNCTIONS\n// =============================================================================\n\n/**\n * Infer list level from indentation.\n * Uses standard Word indentation: 720 twips for level 0, +360 per level.\n */\nexport function inferLevelFromIndentation(indentTwips: number): number {\n  if (indentTwips < WORD_BASE_INDENT) return 0;\n  return Math.floor((indentTwips - WORD_BASE_INDENT) / INDENT_PER_LEVEL);\n}\n\n/**\n * Infer list level from relative indentation (baseline already subtracted).\n * Used when normalizing lists within a table cell where the baseline\n * indentation varies per cell.\n */\nexport function inferLevelFromRelativeIndentation(relativeIndentTwips: number): number {\n  if (relativeIndentTwips <= 0) return 0;\n  return Math.min(8, Math.floor(relativeIndentTwips / INDENT_PER_LEVEL));\n}\n\n/**\n * Detect typed list prefix in text.\n * Returns the matched prefix and format type.\n *\n * Special handling for abbreviations:\n * - Single letter prefixes (A., B., P.) are NOT treated as list markers\n *   if the remaining text also starts with a letter+period pattern,\n *   indicating an abbreviation like \"P.O. Box\", \"U.S. Army\", etc.\n */\nexport function detectTypedPrefix(text: string): {\n  prefix: string | null;\n  format: NumberFormat | BulletFormat | null;\n  category: ListCategory;\n} {\n  for (const [format, regex] of Object.entries(TYPED_LIST_PATTERNS)) {\n    const match = text.match(regex);\n    if (match) {\n      // Special check for single-letter patterns (lowerLetter, upperLetter)\n      // to avoid false positives on abbreviations like \"P.O. Box\", \"U.S.\", \"A.M.\"\n      if (format === 'lowerLetter' || format === 'upperLetter') {\n        const remaining = text.substring(match[0].length);\n        // If remaining text starts with another letter followed by period,\n        // this is likely an abbreviation, not a list marker\n        if (/^[A-Za-z]\\./.test(remaining)) {\n          continue; // Skip this pattern, try others\n        }\n      }\n\n      return {\n        prefix: match[0],\n        format: format as NumberFormat | BulletFormat,\n        category: PATTERN_TO_CATEGORY[format] ?? 'none',\n      };\n    }\n  }\n\n  return { prefix: null, format: null, category: 'none' };\n}\n\n/**\n * Get the left indentation from a paragraph in twips.\n */\nexport function getParagraphIndentation(paragraph: Paragraph): number {\n  const formatting = paragraph.getFormatting();\n  return formatting?.indentation?.left ?? 0;\n}\n\n/**\n * Main detection function: analyze a single paragraph for list properties.\n */\nexport function detectListType(paragraph: Paragraph): ListDetectionResult {\n  const text = paragraph.getText();\n  const indentation = getParagraphIndentation(paragraph);\n  const numbering = paragraph.getNumbering();\n\n  // Priority 1: Real Word list with <w:numPr>\n  if (numbering?.numId !== undefined && numbering.numId !== 0) {\n    return {\n      category: 'numbered', // Default, caller can refine with NumberingManager lookup\n      isWordList: true,\n      typedPrefix: null,\n      inferredLevel: numbering.level ?? 0,\n      format: null, // Would need numbering.xml lookup\n      numId: numbering.numId,\n      ilvl: numbering.level ?? 0,\n      indentationTwips: indentation,\n    };\n  }\n\n  // Priority 2: Typed prefix detection\n  const typed = detectTypedPrefix(text);\n  if (typed.prefix) {\n    return {\n      category: typed.category,\n      isWordList: false,\n      typedPrefix: typed.prefix,\n      // Use FORMAT to determine level, not indentation!\n      // decimal=0, lowerLetter=1, lowerRoman=2\n      inferredLevel: getLevelFromFormat(typed.format),\n      format: typed.format,\n      numId: null,\n      ilvl: null,\n      indentationTwips: indentation,\n    };\n  }\n\n  // Priority 3: Not a list\n  return {\n    category: 'none',\n    isWordList: false,\n    typedPrefix: null,\n    inferredLevel: 0,\n    format: null,\n    numId: null,\n    ilvl: null,\n    indentationTwips: indentation,\n  };\n}\n\n/**\n * Validate that a typed prefix sequence is reasonable.\n * E.g., \"1. 2. 3.\" is valid, \"1. 5. 2.\" is suspicious.\n */\nexport function validateListSequence(\n  paragraphs: { detection: ListDetectionResult; text: string }[]\n): { valid: boolean; warnings: string[] } {\n  const warnings: string[] = [];\n  let lastDecimal = 0;\n  let lastLetter = '';\n\n  for (const { detection } of paragraphs) {\n    if (!detection.typedPrefix || detection.category !== 'numbered') continue;\n\n    const match = /^(\\d+|[a-zA-Z]+)/.exec(detection.typedPrefix);\n    if (!match?.[1]) continue;\n\n    const marker = match[1];\n\n    // Check decimal sequence\n    if (/^\\d+$/.test(marker)) {\n      const num = parseInt(marker, 10);\n      if (lastDecimal > 0 && num !== lastDecimal + 1 && num !== 1) {\n        warnings.push(`Unexpected number sequence: ${lastDecimal} → ${num}`);\n      }\n      lastDecimal = num;\n    }\n\n    // Check letter sequence\n    if (/^[a-z]$/i.test(marker)) {\n      const letter = marker.toLowerCase();\n      if (lastLetter && letter.charCodeAt(0) !== lastLetter.charCodeAt(0) + 1 && letter !== 'a') {\n        warnings.push(`Unexpected letter sequence: ${lastLetter} → ${letter}`);\n      }\n      lastLetter = letter;\n    }\n  }\n\n  return { valid: warnings.length === 0, warnings };\n}\n\n/**\n * Determine the list category for a given numId by checking the abstractNum.\n * This requires access to the NumberingManager.\n */\nexport function getListCategoryFromFormat(format: string | undefined): ListCategory {\n  if (!format) return 'none';\n\n  if (['bullet', 'dash', 'arrow'].includes(format)) {\n    return 'bullet';\n  }\n\n  if (['decimal', 'lowerLetter', 'upperLetter', 'lowerRoman', 'upperRoman'].includes(format)) {\n    return 'numbered';\n  }\n\n  return 'none';\n}\n"]}
+{"version":3,"file":"list-detection.js","sourceRoot":"","sources":["../../src/utils/list-detection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * List Detection Utilities for docxmlater\n *\n * Provides functions to detect typed list prefixes and analyze\n * paragraph list properties.\n */\n\nimport type { Paragraph } from '../elements/Paragraph.js';\nimport type {\n  ListCategory,\n  ListDetectionResult,\n  NumberFormat,\n  BulletFormat,\n} from '../types/list-types.js';\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\n/**\n * Regex patterns for typed list prefixes.\n * Order matters: more specific patterns first.\n */\nexport const TYPED_LIST_PATTERNS: Record<string, RegExp> = {\n  // Numbered patterns (capture the marker for validation)\n  decimal: /^(\\d+)[.)]\\s+/,\n  lowerLetter: /^([a-z])[.)]\\s+/,\n  upperLetter: /^([A-Z])[.)]\\s+/,\n  lowerRoman: /^((?:i{1,3}|iv|vi{0,3}|ix|x{1,3}))[.)]\\s+/i,\n\n  // Bullet patterns\n  bullet: /^[•●○◦▪■□]\\s+/,\n  dash: /^[-–—]\\s+/,\n  arrow: /^[►▸▶→]\\s+/,\n};\n\n/** Map pattern names to categories */\nexport const PATTERN_TO_CATEGORY: Record<string, ListCategory> = {\n  decimal: 'numbered',\n  lowerLetter: 'numbered',\n  upperLetter: 'numbered',\n  lowerRoman: 'numbered',\n  bullet: 'bullet',\n  dash: 'bullet',\n  arrow: 'bullet',\n};\n\n/**\n * Map typed prefix format to Word numbering level.\n * Word's default multilevel list uses:\n *   Level 0: 1., 2., 3. (decimal)\n *   Level 1: a., b., c. (lowerLetter)\n *   Level 2: i., ii., iii. (lowerRoman)\n */\nexport const FORMAT_TO_LEVEL: Record<string, number> = {\n  decimal: 0, // 1., 2., 3.\n  lowerLetter: 1, // a., b., c.\n  upperLetter: 1, // A., B., C.\n  lowerRoman: 2, // i., ii., iii.\n  upperRoman: 2, // I., II., III.\n  bullet: 0, // Top-level bullet (filled circle)\n  dash: 0, // Top-level dash marker\n  arrow: 0, // Top-level arrow marker\n};\n\n/**\n * Get the Word numbering level for a given format.\n * Returns 0 (top level) for decimal or unknown formats.\n */\nexport function getLevelFromFormat(format: string | null): number {\n  if (!format) return 0;\n  return FORMAT_TO_LEVEL[format] ?? 0;\n}\n\n/**\n * Word standard indentation values in twips.\n * Level 0: 720 twips (0.5 inch) left indent\n * Level 1: 1080 twips (0.75 inch) left indent\n * Level 2: 1440 twips (1 inch) left indent\n * Each subsequent level adds 360 twips.\n */\nconst WORD_BASE_INDENT = 720;\nconst INDENT_PER_LEVEL = 360;\n\n// =============================================================================\n// CORE DETECTION FUNCTIONS\n// =============================================================================\n\n/**\n * Infer list level from indentation.\n * Uses standard Word indentation: 720 twips for level 0, +360 per level.\n */\nexport function inferLevelFromIndentation(indentTwips: number): number {\n  if (indentTwips < WORD_BASE_INDENT) return 0;\n  return Math.floor((indentTwips - WORD_BASE_INDENT) / INDENT_PER_LEVEL);\n}\n\n/**\n * Infer list level from relative indentation (baseline already subtracted).\n * Used when normalizing lists within a table cell where the baseline\n * indentation varies per cell.\n */\nexport function inferLevelFromRelativeIndentation(relativeIndentTwips: number): number {\n  if (relativeIndentTwips <= 0) return 0;\n  return Math.min(8, Math.floor(relativeIndentTwips / INDENT_PER_LEVEL));\n}\n\n/**\n * Detect typed list prefix in text.\n * Returns the matched prefix and format type.\n *\n * Special handling for abbreviations:\n * - Single letter prefixes (A., B., P.) are NOT treated as list markers\n *   if the remaining text also starts with a letter+period pattern,\n *   indicating an abbreviation like \"P.O. Box\", \"U.S. Army\", etc.\n */\nexport function detectTypedPrefix(text: string): {\n  prefix: string | null;\n  format: NumberFormat | BulletFormat | null;\n  category: ListCategory;\n} {\n  for (const [format, regex] of Object.entries(TYPED_LIST_PATTERNS)) {\n    const match = text.match(regex);\n    if (match) {\n      // Special check for single-letter patterns (lowerLetter, upperLetter)\n      // to avoid false positives on abbreviations like \"P.O. Box\", \"U.S.\", \"A.M.\"\n      if (format === 'lowerLetter' || format === 'upperLetter') {\n        const remaining = text.substring(match[0].length);\n        // If remaining text starts with another letter followed by period,\n        // this is likely an abbreviation, not a list marker\n        if (/^[A-Za-z]\\./.test(remaining)) {\n          continue; // Skip this pattern, try others\n        }\n      }\n\n      return {\n        prefix: match[0],\n        format: format as NumberFormat | BulletFormat,\n        category: PATTERN_TO_CATEGORY[format] ?? 'none',\n      };\n    }\n  }\n\n  return { prefix: null, format: null, category: 'none' };\n}\n\n/**\n * Get the left indentation from a paragraph in twips.\n */\nexport function getParagraphIndentation(paragraph: Paragraph): number {\n  const formatting = paragraph.getFormatting();\n  return formatting?.indentation?.left ?? 0;\n}\n\n/**\n * Main detection function: analyze a single paragraph for list properties.\n */\nexport function detectListType(paragraph: Paragraph): ListDetectionResult {\n  const text = paragraph.getText();\n  const indentation = getParagraphIndentation(paragraph);\n  const numbering = paragraph.getNumbering();\n\n  // Priority 1: Real Word list with <w:numPr>\n  if (numbering?.numId !== undefined && numbering.numId !== 0) {\n    return {\n      category: 'numbered', // Default, caller can refine with NumberingManager lookup\n      isWordList: true,\n      typedPrefix: null,\n      inferredLevel: numbering.level ?? 0,\n      format: null, // Would need numbering.xml lookup\n      numId: numbering.numId,\n      ilvl: numbering.level ?? 0,\n      indentationTwips: indentation,\n    };\n  }\n\n  // Priority 2: Typed prefix detection\n  const typed = detectTypedPrefix(text);\n  if (typed.prefix) {\n    return {\n      category: typed.category,\n      isWordList: false,\n      typedPrefix: typed.prefix,\n      // Use FORMAT to determine level, not indentation!\n      // decimal=0, lowerLetter=1, lowerRoman=2\n      inferredLevel: getLevelFromFormat(typed.format),\n      format: typed.format,\n      numId: null,\n      ilvl: null,\n      indentationTwips: indentation,\n    };\n  }\n\n  // Priority 3: Not a list\n  return {\n    category: 'none',\n    isWordList: false,\n    typedPrefix: null,\n    inferredLevel: 0,\n    format: null,\n    numId: null,\n    ilvl: null,\n    indentationTwips: indentation,\n  };\n}\n\n/**\n * Validate that a typed prefix sequence is reasonable.\n * E.g., \"1. 2. 3.\" is valid, \"1. 5. 2.\" is suspicious.\n */\nexport function validateListSequence(\n  paragraphs: { detection: ListDetectionResult; text: string }[]\n): { valid: boolean; warnings: string[] } {\n  const warnings: string[] = [];\n  let lastDecimal = 0;\n  let lastLetter = '';\n\n  for (const { detection } of paragraphs) {\n    if (!detection.typedPrefix || detection.category !== 'numbered') continue;\n\n    const match = /^(\\d+|[a-zA-Z]+)/.exec(detection.typedPrefix);\n    if (!match?.[1]) continue;\n\n    const marker = match[1];\n\n    // Check decimal sequence\n    if (/^\\d+$/.test(marker)) {\n      const num = parseInt(marker, 10);\n      if (lastDecimal > 0 && num !== lastDecimal + 1 && num !== 1) {\n        warnings.push(`Unexpected number sequence: ${lastDecimal} → ${num}`);\n      }\n      lastDecimal = num;\n    }\n\n    // Check letter sequence\n    if (/^[a-z]$/i.test(marker)) {\n      const letter = marker.toLowerCase();\n      if (lastLetter && letter.charCodeAt(0) !== lastLetter.charCodeAt(0) + 1 && letter !== 'a') {\n        warnings.push(`Unexpected letter sequence: ${lastLetter} → ${letter}`);\n      }\n      lastLetter = letter;\n    }\n  }\n\n  return { valid: warnings.length === 0, warnings };\n}\n\n/**\n * Determine the list category for a given numId by checking the abstractNum.\n * This requires access to the NumberingManager.\n */\nexport function getListCategoryFromFormat(format: string | undefined): ListCategory {\n  if (!format) return 'none';\n\n  if (['bullet', 'dash', 'arrow'].includes(format)) {\n    return 'bullet';\n  }\n\n  if (['decimal', 'lowerLetter', 'upperLetter', 'lowerRoman', 'upperRoman'].includes(format)) {\n    return 'numbered';\n  }\n\n  return 'none';\n}\n"]}

package/dist/utils/parsingHelpers.d.ts

@@ -1,5 +1,5 @@
 export declare function safeParseInt(value: unknown, defaultValue?: number): number;
-export declare function parseOoxmlBoolean(prop: unknown): boolean;
+export declare function parseOoxmlBoolean(prop: unknown, valAttr?: string): boolean;
 export declare function isExplicitlySet(value: unknown): boolean;
 export declare function parseNumericAttribute(value: unknown, defaultValue: number): number;
 export declare function parseOnOffAttribute(value: unknown, defaultValue?: boolean): boolean;

package/dist/utils/parsingHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parsingHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/parsingHelpers.ts"],"names":[],"mappings":"AA4BA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,MAAM,CAYrE;AA+BD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAiCxD;AA0BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvD;AAkBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKlF;AAeD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,UAAQ,GAAG,OAAO,CAmBjF"}
+{"version":3,"file":"parsingHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/parsingHelpers.ts"],"names":[],"mappings":"AA4BA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,MAAM,CAYrE;AAsCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,SAAY,GAAG,OAAO,CAkC7E;AA0BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvD;AAkBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKlF;AAeD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,UAAQ,GAAG,OAAO,CAmBjF"}

package/dist/utils/parsingHelpers.js

@@ -15,11 +15,11 @@ function safeParseInt(value, defaultValue = 0) {
     const parsed = parseInt(String(value), 10);
     return isNaN(parsed) ? defaultValue : parsed;
 }
-function parseOoxmlBoolean(prop) {
+function parseOoxmlBoolean(prop, valAttr = '@_w:val') {
     if (!prop) {
         return false;
     }
-    const val = prop['@_w:val'];
+    const val = prop[valAttr];
     if (val === undefined) {
         return true;
     }

package/dist/utils/parsingHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"parsingHelpers.js","sourceRoot":"","sources":["../../src/utils/parsingHelpers.ts"],"names":[],"mappings":";;AA4BA,oCAYC;AA+BD,8CAiCC;AA0BD,0CAEC;AAkBD,sDAKC;AAeD,kDAmBC;AAjKD,SAAgB,YAAY,CAAC,KAAc,EAAE,YAAY,GAAG,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,YAAY,CAAC;IACtB,CAAC;IAGD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC;AA+BD,SAAgB,iBAAiB,CAAC,IAAa;IAE7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAGD,MAAM,GAAG,GAAI,IAAgC,CAAC,SAAS,CAAC,CAAC;IAIzD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,IAAI,CAAC;IACtE,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IAGD,OAAO,KAAK,CAAC;AACf,CAAC;AA0BD,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AAC/C,CAAC;AAkBD,SAAgB,qBAAqB,CAAC,KAAc,EAAE,YAAoB;IACxE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC;AAeD,SAAgB,mBAAmB,CAAC,KAAc,EAAE,YAAY,GAAG,KAAK;IACtE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,IAAI,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["/**\n * Parsing Helper Functions\n *\n * Utility functions for safely parsing OOXML values from XML attributes.\n * These helpers address common parsing issues:\n * - Zero-value handling (0 should not be treated as falsy)\n * - NaN validation (malformed values should fall back to defaults)\n * - ECMA-376 boolean parsing (self-closing tags, val=\"1\", val=\"true\")\n *\n * @see https://ecma-international.org/publications-and-standards/standards/ecma-376/\n */\n\n/**\n * Safely parse an integer value with NaN handling.\n *\n * Addresses the issue where parseInt() can return NaN for malformed input,\n * which then propagates through the document model causing issues.\n *\n * @param value - The value to parse (string, number, or any)\n * @param defaultValue - Default value if parsing fails (default: 0)\n * @returns Parsed integer or default value\n *\n * @example\n * safeParseInt(\"42\")      // 42\n * safeParseInt(\"invalid\") // 0\n * safeParseInt(undefined) // 0\n * safeParseInt(\"\", 100)   // 100\n */\nexport function safeParseInt(value: unknown, defaultValue = 0): number {\n  if (value === undefined || value === null) {\n    return defaultValue;\n  }\n\n  // If already a number, return it (handle NaN case)\n  if (typeof value === 'number') {\n    return isNaN(value) ? defaultValue : Math.floor(value);\n  }\n\n  const parsed = parseInt(String(value), 10);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n\n/**\n * Parse OOXML boolean value per ECMA-376 specification.\n *\n * OOXML boolean properties follow these rules:\n * - Self-closing tag `<w:bold/>` (no w:val attribute) = true\n * - `<w:bold w:val=\"1\"/>` = true\n * - `<w:bold w:val=\"true\"/>` = true\n * - `<w:bold w:val=\"on\"/>` = true\n * - `<w:bold w:val=\"0\"/>` = false\n * - `<w:bold w:val=\"false\"/>` = false\n * - `<w:bold w:val=\"off\"/>` = false\n * - Absent element = false (handled by caller checking for property existence)\n *\n * @param prop - The parsed XML property object (e.g., pPrObj[\"w:bold\"])\n * @returns Boolean value\n *\n * @example\n * // For XML: <w:bold/>\n * parseOoxmlBoolean({}) // true (self-closing, no @_w:val)\n *\n * // For XML: <w:bold w:val=\"1\"/>\n * parseOoxmlBoolean({ \"@_w:val\": \"1\" }) // true\n *\n * // For XML: <w:bold w:val=\"0\"/>\n * parseOoxmlBoolean({ \"@_w:val\": \"0\" }) // false\n *\n * // For absent element\n * parseOoxmlBoolean(undefined) // false\n */\nexport function parseOoxmlBoolean(prop: unknown): boolean {\n  // Absent element = false\n  if (!prop) {\n    return false;\n  }\n\n  // Get the w:val attribute value\n  const val = (prop as Record<string, unknown>)['@_w:val'];\n\n  // Self-closing tag without w:val attribute = true\n  // Per ECMA-376, presence of element without val means \"on\"\n  if (val === undefined) {\n    return true;\n  }\n\n  // Handle string values\n  if (typeof val === 'string') {\n    const lowerVal = val.toLowerCase();\n    return lowerVal === '1' || lowerVal === 'true' || lowerVal === 'on';\n  }\n\n  // Handle numeric values\n  if (typeof val === 'number') {\n    return val === 1;\n  }\n\n  // Handle boolean values (already parsed by XML parser)\n  if (typeof val === 'boolean') {\n    return val;\n  }\n\n  // Unknown type - default to false\n  return false;\n}\n\n/**\n * Check if a value is explicitly set (not undefined or null).\n *\n * This helper addresses the zero-value handling bug where truthy checks\n * incorrectly treat 0 as falsy:\n *\n * ```typescript\n * // WRONG - treats 0 as falsy\n * const width = val ? parseInt(val) : defaultWidth;\n *\n * // CORRECT - only checks for undefined/null\n * const width = isExplicitlySet(val) ? parseInt(val) : defaultWidth;\n * ```\n *\n * @param value - The value to check\n * @returns true if value is not undefined and not null\n *\n * @example\n * isExplicitlySet(0)         // true\n * isExplicitlySet(\"\")        // true\n * isExplicitlySet(false)     // true\n * isExplicitlySet(undefined) // false\n * isExplicitlySet(null)      // false\n */\nexport function isExplicitlySet(value: unknown): boolean {\n  return value !== undefined && value !== null;\n}\n\n/**\n * Parse an OOXML numeric attribute with proper handling of zero values.\n *\n * Combines isExplicitlySet() and safeParseInt() for common use case\n * of parsing numeric attributes from XML.\n *\n * @param value - The attribute value to parse\n * @param defaultValue - Default value if attribute is not set\n * @returns Parsed integer or default value\n *\n * @example\n * parseNumericAttribute(\"100\", 50)    // 100\n * parseNumericAttribute(\"0\", 50)      // 0 (not 50!)\n * parseNumericAttribute(undefined, 50) // 50\n * parseNumericAttribute(\"invalid\", 50) // 50\n */\nexport function parseNumericAttribute(value: unknown, defaultValue: number): number {\n  if (!isExplicitlySet(value)) {\n    return defaultValue;\n  }\n  return safeParseInt(value, defaultValue);\n}\n\n/**\n * Parse OOXML \"on/off\" attribute (ST_OnOff type).\n *\n * Some OOXML attributes use the ST_OnOff simple type which can be:\n * - \"on\", \"1\", \"true\" = true\n * - \"off\", \"0\", \"false\" = false\n *\n * This is similar to parseOoxmlBoolean but works on attribute values directly.\n *\n * @param value - The attribute value\n * @param defaultValue - Default if value is not set\n * @returns Boolean value\n */\nexport function parseOnOffAttribute(value: unknown, defaultValue = false): boolean {\n  if (!isExplicitlySet(value)) {\n    return defaultValue;\n  }\n\n  if (typeof value === 'string') {\n    const lowerVal = value.toLowerCase();\n    return lowerVal === '1' || lowerVal === 'true' || lowerVal === 'on';\n  }\n\n  if (typeof value === 'number') {\n    return value === 1;\n  }\n\n  if (typeof value === 'boolean') {\n    return value;\n  }\n\n  return defaultValue;\n}\n"]}
+{"version":3,"file":"parsingHelpers.js","sourceRoot":"","sources":["../../src/utils/parsingHelpers.ts"],"names":[],"mappings":";;AA4BA,oCAYC;AAsCD,8CAkCC;AA0BD,0CAEC;AAkBD,sDAKC;AAeD,kDAmBC;AAzKD,SAAgB,YAAY,CAAC,KAAc,EAAE,YAAY,GAAG,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,YAAY,CAAC;IACtB,CAAC;IAGD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC;AAsCD,SAAgB,iBAAiB,CAAC,IAAa,EAAE,OAAO,GAAG,SAAS;IAElE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAID,MAAM,GAAG,GAAI,IAAgC,CAAC,OAAO,CAAC,CAAC;IAIvD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,IAAI,CAAC;IACtE,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IAGD,OAAO,KAAK,CAAC;AACf,CAAC;AA0BD,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AAC/C,CAAC;AAkBD,SAAgB,qBAAqB,CAAC,KAAc,EAAE,YAAoB;IACxE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC;AAeD,SAAgB,mBAAmB,CAAC,KAAc,EAAE,YAAY,GAAG,KAAK;IACtE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,IAAI,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["/**\n * Parsing Helper Functions\n *\n * Utility functions for safely parsing OOXML values from XML attributes.\n * These helpers address common parsing issues:\n * - Zero-value handling (0 should not be treated as falsy)\n * - NaN validation (malformed values should fall back to defaults)\n * - ECMA-376 boolean parsing (self-closing tags, val=\"1\", val=\"true\")\n *\n * @see https://ecma-international.org/publications-and-standards/standards/ecma-376/\n */\n\n/**\n * Safely parse an integer value with NaN handling.\n *\n * Addresses the issue where parseInt() can return NaN for malformed input,\n * which then propagates through the document model causing issues.\n *\n * @param value - The value to parse (string, number, or any)\n * @param defaultValue - Default value if parsing fails (default: 0)\n * @returns Parsed integer or default value\n *\n * @example\n * safeParseInt(\"42\")      // 42\n * safeParseInt(\"invalid\") // 0\n * safeParseInt(undefined) // 0\n * safeParseInt(\"\", 100)   // 100\n */\nexport function safeParseInt(value: unknown, defaultValue = 0): number {\n  if (value === undefined || value === null) {\n    return defaultValue;\n  }\n\n  // If already a number, return it (handle NaN case)\n  if (typeof value === 'number') {\n    return isNaN(value) ? defaultValue : Math.floor(value);\n  }\n\n  const parsed = parseInt(String(value), 10);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n\n/**\n * Parse OOXML boolean value per ECMA-376 specification.\n *\n * OOXML boolean properties follow these rules:\n * - Self-closing tag `<w:bold/>` (no w:val attribute) = true\n * - `<w:bold w:val=\"1\"/>` = true\n * - `<w:bold w:val=\"true\"/>` = true\n * - `<w:bold w:val=\"on\"/>` = true\n * - `<w:bold w:val=\"0\"/>` = false\n * - `<w:bold w:val=\"false\"/>` = false\n * - `<w:bold w:val=\"off\"/>` = false\n * - Absent element = false (handled by caller checking for property existence)\n *\n * @param prop - The parsed XML property object (e.g., pPrObj[\"w:bold\"])\n * @param valAttr - The attribute key that carries the ST_OnOff literal.\n *   Defaults to `\"@_w:val\"` for the main WordprocessingML namespace.\n *   Pass `\"@_w14:val\"` for w14 extension elements such as\n *   `<w14:checked w14:val=\"1\"/>` (CT_OnOff in the Word 2010+ namespace).\n * @returns Boolean value\n *\n * @example\n * // For XML: <w:bold/>\n * parseOoxmlBoolean({}) // true (self-closing, no @_w:val)\n *\n * // For XML: <w:bold w:val=\"1\"/>\n * parseOoxmlBoolean({ \"@_w:val\": \"1\" }) // true\n *\n * // For XML: <w:bold w:val=\"0\"/>\n * parseOoxmlBoolean({ \"@_w:val\": \"0\" }) // false\n *\n * // For XML: <w14:checked w14:val=\"on\"/>\n * parseOoxmlBoolean({ \"@_w14:val\": \"on\" }, \"@_w14:val\") // true\n *\n * // For absent element\n * parseOoxmlBoolean(undefined) // false\n */\nexport function parseOoxmlBoolean(prop: unknown, valAttr = '@_w:val'): boolean {\n  // Absent element = false\n  if (!prop) {\n    return false;\n  }\n\n  // Get the val attribute value (w:val by default, w14:val or similar for\n  // extension namespaces).\n  const val = (prop as Record<string, unknown>)[valAttr];\n\n  // Self-closing tag without w:val attribute = true\n  // Per ECMA-376, presence of element without val means \"on\"\n  if (val === undefined) {\n    return true;\n  }\n\n  // Handle string values\n  if (typeof val === 'string') {\n    const lowerVal = val.toLowerCase();\n    return lowerVal === '1' || lowerVal === 'true' || lowerVal === 'on';\n  }\n\n  // Handle numeric values\n  if (typeof val === 'number') {\n    return val === 1;\n  }\n\n  // Handle boolean values (already parsed by XML parser)\n  if (typeof val === 'boolean') {\n    return val;\n  }\n\n  // Unknown type - default to false\n  return false;\n}\n\n/**\n * Check if a value is explicitly set (not undefined or null).\n *\n * This helper addresses the zero-value handling bug where truthy checks\n * incorrectly treat 0 as falsy:\n *\n * ```typescript\n * // WRONG - treats 0 as falsy\n * const width = val ? parseInt(val) : defaultWidth;\n *\n * // CORRECT - only checks for undefined/null\n * const width = isExplicitlySet(val) ? parseInt(val) : defaultWidth;\n * ```\n *\n * @param value - The value to check\n * @returns true if value is not undefined and not null\n *\n * @example\n * isExplicitlySet(0)         // true\n * isExplicitlySet(\"\")        // true\n * isExplicitlySet(false)     // true\n * isExplicitlySet(undefined) // false\n * isExplicitlySet(null)      // false\n */\nexport function isExplicitlySet(value: unknown): boolean {\n  return value !== undefined && value !== null;\n}\n\n/**\n * Parse an OOXML numeric attribute with proper handling of zero values.\n *\n * Combines isExplicitlySet() and safeParseInt() for common use case\n * of parsing numeric attributes from XML.\n *\n * @param value - The attribute value to parse\n * @param defaultValue - Default value if attribute is not set\n * @returns Parsed integer or default value\n *\n * @example\n * parseNumericAttribute(\"100\", 50)    // 100\n * parseNumericAttribute(\"0\", 50)      // 0 (not 50!)\n * parseNumericAttribute(undefined, 50) // 50\n * parseNumericAttribute(\"invalid\", 50) // 50\n */\nexport function parseNumericAttribute(value: unknown, defaultValue: number): number {\n  if (!isExplicitlySet(value)) {\n    return defaultValue;\n  }\n  return safeParseInt(value, defaultValue);\n}\n\n/**\n * Parse OOXML \"on/off\" attribute (ST_OnOff type).\n *\n * Some OOXML attributes use the ST_OnOff simple type which can be:\n * - \"on\", \"1\", \"true\" = true\n * - \"off\", \"0\", \"false\" = false\n *\n * This is similar to parseOoxmlBoolean but works on attribute values directly.\n *\n * @param value - The attribute value\n * @param defaultValue - Default if value is not set\n * @returns Boolean value\n */\nexport function parseOnOffAttribute(value: unknown, defaultValue = false): boolean {\n  if (!isExplicitlySet(value)) {\n    return defaultValue;\n  }\n\n  if (typeof value === 'string') {\n    const lowerVal = value.toLowerCase();\n    return lowerVal === '1' || lowerVal === 'true' || lowerVal === 'on';\n  }\n\n  if (typeof value === 'number') {\n    return value === 1;\n  }\n\n  if (typeof value === 'boolean') {\n    return value;\n  }\n\n  return defaultValue;\n}\n"]}

package/dist/utils/validation.js

@@ -20,14 +20,14 @@ exports.detectXmlInText = detectXmlInText;
 exports.cleanXmlFromText = cleanXmlFromText;
 exports.validateRunText = validateRunText;
 exports.sanitizeHyperlinkUrl = sanitizeHyperlinkUrl;
-const types_1 = require("../zip/types");
-const errors_1 = require("../zip/errors");
-const logger_1 = require("./logger");
+const types_js_1 = require("../zip/types.js");
+const errors_js_1 = require("../zip/errors.js");
+const logger_js_1 = require("./logger.js");
 function validateDocxStructure(filePaths) {
     const fileSet = new Set(filePaths);
-    for (const requiredFile of types_1.REQUIRED_DOCX_FILES) {
+    for (const requiredFile of types_js_1.REQUIRED_DOCX_FILES) {
         if (!fileSet.has(requiredFile)) {
-            throw new errors_1.MissingRequiredFileError(requiredFile);
+            throw new errors_js_1.MissingRequiredFileError(requiredFile);
         }
     }
 }
@@ -268,8 +268,8 @@ function validateRunText(text, options = {}) {
     }
     if (warnToConsole && result.warnings.length > 0 && typeof console !== 'undefined') {
         const contextStr = context ? ` [${context}]` : '';
-        logger_1.defaultLogger.warn(`DocXML Text Validation Warning${contextStr}:`);
-        result.warnings.forEach((warning) => logger_1.defaultLogger.warn(`  - ${warning}`));
+        logger_js_1.defaultLogger.warn(`DocXML Text Validation Warning${contextStr}:`);
+        result.warnings.forEach((warning) => logger_js_1.defaultLogger.warn(`  - ${warning}`));
     }
     return result;
 }