valtech-components 2.0.691 → 2.0.692

package/lib/components/molecules/links-accordion/links-accordion.component.d.ts

@@ -0,0 +1,61 @@
+import { EventEmitter } from '@angular/core';
+import { Router } from '@angular/router';
+import { IonAccordionGroup, MenuController } from '@ionic/angular/standalone';
+import { LinksAccordionLink, LinksAccordionMetadata, LinksAccordionSection } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-links-accordion
+ *
+ * A hierarchical navigation component using Ionic accordions.
+ * Supports sections with optional sub-links and automatic menu closing.
+ *
+ * @example
+ * <val-links-accordion
+ *   [props]="{
+ *     sections: [
+ *       { title: 'Home', route: ['/'] },
+ *       { title: 'Products', links: [
+ *         { text: 'Catalog', route: ['/products'] },
+ *         { text: 'New Arrivals', route: ['/products', 'new'] }
+ *       ]}
+ *     ]
+ *   }"
+ *   (navigate)="onNavigate($event)"
+ * ></val-links-accordion>
+ *
+ * @input props - Accordion configuration
+ * @output navigate - Emits route when a link is clicked
+ */
+export declare class LinksAccordionComponent {
+    private router;
+    private menuCtrl;
+    private i18n;
+    /**
+     * Accordion configuration.
+     */
+    props: LinksAccordionMetadata;
+    /**
+     * Emits the route when a link is clicked.
+     */
+    navigate: EventEmitter<string[]>;
+    accordionGroup: IonAccordionGroup;
+    constructor(router: Router, menuCtrl: MenuController);
+    /**
+     * Gets a unique value for the accordion section.
+     */
+    getSectionValue(section: LinksAccordionSection, index: number): string;
+    /**
+     * Gets the section title, supporting i18n via titleKey.
+     */
+    getSectionTitle(section: LinksAccordionSection): string;
+    /**
+     * Gets the link text, supporting i18n via textKey.
+     */
+    getLinkText(link: LinksAccordionLink): string;
+    /**
+     * Handles link click - closes accordion/menu and navigates.
+     */
+    onLinkClick(route: string[], event?: Event): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LinksAccordionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LinksAccordionComponent, "val-links-accordion", never, { "props": { "alias": "props"; "required": false; }; }, { "navigate": "navigate"; }, never, never, true, never>;
+}

package/lib/components/molecules/links-accordion/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A link item within an accordion section.
+ */
+export interface LinksAccordionLink {
+    /** Display text for the link (static) */
+    text?: string;
+    /** i18n key for the link text (use with namespace in LinksAccordionMetadata) */
+    textKey?: string;
+    /** Route segments for navigation */
+    route: string[];
+}
+/**
+ * An accordion section with optional sub-links.
+ */
+export interface LinksAccordionSection {
+    /** Section title (static) */
+    title?: string;
+    /** i18n key for the section title (use with namespace in LinksAccordionMetadata) */
+    titleKey?: string;
+    /** Optional route if the section itself is clickable */
+    route?: string[];
+    /** Optional sub-links within this section */
+    links?: LinksAccordionLink[];
+}
+/**
+ * Configuration for the links accordion component.
+ */
+export interface LinksAccordionMetadata {
+    /** Array of accordion sections */
+    sections: LinksAccordionSection[];
+    /** Background color for the accordion. Default: 'var(--ion-background-color)' */
+    backgroundColor?: string;
+    /** Whether to close the menu when a link is clicked. Default: true */
+    closeMenuOnClick?: boolean;
+    /** Whether to close the accordion when navigating. Default: true */
+    closeAccordionOnClick?: boolean;
+    /** i18n namespace for translating titleKey and textKey values */
+    i18nNamespace?: string;
+}

package/lib/components/molecules/links-cake/links-cake.component.d.ts

