ooxml-ui 1.1.0 → 1.3.0

package/dist/xlsx/collaboration.d.ts

@@ -0,0 +1,56 @@
+import type { CellRange, EditSession, RemoteRange } from 'ooxml-core/xlsx';
+import type { EditHistory, Selection, SelectionModel } from 'ooxml-core/xlsx/ui';
+import { type CollabRuntime } from './collaboration-session.js';
+import type { EditorCore } from './editor-core.js';
+import { type XlsxCollaborationOptions, type XlsxCollaborationState } from './collaboration-types.js';
+/** What the controller needs from the editor. */
+export interface CollaborationHost {
+    edit(): EditSession | undefined;
+    readonly selection: SelectionModel;
+    userName(): string;
+    t(key: string, vars?: Record<string, string | number>): string;
+    toast(message: string, kind: 'info' | 'warning' | 'error'): void;
+    /** Reports a failure as `workbook-error`. */
+    error(error: Error): void;
+    /** Announces `collaboration-change` and refreshes the title bar. */
+    changed(state: XlsxCollaborationState): void;
+    setReadOnly(readOnly: boolean): void;
+}
+/** The part of the selection a collaborator sees: the range holding the active cell. */
+export declare function presenceRange(selection: Selection): CellRange;
+export declare class XlsxCollaboration {
+    #private;
+    private readonly host;
+    private readonly load;
+    constructor(host: CollaborationHost, load?: () => Promise<CollabRuntime>);
+    get active(): boolean;
+    /** Joined or joining. */
+    get busy(): boolean;
+    /** The options of the declarative `collaboration` property, if set. */
+    get wanted(): XlsxCollaborationOptions | undefined;
+    /**
+     * Declarative sharing: while set, the open workbook is shared in that room, and a workbook
+     * opened later joins it too (the room's content wins when it already has one). Undefined stops.
+     */
+    want(options: XlsxCollaborationOptions | undefined): void;
+    /** Leaves the room before the workbook is replaced; true when it was shared. */
+    suspend(): boolean;
+    /** Joins the wanted room with the workbook now open. */
+    resume(): void;
+    /** Joins a room. Rejects when one is active, no workbook is open or the room is invalid. */
+    start(options: XlsxCollaborationOptions): Promise<void>;
+    /**
+     * Leaves the room and forgets the `collaboration` property. A session the host passed in stays
+     * alive; one the editor made is destroyed.
+     */
+    stop(): void;
+    /** Restarts the connection, keeping the shared workbook and queued changes. */
+    reconnect(): void;
+    /** The binding's history while shared (only this window's edits), else undefined. */
+    history(): EditHistory | undefined;
+    remoteSelections(): readonly RemoteRange[];
+    onRemoteChange(listener: () => void): () => void;
+    state(): XlsxCollaborationState;
+}
+/** The controller of one editor, reporting through its toasts, events and render loop. */
+export declare function collaborationFor(core: EditorCore): XlsxCollaboration;

package/dist/xlsx/component.d.ts

@@ -5,6 +5,7 @@
 import type { Workbook } from 'ooxml-core/xlsx';
 import { XlsxEditorApi } from './element-api.js';
 import type { XlsxEditorEventMap } from './events.js';
+import type { XlsxCollaborationOptions } from './collaboration-types.js';
 import type { EditorLocale, EditorLocaleInput } from 'ooxml-core/xlsx/ui';
 import { type EditorThemeMode, type XlsxTheme } from './theme/index.js';
 /** Theme tokens, applied to the host as `--xve-<kebab-key>` custom properties. */
@@ -53,6 +54,13 @@ export declare class XlsxEditorElement extends XlsxEditorApi {
     set workbook(value: Workbook | null);
     /** Unsaved changes since the last load, save or `markClean()`. */
     get dirty(): boolean;
+    /**
+     * Shares the open workbook in a room while set: a workbook opened later joins the same room
+     * (the room's content wins when it already has a workbook); `null` leaves it. A window joining
+     * an existing room still needs a workbook open (`newWorkbook()` is enough).
+     */
+    get collaboration(): XlsxCollaborationOptions | null;
+    set collaboration(value: XlsxCollaborationOptions | null | undefined);
     get activeSheet(): number;
     set activeSheet(index: number);
 }

package/dist/xlsx/dialogs/comments-list.d.ts

