@pecb-ui/components 1.1.2 → 2.0.0

package/lib/services/notification.service.d.ts

@@ -1,136 +0,0 @@
-import { Observable } from 'rxjs';
-import * as i0 from "@angular/core";
-/**
- * Notification types supported by the service
- */
-export type NotificationType = 'success' | 'error' | 'warning' | 'info';
-/**
- * Notification position on screen
- */
-export type NotificationPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'top-center' | 'bottom-center';
-/**
- * Notification configuration options
- */
-export interface NotificationConfig {
-    /** Notification message */
-    message: string;
-    /** Notification title (optional) */
-    title?: string;
-    /** Type of notification */
-    type: NotificationType;
-    /** Duration in milliseconds (0 for persistent) */
-    duration?: number;
-    /** Whether the notification can be dismissed */
-    dismissible?: boolean;
-    /** Position on screen */
-    position?: NotificationPosition;
-    /** Custom CSS class */
-    customClass?: string;
-    /** Unique identifier */
-    id?: string;
-}
-/**
- * Notification object with all properties
- */
-export interface Notification extends Required<Omit<NotificationConfig, 'title' | 'customClass'>> {
-    title?: string;
-    customClass?: string;
-    timestamp: Date;
-}
-/**
- * A stateless, injectable notification service for displaying toast notifications.
- *
- * This service provides a reactive way to manage notifications across the application.
- * It uses RxJS Subjects to emit notification events that can be consumed by notification
- * display components.
- *
- * @example
- * ```typescript
- * import { NotificationService } from '@pecb-ui/components';
- *
- * @Component({...})
- * export class MyComponent {
- *   constructor(private notificationService: NotificationService) {}
- *
- *   showSuccess(): void {
- *     this.notificationService.success('Operation completed successfully!');
- *   }
- *
- *   showError(): void {
- *     this.notificationService.error('An error occurred', 'Error Title');
- *   }
- * }
- * ```
- *
- * @publicApi
- */
-export declare class NotificationService {
-    private readonly notificationSubject;
-    private readonly dismissSubject;
-    private readonly clearSubject;
-    /** Default duration for notifications in milliseconds */
-    private readonly defaultDuration;
-    /** Default position for notifications */
-    private readonly defaultPosition;
-    /**
-     * Observable stream of notifications
-     */
-    get notifications$(): Observable<Notification>;
-    /**
-     * Observable stream of dismissed notification IDs
-     */
-    get dismiss$(): Observable<string>;
-    /**
-     * Observable stream for clear all events
-     */
-    get clear$(): Observable<void>;
-    /**
-     * Show a success notification
-     * @param message - The notification message
-     * @param title - Optional title
-     * @param config - Optional additional configuration
-     */
-    success(message: string, title?: string, config?: Partial<NotificationConfig>): string;
-    /**
-     * Show an error notification
-     * @param message - The notification message
-     * @param title - Optional title
-     * @param config - Optional additional configuration
-     */
-    error(message: string, title?: string, config?: Partial<NotificationConfig>): string;
-    /**
-     * Show a warning notification
-     * @param message - The notification message
-     * @param title - Optional title
-     * @param config - Optional additional configuration
-     */
-    warning(message: string, title?: string, config?: Partial<NotificationConfig>): string;
-    /**
-     * Show an info notification
-     * @param message - The notification message
-     * @param title - Optional title
-     * @param config - Optional additional configuration
-     */
-    info(message: string, title?: string, config?: Partial<NotificationConfig>): string;
-    /**
-     * Show a notification with custom configuration
-     * @param config - Full notification configuration
-     * @returns The notification ID
-     */
-    show(config: NotificationConfig): string;
-    /**
-     * Dismiss a specific notification by ID
-     * @param id - The notification ID to dismiss
-     */
-    dismiss(id: string): void;
-    /**
-     * Clear all notifications
-     */
-    clearAll(): void;
-    /**
-     * Generate a unique notification ID
-     */
-    private generateId;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NotificationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<NotificationService>;
-}

package/lib/services/theme.service.d.ts