@@ -0,0 +1,17 @@
+import { OnInit } from '@angular/core';
+import { LinkCakeMetadata } from './types';
+import * as i0 from "@angular/core";
+export declare class LinksCakeComponent implements OnInit {
+    /**
+     * Links cake configuration object.
+     * @type {LinkCakeMetadata}
+     * @property title - The title for the links section (optional).
+     * @property links - Array of link configurations.
+     * @property size - The size of the title and links.
+     */
+    props: LinkCakeMetadata;
+    constructor();
+    ngOnInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LinksCakeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LinksCakeComponent, "val-links-cake", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/molecules/links-cake/types.d.ts

@@ -0,0 +1,13 @@
+import { HrefMetadata } from '../../atoms/href/types';
+/**
+ * Props for val-links-cake component.
+ *
+ * @property title - The title for the links section (optional).
+ * @property links - Array of link configurations.
+ * @property size - The size of the title and links ('small' | 'medium' | 'large').
+ */
+export interface LinkCakeMetadata {
+    title: string;
+    links: HrefMetadata[];
+    size: 'small' | 'medium' | 'large';
+}

package/lib/components/molecules/multi-select-search/multi-select-search.component.d.ts

@@ -0,0 +1,76 @@
+import { OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import { IonModal } from '@ionic/angular';
+import { IconService } from '../../../services/icons.service';
+import { InputMetadata, InputOption } from '../../types';
+import * as i0 from "@angular/core";
+export declare class MultiSelectSearchComponent implements OnChanges, OnDestroy {
+    modal: IonModal;
+    label: string;
+    labelProperty: string;
+    valueProperty: string;
+    placeholder: string;
+    props: InputMetadata;
+    icon: IconService;
+    private changeDetector;
+    private i18n;
+    /** Get resolved label with i18n fallback */
+    getLabel(): string;
+    /** Get resolved placeholder with i18n fallback */
+    getPlaceholder(): string;
+    /** Get close button text */
+    getCloseText(): string;
+    /** Get no results text */
+    getNoResultsText(): string;
+    /** Get select all text */
+    getSelectAllText(): string;
+    /** Get clear text */
+    getClearText(): string;
+    /** Get apply text */
+    getApplyText(): string;
+    /** Get items selected text */
+    getItemsSelectedText(count: number): string;
+    searchTerm: string;
+    filteredItems: InputOption[];
+    selectedItems: InputOption[];
+    displayValue: string;
+    private previousOptions;
+    private isProcessingChanges;
+    private valueChangesSubscription?;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ionViewWillEnter(): void;
+    private subscribeToValueChanges;
+    private areOptionsEqual;
+    private initializeItems;
+    private syncControlValueWithSelectedItems;
+    private applyDefaultValue;
+    onFilter(event: any): void;
+    onFocus(): void;
+    onBlur(): void;
+    openModal(): void;
+    preventDefaultBehavior(event: MouseEvent): void;
+    /**
+     * Reset state only - called by didDismiss event
+     * Separated from closeModal to avoid double dismissal and scroll issues
+     */
+    resetState(): void;
+    /**
+     * Close modal only - does not reset state (didDismiss will handle that)
+     */
+    closeModal(): void;
+    /**
+     * @deprecated Use closeModal() instead. Kept for backwards compatibility.
+     */
+    cancelModal(): void;
+    selectItem(item: any): void;
+    selectAll(): void;
+    clearAll(): void;
+    isItemSelected(item: any): boolean;
+    updateDisplayValue(): void;
+    applyChanges(): void;
+    applyAndClose(): void;
+    reset(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MultiSelectSearchComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MultiSelectSearchComponent, "val-multi-select-search", never, { "label": { "alias": "label"; "required": false; }; "labelProperty": { "alias": "labelProperty"; "required": false; }; "valueProperty": { "alias": "valueProperty"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/molecules/notes-box/notes-box.component.d.ts

@@ -0,0 +1,21 @@
+import { OnInit } from '@angular/core';
+import { NotesBoxMetadata } from './types';
+import * as i0 from "@angular/core";
+export declare class NotesBoxComponent implements OnInit {
+    /**
+     * Notes box configuration object.
+     * @type {NotesBoxMetadata}
+     * @property text - The main text content.
+     * @property prefix - Optional prefix text (bold).
+     * @property color - The background color of the box.
+     * @property textColor - The color of the text.
+     * @property size - The size of the text and box.
+     * @property rounded - Whether the box has rounded corners.
+     * @property padding - Custom padding for the box.
+     */
+    props: NotesBoxMetadata;
+    constructor();
+    ngOnInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotesBoxComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NotesBoxComponent, "val-notes-box", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/molecules/notes-box/types.d.ts

@@ -0,0 +1,21 @@
+import { Color } from '@ionic/core';
+/**
+ * Props for val-notes-box component.
+ *
+ * @property color - The background color of the box.
+ * @property textColor - The color of the text.
+ * @property prefix - Optional prefix text (bold).
+ * @property text - The main text content.
+ * @property size - The size of the text and box ('small' | 'medium' | 'large' | 'xlarge').
+ * @property rounded - Whether the box has rounded corners.
+ * @property padding - Custom padding for the box (optional).
+ */
+export interface NotesBoxMetadata {
+    color: Color;
+    textColor: Color;
+    prefix: string;
+    text: string;
+    size: 'small' | 'medium' | 'large' | 'xlarge';
+    rounded: boolean;
+    padding?: string;
+}

package/lib/components/molecules/number-from-to/number-from-to.component.d.ts

@@ -0,0 +1,27 @@
+import { OnInit } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { NumberFromToMetadata } from './types';
+import * as i0 from "@angular/core";
+export declare class NumberFromToComponent implements OnInit {
+    /**
+     * Input configuration object.
+     * @type {NumberFromToMetadata}
+     * @property fromControl - The Angular FormControl for the "from" value.
+     * @property toControl - The Angular FormControl for the "to" value.
+     */
+    props: NumberFromToMetadata;
+    private i18n;
+    /** Get from label with i18n fallback */
+    getFromLabel(): string;
+    /** Get to label with i18n fallback */
+    getToLabel(): string;
+    constructor();
+    ngOnInit(): void;
+    private applyDefaultValues;
+    private resolveDefaultValue;
+    private parseValue;
+    get fromControl(): FormControl;
+    get toControl(): FormControl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NumberFromToComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NumberFromToComponent, "val-number-from-to", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/molecules/number-from-to/types.d.ts

@@ -0,0 +1,76 @@
+import { FormControl } from '@angular/forms';
+import { Color } from '@ionic/core';
+import { ComponentState } from '../../types';
+/**
+ * Number range value with from and to.
+ */
+export interface NumberFromToValue {
+    /** Starting value */
+    from: number | null;
+    /** Ending value */
+    to: number | null;
+}
+/**
+ * Metadata for the number from-to input component.
+ */
+export interface NumberFromToMetadata {
+    /** Main form control (optional, stores combined value) */
+    control?: FormControl<NumberFromToValue | null>;
+    /** Form control for "from" value (required for standalone use) */
+    fromControl?: FormControl<number | null>;
+    /** Form control for "to" value (required for standalone use) */
+    toControl?: FormControl<number | null>;
+    /** Unique token for the input */
+    token?: string;
+    /** Display label */
+    label?: string;
+    /** Field name */
+    name?: string;
+    /** Help text */
+    hint?: string;
+    /** Field state */
+    state?: ComponentState;
+    /** Label for "from" field */
+    fromLabel?: string;
+    /** Label for "to" field */
+    toLabel?: string;
+    /** Placeholder for main input */
+    placeholder?: string;
+    /** Placeholder for "from" field */
+    fromPlaceholder?: string;
+    /** Placeholder for "to" field */
+    toPlaceholder?: string;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step increment */
+    step?: number;
+    /** Component color */
+    color?: Color;
+    /** Custom CSS class */
+    cssClass?: string;
+    /** Initial value for the field */
+    value?: string;
+    /** Default value configuration - string for custom defaults, true for auto defaults */
+    withDefault?: string | boolean;
+    /** Content key for reactive label */
+    contentKey?: string;
+    /** Component class name for content lookup */
+    contentClass?: string;
+    /** Fallback text if content key is not found */
+    contentFallback?: string;
+    /** Custom error messages */
+    errors?: Record<string, string>;
+    /** Show validation errors */
+    showErrors?: boolean;
+}
+/**
+ * Event emitted when number range changes.
+ */
+export interface NumberFromToChangeEvent {
+    /** Number range value */
+    value: NumberFromToValue;
+    /** Whether the range is valid (from <= to) */
+    isValid: boolean;
+}

package/lib/components/molecules/number-input/number-input.component.d.ts

@@ -0,0 +1,16 @@
+import { OnInit } from '@angular/core';
+import { InputMetadata } from '../../types';
+import * as i0 from "@angular/core";
+export declare class NumberInputComponent implements OnInit {
+    /**
+     * Input configuration object.
+     * @type {InputMetadata}
+     * @property control - The Angular FormControl for the input.
+     * @property placeholder - The placeholder text.
+     */
+    props: InputMetadata;
+    constructor();
+    ngOnInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NumberInputComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NumberInputComponent, "val-number-input", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/molecules/number-stepper/number-stepper.component.d.ts

@@ -0,0 +1,38 @@
+import { EventEmitter, OnInit, OnDestroy } from '@angular/core';
+import { NumberStepperMetadata, NumberStepperChangeEvent } from './types';
+import * as i0 from "@angular/core";
+export declare class NumberStepperComponent implements OnInit, OnDestroy {
+    props: NumberStepperMetadata;
+    valueChange: EventEmitter<NumberStepperChangeEvent>;
+    states: {
+        ENABLED: "ENABLED";
+        DISABLED: "DISABLED";
+        WORKING: "WORKING";
+        ERROR: "ERROR";
+    };
+    private i18n;
+    private valueSubscription;
+    /** Get decrement button aria-label with i18n fallback */
+    getDecrementLabel(): string;
+    /** Get increment button aria-label with i18n fallback */
+    getIncrementLabel(): string;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    get currentValue(): number;
+    get isAtMin(): boolean;
+    get isAtMax(): boolean;
+    get totalPrice(): number;
+    increment(): void;
+    decrement(): void;
+    setValue(value: number): void;
+    onInputBlur(): void;
+    private clampValue;
+    private clamp;
+    private emitChange;
+    getLabel(): string;
+    getUnitLabel(): string;
+    formatPrice(amount: number): string;
+    getColor(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NumberStepperComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NumberStepperComponent, "val-number-stepper", never, { "props": { "alias": "props"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}

package/lib/components/molecules/number-stepper/types.d.ts

@@ -0,0 +1,88 @@
+import { FormControl } from '@angular/forms';
+import { Color } from '@ionic/core';
+import { ComponentState } from '../../types';
+/**
+ * Quick selection preset for number stepper.
+ */
+export interface NumberStepperPreset {
+    /** Preset value */
+    value: number;
+    /** Display label (optional, defaults to value) */
+    label?: string;
+    /** Whether this is a popular/highlighted option */
+    popular?: boolean;
+}
+/**
+ * Metadata for the number stepper component.
+ */
+export interface NumberStepperMetadata {
+    /** Form control for the value */
+    control: FormControl<number>;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step increment */
+    step?: number;
+    /** Show manual input field */
+    showInput?: boolean;
+    /** Allow manual input editing */
+    editableInput?: boolean;
+    /** Unit price for total calculation */
+    unitPrice?: number;
+    /** Currency code for price display */
+    currency?: string;
+    /** Currency symbol */
+    currencySymbol?: string;
+    /** Show total price */
+    showTotal?: boolean;
+    /** Unit label (e.g., "boletos", "tickets") */
+    unitLabel?: string;
+    /** Singular unit label */
+    unitLabelSingular?: string;
+    /** Preset values for quick selection */
+    presets?: NumberStepperPreset[];
+    /** Show preset buttons */
+    showPresets?: boolean;
+    /** Component color */
+    color?: Color;
+    /** Size variant */
+    size?: 'small' | 'medium' | 'large';
+    /** Button shape */
+    buttonShape?: 'square' | 'round';
+    /** Layout direction */
+    layout?: 'horizontal' | 'vertical';
+    /** Custom CSS class */
+    cssClass?: string;
+    /** Component state */
+    state?: ComponentState;
+    /** Label for the component */
+    label?: string;
+    /** Hint text */
+    hint?: string;
+    /** Decrement button aria label */
+    decrementLabel?: string;
+    /** Increment button aria label */
+    incrementLabel?: string;
+    /** Content key for label */
+    labelContentKey?: string;
+    /** Content key for unit label */
+    unitLabelContentKey?: string;
+    /** Content class for reactive content */
+    contentClass?: string;
+}
+/**
+ * Event emitted when value changes.
+ */
+export interface NumberStepperChangeEvent {
+    /** New value */
+    value: number;
+    /** Previous value */
+    previousValue: number;
+    /** Total price (if unitPrice is set) */
+    totalPrice?: number;
+    /** Whether at minimum */
+    atMin: boolean;
+    /** Whether at maximum */
+    atMax: boolean;
+}

package/lib/components/molecules/pagination/pagination.component.d.ts

@@ -0,0 +1,15 @@
+import { OnChanges, EventEmitter, SimpleChanges } from '@angular/core';
+import { PaginationMetadata, PageChangeEvent } from './types';
+import * as i0 from "@angular/core";
+export declare class PaginationComponent implements OnChanges {
+    props: PaginationMetadata;
+    pageChange: EventEmitter<PageChangeEvent>;
+    visiblePages: number[];
+    totalPages: number;
+    ngOnChanges(changes: SimpleChanges): void;
+    goToPage(page: number): void;
+    private calculateTotalPages;
+    private calculateVisiblePages;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PaginationComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PaginationComponent, "val-pagination", never, { "props": { "alias": "props"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+}

package/lib/components/molecules/pagination/types.d.ts

@@ -0,0 +1,41 @@
+import { Color } from '@ionic/core';
+/**
+ * Metadata for the pagination component.
+ */
+export interface PaginationMetadata {
+    /** Current page number (1-based) */
+    currentPage: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** Items per page */
+    pageSize?: number;
+    /** Total number of items (alternative to totalPages) */
+    totalItems?: number;
+    /** Maximum visible page buttons */
+    maxVisiblePages?: number;
+    /** Show first/last page buttons */
+    showFirstLast?: boolean;
+    /** Show previous/next buttons */
+    showPrevNext?: boolean;
+    /** Pagination color */
+    color?: Color;
+    /** Size variant */
+    size?: 'small' | 'default' | 'large';
+    /** Disable pagination */
+    disabled?: boolean;
+    /** Show page info text (e.g., "Page 1 of 10") */
+    showPageInfo?: boolean;
+    /** Unique token identifier */
+    token?: string;
+}
+/**
+ * Event emitted when page changes.
+ */
+export interface PageChangeEvent {
+    /** New page number */
+    page: number;
+    /** Previous page number */
+    previousPage: number;
+    /** Page size */
+    pageSize: number;
+}

package/lib/components/molecules/participant-card/participant-card.component.d.ts

@@ -0,0 +1,34 @@
+import { EventEmitter } from '@angular/core';
+import { ParticipantCardMetadata, ParticipantCardClickEvent, ParticipantCardActionEvent, ParticipantTicket } from './types';
+import * as i0 from "@angular/core";
+export declare class ParticipantCardComponent {
+    props: ParticipantCardMetadata;
+    cardClick: EventEmitter<ParticipantCardClickEvent>;
+    actionClick: EventEmitter<ParticipantCardActionEvent>;
+    private i18n;
+    showAllTickets: boolean;
+    /** Get winner badge text */
+    getWinnerText(): string;
+    /** Get tickets count text */
+    getTicketsCountText(count: number): string;
+    /** Get more tickets text */
+    getMoreText(count: number): string;
+    /** Get notes label */
+    getNotesLabel(): string;
+    get ticketNumbers(): (number | ParticipantTicket)[];
+    get visibleTickets(): (number | ParticipantTicket)[];
+    get hiddenTicketsCount(): number;
+    formatTicketNumber(ticket: number | ParticipantTicket): string;
+    getTicketColor(ticket: number | ParticipantTicket): string;
+    isWinnerTicket(ticket: number | ParticipantTicket): boolean;
+    getPaymentStatusLabel(): string;
+    getPaymentStatusColor(): string;
+    getPaymentStatusIcon(): string;
+    formatCurrency(amount: number): string;
+    formatDate(date: Date | string): string;
+    toggleShowAllTickets(event: Event): void;
+    onCardClick(): void;
+    onActionsClick(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ParticipantCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ParticipantCardComponent, "val-participant-card", never, { "props": { "alias": "props"; "required": false; }; }, { "cardClick": "cardClick"; "actionClick": "actionClick"; }, never, never, true, never>;
+}