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/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
|
|
99
|
-
escribe `brand.css`, conecta el CSS de
|
|
100
|
-
|
|
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
|
|
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:
|