@betteroffice/docx 0.0.1 → 0.0.3

package/dist/layout/measure/index.d.mts

@@ -1,324 +0,0 @@
-import { M as MeasureBlockFn } from '../../measureBlocksPipeline-Df0Bbrwy.mjs';
-export { F as FloatPageGeometry, a as FloatingExclusionRect, b as FloatingImageZone, c as FloatingLineSegmentZone, d as clampFloatingWrapMargins, g as getFloatingMargins, m as measureBlocksWithFloats, r as rectsToFloatingZones } from '../../measureBlocksPipeline-Df0Bbrwy.mjs';
-import { C as CompatibilityFlags } from '../../settingsParser-CcGvtmCK.mjs';
-import { e as LayoutBlock, a1 as ParagraphBlock } from '../../types-DNrYr6yQ.mjs';
-import '../../content-sSHuWw49.mjs';
-import '../../formatting-DoL7KBSL.mjs';
-import '../../docx/wrapTypes.mjs';
-
-/**
- * Script bucket a fallback face provides glyph coverage for. Han text is
- * region-resolved by the caller (SC/TC/JP/KR — see `rustMeasureSource.ts`);
- * kana, Hangul, Arabic and Hebrew detect directly.
- *
- * @public
- */
-type FontScript = 'cjk-sc' | 'cjk-tc' | 'cjk-jp' | 'cjk-kr' | 'arabic' | 'hebrew';
-/**
- * Resolver for the bundled metric-compatible set (Carlito↔Calibri,
- * Liberation↔Arial/Times/Courier, …). Returns a lazy byte loader so the
- * (lazily fetched, same-origin) binary is only downloaded when a document
- * actually needs the face, or `undefined` when the family has no bundled
- * substitute.
- *
- * @public
- */
-interface BundledFontProvider {
-    /** Resolve a Word family to bundled metric-compatible face byte loaders, or undefined. */
-    resolve(family: string, bold: boolean, italic: boolean): (() => Promise<ArrayBuffer>) | undefined;
-    /**
-     * Optional per-script coverage fallback (Noto CJK/RTL faces). Same loader
-     * contract as {@link BundledFontProvider.resolve}; providers without
-     * script faces simply omit the method. These faces are coverage fallbacks
-     * first, metric approximations second — CJK metric compatibility is much
-     * weaker than the Carlito/Calibri class of substitutes.
-     */
-    resolveScriptFallback?(script: FontScript, bold: boolean, italic: boolean): (() => Promise<ArrayBuffer>) | undefined;
-    /**
-     * The always-available last-resort base face (broad-coverage Latin —
-     * Liberation Sans/Serif per serif-ness). Unlike {@link
-     * BundledFontProvider.resolve}, a conforming provider (e.g.
-     * `@betteroffice/docx-fonts`'s `resolveLastResortFace`) returns a loader for
-     * EVERY family, so the chain this registry builds is guaranteed non-empty
-     * and a run never routes to the browser measurer for want of font bytes. The
-     * face's metrics are the base font's, not the requested family's — the
-     * accepted divergence for a truly-unknown font, in exchange for staying on
-     * the native measurement path.
-     *
-     * Optional so mock/partial providers can omit it; when absent (or returning
-     * undefined) an unmapped family still yields an empty chain and the caller
-     * browser-falls-back that run — the pre-policy behavior. Same lazy loader
-     * contract as {@link BundledFontProvider.resolve}.
-     */
-    resolveLastResort?(family: string, bold: boolean, italic: boolean): (() => Promise<ArrayBuffer>) | undefined;
-}
-/**
- * One embedded face extracted from the open document. Structurally identical
- * to `EmbeddedFontFace` (`utils/embeddedFonts.ts`), so the output of
- * `getEmbeddedFontFaces` feeds straight in; duplicated here so this module
- * stays decoupled from the loader.
- *
- * @public
- */
-interface EmbeddedFaceInput {
-    /** Word font name the face is registered under (attacker-controlled). */
-    family: string;
-    /** `'bold'` for the embedBold/embedBoldItalic slots, else `'normal'`. */
-    weight: 'normal' | 'bold';
-    /** `'italic'` for the embedItalic/embedBoldItalic slots, else `'normal'`. */
-    style: 'normal' | 'italic';
-    /** De-obfuscated OpenType/TrueType bytes. */
-    data: ArrayBuffer;
-    /** Whether the source face was subsetted (`w:subsetted`). */
-    subsetted: boolean;
-}
-
-/**
- * The Rust measurement source — the SOLE text/layout measurement path. Every
- * block kind is measured here: paragraphs through the wasm `docx-text` engine
- * (Word metrics), tables/text boxes/shapes by pure recursion through the same
- * measurer, and image/chart/break extents synthesized from declared
- * dimensions. There is no browser `measureText` anywhere in layout.
- *
- * Division of labor:
- *  - {@link TextMeasureFontRegistry} (owned here) turns Word font requests
- *    into ordered engine font-id chains from embedded + bundled bytes, and
- *    resolves the shared per-script coverage fallbacks (CJK/RTL Noto faces).
- *    Resolution is deterministic: embedded faces → bundled metric-compatible
- *    face → always-available last-resort base face; never OS/local fonts.
- *  - {@link RustMeasureSource.prepareFonts} is the ONLY async step: it warms
- *    the registry for every (family, bold, italic) combo a block list uses,
- *    plus the script fallbacks for every script detected in the blocks'
- *    text — and for every request an earlier measure pass found unresolved
- *    (header/footer and footnote paragraphs reach measurement without
- *    passing through the adapters' block notifications; recording their
- *    misses here closes that gap). Call sites re-layout after it resolves.
- *  - {@link RustMeasureSource.createMeasureBlock} builds the sync
- *    `MeasureBlockFn` the float pipeline consumes. Paragraph blocks whose
- *    font chains are cached go to the engine — float-zoned blocks included,
- *    with the zones and cumulative Y passed through in the envelope.
- *
- * READINESS GATE (how measurement never races an unloaded face): a paragraph
- * whose font chain (or script fallback) has not settled yet measures as a
- * deterministic SYNTHETIC extent and records the miss;
- * {@link RustMeasureSource.hasPendingFonts} then reports true, the adapter
- * discards that provisional pass instead of committing it, and re-runs the
- * pipeline when `prepareFonts` settles. Once settled, `font-unready` can
- * never recur for those chains (the sync registry view is populated), so
- * committed layouts are always measured against real, loaded font bytes.
- *
- * SELF-SUFFICIENT FONTS: every family chain the registry builds terminates in
- * an always-available last-resort base face (broad-coverage Liberation
- * Sans/Serif per serif-ness, supplied by the bundled provider's
- * `resolveLastResort`), and the per-script Noto fallback is appended whenever
- * a covered script is detected. A run whose family has no embedded/bundled
- * match — or a character outside the family chain's coverage — still has real
- * font bytes to measure with; the engine substitutes the terminal face's
- * `.notdef` for genuinely uncovered characters. For a truly-unknown font the
- * measured metrics are the base font's, not the requested family's — the
- * accepted, deterministic substitution tradeoff.
- *
- * SYNTHETIC extents (deterministic pure arithmetic, no font tables, no
- * platform state) stand in for exactly two residual cases: (a) an engine
- * refusal — degenerate/attacker-crafted input tripping the security clamps,
- * or a malformed payload; (b) a chain that SETTLED EMPTY, which can only
- * happen when the host injects no bundled provider (`resolveLastResort`
- * guarantees non-empty chains otherwise) and the document embeds nothing for
- * the family. Both are counted in {@link RustMeasureStats}.
- *
- * Script fallbacks: runs are scanned for Unicode script ranges — kana → JP,
- * Hangul → KR, Arabic → arabic, Hebrew → hebrew — and Han is region-resolved:
- * kana in the same block wins (Japanese text), else the document's
- * `w:themeFontLang` eastAsia hint ({@link RustMeasureSource.setScriptHints}),
- * else Hangul in the block (hanja), else SC. The resolved script ids are
- * appended AFTER the family faces of every chain the block uses, so the
- * family face keeps supplying metrics/Latin glyphs and the script face only
- * covers what the family face cannot. RTL text measures natively (the engine
- * splits UBA level runs before shaping).
- *
- * @packageDocumentation
- * @public
- */
-
-/**
- * Font styling properties for a short-text measurement request (the
- * `measureTextWidthWithActiveRustSource` latch and tab-leader glyph
- * sizing).
- *
- * @public
- */
-interface FontStyle {
-    fontFamily?: string;
-    /** In points. */
-    fontSize?: number;
-    bold?: boolean;
-    italic?: boolean;
-    /** In pixels. */
-    letterSpacing?: number;
-}
-/**
- * Thin sync facade over the wasm measure exports (`register_measure_font`,
- * `clear_measure_fonts`, `measure_paragraph_json`). Injectable so unit tests
- * can script responses without loading wasm.
- *
- * @public
- */
-interface RustTextEngine {
-    /** Register raw sfnt bytes; returns the engine font id. Throws on bad bytes. */
-    registerFont(bytes: Uint8Array): number;
-    /** Drop every registered font (ids restart at 0). */
-    clearFonts(): void;
-    /**
-     * Measurement input JSON in, `ParagraphExtent` JSON out. Throws with a
-     * message starting `UNSUPPORTED:` for blocks the engine cannot measure.
-     */
-    measureParagraphJson(input: string): string;
-}
-/**
- * Lazily load the embedded wasm module and expose its measure surface as a
- * {@link RustTextEngine}. The dynamic `import()` keeps the ~800KB base64
- * module out of the default bundle — only callers that actually enable Rust
- * measurement pay for it (same pattern as the display-list builder's
- * `loadEngine`).
- *
- * @public
- */
-declare function getRustTextEngine(): Promise<RustTextEngine>;
-/** Counters for the debug log line (rust vs synthetic per layout pass). */
-interface RustMeasureStats {
-    /** Paragraph blocks measured by the Rust engine (including memo hits). */
-    rustMeasured: number;
-    /** Paragraphs that measured as a synthetic extent — sum of the reasons below. */
-    syntheticFallback: number;
-    /**
-     * Synthetic extents caused by a font chain (or script fallback) not having
-     * resolved yet. Transient by construction: the miss is recorded, the
-     * adapter discards the pass (`hasPendingFonts`), and the fonts-settled
-     * re-layout measures natively — so no COMMITTED layout ever contains one,
-     * and this MUST hold constant once `prepareFonts` settles.
-     */
-    syntheticFontUnready: number;
-    /**
-     * Synthetic extents caused by an engine glyph-coverage refusal. Dormant —
-     * chains terminate in a last-resort face whose `.notdef` the shaper
-     * substitutes — but kept so a coverage regression is categorized rather
-     * than lumped in with `non-font` refusals.
-     */
-    syntheticUncovered: number;
-    /**
-     * Synthetic-extent counts by `LayoutBlock.kind`. The audit counter proving
-     * text-bearing block kinds (`paragraph`, `table`, `textBox`) measure
-     * natively once fonts are ready.
-     */
-    syntheticBlockKinds: Record<string, number>;
-}
-/**
- * The selectable measurement source. Create with
- * {@link createRustMeasureSource}; see the module doc for the contract.
- *
- * @public
- */
-interface RustMeasureSource {
-    /** Feed the open document's embedded faces (invalidates the measure memo). */
-    setEmbeddedFaces(faces: EmbeddedFaceInput[]): void;
-    /**
-     * Thread the document's compat flags (`w:compat`) into every subsequent
-     * engine call. Pass `undefined` to reset to all-off defaults. The memo key
-     * includes the flags, so switching documents cannot serve stale extents.
-     */
-    setCompat(flags: CompatibilityFlags | undefined): void;
-    /**
-     * Thread document-level script hints into Han region resolution: pass the
-     * `w:themeFontLang` eastAsia tag (`settingsParser` → `themeFontLang`).
-     * Without a hint (or with a non-East-Asian tag) Han-only text defaults to
-     * Simplified Chinese. Invalidates the measure memo — region choice changes
-     * the fallback face and therefore the measured extents.
-     */
-    setScriptHints(hints: {
-        eastAsia?: string;
-    } | undefined): void;
-    /**
-     * Warm the font registry for every (family, bold, italic) combo — plus the
-     * per-family regulars and the per-script coverage fallbacks — that
-     * `blocks`' paragraphs use, AND for every request an earlier measure pass
-     * recorded as unresolved (header/footer and footnote paragraphs reach the
-     * measurer without appearing in the adapters' block lists). The only async
-     * step; per-face failures are tolerated (the chain settles without that
-     * face). Resolves `true` when at least one previously-unsettled chain or
-     * script fallback settled — even settled-empty — i.e. a re-layout would
-     * measure differently (or the deferred pass can now proceed).
-     */
-    prepareFonts(blocks: LayoutBlock[]): Promise<boolean>;
-    /**
-     * True while a font chain (or script fallback) some measured paragraph
-     * needed is still unresolved. The adapter's readiness gate: a pass measured
-     * with pending fonts is provisional (those paragraphs carry synthetic
-     * extents) and must be discarded, not committed; `prepareFonts` settles the
-     * pending set and the fonts-ready re-layout measures natively. Self-clears
-     * once every recorded request has settled.
-     */
-    hasPendingFonts(): boolean;
-    /**
-     * The sync measure function for the float pipeline — the sole measurement
-     * path, exhaustive over every `LayoutBlock` kind. Paragraph blocks whose
-     * chains (and detected script fallbacks) are cached go to the engine —
-     * float-zoned blocks pass their zones and cumulative Y through in the
-     * envelope (measured fresh, never memoized). Tables, text boxes and shapes
-     * recurse through the same measurer; images/charts/breaks synthesize
-     * extents from declared dimensions. Unresolved chains and engine refusals
-     * produce deterministic synthetic extents (see the module doc).
-     */
-    createMeasureBlock(): MeasureBlockFn;
-    /**
-     * The merged, doc-wide font-id chain map for `blocks` — every
-     * `"<family lowercase>|<bold 0|1>|<italic 0|1>"` combo the blocks' paragraphs
-     * use, mapped to its cached engine font-id chain (with the per-block script
-     * fallbacks appended after the family faces, exactly as
-     * {@link RustMeasureSource.createMeasureBlock} assembles them). Only chains that
-     * are already resolved (non-empty in the sync registry cache) are included; a
-     * combo whose chain has not settled yet is simply omitted (its runs stay on
-     * the char-distributed draw path until `prepareFonts` settles and a
-     * re-layout retries). Returns an empty object when nothing is resolved.
-     *
-     * This is the map the canvas display-list builder consumes to gate GlyphRun
-     * emission: the ids reference the same measurement `FontStore` the engine
-     * registered, so the outline provider can rasterize them.
-     */
-    getDocumentFontChains(blocks: LayoutBlock[]): Record<string, number[]>;
-    /** Drop every cached chain, registration, and memoized measure. */
-    clear(): void;
-    /** Snapshot of the rust-vs-fallback counters (never reset implicitly). */
-    getStats(): RustMeasureStats;
-}
-/**
- * Build a {@link RustMeasureSource} over a loaded engine. The source owns a
- * {@link TextMeasureFontRegistry} whose sink is `engine.registerFont`;
- * `bundled` is the optional metric-compatible font provider (injected — core
- * never imports a fonts package).
- *
- * @public
- */
-declare function createRustMeasureSource(opts: {
-    engine: RustTextEngine;
-    bundled?: BundledFontProvider;
-}): RustMeasureSource;
-
-/**
- * Stable identity hash for a paragraph block, used as the Rust measure
- * memo's key so blocks that would lay out identically share one measurement.
- * Every field that can change the rendered result contributes a labelled
- * token; the assembled token list is serialized as JSON so no separator
- * character can leak in from content.
- *
- * @packageDocumentation
- * @public
- */
-
-/**
- * Build the stable identity string for a paragraph block.
- *
- * @public
- */
-declare function hashParagraphBlock(block: ParagraphBlock): string;
-
-export { type BundledFontProvider, type EmbeddedFaceInput, type FontScript, type FontStyle, MeasureBlockFn, type RustMeasureSource, type RustMeasureStats, type RustTextEngine, createRustMeasureSource, getRustTextEngine, hashParagraphBlock };

