ooxml-ui 0.27.2 → 0.28.0

package/dist/xlsx/grid/cell-editor.d.ts

@@ -0,0 +1,29 @@
+import { type BeginOptions, type CommitMove, type EditBridge, type EditDriver } from 'ooxml-core/xlsx/ui';
+import { type FormulaField } from './formula-field.js';
+import { type FunctionAssist } from './function-assist.js';
+import type { GridView } from './grid-view.js';
+import { PointMode } from './point-mode.js';
+export declare class CellEditor implements EditDriver {
+    #private;
+    readonly host: HTMLDivElement;
+    readonly field: FormulaField;
+    readonly assist: FunctionAssist;
+    readonly bridge: EditBridge;
+    readonly point: PointMode;
+    constructor(view: GridView, afterCommit: (move: CommitMove) => void);
+    get editing(): boolean;
+    focus(): void;
+    begin(options: BeginOptions): boolean;
+    changed(source: 'cell' | 'bar'): void;
+    /** Writes text and caret from the grid side (point mode, F4) and tells the formula bar. */
+    setText(text: string, caret: number): void;
+    setMode(mode: 'enter' | 'edit' | 'point'): void;
+    commit(move: CommitMove, allSelected: boolean): boolean;
+    cancel(): void;
+    /** Leaves edit mode without writing. */
+    end(): void;
+    /** Keeps the editor over its cell, growing right and down with its text like Excel. */
+    position(): void;
+    describe(): string;
+    destroy(): void;
+}

package/dist/xlsx/grid/cell-layer.d.ts

@@ -0,0 +1,14 @@
+import type { CellItem } from 'ooxml-core/xlsx/ui';
+export declare function itemSignature(item: CellItem, zoom: number): string;
+export declare class CellLayer {
+    #private;
+    readonly element: HTMLDivElement;
+    constructor(doc: Document);
+    get size(): number;
+    /** Paints `items`; nodes not in the list go back to the pool. */
+    render(items: readonly CellItem[], zoom: number): void;
+    nodeAt(row: number, col: number): HTMLElement | undefined;
+    clear(): void;
+}
+/** Writes a cell node from scratch (only called when its signature changed). */
+export declare function paintCell(doc: Document, node: HTMLElement, item: CellItem, zoom: number): void;

package/dist/xlsx/grid/dom.d.ts

@@ -0,0 +1,19 @@
+/** Creates an element with an optional class name and attributes. */
+export declare function h<K extends keyof HTMLElementTagNameMap>(doc: Document, tag: K, className?: string, attrs?: Record<string, string>): HTMLElementTagNameMap[K];
+/** Sets a style property only when it changed (cheap repaint of recycled nodes). */
+export declare function setStyle(node: HTMLElement, name: string, value: string): void;
+/** Sets pixel geometry in one go. */
+export declare function place(node: HTMLElement, left: number, top: number, width: number, height: number): void;
+/** Toggles a class without touching the DOM when nothing changes. */
+export declare function toggleClass(node: Element, name: string, on: boolean): void;
+/** Parses SVG markup generated by this package or the core (chart and icon painters, which escape text). */
+export declare function svgNode(doc: Document, markup: string): Element;
+/** The window a node lives in (falls back to the global one). */
+export declare const viewOf: (node: Node) => (Window & typeof globalThis) | null;
+/** requestAnimationFrame with a timer fallback (jsdom, background tabs). */
+export declare function nextFrame(node: Node, fn: () => void): () => void;
+/**
+ * Adds a `<style data-xg-style="id">` to the shadow root once. Each UI module (grid, formula bar,
+ * sheet tabs, menus) ships its own CSS this way, using the `--xve-*` theme tokens.
+ */
+export declare function ensureStyle(root: ShadowRoot | HTMLElement, id: string, css: string): void;

package/dist/xlsx/grid/drawing-keys.d.ts

@@ -0,0 +1,7 @@
+import type { EditorContext } from 'ooxml-core/xlsx/ui';
+import type { DrawingLayer } from './drawings.js';
+/**
+ * Keys while a picture or chart is selected: Delete removes it, Escape returns to the cells,
+ * arrows nudge it. Returns true when the key was handled.
+ */
+export declare function drawingKeyDown(ctx: EditorContext, layer: DrawingLayer, event: KeyboardEvent): boolean;

package/dist/xlsx/grid/drawings.d.ts

@@ -0,0 +1,12 @@
+import type { GridView } from './grid-view.js';
+export declare class DrawingLayer {
+    #private;
+    constructor(view: GridView);
+    /** Charts depend on cell values: bump after model changes so they redraw. */
+    invalidate(): void;
+    render(): void;
+    deselect(): void;
+    /** Moves the selected drawing by a few pixels (arrow keys); false when nothing is selected. */
+    nudge(dx: number, dy: number): boolean;
+    destroy(): void;
+}

package/dist/xlsx/grid/formula-field.d.ts

@@ -0,0 +1,11 @@
+import { type ColoredReference } from 'ooxml-core/xlsx';
+export interface FormulaField {
+    readonly root: HTMLElement;
+    readonly input: HTMLTextAreaElement;
+    /** Sets the text (and caret) without firing input events. */
+    setText(text: string, caret?: number): void;
+    /** Repaints the backdrop from the current input value. */
+    refresh(): ColoredReference[];
+    references(): ColoredReference[];
+}
+export declare function createFormulaField(doc: Document, className: string, label: string): FormulaField;

