@cj-tech-master/excelts 9.5.4 → 9.5.5

package/dist/types/modules/word/incremental-edit.d.ts

@@ -0,0 +1,123 @@
+/**
+ * DOCX Incremental Edit API
+ *
+ * Supports efficient "open → modify → save" workflows by editing a DOCX
+ * file at the ZIP entry level.
+ *
+ * Use cases:
+ * - Replace just the document.xml in an existing template
+ * - Update headers/footers without touching styles or images
+ * - Patch specific parts (e.g. core properties metadata)
+ *
+ * **Limitations and caveats — read before using `replacePart`/`deletePart`:**
+ *
+ * This API is a thin wrapper around ZIP entry mutation. It deliberately
+ * does not understand DOCX semantics:
+ *
+ * - `[Content_Types].xml` is **not** updated when you add a new part with
+ *   a previously-unseen content type. If your replacement part introduces
+ *   a new MIME type, callers must also patch `[Content_Types].xml` (or
+ *   round-trip through `readDocx` + `packageDocx` instead).
+ * - Relationship files (`*.rels`) are **not** rebuilt. Adding or deleting
+ *   a part with relationships will leave the corresponding `_rels/*.rels`
+ *   stale.
+ * - `replaceBody`, `replaceHeader`, `replaceFooter` only rewrite their
+ *   target XML part; they do **not** modify the corresponding `.rels` file
+ *   or copy in new media binaries. As a result they reject content that
+ *   would introduce new relationship IDs (images, hyperlinks, charts,
+ *   altChunks, opaque drawings carrying rIds) — use `patchDocument` /
+ *   `packageDocx` for those cases. Existing references that survive
+ *   unchanged are fine because their `.rels` entries already exist.
+ *
+ * For DOCX-aware edits (changes that may add/remove relationships or
+ * content types) use `patchDocument` or `compileTemplate`, or round-trip
+ * through `readDocx` + `packageDocx`.
+ *
+ * Note: This API operates on raw ZIP entries; it does not parse the DOCX
+ * model. For higher-level edits use `patchDocument` or `compileTemplate`.
+ */
+import type { BodyContent, Paragraph, Table } from "./types.js";
+/** A single incremental edit operation. */
+export type IncrementalEdit = {
+    /**
+     * Replace a specific part by raw bytes.
+     *
+     * Caveat: does not update `[Content_Types].xml` or any `.rels` file.
+     * Adding a part with a new content type or new relationships will
+     * produce a malformed package. See the file header for details.
+     */
+    readonly type: "replacePart";
+    readonly path: string;
+    readonly data: Uint8Array;
+} | {
+    /** Replace a part with a string (UTF-8 encoded). Same caveats as `replacePart`. */
+    readonly type: "replacePartText";
+    readonly path: string;
+    readonly text: string;
+} | {
+    /**
+     * Delete a specific part.
+     *
+     * Caveat: does not update `[Content_Types].xml` or any `.rels` file.
+     * Deleting a part that other parts reference (via rels or other XML)
+     * will leave dangling references — round-trip through readDocx +
+     * packageDocx if you need a consistent package.
+     */
+    readonly type: "deletePart";
+    readonly path: string;
+} | {
+    /** Replace the body content of `word/document.xml`. */
+    readonly type: "replaceBody";
+    readonly body: readonly BodyContent[];
+} | {
+    /** Replace a header part identified by path (e.g. `word/header1.xml`). */
+    readonly type: "replaceHeader";
+    readonly path: string;
+    readonly children: readonly (Paragraph | Table)[];
+} | {
+    /** Replace a footer part identified by path (e.g. `word/footer1.xml`). */
+    readonly type: "replaceFooter";
+    readonly path: string;
+    readonly children: readonly (Paragraph | Table)[];
+};
+/** Options for incremental editing. */
+export interface IncrementalEditOptions {
+    /** Compression level for replaced entries (0-9). Default: 6. */
+    readonly compressionLevel?: number;
+}
+/**
+ * Apply incremental edits to an existing DOCX file.
+ *
+ * Reads all parts from the original ZIP, applies the edits, and writes a
+ * new ZIP. Unchanged parts are passed through (decompressed and recompressed,
+ * but their content is not parsed).
+ *
+ * @param buffer - The original DOCX file as a Uint8Array.
+ * @param edits - Array of incremental edits to apply.
+ * @param options - Optional settings.
+ * @returns A new DOCX file as a Uint8Array.
+ *
+ * @example
+ * ```ts
+ * const original = await fs.readFile("template.docx");
+ * const edited = await editDocxIncremental(original, [
+ *   { type: "replaceBody", body: [...newParagraphs] }
+ * ]);
+ * ```
+ */
+export declare function editDocxIncremental(buffer: Uint8Array, edits: readonly IncrementalEdit[], options?: IncrementalEditOptions): Promise<Uint8Array>;
+/**
+ * List all part paths in a DOCX file without parsing the model.
+ *
+ * @param buffer - The DOCX file as a Uint8Array.
+ * @returns Array of part paths.
+ */
+export declare function listDocxParts(buffer: Uint8Array): Promise<string[]>;
+/**
+ * Read a single part's raw bytes from a DOCX file.
+ *
+ * @param buffer - The DOCX file as a Uint8Array.
+ * @param path - The part path (e.g. `"word/document.xml"`).
+ * @returns The part's raw bytes, or undefined if the part doesn't exist.
+ */
+export declare function readDocxPart(buffer: Uint8Array, path: string): Promise<Uint8Array | undefined>;