package/dist/layout/measure/index.mjs

@@ -1 +0,0 @@
-export{h as createRustMeasureSource,e as getRustTextEngine,d as hashParagraphBlock,c as measureBlocksWithFloats}from'../../chunk-7DEIW7FL.mjs';export{g as clampFloatingWrapMargins,i as getFloatingMargins,h as rectsToFloatingZones}from'../../chunk-52GB3Y42.mjs';import'../../chunk-7PCO5I2O.mjs';import'../../chunk-X4XDO3LZ.mjs';import'../../chunk-OBQGPMPQ.mjs';import'../../chunk-3UBMCDME.mjs';import'../../chunk-TTRUPDAB.mjs';

package/dist/layout/pagination/types.d.mts

@@ -1,4 +0,0 @@
-export { A as AnchoredObjectPositionInput, B as BlockExtent, f as BlockId, j as BorderStyle, k as CellBorderSpec, l as CellBorders, m as ChartBlock, n as ChartExtent, o as ChartFragment, p as ColumnBreakBlock, q as ColumnBreakExtent, C as ColumnLayout, D as DEFAULT_TEXTBOX_MARGINS, r as DEFAULT_TEXTBOX_WIDTH, s as DocumentPosition, t as FieldRun, u as FloatingTablePosition, F as FootnoteContent, h as FootnoteRenderItem, v as Fragment, w as FragmentBase, H as HeaderFooterContent, x as HeaderFooterContentHeights, y as HeaderFooterLayout, z as HitTestResult, E as HyperlinkInfo, G as ImageBlock, J as ImageExtent, K as ImageFragment, I as ImageRun, M as ImageRunPosition, O as InlineSdtWidget, a as Layout, e as LayoutBlock, L as LayoutOptions, R as LineBreakRun, U as ListNumPr, V as NoteAreaContract, X as NoteLayoutItem, N as NoteSettingsContract, g as Page, d as PageBorderContract, Y as PageBreakBlock, Z as PageBreakExtent, i as PageGeometry, b as PageHeaderFooterRefs, P as PageMargins, c as PageNumberingContract, a0 as ParagraphAttrs, a1 as ParagraphBlock, a2 as ParagraphBorders, a3 as ParagraphExtent, a4 as ParagraphFragment, a5 as ParagraphIndent, a6 as ParagraphSpacing, a7 as ResolvedLine, a8 as ResolvedSegment, a9 as Run, aa as RunFontSlots, ab as RunFormatting, ac as RunLanguageSlots, ad as SdtGroup, S as SectionBreakBlock, ae as SectionBreakExtent, af as ShapeBlock, ag as ShapeBlockFill, ah as ShapeBlockStroke, ai as ShapeBlockTransform, aj as ShapeExtent, ak as ShapeFragment, al as TabAlignment, am as TabRun, an as TabStop, ao as TableBlock, ap as TableCell, aq as TableCellExtent, ar as TableExtent, as as TableFragment, at as TableRow, au as TableRowExtent, T as TextBoxBlock, av as TextBoxExtent, aw as TextBoxFragment, ax as TextRun, ay as TypesetBidiSlice, az as TypesetClusterAdvance, aA as TypesetRow, aB as TypesetRowSegment, aC as TypesetRunAdvance, W as WrapTextDirection, aD as assertExhaustiveLayoutBlock, aE as isTextWrappingFloatingImageRun, aF as pageGeometryFromPage, aG as resolveAnchoredObjectVerticalTop } from '../../types-DNrYr6yQ.mjs';
-import '../../content-sSHuWw49.mjs';
-import '../../formatting-DoL7KBSL.mjs';
-import '../../docx/wrapTypes.mjs';