package/dist/xlsx/grid/function-assist.d.ts

@@ -0,0 +1,16 @@
+import { type FunctionInfo } from 'ooxml-core/xlsx';
+import type { FormulaField } from './formula-field.js';
+export interface FunctionAssist {
+    update(field: FormulaField, anchor: {
+        left: number;
+        top: number;
+    }): void;
+    /** True when the key was consumed by the popup. */
+    handleKey(event: KeyboardEvent, field: FormulaField): boolean;
+    close(): void;
+    isOpen(): boolean;
+    destroy(): void;
+}
+type Translate = (key: string, vars?: Record<string, string | number>) => string;
+export declare function createFunctionAssist(doc: Document, container: HTMLElement, t: Translate, catalog?: readonly FunctionInfo[]): FunctionAssist;
+export {};

package/dist/xlsx/grid/grid-a11y.d.ts

@@ -0,0 +1,12 @@
+import type { Selection } from 'ooxml-core/xlsx/ui';
+import type { GridView } from './grid-view.js';
+export declare function describeSelection(view: GridView, selection: Selection): string;
+export declare class GridA11y {
+    #private;
+    readonly live: HTMLDivElement;
+    constructor(view: GridView, input: HTMLTextAreaElement);
+    readonly input: HTMLTextAreaElement;
+    /** Updates the sink label and announces (debounced) after a selection change. */
+    update(selection: Selection, editing: boolean): void;
+    destroy(): void;
+}

package/dist/xlsx/grid/grid-commands.d.ts

@@ -0,0 +1,19 @@
+import { type CellRange, type Worksheet } from 'ooxml-core/xlsx';
+import type { GridClipboard } from '../clipboard.js';
+import type { Command } from 'ooxml-core/xlsx/ui';
+import type { Selection } from 'ooxml-core/xlsx/ui';
+export interface CommandHost {
+    clipboard: GridClipboard;
+    cancelEdit(): void;
+    isEditing(): boolean;
+    selectAll(): void;
+    openValidationList(): boolean;
+}
+/** Ctrl+A: the current region first, everything when the region is already selected. */
+export declare function currentRegionOrAll(sheet: Worksheet, selection: Selection): CellRange | undefined;
+/** Fill down / right: the first row (column) of each range, or the one before a single row. */
+export declare function fillPlan(range: CellRange, axis: 'down' | 'right'): {
+    source: CellRange;
+    target: CellRange;
+} | undefined;
+export declare function gridCommands(host: CommandHost): Command[];

package/dist/xlsx/grid/grid-keys.d.ts

@@ -0,0 +1,19 @@
+import type { NavigationKey } from 'ooxml-core/xlsx';
+import type { CellEditor } from './cell-editor.js';
+import type { GridSelection } from './grid-selection.js';
+import type { GridView } from './grid-view.js';
+export interface KeyHost {
+    view: GridView;
+    selection: GridSelection;
+    editor: CellEditor;
+    openCellMenu(): void;
+    openValidationList(): boolean;
+    clearMarquee(): boolean;
+    prepareCopy(cut: boolean): void;
+}
+/** The navigation key for an arrow / Home / End / Page key event, or undefined. */
+export declare function navigationKey(event: Pick<KeyboardEvent, 'key' | 'ctrlKey' | 'metaKey'>): NavigationKey | undefined;
+/** Ready mode (not editing). */
+export declare function readyKeyDown(host: KeyHost, event: KeyboardEvent): void;
+/** Edit / Enter / Point mode keys of the in-cell editor. */
+export declare function editorKeyDown(host: KeyHost, event: KeyboardEvent): void;

package/dist/xlsx/grid/grid-menus.d.ts

@@ -0,0 +1,8 @@
+import type { GridView } from './grid-view.js';
+export type MenuKind = 'cell' | 'row' | 'col';
+/** Which menu the current selection calls for (whole rows / columns get the header menus). */
+export declare function menuKindFor(view: GridView): MenuKind;
+export declare function openGridMenu(view: GridView, kind: MenuKind, x: number, y: number, refocus: () => void): void;
+/** Opens the menu for the active cell's position (keyboard). */
+export declare function openMenuAtActive(view: GridView, refocus: () => void): void;
+export declare function wireMenus(view: GridView, refocus: () => void): () => void;

package/dist/xlsx/grid/grid-pointer.d.ts

@@ -0,0 +1,16 @@
+import { type CellAddress, type CellRange } from 'ooxml-core/xlsx';
+import type { CellEditor } from './cell-editor.js';
+import type { GridSelection } from './grid-selection.js';
+import type { GridView } from './grid-view.js';
+import { spanRange } from 'ooxml-core/xlsx/ui';
+export interface PointerHost {
+    view: GridView;
+    selection: GridSelection;
+    editor: CellEditor;
+    followLink(row: number, col: number): boolean;
+    fill(source: CellRange, target: CellRange): void;
+}
+/** The range a fill-handle drag to `at` produces (extends the source along one axis). */
+export declare function fillTarget(source: CellRange, at: CellAddress): CellRange | undefined;
+export declare function wirePointer(host: PointerHost): () => void;
+export { spanRange };

package/dist/xlsx/grid/grid-selection.d.ts

