@eduboxpro/studio 0.1.8 → 0.1.9

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 { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 import { icons } from 'lucide-angular';
 
 /**
@@ -219,6 +219,18 @@ 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';
+}
 /**
  * Components defaults configuration
  */
@@ -231,6 +243,7 @@ interface ComponentsConfig {
     textarea?: TextareaDefaultsConfig;
     buttonGroup?: ButtonGroupDefaultsConfig;
     buttonToggleGroup?: ButtonToggleGroupDefaultsConfig;
+    select?: SelectDefaultsConfig;
 }
 /**
  * Main Studio configuration interface
@@ -699,6 +712,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 +1126,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 +1296,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, 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, 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.9",
   "description": "Modern Angular UI library for educational platforms with customizable design system",
   "keywords": [
     "angular",