@zeke-02/docx-editor 0.0.34 → 0.5.1

package/dist/{clipboard-BvkuNZub.d.ts → TableToolbar-YL74HNS1.d.mts}

@@ -1,5 +1,28 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default, { CSSProperties, ReactNode } from 'react';
-import { e as Table, a0 as TableCell, b as Run, a as Paragraph } from './agentApi-mv532p8I.js';
+import { a3 as Theme, b as Run, a as Paragraph, e as Table, a0 as TableCell } from './agentApi-DLt94vXk.mjs';
+
+/**
+ * Font Picker Component (Radix UI)
+ *
+ * A dropdown selector for choosing font families using Radix Select.
+ */
+interface FontOption {
+    name: string;
+    fontFamily: string;
+    category?: 'sans-serif' | 'serif' | 'monospace' | 'other';
+}
+interface FontPickerProps {
+    value?: string;
+    onChange?: (fontFamily: string) => void;
+    fonts?: FontOption[];
+    disabled?: boolean;
+    className?: string;
+    placeholder?: string;
+    width?: number | string;
+    showPreview?: boolean;
+}
+declare function FontPicker({ value, onChange, fonts, disabled, className, placeholder, width, showPreview, }: FontPickerProps): react_jsx_runtime.JSX.Element;
 
 var _lang = "en";
 var common = {
@@ -27,6 +50,10 @@ var toolbar = {
 	file: "File",
 	format: "Format",
 	insert: "Insert",
+	open: "Open",
+	openShortcut: "Ctrl+O",
+	save: "Save",
+	saveShortcut: "Ctrl+S",
 	print: "Print",
 	printShortcut: "Ctrl+P",
 	pageSetup: "Page setup",
@@ -36,7 +63,9 @@ var toolbar = {
 	table: "Table",
 	pageBreak: "Page break",
 	tableOfContents: "Table of contents",
-	symbol: "Symbol"
+	symbol: "Symbol",
+	help: "Help",
+	reportIssue: "Report issue"
 };
 var formattingBar = {
 	groups: {
@@ -230,6 +259,15 @@ var dialogs = {
 		insertButton: "Insert Table",
 		sizeSelector: "Table size selector"
 	},
+	splitCell: {
+		title: "Split Cell",
+		description: "Set how many rows and columns to split the selected cell into.",
+		rowsLabel: "Rows:",
+		columnsLabel: "Columns:",
+		currentMinimum: "Minimum from current span: {rows} row(s) x {cols} column(s)",
+		minValue: "Use at least {rows} row(s) and {cols} column(s).",
+		notOneByOne: "Choose at least two resulting cells."
+	},
 	insertImage: {
 		title: "Insert Image",
 		uploadAriaLabel: "Click or drag to upload image",
@@ -553,6 +591,9 @@ var documentOutline = {
 var sidebar = {
 	ariaLabel: "Annotations sidebar"
 };
+var viewer = {
+	pageIndicator: "{current} of {total}"
+};
 var titleBar = {
 	untitled: "Untitled",
 	documentNameAriaLabel: "Document name",
@@ -661,13 +702,28 @@ var imageTransform = {
 	flipVertical: "Flip vertical"
 };
 var imageWrap = {
-	inline: "Inline with text",
-	floatLeft: "Float left (wrap right)",
-	floatRight: "Float right (wrap left)",
-	topAndBottom: "Top and bottom",
-	behindText: "Behind text",
-	inFrontOfText: "In front of text",
-	tooltipPrefix: "Wrap: {label}"
+	inline: "In Line with Text",
+	floatLeft: "Square Left",
+	floatRight: "Square Right",
+	topAndBottom: "Top and Bottom",
+	behindText: "Behind Text",
+	inFrontOfText: "In Front of Text",
+	tooltipPrefix: "Wrap: {label}",
+	menu: {
+		inLineWithText: "In Line with Text",
+		squareLeft: "Square Left",
+		squareRight: "Square Right",
+		behindText: "Behind Text",
+		inFrontOfText: "In Front of Text",
+		ariaLabel: "Image layout options"
+	},
+	menuDesc: {
+		inLineWithText: "Image flows in the line as a glyph",
+		squareLeft: "Image floats left, text wraps on the right",
+		squareRight: "Image floats right, text wraps on the left",
+		behindText: "Image paints behind body text",
+		inFrontOfText: "Image paints over body text"
+	}
 };
 var responsePreview = {
 	loading: "{action}...",
@@ -744,6 +800,20 @@ var unsaved = {
 var loading = {
 	label: "Loading"
 };
+var agentPanel = {
+	defaultTitle: "Assistant",
+	toggle: "Open assistant",
+	close: "Close panel",
+	resizeHandle: "Resize agent panel",
+	thinking: "Assistant is thinking",
+	composerPlaceholder: "Ask the assistant…",
+	send: "Send",
+	timeline: {
+		working: "Working… {count, plural, one {# step} other {# steps}}",
+		summary: "{count, plural, one {# step} other {# steps}}",
+		earlier: "+ {count, plural, one {# earlier step} other {# earlier steps}}"
+	}
+};
 var en = {
 	_lang: _lang,
 	common: common,
@@ -763,6 +833,7 @@ var en = {
 	contextMenu: contextMenu,
 	documentOutline: documentOutline,
 	sidebar: sidebar,
+	viewer: viewer,
 	titleBar: titleBar,
 	errors: errors,
 	table: table,
@@ -778,7 +849,8 @@ var en = {
 	ruler: ruler,
 	print: print,
 	unsaved: unsaved,
-	loading: loading
+	loading: loading,
+	agentPanel: agentPanel
 };
 
 /** Auto-derived from en.json — never manually maintained */
@@ -886,6 +958,137 @@ declare function formatPageRange(range: {
  */
 declare function isPrintSupported(): boolean;
 
+/**
+ * Clipboard utilities for copy/paste with formatting
+ *
+ * Handles:
+ * - Copy: puts formatted HTML and plain text on clipboard
+ * - Paste: reads HTML clipboard, converts to runs with formatting
+ * - Handles paste from Word (cleans up Word HTML)
+ * - Ctrl+C, Ctrl+V, Ctrl+X keyboard shortcuts
+ */
+
+/**
+ * Clipboard content format
+ */
+interface ClipboardContent {
+    /** Plain text representation */
+    plainText: string;
+    /** HTML representation */
+    html: string;
+    /** Internal format (JSON) for preserving full formatting */
+    internal?: string;
+}
+/**
+ * Parsed clipboard content
+ */
+interface ParsedClipboardContent {
+    /** Runs parsed from clipboard */
+    runs: Run[];
+    /** Whether content came from Word */
+    fromWord: boolean;
+    /** Whether content came from our editor */
+    fromEditor: boolean;
+    /** Original plain text */
+    plainText: string;
+}
+/**
+ * Options for clipboard operations
+ */
+interface ClipboardOptions {
+    /** Whether to include formatting in copy */
+    includeFormatting?: boolean;
+    /** Whether to clean Word-specific formatting */
+    cleanWordFormatting?: boolean;
+    /** Callback for handling errors */
+    onError?: (error: Error) => void;
+    /** Document theme — required to resolve themed text/shading colors in HTML. */
+    theme?: Theme | null;
+}
+/**
+ * Custom MIME type for internal clipboard format
+ */
+declare const INTERNAL_CLIPBOARD_TYPE = "application/x-docx-editor";
+/**
+ * Standard clipboard MIME types
+ */
+declare const CLIPBOARD_TYPES: {
+    readonly HTML: "text/html";
+    readonly PLAIN: "text/plain";
+};
+/**
+ * Copy runs to clipboard with formatting
+ */
+declare function copyRuns(runs: Run[], options?: ClipboardOptions): Promise<boolean>;
+/**
+ * Copy paragraphs to clipboard with formatting
+ */
+declare function copyParagraphs(paragraphs: Paragraph[], options?: ClipboardOptions): Promise<boolean>;
+/**
+ * Convert runs to clipboard content (HTML and plain text).
+ *
+ * @param theme - Optional document theme. Pass it so themed text color and
+ *   shading resolve correctly in the HTML payload (matters when pasting into
+ *   Gmail/Word/etc.). Omit for rgb-only content.
+ */
+declare function runsToClipboardContent(runs: Run[], includeFormatting?: boolean, theme?: Theme | null): ClipboardContent;
+/**
+ * Convert paragraphs to clipboard content.
+ *
+ * @param theme - See {@link runsToClipboardContent}.
+ */
+declare function paragraphsToClipboardContent(paragraphs: Paragraph[], includeFormatting?: boolean, theme?: Theme | null): ClipboardContent;
+/**
+ * Write content to clipboard
+ */
+declare function writeToClipboard(content: ClipboardContent): Promise<boolean>;
+/**
+ * Read content from clipboard
+ */
+declare function readFromClipboard(options?: ClipboardOptions): Promise<ParsedClipboardContent | null>;
+/**
+ * Handle paste event
+ */
+declare function handlePasteEvent(event: ClipboardEvent, options?: ClipboardOptions): ParsedClipboardContent | null;
+/**
+ * Parse HTML from clipboard
+ */
+declare function parseClipboardHtml(html: string, plainText: string, cleanWordFormatting?: boolean): ParsedClipboardContent;
+/**
+ * Check if HTML is from Microsoft Word
+ */
+declare function isWordHtml(html: string): boolean;
+/**
+ * Check if HTML is from our editor
+ */
+declare function isEditorHtml(html: string): boolean;
+/**
+ * Clean Microsoft Word HTML
+ */
+declare function cleanWordHtml(html: string): string;
+/**
+ * Convert HTML to runs
+ */
+declare function htmlToRuns(html: string, plainTextFallback: string): Run[];
+/**
+ * Create clipboard keyboard handlers for an editor
+ */
+declare function createClipboardHandlers(options: {
+    onCopy?: () => {
+        runs: Run[];
+    } | null;
+    onCut?: () => {
+        runs: Run[];
+    } | null;
+    onPaste?: (content: ParsedClipboardContent) => void;
+    clipboardOptions?: ClipboardOptions;
+}): {
+    handleCopy: (event: ClipboardEvent) => Promise<void>;
+    handleCut: (event: ClipboardEvent) => Promise<void>;
+    handlePaste: (event: ClipboardEvent) => void;
+    handleKeyDown: (event: KeyboardEvent) => Promise<void>;
+};
+
 /**
  * TableToolbar Component
  *
@@ -991,6 +1194,12 @@ interface TableContext {
     /** Total number of columns */
     columnCount: number;
 }
+interface TableSplitConfig {
+    minRows: number;
+    minCols: number;
+    initialRows: number;
+    initialCols: number;
+}
 /**
  * Props for TableToolbar component
  */
@@ -1030,6 +1239,8 @@ declare function getColumnCount(table: Table): number;
  * Get cell at specific row and column index
  */
 declare function getCellAt(table: Table, rowIndex: number, columnIndex: number): TableCell | null;
+declare function getTableSplitCellDialogConfig(table: Table, rowIndex: number, columnIndex: number): TableSplitConfig | null;
+declare function splitTableCell(table: Table, rowIndex: number, columnIndex: number, rows: number, cols: number): Table;
 /**
  * Add a row to a table at the specified index
  */
@@ -1051,131 +1262,12 @@ declare function deleteColumn(table: Table, columnIndex: number): Table;
  */
 declare function mergeCells(table: Table, selection: TableSelection): Table;
 /**
- * Split a merged cell
- */
-declare function splitCell(table: Table, rowIndex: number, columnIndex: number): Table;
-
-/**
- * Clipboard utilities for copy/paste with formatting
+ * Backward-compatible helper for callers that still use the older merged-cell
+ * split behavior directly.
  *
- * Handles:
- * - Copy: puts formatted HTML and plain text on clipboard
- * - Paste: reads HTML clipboard, converts to runs with formatting
- * - Handles paste from Word (cleans up Word HTML)
- * - Ctrl+C, Ctrl+V, Ctrl+X keyboard shortcuts
- */
-
-/**
- * Clipboard content format
- */
-interface ClipboardContent {
-    /** Plain text representation */
-    plainText: string;
-    /** HTML representation */
-    html: string;
-    /** Internal format (JSON) for preserving full formatting */
-    internal?: string;
-}
-/**
- * Parsed clipboard content
- */
-interface ParsedClipboardContent {
-    /** Runs parsed from clipboard */
-    runs: Run[];
-    /** Whether content came from Word */
-    fromWord: boolean;
-    /** Whether content came from our editor */
-    fromEditor: boolean;
-    /** Original plain text */
-    plainText: string;
-}
-/**
- * Options for clipboard operations
- */
-interface ClipboardOptions {
-    /** Whether to include formatting in copy */
-    includeFormatting?: boolean;
-    /** Whether to clean Word-specific formatting */
-    cleanWordFormatting?: boolean;
-    /** Callback for handling errors */
-    onError?: (error: Error) => void;
-}
-/**
- * Custom MIME type for internal clipboard format
- */
-declare const INTERNAL_CLIPBOARD_TYPE = "application/x-docx-editor";
-/**
- * Standard clipboard MIME types
- */
-declare const CLIPBOARD_TYPES: {
-    readonly HTML: "text/html";
-    readonly PLAIN: "text/plain";
-};
-/**
- * Copy runs to clipboard with formatting
- */
-declare function copyRuns(runs: Run[], options?: ClipboardOptions): Promise<boolean>;
-/**
- * Copy paragraphs to clipboard with formatting
- */
-declare function copyParagraphs(paragraphs: Paragraph[], options?: ClipboardOptions): Promise<boolean>;
-/**
- * Convert runs to clipboard content (HTML and plain text)
- */
-declare function runsToClipboardContent(runs: Run[], includeFormatting?: boolean): ClipboardContent;
-/**
- * Convert paragraphs to clipboard content
- */
-declare function paragraphsToClipboardContent(paragraphs: Paragraph[], includeFormatting?: boolean): ClipboardContent;
-/**
- * Write content to clipboard
- */
-declare function writeToClipboard(content: ClipboardContent): Promise<boolean>;
-/**
- * Read content from clipboard
- */
-declare function readFromClipboard(options?: ClipboardOptions): Promise<ParsedClipboardContent | null>;
-/**
- * Handle paste event
- */
-declare function handlePasteEvent(event: ClipboardEvent, options?: ClipboardOptions): ParsedClipboardContent | null;
-/**
- * Parse HTML from clipboard
- */
-declare function parseClipboardHtml(html: string, plainText: string, cleanWordFormatting?: boolean): ParsedClipboardContent;
-/**
- * Check if HTML is from Microsoft Word
+ * User-facing Split cell is now dialog-driven. For document-model tables, use
+ * `getTableSplitCellDialogConfig()` and `splitTableCell()` instead.
  */
-declare function isWordHtml(html: string): boolean;
-/**
- * Check if HTML is from our editor
- */
-declare function isEditorHtml(html: string): boolean;
-/**
- * Clean Microsoft Word HTML
- */
-declare function cleanWordHtml(html: string): string;
-/**
- * Convert HTML to runs
- */
-declare function htmlToRuns(html: string, plainTextFallback: string): Run[];
-/**
- * Create clipboard keyboard handlers for an editor
- */
-declare function createClipboardHandlers(options: {
-    onCopy?: () => {
-        runs: Run[];
-    } | null;
-    onCut?: () => {
-        runs: Run[];
-    } | null;
-    onPaste?: (content: ParsedClipboardContent) => void;
-    clipboardOptions?: ClipboardOptions;
-}): {
-    handleCopy: (event: ClipboardEvent) => Promise<void>;
-    handleCut: (event: ClipboardEvent) => Promise<void>;
-    handlePaste: (event: ClipboardEvent) => void;
-    handleKeyDown: (event: KeyboardEvent) => Promise<void>;
-};
+declare function splitCell(table: Table, rowIndex: number, columnIndex: number): Table;
 
-export { handlePasteEvent as A, htmlToRuns as B, CLIPBOARD_TYPES as C, isEditorHtml as D, isPrintSupported as E, isWordHtml as F, mergeCells as G, openPrintWindow as H, INTERNAL_CLIPBOARD_TYPE as I, paragraphsToClipboardContent as J, parseClipboardHtml as K, type LocaleStrings as L, parsePageRange as M, readFromClipboard as N, runsToClipboardContent as O, type ParsedClipboardContent as P, splitCell as Q, triggerPrint as R, writeToClipboard as S, type Translations as T, type TranslationKey as a, type ClipboardContent as b, type ClipboardOptions as c, type PartialLocaleStrings as d, PrintButton as e, type PrintButtonProps as f, type PrintOptions as g, PrintStyles as h, type TableAction as i, type TableContext as j, type TableSelection as k, TableToolbar as l, type TableToolbarProps as m, addColumn as n, addRow as o, cleanWordHtml as p, copyParagraphs as q, copyRuns as r, createClipboardHandlers as s, createTableContext as t, deleteColumn as u, deleteRow as v, formatPageRange as w, getCellAt as x, getColumnCount as y, getDefaultPrintOptions as z };
+export { getCellAt as A, getColumnCount as B, CLIPBOARD_TYPES as C, getDefaultPrintOptions as D, getTableSplitCellDialogConfig as E, type FontOption as F, handlePasteEvent as G, htmlToRuns as H, INTERNAL_CLIPBOARD_TYPE as I, isEditorHtml as J, isPrintSupported as K, type LocaleStrings as L, isWordHtml as M, mergeCells as N, openPrintWindow as O, type ParsedClipboardContent as P, paragraphsToClipboardContent as Q, parseClipboardHtml as R, parsePageRange as S, type Translations as T, readFromClipboard as U, runsToClipboardContent as V, splitCell as W, splitTableCell as X, triggerPrint as Y, writeToClipboard as Z, type TranslationKey as a, type ClipboardContent as b, type ClipboardOptions as c, FontPicker as d, type FontPickerProps as e, type PartialLocaleStrings as f, PrintButton as g, type PrintButtonProps as h, type PrintOptions as i, PrintStyles as j, type TableAction as k, type TableContext as l, type TableSelection as m, type TableSplitConfig as n, TableToolbar as o, type TableToolbarProps as p, addColumn as q, addRow as r, cleanWordHtml as s, copyParagraphs as t, copyRuns as u, createClipboardHandlers as v, createTableContext as w, deleteColumn as x, deleteRow as y, formatPageRange as z };

package/dist/{agentApi-mv532p8I.d.mts → agentApi-DLt94vXk.d.mts}

@@ -178,6 +178,13 @@ type ParagraphAlignment = 'left' | 'center' | 'right' | 'both' | 'distribute' |
 /**
  * Complete paragraph formatting properties (w:pPr)
  */
+/** Per-side flags identifying which `<w:spacing>` attrs were inline (not
+ *  inherited from a style chain). Used to suppress style-only spacing on
+ *  empty paragraphs per Word's behavior. */
+type SpacingExplicit = {
+    before?: boolean;
+    after?: boolean;
+};
 interface ParagraphFormatting {
     /** Paragraph alignment (w:jc) */
     alignment?: ParagraphAlignment;
@@ -195,6 +202,12 @@ interface ParagraphFormatting {
     beforeAutospacing?: boolean;
     /** Auto space after (w:spacing/@w:afterAutospacing) */
     afterAutospacing?: boolean;
+    /**
+     * Per-side flags marking which `<w:spacing>` attrs came from this
+     * paragraph's own pPr (vs inherited). Word collapses style-inherited
+     * spacing on empty paragraphs but honors the explicit values.
+     */
+    spacingExplicit?: SpacingExplicit;
     /** Left indent in twips (w:ind/@w:left) */
     indentLeft?: number;
     /** Right indent in twips (w:ind/@w:right) */
@@ -526,6 +539,20 @@ interface ListRendering {
     markerFontFamily?: string;
     /** Marker font size from numbering level rPr, in points */
     markerFontSize?: number;
+    /**
+     * NumberFormat for each level from 0..ilvl (inclusive).
+     * Used to resolve multi-level templates like "%1.%2." where each %N
+     * may need a different format (e.g., upperRoman parent + decimal child).
+     */
+    levelNumFmts?: NumberFormat[];
+    /** abstractNumId the paragraph's numId points to (counters key on this). */
+    abstractNumId?: number;
+    /**
+     * Start value from the numId's lvlOverride for the paragraph's ilvl, if any.
+     * Per ECMA-376 §17.9.18, this resets the shared abstractNum counter the
+     * first time the numId appears.
+     */
+    startOverride?: number;
 }
 /**
  * Complete numbering definitions
@@ -537,6 +564,16 @@ interface NumberingDefinitions {
     nums: NumberingInstance[];
 }
 
+/**
+ * OOXML image wrap-type taxonomy.
+ *
+ * `wp:inline` flows in the line. `wp:anchor` covers all positioned variants:
+ *   - `square` / `tight` / `through` — text wraps around the image
+ *   - `topAndBottom` — text breaks above and below
+ *   - `behind` / `inFront` (`wp:wrapNone`) — image paints out of flow
+ */
+type WrapType = 'inline' | 'square' | 'tight' | 'through' | 'topAndBottom' | 'behind' | 'inFront';
+
 /**
  * Document Content Model
  *
@@ -751,7 +788,7 @@ interface ImageSize {
  * Image wrap type for floating images
  */
 interface ImageWrap {
-    type: 'inline' | 'square' | 'tight' | 'through' | 'topAndBottom' | 'behind' | 'inFront';
+    type: WrapType;
     /** Wrap text direction */
     wrapText?: 'bothSides' | 'left' | 'right' | 'largest';
     /** Distance from text */
@@ -797,6 +834,19 @@ interface ImagePadding {
     left?: number;
     right?: number;
 }
+/**
+ * Image crop, expressed as fractions of the source image to trim from each
+ * edge. OOXML's `<a:srcRect l="10000" t="0" r="5000" b="0"/>` uses units of
+ * 1/100000 (so 10000 → 0.1 → 10% trimmed from the left). We store the
+ * normalised fraction so both the renderer and the saver can read it
+ * directly without re-parsing units.
+ */
+interface ImageCrop {
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+}
 /**
  * Embedded image (w:drawing)
  */
@@ -828,8 +878,25 @@ interface Image {
     transform?: ImageTransform;
     /** Padding around image */
     padding?: ImagePadding;
+    /** Source-image crop (fractional, OOXML `a:srcRect`). */
+    crop?: ImageCrop;
+    /** Opacity in [0, 1] (OOXML `a:alphaModFix amt`). Undefined = fully opaque. */
+    opacity?: number;
     /** Whether this is a decorative image */
     decorative?: boolean;
+    /**
+     * `wp:anchor layoutInCell` — when true (default), an anchored image inside
+     * a table cell is constrained to the cell. When false, the image escapes
+     * the cell into the page area. Round-tripped on save.
+     */
+    layoutInCell?: boolean;
+    /**
+     * `wp:anchor allowOverlap` — when true (default), anchored objects may
+     * overlap; when false, Word repositions them to avoid collisions. We
+     * don't currently reposition; we round-trip the flag so saving preserves
+     * the author's intent.
+     */
+    allowOverlap?: boolean;
     /** Hyperlink URL for clickable image */
     hlinkHref?: string;
     /** Image outline/border */
@@ -1288,6 +1355,8 @@ interface Paragraph {
     content: ParagraphContent[];
     /** Computed list rendering (if this is a list item) */
     listRendering?: ListRendering;
+    /** Word's cached layout says this paragraph started on a new rendered page. */
+    renderedPageBreakBefore?: boolean;
     /** Section properties (if this paragraph ends a section) */
     sectionProperties?: SectionProperties;
 }
@@ -1355,8 +1424,14 @@ interface Footnote {
     id: number;
     /** Special footnote type */
     noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
-    /** Content */
-    content: Paragraph[];
+    /**
+     * Content. Per ECMA-376 §17.11.10 footnotes can hold the same blocks as
+     * the body — paragraphs and tables. The parser previously only collected
+     * <w:p> children which silently dropped any <w:tbl> inside a footnote;
+     * widened to match HeaderFooter / TableCell shape so the body pipeline
+     * (toProseDoc → toFlowBlocks) can render them uniformly.
+     */
+    content: (Paragraph | Table)[];
 }
 /**
  * Endnote (w:endnote)
@@ -1367,8 +1442,11 @@ interface Endnote {
     id: number;
     /** Special endnote type */
     noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
-    /** Content */
-    content: Paragraph[];
+    /**
+     * Content. Per ECMA-376 §17.11.4 endnotes can hold the same blocks as
+     * the body — paragraphs and tables. See note on `Footnote.content`.
+     */
+    content: (Paragraph | Table)[];
 }
 /**
  * Page orientation