@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
@@ -0,0 +1,254 @@
1
+ /* eslint-disable no-continue */
2
+ import { ts } from 'ts-morph';
3
+ import { getProject } from './tsProject.js';
4
+ /**
5
+ * Статические поля React-компонента (React.ComponentClass / FunctionComponent) —
6
+ * не JSX-пропсы, а служебные члены. Не приходят из HTMLAttributes, поэтому
7
+ * фильтруются отдельным точным списком имён.
8
+ */
9
+ export const REACT_STATIC_MEMBER_NAMES = new Set([
10
+ 'propTypes',
11
+ 'contextTypes',
12
+ 'childContextTypes',
13
+ 'defaultProps',
14
+ 'displayName',
15
+ 'getDerivedStateFromError',
16
+ 'getDerivedStateFromProps',
17
+ // styled-components API-шум: есть у КАЖДОГО styled(...)-компонента
18
+ // (BoxProps и всё, что от него наследуется), почти никогда не используется
19
+ // осмысленно в реальном коде.
20
+ 'theme',
21
+ 'forwardedAs',
22
+ ]);
23
+ /**
24
+ * Имена, которые всегда DOM/React-служебный шум независимо от текста типа —
25
+ * дизайн-система их не переопределяет осмысленно нигде в кодовой базе.
26
+ * НЕ добавлять сюда `disabled`, `size`, `value`, `checked`, `role`,
27
+ * `tabIndex`, `hidden`, `draggable`, `color`, `autoComplete`,
28
+ * `enterKeyHint` — их дизайн-система переопределяет, они должны проходить
29
+ * через сравнение типов в isNoiseProp, иначе потеряем реальные пропсы.
30
+ */
31
+ export const UNCONDITIONAL_NOISE_NAMES = new Set([
32
+ 'key',
33
+ 'ref',
34
+ 'dangerouslySetInnerHTML',
35
+ 'suppressContentEditableWarning',
36
+ 'suppressHydrationWarning',
37
+ 'contentEditable',
38
+ 'inputMode',
39
+ 'itemProp',
40
+ 'itemScope',
41
+ 'itemType',
42
+ 'itemID',
43
+ 'itemRef',
44
+ 'nonce',
45
+ 'is',
46
+ 'about',
47
+ 'datatype',
48
+ 'inlist',
49
+ 'prefix',
50
+ 'property',
51
+ 'resource',
52
+ 'typeof',
53
+ 'vocab',
54
+ 'security',
55
+ 'unselectable',
56
+ 'radioGroup',
57
+ 'results',
58
+ 'translate',
59
+ 'spellCheck',
60
+ ]);
61
+ /** Безусловные паттерны имени: aria-*, data-*, обработчики *Capture. */
62
+ const UNCONDITIONAL_NOISE_PATTERNS = [/^aria-/, /^data-/, /^on[A-Z].*Capture$/];
63
+ let cachedDenylist;
64
+ /**
65
+ * Пропсы `ComponentProps<typeof X>` почти всегда содержат ~300 унаследованных
66
+ * DOM/ARIA-атрибутов (onDrag, aria-live, spellCheck...) вперемешку с реальными
67
+ * пропсами дизайн-системы. Часть имён совпадает (disabled, size, value,
68
+ * checked) — поэтому фильтруем не по имени, а по паре имя+текст типа: если
69
+ * тип совпадает с "чистым" HTML-атрибутом дословно — значит дизайн-система
70
+ * его не переопределяла, это шум. Если тип уже, чем в HTML (например
71
+ * `size: "s" | "m" | "l"` вместо HTML `size: number`) — это осмысленный
72
+ * пропс, оставляем. Заодно копим JSDoc-описания того же пробника — источник
73
+ * для isReactDomDescription (T7): пропсы вроде `role`/`tabIndex`/`color`
74
+ * дизайн-система переопределяет по типу (проходят isNoiseProp), но их
75
+ * описание иногда остаётся нетронутым унаследованным React DOM-текстом.
76
+ */
77
+ function buildDenylist() {
78
+ const project = getProject();
79
+ const tmp = project.createSourceFile('packages/ui-kit/src/__mcp_denylist_probe.ts', `
80
+ import type { AllHTMLAttributes, AriaAttributes, DOMAttributes } from 'react';
81
+ export type __Denylist = AllHTMLAttributes<HTMLElement> & AriaAttributes & DOMAttributes<HTMLElement>;
82
+ `, { overwrite: true });
83
+ const alias = tmp.getTypeAliasOrThrow('__Denylist');
84
+ const types = new Map();
85
+ const descriptions = new Map();
86
+ const checker = project.getTypeChecker().compilerObject;
87
+ for (const symbol of alias.getType().getProperties()) {
88
+ const decl = symbol.getValueDeclaration() ?? symbol.getDeclarations()[0];
89
+ if (!decl)
90
+ continue;
91
+ try {
92
+ types.set(symbol.getName(), symbol.getTypeAtLocation(decl).getText());
93
+ }
94
+ catch {
95
+ // пропускаем нерезолвящиеся члены — не критично для денылиста
96
+ }
97
+ try {
98
+ const parts = symbol.compilerSymbol.getDocumentationComment(checker);
99
+ const text = ts.displayPartsToString(parts).trim();
100
+ if (text)
101
+ descriptions.set(symbol.getName(), text);
102
+ }
103
+ catch {
104
+ // doc comment недоступен — не критично
105
+ }
106
+ }
107
+ tmp.forget();
108
+ return { types, descriptions };
109
+ }
110
+ function getDenylist() {
111
+ if (!cachedDenylist) {
112
+ cachedDenylist = buildDenylist();
113
+ }
114
+ return cachedDenylist;
115
+ }
116
+ export function getDenylistMap() {
117
+ return getDenylist().types;
118
+ }
119
+ /**
120
+ * true — описание пропса дословно совпадает с JSDoc React DOM-типизации того
121
+ * же имени (TASKS.md T7, п.2) — переписанный React-текст ("Indicates the
122
+ * current \"checked\" state of checkboxes…"), а не осмысленное описание
123
+ * дизайн-системы. Применяется ПОСЛЕ isNoiseProp — сам пропс мог пройти
124
+ * фильтр шума по типу (`role`/`tabIndex`/`color` дизайн-система
125
+ * переопределяет), но унаследовать чужое описание отдельно от типа.
126
+ */
127
+ export function isReactDomDescription(name, description) {
128
+ if (!description)
129
+ return false;
130
+ return getDenylist().descriptions.get(name) === description;
131
+ }
132
+ /**
133
+ * Снимает внешние скобки, только если они реально оборачивают весь текст
134
+ * целиком (а не просто `(A) & (B)`, где скобки закрываются раньше конца).
135
+ */
136
+ function stripOuterParens(typeText) {
137
+ if (!typeText.startsWith('(') || !typeText.endsWith(')'))
138
+ return typeText;
139
+ let depth = 0;
140
+ for (let i = 0; i < typeText.length; i += 1) {
141
+ if (typeText[i] === '(')
142
+ depth += 1;
143
+ else if (typeText[i] === ')') {
144
+ depth -= 1;
145
+ if (depth === 0 && i !== typeText.length - 1)
146
+ return typeText;
147
+ }
148
+ }
149
+ return typeText.slice(1, -1).trim();
150
+ }
151
+ function stripOuterParensRepeated(typeText) {
152
+ let t = typeText;
153
+ for (let prev = ''; prev !== t;) {
154
+ prev = t;
155
+ t = stripOuterParens(t).trim();
156
+ }
157
+ return t;
158
+ }
159
+ /**
160
+ * Разбивает текст типа по union (`|`) или intersection (`&`) верхнего уровня
161
+ * — то есть игнорирует вхождения разделителя внутри `<...>`, `(...)`,
162
+ * `{...}`, `[...]` и строковых литералов (литеральные типы вроде `"a|b"`
163
+ * в кодовой базе не встречаются, но на всякий случай не разбиваем и там).
164
+ */
165
+ function splitTopLevel(typeText, separator) {
166
+ const parts = [];
167
+ let depth = 0;
168
+ let quote = null;
169
+ let current = '';
170
+ for (let i = 0; i < typeText.length; i += 1) {
171
+ const ch = typeText[i];
172
+ if (quote) {
173
+ current += ch;
174
+ if (ch === quote && typeText[i - 1] !== '\\')
175
+ quote = null;
176
+ continue;
177
+ }
178
+ if (ch === '"' || ch === "'" || ch === '`') {
179
+ quote = ch;
180
+ current += ch;
181
+ continue;
182
+ }
183
+ if (ch === '(' || ch === '[' || ch === '{' || ch === '<')
184
+ depth += 1;
185
+ else if (ch === ')' || ch === ']' || ch === '}' || ch === '>')
186
+ depth -= 1;
187
+ if (depth === 0 && ch === separator) {
188
+ parts.push(current.trim());
189
+ current = '';
190
+ continue;
191
+ }
192
+ current += ch;
193
+ }
194
+ parts.push(current.trim());
195
+ return parts;
196
+ }
197
+ /**
198
+ * Убирает буквально повторяющиеся члены union/intersection верхнего уровня
199
+ * (после нормализации конкретного HTML-элемента разные члены схлопываются
200
+ * в один и тот же текст — см. normalizeElementGeneric).
201
+ */
202
+ function dedupeTopLevel(typeText, separator) {
203
+ const t = stripOuterParensRepeated(typeText);
204
+ if (!t.includes(separator))
205
+ return t;
206
+ const members = splitTopLevel(t, separator).map(stripOuterParensRepeated);
207
+ return Array.from(new Set(members)).join(` ${separator} `);
208
+ }
209
+ /**
210
+ * Компоненты спредят DOM-пропсы на разные теги (input/button/div/...), из-за
211
+ * чего у обработчиков событий и подобных полей меняется параметр конкретного
212
+ * HTML-элемента (`FormEventHandler<HTMLDivElement>` vs `<HTMLInputElement>`),
213
+ * хотя по сути это один и тот же непереопределённый DOM-пропс. Нормализуем
214
+ * конкретный элемент перед сравнением, чтобы не терять их как "разные" типы.
215
+ *
216
+ * Дополнительно схлопываем алиасы, которые тайпчекер иногда печатает вместо
217
+ * разложенного типа в зависимости от точки резолва: `Booleanish` (реальный
218
+ * тип `boolean | "true" | "false"`), префикс `React.` (виден/не виден в
219
+ * зависимости от того, реэкспортирован ли символ в области резолва) и
220
+ * хвостовой `| undefined` (optional-модификатор и так учитывается отдельно
221
+ * через SymbolFlags.Optional, в тексте типа он лишний шум для сравнения).
222
+ *
223
+ * Отдельный случай — компонент рендерит DOM-пропс на несколько разных
224
+ * элементов (`ComponentProps<'input'> & ComponentProps<'div'>` или
225
+ * `... | ComponentProps<'a'>`): тайпчекер печатает union/intersection
226
+ * одного и того же обработчика с разными generic-параметрами
227
+ * (`ClipboardEventHandler<HTMLInputElement> & ClipboardEventHandler<HTMLDivElement>`,
228
+ * `MouseEventHandler<HTMLElement> | MouseEventHandler<HTMLAnchorElement>`),
229
+ * которое после нормализации конкретного элемента схлопывается в буквально
230
+ * повторяющиеся члены — убираем дубликаты на обоих уровнях.
231
+ */
232
+ function normalizeElementGeneric(typeText) {
233
+ const t = typeText
234
+ .replace(/HTML[A-Za-z]*Element/g, 'HTMLElement')
235
+ .replace(/\bBooleanish\b/g, 'boolean | "true" | "false"')
236
+ .replace(/\bReact\./g, '')
237
+ .replace(/\s*\|\s*undefined\b/g, '')
238
+ .trim();
239
+ return dedupeTopLevel(dedupeTopLevel(t, '|'), '&');
240
+ }
241
+ /** true — считаем пропс шумом (унаследованный DOM-атрибут без переопределения). */
242
+ export function isNoiseProp(name, typeText) {
243
+ if (REACT_STATIC_MEMBER_NAMES.has(name))
244
+ return true;
245
+ if (UNCONDITIONAL_NOISE_NAMES.has(name))
246
+ return true;
247
+ if (UNCONDITIONAL_NOISE_PATTERNS.some((re) => re.test(name)))
248
+ return true;
249
+ const denyType = getDenylistMap().get(name);
250
+ if (denyType === undefined)
251
+ return false;
252
+ return (normalizeElementGeneric(denyType) === normalizeElementGeneric(typeText));
253
+ }
254
+ //# sourceMappingURL=htmlAttributeDenylist.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"htmlAttributeDenylist.js","sourceRoot":"","sources":["../../src/indexer/htmlAttributeDenylist.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { REPO_ROOT } from './tsProject.js';
4
+ const META_JSON_PATH = path.join(REPO_ROOT, '_docs/meta/components-meta.json');
5
+ let cachedMeta;
6
+ function loadMetaJson() {
7
+ if (cachedMeta === undefined) {
8
+ cachedMeta = fs.existsSync(META_JSON_PATH)
9
+ ? JSON.parse(fs.readFileSync(META_JSON_PATH, 'utf8'))
10
+ : null;
11
+ }
12
+ return cachedMeta;
13
+ }
14
+ /** Первая содержательная строка — пропускаем markdown-заголовки ("# Editing"), это не summary. */
15
+ function firstMeaningfulLine(text) {
16
+ const line = (text || '')
17
+ .split('\n')
18
+ .map((l) => l.trim())
19
+ .find((l) => l.length > 0 && !/^#+\s/.test(l));
20
+ return (line || '').replace(/^[-*]\s*/, '');
21
+ }
22
+ /**
23
+ * Фичи — первоклассные сущности, не вложенный подобъект компонента. Замеры на
24
+ * TableCanvas/Table показали: 46/31 фичей составляют 95-98% payload'а этих
25
+ * двух компонентов, а имена фичей не угадываются (massPanelAction,
26
+ * controlBlockApe, CanvasElements/CanvasText) — поэтому разворачиваем их в
27
+ * отдельный плоский список, доступный поиску наравне с компонентами.
28
+ *
29
+ * `features` в components-meta.json уже плоский dict (даже вложенные с виду
30
+ * ключи вроде "CanvasElements/CanvasText" — на деле обычная строка с "/"),
31
+ * рекурсия не нужна.
32
+ */
33
+ export function buildFeatureIndex(records) {
34
+ const meta = loadMetaJson();
35
+ if (!meta)
36
+ return [];
37
+ const legacyByName = new Map(records.map((r) => [r.name, Boolean(r.legacy)]));
38
+ return Object.entries(meta.components).flatMap(([componentName, componentMeta]) => {
39
+ const { features } = componentMeta;
40
+ if (!features)
41
+ return [];
42
+ const legacy = legacyByName.get(componentName) ?? false;
43
+ return Object.entries(features).map(([featureName, featureMeta]) => ({
44
+ component: componentName,
45
+ feature: featureName,
46
+ legacy,
47
+ summary: firstMeaningfulLine(featureMeta.docs) ||
48
+ firstMeaningfulLine(featureMeta.apiDocs),
49
+ docs: featureMeta.docs,
50
+ apiDocs: featureMeta.apiDocs,
51
+ api: featureMeta.api || [],
52
+ stories: featureMeta.stories || [],
53
+ }));
54
+ });
55
+ }
56
+ //# sourceMappingURL=indexFeatures.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"indexFeatures.js","sourceRoot":"","sources":["../../src/indexer/indexFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC;AAE/E,IAAI,UAAuC,CAAC;AAC5C,SAAS,YAAY;IACnB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC;YACxC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAc;YACnE,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,kGAAkG;AAClG,SAAS,mBAAmB,CAAC,IAAwB;IACnD,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;SACtB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAC5C,CAAC,CAAC,aAAa,EAAE,aAAa,CAAC,EAAmB,EAAE;QAClD,MAAM,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC;QAExD,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CACjC,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,EAAiB,EAAE,CAAC,CAAC;YAC9C,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,WAAW;YACpB,MAAM;YACN,OAAO,EACL,mBAAmB,CAAC,WAAW,CAAC,IAAI,CAAC;gBACrC,mBAAmB,CAAC,WAAW,CAAC,OAAO,CAAC;YAC1C,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,GAAG,EAAE,WAAW,CAAC,GAAG,IAAI,EAAE;YAC1B,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,EAAE;SACnC,CAAC,CACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,44 @@
1
+ import { clip, getCollectedTypeDecls, MAX_RAW_TYPE_CHARS, stripImportPaths, } from './parseComponent.js';
2
+ import { deriveGroupAndFolder, resolveImportPath, } from './resolveImportPath.js';
3
+ /**
4
+ * Собирает Record<string, TypeRecord> из типов, которые parseComponent
5
+ * структурно нашёл среди типов пропсов за весь прогон (collectNamedTypeRefs
6
+ * копит их в module-level Map по ходу разбора компонентов — вызывать после
7
+ * того, как все компоненты уже разобраны, иначе Map будет пуст).
8
+ *
9
+ * Одно имя может соответствовать НЕСКОЛЬКИМ разным типам в разных папках
10
+ * ui-kit (TableCanvas активно переиспользует общие имена — свой
11
+ * `ColumnConfig`, отдельный от легаси-`Table.ColumnConfig`). Когда коллизии
12
+ * нет — ключ индекса это просто имя. Когда есть — каждый вариант получает
13
+ * ключ вида "ПапкаКомпонента.Имя", а неоднозначный голый ключ не
14
+ * регистрируется вовсе: тул get_type увидит отсутствие точного совпадения и
15
+ * подскажет агенту квалифицированные варианты (см. tools/getType.ts).
16
+ */
17
+ export function buildTypeIndex() {
18
+ const result = {};
19
+ for (const group of getCollectedTypeDecls()) {
20
+ const ambiguous = group.length > 1;
21
+ for (const { name, decl } of group) {
22
+ const sourceFile = decl.getSourceFile().getFilePath();
23
+ const { importPath, importStatement } = resolveImportPath(name, sourceFile);
24
+ const definition = clip(stripImportPaths(decl.getText()), MAX_RAW_TYPE_CHARS);
25
+ const record = {
26
+ name,
27
+ definition,
28
+ importPath,
29
+ importStatement,
30
+ sourceFile,
31
+ };
32
+ if (ambiguous) {
33
+ const parts = deriveGroupAndFolder(sourceFile);
34
+ const qualifiedKey = parts ? `${parts.folderName}.${name}` : name;
35
+ result[qualifiedKey] = record;
36
+ }
37
+ else {
38
+ result[name] = record;
39
+ }
40
+ }
41
+ }
42
+ return result;
43
+ }
44
+ //# sourceMappingURL=indexTypes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"indexTypes.js","sourceRoot":"","sources":["../../src/indexer/indexTypes.ts"],"names":[],"mappings":"AACA,OAAO,EACL,IAAI,EACJ,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAA+B,EAAE,CAAC;IAE9C,KAAK,MAAM,KAAK,IAAI,qBAAqB,EAAE,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAEnC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC;YACtD,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,iBAAiB,CACvD,IAAI,EACJ,UAAU,CACX,CAAC;YACF,MAAM,UAAU,GAAG,IAAI,CACrB,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAChC,kBAAkB,CACT,CAAC;YAEZ,MAAM,MAAM,GAAe;gBACzB,IAAI;gBACJ,UAAU;gBACV,UAAU;gBACV,eAAe;gBACf,UAAU;aACX,CAAC;YAEF,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,KAAK,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;gBAC/C,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBAClE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,45 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { REPO_ROOT } from './tsProject.js';
4
+ const ATOMIC_CURATED_META_PATH = path.join(REPO_ROOT, 'packages/mcp-server/vendor/atomic-curated-meta.json');
5
+ let cachedMeta;
6
+ function loadAtomicCuratedMeta() {
7
+ if (cachedMeta !== undefined)
8
+ return cachedMeta;
9
+ cachedMeta = fs.existsSync(ATOMIC_CURATED_META_PATH)
10
+ ? JSON.parse(fs.readFileSync(ATOMIC_CURATED_META_PATH, 'utf8'))
11
+ : null;
12
+ return cachedMeta;
13
+ }
14
+ /**
15
+ * Курированные description/category/keywords для компонентов, у которых нет
16
+ * собственного кода в ui-kit — чистых реэкспортов атомов @salutejs/sdds-finai
17
+ * (`export { Accordion } from '@salutejs/sdds-finai'`, без единой строчки
18
+ * своей логики). Для них mergeMeta.ts (_docs/meta/components-meta.json)
19
+ * бесполезен: там курируются компоненты с собственной реализацией и
20
+ * Storybook-документацией, а у чистых реэкспортов нет ни того, ни другого —
21
+ * единственный источник контента при курировании этого файла вручную —
22
+ * вендоренный снэпшот атомарки (vendor/atomic-mcp-data/**\/*.json, поле
23
+ * summary) и inheritedProps. См. TASKS.md T2.
24
+ *
25
+ * Отдельный файл и отдельный модуль от mergeMeta — это две независимые по
26
+ * происхождению записи (курируем "свой" код и "чужой" атом по-разному),
27
+ * curated wins over heuristic/JSDoc в обоих случаях одинаково.
28
+ */
29
+ export function mergeAtomicCuratedMeta(record) {
30
+ const meta = loadAtomicCuratedMeta();
31
+ const entry = meta?.components?.[record.name];
32
+ if (!entry)
33
+ return record;
34
+ return {
35
+ ...record,
36
+ ...(entry.category ? { category: entry.category } : {}),
37
+ ...(entry.description ? { description: entry.description } : {}),
38
+ ...(entry.keywords?.length ? { keywords: entry.keywords } : {}),
39
+ ...(entry.supersededBy ? { supersededBy: entry.supersededBy } : {}),
40
+ ...(entry.chooseWhen ? { chooseWhen: entry.chooseWhen } : {}),
41
+ ...(entry.gotchas?.length ? { gotchas: entry.gotchas } : {}),
42
+ hasCuratedMeta: true,
43
+ };
44
+ }
45
+ //# sourceMappingURL=mergeAtomicCuratedMeta.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mergeAtomicCuratedMeta.js","sourceRoot":"","sources":["../../src/indexer/mergeAtomicCuratedMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,wBAAwB,GAAG,IAAI,CAAC,IAAI,CACxC,SAAS,EACT,qDAAqD,CACtD,CAAC;AAEF,IAAI,UAAgD,CAAC;AAErD,SAAS,qBAAqB;IAC5B,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAChD,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAClD,CAAC,CAAE,IAAI,CAAC,KAAK,CACT,EAAE,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAC5B;QACzB,CAAC,CAAC,IAAI,CAAC;IACT,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA8B;IAE9B,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,OAAO;QACL,GAAG,MAAM;QACT,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,cAAc,EAAE,IAAa;KAC9B,CAAC;AACJ,CAAC"}
@@ -0,0 +1,188 @@
1
+ /* eslint-disable no-underscore-dangle */
2
+ /* eslint-disable @typescript-eslint/naming-convention */
3
+ import fs from 'node:fs';
4
+ import path from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
6
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
7
+ const VENDOR_COMPONENTS_DIR = path.resolve(__dirname, '../../vendor/atomic-mcp-data/components');
8
+ const VENDOR_BETA_DIR = path.resolve(__dirname, '../../vendor/atomic-mcp-data/beta');
9
+ const MANIFEST_PATH = path.resolve(__dirname, '../../vendor/atomic-mcp-data/manifest.json');
10
+ let cachedManifest;
11
+ function getManifest() {
12
+ if (cachedManifest === undefined) {
13
+ cachedManifest = fs.existsSync(MANIFEST_PATH)
14
+ ? JSON.parse(fs.readFileSync(MANIFEST_PATH, 'utf8'))
15
+ : null;
16
+ }
17
+ return cachedManifest;
18
+ }
19
+ /**
20
+ * Снэпшот — один файл на СТРАНИЦУ документации, не на атом (T15, см.
21
+ * ARCHITECTURE.md §1.6b): файл называется по странице, а в `api.props` попадает
22
+ * только ПЕРВАЯ таблица пропсов этой страницы. У двух страниц первая таблица
23
+ * документирует атом с другим именем — файл, названный по странице, несёт
24
+ * пропсы этого атома, а не одноимённого с файлом:
25
+ *
26
+ * - `Segment.json` — пропсы `SegmentGroup` (у страницы `Segment.mdx` вообще нет
27
+ * таблицы `Segment`: `<PropsTable name="SegmentGroup">`, затем `SegmentItem`);
28
+ * - `Skeleton.json` — пропсы `LineSkeleton` (страница `Skeleton.mdx`:
29
+ * `LineSkeleton`, `RectSkeleton`, `TextSkeleton`).
30
+ *
31
+ * Сверено 1:1 с собственным резолвом ts-morph: 8 из 8 пропсов `Skeleton.json`
32
+ * совпадают с own-пропсами `LineSkeleton`, 9 из 10 пропсов `Segment.json` — с
33
+ * own-пропсами `SegmentGroup` (десятый, `disabled`, — реальная вариация
34
+ * `SegmentGroup` в установленном `@salutejs/sdds-finai`, которую own-резолв не
35
+ * находит).
36
+ */
37
+ const ATOMIC_PAGE_FILE_BY_BASE = {
38
+ SegmentGroup: 'Segment',
39
+ LineSkeleton: 'Skeleton',
40
+ };
41
+ /**
42
+ * Обратная сторона той же находки: имена файлов из ATOMIC_PAGE_FILE_BY_BASE
43
+ * нельзя резолвить по совпадению с `atomicBase`. Сейчас ui-kit не экспортирует
44
+ * ни `Segment`, ни `Skeleton` — но если начнёт, эти записи молча получили бы
45
+ * пропсы чужого атома (`SegmentGroup`/`LineSkeleton`) как свои. Отдаём
46
+ * `atomicDataMissing`: отсутствие вендорных данных честнее подмешанных чужих.
47
+ */
48
+ const PAGE_FILES_OF_OTHER_ATOM = new Set(Object.values(ATOMIC_PAGE_FILE_BY_BASE));
49
+ /**
50
+ * Атомы, чья таблица пропсов в доках атомарной команды ЕСТЬ, но не первая на
51
+ * своей странице, — и потому в снэпшот не попадает вовсе (их `extractProps`
52
+ * берёт только первый JSON-массив пропсов со страницы, см. ARCHITECTURE.md
53
+ * §1.6b). Размечено по исходным `docs/components/*.mdx` в
54
+ * `plasma/website/sdds-finai-docs`: 87 таблиц `<PropsTable name="…">` на 72
55
+ * страницы `components/` + 2 `beta/` — 14 таблиц (этот список) снэпшот теряет.
56
+ *
57
+ * Единственный способ их получить — перегенерировать снэпшот у атомарной
58
+ * команды с исправленным `extractProps` (T15, задача открыта); наш код
59
+ * подмешать их не может — в вендоренном JSON этих данных физически нет.
60
+ * Список нужен диагностике: отличает известную дыру снэпшота от новой,
61
+ * появившейся после очередного перевендоринга.
62
+ */
63
+ export const ATOMIC_TABLE_ON_PARENT_PAGE = {
64
+ AccordionItem: 'Accordion',
65
+ CalendarBase: 'Calendar',
66
+ CalendarBaseRange: 'Calendar',
67
+ CalendarDouble: 'Calendar',
68
+ CalendarDoubleRange: 'Calendar',
69
+ Col: 'Grid',
70
+ DatePickerRange: 'DatePicker',
71
+ ListItem: 'List',
72
+ NotificationsProvider: 'Notification',
73
+ RectSkeleton: 'Skeleton',
74
+ SegmentItem: 'Segment',
75
+ TabItem: 'Tabs',
76
+ TabsController: 'Tabs',
77
+ TextSkeleton: 'Skeleton',
78
+ };
79
+ function loadAtomicComponent(atomicBase, atomicSubpath) {
80
+ // beta и основной пакет — разные директории вендоренного снэпшота: у части
81
+ // атомов есть тёзки в обеих категориях с разными пропсами (Popover,
82
+ // Tooltip), поэтому важно не перепутать и не подмешать пропсы не того атома.
83
+ const isBeta = atomicSubpath === 'beta';
84
+ const dir = isBeta ? VENDOR_BETA_DIR : VENDOR_COMPONENTS_DIR;
85
+ // Разметка страниц выше — про основной каталог: в beta первая таблица
86
+ // страницы (`PopoverBeta`/`TooltipBeta` в docgen) документирует ровно тот
87
+ // атом, что beta-пакет экспортирует под именем страницы, путаницы нет.
88
+ if (!isBeta && PAGE_FILES_OF_OTHER_ATOM.has(atomicBase))
89
+ return undefined;
90
+ const fileBase = isBeta
91
+ ? atomicBase
92
+ : ATOMIC_PAGE_FILE_BY_BASE[atomicBase] ?? atomicBase;
93
+ const filePath = path.join(dir, `${fileBase}.json`);
94
+ if (!fs.existsSync(filePath))
95
+ return undefined;
96
+ return JSON.parse(fs.readFileSync(filePath, 'utf8'));
97
+ }
98
+ /**
99
+ * Вендорный снэпшот систематически кладёт "" в description/default (генератор
100
+ * PropsTable у атомарной команды пишет только {name, type} — см.
101
+ * ARCHITECTURE.md §1.6) — пустая строка не то же самое, что "поле
102
+ * отсутствует", и агент читает "" как содержательный (пустой) дефолт.
103
+ * Не сохраняем такие поля вовсе.
104
+ */
105
+ function dropEmptyStrings(p) {
106
+ const cleaned = { ...p };
107
+ if (cleaned.description === '')
108
+ delete cleaned.description;
109
+ if (cleaned.default === '')
110
+ delete cleaned.default;
111
+ return cleaned;
112
+ }
113
+ /**
114
+ * Вендор беднее собственного резолва ts-morph: замер на 40 wrapper-компонентах
115
+ * — 0 описаний, 0 default, 0 required:true во всём снэпшоте, при 454 реальных
116
+ * русских описаниях и 8 required:true, потерянных прежним "own минус
117
+ * inherited"-дедупом (см. TASKS.md T14). Поэтому там, где имя совпало,
118
+ * описание и required берём из own (ts-morph — источник точнее), а текст типа
119
+ * и сам факт наличия пропса — из вендора (он ближе к тому, как атом реально
120
+ * типизирован публично, без внутренних деталей ui-kit-обёртки). `default`
121
+ * (TASKS.md T6) вендор не несёт вовсе (см. dropEmptyStrings) — own всегда
122
+ * побеждает, если он его резолвил (деструктуризация/`@default`).
123
+ */
124
+ function mergeWithOwn(vendorProp, ownProp) {
125
+ if (!ownProp)
126
+ return vendorProp;
127
+ return {
128
+ ...vendorProp,
129
+ required: ownProp.required,
130
+ description: ownProp.description || vendorProp.description,
131
+ default: ownProp.default ?? vendorProp.default,
132
+ };
133
+ }
134
+ /**
135
+ * Тот же порядок, что и у own props[] (см. propTier/sortProps в
136
+ * parseComponent.ts, TASKS.md T7, п.3) — required → с описанием → без
137
+ * описания, по алфавиту внутри яруса. У AtomicPropRecord нет `deprecated`,
138
+ * поэтому последнего яруса (deprecated в конец) здесь просто не существует.
139
+ */
140
+ function sortInheritedProps(props) {
141
+ const tier = (p) => {
142
+ if (p.required)
143
+ return 0;
144
+ return p.description ? 1 : 2;
145
+ };
146
+ return [...props].sort((a, b) => {
147
+ const tierDiff = tier(a) - tier(b);
148
+ return tierDiff !== 0 ? tierDiff : a.name.localeCompare(b.name);
149
+ });
150
+ }
151
+ /**
152
+ * Для каждого компонента с atomicBase (wrapper/form) подмешивает пропсы из
153
+ * вендоренного снэпшота атомарной команды как inheritedProps[] — отдельно от
154
+ * собственных props[]. Пропсы, совпавшие по имени с собственными (own),
155
+ * пополевым мёрджем объединяются в единственную inheritedProps-запись — own
156
+ * при этом убирается из props[], иначе для "чистых" реэкспортов (Button,
157
+ * Accordion) получили бы дублирование всего списка пропсов дважды. Own не
158
+ * теряется бесследно — description/required из него побеждают, см.
159
+ * mergeWithOwn.
160
+ */
161
+ export function mergeAtomicData(record) {
162
+ if (!record.atomicBase) {
163
+ return { ...record, atomicMcpVersion: getManifest()?.version };
164
+ }
165
+ const atomicComponent = loadAtomicComponent(record.atomicBase, record.atomicSubpath);
166
+ if (!atomicComponent) {
167
+ return { ...record, atomicDataMissing: true };
168
+ }
169
+ const ownByName = new Map((record.props || []).map((p) => [p.name, p]));
170
+ const inheritedProps = sortInheritedProps((atomicComponent.api?.props || []).map((p) => ({
171
+ ...mergeWithOwn(dropEmptyStrings(p), ownByName.get(p.name)),
172
+ inheritedFrom: record.atomicBase,
173
+ inheritedPackage: '@salutejs/sdds-finai',
174
+ })));
175
+ const inheritedNames = new Set(inheritedProps.map((p) => p.name));
176
+ const ownProps = (record.props || []).filter((p) => !inheritedNames.has(p.name));
177
+ const vendorExampleSnippets = (atomicComponent.examples || [])
178
+ .filter((e) => Boolean(e.snippet))
179
+ .map((e) => ({ title: e.title, snippet: e.snippet }));
180
+ return {
181
+ ...record,
182
+ props: ownProps,
183
+ inheritedProps,
184
+ atomicMcpVersion: getManifest()?.version,
185
+ ...(vendorExampleSnippets.length ? { vendorExampleSnippets } : {}),
186
+ };
187
+ }
188
+ //# sourceMappingURL=mergeAtomicData.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mergeAtomicData.js","sourceRoot":"","sources":["../../src/indexer/mergeAtomicData.ts"],"names":[],"mappings":"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"}