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
@@ -0,0 +1,176 @@
1
+ # ADR 0002 — Adaptar un sistema corporativo (Fractalia) al modelo de orbital-ds
2
+
3
+ - **Estado:** propuesta (análisis previo a implementar)
4
+ - **Fecha:** 2026-10-13
5
+ - **Origen:** tema `fractalia` (`src/themes/fractalia.*`) y su capa de componentes propia
6
+ (`fractalia.components.css` + `fractalia.components.md`, siete piezas: gauge, escudo, estado,
7
+ progreso, fuerza de contraseña, stepper y loader).
8
+
9
+ ## Principio
10
+
11
+ **Se adapta el sistema corporativo a nuestro modelo, nunca al revés.**
12
+
13
+ | Capa | Qué aporta Fractalia | Dónde vive |
14
+ |---|---|---|
15
+ | Valores (color, forma, medidas, tipo, movimiento) | los de su DS | variables del tema `fractalia.css` (y la marca de cada app en su `brand.css`) |
16
+ | Personalidad (gesto firma) | píldora en mayúsculas, pestaña activa rellena… | sección PERSONALIDAD del tema, **solo con tokens públicos** |
17
+ | Componentes | las siete piezas | **núcleo** (`src/ui/`), genéricos, reutilizables por cualquier tema |
18
+
19
+ Un tema **no trae componentes**. Si una pieza de Fractalia no existe en el núcleo, se crea en el
20
+ núcleo con API genérica y tokens `--ds-*`; Fractalia solo le da sus valores. Así la misma pieza sirve
21
+ en qratia, tactile o cualquier tema futuro, y Fractalia se ve fiel.
22
+
23
+ ---
24
+
25
+ ## 1. Qué ha supuesto el tema `fractalia` (ya hecho en `feat/fractalia-wizard`)
26
+
27
+ - Cumple el contrato y es `strict`. Correcciones necesarias (sin cambio visual): familias «choice»
28
+ (`radio-group-item`) y «title» (`drawer-title`, `empty-title`) completas.
29
+ - Tres pares de su propio DS bajo AA (texto de estado sobre su fondo suave: danger 4.19, warning 4.23,
30
+ neutral 4.41): **declarados** en `a11y.exceptions` de la ficha (el doctor avisa, no falla). El doctor
31
+ acepta ahora excepciones también en estos pares.
32
+ - `"branding": "faithful"`: el asistente recomienda usarlo **fiel**. Antes derivaba siempre la paleta
33
+ entera desde un color y habría borrado su identidad; ahora tiene tres modos (fiel / solo primario /
34
+ completo) y enseña la ficha del tema antes de aplicar.
35
+ - Genera `fractalia.tokens.json` (informes con ECharts) y su versión con ámbito; el escaparate lo
36
+ descubre solo.
37
+
38
+ ## 2. Hallazgos del análisis
39
+
40
+ ### H1 · El tema rodea tokens públicos con variables privadas
41
+
42
+ La personalidad de fractalia pinta con `--zf-*` propiedades que el núcleo YA expone como token
43
+ público. Resultado: una app no puede ajustarlas desde `brand.css` con el nombre estándar, y otro tema
44
+ que copie fractalia hereda el atajo.
45
+
46
+ | Regla de fractalia | Token público que ya existe | Adaptación |
47
+ |---|---|---|
48
+ | `button { border-radius: var(--zf-radius-label) }` | `--ds-radius-button` | `--ds-radius-button: 32px` y quitar la regla |
49
+ | `badge { border-radius: … }` | `--ds-radius-badge` | `--ds-radius-badge: 32px` |
50
+ | `tabs-trigger/toggle { border-radius: … }` | `--ds-radius-tab` | `--ds-radius-tab: 32px` (el contenedor, `--ds-radius-tab` + `--ds-tabs-list-p`) |
51
+ | campos `background: var(--zf-field-bg)` | `--ds-field-bg` (16 componentes lo leen) | `--ds-field-bg: #ecf1f8` y quitar la regla de familia «field» |
52
+ | `switch` apagado `background: var(--zf-track-off)` | `--ds-switch-track-off` | `--ds-switch-track-off: #c8cdd8` |
53
+ | títulos `font-weight: var(--zf-heading-weight)` | `--ds-title-weight`, `--ds-overlay-title-weight` | fijarlos a 700 |
54
+ | foco `outline: 2px … offset 2px` | `--ds-ring-width`, `--ds-ring-color` | `--ds-ring-width: 2px`; falta `--ds-ring-offset` (ver H4) |
55
+ | hover primario `--zf-primary-hover` | `--brand-bright` (mismo valor en claro) | apoyar el hover en un token público (ver H4) |
56
+
57
+ ### H2 · Huecos del núcleo que fractalia deja con el valor neutro aunque su DS los define
58
+
59
+ | Token | Valor neutro (núcleo) | Valor del DS de Fractalia | Fuente |
60
+ |---|---|---|---|
61
+ | `--ds-radius-track` | radio lg (12px en fractalia) | **4px** | progress-bar |
62
+ | `--ds-track-h` | 0.75rem | 12px (coincide) | progress-bar |
63
+ | `--ds-step-size` | 2rem | **34px** (24 en móvil) | empresa-item-step |
64
+ | `--ds-status-dot` | 0.5rem | **12px** (16 / 24) | status-ball |
65
+ | `--ds-legend-swatch` | 0.625rem | **8px** | leyendas de gráficas |
66
+ | `--ds-motion-pulse` | 2 × parpadeo | **1500ms** · `cubic-bezier(.4,0,.6,1)` | motion-duration.pulse |
67
+ | `--ds-badge-px` / `--ds-badge-py` | 0.625rem / … | **8px / 2px** | tag |
68
+ | `--ds-ring-width` | 3px | **2px** | focus |
69
+ | `--ds-radius-check`, `--ds-check-size` | 6px, 1rem | según checkbox.md | checkbox |
70
+
71
+ ### H3 · Pesos de letra: el tema carga 400/700 y el núcleo pide 500 y 600
72
+
73
+ - Tokens del núcleo con 500 (`--ds-nav-weight`, `--ds-tab-weight`, `--ds-table-head-weight`,
74
+ `--ds-overlay-title-weight`) y 600 (`--ds-title-weight`, `--ds-button-weight`, `--ds-strong-weight`…).
75
+ Con Roboto 400/700, el navegador pinta 500 como **400** y 600 como **700**: el aspecto no es el del DS.
76
+ **Adaptación:** fractalia fija todos los `--ds-*-weight` a 400 o 700.
77
+ - **Hueco del núcleo:** 31 usos de `font-medium` (y 1 `font-semibold`) escritos a mano en 25
78
+ componentes. Ningún tema puede cambiarlos. **Propuesta:** token `--ds-medium-weight` (500 por defecto,
79
+ sin cambio visual) y sustituir esas clases. Beneficia a cualquier tema con pocas variantes de fuente.
80
+
81
+ ### H4 · Huecos que faltan en el núcleo (para no necesitar privadas)
82
+
83
+ | Necesidad (genérica, no solo de Fractalia) | Token propuesto | Valor neutro (aspecto actual) |
84
+ |---|---|---|
85
+ | Desactivado con color, no con opacidad | `--ds-button-disabled-bg`, `-fg`, `-border` (**opcionales**: sin definir, cada variante usa su color de respaldo) + `--ds-button-disabled-opacity` | sin definir → opacidad `--ds-disabled-opacity`, como hoy |
86
+ | Hover del botón primario con otro color | `--ds-button-primary-hover`, `-hover-fg` | `color-mix(in oklab, var(--primary) 80%, transparent)` (= `bg-primary/80`) |
87
+ | Colores del botón outline / secundario | `--ds-button-outline-bg`, `-fg`, `-border`, `--ds-button-secondary-border` | los de siempre |
88
+ | Radio del contenedor de pestañas · peso de la insignia | `--ds-radius-tabs-list`, `--ds-badge-weight` | radio de control · peso de etiqueta |
89
+ | Separación del anillo de foco | `--ds-ring-offset` | 0 |
90
+ | Capas de estado (hover / pulsado) | `--ds-state-hover`, `--ds-state-press` | los valores que hoy usa cada componente |
91
+
92
+ Se añaden con valor neutro (nada cambia en los otros temas) y fractalia los rellena.
93
+
94
+ ### H5 · Cinco vocabularios de tono
95
+
96
+ El núcleo ya tiene cuatro: `StatusLevel` (`critical·warning·ok·info·neutral·none`), `DsDataTone`
97
+ (`primary·info·success·warning·danger·neutral·chart-1…5`), `StatTone` (`good·warn·bad·neutral`) y
98
+ `StepStatus`. Fractalia trae un quinto (`low/medium/high`, `protected/alert`, `pending`, `analyzing`,
99
+ `pink/orange/purple`).
100
+
101
+ **Estándar:** las piezas nuevas usan `DsDataTone` como único vocabulario de color. El significado de
102
+ dominio (riesgo bajo/medio/alto, protegido/alerta) lo traduce la app o un mapa documentado en la pieza
103
+ (`low → success`, `medium → warning`, `high → danger`, `analyzing/pending → neutral`). No se renombra
104
+ nada existente (sería versión mayor); `StatusLevel` y `StatTone` siguen como alias.
105
+ **Pendiente:** los tonos decorativos pink/orange/purple (2.0–2.6:1, solo UI no textual) no caben en
106
+ los semánticos; o se usan las series `chart-*` o se crea una paleta decorativa pública (decisión).
107
+
108
+ ### H6 · La capa de componentes rompe piezas existentes
109
+
110
+ Usa cinco `data-slot` que ya son del núcleo: `progress`, `progress-track`, `stepper`, `stepper-item`,
111
+ `status-badge`. Importarla cambia el aspecto de `Progress`, `Stepper` y `StatusBadge` en toda la app.
112
+ **No se importa nunca tal cual.**
113
+
114
+ ### H7 · La capa incumple las reglas del modelo
115
+
116
+ - Colores hex, medidas en px, pesos y tamaños de letra a mano (no `strict`).
117
+ - `--fc-*` duplica valores del tema (y su `.dark` repite hex).
118
+ - Valores en español (`baja`, `media`, `centrado`, `data-tipo`, `nivel`): el modelo exige inglés.
119
+ - Es CSS + HTML a mano: sin React, sin `data-slot` propios del núcleo, accesibilidad manual,
120
+ textos sin i18n («Nivel de fuerza:», «Paso X de 5»…).
121
+ - No respeta RTL salvo un caso (`status-badge`).
122
+
123
+ ## 3. Mapa pieza a pieza (reutilizable por cualquier tema)
124
+
125
+ | Pieza de Fractalia | ¿Existe en el núcleo? | Decisión | API genérica propuesta |
126
+ |---|---|---|---|
127
+ | **Gauge** (anillo 360° / arco 180°, progreso o tramos, leyenda, escala) | No (Sparkline, ProportionBar y EChart gauge son otra cosa) | **Nuevo** `Gauge` | `value` (0–max), `max`, `shape="ring\|semi"`, `tone: DsDataTone`, `segments?: {value,tone,label}[]`, partes `GaugeValue`, `GaugeLabel`, `GaugeCaption`; leyenda con el `Legend` existente; `role="meter"` + `aria-valuetext` |
128
+ | **Escudo** + **radar** | No | **Nuevo** `Shield`, `ShieldRadar` | `Shield value` (0–1) o `children` (insignia), `size`; `ShieldRadar tone` con anillos animados (`--ds-motion-pulse`, reducido = quieto); `role="img"` + texto i18n; trazado del escudo genérico, tokens `--ds-shield-*` |
129
+ | **Estado** dot / icon / hero / user | Parcial: `StatusDot` | **Ampliar** `StatusDot` (solo añadir `size="sm\|md\|lg"`) + **nuevo** `StatusHero` (disco con halo e insignia) | el «user» es un `Avatar` (+N): se cubre con `Avatar`/`AvatarGroup` existentes |
130
+ | **Progreso** bar / estado / nivel | Parcial: `Progress`, `ProportionBar` | barra simple = `Progress` (fractalia da `--ds-radius-track`, `--ds-track-h`). **Nuevo** `TaskProgress` (etiqueta + contador + estado `idle\|running\|done\|error` + icono) y `LevelMeter` (nivel con etiqueta) | `role="progressbar"` / `meter`; textos «No iniciado / En curso / Completado» en i18n |
131
+ | **Fuerza de contraseña** | No | **Nuevo** `PasswordStrength` | `score` 0–4 o `level="weak\|medium\|strong"`, `segments` (5); `role="meter"`, `aria-live`; textos en i18n |
132
+ | **Stepper** dots / cuadrantes / item | Parcial: `Stepper` | **Nuevo** `StepDots` y `StepProgressRing` (cuadrantes); el item = `StepperIndicator` con `--ds-step-size` | `count`, `current`, `completed`; texto «Paso X de N» en i18n |
133
+ | **Loader** ilustrado | Parcial: `Spinner` | **Nuevo** `TaskLoader` | `icon` (la ilustración la pone la app), `value?` (sin él, indeterminado), `state="running\|done"`; `role="status"` |
134
+
135
+ Cada pieza nueva: un fichero en `src/ui/`, `data-slot` propio, solo tokens (`--ds-<pieza>-*` en la
136
+ estructura con valor neutro), textos en en/es/pt-BR, clases lógicas (RTL), demo en el escaparate y
137
+ entrada en el manifiesto. Fractalia da sus valores en `fractalia.css`.
138
+
139
+ ## 4. Estándar para cualquier sistema corporativo futuro
140
+
141
+ 1. **Ficha primero**: `<tema>.meta.json` con `"branding": "faithful"`, `status`
142
+ (verificado / aproximado / diseñado / pendiente) y `a11y.exceptions` justificadas.
143
+ 2. **Valores, no reglas**: si existe un token público para una propiedad, se rellena el token; la
144
+ personalidad solo para lo que ningún token cubre.
145
+ 3. **Sin privadas que sombreen públicas**. Propuesta de comprobación en el doctor: un mapa
146
+ `slotTokens` en `contract.json` («`button` · `border-radius` → `--ds-radius-button`») y aviso
147
+ (error en `strict`) si una regla de personalidad pinta esa propiedad.
148
+ 4. **Pesos cargados = pesos usados**: el doctor compara los `--ds-*-weight` con los pesos de
149
+ `<tema>.fonts.css` y avisa si pide uno no cargado.
150
+ 5. **Componentes al núcleo**: antes de crear, buscar en `components.manifest.json`; si existe, ampliar
151
+ (solo añadir); si no, pieza genérica nueva. Nunca CSS de componentes dentro de un tema.
152
+ 6. **Un vocabulario de tono** (`DsDataTone`) y nombres en inglés.
153
+ 7. **Huecos del DS documentados**, no inventados: lo que la fuente no especifica se marca PROPUESTA en
154
+ la ficha y se valida con diseño.
155
+
156
+ ## 5. Plan por fases (cada una con su validación)
157
+
158
+ | Fase | Contenido | Validación |
159
+ |---|---|---|
160
+ | **F1 · Tema por tokens** ✅ hecho: 33 propiedades × 2 pieles idénticas; solo cambian los valores del DS de H2 | H1 + H2 + pesos de H3 en `fractalia.css`; quitar las privadas sustituibles | `pnpm verify`; comparar valores calculados antes/después de cada slot (sin cambio visual salvo los valores del DS de H2); `check:ds -- --aaa` |
161
+ | **F2 · Huecos del núcleo** ✅ hecho (botón, pestañas, insignia; `--ds-medium-weight` pendiente); tokens.json de los 6 temas sin cambios | H4 + `--ds-medium-weight` (H3), con valor neutro | `pnpm verify` + escaparate compilado; el resto de temas idénticos (tokens.json sin cambios) |
162
+ | **F1b · Resto de temas** | traducir friendly, tactile, twitter y zyro a sus huecos (35 avisos de `slotTokens` hoy), con la misma comparación antes/después; ojo: `--ds-field-bg` lo leen también outline (botón, insignia) | comparación de valores efectivos por tema; después, `slotTokens` pasa a error en strict |
163
+ | **F3 · Doctor** ✅ hecho: pesos cargados (1d) y huecos públicos (`slotTokens`, aviso) | `slotTokens` (estándar 3) y pesos cargados (estándar 4) | probar que falla con el fractalia actual y pasa tras F1 |
164
+ | **F4 · Componentes** ✅ hechos: Shield/ShieldRadar, Gauge, PasswordStrength, StepDots, StepRing, TaskProgress, LevelMeter, StatusHero, TaskLoader y StatusDot size; renderizado comprobado | por orden: `Shield`/`ShieldRadar`, `Gauge`, `PasswordStrength`, `StepDots`/`StepProgressRing`, `TaskProgress`/`LevelMeter`, `StatusHero` + tamaños de `StatusDot`, `TaskLoader` | por pieza: doctor (tokens, textos, demo), typecheck, build, `check:bundle`, manifiesto, demo en los 6 temas × claro/oscuro, `--aaa`, RTL (clases lógicas) |
165
+ | **F5 · Decisiones de diseño** | ver §6 | con diseño de Fractalia |
166
+
167
+ Versión: F1–F4 son añadidos compatibles → **menor** (0.11.x / 0.12.0).
168
+
169
+ ## 6. Decisiones abiertas (de diseño Fractalia, no técnicas)
170
+
171
+ 1. Montserrat **800** para el porcentaje del escudo: añadirlo a `fractalia.fonts.css` o usar 700.
172
+ 2. Gauge: grosor del trazo (propuesta 12px) y umbrales numéricos de riesgo.
173
+ 3. Tonos decorativos pink/orange/purple: series `chart-*` o paleta decorativa pública.
174
+ 4. Halos de `StatusHero` y glow del loader/radar: tokens con valores aproximados hasta que diseño los fije.
175
+ 5. Versiones móviles de gauge, escudo, estado y progreso de nivel.
176
+ 6. Ilustraciones del loader: SVG o Lottie (la pieza las recibe como `icon`, sirve para ambas).
package/package.json CHANGED
@@ -1,171 +1,173 @@
1
- {
2
- "name": "orbital-ds",
3
- "version": "0.10.0",
4
- "description": "Sistema de diseño genérico: estructura común + temas con personalidad (qratia, zyro) + ~60 componentes sobre Base UI y Tailwind v4, con contrato verificable y legible por agentes.",
5
- "keywords": [
6
- "design-system",
7
- "design-tokens",
8
- "theme",
9
- "tailwindcss",
10
- "base-ui",
11
- "shadcn",
12
- "react"
13
- ],
14
- "license": "MIT",
15
- "type": "module",
16
- "sideEffects": [
17
- "*.css"
18
- ],
19
- "files": [
20
- "dist",
21
- "scripts/doctor.mjs",
22
- "contract.json",
23
- "components.manifest.json",
24
- "docs",
25
- "AGENTS.md",
26
- "README.md",
27
- "LICENSE",
28
- "scripts/init.mjs",
29
- "scripts/manifest.mjs",
30
- "scripts/brand-core.mjs",
31
- "scripts/setup.mjs",
32
- "scripts/i18n.mjs"
33
- ],
34
- "exports": {
35
- "./styles.css": "./dist/styles.css",
36
- "./themes/*.css": "./dist/themes/*.css",
37
- "./themes/*.md": "./dist/themes/*.md",
38
- "./themes/*.meta.json": "./dist/themes/*.meta.json",
39
- "./themes/*.tokens.json": "./dist/themes/*.tokens.json",
40
- "./ui/*": {
41
- "types": "./dist/ui/*.d.ts",
42
- "import": "./dist/ui/*.js"
43
- },
44
- "./lib/*": {
45
- "types": "./dist/lib/*.d.ts",
46
- "import": "./dist/lib/*.js"
47
- },
48
- "./hooks/*": {
49
- "types": "./dist/hooks/*.d.ts",
50
- "import": "./dist/hooks/*.js"
51
- },
52
- "./package.json": "./package.json",
53
- "./contract.json": "./contract.json",
54
- "./components.manifest.json": "./components.manifest.json"
55
- },
56
- "peerDependencies": {
57
- "@base-ui/react": ">=1.9",
58
- "@shadcn/react": ">=0.3",
59
- "class-variance-authority": ">=0.7",
60
- "clsx": ">=2",
61
- "cmdk": ">=1.1",
62
- "date-fns": ">=4",
63
- "embla-carousel-react": ">=8.6",
64
- "input-otp": ">=1.5",
65
- "lucide-react": ">=0.400",
66
- "motion": ">=12",
67
- "next-themes": ">=0.4",
68
- "react": ">=19",
69
- "react-day-picker": ">=10",
70
- "react-dom": ">=19",
71
- "react-resizable-panels": ">=4",
72
- "recharts": ">=3",
73
- "sonner": ">=2",
74
- "tailwind-merge": ">=3",
75
- "tailwindcss": ">=4.1",
76
- "tw-animate-css": ">=1.3",
77
- "echarts": ">=6",
78
- "@tanstack/react-table": ">=9"
79
- },
80
- "peerDependenciesMeta": {
81
- "next-themes": {
82
- "optional": true
83
- },
84
- "recharts": {
85
- "optional": true
86
- },
87
- "sonner": {
88
- "optional": true
89
- },
90
- "@shadcn/react": {
91
- "optional": true
92
- },
93
- "cmdk": {
94
- "optional": true
95
- },
96
- "date-fns": {
97
- "optional": true
98
- },
99
- "embla-carousel-react": {
100
- "optional": true
101
- },
102
- "input-otp": {
103
- "optional": true
104
- },
105
- "react-day-picker": {
106
- "optional": true
107
- },
108
- "react-resizable-panels": {
109
- "optional": true
110
- },
111
- "motion": {
112
- "optional": true
113
- },
114
- "echarts": {
115
- "optional": true
116
- },
117
- "@tanstack/react-table": {
118
- "optional": true
119
- }
120
- },
121
- "devDependencies": {
122
- "@base-ui/react": "^1.9.0",
123
- "@shadcn/react": "^0.3.1",
124
- "@tailwindcss/vite": "^4.3.3",
125
- "@tanstack/react-table": "^9.2.8",
126
- "@types/react": "^19.2.0",
127
- "@types/react-dom": "^19.2.0",
128
- "@vitejs/plugin-react": "^6.1.2",
129
- "class-variance-authority": "^0.7.1",
130
- "clsx": "^2.1.1",
131
- "cmdk": "^1.1.1",
132
- "date-fns": "^4.4.0",
133
- "echarts": "^6.1.0",
134
- "embla-carousel-react": "^8.6.0",
135
- "input-otp": "^1.5.0",
136
- "lucide-react": "^0.577.0",
137
- "motion": "^14.1.0",
138
- "next-themes": "^0.4.6",
139
- "react": "^19.2.0",
140
- "react-day-picker": "^10.0.2",
141
- "react-dom": "^19.2.0",
142
- "react-resizable-panels": "^4.14.4",
143
- "recharts": "3.8.0",
144
- "sonner": "^2.0.8",
145
- "tailwind-merge": "^3.0.2",
146
- "tailwindcss": "^4.1.18",
147
- "tsup": "^8.5.0",
148
- "tw-animate-css": "^1.3.6",
149
- "typescript": "^5.9.0",
150
- "vite": "^8.3.4"
151
- },
152
- "bin": {
153
- "orbital-ds-doctor": "./scripts/doctor.mjs",
154
- "orbital-ds-init": "./scripts/init.mjs",
155
- "orbital-ds-i18n": "./scripts/i18n.mjs"
156
- },
157
- "dependencies": {
158
- "@clack/prompts": "^1.8.1"
159
- },
160
- "scripts": {
161
- "build": "tsup && node scripts/build-css.mjs",
162
- "dev": "tsup --watch --onSuccess \"node scripts/copy-css.mjs\"",
163
- "typecheck": "tsc --noEmit",
164
- "verify": "pnpm check:ds && pnpm typecheck && pnpm showcase:typecheck && pnpm build",
165
- "manifest": "node scripts/manifest.mjs",
166
- "check:ds": "node scripts/doctor.mjs",
167
- "showcase": "vite --config showcase/vite.config.ts",
168
- "showcase:build": "vite build --config showcase/vite.config.ts",
169
- "showcase:typecheck": "tsc --noEmit -p showcase"
170
- }
171
- }
1
+ {
2
+ "name": "orbital-ds",
3
+ "version": "0.12.0",
4
+ "description": "Sistema de diseño genérico: estructura común + temas con personalidad (qratia, zyro) + ~60 componentes sobre Base UI y Tailwind v4, con contrato verificable y legible por agentes.",
5
+ "keywords": [
6
+ "design-system",
7
+ "design-tokens",
8
+ "theme",
9
+ "tailwindcss",
10
+ "base-ui",
11
+ "shadcn",
12
+ "react"
13
+ ],
14
+ "license": "MIT",
15
+ "type": "module",
16
+ "sideEffects": [
17
+ "*.css",
18
+ "./dist/lib/echarts-setup.js"
19
+ ],
20
+ "files": [
21
+ "dist",
22
+ "scripts/doctor.mjs",
23
+ "contract.json",
24
+ "components.manifest.json",
25
+ "docs",
26
+ "AGENTS.md",
27
+ "README.md",
28
+ "LICENSE",
29
+ "scripts/init.mjs",
30
+ "scripts/manifest.mjs",
31
+ "scripts/brand-core.mjs",
32
+ "scripts/setup.mjs",
33
+ "scripts/i18n.mjs"
34
+ ],
35
+ "exports": {
36
+ "./styles.css": "./dist/styles.css",
37
+ "./themes/*.css": "./dist/themes/*.css",
38
+ "./themes/*.md": "./dist/themes/*.md",
39
+ "./themes/*.meta.json": "./dist/themes/*.meta.json",
40
+ "./themes/*.tokens.json": "./dist/themes/*.tokens.json",
41
+ "./ui/*": {
42
+ "types": "./dist/ui/*.d.ts",
43
+ "import": "./dist/ui/*.js"
44
+ },
45
+ "./lib/*": {
46
+ "types": "./dist/lib/*.d.ts",
47
+ "import": "./dist/lib/*.js"
48
+ },
49
+ "./hooks/*": {
50
+ "types": "./dist/hooks/*.d.ts",
51
+ "import": "./dist/hooks/*.js"
52
+ },
53
+ "./package.json": "./package.json",
54
+ "./contract.json": "./contract.json",
55
+ "./components.manifest.json": "./components.manifest.json"
56
+ },
57
+ "scripts": {
58
+ "build": "tsup && node scripts/build-css.mjs",
59
+ "dev": "tsup --watch --onSuccess \"node scripts/copy-css.mjs\"",
60
+ "typecheck": "tsc --noEmit",
61
+ "verify": "pnpm check:ds && pnpm typecheck && pnpm showcase:typecheck && pnpm build && pnpm check:bundle",
62
+ "manifest": "node scripts/manifest.mjs",
63
+ "check:ds": "node scripts/doctor.mjs",
64
+ "check:bundle": "node scripts/check-bundle.mjs",
65
+ "showcase": "vite --config showcase/vite.config.ts",
66
+ "showcase:build": "vite build --config showcase/vite.config.ts",
67
+ "showcase:typecheck": "tsc --noEmit -p showcase"
68
+ },
69
+ "peerDependencies": {
70
+ "@base-ui/react": ">=1.9",
71
+ "@shadcn/react": ">=0.3",
72
+ "class-variance-authority": ">=0.7",
73
+ "clsx": ">=2",
74
+ "cmdk": ">=1.1",
75
+ "date-fns": ">=4",
76
+ "embla-carousel-react": ">=8.6",
77
+ "input-otp": ">=1.5",
78
+ "lucide-react": ">=0.400",
79
+ "motion": ">=12",
80
+ "next-themes": ">=0.4",
81
+ "react": ">=19",
82
+ "react-day-picker": ">=10",
83
+ "react-dom": ">=19",
84
+ "react-resizable-panels": ">=4",
85
+ "recharts": ">=3",
86
+ "sonner": ">=2",
87
+ "tailwind-merge": ">=3",
88
+ "tailwindcss": ">=4.1",
89
+ "tw-animate-css": ">=1.3",
90
+ "echarts": ">=6",
91
+ "@tanstack/react-table": ">=9"
92
+ },
93
+ "peerDependenciesMeta": {
94
+ "next-themes": {
95
+ "optional": true
96
+ },
97
+ "recharts": {
98
+ "optional": true
99
+ },
100
+ "sonner": {
101
+ "optional": true
102
+ },
103
+ "@shadcn/react": {
104
+ "optional": true
105
+ },
106
+ "cmdk": {
107
+ "optional": true
108
+ },
109
+ "date-fns": {
110
+ "optional": true
111
+ },
112
+ "embla-carousel-react": {
113
+ "optional": true
114
+ },
115
+ "input-otp": {
116
+ "optional": true
117
+ },
118
+ "react-day-picker": {
119
+ "optional": true
120
+ },
121
+ "react-resizable-panels": {
122
+ "optional": true
123
+ },
124
+ "motion": {
125
+ "optional": true
126
+ },
127
+ "echarts": {
128
+ "optional": true
129
+ },
130
+ "@tanstack/react-table": {
131
+ "optional": true
132
+ }
133
+ },
134
+ "devDependencies": {
135
+ "@base-ui/react": "^1.9.0",
136
+ "@shadcn/react": "^0.3.1",
137
+ "@tailwindcss/vite": "^4.3.3",
138
+ "@tanstack/react-table": "^9.2.8",
139
+ "@types/react": "^19.2.0",
140
+ "@types/react-dom": "^19.2.0",
141
+ "@vitejs/plugin-react": "^6.1.2",
142
+ "class-variance-authority": "^0.7.1",
143
+ "clsx": "^2.1.1",
144
+ "cmdk": "^1.1.1",
145
+ "date-fns": "^4.4.0",
146
+ "echarts": "^6.1.0",
147
+ "embla-carousel-react": "^8.6.0",
148
+ "input-otp": "^1.5.0",
149
+ "lucide-react": "^0.577.0",
150
+ "motion": "^14.1.0",
151
+ "next-themes": "^0.4.6",
152
+ "react": "^19.2.0",
153
+ "react-day-picker": "^10.0.2",
154
+ "react-dom": "^19.2.0",
155
+ "react-resizable-panels": "^4.14.4",
156
+ "recharts": "3.8.0",
157
+ "sonner": "^2.0.8",
158
+ "tailwind-merge": "^3.0.2",
159
+ "tailwindcss": "^4.1.18",
160
+ "tsup": "^8.5.0",
161
+ "tw-animate-css": "^1.3.6",
162
+ "typescript": "^5.9.0",
163
+ "vite": "^8.3.4"
164
+ },
165
+ "bin": {
166
+ "orbital-ds-doctor": "./scripts/doctor.mjs",
167
+ "orbital-ds-init": "./scripts/init.mjs",
168
+ "orbital-ds-i18n": "./scripts/i18n.mjs"
169
+ },
170
+ "dependencies": {
171
+ "@clack/prompts": "^1.8.1"
172
+ }
173
+ }
@@ -84,15 +84,17 @@ function ajustar(color, dir, bien) {
84
84
  /**
85
85
  * Deriva la marca. Devuelve { claro, oscuro, avisos } con los tokens (sin el prefijo --).
86
86
  * `acento` y `marcador` solo si el tema tiene gestos.
87
+ * `base` ({ papel, tinta, fondoO, textoO }): neutros REALES del tema. Con ellos, el texto sobre el
88
+ * primario, el enlace y el contraste se calculan contra la paleta del tema (modo «solo primario»).
87
89
  */
88
- export function derivar(primario, { acento, marcador = true, gestos = false }) {
90
+ export function derivar(primario, { acento, marcador = true, gestos = false, base = {} }) {
89
91
  const avisos = [];
90
92
  const P = rgbToOklch(primario);
91
93
  const H = P.c < 0.02 ? 255 : P.h; // primario casi gris: neutros azulados por defecto
92
94
  const tinte = Math.min(0.02, 0.008 + P.c * 0.05);
93
95
 
94
96
  /* ── piel clara ── */
95
- const papel = ok(0.965, tinte, H), tinta = ok(0.235, 0.05, H), blanco = { r: 255, g: 255, b: 255 };
97
+ const papel = base.papel ?? ok(0.965, tinte, H), tinta = base.tinta ?? ok(0.235, 0.05, H), blanco = { r: 255, g: 255, b: 255 };
96
98
  const suave = ok(0.925, tinte + 0.008, H);
97
99
  let prim = primario;
98
100
  const textoSobre = (c) => (ratio(blanco, c) >= ratio(tinta, c) ? blanco : tinta);
@@ -122,7 +124,7 @@ export function derivar(primario, { acento, marcador = true, gestos = false }) {
122
124
  }
123
125
 
124
126
  /* ── piel oscura ── */
125
- const fondoO = ok(0.19, 0.03, H), tarjetaO = ok(0.25, 0.04, H), suaveO = ok(0.22, 0.035, H), textoO = ok(0.95, 0.012, H);
127
+ const fondoO = base.fondoO ?? ok(0.19, 0.03, H), tarjetaO = ok(0.25, 0.04, H), suaveO = ok(0.22, 0.035, H), textoO = base.textoO ?? ok(0.95, 0.012, H);
126
128
  let primO = oklchToRgb({ ...P, l: Math.max(P.l, 0.74), c: Math.min(P.c, 0.2) });
127
129
  const primOFg = fondoO;
128
130
  if (ratio(primOFg, primO) < 4.5) primO = ajustar(primO, +1, (c) => ratio(primOFg, c) >= 4.5) ?? primO;