@makigamestudio/ui-core 0.7.0 → 0.9.0

package/fesm2022/makigamestudio-ui-core.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Injectable, signal } from '@angular/core';
+import { Injectable, signal, inject, DestroyRef } from '@angular/core';
 
 /**
  * @file Action button type enumeration
@@ -653,6 +653,602 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImpor
             type: Injectable
         }] });
 
+/**
+ * @file Device Detection Service
+ * @description Detects and tracks device type (mobile/desktop) based on user-agent and viewport width.
+ *
+ * This service provides a reactive signal that updates when the viewport is resized,
+ * allowing components to respond to device type changes. The service uses OR logic,
+ * considering a device mobile if EITHER the user-agent indicates a mobile device
+ * OR the viewport width is less than 768px.
+ *
+ * @example
+ * ```typescript
+ * // Component usage
+ * @Component({
+ *   selector: 'app-example',
+ *   template: `
+ *     @if (deviceDetection.isMobile()) {
+ *       <p>Mobile view</p>
+ *     } @else {
+ *       <p>Desktop view</p>
+ *     }
+ *   `
+ * })
+ * export class ExampleComponent {
+ *   readonly deviceDetection = inject(DeviceDetectionService);
+ * }
+ *
+ * // Direct usage in computed signals
+ * @Component({
+ *   selector: 'app-layout'
+ * })
+ * export class LayoutComponent {
+ *   private readonly deviceDetection = inject(DeviceDetectionService);
+ *
+ *   readonly showSidebar = computed(() =>
+ *     !this.deviceDetection.isMobile()
+ *   );
+ * }
+ * ```
+ */
+/**
+ * Service for detecting and tracking device type based on user-agent and viewport width.
+ *
+ * The service initializes on construction and sets up a window resize listener to
+ * track viewport changes. It uses OR logic to determine if the device is mobile:
+ * - User-agent matches mobile device patterns
+ * - OR viewport width is less than 768px
+ *
+ * The resize listener is automatically cleaned up when the service is destroyed.
+ *
+ * @usageNotes
+ *
+ * ### Basic Usage
+ * Inject the service and use the `isMobile()` signal in templates or computed signals:
+ *
+ * ```typescript
+ * export class MyComponent {
+ *   readonly deviceDetection = inject(DeviceDetectionService);
+ * }
+ * ```
+ *
+ * ### Template Usage
+ * ```typescript
+ * @if (deviceDetection.isMobile()) {
+ *   <ion-icon name="phone-portrait-outline" />
+ * } @else {
+ *   <ion-icon name="desktop-outline" />
+ * }
+ * ```
+ *
+ * ### Computed Signals
+ * ```typescript
+ * readonly layout = computed(() =>
+ *   this.deviceDetection.isMobile() ? 'mobile' : 'desktop'
+ * );
+ * ```
+ */
+class DeviceDetectionService {
+    destroyRef = inject(DestroyRef);
+    /**
+     * Regular expression pattern for detecting mobile devices via user-agent.
+     * Matches common mobile device identifiers including:
+     * - Android devices
+     * - iOS devices (iPhone, iPad, iPod)
+     * - Windows Phone (IEMobile)
+     * - BlackBerry
+     * - Opera Mini mobile browser
+     * - webOS devices
+     */
+    MOBILE_REGEX = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;
+    /**
+     * Breakpoint width (in pixels) below which viewport is considered mobile.
+     * @constant
+     */
+    MOBILE_BREAKPOINT = 768;
+    /**
+     * Private writable signal tracking mobile device state.
+     */
+    _isMobile = signal(false, ...(ngDevMode ? [{ debugName: "_isMobile" }] : []));
+    /**
+     * Public readonly signal indicating whether the device is mobile.
+     * Returns `true` if EITHER user-agent indicates mobile OR viewport width < 768px.
+     *
+     * @returns Readonly signal of mobile device state
+     *
+     * @example
+     * ```typescript
+     * const deviceDetection = inject(DeviceDetectionService);
+     * const isMobile = deviceDetection.isMobile();
+     * console.log(`Device is ${isMobile ? 'mobile' : 'desktop'}`);
+     * ```
+     */
+    isMobile = this._isMobile.asReadonly();
+    constructor() {
+        // Initialize mobile state
+        this._isMobile.set(this.checkDevice());
+        // Set up resize listener
+        const resizeHandler = () => {
+            this._isMobile.set(this.checkDevice());
+        };
+        window.addEventListener('resize', resizeHandler);
+        // Cleanup on service destruction
+        this.destroyRef.onDestroy(() => {
+            window.removeEventListener('resize', resizeHandler);
+        });
+    }
+    /**
+     * Checks if the device should be considered mobile based on user-agent and viewport width.
+     *
+     * Uses OR logic: returns `true` if EITHER condition is met:
+     * - User-agent matches mobile device pattern
+     * - Viewport width is less than 768px
+     *
+     * @returns `true` if device is mobile, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const deviceDetection = inject(DeviceDetectionService);
+     * const isMobile = deviceDetection.checkDevice();
+     * // isMobile will be true if:
+     * // - User-agent contains "Android", "iPhone", etc.
+     * // - OR window.innerWidth < 768
+     * ```
+     */
+    checkDevice() {
+        const isMobileUA = this.MOBILE_REGEX.test(navigator.userAgent);
+        const isMobileViewport = window.innerWidth < this.MOBILE_BREAKPOINT;
+        return isMobileUA || isMobileViewport;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DeviceDetectionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DeviceDetectionService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DeviceDetectionService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: () => [] });
+
+/**
+ * @file Tooltip Service
+ * @description UI-agnostic service for tooltip positioning and display logic.
+ *
+ * This service provides pure computational functions for tooltip positioning
+ * and visibility rules, making it reusable across different UI library
+ * implementations (Ionic, Material, PrimeNG, etc.).
+ *
+ * @example
+ * ```typescript
+ * // Ionic implementation (MakiTooltipDirective)
+ * @Directive({
+ *   selector: '[makiTooltip]'
+ * })
+ * export class MakiTooltipDirective {
+ *   private readonly tooltipService = inject(TooltipService);
+ *   private readonly deviceDetection = inject(DeviceDetectionService);
+ *
+ *   private positionTooltip(): void {
+ *     const triggerRect = this.el.nativeElement.getBoundingClientRect();
+ *     const tooltipRect = this.tooltip.getBoundingClientRect();
+ *     const position = this.tooltipService.calculatePosition(
+ *       triggerRect,
+ *       tooltipRect,
+ *       window.innerWidth,
+ *       window.innerHeight
+ *     );
+ *     this.applyPosition(position);
+ *   }
+ *
+ *   private shouldShow(): boolean {
+ *     const tag = this.el.nativeElement.tagName.toLowerCase();
+ *     return this.tooltipService.shouldShowTooltip(
+ *       tag,
+ *       this.deviceDetection.isMobile(),
+ *       !!this.content()
+ *     );
+ *   }
+ * }
+ *
+ * // Material implementation example
+ * @Directive({
+ *   selector: '[matTooltip]'
+ * })
+ * export class MatTooltipDirective {
+ *   private readonly tooltipService = inject(TooltipService);
+ *
+ *   private calculatePosition(): TooltipPosition {
+ *     return this.tooltipService.calculatePosition(
+ *       this.triggerRect,
+ *       this.tooltipRect,
+ *       window.innerWidth,
+ *       window.innerHeight
+ *     );
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Interactive element tags that should skip tooltips on mobile devices.
+ */
+const INTERACTIVE_ELEMENTS = [
+    'button',
+    'ion-button',
+    'ion-select',
+    'a',
+    'input',
+    'select',
+    'textarea'
+];
+/**
+ * Default gap between tooltip and trigger element (in pixels).
+ */
+const TOOLTIP_GAP = 5;
+/**
+ * Minimum distance from viewport edge (in pixels).
+ */
+const VIEWPORT_PADDING = 5;
+// ============================================================================
+// Service
+// ============================================================================
+/**
+ * Service providing UI-agnostic tooltip positioning and display logic.
+ *
+ * This service contains pure functions for calculating tooltip positions
+ * and determining when tooltips should be shown, without any DOM manipulation
+ * or framework-specific code.
+ *
+ * @usageNotes
+ *
+ * ### Positioning
+ * Use `calculatePosition()` to compute tooltip position based on element rectangles:
+ * ```typescript
+ * const position = tooltipService.calculatePosition(
+ *   triggerElement.getBoundingClientRect(),
+ *   tooltipElement.getBoundingClientRect(),
+ *   window.innerWidth,
+ *   window.innerHeight
+ * );
+ * tooltip.style.top = `${position.top}px`;
+ * tooltip.style.left = `${position.left}px`;
+ * ```
+ *
+ * ### Visibility Rules
+ * Use `shouldShowTooltip()` to determine if tooltip should appear:
+ * ```typescript
+ * if (tooltipService.shouldShowTooltip(element.tagName, isMobile, hasContent)) {
+ *   this.showTooltip();
+ * }
+ * ```
+ */
+class TooltipService {
+    /**
+     * Calculates the optimal position for a tooltip relative to its trigger element.
+     *
+     * The function attempts to position the tooltip below the trigger element by default.
+     * If the tooltip would overflow the viewport, it adjusts the position:
+     * - Positions above if it would overflow the bottom
+     * - Aligns to the right edge if it would overflow the right
+     *
+     * @param triggerRect - Bounding rectangle of the trigger element
+     * @param tooltipRect - Bounding rectangle of the tooltip element
+     * @param viewportWidth - Current viewport width (typically window.innerWidth)
+     * @param viewportHeight - Current viewport height (typically window.innerHeight)
+     * @param preferredPlacement - Optional preferred placement before fallback logic
+     * @returns Position object with top, left coordinates and final placement
+     *
+     * @example
+     * ```typescript
+     * const position = tooltipService.calculatePosition(
+     *   button.getBoundingClientRect(),
+     *   tooltip.getBoundingClientRect(),
+     *   window.innerWidth,
+     *   window.innerHeight,
+     *   'top'
+     * );
+     * // position = { top: 150, left: 100, placement: 'top' }
+     * ```
+     */
+    calculatePosition(triggerRect, tooltipRect, viewportWidth, viewportHeight, placement = 'bottom') {
+        const clampVertical = (top) => {
+            const maxTop = viewportHeight - tooltipRect.height - VIEWPORT_PADDING;
+            return Math.min(Math.max(VIEWPORT_PADDING, top), maxTop);
+        };
+        const calculatePositionFor = (placement) => {
+            let top;
+            let left;
+            const centeredTop = triggerRect.top + (triggerRect.height - tooltipRect.height) / 2;
+            switch (placement) {
+                case 'top':
+                    top = triggerRect.top - tooltipRect.height - TOOLTIP_GAP;
+                    left = triggerRect.left;
+                    break;
+                case 'bottom':
+                    top = triggerRect.bottom + TOOLTIP_GAP;
+                    left = triggerRect.left;
+                    break;
+                case 'left':
+                    top = clampVertical(centeredTop);
+                    left = triggerRect.left - tooltipRect.width - TOOLTIP_GAP;
+                    break;
+                case 'right':
+                    top = clampVertical(centeredTop);
+                    left = triggerRect.right + TOOLTIP_GAP;
+                    break;
+            }
+            if (placement === 'top' || placement === 'bottom') {
+                const wouldOverflowRight = triggerRect.left + tooltipRect.width > viewportWidth;
+                if (wouldOverflowRight) {
+                    const rightAligned = triggerRect.right - tooltipRect.width;
+                    left = Math.max(VIEWPORT_PADDING, rightAligned);
+                }
+            }
+            return { top, left, placement };
+        };
+        const fitsInViewport = (position) => {
+            const minTop = 0;
+            const maxTop = viewportHeight - tooltipRect.height;
+            // If the tooltip is wider than the viewport, horizontal placements
+            // ('left' or 'right') are effectively impossible and should not be
+            // considered valid. Only vertical placements are allowed in that case.
+            if (tooltipRect.width > viewportWidth) {
+                if (position.placement !== 'top' && position.placement !== 'bottom') {
+                    return false;
+                }
+                return position.top >= minTop && position.top <= maxTop;
+            }
+            const minLeft = VIEWPORT_PADDING;
+            const maxLeft = viewportWidth - tooltipRect.width;
+            return (position.left >= minLeft &&
+                position.left <= maxLeft &&
+                position.top >= minTop &&
+                position.top <= maxTop);
+        };
+        const preferredPosition = calculatePositionFor(placement);
+        if (fitsInViewport(preferredPosition)) {
+            return preferredPosition;
+        }
+        if (placement === 'bottom') {
+            const fallbackPosition = calculatePositionFor('top');
+            if (fitsInViewport(fallbackPosition)) {
+                return fallbackPosition;
+            }
+        }
+        if (placement === 'top') {
+            const fallbackPosition = calculatePositionFor('bottom');
+            if (fitsInViewport(fallbackPosition)) {
+                return fallbackPosition;
+            }
+        }
+        if (placement === 'left' || placement === 'right') {
+            const opposite = placement === 'left' ? 'right' : 'left';
+            const oppositePosition = calculatePositionFor(opposite);
+            if (fitsInViewport(oppositePosition)) {
+                return oppositePosition;
+            }
+            const bottomPosition = calculatePositionFor('bottom');
+            if (fitsInViewport(bottomPosition)) {
+                return bottomPosition;
+            }
+            const topPosition = calculatePositionFor('top');
+            if (fitsInViewport(topPosition)) {
+                return topPosition;
+            }
+        }
+        return preferredPosition;
+    }
+    /**
+     * Determines whether a tooltip should be shown based on context.
+     *
+     * On mobile devices, tooltips are suppressed for interactive elements
+     * (buttons, links, selects) to avoid interfering with their primary click handlers.
+     *
+     * @param elementTag - Lowercase tag name of the trigger element
+     * @param isMobile - Whether the device is currently considered mobile
+     * @param hasContent - Whether the tooltip has content to display
+     * @returns `true` if tooltip should be shown, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const shouldShow = tooltipService.shouldShowTooltip('button', true, true);
+     * // shouldShow = false (button on mobile)
+     *
+     * const shouldShow2 = tooltipService.shouldShowTooltip('div', true, true);
+     * // shouldShow2 = true (non-interactive on mobile)
+     *
+     * const shouldShow3 = tooltipService.shouldShowTooltip('button', false, true);
+     * // shouldShow3 = true (button on desktop)
+     * ```
+     */
+    shouldShowTooltip(elementTag, isMobile, hasContent) {
+        // No content = no tooltip
+        if (!hasContent) {
+            return false;
+        }
+        // On mobile, skip interactive elements
+        if (isMobile && this.isInteractiveElement(elementTag)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Checks if an element tag represents an interactive element.
+     *
+     * Interactive elements (buttons, links, form controls) typically have
+     * their own click/tap handlers, and showing tooltips on mobile can
+     * interfere with the primary interaction.
+     *
+     * @param elementTag - Lowercase tag name to check
+     * @returns `true` if the element is interactive, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * tooltipService.isInteractiveElement('button'); // true
+     * tooltipService.isInteractiveElement('ion-button'); // true
+     * tooltipService.isInteractiveElement('div'); // false
+     * tooltipService.isInteractiveElement('span'); // false
+     * ```
+     */
+    isInteractiveElement(elementTag) {
+        return INTERACTIVE_ELEMENTS.includes(elementTag.toLowerCase());
+    }
+    /**
+     * Checks if a tooltip element is visible (has non-zero dimensions).
+     *
+     * This is useful for detecting if an element has been hidden or removed
+     * from the layout, which should trigger tooltip dismissal.
+     *
+     * @param rect - Bounding rectangle of the element
+     * @returns `true` if element has visible dimensions, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const isVisible = tooltipService.isElementVisible(
+     *   element.getBoundingClientRect()
+     * );
+     * if (!isVisible) {
+     *   this.hideTooltip();
+     * }
+     * ```
+     */
+    isElementVisible(rect) {
+        return rect.width > 0 && rect.height > 0;
+    }
+    /**
+     *
+     * @returns Tooltip show delay in milliseconds.
+     */
+    getShowDelayMs() {
+        return 250;
+    }
+    /**
+     * @returns Tooltip close delay in milliseconds.
+     */
+    getCloseDelayMs() {
+        return 200;
+    }
+    /**
+     * @returns Tooltip fade duration in milliseconds.
+     */
+    getFadeDurationMs() {
+        return 150;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: TooltipService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: TooltipService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: TooltipService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }] });
+
+/**
+ * Singleton service that centralizes tooltip scheduling (show/hide delays).
+ * Purely orchestrates timers and delegates to provided callbacks; no DOM access.
+ */
+class TooltipSchedulerService {
+    tooltipService;
+    constructor(tooltipService) {
+        this.tooltipService = tooltipService;
+    }
+    /**
+     * Create an isolated scheduler handle for a single tooltip instance.
+     * The handle exposes the same event methods but keeps timers/state per-instance.
+     */
+    createHandle(show, hide) {
+        let showTimeout = null;
+        let closeTimeout = null;
+        let isTriggerHovering = false;
+        let isTooltipHovering = false;
+        let isTouching = false;
+        const clearShowTimeout = () => {
+            if (showTimeout) {
+                clearTimeout(showTimeout);
+                showTimeout = null;
+            }
+        };
+        const clearCloseTimeout = () => {
+            if (closeTimeout) {
+                clearTimeout(closeTimeout);
+                closeTimeout = null;
+            }
+        };
+        const scheduleShow = () => {
+            clearShowTimeout();
+            const ms = this.tooltipService.getShowDelayMs();
+            showTimeout = setTimeout(() => {
+                showTimeout = null;
+                invokeShow();
+            }, ms);
+        };
+        const scheduleClose = () => {
+            clearCloseTimeout();
+            const ms = this.tooltipService.getCloseDelayMs();
+            closeTimeout = setTimeout(() => {
+                closeTimeout = null;
+                if (!isTriggerHovering && !isTooltipHovering && !isTouching) {
+                    invokeHide();
+                }
+            }, ms);
+        };
+        const invokeShow = () => show();
+        const invokeHide = () => hide();
+        return {
+            destroy() {
+                clearShowTimeout();
+                clearCloseTimeout();
+            },
+            onTriggerEnter() {
+                isTriggerHovering = true;
+                clearCloseTimeout();
+                clearShowTimeout();
+                scheduleShow();
+            },
+            onTriggerLeave() {
+                isTriggerHovering = false;
+                clearShowTimeout();
+                scheduleClose();
+            },
+            onTooltipEnter() {
+                isTooltipHovering = true;
+                clearCloseTimeout();
+            },
+            onTooltipLeave() {
+                isTooltipHovering = false;
+                scheduleClose();
+            },
+            onTooltipTouchStart() {
+                isTouching = true;
+            },
+            onTooltipTouchEnd() {
+                isTouching = false;
+                scheduleClose();
+            },
+            onClick(isMobile) {
+                if (isMobile) {
+                    isTouching = true;
+                    invokeShow();
+                    return;
+                }
+                // Desktop toggle behavior
+                if (closeTimeout) {
+                    clearCloseTimeout();
+                    return;
+                }
+                invokeShow();
+            }
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: TooltipSchedulerService, deps: [{ token: TooltipService }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: TooltipSchedulerService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: TooltipSchedulerService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: TooltipService }] });
+
 /**
  * @file Services Barrel Export
  * @description Exports all services from the ui-core library.
@@ -670,5 +1266,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { ActionButtonListService, ActionButtonType, ButtonDisplayService, ButtonHandlerService, ButtonStateService };
+export { ActionButtonListService, ActionButtonType, ButtonDisplayService, ButtonHandlerService, ButtonStateService, DeviceDetectionService, TooltipSchedulerService, TooltipService };
 //# sourceMappingURL=makigamestudio-ui-core.mjs.map

package/fesm2022/makigamestudio-ui-core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"makigamestudio-ui-core.mjs","sources":["../../../projects/ui-core/src/lib/interfaces/action-button-type.enum.ts","../../../projects/ui-core/src/lib/services/action-button-list.service.ts","../../../projects/ui-core/src/lib/services/button-display.service.ts","../../../projects/ui-core/src/lib/services/button-handler.service.ts","../../../projects/ui-core/src/lib/services/button-state.service.ts","../../../projects/ui-core/src/lib/services/index.ts","../../../projects/ui-core/src/public-api.ts","../../../projects/ui-core/src/makigamestudio-ui-core.ts"],"sourcesContent":["/**\n * @file Action button type enumeration\n * @description Defines the display types for action buttons\n */\n\n/**\n * Enumeration of action button types.\n *\n * Both types support flexible display formats:\n * - Icon + Label: Provide both `icon` and `label` properties\n * - Icon only: Provide `icon` without `label`\n * - Label only: Provide `label` without `icon`\n *\n * @example\n * ```typescript\n * // Default button with label and icon\n * const saveButton: ActionButton = {\n *   id: 'save-btn',\n *   label: 'Save',\n *   icon: 'save-outline',\n *   type: ActionButtonType.Default,\n *   handler: () => console.log('Saved!')\n * };\n *\n * // Icon-only button (no label)\n * const iconButton: ActionButton = {\n *   id: 'settings-btn',\n *   icon: 'settings-outline',\n *   type: ActionButtonType.Default,\n *   ariaLabel: 'Settings',\n *   handler: () => console.log('Settings')\n * };\n *\n * // Label-only button (no icon)\n * const textButton: ActionButton = {\n *   id: 'cancel-btn',\n *   label: 'Cancel',\n *   type: ActionButtonType.Default,\n *   handler: () => console.log('Cancelled')\n * };\n * ```\n */\nexport enum ActionButtonType {\n  /**\n   * Standard action button.\n   * Display format (icon-only, label-only, or icon+label) is determined by which properties are provided.\n   */\n  Default = 'default',\n\n  /**\n   * Button that opens a dropdown popover with child actions.\n   * Like Default, supports icon-only, label-only, or icon+label display.\n   */\n  Dropdown = 'dropdown'\n}\n","/**\n * @file Action Button List Service\n * @description Provides logic for managing lists of action buttons in dropdowns/popovers.\n *\n * This service encapsulates all list-related logic for action buttons, making it\n * reusable across different UI library implementations (Ionic popover, Material menu,\n * PrimeNG overlay, etc.).\n *\n * @example\n * ```typescript\n * // Ionic implementation (ActionButtonListComponent)\n * @Component({\n *   providers: [ActionButtonListService],\n *   template: `\n *     <ion-list>\n *       @for (button of buttonList(); track button.id) {\n *         <ion-item\n *           [disabled]=\"!canSelectButton(button)\"\n *           (click)=\"onSelect(button)\"\n *         >\n *           @if (isButtonLoading(button)) {\n *             <ion-spinner slot=\"start\" />\n *           }\n *           <ion-label>{{ button.label }}</ion-label>\n *         </ion-item>\n *       }\n *     </ion-list>\n *   `\n * })\n * export class ActionButtonListComponent {\n *   private readonly listService = inject(ActionButtonListService);\n *\n *   readonly buttonList = computed(() =>\n *     this.listService.resolveButtonList(this._propsButtons(), this.buttons())\n *   );\n *\n *   protected isButtonLoading(button: ActionButton): boolean {\n *     return this.listService.isButtonLoading(button, this.loadingChildIds());\n *   }\n * }\n *\n * // Material Menu implementation example\n * @Component({\n *   selector: 'mat-action-menu',\n *   providers: [ActionButtonListService],\n *   template: `\n *     <mat-menu #menu=\"matMenu\">\n *       @for (button of buttonList(); track button.id) {\n *         <button mat-menu-item\n *           [disabled]=\"!canSelectButton(button)\"\n *           (click)=\"onSelect(button)\"\n *         >\n *           @if (isButtonLoading(button)) {\n *             <mat-spinner diameter=\"16\" />\n *           } @else if (button.icon) {\n *             <mat-icon>{{ button.icon }}</mat-icon>\n *           }\n *           <span>{{ button.label }}</span>\n *         </button>\n *       }\n *     </mat-menu>\n *   `\n * })\n * export class MatActionMenuComponent {\n *   private readonly listService = inject(ActionButtonListService);\n *   // ... similar implementation\n * }\n * ```\n */\n\nimport { Injectable, Signal } from '@angular/core';\n\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Service that provides logic for managing lists of action buttons.\n *\n * This service is designed to be provided at the component level to maintain\n * consistency with other button services.\n *\n * @usageNotes\n * ### Button List Resolution\n * The service handles two input sources for buttons:\n * 1. Direct property assignment (via PopoverController.create componentProps)\n * 2. Angular signal input binding\n *\n * Props take precedence over input when both are provided.\n *\n * ### Loading State\n * Loading state can come from:\n * 1. The button's own `loading` property\n * 2. A set of loading child IDs passed from the parent button\n *\n * ### Selection Validation\n * A button can be selected only if it's not loading and not disabled.\n */\n@Injectable()\nexport class ActionButtonListService {\n  /**\n   * Resolves the button list from either props or input.\n   * Props (from PopoverController) take precedence over input binding.\n   *\n   * @param propsButtons - Buttons passed via component props\n   * @param inputButtons - Buttons passed via signal input\n   * @returns The resolved button array\n   */\n  resolveButtonList(\n    propsButtons: readonly ActionButton[],\n    inputButtons: readonly ActionButton[]\n  ): readonly ActionButton[] {\n    return propsButtons.length > 0 ? propsButtons : inputButtons;\n  }\n\n  /**\n   * Checks if a button is currently in a loading state.\n   *\n   * @param button - The button to check\n   * @param loadingChildIds - Set of child IDs currently loading (optional)\n   * @returns True if the button is loading\n   */\n  isButtonLoading(button: ActionButton, loadingChildIds?: ReadonlySet<string>): boolean {\n    const ids = loadingChildIds ?? new Set<string>();\n    return (button.loading ?? false) || ids.has(button.id);\n  }\n\n  /**\n   * Checks if a button is currently in a loading state using a signal.\n   * Convenience method when loadingChildIds is provided as a signal.\n   *\n   * @param button - The button to check\n   * @param loadingChildIdsSignal - Signal containing loading child IDs (optional)\n   * @returns True if the button is loading\n   */\n  isButtonLoadingFromSignal(\n    button: ActionButton,\n    loadingChildIdsSignal: Signal<ReadonlySet<string>> | null\n  ): boolean {\n    const loadingChildIds = loadingChildIdsSignal ? loadingChildIdsSignal() : new Set<string>();\n    return this.isButtonLoading(button, loadingChildIds);\n  }\n\n  /**\n   * Determines if a button can be selected (clicked).\n   *\n   * @param button - The button to check\n   * @param loadingChildIds - Set of child IDs currently loading (optional)\n   * @returns True if the button can be selected\n   */\n  canSelectButton(button: ActionButton, loadingChildIds?: ReadonlySet<string>): boolean {\n    const isLoading = this.isButtonLoading(button, loadingChildIds);\n    const isDisabled = button.config?.disabled ?? false;\n    return !isLoading && !isDisabled;\n  }\n\n  /**\n   * Determines whether to show a loading spinner for a button.\n   *\n   * @param button - The button to check\n   * @param loadingChildIds - Set of child IDs currently loading (optional)\n   * @returns True if spinner should be shown\n   */\n  shouldShowSpinner(button: ActionButton, loadingChildIds?: ReadonlySet<string>): boolean {\n    const isLoading = this.isButtonLoading(button, loadingChildIds);\n    const showSpinner = button.showLoadingSpinner ?? true;\n    return isLoading && showSpinner;\n  }\n}\n","/**\n * @file Button Display Service\n * @description Provides display logic for action buttons (icon slots, label visibility, etc.).\n *\n * This service encapsulates all display-related logic for buttons, making it\n * reusable across different UI library implementations.\n *\n * @example\n * ```typescript\n * // Ionic implementation\n * @Component({\n *   providers: [ButtonDisplayService],\n *   template: `\n *     <ion-button\n        [fill]=\"button().config?.fill\"\n        [size]=\"button().config?.size\"\n        [color]=\"button().config?.color\"\n        [shape]=\"button().config?.shape\"\n        [expand]=\"button().config?.expand\"\n        [strong]=\"button().config?.strong\"\n        [disabled]=\"isDisabled()\"\n        [attr.aria-label]=\"button().ariaLabel\"\n        [title]=\"button().tooltip ?? ''\"\n        (click)=\"onClick($event)\"\n      >\n        @if (showLoadingSpinner()) {\n          <ion-spinner [slot]=\"iconSlot()\" name=\"crescent\" />\n        } @else if (button().icon) {\n          <ion-icon [name]=\"button().icon\" [slot]=\"iconSlot()\" class=\"button-icon\" />\n        }\n        @if (showLabel()) {\n          {{ button().label }}\n        }\n        @if (showDropdownIcon()) {\n          <ion-icon name=\"chevron-down-outline\" slot=\"end\" class=\"dropdown-icon\" />\n        }\n      </ion-button>\n *   `\n * })\n * export class ButtonComponent {\n *   private readonly displayService = inject(ButtonDisplayService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly showLabel = computed(() =>\n *     this.displayService.shouldShowLabel(this.button())\n *   );\n * }\n *\n * // PrimeNG implementation example\n * @Component({\n *   selector: 'p-action-button',\n *   providers: [ButtonDisplayService],\n *   template: `\n *     <p-button\n *       [icon]=\"button().icon\"\n *       [iconPos]=\"showLabel() ? 'left' : undefined\"\n *       [label]=\"showLabel() ? button().label : null\"\n *     />\n *   `\n * })\n * export class PrimeActionButtonComponent {\n *   private readonly displayService = inject(ButtonDisplayService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly showLabel = computed(() =>\n *     this.displayService.shouldShowLabel(this.button())\n *   );\n * }\n * ```\n */\n\nimport { Injectable } from '@angular/core';\n\nimport { ActionButtonType } from '../interfaces/action-button-type.enum';\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Service that provides display logic for action buttons.\n *\n * This service is designed to be provided at the component level to maintain\n * consistency with other button services, though it contains only pure functions.\n *\n * @usageNotes\n * ### Pure Functions\n * All methods in this service are pure functions that take a button configuration\n * and return display values. They can be safely used in Angular's `computed()`.\n *\n * ### Dropdown Icon\n * Dropdown buttons show a chevron icon unless `config.hideDropdownIcon` is true.\n */\n@Injectable()\nexport class ButtonDisplayService {\n  /**\n   * Determines whether to show the label text.\n   *\n   * @param button - The button configuration\n   * @returns True when a label is provided\n   */\n  shouldShowLabel(button: ActionButton): boolean {\n    return !!button.label;\n  }\n\n  /**\n   * Determines whether to show the dropdown chevron icon.\n   *\n   * @param button - The button configuration\n   * @returns True for dropdown buttons without hideDropdownIcon\n   */\n  shouldShowDropdownIcon(button: ActionButton): boolean {\n    return button.type === ActionButtonType.Dropdown && !button.config?.hideDropdownIcon;\n  }\n}\n","/**\n * @file Button Handler Service\n * @description Executes button handlers with automatic loading state management.\n *\n * This service encapsulates handler execution logic, providing automatic\n * loading state management for async handlers across different UI implementations.\n *\n * @example\n * ```typescript\n * // Ionic implementation\n * @Component({\n *   providers: [ButtonStateService, ButtonHandlerService]\n * })\n * export class ButtonComponent {\n *   private readonly stateService = inject(ButtonStateService);\n *   private readonly handlerService = inject(ButtonHandlerService);\n *\n *   protected async onClick(): Promise<void> {\n *     await this.handlerService.executeHandler(\n *       this.button(),\n *       loading => this.stateService.setLoading(loading)\n *     );\n *     this.buttonClick.emit(this.button());\n *   }\n * }\n *\n * // Generic web component example\n * class ActionButtonElement extends HTMLElement {\n *   private handlerService = new ButtonHandlerService();\n *   private loading = false;\n *\n *   async handleClick() {\n *     await this.handlerService.executeHandler(\n *       this.buttonConfig,\n *       loading => {\n *         this.loading = loading;\n *         this.render();\n *       }\n *     );\n *   }\n * }\n * ```\n */\n\nimport { Injectable } from '@angular/core';\n\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Callback function type for loading state changes.\n */\nexport type LoadingCallback = (loading: boolean) => void;\n\n/**\n * Callback function type for child loading state changes.\n */\nexport type ChildLoadingCallback = (childId: string, loading: boolean) => void;\n\n/**\n * Service that executes button handlers with automatic loading state management.\n *\n * This service is designed to be provided at the component level to ensure\n * proper isolation of handler execution context.\n *\n * @usageNotes\n * ### Async Handler Support\n * When a handler returns a Promise, the service automatically:\n * 1. Calls `onLoadingChange(true)` before execution\n * 2. Awaits the Promise\n * 3. Calls `onLoadingChange(false)` after completion (success or failure)\n *\n * ### Sync Handler Support\n * For synchronous handlers, no loading state changes are triggered.\n *\n * ### Error Handling\n * The service uses try/finally to ensure loading state is always reset,\n * even if the handler throws an error. The error is not caught, allowing\n * it to propagate to the calling code.\n */\n@Injectable()\nexport class ButtonHandlerService {\n  /**\n   * Executes a button's handler with automatic loading state management.\n   *\n   * @param button - The button whose handler to execute\n   * @param onLoadingChange - Callback invoked when loading state changes\n   * @returns Promise that resolves when handler completes\n   *\n   * @example\n   * ```typescript\n   * await handlerService.executeHandler(\n   *   myButton,\n   *   loading => this.isLoading.set(loading)\n   * );\n   * ```\n   */\n  async executeHandler(button: ActionButton, onLoadingChange: LoadingCallback): Promise<void> {\n    const result = button.handler();\n\n    if (result instanceof Promise) {\n      onLoadingChange(true);\n      try {\n        await result;\n      } finally {\n        onLoadingChange(false);\n      }\n    }\n  }\n\n  /**\n   * Executes a child button's handler with loading state tracking by ID.\n   *\n   * This method is designed for dropdown children where multiple buttons\n   * might be loading simultaneously and need individual tracking.\n   *\n   * @param child - The child button whose handler to execute\n   * @param onChildLoadingChange - Callback with child ID and loading state\n   * @returns Promise that resolves when handler completes\n   *\n   * @example\n   * ```typescript\n   * await handlerService.executeChildHandler(\n   *   selectedChild,\n   *   (childId, loading) => {\n   *     if (loading) {\n   *       this.stateService.addLoadingChild(childId);\n   *     } else {\n   *       this.stateService.removeLoadingChild(childId);\n   *     }\n   *   }\n   * );\n   * ```\n   */\n  async executeChildHandler(\n    child: ActionButton,\n    onChildLoadingChange: ChildLoadingCallback\n  ): Promise<void> {\n    onChildLoadingChange(child.id, true);\n    try {\n      const result = child.handler();\n      if (result instanceof Promise) {\n        await result;\n      }\n    } finally {\n      onChildLoadingChange(child.id, false);\n    }\n  }\n}\n","/**\n * @file Button State Service\n * @description Manages loading states and computed state values for action buttons.\n *\n * This service encapsulates all state management logic for buttons, making it\n * reusable across different UI library implementations (Ionic, Material, PrimeNG, etc.).\n *\n * @example\n * ```typescript\n * // Ionic implementation (ButtonComponent)\n * @Component({\n *   providers: [ButtonStateService]\n * })\n * export class ButtonComponent {\n *   private readonly stateService = inject(ButtonStateService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly isLoading = computed(() =>\n *     this.stateService.isLoading(this.button())\n *   );\n * }\n *\n * // Material implementation example\n * @Component({\n *   selector: 'mat-action-button',\n *   providers: [ButtonStateService],\n *   template: `\n *     <button mat-button [disabled]=\"isDisabled()\">\n *       @if (showLoadingSpinner()) {\n *         <mat-spinner diameter=\"16\" />\n *       }\n *       {{ button().label }}\n *     </button>\n *   `\n * })\n * export class MatActionButtonComponent {\n *   private readonly stateService = inject(ButtonStateService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly isDisabled = computed(() =>\n *     this.stateService.isDisabled(this.button())\n *   );\n *   readonly showLoadingSpinner = computed(() =>\n *     this.stateService.showLoadingSpinner(this.button())\n *   );\n * }\n * ```\n */\n\nimport { Injectable, signal } from '@angular/core';\n\nimport { ActionButtonType } from '../interfaces/action-button-type.enum';\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Service that manages button loading states and computes derived state values.\n *\n * This service is designed to be provided at the component level (not root)\n * to ensure each button instance has isolated state management.\n *\n * @usageNotes\n * ### Providing the Service\n * Always provide this service at the component level to isolate state:\n * ```typescript\n * @Component({\n *   providers: [ButtonStateService]\n * })\n * ```\n *\n * ### State Management\n * The service manages two types of loading state:\n * 1. **Internal loading** - Set when executing async handlers via `setLoading()`\n * 2. **Child loading** - Tracks which dropdown children are loading via `setChildLoading()`\n *\n * ### Computed States\n * All computed methods are pure functions that can be used in Angular's `computed()`:\n * - `isLoading(button)` - Combined loading state\n * - `isDisabled(button)` - Whether button should be disabled\n * - `showLoadingSpinner(button)` - Whether to show spinner\n * - `hasLoadingChild(button)` - Whether any child is loading\n */\n@Injectable()\nexport class ButtonStateService {\n  /**\n   * Internal loading state for async handler execution.\n   */\n  private readonly _isLoading = signal<boolean>(false);\n\n  /**\n   * Set of child button IDs that are currently loading (for dropdowns).\n   */\n  private readonly _loadingChildIds = signal<ReadonlySet<string>>(new Set());\n\n  /**\n   * Read-only access to internal loading state.\n   */\n  readonly internalLoading = this._isLoading.asReadonly();\n\n  /**\n   * Read-only access to loading child IDs.\n   */\n  readonly loadingChildIds = this._loadingChildIds.asReadonly();\n\n  /**\n   * Sets the internal loading state.\n   *\n   * @param loading - Whether the button is loading\n   */\n  setLoading(loading: boolean): void {\n    this._isLoading.set(loading);\n  }\n\n  /**\n   * Adds a child ID to the loading set.\n   *\n   * @param childId - The ID of the child button that started loading\n   */\n  addLoadingChild(childId: string): void {\n    this._loadingChildIds.update(ids => new Set([...ids, childId]));\n  }\n\n  /**\n   * Removes a child ID from the loading set.\n   *\n   * @param childId - The ID of the child button that finished loading\n   */\n  removeLoadingChild(childId: string): void {\n    this._loadingChildIds.update(ids => {\n      const newIds = new Set(ids);\n      newIds.delete(childId);\n      return newIds;\n    });\n  }\n\n  /**\n   * Checks if any child button is in a loading state with spinner enabled.\n   *\n   * @param button - The parent button configuration\n   * @returns True if any child is loading and should show spinner\n   */\n  hasLoadingChild(button: ActionButton): boolean {\n    if (button.type !== ActionButtonType.Dropdown || !button.children) {\n      return false;\n    }\n\n    const loadingChildIds = this._loadingChildIds();\n\n    return button.children.some(child => {\n      const showSpinner = child.showLoadingSpinner ?? true;\n      const isLoadingFromProp = child.loading && showSpinner;\n      const isLoadingFromExecution = loadingChildIds.has(child.id) && showSpinner;\n      return isLoadingFromProp || isLoadingFromExecution;\n    });\n  }\n\n  /**\n   * Computes the combined loading state for a button.\n   *\n   * @param button - The button configuration\n   * @returns True if the button is in any loading state\n   */\n  isLoading(button: ActionButton): boolean {\n    const parentLoading = this._isLoading() || (button.loading ?? false);\n    const childLoading = this.hasLoadingChild(button) && (button.showLoadingSpinner ?? true);\n    return parentLoading || childLoading;\n  }\n\n  /**\n   * Determines whether to display the loading spinner.\n   *\n   * @param button - The button configuration\n   * @returns True if spinner should be shown\n   */\n  showLoadingSpinner(button: ActionButton): boolean {\n    return this.isLoading(button) && (button.showLoadingSpinner ?? true);\n  }\n\n  /**\n   * Computes whether the button should be disabled.\n   *\n   * For dropdown buttons: Only disabled if config says so or if parent itself is loading\n   * (not disabled by inherited child loading - user can still open dropdown).\n   *\n   * For non-dropdown buttons: Disabled when loading or explicitly disabled in config.\n   *\n   * @param button - The button configuration\n   * @returns True if the button should be disabled\n   */\n  isDisabled(button: ActionButton): boolean {\n    const configDisabled = button.config?.disabled ?? false;\n\n    if (button.type === ActionButtonType.Dropdown) {\n      const parentSelfLoading = this._isLoading() || (button.loading ?? false);\n      return configDisabled || parentSelfLoading;\n    }\n\n    return this.isLoading(button) || configDisabled;\n  }\n\n  /**\n   * Checks if a specific button is currently loading.\n   * Used primarily for checking child button loading state.\n   *\n   * @param button - The button to check\n   * @returns True if the button is loading\n   */\n  isButtonLoading(button: ActionButton): boolean {\n    const loadingChildIds = this._loadingChildIds();\n    return (button.loading ?? false) || loadingChildIds.has(button.id);\n  }\n}\n","/**\n * @file Services Barrel Export\n * @description Exports all services from the ui-core library.\n */\n\nexport { ActionButtonListService } from './action-button-list.service';\nexport { ButtonDisplayService } from './button-display.service';\nexport { ButtonHandlerService } from './button-handler.service';\nexport type { ChildLoadingCallback, LoadingCallback } from './button-handler.service';\nexport { ButtonStateService } from './button-state.service';\n\n","/*\n * Public API Surface of @makigamestudio/ui-core\n *\n * This package provides UI-agnostic interfaces, services, and design tokens\n * for building action button components across different UI frameworks.\n */\n\n// ============================================================================\n// Interfaces\n// ============================================================================\n\n// Action Button Configuration (generic, UI-agnostic)\nexport type {\n    ActionButtonConfig,\n    BaseActionButtonConfig\n} from './lib/interfaces/action-button-config.interface';\n\n// Action Button Type Enum\nexport { ActionButtonType } from './lib/interfaces/action-button-type.enum';\n\n// Action Button Interface (generic, UI-agnostic)\nexport type { ActionButton } from './lib/interfaces/action-button.interface';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport {\n    ActionButtonListService,\n    ButtonDisplayService,\n    ButtonHandlerService,\n    ButtonStateService\n} from './lib/services';\n\nexport type { ChildLoadingCallback, LoadingCallback } from './lib/services';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"makigamestudio-ui-core.mjs","sources":["../../../projects/ui-core/src/lib/interfaces/action-button-type.enum.ts","../../../projects/ui-core/src/lib/services/action-button-list.service.ts","../../../projects/ui-core/src/lib/services/button-display.service.ts","../../../projects/ui-core/src/lib/services/button-handler.service.ts","../../../projects/ui-core/src/lib/services/button-state.service.ts","../../../projects/ui-core/src/lib/services/device-detection.service.ts","../../../projects/ui-core/src/lib/services/tooltip.service.ts","../../../projects/ui-core/src/lib/services/tooltip-scheduler.service.ts","../../../projects/ui-core/src/lib/services/index.ts","../../../projects/ui-core/src/public-api.ts","../../../projects/ui-core/src/makigamestudio-ui-core.ts"],"sourcesContent":["/**\n * @file Action button type enumeration\n * @description Defines the display types for action buttons\n */\n\n/**\n * Enumeration of action button types.\n *\n * Both types support flexible display formats:\n * - Icon + Label: Provide both `icon` and `label` properties\n * - Icon only: Provide `icon` without `label`\n * - Label only: Provide `label` without `icon`\n *\n * @example\n * ```typescript\n * // Default button with label and icon\n * const saveButton: ActionButton = {\n *   id: 'save-btn',\n *   label: 'Save',\n *   icon: 'save-outline',\n *   type: ActionButtonType.Default,\n *   handler: () => console.log('Saved!')\n * };\n *\n * // Icon-only button (no label)\n * const iconButton: ActionButton = {\n *   id: 'settings-btn',\n *   icon: 'settings-outline',\n *   type: ActionButtonType.Default,\n *   ariaLabel: 'Settings',\n *   handler: () => console.log('Settings')\n * };\n *\n * // Label-only button (no icon)\n * const textButton: ActionButton = {\n *   id: 'cancel-btn',\n *   label: 'Cancel',\n *   type: ActionButtonType.Default,\n *   handler: () => console.log('Cancelled')\n * };\n * ```\n */\nexport enum ActionButtonType {\n  /**\n   * Standard action button.\n   * Display format (icon-only, label-only, or icon+label) is determined by which properties are provided.\n   */\n  Default = 'default',\n\n  /**\n   * Button that opens a dropdown popover with child actions.\n   * Like Default, supports icon-only, label-only, or icon+label display.\n   */\n  Dropdown = 'dropdown'\n}\n","/**\n * @file Action Button List Service\n * @description Provides logic for managing lists of action buttons in dropdowns/popovers.\n *\n * This service encapsulates all list-related logic for action buttons, making it\n * reusable across different UI library implementations (Ionic popover, Material menu,\n * PrimeNG overlay, etc.).\n *\n * @example\n * ```typescript\n * // Ionic implementation (ActionButtonListComponent)\n * @Component({\n *   providers: [ActionButtonListService],\n *   template: `\n *     <ion-list>\n *       @for (button of buttonList(); track button.id) {\n *         <ion-item\n *           [disabled]=\"!canSelectButton(button)\"\n *           (click)=\"onSelect(button)\"\n *         >\n *           @if (isButtonLoading(button)) {\n *             <ion-spinner slot=\"start\" />\n *           }\n *           <ion-label>{{ button.label }}</ion-label>\n *         </ion-item>\n *       }\n *     </ion-list>\n *   `\n * })\n * export class ActionButtonListComponent {\n *   private readonly listService = inject(ActionButtonListService);\n *\n *   readonly buttonList = computed(() =>\n *     this.listService.resolveButtonList(this._propsButtons(), this.buttons())\n *   );\n *\n *   protected isButtonLoading(button: ActionButton): boolean {\n *     return this.listService.isButtonLoading(button, this.loadingChildIds());\n *   }\n * }\n *\n * // Material Menu implementation example\n * @Component({\n *   selector: 'mat-action-menu',\n *   providers: [ActionButtonListService],\n *   template: `\n *     <mat-menu #menu=\"matMenu\">\n *       @for (button of buttonList(); track button.id) {\n *         <button mat-menu-item\n *           [disabled]=\"!canSelectButton(button)\"\n *           (click)=\"onSelect(button)\"\n *         >\n *           @if (isButtonLoading(button)) {\n *             <mat-spinner diameter=\"16\" />\n *           } @else if (button.icon) {\n *             <mat-icon>{{ button.icon }}</mat-icon>\n *           }\n *           <span>{{ button.label }}</span>\n *         </button>\n *       }\n *     </mat-menu>\n *   `\n * })\n * export class MatActionMenuComponent {\n *   private readonly listService = inject(ActionButtonListService);\n *   // ... similar implementation\n * }\n * ```\n */\n\nimport { Injectable, Signal } from '@angular/core';\n\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Service that provides logic for managing lists of action buttons.\n *\n * This service is designed to be provided at the component level to maintain\n * consistency with other button services.\n *\n * @usageNotes\n * ### Button List Resolution\n * The service handles two input sources for buttons:\n * 1. Direct property assignment (via PopoverController.create componentProps)\n * 2. Angular signal input binding\n *\n * Props take precedence over input when both are provided.\n *\n * ### Loading State\n * Loading state can come from:\n * 1. The button's own `loading` property\n * 2. A set of loading child IDs passed from the parent button\n *\n * ### Selection Validation\n * A button can be selected only if it's not loading and not disabled.\n */\n@Injectable()\nexport class ActionButtonListService {\n  /**\n   * Resolves the button list from either props or input.\n   * Props (from PopoverController) take precedence over input binding.\n   *\n   * @param propsButtons - Buttons passed via component props\n   * @param inputButtons - Buttons passed via signal input\n   * @returns The resolved button array\n   */\n  resolveButtonList(\n    propsButtons: readonly ActionButton[],\n    inputButtons: readonly ActionButton[]\n  ): readonly ActionButton[] {\n    return propsButtons.length > 0 ? propsButtons : inputButtons;\n  }\n\n  /**\n   * Checks if a button is currently in a loading state.\n   *\n   * @param button - The button to check\n   * @param loadingChildIds - Set of child IDs currently loading (optional)\n   * @returns True if the button is loading\n   */\n  isButtonLoading(button: ActionButton, loadingChildIds?: ReadonlySet<string>): boolean {\n    const ids = loadingChildIds ?? new Set<string>();\n    return (button.loading ?? false) || ids.has(button.id);\n  }\n\n  /**\n   * Checks if a button is currently in a loading state using a signal.\n   * Convenience method when loadingChildIds is provided as a signal.\n   *\n   * @param button - The button to check\n   * @param loadingChildIdsSignal - Signal containing loading child IDs (optional)\n   * @returns True if the button is loading\n   */\n  isButtonLoadingFromSignal(\n    button: ActionButton,\n    loadingChildIdsSignal: Signal<ReadonlySet<string>> | null\n  ): boolean {\n    const loadingChildIds = loadingChildIdsSignal ? loadingChildIdsSignal() : new Set<string>();\n    return this.isButtonLoading(button, loadingChildIds);\n  }\n\n  /**\n   * Determines if a button can be selected (clicked).\n   *\n   * @param button - The button to check\n   * @param loadingChildIds - Set of child IDs currently loading (optional)\n   * @returns True if the button can be selected\n   */\n  canSelectButton(button: ActionButton, loadingChildIds?: ReadonlySet<string>): boolean {\n    const isLoading = this.isButtonLoading(button, loadingChildIds);\n    const isDisabled = button.config?.disabled ?? false;\n    return !isLoading && !isDisabled;\n  }\n\n  /**\n   * Determines whether to show a loading spinner for a button.\n   *\n   * @param button - The button to check\n   * @param loadingChildIds - Set of child IDs currently loading (optional)\n   * @returns True if spinner should be shown\n   */\n  shouldShowSpinner(button: ActionButton, loadingChildIds?: ReadonlySet<string>): boolean {\n    const isLoading = this.isButtonLoading(button, loadingChildIds);\n    const showSpinner = button.showLoadingSpinner ?? true;\n    return isLoading && showSpinner;\n  }\n}\n","/**\n * @file Button Display Service\n * @description Provides display logic for action buttons (icon slots, label visibility, etc.).\n *\n * This service encapsulates all display-related logic for buttons, making it\n * reusable across different UI library implementations.\n *\n * @example\n * ```typescript\n * // Ionic implementation\n * @Component({\n *   providers: [ButtonDisplayService],\n *   template: `\n *     <ion-button\n        [fill]=\"button().config?.fill\"\n        [size]=\"button().config?.size\"\n        [color]=\"button().config?.color\"\n        [shape]=\"button().config?.shape\"\n        [expand]=\"button().config?.expand\"\n        [strong]=\"button().config?.strong\"\n        [disabled]=\"isDisabled()\"\n        [attr.aria-label]=\"button().ariaLabel\"\n        [title]=\"button().tooltip ?? ''\"\n        (click)=\"onClick($event)\"\n      >\n        @if (showLoadingSpinner()) {\n          <ion-spinner [slot]=\"iconSlot()\" name=\"crescent\" />\n        } @else if (button().icon) {\n          <ion-icon [name]=\"button().icon\" [slot]=\"iconSlot()\" class=\"button-icon\" />\n        }\n        @if (showLabel()) {\n          {{ button().label }}\n        }\n        @if (showDropdownIcon()) {\n          <ion-icon name=\"chevron-down-outline\" slot=\"end\" class=\"dropdown-icon\" />\n        }\n      </ion-button>\n *   `\n * })\n * export class ButtonComponent {\n *   private readonly displayService = inject(ButtonDisplayService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly showLabel = computed(() =>\n *     this.displayService.shouldShowLabel(this.button())\n *   );\n * }\n *\n * // PrimeNG implementation example\n * @Component({\n *   selector: 'p-action-button',\n *   providers: [ButtonDisplayService],\n *   template: `\n *     <p-button\n *       [icon]=\"button().icon\"\n *       [iconPos]=\"showLabel() ? 'left' : undefined\"\n *       [label]=\"showLabel() ? button().label : null\"\n *     />\n *   `\n * })\n * export class PrimeActionButtonComponent {\n *   private readonly displayService = inject(ButtonDisplayService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly showLabel = computed(() =>\n *     this.displayService.shouldShowLabel(this.button())\n *   );\n * }\n * ```\n */\n\nimport { Injectable } from '@angular/core';\n\nimport { ActionButtonType } from '../interfaces/action-button-type.enum';\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Service that provides display logic for action buttons.\n *\n * This service is designed to be provided at the component level to maintain\n * consistency with other button services, though it contains only pure functions.\n *\n * @usageNotes\n * ### Pure Functions\n * All methods in this service are pure functions that take a button configuration\n * and return display values. They can be safely used in Angular's `computed()`.\n *\n * ### Dropdown Icon\n * Dropdown buttons show a chevron icon unless `config.hideDropdownIcon` is true.\n */\n@Injectable()\nexport class ButtonDisplayService {\n  /**\n   * Determines whether to show the label text.\n   *\n   * @param button - The button configuration\n   * @returns True when a label is provided\n   */\n  shouldShowLabel(button: ActionButton): boolean {\n    return !!button.label;\n  }\n\n  /**\n   * Determines whether to show the dropdown chevron icon.\n   *\n   * @param button - The button configuration\n   * @returns True for dropdown buttons without hideDropdownIcon\n   */\n  shouldShowDropdownIcon(button: ActionButton): boolean {\n    return button.type === ActionButtonType.Dropdown && !button.config?.hideDropdownIcon;\n  }\n}\n","/**\n * @file Button Handler Service\n * @description Executes button handlers with automatic loading state management.\n *\n * This service encapsulates handler execution logic, providing automatic\n * loading state management for async handlers across different UI implementations.\n *\n * @example\n * ```typescript\n * // Ionic implementation\n * @Component({\n *   providers: [ButtonStateService, ButtonHandlerService]\n * })\n * export class ButtonComponent {\n *   private readonly stateService = inject(ButtonStateService);\n *   private readonly handlerService = inject(ButtonHandlerService);\n *\n *   protected async onClick(): Promise<void> {\n *     await this.handlerService.executeHandler(\n *       this.button(),\n *       loading => this.stateService.setLoading(loading)\n *     );\n *     this.buttonClick.emit(this.button());\n *   }\n * }\n *\n * // Generic web component example\n * class ActionButtonElement extends HTMLElement {\n *   private handlerService = new ButtonHandlerService();\n *   private loading = false;\n *\n *   async handleClick() {\n *     await this.handlerService.executeHandler(\n *       this.buttonConfig,\n *       loading => {\n *         this.loading = loading;\n *         this.render();\n *       }\n *     );\n *   }\n * }\n * ```\n */\n\nimport { Injectable } from '@angular/core';\n\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Callback function type for loading state changes.\n */\nexport type LoadingCallback = (loading: boolean) => void;\n\n/**\n * Callback function type for child loading state changes.\n */\nexport type ChildLoadingCallback = (childId: string, loading: boolean) => void;\n\n/**\n * Service that executes button handlers with automatic loading state management.\n *\n * This service is designed to be provided at the component level to ensure\n * proper isolation of handler execution context.\n *\n * @usageNotes\n * ### Async Handler Support\n * When a handler returns a Promise, the service automatically:\n * 1. Calls `onLoadingChange(true)` before execution\n * 2. Awaits the Promise\n * 3. Calls `onLoadingChange(false)` after completion (success or failure)\n *\n * ### Sync Handler Support\n * For synchronous handlers, no loading state changes are triggered.\n *\n * ### Error Handling\n * The service uses try/finally to ensure loading state is always reset,\n * even if the handler throws an error. The error is not caught, allowing\n * it to propagate to the calling code.\n */\n@Injectable()\nexport class ButtonHandlerService {\n  /**\n   * Executes a button's handler with automatic loading state management.\n   *\n   * @param button - The button whose handler to execute\n   * @param onLoadingChange - Callback invoked when loading state changes\n   * @returns Promise that resolves when handler completes\n   *\n   * @example\n   * ```typescript\n   * await handlerService.executeHandler(\n   *   myButton,\n   *   loading => this.isLoading.set(loading)\n   * );\n   * ```\n   */\n  async executeHandler(button: ActionButton, onLoadingChange: LoadingCallback): Promise<void> {\n    const result = button.handler();\n\n    if (result instanceof Promise) {\n      onLoadingChange(true);\n      try {\n        await result;\n      } finally {\n        onLoadingChange(false);\n      }\n    }\n  }\n\n  /**\n   * Executes a child button's handler with loading state tracking by ID.\n   *\n   * This method is designed for dropdown children where multiple buttons\n   * might be loading simultaneously and need individual tracking.\n   *\n   * @param child - The child button whose handler to execute\n   * @param onChildLoadingChange - Callback with child ID and loading state\n   * @returns Promise that resolves when handler completes\n   *\n   * @example\n   * ```typescript\n   * await handlerService.executeChildHandler(\n   *   selectedChild,\n   *   (childId, loading) => {\n   *     if (loading) {\n   *       this.stateService.addLoadingChild(childId);\n   *     } else {\n   *       this.stateService.removeLoadingChild(childId);\n   *     }\n   *   }\n   * );\n   * ```\n   */\n  async executeChildHandler(\n    child: ActionButton,\n    onChildLoadingChange: ChildLoadingCallback\n  ): Promise<void> {\n    onChildLoadingChange(child.id, true);\n    try {\n      const result = child.handler();\n      if (result instanceof Promise) {\n        await result;\n      }\n    } finally {\n      onChildLoadingChange(child.id, false);\n    }\n  }\n}\n","/**\n * @file Button State Service\n * @description Manages loading states and computed state values for action buttons.\n *\n * This service encapsulates all state management logic for buttons, making it\n * reusable across different UI library implementations (Ionic, Material, PrimeNG, etc.).\n *\n * @example\n * ```typescript\n * // Ionic implementation (ButtonComponent)\n * @Component({\n *   providers: [ButtonStateService]\n * })\n * export class ButtonComponent {\n *   private readonly stateService = inject(ButtonStateService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly isLoading = computed(() =>\n *     this.stateService.isLoading(this.button())\n *   );\n * }\n *\n * // Material implementation example\n * @Component({\n *   selector: 'mat-action-button',\n *   providers: [ButtonStateService],\n *   template: `\n *     <button mat-button [disabled]=\"isDisabled()\">\n *       @if (showLoadingSpinner()) {\n *         <mat-spinner diameter=\"16\" />\n *       }\n *       {{ button().label }}\n *     </button>\n *   `\n * })\n * export class MatActionButtonComponent {\n *   private readonly stateService = inject(ButtonStateService);\n *   readonly button = input.required<ActionButton>();\n *\n *   readonly isDisabled = computed(() =>\n *     this.stateService.isDisabled(this.button())\n *   );\n *   readonly showLoadingSpinner = computed(() =>\n *     this.stateService.showLoadingSpinner(this.button())\n *   );\n * }\n * ```\n */\n\nimport { Injectable, signal } from '@angular/core';\n\nimport { ActionButtonType } from '../interfaces/action-button-type.enum';\nimport { ActionButton } from '../interfaces/action-button.interface';\n\n/**\n * Service that manages button loading states and computes derived state values.\n *\n * This service is designed to be provided at the component level (not root)\n * to ensure each button instance has isolated state management.\n *\n * @usageNotes\n * ### Providing the Service\n * Always provide this service at the component level to isolate state:\n * ```typescript\n * @Component({\n *   providers: [ButtonStateService]\n * })\n * ```\n *\n * ### State Management\n * The service manages two types of loading state:\n * 1. **Internal loading** - Set when executing async handlers via `setLoading()`\n * 2. **Child loading** - Tracks which dropdown children are loading via `setChildLoading()`\n *\n * ### Computed States\n * All computed methods are pure functions that can be used in Angular's `computed()`:\n * - `isLoading(button)` - Combined loading state\n * - `isDisabled(button)` - Whether button should be disabled\n * - `showLoadingSpinner(button)` - Whether to show spinner\n * - `hasLoadingChild(button)` - Whether any child is loading\n */\n@Injectable()\nexport class ButtonStateService {\n  /**\n   * Internal loading state for async handler execution.\n   */\n  private readonly _isLoading = signal<boolean>(false);\n\n  /**\n   * Set of child button IDs that are currently loading (for dropdowns).\n   */\n  private readonly _loadingChildIds = signal<ReadonlySet<string>>(new Set());\n\n  /**\n   * Read-only access to internal loading state.\n   */\n  readonly internalLoading = this._isLoading.asReadonly();\n\n  /**\n   * Read-only access to loading child IDs.\n   */\n  readonly loadingChildIds = this._loadingChildIds.asReadonly();\n\n  /**\n   * Sets the internal loading state.\n   *\n   * @param loading - Whether the button is loading\n   */\n  setLoading(loading: boolean): void {\n    this._isLoading.set(loading);\n  }\n\n  /**\n   * Adds a child ID to the loading set.\n   *\n   * @param childId - The ID of the child button that started loading\n   */\n  addLoadingChild(childId: string): void {\n    this._loadingChildIds.update(ids => new Set([...ids, childId]));\n  }\n\n  /**\n   * Removes a child ID from the loading set.\n   *\n   * @param childId - The ID of the child button that finished loading\n   */\n  removeLoadingChild(childId: string): void {\n    this._loadingChildIds.update(ids => {\n      const newIds = new Set(ids);\n      newIds.delete(childId);\n      return newIds;\n    });\n  }\n\n  /**\n   * Checks if any child button is in a loading state with spinner enabled.\n   *\n   * @param button - The parent button configuration\n   * @returns True if any child is loading and should show spinner\n   */\n  hasLoadingChild(button: ActionButton): boolean {\n    if (button.type !== ActionButtonType.Dropdown || !button.children) {\n      return false;\n    }\n\n    const loadingChildIds = this._loadingChildIds();\n\n    return button.children.some(child => {\n      const showSpinner = child.showLoadingSpinner ?? true;\n      const isLoadingFromProp = child.loading && showSpinner;\n      const isLoadingFromExecution = loadingChildIds.has(child.id) && showSpinner;\n      return isLoadingFromProp || isLoadingFromExecution;\n    });\n  }\n\n  /**\n   * Computes the combined loading state for a button.\n   *\n   * @param button - The button configuration\n   * @returns True if the button is in any loading state\n   */\n  isLoading(button: ActionButton): boolean {\n    const parentLoading = this._isLoading() || (button.loading ?? false);\n    const childLoading = this.hasLoadingChild(button) && (button.showLoadingSpinner ?? true);\n    return parentLoading || childLoading;\n  }\n\n  /**\n   * Determines whether to display the loading spinner.\n   *\n   * @param button - The button configuration\n   * @returns True if spinner should be shown\n   */\n  showLoadingSpinner(button: ActionButton): boolean {\n    return this.isLoading(button) && (button.showLoadingSpinner ?? true);\n  }\n\n  /**\n   * Computes whether the button should be disabled.\n   *\n   * For dropdown buttons: Only disabled if config says so or if parent itself is loading\n   * (not disabled by inherited child loading - user can still open dropdown).\n   *\n   * For non-dropdown buttons: Disabled when loading or explicitly disabled in config.\n   *\n   * @param button - The button configuration\n   * @returns True if the button should be disabled\n   */\n  isDisabled(button: ActionButton): boolean {\n    const configDisabled = button.config?.disabled ?? false;\n\n    if (button.type === ActionButtonType.Dropdown) {\n      const parentSelfLoading = this._isLoading() || (button.loading ?? false);\n      return configDisabled || parentSelfLoading;\n    }\n\n    return this.isLoading(button) || configDisabled;\n  }\n\n  /**\n   * Checks if a specific button is currently loading.\n   * Used primarily for checking child button loading state.\n   *\n   * @param button - The button to check\n   * @returns True if the button is loading\n   */\n  isButtonLoading(button: ActionButton): boolean {\n    const loadingChildIds = this._loadingChildIds();\n    return (button.loading ?? false) || loadingChildIds.has(button.id);\n  }\n}\n","/**\n * @file Device Detection Service\n * @description Detects and tracks device type (mobile/desktop) based on user-agent and viewport width.\n *\n * This service provides a reactive signal that updates when the viewport is resized,\n * allowing components to respond to device type changes. The service uses OR logic,\n * considering a device mobile if EITHER the user-agent indicates a mobile device\n * OR the viewport width is less than 768px.\n *\n * @example\n * ```typescript\n * // Component usage\n * @Component({\n *   selector: 'app-example',\n *   template: `\n *     @if (deviceDetection.isMobile()) {\n *       <p>Mobile view</p>\n *     } @else {\n *       <p>Desktop view</p>\n *     }\n *   `\n * })\n * export class ExampleComponent {\n *   readonly deviceDetection = inject(DeviceDetectionService);\n * }\n *\n * // Direct usage in computed signals\n * @Component({\n *   selector: 'app-layout'\n * })\n * export class LayoutComponent {\n *   private readonly deviceDetection = inject(DeviceDetectionService);\n *\n *   readonly showSidebar = computed(() =>\n *     !this.deviceDetection.isMobile()\n *   );\n * }\n * ```\n */\n\nimport { DestroyRef, Injectable, inject, signal } from '@angular/core';\n\n/**\n * Service for detecting and tracking device type based on user-agent and viewport width.\n *\n * The service initializes on construction and sets up a window resize listener to\n * track viewport changes. It uses OR logic to determine if the device is mobile:\n * - User-agent matches mobile device patterns\n * - OR viewport width is less than 768px\n *\n * The resize listener is automatically cleaned up when the service is destroyed.\n *\n * @usageNotes\n *\n * ### Basic Usage\n * Inject the service and use the `isMobile()` signal in templates or computed signals:\n *\n * ```typescript\n * export class MyComponent {\n *   readonly deviceDetection = inject(DeviceDetectionService);\n * }\n * ```\n *\n * ### Template Usage\n * ```typescript\n * @if (deviceDetection.isMobile()) {\n *   <ion-icon name=\"phone-portrait-outline\" />\n * } @else {\n *   <ion-icon name=\"desktop-outline\" />\n * }\n * ```\n *\n * ### Computed Signals\n * ```typescript\n * readonly layout = computed(() =>\n *   this.deviceDetection.isMobile() ? 'mobile' : 'desktop'\n * );\n * ```\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class DeviceDetectionService {\n  private readonly destroyRef = inject(DestroyRef);\n\n  /**\n   * Regular expression pattern for detecting mobile devices via user-agent.\n   * Matches common mobile device identifiers including:\n   * - Android devices\n   * - iOS devices (iPhone, iPad, iPod)\n   * - Windows Phone (IEMobile)\n   * - BlackBerry\n   * - Opera Mini mobile browser\n   * - webOS devices\n   */\n  private readonly MOBILE_REGEX = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;\n\n  /**\n   * Breakpoint width (in pixels) below which viewport is considered mobile.\n   * @constant\n   */\n  private readonly MOBILE_BREAKPOINT = 768;\n\n  /**\n   * Private writable signal tracking mobile device state.\n   */\n  private readonly _isMobile = signal<boolean>(false);\n\n  /**\n   * Public readonly signal indicating whether the device is mobile.\n   * Returns `true` if EITHER user-agent indicates mobile OR viewport width < 768px.\n   *\n   * @returns Readonly signal of mobile device state\n   *\n   * @example\n   * ```typescript\n   * const deviceDetection = inject(DeviceDetectionService);\n   * const isMobile = deviceDetection.isMobile();\n   * console.log(`Device is ${isMobile ? 'mobile' : 'desktop'}`);\n   * ```\n   */\n  readonly isMobile = this._isMobile.asReadonly();\n\n  constructor() {\n    // Initialize mobile state\n    this._isMobile.set(this.checkDevice());\n\n    // Set up resize listener\n    const resizeHandler = (): void => {\n      this._isMobile.set(this.checkDevice());\n    };\n\n    window.addEventListener('resize', resizeHandler);\n\n    // Cleanup on service destruction\n    this.destroyRef.onDestroy(() => {\n      window.removeEventListener('resize', resizeHandler);\n    });\n  }\n\n  /**\n   * Checks if the device should be considered mobile based on user-agent and viewport width.\n   *\n   * Uses OR logic: returns `true` if EITHER condition is met:\n   * - User-agent matches mobile device pattern\n   * - Viewport width is less than 768px\n   *\n   * @returns `true` if device is mobile, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * const deviceDetection = inject(DeviceDetectionService);\n   * const isMobile = deviceDetection.checkDevice();\n   * // isMobile will be true if:\n   * // - User-agent contains \"Android\", \"iPhone\", etc.\n   * // - OR window.innerWidth < 768\n   * ```\n   */\n  private checkDevice(): boolean {\n    const isMobileUA = this.MOBILE_REGEX.test(navigator.userAgent);\n    const isMobileViewport = window.innerWidth < this.MOBILE_BREAKPOINT;\n    return isMobileUA || isMobileViewport;\n  }\n}\n","/**\n * @file Tooltip Service\n * @description UI-agnostic service for tooltip positioning and display logic.\n *\n * This service provides pure computational functions for tooltip positioning\n * and visibility rules, making it reusable across different UI library\n * implementations (Ionic, Material, PrimeNG, etc.).\n *\n * @example\n * ```typescript\n * // Ionic implementation (MakiTooltipDirective)\n * @Directive({\n *   selector: '[makiTooltip]'\n * })\n * export class MakiTooltipDirective {\n *   private readonly tooltipService = inject(TooltipService);\n *   private readonly deviceDetection = inject(DeviceDetectionService);\n *\n *   private positionTooltip(): void {\n *     const triggerRect = this.el.nativeElement.getBoundingClientRect();\n *     const tooltipRect = this.tooltip.getBoundingClientRect();\n *     const position = this.tooltipService.calculatePosition(\n *       triggerRect,\n *       tooltipRect,\n *       window.innerWidth,\n *       window.innerHeight\n *     );\n *     this.applyPosition(position);\n *   }\n *\n *   private shouldShow(): boolean {\n *     const tag = this.el.nativeElement.tagName.toLowerCase();\n *     return this.tooltipService.shouldShowTooltip(\n *       tag,\n *       this.deviceDetection.isMobile(),\n *       !!this.content()\n *     );\n *   }\n * }\n *\n * // Material implementation example\n * @Directive({\n *   selector: '[matTooltip]'\n * })\n * export class MatTooltipDirective {\n *   private readonly tooltipService = inject(TooltipService);\n *\n *   private calculatePosition(): TooltipPosition {\n *     return this.tooltipService.calculatePosition(\n *       this.triggerRect,\n *       this.tooltipRect,\n *       window.innerWidth,\n *       window.innerHeight\n *     );\n *   }\n * }\n * ```\n */\n\nimport { Injectable } from '@angular/core';\n\n// ============================================================================\n// Interfaces\n// ============================================================================\n\n/**\n * Position data for tooltip placement.\n */\nexport interface TooltipPosition {\n  /** CSS top value in pixels */\n  readonly top: number;\n  /** CSS left value in pixels */\n  readonly left: number;\n  /** Actual placement after overflow adjustment */\n  readonly placement: TooltipPlacement;\n}\n\n/**\n * Tooltip placement options.\n */\nexport type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';\n\n/**\n * Rectangle dimensions for positioning calculations.\n * Compatible with DOMRect from getBoundingClientRect().\n */\nexport interface ElementRect {\n  readonly top: number;\n  readonly bottom: number;\n  readonly left: number;\n  readonly right: number;\n  readonly width: number;\n  readonly height: number;\n}\n\n/**\n * Interactive element tags that should skip tooltips on mobile devices.\n */\nconst INTERACTIVE_ELEMENTS: readonly string[] = [\n  'button',\n  'ion-button',\n  'ion-select',\n  'a',\n  'input',\n  'select',\n  'textarea'\n];\n\n/**\n * Default gap between tooltip and trigger element (in pixels).\n */\nconst TOOLTIP_GAP = 5;\n\n/**\n * Minimum distance from viewport edge (in pixels).\n */\nconst VIEWPORT_PADDING = 5;\n\n// ============================================================================\n// Service\n// ============================================================================\n\n/**\n * Service providing UI-agnostic tooltip positioning and display logic.\n *\n * This service contains pure functions for calculating tooltip positions\n * and determining when tooltips should be shown, without any DOM manipulation\n * or framework-specific code.\n *\n * @usageNotes\n *\n * ### Positioning\n * Use `calculatePosition()` to compute tooltip position based on element rectangles:\n * ```typescript\n * const position = tooltipService.calculatePosition(\n *   triggerElement.getBoundingClientRect(),\n *   tooltipElement.getBoundingClientRect(),\n *   window.innerWidth,\n *   window.innerHeight\n * );\n * tooltip.style.top = `${position.top}px`;\n * tooltip.style.left = `${position.left}px`;\n * ```\n *\n * ### Visibility Rules\n * Use `shouldShowTooltip()` to determine if tooltip should appear:\n * ```typescript\n * if (tooltipService.shouldShowTooltip(element.tagName, isMobile, hasContent)) {\n *   this.showTooltip();\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class TooltipService {\n  /**\n   * Calculates the optimal position for a tooltip relative to its trigger element.\n   *\n   * The function attempts to position the tooltip below the trigger element by default.\n   * If the tooltip would overflow the viewport, it adjusts the position:\n   * - Positions above if it would overflow the bottom\n   * - Aligns to the right edge if it would overflow the right\n   *\n   * @param triggerRect - Bounding rectangle of the trigger element\n   * @param tooltipRect - Bounding rectangle of the tooltip element\n   * @param viewportWidth - Current viewport width (typically window.innerWidth)\n   * @param viewportHeight - Current viewport height (typically window.innerHeight)\n   * @param preferredPlacement - Optional preferred placement before fallback logic\n   * @returns Position object with top, left coordinates and final placement\n   *\n   * @example\n   * ```typescript\n   * const position = tooltipService.calculatePosition(\n   *   button.getBoundingClientRect(),\n   *   tooltip.getBoundingClientRect(),\n   *   window.innerWidth,\n   *   window.innerHeight,\n   *   'top'\n   * );\n   * // position = { top: 150, left: 100, placement: 'top' }\n   * ```\n   */\n  calculatePosition(\n    triggerRect: ElementRect,\n    tooltipRect: ElementRect,\n    viewportWidth: number,\n    viewportHeight: number,\n    placement: TooltipPlacement = 'bottom'\n  ): TooltipPosition {\n    const clampVertical = (top: number): number => {\n      const maxTop = viewportHeight - tooltipRect.height - VIEWPORT_PADDING;\n      return Math.min(Math.max(VIEWPORT_PADDING, top), maxTop);\n    };\n\n    const calculatePositionFor = (placement: TooltipPlacement): TooltipPosition => {\n      let top: number;\n      let left: number;\n      const centeredTop = triggerRect.top + (triggerRect.height - tooltipRect.height) / 2;\n\n      switch (placement) {\n        case 'top':\n          top = triggerRect.top - tooltipRect.height - TOOLTIP_GAP;\n          left = triggerRect.left;\n          break;\n        case 'bottom':\n          top = triggerRect.bottom + TOOLTIP_GAP;\n          left = triggerRect.left;\n          break;\n        case 'left':\n          top = clampVertical(centeredTop);\n          left = triggerRect.left - tooltipRect.width - TOOLTIP_GAP;\n          break;\n        case 'right':\n          top = clampVertical(centeredTop);\n          left = triggerRect.right + TOOLTIP_GAP;\n          break;\n      }\n\n      if (placement === 'top' || placement === 'bottom') {\n        const wouldOverflowRight = triggerRect.left + tooltipRect.width > viewportWidth;\n        if (wouldOverflowRight) {\n          const rightAligned = triggerRect.right - tooltipRect.width;\n          left = Math.max(VIEWPORT_PADDING, rightAligned);\n        }\n      }\n\n      return { top, left, placement };\n    };\n\n    const fitsInViewport = (position: TooltipPosition): boolean => {\n      const minTop = 0;\n      const maxTop = viewportHeight - tooltipRect.height;\n\n      // If the tooltip is wider than the viewport, horizontal placements\n      // ('left' or 'right') are effectively impossible and should not be\n      // considered valid. Only vertical placements are allowed in that case.\n      if (tooltipRect.width > viewportWidth) {\n        if (position.placement !== 'top' && position.placement !== 'bottom') {\n          return false;\n        }\n        return position.top >= minTop && position.top <= maxTop;\n      }\n\n      const minLeft = VIEWPORT_PADDING;\n      const maxLeft = viewportWidth - tooltipRect.width;\n\n      return (\n        position.left >= minLeft &&\n        position.left <= maxLeft &&\n        position.top >= minTop &&\n        position.top <= maxTop\n      );\n    };\n\n    const preferredPosition = calculatePositionFor(placement);\n    if (fitsInViewport(preferredPosition)) {\n      return preferredPosition;\n    }\n\n    if (placement === 'bottom') {\n      const fallbackPosition = calculatePositionFor('top');\n      if (fitsInViewport(fallbackPosition)) {\n        return fallbackPosition;\n      }\n    }\n\n    if (placement === 'top') {\n      const fallbackPosition = calculatePositionFor('bottom');\n      if (fitsInViewport(fallbackPosition)) {\n        return fallbackPosition;\n      }\n    }\n\n    if (placement === 'left' || placement === 'right') {\n      const opposite: TooltipPlacement = placement === 'left' ? 'right' : 'left';\n      const oppositePosition = calculatePositionFor(opposite);\n      if (fitsInViewport(oppositePosition)) {\n        return oppositePosition;\n      }\n\n      const bottomPosition = calculatePositionFor('bottom');\n      if (fitsInViewport(bottomPosition)) {\n        return bottomPosition;\n      }\n\n      const topPosition = calculatePositionFor('top');\n      if (fitsInViewport(topPosition)) {\n        return topPosition;\n      }\n    }\n\n    return preferredPosition;\n  }\n\n  /**\n   * Determines whether a tooltip should be shown based on context.\n   *\n   * On mobile devices, tooltips are suppressed for interactive elements\n   * (buttons, links, selects) to avoid interfering with their primary click handlers.\n   *\n   * @param elementTag - Lowercase tag name of the trigger element\n   * @param isMobile - Whether the device is currently considered mobile\n   * @param hasContent - Whether the tooltip has content to display\n   * @returns `true` if tooltip should be shown, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * const shouldShow = tooltipService.shouldShowTooltip('button', true, true);\n   * // shouldShow = false (button on mobile)\n   *\n   * const shouldShow2 = tooltipService.shouldShowTooltip('div', true, true);\n   * // shouldShow2 = true (non-interactive on mobile)\n   *\n   * const shouldShow3 = tooltipService.shouldShowTooltip('button', false, true);\n   * // shouldShow3 = true (button on desktop)\n   * ```\n   */\n  shouldShowTooltip(elementTag: string, isMobile: boolean, hasContent: boolean): boolean {\n    // No content = no tooltip\n    if (!hasContent) {\n      return false;\n    }\n\n    // On mobile, skip interactive elements\n    if (isMobile && this.isInteractiveElement(elementTag)) {\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Checks if an element tag represents an interactive element.\n   *\n   * Interactive elements (buttons, links, form controls) typically have\n   * their own click/tap handlers, and showing tooltips on mobile can\n   * interfere with the primary interaction.\n   *\n   * @param elementTag - Lowercase tag name to check\n   * @returns `true` if the element is interactive, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * tooltipService.isInteractiveElement('button'); // true\n   * tooltipService.isInteractiveElement('ion-button'); // true\n   * tooltipService.isInteractiveElement('div'); // false\n   * tooltipService.isInteractiveElement('span'); // false\n   * ```\n   */\n  isInteractiveElement(elementTag: string): boolean {\n    return INTERACTIVE_ELEMENTS.includes(elementTag.toLowerCase());\n  }\n\n  /**\n   * Checks if a tooltip element is visible (has non-zero dimensions).\n   *\n   * This is useful for detecting if an element has been hidden or removed\n   * from the layout, which should trigger tooltip dismissal.\n   *\n   * @param rect - Bounding rectangle of the element\n   * @returns `true` if element has visible dimensions, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * const isVisible = tooltipService.isElementVisible(\n   *   element.getBoundingClientRect()\n   * );\n   * if (!isVisible) {\n   *   this.hideTooltip();\n   * }\n   * ```\n   */\n  isElementVisible(rect: ElementRect): boolean {\n    return rect.width > 0 && rect.height > 0;\n  }\n\n  /**\n   *\n   * @returns Tooltip show delay in milliseconds.\n   */\n  getShowDelayMs(): number {\n    return 250;\n  }\n\n  /**\n   * @returns Tooltip close delay in milliseconds.\n   */\n  getCloseDelayMs(): number {\n    return 200;\n  }\n\n  /**\n   * @returns Tooltip fade duration in milliseconds.\n   */\n  getFadeDurationMs(): number {\n    return 150;\n  }\n}\n","import { Injectable } from '@angular/core';\nimport { TooltipService } from './tooltip.service';\n\n/**\n * Handle interface for a single tooltip's scheduling logic.\n * Exposes event methods to be called by the tooltip directive/component.\n */\nexport interface TooltipSchedulerHandle {\n  destroy(): void;\n  onTriggerEnter(): void;\n  onTriggerLeave(): void;\n  onTooltipEnter(): void;\n  onTooltipLeave(): void;\n  onTooltipTouchStart(): void;\n  onTooltipTouchEnd(): void;\n  onClick(isMobile: boolean): void;\n}\n\n/**\n * Singleton service that centralizes tooltip scheduling (show/hide delays).\n * Purely orchestrates timers and delegates to provided callbacks; no DOM access.\n */\n@Injectable({ providedIn: 'root' })\nexport class TooltipSchedulerService {\n  constructor(private readonly tooltipService: TooltipService) {}\n\n  /**\n   * Create an isolated scheduler handle for a single tooltip instance.\n   * The handle exposes the same event methods but keeps timers/state per-instance.\n   */\n  createHandle(show: () => void, hide: () => void): TooltipSchedulerHandle {\n    let showTimeout: ReturnType<typeof setTimeout> | null = null;\n    let closeTimeout: ReturnType<typeof setTimeout> | null = null;\n\n    let isTriggerHovering = false;\n    let isTooltipHovering = false;\n    let isTouching = false;\n\n    const clearShowTimeout = (): void => {\n      if (showTimeout) {\n        clearTimeout(showTimeout);\n        showTimeout = null;\n      }\n    };\n\n    const clearCloseTimeout = (): void => {\n      if (closeTimeout) {\n        clearTimeout(closeTimeout);\n        closeTimeout = null;\n      }\n    };\n\n    const scheduleShow = (): void => {\n      clearShowTimeout();\n      const ms = this.tooltipService.getShowDelayMs();\n      showTimeout = setTimeout(() => {\n        showTimeout = null;\n        invokeShow();\n      }, ms);\n    };\n\n    const scheduleClose = (): void => {\n      clearCloseTimeout();\n      const ms = this.tooltipService.getCloseDelayMs();\n      closeTimeout = setTimeout(() => {\n        closeTimeout = null;\n        if (!isTriggerHovering && !isTooltipHovering && !isTouching) {\n          invokeHide();\n        }\n      }, ms);\n    };\n\n    const invokeShow = (): void => show();\n    const invokeHide = (): void => hide();\n\n    return {\n      destroy(): void {\n        clearShowTimeout();\n        clearCloseTimeout();\n      },\n      onTriggerEnter(): void {\n        isTriggerHovering = true;\n        clearCloseTimeout();\n        clearShowTimeout();\n        scheduleShow();\n      },\n      onTriggerLeave(): void {\n        isTriggerHovering = false;\n        clearShowTimeout();\n        scheduleClose();\n      },\n      onTooltipEnter(): void {\n        isTooltipHovering = true;\n        clearCloseTimeout();\n      },\n      onTooltipLeave(): void {\n        isTooltipHovering = false;\n        scheduleClose();\n      },\n      onTooltipTouchStart(): void {\n        isTouching = true;\n      },\n      onTooltipTouchEnd(): void {\n        isTouching = false;\n        scheduleClose();\n      },\n      onClick(isMobile: boolean): void {\n        if (isMobile) {\n          isTouching = true;\n          invokeShow();\n          return;\n        }\n\n        // Desktop toggle behavior\n        if (closeTimeout) {\n          clearCloseTimeout();\n          return;\n        }\n\n        invokeShow();\n      }\n    };\n  }\n}\n","/**\n * @file Services Barrel Export\n * @description Exports all services from the ui-core library.\n */\n\nexport { ActionButtonListService } from './action-button-list.service';\nexport { ButtonDisplayService } from './button-display.service';\nexport { ButtonHandlerService } from './button-handler.service';\nexport type { ChildLoadingCallback, LoadingCallback } from './button-handler.service';\nexport { ButtonStateService } from './button-state.service';\nexport { DeviceDetectionService } from './device-detection.service';\nexport { TooltipSchedulerService } from './tooltip-scheduler.service';\nexport type { TooltipSchedulerHandle } from './tooltip-scheduler.service';\nexport { TooltipService } from './tooltip.service';\nexport type { ElementRect, TooltipPlacement, TooltipPosition } from './tooltip.service';\n","/*\n * Public API Surface of @makigamestudio/ui-core\n *\n * This package provides UI-agnostic interfaces, services, and design tokens\n * for building action button components across different UI frameworks.\n */\n\n// ============================================================================\n// Interfaces\n// ============================================================================\n\n// Action Button Configuration (generic, UI-agnostic)\nexport type {\n  ActionButtonConfig,\n  BaseActionButtonConfig\n} from './lib/interfaces/action-button-config.interface';\n\n// Action Button Type Enum\nexport { ActionButtonType } from './lib/interfaces/action-button-type.enum';\n\n// Action Button Interface (generic, UI-agnostic)\nexport type { ActionButton } from './lib/interfaces/action-button.interface';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport {\n  ActionButtonListService,\n  ButtonDisplayService,\n  ButtonHandlerService,\n  ButtonStateService,\n  DeviceDetectionService,\n  TooltipSchedulerService,\n  TooltipService\n} from './lib/services';\n\nexport type {\n  ChildLoadingCallback,\n  ElementRect,\n  LoadingCallback,\n  TooltipPlacement,\n  TooltipPosition,\n  TooltipSchedulerHandle\n} from './lib/services';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":["i1.TooltipService"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makigamestudio/ui-core",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "UI-agnostic Angular component library core with interfaces, services, and design tokens. Provides the foundation for UI implementations like @makigamestudio/ui-ionic.",
   "keywords": [
     "angular",

package/types/makigamestudio-ui-core.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Signal } from '@angular/core';
+import { TemplateRef, Signal } from '@angular/core';
 
 /**
  * @file Action button configuration interface
@@ -290,9 +290,26 @@ interface ActionButton<T = void, Config extends ActionButtonConfig = ActionButto
      */
     readonly ariaLabel?: string;
     /**
-     * Tooltip text shown on hover.
+     * Tooltip content shown on hover (desktop) or click (mobile).
+     * Can be a simple string or a TemplateRef for rich content.
+     * Uses the makiTooltip directive for device-aware behavior.
+     *
+     * @example
+     * ```typescript
+     * // String tooltip
+     * tooltip: 'Save changes'
+     *
+     * // Template tooltip (in component)
+     * @ViewChild('customTooltip') tooltipTemplate!: TemplateRef<unknown>;
+     * button = { tooltip: this.tooltipTemplate };
+     * ```
+     */
+    readonly tooltip?: string | TemplateRef<unknown>;
+    /**
+     * Optional color for the tooltip background.
+     * The specific color values depend on the UI library implementation.
      */