package/dist/layout/pagination/types.mjs

@@ -1 +0,0 @@
-export{a as DEFAULT_TEXTBOX_MARGINS,b as DEFAULT_TEXTBOX_WIDTH,c as assertExhaustiveLayoutBlock,f as isTextWrappingFloatingImageRun,d as pageGeometryFromPage,e as resolveAnchoredObjectVerticalTop}from'../../chunk-X4XDO3LZ.mjs';import'../../chunk-OBQGPMPQ.mjs';import'../../chunk-3UBMCDME.mjs';import'../../chunk-TTRUPDAB.mjs';

package/dist/managers/AutoSaveManager.d.mts

@@ -1,81 +0,0 @@
-import { S as Subscribable } from '../Subscribable-DOz6Ohoo.mjs';
-import { AutoSaveSnapshot, AutoSaveManagerOptions, SavedDocumentData, AutoSaveStatus } from './types.mjs';
-import { Document } from '../types/document.mjs';
-import '../content-sSHuWw49.mjs';
-import '../formatting-DoL7KBSL.mjs';
-import '../docx/wrapTypes.mjs';
-import '../styles-VxNcXLdi.mjs';
-import '../settingsParser-CcGvtmCK.mjs';
-
-/**
- * AutoSaveManager
- *
- * Framework-agnostic class for auto-saving documents to localStorage.
- * Extracted from the React `useAutoSave` hook.
- *
- * Usage with React:
- * ```ts
- * const snapshot = useSyncExternalStore(manager.subscribe, manager.getSnapshot);
- * ```
- * @packageDocumentation
- * @public
- */
-
-declare class AutoSaveManager extends Subscribable<AutoSaveSnapshot> {
-    private storageKey;
-    private interval;
-    private maxAge;
-    private saveOnChange;
-    private debounceDelay;
-    private onSaveCallback?;
-    private onErrorCallback?;
-    private onRecoveryAvailableCallback?;
-    private storageAvailable;
-    private currentDocument;
-    private lastSavedJson;
-    private intervalTimer;
-    private debounceTimer;
-    private status;
-    private lastSaveTime;
-    private _hasRecoveryData;
-    private _isEnabled;
-    constructor(options?: AutoSaveManagerOptions);
-    /** Update the current document. Triggers debounced save if enabled. */
-    onDocumentChanged(document: Document | null): void;
-    /** Manually trigger a save. */
-    save(): Promise<boolean>;
-    /** Clear auto-saved data from storage. */
-    clear(): void;
-    /** Get recovery data from storage. */
-    getRecoveryData(): SavedDocumentData | null;
-    /** Accept recovery and return the document. */
-    acceptRecovery(): Document | null;
-    /** Dismiss recovery and clear saved data. */
-    dismissRecovery(): void;
-    /** Enable auto-save and start the interval timer. */
-    enable(): void;
-    /** Disable auto-save and stop all timers. */
-    disable(): void;
-    /** Start the interval timer. Call after enabling or on init. */
-    startInterval(): void;
-    /** Save synchronously on destroy (best-effort). */
-    destroy(): void;
-    private checkRecoveryData;
-    private persistToStorage;
-    private debounceSave;
-    private stopTimers;
-    private updateStatus;
-    private emitSnapshot;
-}
-/** Format last save time for display */
-declare function formatLastSaveTime(date: Date | null): string;
-/** Get auto-save status label */
-declare function getAutoSaveStatusLabel(status: AutoSaveStatus): string;
-/** Get storage size used by auto-save */
-declare function getAutoSaveStorageSize(storageKey?: string): number;
-/** Format storage size for display */
-declare function formatStorageSize(bytes: number): string;
-/** Check if auto-save is supported */
-declare function isAutoSaveSupported(): boolean;
-
-export { AutoSaveManager, formatLastSaveTime, formatStorageSize, getAutoSaveStatusLabel, getAutoSaveStorageSize, isAutoSaveSupported };

