ooxml-ui 0.20.0 → 0.22.0

package/dist/controls.d.ts

@@ -1,51 +1,61 @@
-import { defineDialogFooter, defineToasts } from './chrome-controls.js';
-import { definePasteOptions, defineReadOnlyBanner } from './document-notices.js';
-import { defineRadio } from './radio.js';
-import { defineRibbonToggle } from './ribbon-toggle.js';
-import { defineSearchField } from './search-field.js';
-import { defineBackstage } from './backstage.js';
-import { defineFindBar } from './find-bar.js';
-import { definePrintPreview } from './print-preview.js';
-import { defineRibbon } from './ribbon-tabs.js';
-import { defineRibbonSection } from './ribbon-section.js';
-import { defineGallery } from './gallery.js';
-import { defineRuler } from './ruler.js';
-import { defineAccount } from './account.js';
-import { defineButton } from './button.js';
-import { defineCheckbox, defineSwitch } from './checkable.js';
-import { defineDialog } from './dialog.js';
-import { defineIcon } from './icons.js';
-import { defineCommandSearch } from './command-search.js';
-import { defineContextMenu, defineMenuSeparator } from './context-menu.js';
-import { defineMenuButton, defineMenuItem } from './menu.js';
-import { defineOptionsDialog } from './options.js';
-import { defineRibbonGroup, defineRibbonStack, defineToolbar } from './ribbon.js';
-import { defineSelect } from './select.js';
-import { defineStatusBar, defineStatusItem } from './status-bar.js';
-import { defineTabStrip } from './tab-strip.js';
-import { defineTitleBar } from './title-bar.js';
-import { defineZoomSlider } from './zoom-slider.js';
+import { defineDialogFooter } from './dialog/dialog-footer.js';
+import { defineToasts } from './notices/toasts.js';
+import { definePasteOptions } from './notices/paste-options.js';
+import { defineReadOnlyBanner } from './notices/read-only-banner.js';
+import { defineRadio } from './form/radio.js';
+import { defineRibbonToggle } from './ribbon/ribbon-toggle.js';
+import { defineSearchField } from './form/search-field.js';
+import { defineBackstage } from './chrome/backstage.js';
+import { defineFindBar } from './chrome/find-bar.js';
+import { definePrintPreview } from './chrome/print-preview.js';
+import { defineRibbon } from './ribbon/ribbon-tabs.js';
+import { defineRibbonSection } from './ribbon/ribbon-section.js';
+import { defineGallery } from './ribbon/gallery.js';
+import { defineRuler } from './chrome/ruler.js';
+import { defineAccount } from './chrome/account.js';
+import { defineButton } from './ribbon/button.js';
+import { defineCheckbox } from './form/checkbox.js';
+import { defineSwitch } from './form/switch.js';
+import { defineDialog } from './dialog/dialog.js';
+import { defineIcon } from './icon.js';
+import { defineCommandSearch } from './menu/command-search.js';
+import { defineContextMenu } from './menu/context-menu.js';
+import { defineMenuSeparator } from './menu/menu-separator.js';
+import { defineMenuButton } from './menu/menu-button.js';
+import { defineMenuItem } from './menu/menu-item.js';
+import { defineOptionsDialog } from './dialog/options-dialog.js';
+import { defineRibbonGroup } from './ribbon/ribbon-group.js';
+import { defineRibbonStack } from './ribbon/ribbon-stack.js';
+import { defineToolbar } from './ribbon/ribbon-toolbar.js';
+import { defineSelect } from './form/select.js';
+import { defineStatusBar } from './chrome/status-bar.js';
+import { defineStatusItem } from './chrome/status-item.js';
+import { defineTabStrip } from './chrome/tab-strip.js';
+import { defineTitleBar } from './chrome/title-bar.js';
+import { defineZoomSlider } from './form/zoom-slider.js';
 export { defineAccount, defineDialogFooter, definePasteOptions, defineRadio, defineReadOnlyBanner, defineRibbonToggle, defineSearchField, defineToasts, defineBackstage, defineFindBar, defineGallery, definePrintPreview, defineRibbon, defineRuler, defineButton, defineCheckbox, defineCommandSearch, defineContextMenu, defineDialog, defineIcon, defineMenuButton, defineMenuItem, defineMenuSeparator, defineOptionsDialog, defineRibbonGroup, defineRibbonSection, defineRibbonStack, defineSelect, defineStatusBar, defineStatusItem, defineSwitch, defineTabStrip, defineTitleBar, defineToolbar, defineZoomSlider, };
