orbital-ds 0.40.0 → 0.44.1

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 (197) hide show
  1. package/AGENTS.md +29 -10
  2. package/components.manifest.json +6469 -3349
  3. package/dist/auth-form-B1hgbXkI.d.ts +144 -0
  4. package/dist/hooks/use-ds-messages.d.ts +89 -0
  5. package/dist/lib/a2ui-catalog.d.ts +42 -0
  6. package/dist/lib/a2ui-catalog.js +558 -0
  7. package/dist/lib/a2ui.d.ts +289 -0
  8. package/dist/lib/a2ui.js +215 -0
  9. package/dist/lib/ai-events.d.ts +15 -0
  10. package/dist/lib/ai-events.js +202 -0
  11. package/dist/lib/auth-flow.d.ts +3 -1
  12. package/dist/lib/auth-flow.js +24 -3
  13. package/dist/lib/format.d.ts +57 -0
  14. package/dist/lib/format.js +177 -0
  15. package/dist/lib/i18n.d.ts +96 -2
  16. package/dist/lib/i18n.js +278 -2
  17. package/dist/lib/locales/de.d.ts +7 -0
  18. package/dist/lib/locales/de.js +535 -0
  19. package/dist/lib/locales/fr.d.ts +7 -0
  20. package/dist/lib/locales/fr.js +535 -0
  21. package/dist/lib/locales/he.d.ts +7 -0
  22. package/dist/lib/locales/he.js +535 -0
  23. package/dist/lib/locales/it.d.ts +7 -0
  24. package/dist/lib/locales/it.js +535 -0
  25. package/dist/styles.css +62 -2
  26. package/dist/ui/a2ui-renderer.d.ts +44 -0
  27. package/dist/ui/a2ui-renderer.js +793 -0
  28. package/dist/ui/agent-events.d.ts +49 -0
  29. package/dist/ui/agent-events.js +108 -0
  30. package/dist/ui/ai-tag.d.ts +16 -0
  31. package/dist/ui/alert-dialog.d.ts +37 -0
  32. package/dist/ui/alert.d.ts +1 -1
  33. package/dist/ui/animated-number.d.ts +11 -0
  34. package/dist/ui/app-bar.d.ts +22 -0
  35. package/dist/ui/attachment.d.ts +1 -1
  36. package/dist/ui/auth-backdrop.d.ts +17 -0
  37. package/dist/ui/auth-form.d.ts +3 -110
  38. package/dist/ui/auth-form.js +46 -11
  39. package/dist/ui/auth-layout.d.ts +38 -0
  40. package/dist/ui/avatar.d.ts +27 -0
  41. package/dist/ui/ayuda.d.ts +1 -1
  42. package/dist/ui/ayuda.js +4 -1
  43. package/dist/ui/badge.d.ts +1 -1
  44. package/dist/ui/banner.d.ts +1 -1
  45. package/dist/ui/bottom-nav.d.ts +22 -0
  46. package/dist/ui/breadcrumb.d.ts +22 -0
  47. package/dist/ui/breadcrumb.js +1 -1
  48. package/dist/ui/bubble.d.ts +1 -1
  49. package/dist/ui/button.d.ts +2 -2
  50. package/dist/ui/calendar.d.ts +13 -0
  51. package/dist/ui/calendar.js +3 -0
  52. package/dist/ui/card-stack.d.ts +27 -0
  53. package/dist/ui/card.d.ts +33 -0
  54. package/dist/ui/carousel.d.ts +35 -0
  55. package/dist/ui/carousel.js +10 -5
  56. package/dist/ui/chain-of-thought.d.ts +34 -0
  57. package/dist/ui/chain-of-thought.js +90 -0
  58. package/dist/ui/chart-card.d.ts +19 -0
  59. package/dist/ui/chart.d.ts +19 -0
  60. package/dist/ui/chat-composer.d.ts +58 -0
  61. package/dist/ui/chat-composer.js +192 -0
  62. package/dist/ui/choice-card.d.ts +33 -0
  63. package/dist/ui/code-block.d.ts +15 -0
  64. package/dist/ui/combobox.d.ts +48 -0
  65. package/dist/ui/command-palette.d.ts +18 -0
  66. package/dist/ui/command.d.ts +34 -0
  67. package/dist/ui/confirm-action.d.ts +30 -0
  68. package/dist/ui/confirm-dialog.d.ts +23 -0
  69. package/dist/ui/content-card.d.ts +14 -0
  70. package/dist/ui/context-menu.d.ts +35 -0
  71. package/dist/ui/context-menu.js +1 -1
  72. package/dist/ui/conversation-list.d.ts +44 -0
  73. package/dist/ui/conversation-list.js +141 -0
  74. package/dist/ui/copy-button.d.ts +11 -0
  75. package/dist/ui/date-time.d.ts +40 -0
  76. package/dist/ui/date-time.js +55 -0
  77. package/dist/ui/description-list.d.ts +49 -0
  78. package/dist/ui/description-list.js +86 -0
  79. package/dist/ui/detail-panel.d.ts +22 -0
  80. package/dist/ui/dialog.d.ts +35 -0
  81. package/dist/ui/dock.d.ts +17 -0
  82. package/dist/ui/drawer.d.ts +41 -0
  83. package/dist/ui/dropdown-menu.d.ts +32 -0
  84. package/dist/ui/dropdown-menu.js +1 -1
  85. package/dist/ui/echart.d.ts +15 -0
  86. package/dist/ui/empty.d.ts +1 -1
  87. package/dist/ui/entity-list.d.ts +32 -0
  88. package/dist/ui/form-layout.d.ts +24 -0
  89. package/dist/ui/gauge.d.ts +26 -0
  90. package/dist/ui/generated-image.d.ts +33 -0
  91. package/dist/ui/generated-image.js +65 -0
  92. package/dist/ui/generated-table.d.ts +29 -0
  93. package/dist/ui/generated-table.js +59 -0
  94. package/dist/ui/heatmap-grid.d.ts +20 -0
  95. package/dist/ui/hero.d.ts +58 -0
  96. package/dist/ui/hero.js +145 -0
  97. package/dist/ui/i18n-provider.d.ts +16 -0
  98. package/dist/ui/icon-tile.d.ts +2 -2
  99. package/dist/ui/input-group.d.ts +1 -1
  100. package/dist/ui/input-otp.d.ts +23 -0
  101. package/dist/ui/input.d.ts +16 -0
  102. package/dist/ui/instruction-editor.d.ts +17 -0
  103. package/dist/ui/item.d.ts +3 -3
  104. package/dist/ui/label.d.ts +17 -0
  105. package/dist/ui/legend.d.ts +25 -0
  106. package/dist/ui/level-meter.d.ts +12 -0
  107. package/dist/ui/load-more.d.ts +17 -0
  108. package/dist/ui/loading-state.d.ts +12 -0
  109. package/dist/ui/markdown.d.ts +29 -0
  110. package/dist/ui/markdown.js +123 -0
  111. package/dist/ui/media-card.d.ts +16 -0
  112. package/dist/ui/menubar.d.ts +39 -0
  113. package/dist/ui/message-actions.d.ts +21 -0
  114. package/dist/ui/message-actions.js +79 -0
  115. package/dist/ui/message-scroller.d.ts +30 -0
  116. package/dist/ui/message.d.ts +33 -0
  117. package/dist/ui/mfa-challenge.d.ts +3 -32
  118. package/dist/ui/mfa-challenge.js +1 -1
  119. package/dist/ui/mfa-setup.d.ts +1 -1
  120. package/dist/ui/mosaic.d.ts +23 -0
  121. package/dist/ui/motion-provider.d.ts +17 -0
  122. package/dist/ui/native-select.d.ts +22 -0
  123. package/dist/ui/next-step-card.d.ts +55 -0
  124. package/dist/ui/next-step-card.js +92 -0
  125. package/dist/ui/notice-review.d.ts +32 -0
  126. package/dist/ui/oauth-consent.d.ts +1 -1
  127. package/dist/ui/page-header.d.ts +46 -4
  128. package/dist/ui/page-header.js +20 -11
  129. package/dist/ui/page-loader.d.ts +17 -0
  130. package/dist/ui/page-shell.d.ts +17 -0
  131. package/dist/ui/pagination.d.ts +20 -0
  132. package/dist/ui/pagination.js +2 -2
  133. package/dist/ui/panel.d.ts +1 -1
  134. package/dist/ui/password-strength.d.ts +14 -0
  135. package/dist/ui/popover.d.ts +32 -0
  136. package/dist/ui/proportion-bar.d.ts +25 -0
  137. package/dist/ui/quantity.d.ts +25 -0
  138. package/dist/ui/quantity.js +27 -0
  139. package/dist/ui/questionnaire.d.ts +38 -0
  140. package/dist/ui/reasoning.d.ts +24 -0
  141. package/dist/ui/reasoning.js +62 -0
  142. package/dist/ui/reveal.d.ts +17 -0
  143. package/dist/ui/sheet.d.ts +39 -2
  144. package/dist/ui/sheet.js +6 -2
  145. package/dist/ui/shield.d.ts +14 -0
  146. package/dist/ui/show-more.d.ts +14 -0
  147. package/dist/ui/sidebar.d.ts +4 -2
  148. package/dist/ui/sidebar.js +7 -3
  149. package/dist/ui/sparkline.d.ts +1 -1
  150. package/dist/ui/stat-group.d.ts +32 -0
  151. package/dist/ui/stat.d.ts +1 -1
  152. package/dist/ui/status-badge.d.ts +3 -3
  153. package/dist/ui/status-hero.d.ts +18 -0
  154. package/dist/ui/step-dots.d.ts +12 -0
  155. package/dist/ui/step-ring.d.ts +14 -0
  156. package/dist/ui/suggestions.d.ts +17 -0
  157. package/dist/ui/suggestions.js +39 -0
  158. package/dist/ui/table.d.ts +26 -0
  159. package/dist/ui/tag-input.d.ts +21 -0
  160. package/dist/ui/tag-input.js +169 -0
  161. package/dist/ui/task-loader.d.ts +15 -0
  162. package/dist/ui/task-progress.d.ts +14 -0
  163. package/dist/ui/textarea.d.ts +22 -1
  164. package/dist/ui/textarea.js +7 -1
  165. package/dist/ui/timeline.d.ts +26 -0
  166. package/dist/ui/toggle-group.d.ts +24 -0
  167. package/dist/ui/tool-call.d.ts +27 -0
  168. package/dist/ui/tool-call.js +74 -0
  169. package/dist/ui/usage-meter.d.ts +42 -0
  170. package/dist/ui/usage-meter.js +116 -0
  171. package/dist/ui/week-strip.d.ts +11 -0
  172. package/dist/ui/week-strip.js +2 -2
  173. package/dist/ui/workflow-run.d.ts +51 -0
  174. package/dist/ui/workflow-run.js +185 -0
  175. package/docs/adr/0001-rtl-clases-logicas.md +14 -1
  176. package/docs/designer/criterio.md +87 -87
  177. package/docs/designer/flujo.md +1 -1
  178. package/docs/designer/patrones.md +43 -2
  179. package/manifest/actions.json +364 -0
  180. package/manifest/agents.json +399 -0
  181. package/manifest/ai.json +128 -0
  182. package/manifest/auth.json +1547 -0
  183. package/manifest/chat.json +612 -0
  184. package/manifest/content.json +2298 -0
  185. package/manifest/data.json +2904 -0
  186. package/manifest/feedback.json +1005 -0
  187. package/manifest/forms.json +1954 -0
  188. package/manifest/motion.json +196 -0
  189. package/manifest/navigation.json +1792 -0
  190. package/manifest/overlays.json +931 -0
  191. package/package.json +35 -21
  192. package/scripts/cli.mjs +105 -8
  193. package/scripts/doctor.mjs +126 -1
  194. package/scripts/eslint-plugin.mjs +93 -0
  195. package/scripts/i18n.mjs +1 -1
  196. package/scripts/manifest.mjs +159 -7
  197. package/skill/SKILL.md +8 -3