@@ -1,2 +1,6 @@
+import { type Comment } from 'ooxml-core/xlsx';
 import type { EditorContext } from 'ooxml-core/xlsx/ui';
+import type { OfficeCommentThread } from '../../comments/types.js';
+/** Excel notes and threaded comments as neutral threads, in sheet order, keyed by address. */
+export declare function excelCommentThreads(comments: readonly Comment[]): OfficeCommentThread[];
 export declare function openCommentsList(ctx: EditorContext): Promise<string | undefined>;

package/dist/xlsx/dialogs/help-dialogs.d.ts

@@ -1,5 +1,5 @@
 import type { EditorContext } from 'ooxml-core/xlsx/ui';
 export declare function openShortcutHelp(ctx: EditorContext): Promise<undefined>;
 export declare const SUPPORTED_FEATURES: readonly ['Cell editing with undo and redo', 'Formulas calculated by the built-in calculation engine', 'Number formats', 'Conditional formatting display', 'Tables', 'Charts (display and basic editing)', 'Comments and notes', 'Hyperlinks', 'Data validation', 'Sort and filter', 'Freeze panes'];
-export declare const UNSUPPORTED_FEATURES: readonly ['Pivot tables and sparklines (kept in the file but not shown)', 'Show Formulas', 'Manual calculation', 'Outline (grouping) for columns', 'Password protection hashes', 'Editing threaded comment replies', 'Macros (VBA is kept in the file but never run)', 'Changing the workbook theme', 'Page Layout view'];
+export declare const UNSUPPORTED_FEATURES: readonly ['Pivot tables (kept in the file but not shown)', 'Creating or editing sparklines (existing ones are shown)', 'Show Formulas', 'Manual calculation', 'Outline (grouping) for columns', 'Password protection hashes', 'Editing threaded comment replies', 'Macros (VBA is kept in the file but never run)', 'Changing the workbook theme', 'Page Layout view'];
 export declare function openFeatureStatus(ctx: EditorContext): Promise<undefined>;

package/dist/xlsx/editor-core.d.ts

@@ -11,6 +11,8 @@ import { type DialogRegistry } from 'ooxml-core/xlsx/ui';
 import { DirtyState } from 'ooxml-core/xlsx/ui';
 import { type EditorLocale } from 'ooxml-core/xlsx/ui';
 import type { CalculationMode } from './backstage/index.js';
