@caribeng/ui 22.1.1 → 22.4.0

package/schematics/ng-add/index.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CARIBENG_STYLES = void 0;
+exports.ngAdd = ngAdd;
+exports.providerConfig = providerConfig;
+exports.projectSourceRoot = projectSourceRoot;
+exports.addStyles = addStyles;
+exports.containsText = containsText;
+const schematics_1 = require("@angular-devkit/schematics");
+const utility_1 = require("@schematics/angular/utility");
+/** Hoja de estilos de CaribeNG (export `./styles.css` del paquete). */
+exports.CARIBENG_STYLES = '@caribeng/ui/styles.css';
+/** Otras formas de referirse a la misma hoja (si ya está, no se duplica). */
+const STYLE_ALIASES = [
+    exports.CARIBENG_STYLES,
+    '@caribeng/ui/styles/caribeng.css',
+    'node_modules/@caribeng/ui/styles/caribeng.css',
+    './node_modules/@caribeng/ui/styles/caribeng.css',
+];
+/** Targets de angular.json que llevan la lista de estilos globales. */
+const STYLE_TARGETS = ['build', 'test'];
+/**
+ * `ng add @caribeng/ui`: registra `provideCaribeNG()` con el idioma, tema y
+ * paleta elegidos, y añade la hoja de estilos a `angular.json`. Es idempotente:
+ * ejecutarlo dos veces no duplica el proveedor ni los estilos.
+ */
+function ngAdd(options) {
+    return async (tree, context) => {
+        const project = await resolveProject(tree, options.project);
+        const sourceRoot = await projectSourceRoot(tree, project);
+        const hasProvider = containsText(tree, sourceRoot, 'provideCaribeNG(');
+        if (hasProvider) {
+            context.logger.info('ℹ provideCaribeNG() ya está configurado: no se modifica.');
+        }
+        return (0, schematics_1.chain)([
+            options.styles === false ? (0, schematics_1.noop)() : addStyles(project),
+            hasProvider
+                ? (0, schematics_1.noop)()
+                : (0, utility_1.addRootProvider)(project, ({ code, external }) => code `${external('provideCaribeNG', '@caribeng/ui')}(${providerConfig(options)})`),
+            logNextSteps(options),
+        ]);
+    };
+}
+/** Configuración de `provideCaribeNG()` con las opciones elegidas. */
+function providerConfig(options) {
+    return `{ locale: '${options.locale ?? 'es'}', theme: '${options.theme ?? 'light'}', preset: '${options.preset ?? 'emerald'}' }`;
+}
+/** Proyecto indicado o, si no se indica, la aplicación del workspace (la primera si hay varias). */
+async function resolveProject(tree, name) {
+    const workspace = await (0, utility_1.readWorkspace)(tree);
+    if (name) {
+        if (!workspace.projects.has(name))
+            throw new schematics_1.SchematicsException(`No existe el proyecto "${name}" en angular.json.`);
+        return name;
+    }
+    const apps = [...workspace.projects.entries()].filter(([, p]) => p.extensions['projectType'] === 'application');
+    if (!apps.length)
+        throw new schematics_1.SchematicsException('No hay ninguna aplicación en angular.json. Indica una con --project.');
+    return apps[0][0];
+}
+async function projectSourceRoot(tree, name) {
+    const project = (await (0, utility_1.readWorkspace)(tree)).projects.get(name);
+    return project.sourceRoot ?? `${project.root ? project.root + '/' : ''}src`;
+}
+/** Añade la hoja de estilos al principio de `styles` (los estilos propios de la app la pueden sobrescribir). */
+function addStyles(projectName) {
+    return (0, utility_1.updateWorkspace)((workspace) => {
+        const project = workspace.projects.get(projectName);
+        if (!project)
+            return;
+        for (const targetName of STYLE_TARGETS) {
+            const target = project.targets.get(targetName);
+            if (!target)
+                continue;
+            target.options ??= {};
+            const styles = Array.isArray(target.options['styles']) ? [...target.options['styles']] : [];
+            const present = styles.some((entry) => STYLE_ALIASES.includes(styleInput(entry)));
+            if (!present)
+                target.options['styles'] = [exports.CARIBENG_STYLES, ...styles];
+        }
+    });
+}
+/** `styles` admite cadenas u objetos `{ input, bundleName, inject }`. */
+function styleInput(entry) {
+    if (typeof entry === 'string')
+        return entry;
+    if (entry && typeof entry === 'object' && typeof entry.input === 'string') {
+        return entry.input;
+    }
+    return '';
+}
+/** Busca un texto en los `.ts` del proyecto (para no registrar el proveedor dos veces). */
+function containsText(tree, root, text) {
+    let found = false;
+    tree.getDir(root).visit((path) => {
+        if (found || !path.endsWith('.ts') || path.endsWith('.spec.ts'))
+            return;
+        found = tree.readText(path).includes(text);
+    });
+    return found;
+}
+function logNextSteps(options) {
+    return (tree, context) => {
+        const es = options.locale !== 'en';
+        const lines = es
+            ? [
+                '',
+                '✔ CaribeNG está listo.',
+                '',
+                '  Importa los componentes desde su entry point, por ejemplo:',
+                "    import { CbButton } from '@caribeng/ui/button';",
+                '',
+                '  Documentación y catálogo: https://github.com/caribeng/ui#readme',
+                '',
+            ]
+            : [
+                '',
+                '✔ CaribeNG is ready.',
+                '',
+                '  Import components from their entry point, for example:',
+                "    import { CbButton } from '@caribeng/ui/button';",
+                '',
+                '  Docs and catalog: https://github.com/caribeng/ui#readme',
+                '',
+            ];
+        lines.forEach((line) => context.logger.info(line));
+        if (usesPrimeng(tree)) {
+            context.logger.warn(es
+                ? '⚠ Este proyecto usa PrimeNG. Para migrar sus componentes a CaribeNG ejecuta:\n    ng generate @caribeng/ui:migrate-from-primeng'
+                : '⚠ This project uses PrimeNG. To migrate its components to CaribeNG run:\n    ng generate @caribeng/ui:migrate-from-primeng');
+        }
+    };
+}
+/** `primeng` aparece en las dependencias del package.json raíz. */
+function usesPrimeng(tree) {
+    if (!tree.exists('/package.json'))
+        return false;
+    const pkg = JSON.parse(tree.readText('/package.json'));
+    return Boolean(pkg['dependencies']?.['primeng'] ?? pkg['devDependencies']?.['primeng']);
+}

