@aitronos/freddy-plugins 0.4.57 → 0.4.59

package/dist/src/interfaces/input-field.interfaces.d.ts

@@ -0,0 +1,226 @@
+import { Component } from 'vue';
+export type InputFieldSize = 'sm' | 'md' | 'lg';
+export type InputFieldColorStyle = 'freddy' | 'contentplate';
+export type InputFieldState = 'placeholder' | 'filled' | 'focused' | 'disabled' | 'loading' | 'success' | 'error';
+export type InputFieldVariant = 'default' | 'phone' | 'price' | 'url' | 'card' | 'tags' | 'copy' | 'leading-dropdown' | 'trailing-dropdown' | 'leading-text' | 'payment' | 'trailing-button' | 'clear' | 'freddy-input';
+export interface UnifiedInputFieldProps {
+    size?: InputFieldSize;
+    colorStyle?: InputFieldColorStyle;
+    state?: InputFieldState;
+    destructive?: boolean;
+    variant?: InputFieldVariant;
+    type?: InputFieldVariant;
+    label?: string;
+    hintText?: string;
+    required?: boolean;
+    placeholder?: string;
+    value?: string;
+    modelValue?: string;
+    inputType?: string;
+    readonly?: boolean;
+    disabled?: boolean;
+    leadingIcon?: Component | string;
+    trailingIcon?: Component | string;
+    tooltipText?: string;
+    iconLeading?: boolean;
+    helpIcon?: boolean;
+    helpText?: string;
+    leadingDropdownText?: string;
+    trailingDropdownText?: string;
+    leadingText?: string;
+    trailingButtonText?: string;
+    countryCode?: string;
+    countryOptions?: CountryOption[];
+    phoneNumber?: string;
+    currency?: string;
+    currencyOptions?: CurrencyOption[];
+    amount?: string | number;
+    showCurrencySymbol?: boolean;
+    protocol?: 'http://' | 'https://';
+    allowProtocolChange?: boolean;
+    url?: string;
+    cardNumber?: string;
+    cardType?: CardType;
+    maskInput?: boolean;
+    showCardIcon?: boolean;
+    tags?: string[];
+    maxTags?: number;
+    allowDuplicates?: boolean;
+    tagSeparators?: string[];
+    suggestions?: string[];
+    copyText?: string;
+    showCopyButton?: boolean;
+    copySuccessMessage?: string;
+}
+export interface BaseInputFieldProps extends UnifiedInputFieldProps {
+}
+export interface PhoneInputProps extends BaseInputFieldProps {
+    countryCode?: string;
+    countryOptions?: CountryOption[];
+    phoneNumber?: string;
+}
+export interface CountryOption {
+    code: string;
+    name: string;
+    flag: string;
+    dialCode: string;
+}
+export interface PriceInputProps extends BaseInputFieldProps {
+    currency?: string;
+    currencyOptions?: CurrencyOption[];
+    amount?: string | number;
+    showCurrencySymbol?: boolean;
+}
+export interface CurrencyOption {
+    code: string;
+    name: string;
+    symbol: string;
+}
+export interface UrlInputProps extends BaseInputFieldProps {
+    protocol?: 'http://' | 'https://';
+    allowProtocolChange?: boolean;
+    url?: string;
+}
+export interface CardInputProps extends BaseInputFieldProps {
+    cardNumber?: string;
+    cardType?: CardType;
+    maskInput?: boolean;
+    showCardIcon?: boolean;
+}
+export type CardType = 'visa' | 'mastercard' | 'amex' | 'discover' | 'unknown';
+export interface TagsInputProps extends BaseInputFieldProps {
+    tags?: string[];
+    maxTags?: number;
+    allowDuplicates?: boolean;
+    tagSeparators?: string[];
+    suggestions?: string[];
+}
+export interface CopyInputProps extends BaseInputFieldProps {
+    copyText?: string;
+    showCopyButton?: boolean;
+    copySuccessMessage?: string;
+}
+export interface UnifiedInputFieldEvents {
+    'update:modelValue': [value: string];
+    input: [value: string];
+    focus: [event: FocusEvent];
+    blur: [event: FocusEvent];
+    keydown: [event: KeyboardEvent];
+    'leading-icon-click': [event: MouseEvent];
+    'trailing-icon-click': [event: MouseEvent];
+    'trailing-button-click': [event: MouseEvent];
+    'update:countryCode': [code: string];
+    'update:phoneNumber': [number: string];
+    'country-change': [country: CountryOption];
+    'update:currency': [currency: string];
+    'update:amount': [amount: string | number];
+    'currency-change': [currency: CurrencyOption];
+    'update:protocol': [protocol: string];
+    'update:url': [url: string];
+    'protocol-change': [protocol: string];
+    'update:cardNumber': [number: string];
+    'card-type-detected': [type: CardType];
+    'update:tags': [tags: string[]];
+    'tag-added': [tag: string];
+    'tag-removed': [tag: string, index: number];
+    'max-tags-reached': [];
+    'copy-success': [text: string];
+    'copy-error': [error: Error];
+}
+export interface InputFieldEvents extends UnifiedInputFieldEvents {
+}
+export interface PhoneInputEvents extends InputFieldEvents {
+    'update:countryCode': [code: string];
+    'update:phoneNumber': [number: string];
+    'country-change': [country: CountryOption];
+}
+export interface PriceInputEvents extends InputFieldEvents {
+    'update:currency': [currency: string];
+    'update:amount': [amount: string | number];
+    'currency-change': [currency: CurrencyOption];
+}
+export interface UrlInputEvents extends InputFieldEvents {
+    'update:protocol': [protocol: string];
+    'update:url': [url: string];
+    'protocol-change': [protocol: string];
+}
+export interface CardInputEvents extends InputFieldEvents {
+    'update:cardNumber': [number: string];
+    'card-type-detected': [type: CardType];
+}
+export interface TagsInputEvents extends InputFieldEvents {
+    'update:tags': [tags: string[]];
+    'tag-added': [tag: string];
+    'tag-removed': [tag: string, index: number];
+    'max-tags-reached': [];
+}
+export interface CopyInputEvents extends InputFieldEvents {
+    'copy-success': [text: string];
+    'copy-error': [error: Error];
+}
+export interface BaseInputProps {
+    size?: InputFieldSize;
+    colorStyle?: InputFieldColorStyle;
+    state?: InputFieldState;
+    destructive?: boolean;
+    required?: boolean;
+    label?: string;
+    hintText?: string;
+    disabled?: boolean;
+}
+export interface DefaultInputProps extends BaseInputProps {
+    placeholder?: string;
+    inputType?: string;
+    modelValue?: string;
+    readonly?: boolean;
+    leadingIcon?: Component | string;
+    trailingIcon?: Component | string;
+    tooltipText?: string;
+}
+export interface DefaultInputEvents {
+    'update:modelValue': [value: string];
+    input: [value: string];
+    focus: [event: FocusEvent];
+    blur: [event: FocusEvent];
+    keydown: [event: KeyboardEvent];
+    'leading-icon-click': [event: MouseEvent];
+    'trailing-icon-click': [event: MouseEvent];
+}
+export interface PhoneInputProps extends BaseInputProps {
+    placeholder?: string;
+    countryCode?: string;
+    phoneNumber?: string;
+    countryOptions?: CountryOption[];
+    trailingIcon?: Component | string;
+    tooltipText?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+}
+export interface PhoneInputEvents {
+    'update:modelValue': [value: string];
+    'update:countryCode': [code: string];
+    'update:phoneNumber': [number: string];
+    'country-change': [country: CountryOption];
+    input: [value: string];
+    focus: [event: FocusEvent];
+    blur: [event: FocusEvent];
+}
+export interface CardInputProps extends BaseInputProps {
+    placeholder?: string;
+    cardNumber?: string;
+    cardType?: CardType;
+    maskInput?: boolean;
+    showCardIcon?: boolean;
+    trailingIcon?: Component | string;
+    disabled?: boolean;
+    readonly?: boolean;
+}
+export interface CardInputEvents {
+    'update:modelValue': [value: string];
+    'update:cardNumber': [number: string];
+    'card-type-detected': [cardType: CardType];
+    input: [value: string];
+    focus: [event: FocusEvent];
+    blur: [event: FocusEvent];
+    'trailing-icon-click': [event: MouseEvent];
+}