package/dist/managers/AutoSaveManager.mjs

@@ -1 +0,0 @@
-export{a as AutoSaveManager,b as formatLastSaveTime,e as formatStorageSize,c as getAutoSaveStatusLabel,d as getAutoSaveStorageSize,f as isAutoSaveSupported}from'../chunk-VCER63GQ.mjs';import'../chunk-BI3B33LI.mjs';import'../chunk-TTRUPDAB.mjs';

package/dist/managers/TableSelectionManager.d.mts

@@ -1,74 +0,0 @@
-import { S as Subscribable } from '../Subscribable-DOz6Ohoo.mjs';
-import { TableSelectionSnapshot, CellCoordinates } from './types.mjs';
-import { Document } from '../types/document.mjs';
-import { T as Table } from '../content-sSHuWw49.mjs';
-import '../formatting-DoL7KBSL.mjs';
-import '../styles-VxNcXLdi.mjs';
-import '../settingsParser-CcGvtmCK.mjs';
-import '../docx/wrapTypes.mjs';
-
-/**
- * TableSelectionManager
- *
- * Framework-agnostic class for managing table cell selection state.
- * Extracted from the React `useTableSelection` hook.
- *
- * Handles:
- * - Cell selection via data-attribute queries on the DOM
- * - Table document operations (add/delete rows/columns, merge/split)
- *
- * @remarks
- * Tagged `@internal` post-1.0 cut. Adapters bind to this class today,
- * but consumers should reach for `useTableSelection()` (React/Vue) instead
- * of this raw subpath. The subpath stays in `package.json` `exports` for
- * back-compat; expect it to move behind a public surface in a future major.
- *
- * @packageDocumentation
- * @internal
- */
-
-/**
- * Data attributes for table elements in the rendered DOM
- * @internal
- */
-declare const TABLE_DATA_ATTRIBUTES: {
-    readonly TABLE_INDEX: "data-table-index";
-    readonly ROW_INDEX: "data-row";
-    readonly COLUMN_INDEX: "data-col";
-    readonly TABLE_CELL: "data-table-cell";
-};
-/**
- * Find table cell coordinates from a click target by walking up the DOM
- * and reading data attributes.
- * @internal
- */
-declare function findTableFromClick(target: EventTarget | null, container?: HTMLElement | null): CellCoordinates | null;
-/**
- * Get a table from the document by index.
- * @internal
- */
-declare function getTableFromDocument(doc: Document, tableIndex: number): Table | null;
-/**
- * Update a table in the document immutably.
- * @internal
- */
-declare function updateTableInDocument(doc: Document, tableIndex: number, newTable: Table): Document;
-/**
- * Delete a table from the document immutably.
- * @internal
- */
-declare function deleteTableFromDocument(doc: Document, tableIndex: number): Document;
-/** @internal */
-declare class TableSelectionManager extends Subscribable<TableSelectionSnapshot> {
-    constructor();
-    /** Select a specific cell. */
-    selectCell(coords: CellCoordinates): void;
-    /** Clear the current selection. */
-    clearSelection(): void;
-    /** Check if a specific cell is selected. */
-    isCellSelected(tableIndex: number, rowIndex: number, columnIndex: number): boolean;
-    /** Get the currently selected cell coordinates, or null. */
-    getSelectedCell(): CellCoordinates | null;
-}
-
-export { TABLE_DATA_ATTRIBUTES, TableSelectionManager, deleteTableFromDocument, findTableFromClick, getTableFromDocument, updateTableInDocument };

