orbital-ds 0.10.1 → 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 +32 -4
- 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/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/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 +1 -1
- package/scripts/brand-core.mjs +5 -3
- package/scripts/doctor.mjs +61 -3
- package/scripts/init.mjs +182 -26
package/AGENTS.md
CHANGED
|
@@ -97,9 +97,17 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
|
|
|
97
97
|
|
|
98
98
|
## Instalar en una app
|
|
99
99
|
|
|
100
|
-
`pnpm exec orbital-ds-init`: elige tema
|
|
101
|
-
escribe `brand.css`, conecta el CSS de
|
|
102
|
-
|
|
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).
|
|
103
111
|
|
|
104
112
|
## Cómo comprobar tu trabajo
|
|
105
113
|
|
|
@@ -144,6 +152,26 @@ personalidad use **solo variables** (ni medidas, ni colores, ni pesos) y que est
|
|
|
144
152
|
**familias completas** de piezas (`slotFamilies` en `contract.json`: si das tinta al
|
|
145
153
|
`checkbox`, también al `radio-group-item`).
|
|
146
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
|
+
|
|
147
175
|
## Estándar de integración (cómo debe ajustarse una app)
|
|
148
176
|
|
|
149
177
|
Para que una app (o un agente que la edite) use orbital-ds sin romper nada:
|
|
@@ -160,6 +188,6 @@ Para que una app (o un agente que la edite) use orbital-ds sin romper nada:
|
|
|
160
188
|
|
|
161
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.
|
|
162
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.
|
|
163
|
-
- **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).
|
|
164
192
|
- **Foco siempre visible** (anillo de 3:1 como mínimo) y sin que otro elemento lo tape.
|
|
165
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:
|