@pine-ds/core 3.1.0 → 3.2.0

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

@@ -0,0 +1,72 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export declare class PdsModal {
+    private modalRef;
+    private previousActiveElement;
+    private focusableElements;
+    el: HTMLPdsModalElement;
+    /**
+     * Whether the modal can be dismissed by clicking the backdrop
+     * @default true
+     */
+    backdropDismiss: boolean;
+    /**
+     * A unique identifier used for the underlying component `id` attribute.
+     */
+    componentId: string;
+    /**
+     * Whether the modal is open
+     * @default false
+     */
+    open: boolean;
+    /**
+     * The size of the modal
+     * @default 'md'
+     */
+    size: 'sm' | 'md' | 'lg' | 'fullscreen';
+    /**
+     * Emitted when the modal is opened
+     */
+    pdsModalOpen: EventEmitter<void>;
+    /**
+     * Emitted when the modal is closed
+     */
+    pdsModalClose: EventEmitter<void>;
+    /**
+     * Stores the list of focusable elements in the modal
+     */
+    focusableElementsArray: HTMLElement[];
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    handleOpenChange(newValue: boolean): void;
+    /**
+     * Updates the list of focusable elements in the modal
+     */
+    private updateFocusableElements;
+    /**
+     * Sets focus to the first focusable element in the modal
+     */
+    private setInitialFocus;
+    /**
+     * Helper method to focus an element, with special handling for web components
+     */
+    private focusElement;
+    /**
+     * Opens the modal
+     */
+    showModal(): Promise<void>;
+    /**
+     * Closes the modal
+     */
+    hideModal(): Promise<void>;
+    private handleBackdropClick;
+    /**
+     * Gets the z-index of a modal's backdrop element
+     */
+    private getBackdropZIndex;
+    /**
+     * Checks if this modal is the innermost (highest z-index) modal
+     */
+    private isInnermostModal;
+    private handleKeyDown;
+    render(): any;
+}

package/dist/types/components/pds-modal/test/mock-pds-modal.d.ts

@@ -0,0 +1,63 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+interface HTMLMockPdsModalElement extends HTMLElement {
+    open: boolean;
+    showModal: () => Promise<void>;
+    hideModal: () => Promise<void>;
+    handleBackdropClick: (event: MouseEvent) => void;
+    handleKeyDown: (event: KeyboardEvent) => void;
+}
+/**
+ * Mock PdsModal component for testing purposes
+ * This component mimics the real PdsModal but without using the Popover API
+ */
+export declare class MockPdsModal {
+    el: HTMLMockPdsModalElement;
+    /**
+     * The ID of the modal component
+     */
+    componentId?: string;
+    /**
+     * The size of the modal
+     */
+    size: 'sm' | 'md' | 'lg' | 'fullscreen';
+    /**
+     * Whether the modal can be dismissed by clicking the backdrop
+     */
+    backdropDismiss: boolean;
+    /**
+     * Whether the modal is open
+     */
+    open: boolean;
+    /**
+     * Event emitted when the modal is opened
+     */
+    pdsModalOpen: EventEmitter;
+    /**
+     * Event emitted when the modal is closed
+     */
+    pdsModalClose: EventEmitter;
+    /**
+     * Event emitted when the backdrop is clicked
+     */
+    pdsModalBackdropClick: EventEmitter;
+    /**
+     * Shows the modal
+     */
+    showModal(): Promise<void>;
+    /**
+     * Hides the modal
+     */
+    hideModal(): Promise<void>;
+    /**
+     * Listen for click events on the backdrop
+     */
+    handleBackdropClick(event: MouseEvent): void;
+    /**
+     * Listen for keydown events to handle Escape key
+     * Native dialog element always closes on Escape key press
+     */
+    handleKeyDown(event: KeyboardEvent): void;
+    componentDidLoad(): void;
+    render(): any;
+}
+export {};

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

@@ -0,0 +1,57 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export declare class PdsToast {
+    /**
+     * A unique identifier used for the underlying component `id` attribute.
+     */
+    componentId: string;
+    /**
+     * Whether the toast can be dismissed manually via the close button.
+     * Note: This only controls manual dismissal. Auto-dismissal via duration still applies.
+     * @default true
+     */
+    dismissible: boolean;
+    /**
+     * The duration in milliseconds to show the toast before auto-dismissing.
+     * Set to 0 to disable auto-dismiss.
+     * @default 4500
+     */
+    duration: number;
+    /**
+     * The name of the icon to display in the toast.
+     */
+    icon?: string;
+    /**
+     * The type of toast to display.
+     * - default: Grey background (default)
+     * - danger: Red background
+     * - loading: With spinner animation
+     * @default 'default'
+     */
+    type: 'default' | 'danger' | 'loading';
+    /**
+     * Whether the toast is currently visible.
+     */
+    isVisible: boolean;
+    /**
+     * Whether the toast is animating out.
+     */
+    isAnimatingOut: boolean;
+    /**
+     * Timer for auto-dismissal
+     */
+    private dismissTimer?;
+    /**
+     * Event emitted when the toast is dismissed, either manually or automatically.
+     */
+    pdsToastDismissed: EventEmitter<{
+        componentId?: string;
+    }>;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    handleDurationChange(newDuration: number): void;
+    dismiss(): Promise<void>;
+    private cleanup;
+    private startDismissTimer;
+    private renderIcon;
+    render(): any;
+}

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

@@ -3,7 +3,17 @@
  * @slot content - HTML content for the tooltip
  */
 export declare class PdsTooltip {
-    private contentEl;
+    private static instanceCounter;
+    /**
+     * Internal state: true if the tooltip was opened by user interaction (hover/focus),
+     * false if opened via the `opened` prop or currently closed.
+     */
+    private _isInteractiveOpen;
+    private portalEl;
+    private triggerEl;
+    private contentDiv;
+    private slotMutationObserver;
+    private overlayResizeObserver;
     /**
      * Reference to the Host element
      */
@@ -46,10 +56,9 @@ export declare class PdsTooltip {
      * @defaultValue false
      */
     opened: boolean;
-    handleOpenToggle(): void;
+    handleOpenToggle(newValue: boolean, oldValue: boolean): void;
     componentWillLoad(): void;
     componentDidLoad(): () => void;
-    componentDidUpdate(): void;
     componentDidRender(): void;
     /**
      * Shows the tooltip by enabling the opened property
@@ -62,5 +71,21 @@ export declare class PdsTooltip {
     private handleHide;
     private handleShow;
     private handlePageShow;
+    private handleScroll;
+    private handleSpaNavigation;
+    /**
+     * Determines the most accurate HTML element to use as the anchor for positioning the tooltip.
+     * If `htmlContent` is false, it attempts to find the actual element slotted as the trigger.
+     * Otherwise, or if no specific element is found, it defaults to the span wrapper around the trigger slot.
+     * This helps with precise alignment.
+     */
+    private determinePositioningAnchor;
+    /**
+     * Centralized method to calculate and apply the tooltip's position.
+     * Uses the determined anchor element and the current content dimensions.
+     */
+    private repositionPortal;
+    private createPortal;
+    private removePortal;
     render(): any;
 }