orbital-ds 0.44.1 → 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 (310) hide show
  1. package/AGENTS.md +29 -6
  2. package/CHANGELOG.md +458 -0
  3. package/README.md +2 -2
  4. package/components.manifest.json +209 -48
  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/i18n.js +3 -0
  12. package/dist/lib/locales/de.js +1 -0
  13. package/dist/lib/locales/fr.js +1 -0
  14. package/dist/lib/locales/he.js +1 -0
  15. package/dist/lib/locales/it.js +1 -0
  16. package/dist/ui/context-menu.js +2 -2
  17. package/dist/ui/cta-banner.js +63 -0
  18. package/dist/ui/detail-panel.js +2 -2
  19. package/dist/ui/faq.js +25 -0
  20. package/dist/ui/feature-grid.js +40 -0
  21. package/dist/ui/landing-section.js +59 -0
  22. package/dist/ui/pricing-table.js +86 -0
  23. package/dist/ui/sheet.js +1 -1
  24. package/dist/ui/testimonial.js +61 -0
  25. package/docs/designer/patrones.md +7 -2
  26. package/manifest/actions.json +1 -1
  27. package/manifest/agents.json +1 -1
  28. package/manifest/ai.json +1 -1
  29. package/manifest/auth.json +1 -1
  30. package/manifest/chat.json +1 -1
  31. package/manifest/content.json +496 -1
  32. package/manifest/data.json +1 -103
  33. package/manifest/feedback.json +6 -6
  34. package/manifest/forms.json +1 -1
  35. package/manifest/motion.json +3 -3
  36. package/manifest/navigation.json +3 -3
  37. package/manifest/overlays.json +14 -11
  38. package/package.json +6 -8
  39. package/scripts/cli.mjs +19 -0
  40. package/scripts/doctor.mjs +28 -2
  41. package/scripts/eslint-plugin.mjs +32 -0
  42. package/scripts/manifest.mjs +20 -0
  43. package/scripts/upgrade.mjs +126 -0
  44. package/dist/auth-form-B1hgbXkI.d.ts +0 -144
  45. package/dist/hooks/use-ds-messages.d.ts +0 -544
  46. package/dist/hooks/use-ds-motion.d.ts +0 -17
  47. package/dist/hooks/use-in-view.d.ts +0 -9
  48. package/dist/hooks/use-mobile.d.ts +0 -3
  49. package/dist/lib/a2ui-catalog.d.ts +0 -42
  50. package/dist/lib/a2ui.d.ts +0 -289
  51. package/dist/lib/ai-events.d.ts +0 -15
  52. package/dist/lib/auth-better-auth.d.ts +0 -29
  53. package/dist/lib/auth-flow.d.ts +0 -85
  54. package/dist/lib/auth-providers.d.ts +0 -194
  55. package/dist/lib/auth.d.ts +0 -68
  56. package/dist/lib/echarts-presets.d.ts +0 -227
  57. package/dist/lib/echarts-server.d.ts +0 -15
  58. package/dist/lib/echarts-setup.d.ts +0 -8
  59. package/dist/lib/echarts-theme.d.ts +0 -36
  60. package/dist/lib/format.d.ts +0 -57
  61. package/dist/lib/header-control.d.ts +0 -4
  62. package/dist/lib/i18n.d.ts +0 -557
  63. package/dist/lib/image-upload.d.ts +0 -41
  64. package/dist/lib/locales/de.d.ts +0 -7
  65. package/dist/lib/locales/fr.d.ts +0 -7
  66. package/dist/lib/locales/he.d.ts +0 -7
  67. package/dist/lib/locales/it.d.ts +0 -7
  68. package/dist/lib/motion.d.ts +0 -74
  69. package/dist/lib/presets.d.ts +0 -8
  70. package/dist/lib/template-syntax.d.ts +0 -22
  71. package/dist/lib/utils.d.ts +0 -5
  72. package/dist/motion.css +0 -146
  73. package/dist/styles.css +0 -1775
  74. package/dist/themes/chocolate.css +0 -259
  75. package/dist/themes/chocolate.fonts.css +0 -2
  76. package/dist/themes/chocolate.guide.md +0 -30
  77. package/dist/themes/chocolate.meta.json +0 -61
  78. package/dist/themes/chocolate.scoped.css +0 -259
  79. package/dist/themes/chocolate.tokens.json +0 -49
  80. package/dist/themes/fractalia.css +0 -556
  81. package/dist/themes/fractalia.fonts.css +0 -3
  82. package/dist/themes/fractalia.guide.md +0 -86
  83. package/dist/themes/fractalia.meta.json +0 -112
  84. package/dist/themes/fractalia.scoped.css +0 -556
  85. package/dist/themes/fractalia.tokens.json +0 -39
  86. package/dist/themes/friendly.css +0 -375
  87. package/dist/themes/friendly.fonts.css +0 -2
  88. package/dist/themes/friendly.guide.md +0 -38
  89. package/dist/themes/friendly.meta.json +0 -82
  90. package/dist/themes/friendly.scoped.css +0 -375
  91. package/dist/themes/friendly.tokens.json +0 -45
  92. package/dist/themes/lagoon.css +0 -362
  93. package/dist/themes/lagoon.fonts.css +0 -2
  94. package/dist/themes/lagoon.guide.md +0 -47
  95. package/dist/themes/lagoon.meta.json +0 -85
  96. package/dist/themes/lagoon.scoped.css +0 -362
  97. package/dist/themes/lagoon.tokens.json +0 -49
  98. package/dist/themes/liquid.css +0 -510
  99. package/dist/themes/liquid.fonts.css +0 -7
  100. package/dist/themes/liquid.guide.md +0 -82
  101. package/dist/themes/liquid.meta.json +0 -134
  102. package/dist/themes/liquid.scoped.css +0 -510
  103. package/dist/themes/liquid.tokens.json +0 -47
  104. package/dist/themes/matcha.css +0 -259
  105. package/dist/themes/matcha.fonts.css +0 -2
  106. package/dist/themes/matcha.guide.md +0 -30
  107. package/dist/themes/matcha.meta.json +0 -61
  108. package/dist/themes/matcha.scoped.css +0 -259
  109. package/dist/themes/matcha.tokens.json +0 -49
  110. package/dist/themes/qratia.css +0 -264
  111. package/dist/themes/qratia.fonts.css +0 -2
  112. package/dist/themes/qratia.guide.md +0 -34
  113. package/dist/themes/qratia.meta.json +0 -49
  114. package/dist/themes/qratia.scoped.css +0 -264
  115. package/dist/themes/qratia.tokens.json +0 -49
  116. package/dist/themes/stone.css +0 -263
  117. package/dist/themes/stone.fonts.css +0 -2
  118. package/dist/themes/stone.guide.md +0 -30
  119. package/dist/themes/stone.meta.json +0 -47
  120. package/dist/themes/stone.scoped.css +0 -263
  121. package/dist/themes/stone.tokens.json +0 -49
  122. package/dist/themes/tactile.css +0 -596
  123. package/dist/themes/tactile.fonts.css +0 -3
  124. package/dist/themes/tactile.guide.md +0 -82
  125. package/dist/themes/tactile.meta.json +0 -182
  126. package/dist/themes/tactile.scoped.css +0 -596
  127. package/dist/themes/tactile.tokens.json +0 -42
  128. package/dist/themes/twitter.css +0 -364
  129. package/dist/themes/twitter.fonts.css +0 -6
  130. package/dist/themes/twitter.guide.md +0 -35
  131. package/dist/themes/twitter.meta.json +0 -90
  132. package/dist/themes/twitter.scoped.css +0 -364
  133. package/dist/themes/twitter.tokens.json +0 -45
  134. package/dist/themes/y2k.css +0 -259
  135. package/dist/themes/y2k.fonts.css +0 -2
  136. package/dist/themes/y2k.guide.md +0 -30
  137. package/dist/themes/y2k.meta.json +0 -59
  138. package/dist/themes/y2k.scoped.css +0 -259
  139. package/dist/themes/y2k.tokens.json +0 -49
  140. package/dist/themes/zyro.css +0 -442
  141. package/dist/themes/zyro.fonts.css +0 -2
  142. package/dist/themes/zyro.guide.md +0 -33
  143. package/dist/themes/zyro.meta.json +0 -74
  144. package/dist/themes/zyro.scoped.css +0 -442
  145. package/dist/themes/zyro.tokens.json +0 -46
  146. package/dist/ui/a2ui-renderer.d.ts +0 -44
  147. package/dist/ui/accordion.d.ts +0 -9
  148. package/dist/ui/agent-events.d.ts +0 -49
  149. package/dist/ui/ai-tag.d.ts +0 -24
  150. package/dist/ui/alert-dialog.d.ts +0 -60
  151. package/dist/ui/alert.d.ts +0 -13
  152. package/dist/ui/animated-number.d.ts +0 -20
  153. package/dist/ui/app-bar.d.ts +0 -32
  154. package/dist/ui/aspect-ratio.d.ts +0 -7
  155. package/dist/ui/attachment.d.ts +0 -26
  156. package/dist/ui/auth-backdrop.d.ts +0 -37
  157. package/dist/ui/auth-form.d.ts +0 -4
  158. package/dist/ui/auth-layout.d.ts +0 -110
  159. package/dist/ui/auth-parts.d.ts +0 -43
  160. package/dist/ui/auth-status.d.ts +0 -23
  161. package/dist/ui/avatar.d.ts +0 -43
  162. package/dist/ui/ayuda.d.ts +0 -22
  163. package/dist/ui/badge.d.ts +0 -15
  164. package/dist/ui/banner.d.ts +0 -14
  165. package/dist/ui/bottom-nav.d.ts +0 -37
  166. package/dist/ui/breadcrumb.d.ts +0 -34
  167. package/dist/ui/bubble.d.ts +0 -19
  168. package/dist/ui/button-group.d.ts +0 -15
  169. package/dist/ui/button.d.ts +0 -14
  170. package/dist/ui/calendar.d.ts +0 -28
  171. package/dist/ui/card-stack.d.ts +0 -36
  172. package/dist/ui/card.d.ts +0 -61
  173. package/dist/ui/carousel.d.ts +0 -68
  174. package/dist/ui/chain-of-thought.d.ts +0 -34
  175. package/dist/ui/chart-card.d.ts +0 -47
  176. package/dist/ui/chart.d.ts +0 -65
  177. package/dist/ui/chart.js +0 -254
  178. package/dist/ui/chat-composer.d.ts +0 -58
  179. package/dist/ui/checkbox.d.ts +0 -6
  180. package/dist/ui/choice-card.d.ts +0 -49
  181. package/dist/ui/code-block.d.ts +0 -29
  182. package/dist/ui/collapsible.d.ts +0 -8
  183. package/dist/ui/combobox.d.ts +0 -74
  184. package/dist/ui/command-palette.d.ts +0 -54
  185. package/dist/ui/command.d.ts +0 -56
  186. package/dist/ui/confirm-action.d.ts +0 -48
  187. package/dist/ui/confirm-dialog.d.ts +0 -44
  188. package/dist/ui/connected-accounts.d.ts +0 -25
  189. package/dist/ui/content-card.d.ts +0 -66
  190. package/dist/ui/context-menu.d.ts +0 -66
  191. package/dist/ui/conversation-list.d.ts +0 -44
  192. package/dist/ui/copy-button.d.ts +0 -25
  193. package/dist/ui/data-table.d.ts +0 -198
  194. package/dist/ui/date-picker.d.ts +0 -65
  195. package/dist/ui/date-time.d.ts +0 -40
  196. package/dist/ui/description-list.d.ts +0 -49
  197. package/dist/ui/detail-panel.d.ts +0 -38
  198. package/dist/ui/dialog.d.ts +0 -54
  199. package/dist/ui/direction.d.ts +0 -1
  200. package/dist/ui/dock.d.ts +0 -30
  201. package/dist/ui/drawer.d.ts +0 -59
  202. package/dist/ui/dropdown-menu.d.ts +0 -63
  203. package/dist/ui/dropzone.d.ts +0 -44
  204. package/dist/ui/echart.d.ts +0 -46
  205. package/dist/ui/empty-state.d.ts +0 -26
  206. package/dist/ui/empty.d.ts +0 -15
  207. package/dist/ui/entity-list.d.ts +0 -57
  208. package/dist/ui/error-page.d.ts +0 -28
  209. package/dist/ui/error-state.d.ts +0 -16
  210. package/dist/ui/eyebrow.d.ts +0 -7
  211. package/dist/ui/field.d.ts +0 -28
  212. package/dist/ui/file-upload.d.ts +0 -42
  213. package/dist/ui/filter-bar.d.ts +0 -38
  214. package/dist/ui/form-layout.d.ts +0 -43
  215. package/dist/ui/gauge.d.ts +0 -66
  216. package/dist/ui/generated-image.d.ts +0 -33
  217. package/dist/ui/generated-table.d.ts +0 -29
  218. package/dist/ui/heatmap-grid.d.ts +0 -59
  219. package/dist/ui/hero.d.ts +0 -58
  220. package/dist/ui/hover-card.d.ts +0 -8
  221. package/dist/ui/i18n-provider.d.ts +0 -27
  222. package/dist/ui/icon-tile.d.ts +0 -11
  223. package/dist/ui/input-group.d.ts +0 -22
  224. package/dist/ui/input-otp.d.ts +0 -36
  225. package/dist/ui/input.d.ts +0 -21
  226. package/dist/ui/instruction-editor.d.ts +0 -81
  227. package/dist/ui/item.d.ts +0 -26
  228. package/dist/ui/kbd.d.ts +0 -6
  229. package/dist/ui/label.d.ts +0 -22
  230. package/dist/ui/legend.d.ts +0 -57
  231. package/dist/ui/level-meter.d.ts +0 -28
  232. package/dist/ui/load-more.d.ts +0 -36
  233. package/dist/ui/loading-state.d.ts +0 -26
  234. package/dist/ui/locale-switcher.d.ts +0 -19
  235. package/dist/ui/markdown.d.ts +0 -29
  236. package/dist/ui/marker.d.ts +0 -13
  237. package/dist/ui/media-card.d.ts +0 -29
  238. package/dist/ui/menubar.d.ts +0 -70
  239. package/dist/ui/message-actions.d.ts +0 -21
  240. package/dist/ui/message-scroller.d.ts +0 -46
  241. package/dist/ui/message.d.ts +0 -45
  242. package/dist/ui/mfa-challenge.d.ts +0 -4
  243. package/dist/ui/mfa-setup.d.ts +0 -29
  244. package/dist/ui/mosaic.d.ts +0 -38
  245. package/dist/ui/motion-provider.d.ts +0 -28
  246. package/dist/ui/native-select.d.ts +0 -32
  247. package/dist/ui/navigation-menu.d.ts +0 -15
  248. package/dist/ui/next-step-card.d.ts +0 -55
  249. package/dist/ui/notice-review.d.ts +0 -64
  250. package/dist/ui/notifications.d.ts +0 -81
  251. package/dist/ui/oauth-consent.d.ts +0 -54
  252. package/dist/ui/page-header.d.ts +0 -64
  253. package/dist/ui/page-loader.d.ts +0 -40
  254. package/dist/ui/page-shell.d.ts +0 -25
  255. package/dist/ui/pagination.d.ts +0 -42
  256. package/dist/ui/panel.d.ts +0 -12
  257. package/dist/ui/passkey-list.d.ts +0 -17
  258. package/dist/ui/password-input.d.ts +0 -5
  259. package/dist/ui/password-strength.d.ts +0 -28
  260. package/dist/ui/popover.d.ts +0 -44
  261. package/dist/ui/progress.d.ts +0 -9
  262. package/dist/ui/proportion-bar.d.ts +0 -52
  263. package/dist/ui/quantity.d.ts +0 -25
  264. package/dist/ui/questionnaire.d.ts +0 -62
  265. package/dist/ui/radio-group.d.ts +0 -8
  266. package/dist/ui/reasoning.d.ts +0 -24
  267. package/dist/ui/resizable.d.ts +0 -10
  268. package/dist/ui/reveal.d.ts +0 -28
  269. package/dist/ui/scroll-area.d.ts +0 -7
  270. package/dist/ui/search-box.d.ts +0 -32
  271. package/dist/ui/select.d.ts +0 -19
  272. package/dist/ui/separator.d.ts +0 -6
  273. package/dist/ui/session-list.d.ts +0 -19
  274. package/dist/ui/session-timeout.d.ts +0 -13
  275. package/dist/ui/sheet.d.ts +0 -53
  276. package/dist/ui/shield.d.ts +0 -35
  277. package/dist/ui/show-more.d.ts +0 -26
  278. package/dist/ui/sidebar.d.ts +0 -92
  279. package/dist/ui/sign-out-dialog.d.ts +0 -17
  280. package/dist/ui/skeleton.d.ts +0 -10
  281. package/dist/ui/slider.d.ts +0 -23
  282. package/dist/ui/sonner.d.ts +0 -6
  283. package/dist/ui/sparkline.d.ts +0 -26
  284. package/dist/ui/spinner.d.ts +0 -5
  285. package/dist/ui/stat-group.d.ts +0 -40
  286. package/dist/ui/stat.d.ts +0 -90
  287. package/dist/ui/status-badge.d.ts +0 -39
  288. package/dist/ui/status-hero.d.ts +0 -30
  289. package/dist/ui/step-dots.d.ts +0 -22
  290. package/dist/ui/step-flow.d.ts +0 -48
  291. package/dist/ui/step-ring.d.ts +0 -26
  292. package/dist/ui/stepper.d.ts +0 -20
  293. package/dist/ui/suggestions.d.ts +0 -17
  294. package/dist/ui/switch.d.ts +0 -8
  295. package/dist/ui/table.d.ts +0 -38
  296. package/dist/ui/tabs.d.ts +0 -14
  297. package/dist/ui/tag-input.d.ts +0 -21
  298. package/dist/ui/task-loader.d.ts +0 -29
  299. package/dist/ui/task-progress.d.ts +0 -32
  300. package/dist/ui/textarea.d.ts +0 -32
  301. package/dist/ui/theme-toggle.d.ts +0 -14
  302. package/dist/ui/timeline.d.ts +0 -55
  303. package/dist/ui/toast.d.ts +0 -19
  304. package/dist/ui/toggle-group.d.ts +0 -38
  305. package/dist/ui/toggle.d.ts +0 -12
  306. package/dist/ui/tool-call.d.ts +0 -27
  307. package/dist/ui/tooltip.d.ts +0 -9
  308. package/dist/ui/usage-meter.d.ts +0 -42
  309. package/dist/ui/week-strip.d.ts +0 -23
  310. package/dist/ui/workflow-run.d.ts +0 -51
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.48.0",
4
4
  "engine": "@base-ui/react",