package/schematics/ng-add/schema.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/schematics/ng-add/schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "caribeng-ng-add",
+  "title": "CaribeNG ng-add",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "Proyecto (aplicación) donde configurar CaribeNG. Por defecto, la única aplicación del workspace.",
+      "$default": { "$source": "projectName" }
+    },
+    "locale": {
+      "type": "string",
+      "description": "Idioma de los textos de interfaz de los componentes.",
+      "enum": ["es", "en"],
+      "default": "es",
+      "x-prompt": {
+        "message": "Idioma de los componentes / Component language:",
+        "type": "list",
+        "items": [
+          { "value": "es", "label": "Español" },
+          { "value": "en", "label": "English" }
+        ]
+      }
+    },
+    "theme": {
+      "type": "string",
+      "description": "Tema inicial: claro, oscuro o el del sistema operativo.",
+      "enum": ["light", "dark", "system"],
+      "default": "light",
+      "x-prompt": {
+        "message": "Tema / Theme:",
+        "type": "list",
+        "items": [
+          { "value": "light", "label": "Claro / Light" },
+          { "value": "dark", "label": "Oscuro / Dark" },
+          { "value": "system", "label": "El del sistema / System" }
+        ]
+      }
+    },
+    "preset": {
+      "type": "string",
+      "description": "Paleta de color primaria.",
+      "enum": ["emerald", "ocean", "coral", "amber", "violet", "rose"],
+      "default": "emerald",
+      "x-prompt": {
+        "message": "Color primario / Primary color:",
+        "type": "list",
+        "items": [
+          { "value": "emerald", "label": "Emerald (verde)" },
+          { "value": "ocean", "label": "Ocean (azul)" },
+          { "value": "coral", "label": "Coral" },
+          { "value": "amber", "label": "Amber (ámbar)" },
+          { "value": "violet", "label": "Violet (violeta)" },
+          { "value": "rose", "label": "Rose (rosa)" }
+        ]
+      }
+    },
+    "styles": {
+      "type": "boolean",
+      "description": "Añade @caribeng/ui/styles.css a los estilos del proyecto en angular.json.",
+      "default": true
+    }
+  },
+  "required": []
+}

package/types/caribeng-ui-anchor.d.ts

