@daisforge/ui-mcp 0.1.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 (75) hide show
  1. package/README.md +140 -0
  2. package/data/component-index.json +45769 -0
  3. package/dist/indexer/buildIndex.js +323 -0
  4. package/dist/indexer/buildIndex.js.map +1 -0
  5. package/dist/indexer/classify.js +129 -0
  6. package/dist/indexer/classify.js.map +1 -0
  7. package/dist/indexer/classifyRole.js +58 -0
  8. package/dist/indexer/classifyRole.js.map +1 -0
  9. package/dist/indexer/collectUsageExamples.js +261 -0
  10. package/dist/indexer/collectUsageExamples.js.map +1 -0
  11. package/dist/indexer/diagnostics.js +85 -0
  12. package/dist/indexer/diagnostics.js.map +1 -0
  13. package/dist/indexer/discoverComponents.js +119 -0
  14. package/dist/indexer/discoverComponents.js.map +1 -0
  15. package/dist/indexer/htmlAttributeDenylist.js +254 -0
  16. package/dist/indexer/htmlAttributeDenylist.js.map +1 -0
  17. package/dist/indexer/indexFeatures.js +56 -0
  18. package/dist/indexer/indexFeatures.js.map +1 -0
  19. package/dist/indexer/indexTypes.js +44 -0
  20. package/dist/indexer/indexTypes.js.map +1 -0
  21. package/dist/indexer/mergeAtomicCuratedMeta.js +45 -0
  22. package/dist/indexer/mergeAtomicCuratedMeta.js.map +1 -0
  23. package/dist/indexer/mergeAtomicData.js +188 -0
  24. package/dist/indexer/mergeAtomicData.js.map +1 -0
  25. package/dist/indexer/mergeMeta.js +85 -0
  26. package/dist/indexer/mergeMeta.js.map +1 -0
  27. package/dist/indexer/parseComponent.js +715 -0
  28. package/dist/indexer/parseComponent.js.map +1 -0
  29. package/dist/indexer/resolveImportPath.js +69 -0
  30. package/dist/indexer/resolveImportPath.js.map +1 -0
  31. package/dist/indexer/synthesizeExample.js +41 -0
  32. package/dist/indexer/synthesizeExample.js.map +1 -0
  33. package/dist/indexer/tsProject.js +24 -0
  34. package/dist/indexer/tsProject.js.map +1 -0
  35. package/dist/indexer/vendorAtomicData.js +57 -0
  36. package/dist/indexer/vendorAtomicData.js.map +1 -0
  37. package/dist/indexer/vendorExamples.js +60 -0
  38. package/dist/indexer/vendorExamples.js.map +1 -0
  39. package/dist/indexer/vendorUsageExamples.js +111 -0
  40. package/dist/indexer/vendorUsageExamples.js.map +1 -0
  41. package/dist/resolveIndex.js +87 -0
  42. package/dist/resolveIndex.js.map +1 -0
  43. package/dist/server.js +114 -0
  44. package/dist/server.js.map +1 -0
  45. package/dist/tools/getComponent.js +99 -0
  46. package/dist/tools/getComponent.js.map +1 -0
  47. package/dist/tools/getComponentExamples.js +28 -0
  48. package/dist/tools/getComponentExamples.js.map +1 -0
  49. package/dist/tools/getComponentProps.js +60 -0
  50. package/dist/tools/getComponentProps.js.map +1 -0
  51. package/dist/tools/getFeature.js +19 -0
  52. package/dist/tools/getFeature.js.map +1 -0
  53. package/dist/tools/getFeatureExamples.js +27 -0
  54. package/dist/tools/getFeatureExamples.js.map +1 -0
  55. package/dist/tools/getInstallationGuide.js +8 -0
  56. package/dist/tools/getInstallationGuide.js.map +1 -0
  57. package/dist/tools/getType.js +34 -0
  58. package/dist/tools/getType.js.map +1 -0
  59. package/dist/tools/listCategories.js +19 -0
  60. package/dist/tools/listCategories.js.map +1 -0
  61. package/dist/tools/listComponents.js +51 -0
  62. package/dist/tools/listComponents.js.map +1 -0
  63. package/dist/tools/listFeatures.js +17 -0
  64. package/dist/tools/listFeatures.js.map +1 -0
  65. package/dist/tools/searchComponents.js +176 -0
  66. package/dist/tools/searchComponents.js.map +1 -0
  67. package/dist/tools/shared.js +39 -0
  68. package/dist/tools/shared.js.map +1 -0
  69. package/dist/tools/truncate.js +81 -0
  70. package/dist/tools/truncate.js.map +1 -0
  71. package/dist/types.js +9 -0
  72. package/dist/types.js.map +1 -0
  73. package/dist/validate/validateIndex.js +200 -0
  74. package/dist/validate/validateIndex.js.map +1 -0
  75. package/package.json +59 -0
