orbital-ds 0.12.0 → 0.13.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.
Files changed (57) hide show
  1. package/AGENTS.md +32 -4
  2. package/README.md +93 -93
  3. package/components.manifest.json +66 -14
  4. package/dist/motion.css +139 -0
  5. package/dist/styles.css +15 -2
  6. package/dist/themes/fractalia.css +473 -464
  7. package/dist/themes/fractalia.fonts.css +3 -3
  8. package/dist/themes/fractalia.guide.md +79 -77
  9. package/dist/themes/fractalia.meta.json +99 -96
  10. package/dist/themes/fractalia.scoped.css +473 -464
  11. package/dist/themes/friendly.css +7 -1
  12. package/dist/themes/friendly.meta.json +7 -0
  13. package/dist/themes/friendly.scoped.css +7 -1
  14. package/dist/themes/qratia.css +13 -8
  15. package/dist/themes/qratia.meta.json +8 -1
  16. package/dist/themes/qratia.scoped.css +13 -8
  17. package/dist/themes/tactile.css +7 -1
  18. package/dist/themes/tactile.meta.json +7 -0
  19. package/dist/themes/tactile.scoped.css +7 -1
  20. package/dist/themes/twitter.css +7 -1
  21. package/dist/themes/twitter.meta.json +7 -0
  22. package/dist/themes/twitter.scoped.css +7 -1
  23. package/dist/themes/zyro.css +7 -1
  24. package/dist/themes/zyro.meta.json +7 -0
  25. package/dist/themes/zyro.scoped.css +7 -1
  26. package/dist/ui/alert.js +6 -5
  27. package/dist/ui/attachment.d.ts +1 -1
  28. package/dist/ui/badge.js +6 -6
  29. package/dist/ui/banner.js +4 -4
  30. package/dist/ui/button.d.ts +1 -1
  31. package/dist/ui/combobox.js +1 -1
  32. package/dist/ui/context-menu.js +4 -4
  33. package/dist/ui/dropdown-menu.js +4 -4
  34. package/dist/ui/input-group.d.ts +1 -1
  35. package/dist/ui/item.d.ts +3 -3
  36. package/dist/ui/item.js +14 -4
  37. package/dist/ui/marker.d.ts +1 -1
  38. package/dist/ui/menubar.js +4 -4
  39. package/dist/ui/native-select.js +2 -2
  40. package/dist/ui/select.js +7 -8
  41. package/dist/ui/stat.d.ts +11 -1
  42. package/dist/ui/stat.js +13 -3
  43. package/dist/ui/status-badge.js +6 -6
  44. package/docs/adr/0002-sistemas-corporativos-al-modelo.md +176 -176
  45. package/docs/designer/flujo.md +79 -0
  46. package/docs/designer/patrones.md +116 -0
  47. package/docs/designer/revision.md +60 -0
  48. package/docs/designer/ux.md +71 -0
  49. package/package.json +9 -2
  50. package/scripts/brand-core.mjs +51 -13
  51. package/scripts/cli.mjs +370 -0
  52. package/scripts/doctor.mjs +578 -509
  53. package/scripts/init.mjs +187 -125
  54. package/scripts/manifest.mjs +85 -79
  55. package/scripts/setup.mjs +2 -1
  56. package/scripts/skill.mjs +67 -0
  57. package/skill/SKILL.md +47 -0
package/scripts/init.mjs CHANGED
@@ -19,6 +19,11 @@
19
19
  * --theme <tema> tema para el que se genera (por defecto: el que importa tu CSS, o qratia)
20
20
  * --mode <modo> faithful · primary · full (sin --primary: faithful)
21
21
  * --primary <color> color primario: hex, rgb(), hsl() u oklch()
22
+ * --secondary <color> color secundario: serie 2 de los gráficos y acento del gesto del tema
23
+ * --animations activa las animaciones del tema (añade orbital-ds/motion.css a los imports)
24
+ * --charts instala ECharts (gráficos e informes) · --tables instala TanStack Table
25
+ *
26
+ * También desde la orden única: orbital-ds init [opciones] · orbital-ds help init
22
27
  * --accent <color> color de acento/gesto (si no, el complementario del primario)
23
28
  * --no-marker apaga el rotulador del tema (si el tema lo tiene)
24
29
  * --out <fichero> fichero de marca (por defecto src/brand.css)
