orbital-ds 0.16.0 → 0.18.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/scripts/cli.mjs CHANGED
@@ -1,452 +1,452 @@
1
- #!/usr/bin/env node
2
- /**
3
- * orbital-ds — una sola orden para todo:
4
- *
5
- * orbital-ds menú (¿qué quieres hacer?)
6
- * orbital-ds init [opciones] configuración inicial: tema, colores y extras (= orbital-ds-init)
7
- * orbital-ds theme [tema] cambiar de tema conservando tu marca y tus extras
8
- * orbital-ds doctor [opc.] comprobar contrato, contraste y marca (= orbital-ds-doctor)
9
- * orbital-ds i18n [opc.] textos de orbital-ds en los idiomas de la app (= orbital-ds-i18n)
10
- * orbital-ds help esta ayuda
11
- *
12
- * Las órdenes sueltas (orbital-ds-init, -doctor, -i18n) siguen funcionando: son atajos.
13
- */
14
- import { existsSync, readdirSync, readFileSync } from 'node:fs';
15
- import { dirname, join, relative, resolve, sep } from 'node:path';
16
- import { fileURLToPath } from 'node:url';
17
- import { spawnSync } from 'node:child_process';
18
-
19
- import { detectarCssApp, detectarMarca, importsDeTemaSueltos, temaDelCss, yaInstalado } from './setup.mjs';
20
- import { analizarMarca, marcaGenerada, nombresColorTemas } from './brand-file.mjs';
21
- import { estadoSkill, instalarSkill, raizApp, SKILL_NAME } from './skill.mjs';
22
-
23
- const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
24
- const [orden, ...resto] = process.argv.slice(2);
25
- const version = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8')).version;
26
- const temasDir = existsSync(join(ROOT, 'src/themes')) ? join(ROOT, 'src/themes') : join(ROOT, 'dist/themes');
27
- /** Fichas de los temas que trae el paquete. */
28
- const temas = () =>
29
- readdirSync(temasDir)
30
- .filter((f) => f.endsWith('.meta.json'))
31
- .map((f) => JSON.parse(readFileSync(join(temasDir, f), 'utf8')));
32
-
33
- /** Ejecuta otro script del paquete con los mismos stdin/stdout (interactivo incluido). */
34
- function ejecutar(script, args) {
35
- const r = spawnSync(process.execPath, [join(ROOT, 'scripts', script), ...args], { stdio: 'inherit' });
36
- process.exit(r.status ?? 1);
37
- }
38
-
39
- const AYUDA = {
40
- general: `orbital-ds ${version} — sistema de diseño: temas, componentes y herramientas
41
-
42
- Uso: orbital-ds <orden> [opciones] (sin orden, un menú)
43
-
44
- Órdenes
45
- init configuración inicial: tema, colores y extras (asistente)
46
- theme cambiar de tema conservando tu marca y tus extras
47
- doctor comprobar contrato, contraste, pesos y marca
48
- i18n textos de orbital-ds en los idiomas de la app
49
- context resumen de esta app para un agente: tema, marca, componentes y patrones
50
- skill instala o refresca el diseñador de orbital-ds para Claude Code
51
- help esta ayuda · orbital-ds help <orden> para el detalle
52
-
53
- Ejemplos
54
- orbital-ds menú
55
- orbital-ds init asistente paso a paso
56
- orbital-ds theme fractalia pasar a fractalia
57
- orbital-ds doctor --css src/brand.css comprobar tu marca
58
-
59
- Desde un script de package.json: pnpm exec orbital-ds <orden> (o npx orbital-ds <orden>).
60
- Las órdenes antiguas (orbital-ds-init, orbital-ds-doctor, orbital-ds-i18n) siguen valiendo.`,
61
-
62
- init: `orbital-ds init — configuración inicial de la app
63
-
64
- Sin opciones abre el asistente: 1) tema, 2) colores (fiel, solo primario o marca completa;
65
- primario y, si quieres, secundario; ves la paleta y el contraste), 3) extras (animaciones,
66
- Motion, gráficos, tablas, idiomas) y 4) resumen antes de escribir nada. Es la configuración
67
- INICIAL: todo se cambia después en src/brand.css o volviendo a ejecutarlo.
68
-
69
- Sin preguntas (scripts / CI)
70
- --theme <tema> qratia, fractalia, tactile, zyro, friendly, twitter, liquid
71
- --mode <modo> faithful (tema tal cual) · primary (solo tu color) · full (paleta entera)
72
- --primary <color> #1D63D8, rgb(), hsl() u oklch()
73
- --secondary <color> serie 2 de los gráficos y gesto del tema
74
- --connect [--css <f>] conecta el CSS de la app (imports en orden)
75
- --animations activa las animaciones del tema (orbital-ds/motion.css)
76
- --motion --charts --tables instala Motion, ECharts o TanStack Table
77
- --i18n rellena el espacio «orbital» de los JSON de idioma
78
- --update reescribe el bloque generado de brand.css
79
- --dry-run enseña el resultado sin escribir nada
80
- --out <fichero> fichero de marca (por defecto el que importa tu CSS, o src/brand.css)
81
- --clean <alcance> desactiva lo escrito A MANO en brand.css (se comenta, con copia .bak):
82
- colors = colores y variables privadas de un tema · all = todo
83
- --remember-brand (tema fiel) recuerda la marca generada para recuperarla al volver
84
-
85
- Ejemplos
86
- orbital-ds init --theme fractalia --connect --animations
87
- orbital-ds init --theme qratia --mode primary --primary "#0A7D4F" --connect --charts`,
88
-
89
- theme: `orbital-ds theme [tema] — cambiar de tema
90
-
91
- Cambia el import del tema en el CSS de la app y conserva lo tuyo:
92
- - si tu marca se generó desde un color, la recalcula para el tema nuevo (mismo color y modo);
93
- - si el tema nuevo es de un sistema corporativo (fractalia), se usa fiel;
94
- - si tenías las animaciones activas, siguen activas;
95
- - quita los imports del tema anterior que la app cargue en otros ficheros (JS, HTML, otros CSS).
96
- Al volver de un tema fiel a uno que admite marca, recupera la marca que tenías.
97
- Sin tema, pregunta a cuál cambiar.
98
-
99
- Colores escritos a mano en brand.css para el tema anterior (lienzo, tinta, tarjetas…) taparían al
100
- nuevo. El asistente pregunta qué hacer; sin terminal, --brand lo decide (por defecto keep, con aviso):
101
- --brand adapt los quita y aplica tu --primary escrito a mano sobre la paleta del tema nuevo
102
- --brand clean los quita (se comentan, con copia .bak); radios y fuentes se quedan
103
- --brand clean-all comenta todo lo escrito a mano
104
- --brand keep los conserva
105
-
106
- Ejemplos
107
- orbital-ds theme elegir de la lista
108
- orbital-ds theme tactile
109
- orbital-ds theme liquid --brand adapt`,
110
-
111
- doctor: `orbital-ds doctor — comprobar
112
-
113
- orbital-ds doctor --css src/brand.css tu marca: variables que existen, contraste AA,
114
- pesos de letra cargados
115
- orbital-ds doctor --ui src tus vistas no se salen del sistema: colores, medidas y
116
- valores arbitrarios, paleta de Tailwind, !important,
117
- controles nativos sueltos
118
- --aaa mide también el objetivo AAA del texto
119
-
120
- Va bien en el verify de la app: "check:ds": "orbital-ds doctor --css src/brand.css --ui src"`,
121
-
122
- context: `orbital-ds context — lo que un agente necesita saber de ESTA app
123
-
124
- Imprime: versión de orbital-ds, tema activo (esencia, gesto, movimiento, excepciones), cómo está la marca,
125
- extras activos, componentes con sus notas de uso, patrones del diseñador y dónde está la documentación.
126
- Lo lee el skill «orbital-ds-designer» antes de diseñar, y vale para cualquier agente.
127
-
128
- orbital-ds context en texto (markdown)
129
- orbital-ds context --json en JSON`,
130
-
131
- skill: `orbital-ds skill — diseñador de orbital-ds para Claude Code
132
-
133
- Instala (o refresca) el skill «orbital-ds-designer» en la raíz de la app: .claude/skills/orbital-ds-designer/.
134
- Es fino: las reglas largas se leen de node_modules/orbital-ds/docs/designer/, así que al actualizar orbital-ds
135
- ya trabaja con lo nuevo. Lleva la versión estampada; lo que añadas DESPUÉS de su bloque se conserva.
136
-
137
- orbital-ds skill instala o refresca
138
- orbital-ds skill --check comprueba (para el verify): falla si falta o es de otra versión
139
- orbital-ds skill --print enseña el contenido sin escribir nada`,
140
-
141
- i18n: `orbital-ds i18n — textos de orbital-ds en tus idiomas
142
-
143
- orbital-ds i18n rellena el espacio «orbital» de cada JSON (sin pisar lo tuyo)
144
- orbital-ds i18n --check solo comprueba (para el verify): falla si falta algo
145
- --dir <carpeta> carpeta de los JSON (por defecto src/i18n/locales, src/locales…)
146
- --ns <nombre> espacio de nombres (por defecto orbital)
147
-
148
- Añadir un idioma (p. ej. ru): crea ru.json, ejecuta orbital-ds i18n y traduce lo que liste.`,
149
- };
150
-
151
- function ayuda(tema = 'general') {
152
- console.log(AYUDA[tema] ?? AYUDA.general);
153
- }
154
-
155
- /** Lo que falta en la raíz de la app para que las piezas de orbital-ds funcionen del todo. */
156
- function avisosIntegracion(estado) {
157
- const src = resolve('src');
158
- let codigo = '';
159
- const leer = (d) => {
160
- if (!existsSync(d)) return;
161
- for (const n of readdirSync(d, { withFileTypes: true })) {
162
- if (n.name === 'node_modules' || n.name.startsWith('.')) continue;
163
- const p = join(d, n.name);
164
- if (n.isDirectory()) leer(p);
165
- // Sin comentarios: nombrar <Toaster /> en un comentario no cuenta como tenerlo.
166
- else if (/\.(tsx|jsx|ts|js)$/.test(n.name)) codigo += readFileSync(p, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^:])\/\/.*$/gm, '$1');
167
- }
168
- };
169
- leer(src);
170
- const avisos = [];
171
- if (!estado.tema) avisos.push('El CSS de la app no importa ningún tema: ejecuta orbital-ds init (o orbital-ds theme).');
172
- const otros = estado.sueltos;
173
- if (otros.length) avisos.push(`Hay imports de tema fuera del CSS principal (${otros.map((x) => `${relative(process.cwd(), x.fichero)}:${x.linea} → ${x.tema}`).join(', ')}): con dos temas cargados gana el último. orbital-ds theme los quita.`);
174
- if (estado.manual.privadas.length) avisos.push(`brand.css usa variables privadas de un tema (${estado.manual.privadas.map((d) => d.name).join(', ')}): pueden desaparecer. Usa las --ds-* públicas.`);
175
- if (estado.manual.colores.length && estado.marca?.activa) avisos.push(`brand.css tiene ${estado.manual.colores.length} color(es) escritos a mano además de la marca generada: ganan a ella y al tema.`);
176
- if (codigo && !/DsI18nProvider/.test(codigo)) avisos.push('No hay <DsI18nProvider> en la raíz: los textos de orbital-ds salen en inglés (orbital-ds/ui/i18n-provider).');
177
- if (codigo && /\btoast\b/.test(codigo) && !/<Toaster\b/.test(codigo)) avisos.push('Se usa toast pero no hay <Toaster /> en la raíz: los avisos no se verán (orbital-ds/ui/toast).');
178
- if (codigo && /useDsMotion|DsMotionProvider/.test(codigo) && !yaInstalado('motion')) avisos.push('Se usa Motion (useDsMotion/DsMotionProvider) pero el paquete motion no está instalado.');
179
- if (codigo && /useDsMotion/.test(codigo) && !/DsMotionProvider/.test(codigo)) avisos.push('Se usa useDsMotion() sin <DsMotionProvider> en la raíz: envuelve la app para que todo motion.* use el ritmo del tema.');
180
- return avisos;
181
- }
182
-
183
- /** orbital-ds context: el estado real de la app, para un agente (texto o JSON). */
184
- function contexto(json) {
185
- const estado = estadoApp();
186
- const ficha = temas().find((t) => t.name === estado.tema) ?? null;
187
- const manifest = JSON.parse(readFileSync(join(ROOT, 'components.manifest.json'), 'utf8'));
188
- const patronesMd = join(ROOT, 'docs', 'designer', 'patrones.md');
189
- const patrones = existsSync(patronesMd) ? [...readFileSync(patronesMd, 'utf8').matchAll(/^## (P\d+ · .+)$/gm)].map((m) => m[1].trim()) : [];
190
- const brand = estado.brand;
191
- const brandVars = existsSync(brand)
192
- ? [...new Set([...readFileSync(brand, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '').matchAll(/(--[\w-]+)\s*:/g)].map((m) => m[1]))]
193
- : [];
194
- const docs = 'node_modules/orbital-ds';
195
- const datos = {
196
- version,
197
- tema: ficha
198
- ? {
199
- nombre: ficha.name,
200
- etiqueta: ficha.label,
201
- esencia: ficha.essence,
202
- gesto: ficha.signature ?? [],
203
- movimiento: ficha.motion?.about ?? null,
204
- animaciones: ficha.motion?.auto ?? null,
205
- marca: ficha.branding ?? 'full',
206
- excepciones: ficha.a11y?.exceptions ?? [],
207
- guia: `${docs}/dist/themes/${ficha.name}.guide.md`,
208
- }
209
- : null,
210
- marca: estado.marca?.activa ? estado.marca : null,
211
- brandCss: { fichero: existsSync(brand) ? relative(process.cwd(), brand).split(sep).join('/') : null, variables: brandVars, coloresAMano: estado.manual.colores.map((d) => d.name) },
212
- extras: { animaciones: estado.animaciones, motion: yaInstalado('motion'), echarts: yaInstalado('echarts'), tablas: yaInstalado('@tanstack/react-table') },
213
- componentes: Object.fromEntries(Object.entries(manifest.components).map(([n, c]) => [n, { import: c.import, exports: c.exports, ...(c.notes ? { notes: c.notes } : {}) }])),
214
- patrones,
215
- documentacion: {
216
- reglas: `${docs}/AGENTS.md`,
217
- flujo: `${docs}/docs/designer/flujo.md`,
218
- patrones: `${docs}/docs/designer/patrones.md`,
219
- ux: `${docs}/docs/designer/ux.md`,
220
- revision: `${docs}/docs/designer/revision.md`,
221
- manifiesto: `${docs}/components.manifest.json`,
222
- },
223
- skill: estadoSkill(raizApp()).estado,
224
- integracion: avisosIntegracion(estado),
225
- };
226
- if (json) return console.log(JSON.stringify(datos, null, 2));
227
-
228
- const L = [`# orbital-ds ${version} · contexto de esta app`, ''];
229
- if (datos.tema) {
230
- const t = datos.tema;
231
- L.push(`## Tema activo: ${t.etiqueta ?? t.nombre} (${t.nombre})`, t.esencia ?? '');
232
- if (t.gesto.length) L.push(`- Gesto firma: ${t.gesto.join(' · ')}`);
233
- if (t.movimiento) L.push(`- Movimiento: ${t.movimiento}`);
234
- if (t.animaciones) L.push(`- Animaciones (${datos.extras.animaciones ? 'ACTIVAS' : 'inactivas'}): ${t.animaciones.about}`);
235
- L.push(`- Marca: ${t.marca === 'faithful' ? 'sistema corporativo, se usa FIEL' : 'admite marca propia'}`);
236
- if (t.excepciones.length) L.push(`- Excepciones de contraste declaradas: ${t.excepciones.join(', ')}`);
237
- L.push(`- Guía: ${t.guia}`);
238
- } else {
239
- L.push('## Tema activo: no detectado (¿falta conectar el CSS? orbital-ds init)');
240
- }
241
- L.push('', '## Marca de la app');
242
- L.push(datos.marca ? `- Generada desde ${datos.marca.primario} (modo ${datos.marca.modo}, tema ${datos.marca.tema})` : '- Sin bloque generado (tema fiel o marca a mano)');
243
- if (brandVars.length) L.push(`- ${datos.brandCss.fichero} cambia: ${brandVars.join(', ')}`);
244
- if (estado.manual.colores.length) L.push(`- Colores escritos a mano (ganan al tema): ${estado.manual.colores.map((d) => d.name).join(', ')}`);
245
- const sino = (v) => (v ? 'sí' : 'no');
246
- L.push('', '## Extras', `- Animaciones del tema: ${sino(datos.extras.animaciones)} · Motion: ${sino(datos.extras.motion)} · ECharts: ${sino(datos.extras.echarts)} · TanStack Table: ${sino(datos.extras.tablas)}`);
247
- L.push('', `## Componentes (${Object.keys(datos.componentes).length}) · import orbital-ds/ui/<nombre>`, Object.keys(datos.componentes).join(', '));
248
- const conNotas = Object.entries(datos.componentes).filter(([, c]) => c.notes);
249
- if (conNotas.length) {
250
- L.push('', '### Notas de uso');
251
- for (const [n, c] of conNotas) for (const x of c.notes) L.push(`- ${n}: ${x}`);
252
- }
253
- if (datos.integracion.length) L.push('', '## Avisos de integración', ...datos.integracion.map((a) => `- ${a}`));
254
- if (patrones.length) L.push('', '## Patrones (docs/designer/patrones.md)', ...patrones.map((p) => `- ${p}`));
255
- L.push('', '## Documentación', ...Object.entries(datos.documentacion).map(([k, v]) => `- ${k}: ${v}`));
256
- L.push(
257
- '',
258
- '## Reglas que no se rompen',
259
- '- Solo componentes de orbital-ds y variables: nada de colores, medidas, sombras, radios, pesos, duraciones ni z-index a mano.',
260
- '- El aspecto lo ponen el tema y src/brand.css, no la vista. Si falta algo, se anota como hueco de la librería.',
261
- '- Primero el mapa del flujo de la persona; después los patrones; al final, componer y revisar (doctor incluido).',
262
- );
263
- console.log(L.join('\n'));
264
- }
265
-
266
- /** orbital-ds skill [--check | --print] */
267
- function ordenSkill(args) {
268
- if (args.includes('--print')) return console.log(readFileSync(join(ROOT, 'skill', 'SKILL.md'), 'utf8').replaceAll('{{VERSION}}', version));
269
- const raiz = raizApp();
270
- if (args.includes('--check')) {
271
- const e = estadoSkill(raiz);
272
- if (e.estado === 'al-dia') return console.log(`skill ${SKILL_NAME}: al día (${version})`);
273
- console.error(
274
- e.estado === 'falta'
275
- ? `skill ${SKILL_NAME}: no está instalado. Instálalo con: orbital-ds skill`
276
- : `skill ${SKILL_NAME}: es de la versión ${e.version} y orbital-ds es la ${version}. Refréscalo con: orbital-ds skill`,
277
- );
278
- process.exit(1);
279
- }
280
- const r = instalarSkill(raiz);
281
- console.log(`skill ${SKILL_NAME} ${r.accion} (${r.version}): ${r.ruta}`);
282
- }
283
-
284
- function estadoApp() {
285
- const css = detectarCssApp();
286
- const cssTxt = css && existsSync(css) ? readFileSync(css, 'utf8') : '';
287
- const tema = temaDelCss(css);
288
- const animaciones = /orbital-ds\/motion\.css/.test(cssTxt);
289
- const brand = detectarMarca(css);
290
- // marca.activa = false: se quitó al pasar a un tema fiel y se recuerda para recuperarla.
291
- const marca = marcaGenerada(brand);
292
- const manual = analizarMarca(brand, { nombresColor: nombresColorTemas(temasDir) });
293
- const sueltos = importsDeTemaSueltos(css);
294
- return { css, tema, animaciones, brand, marca, manual, sueltos };
295
- }
296
-
297
- /** Parámetros de init para recalcular la marca generada (o recordada) en el tema nuevo. */
298
- const argsMarca = (m) => [
299
- '--primary', m.primario, '--mode', m.modo,
300
- ...(m.secundario ? ['--secondary', m.secundario] : []),
301
- ...(m.acento ? ['--accent', m.acento] : []),
302
- ...(m.marcador === false ? ['--no-marker'] : []),
303
- ];
304
-
305
- /**
306
- * Cambiar de tema: reescribe el import del tema (y quita los que la app cargue aparte), recalcula la
307
- * marca generada para el nuevo y decide qué hacer con los colores escritos A MANO para el anterior,
308
- * que si no taparían al tema nuevo. `--brand adapt|clean|clean-all|keep` lo decide sin preguntar.
309
- */
310
- async function cambiarTema(nuevo, args) {
311
- const lista = temas();
312
- const estado = estadoApp();
313
- const interactivo = process.stdin.isTTY && process.stdout.isTTY;
314
- const p = interactivo ? await import('@clack/prompts') : null;
315
- const val = (n) => { const i = args.indexOf(`--${n}`); return i > -1 ? args[i + 1] : undefined; };
316
- if (!nuevo) {
317
- if (!p) { console.error('Indica el tema: orbital-ds theme <tema>'); process.exit(1); }
318
- p.intro(` orbital-ds ${version} · cambiar de tema `);
319
- if (estado.tema) p.log.info(`Tema actual: ${estado.tema}${estado.marca?.activa ? ` · marca generada desde ${estado.marca.primario} (modo ${estado.marca.modo})` : ' · sin marca generada'}${estado.manual.colores.length ? ` · ${estado.manual.colores.length} color(es) escritos a mano en brand.css` : ''}`);
320
- const v = await p.select({
321
- message: '¿A qué tema cambias?',
322
- initialValue: estado.tema ?? undefined,
323
- options: lista.map((t) => ({ value: t.name, label: t.label ? `${t.label} (${t.name})` : t.name, hint: t.essence })),
324
- });
325
- if (p.isCancel(v)) { p.cancel('Sin cambios.'); return; }
326
- nuevo = v;
327
- }
328
- if (!lista.some((t) => t.name === nuevo)) {
329
- console.error(`El tema «${nuevo}» no existe. Disponibles: ${lista.map((t) => t.name).join(', ')}`);
330
- process.exit(1);
331
- }
332
- const ficha = lista.find((t) => t.name === nuevo);
333
- const fiel = ficha.branding === 'faithful';
334
- const init = ['--theme', nuevo, '--connect', '--update'];
335
- if (estado.css) init.push('--css', estado.css);
336
- if (estado.brand) init.push('--out', estado.brand);
337
- if (estado.animaciones) init.push('--animations');
338
-
339
- // 1 · Marca generada (o recordada de un tema fiel): se recalcula para el tema nuevo.
340
- if (estado.marca && !fiel) init.push(...argsMarca(estado.marca));
341
- else if (estado.marca?.activa) {
342
- init.push('--remember-brand');
343
- console.log(`«${nuevo}» es un tema de sistema corporativo: se usa FIEL y se quita la marca generada (${estado.marca.primario}). Se recuerda: vuelve a ella al pasar a un tema que la admita.`);
344
- }
345
-
346
- // 2 · Colores escritos a mano para el tema anterior: taparían al nuevo.
347
- const colores = estado.manual.colores;
348
- const primManual = !estado.marca && !fiel ? estado.manual.primario : null;
349
- const ejemplo = colores.slice(0, 4).map((d) => `${d.name} ${d.value}`).join(', ') + (colores.length > 4 ? `… (+${colores.length - 4})` : '');
350
- let decision = val('brand');
351
- if (decision && !['adapt', 'clean', 'clean-all', 'keep'].includes(decision)) { console.error(`--brand «${decision}» no válido. Usa: adapt · clean · clean-all · keep`); process.exit(1); }
352
- if (colores.length && nuevo !== estado.tema && !decision) {
353
- if (p) {
354
- p.note(
355
- [
356
- `brand.css tiene ${colores.length} color(es) escritos a mano${estado.tema ? ` para «${estado.tema}»` : ''}:`,
357
- ` ${ejemplo}`,
358
- '',
359
- `brand.css va después del tema: si se quedan, «${nuevo}» no se verá con sus colores.`,
360
- ].join('\n'),
361
- 'Colores del tema anterior',
362
- );
363
- const opciones = [
364
- ...(primManual ? [{ value: 'adapt', label: 'Adaptar mi color al tema nuevo (recomendado)', hint: `quita esos colores y aplica tu primario ${primManual} sobre la paleta de «${nuevo}»` }] : []),
365
- { value: 'clean', label: `Usar los colores de «${nuevo}»${primManual ? '' : ' (recomendado)'}`, hint: 'quita esos colores (se comentan, con copia .bak); radios y fuentes se quedan' },
366
- { value: 'clean-all', label: 'Dejar brand.css limpio', hint: 'comenta todo lo escrito a mano (con copia .bak)' },
367
- { value: 'keep', label: 'Conservarlos', hint: 'seguirán tapando al tema nuevo' },
368
- ];
369
- const v = await p.select({ message: '¿Qué hago con ellos?', initialValue: opciones[0].value, options: opciones });
370
- if (p.isCancel(v)) { p.cancel('Sin cambios.'); return; }
371
- decision = v;
372
- } else {
373
- decision = 'keep';
374
- init.push('--keep-manual');
375
- console.log(`Aviso: brand.css tiene ${colores.length} color(es) escritos a mano (${ejemplo}) que taparán a «${nuevo}». Se conservan.\n Para quitarlos: orbital-ds theme ${nuevo} --brand clean${primManual ? ` · para adaptar tu primario: --brand adapt` : ''}`);
376
- }
377
- }
378
- if (decision === 'adapt' && !primManual) {
379
- console.error(fiel ? `«${nuevo}» se usa fiel: no admite adaptar un primario. Usa --brand clean.` : 'No hay un --primary escrito a mano en brand.css que adaptar. Usa --brand clean.');
380
- process.exit(1);
381
- }
382
- if (decision === 'adapt') init.push('--clean', 'colors', '--primary', primManual, '--mode', 'primary');
383
- if (decision === 'clean') init.push('--clean', 'colors');
384
- if (decision === 'clean-all') init.push('--clean', 'all');
385
- ejecutar('init.mjs', init);
386
- }
387
-
388
- async function menu() {
389
- const p = await import('@clack/prompts');
390
- const estado = estadoApp();
391
- p.intro(` orbital-ds ${version} `);
392
- if (estado.tema) p.log.info(`En esta app: tema ${estado.tema}${estado.marca ? `, marca desde ${estado.marca.primario}` : ''}${estado.animaciones ? ', animaciones activas' : ''}.`);
393
- const v = await p.select({
394
- message: '¿Qué quieres hacer?',
395
- initialValue: estado.tema ? 'theme' : 'init',
396
- options: [
397
- { value: 'init', label: 'Configurar la app', hint: 'tema, colores y extras (también para rehacer la marca)' },
398
- { value: 'theme', label: 'Cambiar de tema', hint: 'conserva tu marca y tus extras' },
399
- { value: 'doctor', label: 'Comprobar mi marca', hint: 'contrato, contraste y pesos' },
400
- { value: 'i18n', label: 'Textos en mis idiomas', hint: 'espacio «orbital» de los JSON de idioma' },
401
- { value: 'skill', label: 'Diseñador para Claude (skill)', hint: 'instala o refresca .claude/skills/orbital-ds-designer' },
402
- ],
403
- });
404
- if (p.isCancel(v)) { p.cancel('Nada que hacer.'); return; }
405
- if (v === 'init') ejecutar('init.mjs', ['--wizard']);
406
- if (v === 'theme') return cambiarTema(null, []);
407
- if (v === 'doctor') ejecutar('doctor.mjs', ['--css', resolve('src/brand.css')]);
408
- if (v === 'i18n') ejecutar('i18n.mjs', []);
409
- if (v === 'skill') return ordenSkill([]);
410
- }
411
-
412
- // Ayuda de una orden: orbital-ds <orden> --help · orbital-ds help <orden>
413
- if (orden && AYUDA[orden] && (resto.includes('--help') || resto.includes('-h'))) {
414
- ayuda(orden);
415
- process.exit(0);
416
- }
417
-
418
- switch (orden) {
419
- case undefined:
420
- if (process.stdin.isTTY && process.stdout.isTTY) await menu();
421
- else ayuda();
422
- break;
423
- case 'init':
424
- ejecutar('init.mjs', resto.length ? resto : ['--wizard']);
425
- break;
426
- case 'theme':
427
- await cambiarTema(resto.find((a, i) => !a.startsWith('--') && resto[i - 1] !== '--brand') ?? null, resto);
428
- break;
429
- case 'doctor':
430
- ejecutar('doctor.mjs', resto);
431
- break;
432
- case 'context':
433
- contexto(resto.includes('--json'));
434
- break;
435
- case 'skill':
436
- ordenSkill(resto);
437
- break;
438
- case 'i18n':
439
- ejecutar('i18n.mjs', resto);
440
- break;
441
- case 'help':
442
- case '--help':
443
- case '-h':
444
- case '--version':
445
- if (orden === '--version') console.log(version);
446
- else ayuda(resto[0]);
447
- break;
448
- default:
449
- console.error(`Orden desconocida: ${orden}\n`);
450
- ayuda();
451
- process.exit(1);
452
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * orbital-ds — una sola orden para todo:
4
+ *
5
+ * orbital-ds menú (¿qué quieres hacer?)
6
+ * orbital-ds init [opciones] configuración inicial: tema, colores y extras (= orbital-ds-init)
7
+ * orbital-ds theme [tema] cambiar de tema conservando tu marca y tus extras
8
+ * orbital-ds doctor [opc.] comprobar contrato, contraste y marca (= orbital-ds-doctor)
9
+ * orbital-ds i18n [opc.] textos de orbital-ds en los idiomas de la app (= orbital-ds-i18n)
10
+ * orbital-ds help esta ayuda
11
+ *
12
+ * Las órdenes sueltas (orbital-ds-init, -doctor, -i18n) siguen funcionando: son atajos.
13
+ */
14
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
15
+ import { dirname, join, relative, resolve, sep } from 'node:path';
16
+ import { fileURLToPath } from 'node:url';
17
+ import { spawnSync } from 'node:child_process';
18
+
19
+ import { detectarCssApp, detectarMarca, importsDeTemaSueltos, temaDelCss, yaInstalado } from './setup.mjs';
20
+ import { analizarMarca, marcaGenerada, nombresColorTemas } from './brand-file.mjs';
21
+ import { estadoSkill, instalarSkill, raizApp, SKILL_NAME } from './skill.mjs';
22
+
23
+ const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
24
+ const [orden, ...resto] = process.argv.slice(2);
25
+ const version = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8')).version;
26
+ const temasDir = existsSync(join(ROOT, 'src/themes')) ? join(ROOT, 'src/themes') : join(ROOT, 'dist/themes');
27
+ /** Fichas de los temas que trae el paquete. */
28
+ const temas = () =>
29
+ readdirSync(temasDir)
30
+ .filter((f) => f.endsWith('.meta.json'))
31
+ .map((f) => JSON.parse(readFileSync(join(temasDir, f), 'utf8')));
32
+
33
+ /** Ejecuta otro script del paquete con los mismos stdin/stdout (interactivo incluido). */
34
+ function ejecutar(script, args) {
35
+ const r = spawnSync(process.execPath, [join(ROOT, 'scripts', script), ...args], { stdio: 'inherit' });
36
+ process.exit(r.status ?? 1);
37
+ }
38
+
39
+ const AYUDA = {
40
+ general: `orbital-ds ${version} — sistema de diseño: temas, componentes y herramientas
41
+
42
+ Uso: orbital-ds <orden> [opciones] (sin orden, un menú)
43
+
44
+ Órdenes
45
+ init configuración inicial: tema, colores y extras (asistente)
46
+ theme cambiar de tema conservando tu marca y tus extras
47
+ doctor comprobar contrato, contraste, pesos y marca
48
+ i18n textos de orbital-ds en los idiomas de la app
49
+ context resumen de esta app para un agente: tema, marca, componentes y patrones
50
+ skill instala o refresca el diseñador de orbital-ds para Claude Code
51
+ help esta ayuda · orbital-ds help <orden> para el detalle
52
+
53
+ Ejemplos
54
+ orbital-ds menú
55
+ orbital-ds init asistente paso a paso
56
+ orbital-ds theme fractalia pasar a fractalia
57
+ orbital-ds doctor --css src/brand.css comprobar tu marca
58
+
59
+ Desde un script de package.json: pnpm exec orbital-ds <orden> (o npx orbital-ds <orden>).
60
+ Las órdenes antiguas (orbital-ds-init, orbital-ds-doctor, orbital-ds-i18n) siguen valiendo.`,
61
+
62
+ init: `orbital-ds init — configuración inicial de la app
63
+
64
+ Sin opciones abre el asistente: 1) tema, 2) colores (fiel, solo primario o marca completa;
65
+ primario y, si quieres, secundario; ves la paleta y el contraste), 3) extras (animaciones,
66
+ Motion, gráficos, tablas, idiomas) y 4) resumen antes de escribir nada. Es la configuración
67
+ INICIAL: todo se cambia después en src/brand.css o volviendo a ejecutarlo.
68
+
69
+ Sin preguntas (scripts / CI)
70
+ --theme <tema> qratia, fractalia, tactile, zyro, friendly, twitter, liquid, lagoon
71
+ --mode <modo> faithful (tema tal cual) · primary (solo tu color) · full (paleta entera)
72
+ --primary <color> #1D63D8, rgb(), hsl() u oklch()
73
+ --secondary <color> serie 2 de los gráficos y gesto del tema
74
+ --connect [--css <f>] conecta el CSS de la app (imports en orden)
75
+ --animations activa las animaciones del tema (orbital-ds/motion.css)
76
+ --motion --charts --tables instala Motion, ECharts o TanStack Table
77
+ --i18n rellena el espacio «orbital» de los JSON de idioma
78
+ --update reescribe el bloque generado de brand.css
79
+ --dry-run enseña el resultado sin escribir nada
80
+ --out <fichero> fichero de marca (por defecto el que importa tu CSS, o src/brand.css)
81
+ --clean <alcance> desactiva lo escrito A MANO en brand.css (se comenta, con copia .bak):
82
+ colors = colores y variables privadas de un tema · all = todo
83
+ --remember-brand (tema fiel) recuerda la marca generada para recuperarla al volver
84
+
85
+ Ejemplos
86
+ orbital-ds init --theme fractalia --connect --animations
87
+ orbital-ds init --theme qratia --mode primary --primary "#0A7D4F" --connect --charts`,
88
+
89
+ theme: `orbital-ds theme [tema] — cambiar de tema
90
+
91
+ Cambia el import del tema en el CSS de la app y conserva lo tuyo:
92
+ - si tu marca se generó desde un color, la recalcula para el tema nuevo (mismo color y modo);
93
+ - si el tema nuevo es de un sistema corporativo (fractalia), se usa fiel;
94
+ - si tenías las animaciones activas, siguen activas;
95
+ - quita los imports del tema anterior que la app cargue en otros ficheros (JS, HTML, otros CSS).
96
+ Al volver de un tema fiel a uno que admite marca, recupera la marca que tenías.
97
+ Sin tema, pregunta a cuál cambiar.
98
+
99
+ Colores escritos a mano en brand.css para el tema anterior (lienzo, tinta, tarjetas…) taparían al
100
+ nuevo. El asistente pregunta qué hacer; sin terminal, --brand lo decide (por defecto keep, con aviso):
101
+ --brand adapt los quita y aplica tu --primary escrito a mano sobre la paleta del tema nuevo
102
+ --brand clean los quita (se comentan, con copia .bak); radios y fuentes se quedan
103
+ --brand clean-all comenta todo lo escrito a mano
104
+ --brand keep los conserva
105
+
106
+ Ejemplos
107
+ orbital-ds theme elegir de la lista
108
+ orbital-ds theme tactile
109
+ orbital-ds theme liquid --brand adapt`,
110
+
111
+ doctor: `orbital-ds doctor — comprobar
112
+
113
+ orbital-ds doctor --css src/brand.css tu marca: variables que existen, contraste AA,
114
+ pesos de letra cargados
115
+ orbital-ds doctor --ui src tus vistas no se salen del sistema: colores, medidas y
116
+ valores arbitrarios, paleta de Tailwind, !important,
117
+ controles nativos sueltos
118
+ --aaa mide también el objetivo AAA del texto
119
+
120
+ Va bien en el verify de la app: "check:ds": "orbital-ds doctor --css src/brand.css --ui src"`,
121
+
122
+ context: `orbital-ds context — lo que un agente necesita saber de ESTA app
123
+
124
+ Imprime: versión de orbital-ds, tema activo (esencia, gesto, movimiento, excepciones), cómo está la marca,
125
+ extras activos, componentes con sus notas de uso, patrones del diseñador y dónde está la documentación.
126
+ Lo lee el skill «orbital-ds-designer» antes de diseñar, y vale para cualquier agente.
127
+
128
+ orbital-ds context en texto (markdown)
129
+ orbital-ds context --json en JSON`,
130
+
131
+ skill: `orbital-ds skill — diseñador de orbital-ds para Claude Code
132
+
133
+ Instala (o refresca) el skill «orbital-ds-designer» en la raíz de la app: .claude/skills/orbital-ds-designer/.
134
+ Es fino: las reglas largas se leen de node_modules/orbital-ds/docs/designer/, así que al actualizar orbital-ds
135
+ ya trabaja con lo nuevo. Lleva la versión estampada; lo que añadas DESPUÉS de su bloque se conserva.
136
+
137
+ orbital-ds skill instala o refresca
138
+ orbital-ds skill --check comprueba (para el verify): falla si falta o es de otra versión
139
+ orbital-ds skill --print enseña el contenido sin escribir nada`,
140
+
141
+ i18n: `orbital-ds i18n — textos de orbital-ds en tus idiomas
142
+
143
+ orbital-ds i18n rellena el espacio «orbital» de cada JSON (sin pisar lo tuyo)
144
+ orbital-ds i18n --check solo comprueba (para el verify): falla si falta algo
145
+ --dir <carpeta> carpeta de los JSON (por defecto src/i18n/locales, src/locales…)
146
+ --ns <nombre> espacio de nombres (por defecto orbital)
147
+
148
+ Añadir un idioma (p. ej. ru): crea ru.json, ejecuta orbital-ds i18n y traduce lo que liste.`,
149
+ };
150
+
151
+ function ayuda(tema = 'general') {
152
+ console.log(AYUDA[tema] ?? AYUDA.general);
153
+ }
154
+
155
+ /** Lo que falta en la raíz de la app para que las piezas de orbital-ds funcionen del todo. */
156
+ function avisosIntegracion(estado) {
157
+ const src = resolve('src');
158
+ let codigo = '';
159
+ const leer = (d) => {
160
+ if (!existsSync(d)) return;
161
+ for (const n of readdirSync(d, { withFileTypes: true })) {
162
+ if (n.name === 'node_modules' || n.name.startsWith('.')) continue;
163
+ const p = join(d, n.name);
164
+ if (n.isDirectory()) leer(p);
165
+ // Sin comentarios: nombrar <Toaster /> en un comentario no cuenta como tenerlo.
166
+ else if (/\.(tsx|jsx|ts|js)$/.test(n.name)) codigo += readFileSync(p, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^:])\/\/.*$/gm, '$1');
167
+ }
168
+ };
169
+ leer(src);
170
+ const avisos = [];
171
+ if (!estado.tema) avisos.push('El CSS de la app no importa ningún tema: ejecuta orbital-ds init (o orbital-ds theme).');
172
+ const otros = estado.sueltos;
173
+ if (otros.length) avisos.push(`Hay imports de tema fuera del CSS principal (${otros.map((x) => `${relative(process.cwd(), x.fichero)}:${x.linea} → ${x.tema}`).join(', ')}): con dos temas cargados gana el último. orbital-ds theme los quita.`);
174
+ if (estado.manual.privadas.length) avisos.push(`brand.css usa variables privadas de un tema (${estado.manual.privadas.map((d) => d.name).join(', ')}): pueden desaparecer. Usa las --ds-* públicas.`);
175
+ if (estado.manual.colores.length && estado.marca?.activa) avisos.push(`brand.css tiene ${estado.manual.colores.length} color(es) escritos a mano además de la marca generada: ganan a ella y al tema.`);
176
+ if (codigo && !/DsI18nProvider/.test(codigo)) avisos.push('No hay <DsI18nProvider> en la raíz: los textos de orbital-ds salen en inglés (orbital-ds/ui/i18n-provider).');
177
+ if (codigo && /\btoast\b/.test(codigo) && !/<Toaster\b/.test(codigo)) avisos.push('Se usa toast pero no hay <Toaster /> en la raíz: los avisos no se verán (orbital-ds/ui/toast).');
178
+ if (codigo && /useDsMotion|DsMotionProvider/.test(codigo) && !yaInstalado('motion')) avisos.push('Se usa Motion (useDsMotion/DsMotionProvider) pero el paquete motion no está instalado.');
179
+ if (codigo && /useDsMotion/.test(codigo) && !/DsMotionProvider/.test(codigo)) avisos.push('Se usa useDsMotion() sin <DsMotionProvider> en la raíz: envuelve la app para que todo motion.* use el ritmo del tema.');
180
+ return avisos;
181
+ }
182
+
183
+ /** orbital-ds context: el estado real de la app, para un agente (texto o JSON). */
184
+ function contexto(json) {
185
+ const estado = estadoApp();
186
+ const ficha = temas().find((t) => t.name === estado.tema) ?? null;
187
+ const manifest = JSON.parse(readFileSync(join(ROOT, 'components.manifest.json'), 'utf8'));
188
+ const patronesMd = join(ROOT, 'docs', 'designer', 'patrones.md');
189
+ const patrones = existsSync(patronesMd) ? [...readFileSync(patronesMd, 'utf8').matchAll(/^## (P\d+ · .+)$/gm)].map((m) => m[1].trim()) : [];
190
+ const brand = estado.brand;
191
+ const brandVars = existsSync(brand)
192
+ ? [...new Set([...readFileSync(brand, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '').matchAll(/(--[\w-]+)\s*:/g)].map((m) => m[1]))]
193
+ : [];
194
+ const docs = 'node_modules/orbital-ds';
195
+ const datos = {
196
+ version,
197
+ tema: ficha
198
+ ? {
199
+ nombre: ficha.name,
200
+ etiqueta: ficha.label,
201
+ esencia: ficha.essence,
202
+ gesto: ficha.signature ?? [],
203
+ movimiento: ficha.motion?.about ?? null,
204
+ animaciones: ficha.motion?.auto ?? null,
205
+ marca: ficha.branding ?? 'full',
206
+ excepciones: ficha.a11y?.exceptions ?? [],
207
+ guia: `${docs}/dist/themes/${ficha.name}.guide.md`,
208
+ }
209
+ : null,
210
+ marca: estado.marca?.activa ? estado.marca : null,
211
+ brandCss: { fichero: existsSync(brand) ? relative(process.cwd(), brand).split(sep).join('/') : null, variables: brandVars, coloresAMano: estado.manual.colores.map((d) => d.name) },
212
+ extras: { animaciones: estado.animaciones, motion: yaInstalado('motion'), echarts: yaInstalado('echarts'), tablas: yaInstalado('@tanstack/react-table') },
213
+ componentes: Object.fromEntries(Object.entries(manifest.components).map(([n, c]) => [n, { import: c.import, exports: c.exports, ...(c.notes ? { notes: c.notes } : {}) }])),
214
+ patrones,
215
+ documentacion: {
216
+ reglas: `${docs}/AGENTS.md`,
217
+ flujo: `${docs}/docs/designer/flujo.md`,
218
+ patrones: `${docs}/docs/designer/patrones.md`,
219
+ ux: `${docs}/docs/designer/ux.md`,
220
+ revision: `${docs}/docs/designer/revision.md`,
221
+ manifiesto: `${docs}/components.manifest.json`,
222
+ },
223
+ skill: estadoSkill(raizApp()).estado,
224
+ integracion: avisosIntegracion(estado),
225
+ };
226
+ if (json) return console.log(JSON.stringify(datos, null, 2));
227
+
228
+ const L = [`# orbital-ds ${version} · contexto de esta app`, ''];
229
+ if (datos.tema) {
230
+ const t = datos.tema;
231
+ L.push(`## Tema activo: ${t.etiqueta ?? t.nombre} (${t.nombre})`, t.esencia ?? '');
232
+ if (t.gesto.length) L.push(`- Gesto firma: ${t.gesto.join(' · ')}`);
233
+ if (t.movimiento) L.push(`- Movimiento: ${t.movimiento}`);
234
+ if (t.animaciones) L.push(`- Animaciones (${datos.extras.animaciones ? 'ACTIVAS' : 'inactivas'}): ${t.animaciones.about}`);
235
+ L.push(`- Marca: ${t.marca === 'faithful' ? 'sistema corporativo, se usa FIEL' : 'admite marca propia'}`);
236
+ if (t.excepciones.length) L.push(`- Excepciones de contraste declaradas: ${t.excepciones.join(', ')}`);
237
+ L.push(`- Guía: ${t.guia}`);
238
+ } else {
239
+ L.push('## Tema activo: no detectado (¿falta conectar el CSS? orbital-ds init)');
240
+ }
241
+ L.push('', '## Marca de la app');
242
+ L.push(datos.marca ? `- Generada desde ${datos.marca.primario} (modo ${datos.marca.modo}, tema ${datos.marca.tema})` : '- Sin bloque generado (tema fiel o marca a mano)');
243
+ if (brandVars.length) L.push(`- ${datos.brandCss.fichero} cambia: ${brandVars.join(', ')}`);
244
+ if (estado.manual.colores.length) L.push(`- Colores escritos a mano (ganan al tema): ${estado.manual.colores.map((d) => d.name).join(', ')}`);
245
+ const sino = (v) => (v ? 'sí' : 'no');
246
+ L.push('', '## Extras', `- Animaciones del tema: ${sino(datos.extras.animaciones)} · Motion: ${sino(datos.extras.motion)} · ECharts: ${sino(datos.extras.echarts)} · TanStack Table: ${sino(datos.extras.tablas)}`);
247
+ L.push('', `## Componentes (${Object.keys(datos.componentes).length}) · import orbital-ds/ui/<nombre>`, Object.keys(datos.componentes).join(', '));
248
+ const conNotas = Object.entries(datos.componentes).filter(([, c]) => c.notes);
249
+ if (conNotas.length) {
250
+ L.push('', '### Notas de uso');
251
+ for (const [n, c] of conNotas) for (const x of c.notes) L.push(`- ${n}: ${x}`);
252
+ }
253
+ if (datos.integracion.length) L.push('', '## Avisos de integración', ...datos.integracion.map((a) => `- ${a}`));
254
+ if (patrones.length) L.push('', '## Patrones (docs/designer/patrones.md)', ...patrones.map((p) => `- ${p}`));
255
+ L.push('', '## Documentación', ...Object.entries(datos.documentacion).map(([k, v]) => `- ${k}: ${v}`));
256
+ L.push(
257
+ '',
258
+ '## Reglas que no se rompen',
259
+ '- Solo componentes de orbital-ds y variables: nada de colores, medidas, sombras, radios, pesos, duraciones ni z-index a mano.',
260
+ '- El aspecto lo ponen el tema y src/brand.css, no la vista. Si falta algo, se anota como hueco de la librería.',
261
+ '- Primero el mapa del flujo de la persona; después los patrones; al final, componer y revisar (doctor incluido).',
262
+ );
263
+ console.log(L.join('\n'));
264
+ }
265
+
266
+ /** orbital-ds skill [--check | --print] */
267
+ function ordenSkill(args) {
268
+ if (args.includes('--print')) return console.log(readFileSync(join(ROOT, 'skill', 'SKILL.md'), 'utf8').replaceAll('{{VERSION}}', version));
269
+ const raiz = raizApp();
270
+ if (args.includes('--check')) {
271
+ const e = estadoSkill(raiz);
272
+ if (e.estado === 'al-dia') return console.log(`skill ${SKILL_NAME}: al día (${version})`);
273
+ console.error(
274
+ e.estado === 'falta'
275
+ ? `skill ${SKILL_NAME}: no está instalado. Instálalo con: orbital-ds skill`
276
+ : `skill ${SKILL_NAME}: es de la versión ${e.version} y orbital-ds es la ${version}. Refréscalo con: orbital-ds skill`,
277
+ );
278
+ process.exit(1);
279
+ }
280
+ const r = instalarSkill(raiz);
281
+ console.log(`skill ${SKILL_NAME} ${r.accion} (${r.version}): ${r.ruta}`);
282
+ }
283
+
284
+ function estadoApp() {
285
+ const css = detectarCssApp();
286
+ const cssTxt = css && existsSync(css) ? readFileSync(css, 'utf8') : '';
287
+ const tema = temaDelCss(css);
288
+ const animaciones = /orbital-ds\/motion\.css/.test(cssTxt);
289
+ const brand = detectarMarca(css);
290
+ // marca.activa = false: se quitó al pasar a un tema fiel y se recuerda para recuperarla.
291
+ const marca = marcaGenerada(brand);
292
+ const manual = analizarMarca(brand, { nombresColor: nombresColorTemas(temasDir) });
293
+ const sueltos = importsDeTemaSueltos(css);
294
+ return { css, tema, animaciones, brand, marca, manual, sueltos };
295
+ }
296
+
297
+ /** Parámetros de init para recalcular la marca generada (o recordada) en el tema nuevo. */
298
+ const argsMarca = (m) => [
299
+ '--primary', m.primario, '--mode', m.modo,
300
+ ...(m.secundario ? ['--secondary', m.secundario] : []),
301
+ ...(m.acento ? ['--accent', m.acento] : []),
302
+ ...(m.marcador === false ? ['--no-marker'] : []),
303
+ ];
304
+
305
+ /**
306
+ * Cambiar de tema: reescribe el import del tema (y quita los que la app cargue aparte), recalcula la
307
+ * marca generada para el nuevo y decide qué hacer con los colores escritos A MANO para el anterior,
308
+ * que si no taparían al tema nuevo. `--brand adapt|clean|clean-all|keep` lo decide sin preguntar.
309
+ */
310
+ async function cambiarTema(nuevo, args) {
311
+ const lista = temas();
312
+ const estado = estadoApp();
313
+ const interactivo = process.stdin.isTTY && process.stdout.isTTY;
314
+ const p = interactivo ? await import('@clack/prompts') : null;
315
+ const val = (n) => { const i = args.indexOf(`--${n}`); return i > -1 ? args[i + 1] : undefined; };
316
+ if (!nuevo) {
317
+ if (!p) { console.error('Indica el tema: orbital-ds theme <tema>'); process.exit(1); }
318
+ p.intro(` orbital-ds ${version} · cambiar de tema `);
319
+ if (estado.tema) p.log.info(`Tema actual: ${estado.tema}${estado.marca?.activa ? ` · marca generada desde ${estado.marca.primario} (modo ${estado.marca.modo})` : ' · sin marca generada'}${estado.manual.colores.length ? ` · ${estado.manual.colores.length} color(es) escritos a mano en brand.css` : ''}`);
320
+ const v = await p.select({
321
+ message: '¿A qué tema cambias?',
322
+ initialValue: estado.tema ?? undefined,
323
+ options: lista.map((t) => ({ value: t.name, label: t.label ? `${t.label} (${t.name})` : t.name, hint: t.essence })),
324
+ });
325
+ if (p.isCancel(v)) { p.cancel('Sin cambios.'); return; }
326
+ nuevo = v;
327
+ }
328
+ if (!lista.some((t) => t.name === nuevo)) {
329
+ console.error(`El tema «${nuevo}» no existe. Disponibles: ${lista.map((t) => t.name).join(', ')}`);
330
+ process.exit(1);
331
+ }
332
+ const ficha = lista.find((t) => t.name === nuevo);
333
+ const fiel = ficha.branding === 'faithful';
334
+ const init = ['--theme', nuevo, '--connect', '--update'];
335
+ if (estado.css) init.push('--css', estado.css);
336
+ if (estado.brand) init.push('--out', estado.brand);
337
+ if (estado.animaciones) init.push('--animations');
338
+
339
+ // 1 · Marca generada (o recordada de un tema fiel): se recalcula para el tema nuevo.
340
+ if (estado.marca && !fiel) init.push(...argsMarca(estado.marca));
341
+ else if (estado.marca?.activa) {
342
+ init.push('--remember-brand');
343
+ console.log(`«${nuevo}» es un tema de sistema corporativo: se usa FIEL y se quita la marca generada (${estado.marca.primario}). Se recuerda: vuelve a ella al pasar a un tema que la admita.`);
344
+ }
345
+
346
+ // 2 · Colores escritos a mano para el tema anterior: taparían al nuevo.
347
+ const colores = estado.manual.colores;
348
+ const primManual = !estado.marca && !fiel ? estado.manual.primario : null;
349
+ const ejemplo = colores.slice(0, 4).map((d) => `${d.name} ${d.value}`).join(', ') + (colores.length > 4 ? `… (+${colores.length - 4})` : '');
350
+ let decision = val('brand');
351
+ if (decision && !['adapt', 'clean', 'clean-all', 'keep'].includes(decision)) { console.error(`--brand «${decision}» no válido. Usa: adapt · clean · clean-all · keep`); process.exit(1); }
352
+ if (colores.length && nuevo !== estado.tema && !decision) {
353
+ if (p) {
354
+ p.note(
355
+ [
356
+ `brand.css tiene ${colores.length} color(es) escritos a mano${estado.tema ? ` para «${estado.tema}»` : ''}:`,
357
+ ` ${ejemplo}`,
358
+ '',
359
+ `brand.css va después del tema: si se quedan, «${nuevo}» no se verá con sus colores.`,
360
+ ].join('\n'),
361
+ 'Colores del tema anterior',
362
+ );
363
+ const opciones = [
364
+ ...(primManual ? [{ value: 'adapt', label: 'Adaptar mi color al tema nuevo (recomendado)', hint: `quita esos colores y aplica tu primario ${primManual} sobre la paleta de «${nuevo}»` }] : []),
365
+ { value: 'clean', label: `Usar los colores de «${nuevo}»${primManual ? '' : ' (recomendado)'}`, hint: 'quita esos colores (se comentan, con copia .bak); radios y fuentes se quedan' },
366
+ { value: 'clean-all', label: 'Dejar brand.css limpio', hint: 'comenta todo lo escrito a mano (con copia .bak)' },
367
+ { value: 'keep', label: 'Conservarlos', hint: 'seguirán tapando al tema nuevo' },
368
+ ];
369
+ const v = await p.select({ message: '¿Qué hago con ellos?', initialValue: opciones[0].value, options: opciones });
370
+ if (p.isCancel(v)) { p.cancel('Sin cambios.'); return; }
371
+ decision = v;
372
+ } else {
373
+ decision = 'keep';
374
+ init.push('--keep-manual');
375
+ console.log(`Aviso: brand.css tiene ${colores.length} color(es) escritos a mano (${ejemplo}) que taparán a «${nuevo}». Se conservan.\n Para quitarlos: orbital-ds theme ${nuevo} --brand clean${primManual ? ` · para adaptar tu primario: --brand adapt` : ''}`);
376
+ }
377
+ }
378
+ if (decision === 'adapt' && !primManual) {
379
+ console.error(fiel ? `«${nuevo}» se usa fiel: no admite adaptar un primario. Usa --brand clean.` : 'No hay un --primary escrito a mano en brand.css que adaptar. Usa --brand clean.');
380
+ process.exit(1);
381
+ }
382
+ if (decision === 'adapt') init.push('--clean', 'colors', '--primary', primManual, '--mode', 'primary');
383
+ if (decision === 'clean') init.push('--clean', 'colors');
384
+ if (decision === 'clean-all') init.push('--clean', 'all');
385
+ ejecutar('init.mjs', init);
386
+ }
387
+
388
+ async function menu() {
389
+ const p = await import('@clack/prompts');
390
+ const estado = estadoApp();
391
+ p.intro(` orbital-ds ${version} `);
392
+ if (estado.tema) p.log.info(`En esta app: tema ${estado.tema}${estado.marca ? `, marca desde ${estado.marca.primario}` : ''}${estado.animaciones ? ', animaciones activas' : ''}.`);
393
+ const v = await p.select({
394
+ message: '¿Qué quieres hacer?',
395
+ initialValue: estado.tema ? 'theme' : 'init',
396
+ options: [
397
+ { value: 'init', label: 'Configurar la app', hint: 'tema, colores y extras (también para rehacer la marca)' },
398
+ { value: 'theme', label: 'Cambiar de tema', hint: 'conserva tu marca y tus extras' },
399
+ { value: 'doctor', label: 'Comprobar mi marca', hint: 'contrato, contraste y pesos' },
400
+ { value: 'i18n', label: 'Textos en mis idiomas', hint: 'espacio «orbital» de los JSON de idioma' },
401
+ { value: 'skill', label: 'Diseñador para Claude (skill)', hint: 'instala o refresca .claude/skills/orbital-ds-designer' },
402
+ ],
403
+ });
404
+ if (p.isCancel(v)) { p.cancel('Nada que hacer.'); return; }
405
+ if (v === 'init') ejecutar('init.mjs', ['--wizard']);
406
+ if (v === 'theme') return cambiarTema(null, []);
407
+ if (v === 'doctor') ejecutar('doctor.mjs', ['--css', resolve('src/brand.css')]);
408
+ if (v === 'i18n') ejecutar('i18n.mjs', []);
409
+ if (v === 'skill') return ordenSkill([]);
410
+ }
411
+
412
+ // Ayuda de una orden: orbital-ds <orden> --help · orbital-ds help <orden>
413
+ if (orden && AYUDA[orden] && (resto.includes('--help') || resto.includes('-h'))) {
414
+ ayuda(orden);
415
+ process.exit(0);
416
+ }
417
+
418
+ switch (orden) {
419
+ case undefined:
420
+ if (process.stdin.isTTY && process.stdout.isTTY) await menu();
421
+ else ayuda();
422
+ break;
423
+ case 'init':
424
+ ejecutar('init.mjs', resto.length ? resto : ['--wizard']);
425
+ break;
426
+ case 'theme':
427
+ await cambiarTema(resto.find((a, i) => !a.startsWith('--') && resto[i - 1] !== '--brand') ?? null, resto);
428
+ break;
429
+ case 'doctor':
430
+ ejecutar('doctor.mjs', resto);
431
+ break;
432
+ case 'context':
433
+ contexto(resto.includes('--json'));
434
+ break;
435
+ case 'skill':
436
+ ordenSkill(resto);
437
+ break;
438
+ case 'i18n':
439
+ ejecutar('i18n.mjs', resto);
440
+ break;
441
+ case 'help':
442
+ case '--help':
443
+ case '-h':
444
+ case '--version':
445
+ if (orden === '--version') console.log(version);
446
+ else ayuda(resto[0]);
447
+ break;
448
+ default:
449
+ console.error(`Orden desconocida: ${orden}\n`);
450
+ ayuda();
451
+ process.exit(1);
452
+ }