orbital-ds 0.44.1 → 0.50.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 (102) hide show
  1. package/AGENTS.md +42 -10
  2. package/CHANGELOG.md +489 -0
  3. package/README.md +2 -2
  4. package/components.manifest.json +590 -83
  5. package/dist/hooks/use-ds-messages.d.ts +54 -0
  6. package/dist/hooks/use-esc-close-stack.d.ts +3 -0
  7. package/dist/hooks/use-esc-close-stack.js +38 -0
  8. package/dist/hooks/use-simulated-progress.d.ts +11 -0
  9. package/dist/hooks/use-simulated-progress.js +30 -0
  10. package/dist/lib/brand-allowlist.d.ts +3 -0
  11. package/dist/lib/brand-allowlist.js +719 -0
  12. package/dist/lib/brand-runtime.d.ts +52 -0
  13. package/dist/lib/brand-runtime.js +85 -0
  14. package/dist/lib/echarts-presets.d.ts +81 -1
  15. package/dist/lib/echarts-presets.js +152 -1
  16. package/dist/lib/echarts-setup.js +2 -0
  17. package/dist/lib/i18n.d.ts +54 -0
  18. package/dist/lib/i18n.js +165 -3
  19. package/dist/lib/locales/de.js +55 -1
  20. package/dist/lib/locales/fr.js +55 -1
  21. package/dist/lib/locales/he.js +55 -1
  22. package/dist/lib/locales/it.js +55 -1
  23. package/dist/styles.css +44 -0
  24. package/dist/themes/tactile.css +1 -6
  25. package/dist/themes/tactile.scoped.css +1 -6
  26. package/dist/ui/alert.d.ts +1 -1
  27. package/dist/ui/api-key-list.d.ts +40 -0
  28. package/dist/ui/api-key-list.js +89 -0
  29. package/dist/ui/attachment.d.ts +3 -3
  30. package/dist/ui/audit-log.d.ts +53 -0
  31. package/dist/ui/audit-log.js +102 -0
  32. package/dist/ui/banner.d.ts +1 -1
  33. package/dist/ui/bubble.d.ts +1 -1
  34. package/dist/ui/button-group.d.ts +1 -1
  35. package/dist/ui/button.d.ts +2 -2
  36. package/dist/ui/chart-card.d.ts +0 -1
  37. package/dist/ui/context-menu.js +2 -2
  38. package/dist/ui/cta-banner.d.ts +30 -0
  39. package/dist/ui/cta-banner.js +63 -0
  40. package/dist/ui/detail-panel.d.ts +3 -1
  41. package/dist/ui/detail-panel.js +2 -2
  42. package/dist/ui/faq.d.ts +34 -0
  43. package/dist/ui/faq.js +25 -0
  44. package/dist/ui/feature-grid.d.ts +40 -0
  45. package/dist/ui/feature-grid.js +40 -0
  46. package/dist/ui/field.d.ts +1 -1
  47. package/dist/ui/input-group.d.ts +1 -1
  48. package/dist/ui/item.d.ts +3 -3
  49. package/dist/ui/landing-section.d.ts +34 -0
  50. package/dist/ui/landing-section.js +59 -0
  51. package/dist/ui/marker.d.ts +1 -1
  52. package/dist/ui/member-list.d.ts +43 -0
  53. package/dist/ui/member-list.js +107 -0
  54. package/dist/ui/onboarding-checklist.d.ts +38 -0
  55. package/dist/ui/onboarding-checklist.js +132 -0
  56. package/dist/ui/panel.d.ts +2 -2
  57. package/dist/ui/permission-matrix.d.ts +35 -0
  58. package/dist/ui/permission-matrix.js +89 -0
  59. package/dist/ui/plan-summary.d.ts +59 -0
  60. package/dist/ui/plan-summary.js +92 -0
  61. package/dist/ui/popover.d.ts +1 -1
  62. package/dist/ui/pricing-table.d.ts +29 -0
  63. package/dist/ui/pricing-table.js +86 -0
  64. package/dist/ui/sheet.d.ts +2 -2
  65. package/dist/ui/sheet.js +1 -1
  66. package/dist/ui/sidebar.d.ts +1 -1
  67. package/dist/ui/sparkline.d.ts +1 -1
  68. package/dist/ui/status-badge.d.ts +2 -2
  69. package/dist/ui/tabs.d.ts +1 -1
  70. package/dist/ui/testimonial.d.ts +37 -0
  71. package/dist/ui/testimonial.js +61 -0
  72. package/dist/ui/toggle.d.ts +1 -1
  73. package/dist/ui/upgrade-prompt.d.ts +24 -0
  74. package/dist/ui/upgrade-prompt.js +85 -0
  75. package/dist/ui/workspace-switcher.d.ts +28 -0
  76. package/dist/ui/workspace-switcher.js +92 -0
  77. package/docs/GRAFICOS.md +1 -1
  78. package/docs/designer/patrones.md +36 -3
  79. package/manifest/actions.json +1 -1
  80. package/manifest/agents.json +1 -1
  81. package/manifest/ai.json +1 -1
  82. package/manifest/auth.json +1 -1
  83. package/manifest/chat.json +1 -1
  84. package/manifest/content.json +496 -1
  85. package/manifest/data.json +498 -103
  86. package/manifest/feedback.json +234 -47
  87. package/manifest/forms.json +1 -1
  88. package/manifest/motion.json +3 -3
  89. package/manifest/navigation.json +104 -3
  90. package/manifest/overlays.json +15 -12
  91. package/package.json +6 -18
  92. package/scripts/cli.mjs +82 -5
  93. package/scripts/doctor.mjs +32 -4
  94. package/scripts/eslint-plugin.mjs +32 -0
  95. package/scripts/manifest.mjs +20 -0
  96. package/scripts/skill.mjs +85 -0
  97. package/scripts/upgrade.mjs +126 -0
  98. package/skill/SKILL.md +5 -2
  99. package/dist/ui/chart.d.ts +0 -65
  100. package/dist/ui/chart.js +0 -254
  101. package/dist/ui/sonner.d.ts +0 -6
  102. package/dist/ui/sonner.js +0 -60
