orbital-ds 0.21.0 → 0.25.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 +15 -4
- package/components.manifest.json +113 -1
- package/dist/hooks/use-ds-messages.d.ts +1 -0
- package/dist/lib/echarts-presets.d.ts +75 -1
- package/dist/lib/echarts-presets.js +138 -1
- package/dist/lib/echarts-setup.js +24 -0
- package/dist/lib/i18n.d.ts +1 -0
- package/dist/lib/i18n.js +3 -0
- package/dist/styles.css +7 -2
- package/dist/ui/chart-card.d.ts +28 -0
- package/dist/ui/chart-card.js +79 -0
- package/dist/ui/content-card.d.ts +31 -0
- package/dist/ui/content-card.js +89 -0
- package/dist/ui/data-table.d.ts +5 -2
- package/dist/ui/data-table.js +11 -4
- package/dist/ui/detail-panel.d.ts +16 -0
- package/dist/ui/detail-panel.js +52 -0
- package/dist/ui/entity-list.d.ts +25 -0
- package/dist/ui/entity-list.js +67 -0
- package/dist/ui/form-layout.js +4 -4
- package/dist/ui/loading-state.d.ts +10 -0
- package/dist/ui/loading-state.js +48 -0
- package/dist/ui/mosaic.d.ts +13 -0
- package/dist/ui/mosaic.js +52 -0
- package/dist/ui/page-shell.d.ts +8 -0
- package/dist/ui/page-shell.js +29 -0
- package/dist/ui/stat-group.js +3 -3
- package/dist/ui/step-flow.js +8 -8
- package/docs/CONTRACT.md +9 -2
- package/package.json +3 -2
- package/scripts/doctor.mjs +27 -0
package/dist/ui/step-flow.js
CHANGED
|
@@ -132,7 +132,7 @@ function StepFlow({
|
|
|
132
132
|
/* @__PURE__ */ jsxs(
|
|
133
133
|
"div",
|
|
134
134
|
{
|
|
135
|
-
className: cn("flex flex-col gap-2", density !== "compact" && "@[
|
|
135
|
+
className: cn("flex flex-col gap-2", density !== "compact" && "@[37.5rem]:hidden"),
|
|
136
136
|
children: [
|
|
137
137
|
/* @__PURE__ */ jsxs("div", { className: "flex items-baseline justify-between gap-3 text-xs text-muted-foreground", children: [
|
|
138
138
|
/* @__PURE__ */ jsx("span", { className: "tabular-nums", children: dsFormat(t.stepOf, { n: index + 1, total: all.length }) }),
|
|
@@ -153,7 +153,7 @@ function StepFlow({
|
|
|
153
153
|
{
|
|
154
154
|
"aria-label": t.stepFlowProgress,
|
|
155
155
|
orientation: "horizontal",
|
|
156
|
-
className: "hidden @[
|
|
156
|
+
className: "hidden @[37.5rem]:flex",
|
|
157
157
|
children: all.map((s, i) => /* @__PURE__ */ jsxs(StepperItem, { step: i + 1, status: stepStatus(i, s), children: [
|
|
158
158
|
/* @__PURE__ */ jsx(StepperIndicator, {}),
|
|
159
159
|
/* @__PURE__ */ jsx(StepperContent, { className: "min-w-0 max-w-40", children: /* @__PURE__ */ jsx(StepperTitle, { className: "truncate", children: s.title }) }),
|
|
@@ -166,7 +166,7 @@ function StepFlow({
|
|
|
166
166
|
{
|
|
167
167
|
"aria-label": t.stepFlowProgress,
|
|
168
168
|
orientation: "vertical",
|
|
169
|
-
className: "hidden @[
|
|
169
|
+
className: "hidden @[37.5rem]:flex",
|
|
170
170
|
children: all.map((s, i) => /* @__PURE__ */ jsxs(StepperItem, { step: i + 1, status: stepStatus(i, s), children: [
|
|
171
171
|
/* @__PURE__ */ jsx(StepperIndicator, {}),
|
|
172
172
|
/* @__PURE__ */ jsxs(StepperContent, { children: [
|
|
@@ -201,7 +201,7 @@ function StepFlow({
|
|
|
201
201
|
"div",
|
|
202
202
|
{
|
|
203
203
|
"data-slot": "step-flow-footer",
|
|
204
|
-
className: "flex flex-col-reverse gap-2 @[
|
|
204
|
+
className: "flex flex-col-reverse gap-2 @[37.5rem]:flex-row @[37.5rem]:items-center @[37.5rem]:justify-end",
|
|
205
205
|
children: [
|
|
206
206
|
/* @__PURE__ */ jsx(
|
|
207
207
|
Button,
|
|
@@ -209,7 +209,7 @@ function StepFlow({
|
|
|
209
209
|
variant: "ghost",
|
|
210
210
|
disabled: pending,
|
|
211
211
|
onClick: requestClose,
|
|
212
|
-
className: "@[
|
|
212
|
+
className: "@[37.5rem]:me-auto",
|
|
213
213
|
children: t.stepFlowCancel
|
|
214
214
|
}
|
|
215
215
|
),
|
|
@@ -256,7 +256,7 @@ function StepFlow({
|
|
|
256
256
|
{
|
|
257
257
|
className: cn(
|
|
258
258
|
"grid min-w-0 gap-(--ds-section-gap)",
|
|
259
|
-
rail && "@[
|
|
259
|
+
rail && "@[37.5rem]:grid-cols-[minmax(10rem,14rem)_minmax(0,1fr)]"
|
|
260
260
|
),
|
|
261
261
|
children: [
|
|
262
262
|
result == null && progressNode,
|
|
@@ -265,11 +265,11 @@ function StepFlow({
|
|
|
265
265
|
{
|
|
266
266
|
className: cn(
|
|
267
267
|
"grid min-w-0 gap-(--ds-section-gap)",
|
|
268
|
-
showAside && result == null && "@[
|
|
268
|
+
showAside && result == null && "@[37.5rem]:grid-cols-[minmax(0,1fr)_minmax(0,0.8fr)]"
|
|
269
269
|
),
|
|
270
270
|
children: [
|
|
271
271
|
body,
|
|
272
|
-
showAside && result == null && /* @__PURE__ */ jsx("aside", { "data-slot": "step-flow-aside", className: "hidden min-w-0 @[
|
|
272
|
+
showAside && result == null && /* @__PURE__ */ jsx("aside", { "data-slot": "step-flow-aside", className: "hidden min-w-0 @[37.5rem]:block", children: aside })
|
|
273
273
|
]
|
|
274
274
|
}
|
|
275
275
|
)
|
package/docs/CONTRACT.md
CHANGED
|
@@ -134,10 +134,12 @@ en cualquier proyecto. Vocabulario común en `src/lib/presets.ts` (`DsDensity`,
|
|
|
134
134
|
4. **El diseño sigue el ancho del contenedor** (container query), no el dispositivo ni la presentación.
|
|
135
135
|
5. **Aviso en desarrollo** (`dsWarn`, mensaje en inglés) si la combinación no cuadra.
|
|
136
136
|
6. **Ganchos del DOM**: `data-slot` y `data-preset` (más `data-presentation`/`data-density` si aplica).
|
|
137
|
-
7. **Un `@note`** que diga cuándo usar cada preset. Catálogo hoy: `StepFlow` (quick · activation · long), `FormLayout`
|
|
138
|
-
(inline · sectioned · settings), `EmptyState` (first-use · no-results · error · forbidden), `StatGroup` (overview ·
|
|
137
|
+
7. **Un `@note`** que diga cuándo usar cada preset. Catálogo hoy: `ChartCard` (glance · standard · focus · dense), `ContentCard` (basic · feature · media · horizontal, con `emphasis` elevated · outlined · filled · ghost), `Mosaic` (even · bento · trio), `PageShell` (content · detail · canvas), `DataTable` (browse · manage · compact), `LoadingState` (list · card · table · detail), `DetailPanel` (side · bottom · full), `EntityList` (list · grid · compact), `StepFlow` (quick · activation · long), `FormLayout`
|
|
138
|
+
(inline · sectioned · settings), `NoticeReview` (read · acknowledge · resolve · respond), `EmptyState` (first-use · no-results · error · forbidden), `StatGroup` (overview ·
|
|
139
139
|
compact · comparison) y `ConfirmAction` (simple · typed).
|
|
140
140
|
|
|
141
|
+
**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`.
|
|
142
|
+
|
|
141
143
|
## Avisos y comunicaciones in-app (qué canal usar)
|
|
142
144
|
|
|
143
145
|
Se elige el canal por **urgencia** y **persistencia**; cada app no lo decide a mano:
|
|
@@ -154,6 +156,11 @@ Mismo vocabulario en todos: tono `info | success | warning | danger` y estado `n
|
|
|
154
156
|
`NotificationItem onSelect` abre la revisión; `NoticeReview` tiene presets `read | acknowledge | resolve | respond`
|
|
155
157
|
(modal o `presentation="sheet"`).
|
|
156
158
|
|
|
159
|
+
## Unidades
|
|
160
|
+
|
|
161
|
+
Medidas en `rem` (también en container queries); `em` solo relativo al propio componente; `px` solo en filetes y
|
|
162
|
+
bordes finos vía token. `pnpm check:ds` rechaza `@[Npx]` y medidas fijas en valores arbitrarios.
|
|
163
|
+
|
|
157
164
|
## Reglas de nombres
|
|
158
165
|
|
|
159
166
|
- Todo en **inglés**: tokens, props y valores de variantes.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "orbital-ds",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.25.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,10 +68,11 @@
|
|
|
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:pack",
|
|
71
|
+
"verify": "pnpm check:ds && 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
|
+
"check:charts": "node scripts/check-charts.mjs",
|
|
75
76
|
"check:pack": "node scripts/check-pack.mjs",
|
|
76
77
|
"prepublishOnly": "pnpm verify",
|
|
77
78
|
"showcase": "vite --config showcase/vite.config.ts",
|
package/scripts/doctor.mjs
CHANGED
|
@@ -70,6 +70,12 @@ function declarations(body) {
|
|
|
70
70
|
|
|
71
71
|
/** Variables --ds-* que la estructura del paquete define (las que una app puede usar). */
|
|
72
72
|
/** CSS de la estructura: src/ en el repo; dist/ en el paquete instalado (npm no publica src/). */
|
|
73
|
+
// Objetivo táctil mínimo WCAG 2.5.8 (AA): ningún control mide menos de 1,5rem (24 px).
|
|
74
|
+
{
|
|
75
|
+
const css = existsSync(join(ROOT, 'src/styles.css')) ? readFileSync(join(ROOT, 'src/styles.css'), 'utf8') : '';
|
|
76
|
+
for (const m of css.matchAll(/--ds-control-h-(xs|sm|md|lg)\s*:\s*([\d.]+)rem/g))
|
|
77
|
+
if (parseFloat(m[2]) < 1.5) errors.push(`accesibilidad: --ds-control-h-${m[1]} = ${m[2]}rem queda bajo el objetivo táctil mínimo de 1.5rem (WCAG 2.5.8)`);
|
|
78
|
+
}
|
|
73
79
|
const STRUCTURE_CSS = existsSync(join(ROOT, 'src/styles.css')) ? join(ROOT, 'src/styles.css') : join(ROOT, 'dist/styles.css');
|
|
74
80
|
|
|
75
81
|
function knownDsVars() {
|
|
@@ -453,6 +459,25 @@ if (base && themeInfo[base]) {
|
|
|
453
459
|
}
|
|
454
460
|
}
|
|
455
461
|
|
|
462
|
+
// 9) PRESETS (estándar de AGENTS.md): un componente con prop `preset` emite `data-preset`, sus valores
|
|
463
|
+
// son una palabra en inglés en minúsculas (kebab-case) y lleva un @note que explica cuándo usar cada uno.
|
|
464
|
+
{
|
|
465
|
+
const uiDir9 = join(ROOT, 'src/ui');
|
|
466
|
+
if (existsSync(uiDir9)) {
|
|
467
|
+
for (const f of readdirSync(uiDir9).filter((n) => n.endsWith('.tsx'))) {
|
|
468
|
+
const src = read(join(uiDir9, f));
|
|
469
|
+
if (!/preset\??:/.test(src)) continue;
|
|
470
|
+
if (!/data-preset=/.test(src)) errors.push(`ui/${f}: tiene prop preset pero no emite data-preset`);
|
|
471
|
+
if (!/@note/.test(src)) errors.push(`ui/${f}: tiene prop preset pero ningún @note que explique cuándo usar cada uno`);
|
|
472
|
+
for (const m of src.matchAll(/type \w*Preset\s*=\s*([^;]+);/g)) {
|
|
473
|
+
for (const v of m[1].matchAll(/"([^"]+)"/g)) {
|
|
474
|
+
if (!/^[a-z]+(-[a-z]+)*$/.test(v[1])) errors.push(`ui/${f}: valor de preset «${v[1]}» fuera del estándar (inglés, minúsculas, kebab-case)`);
|
|
475
|
+
}
|
|
476
|
+
}
|
|
477
|
+
}
|
|
478
|
+
}
|
|
479
|
+
}
|
|
480
|
+
|
|
456
481
|
// CSS de una app (opcional)
|
|
457
482
|
const cssArgIdx = process.argv.indexOf('--css');
|
|
458
483
|
if (cssArgIdx > -1 && process.argv[cssArgIdx + 1]) {
|
|
@@ -488,6 +513,8 @@ const NO_HARDCODE = [
|
|
|
488
513
|
{ re: /(?<![\w-])(?:bg|text|border)-(?:black|white)(?:\/\d+)?(?![\w-])/g, why: 'color fijo (usa un token de color)' },
|
|
489
514
|
{ re: /(?<![\w-])shadow-(?:xs|sm|md|lg|xl|2xl)(?![\w-])/g, why: 'sombra de la escala Tailwind (usa shadow-card/control/raised/overlay/popover)' },
|
|
490
515
|
{ re: /(?<![\w-])text-\[\d+px\]/g, why: 'tamaño de texto arbitrario (usa la escala estándar)' },
|
|
516
|
+
{ re: /(?<![\w-])text-\[(?:0?\.[0-6]\d*|0?\.7[0-4]\d*)rem\]/g, why: 'texto menor de 0,75rem (12 px): ilegible; usa text-xs como mínimo' },
|
|
517
|
+
{ re: /@\[\d+px\]/g, why: 'container query en px (usa rem: respeta el tamaño de letra de la persona)' },
|
|
491
518
|
{ re: /(?<![\w-])rounded-(?:3xl|4xl)(?![\w-])/g, why: 'radio fuera de la rampa (usa rounded-control/overlay o la rampa sm…2xl)' },
|
|
492
519
|
{ re: /(?<![\w-])(?:bg|text|border|ring|fill|stroke)-(?:red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose|slate|gray|zinc|neutral|stone)-\d{2,3}(?![\w-])/g, why: 'color de la paleta Tailwind (usa tokens del tema)' },
|
|
493
520
|
];
|