-    readonly tooltip?: string;
+    readonly tooltipColor?: string;
 }
 
 /**
@@ -649,5 +666,298 @@ declare class ButtonStateService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ButtonStateService>;
 }
 
-export { ActionButtonListService, ActionButtonType, ButtonDisplayService, ButtonHandlerService, ButtonStateService };
-export type { ActionButton, ActionButtonConfig, BaseActionButtonConfig, ChildLoadingCallback, LoadingCallback };
+/**
+ * Service for detecting and tracking device type based on user-agent and viewport width.
+ *
+ * The service initializes on construction and sets up a window resize listener to
+ * track viewport changes. It uses OR logic to determine if the device is mobile:
+ * - User-agent matches mobile device patterns
+ * - OR viewport width is less than 768px
+ *
+ * The resize listener is automatically cleaned up when the service is destroyed.
+ *
+ * @usageNotes
+ *
+ * ### Basic Usage
+ * Inject the service and use the `isMobile()` signal in templates or computed signals:
+ *
+ * ```typescript
+ * export class MyComponent {
+ *   readonly deviceDetection = inject(DeviceDetectionService);
+ * }
+ * ```
+ *
+ * ### Template Usage
+ * ```typescript
+ * @if (deviceDetection.isMobile()) {
+ *   <ion-icon name="phone-portrait-outline" />
+ * } @else {
+ *   <ion-icon name="desktop-outline" />
+ * }
+ * ```
+ *
+ * ### Computed Signals
+ * ```typescript
+ * readonly layout = computed(() =>
+ *   this.deviceDetection.isMobile() ? 'mobile' : 'desktop'
+ * );
+ * ```
+ */
+declare class DeviceDetectionService {
+    private readonly destroyRef;
+    /**
+     * Regular expression pattern for detecting mobile devices via user-agent.
+     * Matches common mobile device identifiers including:
+     * - Android devices
+     * - iOS devices (iPhone, iPad, iPod)
+     * - Windows Phone (IEMobile)
+     * - BlackBerry
+     * - Opera Mini mobile browser
+     * - webOS devices
+     */
+    private readonly MOBILE_REGEX;
+    /**
+     * Breakpoint width (in pixels) below which viewport is considered mobile.
+     * @constant
+     */
+    private readonly MOBILE_BREAKPOINT;
+    /**
+     * Private writable signal tracking mobile device state.
+     */
+    private readonly _isMobile;
+    /**
+     * Public readonly signal indicating whether the device is mobile.
+     * Returns `true` if EITHER user-agent indicates mobile OR viewport width < 768px.
+     *
+     * @returns Readonly signal of mobile device state
+     *
+     * @example
+     * ```typescript
+     * const deviceDetection = inject(DeviceDetectionService);
+     * const isMobile = deviceDetection.isMobile();
+     * console.log(`Device is ${isMobile ? 'mobile' : 'desktop'}`);
+     * ```
+     */
+    readonly isMobile: i0.Signal<boolean>;
+    constructor();
+    /**
+     * Checks if the device should be considered mobile based on user-agent and viewport width.
+     *
+     * Uses OR logic: returns `true` if EITHER condition is met:
+     * - User-agent matches mobile device pattern
+     * - Viewport width is less than 768px
+     *
+     * @returns `true` if device is mobile, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const deviceDetection = inject(DeviceDetectionService);
+     * const isMobile = deviceDetection.checkDevice();
+     * // isMobile will be true if:
+     * // - User-agent contains "Android", "iPhone", etc.
+     * // - OR window.innerWidth < 768
+     * ```
+     */
+    private checkDevice;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DeviceDetectionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DeviceDetectionService>;
+}
+
+/**
+ * Position data for tooltip placement.
+ */
+interface TooltipPosition {
+    /** CSS top value in pixels */
+    readonly top: number;
+    /** CSS left value in pixels */
+    readonly left: number;
+    /** Actual placement after overflow adjustment */
+    readonly placement: TooltipPlacement;
+}
+/**
+ * Tooltip placement options.
+ */
+type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Rectangle dimensions for positioning calculations.
+ * Compatible with DOMRect from getBoundingClientRect().
+ */
+interface ElementRect {
+    readonly top: number;
+    readonly bottom: number;
+    readonly left: number;
+    readonly right: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Service providing UI-agnostic tooltip positioning and display logic.
+ *
+ * This service contains pure functions for calculating tooltip positions
+ * and determining when tooltips should be shown, without any DOM manipulation
+ * or framework-specific code.
+ *
+ * @usageNotes
+ *
+ * ### Positioning
+ * Use `calculatePosition()` to compute tooltip position based on element rectangles:
+ * ```typescript
+ * const position = tooltipService.calculatePosition(
+ *   triggerElement.getBoundingClientRect(),
+ *   tooltipElement.getBoundingClientRect(),
+ *   window.innerWidth,
+ *   window.innerHeight
+ * );
+ * tooltip.style.top = `${position.top}px`;
+ * tooltip.style.left = `${position.left}px`;
+ * ```
+ *
+ * ### Visibility Rules
+ * Use `shouldShowTooltip()` to determine if tooltip should appear:
+ * ```typescript
+ * if (tooltipService.shouldShowTooltip(element.tagName, isMobile, hasContent)) {
+ *   this.showTooltip();
+ * }
+ * ```
+ */
+declare class TooltipService {
+    /**
+     * Calculates the optimal position for a tooltip relative to its trigger element.
+     *
+     * The function attempts to position the tooltip below the trigger element by default.
+     * If the tooltip would overflow the viewport, it adjusts the position:
+     * - Positions above if it would overflow the bottom
+     * - Aligns to the right edge if it would overflow the right
+     *
+     * @param triggerRect - Bounding rectangle of the trigger element
+     * @param tooltipRect - Bounding rectangle of the tooltip element
+     * @param viewportWidth - Current viewport width (typically window.innerWidth)
+     * @param viewportHeight - Current viewport height (typically window.innerHeight)
+     * @param preferredPlacement - Optional preferred placement before fallback logic
+     * @returns Position object with top, left coordinates and final placement
+     *
+     * @example
+     * ```typescript
+     * const position = tooltipService.calculatePosition(
+     *   button.getBoundingClientRect(),
+     *   tooltip.getBoundingClientRect(),
+     *   window.innerWidth,
+     *   window.innerHeight,
+     *   'top'
+     * );
+     * // position = { top: 150, left: 100, placement: 'top' }
+     * ```
+     */
+    calculatePosition(triggerRect: ElementRect, tooltipRect: ElementRect, viewportWidth: number, viewportHeight: number, placement?: TooltipPlacement): TooltipPosition;
+    /**
+     * Determines whether a tooltip should be shown based on context.
+     *
+     * On mobile devices, tooltips are suppressed for interactive elements
+     * (buttons, links, selects) to avoid interfering with their primary click handlers.
+     *
+     * @param elementTag - Lowercase tag name of the trigger element
+     * @param isMobile - Whether the device is currently considered mobile
+     * @param hasContent - Whether the tooltip has content to display
+     * @returns `true` if tooltip should be shown, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const shouldShow = tooltipService.shouldShowTooltip('button', true, true);
+     * // shouldShow = false (button on mobile)
+     *
+     * const shouldShow2 = tooltipService.shouldShowTooltip('div', true, true);
+     * // shouldShow2 = true (non-interactive on mobile)
+     *
+     * const shouldShow3 = tooltipService.shouldShowTooltip('button', false, true);
+     * // shouldShow3 = true (button on desktop)
+     * ```
+     */
+    shouldShowTooltip(elementTag: string, isMobile: boolean, hasContent: boolean): boolean;
+    /**
+     * Checks if an element tag represents an interactive element.
+     *
+     * Interactive elements (buttons, links, form controls) typically have
+     * their own click/tap handlers, and showing tooltips on mobile can
+     * interfere with the primary interaction.
+     *
+     * @param elementTag - Lowercase tag name to check
+     * @returns `true` if the element is interactive, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * tooltipService.isInteractiveElement('button'); // true
+     * tooltipService.isInteractiveElement('ion-button'); // true
+     * tooltipService.isInteractiveElement('div'); // false
+     * tooltipService.isInteractiveElement('span'); // false
+     * ```
+     */
+    isInteractiveElement(elementTag: string): boolean;
+    /**
+     * Checks if a tooltip element is visible (has non-zero dimensions).
+     *
+     * This is useful for detecting if an element has been hidden or removed
+     * from the layout, which should trigger tooltip dismissal.
+     *
+     * @param rect - Bounding rectangle of the element
+     * @returns `true` if element has visible dimensions, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const isVisible = tooltipService.isElementVisible(
+     *   element.getBoundingClientRect()
+     * );
+     * if (!isVisible) {
+     *   this.hideTooltip();
+     * }
+     * ```
+     */
+    isElementVisible(rect: ElementRect): boolean;
+    /**
+     *
+     * @returns Tooltip show delay in milliseconds.
+     */
+    getShowDelayMs(): number;
+    /**
+     * @returns Tooltip close delay in milliseconds.
+     */
+    getCloseDelayMs(): number;
+    /**
+     * @returns Tooltip fade duration in milliseconds.
+     */
+    getFadeDurationMs(): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TooltipService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TooltipService>;
+}
+
+/**
+ * Handle interface for a single tooltip's scheduling logic.
+ * Exposes event methods to be called by the tooltip directive/component.
+ */
+interface TooltipSchedulerHandle {
+    destroy(): void;
+    onTriggerEnter(): void;
+    onTriggerLeave(): void;
+    onTooltipEnter(): void;
+    onTooltipLeave(): void;
+    onTooltipTouchStart(): void;
+    onTooltipTouchEnd(): void;
+    onClick(isMobile: boolean): void;
+}
+/**
+ * Singleton service that centralizes tooltip scheduling (show/hide delays).
+ * Purely orchestrates timers and delegates to provided callbacks; no DOM access.
+ */
+declare class TooltipSchedulerService {
+    private readonly tooltipService;
+    constructor(tooltipService: TooltipService);
+    /**
+     * Create an isolated scheduler handle for a single tooltip instance.
+     * The handle exposes the same event methods but keeps timers/state per-instance.
+     */
+    createHandle(show: () => void, hide: () => void): TooltipSchedulerHandle;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TooltipSchedulerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TooltipSchedulerService>;
+}
+
+export { ActionButtonListService, ActionButtonType, ButtonDisplayService, ButtonHandlerService, ButtonStateService, DeviceDetectionService, TooltipSchedulerService, TooltipService };
+export type { ActionButton, ActionButtonConfig, BaseActionButtonConfig, ChildLoadingCallback, ElementRect, LoadingCallback, TooltipPlacement, TooltipPosition, TooltipSchedulerHandle };