orbital-ds 0.18.0 → 0.18.2
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/README.md +97 -97
- package/components.manifest.json +1 -1
- package/dist/motion.css +1 -1
- package/dist/styles.css +1148 -1143
- package/dist/themes/lagoon.fonts.css +2 -2
- package/dist/themes/lagoon.guide.md +1 -0
- package/dist/ui/avatar.js +1 -1
- package/dist/ui/chart.js +1 -1
- package/dist/ui/command.js +3 -3
- package/dist/ui/gauge.js +6 -6
- package/dist/ui/level-meter.js +2 -2
- package/dist/ui/select.js +1 -1
- package/dist/ui/shield.js +1 -1
- package/dist/ui/sidebar.js +1 -1
- package/dist/ui/stat.js +4 -4
- package/package.json +186 -186
- package/scripts/cli.mjs +452 -452
package/README.md
CHANGED
|
@@ -1,97 +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), `lagoon` (pino y jade con dock oscuro), `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
|
+
# 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), `lagoon` (pino y jade con dock oscuro), `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
|
package/components.manifest.json
CHANGED
package/dist/motion.css
CHANGED
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
:where([data-slot='alert'], [data-slot='banner'], [data-slot='empty']) {
|
|
31
31
|
animation: var(--ds-enter-notices) var(--ds-motion-base) var(--ds-ease-enter) both;
|
|
32
32
|
}
|
|
33
|
-
:where([data-slot='page-header'], [data-slot='section-header']) {
|
|
33
|
+
:where([data-slot='page-header'], [data-slot='section-header'], [data-slot='app-header']) {
|
|
34
34
|
animation: var(--ds-enter-headers) var(--ds-motion-base) var(--ds-ease-enter) both;
|
|
35
35
|
}
|
|
36
36
|
:where([data-slot='timeline-item'], [data-slot='table-body'] > [data-slot='table-row']) {
|