package/AGENTS.md CHANGED
@@ -81,15 +81,15 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
81
81
 
82
82
  ## Gráficos e informes (Apache ECharts)
83
83
 
84
- - **Librería oficial: ECharts** (dependencia opcional). `chart.tsx` (Recharts) se mantiene por compatibilidad,
85
- sin nuevas funciones.
84
+ - **Librería única: ECharts** (dependencia opcional). `chart.tsx` (Recharts) se retiró en 0.48.0; el doctor (`--ui`)
85
+ marca como error un import de `orbital-ds/ui/chart`.
86
86
  - **El tema gobierna el gráfico**: `<EChart option={…} />` (`orbital-ds/ui/echart`) monta un tema de ECharts
87
87
  desde las variables del tema activo y de la marca (paleta `--chart-1…5` + estados, textos, ejes, tooltip,
88
88
  fuentes, ritmo) y se repinta al cambiar de tema o de piel. SVG por defecto; `exportable` descarga SVG/PNG.
89
89
  Nunca pongas colores en el `option`: los da el tema (si una serie necesita un tono, usa la paleta del tema).
90
90
  - **Tarjeta**: `<ChartCard preset="standard|glance|focus|dense" option={…} loading error empty />` (`orbital-ds/ui/chart-card`) pone título, estados, descarga y motor de pintado; el `option` sigue sin colores.
91
91
  - **Opciones listas**: `orbital-ds/lib/echarts-presets` (línea/área, barras, combo, mapa de calor, sankey,
92
- gauge, donut, dispersión, radar, embudo, treemap, sunburst, velas, boxplot, líneas y áreas de referencia). Sirven igual en pantalla y en informes.
92
+ gauge, donut, dispersión, radar, embudo, treemap, sunburst, velas, boxplot, cascada, cohortes, calendario, grafo, líneas y áreas de referencia). Sirven igual en pantalla y en informes.
93
93
  - **Informes automáticos (servidor / Workers, sin DOM)**: `renderEChartToSvg(option, { width, height, tokens })`
94
94
  (`orbital-ds/lib/echarts-server`) con `tokens` = `orbital-ds/themes/<tema>.tokens.json` → `.light` o