@@ -0,0 +1,22 @@
+import { type CellAddress, type NavigationKey } from 'ooxml-core/xlsx';
+import type { Selection } from 'ooxml-core/xlsx/ui';
+import type { GridView } from './grid-view.js';
+export declare class GridSelection {
+    #private;
+    constructor(view: GridView);
+    get(): Selection;
+    /** Replaces the selection; `reveal` scrolls a cell into view. */
+    set(next: Selection, reveal?: CellAddress): void;
+    /** Visible rows per page in the scrolling pane (PageUp/PageDown). */
+    pageRows(): number;
+    cellAt(at: CellAddress): void;
+    /** Arrow-like movement; with `extend` the moving corner moves and the active cell stays. */
+    move(key: NavigationKey, extend: boolean): void;
+    /** Enter / Tab: walk the selection when it has several cells, else move one cell. */
+    advance(direction: 'down' | 'up' | 'right' | 'left'): void;
+    rows(r1: number, r2: number, add?: boolean): void;
+    cols(c1: number, c2: number, add?: boolean): void;
+    all(): void;
+    firstVisibleRow(): number;
+    firstVisibleCol(): number;
+}

package/dist/xlsx/grid/grid-view.d.ts

@@ -0,0 +1,75 @@
+import { type CellRange, type CellView, type GridMetrics, type Workbook, type Worksheet } from 'ooxml-core/xlsx';
+import type { EditorContext } from 'ooxml-core/xlsx/ui';
+import { CellLayer } from './cell-layer.js';
+import { GridGeometry, type Hit, type Quadrant } from 'ooxml-core/xlsx/ui';
+import { GridlineLayer } from './gridlines.js';
+import { type HeaderPane } from './pane-chrome.js';
+import { type TextMeasurer } from './measure.js';
+import { SelectionLayer, type OverlayState } from './selection-layer.js';
+interface QuadrantNodes {
+    box: HTMLDivElement;
+    plane: HTMLDivElement;
+    cells: CellLayer;
+    lines: GridlineLayer;
+    overlay: SelectionLayer;
+    drawings: HTMLDivElement;
+}
+export type PaintHook = (view: GridView) => void;
+export declare class GridView {
+    #private;
+    readonly ctx: EditorContext;
+    readonly doc: Document;
+    readonly root: HTMLDivElement;
+    readonly scroller: HTMLDivElement;
+    readonly space: HTMLDivElement;
+    readonly view: HTMLDivElement;
+    readonly corner: HTMLDivElement;
+    readonly quads: Record<Quadrant, QuadrantNodes>;
+    readonly colHeaders: {
+        frozen: HeaderPane;
+        scroll: HeaderPane;
+    };
+    readonly rowHeaders: {
+        frozen: HeaderPane;
+        scroll: HeaderPane;
+    };
+    readonly measurer: TextMeasurer;
+    readonly overlay: Pick<OverlayState, 'copyRange' | 'references' | 'fillPreview'>;
+    readonly hooks: Set<PaintHook>;
+    metrics: GridMetrics;
+    geometry: GridGeometry;
+    extentRow: number;
+    extentCol: number;
+    constructor(ctx: EditorContext, container: HTMLElement);
+    workbook(): Workbook | undefined;
+    sheetIndex(): number;
+    sheet(): Worksheet | undefined;
+    zoom(): number;
+    setZoom(percent: number): void;
+    /** Recreates metrics (structure, sizes, zoom or sheet changed) and repaints. */
+    rebuild(): void;
+    /** Drops cached cell views (after any model change) and schedules a repaint. */
+    invalidate(): void;
+    clearViews(): void;
+    /** Grows the scroll extent so `row`/`col` (and some margin) are reachable. */
+    ensureExtent(row: number, col: number): void;
+    headerSizes(): {
+        w: number;
+        h: number;
+    };
+    schedule(): void;
+    /** The cached core view of a cell; null when it paints nothing. */
+    cellViewAt(row: number, col: number): CellView | null;
+    /** The active cell's range, merge-expanded. */
+    activeRange(): CellRange;
+    clientToView(clientX: number, clientY: number): {
+        x: number;
+        y: number;
+    };
+    hitClient(clientX: number, clientY: number): Hit;
+    /** Scrolls so a cell is fully visible in the scrolling pane. */
+    reveal(row: number, col: number): void;
+    paint(): void;
+    destroy(): void;
+}
+export {};

package/dist/xlsx/grid/gridlines.d.ts

@@ -0,0 +1,7 @@
+import type { GridMetrics } from 'ooxml-core/xlsx';
+export declare class GridlineLayer {
+    #private;
+    readonly element: HTMLDivElement;
+    constructor(doc: Document);
+    render(metrics: GridMetrics, rows: readonly number[], cols: readonly number[], visible: boolean): void;
+}

package/dist/xlsx/grid/header-resize.d.ts

@@ -0,0 +1,8 @@
+import type { GridView } from './grid-view.js';
+/** The indices a resize applies to: every fully selected row/column when `index` is one of them. */
+export declare function resizeTargets(view: GridView, axis: 'row' | 'col', index: number): number[];
+/** Pixels at the current zoom to a file size (characters for columns, points for rows). */
+export declare function toFileSize(view: GridView, axis: 'row' | 'col', px: number): number;
+export declare function startHeaderResize(view: GridView, axis: 'row' | 'col', index: number, event: PointerEvent): void;
+/** Double-click on a header border: fit the column(s) to their content, or the row(s) height. */
+export declare function autoFit(view: GridView, axis: 'row' | 'col', index: number): void;