package/dist/types/modules/word/index.base.d.ts

@@ -2,15 +2,199 @@
  * DOCX Module - Base Exports (Platform Independent)
  *
  * Shared exports for both Node.js and browser environments.
+ *
+ * Each export is annotated with a `@stability` tag:
+ *
+ * - `@stability stable` — Public API. Backwards-compatible changes only;
+ *   semver-major bumps for any breaking changes.
+ * - `@stability experimental` — Public but evolving. The shape may change
+ *   without a major version bump while we collect feedback. Consumers
+ *   should pin to exact minor versions if they rely on these.
+ * - `@stability preserve-only` — Round-trip preservation types. They exist
+ *   so reading and writing a DOCX is loss-less; the underlying schema is
+ *   not yet promised to be ergonomic. Avoid building features on top of
+ *   them unless you also handle the underlying OOXML directly.
+ *
+ * Tree-shakeable subpaths: HTML/Markdown/Excel/PDF integrations live under
+ * `excelts/word/{html,markdown,excel}` and `excelts/pdf` — they are not
+ * re-exported here so bundlers can drop them when unused.
  */
-export type { HalfPoint, Twips, Emu, EighthPoint, HexColor, ShadingType, BorderStyle, PageOrientation, PageSize, PageMargins, ColumnDef, SectionColumns, SectionBreakType, PageNumberFormat, HeaderFooterType, HeaderFooterRef, PageVerticalAlign, DocumentGridType, PageTextDirection, Border, ArtBorderType, PageBorders, SectionProperties, UnderlineStyle, VerticalAlign, HighlightColor, FontSpec, Shading, UnderlineSpec, TextEffect, EmphasisMarkType, ColorSpec, RunProperties, RunContent, TextContent, BreakContent, TabContent, PositionalTabContent, RubyContent, RubyAlign, RubyProperties, SymbolContent, FootnoteRefContent, EndnoteRefContent, FieldContent, InlineImageContent, CarriageReturnContent, NoBreakHyphenContent, SoftHyphenContent, LastRenderedPageBreakContent, AnnotationReferenceContent, PageNumberType, DateFieldContent, Run, RevisionInfo, InsertedRun, DeletedRun, MovedFromRun, MovedToRun, MoveRangeMarker, CustomXmlTrackingMarker, ParagraphPropertyChange, RunPropertyChange, SectionPropertyChange, TableRowRevision, CommentDef, CommentRangeStart, CommentRangeEnd, CommentReference, Alignment, LineSpacingRule, LineSpacing, Indentation, TabStopType, TabStopLeader, TabStop, PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader, ParagraphBorders, NumberingRef, FrameAnchorType, DropCapType, ParagraphFrame, ParagraphProperties, Paragraph, Hyperlink, BookmarkStart, BookmarkEnd, ParagraphChild, TableWidth, TableBorders, TableCellMargins, TableLayout, TableLook, TableFloat, TableProperties, RowHeightRule, TableRowProperties, VerticalCellAlign, TextDirection, VerticalMerge, TableCellProperties, TableCell, TableRow, Table, HorizontalPositionRelative, VerticalPositionRelative, WrapStyle, WrapTextSide, WrapMargins, FloatingImage, DrawingShape, PresetShapeType, Chart, ChartType, ChartSeries, ChartLegendPosition, ChartAxis, ChartContent, AltChunk, WebSettings, PersonInfo, NoteType, TablePropertyChange, TableRowPropertyChange, TableCellPropertyChange, CellMergeRevision, OpaquePart, OpaqueRelationship, OpaqueDrawing, TableOfContents, MathRun, MathFraction, MathSuperScript, MathSubScript, MathSubSuperScript, MathPreSubSuperScript, MathPhantom, MathGroupChar, MathBorderBox, MathRadical, MathDelimiter, MathNary, MathFunction, MathLimit, MathMatrix, MathAccent, MathBar, MathBox, MathEquationArray, MathContent, MathBlock, TextBox, CheckBox, SdtListItem, SdtDateProperties, SdtProperties, SdtDataBinding, SdtCheckboxProperties, SdtRepeatingSectionProperties, StructuredDocumentTag, CustomXmlPart, BodyContent, StyleType, TableStyleConditionType, TableStyleConditionalFormat, StyleDef, DocDefaults, NumberFormat, LevelJustification, LevelSuffix, NumberingLevel, MultiLevelType, AbstractNumbering, LevelOverride, NumberingInstance, NumPicBullet, HeaderFooterContent, HeaderDef, FooterDef, FootnoteDef, EndnoteDef, ImageMediaType, ImageDef, FontFamily, FontPitch, FontDef, EmbeddedFont, ProtectionType, HyphenationSettings, DocumentSettings, CompatSetting, CompatFlag, DocumentBackground, DocumentTheme, ThemeColorScheme, ThemeFontScheme, ThemeFont, ThemeFormatScheme, ThemeColorName, CustomPropertyValue, CustomProperty, CoreProperties, AppProperties, DocxDocument, DocxOptions } from "./types.js";
-export { DocxError, DocxParseError, DocxWriteError, DocxMissingPartError, DocxInvalidStructureError, DocxUnsupportedFeatureError, isDocxError } from "./errors.js";
+/** @stability stable */
+export type { HalfPoint, Twips, Emu, EighthPoint, HexColor, ShadingType, BorderStyle, PageOrientation, PageSize, PageMargins, ColumnDef, SectionColumns, SectionBreakType, PageNumberFormat, HeaderFooterType, HeaderFooterRef, PageVerticalAlign, DocumentGridType, Border, ArtBorderType, PageBorders, SectionProperties, UnderlineStyle, VerticalAlign, HighlightColor, FontSpec, Shading, UnderlineSpec, TextEffect, EmphasisMarkType, EastAsianCombineBrackets, EastAsianLayoutSpec, ColorSpec, RunProperties, RunContent, TextContent, BreakContent, TabContent, PositionalTabContent, RubyContent, RubyAlign, RubyProperties, SymbolContent, FootnoteRefContent, EndnoteRefContent, FieldContent, InlineImageContent, CarriageReturnContent, NoBreakHyphenContent, SoftHyphenContent, LastRenderedPageBreakContent, AnnotationReferenceContent, PageNumberType, DateFieldContent, Run, RevisionInfo, InsertedRun, DeletedRun, MovedFromRun, MovedToRun, MoveRangeMarker, CustomXmlTrackingMarker, ParagraphPropertyChange, RunPropertyChange, SectionPropertyChange, TableRowRevision, CommentDef, CommentRangeStart, CommentRangeEnd, CommentReference, Alignment, LineSpacingRule, LineSpacing, Indentation, TabStopType, TabStopLeader, TabStop, PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader, ParagraphBorders, NumberingRef, FrameAnchorType, DropCapType, ParagraphFrame, ParagraphProperties, Paragraph, Hyperlink, BookmarkStart, BookmarkEnd, ParagraphChild, TableWidth, TableBorders, TableCellMargins, TableLayout, TableLook, TableFloat, TableProperties, RowHeightRule, TableRowProperties, VerticalCellAlign, TextDirection, VerticalMerge, TableCellProperties, TableCell, TableRow, Table, HorizontalPositionRelative, VerticalPositionRelative, WrapStyle, WrapTextSide, WrapMargins, FloatingImage, DrawingShape, PresetShapeType, Chart, ChartType, ChartSeries, ChartLegendPosition, ChartAxis, ChartContent, ChartExContent, ChartExData, ChartExSeriesData, ChartTrendline, ChartTrendlineType, ChartErrorBars, ChartErrorBarDirection, ChartErrorBarType, ChartDataLabels, ChartDataLabelPosition, AltChunk, WebSettings, PersonInfo, NoteType, FootnoteProperties, EndnoteProperties, NoteNumberFormat, NoteNumberRestart, TablePropertyChange, TableRowPropertyChange, TableCellPropertyChange, CellMergeRevision, DocxDocumentType, TableOfContents, MathRun, MathFraction, MathSuperScript, MathSubScript, MathSubSuperScript, MathPreSubSuperScript, MathPhantom, MathGroupChar, MathBorderBox, MathRadical, MathDelimiter, MathNary, MathFunction, MathLimit, MathMatrix, MathAccent, MathBar, MathBox, MathEquationArray, MathContent, MathBlock, TextBox, CheckBox, SdtListItem, SdtDateProperties, SdtProperties, SdtDataBinding, SdtCheckboxProperties, SdtRepeatingSectionProperties, StructuredDocumentTag, CustomXmlPart, FormFieldType, FormField, TextFormField, CheckBoxFormField, DropDownFormField, Watermark, TextWatermark, ImageWatermark, BodyContent, StyleType, TableStyleConditionType, TableStyleConditionalFormat, StyleDef, DocDefaults, NumberFormat, LevelJustification, LevelSuffix, NumberingLevel, MultiLevelType, AbstractNumbering, LevelOverride, NumberingInstance, NumPicBullet, HeaderFooterContent, HeaderDef, FooterDef, FootnoteDef, EndnoteDef, ImageMediaType, ImageDef, FontFamily, FontPitch, FontDef, EmbeddedFont, ProtectionType, HyphenationSettings, DocumentSettings, CompatSetting, CompatFlag, DocumentBackground, DocumentTheme, ThemeColorScheme, ThemeFontScheme, ThemeFont, ThemeFormatScheme, ThemeColorName, CustomPropertyValue, CustomProperty, CoreProperties, AppProperties, DocxDocument, DocxOptions } from "./types.js";
+/** @stability preserve-only */
+export type { OpaquePart, OpaqueRelationship, OpaqueDrawing, OpaqueRunContent, OpaqueParagraphChild } from "./types.js";
+/** @stability stable */
+export { DocxError, DocxParseError, DocxWriteError, DocxMissingPartError, DocxInvalidStructureError, DocxUnsupportedFeatureError, DocxEncryptedError, DocxDecryptionError, DocxLimitExceededError, isDocxError } from "./errors.js";
+/** @stability stable */
 export { inchesToTwips, twipsToInches, cmToTwips, twipsToCm, ptToTwips, twipsToPt, mmToTwips, inchesToEmu, emuToInches, cmToEmu, emuToCm, ptToEmu, pxToEmu, emuToPx, ptToHalfPoint, halfPointToPt, ptToEighthPoint, eighthPointToPt, lineMultiplierToSpacing, spacingToLineMultiplier, percentToTablePct, tablePctToPercent } from "./units.js";
