@ingcrea/aumic-tailwind-killer 3.1.4 → 3.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +56 -69
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,97 +1,84 @@
1
- # ⚔️ AUM-IC Tailwind Killer
1
+ # ⚔️ AUM-IC Tailwind Killer (Native & Hybrid Core)
2
2
 
3
- **AUM-IC Tailwind Killer** es un orquestador CLI de alto rendimiento diseñado para **transmutar** proyectos basados en Tailwind CSS en ecosistemas de clases ofuscadas, deterministas y libres de dependencias (Zero-Bloat).
3
+ > **Transmutador de Tailwind CSS a Arquitectura Zero-Bloat, potenciado por Rust y TypeScript.**
4
4
 
5
- Desarrollado por el equipo de **Ingeniería Creativa (IngCrea)**, esta herramienta audita, extrae, compila (vía JIT) y purga tu código fuente en segundos gracias a su arquitectura multi-hilos (Piscina) e interceptores AST universales.
5
+ **AUM-IC Tailwind Killer** es un orquestador CLI de grado corporativo, diseñado por **Ingeniería Creativa (IngCrea)**. Su función principal es **erradicar** el framework de Tailwind CSS de tu código fuente y transformarlo en un ecosistema de clases ofuscadas, deterministas y 100% nativas (AUM-IC).
6
6
 
7
7
  ---
8
8
 
9
- ## ⚡ ¿Por qué usar AUM-IC Tailwind Killer?
9
+ ## ⚡ La Arquitectura de Doble Núcleo: ¿Por qué Rust?
10
10
 
11
- 1. **Ofuscación y Seguridad Corporativa:** Transforma utilidades legibles (`flex items-center text-red-500`) en hashes seguros (`aumic-component-1b3a4f`), dificultando el scraping y el robo de diseño (UI/UX).
12
- 2. **Independencia del Framework:** Erradica a Tailwind CSS de tu `package.json` y dependencias de build. Tu proyecto pasa a depender únicamente de un archivo `.css` nativo, estándar y ultra-optimizado.
13
- 3. **Rendimiento Extremo (Build Time):** Al purgar el motor de Tailwind de tu flujo de trabajo, los tiempos de compilación de tu framework (Astro, Next.js, Vite) se reducen drásticamente.
14
- 4. **Cero Riesgo de Corrupción:** Cuenta con escudos **Pre-Flight** que auditan los permisos NTFS/POSIX antes de tocar un solo archivo, evitando estados corruptos.
11
+ Procesar miles de archivos, parsear el DOM y orquestar el compilador JIT en un entorno mono-hilo como Node.js genera un cuello de botella. Para alcanzar el pináculo del rendimiento, diseñamos una **arquitectura híbrida infalible**:
15
12
 
16
- ---
17
-
18
- ## 🚀 Instalación
19
-
20
- Puedes ejecutarlo al vuelo usando `npx` (recomendado) o instalarlo globalmente:
21
-
22
- ```bash
23
- # Uso al vuelo mediante NPX
24
- npx @ingcrea/aumic-tailwind-killer -m local -t ./mi-proyecto
13
+ 1. 🦀 **Motor Nativo en Rust (El Estándar):**
14
+ - **Zero-Bloat Absoluto:** Un ejecutable de 2.5 MB sin dependencias de Node.
15
+ - **Concurrencia Multi-Núcleo:** Utiliza la librería
16
+ - **Velocidad Extrema:** Expresiones regulares nativas y rutinas de criptografía (sha2) que mutan proyectos enteros en milisegundos.
25
17
 
26
- # Instalación global
27
- npm install -g @ingcrea/aumic-tailwind-killer
28
- ```
18
+ 2. 🟦 **Motor de TypeScript (El Fallback Inteligente):**
19
+ - Sirve como red de seguridad. Si el binario de Rust es bloqueado por políticas corporativas de OS o firewalls estrictos, el Wrapper de NPM detecta el fallo y **ejecuta instantáneamente el motor en TypeScript** (Babel AST), asegurando que tu flujo de trabajo CI/CD jamás se rompa.
29
20
 
30
21
  ---
31
22
 
