orbital-ds 0.13.1 → 0.14.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 (114) hide show
  1. package/AGENTS.md +3 -1
  2. package/README.md +93 -93
  3. package/components.manifest.json +1 -1
  4. package/dist/hooks/use-ds-messages.js +1 -1
  5. package/dist/hooks/use-ds-motion.js +1 -1
  6. package/dist/lib/echarts-server.js +2 -2
  7. package/dist/styles.css +1041 -1040
  8. package/dist/themes/liquid.css +500 -0
  9. package/dist/themes/liquid.fonts.css +7 -0
  10. package/dist/themes/liquid.guide.md +73 -0
  11. package/dist/themes/liquid.meta.json +134 -0
  12. package/dist/themes/liquid.scoped.css +500 -0
  13. package/dist/themes/liquid.tokens.json +47 -0
  14. package/dist/ui/accordion.js +1 -1
  15. package/dist/ui/alert-dialog.js +2 -2
  16. package/dist/ui/alert.js +1 -1
  17. package/dist/ui/aspect-ratio.js +1 -1
  18. package/dist/ui/attachment.js +2 -2
  19. package/dist/ui/avatar.js +1 -1
  20. package/dist/ui/ayuda.js +1 -1
  21. package/dist/ui/badge.d.ts +1 -1
  22. package/dist/ui/badge.js +1 -1
  23. package/dist/ui/banner.js +1 -1
  24. package/dist/ui/breadcrumb.js +2 -2
  25. package/dist/ui/bubble.d.ts +1 -1
  26. package/dist/ui/bubble.js +1 -1
  27. package/dist/ui/button-group.js +2 -2
  28. package/dist/ui/button.d.ts +1 -1
  29. package/dist/ui/button.js +1 -1
  30. package/dist/ui/calendar.js +3 -3
  31. package/dist/ui/card.js +1 -1
  32. package/dist/ui/carousel.js +3 -3
  33. package/dist/ui/chart.js +1 -1
  34. package/dist/ui/checkbox.js +1 -1
  35. package/dist/ui/code-block.js +3 -3
  36. package/dist/ui/combobox.js +3 -3
  37. package/dist/ui/command.js +4 -4
  38. package/dist/ui/context-menu.js +1 -1
  39. package/dist/ui/data-table.js +12 -12
  40. package/dist/ui/date-picker.js +6 -6
  41. package/dist/ui/dialog.js +3 -3
  42. package/dist/ui/drawer.js +1 -1
  43. package/dist/ui/dropdown-menu.js +1 -1
  44. package/dist/ui/dropzone.js +4 -4
  45. package/dist/ui/echart.js +5 -5
  46. package/dist/ui/empty.js +1 -1
  47. package/dist/ui/eyebrow.js +1 -1
  48. package/dist/ui/field.js +3 -3
  49. package/dist/ui/filter-bar.js +5 -5
  50. package/dist/ui/gauge.js +3 -3
  51. package/dist/ui/heatmap-grid.js +4 -4
  52. package/dist/ui/hover-card.js +1 -1
  53. package/dist/ui/i18n-provider.js +2 -2
  54. package/dist/ui/icon-tile.js +1 -1
  55. package/dist/ui/input-group.js +4 -4
  56. package/dist/ui/input-otp.js +1 -1
  57. package/dist/ui/input.js +1 -1
  58. package/dist/ui/item.d.ts +1 -1
  59. package/dist/ui/item.js +2 -2
  60. package/dist/ui/kbd.js +1 -1
  61. package/dist/ui/label.js +1 -1
  62. package/dist/ui/legend.js +1 -1
  63. package/dist/ui/level-meter.js +3 -3
  64. package/dist/ui/marker.d.ts +1 -1
  65. package/dist/ui/marker.js +1 -1
  66. package/dist/ui/menubar.js +2 -2
  67. package/dist/ui/message-scroller.js +3 -3
  68. package/dist/ui/message.js +1 -1
  69. package/dist/ui/motion-provider.js +1 -1
  70. package/dist/ui/native-select.js +1 -1
  71. package/dist/ui/navigation-menu.js +1 -1
  72. package/dist/ui/notifications.js +8 -8
  73. package/dist/ui/page-header.js +2 -2
  74. package/dist/ui/pagination.js +3 -3
  75. package/dist/ui/panel.js +1 -1
  76. package/dist/ui/password-strength.js +3 -3
  77. package/dist/ui/popover.js +1 -1
  78. package/dist/ui/progress.js +1 -1
  79. package/dist/ui/proportion-bar.js +3 -3
  80. package/dist/ui/questionnaire.js +3 -3
  81. package/dist/ui/radio-group.js +1 -1
  82. package/dist/ui/resizable.js +1 -1
  83. package/dist/ui/scroll-area.js +1 -1
  84. package/dist/ui/select.js +1 -1
  85. package/dist/ui/separator.js +1 -1
  86. package/dist/ui/sheet.js +3 -3
  87. package/dist/ui/shield.js +4 -4
  88. package/dist/ui/sidebar.js +9 -9
  89. package/dist/ui/skeleton.js +1 -1
  90. package/dist/ui/slider.js +1 -1
  91. package/dist/ui/sparkline.d.ts +1 -1
  92. package/dist/ui/sparkline.js +1 -1
  93. package/dist/ui/spinner.js +2 -2
  94. package/dist/ui/stat.js +6 -6
  95. package/dist/ui/status-badge.d.ts +2 -2
  96. package/dist/ui/status-badge.js +3 -3
  97. package/dist/ui/status-hero.js +3 -3
  98. package/dist/ui/step-dots.js +3 -3
  99. package/dist/ui/step-ring.js +3 -3
  100. package/dist/ui/stepper.js +3 -3
  101. package/dist/ui/switch.js +2 -2
  102. package/dist/ui/table.js +1 -1
  103. package/dist/ui/tabs.d.ts +1 -1
  104. package/dist/ui/tabs.js +1 -1
  105. package/dist/ui/task-loader.js +2 -2
  106. package/dist/ui/task-progress.js +3 -3
  107. package/dist/ui/textarea.js +1 -1
  108. package/dist/ui/timeline.js +3 -3
  109. package/dist/ui/toast.js +3 -3
  110. package/dist/ui/toggle-group.js +2 -2
  111. package/dist/ui/toggle.js +1 -1
  112. package/dist/ui/tooltip.js +1 -1
  113. package/package.json +180 -180
  114. package/scripts/cli.mjs +370 -370
package/AGENTS.md CHANGED
@@ -162,7 +162,9 @@ Si `pnpm check:ds` falla, **corrige la causa**; no lo desactives ni lo rodees.
162
162
 
163
163
  1. Fichero en `src/ui/<nombre>.tsx` (un componente = un fichero; sin barril).
164
164
  2. `data-slot="<nombre>"` en su raíz y en las partes relevantes.
165
- 3. Solo tokens. Importa `cn` de `../lib/utils`; los demás componentes, de `./<otro>`.
165
+ 3. Solo tokens. Importa `cn` de `../lib/utils.js`; los demás componentes, de `./<otro>.js`. **Los imports relativos llevan
166
+ siempre `.js`**: el paquete es `"type": "module"` y Node (tests, SSR sin bundler) no completa la ruta; `check:pack`
167
+ importa cada export con Node puro.
166
168
  4. Dependencias de terceros de un COMPONENTE: opcionales (`peerDependenciesMeta`), nunca
167
169
  obligatorias. Las herramientas de terminal del paquete (`orbital-ds-init`) sí pueden
168
170
  tener las suyas (`@clack/prompts`), porque no llegan al bundle de la app.
package/README.md CHANGED
@@ -1,93 +1,93 @@
1
- # orbital-ds
2
-
3
- Sistema de diseño genérico: **estructura común + temas intercambiables + ~60 componentes**
4
- sobre [Base UI](https://base-ui.com) y Tailwind v4 (los de shadcn en su versión Base UI).
5
-
6
- - `styles.css` — la ESTRUCTURA: mapea variables de tema a utilidades de Tailwind y define los
7
- tokens semánticos (radios, alturas, sombras, espaciado, capas, movimiento, foco, materiales)
8
- y la capa base. No lleva colores ni fuentes.
9
- - `themes/<tema>.css` — un TEMA: paleta (claro/oscuro), radio base y tipografía.
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.
12
- - `themes/<tema>.fonts.css` — las fuentes del tema (un `@import url()`; va el primero).
13
- - `ui/*` — componentes, uno por fichero (`orbital-ds/ui/button`, …): quien no usa gráficos
14
- no necesita `recharts`, quien no usa el calendario no necesita `react-day-picker`.
15
- - `contract.json` + `pnpm check:ds` — el contrato de tema y su comprobación.
16
-
17
- ## Uso en una app (Tailwind v4)
18
-
19
- ```css
20
- @import 'orbital-ds/themes/qratia.fonts.css'; /* fuentes: lo primero */
21
- @import 'tailwindcss';
22
- @plugin '@tailwindcss/typography';
23
- @import 'tw-animate-css';
24
- @import 'orbital-ds/styles.css'; /* estructura */
25
- @import 'orbital-ds/themes/qratia.css'; /* tema (después de la estructura) */
26
- @source '../node_modules/orbital-ds/dist'; /* que Tailwind vea las clases del paquete */
27
- ```
28
-
29
- ```tsx
30
- import { Button } from 'orbital-ds/ui/button';
31
- ```
32
-
33
- Cambiar de identidad = cambiar `qratia` por `zyro` en esas dos líneas de tema/fuentes.
34
- Detalle del contrato, tokens y reglas de nombres en [`docs/CONTRACT.md`](docs/CONTRACT.md).
35
-
36
- ## Generar la marca desde un color (asistente)
37
-
38
- ```
39
- pnpm exec orbital-ds-init # asistente interactivo
40
- pnpm exec orbital-ds-init --primary "#1D63D8" # sin preguntas (CI, scripts)
41
- ```
42
-
43
- A partir del **color primario** (hex, `rgb()`, `hsl()` u `oklch()`) deriva en OKLCH los neutros teñidos
44
- (papel, tinta, tarjeta, bordes, lateral), el texto sobre el primario, el enlace y el foco, en piel clara y
45
- oscura, y **comprueba el contraste** (AA 4,5:1). Si un color no llega, lo ajusta lo mínimo y te lo dice.
46
- Escribe solo un bloque delimitado en `brand.css`; con `--update` lo reescribe y lo tuyo de fuera no se
47
- toca. Opciones: `--theme`, `--accent`, `--no-marker` (apaga el rotulador de `tactile`), `--dry-run`,
48
- `--yes`, `--out`. Sin dependencias.
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
-
55
- ## Guía de cada tema
56
-
57
- Cada tema lleva su documentación, que viaja con el paquete:
58
-
59
- - `orbital-ds/themes/<tema>.guide.md` — guía de diseño: esencia, gesto firma, principios, referencias (qué se tomó de cada una), paleta, tipografía, formas, accesibilidad y estado de los valores (confirmados, aproximados o de diseño propio).
60
- - `orbital-ds/themes/<tema>.meta.json` — la misma ficha legible por máquina.
61
-
62
- `pnpm check:ds` falla si a un tema le falta alguna de las dos. Un tema nuevo debe nacer con ambas.
63
-
64
- ## Marca de una app
65
-
66
- Lo propio de cada app (color principal, acento, radio, fuentes) va en **su** `src/brand.css`,
67
- importado después del tema. Ninguna actualización de orbital-ds lo toca. `pnpm exec orbital-ds-init`
68
- lo crea la primera vez. Detalle en [`docs/CONTRACT.md`](docs/CONTRACT.md).
69
-
70
- ## Regla
71
-
72
- Ningún componente lleva valores propios (colores, medidas, sombras, z-index, duraciones):
73
- pide un hueco a una variable. Para cambiar el aspecto se cambia el tema, no el componente.
74
- Si un componente necesita un hueco nuevo, se AÑADE el token con un valor que deje el aspecto
75
- como estaba. `pnpm check:ds` lo comprueba.
76
-
77
- ## Desarrollo
78
-
79
- ```bash
80
- pnpm install
81
- pnpm verify # doctor + typecheck + build
82
- pnpm check:ds # solo el contrato de tema y los valores fijos
83
- ```
84
-
85
- Peers obligatorios: `react`, `react-dom`, `@base-ui/react`, `tailwindcss`, `tailwind-merge`,
86
- `class-variance-authority`, `clsx`, `lucide-react`, `tw-animate-css`.
87
- Opcionales (solo si usas ese componente): `recharts`, `sonner`, `next-themes`, `cmdk`,
88
- `date-fns` + `react-day-picker`, `embla-carousel-react`, `input-otp`,
89
- `react-resizable-panels`, `@shadcn/react`.
90
-
91
- ## Licencia
92
-
93
- MIT © Fractalia Systems
1
+ # orbital-ds
2
+
3
+ Sistema de diseño genérico: **estructura común + temas intercambiables + ~60 componentes**
4
+ sobre [Base UI](https://base-ui.com) y Tailwind v4 (los de shadcn en su versión Base UI).
5
+
6
+ - `styles.css` — la ESTRUCTURA: mapea variables de tema a utilidades de Tailwind y define los
7
+ tokens semánticos (radios, alturas, sombras, espaciado, capas, movimiento, foco, materiales)
8
+ y la capa base. No lleva colores ni fuentes.
9
+ - `themes/<tema>.css` — un TEMA: paleta (claro/oscuro), radio base y tipografía.
10
+ Hoy: `qratia`, `zyro` (cristal), `liquid` (Liquid Glass de Apple), `friendly`, `twitter`, `tactile` y `fractalia` (sistema corporativo de
11
+ Fractalia, para usarlo fiel). Añadir otro = añadir otro fichero.
12
+ - `themes/<tema>.fonts.css` — las fuentes del tema (un `@import url()`; va el primero).
13
+ - `ui/*` — componentes, uno por fichero (`orbital-ds/ui/button`, …): quien no usa gráficos
14
+ no necesita `recharts`, quien no usa el calendario no necesita `react-day-picker`.
15
+ - `contract.json` + `pnpm check:ds` — el contrato de tema y su comprobación.
16
+
17
+ ## Uso en una app (Tailwind v4)
18
+
19
+ ```css
20
+ @import 'orbital-ds/themes/qratia.fonts.css'; /* fuentes: lo primero */
21
+ @import 'tailwindcss';
22
+ @plugin '@tailwindcss/typography';
23
+ @import 'tw-animate-css';
24
+ @import 'orbital-ds/styles.css'; /* estructura */
25
+ @import 'orbital-ds/themes/qratia.css'; /* tema (después de la estructura) */
26
+ @source '../node_modules/orbital-ds/dist'; /* que Tailwind vea las clases del paquete */
27
+ ```
28
+
29
+ ```tsx
30
+ import { Button } from 'orbital-ds/ui/button';
31
+ ```
32
+
33
+ Cambiar de identidad = cambiar `qratia` por `zyro` en esas dos líneas de tema/fuentes.
34
+ Detalle del contrato, tokens y reglas de nombres en [`docs/CONTRACT.md`](docs/CONTRACT.md).
35
+
36
+ ## Generar la marca desde un color (asistente)
37
+
38
+ ```
39
+ pnpm exec orbital-ds-init # asistente interactivo
40
+ pnpm exec orbital-ds-init --primary "#1D63D8" # sin preguntas (CI, scripts)
41
+ ```
42
+
43
+ A partir del **color primario** (hex, `rgb()`, `hsl()` u `oklch()`) deriva en OKLCH los neutros teñidos
44
+ (papel, tinta, tarjeta, bordes, lateral), el texto sobre el primario, el enlace y el foco, en piel clara y
45
+ oscura, y **comprueba el contraste** (AA 4,5:1). Si un color no llega, lo ajusta lo mínimo y te lo dice.
46
+ Escribe solo un bloque delimitado en `brand.css`; con `--update` lo reescribe y lo tuyo de fuera no se
47
+ toca. Opciones: `--theme`, `--accent`, `--no-marker` (apaga el rotulador de `tactile`), `--dry-run`,
48
+ `--yes`, `--out`. Sin dependencias.
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
+
55
+ ## Guía de cada tema
56
+
57
+ Cada tema lleva su documentación, que viaja con el paquete:
58
+
59
+ - `orbital-ds/themes/<tema>.guide.md` — guía de diseño: esencia, gesto firma, principios, referencias (qué se tomó de cada una), paleta, tipografía, formas, accesibilidad y estado de los valores (confirmados, aproximados o de diseño propio).
60
+ - `orbital-ds/themes/<tema>.meta.json` — la misma ficha legible por máquina.
61
+
62
+ `pnpm check:ds` falla si a un tema le falta alguna de las dos. Un tema nuevo debe nacer con ambas.
63
+
64
+ ## Marca de una app
65
+
66
+ Lo propio de cada app (color principal, acento, radio, fuentes) va en **su** `src/brand.css`,
67
+ importado después del tema. Ninguna actualización de orbital-ds lo toca. `pnpm exec orbital-ds-init`
68
+ lo crea la primera vez. Detalle en [`docs/CONTRACT.md`](docs/CONTRACT.md).
69
+
70
+ ## Regla
71
+
72
+ Ningún componente lleva valores propios (colores, medidas, sombras, z-index, duraciones):
73
+ pide un hueco a una variable. Para cambiar el aspecto se cambia el tema, no el componente.
74
+ Si un componente necesita un hueco nuevo, se AÑADE el token con un valor que deje el aspecto
75
+ como estaba. `pnpm check:ds` lo comprueba.
76
+
77
+ ## Desarrollo
78
+
79
+ ```bash
80
+ pnpm install
81
+ pnpm verify # doctor + typecheck + build
82
+ pnpm check:ds # solo el contrato de tema y los valores fijos
83
+ ```
84
+
85
+ Peers obligatorios: `react`, `react-dom`, `@base-ui/react`, `tailwindcss`, `tailwind-merge`,
86
+ `class-variance-authority`, `clsx`, `lucide-react`, `tw-animate-css`.
87
+ Opcionales (solo si usas ese componente): `recharts`, `sonner`, `next-themes`, `cmdk`,
88
+ `date-fns` + `react-day-picker`, `embla-carousel-react`, `input-otp`,
89
+ `react-resizable-panels`, `@shadcn/react`.
90
+
91
+ ## Licencia
92
+
93
+ MIT © Fractalia Systems
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.13.1",
3
+ "version": "0.13.2",
4
4
  "engine": "@base-ui/react",
5
5
  "docs": [
6
6
  "README.md",
@@ -1,5 +1,5 @@
1
1
  import * as React from "react";
2
- import { dsCatalogs, DS_DEFAULT_LOCALE } from "../lib/i18n";
2
+ import { dsCatalogs, DS_DEFAULT_LOCALE } from "../lib/i18n.js";
3
3
  const DsMessagesContext = React.createContext(
4
4
  dsCatalogs[DS_DEFAULT_LOCALE]
5
5
  );
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import {
3
3
  readDsTransition,
4
4
  readDsMotion
5
- } from "../lib/motion";
5
+ } from "../lib/motion.js";
6
6
  function useDsTransition(duration = "base", ease = "standard") {
7
7
  const [transition, setTransition] = React.useState(
8
8
  () => readDsTransition(duration, ease)
@@ -1,5 +1,5 @@
1
- import { dsEcharts } from "./echarts-setup";
2
- import { dsEchartsThemeFromTokens } from "./echarts-theme";
1
+ import { dsEcharts } from "./echarts-setup.js";
2
+ import { dsEchartsThemeFromTokens } from "./echarts-theme.js";
3
3
  function renderEChartToSvg(option, { width, height, tokens, theme, animation = false }) {
4
4
  const tema = theme ?? (tokens ? dsEchartsThemeFromTokens(tokens, { reducedMotion: !animation }) : void 0);
5
5
  const chart = dsEcharts().init(null, tema, { renderer: "svg", ssr: true, width, height });