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.
Files changed (321) hide show
  1. package/AGENTS.md +54 -12
  2. package/CHANGELOG.md +458 -0
  3. package/README.md +2 -2
  4. package/components.manifest.json +6630 -3569
  5. package/dist/hooks/use-esc-close-stack.js +38 -0
  6. package/dist/hooks/use-simulated-progress.js +30 -0
  7. package/dist/lib/brand-allowlist.js +703 -0
  8. package/dist/lib/brand-runtime.js +85 -0
  9. package/dist/lib/echarts-presets.js +152 -1
  10. package/dist/lib/echarts-setup.js +2 -0
  11. package/dist/lib/format.js +177 -0
  12. package/dist/lib/i18n.js +35 -2
  13. package/dist/lib/locales/de.js +536 -0
  14. package/dist/lib/locales/fr.js +536 -0
  15. package/dist/lib/locales/he.js +536 -0
  16. package/dist/lib/locales/it.js +536 -0
  17. package/dist/ui/auth-form.js +13 -6
  18. package/dist/ui/ayuda.js +4 -1
  19. package/dist/ui/breadcrumb.js +1 -1
  20. package/dist/ui/calendar.js +3 -0
  21. package/dist/ui/carousel.js +10 -5
  22. package/dist/ui/context-menu.js +3 -3
  23. package/dist/ui/cta-banner.js +63 -0
  24. package/dist/ui/date-time.js +55 -0
  25. package/dist/ui/description-list.js +86 -0
  26. package/dist/ui/detail-panel.js +2 -2
  27. package/dist/ui/dropdown-menu.js +1 -1
  28. package/dist/ui/faq.js +25 -0
  29. package/dist/ui/feature-grid.js +40 -0
  30. package/dist/ui/hero.js +145 -0
  31. package/dist/ui/landing-section.js +59 -0
  32. package/dist/ui/mfa-challenge.js +1 -1
  33. package/dist/ui/next-step-card.js +92 -0
  34. package/dist/ui/page-header.js +20 -11
  35. package/dist/ui/pagination.js +2 -2
  36. package/dist/ui/pricing-table.js +86 -0
  37. package/dist/ui/quantity.js +27 -0
  38. package/dist/ui/sheet.js +6 -2
  39. package/dist/ui/sidebar.js +7 -3
  40. package/dist/ui/tag-input.js +169 -0
  41. package/dist/ui/testimonial.js +61 -0
  42. package/dist/ui/textarea.js +7 -1
  43. package/dist/ui/usage-meter.js +116 -0
  44. package/dist/ui/week-strip.js +2 -2
  45. package/docs/adr/0001-rtl-clases-logicas.md +14 -1
  46. package/docs/designer/flujo.md +1 -1
  47. package/docs/designer/patrones.md +45 -1
  48. package/manifest/actions.json +364 -0
  49. package/manifest/agents.json +399 -0
  50. package/manifest/ai.json +128 -0
  51. package/manifest/auth.json +1547 -0
  52. package/manifest/chat.json +612 -0
  53. package/manifest/content.json +2793 -0
  54. package/manifest/data.json +2802 -0
  55. package/manifest/feedback.json +1005 -0
  56. package/manifest/forms.json +1954 -0
  57. package/manifest/motion.json +196 -0
  58. package/manifest/navigation.json +1792 -0
  59. package/manifest/overlays.json +934 -0
  60. package/package.json +240 -238
  61. package/scripts/cli.mjs +124 -8
  62. package/scripts/doctor.mjs +153 -2
  63. package/scripts/eslint-plugin.mjs +125 -0
  64. package/scripts/i18n.mjs +1 -1
  65. package/scripts/manifest.mjs +179 -7
  66. package/scripts/upgrade.mjs +126 -0
  67. package/skill/SKILL.md +8 -3
  68. package/dist/hooks/use-ds-messages.d.ts +0 -537
  69. package/dist/hooks/use-ds-motion.d.ts +0 -17
  70. package/dist/hooks/use-in-view.d.ts +0 -9
  71. package/dist/hooks/use-mobile.d.ts +0 -3
  72. package/dist/lib/a2ui-catalog.d.ts +0 -42
  73. package/dist/lib/a2ui.d.ts +0 -289
  74. package/dist/lib/ai-events.d.ts +0 -15
  75. package/dist/lib/auth-better-auth.d.ts +0 -29
  76. package/dist/lib/auth-flow.d.ts +0 -85
  77. package/dist/lib/auth-providers.d.ts +0 -194
  78. package/dist/lib/auth.d.ts +0 -68
  79. package/dist/lib/echarts-presets.d.ts +0 -227
  80. package/dist/lib/echarts-server.d.ts +0 -15
  81. package/dist/lib/echarts-setup.d.ts +0 -8
  82. package/dist/lib/echarts-theme.d.ts +0 -36
  83. package/dist/lib/header-control.d.ts +0 -4
  84. package/dist/lib/i18n.d.ts +0 -545
  85. package/dist/lib/image-upload.d.ts +0 -41
  86. package/dist/lib/motion.d.ts +0 -74
  87. package/dist/lib/presets.d.ts +0 -8
  88. package/dist/lib/template-syntax.d.ts +0 -22
  89. package/dist/lib/utils.d.ts +0 -5
  90. package/dist/motion.css +0 -146
  91. package/dist/styles.css +0 -1737
  92. package/dist/themes/chocolate.css +0 -259
  93. package/dist/themes/chocolate.fonts.css +0 -2
  94. package/dist/themes/chocolate.guide.md +0 -30
  95. package/dist/themes/chocolate.meta.json +0 -61
  96. package/dist/themes/chocolate.scoped.css +0 -259
  97. package/dist/themes/chocolate.tokens.json +0 -49
  98. package/dist/themes/fractalia.css +0 -556
  99. package/dist/themes/fractalia.fonts.css +0 -3
  100. package/dist/themes/fractalia.guide.md +0 -86
  101. package/dist/themes/fractalia.meta.json +0 -112
  102. package/dist/themes/fractalia.scoped.css +0 -556
  103. package/dist/themes/fractalia.tokens.json +0 -39
  104. package/dist/themes/friendly.css +0 -375
  105. package/dist/themes/friendly.fonts.css +0 -2
  106. package/dist/themes/friendly.guide.md +0 -38
  107. package/dist/themes/friendly.meta.json +0 -82
  108. package/dist/themes/friendly.scoped.css +0 -375
  109. package/dist/themes/friendly.tokens.json +0 -45
  110. package/dist/themes/lagoon.css +0 -362
  111. package/dist/themes/lagoon.fonts.css +0 -2
  112. package/dist/themes/lagoon.guide.md +0 -47
  113. package/dist/themes/lagoon.meta.json +0 -85
  114. package/dist/themes/lagoon.scoped.css +0 -362
  115. package/dist/themes/lagoon.tokens.json +0 -49
  116. package/dist/themes/liquid.css +0 -510
  117. package/dist/themes/liquid.fonts.css +0 -7
  118. package/dist/themes/liquid.guide.md +0 -82
  119. package/dist/themes/liquid.meta.json +0 -134
  120. package/dist/themes/liquid.scoped.css +0 -510
  121. package/dist/themes/liquid.tokens.json +0 -47
  122. package/dist/themes/matcha.css +0 -259
  123. package/dist/themes/matcha.fonts.css +0 -2
  124. package/dist/themes/matcha.guide.md +0 -30
  125. package/dist/themes/matcha.meta.json +0 -61
  126. package/dist/themes/matcha.scoped.css +0 -259
  127. package/dist/themes/matcha.tokens.json +0 -49
  128. package/dist/themes/qratia.css +0 -264
  129. package/dist/themes/qratia.fonts.css +0 -2
  130. package/dist/themes/qratia.guide.md +0 -34
  131. package/dist/themes/qratia.meta.json +0 -49
  132. package/dist/themes/qratia.scoped.css +0 -264
  133. package/dist/themes/qratia.tokens.json +0 -49
  134. package/dist/themes/stone.css +0 -263
  135. package/dist/themes/stone.fonts.css +0 -2
  136. package/dist/themes/stone.guide.md +0 -30
  137. package/dist/themes/stone.meta.json +0 -47
  138. package/dist/themes/stone.scoped.css +0 -263
  139. package/dist/themes/stone.tokens.json +0 -49
  140. package/dist/themes/tactile.css +0 -596
  141. package/dist/themes/tactile.fonts.css +0 -3
  142. package/dist/themes/tactile.guide.md +0 -82
  143. package/dist/themes/tactile.meta.json +0 -182
  144. package/dist/themes/tactile.scoped.css +0 -596
  145. package/dist/themes/tactile.tokens.json +0 -42
  146. package/dist/themes/twitter.css +0 -364
  147. package/dist/themes/twitter.fonts.css +0 -6
  148. package/dist/themes/twitter.guide.md +0 -35
  149. package/dist/themes/twitter.meta.json +0 -90
  150. package/dist/themes/twitter.scoped.css +0 -364
  151. package/dist/themes/twitter.tokens.json +0 -45
  152. package/dist/themes/y2k.css +0 -259
  153. package/dist/themes/y2k.fonts.css +0 -2
  154. package/dist/themes/y2k.guide.md +0 -30
  155. package/dist/themes/y2k.meta.json +0 -59
  156. package/dist/themes/y2k.scoped.css +0 -259
  157. package/dist/themes/y2k.tokens.json +0 -49
  158. package/dist/themes/zyro.css +0 -442
  159. package/dist/themes/zyro.fonts.css +0 -2
  160. package/dist/themes/zyro.guide.md +0 -33
  161. package/dist/themes/zyro.meta.json +0 -74
  162. package/dist/themes/zyro.scoped.css +0 -442
  163. package/dist/themes/zyro.tokens.json +0 -46
  164. package/dist/ui/a2ui-renderer.d.ts +0 -33
  165. package/dist/ui/accordion.d.ts +0 -9
  166. package/dist/ui/agent-events.d.ts +0 -32
  167. package/dist/ui/ai-tag.d.ts +0 -8
  168. package/dist/ui/alert-dialog.d.ts +0 -23
  169. package/dist/ui/alert.d.ts +0 -13
  170. package/dist/ui/animated-number.d.ts +0 -9
  171. package/dist/ui/app-bar.d.ts +0 -10
  172. package/dist/ui/aspect-ratio.d.ts +0 -7
  173. package/dist/ui/attachment.d.ts +0 -26
  174. package/dist/ui/auth-backdrop.d.ts +0 -20
  175. package/dist/ui/auth-form.d.ts +0 -113
  176. package/dist/ui/auth-layout.d.ts +0 -72
  177. package/dist/ui/auth-parts.d.ts +0 -43
  178. package/dist/ui/auth-status.d.ts +0 -23
  179. package/dist/ui/avatar.d.ts +0 -16
  180. package/dist/ui/ayuda.d.ts +0 -22
  181. package/dist/ui/badge.d.ts +0 -15
  182. package/dist/ui/banner.d.ts +0 -14
  183. package/dist/ui/bottom-nav.d.ts +0 -15
  184. package/dist/ui/breadcrumb.d.ts +0 -12
  185. package/dist/ui/bubble.d.ts +0 -19
  186. package/dist/ui/button-group.d.ts +0 -15
  187. package/dist/ui/button.d.ts +0 -14
  188. package/dist/ui/calendar.d.ts +0 -15
  189. package/dist/ui/card-stack.d.ts +0 -9
  190. package/dist/ui/card.d.ts +0 -28
  191. package/dist/ui/carousel.d.ts +0 -33
  192. package/dist/ui/chain-of-thought.d.ts +0 -19
  193. package/dist/ui/chart-card.d.ts +0 -28
  194. package/dist/ui/chart.d.ts +0 -46
  195. package/dist/ui/chart.js +0 -254
  196. package/dist/ui/chat-composer.d.ts +0 -39
  197. package/dist/ui/checkbox.d.ts +0 -6
  198. package/dist/ui/choice-card.d.ts +0 -16
  199. package/dist/ui/code-block.d.ts +0 -14
  200. package/dist/ui/collapsible.d.ts +0 -8
  201. package/dist/ui/combobox.d.ts +0 -26
  202. package/dist/ui/command-palette.d.ts +0 -36
  203. package/dist/ui/command.d.ts +0 -22
  204. package/dist/ui/confirm-action.d.ts +0 -18
  205. package/dist/ui/confirm-dialog.d.ts +0 -21
  206. package/dist/ui/connected-accounts.d.ts +0 -25
  207. package/dist/ui/content-card.d.ts +0 -52
  208. package/dist/ui/context-menu.d.ts +0 -31
  209. package/dist/ui/conversation-list.d.ts +0 -24
  210. package/dist/ui/copy-button.d.ts +0 -14
  211. package/dist/ui/data-table.d.ts +0 -198
  212. package/dist/ui/date-picker.d.ts +0 -65
  213. package/dist/ui/detail-panel.d.ts +0 -16
  214. package/dist/ui/dialog.d.ts +0 -19
  215. package/dist/ui/direction.d.ts +0 -1
  216. package/dist/ui/dock.d.ts +0 -13
  217. package/dist/ui/drawer.d.ts +0 -18
  218. package/dist/ui/dropdown-menu.d.ts +0 -31
  219. package/dist/ui/dropzone.d.ts +0 -44
  220. package/dist/ui/echart.d.ts +0 -31
  221. package/dist/ui/empty-state.d.ts +0 -26
  222. package/dist/ui/empty.d.ts +0 -15
  223. package/dist/ui/entity-list.d.ts +0 -25
  224. package/dist/ui/error-page.d.ts +0 -28
  225. package/dist/ui/error-state.d.ts +0 -16
  226. package/dist/ui/eyebrow.d.ts +0 -7
  227. package/dist/ui/field.d.ts +0 -28
  228. package/dist/ui/file-upload.d.ts +0 -42
  229. package/dist/ui/filter-bar.d.ts +0 -38
  230. package/dist/ui/form-layout.d.ts +0 -19
  231. package/dist/ui/gauge.d.ts +0 -40
  232. package/dist/ui/generated-image.d.ts +0 -14
  233. package/dist/ui/generated-table.d.ts +0 -11
  234. package/dist/ui/heatmap-grid.d.ts +0 -39
  235. package/dist/ui/hover-card.d.ts +0 -8
  236. package/dist/ui/i18n-provider.d.ts +0 -11
  237. package/dist/ui/icon-tile.d.ts +0 -11
  238. package/dist/ui/input-group.d.ts +0 -22
  239. package/dist/ui/input-otp.d.ts +0 -13
  240. package/dist/ui/input.d.ts +0 -5
  241. package/dist/ui/instruction-editor.d.ts +0 -64
  242. package/dist/ui/item.d.ts +0 -26
  243. package/dist/ui/kbd.d.ts +0 -6
  244. package/dist/ui/label.d.ts +0 -5
  245. package/dist/ui/legend.d.ts +0 -32
  246. package/dist/ui/level-meter.d.ts +0 -16
  247. package/dist/ui/load-more.d.ts +0 -19
  248. package/dist/ui/loading-state.d.ts +0 -14
  249. package/dist/ui/locale-switcher.d.ts +0 -19
  250. package/dist/ui/markdown.d.ts +0 -14
  251. package/dist/ui/marker.d.ts +0 -13
  252. package/dist/ui/media-card.d.ts +0 -13
  253. package/dist/ui/menubar.d.ts +0 -31
  254. package/dist/ui/message-actions.d.ts +0 -12
  255. package/dist/ui/message-scroller.d.ts +0 -16
  256. package/dist/ui/message.d.ts +0 -12
  257. package/dist/ui/mfa-challenge.d.ts +0 -33
  258. package/dist/ui/mfa-setup.d.ts +0 -29
  259. package/dist/ui/mosaic.d.ts +0 -15
  260. package/dist/ui/motion-provider.d.ts +0 -11
  261. package/dist/ui/native-select.d.ts +0 -10
  262. package/dist/ui/navigation-menu.d.ts +0 -15
  263. package/dist/ui/notice-review.d.ts +0 -32
  264. package/dist/ui/notifications.d.ts +0 -81
  265. package/dist/ui/oauth-consent.d.ts +0 -54
  266. package/dist/ui/page-header.d.ts +0 -22
  267. package/dist/ui/page-loader.d.ts +0 -23
  268. package/dist/ui/page-shell.d.ts +0 -8
  269. package/dist/ui/pagination.d.ts +0 -22
  270. package/dist/ui/panel.d.ts +0 -12
  271. package/dist/ui/passkey-list.d.ts +0 -17
  272. package/dist/ui/password-input.d.ts +0 -5
  273. package/dist/ui/password-strength.d.ts +0 -14
  274. package/dist/ui/popover.d.ts +0 -12
  275. package/dist/ui/progress.d.ts +0 -9
  276. package/dist/ui/proportion-bar.d.ts +0 -27
  277. package/dist/ui/questionnaire.d.ts +0 -24
  278. package/dist/ui/radio-group.d.ts +0 -8
  279. package/dist/ui/reasoning.d.ts +0 -10
  280. package/dist/ui/resizable.d.ts +0 -10
  281. package/dist/ui/reveal.d.ts +0 -11
  282. package/dist/ui/scroll-area.d.ts +0 -7
  283. package/dist/ui/search-box.d.ts +0 -32
  284. package/dist/ui/select.d.ts +0 -19
  285. package/dist/ui/separator.d.ts +0 -6
  286. package/dist/ui/session-list.d.ts +0 -19
  287. package/dist/ui/session-timeout.d.ts +0 -13
  288. package/dist/ui/sheet.d.ts +0 -16
  289. package/dist/ui/shield.d.ts +0 -21
  290. package/dist/ui/show-more.d.ts +0 -12
  291. package/dist/ui/sidebar.d.ts +0 -90
  292. package/dist/ui/sign-out-dialog.d.ts +0 -17
  293. package/dist/ui/skeleton.d.ts +0 -10
  294. package/dist/ui/slider.d.ts +0 -23
  295. package/dist/ui/sonner.d.ts +0 -6
  296. package/dist/ui/sparkline.d.ts +0 -26
  297. package/dist/ui/spinner.d.ts +0 -5
  298. package/dist/ui/stat-group.d.ts +0 -8
  299. package/dist/ui/stat.d.ts +0 -90
  300. package/dist/ui/status-badge.d.ts +0 -39
  301. package/dist/ui/status-hero.d.ts +0 -12
  302. package/dist/ui/step-dots.d.ts +0 -10
  303. package/dist/ui/step-flow.d.ts +0 -48
  304. package/dist/ui/step-ring.d.ts +0 -12
  305. package/dist/ui/stepper.d.ts +0 -20
  306. package/dist/ui/suggestions.d.ts +0 -8
  307. package/dist/ui/switch.d.ts +0 -8
  308. package/dist/ui/table.d.ts +0 -12
  309. package/dist/ui/tabs.d.ts +0 -14
  310. package/dist/ui/task-loader.d.ts +0 -14
  311. package/dist/ui/task-progress.d.ts +0 -18
  312. package/dist/ui/textarea.d.ts +0 -11
  313. package/dist/ui/theme-toggle.d.ts +0 -14
  314. package/dist/ui/timeline.d.ts +0 -29
  315. package/dist/ui/toast.d.ts +0 -19
  316. package/dist/ui/toggle-group.d.ts +0 -14
  317. package/dist/ui/toggle.d.ts +0 -12
  318. package/dist/ui/tool-call.d.ts +0 -15
  319. package/dist/ui/tooltip.d.ts +0 -9
  320. package/dist/ui/week-strip.d.ts +0 -12
  321. 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
- help esta ayuda · orbital-ds help <orden> para el detalle
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>`, Object.keys(datos.componentes).join(', '));
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
- const conNotas = Object.entries(datos.componentes).filter(([, c]) => c.notes);
255
- if (conNotas.length) {
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':
@@ -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', skip: ['chart.tsx'] },
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).