@cj-tech-master/excelts 9.5.0 → 9.5.1

package/dist/types/modules/word/document.d.ts

@@ -4,8 +4,11 @@
  * High-level fluent API for constructing DOCX documents programmatically.
  * Provides convenience methods for common operations including comments,
  * track changes, TOC, math, text boxes, checkboxes, and custom properties.
+ *
+ * This file has NO static imports from docx-packager or docx-reader,
+ * ensuring that importing builder helpers does not pull in archive/xml code.
  */
-import type { DocxDocument, BodyContent, Paragraph, ParagraphProperties, ParagraphChild, Run, RunProperties, Table, TableRow, TableCell, TableProperties, TableRowProperties, TableCellProperties, SectionProperties, StyleDef, DocDefaults, BookmarkStart, Hyperlink, HeaderFooterContent, ImageDef, ImageMediaType, CoreProperties, AppProperties, DocumentSettings, FontDef, Border, TableWidth, TableBorders, Emu, Twips, CommentDef, DocumentBackground, CustomPropertyValue, TableOfContents, MathBlock, MathContent, CheckBox, RevisionInfo, InsertedRun, DeletedRun, MovedFromRun, MovedToRun, MoveRangeMarker, Chart, ChartSeries, ChartAxis, ChartLegendPosition, ChartContent, CommentRangeStart, CommentRangeEnd, CommentReference, FloatingImage, StructuredDocumentTag, SdtProperties, Watermark, DocumentTheme, ColorSpec, HexColor, DrawingShape, PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader, RubyProperties } from "./types.js";
+import type { DocxDocument, BodyContent, Paragraph, ParagraphProperties, ParagraphChild, Run, RunProperties, Table, TableRow, TableCell, TableProperties, TableRowProperties, TableCellProperties, SectionProperties, StyleDef, DocDefaults, BookmarkStart, Hyperlink, HeaderFooterContent, ImageDef, ImageMediaType, CoreProperties, AppProperties, DocumentSettings, FontDef, Border, TableWidth, TableBorders, Emu, Twips, CommentDef, DocumentBackground, CustomPropertyValue, TableOfContents, MathBlock, MathContent, CheckBox, RevisionInfo, InsertedRun, DeletedRun, MovedFromRun, MovedToRun, MoveRangeMarker, Chart, ChartSeries, ChartAxis, ChartLegendPosition, ChartContent, CommentRangeStart, CommentRangeEnd, CommentReference, FloatingImage, StructuredDocumentTag, SdtProperties, Watermark, HexColor, DrawingShape, 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. */
@@ -411,71 +414,55 @@ export declare function simpleTable(data: string[][], options?: {
     width?: TableWidth;
     columnWidths?: Twips[];
 }): Table;
+declare const _documentBrand: unique symbol;
+/**
+ * Opaque handle representing a document being built.
+ * Created via `Document.create()`, passed to `Document.*` functions.
+ */
+export type DocumentHandle = {
+    readonly [_documentBrand]: true;
+};
 /**
- * Fluent builder for constructing DOCX documents.
+ * Namespace of free functions for building DOCX documents.
+ *
+ * Replaces the former `DocumentBuilder` class with tree-shakeable free functions.
+ * Each function operates on an opaque `DocumentHandle`.
  *
  * @example
  * ```ts
- * const doc = new DocumentBuilder()
- *   .addHeading("Hello World", 1)
- *   .addParagraph("This is a paragraph.")
- *   .addTable([["Name", "Age"], ["Alice", "30"]])
- *   .build();
- *
- * const bytes = await doc.toBuffer();
+ * const doc = Document.create();
+ * Document.addHeading(doc, "Hello World", 1);
+ * Document.addParagraph(doc, "This is a paragraph.");
+ * Document.addTable(doc, [["Name", "Age"], ["Alice", "30"]]);
+ * const bytes = await Document.toBuffer(doc);
  * ```
  */
-export declare class DocumentBuilder {
-    private _body;
-    private _sectionProperties?;
-    private _styles;
-    private _docDefaults?;
-    private _abstractNumberings;
-    private _numberingInstances;
-    private _headers;
-    private _footers;
-    private _footnotes;
-    private _endnotes;
-    private _images;
-    private _fonts;
-    private _settings?;
-    private _coreProperties?;
-    private _appProperties?;
-    private _comments;
-    private _background?;
-    private _customProperties;
-    private _watermark?;
-    private _nextImageId;
-    private _nextFootnoteId;
-    private _nextEndnoteId;
-    private _nextBookmarkId;
-    private _nextAbstractNumId;
-    private _nextNumId;
-    private _nextDrawingId;
-    private _nextCommentId;
+export declare const Document: {
+    /** Create a new document handle. */
+    create(): DocumentHandle;
     /** Add raw body content. */
-    addContent(content: BodyContent): this;
+    addContent(doc: DocumentHandle, content: BodyContent): void;
     /** Add a paragraph with runs. */
-    addParagraphElement(para: Paragraph): this;
+    addParagraphElement(doc: DocumentHandle, para: Paragraph): void;
     /** Add a simple text paragraph. */
-    addParagraph(content: string, properties?: ParagraphProperties & {
+    addParagraph(doc: DocumentHandle, content: string, properties?: ParagraphProperties & {
         run?: RunProperties;
-    }): this;
+    }): void;
     /** Add a heading. */
-    addHeading(content: string, level?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9): this;
+    addHeading(doc: DocumentHandle, content: string, level?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9): void;
     /** Add a page break. */
-    addPageBreak(): this;
+    addPageBreak(doc: DocumentHandle): void;
     /** Add a table from a 2D array. */
-    addTable(data: string[][], options?: {
+    addTable(doc: DocumentHandle, data: string[][], options?: {
         headerRow?: boolean;
         borders?: boolean;
         width?: TableWidth;
         columnWidths?: Twips[];
-    }): this;
+    }): void;
     /** Add a table element. */
-    addTableElement(tbl: Table): this;
+    addTableElement(doc: DocumentHandle, tbl: Table): void;
     /** Add an inline image. Returns the image relationship ID and drawing ID. */
-    addImage(data: Uint8Array, mediaType: ImageMediaType, width: Emu, height: Emu, options?: {
+    addImage(doc: DocumentHandle, data: Uint8Array, mediaType: ImageMediaType, width: Emu, height: Emu, options?: {
         altText?: string;
         name?: string;
     }): {
@@ -483,7 +470,7 @@ export declare class DocumentBuilder {
         drawingId: number;
     };
     /** Add a floating image. Returns the image relationship ID. */
-    addFloatingImage(data: Uint8Array, mediaType: ImageMediaType, width: Emu, height: Emu, options?: {
+    addFloatingImage(doc: DocumentHandle, data: Uint8Array, mediaType: ImageMediaType, width: Emu, height: Emu, options?: {
         altText?: string;
         name?: string;
         horizontalPosition?: FloatingImage["horizontalPosition"];
@@ -502,76 +489,63 @@ export declare class DocumentBuilder {
         flipVertical?: boolean;
     }): string;
     /** Add a custom font definition. */
-    addFont(font: FontDef): this;
+    addFont(doc: DocumentHandle, font: FontDef): void;
     /** Set a text watermark on the document. */
-    setWatermark(watermark: Watermark): this;
+    setWatermark(doc: DocumentHandle, watermark: Watermark): void;
     /** Add a footnote. Returns the footnote ID. */
-    addFootnote(content: string | Paragraph[]): number;
+    addFootnote(doc: DocumentHandle, content: string | Paragraph[]): number;
     /** Add an endnote. Returns the endnote ID. */
-    addEndnote(content: string | Paragraph[]): number;
+    addEndnote(doc: DocumentHandle, content: string | Paragraph[]): number;
     /** Add a comment. Returns the comment ID. */
-    addComment(author: string, content: string | Paragraph[], options?: {
+    addComment(doc: DocumentHandle, author: string, content: string | Paragraph[], options?: {
         date?: string;
         initials?: string;
     }): number;
     /** Add a Table of Contents. */
-    addTableOfContents(options?: Partial<Omit<TableOfContents, "type">>): this;
+    addTableOfContents(doc: DocumentHandle, options?: Partial<Omit<TableOfContents, "type">>): void;
     /** Add a math equation block. */
-    addMath(content: MathContent[]): this;
+    addMath(doc: DocumentHandle, content: MathContent[]): void;
     /** Add a text box. */
-    addTextBox(content: string | Paragraph[], options?: {
+    addTextBox(doc: DocumentHandle, content: string | Paragraph[], options?: {
         width?: Twips;
         height?: Twips;
         stroke?: boolean;
         fill?: boolean;
-    }): this;
+    }): void;
     /** Add a bullet list. */
-    addBulletList(items: string[], level?: number): this;
+    addBulletList(doc: DocumentHandle, items: string[], level?: number): void;
     /** Add a numbered list. */
-    addNumberedList(items: string[], level?: number): this;
+    addNumberedList(doc: DocumentHandle, items: string[], level?: number): void;
     /** Set section properties (page size, margins, etc.). */
-    setSectionProperties(props: SectionProperties): this;
+    setSectionProperties(doc: DocumentHandle, props: SectionProperties): void;
     /** Set document defaults. */
-    setDocDefaults(defaults: DocDefaults): this;
+    setDocDefaults(doc: DocumentHandle, defaults: DocDefaults): void;
     /** Add a style definition. */
-    addStyle(style: StyleDef): this;
+    addStyle(doc: DocumentHandle, style: StyleDef): void;
     /** Set default styles (Normal, Heading1-6, Hyperlink, etc.). */
-    useDefaultStyles(): this;
+    useDefaultStyles(doc: DocumentHandle): void;
     /** Set a header for the given type. */
-    setHeader(type: string, content: HeaderFooterContent): this;
+    setHeader(doc: DocumentHandle, type: string, content: HeaderFooterContent): void;
     /** Set a footer for the given type. */
-    setFooter(type: string, content: HeaderFooterContent): this;
+    setFooter(doc: DocumentHandle, type: string, content: HeaderFooterContent): void;
     /** Set document settings. */
-    setSettings(settings: DocumentSettings): this;
+    setSettings(doc: DocumentHandle, settings: DocumentSettings): void;
     /** Set core properties (metadata). */
-    setCoreProperties(props: CoreProperties): this;
+    setCoreProperties(doc: DocumentHandle, props: CoreProperties): void;
     /** Set application properties. */
-    setAppProperties(props: AppProperties): this;
+    setAppProperties(doc: DocumentHandle, props: AppProperties): void;
     /** Set document background. */
-    setBackground(background: DocumentBackground): this;
+    setBackground(doc: DocumentHandle, background: DocumentBackground): void;
     /** Add a custom document property. */
-    addCustomProperty(name: string, value: CustomPropertyValue): this;
+    addCustomProperty(doc: DocumentHandle, name: string, value: CustomPropertyValue): void;
     /** Add a section break with properties. */
-    addSectionBreak(props: SectionProperties): this;
+    addSectionBreak(doc: DocumentHandle, props: SectionProperties): void;
     /** Get next available bookmark ID. */
-    nextBookmarkId(): number;
-    /** Build the DocxDocument model. */
-    build(): DocxDocument;
-    /** Build and package to DOCX bytes. */
-    toBuffer(compressionLevel?: number): Promise<Uint8Array>;
-    /** Build and package to base64 string. */
-    toBase64(compressionLevel?: number): Promise<string>;
-}
-/**
- * Resolve a ColorSpec to an actual hex RGB color using the document theme.
- *
- * Applies theme color lookup + tint/shade transformations per OOXML spec.
- *
- * @param color - The color value (HexColor string or ColorSpec).
- * @param theme - The document theme (from `doc.theme`).
- * @returns Resolved hex color string (6 chars, no #), or undefined if unresolvable.
- */
-export declare function resolveThemeColor(color: HexColor | ColorSpec | undefined, theme?: DocumentTheme): HexColor | undefined;
+    nextBookmarkId(doc: DocumentHandle): number;
+    /** Build the DocxDocument model from the handle. */
+    build(doc: DocumentHandle): DocxDocument;
+};
+export { resolveThemeColor } from "./color-utils.js";
 /** Result of a text search in a document. */
 export interface SearchResult {
     /** Paragraph index in body. */
@@ -680,49 +654,4 @@ export declare function mailMerge(doc: DocxDocument, data: Record<string, string
     /** If true, remove fields not found in data. Default: false (leave unchanged). */
     removeUnmatched?: boolean;
 }): number;
-/** Type of content to patch into a placeholder. */
-export type PatchContent = {
-    readonly type: "text";
-    readonly text: string;
-} | {
-    readonly type: "paragraph";
-    readonly children: readonly Paragraph[];
-} | {
-    readonly type: "table";
-    readonly table: Table;
-} | {
-    readonly type: "image";
-    readonly image: ImageDef;
-    readonly width: number;
-    readonly height: number;
-};
-/** A single patch operation mapping a placeholder to replacement content. */
-export interface PatchOperation {
-    /** Placeholder string to find (e.g. "{{name}}"). */
-    readonly placeholder: string;
-    /** Content to replace the placeholder with. */
-    readonly content: PatchContent;
-}
-/** Options for patchDocument. */
-export interface PatchOptions {
-    /** Compression level (0-9). Default: 6. */
-    readonly compressionLevel?: number;
-}
-/**
- * Read an existing DOCX file, replace placeholders with content, and produce a new DOCX.
- *
- * Placeholders are strings like `{{name}}` embedded in the document text.
- * They may span across multiple runs — the patcher handles cross-run matching.
- *
- * Supported patch content types:
- * - `text` — simple text replacement (preserves formatting of the first run)
- * - `paragraph` — replaces the entire paragraph containing the placeholder
- * - `table` — replaces the entire paragraph with a table
- * - `image` — replaces the placeholder with an inline image
- *
- * @param buffer - The source DOCX file as a Uint8Array.
- * @param patches - Array of patch operations to apply.
- * @param options - Optional compression settings.
- * @returns New DOCX file as a Uint8Array.
- */
-export declare function patchDocument(buffer: Uint8Array, patches: readonly PatchOperation[], options?: PatchOptions): Promise<Uint8Array>;
+export type { PatchContent, PatchOperation, PatchOptions } from "./document-io.js";

package/dist/types/modules/word/html.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DOCX Module - HTML Renderer (Subpath Export)
+ *
+ * Import separately to avoid pulling html-renderer into the bundle
+ * when only core document building is needed.
+ *
+ * @example
+ * ```ts
+ * import { renderToHtml } from "excelts/word/html";
+ * ```
+ */
+export { renderToHtml } from "./html-renderer.js";
+export type { HtmlRenderOptions, HtmlRenderResult } from "./html-renderer.js";

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

@@ -6,14 +6,11 @@
 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";
 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 { DocumentBuilder, 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, patchDocument, mailMerge, paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, tableCount, extractText } from "./document.js";
-export type { SearchResult, PatchContent, PatchOperation, PatchOptions, DocumentHeading } from "./document.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 { deobfuscateFont, obfuscateFont, generateFontKey } from "./font-obfuscation.js";
-export { isEncryptedDocx, verifyPassword, decryptPackage, parseEncryptionInfoXml, deriveEncryptionKey, AGILE_BLOCK_KEYS } from "./encryption.js";
-export type { AgileEncryptionInfo } from "./encryption.js";
-export { hasDigitalSignatures, parseSignatureXml, extractSignatures, isWellFormedSignature } from "./digital-signatures.js";
-export type { DigitalSignatureInfo } from "./digital-signatures.js";
-export { renderToHtml } from "./html-renderer.js";
-export type { HtmlRenderOptions, HtmlRenderResult } from "./html-renderer.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";

package/dist/types/modules/word/namespaces.d.ts

@@ -0,0 +1,159 @@
+/**
+ * DOCX Module — Sub-namespace objects
+ *
+ * Groups flat builder helpers into logical namespaces for better
+ * IDE discoverability. These are re-exports aggregated into objects;
+ * since they reference the same underlying functions, tree-shaking
+ * still applies at the individual function level for consumers who
+ * import the flat named exports instead.
+ *
+ * @example
+ * ```ts
+ * import { Run, Paragraph, Table, Math, Field } from "excelts/word";
+ *
+ * const doc = Document.create();
+ * Document.addParagraphElement(doc, Paragraph.create([
+ *   Run.bold("Hello"),
+ *   Run.text(" world")
+ * ]));
+ * ```
+ */
+import { text, bold, italic, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, symbol, 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, floatingImage, drawingShape, chart, structuredDocumentTag, border, gridBorders, cell, row, table, simpleTable, searchText, replaceText, mailMerge, paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, tableCount, extractText } from "./document.js";
+/** Namespace for creating text runs (inline content). */
+export declare const Run: {
+    text: typeof text;
+    bold: typeof bold;
+    italic: typeof italic;
+    pageBreak: typeof pageBreak;
+    lineBreak: typeof lineBreak;
+    columnBreak: typeof columnBreak;
+    tab: typeof tab;
+    positionalTab: typeof positionalTab;
+    ruby: typeof ruby;
+    carriageReturn: typeof carriageReturn;
+    noBreakHyphen: typeof noBreakHyphen;
+    softHyphen: typeof softHyphen;
+    symbol: typeof symbol;
+};
+/** Namespace for creating field codes. */
+export declare const Field: {
+    create: typeof field;
+    pageNumber: typeof pageNumberField;
+    totalPages: typeof totalPagesField;
+    sectionPages: typeof sectionPagesField;
+    section: typeof sectionField;
+    date: typeof dateField;
+    sequence: typeof sequenceField;
+    time: typeof timeField;
+    author: typeof authorField;
+    title: typeof titleField;
+    subject: typeof subjectField;
+    keywords: typeof keywordsField;
+    fileName: typeof fileNameField;
+    fileSize: typeof fileSizeField;
+    styleRef: typeof styleRefField;
+    ref: typeof refField;
+    pageRef: typeof pageRefField;
+    noteRef: typeof noteRefField;
+    hyperlink: typeof hyperlinkField;
+    quote: typeof quoteField;
+    toc: typeof tocField;
+    tc: typeof tcField;
+    indexEntry: typeof indexEntryField;
+    index: typeof indexField;
+    condition: typeof ifField;
+    includeText: typeof includeTextField;
+    includePicture: typeof includePictureField;
+    formText: typeof formTextField;
+    formCheckbox: typeof formCheckboxField;
+    formDropdown: typeof formDropdownField;
+};
+/** Namespace for creating paragraphs. */
+export declare const Paragraph: {
+    create: typeof paragraph;
+    text: typeof textParagraph;
+    heading: typeof heading;
+    hyperlink: typeof hyperlink;
+    bookmarkStart: typeof bookmarkStart;
+    bookmarkEnd: typeof bookmarkEnd;
+};
+/** Namespace for comment-related markers. */
+export declare const Comment: {
+    rangeStart: typeof commentRangeStart;
+    rangeEnd: typeof commentRangeEnd;
+    reference: typeof commentReference;
+};
+/** Namespace for track-changes (revision) markers. */
+export declare const TrackChanges: {
+    insertedRun: typeof insertedRun;
+    deletedRun: typeof deletedRun;
+    movedFromRun: typeof movedFromRun;
+    movedToRun: typeof movedToRun;
+    moveFromRangeStart: typeof moveFromRangeStart;
+    moveFromRangeEnd: typeof moveFromRangeEnd;
+    moveToRangeStart: typeof moveToRangeStart;
+    moveToRangeEnd: typeof moveToRangeEnd;
+};
+/** Namespace for OMML (Office Math) content. */
+export declare const Math: {
+    block: typeof mathBlock;
+    run: typeof mathRun;
+    fraction: typeof mathFraction;
+    sqrt: typeof mathSqrt;
+    root: typeof mathRoot;
+    sum: typeof mathSum;
+    integral: typeof mathIntegral;
+    product: typeof mathProduct;
+    superScript: typeof mathSuperScript;
+    subScript: typeof mathSubScript;
+    subSuperScript: typeof mathSubSuperScript;
+    preSubSuperScript: typeof mathPreSubSuperScript;
+    phantom: typeof mathPhantom;
+    groupChar: typeof mathGroupChar;
+    borderBox: typeof mathBorderBox;
+    delimiter: typeof mathDelimiter;
+    nary: typeof mathNary;
+    func: typeof mathFunction;
+    limit: typeof mathLimit;
+    matrix: typeof mathMatrix;
+    accent: typeof mathAccent;
+    bar: typeof mathBar;
+    box: typeof mathBox;
+    equationArray: typeof mathEquationArray;
+};
+/** Namespace for creating tables. */
+export declare const Table: {
+    create: typeof table;
+    simple: typeof simpleTable;
+    row: typeof row;
+    cell: typeof cell;
+    border: typeof border;
+    gridBorders: typeof gridBorders;
+};
+/** Namespace for drawings (images, shapes, charts). */
+export declare const Drawing: {
+    floatingImage: typeof floatingImage;
+    shape: typeof drawingShape;
+    chart: typeof chart;
+};
+/** Namespace for structured document tags (content controls). */
+export declare const Sdt: {
+    create: typeof structuredDocumentTag;
+    checkBox: typeof checkBox;
+};
+/** Namespace for querying/searching document content. */
+export declare const Query: {
+    search: typeof searchText;
+    replace: typeof replaceText;
+    mailMerge: typeof mailMerge;
+    paragraphCount: typeof paragraphCount;
+    countWords: typeof countWords;
+    getHeadings: typeof getHeadings;
+    findBookmark: typeof findBookmark;
+    findComment: typeof findComment;
+    listImages: typeof listImages;
+    listTables: typeof listTables;
+    listHyperlinks: typeof listHyperlinks;
+    tableCount: typeof tableCount;
+    extractText: typeof extractText;
+};

package/dist/types/modules/word/relationships.d.ts

@@ -3,6 +3,7 @@
  *
  * Manages OPC relationships for the DOCX package.
  * Generates .rels files for package-level and part-level relationships.
+ * Uses a plain data record + free functions for tree-shakeability.
  */
 import type { XmlSink } from "../xml/types.js";
 /** A single OPC relationship. */
@@ -12,20 +13,18 @@ export interface Relationship {
     readonly target: string;
     readonly targetMode?: "External";
 }
-/**
- * Manages relationships and generates .rels XML.
- */
-export declare class RelationshipManager {
-    private readonly _rels;
-    private _nextId;
-    /** Add a relationship and return its assigned rId. */
-    add(type: string, target: string, targetMode?: "External"): string;
-    /** Add a relationship with a specific ID. */
-    addWithId(id: string, type: string, target: string, targetMode?: "External"): void;
-    /** Get all relationships. */
-    get relationships(): readonly Relationship[];
-    /** Get the number of relationships. */
-    get count(): number;
-    /** Render the relationships XML to a sink. */
-    render(xml: XmlSink): void;
+/** Internal state for relationships (plain record, not a class). */
+export interface RelationshipsState {
+    readonly rels: Relationship[];
+    nextId: number;
 }
+/** Create a new empty RelationshipsState. */
+export declare function createRelationships(): RelationshipsState;
+/** Add a relationship and return its assigned rId. */
+export declare function addRelationship(state: RelationshipsState, type: string, target: string, targetMode?: "External"): string;
+/** Add a relationship with a specific ID. */
+export declare function addRelationshipWithId(state: RelationshipsState, id: string, type: string, target: string, targetMode?: "External"): void;
+/** Get the number of relationships. */
+export declare function getRelationshipCount(state: RelationshipsState): number;
+/** Render the relationships XML to a sink. */
+export declare function renderRelationships(state: RelationshipsState, xml: XmlSink): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "9.5.0",
+  "version": "9.5.1",
   "description": "Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.",
   "keywords": [
     "archive",