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
package/AGENTS.md CHANGED
@@ -68,7 +68,9 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
68
68
  (`orbital-ds/lib/echarts-server`) con `tokens` = `orbital-ds/themes/<tema>.tokens.json` → `.light` o
69
69
  `.dark` (colores ya resueltos; mezcla ahí los de la marca si la app tiene). Para PNG (plantillas de
70
70
  documento), la app convierte el SVG (p. ej. resvg) con las fuentes del tema.
71
- - Registro común de tipos y componentes: `orbital-ds/lib/echarts-setup`. Otro tipo → `echarts.use([...])` en la app.
71
+ - Registro común de tipos y componentes: `orbital-ds/lib/echarts-setup`. Otro tipo → `echarts.use([...])` en la app. Si la app
72
+ usa `echarts` directamente (sin `<EChart>` ni `renderEChartToSvg`), llama antes a `dsEcharts()` (registra y lo devuelve):
73
+ así ningún empaquetador quita el registro. `pnpm check:bundle` lo comprueba empaquetando un consumidor.
72
74
  - **Recetas completas** (pantalla, informe SVG→PNG, función de servidor de TanStack Start, endpoint en un Worker, marca en los informes): `docs/GRAFICOS.md`.
73
75
 
74
76
  ## Idioma (i18n)
@@ -95,15 +97,24 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
95
97
 
96
98
  ## Instalar en una app
97
99
 
98
- `pnpm exec orbital-ds-init`: elige tema y color, comprueba el contraste y, si lo aceptas,
99
- escribe `brand.css`, conecta el CSS de la app (bloque de imports en orden), anota DESIGN.md,
100
- instala Motion y pasa el doctor. Sin preguntas: `--primary <color> --theme <tema> --connect --motion`.
100
+ `pnpm exec orbital-ds-init`: elige tema (enseña su ficha: esencia, paleta, gesto, excepciones de
101
+ contraste), elige **cómo aplicar la marca** y, si lo aceptas, escribe `brand.css`, conecta el CSS de
102
+ la app (bloque de imports en orden), anota DESIGN.md, instala Motion y pasa el doctor.
103
+
104
+ - **Modos de marca** (`--mode`): `faithful` (el tema tal cual, sin derivar nada; quita un bloque
105
+ generado con `--update`), `primary` (solo el primario —foco, enlace, lateral activo, serie 1— sobre
106
+ la paleta del tema, con el contraste medido contra SU lienzo) y `full` (paleta entera derivada).
107
+ - La ficha del tema recomienda el modo con `"branding"`. Un tema de un **sistema corporativo**
108
+ (p. ej. `fractalia`) declara `"branding": "faithful"`: no le derives la paleta.
109
+ - Sin preguntas: `--theme fractalia --connect` (fiel) · `--primary <color> --mode primary --theme <tema>` ·
110
+ `--primary <color> --theme <tema> --connect --motion` (completa).
101
111
 
102
112
  ## Cómo comprobar tu trabajo
103
113
 