@@ -9,18 +9,43 @@
9
9
  *
10
10
  * node scripts/manifest.mjs # regenera components.manifest.json
11
11
  */
12
- import { readFileSync, readdirSync, writeFileSync, existsSync } from 'node:fs';
12
+ import { readFileSync, readdirSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
13
13
  import { join, dirname, resolve } from 'node:path';
14
14
  import { fileURLToPath } from 'node:url';
15
+ import ts from 'typescript';
15
16
 
16
17
  const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
17
18
  const UI = join(ROOT, 'src/ui');
19
+ const EOL = '\n';
18
20
 
19
21
  // Dependencias que SIEMPRE están (peers obligatorios): no se listan como opcionales.
20
22
  const REQUIRED = new Set([
21
23
  'react', 'react-dom', 'class-variance-authority', 'clsx', 'tailwind-merge', 'lucide-react',
22
24
  ]);
23
25
 
26
+ /**
27
+ * Dominios de los componentes: el `@group` de cada fichero de `src/ui` (obligatorio, uno de estos) y la sección
28
+ * de su demo en el escaparate (`label`). Un agente pide solo el dominio que necesita en vez de leer los 150+.
29
+ */
30
+ export const GROUPS = {
31
+ actions: { label: 'Acciones', about: 'Botones y acciones sueltas.' },
32
+ forms: { label: 'Formularios', about: 'Campos, selectores y envío de datos.' },
33
+ feedback: { label: 'Avisos', about: 'Alertas, toasts, progreso y esperas.' },
34
+ overlays: { label: 'Capas', about: 'Diálogos, menús, popovers y paneles que se superponen.' },
35
+ navigation: { label: 'Navegación', about: 'Cabecera, lateral, pestañas, pasos, paginación y búsqueda de destinos.' },
36
+ data: { label: 'Datos', about: 'Tablas, gráficos, métricas, listas de entidades y estados de carga.' },
37
+ content: { label: 'Contenido', about: 'Tarjetas, texto, media y piezas de maquetación.' },
38
+ motion: { label: 'Movimiento', about: 'Animación y cargadores de página.' },
39
+ chat: { label: 'Chat', about: 'Conversación: mensajes, compositor, adjuntos y sugerencias.' },
40
+ agents: { label: 'Agentes', about: 'Lo que hace un agente: razonamiento, herramientas, eventos, flujos y A2UI.' },
41
+ ai: { label: 'IA', about: 'Piezas de contenido generado.' },
42
+ auth: { label: 'Acceso', about: 'Inicio de sesión, MFA, passkeys, sesiones y consentimiento.' },
43
+ };
44
+
45
+ function parseGroup(src) {
46
+ return src.match(/@group\s+([a-z-]+)/)?.[1] ?? null;
47
+ }
48
+
24
49
  function parseExports(src) {
25
50
  const names = new Set();
26
51
  for (const m of src.matchAll(/export\s*\{([^}]*)\}/g)) {
@@ -34,7 +59,58 @@ function parseExports(src) {
34
59
  }
35
60
 
36
61
  function parseSlots(src) {
37
- return [...new Set([...src.matchAll(/data-slot="([a-z0-9-]+)"/g)].map((m) => m[1]))].sort();
62
+ // `data-slot="x"` en JSX, `"data-slot": "x"` en un objeto de props y `state: { slot: "x" }` de useRender.
63
+ const re = /(?:data-slot"?\s*[=:]\s*|\bslot:\s*)"([a-z0-9-]+)"/g;
64
+ return [...new Set([...src.matchAll(re)].map((m) => m[1]))].sort();
65
+ }
66
+
67
+ /**
68
+ * Ficha para agentes escrita en la cabecera del componente (JSDoc, en español):
69
+ *
70
+ * @summary <una línea: qué es y cuándo usarlo>
71
+ * @see <otro-componente> — <cuándo usar ese en su lugar>
72
+ * @example <título: una sola idea>
73
+ * <JSX mínimo, en las líneas siguientes, hasta la próxima etiqueta o el fin del comentario>
74
+ *
75
+ * Todo en UN bloque `/** … *\/` (el de `@group`). En el JSX de un ejemplo no caben comentarios `{/* … *\/}`.
76
+ *
77
+ * Es lo primero que lee un agente para ELEGIR (summary y see van al índice) y para COPIAR bien (examples).
78
+ */
79
+ export function parseDoc(src) {
80
+ const out = { summary: null, see: [], examples: [] };
81
+ for (const block of src.matchAll(/\/\*\*?([\s\S]*?)\*\//g)) {
82
+ // Solo el bloque de la ficha (el que lleva @summary): un @see o @example en el JSDoc de una prop no cuenta.
83
+ if (!/@summary\b/.test(block[1])) continue;
84
+ const lines = block[1].split(/\r?\n/).map((l) => l.replace(/^\s*\*\s?/, ''));
85
+ let cur = null;
86
+ const flush = () => {
87
+ if (cur?.kind === 'example') {
88
+ while (cur.code.length && !cur.code.at(-1).trim()) cur.code.pop();
89
+ while (cur.code.length && !cur.code[0].trim()) cur.code.shift();
90
+ const indent = Math.min(...cur.code.filter((l) => l.trim()).map((l) => l.match(/^\s*/)[0].length));
91
+ out.examples.push({ title: cur.title, code: cur.code.map((l) => l.slice(indent)).join('\n') });
92
+ }
93
+ cur = null;
94
+ };
95
+ for (const line of lines) {
96
+ const tag = line.match(/^\s*@(\w+)\s*(.*)$/);
97
+ if (tag) {
98
+ flush();
99
+ const [, name, rest] = tag;
100
+ if (name === 'summary') { out.summary = rest.trim(); cur = { kind: 'summary' }; }
101
+ else if (name === 'see') {
102
+ const m = rest.match(/^([a-z0-9-]+)\s*(?:—|-{1,2}|:)?\s*(.*)$/);
103
+ if (m) out.see.push({ component: m[1], when: m[2].trim() });
104
+ } else if (name === 'example') cur = { kind: 'example', title: rest.trim(), code: [] };
105
+ continue;
106
+ }
107
+ if (cur?.kind === 'example') cur.code.push(line);
108
+ else if (cur?.kind === 'summary' && line.trim()) out.summary += ` ${line.trim()}`;
109
+ else cur = null;
110
+ }
111
+ flush();
112
+ }
113
+ return out;
38
114
  }
39
115
 
40
116
  /** Reglas de uso escritas en el componente con `@note …` (una por línea): van al manifiesto. */
@@ -68,18 +144,74 @@ function parseOptionalPeers(src) {
68
144
  return [...peers].sort();
69
145
  }
70
146
 
71
- export function buildManifest() {
147
+ /**
148
+ * Props PROPIAS de cada componente exportado (las declaradas en `src/`, no las del elemento nativo ni las de
149
+ * Base UI): nombre, tipo, si es obligatoria, valores si es una unión de literales y su comentario.
150
+ * Lee los tipos con el compilador de TypeScript, así que nunca se desfasa del código.
151
+ */
152
+ function extractProps() {
153
+ const cfgPath = join(ROOT, 'tsconfig.json');
154
+ const cfg = ts.getParsedCommandLineOfConfigFile(cfgPath, {}, { ...ts.sys, onUnRecoverableConfigFileDiagnostic: () => {} });
155
+ const files = readdirSync(UI).filter((n) => n.endsWith('.tsx')).map((n) => join(UI, n));
156
+ const program = ts.createProgram(files, cfg.options);
157
+ const checker = program.getTypeChecker();
158
+ const own = (sym) => (sym.declarations ?? []).length > 0 && sym.declarations.every((d) => !d.getSourceFile().fileName.includes('node_modules'));
159
+ const out = {};
160
+ for (const file of files) {
161
+ const sf = program.getSourceFile(file);
162
+ const mod = sf && checker.getSymbolAtLocation(sf);
163
+ if (!mod) continue;
164
+ const name = file.slice(UI.length + 1).replace(/\.tsx$/, '').replaceAll('\\', '/');
165
+ const byExport = {};
166
+ for (const exp of checker.getExportsOfModule(mod)) {
167
+ if (!/^[A-Z]/.test(exp.name)) continue;
168
+ const target = exp.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(exp) : exp;
169
+ const decl = target.valueDeclaration ?? target.declarations?.[0];
170
+ if (!decl) continue;
171
+ const sig = checker.getTypeOfSymbolAtLocation(target, decl).getCallSignatures()[0];
172
+ const param = sig?.parameters[0];
173
+ if (!param) continue;
174
+ const props = {};
175
+ for (const p of checker.getTypeOfSymbolAtLocation(param, decl).getProperties()) {
176
+ if (!own(p)) continue;
177
+ const optional = (p.flags & ts.SymbolFlags.Optional) !== 0;
178
+ const type = checker.getNonNullableType(checker.getTypeOfSymbolAtLocation(p, decl));
179
+ const text = checker.typeToString(type, decl, ts.TypeFormatFlags.NoTruncation | ts.TypeFormatFlags.UseAliasDefinedOutsideCurrentScope);
180
+ const lits = type.isUnion() ? type.types.filter((t) => t.isStringLiteral()).map((t) => t.value) : [];
181
+ const doc = ts.displayPartsToString(p.getDocumentationComment(checker)).replace(/\s+/g, ' ').trim();
182
+ props[p.name] = {
183
+ type: text.length > 160 ? text.slice(0, 157) + '…' : text,
184
+ ...(optional ? {} : { required: true }),
185
+ ...(lits.length > 1 && lits.length === type.types.length ? { values: lits } : {}),
186
+ ...(doc ? { doc } : {}),
187
+ };
188
+ }
189
+ if (Object.keys(props).length) byExport[exp.name] = props;
190
+ }
191
+ if (Object.keys(byExport).length) out[name] = byExport;
192
+ }
193
+ return out;
194
+ }
195
+
196
+ export function buildManifest({ props = false } = {}) {
197
+ const propsByFile = props ? extractProps() : {};
72
198
  const components = {};
73
199
  for (const f of readdirSync(UI).filter((n) => n.endsWith('.tsx')).sort()) {
74
200
  const src = readFileSync(join(UI, f), 'utf8');
75
201
  const name = f.replace(/\.tsx$/, '');
202
+ const doc = parseDoc(src);
76
203
  components[name] = {
77
204
  import: `orbital-ds/ui/${name}`,
205
+ group: parseGroup(src),
206
+ ...(doc.summary ? { summary: doc.summary } : {}),
207
+ ...(doc.see.length ? { see: doc.see } : {}),
78
208
  exports: parseExports(src),
79
209
  slots: parseSlots(src),
80
210
  optionalPeers: parseOptionalPeers(src),
211
+ ...(propsByFile[name] ? { props: propsByFile[name] } : {}),
81
212
  ...(parsePresets(src) ? { presets: parsePresets(src) } : {}),
82
213
  ...(parseNotes(src).length ? { notes: parseNotes(src) } : {}),
214
+ ...(doc.examples.length ? { examples: doc.examples } : {}),
83
215
  };
84
216
  }
85
217
  const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'));
@@ -87,14 +219,34 @@ export function buildManifest() {
87
219
  package: pkg.name,
88
220
  version: pkg.version,
89
221
  engine: '@base-ui/react',
222
+ groups: Object.fromEntries(Object.entries(GROUPS).map(([k, v]) => [k, v.about])),
90
223
  docs: ['README.md', 'docs/CONTRACT.md', 'AGENTS.md', 'contract.json'],
91
224
  components,
92
225
  };
93
226
  }
94
227
 
228
+ /** Carpeta de las páginas por dominio (`manifest/<dominio>.json`): componentes con sus props tipadas. */
229
+ export const PAGES_DIR = 'manifest';
230
+
231
+ /** Separa el manifiesto completo en el índice (sin props, ligero) y una página por dominio (con props). */
232
+ export function splitManifest(full) {
233
+ const index = { ...full, pages: Object.fromEntries(Object.keys(GROUPS).map((g) => [g, `${PAGES_DIR}/${g}.json`])), components: {} };
234
+ const pages = {};
235
+ for (const g of Object.keys(GROUPS)) pages[g] = { package: full.package, version: full.version, group: g, about: GROUPS[g].about, components: {} };
236
+ for (const [name, c] of Object.entries(full.components)) {
237
+ // El índice sirve para ELEGIR (resumen, alternativas, notas); las props y los ejemplos, en la página del dominio.
238
+ const { props, examples, ...light } = c;
239
+ index.components[name] = light;
240
+ if (pages[c.group]) pages[c.group].components[name] = c;
241
+ }
242
+ return { index, pages };
243
+ }
244
+
95
245
  if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
96
- const out = join(ROOT, 'components.manifest.json');
97
- const manifest = buildManifest();
98
- writeFileSync(out, JSON.stringify(manifest, null, 2) + '\n');
99
- console.log(`manifest: ${Object.keys(manifest.components).length} componentes → components.manifest.json`);
246
+ const full = buildManifest({ props: true });
247
+ const { index, pages } = splitManifest(full);
248
+ writeFileSync(join(ROOT, 'components.manifest.json'), JSON.stringify(index, null, 2) + EOL);
249
+ mkdirSync(join(ROOT, PAGES_DIR), { recursive: true });
250
+ for (const [g, page] of Object.entries(pages)) writeFileSync(join(ROOT, PAGES_DIR, `${g}.json`), JSON.stringify(page, null, 2) + EOL);
251
+ console.log(`manifest: ${Object.keys(full.components).length} componentes → components.manifest.json + ${PAGES_DIR}/ (${Object.keys(pages).length} dominios)`);
100
252
  }
package/skill/SKILL.md CHANGED
@@ -27,8 +27,13 @@ mismos componentes, el aspecto del tema y de la marca de la app.
27
27
  2. **Modo:** dar forma · construir · revisar · robustecer → `node_modules/orbital-ds/docs/designer/flujo.md` §1.
28
28
  3. **Mapa del flujo y modelo mental de la persona** → `flujo.md` §2. Reduce pasos y deja una acción principal.
29
29
  4. **Patrones** para cada paso → `node_modules/orbital-ds/docs/designer/patrones.md`.
30
- 5. **Componer** con los componentes del manifiesto (`node_modules/orbital-ds/components.manifest.json`, respeta sus
31
- `notes`) y las reglas de `node_modules/orbital-ds/AGENTS.md`.
30
+ 5. **Componer** con los componentes del sistema. Para ELEGIR, busca por intención: `pnpm exec orbital-ds components --search
31
+ <qué necesitas>` (resumen y alternativas de cada uno). Antes de usar uno, lee su **ficha** con
32
+ `orbital-ds components <nombre>`: cuándo usar otro, props, notas y **ejemplos mínimos**; parte de un ejemplo en vez de
33
+ escribir de memoria. Por dominio: `pnpm exec orbital-ds components` lista los 12
34
+ dominios; `orbital-ds components --group <dominio>` da sus componentes con **props tipadas** (valores permitidos,
35
+ obligatorias), presets y `notes`; `orbital-ds components <nombre>` uno solo. No inventes props: si no está ahí, no
36
+ existe. Reglas en `node_modules/orbital-ds/AGENTS.md`.
32
37
  6. **Criterio visual: analiza y elige el elemento** → `node_modules/orbital-ds/docs/designer/criterio.md` (los 8 pasos
33
38
  de análisis puntuados, el árbol «¿tarjeta, ítem, bento, imagen, efecto?», armonía y referentes: Apple, Material,
34
39
  Nielsen, Polaris/GOV.UK). Antes de elegir un elemento, lee el `@note` de las dos piezas candidatas. Puntúa la
@@ -37,7 +42,7 @@ mismos componentes, el aspecto del tema y de la marca de la app.
37
42
  formularios, textos, accesibilidad WCAG 2.2 AA, responsivo).
38
43
  8. **Verificar** → `node_modules/orbital-ds/docs/designer/revision.md`, y además:
39
44
  `pnpm exec orbital-ds doctor --css src/brand.css --ui src` (la parte mecánica: valores fijos, paleta de
40
- Tailwind, `!important`, controles nativos sueltos) y el verify de la app. Recorre cada estado, con teclado, en
45
+ Tailwind, `!important`, controles nativos sueltos, `asChild`, props y valores que no existen en el componente) y el verify de la app. Recorre cada estado, con teclado, en
41
46
  móvil, claro/oscuro y con textos largos.
42
47
 
43
48
  ## Orden de autoridad