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.
- package/AGENTS.md +37 -6
- package/README.md +7 -1
- package/components.manifest.json +1854 -1713
- package/contract.json +37 -0
- package/dist/hooks/use-ds-messages.d.ts +17 -0
- package/dist/lib/echarts-server.js +2 -2
- package/dist/lib/echarts-setup.d.ts +5 -1
- package/dist/lib/echarts-setup.js +36 -28
- package/dist/lib/i18n.d.ts +17 -0
- package/dist/lib/i18n.js +54 -3
- package/dist/styles.css +111 -0
- package/dist/themes/fractalia.css +464 -0
- package/dist/themes/fractalia.fonts.css +3 -0
- package/dist/themes/fractalia.guide.md +77 -0
- package/dist/themes/fractalia.meta.json +96 -0
- package/dist/themes/fractalia.scoped.css +464 -0
- package/dist/themes/fractalia.tokens.json +39 -0
- package/dist/ui/accordion.js +1 -1
- package/dist/ui/attachment.js +1 -1
- package/dist/ui/badge.js +1 -1
- package/dist/ui/banner.js +2 -2
- package/dist/ui/button-group.js +1 -1
- package/dist/ui/button.js +7 -7
- package/dist/ui/calendar.js +2 -2
- package/dist/ui/chart.js +3 -3
- package/dist/ui/combobox.js +1 -1
- package/dist/ui/command.js +1 -1
- package/dist/ui/echart.js +2 -2
- package/dist/ui/empty.js +1 -1
- package/dist/ui/field.js +2 -2
- package/dist/ui/gauge.d.ts +40 -0
- package/dist/ui/gauge.js +157 -0
- package/dist/ui/heatmap-grid.js +1 -1
- package/dist/ui/input-group.js +1 -1
- package/dist/ui/input.js +1 -1
- package/dist/ui/item.js +1 -1
- package/dist/ui/kbd.js +1 -1
- package/dist/ui/label.js +1 -1
- package/dist/ui/legend.d.ts +3 -1
- package/dist/ui/legend.js +15 -1
- package/dist/ui/level-meter.d.ts +16 -0
- package/dist/ui/level-meter.js +60 -0
- package/dist/ui/menubar.js +1 -1
- package/dist/ui/message.js +2 -2
- package/dist/ui/navigation-menu.js +1 -1
- package/dist/ui/password-strength.d.ts +14 -0
- package/dist/ui/password-strength.js +61 -0
- package/dist/ui/progress.js +1 -1
- package/dist/ui/proportion-bar.js +2 -2
- package/dist/ui/questionnaire.js +2 -2
- package/dist/ui/shield.d.ts +21 -0
- package/dist/ui/shield.js +141 -0
- package/dist/ui/sidebar.js +1 -1
- package/dist/ui/status-badge.d.ts +3 -2
- package/dist/ui/status-badge.js +4 -2
- package/dist/ui/status-hero.d.ts +12 -0
- package/dist/ui/status-hero.js +60 -0
- package/dist/ui/step-dots.d.ts +10 -0
- package/dist/ui/step-dots.js +40 -0
- package/dist/ui/step-ring.d.ts +12 -0
- package/dist/ui/step-ring.js +35 -0
- package/dist/ui/table.js +1 -1
- package/dist/ui/tabs.js +1 -1
- package/dist/ui/task-loader.d.ts +14 -0
- package/dist/ui/task-loader.js +50 -0
- package/dist/ui/task-progress.d.ts +18 -0
- package/dist/ui/task-progress.js +84 -0
- package/dist/ui/toggle.js +1 -1
- package/docs/adr/0002-sistemas-corporativos-al-modelo.md +176 -0
- package/package.json +173 -171
- package/scripts/brand-core.mjs +5 -3
- package/scripts/doctor.mjs +61 -3
- package/scripts/i18n.mjs +0 -0
- package/scripts/init.mjs +182 -26
package/scripts/doctor.mjs
CHANGED
|
@@ -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)
|
|
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
|
|
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) => (
|
|
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 =
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
246
|
-
|
|
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 (
|
|
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
|
|
298
|
-
|
|
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
|
-
|
|
303
|
-
if (
|
|
304
|
-
console.log(`
|
|
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(); }
|