-export type { OfficeCommandEvent } from './button.js';
-export type { OfficeDialogCloseEvent, OfficeDialogCloseReason } from './dialog.js';
-export type { OfficeSelectOption } from './select.js';
-export type { OfficeStatusActivateEvent, OfficeStatusBarState, OfficeStatusButton, OfficeStatusText, } from './status-bar.js';
-export type { OfficeTab, OfficeTabSelectEvent } from './tab-strip.js';
-export type { OfficeSearchCommand } from './command-search.js';
-export { OFFICE_TITLE_BAR_SEARCH_LIMIT, type OfficeQuickAccessItem, type OfficeTitleBarAutosave, type OfficeTitleBarCommand, type OfficeTitleBarPlacement, type OfficeTitleBarSearch, type OfficeTitleBarSearchDetail, type OfficeTitleBarState, type OfficeTitleBarTone, } from './title-bar.js';
+export type { OfficeCommandEvent } from './ribbon/button.js';
+export type { OfficeDialogCloseEvent, OfficeDialogCloseReason } from './dialog/dialog.js';
+export type { OfficeSelectOption } from './form/select.js';
+export type { OfficeStatusActivateEvent, OfficeStatusBarState, OfficeStatusButton, OfficeStatusText, } from './chrome/status-bar.js';
+export type { OfficeTab, OfficeTabSelectEvent } from './chrome/tab-strip.js';
+export type { OfficeSearchCommand } from './menu/command-search.js';
+export { OFFICE_TITLE_BAR_SEARCH_LIMIT, type OfficeQuickAccessItem, type OfficeTitleBarAutosave, type OfficeTitleBarCommand, type OfficeTitleBarPlacement, type OfficeTitleBarSearch, type OfficeTitleBarSearchDetail, type OfficeTitleBarState, type OfficeTitleBarTone, } from './chrome/title-bar.js';
 export { attachKeyTips, type KeyTipsHandle } from './keytips.js';
