orbital-ds 0.28.0 → 0.30.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 (137) hide show
  1. package/AGENTS.md +303 -273
  2. package/components.manifest.json +526 -12
  3. package/dist/hooks/use-ds-messages.d.ts +205 -0
  4. package/dist/lib/auth-better-auth.d.ts +29 -0
  5. package/dist/lib/auth-better-auth.js +60 -0
  6. package/dist/lib/auth-flow.d.ts +83 -0
  7. package/dist/lib/auth-flow.js +152 -0
  8. package/dist/lib/auth-providers.d.ts +194 -0
  9. package/dist/lib/auth-providers.js +64 -0
  10. package/dist/lib/auth.d.ts +68 -0
  11. package/dist/lib/auth.js +110 -0
  12. package/dist/lib/header-control.d.ts +4 -0
  13. package/dist/lib/header-control.js +14 -0
  14. package/dist/lib/i18n.d.ts +205 -0
  15. package/dist/lib/i18n.js +624 -3
  16. package/dist/ui/app-bar.d.ts +10 -0
  17. package/dist/ui/app-bar.js +51 -0
  18. package/dist/ui/attachment.js +1 -1
  19. package/dist/ui/auth-backdrop.d.ts +20 -0
  20. package/dist/ui/auth-backdrop.js +137 -0
  21. package/dist/ui/auth-form.d.ts +111 -0
  22. package/dist/ui/auth-form.js +531 -0
  23. package/dist/ui/auth-layout.d.ts +70 -0
  24. package/dist/ui/auth-layout.js +283 -0
  25. package/dist/ui/auth-parts.d.ts +43 -0
  26. package/dist/ui/auth-parts.js +159 -0
  27. package/dist/ui/auth-status.d.ts +23 -0
  28. package/dist/ui/auth-status.js +99 -0
  29. package/dist/ui/badge.js +2 -2
  30. package/dist/ui/button.js +1 -1
  31. package/dist/ui/connected-accounts.d.ts +25 -0
  32. package/dist/ui/connected-accounts.js +89 -0
  33. package/dist/ui/content-card.d.ts +6 -2
  34. package/dist/ui/content-card.js +27 -3
  35. package/dist/ui/dropzone.js +1 -1
  36. package/dist/ui/empty-state.d.ts +10 -1
  37. package/dist/ui/empty-state.js +28 -7
  38. package/dist/ui/error-page.d.ts +10 -1
  39. package/dist/ui/error-page.js +74 -28
  40. package/dist/ui/icon-tile.d.ts +1 -1
  41. package/dist/ui/input-otp.js +2 -1
  42. package/dist/ui/item.js +1 -1
  43. package/dist/ui/legend.js +1 -1
  44. package/dist/ui/locale-switcher.d.ts +19 -0
  45. package/dist/ui/locale-switcher.js +54 -0
  46. package/dist/ui/menubar.js +1 -1
  47. package/dist/ui/message-scroller.js +1 -1
  48. package/dist/ui/mfa-challenge.d.ts +33 -0
  49. package/dist/ui/mfa-challenge.js +214 -0
  50. package/dist/ui/mfa-setup.d.ts +29 -0
  51. package/dist/ui/mfa-setup.js +196 -0
  52. package/dist/ui/navigation-menu.js +2 -2
  53. package/dist/ui/notice-review.d.ts +1 -0
  54. package/dist/ui/notifications.d.ts +12 -2
  55. package/dist/ui/notifications.js +28 -5
  56. package/dist/ui/oauth-consent.d.ts +54 -0
  57. package/dist/ui/oauth-consent.js +208 -0
  58. package/dist/ui/passkey-list.d.ts +17 -0
  59. package/dist/ui/passkey-list.js +112 -0
  60. package/dist/ui/password-input.d.ts +5 -0
  61. package/dist/ui/password-input.js +77 -0
  62. package/dist/ui/session-list.d.ts +19 -0
  63. package/dist/ui/session-list.js +70 -0
  64. package/dist/ui/session-timeout.d.ts +13 -0
  65. package/dist/ui/session-timeout.js +87 -0
  66. package/dist/ui/sidebar.d.ts +27 -5
  67. package/dist/ui/sidebar.js +56 -11
  68. package/dist/ui/sign-out-dialog.d.ts +17 -0
  69. package/dist/ui/sign-out-dialog.js +82 -0
  70. package/dist/ui/stat-group.d.ts +1 -1
  71. package/dist/ui/stat-group.js +6 -2
  72. package/dist/ui/stat.d.ts +24 -5
  73. package/dist/ui/stat.js +124 -19
  74. package/dist/ui/status-badge.d.ts +1 -1
  75. package/dist/ui/theme-toggle.d.ts +14 -0
  76. package/dist/ui/theme-toggle.js +112 -0
  77. package/dist/ui/toggle.js +2 -2
  78. package/dist/ui/week-strip.js +1 -1
  79. package/docs/CONTRACT.md +1 -1
  80. package/docs/designer/patrones.md +27 -0
  81. package/docs/designer/revision.md +8 -0
  82. package/package.json +3 -2
  83. package/scripts/brand-core.d.mts +2 -0
  84. package/scripts/brand-core.mjs +21 -1
  85. package/scripts/cli.mjs +452 -452
  86. package/scripts/doctor.mjs +3 -0
  87. package/scripts/init.mjs +7 -3
  88. package/dist/motion.css +0 -146
  89. package/dist/styles.css +0 -1240
  90. package/dist/themes/fractalia.css +0 -549
  91. package/dist/themes/fractalia.fonts.css +0 -3
  92. package/dist/themes/fractalia.guide.md +0 -86
  93. package/dist/themes/fractalia.meta.json +0 -112
  94. package/dist/themes/fractalia.scoped.css +0 -549
  95. package/dist/themes/fractalia.tokens.json +0 -39
  96. package/dist/themes/friendly.css +0 -367
  97. package/dist/themes/friendly.fonts.css +0 -2
  98. package/dist/themes/friendly.guide.md +0 -38
  99. package/dist/themes/friendly.meta.json +0 -82
  100. package/dist/themes/friendly.scoped.css +0 -367
  101. package/dist/themes/friendly.tokens.json +0 -45
  102. package/dist/themes/lagoon.css +0 -348
  103. package/dist/themes/lagoon.fonts.css +0 -2
  104. package/dist/themes/lagoon.guide.md +0 -47
  105. package/dist/themes/lagoon.meta.json +0 -84
  106. package/dist/themes/lagoon.scoped.css +0 -348
  107. package/dist/themes/lagoon.tokens.json +0 -49
  108. package/dist/themes/liquid.css +0 -502
  109. package/dist/themes/liquid.fonts.css +0 -7
  110. package/dist/themes/liquid.guide.md +0 -82
  111. package/dist/themes/liquid.meta.json +0 -134
  112. package/dist/themes/liquid.scoped.css +0 -502
  113. package/dist/themes/liquid.tokens.json +0 -47
  114. package/dist/themes/qratia.css +0 -260
  115. package/dist/themes/qratia.fonts.css +0 -2
  116. package/dist/themes/qratia.guide.md +0 -34
  117. package/dist/themes/qratia.meta.json +0 -49
  118. package/dist/themes/qratia.scoped.css +0 -260
  119. package/dist/themes/qratia.tokens.json +0 -49
  120. package/dist/themes/tactile.css +0 -588
  121. package/dist/themes/tactile.fonts.css +0 -3
  122. package/dist/themes/tactile.guide.md +0 -82
  123. package/dist/themes/tactile.meta.json +0 -182
  124. package/dist/themes/tactile.scoped.css +0 -588
  125. package/dist/themes/tactile.tokens.json +0 -42
  126. package/dist/themes/twitter.css +0 -357
  127. package/dist/themes/twitter.fonts.css +0 -6
  128. package/dist/themes/twitter.guide.md +0 -35
  129. package/dist/themes/twitter.meta.json +0 -90
  130. package/dist/themes/twitter.scoped.css +0 -357
  131. package/dist/themes/twitter.tokens.json +0 -45
  132. package/dist/themes/zyro.css +0 -434
  133. package/dist/themes/zyro.fonts.css +0 -2
  134. package/dist/themes/zyro.guide.md +0 -33
  135. package/dist/themes/zyro.meta.json +0 -74
  136. package/dist/themes/zyro.scoped.css +0 -434
  137. package/dist/themes/zyro.tokens.json +0 -46