package/dist/xlsx/grid/headers.d.ts

@@ -0,0 +1,9 @@
+import { type GridMetrics } from 'ooxml-core/xlsx';
+export type HeaderAxis = 'row' | 'col';
+export type HeaderState = 'none' | 'part' | 'full';
+export declare class HeaderLayer {
+    #private;
+    readonly element: HTMLDivElement;
+    constructor(doc: Document, axis: HeaderAxis);
+    render(metrics: GridMetrics, indices: readonly number[], state: (index: number) => HeaderState, fontPx: number): void;
+}

package/dist/xlsx/grid/index.d.ts

@@ -0,0 +1,8 @@
+import type { EditorContext, GridController } from 'ooxml-core/xlsx/ui';
+export { editBridge, type EditBridge, type EditMode, type EditState } from 'ooxml-core/xlsx/ui';
+/** The GridController plus the grid's status-bar mode. */
+export interface GridControllerExt extends GridController {
+    /** Excel's mode indicator: 'ready' | 'enter' | 'edit' | 'point'. */
+    mode(): string;
+}
+export declare function mountGrid(ctx: EditorContext, container: HTMLElement): () => void;

package/dist/xlsx/grid/indicators.d.ts

@@ -0,0 +1,5 @@
+import type { GridSelection } from './grid-selection.js';
+import type { GridView } from './grid-view.js';
+export declare function wireTooltips(view: GridView): () => void;
+/** Follows the hyperlink of a cell; false when the cell has none. */
+export declare function followLink(view: GridView, selection: GridSelection, row: number, col: number): boolean;

package/dist/xlsx/grid/measure.d.ts

@@ -0,0 +1,9 @@
+import type { FontView } from 'ooxml-core/xlsx';
+export interface TextMeasurer {
+    /** Width in CSS pixels of `text` in a CSS font shorthand. */
+    measure(text: string, font: string): number;
+    /** Width at 100% zoom of `text` in a core font view (for `autoFitColumnWidth`). */
+    measureFont(text: string, font: FontView): number;
+}
+export declare function estimateWidth(text: string, font: string): number;
+export declare function createTextMeasurer(doc: Document | undefined): TextMeasurer;

package/dist/xlsx/grid/pane-chrome.d.ts

@@ -0,0 +1,22 @@
+import type { GridMetrics, VisibleCells } from 'ooxml-core/xlsx';
+import type { Selection } from 'ooxml-core/xlsx/ui';
+import type { GridGeometry } from 'ooxml-core/xlsx/ui';
+import type { HeaderLayer } from './headers.js';
+export interface HeaderPane {
+    box: HTMLDivElement;
+    layer: HeaderLayer;
+}
+export interface ChromeNodes {
+    colHeaders: {
+        frozen: HeaderPane;
+        scroll: HeaderPane;
+    };
+    rowHeaders: {
+        frozen: HeaderPane;
+        scroll: HeaderPane;
+    };
+    corner: HTMLDivElement;
+    freezeH: HTMLDivElement;
+    freezeV: HTMLDivElement;
+}
+export declare function paintChrome(nodes: ChromeNodes, g: GridGeometry, metrics: GridMetrics, vis: VisibleCells, selection: Selection): void;

package/dist/xlsx/grid/point-mode.d.ts

@@ -0,0 +1,27 @@
+import { type CellAddress, type NavigationKey } from 'ooxml-core/xlsx';
+import type { GridView } from './grid-view.js';
+export interface PointEditor {
+    readonly bridge: {
+        state(): {
+            editing: boolean;
+            text: string;
+            caret: number;
+            sheet: number;
+            address: CellAddress;
+        };
+    };
+    setText(text: string, caret: number): void;
+    setMode(mode: 'enter' | 'edit' | 'point'): void;
+}
+export declare class PointMode {
+    #private;
+    constructor(view: GridView, editor: PointEditor);
+    reset(): void;
+    get active(): boolean;
+    /** True when a pointed reference would be inserted (or replace the current one). */
+    canPoint(): boolean;
+    /** Arrow key in point mode; Shift extends the pointed range. */
+    move(key: NavigationKey, extend: boolean): boolean;
+    /** Mouse pointing: `anchor` where the press started, `at` where the pointer is. */
+    pointRange(anchor: CellAddress, at: CellAddress): boolean;
+}

package/dist/xlsx/grid/selection-layer.d.ts

@@ -0,0 +1,32 @@
+import type { CellRange, GridMetrics } from 'ooxml-core/xlsx';
+import type { Selection } from 'ooxml-core/xlsx/ui';
+export interface OverlayState {
+    selection: Selection | undefined;
+    /** The cell range the active cell covers (merge-sized). */
+    activeRange: CellRange | undefined;
+    copyRange?: CellRange | undefined;
+    references?: {
+        range: CellRange;
+        color: string;
+    }[] | undefined;
+    fillPreview?: CellRange | undefined;
+    showHandle: boolean;
+    /** Last row/column worth painting (whole-column ranges are clipped to it). */
+    maxRow: number;
+    maxCol: number;
+}
+interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export declare class SelectionLayer {
+    #private;
+    readonly element: HTMLDivElement;
+    constructor(doc: Document);
+    render(metrics: GridMetrics, state: OverlayState): void;
+}
+/** clip-path polygon showing `outer` minus `inner` (both in plane pixels). */
+export declare function cutout(outer: Rect, inner: Rect): string;
+export {};

