orbital-ds 0.41.0 → 0.48.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 +54 -12
- package/CHANGELOG.md +458 -0
- package/README.md +2 -2
- package/components.manifest.json +6630 -3569
- package/dist/hooks/use-esc-close-stack.js +38 -0
- package/dist/hooks/use-simulated-progress.js +30 -0
- package/dist/lib/brand-allowlist.js +703 -0
- package/dist/lib/brand-runtime.js +85 -0
- package/dist/lib/echarts-presets.js +152 -1
- package/dist/lib/echarts-setup.js +2 -0
- package/dist/lib/format.js +177 -0
- package/dist/lib/i18n.js +35 -2
- package/dist/lib/locales/de.js +536 -0
- package/dist/lib/locales/fr.js +536 -0
- package/dist/lib/locales/he.js +536 -0
- package/dist/lib/locales/it.js +536 -0
- package/dist/ui/auth-form.js +13 -6
- package/dist/ui/ayuda.js +4 -1
- package/dist/ui/breadcrumb.js +1 -1
- package/dist/ui/calendar.js +3 -0
- package/dist/ui/carousel.js +10 -5
- package/dist/ui/context-menu.js +3 -3
- package/dist/ui/cta-banner.js +63 -0
- package/dist/ui/date-time.js +55 -0
- package/dist/ui/description-list.js +86 -0
- package/dist/ui/detail-panel.js +2 -2
- package/dist/ui/dropdown-menu.js +1 -1
- package/dist/ui/faq.js +25 -0
- package/dist/ui/feature-grid.js +40 -0
- package/dist/ui/hero.js +145 -0
- package/dist/ui/landing-section.js +59 -0
- package/dist/ui/mfa-challenge.js +1 -1
- package/dist/ui/next-step-card.js +92 -0
- package/dist/ui/page-header.js +20 -11
- package/dist/ui/pagination.js +2 -2
- package/dist/ui/pricing-table.js +86 -0
- package/dist/ui/quantity.js +27 -0
- package/dist/ui/sheet.js +6 -2
- package/dist/ui/sidebar.js +7 -3
- package/dist/ui/tag-input.js +169 -0
- package/dist/ui/testimonial.js +61 -0
- package/dist/ui/textarea.js +7 -1
- package/dist/ui/usage-meter.js +116 -0
- package/dist/ui/week-strip.js +2 -2
- package/docs/adr/0001-rtl-clases-logicas.md +14 -1
- package/docs/designer/flujo.md +1 -1
- package/docs/designer/patrones.md +45 -1
- package/manifest/actions.json +364 -0
- package/manifest/agents.json +399 -0
- package/manifest/ai.json +128 -0
- package/manifest/auth.json +1547 -0
- package/manifest/chat.json +612 -0
- package/manifest/content.json +2793 -0
- package/manifest/data.json +2802 -0
- package/manifest/feedback.json +1005 -0
- package/manifest/forms.json +1954 -0
- package/manifest/motion.json +196 -0
- package/manifest/navigation.json +1792 -0
- package/manifest/overlays.json +934 -0
- package/package.json +240 -238
- package/scripts/cli.mjs +124 -8
- package/scripts/doctor.mjs +153 -2
- package/scripts/eslint-plugin.mjs +125 -0
- package/scripts/i18n.mjs +1 -1
- package/scripts/manifest.mjs +179 -7
- package/scripts/upgrade.mjs +126 -0
- package/skill/SKILL.md +8 -3
- package/dist/hooks/use-ds-messages.d.ts +0 -537
- package/dist/hooks/use-ds-motion.d.ts +0 -17
- package/dist/hooks/use-in-view.d.ts +0 -9
- package/dist/hooks/use-mobile.d.ts +0 -3
- package/dist/lib/a2ui-catalog.d.ts +0 -42
- package/dist/lib/a2ui.d.ts +0 -289
- package/dist/lib/ai-events.d.ts +0 -15
- package/dist/lib/auth-better-auth.d.ts +0 -29
- package/dist/lib/auth-flow.d.ts +0 -85
- package/dist/lib/auth-providers.d.ts +0 -194
- package/dist/lib/auth.d.ts +0 -68
- package/dist/lib/echarts-presets.d.ts +0 -227
- package/dist/lib/echarts-server.d.ts +0 -15
- package/dist/lib/echarts-setup.d.ts +0 -8
- package/dist/lib/echarts-theme.d.ts +0 -36
- package/dist/lib/header-control.d.ts +0 -4
- package/dist/lib/i18n.d.ts +0 -545
- package/dist/lib/image-upload.d.ts +0 -41
- package/dist/lib/motion.d.ts +0 -74
- package/dist/lib/presets.d.ts +0 -8
- package/dist/lib/template-syntax.d.ts +0 -22
- package/dist/lib/utils.d.ts +0 -5
- package/dist/motion.css +0 -146
- package/dist/styles.css +0 -1737
- package/dist/themes/chocolate.css +0 -259
- package/dist/themes/chocolate.fonts.css +0 -2
- package/dist/themes/chocolate.guide.md +0 -30
- package/dist/themes/chocolate.meta.json +0 -61
- package/dist/themes/chocolate.scoped.css +0 -259
- package/dist/themes/chocolate.tokens.json +0 -49
- package/dist/themes/fractalia.css +0 -556
- package/dist/themes/fractalia.fonts.css +0 -3
- package/dist/themes/fractalia.guide.md +0 -86
- package/dist/themes/fractalia.meta.json +0 -112
- package/dist/themes/fractalia.scoped.css +0 -556
- package/dist/themes/fractalia.tokens.json +0 -39
- package/dist/themes/friendly.css +0 -375
- package/dist/themes/friendly.fonts.css +0 -2
- package/dist/themes/friendly.guide.md +0 -38
- package/dist/themes/friendly.meta.json +0 -82
- package/dist/themes/friendly.scoped.css +0 -375
- package/dist/themes/friendly.tokens.json +0 -45
- package/dist/themes/lagoon.css +0 -362
- package/dist/themes/lagoon.fonts.css +0 -2
- package/dist/themes/lagoon.guide.md +0 -47
- package/dist/themes/lagoon.meta.json +0 -85
- package/dist/themes/lagoon.scoped.css +0 -362
- package/dist/themes/lagoon.tokens.json +0 -49
- package/dist/themes/liquid.css +0 -510
- package/dist/themes/liquid.fonts.css +0 -7
- package/dist/themes/liquid.guide.md +0 -82
- package/dist/themes/liquid.meta.json +0 -134
- package/dist/themes/liquid.scoped.css +0 -510
- package/dist/themes/liquid.tokens.json +0 -47
- package/dist/themes/matcha.css +0 -259
- package/dist/themes/matcha.fonts.css +0 -2
- package/dist/themes/matcha.guide.md +0 -30
- package/dist/themes/matcha.meta.json +0 -61
- package/dist/themes/matcha.scoped.css +0 -259
- package/dist/themes/matcha.tokens.json +0 -49
- package/dist/themes/qratia.css +0 -264
- package/dist/themes/qratia.fonts.css +0 -2
- package/dist/themes/qratia.guide.md +0 -34
- package/dist/themes/qratia.meta.json +0 -49
- package/dist/themes/qratia.scoped.css +0 -264
- package/dist/themes/qratia.tokens.json +0 -49
- package/dist/themes/stone.css +0 -263
- package/dist/themes/stone.fonts.css +0 -2
- package/dist/themes/stone.guide.md +0 -30
- package/dist/themes/stone.meta.json +0 -47
- package/dist/themes/stone.scoped.css +0 -263
- package/dist/themes/stone.tokens.json +0 -49
- package/dist/themes/tactile.css +0 -596
- package/dist/themes/tactile.fonts.css +0 -3
- package/dist/themes/tactile.guide.md +0 -82
- package/dist/themes/tactile.meta.json +0 -182
- package/dist/themes/tactile.scoped.css +0 -596
- package/dist/themes/tactile.tokens.json +0 -42
- package/dist/themes/twitter.css +0 -364
- package/dist/themes/twitter.fonts.css +0 -6
- package/dist/themes/twitter.guide.md +0 -35
- package/dist/themes/twitter.meta.json +0 -90
- package/dist/themes/twitter.scoped.css +0 -364
- package/dist/themes/twitter.tokens.json +0 -45
- package/dist/themes/y2k.css +0 -259
- package/dist/themes/y2k.fonts.css +0 -2
- package/dist/themes/y2k.guide.md +0 -30
- package/dist/themes/y2k.meta.json +0 -59
- package/dist/themes/y2k.scoped.css +0 -259
- package/dist/themes/y2k.tokens.json +0 -49
- package/dist/themes/zyro.css +0 -442
- package/dist/themes/zyro.fonts.css +0 -2
- package/dist/themes/zyro.guide.md +0 -33
- package/dist/themes/zyro.meta.json +0 -74
- package/dist/themes/zyro.scoped.css +0 -442
- package/dist/themes/zyro.tokens.json +0 -46
- package/dist/ui/a2ui-renderer.d.ts +0 -33
- package/dist/ui/accordion.d.ts +0 -9
- package/dist/ui/agent-events.d.ts +0 -32
- package/dist/ui/ai-tag.d.ts +0 -8
- package/dist/ui/alert-dialog.d.ts +0 -23
- package/dist/ui/alert.d.ts +0 -13
- package/dist/ui/animated-number.d.ts +0 -9
- package/dist/ui/app-bar.d.ts +0 -10
- package/dist/ui/aspect-ratio.d.ts +0 -7
- package/dist/ui/attachment.d.ts +0 -26
- package/dist/ui/auth-backdrop.d.ts +0 -20
- package/dist/ui/auth-form.d.ts +0 -113
- package/dist/ui/auth-layout.d.ts +0 -72
- package/dist/ui/auth-parts.d.ts +0 -43
- package/dist/ui/auth-status.d.ts +0 -23
- package/dist/ui/avatar.d.ts +0 -16
- package/dist/ui/ayuda.d.ts +0 -22
- package/dist/ui/badge.d.ts +0 -15
- package/dist/ui/banner.d.ts +0 -14
- package/dist/ui/bottom-nav.d.ts +0 -15
- package/dist/ui/breadcrumb.d.ts +0 -12
- package/dist/ui/bubble.d.ts +0 -19
- package/dist/ui/button-group.d.ts +0 -15
- package/dist/ui/button.d.ts +0 -14
- package/dist/ui/calendar.d.ts +0 -15
- package/dist/ui/card-stack.d.ts +0 -9
- package/dist/ui/card.d.ts +0 -28
- package/dist/ui/carousel.d.ts +0 -33
- package/dist/ui/chain-of-thought.d.ts +0 -19
- package/dist/ui/chart-card.d.ts +0 -28
- package/dist/ui/chart.d.ts +0 -46
- package/dist/ui/chart.js +0 -254
- package/dist/ui/chat-composer.d.ts +0 -39
- package/dist/ui/checkbox.d.ts +0 -6
- package/dist/ui/choice-card.d.ts +0 -16
- package/dist/ui/code-block.d.ts +0 -14
- package/dist/ui/collapsible.d.ts +0 -8
- package/dist/ui/combobox.d.ts +0 -26
- package/dist/ui/command-palette.d.ts +0 -36
- package/dist/ui/command.d.ts +0 -22
- package/dist/ui/confirm-action.d.ts +0 -18
- package/dist/ui/confirm-dialog.d.ts +0 -21
- package/dist/ui/connected-accounts.d.ts +0 -25
- package/dist/ui/content-card.d.ts +0 -52
- package/dist/ui/context-menu.d.ts +0 -31
- package/dist/ui/conversation-list.d.ts +0 -24
- package/dist/ui/copy-button.d.ts +0 -14
- package/dist/ui/data-table.d.ts +0 -198
- package/dist/ui/date-picker.d.ts +0 -65
- package/dist/ui/detail-panel.d.ts +0 -16
- package/dist/ui/dialog.d.ts +0 -19
- package/dist/ui/direction.d.ts +0 -1
- package/dist/ui/dock.d.ts +0 -13
- package/dist/ui/drawer.d.ts +0 -18
- package/dist/ui/dropdown-menu.d.ts +0 -31
- package/dist/ui/dropzone.d.ts +0 -44
- package/dist/ui/echart.d.ts +0 -31
- package/dist/ui/empty-state.d.ts +0 -26
- package/dist/ui/empty.d.ts +0 -15
- package/dist/ui/entity-list.d.ts +0 -25
- package/dist/ui/error-page.d.ts +0 -28
- package/dist/ui/error-state.d.ts +0 -16
- package/dist/ui/eyebrow.d.ts +0 -7
- package/dist/ui/field.d.ts +0 -28
- package/dist/ui/file-upload.d.ts +0 -42
- package/dist/ui/filter-bar.d.ts +0 -38
- package/dist/ui/form-layout.d.ts +0 -19
- package/dist/ui/gauge.d.ts +0 -40
- package/dist/ui/generated-image.d.ts +0 -14
- package/dist/ui/generated-table.d.ts +0 -11
- package/dist/ui/heatmap-grid.d.ts +0 -39
- package/dist/ui/hover-card.d.ts +0 -8
- package/dist/ui/i18n-provider.d.ts +0 -11
- package/dist/ui/icon-tile.d.ts +0 -11
- package/dist/ui/input-group.d.ts +0 -22
- package/dist/ui/input-otp.d.ts +0 -13
- package/dist/ui/input.d.ts +0 -5
- package/dist/ui/instruction-editor.d.ts +0 -64
- package/dist/ui/item.d.ts +0 -26
- package/dist/ui/kbd.d.ts +0 -6
- package/dist/ui/label.d.ts +0 -5
- package/dist/ui/legend.d.ts +0 -32
- package/dist/ui/level-meter.d.ts +0 -16
- package/dist/ui/load-more.d.ts +0 -19
- package/dist/ui/loading-state.d.ts +0 -14
- package/dist/ui/locale-switcher.d.ts +0 -19
- package/dist/ui/markdown.d.ts +0 -14
- package/dist/ui/marker.d.ts +0 -13
- package/dist/ui/media-card.d.ts +0 -13
- package/dist/ui/menubar.d.ts +0 -31
- package/dist/ui/message-actions.d.ts +0 -12
- package/dist/ui/message-scroller.d.ts +0 -16
- package/dist/ui/message.d.ts +0 -12
- package/dist/ui/mfa-challenge.d.ts +0 -33
- package/dist/ui/mfa-setup.d.ts +0 -29
- package/dist/ui/mosaic.d.ts +0 -15
- package/dist/ui/motion-provider.d.ts +0 -11
- package/dist/ui/native-select.d.ts +0 -10
- package/dist/ui/navigation-menu.d.ts +0 -15
- package/dist/ui/notice-review.d.ts +0 -32
- package/dist/ui/notifications.d.ts +0 -81
- package/dist/ui/oauth-consent.d.ts +0 -54
- package/dist/ui/page-header.d.ts +0 -22
- package/dist/ui/page-loader.d.ts +0 -23
- package/dist/ui/page-shell.d.ts +0 -8
- package/dist/ui/pagination.d.ts +0 -22
- package/dist/ui/panel.d.ts +0 -12
- package/dist/ui/passkey-list.d.ts +0 -17
- package/dist/ui/password-input.d.ts +0 -5
- package/dist/ui/password-strength.d.ts +0 -14
- package/dist/ui/popover.d.ts +0 -12
- package/dist/ui/progress.d.ts +0 -9
- package/dist/ui/proportion-bar.d.ts +0 -27
- package/dist/ui/questionnaire.d.ts +0 -24
- package/dist/ui/radio-group.d.ts +0 -8
- package/dist/ui/reasoning.d.ts +0 -10
- package/dist/ui/resizable.d.ts +0 -10
- package/dist/ui/reveal.d.ts +0 -11
- package/dist/ui/scroll-area.d.ts +0 -7
- package/dist/ui/search-box.d.ts +0 -32
- package/dist/ui/select.d.ts +0 -19
- package/dist/ui/separator.d.ts +0 -6
- package/dist/ui/session-list.d.ts +0 -19
- package/dist/ui/session-timeout.d.ts +0 -13
- package/dist/ui/sheet.d.ts +0 -16
- package/dist/ui/shield.d.ts +0 -21
- package/dist/ui/show-more.d.ts +0 -12
- package/dist/ui/sidebar.d.ts +0 -90
- package/dist/ui/sign-out-dialog.d.ts +0 -17
- package/dist/ui/skeleton.d.ts +0 -10
- package/dist/ui/slider.d.ts +0 -23
- package/dist/ui/sonner.d.ts +0 -6
- package/dist/ui/sparkline.d.ts +0 -26
- package/dist/ui/spinner.d.ts +0 -5
- package/dist/ui/stat-group.d.ts +0 -8
- package/dist/ui/stat.d.ts +0 -90
- package/dist/ui/status-badge.d.ts +0 -39
- package/dist/ui/status-hero.d.ts +0 -12
- package/dist/ui/step-dots.d.ts +0 -10
- package/dist/ui/step-flow.d.ts +0 -48
- package/dist/ui/step-ring.d.ts +0 -12
- package/dist/ui/stepper.d.ts +0 -20
- package/dist/ui/suggestions.d.ts +0 -8
- package/dist/ui/switch.d.ts +0 -8
- package/dist/ui/table.d.ts +0 -12
- package/dist/ui/tabs.d.ts +0 -14
- package/dist/ui/task-loader.d.ts +0 -14
- package/dist/ui/task-progress.d.ts +0 -18
- package/dist/ui/textarea.d.ts +0 -11
- package/dist/ui/theme-toggle.d.ts +0 -14
- package/dist/ui/timeline.d.ts +0 -29
- package/dist/ui/toast.d.ts +0 -19
- package/dist/ui/toggle-group.d.ts +0 -14
- package/dist/ui/toggle.d.ts +0 -12
- package/dist/ui/tool-call.d.ts +0 -15
- package/dist/ui/tooltip.d.ts +0 -9
- package/dist/ui/week-strip.d.ts +0 -12
- package/dist/ui/workflow-run.d.ts +0 -23
package/scripts/cli.mjs
CHANGED
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
* orbital-ds theme [tema] cambiar de tema conservando tu marca y tus extras
|
|
8
8
|
* orbital-ds doctor [opc.] comprobar contrato, contraste y marca (= orbital-ds-doctor)
|
|
9
9
|
* orbital-ds i18n [opc.] textos de orbital-ds en los idiomas de la app (= orbital-ds-i18n)
|
|
10
|
+
* orbital-ds upgrade qué cambió desde la versión anterior y qué revisar
|
|
10
11
|
* orbital-ds help esta ayuda
|
|
11
12
|
*
|
|
12
13
|
* Las órdenes sueltas (orbital-ds-init, -doctor, -i18n) siguen funcionando: son atajos.
|
|
@@ -19,6 +20,7 @@ import { spawnSync } from 'node:child_process';
|
|
|
19
20
|
import { detectarCssApp, detectarMarca, importsDeTemaSueltos, temaDelCss, yaInstalado } from './setup.mjs';
|
|
20
21
|
import { analizarMarca, marcaGenerada, nombresColorTemas } from './brand-file.mjs';
|
|
21
22
|
import { estadoSkill, instalarSkill, raizApp, SKILL_NAME } from './skill.mjs';
|
|
23
|
+
import { ordenUpgrade } from './upgrade.mjs';
|
|
22
24
|
|
|
23
25
|
const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
|
|
24
26
|
const [orden, ...resto] = process.argv.slice(2);
|
|
@@ -47,8 +49,10 @@ Uso: orbital-ds <orden> [opciones] (sin orden, un menú)
|
|
|
47
49
|
doctor comprobar contrato, contraste, pesos y marca
|
|
48
50
|
i18n textos de orbital-ds en los idiomas de la app
|
|
49
51
|
context resumen de esta app para un agente: tema, marca, componentes y patrones
|
|
52
|
+
components catálogo por dominios: resumen, alternativas, props, notas y ejemplos (--search · --group · <nombre>)
|
|
50
53
|
skill instala o refresca el diseñador de orbital-ds para Claude Code
|
|
51
|
-
|
|
54
|
+
upgrade qué cambió desde tu versión anterior y qué revisar en la app
|
|
55
|
+
help esta ayuda · orbital-ds help <orden> para el detalle
|
|
52
56
|
|
|
53
57
|
Ejemplos
|
|
54
58
|
orbital-ds menú
|
|
@@ -128,6 +132,18 @@ Lo lee el skill «orbital-ds-designer» antes de diseñar, y vale para cualquier
|
|
|
128
132
|
orbital-ds context en texto (markdown)
|
|
129
133
|
orbital-ds context --json en JSON`,
|
|
130
134
|
|
|
135
|
+
components: `orbital-ds components — el catálogo, por páginas de dominio
|
|
136
|
+
|
|
137
|
+
Cada componente pertenece a un dominio (actions, forms, feedback, overlays, navigation, data, content, motion, chat,
|
|
138
|
+
agents, ai, auth). Pide solo lo que necesitas: cada ficha trae resumen (cuándo usarlo), alternativas (cuándo usar
|
|
139
|
+
otro), props tipadas (* = obligatoria), presets, notas de uso y ejemplos mínimos para copiar.
|
|
140
|
+
|
|
141
|
+
orbital-ds components los dominios y sus componentes
|
|
142
|
+
orbital-ds components --group auth todo un dominio
|
|
143
|
+
orbital-ds components --search tabla buscar por intención (nombre, resumen, alternativas y notas)
|
|
144
|
+
orbital-ds components button un componente
|
|
145
|
+
--json en JSON (también en node_modules/orbital-ds/manifest/<dominio>.json)`,
|
|
146
|
+
|
|
131
147
|
skill: `orbital-ds skill — diseñador de orbital-ds para Claude Code
|
|
132
148
|
|
|
133
149
|
Instala (o refresca) el skill «orbital-ds-designer» en la raíz de la app: .claude/skills/orbital-ds-designer/.
|
|
@@ -138,6 +154,17 @@ ya trabaja con lo nuevo. Lleva la versión estampada; lo que añadas DESPUÉS de
|
|
|
138
154
|
orbital-ds skill --check comprueba (para el verify): falla si falta o es de otra versión
|
|
139
155
|
orbital-ds skill --print enseña el contenido sin escribir nada`,
|
|
140
156
|
|
|
157
|
+
upgrade: `orbital-ds upgrade — qué cambió y qué revisar al actualizar
|
|
158
|
+
|
|
159
|
+
Lee el CHANGELOG del paquete instalado entre tu versión anterior y la actual. La anterior sale del último
|
|
160
|
+
commit (lockfile o package.json) o del sello del skill; si no, indícala con --from.
|
|
161
|
+
|
|
162
|
+
orbital-ds upgrade resumen por versión con lo que puede pedir un ajuste
|
|
163
|
+
orbital-ds upgrade --from 0.41.0 desde una versión concreta
|
|
164
|
+
orbital-ds upgrade --json en JSON (para un agente)
|
|
165
|
+
|
|
166
|
+
No cambia nada en la app. Al terminar recuerda las comprobaciones (doctor --ui, i18n --check, skill).`,
|
|
167
|
+
|
|
141
168
|
i18n: `orbital-ds i18n — textos de orbital-ds en tus idiomas
|
|
142
169
|
|
|
143
170
|
orbital-ds i18n rellena el espacio «orbital» de cada JSON (sin pisar lo tuyo)
|
|
@@ -210,7 +237,7 @@ function contexto(json) {
|
|
|
210
237
|
marca: estado.marca?.activa ? estado.marca : null,
|
|
211
238
|
brandCss: { fichero: existsSync(brand) ? relative(process.cwd(), brand).split(sep).join('/') : null, variables: brandVars, coloresAMano: estado.manual.colores.map((d) => d.name) },
|
|
212
239
|
extras: { animaciones: estado.animaciones, motion: yaInstalado('motion'), echarts: yaInstalado('echarts'), tablas: yaInstalado('@tanstack/react-table') },
|
|
213
|
-
componentes: Object.fromEntries(Object.entries(manifest.components).map(([n, c]) => [n, { import: c.import, exports: c.exports, ...(c.presets ? { presets: c.presets } : {}), ...(c.notes ? { notes: c.notes } : {}) }])),
|
|
240
|
+
componentes: Object.fromEntries(Object.entries(manifest.components).map(([n, c]) => [n, { import: c.import, group: c.group, exports: c.exports, ...(c.summary ? { summary: c.summary } : {}), ...(c.see ? { see: c.see } : {}), ...(c.presets ? { presets: c.presets } : {}), ...(c.notes ? { notes: c.notes } : {}) }])),
|
|
214
241
|
patrones,
|
|
215
242
|
documentacion: {
|
|
216
243
|
reglas: `${docs}/AGENTS.md`,
|
|
@@ -220,6 +247,7 @@ function contexto(json) {
|
|
|
220
247
|
ux: `${docs}/docs/designer/ux.md`,
|
|
221
248
|
revision: `${docs}/docs/designer/revision.md`,
|
|
222
249
|
manifiesto: `${docs}/components.manifest.json`,
|
|
250
|
+
paginas: `${docs}/manifest/<dominio>.json`,
|
|
223
251
|
},
|
|
224
252
|
skill: estadoSkill(raizApp()).estado,
|
|
225
253
|
integracion: avisosIntegracion(estado),
|
|
@@ -245,17 +273,20 @@ function contexto(json) {
|
|
|
245
273
|
if (estado.manual.colores.length) L.push(`- Colores escritos a mano (ganan al tema): ${estado.manual.colores.map((d) => d.name).join(', ')}`);
|
|
246
274
|
const sino = (v) => (v ? 'sí' : 'no');
|
|
247
275
|
L.push('', '## Extras', `- Animaciones del tema: ${sino(datos.extras.animaciones)} · Motion: ${sino(datos.extras.motion)} · ECharts: ${sino(datos.extras.echarts)} · TanStack Table: ${sino(datos.extras.tablas)}`);
|
|
248
|
-
L.push('', `## Componentes (${Object.keys(datos.componentes).length}) · import orbital-ds/ui/<nombre
|
|
276
|
+
L.push('', `## Componentes (${Object.keys(datos.componentes).length}) por dominio · import orbital-ds/ui/<nombre> · ficha: orbital-ds components <nombre>`);
|
|
277
|
+
for (const g of Object.keys(manifest.groups ?? {})) {
|
|
278
|
+
const nombres = Object.entries(datos.componentes).filter(([, c]) => c.group === g).map(([n]) => n);
|
|
279
|
+
if (!nombres.length) continue;
|
|
280
|
+
L.push('', `### ${g}`);
|
|
281
|
+
for (const n of nombres) L.push(`- ${n}: ${datos.componentes[n].summary ?? '—'}`);
|
|
282
|
+
}
|
|
249
283
|
const conPresets = Object.entries(datos.componentes).filter(([, c]) => c.presets);
|
|
250
284
|
if (conPresets.length) {
|
|
251
285
|
L.push('', '### Presets (valor por defecto con *)');
|
|
252
286
|
for (const [n, c] of conPresets) L.push(`- ${n}: ${c.presets.values.map((v) => (v === c.presets.default ? `${v}*` : v)).join(' · ')}`);
|
|
253
287
|
}
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
L.push('', '### Notas de uso');
|
|
257
|
-
for (const [n, c] of conNotas) for (const x of c.notes) L.push(`- ${n}: ${x}`);
|
|
258
|
-
}
|
|
288
|
+
// Notas, alternativas y ejemplos de cada uno: en su ficha (orbital-ds components <nombre>), para no cargar las 160 aquí.
|
|
289
|
+
L.push('', 'Antes de usar un componente, lee su ficha: `orbital-ds components <nombre>` (alternativas, props, notas y ejemplos). Buscar por intención: `orbital-ds components --search <texto>`.');
|
|
259
290
|
if (datos.integracion.length) L.push('', '## Avisos de integración', ...datos.integracion.map((a) => `- ${a}`));
|
|
260
291
|
if (patrones.length) L.push('', '## Patrones (docs/designer/patrones.md)', ...patrones.map((p) => `- ${p}`));
|
|
261
292
|
L.push('', '## Documentación', ...Object.entries(datos.documentacion).map(([k, v]) => `- ${k}: ${v}`));
|
|
@@ -269,6 +300,83 @@ function contexto(json) {
|
|
|
269
300
|
console.log(L.join('\n'));
|
|
270
301
|
}
|
|
271
302
|
|
|
303
|
+
/**
|
|
304
|
+
* orbital-ds components [<nombre> | --group <dominio>] [--json]: el catálogo por páginas. Sin argumentos, los dominios;
|
|
305
|
+
* con `--group`, sus componentes con props tipadas, presets y notas; con un nombre, solo ese componente.
|
|
306
|
+
*/
|
|
307
|
+
function ordenComponentes(args) {
|
|
308
|
+
const json = args.includes('--json');
|
|
309
|
+
const gi = args.indexOf('--group');
|
|
310
|
+
const grupo = gi > -1 ? args[gi + 1] : null;
|
|
311
|
+
const nombre = args.includes('--search') ? null : args.find((a, i) => !a.startsWith('--') && args[i - 1] !== '--group');
|
|
312
|
+
const indice = JSON.parse(readFileSync(join(ROOT, 'components.manifest.json'), 'utf8'));
|
|
313
|
+
const salir = (m) => { console.error(m); process.exit(1); };
|
|
314
|
+
const pagina = (g) => {
|
|
315
|
+
const f = join(ROOT, 'manifest', `${g}.json`);
|
|
316
|
+
return existsSync(f) ? JSON.parse(readFileSync(f, 'utf8')) : salir(`No hay página del dominio «${g}». Dominios: ${Object.keys(indice.groups).join(', ')}`);
|
|
317
|
+
};
|
|
318
|
+
const ficha = (n, c) => {
|
|
319
|
+
const L = [`### ${n} · ${c.import}`];
|
|
320
|
+
if (c.summary) L.push(c.summary);
|
|
321
|
+
for (const s of c.see ?? []) L.push(`en su lugar → ${s.component}: ${s.when}`);
|
|
322
|
+
L.push(`exports: ${c.exports.join(', ')}`);
|
|
323
|
+
if (c.presets) L.push(`presets: ${c.presets.values.map((v) => (v === c.presets.default ? `${v}*` : v)).join(' · ')}`);
|
|
324
|
+
for (const [exp, props] of Object.entries(c.props ?? {})) {
|
|
325
|
+
L.push(`props de ${exp}:`);
|
|
326
|
+
for (const [p, d] of Object.entries(props)) L.push(` - ${p}${d.required ? '*' : ''}: ${d.values ? d.values.map((v) => `"${v}"`).join(' | ') : d.type}${d.doc ? ` — ${d.doc}` : ''}`);
|
|
327
|
+
}
|
|
328
|
+
for (const x of c.notes ?? []) L.push(`nota: ${x}`);
|
|
329
|
+
for (const e of c.examples ?? []) L.push(`ejemplo — ${e.title}:`, '```tsx', e.code, '```');
|
|
330
|
+
return L.join('\n');
|
|
331
|
+
};
|
|
332
|
+
// Búsqueda: por nombre, export, resumen, alternativas y notas (sin acentos ni mayúsculas). Para ELEGIR sin leer todo.
|
|
333
|
+
const si = args.indexOf('--search');
|
|
334
|
+
if (si > -1) {
|
|
335
|
+
const llano = (s) => String(s ?? '').normalize('NFD').replace(/\p{M}/gu, '').toLowerCase();
|
|
336
|
+
const terminos = llano(args.slice(si + 1).filter((a) => !a.startsWith('--')).join(' ')).split(/\s+/)
|
|
337
|
+
.filter((t) => t.length > 2 && !/^(?:una?|unos?|las?|los|del|con|para|por|que|toda?s?|the|and|for|with)$/.test(t));
|
|
338
|
+
if (!terminos.length) salir('Uso: orbital-ds components --search <texto>');
|
|
339
|
+
const hits = Object.entries(indice.components)
|
|
340
|
+
.map(([n, c]) => {
|
|
341
|
+
// Raíz de 5 letras al inicio de palabra: «confirmar» encuentra confirm-action y «borrado», «borrar».
|
|
342
|
+
// Sinónimos frecuentes al describir una intención (un agente no sabe qué palabra usa el resumen).
|
|
343
|
+
const SIN = { archivo: 'fichero', fichero: 'archivo', borrar: 'eliminar', eliminar: 'borrar', borrado: 'eliminar', modal: 'dialogo', ventana: 'dialogo', popup: 'dialogo', notificacion: 'aviso', mensaje: 'aviso', grafico: 'chart', grafica: 'chart', desplegable: 'select', cargando: 'carga', spinner: 'carga', kpi: 'cifra' };
|
|
344
|
+
const corta = (t) => t.slice(0, t.length >= 7 ? 5 : t.length >= 5 ? 4 : t.length).replace(/[^a-z0-9]/g, '');
|
|
345
|
+
const raiz = (t) => new RegExp(`(?:^|[^a-z0-9])(?:${[t, SIN[t]].filter(Boolean).map(corta).join('|')})`);
|
|
346
|
+
const nombreExp = llano([n.replace(/-/g, ' '), ...c.exports.map((e) => e.replace(/([a-z])([A-Z])/g, '$1 $2'))].join(' '));
|
|
347
|
+
const resumen = llano(c.summary);
|
|
348
|
+
const resto = llano([...(c.see ?? []).map((s) => s.when), ...(c.notes ?? [])].join(' '));
|
|
349
|
+
let cubiertos = 0;
|
|
350
|
+
const puntos = terminos.reduce((p, t) => {
|
|
351
|
+
const r = raiz(t);
|
|
352
|
+
const q = (r.test(nombreExp) ? 4 : 0) + (r.test(resumen) ? 2 : 0) + (r.test(resto) ? 1 : 0);
|
|
353
|
+
if (q) cubiertos++;
|
|
354
|
+
return p + q;
|
|
355
|
+
}, 0) + (cubiertos > 1 ? cubiertos * 3 : 0);
|
|
356
|
+
return { n, c, puntos };
|
|
357
|
+
})
|
|
358
|
+
.filter((h) => h.puntos > 0)
|
|
359
|
+
.sort((a, b) => b.puntos - a.puntos || a.n.localeCompare(b.n))
|
|
360
|
+
.slice(0, 12);
|
|
361
|
+
if (json) return console.log(JSON.stringify(hits.map(({ n, c }) => ({ name: n, import: c.import, group: c.group, summary: c.summary ?? null })), null, 2));
|
|
362
|
+
if (!hits.length) return console.log('Sin resultados. Prueba otras palabras o `orbital-ds components` para ver los dominios.');
|
|
363
|
+
return console.log([`# Búsqueda: ${terminos.join(' ')} (detalle: orbital-ds components <nombre>)`, '', ...hits.map(({ n, c }) => `- ${n} (${c.group}): ${c.summary ?? '—'}`)].join('\n'));
|
|
364
|
+
}
|
|
365
|
+
if (nombre) {
|
|
366
|
+
const g = indice.components[nombre]?.group ?? salir(`No existe el componente «${nombre}».`);
|
|
367
|
+
const c = pagina(g).components[nombre];
|
|
368
|
+
return json ? console.log(JSON.stringify({ [nombre]: c }, null, 2)) : console.log(ficha(nombre, c));
|
|
369
|
+
}
|
|
370
|
+
if (grupo) {
|
|
371
|
+
const p = pagina(grupo);
|
|
372
|
+
return json ? console.log(JSON.stringify(p, null, 2)) : console.log([`# ${grupo} — ${p.about}`, '', ...Object.entries(p.components).map(([n, c]) => ficha(n, c))].join('\n\n'));
|
|
373
|
+
}
|
|
374
|
+
const cuenta = {};
|
|
375
|
+
for (const c of Object.values(indice.components)) (cuenta[c.group] ??= []).push(c.import.split('/').pop());
|
|
376
|
+
if (json) return console.log(JSON.stringify(Object.fromEntries(Object.entries(indice.groups).map(([g, about]) => [g, { about, components: cuenta[g] ?? [] }])), null, 2));
|
|
377
|
+
console.log(['# Dominios de orbital-ds (orbital-ds components --group <dominio> · orbital-ds components <nombre>)', '', ...Object.entries(indice.groups).map(([g, about]) => `- ${g} (${(cuenta[g] ?? []).length}): ${about}\n ${(cuenta[g] ?? []).join(', ')}`)].join('\n'));
|
|
378
|
+
}
|
|
379
|
+
|
|
272
380
|
/** orbital-ds skill [--check | --print] */
|
|
273
381
|
function ordenSkill(args) {
|
|
274
382
|
if (args.includes('--print')) return console.log(readFileSync(join(ROOT, 'skill', 'SKILL.md'), 'utf8').replaceAll('{{VERSION}}', version));
|
|
@@ -405,6 +513,7 @@ async function menu() {
|
|
|
405
513
|
{ value: 'doctor', label: 'Comprobar mi marca', hint: 'contrato, contraste y pesos' },
|
|
406
514
|
{ value: 'i18n', label: 'Textos en mis idiomas', hint: 'espacio «orbital» de los JSON de idioma' },
|
|
407
515
|
{ value: 'skill', label: 'Diseñador para Claude (skill)', hint: 'instala o refresca .claude/skills/orbital-ds-designer' },
|
|
516
|
+
{ value: 'upgrade', label: 'Qué cambió al actualizar', hint: 'resumen del CHANGELOG desde tu versión anterior' },
|
|
408
517
|
],
|
|
409
518
|
});
|
|
410
519
|
if (p.isCancel(v)) { p.cancel('Nada que hacer.'); return; }
|
|
@@ -413,6 +522,7 @@ async function menu() {
|
|
|
413
522
|
if (v === 'doctor') ejecutar('doctor.mjs', ['--css', resolve('src/brand.css')]);
|
|
414
523
|
if (v === 'i18n') ejecutar('i18n.mjs', []);
|
|
415
524
|
if (v === 'skill') return ordenSkill([]);
|
|
525
|
+
if (v === 'upgrade') return ordenUpgrade([]);
|
|
416
526
|
}
|
|
417
527
|
|
|
418
528
|
// Ayuda de una orden: orbital-ds <orden> --help · orbital-ds help <orden>
|
|
@@ -438,12 +548,18 @@ switch (orden) {
|
|
|
438
548
|
case 'context':
|
|
439
549
|
contexto(resto.includes('--json'));
|
|
440
550
|
break;
|
|
551
|
+
case 'components':
|
|
552
|
+
ordenComponentes(resto);
|
|
553
|
+
break;
|
|
441
554
|
case 'skill':
|
|
442
555
|
ordenSkill(resto);
|
|
443
556
|
break;
|
|
444
557
|
case 'i18n':
|
|
445
558
|
ejecutar('i18n.mjs', resto);
|
|
446
559
|
break;
|
|
560
|
+
case 'upgrade':
|
|
561
|
+
ordenUpgrade(resto);
|
|
562
|
+
break;
|
|
447
563
|
case 'help':
|
|
448
564
|
case '--help':
|
|
449
565
|
case '-h':
|
package/scripts/doctor.mjs
CHANGED
|
@@ -508,7 +508,7 @@ if (cssArgIdx > -1 && process.argv[cssArgIdx + 1]) {
|
|
|
508
508
|
|
|
509
509
|
// 5) valores fijos en componentes
|
|
510
510
|
const NO_HARDCODE = [
|
|
511
|
-
{ re: /#[0-9a-fA-F]{3,8}\b/g, why: 'color hexadecimal'
|
|
511
|
+
{ re: /#[0-9a-fA-F]{3,8}\b/g, why: 'color hexadecimal' },
|
|
512
512
|
{ re: /\b(?:rgb|rgba|hsl|hsla|oklch)\((?!from_)/g, why: 'color literal' },
|
|
513
513
|
{ re: /(?<![\w-])z-(?!0(?![\w-]))\d+(?![\w-])/g, why: 'z-index numérico (usa --ds-z-*)' },
|
|
514
514
|
{ re: /(?<![\w-])duration-(?!0(?![\w-]))\d+(?![\w-])/g, why: 'duración fija (usa --ds-motion-*)' },
|
|
@@ -535,7 +535,18 @@ const uiDir = join(ROOT, 'src/ui');
|
|
|
535
535
|
if (existsSync(uiDir)) {
|
|
536
536
|
for (const f of readdirSync(uiDir).filter((n) => n.endsWith('.tsx'))) {
|
|
537
537
|
const lines = read(join(uiDir, f)).split(/\r?\n/);
|
|
538
|
+
// La ficha (bloque /** … @summary … */) es documentación: sus @example son JSX de la APP (con sus
|
|
539
|
+
// textos), no código del componente. Se salta entera; la comprobación de fichas la valida aparte.
|
|
540
|
+
const ficha = new Set();
|
|
541
|
+
for (let a = 0; a < lines.length; a++) {
|
|
542
|
+
if (!/^\s*\/\*\*/.test(lines[a])) continue;
|
|
543
|
+
let b = a;
|
|
544
|
+
while (b < lines.length && !lines[b].includes('*/')) b++;
|
|
545
|
+
if (lines.slice(a, b + 1).some((l) => /@summary\b/.test(l))) for (let k = a; k <= b; k++) ficha.add(k);
|
|
546
|
+
a = b;
|
|
547
|
+
}
|
|
538
548
|
lines.forEach((line, i) => {
|
|
549
|
+
if (ficha.has(i)) return;
|
|
539
550
|
const code = line.replace(/\/\/.*$/, '');
|
|
540
551
|
for (const rule of NO_HARDCODE) {
|
|
541
552
|
if (rule.skip?.includes(f)) continue;
|
|
@@ -546,6 +557,20 @@ if (existsSync(uiDir)) {
|
|
|
546
557
|
}
|
|
547
558
|
}
|
|
548
559
|
|
|
560
|
+
// 5a) LADOS LÓGICOS: ningún componente se ancla por defecto a un lado físico (left/right), que no se invierte
|
|
561
|
+
// en RTL. Laterales y paneles usan start/end; flotantes (Base UI), inline-start/inline-end.
|
|
562
|
+
const LADO_FISICO = /(?<![\w-])side(?:Prop)?\s*(?:=|:)\s*["'](?:left|right)["']/g;
|
|
563
|
+
const LADO_POR_QUE = 'lado físico que no se invierte en RTL (usa side="start"/"end" en Sidebar, Sheet y DetailPanel, o "inline-start"/"inline-end" en Tooltip, Popover y menús)';
|
|
564
|
+
if (existsSync(uiDir)) {
|
|
565
|
+
for (const f of readdirSync(uiDir).filter((n) => n.endsWith('.tsx'))) {
|
|
566
|
+
read(join(uiDir, f)).split(/\r?\n/).forEach((line, i) => {
|
|
567
|
+
if (/^\s*\*/.test(line)) return; // comentarios y fichas: documentan los valores físicos que existen
|
|
568
|
+
const hits = line.replace(/\/\/.*$/, '').match(LADO_FISICO);
|
|
569
|
+
if (hits) errors.push(`ui/${f}:${i + 1}: ${LADO_POR_QUE} → ${[...new Set(hits)].join(', ')}`);
|
|
570
|
+
});
|
|
571
|
+
}
|
|
572
|
+
}
|
|
573
|
+
|
|
549
574
|
// 5b) UI DE UNA APP (--ui <carpeta>): el código de las vistas no se sale del sistema. Mismas reglas
|
|
550
575
|
// visuales que los componentes (sin las de textos: la app tiene su i18n) y tres propias de una app.
|
|
551
576
|
// Son las comprobaciones mecánicas del diseñador (docs/designer/revision.md, apartado A).
|
|
@@ -560,6 +585,10 @@ if (existsSync(uiDir)) {
|
|
|
560
585
|
{ cadenas: true, re: /(?<=^|\s)![a-z][\w:/()[\]-]*/g, why: '!important en una clase (no se pelea con la librería: ajusta en brand.css o abre un hueco)' },
|
|
561
586
|
{ re: /<(?:button|input|select|textarea)\b(?![^>]*data-slot)/g, why: 'control nativo suelto (usa Button, Input, Select/NativeSelect o Textarea de orbital-ds)' },
|
|
562
587
|
];
|
|
588
|
+
const RETIRADOS = [
|
|
589
|
+
{ error: true, re: /['"]orbital-ds\/ui\/chart['"]/, why: 'orbital-ds/ui/chart (Recharts) se retiró en 0.48.0: usa ChartCard o EChart con un option de orbital-ds/lib/echarts-presets' },
|
|
590
|
+
{ re: /['"]orbital-ds\/ui\/sonner['"]/, why: 'orbital-ds/ui/sonner está obsoleto y se retirará: usa Toaster y toast.add de orbital-ds/ui/toast' },
|
|
591
|
+
];
|
|
563
592
|
const ficheros = [];
|
|
564
593
|
const recorrer = (d) => {
|
|
565
594
|
if (!existsSync(d)) return;
|
|
@@ -581,8 +610,87 @@ if (existsSync(uiDir)) {
|
|
|
581
610
|
const hits = rule.cadenas ? cadenas.flatMap((c) => c.match(rule.re) ?? []) : code.match(rule.re);
|
|
582
611
|
if (hits?.length) errors.push(`ui ${f.replace(process.cwd(), '.').split('\\').join('/')}:${n + 1}: ${rule.why} → ${[...new Set(hits)].join(', ')}`);
|
|
583
612
|
}
|
|
613
|
+
// Lado físico: aviso (puede ser intencionado en una app de un solo idioma), no error.
|
|
614
|
+
const lados = code.match(LADO_FISICO);
|
|
615
|
+
if (lados) warnings.push(`ui ${f.replace(process.cwd(), '.').split('\\').join('/')}:${n + 1}: ${LADO_POR_QUE} → ${[...new Set(lados)].join(', ')}`);
|
|
616
|
+
// Componentes retirados (error: el import ya no existe) u obsoletos (aviso: se retirarán en la próxima mayor).
|
|
617
|
+
for (const r of RETIRADOS) if (r.re.test(code)) (r.error ? errors : warnings).push(`ui ${f.replace(process.cwd(), '.').split('\\').join('/')}:${n + 1}: ${r.why}`);
|
|
584
618
|
});
|
|
585
619
|
}
|
|
620
|
+
// Props de los componentes de orbital-ds usados en las vistas, contra las props tipadas del manifiesto por dominio:
|
|
621
|
+
// `asChild` (no existe: es `render`), un valor fuera de la unión (variant="primary") y un nombre casi igual a uno propio.
|
|
622
|
+
const indiceFile = join(ROOT, 'components.manifest.json');
|
|
623
|
+
if (existsSync(indiceFile)) {
|
|
624
|
+
const indice = JSON.parse(read(indiceFile)).components;
|
|
625
|
+
const paginas = {};
|
|
626
|
+
const propsDe = (modulo, exp) => {
|
|
627
|
+
const c = indice[modulo];
|
|
628
|
+
if (!c) return null;
|
|
629
|
+
const f = join(ROOT, 'manifest', `${c.group}.json`);
|
|
630
|
+
if (!(c.group in paginas)) paginas[c.group] = existsSync(f) ? JSON.parse(read(f)).components : null;
|
|
631
|
+
return paginas[c.group]?.[modulo]?.props?.[exp] ?? null;
|
|
632
|
+
};
|
|
633
|
+
const COMUNES = new Set(['className', 'children', 'key', 'ref', 'style', 'id', 'render', 'title', 'role', 'type', 'name', 'value', 'defaultValue', 'disabled', 'hidden', 'tabIndex', 'lang', 'dir', 'slot', 'form', 'href', 'src', 'alt', 'open', 'defaultOpen', 'checked', 'defaultChecked', 'placeholder', 'required', 'readOnly', 'autoFocus', 'autoComplete', 'htmlFor', 'width', 'height', 'target', 'rel']);
|
|
634
|
+
const distancia = (a, b) => {
|
|
635
|
+
const d = Array.from({ length: a.length + 1 }, (_, x) => [x, ...Array(b.length).fill(0)]);
|
|
636
|
+
for (let y = 1; y <= b.length; y++) d[0][y] = y;
|
|
637
|
+
for (let x = 1; x <= a.length; x++) for (let y = 1; y <= b.length; y++) d[x][y] = Math.min(d[x - 1][y] + 1, d[x][y - 1] + 1, d[x - 1][y - 1] + (a[x - 1] === b[y - 1] ? 0 : 1));
|
|
638
|
+
return d[a.length][b.length];
|
|
639
|
+
};
|
|
640
|
+
/** Atributos de una etiqueta JSX a partir de `pos` (tras el nombre): [{nombre, literal}] y la línea. */
|
|
641
|
+
const atributos = (src, pos) => {
|
|
642
|
+
const out = [];
|
|
643
|
+
let k = pos;
|
|
644
|
+
while (k < src.length) {
|
|
645
|
+
const ch = src[k];
|
|
646
|
+
if (ch === '>' || (ch === '/' && src[k + 1] === '>')) break;
|
|
647
|
+
if (ch === '{') { let n = 1; k++; while (k < src.length && n) { if (src[k] === '{') n++; else if (src[k] === '}') n--; k++; } continue; }
|
|
648
|
+
const m = /^[A-Za-z_][\w:-]*/.exec(src.slice(k, k + 80));
|
|
649
|
+
if (!m) { k++; continue; }
|
|
650
|
+
const nombre = m[0];
|
|
651
|
+
k += nombre.length;
|
|
652
|
+
let literal = null;
|
|
653
|
+
if (src[k] === '=') {
|
|
654
|
+
k++;
|
|
655
|
+
if (src[k] === '"' || src[k] === "'") { const q = src[k]; const e = src.indexOf(q, k + 1); literal = src.slice(k + 1, e); k = e + 1; }
|
|
656
|
+
else if (src[k] === '{') { let n = 1, j = k + 1; while (j < src.length && n) { if (src[j] === '{') n++; else if (src[j] === '}') n--; j++; } const lit = /^\{\s*(?:"([^"]*)"|'([^']*)')\s*\}$/.exec(src.slice(k, j)); if (lit) literal = lit[1] ?? lit[2]; k = j; }
|
|
657
|
+
}
|
|
658
|
+
out.push({ nombre, literal, pos: k });
|
|
659
|
+
}
|
|
660
|
+
return out;
|
|
661
|
+
};
|
|
662
|
+
let revisadas = 0;
|
|
663
|
+
for (const f of ficheros) {
|
|
664
|
+
const src = read(f).replace(/\r\n/g, '\n');
|
|
665
|
+
const locales = {};
|
|
666
|
+
for (const m of src.matchAll(/import\s*\{([^}]*)\}\s*from\s*["']orbital-ds\/ui\/([\w-]+)["']/g)) {
|
|
667
|
+
for (const parte of m[1].split(',')) {
|
|
668
|
+
const [orig, alias] = parte.trim().split(/\s+as\s+/);
|
|
669
|
+
if (orig && /^[A-Z]/.test(orig)) locales[alias ?? orig] = { modulo: m[2], exp: orig };
|
|
670
|
+
}
|
|
671
|
+
}
|
|
672
|
+
const donde = (pos) => `${f.replace(process.cwd(), '.').split('\\').join('/')}:${src.slice(0, pos).split('\n').length}`;
|
|
673
|
+
for (const m of src.matchAll(/<([A-Z]\w*)(?=[\s/>])/g)) {
|
|
674
|
+
const def = locales[m[1]];
|
|
675
|
+
if (!def) continue;
|
|
676
|
+
const props = propsDe(def.modulo, def.exp);
|
|
677
|
+
for (const a of atributos(src, m.index + m[0].length)) {
|
|
678
|
+
if (a.nombre === 'asChild') { errors.push(`ui ${donde(a.pos)}: <${m[1]} asChild> no existe en orbital-ds (Base UI usa la prop \`render\`)`); continue; }
|
|
679
|
+
if (!props) continue;
|
|
680
|
+
const d = props[a.nombre];
|
|
681
|
+
if (d) {
|
|
682
|
+
if (a.literal != null && d.values && !d.values.includes(a.literal)) errors.push(`ui ${donde(a.pos)}: <${m[1]} ${a.nombre}="${a.literal}"> no es válido; valores: ${d.values.join(' | ')}`);
|
|
683
|
+
continue;
|
|
684
|
+
}
|
|
685
|
+
if (COMUNES.has(a.nombre) || /^(?:data-|aria-|on[A-Z])/.test(a.nombre)) continue;
|
|
686
|
+
const cerca = Object.keys(props).find((p) => distancia(p.toLowerCase(), a.nombre.toLowerCase()) <= 2);
|
|
687
|
+
if (cerca) warnings.push(`ui ${donde(a.pos)}: <${m[1]} ${a.nombre}> no es una prop de orbital-ds; ¿querías decir «${cerca}»? (orbital-ds components ${def.modulo})`);
|
|
688
|
+
}
|
|
689
|
+
revisadas++;
|
|
690
|
+
}
|
|
691
|
+
}
|
|
692
|
+
if (revisadas) console.log(`ui: ${revisadas} uso(s) de componentes comprobados contra sus props tipadas`);
|
|
693
|
+
}
|
|
586
694
|
if (ficheros.length) console.log(`ui: ${ficheros.length} fichero(s) revisados en ${process.argv[i + 1]}`);
|
|
587
695
|
}
|
|
588
696
|
}
|
|
@@ -590,9 +698,44 @@ if (existsSync(uiDir)) {
|
|
|
590
698
|
// 6) API pública frente a la huella commiteada
|
|
591
699
|
const manifestPath = join(ROOT, 'components.manifest.json');
|
|
592
700
|
if (existsSync(manifestPath) && existsSync(uiDir)) {
|
|
593
|
-
const { buildManifest } = await import('./manifest.mjs');
|
|
701
|
+
const { buildManifest, GROUPS, buildBrandAllowlist, ALLOWLIST_FILE } = await import('./manifest.mjs');
|
|
702
|
+
// Lista de variables públicas de brand-runtime: debe coincidir con el contrato y la estructura.
|
|
703
|
+
const allowPath = join(ROOT, ALLOWLIST_FILE);
|
|
704
|
+
if (!existsSync(allowPath) || read(allowPath).replace(/\r\n/g, '\n') !== buildBrandAllowlist()) errors.push(`${ALLOWLIST_FILE} desactualizado: ejecuta pnpm manifest`);
|
|
594
705
|
const before = JSON.parse(read(manifestPath)).components;
|
|
595
706
|
const now = buildManifest().components;
|
|
707
|
+
// Dominio: cada componente declara `/** @group <dominio> */` y su demo vive en la sección homónima del escaparate.
|
|
708
|
+
for (const [name, comp] of Object.entries(now)) {
|
|
709
|
+
if (!comp.group || !GROUPS[comp.group]) {
|
|
710
|
+
errors.push(`Dominio: «${name}» necesita \`/** @group <dominio> */\` con uno de: ${Object.keys(GROUPS).join(', ')}`);
|
|
711
|
+
continue;
|
|
712
|
+
}
|
|
713
|
+
const demo = join(ROOT, 'showcase/src/demos', `${name}.tsx`);
|
|
714
|
+
const label = existsSync(demo) ? read(demo).match(/group:\s*"([^"]+)"/)?.[1] : null;
|
|
715
|
+
if (label && label !== GROUPS[comp.group].label) {
|
|
716
|
+
errors.push(`Dominio: «${name}» es «${comp.group}» (${GROUPS[comp.group].label}) pero su demo está en «${label}»`);
|
|
717
|
+
}
|
|
718
|
+
}
|
|
719
|
+
// Ficha para agentes (cabecera JSDoc, ver scripts/manifest.mjs › parseDoc): `@summary` para ELEGIR, `@example` para
|
|
720
|
+
// COPIAR bien y `@see` hacia componentes que existen. Sin ella, un agente adivina entre piezas parecidas.
|
|
721
|
+
for (const [name, comp] of Object.entries(now)) {
|
|
722
|
+
if (!comp.summary) errors.push(`Ficha: «${name}» necesita \`@summary\` (una línea: qué es y cuándo usarlo) en su cabecera`);
|
|
723
|
+
else if (comp.summary.length > 220) warnings.push(`Ficha: el @summary de «${name}» pasa de 220 caracteres; el detalle va en @note`);
|
|
724
|
+
if (!comp.examples?.length) errors.push(`Ficha: «${name}» necesita al menos un \`@example <título>\` con JSX mínimo en su cabecera`);
|
|
725
|
+
const tags = comp.exports.filter((e) => /^[A-Z]/.test(e));
|
|
726
|
+
for (const ex of comp.examples ?? []) {
|
|
727
|
+
if (!ex.title) errors.push(`Ficha: un @example de «${name}» no tiene título (una sola idea: «Acción principal y secundaria»)`);
|
|
728
|
+
if (tags.length && !tags.some((t) => new RegExp(`<${t}[\\s/>.]`).test(ex.code) || ex.code.includes(`${t}(`))) {
|
|
729
|
+
errors.push(`Ficha: el @example «${ex.title}» de «${name}» no usa ninguno de sus exports (${tags.join(', ')})`);
|
|
730
|
+
}
|
|
731
|
+
if (/asChild/.test(ex.code)) errors.push(`Ficha: el @example «${ex.title}» de «${name}» usa asChild (es render)`);
|
|
732
|
+
}
|
|
733
|
+
for (const s of comp.see ?? []) {
|
|
734
|
+
if (!now[s.component]) errors.push(`Ficha: «${name}» remite con @see a «${s.component}», que no existe`);
|
|
735
|
+
else if (s.component === name) errors.push(`Ficha: «${name}» se remite a sí mismo con @see`);
|
|
736
|
+
if (!s.when) warnings.push(`Ficha: el @see ${s.component} de «${name}» no dice cuándo usarlo en su lugar`);
|
|
737
|
+
}
|
|
738
|
+
}
|
|
596
739
|
for (const [name, comp] of Object.entries(before)) {
|
|
597
740
|
if (!now[name]) {
|
|
598
741
|
errors.push(`API pública: desaparece el componente «${name}» (¿versión mayor? regenera con pnpm manifest)`);
|
|
@@ -604,6 +747,14 @@ if (existsSync(manifestPath) && existsSync(uiDir)) {
|
|
|
604
747
|
}
|
|
605
748
|
}
|
|
606
749
|
}
|
|
750
|
+
// Páginas por dominio (`manifest/<dominio>.json`): una por dominio y con los mismos componentes que el código.
|
|
751
|
+
for (const [g, nombres] of Object.entries(Object.groupBy(Object.keys(now), (n) => now[n].group))) {
|
|
752
|
+
const f = join(ROOT, 'manifest', `${g}.json`);
|
|
753
|
+
const pagina = existsSync(f) ? Object.keys(JSON.parse(read(f)).components) : null;
|
|
754
|
+
if (!pagina || pagina.length !== nombres.length || nombres.some((n) => !pagina.includes(n))) {
|
|
755
|
+
errors.push(`Manifiesto: la página «manifest/${g}.json» está ${pagina ? 'desfasada' : 'sin generar'}; ejecuta pnpm manifest`);
|
|
756
|
+
}
|
|
757
|
+
}
|
|
607
758
|
const added = Object.keys(now).filter((n) => !before[n]);
|
|
608
759
|
if (added.length) warnings.push(`API pública: componentes nuevos sin registrar en el manifiesto (${added.join(', ')}); ejecuta pnpm manifest`);
|
|
609
760
|
}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Plugin de ESLint de orbital-ds (config plana, sin dependencias): en la app solo se usan los componentes y las
|
|
3
|
+
* variables del sistema. Es la versión «en el editor» de lo que ya comprueba `orbital-ds doctor --ui`.
|
|
4
|
+
*
|
|
5
|
+
* // eslint.config.js
|
|
6
|
+
* import orbital from "orbital-ds/eslint";
|
|
7
|
+
* export default [orbital.configs.recommended];
|
|
8
|
+
*
|
|
9
|
+
* Reglas:
|
|
10
|
+
* orbital-ds/no-as-child `asChild` no existe (motor Base UI): se usa `render`.
|
|
11
|
+
* orbital-ds/system-styles en `className`, `cn()`, `clsx()` y `cva()`: nada de colores, z-index, duraciones,
|
|
12
|
+
* sombras de la escala Tailwind, paleta Tailwind ni px sueltos; usa tokens (`--ds-*`).
|
|
13
|
+
* orbital-ds/logical-direction clases lógicas (`ms-`, `ps-`, `text-start`…) en lugar de las físicas (RTL).
|
|
14
|
+
* orbital-ds/logical-side `side="left"|"right"` no se invierte en RTL: `start`/`end` (Sidebar, Sheet, DetailPanel)
|
|
15
|
+
* o `inline-start`/`inline-end` (Tooltip, Popover, menús).
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
const STYLE_RULES = [
|
|
19
|
+
[/#[0-9a-fA-F]{3,8}\b/, 'color hexadecimal'],
|
|
20
|
+
[/\b(?:rgb|rgba|hsl|hsla|oklch)\((?!from_)/, 'color literal'],
|
|
21
|
+
[/(?<![\w-])z-(?!0(?![\w-]))\d+(?![\w-])/, 'z-index numérico (usa --ds-z-*)'],
|
|
22
|
+
[/(?<![\w-])duration-(?!0(?![\w-]))\d+(?![\w-])/, 'duración fija (usa --ds-motion-*)'],
|
|
23
|
+
[/(?<![\w-])ease-\[(?:cubic-bezier|steps)\(/, 'curva escrita (usa ease-(--ds-ease-*))'],
|
|
24
|
+
[/(?<![\w-])(?:bg|text|border)-(?:black|white)(?:\/\d+)?(?![\w-])/, 'color fijo (usa un token de color)'],
|
|
25
|
+
[/(?<![\w-])shadow-(?:xs|sm|md|lg|xl|2xl)(?![\w-])/, 'sombra de la escala Tailwind (usa shadow-card/control/raised/overlay/popover)'],
|
|
26
|
+
[/(?<![\w-])text-\[\d+px\]/, 'tamaño de texto en px (usa la escala estándar)'],
|
|
27
|
+
[/@\[\d+px\]/, 'container query en px (usa rem)'],
|
|
28
|
+
[/(?<![\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-])/, 'color de la paleta Tailwind (usa tokens de color)'],
|
|
29
|
+
];
|
|
30
|
+
|
|
31
|
+
const PHYSICAL = /(?<![\w])-?(?:ml|mr|pl|pr)-(?=[\w[(.])|(?<![\w-])text-(?:left|right)(?![\w-])|(?<![\w-])(?:border|rounded)-[lr](?![\w])/;
|
|
32
|
+
|
|
33
|
+
const CLASS_HELPERS = new Set(['cn', 'clsx', 'cva', 'twMerge', 'classNames']);
|
|
34
|
+
|
|
35
|
+
/** ¿Está este literal dentro de un `className` / `class` o de una llamada a `cn()`, `clsx()`…? */
|
|
36
|
+
function inClassContext(node) {
|
|
37
|
+
for (let p = node.parent; p; p = p.parent) {
|
|
38
|
+
if (p.type === 'JSXAttribute') return p.name?.name === 'className' || p.name?.name === 'class';
|
|
39
|
+
if (p.type === 'CallExpression' && p.callee.type === 'Identifier' && CLASS_HELPERS.has(p.callee.name)) return true;
|
|
40
|
+
if (p.type === 'JSXElement' || p.type === 'FunctionDeclaration' || p.type === 'Program') return false;
|
|
41
|
+
}
|
|
42
|
+
return false;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** Regla que busca patrones en los textos de clase. */
|
|
46
|
+
function classRule(patterns, description) {
|
|
47
|
+
return {
|
|
48
|
+
meta: { type: 'problem', docs: { description }, schema: [], messages: { bad: '{{why}}' } },
|
|
49
|
+
create(context) {
|
|
50
|
+
const check = (node, text) => {
|
|
51
|
+
if (!text || !inClassContext(node)) return;
|
|
52
|
+
for (const [re, why] of patterns) if (re.test(text)) context.report({ node, messageId: 'bad', data: { why } });
|
|
53
|
+
};
|
|
54
|
+
return {
|
|
55
|
+
Literal: (n) => typeof n.value === 'string' && check(n, n.value),
|
|
56
|
+
TemplateElement: (n) => check(n, n.value.cooked ?? n.value.raw),
|
|
57
|
+
};
|
|
58
|
+
},
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const rules = {
|
|
63
|
+
'no-as-child': {
|
|
64
|
+
meta: {
|
|
65
|
+
type: 'problem',
|
|
66
|
+
docs: { description: '`asChild` no existe en orbital-ds (Base UI): usa `render`.' },
|
|
67
|
+
schema: [],
|
|
68
|
+
messages: { bad: '`asChild` no existe en orbital-ds: usa la prop `render` (p. ej. render={<a href="…" />}).' },
|
|
69
|
+
},
|
|
70
|
+
create: (context) => ({
|
|
71
|
+
JSXAttribute(n) {
|
|
72
|
+
if (n.name?.name === 'asChild') context.report({ node: n, messageId: 'bad' });
|
|
73
|
+
},
|
|
74
|
+
}),
|
|
75
|
+
},
|
|
76
|
+
'system-styles': classRule(STYLE_RULES, 'Solo variables y utilidades del sistema: sin colores, z-index ni duraciones fijos.'),
|
|
77
|
+
'logical-direction': classRule(
|
|
78
|
+
[[PHYSICAL, 'clase física de dirección (usa ms-/me-/ps-/pe-, text-start/end, border-s/e, rounded-s/e: soporte RTL)']],
|
|
79
|
+
'Clases lógicas de dirección para que la interfaz funcione en RTL.',
|
|
80
|
+
),
|
|
81
|
+
'logical-side': {
|
|
82
|
+
meta: {
|
|
83
|
+
type: 'suggestion',
|
|
84
|
+
docs: { description: 'Lados lógicos para que laterales, paneles y flotantes se inviertan en RTL.' },
|
|
85
|
+
schema: [],
|
|
86
|
+
messages: {
|
|
87
|
+
bad: 'side="{{value}}" es un lado físico y no se invierte en RTL: usa side="{{start}}" (o "{{end}}") para que siga la lectura.',
|
|
88
|
+
},
|
|
89
|
+
},
|
|
90
|
+
create: (context) => ({
|
|
91
|
+
JSXAttribute(n) {
|
|
92
|
+
if (n.name?.name !== 'side' || n.value?.type !== 'Literal' || !['left', 'right'].includes(n.value.value)) return;
|
|
93
|
+
const el = n.parent?.name;
|
|
94
|
+
const tag = el?.type === 'JSXIdentifier' ? el.name : el?.type === 'JSXMemberExpression' ? el.property.name : '';
|
|
95
|
+
if (!/^[A-Z]/.test(tag)) return;
|
|
96
|
+
const panel = /^(?:Sidebar|SheetContent|DetailPanel)$/.test(tag);
|
|
97
|
+
const pick = (a, b) => (n.value.value === 'left' ? a : b);
|
|
98
|
+
context.report({
|
|
99
|
+
node: n,
|
|
100
|
+
messageId: 'bad',
|
|
101
|
+
data: {
|
|
102
|
+
value: n.value.value,
|
|
103
|
+
start: panel ? pick('start', 'end') : pick('inline-start', 'inline-end'),
|
|
104
|
+
end: panel ? pick('end', 'start') : pick('inline-end', 'inline-start'),
|
|
105
|
+
},
|
|
106
|
+
});
|
|
107
|
+
},
|
|
108
|
+
}),
|
|
109
|
+
},
|
|
110
|
+
};
|
|
111
|
+
|
|
112
|
+
const plugin = { meta: { name: 'orbital-ds' }, rules, configs: {} };
|
|
113
|
+
plugin.configs.recommended = {
|
|
114
|
+
files: ['**/*.{jsx,tsx}'],
|
|
115
|
+
plugins: { 'orbital-ds': plugin },
|
|
116
|
+
rules: {
|
|
117
|
+
'orbital-ds/no-as-child': 'error',
|
|
118
|
+
'orbital-ds/system-styles': 'error',
|
|
119
|
+
'orbital-ds/logical-direction': 'warn',
|
|
120
|
+
'orbital-ds/logical-side': 'warn',
|
|
121
|
+
},
|
|
122
|
+
};
|
|
123
|
+
|
|
124
|
+
export default plugin;
|
|
125
|
+
export { rules };
|
package/scripts/i18n.mjs
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
*
|
|
12
12
|
* Qué hace, por cada <idioma>.json de la carpeta:
|
|
13
13
|
* - Añade las claves que FALTEN en su espacio «orbital», con el texto de orbital-ds para ese
|
|
14
|
-
* idioma (en, es, pt-BR incluidos; `es-CO` usa `es`). Nunca pisa lo que la app ya tenga.
|
|
14
|
+
* idioma (en, es, pt-BR, fr, it, de y he incluidos; `es-CO` usa `es`). Nunca pisa lo que la app ya tenga.
|
|
15
15
|
* - Si orbital-ds no trae ese idioma (p. ej. `ru`), pone el inglés y lo lista como
|
|
16
16
|
* PENDIENTE DE TRADUCIR: el agente o la persona lo traduce en el JSON.
|
|
17
17
|
* - Avisa de claves que sobran (orbital-ds ya no las usa).
|