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.
@@ -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" && "@[600px]:hidden"),
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 @[600px]:flex",
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 @[600px]:flex",
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 @[600px]:flex-row @[600px]:items-center @[600px]:justify-end",
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: "@[600px]:me-auto",
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 && "@[600px]:grid-cols-[minmax(10rem,14rem)_minmax(0,1fr)]"
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 && "@[600px]:grid-cols-[minmax(0,1fr)_minmax(0,0.8fr)]"
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 @[600px]:block", children: aside })
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.21.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",
@@ -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
  ];