package/dist/xlsx/grid/smartart.d.ts

@@ -0,0 +1,10 @@
+import { type SmartArtObject, type ThemePalette } from 'ooxml-core/xlsx';
+import { type SchemeColors } from '../../index';
+import type { EditorContext } from 'ooxml-core/xlsx/ui';
+/** The workbook theme as the scheme colours the SmartArt drawing refers to (`#rrggbb`). */
+export declare function smartArtSchemeColors(theme: ThemePalette | undefined): SchemeColors;
+/**
+ * Paints a SmartArt frame into `node`. The shared SVG scales to the positioned frame,
+ * following both zoom and drawing resize without clipping the original cached extent.
+ */
+export declare function paintSmartArt(ctx: EditorContext, node: HTMLElement, obj: SmartArtObject, theme: ThemePalette | undefined): void;

package/dist/xlsx/grid/styles.d.ts

@@ -0,0 +1 @@
+export declare const GRID_CSS = "\n.xg-root [hidden]{display:none!important}\n.xg-root{position:relative;overflow:hidden;width:100%;height:100%;min-height:0;outline:none;\n\tbackground:var(--xve-sheet-bg,#fff);color:#000;font-family:\"Segoe UI\",system-ui,sans-serif;\n\t-webkit-user-select:none;user-select:none;contain:strict}\n.xg-scroller{position:absolute;inset:0;overflow:auto;overscroll-behavior:contain;touch-action:pan-x pan-y}\n.xg-space{position:relative}\n.xg-view{position:sticky;left:0;top:0;overflow:hidden;cursor:cell;touch-action:pan-x pan-y}\n.xg-q,.xg-hbox{position:absolute;overflow:hidden}\n.xg-plane{position:absolute;left:0;top:0;will-change:transform}\n.xg-cells,.xg-lines,.xg-overlay,.xg-drawings{position:absolute;left:0;top:0}\n.xg-gl{position:absolute;background:var(--xve-grid-line,#e1e1e1)}\n.xg-c{position:absolute;box-sizing:border-box;overflow:visible}\n.xg-c[hidden],.xg-gl[hidden],.xg-hd[hidden]{display:none}\n.xg-c-over{z-index:1}\n.xg-t{position:absolute;top:0;bottom:0;display:flex;box-sizing:border-box;overflow:hidden;line-height:1.15}\n.xg-t.xg-wrap{white-space:pre-wrap;overflow-wrap:anywhere}\n.xg-t.xg-wrap>.xg-tx{display:block;width:100%}\n.xg-t.xg-vert{writing-mode:vertical-rl;text-orientation:upright}\n.xg-t.xg-over{background:var(--xve-sheet-bg,#fff)}\n.xg-c[style*=\"background-color\"]>.xg-t.xg-over,.xg-c-fill>.xg-t.xg-over{background:transparent}\n.xg-tx{display:inline-block;white-space:inherit}\n.xg-link{cursor:pointer}\n.xg-b{position:absolute;left:-1px;top:-1px;box-sizing:border-box;pointer-events:none}\n.xg-diag{position:absolute;left:0;top:0;pointer-events:none}\n.xg-db{position:absolute;left:2px;top:2px;bottom:2px;border:1px solid;box-sizing:border-box}\n.xg-ic{position:absolute;left:2px;top:50%;transform:translateY(-50%)}\n.xg-cm{position:absolute;right:0;top:0;width:0;height:0;border-left:6px solid transparent;border-top:6px solid #d13438;z-index:2}\n.xg-er{position:absolute;left:0;top:0;width:0;height:0;border-right:6px solid transparent;border-top:6px solid #107c41;z-index:2}\n.xg-overlay{pointer-events:none;z-index:3}\n.xg-shade{position:absolute;background:var(--xve-selection,rgba(33,115,70,.12))}\n.xg-outline{position:absolute;box-sizing:border-box;border:2px solid var(--xve-selection-border,#217346)}\n.xg-active{position:absolute;box-sizing:border-box;border:1px solid var(--xve-selection-border,#217346)}\n.xg-handle{position:absolute;box-sizing:border-box;background:var(--xve-selection-border,#217346);border:1px solid #fff;pointer-events:auto;cursor:crosshair}\n.xg-ants{position:absolute;box-sizing:border-box;--a:var(--xve-selection-border,#217346);\n\tbackground-image:linear-gradient(90deg,var(--a) 50%,transparent 50%),linear-gradient(90deg,var(--a) 50%,transparent 50%),linear-gradient(0deg,var(--a) 50%,transparent 50%),linear-gradient(0deg,var(--a) 50%,transparent 50%);\n\tbackground-repeat:repeat-x,repeat-x,repeat-y,repeat-y;background-size:8px 2px,8px 2px,2px 8px,2px 8px;\n\tbackground-position:0 0,0 100%,0 0,100% 0;animation:xg-ants .5s linear infinite}\n@keyframes xg-ants{to{background-position:8px 0,-8px 100%,0 -8px,100% 8px}}\n@media (prefers-reduced-motion:reduce){.xg-ants{animation:none}}\n.xg-fill-preview{position:absolute;box-sizing:border-box;border:1px dashed #666}\n.xg-refbox{position:absolute;box-sizing:border-box;border:2px solid}\n.xg-hbox{background:var(--xve-header-bg,#f3f3f3);z-index:4}\n.xg-hdr-plane{position:absolute;left:0;top:0;will-change:transform}\n.xg-hd{position:absolute;box-sizing:border-box;display:flex;align-items:center;justify-content:center;\n\tcolor:var(--xve-header-fg,#444);border-right:1px solid var(--xve-header-line,#d4d4d4);border-bottom:1px solid var(--xve-header-line,#d4d4d4);overflow:hidden;white-space:nowrap}\n.xg-hdr-col .xg-hd{top:0;height:100%}\n.xg-hdr-row .xg-hd{left:0;width:100%}\n.xg-hd-sel{background:var(--xve-header-active-bg,#e1e1e1);color:var(--xve-selection-border,#217346);font-weight:600}\n.xg-hdr-col .xg-hd-sel{box-shadow:inset 0 -2px 0 var(--xve-selection-border,#217346)}\n.xg-hdr-row .xg-hd-sel{box-shadow:inset -2px 0 0 var(--xve-selection-border,#217346)}\n.xg-hd-full{background:var(--xve-header-full-bg,#cde6d7);color:var(--xve-selection-border,#185c37);font-weight:600}\n.xg-hdr-col{cursor:s-resize}.xg-hdr-row{cursor:e-resize}\n.xg-hdr-col .xg-hd,.xg-hdr-row .xg-hd{cursor:inherit}\n.xg-corner{position:absolute;left:0;top:0;background:var(--xve-header-bg,#f3f3f3);z-index:5;box-sizing:border-box;\n\tborder-right:1px solid var(--xve-header-line,#d4d4d4);border-bottom:1px solid var(--xve-header-line,#d4d4d4);cursor:default}\n.xg-corner::after{content:\"\";position:absolute;right:3px;bottom:3px;border-left:9px solid transparent;border-bottom:9px solid #b4b4b4}\n.xg-freeze-h,.xg-freeze-v{position:absolute;background:var(--xve-freeze-line,#9b9b9b);z-index:6;pointer-events:none}\n.xg-col-resize{cursor:col-resize!important}.xg-row-resize{cursor:row-resize!important}\n.xg-resize-guide{position:absolute;z-index:8;border:0 dashed #666;pointer-events:none}\n.xg-editor-host{position:absolute;z-index:7;box-sizing:border-box;opacity:0;overflow:hidden;pointer-events:none;background:#fff;color:#000;line-height:1.25}\n.xg-editor-host.xg-editing{opacity:1;pointer-events:auto;overflow:visible;cursor:text;\n\tbox-shadow:0 0 0 2px var(--xve-selection-border,#217346),0 2px 6px rgba(0,0,0,.25)}\n.xg-editor-host .xg-field-backdrop,.xg-editor-host .xg-field-input{padding:1px 3px}\n.xg-sink{position:absolute;left:0;top:0;width:1px;height:1px;opacity:0;padding:0;border:0;resize:none;overflow:hidden;pointer-events:none}\n.xg-field{position:relative}\n.xg-field-backdrop,.xg-field-input{margin:0;border:0;box-sizing:border-box;font:inherit;line-height:inherit;letter-spacing:inherit;\n\tpadding:inherit;white-space:pre-wrap;overflow-wrap:anywhere;word-break:normal;tab-size:4}\n.xg-field-backdrop{position:absolute;inset:0;overflow:hidden;color:inherit;pointer-events:none;visibility:hidden}\n.xg-field.xg-formula .xg-field-backdrop{visibility:visible}\n.xg-field-input{position:relative;display:block;width:100%;height:100%;resize:none;outline:none;background:transparent;color:inherit;overflow:hidden}\n.xg-field.xg-formula .xg-field-input{color:transparent;caret-color:#000}\n.xg-ref{font:inherit}\n.xg-editor-host .xg-field{width:100%;height:100%}\n.xg-dd{position:absolute;z-index:6;width:17px;height:17px;box-sizing:border-box;border:1px solid #c8c8c8;background:#f3f3f3;\n\tdisplay:flex;align-items:center;justify-content:center;cursor:default;pointer-events:auto}\n.xg-dd::before{content:\"\";border-left:4px solid transparent;border-right:4px solid transparent;border-top:5px solid #444}\n.xg-popup{position:absolute;z-index:20;background:var(--xve-popover,#fff);color:var(--xve-popover-foreground,#222);\n\tborder:1px solid var(--xve-border,#c8c8c8);box-shadow:0 4px 12px rgba(0,0,0,.18);font-size:13px;border-radius:4px}\n.xg-list{max-height:220px;overflow:auto;min-width:120px;padding:2px 0;margin:0;list-style:none}\n.xg-list [role=option]{padding:3px 10px;cursor:default;white-space:nowrap}\n.xg-list [aria-selected=true]{background:var(--xve-accent,#e1efe6)}\n.xg-tip{padding:6px 8px;max-width:260px;white-space:pre-wrap;background:#fffbe6;color:#222;pointer-events:none}\n.xg-tip b{display:block;margin-bottom:2px}\n.xg-alert{padding:12px 14px;max-width:340px}\n.xg-alert h3{margin:0 0 6px;font-size:14px}\n.xg-alert p{margin:0 0 10px;white-space:pre-wrap}\n.xg-alert .xg-actions{display:flex;gap:6px;justify-content:flex-end}\n.xg-alert button{min-width:64px;padding:4px 10px;border:1px solid var(--xve-border,#c8c8c8);border-radius:3px;background:var(--xve-secondary,#f3f3f3);color:inherit;font:inherit}\n.xg-alert button:first-child{background:var(--xve-selection-border,#217346);color:#fff;border-color:transparent}\n.xg-drawings{z-index:4}\n.xg-obj{position:absolute;box-sizing:border-box;pointer-events:auto;cursor:default}\n.xg-obj img,.xg-obj svg{display:block;width:100%;height:100%;pointer-events:none}\n.xg-obj.xg-chart{background:#fff;border:1px solid #d9d9d9}\n.xg-obj.xg-obj-sel{outline:1px solid #8a8a8a}\n.xg-obj .xg-grip{position:absolute;width:8px;height:8px;background:#fff;border:1px solid #555;box-sizing:border-box;border-radius:50%}\n.xg-obj-unsupported{background:repeating-linear-gradient(45deg,#f6f6f6,#f6f6f6 6px,#ececec 6px,#ececec 12px);border:1px dashed #aaa;\n\tfont-size:11px;color:#555;display:flex;align-items:center;justify-content:center;text-align:center}\n.xg-obj.xg-smartart{overflow:hidden}\n.xg-obj.xg-smartart office-ui-smartart{display:block;pointer-events:none}\n.xg-smartart-placeholder{background:#fafafa;border:1px dashed #aaa;font-size:11px;color:#333;padding:4px;overflow:auto}\n.xg-smartart-nodes{margin:0;padding-left:16px}\n.xg-smartart-nodes .xg-smartart-child{margin-left:12px}\n.xg-smartart-notice{display:none;position:absolute;left:0;bottom:0;padding:1px 4px;font-size:10px;background:rgba(255,255,255,.9);color:#555;border-top-right-radius:3px}\n.xg-obj-sel .xg-smartart-notice,.xg-smartart-placeholder .xg-smartart-notice{display:block}\n.xg-live{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}\n";

