valtech-components 2.0.819 → 2.0.821

package/lib/components/organisms/bottom-nav/types.d.ts

@@ -1,120 +0,0 @@
-import { Color } from '@ionic/core';
-/**
- * Badge configuration for a nav item
- */
-export interface BottomNavBadge {
-    /** Badge text (e.g., "3", "NEW") */
-    text?: string;
-    /** Badge color */
-    color?: Color | string;
-    /** Badge background color */
-    backgroundColor?: Color | string;
-    /** Show as dot only (no text) */
-    dot?: boolean;
-}
-/**
- * Icon configuration - supports multiple icon sources
- */
-export interface BottomNavIcon {
-    /** Ionicon name for inactive state (e.g., 'home-outline') */
-    default: string;
-    /** Ionicon name for active state (e.g., 'home') - defaults to default if not provided */
-    active?: string;
-}
-/**
- * Configuration for a single nav tab item
- */
-export interface BottomNavTab {
-    /** Unique identifier for the tab */
-    token: string;
-    /** Icon configuration */
-    icon: BottomNavIcon;
-    /** Static label text */
-    label?: string;
-    /** i18n key for label */
-    labelKey?: string;
-    /** Route to navigate to (supports string or array format) */
-    route: string | string[];
-    /** Routes that should also mark this tab as active (for nested routes) */
-    activeRoutes?: string[];
-    /** Badge configuration */
-    badge?: BottomNavBadge;
-    /** Whether the tab is disabled */
-    disabled?: boolean;
-    /** Aria label for accessibility */
-    ariaLabel?: string;
-}
-/**
- * Configuration for the central FAB button (optional)
- */
-export interface BottomNavFab {
-    /** Icon name */
-    icon: string;
-    /** FAB color */
-    color?: Color | string;
-    /** FAB size */
-    size?: 'small' | 'default';
-    /** Route to navigate to (if navigation action) */
-    route?: string | string[];
-    /** Whether this is an action (emits event) or navigation */
-    isAction?: boolean;
-    /** Aria label for accessibility */
-    ariaLabel?: string;
-}
-/**
- * Theme configuration for bottom nav
- */
-export interface BottomNavTheme {
-    /** Background color (CSS variable or color value) */
-    background?: string;
-    /** Active tab color */
-    activeColor?: Color | string;
-    /** Inactive tab color */
-    inactiveColor?: Color | string;
-    /** Border radius for the nav bar */
-    borderRadius?: string;
-    /** Whether to show a top border/shadow */
-    elevated?: boolean;
-    /** Blur effect for translucent background */
-    translucent?: boolean;
-    /** Floating island style - detached from edges with rounded corners */
-    floating?: boolean;
-}
-/**
- * Click event emitted by bottom nav
- */
-export interface BottomNavClickEvent {
-    /** Token of the clicked item */
-    token: string;
-    /** Whether it's the FAB button */
-    isFab: boolean;
-    /** The route if navigation occurred */
-    route?: string | string[];
-}
-/**
- * Main metadata for val-bottom-nav component
- */
-export interface BottomNavMetadata {
-    /** Array of tab configurations */
-    tabs: BottomNavTab[];
-    /** Central FAB button configuration (optional) */
-    fab?: BottomNavFab;
-    /** i18n namespace for labels */
-    i18nNamespace?: string;
-    /** Theme configuration */
-    theme?: BottomNavTheme;
-    /** Hide labels (icon-only mode) */
-    hideLabels?: boolean;
-    /** Safe area padding for iOS notch */
-    safeArea?: boolean;
-    /** Animation style */
-    animation?: 'fade' | 'scale' | 'slide' | 'none';
-    /** Cap del ancho de la barra. Token sm|md|lg|xl|full o valor CSS crudo. Default: 'md' (720px) — bottom-nav típicamente tiene pocos tabs y se ve mejor estrecho aunque el contenido use 'xl' */
-    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'full' | string;
-}
-/**
- * Default values for BottomNavMetadata
- */
-export declare const BOTTOM_NAV_DEFAULTS: Required<Pick<BottomNavMetadata, 'hideLabels' | 'safeArea' | 'animation' | 'maxWidth'>> & {
-    theme: Required<BottomNavTheme>;
-};

