@pine-ds/core 3.13.0 → 3.14.1

package/dist/types/components/pds-multiselect/pds-multiselect.d.ts

@@ -0,0 +1,175 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { MultiselectOption, MultiselectChangeEventDetail, MultiselectSearchEventDetail, MultiselectLoadOptionsEventDetail } from './multiselect-interface';
+/**
+ * @slot (default) - Static option elements for the multiselect
+ * @slot empty - Custom empty state message when no options match
+ * @slot loading - Custom loading indicator
+ */
+export declare class PdsMultiselect {
+    private triggerEl?;
+    private searchInputEl?;
+    private containerEl?;
+    private listboxEl?;
+    private panelEl?;
+    private internals?;
+    private abortController?;
+    private fetchDebounceTimer?;
+    private observer?;
+    private cleanupAutoUpdate?;
+    el: HTMLPdsMultiselectElement;
+    /**
+     * A unique identifier used for the underlying component `id` attribute.
+     */
+    componentId: string;
+    /**
+     * Text to be displayed as the multiselect label.
+     */
+    label?: string;
+    /**
+     * Placeholder text for the input field.
+     */
+    placeholder?: string;
+    /**
+     * Specifies the name. Submitted with the form as part of a name/value pair.
+     */
+    name?: string;
+    /**
+     * Array of selected option values.
+     */
+    value: string[];
+    /**
+     * Determines whether or not the multiselect is disabled.
+     */
+    disabled: boolean;
+    /**
+     * URL endpoint for async data fetching.
+     */
+    asyncUrl?: string;
+    /**
+     * HTTP method for async requests.
+     */
+    asyncMethod: 'GET' | 'POST';
+    /**
+     * Debounce delay in milliseconds for search/fetch.
+     */
+    debounce: number;
+    /**
+     * Maximum number of selections allowed.
+     */
+    maxSelections?: number;
+    /**
+     * Maximum height of the dropdown before scrolling.
+     */
+    maxHeight: string;
+    /**
+     * Width of the trigger button (and reference for dropdown positioning).
+     */
+    triggerWidth: string;
+    /**
+     * Minimum width of the dropdown panel.
+     */
+    minWidth: string;
+    /**
+     * Width of the dropdown panel. Defaults to the trigger width.
+     */
+    panelWidth?: string;
+    /**
+     * Visually hides the label but keeps it accessible.
+     */
+    hideLabel: boolean;
+    /**
+     * Error message to display.
+     */
+    errorMessage?: string;
+    /**
+     * Helper message to display below the input.
+     */
+    helperMessage?: string;
+    /**
+     * If true, the multiselect is in an invalid state.
+     */
+    invalid?: boolean;
+    /**
+     * If true, the multiselect is required.
+     */
+    required: boolean;
+    /**
+     * Whether the component is currently loading async options.
+     */
+    loading: boolean;
+    /**
+     * Options provided externally (for consumer-managed async).
+     */
+    options?: MultiselectOption[];
+    /**
+     * Function to format async results. Receives raw API response item.
+     */
+    formatResult?: (item: unknown) => MultiselectOption;
+    isOpen: boolean;
+    searchQuery: string;
+    highlightedIndex: number;
+    internalOptions: MultiselectOption[];
+    selectedItems: MultiselectOption[];
+    currentPage: number;
+    hasMore: boolean;
+    private isOpening;
+    /**
+     * Emitted when selection changes.
+     */
+    pdsMultiselectChange: EventEmitter<MultiselectChangeEventDetail>;
+    /**
+     * Emitted on search input (for consumer-managed async).
+     */
+    pdsMultiselectSearch: EventEmitter<MultiselectSearchEventDetail>;
+    /**
+     * Emitted to request more options (pagination).
+     */
+    pdsMultiselectLoadOptions: EventEmitter<MultiselectLoadOptionsEventDetail>;
+    private originalSearchEmitter?;
+    connectedCallback(): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    private setupSlotChangeListener;
+    disconnectedCallback(): void;
+    protected setupDebounce(): void;
+    protected valueChanged(newValue: string[] | string): void;
+    protected optionsChanged(): void;
+    protected internalOptionsChanged(): void;
+    /**
+     * Sets focus on the trigger button.
+     */
+    setFocus(): Promise<void>;
+    /**
+     * Handle global keyboard events for accessibility.
+     * Closes dropdown on Escape key press regardless of focus location.
+     */
+    handleWindowKeyDown(event: KeyboardEvent): void;
+    private setupMutationObserver;
+    private updateOptionsFromSlot;
+    private clearAsyncFetchState;
+    private debouncedFetchAsyncOptions;
+    private syncSelectedItems;
+    private ensureValueArray;
+    private getAllOptions;
+    private getFilteredOptions;
+    private updateFormValue;
+    private fetchOptions;
+    private handleTriggerClick;
+    private handleTriggerKeyDown;
+    private handleSearchInputChange;
+    private handleSearchInputKeyDown;
+    private handleContainerFocusOut;
+    private openDropdown;
+    private closeDropdown;
+    private positionDropdown;
+    private scrollOptionIntoView;
+    private toggleOption;
+    private selectOption;
+    private handleOptionMouseDown;
+    private handleOptionMouseEnter;
+    private handleScroll;
+    private renderSelectedItemsList;
+    private renderDropdown;
+    private getTriggerText;
+    render(): any;
+}

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

