@mimi-ng/cli 0.2.0 → 0.4.0

package/dist/ui/schema.json

@@ -9,13 +9,13 @@
       "items": {
         "type": "string"
       },
-      "description": "Componentes que se agregan (varios a la vez: button input form-field).",
+      "description": "Componentes o Blocks que se agregan (varios a la vez: button input form-field, o un Block: login-01).",
       "$default": {
         "$source": "argv",
         "index": 0
       },
       "x-prompt": {
-        "message": "¿Qué componentes quieres agregar?",
+        "message": "¿Qué componentes o Blocks quieres agregar?",
         "type": "list",
         "multiselect": true,
         "items": [
@@ -31,6 +31,10 @@
             "value": "button",
             "label": "button"
           },
+          {
+            "value": "calendar",
+            "label": "calendar"
+          },
           {
             "value": "card",
             "label": "card"
@@ -39,6 +43,14 @@
             "value": "checkbox",
             "label": "checkbox"
           },
+          {
+            "value": "color-picker",
+            "label": "color-picker"
+          },
+          {
+            "value": "combobox",
+            "label": "combobox"
+          },
           {
             "value": "confirm",
             "label": "confirm"
@@ -47,6 +59,14 @@
             "value": "context-menu",
             "label": "context-menu"
           },
+          {
+            "value": "date-picker",
+            "label": "date-picker"
+          },
+          {
+            "value": "date-range",
+            "label": "date-range"
+          },
           {
             "value": "dialog",
             "label": "dialog"
@@ -55,6 +75,10 @@
             "value": "dropdown-menu",
             "label": "dropdown-menu"
           },
+          {
+            "value": "file-upload",
+            "label": "file-upload"
+          },
           {
             "value": "form-field",
             "label": "form-field"
@@ -63,14 +87,34 @@
             "value": "input",
             "label": "input"
           },
+          {
+            "value": "input-mask",
+            "label": "input-mask"
+          },
+          {
+            "value": "input-otp",
+            "label": "input-otp"
+          },
+          {
+            "value": "number-input",
+            "label": "number-input"
+          },
           {
             "value": "pagination",
             "label": "pagination"
           },
+          {
+            "value": "password",
+            "label": "password"
+          },
           {
             "value": "popover",
             "label": "popover"
           },
+          {
+            "value": "progress",
+            "label": "progress"
+          },
           {
             "value": "select",
             "label": "select"
@@ -83,6 +127,10 @@
             "value": "skeleton",
             "label": "skeleton"
           },
+          {
+            "value": "slider",
+            "label": "slider"
+          },
           {
             "value": "switch",
             "label": "switch"
@@ -91,6 +139,10 @@
             "value": "tabs",
             "label": "tabs"
           },
+          {
+            "value": "tags-input",
+            "label": "tags-input"
+          },
           {
             "value": "textarea",
             "label": "textarea"
@@ -99,6 +151,10 @@
             "value": "toast",
             "label": "toast"
           },
+          {
+            "value": "toggle-group",
+            "label": "toggle-group"
+          },
           {
             "value": "toolbar",
             "label": "toolbar"
@@ -106,6 +162,30 @@
           {
             "value": "tooltip",
             "label": "tooltip"
+          },
+          {
+            "value": "login-01",
+            "label": "login-01 (Block)"
+          },
+          {
+            "value": "login-02",
+            "label": "login-02 (Block)"
+          },
+          {
+            "value": "otp-01",
+            "label": "otp-01 (Block)"
+          },
+          {
+            "value": "pricing-01",
+            "label": "pricing-01 (Block)"
+          },
+          {
+            "value": "settings-01",
+            "label": "settings-01 (Block)"
+          },
+          {
+            "value": "signup-01",
+            "label": "signup-01 (Block)"
           }
         ]
       }

package/dist/utils/project.js

@@ -1,12 +1,47 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIMI_COLLECTION = void 0;
+exports.defaultBlocksDir = defaultBlocksDir;
+exports.assertAliases = assertAliases;
 exports.readJson = readJson;
 exports.allDependencies = allDependencies;
 exports.majorOf = majorOf;
 const schematics_1 = require("@angular-devkit/schematics");
+const paths_1 = require("../init/paths");
 /** Nombre de esta colección (el paquete). */
 exports.MIMI_COLLECTION = '@mimi-ng/cli';
