@adeu/core 1.6.2 → 1.6.4

package/src/docx/bridge.ts

@@ -1,189 +1,189 @@
-import JSZip from 'jszip';
-import { parseXml, findChild, findAllDescendants, serializeXml } from './dom.js';
-
-export class Relationship {
-  constructor(
-    public id: string,
-    public type: string,
-    public target: string,
-    public isExternal: boolean
-  ) {}
-}
-
-export class Part {
-  public rels: Map<string, Relationship> = new Map();
-  public _element: Element;
-
-  constructor(
-    public partname: string,
-    public blob: string,
-    element: Element,
-    public contentType: string
-  ) {
-    this._element = element;
-  }
-
-  public addRelationship(id: string, type: string, target: string, isExternal: boolean = false) {
-    this.rels.set(id, new Relationship(id, type, target, isExternal));
-    
-    // If this part represents a .rels file, update the XML directly
-    if (this._element.tagName === 'Relationships') {
-      const doc = this._element.ownerDocument;
-      if (doc) {
-        const relEl = doc.createElement('Relationship');
-        relEl.setAttribute('Id', id);
-        relEl.setAttribute('Type', type);
-        relEl.setAttribute('Target', target);
-        if (isExternal) relEl.setAttribute('TargetMode', 'External');
-        this._element.appendChild(relEl);
-      }
-    }
-  }
-}
-
-export class DocxPackage {
-  public parts: Part[] = [];
-  public mainDocumentPart!: Part;
-
-  constructor(public zip: JSZip) {}
-
-  public getPartByPath(path: string): Part | undefined {
-    // Strip leading slash for jszip compat
-    const searchPath = path.startsWith('/') ? path.substring(1) : path;
-    return this.parts.find((p) => p.partname === searchPath || p.partname === '/' + searchPath);
-  }
-
-  public nextPartname(pattern: string): string {
-    let i = 1;
-    while (true) {
-      const candidate = pattern.replace('%d', i === 1 ? '' : i.toString());
-      if (!this.getPartByPath(candidate)) return candidate;
-      i++;
-    }
-  }
-
-  public addPart(partname: string, contentType: string, xmlString: string): Part {
-    const doc = parseXml(xmlString);
-    const part = new Part(partname, xmlString, doc.documentElement, contentType);
-    this.parts.push(part);
-
-    // Update [Content_Types].xml
-    const ctPart = this.getPartByPath('[Content_Types].xml');
-    if (ctPart) {
-      const docCT = ctPart._element.ownerDocument;
-      if (docCT) {
-        const override = docCT.createElement('Override');
-        override.setAttribute('PartName', partname);
-        override.setAttribute('ContentType', contentType);
-        ctPart._element.appendChild(override);
-      }
-    }
-    return part;
-  }
-
-  public getOrCreateRelsPart(sourcePartname: string): Part {
-    // e.g., /word/document.xml -> /word/_rels/document.xml.rels
-    const parts = sourcePartname.split('/');
-    const file = parts.pop();
-    const relsPath = parts.join('/') + '/_rels/' + file + '.rels';
-    
-    let relsPart = this.getPartByPath(relsPath);
-    if (!relsPart) {
-      const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>`;
-      relsPart = this.addPart(relsPath, 'application/vnd.openxmlformats-package.relationships+xml', xml);
-    }
-    return relsPart;
-  }
-}
-
-export class DocumentObject {
-  public part: Part;
-  public settings: { oddAndEvenPagesHeaderFooter: boolean } = { oddAndEvenPagesHeaderFooter: false };
-  // Simplification for the TS port: sections hold header/footer refs
-  public sections: any[] = []; 
-
-  constructor(public pkg: DocxPackage, part: Part) {
-    this.part = part;
-  }
-
-  public get element(): Element {
-    return findChild(this.part._element, 'w:body') || this.part._element;
-  }
-
-  /**
-   * Main entrypoint for loading a DOCX buffer into the DOM wrapper.
-   */
-  public static async load(buffer: Buffer | ArrayBuffer): Promise<DocumentObject> {
-    const zip = await JSZip.loadAsync(buffer);
-    const pkg = new DocxPackage(zip);
-
-    // 1. Load Content Types
-    const ctFile = zip.file('[Content_Types].xml');
-    let contentTypes: Record<string, string> = {};
-    if (ctFile) {
-      const ctXml = parseXml(await ctFile.async('text'));
-      const overrides = findAllDescendants(ctXml.documentElement, 'Override');
-      for (const override of overrides) {
-        contentTypes[override.getAttribute('PartName') || ''] = override.getAttribute('ContentType') || '';
-      }
-    }
-
-    // 2. Pre-load all XML parts to allow synchronous traversal later
-    for (const [path, file] of Object.entries(zip.files)) {
-      if (!file.dir && (path.endsWith('.xml') || path.endsWith('.rels'))) {
-        const text = await file.async('text');
-        const doc = parseXml(text);
-        const cType = contentTypes['/' + path] || 'application/xml';
-        const part = new Part('/' + path, text, doc.documentElement, cType);
-        pkg.parts.push(part);
-      }
-    }
-
-    // 3. Resolve Relationships for the main document
-    const mainPart = pkg.getPartByPath('word/document.xml');
-    if (!mainPart) throw new Error('Invalid DOCX: Missing word/document.xml');
-    pkg.mainDocumentPart = mainPart;
-
-    const relsPart = pkg.getPartByPath('word/_rels/document.xml.rels');
-    if (relsPart) {
-      const relElements = findAllDescendants(relsPart._element, 'Relationship');
-      for (const rel of relElements) {
-        const rId = rel.getAttribute('Id');
-        const target = rel.getAttribute('Target');
-        const type = rel.getAttribute('Type');
-        const targetMode = rel.getAttribute('TargetMode');
-        
-        if (rId && target && type) {
-          mainPart.rels.set(rId, new Relationship(rId, type, target, targetMode === 'External'));
-        }
-      }
-    }
-
-    return new DocumentObject(pkg, mainPart);
-  }
-
-  public relateTo(part: Part, relType: string) {
-    let rId = 1;
-    while (this.part.rels.has(`rId${rId}`)) rId++;
-    const id = `rId${rId}`;
-    
-    // In DOCX, targets in .rels are relative to the source part's directory.
-    // /word/document.xml relating to /word/comments.xml -> target is "comments.xml"
-    const target = part.partname.split('/').pop()!;
-    
-    this.part.rels.set(id, new Relationship(id, relType, target, false));
-    const relsPart = this.pkg.getOrCreateRelsPart(this.part.partname);
-    relsPart.addRelationship(id, relType, target, false);
-  }
-
-  public async save(): Promise<Buffer> {
-    for (const part of this.pkg.parts) {
-      let xmlStr = serializeXml(part._element.ownerDocument || part._element);
-      if (!xmlStr.startsWith('<?xml')) {
-        xmlStr = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' + xmlStr;
-      }
-      this.pkg.zip.file(part.partname.substring(1), xmlStr); // Strip leading slash for JSZip
-    }
-    return this.pkg.zip.generateAsync({ type: 'nodebuffer' });
-  }
+import JSZip from 'jszip';
+import { parseXml, findChild, findAllDescendants, serializeXml } from './dom.js';
+
+export class Relationship {
+  constructor(
+    public id: string,
+    public type: string,
+    public target: string,
+    public isExternal: boolean
+  ) {}
+}
+
+export class Part {
+  public rels: Map<string, Relationship> = new Map();
+  public _element: Element;
+
+  constructor(
+    public partname: string,
+    public blob: string,
+    element: Element,
+    public contentType: string
+  ) {
+    this._element = element;
+  }
+
+  public addRelationship(id: string, type: string, target: string, isExternal: boolean = false) {
+    this.rels.set(id, new Relationship(id, type, target, isExternal));
+    
+    // If this part represents a .rels file, update the XML directly
+    if (this._element.tagName === 'Relationships') {
+      const doc = this._element.ownerDocument;
+      if (doc) {
+        const relEl = doc.createElement('Relationship');
+        relEl.setAttribute('Id', id);
+        relEl.setAttribute('Type', type);
+        relEl.setAttribute('Target', target);
+        if (isExternal) relEl.setAttribute('TargetMode', 'External');
+        this._element.appendChild(relEl);
+      }
+    }
+  }
+}
+
+export class DocxPackage {
+  public parts: Part[] = [];
+  public mainDocumentPart!: Part;
+
+  constructor(public zip: JSZip) {}
+
+  public getPartByPath(path: string): Part | undefined {
+    // Strip leading slash for jszip compat
+    const searchPath = path.startsWith('/') ? path.substring(1) : path;
+    return this.parts.find((p) => p.partname === searchPath || p.partname === '/' + searchPath);
+  }
+
+  public nextPartname(pattern: string): string {
+    let i = 1;
+    while (true) {
+      const candidate = pattern.replace('%d', i === 1 ? '' : i.toString());
+      if (!this.getPartByPath(candidate)) return candidate;
+      i++;
+    }
+  }
+
+  public addPart(partname: string, contentType: string, xmlString: string): Part {
+    const doc = parseXml(xmlString);
+    const part = new Part(partname, xmlString, doc.documentElement, contentType);
+    this.parts.push(part);
+
+    // Update [Content_Types].xml
+    const ctPart = this.getPartByPath('[Content_Types].xml');
+    if (ctPart) {
+      const docCT = ctPart._element.ownerDocument;
+      if (docCT) {
+        const override = docCT.createElement('Override');
+        override.setAttribute('PartName', partname);
+        override.setAttribute('ContentType', contentType);
+        ctPart._element.appendChild(override);
+      }
+    }
+    return part;
+  }
+
+  public getOrCreateRelsPart(sourcePartname: string): Part {
+    // e.g., /word/document.xml -> /word/_rels/document.xml.rels
+    const parts = sourcePartname.split('/');
+    const file = parts.pop();
+    const relsPath = parts.join('/') + '/_rels/' + file + '.rels';
+    
+    let relsPart = this.getPartByPath(relsPath);
+    if (!relsPart) {
+      const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>`;
+      relsPart = this.addPart(relsPath, 'application/vnd.openxmlformats-package.relationships+xml', xml);
+    }
+    return relsPart;
+  }
+}
+
+export class DocumentObject {
+  public part: Part;
+  public settings: { oddAndEvenPagesHeaderFooter: boolean } = { oddAndEvenPagesHeaderFooter: false };
+  // Simplification for the TS port: sections hold header/footer refs
+  public sections: any[] = []; 
+
+  constructor(public pkg: DocxPackage, part: Part) {
+    this.part = part;
+  }
+
+  public get element(): Element {
+    return findChild(this.part._element, 'w:body') || this.part._element;
+  }
+
+  /**
+   * Main entrypoint for loading a DOCX buffer into the DOM wrapper.
+   */
+  public static async load(buffer: Buffer | ArrayBuffer): Promise<DocumentObject> {
+    const zip = await JSZip.loadAsync(buffer);
+    const pkg = new DocxPackage(zip);
+
+    // 1. Load Content Types
+    const ctFile = zip.file('[Content_Types].xml');
+    let contentTypes: Record<string, string> = {};
+    if (ctFile) {
+      const ctXml = parseXml(await ctFile.async('text'));
+      const overrides = findAllDescendants(ctXml.documentElement, 'Override');
+      for (const override of overrides) {
+        contentTypes[override.getAttribute('PartName') || ''] = override.getAttribute('ContentType') || '';
+      }
+    }
+
+    // 2. Pre-load all XML parts to allow synchronous traversal later
+    for (const [path, file] of Object.entries(zip.files)) {
+      if (!file.dir && (path.endsWith('.xml') || path.endsWith('.rels'))) {
+        const text = await file.async('text');
+        const doc = parseXml(text);
+        const cType = contentTypes['/' + path] || 'application/xml';
+        const part = new Part('/' + path, text, doc.documentElement, cType);
+        pkg.parts.push(part);
+      }
+    }
+
+    // 3. Resolve Relationships for the main document
+    const mainPart = pkg.getPartByPath('word/document.xml');
+    if (!mainPart) throw new Error('Invalid DOCX: Missing word/document.xml');
+    pkg.mainDocumentPart = mainPart;
+
+    const relsPart = pkg.getPartByPath('word/_rels/document.xml.rels');
+    if (relsPart) {
+      const relElements = findAllDescendants(relsPart._element, 'Relationship');
+      for (const rel of relElements) {
+        const rId = rel.getAttribute('Id');
+        const target = rel.getAttribute('Target');
+        const type = rel.getAttribute('Type');
+        const targetMode = rel.getAttribute('TargetMode');
+        
+        if (rId && target && type) {
+          mainPart.rels.set(rId, new Relationship(rId, type, target, targetMode === 'External'));
+        }
+      }
+    }
+
+    return new DocumentObject(pkg, mainPart);
+  }
+
+  public relateTo(part: Part, relType: string) {
+    let rId = 1;
+    while (this.part.rels.has(`rId${rId}`)) rId++;
+    const id = `rId${rId}`;
+    
+    // In DOCX, targets in .rels are relative to the source part's directory.
+    // /word/document.xml relating to /word/comments.xml -> target is "comments.xml"
+    const target = part.partname.split('/').pop()!;
+    
+    this.part.rels.set(id, new Relationship(id, relType, target, false));
+    const relsPart = this.pkg.getOrCreateRelsPart(this.part.partname);
+    relsPart.addRelationship(id, relType, target, false);
+  }
+
+  public async save(): Promise<Buffer> {
+    for (const part of this.pkg.parts) {
+      let xmlStr = serializeXml(part._element.ownerDocument || part._element);
+      if (!xmlStr.startsWith('<?xml')) {
+        xmlStr = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' + xmlStr;
+      }
+      this.pkg.zip.file(part.partname.substring(1), xmlStr); // Strip leading slash for JSZip
+    }
+    return this.pkg.zip.generateAsync({ type: 'nodebuffer' });
+  }
 }