-export { Document, text, bold, italic, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, field, pageNumberField, totalPagesField, sectionPagesField, sectionField, dateField, sequenceField, timeField, authorField, titleField, subjectField, keywordsField, fileNameField, fileSizeField, styleRefField, refField, pageRefField, noteRefField, hyperlinkField, quoteField, tocField, tcField, indexEntryField, indexField, ifField, includeTextField, includePictureField, formTextField, formCheckboxField, formDropdownField, paragraph, textParagraph, heading, hyperlink, bookmarkStart, bookmarkEnd, commentRangeStart, commentRangeEnd, commentReference, insertedRun, deletedRun, movedFromRun, movedToRun, moveFromRangeStart, moveFromRangeEnd, moveToRangeStart, moveToRangeEnd, checkBox, mathBlock, mathRun, mathFraction, mathSqrt, mathRoot, mathSum, mathIntegral, mathProduct, mathSuperScript, mathSubScript, mathSubSuperScript, mathPreSubSuperScript, mathPhantom, mathGroupChar, mathBorderBox, mathDelimiter, mathNary, mathFunction, mathLimit, mathMatrix, mathAccent, mathBar, mathBox, mathEquationArray, symbol, floatingImage, drawingShape, chart, structuredDocumentTag, border, gridBorders, cell, row, table, simpleTable, searchText, replaceText, resolveThemeColor, mailMerge, paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, tableCount, extractText } from "./document.js";
-export type { DocumentHandle, SearchResult, DocumentHeading } from "./document.js";
-export type { PatchContent, PatchOperation, PatchOptions } from "./document-io.js";
-export { packageDocx } from "./docx-packager.js";
-export { readDocx } from "./docx-reader.js";
-export { toBuffer, toBase64, patchDocument } from "./document-io.js";
-export { Field, Drawing, TrackChanges, Sdt, Query } from "./namespaces.js";
-export { Math as MathML } from "./namespaces.js";
+/** @stability stable */
+export { Document } from "./builder/document-handle.js";
+/** @stability stable */
+export type { DocumentHandle } from "./builder/document-handle.js";
+/** @stability stable — Run / Field / Math / shape / chart / SDT builders */
+export { text, bold, italic, underline, strikethrough, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, field, pageNumberField, totalPagesField, sectionPagesField, sectionField, dateField, sequenceField, timeField, authorField, titleField, subjectField, keywordsField, fileNameField, fileSizeField, styleRefField, refField, pageRefField, noteRefField, hyperlinkField, quoteField, tocField, tcField, indexEntryField, indexField, ifField, includeTextField, includePictureField, formTextField, formCheckboxField, formDropdownField, checkBox, mathBlock, mathRun, mathFraction, mathSqrt, mathRoot, mathSum, mathIntegral, mathProduct, mathSuperScript, mathSubScript, mathSubSuperScript, mathPreSubSuperScript, mathPhantom, mathGroupChar, mathBorderBox, mathDelimiter, mathNary, mathFunction, mathLimit, mathMatrix, mathAccent, mathBar, mathBox, mathEquationArray, symbol, floatingImage, drawingShape, chart, structuredDocumentTag } from "./builder/run-builders.js";
+/** @stability stable — paragraph / hyperlink / comment / track-changes builders */
+export { paragraph, textParagraph, heading, hyperlink, bookmarkStart, bookmarkEnd, commentRangeStart, commentRangeEnd, commentReference, insertedRun, deletedRun, movedFromRun, movedToRun, moveFromRangeStart, moveFromRangeEnd, moveToRangeStart, moveToRangeEnd } from "./builder/paragraph-builders.js";
+/** @stability stable — table builders */
+export { border, gridBorders, cell, row, table, simpleTable } from "./builder/table-builders.js";
+/** @stability stable — theme color resolution */
+export { resolveThemeColor } from "./core/color-utils.js";
+/** @stability stable — search / queries */
+export { paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, listSections, tableCount, extractText, searchText } from "./query/search.js";
+/** @stability stable */
+export type { SearchResult, DocumentHeading, DocumentSection } from "./query/search.js";
+/** @stability stable */
+export { replaceText } from "./query/replace.js";
+/** @stability stable */
+export { mailMerge } from "./query/mail-merge.js";
+/** @stability stable */
+export { mergeDocuments } from "./query/merge.js";
+/** @stability stable */
+export type { MergeOptions } from "./query/merge.js";
+/** @stability stable */
+export { splitDocument } from "./query/split.js";
+/** @stability stable */
+export type { SplitOptions } from "./query/split.js";
+/** @stability stable */
+export { acceptAllRevisions, rejectAllRevisions, listRevisions, acceptRevision, rejectRevision } from "./query/revisions.js";
+/** @stability stable */
+export type { RevisionEntry } from "./query/revisions.js";
+/** @stability stable */
+export { resolveStyle, resolveRunStyle, resolveNumberingLevel, resolveTableStyle } from "./query/style-resolve.js";
+/** @stability stable */
+export type { StyleResolveContext, ResolvedParagraphStyle, ResolvedRunStyle, ResolvedNumberingLevel } from "./query/style-resolve.js";
+/** @stability stable */
+export { getCompatibilityMode, setCompatibilityMode } from "./query/compat.js";
+/** @stability stable */
+export type { CompatibilityMode } from "./query/compat.js";
+/** @stability stable */
+export { resolveDataBindings } from "./query/data-binding.js";
+/** @stability stable */
+export { extractFormFields, fillFormFields } from "./query/form-fields.js";
+/** @stability stable */
+export type { FormFieldEntry } from "./query/form-fields.js";
+/** @stability stable */
+export type { PatchContent, PatchOperation, PatchOptions, CompiledTemplate } from "./document-io.js";
+export type { IncrementalEdit, IncrementalEditOptions } from "./incremental-edit.js";
+export { editDocxIncremental, listDocxParts, readDocxPart } from "./incremental-edit.js";
+/** @stability stable */
+export { packageDocx } from "./writer/docx-packager.js";
+/** @stability stable */
+export { readDocx } from "./reader/docx-reader.js";
+/** @stability stable */
+export type { ReadDocxOptions } from "./reader/docx-reader.js";
+/** @stability stable */
+export { toBuffer, toBase64, patchDocument, compileTemplate, patchTemplate, fillTemplateFromBuffer, toFlatOpcFromDoc } from "./document-io.js";
+/** @stability experimental */
+export { diffDocuments } from "./advanced/diff.js";
+/** @stability experimental */
+export type { DiffChangeType, DiffEntry, DiffSummary, DiffResult } from "./advanced/diff.js";
+/** @stability experimental */
+export { fillTemplate, fillTemplateEnhanced, listTemplateTags, isTemplateChart, TemplateError } from "./template/template-engine.js";
+/** @stability experimental */
+export type { TemplateOptions, TemplateImage, TemplateRichText, TemplateSubDocument, TemplateChart, TemplateHtmlChunk, TemplateTag } from "./template/template-engine.js";
+/** @stability stable */
+export { parseFlatOpc, isFlatOpc, toFlatOpc } from "./convert/flat-opc.js";
+/** @stability stable */
+export type { FlatOpcPart } from "./convert/flat-opc.js";
+/** @stability experimental */
+export { StreamingDocxWriter, createDocxStream } from "./writer/streaming-writer.js";
+/** @stability experimental */
+export type { StreamingDocxOptions, StreamingProgressCallback } from "./writer/streaming-writer.js";
+/** @stability experimental */
+export { validateDocument } from "./advanced/validation.js";
+/** @stability experimental */
+export type { ValidationSeverity, ValidationIssue, ValidationResult, ValidationOptions } from "./advanced/validation.js";
+/** @stability stable */
+export { embedFont, embedFontFamily, addEmbeddedFonts, subsetFont } from "./font/font-embed.js";
+/** @stability stable */
+export type { FontEmbedStyle, EmbedFontOptions, EmbedFontResult } from "./font/font-embed.js";
+/** @stability experimental */
+export { extractOleObjects, hasOleObjects, getOleObjectData, createOleEmbedding } from "./advanced/ole-objects.js";
+/** @stability experimental */
+export type { OleObject, OleObjectType, OleDisplayAs, OleExtractionResult } from "./advanced/ole-objects.js";
+/** @stability experimental */
+export { createBuildingBlock, createGlossaryDocument, findBuildingBlock, listBuildingBlocks, getAutoTextEntries, getQuickParts } from "./advanced/glossary.js";
+/** @stability experimental */
+export type { BuildingBlockGallery, BuildingBlock, GlossaryDocument } from "./advanced/glossary.js";
+/** @stability stable */
+export { protectDocument, unprotectDocument, isDocumentProtected, getProtectionState, verifyProtectionPassword } from "./security/document-protection.js";
+/** @stability stable */
+export type { ProtectionEditType, ProtectionHashAlgorithm, DocumentProtectionOptions, ProtectionState } from "./security/document-protection.js";
+/** @stability stable */
+export { parseStyleMap, createStyleMap, mergeStyleMaps, matchStyleMap, DEFAULT_STYLE_MAP } from "./advanced/style-map.js";
+/** @stability stable */
+export type { MappingSourceType, MappingCondition, MappingTarget, StyleMappingRule, StyleMap, StyleMapOptions } from "./advanced/style-map.js";
+/** @stability experimental */
+export { hasVbaProject, getVbaProjectInfo, getVbaProjectData, addVbaProject, removeVbaProject, listVbaParts } from "./advanced/vba-project.js";
+/** @stability experimental */
+export type { VbaProjectInfo } from "./advanced/vba-project.js";
+/** @stability experimental */
+export { layoutDocument } from "./layout/layout.js";
+/** @stability experimental */
+export type { LayoutResult, LayoutOptions } from "./layout/layout.js";
+/** @stability experimental */
+export { layoutDocumentFull } from "./layout/layout-full.js";
+/** @stability experimental */
+export type { FullLayoutOptions, PageGeometryOverride } from "./layout/layout-full.js";
+/** @stability experimental */
+export { updateFields, updateTableOfContents } from "./advanced/field-engine.js";
+/** @stability experimental */
+export type { FieldUpdateOptions } from "./advanced/field-engine.js";
+/** @stability experimental */
+export { ommlToMathML, mathMLToOmml } from "./advanced/math-convert.js";
+/** @stability experimental */
+export { createShape, createRect, createRoundRect, createEllipse, createLine, createArrow, createFlowchartShape, createCallout, createStar } from "./advanced/drawing-shapes.js";
+/** @stability experimental */
+export type { StandardShapeType, SolidFill, GradientStop, GradientFill, PatternFill, NoFill, ShapeFill, LineDash, LineEndType, LineEndSize, ShapeOutline, ShadowEffect, GlowEffect, ReflectionEffect, Effect3D, ShapeEffects, TextVerticalAnchor, TextWrap, ShapeTextBody, CreateShapeOptions } from "./advanced/drawing-shapes.js";
+/** @stability experimental — Text shaping for complex scripts */
+export { shapeText, detectScript, detectDirection } from "./font/text-shaping.js";
+export type { ScriptType, BiDiDirection, ShapedCluster, ShapingOptions } from "./font/text-shaping.js";
+/** @stability experimental — Hyphenation engine */
+export { createHyphenator, hyphenateWord, hyphenateText, ENGLISH_US_PATTERNS } from "./font/hyphenation.js";
+export type { HyphenationOptions, HyphenationPatterns } from "./font/hyphenation.js";
+/** @stability experimental — Format-based search */
+export { searchByFormat, countByFormat, getUsedFormats } from "./query/format-search.js";
+export type { FormatCriteria, FormatSearchResult } from "./query/format-search.js";
+/** @stability experimental — ODT (OpenDocument Text) read/write */
+export { readOdt, writeOdt } from "./convert/odt/odt.js";
+/** @stability experimental — Page rendering to SVG */
+export { renderPageToSvg, renderDocumentToSvg, renderPageFromLayout } from "./layout/render-page.js";
+export type { RenderOptions } from "./layout/render-page.js";
+/** @stability experimental — Template data source abstraction */
+export { JsonDataSource, XmlDataSource, CsvDataSource, CompositeDataSource, fillTemplateFromSource } from "./template/template-datasource.js";
+export type { DataSource } from "./template/template-datasource.js";
+/** @stability experimental — Chart data binding for templates */
+export { bindChartData } from "./template/template-chart.js";
+export type { ChartBinding, ChartSeriesData, ChartTemplateData } from "./template/template-chart.js";
+/** @stability stable — DOCX encryption */
+export { encryptDocx } from "./security/encryption.js";
+export type { EncryptOptions } from "./security/encryption.js";
+/** @stability experimental */
+export type { WordSecurityPolicy } from "./security/policy.js";
+/** @stability experimental */
+export { DEFAULT_SECURITY_POLICY, STRICT_SECURITY_POLICY, resolveSecurityPolicy } from "./security/policy.js";
+/** @stability experimental */
+export type { WordRenderContext, IdGenerators } from "./writer/render-context.js";
+/** @stability experimental */
+export { createRenderContext, createIdGenerators } from "./writer/render-context.js";
+/** @stability experimental */
+export type { DocxTransformer, MapOptions } from "./core/mapper.js";
+/** @stability experimental */
+export { mapDocument } from "./core/mapper.js";
+/** @stability experimental */
+export type { DocxVisitor, WalkPath, WalkOptions, VisitAction } from "./core/walker.js";
+/** @stability experimental */
+export { walkDocument, walkBlocks, collectParagraphs, collectRuns, collectTables } from "./core/walker.js";
+/** @stability experimental */
+export type { LayoutDocument, LayoutPage, PageGeometry, PageContent, LayoutParagraph, LayoutTable, LayoutTableCell, LayoutImage, LayoutFloat, LayoutFloatWrap, LayoutTextBox, LayoutShape, LayoutChart, LayoutSdt, LayoutMath, LayoutCheckBox, LayoutTableOfContents, LayoutAltChunk, LayoutOpaqueDrawing, LineBox, LineBoxItem, PositionedInlineImage, PositionedRun } from "./layout/layout-model.js";
+/** @stability experimental */
+export type { SemanticDocument, SemanticBlock, SemanticInline, ConversionContext, ConversionWarning, ConversionAsset, ResolvedFormatting } from "./convert/conversion-ir.js";
+/** @stability experimental */
+export { createConversionContext } from "./convert/conversion-ir.js";
+/** @stability experimental */
+export { docxToSemantic } from "./convert/docx-to-semantic.js";
+/** @stability experimental */
+export type { DocxToSemanticOptions } from "./convert/docx-to-semantic.js";
+/** @stability experimental */
+export type { AssetRef, MediaAsset } from "./types.js";