+import { CalcPreparation } from './calc-preparation.js';
+import { type XlsxCollaboration } from './collaboration.js';
 import type { EditorThemeMode, XlsxTheme } from './theme/index.js';
 /** What the shell exposes back to the core (filled in when the element connects). */
 export interface ShellHooks {
@@ -41,6 +43,10 @@ export declare class EditorCore {
     readonly dialogs: DialogRegistry;
     readonly dirty: DirtyState;
     readonly ctx: EditorContext;
+    /** Co-editing over `ooxml-core/collab`; undo and redo go through it while shared. */
+    readonly collab: XlsxCollaboration;
+    /** Builds the formula graph in idle time after a workbook opens. */
+    readonly calcPreparation: CalcPreparation;
     private gridController;
     private readonly modelListeners;
     private stopSession;

package/dist/xlsx/element-api.d.ts

@@ -1,16 +1,19 @@
 /**
  * The public methods of `<xlsx-editor>` (load, newWorkbook, save, saveBytes, download, markClean,
- * select, getSelection, setActiveSheet, undo, redo, focusGrid). The properties and lifecycle are
+ * select, getSelection, setActiveSheet, collaboration, share, undo, redo, focusGrid). The properties and lifecycle are
  * in component.ts; the state is the EditorCore.
  */
 import { EditorCore } from './editor-core.js';
 import { type FileChrome } from './editor-files.js';
+import type { XlsxCollaborationOptions, XlsxCollaborationState } from './collaboration-types.js';
 /** Server rendering has no HTMLElement; the class still has to be definable there. */
 export declare const HTMLElementBase: typeof HTMLElement;
 export declare class XlsxEditorApi extends HTMLElementBase {
     protected readonly core: EditorCore;
     /** Set by the shell once connected. */
     protected chrome: FileChrome | undefined;
+    /** Set by the shell once connected: opens File > Share. */
+    protected openShare: (() => void) | undefined;
     /** Opens .xlsx, .xlsm, .xltx, .xls or .csv bytes; `fileName` helps detection and names the file. */
     load(bytes: Uint8Array | ArrayBuffer, fileName?: string): Promise<void>;
     /** Starts a blank workbook named Book1.xlsx. */
@@ -30,6 +33,21 @@ export declare class XlsxEditorApi extends HTMLElementBase {
     /** The selection as A1 text (`B2:C5`, several ranges joined by commas). */
     getSelection(): string;
     setActiveSheet(index: number): void;
+    /**
+     * Shares the open workbook in a room (see `XlsxCollaborationOptions`). Resolves once joined;
+     * the room's workbook replaces this one when the room already has one. Rejects when sharing is
+     * already active or no workbook is open.
+     */
+    startCollaboration(options: XlsxCollaborationOptions): Promise<void>;
+    /** Leaves the room (and clears `collaboration`). The workbook stays as it is. */
+    stopCollaboration(): void;
+    /** Restarts the connection, keeping the shared workbook and changes made offline. */
+    reconnectCollaboration(): void;
+    /** Who is in the room and how the connection is. */
+    get collaborationState(): XlsxCollaborationState;
+    /** Opens File > Share, where the user starts or stops sharing and sees who is in the room. */
+    share(): void;
+    /** Undo the last edit; while shared, only this window's edits are undone. */
     undo(): void;
     redo(): void;
     focusGrid(): void;

package/dist/xlsx/events.d.ts

@@ -1,4 +1,5 @@
 import type { Workbook } from 'ooxml-core/xlsx';
+import type { XlsxCollaborationState } from './collaboration-types.js';
 export type FileCommand = 'new' | 'open' | 'save' | 'saveAs' | 'export' | 'exportCsv' | 'print';
 export interface FileCommandDetail {
     command: FileCommand;
@@ -50,11 +51,13 @@ export interface XlsxEditorEventMap {
     'dirty-change': {
         dirty: boolean;
     };
+    /** Sharing started or stopped, the connection changed, or someone joined, left or synced. */
+    'collaboration-change': XlsxCollaborationState;
 }
 export type XlsxEditorEventName = keyof XlsxEditorEventMap;
 export type XlsxEditorEventDetail<K extends XlsxEditorEventName> = XlsxEditorEventMap[K];
 /** Runtime list of every event name; the `satisfies` check keeps it a subset of the map. */
-export declare const XLSX_EDITOR_EVENTS: readonly ["workbook-change", "workbook-error", "workbook-warning", "readonly-change", "ribbon-action", "ribbon-customize", "file-command", "selection-change", "sheet-change", "dirty-change"];
+export declare const XLSX_EDITOR_EVENTS: readonly ["workbook-change", "workbook-error", "workbook-warning", "readonly-change", "ribbon-action", "ribbon-customize", "file-command", "selection-change", "sheet-change", "dirty-change", "collaboration-change"];
 /**
  * Dispatches a bubbling, composed CustomEvent. Returns false when a cancelable event was canceled
  * (the `EventTarget.dispatchEvent` contract).

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

@@ -0,0 +1,3 @@
+import type { GridView } from './grid-view.js';
+/** Adds the remote-selection layer to every quadrant; returns the remover. */
+export declare function installRemoteSelections(view: GridView): () => void;

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

@@ -0,0 +1,3 @@
+import type { SparklineView } from 'ooxml-core/xlsx';
+/** Builds the `<svg class="xg-spark">` for a `w` x `h` px cell at `zoom` percent. */
+export declare function sparklineSvg(doc: Document, view: SparklineView, w: number, h: number, zoom: number): Element;

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

@@ -1 +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-chart svg [data-chart-series],.xg-chart svg [data-chart-part]{pointer-events:auto}\n.xg-obj.xg-chart{background:#fff;outline:1px solid #d9d9d9;outline-offset:-1px}\n.xg-obj.xg-obj-sel{outline:1px solid #8a8a8a;outline-offset:0}\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";
+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-spark{position:absolute;left:0;top:0;pointer-events:none;overflow:hidden}\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-remote-layer{position:absolute;left:0;top:0;pointer-events:none;z-index:3}\n.xg-remote{position:absolute;box-sizing:border-box;border:2px solid}\n.xg-remote[hidden]{display:none}\n.xg-remote-tag{position:absolute;left:-2px;bottom:100%;max-width:160px;padding:0 4px;height:16px;line-height:16px;\n\tfont:600 11px/16px var(--xve-font,system-ui,sans-serif);color:#fff;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;border-radius:2px 2px 2px 0}\n.xg-remote[data-tag=\"inside\"] .xg-remote-tag{bottom:auto;top:0;left:0;border-radius:0 0 2px 0}\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-chart svg [data-chart-series],.xg-chart svg [data-chart-part]{pointer-events:auto}\n.xg-obj.xg-chart{background:#fff;outline:1px solid #d9d9d9;outline-offset:-1px}\n.xg-obj.xg-obj-sel{outline:1px solid #8a8a8a;outline-offset:0}\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/index.d.ts

@@ -1,5 +1,6 @@
 export { XlsxEditorElement, defineXlsxEditor, type XlsxThemeColors } from './component.js';
 export { XLSX_EDITOR_EVENTS, type FileCommand, type FileCommandDetail, type SelectionChangeDetail, type XlsxEditorEventDetail, type XlsxEditorEventMap, type XlsxEditorEventName, } from './events.js';
+export type { XlsxCollaborationOptions, XlsxCollaborationState, XlsxCollaborator, } from './collaboration-types.js';
 export { XLSX_EDITOR_ATTRIBUTES, DEFAULT_AUTHOR_NAME, DEFAULT_FILE_NAME, } from './editor-attributes.js';
 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/index.js';

package/dist/xlsx/ribbon-actions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The controls at the right end of Excel's ribbon tab row: the Editing / Viewing selector, the
+ * Comments toggle and Share, in that order, as Excel 365 places them. The shared
+ * `office-ui-ribbon-actions` element draws them (Word uses the same one) in the shared ribbon's
+ * `actions` slot; the title bar keeps the file name, search and the people in a shared session.
+ */
+import type { EditorContext } from 'ooxml-core/xlsx/ui';
+import { type OfficeUiRibbonActions } from '../ribbon/ribbon-actions.js';
+import type { XlsxCollaborationState } from './collaboration-types.js';
+export interface RibbonActionsHandlers {
+    setReadOnly(readOnly: boolean): void;
+    isHidden(id: string): boolean;
+    /** Sharing state, for Share's pressed state; absent leaves it unpressed. */
+    collaboration?(): XlsxCollaborationState;
+}
+export interface RibbonActions {
+    readonly element: OfficeUiRibbonActions;
+    /** Re-reads read-only, sharing and the comments pane state. */
+    refresh(): void;
+    relocalize(): void;
+}
+export declare function createRibbonActions(ctx: EditorContext, handlers: RibbonActionsHandlers): RibbonActions;

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

@@ -3,7 +3,7 @@ import type { EditorContext } from 'ooxml-core/xlsx/ui';
 import type { FileCommand } from './events.js';
 export interface ShellCommandHandlers {
     fileCommand(command: FileCommand): void;
-    openBackstage(page: 'info' | 'saveAs' | 'options' | 'new'): void;
+    openBackstage(page: 'info' | 'saveAs' | 'options' | 'new' | 'share'): void;
     showShortcuts(): void;
     formulaBarShown(): boolean;
     setFormulaBarShown(shown: boolean): void;

package/dist/xlsx/title-bar.d.ts

@@ -1,15 +1,17 @@
 import type { EditorContext } from 'ooxml-core/xlsx/ui';
 import { type TellMeHandlers } from 'ooxml-core/xlsx/ui';
+import type { XlsxCollaborationState } from './collaboration-types.js';
 export type SaveState = 'saved' | 'dirty' | 'saving' | 'saved-local';
 export interface TitleBarHandlers extends TellMeHandlers {
     save(): void;
-    setReadOnly(readOnly: boolean): void;
+    /** Sharing state for the presence stack; absent hides it. */
+    collaboration?(): XlsxCollaborationState;
 }
 export interface TitleBar {
     readonly element: HTMLElement;
     setFileName(name: string): void;
     setSaveState(state: SaveState): void;
-    /** Re-reads read-only, undo/redo and comments state. */
+    /** Re-reads undo/redo and the people in a shared session. */
     refresh(): void;
     relocalize(): void;
     focusTellMe(): void;