@@ -0,0 +1,50 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** Enlace del índice: `href` apunta al id de la sección (`#seccion`). */
+interface CbAnchorLink {
+    label: string;
+    href: string;
+    children?: CbAnchorLink[];
+}
+/**
+ * Anchor de CaribeNG: índice de la página ("En esta página") que resalta la
+ * sección visible (`aria-current="location"`) y, al hacer clic, desplaza hasta
+ * ella teniendo en cuenta una cabecera fija (`offset`) y le pasa el foco.
+ *
+ * @example
+ * ```html
+ * <cb-anchor [offset]="64" [links]="[
+ *   { label: 'Resumen', href: '#resumen' },
+ *   { label: 'Movimientos', href: '#movimientos', children: [{ label: 'Pendientes', href: '#pendientes' }] },
+ * ]" />
+ * ```
+ */
+declare class CbAnchor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly document;
+    readonly links: _angular_core.InputSignal<readonly CbAnchorLink[]>;
+    /** Alto (px) de la cabecera fija que tapa la parte superior de la página. */
+    readonly offset: _angular_core.InputSignal<number>;
+    /** Nombre de la navegación. Por defecto, "En esta página" del idioma activo. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Se emite al cambiar la sección visible (su `href`). */
+    readonly activeChange: _angular_core.OutputEmitterRef<string | null>;
+    protected readonly active: _angular_core.WritableSignal<string | null>;
+    private frame;
+    constructor();
+    private readonly onScroll;
+    /** Sección activa: la última cuyo inicio ya pasó la línea de la cabecera fija. */
+    update(): void;
+    /** Desplaza hasta la sección, deja el foco en ella y actualiza la URL. */
+    protected go(event: MouseEvent, link: CbAnchorLink): void;
+    private flatHrefs;
+    private target;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbAnchor, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbAnchor, "cb-anchor", never, { "links": { "alias": "links"; "required": false; "isSignal": true; }; "offset": { "alias": "offset"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "activeChange": "activeChange"; }, never, never, true, never>;
+}
+
+export { CbAnchor };
+export type { CbAnchorLink };
+//# sourceMappingURL=caribeng-ui-anchor.d.ts.map

package/types/caribeng-ui-autocomplete.d.ts

@@ -1,6 +1,6 @@
+import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 import { CbSize, CbRequiredIndicator } from '@caribeng/ui';
-import * as _angular_core from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { ConnectedPosition } from '@angular/cdk/overlay';
 
