valtech-components 2.0.729 → 2.0.730

package/fesm2022/valtech-components.mjs

@@ -50,7 +50,7 @@ import 'prismjs/components/prism-json';
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-const VERSION = '2.0.729';
+const VERSION = '2.0.730';
 
 /**
  * Servicio para gestionar presets de componentes.
@@ -34953,7 +34953,8 @@ const ORDERED_RE = /^\s*\d+\.\s+(.+)$/;
 const TABLE_DIVIDER_RE = /^\s*\|?[\s:|-]+\|?\s*$/;
 const TABLE_ROW_RE = /^\s*\|(.+)\|\s*$/;
 /**
- * Converts Markdown documents into ArticleMetadata for the val-article organism.
+ * 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
@@ -34965,261 +34966,256 @@ const TABLE_ROW_RE = /^\s*\|(.+)\|\s*$/;
  * - Tables → flattened into paragraphs with bold keys
  * - Horizontal rules (---, ***, ___) → separator
  */
-class MarkdownArticleParserService {
-    parse(markdown, config) {
-        const lines = this.normalize(markdown).split('\n');
-        const elements = [];
-        let i = 0;
-        while (i < lines.length) {
-            const line = lines[i];
-            if (line.trim() === '') {
+function parseMarkdownArticle(markdown, config) {
+    const lines = normalize(markdown).split('\n');
+    const elements = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.trim() === '') {
+            i++;
+            continue;
+        }
+        const fence = line.match(FENCE_RE);
+        if (fence) {
+            const lang = fence[1] || undefined;
+            const body = [];
+            i++;
+            while (i < lines.length && !FENCE_RE.test(lines[i])) {
+                body.push(lines[i]);
                 i++;
-                continue;
             }
-            // Fenced code block
-            const fence = line.match(FENCE_RE);
-            if (fence) {
-                const lang = fence[1] || undefined;
-                const body = [];
+            i++;
+            elements.push({
+                type: 'code',
+                props: { code: body.join('\n'), language: lang, theme: 'dark' },
+            });
+            continue;
+        }
+        if (BOX_DRAWING.test(line)) {
+            const body = [];
+            while (i < lines.length && (lines[i].trim() === '' || BOX_DRAWING.test(lines[i]))) {
+                body.push(lines[i]);
                 i++;
-                while (i < lines.length && !FENCE_RE.test(lines[i])) {
-                    body.push(lines[i]);
-                    i++;
-                }
-                i++; // skip closing fence
-                elements.push({
-                    type: 'code',
-                    props: { code: body.join('\n'), language: lang, theme: 'dark' },
-                });
-                continue;
-            }
-            // ASCII box-drawing art → treat as code block
-            if (BOX_DRAWING.test(line)) {
-                const body = [];
-                while (i < lines.length && (lines[i].trim() === '' || BOX_DRAWING.test(lines[i]))) {
-                    body.push(lines[i]);
-                    i++;
-                }
-                // Trim trailing blank lines from the block
-                while (body.length && body[body.length - 1].trim() === '')
-                    body.pop();
-                elements.push({
-                    type: 'code',
-                    props: { code: body.join('\n'), language: 'text', theme: 'dark' },
-                });
-                continue;
             }
-            // Separator
-            if (SEPARATOR_RE.test(line)) {
-                elements.push({ type: 'separator', props: { style: 'line' } });
+            while (body.length && body[body.length - 1].trim() === '')
+                body.pop();
+            elements.push({
+                type: 'code',
+                props: { code: body.join('\n'), language: 'text', theme: 'dark' },
+            });
+            continue;
+        }
+        if (SEPARATOR_RE.test(line)) {
+            elements.push({ type: 'separator', props: { style: 'line' } });
+            i++;
+            continue;
+        }
+        const heading = line.match(HEADING_RE);
+        if (heading) {
+            elements.push(makeHeading(heading[1].length, heading[2].trim()));
+            i++;
+            continue;
+        }
+        if (line.startsWith('>')) {
+            const block = [];
+            while (i < lines.length && lines[i].startsWith('>')) {
+                block.push(lines[i]);
                 i++;
-                continue;
             }
-            // Heading
-            const heading = line.match(HEADING_RE);
-            if (heading) {
-                elements.push(this.makeHeading(heading[1].length, heading[2].trim()));
+            elements.push(makeQuoteOrCallout(block));
+            continue;
+        }
+        if (TABLE_ROW_RE.test(line)) {
+            const rows = [];
+            while (i < lines.length && TABLE_ROW_RE.test(lines[i])) {
+                rows.push(lines[i]);
                 i++;
-                continue;
-            }
-            // Callout / blockquote (consume contiguous `>` lines)
-            if (line.startsWith('>')) {
-                const block = [];
-                while (i < lines.length && lines[i].startsWith('>')) {
-                    block.push(lines[i]);
-                    i++;
-                }
-                elements.push(this.makeQuoteOrCallout(block));
-                continue;
-            }
-            // Table (consume contiguous `|` lines)
-            if (TABLE_ROW_RE.test(line)) {
-                const rows = [];
-                while (i < lines.length && TABLE_ROW_RE.test(lines[i])) {
-                    rows.push(lines[i]);
-                    i++;
-                }
-                elements.push(...this.makeTable(rows));
-                continue;
-            }
-            // List (checklist / unordered / ordered) — consume contiguous lines
-            if (CHECKLIST_RE.test(line) || UNORDERED_RE.test(line) || ORDERED_RE.test(line)) {
-                const listType = CHECKLIST_RE.test(line)
-                    ? 'checklist'
-                    : ORDERED_RE.test(line)
-                        ? 'ordered'
-                        : 'unordered';
-                const items = [];
-                while (i < lines.length && lines[i].trim() !== '') {
-                    const cur = lines[i];
-                    const check = cur.match(CHECKLIST_RE);
-                    const unord = cur.match(UNORDERED_RE);
-                    const ord = cur.match(ORDERED_RE);
-                    if (check)
-                        items.push({ text: check[2].trim() });
-                    else if (ord && listType === 'ordered')
-                        items.push({ text: ord[1].trim() });
-                    else if (unord && listType !== 'ordered')
-                        items.push({ text: unord[1].trim() });
-                    else
-                        break;
-                    i++;
-                }
-                elements.push({ type: 'list', props: { items, listType } });
-                continue;
             }
-            // Paragraph — consume contiguous non-empty lines that aren't a special block
-            const paragraph = [];
-            while (i < lines.length && lines[i].trim() !== '' && !this.startsNewBlock(lines[i])) {
-                paragraph.push(lines[i]);
+            elements.push(...makeTable(rows));
+            continue;
+        }
+        if (CHECKLIST_RE.test(line) || UNORDERED_RE.test(line) || ORDERED_RE.test(line)) {
+            const listType = CHECKLIST_RE.test(line)
+                ? 'checklist'
+                : ORDERED_RE.test(line)
+                    ? 'ordered'
+                    : 'unordered';
+            const items = [];
+            while (i < lines.length && lines[i].trim() !== '') {
+                const cur = lines[i];
+                const check = cur.match(CHECKLIST_RE);
+                const unord = cur.match(UNORDERED_RE);
+                const ord = cur.match(ORDERED_RE);
+                if (check)
+                    items.push({ text: check[2].trim() });
+                else if (ord && listType === 'ordered')
+                    items.push({ text: ord[1].trim() });
+                else if (unord && listType !== 'ordered')
+                    items.push({ text: unord[1].trim() });
+                else
+                    break;
                 i++;
             }
-            const text = paragraph.join(' ').trim();
-            if (text) {
-                elements.push({
-                    type: 'paragraph',
-                    props: {
-                        content: text,
-                        size: 'medium',
-                        color: 'dark',
-                        bold: false,
-                        processLinks: true,
-                        allowPartialBold: true,
-                    },
-                });
-            }
+            elements.push({ type: 'list', props: { items, listType } });
+            continue;
         }
-        return {
-            elements,
-            maxWidth: '900px',
-            centered: true,
-            theme: 'auto',
-            ...config,
-        };
-    }
-    normalize(md) {
-        return md.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-    }
-    startsNewBlock(line) {
-        return (HEADING_RE.test(line) ||
-            FENCE_RE.test(line) ||
-            SEPARATOR_RE.test(line) ||
-            TABLE_ROW_RE.test(line) ||
-            UNORDERED_RE.test(line) ||
-            ORDERED_RE.test(line) ||
-            CHECKLIST_RE.test(line) ||
-            line.startsWith('>') ||
-            BOX_DRAWING.test(line));
-    }
-    makeHeading(level, content) {
-        if (level === 1) {
-            return {
-                type: 'title',
-                props: { content, size: 'xlarge', color: 'dark', bold: true },
-            };
+        const paragraph = [];
+        while (i < lines.length && lines[i].trim() !== '' && !startsNewBlock(lines[i])) {
+            paragraph.push(lines[i]);
+            i++;
+        }
+        const text = paragraph.join(' ').trim();
+        if (text) {
+            elements.push({
+                type: 'paragraph',
+                props: {
+                    content: text,
+                    size: 'medium',
+                    color: 'dark',
+                    bold: false,
+                    processLinks: true,
+                    allowPartialBold: true,
+                },
+            });
         }
-        const size = level === 2 ? 'large' : level === 3 ? 'medium' : 'small';
-        return {
-            type: 'subtitle',
-            props: { content, size, color: 'dark', bold: true },
-        };
-    }
-    makeQuoteOrCallout(block) {
-        const first = block[0];
-        const callout = first.match(CALLOUT_RE);
-        const lines = block.map(l => l.replace(/^>\s?/, ''));
-        if (callout) {
-            const type = callout[1].toUpperCase();
-            const firstLineRest = callout[2] || '';
-            const rest = lines.slice(1).join(' ').trim();
-            const text = [firstLineRest, rest].filter(Boolean).join(' ').trim();
-            return this.makeNote(type, text);
-        }
-        const text = lines.join(' ').trim();
-        return {
-            type: 'quote',
-            props: {
-                content: text,
-                size: 'medium',
-                color: 'medium',
-                bold: false,
-                showQuoteMark: true,
-                alignment: 'left',
-            },
-        };
     }
-    makeNote(kind, text) {
-        const map = {
-            NOTE: { color: 'primary', prefix: 'Nota' },
-            TIP: { color: 'success', prefix: 'Tip' },
-            INFO: { color: 'tertiary', prefix: 'Info' },
-            IMPORTANT: { color: 'warning', prefix: 'Importante' },
-            WARNING: { color: 'warning', prefix: 'Atención' },
-            CAUTION: { color: 'danger', prefix: 'Precaución' },
-        };
-        const cfg = map[kind];
+    return {
+        elements,
+        maxWidth: '900px',
+        centered: true,
+        theme: 'auto',
+        ...config,
+    };
+}
+function normalize(md) {
+    return md.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
+function startsNewBlock(line) {
+    return (HEADING_RE.test(line) ||
+        FENCE_RE.test(line) ||
+        SEPARATOR_RE.test(line) ||
+        TABLE_ROW_RE.test(line) ||
+        UNORDERED_RE.test(line) ||
+        ORDERED_RE.test(line) ||
+        CHECKLIST_RE.test(line) ||
+        line.startsWith('>') ||
+        BOX_DRAWING.test(line));
+}
+function makeHeading(level, content) {
+    if (level === 1) {
         return {
-            type: 'note',
-            props: {
-                text,
-                prefix: `${cfg.prefix}:`,
-                color: cfg.color,
-                textColor: 'dark',
-                size: 'medium',
-                rounded: true,
-            },
+            type: 'title',
+            props: { content, size: 'xlarge', color: 'dark', bold: true },
         };
     }
-    /**
-     * 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.
-     */
-    makeTable(rows) {
-        const parsed = rows
-            .filter(r => !TABLE_DIVIDER_RE.test(r))
-            .map(r => r
-            .trim()
-            .replace(/^\|/, '')
-            .replace(/\|$/, '')
-            .split('|')
-            .map(c => c.trim()));
-        if (parsed.length === 0)
-            return [];
-        const header = parsed[0];
-        const dataRows = parsed.slice(1);
-        if (dataRows.length === 0) {
-            return [
-                {
-                    type: 'paragraph',
-                    props: {
-                        content: header.join(' · '),
-                        size: 'medium',
-                        color: 'dark',
-                        bold: false,
-                        processLinks: true,
-                        allowPartialBold: true,
-                    },
-                },
-            ];
-        }
-        return dataRows.map(row => {
-            const pairs = row.map((cell, idx) => {
-                const key = header[idx] ?? '';
-                return key ? `**${key}:** ${cell}` : cell;
-            });
-            return {
+    const size = level === 2 ? 'large' : level === 3 ? 'medium' : 'small';
+    return {
+        type: 'subtitle',
+        props: { content, size, color: 'dark', bold: true },
+    };
+}
+function makeQuoteOrCallout(block) {
+    const first = block[0];
+    const callout = first.match(CALLOUT_RE);
+    const lines = block.map(l => l.replace(/^>\s?/, ''));
+    if (callout) {
+        const type = callout[1].toUpperCase();
+        const firstLineRest = callout[2] || '';
+        const rest = lines.slice(1).join(' ').trim();
+        const text = [firstLineRest, rest].filter(Boolean).join(' ').trim();
+        return makeNote(type, text);
+    }
+    const text = lines.join(' ').trim();
+    return {
+        type: 'quote',
+        props: {
+            content: text,
+            size: 'medium',
+            color: 'medium',
+            bold: false,
+            showQuoteMark: true,
+            alignment: 'left',
+        },
+    };
+}
+function makeNote(kind, text) {
+    const map = {
+        NOTE: { color: 'primary', prefix: 'Nota' },
+        TIP: { color: 'success', prefix: 'Tip' },
+        INFO: { color: 'tertiary', prefix: 'Info' },
+        IMPORTANT: { color: 'warning', prefix: 'Importante' },
+        WARNING: { color: 'warning', prefix: 'Atención' },
+        CAUTION: { color: 'danger', prefix: 'Precaución' },
+    };
+    const cfg = map[kind];
+    return {
+        type: 'note',
+        props: {
+            text,
+            prefix: `${cfg.prefix}:`,
+            color: cfg.color,
+            textColor: 'dark',
+            size: 'medium',
+            rounded: true,
+        },
+    };
+}
+function makeTable(rows) {
+    const parsed = rows
+        .filter(r => !TABLE_DIVIDER_RE.test(r))
+        .map(r => r
+        .trim()
+        .replace(/^\|/, '')
+        .replace(/\|$/, '')
+        .split('|')
+        .map(c => c.trim()));
+    if (parsed.length === 0)
+        return [];
+    const header = parsed[0];
+    const dataRows = parsed.slice(1);
+    if (dataRows.length === 0) {
+        return [
+            {
                 type: 'paragraph',
                 props: {
-                    content: pairs.join(' · '),
+                    content: header.join(' · '),
                     size: 'medium',
                     color: 'dark',
                     bold: false,
                     processLinks: true,
                     allowPartialBold: true,
                 },
-            };
+            },
+        ];
+    }
+    return dataRows.map(row => {
+        const pairs = row.map((cell, idx) => {
+            const key = header[idx] ?? '';
+            return key ? `**${key}:** ${cell}` : cell;
         });
+        return {
+            type: 'paragraph',
+            props: {
+                content: pairs.join(' · '),
+                size: 'medium',
+                color: 'dark',
+                bold: false,
+                processLinks: true,
+                allowPartialBold: true,
+            },
+        };
+    });
+}
+
+/**
+ * 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).
+ */
+class MarkdownArticleParserService {
+    parse(markdown, config) {
+        return parseMarkdownArticle(markdown, config);
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: MarkdownArticleParserService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: MarkdownArticleParserService, providedIn: 'root' }); }
@@ -35229,43 +35225,77 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImpo
             args: [{ providedIn: 'root' }]
         }] });
 
+const LEGAL_CONTENT_CONFIG = new InjectionToken('LEGAL_CONTENT_CONFIG');
 /**
- * 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.
  */
 class LegalContentService {
     constructor() {
         this.http = inject(HttpClient);
         this.parser = inject(MarkdownArticleParserService);
+        this.config = inject(LEGAL_CONTENT_CONFIG, { optional: true }) ?? {};
         this.DEFAULT_BASE = '/assets/legal';
         this.cache = new Map();
+        this.factoryCache = new Map();
     }
     load(slug, options = {}) {
         const locale = (options.locale ?? 'es').toLowerCase();
-        const base = options.basePath ?? this.DEFAULT_BASE;
-        const fallback = options.fallbackLocale === undefined ? 'es' : options.fallbackLocale;
-        const key = `${base}|${locale}|${slug}`;
+        const fallback = options.fallbackLocale === undefined
+            ? (this.config.fallbackLocale ?? 'es')
+            : options.fallbackLocale;
+        const key = `${locale}|${slug}`;
         const cached = this.cache.get(key);
         if (cached)
             return cached;
-        const primary = this.fetchAndParse(`${base}/${locale}/${slug}.md`);
+        const primary = this.loadOne(slug, locale, options.basePath);
         const stream = fallback && fallback !== locale
-            ? primary.pipe(catchError(() => this.fetchAndParse(`${base}/${fallback}/${slug}.md`)))
+            ? primary.pipe(catchError(() => this.loadOne(slug, fallback, options.basePath)))
             : primary;
         const shared = stream.pipe(shareReplay({ bufferSize: 1, refCount: false }));
         this.cache.set(key, shared);
         return shared;
     }
-    /** Returns the raw Markdown string without parsing. Useful for debugging. */
+    /** Raw Markdown — only available in runtime mode (HTTP). */
     raw(slug, options = {}) {
         const locale = (options.locale ?? 'es').toLowerCase();
-        const base = options.basePath ?? this.DEFAULT_BASE;
+        const base = options.basePath ?? this.config.basePath ?? this.DEFAULT_BASE;
         return this.http.get(`${base}/${locale}/${slug}.md`, { responseType: 'text' });
     }
-    /** Clears the in-memory cache. Call when the user changes locale at runtime. */
+    /** Clears in-memory caches. Call on runtime locale change. */
     invalidate() {
         this.cache.clear();
+        this.factoryCache.clear();
+    }
+    loadOne(slug, locale, basePathOverride) {
+        const factory = this.config.factories?.[locale];
+        if (factory) {
+            return from(this.runFactory(locale, factory)).pipe(switchMap(content => {
+                const article = content[slug];
+                return article
+                    ? of(article)
+                    : throwError(() => new Error(`Legal doc not found: ${locale}/${slug}`));
+            }));
+        }
+        const base = basePathOverride ?? this.config.basePath ?? this.DEFAULT_BASE;
+        return this.fetchAndParse(`${base}/${locale}/${slug}.md`);
+    }
+    runFactory(locale, factory) {
+        const cached = this.factoryCache.get(locale);
+        if (cached)
+            return cached;
+        const promise = factory();
+        this.factoryCache.set(locale, promise);
+        return promise;
     }
     fetchAndParse(url) {
         return this.http.get(url, { responseType: 'text' }).pipe(switchMap(md => md && md.trim().length > 0
@@ -35279,6 +35309,184 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImpo
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
+/**
+ * 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),
+ *   },
+ * })
+ */
+function provideLegalContent(config) {
+    return { provide: LEGAL_CONTENT_CONFIG, useValue: config };
+}
+
+/**
+ * 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.
+ */
+class PreferencesService {
+    constructor(config, firestore, auth, http, themeService, i18n) {
+        this.config = config;
+        this.firestore = firestore;
+        this.auth = auth;
+        this.http = http;
+        this.themeService = themeService;
+        this.i18n = i18n;
+        this._theme = signal('auto');
+        this._language = signal('es');
+        this._notificationsMaster = signal(true);
+        /** `true` después del primer snapshot Firestore. Antes, defaults sin side-effects. */
+        this._synced = signal(false);
+        this.theme = this._theme.asReadonly();
+        this.language = this._language.asReadonly();
+        this.notificationsMaster = this._notificationsMaster.asReadonly();
+        this.synced = this._synced.asReadonly();
+        const destroyRef = inject(DestroyRef);
+        destroyRef.onDestroy(() => this.unbind());
+        // Auto-bind al user actual. effect() corre en injection context (constructor OK).
+        effect(() => {
+            const user = this.auth.user();
+            if (user?.userId) {
+                this.bindToUser(user.userId);
+            }
+            else {
+                this.unbind();
+            }
+        });
+        // Side-effect: aplicar theme local cuando llega snapshot real.
+        effect(() => {
+            if (!this._synced())
+                return;
+            const t = this._theme();
+            if (this.themeService) {
+                this.themeService.Theme = t;
+            }
+        });
+        // Side-effect: aplicar language local cuando llega snapshot real.
+        effect(() => {
+            if (!this._synced())
+                return;
+            const l = this._language();
+            if (this.i18n && this.i18n.lang() !== l) {
+                this.i18n.setLanguage(l);
+            }
+        });
+    }
+    /** Actualiza preferencias via backend. Optimistic UI: aplica local, revierte si falla. */
+    async update(partial) {
+        const url = `${this.config.apiUrl}/v2/auth/preferences`;
+        const prev = {
+            theme: this._theme(),
+            language: this._language(),
+            master: this._notificationsMaster(),
+        };
+        if (partial.theme)
+            this._theme.set(partial.theme);
+        if (partial.language)
+            this._language.set(partial.language);
+        if (partial.notifications && typeof partial.notifications.master === 'boolean') {
+            this._notificationsMaster.set(partial.notifications.master);
+        }
+        try {
+            const res = await firstValueFrom(this.http.put(url, partial));
+            // El listener Firestore es la fuente final, pero alinear ya con la
+            // respuesta del backend acelera UX (especialmente si el listener
+            // tarda en propagar).
+            if (res.theme)
+                this._theme.set(res.theme);
+            if (res.language)
+                this._language.set(res.language);
+            if (typeof res.notifications?.master === 'boolean') {
+                this._notificationsMaster.set(res.notifications.master);
+            }
+            return res;
+        }
+        catch (err) {
+            // Revert optimistic.
+            this._theme.set(prev.theme);
+            this._language.set(prev.language);
+            this._notificationsMaster.set(prev.master);
+            throw err;
+        }
+    }
+    setTheme(theme) {
+        return this.update({ theme });
+    }
+    setLanguage(language) {
+        return this.update({ language });
+    }
+    setNotificationsMaster(enabled) {
+        return this.update({ notifications: { master: enabled } });
+    }
+    bindToUser(userId) {
+        if (this.currentUserId === userId && this.subscription)
+            return;
+        this.unbind();
+        this.currentUserId = userId;
+        // FirestoreService.docChanges prefija automáticamente `apps/{appId}/`
+        // cuando `config.appId` está seteado en ValtechAuthConfig.
+        this.subscription = this.firestore
+            .docChanges(`users/${userId}/preferences`, 'main')
+            .subscribe(doc => {
+            if (!doc) {
+                // Doc no existe aún (user nuevo, sin primer sync). Mantenemos
+                // defaults locales pero NO marcamos synced — los side-effects no
+                // pisan el theme/lang locales con valores arbitrarios.
+                return;
+            }
+            if (doc.theme)
+                this._theme.set(doc.theme);
+            if (doc.language)
+                this._language.set(doc.language);
+            if (doc.notifications && typeof doc.notifications.master === 'boolean') {
+                this._notificationsMaster.set(doc.notifications.master);
+            }
+            this._synced.set(true);
+        });
+    }
+    unbind() {
+        this.subscription?.unsubscribe();
+        this.subscription = undefined;
+        this.currentUserId = undefined;
+        this._synced.set(false);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: PreferencesService, deps: [{ token: VALTECH_AUTH_CONFIG }, { token: FirestoreService }, { token: AuthService }, { token: i1$8.HttpClient }, { token: ThemeService, optional: true }, { token: I18nService, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: PreferencesService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: PreferencesService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: undefined, decorators: [{
+                    type: Inject,
+                    args: [VALTECH_AUTH_CONFIG]
+                }] }, { type: FirestoreService }, { type: AuthService }, { type: i1$8.HttpClient }, { type: ThemeService, decorators: [{
+                    type: Optional
+                }] }, { type: I18nService, decorators: [{
+                    type: Optional
+                }] }] });
+
+/**
+ * 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.
+ */
 
 /**
  * Cross-Platform Version Helpers
@@ -42427,5 +42635,5 @@ function buildFooterLinks(links, t) {
  * Generated bundle index. Do not edit.
  */
 
-export { ACTION_CARD_DEFAULTS, AD_SIZE_MAP, API_TABLE_COLUMN_LABELS, ARTICLE_SPACING, AVATAR_UPLOAD_DEFAULTS, AccordionComponent, ActionCardComponent, ActionHeaderComponent, ActionType, AdSlotComponent, AdsLoaderService, AdsService, AlertBoxComponent, AnalyticsErrorHandler, AnalyticsRouterTracker, AnalyticsService, AppConfigService, ArticleBuilder, ArticleComponent, AuthBackgroundComponent, AuthService, AuthStateService, AuthStorageService, AuthSyncService, AvatarComponent, AvatarUploadComponent, BOTTOM_NAV_DEFAULTS, BannerComponent, BaseDefault, BlogPostBuilder, BottomNavComponent, BoxComponent, BreadcrumbComponent, ButtonComponent, ButtonGroupComponent, COMMON_COUNTRY_CODES, COMMON_CURRENCIES, CURRENCY_INFO, CardComponent, CardSection, CardType, CardsCarouselComponent, CheckInputComponent, CheckboxRadioInputComponent, ChipGroupComponent, ClearDefault, ClearDefaultBlock, ClearDefaultFull, ClearDefaultRound, ClearDefaultRoundBlock, ClearDefaultRoundFull, CodeDisplayComponent, CommandDisplayComponent, CommentComponent, CommentInputComponent, CommentSectionComponent, CompanyFooterComponent, ComponentStates, ConfirmationDialogService, ContainerComponent, ContentLoaderComponent, ContentReactionComponent, ContentTransformer, CountdownComponent, CurrencyInputComponent, DEFAULT_ADS_CONFIG, DEFAULT_APP_CONFIG_SERVICE_CONFIG, DEFAULT_AUTH_CONFIG, DEFAULT_BACK_HEADER, DEFAULT_CANCEL_BUTTON, DEFAULT_CONFIRM_BUTTON, DEFAULT_COUNTDOWN_LABELS, DEFAULT_COUNTDOWN_LABELS_EN, DEFAULT_EMPTY_STATE, DEFAULT_EMULATOR_CONFIG, DEFAULT_FEEDBACK_CONFIG, DEFAULT_FEEDBACK_TYPE_OPTIONS, DEFAULT_HOME_HEADER, DEFAULT_INFINITE_LIST_METADATA, DEFAULT_MODAL_CANCEL_BUTTON, DEFAULT_MODAL_CONFIRM_BUTTON, DEFAULT_PAGE_SIZE_OPTIONS, DEFAULT_PLATFORMS, DEFAULT_REFRESHER_METADATA, DEFAULT_SKELETON_CONFIG, DataTableComponent, DateInputComponent, DateRangeInputComponent, DetailSkeletonComponent, DeviceService, DisplayComponent, DividerComponent, DocsApiTableComponent, DocsBreadcrumbComponent, DocsBuilder, DocsCalloutComponent, DocsCodeExampleComponent, DocsLayoutComponent, DocsNavLinksComponent, DocsNavigationService, DocsPageComponent, DocsSearchComponent, DocsSectionComponent, DocsShellComponent, DocsSidebarComponent, DocsTocComponent, DownloadService, EmailInputComponent, ExpandableTextComponent, FEATURES_LIST_DEFAULTS, FabComponent, FeaturesListComponent, FeedbackFormComponent, FeedbackService, FileInputComponent, FirebaseService, FirestoreCollectionFactory, FirestoreService, FooterComponent, FooterLinksComponent, FormComponent, FormFooterComponent, FormSkeletonComponent, FunHeaderComponent, GlowCardComponent, GridSkeletonComponent, HANDOFF_ROUTE_PARAM, HANDOFF_TOKEN_PARAM, HandoffService, HeaderComponent, HintComponent, HorizontalScrollComponent, HourInputComponent, HrefComponent, I18nService, IMAGE_DEFAULTS, INITIAL_AUTH_STATE, INITIAL_MFA_STATE, Icon, IconComponent, IconService, ImageComponent, ImageCropComponent, ImageService, InAppBrowserService, InfiniteListComponent, InfoComponent, InputI18nHelper, InputType, ItemListComponent, LANG_STORAGE_KEY$1 as LANG_STORAGE_KEY, LOGIN_DEFAULTS, LanguageSelectorComponent, LayeredCardComponent, LegalContentService, LinkComponent, LinkProcessorService, LinkedProvidersComponent, LinksAccordionComponent, LinksCakeComponent, ListSkeletonComponent, LoadingDirective, LocalStorageService, LocaleService, LoginComponent, MODAL_SIZES, MOTION, MaintenancePageComponent, MarkdownArticleParserService, MenuComponent, MessagingService, MetaService, ModalService, MultiSelectSearchComponent, NavigationService, NewsBuilder, NoContentComponent, NotesBoxComponent, NotificationActionService, NotificationsService, NumberFromToComponent, NumberInputComponent, NumberStepperComponent, OAUTH_PROVIDERS_INFO, OAuthCallbackComponent, OAuthService, OrgSwitchService, OutlineDefault, OutlineDefaultBlock, OutlineDefaultFull, OutlineDefaultRound, OutlineDefaultRoundBlock, OutlineDefaultRoundFull, PLATFORM_CONFIGS, PageContentComponent, PageTemplateComponent, PageWrapperComponent, PaginationComponent, PaginationService, PasswordInputComponent, PhoneInputComponent, PillComponent, PinInputComponent, PlainCodeBoxComponent, PopoverSelectorComponent, PresetService, PriceTagComponent, PrimarySolidBlockButton, PrimarySolidBlockHrefButton, PrimarySolidBlockIconButton, PrimarySolidBlockIconHrefButton, PrimarySolidDefaultRoundButton, PrimarySolidDefaultRoundHrefButton, PrimarySolidDefaultRoundIconButton, PrimarySolidDefaultRoundIconHrefButton, PrimarySolidFullButton, PrimarySolidFullHrefButton, PrimarySolidFullIconButton, PrimarySolidFullIconHrefButton, PrimarySolidLargeRoundButton, PrimarySolidLargeRoundHrefButton, PrimarySolidLargeRoundIconButton, PrimarySolidLargeRoundIconHrefButton, PrimarySolidSmallRoundButton, PrimarySolidSmallRoundHrefButton, PrimarySolidSmallRoundIconButton, PrimarySolidSmallRoundIconHrefButton, ProcessLinksPipe, ProfileSkeletonComponent, ProgressBarComponent, ProgressRingComponent, ProgressStatusComponent, PrompterComponent, QR_PRESETS, QrCodeComponent, QrGeneratorService, QueryBuilder, QuoteBoxComponent, RadioInputComponent, RangeInputComponent, RatingComponent, RefresherComponent, RightsFooterComponent, RotatingTextComponent, SKELETON_PRESETS, SearchSelectorComponent, SearchbarComponent, SecondarySolidBlockButton, SecondarySolidBlockHrefButton, SecondarySolidBlockIconButton, SecondarySolidBlockIconHrefButton, SecondarySolidDefaultRoundButton, SecondarySolidDefaultRoundHrefButton, SecondarySolidDefaultRoundIconButton, SecondarySolidDefaultRoundIconHrefButton, SecondarySolidFullButton, SecondarySolidFullHrefButton, SecondarySolidFullIconButton, SecondarySolidFullIconHrefButton, SecondarySolidLargeRoundButton, SecondarySolidLargeRoundHrefButton, SecondarySolidLargeRoundIconButton, SecondarySolidLargeRoundIconHrefButton, SecondarySolidSmallRoundButton, SecondarySolidSmallRoundHrefButton, SecondarySolidSmallRoundIconButton, SecondarySolidSmallRoundIconHrefButton, SegmentControlComponent, SelectSearchComponent, SessionService, ShareButtonsComponent, SimpleComponent, SkeletonComponent, SkeletonService, SolidBlockButton, SolidDefault, SolidDefaultBlock, SolidDefaultButton, SolidDefaultFull, SolidDefaultRound, SolidDefaultRoundBlock, SolidDefaultRoundButton, SolidDefaultRoundFull, SolidFullButton, SolidLargeButton, SolidLargeRoundButton, SolidSmallButton, SolidSmallRoundButton, StatsCardComponent, StepperComponent, StorageService, SwipeCarouselComponent, TabbedContentComponent, TableSkeletonComponent, TabsComponent, Terminal404Component, TestimonialCardComponent, TestimonialCarouselComponent, TextComponent, TextInputComponent, TextareaInputComponent, ThemeOption, ThemeService, TimelineComponent, TitleBlockComponent, TitleComponent, ToastService, ToggleInputComponent, TokenService, ToolbarActionType, ToolbarComponent, TranslatePipe, TypedCollection, UpdateBannerComponent, UsernameInputComponent, VALTECH_ADS_CONFIG, VALTECH_APP_CONFIG, VALTECH_AUTH_CONFIG, VALTECH_COMPANY_LINKS, VALTECH_DEFAULT_CONTENT, VALTECH_FEEDBACK_CONFIG, VALTECH_FIREBASE_CONFIG, VALTECH_FOOTER_I18N, VALTECH_FOOTER_LOGO, VALTECH_LANGUAGE_SELECTOR, VALTECH_SOCIAL_LINKS, VERSION, WizardComponent, WizardFooterComponent, applyDefaultValueToControl, authGuard, authInterceptor, blogPost, buildFooterLinks, buildPath, collections, createFirebaseConfig, createGlowCardProps, createInitialPaginationState, createNumberFromToField, createTitleProps, docs, extractPathParams, getAppInfo, getAppVersion, getCollectionPath, getDocumentId, getTimeOfDayKey, goToTop, guestGuard, hasEmulators, isAtEnd, isCollectionPath, isDocumentPath, isEmulatorMode, isValidPath, joinPath, maxLength, news, permissionGuard, permissionGuardFromRoute, provideValtechAds, provideValtechAppConfig, provideValtechAuth, provideValtechAuthInterceptor, provideValtechFeedback, provideValtechFirebase, provideValtechI18n, provideValtechPresets, provideValtechSkeleton, query, replaceSpecialChars, resolveColor, resolveInputDefaultValue, roleGuard, storagePaths, superAdminGuard, toArticle };
+export { ACTION_CARD_DEFAULTS, AD_SIZE_MAP, API_TABLE_COLUMN_LABELS, ARTICLE_SPACING, AVATAR_UPLOAD_DEFAULTS, AccordionComponent, ActionCardComponent, ActionHeaderComponent, ActionType, AdSlotComponent, AdsLoaderService, AdsService, AlertBoxComponent, AnalyticsErrorHandler, AnalyticsRouterTracker, AnalyticsService, AppConfigService, ArticleBuilder, ArticleComponent, AuthBackgroundComponent, AuthService, AuthStateService, AuthStorageService, AuthSyncService, AvatarComponent, AvatarUploadComponent, BOTTOM_NAV_DEFAULTS, BannerComponent, BaseDefault, BlogPostBuilder, BottomNavComponent, BoxComponent, BreadcrumbComponent, ButtonComponent, ButtonGroupComponent, COMMON_COUNTRY_CODES, COMMON_CURRENCIES, CURRENCY_INFO, CardComponent, CardSection, CardType, CardsCarouselComponent, CheckInputComponent, CheckboxRadioInputComponent, ChipGroupComponent, ClearDefault, ClearDefaultBlock, ClearDefaultFull, ClearDefaultRound, ClearDefaultRoundBlock, ClearDefaultRoundFull, CodeDisplayComponent, CommandDisplayComponent, CommentComponent, CommentInputComponent, CommentSectionComponent, CompanyFooterComponent, ComponentStates, ConfirmationDialogService, ContainerComponent, ContentLoaderComponent, ContentReactionComponent, ContentTransformer, CountdownComponent, CurrencyInputComponent, DEFAULT_ADS_CONFIG, DEFAULT_APP_CONFIG_SERVICE_CONFIG, DEFAULT_AUTH_CONFIG, DEFAULT_BACK_HEADER, DEFAULT_CANCEL_BUTTON, DEFAULT_CONFIRM_BUTTON, DEFAULT_COUNTDOWN_LABELS, DEFAULT_COUNTDOWN_LABELS_EN, DEFAULT_EMPTY_STATE, DEFAULT_EMULATOR_CONFIG, DEFAULT_FEEDBACK_CONFIG, DEFAULT_FEEDBACK_TYPE_OPTIONS, DEFAULT_HOME_HEADER, DEFAULT_INFINITE_LIST_METADATA, DEFAULT_MODAL_CANCEL_BUTTON, DEFAULT_MODAL_CONFIRM_BUTTON, DEFAULT_PAGE_SIZE_OPTIONS, DEFAULT_PLATFORMS, DEFAULT_REFRESHER_METADATA, DEFAULT_SKELETON_CONFIG, DataTableComponent, DateInputComponent, DateRangeInputComponent, DetailSkeletonComponent, DeviceService, DisplayComponent, DividerComponent, DocsApiTableComponent, DocsBreadcrumbComponent, DocsBuilder, DocsCalloutComponent, DocsCodeExampleComponent, DocsLayoutComponent, DocsNavLinksComponent, DocsNavigationService, DocsPageComponent, DocsSearchComponent, DocsSectionComponent, DocsShellComponent, DocsSidebarComponent, DocsTocComponent, DownloadService, EmailInputComponent, ExpandableTextComponent, FEATURES_LIST_DEFAULTS, FabComponent, FeaturesListComponent, FeedbackFormComponent, FeedbackService, FileInputComponent, FirebaseService, FirestoreCollectionFactory, FirestoreService, FooterComponent, FooterLinksComponent, FormComponent, FormFooterComponent, FormSkeletonComponent, FunHeaderComponent, GlowCardComponent, GridSkeletonComponent, HANDOFF_ROUTE_PARAM, HANDOFF_TOKEN_PARAM, HandoffService, HeaderComponent, HintComponent, HorizontalScrollComponent, HourInputComponent, HrefComponent, I18nService, IMAGE_DEFAULTS, INITIAL_AUTH_STATE, INITIAL_MFA_STATE, Icon, IconComponent, IconService, ImageComponent, ImageCropComponent, ImageService, InAppBrowserService, InfiniteListComponent, InfoComponent, InputI18nHelper, InputType, ItemListComponent, LANG_STORAGE_KEY$1 as LANG_STORAGE_KEY, LEGAL_CONTENT_CONFIG, LOGIN_DEFAULTS, LanguageSelectorComponent, LayeredCardComponent, LegalContentService, LinkComponent, LinkProcessorService, LinkedProvidersComponent, LinksAccordionComponent, LinksCakeComponent, ListSkeletonComponent, LoadingDirective, LocalStorageService, LocaleService, LoginComponent, MODAL_SIZES, MOTION, MaintenancePageComponent, MarkdownArticleParserService, MenuComponent, MessagingService, MetaService, ModalService, MultiSelectSearchComponent, NavigationService, NewsBuilder, NoContentComponent, NotesBoxComponent, NotificationActionService, NotificationsService, NumberFromToComponent, NumberInputComponent, NumberStepperComponent, OAUTH_PROVIDERS_INFO, OAuthCallbackComponent, OAuthService, OrgSwitchService, OutlineDefault, OutlineDefaultBlock, OutlineDefaultFull, OutlineDefaultRound, OutlineDefaultRoundBlock, OutlineDefaultRoundFull, PLATFORM_CONFIGS, PageContentComponent, PageTemplateComponent, PageWrapperComponent, PaginationComponent, PaginationService, PasswordInputComponent, PhoneInputComponent, PillComponent, PinInputComponent, PlainCodeBoxComponent, PopoverSelectorComponent, PreferencesService, PresetService, PriceTagComponent, PrimarySolidBlockButton, PrimarySolidBlockHrefButton, PrimarySolidBlockIconButton, PrimarySolidBlockIconHrefButton, PrimarySolidDefaultRoundButton, PrimarySolidDefaultRoundHrefButton, PrimarySolidDefaultRoundIconButton, PrimarySolidDefaultRoundIconHrefButton, PrimarySolidFullButton, PrimarySolidFullHrefButton, PrimarySolidFullIconButton, PrimarySolidFullIconHrefButton, PrimarySolidLargeRoundButton, PrimarySolidLargeRoundHrefButton, PrimarySolidLargeRoundIconButton, PrimarySolidLargeRoundIconHrefButton, PrimarySolidSmallRoundButton, PrimarySolidSmallRoundHrefButton, PrimarySolidSmallRoundIconButton, PrimarySolidSmallRoundIconHrefButton, ProcessLinksPipe, ProfileSkeletonComponent, ProgressBarComponent, ProgressRingComponent, ProgressStatusComponent, PrompterComponent, QR_PRESETS, QrCodeComponent, QrGeneratorService, QueryBuilder, QuoteBoxComponent, RadioInputComponent, RangeInputComponent, RatingComponent, RefresherComponent, RightsFooterComponent, RotatingTextComponent, SKELETON_PRESETS, SearchSelectorComponent, SearchbarComponent, SecondarySolidBlockButton, SecondarySolidBlockHrefButton, SecondarySolidBlockIconButton, SecondarySolidBlockIconHrefButton, SecondarySolidDefaultRoundButton, SecondarySolidDefaultRoundHrefButton, SecondarySolidDefaultRoundIconButton, SecondarySolidDefaultRoundIconHrefButton, SecondarySolidFullButton, SecondarySolidFullHrefButton, SecondarySolidFullIconButton, SecondarySolidFullIconHrefButton, SecondarySolidLargeRoundButton, SecondarySolidLargeRoundHrefButton, SecondarySolidLargeRoundIconButton, SecondarySolidLargeRoundIconHrefButton, SecondarySolidSmallRoundButton, SecondarySolidSmallRoundHrefButton, SecondarySolidSmallRoundIconButton, SecondarySolidSmallRoundIconHrefButton, SegmentControlComponent, SelectSearchComponent, SessionService, ShareButtonsComponent, SimpleComponent, SkeletonComponent, SkeletonService, SolidBlockButton, SolidDefault, SolidDefaultBlock, SolidDefaultButton, SolidDefaultFull, SolidDefaultRound, SolidDefaultRoundBlock, SolidDefaultRoundButton, SolidDefaultRoundFull, SolidFullButton, SolidLargeButton, SolidLargeRoundButton, SolidSmallButton, SolidSmallRoundButton, StatsCardComponent, StepperComponent, StorageService, SwipeCarouselComponent, TabbedContentComponent, TableSkeletonComponent, TabsComponent, Terminal404Component, TestimonialCardComponent, TestimonialCarouselComponent, TextComponent, TextInputComponent, TextareaInputComponent, ThemeOption, ThemeService, TimelineComponent, TitleBlockComponent, TitleComponent, ToastService, ToggleInputComponent, TokenService, ToolbarActionType, ToolbarComponent, TranslatePipe, TypedCollection, UpdateBannerComponent, UsernameInputComponent, VALTECH_ADS_CONFIG, VALTECH_APP_CONFIG, VALTECH_AUTH_CONFIG, VALTECH_COMPANY_LINKS, VALTECH_DEFAULT_CONTENT, VALTECH_FEEDBACK_CONFIG, VALTECH_FIREBASE_CONFIG, VALTECH_FOOTER_I18N, VALTECH_FOOTER_LOGO, VALTECH_LANGUAGE_SELECTOR, VALTECH_SOCIAL_LINKS, VERSION, WizardComponent, WizardFooterComponent, applyDefaultValueToControl, authGuard, authInterceptor, blogPost, buildFooterLinks, buildPath, collections, createFirebaseConfig, createGlowCardProps, createInitialPaginationState, createNumberFromToField, createTitleProps, docs, extractPathParams, getAppInfo, getAppVersion, getCollectionPath, getDocumentId, getTimeOfDayKey, goToTop, guestGuard, hasEmulators, isAtEnd, isCollectionPath, isDocumentPath, isEmulatorMode, isValidPath, joinPath, maxLength, news, parseMarkdownArticle, permissionGuard, permissionGuardFromRoute, provideLegalContent, provideValtechAds, provideValtechAppConfig, provideValtechAuth, provideValtechAuthInterceptor, provideValtechFeedback, provideValtechFirebase, provideValtechI18n, provideValtechPresets, provideValtechSkeleton, query, replaceSpecialChars, resolveColor, resolveInputDefaultValue, roleGuard, storagePaths, superAdminGuard, toArticle };
 //# sourceMappingURL=valtech-components.mjs.map