@@ -66,9 +66,21 @@ export declare class PdsSelect {
      */
     value?: string | string[];
     /**
-     * Emitted when a keyboard input occurs.
+     * Emitted when the select value changes.
      */
     pdsSelectChange: EventEmitter<InputEvent>;
+    /**
+     * Emitted when the select loses focus.
+     */
+    pdsBlur: EventEmitter<FocusEvent>;
+    /**
+     * Emitted when the select gains focus.
+     */
+    pdsFocus: EventEmitter<FocusEvent>;
+    /**
+     * Emitted when a key is pressed down in the select.
+     */
+    pdsKeyDown: EventEmitter<KeyboardEvent>;
     /**
      * Handles the change in the value of the select component.
      * This method is called whenever the value of the select component changes.
@@ -98,6 +110,9 @@ export declare class PdsSelect {
      * Emits an event on input change.
     */
     private onSelectUpdate;
+    private onBlur;
+    private onFocus;
+    private onKeyDown;
     /**
      * Handles the change event for the slot element.
      * This method is triggered when the slot content changes.

package/dist/types/components/pds-table/pds-table-head-cell/pds-table-head-cell.d.ts

@@ -45,6 +45,22 @@ export declare class PdsTableHeadCell {
      * @defaultValue false
      */
     private hasHeadBackground;
+    /**
+     * Determines if this column is the currently active sorted column.
+     * @defaultValue false
+     */
+    private isActive;
+    /**
+     * Programmatically sets this column as the active sort column with the specified direction.
+     * Used by pds-table to apply a default sort on initial load.
+     * @param direction - The sort direction to apply ('asc' or 'desc')
+     */
+    setActiveSort(direction: 'asc' | 'desc'): Promise<void>;
+    /**
+     * Clears the active sort state from this column.
+     * Used internally when another column becomes active.
+     */
+    clearActiveSort(): Promise<void>;
     componentWillLoad(): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;

package/dist/types/components/pds-table/pds-table.d.ts

@@ -31,6 +31,17 @@ export declare class PdsTable {
      * @defaultValue false
      */
     rowDividers: boolean;
+    /**
+     * The name of the column to sort by on initial load.
+     * Must match the text content of a sortable column header.
+     */
+    defaultSortColumn?: string;
+    /**
+     * The direction to sort the default column on initial load.
+     * Only applies if `defaultSortColumn` is set.
+     * @defaultValue 'asc'
+     */
+    defaultSortDirection?: 'asc' | 'desc';
     /**
      * The name of the column being sorted.
      * @defaultValue null
@@ -54,8 +65,13 @@ export declare class PdsTable {
     pdsTableSelectAll: EventEmitter<{
         isSelected: boolean;
     }>;
-    componentWillLoad(): void;
     componentDidLoad(): void;
+    /**
+     * Applies the default sort configuration on initial load.
+     * Finds the matching column header and activates its sort state.
+     * @private
+     */
+    private applyDefaultSort;
     disconnectedCallback(): void;
     /**
      * Sets up responsive scrolling behavior for the table.

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

@@ -36,6 +36,10 @@ export declare class PdsTextarea {
      * This event will not emit when programmatically setting the `value` property.
      */
     pdsTextareaChange: EventEmitter<TextareaChangeEventDetail>;
+    /**
+     * Emitted when a key is pressed down in the textarea.
+     */
+    pdsKeyDown: EventEmitter<KeyboardEvent>;
     /**
      * Sets focus on the native `textarea` in the `pds-textarea`. Use this method instead of the global
      * `textarea.focus()`.
@@ -138,6 +142,7 @@ export declare class PdsTextarea {
     private onFocus;
     private onInput;
     private onTextareaChange;
+    private onKeyDown;
     private textareaClassNames;
     connectedCallback(): void;
     disconnectedCallback(): void;