@@ -0,0 +1,14 @@
1
+ import * as React from 'react';
2
+ import { HeaderControlTone } from '../lib/header-control.js';
3
+
4
+ type ThemeMode = "light" | "dark" | "system";
5
+ type ThemeTogglePreset = "icon" | "cycle" | "segmented";
6
+ declare function ThemeToggle({ value, onValueChange, preset, tone, className, }: {
7
+ value?: ThemeMode;
8
+ onValueChange?: (value: ThemeMode) => void;
9
+ preset?: ThemeTogglePreset;
10
+ tone?: HeaderControlTone;
11
+ className?: string;
12
+ }): React.JSX.Element;
13
+
14
+ export { type ThemeMode, ThemeToggle, type ThemeTogglePreset };
@@ -0,0 +1,112 @@
1
+ import { jsx, jsxs } from "react/jsx-runtime";
2
+ import { MonitorIcon, MoonIcon, SunIcon } from "lucide-react";
3
+ import { useDsMessages } from "../hooks/use-ds-messages.js";
4
+ import { headerControlClass } from "../lib/header-control.js";
5
+ import { cn } from "../lib/utils.js";
6
+ import { Button } from "./button.js";
7
+ import {
8
+ DropdownMenu,
9
+ DropdownMenuContent,
10
+ DropdownMenuRadioGroup,
11
+ DropdownMenuRadioItem,
12
+ DropdownMenuTrigger
13
+ } from "./dropdown-menu.js";
14
+ const MODES = ["light", "dark", "system"];
15
+ const ICONS = { light: SunIcon, dark: MoonIcon, system: MonitorIcon };
16
+ function useModeLabels() {
17
+ const t = useDsMessages();
18
+ return { light: t.themeLight, dark: t.themeDark, system: t.themeSystem };
19
+ }
20
+ function ThemeToggle({
21
+ value = "system",
22
+ onValueChange,
23
+ preset = "icon",
24
+ tone = "neutral",
25
+ className
26
+ }) {
27
+ const t = useDsMessages();
28
+ const labels = useModeLabels();
29
+ const Icon = ICONS[value];
30
+ if (preset === "segmented") {
31
+ return /* @__PURE__ */ jsx(
32
+ "div",
33
+ {
34
+ role: "radiogroup",
35
+ "aria-label": t.themeToggleLabel,
36
+ "data-slot": "theme-toggle",
37
+ "data-preset": preset,
38
+ "data-value": value,
39
+ className: cn("inline-flex items-center gap-(--ds-appbar-gap) rounded-button bg-muted p-1", className),
40
+ children: MODES.map((mode) => {
41
+ const ModeIcon = ICONS[mode];
42
+ return /* @__PURE__ */ jsxs(
43
+ Button,
44
+ {
45
+ type: "button",
46
+ role: "radio",
47
+ "aria-checked": value === mode,
48
+ variant: value === mode ? "secondary" : "ghost",
49
+ size: "sm",
50
+ onClick: () => onValueChange?.(mode),
51
+ children: [
52
+ /* @__PURE__ */ jsx(ModeIcon, {}),
53
+ labels[mode]
54
+ ]
55
+ },
56
+ mode
57
+ );
58
+ })
59
+ }
60
+ );
61
+ }
62
+ if (preset === "cycle") {
63
+ const next = MODES[(MODES.indexOf(value) + 1) % MODES.length];
64
+ return /* @__PURE__ */ jsx(
65
+ Button,
66
+ {
67
+ type: "button",
68
+ variant: "ghost",
69
+ size: "icon-sm",
70
+ "data-slot": "theme-toggle",
71
+ "data-preset": preset,
72
+ "data-value": value,
73
+ "aria-label": `${t.themeToggleLabel}: ${labels[value]}`,
74
+ title: labels[next],
75
+ className: cn(headerControlClass(tone), className),
76
+ onClick: () => onValueChange?.(next),
77
+ children: /* @__PURE__ */ jsx(Icon, {})
78
+ }
79
+ );
80
+ }
81
+ return /* @__PURE__ */ jsxs(DropdownMenu, { children: [
82
+ /* @__PURE__ */ jsx(
83
+ DropdownMenuTrigger,
84
+ {
85
+ render: /* @__PURE__ */ jsx(
86
+ Button,
87
+ {
88
+ type: "button",
89
+ variant: "ghost",
90
+ size: "icon-sm",
91
+ "data-slot": "theme-toggle",
92
+ "data-preset": preset,
93
+ "data-value": value,
94
+ "aria-label": `${t.themeToggleLabel}: ${labels[value]}`,
95
+ className: cn(headerControlClass(tone), className)
96
+ }
97
+ ),
98
+ children: /* @__PURE__ */ jsx(Icon, {})
99
+ }
100
+ ),
101
+ /* @__PURE__ */ jsx(DropdownMenuContent, { align: "end", children: /* @__PURE__ */ jsx(DropdownMenuRadioGroup, { value, onValueChange: (v) => onValueChange?.(v), children: MODES.map((mode) => {
102
+ const ModeIcon = ICONS[mode];
103
+ return /* @__PURE__ */ jsxs(DropdownMenuRadioItem, { value: mode, children: [
104
+ /* @__PURE__ */ jsx(ModeIcon, {}),
105
+ labels[mode]
106
+ ] }, mode);
107
+ }) }) })
108
+ ] });
109
+ }
110
+ export {
111
+ ThemeToggle
112
+ };
package/dist/ui/toggle.js CHANGED
@@ -3,12 +3,12 @@ import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
3
3
  import { cva } from "class-variance-authority";
