@sekiui/elements 0.1.3 → 0.1.5

package/dist/types/components.d.ts

@@ -18,7 +18,7 @@ import { CarouselContext } from "./components/carousel/seki-carousel";
 import { ChartData, ChartOptions, ChartType } from "./components/chart/chart-types";
 import { ChartLegendConfig } from "./components/chart-legend/seki-chart-legend";
 import { ComboboxChangeEventDetail, ComboboxCustomValueEventDetail, ComboboxEmptyReason, ComboboxItem, ComboboxMultiSelectDisplay, ComboboxSearchEventDetail, ComboboxValue } from "./utils/combobox";
-import { ColumnDef, ColumnReorderDetail, ColumnResizeDetail, ColumnsChangeDetail, FilterChangeDetail, FilterValue, PageChangeDetail, RowClickDetail, RowExpandDetail, SelectionChangeDetail, SortChangeDetail } from "./components/data-table/interfaces";
+import { ColumnDef, ColumnReorderDetail, ColumnResizeDetail, ColumnsChangeDetail, FetchDataCallback, FilterChangeDetail, FilterValue, PageChangeDetail, RenderExpandedRowCallback, RowClickDetail, RowExpandDetail, SelectionChangeDetail, SortChangeDetail } from "./components/data-table/interfaces";
 import { DatePickerMode, DateRange as DateRange1 } from "./components/date-picker/seki-date-picker";
 import { DrawerDirection } from "./components/drawer/seki-drawer-content";
 import { DropdownMenuAlign, DropdownMenuSide } from "./components/dropdown-menu/seki-dropdown-menu";
@@ -58,7 +58,7 @@ export { CarouselContext } from "./components/carousel/seki-carousel";
 export { ChartData, ChartOptions, ChartType } from "./components/chart/chart-types";
 export { ChartLegendConfig } from "./components/chart-legend/seki-chart-legend";
 export { ComboboxChangeEventDetail, ComboboxCustomValueEventDetail, ComboboxEmptyReason, ComboboxItem, ComboboxMultiSelectDisplay, ComboboxSearchEventDetail, ComboboxValue } from "./utils/combobox";
-export { ColumnDef, ColumnReorderDetail, ColumnResizeDetail, ColumnsChangeDetail, FilterChangeDetail, FilterValue, PageChangeDetail, RowClickDetail, RowExpandDetail, SelectionChangeDetail, SortChangeDetail } from "./components/data-table/interfaces";
+export { ColumnDef, ColumnReorderDetail, ColumnResizeDetail, ColumnsChangeDetail, FetchDataCallback, FilterChangeDetail, FilterValue, PageChangeDetail, RenderExpandedRowCallback, RowClickDetail, RowExpandDetail, SelectionChangeDetail, SortChangeDetail } from "./components/data-table/interfaces";
 export { DatePickerMode, DateRange as DateRange1 } from "./components/date-picker/seki-date-picker";
 export { DrawerDirection } from "./components/drawer/seki-drawer-content";
 export { DropdownMenuAlign, DropdownMenuSide } from "./components/dropdown-menu/seki-dropdown-menu";
