@raintonic/formaui 0.2.0

package/types/raintonic-formaui-services-notification.d.ts

@@ -0,0 +1,221 @@
+import { FuiNotificationConfig, FuiNotificationPosition } from '@raintonic/formaui/components/alert';
+import { Observable } from 'rxjs';
+import * as i0 from '@angular/core';
+
+/**
+ * Reference to a notification instance.
+ * Provides control over the notification and observables for lifecycle events.
+ */
+declare class FuiNotificationRef {
+    readonly id: string;
+    readonly config: FuiNotificationConfig;
+    private readonly _afterClosed;
+    private readonly _afterDismissed;
+    /**
+     * Observable that emits when the notification is closed
+     */
+    readonly afterClosed: Observable<void>;
+    /**
+     * Observable that emits when the notification is dismissed (after animation)
+     */
+    readonly afterDismissed: Observable<void>;
+    constructor(id: string, config: FuiNotificationConfig);
+    /**
+     * Close the notification
+     */
+    close(): void;
+    /**
+     * Called internally when the notification is fully dismissed
+     * @internal
+     */
+    _dismiss(): void;
+}
+
+/**
+ * # FuiNotificationService
+ *
+ * Service for displaying toast-style notifications using overlays.
+ * Notifications can be displayed at various positions on the screen and will
+ * auto-dismiss after a configurable duration with a visual countdown.
+ *
+ * ## Features
+ * - Multiple notification variants (success, info, warning, error, primary, generic)
+ * - Configurable positioning (top-left, top-center, top-right, bottom-left, bottom-center, bottom-right)
+ * - Auto-dismiss with progress bar countdown
+ * - Manual dismiss via close button
+ * - Stack multiple notifications
+ * - Convenient shorthand methods for common variants
+ *
+ * ## Usage
+ *
+ * ### Success Notification
+ * ```typescript
+ * this.notificationService.success('Changes saved successfully!');
+ * ```
+ *
+ * ### Error Notification with Description
+ * ```typescript
+ * this.notificationService.error('Failed to save', {
+ *   description: 'Please check your connection and try again.'
+ * });
+ * ```
+ *
+ * ### Custom Duration and Position
+ * ```typescript
+ * this.notificationService.info('New message received', {
+ *   description: 'Click to view',
+ *   duration: 10000,
+ *   position: 'bottom-right'
+ * });
+ * ```
+ *
+ * ### No Auto-Dismiss
+ * ```typescript
+ * this.notificationService.warning('Important notice', {
+ *   duration: 0, // Won't auto-dismiss
+ *   closeable: true
+ * });
+ * ```
+ *
+ * ### Full Configuration
+ * ```typescript
+ * const ref = this.notificationService.show({
+ *   variant: 'success',
+ *   title: 'Success!',
+ *   description: 'Your operation completed successfully.',
+ *   duration: 5000,
+ *   closeable: true,
+ *   icon: 'custom-icon',
+ *   position: 'top-center'
+ * });
+ *
+ * // Programmatically close
+ * ref.close();
+ * ```
+ */
+declare class FuiNotificationService {
+    private readonly _document;
+    private readonly _rendererFactory;
+    private readonly _environmentInjector;
+    private readonly _applicationRef;
+    private readonly _renderer;
+    /**
+     * Map of container components by position
+     */
+    private readonly _containers;
+    /**
+     * Default position for notifications
+     */
+    private _defaultPosition;
+    /**
+     * Next unique notification ID
+     */
+    private _nextId;
+    constructor();
+    /**
+     * Set the default position for notifications
+     */
+    setDefaultPosition(position: FuiNotificationPosition): void;
+    /**
+     * Show a success notification
+     */
+    success(title: string, options?: Partial<Omit<FuiNotificationConfig, 'variant' | 'title'>> & {
+        position?: FuiNotificationPosition;
+    }): FuiNotificationRef;
+    /**
+     * Show an info notification
+     */
+    info(title: string, options?: Partial<Omit<FuiNotificationConfig, 'variant' | 'title'>> & {
+        position?: FuiNotificationPosition;
+    }): FuiNotificationRef;
+    /**
+     * Show a warning notification
+     */
+    warning(title: string, options?: Partial<Omit<FuiNotificationConfig, 'variant' | 'title'>> & {
+        position?: FuiNotificationPosition;
+    }): FuiNotificationRef;
+    /**
+     * Show an error notification
+     */
+    error(title: string, options?: Partial<Omit<FuiNotificationConfig, 'variant' | 'title'>> & {
+        position?: FuiNotificationPosition;
+    }): FuiNotificationRef;
+    /**
+     * Show a primary notification
+     */
+    primary(title: string, options?: Partial<Omit<FuiNotificationConfig, 'variant' | 'title'>> & {
+        position?: FuiNotificationPosition;
+    }): FuiNotificationRef;
+    /**
+     * Show a generic notification
+     */
+    generic(title: string, options?: Partial<Omit<FuiNotificationConfig, 'variant' | 'title'>> & {
+        position?: FuiNotificationPosition;
+    }): FuiNotificationRef;
+    /**
+     * Show a notification with full configuration
+     */
+    show(config: FuiNotificationConfig & {
+        position?: FuiNotificationPosition;
+    }): FuiNotificationRef;
+    /**
+     * Clear all notifications at a specific position
+     */
+    clearPosition(position: FuiNotificationPosition): void;
+    /**
+     * Clear all notifications
+     */
+    clearAll(): void;
+    private _getOrCreateContainer;
+    private _createContainer;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FuiNotificationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FuiNotificationService>;
+}
+
+/**
+ * Container component for displaying stacked notifications.
+ * This component is created by the notification service and managed internally.
+ * @internal
+ */
+declare class FuiNotificationContainerComponent {
+    /**
+     * List of active notifications
+     */
+    readonly notifications: i0.WritableSignal<FuiNotificationRef[]>;
+    /**
+     * Progress values for each notification (0-100)
+     */
+    readonly progressValues: i0.WritableSignal<Map<any, any>>;
+    /**
+     * Timers for auto-dismiss
+     */
+    private readonly timers;
+    constructor();
+    /**
+     * Add a notification to the container
+     */
+    addNotification(notification: FuiNotificationRef): void;
+    /**
+     * Remove a notification from the container
+     */
+    removeNotification(notificationId: string): void;
+    /**
+     * Handle notification close button click
+     */
+    onNotificationClose(notification: FuiNotificationRef): void;
+    /**
+     * Get the progress value for a notification
+     */
+    getProgress(notificationId: string): number;
+    /**
+     * Check if notification should show progress bar
+     */
+    shouldShowProgress(notification: FuiNotificationRef): boolean;
+    private _setupAutoDismiss;
+    private _removeNotification;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FuiNotificationContainerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FuiNotificationContainerComponent, "fui-notification-container", never, {}, {}, never, never, true, never>;
+}
+
+export { FuiNotificationContainerComponent, FuiNotificationRef, FuiNotificationService };
+//# sourceMappingURL=raintonic-formaui-services-notification.d.ts.map