package/dist/src/interfaces/reference.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @deprecated Use IReference from /utilities/common.interfaces.ts instead
+ */
+export interface Reference {
+    id: string;
+    title?: string;
+    name?: string;
+    description?: string;
+    url?: string;
+    type?: string;
+    path?: string;
+    metadata?: Record<string, unknown>;
+}
+export type { IReference } from './utilities';

package/dist/src/interfaces/services/ai.interfaces.d.ts

@@ -0,0 +1,56 @@
+/**
+ * AI Service Interfaces
+ * Interfaces for AI-related services and API interactions
+ */
+export interface IAITextRequest {
+    userQuestion: string;
+    textBoxContent?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface IAITextResponse {
+    success: boolean;
+    content?: string;
+    error?: string;
+    action?: 'replace' | 'complete' | 'chat';
+    hasChanges?: boolean;
+    changeTitle?: string;
+    changeDescription?: string;
+    improvedText?: string;
+    stats?: {
+        added: number;
+        removed: number;
+        modified?: number;
+    };
+}
+export interface IAIServiceConfig {
+    apiKey: string;
+    baseUrl?: string;
+    model?: string;
+    organization?: string;
+    timeout?: number;
+}
+export interface IAITextApiResponse {
+    success?: boolean;
+    content?: string;
+    output?: Array<{
+        content?: string | Array<{
+            text?: string;
+            type?: string;
+        }>;
+    }>;
+    error?: string | {
+        message?: string;
+        code?: string;
+    };
+    action?: 'replace' | 'complete' | 'chat';
+    hasChanges?: boolean;
+    changeTitle?: string;
+    changeDescription?: string;
+    improvedText?: string;
+    stats?: {
+        added: number;
+        removed: number;
+    };
+}

package/dist/src/interfaces/services/api.interfaces.d.ts

@@ -0,0 +1,46 @@
+/**
+ * API Service Interfaces
+ * Generic interfaces for API requests, responses, and error handling
+ */
+export interface IApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    message?: string;
+    error?: string;
+    code?: number;
+    timestamp?: string;
+}
+export interface IApiRequest {
+    [key: string]: unknown;
+}
+export interface IApiError {
+    message: string;
+    code?: string | number;
+    details?: Record<string, unknown>;
+    timestamp?: string;
+}
+export interface IApiConfig {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    retries?: number;
+    retryDelay?: number;
+}
+export interface IPaginatedResponse<T> extends IApiResponse<T[]> {
+    pagination?: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+export interface IPaginationParams {
+    page?: number;
+    limit?: number;
+    sort?: string;
+    order?: 'asc' | 'desc';
+    search?: string;
+    filters?: Record<string, unknown>;
+}

package/dist/src/interfaces/services/auth.interfaces.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Authentication Service Interfaces
+ * Interfaces for authentication, authorization, and user management
+ */
+export interface IUser {
+    id: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    role: string;
+    globalScopes: string[];
+    mfaEnabled: boolean;
+    avatar?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface IUserProfile extends IUser {
+    phone?: string;
+    timezone?: string;
+    language?: string;
+    preferences?: Record<string, unknown>;
+}
+export interface ILoginRequest {
+    email: string;
+    password: string;
+    rememberMe?: boolean;
+    deviceInfo?: IDeviceInformation;
+}
+export interface ILoginResponse {
+    success: boolean;
+    user?: IUser;
+    token?: string;
+    refreshToken?: string;
+    expiresIn?: number;
+    requiresMfa?: boolean;
+    mfaToken?: string;
+}
+export interface IRegisterRequest {
+    email: string;
+    password: string;
+    firstName: string;
+    lastName: string;
+    acceptTerms: boolean;
+}
+export interface IRegisterResponse {
+    success: boolean;
+    user?: IUser;
+    message?: string;
+    requiresVerification?: boolean;
+}
+export interface IVerifyLoginRequest {
+    token: string;
+    code: string;
+}
+export interface IEmailVerificationRequest {
+    email: string;
+    code: string;
+}
+export interface IEmailVerificationResponse {
+    success: boolean;
+    message?: string;
+}
+export interface IMfaQrResponse {
+    qrCode: string;
+    secret: string;
+    backupCodes: string[];
+}
+export interface IMfaVerifyRequest {
+    code: string;
+    token?: string;
+}
+export interface IMfaEnableRequest {
+    code: string;
+    secret: string;
+}
+export interface IMfaDisableRequest {
+    password: string;
+    code: string;
+}
+export interface IDeviceInformation {
+    userAgent: string;
+    platform: string;
+    deviceId?: string;
+    ipAddress?: string;
+}
+export interface IAuthToken {
+    token: string;
+    refreshToken?: string;
+    expiresIn: number;
+    tokenType: string;
+}
+export interface IAuthState {
+    isAuthenticated: boolean;
+    user: IUser | null;
+    token: string | null;
+    refreshToken: string | null;
+    loading: boolean;
+    error: string | null;
+}

package/dist/src/interfaces/services/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Service Interfaces
+ * Exports all service related interfaces
+ */
+export * from './ai.interfaces';
+export * from './api.interfaces';
+export * from './auth.interfaces';

package/dist/src/interfaces/skeleton-loader.interfaces.d.ts

@@ -0,0 +1 @@
+export type ISkeletonType = 'card' | 'paragraph' | 'table' | 'single-box' | 'single-paragraph';

package/dist/src/interfaces/slider.interfaces.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Slider Component Interfaces
+ * Defines TypeScript interfaces for the Slider component with comprehensive JSDoc
+ */
+/**
+ * Props interface for the Slider component
+ */
+export interface SliderProps {
+    /**
+     * The current value of the slider
+     * @default 0
+     */
+    modelValue: number;
+    /**
+     * The minimum value of the slider
+     * @default 0
+     */
+    min?: number;
+    /**
+     * The maximum value of the slider
+     * @default 100
+     */
+    max?: number;
+    /**
+     * The step increment for the slider
+     * @default 1
+     */
+    step?: number;
+    /**
+     * Optional label text displayed above the slider
+     */
+    label?: string;
+    /**
+     * Optional tooltip text for the help icon
+     */
+    tooltip?: string;
+    /**
+     * Placement of the tooltip relative to the trigger element
+     * @default 'top'
+     */
+    tooltipPlacement?: 'top' | 'bottom' | 'left' | 'right';
+    /**
+     * Optional hint text displayed below the slider
+     */
+    hint?: string;
+    /**
+     * Whether the slider is disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether to show the current value in the top right corner
+     * @default true
+     */
+    showValue?: boolean;
+    /**
+     * Whether to enable range mode (dual thumb selection)
+     * @default false
+     */
+    range?: boolean;
+    /**
+     * The range values for dual thumb mode [min, max]
+     * Only used when range is true
+     */
+    rangeValue?: [number, number];
+}
+/**
+ * Emits interface for the Slider component
+ */
+export interface SliderEmits {
+    /**
+     * Emitted when the slider value changes
+     * @param value - The new value
+     */
+    'update:modelValue': (value: number) => void;
+    /**
+     * Emitted when the range values change (only in range mode)
+     * @param range - The new range values [min, max]
+     */
+    'update:rangeValue': (range: [number, number]) => void;
+}

package/dist/src/interfaces/social-buttons.interfaces.d.ts

@@ -0,0 +1,115 @@
+import { Component } from 'vue';
+/**
+ * Social Buttons Component Interfaces
+ * Defines the props and types for the SocialButtons component
+ */
+export type SocialProvider = 'google' | 'facebook' | 'apple' | 'x' | 'figma' | 'dribbble';
+export type SocialButtonVariant = 'filled' | 'outlined' | 'ghost';
+export type SocialButtonSize = 'sm' | 'md' | 'lg';
+export type SocialButtonLayout = 'horizontal' | 'vertical';
+export interface SocialButtonProps {
+    /**
+     * Social media provider
+     */
+    provider: SocialProvider;
+    /**
+     * Visual variant of the button
+     * - filled: Brand background colors
+     * - outlined: White background with brand border
+     * - ghost: Transparent with muted colors
+     */
+    variant?: SocialButtonVariant;
+    /**
+     * Size of the button
+     * - sm: 32px height, 14px font
+     * - md: 40px height, 16px font
+     * - lg: 48px height, 18px font
+     */
+    size?: SocialButtonSize;
+    /**
+     * Whether the button is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Whether to show only the icon (square button)
+     */
+    iconOnly?: boolean;
+    /**
+     * Custom label text (overrides default provider label)
+     */
+    label?: string;
+    /**
+     * Custom CSS class for styling overrides
+     */
+    class?: string;
+    /**
+     * Custom CSS style for styling overrides
+     */
+    style?: string;
+}
+export interface SocialButtonGroupProps {
+    /**
+     * Array of social media providers to display
+     */
+    providers: SocialProvider[];
+    /**
+     * Visual variant for all buttons in the group
+     */
+    variant?: SocialButtonVariant;
+    /**
+     * Size for all buttons in the group
+     */
+    size?: SocialButtonSize;
+    /**
+     * Whether all buttons are disabled
+     */
+    disabled?: boolean;
+    /**
+     * Whether to show only icons (square buttons)
+     */
+    iconOnly?: boolean;
+    /**
+     * Layout orientation of the button group
+     */
+    layout?: SocialButtonLayout;
+    /**
+     * Custom CSS class for styling overrides
+     */
+    class?: string;
+    /**
+     * Custom CSS style for styling overrides
+     */
+    style?: string;
+}
+export interface SocialButtonEmits {
+    /**
+     * Emitted when a social button is clicked
+     * @param provider - The social media provider that was clicked
+     * @param event - The click event
+     */
+    click: [provider: SocialProvider, event: MouseEvent];
+}
+/**
+ * Provider configuration mapping
+ */
+export interface SocialProviderConfig {
+    icon: Component;
+    label: string;
+    colors: {
+        filled: {
+            background: string;
+            color: string;
+            border?: string;
+        };
+        outlined: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        ghost: {
+            background: string;
+            color: string;
+            border: string;
+        };
+    };
+}

package/dist/src/interfaces/switch-slot.interfaces.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Switch Slot Component Interfaces
+ * Defines TypeScript interfaces for the SwitchSlot component with comprehensive JSDoc
+ */
+/**
+ * Props interface for the SwitchSlot component
+ */
+export interface SwitchSlotProps {
+    /**
+     * The current state of the switch (on/off)
+     */
+    modelValue: boolean;
+    /**
+     * Optional label text displayed next to the switch
+     */
+    label?: string;
+    /**
+     * Optional tooltip text for the help icon
+     */
+    tooltip?: string;
+    /**
+     * Placement of the tooltip relative to the trigger element
+     * @default 'top'
+     */
+    tooltipPlacement?: 'top' | 'bottom' | 'left' | 'right';
+    /**
+     * Optional hint text displayed below the component
+     */
+    hint?: string;
+    /**
+     * Whether the switch is disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Visual variant of the component
+     * @default 'default'
+     */
+    variant?: 'default' | 'bordered';
+    /**
+     * Whether to show the slot content section
+     * @default false
+     */
+    showSlotContent?: boolean;
+}
+/**
+ * Emits interface for the SwitchSlot component
+ */
+export interface SwitchSlotEmits {
+    /**
+     * Emitted when the switch state changes
+     * @param value - The new switch state
+     */
+    (e: 'update:modelValue', value: boolean): void;
+}