valtech-components 4.0.5 → 4.0.6

package/lib/components/atoms/progress-bar/types.d.ts

@@ -16,4 +16,6 @@ export interface ProgressBarMetadata {
     buffer: number;
     type: 'determinate' | 'indeterminate';
     rounded: boolean;
+    /** Accessible label for screen readers (aria-label). Defaults to 'Progreso'. */
+    label?: string;
 }

package/lib/components/atoms/rights-footer/rights-footer.component.d.ts

@@ -39,11 +39,11 @@ export declare class RightsFooterComponent {
     /**
      * Computed helper for align prop in template.
      */
-    propsAlign: import("@angular/core").Signal<"left" | "right" | "center">;
+    propsAlign: import("@angular/core").Signal<"left" | "center" | "right">;
     /**
      * Computed helper for color prop in template.
      */
-    propsColor: import("@angular/core").Signal<"primary" | "secondary" | "tertiary" | "success" | "warning" | "danger" | "light" | "medium" | "dark">;
+    propsColor: import("@angular/core").Signal<"success" | "medium" | "primary" | "secondary" | "tertiary" | "warning" | "danger" | "light" | "dark">;
     /**
      * Computed helper for withMargin prop in template.
      */

package/lib/components/atoms/text/text.component.d.ts

@@ -11,7 +11,7 @@ export declare class TextComponent {
      */
     displayContent: import("@angular/core").Signal<string>;
     propsColor: import("@angular/core").Signal<import("@ionic/core").Color>;
-    propsSize: import("@angular/core").Signal<"medium" | "small" | "large" | "xlarge">;
+    propsSize: import("@angular/core").Signal<"small" | "medium" | "large" | "xlarge">;
     propsBold: import("@angular/core").Signal<boolean>;
     propsProcessLinks: import("@angular/core").Signal<boolean>;
     propsAllowPartialBold: import("@angular/core").Signal<boolean>;

package/lib/components/atoms/user-avatar/user-avatar.component.d.ts

@@ -38,7 +38,7 @@ export declare class UserAvatarComponent {
     readonly imageUrl: import("@angular/core").Signal<string>;
     /** Iniciales — 1-2 chars derivados de name (preferred) o email prefix. */
     readonly initials: import("@angular/core").Signal<string>;
-    readonly sizeClass: import("@angular/core").Signal<"medium" | "small" | "large" | "xlarge" | "xsmall">;
+    readonly sizeClass: import("@angular/core").Signal<"small" | "medium" | "large" | "xlarge" | "xsmall">;
     readonly shapeClass: import("@angular/core").Signal<"circle" | "square">;
     /** Background — explicito o derivado deterministicamente del user. */
     readonly bgColor: import("@angular/core").Signal<string>;

package/lib/components/molecules/features-list/features-list.component.d.ts

@@ -41,7 +41,7 @@ export declare class FeaturesListComponent {
         iconColor: string;
         iconSize: number;
         mode: "horizontal" | "vertical";
-        gap: "medium" | "small" | "large";
+        gap: "small" | "medium" | "large";
         alignment: "center" | "start";
         imageShape: "circle" | "square";
         maxVisible: number;

package/lib/components/organisms/article/article.component.d.ts

@@ -45,7 +45,7 @@ export declare class ArticleComponent implements OnInit {
     getVideoElement(element: ArticleElement): ArticleVideoElement;
     getCustomElement(element: ArticleElement): ArticleCustomElement;
     getQuoteTextProps(element: ArticleElement): {
-        size: "medium" | "small" | "large" | "xlarge";
+        size: "small" | "medium" | "large" | "xlarge";
         color: import("@ionic/core").Color;
         content?: string;
         bold: boolean;
@@ -57,11 +57,11 @@ export declare class ArticleComponent implements OnInit {
         linkConfig?: import("valtech-components").LinkProcessorConfig;
         allowPartialBold?: boolean;
         authorColor?: import("@ionic/core").Color;
-        alignment?: "left" | "right" | "center";
+        alignment?: "left" | "center" | "right";
         showQuoteMark?: boolean;
     };
     getHighlightTextProps(element: ArticleElement): {
-        size: "medium" | "small" | "large" | "xlarge";
+        size: "small" | "medium" | "large" | "xlarge";
         color: import("@ionic/core").Color;
         content?: string;
         bold: boolean;
@@ -93,7 +93,7 @@ export declare class ArticleComponent implements OnInit {
         shape?: "round";
         size?: "default" | "small" | "large";
         fill?: "default" | "clear" | "outline" | "solid";
-        type: "button" | "submit" | "reset";
+        type: "reset" | "submit" | "button";
         token?: string;
         ref?: any;
         handler?: (value: any) => any;

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

@@ -19,6 +19,8 @@ export type CookieBannerPosition = 'bottom' | 'top';
 export interface CookieBannerMetadata {
     /** Whether the banner is shown. Parent toggles based on `hasDecided`. */
     visible: boolean;
+    /** Accessible label for the dialog (aria-label). Defaults to 'Aviso de cookies'. */
+    ariaLabel?: string;
     /** Where the banner anchors. Default `'bottom'`. */
     position?: CookieBannerPosition;
     /** Short title above the message (optional). */

package/lib/components/organisms/landing-steps/landing-steps.component.d.ts

@@ -4,7 +4,7 @@ export declare class LandingStepsComponent {
     private readonly props_;
     set props(v: LandingStepsMetadata);
     readonly p: import("@angular/core").Signal<LandingStepsMetadata>;
-    readonly cols: import("@angular/core").Signal<3 | 2 | 4>;
+    readonly cols: import("@angular/core").Signal<2 | 3 | 4>;
     readonly accentColor: import("@angular/core").Signal<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<LandingStepsComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LandingStepsComponent, "val-landing-steps", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;

package/lib/services/page-state/page-state.d.ts

@@ -0,0 +1,74 @@
+/**
+ * createPageState — helper estándar para el patrón loading/error/data de una
+ * página con datos remotos (HTTP o Firestore one-shot).
+ *
+ * Encapsula el boilerplate repetido en cada vista:
+ *  - `loading` signal (true mientras carga o recarga).
+ *  - `loadError` signal (el error crudo o null).
+ *  - `errorState` computed que convierte el error a `EmptyStateMetadata` listo
+ *    para `<val-empty-state>`, reactivo al idioma.
+ *  - `reload()` function que re-ejecuta el `loader` async.
+ *
+ * El caller controla el template; `createPageState` solo maneja el estado:
+ *
+ * ```ts
+ * readonly page = createPageState(
+ *   this.i18n,
+ *   async () => {
+ *     const res = await firstValueFrom(this.svc.getData());
+ *     this.items.set(res.items);
+ *   },
+ *   { errorTitle: () => this.t('errorTitle'), retryLabel: () => this.t('retry') }
+ * );
+ * ```
+ *
+ * Template:
+ * ```html
+ * @if (page.loading()) { <val-skeleton-layout [props]="{ preset: 'list' }" /> }
+ * @else if (page.errorState(); as e) { <val-empty-state [props]="e" /> }
+ * @else { <!-- content --> }
+ * ```
+ *
+ * El helper llama a `reload()` automáticamente al construirse (carga inicial),
+ * igual que el patrón clásico `void this.load()` en el constructor.
+ * Para deshabilitar la carga automática, pasar `{ autoLoad: false }`.
+ *
+ * Para pull-to-refresh usar `connectPageRefresh(() => page.reload())` como siempre.
+ */
+import { EmptyStateMetadata } from '../../components/molecules/empty-state/types';
+import { I18nService } from '../i18n';
+/** Labels i18n para el empty-state de error. Funciones para ser reactivas. */
+export interface PageStateLabels {
+    errorTitle?: () => string;
+    offlineTitle?: () => string;
+    offlineHint?: () => string;
+    retryLabel?: () => string;
+    /** Descripción del error (default: mensaje del backend). */
+    errorDescription?: (err: unknown) => string;
+}
+/** Objeto retornado por `createPageState`. */
+export interface PageState {
+    /** true mientras el loader está en curso. */
+    readonly loading: () => boolean;
+    /** Error crudo del último intento (null si fue exitoso). */
+    readonly loadError: () => unknown | null;
+    /**
+     * Props para `<val-empty-state>` — null si no hay error.
+     * Reactivo al idioma (llama `i18n.lang()` internamente).
+     */
+    readonly errorState: () => EmptyStateMetadata | null;
+    /** Re-ejecuta el loader (sets loading=true, limpia error). */
+    reload(): Promise<void>;
+}
+/**
+ * Crea el estado de carga de una página.
+ *
+ * @param i18n - `I18nService` inyectado en la page (para reactividad al idioma).
+ * @param loader - función async que carga los datos y los siembra en signals
+ *   propias de la page. Si lanza, el error se captura en `loadError`.
+ * @param labels - labels i18n opcionales. Si se omiten usa defaults genéricos.
+ * @param options - `autoLoad`: si false no carga al construirse (default true).
+ */
+export declare function createPageState(i18n: I18nService, loader: () => Promise<void>, labels?: PageStateLabels, options?: {
+    autoLoad?: boolean;
+}): PageState;

package/lib/services/page-state/page-state.i18n.d.ts

@@ -0,0 +1,6 @@
+import { LanguagesContent } from '../i18n/types';
+/**
+ * Defaults i18n embebidos en `createPageState`. Namespace `PageState`.
+ * Auto-registrados la primera vez que se llama al helper.
+ */
+export declare const PAGE_STATE_I18N: LanguagesContent;

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "4.0.5";
+export declare const VERSION = "4.0.6";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.5",
+  "version": "4.0.6",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -369,6 +369,7 @@ export * from './lib/services/network-status';
 export * from './lib/components/molecules/network-banner/network-banner.component';
 export * from './lib/services/page-refresh/page-refresh.service';
 export * from './lib/services/refreshable-stream';
+export * from './lib/services/page-state/page-state';
 export * from './lib/services/app-config';
 export * from './lib/services/app-version';
 export * from './lib/services/presets';