@cj-tech-master/excelts 9.5.4 → 9.5.5

package/dist/types/modules/word/builder/run-builders.d.ts

@@ -0,0 +1,374 @@
+/**
+ * Run-level builder functions for DOCX documents.
+ *
+ * These are pure run/field/math/symbol/image/shape/chart/SDT/checkbox builders
+ * that do not depend on paragraph or table builders.
+ */
+import type { Run, RunProperties, MathBlock, MathContent, CheckBox, FloatingImage, DrawingShape, Chart, ChartSeries, ChartAxis, ChartLegendPosition, ChartContent, StructuredDocumentTag, SdtProperties, Paragraph, Table, Emu, HexColor, PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader, RubyProperties } from "../types.js";
+/** Create a text run. */
+export declare function text(content: string, properties?: RunProperties): Run;
+/** Create a bold text run. */
+export declare function bold(content: string, properties?: Omit<RunProperties, "bold">): Run;
+/** Create an italic text run. */
+export declare function italic(content: string, properties?: Omit<RunProperties, "italic">): Run;
+/** Create an underlined text run. */
+export declare function underline(content: string, style?: "single" | "double" | "thick" | "dotted" | "dash" | "wave", properties?: Omit<RunProperties, "underline">): Run;
+/** Create a strikethrough text run. */
+export declare function strikethrough(content: string, properties?: Omit<RunProperties, "strike">): Run;
+/** Create a run with a page break. */
+export declare function pageBreak(): Run;
+/** Create a run with a line break. */
+export declare function lineBreak(): Run;
+/** Create a run with a column break. */
+export declare function columnBreak(): Run;
+/** Create a tab run. */
+export declare function tab(): Run;
+/** Create a positional tab (w:ptab). */
+export declare function positionalTab(options: {
+    alignment: PositionalTabAlignment;
+    relativeTo: PositionalTabRelativeTo;
+    leader?: PositionalTabLeader;
+}): Run;
+/**
+ * Create a ruby (phonetic guide) run — e.g. Japanese furigana or Chinese pinyin.
+ *
+ * @param baseText - The main text being annotated.
+ * @param rubyText - The phonetic text shown above the base.
+ * @param properties - Optional ruby properties (alignment, font size, language).
+ */
+export declare function ruby(baseText: string | Run | readonly Run[], rubyText: string | Run | readonly Run[], properties?: RubyProperties): Run;
+/** Create a carriage return run. */
+export declare function carriageReturn(): Run;
+/** Create a no-break hyphen run. */
+export declare function noBreakHyphen(): Run;
+/** Create a soft hyphen run. */
+export declare function softHyphen(): Run;
+/** Create a run with a field code. */
+export declare function field(instruction: string, cachedValue?: string): Run;
+/** Create a PAGE field (current page number). */
+export declare function pageNumberField(cachedValue?: string): Run;
+/** Create a NUMPAGES field (total page count). */
+export declare function totalPagesField(cachedValue?: string): Run;
+/** Create a SECTIONPAGES field (pages in section). */
+export declare function sectionPagesField(cachedValue?: string): Run;
+/** Create a SECTION field (current section number). */
+export declare function sectionField(cachedValue?: string): Run;
+/** Create a DATE field. */
+export declare function dateField(format?: string, cachedValue?: string): Run;
+/** Create a SEQ (sequence) field for numbering figures, tables, etc. */
+export declare function sequenceField(identifier: string, options?: {
+    cachedValue?: string;
+    hide?: boolean;
+}): Run;
+/** Create a TIME field (current time). */
+export declare function timeField(format?: string, cachedValue?: string): Run;
+/** Create an AUTHOR field. */
+export declare function authorField(cachedValue?: string): Run;
+/** Create a TITLE field. */
+export declare function titleField(cachedValue?: string): Run;
+/** Create a SUBJECT field. */
+export declare function subjectField(cachedValue?: string): Run;
+/** Create a KEYWORDS field. */
+export declare function keywordsField(cachedValue?: string): Run;
+/** Create a FILENAME field. */
+export declare function fileNameField(options?: {
+    includePath?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create a FILESIZE field. */
+export declare function fileSizeField(cachedValue?: string): Run;
+/**
+ * Create a STYLEREF field (references text from nearest paragraph with given style).
+ *
+ * Commonly used in headers to show current chapter/section heading.
+ */
+export declare function styleRefField(styleName: string, options?: {
+    /** Search from bottom of page (default: top). */
+    fromBottom?: boolean;
+    /** Insert paragraph number instead of text. */
+    insertParagraphNumber?: boolean;
+    /** Insert position (above/below) reference. */
+    insertPosition?: boolean;
+    /** Suppress non-delimiter/non-numerical text. */
+    suppressNonNumeric?: boolean;
+    cachedValue?: string;
+}): Run;
+/**
+ * Create a REF field (references a bookmark).
+ */
+export declare function refField(bookmarkName: string, options?: {
+    /** Insert bookmark number. */
+    insertNumber?: boolean;
+    /** Hyperlink to bookmark. */
+    hyperlink?: boolean;
+    /** Paragraph number (no context). */
+    paragraphNumber?: boolean;
+    /** Relative paragraph number. */
+    relativeParagraphNumber?: boolean;
+    /** Full context paragraph number. */
+    fullContext?: boolean;
+    /** Suppress non-delimiter. */
+    suppressNonDelimiter?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create a PAGEREF field (references page of bookmark). */
+export declare function pageRefField(bookmarkName: string, options?: {
+    hyperlink?: boolean;
+    relativePosition?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create a NOTEREF field (references a footnote/endnote). */
+export declare function noteRefField(bookmarkName: string, options?: {
+    hyperlink?: boolean;
+    insertNumberFormat?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create a HYPERLINK field (alternative to w:hyperlink element). */
+export declare function hyperlinkField(target: string, options?: {
+    /** Anchor within target (bookmark). */
+    anchor?: string;
+    /** Open in new window. */
+    newWindow?: boolean;
+    /** Display text (if omitted, uses target). */
+    displayText?: string;
+    /** Screen tip tooltip. */
+    tooltip?: string;
+    cachedValue?: string;
+}): Run;
+/** Create a QUOTE field (literal text). */
+export declare function quoteField(text: string, cachedValue?: string): Run;
+/**
+ * Create a TOC field for table of contents.
+ *
+ * @param options - TOC options.
+ */
+export declare function tocField(options?: {
+    /** Heading levels to include (e.g. "1-3"). */
+    headingLevels?: string;
+    /** Include paragraphs with these styles. */
+    styles?: readonly string[];
+    /** Include table entries (TC fields) with these levels. */
+    tcLevels?: string;
+    /** Hyperlinks for entries. */
+    hyperlink?: boolean;
+    /** Right-align page numbers. */
+    rightAlignedPageNumbers?: boolean;
+    /** Use tab leader (default "." dots). */
+    tabLeader?: "." | "-" | "_" | " ";
+    /** Suppress page numbers. */
+    noPageNumbers?: boolean;
+    /** Identifier for table of captions. */
+    captionIdentifier?: string;
+    cachedValue?: string;
+}): Run;
+/** Create a TC (table of contents entry) field. */
+export declare function tcField(text: string, options?: {
+    level?: number;
+    suppressPageNumber?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create an XE (index entry) field. */
+export declare function indexEntryField(text: string, options?: {
+    bold?: boolean;
+    italic?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create an INDEX field (renders index from XE entries). */
+export declare function indexField(options?: {
+    bookmark?: string;
+    columns?: number;
+    entryType?: string;
+    cachedValue?: string;
+}): Run;
+/** Create an IF field (conditional content). */
+export declare function ifField(condition: string, trueText: string, falseText: string, cachedValue?: string): Run;
+/** Create an INCLUDETEXT field (includes external file content). */
+export declare function includeTextField(filePath: string, options?: {
+    bookmark?: string;
+    cachedValue?: string;
+}): Run;
+/** Create an INCLUDEPICTURE field. */
+export declare function includePictureField(filePath: string, cachedValue?: string): Run;
+/** Create a FORMTEXT field (legacy text form field) with full properties. */
+export declare function formTextField(options?: {
+    name?: string;
+    default?: string;
+    maxLength?: number;
+    format?: string;
+    helpText?: string;
+    statusText?: string;
+    enabled?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create a FORMCHECKBOX field (legacy checkbox form field) with full properties. */
+export declare function formCheckboxField(options?: {
+    name?: string;
+    checked?: boolean;
+    default?: boolean;
+    size?: number;
+    cachedValue?: string;
+}): Run;
+/** Create a FORMDROPDOWN field (legacy dropdown form field) with full properties. */
+export declare function formDropdownField(options?: {
+    name?: string;
+    entries?: readonly string[];
+    default?: number;
+    helpText?: string;
+    statusText?: string;
+    enabled?: boolean;
+    cachedValue?: string;
+}): Run;
+/** Create a math block. */
+export declare function mathBlock(content: MathContent[]): MathBlock;
+/** Create a math text run. */
+export declare function mathRun(mathText: string, properties?: {
+    italic?: boolean;
+    bold?: boolean;
+    font?: string;
+}): MathContent;
+/** Create a math fraction. */
+export declare function mathFraction(numerator: MathContent[], denominator: MathContent[], fractionType?: "bar" | "skw" | "lin" | "noBar"): MathContent;
+/** Create a math square root. */
+export declare function mathSqrt(content: MathContent[]): MathContent;
+/** Create a math nth root. */
+export declare function mathRoot(degree: MathContent[], content: MathContent[]): MathContent;
+/** Create a math summation. */
+export declare function mathSum(content: MathContent[], sub?: MathContent[], sup?: MathContent[]): MathContent;
+/** Create a math integral. */
+export declare function mathIntegral(content: MathContent[], sub?: MathContent[], sup?: MathContent[]): MathContent;
+/** Create a math product. */
+export declare function mathProduct(content: MathContent[], sub?: MathContent[], sup?: MathContent[]): MathContent;
+/** Create a math superscript. */
+export declare function mathSuperScript(base: MathContent[], superScript: MathContent[]): MathContent;
+/** Create a math subscript. */
+export declare function mathSubScript(base: MathContent[], subScript: MathContent[]): MathContent;
+/** Create a math sub-superscript. */
+export declare function mathSubSuperScript(base: MathContent[], subScript: MathContent[], superScript: MathContent[]): MathContent;
+/** Create a math pre-sub-superscript (subscript/superscript before the base). */
+export declare function mathPreSubSuperScript(base: MathContent[], preSubScript: MathContent[], preSuperScript: MathContent[]): MathContent;
+/** Create a math phantom (invisible expression that takes up space). */
+export declare function mathPhantom(content: MathContent[], options?: {
+    show?: boolean;
+    zeroWidth?: boolean;
+    zeroAscent?: boolean;
+    zeroDescent?: boolean;
+    transparent?: boolean;
+}): MathContent;
+/** Create a math group character (e.g. a horizontal brace over an expression). */
+export declare function mathGroupChar(base: MathContent[], options?: {
+    char?: string;
+    position?: "top" | "bottom";
+    verticalAlign?: "top" | "center" | "bottom";
+}): MathContent;
+/** Create a math border box (draw borders around / strike through an expression). */
+export declare function mathBorderBox(content: MathContent[], options?: {
+    hideTop?: boolean;
+    hideBottom?: boolean;
+    hideLeft?: boolean;
+    hideRight?: boolean;
+    strikeBlTr?: boolean;
+    strikeTlBr?: boolean;
+    strikeH?: boolean;
+    strikeV?: boolean;
+}): MathContent;
+/** Create a math delimiter (parentheses, brackets, etc.). */
+export declare function mathDelimiter(content: MathContent[][], options?: {
+    beginChar?: string;
+    endChar?: string;
+    separatorChar?: string;
+}): MathContent;
+/** Create a math n-ary operator (sum, integral, product, etc.). */
+export declare function mathNary(char: string, content: MathContent[], sub?: MathContent[], sup?: MathContent[]): MathContent;
+/** Create a math function (sin, cos, lim, etc.). */
+export declare function mathFunction(name: MathContent[], content: MathContent[]): MathContent;
+/** Create a math limit (upper or lower). */
+export declare function mathLimit(base: MathContent[], limit: MathContent[], limitType?: "upper" | "lower"): MathContent;
+/** Create a math matrix. */
+export declare function mathMatrix(rows: MathContent[][][]): MathContent;
+/** Create a math accent (hat, tilde, etc.). */
+export declare function mathAccent(content: MathContent[], char?: string): MathContent;
+/** Create a math bar (overbar/underbar). */
+export declare function mathBar(content: MathContent[], position?: "top" | "bottom"): MathContent;
+/** Create a math box. */
+export declare function mathBox(content: MathContent[]): MathContent;
+/** Create a math equation array. */
+export declare function mathEquationArray(rows: MathContent[][]): MathContent;
+/** Create a symbol run. */
+export declare function symbol(font: string, char: string, properties?: RunProperties): Run;
+/** Create a floating image (body-level). */
+export declare function floatingImage(options: {
+    rId: string;
+    width: Emu;
+    height: Emu;
+    horizontalPosition?: FloatingImage["horizontalPosition"];
+    verticalPosition?: FloatingImage["verticalPosition"];
+    wrap?: FloatingImage["wrap"];
+    altText?: string;
+    name?: string;
+    behindDoc?: boolean;
+    lockAnchor?: boolean;
+    layoutInCell?: boolean;
+    allowOverlap?: boolean;
+    simplePos?: {
+        x: Emu;
+        y: Emu;
+    };
+    distT?: Emu;
+    distB?: Emu;
+    distL?: Emu;
+    distR?: Emu;
+    rotation?: number;
+    flipHorizontal?: boolean;
+    flipVertical?: boolean;
+    srcRect?: FloatingImage["srcRect"];
+}): FloatingImage;
+/** Create a DrawingML shape. */
+export declare function drawingShape(options: {
+    shapeType: DrawingShape["shapeType"];
+    width: Emu;
+    height: Emu;
+    fillColor?: HexColor;
+    noFill?: boolean;
+    outlineColor?: HexColor;
+    outlineWidth?: Emu;
+    noOutline?: boolean;
+    textContent?: readonly Paragraph[];
+    altText?: string;
+    name?: string;
+    horizontalPosition?: DrawingShape["horizontalPosition"];
+    verticalPosition?: DrawingShape["verticalPosition"];
+    wrap?: DrawingShape["wrap"];
+    behindDoc?: boolean;
+    rotation?: number;
+}): DrawingShape;
+/** Create a chart content block. */
+export declare function chart(options: {
+    type: Chart["type"];
+    series: readonly ChartSeries[];
+    title?: string;
+    legend?: ChartLegendPosition;
+    categoryAxis?: ChartAxis;
+    valueAxis?: ChartAxis;
+    plotAreaColor?: HexColor;
+    chartAreaColor?: HexColor;
+    view3d?: boolean;
+    style?: number;
+    width?: Emu;
+    height?: Emu;
+    altText?: string;
+    name?: string;
+}): ChartContent;
+/** Create a structured document tag (content control). */
+export declare function structuredDocumentTag(content: (Paragraph | Table)[], properties?: SdtProperties): StructuredDocumentTag;
+/** Create a checkbox. */
+export declare function checkBox(options?: {
+    checked?: boolean;
+    checkedState?: {
+        value: string;
+        font?: string;
+    };
+    uncheckedState?: {
+        value: string;
+        font?: string;
+    };
+}): CheckBox;

package/dist/types/modules/word/builder/table-builders.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Table builder functions for DOCX documents.
+ *
+ * Includes border, gridBorders, cell, row, table, simpleTable.
+ */
+import type { Border, Table, TableRow, TableCell, TableProperties, TableRowProperties, TableCellProperties, TableBorders, TableWidth, Paragraph, Twips } from "../types.js";
+/** Shorthand border. */
+export declare function border(style?: Border["style"], size?: number, color?: string): Border;
+/** Create standard grid borders for a table. */
+export declare function gridBorders(size?: number, color?: string): TableBorders;
+/** Create a table cell. */
+export declare function cell(content: string | (Paragraph | Table)[], properties?: TableCellProperties): TableCell;
+/** Create a table row. */
+export declare function row(cells: TableCell[], properties?: TableRowProperties): TableRow;
+/** Create a table. */
+export declare function table(rows: TableRow[], properties?: TableProperties, columnWidths?: Twips[]): Table;
+/** Create a simple table from a 2D string array. */
+export declare function simpleTable(data: string[][], options?: {
+    headerRow?: boolean;
+    borders?: boolean;
+    width?: TableWidth;
+    columnWidths?: Twips[];
+}): Table;

package/dist/types/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/types/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;