package/types/raintonic-formaui-services-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raintonic-formaui-services-notification.d.ts","sources":["../../../lib/services/notification/notification-ref.ts","../../../lib/services/notification/notification.service.ts","../../../lib/services/notification/notification-container.component.ts"],"mappings":";;;;AAGA;;;AAGG;AACH,cAAa,kBAAkB;AAeX;AACA,qBAAQ,qBAAqB;AAf/C;AACA;AAEA;;AAEG;AACH,0BAAsB,UAAU;AAEhC;;AAEG;AACH,6BAAyB,UAAU;AAGjB,oCACQ,qBAAqB;AAG/C;;AAEG;AACH;AAKA;;;AAGG;AACH;AAID;;AC3BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DG;AACH,cAGa,sBAAsB;AACjC;AACA;AACA;AACA;AACA;AAEA;;AAEG;AACH;AAEA;;AAEG;;AAGH;;AAEG;;;AAOH;;AAEG;AACH,iCAA6B,uBAAuB;AAIpD;;AAEG;AACH,qCAEY,OAAO,CAAC,IAAI,CAAC,qBAAqB;mBAC/B,uBAAuB;AACnC,QACA,kBAAkB;AAQrB;;AAEG;AACH,kCAEY,OAAO,CAAC,IAAI,CAAC,qBAAqB;mBAC/B,uBAAuB;AACnC,QACA,kBAAkB;AAQrB;;AAEG;AACH,qCAEY,OAAO,CAAC,IAAI,CAAC,qBAAqB;mBAC/B,uBAAuB;AACnC,QACA,kBAAkB;AAQrB;;AAEG;AACH,mCAEY,OAAO,CAAC,IAAI,CAAC,qBAAqB;mBAC/B,uBAAuB;AACnC,QACA,kBAAkB;AAQrB;;AAEG;AACH,qCAEY,OAAO,CAAC,IAAI,CAAC,qBAAqB;mBAC/B,uBAAuB;AACnC,QACA,kBAAkB;AAQrB;;AAEG;AACH,qCAEY,OAAO,CAAC,IAAI,CAAC,qBAAqB;mBAC/B,uBAAuB;AACnC,QACA,kBAAkB;AAQrB;;AAEG;AACH,iBAAa,qBAAqB;mBAAgB,uBAAuB;AAAE,QAAG,kBAAkB;AAchG;;AAEG;AACH,4BAAwB,uBAAuB;AAW/C;;AAEG;AACH;AASA;AAWA;yCAvLW,sBAAsB;6CAAtB,sBAAsB;AA0MlC;;ACtRD;;;;AAIG;AACH,cAea,iCAAiC;AAC5C;;AAEG;4BACmBA,EAAA,CAAA,cAAA,CAAA,kBAAA;AAEtB;;AAEG;6BACoBA,EAAA,CAAA,cAAA,CAAA,GAAA;AAEvB;;AAEG;AACH;;AAaA;;AAEG;AACH,kCAA8B,kBAAkB;AAehD;;AAEG;AACH;AAOA;;AAEG;AACH,sCAAkC,kBAAkB;AAIpD;;AAEG;AACH;AAIA;;AAEG;AACH,qCAAiC,kBAAkB;AAKnD;AA4BA;yCAzGW,iCAAiC;2CAAjC,iCAAiC;AA+H7C;;;;","names":["_angular_core"]}

