@betteroffice/docx 0.0.1 → 0.0.2

package/dist/docx/rezip.d.mts

@@ -1,148 +0,0 @@
-import { Document } from '../types/document.mjs';
-import '../content-sSHuWw49.mjs';
-import '../formatting-DoL7KBSL.mjs';
-import './wrapTypes.mjs';
-import '../styles-VxNcXLdi.mjs';
-import '../settingsParser-CcGvtmCK.mjs';
-
-/**
- * Zip-container READ facade for the DOCX open path.
- *
- * Backed by the inlined docx-container wasm (see ./wasm): every non-directory
- * entry is inflated in Rust — with the decompression-bomb and path-traversal
- * guards enforced there by construction — and exposed as a normalized, eager
- * read view. Consumers pull parts by path.
- *
- * Read path only. The write/rezip builder assembles a parts map and hands it
- * to the same wasm container via `rezipContainer` (see ./rezip).
- */
-/**
- * Eager, normalized read view of an OPC (DOCX) container. All entries are
- * already materialized; lookups are synchronous.
- */
-interface ZipContainerReader {
-    paths(): string[];
-    file(path: string): Uint8Array | null;
-    text(path: string): string | null;
-}
-
-/**
- * Legacy raw-package shape retained for the public rezip compatibility
- * signature. Live parsing no longer constructs it; Rust S9 owns extraction.
- */
-interface RawDocxContent {
-    documentXml: string | null;
-    stylesXml: string | null;
-    themeXml: string | null;
-    numberingXml: string | null;
-    fontTableXml: string | null;
-    settingsXml: string | null;
-    webSettingsXml: string | null;
-    headers: Map<string, string>;
-    footers: Map<string, string>;
-    footnotesXml: string | null;
-    endnotesXml: string | null;
-    commentsXml: string | null;
-    commentsExtensibleXml: string | null;
-    commentsExtendedXml: string | null;
-    documentRels: string | null;
-    packageRels: string | null;
-    contentTypesXml: string | null;
-    corePropsXml: string | null;
-    appPropsXml: string | null;
-    customPropsXml: string | null;
-    media: Map<string, ArrayBuffer>;
-    fonts: Map<string, ArrayBuffer>;
-    allXml: Map<string, string>;
-    container: ZipContainerReader;
-    originalBuffer: ArrayBuffer;
-}
-
-/**
- * Part Enumeration
- *
- * Shared helpers for walking the parts of a DOCX package (body, headers,
- * footers, footnotes, endnotes) when registering newly inserted images and
- * hyperlinks against each part's rels file.
- */
-
-/**
- * The assembled DOCX package as a `path -> bytes` map. Both the full-repack and
- * selective-save flows build one of these and hand it to the wasm container.
- */
-type PartsMap = Map<string, Uint8Array>;
-/**
- * Find the highest rId number in a relationships XML string.
- */
-declare function findMaxRId(relsXml: string): number;
-
-/**
- * Empty DOCX Template
- *
- * Produces a minimal valid DOCX package — Content Types, package + document
- * rels, an empty body with the standard letter-size section, default
- * Calibri 11 styles, and core/app properties. Used as the base for
- * `createDocx()` when the caller has no existing buffer.
- */
-/**
- * Create a new empty DOCX file.
- *
- * @returns Promise resolving to minimal DOCX as ArrayBuffer
- */
-declare function createEmptyDocx(): Promise<ArrayBuffer>;
-
-/**
- * Public DOCX package I/O wrappers.
- *
- * Model serialization and selective package writing are Rust-owned. The
- * TypeScript kept here is compatibility glue for public ZIP utilities and host
- * values; package inflation/deflation continues through `docx-container` wasm.
- * @packageDocumentation
- * @public
- */
-
-declare const COMMENTS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml";
-declare const COMMENTS_EXTENDED_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml";
-declare const COMMENTS_IDS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsIds+xml";
-declare const COMMENTS_EXTENSIBLE_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtensible+xml";
-interface RepackOptions {
-    /** Retained for signature compatibility; `docx-container` chooses compression. */
-    compressionLevel?: number;
-    updateModifiedDate?: boolean;
-    modifiedBy?: string;
-}
-/** Repack a public Document through the live Rust S13 writer. */
-declare function repackDocx(doc: Document, options?: RepackOptions): Promise<ArrayBuffer>;
-declare function repackDocxFromRaw(doc: Document, rawContent: RawDocxContent, options?: RepackOptions): Promise<ArrayBuffer>;
-declare function updateDocumentXml(originalBuffer: ArrayBuffer, newDocumentXml: string, options?: RepackOptions): Promise<ArrayBuffer>;
-declare function updateXmlFile(originalBuffer: ArrayBuffer, path: string, content: string, options?: RepackOptions): Promise<ArrayBuffer>;
-declare function updateMultipleFiles(originalBuffer: ArrayBuffer, updates: Map<string, string | ArrayBuffer>, options?: RepackOptions): Promise<ArrayBuffer>;
-declare function applyUpdatesToZip(pkg: PartsMap, updates: Map<string, string | ArrayBuffer>, _options?: RepackOptions): Promise<ArrayBuffer>;
-declare function addRelationship(originalBuffer: ArrayBuffer, relationship: {
-    type: string;
-    target: string;
-    targetMode?: 'External' | 'Internal';
-}): Promise<{
-    buffer: ArrayBuffer;
-    rId: string;
-}>;
-declare function addMedia(originalBuffer: ArrayBuffer, filename: string, data: ArrayBuffer, mimeType: string): Promise<{
-    buffer: ArrayBuffer;
-    rId: string;
-    path: string;
-}>;
-declare function updateCoreProperties(corePropsXml: string, options: {
-    updateModifiedDate?: boolean;
-    modifiedBy?: string;
-}): string;
-declare function validateDocx(buffer: ArrayBuffer): Promise<{
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-}>;
-declare function isDocxBuffer(buffer: ArrayBuffer): boolean;
-declare function createDocx(doc: Document): Promise<ArrayBuffer>;
-/** Compatibility helper for callers that update header/footer parts directly. */
-declare function collectHeaderFooterUpdates(doc: Document): Map<string, string>;
-
-export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENSIBLE_CONTENT_TYPE, COMMENTS_IDS_CONTENT_TYPE, type PartsMap, type RepackOptions, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, createDocx, createEmptyDocx, repackDocx as default, findMaxRId, isDocxBuffer, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx };

package/dist/docx/rezip.mjs

@@ -1 +0,0 @@
-export{d as COMMENTS_CONTENT_TYPE,e as COMMENTS_EXTENDED_CONTENT_TYPE,g as COMMENTS_EXTENSIBLE_CONTENT_TYPE,f as COMMENTS_IDS_CONTENT_TYPE,o as addMedia,n as addRelationship,m as applyUpdatesToZip,t as collectHeaderFooterUpdates,s as createDocx,c as createEmptyDocx,u as default,a as findMaxRId,r as isDocxBuffer,h as repackDocx,i as repackDocxFromRaw,p as updateCoreProperties,j as updateDocumentXml,l as updateMultipleFiles,k as updateXmlFile,q as validateDocx}from'../chunk-KVKLLTDP.mjs';import'../chunk-BIQWVK5P.mjs';import'../chunk-H3JCIGWK.mjs';import'../chunk-N5Q3YN64.mjs';import'../chunk-SINEY6ZF.mjs';import'../chunk-T4EZMUXM.mjs';import'../chunk-TTRUPDAB.mjs';

package/dist/docx/serializer/index.d.mts

@@ -1,42 +0,0 @@
-import { Document } from '../../types/document.mjs';
-import { c as DocumentBody, S as SectionProperties, B as BlockContent, C as Comment, E as Endnote, F as Footnote, m as HeaderFooter, P as Paragraph, R as Run, T as Table } from '../../content-sSHuWw49.mjs';
-import '../../formatting-DoL7KBSL.mjs';
-import '../../styles-VxNcXLdi.mjs';
-import '../../settingsParser-CcGvtmCK.mjs';
-import '../wrapTypes.mjs';
-
-/**
- * DOCX XML serializers.
- *
- * The public synchronous serializer surface is retained for compatibility, but
- * all OOXML emission is owned by the Rust writer. The fixed context only
- * supplies deterministic IDs to standalone XML calls; package saves use the
- * source-package hash and clock through {@link ../rustSaveFacade}.
- * @packageDocumentation
- * @public
- */
-
-/** Serialize a single block content item. */
-declare function serializeBlockContent(block: BlockContent): string;
-/** Serialize a complete `word/document.xml` part. */
-declare function serializeDocument(doc: Document): string;
-/** Serialize the contents of `w:body`, without the body tags. */
-declare function serializeDocumentBody(body: DocumentBody): string;
-/** Serialize section properties. */
-declare function serializeSectionProperties(props: SectionProperties | undefined): string;
-/** Serialize one paragraph. */
-declare function serializeParagraph(paragraph: Paragraph): string;
-/** Serialize one run. */
-declare function serializeRun(run: Run): string;
-/** Serialize one table. */
-declare function serializeTable(table: Table): string;
-/** Serialize a header or footer part. */
-declare function serializeHeaderFooter(hf: HeaderFooter): string;
-/** Serialize the comments part. */
-declare function serializeComments(comments: Comment[]): string;
-/** Serialize the footnotes part. */
-declare function serializeFootnotes(footnotes: Footnote[]): string;
-/** Serialize the endnotes part. */
-declare function serializeEndnotes(endnotes: Endnote[]): string;
-
-export { serializeBlockContent, serializeComments, serializeDocument, serializeDocumentBody, serializeEndnotes, serializeFootnotes, serializeHeaderFooter, serializeParagraph, serializeRun, serializeSectionProperties, serializeTable };

package/dist/docx/serializer/index.mjs

@@ -1 +0,0 @@
-export{a as serializeBlockContent,i as serializeComments,b as serializeDocument,c as serializeDocumentBody,k as serializeEndnotes,j as serializeFootnotes,h as serializeHeaderFooter,e as serializeParagraph,f as serializeRun,d as serializeSectionProperties,g as serializeTable}from'../../chunk-N5Q3YN64.mjs';import'../../chunk-SINEY6ZF.mjs';import'../../chunk-T4EZMUXM.mjs';import'../../chunk-TTRUPDAB.mjs';

package/dist/editorTree-DO5PyDK8.d.mts