package/dist/xlsx/grid/test-context.d.ts

@@ -0,0 +1,14 @@
+import { type Workbook } from 'ooxml-core/xlsx';
+import type { EditorContext } from 'ooxml-core/xlsx/ui';
+export interface TestContext extends EditorContext {
+    readonly events: {
+        type: string;
+        detail: unknown;
+    }[];
+    readonly toasts: string[];
+    setReadOnly(value: boolean): void;
+    /** Simulates the shell's model-change fan-out. */
+    notify(change?: unknown): void;
+}
+export declare function interpolate(text: string, vars?: Record<string, string | number>): string;
+export declare function createTestContext(workbook?: Workbook, doc?: Document): TestContext;

package/dist/xlsx/grid/validation-list.d.ts

@@ -0,0 +1,13 @@
+import type { GridView } from './grid-view.js';
+/** Unique texts above and below a cell in its column (contiguous block), for the pick list. */
+export declare function columnPickList(view: GridView, row: number, col: number, limit?: number): string[];
+export declare class ValidationList {
+    #private;
+    readonly arrow: HTMLDivElement;
+    constructor(view: GridView, onDone: () => void);
+    position(): void;
+    get isOpen(): boolean;
+    /** Opens the list; `pick` falls back to the column's values when there is no list rule. */
+    open(pick: boolean): boolean;
+    close(refocus?: boolean): void;
+}