4
4
  import { cn } from "../lib/utils.js";
5
5
  const toggleVariants = cva(
6
- "group/toggle inline-flex items-center justify-center gap-1 rounded-control text-sm font-(--ds-medium-weight) whitespace-nowrap transition-colors duration-(--ds-motion-snap) outline-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-(length:--ds-ring-width) focus-visible:ring-(--ds-ring-color) disabled:pointer-events-none disabled:opacity-(--ds-disabled-opacity) aria-invalid:border-(--ds-invalid-border) aria-invalid:ring-(--ds-invalid-ring) aria-pressed:bg-muted [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
6
+ "group/toggle inline-flex items-center justify-center gap-1 rounded-control text-sm font-(--ds-medium-weight) whitespace-nowrap transition-colors duration-(--ds-motion-snap) outline-none hover:bg-(--ds-hover-bg) hover:text-foreground focus-visible:border-ring focus-visible:ring-(length:--ds-ring-width) focus-visible:ring-(--ds-ring-color) disabled:pointer-events-none disabled:opacity-(--ds-disabled-opacity) aria-invalid:border-(--ds-invalid-border) aria-invalid:ring-(--ds-invalid-ring) aria-pressed:bg-muted [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
7
7
  {
8
8
  variants: {
9
9
  variant: {
10
10
  default: "bg-transparent",
11
- outline: "border border-input bg-transparent hover:bg-muted"
11
+ outline: "border border-input bg-transparent hover:bg-(--ds-hover-bg)"
12
12
  },
13
13
  size: {
14
14
  default: "h-(--ds-control-h-md) min-w-(--ds-control-h-md) px-3 has-data-[icon=inline-end]:pr-2.5 has-data-[icon=inline-start]:pl-2.5",
@@ -62,7 +62,7 @@ function WeekStrip({
62
62
  "aria-pressed": active,
63
63
  "aria-label": full.format(d),
64
64
  onClick: () => choose(d),
65
- className: "relative flex flex-col items-center gap-0.5 rounded-(--ds-week-day-radius) border border-transparent px-1 py-2 text-sm outline-none transition-colors duration-(--ds-motion-fast) ease-(--ds-ease-standard) hover:bg-muted focus-visible:ring-(length:--ds-ring-width) focus-visible:ring-(--ds-ring-color) data-today:border-border data-active:bg-primary data-active:text-primary-foreground motion-reduce:transition-none",
65
+ className: "relative flex flex-col items-center gap-0.5 rounded-(--ds-week-day-radius) border border-transparent px-1 py-2 text-sm outline-none transition-colors duration-(--ds-motion-fast) ease-(--ds-ease-standard) hover:bg-(--ds-hover-bg) focus-visible:ring-(length:--ds-ring-width) focus-visible:ring-(--ds-ring-color) data-today:border-border data-active:bg-primary data-active:text-primary-foreground motion-reduce:transition-none",
66
66
  children: [
67
67
  /* @__PURE__ */ jsx("small", { className: "text-xs opacity-70", children: weekday.format(d) }),
68
68
  /* @__PURE__ */ jsx("b", { className: "font-display tabular-nums", children: d.getDate() }),
package/docs/CONTRACT.md CHANGED
@@ -81,7 +81,7 @@ Los define la estructura con un valor neutro; un tema los sobrescribe si quiere.
81
81
  | Foco | `--ds-ring-width` |
82
82
  | Lateral | `--ds-sidebar-icon`, `--ds-sidebar-icon-stroke` (iconos), `--ds-sidebar-rail-w` (ancho contraído), `--ds-sidebar-rail-item` (tecla del raíl), `--ds-sidebar-logo` (logo y avatar), `--ds-sidebar-sep-inset` (separadores; negativo = de borde a borde). **Todo tema los define** (contrato) |
83
83
  | **Gesto de tecla** | `--ds-key-outline`, `--ds-key-edge` (colores), `--ds-key-border` (contorno), `--ds-key-edge-w` / `-sm` / `-pressed` (arista en reposo, en controles pequeños y al pulsar), `--ds-key-press` / `-sm` (cuánto se hunde), `--ds-key-radius` / `-sm`, `--ds-key-weight`, `--ds-key-disabled-opacity`, `--ds-rule-w` (filete de superficies), `--ds-overlay-edge-w` (arista de diálogos). Valores neutros en la estructura; los usa la personalidad de un tema como `tactile` |
84
- | **Rotulador** | `--ds-marker` (color; `transparent` lo apaga), `--ds-marker-thickness` (grosor de la franja), `--ds-marker-offset` (cuánto sube); gesto **común**: lo dibuja la estructura en los títulos de cualquier tema |
84
+ | **Rotulador** | `--ds-marker` (color; `transparent` lo apaga), `--ds-marker-thickness` (grosor de la franja), `--ds-marker-offset` (cuánto sube); en desuso desde 0.30: la estructura ya no lo dibuja; se conservan por compatibilidad |
85
85
  | **Títulos y etiquetas** | `--ds-display-variation` (ejes de la fuente de titulares, p. ej. `"SOFT" 50, "WONK" 1`), `--ds-heading-weight` (h1–h3), `--ds-title-weight`, `--ds-title-leading` (títulos de componente), `--ds-heading-tracking`, `--ds-label-tracking` (versalitas), `--ds-strong-weight`, `--ds-nav-weight`, `--ds-tabs-gap` |
86
86
  | **Personalidad común** | `--ds-radius-pill`, `--ds-button-case`, `--ds-button-tracking`, `--ds-button-outline-w`, `--ds-shadow-button` / `-hover`, `--ds-hover-lift`, `--ds-hover-opacity`, `--ds-tab-weight` / `-active-weight`, `--ds-tab-indicator-w`, `--ds-label-weight`, `--ds-nav-active-weight`. Huecos que **cualquier** tema usa en su personalidad (píldoras, botones en mayúsculas, brillo, subrayado de pestañas…) |
87
87
  | Velo | `--color-scrim` |
@@ -102,6 +102,33 @@ Formato: **cuándo** · **piezas** · **reglas** · **evita**.
102
102
  - **Piezas:** `Tabs` o navegación lateral por secciones; cada sección un `FieldGroup`; `Switch` para lo que se
103
103
  aplica al momento y botón «Guardar cambios» para lo que no (nunca mezclados en la misma sección).
104
104
 
105
+ ## P13 · Acceso (entrar, verificar, sesiones)
106
+ - **Cuándo:** iniciar sesión, registro, recuperar contraseña, segundo factor, consentimiento OAuth/MCP, y la
107
+ gestión de la seguridad de la cuenta (sesiones, llaves de acceso, cuentas conectadas).
108
+ - **Primero el flujo:** `defineAuthFlow(preset)` (`orbital-ds/lib/auth-flow`) decide audiencia (`internal` ·
109
+ `external`), métodos, registro, segundo factor y aspecto. Presets: `standard` · `social` · `passwordless` ·
110
+ `partner` · `enterprise` · `hybrid` (plantilla por SSO y externos con cuenta propia, enrutados por dominio con
111
+ `routeAuthIdentifier`) · `sso-only`. `validateAuthFlow` avisa de combinaciones sin sentido.
112
+ - **Interno o externo:** en `hybrid` (y `enterprise`) el correo decide la puerta. `internalDomains` → SSO de la
113
+ plantilla (sin registro, sin 2FA propio: lo pone el directorio); el resto, cuenta propia con el 2FA y el registro
114
+ del flujo. `access: { internal, external }` ajusta métodos, `mfaRequired` y `signUp` de cada puerta;
115
+ `resolveAuthAccess(flow, correo)` devuelve la regla; `routeAuthIdentifier` ya la usa. En pantalla,
116
+ `AuthForm audience={flow.audience}` explica antes del correo quién entra por dónde, y tras identificarse
117
+ muestra «Personal» o «Externo» junto al correo.
118
+ - **Piezas:** `AuthLayout` (`centered` · `split` · `cover` · `banner` · `minimal`; fondo con `backdrop`, también
119
+ `image` + `backdropMedia` y `backdropGlass`) + `AuthForm` (`sign-in` · `social` · `sign-up` · `magic-link` ·
120
+ `email-code` · `sso` · `forgot-password` · `reset-password`). Proveedores con `authProviders([...])`
121
+ (`orbital-ds/lib/auth-providers`, ids de Better Auth). Segundo factor: `MfaChallenge` y `MfaSetup`. Resultado:
122
+ `AuthStatus`. Consentimiento: `OAuthConsent` (`authorize` · `mcp` · `device`). Cuenta: `SessionList`,
123
+ `PasskeyList`, `ConnectedAccounts`, `SignOutDialog`, `SessionTimeout`. Con Better Auth, `fromBetterAuth()`
124
+ (`orbital-ds/lib/auth-better-auth`) traduce sus respuestas.
125
+ - **Reglas:** el error nunca revela si la cuenta existe (`invalid-credentials`); los textos salen del catálogo
126
+ (`AuthErrorCode`), no de la respuesta del proveedor. Idioma y tema siempre visibles en la esquina (`toolbar`).
127
+ Una sola acción principal por pantalla; los proveedores van antes o después del formulario, no mezclados.
128
+ Contraseña con `PasswordInput` (mostrar/ocultar) y, al crearla, `PasswordStrength`.
129
+ - **Evita:** fondos animados en un backoffice interno (usa `minimal` o `centered` sin fondo); proveedores que la
130
+ app no tiene configurados; CAPTCHA o pasos extra antes de saber si hacen falta.
131
+
105
132
  ---
106
133
 
107
134
  ## Patrones de movimiento
@@ -48,6 +48,14 @@ la pantalla). Un hallazgo se reporta así: `fichero:línea · regla · qué pasa
48
48
  - [ ] Solo el del tema (`motion.css` y sus interruptores, o `useDsMotion()`); nada de duraciones o curvas propias.
49
49
  - [ ] El movimiento explica algo (origen, cambio de estado), no decora; quieto con movimiento reducido.
50
50
 
51
+ ## G. Acceso (P13)
52
+ - [ ] El flujo sale de `defineAuthFlow` y `validateAuthFlow` no da avisos.
53
+ - [ ] Ningún error revela si la cuenta existe; los textos de error salen del catálogo, no del proveedor.
54
+ - [ ] Autocompletado correcto (`username`, `current-password`, `new-password`, `one-time-code`) y llaves de acceso
55
+ ofrecidas si el flujo las tiene.
56
+ - [ ] Idioma y tema visibles; con el lector de pantalla se anuncian error, envío y éxito.
57
+ - [ ] El segundo factor ofrece otra vía (código de respaldo) y la sesión avisa antes de caducar (`SessionTimeout`).
58
+
51
59
  ## Anti-patrones (rechazar)
52
60
  - Tarjetas dentro de tarjetas; todo metido en tarjetas.
53
61
  - Texto gris sobre fondos de color; texto sobre imágenes sin garantía de contraste.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "orbital-ds",
3
- "version": "0.28.0",
3
+ "version": "0.30.0",
4
4
  "description": "Sistema de diseño genérico: estructura común + temas con personalidad (qratia, zyro) + ~60 componentes sobre Base UI y Tailwind v4, con contrato verificable y legible por agentes.",
5
5
  "keywords": [
6
6
  "design-system",
@@ -68,11 +68,12 @@
68
68
  "build": "tsup && node scripts/build-css.mjs",
69
69
  "dev": "tsup --watch --onSuccess \"node scripts/copy-css.mjs\"",
70
70
  "typecheck": "tsc --noEmit",
71
- "verify": "pnpm check:ds && pnpm typecheck && pnpm showcase:typecheck && pnpm build && pnpm check:bundle && pnpm check:charts && pnpm check:pack",
71
+ "verify": "pnpm check:ds && pnpm check:neutral && pnpm typecheck && pnpm showcase:typecheck && pnpm build && pnpm check:bundle && pnpm check:charts && pnpm check:pack",
72
72
  "manifest": "node scripts/manifest.mjs",
73
73
  "check:ds": "node scripts/doctor.mjs",
74
74
  "check:bundle": "node scripts/check-bundle.mjs",
75
75
  "check:charts": "node scripts/check-charts.mjs",
76
+ "check:neutral": "node scripts/neutral.mjs --check",
76
77
  "check:pack": "node scripts/check-pack.mjs",
77
78
  "prepublishOnly": "pnpm verify",
78
79
  "showcase": "vite --config showcase/vite.config.ts",
@@ -11,6 +11,8 @@ export interface BrandOptions {
11
11
  gestos?: boolean
12
12
  /** Neutros reales del tema: el contraste se mide contra SU lienzo. */
13
13
  base?: BrandBase
14
+ /** "dark": el tema tiene el lateral oscuro en las dos pieles (dock); se traduce a un tono profundo del primario. */
15
+ lateral?: "auto" | "dark"
14
16
  }
15
17
  export interface BrandResult {
16
18
  claro: BrandSkin
@@ -111,10 +111,13 @@ export function derivarSeries(primario, secundario, lienzo, { oscura = false } =
111
111
  * Deriva la marca. Devuelve { claro, oscuro, avisos } con los tokens (sin el prefijo --).
112
112
  * `secundario` (opcional): serie 2 de los gráficos y, si el tema tiene gestos, el acento del gesto.
113
113
  * `acento` y `marcador` solo si el tema tiene gestos.
114
+ * `lateral` = 'dark' si el tema tiene el lateral oscuro en las dos pieles (ficha: "sidebar": "dark",
115
+ * p. ej. el dock de lagoon): el lateral se traduce a un tono PROFUNDO y mate del primario, con el
116
+ * activo en una versión clara del primario y texto oscuro encima (AA medido contra ese lateral).
114
117
  * `base` ({ papel, tinta, fondoO, textoO }): neutros REALES del tema. Con ellos, el texto sobre el
115
118
  * primario, el enlace y el contraste se calculan contra la paleta del tema (modo «solo primario»).
116
119
  */
117
- export function derivar(primario, { acento, secundario = null, marcador = true, gestos = false, base = {} }) {
120
+ export function derivar(primario, { acento, secundario = null, marcador = true, gestos = false, base = {}, lateral = 'auto' }) {
118
121
  const avisos = [];
119
122
  const P = rgbToOklch(primario);
120
123
  const H = P.c < 0.02 ? 255 : P.h; // primario casi gris: neutros azulados por defecto
@@ -175,6 +178,23 @@ export function derivar(primario, { acento, secundario = null, marcador = true,
175
178
  oscuro['ds-marker'] = marcador ? rgba(acentoC, 0.45) : 'transparent';
176
179
  }
177
180
 
181
+ /* ── lateral oscuro (dock): profundo y mate en el tono del primario, en las dos pieles ── */
182
+ if (lateral === 'dark') {
183
+ const croma = Math.min(Math.max(P.c * 0.4, 0.03), 0.07);
184
+ const dock = (l) => {
185
+ const fondo = ok(l, croma, H), texto = ok(0.95, 0.02, H);
186
+ let activo = oklchToRgb({ l: Math.max(P.l, 0.82), c: Math.min(P.c, 0.16), h: H });
187
+ if (ratio(fondo, activo) < 4.5) activo = ajustar(activo, +1, (c) => ratio(fondo, c) >= 4.5) ?? activo;
188
+ if (ratio(texto, fondo) < 4.5) avisos.push(`lateral: el texto sobre ${hex(fondo)} no llega a 4.5:1`);
189
+ return {
190
+ sidebar: hex(fondo), 'sidebar-foreground': hex(texto), 'sidebar-accent': rgba(texto, 0.12), 'sidebar-accent-foreground': hex(texto),
191
+ 'sidebar-border': rgba(texto, 0.14), 'sidebar-primary': hex(activo), 'sidebar-primary-foreground': hex(fondo), 'sidebar-ring': hex(activo),
192
+ };
193
+ };
194
+ Object.assign(claro, dock(0.28));
195
+ Object.assign(oscuro, dock(0.24));
196
+ }
197
+
178
198
  /* ── series de gráfico: 5, en armonía, 3:1 sobre el lienzo de cada piel ── */
179
199
  const seriesC = derivarSeries(prim, secundario, papel);
180
200
  const seriesO = derivarSeries(primO, secundario ? oklchToRgb({ ...rgbToOklch(secundario), l: Math.max(rgbToOklch(secundario).l, 0.7) }) : null, fondoO, { oscura: true });