@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.
- package/README.md +140 -0
- package/data/component-index.json +45769 -0
- package/dist/indexer/buildIndex.js +323 -0
- package/dist/indexer/buildIndex.js.map +1 -0
- package/dist/indexer/classify.js +129 -0
- package/dist/indexer/classify.js.map +1 -0
- package/dist/indexer/classifyRole.js +58 -0
- package/dist/indexer/classifyRole.js.map +1 -0
- package/dist/indexer/collectUsageExamples.js +261 -0
- package/dist/indexer/collectUsageExamples.js.map +1 -0
- package/dist/indexer/diagnostics.js +85 -0
- package/dist/indexer/diagnostics.js.map +1 -0
- package/dist/indexer/discoverComponents.js +119 -0
- package/dist/indexer/discoverComponents.js.map +1 -0
- package/dist/indexer/htmlAttributeDenylist.js +254 -0
- package/dist/indexer/htmlAttributeDenylist.js.map +1 -0
- package/dist/indexer/indexFeatures.js +56 -0
- package/dist/indexer/indexFeatures.js.map +1 -0
- package/dist/indexer/indexTypes.js +44 -0
- package/dist/indexer/indexTypes.js.map +1 -0
- package/dist/indexer/mergeAtomicCuratedMeta.js +45 -0
- package/dist/indexer/mergeAtomicCuratedMeta.js.map +1 -0
- package/dist/indexer/mergeAtomicData.js +188 -0
- package/dist/indexer/mergeAtomicData.js.map +1 -0
- package/dist/indexer/mergeMeta.js +85 -0
- package/dist/indexer/mergeMeta.js.map +1 -0
- package/dist/indexer/parseComponent.js +715 -0
- package/dist/indexer/parseComponent.js.map +1 -0
- package/dist/indexer/resolveImportPath.js +69 -0
- package/dist/indexer/resolveImportPath.js.map +1 -0
- package/dist/indexer/synthesizeExample.js +41 -0
- package/dist/indexer/synthesizeExample.js.map +1 -0
- package/dist/indexer/tsProject.js +24 -0
- package/dist/indexer/tsProject.js.map +1 -0
- package/dist/indexer/vendorAtomicData.js +57 -0
- package/dist/indexer/vendorAtomicData.js.map +1 -0
- package/dist/indexer/vendorExamples.js +60 -0
- package/dist/indexer/vendorExamples.js.map +1 -0
- package/dist/indexer/vendorUsageExamples.js +111 -0
- package/dist/indexer/vendorUsageExamples.js.map +1 -0
- package/dist/resolveIndex.js +87 -0
- package/dist/resolveIndex.js.map +1 -0
- package/dist/server.js +114 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/getComponent.js +99 -0
- package/dist/tools/getComponent.js.map +1 -0
- package/dist/tools/getComponentExamples.js +28 -0
- package/dist/tools/getComponentExamples.js.map +1 -0
- package/dist/tools/getComponentProps.js +60 -0
- package/dist/tools/getComponentProps.js.map +1 -0
- package/dist/tools/getFeature.js +19 -0
- package/dist/tools/getFeature.js.map +1 -0
- package/dist/tools/getFeatureExamples.js +27 -0
- package/dist/tools/getFeatureExamples.js.map +1 -0
- package/dist/tools/getInstallationGuide.js +8 -0
- package/dist/tools/getInstallationGuide.js.map +1 -0
- package/dist/tools/getType.js +34 -0
- package/dist/tools/getType.js.map +1 -0
- package/dist/tools/listCategories.js +19 -0
- package/dist/tools/listCategories.js.map +1 -0
- package/dist/tools/listComponents.js +51 -0
- package/dist/tools/listComponents.js.map +1 -0
- package/dist/tools/listFeatures.js +17 -0
- package/dist/tools/listFeatures.js.map +1 -0
- package/dist/tools/searchComponents.js +176 -0
- package/dist/tools/searchComponents.js.map +1 -0
- package/dist/tools/shared.js +39 -0
- package/dist/tools/shared.js.map +1 -0
- package/dist/tools/truncate.js +81 -0
- package/dist/tools/truncate.js.map +1 -0
- package/dist/types.js +9 -0
- package/dist/types.js.map +1 -0
- package/dist/validate/validateIndex.js +200 -0
- package/dist/validate/validateIndex.js.map +1 -0
- package/package.json +59 -0
|
@@ -0,0 +1,261 @@
|
|
|
1
|
+
/* eslint-disable no-continue */
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { ts } from 'ts-morph';
|
|
5
|
+
import { REPO_ROOT } from './tsProject.js';
|
|
6
|
+
/**
|
|
7
|
+
* Сбор реальных JSX-вхождений компонентов по монорепо (TASKS.md T3) —
|
|
8
|
+
* лучший доступный источник примеров: код заведомо компилируется и отражает
|
|
9
|
+
* реальные паттерны применения, в отличие от synthesizeMinimalUsage
|
|
10
|
+
* (плейсхолдеры) и в дополнение к curated Storybook-стори (покрывают лишь
|
|
11
|
+
* часть каталога).
|
|
12
|
+
*
|
|
13
|
+
* Разбор через сырой TypeScript-компилятор (ts.createSourceFile), а не
|
|
14
|
+
* через общий ts-morph Project из tsProject.ts: нужен только синтаксис
|
|
15
|
+
* (найти JSX-теги), не типы — добавлять сотни сторибук/vite-project файлов,
|
|
16
|
+
* которые лежат вне tsconfig.lib.json ui-kit, в общий типизированный проект
|
|
17
|
+
* дорого и не нужно для этой задачи.
|
|
18
|
+
*/
|
|
19
|
+
const CODE_EXTENSIONS = new Set(['.ts', '.tsx']);
|
|
20
|
+
const IGNORED_DIR_NAMES = new Set([
|
|
21
|
+
'node_modules',
|
|
22
|
+
'dist',
|
|
23
|
+
'build',
|
|
24
|
+
'coverage',
|
|
25
|
+
'__snapshots__',
|
|
26
|
+
'storybook-static',
|
|
27
|
+
]);
|
|
28
|
+
/** "Разумный размер" примера — усечение длинного JSX-блока, не поиск валидного среза. */
|
|
29
|
+
const MAX_USAGE_CODE_CHARS = 700;
|
|
30
|
+
/** Не больше 1–2 самых "богатых" (по числу разных пропсов) вхождений на компонент — см. TASKS.md T3. */
|
|
31
|
+
const MAX_CANDIDATES_PER_COMPONENT = 2;
|
|
32
|
+
/**
|
|
33
|
+
* "apps/**, packages/** кроме ui-kit" из формулировки задачи — в этом
|
|
34
|
+
* чекауте физически есть только packages/storybook и packages/vite-project
|
|
35
|
+
* (webpack-finportal-platform/webpack-project-finalheader из CLAUDE.md здесь
|
|
36
|
+
* не выкачаны), но список считается динамически по содержимому apps/ и
|
|
37
|
+
* packages/, а не хардкодится — появятся новые пакеты-потребители, попадут
|
|
38
|
+
* в поиск сами. mcp-server исключён явно: это сам MCP-сервер, а не
|
|
39
|
+
* потребитель ui-kit, сканировать его src на JSX-вхождения бессмысленно.
|
|
40
|
+
*/
|
|
41
|
+
function listSearchRoots() {
|
|
42
|
+
const roots = [];
|
|
43
|
+
const appsDir = path.join(REPO_ROOT, 'apps');
|
|
44
|
+
if (fs.existsSync(appsDir)) {
|
|
45
|
+
fs.readdirSync(appsDir, { withFileTypes: true })
|
|
46
|
+
.filter((d) => d.isDirectory())
|
|
47
|
+
.forEach((d) => roots.push(path.join(appsDir, d.name)));
|
|
48
|
+
}
|
|
49
|
+
const packagesDir = path.join(REPO_ROOT, 'packages');
|
|
50
|
+
fs.readdirSync(packagesDir, { withFileTypes: true })
|
|
51
|
+
.filter((d) => d.isDirectory())
|
|
52
|
+
.filter((d) => d.name !== 'ui-kit' && d.name !== 'mcp-server')
|
|
53
|
+
.forEach((d) => roots.push(path.join(packagesDir, d.name)));
|
|
54
|
+
return roots;
|
|
55
|
+
}
|
|
56
|
+
function collectCodeFiles(root) {
|
|
57
|
+
const files = [];
|
|
58
|
+
const stack = [root];
|
|
59
|
+
while (stack.length) {
|
|
60
|
+
const dir = stack.pop();
|
|
61
|
+
let entries;
|
|
62
|
+
try {
|
|
63
|
+
entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
64
|
+
}
|
|
65
|
+
catch {
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
for (const entry of entries) {
|
|
69
|
+
if (entry.name.startsWith('.') || IGNORED_DIR_NAMES.has(entry.name)) {
|
|
70
|
+
continue;
|
|
71
|
+
}
|
|
72
|
+
const full = path.join(dir, entry.name);
|
|
73
|
+
if (entry.isDirectory()) {
|
|
74
|
+
stack.push(full);
|
|
75
|
+
}
|
|
76
|
+
else if (entry.isFile() &&
|
|
77
|
+
CODE_EXTENSIONS.has(path.extname(entry.name)) &&
|
|
78
|
+
!entry.name.endsWith('.d.ts')) {
|
|
79
|
+
files.push(full);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return files;
|
|
84
|
+
}
|
|
85
|
+
/** Модуль реально ведёт в ui-kit — публикуемый пакет или монорепный алиас на исходники. */
|
|
86
|
+
const UI_KIT_SPECIFIER = /^@daisforge\/ui(\/.*)?$/;
|
|
87
|
+
const UI_KIT_ALIAS_SPECIFIER = /^@ui-kit\//;
|
|
88
|
+
function isUiKitSpecifier(spec) {
|
|
89
|
+
return UI_KIT_SPECIFIER.test(spec) || UI_KIT_ALIAS_SPECIFIER.test(spec);
|
|
90
|
+
}
|
|
91
|
+
function collectUiKitImports(sourceFile) {
|
|
92
|
+
const named = new Map();
|
|
93
|
+
const namespaces = new Set();
|
|
94
|
+
sourceFile.forEachChild((stmt) => {
|
|
95
|
+
if (!ts.isImportDeclaration(stmt))
|
|
96
|
+
return;
|
|
97
|
+
if (!ts.isStringLiteral(stmt.moduleSpecifier))
|
|
98
|
+
return;
|
|
99
|
+
if (!isUiKitSpecifier(stmt.moduleSpecifier.text))
|
|
100
|
+
return;
|
|
101
|
+
const bindings = stmt.importClause?.namedBindings;
|
|
102
|
+
if (!bindings)
|
|
103
|
+
return;
|
|
104
|
+
if (ts.isNamespaceImport(bindings)) {
|
|
105
|
+
namespaces.add(bindings.name.text);
|
|
106
|
+
}
|
|
107
|
+
else if (ts.isNamedImports(bindings)) {
|
|
108
|
+
bindings.elements.forEach((el) => {
|
|
109
|
+
named.set(el.name.text, (el.propertyName ?? el.name).text);
|
|
110
|
+
});
|
|
111
|
+
}
|
|
112
|
+
});
|
|
113
|
+
return { named, namespaces };
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* Резолвит JSX-тег к реальному имени экспорта ui-kit — только если он
|
|
117
|
+
* действительно пришёл из ui-kit-импорта этого же файла (см. FileImports).
|
|
118
|
+
*
|
|
119
|
+
* Compound-части в реальном коде почти всегда пишут dot-notation
|
|
120
|
+
* (`<DrawerDF.Content>`, `<ModalDF.Header>`), а не плоским именем — но именно
|
|
121
|
+
* плоское склеенное имя (`DrawerDFContent`) лежит в индексе как отдельная
|
|
122
|
+
* top-level запись для 10 известных пар (см. linkCompoundPartDuplicates в
|
|
123
|
+
* buildIndex.ts, TASKS.md T12): если `DrawerDF` импортирован из ui-kit,
|
|
124
|
+
* `<DrawerDF.Content>` резолвится в `DrawerDFContent`. Без этой ветки все 10
|
|
125
|
+
* таких записей были бы обречены на 0 примеров — их плоское имя в
|
|
126
|
+
* исходниках просто не пишут. `<Widget.Header>`, где `Widget` не входит в
|
|
127
|
+
* T12-пары, даст `WidgetHeader` — не найдёт совпадения среди knownNames в
|
|
128
|
+
* record() ниже и будет отброшен, без ложного срабатывания.
|
|
129
|
+
*/
|
|
130
|
+
function resolveComponentName(tagName, imports) {
|
|
131
|
+
if (ts.isIdentifier(tagName)) {
|
|
132
|
+
return imports.named.get(tagName.text);
|
|
133
|
+
}
|
|
134
|
+
if (ts.isPropertyAccessExpression(tagName) &&
|
|
135
|
+
ts.isIdentifier(tagName.expression) &&
|
|
136
|
+
ts.isIdentifier(tagName.name)) {
|
|
137
|
+
if (imports.namespaces.has(tagName.expression.text)) {
|
|
138
|
+
return tagName.name.text;
|
|
139
|
+
}
|
|
140
|
+
const realParent = imports.named.get(tagName.expression.text);
|
|
141
|
+
return realParent ? `${realParent}${tagName.name.text}` : undefined;
|
|
142
|
+
}
|
|
143
|
+
return undefined;
|
|
144
|
+
}
|
|
145
|
+
function clipCode(raw) {
|
|
146
|
+
const trimmed = raw.trim();
|
|
147
|
+
return trimmed.length > MAX_USAGE_CODE_CHARS
|
|
148
|
+
? `${trimmed.slice(0, MAX_USAGE_CODE_CHARS)}\n// … (обрезано)`
|
|
149
|
+
: trimmed;
|
|
150
|
+
}
|
|
151
|
+
/** Разбирает один файл, дописывая найденные JSX-вхождения известных компонентов в candidates. */
|
|
152
|
+
function scanFile(filePath, knownNames, candidates) {
|
|
153
|
+
let text;
|
|
154
|
+
try {
|
|
155
|
+
text = fs.readFileSync(filePath, 'utf8');
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
const scriptKind = filePath.endsWith('.tsx')
|
|
161
|
+
? ts.ScriptKind.TSX
|
|
162
|
+
: ts.ScriptKind.TS;
|
|
163
|
+
const sourceFile = ts.createSourceFile(filePath, text, ts.ScriptTarget.Latest, false, scriptKind);
|
|
164
|
+
const relSourceFile = path.relative(REPO_ROOT, filePath);
|
|
165
|
+
const imports = collectUiKitImports(sourceFile);
|
|
166
|
+
if (!imports.named.size && !imports.namespaces.size)
|
|
167
|
+
return; // файл вообще не импортирует ui-kit — сканировать нечего
|
|
168
|
+
const record = (name, node, attrs) => {
|
|
169
|
+
if (!knownNames.has(name))
|
|
170
|
+
return;
|
|
171
|
+
const code = clipCode(node.getText(sourceFile));
|
|
172
|
+
if (!code)
|
|
173
|
+
return;
|
|
174
|
+
const list = candidates.get(name) ?? [];
|
|
175
|
+
list.push({
|
|
176
|
+
code,
|
|
177
|
+
propCount: attrs.properties.length,
|
|
178
|
+
sourceFile: relSourceFile,
|
|
179
|
+
});
|
|
180
|
+
candidates.set(name, list);
|
|
181
|
+
};
|
|
182
|
+
const visit = (node) => {
|
|
183
|
+
if (ts.isJsxSelfClosingElement(node)) {
|
|
184
|
+
const name = resolveComponentName(node.tagName, imports);
|
|
185
|
+
if (name)
|
|
186
|
+
record(name, node, node.attributes);
|
|
187
|
+
}
|
|
188
|
+
else if (ts.isJsxElement(node)) {
|
|
189
|
+
const name = resolveComponentName(node.openingElement.tagName, imports);
|
|
190
|
+
if (name)
|
|
191
|
+
record(name, node, node.openingElement.attributes);
|
|
192
|
+
}
|
|
193
|
+
ts.forEachChild(node, visit);
|
|
194
|
+
};
|
|
195
|
+
try {
|
|
196
|
+
visit(sourceFile);
|
|
197
|
+
}
|
|
198
|
+
catch {
|
|
199
|
+
// Синтаксически необычный файл (например, сгенерированный) не должен ронять всю сборку индекса.
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
* Из всех найденных вхождений компонента отбирает до MAX_CANDIDATES_PER_COMPONENT
|
|
204
|
+
* самых информативных: по убыванию числа разных пропсов, при равенстве — короче
|
|
205
|
+
* (меньше риск попасть под обрезку), и по возможности из разных файлов —
|
|
206
|
+
* два вхождения из одного и того же стори дают меньше сигнала, чем два из
|
|
207
|
+
* разных мест применения.
|
|
208
|
+
*/
|
|
209
|
+
function pickRichest(list) {
|
|
210
|
+
const seenCode = new Set();
|
|
211
|
+
const deduped = list.filter((c) => {
|
|
212
|
+
if (seenCode.has(c.code))
|
|
213
|
+
return false;
|
|
214
|
+
seenCode.add(c.code);
|
|
215
|
+
return true;
|
|
216
|
+
});
|
|
217
|
+
const sorted = [...deduped].sort((a, b) => b.propCount - a.propCount || a.code.length - b.code.length);
|
|
218
|
+
const picked = [];
|
|
219
|
+
const usedFiles = new Set();
|
|
220
|
+
for (const c of sorted) {
|
|
221
|
+
if (picked.length >= MAX_CANDIDATES_PER_COMPONENT)
|
|
222
|
+
break;
|
|
223
|
+
if (usedFiles.has(c.sourceFile))
|
|
224
|
+
continue;
|
|
225
|
+
picked.push(c);
|
|
226
|
+
usedFiles.add(c.sourceFile);
|
|
227
|
+
}
|
|
228
|
+
for (const c of sorted) {
|
|
229
|
+
if (picked.length >= MAX_CANDIDATES_PER_COMPONENT)
|
|
230
|
+
break;
|
|
231
|
+
if (!picked.includes(c))
|
|
232
|
+
picked.push(c);
|
|
233
|
+
}
|
|
234
|
+
return picked;
|
|
235
|
+
}
|
|
236
|
+
/**
|
|
237
|
+
* Однопроходный сбор: обходит все файлы поисковых корней один раз (не по
|
|
238
|
+
* разу на компонент — при 240+ именах это было бы O(имена × файлы)),
|
|
239
|
+
* возвращает готовый Map<имя компонента, до 2 ExampleRecord type: 'usage'>.
|
|
240
|
+
*/
|
|
241
|
+
export function buildUsageExamples(componentNames) {
|
|
242
|
+
const knownNames = new Set(componentNames);
|
|
243
|
+
const candidates = new Map();
|
|
244
|
+
const files = listSearchRoots().flatMap((root) => collectCodeFiles(root));
|
|
245
|
+
files.forEach((file) => scanFile(file, knownNames, candidates));
|
|
246
|
+
const result = new Map();
|
|
247
|
+
candidates.forEach((list, name) => {
|
|
248
|
+
const top = pickRichest(list);
|
|
249
|
+
if (!top.length)
|
|
250
|
+
return;
|
|
251
|
+
result.set(name, top.map((c, i) => ({
|
|
252
|
+
exportName: top.length > 1 ? `Usage${i + 1}` : 'Usage',
|
|
253
|
+
displayName: `Использование в ${path.basename(c.sourceFile)}`,
|
|
254
|
+
type: 'usage',
|
|
255
|
+
code: c.code,
|
|
256
|
+
sourceFile: c.sourceFile,
|
|
257
|
+
})));
|
|
258
|
+
});
|
|
259
|
+
return result;
|
|
260
|
+
}
|
|
261
|
+
//# sourceMappingURL=collectUsageExamples.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collectUsageExamples.js","sourceRoot":"","sources":["../../src/indexer/collectUsageExamples.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { isOkComponent } from '../types.js';
|
|
2
|
+
import { ATOMIC_TABLE_ON_PARENT_PAGE } from './mergeAtomicData.js';
|
|
3
|
+
const YELLOW = '\x1b[33m';
|
|
4
|
+
const RED = '\x1b[31m';
|
|
5
|
+
const GREEN = '\x1b[32m';
|
|
6
|
+
const RESET = '\x1b[0m';
|
|
7
|
+
const BOLD = '\x1b[1m';
|
|
8
|
+
const RESPONSE_BUDGET_CHARS = 25000;
|
|
9
|
+
/**
|
|
10
|
+
* Дыры вендоренного снэпшота бывают трёх сортов (T15, ARCHITECTURE.md §1.6b), и
|
|
11
|
+
* без пометки они выглядят в логе одинаково — а лечатся по-разному: одни
|
|
12
|
+
* закроются перегенерацией снэпшота у атомарной команды, другие не закроются
|
|
13
|
+
* никогда (атома нет в их доках вовсе), третьи означают новую, ещё не
|
|
14
|
+
* разобранную дыру, появившуюся после очередного перевендоринга.
|
|
15
|
+
*/
|
|
16
|
+
function describeAtomicGap(atomicBase) {
|
|
17
|
+
if (!atomicBase)
|
|
18
|
+
return 'atomicBase не резолвился';
|
|
19
|
+
const parentPage = ATOMIC_TABLE_ON_PARENT_PAGE[atomicBase];
|
|
20
|
+
if (parentPage) {
|
|
21
|
+
return `таблица есть на странице ${parentPage}, но снэпшот берёт со страницы только первую (ожидаемо, T15)`;
|
|
22
|
+
}
|
|
23
|
+
// Отличить «страницы нет в доках вовсе» (Divider, Rating, типографика,
|
|
24
|
+
// compound-части Drawer) от «страница появилась, а снэпшот устарел» по самому
|
|
25
|
+
// снэпшоту невозможно — сверка идёт по докам атомарной команды при
|
|
26
|
+
// перевендоринге, см. ARCHITECTURE.md §1.6b/§6.
|
|
27
|
+
return 'страницы атома нет в снэпшоте — пропсы только из собственного резолва ts-morph';
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Диагностика по аналогии с generate-meta.js: без неё деградация индекса
|
|
31
|
+
* (недопарсенный компонент, сломанный compound-парсинг, атом без вендоренных
|
|
32
|
+
* данных) остаётся незаметной до первой жалобы пользователя MCP.
|
|
33
|
+
*/
|
|
34
|
+
export function printDiagnostics(records, features) {
|
|
35
|
+
const errors = [];
|
|
36
|
+
const warnings = [];
|
|
37
|
+
records.forEach((r) => {
|
|
38
|
+
if (!isOkComponent(r)) {
|
|
39
|
+
errors.push(`${r.name}: ${r.error}`);
|
|
40
|
+
return;
|
|
41
|
+
}
|
|
42
|
+
if (r.atomicDataMissing) {
|
|
43
|
+
warnings.push(`${r.name}: atomicBase "${r.atomicBase}" не найден в вендоренных данных` +
|
|
44
|
+
` — ${describeAtomicGap(r.atomicBase)}`);
|
|
45
|
+
}
|
|
46
|
+
if (!r.props?.length && !r.inheritedProps?.length && !r.isGeneric) {
|
|
47
|
+
warnings.push(`${r.name}: пустой список пропсов`);
|
|
48
|
+
}
|
|
49
|
+
const size = JSON.stringify(r).length;
|
|
50
|
+
if (size > RESPONSE_BUDGET_CHARS * 4) {
|
|
51
|
+
warnings.push(`${r.name}: запись ${size} символов — сильно больше бюджета ответа`);
|
|
52
|
+
}
|
|
53
|
+
});
|
|
54
|
+
const okRecords = records.filter(isOkComponent);
|
|
55
|
+
const byType = {};
|
|
56
|
+
okRecords.forEach((r) => {
|
|
57
|
+
byType[r.type] = (byType[r.type] || 0) + 1;
|
|
58
|
+
});
|
|
59
|
+
const withCuratedMeta = okRecords.filter((r) => r.hasCuratedMeta).length;
|
|
60
|
+
const withAtomicBase = okRecords.filter((r) => r.atomicBase).length;
|
|
61
|
+
const withFormVariant = okRecords.filter((r) => r.formVariant).length;
|
|
62
|
+
console.log(`\n${BOLD}═══ Диагностика mcp-server индексера ═══${RESET}`);
|
|
63
|
+
console.log(`Компонентов: ${records.length} | Фичей: ${features.length} | ` +
|
|
64
|
+
`Курировано (meta.json): ${withCuratedMeta} | С atomicBase: ${withAtomicBase} | Form-связей: ${withFormVariant}`);
|
|
65
|
+
console.log(`По типам: ${JSON.stringify(byType)}`);
|
|
66
|
+
if (errors.length > 0) {
|
|
67
|
+
console.log(`\n${RED}${BOLD}ОШИБКИ (${errors.length})${RESET}`);
|
|
68
|
+
errors.forEach((e) => console.log(`${RED} ✗ ${e}${RESET}`));
|
|
69
|
+
}
|
|
70
|
+
if (warnings.length > 0) {
|
|
71
|
+
console.log(`\n${YELLOW}${BOLD}ПРЕДУПРЕЖДЕНИЯ (${warnings.length})${RESET}`);
|
|
72
|
+
warnings
|
|
73
|
+
.slice(0, 30)
|
|
74
|
+
.forEach((w) => console.log(`${YELLOW} ⚠ ${w}${RESET}`));
|
|
75
|
+
if (warnings.length > 30) {
|
|
76
|
+
console.log(`${YELLOW} ... и ещё ${warnings.length - 30}${RESET}`);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
if (errors.length === 0 && warnings.length === 0) {
|
|
80
|
+
console.log(`${GREEN}Без ошибок и предупреждений.${RESET}`);
|
|
81
|
+
}
|
|
82
|
+
console.log('');
|
|
83
|
+
return { errors, warnings };
|
|
84
|
+
}
|
|
85
|
+
//# sourceMappingURL=diagnostics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/indexer/diagnostics.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
/* eslint-disable no-continue */
|
|
2
|
+
/* eslint-disable no-bitwise */
|
|
3
|
+
import fs from 'node:fs';
|
|
4
|
+
import path from 'node:path';
|
|
5
|
+
import { SymbolFlags } from 'ts-morph';
|
|
6
|
+
import { getProject, UI_KIT_SRC } from './tsProject.js';
|
|
7
|
+
const GROUPS = [
|
|
8
|
+
{ dir: 'components', group: 'components' },
|
|
9
|
+
{ dir: 'formComponents', group: 'formComponents' },
|
|
10
|
+
{ dir: 'layouts', group: 'layouts' },
|
|
11
|
+
];
|
|
12
|
+
// Папки, физически лежащие рядом с компонентами, но не являющиеся ими —
|
|
13
|
+
// внутренние Storybook-хелперы и т.п. Небольшой явный список, а не эвристика,
|
|
14
|
+
// потому что их экспорты (PascalCase функции) неотличимы от реальных
|
|
15
|
+
// компонентов по одним только флагам символа.
|
|
16
|
+
const EXCLUDED_DIRS = new Set(['StoriesUtils']);
|
|
17
|
+
/**
|
|
18
|
+
* Отдельные PascalCase value-экспорты внутри иначе легитимных барреля
|
|
19
|
+
* компонентов, которые сами компонентами не являются — внутренние классы
|
|
20
|
+
* canvas-рендеринга (TableGlide), API-классы (TableContract), React.Context/
|
|
21
|
+
* внутренний класс-держатель рефов (Tabs, TableTabs) и объекты с именами
|
|
22
|
+
* CSS-классов (GridDND, Layout). Они случайно удовлетворяют тем же флагам
|
|
23
|
+
* символа (Variable/Function/Class), что и настоящие компоненты — по
|
|
24
|
+
* аналогии с EXCLUDED_DIRS, явный список, а не эвристика: попытка отличить
|
|
25
|
+
* их структурно через `T extends JSXElementConstructor<any>` дала 80+
|
|
26
|
+
* ложных срабатываний на настоящих компонентах (FormTextField, Select,
|
|
27
|
+
* PageLayout...) — тайпчекер слишком часто не резолвит такую форму для
|
|
28
|
+
* generic/forwardRef-обёрток, так что как сигнал она непригодна.
|
|
29
|
+
*/
|
|
30
|
+
const EXCLUDED_NAMES = new Set([
|
|
31
|
+
// TableGlide/lib/canvas — внутренние примитивы canvas-рендеринга
|
|
32
|
+
'CanvasAbsoluteContainer',
|
|
33
|
+
'CanvasHoverController',
|
|
34
|
+
'CanvasLeaf',
|
|
35
|
+
'CanvasRegistry',
|
|
36
|
+
'CanvasRoot',
|
|
37
|
+
'DrawBatcher',
|
|
38
|
+
'CanvasChevron',
|
|
39
|
+
'CellCanvasRoot',
|
|
40
|
+
'FlexBox',
|
|
41
|
+
'FlexElement',
|
|
42
|
+
'RootFlexBox',
|
|
43
|
+
// TableContract/api — API-классы, не компоненты
|
|
44
|
+
'DataViewApi',
|
|
45
|
+
'EditingApi',
|
|
46
|
+
// React.Context и внутренний класс-держатель рефов, а не компоненты
|
|
47
|
+
'TableTabsContext',
|
|
48
|
+
'TabsContext',
|
|
49
|
+
'TabItemRefs',
|
|
50
|
+
// Объекты с именами CSS-классов
|
|
51
|
+
'GridDNDClassNames',
|
|
52
|
+
'LayoutDfClassNames',
|
|
53
|
+
// Класс диапазона выделения из glide-data-grid, не компонент
|
|
54
|
+
'CompactSelection',
|
|
55
|
+
]);
|
|
56
|
+
function isAllCaps(name) {
|
|
57
|
+
return /^[A-Z0-9_]+$/.test(name);
|
|
58
|
+
}
|
|
59
|
+
function findBarrelPath(compDir) {
|
|
60
|
+
const indexTs = path.join(compDir, 'index.ts');
|
|
61
|
+
if (fs.existsSync(indexTs))
|
|
62
|
+
return indexTs;
|
|
63
|
+
const indexTsx = path.join(compDir, 'index.tsx');
|
|
64
|
+
if (fs.existsSync(indexTsx))
|
|
65
|
+
return indexTsx;
|
|
66
|
+
return undefined;
|
|
67
|
+
}
|
|
68
|
+
/** PascalCase-значение (не тип, не хук, не ALL_CAPS-константа, не enum). */
|
|
69
|
+
function isComponentLikeSymbol(symbol) {
|
|
70
|
+
const name = symbol.getName();
|
|
71
|
+
if (!/^[A-Z]/.test(name) || isAllCaps(name))
|
|
72
|
+
return false;
|
|
73
|
+
const real = symbol.isAlias() ? symbol.getAliasedSymbol() ?? symbol : symbol;
|
|
74
|
+
const flags = real.getFlags();
|
|
75
|
+
const isValueLike = Boolean(flags & (SymbolFlags.Variable | SymbolFlags.Function | SymbolFlags.Class));
|
|
76
|
+
const isEnum = Boolean(flags & SymbolFlags.Enum);
|
|
77
|
+
return isValueLike && !isEnum;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Обходит packages/ui-kit/src/{components,formComponents,layouts} и
|
|
81
|
+
* возвращает список реально экспортируемых компонентов. Одна папка может
|
|
82
|
+
* содержать НЕСКОЛЬКО компонентов (FormDatePickers → FormDatePicker +
|
|
83
|
+
* FormDatePickerRange; Segment → SegmentGroup/SegmentItem/...; IconButton →
|
|
84
|
+
* IconButton/IconButtonDots/IconButtonFilter) — поэтому не полагаемся на
|
|
85
|
+
* совпадение "имя папки == имя компонента", а перечисляем реальные
|
|
86
|
+
* PascalCase value-экспорты barrel-файла.
|
|
87
|
+
*/
|
|
88
|
+
export function discoverComponents() {
|
|
89
|
+
const project = getProject();
|
|
90
|
+
const entries = [];
|
|
91
|
+
for (const { dir, group } of GROUPS) {
|
|
92
|
+
const groupDir = path.join(UI_KIT_SRC, dir);
|
|
93
|
+
if (!fs.existsSync(groupDir))
|
|
94
|
+
continue;
|
|
95
|
+
for (const folderName of fs.readdirSync(groupDir)) {
|
|
96
|
+
if (EXCLUDED_DIRS.has(folderName))
|
|
97
|
+
continue;
|
|
98
|
+
const compDir = path.join(groupDir, folderName);
|
|
99
|
+
if (!fs.statSync(compDir).isDirectory())
|
|
100
|
+
continue;
|
|
101
|
+
const barrelPath = findBarrelPath(compDir);
|
|
102
|
+
if (!barrelPath)
|
|
103
|
+
continue;
|
|
104
|
+
const barrelSourceFile = project.getSourceFileOrThrow(barrelPath);
|
|
105
|
+
const seen = new Set();
|
|
106
|
+
for (const symbol of barrelSourceFile.getExportSymbols()) {
|
|
107
|
+
const name = symbol.getName();
|
|
108
|
+
if (seen.has(name) || EXCLUDED_NAMES.has(name))
|
|
109
|
+
continue;
|
|
110
|
+
if (!isComponentLikeSymbol(symbol))
|
|
111
|
+
continue;
|
|
112
|
+
seen.add(name);
|
|
113
|
+
entries.push({ name, dir: compDir, group, barrelPath, folderName });
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
return entries;
|
|
118
|
+
}
|
|
119
|
+
//# sourceMappingURL=discoverComponents.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"discoverComponents.js","sourceRoot":"","sources":["../../src/indexer/discoverComponents.ts"],"names":[],"mappings":"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"}
|