@caribeng/ui 22.1.0 → 22.2.0

package/package.json

@@ -1,19 +1,32 @@
 {
   "name": "@caribeng/ui",
-  "version": "22.1.0",
-  "description": "CaribeNG — sistema de diseño y librería de componentes para Angular 22+ (standalone, signals, OnPush, zoneless). 142 entry points tree-shakeables, accesibles (WCAG 2.2 AA) y tematizables.",
-  "license": "MIT",
+  "version": "22.2.0",
+  "description": "CaribeNG — sistema de diseño y librería de componentes para Angular 22+ (standalone, signals, OnPush, zoneless). 152 entry points tree-shakeables, accesibles (WCAG 2.2 AA) y tematizables.",
   "keywords": [
     "angular",
-    "design-system",
-    "components",
-    "signals",
-    "zoneless",
-    "ui",
-    "caribeng",
-    "a11y"
+    "ui library",
+    "component library",
+    "design",
+    "framework",
+    "frontend",
+    "caribeng"
   ],
+  "author": "CaribeNG",
+  "license": "MIT",
+  "homepage": "https://github.com/caribeng/ui#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caribeng/ui.git",
+    "directory": "packages/ui"
+  },
+  "bugs": {
+    "url": "https://github.com/caribeng/ui/issues"
+  },
   "sideEffects": false,
+  "schematics": "./schematics/collection.json",
+  "ng-add": {
+    "save": "dependencies"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -22,9 +35,15 @@
     "@angular/core": "^22.0.0",
     "@angular/forms": "^22.0.0",
     "@angular/platform-browser": "^22.0.0",
-    "@angular/cdk": "^22.0.0"
+    "pdfjs-dist": "^6.4.0"
+  },
+  "peerDependenciesMeta": {
+    "pdfjs-dist": {
+      "optional": true
+    }
   },
   "dependencies": {
+    "@angular/cdk": "^22.0.0",
     "tslib": "^2.8.1"
   },
   "module": "fesm2022/caribeng-ui.mjs",
@@ -41,6 +60,10 @@
       "types": "./types/caribeng-ui-accordion.d.ts",
       "default": "./fesm2022/caribeng-ui-accordion.mjs"
     },
+    "./anchor": {
+      "types": "./types/caribeng-ui-anchor.d.ts",
+      "default": "./fesm2022/caribeng-ui-anchor.mjs"
+    },
     "./animateonscroll": {
       "types": "./types/caribeng-ui-animateonscroll.d.ts",
       "default": "./fesm2022/caribeng-ui-animateonscroll.mjs"
@@ -309,6 +332,10 @@
       "types": "./types/caribeng-ui-datepicker.d.ts",
       "default": "./fesm2022/caribeng-ui-datepicker.mjs"
     },
+    "./descriptions": {
+      "types": "./types/caribeng-ui-descriptions.d.ts",
+      "default": "./fesm2022/caribeng-ui-descriptions.mjs"
+    },
     "./dialog": {
       "types": "./types/caribeng-ui-dialog.d.ts",
       "default": "./fesm2022/caribeng-ui-dialog.mjs"
@@ -333,6 +360,10 @@
       "types": "./types/caribeng-ui-editor.d.ts",
       "default": "./fesm2022/caribeng-ui-editor.mjs"
     },
+    "./empty": {
+      "types": "./types/caribeng-ui-empty.d.ts",
+      "default": "./fesm2022/caribeng-ui-empty.mjs"
+    },
     "./fieldset": {
       "types": "./types/caribeng-ui-fieldset.d.ts",
       "default": "./fesm2022/caribeng-ui-fieldset.mjs"
@@ -405,6 +436,10 @@
       "types": "./types/caribeng-ui-inputotp.d.ts",
       "default": "./fesm2022/caribeng-ui-inputotp.mjs"
     },
+    "./keyfilter": {
+      "types": "./types/caribeng-ui-keyfilter.d.ts",
+      "default": "./fesm2022/caribeng-ui-keyfilter.mjs"
+    },
     "./knob": {
       "types": "./types/caribeng-ui-knob.d.ts",
       "default": "./fesm2022/caribeng-ui-knob.mjs"
@@ -461,6 +496,10 @@
       "types": "./types/caribeng-ui-password.d.ts",
       "default": "./fesm2022/caribeng-ui-password.mjs"
     },
+    "./pdfviewer": {
+      "types": "./types/caribeng-ui-pdfviewer.d.ts",
+      "default": "./fesm2022/caribeng-ui-pdfviewer.mjs"
+    },
     "./picklist": {
       "types": "./types/caribeng-ui-picklist.d.ts",
       "default": "./fesm2022/caribeng-ui-picklist.mjs"
@@ -485,6 +524,14 @@
       "types": "./types/caribeng-ui-rating.d.ts",
       "default": "./fesm2022/caribeng-ui-rating.mjs"
     },
+    "./repeater": {
+      "types": "./types/caribeng-ui-repeater.d.ts",
+      "default": "./fesm2022/caribeng-ui-repeater.mjs"
+    },
+    "./result": {
+      "types": "./types/caribeng-ui-result.d.ts",
+      "default": "./fesm2022/caribeng-ui-result.mjs"
+    },
     "./ripple": {
       "types": "./types/caribeng-ui-ripple.d.ts",
       "default": "./fesm2022/caribeng-ui-ripple.mjs"
@@ -521,10 +568,18 @@
       "types": "./types/caribeng-ui-spinner.d.ts",
       "default": "./fesm2022/caribeng-ui-spinner.mjs"
     },
+    "./splitbutton": {
+      "types": "./types/caribeng-ui-splitbutton.d.ts",
+      "default": "./fesm2022/caribeng-ui-splitbutton.mjs"
+    },
     "./splitter": {
       "types": "./types/caribeng-ui-splitter.d.ts",
       "default": "./fesm2022/caribeng-ui-splitter.mjs"
     },
+    "./statistic": {
+      "types": "./types/caribeng-ui-statistic.d.ts",
+      "default": "./fesm2022/caribeng-ui-statistic.mjs"
+    },
     "./stepper": {
       "types": "./types/caribeng-ui-stepper.d.ts",
       "default": "./fesm2022/caribeng-ui-stepper.mjs"
@@ -561,6 +616,10 @@
       "types": "./types/caribeng-ui-textarea.d.ts",
       "default": "./fesm2022/caribeng-ui-textarea.mjs"
     },
+    "./themetoggle": {
+      "types": "./types/caribeng-ui-themetoggle.d.ts",
+      "default": "./fesm2022/caribeng-ui-themetoggle.mjs"
+    },
     "./tieredmenu": {
       "types": "./types/caribeng-ui-tieredmenu.d.ts",
       "default": "./fesm2022/caribeng-ui-tieredmenu.mjs"

package/schematics/collection.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Configura CaribeNG en el proyecto: provideCaribeNG() y la hoja de estilos.",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json"
+    }
+  }
+}

package/schematics/ng-add/index.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CARIBENG_STYLES = void 0;
+exports.ngAdd = ngAdd;
+exports.providerConfig = providerConfig;
+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));
+    };
+}

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": []
+}