@cj-tech-master/excelts 9.5.4 → 9.5.5

package/dist/browser/modules/word/constants.d.ts

@@ -16,6 +16,23 @@ export declare const NS_A = "http://schemas.openxmlformats.org/drawingml/2006/ma
 export declare const NS_PIC = "http://schemas.openxmlformats.org/drawingml/2006/picture";
 /** Markup compatibility namespace (mc:). */
 export declare const NS_MC = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+/** Strict WordprocessingML main namespace. */
+export declare const NS_W_STRICT = "http://purl.oclc.org/ooxml/wordprocessingml/main";
+/** Strict Relationships namespace. */
+export declare const NS_R_STRICT = "http://purl.oclc.org/ooxml/officeDocument/relationships";
+/** Strict DrawingML Word Processing Drawing namespace. */
+export declare const NS_WP_STRICT = "http://purl.oclc.org/ooxml/drawingml/wordprocessingDrawing";
+/** Strict DrawingML main namespace. */
+export declare const NS_A_STRICT = "http://purl.oclc.org/ooxml/drawingml/main";
+/** Strict DrawingML picture namespace. */
+export declare const NS_PIC_STRICT = "http://purl.oclc.org/ooxml/drawingml/picture";
+/** Strict Markup compatibility namespace. */
+export declare const NS_MC_STRICT = "http://purl.oclc.org/ooxml/markup-compatibility/2006";
+/**
+ * Maps ISO 29500 Strict namespace URIs to their Transitional equivalents.
+ * Used during reading to normalize Strict documents into the internal model.
+ */
+export declare const STRICT_TO_TRANSITIONAL_NS: ReadonlyMap<string, string>;
 /** VML namespace (v:). */
 export declare const NS_V = "urn:schemas-microsoft-com:vml";
 /** Office VML extensions (o:). */
@@ -64,8 +81,19 @@ export declare const NS_CONTENT_TYPES = "http://schemas.openxmlformats.org/packa
 export declare const NS_PKG_RELS = "http://schemas.openxmlformats.org/package/2006/relationships";
 /** DrawingML picture URI for graphicData. */
 export declare const URI_PIC = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+/** DrawingML chart namespace (c:). */
+export declare const NS_C_CHART = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+/** Chart Extensions namespace (cx:) — Office 2016+ chartEx. */
+export declare const NS_CX_CHART = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+/** Flat OPC packaging namespace. */
+export declare const NS_PKG = "http://schemas.microsoft.com/office/2006/xmlPackage";
 /** Standard namespace attributes for w:document root element. */