5
5
  "groups": {
6
6
  "actions": "Botones y acciones sueltas.",
@@ -1162,10 +1162,6 @@
1162
1162
  "component": "echart",
1163
1163
  "when": "solo el lienzo del gráfico, sin tarjeta ni estados, dentro de tu propia maqueta"
1164
1164
  },
1165
- {
1166
- "component": "chart",
1167
- "when": "gráficos Recharts heredados: solo compatibilidad, nunca para pantallas nuevas"
1168
- },
1169
1165
  {
1170
1166
  "component": "stat",
1171
1167
  "when": "una cifra clave con su tendencia mínima (Sparkline), no un gráfico completo"
@@ -1199,47 +1195,6 @@
1199
1195
  "Varios gráficos juntos: dentro de Mosaic (bento: el principal primero y en `focus`). Para informes en servidor usa renderEChartToSvg con el mismo option."
1200
1196
  ]
1201
1197
  },
1202
- "chart": {
1203
- "import": "orbital-ds/ui/chart",
1204
- "group": "data",
1205
- "summary": "Contenedor de Recharts con la paleta del tema, tooltip y leyenda. SOLO por compatibilidad (sin funciones nuevas): para cualquier gráfico nuevo usa ChartCard o EChart.",
1206
- "see": [
1207
- {
1208
- "component": "chart-card",
1209
- "when": "gráfico nuevo en un panel: tarjeta con estados y descarga (ECharts)"
1210
- },
1211
- {
1212
- "component": "echart",
1213
- "when": "gráfico nuevo dentro de tu propia maqueta (ECharts, colores del tema)"
1214
- },
1215
- {
1216
- "component": "sparkline",
1217
- "when": "tendencia mínima junto a una cifra, sin librería de gráficos"
1218
- }
1219
- ],
1220
- "exports": [
1221
- "ChartContainer",
1222
- "ChartLegend",
1223
- "ChartLegendContent",
1224
- "ChartStyle",
1225
- "ChartTooltip",
1226
- "ChartTooltipContent"
1227
- ],
1228
- "slots": [
1229
- "chart",
1230
- "chart-legend",
1231
- "chart-legend-item",
1232
- "chart-tooltip",
1233
- "chart-tooltip-item"
1234
- ],
1235
- "optionalPeers": [
1236
- "recharts"
1237
- ],
1238
- "notes": [
1239
- "Solo compatibilidad con Recharts: no recibe funciones nuevas. En pantallas nuevas usa ChartCard (o EChart) con un option de orbital-ds/lib/echarts-presets.",
1240
- "Los colores de cada serie salen de las variables del tema (var(--chart-1) … var(--chart-5)) en el config; nunca un color escrito."
1241
- ]
1242
- },
1243
1198
  "chat-composer": {
1244
1199
  "import": "orbital-ds/ui/chat-composer",
1245
1200
  "group": "chat",
@@ -1847,6 +1802,40 @@
1847
1802
  "El dato va limpio, sin instrucciones dentro del texto («Copia esta IP…»): el botón ya lo dice."
1848
1803
  ]
