@zeyos/zx 4.3.4 → 4.4.0

package/dist/types/components/activity-list/activity-list.d.ts

@@ -0,0 +1,195 @@
+import { Component } from '../../core/component.js';
+export type ActivityItemOptions = import('../activity-item/activity-item.js').ActivityItemOptions;
+export type ActivityListContent = string | number | Node | Component | null;
+export type ActivityGroupReader = string | ((item: ActivityItemOptions, index: number) => unknown) | null;
+export type ActivityGroupLabel = (group: unknown, items: ActivityItemOptions[]) => ActivityListContent;
+export type ActivityGroup = {
+    /**
+     * Group identity returned by the configured reader.
+     */
+    id: unknown;
+    /**
+     * Activities in stable source order.
+     */
+    items: ActivityItemOptions[];
+};
+export type ActivityListOptions = {
+    /**
+     * Initial activities in host-supplied chronological order.
+     */
+    items?: ActivityItemOptions[];
+    /**
+     * Property or resolver used for stable grouping.
+     */
+    groupBy?: ActivityGroupReader;
+    /**
+     * Group-heading renderer.
+     */
+    groupLabel?: ActivityGroupLabel | null;
+    /**
+     * Accessible collection name.
+     */
+    label?: string;
+    /**
+     * Whether initial or incremental activity is loading.
+     */
+    loading?: boolean;
+    /**
+     * Placeholder rows shown for an empty loading list.
+     */
+    loadingCount?: number;
+    /**
+     * Loading status text.
+     */
+    loadingText?: string;
+    /**
+     * Empty-state content.
+     */
+    emptyText?: ActivityListContent;
+    /**
+     * Semantic group-heading level.
+     */
+    groupHeadingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * Default item-heading level.
+     */
+    itemHeadingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    ondatachange?: (event: CustomEvent<{
+        items: ActivityItemOptions[];
+    }>) => void;
+};
+/** @typedef {import('../activity-item/activity-item.js').ActivityItemOptions} ActivityItemOptions */
+/** @typedef {string|number|Node|Component|null} ActivityListContent */
+/** @typedef {string|((item:ActivityItemOptions,index:number)=>unknown)|null} ActivityGroupReader */
+/** @typedef {(group:unknown,items:ActivityItemOptions[])=>ActivityListContent} ActivityGroupLabel */
+/**
+ * @typedef {Object} ActivityGroup
+ * @property {unknown} id Group identity returned by the configured reader.
+ * @property {ActivityItemOptions[]} items Activities in stable source order.
+ */
+/**
+ * @typedef {Object} ActivityListOptions
+ * @property {ActivityItemOptions[]} [items=[]] Initial activities in host-supplied chronological order.
+ * @property {ActivityGroupReader} [groupBy=null] Property or resolver used for stable grouping.
+ * @property {ActivityGroupLabel|null} [groupLabel=null] Group-heading renderer.
+ * @property {string} [label='Activity'] Accessible collection name.
+ * @property {boolean} [loading=false] Whether initial or incremental activity is loading.
+ * @property {number} [loadingCount=3] Placeholder rows shown for an empty loading list.
+ * @property {string} [loadingText='Loading activity'] Loading status text.
+ * @property {ActivityListContent} [emptyText='No activity yet'] Empty-state content.
+ * @property {1|2|3|4|5|6} [groupHeadingLevel=2] Semantic group-heading level.
+ * @property {1|2|3|4|5|6} [itemHeadingLevel=3] Default item-heading level.
+ * @property {(event:CustomEvent<{items:ActivityItemOptions[]}>)=>void} [ondatachange]
+ */
+/**
+ * Accessible chronological activity collection with stable grouping, loading/empty states, and
+ * incremental update methods. Ordering stays host-controlled so paginated and live server results
+ * are never silently re-sorted. Item `zx-action` events bubble through the list naturally.
+ *
+ * @fires ActivityList#datachange
+ * @extends {Component<ActivityListOptions>}
+ */
+export declare class ActivityList extends Component<ActivityListOptions> {
+    _createdRoot: boolean;
+    _original: import("../../core/dom.js").TargetSnapshot;
+    _cleaned: boolean;
+    _items: any;
+    _loading: any;
+    _itemComponents: any[];
+    _groupSequence: number;
+    static cssName: string;
+    /** @type {Readonly<ActivityListOptions>} */
+    static defaults: Readonly<ActivityListOptions>;
+    /**
+     * Creates or enhances an activity collection.
+     * @param {Element|string|null} [target=null] Existing container, selector, or null.
+     * @param {ActivityListOptions} [options={}] Collection options.
+     */
+    constructor(target?: Element | string | null, options?: ActivityListOptions);
+    /** @returns {HTMLElement} */
+    render(): HTMLElement;
+    /**
+     * Replaces all activities.
+     * @param {ActivityItemOptions[]} items Activities in desired chronological order.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    setItems(items: ActivityItemOptions[], options?: {
+        silent?: boolean;
+    }): this;
+    /** Returns shallow descriptor copies in current display order. @returns {ActivityItemOptions[]} */
+    getItems(): ActivityItemOptions[];
+    /** Returns a shallow descriptor copy by stable host ID. @param {unknown} id @returns {ActivityItemOptions|null} */
+    getItem(id: unknown): ActivityItemOptions | null;
+    /**
+     * Adds activities after the current source order for older-page or forward-stream updates.
+     * @param {ActivityItemOptions|ActivityItemOptions[]} items New activities.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    appendItems(items: ActivityItemOptions | ActivityItemOptions[], options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Adds activities before the current source order for newest-first live updates.
+     * @param {ActivityItemOptions|ActivityItemOptions[]} items New activities.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    prependItems(items: ActivityItemOptions | ActivityItemOptions[], options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Patches the first activity whose ID is `Object.is`-equal to the requested ID.
+     * @param {unknown} id Stable host identifier.
+     * @param {Partial<ActivityItemOptions>} values Replacement fields.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    updateItem(id: unknown, values: Partial<ActivityItemOptions>, options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Removes the first activity whose ID is `Object.is`-equal to the requested ID.
+     * @param {unknown} id Stable host identifier.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    removeItem(id: unknown, options?: {
+        silent?: boolean;
+    }): this;
+    /** Sets initial/incremental loading presentation. @param {boolean} loading @returns {this} */
+    setLoading(loading: boolean): this;
+    /** Restores an enhanced target exactly, or removes an owned list. @returns {void} */
+    destroy(): void;
+    /** @private @returns {void} */
+    private _renderList;
+    /** @private @param {ActivityGroup} group @param {boolean} grouped @returns {HTMLElement} */
+    private _createGroup;
+    /** @private @param {boolean} placeholders @returns {HTMLElement} */
+    private _createLoading;
+    /** @private @returns {void} */
+    private _destroyItems;
+    /** @private @returns {void} */
+    private _emitDataChange;
+}
+/**
+ * Groups descriptors in first-seen group order while preserving source order within every group.
+ * A null reader returns one ungrouped collection. Neither descriptors nor the input array mutate.
+ * @param {ActivityItemOptions[]} items Activity descriptors.
+ * @param {ActivityGroupReader} groupBy Group reader.
+ * @returns {ActivityGroup[]}
+ */
+export declare function groupActivityItems(items: ActivityItemOptions[], groupBy?: ActivityGroupReader): ActivityGroup[];
+/**
+ * Validates and shallow-clones activity descriptors, including each slot array. Explicit
+ * duplicate IDs are rejected while id-less entries remain valid.
+ * @param {unknown} value Candidate descriptor array.
+ * @returns {ActivityItemOptions[]}
+ */
+export declare function normalizeActivityItems(value: unknown): ActivityItemOptions[];
+/**
+ * Activity descriptors changed through a list mutation method.
+ * @event ActivityList#datachange
+ * @type {CustomEvent<{items:ActivityItemOptions[]}>}
+ */