package/dist/server.js ADDED
@@ -0,0 +1,114 @@
1
+ #!/usr/bin/env node
2
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
4
+ import { z } from 'zod';
5
+ import { resolveIndex } from './resolveIndex.js';
6
+ import { getComponent } from './tools/getComponent.js';
7
+ import { getComponentExamples } from './tools/getComponentExamples.js';
8
+ import { getComponentProps } from './tools/getComponentProps.js';
9
+ import { getFeature } from './tools/getFeature.js';
10
+ import { getFeatureExamples } from './tools/getFeatureExamples.js';
11
+ import { getInstallationGuide } from './tools/getInstallationGuide.js';
12
+ import { getType } from './tools/getType.js';
13
+ import { listCategories } from './tools/listCategories.js';
14
+ import { listComponents } from './tools/listComponents.js';
15
+ import { listFeatures } from './tools/listFeatures.js';
16
+ import { searchComponents } from './tools/searchComponents.js';
17
+ import { truncateForResponse } from './tools/truncate.js';
18
+ function loadIndex() {
19
+ const resolved = resolveIndex();
20
+ // dataVersionNotice/libNotInstalled/source кладём прямо в index — тулзам
21
+ // так не нужно принимать второй аргумент на каждый вызов.
22
+ return {
23
+ ...resolved.index,
24
+ dataVersionNotice: resolved.dataVersionNotice,
25
+ libNotInstalled: resolved.libNotInstalled,
26
+ indexSource: resolved.source,
27
+ };
28
+ }
29
+ /**
30
+ * Явная аннотация возврата CallToolResult обязательна: без неё литерал
31
+ * 'text' расширяется до string и объект перестаёт подходить под
32
+ * дискриминированный union content-блоков SDK.
33
+ */
34
+ function toToolResult(payload) {
35
+ return { content: [{ type: 'text', text: truncateForResponse(payload) }] };
36
+ }
37
+ /** То же самое для ресурсов (T8): один текстовый content-блок с тем же JSON-форматом, что и у тулов. */
38
+ function toResourceResult(uri, payload) {
39
+ return {
40
+ contents: [
41
+ {
42
+ uri: uri.href,
43
+ mimeType: 'application/json',
44
+ text: truncateForResponse(payload),
45
+ },
46
+ ],
47
+ };
48
+ }
49
+ /**
50
+ * Дженерик Shape нужен ровно для одного: чтобы TS проверил, что тип args
51
+ * хендлера согласован с переданной zod-схемой (иначе рассинхрон схемы и
52
+ * реализации ловится только в рантайме).
53
+ *
54
+ * В сам SDK схема уходит уже расширенной до ZodRawShapeCompat: ToolCallback —
55
+ * условный тип, и на нерезолвнутом Shape он остаётся отложенным, из-за чего
56
+ * ни одна конкретная функция под него не подходит (TS2352). На конкретном
57
+ * ZodRawShapeCompat он резолвится в (args: Record<string, any>) => …, и
58
+ * единственное сужение — as ShapeOutput<Shape> — стоит ровно на границе,
59
+ * где SDK уже провалидировал args настоящей zod-схемой.
60
+ */
61
+ function registerJsonTool(server, index, name, description, inputSchema, handler) {
62
+ const widenedSchema = inputSchema;
63
+ const cb = async (args) => toToolResult(handler(index, args));
64
+ server.registerTool(name, { description, inputSchema: widenedSchema }, cb);
65
+ }
66
+ function main() {
67
+ const index = loadIndex();
68
+ const server = new McpServer({ name: '@daisforge/ui-mcp', version: '0.1.0' });
69
+ registerJsonTool(server, index, 'list_components', 'Список компонентов @daisforge/ui с фильтрами по типу (wrapper/composition/standalone/form), категории ("Локальные компоненты" / "Композиции" / "Формы" — количество по типам см. в ресурсе daisforge-ui://catalog/categories), scope. По умолчанию — только самостоятельные компоненты (role: "primary", ~177 из 243): слоты вроде DrawerDFHeader и служебные примитивы вроде CanvasRect скрыты, они видны через relatedExports в карточке владельца (get_component) или напрямую по имени; role: "all" снимает фильтр. Без limit список бюджетируется автоматически (см. shown/total/truncationNotice в ответе); limit/offset — явная пагинация.', {
70
+ type: z.string().optional(),
71
+ category: z.string().optional(),
72
+ scope: z.string().optional(),
73
+ role: z.enum(['primary', 'part', 'internal', 'all']).optional(),
74
+ limit: z.number().int().positive().optional(),
75
+ offset: z.number().int().nonnegative().optional(),
76
+ }, listComponents);
77
+ registerJsonTool(server, index, 'search_components', 'Поиск компонентов и их фичей по свободному запросу (рус/англ) — включая disambiguation-подсказки (например "таблица" → TableCanvas).', {
78
+ query: z.string(),
79
+ limit: z.number().int().positive().max(50).optional(),
80
+ }, searchComponents);
81
+ registerJsonTool(server, index, 'get_component', 'Компактная карточка компонента: тип, категория, hint, importStatement, имена пропсов, compound-части, список фичей. Для деталей используйте get_component_props/get_component_examples.', { name: z.string() }, getComponent);
82
+ registerJsonTool(server, index, 'get_component_props', 'Полные пропсы компонента (собственные + унаследованные от атомарного @salutejs/sdds-finai компонента). part — для compound-частей (например "Header" у DrawerDF).', { name: z.string(), part: z.string().optional() }, getComponentProps);
83
+ registerJsonTool(server, index, 'get_component_examples', 'Примеры кода компонента. Без title — список заголовков + первый пример; с title — конкретный пример.', { name: z.string(), title: z.string().optional() }, getComponentExamples);
84
+ registerJsonTool(server, index, 'get_type', 'Разворачивает именованный тип, встреченный в тексте пропса (например columnConfig: readonly ColumnConfig<Row>[] — get_component_props покажет только имя ColumnConfig, этот тул отдаёт само определение и готовый import). Некоторые имена неоднозначны (TableCanvas переиспользует общие имена типов) — тогда тул вернёт список квалифицированных ключей вида "TableCanvas.ColumnConfig" для уточнения.', { name: z.string() }, getType);
85
+ registerJsonTool(server, index, 'list_features', 'Список фичей компонента (актуально для TableCanvas/Table — десятки фичей вроде Filtering/Sorting/CopyPasteFill, недоступных иначе).', { component: z.string() }, listFeatures);
86
+ registerJsonTool(server, index, 'get_feature', 'Документация и API конкретной фичи компонента (без тел примеров). Регистронезависимо, понимает вложенные пути вроде "CanvasElements/CanvasText".', { component: z.string(), feature: z.string() }, getFeature);
87
+ registerJsonTool(server, index, 'get_feature_examples', 'Примеры кода конкретной фичи. Без title — список заголовков + первый пример.', {
88
+ component: z.string(),
89
+ feature: z.string(),
90
+ title: z.string().optional(),
91
+ }, getFeatureExamples);
92
+ /**
93
+ * list_categories и get_installation_guide не принимают аргументов и не
94
+ * зависят от них — это статический контент за один вызов на сессию, а не
95
+ * тул с параметрами выбора. Ресурсы (T8) не занимают слот в списке тулов,
96
+ * который агент читает при каждом запросе; значения category, которые
97
+ * раньше приходилось узнавать через list_categories(), теперь прямо в
98
+ * описании list_components (см. ниже).
99
+ */
100
+ server.registerResource('categories', 'daisforge-ui://catalog/categories', {
101
+ title: 'Категории компонентов @daisforge/ui',
102
+ description: 'Категории каталога с количеством компонентов по типам (wrapper/composition/standalone/form).',
103
+ mimeType: 'application/json',
104
+ }, async (uri) => toResourceResult(uri, listCategories(index)));
105
+ server.registerResource('installation-guide', 'daisforge-ui://catalog/installation-guide', {
106
+ title: 'Гайд по установке @daisforge/ui',
107
+ description: 'Установка пакета и подключение стилей/токенов, использование компонентов и иконок.',
108
+ mimeType: 'application/json',
109
+ }, async (uri) => toResourceResult(uri, getInstallationGuide(index)));
110
+ const transport = new StdioServerTransport();
111
+ server.connect(transport);
112
+ }
113
+ main();
114
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,99 @@
1
+ import { isOkComponent } from '../types.js';
2
+ import { findComponent, listComponentFeatures, summarizeProp, } from './shared.js';
3
+ /**
4
+ * Сколько необязательных пропсов с описанием показывать в компактной
5
+ * карточке сверх обязательных. У широких API (TableGlideInstance — 153
6
+ * своих пропса) весь список отдавать здесь бессмысленно — карточка
7
+ * задумана как дешёвый шаг выбора компонента, а не замена
8
+ * get_component_props.
9
+ */
10
+ const MAX_OPTIONAL_OWN_PROPS_SHOWN = 10;
11
+ /**
12
+ * required-пропсы — всегда (без них компонент не собрать), плюс до
13
+ * MAX_OPTIONAL_OWN_PROPS_SHOWN "значимых" необязательных: с описанием и не
14
+ * deprecated (без описания в компактной карточке от пропса пользы ноль, а
15
+ * deprecated не должны конкурировать за место с живыми пропсами).
16
+ */
17
+ function selectOwnProps(props) {
18
+ const required = props.filter((p) => p.required);
19
+ const significantOptional = props.filter((p) => !p.required && p.description && !p.deprecated);
20
+ return [
21
+ ...required,
22
+ ...significantOptional.slice(0, MAX_OPTIONAL_OWN_PROPS_SHOWN),
23
+ ];
24
+ }
25
+ /**
26
+ * Компактная карточка компонента — без полных доков и без тел примеров.
27
+ * Замеры на существующем meta.json показали: полная запись TableCanvas
28
+ * весит 682k символов, что целиком исчерпало бы контекст агента одним
29
+ * вызовом. Здесь — только то, что нужно решить "это ли компонент" и куда
30
+ * идти дальше за деталями.
31
+ */
32
+ export function getComponent(index, { name } = {}) {
33
+ const record = findComponent(index, name);
34
+ if (!record) {
35
+ return {
36
+ error: `Компонент "${name}" не найден. Используйте search_components или list_components.`,
37
+ };
38
+ }
39
+ if (!isOkComponent(record)) {
40
+ return { error: record.error };
41
+ }
42
+ const features = listComponentFeatures(index, record.name);
43
+ const exampleTitles = (record.examples || []).map((e) => e.displayName || e.exportName);
44
+ const allOwnProps = record.props || [];
45
+ const shownOwnProps = selectOwnProps(allOwnProps);
46
+ const hiddenOwnPropsCount = allOwnProps.length - shownOwnProps.length;
47
+ const { compoundPartOf } = record;
48
+ // Настоящих примеров нет (exampleTitles: []) — незачем звать инструмент,
49
+ // который вернёт то же самое, что уже есть в minimalUsage этой карточки.
50
+ const examplesHint = exampleTitles.length
51
+ ? '; get_component_examples({name}) — примеры кода'
52
+ : '';
53
+ const nextSteps = compoundPartOf
54
+ ? `Это одновременно compound-часть "${compoundPartOf.part}" у "${compoundPartOf.component}" — за пропсами идите туда: get_component_props({name: ${JSON.stringify(compoundPartOf.component)}, part: ${JSON.stringify(compoundPartOf.part)}})${examplesHint}${features.length ? '; list_features({component}) — фичи компонента' : ''}`
55
+ : `get_component_props({name}) — полные пропсы${hiddenOwnPropsCount > 0
56
+ ? ` (в карточке показано ${shownOwnProps.length} из ${allOwnProps.length})`
57
+ : ''}${examplesHint}${features.length ? '; list_features({component}) — фичи компонента' : ''}`;
58
+ return {
59
+ name: record.name,
60
+ type: record.type,
61
+ category: record.category,
62
+ description: record.description || undefined,
63
+ hint: record.hint || undefined,
64
+ keywords: record.keywords,
65
+ importStatement: record.importStatement,
66
+ deprecated: record.deprecated || undefined,
67
+ deprecationReason: record.deprecationReason,
68
+ legacy: record.legacy || undefined,
69
+ supersededBy: record.supersededBy,
70
+ chooseWhen: record.chooseWhen,
71
+ gotchas: record.gotchas,
72
+ scope: record.scope,
73
+ formVariant: record.formVariant,
74
+ wrappedBy: record.wrappedBy,
75
+ role: record.role !== 'primary' ? record.role : undefined,
76
+ parentComponent: record.parentComponent,
77
+ relatedExports: record.relatedExports,
78
+ compoundPartOf,
79
+ atomicBase: record.atomicBase,
80
+ atomicDataMissing: record.atomicDataMissing || undefined,
81
+ ...(compoundPartOf
82
+ ? {}
83
+ : {
84
+ ownProps: shownOwnProps.map(summarizeProp),
85
+ ownPropsCount: allOwnProps.length,
86
+ inheritedPropsCount: (record.inheritedProps || []).length,
87
+ }),
88
+ compoundParts: (record.compoundParts || []).map((p) => p.name),
89
+ minimalUsage: record.minimalUsage,
90
+ exampleTitles,
91
+ features: features.map((f) => ({
92
+ feature: f.feature,
93
+ legacy: f.legacy || undefined,
94
+ })),
95
+ dataVersionNotice: index.dataVersionNotice,
96
+ nextSteps,
97
+ };
98
+ }
99
+ //# sourceMappingURL=getComponent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getComponent.js","sourceRoot":"","sources":["../../src/tools/getComponent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import { isOkComponent } from '../types.js';
2
+ import { findComponent } from './shared.js';
3
+ export function getComponentExamples(index, { name, title } = {}) {
4
+ const record = findComponent(index, name);
5
+ if (!record) {
6
+ return { error: `Компонент "${name}" не найден.` };
7
+ }
8
+ if (!isOkComponent(record)) {
9
+ return { error: record.error };
10
+ }
11
+ const examples = record.examples || [];
12
+ if (!title) {
13
+ return {
14
+ name: record.name,
15
+ titles: examples.map((e) => e.displayName || e.exportName),
16
+ example: examples[0],
17
+ };
18
+ }
19
+ const found = examples.find((e) => (e.displayName || '').toLowerCase() === title.toLowerCase() ||
20
+ (e.exportName || '').toLowerCase() === title.toLowerCase());
21
+ if (!found) {
22
+ return {
23
+ error: `Пример "${title}" не найден у "${record.name}". Доступные: ${examples.map((e) => e.displayName || e.exportName).join(', ') || '(нет)'}`,
24
+ };
25
+ }
26
+ return { name: record.name, example: found };
27
+ }
28
+ //# sourceMappingURL=getComponentExamples.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getComponentExamples.js","sourceRoot":"","sources":["../../src/tools/getComponentExamples.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkB5C,MAAM,UAAU,oBAAoB,CAClC,KAAmB,EACnB,EAAE,IAAI,EAAE,KAAK,KAA+B,EAAE;IAE9C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,cAAc,IAAI,cAAc,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC;YAC1D,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE;QAC3D,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAC7D,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,WAAW,KAAK,kBAAkB,MAAM,CAAC,IAAI,iBAClD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OACnE,EAAE;SACH,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}
@@ -0,0 +1,60 @@
1
+ import { isOkComponent } from '../types.js';
2
+ import { findComponent } from './shared.js';
3
+ /**
4
+ * Пустой props[] у generic-типа — не факт "у компонента нет пропсов", а
5
+ * иногда деградация индексера (структурный резолв генерика не прошёл
6
+ * эвристики безопасности, см. tryExtractGenericProps в parseComponent.ts,
7
+ * и откатился на сырой текст типа). Без явного сигнала агент, полагающийся
8
+ * только на MCP, не может отличить одно от другого и рискует придумать
9
+ * пропсы по общему паттерну (реальный кейс — FormMask до фикса индексера).
10
+ */
11
+ function genericEmptyPropsWarning(isGeneric, propsLength) {
12
+ if (!isGeneric || propsLength > 0)
13
+ return undefined;
14
+ return ('Пропсы не резолвлены (сложный generic-тип) — пустой props[] не значит, ' +
15
+ 'что у компонента их нет. Проверь rawType в этом же ответе, попробуй ' +
16
+ 'get_component_examples, а для компонентов с wrappedBy/atomicBase — ' +
17
+ 'get_component_props по этому имени.');
18
+ }
19
+ export function getComponentProps(index, { name, part } = {}) {
20
+ const record = findComponent(index, name);
21
+ if (!record) {
22
+ return { error: `Компонент "${name}" не найден.` };
23
+ }
24
+ if (!isOkComponent(record)) {
25
+ return { error: record.error };
26
+ }
27
+ if (part) {
28
+ const compoundPart = (record.compoundParts || []).find((p) => p.name.toLowerCase() === part.toLowerCase());
29
+ if (!compoundPart) {
30
+ return {
31
+ error: `Compound-часть "${part}" не найдена у "${record.name}". Доступные: ${(record.compoundParts || []).map((p) => p.name).join(', ') || '(нет)'}`,
32
+ };
33
+ }
34
+ const compoundPartProps = compoundPart.props || [];
35
+ return {
36
+ name: record.name,
37
+ part: compoundPart.name,
38
+ propsTypeName: compoundPart.typeName,
39
+ rawType: compoundPart.rawType,
40
+ isGeneric: compoundPart.isGeneric || undefined,
41
+ props: compoundPartProps,
42
+ warning: genericEmptyPropsWarning(compoundPart.isGeneric, compoundPartProps.length),
43
+ };
44
+ }
45
+ const props = record.props || [];
46
+ return {
47
+ name: record.name,
48
+ propsTypeName: record.propsTypeName,
49
+ rawType: record.rawType,
50
+ isGeneric: record.isGeneric || undefined,
51
+ props,
52
+ inheritedProps: record.inheritedProps || [],
53
+ atomicBase: record.atomicBase,
54
+ atomicDataMissing: record.atomicDataMissing || undefined,
55
+ compoundPartOf: record.compoundPartOf,
56
+ dataVersionNotice: index.dataVersionNotice,
57
+ warning: genericEmptyPropsWarning(record.isGeneric, props.length),
58
+ };
59
+ }
60
+ //# sourceMappingURL=getComponentProps.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getComponentProps.js","sourceRoot":"","sources":["../../src/tools/getComponentProps.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgC5C;;;;;;;GAOG;AACH,SAAS,wBAAwB,CAC/B,SAA8B,EAC9B,WAAmB;IAEnB,IAAI,CAAC,SAAS,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,CACL,yEAAyE;QACzE,sEAAsE;QACtE,qEAAqE;QACrE,qCAAqC,CACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAmB,EACnB,EAAE,IAAI,EAAE,IAAI,KAA4B,EAAE;IAE1C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,cAAc,IAAI,cAAc,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,CACpD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACnD,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;gBACL,KAAK,EAAE,mBAAmB,IAAI,mBAC5B,MAAM,CAAC,IACT,iBACE,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAChE,EAAE;aACH,CAAC;QACJ,CAAC;QACD,MAAM,iBAAiB,GAAG,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;QACnD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,aAAa,EAAE,YAAY,CAAC,QAAQ;YACpC,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,SAAS;YAC9C,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,wBAAwB,CAC/B,YAAY,CAAC,SAAS,EACtB,iBAAiB,CAAC,MAAM,CACzB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;QACxC,KAAK;QACL,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,EAAE;QAC3C,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,SAAS;QACxD,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;KAClE,CAAC;AACJ,CAAC"}
@@ -0,0 +1,19 @@
1
+ import { findFeature } from './shared.js';
2
+ export function getFeature(index, { component, feature } = {}) {
3
+ const found = findFeature(index, component, feature);
4
+ if (!found) {
5
+ return {
6
+ error: `Фича "${feature}" не найдена у "${component}". Используйте list_features({component}).`,
7
+ };
8
+ }
9
+ return {
10
+ component: found.component,
11
+ feature: found.feature,
12
+ legacy: found.legacy || undefined,
13
+ docs: found.docs,
14
+ apiDocs: found.apiDocs,
15
+ api: found.api || [],
16
+ exampleTitles: (found.stories || []).map((s) => s.displayName || s.exportName),
17
+ };
18
+ }
19
+ //# sourceMappingURL=getFeature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getFeature.js","sourceRoot":"","sources":["../../src/tools/getFeature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiB1C,MAAM,UAAU,UAAU,CACxB,KAAmB,EACnB,EAAE,SAAS,EAAE,OAAO,KAAqB,EAAE;IAE3C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,SAAS,OAAO,mBAAmB,SAAS,4CAA4C;SAChG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;QACjC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;QACpB,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CACrC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,27 @@
1
+ import { findFeature } from './shared.js';
2
+ export function getFeatureExamples(index, { component, feature, title } = {}) {
3
+ const found = findFeature(index, component, feature);
4
+ if (!found) {
5
+ return {
6
+ error: `Фича "${feature}" не найдена у "${component}". Используйте list_features({component}).`,
7
+ };
8
+ }
9
+ const stories = found.stories || [];
10
+ if (!title) {
11
+ return {
12
+ component: found.component,
13
+ feature: found.feature,
14
+ titles: stories.map((s) => s.displayName || s.exportName),
15
+ example: stories[0],
16
+ };
17
+ }
18
+ const story = stories.find((s) => (s.displayName || '').toLowerCase() === title.toLowerCase() ||
19
+ (s.exportName || '').toLowerCase() === title.toLowerCase());
20
+ if (!story) {
21
+ return {
22
+ error: `Пример "${title}" не найден у "${component}/${feature}". Доступные: ${stories.map((s) => s.displayName || s.exportName).join(', ') || '(нет)'}`,
23
+ };
24
+ }
25
+ return { component: found.component, feature: found.feature, example: story };
26
+ }
27
+ //# sourceMappingURL=getFeatureExamples.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getFeatureExamples.js","sourceRoot":"","sources":["../../src/tools/getFeatureExamples.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqB1C,MAAM,UAAU,kBAAkB,CAChC,KAAmB,EACnB,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,KAA6B,EAAE;IAE1D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,SAAS,OAAO,mBAAmB,SAAS,4CAA4C;SAChG,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC;YACzD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;SACpB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CACxB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE;QAC3D,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAC7D,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,WAAW,KAAK,kBAAkB,SAAS,IAAI,OAAO,iBAC3D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAClE,EAAE;SACH,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAChF,CAAC"}
@@ -0,0 +1,8 @@
1
+ export function getInstallationGuide(index) {
2
+ const guide = index.guides?.installation;
3
+ if (!guide) {
4
+ return { error: 'Гайд по установке не найден в индексе.' };
5
+ }
6
+ return guide;
7
+ }
8
+ //# sourceMappingURL=getInstallationGuide.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getInstallationGuide.js","sourceRoot":"","sources":["../../src/tools/getInstallationGuide.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,KAAmB;IAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Разворачивает именованный тип, встреченный в тексте пропса компонента
3
+ * (например `columnConfig: readonly ColumnConfig<Row>[]` — get_component_props
4
+ * покажет только имя, этот тул — само определение и готовый import).
5
+ *
6
+ * Некоторые имена неоднозначны: TableCanvas активно переиспользует общие
7
+ * имена типов (свой ColumnConfig, отдельный от легаси-Table.ColumnConfig) —
8
+ * такие типы лежат в индексе под квалифицированным ключом "Папка.Имя". Если
9
+ * запрошено голое имя и оно неоднозначно, возвращаем не первый попавшийся
10
+ * вариант, а список кандидатов для уточнения — тихо угадать здесь хуже, чем
11
+ * спросить: `import { ColumnConfig } from '@daisforge/ui'` без разбора может
12
+ * оказаться совсем не тем ColumnConfig, который агент имел в виду.
13
+ */
14
+ export function getType(index, { name } = {}) {
15
+ if (!name) {
16
+ return { error: 'Не указано имя типа.' };
17
+ }
18
+ const direct = index.types[name];
19
+ if (direct)
20
+ return direct;
21
+ const lowerName = name.toLowerCase();
22
+ const ciKeyMatch = Object.entries(index.types).find(([key]) => key.toLowerCase() === lowerName);
23
+ if (ciKeyMatch)
24
+ return ciKeyMatch[1];
25
+ const candidates = Object.entries(index.types).filter(([, t]) => t.name.toLowerCase() === lowerName);
26
+ if (candidates.length > 0) {
27
+ const keys = candidates.map(([key]) => key).join(', ');
28
+ return {
29
+ error: `Тип "${name}" неоднозначен — в ui-kit несколько разных типов с этим именем в разных модулях. Уточните одним из ключей: ${keys}.`,
30
+ };
31
+ }
32
+ return { error: `Тип "${name}" не найден в индексе.` };
33
+ }
34
+ //# sourceMappingURL=getType.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getType.js","sourceRoot":"","sources":["../../src/tools/getType.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CACrB,KAAmB,EACnB,EAAE,IAAI,KAAkB,EAAE;IAE1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CACjD,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,SAAS,CAC3C,CAAC;IACF,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAErC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CACnD,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS,CAC9C,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO;YACL,KAAK,EAAE,QAAQ,IAAI,8GAA8G,IAAI,GAAG;SACzI,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,IAAI,wBAAwB,EAAE,CAAC;AACzD,CAAC"}
@@ -0,0 +1,19 @@
1
+ import { isOkComponent } from '../types.js';
2
+ export function listCategories(index) {
3
+ const byCategory = new Map();
4
+ Object.values(index.components)
5
+ .filter(isOkComponent)
6
+ .forEach((c) => {
7
+ const key = c.category || '(без категории)';
8
+ const entry = byCategory.get(key) || {
9
+ category: key,
10
+ count: 0,
11
+ types: {},
12
+ };
13
+ entry.count += 1;
14
+ entry.types[c.type] = (entry.types[c.type] || 0) + 1;
15
+ byCategory.set(key, entry);
16
+ });
17
+ return { categories: Array.from(byCategory.values()) };
18
+ }
19
+ //# sourceMappingURL=listCategories.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"listCategories.js","sourceRoot":"","sources":["../../src/tools/listCategories.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,UAAU,cAAc,CAAC,KAAmB;IAGhD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEpD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;SAC5B,MAAM,CAAC,aAAa,CAAC;SACrB,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,iBAAiB,CAAC;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI;YACnC,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,EAAE;SACV,CAAC;QACF,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACjB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACrD,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;AACzD,CAAC"}
@@ -0,0 +1,51 @@
1
+ import { isOkComponent } from '../types.js';
2
+ import { RESPONSE_BUDGET_CHARS, truncateList } from './truncate.js';
3
+ const DESCRIPTION_CLIP_CHARS = 120;
4
+ function clipDescription(description) {
5
+ if (!description)
6
+ return undefined;
7
+ if (description.length <= DESCRIPTION_CLIP_CHARS)
8
+ return description;
9
+ return `${description.slice(0, DESCRIPTION_CLIP_CHARS - 1)}…`;
10
+ }
11
+ export function listComponents(index, { type, category, scope, role, limit, offset } = {}) {
12
+ const roleFilter = role ?? 'primary';
13
+ const filtered = Object.values(index.components)
14
+ .filter(isOkComponent)
15
+ .filter((c) => !type || c.type === type)
16
+ .filter((c) => !category || c.category === category)
17
+ .filter((c) => !scope || c.scope === scope)
18
+ .filter((c) => roleFilter === 'all' || c.role === roleFilter)
19
+ .map((c) => ({
20
+ name: c.name,
21
+ type: c.type,
22
+ category: c.category,
23
+ description: clipDescription(c.description),
24
+ // legacy и deprecated сигналят одно и то же ("не используйте это") —
25
+ // не показываем оба сразу, deprecated значим только сам по себе.
26
+ legacy: c.legacy || undefined,
27
+ deprecated: !c.legacy && c.deprecated ? true : undefined,
28
+ hasFormVariant: c.formVariant ? true : undefined,
29
+ role: c.role !== 'primary' ? c.role : undefined,
30
+ parentComponent: c.role !== 'primary' ? c.parentComponent : undefined,
31
+ }));
32
+ const total = filtered.length;
33
+ if (limit !== undefined || offset !== undefined) {
34
+ const start = offset ?? 0;
35
+ const end = limit !== undefined ? start + limit : filtered.length;
36
+ const page = filtered.slice(start, end);
37
+ const hasMore = end < total;
38
+ return {
39
+ items: page,
40
+ shown: page.length,
41
+ total,
42
+ hasMore,
43
+ truncationNotice: hasMore
44
+ ? `Показано ${page.length} из ${total}. Следующая страница: offset=${end}.`
45
+ : undefined,
46
+ };
47
+ }
48
+ const result = truncateList(filtered, RESPONSE_BUDGET_CHARS);
49
+ return { ...result, hasMore: result.shown < result.total || undefined };
50
+ }
51
+ //# sourceMappingURL=listComponents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"listComponents.js","sourceRoot":"","sources":["../../src/tools/listComponents.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import { listComponentFeatures } from './shared.js';
2
+ export function listFeatures(index, { component } = {}) {
3
+ if (!component) {
4
+ return { error: 'Параметр component обязателен.' };
5
+ }
6
+ const features = listComponentFeatures(index, component);
7
+ return {
8
+ component,
9
+ count: features.length,
10
+ features: features.map((f) => ({
11
+ feature: f.feature,
12
+ summary: f.summary,
13
+ legacy: f.legacy || undefined,
14
+ })),
15
+ };
16
+ }
17
+ //# sourceMappingURL=listFeatures.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"listFeatures.js","sourceRoot":"","sources":["../../src/tools/listFeatures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAkBpD,MAAM,UAAU,YAAY,CAC1B,KAAmB,EACnB,EAAE,SAAS,KAAuB,EAAE;IAEpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACzD,OAAO;QACL,SAAS;QACT,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;SAC9B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}