@higinio/design-mcp 0.1.1 → 0.2.0
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/LICENSE +4 -4
- package/README.md +5 -5
- package/assets/bruma/design-doc.md +1083 -0
- package/assets/bruma/framework.css +1374 -0
- package/assets/bruma/styleguide.html +4687 -0
- package/assets/bruma/tailwind.css +121 -0
- package/assets/bruma/tokens.css +147 -0
- package/assets/bruma/tokens.json +995 -0
- package/assets/celeste/design-doc.md +56 -5
- package/assets/celeste/framework.css +93 -4
- package/assets/celeste/styleguide.html +252 -19
- package/assets/nocturna/design-doc.md +63 -12
- package/assets/nocturna/framework.css +102 -7
- package/assets/nocturna/styleguide.html +341 -118
- package/assets/nocturna/tokens.css +8 -3
- package/assets/salvia/design-doc.md +1067 -0
- package/assets/salvia/framework.css +1370 -0
- package/assets/salvia/styleguide.html +4670 -0
- package/assets/salvia/tailwind.css +121 -0
- package/assets/salvia/tokens.css +143 -0
- package/assets/salvia/tokens.json +1023 -0
- package/dist/cli.js +7 -5
- package/dist/doc.js +18 -4
- package/dist/preflight.js +2 -1
- package/dist/server.js +7 -7
- package/dist/systems.js +27 -1
- package/dist/validate.js +13 -5
- package/package.json +9 -31
package/LICENSE
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
Copyright (c) 2026 Higinio Sosa. Todos los derechos reservados.
|
|
2
2
|
|
|
3
|
-
Este software y los sistemas de diseño que contiene ("Celeste Clásica"
|
|
4
|
-
"Nocturna Eléctrica"
|
|
5
|
-
activos, son propiedad de Higinio Sosa y
|
|
6
|
-
uso en sus propios productos.
|
|
3
|
+
Este software y los sistemas de diseño que contiene ("Celeste Clásica",
|
|
4
|
+
"Nocturna Eléctrica", "Salvia Serena" y "Bruma Lavanda"), incluyendo sus
|
|
5
|
+
tokens, componentes, documentación y activos, son propiedad de Higinio Sosa y
|
|
6
|
+
están destinados exclusivamente a uso en sus propios productos.
|
|
7
7
|
|
|
8
8
|
No se concede ninguna licencia, expresa o implícita, para usar, copiar,
|
|
9
9
|
modificar, fusionar, publicar, distribuir, sublicenciar o vender copias de
|
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@ npm run build
|
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
- `npm install` dispara automáticamente el script `prepare` (`sync-assets && build`), así que en un `git clone` limpio con solo `npm install` ya queda todo listo.
|
|
17
|
-
- `sync-assets` copia los tokens y la documentación de cada sistema (`celeste/`, `nocturna/`) a `mcp/assets/` (carpeta gitignored, se regenera siempre desde la fuente).
|
|
17
|
+
- `sync-assets` copia los tokens y la documentación de cada sistema (`celeste/`, `nocturna/`, `salvia/`, `bruma/`) a `mcp/assets/` (carpeta gitignored, se regenera siempre desde la fuente).
|
|
18
18
|
- `build` compila `src/` a `dist/` con `tsc`. Los binarios ejecutables son `dist/index.js` (server MCP, bin `design-mcp`) y `dist/cli.js` (linter, bin `design-lint`; ver **CLI / pre-commit**), ambos con shebang `#!/usr/bin/env node`.
|
|
19
19
|
|
|
20
20
|
Para desarrollo sin compilar: `npm run dev` (ejecuta `src/index.ts` con `tsx`). Para correr los tests: `npm test`.
|
|
@@ -97,20 +97,20 @@ Para desplegarlo en **Dokploy** y conectarlo desde Claude Code (local o remoto),
|
|
|
97
97
|
- `build_ui` — instrucciones para construir UI respetando el sistema de diseño elegido.
|
|
98
98
|
- `audit_ui` — instrucciones para auditar código o una pantalla contra el sistema de diseño elegido.
|
|
99
99
|
- `audit_diseno` — instrucciones para auditar una interfaz con la rúbrica de 14 dimensiones, Nielsen /40, carga cognitiva y las 5 personas, con salida por fases.
|
|
100
|
-
- `recomendar_direccion` — dado un brief de producto, recomienda el sistema (Celeste
|
|
100
|
+
- `recomendar_direccion` — dado un brief de producto, recomienda el sistema (entre Celeste, Nocturna, Salvia y Bruma), los valores de dial (variación/motion/densidad acotados) y una dirección de diseño sobria.
|
|
101
101
|
- `recomendar_grafica` — dada una descripción de datos, recomienda el tipo de gráfica, la paleta (categórica/secuencial/divergente/estado) y el fallback de accesibilidad.
|
|
102
102
|
|
|
103
103
|
**Resources:**
|
|
104
104
|
|
|
105
105
|
- `design://systems` — índice de sistemas disponibles y su metadata.
|
|
106
|
-
- `design://<sistema>/<archivo>` — archivo crudo de un sistema (`tokens.json`, `tokens.css`, `tailwind.css`, `framework.css`, `design-doc.md`, `styleguide.html`), con `<sistema>` = `celeste` o `
|
|
106
|
+
- `design://<sistema>/<archivo>` — archivo crudo de un sistema (`tokens.json`, `tokens.css`, `tailwind.css`, `framework.css`, `design-doc.md`, `styleguide.html`), con `<sistema>` = `celeste`, `nocturna`, `salvia` o `bruma`.
|
|
107
107
|
|
|
108
108
|
## CLI / pre-commit
|
|
109
109
|
|
|
110
110
|
Los cuatro validadores puros (`validate_code`, `validate_motion`, `check_slop`, `checklist_preflight`) también se pueden correr sobre archivos locales sin pasar por MCP, con el binario `design-lint`. Como el paquete está publicado en npm, en otro proyecto lo ejecutas con `npx` sin instalar nada; dentro de este repo apuntas a `dist/cli.js`:
|
|
111
111
|
|
|
112
112
|
```
|
|
113
|
-
design-lint --system celeste|nocturna [--lang css|html|js] [--json] <archivos o globs...>
|
|
113
|
+
design-lint --system celeste|nocturna|salvia|bruma [--lang css|html|js] [--json] <archivos o globs...>
|
|
114
114
|
|
|
115
115
|
# desde cualquier proyecto (paquete publicado)
|
|
116
116
|
npx @higinio/design-mcp design-lint --system celeste "src/**/*.css"
|
|
@@ -164,4 +164,4 @@ Si el IDE mantiene el proceso del servidor corriendo, reinícialo después para
|
|
|
164
164
|
|
|
165
165
|
## Relación con las skills
|
|
166
166
|
|
|
167
|
-
Las skills de Claude (`celeste-clasica-design`, `nocturna-electrica-design`) son la "voz experta": encapsulan criterio, ejemplos y guía narrativa para construir UI con estos sistemas dentro de Claude. Este MCP es la fuente de datos portátil de esos mismos sistemas —tokens, specs de componentes, reglas y validación— accesible desde cualquier IDE o cliente MCP, no solo Claude. Ambos se complementan: la skill explica el criterio, el MCP expone los datos exactos y permite validarlos programáticamente en cualquier entorno.
|
|
167
|
+
Las skills de Claude (`celeste-clasica-design`, `nocturna-electrica-design`, `salvia-serena-design`, `bruma-lavanda-design`) son la "voz experta": encapsulan criterio, ejemplos y guía narrativa para construir UI con estos sistemas dentro de Claude. Este MCP es la fuente de datos portátil de esos mismos sistemas —tokens, specs de componentes, reglas y validación— accesible desde cualquier IDE o cliente MCP, no solo Claude. Ambos se complementan: la skill explica el criterio, el MCP expone los datos exactos y permite validarlos programáticamente en cualquier entorno.
|