ooxml-ui 0.20.0 → 0.22.0

package/dist/form/zoom-slider.d.ts

@@ -0,0 +1,78 @@
+import { OfficeElement } from '../base.js';
+/**
+ * Office status-bar zoom: zoom out, slider, zoom in, percentage and an optional fit button.
+ * Attributes: `value` (percent, default 100), `min` (10), `max` (400), `step` (10, for the
+ * buttons), `disabled`, `fit` (shows the fit button; its value is the button's name, e.g.
+ * "Fit page to current window"), `label` (group name, default "Zoom"). `out-label`, `in-label` and
+ * `slider-label` name the zoom-out button, zoom-in button and slider (English by default), so a
+ * product can translate them.
+ * User changes emit native `input` (slider drag) and `change` events with `value` updated;
+ * the fit button emits `office-command` `{ command: 'zoom-fit' }`. Setting `value` never emits.
+ */
+export declare class OfficeUiZoomSlider extends OfficeElement {
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        value: {
+            type: NumberConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        min: {
+            type: NumberConstructor;
+        };
+        max: {
+            type: NumberConstructor;
+        };
+        step: {
+            type: NumberConstructor;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        fit: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
+        label: {
+            type: StringConstructor;
+        };
+        outLabel: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        inLabel: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        sliderLabel: {
+            type: StringConstructor;
+            attribute: string;
+        };
+    };
+    min: number;
+    max: number;
+    step: number;
+    disabled: boolean;
+    fit: string | null;
+    label: string | null;
+    outLabel: string | null;
+    inLabel: string | null;
+    sliderLabel: string | null;
+    private requested;
+    constructor();
+    get value(): number;
+    set value(next: number);
+    private get low();
+    private get high();
+    /** Office buttons snap to the next multiple of `step`, so 67% steps to 70%, not 77%. */
+    private stepBy;
+    private commit;
+    protected willUpdate(): void;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineZoomSlider: import("../registry.js").Definer;

package/dist/glyph.d.ts

@@ -0,0 +1,2 @@
+import { type TemplateResult } from 'lit';
+export declare function glyph(name: string | null | undefined, className?: string, hidden?: boolean): TemplateResult;

package/dist/icon.d.ts

@@ -0,0 +1,19 @@
+import { OfficeElement } from './base.js';
+/** `<office-ui-icon name="check" label="Done">`: decorative unless `label` is set. */
+export declare class OfficeUiIcon extends OfficeElement {
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        name: {
+            type: StringConstructor;
+        };
+        label: {
+            type: StringConstructor;
+        };
+    };
+    name: string;
+    label: string;
+    constructor();
+    protected willUpdate(): void;
+    protected render(): import("lit").TemplateResult;
+}
+export declare const defineIcon: import("./registry.js").Definer;

package/dist/icons.d.ts

@@ -11,6 +11,3 @@ export declare function listIcons(): string[];
 export declare function createIconSvg(doc: Document): SVGSVGElement;
 /** Fill an `<svg>` with a registered icon (empty when unknown). Used by every control. */
 export declare function paintIcon(svg: SVGElement, name: string | null | undefined): boolean;
-export declare const ICON_CSS = "\nsvg { width: 1em; height: 1em; fill: none; stroke: currentColor; stroke-width: 1.5;\n\tstroke-linecap: round; stroke-linejoin: round; }\n";
-/** `<office-ui-icon name="check" label="Done">`: decorative unless `label` is set. */
-export declare const defineIcon: import("./registry.js").Definer;

package/dist/icons.js

@@ -1,3 +1 @@
-export { ICON_CSS, createIconSvg, defineIcon, getIcon, listIcons, paintIcon, registerIcon } from './chunk-W5PYFBEZ.js';
-import './chunk-UEJ4F33J.js';
-import './chunk-G3LAGZEW.js';
+export { createIconSvg, getIcon, listIcons, paintIcon, registerIcon } from './chunk-HZ422LTR.js';

package/dist/index.d.ts

@@ -1,11 +1,14 @@
+export * from './base.js';
 export * from './controls.js';
+export * from './glyph.js';
 export * from './icons.js';
 export * from './presence.js';
 export * from './smartart.js';
+export * from './teams/index.js';
 export * from './theme.js';
 export { CONTRACT_REVISION, type Definer } from './registry.js';
 /** Every ooxml-ui tag this package defines, in registration order. */
-export declare const OFFICE_UI_TAGS: readonly ["office-ui-icon", "office-ui-button", "office-ui-checkbox", "office-ui-switch", "office-ui-select", "office-ui-ribbon-group", "office-ui-ribbon-stack", "office-ui-menu-item", "office-ui-menu-button", "office-ui-menu-separator", "office-ui-context-menu", "office-ui-command-search", "office-ui-toolbar", "office-ui-dialog", "office-ui-status-bar", "office-ui-status-item", "office-ui-zoom-slider", "office-ui-tab-strip", "office-ui-options-dialog", "office-ui-account", "office-ui-ribbon", "office-ui-find-bar", "office-ui-ruler", "office-ui-backstage", "office-ui-print-preview", "office-ui-radio", "office-ui-search", "office-ui-ribbon-toggle", "office-ui-dialog-footer", "office-ui-toasts", "office-ui-read-only-banner", "office-ui-paste-options", "office-ui-title-bar", "office-ui-ribbon-section", "office-ui-gallery", "office-ui-presence", "office-ui-smartart"];
+export declare const OFFICE_UI_TAGS: readonly ["office-ui-icon", "office-ui-button", "office-ui-checkbox", "office-ui-switch", "office-ui-select", "office-ui-ribbon-group", "office-ui-ribbon-stack", "office-ui-menu-item", "office-ui-menu-button", "office-ui-menu-separator", "office-ui-context-menu", "office-ui-command-search", "office-ui-toolbar", "office-ui-dialog", "office-ui-status-bar", "office-ui-status-item", "office-ui-zoom-slider", "office-ui-tab-strip", "office-ui-options-dialog", "office-ui-account", "office-ui-ribbon", "office-ui-find-bar", "office-ui-ruler", "office-ui-backstage", "office-ui-print-preview", "office-ui-radio", "office-ui-search", "office-ui-ribbon-toggle", "office-ui-dialog-footer", "office-ui-toasts", "office-ui-read-only-banner", "office-ui-paste-options", "office-ui-title-bar", "office-ui-ribbon-section", "office-ui-gallery", "office-ui-presence", "office-ui-smartart", "office-ui-avatar", "office-ui-app-rail", "office-ui-channel-list", "office-ui-chat-list", "office-ui-chat-composer", "office-ui-prejoin", "office-ui-call-grid", "office-ui-call-controls"];
 /**
  * Install the theme tokens and define every element. Idempotent and safe to call from every
  * viewer binding; a no-op where there is no DOM (SSR).

package/dist/index.js

@@ -1,14 +1,16 @@
-import { installOfficeUiTheme } from './chunk-7XBKSYGM.js';
-export { THEME_CSS, THEME_STYLE_ID, installOfficeUiTheme } from './chunk-7XBKSYGM.js';
-import { registerControls } from './chunk-W7YI5DSJ.js';
-export { CONTROL_DEFINERS, DEFAULT_OFFICE_PROFILE, EMPTY_MENU_STATE, OFFICE_AVATAR_SWATCHES, OFFICE_PROFILE_STORAGE_KEY, OFFICE_TITLE_BAR_SEARCH_LIMIT, OFFICE_TOAST_VISIBLE_LIMIT, attachKeyTips, clampFlyoutPosition, clampOptionNumber, clearOfficeProfile, defineAccount, defineBackstage, defineButton, defineCheckbox, defineCommandSearch, defineContextMenu, defineDialog, defineDialogFooter, defineFindBar, defineGallery, defineMenuButton, defineMenuItem, defineMenuSeparator, defineOptionsDialog, definePasteOptions, definePrintPreview, defineRadio, defineReadOnlyBanner, defineRibbon, defineRibbonGroup, defineRibbonSection, defineRibbonStack, defineRibbonToggle, defineRuler, defineSearchField, defineSelect, defineStatusBar, defineStatusItem, defineSwitch, defineTabStrip, defineTitleBar, defineToasts, defineToolbar, defineZoomSlider, nextEnabledIndex, parseSvgPreview, profileInitials, readOfficeProfile, registerControls, rulerDivisions, sanitizeOfficeProfile, typeAheadIndex, writeOfficeProfile } from './chunk-W7YI5DSJ.js';
-export { ICON_CSS, createIconSvg, defineIcon, getIcon, listIcons, paintIcon, registerIcon } from './chunk-W5PYFBEZ.js';
-import { definePresence } from './chunk-24MMSCKW.js';
-export { definePresence, initialsOf, participantsFromAwareness } from './chunk-24MMSCKW.js';
-import { defineSmartArt } from './chunk-4JQLQROF.js';
-export { defineSmartArt, renderDiagramDrawing } from './chunk-4JQLQROF.js';
-export { CONTRACT_REVISION } from './chunk-UEJ4F33J.js';
-export { COMPACT, FOCUS_RING, OFFICE_TOKENS, TOUCH, tok } from './chunk-G3LAGZEW.js';
+import { installOfficeUiTheme } from './chunk-2X6QYQ3Q.js';
+export { THEME_CSS, THEME_STYLE_ID, installOfficeUiTheme } from './chunk-2X6QYQ3Q.js';
+import { registerControls } from './chunk-LKLZOPTO.js';
+export { CONTROL_DEFINERS, DEFAULT_OFFICE_PROFILE, EMPTY_MENU_STATE, OFFICE_AVATAR_SWATCHES, OFFICE_PROFILE_STORAGE_KEY, OFFICE_TITLE_BAR_SEARCH_LIMIT, OFFICE_TOAST_VISIBLE_LIMIT, attachKeyTips, clampFlyoutPosition, clampOptionNumber, clearOfficeProfile, defineAccount, defineBackstage, defineButton, defineCheckbox, defineCommandSearch, defineContextMenu, defineDialog, defineDialogFooter, defineFindBar, defineGallery, defineIcon, defineMenuButton, defineMenuItem, defineMenuSeparator, defineOptionsDialog, definePasteOptions, definePrintPreview, defineRadio, defineReadOnlyBanner, defineRibbon, defineRibbonGroup, defineRibbonSection, defineRibbonStack, defineRibbonToggle, defineRuler, defineSearchField, defineSelect, defineStatusBar, defineStatusItem, defineSwitch, defineTabStrip, defineTitleBar, defineToasts, defineToolbar, defineZoomSlider, glyph, nextEnabledIndex, parseSvgPreview, profileInitials, readOfficeProfile, registerControls, rulerDivisions, sanitizeOfficeProfile, typeAheadIndex, writeOfficeProfile } from './chunk-LKLZOPTO.js';
+import { defineSmartArt } from './chunk-3MDKXKKQ.js';
+export { OfficeUiSmartArt, defineSmartArt, renderDiagramDrawing } from './chunk-3MDKXKKQ.js';
+import { TEAMS_TAGS, registerTeams } from './chunk-HNGJI5EZ.js';
+export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsElement, colorFor, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, formatElapsed, formatSize, formatTime, icon, registerTeams, withStyles } from './chunk-HNGJI5EZ.js';
+export { createIconSvg, getIcon, listIcons, paintIcon, registerIcon } from './chunk-HZ422LTR.js';
+import { definePresence } from './chunk-E47762NY.js';
+export { OfficeUiPresence, definePresence, initialsOf, participantsFromAwareness } from './chunk-E47762NY.js';
+export { CONTRACT_REVISION, OfficeElement, controlStyles, flag, readFlag, triState, valueOn, withTokens } from './chunk-5A4REH6T.js';
+export { COMPACT, FOCUS_RING, OFFICE_TOKENS, TOUCH, tok } from './chunk-HSJH6SUW.js';
 
 // src/index.ts
 var OFFICE_UI_TAGS = [
@@ -48,7 +50,8 @@ var OFFICE_UI_TAGS = [
   "office-ui-ribbon-section",
   "office-ui-gallery",
   "office-ui-presence",
-  "office-ui-smartart"
+  "office-ui-smartart",
+  ...TEAMS_TAGS
 ];
 function registerOfficeUi(options = {}) {
   if (typeof window === "undefined" || !window.customElements) return;
@@ -56,6 +59,7 @@ function registerOfficeUi(options = {}) {
   registerControls();
   definePresence();
   defineSmartArt();
+  registerTeams();
 }
 
 export { OFFICE_UI_TAGS, registerOfficeUi };

package/dist/menu/command-search.d.ts

@@ -0,0 +1,74 @@
+import { type PropertyValues } from 'lit';
+import { OfficeElement } from '../base.js';
+/** One searchable command: label and optional keywords; disabled commands show their reason. */
+export interface OfficeSearchCommand {
+    id: string;
+    label: string;
+    keywords?: string;
+    /** Where the command lives, shown under the label (for example "Home › Paragraph"). */
+    description?: string;
+    disabled?: boolean;
+    title?: string;
+}
+/**
+ * Office's "Tell me what you want to do" box. Set `commands` (`OfficeSearchCommand[]`); typing
+ * lists up to `limit` (default 8) matches by label or keywords in a top-layer listbox.
+ * ArrowUp/Down move, Enter or click run an enabled match (`office-command` `{ command }`),
+ * Escape closes then clears. Disabled matches stay visible with their reason. Attributes:
+ * `placeholder`, `label` (accessible name), `limit`. Setting `commands` never emits.
+ */
+export declare class OfficeUiCommandSearch extends OfficeElement {
+    static shadowRootOptions: {
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry | null;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+        delegatesFocus: boolean;
+    };
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        placeholder: {
+            type: StringConstructor;
+        };
+        label: {
+            type: StringConstructor;
+        };
+        limit: {
+            type: StringConstructor;
+        };
+        found: {
+            state: boolean;
+        };
+        active: {
+            state: boolean;
+        };
+        isOpen: {
+            state: boolean;
+        };
+    };
+    placeholder: string | null;
+    label: string | null;
+    limit: string | null;
+    found: OfficeSearchCommand[];
+    active: number;
+    isOpen: boolean;
+    private items;
+    private readonly uid;
+    constructor();
+    get commands(): OfficeSearchCommand[];
+    set commands(value: readonly OfficeSearchCommand[]);
+    disconnectedCallback(): void;
+    private get input();
+    private get list();
+    private search;
+    private hide;
+    private move;
+    private choose;
+    private onKey;
+    /** The listbox is a top-layer popover below the field: show or hide it as `isOpen` changes. */
+    protected updated(changed: PropertyValues<this>): void;
+    private optionTemplates;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineCommandSearch: import("../registry.js").Definer;

package/dist/menu/context-menu.d.ts

@@ -0,0 +1,89 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { OfficeElement } from '../base.js';
+import { type OfficeMenuState } from './menu-model.js';
+/**
+ * Office's right-click menu, in two modes sharing keyboard, type-ahead and dismissal:
+ *
+ * - **Children** (self-managed): `office-ui-menu-item` and `office-ui-menu-separator` children.
+ *   `openAt(x, y)` shows it in the popover top layer, kept inside the viewport; `close()` hides it.
+ *   Choosing an item closes the menu and its `office-command` bubbles to the host.
+ * - **Controlled** (moved from pptx-viewer `pptx-ui-context-menu`): set `state`
+ *   (`{ x, y, label, items: [{ id, label, separatorBefore?, heading?, danger?, disabled?,
+ *   checked?, icon? }], markers?, zIndex?, autoFocus? }`). The host is the fixed box at the
+ *   pointer, clamped into the window. It emits `office-menu-request` `{ id }` when a row is chosen
+ *   and `office-menu-close` `{ reason: 'escape' | 'outside' | 'tab' }` when dismissed, and never
+ *   closes itself: the host removes it or clears its items. While open it takes focus on the first
+ *   enabled row and returns focus to the opener when it goes away, unless something else took it.
+ *
+ * Arrow keys, Home, End and type-ahead (repeating a letter cycles) move between enabled rows.
+ * Static `requestEvent`, `closeEvent` and `markerPattern` let a product keep its published names.
+ */
+export declare class OfficeUiContextMenu extends OfficeElement {
+    static requestEvent: string;
+    static closeEvent: string;
+    static markerPattern: RegExp;
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        label: {
+            type: StringConstructor;
+        };
+        open: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+            attribute: string;
+        };
+    };
+    label: string | null;
+    open: boolean;
+    private model;
+    private controlled;
+    private returnFocus;
+    private outside;
+    private active;
+    private focused;
+    private query;
+    private queryTimer;
+    private markers;
+    private listening;
+    private opener;
+    constructor();
+    private get panel();
+    private get rows();
+    private config;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private typeAhead;
+    private isTypeAhead;
+    private items;
+    /** Show at client coordinates; focus the first enabled item. */
+    openAt(x: number, y: number): void;
+    close(): void;
+    private closed;
+    private onChildKey;
+    get state(): OfficeMenuState;
+    set state(value: OfficeMenuState);
+    private deepActive;
+    protected willUpdate(changed: PropertyValues<this>): void;
+    protected updated(changed: PropertyValues<this>): void;
+    /** Position the open menu, listen for dismissal and keep focus on the active row. */
+    private settle;
+    private applyMarkers;
+    private place;
+    private focusRow;
+    private onRowKey;
+    private onRowOver;
+    private dismiss;
+    private readonly onDocumentKey;
+    private readonly onDocumentPointer;
+    private listen;
+    private stopListening;
+    private row;
+    /** Rows with their rules and headings; a heading opens a labelled group for the rows after it. */
+    private rowTemplates;
+    protected render(): TemplateResult<1>;
+}
+export declare const defineContextMenu: import("../registry.js").Definer;