95
95
  `.dark` (colores ya resueltos; mezcla ahí los de la marca si la app tiene). Para PNG (plantillas de
@@ -122,14 +122,15 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
122
122
  el inglés y LISTA las claves pendientes: tradúcelas en el JSON hasta que `--check` pase.
123
123
  - **RTL**: `dsDirection(idioma)` (`orbital-ds/lib/i18n`) da `ltr`/`rtl`; la app lo pone en `<html dir>` y
124
124
  `DsI18nProvider` lo pasa a Base UI. Los componentes usan clases lógicas (`ms-`/`ps-`/`start-`/`text-start`; el doctor
125
- rechaza las físicas), las flechas de dirección llevan `rtl:rotate-180` y `Sheet`/`Sidebar` aceptan `side="start"|"end"`
126
- (siguen la lectura; `left`/`right` son físicos). Lo que dibuja el navegador (lista de `<select>`, calendario nativo) sigue
125
+ rechaza las físicas), las flechas de dirección llevan `rtl:rotate-180` y `Sheet`/`Sidebar`/`DetailPanel` usan por defecto
126
+ `side="start"` (lateral) o `"end"` (paneles), que siguen la lectura (`left`/`right` son físicos); los menús contextuales salen hacia `inline-end`. Lo que dibuja el navegador (lista de `<select>`, calendario nativo) sigue
127
127
  el modo claro/oscuro del tema por `color-scheme`. Decisión: `docs/adr/0001-rtl-clases-logicas.md`.
128
128
 
129
129
  ## Instalar en una app
130
130
 
131
131
  **Orden única: `pnpm exec orbital-ds`** (menú) · `orbital-ds init` (configuración inicial) · `orbital-ds theme [tema]`
132
- (cambiar de tema conservando marca y extras) · `orbital-ds doctor` · `orbital-ds i18n` · `orbital-ds help [orden]`.
132
+ (cambiar de tema conservando marca y extras) · `orbital-ds doctor` · `orbital-ds i18n` · `orbital-ds upgrade` (qué cambió desde
133
+ tu versión anterior y qué revisar) · `orbital-ds help [orden]`.
133
134
  Las órdenes sueltas (`orbital-ds-init`, `-doctor`, `-i18n`) siguen valiendo como atajos.
134
135
 