@@ -1,142 +0,0 @@
-import { Observable } from 'rxjs';
-import * as i0 from "@angular/core";
-/**
- * Available theme modes
- */
-export type ThemeMode = 'light' | 'dark' | 'system';
-/**
- * Theme configuration interface
- */
-export interface ThemeConfig {
-    /** Current theme mode */
-    mode: ThemeMode;
-    /** Resolved theme (light or dark, never system) */
-    resolvedTheme: 'light' | 'dark';
-    /** CSS class to apply to the document */
-    cssClass: string;
-}
-/**
- * Custom theme variables that can be overridden
- */
-export interface ThemeVariables {
-    /** Primary color */
-    primaryColor?: string;
-    /** Secondary color */
-    secondaryColor?: string;
-    /** Background color */
-    backgroundColor?: string;
-    /** Text color */
-    textColor?: string;
-    /** Border radius */
-    borderRadius?: string;
-    /** Font family */
-    fontFamily?: string;
-    /** Custom CSS variables */
-    [key: string]: string | undefined;
-}
-/**
- * A stateless, injectable theme service for managing application themes.
- *
- * This service provides reactive theme management with support for light/dark modes,
- * system preference detection, and custom CSS variable overrides.
- *
- * @example
- * ```typescript
- * import { ThemeService } from '@pecb-ui/components';
- *
- * @Component({...})
- * export class MyComponent {
- *   constructor(private themeService: ThemeService) {}
- *
- *   toggleTheme(): void {
- *     this.themeService.toggleTheme();
- *   }
- *
- *   setDarkMode(): void {
- *     this.themeService.setTheme('dark');
- *   }
- * }
- * ```
- *
- * @publicApi
- */
-export declare class ThemeService {
-    private readonly themeSubject;
-    private readonly isBrowser;
-    private mediaQuery;
-    constructor(platformId: object);
-    /**
-     * Observable stream of theme configuration changes
-     */
-    get theme$(): Observable<ThemeConfig>;
-    /**
-     * Get the current theme configuration
-     */
-    get currentTheme(): ThemeConfig;
-    /**
-     * Get the current theme mode
-     */
-    get currentMode(): ThemeMode;
-    /**
-     * Check if the current resolved theme is dark
-     */
-    get isDarkMode(): boolean;
-    /**
-     * Set the theme mode
-     * @param mode - The theme mode to set (light, dark, or system)
-     */
-    setTheme(mode: ThemeMode): void;
-    /**
-     * Toggle between light and dark themes
-     * If currently using system preference, switches to the opposite of the resolved theme
-     */
-    toggleTheme(): void;
-    /**
-     * Reset to system preference
-     */
-    useSystemTheme(): void;
-    /**
-     * Apply custom CSS variables to the document
-     * @param variables - Object containing CSS variable overrides
-     */
-    setCustomVariables(variables: ThemeVariables): void;
-    /**
-     * Remove custom CSS variables from the document
-     * @param variableNames - Array of variable names to remove
-     */
-    removeCustomVariables(variableNames: string[]): void;
-    /**
-     * Get the initial theme from storage or system preference
-     */
-    private getInitialTheme;
-    /**
-     * Create a theme configuration object
-     */
-    private createThemeConfig;
-    /**
-     * Resolve the actual theme from mode (handles 'system' mode)
-     */
-    private resolveTheme;
-    /**
-     * Get the system color scheme preference
-     */
-    private getSystemPreference;
-    /**
-     * Setup listener for system theme changes
-     */
-    private setupSystemThemeListener;
-    /**
-     * Apply the theme to the document
-     */
-    private applyTheme;
-    /**
-     * Persist theme preference to storage
-     */
-    private persistTheme;
-    /**
-     * Convert camelCase property name to CSS variable name
-     */
-    private toCssVariableName;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ThemeService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ThemeService>;
-}

package/lib/shared/interfaces/component.interfaces.d.ts

