@pecb-ui/components 1.1.2 → 1.2.0

package/lib/shared/utils/accessibility.utils.d.ts

@@ -1,167 +0,0 @@
-/**
- * Accessibility utility functions for PECB UI Components
- * Helps ensure WCAG 2.1 compliance
- * @module utils/accessibility
- */
-/**
- * ARIA live region politeness levels
- */
-export type AriaLive = 'off' | 'polite' | 'assertive';
-/**
- * ARIA roles commonly used in components
- */
-export type AriaRole = 'alert' | 'alertdialog' | 'button' | 'checkbox' | 'combobox' | 'dialog' | 'grid' | 'gridcell' | 'link' | 'listbox' | 'menu' | 'menubar' | 'menuitem' | 'menuitemcheckbox' | 'menuitemradio' | 'option' | 'progressbar' | 'radio' | 'radiogroup' | 'scrollbar' | 'searchbox' | 'slider' | 'spinbutton' | 'status' | 'switch' | 'tab' | 'tablist' | 'tabpanel' | 'textbox' | 'tooltip' | 'tree' | 'treegrid' | 'treeitem';
-/**
- * Standard ARIA attributes interface for components
- */
-export interface AriaAttributes {
-    role?: AriaRole;
-    'aria-label'?: string;
-    'aria-labelledby'?: string;
-    'aria-describedby'?: string;
-    'aria-expanded'?: boolean;
-    'aria-selected'?: boolean;
-    'aria-checked'?: boolean | 'mixed';
-    'aria-disabled'?: boolean;
-    'aria-hidden'?: boolean;
-    'aria-invalid'?: boolean;
-    'aria-required'?: boolean;
-    'aria-readonly'?: boolean;
-    'aria-pressed'?: boolean | 'mixed';
-    'aria-current'?: boolean | 'page' | 'step' | 'location' | 'date' | 'time';
-    'aria-haspopup'?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
-    'aria-controls'?: string;
-    'aria-owns'?: string;
-    'aria-live'?: AriaLive;
-    'aria-atomic'?: boolean;
-    'aria-busy'?: boolean;
-    'aria-valuemin'?: number;
-    'aria-valuemax'?: number;
-    'aria-valuenow'?: number;
-    'aria-valuetext'?: string;
-    'aria-orientation'?: 'horizontal' | 'vertical';
-    'aria-activedescendant'?: string;
-    'aria-autocomplete'?: 'none' | 'inline' | 'list' | 'both';
-    'aria-multiselectable'?: boolean;
-    'aria-sort'?: 'none' | 'ascending' | 'descending' | 'other';
-    'aria-level'?: number;
-    'aria-setsize'?: number;
-    'aria-posinset'?: number;
-    tabindex?: number;
-}
-/**
- * Generate ARIA attributes for a button component
- * @param options - Button accessibility options
- * @returns ARIA attributes object
- */
-export declare function getButtonAriaAttributes(options: {
-    label?: string;
-    pressed?: boolean;
-    expanded?: boolean;
-    disabled?: boolean;
-    controls?: string;
-    haspopup?: AriaAttributes['aria-haspopup'];
-    describedby?: string;
-}): AriaAttributes;
-/**
- * Generate ARIA attributes for a dialog/modal component
- * @param options - Dialog accessibility options
- * @returns ARIA attributes object
- */
-export declare function getDialogAriaAttributes(options: {
-    labelledby?: string;
-    describedby?: string;
-    modal?: boolean;
-}): AriaAttributes;
-/**
- * Generate ARIA attributes for a form input
- * @param options - Input accessibility options
- * @returns ARIA attributes object
- */
-export declare function getInputAriaAttributes(options: {
-    label?: string;
-    labelledby?: string;
-    describedby?: string;
-    invalid?: boolean;
-    required?: boolean;
-    readonly?: boolean;
-    disabled?: boolean;
-    errorId?: string;
-    helperId?: string;
-}): AriaAttributes;
-/**
- * Generate ARIA attributes for a progress bar
- * @param options - Progress accessibility options
- * @returns ARIA attributes object
- */
-export declare function getProgressAriaAttributes(options: {
-    value: number;
-    min?: number;
-    max?: number;
-    label?: string;
-    valueText?: string;
-}): AriaAttributes;
-/**
- * Generate ARIA attributes for a tab component
- * @param options - Tab accessibility options
- * @returns ARIA attributes for tab and tabpanel
- */
-export declare function getTabAriaAttributes(options: {
-    tabId: string;
-    panelId: string;
-    selected: boolean;
-    disabled?: boolean;
-}): {
-    tab: AriaAttributes;
-    panel: AriaAttributes;
-};
-/**
- * Generate ARIA attributes for a listbox option
- * @param options - Option accessibility options
- * @returns ARIA attributes object
- */
-export declare function getOptionAriaAttributes(options: {
-    selected: boolean;
-    disabled?: boolean;
-    setsize?: number;
-    posinset?: number;
-}): AriaAttributes;
-/**
- * Generate linked IDs for label and input association
- * @param baseName - Base name for generating IDs
- * @returns Object with inputId, labelId, errorId, and helperId
- */
-export declare function generateLinkedIds(baseName?: string): {
-    inputId: string;
-    labelId: string;
-    errorId: string;
-    helperId: string;
-};
-/**
- * Create a visually hidden element for screen readers
- * @returns CSS styles for visually hidden content
- */
-export declare function getVisuallyHiddenStyles(): Record<string, string>;
-/**
- * Check if the user has enabled reduced motion preference
- * @returns True if user prefers reduced motion
- */
-export declare function prefersReducedMotion(): boolean;
-/**
- * Check if the user has enabled high contrast mode
- * @returns True if high contrast mode is enabled
- */
-export declare function prefersHighContrast(): boolean;
-/**
- * Announce a message to screen readers using aria-live regions
- * @param message - The message to announce
- * @param politeness - The urgency level (polite or assertive)
- */
-export declare function announceToScreenReader(message: string, politeness?: 'polite' | 'assertive'): void;
-/**
- * Get the appropriate aria-current value for navigation items
- * @param isActive - Whether the item is active/current
- * @param type - The type of current indicator
- * @returns The aria-current value or undefined
- */
-export declare function getAriaCurrent(isActive: boolean, type?: 'page' | 'step' | 'location' | 'date' | 'time'): AriaAttributes['aria-current'];