package/dist/managers/TableSelectionManager.mjs

@@ -1 +0,0 @@
-export{a as TABLE_DATA_ATTRIBUTES,f as TableSelectionManager,e as deleteTableFromDocument,b as findTableFromClick,c as getTableFromDocument,d as updateTableInDocument}from'../chunk-JY6ILTNS.mjs';import'../chunk-BI3B33LI.mjs';import'../chunk-TTRUPDAB.mjs';

package/dist/managers/types.d.mts

@@ -1,113 +0,0 @@
-import { Document } from '../types/document.mjs';
-import '../content-sSHuWw49.mjs';
-import '../formatting-DoL7KBSL.mjs';
-import '../docx/wrapTypes.mjs';
-import '../styles-VxNcXLdi.mjs';
-import '../settingsParser-CcGvtmCK.mjs';
-
-/**
- * Manager Types
- *
- * Framework-agnostic interfaces for the editor's manager classes.
- * @packageDocumentation
- * @public
- */
-
-/**
- * Framework-agnostic interface for an imperatively mounted editor instance.
- *
- * Returned by `renderAsync()` implementations (React, Vue, etc.).
- * Consumers use this to interact with the editor programmatically.
- */
-interface EditorHandle {
-    /** Save the document and return the DOCX as a Blob. */
-    save(): Promise<Blob | null>;
-    /** Get the current parsed document model. */
-    getDocument(): Document | null;
-    /** Focus the editor. */
-    focus(): void;
-    /** Unmount the editor and clean up. */
-    destroy(): void;
-}
-/** Auto-save status */
-type AutoSaveStatus = 'idle' | 'saving' | 'saved' | 'error';
-/** Configuration for AutoSaveManager */
-interface AutoSaveManagerOptions {
-    /** Storage key for localStorage (default: 'docx-editor-autosave') */
-    storageKey?: string;
-    /** Save interval in milliseconds (default: 30000 - 30 seconds) */
-    interval?: number;
-    /** Maximum age of auto-save before it's considered stale (default: 24 hours) */
-    maxAge?: number;
-    /** Whether to save on document change with debounce (default: true) */
-    saveOnChange?: boolean;
-    /** Debounce delay for saveOnChange in milliseconds (default: 2000) */
-    debounceDelay?: number;
-    /** Callback when save succeeds */
-    onSave?: (timestamp: Date) => void;
-    /** Callback when save fails */
-    onError?: (error: Error) => void;
-    /** Callback when recovery data is found */
-    onRecoveryAvailable?: (savedDocument: SavedDocumentData) => void;
-}
-/** Saved document data structure */
-interface SavedDocumentData {
-    /** The document JSON */
-    document: Document;
-    /** When the document was saved */
-    savedAt: string;
-    /** Version for format compatibility */
-    version: number;
-    /** Optional document identifier */
-    documentId?: string;
-}
-/** AutoSaveManager snapshot for UI consumption */
-interface AutoSaveSnapshot {
-    status: AutoSaveStatus;
-    lastSaveTime: Date | null;
-    hasRecoveryData: boolean;
-    isEnabled: boolean;
-}
-/** Cell coordinates in a table */
-interface CellCoordinates {
-    tableIndex: number;
-    rowIndex: number;
-    columnIndex: number;
-}
-/** TableSelectionManager snapshot */
-interface TableSelectionSnapshot {
-    /** Currently selected cell, or null if no selection */
-    selectedCell: CellCoordinates | null;
-}
-/** Error severity levels */
-type ErrorSeverity = 'error' | 'warning' | 'info';
-/** Error notification */
-interface ErrorNotification {
-    id: string;
-    message: string;
-    severity: ErrorSeverity;
-    details?: string;
-    timestamp: number;
-    dismissed?: boolean;
-}
-/** ErrorManager snapshot */
-interface ErrorManagerSnapshot {
-    notifications: ErrorNotification[];
-}
-/** Plugin lifecycle configuration */
-interface PluginLifecycleConfig {
-    id: string;
-    styles?: string;
-    initialize?: (editorState: unknown) => unknown;
-    onStateChange?: (editorState: unknown) => unknown;
-    destroy?: () => void;
-}
-/** PluginLifecycleManager snapshot */
-interface PluginLifecycleSnapshot {
-    /** Map of plugin ID to plugin state */
-    states: Map<string, unknown>;
-    /** Version counter (incremented on any state change) */
-    version: number;
-}
-
-export type { AutoSaveManagerOptions, AutoSaveSnapshot, AutoSaveStatus, CellCoordinates, EditorHandle, ErrorManagerSnapshot, ErrorNotification, ErrorSeverity, PluginLifecycleConfig, PluginLifecycleSnapshot, SavedDocumentData, TableSelectionSnapshot };