docxmlater 10.4.0 → 11.0.4

package/dist/esm/core/DocumentContent.js

@@ -0,0 +1,190 @@
+import { Paragraph } from '../elements/Paragraph.js';
+import { Table } from '../elements/Table.js';
+import { Section } from '../elements/Section.js';
+import { StructuredDocumentTag } from '../elements/StructuredDocumentTag.js';
+import { TableOfContentsElement } from '../elements/TableOfContentsElement.js';
+export class DocumentContent {
+    bodyElements = [];
+    section;
+    constructor() {
+        this.section = new Section();
+    }
+    addParagraph(paragraph) {
+        this.bodyElements.push(paragraph);
+        return this;
+    }
+    createParagraph(text) {
+        const para = new Paragraph();
+        if (text) {
+            para.addText(text);
+        }
+        this.bodyElements.push(para);
+        return para;
+    }
+    addTable(table) {
+        this.bodyElements.push(table);
+        return this;
+    }
+    createTable(rows, columns) {
+        const table = new Table(rows, columns);
+        this.bodyElements.push(table);
+        return table;
+    }
+    addStructuredDocumentTag(sdt) {
+        this.bodyElements.push(sdt);
+        return this;
+    }
+    addTableOfContents(toc) {
+        this.bodyElements.push(toc);
+        return this;
+    }
+    addBodyElement(element) {
+        this.bodyElements.push(element);
+        return this;
+    }
+    insertBodyElementAt(index, element) {
+        index = Math.max(0, Math.min(index, this.bodyElements.length));
+        this.bodyElements.splice(index, 0, element);
+        return this;
+    }
+    removeBodyElementAt(index) {
+        if (index < 0 || index >= this.bodyElements.length) {
+            return undefined;
+        }
+        return this.bodyElements.splice(index, 1)[0];
+    }
+    getBodyElements() {
+        return [...this.bodyElements];
+    }
+    getBodyElementsMutable() {
+        return this.bodyElements;
+    }
+    getParagraphs() {
+        return this.bodyElements.filter((el) => el instanceof Paragraph);
+    }
+    getAllParagraphs() {
+        const paragraphs = [];
+        const collectParagraphs = (elements) => {
+            for (const element of elements) {
+                if (element instanceof Paragraph) {
+                    paragraphs.push(element);
+                }
+                else if (element instanceof Table) {
+                    for (let row = 0; row < element.getRowCount(); row++) {
+                        for (let col = 0; col < element.getColumnCount(); col++) {
+                            const cell = element.getCell(row, col);
+                            if (cell) {
+                                paragraphs.push(...cell.getParagraphs());
+                            }
+                        }
+                    }
+                }
+                else if (element instanceof StructuredDocumentTag) {
+                    const content = element.getContent();
+                    collectParagraphs(content);
+                }
+            }
+        };
+        collectParagraphs(this.bodyElements);
+        return paragraphs;
+    }
+    getTables() {
+        return this.bodyElements.filter((el) => el instanceof Table);
+    }
+    getAllTables() {
+        const tables = [];
+        const collectTables = (elements) => {
+            for (const element of elements) {
+                if (element instanceof Table) {
+                    tables.push(element);
+                }
+                else if (element instanceof StructuredDocumentTag) {
+                    collectTables(element.getContent());
+                }
+            }
+        };
+        collectTables(this.bodyElements);
+        return tables;
+    }
+    getTableOfContentsElements() {
+        return this.bodyElements.filter((el) => el instanceof TableOfContentsElement);
+    }
+    getStructuredDocumentTags() {
+        return this.bodyElements.filter((el) => el instanceof StructuredDocumentTag);
+    }
+    getBodyElementCount() {
+        return this.bodyElements.length;
+    }
+    getParagraphCount() {
+        return this.getParagraphs().length;
+    }
+    getTableCount() {
+        return this.getTables().length;
+    }
+    getSection() {
+        return this.section;
+    }
+    setSection(section) {
+        this.section = section;
+        return this;
+    }
+    clear() {
+        this.bodyElements = [];
+        return this;
+    }
+    clearParagraphs() {
+        this.bodyElements = this.bodyElements.filter((el) => !(el instanceof Paragraph));
+        return this;
+    }
+    clearTables() {
+        this.bodyElements = this.bodyElements.filter((el) => !(el instanceof Table));
+        return this;
+    }
+    indexOf(element) {
+        return this.bodyElements.indexOf(element);
+    }
+    contains(element) {
+        return this.bodyElements.includes(element);
+    }
+    findParagraphsByStyle(styleId) {
+        const results = [];
+        const normalizedStyleId = styleId.toLowerCase();
+        for (const paragraph of this.getAllParagraphs()) {
+            const paraStyle = paragraph.getStyle()?.toLowerCase();
+            if (paraStyle === normalizedStyleId) {
+                results.push(paragraph);
+            }
+        }
+        return results;
+    }
+    getWordCount() {
+        let wordCount = 0;
+        for (const paragraph of this.getAllParagraphs()) {
+            const text = paragraph.getText();
+            if (text) {
+                wordCount += text.split(/\s+/).filter((word) => word.length > 0).length;
+            }
+        }
+        return wordCount;
+    }
+    getCharacterCount(includeSpaces = true) {
+        let charCount = 0;
+        for (const paragraph of this.getAllParagraphs()) {
+            const text = paragraph.getText();
+            if (text) {
+                charCount += includeSpaces ? text.length : text.replace(/\s/g, '').length;
+            }
+        }
+        return charCount;
+    }
+    clone() {
+        const cloned = new DocumentContent();
+        cloned.bodyElements = [...this.bodyElements];
+        cloned.section = this.section?.clone();
+        return cloned;
+    }
+    isEmpty() {
+        return this.bodyElements.length === 0;
+    }
+}
+//# sourceMappingURL=DocumentContent.js.map