-export type { OfficeBackstageCloseEvent, OfficeBackstageItem, OfficeBackstageSelectEvent, } from './backstage.js';
-export type { OfficeFindInputEvent, OfficeFindStepEvent } from './find-bar.js';
-export type { OfficePrintPreviewPageEvent } from './print-preview.js';
-export type { OfficeRibbonSelectEvent } from './ribbon-tabs.js';
-export type { OfficeRibbonCommandView, OfficeRibbonGroupView } from './ribbon-section.js';
-export { parseSvgPreview, type OfficeGalleryItem, type OfficeGalleryPickEvent, type OfficeGallerySection, type OfficeGalleryState, } from './gallery.js';
-export { rulerDivisions } from './ruler.js';
-export { clampFlyoutPosition, EMPTY_MENU_STATE, nextEnabledIndex, typeAheadIndex, type FlyoutPositionInput, type OfficeMenuCloseReason, type OfficeMenuItem, type OfficeMenuState, } from './menu-model.js';
-export { OFFICE_TOAST_VISIBLE_LIMIT, type OfficeDialogFooterAction, type OfficeDialogFooterState, type OfficeDialogFooterVariant, type OfficeToast, type OfficeToastsState, } from './chrome-controls.js';
-export type { OfficePasteOption, OfficePasteOptionsState, OfficeReadOnlyBannerIntent, OfficeReadOnlyBannerState, } from './document-notices.js';
-export { clearOfficeProfile, DEFAULT_OFFICE_PROFILE, OFFICE_AVATAR_SWATCHES, OFFICE_PROFILE_STORAGE_KEY, profileInitials, readOfficeProfile, sanitizeOfficeProfile, writeOfficeProfile, type OfficeProfile, type OfficeProfileChangeEvent, } from './account.js';
-export { clampOptionNumber, type OfficeOptionCategory, type OfficeOptionChoice, type OfficeOptionControl, type OfficeOptionSection, type OfficeOptionsChangeEvent, type OfficeOptionValue, type OfficeOptionValues, } from './options.js';
+export type { OfficeBackstageCloseEvent, OfficeBackstageItem, OfficeBackstageSelectEvent, } from './chrome/backstage.js';
+export type { OfficeFindInputEvent, OfficeFindStepEvent } from './chrome/find-bar.js';
+export type { OfficePrintPreviewPageEvent } from './chrome/print-preview.js';
+export type { OfficeRibbonSelectEvent } from './ribbon/ribbon-tabs.js';
+export type { OfficeRibbonCommandView, OfficeRibbonGroupView } from './ribbon/ribbon-section.js';
+export { parseSvgPreview, type OfficeGalleryItem, type OfficeGalleryPickEvent, type OfficeGallerySection, type OfficeGalleryState, } from './ribbon/gallery.js';
+export { rulerDivisions } from './chrome/ruler.js';
+export { clampFlyoutPosition, EMPTY_MENU_STATE, nextEnabledIndex, typeAheadIndex, type FlyoutPositionInput, type OfficeMenuCloseReason, type OfficeMenuItem, type OfficeMenuState, } from './menu/menu-model.js';
+export type { OfficeDialogFooterAction, OfficeDialogFooterState, OfficeDialogFooterVariant, } from './dialog/dialog-footer.js';
+export { OFFICE_TOAST_VISIBLE_LIMIT, type OfficeToast, type OfficeToastsState, } from './notices/toasts.js';
+export type { OfficePasteOption, OfficePasteOptionsState } from './notices/paste-options.js';
+export type { OfficeReadOnlyBannerIntent, OfficeReadOnlyBannerState, } from './notices/read-only-banner.js';
+export { clearOfficeProfile, DEFAULT_OFFICE_PROFILE, OFFICE_AVATAR_SWATCHES, OFFICE_PROFILE_STORAGE_KEY, profileInitials, readOfficeProfile, sanitizeOfficeProfile, writeOfficeProfile, type OfficeProfile, type OfficeProfileChangeEvent, } from './chrome/account-profile.js';
+export { clampOptionNumber, type OfficeOptionCategory, type OfficeOptionChoice, type OfficeOptionControl, type OfficeOptionSection, type OfficeOptionsChangeEvent, type OfficeOptionValue, type OfficeOptionValues, } from './dialog/options-dialog.js';
 /** Every control of this entry. */
 export declare const CONTROL_DEFINERS: readonly [import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer, import("./registry.js").Definer];
 /** Idempotent, SSR-safe (no-op without a DOM). */

package/dist/controls.js

@@ -1,5 +1,5 @@
-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 { defineIcon } from './chunk-W5PYFBEZ.js';
-import './chunk-24MMSCKW.js';
-import './chunk-UEJ4F33J.js';
-import './chunk-G3LAGZEW.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, nextEnabledIndex, parseSvgPreview, profileInitials, readOfficeProfile, registerControls, rulerDivisions, sanitizeOfficeProfile, typeAheadIndex, writeOfficeProfile } from './chunk-LKLZOPTO.js';
+import './chunk-HZ422LTR.js';
+import './chunk-E47762NY.js';
+import './chunk-5A4REH6T.js';
+import './chunk-HSJH6SUW.js';

package/dist/dialog/dialog-footer.d.ts