@@ -20,6 +20,8 @@ import { ConnectedPosition } from '@angular/cdk/overlay';
  * ```
  */
 declare class CbAutocomplete implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     /** Valor seleccionado (two-way opcional fuera de Angular Forms). */
     readonly value: _angular_core.ModelSignal<unknown>;
     /** Sugerencias a mostrar (las provee y filtra el consumidor). */
@@ -36,7 +38,7 @@ declare class CbAutocomplete implements ControlValueAccessor {
     readonly forceSelection: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Muestra un botón para desplegar todas las sugerencias. */
     readonly dropdown: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly emptyMessage: _angular_core.InputSignal<string>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
     readonly label: _angular_core.InputSignal<string>;
     readonly hint: _angular_core.InputSignal<string>;
     readonly error: _angular_core.InputSignal<string>;

package/types/caribeng-ui-avatargroup.d.ts

@@ -4,8 +4,10 @@ import * as i0 from '@angular/core';
  * AvatarGroup de CaribeNG: agrupa varios `<cb-avatar>` con superposición visual.
  */
 declare class CbAvatarGroup {
+    /** Nombre accesible del grupo (p. ej. "Participantes"). */
+    readonly ariaLabel: i0.InputSignal<string | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<CbAvatarGroup, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CbAvatarGroup, "cb-avatar-group", never, {}, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CbAvatarGroup, "cb-avatar-group", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 export { CbAvatarGroup };

package/types/caribeng-ui-badge.d.ts

@@ -19,8 +19,10 @@ declare class CbBadge {
     readonly size: _angular_core.InputSignal<CbSize>;
     /** Muestra solo un punto (sin texto). */
     readonly dot: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nombre accesible que sustituye al valor (p. ej. "3 mensajes sin leer"). Sin él, un `dot` es decorativo. */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbBadge, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbBadge, "cb-badge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbBadge, "cb-badge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { CbBadge };

package/types/caribeng-ui-blockui.d.ts

@@ -1,13 +1,18 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * BlockUI de CaribeNG: bloquea la interacción sobre el contenido proyectado
  * mostrando una máscara semitransparente con indicador opcional (`aria-busy`).
  */
 declare class CbBlockUi {
-    readonly blocked: i0.InputSignal<boolean>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CbBlockUi, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CbBlockUi, "cb-block-ui", never, { "blocked": { "alias": "blocked"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    readonly blocked: _angular_core.InputSignal<boolean>;
+    /** Texto que anuncia el lector de pantalla al bloquear. Por defecto, "Cargando" del idioma activo. */
+    readonly message: _angular_core.InputSignal<string | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbBlockUi, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbBlockUi, "cb-block-ui", never, { "blocked": { "alias": "blocked"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 export { CbBlockUi };

package/types/caribeng-ui-breadcrumb.d.ts

@@ -1,4 +1,6 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbMenuCommandEvent } from '@caribeng/ui';
 
 interface CbBreadcrumbItem {
     label: string;
@@ -6,6 +8,10 @@ interface CbBreadcrumbItem {
     url?: string;
     /** Icono (nombre del set de @caribeng/ui/icon) antes del texto. */
     icon?: string;
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbBreadcrumbItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /**
  * Breadcrumb de CaribeNG: rastro de navegación jerárquica.
@@ -20,11 +26,16 @@ interface CbBreadcrumbItem {
  * ```
  */
 declare class CbBreadcrumb {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly items: _angular_core.InputSignal<readonly CbBreadcrumbItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbBreadcrumbItem[]>;
     /** Icono separador entre elementos. */
     readonly separator: _angular_core.InputSignal<string>;
     /** Se emite al hacer clic en un elemento con enlace. */
     readonly itemClick: _angular_core.OutputEmitterRef<CbBreadcrumbItem>;
+    protected select(item: CbBreadcrumbItem, event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbBreadcrumb, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbBreadcrumb, "cb-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
 }

package/types/caribeng-ui-button.d.ts

@@ -31,10 +31,18 @@ declare class CbButton {
     readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Tipo nativo del botón. */
     readonly type: _angular_core.InputSignal<CbButtonType>;
+    /** Nombre accesible (imprescindible en botones de solo icono). */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Tipo de elemento que abre (`menu`, `dialog`, `listbox`…). */
+    readonly ariaHaspopup: _angular_core.InputSignal<string | undefined>;
+    /** Si lo que abre está desplegado. */
+    readonly ariaExpanded: _angular_core.InputSignal<boolean | undefined>;
+    /** Id del elemento que controla. */
+    readonly ariaControls: _angular_core.InputSignal<string | undefined>;
     private static readonly CHROMATIC;
     protected readonly variantClasses: _angular_core.Signal<string[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbButton, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbButton, "cb-button", never, { "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbButton, "cb-button", never, { "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaHaspopup": { "alias": "ariaHaspopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 export { CbButton };

package/types/caribeng-ui-caribe-alert.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Alert de Caribe Design: banner de notificación con severidad, título,
@@ -10,6 +11,8 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbAlert {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly title: _angular_core.InputSignal<string>;
     readonly severity: _angular_core.InputSignal<"success" | "warning" | "error" | "info">;
     readonly closable: _angular_core.InputSignal<boolean>;

package/types/caribeng-ui-caribe-animation-lottie.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Animation-lottie de Caribe Design: contenedor de animación (placeholder
@@ -10,11 +11,13 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbAnimationLottie {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly src: _angular_core.InputSignal<string>;
     readonly autoplay: _angular_core.InputSignal<boolean>;
     readonly loop: _angular_core.InputSignal<boolean>;
     readonly size: _angular_core.InputSignal<string>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly playing: _angular_core.WritableSignal<boolean>;
     play(): void;
     pause(): void;

package/types/caribeng-ui-caribe-button-group.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Button-group de Caribe Design: contenedor que agrupa acciones relacionadas
@@ -12,10 +13,12 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbButtonGroup {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     /** Dirección del grupo. */
     readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
     /** Etiqueta accesible del grupo. */
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbButtonGroup, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbButtonGroup, "cb-button-group", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }

package/types/caribeng-ui-caribe-calendar.d.ts

@@ -1,3 +1,4 @@
+import * as _caribeng_ui from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
 
 /**
@@ -12,7 +13,10 @@ declare class CbCalendar {
     readonly monthLabel: _angular_core.InputSignal<string>;
     readonly totalDays: _angular_core.InputSignal<number>;
     readonly selectedDay: _angular_core.ModelSignal<number>;
-    protected readonly weekdays: string[];
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Iniciales de lunes a domingo en el idioma activo. */
+    protected readonly weekdays: _angular_core.Signal<string[]>;
     protected readonly days: _angular_core.Signal<number[]>;
     selectDay(day: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCalendar, never>;

package/types/caribeng-ui-caribe-card-content.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Card-content de Caribe Design: tarjeta de contenido con título, subtítulo,
@@ -10,9 +11,11 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbCardContent {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly title: _angular_core.InputSignal<string>;
     readonly subtitle: _angular_core.InputSignal<string>;
-    readonly actionLabel: _angular_core.InputSignal<string>;
+    readonly actionLabel: _angular_core.InputSignal<string | undefined>;
     readonly action: _angular_core.OutputEmitterRef<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCardContent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbCardContent, "cb-card-content", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; }, { "action": "action"; }, never, ["*"], true, never>;

package/types/caribeng-ui-caribe-card-move.d.ts

@@ -1,19 +1,19 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
-/**
- * Card-move de Caribe Design: lista de elementos reordenables mediante botones
- * de subir/bajar.
- *
- * @example
- * ```html
- * <cb-card-move [(items)]="opciones" />
- * ```
- */
 declare class CbCardMove {
-    readonly items: i0.ModelSignal<readonly string[]>;
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    readonly items: _angular_core.ModelSignal<readonly string[]>;
+    /** Prefijo de ids: cada botón se describe con la etiqueta de su elemento. */
+    protected readonly uid: string;
+    private readonly host;
+    private readonly injector;
     protected move(index: number, delta: number): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CbCardMove, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CbCardMove, "cb-card-move", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; }, { "items": "itemsChange"; }, never, never, true, never>;
+    /** El foco sigue al elemento movido; si su botón queda deshabilitado (extremo), pasa al otro. */
+    private followItem;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCardMove, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbCardMove, "cb-card-move", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; }, { "items": "itemsChange"; }, never, never, true, never>;
 }
 
 export { CbCardMove };

package/types/caribeng-ui-caribe-card-select.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Card-select de Caribe Design: tarjeta con buscador y lista de opciones
@@ -10,11 +11,19 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbCardSelect {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly items: _angular_core.InputSignal<readonly string[]>;
-    readonly label: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
     readonly selected: _angular_core.ModelSignal<string | null>;
     readonly selectionChange: _angular_core.OutputEmitterRef<string>;
     protected readonly query: _angular_core.ModelSignal<string>;
+    private readonly host;
+    /** Opción que entra en el orden de tabulación: la elegida o, si no está visible, la primera. */
+    protected readonly tabbable: _angular_core.Signal<number>;
+    protected choose(item: string): void;
+    /** Patrón *listbox*: flechas (circular), Inicio y Fin mueven el foco; Enter / Espacio eligen (botón nativo). */
+    protected onListKeydown(event: KeyboardEvent): void;
     protected readonly filtered: _angular_core.Signal<string[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCardSelect, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbCardSelect, "cb-card-select", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; "selectionChange": "selectionChange"; "query": "queryChange"; }, never, never, true, never>;

package/types/caribeng-ui-caribe-circle-loading.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Circle-loading de Caribe Design: progreso circular determinado o
@@ -11,10 +12,12 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbCircleLoading {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly progress: _angular_core.InputSignal<number>;
     readonly size: _angular_core.InputSignal<number>;
     readonly indeterminate: _angular_core.InputSignal<boolean>;
-    readonly label: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
     protected readonly circumference: number;
     protected readonly dashOffset: _angular_core.Signal<number>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCircleLoading, never>;

package/types/caribeng-ui-caribe-coachmark.d.ts

@@ -1,4 +1,6 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
 /**
  * Coachmark de Caribe Design: tarjeta de ayuda guiada paso a paso para resaltar
@@ -10,6 +12,10 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbCoachmark {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     readonly steps: _angular_core.InputSignal<readonly string[]>;
     readonly visible: _angular_core.ModelSignal<boolean>;
     readonly index: _angular_core.ModelSignal<number>;

package/types/caribeng-ui-caribe-data-table.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Data-table de Caribe Design: tabla simple de columnas y filas con mensaje de
@@ -10,11 +11,15 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbDataTable {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly columns: _angular_core.InputSignal<readonly string[]>;
     readonly rows: _angular_core.InputSignal<readonly Record<string, unknown>[]>;
-    readonly emptyMessage: _angular_core.InputSignal<string>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    /** Nombre accesible de la tabla (p. ej. "Movimientos del mes"). */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbDataTable, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbDataTable, "cb-data-table", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbDataTable, "cb-data-table", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { CbDataTable };