valtech-components 2.0.728 → 2.0.730

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

@@ -64,6 +64,7 @@ export declare class BottomNavComponent implements OnInit, OnDestroy {
         hideLabels: boolean;
         safeArea: boolean;
         animation: "none" | "slide" | "fade" | "scale";
+        maxWidth: string;
     }>;
     /** Computed tabs with FAB inserted if present */
     displayTabs: import("@angular/core").Signal<BottomNavTab[]>;
@@ -75,6 +76,8 @@ export declare class BottomNavComponent implements OnInit, OnDestroy {
     getLabel(tab: BottomNavTab): string;
     /** Get CSS variables for theming */
     getThemeStyles(): Record<string, string>;
+    /** Resolve maxWidth token (sm|md|lg|xl|full) to CSS var or raw value */
+    resolveMaxWidth(v?: string): string;
     ngOnInit(): void;
     ngOnDestroy(): void;
     /** Handle tab click */

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

@@ -109,10 +109,12 @@ export interface BottomNavMetadata {
     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: 'xl' (1100px) — alinea con `--val-container-xl` del repo */
+    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'full' | string;
 }
 /**
  * Default values for BottomNavMetadata
  */
-export declare const BOTTOM_NAV_DEFAULTS: Required<Pick<BottomNavMetadata, 'hideLabels' | 'safeArea' | 'animation'>> & {
+export declare const BOTTOM_NAV_DEFAULTS: Required<Pick<BottomNavMetadata, 'hideLabels' | 'safeArea' | 'animation' | 'maxWidth'>> & {
     theme: Required<BottomNavTheme>;
 };

package/lib/services/auth/handoff.service.d.ts

@@ -50,6 +50,16 @@ export interface HandoffCreateResponse {
     expiresAt: string;
     /** Echoed `route` from the request, when provided. */
     route?: string;
+    /**
+     * Absolute base URL of the target app (e.g. `"https://sigify.com"`).
+     *
+     * When present, callers should use this as the destination for the redirect.
+     * Backend resolves it from the `app-config` table (single source of truth).
+     *
+     * Optional for backward compatibility — when missing, callers may fall back
+     * to a client-side `appUrls` mapping.
+     */
+    targetBaseUrl?: string;
 }
 /**
  * Response body from `POST /v2/auth/handoff/exchange`.

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.728",
+  "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';