@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,715 @@
|
|
|
1
|
+
/* eslint-disable no-continue */
|
|
2
|
+
/* eslint-disable no-bitwise */
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { Node, SymbolFlags, SyntaxKind, ts } from 'ts-morph';
|
|
5
|
+
import { isNoiseProp, isReactDomDescription } from './htmlAttributeDenylist.js';
|
|
6
|
+
import { getProject, UI_KIT_SRC } from './tsProject.js';
|
|
7
|
+
const MAX_PROP_TYPE_CHARS = 400;
|
|
8
|
+
export const MAX_RAW_TYPE_CHARS = 6000;
|
|
9
|
+
/** Сужающий guard для ParsedComponent | ParseFailure — тот же приём, что isOkComponent в types.ts. */
|
|
10
|
+
export function isParsedComponent(p) {
|
|
11
|
+
return p.error === undefined;
|
|
12
|
+
}
|
|
13
|
+
/** Обрезает строку с явным маркером — не молча теряет данные. */
|
|
14
|
+
export function clip(text, max) {
|
|
15
|
+
if (!text)
|
|
16
|
+
return text;
|
|
17
|
+
return text.length > max ? `${text.slice(0, max)}…` : text;
|
|
18
|
+
}
|
|
19
|
+
const IMPORT_PATH_PREFIX_RE = /import\("[^"]*"\)\./g;
|
|
20
|
+
/**
|
|
21
|
+
* Тайпчекер печатает ссылки на типы из других файлов как
|
|
22
|
+
* `import("/абсолютный/путь/к/модулю").TypeName` — путь конкретной машины
|
|
23
|
+
* утекает в текст пропса (1029 пропсов в 99 компонентах на момент находки)
|
|
24
|
+
* и впустую жрёт бюджет ответа. Оставляем только `TypeName`.
|
|
25
|
+
*/
|
|
26
|
+
export function stripImportPaths(text) {
|
|
27
|
+
return text.replace(IMPORT_PATH_PREFIX_RE, '');
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Типы пропсов, собранные за весь прогон индексера (module-level, как
|
|
31
|
+
* cachedProject в tsProject.ts или cachedDenylistMap в
|
|
32
|
+
* htmlAttributeDenylist.ts) — buildIndex.ts вызывает parseComponent для
|
|
33
|
+
* каждого компонента синхронно в один процесс, поэтому один общий Map
|
|
34
|
+
* корректно копит находки по всему прогону. Значение — МАССИВ, а не
|
|
35
|
+
* одна декларация: TableCanvas активно переиспользует общие имена типов
|
|
36
|
+
* (свой `ColumnConfig`, отдельный от легаси-`Table.ColumnConfig`), и первое
|
|
37
|
+
* найденное молча маскировало бы остальные при обычном dedup-by-name. Каждая
|
|
38
|
+
* РАЗНАЯ по файлу декларация под одним именем сохраняется отдельно —
|
|
39
|
+
* indexTypes.ts решает, как их различить в итоговых ключах индекса.
|
|
40
|
+
*/
|
|
41
|
+
const collectedTypeDecls = new Map();
|
|
42
|
+
export function getCollectedTypeDecls() {
|
|
43
|
+
return [...collectedTypeDecls.values()];
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Записывает символ как найденный тип, если его декларация — type alias/
|
|
47
|
+
* interface внутри самого ui-kit. Дедуп — по паре (имя, файл декларации):
|
|
48
|
+
* разные типы с одинаковым именем в разных файлах сохраняются оба (см.
|
|
49
|
+
* collectedTypeDecls), но повторные ссылки на ОДИН И ТОТ ЖЕ тип из разных
|
|
50
|
+
* пропсов не плодят дубликаты. true, если что-то записано (или уже было) —
|
|
51
|
+
* вызывающий код использует это, чтобы решить, надо ли ещё разворачивать
|
|
52
|
+
* структуру типа (см. collectNamedTypeRefs).
|
|
53
|
+
*/
|
|
54
|
+
function recordTypeSymbol(symbol) {
|
|
55
|
+
const decl = symbol.getDeclarations()[0];
|
|
56
|
+
if (!decl)
|
|
57
|
+
return false;
|
|
58
|
+
if (!Node.isTypeAliasDeclaration(decl) &&
|
|
59
|
+
!Node.isInterfaceDeclaration(decl)) {
|
|
60
|
+
return false;
|
|
61
|
+
}
|
|
62
|
+
if (!decl.getSourceFile().getFilePath().includes('/packages/ui-kit/src/')) {
|
|
63
|
+
return false;
|
|
64
|
+
}
|
|
65
|
+
const name = symbol.getName();
|
|
66
|
+
const filePath = decl.getSourceFile().getFilePath();
|
|
67
|
+
const existing = collectedTypeDecls.get(name) ?? [];
|
|
68
|
+
if (!existing.some((e) => e.decl.getSourceFile().getFilePath() === filePath)) {
|
|
69
|
+
existing.push({ name, decl });
|
|
70
|
+
collectedTypeDecls.set(name, existing);
|
|
71
|
+
}
|
|
72
|
+
return true;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Структурно (не по тексту типа — там мусор вроде React.ReactNode/Omit и
|
|
76
|
+
* коллизии имён) находит именованные типы, на которые реально ссылается
|
|
77
|
+
* проп, и копит их для индексации. Раскрывает обёртки массива/union/
|
|
78
|
+
* intersection (`MassActionsButtonProps[] | undefined` сам по себе не имеет
|
|
79
|
+
* alias-символа — он есть только у элемента массива), останавливаясь, как
|
|
80
|
+
* только находит именованную декларацию — без рекурсии в её собственное
|
|
81
|
+
* тело (агент при необходимости запросит её отдельным вызовом get_type).
|
|
82
|
+
* Индексируем только типы, объявленные в самом ui-kit — типы React/DOM и
|
|
83
|
+
* @salutejs/* уже приходят как inheritedProps/готовые примитивы.
|
|
84
|
+
*/
|
|
85
|
+
function collectNamedTypeRefs(type, seen) {
|
|
86
|
+
if (seen.has(type))
|
|
87
|
+
return;
|
|
88
|
+
seen.add(type);
|
|
89
|
+
// Alias-символ проверяем ПЕРВЫМ, до любого структурного разбора: у типа,
|
|
90
|
+
// объявленного как `type X = A | B`, одновременно isUnion() === true И
|
|
91
|
+
// getAliasSymbol() === X — если сначала развернуть union, имя X (то,
|
|
92
|
+
// что реально написано в проп-типе, `X[]`/`X | undefined`) потеряется,
|
|
93
|
+
// а вместо него найдутся A/B по отдельности. Раскрываем union/intersection/
|
|
94
|
+
// array только когда у типа НЕТ собственного имени — иначе останавливаемся
|
|
95
|
+
// на найденном алиасе (агент при необходимости заглянет глубже вторым
|
|
96
|
+
// вызовом get_type, как и для обычных вложенных ссылок).
|
|
97
|
+
const aliasSymbol = type.getAliasSymbol();
|
|
98
|
+
if (aliasSymbol) {
|
|
99
|
+
recordTypeSymbol(aliasSymbol);
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
102
|
+
if (type.isArray()) {
|
|
103
|
+
const elementType = type.getArrayElementType();
|
|
104
|
+
if (elementType)
|
|
105
|
+
collectNamedTypeRefs(elementType, seen);
|
|
106
|
+
return;
|
|
107
|
+
}
|
|
108
|
+
if (type.isUnion()) {
|
|
109
|
+
type.getUnionTypes().forEach((t) => collectNamedTypeRefs(t, seen));
|
|
110
|
+
return;
|
|
111
|
+
}
|
|
112
|
+
if (type.isIntersection()) {
|
|
113
|
+
type.getIntersectionTypes().forEach((t) => collectNamedTypeRefs(t, seen));
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
const symbol = type.getSymbol();
|
|
117
|
+
if (symbol)
|
|
118
|
+
recordTypeSymbol(symbol);
|
|
119
|
+
}
|
|
120
|
+
function getJsDocs(node) {
|
|
121
|
+
return Node.isJSDocable(node) ? node.getJsDocs() : [];
|
|
122
|
+
}
|
|
123
|
+
function getJsDocDescription(jsDocable) {
|
|
124
|
+
const docs = getJsDocs(jsDocable);
|
|
125
|
+
return docs
|
|
126
|
+
.map((d) => d.getDescription().trim())
|
|
127
|
+
.filter(Boolean)
|
|
128
|
+
.join('\n');
|
|
129
|
+
}
|
|
130
|
+
function isDeprecated(jsDocable) {
|
|
131
|
+
const docs = getJsDocs(jsDocable);
|
|
132
|
+
return docs.some((d) => d.getTags().some((t) => t.getTagName() === 'deprecated'));
|
|
133
|
+
}
|
|
134
|
+
function getDeprecatedReason(jsDocable) {
|
|
135
|
+
const docs = getJsDocs(jsDocable);
|
|
136
|
+
for (const d of docs) {
|
|
137
|
+
for (const t of d.getTags()) {
|
|
138
|
+
if (t.getTagName() === 'deprecated') {
|
|
139
|
+
return t.getCommentText()?.trim() || undefined;
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
return undefined;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Второй, более редкий источник дефолта (TASKS.md T6) — тег `@default` в
|
|
147
|
+
* JSDoc самого пропса (`/** @default 'm' *\/ size?: Size`). Применяется как
|
|
148
|
+
* фолбэк в extractPropsFromType, только если деструктуризация параметра
|
|
149
|
+
* (collectDestructuringDefaults) не дала значения для этого имени.
|
|
150
|
+
*/
|
|
151
|
+
function getJsDocDefault(jsDocable) {
|
|
152
|
+
const docs = getJsDocs(jsDocable);
|
|
153
|
+
for (const d of docs) {
|
|
154
|
+
for (const t of d.getTags()) {
|
|
155
|
+
if (t.getTagName() === 'default') {
|
|
156
|
+
return t.getCommentText()?.trim() || undefined;
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
return undefined;
|
|
161
|
+
}
|
|
162
|
+
const MAX_DEFAULT_CHARS = 60;
|
|
163
|
+
/**
|
|
164
|
+
* Основной источник дефолтов (TASKS.md T6) — деструктуризация первого
|
|
165
|
+
* параметра render-функции: `({ size = 'm', view = 'default', ...rest })` —
|
|
166
|
+
* самый распространённый в кодовой базе паттерн. Ключ — имя ПРОПСА (левая
|
|
167
|
+
* часть `propertyName: localName`, если есть переименование; иначе то же имя,
|
|
168
|
+
* что и локальная переменная), не локальное имя переменной — иначе
|
|
169
|
+
* `{ size: sizeProp = 'm' }` не смэтчился бы с пропсом `size`. Rest-элемент
|
|
170
|
+
* (`...rest`) пропускается — у него нет содержательного имени пропса.
|
|
171
|
+
*/
|
|
172
|
+
function collectDestructuringDefaults(fn) {
|
|
173
|
+
const map = new Map();
|
|
174
|
+
const nameNode = fn?.getParameters()[0]?.getNameNode();
|
|
175
|
+
if (!nameNode || !Node.isObjectBindingPattern(nameNode))
|
|
176
|
+
return map;
|
|
177
|
+
for (const element of nameNode.getElements()) {
|
|
178
|
+
if (element.getDotDotDotToken())
|
|
179
|
+
continue; // ...rest
|
|
180
|
+
const init = element.getInitializer();
|
|
181
|
+
if (!init)
|
|
182
|
+
continue;
|
|
183
|
+
const propName = element.getPropertyNameNode()?.getText() ?? element.getName();
|
|
184
|
+
const text = clip(init.getText(), MAX_DEFAULT_CHARS);
|
|
185
|
+
if (text)
|
|
186
|
+
map.set(propName, text);
|
|
187
|
+
}
|
|
188
|
+
return map;
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* Резолвит имя, экспортируемое из barrel-файла, до его конечной декларации
|
|
192
|
+
* (следуя через re-export цепочки — в этом и ценность getExportedDeclarations
|
|
193
|
+
* вместо ручного парсинга import/export specifiers).
|
|
194
|
+
*/
|
|
195
|
+
function resolveExportedDeclaration(barrelSourceFile, name) {
|
|
196
|
+
return barrelSourceFile.getExportedDeclarations().get(name)?.[0];
|
|
197
|
+
}
|
|
198
|
+
function isInPackage(sourceFile, pkgName) {
|
|
199
|
+
const filePath = sourceFile.getFilePath();
|
|
200
|
+
return filePath.includes(`/node_modules/${pkgName}/`);
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
* Находит тип пропсов компонента среди экспортов barrel-файла: по
|
|
204
|
+
* соглашению имени (`${Name}Props`, `${Name}CompProps`) либо — если не
|
|
205
|
+
* нашли — среди всех экспортов, заканчивающихся на "Props".
|
|
206
|
+
*/
|
|
207
|
+
function findPropsDeclaration(barrelSourceFile, componentName) {
|
|
208
|
+
const map = barrelSourceFile.getExportedDeclarations();
|
|
209
|
+
const candidates = [`${componentName}Props`, `${componentName}CompProps`];
|
|
210
|
+
for (const candidate of candidates) {
|
|
211
|
+
const decl = map.get(candidate)?.[0];
|
|
212
|
+
if (decl)
|
|
213
|
+
return { name: candidate, decl };
|
|
214
|
+
}
|
|
215
|
+
for (const [name, decls] of map.entries()) {
|
|
216
|
+
if (name.endsWith('Props') &&
|
|
217
|
+
name.toLowerCase().includes(componentName.toLowerCase()) &&
|
|
218
|
+
decls[0]) {
|
|
219
|
+
return { name, decl: decls[0] };
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
return undefined;
|
|
223
|
+
}
|
|
224
|
+
function isInlineRenderFunction(node) {
|
|
225
|
+
return Node.isArrowFunction(node) || Node.isFunctionExpression(node);
|
|
226
|
+
}
|
|
227
|
+
/**
|
|
228
|
+
* Разворачивает forwardRef(...)/memo(...) обёртку до самой render-функции.
|
|
229
|
+
*/
|
|
230
|
+
function unwrapToRenderFunction(node) {
|
|
231
|
+
if (Node.isFunctionDeclaration(node) || isInlineRenderFunction(node)) {
|
|
232
|
+
return node;
|
|
233
|
+
}
|
|
234
|
+
if (Node.isVariableDeclaration(node)) {
|
|
235
|
+
const init = node.getInitializer();
|
|
236
|
+
if (!init)
|
|
237
|
+
return undefined;
|
|
238
|
+
if (isInlineRenderFunction(init))
|
|
239
|
+
return init;
|
|
240
|
+
if (Node.isCallExpression(init)) {
|
|
241
|
+
return init.getArguments().find(isInlineRenderFunction);
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
return undefined;
|
|
245
|
+
}
|
|
246
|
+
/**
|
|
247
|
+
* Фолбек, когда компонент не экспортирует именованный тип пропсов из barrel
|
|
248
|
+
* (случай TableCanvas/Table — `TableProps` объявлен, но не реэкспортирован
|
|
249
|
+
* под предсказуемым именем). Берём тип первого параметра самой render-функции.
|
|
250
|
+
* Если это ссылка на именованный alias/interface — переиспользуем ту же
|
|
251
|
+
* логику (и тот же generic-фолбек), что и для найденных по имени пропсов.
|
|
252
|
+
*/
|
|
253
|
+
function findPropsDeclFromSignature(mainDecl, componentName) {
|
|
254
|
+
const fn = unwrapToRenderFunction(mainDecl);
|
|
255
|
+
const param = fn?.getParameters()[0];
|
|
256
|
+
const typeNode = param?.getTypeNode();
|
|
257
|
+
if (!param || !typeNode)
|
|
258
|
+
return undefined;
|
|
259
|
+
if (Node.isTypeReference(typeNode)) {
|
|
260
|
+
const symbol = typeNode.getTypeName().getSymbol();
|
|
261
|
+
const decl = symbol?.getDeclarations()[0];
|
|
262
|
+
if (decl &&
|
|
263
|
+
(Node.isTypeAliasDeclaration(decl) || Node.isInterfaceDeclaration(decl))) {
|
|
264
|
+
return { name: decl.getName(), decl };
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
// Инлайновый тип литерала/пересечения без отдельного имени — не критично,
|
|
268
|
+
// просто извлекаем свойства прямо из типа параметра.
|
|
269
|
+
return {
|
|
270
|
+
name: `${componentName}Props`,
|
|
271
|
+
inlineParamNode: param,
|
|
272
|
+
};
|
|
273
|
+
}
|
|
274
|
+
function getTypeParameters(decl) {
|
|
275
|
+
if (Node.isTypeAliasDeclaration(decl) || Node.isInterfaceDeclaration(decl)) {
|
|
276
|
+
return decl.getTypeParameters();
|
|
277
|
+
}
|
|
278
|
+
return [];
|
|
279
|
+
}
|
|
280
|
+
/** Свойство `type` в резолве через checker может отсутствовать у mapped/computed членов. */
|
|
281
|
+
function safeGetPropertyType(prop, node) {
|
|
282
|
+
try {
|
|
283
|
+
return prop.getTypeAtLocation(node);
|
|
284
|
+
}
|
|
285
|
+
catch {
|
|
286
|
+
return undefined;
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* true — свойство объявлено в том же файле, что и сам тип пропсов (значит,
|
|
291
|
+
* это поле, которое компонент реально описал сам), а не унаследовано через
|
|
292
|
+
* spread другого типа вроде `BoxProps & { title?: ... }` (объявлен в файле
|
|
293
|
+
* Box, а не DrawerDF). Используется для сортировки — см. extractPropsFromType.
|
|
294
|
+
*/
|
|
295
|
+
function isOwnFileDeclaration(decl, ownFilePath) {
|
|
296
|
+
return (decl !== undefined && decl.getSourceFile().getFilePath() === ownFilePath);
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* Итоговый порядок пропсов (TASKS.md T7): `required` → с описанием → без
|
|
300
|
+
* описания → `deprecated` в самый конец (переопределяет required — устаревший
|
|
301
|
+
* обязательный пропс всё равно уходит в хвост). При обрезке по бюджету
|
|
302
|
+
* (truncateForResponse режет большие ответы по символам без учёта структуры,
|
|
303
|
+
* см. tools/truncate.ts) теряется наименее нужное подмножество, а не
|
|
304
|
+
* случайное. Внутри яруса — сперва поля, объявленные в том же файле, что и
|
|
305
|
+
* сам тип пропсов (собственные, не унаследованные через spread чужого типа
|
|
306
|
+
* вроде `BoxProps & { title?: ... }` — тот приём, что раньше решал проблему
|
|
307
|
+
* DrawerDF.Header, где CSS/layout-пропсы BoxProps съедали лимит раньше
|
|
308
|
+
* `title`/`subTitle`/`rightBlock`), затем — по алфавиту, для стабильности
|
|
309
|
+
* диффов индекса.
|
|
310
|
+
*/
|
|
311
|
+
function propTier(record) {
|
|
312
|
+
if (record.deprecated)
|
|
313
|
+
return 3;
|
|
314
|
+
if (record.required)
|
|
315
|
+
return 0;
|
|
316
|
+
return record.description ? 1 : 2;
|
|
317
|
+
}
|
|
318
|
+
function sortProps(entries) {
|
|
319
|
+
return entries
|
|
320
|
+
.slice()
|
|
321
|
+
.sort((a, b) => {
|
|
322
|
+
const tierDiff = propTier(a.record) - propTier(b.record);
|
|
323
|
+
if (tierDiff !== 0)
|
|
324
|
+
return tierDiff;
|
|
325
|
+
if (a.ownFile !== b.ownFile)
|
|
326
|
+
return a.ownFile ? -1 : 1;
|
|
327
|
+
return a.record.name.localeCompare(b.record.name);
|
|
328
|
+
})
|
|
329
|
+
.map((e) => e.record);
|
|
330
|
+
}
|
|
331
|
+
function extractPropsFromType(type, atLocationNode, defaultsMap) {
|
|
332
|
+
const ownFilePath = atLocationNode.getSourceFile().getFilePath();
|
|
333
|
+
const entries = [];
|
|
334
|
+
for (const symbol of type.getProperties()) {
|
|
335
|
+
const decl = symbol.getValueDeclaration() ?? symbol.getDeclarations()[0];
|
|
336
|
+
const propType = safeGetPropertyType(symbol, decl ?? atLocationNode);
|
|
337
|
+
const fullTypeText = propType ? propType.getText() : 'unknown';
|
|
338
|
+
const name = symbol.getName();
|
|
339
|
+
// Шум от ComponentProps<typeof X>: ~300 унаследованных DOM/ARIA-атрибутов
|
|
340
|
+
// и React-статиков. Фильтруем по имени+типу, а не только по имени — иначе
|
|
341
|
+
// потеряли бы реально переопределённые пропсы вроде Switch.size: "s"|"m"|"l".
|
|
342
|
+
if (isNoiseProp(name, fullTypeText))
|
|
343
|
+
continue;
|
|
344
|
+
if (propType)
|
|
345
|
+
collectNamedTypeRefs(propType, new Set());
|
|
346
|
+
// SymbolFlags.Optional — сигнал от самого тайпчекера после резолва
|
|
347
|
+
// union/intersection, надёжнее чем questionToken на одной из деклараций
|
|
348
|
+
// (при пересечении типов может быть несколько деклараций одного символа).
|
|
349
|
+
const optional = Boolean(symbol.getFlags() & SymbolFlags.Optional);
|
|
350
|
+
let description = '';
|
|
351
|
+
try {
|
|
352
|
+
const parts = symbol.compilerSymbol.getDocumentationComment(getProject().getTypeChecker().compilerObject);
|
|
353
|
+
description = ts.displayPartsToString(parts).trim();
|
|
354
|
+
}
|
|
355
|
+
catch {
|
|
356
|
+
// no doc comment resolvable — не критично
|
|
357
|
+
}
|
|
358
|
+
// TASKS.md T7, п.2: пропсы вроде `role`/`tabIndex`/`color` дизайн-система
|
|
359
|
+
// переопределяет по ТИПУ (проходят isNoiseProp выше), но их описание
|
|
360
|
+
// может остаться нетронутым унаследованным React DOM-текстом
|
|
361
|
+
// ("Indicates the current…") — токены на ветер, дословно совпадающие с
|
|
362
|
+
// денылистом. Не проп-шум (тип-то осмысленный), а описание-шум.
|
|
363
|
+
if (description && isReactDomDescription(name, description)) {
|
|
364
|
+
description = '';
|
|
365
|
+
}
|
|
366
|
+
const deprecated = decl !== undefined &&
|
|
367
|
+
(Node.isPropertySignature(decl) || Node.isPropertyDeclaration(decl))
|
|
368
|
+
? isDeprecated(decl)
|
|
369
|
+
: false;
|
|
370
|
+
const defaultValue = defaultsMap?.get(name) ??
|
|
371
|
+
(decl !== undefined &&
|
|
372
|
+
(Node.isPropertySignature(decl) || Node.isPropertyDeclaration(decl))
|
|
373
|
+
? getJsDocDefault(decl)
|
|
374
|
+
: undefined);
|
|
375
|
+
const record = {
|
|
376
|
+
name,
|
|
377
|
+
type: clip(stripImportPaths(fullTypeText), MAX_PROP_TYPE_CHARS),
|
|
378
|
+
required: !optional,
|
|
379
|
+
description,
|
|
380
|
+
...(deprecated ? { deprecated: true } : {}),
|
|
381
|
+
...(defaultValue ? { default: defaultValue } : {}),
|
|
382
|
+
};
|
|
383
|
+
entries.push({ record, ownFile: isOwnFileDeclaration(decl, ownFilePath) });
|
|
384
|
+
}
|
|
385
|
+
return sortProps(entries);
|
|
386
|
+
}
|
|
387
|
+
/**
|
|
388
|
+
* Порог "нечитаемой простыни" для generic-пропсов (см. resolvePropsType).
|
|
389
|
+
* Число пропсов само по себе не сигнал плохого резолва — среди обычных
|
|
390
|
+
* (не-generic) компонентов легитимно встречается 96-190 своих пропсов
|
|
391
|
+
* (замер на текущем индексе), так что MAX_GENERIC_PROPS — не порог
|
|
392
|
+
* качества, а чисто защитный потолок на случай патологического взрыва
|
|
393
|
+
* членов (рекурсивный mapped-тип и т.п.), с запасом выше макс. легитимного.
|
|
394
|
+
* Настоящий сигнал мусора — доля пропсов с нерезолвящимся ("unknown")
|
|
395
|
+
* типом: если она большая, значит type-параметры генерика не подставились
|
|
396
|
+
* и типы не резолвятся осмысленно — тогда откатываемся на сырой текст типа.
|
|
397
|
+
*/
|
|
398
|
+
const MAX_GENERIC_PROPS = 300;
|
|
399
|
+
const MAX_UNKNOWN_PROP_RATIO = 0.3;
|
|
400
|
+
/**
|
|
401
|
+
* Когда своя типовая декларация не резолвлена (unresolved type parameter),
|
|
402
|
+
* тайпчекер печатает доступ к её полям как есть — `SomeProps<T>["autoFocus"]`
|
|
403
|
+
* — вместо конкретного типа. Обнаружено вживую на TypographyWithAutoTooltip:
|
|
404
|
+
* из-за этого проваливается денылист DOM-шума в isNoiseProp (сравнение идёт
|
|
405
|
+
* по точному тексту типа, а `boolean | undefined` != `X<T>["autoFocus"]`),
|
|
406
|
+
* и ~280 унаследованных DOM/ARIA-атрибутов просачиваются как "настоящие"
|
|
407
|
+
* пропсы. Текст-то не буквально "unknown", но так же бесполезен — считаем
|
|
408
|
+
* его мусором наравне с unknown при оценке доли шума.
|
|
409
|
+
*/
|
|
410
|
+
const UNRESOLVED_GENERIC_ACCESS_RE = /\w+<[^<>]*>\["[^"]+"\](\s*\|\s*undefined)?$/;
|
|
411
|
+
function isUselessResolvedType(typeText) {
|
|
412
|
+
return typeText === 'unknown' || UNRESOLVED_GENERIC_ACCESS_RE.test(typeText);
|
|
413
|
+
}
|
|
414
|
+
/**
|
|
415
|
+
* Структурный резолв пропсов дженерика через тайпчекер — работает для
|
|
416
|
+
* простых пересечений вроде `TMutationRegister<T> & TPropsFromMask & TProps`
|
|
417
|
+
* (один type-параметр, все члены пересечения резолвятся структурно
|
|
418
|
+
* независимо от того, что T не подставлен). Возвращает undefined, если
|
|
419
|
+
* результат похож на "нечитаемую простыню" — тогда resolvePropsType
|
|
420
|
+
* откатывается на сырой текст типа, как раньше.
|
|
421
|
+
*/
|
|
422
|
+
function tryExtractGenericProps(decl, defaultsMap) {
|
|
423
|
+
if (!Node.isTypeAliasDeclaration(decl) &&
|
|
424
|
+
!Node.isInterfaceDeclaration(decl)) {
|
|
425
|
+
return undefined;
|
|
426
|
+
}
|
|
427
|
+
let props;
|
|
428
|
+
try {
|
|
429
|
+
props = extractPropsFromType(decl.getType(), decl, defaultsMap);
|
|
430
|
+
}
|
|
431
|
+
catch {
|
|
432
|
+
return undefined;
|
|
433
|
+
}
|
|
434
|
+
if (props.length === 0 || props.length > MAX_GENERIC_PROPS)
|
|
435
|
+
return undefined;
|
|
436
|
+
const uselessCount = props.filter((p) => isUselessResolvedType(p.type)).length;
|
|
437
|
+
if (uselessCount / props.length > MAX_UNKNOWN_PROP_RATIO)
|
|
438
|
+
return undefined;
|
|
439
|
+
return props.filter((p) => !isUselessResolvedType(p.type));
|
|
440
|
+
}
|
|
441
|
+
/**
|
|
442
|
+
* Пропсы компонента: обычный резолв через тайпчекер, но с фолбеком на сырой
|
|
443
|
+
* текст типа для сложных дженериков (TableProps<...> и подобные) — тот же
|
|
444
|
+
* приём, что copyTypeAsStringSync в generators/meta-info, только проще:
|
|
445
|
+
* у нас уже есть AST-узел, поэтому просто берём node.getText().
|
|
446
|
+
*/
|
|
447
|
+
function resolvePropsType(propsRef, defaultsMap) {
|
|
448
|
+
if (propsRef.decl === undefined) {
|
|
449
|
+
const { name, inlineParamNode } = propsRef;
|
|
450
|
+
try {
|
|
451
|
+
return {
|
|
452
|
+
typeName: name,
|
|
453
|
+
props: extractPropsFromType(inlineParamNode.getType(), inlineParamNode, defaultsMap),
|
|
454
|
+
};
|
|
455
|
+
}
|
|
456
|
+
catch {
|
|
457
|
+
return { typeName: name, props: [] };
|
|
458
|
+
}
|
|
459
|
+
}
|
|
460
|
+
const { name, decl } = propsRef;
|
|
461
|
+
const typeParams = getTypeParameters(decl);
|
|
462
|
+
if (typeParams.length > 0) {
|
|
463
|
+
const structuralProps = tryExtractGenericProps(decl, defaultsMap);
|
|
464
|
+
return {
|
|
465
|
+
typeName: name,
|
|
466
|
+
rawType: clip(stripImportPaths(decl.getText()), MAX_RAW_TYPE_CHARS),
|
|
467
|
+
props: structuralProps ?? [],
|
|
468
|
+
isGeneric: true,
|
|
469
|
+
};
|
|
470
|
+
}
|
|
471
|
+
try {
|
|
472
|
+
const type = Node.isTypeAliasDeclaration(decl) || Node.isInterfaceDeclaration(decl)
|
|
473
|
+
? decl.getType()
|
|
474
|
+
: undefined;
|
|
475
|
+
if (!type) {
|
|
476
|
+
return {
|
|
477
|
+
typeName: name,
|
|
478
|
+
rawType: clip(stripImportPaths(decl.getText()), MAX_RAW_TYPE_CHARS),
|
|
479
|
+
props: [],
|
|
480
|
+
};
|
|
481
|
+
}
|
|
482
|
+
const props = extractPropsFromType(type, decl, defaultsMap);
|
|
483
|
+
return { typeName: name, props };
|
|
484
|
+
}
|
|
485
|
+
catch {
|
|
486
|
+
return {
|
|
487
|
+
typeName: name,
|
|
488
|
+
rawType: clip(stripImportPaths(decl.getText()), MAX_RAW_TYPE_CHARS),
|
|
489
|
+
props: [],
|
|
490
|
+
};
|
|
491
|
+
}
|
|
492
|
+
}
|
|
493
|
+
/**
|
|
494
|
+
* Виртуальный файл-пробник для семантического фолбэка (см.
|
|
495
|
+
* tryExtractViaComponentProps) — один на весь прогон индексера, содержимое
|
|
496
|
+
* целиком перезаписывается на каждый вызов. Лежит внутри UI_KIT_SRC (а не,
|
|
497
|
+
* скажем, в mcp-server), чтобы `import type { ComponentProps } from 'react'`
|
|
498
|
+
* резолвился ровно так же, как для настоящих файлов ui-kit — react там уже
|
|
499
|
+
* гарантированно резолвится через тот же tsconfig/node_modules.
|
|
500
|
+
*/
|
|
501
|
+
let probeSourceFile;
|
|
502
|
+
function getProbeSourceFile() {
|
|
503
|
+
if (!probeSourceFile) {
|
|
504
|
+
const probePath = path.join(UI_KIT_SRC, '__mcp_component_props_probe__.ts');
|
|
505
|
+
probeSourceFile = getProject().createSourceFile(probePath, '', {
|
|
506
|
+
overwrite: true,
|
|
507
|
+
});
|
|
508
|
+
}
|
|
509
|
+
return probeSourceFile;
|
|
510
|
+
}
|
|
511
|
+
let probeCounter = 0;
|
|
512
|
+
/**
|
|
513
|
+
* Финальный фолбэк, когда ни именованный Props-тип (findPropsDeclaration),
|
|
514
|
+
* ни render-функция с параметром (findPropsDeclFromSignature) не найдены —
|
|
515
|
+
* типичный случай для чистых реэкспортов из @salutejs/plasma-new-hope
|
|
516
|
+
* (AccordionItem, ButtonBase, CellTextbox...): в .d.ts они объявлены как
|
|
517
|
+
* `export declare const X: ForwardRefExoticComponent<Props & RefAttributes>`
|
|
518
|
+
* БЕЗ инициализатора, поэтому unwrapToRenderFunction не может дойти до тела
|
|
519
|
+
* функции — там его просто нет, .d.ts не содержит реализации. Тот же провал
|
|
520
|
+
* и для styled-компонентов с инлайновым дженериком (`styled.div<{...}>`) —
|
|
521
|
+
* `styled.div<T>` это TaggedTemplateExpression, не render-функция.
|
|
522
|
+
*
|
|
523
|
+
* Вместо разбора AST берём у тайпчекера тип самого экспорта (он есть всегда
|
|
524
|
+
* — это тип объявления, а не тип инициализатора) и прогоняем его через
|
|
525
|
+
* ComponentProps<T> — тот же паттерн, которым уже пользуется .probe/
|
|
526
|
+
* validate.ts для проверки индекса против реальных типов. ComponentProps
|
|
527
|
+
* сама умеет разворачивать ForwardRefExoticComponent/FunctionComponent/
|
|
528
|
+
* class-компоненты/styled-components — не нужно вручную разбирать эти формы.
|
|
529
|
+
*/
|
|
530
|
+
function tryExtractViaComponentProps(mainDecl, defaultsMap) {
|
|
531
|
+
let declType;
|
|
532
|
+
try {
|
|
533
|
+
declType = mainDecl.getType();
|
|
534
|
+
}
|
|
535
|
+
catch {
|
|
536
|
+
return undefined;
|
|
537
|
+
}
|
|
538
|
+
// Без enclosing-node — иначе принтер печатает типы "как в исходном файле"
|
|
539
|
+
// (короткие локальные имена вроде голого `CellTextboxProps`, доступные
|
|
540
|
+
// только там благодаря его собственным импортам), а не как
|
|
541
|
+
// `import("...").CellTextboxProps` — в файле-пробнике таких импортов нет,
|
|
542
|
+
// и голое имя не резолвится (тихо ловится catch ниже как несуществующий
|
|
543
|
+
// тип). Без enclosing-node тайпчекер всегда квалифицирует типы полным
|
|
544
|
+
// путём — тем же приёмом, который потом снимает stripImportPaths.
|
|
545
|
+
const rawTypeText = declType.getText();
|
|
546
|
+
if (!rawTypeText || rawTypeText === 'any' || rawTypeText === 'unknown') {
|
|
547
|
+
return undefined;
|
|
548
|
+
}
|
|
549
|
+
probeCounter += 1;
|
|
550
|
+
const aliasName = `__MCPProbe${probeCounter}`;
|
|
551
|
+
const file = getProbeSourceFile();
|
|
552
|
+
try {
|
|
553
|
+
file.replaceWithText(`import type { ComponentProps } from 'react';\ntype ${aliasName} = ComponentProps<${rawTypeText}>;\n`);
|
|
554
|
+
const alias = file.getTypeAliasOrThrow(aliasName);
|
|
555
|
+
const props = extractPropsFromType(alias.getType(), alias, defaultsMap);
|
|
556
|
+
return props.length > 0 ? props : undefined;
|
|
557
|
+
}
|
|
558
|
+
catch {
|
|
559
|
+
return undefined;
|
|
560
|
+
}
|
|
561
|
+
}
|
|
562
|
+
/** Ищет паттерн `Component.Sub = LocalName;` — compound-компоненты (DrawerDF.Header и т.п.). */
|
|
563
|
+
function findCompoundAssignments(mainSourceFile, componentName) {
|
|
564
|
+
if (!mainSourceFile)
|
|
565
|
+
return [];
|
|
566
|
+
const assignments = [];
|
|
567
|
+
const binaryExprs = mainSourceFile.getDescendantsOfKind(SyntaxKind.BinaryExpression);
|
|
568
|
+
for (const expr of binaryExprs) {
|
|
569
|
+
if (expr.getOperatorToken().getText() !== '=')
|
|
570
|
+
continue;
|
|
571
|
+
const left = expr.getLeft();
|
|
572
|
+
if (!Node.isPropertyAccessExpression(left))
|
|
573
|
+
continue;
|
|
574
|
+
if (left.getExpression().getText() !== componentName)
|
|
575
|
+
continue;
|
|
576
|
+
const subName = left.getName();
|
|
577
|
+
const right = expr.getRight();
|
|
578
|
+
if (Node.isIdentifier(right)) {
|
|
579
|
+
assignments.push({ subName, localName: right.getText() });
|
|
580
|
+
}
|
|
581
|
+
}
|
|
582
|
+
return assignments;
|
|
583
|
+
}
|
|
584
|
+
/**
|
|
585
|
+
* Многие compound-подкомпоненты (DrawerDF.Header и т.п.) не реэкспортируют
|
|
586
|
+
* свой Props-тип из barrel — он объявлен, но остаётся "внутренним" (типа
|
|
587
|
+
* `DrawerDFHeaderProps` в types.ts). Ищем такие декларации напрямую в файлах
|
|
588
|
+
* папки компонента, не только среди экспортов barrel-файла.
|
|
589
|
+
*/
|
|
590
|
+
function findLocalTypeDeclaration(compDir, typeName) {
|
|
591
|
+
if (!compDir)
|
|
592
|
+
return undefined;
|
|
593
|
+
for (const sourceFile of getProject().getSourceFiles()) {
|
|
594
|
+
if (!sourceFile.getFilePath().startsWith(compDir))
|
|
595
|
+
continue;
|
|
596
|
+
const decl = sourceFile.getTypeAlias(typeName) ?? sourceFile.getInterface(typeName);
|
|
597
|
+
if (decl)
|
|
598
|
+
return { name: typeName, decl };
|
|
599
|
+
}
|
|
600
|
+
return undefined;
|
|
601
|
+
}
|
|
602
|
+
function resolveCompoundPart(barrelSourceFile, componentName, subName, localName, compDir) {
|
|
603
|
+
const propsRef = findPropsDeclaration(barrelSourceFile, localName) ??
|
|
604
|
+
findPropsDeclaration(barrelSourceFile, subName) ??
|
|
605
|
+
findLocalTypeDeclaration(compDir, `${componentName}${subName}Props`) ??
|
|
606
|
+
findLocalTypeDeclaration(compDir, `${localName}Props`);
|
|
607
|
+
const localDecl = resolveExportedDeclaration(barrelSourceFile, localName);
|
|
608
|
+
// Дефолты compound-части читаются из её СОБСТВЕННОЙ render-функции
|
|
609
|
+
// (localDecl), не из render-функции родителя — `DrawerDF.Header`
|
|
610
|
+
// деструктурирует свои пропсы независимо от `DrawerDF` (TASKS.md T6).
|
|
611
|
+
const defaultsMap = collectDestructuringDefaults(localDecl && unwrapToRenderFunction(localDecl));
|
|
612
|
+
let resolved;
|
|
613
|
+
if (propsRef) {
|
|
614
|
+
resolved = resolvePropsType(propsRef, defaultsMap);
|
|
615
|
+
}
|
|
616
|
+
else {
|
|
617
|
+
const sigPropsRef = localDecl && findPropsDeclFromSignature(localDecl, localName);
|
|
618
|
+
if (sigPropsRef)
|
|
619
|
+
resolved = resolvePropsType(sigPropsRef, defaultsMap);
|
|
620
|
+
}
|
|
621
|
+
// Тот же финальный фолбэк, что и у parseComponent для top-level компонента
|
|
622
|
+
// (см. вызов ниже, ~строка 788): без него для compound-частей без своего
|
|
623
|
+
// именованного Props-типа и без параметра render-функции (реэкспорт из
|
|
624
|
+
// @salutejs/sdds-finai без инициализатора) остаётся только сырой текст
|
|
625
|
+
// типа — до 400 символов нечитаемых вложенных Omit<...>, см. TASKS.md T13.
|
|
626
|
+
if ((!resolved || (resolved.props.length === 0 && !resolved.isGeneric)) &&
|
|
627
|
+
localDecl) {
|
|
628
|
+
const viaComponentProps = tryExtractViaComponentProps(localDecl, defaultsMap);
|
|
629
|
+
if (viaComponentProps) {
|
|
630
|
+
resolved = {
|
|
631
|
+
typeName: resolved?.typeName ?? `ComponentProps<typeof ${localName}>`,
|
|
632
|
+
props: viaComponentProps,
|
|
633
|
+
};
|
|
634
|
+
}
|
|
635
|
+
}
|
|
636
|
+
return { name: subName, ...(resolved ?? { props: [] }) };
|
|
637
|
+
}
|
|
638
|
+
/**
|
|
639
|
+
* Разбирает один компонент: где реально объявлен (локально/через реэкспорт
|
|
640
|
+
* из @salutejs/sdds-finai), его пропсы, compound-части, deprecated.
|
|
641
|
+
*/
|
|
642
|
+
export function parseComponent({ name, barrelPath, dir, }) {
|
|
643
|
+
const project = getProject();
|
|
644
|
+
const barrelSourceFile = project.getSourceFileOrThrow(barrelPath);
|
|
645
|
+
const mainDecl = resolveExportedDeclaration(barrelSourceFile, name);
|
|
646
|
+
if (!mainDecl) {
|
|
647
|
+
return { name, error: `export "${name}" не найден в barrel-файле` };
|
|
648
|
+
}
|
|
649
|
+
const mainSourceFile = mainDecl.getSourceFile();
|
|
650
|
+
const pureAtomicReExport = isInPackage(mainSourceFile, '@salutejs/sdds-finai');
|
|
651
|
+
// Для чистого реэкспорта берём имя символа там, где он реально объявлен
|
|
652
|
+
// в sdds-finai — не `name` (локальное имя в barrel-файле ui-kit), которое
|
|
653
|
+
// может быть алиасом (`import { Popover as PopoverBeta } from '.../beta'`).
|
|
654
|
+
const atomicName = pureAtomicReExport
|
|
655
|
+
? mainDecl.getSymbol()?.getName()
|
|
656
|
+
: undefined;
|
|
657
|
+
// Типы beta-пакета резолвятся из @salutejs/sdds-finai/dist/beta/... (см.
|
|
658
|
+
// subpath-export "./beta" в package.json), в отличие от основного пакета
|
|
659
|
+
// (@salutejs/sdds-finai/types/...) — по этому и различаем. Важно: у
|
|
660
|
+
// части атомов есть тёзки в основном пакете (Popover, Tooltip) с ДРУГИМИ
|
|
661
|
+
// пропсами, поэтому подмешивать данные не глядя на subpath нельзя.
|
|
662
|
+
const isBetaAtom = pureAtomicReExport &&
|
|
663
|
+
mainSourceFile.getFilePath().includes('/sdds-finai/dist/beta/');
|
|
664
|
+
const atomicSubpath = isBetaAtom ? 'beta' : undefined;
|
|
665
|
+
const declaredInUiKit = mainSourceFile
|
|
666
|
+
.getFilePath()
|
|
667
|
+
.includes('/packages/ui-kit/src/');
|
|
668
|
+
const jsDocable = Node.isVariableDeclaration(mainDecl)
|
|
669
|
+
? mainDecl.getVariableStatementOrThrow()
|
|
670
|
+
: mainDecl;
|
|
671
|
+
const description = getJsDocDescription(jsDocable);
|
|
672
|
+
const deprecated = isDeprecated(jsDocable);
|
|
673
|
+
const deprecationReason = deprecated
|
|
674
|
+
? getDeprecatedReason(jsDocable)
|
|
675
|
+
: undefined;
|
|
676
|
+
// Дефолты из деструктуризации первого параметра самой render-функции
|
|
677
|
+
// компонента — `({ size = 'm', ...rest }: TextFieldProps) => ...`
|
|
678
|
+
// (TASKS.md T6). unwrapToRenderFunction здесь безопасен даже для чистых
|
|
679
|
+
// реэкспортов без инициализатора — вернёт undefined, defaultsMap пустая.
|
|
680
|
+
const defaultsMap = collectDestructuringDefaults(unwrapToRenderFunction(mainDecl));
|
|
681
|
+
const propsRef = findPropsDeclaration(barrelSourceFile, name) ??
|
|
682
|
+
findPropsDeclFromSignature(mainDecl, name);
|
|
683
|
+
let propsResolved = propsRef
|
|
684
|
+
? resolvePropsType(propsRef, defaultsMap)
|
|
685
|
+
: { props: [] };
|
|
686
|
+
if (propsResolved.props.length === 0 && !propsResolved.isGeneric) {
|
|
687
|
+
const viaComponentProps = tryExtractViaComponentProps(mainDecl, defaultsMap);
|
|
688
|
+
if (viaComponentProps) {
|
|
689
|
+
propsResolved = {
|
|
690
|
+
typeName: propsResolved.typeName ?? `ComponentProps<typeof ${name}>`,
|
|
691
|
+
props: viaComponentProps,
|
|
692
|
+
};
|
|
693
|
+
}
|
|
694
|
+
}
|
|
695
|
+
const localMainFile = declaredInUiKit ? mainSourceFile : undefined;
|
|
696
|
+
const compoundAssignments = findCompoundAssignments(localMainFile, name);
|
|
697
|
+
const compoundParts = compoundAssignments.map(({ subName, localName }) => resolveCompoundPart(barrelSourceFile, name, subName, localName, dir));
|
|
698
|
+
return {
|
|
699
|
+
name,
|
|
700
|
+
description,
|
|
701
|
+
deprecated,
|
|
702
|
+
deprecationReason,
|
|
703
|
+
pureAtomicReExport,
|
|
704
|
+
atomicName,
|
|
705
|
+
atomicSubpath,
|
|
706
|
+
declaredInUiKit,
|
|
707
|
+
declarationFile: mainSourceFile.getFilePath(),
|
|
708
|
+
props: propsResolved.props,
|
|
709
|
+
propsTypeName: propsResolved.typeName,
|
|
710
|
+
rawType: propsResolved.rawType,
|
|
711
|
+
isGeneric: propsResolved.isGeneric,
|
|
712
|
+
compoundParts: compoundParts.length > 0 ? compoundParts : undefined,
|
|
713
|
+
};
|
|
714
|
+
}
|
|
715
|
+
//# sourceMappingURL=parseComponent.js.map
|