package/dist/xlsx/index.d.ts

@@ -0,0 +1,10 @@
+export { XlsxEditorElement, defineXlsxEditor, type XlsxThemeColors } from './component';
+export { XLSX_EDITOR_EVENTS, type FileCommand, type FileCommandDetail, type SelectionChangeDetail, type XlsxEditorEventDetail, type XlsxEditorEventMap, type XlsxEditorEventName, } from './events';
+export { XLSX_EDITOR_ATTRIBUTES, DEFAULT_AUTHOR_NAME, DEFAULT_FILE_NAME, } from './editor-attributes';
+export { EDITOR_LOCALES, normalizeEditorLocale, type EditorLocale, type EditorLocaleInput, } from 'ooxml-core/xlsx/ui';
+export { THEME_KEYS, darkTheme as xlsxDarkTheme, lightTheme as xlsxLightTheme, themeToCssVars, type EditorThemeMode, type XlsxTheme, } from './theme';
+export type { Command as EditorCommand, CommandRegistry } from 'ooxml-core/xlsx/ui';
+export type { EditorContext, GridController, Selection as EditorSelection, SelectionModel, } from 'ooxml-core/xlsx/ui';
+export type { DialogRegistry } from 'ooxml-core/xlsx/ui';
+export { registerRibbonTabs, type RibbonControl, type RibbonGroup, type RibbonMenuItem, type RibbonTab, } from 'ooxml-core/xlsx/ui';
+export { registerRibbonIcon } from './ribbon/icons';

