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.
- package/AGENTS.md +32 -4
- package/README.md +93 -93
- package/components.manifest.json +66 -14
- package/dist/motion.css +139 -0
- package/dist/styles.css +15 -2
- package/dist/themes/fractalia.css +473 -464
- package/dist/themes/fractalia.fonts.css +3 -3
- package/dist/themes/fractalia.guide.md +79 -77
- package/dist/themes/fractalia.meta.json +99 -96
- package/dist/themes/fractalia.scoped.css +473 -464
- package/dist/themes/friendly.css +7 -1
- package/dist/themes/friendly.meta.json +7 -0
- package/dist/themes/friendly.scoped.css +7 -1
- package/dist/themes/qratia.css +13 -8
- package/dist/themes/qratia.meta.json +8 -1
- package/dist/themes/qratia.scoped.css +13 -8
- package/dist/themes/tactile.css +7 -1
- package/dist/themes/tactile.meta.json +7 -0
- package/dist/themes/tactile.scoped.css +7 -1
- package/dist/themes/twitter.css +7 -1
- package/dist/themes/twitter.meta.json +7 -0
- package/dist/themes/twitter.scoped.css +7 -1
- package/dist/themes/zyro.css +7 -1
- package/dist/themes/zyro.meta.json +7 -0
- package/dist/themes/zyro.scoped.css +7 -1
- package/dist/ui/alert.js +6 -5
- package/dist/ui/attachment.d.ts +1 -1
- package/dist/ui/badge.js +6 -6
- package/dist/ui/banner.js +4 -4
- package/dist/ui/button.d.ts +1 -1
- package/dist/ui/combobox.js +1 -1
- package/dist/ui/context-menu.js +4 -4
- package/dist/ui/dropdown-menu.js +4 -4
- package/dist/ui/input-group.d.ts +1 -1
- package/dist/ui/item.d.ts +3 -3
- package/dist/ui/item.js +14 -4
- package/dist/ui/marker.d.ts +1 -1
- package/dist/ui/menubar.js +4 -4
- package/dist/ui/native-select.js +2 -2
- package/dist/ui/select.js +7 -8
- package/dist/ui/stat.d.ts +11 -1
- package/dist/ui/stat.js +13 -3
- package/dist/ui/status-badge.js +6 -6
- package/docs/adr/0002-sistemas-corporativos-al-modelo.md +176 -176
- package/docs/designer/flujo.md +79 -0
- package/docs/designer/patrones.md +116 -0
- package/docs/designer/revision.md +60 -0
- package/docs/designer/ux.md +71 -0
- package/package.json +9 -2
- package/scripts/brand-core.mjs +51 -13
- package/scripts/cli.mjs +370 -0
- package/scripts/doctor.mjs +578 -509
- package/scripts/init.mjs +187 -125
- package/scripts/manifest.mjs +85 -79
- package/scripts/setup.mjs +2 -1
- package/scripts/skill.mjs +67 -0
- 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
|
-
|
|
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(
|
|
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(
|
|
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.
|
|
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
|
|
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
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
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
|
-
|
|
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
|
|
365
|
-
|
|
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: ['
|
|
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
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
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
|
-
|
|
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
|
|
401
|
-
const r = instalar(gestor,
|
|
402
|
-
if (r.ok) s.stop(
|
|
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
|
|
405
|
-
p.log.warn(`Hazlo a mano: ${comandoInstalar(gestor,
|
|
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 (
|
|
409
|
-
|
|
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
|
-
|
|
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
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
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
|
|
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
|
-
|
|
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,
|
|
471
|
-
console.log(r.ok ?
|
|
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
|
|
package/scripts/manifest.mjs
CHANGED
|
@@ -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
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
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,
|