valtech-components 2.0.729 → 2.0.731

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/bottom-nav/types.d.ts

@@ -109,7 +109,7 @@ 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 */
+    /** 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;
 }
 /**

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/config/company-footer.config.d.ts

@@ -31,9 +31,19 @@ export declare const VALTECH_FOOTER_LOGO: {
 export interface CompanyLink {
     /** i18n key for the link text */
     key: string;
-    /** URL path or external URL */
+    /** URL path (relative) or absolute URL */
     url: string;
-    /** Whether the link opens in a new tab */
+    /**
+     * Hint for `LegalLinkService` about which app owns this link in a multi-app factory:
+     * - `'legal'` — canonical legal content (terms, privacy, …) — lives on main site
+     * - `'site'`  — marketing/info pages (about, blog, …) — lives on main site
+     * - `'support'` — support/help — typically per-app (each product has own support)
+     *
+     * In satellite apps with `provideValtechLegal({ baseUrl })`, links with kind
+     * `'legal'` or `'site'` get rewritten to the main site URL.
+     */
+    kind?: 'legal' | 'site' | 'support';
+    /** Force opens in a new tab. Resolver may also set this when rewriting cross-origin. */
     external?: boolean;
 }
 /**
@@ -82,12 +92,22 @@ export declare const VALTECH_LANGUAGE_SELECTOR: {
     size: "default";
 };
 /**
- * Helper to build footer links from company links config
+ * Optional URL resolver applied per link (e.g. `LegalLinkService.resolve.bind(svc)`).
+ * Returns `{ url, external? }` to allow cross-origin rewrites.
+ */
+export type CompanyLinkResolver = (link: CompanyLink) => {
+    url: string;
+    external?: boolean;
+};
+/**
+ * Helper to build footer links from company links config.
+ *
  * @param links - Array of company links
  * @param t - Translation function (key: string) => string
+ * @param resolver - Optional resolver — typically `(link) => ({ url: legalLink.resolve(link.url), external: legalLink.isExternal(link.url) && (link.kind === 'legal' || link.kind === 'site') })` to point cross-app legal/site links to the main site.
  * @returns Array of link objects ready for FooterLinksMetadata
  */
-export declare function buildFooterLinks(links: CompanyLink[], t: (key: string) => string): Array<{
+export declare function buildFooterLinks(links: CompanyLink[], t: (key: string) => string, resolver?: CompanyLinkResolver): Array<{
     url: string;
     text: string;
     color: string;

package/lib/services/legal-link/legal-link.service.d.ts

@@ -0,0 +1,59 @@
+import { InjectionToken, Provider } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Config for cross-app legal/site link resolution.
+ *
+ * Used by satellite apps (showcase, sigify, admin-portal, …) to point their legal
+ * and site links (terms, privacy, about, contact, …) to the main marketing site,
+ * which owns the canonical legal content. The main site itself does NOT call
+ * `provideValtechLegal` — its links stay relative.
+ */
+export interface ValtechLegalConfig {
+    /**
+     * Absolute base URL of the main site (no trailing slash).
+     * @example 'https://myvaltech.com'
+     */
+    baseUrl?: string;
+    /** Open resolved external links in a new tab. Defaults to `true` when `baseUrl` is set. */
+    openInNewTab?: boolean;
+}
+export declare const VALTECH_LEGAL_CONFIG: InjectionToken<ValtechLegalConfig>;
+/**
+ * Resolves legal/site paths against a configurable main-site base URL.
+ *
+ * - **Main site mode**: no `provideValtechLegal` called → `resolve('/legal/terms')` returns `/legal/terms` (relative).
+ * - **Satellite mode**: `provideValtechLegal({ baseUrl: 'https://myvaltech.com' })` → `resolve('/legal/terms')` returns `'https://myvaltech.com/legal/terms'` and `isExternal('/legal/terms')` returns `true`.
+ *
+ * Absolute URLs passed in are returned unchanged (no double-prefix).
+ */
+export declare class LegalLinkService {
+    private readonly config;
+    /** Effective base URL (null if running as main site). */
+    get baseUrl(): string | null;
+    /** Whether resolved external links should open in a new tab. */
+    get openInNewTab(): boolean;
+    /**
+     * Returns the URL to use for a given internal path. Absolute URLs pass through.
+     * @example
+     * resolve('/legal/terms')  // main site:    '/legal/terms'
+     *                          // satellite:    'https://myvaltech.com/legal/terms'
+     * resolve('https://x.com/y') // unchanged
+     */
+    resolve(path: string): string;
+    /** `true` if the path would be resolved to a cross-origin URL. */
+    isExternal(path: string): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LegalLinkService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LegalLinkService>;
+}
+/**
+ * Wires `LegalLinkService` for satellite apps. Omit in the main site (the one
+ * that hosts the canonical /legal/* routes) so links stay relative.
+ *
+ * @example
+ * // main.ts of showcase / sigify / etc.
+ * provideValtechLegal({
+ *   baseUrl: 'https://myvaltech.com',
+ *   openInNewTab: true,
+ * }),
+ */
+export declare function provideValtechLegal(config: ValtechLegalConfig): Provider;

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.731";

package/package.json

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

package/public-api.d.ts

@@ -239,11 +239,14 @@ 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/legal-link/legal-link.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';