@@ -1065,6 +1065,14 @@ export namespace Components {
           * ID of element describing this checkbox.
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers.
          */
@@ -1263,6 +1271,11 @@ export namespace Components {
         "reason": ComboboxEmptyReason;
     }
     interface SekiComboboxGroup {
+        /**
+          * Show even when every item in the group is filtered out
+          * @default false
+         */
+        "forceMount": boolean;
         /**
           * Group label
          */
@@ -1449,6 +1462,11 @@ export namespace Components {
           * @default false
          */
         "expandable": boolean;
+        /**
+          * Callback to fetch data. Set it as a JS property. Assigning or replacing it (re)loads the table. Must be a
+          * @Prop : in the lazy-loader build only decorated members are proxied from the host element to the instance.
+         */
+        "fetchData"?: FetchDataCallback;
         /**
           * Get current filter state
          */
@@ -1485,6 +1503,11 @@ export namespace Components {
           * Refresh data
          */
         "refresh": () => Promise<void>;
+        /**
+          * Callback to render expanded row content (must be a
+          * @Prop , see fetchData)
+         */
+        "renderExpandedRow"?: RenderExpandedRowCallback;
         /**
           * Fixed row height for virtualization
           * @default 48
@@ -1545,6 +1568,14 @@ export namespace Components {
      * <seki-date-picker mode="range" placeholder="Pick a date range"></seki-date-picker>
      */
     interface SekiDatePicker {
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * ARIA label for accessibility
          */
@@ -1582,7 +1613,7 @@ export namespace Components {
          */
         "mode": DatePickerMode;
         /**
-          * Form field name
+          * Form field name. In single mode the submitted value is `YYYY-MM-DD`. In range mode two entries are submitted: `<name>-from` and `<name>-to` (each `YYYY-MM-DD`; an unset end is omitted).
          */
         "name"?: string;
         /**
@@ -1681,10 +1712,13 @@ export namespace Components {
     }
     /**
      * Dialog overlay (backdrop)
+     * Works inside `seki-dialog` and inside `seki-alert-dialog`. In an alert
+     * dialog a click on the overlay never closes it (shadcn/Radix: alert dialogs
+     * close only via Cancel, Action or Escape).
      */
     interface SekiDialogOverlay {
         /**
-          * Whether clicking the overlay closes the dialog
+          * Whether clicking the overlay closes the dialog. Ignored inside `seki-alert-dialog`, which an overlay click never closes.
           * @default true
          */
         "closeOnClick": boolean;
@@ -2008,7 +2042,7 @@ export namespace Components {
     }
     interface SekiFieldLabel {
         /**
-          * ID of the form control this label is for Sets the `for` attribute on the label element
+          * ID of the form control this label is for Resolved in the label's own root node (not this component's shadow root), so it reaches light-DOM controls. Falls back to the control nested in the label.
          */
         "htmlFor"?: string;
         /**
@@ -2144,6 +2178,14 @@ export namespace Components {
           * ID of element describing this input
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers
          */
@@ -2248,6 +2290,14 @@ export namespace Components {
           * ID of element describing this input
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Custom aria-label for the input
          */
@@ -2359,7 +2409,7 @@ export namespace Components {
          */
         "disabled"?: boolean;
         /**
-          * The ID of the form element this label is associated with. Maps to the `htmlFor` attribute on the inner `<label>` element.
+          * The ID of the form element this label is associated with. Resolved in the label's own root node (document or shadow root), not in this component's shadow root, so it reaches light-DOM controls. Without it, the first control nested inside the label is used.
          */
         "for"?: string;
         /**
@@ -3427,6 +3477,14 @@ export namespace Components {
           * ID of element that describes this select
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers
          */
@@ -3607,6 +3665,9 @@ export namespace Components {
     }
     /**
      * seki-sheet-content: Container for sheet content
+     * A modal panel: while open it moves focus inside, traps Tab, locks page
+     * scroll, closes on Escape when nothing is open on top of it, and returns
+     * focus to the element that opened it (utils/overlay.ts).
      * @component SheetContent
      */
     interface SekiSheetContent {
@@ -3834,6 +3895,14 @@ export namespace Components {
           * ID of element describing this slider.
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers.
          */
@@ -3917,6 +3986,14 @@ export namespace Components {
      * <seki-switch disabled></seki-switch>
      */
     interface SekiSwitch {
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * @description Accessible label for standalone switches without associated label elements.
          */
@@ -4108,6 +4185,14 @@ export namespace Components {
           * ID of element describing this textarea
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers
          */
@@ -4710,6 +4795,7 @@ declare global {
     };
     interface HTMLSekiAlertDialogElementEventMap {
         "sekiOpenChange": boolean;
+        "sekiContextChange": void;
     }
     /**
      * Alert Dialog root component for confirmation dialogs
@@ -5480,6 +5566,7 @@ declare global {
     };
     interface HTMLSekiCollapsibleElementEventMap {
         "sekiOpenChange": boolean;
+        "sekiContextChange": void;
     }
     interface HTMLSekiCollapsibleElement extends Components.SekiCollapsible, HTMLStencilElement {
         addEventListener<K extends keyof HTMLSekiCollapsibleElementEventMap>(type: K, listener: (this: HTMLSekiCollapsibleElement, ev: SekiCollapsibleCustomEvent<HTMLSekiCollapsibleElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -5576,6 +5663,7 @@ declare global {
     interface HTMLSekiCommandElementEventMap {
         "sekiValueChange": string;
         "sekiSelect": string;
+        "sekiContextChange": void;
     }
     /**
      * Command root component - command palette for navigation
@@ -5775,6 +5863,7 @@ declare global {
     };
     interface HTMLSekiDialogElementEventMap {
         "sekiOpenChange": boolean;
+        "sekiContextChange": void;
     }
     /**
      * Dialog root component for modal dialogs
@@ -5865,6 +5954,9 @@ declare global {
     }
     /**
      * Dialog overlay (backdrop)
+     * Works inside `seki-dialog` and inside `seki-alert-dialog`. In an alert
+     * dialog a click on the overlay never closes it (shadcn/Radix: alert dialogs
+     * close only via Cancel, Action or Escape).
      */
     interface HTMLSekiDialogOverlayElement extends Components.SekiDialogOverlay, HTMLStencilElement {
         addEventListener<K extends keyof HTMLSekiDialogOverlayElementEventMap>(type: K, listener: (this: HTMLSekiDialogOverlayElement, ev: SekiDialogOverlayCustomEvent<HTMLSekiDialogOverlayElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -5927,6 +6019,7 @@ declare global {
         "drawerClose": void;
         "drawerSnap": { point: number };
         "sekiOpenChange": boolean;
+        "sekiContextChange": void;
     }
     /**
      * seki-drawer: Mobile-friendly drawer component with swipe gestures
@@ -7093,6 +7186,7 @@ declare global {
     };
     interface HTMLSekiPopoverElementEventMap {
         "sekiOpenChange": boolean;
+        "sekiContextChange": void;
     }
     /**
      * Popover component - floating content triggered by click
@@ -7388,6 +7482,7 @@ declare global {
         "sheetOpen": void;
         "sheetClose": void;
         "sekiOpenChange": boolean;
+        "sekiContextChange": void;
     }
     /**
      * seki-sheet: Root sheet component (slide-out panel)
@@ -7445,6 +7540,9 @@ declare global {
     }
     /**
      * seki-sheet-content: Container for sheet content
+     * A modal panel: while open it moves focus inside, traps Tab, locks page
+     * scroll, closes on Escape when nothing is open on top of it, and returns
+     * focus to the element that opened it (utils/overlay.ts).
      * @component SheetContent
      */
     interface HTMLSekiSheetContentElement extends Components.SekiSheetContent, HTMLStencilElement {
@@ -8350,6 +8448,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "defaultOpen"?: boolean;
+        /**
+          * Internal: notifies alert dialog parts that `_alertDialogContext` changed. Not part of the public API; listen to `sekiOpenChange` instead.
+         */
+        "onSekiContextChange"?: (event: SekiAlertDialogCustomEvent<void>) => void;
         /**
           * Emitted when open state changes
          */
@@ -9255,6 +9357,14 @@ declare namespace LocalJSX {
           * ID of element describing this checkbox.
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers.
          */
@@ -9308,6 +9418,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "disabled"?: boolean;
+        /**
+          * Internal: notifies collapsible parts that `_collapsibleContext` changed. Not part of the public API; listen to `sekiOpenChange` instead.
+         */
+        "onSekiContextChange"?: (event: SekiCollapsibleCustomEvent<void>) => void;
         /**
           * Emitted when open state changes
          */
@@ -9449,6 +9563,11 @@ declare namespace LocalJSX {
         "reason"?: ComboboxEmptyReason;
     }
     interface SekiComboboxGroup {
+        /**
+          * Show even when every item in the group is filtered out
+          * @default false
+         */
+        "forceMount"?: boolean;
         /**
           * Group label
          */
@@ -9476,6 +9595,10 @@ declare namespace LocalJSX {
           * @default true
          */
         "filter"?: boolean;
+        /**
+          * Internal: notifies command parts (input, items, groups, empty state) that `_commandContext` changed. Not part of the public API; listen to `sekiValueChange` instead.
+         */
+        "onSekiContextChange"?: (event: SekiCommandCustomEvent<void>) => void;
         /**
           * Emitted when an item is selected
          */
@@ -9641,6 +9764,11 @@ declare namespace LocalJSX {
           * @default false
          */
         "expandable"?: boolean;
+        /**
+          * Callback to fetch data. Set it as a JS property. Assigning or replacing it (re)loads the table. Must be a
+          * @Prop : in the lazy-loader build only decorated members are proxied from the host element to the instance.
+         */
+        "fetchData"?: FetchDataCallback;
         /**
           * Show loading state
           * @default false
@@ -9697,6 +9825,11 @@ declare namespace LocalJSX {
           * @default '[25, 50, 100]'
          */
         "pageSizeOptions"?: string | number[];
+        /**
+          * Callback to render expanded row content (must be a
+          * @Prop , see fetchData)
+         */
+        "renderExpandedRow"?: RenderExpandedRowCallback;
         /**
           * Fixed row height for virtualization
           * @default 48
@@ -9745,6 +9878,14 @@ declare namespace LocalJSX {
      * <seki-date-picker mode="range" placeholder="Pick a date range"></seki-date-picker>
      */
     interface SekiDatePicker {
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * ARIA label for accessibility
          */
@@ -9778,7 +9919,7 @@ declare namespace LocalJSX {
          */
         "mode"?: DatePickerMode;
         /**
-          * Form field name
+          * Form field name. In single mode the submitted value is `YYYY-MM-DD`. In range mode two entries are submitted: `<name>-from` and `<name>-to` (each `YYYY-MM-DD`; an unset end is omitted).
          */
         "name"?: string;
         /**
@@ -9839,6 +9980,10 @@ declare namespace LocalJSX {
           * @default true
          */
         "modal"?: boolean;
+        /**
+          * Internal: notifies dialog parts (content, overlay, title, description) that `_dialogContext` changed. Not part of the public API; listen to `sekiOpenChange` instead.
+         */
+        "onSekiContextChange"?: (event: SekiDialogCustomEvent<void>) => void;
         /**
           * Emitted when open state changes
          */
@@ -9883,10 +10028,13 @@ declare namespace LocalJSX {
     }
     /**
      * Dialog overlay (backdrop)
+     * Works inside `seki-dialog` and inside `seki-alert-dialog`. In an alert
+     * dialog a click on the overlay never closes it (shadcn/Radix: alert dialogs
+     * close only via Cancel, Action or Escape).
      */
     interface SekiDialogOverlay {
         /**
-          * Whether clicking the overlay closes the dialog
+          * Whether clicking the overlay closes the dialog. Ignored inside `seki-alert-dialog`, which an overlay click never closes.
           * @default true
          */
         "closeOnClick"?: boolean;
@@ -9950,6 +10098,10 @@ declare namespace LocalJSX {
           * Emitted when the drawer snaps to a point
          */
         "onDrawerSnap"?: (event: SekiDrawerCustomEvent<{ point: number }>) => void;
+        /**
+          * Internal: notifies seki-drawer-content that `_drawerContext` changed. Not part of the public API; listen to `sekiOpenChange` instead.
+         */
+        "onSekiContextChange"?: (event: SekiDrawerCustomEvent<void>) => void;
         /**
           * Emitted whenever the open state changes. Matches the dialog/popover/collapsible event shape so a consumer can listen to one event name across every overlay.
          */
@@ -10225,7 +10377,7 @@ declare namespace LocalJSX {
     }
     interface SekiFieldLabel {
         /**
-          * ID of the form control this label is for Sets the `for` attribute on the label element
+          * ID of the form control this label is for Resolved in the label's own root node (not this component's shadow root), so it reaches light-DOM controls. Falls back to the control nested in the label.
          */
         "htmlFor"?: string;
         /**
@@ -10377,6 +10529,14 @@ declare namespace LocalJSX {
           * ID of element describing this input
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers
          */
@@ -10497,6 +10657,14 @@ declare namespace LocalJSX {
           * ID of element describing this input
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Custom aria-label for the input
          */
@@ -10628,7 +10796,7 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * The ID of the form element this label is associated with. Maps to the `htmlFor` attribute on the inner `<label>` element.
+          * The ID of the form element this label is associated with. Resolved in the label's own root node (document or shadow root), not in this component's shadow root, so it reaches light-DOM controls. Without it, the first control nested inside the label is used.
          */
         "for"?: string;
         /**
@@ -11424,6 +11592,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "defaultOpen"?: boolean;
+        /**
+          * Internal: notifies popover parts that `_popoverContext` changed. Not part of the public API; listen to `sekiOpenChange` instead.
+         */
+        "onSekiContextChange"?: (event: SekiPopoverCustomEvent<void>) => void;
         /**
           * Emitted when open state changes
          */
@@ -11710,6 +11882,14 @@ declare namespace LocalJSX {
           * ID of element that describes this select
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers
          */
@@ -11864,6 +12044,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "defaultOpen"?: boolean;
+        /**
+          * Internal: notifies seki-sheet-content that `_sheetContext` changed. Not part of the public API; listen to `sekiOpenChange` instead.
+         */
+        "onSekiContextChange"?: (event: SekiSheetCustomEvent<void>) => void;
         /**
           * Emitted whenever the open state changes. Matches the dialog/popover/collapsible event shape so a consumer can listen to one event name across every overlay.
          */
@@ -11894,6 +12078,9 @@ declare namespace LocalJSX {
     }
     /**
      * seki-sheet-content: Container for sheet content
+     * A modal panel: while open it moves focus inside, traps Tab, locks page
+     * scroll, closes on Escape when nothing is open on top of it, and returns
+     * focus to the element that opened it (utils/overlay.ts).
      * @component SheetContent
      */
     interface SekiSheetContent {
@@ -12137,6 +12324,14 @@ declare namespace LocalJSX {
           * ID of element describing this slider.
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers.
          */
@@ -12228,6 +12423,14 @@ declare namespace LocalJSX {
      * <seki-switch disabled></seki-switch>
      */
     interface SekiSwitch {
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * @description Accessible label for standalone switches without associated label elements.
          */
@@ -12423,6 +12626,14 @@ declare namespace LocalJSX {
           * ID of element describing this textarea
          */
         "ariaDescribedby"?: string;
+        /**
+          * Text that describes this control. Set by `seki-field` from its description (and error) slot, because an `aria-describedby` id cannot cross the shadow boundary to the inner element (#358).
+         */
+        "ariaDescription"?: string;
+        /**
+          * Marks the control invalid for assistive technology. Set by `seki-field` (#358).
+         */
+        "ariaInvalid"?: string;
         /**
           * Accessible label for screen readers
          */
@@ -13477,6 +13688,9 @@ declare module "@stencil/core" {
             "seki-dialog-header": LocalJSX.SekiDialogHeader & JSXBase.HTMLAttributes<HTMLSekiDialogHeaderElement>;
             /**
              * Dialog overlay (backdrop)
+             * Works inside `seki-dialog` and inside `seki-alert-dialog`. In an alert
+             * dialog a click on the overlay never closes it (shadcn/Radix: alert dialogs
+             * close only via Cancel, Action or Escape).
              */
             "seki-dialog-overlay": LocalJSX.SekiDialogOverlay & JSXBase.HTMLAttributes<HTMLSekiDialogOverlayElement>;
             /**
@@ -14101,6 +14315,9 @@ declare module "@stencil/core" {
             "seki-sheet-close": LocalJSX.SekiSheetClose & JSXBase.HTMLAttributes<HTMLSekiSheetCloseElement>;
             /**
              * seki-sheet-content: Container for sheet content
+             * A modal panel: while open it moves focus inside, traps Tab, locks page
+             * scroll, closes on Escape when nothing is open on top of it, and returns
+             * focus to the element that opened it (utils/overlay.ts).
              * @component SheetContent
              */
             "seki-sheet-content": LocalJSX.SekiSheetContent & JSXBase.HTMLAttributes<HTMLSekiSheetContentElement>;

package/dist/types/index.d.ts

@@ -8,3 +8,4 @@ export * from './types';
 export { SekiSonnerElement } from './components/sonner/seki-sonner';
 export { SekiSonner } from './components/sonner/seki-sonner-controller';
 export type { ToastOptions } from './components/sonner/seki-sonner-controller';
+export { toast } from './components/toast/toast';

package/dist/types/utils/calendar/date-utils.d.ts

@@ -74,4 +74,13 @@ export declare function navigateWeek(date: Date, direction: 'prev' | 'next'): Da
  * Get the day of week index
  */
 export declare function getDayOfWeek(date: Date): number;
+/**
+ * Parse a user-supplied date. Date-only ISO strings (`YYYY-MM-DD`) are calendar
+ * dates, so they become local midnight; `new Date('2024-01-15')` would be UTC
+ * midnight and display a day early west of UTC. Anything invalid (including an
+ * invalid `Date` instance) yields `null`.
+ */
+export declare function parseDateInput(value?: Date | string | null): Date | null;
+/** Serialize the local calendar day of `date` as `YYYY-MM-DD`. */
+export declare function toISODate(date: Date): string;
 export { isSameDay, isSameMonth, isToday, startOfMonth, startOfDay, format, };