orbital-ds 0.3.0 → 0.5.0

package/AGENTS.md

@@ -22,6 +22,9 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
    foco incluido).
 6. **Un tema cumple el contrato completo** (`contract.json`) y define en `:root` todo
    `--ds-*` que defina el tema base.
+7. **La marca de una app vive en SU `brand.css`**, no en el tema del paquete. Para
+   personalizar una app (color, radio, fuentes) edita ese fichero; nunca `node_modules` ni
+   los temas. `pnpm exec orbital-ds-init` lo crea sin sobrescribir.
 
 ## Cómo cambiar el aspecto
 

package/README.md

@@ -32,6 +32,12 @@ 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):

package/contract.json

@@ -1,5 +1,5 @@
 {
-  "version": 2,
+  "version": 3,
   "descripcion": "Contrato de tema de orbital-ds: todo tema (themes/*.css) debe definir estos tokens en :root. Nombres en inglés estándar; los de shadcn sin prefijo; los propios con --ds-. baseTheme es el tema aplicado siempre (los demás se aplican encima, con ámbito).",
   "root": [
     "radius",
@@ -78,5 +78,85 @@
       "link"
     ]
   },
-  "baseTheme": "qratia"
+  "baseTheme": "qratia",
+  "brand": {
+    "descripcion": "Grupo ESTABLE de variables que una app suele personalizar en su fichero de marca (brand.css). Renombrar o quitar una es versión MAYOR. Todas están también en `root` salvo las --ds-*.",
+    "tokens": [
+      {
+        "name": "primary",
+        "example": "oklch(0.55 0.2 260)",
+        "about": "color de acción principal (botones, foco)"
+      },
+      {
+        "name": "primary-foreground",
+        "example": "#ffffff",
+        "about": "texto sobre el color principal (comprueba el contraste)"
+      },
+      {
+        "name": "ring",
+        "example": "oklch(0.55 0.2 260)",
+        "about": "anillo de foco; suele ir igual que primary"
+      },
+      {
+        "name": "link",
+        "example": "oklch(0.5 0.15 260)",
+        "about": "texto de enlace: más oscuro que primary para tener contraste"
+      },
+      {
+        "name": "link-hover",
+        "example": "oklch(0.42 0.13 260)",
+        "about": "enlace al pasar el ratón"
+      },
+      {
+        "name": "brand",
+        "example": "oklch(0.7 0.13 220)",
+        "about": "acento de marca (detalles, selección)"
+      },
+      {
+        "name": "brand-bright",
+        "example": "oklch(0.8 0.13 220)",
+        "about": "acento de marca sobre fondos oscuros"
+      },
+      {
+        "name": "sidebar-primary",
+        "example": "oklch(0.8 0.13 220)",
+        "about": "acento dentro del sidebar"
+      },
+      {
+        "name": "sidebar-primary-foreground",
+        "example": "#04121c",
+        "about": "texto sobre el acento del sidebar"
+      },
+      {
+        "name": "sidebar-accent-foreground",
+        "example": "oklch(0.85 0.1 220)",
+        "about": "texto del destino activo del sidebar"
+      },
+      {
+        "name": "accent-foreground",
+        "example": "oklch(0.5 0.15 260)",
+        "about": "texto sobre superficies de acento suave"
+      },
+      {
+        "name": "chart-1",
+        "example": "oklch(0.55 0.2 260)",
+        "about": "primera serie de las gráficas: la marca"
+      },
+      {
+        "name": "radius",
+        "example": "12px",
+        "about": "redondez base (en temas cuya rampa deriva de ella)"
+      },
+      {
+        "name": "ds-font-sans",
+        "example": "'Inter', system-ui, sans-serif",
+        "about": "fuente del cuerpo (carga la fuente en tu app)"
+      },
+      {
+        "name": "ds-font-display",
+        "example": "'Sora', system-ui, sans-serif",
+        "about": "fuente de los titulares"
+      }
+    ]
+  }
 }

package/dist/themes/friendly.css