package/types/raintonic-formaui-services-theme.d.ts

@@ -0,0 +1,126 @@
+import * as i0 from '@angular/core';
+import { Signal } from '@angular/core';
+
+/**
+ * Configuration interface for theme customization
+ */
+interface FuiThemeConfig {
+    /** Primary color for the theme (hex, rgb, hsl) */
+    primary?: string;
+    /** Secondary color for the theme (hex, rgb, hsl) */
+    secondary?: string;
+    /** Tertiary color for the theme (hex, rgb, hsl) */
+    tertiary?: string;
+}
+/**
+ * Available theme modes
+ */
+type FuiThemeMode = 'light' | 'dark' | 'auto';
+/**
+ * # FuiTheme Service
+ *
+ * Central service for managing theme configuration and mode switching.
+ * Provides runtime theme customization with CSS variables and automatic palette generation.
+ *
+ * ## Features
+ * - Runtime theme customization
+ * - Light/dark/auto mode switching
+ * - Automatic color palette generation
+ * - CSS variables-based theming
+ * - Persistent theme preferences
+ * - System theme detection
+ *
+ * ## Usage
+ *
+ * ### Basic Theme Setup
+ * ```typescript
+ * import { FuiThemeService } from '@raintonic/formaui/services/theme';
+ *
+ * constructor(private themeService: FuiThemeService) {
+ *   // Set custom theme colors
+ *   this.themeService.setTheme({
+ *     primary: '#007bff',
+ *     secondary: '#6c757d',
+ *     tertiary: '#28a745'
+ *   });
+ * }
+ * ```
+ *
+ * ### Theme Mode Switching
+ * ```typescript
+ * // Switch to dark mode
+ * this.themeService.setMode('dark');
+ *
+ * // Switch to auto (follows system preference)
+ * this.themeService.setMode('auto');
+ *
+ * // Get current mode
+ * const currentMode = this.themeService.currentMode();
+ * const isDark = this.themeService.isDark();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { Component, effect } from '@angular/core';
+ * import { FuiThemeService } from '@raintonic/formaui/services/theme';
+ *
+ * @Component({
+ *   template: `
+ *     <div class="theme-controls">
+ *       <button rtButton (click)="setLightMode()">Light</button>
+ *       <button rtButton (click)="setDarkMode()">Dark</button>
+ *       <button rtButton (click)="setAutoMode()">Auto</button>
+ *     </div>
+ *   `
+ * })
+ * export class ThemeControlsComponent {
+ *   constructor(public themeService: FuiThemeService) {}
+ *
+ *   setLightMode() { this.themeService.setMode('light'); }
+ *   setDarkMode() { this.themeService.setMode('dark'); }
+ *   setAutoMode() { this.themeService.setMode('auto'); }
+ * }
+ * ```
+ */
+declare class FuiThemeService {
+    private readonly _destroyRef;
+    private readonly _document;
+    private readonly _platformId;
+    private readonly _currentMode;
+    private readonly _isDark;
+    readonly currentMode: Signal<FuiThemeMode>;
+    readonly isDark: Signal<boolean>;
+    constructor();
+    /**
+     * Initialize theme with custom colors
+     */
+    initTheme(config?: FuiThemeConfig): void;
+    /**
+     * Set theme colors dynamically
+     */
+    setTheme(config?: FuiThemeConfig): void;
+    /**
+     * Set theme mode
+     */
+    setThemeMode(mode: FuiThemeMode): void;
+    /**
+     * Set theme mode (preferred method)
+     */
+    setMode(mode: FuiThemeMode): void;
+    /**
+     * Toggle between light and dark themes
+     */
+    toggleTheme(): void;
+    private _initializeTheme;
+    private _setupMediaQueryListener;
+    private _applyThemeMode;
+    private _updateDarkMode;
+    private _setColorPalette;
+    private _generateColorPalette;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FuiThemeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FuiThemeService>;
+}
+
+export { FuiThemeService };
+export type { FuiThemeConfig, FuiThemeMode };
+//# sourceMappingURL=raintonic-formaui-services-theme.d.ts.map