@@ -1,37 +0,0 @@
-/**
- * Structural mark contract consumed by the legacy tree-to-layout adapter.
- * @public
- */
-interface EditorTreeMark {
-    readonly type: {
-        readonly name: string;
-    };
-    readonly attrs: Record<string, any>;
-}
-/**
- * Structural node contract consumed by renderer-side tree walkers.
- *
- * The contract deliberately describes only the immutable tree operations the
- * renderer needs, so core does not depend on any editor implementation.
- * @public
- */
-interface EditorTreeNode {
-    readonly type: {
-        readonly name: string;
-        create(...args: any[]): EditorTreeNode;
-    };
-    readonly attrs: Record<string, any>;
-    readonly marks: readonly EditorTreeMark[];
-    readonly nodeSize: number;
-    readonly content: {
-        readonly size: number;
-    };
-    readonly isText: boolean;
-    readonly isTextblock: boolean;
-    readonly isInline: boolean;
-    readonly text?: string | null;
-    forEach(callback: (node: EditorTreeNode, offset: number, index: number) => void): void;
-    descendants(callback: (node: EditorTreeNode, pos: number) => boolean | void): void;
-}
-
-export type { EditorTreeNode as E };

package/dist/executor-7O2RBJ2B.mjs

@@ -1 +0,0 @@
-export{a as executeCommand,b as executeCommands}from'./chunk-6PW4CWUG.mjs';import'./chunk-KXNZFTTK.mjs';import'./chunk-VBOTMRXV.mjs';import'./chunk-3UBMCDME.mjs';import'./chunk-TTRUPDAB.mjs';

package/dist/headerFooterLayout-0zPT64Qc.d.mts

