@eduboxpro/studio 0.1.8 → 0.1.10

package/index.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, EnvironmentProviders, ElementRef, Signal } from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
+import { InjectionToken, EnvironmentProviders, TemplateRef, ElementRef, WritableSignal, Signal } from '@angular/core';
+import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 import { icons } from 'lucide-angular';
 
 /**
@@ -219,6 +219,43 @@ interface ButtonToggleGroupDefaultsConfig {
     radius?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
     shadow?: 'none' | 'sm' | 'md' | 'lg';
 }
+/**
+ * Select component defaults configuration
+ */
+interface SelectDefaultsConfig {
+    variant?: 'outline' | 'filled' | 'underline';
+    size?: 'sm' | 'md' | 'lg';
+    radius?: 'none' | 'sm' | 'md' | 'lg' | 'full';
+    searchable?: boolean;
+    clearable?: boolean;
+    maxHeight?: string;
+    position?: 'auto' | 'top' | 'bottom';
+}
+/**
+ * Drawer component defaults configuration
+ */
+interface DrawerDefaultsConfig {
+    position?: 'left' | 'right' | 'top' | 'bottom';
+    size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+    modal?: boolean;
+    closeOnEscape?: boolean;
+    closeOnBackdropClick?: boolean;
+    showHeader?: boolean;
+    showCloseButton?: boolean;
+    closeButtonPosition?: 'left' | 'right';
+    swipeToClose?: boolean;
+    swipeThreshold?: number;
+    animationDuration?: number;
+    animationEasing?: 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';
+    disableAnimation?: boolean;
+    shadow?: boolean;
+    shadowSize?: 'sm' | 'md' | 'lg' | 'xl';
+    radius?: 'none' | 'sm' | 'md' | 'lg';
+    autoFocus?: boolean;
+    restoreFocus?: boolean;
+    blockScroll?: boolean;
+    role?: 'dialog' | 'alertdialog';
+}
 /**
  * Components defaults configuration
  */