@@ -0,0 +1,40 @@
+import { OfficeElement } from '../base.js';
+export type OfficeDialogFooterVariant = 'secondary' | 'primary' | 'warning' | 'danger';
+export interface OfficeDialogFooterAction {
+    /** Stable id echoed back in the request event. */
+    id: string;
+    /** Translated label and accessible name. */
+    label: string;
+    variant?: OfficeDialogFooterVariant;
+    /** A registered icon name (for example `trash`, `pencil`, `restore`, `print`, `check`). */
+    icon?: string;
+    disabled?: boolean;
+    /** Work in flight: disabled, `aria-busy` and a spinner. */
+    busy?: boolean;
+    title?: string;
+    /** `start` pins a tertiary action (Remove link, Reset all) to the left edge. */
+    align?: 'start' | 'end';
+    testId?: string;
+}
+export interface OfficeDialogFooterState {
+    actions: readonly OfficeDialogFooterAction[];
+}
+/**
+ * `<office-ui-dialog-footer>`: a dialog's action row (Cancel, OK, Apply...). Not a dialog shell.
+ * Set `state`; each button emits `office-dialog-footer-request` `{ id }`. Buttons are keyed by
+ * action id and patched in place, so focus survives state changes. `focusAction(id)`. Text arrives
+ * already translated; the event name is a static field a product subclass may override.
+ */
+export declare class OfficeUiDialogFooter extends OfficeElement {
+    static requestEvent: string;
+    static testIdPrefix: string;
+    static styles: import("lit").CSSResult[];
+    private model;
+    get state(): OfficeDialogFooterState;
+    set state(value: OfficeDialogFooterState);
+    /** Move keyboard focus to an action, for example the primary one when a dialog opens. */
+    focusAction(id: string): void;
+    private classes;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineDialogFooter: import("../registry.js").Definer;

package/dist/dialog/dialog.d.ts

@@ -0,0 +1,52 @@
+import { type PropertyValues } from 'lit';
+import { OfficeElement } from '../base.js';
+export type OfficeDialogCloseReason = 'escape' | 'close-button' | 'backdrop' | 'api';
+/** Cancelable: `preventDefault()` keeps the dialog open. */
+export type OfficeDialogCloseEvent = CustomEvent<{
+    reason: OfficeDialogCloseReason;
+}>;
+/**
+ * Modal dialog shell. `open` and `heading` attributes, `dismissible` (default true; set
+ * `dismissible="false"` to ignore Escape and backdrop). Default slot is the body, `slot="footer"`
+ * holds actions. `role="dialog"`, `aria-modal`, labelled by the heading. Escape, the close button
+ * and the backdrop emit a cancelable `office-dialog-close` and close unless prevented; focus
+ * moves in on open, is trapped with Tab, and returns to the previously focused element on close.
+ */
+export declare class OfficeUiDialog extends OfficeElement {
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        open: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        heading: {
+            type: StringConstructor;
+        };
+        dismissible: {
+            type: StringConstructor;
+        };
+    };
+    open: boolean;
+    heading: string;
+    dismissible: string | null;
+    private returnFocus;
+    constructor();
+    show(): void;
+    /** Programmatic close; still emits `office-dialog-close` (reason `api`). */
+    close(): void;
+    private requestClose;
+    private get box();
+    private get closeButton();
+    private focusables;
+    private onOpen;
+    private onClose;
+    private onKey;
+    /** Focus moves in when the dialog opens (also when it connects open) and back when it closes. */
+    protected updated(changed: PropertyValues<this>): void;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineDialog: import("../registry.js").Definer;

package/dist/{options.d.ts → dialog/options-dialog.d.ts}

@@ -1,3 +1,5 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { OfficeElement } from '../base.js';
 /**
  * Office File > Options dialog. Products describe their categories as data; the element renders
  * the category list, the pane and OK/Cancel, and reports the edited values. Generalised from
@@ -62,5 +64,48 @@ export declare function clampOptionNumber(raw: string, min: number, max: number)
  * attribute). Edits stay in a draft until OK, which emits `office-options-change` and closes;
  * Cancel, Escape and the close button discard them. `heading` defaults to "Options".
  */
-export declare const defineOptionsDialog: import("./registry.js").Definer;
+export declare class OfficeUiOptionsDialog extends OfficeElement {
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        open: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        heading: {
+            type: StringConstructor;
+        };
+        categories: {
+            attribute: boolean;
+        };
+        active: {
+            state: boolean;
+        };
+    };
+    open: boolean;
+    heading: string | null;
+    categories: readonly OfficeOptionCategory[];
+    active: string;
+    private committed;
+    private draft;
+    constructor();
+    get values(): OfficeOptionValues;
+    set values(value: OfficeOptionValues);
+    /** The selected category id. */
+    get category(): string;
+    set category(id: string);
+    show(): void;
+    close(): void;
+    private commit;
+    private onNavKey;
+    protected willUpdate(changed: PropertyValues<this>): void;
+    private set;
+    private control;
+    private pane;
+    protected render(): TemplateResult<1>;
+}
+export declare const defineOptionsDialog: import("../registry.js").Definer;
 export {};