package/lib/components/organisms/cards-carousel/cards-carousel.component.d.ts

@@ -1,36 +0,0 @@
-import { CardsCarouselMetadata, CarouselCardShape } from './types';
-import * as i0 from "@angular/core";
-/**
- * val-cards-carousel
- *
- * A horizontal carousel of cards with optional action header.
- * Combines HorizontalScroll for smooth horizontal scrolling with inline
- * card rendering for consistent card styling.
- *
- * @example
- * <val-cards-carousel
- *   [props]="{
- *     header: { title: 'Featured Items', actionType: 'link', actionLabel: 'View All' },
- *     cards: [
- *       { title: { title: 'Card 1' }, link: { text: 'Learn more', url: '/item/1' } },
- *       { title: { title: 'Card 2' }, link: { text: 'Learn more', url: '/item/2' } }
- *     ]
- *   }"
- * ></val-cards-carousel>
- *
- * @input props - Carousel configuration with cards and optional header
- */
-export declare class CardsCarouselComponent {
-    /**
-     * Carousel configuration with cards and optional header.
-     */
-    props: CardsCarouselMetadata;
-    /**
-     * Merges shape color with additional styles.
-     */
-    mergeShapeStyle(shape: CarouselCardShape): {
-        [key: string]: string | number;
-    };
-    static ɵfac: i0.ɵɵFactoryDeclaration<CardsCarouselComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CardsCarouselComponent, "val-cards-carousel", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
-}

package/lib/components/organisms/cards-carousel/types.d.ts

@@ -1,40 +0,0 @@
-import { ActionHeaderMetadata } from '../../molecules/action-header/types';
-import { LinkMetadata } from '../../molecules/link/types';
-import { TitleBlockMetada } from '../../molecules/title-block/types';
-/**
- * Configuration for a decorative shape within a carousel card.
- */
-export interface CarouselCardShape {
-    /** Background color of the shape */
-    color: string;
-    /** Additional CSS styles (position, size, etc.) */
-    style?: {
-        [key: string]: string | number;
-    };
-}
-/**
- * Configuration for a single card inside the carousel.
- */
-export interface CarouselCardMetadata {
-    /** Title block configuration */
-    title: TitleBlockMetada;
-    /** Link configuration */
-    link: LinkMetadata;
-    /** Decorative shapes to display behind content */
-    shapes?: CarouselCardShape[];
-    /** Background color of the card (Ionic color) */
-    color?: string;
-    /** Minimum height of the card. Default: '400px' */
-    minHeight?: string;
-    /** Width of the card. Default: '280px' */
-    width?: string;
-}
-/**
- * Configuration for the cards carousel component.
- */
-export interface CardsCarouselMetadata {
-    /** Array of cards to display */
-    cards: CarouselCardMetadata[];
-    /** Optional action header configuration */
-    header?: ActionHeaderMetadata;
-}

package/lib/components/organisms/comment-section/comment-section.component.d.ts

