orbital-ds 0.5.0 → 0.6.2

package/README.md

@@ -1,64 +1,73 @@
-# orbital-ds
-
-Sistema de diseño genérico: **estructura común + temas intercambiables + ~60 componentes**
-sobre [Base UI](https://base-ui.com) y Tailwind v4 (los de shadcn en su versión Base UI).
-
-- `styles.css` — la ESTRUCTURA: mapea variables de tema a utilidades de Tailwind y define los
-  tokens semánticos (radios, alturas, sombras, espaciado, capas, movimiento, foco, materiales)
-  y la capa base. No lleva colores ni fuentes.
-- `themes/<tema>.css` — un TEMA: paleta (claro/oscuro), radio base y tipografía.
-  Hoy: `qratia` y `zyro` (cristal). Añadir otro = añadir otro fichero.
-- `themes/<tema>.fonts.css` — las fuentes del tema (un `@import url()`; va el primero).
-- `ui/*` — componentes, uno por fichero (`orbital-ds/ui/button`, …): quien no usa gráficos
-  no necesita `recharts`, quien no usa el calendario no necesita `react-day-picker`.
-- `contract.json` + `pnpm check:ds` — el contrato de tema y su comprobación.
-
-## Uso en una app (Tailwind v4)
-
-```css
-@import 'orbital-ds/themes/qratia.fonts.css'; /* fuentes: lo primero */
-@import 'tailwindcss';
-@plugin '@tailwindcss/typography';
-@import 'tw-animate-css';
-@import 'orbital-ds/styles.css';              /* estructura */
-@import 'orbital-ds/themes/qratia.css';       /* tema (después de la estructura) */
-@source '../node_modules/orbital-ds/dist';    /* que Tailwind vea las clases del paquete */
-```
-
-```tsx
-import { Button } from 'orbital-ds/ui/button';
-```
-
-Cambiar de identidad = cambiar `qratia` por `zyro` en esas dos líneas de tema/fuentes.
-Detalle del contrato, tokens y reglas de nombres en [`docs/CONTRACT.md`](docs/CONTRACT.md).
-
-## Marca de una app
-
-Lo propio de cada app (color principal, acento, radio, fuentes) va en **su** `src/brand.css`,
-importado después del tema. Ninguna actualización de orbital-ds lo toca. `pnpm exec orbital-ds-init`
-lo crea la primera vez. Detalle en [`docs/CONTRACT.md`](docs/CONTRACT.md).
-
-## Regla
-
-Ningún componente lleva valores propios (colores, medidas, sombras, z-index, duraciones):
-pide un hueco a una variable. Para cambiar el aspecto se cambia el tema, no el componente.
-Si un componente necesita un hueco nuevo, se AÑADE el token con un valor que deje el aspecto
-como estaba. `pnpm check:ds` lo comprueba.
-
-## Desarrollo
-
-```bash
-pnpm install
-pnpm verify    # doctor + typecheck + build
-pnpm check:ds    # solo el contrato de tema y los valores fijos
-```
-
-Peers obligatorios: `react`, `react-dom`, `@base-ui/react`, `tailwindcss`, `tailwind-merge`,
-`class-variance-authority`, `clsx`, `lucide-react`, `tw-animate-css`.
-Opcionales (solo si usas ese componente): `recharts`, `sonner`, `next-themes`, `cmdk`,
-`date-fns` + `react-day-picker`, `embla-carousel-react`, `input-otp`,
-`react-resizable-panels`, `@shadcn/react`.
-
-## Licencia
-
-MIT © Fractalia Systems
+# orbital-ds
+
+Sistema de diseño genérico: **estructura común + temas intercambiables + ~60 componentes**
+sobre [Base UI](https://base-ui.com) y Tailwind v4 (los de shadcn en su versión Base UI).
+
+- `styles.css` — la ESTRUCTURA: mapea variables de tema a utilidades de Tailwind y define los
+  tokens semánticos (radios, alturas, sombras, espaciado, capas, movimiento, foco, materiales)
+  y la capa base. No lleva colores ni fuentes.
+- `themes/<tema>.css` — un TEMA: paleta (claro/oscuro), radio base y tipografía.
+  Hoy: `qratia` y `zyro` (cristal). Añadir otro = añadir otro fichero.
+- `themes/<tema>.fonts.css` — las fuentes del tema (un `@import url()`; va el primero).
+- `ui/*` — componentes, uno por fichero (`orbital-ds/ui/button`, …): quien no usa gráficos
+  no necesita `recharts`, quien no usa el calendario no necesita `react-day-picker`.
+- `contract.json` + `pnpm check:ds` — el contrato de tema y su comprobación.
+
+## Uso en una app (Tailwind v4)
+
+```css
+@import 'orbital-ds/themes/qratia.fonts.css'; /* fuentes: lo primero */
+@import 'tailwindcss';
+@plugin '@tailwindcss/typography';
+@import 'tw-animate-css';
+@import 'orbital-ds/styles.css';              /* estructura */
+@import 'orbital-ds/themes/qratia.css';       /* tema (después de la estructura) */
+@source '../node_modules/orbital-ds/dist';    /* que Tailwind vea las clases del paquete */
+```
+
+```tsx
+import { Button } from 'orbital-ds/ui/button';
+```
+
+Cambiar de identidad = cambiar `qratia` por `zyro` en esas dos líneas de tema/fuentes.
+Detalle del contrato, tokens y reglas de nombres en [`docs/CONTRACT.md`](docs/CONTRACT.md).
+
+## Guía de cada tema
+
+Cada tema lleva su documentación, que viaja con el paquete:
+
+- `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).
+- `orbital-ds/themes/<tema>.meta.json` — la misma ficha legible por máquina.
+
+`pnpm check:ds` falla si a un tema le falta alguna de las dos. Un tema nuevo debe nacer con ambas.
+
+## Marca de una app
+
+Lo propio de cada app (color principal, acento, radio, fuentes) va en **su** `src/brand.css`,
+importado después del tema. Ninguna actualización de orbital-ds lo toca. `pnpm exec orbital-ds-init`
+lo crea la primera vez. Detalle en [`docs/CONTRACT.md`](docs/CONTRACT.md).
+
+## Regla
+
+Ningún componente lleva valores propios (colores, medidas, sombras, z-index, duraciones):
+pide un hueco a una variable. Para cambiar el aspecto se cambia el tema, no el componente.
+Si un componente necesita un hueco nuevo, se AÑADE el token con un valor que deje el aspecto
+como estaba. `pnpm check:ds` lo comprueba.
+
+## Desarrollo
+
+```bash
+pnpm install
+pnpm verify    # doctor + typecheck + build
+pnpm check:ds    # solo el contrato de tema y los valores fijos
+```
+
+Peers obligatorios: `react`, `react-dom`, `@base-ui/react`, `tailwindcss`, `tailwind-merge`,
+`class-variance-authority`, `clsx`, `lucide-react`, `tw-animate-css`.
+Opcionales (solo si usas ese componente): `recharts`, `sonner`, `next-themes`, `cmdk`,
+`date-fns` + `react-day-picker`, `embla-carousel-react`, `input-otp`,
+`react-resizable-panels`, `@shadcn/react`.
+
+## Licencia
+
+MIT © Fractalia Systems

package/components.manifest.json

@@ -1,6 +1,6 @@
 {
   "package": "orbital-ds",
-  "version": "0.3.0",
+  "version": "0.6.1",
   "engine": "@base-ui/react",
   "docs": [
     "README.md",
@@ -582,6 +582,17 @@
       ],
       "optionalPeers": []
     },
+    "icon-tile": {
+      "import": "orbital-ds/ui/icon-tile",
+      "exports": [
+        "IconTile",
+        "iconTileVariants"
+      ],
+      "slots": [
+        "icon-tile"
+      ],
+      "optionalPeers": []
+    },
     "input-group": {
       "import": "orbital-ds/ui/input-group",
       "exports": [

package/dist/styles.css

@@ -134,6 +134,7 @@
    */
   --ds-z-raised: 10;
   --ds-z-sticky: 20;
+  --ds-z-sidebar: 21; /* por encima de la cabecera sticky: su filete no debe quedar tapado */
   --ds-z-overlay: 50;
 
   --ds-motion-fast: 100ms;
@@ -192,9 +193,21 @@
   --ds-sidebar-shadow: var(--ds-shadow-raised);
   --ds-sidebar-ring: 1px;
   --ds-sidebar-edge: 0 solid transparent;
+  --ds-sidebar-rail-w: 4rem; /* ancho del lateral contraído (raíl de iconos) */
   --ds-sidebar-item-radius: var(--ds-radius-md);
   --ds-sidebar-item-h: 2.5rem;
 
+  /* ── BALDOSA DE ICONO ───────────────────────────────────────────────────
+   * Un icono grande (Lucide) dentro de una baldosa tintada: la «mascota» barata.
+   * sm / md / lg: lado de la baldosa; radius: su esquina; fill: cuánto relleno
+   * lleva el icono (0 = solo trazo; 0.2 = aspecto duotono suave).
+   */
+  --ds-icon-tile-sm: 2rem;
+  --ds-icon-tile-md: 2.75rem;
+  --ds-icon-tile-lg: 3.75rem;
+  --ds-icon-tile-radius: var(--ds-radius-lg);
+  --ds-icon-tile-fill: 0;
+
   /* ── COLOR (mapeo de las variables del tema a utilidades) ─────────────── */
   --color-background: var(--background);
   --color-foreground: var(--foreground);
@@ -484,3 +497,10 @@
     }
   }
 }
+
+/* Baldosa de icono: el relleno del icono lo decide el tema (--ds-icon-tile-fill). */
+@layer base {
+  [data-slot='icon-tile'] svg {
+    fill: color-mix(in oklch, currentColor calc(var(--ds-icon-tile-fill) * 100%), transparent);
+  }
+}