package/dist/menu/menu-button.d.ts

@@ -0,0 +1,77 @@
+import { OfficeElement } from '../base.js';
+/**
+ * Dropdown command with a menu of `office-ui-menu-item` children (Office's Find, Layers,
+ * Align). With a `command` attribute it is a split button: the main part emits that command
+ * and the caret opens the menu. Attributes: `label`, `icon`, `command`, `variant="stacked"`, `icon-only`,
+ * `disabled`, `title`, `keyshortcuts`. The menu uses the top layer (`popover`) so ribbon
+ * overflow never clips it. Keyboard: Enter, Space or ArrowDown open; arrows, Home and End move;
+ * Escape and Tab close; focus returns to the trigger. Choosing an item closes the menu; its
+ * `office-command` bubbles to the host.
+ */
+export declare class OfficeUiMenuButton extends OfficeElement {
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        label: {
+            type: StringConstructor;
+        };
+        icon: {
+            type: StringConstructor;
+        };
+        command: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
+        keyshortcuts: {
+            type: StringConstructor;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        iconOnly: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+            attribute: string;
+        };
+        open: {
+            state: boolean;
+        };
+    };
+    label: string;
+    icon: string | null;
+    command: string | null;
+    keyshortcuts: string | null;
+    disabled: boolean;
+    iconOnly: boolean;
+    open: boolean;
+    private outside;
+    /** `title` is a native attribute, so it is watched rather than declared as a property. */
+    static get observedAttributes(): string[];
+    constructor();
+    attributeChangedCallback(name: string, old: string | null, value: string | null): void;
+    disconnectedCallback(): void;
+    private get panel();
+    private get split();
+    private get nativePopover();
+    private items;
+    private toggle;
+    private show;
+    /** Keep the open menu inside the viewport: flip left of the trigger's right edge if needed. */
+    private place;
+    private hide;
+    private closed;
+    private onMain;
+    private onTriggerKey;
+    private onMenuKey;
+    protected willUpdate(): void;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineMenuButton: import("../registry.js").Definer;