package/dist/esm/core/DocumentContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentContent.js","sourceRoot":"","sources":["../../../src/core/DocumentContent.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DocumentContent - Manages document body elements\n *\n * Handles paragraphs, tables, sections, and other body elements.\n * Extracted from Document.ts for better separation of concerns.\n */\n\nimport { Paragraph } from '../elements/Paragraph.js';\nimport { Table } from '../elements/Table.js';\nimport { Section } from '../elements/Section.js';\nimport { StructuredDocumentTag } from '../elements/StructuredDocumentTag.js';\nimport { TableOfContentsElement } from '../elements/TableOfContentsElement.js';\nimport { AlternateContent } from '../elements/AlternateContent.js';\nimport { MathParagraph } from '../elements/MathElement.js';\nimport { CustomXmlBlock } from '../elements/CustomXml.js';\nimport { PreservedElement } from '../elements/PreservedElement.js';\nimport { RegisteredBodyElement } from '../elements/RegisteredBodyElement.js';\n\n/**\n * Body element type — Paragraph, Table, TOC, SDT, raw passthrough, or\n * a consumer-defined element produced by `ElementRegistry`.\n */\nexport type BodyElement =\n  | Paragraph\n  | Table\n  | TableOfContentsElement\n  | StructuredDocumentTag\n  | AlternateContent\n  | MathParagraph\n  | CustomXmlBlock\n  | PreservedElement\n  | RegisteredBodyElement;\n\n/**\n * Manages document content (paragraphs, tables, sections)\n */\nexport class DocumentContent {\n  private bodyElements: BodyElement[] = [];\n  private section: Section;\n\n  constructor() {\n    this.section = new Section();\n  }\n\n  // ==================== Body Elements ====================\n\n  /**\n   * Adds an existing paragraph to the document body\n   *\n   * @param paragraph - The Paragraph instance to add\n   * @returns This instance for chaining\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.bodyElements.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates a new paragraph and adds it to the document\n   *\n   * @param text - Optional text content for the paragraph\n   * @returns The created Paragraph instance\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.bodyElements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds an existing table to the document body\n   *\n   * @param table - The Table instance to add\n   * @returns This instance for chaining\n   */\n  addTable(table: Table): this {\n    this.bodyElements.push(table);\n    return this;\n  }\n\n  /**\n   * Creates a new table and adds it to the document\n   *\n   * @param rows - Number of rows to create\n   * @param columns - Number of columns per row\n   * @returns The created Table instance\n   */\n  createTable(rows: number, columns: number): Table {\n    const table = new Table(rows, columns);\n    this.bodyElements.push(table);\n    return table;\n  }\n\n  /**\n   * Adds a Structured Document Tag to the document body\n   *\n   * @param sdt - The StructuredDocumentTag instance to add\n   * @returns This instance for chaining\n   */\n  addStructuredDocumentTag(sdt: StructuredDocumentTag): this {\n    this.bodyElements.push(sdt);\n    return this;\n  }\n\n  /**\n   * Adds a Table of Contents element to the document body\n   *\n   * @param toc - The TableOfContentsElement to add\n   * @returns This instance for chaining\n   */\n  addTableOfContents(toc: TableOfContentsElement): this {\n    this.bodyElements.push(toc);\n    return this;\n  }\n\n  /**\n   * Adds any body element to the document\n   *\n   * @param element - The body element to add\n   * @returns This instance for chaining\n   */\n  addBodyElement(element: BodyElement): this {\n    this.bodyElements.push(element);\n    return this;\n  }\n\n  /**\n   * Inserts a body element at a specific index\n   *\n   * @param index - Position to insert at (0-based)\n   * @param element - The body element to insert\n   * @returns This instance for chaining\n   */\n  insertBodyElementAt(index: number, element: BodyElement): this {\n    index = Math.max(0, Math.min(index, this.bodyElements.length));\n    this.bodyElements.splice(index, 0, element);\n    return this;\n  }\n\n  /**\n   * Removes a body element at a specific index\n   *\n   * @param index - Position to remove from (0-based)\n   * @returns The removed element or undefined\n   */\n  removeBodyElementAt(index: number): BodyElement | undefined {\n    if (index < 0 || index >= this.bodyElements.length) {\n      return undefined;\n    }\n    return this.bodyElements.splice(index, 1)[0];\n  }\n\n  // ==================== Getters ====================\n\n  /**\n   * Gets all body elements\n   *\n   * @returns Array of all body elements\n   */\n  getBodyElements(): BodyElement[] {\n    return [...this.bodyElements];\n  }\n\n  /**\n   * Gets body elements with mutable access (internal use)\n   *\n   * @returns Reference to body elements array\n   * @internal\n   */\n  getBodyElementsMutable(): BodyElement[] {\n    return this.bodyElements;\n  }\n\n  /**\n   * Gets top-level paragraphs only\n   *\n   * @returns Array of Paragraph instances in document body\n   */\n  getParagraphs(): Paragraph[] {\n    return this.bodyElements.filter((el): el is Paragraph => el instanceof Paragraph);\n  }\n\n  /**\n   * Gets all paragraphs including nested ones (in tables, SDTs)\n   *\n   * @returns Array of all Paragraph instances\n   */\n  getAllParagraphs(): Paragraph[] {\n    const paragraphs: Paragraph[] = [];\n\n    const collectParagraphs = (elements: BodyElement[]) => {\n      for (const element of elements) {\n        if (element instanceof Paragraph) {\n          paragraphs.push(element);\n        } else if (element instanceof Table) {\n          // Collect paragraphs from table cells\n          for (let row = 0; row < element.getRowCount(); row++) {\n            for (let col = 0; col < element.getColumnCount(); col++) {\n              const cell = element.getCell(row, col);\n              if (cell) {\n                paragraphs.push(...cell.getParagraphs());\n              }\n            }\n          }\n        } else if (element instanceof StructuredDocumentTag) {\n          // Recursively collect from SDT content\n          const content = element.getContent();\n          collectParagraphs(content as BodyElement[]);\n        }\n      }\n    };\n\n    collectParagraphs(this.bodyElements);\n    return paragraphs;\n  }\n\n  /**\n   * Gets top-level tables only\n   *\n   * @returns Array of Table instances in document body\n   */\n  getTables(): Table[] {\n    return this.bodyElements.filter((el): el is Table => el instanceof Table);\n  }\n\n  /**\n   * Gets all tables including nested ones\n   *\n   * @returns Array of all Table instances\n   */\n  getAllTables(): Table[] {\n    const tables: Table[] = [];\n\n    const collectTables = (elements: BodyElement[]) => {\n      for (const element of elements) {\n        if (element instanceof Table) {\n          tables.push(element);\n        } else if (element instanceof StructuredDocumentTag) {\n          collectTables(element.getContent() as BodyElement[]);\n        }\n      }\n    };\n\n    collectTables(this.bodyElements);\n    return tables;\n  }\n\n  /**\n   * Gets Table of Contents elements\n   *\n   * @returns Array of TableOfContentsElement instances\n   */\n  getTableOfContentsElements(): TableOfContentsElement[] {\n    return this.bodyElements.filter(\n      (el): el is TableOfContentsElement => el instanceof TableOfContentsElement\n    );\n  }\n\n  /**\n   * Gets Structured Document Tags\n   *\n   * @returns Array of StructuredDocumentTag instances\n   */\n  getStructuredDocumentTags(): StructuredDocumentTag[] {\n    return this.bodyElements.filter(\n      (el): el is StructuredDocumentTag => el instanceof StructuredDocumentTag\n    );\n  }\n\n  // ==================== Counts ====================\n\n  /**\n   * Gets the total number of body elements\n   */\n  getBodyElementCount(): number {\n    return this.bodyElements.length;\n  }\n\n  /**\n   * Gets the number of top-level paragraphs\n   */\n  getParagraphCount(): number {\n    return this.getParagraphs().length;\n  }\n\n  /**\n   * Gets the number of top-level tables\n   */\n  getTableCount(): number {\n    return this.getTables().length;\n  }\n\n  // ==================== Section ====================\n\n  /**\n   * Gets the document section (page setup, margins, etc.)\n   *\n   * @returns The Section instance\n   */\n  getSection(): Section {\n    return this.section;\n  }\n\n  /**\n   * Sets the document section\n   *\n   * @param section - The Section instance to set\n   * @returns This instance for chaining\n   */\n  setSection(section: Section): this {\n    this.section = section;\n    return this;\n  }\n\n  // ==================== Clearing ====================\n\n  /**\n   * Clears all body elements\n   *\n   * @returns This instance for chaining\n   */\n  clear(): this {\n    this.bodyElements = [];\n    return this;\n  }\n\n  /**\n   * Clears all paragraphs from the document\n   *\n   * @returns This instance for chaining\n   */\n  clearParagraphs(): this {\n    this.bodyElements = this.bodyElements.filter((el) => !(el instanceof Paragraph));\n    return this;\n  }\n\n  /**\n   * Clears all tables from the document\n   *\n   * @returns This instance for chaining\n   */\n  clearTables(): this {\n    this.bodyElements = this.bodyElements.filter((el) => !(el instanceof Table));\n    return this;\n  }\n\n  // ==================== Search ====================\n\n  /**\n   * Finds the index of a body element\n   *\n   * @param element - The element to find\n   * @returns Index or -1 if not found\n   */\n  indexOf(element: BodyElement): number {\n    return this.bodyElements.indexOf(element);\n  }\n\n  /**\n   * Checks if a body element exists\n   *\n   * @param element - The element to check\n   * @returns true if the element is in the document\n   */\n  contains(element: BodyElement): boolean {\n    return this.bodyElements.includes(element);\n  }\n\n  /**\n   * Finds paragraphs by style ID\n   *\n   * @param styleId - The style ID to search for\n   * @returns Array of paragraphs with the style\n   */\n  findParagraphsByStyle(styleId: string): Paragraph[] {\n    const results: Paragraph[] = [];\n    const normalizedStyleId = styleId.toLowerCase();\n\n    for (const paragraph of this.getAllParagraphs()) {\n      const paraStyle = paragraph.getStyle()?.toLowerCase();\n      if (paraStyle === normalizedStyleId) {\n        results.push(paragraph);\n      }\n    }\n\n    return results;\n  }\n\n  // ==================== Statistics ====================\n\n  /**\n   * Gets word count for all text content\n   *\n   * @returns Approximate word count\n   */\n  getWordCount(): number {\n    let wordCount = 0;\n    for (const paragraph of this.getAllParagraphs()) {\n      const text = paragraph.getText();\n      if (text) {\n        // Simple word counting - split on whitespace\n        wordCount += text.split(/\\s+/).filter((word) => word.length > 0).length;\n      }\n    }\n    return wordCount;\n  }\n\n  /**\n   * Gets character count for all text content\n   *\n   * @param includeSpaces - Whether to include spaces (default: true)\n   * @returns Character count\n   */\n  getCharacterCount(includeSpaces = true): number {\n    let charCount = 0;\n    for (const paragraph of this.getAllParagraphs()) {\n      const text = paragraph.getText();\n      if (text) {\n        charCount += includeSpaces ? text.length : text.replace(/\\s/g, '').length;\n      }\n    }\n    return charCount;\n  }\n\n  // ==================== Utility ====================\n\n  /**\n   * Creates a clone of this content instance\n   *\n   * Note: This creates shallow copies of body elements.\n   * For deep cloning, individual elements should be cloned.\n   *\n   * @returns New DocumentContent instance\n   */\n  clone(): DocumentContent {\n    const cloned = new DocumentContent();\n    cloned.bodyElements = [...this.bodyElements];\n    cloned.section = this.section?.clone();\n    return cloned;\n  }\n\n  /**\n   * Checks if the document has any content\n   *\n   * @returns true if document has no body elements\n   */\n  isEmpty(): boolean {\n    return this.bodyElements.length === 0;\n  }\n}\n"]}

package/dist/esm/core/DocumentEvents.js

@@ -0,0 +1,47 @@
+import { getGlobalLogger } from '../utils/logger.js';
+export class DocumentEventEmitter {
+    listeners = new Map();
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => this.off(event, listener);
+    }
+    off(event, listener) {
+        const set = this.listeners.get(event);
+        if (set) {
+            set.delete(listener);
+        }
+    }
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (!set || set.size === 0)
+            return;
+        for (const listener of set) {
+            try {
+                listener(payload);
+            }
+            catch (err) {
+                getGlobalLogger().warn('Document event listener threw', {
+                    event,
+                    error: String(err),
+                });
+            }
+        }
+    }
+    removeAllListeners(event) {
+        if (event) {
+            this.listeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    listenerCount(event) {
+        return this.listeners.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=DocumentEvents.js.map

package/dist/esm/core/DocumentEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentEvents.js","sourceRoot":"","sources":["../../../src/core/DocumentEvents.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA4BrD,MAAM,OAAO,oBAAoB;IACvB,SAAS,GAAG,IAAI,GAAG,EAAoE,CAAC;IAEhG,EAAE,CAA8B,KAAQ,EAAE,QAAkC;QAC1E,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAoD,CAAC,CAAC;QAC9D,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAA8B,KAAQ,EAAE,QAAkC;QAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,CAAC,QAAoD,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,CAA8B,KAAQ,EAAE,OAA4B;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACnC,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACF,QAAqC,CAAC,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,eAAe,EAAE,CAAC,IAAI,CAAC,+BAA+B,EAAE;oBACtD,KAAK;oBACL,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,KAAyB;QAC1C,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAAwB;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF","sourcesContent":["/**\n * Lightweight event system for Document lifecycle and content mutations.\n *\n * Designed for batch pipelines that need to react to programmatic edits\n * (e.g., audit-logging every `paragraphAdded`). Listeners are synchronous;\n * thrown errors are caught and logged via the global logger so a bad\n * listener cannot abort `save()` or corrupt document state.\n *\n * `beforeSave` fires inside the save lock; `afterSave` and `afterLoad`\n * fire only after success. Mutation events fire synchronously after the\n * mutation is applied. Pure structural moves (moveElement) and\n * load/parse-time construction do not fire mutation events.\n */\nimport type { Paragraph } from '../elements/Paragraph.js';\nimport type { Table } from '../elements/Table.js';\nimport { getGlobalLogger } from '../utils/logger.js';\n\nexport interface DocumentEventMap {\n  /** Fired after a paragraph is added to the document body. */\n  paragraphAdded: { paragraph: Paragraph; index?: number };\n  /** Fired after a paragraph is removed from the document body. */\n  paragraphRemoved: { paragraph: Paragraph };\n  /** Fired after a table is added to the document body. */\n  tableAdded: { table: Table };\n  /** Fired after a table is removed from the document body. */\n  tableRemoved: { table: Table };\n  /** Fired immediately before save() / toBuffer() begins generation. */\n  beforeSave: { filePath?: string };\n  /** Fired immediately after save() / toBuffer() completes successfully. */\n  afterSave: { filePath?: string; bufferSize?: number };\n  /** Fired immediately after a load() / loadFromBuffer() completes. */\n  afterLoad: { source: 'file' | 'buffer'; path?: string };\n}\n\nexport type DocumentEventType = keyof DocumentEventMap;\n\nexport type DocumentEventListener<T extends DocumentEventType> = (\n  payload: DocumentEventMap[T]\n) => void;\n\n/**\n * Internal emitter implementation. Stored on each Document instance.\n */\nexport class DocumentEventEmitter {\n  private listeners = new Map<DocumentEventType, Set<DocumentEventListener<DocumentEventType>>>();\n\n  on<T extends DocumentEventType>(event: T, listener: DocumentEventListener<T>): () => void {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(listener as DocumentEventListener<DocumentEventType>);\n    return () => this.off(event, listener);\n  }\n\n  off<T extends DocumentEventType>(event: T, listener: DocumentEventListener<T>): void {\n    const set = this.listeners.get(event);\n    if (set) {\n      set.delete(listener as DocumentEventListener<DocumentEventType>);\n    }\n  }\n\n  emit<T extends DocumentEventType>(event: T, payload: DocumentEventMap[T]): void {\n    const set = this.listeners.get(event);\n    if (!set || set.size === 0) return;\n    for (const listener of set) {\n      try {\n        (listener as DocumentEventListener<T>)(payload);\n      } catch (err) {\n        getGlobalLogger().warn('Document event listener threw', {\n          event,\n          error: String(err),\n        });\n      }\n    }\n  }\n\n  removeAllListeners(event?: DocumentEventType): void {\n    if (event) {\n      this.listeners.delete(event);\n    } else {\n      this.listeners.clear();\n    }\n  }\n\n  listenerCount(event: DocumentEventType): number {\n    return this.listeners.get(event)?.size ?? 0;\n  }\n}\n"]}