32
- ## 🛠 Casos de Uso y Ejemplos de Ejecución
33
-
34
- La herramienta opera bajo distintos **modos** de destrucción y auditoría. Asegúrate de estar en una rama de Git limpia (ej. `git checkout -b build-aumic`) antes de realizar mutaciones destructivas.
35
-
36
- ### 1. Modo Simulación (Dry-Run)
37
- **Caso de uso:** Quieres auditar tu proyecto, ver cuántas clases de Tailwind usas y visualizar el impacto sin modificar tu código fuente. Ideal para auditorías previas.
38
-
39
- ```bash
40
- npx @ingcrea/aumic-tailwind-killer -m simulate -t ./
41
- ```
42
- * **Qué hace:** Escanea el código mediante el Motor Infrarrojo, extrae las utilidades, genera los hashes en RAM y emite un reporte visual detallado (`aumic-report.html`), pero **no altera** tus archivos.
43
-
44
- ### 2. Modo Local (Transmutación Destructiva)
45
- **Caso de uso:** Estás listo para preparar tu código para producción. Deseas reemplazar todo Tailwind por CSS puro, reescribir tus componentes (`.astro`, `.tsx`, `.vue`, `.py`) y eliminar el framework.
46
-
47
- ```bash
48
- npx @ingcrea/aumic-tailwind-killer -m local -t ./
49
- ```
50
- * **Qué hace:** Ejecuta las 5 Fases de AUM-IC. Reescribe físicamente todos los archivos soportados, inyecta el CSS nativo unificado, elimina dependencias en `package.json` y genera un mapa reverso (`aumic-lock.json`).
51
-
52
- ### 3. Modo Quirúrgico (Surgical Scope)
53
- **Caso de uso:** Tienes un monorepo gigante y solo quieres ofuscar una carpeta específica (ej. solo el frontend de marketing) ignorando el panel de administración.
23
+ ## 📦 Instalación
54
24
 
55
- ```bash
56
- npx @ingcrea/aumic-tailwind-killer -m local -t ./ -s "src/frontend/**/*.{tsx,astro}"
57
- ```
58
- * **Qué hace:** Ignora el escáner global de Git y restringe la mutación **estrictamente** al patrón Glob (Regex) definido en el argumento `-s` (Scope).
25
+ El Wrapper interceptor distribuirá dinámicamente el ejecutable correspondiente a tu Sistema Operativo (Windows, Linux, macOS).
59
26
 
60
- ### 4. Modo Restauración (Rollback)
61
- **Caso de uso:** Algo falló durante el QA post-mutación o necesitas volver a trabajar con Tailwind en tu entorno local.
27
+ **Uso al vuelo (Recomendado):**
28
+ \\\ash
29
+ npx @ingcrea/aumic-tailwind-killer -m <modo> -t <ruta>
30
+ \\\
62
31
 
63
- ```bash
64
- npx @ingcrea/aumic-tailwind-killer -m restore -t ./
65
- ```
66
- * **Qué hace:** Lee el mapa criptográfico `aumic-lock.json`, revierte los hashes en tus archivos a sus clases Tailwind originales y restaura el `package.json.aumic-bak`.
32
+ **Instalación Global:**
33
+ \\\ash
34
+ npm install -g @ingcrea/aumic-tailwind-killer
35
+ aumic-tailwind-killer -m <modo> -t <ruta>
36
+ \\\
67
37
 
68
38
  ---
69
39
 
70
- ## ⚙️ Banderas y Variables (CLI Options)
40
+ ## 🛠️ Modos de Operación y Banderas
41
+
42
+ El CLI funciona a través de banderas estrictas para evitar mutaciones accidentales.
71
43
 
72
- | Bandera Corta | Bandera Larga | Descripción | Obligatorio |
73
- | :--- | :--- | :--- | :--- |
74
- | `-m` | `--mode` | Define el comportamiento del orquestador (`simulate`, `local`, `restore`, `clone`). | **Sí** |
75
- | `-t` | `--target` | Ruta absoluta o relativa al directorio del proyecto a procesar. | **Sí** |
76
- | `-s` | `--scope` | Patrón de búsqueda Glob para restringir la mutación a archivos específicos. | No |
44
+ | Bandera | Argumento | Descripción |
45
+ | :--- | :--- | :--- |
46
+ | **-m / --mode** | simulate, local,
47
+ | **-t / --target**| ./mi-proyecto | **(Requerido)** La ruta absoluta o relativa del proyecto a procesar. |
48
+ | **-s / --scope** | components, pages, etc. | *(Opcional)* Limita el escaneo a un subdirectorio específico. |
77
49
 
78
50
  ---
79
51
 
80
- ## 🧠 Arquitectura de 5 Fases
52
+ ## 🚀 Ejemplos de Uso en Entornos Reales
81
53
 