package/lib/shared/utils/dom.utils.d.ts

@@ -1,108 +0,0 @@
-/**
- * DOM utility functions for PECB UI Components
- * @module utils/dom
- */
-/**
- * Check if code is running in a browser environment
- * @returns True if running in browser
- */
-export declare function isBrowser(): boolean;
-/**
- * Generate a unique ID for DOM elements
- * @param prefix - Optional prefix for the ID
- * @returns A unique ID string
- *
- * @example
- * generateUniqueId('btn') // 'btn-a1b2c3d4'
- */
-export declare function generateUniqueId(prefix?: string): string;
-/**
- * Check if an element matches a CSS selector
- * @param element - The element to check
- * @param selector - The CSS selector
- * @returns True if the element matches
- */
-export declare function matchesSelector(element: Element, selector: string): boolean;
-/**
- * Find the closest ancestor matching a selector
- * @param element - Starting element
- * @param selector - CSS selector to match
- * @returns The matching ancestor or null
- */
-export declare function closestElement<T extends Element>(element: Element, selector: string): T | null;
-/**
- * Check if an element is visible in the viewport
- * @param element - The element to check
- * @param partial - Whether partial visibility counts
- * @returns True if visible
- */
-export declare function isElementVisible(element: Element, partial?: boolean): boolean;
-/**
- * Get all focusable elements within a container
- * @param container - The container element
- * @returns Array of focusable elements
- */
-export declare function getFocusableElements(container: Element): HTMLElement[];
-/**
- * Trap focus within a container (useful for modals)
- * @param container - The container to trap focus in
- * @returns Cleanup function to remove the trap
- */
-export declare function trapFocus(container: HTMLElement): () => void;
-/**
- * Scroll an element into view smoothly
- * @param element - The element to scroll to
- * @param options - Scroll options
- */
-export declare function scrollIntoView(element: Element, options?: ScrollIntoViewOptions): void;
-/**
- * Get the scroll parent of an element
- * @param element - The element to find scroll parent for
- * @returns The scroll parent element
- */
-export declare function getScrollParent(element: Element): Element | null;
-/**
- * Disable body scroll (useful for modals)
- * @returns Cleanup function to re-enable scroll
- */
-export declare function disableBodyScroll(): () => void;
-/**
- * Copy text to clipboard
- * @param text - The text to copy
- * @returns Promise that resolves when copied
- */
-export declare function copyToClipboard(text: string): Promise<void>;
-/**
- * Check if an element has a specific CSS class
- * @param element - The element to check
- * @param className - The class name
- * @returns True if the element has the class
- */
-export declare function hasClass(element: Element, className: string): boolean;
-/**
- * Add CSS class(es) to an element
- * @param element - The element to modify
- * @param classNames - Class name(s) to add
- */
-export declare function addClass(element: Element, ...classNames: string[]): void;
-/**
- * Remove CSS class(es) from an element
- * @param element - The element to modify
- * @param classNames - Class name(s) to remove
- */
-export declare function removeClass(element: Element, ...classNames: string[]): void;
-/**
- * Toggle a CSS class on an element
- * @param element - The element to modify
- * @param className - The class name to toggle
- * @param force - Optional force add (true) or remove (false)
- * @returns True if the class is now present
- */
-export declare function toggleClass(element: Element, className: string, force?: boolean): boolean;
-/**
- * Get computed CSS property value
- * @param element - The element to check
- * @param property - CSS property name
- * @returns The computed value
- */
-export declare function getComputedStyleValue(element: Element, property: string): string;