@@ -1,316 +0,0 @@
-import { e as LayoutBlock, B as BlockExtent, f as BlockId, L as LayoutOptions, a as Layout, F as FootnoteContent, g as Page, h as FootnoteRenderItem, P as PageMargins, H as HeaderFooterContent, I as ImageRun } from './types-DNrYr6yQ.mjs';
-import { a as Theme } from './formatting-DoL7KBSL.mjs';
-import { ax as NoteKind, F as Footnote, E as Endnote, m as HeaderFooter } from './content-sSHuWw49.mjs';
-import { a as StyleDefinitions } from './styles-VxNcXLdi.mjs';
-import { M as MeasuredBlock } from './measuredBlock-DZwz8zhD.mjs';
-import { Document } from './types/document.mjs';
-import { a as DisplayListQueries, D as DisplayListRect } from './displayListQueries-p-ijSzdh.mjs';
-
-/**
- * Footnote Layout Utilities
- *
- * Footnote/endnote rendering pipeline plus page-mapping helpers:
- * - scanning FlowBlocks for footnote references and their PM positions
- * - mapping references to the page that ends up containing them
- * - converting a Footnote → FootnoteContent via the body pipeline
- *   (footnoteToProseDoc → toLayoutBlocks → caller-supplied measureBlocks)
- * - reserving per-page footnote area heights for layout
- *
- * Everything that's pure OOXML / LayoutBlock semantics lives here so the
- * React, Vue, and any future adapters can share the conversion logic
- * and just supply their own measurement function (which depends on
- * platform-specific Canvas/font metrics).
- */
-
-/** Separator line height + vertical padding in pixels. */
-declare const FOOTNOTE_SEPARATOR_HEIGHT = 12;
-/**
- * Gutter between footnote columns when `w15:footnoteColumns` > 1, in pixels
- * (≈ 0.25in). Shared by the reserved-height/measurement path (core) and the
- * footnote painter so a footnote measured at column width paints into a column
- * of exactly that width. Single-column footnotes never consult it.
- */
-declare const FOOTNOTE_COLUMN_GAP_PX = 24;
-/**
- * Hard cap on the multi-pass footnote layout loop. Reserving footnote
- * space can move a reference to another page, so adapters keep remapping
- * until the page→height contract is stable. Dense layouts converge in
- * 2–3 passes in practice; 6 is a safe ceiling.
- */
-declare const MAX_FOOTNOTE_LAYOUT_PASSES = 6;
-/**
- * Compare two per-page footnote reservation maps. Used by the React +
- * Vue adapters to detect when the multi-pass loop has converged.
- */
-declare function footnoteReservedHeightsEqual(a: Map<number, number>, b: Map<number, number>): boolean;
-/**
- * Where a footnote reference lives, as found by {@link collectFootnoteRefs}.
- *
- * `pmPos` alone is enough to attribute a reference to a page for ordinary
- * (paragraph) content, whose fragments carry a per-page pm sub-range. A table
- * is different: it splits across pages by ROW, but every `TableFragment` keeps
- * the whole table's `pmStart`/`pmEnd` (those drive selection mapping and must
- * not be narrowed). So for a reference authored inside a table cell we also
- * record the OUTERMOST table's id and the index of the row that contains it,
- * letting {@link mapFootnotesToPages} attribute the reference to the page that
- * actually laid out that row.
- */
-type FootnoteRefLocation = {
-    footnoteId: number;
-    pmPos: number;
-    /** Undefined preserves the legacy footnote-only shape. */
-    noteKind?: NoteKind;
-    /** Id of the outermost enclosing table block, when the ref is in a table cell. */
-    tableBlockId?: BlockId;
-    /** Index (into the outermost table's `rows`) of the row holding the ref. */
-    rowIndex?: number;
-};
-/**
- * Scan FlowBlocks for runs with footnoteRefId set.
- * Returns a list of {@link FootnoteRefLocation} in document order.
- *
- * Recurses into container blocks (table cells, text boxes) so footnote
- * references authored anywhere in the body reach the page-reservation
- * pass. Without this, a `footnoteRefId` nested inside a table cell never
- * gets mapped to a page and the per-page `.layout-footnote-area` silently
- * drops that entry even though the body still renders the in-line ref
- * marker.
- *
- * For refs inside a table, the OUTERMOST table's id and row index are
- * recorded (a nested table keeps the outer context, since the outer row is
- * what the paginator splits into per-page fragments).
- */
-declare function collectFootnoteRefs(blocks: LayoutBlock[]): FootnoteRefLocation[];
-/**
- * After layout, determine which footnotes appear on which pages.
- * Checks each page's fragments to see if any footnoteRef PM positions fall within.
- *
- * Returns Map<pageNumber, footnoteId[]> in document order.
- */
-declare function mapFootnotesToPages(pages: Page[], footnoteRefs: FootnoteRefLocation[]): Map<number, number[]>;
-/**
- * Footnote-specific block normalization. Mirrors the spirit of
- * `normalizeHeaderFooterMeasureBlocks`: post-process the body-pipeline
- * output for a single footnote so it carries the correct visual prefix
- * (its display number, rendered as a superscript) and a default 8pt font
- * for any run that didn't specify a size.
- *
- * The displayNumber is prepended onto the FIRST paragraph as a fresh
- * superscript text run — visually matches Word's footnote numbering
- * without disturbing the authored runs.
- *
- * Exported for callers that want to compose their own conversion
- * pipeline; `convertFootnoteToContent` calls it as part of its flow.
- */
-declare function applyFootnotePresentation(blocks: LayoutBlock[], displayNumber: number, displayLabel?: string): LayoutBlock[];
-/**
- * Adapter-supplied block measurement function. The caller (React /
- * Vue / etc.) supplies its platform's measure routine — at minimum
- * paragraph + table + image + textBox — so this core helper stays
- * Canvas-free.
- */
-type MeasureBlocksFn = (blocks: LayoutBlock[], contentWidth: number) => BlockExtent[];
-/**
- * Options for {@link convertFootnoteToContent}.
- */
-type ConvertFootnoteOptions = {
-    /** The document's parsed style definitions, threaded into the body pipeline. */
-    styles?: StyleDefinitions | null;
-    /** Theme for resolving themed fills / fonts inside the footnote. */
-    theme?: Theme | null;
-    /** Authoritative yrs story source. */
-    yrsStoryBlocks?: (storyId: string) => LayoutBlock[] | null;
-    /** BlockExtent callback supplied by the rendering adapter. */
-    measureBlocks: MeasureBlocksFn;
-    /**
-     * Doc-level `w:defaultTabStop` (twips) from the body so list markers
-     * inside footnotes honor the same tab grid.
-     */
-    defaultTabStopTwips?: number | null;
-};
-/**
- * Convert a Footnote to renderable FootnoteContent via the body pipeline:
- * `footnoteToProseDoc → toLayoutBlocks → applyFootnotePresentation →
- * measureBlocks`. Pre-PR (#378) this lived in a hand-rolled shadow stack
- * that silently dropped non-paragraph content; routing through the body
- * pipeline gives footnotes full block-kind support — paragraph + table
- * + image + textBox + fields.
- */
-declare function convertFootnoteToContent(footnote: Footnote | Endnote, displayNumber: number, contentWidth: number, options: ConvertFootnoteOptions, presentation?: {
-    noteKind?: NoteKind;
-    displayLabel?: string;
-    anchor?: FootnoteContent['anchor'];
-}): FootnoteContent;
-/**
- * Build footnote content for all footnotes referenced in the document.
- * Display numbers are assigned by first-appearance order (the same way
- * Word renders them).
- */
-declare function buildFootnoteContentMap(footnotes: Footnote[], footnoteRefs: Array<{
-    footnoteId: number;
-}>, contentWidth: number | ((ref: {
-    footnoteId: number;
-}) => number), options: ConvertFootnoteOptions): Map<number, FootnoteContent>;
-/**
- * Distribute footnote items across `columns` balanced columns, preserving
- * document order (footnotes must still read in numeric sequence). Items fill
- * the first column until it reaches the balanced target height (≈ total / N),
- * then spill into the next column — the same order-preserving balance Word
- * applies to its footnote columns, not a greedy shortest-column packing
- * (which would scramble the reading order).
- *
- * `columns <= 1` (the default for ordinary single-column footnotes) returns a
- * single column unchanged, so callers that never opt into multi-column
- * footnotes are byte-for-byte unaffected.
- *
- * Pure and shared by the reserved-height calculation (core) and the
- * display-list footnote emission so the reserved area and the rendered
- * columns are computed from the same partition.
- */
-declare function distributeFootnotesIntoColumns<T extends {
-    height: number;
-}>(items: T[], columns: number): T[][];
-/**
- * Calculate per-page footnote reserved heights.
- * Returns Map<pageNumber, reservedHeight>.
- *
- * With `columns > 1` the footnotes are balanced across that many columns and
- * the reserved height is the tallest column (plus the separator), since the
- * columns sit side by side — not the sum of every footnote height.
- */
-declare function calculateFootnoteReservedHeights(pageFootnoteMap: Map<number, number[]>, footnoteContentMap: Map<number, {
-    height: number;
-    noteKind?: NoteKind;
-}>, columns?: number | Map<number, number>): Map<number, number>;
-interface StabilizeFootnoteLayoutArgs {
-    blocks: LayoutBlock[];
-    measures: BlockExtent[];
-    layoutOpts: LayoutOptions;
-    /**
-     * The pagination kernel each stabilization iteration re-enters — the
-     * caller binds this to the mandatory Rust pagination source
-     * (`LayoutPaginationSource.paginate`). Throws on engine failure; the
-     * pipeline surfaces the error.
-     */
-    paginate: (measured: MeasuredBlock[], options: LayoutOptions) => Layout;
-    footnoteRefs: FootnoteRefLocation[];
-    footnoteContentMap: Map<number, FootnoteContent>;
-    /** First-pass layout already computed by the caller without reserved heights. */
-    initialLayout: Layout;
-    /**
-     * Number of columns the footnote area is laid out in (`w15:footnoteColumns`).
-     * Defaults to 1. When > 1, reserved heights are balanced across the columns
-     * (tallest column wins) instead of summing every footnote, and the value is
-     * written onto each footnote-bearing page as `page.footnoteColumns`.
-     */
-    footnoteColumns?: number | Map<number, number>;
-    /** Placement-aware mapper; defaults to legacy reference-page mapping. */
-    mapReferencesToPages?: (pages: Page[], refs: FootnoteRefLocation[]) => Map<number, number[]>;
-}
-interface StabilizeFootnoteLayoutResult {
-    layout: Layout;
-    pageFootnoteMap: Map<number, number[]>;
-    /** True if the loop converged before hitting MAX_FOOTNOTE_LAYOUT_PASSES. */
-    converged: boolean;
-}
-/**
- * Run the multi-pass footnote layout loop. Reserving footnote space on a
- * page can move a reference to another page, which changes the reservation,
- * which can move references again. Iterate until the page→height contract
- * is the same one used by the latest layout, or `MAX_FOOTNOTE_LAYOUT_PASSES`
- * passes have run.
- *
- * Lives in core so the React + Vue adapters call the same loop and stay in
- * lockstep on convergence behaviour. Writes `page.footnoteIds` onto each
- * page in the returned layout so renderers can paint footnote areas.
- */
-declare function stabilizeFootnoteLayout(args: StabilizeFootnoteLayoutArgs): StabilizeFootnoteLayoutResult;
-/**
- * Turn the page→footnote-id map into the per-page render payload that
- * `renderPages` consumes via `footnotesByPage`. Skips non-`normal` notes
- * (separators, continuation notices), reads the display number out of the
- * content map, and pulls plain text via `getFootnoteText`.
- *
- * Lives in core (not in either adapter) so React + Vue both call the
- * same helper — same rule as the rest of this module.
- */
-declare function buildFootnoteRenderItems(pageFootnoteMap: Map<number, number[]>, footnoteContentMap: Map<number, FootnoteContent>, doc: Document | null): Map<number, FootnoteRenderItem[]>;
-
-/**
- * Header / Footer Layout Utilities
- *
- * The header/footer rendering pipeline lives here so any rendering adapter
- * (React, Vue, etc.) can share the conversion logic and just supply its
- * platform-specific {@link MeasureBlocksFn}. Mirrors the footnote pipeline
- * in `footnoteLayout.ts`.
- *
- * Pipeline:
- *   HF.content → headerFooterToProseDoc → toLayoutBlocks
- *     → measureBlocks (caller-supplied, Canvas-aware)
- *     → HeaderFooterContent (blocks, measures, height, visualTop/Bottom)
- *
- * The render side uses the normalized block list so paint and measurement stay
- * in lockstep. Visual-bounds calculation still inspects the original block
- * list because floating images can paint above/below the nominal flow box even
- * when they do not contribute to flow height.
- */
-
-type HeaderFooterMetrics = {
-    section: 'header' | 'footer';
-    pageSize: {
-        w: number;
-        h: number;
-    };
-    margins: PageMargins;
-};
-declare function normalizeHeaderFooterMeasureBlocks(blocks: LayoutBlock[]): LayoutBlock[];
-declare function resolveHeaderFooterVisualTop(run: ImageRun, paragraphY: number, flowHeight: number, metrics: HeaderFooterMetrics): number;
-/**
- * Whether a header/footer block participates in the in-flow band height that
- * pushes the body margin.
- *
- * OOXML semantics: Word grows the header/footer band — and shifts body text —
- * based only on the story's in-flow content. A floating/anchored object
- * (`wp:anchor` DrawingML or an absolutely-positioned VML shape, e.g. a
- * full-page letterhead anchored to the page in a header) is removed from the
- * text flow and positioned on the page; it does NOT grow the band or push the
- * body. So only inline-flow blocks count here. Anchored image *runs* inside a
- * paragraph are likewise out of flow, but they don't contribute to the
- * paragraph's measured line height, so paragraphs need no special handling.
- *
- * @public
- */
-declare function contributesToHeaderFooterFlowHeight(block: LayoutBlock): boolean;
-declare function calculateHeaderFooterVisualBounds(blocks: LayoutBlock[], measures: BlockExtent[], flowHeight: number, metrics: HeaderFooterMetrics): {
-    visualTop: number;
-    visualBottom: number;
-};
-type ConvertHeaderFooterOptions = {
-    styles?: StyleDefinitions | null;
-    theme?: Theme | null;
-    measureBlocks: MeasureBlocksFn;
-    /** Authoritative yrs story source. */
-    yrsStoryBlocks?: (storyId: string) => LayoutBlock[] | null;
-    /**
-     * `w:defaultTabStop` (twips) read from `state.doc.attrs.defaultTabStopTwips`
-     * on the body doc — HF content doesn't carry its own doc-level setting,
-     * so pass it through so list markers inside headers/footers honor the
-     * same tab grid as the body.
-     */
-    defaultTabStopTwips?: number | null;
-};
-/**
- * Convert HeaderFooter (document type) to HeaderFooterContent (render type).
- *
- * Routes through the same pipeline as the body: HF.content →
- * headerFooterToProseDoc → toLayoutBlocks → measureBlocks. The inline editor
- * uses the same conversion chain, so block support (paragraph, table, image,
- * textBox, fields) and the inline editor's content stay in lockstep.
- */
-declare function convertHeaderFooterToContent(headerFooter: HeaderFooter | null | undefined, contentWidth: number, metrics: HeaderFooterMetrics, options: ConvertHeaderFooterOptions, hfStoryId?: string): HeaderFooterContent | undefined;
-/** Query-backed HF caret geometry, optionally narrowed to the edited page. */
-declare function computeHfCaretRectsFromDisplayList(queries: DisplayListQueries, section: 'header' | 'footer', rId: string, pos: number, pageIndex?: number): DisplayListRect[];
-/** Query-backed HF selection geometry, optionally narrowed to the edited page. */
-declare function computeHfSelectionRectsFromDisplayList(queries: DisplayListQueries, section: 'header' | 'footer', rId: string, from: number, to: number, pageIndex?: number): DisplayListRect[];
-
-export { type ConvertFootnoteOptions as C, FOOTNOTE_COLUMN_GAP_PX as F, type HeaderFooterMetrics as H, MAX_FOOTNOTE_LAYOUT_PASSES as M, type StabilizeFootnoteLayoutArgs as S, type ConvertHeaderFooterOptions as a, FOOTNOTE_SEPARATOR_HEIGHT as b, type FootnoteRefLocation as c, type MeasureBlocksFn as d, type StabilizeFootnoteLayoutResult as e, applyFootnotePresentation as f, buildFootnoteContentMap as g, buildFootnoteRenderItems as h, calculateFootnoteReservedHeights as i, calculateHeaderFooterVisualBounds as j, collectFootnoteRefs as k, computeHfCaretRectsFromDisplayList as l, computeHfSelectionRectsFromDisplayList as m, contributesToHeaderFooterFlowHeight as n, convertFootnoteToContent as o, convertHeaderFooterToContent as p, distributeFootnotesIntoColumns as q, footnoteReservedHeightsEqual as r, mapFootnotesToPages as s, normalizeHeaderFooterMeasureBlocks as t, resolveHeaderFooterVisualTop as u, stabilizeFootnoteLayout as v };