@@ -1,50 +0,0 @@
-import { EventEmitter, OnInit } from '@angular/core';
-import { CommentSectionMetadata, CommentSortOption, CommentSortChangeEvent, CommentSubmitEvent, CommentSectionLoadMoreEvent } from './types';
-import { CommentAuthorClickEvent, CommentReactionClickEvent, CommentActionClickEvent, CommentMenuItemClickEvent, CommentLoadMoreEvent } from '../../molecules/comment/types';
-import * as i0 from "@angular/core";
-export declare class CommentSectionComponent implements OnInit {
-    private i18n;
-    props: CommentSectionMetadata;
-    sortChange: EventEmitter<CommentSortChangeEvent>;
-    commentSubmit: EventEmitter<CommentSubmitEvent>;
-    loadMore: EventEmitter<CommentSectionLoadMoreEvent>;
-    authorClick: EventEmitter<CommentAuthorClickEvent>;
-    reactionClick: EventEmitter<CommentReactionClickEvent>;
-    actionClick: EventEmitter<CommentActionClickEvent>;
-    menuItemClick: EventEmitter<CommentMenuItemClickEvent>;
-    commentLoadMore: EventEmitter<CommentLoadMoreEvent>;
-    collapseToggle: EventEmitter<{
-        token: string;
-        collapsed: boolean;
-    }>;
-    replyStart: EventEmitter<{
-        commentToken: string;
-    }>;
-    newCommentText: string;
-    replyingTo: string | null;
-    displayTitle: string;
-    displayLoadMoreLabel: string;
-    ngOnInit(): void;
-    private updateDisplayTexts;
-    getSortByLabel(): string;
-    formatCount(count: number): string;
-    getSortOptionLabel(option: CommentSortOption): string;
-    getInputPlaceholder(): string;
-    getSubmitLabel(): string;
-    getEmptyTitle(): string;
-    getEmptyMessage(): string;
-    getSkeletonArray(): number[];
-    canSubmit(): boolean;
-    isNearLimit(): boolean;
-    onSortChange(event: CustomEvent): void;
-    onSubmitComment(): void;
-    onCommentAction(event: CommentActionClickEvent): void;
-    onLoadMore(): void;
-    onInfiniteScroll(event: CustomEvent): void;
-    completeInfiniteScroll(): void;
-    private infiniteScrollEvent;
-    startReply(commentToken: string): void;
-    cancelReply(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CommentSectionComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CommentSectionComponent, "val-comment-section", never, { "props": { "alias": "props"; "required": false; }; }, { "sortChange": "sortChange"; "commentSubmit": "commentSubmit"; "loadMore": "loadMore"; "authorClick": "authorClick"; "reactionClick": "reactionClick"; "actionClick": "actionClick"; "menuItemClick": "menuItemClick"; "commentLoadMore": "commentLoadMore"; "collapseToggle": "collapseToggle"; "replyStart": "replyStart"; }, never, never, true, never>;
-}

package/lib/components/organisms/comment-section/types.d.ts

@@ -1,144 +0,0 @@
-import { Color } from '@ionic/core';
-import { CommentMetadata, CommentAuthor } from '../../molecules/comment/types';
-/**
- * Sort/filter option for comments.
- * The actual sorting logic is handled by the parent component.
- */
-export interface CommentSortOption {
-    /** Unique identifier */
-    token: string;
-    /** Display label */
-    label: string;
-    /** Optional icon */
-    icon?: string;
-    /** Reactive content key */
-    contentKey?: string;
-    /** Component class for content lookup */
-    contentClass?: string;
-    /** Fallback label */
-    contentFallback?: string;
-}
-/**
- * Configuration for the new comment input area.
- */
-export interface CommentInputConfig {
-    /** Input placeholder text */
-    placeholder?: string;
-    /** Submit button label */
-    submitLabel?: string;
-    /** Current user info (for avatar display) */
-    currentUser?: CommentAuthor;
-    /** Maximum character length */
-    maxLength?: number;
-    /** Minimum character length to enable submit */
-    minLength?: number;
-    /** Whether input is disabled */
-    disabled?: boolean;
-    /** Submit button color */
-    submitColor?: Color;
-    /** Show character counter */
-    showCounter?: boolean;
-    /** Reactive content keys */
-    placeholderContentKey?: string;
-    submitLabelContentKey?: string;
-    contentClass?: string;
-}
-/**
- * Empty state configuration when no comments exist.
- */
-export interface CommentEmptyState {
-    /** Empty state title */
-    title?: string;
-    /** Empty state message */
-    message?: string;
-    /** Empty state icon */
-    icon?: string;
-    /** Reactive content keys */
-    titleContentKey?: string;
-    messageContentKey?: string;
-    contentClass?: string;
-}
-/**
- * Main metadata for comment-section organism.
- */
-export interface CommentSectionMetadata {
-    /** Unique section identifier */
-    token?: string;
-    /** Section title (e.g., "Comments", "Reviews") */
-    title?: string;
-    /** Total comment count (may differ from comments.length if paginated) */
-    count?: number;
-    /** Whether to show the count badge */
-    showCount?: boolean;
-    /** Available sort options */
-    sortOptions?: CommentSortOption[];
-    /** Currently selected sort option token */
-    selectedSort?: string;
-    /** Sort dropdown label */
-    sortLabel?: string;
-    /** Array of comments to display */
-    comments: CommentMetadata[];
-    /** Whether to show the new comment input */
-    showInput?: boolean;
-    /** Input configuration */
-    inputConfig?: CommentInputConfig;
-    /** Initial loading state */
-    loading?: boolean;
-    /** Loading more comments */
-    loadingMore?: boolean;
-    /** Number of skeleton items to show when loading */
-    skeletonCount?: number;
-    /** Whether there are more comments to load */
-    hasMore?: boolean;
-    /** Load more button label */
-    loadMoreLabel?: string;
-    /** Pagination mode: 'button' (default) or 'infinite' */
-    paginationMode?: 'button' | 'infinite';
-    /** Infinite scroll threshold (e.g., '100px', '15%') */
-    infiniteScrollThreshold?: string;
-    /** Infinite scroll position */
-    infiniteScrollPosition?: 'top' | 'bottom';
-    /** Empty state configuration */
-    emptyState?: CommentEmptyState;
-    /** Section color theme */
-    color?: Color;
-    /** Whether to show dividers between comments */
-    showDividers?: boolean;
-    /** Reactive content key for title */
-    titleContentKey?: string;
-    /** Component class for content lookup */
-    contentClass?: string;
-    /** Fallback title */
-    titleContentFallback?: string;
-    /** Reactive content key for load more label */
-    loadMoreContentKey?: string;
-}
-/**
- * Event emitted when sort option changes.
- */
-export interface CommentSortChangeEvent {
-    /** Selected sort option */
-    option: CommentSortOption;
-    /** Previous sort option token */
-    previousSort?: string;
-}
-/**
- * Event emitted when a new comment is submitted.
- */
-export interface CommentSubmitEvent {
-    /** Comment text content */
-    content: string;
-    /** Parent comment token (if replying) */
-    parentToken?: string;
-    /** Section token */
-    sectionToken?: string;
-}
-/**
- * Event emitted when load more is clicked.
- */
-export interface CommentSectionLoadMoreEvent {
-    /** Section token */
-    sectionToken?: string;
-    /** Current loaded count */
-    currentCount: number;
-}

package/lib/components/organisms/company-footer/company-footer.component.d.ts

@@ -1,37 +0,0 @@
-import { CompanyFooterMetadata } from './types';
-import * as i0 from "@angular/core";
-/**
- * val-company-footer
- *
- * A complete footer component combining footer links (with logo and social icons)
- * and a rights/copyright footer. Configurable padding and background options.
- *
- * @example
- * <val-company-footer
- *   [props]="{
- *     links: {
- *       leftLinks: { title: 'Company', size: 'medium', links: [...] },
- *       rightLinks: { title: 'Support', size: 'medium', links: [...] },
- *       logo: '/assets/logo.png',
- *       socialLinks: [...]
- *     },
- *     rights: { companyName: 'Acme Inc' },
- *     withPadding: true
- *   }"
- * ></val-company-footer>
- *
- * @input props - Footer configuration
- */
-export declare class CompanyFooterComponent {
-    /**
-     * Footer configuration.
-     * Signal-based input for full reactivity with computed().
-     */
-    readonly props: import("@angular/core").InputSignal<CompanyFooterMetadata>;
-    propsWithPadding: import("@angular/core").Signal<boolean>;
-    propsWithBackground: import("@angular/core").Signal<boolean>;
-    propsLinks: import("@angular/core").Signal<import("valtech-components").FooterLinksMetadata>;
-    propsRights: import("@angular/core").Signal<import("valtech-components").RightsFooterMetadata>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CompanyFooterComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CompanyFooterComponent, "val-company-footer", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}

package/lib/components/organisms/company-footer/types.d.ts

@@ -1,15 +0,0 @@
-import { FooterLinksMetadata } from '../../molecules/footer-links/types';
-import { RightsFooterMetadata } from '../../atoms/rights-footer/types';
-/**
- * Configuration for the company footer component.
- */
-export interface CompanyFooterMetadata {
-    /** Footer links configuration */
-    links: FooterLinksMetadata;
-    /** Rights footer configuration */
-    rights?: RightsFooterMetadata;
-    /** Add padding around the footer */
-    withPadding?: boolean;
-    /** Add background color to the footer */
-    withBackground?: boolean;
-}

package/lib/components/organisms/cookie-banner/cookie-banner.component.d.ts

@@ -1,36 +0,0 @@
-import { EventEmitter } from '@angular/core';
-import { CookieBannerMetadata } from './types';
-import * as i0 from "@angular/core";
-/**
- * `val-cookie-banner` — bottom/top fixed banner asking the user to choose
- * a cookie consent option. Presentational only: emits events on each
- * action, the parent decides what to do (typically wiring to
- * `AnalyticsService` from `valtech-components`).
- *
- * @example
- * <val-cookie-banner
- *   [props]="bannerProps()"
- *   (accept)="onAccept()"
- *   (reject)="onReject()"
- *   (customize)="onCustomize()"
- *   (dismiss)="onDismiss()"
- * />
- *
- * Wire `props.visible` to `analytics.consentState().hasDecided === false`
- * so the banner auto-hides once the user makes a choice.
- */
-export declare class CookieBannerComponent {
-    /** Banner configuration object. */
-    props: CookieBannerMetadata;
-    /** Fired when the user clicks the primary "accept" button. */
-    accept: EventEmitter<void>;
-    /** Fired when the user clicks the secondary "reject" button. */
-    reject: EventEmitter<void>;
-    /** Fired when the user clicks the tertiary "customize/configure" button. */
-    customize: EventEmitter<void>;
-    /** Fired when the user clicks the dismiss (X) icon. */
-    dismiss: EventEmitter<void>;
-    constructor();
-    static ɵfac: i0.ɵɵFactoryDeclaration<CookieBannerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CookieBannerComponent, "val-cookie-banner", never, { "props": { "alias": "props"; "required": false; }; }, { "accept": "accept"; "reject": "reject"; "customize": "customize"; "dismiss": "dismiss"; }, never, never, true, never>;
-}

package/lib/components/organisms/cookie-banner/types.d.ts

@@ -1,62 +0,0 @@
-import { Color } from '@ionic/core';
-/** Position of the banner relative to the viewport. */
-export type CookieBannerPosition = 'bottom' | 'top';
-/**
- * Configuration for `val-cookie-banner`.
- *
- * The banner is purely presentational: it shows configurable text and
- * up to three action buttons. It does NOT couple to any consent service —
- * the parent decides what to do on each event (accept/reject/customize).
- *
- * Typical wiring (with `AnalyticsService` from valtech-components):
- *   - `accept`   → `analytics.grantAllConsent()`
- *   - `reject`   → `analytics.denyAllConsent()`
- *   - `customize` → `router.navigate(['/cookies'])`
- *
- * Visibility is controlled by the parent via `[visible]` — typically
- * tied to `analytics.consentState().hasDecided === false`.
- */
-export interface CookieBannerMetadata {
-    /** Whether the banner is shown. Parent toggles based on `hasDecided`. */
-    visible: boolean;
-    /** Where the banner anchors. Default `'bottom'`. */
-    position?: CookieBannerPosition;
-    /** Short title above the message (optional). */
-    title?: string;
-    /**
-     * Main message shown to the user. Plain text — newlines respected.
-     * For inline links, use `policyHref` + `policyLinkText` so the link
-     * renders consistently after the message.
-     */
-    message: string;
-    /** Optional inline link appended to the message (e.g. "More info"). */
-    policyLinkText?: string;
-    /** Href for the inline policy link (relative or absolute). */
-    policyHref?: string;
-    /** Label for the "accept all" primary action. */
-    acceptText: string;
-    /** Label for the "reject / essential only" secondary action. */
-    rejectText: string;
-    /**
-     * Label for the "configure / customize" tertiary action. When omitted,
-     * the button is not rendered (simple two-button mode).
-     */
-    customizeText?: string;
-    /** Router link applied to the customize button (e.g. `'/cookies'`). */
-    customizeRouterLink?: string;
-    /** Show an `X` icon to dismiss the banner without deciding. Default `false`. */
-    dismissible?: boolean;
-    /** Color of the primary action button. Default `'primary'`. */
-    acceptColor?: Color;
-    /** Color of the secondary action button. Default `'medium'`. */
-    rejectColor?: Color;
-    /** Color of the tertiary action button. Default `'dark'`. */
-    customizeColor?: Color;
-    /**
-     * Max width of the inner banner container. Defaults to `'1200px'` so it
-     * doesn't span the full viewport on large screens.
-     */
-    maxWidth?: string;
-    /** Apply translucent (glass-style) backdrop. Default `false`. */
-    translucent?: boolean;
-}

package/lib/components/organisms/data-table/data-table.component.d.ts

@@ -1,63 +0,0 @@
-import { EventEmitter, OnInit, OnChanges, SimpleChanges } from '@angular/core';
-import { DataTableMetadata, DataTableColumn, DataTableSort, DataTableRowClickEvent, DataTableSelectionChangeEvent, DataTableSortChangeEvent, DataTablePageChangeEvent, DataTableEmptyState } from './types';
-import * as i0 from "@angular/core";
-export declare class DataTableComponent<T = any> implements OnInit, OnChanges {
-    props: DataTableMetadata<T>;
-    rowClick: EventEmitter<DataTableRowClickEvent<T>>;
-    selectionChange: EventEmitter<DataTableSelectionChangeEvent<T>>;
-    sortChange: EventEmitter<DataTableSortChangeEvent>;
-    pageChange: EventEmitter<DataTablePageChangeEvent>;
-    displayedData: T[];
-    currentSort: DataTableSort | null;
-    selectedRows: Set<any>;
-    /** Cached visible columns for performance */
-    private _visibleColumns;
-    private cdr;
-    private i18n;
-    ngOnInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    private initializeState;
-    private updateDisplayedData;
-    private sortData;
-    get visibleColumns(): DataTableColumn<T>[];
-    get totalColumns(): number;
-    get emptyState(): DataTableEmptyState;
-    /** Get actions column label */
-    getActionsLabel(): string;
-    /** Get pagination info text */
-    getPaginationInfoText(): string;
-    /** Get per page text */
-    getPerPageText(size: number): string;
-    /** Get first page aria label */
-    getFirstPageLabel(): string;
-    /** Get previous page aria label */
-    getPreviousPageLabel(): string;
-    /** Get next page aria label */
-    getNextPageLabel(): string;
-    /** Get last page aria label */
-    getLastPageLabel(): string;
-    get pageSizeOptions(): number[];
-    get totalPages(): number;
-    get paginationStart(): number;
-    get paginationEnd(): number;
-    get isAllSelected(): boolean;
-    get isIndeterminate(): boolean;
-    getCellValue(row: T, column: DataTableColumn<T>): any;
-    getFormattedValue(row: T, column: DataTableColumn<T>): string;
-    getColumnClass(column: DataTableColumn<T>): string;
-    getAriaSort(column: DataTableColumn<T>): string | null;
-    getRowNumber(index: number): number;
-    getRowId(row: T): any;
-    trackByFn(row: T): any;
-    isRowSelected(row: T): boolean;
-    onSort(column: DataTableColumn<T>): void;
-    onRowClick(row: T, index: number, event: MouseEvent): void;
-    toggleSelectAll(event: CustomEvent): void;
-    toggleRowSelection(row: T, event: CustomEvent): void;
-    selectSingleRow(row: T): void;
-    private emitSelectionChange;
-    goToPage(page: number): void;
-    onPageSizeChange(event: CustomEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DataTableComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DataTableComponent<any>, "val-data-table", never, { "props": { "alias": "props"; "required": false; }; }, { "rowClick": "rowClick"; "selectionChange": "selectionChange"; "sortChange": "sortChange"; "pageChange": "pageChange"; }, never, ["[toolbar]"], true, never>;
-}