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.
- package/AGENTS.md +42 -10
- package/CHANGELOG.md +489 -0
- package/README.md +2 -2
- package/components.manifest.json +590 -83
- package/dist/hooks/use-ds-messages.d.ts +54 -0
- package/dist/hooks/use-esc-close-stack.d.ts +3 -0
- package/dist/hooks/use-esc-close-stack.js +38 -0
- package/dist/hooks/use-simulated-progress.d.ts +11 -0
- package/dist/hooks/use-simulated-progress.js +30 -0
- package/dist/lib/brand-allowlist.d.ts +3 -0
- package/dist/lib/brand-allowlist.js +719 -0
- package/dist/lib/brand-runtime.d.ts +52 -0
- package/dist/lib/brand-runtime.js +85 -0
- package/dist/lib/echarts-presets.d.ts +81 -1
- package/dist/lib/echarts-presets.js +152 -1
- package/dist/lib/echarts-setup.js +2 -0
- package/dist/lib/i18n.d.ts +54 -0
- package/dist/lib/i18n.js +165 -3
- package/dist/lib/locales/de.js +55 -1
- package/dist/lib/locales/fr.js +55 -1
- package/dist/lib/locales/he.js +55 -1
- package/dist/lib/locales/it.js +55 -1
- package/dist/styles.css +44 -0
- package/dist/themes/tactile.css +1 -6
- package/dist/themes/tactile.scoped.css +1 -6
- package/dist/ui/alert.d.ts +1 -1
- package/dist/ui/api-key-list.d.ts +40 -0
- package/dist/ui/api-key-list.js +89 -0
- package/dist/ui/attachment.d.ts +3 -3
- package/dist/ui/audit-log.d.ts +53 -0
- package/dist/ui/audit-log.js +102 -0
- package/dist/ui/banner.d.ts +1 -1
- package/dist/ui/bubble.d.ts +1 -1
- package/dist/ui/button-group.d.ts +1 -1
- package/dist/ui/button.d.ts +2 -2
- package/dist/ui/chart-card.d.ts +0 -1
- package/dist/ui/context-menu.js +2 -2
- package/dist/ui/cta-banner.d.ts +30 -0
- package/dist/ui/cta-banner.js +63 -0
- package/dist/ui/detail-panel.d.ts +3 -1
- package/dist/ui/detail-panel.js +2 -2
- package/dist/ui/faq.d.ts +34 -0
- package/dist/ui/faq.js +25 -0
- package/dist/ui/feature-grid.d.ts +40 -0
- package/dist/ui/feature-grid.js +40 -0
- package/dist/ui/field.d.ts +1 -1
- package/dist/ui/input-group.d.ts +1 -1
- package/dist/ui/item.d.ts +3 -3
- package/dist/ui/landing-section.d.ts +34 -0
- package/dist/ui/landing-section.js +59 -0
- package/dist/ui/marker.d.ts +1 -1
- package/dist/ui/member-list.d.ts +43 -0
- package/dist/ui/member-list.js +107 -0
- package/dist/ui/onboarding-checklist.d.ts +38 -0
- package/dist/ui/onboarding-checklist.js +132 -0
- package/dist/ui/panel.d.ts +2 -2
- package/dist/ui/permission-matrix.d.ts +35 -0
- package/dist/ui/permission-matrix.js +89 -0
- package/dist/ui/plan-summary.d.ts +59 -0
- package/dist/ui/plan-summary.js +92 -0
- package/dist/ui/popover.d.ts +1 -1
- package/dist/ui/pricing-table.d.ts +29 -0
- package/dist/ui/pricing-table.js +86 -0
- package/dist/ui/sheet.d.ts +2 -2
- package/dist/ui/sheet.js +1 -1
- package/dist/ui/sidebar.d.ts +1 -1
- package/dist/ui/sparkline.d.ts +1 -1
- package/dist/ui/status-badge.d.ts +2 -2
- package/dist/ui/tabs.d.ts +1 -1
- package/dist/ui/testimonial.d.ts +37 -0
- package/dist/ui/testimonial.js +61 -0
- package/dist/ui/toggle.d.ts +1 -1
- package/dist/ui/upgrade-prompt.d.ts +24 -0
- package/dist/ui/upgrade-prompt.js +85 -0
- package/dist/ui/workspace-switcher.d.ts +28 -0
- package/dist/ui/workspace-switcher.js +92 -0
- package/docs/GRAFICOS.md +1 -1
- package/docs/designer/patrones.md +36 -3
- package/manifest/actions.json +1 -1
- package/manifest/agents.json +1 -1
- package/manifest/ai.json +1 -1
- package/manifest/auth.json +1 -1
- package/manifest/chat.json +1 -1
- package/manifest/content.json +496 -1
- package/manifest/data.json +498 -103
- package/manifest/feedback.json +234 -47
- package/manifest/forms.json +1 -1
- package/manifest/motion.json +3 -3
- package/manifest/navigation.json +104 -3
- package/manifest/overlays.json +15 -12
- package/package.json +6 -18
- package/scripts/cli.mjs +82 -5
- package/scripts/doctor.mjs +32 -4
- package/scripts/eslint-plugin.mjs +32 -0
- package/scripts/manifest.mjs +20 -0
- package/scripts/skill.mjs +85 -0
- package/scripts/upgrade.mjs +126 -0
- package/skill/SKILL.md +5 -2
- package/dist/ui/chart.d.ts +0 -65
- package/dist/ui/chart.js +0 -254
- package/dist/ui/sonner.d.ts +0 -6
- 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
|
|
85
|
-
|
|
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`
|
|
126
|
-
(siguen la lectura
|
|
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
|
|
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–
|
|
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
|
|
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`
|
|
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-
|
|
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
|