package/types/raintonic-formaui-services-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raintonic-formaui-services-theme.d.ts","sources":["../../../lib/services/theme/theme.service.ts"],"mappings":";;;AAGA;;AAEG;UACc,cAAc;;;;;;;AAO9B;AAED;;AAEG;AACG,KAAM,YAAY;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEG;AACH,cAGa,eAAe;AAC1B;AACA;AACA;AACA;AACA;AAEA,0BAAsB,MAAM,CAAC,YAAY;AACzC,qBAAiB,MAAM;;AAOvB;;AAEG;AACH,uBAAkB,cAAmB;AAIrC;;AAEG;AACH,sBAAiB,cAAmB;AAgBpC;;AAEG;AACH,uBAAmB,YAAY;AAI/B;;AAEG;AACH,kBAAc,YAAY;AAK1B;;AAEG;AACH;AAKA;AAoBA;AA+BA;AA+BA;AAKA;AAWA;yCAlKW,eAAe;6CAAf,eAAe;AAkM3B;;;;","names":[]}

package/types/raintonic-formaui-test-utils.d.ts

@@ -0,0 +1,24 @@
+import axe from 'axe-core';
+
+/**
+ * Runs axe-core accessibility audit on the given element.
+ * Returns violations array. Empty array means no violations.
+ */
+declare function runA11yAudit(element: HTMLElement): Promise<axe.Result[]>;
+
+declare function pressKey(element: HTMLElement, key: string, modifiers?: {
+    shift?: boolean;
+    ctrl?: boolean;
+    alt?: boolean;
+}): void;
+declare function pressTab(element: HTMLElement, shift?: boolean): void;
+declare function pressArrowDown(element: HTMLElement): void;
+declare function pressArrowUp(element: HTMLElement): void;
+declare function pressEnter(element: HTMLElement): void;
+declare function pressSpace(element: HTMLElement): void;
+declare function pressEscape(element: HTMLElement): void;
+declare function pressHome(element: HTMLElement): void;
+declare function pressEnd(element: HTMLElement): void;
+
+export { pressArrowDown, pressArrowUp, pressEnd, pressEnter, pressEscape, pressHome, pressKey, pressSpace, pressTab, runA11yAudit };
+//# sourceMappingURL=raintonic-formaui-test-utils.d.ts.map

package/types/raintonic-formaui-test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raintonic-formaui-test-utils.d.ts","sources":["../../../lib/test-utils/a11y-test.util.ts","../../../lib/test-utils/keyboard-test.util.ts"],"mappings":";;AAEA;;;AAGG;AACH,iBAAsB,YAAY,UAAU,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM;;ACN5E,iBAAgB,QAAQ,UACb,WAAW;;;;AAE0C;AAahE,iBAAgB,QAAQ,UAAU,WAAW;AAI7C,iBAAgB,cAAc,UAAU,WAAW;AAInD,iBAAgB,YAAY,UAAU,WAAW;AAIjD,iBAAgB,UAAU,UAAU,WAAW;AAI/C,iBAAgB,UAAU,UAAU,WAAW;AAI/C,iBAAgB,WAAW,UAAU,WAAW;AAIhD,iBAAgB,SAAS,UAAU,WAAW;AAI9C,iBAAgB,QAAQ,UAAU,WAAW;;;;","names":[]}

package/types/raintonic-formaui.d.ts

@@ -0,0 +1,4 @@
+declare const FORMAUI_VERSION = "0.1.0";
+
+export { FORMAUI_VERSION };
+//# sourceMappingURL=raintonic-formaui.d.ts.map

package/types/raintonic-formaui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raintonic-formaui.d.ts","sources":["../../../lib/src/public-api.ts"],"mappings":"AAAA,cAAa,eAAe;;;;","names":[]}