1849
1804
  },
1805
+ "cta-banner": {
1806
+ "import": "orbital-ds/ui/cta-banner",
1807
+ "group": "content",
1808
+ "summary": "Llamada final a la acción de una web pública: bloque con superficie propia, título, una frase y uno o dos botones, al pie de la portada.",
1809
+ "see": [
1810
+ {
1811
+ "component": "hero",
1812
+ "when": "la portada de arriba del todo"
1813
+ },
1814
+ {
1815
+ "component": "banner",
1816
+ "when": "aviso de sistema que afecta a toda la página, no una invitación"
1817
+ },
1818
+ {
1819
+ "component": "next-step-card",
1820
+ "when": "siguiente paso de un servicio DENTRO de la app"
1821
+ }
1822
+ ],
1823
+ "exports": [
1824
+ "CtaBanner",
1825
+ "type CtaBannerProps"
1826
+ ],
1827
+ "slots": [
1828
+ "cta-banner",
1829
+ "cta-banner-actions",
1830
+ "cta-banner-description",
1831
+ "cta-banner-title"
1832
+ ],
1833
+ "optionalPeers": [],
1834
+ "notes": [
1835
+ "Una por página, al final, repitiendo la acción principal del Hero con otras palabras; nada de enlaces sueltos alrededor.",
1836
+ "Para darle color de marca, la app ajusta `--ds-cta-bg`, `--ds-cta-fg` y `--ds-cta-description-fg` en su brand.css (y vuelve a pasar el doctor por el contraste); con `backdrop` de imagen, usa `backdropGlass` para que el texto se lea."
1837
+ ]
1838
+ },
1850
1839
  "data-table": {
1851
1840
  "import": "orbital-ds/ui/data-table",
1852
1841
  "group": "data",
@@ -2599,6 +2588,69 @@
2599
2588
  "No sustituye a un encabezado: es contexto y el título sigue siendo un h1–h3. Con `render` adopta la etiqueta semántica (dt, span)."
2600
2589
  ]
