oasis-editor 0.0.1 → 0.0.2

package/dist/i18n/locales/pt-BR.d.ts

@@ -48,8 +48,10 @@ export declare const ptBR: {
     "toolbar.size": string;
     "toolbar.color": string;
     "toolbar.highlight": string;
+    "toolbar.textShading": string;
     "toolbar.colorAutomatic": string;
     "toolbar.noHighlight": string;
+    "toolbar.noTextShading": string;
     "toolbar.themeColors": string;
     "toolbar.standardColors": string;
     "toolbar.moreColors": string;
@@ -83,6 +85,41 @@ export declare const ptBR: {
     "lineSpacing.spacingAfterLabel": string;
     "lineSpacing.preview": string;
     "lineSpacing.previewText": string;
+    "paragraph.title": string;
+    "paragraph.generalSection": string;
+    "paragraph.alignLabel": string;
+    "paragraph.alignLeft": string;
+    "paragraph.alignCenter": string;
+    "paragraph.alignRight": string;
+    "paragraph.alignJustify": string;
+    "paragraph.indentSection": string;
+    "paragraph.indentLeftLabel": string;
+    "paragraph.indentRightLabel": string;
+    "paragraph.specialLabel": string;
+    "paragraph.specialNone": string;
+    "paragraph.specialFirstLine": string;
+    "paragraph.specialHanging": string;
+    "paragraph.specialByLabel": string;
+    "paragraph.spacingSection": string;
+    "paragraph.spacingBeforeLabel": string;
+    "paragraph.spacingAfterLabel": string;
+    "paragraph.lineSpacingLabel": string;
+    "paragraph.bordersSection": string;
+    "paragraph.borderStyleLabel": string;
+    "paragraph.borderWidthLabel": string;
+    "paragraph.borderColorLabel": string;
+    "paragraph.shadingLabel": string;
+    "paragraph.borderNone": string;
+    "paragraph.borderSolid": string;
+    "paragraph.borderDashed": string;
+    "paragraph.borderDotted": string;
+    "paragraph.borderSidesLabel": string;
+    "paragraph.borderSideTop": string;
+    "paragraph.borderSideRight": string;
+    "paragraph.borderSideBottom": string;
+    "paragraph.borderSideLeft": string;
+    "paragraph.preview": string;
+    "paragraph.previewText": string;
     "section.orient": string;
     "section.pageSetup": string;
     "section.toggleOrientation": string;
@@ -114,6 +151,59 @@ export declare const ptBR: {
     "table.cellWidth": string;
     "table.cellBgColorPrompt": string;
     "table.cellWidthPrompt": string;
+    "table.propertiesTitle": string;
+    "table.tabTable": string;
+    "table.tabRow": string;
+    "table.tabColumn": string;
+    "table.tabCell": string;
+    "table.tabAltText": string;
+    "table.sizeSection": string;
+    "table.preferredWidth": string;
+    "table.measureIn": string;
+    "table.points": string;
+    "table.percent": string;
+    "table.alignmentSection": string;
+    "table.indentFromLeft": string;
+    "table.textWrappingSection": string;
+    "table.wrapNone": string;
+    "table.wrapAround": string;
+    "table.positioning": string;
+    "table.positioningReadOnly": string;
+    "table.rowHeight": string;
+    "table.rowHeightRule": string;
+    "table.rowAuto": string;
+    "table.rowAtLeast": string;
+    "table.rowExactly": string;
+    "table.repeatHeader": string;
+    "table.allowBreakAcrossPages": string;
+    "table.hiddenRow": string;
+    "table.columnWidth": string;
+    "table.verticalAlignment": string;
+    "table.inherit": string;
+    "table.valignTop": string;
+    "table.valignMiddle": string;
+    "table.valignBottom": string;
+    "table.textDirection": string;
+    "table.options": string;
+    "table.noWrap": string;
+    "table.fitText": string;
+    "table.hideMark": string;
+    "table.cellMargins": string;
+    "table.altTitle": string;
+    "table.altDescription": string;
+    "layoutOptions.title": string;
+    "layoutOptions.inLineGroup": string;
+    "layoutOptions.wrapGroup": string;
+    "layoutOptions.inline": string;
+    "layoutOptions.square": string;
+    "layoutOptions.tight": string;
+    "layoutOptions.through": string;
+    "layoutOptions.topAndBottom": string;
+    "layoutOptions.behind": string;
+    "layoutOptions.front": string;
+    "layoutOptions.moveWithText": string;
+    "layoutOptions.fixPosition": string;
+    "layoutOptions.behindHint": string;
     "generic.close": string;
     "generic.cancel": string;
     "generic.save": string;
@@ -137,6 +227,7 @@ export declare const ptBR: {
     "dialog.font.color": string;
     "dialog.font.customColor": string;
     "dialog.font.highlight": string;
+    "dialog.font.shading": string;
     "dialog.font.familyFilter": string;
     "dialog.font.customSize": string;
     "dialog.font.sizeInvalid": string;
@@ -194,6 +285,9 @@ export declare const ptBR: {
     "contextmenu.paste": string;
     "contextmenu.link": string;
     "contextmenu.font": string;
+    "contextmenu.paragraph": string;
+    "contextmenu.tableProperties": string;
+    "contextmenu.bordersAndShading": string;
     "status.words": string;
     "status.characters": string;
     "status.page": string;
@@ -234,6 +328,7 @@ export declare const ptBR: {
     "menu.view": string;
     "menu.view.margins": string;
     "menu.view.paragraphMarks": string;
+    "menu.view.preciseFonts": string;
     "menu.view.outline": string;
     "menu.view.fullscreen": string;
     "menu.insert": string;
@@ -246,6 +341,19 @@ export declare const ptBR: {
     "menu.help": string;
     "menu.help.shortcuts": string;
     "menu.help.about": string;
+    "loading.title": string;
+    "welcome.title": string;
+    "welcome.body": string;
+    "welcome.note": string;
+    "welcome.enable": string;
+    "welcome.skip": string;
     "outline.toggle": string;
     "outline.empty": string;
+    "ruler.horizontal": string;
+    "ruler.firstLineIndent": string;
+    "ruler.hangingIndent": string;
+    "ruler.leftIndent": string;
+    "ruler.rightIndent": string;
+    "ruler.leftMargin": string;
+    "ruler.rightMargin": string;
 };

package/dist/import/DocumentFormatImporter.d.ts

@@ -0,0 +1,26 @@
+import { EditorDocument } from '../../core/model.js';
+
+/**
+ * Coarse, format-agnostic import stages. Each concrete importer maps its own
+ * internal phases onto these so the progress UI does not need to know about any
+ * specific file format.
+ */
+export type ImportStage = "opening" | "parsing" | "finishing";
+export type ImportProgressReporter = (stage: ImportStage, progress?: number) => void;
+/**
+ * A pluggable document format importer. Adding support for a new format means
+ * implementing this interface and registering it — no consumer of the import
+ * pipeline (controller, UI) needs to change (Open/Closed, Dependency Inversion).
+ */
+export interface DocumentFormatImporter {
+    /** Stable identifier, e.g. "docx" or "html". */
+    readonly id: string;
+    /** File extensions handled, lowercase and dot-prefixed, e.g. [".html", ".htm"]. */
+    readonly accept: readonly string[];
+    /** Whether this importer can handle the given file (by extension). */
+    matches(file: File): boolean;
+    /** Parse the raw bytes into an editor document. */
+    import(buffer: ArrayBuffer, onProgress?: ImportProgressReporter): Promise<EditorDocument>;
+}
+/** Returns the lowercase dot-extension of a file name, e.g. ".html". */
+export declare function fileExtension(fileName: string): string;

package/dist/import/documentImporterRegistry.d.ts

@@ -0,0 +1,6 @@
+import { DocumentFormatImporter } from '../DocumentFormatImporter.js';
+
+/** Finds the importer that can handle the given file, if any. */
+export declare function resolveImporterForFile(file: File): DocumentFormatImporter | undefined;
+/** Comma-separated extension list for an `<input type="file" accept>`. */
+export declare function importFileAccept(): string;

package/dist/import/docx/bookmarks.d.ts

@@ -0,0 +1,8 @@
+import { EditorBookmarks, EditorSection } from '../../../../core/model.js';
+
+/**
+ * Walk all stories in the imported sections, collect bookmark boundaries, pair
+ * them by DOCX id and return the registry (or `undefined` when there are none).
+ * Mutates the paragraphs in place to remove the transient marker runs.
+ */
+export declare function extractBookmarksFromSections(sections: EditorSection[]): EditorBookmarks | undefined;

package/dist/import/docx/borders.d.ts

@@ -0,0 +1,37 @@
+import { Element as XmlElement } from '../../@xmldom/xmldom';
+import { EditorBorderStyle } from '../../../../core/model.js';
+
+/**
+ * Parses a single OOXML border element (`<w:top>`, `<w:left>`, ...) into the
+ * editor's `EditorBorderStyle`. Shared by table-cell borders (`w:tcBorders`) and
+ * paragraph borders (`w:pBdr`) so both stay in sync.
+ *
+ * `w:sz` is in eighths of a point; an explicit `nil`/`none` value yields a
+ * zero-width "none" border so callers can distinguish "no border" from "absent".
+ */
+export declare function parseDocxBorder(borderNode: XmlElement | null): EditorBorderStyle | undefined;
+export interface EditorBoxBorders {
+    borderTop?: EditorBorderStyle;
+    borderRight?: EditorBorderStyle;
+    borderBottom?: EditorBorderStyle;
+    borderLeft?: EditorBorderStyle;
+    borderStart?: EditorBorderStyle;
+    borderEnd?: EditorBorderStyle;
+    borderTopLeftToBottomRight?: EditorBorderStyle;
+    borderTopRightToBottomLeft?: EditorBorderStyle;
+}
+export interface EditorTableBorders extends EditorBoxBorders {
+    borderInsideH?: EditorBorderStyle;
+    borderInsideV?: EditorBorderStyle;
+}
+/**
+ * Parses the four edges of a border container (`w:tcBorders` for cells or
+ * `w:pBdr` for paragraphs) into the editor's four `border*` fields.
+ */
+export declare function parseDocxBoxBorders(container: XmlElement | null): EditorBoxBorders;
+/**
+ * Parses `w:tblBorders` (6 edges: top/right/bottom/left + insideH/insideV)
+ * into `EditorTableBorders`. Used to propagate table-level border defaults to
+ * cells that have no explicit `w:tcBorders` override for that edge.
+ */
+export declare function parseDocxTableBorders(container: XmlElement | null): EditorTableBorders;

package/dist/import/docx/docxImporter.d.ts

@@ -0,0 +1,3 @@
+import { DocumentFormatImporter } from '../../../DocumentFormatImporter.js';
+
+export declare const docxImporter: DocumentFormatImporter;

package/dist/import/docx/dropCap.d.ts

@@ -0,0 +1,13 @@
+import { Element as XmlElement } from '../../@xmldom/xmldom';
+import { EditorDropCap } from '../../../../core/model.js';
+import { ImportedRun } from '../../runs.js';
+
+/**
+ * Detect a Word drop cap frame (`w:pPr/w:framePr/@dropCap`). Word stores the
+ * large initial letter in its own frame paragraph that precedes the wrapping
+ * body paragraph; the import driver merges the returned descriptor onto that
+ * following paragraph so the per-paragraph layout owns the cap.
+ *
+ * Returns null for any paragraph that is not a drop cap frame.
+ */
+export declare function parseDropCapFrame(paragraphProperties: XmlElement | null, runs: ImportedRun[]): EditorDropCap | null;

package/dist/import/docx/endnotes.d.ts

@@ -0,0 +1,17 @@
+import { default as JSZip } from '../../jszip';
+import { EditorBlockNode, EditorEndnotes, EditorEndnote, EditorNamedStyle } from '../../../../core/model.js';
+import { AssetRegistry } from '../../assetRegistry.js';
+import { DocxImportTheme } from '../../theme.js';
+import { NumberingMaps } from '../../numbering.js';
+
+export interface ParsedEndnotes {
+    /** Map from DOCX `w:id` (string) to the parsed endnote. */
+    byDocxId: Map<string, EditorEndnote>;
+    /** Final shape ready to be assigned to `EditorDocument.endnotes`. */
+    endnotes: EditorEndnotes;
+    /** Imported "separator" part, if any. */
+    separator?: EditorBlockNode[];
+    /** Imported "continuationSeparator" part, if any. */
+    continuationSeparator?: EditorBlockNode[];
+}
+export declare function parseEndnotesXml(xmlContent: string | null, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme, styles?: Record<string, EditorNamedStyle>): Promise<ParsedEndnotes>;

package/dist/import/docx/footnotes.d.ts

@@ -1,7 +1,7 @@
 import { default as JSZip } from '../../jszip';
 import { EditorBlockNode, EditorFootnotes, EditorFootnote, EditorNamedStyle } from '../../../../core/model.js';
 import { AssetRegistry } from '../../assetRegistry.js';
-import { ThemeFontMap } from '../../themeFonts.js';
+import { DocxImportTheme } from '../../theme.js';
 import { NumberingMaps } from '../../numbering.js';
 
 export interface ParsedFootnotes {
@@ -14,4 +14,4 @@ export interface ParsedFootnotes {
     /** Imported "continuationSeparator" part, if any. */
     continuationSeparator?: EditorBlockNode[];
 }
-export declare function parseFootnotesXml(xmlContent: string | null, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, themeFonts: ThemeFontMap, styles?: Record<string, EditorNamedStyle>): Promise<ParsedFootnotes>;
+export declare function parseFootnotesXml(xmlContent: string | null, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme, styles?: Record<string, EditorNamedStyle>): Promise<ParsedFootnotes>;

package/dist/import/docx/headerFooter.d.ts

@@ -1,7 +1,7 @@
 import { default as JSZip } from '../../jszip';
 import { EditorBlockNode, EditorNamedStyle } from '../../../../core/model.js';
 import { AssetRegistry } from '../../assetRegistry.js';
-import { ThemeFontMap } from '../../themeFonts.js';
+import { DocxImportTheme } from '../../theme.js';
 import { NumberingMaps } from '../../numbering.js';
 
-export declare function parseHeaderFooterXml(xmlContent: string | null, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, themeFonts: ThemeFontMap, styles?: Record<string, EditorNamedStyle>): Promise<EditorBlockNode[]>;
+export declare function parseHeaderFooterXml(xmlContent: string | null, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme, styles?: Record<string, EditorNamedStyle>): Promise<EditorBlockNode[]>;

package/dist/import/docx/nestedBlocks.d.ts

@@ -0,0 +1,15 @@
+import { default as JSZip } from '../../jszip';
+import { Element as XmlElement } from '../../@xmldom/xmldom';
+import { EditorBlockNode } from '../../../../core/model.js';
+import { AssetRegistry } from '../../assetRegistry.js';
+import { DocxImportTheme } from '../../theme.js';
+import { NumberingMaps } from '../../numbering.js';
+
+/**
+ * Parse the block-level content of a `w:txbxContent` (text box body) into the
+ * editor block model. Handles `w:p` (paragraphs) and `w:tbl` (tables), mirroring
+ * the top-level body walker. Defined in its own module so `runs.ts` can request
+ * nested-block parsing via a callback without creating an import cycle
+ * (`runs.ts` -> `paragraphs.ts`/`tables.ts` -> `runs.ts`).
+ */
+export declare function parseTxbxContentBlocks(container: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme): Promise<EditorBlockNode[]>;

package/dist/import/docx/numbering.d.ts

@@ -4,6 +4,21 @@ import { EditorParagraphListStyle } from '../../../../core/model.js';
 export interface NumberingMaps {
     abstractKinds: Map<string, EditorParagraphListStyle["kind"]>;
     numKinds: Map<string, EditorParagraphListStyle["kind"]>;
+    /** Indent per level, keyed by "abstractNumId:ilvl". Values in points. */
+    abstractIndents: Map<string, {
+        left?: number;
+        hanging?: number;
+    }>;
+    /** Suffix (`w:suff`) per level, keyed by "abstractNumId:ilvl". */
+    abstractSuffixes: Map<string, EditorParagraphListStyle["suffix"]>;
+    /** numId → abstractNumId */
+    numToAbstractId: Map<string, string>;
 }
 export declare function parseNumbering(numberingXml: string | null): NumberingMaps;
-export declare function parseParagraphList(paragraphProperties: XmlElement | null, numberingMaps: NumberingMaps): EditorParagraphListStyle | undefined;
+export declare function parseParagraphList(paragraphProperties: XmlElement | null, numberingMaps: NumberingMaps): {
+    list: EditorParagraphListStyle;
+    indent?: {
+        left?: number;
+        hanging?: number;
+    };
+} | undefined;

package/dist/import/docx/{styles.d.ts → paragraphStyle.d.ts}

@@ -1,12 +1,8 @@
 import { Element as XmlElement } from '../../@xmldom/xmldom';
-import { EditorNamedStyle, EditorParagraphStyle, EditorTextStyle } from '../../../../core/model.js';
-import { ThemeFontMap } from '../../themeFonts.js';
+import { EditorParagraphStyle } from '../../../../core/model.js';
 
 export declare function normalizeImportedParagraphStyle(style: EditorParagraphStyle | undefined): EditorParagraphStyle | undefined;
 export declare function withDocxImplicitSingleLineHeight(style: EditorParagraphStyle | undefined): EditorParagraphStyle;
-export declare function normalizeImportedRunStyle(style: EditorTextStyle | undefined, paragraphStyleId: string | undefined): EditorTextStyle | undefined;
-export declare function parseRunStyle(runProperties: XmlElement | null, themeFonts: ThemeFontMap): EditorTextStyle | undefined;
-export declare function parseParagraphStyle(paragraphProperties: XmlElement | null): EditorParagraphStyle | undefined;
 export interface ParagraphAutospacingFlags {
     before: boolean;
     after: boolean;
@@ -19,6 +15,4 @@ export interface ParagraphAutospacingFlags {
  * reproduce that collapsing; see `collapseCellAutospacing` in tables.ts.
  */
 export declare function parseAutospacingFlags(paragraphProperties: XmlElement | null): ParagraphAutospacingFlags;
-export declare function mergeImportedParagraphStyles(base: EditorParagraphStyle | undefined, local: EditorParagraphStyle | undefined): EditorParagraphStyle | undefined;
-export declare function mergeImportedTextStyles(base: EditorTextStyle | undefined, local: EditorTextStyle | undefined): EditorTextStyle | undefined;
-export declare function parseImportedStyles(stylesXml: string | null, themeFonts: ThemeFontMap): Record<string, EditorNamedStyle> | undefined;
+export declare function parseParagraphStyle(paragraphProperties: XmlElement | null): EditorParagraphStyle | undefined;

package/dist/import/docx/paragraphs.d.ts

@@ -1,12 +1,13 @@
 import { default as JSZip } from '../../jszip';
 import { Element as XmlElement } from '../../@xmldom/xmldom';
-import { EditorParagraphNode, EditorParagraphStyle } from '../../../../core/model.js';
+import { EditorDropCap, EditorParagraphNode, EditorParagraphStyle } from '../../../../core/model.js';
 import { AssetRegistry } from '../../assetRegistry.js';
-import { ThemeFontMap } from '../../themeFonts.js';
+import { DocxImportTheme } from '../../theme.js';
 import { NumberingMaps } from '../../numbering.js';
 
-export declare function parseParagraphNodes(paragraphNode: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, themeFonts: ThemeFontMap, inheritedStyle?: EditorParagraphStyle): Promise<{
+export declare function parseParagraphNodes(paragraphNode: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme, inheritedStyle?: EditorParagraphStyle): Promise<{
     paragraphs: EditorParagraphNode[];
     pageBreakAfter: boolean;
+    dropCapFrame?: EditorDropCap;
 }>;
-export declare function parseParagraphNode(paragraphNode: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, themeFonts: ThemeFontMap, inheritedStyle?: EditorParagraphStyle): Promise<EditorParagraphNode>;
+export declare function parseParagraphNode(paragraphNode: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme, inheritedStyle?: EditorParagraphStyle): Promise<EditorParagraphNode>;

package/dist/import/docx/runStyle.d.ts

@@ -0,0 +1,6 @@
+import { Element as XmlElement } from '../../@xmldom/xmldom';
+import { EditorTextStyle } from '../../../../core/model.js';
+import { DocxImportTheme } from '../../theme.js';
+
+export declare function normalizeImportedRunStyle(style: EditorTextStyle | undefined, paragraphStyleId: string | undefined): EditorTextStyle | undefined;
+export declare function parseRunStyle(runProperties: XmlElement | null, theme: DocxImportTheme): EditorTextStyle | undefined;

package/dist/import/docx/runs/drawingImage.d.ts

@@ -0,0 +1,13 @@
+import { default as JSZip } from '../../../jszip';
+import { Element as XmlElement } from '../../../@xmldom/xmldom';
+import { EditorImageRunData } from '../../../../../../core/model.js';
+import { AssetRegistry } from '../../../../assetRegistry.js';
+
+export declare function parseDrawingImage(drawing: XmlElement, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry): Promise<{
+    image: EditorImageRunData;
+    text: string;
+} | {
+    image: undefined;
+    text: string;
+    textBox?: undefined;
+}>;

package/dist/import/docx/runs/fields.d.ts

@@ -0,0 +1,3 @@
+import { Element as XmlElement } from '../../../@xmldom/xmldom';
+
+export declare function getRunInstructionText(runElement: XmlElement): string;

package/dist/import/docx/runs/relationships.d.ts

@@ -0,0 +1,11 @@
+import { default as JSZip } from '../../../jszip';
+import { Element as XmlElement } from '../../../@xmldom/xmldom';
+import { AssetRegistry } from '../../../../assetRegistry.js';
+
+export declare function isAbsoluteUri(target: string): boolean;
+export declare function parseRelationshipId(element: XmlElement): string | undefined;
+export declare function parseBlipRels(blip: XmlElement): {
+    embed?: string;
+    link?: string;
+};
+export declare function loadEmbeddedImage(zip: JSZip, assets: AssetRegistry, target: string): Promise<string | undefined>;

package/dist/import/docx/runs/textBox.d.ts

@@ -0,0 +1,6 @@
+import { Element as XmlElement } from '../../../@xmldom/xmldom';
+import { EditorTextBoxData } from '../../../../../../core/model.js';
+import { ParseNestedBlocks } from '../../../types.js';
+
+export declare function parseTextBox(drawing: XmlElement, parseNestedBlocks: ParseNestedBlocks | undefined): Promise<EditorTextBoxData | undefined>;
+export declare function resolveAlternateContentDrawing(alternateContent: XmlElement): XmlElement | undefined;

package/dist/import/docx/runs/types.d.ts

@@ -0,0 +1,42 @@
+import { Element as XmlElement } from '../../../@xmldom/xmldom';
+import { EditorBlockNode, EditorTextStyle, EditorImageRunData, EditorTextBoxData } from '../../../../../../core/model.js';
+
+export type ParseNestedBlocks = (container: XmlElement) => Promise<EditorBlockNode[]>;
+/**
+ * A `w:bookmarkStart` / `w:bookmarkEnd` marker carried through the run stream as
+ * a zero-length transient run. The import driver extracts these into the
+ * document-level bookmark registry once paragraph ids and offsets are known.
+ */
+export interface ImportedBookmarkMarker {
+    kind: "start" | "end";
+    docxId: string;
+    name?: string;
+    colFirst?: number;
+    colLast?: number;
+}
+export interface ImportedRun {
+    text: string;
+    image?: EditorImageRunData;
+    textBox?: EditorTextBoxData;
+    styles?: EditorTextStyle;
+    field?: {
+        type: "PAGE" | "NUMPAGES";
+    };
+    /** Preserved `w:fldChar` control char (complex fields). Zero-length marker. */
+    fieldChar?: {
+        kind: "begin" | "separate" | "end";
+        fieldLock?: boolean;
+        dirty?: boolean;
+    };
+    /** Preserved `w:instrText`. Zero-length marker. */
+    fieldInstruction?: string;
+    footnoteReference?: {
+        docxId: string;
+        customMark?: string;
+    };
+    endnoteReference?: {
+        docxId: string;
+        customMark?: string;
+    };
+    bookmark?: ImportedBookmarkMarker;
+}

package/dist/import/docx/runs/units.d.ts

@@ -0,0 +1,11 @@
+export declare const EMU_PER_PX = 9525;
+export declare const EMU_PER_PT = 12700;
+export declare const OOXML_PERCENT_DENOMINATOR = 100000;
+export declare const OOXML_ROTATION_UNITS = 60000;
+export declare const VML_FRACTION_DENOMINATOR = 65536;
+export declare const PX_PER_INCH = 96;
+export declare const PX_PER_POINT: number;
+export declare function emuToPx(value: string | null | undefined): number | undefined;
+export declare function parseOptionalInt(value: string | null | undefined): number | undefined;
+export declare function parseCssLengthToPx(value: string | null | undefined): number | null;
+export declare function normalizeHexColor(value: string | null | undefined): string | undefined;

package/dist/import/docx/runs/vmlImage.d.ts

@@ -0,0 +1,6 @@
+import { default as JSZip } from '../../../jszip';
+import { Element as XmlElement } from '../../../@xmldom/xmldom';
+import { EditorImageRunData } from '../../../../../../core/model.js';
+import { AssetRegistry } from '../../../../assetRegistry.js';
+
+export declare function parseVmlImage(pictElement: XmlElement, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry): Promise<EditorImageRunData | undefined>;

package/dist/import/docx/runs.d.ts

@@ -1,41 +1,21 @@
 import { default as JSZip } from '../../jszip';
 import { Element as XmlElement } from '../../@xmldom/xmldom';
-import { EditorTextStyle } from '../../../../core/model.js';
+import { EditorImageRunData, EditorTextBoxData } from '../../../../core/model.js';
 import { AssetRegistry } from '../../assetRegistry.js';
-import { ThemeFontMap } from '../../themeFonts.js';
+import { DocxImportTheme } from '../../theme.js';
 import { NumberingMaps } from '../../numbering.js';
+import { ImportedBookmarkMarker, ImportedRun, ParseNestedBlocks } from '../../runs/types.js';
 
-export interface ImportedRun {
+export type { ImportedRun } from '../../runs/types.js';
+export type { ParseNestedBlocks } from '../../runs/types.js';
+export { getRunInstructionText } from '../../runs/fields.js';
+export declare function parseRunElement(runElement: XmlElement, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, parseNestedBlocks?: ParseNestedBlocks): Promise<{
     text: string;
-    image?: {
-        src: string;
-        width: number;
-        height: number;
-        alt?: string;
-    };
-    styles?: EditorTextStyle;
-    field?: {
-        type: "PAGE" | "NUMPAGES";
-    };
-    /**
-     * When present, the run is an inline footnote reference. The DOCX `w:id`
-     * is carried verbatim so a later pass can remap it to a real footnote id.
-     * `text` is the placeholder marker (numbering is resolved post-parse).
-     */
-    footnoteReference?: {
-        docxId: string;
-        customMark?: string;
-    };
-}
-export declare function parseRunElement(runElement: XmlElement, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry): Promise<{
-    text: string;
-    image?: {
-        src: string;
-        width: number;
-        height: number;
-        alt?: string;
-    };
+    image?: EditorImageRunData;
+    textBox?: EditorTextBoxData;
+    innerBookmarks?: Array<{
+        offset: number;
+        marker: ImportedBookmarkMarker;
+    }>;
 }>;
-export declare function getRunFieldCharType(runElement: XmlElement): string | null;
-export declare function getRunInstructionText(runElement: XmlElement): string;
-export declare function parseRunsContainer(container: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, themeFonts: ThemeFontMap, inheritedLink?: string | null): Promise<ImportedRun[]>;
+export declare function parseRunsContainer(container: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme, inheritedLink?: string | null, parseNestedBlocks?: ParseNestedBlocks): Promise<ImportedRun[]>;

package/dist/import/docx/sectionProperties.d.ts

@@ -7,7 +7,7 @@ export interface SectionProperties {
     headerRIds: Partial<Record<"default" | "first" | "even", string>>;
     footerRIds: Partial<Record<"default" | "first" | "even", string>>;
     docGridLinePitchPx?: number;
-    docGridMode?: "explicit" | "implicit";
+    docGridMode?: "explicit";
     docGridType?: string | null;
 }
 export declare function parseSectionProperties(sectPr: XmlElement): SectionProperties;

package/dist/import/docx/settings.d.ts

@@ -1,4 +1,5 @@
 export interface DocxSettings {
     adjustLineHeightInTable: boolean;
+    defaultTabStop?: number;
 }
 export declare function parseSettings(xml: string | null): DocxSettings;

package/dist/import/docx/styleUtils.d.ts

@@ -0,0 +1,6 @@
+import { Element as XmlElement } from '../../@xmldom/xmldom';
+
+export declare function stripUndefined<T extends object>(value: T): Partial<T> | undefined;
+export declare function emptyOrUndefined<T extends object>(obj: T): T | undefined;
+export declare function mergeStyles<T extends object>(base: T | undefined, local: T | undefined): T | undefined;
+export declare function parseShdFill(element: XmlElement | null): string | undefined;

package/dist/import/docx/stylesXml.d.ts

@@ -0,0 +1,4 @@
+import { EditorNamedStyle } from '../../../../core/model.js';
+import { DocxImportTheme } from '../../theme.js';
+
+export declare function parseImportedStyles(stylesXml: string | null, theme: DocxImportTheme): Record<string, EditorNamedStyle> | undefined;

package/dist/import/docx/tables.d.ts

@@ -2,7 +2,7 @@ import { default as JSZip } from '../../jszip';
 import { Element as XmlElement } from '../../@xmldom/xmldom';
 import { EditorNamedStyle, EditorTableNode } from '../../../../core/model.js';
 import { AssetRegistry } from '../../assetRegistry.js';
-import { ThemeFontMap } from '../../themeFonts.js';
+import { DocxImportTheme } from '../../theme.js';
 import { NumberingMaps } from '../../numbering.js';
 
-export declare function parseTableNode(tableNode: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, themeFonts: ThemeFontMap, styles?: Record<string, EditorNamedStyle>): Promise<EditorTableNode>;
+export declare function parseTableNode(tableNode: XmlElement, numberingMaps: NumberingMaps, zip: JSZip, relsMap: Map<string, string>, assets: AssetRegistry, theme: DocxImportTheme, styles?: Record<string, EditorNamedStyle>): Promise<EditorTableNode>;

package/dist/import/docx/theme.d.ts

@@ -0,0 +1,17 @@
+import { ThemeFontMap } from '../../themeFonts.js';
+import { ThemeColorMap } from '../../themeColors.js';
+
+/**
+ * Resolved `word/theme/theme1.xml` data threaded through the importer: the font
+ * scheme (for `*Theme` run fonts) and the color scheme (for `w:themeColor`).
+ */
+export interface DocxImportTheme {
+    fonts: ThemeFontMap;
+    colors: ThemeColorMap;
+}
+/**
+ * Parses `word/theme/theme1.xml` once and extracts both font and color scheme
+ * data. This is the only place the XML is parsed; the individual extractors
+ * ({@link extractThemeFonts}, {@link extractThemeColors}) work on the DOM node.
+ */
+export declare function parseDocxTheme(themeXml: string | null): DocxImportTheme;