+/**
+ * Carpeta de los Blocks si mimi.json no la dice: la hermana de `components/` cuando la de
+ * componentes es la de siempre (`src/app/components/ui` → `src/app/blocks`), o si no, la hermana
+ * de la carpeta de componentes (`src/app/ui` → `src/app/blocks`).
+ */
+function defaultBlocksDir(componentsDir) {
+    const parts = componentsDir.split('/').filter(Boolean);
+    if (parts.length >= 2 && parts.at(-1) === 'ui' && parts.at(-2) === 'components') {
+        parts.splice(-2, 2);
+    }
+    else {
+        parts.pop();
+    }
+    return [...parts, 'blocks'].join('/');
+}
+/**
+ * M2: falla con un error claro (sin escribir nada) si `aliases.components` o `aliases.blocks` de
+ * mimi.json es absoluto, tiene `..` o sale del proyecto.
+ */
+function assertAliases(config) {
+    for (const name of ['components', 'blocks']) {
+        const value = config.aliases?.[name];
+        if (value === undefined)
+            continue;
+        const reason = (0, paths_1.invalidAliasReason)(value);
+        if (!reason)
+            continue;
+        const example = name === 'blocks' ? 'src/app/blocks' : 'src/app/components/ui';
+        throw new schematics_1.SchematicsException(`mimi.json → aliases.${name} ${reason}: ${JSON.stringify(value)}. Usa una ruta relativa a ` +
+            `la raíz del workspace y dentro de ella (por ejemplo "${example}"). No se cambió nada.`);
+    }
+}
 function readJson(tree, path) {
     if (!tree.exists(path))
         return null;

package/dist/utils/tailwind.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tailwindSupportsSourceNot = tailwindSupportsSourceNot;
+exports.withBlocksSource = withBlocksSource;
+exports.mimiSourceNotLine = mimiSourceNotLine;
+exports.mimiSourceNotPath = mimiSourceNotPath;
+exports.missingMimiExclusion = missingMimiExclusion;
+const css_1 = require("../init/css");
+const paths_1 = require("../init/paths");
+/** La carpeta de las copias originales (`.mimi/base/`), en la raíz del workspace. */
+const MIMI_DIR = '.mimi';
+/**
+ * ¿El Tailwind del proyecto entiende `@source not` (4.1 o superior)? Manda la versión instalada
+ * (`node_modules`, la que corre de verdad); si no está instalado, el rango de package.json: solo
+ * un rango que no puede pasar de la 4.0 (`4.0.5`, `~4.0.17`) cuenta como 4.0. `^4.0.17` instala
+ * la última 4.x, así que sí lo entiende.
+ */
+function tailwindSupportsSourceNot(tree, declared) {
+    const file = tree.read('node_modules/tailwindcss/package.json');
+    const installed = file
+        ? JSON.parse(file.toString('utf-8')).version
+        : undefined;
+    if (installed)
+        return atLeast41(installed);
+    if (!declared)
+        return true;
+    // Solo un rango exacto o con `~` fija el minor; `^4.0.17`, `>=4`, `^4`, `latest`: la última 4.x.
+    const match = /^\s*(?:~|=|v)?\s*(\d+)\.(\d+)/.exec(declared);
+    if (!match)
+        return true;
+    const [major, minor] = [Number(match[1]), Number(match[2])];
+    return major > 4 || (major === 4 && minor >= 1);
+}
+function atLeast41(version) {
+    const [major, minor] = version.split('.').map((n) => Number.parseInt(n, 10) || 0);
+    return major > 4 || (major === 4 && minor >= 1);
+}
+/**
+ * Con `source(none)`, Tailwind solo escanea lo que dice un `@source`: la carpeta de los Blocks
+ * necesita el suyo (G1), como la de componentes. Devuelve el CSS con la línea agregada (después
+ * del `@source` de componentes, o del tema), o `null` si no hace falta: sin `source(none)`, o si
+ * ya está (comillas simples o dobles).
+ */
+function withBlocksSource(css, cssPath, componentsDir, blocksDir) {
+    const tailwind = (0, css_1.findTailwindImport)(css);
+    if (!tailwind?.sourceNone)
+        return null;
+    const cssDir = (0, paths_1.dirnameOf)(cssPath);
+    const path = (0, paths_1.relativePath)(cssDir, blocksDir);
+    if ((0, css_1.hasDirective)(css, '@source', path))
+        return null;
+    const line = `@source "${path}";`;
+    const after = new RegExp(String.raw `^[ \t]*@source\s+(["'])` +
+        (0, paths_1.relativePath)(cssDir, componentsDir).replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+        String.raw `\1[^;\n]*;[^\n]*$`, 'm').exec(css);
+    if (after) {
+        const end = after.index + after[0].length;
+        const eol = /\r\n/.test(css) ? '\r\n' : '\n';
+        return { css: css.slice(0, end) + eol + line + css.slice(end), line };
+    }
+    const updated = (0, css_1.insertAfterTheme)(css, [line]);
+    return updated === null ? null : { css: updated, line };
+}
+/** La línea que excluye `.mimi/` del escaneo de Tailwind, relativa al CSS global. */
+function mimiSourceNotLine(cssPath) {
+    return `@source not "${mimiSourceNotPath(cssPath)}";`;
+}
+function mimiSourceNotPath(cssPath) {
+    return (0, paths_1.relativePath)((0, paths_1.dirnameOf)(cssPath), MIMI_DIR);
+}
+/**
+ * ¿Falta la exclusión de `.mimi/` en este CSS? No hace falta con `source(none)` (Tailwind no
+ * escanea nada por su cuenta) ni si ya está, con comillas simples o dobles.
+ */
+function missingMimiExclusion(css, cssPath) {
+    const tailwind = (0, css_1.findTailwindImport)(css);
+    if (!tailwind || tailwind.sourceNone)
+        return false;
+    return !(0, css_1.hasDirective)(css, '@source not', mimiSourceNotPath(cssPath));
+}

package/dist/utils/write-files.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasFileChanges = exports.emptyReport = exports.MANIFEST = exports.BASE_DIR = void 0;
+exports.isBlockFile = exports.hasFileChanges = exports.emptyReport = exports.MANIFEST = exports.BASE_DIR = void 0;
 exports.projectPathOf = projectPathOf;
+exports.targetPathOf = targetPathOf;
 exports.basePathOf = basePathOf;
 exports.writeTemplates = writeTemplates;
 exports.blockedMessages = blockedMessages;
@@ -9,6 +10,7 @@ exports.compareVersions = compareVersions;
 exports.updatedMessages = updatedMessages;
 const schematics_1 = require("@angular-devkit/schematics");
 const registry_1 = require("../registry");
+const project_1 = require("./project");
 /** Carpeta de las copias originales, en la raíz del workspace. Debe quedar en git. */
 exports.BASE_DIR = '.mimi/base';
 /** Versión de Mimi con la que se escribió la base de cada archivo. */
@@ -34,7 +36,26 @@ exports.hasFileChanges = hasFileChanges;
 function projectPathOf(file) {
     return file.replace(/^components\//, '');
 }
-/** Copia original en .mimi/base, con la misma estructura (`.mimi/base/button/button.ts`). */
+/** Prefijo de los archivos de un Block en las plantillas (`blocks/login-01/login-01.ts`). */
+const BLOCKS_PREFIX = 'blocks/';
+/** ¿Es un archivo de un Block? */
+const isBlockFile = (file) => file.startsWith(BLOCKS_PREFIX);
+exports.isBlockFile = isBlockFile;
+/**
+ * Ruta en el proyecto de un archivo de las plantillas: los Blocks van a su carpeta, sin
+ * `blocks/` (`blocks/login-01/login-01.ts` → `<blocksDir>/login-01/login-01.ts`); el resto, a la
+ * de componentes (ver projectPathOf).
+ */
+function targetPathOf(file, componentsDir, blocksDir) {
+    return (0, exports.isBlockFile)(file)
+        ? `${blocksDir}/${file.slice(BLOCKS_PREFIX.length)}`
+        : `${componentsDir}/${projectPathOf(file)}`;
+}
+/**
+ * Copia original en .mimi/base, con la misma estructura (`.mimi/base/button/button.ts`). Los
+ * Blocks conservan `blocks/` (`.mimi/base/blocks/login-01/login-01.ts`), y esa es también su
+ * clave en el manifiesto.
+ */
 function basePathOf(file) {
     return `${exports.BASE_DIR}/${projectPathOf(file)}`;
 }
@@ -61,7 +82,8 @@ function readManifest(tree) {
  * - si no, se crean los que faltan y se actualizan los que el usuario no tocó. Los modificados
  *   sobre esta versión se conservan (`skipped`).
  *
- * Con `overwrite`, todo se reemplaza y nada se bloquea. Los ítems `implicit` (el tema y lo que
+ * Con `overwrite`, todo se reemplaza y nada se bloquea, también un archivo igual a su base de la
+ * misma versión (`formatted`; M.11). Los ítems `implicit` (el tema y lo que
  * copia init, que `ng g mimi` revisa aunque no se pidan) solo se escriben si hay que
  * actualizarlos: un cambio del usuario sobre la versión actual se respeta en silencio, también
  * con `overwrite`, y no bloquean a otros ítems.
@@ -87,7 +109,7 @@ function writeTemplates(options) {
     const write = (tree) => {
         const manifest = readManifest(tree);
         let manifestChanged = false;
-        const targetOf = (file) => `${options.componentsDir}/${projectPathOf(file)}`;
+        const targetOf = (file) => targetPathOf(file, options.componentsDir, options.blocksDir ?? (0, project_1.defaultBlocksDir)(options.componentsDir));
         const stateOf = (file) => {
             const target = targetOf(file);
             if (!tree.exists(target))
@@ -172,7 +194,16 @@ function writeTemplates(options) {
                         writeBase(file, content);
                         break;
                     case 'formatted':
-                        options.report.unchanged.push(file);
+                        // Con --overwrite se reemplaza siempre, también con la misma versión (M.11): sin él,
+                        // un archivo distinto de la plantilla con la misma versión no se podía reponer.
+                        if (options.overwrite && !implicit.has(item)) {
+                            tree.overwrite(target, content);
+                            options.report.overwritten.push(file);
+                            writeBase(file, content);
+                        }
+                        else {
+                            options.report.unchanged.push(file);
+                        }
                         break;
                     case 'old':
                         tree.overwrite(target, content);
@@ -209,8 +240,8 @@ function writeTemplates(options) {
  * Los avisos de los ítems que no se escribieron (`report.blocked`): qué no se actualizó, por qué
  * y qué hacer. Nunca dicen «actualizado».
  */
-function blockedMessages(report, componentsDir, version) {
-    const path = (file) => `${componentsDir}/${projectPathOf(file)}`;
+function blockedMessages(report, componentsDir, version, blocksDir = (0, project_1.defaultBlocksDir)(componentsDir)) {
+    const path = (file) => targetPathOf(file, componentsDir, blocksDir);
     return report.blocked.map(({ item, files, dependency, installed }) => {
         if (dependency) {
             const needs = `necesita ${dependency} ${version}, que no se actualizó (ver el aviso de ${dependency}).`;
@@ -218,9 +249,18 @@ function blockedMessages(report, componentsDir, version) {
                 ? `${item} no se actualizó a ${version}: ${needs}`
                 : `${item} no se agregó: ${needs}`;
         }
-        const isTheme = registry_1.registry.items[item]?.type === 'theme';
-        const label = isTheme ? 'El tema' : item;
+        const type = registry_1.registry.items[item]?.type;
         const dir = projectPathOf(files[0]).split('/').slice(0, -1).join('/');
+        if (type === 'block') {
+            // Lo normal es editar un Block (es una pantalla del usuario): el aviso no alarma (B.1-b).
+            return (`${item} no se actualizó a ${version}: es tu pantalla y la modificaste ` +
+                `(${files.map(path).join(', ')}), así que no se tocó ninguno de sus archivos. Es lo ` +
+                `normal con un Block. La versión de Mimi que modificaste está en ${exports.BASE_DIR}/${dir}/, ` +
+                'para comparar. Si quieres la nueva, guarda tus cambios (por ejemplo, en git) y vuelve ' +
+                'a ejecutar el comando con --overwrite: reemplaza tu pantalla entera.');
+        }
+        const isTheme = type === 'theme';
+        const label = isTheme ? 'El tema' : item;
         return (`${label} no se actualizó a ${version} porque modificaste ${files.map(path).join(', ')}. ` +
             'No se cambió ninguno de sus archivos, para no mezclar versiones.' +
             (isTheme

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mimi-ng/cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Angular + Tailwind CSS 4 UI components that a CLI copies into your project, so you own the code. Schematics for ng add and ng generate.",
   "keywords": [
     "angular",