package/dist/menu/menu-item.d.ts

@@ -0,0 +1,52 @@
+import { OfficeElement } from '../base.js';
+/**
+ * One menu entry: `command`, `label`, `icon`, `disabled`, `checked` (renders a
+ * `menuitemcheckbox`), `title`. Activation emits `office-command` `{ command }`.
+ */
+export declare class OfficeUiMenuItem extends OfficeElement {
+    static shadowRootOptions: {
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry | null;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+        delegatesFocus: boolean;
+    };
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        label: {
+            type: StringConstructor;
+        };
+        icon: {
+            type: StringConstructor;
+        };
+        command: {
+            type: StringConstructor;
+        };
+        checked: {
+            type: StringConstructor;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+    };
+    label: string;
+    icon: string | null;
+    command: string | null;
+    checked: string | null;
+    disabled: boolean;
+    /** `title` is a native attribute, so it is watched rather than declared as a property. */
+    static get observedAttributes(): string[];
+    constructor();
+    attributeChangedCallback(name: string, old: string | null, value: string | null): void;
+    /** Focus the menuitem itself, so arrow navigation never depends on delegatesFocus. */
+    focus(options?: FocusOptions): void;
+    private onClick;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineMenuItem: import("../registry.js").Definer;

package/dist/{menu-model.d.ts → menu/menu-model.d.ts}

@@ -20,6 +20,8 @@ export interface OfficeMenuItem {
     checked?: boolean;
     /** A registered icon drawn before the label. */
     icon?: string;
+    /** Tooltip, for example why a disabled row is unavailable. */
+    title?: string;
 }
 /** Everything a controlled menu needs to draw. */
 export interface OfficeMenuState {

package/dist/menu/menu-separator.d.ts

@@ -0,0 +1,7 @@
+import { OfficeElement } from '../base.js';
+/** A `role="separator"` rule between groups of menu items. */
+export declare class OfficeUiMenuSeparator extends OfficeElement {
+    static styles: import("lit").CSSResult[];
+    protected willUpdate(): void;
+}
+export declare const defineMenuSeparator: import("../registry.js").Definer;

package/dist/notices/paste-options.d.ts

@@ -0,0 +1,41 @@
+import { OfficeElement } from '../base.js';
+export interface OfficePasteOption {
+    /** Echoed back as `format` in the request event. */
+    id: string;
+    /** Translated label. */
+    label: string;
+}
+export interface OfficePasteOptionsState {
+    /** Right edge of the pasted object in viewport pixels. */
+    left: number;
+    /** Bottom edge of the pasted object in viewport pixels. */
+    top: number;
+    options: readonly OfficePasteOption[];
+    /** Toolbar accessible name. */
+    label?: string;
+}
+/**
+ * `<office-ui-paste-options>`: the Paste Options strip Word, Excel and PowerPoint offer after a
+ * paste, anchored one `--office-space-1` step past the pasted object's bottom-right corner (the
+ * host is the fixed box). A choice emits `office-paste-options-request` `{ format }` then
+ * `office-paste-options-dismiss`; the first pointerdown or keydown outside (Escape inside too)
+ * dismisses, armed one task after connecting so the paste gesture does not. Text arrives
+ * translated; event names and the test id prefix are static fields a product subclass may override.
+ */
+export declare class OfficeUiPasteOptions extends OfficeElement {
+    static requestEvent: string;
+    static dismissEvent: string;
+    static testIdPrefix: string;
+    static styles: import("lit").CSSResult[];
+    private model;
+    get state(): OfficePasteOptionsState;
+    set state(value: OfficePasteOptionsState);
+    private disarm;
+    private dismiss;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private choose;
+    protected willUpdate(): void;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const definePasteOptions: import("../registry.js").Definer;

package/dist/notices/read-only-banner.d.ts

@@ -0,0 +1,53 @@
+import { type PropertyValues } from 'lit';
+import { OfficeElement } from '../base.js';
+export interface OfficeReadOnlyBannerState {
+    /** Why read-only is recommended; mirrored onto the host's `data-kind`. */
+    kind: string | null;
+    /** Translated reason. */
+    message: string;
+    /** Swap Edit anyway / Dismiss for the inline password form. */
+    passwordPromptOpen?: boolean;
+    /** Translated password error, or null. */
+    passwordError?: string | null;
+    /** Disables the form while a submitted password is checked. */
+    checkingPassword?: boolean;
+    labels?: {
+        title?: string;
+        editAnyway?: string;
+        dismiss?: string;
+        passwordLabel?: string;
+        passwordPlaceholder?: string;
+        unlock?: string;
+        cancel?: string;
+    };
+}
+export type OfficeReadOnlyBannerIntent = {
+    id: 'editAnyway' | 'dismiss' | 'cancelPassword';
+} | {
+    id: 'submitPassword';
+    password: string;
+};
+/**
+ * `<office-ui-read-only-banner>`: controlled banner for "read-only recommended", which Word, Excel
+ * and PowerPoint all show. The host owns the lock (Edit anyway, Dismiss, the password check); the
+ * element owns the markup, the password form and its focus. Each activation emits
+ * `office-read-only-request` with an {@link OfficeReadOnlyBannerIntent}. Text arrives translated;
+ * the event name and test id prefix are static fields a product subclass may override.
+ */
+export declare class OfficeUiReadOnlyBanner extends OfficeElement {
+    static requestEvent: string;
+    static testIdPrefix: string;
+    static styles: import("lit").CSSResult[];
+    private model;
+    get state(): OfficeReadOnlyBannerState;
+    set state(value: OfficeReadOnlyBannerState);
+    private promptWasOpen;
+    private send;
+    private get input();
+    private onSubmit;
+    protected willUpdate(): void;
+    /** The password field takes focus when the prompt opens and is cleared when it closes. */
+    protected updated(_changed: PropertyValues<this>): void;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineReadOnlyBanner: import("../registry.js").Definer;

package/dist/notices/toasts.d.ts

@@ -0,0 +1,40 @@
+import { type PropertyValues } from 'lit';
+import { OfficeElement } from '../base.js';
+/** Toasts rendered before the rest collapse into a "+N" count. */
+export declare const OFFICE_TOAST_VISIBLE_LIMIT = 5;
+export interface OfficeToast {
+    readonly id: string;
+    /** Machine-readable code, mirrored to `data-code`. */
+    readonly code?: string;
+    readonly severity: 'info' | 'warning';
+    /** Translated message. */
+    readonly message: string;
+}
+export interface OfficeToastsState {
+    toasts: readonly OfficeToast[];
+    /** Extra toasts a host already trimmed off the list it passes. */
+    overflowCount?: number;
+    labels?: {
+        title?: string;
+        dismissAll?: string;
+        dismiss?: string;
+    };
+}
+/**
+ * `<office-ui-toasts>`: a stack of load or compatibility notices. Toasts never auto-hide;
+ * dismissal is the host's decision through `office-toasts-request` `{ id: 'dismissAll' }` or
+ * `{ id: 'dismiss', toastId }`. The host positions the element. Hidden when empty. Text arrives
+ * already translated; the event name and test id prefix are static fields a product subclass
+ * may override.
+ */
+export declare class OfficeUiToasts extends OfficeElement {
+    static requestEvent: string;
+    static testIdPrefix: string;
+    static styles: import("lit").CSSResult[];
+    private model;
+    get state(): OfficeToastsState;
+    set state(value: OfficeToastsState);
+    protected willUpdate(_changed: PropertyValues<this>): void;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineToasts: import("../registry.js").Definer;