@ingcrea/aumic-tailwind-killer 3.1.5 → 3.1.6
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.
- package/README.md +77 -53
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,84 +1,108 @@
|
|
|
1
|
-
|
|
1
|
+
# ⚔️ AUM-IC Tailwind Killer
|
|
2
2
|
|
|
3
|
-
|
|
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).
|
|
4
4
|
|
|
5
|
-
|
|
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 nueva arquitectura de **Doble Núcleo (Rust + TypeScript)** e interceptores AST universales.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
## ⚡
|
|
9
|
+
## ⚡ ¿Por qué crear AUM-IC Tailwind Killer?
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
1. **Ofuscación y Seguridad Corporativa:** Transforma utilidades legibles (`flex items-center text-red-500`) en hashes seguros (`aumic-rs-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 antes de tocar un solo archivo, evitando estados corruptos.
|
|
12
15
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 🦀 Arquitectura de Doble Núcleo: ¿Por qué Rust?
|
|
19
|
+
|
|
20
|
+
Procesar miles de archivos, parsear el DOM y orquestar el compilador JIT en un entorno mono-hilo como Node.js generaba un cuello de botella inaceptable para proyectos masivos. Para alcanzar el pináculo del rendimiento "Zero-Bloat", rediseñamos el núcleo bajo una **arquitectura híbrida infalible**:
|
|
21
|
+
|
|
22
|
+
1. **Motor Nativo en Rust (El Estándar):**
|
|
23
|
+
- Un ejecutable de apenas 2.5 MB.
|
|
24
|
+
- **Concurrencia Multi-Núcleo:** Utiliza la librería `rayon` para procesar archivos en paralelo utilizando el 100% de los hilos de tu CPU.
|
|
25
|
+
- Analiza y muta todo un proyecto en escasos milisegundos usando criptografía segura (`sha2`).
|
|
17
26
|
|
|
18
|
-
2.
|
|
19
|
-
- Sirve como red de seguridad. Si el binario de Rust es bloqueado por políticas corporativas
|
|
27
|
+
2. **Motor de TypeScript (El Fallback Inteligente):**
|
|
28
|
+
- Sirve como red de seguridad. Si el binario de Rust es bloqueado por políticas corporativas, antivirus o usas una arquitectura de hardware exótica, el Wrapper de NPM detecta el fallo y **ejecuta instantáneamente nuestro motor fuertemente tipado en Node.js**.
|
|
29
|
+
- Posee una precisión inigualable mediante el análisis profundo de AST (Babel) para componentes complejos de React/Next.js.
|
|
20
30
|
|
|
21
31
|
---
|
|
22
32
|
|
|
23
|
-
##
|
|
33
|
+
## 🚀 Instalación
|
|
24
34
|
|
|
25
35
|
El Wrapper interceptor distribuirá dinámicamente el ejecutable correspondiente a tu Sistema Operativo (Windows, Linux, macOS).
|
|
26
36
|
|
|
27
|
-
|
|
28
|
-
\\\ash
|
|
29
|
-
npx @ingcrea/aumic-tailwind-killer -m <modo> -t <ruta>
|
|
30
|
-
\\\
|
|
37
|
+
Puedes ejecutarlo al vuelo usando `npx` (recomendado) o instalarlo globalmente:
|
|
31
38
|
|
|
32
|
-
|
|
33
|
-
|
|
39
|
+
```bash
|
|
40
|
+
# Uso al vuelo mediante NPX
|
|
41
|
+
npx @ingcrea/aumic-tailwind-killer -m local -t ./mi-proyecto
|
|
42
|
+
|
|
43
|
+
# Instalación global
|
|
34
44
|
npm install -g @ingcrea/aumic-tailwind-killer
|
|
35
|
-
aumic-tailwind-killer -m
|
|
36
|
-
|
|
45
|
+
aumic-tailwind-killer -m local -t ./mi-proyecto
|
|
46
|
+
```
|
|
37
47
|
|
|
38
48
|
---
|
|
39
49
|
|
|
40
|
-
##
|
|
50
|
+
## 🛠 Casos de Uso y Ejemplos de Ejecución
|
|
51
|
+
|
|
52
|
+
La herramienta opera bajo distintos **modos** de destrucción y auditoría. Asegúrate de estar en una rama de Git limpia antes de realizar mutaciones destructivas.
|
|
53
|
+
|
|
54
|
+
### 1. Modo Simulación (Dry-Run)
|
|
55
|
+
**Caso de uso:** Quieres auditar tu proyecto, ver cuántas clases de Tailwind usas y visualizar el impacto sin modificar tu código fuente.
|
|
41
56
|
|
|
42
|
-
|
|
57
|
+
```bash
|
|
58
|
+
npx @ingcrea/aumic-tailwind-killer -m simulate -t ./
|
|
59
|
+
```
|
|
60
|
+
* **Qué hace:** Escanea el código mediante el Motor Infrarrojo, extrae las utilidades, genera los hashes en memoria y emite el CSS de prueba, pero **no altera** tus archivos.
|
|
43
61
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
62
|
+
### 2. Modo Local (Transmutación Destructiva)
|
|
63
|
+
**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.
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
npx @ingcrea/aumic-tailwind-killer -m local -t ./
|
|
67
|
+
```
|
|
68
|
+
* **Qué hace:** Ejecuta las 5 Fases de AUM-IC. Reescribe físicamente todos los archivos soportados usando los motores paralelos de Rust, inyecta el CSS nativo unificado, elimina dependencias en `package.json` y genera un mapa reverso (`aumic-lock.json`).
|
|
69
|
+
|
|
70
|
+
### 3. Modo Quirúrgico (Surgical Scope)
|
|
71
|
+
**Caso de uso:** Tienes un monorepo gigante y solo quieres ofuscar una carpeta específica (ej. solo el frontend de marketing).
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
npx @ingcrea/aumic-tailwind-killer -m local -t ./ -s "src/frontend/**/*.{tsx,astro}"
|
|
75
|
+
```
|
|
76
|
+
* **Qué hace:** Restringe la mutación **estrictamente** al patrón Glob (Regex) definido en el argumento `-s` (Scope).
|
|
77
|
+
|
|
78
|
+
### 4. Modo Restauración (Rollback)
|
|
79
|
+
**Caso de uso:** Algo falló durante el QA post-mutación o necesitas volver a trabajar con Tailwind en tu entorno local.
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
npx @ingcrea/aumic-tailwind-killer -m restore -t ./
|
|
83
|
+
```
|
|
84
|
+
* **Qué hace:** Lee el mapa criptográfico `aumic-lock.json`, revierte los hashes en tus archivos a sus clases Tailwind originales y restaura las configuraciones de `.aumic-bak`.
|
|
49
85
|
|
|
50
86
|
---
|
|
51
87
|
|
|
52
|
-
##
|
|
88
|
+
## ⚙️ Banderas y Variables (CLI Options)
|
|
53
89
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
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
|
-
\\\
|
|
90
|
+
| Bandera Corta | Bandera Larga | Descripción | Obligatorio |
|
|
91
|
+
| :--- | :--- | :--- | :--- |
|
|
92
|
+
| `-m` | `--mode` | Define el comportamiento del orquestador (`simulate`, `local`, `restore`). | **Sí** |
|
|
93
|
+
| `-t` | `--target` | Ruta absoluta o relativa al directorio del proyecto a procesar. | **Sí** |
|
|
94
|
+
| `-s` | `--scope` | Patrón de búsqueda para restringir la mutación a archivos específicos. | No |
|
|
73
95
|
|
|
74
96
|
---
|
|
75
97
|
|
|
76
|
-
##
|
|
98
|
+
## 🧠 Arquitectura de 5 Fases
|
|
77
99
|
|
|
78
|
-
|
|
100
|
+
1. **Reconocimiento & Pre-Flight:** Validación exhaustiva del sistema de archivos ignorando estrictamente agujeros negros como `node_modules`, `.git` y `dist`.
|
|
101
|
+
2. **Extracción Paralela (Rust Rayon + Babel TS):** Intercepta atributos de clase (`class`, `className`, `class:list`) dividiendo la carga de trabajo entre todos los hilos del procesador.
|
|
102
|
+
3. **Criptografía de Nomenclatura:** Asignación de Hashes Deterministas (`aumic-rs-[hash]`) optimizando la reusabilidad (deduplicación del 100%).
|
|
103
|
+
4. **Motor JIT Embebido:** Generación virtual en memoria y renderizado de CSS de Tailwind usando compilación "Just In Time" invocada como un subproceso nativo del sistema.
|
|
104
|
+
5. **Erradicación Total:** Renombramiento de configuraciones a `.aumic-bak`, inyección del archivo CSS puro resultante y desinstalación forzada del framework original.
|
|
79
105
|
|
|
80
|
-
|
|
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.
|
|
106
|
+
---
|
|
83
107
|
|
|
84
|
-
>
|
|
108
|
+
> Desarrollado bajo la doctrina tecnológica de Ingeniería Creativa. Excelencia, Determinismo y Zero-Trust.
|