@@ -58,6 +63,7 @@ const opt = (n) => { const i = args.indexOf(`--${n}`); return i > -1 && args[i +
58
63
 
59
64
  import { parseColor, derivar, hex, ratio, rgbToOklch, ok } from './brand-core.mjs';
60
65
  import { detectarCssApp, conectarCss, gestorPaquetes, comandoInstalar, instalar, yaInstalado } from './setup.mjs';
66
+ import { instalarSkill, usaClaude, estadoSkill } from './skill.mjs';
61
67
 
62
68
  /** Ruta relativa al directorio de trabajo, con barras normales (para mostrarla). */
63
69
  const relPath = (f) => f.replace(process.cwd(), '.').split('\\').join('/');
@@ -182,6 +188,8 @@ function resumenFicha(tema) {
182
188
  ];
183
189
  if (f.fonts) lineas.push(`Fuentes ${f.fonts.display} (títulos) · ${f.fonts.body} (texto)`);
184
190
  if (f.signature?.length) lineas.push('', 'Gesto firma:', ...f.signature.map((s) => ` · ${s}`));
191
+ if (f.motion?.about || f.motion?.auto?.about) lineas.push('', `Movimiento: ${f.motion.about ?? ''}${f.motion.auto?.about ? `
192
+ Animaciones (si las activas): ${f.motion.auto.about}` : ''}`);
185
193
  if (f.a11y?.exceptions?.length) lineas.push('', `Excepciones de contraste declaradas: ${f.a11y.exceptions.join(', ')}`);
186
194
  if (f.status?.pending?.length) lineas.push('', 'Pendiente en su sistema:', ...f.status.pending.map((s) => ` · ${s}`));
187
195
  if (f.branding === 'faithful') lineas.push('', 'Tema de un sistema corporativo: se recomienda usarlo FIEL (sin derivar marca).');
@@ -192,25 +200,36 @@ function resumenFicha(tema) {
192
200
  /** Pares de contraste del modo «solo primario», medidos contra la paleta real del tema. */
193
201
  function paresPrimario(res, tema) {
194
202
  const { claro, oscuro } = paletaTema(tema);
195
- const par = (piel, nombre, f, b) => { const x = parseColor(f ?? ''), y = parseColor(b ?? ''); return x && y ? { piel, nombre, r: ratio(x, y) } : null; };
203
+ const par = (piel, nombre, f, b, min = 4.5) => { const x = parseColor(f ?? ''), y = parseColor(b ?? ''); return x && y ? { piel, nombre, r: ratio(x, y), min } : null; };
196
204
  return [
197
205
  par('claro', 'texto sobre primario', res.claro['primary-foreground'], res.claro.primary),
198
206
  par('claro', 'enlace/lienzo', res.claro.link, claro.background),
199
207
  par('claro', 'enlace/tarjeta', res.claro.link, claro.card),
200
208
  par('claro', 'texto lateral activo', res.claro['sidebar-primary-foreground'], res.claro['sidebar-primary']),
209
+ par('claro', 'foco/lienzo', res.claro.ring, claro.background, 3),
210
+ ...['chart-1', 'chart-2'].filter((k) => res.claro[k]).map((k) => par('claro', `serie ${k.slice(-1)}/lienzo`, res.claro[k], claro.background, 3)),
201
211
  par('oscuro', 'texto sobre primario', res.oscuro['primary-foreground'], res.oscuro.primary),
202
212
  par('oscuro', 'enlace/lienzo', res.oscuro.link, oscuro.background),
213
+ par('oscuro', 'foco/lienzo', res.oscuro.ring, oscuro.background, 3),
214
+ ...['chart-1', 'chart-2'].filter((k) => res.oscuro[k]).map((k) => par('oscuro', `serie ${k.slice(-1)}/lienzo`, res.oscuro[k], oscuro.background, 3)),
203
215
  ].filter(Boolean);
204
216
  }
205
217
 
206
218
  /** Calcula la marca según el modo. */
207
- function calcular(modo, tema, primario, { acento, marcador }) {
219
+ function calcular(modo, tema, primario, { acento, secundario = null, marcador = true }) {
208
220
  const gestos = tieneGestos(tema);
209
221
  if (modo === 'primary') {
210
- const res = derivar(primario, { acento, marcador, gestos, base: baseTema(tema) });
211
- return { ...res, claro: soloPrimario(res.claro), oscuro: soloPrimario(res.oscuro), pares: paresPrimario(res, tema) };
222
+ const res = derivar(primario, { acento, secundario, marcador, gestos, base: baseTema(tema) });
223
+ // Solo el primario (y la serie 2 si hay secundario): el resto de series es la del tema.
224
+ const quedan = (tokens) => Object.fromEntries(Object.entries(tokens).filter(([k]) => TOKENS_PRIMARIO.has(k) || (secundario && k === 'chart-2')));
225
+ const claro = quedan(res.claro), oscuro = quedan(res.oscuro);
226
+ // La vista enseña las series que se USARÁN: las nuevas (1 y, con secundario, 2) y el resto, del tema.
227
+ const tem = paletaTema(tema);
228
+ const serie = (nuevo, delTema, i) => parseColor(nuevo[`chart-${i}`] ?? delTema[`chart-${i}`] ?? '') ?? undefined;
229
+ const muestras = { ...res.muestras, seriesC: [1, 2, 3, 4, 5].map((i) => serie(claro, tem.claro, i)).filter(Boolean), seriesO: [1, 2, 3, 4, 5].map((i) => serie(oscuro, tem.oscuro, i)).filter(Boolean) };
230
+ return { ...res, claro, oscuro, muestras, pares: paresPrimario({ claro, oscuro }, tema) };
212
231
  }
213
- return derivar(primario, { acento, marcador, gestos });
232
+ return derivar(primario, { acento, secundario, marcador, gestos });
214
233
  }
215
234
 
216
235
  /* ═══════════════════════════════ FLUJO ═══════════════════════════════════════ */
@@ -275,162 +294,198 @@ Siguientes pasos
275
294
  }
276
295
 
277
296
  function mostrar(res, tema, primario) {
278
- const m = res.muestras;
279
297
  console.log(`\nMarca derivada de ${primario} para el tema «${tema}»\n`);
280
- console.log(` Claro ${muestra(m.papel)}papel ${hex(m.papel)} ${muestra(m.tinta)}tinta ${hex(m.tinta)} ${muestra(m.prim)}primario ${hex(m.prim)} ${muestra(m.acentoC)}acento ${hex(m.acentoC)}`);
281
- console.log(` Oscuro ${muestra(m.fondoO)}fondo ${hex(m.fondoO)} ${muestra(m.textoO)}texto ${hex(m.textoO)} ${muestra(m.primO)}primario ${hex(m.primO)}\n`);
282
- console.log(' Contraste (mínimo AA 4.5:1):');
283
- for (const p of res.pares) console.log(` ${p.r >= 7 ? '✓ AAA' : p.r >= 4.5 ? '✓ AA ' : '✗ '} ${p.r.toFixed(2).padStart(5)}:1 ${p.piel.padEnd(6)} ${p.nombre}`);
298
+ console.log(paletaVisual(res));
284
299
  for (const a of res.avisos) console.log(` ! ${a}`);
285
300
  console.log('');
286
301
  }
287
302
 
303
+ /** Paleta que se va a usar, en muestras de color, y el resumen del contraste. */
304
+ function paletaVisual(res) {
305
+ const m = res.muestras;
306
+ const fila = (pares) => pares.filter(([, c]) => c).map(([n, c]) => `${muestra(c)}${n} ${hex(c)}`).join(' ');
307
+ const series = (lista) => (lista ?? []).map((c) => muestra(c)).join('') + ' ' + (lista ?? []).map(hex).join(' ');
308
+ const malos = res.pares.filter((x) => x.r < (x.min ?? 4.5));
309
+ return [
310
+ 'CLARA',
311
+ ` ${fila([['lienzo', m.papel], ['texto', m.tinta], ['primario', m.prim], ['secundario', m.secundario]])}`,
312
+ ` gráficos ${series(m.seriesC)}`,
313
+ 'OSCURA',
314
+ ` ${fila([['lienzo', m.fondoO], ['texto', m.textoO], ['primario', m.primO]])}`,
315
+ ` gráficos ${series(m.seriesO)}`,
316
+ '',
317
+ malos.length
318
+ ? `Contraste: ${res.pares.length - malos.length} de ${res.pares.length} pares bien; por ajustar:\n${malos.map((x) => ` ✗ ${x.r.toFixed(2)}:1 (mín. ${x.min ?? 4.5}) ${x.piel} ${x.nombre}`).join('\n')}`
319
+ : `Contraste: los ${res.pares.length} pares cumplen (texto 4,5:1 · foco y gráficos 3:1, en claro y oscuro).`,
320
+ ].join('\n');
321
+ }
322
+
323
+ const EXTRAS = {
324
+ animations: { label: 'Animaciones del tema', hint: 'entradas en cascada y tarjetas pulsables, con el ritmo del tema; sin código' },
325
+ motion: { label: 'Motion, para animaciones a medida', hint: 'librería opcional: <DsMotionProvider> + useDsMotion()', pkgs: ['motion'] },
326
+ charts: { label: 'Gráficos e informes (ECharts)', hint: '<EChart> con los colores del tema y SVG en servidor', pkgs: ['echarts'] },
327
+ tables: { label: 'Tablas de datos (TanStack Table)', hint: '<DataTable> con orden, filtros y paginación', pkgs: ['@tanstack/react-table'] },
328
+ designer: { label: 'Diseñador para Claude (skill orbital-ds-designer)', hint: 'Claude diseña con los patrones del sistema y nunca se sale de él' },
329
+ };
330
+
288
331
  async function asistente() {
289
332
  const p = await import('@clack/prompts');
290
333
  const salir = (v) => { if (p.isCancel(v)) { p.cancel('Cancelado: no se ha escrito nada.'); process.exit(0); } return v; };
334
+ const version = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8')).version;
291
335
 
292
- p.intro(' orbital-ds · asistente de marca ');
336
+ p.intro(` orbital-ds ${version} · configuración inicial `);
337
+ p.note(
338
+ [
339
+ 'Vamos a dejar tu app lista en unos pasos: tema, colores y extras.',
340
+ 'Es la CONFIGURACIÓN INICIAL: todo se puede cambiar después en src/brand.css',
341
+ '(es tu fichero) o volviendo a ejecutar este asistente. Nada se escribe hasta el final.',
342
+ ].join('\n'),
343
+ 'Bienvenida',
344
+ );
293
345
 
346
+ /* 1 · Tema */
294
347
  const tema = salir(await p.select({
295
- message: '¿Qué tema quieres?',
348
+ message: '1/4 · ¿Qué tema quieres usar?',
296
349
  initialValue: TEMA_CSS,
297
- options: temas.map((t) => ({ value: t.name, label: t.label ? `${t.name} · ${t.label}` : t.name, hint: t.essence })),
350
+ options: temas.map((t) => ({ value: t.name, label: t.label ? `${t.label} (${t.name})` : t.name, hint: t.essence })),
298
351
  }));
299
-
300
352
  p.note(resumenFicha(tema), `Tema «${tema}»`);
301
353
 
354
+ /* 2 · Colores */
302
355
  const recomendado = modoRecomendado(tema);
303
356
  const modo = salir(await p.select({
304
- message: '¿Cómo aplico tu marca sobre el tema?',
357
+ message: '2/4 · ¿Cómo quieres los colores?',
305
358
  initialValue: recomendado,
306
359
  options: Object.entries(MODOS).map(([value, m]) => ({ value, label: value === recomendado ? `${m.label} (recomendado)` : m.label, hint: m.hint })),
307
360
  }));
308
361
 
309
362
  const out = resolve(opt('out') ?? 'src/brand.css');
310
- if (modo === 'faithful') return aplicarPlan(p, salir, { tema, modo, out, res: null, primario: null });
311
-
312
- const raw = salir(await p.text({
313
- message: modo === 'primary' ? 'Color primario (el resto de la paleta es la del tema)' : 'Color primario de tu marca',
314
- placeholder: '#1D63D8 · rgb(29 99 216) · hsl(219 76% 48%) · oklch(0.55 0.2 260)',
315
- validate: (v) => (v && parseColor(v) ? undefined : 'No entiendo ese color. Prueba con #1D63D8, rgb(), hsl() u oklch().'),
316
- }));
317
- const primario = parseColor(raw);
318
-
319
- const gestos = tieneGestos(tema);
320
- let marcador = true, acento;
321
- if (gestos) {
322
- const P = rgbToOklch(primario);
323
- const prop = [['complementario', 180], ['análogo', 30], ['triádico', 120]].map(([n, d]) => [n, ok(0.82, 0.16, (P.h + d) % 360)]);
324
- const elegido = salir(await p.select({
325
- message: 'Acento (color del rotulador y detalles)',
326
- options: [...prop.map(([n, c]) => ({ value: hex(c), label: `${muestra(c)}${n}`, hint: hex(c) })), { value: 'otro', label: 'Otro color…' }],
327
- }));
328
- acento = elegido === 'otro'
329
- ? parseColor(salir(await p.text({ message: 'Color del acento', validate: (v) => (parseColor(v ?? '') ? undefined : 'Color no válido') })))
330
- : parseColor(elegido);
331
- marcador = salir(await p.confirm({ message: '¿Rotulador bajo los títulos?', initialValue: true }));
363
+ let res = null, primario = null, secundario = null;
364
+ if (modo !== 'faithful') {
365
+ const gestos = tieneGestos(tema);
366
+ for (;;) {
367
+ primario = parseColor(salir(await p.text({
368
+ message: modo === 'primary' ? 'Color principal de tu marca (el resto de la paleta será la del tema)' : 'Color principal de tu marca',
369
+ placeholder: '#1D63D8 · rgb(29 99 216) · hsl(219 76% 48%) · oklch(0.55 0.2 260)',
370
+ initialValue: primario ? hex(primario) : undefined,
371
+ validate: (v) => (v && parseColor(v) ? undefined : 'No entiendo ese color. Prueba con #1D63D8, rgb(), hsl() u oklch().'),
372
+ })));
373
+ const quiereSec = salir(await p.confirm({
374
+ active: 'Sí',
375
+ inactive: 'No',
376
+ message: `¿Añades un color secundario?${gestos ? ' (se usa en los gráficos y en el gesto del tema)' : ' (se usa como segunda serie de los gráficos)'}`,
377
+ initialValue: Boolean(secundario),
378
+ }));
379
+ secundario = null;
380
+ if (quiereSec) {
381
+ const P = rgbToOklch(primario);
382
+ const prop = [['complementario', 180], ['análogo', 35], ['triádico', 120]].map(([n, d]) => [n, ok(0.7, Math.max(0.12, Math.min(P.c, 0.18)), (P.h + d) % 360)]);
383
+ const elegido = salir(await p.select({
384
+ message: 'Color secundario',
385
+ options: [...prop.map(([n, c]) => ({ value: hex(c), label: `${muestra(c)}${n}`, hint: hex(c) })), { value: 'otro', label: 'Otro color…' }],
386
+ }));
387
+ secundario = elegido === 'otro'
388
+ ? parseColor(salir(await p.text({ message: 'Color secundario', validate: (v) => (parseColor(v ?? '') ? undefined : 'Color no válido') })))
389
+ : parseColor(elegido);
390
+ }
391
+ const marcador = gestos ? salir(await p.confirm({ message: '¿Rotulador bajo los títulos? (gesto del tema)', active: 'Sí', inactive: 'No', initialValue: true })) : true;
392
+
393
+ res = calcular(modo, tema, primario, { secundario, marcador });
394
+ p.note(
395
+ [
396
+ modo === 'primary'
397
+ ? 'Cambian solo el color principal (botones, foco, enlaces, lateral activo) y, si lo has dado, el secundario.\nEl lienzo, el texto, las tarjetas y los estados siguen siendo los del tema.'
398
+ : 'Cambia la paleta entera (neutros, lateral, gráficos y las dos pieles). La forma, las fuentes y el\nmovimiento siguen siendo los del tema.',
399
+ '',
400
+ paletaVisual(res),
401
+ ...res.avisos.map((a) => `! ${a}`),
402
+ ].join('\n'),
403
+ 'Tu paleta',
404
+ );
405
+ if (salir(await p.confirm({ message: '¿Te gusta así?', active: 'Sí, seguir', inactive: 'No, elegir otros colores', initialValue: true }))) break;
406
+ }
332
407
  }
333
408
 
334
- const res = calcular(modo, tema, primario, { acento, marcador });
335
- const m = res.muestras;
336
- const filas = res.pares.map((x) => `${x.r >= 7 ? '✓ AAA' : x.r >= 4.5 ? '✓ AA ' : '✗ '} ${x.r.toFixed(2).padStart(5)}:1 ${x.piel.padEnd(6)} ${x.nombre}`);
337
- p.note(
338
- [
339
- modo === 'primary'
340
- ? `Cambia: ${Object.keys(res.claro).map((k) => `--${k}`).join(', ')}\nEl lienzo, la tinta, las tarjetas, los bordes y los estados siguen siendo los del tema.`
341
- : 'Cambia la paleta entera (neutros, lateral, pieles); la forma, las fuentes y el movimiento siguen siendo los del tema.',
342
- '',
343
- `Claro ${muestra(m.papel)}papel ${hex(m.papel)} ${muestra(m.tinta)}tinta ${hex(m.tinta)} ${muestra(m.prim)}primario ${hex(m.prim)}`,
344
- `Oscuro ${muestra(m.fondoO)}fondo ${hex(m.fondoO)} ${muestra(m.textoO)}texto ${hex(m.textoO)} ${muestra(m.primO)}primario ${hex(m.primO)}`,
345
- '',
346
- 'Contraste (mínimo AA 4.5:1):',
347
- ...filas,
348
- ...res.avisos.map((a) => `! ${a}`),
349
- ].join('\n'),
350
- `${MODOS[modo].label} · ${hex(primario)} · tema ${tema}`,
351
- );
352
- if (res.pares.some((x) => x.r < 4.5)) p.log.warn('Algún par no llega a AA: el doctor lo marcará. Prueba otro tono o ajústalo en brand.css.');
353
-
354
- return aplicarPlan(p, salir, { tema, modo, out, res, primario });
355
- }
356
-
357
- /** Lo que el asistente aplica (común a los tres modos). */
358
- async function aplicarPlan(p, salir, { tema, modo, out, res, primario }) {
359
- const css = detectarCssApp();
409
+ /* 3 · Extras */
360
410
  const gestor = gestorPaquetes();
361
- const motionYa = yaInstalado('motion');
362
411
  const locales = ['src/i18n/locales', 'src/locales', 'locales', 'public/locales'].find((d) => existsSync(d));
363
-
364
- const bloqueViejo = tieneBloque(out);
365
- const marcaOpcion = modo === 'faithful'
366
- ? bloqueViejo
367
- ? { value: 'marca', label: `Quitar la marca generada de ${relPath(out)}`, hint: 'el tema se verá fiel; lo tuyo fuera del bloque se queda' }
368
- : { value: 'marca', label: existsSync(out) ? `${relPath(out)} sin bloque generado: nada que cambiar` : `Crear ${relPath(out)} vacío (plantilla comentada)`, hint: 'el tema se ve tal cual' }
369
- : { value: 'marca', label: `Escribir la marca en ${relPath(out)}`, hint: 'solo un bloque delimitado' };
370
-
371
- const plan = salir(await p.multiselect({
372
- message: '¿Qué aplico ahora? (espacio para marcar, Enter para seguir)',
412
+ const instalado = (e) => (EXTRAS[e].pkgs ?? []).length > 0 && EXTRAS[e].pkgs.every((x) => yaInstalado(x));
413
+ const extras = salir(await p.multiselect({
414
+ message: '3/4 · ¿Qué más vas a usar? (espacio para marcar, Enter para seguir)',
373
415
  required: false,
374
- initialValues: ['marca', 'css', 'design', ...(motionYa ? [] : ['motion']), ...(locales ? ['i18n'] : [])],
375
- options: [
376
- marcaOpcion,
377
- { value: 'css', label: css ? `Conectar el CSS de la app (${relPath(css)})` : 'Crear src/index.css con los imports', hint: 'fuentes, Tailwind, estructura, tema y marca en orden' },
378
- { value: 'motion', label: motionYa ? 'Motion ya está instalado' : `Instalar Motion para animar (${comandoInstalar(gestor, ['motion'])})`, hint: 'librería oficial de animación' },
379
- { value: 'design', label: 'Anotar orbital-ds en DESIGN.md', hint: 'para que un agente sepa usarlo' },
380
- ...(locales ? [{ value: 'i18n', label: `Sincronizar los textos de orbital-ds en tus idiomas (${locales})`, hint: 'espacio «orbital» en cada JSON' }] : []),
381
- ],
416
+ initialValues: ['animations', ...Object.keys(EXTRAS).filter(instalado), ...(usaClaude() || estadoSkill().estado !== 'falta' ? ['designer'] : [])],
417
+ options: Object.entries(EXTRAS).map(([value, e]) => ({ value, label: instalado(value) ? `${e.label} · ya instalado` : e.label, hint: e.hint })),
382
418
  }));
419
+ const conIdiomas = locales ? salir(await p.confirm({ message: `¿Sincronizo los textos de orbital-ds en tus idiomas (${locales})?`, active: 'Sí', inactive: 'No', initialValue: true })) : false;
383
420
 
384
- if (plan.includes('marca')) {
385
- if (modo === 'faithful') {
386
- const estado = bloqueViejo ? quitarBloque(out) : asegurarMarca(out);
387
- p.log.success(`Marca ${estado === 'quitado' ? 'generada quitada de' : estado === 'creado' ? 'creada (vacía) en' : 'sin cambios en'} ${relPath(out)}: el tema «${tema}» se ve fiel.`);
388
- } else {
389
- const estado = escribirBloque(out, bloqueCss(res, { tema, primario: hex(primario), modo }));
390
- p.log.success(`Marca ${estado} en ${relPath(out)} (lo de fuera de las marcas no se toca).`);
391
- }
392
- }
393
- if (plan.includes('css')) {
394
- const destino = css ?? resolve('src/index.css');
395
- const estado = conectarCss(destino, { tema, brandFile: out });
396
- p.log.success(`CSS ${estado}: ${relPath(destino)} importa el tema «${tema}» y tu marca en el orden correcto.`);
421
+ /* 4 · Resumen y aplicar */
422
+ const css = detectarCssApp() ?? resolve('src/index.css');
423
+ const paquetes = [...new Set(extras.flatMap((e) => EXTRAS[e].pkgs ?? []))].filter((x) => !yaInstalado(x));
424
+ const bloqueViejo = tieneBloque(out);
425
+ const pasoMarca =
426
+ modo === 'faithful'
427
+ ? bloqueViejo
428
+ ? `Quitar la marca generada de ${relPath(out)} (el tema se verá fiel)`
429
+ : `${existsSync(out) ? 'Dejar' : 'Crear'} ${relPath(out)} sin cambios de paleta`
430
+ : `Escribir tu marca en ${relPath(out)} (solo un bloque delimitado)`;
431
+ const pasos = [
432
+ pasoMarca,
433
+ `Conectar ${relPath(css)}: fuentes, Tailwind, estructura, tema${extras.includes('animations') ? ', animaciones' : ''} y marca, en orden`,
434
+ ...(paquetes.length ? [`Instalar con ${gestor}: ${paquetes.join(', ')}`] : []),
435
+ ...(conIdiomas ? [`Rellenar el espacio «orbital» en ${locales}`] : []),
436
+ ...(extras.includes('designer') ? ['Instalar el diseñador para Claude en .claude/skills/orbital-ds-designer'] : []),
437
+ ...(existsSync('DESIGN.md') ? ['Anotar orbital-ds en DESIGN.md (para los agentes)'] : []),
438
+ 'Pasar el doctor sobre tu marca',
439
+ ];
440
+ p.note(pasos.map((s) => `• ${s}`).join('\n'), '4/4 · Esto es lo que voy a hacer');
441
+ if (!salir(await p.confirm({ message: '¿Lo aplico?', active: 'Sí', inactive: 'No', initialValue: true }))) { p.cancel('No se ha escrito nada.'); return; }
442
+
443
+ if (modo === 'faithful') {
444
+ if (bloqueViejo) quitarBloque(out); else asegurarMarca(out);
445
+ p.log.success(`Marca: el tema «${tema}» se ve fiel (${relPath(out)}).`);
446
+ } else {
447
+ p.log.success(`Marca ${escribirBloque(out, bloqueCss(res, { tema, primario: hex(primario), modo }))} en ${relPath(out)}.`);
397
448
  }
398
- if (plan.includes('motion') && !motionYa) {
449
+ p.log.success(`CSS ${conectarCss(css, { tema, brandFile: out, motion: extras.includes('animations') })}: ${relPath(css)}.`);
450
+ if (paquetes.length) {
399
451
  const s = p.spinner();
400
- s.start(`Instalando Motion con ${gestor}…`);
401
- const r = instalar(gestor, ['motion']);
402
- if (r.ok) s.stop('Motion instalado.');
452
+ s.start(`Instalando ${paquetes.join(', ')}…`);
453
+ const r = instalar(gestor, paquetes);
454
+ if (r.ok) s.stop(`Instalado: ${paquetes.join(', ')}.`);
403
455
  else {
404
- s.stop('No se pudo instalar Motion.');
405
- p.log.warn(`Hazlo a mano: ${comandoInstalar(gestor, ['motion'])}\n${r.salida.split('\n').slice(-4).join('\n')}`);
456
+ s.stop('No se pudo instalar.');
457
+ p.log.warn(`Hazlo a mano: ${comandoInstalar(gestor, paquetes)}\n${r.salida.split('\n').slice(-4).join('\n')}`);
406
458
  }
407
459
  }
408
- if (plan.includes('design')) actualizarDesign();
409
- if (plan.includes('i18n')) {
460
+ if (extras.includes('designer')) {
461
+ const r = instalarSkill();
462
+ p.log.success(`Diseñador para Claude ${r.accion}: ${relPath(r.ruta)}`);
463
+ }
464
+ if (conIdiomas) {
410
465
  const r = spawnSync(process.execPath, [join(ROOT, 'scripts/i18n.mjs'), '--dir', locales], { encoding: 'utf8' });
411
466
  p.log.info((r.stdout ?? '').trim());
412
467
  }
413
-
468
+ actualizarDesign();
414
469
  if (existsSync(out)) {
415
470
  const d = spawnSync(process.execPath, [join(ROOT, 'scripts/doctor.mjs'), '--css', out], { encoding: 'utf8' });
416
- const ultima = (d.stdout ?? '').trim().split('\n').pop();
417
- if (d.status === 0) p.log.success(`Doctor: ${ultima}`);
471
+ if (d.status === 0) p.log.success('Doctor: tu marca cumple el contrato y el contraste.');
418
472
  else p.log.error(`Doctor: hay errores.\n${(d.stdout ?? '').split('\n').filter((l) => l.startsWith('ERROR')).slice(0, 6).join('\n')}`);
419
473
  }
420
474
 
421
- const usaMotion = plan.includes('motion') || motionYa;
422
- p.note(
423
- [
424
- usaMotion
425
- ? 'Animación (el tema trae su movimiento de fábrica):\n 1. Envuelve la app: <DsMotionProvider> ← orbital-ds/ui/motion-provider\n 2. const m = useDsMotion() ← orbital-ds/hooks/use-ds-motion\n 3. <motion.div {...m.fadeUp} /> · {...m.scaleIn} · {...m.list} · {...m.press}\n Un componente existente: render={<motion.div {...m.fadeUp} />}'
426
- : 'Animación: los componentes ya animan con el ritmo del tema. Para coreografías,\n vuelve a ejecutar el asistente y marca «Instalar Motion».',
427
- '',
428
- 'Idioma: <DsI18nProvider locale={i18n.language}> en la raíz (orbital-ds/ui/i18n-provider).',
429
- `Guía del tema: node_modules/orbital-ds/dist/themes/${tema}.guide.md`,
430
- 'Ajustes finos (radio, fuentes, movimiento): en tu brand.css, nunca en el paquete.',
431
- ].join('\n'),
432
- 'Siguientes pasos',
433
- );
475
+ const siguientes = [
476
+ 'Tu configuración inicial está lista. Para ajustarla después:',
477
+ ` • Colores, radios, fuentes y movimiento → ${relPath(out)} (tu fichero; gana al tema).`,
478
+ ' • O vuelve a ejecutar este asistente: solo reescribe sus bloques, nunca lo tuyo.',
479
+ '',
480
+ ];
481
+ if (extras.includes('animations')) siguientes.push('Animaciones: ya están activas (orbital-ds/motion.css). Apaga un grupo en brand.css,', ' p. ej. --ds-enter-rows: none;', '');
482
+ if (extras.includes('motion')) siguientes.push('Motion: envuelve la app en <DsMotionProvider> y usa const m = useDsMotion()', ' (<motion.div {...m.fadeUp} />). Un componente existente: render={<motion.div {...m.fadeUp} />}.', '');
483
+ if (extras.includes('charts')) siguientes.push('Gráficos: <EChart option={…} /> de orbital-ds/ui/echart (sin colores en el option: los da el tema).', ' Informes en servidor: node_modules/orbital-ds/docs/GRAFICOS.md', '');
484
+ if (extras.includes('tables')) siguientes.push('Tablas: <DataTable columns={…} data={…} /> de orbital-ds/ui/data-table.', '');
485
+ if (extras.includes('designer')) siguientes.push('Diseñador: pide a Claude pantallas o flujos; usará los patrones y el tema. Al actualizar', ' orbital-ds, refresca con: orbital-ds skill (y pon orbital-ds skill --check en el verify).', '');
486
+ siguientes.push('Idioma: <DsI18nProvider locale={i18n.language}> en la raíz (orbital-ds/ui/i18n-provider).');
487
+ siguientes.push(`Guía del tema: node_modules/orbital-ds/dist/themes/${tema}.guide.md`);
488
+ p.note(siguientes.join('\n'), 'Siguientes pasos');
434
489
  p.outro('Listo.');
435
490
  }
436
491
 
@@ -452,7 +507,9 @@ async function directo() {
452
507
  const primario = parseColor(opt('primary'));
453
508
  if (!primario) { console.error('Color primario no válido. Usa hex, rgb(), hsl() u oklch().'); process.exit(1); }
454
509
  const acento = opt('accent') ? parseColor(opt('accent')) : undefined;
455
- const res = calcular(modo, tema, primario, { acento, marcador: !flag('no-marker') });
510
+ const secundario = opt('secondary') ? parseColor(opt('secondary')) : null;
511
+ if (opt('secondary') && !secundario) { console.error('Color secundario no válido.'); process.exit(1); }
512
+ const res = calcular(modo, tema, primario, { acento, secundario, marcador: !flag('no-marker') });
456
513
  mostrar(res, tema, hex(primario));
457
514
  const bloque = bloqueCss(res, { tema, primario: hex(primario), modo });
458
515
  if (flag('dry-run')) { console.log(bloque); return; }
@@ -463,18 +520,23 @@ async function directo() {
463
520
  }
464
521
  if (flag('connect')) {
465
522
  const destino = opt('css') ? resolve(opt('css')) : detectarCssApp() ?? resolve('src/index.css');
466
- console.log(`CSS ${conectarCss(destino, { tema, brandFile: out })}: ${destino}`);
523
+ console.log(`CSS ${conectarCss(destino, { tema, brandFile: out, motion: flag('animations') })}: ${destino}`);
467
524
  }
468
- if (flag('motion') && !yaInstalado('motion')) {
525
+ const paquetes = [...(flag('motion') ? ['motion'] : []), ...(flag('charts') ? ['echarts'] : []), ...(flag('tables') ? ['@tanstack/react-table'] : [])].filter((x) => !yaInstalado(x));
526
+ if (paquetes.length) {
469
527
  const gestor = gestorPaquetes();
470
- const r = instalar(gestor, ['motion']);
471
- console.log(r.ok ? 'Motion instalado.' : `No se pudo instalar Motion: ${comandoInstalar(gestor, ['motion'])}`);
528
+ const r = instalar(gestor, paquetes);
529
+ console.log(r.ok ? `Instalado: ${paquetes.join(', ')}.` : `No se pudo instalar: ${comandoInstalar(gestor, paquetes)}`);
530
+ }
531
+ if (flag('skill')) {
532
+ const r = instalarSkill();
533
+ console.log(`Diseñador para Claude ${r.accion}: ${r.ruta}`);
472
534
  }
473
535
  if (flag('i18n')) {
474
536
  const r = spawnSync(process.execPath, [join(ROOT, 'scripts/i18n.mjs')], { encoding: 'utf8' });
475
537
  console.log((r.stdout ?? '').trim());
476
538
  }
477
- siguientesPasos(tema);
539
+ if (!flag('connect')) siguientesPasos(tema);
478
540
  actualizarDesign();
479
541
  }
480
542
 
@@ -1,79 +1,85 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Manifiesto de componentes de orbital-ds (`components.manifest.json`).
4
- *
5
- * Lo leen los agentes de IA (qué hay, cómo se importa, qué `data-slot` expone,
6
- * qué dependencias opcionales pide) y `pnpm check:ds` lo usa como HUELLA de la API
7
- * pública: si desaparece un componente o un export respecto al manifiesto
8
- * commiteado, doctor falla salvo que se haga una versión mayor.
9
- *
10
- * node scripts/manifest.mjs # regenera components.manifest.json
11
- */
12
- import { readFileSync, readdirSync, writeFileSync, existsSync } from 'node:fs';
13
- import { join, dirname, resolve } from 'node:path';
14
- import { fileURLToPath } from 'node:url';
15
-
16
- const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
17
- const UI = join(ROOT, 'src/ui');
18
-
19
- // Dependencias que SIEMPRE están (peers obligatorios): no se listan como opcionales.
20
- const REQUIRED = new Set([
21
- 'react', 'react-dom', 'class-variance-authority', 'clsx', 'tailwind-merge', 'lucide-react',
22
- ]);
23
-
24
- function parseExports(src) {
25
- const names = new Set();
26
- for (const m of src.matchAll(/export\s*\{([^}]*)\}/g)) {
27
- for (const part of m[1].split(',')) {
28
- const n = part.trim().split(/\s+as\s+/i).pop()?.trim();
29
- if (n) names.add(n);
30
- }
31
- }
32
- for (const m of src.matchAll(/export\s+(?:async\s+)?(?:function|const|class)\s+([A-Za-z0-9_]+)/g)) names.add(m[1]);
33
- return [...names].sort();
34
- }
35
-
36
- function parseSlots(src) {
37
- return [...new Set([...src.matchAll(/data-slot="([a-z0-9-]+)"/g)].map((m) => m[1]))].sort();
38
- }
39
-
40
- function parseOptionalPeers(src) {
41
- const peers = new Set();
42
- for (const m of src.matchAll(/from\s+"([^"]+)"/g)) {
43
- const spec = m[1];
44
- if (spec.startsWith('.')) continue;
45
- const pkg = spec.startsWith('@') ? spec.split('/').slice(0, 2).join('/') : spec.split('/')[0];
46
- if (pkg === '@base-ui/react' || REQUIRED.has(pkg)) continue;
47
- peers.add(pkg);
48
- }
49
- return [...peers].sort();
50
- }
51
-
52
- export function buildManifest() {
53
- const components = {};
54
- for (const f of readdirSync(UI).filter((n) => n.endsWith('.tsx')).sort()) {
55
- const src = readFileSync(join(UI, f), 'utf8');
56
- const name = f.replace(/\.tsx$/, '');
57
- components[name] = {
58
- import: `orbital-ds/ui/${name}`,
59
- exports: parseExports(src),
60
- slots: parseSlots(src),
61
- optionalPeers: parseOptionalPeers(src),
62
- };
63
- }
64
- const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'));
65
- return {
66
- package: pkg.name,
67
- version: pkg.version,
68
- engine: '@base-ui/react',
69
- docs: ['README.md', 'docs/CONTRACT.md', 'AGENTS.md', 'contract.json'],
70
- components,
71
- };
72
- }
73
-
74
- if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
75
- const out = join(ROOT, 'components.manifest.json');
76
- const manifest = buildManifest();
77
- writeFileSync(out, JSON.stringify(manifest, null, 2) + '\n');
78
- console.log(`manifest: ${Object.keys(manifest.components).length} componentes → components.manifest.json`);
79
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Manifiesto de componentes de orbital-ds (`components.manifest.json`).
4
+ *
5
+ * Lo leen los agentes de IA (qué hay, cómo se importa, qué `data-slot` expone,
6
+ * qué dependencias opcionales pide) y `pnpm check:ds` lo usa como HUELLA de la API
7
+ * pública: si desaparece un componente o un export respecto al manifiesto
8
+ * commiteado, doctor falla salvo que se haga una versión mayor.
9
+ *
10
+ * node scripts/manifest.mjs # regenera components.manifest.json
11
+ */
12
+ import { readFileSync, readdirSync, writeFileSync, existsSync } from 'node:fs';
13
+ import { join, dirname, resolve } from 'node:path';
14
+ import { fileURLToPath } from 'node:url';
15
+
16
+ const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
17
+ const UI = join(ROOT, 'src/ui');
18
+
19
+ // Dependencias que SIEMPRE están (peers obligatorios): no se listan como opcionales.
20
+ const REQUIRED = new Set([
21
+ 'react', 'react-dom', 'class-variance-authority', 'clsx', 'tailwind-merge', 'lucide-react',
22
+ ]);
23
+
24
+ function parseExports(src) {
25
+ const names = new Set();
26
+ for (const m of src.matchAll(/export\s*\{([^}]*)\}/g)) {
27
+ for (const part of m[1].split(',')) {
28
+ const n = part.trim().split(/\s+as\s+/i).pop()?.trim();
29
+ if (n) names.add(n);
30
+ }
31
+ }
32
+ for (const m of src.matchAll(/export\s+(?:async\s+)?(?:function|const|class)\s+([A-Za-z0-9_]+)/g)) names.add(m[1]);
33
+ return [...names].sort();
34
+ }
35
+
36
+ function parseSlots(src) {
37
+ return [...new Set([...src.matchAll(/data-slot="([a-z0-9-]+)"/g)].map((m) => m[1]))].sort();
38
+ }
39
+
40
+ /** Reglas de uso escritas en el componente con `@note …` (una por línea): van al manifiesto. */
41
+ function parseNotes(src) {
42
+ return [...src.matchAll(/@note\s+([^\r\n]+)/g)].map((m) => m[1].replace(/\s*\*\/\s*$/, '').trim());
43
+ }
44
+
45
+ function parseOptionalPeers(src) {
46
+ const peers = new Set();
47
+ for (const m of src.matchAll(/from\s+"([^"]+)"/g)) {
48
+ const spec = m[1];
49
+ if (spec.startsWith('.')) continue;
50
+ const pkg = spec.startsWith('@') ? spec.split('/').slice(0, 2).join('/') : spec.split('/')[0];
51
+ if (pkg === '@base-ui/react' || REQUIRED.has(pkg)) continue;
52
+ peers.add(pkg);
53
+ }
54
+ return [...peers].sort();
55
+ }
56
+
57
+ export function buildManifest() {
58
+ const components = {};
59
+ for (const f of readdirSync(UI).filter((n) => n.endsWith('.tsx')).sort()) {
60
+ const src = readFileSync(join(UI, f), 'utf8');
61
+ const name = f.replace(/\.tsx$/, '');
62
+ components[name] = {
63
+ import: `orbital-ds/ui/${name}`,
64
+ exports: parseExports(src),
65
+ slots: parseSlots(src),
66
+ optionalPeers: parseOptionalPeers(src),
67
+ ...(parseNotes(src).length ? { notes: parseNotes(src) } : {}),
68
+ };
69
+ }
70
+ const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'));
71
+ return {
72
+ package: pkg.name,
73
+ version: pkg.version,
74
+ engine: '@base-ui/react',
75
+ docs: ['README.md', 'docs/CONTRACT.md', 'AGENTS.md', 'contract.json'],
76
+ components,
77
+ };
78
+ }
79
+
80
+ if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
81
+ const out = join(ROOT, 'components.manifest.json');
82
+ const manifest = buildManifest();
83
+ writeFileSync(out, JSON.stringify(manifest, null, 2) + '\n');
84
+ console.log(`manifest: ${Object.keys(manifest.components).length} componentes → components.manifest.json`);
85
+ }
package/scripts/setup.mjs CHANGED
@@ -30,7 +30,7 @@ const rel = (desde, hasta) => {
30
30
  * Quita solo las líneas que el bloque ya contiene (tailwindcss, tw-animate-css, orbital-ds
31
31
  * y el brand.css); el resto del fichero queda igual. Devuelve el nuevo contenido.
32
32
  */
33
- export function bloqueImports(cssFile, { tema, brandFile, cwd = process.cwd() }) {
33
+ export function bloqueImports(cssFile, { tema, brandFile, motion = false, cwd = process.cwd() }) {
34
34
  const nm = resolve(cwd, 'node_modules/orbital-ds/dist');
35
35
  const lineas = [
36
36
  IMPORTS_INI,
@@ -39,6 +39,7 @@ export function bloqueImports(cssFile, { tema, brandFile, cwd = process.cwd() })
39
39
  `@import 'tw-animate-css';`,
40
40
  `@import 'orbital-ds/styles.css'; /* estructura */`,
41
41
  `@import 'orbital-ds/themes/${tema}.css'; /* tema */`,
42
+ ...(motion ? [`@import 'orbital-ds/motion.css'; /* animaciones del tema: entradas y superficies pulsables */`] : []),
42
43
  `@import '${rel(cssFile, brandFile)}'; /* tu marca: gana al tema */`,
43
44
  `@source '${rel(cssFile, nm)}';`,
44
45
  IMPORTS_FIN,