104
114
  ```bash
105
115
  pnpm check:ds # contrato, repetidos, sombras, fugas, valores fijos, personalidad, familias, contraste y demos
106
- pnpm verify # doctor + typecheck + build
116
+ pnpm verify # doctor + typecheck + build + check:bundle
117
+ pnpm check:bundle # empaqueta un consumidor de EChart (navegador y servidor) y comprueba que dibuja
107
118
  pnpm manifest # regenera components.manifest.json tras añadir componentes
108
119
  pnpm showcase # escaparate: todos los componentes × todos los temas × claro/oscuro × marca
109
120
  pnpm showcase:typecheck # tipos de las demos
@@ -141,6 +152,26 @@ personalidad use **solo variables** (ni medidas, ni colores, ni pesos) y que est
141
152
  **familias completas** de piezas (`slotFamilies` en `contract.json`: si das tinta al
142
153
  `checkbox`, también al `radio-group-item`).
143
154
 
155
+ ## Adaptar un sistema corporativo (p. ej. Fractalia)
156
+
157
+ Se adapta el sistema al modelo, nunca al revés (decisión y plan: `docs/adr/0002-sistemas-corporativos-al-modelo.md`):
158
+
159
+ 1. **Valores a los huecos.** Cada valor de su DS va a la variable pública que ya lo cubre (`--ds-radius-button`,
160
+ `--ds-field-bg`, `--ds-switch-track-off`, `--ds-*-weight`…). La personalidad solo para lo que ningún hueco
161
+ cubre. El doctor avisa si una regla pinta una propiedad que tiene hueco (`slotTokens` del contrato).
162
+ 2. **Si falta el hueco, se añade** al núcleo con un valor que deje igual a los demás temas (p. ej. el
163
+ desactivado con color: `--ds-button-disabled-bg/-fg/-border`, opcionales con respaldo por variante).
164
+ 3. **Pesos cargados = pesos usados**: el doctor avisa si una `--ds-*-weight` pide un peso que `<tema>.fonts.css`
165
+ no carga.
166
+ 4. **Sus componentes van al núcleo, genéricos** (nunca CSS de componentes dentro de un tema): antes de crear,
167
+ busca en el manifiesto y amplía (solo añadir). Tono con el vocabulario común (`DsDataTone`); el significado
168
+ de dominio (riesgo bajo/medio/alto) lo traduce la app. Medidas y efectos en `--ds-<pieza>-*`; animación con
169
+ CSS y el ritmo del tema (`--ds-motion-pulse`, `--ds-ease-pulse`), quieta con movimiento reducido.
170
+ Piezas de estado y progreso: `Shield`/`ShieldRadar`, `Gauge`, `PasswordStrength`, `StepDots`, `StepRing`,
171
+ `TaskProgress`, `LevelMeter`, `StatusHero`, `TaskLoader` y `StatusDot size`. Pista común: `--ds-track-bg`.
172
+ 5. **Fidelidad comprobada**: compara el valor efectivo de cada propiedad antes y después de traducir (claro y
173
+ oscuro); solo deben cambiar los valores de su DS que antes no se aplicaban.
174
+
144
175
  ## Estándar de integración (cómo debe ajustarse una app)
145
176
 
146
177
  Para que una app (o un agente que la edite) use orbital-ds sin romper nada:
@@ -157,6 +188,6 @@ Para que una app (o un agente que la edite) use orbital-ds sin romper nada:
157
188
 
158
189
  - **Mínimo exigible: AA.** Texto 4,5:1; texto grande y controles 3:1. `pnpm check:ds` falla si un par principal de texto sobre su superficie (texto/fondo, tarjeta, popover, primario, secundario, lateral, destructivo) o un texto de estado (info, danger, warning, success, neutral) baja de 4,5:1.
159
190
  - **Objetivo: AAA en el texto del cuerpo** (7:1 para texto/fondo y texto/tarjeta). Se mide con `pnpm check:ds -- --aaa` y avisa, no falla: WCAG no aconseja exigir AAA a todo el sitio. Hoy todos los temas lo cumplen.
160
- - **Excepciones declaradas, nunca silenciosas.** Si un tema no puede cumplir un par (el azul de marca de Twitter con texto blanco da 3:1), lo declara en su ficha, en `a11y.exceptions`, con su porqué; el doctor lo muestra como aviso.
191
+ - **Excepciones declaradas, nunca silenciosas.** Si un tema no puede cumplir un par (el azul de marca de Twitter con texto blanco da 3:1), lo declara en su ficha, en `a11y.exceptions`, con su porqué; el doctor lo muestra como aviso. Vale también para el texto de estado sobre su fondo suave (`"warning/warning-soft"`), p. ej. cuando el par viene del sistema corporativo que el tema reproduce (fractalia).
161
192
  - **Foco siempre visible** (anillo de 3:1 como mínimo) y sin que otro elemento lo tape.
162
193
  - **Una marca nueva debe volver a pasar el doctor.** Cambiar `--primary` obliga a revisar `--primary-foreground`, `--link` y `--ring`.
package/README.md CHANGED
@@ -7,7 +7,8 @@ sobre [Base UI](https://base-ui.com) y Tailwind v4 (los de shadcn en su versión
7
7
  tokens semánticos (radios, alturas, sombras, espaciado, capas, movimiento, foco, materiales)
8
8
  y la capa base. No lleva colores ni fuentes.
9
9
  - `themes/<tema>.css` — un TEMA: paleta (claro/oscuro), radio base y tipografía.
10
- Hoy: `qratia` y `zyro` (cristal). Añadir otro = añadir otro fichero.
10
+ Hoy: `qratia`, `zyro` (cristal), `friendly`, `twitter`, `tactile` y `fractalia` (sistema corporativo de
11
+ Fractalia, para usarlo fiel). Añadir otro = añadir otro fichero.
11
12
  - `themes/<tema>.fonts.css` — las fuentes del tema (un `@import url()`; va el primero).
12
13
  - `ui/*` — componentes, uno por fichero (`orbital-ds/ui/button`, …): quien no usa gráficos
13
14
  no necesita `recharts`, quien no usa el calendario no necesita `react-day-picker`.
@@ -46,6 +47,11 @@ Escribe solo un bloque delimitado en `brand.css`; con `--update` lo reescribe y
46
47
  toca. Opciones: `--theme`, `--accent`, `--no-marker` (apaga el rotulador de `tactile`), `--dry-run`,
47
48
  `--yes`, `--out`. Sin dependencias.
48
49
 
50
+ **Modos de marca** (`--mode`; el asistente los ofrece con el recomendado por la ficha del tema):
51
+ `faithful` deja el tema tal cual (lo que piden los temas de un sistema corporativo, como `fractalia`:
52
+ `--theme fractalia --connect`), `primary` cambia solo el primario sobre la paleta del tema y `full`
53
+ deriva la paleta entera.
54
+
49
55
  ## Guía de cada tema
50
56
 
51
57
  Cada tema lleva su documentación, que viaja con el paquete: