orbital-ds 0.14.0 → 0.16.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 (44) hide show
  1. package/AGENTS.md +5 -0
  2. package/README.md +97 -93
  3. package/components.manifest.json +79 -1
  4. package/dist/hooks/use-ds-messages.d.ts +5 -0
  5. package/dist/lib/i18n.d.ts +5 -0
  6. package/dist/lib/i18n.js +18 -3
  7. package/dist/styles.css +1108 -1041
  8. package/dist/themes/fractalia.css +77 -1
  9. package/dist/themes/fractalia.guide.md +10 -3
  10. package/dist/themes/fractalia.meta.json +16 -3
  11. package/dist/themes/fractalia.scoped.css +77 -1
  12. package/dist/themes/liquid.css +502 -500
  13. package/dist/themes/liquid.fonts.css +7 -7
  14. package/dist/themes/liquid.guide.md +82 -73
  15. package/dist/themes/liquid.meta.json +134 -134
  16. package/dist/themes/liquid.scoped.css +502 -500
  17. package/dist/ui/ai-tag.d.ts +8 -0
  18. package/dist/ui/ai-tag.js +45 -0
  19. package/dist/ui/alert.js +18 -9
  20. package/dist/ui/avatar.d.ts +4 -1
  21. package/dist/ui/avatar.js +10 -1
  22. package/dist/ui/badge.d.ts +1 -1
  23. package/dist/ui/bottom-nav.d.ts +15 -0
  24. package/dist/ui/bottom-nav.js +97 -0
  25. package/dist/ui/bubble.d.ts +1 -1
  26. package/dist/ui/button.d.ts +1 -1
  27. package/dist/ui/choice-card.d.ts +16 -0
  28. package/dist/ui/choice-card.js +98 -0
  29. package/dist/ui/copy-button.d.ts +14 -0
  30. package/dist/ui/copy-button.js +112 -0
  31. package/dist/ui/icon-tile.d.ts +1 -1
  32. package/dist/ui/input-group.d.ts +1 -1
  33. package/dist/ui/item.d.ts +1 -1
  34. package/dist/ui/marker.d.ts +1 -1
  35. package/dist/ui/progress.d.ts +4 -1
  36. package/dist/ui/progress.js +5 -1
  37. package/dist/ui/sparkline.d.ts +1 -1
  38. package/dist/ui/status-badge.d.ts +2 -2
  39. package/dist/ui/tabs.d.ts +1 -1
  40. package/package.json +181 -180
  41. package/scripts/brand-file.mjs +221 -0
  42. package/scripts/cli.mjs +452 -370
  43. package/scripts/init.mjs +176 -72
  44. package/scripts/setup.mjs +90 -10
package/AGENTS.md CHANGED
@@ -120,6 +120,11 @@ la app (bloque de imports en orden), anota DESIGN.md, instala Motion y pasa el d
120
120
  (p. ej. `fractalia`) declara `"branding": "faithful"`: no le derives la paleta.
121
121
  - Sin preguntas: `--theme fractalia --connect` (fiel) · `--primary <color> --mode primary --theme <tema>` ·
122
122
  `--primary <color> --theme <tema> --connect --motion` (completa).
123
+ - **Cambiar de tema**: `orbital-ds theme <tema> [--brand adapt|clean|clean-all|keep]`. `adapt` recalcula la marca
124
+ para el tema nuevo y desactiva los colores escritos a mano para el anterior; `clean` solo desactiva esos colores;
125
+ `clean-all`, toda la marca; `keep` la deja (por defecto sin terminal, con aviso). Lo desactivado queda comentado,
126
+ con copia `.bak`; quita también los imports de tema sueltos y pone `@base-theme` al tema nuevo. Al pasar por un
127
+ tema fiel, la marca queda recordada y vuelve al salir de él.
123
128
 
124
129
  ## Diseñar con orbital-ds (diseñador para agentes)
125
130
 
package/README.md CHANGED
@@ -1,93 +1,97 @@
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
+ # 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
+ **Cambiar de tema** sin restos del anterior: `pnpm exec orbital-ds theme <tema>` pregunta qué hacer con la marca
56
+ (`--brand adapt|clean|clean-all|keep` sin preguntas). Desactiva, comentándolos y con copia `.bak`, los colores
57
+ escritos a mano para el tema anterior, y quita los imports de tema sueltos.
58
+
59
+ ## Guía de cada tema
60
+
61
+ Cada tema lleva su documentación, que viaja con el paquete:
62
+
63
+ - `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).
64
+ - `orbital-ds/themes/<tema>.meta.json` — la misma ficha legible por máquina.
65
+
66
+ `pnpm check:ds` falla si a un tema le falta alguna de las dos. Un tema nuevo debe nacer con ambas.
67
+
68
+ ## Marca de una app
69
+
70
+ Lo propio de cada app (color principal, acento, radio, fuentes) va en **su** `src/brand.css`,
71
+ importado después del tema. Ninguna actualización de orbital-ds lo toca. `pnpm exec orbital-ds-init`
72
+ lo crea la primera vez. Detalle en [`docs/CONTRACT.md`](docs/CONTRACT.md).
73
+
74
+ ## Regla
75
+
76
+ Ningún componente lleva valores propios (colores, medidas, sombras, z-index, duraciones):
77
+ pide un hueco a una variable. Para cambiar el aspecto se cambia el tema, no el componente.
78
+ Si un componente necesita un hueco nuevo, se AÑADE el token con un valor que deje el aspecto
79
+ como estaba. `pnpm check:ds` lo comprueba.
80
+
81
+ ## Desarrollo
82
+
83
+ ```bash
84
+ pnpm install
85
+ pnpm verify # doctor + typecheck + build
86
+ pnpm check:ds # solo el contrato de tema y los valores fijos
87
+ ```
88
+
89
+ Peers obligatorios: `react`, `react-dom`, `@base-ui/react`, `tailwindcss`, `tailwind-merge`,
90
+ `class-variance-authority`, `clsx`, `lucide-react`, `tw-animate-css`.
91
+ Opcionales (solo si usas ese componente): `recharts`, `sonner`, `next-themes`, `cmdk`,
92
+ `date-fns` + `react-day-picker`, `embla-carousel-react`, `input-otp`,
93
+ `react-resizable-panels`, `@shadcn/react`.
94
+
95
+ ## Licencia
96
+
97
+ MIT © Fractalia Systems
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.13.2",
3
+ "version": "0.15.0",
4
4
  "engine": "@base-ui/react",
5
5
  "docs": [
6
6
  "README.md",
@@ -27,6 +27,21 @@
27
27
  ],
28
28
  "optionalPeers": []
29
29
  },
30
+ "ai-tag": {
31
+ "import": "orbital-ds/ui/ai-tag",
32
+ "exports": [
33
+ "AiTag",
34
+ "AiTagMeta"
35
+ ],
36
+ "slots": [
37
+ "ai-tag",
38
+ "ai-tag-meta"
39
+ ],
40
+ "optionalPeers": [],
41
+ "notes": [
42
+ "Informativa, no pulsable: para filtrar por contenido de IA, un Toggle o un filtro."
43
+ ]
44
+ },
30
45
  "alert-dialog": {
31
46
  "import": "orbital-ds/ui/alert-dialog",
32
47
  "exports": [
@@ -172,6 +187,27 @@
172
187
  ],
173
188
  "optionalPeers": []
174
189
  },
190
+ "bottom-nav": {
191
+ "import": "orbital-ds/ui/bottom-nav",
192
+ "exports": [
193
+ "BottomNav",
194
+ "BottomNavBadge",
195
+ "BottomNavIcon",
196
+ "BottomNavItem",
197
+ "BottomNavLabel"
198
+ ],
199
+ "slots": [
200
+ "bottom-nav",
201
+ "bottom-nav-badge",
202
+ "bottom-nav-icon",
203
+ "bottom-nav-label"
204
+ ],
205
+ "optionalPeers": [],
206
+ "notes": [
207
+ "Solo en móvil y para 3–5 destinos de primer nivel; en escritorio, el lateral (Sidebar).",
208
+ "Sin BottomNavLabel, pon aria-label en cada BottomNavItem: el icono solo no se anuncia."
209
+ ]
210
+ },
175
211
  "breadcrumb": {
176
212
  "import": "orbital-ds/ui/breadcrumb",
177
213
  "exports": [
@@ -329,6 +365,31 @@
329
365
  ],
330
366
  "optionalPeers": []
331
367
  },
368
+ "choice-card": {
369
+ "import": "orbital-ds/ui/choice-card",
370
+ "exports": [
371
+ "ChoiceCard",
372
+ "ChoiceCardContent",
373
+ "ChoiceCardDescription",
374
+ "ChoiceCardGroup",
375
+ "ChoiceCardIndicator",
376
+ "ChoiceCardMedia",
377
+ "ChoiceCardTitle"
378
+ ],
379
+ "slots": [
380
+ "choice-card",
381
+ "choice-card-content",
382
+ "choice-card-description",
383
+ "choice-card-group",
384
+ "choice-card-indicator",
385
+ "choice-card-media",
386
+ "choice-card-title"
387
+ ],
388
+ "optionalPeers": [],
389
+ "notes": [
390
+ "De 2 a 6 opciones mutuamente excluyentes, con texto corto; más opciones o texto largo, RadioGroup o Select."
391
+ ]
392
+ },
332
393
  "code-block": {
333
394
  "import": "orbital-ds/ui/code-block",
334
395
  "exports": [
@@ -466,6 +527,23 @@
466
527
  ],
467
528
  "optionalPeers": []
468
529
  },
530
+ "copy-button": {
531
+ "import": "orbital-ds/ui/copy-button",
532
+ "exports": [
533
+ "CopyButton",
534
+ "CopyField"
535
+ ],
536
+ "slots": [
537
+ "copy-button",
538
+ "copy-field",
539
+ "copy-field-icon",
540
+ "copy-field-value"
541
+ ],
542
+ "optionalPeers": [],
543
+ "notes": [
544
+ "El dato va limpio, sin instrucciones dentro del texto («Copia esta IP…»): el botón ya lo dice."
545
+ ]
546
+ },
469
547
  "data-table": {
470
548
  "import": "orbital-ds/ui/data-table",
471
549
  "exports": [
@@ -100,6 +100,11 @@ declare const DsMessagesContext: React.Context<{
100
100
  toneDanger: string;
101
101
  toneInfo: string;
102
102
  toneNeutral: string;
103
+ copy: string;
104
+ copied: string;
105
+ copyValue: string;
106
+ aiGenerated: string;
107
+ bottomNav: string;
103
108
  }>;
104
109
  /** Textos de los componentes en el idioma activo. */
105
110
  declare function useDsMessages(): DsMessages;
@@ -99,6 +99,11 @@ declare const en: {
99
99
  toneDanger: string;
100
100
  toneInfo: string;
101
101
  toneNeutral: string;
102
+ copy: string;
103
+ copied: string;
104
+ copyValue: string;
105
+ aiGenerated: string;
106
+ bottomNav: string;
102
107
  };
103
108
  type DsMessages = typeof en;
104
109
  type DsMessageKey = keyof DsMessages;
package/dist/lib/i18n.js CHANGED
@@ -97,7 +97,12 @@ const en = {
97
97
  toneWarning: "Warning",
98
98
  toneDanger: "Error",
99
99
  toneInfo: "Information",
100
- toneNeutral: "Neutral"
100
+ toneNeutral: "Neutral",
101
+ copy: "Copy to clipboard",
102
+ copied: "Copied",
103
+ copyValue: "Copy {value}",
104
+ aiGenerated: "AI-generated",
105
+ bottomNav: "Main navigation"
101
106
  };
102
107
  const es = {
103
108
  close: "Cerrar",
@@ -196,7 +201,12 @@ const es = {
196
201
  toneWarning: "Alerta",
197
202
  toneDanger: "Error",
198
203
  toneInfo: "Informaci\xF3n",
199
- toneNeutral: "Neutro"
204
+ toneNeutral: "Neutro",
205
+ copy: "Copiar al portapapeles",
206
+ copied: "Copiado",
207
+ copyValue: "Copiar {value}",
208
+ aiGenerated: "Generado con IA",
209
+ bottomNav: "Navegaci\xF3n principal"
200
210
  };
201
211
  const ptBR = {
202
212
  close: "Fechar",
@@ -295,7 +305,12 @@ const ptBR = {
295
305
  toneWarning: "Alerta",
296
306
  toneDanger: "Erro",
297
307
  toneInfo: "Informa\xE7\xE3o",
298
- toneNeutral: "Neutro"
308
+ toneNeutral: "Neutro",
309
+ copy: "Copiar para a \xE1rea de transfer\xEAncia",
310
+ copied: "Copiado",
311
+ copyValue: "Copiar {value}",
312
+ aiGenerated: "Gerado por IA",
313
+ bottomNav: "Navega\xE7\xE3o principal"
299
314
  };
300
315
  const dsCatalogs = { en, es, "pt-BR": ptBR };
301
316
  function resolveDsLocale(tag) {