package/lib/shared/utils/error.utils.d.ts

@@ -1,191 +0,0 @@
-/**
- * Error handling utility functions for PECB UI Components
- * Provides standardized error handling patterns
- * @module utils/error
- */
-/**
- * Error severity levels
- */
-export type ErrorSeverity = 'info' | 'warning' | 'error' | 'critical';
-/**
- * Error categories for classification
- */
-export type ErrorCategory = 'validation' | 'network' | 'authentication' | 'authorization' | 'configuration' | 'runtime' | 'unknown';
-/**
- * Standard error interface for PECB components
- */
-export interface PecbError {
-    /** Unique error code */
-    code: string;
-    /** Human-readable error message */
-    message: string;
-    /** Error severity level */
-    severity: ErrorSeverity;
-    /** Error category */
-    category: ErrorCategory;
-    /** Original error if wrapping another error */
-    originalError?: Error;
-    /** Additional context data */
-    context?: Record<string, unknown>;
-    /** Timestamp when error occurred */
-    timestamp: Date;
-    /** Suggested recovery action */
-    recoveryAction?: string;
-    /** Whether the error is recoverable */
-    recoverable: boolean;
-}
-/**
- * Validation error details
- */
-export interface ValidationError {
-    /** Field name that failed validation */
-    field: string;
-    /** Validation rule that failed */
-    rule: string;
-    /** Error message */
-    message: string;
-    /** Expected value or format */
-    expected?: string;
-    /** Actual value received */
-    actual?: unknown;
-}
-/**
- * Error factory options
- */
-export interface ErrorOptions {
-    code?: string;
-    severity?: ErrorSeverity;
-    category?: ErrorCategory;
-    context?: Record<string, unknown>;
-    recoveryAction?: string;
-    recoverable?: boolean;
-    originalError?: Error;
-}
-/**
- * Create a standardized PECB error
- * @param message - Error message
- * @param options - Additional error options
- * @returns A standardized PecbError object
- *
- * @example
- * const error = createError('Invalid input', {
- *   code: 'VALIDATION_001',
- *   category: 'validation',
- *   severity: 'warning',
- *   recoverable: true
- * });
- */
-export declare function createError(message: string, options?: ErrorOptions): PecbError;
-/**
- * Create a validation error
- * @param field - Field name that failed validation
- * @param rule - Validation rule that failed
- * @param message - Error message
- * @returns A ValidationError object
- *
- * @example
- * const error = createValidationError('email', 'format', 'Invalid email format');
- */
-export declare function createValidationError(field: string, rule: string, message: string, details?: {
-    expected?: string;
-    actual?: unknown;
-}): ValidationError;
-/**
- * Wrap an unknown error in a PecbError
- * @param error - The error to wrap
- * @param options - Additional options
- * @returns A standardized PecbError
- *
- * @example
- * try {
- *   await riskyOperation();
- * } catch (e) {
- *   const error = wrapError(e, { category: 'network' });
- *   handleError(error);
- * }
- */
-export declare function wrapError(error: unknown, options?: ErrorOptions): PecbError;
-/**
- * Type guard to check if an object is a PecbError
- * @param error - The object to check
- * @returns True if the object is a PecbError
- */
-export declare function isPecbError(error: unknown): error is PecbError;
-/**
- * Type guard to check if an error is recoverable
- * @param error - The error to check
- * @returns True if the error is recoverable
- */
-export declare function isRecoverableError(error: PecbError): boolean;
-/**
- * Format an error for display to users
- * @param error - The error to format
- * @param includeCode - Whether to include the error code
- * @returns Formatted error message
- */
-export declare function formatErrorMessage(error: PecbError, includeCode?: boolean): string;
-/**
- * Format an error for logging
- * @param error - The error to format
- * @returns Formatted error string for logging
- */
-export declare function formatErrorForLog(error: PecbError): string;
-/**
- * Create a network error
- * @param message - Error message
- * @param statusCode - HTTP status code if applicable
- * @param originalError - Original error
- * @returns A network category PecbError
- */
-export declare function createNetworkError(message: string, statusCode?: number, originalError?: Error): PecbError;
-/**
- * Create an authentication error
- * @param message - Error message
- * @param originalError - Original error
- * @returns An authentication category PecbError
- */
-export declare function createAuthError(message: string, originalError?: Error): PecbError;
-/**
- * Create an authorization error
- * @param message - Error message
- * @param resource - The resource that access was denied to
- * @returns An authorization category PecbError
- */
-export declare function createAuthorizationError(message: string, resource?: string): PecbError;
-/**
- * Create a configuration error
- * @param message - Error message
- * @param configKey - The configuration key that is invalid
- * @returns A configuration category PecbError
- */
-export declare function createConfigError(message: string, configKey?: string): PecbError;
-/**
- * Error handler type
- */
-export type ErrorHandler = (error: PecbError) => void;
-/**
- * Register an error handler for a category
- * @param category - The error category to handle
- * @param handler - The handler function
- * @returns Cleanup function to unregister
- */
-export declare function registerErrorHandler(category: ErrorCategory, handler: ErrorHandler): () => void;
-/**
- * Handle an error by invoking registered handlers
- * @param error - The error to handle
- */
-export declare function handleError(error: PecbError): void;
-/**
- * Try to execute an operation and return a result or error
- * @param operation - The operation to execute
- * @param errorOptions - Options for error wrapping
- * @returns A tuple of [result, null] or [null, error]
- */
-export declare function tryAsync<T>(operation: () => Promise<T>, errorOptions?: ErrorOptions): Promise<[T, null] | [null, PecbError]>;
-/**
- * Synchronous version of tryAsync
- * @param operation - The operation to execute
- * @param errorOptions - Options for error wrapping
- * @returns A tuple of [result, null] or [null, error]
- */
-export declare function trySync<T>(operation: () => T, errorOptions?: ErrorOptions): [T, null] | [null, PecbError];