package/dist/types/modules/word/layout/layout-constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared layout constants for the layout / pagination / SVG render modules.
+ *
+ * These defaults are used when a `SectionProperties` does not specify a
+ * page size or margin. Keeping them in a single file avoids drift between
+ * `layout.ts`, `layout-full.ts`, and `render-page.ts`.
+ *
+ * The values match Microsoft Word's defaults for US Letter paper:
+ *   - Page size: 8.5 in × 11 in (12240 × 15840 twips)
+ *   - Margins:   1 in on all sides (1440 twips)
+ */
+/** Default page width in twips (US Letter, 8.5 in). */
+export declare const DEFAULT_PAGE_WIDTH_TWIPS = 12240;
+/** Default page height in twips (US Letter, 11 in). */
+export declare const DEFAULT_PAGE_HEIGHT_TWIPS = 15840;
+/** Default page margin in twips (1 in on each side). */
+export declare const DEFAULT_PAGE_MARGIN_TWIPS = 1440;

package/dist/types/modules/word/layout/layout-full.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Full Layout Engine — produces a complete LayoutDocument with positioned elements.
+ *
+ * Uses the pagination result from layoutDocument() for page assignments,
+ * then computes precise positions (x, y, width, height) for every body
+ * element on each page.
+ *
+ * This is the bridge between the page-number-only LayoutResult and the
+ * fully positioned LayoutDocument that renderers (SVG, PDF, Canvas) can consume.
+ *
+ * Coverage: every variant of `BodyContent` from `../types` produces a
+ * `PageContent` variant in the output. The `default:` branch of the
+ * dispatch switch in `buildPage()` is a `never`-typed exhaustiveness
+ * guard — adding a new body variant without a matching layout function
+ * is a build error, never a silent drop.
+ */
+import type { DocxDocument } from "../types.js";
+import type { LayoutOptions } from "./layout.js";
+import type { LayoutDocument } from "./layout-model.js";
+/**
+ * Page geometry overrides for {@link FullLayoutOptions}. All fields are
+ * in points. Any field not supplied falls back to the corresponding
+ * value resolved from `doc.sectionProperties` (or the engine defaults).
+ */
+export interface PageGeometryOverride {
+    readonly pageWidth?: number;
+    readonly pageHeight?: number;
+    readonly marginTop?: number;
+    readonly marginBottom?: number;
+    readonly marginLeft?: number;
+    readonly marginRight?: number;
+}
+/** Options for the full layout engine. */
+export interface FullLayoutOptions extends LayoutOptions {
+    /** Font map for font-family resolution (name → actual font). */
+    readonly fonts?: ReadonlyMap<string, string>;
+    /**
+     * Override the page geometry resolved from `doc.sectionProperties`.
+     * Used by hosts that drive layout with their own page model (e.g. the
+     * PDF bridge translating `DocxToPdfOptions.pageWidth` into a layout
+     * geometry override). Any unspecified field falls back to the
+     * section properties / engine defaults.
+     */
+    readonly pageGeometry?: PageGeometryOverride;
+}
+/**
+ * Perform full document layout, producing a LayoutDocument with precise positions.
+ *
+ * @param doc - The parsed DOCX document.
+ * @param options - Layout and font options.
+ * @returns A fully positioned LayoutDocument.
+ */
+export declare function layoutDocumentFull(doc: DocxDocument, options?: FullLayoutOptions): LayoutDocument;