@@ -231,6 +268,8 @@ interface ComponentsConfig {
     textarea?: TextareaDefaultsConfig;
     buttonGroup?: ButtonGroupDefaultsConfig;
     buttonToggleGroup?: ButtonToggleGroupDefaultsConfig;
+    select?: SelectDefaultsConfig;
+    drawer?: DrawerDefaultsConfig;
 }
 /**
  * Main Studio configuration interface
@@ -561,6 +600,176 @@ type CheckboxColor = 'primary' | 'secondary' | 'success' | 'error';
 type CheckboxVariant = 'default' | 'outlined' | 'filled';
 type CheckboxRadius = 'none' | 'sm' | 'md' | 'lg' | 'full';
 
+type DrawerPosition = 'left' | 'right' | 'top' | 'bottom';
+type DrawerSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+type DrawerRadius = 'none' | 'sm' | 'md' | 'lg';
+type DrawerShadowSize = 'sm' | 'md' | 'lg' | 'xl';
+type DrawerRole = 'dialog' | 'alertdialog';
+type DrawerAnimationEasing = 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';
+type DrawerCloseButtonPosition = 'left' | 'right';
+interface DrawerConfig {
+    position?: DrawerPosition;
+    size?: DrawerSize;
+    modal?: boolean;
+    closeOnEscape?: boolean;
+    closeOnBackdropClick?: boolean;
+    showCloseButton?: boolean;
+    closeButtonPosition?: DrawerCloseButtonPosition;
+    swipeToClose?: boolean;
+    swipeThreshold?: number;
+    animationDuration?: number;
+    animationEasing?: DrawerAnimationEasing;
+    disableAnimation?: boolean;
+    shadow?: boolean;
+    shadowSize?: DrawerShadowSize;
+    radius?: DrawerRadius;
+    autoFocus?: boolean;
+    restoreFocus?: boolean;
+    blockScroll?: boolean;
+    role?: DrawerRole;
+}
+
+declare class DrawerComponent {
+    private readonly document;
+    private readonly destroyRef;
+    private readonly configService;
+    private readonly drawerService;
+    private readonly drawerDefaults;
+    protected readonly headerTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    protected readonly footerTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    protected readonly panelEl: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
+    id: _angular_core.InputSignal<string>;
+    visible: _angular_core.ModelSignal<boolean>;
+    positionInput: _angular_core.InputSignal<DrawerPosition | undefined>;
+    sizeInput: _angular_core.InputSignal<DrawerSize | undefined>;
+    customWidth: _angular_core.InputSignal<string | undefined>;
+    customHeight: _angular_core.InputSignal<string | undefined>;
+    position: _angular_core.Signal<"left" | "right" | "top" | "bottom">;
+    size: _angular_core.Signal<"sm" | "md" | "lg" | "xl" | "full">;
+    modalInput: _angular_core.InputSignal<boolean | undefined>;
+    closeOnEscapeInput: _angular_core.InputSignal<boolean | undefined>;
+    closeOnBackdropClickInput: _angular_core.InputSignal<boolean | undefined>;
+    blockScrollInput: _angular_core.InputSignal<boolean | undefined>;
+    modal: _angular_core.Signal<boolean>;
+    closeOnEscape: _angular_core.Signal<boolean>;
+    closeOnBackdropClick: _angular_core.Signal<boolean>;
+    blockScroll: _angular_core.Signal<boolean>;
+    header: _angular_core.InputSignal<string | undefined>;
+    showHeaderInput: _angular_core.InputSignal<boolean | undefined>;
+    showCloseButtonInput: _angular_core.InputSignal<boolean | undefined>;
+    closeButtonPositionInput: _angular_core.InputSignal<DrawerCloseButtonPosition | undefined>;
+    showFooter: _angular_core.InputSignal<boolean>;
+    showHeader: _angular_core.Signal<boolean>;
+    showCloseButton: _angular_core.Signal<boolean>;
+    closeButtonPosition: _angular_core.Signal<"left" | "right">;
+    swipeToCloseInput: _angular_core.InputSignal<boolean | undefined>;
+    swipeThresholdInput: _angular_core.InputSignal<number | undefined>;
+    swipeToClose: _angular_core.Signal<boolean>;
+    swipeThreshold: _angular_core.Signal<number>;
+    animationDurationInput: _angular_core.InputSignal<number | undefined>;
+    animationEasingInput: _angular_core.InputSignal<DrawerAnimationEasing | undefined>;
+    disableAnimationInput: _angular_core.InputSignal<boolean | undefined>;
+    animationDuration: _angular_core.Signal<number>;
+    animationEasing: _angular_core.Signal<"ease" | "ease-in" | "ease-out" | "ease-in-out">;
+    disableAnimation: _angular_core.Signal<boolean>;
+    radiusInput: _angular_core.InputSignal<DrawerRadius | undefined>;
+    shadowInput: _angular_core.InputSignal<boolean | undefined>;
+    shadowSizeInput: _angular_core.InputSignal<DrawerShadowSize | undefined>;
+    radius: _angular_core.Signal<"sm" | "md" | "lg" | "none">;
+    shadow: _angular_core.Signal<boolean>;
+    shadowSize: _angular_core.Signal<"sm" | "md" | "lg" | "xl">;
+    ariaLabel: _angular_core.InputSignal<string | undefined>;
+    ariaLabelledBy: _angular_core.InputSignal<string | undefined>;
+    ariaDescribedBy: _angular_core.InputSignal<string | undefined>;
+    autoFocusInput: _angular_core.InputSignal<boolean | undefined>;
+    restoreFocusInput: _angular_core.InputSignal<boolean | undefined>;
+    roleInput: _angular_core.InputSignal<DrawerRole | undefined>;
+    autoFocus: _angular_core.Signal<boolean>;
+    restoreFocus: _angular_core.Signal<boolean>;
+    role: _angular_core.Signal<"dialog" | "alertdialog">;
+    visibleChange: _angular_core.OutputEmitterRef<boolean>;
+    opened: _angular_core.OutputEmitterRef<void>;
+    closed: _angular_core.OutputEmitterRef<void>;
+    backdropClick: _angular_core.OutputEmitterRef<void>;
+    private previousActiveElement?;
+    private touchStartX;
+    private touchStartY;
+    private isDragging;
+    private scrollbarWidth;
+    protected hostClasses: _angular_core.Signal<string>;
+    constructor();
+    protected handleOpen(): void;
+    protected handleClose(): void;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    protected handleBackdropClick(): void;
+    protected handleEscapeKey(event: KeyboardEvent): void;
+    protected onTouchStart(event: TouchEvent): void;
+    protected onTouchMove(event: TouchEvent): void;
+    protected onTouchEnd(event: TouchEvent): void;
+    private applyDragTransform;
+    private resetTransform;
+    private lockBodyScroll;
+    private unlockBodyScroll;
+    private setupFocusTrap;
+    private restorePreviousFocus;
+    private getFirstFocusableElement;
+    protected handleKeydown(event: KeyboardEvent): void;
+    private trapFocus;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DrawerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DrawerComponent, "studio-drawer", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "positionInput": { "alias": "position"; "required": false; "isSignal": true; }; "sizeInput": { "alias": "size"; "required": false; "isSignal": true; }; "customWidth": { "alias": "customWidth"; "required": false; "isSignal": true; }; "customHeight": { "alias": "customHeight"; "required": false; "isSignal": true; }; "modalInput": { "alias": "modal"; "required": false; "isSignal": true; }; "closeOnEscapeInput": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "closeOnBackdropClickInput": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "blockScrollInput": { "alias": "blockScroll"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "showHeaderInput": { "alias": "showHeader"; "required": false; "isSignal": true; }; "showCloseButtonInput": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "closeButtonPositionInput": { "alias": "closeButtonPosition"; "required": false; "isSignal": true; }; "showFooter": { "alias": "showFooter"; "required": false; "isSignal": true; }; "swipeToCloseInput": { "alias": "swipeToClose"; "required": false; "isSignal": true; }; "swipeThresholdInput": { "alias": "swipeThreshold"; "required": false; "isSignal": true; }; "animationDurationInput": { "alias": "animationDuration"; "required": false; "isSignal": true; }; "animationEasingInput": { "alias": "animationEasing"; "required": false; "isSignal": true; }; "disableAnimationInput": { "alias": "disableAnimation"; "required": false; "isSignal": true; }; "radiusInput": { "alias": "radius"; "required": false; "isSignal": true; }; "shadowInput": { "alias": "shadow"; "required": false; "isSignal": true; }; "shadowSizeInput": { "alias": "shadowSize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "autoFocusInput": { "alias": "autoFocus"; "required": false; "isSignal": true; }; "restoreFocusInput": { "alias": "restoreFocus"; "required": false; "isSignal": true; }; "roleInput": { "alias": "role"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "visibleChange": "visibleChange"; "opened": "opened"; "closed": "closed"; "backdropClick": "backdropClick"; }, ["headerTemplate", "footerTemplate"], ["[drawerHeader]", "*", "[drawerFooter]"], true, never>;
+}
+
+/**
+ * Service for programmatic control of Drawer components
+ *
+ * @example
+ * ```typescript
+ * // In component
+ * private drawerService = inject(DrawerService);
+ *
+ * openSettings() {
+ *   this.drawerService.open('settings-drawer');
+ * }
+ * ```
+ */
+declare class DrawerService {
+    private drawers;
+    /**
+     * Register a drawer with the service
+     * Called automatically by DrawerComponent
+     */
+    register(id: string, signal: WritableSignal<boolean>): void;
+    /**
+     * Unregister a drawer from the service
+     * Called automatically on component destroy
+     */
+    unregister(id: string): void;
+    /**
+     * Open a drawer by ID
+     */
+    open(id: string): void;
+    /**
+     * Close a drawer by ID
+     */
+    close(id: string): void;
+    /**
+     * Toggle a drawer by ID
+     */
+    toggle(id: string): void;
+    /**
+     * Close all registered drawers
+     */
+    closeAll(): void;
+    /**
+     * Check if a drawer is open
+     */
+    isOpen(id: string): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DrawerService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DrawerService>;
+}
+
 /**
  * Icon component with Lucide icons support
  *
@@ -699,6 +908,104 @@ declare class InputComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "studio-input", never, { "variantInput": { "alias": "variant"; "required": false; "isSignal": true; }; "sizeInput": { "alias": "size"; "required": false; "isSignal": true; }; "radiusInput": { "alias": "radius"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "inputmode": { "alias": "inputmode"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "floatingLabel": { "alias": "floatingLabel"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; "isSignal": true; }; "suffixIcon": { "alias": "suffixIcon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "showPasswordToggle": { "alias": "showPasswordToggle"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "autoFocus": { "alias": "autoFocus"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "focused": "focused"; "blurred": "blurred"; "cleared": "cleared"; "entered": "entered"; }, never, never, true, never>;
 }
 
+interface SelectOption<T = any> {
+    label: string;
+    value: T;
+    disabled?: boolean;
+    icon?: string;
+    description?: string;
+    group?: string;
+    metadata?: Record<string, any>;
+}
+interface SelectOptionGroup<T = any> {
+    label: string;
+    options: SelectOption<T>[];
+    disabled?: boolean;
+}
+type SelectVariant = 'outline' | 'filled' | 'underline';
+type SelectSize = 'sm' | 'md' | 'lg';
+type SelectPosition = 'auto' | 'top' | 'bottom';
+interface SelectDisplayContext<T = any> {
+    option: SelectOption<T>;
+    selected: boolean;
+    highlighted: boolean;
+}
+
+declare class SelectComponent<T = any> implements ControlValueAccessor {
+    private readonly configService;
+    private readonly selectDefaults;
+    protected readonly triggerEl: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
+    protected readonly dropdownEl: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
+    variantInput: _angular_core.InputSignal<SelectVariant | undefined>;
+    sizeInput: _angular_core.InputSignal<SelectSize | undefined>;
+    radiusInput: _angular_core.InputSignal<"sm" | "md" | "lg" | "none" | "full" | undefined>;
+    variant: _angular_core.Signal<"outline" | "filled" | "underline">;
+    size: _angular_core.Signal<"sm" | "md" | "lg">;
+    radius: _angular_core.Signal<"sm" | "md" | "lg" | "none" | "full">;
+    options: _angular_core.InputSignal<SelectOption<T>[] | SelectOptionGroup<T>[]>;
+    placeholder: _angular_core.InputSignal<string>;
+    multiple: _angular_core.InputSignal<boolean>;
+    searchable: _angular_core.InputSignal<boolean>;
+    clearable: _angular_core.InputSignal<boolean>;
+    disabled: _angular_core.InputSignal<boolean>;
+    loading: _angular_core.InputSignal<boolean>;
+    label: _angular_core.InputSignal<string | undefined>;
+    floatingLabel: _angular_core.InputSignal<boolean>;
+    hint: _angular_core.InputSignal<string | undefined>;
+    error: _angular_core.InputSignal<boolean>;
+    errorMessage: _angular_core.InputSignal<string | undefined>;
+    required: _angular_core.InputSignal<boolean>;
+    prefixIcon: _angular_core.InputSignal<string | undefined>;
+    suffixIcon: _angular_core.InputSignal<string>;
+    fullWidth: _angular_core.InputSignal<boolean>;
+    maxHeight: _angular_core.InputSignal<string>;
+    position: _angular_core.InputSignal<SelectPosition>;
+    searchPlaceholder: _angular_core.InputSignal<string>;
+    valueChange: _angular_core.OutputEmitterRef<T | T[] | null>;
+    searchChange: _angular_core.OutputEmitterRef<string>;
+    opened: _angular_core.OutputEmitterRef<void>;
+    closed: _angular_core.OutputEmitterRef<void>;
+    optionSelected: _angular_core.OutputEmitterRef<SelectOption<T>>;
+    protected isOpen: _angular_core.WritableSignal<boolean>;
+    protected searchQuery: _angular_core.WritableSignal<string>;
+    protected selectedValue: _angular_core.WritableSignal<T | T[] | null>;
+    protected highlightedIndex: _angular_core.WritableSignal<number>;
+    protected isFocused: _angular_core.WritableSignal<boolean>;
+    protected isTouched: _angular_core.WritableSignal<boolean>;
+    protected generatedId: string;
+    private onChange;
+    private onTouched;
+    constructor();
+    protected flattenedOptions: _angular_core.Signal<SelectOption<T>[]>;
+    protected filteredOptions: _angular_core.Signal<SelectOption<T>[]>;
+    protected selectedOptions: _angular_core.Signal<SelectOption<T> | SelectOption<T>[] | null>;
+    protected displayValue: _angular_core.Signal<string>;
+    protected hasValue: _angular_core.Signal<boolean>;
+    protected hostClasses: _angular_core.Signal<string>;
+    protected toggle(): void;
+    protected close(): void;
+    protected selectOption(option: SelectOption<T>): void;
+    protected clear(event: Event): void;
+    protected isSelected(option: SelectOption<T>): boolean;
+    protected handleSearch(event: Event): void;
+    protected handleKeydown(event: KeyboardEvent): void;
+    private highlightNext;
+    private highlightPrevious;
+    private selectHighlighted;
+    private compareValues;
+    private isOptionGroup;
+    private focusSearchInput;
+    private clickOutsideListener?;
+    private setupClickOutside;
+    private cleanupClickOutside;
+    writeValue(value: T | T[]): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent<any>, "studio-select", never, { "variantInput": { "alias": "variant"; "required": false; "isSignal": true; }; "sizeInput": { "alias": "size"; "required": false; "isSignal": true; }; "radiusInput": { "alias": "radius"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "floatingLabel": { "alias": "floatingLabel"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; "isSignal": true; }; "suffixIcon": { "alias": "suffixIcon"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "searchChange": "searchChange"; "opened": "opened"; "closed": "closed"; "optionSelected": "optionSelected"; }, never, never, true, never>;
+}
+
 /**
  * Toggle switch component with customizable size and color
  *
@@ -1015,6 +1322,78 @@ declare class ThemeSwitchComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThemeSwitchComponent, "studio-theme-switch", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare class MaskDirective implements Validator {
+    private readonly el;
+    private readonly renderer;
+    private readonly destroyRef;
+    readonly mask: _angular_core.InputSignalWithTransform<string, string>;
+    readonly maskPlaceholder: _angular_core.InputSignal<string>;
+    readonly maskGuide: _angular_core.InputSignal<boolean>;
+    readonly maskShowOnHover: _angular_core.InputSignal<boolean>;
+    readonly maskShowOnFocus: _angular_core.InputSignal<boolean>;
+    readonly maskClearIncomplete: _angular_core.InputSignal<boolean>;
+    readonly maskAutoUnmask: _angular_core.InputSignal<boolean>;
+    private readonly config;
+    private readonly engine;
+    readonly isComplete: _angular_core.WritableSignal<boolean>;
+    readonly isActive: _angular_core.WritableSignal<boolean>;
+    private onChange;
+    private onTouched;
+    constructor();
+    onInput(event: InputEvent): void;
+    onFocus(): void;
+    onBlur(): void;
+    onPaste(event: ClipboardEvent): void;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    validate(control: AbstractControl): ValidationErrors | null;
+    private updatePlaceholder;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaskDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MaskDirective, "input[studioMask]", never, { "mask": { "alias": "studioMask"; "required": false; "isSignal": true; }; "maskPlaceholder": { "alias": "maskPlaceholder"; "required": false; "isSignal": true; }; "maskGuide": { "alias": "maskGuide"; "required": false; "isSignal": true; }; "maskShowOnHover": { "alias": "maskShowOnHover"; "required": false; "isSignal": true; }; "maskShowOnFocus": { "alias": "maskShowOnFocus"; "required": false; "isSignal": true; }; "maskClearIncomplete": { "alias": "maskClearIncomplete"; "required": false; "isSignal": true; }; "maskAutoUnmask": { "alias": "maskAutoUnmask"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface MaskConfig {
+    pattern: string;
+    placeholder?: string;
+    guide?: boolean;
+    showOnHover?: boolean;
+    showOnFocus?: boolean;
+    clearIncomplete?: boolean;
+    autoUnmask?: boolean;
+}
+interface MaskToken {
+    type: 'digit' | 'letter' | 'alphanumeric' | 'any' | 'mixed' | 'static';
+    char?: string;
+    pattern?: RegExp;
+    optional?: boolean;
+}
+interface MaskResult {
+    value: string;
+    raw: string;
+    cursor: number;
+    isComplete: boolean;
+}
+type MaskPreset = 'phone' | 'phone-ru' | 'phone-kz' | 'date' | 'datetime' | 'time' | 'card' | 'inn' | 'snils' | 'passport-ru';
+
+declare class MaskEngine {
+    private readonly config;
+    private readonly tokens;
+    private readonly patterns;
+    constructor(config: MaskConfig);
+    process(value: string, cursorPos?: number): MaskResult;
+    getPlaceholder(): string;
+    private parsePattern;
+    private getTokenType;
+    private applyMask;
+    private extractRaw;
+    private applyGuide;
+    private calculateCursor;
+    private checkComplete;
+}
+
+declare const MASK_PRESETS: Record<MaskPreset, MaskConfig>;
+
 /**
  * Checks if URL is safe for navigation
  *
@@ -1113,5 +1492,5 @@ declare function loadGoogleFonts(fonts: Array<{
     display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
 }>): void;
 
-export { BadgeComponent, ButtonComponent, ButtonGroupComponent, ButtonToggleGroupComponent, CheckboxComponent, IconComponent, InputComponent, STUDIO_CONFIG, StudioConfigService, SwitchComponent, TextareaComponent, ThemeSwitchComponent, classNames, isSafeUrl, loadGoogleFont, loadGoogleFonts, provideStudioConfig, provideStudioIcons, sanitizeUrl, withConfigDefault };
-export type { BadgeDefaultsConfig, ButtonDefaultsConfig, ButtonGroupDefaultsConfig, ButtonToggleGroupDefaultsConfig, ButtonToggleGroupOption, ButtonToggleGroupValue, CheckboxColor, CheckboxDefaultsConfig, CheckboxRadius, CheckboxSize, CheckboxVariant, ColorConfig, ComponentsConfig, InputDefaultsConfig, InputMode, InputType, StudioConfig, StudioThemeConfig, SwitchDefaultsConfig, TextareaColor, TextareaDefaultsConfig, TextareaRadius, TextareaSize, TextareaVariant, ThemeMode };
+export { BadgeComponent, ButtonComponent, ButtonGroupComponent, ButtonToggleGroupComponent, CheckboxComponent, DrawerComponent, DrawerService, IconComponent, InputComponent, MASK_PRESETS, MaskDirective, MaskEngine, STUDIO_CONFIG, SelectComponent, StudioConfigService, SwitchComponent, TextareaComponent, ThemeSwitchComponent, classNames, isSafeUrl, loadGoogleFont, loadGoogleFonts, provideStudioConfig, provideStudioIcons, sanitizeUrl, withConfigDefault };
+export type { BadgeDefaultsConfig, ButtonDefaultsConfig, ButtonGroupDefaultsConfig, ButtonToggleGroupDefaultsConfig, ButtonToggleGroupOption, ButtonToggleGroupValue, CheckboxColor, CheckboxDefaultsConfig, CheckboxRadius, CheckboxSize, CheckboxVariant, ColorConfig, ComponentsConfig, DrawerAnimationEasing, DrawerCloseButtonPosition, DrawerConfig, DrawerDefaultsConfig, DrawerPosition, DrawerRadius, DrawerRole, DrawerShadowSize, DrawerSize, InputDefaultsConfig, InputMode, InputType, MaskConfig, MaskPreset, MaskResult, MaskToken, SelectDefaultsConfig, SelectDisplayContext, SelectOption, SelectOptionGroup, SelectPosition, SelectSize, SelectVariant, StudioConfig, StudioThemeConfig, SwitchDefaultsConfig, TextareaColor, TextareaDefaultsConfig, TextareaRadius, TextareaSize, TextareaVariant, ThemeMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eduboxpro/studio",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Modern Angular UI library for educational platforms with customizable design system",
   "keywords": [
     "angular",