valtech-components 2.0.729 → 2.0.730

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

@@ -43,7 +43,7 @@ export declare class RightsFooterComponent {
     /**
      * 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<"medium" | "primary" | "secondary" | "tertiary" | "success" | "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/molecules/features-list/features-list.component.d.ts

@@ -48,7 +48,7 @@ export declare class FeaturesListComponent {
         iconColor: string;
         iconSize: number;
         mode: "horizontal" | "vertical";
-        gap: "medium" | "small" | "large";
+        gap: "small" | "medium" | "large";
         alignment: "start" | "center";
     }>;
     /** Resolved icon color (handles Ionic colors and CSS colors) */

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;
@@ -61,7 +61,7 @@ export declare class ArticleComponent implements OnInit {
         showQuoteMark?: boolean;
     };
     getHighlightTextProps(element: ArticleElement): {
-        size: "medium" | "small" | "large" | "xlarge";
+        size: "small" | "medium" | "large" | "xlarge";
         color: import("@ionic/core").Color;
         content?: string;
         bold: boolean;
@@ -90,7 +90,7 @@ export declare class ArticleComponent implements OnInit {
         contentInterpolation?: Record<string, string | number>;
         icon?: import("valtech-components").IconMetada;
         shape?: "round";
-        size?: "small" | "default" | "large";
+        size?: "small" | "large" | "default";
         fill?: "default" | "clear" | "outline" | "solid";
         type: "button" | "submit" | "reset";
         token?: string;

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

@@ -63,7 +63,7 @@ export declare class BottomNavComponent implements OnInit, OnDestroy {
         i18nNamespace?: string;
         hideLabels: boolean;
         safeArea: boolean;
-        animation: "fade" | "scale" | "slide" | "none";
+        animation: "none" | "slide" | "fade" | "scale";
         maxWidth: string;
     }>;
     /** Computed tabs with FAB inserted if present */

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

@@ -72,7 +72,7 @@ export declare class ToolbarComponent implements OnInit {
         };
         showFlags?: boolean;
         color: import("@ionic/core").Color;
-        size?: "small" | "default" | "large";
+        size?: "small" | "large" | "default";
         fill?: "default" | "clear" | "outline" | "solid";
         shape?: "round";
         expand?: "full" | "block";

package/lib/services/markdown-article/legal-content.service.d.ts

@@ -1,31 +1,73 @@
+import { InjectionToken, Provider } from '@angular/core';
 import { Observable } from 'rxjs';
 import { ArticleMetadata } from '../../components/organisms/article/types';
 import * as i0 from "@angular/core";
 export type LegalSlug = 'terms' | 'privacy' | 'cookies' | 'data-usage' | 'legal-notice' | string;
+/**
+ * Factory that returns a Record<slug, ArticleMetadata> for a given locale.
+ * Use a dynamic `import()` so each locale module is code-split by the bundler.
+ */
+export type LegalContentFactory = () => Promise<Record<string, ArticleMetadata>>;
+export interface LegalContentConfig {
+    /** Pre-generated content factories keyed by locale (e.g. `{ es: () => import('./generated/legal-content.es') ... }`). */
+    factories?: Record<string, LegalContentFactory>;
+    /** Override default `/assets/legal` base path used when no factory matches. */
+    basePath?: string;
+    /** Fallback locale (default `es`). Set null to disable. */
+    fallbackLocale?: string | null;
+}
+export declare const LEGAL_CONTENT_CONFIG: InjectionToken<LegalContentConfig>;
 export interface LegalLoadOptions {
-    /** Two-letter locale code (es, en, pt). Falls back to `es` on 404. */
+    /** Two-letter locale code (es, en, pt). */
     locale?: string;
-    /** Override base path (default `/assets/legal`). */
+    /** Override base path for runtime mode (default `/assets/legal`). */
     basePath?: string;
     /** Fallback locale tried when the requested one is missing. Set null to disable. */
     fallbackLocale?: string | null;
 }
 /**
- * Loads Markdown legal documents from `/assets/legal/{locale}/{slug}.md` and parses them
- * into ArticleMetadata ready for `<val-article>`. Caches parsed results by `locale:slug`
- * so multiple views consuming the same doc share one HTTP request.
+ * Loads legal articles via one of two modes:
+ *
+ * 1. **Build-time** (preferred): when the app provides `LEGAL_CONTENT_CONFIG.factories`
+ *    via `provideLegalContent()`, the service dynamically imports the matching
+ *    locale module and returns the pre-parsed `ArticleMetadata` synchronously
+ *    (wrapped in an Observable). Each locale is code-split.
+ *
+ * 2. **Runtime**: when no factory matches, falls back to fetching
+ *    `/assets/legal/{locale}/{slug}.md` and parsing on the fly.
+ *
+ * Both modes cache by `locale:slug` so concurrent loads share one promise/HTTP request.
  */
 export declare class LegalContentService {
     private readonly http;
     private readonly parser;
+    private readonly config;
     private readonly DEFAULT_BASE;
     private readonly cache;
+    private readonly factoryCache;
     load(slug: LegalSlug, options?: LegalLoadOptions): Observable<ArticleMetadata>;
-    /** Returns the raw Markdown string without parsing. Useful for debugging. */
+    /** Raw Markdown — only available in runtime mode (HTTP). */
     raw(slug: LegalSlug, options?: LegalLoadOptions): Observable<string>;
-    /** Clears the in-memory cache. Call when the user changes locale at runtime. */
+    /** Clears in-memory caches. Call on runtime locale change. */
     invalidate(): void;
+    private loadOne;
+    private runFactory;
     private fetchAndParse;
     static ɵfac: i0.ɵɵFactoryDeclaration<LegalContentService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<LegalContentService>;
 }
+/**
+ * Wires pre-generated legal content into `LegalContentService`. Call from `main.ts`
+ * (or any `providers: []` array). The factories use dynamic `import()` so each
+ * locale is code-split — only the active locale's bundle is loaded.
+ *
+ * @example
+ * provideLegalContent({
+ *   factories: {
+ *     es: () => import('./app/generated/legal-content.es').then((m) => m.LEGAL_CONTENT_ES),
+ *     en: () => import('./app/generated/legal-content.en').then((m) => m.LEGAL_CONTENT_EN),
+ *     pt: () => import('./app/generated/legal-content.pt').then((m) => m.LEGAL_CONTENT_PT),
+ *   },
+ * })
+ */
+export declare function provideLegalContent(config: LegalContentConfig): Provider;

package/lib/services/markdown-article/markdown-article-parser.d.ts

@@ -0,0 +1,16 @@
+import { ArticleMetadata } from '../../components/organisms/article/types';
+/**
+ * Pure Markdown → ArticleMetadata parser. No Angular deps — usable from Node scripts
+ * (build-time generation) and from the Angular `MarkdownArticleParserService` wrapper.
+ *
+ * Supported syntax:
+ * - Headings (#, ##, ### …) → title / subtitle
+ * - Paragraphs → paragraph (with `processLinks` + `allowPartialBold`)
+ * - Lists (-, *, 1.) → unordered / ordered list (- [ ] / - [x] for checklist)
+ * - Blockquotes (>) → quote, with GitHub callouts `> [!NOTE|TIP|INFO|WARNING|CAUTION|IMPORTANT]` mapped to notes
+ * - Code fences (```lang) → code
+ * - Box-drawing ASCII art (┌┐└┘│─) auto-wrapped as code
+ * - Tables → flattened into paragraphs with bold keys
+ * - Horizontal rules (---, ***, ___) → separator
+ */
+export declare function parseMarkdownArticle(markdown: string, config?: Partial<ArticleMetadata>): ArticleMetadata;

package/lib/services/markdown-article/markdown-article-parser.service.d.ts

@@ -1,31 +1,12 @@
 import { ArticleMetadata } from '../../components/organisms/article/types';
 import * as i0 from "@angular/core";
 /**
- * Converts Markdown documents into ArticleMetadata for the val-article organism.
- *
- * Supported syntax:
- * - Headings (#, ##, ### …) → title / subtitle
- * - Paragraphs → paragraph (with `processLinks` + `allowPartialBold`)
- * - Lists (-, *, 1.) → unordered / ordered list (- [ ] / - [x] for checklist)
- * - Blockquotes (>) → quote, with GitHub callouts `> [!NOTE|TIP|INFO|WARNING|CAUTION|IMPORTANT]` mapped to notes
- * - Code fences (```lang) → code
- * - Box-drawing ASCII art (┌┐└┘│─) auto-wrapped as code
- * - Tables → flattened into paragraphs with bold keys
- * - Horizontal rules (---, ***, ___) → separator
+ * Angular service wrapper for the pure {@link parseMarkdownArticle} function.
+ * Provided in root so it can be injected anywhere. The actual parsing logic lives in
+ * `markdown-article-parser.ts` and is also usable from Node scripts (build-time generation).
  */
 export declare class MarkdownArticleParserService {
     parse(markdown: string, config?: Partial<ArticleMetadata>): ArticleMetadata;
-    private normalize;
-    private startsNewBlock;
-    private makeHeading;
-    private makeQuoteOrCallout;
-    private makeNote;
-    /**
-     * Tables are flattened into a header subtitle (if present) followed by one paragraph per
-     * data row using `**col[0]:** col[1] · **col[2]:** col[3] …` format. val-article has no
-     * native table element so this preserves the information without breaking the layout.
-     */
-    private makeTable;
     static ɵfac: i0.ɵɵFactoryDeclaration<MarkdownArticleParserService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MarkdownArticleParserService>;
 }

package/lib/services/preferences/index.d.ts

@@ -0,0 +1,2 @@
+export * from './preferences.service';
+export * from './preferences.types';

package/lib/services/preferences/preferences.service.d.ts

@@ -0,0 +1,51 @@
+import { HttpClient } from '@angular/common/http';
+import { AuthService } from '../auth/auth.service';
+import { ValtechAuthConfig } from '../auth/types';
+import { FirestoreService } from '../firebase/firestore.service';
+import { I18nService } from '../i18n/i18n.service';
+import { ThemeService } from '../theme.service';
+import { PreferencesLanguage, PreferencesTheme, PreferencesUpdate, PreferencesUpdateResponse } from './preferences.types';
+import * as i0 from "@angular/core";
+/**
+ * PreferencesService — preferencias del user en el doc canónico Firestore
+ * `/apps/{appId}/users/{uid}/preferences/main`.
+ *
+ * Read reactivo (signals) via listener Firestore.
+ * Write via `PUT /v2/auth/preferences` (cliente NUNCA escribe Firestore directo —
+ * ver memoria `feedback_no_direct_firestore_writes`).
+ *
+ * Side-effects automáticos:
+ * - Cuando `theme()` cambia → `ThemeService.Theme = ...`
+ * - Cuando `language()` cambia → `I18nService.setLanguage(...)`
+ *
+ * Auto-bind al user actual via `AuthService.user()`. Sin user (logout) → unbind.
+ */
+export declare class PreferencesService {
+    private config;
+    private firestore;
+    private auth;
+    private http;
+    private themeService;
+    private i18n;
+    private readonly _theme;
+    private readonly _language;
+    private readonly _notificationsMaster;
+    /** `true` después del primer snapshot Firestore. Antes, defaults sin side-effects. */
+    private readonly _synced;
+    readonly theme: import("@angular/core").Signal<PreferencesTheme>;
+    readonly language: import("@angular/core").Signal<PreferencesLanguage>;
+    readonly notificationsMaster: import("@angular/core").Signal<boolean>;
+    readonly synced: import("@angular/core").Signal<boolean>;
+    private subscription?;
+    private currentUserId?;
+    constructor(config: ValtechAuthConfig, firestore: FirestoreService, auth: AuthService, http: HttpClient, themeService: ThemeService | null, i18n: I18nService | null);
+    /** Actualiza preferencias via backend. Optimistic UI: aplica local, revierte si falla. */
+    update(partial: PreferencesUpdate): Promise<PreferencesUpdateResponse>;
+    setTheme(theme: PreferencesTheme): Promise<PreferencesUpdateResponse>;
+    setLanguage(language: PreferencesLanguage): Promise<PreferencesUpdateResponse>;
+    setNotificationsMaster(enabled: boolean): Promise<PreferencesUpdateResponse>;
+    private bindToUser;
+    private unbind;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PreferencesService, [null, null, null, null, { optional: true; }, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PreferencesService>;
+}

package/lib/services/preferences/preferences.types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Preferences types — Fase 1 schema simple (theme + language + notifications.master).
+ * Doc canónico: /apps/{appId}/users/{uid}/preferences/main
+ * Cliente NUNCA escribe directo — todas las mutaciones via PUT /v2/auth/preferences.
+ */
+export type PreferencesTheme = 'light' | 'dark' | 'auto';
+export type PreferencesLanguage = 'es' | 'en' | 'pt';
+/** Forma del doc tal como lo escribe el backend (Admin SDK). */
+export interface PreferencesDocument {
+    theme?: PreferencesTheme;
+    language?: PreferencesLanguage;
+    notifications?: {
+        master?: boolean;
+    };
+    /** serverTimestamp escrito por el backend en cada sync. */
+    syncedAt?: unknown;
+}
+/** Payload aceptado por `PUT /v2/auth/preferences` — partial update. */
+export interface PreferencesUpdate {
+    theme?: PreferencesTheme;
+    language?: PreferencesLanguage;
+    notifications?: {
+        master?: boolean;
+    };
+}
+/** Response del backend tras el PUT. */
+export interface PreferencesUpdateResponse {
+    operationId: string;
+    theme: PreferencesTheme | '';
+    language: PreferencesLanguage | '';
+    notifications: {
+        master?: boolean;
+    };
+    updated: boolean;
+}

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 = "2.0.729";
+export declare const VERSION = "2.0.730";

package/package.json

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

package/public-api.d.ts

@@ -239,11 +239,13 @@ export * from './lib/services/qr-generator/types';
 export * from './lib/services/modal/modal.service';
 export * from './lib/services/modal/types';
 export * from './lib/services/meta';
+export * from './lib/services/markdown-article/markdown-article-parser';
 export * from './lib/services/markdown-article/markdown-article-parser.service';
 export * from './lib/services/markdown-article/legal-content.service';
 export * from './lib/services/firebase';
 export * from './lib/services/auth';
 export * from './lib/services/i18n';
+export * from './lib/services/preferences';
 export * from './lib/services/app-config';
 export * from './lib/services/presets';
 export * from './lib/services/skeleton';