orbital-ds 0.10.0 → 0.12.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 (74) hide show
  1. package/AGENTS.md +37 -6
  2. package/README.md +7 -1
  3. package/components.manifest.json +1854 -1713
  4. package/contract.json +37 -0
  5. package/dist/hooks/use-ds-messages.d.ts +17 -0
  6. package/dist/lib/echarts-server.js +2 -2
  7. package/dist/lib/echarts-setup.d.ts +5 -1
  8. package/dist/lib/echarts-setup.js +36 -28
  9. package/dist/lib/i18n.d.ts +17 -0
  10. package/dist/lib/i18n.js +54 -3
  11. package/dist/styles.css +111 -0
  12. package/dist/themes/fractalia.css +464 -0
  13. package/dist/themes/fractalia.fonts.css +3 -0
  14. package/dist/themes/fractalia.guide.md +77 -0
  15. package/dist/themes/fractalia.meta.json +96 -0
  16. package/dist/themes/fractalia.scoped.css +464 -0
  17. package/dist/themes/fractalia.tokens.json +39 -0
  18. package/dist/ui/accordion.js +1 -1
  19. package/dist/ui/attachment.js +1 -1
  20. package/dist/ui/badge.js +1 -1
  21. package/dist/ui/banner.js +2 -2
  22. package/dist/ui/button-group.js +1 -1
  23. package/dist/ui/button.js +7 -7
  24. package/dist/ui/calendar.js +2 -2
  25. package/dist/ui/chart.js +3 -3
  26. package/dist/ui/combobox.js +1 -1
  27. package/dist/ui/command.js +1 -1
  28. package/dist/ui/echart.js +2 -2
  29. package/dist/ui/empty.js +1 -1
  30. package/dist/ui/field.js +2 -2
  31. package/dist/ui/gauge.d.ts +40 -0
  32. package/dist/ui/gauge.js +157 -0
  33. package/dist/ui/heatmap-grid.js +1 -1
  34. package/dist/ui/input-group.js +1 -1
  35. package/dist/ui/input.js +1 -1
  36. package/dist/ui/item.js +1 -1
  37. package/dist/ui/kbd.js +1 -1
  38. package/dist/ui/label.js +1 -1
  39. package/dist/ui/legend.d.ts +3 -1
  40. package/dist/ui/legend.js +15 -1
  41. package/dist/ui/level-meter.d.ts +16 -0
  42. package/dist/ui/level-meter.js +60 -0
  43. package/dist/ui/menubar.js +1 -1
  44. package/dist/ui/message.js +2 -2
  45. package/dist/ui/navigation-menu.js +1 -1
  46. package/dist/ui/password-strength.d.ts +14 -0
  47. package/dist/ui/password-strength.js +61 -0
  48. package/dist/ui/progress.js +1 -1
  49. package/dist/ui/proportion-bar.js +2 -2
  50. package/dist/ui/questionnaire.js +2 -2
  51. package/dist/ui/shield.d.ts +21 -0
  52. package/dist/ui/shield.js +141 -0
  53. package/dist/ui/sidebar.js +1 -1
  54. package/dist/ui/status-badge.d.ts +3 -2
  55. package/dist/ui/status-badge.js +4 -2
  56. package/dist/ui/status-hero.d.ts +12 -0
  57. package/dist/ui/status-hero.js +60 -0
  58. package/dist/ui/step-dots.d.ts +10 -0
  59. package/dist/ui/step-dots.js +40 -0
  60. package/dist/ui/step-ring.d.ts +12 -0
  61. package/dist/ui/step-ring.js +35 -0
  62. package/dist/ui/table.js +1 -1
  63. package/dist/ui/tabs.js +1 -1
  64. package/dist/ui/task-loader.d.ts +14 -0
  65. package/dist/ui/task-loader.js +50 -0
  66. package/dist/ui/task-progress.d.ts +18 -0
  67. package/dist/ui/task-progress.js +84 -0
  68. package/dist/ui/toggle.js +1 -1
  69. package/docs/adr/0002-sistemas-corporativos-al-modelo.md +176 -0
  70. package/package.json +173 -171
  71. package/scripts/brand-core.mjs +5 -3
  72. package/scripts/doctor.mjs +61 -3
  73. package/scripts/i18n.mjs +0 -0
  74. package/scripts/init.mjs +182 -26