135
136
  `orbital-ds init` (= `pnpm exec orbital-ds-init`): elige tema (enseña su ficha: esencia, paleta, gesto, excepciones de
@@ -152,14 +153,19 @@ la app (bloque de imports en orden), anota DESIGN.md, instala Motion y pasa el d
152
153
  ## Diseñar con orbital-ds (diseñador para agentes)
153
154
 
154
155
  Para crear o revisar pantallas y flujos, sigue `docs/designer/`: **flujo.md** (contexto real, modo, mapa del flujo y
155
- modelo mental de la persona, orden de autoridad), **patrones.md** (P1–P12: página, lista de entidades, detalle, tabla,
156
+ modelo mental de la persona, orden de autoridad), **patrones.md** (P1–P16: página, lista de entidades, detalle, tabla,
156
157
  formulario, asistente, panel de datos, destructiva, estados, avisos, búsqueda, ajustes), **criterio.md** (análisis visual en 8 pasos con puntuación, árbol «¿tarjeta, ítem, bento, imagen, efecto?», armonía, referentes Apple/Material/Nielsen/Polaris), **ux.md** (heurísticas,
157
158
  carga cognitiva, formularios, textos, WCAG 2.2 AA, responsivo) y **revision.md** (lista observable y anti-patrones).
158
159
  Regla de oro: **nunca te sales del sistema**; si algo no se puede hacer con componentes y variables, se anota como hueco.
159
160
 
160
161
  - `orbital-ds context` (o `--json`): el estado real de la app para un agente (tema, marca, extras, componentes con
161
162
  sus notas, patrones). Las notas de uso de cada componente se escriben en el propio fichero con `@note`.
162
- - `orbital-ds skill`: instala en la app el skill de Claude Code **orbital-ds-designer** (`.claude/skills/`). Es fino:
163
+ - `orbital-ds skill`: instala en la app tres piezas para Claude Code: el skill **orbital-ds-designer** (`.claude/skills/`,
164
+ se carga por su `description` + `when_to_use`), la regla «toda interfaz con orbital-ds» **siempre en contexto** (bloque
165
+ gestionado en `CLAUDE.md`; si la app solo tenía `AGENTS.md`, el `CLAUDE.md` nuevo lo importa con `@AGENTS.md`) y un
166
+ **hook PostToolUse** en `.claude/settings.json` que ejecuta `orbital-ds hook`: pasa el doctor por cada `.tsx`/`.jsx` o
167
+ `brand.css` editado y, si se sale del sistema, sale con 2 para que el modelo vea los errores y los corrija
168
+ (`--no-hook` lo omite). El skill es fino:
163
169
  lee esta documentación del paquete instalado, así que se actualiza con cada versión; `orbital-ds skill --check` en
164
170
  el verify avisa si quedó de otra versión. El asistente lo ofrece en sus extras.
165
171
 
@@ -184,6 +190,10 @@ en cualquier proyecto. Vocabulario común en `src/lib/presets.ts` (`DsDensity`,
184
190
  `MfaChallenge` (totp · sms · email · backup-code · passkey), `MfaSetup` (totp · sms · backup-codes), `OAuthConsent`
185
191
  (authorize · mcp · device), `ConnectedAccounts` (social · integrations) y el flujo entero con `defineAuthFlow`
186
192
  (standard · social · passwordless · partner · enterprise · hybrid · sso-staff · sso-only).
193
+ En **SaaS avanzado** (0.49): `OnboardingChecklist` (card · sidebar · page), `MemberList` (team · workspace · compact),
194
+ `ApiKeyList` (keys · tokens · webhooks), `AuditLog` (full · compact · entity), `PlanSummary` (overview · compact · trial),
195
+ `UpgradePrompt` (inline · card · banner · overlay), `WorkspaceSwitcher` (sidebar · menu · compact) y `PermissionMatrix`
196
+ (roles · review · scopes).
187
197
  `ErrorPage` y `EmptyState` aceptan además `backdrop` (+ `backdropMedia`, `backdropGlass`) y `animated`.
188
198
 
189
199
  **Densidad global.** `--ds-density` (1 por defecto; 0.8 más denso, 1.2 más aireado) escala el relleno de celdas y la separación de secciones y listas; la app lo ajusta en `brand.css`.
@@ -198,6 +208,27 @@ en cualquier proyecto. Vocabulario común en `src/lib/presets.ts` (`DsDensity`,
198
208
  (`activate` · `open` · `resolve` · `inactive`). Receta completa: P14 en `docs/designer/patrones.md`.
199
209
  - `PageHeader` y `SectionHeader` aceptan `title`, `description` y `actions` como props (atajo de las piezas).
200
210
 
211
+ ## Webs públicas y portadas (0.46)
212
+
213
+ - **Portada**: `Hero` (P15). **Debajo**, cada bloque dentro de `LandingSection` (antetítulo, título, texto y acción; mismo
214
+ ancho y ritmo): `FeatureGrid`/`Feature`, `Testimonial`/`TestimonialGrid`, `PricingTable`/`PricingPlan`/`PricingFeature`,
215
+ `Faq` (sobre Accordion; `structuredData` = JSON-LD FAQPage) y `CtaBanner` al pie. Siguen el ancho del contenedor;
216
+ medidas en `--ds-landing-*`, `--ds-pricing-*`, `--ds-testimonial-*` y `--ds-cta-*`. Todo el texto lo pone la app.
217
+ - **Hooks**: `useSimulatedProgress(activo, { expectedMs })` (`orbital-ds/hooks/use-simulated-progress`) da un 0–100 creíble
218
+ cuando la tarea no informa de su avance; `useEscCloseStack(open, onClose)` (`orbital-ds/hooks/use-esc-close-stack`) hace
219
+ que Escape cierre solo la capa propia de arriba (Dialog, Sheet, Popover y Menu ya lo resuelven con Base UI).
220
+
221
+ ## Marca en datos (0.47)
222
+
223
+ - **Una app que guarda su marca en base de datos** (por cliente, desde un panel de ajustes) la valida y la pinta con
224
+ `orbital-ds/lib/brand-runtime`: `validateBrandTokens(fila, { base })` admite solo variables públicas (contrato + `--ds-*`
225
+ de la estructura, lista generada en `src/lib/brand-allowlist.ts` por `pnpm manifest`), rechaza valores que no sean un
226
+ único valor CSS seguro y mide el contraste AA de los pares que toca contra `base` (colores resueltos del tema, p. ej. de
227
+ `<tema>.tokens.json` o de su ficha). `brandTokensToCss(resultado)` da el CSS (`:root:root` y `.dark`) para un `<style>`
228
+ en el `<head>`, también en SSR; lanza si hay errores. Forma de la fila: `{ light: {…}, dark: {…} }` o un objeto plano.
229
+ - Es el mismo nivel que `brand.css`: ajusta la marca **encima** del tema. El tema se sigue eligiendo con su `@import`.
230
+ Guarda en la base de datos solo nombres públicos; nunca CSS libre.
231
+
201
232
  ## Acceso y autenticación
202
233
 
203
234
  - **Agnóstico del proveedor; Better Auth como referencia.** orbital-ds pinta, valida y anuncia; la app conecta su
@@ -215,7 +246,7 @@ Se elige el canal por **urgencia** y **persistencia**; cada app no lo decide a m
215
246
 
216
247
  | Intención | Canal | Persiste | Interrumpe |
217
248
  |---|---|---|---|
218
- | Confirmar una acción de la persona | toast (`Toaster` + `toast.add`, de `orbital-ds/ui/toast`; `sonner` solo por compatibilidad) | no | no |
249
+ | Confirmar una acción de la persona | toast (`Toaster` + `toast.add`, de `orbital-ds/ui/toast`; `sonner` se retiró en 0.49.0) | no | no |
219
250
  | Aviso de una sección | `Alert` | sí | no |
220
251
  | Aviso que afecta a toda la página | `Banner` | hasta resolver | no |
221
252
  | Asunto con seguimiento o decisión | campana (`NotificationCenter`) + `NoticeReview` | sí, con estado | solo si es crítico |
@@ -225,7 +256,7 @@ Mismo vocabulario en todos: tono `info | success | warning | danger` y estado `n
225
256
  `NotificationItem onSelect` abre la revisión; `NoticeReview` tiene presets `read | acknowledge | resolve | respond`
226
257
  (modal o `presentation="sheet"`).
227
258
 
228
- **En la app, en el editor:** `import orbital from "orbital-ds/eslint"; export default [orbital.configs.recommended];` (config plana de ESLint, sin dependencias): `no-as-child`, `system-styles` (nada de colores, z-index, duraciones ni paleta Tailwind en `className`/`cn()`) y `logical-direction` (RTL).
259
+ **En la app, en el editor:** `import orbital from "orbital-ds/eslint"; export default [orbital.configs.recommended];` (config plana de ESLint, sin dependencias): `no-as-child`, `system-styles` (nada de colores, z-index, duraciones ni paleta Tailwind en `className`/`cn()`) `logical-direction` (clases físicas) y `logical-side` (`side="left"|"right"` en laterales, paneles y flotantes: usa `start`/`end` o `inline-start`/`inline-end`). El doctor (`--ui`) avisa de lo mismo y rechaza un lado físico por defecto en un componente del paquete.
229
260
 
230
261
  ## Cómo comprobar tu trabajo
231
262
 
@@ -233,6 +264,7 @@ Mismo vocabulario en todos: tono `info | success | warning | danger` y estado `n
233
264
  pnpm check:ds # contrato, repetidos, sombras, fugas, valores fijos, personalidad, familias, contraste y demos
234
265
  pnpm verify # doctor + typecheck + build + check:bundle
235
266
  pnpm check:charts # cada constructor de gráfico: sin colores y dibuja SVG en servidor
267
+ pnpm test # pruebas de lógica sin navegador (node:test sobre dist/: i18n, format, brand-runtime, auth-flow, plantillas, upgrade)
236
268
  pnpm check:bundle # empaqueta un consumidor de EChart (navegador y servidor) y comprueba que dibuja
237
269
  pnpm domains # dominios tocados por tu rama y su lista de revisión para el PR (base: origin/main)
238
270
  pnpm manifest # regenera components.manifest.json tras añadir componentes