package/dist/form/checkable.d.ts

@@ -0,0 +1,49 @@
+import { OfficeElement } from '../base.js';
+/**
+ * Shared implementation of the two-state controls (checkbox, switch). `checked`, `disabled` and
+ * `value` attributes and properties; Space (and Enter for the switch) toggles; `input` then
+ * `change` bubble from the host; form-associated through ElementInternals where supported;
+ * setting a property is silent.
+ */
+export declare abstract class OfficeUiCheckable extends OfficeElement {
+    static formAssociated: boolean;
+    static properties: {
+        checked: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        value: {
+            type: StringConstructor;
+            converter: {
+                fromAttribute: (value: string | null) => string;
+            };
+        };
+    };
+    checked: boolean;
+    disabled: boolean;
+    value: string;
+    protected abstract readonly semantics: 'checkbox' | 'switch';
+    private readonly internals;
+    private defaultChecked;
+    constructor();
+    connectedCallback(): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
+    private toggle;
+    /** The host carries the semantics: role, state, tab stop and form value. */
+    protected willUpdate(): void;
+    /** The tick, shown through CSS when `checked`. */
+    protected renderCheck(): import("lit").TemplateResult<1>;
+}

package/dist/form/checkbox.d.ts

@@ -0,0 +1,8 @@
+import { OfficeUiCheckable } from './checkable.js';
+/** `<office-ui-checkbox checked disabled value aria-label>`. */
+export declare class OfficeUiCheckbox extends OfficeUiCheckable {
+    static styles: import("lit").CSSResult[];
+    protected readonly semantics = "checkbox";
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineCheckbox: import("../registry.js").Definer;

package/dist/form/radio.d.ts

@@ -0,0 +1,68 @@
+import { OfficeElement } from '../base.js';
+/**
+ * Radio button with a native-like contract. Moved from pptx-viewer `pptx-ui-radio`. Radios
+ * sharing a `name` in one tree and form are a WAI-ARIA radiogroup with one roving tab stop (the
+ * checked radio, else the first enabled one). Arrows move, select and focus the next enabled
+ * radio (wrapping), Home and End jump to the ends, Space selects. Checking programmatically
+ * silently unchecks peers; only user activation emits `input` then `change`, on the radio that
+ * becomes checked. Disabled radios are inert.
+ */
+export declare class OfficeUiRadio extends OfficeElement {
+    static formAssociated: boolean;
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        checked: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        value: {
+            type: StringConstructor;
+            converter: {
+                fromAttribute: (value: string | null) => string;
+            };
+        };
+        name: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
+    };
+    checked: boolean;
+    disabled: boolean;
+    value: string;
+    name: string;
+    private readonly internals;
+    private defaultChecked;
+    private scope;
+    private autoNamed;
+    constructor();
+    get form(): HTMLFormElement | null;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
+    /** Check this radio and, for user intent, announce it. No-op when already checked. */
+    select(emit: boolean): void;
+    /**
+     * A custom element is not named by a wrapping `<label>` in every browser's accessibility
+     * tree, so mirror the label text into `aria-label` unless the host named it.
+     */
+    private syncName;
+    private peers;
+    private onKey;
+    /** The host carries the semantics: role, state, form value and the group's tab stop. */
+    protected willUpdate(): void;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineRadio: import("../registry.js").Definer;

package/dist/form/search-field.d.ts

@@ -0,0 +1,54 @@
+import { OfficeElement } from '../base.js';
+/**
+ * A single styled search input (title bar, recent files, panel filters). Moved from pptx-viewer
+ * `pptx-ui-search`. `value`, `placeholder`, `disabled`, `aria-label` (defaults to the
+ * placeholder) and `variant="titlebar"` (compact). `input` and `change` bubble from the host;
+ * setting `value` is silent. Tokens: `--office-field-*`.
+ */
+export declare class OfficeUiSearch extends OfficeElement {
+    static shadowRootOptions: {
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry | null;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+        delegatesFocus: boolean;
+    };
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        value: {
+            type: StringConstructor;
+        };
+        placeholder: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        variant: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
+    };
+    value: string;
+    placeholder: string | null;
+    disabled: boolean;
+    variant: string;
+    /** `aria-label` names the inner input, 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;
+    private get input();
+    focus(options?: FocusOptions): void;
+    select(): void;
+    private onInput;
+    private onChange;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineSearchField: import("../registry.js").Definer;

package/dist/{select-menu.d.ts → form/select-menu.d.ts}

@@ -1,6 +1,7 @@
 /**
- * Popup helpers of `office-ui-select`. Moved from pptx-viewer
- * (`packages/shared/src/web-components/select-menu.ts`, `select-trigger.ts`).
+ * Pure helpers of `office-ui-select` (choice data, popup placement, keyboard stepping). Moved
+ * from pptx-viewer (`packages/shared/src/web-components/select-menu.ts`). The markup is the
+ * element's own `render()`.
  */
 /** Mutations that can change a select's value, labels or font preview. */
 export declare const SELECT_OPTION_ATTRIBUTES: string[];
@@ -17,26 +18,15 @@ export interface SelectChoice {
 }
 /** Flatten `<option>` children, keeping optgroup labels and disabled or hidden state. */
 export declare function collectSelectChoices(options: HTMLOptionElement[]): SelectChoice[];
-/** Build the popup's options (only while it is open or has been opened). */
-export declare function renderSelectMenu(menu: HTMLElement, choices: SelectChoice[], value: string): void;
 /**
  * Prefer below the trigger, flipping above when that offers more room. Margins, the gap and the
  * height cap come from `--office-space-2`, `--office-space-1` and `--office-select-max-height`
  * (`--office-font-picker-max-height` for a font family picker).
  */
 export declare function positionSelectMenu(menu: HTMLElement, trigger: HTMLElement, host: HTMLElement): void;
-/** Expose the keyboard target while keeping the selected state separate. */
-export declare function markSelectActive(menu: HTMLElement, trigger: HTMLElement, active: number, open: boolean): void;
 /** The next enabled, visible option when moving with the arrow keys (wrapping). */
 export declare function nextSelectActive(choices: SelectChoice[], active: number, step: number): number;
 /** Options a PageUp/PageDown press moves, like the visible rows of a native listbox. */
 export declare const SELECT_PAGE_SIZE = 8;
 /** Jump a page of options up (-1) or down (+1), clamped to the nearest enabled option. */
 export declare function pageSelectActive(choices: SelectChoice[], active: number, direction: 1 | -1): number;
-/** Trigger with an `icon` slot, the value text and a chevron. */
-export declare function createSelectTrigger(doc: Document): {
-    trigger: HTMLButtonElement;
-    text: HTMLSpanElement;
-};
-/** Optional editable content (`slot="custom"`) stays in the light DOM so hosts own its events. */
-export declare function prependSelectCustomSlot(host: HTMLElement, menu: HTMLElement): void;

package/dist/form/select.d.ts

@@ -0,0 +1,115 @@
+import { type PropertyValues } from 'lit';
+import { OfficeElement } from '../base.js';
+import { type SelectChoice } from './select-menu.js';
+/** A programmatic choice; `<option>` elements satisfy the same shape. */
+export interface OfficeSelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+/**
+ * Single-select combobox. Moved from pptx-viewer `pptx-ui-select` (the declarative, most complete
+ * implementation). Choices come from `<option>` / `<optgroup>` children (with `data-display-label`,
+ * `data-description` and font previews through `style="font-family"`), or from the `options`
+ * property when there are none. `value`, `disabled`, `selectedIndex`, `aria-label`;
+ * `variant="ribbon-font"` (compact ribbon combo that accepts unlisted values, such as a typed font
+ * size) or `"ribbon-icon"`; `data-font-picker="family|size"`; an `icon` slot and a `custom` slot at
+ * the top of the popup. Keyboard: arrows, Home, End, PageUp/PageDown (8 options), typeahead,
+ * Enter/Space, Escape, Tab; disabled and hidden choices are skipped. The popup is a top-layer
+ * `popover`, flipped above the trigger when there is more room. `input` then `change` bubble on a
+ * user choice; setting a property is silent. Form-associated.
+ */
+export declare class OfficeUiSelect extends OfficeElement {
+    static formAssociated: boolean;
+    static shadowRootOptions: {
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry | null;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+        delegatesFocus: boolean;
+    };
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        value: {
+            type: StringConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        open: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        active: {
+            state: boolean;
+        };
+        choices: {
+            state: boolean;
+        };
+        opened: {
+            state: boolean;
+        };
+    };
+    disabled: boolean;
+    open: boolean;
+    active: number;
+    choices: SelectChoice[];
+    opened: boolean;
+    static get observedAttributes(): string[];
+    private readonly internals;
+    private readonly observer;
+    private readonly menuId;
+    private requested;
+    private data;
+    private refreshFrame;
+    private search;
+    private searchTimer;
+    private defaultValue;
+    constructor();
+    /** The `<option>` children, or the programmatic options when there are none. */
+    get options(): OfficeSelectOption[];
+    set options(next: OfficeSelectOption[]);
+    get value(): string;
+    set value(next: string);
+    get selectedIndex(): number;
+    set selectedIndex(index: number);
+    private get menu();
+    private get trigger();
+    focus(options?: FocusOptions): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private collect;
+    /** Re-read the choices after the `<option>` children or the `options` data changed. */
+    private refresh;
+    private isUsable;
+    private show;
+    private close;
+    /** The popup is a top-layer popover: show or hide it as `open` changes. */
+    private openPopup;
+    private closePopup;
+    private readonly onOutside;
+    private readonly position;
+    private move;
+    private commit;
+    private onKeyDown;
+    private typeAhead;
+    protected willUpdate(): void;
+    protected updated(changed: PropertyValues<this>): void;
+    private optionTemplates;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineSelect: import("../registry.js").Definer;

package/dist/form/switch.d.ts

@@ -0,0 +1,11 @@
+import { OfficeUiCheckable } from './checkable.js';
+/**
+ * `<office-ui-switch>`: same contract as the checkbox with `role="switch"`. It draws a real knob
+ * element, so hosts and tests can measure and style it.
+ */
+export declare class OfficeUiSwitch extends OfficeUiCheckable {
+    static styles: import("lit").CSSResult[];
+    protected readonly semantics = "switch";
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare const defineSwitch: import("../registry.js").Definer;