package/src/docx/dom.ts

@@ -1,54 +1,54 @@
-import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
-
-/**
- * Simulates docx.oxml.ns.qn. In xmldom, namespaces are preserved in tagName.
- */
-export const qn = (name: string) => name;
-
-/**
- * Simulates lxml element.find("w:tag") - strictly searches DIRECT children only.
- */
-export function findChild(element: Element, tagName: string): Element | null {
-  for (let i = 0; i < element.childNodes.length; i++) {
-    const child = element.childNodes[i];
-    if (child.nodeType === 1 /* ELEMENT_NODE */ && (child as Element).tagName === tagName) {
-      return child as Element;
-    }
-  }
-  return null;
-}
-
-/**
- * Simulates lxml element.findall("w:tag") - strictly searches DIRECT children only.
- */
-export function findChildren(element: Element, tagName: string): Element[] {
-  const result: Element[] = [];
-  for (let i = 0; i < element.childNodes.length; i++) {
-    const child = element.childNodes[i];
-    if (child.nodeType === 1 && (child as Element).tagName === tagName) {
-      result.push(child as Element);
-    }
-  }
-  return result;
-}
-
-/**
- * Simulates lxml element.findall(".//w:tag") - searches ALL descendants.
- */
-export function findAllDescendants(element: Element, tagName: string): Element[] {
-  return Array.from(element.getElementsByTagName(tagName));
-}
-
-/**
- * Parses raw XML strings into xmldom Documents.
- */
-export function parseXml(xmlString: string): Document {
-  return new DOMParser().parseFromString(xmlString, 'text/xml');
-}
-
-/**
- * Serializes an xmldom Document or Element back to a string.
- */
-export function serializeXml(node: Node): string {
-  return new XMLSerializer().serializeToString(node);
+import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
+
+/**
+ * Simulates docx.oxml.ns.qn. In xmldom, namespaces are preserved in tagName.
+ */
+export const qn = (name: string) => name;
+
+/**
+ * Simulates lxml element.find("w:tag") - strictly searches DIRECT children only.
+ */
+export function findChild(element: Element, tagName: string): Element | null {
+  for (let i = 0; i < element.childNodes.length; i++) {
+    const child = element.childNodes[i];
+    if (child.nodeType === 1 /* ELEMENT_NODE */ && (child as Element).tagName === tagName) {
+      return child as Element;
+    }
+  }
+  return null;
+}
+
+/**
+ * Simulates lxml element.findall("w:tag") - strictly searches DIRECT children only.
+ */
+export function findChildren(element: Element, tagName: string): Element[] {
+  const result: Element[] = [];
+  for (let i = 0; i < element.childNodes.length; i++) {
+    const child = element.childNodes[i];
+    if (child.nodeType === 1 && (child as Element).tagName === tagName) {
+      result.push(child as Element);
+    }
+  }
+  return result;
+}
+
+/**
+ * Simulates lxml element.findall(".//w:tag") - searches ALL descendants.
+ */
+export function findAllDescendants(element: Element, tagName: string): Element[] {
+  return Array.from(element.getElementsByTagName(tagName));
+}
+
+/**
+ * Parses raw XML strings into xmldom Documents.
+ */
+export function parseXml(xmlString: string): Document {
+  return new DOMParser().parseFromString(xmlString, 'text/xml');
+}
+
+/**
+ * Serializes an xmldom Document or Element back to a string.
+ */
+export function serializeXml(node: Node): string {
+  return new XMLSerializer().serializeToString(node);
 }

package/src/docx/primitives.ts

@@ -1,65 +1,65 @@
-import { findChild } from './dom.js';
-
-export class Paragraph {
-  constructor(public _element: Element, public _parent: any) {}
-  
-  get text(): string {
-    let t = '';
-    const texts = this._element.getElementsByTagName('w:t');
-    for (let i = 0; i < texts.length; i++) {
-      t += texts[i].textContent || '';
-    }
-    return t;
-  }
-}
-
-export class Run {
-  constructor(public _element: Element, public _parent: any) {}
-}
-
-export class Cell {
-  constructor(public _element: Element, public _parent: any) {}
-}
-
-export class Row {
-  public cells: Cell[] = [];
-  constructor(public _element: Element, public _parent: any) {
-    const tcs = this._element.getElementsByTagName('w:tc');
-    for (let i = 0; i < tcs.length; i++) {
-      this.cells.push(new Cell(tcs[i], this));
-    }
-  }
-}
-
-export class Table {
-  public rows: Row[] = [];
-  constructor(public _element: Element, public _parent: any) {
-    const trs = this._element.getElementsByTagName('w:tr');
-    for (let i = 0; i < trs.length; i++) {
-      this.rows.push(new Row(trs[i], this));
-    }
-  }
-}
-
-export class NotesPart {
-  public _element: Element;
-  constructor(public part: any, public note_type: 'fn' | 'en') {
-    this._element = part._element;
-  }
-}
-
-export class FootnoteItem {
-  public id: string;
-  public part: any;
-  constructor(public _element: Element, public _parent: any, public note_type: 'fn' | 'en') {
-    this.id = _element.getAttribute('w:id') || '';
-    this.part = _parent.part;
-  }
-}
-
-export interface DocxEvent {
-  type: string;
-  id: string;
-  author?: string;
-  date?: string;
+import { findChild } from './dom.js';
+
+export class Paragraph {
+  constructor(public _element: Element, public _parent: any) {}
+  
+  get text(): string {
+    let t = '';
+    const texts = this._element.getElementsByTagName('w:t');
+    for (let i = 0; i < texts.length; i++) {
+      t += texts[i].textContent || '';
+    }
+    return t;
+  }
+}
+
+export class Run {
+  constructor(public _element: Element, public _parent: any) {}
+}
+
+export class Cell {
+  constructor(public _element: Element, public _parent: any) {}
+}
+
+export class Row {
+  public cells: Cell[] = [];
+  constructor(public _element: Element, public _parent: any) {
+    const tcs = this._element.getElementsByTagName('w:tc');
+    for (let i = 0; i < tcs.length; i++) {
+      this.cells.push(new Cell(tcs[i], this));
+    }
+  }
+}
+
+export class Table {
+  public rows: Row[] = [];
+  constructor(public _element: Element, public _parent: any) {
+    const trs = this._element.getElementsByTagName('w:tr');
+    for (let i = 0; i < trs.length; i++) {
+      this.rows.push(new Row(trs[i], this));
+    }
+  }
+}
+
+export class NotesPart {
+  public _element: Element;
+  constructor(public part: any, public note_type: 'fn' | 'en') {
+    this._element = part._element;
+  }
+}
+
+export class FootnoteItem {
+  public id: string;
+  public part: any;
+  constructor(public _element: Element, public _parent: any, public note_type: 'fn' | 'en') {
+    this.id = _element.getAttribute('w:id') || '';
+    this.part = _parent.part;
+  }
+}
+
+export interface DocxEvent {
+  type: string;
+  id: string;
+  author?: string;
+  date?: string;
 }

package/src/domain.ts

@@ -1,11 +1,11 @@
-/**
- * Lightweight port of domain.py (Semantic Diagnostics & Appendix).
- * Uses a simplified heuristic since full rapidfuzz isn't available.
- */
-
-export function build_structural_appendix(doc: any, base_text: string): string {
-  // To keep the initial ingestion port lean and maintain 100% parity on body text,
-  // we will return an empty appendix string for now. The python port can be completed
-  // in a follow-up PR if diagnostics are required in Node MCPs.
-  return '';
+/**
+ * Lightweight port of domain.py (Semantic Diagnostics & Appendix).
+ * Uses a simplified heuristic since full rapidfuzz isn't available.
+ */
+
+export function build_structural_appendix(doc: any, base_text: string): string {
+  // To keep the initial ingestion port lean and maintain 100% parity on body text,
+  // we will return an empty appendix string for now. The python port can be completed
+  // in a follow-up PR if diagnostics are required in Node MCPs.
+  return '';
 }