@@ -1,283 +0,0 @@
-import { TemplateRef } from '@angular/core';
-import { ColorVariant, ComponentSize, ValidationState } from '../types/common.types';
-/**
- * Common interface for components that can be disabled
- */
-export interface Disableable {
-    /** Whether the component is disabled */
-    disabled: boolean;
-}
-/**
- * Common interface for components with loading state
- */
-export interface Loadable {
-    /** Whether the component is in a loading state */
-    loading: boolean;
-}
-/**
- * Common interface for components with size variants
- */
-export interface Sizeable {
-    /** The size of the component */
-    size: ComponentSize;
-}
-/**
- * Common interface for components with color variants
- */
-export interface Colorable {
-    /** The color variant of the component */
-    variant: ColorVariant;
-}
-/**
- * Common interface for focusable components
- */
-export interface Focusable {
-    /** Focus the component programmatically */
-    focus(): void;
-    /** Blur the component programmatically */
-    blur(): void;
-}
-/**
- * Base interface for form control components
- */
-export interface FormControlBase extends Disableable {
-    /** Unique identifier for the control */
-    id: string;
-    /** Name attribute for form submission */
-    name: string;
-    /** Whether the field is required */
-    required: boolean;
-    /** Whether the field is readonly */
-    readonly: boolean;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Accessible label */
-    ariaLabel?: string;
-    /** ID of element that labels this control */
-    ariaLabelledBy?: string;
-    /** ID of element that describes this control */
-    ariaDescribedBy?: string;
-}
-/**
- * Interface for components with validation
- */
-export interface Validatable {
-    /** Current validation state */
-    validationState: ValidationState;
-    /** Error message to display */
-    errorMessage?: string;
-    /** Success message to display */
-    successMessage?: string;
-    /** Helper text to display */
-    helperText?: string;
-}
-/**
- * Interface for selectable items (dropdown, list, etc.)
- */
-export interface SelectableItem<T = unknown> {
-    /** Unique value for the item */
-    value: T;
-    /** Display label */
-    label: string;
-    /** Whether the item is disabled */
-    disabled?: boolean;
-    /** Optional icon name */
-    icon?: string;
-    /** Optional description */
-    description?: string;
-    /** Optional group name for categorization */
-    group?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Interface for components that support custom templates
- */
-export interface Templatable {
-    /** Custom template for rendering */
-    template?: TemplateRef<unknown>;
-}
-/**
- * Interface for overlay components (modal, popover, tooltip)
- */
-export interface OverlayComponent {
-    /** Whether the overlay is currently visible */
-    isOpen: boolean;
-    /** Open the overlay */
-    open(): void;
-    /** Close the overlay */
-    close(): void;
-    /** Toggle the overlay state */
-    toggle(): void;
-}
-/**
- * Interface for components with before/after close hooks
- */
-export interface ClosableWithHooks {
-    /** Called before the component closes. Return false to prevent closing */
-    beforeClose?: () => boolean | Promise<boolean>;
-    /** Called after the component closes */
-    afterClose?: () => void;
-}
-/**
- * Interface for table column definition
- */
-export interface TableColumn<T = unknown> {
-    /** Unique column key */
-    key: string;
-    /** Column header label */
-    label: string;
-    /** Property path to access data (supports dot notation) */
-    field?: keyof T | string;
-    /** Whether the column is sortable */
-    sortable?: boolean;
-    /** Whether the column is filterable */
-    filterable?: boolean;
-    /** Column width (CSS value) */
-    width?: string;
-    /** Minimum column width */
-    minWidth?: string;
-    /** Maximum column width */
-    maxWidth?: string;
-    /** Text alignment */
-    align?: 'left' | 'center' | 'right';
-    /** Whether the column is visible */
-    visible?: boolean;
-    /** Whether the column is sticky */
-    sticky?: 'start' | 'end';
-    /** Custom cell template */
-    cellTemplate?: TemplateRef<unknown>;
-    /** Custom header template */
-    headerTemplate?: TemplateRef<unknown>;
-    /** Value formatter function */
-    formatter?: (value: unknown, row: T) => string;
-}
-/**
- * Interface for pagination state
- */
-export interface PaginationState {
-    /** Current page (1-indexed) */
-    currentPage: number;
-    /** Number of items per page */
-    pageSize: number;
-    /** Total number of items */
-    totalItems: number;
-    /** Total number of pages (calculated) */
-    totalPages: number;
-}
-/**
- * Interface for sort state
- */
-export interface SortState {
-    /** Column key to sort by */
-    column: string;
-    /** Sort direction */
-    direction: 'asc' | 'desc' | null;
-}
-/**
- * Interface for filter state
- */
-export interface FilterState {
-    /** Column key to filter */
-    column: string;
-    /** Filter operator */
-    operator: 'equals' | 'contains' | 'startsWith' | 'endsWith' | 'gt' | 'lt' | 'gte' | 'lte' | 'between' | 'in';
-    /** Filter value(s) */
-    value: unknown;
-}
-/**
- * Interface for tree node structure
- */
-export interface TreeNode<T = unknown> {
-    /** Unique node identifier */
-    id: string | number;
-    /** Node data */
-    data: T;
-    /** Child nodes */
-    children?: TreeNode<T>[];
-    /** Whether the node is expanded */
-    expanded?: boolean;
-    /** Whether the node is selected */
-    selected?: boolean;
-    /** Whether the node is disabled */
-    disabled?: boolean;
-    /** Whether the node is a leaf (no children) */
-    leaf?: boolean;
-    /** Parent node ID */
-    parentId?: string | number;
-    /** Node level in the tree (0-indexed) */
-    level?: number;
-}
-/**
- * Interface for breadcrumb item
- */
-export interface BreadcrumbItem {
-    /** Display label */
-    label: string;
-    /** Navigation URL or route */
-    url?: string;
-    /** Route path array for routerLink */
-    routerLink?: string | string[];
-    /** Query parameters */
-    queryParams?: Record<string, string>;
-    /** Icon name */
-    icon?: string;
-    /** Whether this is the active/current item */
-    active?: boolean;
-    /** Whether the item is disabled */
-    disabled?: boolean;
-}
-/**
- * Interface for tab item
- */
-export interface TabItem {
-    /** Unique tab identifier */
-    id: string;
-    /** Tab label */
-    label: string;
-    /** Tab icon */
-    icon?: string;
-    /** Whether the tab is disabled */
-    disabled?: boolean;
-    /** Whether the tab is closable */
-    closable?: boolean;
-    /** Badge content */
-    badge?: string | number;
-    /** Content template */
-    content?: TemplateRef<unknown>;
-}
-/**
- * Interface for menu item
- */
-export interface MenuItem {
-    /** Unique item identifier */
-    id?: string;
-    /** Display label */
-    label: string;
-    /** Icon name */
-    icon?: string;
-    /** Command to execute on click */
-    command?: () => void;
-    /** URL for navigation */
-    url?: string;
-    /** Router link */
-    routerLink?: string | string[];
-    /** Query parameters */
-    queryParams?: Record<string, string>;
-    /** Whether the item is disabled */
-    disabled?: boolean;
-    /** Whether the item is visible */
-    visible?: boolean;
-    /** Child items for submenu */
-    items?: MenuItem[];
-    /** Whether this is a separator */
-    separator?: boolean;
-    /** Additional CSS class */
-    styleClass?: string;
-    /** Tooltip text */
-    tooltip?: string;
-    /** Badge content */
-    badge?: string | number;
-    /** Badge color variant */
-    badgeVariant?: ColorVariant;
-}

package/lib/shared/types/common.types.d.ts

@@ -1,86 +0,0 @@
-/**
- * Common type definitions for PECB UI Components
- * @module types
- */
-/**
- * Standard size variants used across components
- */
-export type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-/**
- * Standard component size mapping
- */
-export type ComponentSize = 'small' | 'medium' | 'large';
-/**
- * Semantic color variants
- */
-export type ColorVariant = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
-/**
- * Extended color variants including neutral options
- */
-export type ExtendedColorVariant = ColorVariant | 'neutral' | 'muted';
-/**
- * Component state variants
- */
-export type StateVariant = 'default' | 'hover' | 'active' | 'focus' | 'disabled';
-/**
- * Position options for overlays and popups
- */
-export type Position = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
-/**
- * Alignment options
- */
-export type Alignment = 'start' | 'center' | 'end' | 'stretch';
-/**
- * Direction options for layouts
- */
-export type Direction = 'horizontal' | 'vertical';
-/**
- * Orientation alias for direction
- */
-export type Orientation = 'horizontal' | 'vertical';
-/**
- * Spacing scale values
- */
-export type SpacingScale = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
-/**
- * Border radius scale values
- */
-export type RadiusScale = 'none' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
-/**
- * Shadow elevation levels
- */
-export type ElevationLevel = 'none' | 'sm' | 'md' | 'lg' | 'xl';
-/**
- * Animation timing presets
- */
-export type AnimationTiming = 'instant' | 'fast' | 'normal' | 'slow';
-/**
- * Breakpoint names
- */
-export type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
-/**
- * Form validation state
- */
-export type ValidationState = 'valid' | 'invalid' | 'pending' | 'pristine';
-/**
- * Generic callback function type
- */
-export type Callback<T = void> = () => T;
-/**
- * Generic event handler type
- */
-export type EventHandler<T = Event> = (event: T) => void;
-/**
- * Make specific properties required
- */
-export type RequireProps<T, K extends keyof T> = T & Required<Pick<T, K>>;
-/**
- * Make specific properties optional
- */
-export type OptionalProps<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-/**
- * Extract non-nullable type
- */
-export type NonNullableProps<T> = {
-    [K in keyof T]: NonNullable<T[K]>;
-};