@sekiui/elements 0.1.3 → 0.1.5

package/dist/types/components/input/seki-input.d.ts

@@ -77,6 +77,14 @@ export declare class SekiInput {
      * 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;
     /**
      * Emitted on every keystroke
      */

package/dist/types/components/input-otp/seki-input-otp.d.ts

@@ -49,6 +49,14 @@ export declare class SekiInputOtp {
      * 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;
     /**
      * Current active slot index (internal)
      */

package/dist/types/components/label/seki-label.d.ts

@@ -10,8 +10,10 @@
 export declare class SekiLabel {
     el: HTMLElement;
     /**
-     * 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;
     /**
@@ -24,5 +26,12 @@ export declare class SekiLabel {
      * @default false
      */
     disabled?: boolean;
+    private binding?;
+    onForChange(): void;
+    /** Forward clicks to the labelled control (see utils/label-association.ts). */
+    onClick(event: MouseEvent): void;
+    connectedCallback(): void;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
     render(): any;
 }

package/dist/types/components/menubar/seki-menubar.d.ts

@@ -41,8 +41,14 @@ export declare class SekiMenubar {
     private getPrevMenuId;
     private setupClickOutside;
     private removeClickOutside;
-    handleEscape(event: KeyboardEvent): void;
+    /**
+     * Place on the overlay stack (utils/overlay.ts): Escape reaches this
+     * component only when nothing is open on top of it, so one key press closes
+     * one layer (#332).
+     */
+    private layer;
     handleItemSelect(event: CustomEvent<string>): void;
+    componentDidRender(): void;
     disconnectedCallback(): void;
     render(): any;
 }

package/dist/types/components/popover/seki-popover-content.d.ts

@@ -9,7 +9,11 @@ import type { PopoverSide, PopoverAlign } from './seki-popover';
 export declare class SekiPopoverContent {
     el: HTMLElement;
     private contentRef?;
-    private popoverEl?;
+    private popoverConsumer;
+    /**
+     * Re-read the parent's context. Runs once on connect (picking up a popover
+     * that is already open) and on every publish.
+     */
     private onPopoverOpenChange;
     /**
      * Override side from parent
@@ -34,8 +38,7 @@ export declare class SekiPopoverContent {
     };
     _actualSide: PopoverSide;
     private getContext;
-    componentWillRender(): void;
-    componentDidLoad(): void;
+    connectedCallback(): void;
     componentDidRender(): void;
     private updatePosition;
     disconnectedCallback(): void;

package/dist/types/components/popover/seki-popover.d.ts

@@ -57,10 +57,16 @@ export declare class SekiPopover {
      * Emitted when open state changes
      */
     sekiOpenChange: EventEmitter<boolean>;
+    /**
+     * Internal: notifies popover parts that `_popoverContext` changed. Not part
+     * of the public API; listen to `sekiOpenChange` instead.
+     */
+    popoverContextChange: EventEmitter<void>;
     private clickOutsideHandler?;
     private clickOutsideTimeout?;
     componentWillLoad(): void;
     openChanged(newValue: boolean): void;
+    placementChanged(): void;
     /**
      * Open the popover
      */
@@ -75,12 +81,18 @@ export declare class SekiPopover {
     togglePopover(): Promise<void>;
     handleTriggerClick(): void;
     handleCloseRequest(): void;
-    handleKeyDown(event: KeyboardEvent): void;
+    /**
+     * Place on the overlay stack (utils/overlay.ts): Escape reaches this
+     * component only when nothing is open on top of it, so one key press closes
+     * one layer (#332).
+     */
+    private layer;
     private setupClickOutside;
     private removeClickOutside;
     private getContext;
+    private publish;
     componentDidLoad(): void;
-    componentDidUpdate(): void;
+    componentDidRender(): void;
     disconnectedCallback(): void;
     render(): any;
 }

package/dist/types/components/select/seki-select.d.ts

@@ -34,6 +34,14 @@ export declare class SekiSelect {
     ariaLabelledby?: string;
     /** 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;
     /** Preferred dropdown placement */
     placement: SelectPlacement;
     /** Maximum dropdown height */
@@ -69,11 +77,27 @@ export declare class SekiSelect {
     componentDidLoad(): void;
     componentDidRender(): void;
     disconnectedCallback(): void;
+    /**
+     * The trigger already closes the list on Escape; this also covers focus
+     * anywhere else and keeps an enclosing dialog open.
+     * Place on the overlay stack (utils/overlay.ts): Escape reaches this
+     * component only when nothing is open on top of it, so one key press closes
+     * one layer (#332).
+     */
+    private layer;
     handleValuePropChange(newValue: SelectValue): void;
     handleOpenPropChange(newOpen: boolean): void;
     handleIsOpenChange(): void;
     handleInternalValueChange(): void;
     handleDisabledChange(): void;
+    /**
+     * The trigger's label comes from the registered options, so registering an
+     * option must notify the parts. Before #323 this was only a silent property
+     * write in componentDidRender, and a trigger that rendered before the
+     * selected option registered stayed on the placeholder.
+     */
+    handleRegisteredOptionsChange(): void;
+    private registrationPublishQueued;
     formResetCallback(): void;
     formDisabledCallback(disabled: boolean): void;
     formStateRestoreCallback(state: FormControlState): void;

package/dist/types/components/select-content/seki-select-content.d.ts

@@ -5,9 +5,10 @@ export declare class SekiSelectContent {
     el: HTMLElement;
     forceUpdate: number;
     private scrollContainerRef?;
-    componentDidLoad(): void;
+    private selectConsumer;
+    connectedCallback(): void;
     disconnectedCallback(): void;
-    private handleParentOpenChange;
+    private handleParentContextChange;
     /** Scroll to make an option visible */
     scrollToOption(optionId: string): Promise<void>;
     private getSelectContext;

package/dist/types/components/select-option/seki-select-option.d.ts

@@ -20,10 +20,16 @@ export declare class SekiSelectOption {
         value: string | number;
     }>;
     private get optionId();
-    private hasRegistered;
-    private contextSubscription;
-    componentDidLoad(): void;
+    /**
+     * The registerOption function this option last registered through. It is a
+     * stable per-select-instance function, so comparing it tells "already
+     * registered with this select" apart from "the select published its context
+     * for the first time" or "moved to a different select".
+     */
+    private registeredVia?;
+    private selectConsumer;
     connectedCallback(): void;
+    componentDidLoad(): void;
     disconnectedCallback(): void;
     /**
      * Refresh aria-selected/data-selected/data-focused directly on the

package/dist/types/components/select-trigger/seki-select-trigger.d.ts

@@ -6,11 +6,17 @@ export declare class SekiSelectTrigger {
     el: HTMLElement;
     forceUpdate: number;
     private buttonRef?;
-    private contextSubscription;
-    componentDidLoad(): void;
+    private selectConsumer;
+    connectedCallback(): void;
     disconnectedCallback(): void;
-    private handleParentOpenChange;
-    private handleParentValueChange;
+    /**
+     * Listeners follow the button element itself: the button only exists once a
+     * context is available (the first render may be the "Loading..." fallback
+     * when this trigger upgrades before its seki-select), so binding once in
+     * componentDidLoad could miss it entirely.
+     */
+    private setButtonRef;
+    private handleParentContextChange;
     private handleButtonClick;
     private handleButtonKeyDown;
     private getSelectContext;

package/dist/types/components/sheet/seki-sheet-content.d.ts

@@ -3,6 +3,10 @@ export type SheetSide = 'top' | 'right' | 'bottom' | 'left';
 /**
  * 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
  */
 export declare class SekiSheetContent {
@@ -21,12 +25,24 @@ export declare class SekiSheetContent {
      * seki-sheet parent (e.g. mounted standalone).
      */
     _isOpen: boolean;
-    private sheetEl?;
+    /** Title text mirrored for the accessible name (#357). */
+    _label: string;
+    /** Description text mirrored for the accessible description (#357). */
+    _description: string;
+    private contentRef?;
+    private sheetConsumer;
+    private layer;
+    private labels;
     private handleCloseClick;
-    private onSheetOpenChange;
+    /**
+     * Re-read the parent's open state. Runs once on connect (picking up a sheet
+     * that is already open, e.g. `<seki-sheet open>`) and on every publish.
+     */
     private syncOpenState;
-    componentWillLoad(): void;
-    componentDidLoad(): void;
+    connectedCallback(): void;
+    componentDidRender(): void;
     disconnectedCallback(): void;
+    /** Propagate the side attribute to the parent for CSS targeting. */
+    propagateSide(): void;
     render(): any;
 }

package/dist/types/components/sheet/seki-sheet.d.ts

@@ -45,8 +45,12 @@ export declare class SekiSheet {
      * event shape so a consumer can listen to one event name across every overlay.
      */
     sekiOpenChange: EventEmitter<boolean>;
+    /**
+     * Internal: notifies seki-sheet-content that `_sheetContext` changed. Not
+     * part of the public API; listen to `sekiOpenChange` instead.
+     */
+    sheetContextChange: EventEmitter<void>;
     componentWillLoad(): void;
-    componentDidLoad(): void;
     handleOpenPropChange(newValue: boolean): void;
     /**
      * Opens the sheet
@@ -63,6 +67,5 @@ export declare class SekiSheet {
     private updateContext;
     handleTriggerClick(): void;
     handleCloseSheet(): void;
-    handleKeydown(ev: KeyboardEvent): void;
     render(): any;
 }

package/dist/types/components/slider/seki-slider.d.ts

@@ -60,6 +60,14 @@ export declare class SekiSlider {
      * 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;
     /**
      * Internal value for uncontrolled mode.
      */

package/dist/types/components/sonner/seki-sonner-controller.d.ts

@@ -7,10 +7,14 @@ export interface ToastOptions {
         onClick: () => void;
     };
 }
+export declare function nextSonnerToastId(): string;
 export declare class SekiSonner {
     private static _instance;
+    /** Toasts fired before any <seki-sonner> was mounted; flushed on _register. */
+    private static _pending;
     static _register(el: SekiSonnerElement): void;
     static _unregister(_el: SekiSonnerElement): void;
+    private static _deliver;
     private static _show;
     static success(message: string, options?: ToastOptions): string;
     static error(message: string, options?: ToastOptions): string;

package/dist/types/components/sonner/seki-sonner.d.ts

@@ -20,9 +20,12 @@ export declare class SekiSonnerElement {
     duration: number;
     toasts: SonnerToast[];
     private timers;
+    /** Exit-animation timers; tracked so they cannot fire after disconnect. */
+    private removalTimers;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    addToast(data: Omit<SonnerToast, 'id'>): string;
+    private startTimer;
+    addToast(data: Omit<SonnerToast, 'id'>, id?: string): string;
     removeToast(id: string): void;
     private handleDismiss;
     private handleAction;

package/dist/types/components/switch/seki-switch.d.ts

@@ -46,6 +46,14 @@ export declare class SekiSwitch {
      * @description Accessible label for standalone switches without associated label elements.
      */
     ariaLabel?: 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;
     /**
      * @description Rendered checked state. Seeded from `checked` (or `defaultChecked`)
      * and thereafter the single source of truth for rendering.

package/dist/types/components/textarea/seki-textarea.d.ts

@@ -69,6 +69,14 @@ export declare class SekiTextarea {
      * 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;
     /**
      * Autocomplete attribute
      */

package/dist/types/components/toast/seki-toaster.d.ts

@@ -52,7 +52,9 @@ export declare class SekiToaster {
     private handleMouseLeave;
     private handleDismiss;
     private handleActionClick;
+    connectedCallback(): void;
     disconnectedCallback(): void;
+    private startTimer;
     render(): any;
     private renderIcon;
 }

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

@@ -33,6 +33,15 @@ export interface ToastOptions {
         onClick: () => void;
     };
 }
+/** @internal Called by <seki-toaster> when it connects. Returns buffered toasts to replay. */
+export declare function registerToaster(): Array<{
+    message: string;
+    options: ToastOptions;
+}>;
+/** @internal Called by <seki-toaster> when it disconnects. */
+export declare function unregisterToaster(): void;
+/** @internal Test helper. */
+export declare function resetToastQueue(): void;
 /**
  * Show a toast notification
  */

package/dist/types/components/tooltip/seki-tooltip.d.ts

@@ -122,6 +122,16 @@ export declare class SekiTooltip {
      * Handle mouse leave from trigger
      */
     private onTriggerMouseLeave;
+    /**
+     * Pointer entered the tooltip itself: keep it open (WCAG 1.4.13 "hoverable").
+     * Cancels the grace-period hide started when the pointer left the trigger.
+     */
+    private onTooltipMouseEnter;
+    /**
+     * Pointer left the tooltip: start the same grace-period hide as leaving the
+     * trigger, so moving back onto the trigger keeps it open.
+     */
+    private onTooltipMouseLeave;
     /**
      * Handle focus on trigger (accessibility)
      */
@@ -142,6 +152,11 @@ export declare class SekiTooltip {
      * Handle touch end (cancel long-press if not yet fired)
      */
     private onTriggerTouchEnd;
+    /**
+     * A visible tooltip is a layer on the overlay stack (utils/overlay.ts), as
+     * in Radix: Escape hides it first and leaves an enclosing dialog open.
+     */
+    private layer;
     /**
      * Handle Escape key to dismiss tooltip
      */
@@ -166,6 +181,7 @@ export declare class SekiTooltip {
     componentDidLoad(): void;
     openChanged(newValue: boolean): void;
     connectedCallback(): void;
+    componentDidRender(): void;
     disconnectedCallback(): void;
     render(): any;
 }