package/dist/types/components/app-sidebar/app-sidebar.d.ts

@@ -220,6 +220,16 @@ export declare class AppSidebar extends Component<AppSidebarOptions> {
     _renderExpanded(): void;
     /** @returns {void} */
     _renderRail(): void;
+    /**
+     * Keeps a minimized rail's counts readable and audible.
+     *
+     * A rail destination is icon-only, so its accessible name is the label alone and the badge the
+     * expanded tree showed as text is announced by nothing. Here the figure is folded back into the
+     * name, and `data-zx-badge` tells the stylesheet whether the count still fits the target or has
+     * to be drawn as a dot. Presentation only: no item, option, event, or listener is touched.
+     * @returns {void}
+     */
+    _decorateRail(): void;
     /** @param {EventTarget} target @param {string} type @param {EventListener} listener @returns {void} */
     _listenMode(target: EventTarget, type: string, listener: EventListener): void;
     /** @returns {void} */
@@ -234,6 +244,24 @@ export declare class AppSidebar extends Component<AppSidebarOptions> {
     _select(item: AppNavItem, event: Event): void;
     /** @returns {void} */
     _syncActive(): void;
+    /**
+     * Flags the sublist a branch toggle just opened so the stylesheet can animate that one branch.
+     *
+     * `_renderTree()` rebuilds every row on every toggle, so a transition declared on the sublist
+     * alone would replay on branches that never moved. The attribute is written after the rebuild
+     * and disappears with the element on the next one, which is why it needs no teardown.
+     * @param {string} key Branch id as a string.
+     * @returns {void}
+     */
+    _markBranchMotion(key: string): void;
+    /**
+     * Resolves a message through the host translator, falling back to the built-in English text.
+     * @param {string} key Message key.
+     * @param {string} fallback Built-in text, with `%1`-style placeholders.
+     * @param {...unknown} args Interpolation values.
+     * @returns {string}
+     */
+    _message(key: string, fallback: string, ...args: unknown[]): string;
     /** @returns {void} */
     _reconcileExpanded(): void;
 }

package/dist/types/components/button/button.d.ts

@@ -1,3 +1,7 @@
+export type ButtonShortcut = {
+    label: string;
+    keys: string;
+};
 export type ButtonOptions = {
     /**
      * Visible button label.
@@ -23,6 +27,10 @@ export type ButtonOptions = {
      * Native title text.
      */
     title?: string;
+    /**
+     * Keyboard hint; does not register a keyboard handler.
+     */
+    shortcut?: ButtonShortcut;
     /**
      * Click callback.
      */

package/dist/types/components/calendar/calendar.d.ts

@@ -504,6 +504,25 @@ export declare class Calendar extends Component<CalendarOptions> {
     _refreshNowIndicator(): void;
     /** @param {string} message @returns {void} */
     _announce(message: string): void;
+    /**
+     * Names a month or year cell by its date and how many events it holds. Singular and plural are
+     * separate keys because a language that inflects the noun cannot reach it from one template.
+     * @param {Date} day Day the cell stands for.
+     * @param {number} count Events on that day.
+     * @returns {string}
+     */
+    _dayCountLabel(day: Date, count: number): string;
+    /**
+     * Resolves a message through the host translator, falling back to the built-in English text.
+     *
+     * Distinct from `msg()`: the built-in `msg` option answers the calendar's own vocabulary, so a
+     * dotted key falls past it to the host translator, which is what these strings never had.
+     * @param {string} key Message key.
+     * @param {string} fallback Built-in text, with `%1`-style placeholders.
+     * @param {...unknown} args Interpolation values.
+     * @returns {string}
+     */
+    _message(key: string, fallback: string, ...args: unknown[]): string;
 }
 /** @event Calendar#viewchange @type {CustomEvent<{view: CalendarView, oldView: CalendarView}>} */
 /** @event Calendar#dateschange @type {CustomEvent<{view: CalendarView, start: Date, end: Date}>} */

package/dist/types/components/card/card.d.ts

@@ -125,4 +125,11 @@ export declare class Card extends Component<CardOptions> {
     _renderHeading(): void;
     /** @returns {void} */
     _syncHeader(): void;
+    /**
+     * Resolves a message through the host translator, falling back to the built-in English text.
+     * @param {string} key Message key.
+     * @param {string} fallback English default.
+     * @returns {string}
+     */
+    _message(key: string, fallback: string): string;
 }

package/dist/types/components/card-view/card-view.d.ts

@@ -31,6 +31,10 @@ export type CardViewOptions = {
      * Record selection behavior.
      */
     selectable?: false | 'single' | 'multi';
+    /**
+     * Select through a checkbox or the non-interactive card surface.
+     */
+    selectionTrigger?: 'checkbox' | 'card';
     /**
      * Initially selected record ids.
      */
@@ -44,9 +48,10 @@ export type CardViewOptions = {
      */
     hiddenFields?: string[];
     /**
-     * Whether to expose shared field controls.
+     * Whether to expose shared field controls. `true` renders the chooser in the card toolbar and
+     * `false` omits it; an object customises its `label` and mounts it into `target`.
      */
-    fieldControls?: boolean;
+    fieldControls?: boolean | import('../view/record-view.js').ViewFieldControlsConfig;
     /**
      * Empty-result content.
      */
@@ -172,10 +177,13 @@ export type CardRecordGroup = {
  * @property {import('../view/record-view.js').ViewSort|null} [sort=null] Initial shared sort.
  * @property {'local'|'server'} [sortMode='local'] Local sorting or event-only server sorting.
  * @property {false|'single'|'multi'} [selectable=false] Record selection behavior.
+ * @property {'checkbox'|'card'} [selectionTrigger='checkbox'] Select through a checkbox or the non-interactive card surface.
  * @property {unknown[]} [selection=[]] Initially selected record ids.
  * @property {string[]} [fieldOrder=[]] Preferred shared field order.
  * @property {string[]} [hiddenFields=[]] Initially hidden metadata fields.
- * @property {boolean} [fieldControls=true] Whether to expose shared field controls.
+ * @property {boolean|import('../view/record-view.js').ViewFieldControlsConfig} [fieldControls=true]
+ * Whether to expose shared field controls. `true` renders the chooser in the card toolbar and
+ * `false` omits it; an object customises its `label` and mounts it into `target`.
  * @property {string|Node|(()=>string|Node)|null} [emptyText=null] Empty-result content.
  * @property {RecordCardValueSource} [titleField=null] Title field id or explicit resolver.
  * @property {RecordCardValueSource} [subtitleField=null] Subtitle field id or explicit resolver.

package/dist/types/components/card-view/record-card.d.ts

@@ -119,6 +119,10 @@ export type RecordCardOptions = {
      * Selection presentation.
      */
     selectable?: false | 'single' | 'multi';
+    /**
+     * Selection affordance for owning views.
+     */
+    selectionTrigger?: 'checkbox' | 'card';
     /**
      * Current selection state.
      */
@@ -209,6 +213,7 @@ export type ResolvedRecordPreview = {
  * @property {RecordCardLink|((record:ViewRecord,index:number)=>RecordCardLink)} [link]
  * @property {RecordCardAction[]|((record:ViewRecord,index:number)=>RecordCardAction[])} [actions=[]]
  * @property {false|'single'|'multi'} [selectable=false] Selection presentation.
+ * @property {'checkbox'|'card'} [selectionTrigger='checkbox'] Selection affordance for owning views.
  * @property {boolean} [selected=false] Current selection state.
  * @property {'outlined'|'raised'|'filled'} [variant='outlined'] Surface treatment.
  * @property {1|2|3|4|5|6} [headingLevel=3] Card title heading level.
@@ -229,7 +234,8 @@ export type ResolvedRecordPreview = {
  *
  * The returned `<li>` belongs in a semantic `<ul>`/`<ol>`. When selectable its global
  * `aria-description` announces selection without applying the unsupported `aria-selected` state
- * to a listitem; multi-selection also adds a native checkbox. It deliberately remains a listitem
+ * to a listitem; multi-selection adds a native checkbox unless the owner opts into card-surface
+ * selection. It deliberately remains a listitem
  * rather than becoming an ARIA option because cards may contain native links and buttons, which
  * the listbox pattern does not permit inside an option. Preview images are paired with a stable
  * fallback. The owning component listens for image `error` and marks the fallback.

package/dist/types/components/code-editor/code-editor.d.ts

@@ -0,0 +1,160 @@
+import { Component } from '../../core/component.js';
+export type CodeEditorOptions = {
+    /**
+     * Initial text.
+     */
+    value?: unknown;
+    /**
+     * Form field name.
+     */
+    name?: string;
+    /**
+     * Language identifier shown to the user and exposed as data.
+     */
+    language?: string;
+    /**
+     * Accessible editor label.
+     */
+    label?: string;
+    /**
+     * Placeholder text.
+     */
+    placeholder?: string;
+    /**
+     * Visible textarea rows.
+     */
+    rows?: number;
+    /**
+     * Text inserted by Tab and removed by Shift+Tab.
+     */
+    indent?: string;
+    /**
+     * Textarea wrapping behavior.
+     */
+    wrap?: 'off' | 'soft' | 'hard';
+    /**
+     * Whether browser spellcheck is enabled.
+     */
+    spellcheck?: boolean;
+    /**
+     * Whether content can be selected but not changed.
+     */
+    readOnly?: boolean;
+    /**
+     * Whether the editor is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Whether the line/column status is visible.
+     */
+    status?: boolean;
+    /**
+     * Input listener.
+     */
+    oninput?: (event: CustomEvent<{
+        value: string;
+    }>) => void;
+    /**
+     * Change listener.
+     */
+    onchange?: (event: CustomEvent<{
+        value: string;
+    }>) => void;
+};
+/**
+ * @typedef {Object} CodeEditorOptions
+ * @property {unknown} [value=''] Initial text.
+ * @property {string} [name=''] Form field name.
+ * @property {string} [language='text'] Language identifier shown to the user and exposed as data.
+ * @property {string} [label='Code editor'] Accessible editor label.
+ * @property {string} [placeholder=''] Placeholder text.
+ * @property {number} [rows=12] Visible textarea rows.
+ * @property {string} [indent='\t'] Text inserted by Tab and removed by Shift+Tab.
+ * @property {'off'|'soft'|'hard'} [wrap='off'] Textarea wrapping behavior.
+ * @property {boolean} [spellcheck=false] Whether browser spellcheck is enabled.
+ * @property {boolean} [readOnly=false] Whether content can be selected but not changed.
+ * @property {boolean} [disabled=false] Whether the editor is disabled.
+ * @property {boolean} [status=true] Whether the line/column status is visible.
+ * @property {(event: CustomEvent<{value:string}>) => void} [oninput] Input listener.
+ * @property {(event: CustomEvent<{value:string}>) => void} [onchange] Change listener.
+ */
+/**
+ * Dependency-free source editor for structured text, Markdown, JSON and code. It deliberately uses
+ * a native textarea: values remain text-safe, browser undo and IME behavior stay intact, and Tab /
+ * Shift+Tab provide predictable indentation without a third-party editor runtime.
+ * @fires CodeEditor#input
+ * @fires CodeEditor#change
+ * @extends {Component<CodeEditorOptions>}
+ */
+export declare class CodeEditor extends Component<CodeEditorOptions> {
+    _createdRoot: boolean;
+    _initialChildren: ChildNode[];
+    _initialAttributes: Map<string, string>;
+    _language: string;
+    _languageLabel: HTMLElement;
+    _position: HTMLElement;
+    _header: HTMLElement;
+    _input: HTMLTextAreaElement;
+    static cssName: string;
+    /** @type {CodeEditorOptions} */
+    static defaults: CodeEditorOptions;
+    /** @returns {HTMLElement} */
+    render(): HTMLElement;
+    /** @returns {string} */
+    getValue(): string;
+    /**
+     * Replaces the editor text.
+     * @param {unknown} value New value.
+     * @param {{silent?:boolean}} [options={}] Suppress the `change` event.
+     * @returns {this}
+     */
+    setValue(value: unknown, { silent }?: {
+        silent?: boolean;
+    }): this;
+    /** @param {unknown} language New language identifier. @returns {this} */
+    setLanguage(language: unknown): this;
+    /** @returns {this} */
+    focus(): this;
+    /** @returns {this} */
+    enable(): this;
+    /** @returns {this} */
+    disable(): this;
+    /** @param {boolean} value Read-only state. @returns {this} */
+    setReadOnly(value: boolean): this;
+    /** @param {KeyboardEvent} event @returns {void} */
+    _handleKeydown(event: KeyboardEvent): void;
+    /** @returns {void} */
+    _updatePosition(): void;
+    /** @returns {void} */
+    destroy(): void;
+}
+/**
+ * Applies Tab or Shift+Tab to a textarea selection.
+ * @param {string} value Complete source value.
+ * @param {number} start Selection start.
+ * @param {number} end Selection end.
+ * @param {string} indent Indentation text.
+ * @param {boolean} outdent Whether to remove indentation.
+ * @returns {{value:string,start:number,end:number}}
+ */
+export declare function indentSelection(value: string, start: number, end: number, indent?: string, outdent?: boolean): {
+    value: string;
+    start: number;
+    end: number;
+};
+/** @param {string} value @param {number} start @param {number} end @returns {{line:number,column:number,lines:number}} */
+export declare function editorPosition(value: string, start: number, end?: number): {
+    line: number;
+    column: number;
+    lines: number;
+};
+/**
+ * Code editor input event.
+ * @event CodeEditor#input
+ * @type {CustomEvent<{value:string}>}
+ */
+/**
+ * Code editor committed change event.
+ * @event CodeEditor#change
+ * @type {CustomEvent<{value:string}>}
+ */

package/dist/types/components/code-editor/field-adapter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Registers the CodeEditor-backed `code` field type.
+ * @returns {void}
+ */
+export declare function registerCodeEditorFieldAdapter(): void;

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

@@ -1,6 +1,6 @@
 import { Component } from '../../core/component.js';
-export type MenuItem = import('../menu-button/menu-button.js').MenuItem;
-export type ContextMenuEntry = MenuItem | '-';
+export type MenuItem = import('../../internal/menu-items.js').MenuItem;
+export type ContextMenuEntry = import('../../internal/menu-items.js').MenuEntry;
 export type ContextMenuOptions = {
     /**
      * Menu
@@ -34,6 +34,22 @@ export type ContextMenuOptions = {
      */
     onclose?: (event: CustomEvent<Record<string, never>>) => void;
 };
+/** @typedef {import('../../internal/menu-items.js').MenuItem} MenuItem */
+/** @typedef {import('../../internal/menu-items.js').MenuEntry} ContextMenuEntry */
+/**
+ * @typedef {Object} ContextMenuOptions
+ * @property {ContextMenuEntry[]|((context: Element|null) => ContextMenuEntry[])} [items=[]] Menu
+ *   items and `'-'` separators, or a function returning them for the element the menu is opening
+ *   on — which is how a row menu disables the actions that row does not allow. Returning an empty
+ *   array cancels the opening.
+ * @property {string|null} [selector=null] Restricts the menu to descendants matching this
+ *   selector, and reports the matched element as the context of the selection. A table passes
+ *   `'tbody tr'` here to get a per-row menu from one listener.
+ * @property {(event: CustomEvent<{value: unknown, item: MenuItem, context: Element|null}>) => void} [onselect]
+ *   Selection listener.
+ * @property {(event: CustomEvent<{context: Element|null}>) => void} [onopen] Open listener.
+ * @property {(event: CustomEvent<Record<string, never>>) => void} [onclose] Close listener.
+ */
 /**
  * Right-click menu for a region, implementing the APG menu pattern.
  *

package/dist/types/components/date-picker/date-picker.d.ts

@@ -134,4 +134,12 @@ export declare class DatePicker extends Component<DatePickerOptions> {
     _inRange(date: Date): boolean;
     /** @param {Date} date @returns {HTMLButtonElement|null} */
     _buttonForDate(date: Date): HTMLButtonElement | null;
+    /**
+     * Resolves a message through the host translator, falling back to the built-in English text.
+     * @param {string} key Message key.
+     * @param {string} fallback Built-in text, with `%1`-style placeholders.
+     * @param {...unknown} args Interpolation values.
+     * @returns {string}
+     */
+    _message(key: string, fallback: string, ...args: unknown[]): string;
 }

package/dist/types/components/date-picker/time-picker.d.ts

@@ -124,4 +124,11 @@ export declare class TimePicker extends Component<TimePickerOptions> {
     _buildMark(mark: ClockMark, selected: number): HTMLElement;
     /** @param {HTMLElement} element @param {ClockMark} mark @param {number} selected @returns {void} */
     _syncMark(element: HTMLElement, mark: ClockMark, selected: number): void;
+    /**
+     * Resolves a message through the host translator, falling back to the built-in English text.
+     * @param {string} key Message key.
+     * @param {string} fallback English default.
+     * @returns {string}
+     */
+    _message(key: string, fallback: string): string;
 }

package/dist/types/components/dialog/dialog.d.ts

@@ -17,6 +17,14 @@ export type DialogButton = {
      * Whether this button receives initial focus.
      */
     autofocus?: boolean;
+    /**
+     * Whether the footer button is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Visible shortcut hint; the host binds the action.
+     */
+    shortcut?: import('../button/button.js').ButtonShortcut;
 };
 export type DialogOptions = {
     /**
@@ -155,6 +163,8 @@ export type PromptOptions = {
  * @property {DialogButtonKind} [kind='default'] Visual button kind.
  * @property {'close'|'cancel'|((dialog: Dialog) => void)} [action='close'] Button action.
  * @property {boolean} [autofocus=false] Whether this button receives initial focus.
+ * @property {boolean} [disabled=false] Whether the footer button is disabled.
+ * @property {import('../button/button.js').ButtonShortcut} [shortcut] Visible shortcut hint; the host binds the action.
  */
 /**
  * @typedef {Object} DialogOptions
@@ -295,4 +305,23 @@ export declare class Dialog extends Modal {
      * @returns {void}
      */
     _applySize(size: 'sm' | 'md' | 'lg' | number): void;
+    /**
+     * Resolves a component message, falling back to the built-in English text.
+     * @param {string} key Message key.
+     * @param {string} fallback English default.
+     * @returns {string}
+     */
+    _message(key: string, fallback: string): string;
 }
+/**
+ * Copies footer-button descriptors without mutating the caller's array or objects, and settles
+ * the two booleans the footer renders from.
+ *
+ * `autofocus` and `disabled` are resolved together because they contradict each other: a control
+ * that refuses activation must not be the one initial focus lands on, and a host that writes both
+ * has said what it wants twice. Deciding it here rather than at render time keeps `Sheet` — which
+ * takes the same descriptors through the same footer — on one answer.
+ * @param {DialogButton[]|null|undefined} list Button descriptors.
+ * @returns {DialogButton[]} Normalized copies.
+ */
+export declare function normalizeDialogButtons(list: DialogButton[] | null | undefined): DialogButton[];