-export declare const DOCUMENT_NAMESPACES: Record<string, string>;
+export declare const DOCUMENT_NAMESPACES: Readonly<Record<string, string>>;
+/**
+ * Maps ISO 29500 Strict relationship type URIs to their Transitional equivalents.
+ * Used during reading to normalize Strict documents.
+ */
+export declare const STRICT_TO_TRANSITIONAL_REL: ReadonlyMap<string, string>;
 /** OOXML relationship type URIs. */
 export declare const RelType: {
     readonly OfficeDocument: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
@@ -89,11 +117,13 @@ export declare const RelType: {
     readonly Glossary: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/glossaryDocument";
     readonly Font: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
     readonly Chart: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
+    readonly ChartEx: "http://schemas.microsoft.com/office/2014/relationships/chartEx";
     readonly Diagram: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData";
     readonly CustomXml: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml";
     readonly CustomXmlProps: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXmlProps";
     readonly VbaProject: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vbaProject";
     readonly People: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/people";
+    readonly Package: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/package";
     readonly DigitalSignature: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/digital-signature/signature";
 };
 /** OOXML content type strings. */
@@ -101,6 +131,12 @@ export declare const ContentType: {
     readonly Relationships: "application/vnd.openxmlformats-package.relationships+xml";
     readonly Xml: "application/xml";
     readonly Document: "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml";
+    /** Macro-enabled document (.docm) main part. */
+    readonly DocumentMacroEnabled: "application/vnd.ms-word.document.macroEnabled.main+xml";
+    /** Template (.dotx) main part. */
+    readonly Template: "application/vnd.openxmlformats-officedocument.wordprocessingml.template.main+xml";
+    /** Macro-enabled template (.dotm) main part. */
+    readonly TemplateMacroEnabled: "application/vnd.ms-word.template.macroEnabled.main+xml";
     readonly Styles: "application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml";
     readonly Settings: "application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml";
     readonly FontTable: "application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml";
@@ -128,6 +164,8 @@ export declare const ContentType: {
     readonly Wmf: "image/x-wmf";
     readonly ObfuscatedFont: "application/vnd.openxmlformats-officedocument.obfuscatedFont";
     readonly Chart: "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
+    readonly ChartEx: "application/vnd.ms-office.chartEx+xml";
+    readonly Xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
     readonly CustomXml: "application/xml";
     readonly VbaProject: "application/vnd.ms-office.vbaProject";
 };

package/dist/browser/modules/word/constants.js

@@ -5,7 +5,7 @@
  * for the OOXML WordprocessingML format.
  */
 // =============================================================================
-// XML Namespaces
+// XML Namespaces (Transitional — ECMA-376 Part 4)
 // =============================================================================
 /** WordprocessingML main namespace (w:). */
 export const NS_W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
@@ -19,6 +19,60 @@ export const NS_A = "http://schemas.openxmlformats.org/drawingml/2006/main";
 export const NS_PIC = "http://schemas.openxmlformats.org/drawingml/2006/picture";
 /** Markup compatibility namespace (mc:). */
 export const NS_MC = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+// =============================================================================
+// XML Namespaces (Strict — ISO 29500 Part 1)
+// =============================================================================
+/** Strict WordprocessingML main namespace. */
+export const NS_W_STRICT = "http://purl.oclc.org/ooxml/wordprocessingml/main";
+/** Strict Relationships namespace. */
+export const NS_R_STRICT = "http://purl.oclc.org/ooxml/officeDocument/relationships";
+/** Strict DrawingML Word Processing Drawing namespace. */
+export const NS_WP_STRICT = "http://purl.oclc.org/ooxml/drawingml/wordprocessingDrawing";
+/** Strict DrawingML main namespace. */
+export const NS_A_STRICT = "http://purl.oclc.org/ooxml/drawingml/main";
+/** Strict DrawingML picture namespace. */
+export const NS_PIC_STRICT = "http://purl.oclc.org/ooxml/drawingml/picture";
+/** Strict Markup compatibility namespace. */
+export const NS_MC_STRICT = "http://purl.oclc.org/ooxml/markup-compatibility/2006";
+// =============================================================================
+// Strict → Transitional Namespace Mapping
+// =============================================================================
+/**
+ * Maps ISO 29500 Strict namespace URIs to their Transitional equivalents.
+ * Used during reading to normalize Strict documents into the internal model.
+ */
+export const STRICT_TO_TRANSITIONAL_NS = new Map([
+    ["http://purl.oclc.org/ooxml/wordprocessingml/main", NS_W],
+    ["http://purl.oclc.org/ooxml/officeDocument/relationships", NS_R],
+    ["http://purl.oclc.org/ooxml/drawingml/wordprocessingDrawing", NS_WP],
+    ["http://purl.oclc.org/ooxml/drawingml/main", NS_A],
+    ["http://purl.oclc.org/ooxml/drawingml/picture", NS_PIC],
+    ["http://purl.oclc.org/ooxml/markup-compatibility/2006", NS_MC],
+    [
+        "http://purl.oclc.org/ooxml/officeDocument/math",
+        "http://schemas.openxmlformats.org/officeDocument/2006/math"
+    ],
+    [
+        "http://purl.oclc.org/ooxml/officeDocument/extended-properties",
+        "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties"
+    ],
+    [
+        "http://purl.oclc.org/ooxml/officeDocument/custom-properties",
+        "http://schemas.openxmlformats.org/officeDocument/2006/custom-properties"
+    ],
+    [
+        "http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes",
+        "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes"
+    ],
+    [
+        "http://purl.oclc.org/ooxml/drawingml/chart",
+        "http://schemas.openxmlformats.org/drawingml/2006/chart"
+    ],
+    [
+        "http://purl.oclc.org/ooxml/drawingml/spreadsheetDrawing",
+        "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing"
+    ]
+]);
 /** VML namespace (v:). */
 export const NS_V = "urn:schemas-microsoft-com:vml";
 /** Office VML extensions (o:). */
@@ -67,6 +121,12 @@ export const NS_CONTENT_TYPES = "http://schemas.openxmlformats.org/package/2006/
 export const NS_PKG_RELS = "http://schemas.openxmlformats.org/package/2006/relationships";
 /** DrawingML picture URI for graphicData. */
 export const URI_PIC = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+/** DrawingML chart namespace (c:). */
+export const NS_C_CHART = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+/** Chart Extensions namespace (cx:) — Office 2016+ chartEx. */
+export const NS_CX_CHART = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+/** Flat OPC packaging namespace. */
+export const NS_PKG = "http://schemas.microsoft.com/office/2006/xmlPackage";
 // =============================================================================
 // Namespace Attributes (for document.xml root)
 // =============================================================================
@@ -94,6 +154,44 @@ export const DOCUMENT_NAMESPACES = {
 // =============================================================================
 const REL_BASE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
 const PKG_BASE = "http://schemas.openxmlformats.org/package/2006/relationships";
+// Strict relationship base URIs (ISO 29500)
+const REL_BASE_STRICT = "http://purl.oclc.org/ooxml/officeDocument/relationships";
+const PKG_BASE_STRICT = "http://purl.oclc.org/ooxml/package/relationships";
+/**
+ * Maps ISO 29500 Strict relationship type URIs to their Transitional equivalents.
+ * Used during reading to normalize Strict documents.
+ */
+export const STRICT_TO_TRANSITIONAL_REL = new Map([
+    [`${REL_BASE_STRICT}/officeDocument`, `${REL_BASE}/officeDocument`],
+    [`${PKG_BASE_STRICT}/metadata/core-properties`, `${PKG_BASE}/metadata/core-properties`],
+    [`${REL_BASE_STRICT}/extended-properties`, `${REL_BASE}/extended-properties`],
+    [`${REL_BASE_STRICT}/custom-properties`, `${REL_BASE}/custom-properties`],
+    [`${REL_BASE_STRICT}/styles`, `${REL_BASE}/styles`],
+    [`${REL_BASE_STRICT}/settings`, `${REL_BASE}/settings`],
+    [`${REL_BASE_STRICT}/fontTable`, `${REL_BASE}/fontTable`],
+    [`${REL_BASE_STRICT}/numbering`, `${REL_BASE}/numbering`],
+    [`${REL_BASE_STRICT}/footnotes`, `${REL_BASE}/footnotes`],
+    [`${REL_BASE_STRICT}/endnotes`, `${REL_BASE}/endnotes`],
+    [`${REL_BASE_STRICT}/header`, `${REL_BASE}/header`],
+    [`${REL_BASE_STRICT}/footer`, `${REL_BASE}/footer`],
+    [`${REL_BASE_STRICT}/image`, `${REL_BASE}/image`],
+    [`${REL_BASE_STRICT}/hyperlink`, `${REL_BASE}/hyperlink`],
+    [`${REL_BASE_STRICT}/theme`, `${REL_BASE}/theme`],
+    [`${REL_BASE_STRICT}/comments`, `${REL_BASE}/comments`],
+    [`${REL_BASE_STRICT}/commentsExtended`, `${REL_BASE}/commentsExtended`],
+    [`${REL_BASE_STRICT}/webSettings`, `${REL_BASE}/webSettings`],
+    [`${REL_BASE_STRICT}/glossaryDocument`, `${REL_BASE}/glossaryDocument`],
+    [`${REL_BASE_STRICT}/font`, `${REL_BASE}/font`],
+    [`${REL_BASE_STRICT}/chart`, `${REL_BASE}/chart`],
+    [`${REL_BASE_STRICT}/diagramData`, `${REL_BASE}/diagramData`],
+    [`${REL_BASE_STRICT}/customXml`, `${REL_BASE}/customXml`],
+    [`${REL_BASE_STRICT}/customXmlProps`, `${REL_BASE}/customXmlProps`],
+    [`${REL_BASE_STRICT}/vbaProject`, `${REL_BASE}/vbaProject`],
+    [`${REL_BASE_STRICT}/people`, `${REL_BASE}/people`],
+    [`${REL_BASE_STRICT}/package`, `${REL_BASE}/package`],
+    [`${REL_BASE_STRICT}/digital-signature/signature`, `${REL_BASE}/digital-signature/signature`],
+    [`${PKG_BASE_STRICT}/digital-signature/origin`, `${PKG_BASE}/digital-signature/origin`]
+]);
 /** OOXML relationship type URIs. */
 export const RelType = {
     OfficeDocument: `${REL_BASE}/officeDocument`,
@@ -117,11 +215,13 @@ export const RelType = {
     Glossary: `${REL_BASE}/glossaryDocument`,
     Font: `${REL_BASE}/font`,
     Chart: `${REL_BASE}/chart`,
+    ChartEx: "http://schemas.microsoft.com/office/2014/relationships/chartEx",
     Diagram: `${REL_BASE}/diagramData`,
     CustomXml: `${REL_BASE}/customXml`,
     CustomXmlProps: `${REL_BASE}/customXmlProps`,
     VbaProject: `${REL_BASE}/vbaProject`,
     People: `${REL_BASE}/people`,
+    Package: `${REL_BASE}/package`,
     DigitalSignature: `${REL_BASE}/digital-signature/signature`
 };
 // =============================================================================
@@ -132,6 +232,12 @@ export const ContentType = {
     Relationships: "application/vnd.openxmlformats-package.relationships+xml",
     Xml: "application/xml",
     Document: "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml",
+    /** Macro-enabled document (.docm) main part. */
+    DocumentMacroEnabled: "application/vnd.ms-word.document.macroEnabled.main+xml",
+    /** Template (.dotx) main part. */
+    Template: "application/vnd.openxmlformats-officedocument.wordprocessingml.template.main+xml",
+    /** Macro-enabled template (.dotm) main part. */
+    TemplateMacroEnabled: "application/vnd.ms-word.template.macroEnabled.main+xml",
     Styles: "application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml",
     Settings: "application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml",
     FontTable: "application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml",
@@ -159,6 +265,8 @@ export const ContentType = {
     Wmf: "image/x-wmf",
     ObfuscatedFont: "application/vnd.openxmlformats-officedocument.obfuscatedFont",
     Chart: "application/vnd.openxmlformats-officedocument.drawingml.chart+xml",
+    ChartEx: "application/vnd.ms-office.chartEx+xml",
+    Xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
     CustomXml: "application/xml",
     VbaProject: "application/vnd.ms-office.vbaProject"
 };

package/dist/browser/modules/word/convert/conversion-ir.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Conversion Intermediate Representation (IR)
+ *
+ * Format-agnostic semantic document model used by converters.
+ * Sits between DocxDocument (OOXML-specific) and output formats (HTML, Markdown, etc.).
+ *
+ * Purpose:
+ * - Normalize style resolution into direct formatting
+ * - Resolve numbering into concrete list markers
+ * - Flatten SDTs and tracked changes into final visible content
+ * - Provide a common "loss report" mechanism
+ * - Enable consistent behavior across all converters
+ */
+/** Severity of a conversion warning. */
+export type ConversionSeverity = "info" | "warning" | "error";
+/** A warning generated during conversion (feature loss, unsupported element, etc.). */
+export interface ConversionWarning {
+    readonly severity: ConversionSeverity;
+    readonly code: string;
+    readonly message: string;
+    /** Path in the source document (e.g. "body[3].table.row[1].cell[0]"). */
+    readonly path?: string;
+}
+/** A registered media asset for the conversion. */
+export interface ConversionAsset {
+    readonly id: string;
+    readonly mimeType: string;
+    readonly data: Uint8Array;
+    readonly altText?: string;
+    readonly width?: number;
+    readonly height?: number;
+}
+/** Resolved inline formatting (no style inheritance — everything is explicit). */
+export interface ResolvedFormatting {
+    readonly bold?: boolean;
+    readonly italic?: boolean;
+    readonly underline?: boolean;
+    readonly strikethrough?: boolean;
+    readonly superscript?: boolean;
+    readonly subscript?: boolean;
+    readonly fontFamily?: string;
+    readonly fontSize?: number;
+    readonly color?: string;
+    readonly backgroundColor?: string;
+    readonly code?: boolean;
+}
+/** A semantic inline element. */
+export type SemanticInline = {
+    readonly type: "text";
+    readonly text: string;
+    readonly format?: ResolvedFormatting;
+} | {
+    readonly type: "lineBreak";
+} | {
+    readonly type: "image";
+    readonly assetId: string;
+    readonly alt?: string;
+    readonly width?: number;
+    readonly height?: number;
+} | {
+    readonly type: "link";
+    readonly href: string;
+    readonly children: readonly SemanticInline[];
+} | {
+    readonly type: "footnoteRef";
+    readonly id: number;
+} | {
+    readonly type: "endnoteRef";
+    readonly id: number;
+} | {
+    readonly type: "math";
+    readonly latex?: string;
+    readonly text: string;
+} | {
+    readonly type: "code";
+    readonly text: string;
+};
+/** A semantic block element. */
+export type SemanticBlock = {
+    readonly type: "paragraph";
+    readonly children: readonly SemanticInline[];
+    readonly style?: SemanticParagraphStyle;
+} | {
+    readonly type: "heading";
+    readonly level: 1 | 2 | 3 | 4 | 5 | 6;
+    readonly children: readonly SemanticInline[];
+} | {
+    readonly type: "list";
+    readonly ordered: boolean;
+    readonly items: readonly SemanticListItem[];
+} | {
+    readonly type: "table";
+    readonly rows: readonly SemanticTableRow[];
+    readonly caption?: string;
+} | {
+    readonly type: "codeBlock";
+    readonly language?: string;
+    readonly text: string;
+} | {
+    readonly type: "blockquote";
+    readonly children: readonly SemanticBlock[];
+} | {
+    readonly type: "horizontalRule";
+} | {
+    readonly type: "image";
+    readonly assetId: string;
+    readonly alt?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly caption?: string;
+} | {
+    /**
+     * Block-level mathematical expression. `text` is a plain-text
+     * fallback (always present); `mathML` is the full MathML
+     * representation when the converter could derive one.
+     */
+    readonly type: "math";
+    readonly text: string;
+    readonly mathML?: string;
+} | {
+    /**
+     * A chart reference. The chart binary is preserved in `assets` only
+     * when the source provided a rendered SVG; otherwise consumers
+     * should fall back to the `title` / `altText` for a textual
+     * placeholder.
+     */
+    readonly type: "chart";
+    readonly chartId: string;
+    readonly title?: string;
+    readonly altText?: string;
+    /** Asset id of an SVG rendering, when available. */
+    readonly svgAssetId?: string;
+} | {
+    /** Inline check-box state (carries `<w:checkBox>` semantics). */
+    readonly type: "checkBox";
+    readonly checked: boolean;
+    readonly label?: string;
+} | {
+    /**
+     * Embedded foreign content (`<w:altChunk>`): HTML, RTF, plain text,
+     * etc. The renderer can either inline the data directly (when it
+     * knows how to handle `contentType`) or fall back to a placeholder.
+     */
+    readonly type: "embed";
+    readonly contentType: string;
+    readonly data?: Uint8Array;
+    readonly fileName?: string;
+} | {
+    /**
+     * Opaque OOXML drawing markup that cannot be safely flattened into
+     * the semantic model. Carried verbatim so consumers that want full
+     * fidelity (e.g. an OOXML→OOXML pipeline) can preserve the source
+     * markup; markdown / html renderers may emit a placeholder instead.
+     */
+    readonly type: "raw";
+    readonly format: "ooxml-drawing";
+    readonly xml: string;
+};
+/** Paragraph style properties (resolved, not inherited). */
+export interface SemanticParagraphStyle {
+    readonly alignment?: "left" | "center" | "right" | "justify";
+    readonly indentLeft?: number;
+    readonly indentRight?: number;
+    readonly spaceBefore?: number;
+    readonly spaceAfter?: number;
+}
+/** A list item (possibly nested). */
+export interface SemanticListItem {
+    readonly children: readonly SemanticInline[];
+    readonly subList?: SemanticBlock;
+}
+/** A table row. */
+export interface SemanticTableRow {
+    readonly cells: readonly SemanticTableCell[];
+    readonly isHeader?: boolean;
+}
+/** A table cell. */
+export interface SemanticTableCell {
+    readonly children: readonly SemanticBlock[];
+    readonly colSpan?: number;
+    readonly rowSpan?: number;
+    readonly alignment?: "left" | "center" | "right";
+}
+/** A footnote/endnote definition. */
+export interface SemanticNote {
+    readonly id: number;
+    readonly children: readonly SemanticBlock[];
+}
+/** The complete semantic document. */
+export interface SemanticDocument {
+    readonly blocks: readonly SemanticBlock[];
+    readonly assets: readonly ConversionAsset[];
+    readonly footnotes: readonly SemanticNote[];
+    readonly endnotes: readonly SemanticNote[];
+    readonly metadata?: {
+        readonly title?: string;
+        readonly author?: string;
+        readonly subject?: string;
+        readonly language?: string;
+    };
+}
+/** Conversion context passed through the conversion pipeline. */
+export interface ConversionContext {
+    readonly warnings: ConversionWarning[];
+    readonly assets: ConversionAsset[];
+    addWarning(severity: ConversionSeverity, code: string, message: string, path?: string): void;
+    registerAsset(mimeType: string, data: Uint8Array, altText?: string): string;
+}
+/** Create a new conversion context. */
+export declare function createConversionContext(): ConversionContext;

package/dist/browser/modules/word/convert/conversion-ir.js

@@ -0,0 +1,31 @@
+/**
+ * Conversion Intermediate Representation (IR)
+ *
+ * Format-agnostic semantic document model used by converters.
+ * Sits between DocxDocument (OOXML-specific) and output formats (HTML, Markdown, etc.).
+ *
+ * Purpose:
+ * - Normalize style resolution into direct formatting
+ * - Resolve numbering into concrete list markers
+ * - Flatten SDTs and tracked changes into final visible content
+ * - Provide a common "loss report" mechanism
+ * - Enable consistent behavior across all converters
+ */
+/** Create a new conversion context. */
+export function createConversionContext() {
+    let nextAssetId = 1;
+    const warnings = [];
+    const assets = [];
+    return {
+        warnings,
+        assets,
+        addWarning(severity, code, message, path) {
+            warnings.push({ severity, code, message, path });
+        },
+        registerAsset(mimeType, data, altText) {
+            const id = `asset-${nextAssetId++}`;
+            assets.push({ id, mimeType, data, altText });
+            return id;
+        }
+    };
+}

package/dist/browser/modules/word/convert/docx-to-semantic.d.ts

@@ -0,0 +1,39 @@
+/**
+ * DOCX → Semantic Document Converter
+ *
+ * Transforms a DocxDocument into a format-agnostic SemanticDocument.
+ * This is the bridge between OOXML-specific types and the universal IR
+ * that HTML/Markdown/other renderers can consume.
+ *
+ * Handles:
+ * - Heading detection (via style name or outlineLevel)
+ * - Inline formatting resolution
+ * - Hyperlink extraction
+ * - Image registration into ConversionContext
+ * - Table structure with merge (colSpan/rowSpan)
+ * - List/numbering detection (basic)
+ * - Footnote/endnote reference and content
+ * - Math content (text fallback)
+ */
+import type { DocxDocument } from "../types.js";
+import type { ConversionContext, SemanticDocument } from "./conversion-ir.js";
+/** Options for the semantic conversion. */
+export interface DocxToSemanticOptions {
+    /** Include footnotes in the output. Default: true. */
+    readonly includeFootnotes?: boolean;
+    /** Include endnotes in the output. Default: true. */
+    readonly includeEndnotes?: boolean;
+    /** Extract images and register as assets. Default: true. */
+    readonly extractImages?: boolean;
+}
+/**
+ * Convert a DocxDocument to a SemanticDocument (format-agnostic IR).
+ *
+ * @param doc - The parsed DOCX document.
+ * @param options - Conversion options.
+ * @returns The semantic document with warnings and assets.
+ */
+export declare function docxToSemantic(doc: DocxDocument, options?: DocxToSemanticOptions): {
+    document: SemanticDocument;
+    context: ConversionContext;
+};