valtech-components 2.0.809 → 2.0.812

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

@@ -0,0 +1,46 @@
+import { ArticleMetadata } from '../article/types';
+import { FaqCategory, FaqItem, FaqMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-faq`
+ *
+ * Organism de preguntas frecuentes. Q&A categorizado con accordion colapsable
+ * y buscador en vivo. Pensado para vistas FAQ públicas — el caller puede
+ * reusar la misma data (`FaqMetadata.categories`) para emitir el structured
+ * data `FAQPage` (JSON-LD) y ganar rich results en buscadores.
+ *
+ * Las respuestas (`FaqItem.answer`) son **Markdown** — se parsean con
+ * `parseMarkdownArticle` y se renderizan vía `val-article`. Soportan links,
+ * listas, negritas, tablas, etc.
+ *
+ * @example
+ * ```html
+ * <val-faq [props]="{ categories: faqCategories, searchable: true }" />
+ * ```
+ */
+export declare class FaqComponent {
+    private readonly props_;
+    set props(value: FaqMetadata | undefined);
+    get props(): FaqMetadata;
+    /** Término de búsqueda actual. */
+    private readonly query;
+    /**
+     * Cache de respuestas parseadas (Markdown → ArticleMetadata). Se reconstruye
+     * solo cuando cambian las categorías — el parseo NO corre por keystroke.
+     * Keyed por id de item (los ids son únicos en toda la FAQ).
+     */
+    private readonly parsedAnswers;
+    /** Respuesta parseada de un item — desde el cache. */
+    answerOf(item: FaqItem): ArticleMetadata;
+    /**
+     * Categorías visibles tras el filtro. Una categoría desaparece si ninguna
+     * de sus preguntas matchea. Match sobre pregunta + respuesta (raw markdown),
+     * case-insensitive.
+     */
+    readonly visibleCategories: import("@angular/core").Signal<FaqCategory[]>;
+    /** `true` si se debe mostrar el label de cada categoría. */
+    readonly showCategoryLabel: import("@angular/core").Signal<boolean>;
+    onSearch(term: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FaqComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FaqComponent, "val-faq", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/faq/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Tipos del organism `val-faq`.
+ *
+ * Modelo Q&A categorizado. Pensado para vistas FAQ públicas (sitio corporativo)
+ * — el caller también puede usar la misma data para emitir structured data
+ * `FAQPage` (JSON-LD) y ganar rich results en buscadores.
+ */
+/** Una pregunta-respuesta. */
+export interface FaqItem {
+    /** Identificador único dentro de la FAQ — usado como track + accordion value. */
+    id: string;
+    /** La pregunta. */
+    question: string;
+    /** La respuesta. Texto plano (los saltos de línea se respetan). */
+    answer: string;
+}
+/** Grupo de preguntas bajo un tema. */
+export interface FaqCategory {
+    /** Identificador único de la categoría. */
+    id: string;
+    /** Etiqueta visible del grupo. */
+    label: string;
+    /** Preguntas del grupo. */
+    items: FaqItem[];
+}
+/**
+ * Configuración del organism `val-faq`.
+ *
+ * @example
+ * ```html
+ * <val-faq
+ *   [props]="{
+ *     categories: faqCategories,
+ *     searchable: true,
+ *     searchPlaceholder: 'Buscar...',
+ *   }"
+ * />
+ * ```
+ */
+export interface FaqMetadata {
+    /** Categorías con sus preguntas, en orden de aparición. */
+    categories: FaqCategory[];
+    /** Muestra el buscador que filtra preguntas en vivo. Default `true`. */
+    searchable?: boolean;
+    /** Placeholder del buscador. */
+    searchPlaceholder?: string;
+    /** Permite varias preguntas abiertas a la vez. Default `false`. */
+    multiple?: boolean;
+    /** Texto cuando la búsqueda no arroja resultados. */
+    noResultsText?: string;
+    /** Oculta el label de categoría cuando solo hay una. Default `true`. */
+    hideSingleCategoryLabel?: 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.809";
+export declare const VERSION = "2.0.812";

package/package.json

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

package/public-api.d.ts

@@ -226,6 +226,8 @@ export * from './lib/components/organisms/avatar-upload/avatar-upload.component'
 export * from './lib/components/organisms/avatar-upload/types';
 export * from './lib/components/organisms/skeleton-layout/skeleton-layout.component';
 export * from './lib/components/organisms/skeleton-layout/types';
+export * from './lib/components/organisms/faq/faq.component';
+export * from './lib/components/organisms/faq/types';
 export * from './lib/components/templates/simple/simple.component';
 export * from './lib/components/templates/simple/types';
 export * from './lib/components/templates/page-template/page-template.component';