2601
2590
  },
2591
+ "faq": {
2592
+ "import": "orbital-ds/ui/faq",
2593
+ "group": "content",
2594
+ "summary": "Preguntas frecuentes de una web pública o de una ayuda: lista desplegable de pregunta y respuesta, con datos estructurados opcionales para buscadores.",
2595
+ "see": [
2596
+ {
2597
+ "component": "accordion",
2598
+ "when": "paneles desplegables de cualquier contenido (ajustes, detalles)"
2599
+ },
2600
+ {
2601
+ "component": "landing-section",
2602
+ "when": "la sección con título que la envuelve en una portada"
2603
+ }
2604
+ ],
2605
+ "exports": [
2606
+ "Faq",
2607
+ "type FaqItem",
2608
+ "type FaqProps"
2609
+ ],
2610
+ "slots": [
2611
+ "faq"
2612
+ ],
2613
+ "optionalPeers": [],
2614
+ "notes": [
2615
+ "Preguntas reales que hace la gente (soporte, ventas), redactadas como las haría; respuestas de una o dos frases con enlace al detalle si hace falta.",
2616
+ "Entre 4 y 8 preguntas; si hay más, agrúpalas por tema con un título (LandingSection o SectionHeader) por grupo.",
2617
+ "`structuredData` solo en la página pública donde se leen esas preguntas, una vez por página."
2618
+ ]
2619
+ },
2620
+ "feature-grid": {
2621
+ "import": "orbital-ds/ui/feature-grid",
2622
+ "group": "content",
2623
+ "summary": "Rejilla de características o ventajas de un producto (icono, título y una frase), para la sección «qué hace» de una web pública.",
2624
+ "see": [
2625
+ {
2626
+ "component": "content-card",
2627
+ "when": "tarjetas con imagen o enlace a otra página"
2628
+ },
2629
+ {
2630
+ "component": "mosaic",
2631
+ "when": "rejilla bento de bloques de distinto tamaño"
2632
+ }
2633
+ ],
2634
+ "exports": [
2635
+ "Feature",
2636
+ "FeatureGrid",
2637
+ "type FeatureGridProps",
2638
+ "type FeatureProps"
2639
+ ],
2640
+ "slots": [
2641
+ "feature",
2642
+ "feature-description",
2643
+ "feature-grid",
2644
+ "feature-icon",
2645
+ "feature-title"
2646
+ ],
2647
+ "optionalPeers": [],
2648
+ "notes": [
2649
+ "Entre 3 y 6 características, cada una con un beneficio concreto en el título y una sola frase. Más de 6 cansa: agrupa o enlaza a una página de detalle.",
2650
+ "Iconos del mismo trazo y tamaño (lucide); no repitas el mismo icono.",
2651
+ "`variant=\"card\"` cuando la sección va sobre un fondo con dibujo o para separar bloques densos; `plain` en el resto."
2652
+ ]
2653
+ },
2602
2654
  "field": {
2603
2655
  "import": "orbital-ds/ui/field",
2604
2656
  "group": "forms",
@@ -3321,6 +3373,40 @@
3321
3373
  "Asocia con `htmlFor` o envolviendo el control; en un formulario usa FieldLabel dentro de Field."
3322
3374
  ]