@@ -0,0 +1,310 @@
+/*
+ * TEMA friendly — «SaaS amable con personalidad».
+ *
+ * Referencia: la interfaz de SerpWatch (v2). Se conserva lo que le da carácter y se
+ * corrigen sus defectos. Valores LEÍDOS de la referencia: lienzo #F5F6FC, tinta índigo
+ * #232450, fuente Rubik, sombras teñidas de índigo, botón en píldora en mayúsculas con
+ * brillo de color debajo, naranja #FBB232 como segundo acento, tarjetas de esquina
+ * pequeña frente a botones del todo redondos.
+ *
+ * Mejoras respecto a la referencia:
+ *   - El botón primario usa un periwinkle algo más oscuro (#5F6EC9) para que el texto
+ *     blanco alcance contraste AA (el original, #7987CE, queda en torno a 3:1); el
+ *     original se conserva como brillo (`--brand-bright`).
+ *   - Texto atenuado y de estado con contraste AA.
+ *
+ * Importar DESPUÉS de la estructura. Variables `--zf-*`: privadas de este tema.
+ * Fuentes: `friendly.fonts.css` (Rubik), lo primero del CSS de la app.
+ */
+
+/* ── VARIABLES · PIEL CLARA ──────────────────────────────────────────────── */
+:root {
+  --radius: 8px;
+
+  --ds-font-sans: 'Rubik', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
+  --ds-font-display: var(--ds-font-sans);
+  --ds-font-mono: ui-monospace, 'SF Mono', Menlo, monospace;
+  --ds-heading-tracking: normal;
+
+  /* Color: lienzo azulado, tinta índigo, acento periwinkle + naranja cálido */
+  --background: #f5f6fc;
+  --foreground: #232450;
+
+  --card: #ffffff;
+  --card-foreground: #232450;
+  --popover: #ffffff;
+  --popover-foreground: #232450;
+
+  --primary: #5f6ec9;
+  --primary-foreground: #ffffff;
+  --secondary: #e8eaf8;
+  --secondary-foreground: #232450;
+  --muted: #eef0fa;
+  --muted-foreground: #6b6d96;
+  --accent: rgba(55, 132, 247, 0.14);
+  --accent-foreground: #2a64c4;
+  --destructive: #e5484d;
+  --destructive-foreground: #ffffff;
+
+  --border: rgba(35, 36, 80, 0.08);
+  --input: rgba(35, 36, 80, 0.18);
+  --ring: #5f6ec9;
+
+  --chart-1: #5f6ec9;
+  --chart-2: #fbb232;
+  --chart-3: #1db87a;
+  --chart-4: #e5484d;
+  --chart-5: #3784f7;
+
+  --sidebar: #ffffff;
+  --sidebar-foreground: #3a3b6b;
+  --sidebar-primary: #5f6ec9;
+  --sidebar-primary-foreground: #ffffff;
+  --sidebar-accent: rgba(55, 132, 247, 0.16);
+  --sidebar-accent-foreground: #2a64c4;
+  --sidebar-border: rgba(35, 36, 80, 0.07);
+  --sidebar-ring: #5f6ec9;
+
+  --danger: #c7343a;
+  --danger-soft: rgba(229, 72, 77, 0.12);
+  --warning: #9a5b00;
+  --warning-soft: rgba(251, 178, 50, 0.24);
+  --success: #0a7d55;
+  --success-soft: rgba(29, 184, 122, 0.14);
+  --info: #2a64c4;
+  --info-soft: rgba(55, 132, 247, 0.14);
+  --neutral: #6b6d96;
+  --neutral-soft: rgba(35, 36, 80, 0.07);
+
+  --link: #2a64c4;
+  --link-hover: #1f4f9e;
+  --inset: #eef0fa;
+  --inset-foreground: #232450;
+  --brand: #5f6ec9;
+  --brand-bright: #7987ce;
+
+  /* Formas: superficies de esquina pequeña; las acciones, del todo redondas */
+  --ds-radius-sm: 4px;
+  --ds-radius-md: 6px;
+  --ds-radius-lg: 8px;
+  --ds-radius-xl: 10px;
+  --ds-radius-2xl: 14px;
+  --ds-radius-control: 10px;
+  --ds-radius-overlay: 14px;
+
+  /* Sombras suaves TEÑIDAS de índigo (nunca negras) */
+  --ds-shadow-card: 0 8px 20px rgba(0, 4, 131, 0.04);
+  --ds-shadow-card-hover: 0 10px 26px rgba(0, 4, 131, 0.09);
+  --ds-shadow-control: 0 0 #0000;
+  --ds-shadow-raised: 0 8px 20px rgba(0, 4, 131, 0.06);
+  --ds-shadow-overlay: 0 16px 40px rgba(35, 36, 80, 0.16);
+  --ds-shadow-popover: 0 16px 40px rgba(35, 36, 80, 0.16);
+
+  /* Medidas: controles de 38px, botones generosos */
+  --ds-control-h-sm: 2rem;
+  --ds-control-h-md: 2.375rem;
+  --ds-control-h-lg: 2.75rem;
+  --ds-button-px-sm: 1rem;
+  --ds-button-px-md: 1.5rem;
+  --ds-button-px-lg: 2rem;
+  --ds-field-px: 0.875rem;
+  --ds-card-spacing: 1.25rem;
+  --ds-card-spacing-sm: 1rem;
+
+  /* Sin cristal: material plano y luminoso */
+  --ds-card-backdrop: none;
+  --ds-overlay-backdrop: none;
+  --ds-field-backdrop: none;
+  --ds-sidebar-backdrop: none;
+  --ds-page-backdrop: none;
+
+  /* Sidebar a ras de borde, blanco sobre el lienzo, filas con tinte azul */
+  --ds-sidebar-pad: 0px;
+  --ds-sidebar-radius: 0px;
+  --ds-sidebar-shadow: 0 0 #0000;
+  --ds-sidebar-ring: 0px;
+  --ds-sidebar-edge: 1px solid var(--sidebar-border);
+  --ds-sidebar-item-radius: 6px;
+  --ds-sidebar-item-h: 2.75rem;
+
+  /* Privadas de friendly */
+  --zf-orange: #fbb232;
+  --zf-orange-ink: #232450;
+  --zf-glow: rgba(95, 110, 201, 0.42);
+  --zf-glow-hover: rgba(95, 110, 201, 0.55);
+  --zf-fill: rgba(35, 36, 80, 0.05);
+  --zf-fill-hover: rgba(35, 36, 80, 0.08);
+}
+
+/* ── VARIABLES · PIEL OSCURA («noche índigo») ────────────────────────────── */
+.dark {
+  --background: #16173b;
+  --foreground: #ecedfa;
+
+  --card: #1f2150;
+  --card-foreground: #ecedfa;
+  --popover: #25275c;
+  --popover-foreground: #ecedfa;
+
+  --primary: #8a98f0;
+  --primary-foreground: #14153a;
+  --secondary: #2a2c63;
+  --secondary-foreground: #ecedfa;
+  --muted: #232557;
+  --muted-foreground: #a3a6d4;
+  --accent: rgba(86, 156, 255, 0.18);
+  --accent-foreground: #8dbbff;
+  --destructive: #ef5d62;
+  --destructive-foreground: #14153a;
+
+  --border: rgba(255, 255, 255, 0.09);
+  --input: rgba(255, 255, 255, 0.2);
+  --ring: #8a98f0;
+
+  --chart-1: #8a98f0;
+  --chart-2: #fbb232;
+  --chart-3: #3fd397;
+  --chart-4: #ef5d62;
+  --chart-5: #569cff;
+
+  --sidebar: #1b1d47;
+  --sidebar-foreground: #c4c6ec;
+  --sidebar-primary: #8a98f0;
+  --sidebar-primary-foreground: #14153a;
+  --sidebar-accent: rgba(86, 156, 255, 0.2);
+  --sidebar-accent-foreground: #8dbbff;
+  --sidebar-border: rgba(255, 255, 255, 0.07);
+  --sidebar-ring: #8a98f0;
+
+  --danger: #ff7a7f;
+  --danger-soft: rgba(239, 93, 98, 0.2);
+  --warning: #fbb232;
+  --warning-soft: rgba(251, 178, 50, 0.18);
+  --success: #3fd397;
+  --success-soft: rgba(63, 211, 151, 0.16);
+  --info: #8dbbff;
+  --info-soft: rgba(86, 156, 255, 0.2);
+  --neutral: #a3a6d4;
+  --neutral-soft: rgba(255, 255, 255, 0.08);
+
+  --link: #8dbbff;
+  --link-hover: #b4d1ff;
+  --inset: #232557;
+  --inset-foreground: #ecedfa;
+  --brand: #8a98f0;
+  --brand-bright: #aab4f6;
+
+  --ds-shadow-card: 0 8px 20px rgba(0, 0, 20, 0.28);
+  --ds-shadow-card-hover: 0 10px 26px rgba(0, 0, 20, 0.4);
+  --ds-shadow-raised: 0 8px 20px rgba(0, 0, 20, 0.3);
+  --ds-shadow-overlay: 0 16px 40px rgba(0, 0, 20, 0.5);
+  --ds-shadow-popover: 0 16px 40px rgba(0, 0, 20, 0.5);
+
+  --zf-orange-ink: #232450;
+  --zf-glow: rgba(138, 152, 240, 0.4);
+  --zf-glow-hover: rgba(138, 152, 240, 0.55);
+  --zf-fill: rgba(255, 255, 255, 0.07);
+  --zf-fill-hover: rgba(255, 255, 255, 0.11);
+}
+
+/* ── PERSONALIDAD ────────────────────────────────────────────────────────────
+ * Sin capa: gana a las utilidades de los componentes. Solo variables.
+ */
+:root {
+  /* Botones: píldora en mayúsculas con espaciado, y brillo de color debajo */
+  [data-slot='button'] {
+    border-radius: 9999px;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    font-weight: 500;
+    transition:
+      transform var(--ds-motion-base) ease,
+      box-shadow var(--ds-motion-base) ease,
+      background-color var(--ds-motion-base) ease;
+  }
+  [data-slot='button'][data-variant='link'] {
+    text-transform: none;
+    letter-spacing: normal;
+  }
+  [data-slot='button'][data-size^='icon'] {
+    border-radius: var(--ds-radius-xl);
+  }
+  [data-slot='button'][data-variant='default'] {
+    box-shadow: 0 8px 8px -3px var(--zf-glow);
+  }
+  [data-slot='button'][data-variant='default']:hover:not(:disabled) {
+    transform: translateY(-1px);
+    box-shadow: 0 10px 12px -3px var(--zf-glow-hover);
+  }
+  [data-slot='button'][data-variant='default']:active:not(:disabled) {
+    transform: translateY(0);
+  }
+  [data-slot='button'][data-variant='secondary'] {
+    background: var(--zf-fill);
+    color: var(--foreground);
+  }
+  [data-slot='button'][data-variant='secondary']:hover:not(:disabled),
+  [data-slot='button'][data-variant='ghost']:hover:not(:disabled) {
+    background: var(--zf-fill-hover);
+  }
+  [data-slot='button'][data-variant='outline'] {
+    background: transparent;
+    border: 1.5px solid color-mix(in oklch, var(--primary) 55%, transparent);
+    color: var(--primary);
+  }
+  [data-slot='button'][data-variant='outline']:hover:not(:disabled) {
+    background: color-mix(in oklch, var(--primary) 10%, transparent);
+  }
+
+  /* Tarjetas: blancas, sin borde, solo la sombra teñida */
+  [data-slot='card'] {
+    border-color: transparent;
+  }
+
+  /* Campos rellenos (sin borde), como el buscador de la referencia */
+  [data-slot='input'],
+  [data-slot='textarea'],
+  [data-slot='select-trigger'] {
+    background: var(--zf-fill);
+    border-color: transparent;
+  }
+
+  /* Etiquetas en píldora; la secundaria es el naranja de la marca */
+  [data-slot='badge'] {
+    border-radius: 9999px;
+  }
+  [data-slot='badge'][data-variant='secondary'] {
+    background: var(--zf-orange);
+    color: var(--zf-orange-ink);
+  }
+
+  /* Tablas: cabeceras en mayúsculas pequeñas */
+  [data-slot='table-head'] {
+    text-transform: uppercase;
+    font-size: 0.75rem;
+    letter-spacing: 0.05em;
+    font-weight: 600;
+    color: var(--foreground);
+  }
+
+  /* Sidebar: la fila activa con tinte azul y peso medio */
+  [data-sidebar='menu-button'][data-active='true'] {
+    font-weight: 500;
+  }
+  [data-sidebar='menu-button']:hover:not([data-active='true']) {
+    background: var(--zf-fill);
+  }
+
+  /* Pestañas: píldora tintada */
+  [data-slot='tabs-list'] {
+    background: var(--zf-fill);
+    border-radius: 9999px;
+  }
+  [data-slot='tabs-trigger'] {
+    border-radius: 9999px;
+  }
+  [data-slot='tabs-trigger'][data-active] {
+    background: var(--card);
+    box-shadow: var(--ds-shadow-raised);
+  }
+}

package/dist/themes/friendly.fonts.css

@@ -0,0 +1,2 @@
+/* Fuentes del tema friendly: Rubik. Importar la PRIMERA del CSS de la app. */
+@import url('https://fonts.googleapis.com/css2?family=Rubik:wght@400;500;600;700&display=swap');