package/dist/headless.d.mts

@@ -1,69 +0,0 @@
-export { A as AgentContextOptions, S as ContextSelectionOptions, D as DocumentAgent, E as ExtendedSelectionContext, F as FormattedTextSegment, a as FormattingSummary, I as InsertHyperlinkOptions, b as InsertImageOptions, c as InsertTableOptions, d as InsertTextOptions, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, h as buildSelectionContextFromContext, i as createAgent, j as createAgentFromDocument, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary, o as getSelectionFormattingSummary } from './selectionContext-Buc9BCU1.mjs';
-export { ContentControlBoundError, ContentControlCreateError, ContentControlFilter, ContentControlInfo, ContentControlKindError, ContentControlLocation, ContentControlLockedError, ContentControlNotFoundError, ContentControlTypeError, ContentControlValue, ContentControlValueError, CreateContentControlTarget, FindContentControlsOptions, NewContentControlProps, RepeatingSectionError, addRepeatingSectionItem, countCharacters, countWords, createContentControl, findContentControl, findContentControls, formatSdtDate, getBlockIndexForParagraph, getBodyCharacterCount, getBodyText, getBodyWordCount, getContentControlText, getFormattingAtPosition, getHyperlinkAtPosition, getHyperlinkText, getParagraphAtIndex, getParagraphText, getParagraphs, getRunText, getTableText, getTextAfter, getTextBefore, hasHyperlinks, hasImages, hasTables, isHeadingStyle, isPositionInHyperlink, isRepeatingSection, isRepeatingSectionItem, parseHeadingLevel, removeContentControl, removeRepeatingSectionItem, setContentControlContent, setContentControlValue } from './agent/index.mjs';
-export { parseDocx } from './docx/parser.mjs';
-export { serializeDocumentBody, serializeDocument as serializeDocx, serializeSectionProperties } from './docx/serializer/index.mjs';
-export { createDocx, default as repackDocx, updateMultipleFiles } from './docx/rezip.mjs';
-export { g as getDocumentWatermark, s as setDocumentWatermark } from './watermarkApi-DCxjutkg.mjs';
-export { a as attemptSelectiveSave } from './selectiveSave-oFBJ1n71.mjs';
-export { b as buildPatchedDocumentXml, v as validatePatchSafety } from './selectiveXmlPatch-ypkxlTD_.mjs';
-export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, c as colorsEqual, b as createDocumentWithText, d as createEmptyDocument, e as createRgbColor, f as createTemplateProcessor, g as createThemeColor, h as getMissingVariables, i as getTemplateTags, j as isBlack, k as isWhite, p as parseColorString, l as previewTemplate, m as processTemplate, n as processTemplateAdvanced, o as processTemplateAsBlob, q as processTemplateDetailed, r as resolveHighlightColor, s as resolveShadingColor, v as validateTemplate } from './colorResolver-n0o7H7ep.mjs';
-export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-Borj29SF.mjs';
-export { emuToTwips, formatPx, halfPointsToPixels, pixelsToTwips, pointsToHalfPoints, twipsToEmu, twipsToPixels } from './utils/units.mjs';
-export { mapHexToHighlightName } from './utils/highlightColors.mjs';
-export { C as CommandHandler, a as CommandResult, b as CorePlugin, J as JsonSchema, L as LoadedDocument, M as McpSession, c as McpToolAnnotations, d as McpToolContent, e as McpToolContext, f as McpToolDefinition, g as McpToolHandler, h as McpToolResult, b as Plugin, P as PluginCommand, C as PluginCommandHandler, i as PluginEvent, j as PluginEventListener, k as PluginOptions, l as PluginRegistrationResult, f as ToolDefinition, g as ToolHandler, h as ToolResult, Z as ZodSchemaLike, m as isZodSchema } from './types-dYdjUZMo.mjs';
-export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-DMM5VTdT.mjs';
-export { Document, DocxPackage } from './types/document.mjs';
-export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, ApplyStyleCommand, ApplyVariablesCommand, DEFAULT_AI_ACTIONS, DeleteTextCommand, FormatParagraphCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertTableCommand, InsertTextCommand, ParagraphContext, ParagraphOutline, Position, Range, ReplaceTextCommand, SectionInfo, SelectionContext, SetVariableCommand, StyleInfo, SuggestedAction, comparePositions, createCollapsedRange, createCommand, createRange, getActionDescription, getActionLabel, isPositionInRange } from './types/agentApi.mjs';
-export { B as BlockContent, C as Comment, a as CommentRangeEnd, b as CommentRangeStart, D as Deletion, c as DocumentBody, E as Endnote, F as Footnote, H as Hyperlink, I as Image, d as Insertion, L as ListLevel, M as MoveFrom, e as MoveTo, N as NumberingDefinitions, P as Paragraph, f as ParagraphContent, R as Run, g as RunContent, S as SectionProperties, T as Table, h as TableCell, i as TableRow, j as TextContent, k as TrackedChangeInfo, l as TrackedRunChange } from './content-sSHuWw49.mjs';
-export { P as ParagraphFormatting, T as TextFormatting, a as Theme, b as blendColors, d as darkenColor, g as getContrastingColor, l as lightenColor, r as resolveColor } from './formatting-DoL7KBSL.mjs';
-export { R as Relationship, S as Style, a as StyleDefinitions } from './styles-VxNcXLdi.mjs';
-export { e as emuToPixels, p as pixelsToEmu, a as pointsToPixels } from './units-O5Y02RKQ.mjs';
-import './docxInput-DTbCa48g.mjs';
-import './settingsParser-CcGvtmCK.mjs';
-import './docx/wrapTypes.mjs';
-
-/**
- * @betteroffice/docx/headless
- *
- * Headless aggregate for Node.js scripts, CLI tools, and server-side
- * processing. Same surface as the default `.` entry, named to make the
- * "no DOM" intent explicit. Prefer the smaller subpaths (`./docx`,
- * `./agent`, `./utils`, etc.) for new code — they tree-shake better.
- *
- * @example
- * ```ts
- * import { DocumentAgent, parseDocx, pluginRegistry } from '@betteroffice/docx/headless';
- * import { docxtemplaterPlugin } from '@betteroffice/docx/core-plugins';
- *
- * // Register plugins
- * pluginRegistry.register(docxtemplaterPlugin);
- *
- * // Load and manipulate document
- * const buffer = fs.readFileSync('template.docx');
- * const agent = await DocumentAgent.fromBuffer(buffer);
- *
- * // Get document info
- * console.log('Word count:', agent.getWordCount());
- * console.log('Variables:', agent.getVariables());
- *
- * // Edit document
- * const newAgent = agent
- *   .insertText({ paragraphIndex: 0, offset: 0 }, 'Hello ')
- *   .applyStyle(0, 'Heading1');
- *
- * // Apply template variables
- * const finalAgent = await newAgent.applyVariables({
- *   customer_name: 'Jane Doe',
- *   date: '2024-02-15',
- * });
- *
- * // Export
- * const output = await finalAgent.toBuffer();
- * fs.writeFileSync('output.docx', Buffer.from(output));
- * ```
- * @packageDocumentation
- * @public
- */
-declare const VERSION = "0.0.2";
-
-export { VERSION };