package/dist/xlsx/keyboard.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Global keyboard shortcuts. The map only decides which command id (or shell action) a key runs;
+ * the behaviour lives in the commands. Grid navigation and in-cell editing keys belong to the grid,
+ * which handles them first (a handled event is `defaultPrevented` and left alone here).
+ */
+import type { EditorContext } from 'ooxml-core/xlsx/ui';
+/** `Mod` is Cmd on Apple platforms and Ctrl elsewhere; `code:` matches `KeyboardEvent.code`. */
+export type KeySpec = string;
+export type ShellAction = 'help' | 'keytips' | 'next-region' | 'previous-region' | 'context-menu';
+export interface Shortcut {
+    keys: readonly KeySpec[];
+    label: string;
+    command?: string;
+    arg?: unknown;
+    action?: ShellAction;
+    /** True: also works while typing in a text field (formula bar, dialogs). */
+    global?: boolean;
+}
+/** Excel's shortcuts, mapped to command ids (`file.*` and `sheet.next/previous` are the shell's). */
+export declare const SHORTCUTS: readonly Shortcut[];
+export interface KeyEventLike {
+    key: string;
+    code?: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+    shiftKey: boolean;
+}
+export declare function isMacPlatform(): boolean;
+/** Exact modifier match: Ctrl on a Mac, or Cmd elsewhere, never satisfies `Mod`. */
+export declare function matchesKeys(event: KeyEventLike, spec: KeySpec, mac: boolean): boolean;
+/** Human-readable key text (`Ctrl+Shift+L`, `Cmd+S` on a Mac). Legends are not translated. */
+export declare function formatKeys(spec: KeySpec, mac: boolean): string;
+/** Specs listed in help: the first of each shortcut without `code:` duplicates. */
+export declare const displayKeys: (shortcut: Shortcut, mac: boolean) => string[];
+export declare function findShortcut(event: KeyEventLike, mac: boolean): Shortcut | undefined;
+/**
+ * Listens on the host (shadow-tree events bubble to it, retargeted) and runs the map. Returns a
+ * disposer.
+ */
+export declare function installKeyboard(ctx: EditorContext, actions: (action: ShellAction) => void): () => void;

package/dist/xlsx/modules.d.ts

@@ -0,0 +1,4 @@
+export { installCommands } from './commands/index';
+export { mountGrid } from './grid/index';
+export { mountFormulaBar } from './formula-bar/index';
+export { mountSheetTabs } from './sheet-tabs/index';

package/dist/xlsx/print.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Printing: the active sheet's print area (or its used range) rendered as a print-only HTML table
+ * from the core's cell views, column and row metrics, and merges, printed through a hidden frame.
+ * It approximates Excel's page output (no headers, footers or scaling to fit) and says so.
+ */
+import { type CellRange, type CellView, type Workbook } from 'ooxml-core/xlsx';
+/** Inline CSS for one cell view. */
+export declare function cellCss(view: CellView): string;
+/** The range a sheet prints: its print area, else its used range (undefined for an empty sheet). */
+export declare function printRange(workbook: Workbook, sheetIndex: number): CellRange | undefined;
+/** A standalone HTML document with the sheet's print range as a table. */
+export declare function buildPrintHtml(workbook: Workbook, sheetIndex: number, title: string): string;
+/** How long a print frame may stay without `afterprint` before it is removed anyway. */
+export declare const PRINT_FRAME_TIMEOUT_MS = 60000;
+/**
+ * Prints through a hidden frame so the editor page itself is never reflowed. The frame is removed
+ * on `afterprint` (some browsers return from `print()` before the dialog closes, so removing it
+ * then would cancel the job), on the next print, or after a long safety timeout.
+ */
+export declare function printHtml(doc: Document, html: string): void;
+/** Prints the active sheet of `workbook`. */
+export declare function printWorkbook(doc: Document, workbook: Workbook, sheetIndex: number, title: string): void;

package/dist/xlsx/ribbon/caption.d.ts

@@ -0,0 +1,4 @@
+/** The label with a `\n` at the most balanced space (one line for a single word). */
+export declare function balancedCaption(label: string): string;
+/** Writes a large button's caption (two balanced lines). */
+export declare function setLargeCaption(caption: HTMLElement, label: string): void;

package/dist/xlsx/ribbon/color-grid.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Excel's colour picker: Automatic (or No Fill), Theme Colors (ten columns, each a theme slot over
+ * five tints taken from the workbook theme), Standard Colors and More Colors (the browser's colour
+ * input). The choice is a SpreadsheetML `Color` (`{ theme, tint }` or `{ rgb }`), or undefined.
+ */
+import { type Color, type ThemePalette } from 'ooxml-core/xlsx';
+/** Excel's five tint rows under each theme colour (lt1, dk1, lt2 and the rest differ). */
+export declare function themeTints(slot: number): number[];
+export declare const STANDARD_COLORS: ReadonlyArray<readonly [string, string]>;
+export interface ColorGridOptions {
+    /** First row: 'Automatic' (font colour) or 'No Fill' (fill colour). */
+    automaticLabel?: string;
+    theme?: ThemePalette;
+    t(key: string, vars?: Record<string, string | number>): string;
+}
+/** The CSS colour a `Color` shows in the workbook theme (for swatches and the split bar). */
+export declare function cssColor(color: Color | undefined, theme?: ThemePalette): string;
+export declare function openColorGrid(anchor: HTMLElement, choose: (color: Color | undefined) => void, options: ColorGridOptions): void;