3323
3375
  },
3376
+ "landing-section": {
3377
+ "import": "orbital-ds/ui/landing-section",
3378
+ "group": "content",
3379
+ "summary": "Sección de una web pública bajo el Hero: antetítulo, título, texto y el bloque que la ocupa (características, precios, testimonios, preguntas frecuentes).",
3380
+ "see": [
3381
+ {
3382
+ "component": "hero",
3383
+ "when": "la portada de arriba del todo, una por página"
3384
+ },
3385
+ {
3386
+ "component": "page-header",
3387
+ "when": "cabecera de una vista de trabajo dentro de la app"
3388
+ }
3389
+ ],
3390
+ "exports": [
3391
+ "LandingSection",
3392
+ "type LandingSectionProps"
3393
+ ],
3394
+ "slots": [
3395
+ "landing-section",
3396
+ "landing-section-actions",
3397
+ "landing-section-body",
3398
+ "landing-section-description",
3399
+ "landing-section-eyebrow",
3400
+ "landing-section-header",
3401
+ "landing-section-title"
3402
+ ],
3403
+ "optionalPeers": [],
3404
+ "notes": [
3405
+ "Orden habitual de una portada: Hero → características (FeatureGrid) → prueba social (Testimonial) → precios (PricingTable) → preguntas frecuentes (Faq) → llamada final (CtaBanner). Quita lo que no aporte.",
3406
+ "Una idea por sección y un título que la diga; el antetítulo es la categoría («Precios»), no una frase.",
3407
+ "Centrada para presentar; `align=\"start\"` para bloques de lectura (preguntas frecuentes, texto largo)."
3408
+ ]
3409
+ },
3324
3410
  "legend": {
3325
3411
  "import": "orbital-ds/ui/legend",
3326
3412
  "group": "data",
@@ -4595,6 +4681,45 @@
4595
4681
  "Contenido corto; si crece a varios campos o pide confirmar, pasa a Dialog o Sheet."
4596
4682
  ]