82
- 1. **Reconocimiento & Pre-Flight:** Validación exhaustiva de permisos W_OK (Anti-Zombie) y escaneo de árbol de dependencias mediante LS-Files de Git (Fast-Path).
83
- 2. **Extracción Paralela (Babel + Regex):** Pool de workers en Node (Piscina) que analizan sintaxis de JSX, TSX y lenguajes agnósticos (Astro, Python, PHP) interceptando atributos de clase (`class`, `className`, `class:list`).
84
- 3. **Criptografía de Nomenclatura:** Asignación de Hashes Deterministas (`aumic-component-[hash]`) optimizando la reusabilidad (deduplicación del 100%).
85
- 4. **Motor JIT Embebido:** Generación virtual en memoria y renderizado de CSS de Tailwind usando compilación "Just In Time", fusionando todo en la base nativa.
86
- 5. **Erradicación Total:** Purga de scripts, inyección del archivo CSS puro resultante y limpieza de configuraciones del framework original.
54
+ ### 1. Modo Simulación (Dry-Run)
55
+ *Recomendado para la primera auditoría. Extrae clases, calcula hashes y simula la compilación sin alterar un solo byte de tu código fuente original.*
56
+ \\\ash
57
+ npx @ingcrea/aumic-tailwind-killer -m simulate -t ./mi-landing-page
58
+ \\\
59
+ **Resultado:** Se generará el archivo \umic-lock.json\ con el mapa criptográfico y el \umic-ecosystem.css\ de prueba. Tus archivos \.ts\, \.astro\ o \.html\ quedan intactos.
60
+
61
+ ### 2. Modo Operación Local (Destructivo / Producción)
62
+ *El corazón del motor. Escanea, muta todas las clases legibles a Hashes AUM-IC, inyecta el CSS purgado y **desinstala Tailwind CSS** de tu \package.json\ automáticamente.*
63
+ \\\ash
64
+ npx @ingcrea/aumic-tailwind-killer -m local -t ./frontend-app
65
+ \\\
66
+ **Resultado:** Tu HTML pasará de \<div class="flex items-center text-red-500">\ a \<div class="aumic-rs-1a2b3c aumic-rs-9f8e7d">\. Tailwind será eliminado de tus dependencias y configuraciones respaldadas en \.aumic-bak\.
67
+
68
+ ### 3. Modo Restauración (Rollback)
69
+ *Si cometiste un error o necesitas volver a trabajar con Tailwind, este comando lee el \umic-lock.json\ y revierte tu código fuente a su estado original legible.*
70
+ \\\ash
71
+ npx @ingcrea/aumic-tailwind-killer -m restore -t ./frontend-app
72
+ \\\
87
73
 
88
74
  ---
89
75
 
90
- ## 🛡 Consideraciones de Seguridad
76
+ ## 👨‍💻 Código Fuente y Desarrollo (Monorepo)
91
77
 
92
- * **Backup Automático:** Siempre que la herramienta interviene archivos de configuración (`package.json`, `tailwind.config.js`), genera respaldos con la extensión `.aumic-bak`.
93
- * **Archivos Protegidos:** Por defecto, el motor ignora estrictamente agujeros negros como `node_modules`, `.git`, `dist`, y `.venv`.
78
+ Si deseas clonar el repositorio, ten en cuenta que el código fuente se divide físicamente para respetar las integraciones CI/CD de GitHub Actions:
94
79
 
95
- ---
80
+ - 📁 \src-rust/\: Contiene el manifiesto \Cargo.toml\ y la lógica nativa multiplataforma.
81
+ - 📁 \src-typescript/\: Contiene el motor legacy fuertemente tipado en Node y parsers de AST.
82
+ - 📁 \in/\: Contiene \umic-killer.js\, el Wrapper interceptor inteligente que hace el puente entre NPM y el ejecutable pre-compilado en GitHub Releases.
96
83
 
97
- > Desarrollado bajo la doctrina tecnológica de Ingeniería Creativa. Excelencia, Determinismo y Zero-Trust.
84
+ > Construido bajo los estándares de despliegue de **Ingeniería Creativa**.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ingcrea/aumic-tailwind-killer",
3
- "version": "3.1.4",
3
+ "version": "3.1.5",
4
4
  "description": "Transpilador de Tailwind a CSS3 puro bajo estándar AUM-IC",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -45,4 +45,4 @@
45
45
  "ast",
46
46
  "cli"
47
47
  ]
48
- }
48
+ }