package/lib/shared/utils/string.utils.d.ts

@@ -1,144 +0,0 @@
-/**
- * String utility functions for PECB UI Components
- * @module utils/string
- */
-/**
- * Convert a string to kebab-case
- * @param str - The string to convert
- * @returns The kebab-case string
- *
- * @example
- * toKebabCase('myComponentName') // 'my-component-name'
- * toKebabCase('MyComponentName') // 'my-component-name'
- */
-export declare function toKebabCase(str: string): string;
-/**
- * Convert a string to camelCase
- * @param str - The string to convert
- * @returns The camelCase string
- *
- * @example
- * toCamelCase('my-component-name') // 'myComponentName'
- * toCamelCase('my_component_name') // 'myComponentName'
- */
-export declare function toCamelCase(str: string): string;
-/**
- * Convert a string to PascalCase
- * @param str - The string to convert
- * @returns The PascalCase string
- *
- * @example
- * toPascalCase('my-component-name') // 'MyComponentName'
- */
-export declare function toPascalCase(str: string): string;
-/**
- * Convert a string to snake_case
- * @param str - The string to convert
- * @returns The snake_case string
- *
- * @example
- * toSnakeCase('myComponentName') // 'my_component_name'
- */
-export declare function toSnakeCase(str: string): string;
-/**
- * Capitalize the first letter of a string
- * @param str - The string to capitalize
- * @returns The capitalized string
- *
- * @example
- * capitalize('hello world') // 'Hello world'
- */
-export declare function capitalize(str: string): string;
-/**
- * Truncate a string to a specified length
- * @param str - The string to truncate
- * @param maxLength - Maximum length
- * @param suffix - Suffix to append when truncated (default: '...')
- * @returns The truncated string
- *
- * @example
- * truncate('Hello World', 8) // 'Hello...'
- * truncate('Hello World', 8, '…') // 'Hello W…'
- */
-export declare function truncate(str: string, maxLength: number, suffix?: string): string;
-/**
- * Check if a string is empty or contains only whitespace
- * @param str - The string to check
- * @returns True if the string is empty or whitespace
- *
- * @example
- * isBlank('') // true
- * isBlank('  ') // true
- * isBlank('hello') // false
- */
-export declare function isBlank(str: string | null | undefined): boolean;
-/**
- * Check if a string is not empty and contains non-whitespace characters
- * @param str - The string to check
- * @returns True if the string is not empty
- */
-export declare function isNotBlank(str: string | null | undefined): str is string;
-/**
- * Generate a slug from a string (URL-friendly)
- * @param str - The string to convert
- * @returns URL-friendly slug
- *
- * @example
- * slugify('Hello World!') // 'hello-world'
- * slugify('Café Latte') // 'cafe-latte'
- */
-export declare function slugify(str: string): string;
-/**
- * Escape HTML special characters
- * @param str - The string to escape
- * @returns The escaped string
- *
- * @example
- * escapeHtml('<script>alert("XSS")</script>') // '&lt;script&gt;alert(&quot;XSS&quot;)&lt;/script&gt;'
- */
-export declare function escapeHtml(str: string): string;
-/**
- * Strip HTML tags from a string
- * @param str - The string containing HTML
- * @returns The string without HTML tags
- *
- * @example
- * stripHtml('<p>Hello <strong>World</strong></p>') // 'Hello World'
- */
-export declare function stripHtml(str: string): string;
-/**
- * Generate initials from a name
- * @param name - The name to extract initials from
- * @param maxLength - Maximum number of initials (default: 2)
- * @returns The initials in uppercase
- *
- * @example
- * getInitials('John Doe') // 'JD'
- * getInitials('John Michael Doe', 3) // 'JMD'
- */
-export declare function getInitials(name: string, maxLength?: number): string;
-/**
- * Pluralize a word based on count
- * @param count - The count to check
- * @param singular - Singular form
- * @param plural - Plural form (optional, defaults to singular + 's')
- * @returns The appropriate form of the word
- *
- * @example
- * pluralize(1, 'item') // 'item'
- * pluralize(5, 'item') // 'items'
- * pluralize(2, 'child', 'children') // 'children'
- */
-export declare function pluralize(count: number, singular: string, plural?: string): string;
-/**
- * Format a number as a string with count and pluralized label
- * @param count - The count
- * @param singular - Singular form of the label
- * @param plural - Plural form (optional)
- * @returns Formatted string like "5 items"
- *
- * @example
- * formatCount(1, 'item') // '1 item'
- * formatCount(5, 'item') // '5 items'
- */
-export declare function formatCount(count: number, singular: string, plural?: string): string;