4597
4683
  },
4684
+ "pricing-table": {
4685
+ "import": "orbital-ds/ui/pricing-table",
4686
+ "group": "content",
4687
+ "summary": "Tabla de planes y precios de una web pública: cada plan con nombre, precio, periodo, lo que incluye y su botón; uno puede ir destacado.",
4688
+ "see": [
4689
+ {
4690
+ "component": "toggle-group",
4691
+ "when": "conmutar mensual/anual encima de la tabla"
4692
+ },
4693
+ {
4694
+ "component": "usage-meter",
4695
+ "when": "consumo frente a lo contratado DENTRO de la app, no la oferta"
4696
+ }
4697
+ ],
4698
+ "exports": [
4699
+ "PricingFeature",
4700
+ "PricingPlan",
4701
+ "PricingTable",
4702
+ "type PricingFeatureProps",
4703
+ "type PricingPlanProps"
4704
+ ],
4705
+ "slots": [
4706
+ "pricing-feature",
4707
+ "pricing-plan",
4708
+ "pricing-plan-action",
4709
+ "pricing-plan-features",
4710
+ "pricing-plan-header",
4711
+ "pricing-plan-name",
4712
+ "pricing-plan-period",
4713
+ "pricing-plan-price",
4714
+ "pricing-table"
4715
+ ],
4716
+ "optionalPeers": [],
4717
+ "notes": [
4718
+ "Entre 2 y 4 planes; destaca solo uno (`featured`) y dilo también con texto en `badge` («Más elegido»), no solo con color.",
4719
+ "Mismas filas en todos los planes y en el mismo orden, para comparar de un vistazo; lo que un plan no trae, con `included={false}`.",
4720
+ "Precio formateado por la app (moneda e impuestos de su mercado; `formatQuantity` de orbital-ds/lib/format si es una cifra). Mensual/anual con un ToggleGroup encima de la tabla."
4721
+ ]
4722
+ },
4598
4723
  "progress": {
4599
4724
  "import": "orbital-ds/ui/progress",
4600
4725
  "group": "feedback",
@@ -5093,7 +5218,7 @@
5093
5218
  "sheet": {
5094
5219
  "import": "orbital-ds/ui/sheet",
5095
5220
  "group": "overlays",
5096
- "summary": "Panel modal que entra desde un borde (derecha por defecto) para editar o consultar algo largo sin perder la página de fondo; pieza base de DetailPanel.",
5221
+ "summary": "Panel modal que entra desde un borde (por defecto el final de la lectura: derecha en LTR, izquierda en RTL) para editar o consultar algo largo sin perder la página de fondo; pieza base de DetailPanel.",
5097
5222
  "see": [
5098
5223
  {
5099
5224
  "component": "detail-panel",
@@ -5422,7 +5547,7 @@
5422
5547
  "notes": [
5423
5548
  "Un solo Toaster en la raíz; `toast` se importa de `sonner`. Necesita `sonner` y `next-themes` instalados.",
5424
5549
  "Elige un canal de toasts para toda la app: este Toaster o el de `toast` (Base UI), no los dos.",
5425
- "Se mantiene por compatibilidad, sin funciones nuevas (como `chart` frente a `echart`): en una app nueva usa `toast`."
5550
+ "OBSOLETO: se retirará en la próxima versión que rompa compatibilidad; migra a `toast` (Base UI). El doctor (`--ui`) avisa de cada import."
5426
5551
  ]
5427
5552
  },
5428
5553
  "sparkline": {
@@ -6062,6 +6187,42 @@
6062
6187
  "Un fallo va con state=\"error\" y error con el motivo en texto (se anuncia por aria-describedby), no solo en color."
6063
6188
  ]
6064
6189
  },
6190
+ "testimonial": {
6191
+ "import": "orbital-ds/ui/testimonial",
6192
+ "group": "content",
6193
+ "summary": "Testimonio de un cliente (cita, autor, cargo y foto) para la prueba social de una web pública; suelto, destacado o en rejilla.",
6194
+ "see": [
6195
+ {
6196
+ "component": "feature-grid",
6197
+ "when": "ventajas del producto, no opiniones"
6198
+ },
6199
+ {
6200
+ "component": "avatar",
6201
+ "when": "solo la foto o las iniciales de una persona"
6202
+ }
6203
+ ],
6204
+ "exports": [
6205
+ "Testimonial",
6206
+ "TestimonialGrid",
6207
+ "type TestimonialGridProps",
6208
+ "type TestimonialProps"
6209
+ ],
6210
+ "slots": [
6211
+ "testimonial",
6212
+ "testimonial-author",
6213
+ "testimonial-grid",
6214
+ "testimonial-logo",
6215
+ "testimonial-name",
6216
+ "testimonial-quote",
6217
+ "testimonial-role"
6218
+ ],
6219
+ "optionalPeers": [],
6220
+ "notes": [
6221
+ "Testimonios reales, con nombre, cargo y empresa (y foto o logo si hay permiso). Una cita anónima no prueba nada.",
6222
+ "Citas cortas (una o dos frases) que digan un resultado concreto; recorta, no inventes.",
6223
+ "Tres en rejilla o uno destacado (`size=\"lg\"`); nada de carruseles que giran solos."
6224
+ ]
6225
+ },
6065
6226
  "textarea": {
6066
6227
  "import": "orbital-ds/ui/textarea",
6067
6228
  "group": "forms",
@@ -0,0 +1,38 @@
1
+ "use client";
2
+ import * as React from "react";
3
+ const stack = [];
4
+ let listening = false;
5
+ function onKeyDown(e) {
6
+ if (e.key !== "Escape" || e.defaultPrevented || e.isComposing) return;
7
+ const top = stack[stack.length - 1];
8
+ if (!top) return;
9
+ e.preventDefault();
10
+ e.stopPropagation();
11
+ top.current();
12
+ }
13
+ function useEscCloseStack(open, onClose) {
14
+ const handler = React.useRef(onClose);
15
+ React.useEffect(() => {
16
+ handler.current = onClose;
17
+ });
18
+ React.useEffect(() => {
19
+ if (!open || typeof document === "undefined") return;
20
+ const entry = { current: () => handler.current() };
21
+ stack.push(entry);
22
+ if (!listening) {
23
+ document.addEventListener("keydown", onKeyDown);
24
+ listening = true;
25
+ }
26
+ return () => {
27
+ const i = stack.indexOf(entry);
28
+ if (i > -1) stack.splice(i, 1);
29
+ if (stack.length === 0 && listening) {
30
+ document.removeEventListener("keydown", onKeyDown);
31
+ listening = false;
32
+ }
33
+ };
34
+ }, [open]);
35
+ }
36
+ export {
37
+ useEscCloseStack
38
+ };
@@ -0,0 +1,30 @@
1
+ "use client";
2
+ import * as React from "react";
3
+ function useSimulatedProgress(active, { expectedMs = 8e3, ceiling = 90, resetMs = null } = {}) {
4
+ const [value, setValue] = React.useState(0);
5
+ const wasActive = React.useRef(false);
6
+ React.useEffect(() => {
7
+ if (active) {
8
+ wasActive.current = true;
9
+ setValue(0);
10
+ const start = performance.now();
11
+ const tau = Math.max(expectedMs, 1) / 2.3;
12
+ const reduced = typeof matchMedia !== "undefined" && matchMedia("(prefers-reduced-motion: reduce)").matches;
13
+ const id2 = setInterval(() => {
14
+ const t = performance.now() - start;
15
+ setValue(ceiling * (1 - Math.exp(-t / tau)));
16
+ }, reduced ? 500 : 100);
17
+ return () => clearInterval(id2);
18
+ }
19
+ if (!wasActive.current) return;
20
+ wasActive.current = false;
21
+ setValue(100);
22
+ if (resetMs == null) return;
23
+ const id = setTimeout(() => setValue(0), resetMs);
24
+ return () => clearTimeout(id);
25
+ }, [active, expectedMs, ceiling, resetMs]);
26
+ return Math.round(value * 10) / 10;
27
+ }
28
+ export {
29
+ useSimulatedProgress
30
+ };