@@ -150,6 +150,45 @@ for (const f of themeFiles) {
150
150
  if (meta.name !== t) errors.push(`tema ${t}: ${t}.meta.json tiene name «${meta.name}»`);
151
151
  }
152
152
 
153
+ // 1d) PESOS CARGADOS: cada --ds-*-weight que pide el tema (o hereda de la estructura) debe
154
+ // estar entre los que cargan sus fuentes (<tema>.fonts.css, Google Fonts). Si no, el
155
+ // navegador pinta otro peso (500 sin cargar se ve 400) y el aspecto no es el del tema.
156
+ // Temas con fuentes del sistema (sin @import de Google Fonts): no se comprueba.
157
+ {
158
+ const estructura = read(join(ROOT, 'src/styles.css'));
159
+ const pesosBase = {};
160
+ for (const [, k, v] of estructura.matchAll(/(--ds-[\w-]*weight)\s*:\s*([^;]+);/g)) if (!(k in pesosBase)) pesosBase[k] = v.trim();
161
+ for (const f of themeFiles) {
162
+ const t = f.replace(/\.css$/, '');
163
+ const fontsPath = join(themesDir, `${t}.fonts.css`);
164
+ if (!existsSync(fontsPath)) continue;
165
+ const url = (read(fontsPath).match(/fonts\.googleapis\.com\/css2\?([^'")]+)/) ?? [])[1];
166
+ if (!url) continue;
167
+ const cargados = [];
168
+ for (const [, fam] of url.matchAll(/family=([^&]+)/g)) {
169
+ const [, ejes = '', tuplas = ''] = fam.match(/:([^@]+)@(.+)$/) ?? [];
170
+ const i = ejes.split(',').indexOf('wght');
171
+ if (i < 0) { cargados.push([400, 400]); continue; }
172
+ for (const tupla of tuplas.split(';')) {
173
+ const v = tupla.split(',')[i] ?? '';
174
+ const [a, b = a] = v.split('..').map(Number);
175
+ if (Number.isFinite(a)) cargados.push([a, b]);
176
+ }
177
+ }
178
+ if (!cargados.length) continue;
179
+ const css = read(join(themesDir, f)).replace(/\/\*[\s\S]*?\*\//g, '');
180
+ const pesos = { ...pesosBase };
181
+ for (const [, cuerpo] of css.matchAll(/:root\s*\{([^{}]*)\}/g)) for (const [, k, v] of cuerpo.matchAll(/(--ds-[\w-]*weight)\s*:\s*([^;]+);/g)) pesos[k] = v.trim();
182
+ const valor = (v, n = 0) => { const m = v.match(/^var\((--[\w-]+)(?:,\s*([^)]+))?\)$/); return m && n < 8 ? valor(pesos[m[1]] ?? m[2] ?? '', n + 1) : v; };
183
+ for (const [k, v] of Object.entries(pesos)) {
184
+ const p = Number(valor(v));
185
+ if (!Number.isFinite(p)) continue;
186
+ if (!cargados.some(([a, b]) => p >= a && p <= b))
187
+ warnings.push(`tema ${t}: ${k} = ${p}, pero ${t}.fonts.css no carga ese peso (carga ${[...new Set(cargados.map(([a, b]) => (a === b ? a : `${a}–${b}`)))].join(', ')}): el navegador pintará otro`);
188
+ }
189
+ }
190
+ }
191
+
153
192
  // 1c) CONTRASTE de los textos de estado: info, danger, warning, success y neutral
154
193
  // sobre su fondo suave (compuesto sobre el lienzo), mínimo WCAG AA 4.5:1, en claro y oscuro.
155
194
  // No incluye `link` ni `primary-foreground`: dependen de colores de marca fijados por la
@@ -239,13 +278,19 @@ for (const f of themeFiles) {
239
278
  for (const [piel, vars] of [['claro', resolver(claro)], ['oscuro', resolver({ ...claro, ...oscuro })]]) {
240
279
  const lienzo = parseColor(vars.background ?? '#fff');
241
280
  if (!lienzo) continue;
281
+ let excepciones = [];
282
+ try { excepciones = JSON.parse(read(join(themesDir, `${tema}.meta.json`))).a11y?.exceptions ?? []; } catch { /* sin ficha: lo avisa 1b */ }
242
283
  for (const estado of ['info', 'danger', 'warning', 'success', 'neutral']) {
243
284
  const fg = vars[estado] && parseColor(vars[estado]);
244
285
  const suave = vars[`${estado}-soft`] && parseColor(vars[`${estado}-soft`]);
245
286
  if (!fg || !suave) continue;
246
287
  const fondo = over(suave, over(lienzo, { r: 255, g: 255, b: 255, a: 1 }));
247
288
  const r = ratio(over(fg, fondo), fondo);
248
- if (r < 4.5) errors.push(`${etiqueta} (${piel}): ${estado} sobre ${estado}-soft = ${r.toFixed(2)}:1 (mínimo 4.5:1)`);
289
+ if (r < 4.5) {
290
+ const msg = `${etiqueta} (${piel}): ${estado} sobre ${estado}-soft = ${r.toFixed(2)}:1 (mínimo 4.5:1)`;
291
+ if (excepciones.includes(`${estado}/${estado}-soft`)) warnings.push(`${msg} — excepción declarada en la ficha`);
292
+ else errors.push(`${msg}; corrígelo o decláralo en ${tema}.meta.json → a11y.exceptions ("${estado}/${estado}-soft")`);
293
+ }
249
294
  }
250
295
 
251
296
  // Pares principales de texto sobre su superficie. AA (4.5:1) es el mínimo exigible; las
@@ -258,8 +303,6 @@ for (const f of themeFiles) {
258
303
  ['sidebar-foreground', 'sidebar'], ['sidebar-primary-foreground', 'sidebar-primary'],
259
304
  ['destructive-foreground', 'destructive'],
260
305
  ];
261
- let excepciones = [];
262
- try { excepciones = JSON.parse(read(join(themesDir, `${tema}.meta.json`))).a11y?.exceptions ?? []; } catch { /* sin ficha: lo avisa 1b */ }
263
306
  const blanco = { r: 255, g: 255, b: 255, a: 1 };
264
307
  for (const [fgName, bgName] of PARES) {
265
308
  const fgRaw = vars[fgName] && parseColor(vars[fgName]);
@@ -345,6 +388,21 @@ if (base && themeInfo[base]) {
345
388
  }
346
389
  }
347
390
 
391
+ // c) Huecos públicos (contract.slotTokens): pintar esa propiedad de esa pieza con otra cosa
392
+ // que su hueco es rodearlo; se rellena el hueco en las VARIABLES del tema.
393
+ const huecos = contract.slotTokens?.slots ?? {};
394
+ for (const { selector, prop, value } of decls) {
395
+ for (const [, slot] of selector.matchAll(/data-slot=['"]?([\w-]+)/g)) {
396
+ const token = huecos[slot]?.[prop];
397
+ if (!token || value.includes(`var(${token})`)) continue;
398
+ const clave = `hueco|${slot}|${prop}`;
399
+ if (vistos.has(clave)) continue;
400
+ vistos.add(clave);
401
+ // Aviso (también en strict) hasta traducir friendly, tactile, twitter y zyro (ADR 0002, F1b).
402
+ warnings.push(`tema ${tema}: pinta «${prop}» de ${slot} con «${value}» en vez de rellenar su hueco ${token} — define ${token} en las variables y quita la regla`);
403
+ }
404
+ }
405
+
348
406
  const estilizados = new Set(decls.flatMap((d) => [...d.selector.matchAll(/data-slot=['"]?([\w-]+)/g)].map((m) => m[1])));
349
407
  for (const [familia, slots] of familias) {
350
408
  const tiene = slots.filter((s) => estilizados.has(s));
package/scripts/i18n.mjs CHANGED
File without changes
package/scripts/init.mjs CHANGED
@@ -5,8 +5,19 @@
5
5
  * pnpm exec orbital-ds-init # asistente interactivo (terminal)
6
6
  * pnpm exec orbital-ds-init --primary "#1D63D8" # sin preguntas (scripts / CI)
7
7
  *
8
+ * pnpm exec orbital-ds-init --theme fractalia --connect # tema FIEL, sin marca derivada
9
+ *
10
+ * Modos de marca (--mode; el asistente lo pregunta, con el recomendado por la ficha del tema):
11
+ * faithful el tema tal cual: no se deriva nada (temas de un sistema corporativo, p. ej. fractalia).
12
+ * Si brand.css tenía un bloque generado, se quita (con --update o confirmándolo).
13
+ * primary solo tu color primario (primario, foco, enlace, lateral activo, serie 1) sobre la
14
+ * paleta del tema: lienzo, tinta, tarjetas, bordes y estados siguen siendo los suyos.
15
+ * full marca completa derivada de tu color: neutros teñidos, lateral y las dos pieles.
16
+ * La ficha del tema recomienda uno con `"branding"` (por defecto `full`).
17
+ *
8
18
  * Opciones:
9
19
  * --theme <tema> tema para el que se genera (por defecto: el que importa tu CSS, o qratia)
20
+ * --mode <modo> faithful · primary · full (sin --primary: faithful)
10
21
  * --primary <color> color primario: hex, rgb(), hsl() u oklch()
11
22
  * --accent <color> color de acento/gesto (si no, el complementario del primario)
12
23
  * --no-marker apaga el rotulador del tema (si el tema lo tiene)
@@ -57,11 +68,11 @@ const muestra = (c) => (TTY_COLOR ? `\x1b[48;2;${c.r};${c.g};${c.b}m \x1b[0m
57
68
  const INI = '/* orbital-ds:brand:start */';
58
69
  const FIN = '/* orbital-ds:brand:end */';
59
70
 
60
- function bloqueCss(res, { tema, primario }) {
71
+ function bloqueCss(res, { tema, primario, modo = 'full' }) {
61
72
  const fmt = (tokens) => Object.entries(tokens).map(([k, v]) => ` --${k}: ${v};`).join('\n');
62
73
  return `${INI}
63
- /* Generado por \`orbital-ds-init\` (tema ${tema}, primario ${primario}). Si vuelves a ejecutarlo con
64
- * --update, solo se reescribe este bloque; lo que tengas fuera no se toca. */
74
+ /* Generado por \`orbital-ds-init\` (tema ${tema}, primario ${primario}, modo ${modo}). Si vuelves a
75
+ * ejecutarlo con --update, solo se reescribe este bloque; lo que tengas fuera no se toca. */
65
76
  :root {
66
77
  ${fmt(res.claro)}
67
78
  }
@@ -89,17 +100,118 @@ function escribirBloque(file, bloque) {
89
100
  return 'añadido';
90
101
  }
91
102
 
103
+ /** ¿El fichero de marca tiene un bloque generado? */
104
+ const tieneBloque = (file) => existsSync(file) && readFileSync(file, 'utf8').includes(INI) && readFileSync(file, 'utf8').includes(FIN);
105
+
106
+ /** Quita SOLO el bloque generado (modo fiel); lo que la app tenga fuera se queda. */
107
+ function quitarBloque(file) {
108
+ if (!tieneBloque(file)) return 'sin bloque';
109
+ const actual = readFileSync(file, 'utf8');
110
+ const nuevo = (actual.slice(0, actual.indexOf(INI)).replace(/\s*$/, '') + '\n' + actual.slice(actual.indexOf(FIN) + FIN.length).replace(/^\s*/, '\n')).replace(/\n{3,}/g, '\n\n');
111
+ writeFileSync(file, nuevo);
112
+ return 'quitado';
113
+ }
114
+
115
+ /** brand.css de la app: si no existe, la plantilla comentada (vacía: el tema se ve tal cual). */
116
+ function asegurarMarca(out) {
117
+ if (existsSync(out)) return 'existe';
118
+ const lines = contract.brand.tokens.map((t) => ` /* --${t.name}: ${t.example}; */ /* ${t.about} */`);
119
+ mkdirSync(dirname(out), { recursive: true });
120
+ writeFileSync(out, `/*\n * MARCA de la app — fichero TUYO.\n *\n * Ninguna actualización de orbital-ds lo toca. Se importa DESPUÉS del tema, así que\n * lo que pongas aquí gana. Si no defines nada, se aplica el valor estándar del tema.\n *\n * Para generar la marca completa desde un color: pnpm exec orbital-ds-init --primary "#1D63D8"\n */\n:root {\n${lines.join('\n')}\n}\n\n/* Piel oscura: solo si tu marca necesita valores distintos en oscuro. */\n.dark {\n /* --primary: ...; */\n}\n`);
121
+ return 'creado';
122
+ }
123
+
124
+ /* ═══════════════════════════════ MODOS ═══════════════════════════════════════ */
125
+ const MODOS = {
126
+ faithful: { label: 'Fiel al tema', hint: 'su paleta tal cual; no se deriva nada' },
127
+ primary: { label: 'Solo mi color primario', hint: 'primario, foco, enlace y lateral activo sobre la paleta del tema' },
128
+ full: { label: 'Marca completa desde mi color', hint: 'neutros teñidos, lateral y las dos pieles' },
129
+ };
130
+ /** Tokens que cambia el modo «solo primario» (más los de los gestos del tema, si los tiene). */
131
+ const TOKENS_PRIMARIO = new Set(['primary', 'primary-foreground', 'ring', 'link', 'link-hover', 'brand', 'brand-bright', 'sidebar-primary', 'sidebar-primary-foreground', 'sidebar-ring', 'chart-1', 'ds-marker']);
132
+ const soloPrimario = (tokens) => Object.fromEntries(Object.entries(tokens).filter(([k]) => TOKENS_PRIMARIO.has(k)));
133
+
92
134
  /* ═══════════════════════════════ TEMAS ═══════════════════════════════════════ */
93
135
  const temasDir = existsSync(join(ROOT, 'src/themes')) ? join(ROOT, 'src/themes') : join(ROOT, 'dist/themes');
94
136
  const temas = readdirSync(temasDir).filter((f) => f.endsWith('.meta.json')).map((f) => JSON.parse(readFileSync(join(temasDir, f), 'utf8')));
95
137
  const TEMA_CSS = (() => {
96
- for (const f of ['src/styles.css', 'app/styles.css', 'src/index.css']) {
97
- if (existsSync(f)) { const m = readFileSync(f, 'utf8').match(/orbital-ds\/themes\/([\w-]+)\.css/); if (m) return m[1]; }
138
+ for (const f of [detectarCssApp(), 'src/styles.css', 'app/styles.css', 'src/index.css']) {
139
+ if (f && existsSync(f)) { const m = readFileSync(f, 'utf8').match(/orbital-ds\/themes\/([\w-]+)\.css/); if (m) return m[1]; }
98
140
  }
99
141
  return 'qratia';
100
142
  })();
143
+ const ficha = (tema) => temas.find((t) => t.name === tema) ?? {};
101
144
  /** Un tema tiene gestos si su ficha (`<tema>.meta.json`) los declara con variables públicas. */
102
- const tieneGestos = (tema) => (temas.find((t) => t.name === tema)?.gestures ?? []).length > 0;
145
+ const tieneGestos = (tema) => (ficha(tema).gestures ?? []).length > 0;
146
+ /** Modo de marca que recomienda la ficha del tema (`"branding"`). */
147
+ const modoRecomendado = (tema) => (MODOS[ficha(tema).branding] ? ficha(tema).branding : 'full');
148
+
149
+ /** Variables de color del tema (bloques de VARIABLES de :root y .dark), con var() resuelto. */
150
+ function paletaTema(tema) {
151
+ const f = join(temasDir, `${tema}.css`);
152
+ if (!existsSync(f)) return { claro: {}, oscuro: {} };
153
+ const css = readFileSync(f, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '');
154
+ const claro = {}, oscuro = {};
155
+ for (const [, sel, cuerpo] of css.matchAll(/(:root|\.dark)\s*\{([^{}]*)\}/g)) {
156
+ for (const [, k, v] of cuerpo.matchAll(/--([\w-]+)\s*:\s*([^;]+);/g)) (sel === ':root' ? claro : oscuro)[k] = v.trim();
157
+ }
158
+ const resolver = (vars) => Object.fromEntries(Object.entries(vars).map(([k, v]) => {
159
+ for (let n = 0; n < 8; n++) { const m = v.match(/^var\(--([\w-]+)\)$/); if (!m || !vars[m[1]]) break; v = vars[m[1]]; }
160
+ return [k, v];
161
+ }));
162
+ return { claro: resolver(claro), oscuro: resolver({ ...claro, ...oscuro }) };
163
+ }
164
+
165
+ /** Neutros reales del tema para derivar SOLO el primario sobre ellos. */
166
+ function baseTema(tema) {
167
+ const { claro, oscuro } = paletaTema(tema);
168
+ const c = (v) => (v ? parseColor(v) ?? undefined : undefined);
169
+ return { papel: c(claro.background), tinta: c(claro.foreground), fondoO: c(oscuro.background), textoO: c(oscuro.foreground) };
170
+ }
171
+
172
+ /** Resumen de la ficha del tema para elegir informado (esencia, gesto, paleta, a11y, estado). */
173
+ function resumenFicha(tema) {
174
+ const f = ficha(tema);
175
+ const { claro, oscuro } = paletaTema(tema);
176
+ const sw = (v) => { const c = v && parseColor(v); return c ? `${muestra(c)}${hex(c)}` : '—'; };
177
+ const lineas = [
178
+ f.essence ?? '',
179
+ '',
180
+ `Claro lienzo ${sw(claro.background)} tinta ${sw(claro.foreground)} primario ${sw(claro.primary)} foco ${sw(claro.ring)}`,
181
+ `Oscuro lienzo ${sw(oscuro.background)} tinta ${sw(oscuro.foreground)} primario ${sw(oscuro.primary)}`,
182
+ ];
183
+ if (f.fonts) lineas.push(`Fuentes ${f.fonts.display} (títulos) · ${f.fonts.body} (texto)`);
184
+ if (f.signature?.length) lineas.push('', 'Gesto firma:', ...f.signature.map((s) => ` · ${s}`));
185
+ if (f.a11y?.exceptions?.length) lineas.push('', `Excepciones de contraste declaradas: ${f.a11y.exceptions.join(', ')}`);
186
+ if (f.status?.pending?.length) lineas.push('', 'Pendiente en su sistema:', ...f.status.pending.map((s) => ` · ${s}`));
187
+ if (f.branding === 'faithful') lineas.push('', 'Tema de un sistema corporativo: se recomienda usarlo FIEL (sin derivar marca).');
188
+ lineas.push('', `Guía: node_modules/orbital-ds/dist/themes/${tema}.guide.md`);
189
+ return lineas.join('\n');
190
+ }
191
+
192
+ /** Pares de contraste del modo «solo primario», medidos contra la paleta real del tema. */
193
+ function paresPrimario(res, tema) {
194
+ 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; };
196
+ return [
197
+ par('claro', 'texto sobre primario', res.claro['primary-foreground'], res.claro.primary),
198
+ par('claro', 'enlace/lienzo', res.claro.link, claro.background),
199
+ par('claro', 'enlace/tarjeta', res.claro.link, claro.card),
200
+ par('claro', 'texto lateral activo', res.claro['sidebar-primary-foreground'], res.claro['sidebar-primary']),
201
+ par('oscuro', 'texto sobre primario', res.oscuro['primary-foreground'], res.oscuro.primary),
202
+ par('oscuro', 'enlace/lienzo', res.oscuro.link, oscuro.background),
203
+ ].filter(Boolean);
204
+ }
205
+
206
+ /** Calcula la marca según el modo. */
207
+ function calcular(modo, tema, primario, { acento, marcador }) {
208
+ const gestos = tieneGestos(tema);
209
+ 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) };
212
+ }
213
+ return derivar(primario, { acento, marcador, gestos });
214
+ }
103
215
 
104
216
  /* ═══════════════════════════════ FLUJO ═══════════════════════════════════════ */
105
217
  function plantillaClasica() {
@@ -185,8 +297,20 @@ async function asistente() {
185
297
  options: temas.map((t) => ({ value: t.name, label: t.label ? `${t.name} · ${t.label}` : t.name, hint: t.essence })),
186
298
  }));
187
299
 
300
+ p.note(resumenFicha(tema), `Tema «${tema}»`);
301
+
302
+ const recomendado = modoRecomendado(tema);
303
+ const modo = salir(await p.select({
304
+ message: '¿Cómo aplico tu marca sobre el tema?',
305
+ initialValue: recomendado,
306
+ options: Object.entries(MODOS).map(([value, m]) => ({ value, label: value === recomendado ? `${m.label} (recomendado)` : m.label, hint: m.hint })),
307
+ }));
308
+
309
+ const out = resolve(opt('out') ?? 'src/brand.css');
310
+ if (modo === 'faithful') return aplicarPlan(p, salir, { tema, modo, out, res: null, primario: null });
311
+
188
312
  const raw = salir(await p.text({
189
- message: 'Color primario de tu marca',
313
+ message: modo === 'primary' ? 'Color primario (el resto de la paleta es la del tema)' : 'Color primario de tu marca',
190
314
  placeholder: '#1D63D8 · rgb(29 99 216) · hsl(219 76% 48%) · oklch(0.55 0.2 260)',
191
315
  validate: (v) => (v && parseColor(v) ? undefined : 'No entiendo ese color. Prueba con #1D63D8, rgb(), hsl() u oklch().'),
192
316
  }));
@@ -207,11 +331,15 @@ async function asistente() {
207
331
  marcador = salir(await p.confirm({ message: '¿Rotulador bajo los títulos?', initialValue: true }));
208
332
  }
209
333
 
210
- const res = derivar(primario, { acento, marcador, gestos });
334
+ const res = calcular(modo, tema, primario, { acento, marcador });
211
335
  const m = res.muestras;
212
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}`);
213
337
  p.note(
214
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
+ '',
215
343
  `Claro ${muestra(m.papel)}papel ${hex(m.papel)} ${muestra(m.tinta)}tinta ${hex(m.tinta)} ${muestra(m.prim)}primario ${hex(m.prim)}`,
216
344
  `Oscuro ${muestra(m.fondoO)}fondo ${hex(m.fondoO)} ${muestra(m.textoO)}texto ${hex(m.textoO)} ${muestra(m.primO)}primario ${hex(m.primO)}`,
217
345
  '',
@@ -219,21 +347,33 @@ async function asistente() {
219
347
  ...filas,
220
348
  ...res.avisos.map((a) => `! ${a}`),
221
349
  ].join('\n'),
222
- `Marca derivada de ${hex(primario)} · tema ${tema}`,
350
+ `${MODOS[modo].label} · ${hex(primario)} · tema ${tema}`,
223
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.');
224
353
 
225
- const out = resolve(opt('out') ?? 'src/brand.css');
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 }) {
226
359
  const css = detectarCssApp();
227
360
  const gestor = gestorPaquetes();
228
361
  const motionYa = yaInstalado('motion');
229
362
  const locales = ['src/i18n/locales', 'src/locales', 'locales', 'public/locales'].find((d) => existsSync(d));
230
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
+
231
371
  const plan = salir(await p.multiselect({
232
372
  message: '¿Qué aplico ahora? (espacio para marcar, Enter para seguir)',
233
373
  required: false,
234
374
  initialValues: ['marca', 'css', 'design', ...(motionYa ? [] : ['motion']), ...(locales ? ['i18n'] : [])],
235
375
  options: [
236
- { value: 'marca', label: `Escribir la marca en ${relPath(out)}`, hint: 'solo un bloque delimitado' },
376
+ marcaOpcion,
237
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' },
238
378
  { value: 'motion', label: motionYa ? 'Motion ya está instalado' : `Instalar Motion para animar (${comandoInstalar(gestor, ['motion'])})`, hint: 'librería oficial de animación' },
239
379
  { value: 'design', label: 'Anotar orbital-ds en DESIGN.md', hint: 'para que un agente sepa usarlo' },
@@ -242,8 +382,13 @@ async function asistente() {
242
382
  }));
243
383
 
244
384
  if (plan.includes('marca')) {
245
- const estado = escribirBloque(out, bloqueCss(res, { tema, primario: hex(primario) }));
246
- p.log.success(`Marca ${estado} en ${relPath(out)} (lo de fuera de las marcas no se toca).`);
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
+ }
247
392
  }
248
393
  if (plan.includes('css')) {
249
394
  const destino = css ?? resolve('src/index.css');
@@ -266,7 +411,7 @@ async function asistente() {
266
411
  p.log.info((r.stdout ?? '').trim());
267
412
  }
268
413
 
269
- if (plan.includes('marca')) {
414
+ if (existsSync(out)) {
270
415
  const d = spawnSync(process.execPath, [join(ROOT, 'scripts/doctor.mjs'), '--css', out], { encoding: 'utf8' });
271
416
  const ultima = (d.stdout ?? '').trim().split('\n').pop();
272
417
  if (d.status === 0) p.log.success(`Doctor: ${ultima}`);
@@ -290,21 +435,32 @@ async function asistente() {
290
435
  }
291
436
 
292
437
  async function directo() {
293
- const primario = parseColor(opt('primary'));
294
- if (!primario) { console.error('Color primario no válido. Usa hex, rgb(), hsl() u oklch().'); process.exit(1); }
295
438
  const tema = opt('theme') ?? TEMA_CSS;
296
439
  if (!temas.some((t) => t.name === tema)) { console.error(`El tema «${tema}» no existe. Disponibles: ${temas.map((t) => t.name).join(', ')}`); process.exit(1); }
297
- const acento = opt('accent') ? parseColor(opt('accent')) : undefined;
298
- const res = derivar(primario, { acento, marcador: !flag('no-marker'), gestos: tieneGestos(tema) });
299
- mostrar(res, tema, hex(primario));
300
- const bloque = bloqueCss(res, { tema, primario: hex(primario) });
440
+ const modo = opt('mode') ?? (opt('primary') ? 'full' : 'faithful');
441
+ if (!MODOS[modo]) { console.error(`Modo «${modo}» no válido. Usa: ${Object.keys(MODOS).join(', ')}`); process.exit(1); }
301
442
  const out = resolve(opt('out') ?? 'src/brand.css');
302
- if (flag('dry-run')) { console.log(bloque); return; }
303
- if (existsSync(out) && readFileSync(out, 'utf8').includes(INI) && !flag('update')) {
304
- console.log(`Ya hay un bloque generado en ${out}. Usa --update para reescribirlo.`); return;
443
+
444
+ if (modo === 'faithful') {
445
+ console.log(`Tema «${tema}» fiel (sin marca derivada).`);
446
+ if (flag('dry-run')) return;
447
+ if (tieneBloque(out)) {
448
+ if (flag('update')) console.log(`Marca generada quitada de ${out}.`), quitarBloque(out);
449
+ else console.log(`${out} tiene un bloque generado que cambia la paleta del tema. Usa --update para quitarlo.`);
450
+ } else if (asegurarMarca(out) === 'creado') console.log(`Creado ${out} (vacío: el tema se ve tal cual).`);
451
+ } else {
452
+ const primario = parseColor(opt('primary'));
453
+ if (!primario) { console.error('Color primario no válido. Usa hex, rgb(), hsl() u oklch().'); process.exit(1); }
454
+ const acento = opt('accent') ? parseColor(opt('accent')) : undefined;
455
+ const res = calcular(modo, tema, primario, { acento, marcador: !flag('no-marker') });
456
+ mostrar(res, tema, hex(primario));
457
+ const bloque = bloqueCss(res, { tema, primario: hex(primario), modo });
458
+ if (flag('dry-run')) { console.log(bloque); return; }
459
+ if (tieneBloque(out) && !flag('update')) {
460
+ console.log(`Ya hay un bloque generado en ${out}. Usa --update para reescribirlo.`); return;
461
+ }
462
+ console.log(`Bloque ${escribirBloque(out, bloque)} en ${out}.`);
305
463
  }
306
- const estado = escribirBloque(out, bloque);
307
- console.log(`Bloque ${estado} en ${out}.`);
308
464
  if (flag('connect')) {
309
465
  const destino = opt('css') ? resolve(opt('css')) : detectarCssApp() ?? resolve('src/index.css');
310
466
  console.log(`CSS ${conectarCss(destino, { tema, brandFile: out })}: ${destino}`);
@@ -322,6 +478,6 @@ async function directo() {
322
478
  actualizarDesign();
323
479
  }
324
480
 
325
- if (opt('primary')) await directo();
481
+ if (opt('primary') || opt('mode') || (opt('theme') && !flag('wizard'))) await directo();
326
482
  else if (flag('wizard') || (process.stdin.isTTY && process.stdout.isTTY && !flag('classic'))) await asistente();
327
483
  else { plantillaClasica(); actualizarDesign(); }