package/public-api.d.ts

@@ -1,24 +0,0 @@
-export * from './lib/pecb-components.module';
-export * from './lib/components/button/button.component';
-export * from './lib/components/card/card.component';
-export * from './lib/components/status/status.component';
-export * from './lib/components/pagination/pagination.component';
-export * from './lib/components/table/table.component';
-export * from './lib/components/tab/tab.component';
-export * from './lib/components/datepicker/datepicker.component';
-export * from './lib/components/input/input.component';
-export * from './lib/components/radio/radio.component';
-export * from './lib/components/checkbox/checkbox.component';
-export * from './lib/components/toggle/toggle.component';
-export * from './lib/components/dropdown/dropdown.component';
-export * from './lib/components/right-modal/right-modal.component';
-export * from './lib/components/sidebar/sidebar.component';
-export * from './lib/services/notification.service';
-export * from './lib/services/theme.service';
-export * from './lib/services/loading.service';
-export * from './lib/shared/types/common.types';
-export * from './lib/shared/interfaces/component.interfaces';
-export { toKebabCase, toCamelCase, toPascalCase, toSnakeCase, capitalize, truncate, isBlank, isNotBlank, slugify, escapeHtml, stripHtml, getInitials, pluralize, formatCount } from './lib/shared/utils/string.utils';
-export { isBrowser, generateUniqueId, matchesSelector, closestElement, isElementVisible, getFocusableElements, trapFocus, scrollIntoView, getScrollParent, disableBodyScroll, copyToClipboard, hasClass, addClass, removeClass, toggleClass, getComputedStyleValue } from './lib/shared/utils/dom.utils';
-export { AriaLive, AriaRole, AriaAttributes, getButtonAriaAttributes, getDialogAriaAttributes, getInputAriaAttributes, getProgressAriaAttributes, getTabAriaAttributes, getOptionAriaAttributes, generateLinkedIds, getVisuallyHiddenStyles, prefersReducedMotion, prefersHighContrast, announceToScreenReader, getAriaCurrent } from './lib/shared/utils/accessibility.utils';
-export { ErrorSeverity, ErrorCategory, PecbError, ValidationError, ErrorOptions, ErrorHandler, createError, createValidationError, wrapError, isPecbError, isRecoverableError, formatErrorMessage, formatErrorForLog, createNetworkError, createAuthError, createAuthorizationError, createConfigError, registerErrorHandler, handleError, tryAsync, trySync } from './lib/shared/utils/error.utils';