package/dist/headless.mjs

@@ -1 +0,0 @@
-export{b as mapHexToHighlightName}from'./chunk-YCIH2Q3E.mjs';export{b as createDocumentWithText,a as createEmptyDocument}from'./chunk-VAOUFAUH.mjs';export{j as colorsEqual,g as createRgbColor,f as createThemeColor,c as isBlack,d as isWhite,e as parseColorString,a as resolveHighlightColor,b as resolveShadingColor}from'./chunk-L5ISVQ3W.mjs';export{a as isZodSchema}from'./chunk-XYH6XWP3.mjs';export{j as createTemplateProcessor,g as getMissingVariables,e as getTemplateTags,h as previewTemplate,a as processTemplate,i as processTemplateAdvanced,c as processTemplateAsBlob,b as processTemplateDetailed,f as validateTemplate}from'./chunk-O2QSE2I7.mjs';export{a as getDocumentWatermark,b as setDocumentWatermark}from'./chunk-WAUF2UC7.mjs';export{b as buildPatchedDocumentXml,a as validatePatchSafety}from'./chunk-KEE52TT5.mjs';export{i as blendColors,g as darkenColor,f as getContrastingColor,h as lightenColor,d as resolveColor}from'./chunk-FZIA7OFY.mjs';export{a as ContentControlCreateError,e as RepeatingSectionError,f as addRepeatingSectionItem,b as createContentControl,c as isRepeatingSection,d as isRepeatingSectionItem,g as removeRepeatingSectionItem}from'./chunk-QOUFE3VX.mjs';export{C as ContentControlBoundError,F as ContentControlKindError,A as ContentControlLockedError,z as ContentControlNotFoundError,B as ContentControlTypeError,J as ContentControlValueError,g as countCharacters,f as countWords,y as findContentControl,x as findContentControls,K as formatSdtDate,v as getBlockIndexForParagraph,i as getBodyCharacterCount,e as getBodyText,h as getBodyWordCount,w as getContentControlText,l as getFormattingAtPosition,n as getHyperlinkAtPosition,c as getHyperlinkText,u as getParagraphAtIndex,a as getParagraphText,t as getParagraphs,b as getRunText,d as getTableText,k as getTextAfter,j as getTextBefore,r as hasHyperlinks,q as hasImages,s as hasTables,o as isHeadingStyle,m as isPositionInHyperlink,p as parseHeadingLevel,I as removeContentControl,H as setContentControlContent,M as setContentControlValue}from'./chunk-YBIM6UJV.mjs';export{g as DEFAULT_AI_ACTIONS,d as comparePositions,a as createCollapsedRange,h as createCommand,b as createRange,f as getActionDescription,e as getActionLabel,c as isPositionInRange}from'./chunk-Q7PO7V73.mjs';export{a as DocumentAgent,h as buildExtendedSelectionContext,g as buildSelectionContext,e as buildSelectionContextFromContext,b as createAgent,c as createAgentFromDocument,d as getAgentContext,f as getDocumentSummary,i as getSelectionFormattingSummary}from'./chunk-XQBCCJBO.mjs';export{a as detectVariables,b as detectVariablesDetailed,c as detectVariablesInBody,d as detectVariablesInParagraph,m as documentHasVariables,e as extractVariablesFromText,i as formatVariable,f as hasTemplateVariables,g as isValidVariableName,j as parseVariable,l as removeVariables,k as replaceVariables,h as sanitizeVariableName}from'./chunk-UIEJWORW.mjs';export{a as executeCommand,b as executeCommands}from'./chunk-6PW4CWUG.mjs';import'./chunk-KXNZFTTK.mjs';export{a as PluginRegistry,d as createPluginRegistrar,b as pluginRegistry,c as registerPlugins}from'./chunk-VBOTMRXV.mjs';export{a as attemptSelectiveSave}from'./chunk-OJOHXQNQ.mjs';export{s as createDocx,h as repackDocx,l as updateMultipleFiles}from'./chunk-KVKLLTDP.mjs';import'./chunk-BIQWVK5P.mjs';export{b as emuToPixels,i as emuToTwips,q as formatPx,k as halfPointsToPixels,c as pixelsToEmu,h as pixelsToTwips,m as pointsToHalfPoints,d as pointsToPixels,j as twipsToEmu,g as twipsToPixels}from'./chunk-3UBMCDME.mjs';export{a as parseDocx}from'./chunk-LDUWIM7M.mjs';import'./chunk-DXKG3HQ5.mjs';import'./chunk-FPZBTOD6.mjs';import'./chunk-H3JCIGWK.mjs';export{c as serializeDocumentBody,b as serializeDocx,d as serializeSectionProperties}from'./chunk-N5Q3YN64.mjs';import'./chunk-SINEY6ZF.mjs';import'./chunk-T4EZMUXM.mjs';import'./chunk-TTRUPDAB.mjs';var Pt="0.0.2";export{Pt as VERSION};