@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,85 @@
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
+ const INSTALLATION_PAGE_TITLE = 'Установка и использование';
6
+ let cachedMeta;
7
+ function loadMetaJson() {
8
+ if (cachedMeta !== undefined)
9
+ return cachedMeta;
10
+ cachedMeta = fs.existsSync(META_JSON_PATH)
11
+ ? JSON.parse(fs.readFileSync(META_JSON_PATH, 'utf8'))
12
+ : null;
13
+ return cachedMeta;
14
+ }
15
+ /** Убирает крупные <style>...</style>-блоки из сырого MDX — чистый шум для агента. */
16
+ function stripStyleBlocks(text) {
17
+ return text ? text.replace(/<style>[\s\S]*?<\/style>/g, '').trim() : text;
18
+ }
19
+ /**
20
+ * `legacy` (поддерживается, но не рекомендуется для нового кода) — ОТДЕЛЬНЫЙ
21
+ * флаг от `deprecated` (реально устаревший API из @deprecated JSDoc).
22
+ * Детектится по curated-тексту: сейчас в библиотеке только один такой случай
23
+ * (Table — "устаревшая, но поддерживается"), но это принципиальная проверка
24
+ * по смыслу текста, а не хардкод конкретного имени компонента.
25
+ */
26
+ function detectLegacy(componentMeta) {
27
+ const text = `${componentMeta.description || ''} ${componentMeta.hint || ''}`;
28
+ return /устаревш/i.test(text);
29
+ }
30
+ /**
31
+ * Курированные поля из _docs/meta/components-meta.json (hint, disambiguation,
32
+ * готовые докстроки/примеры) — там, где компонент присутствует, они
33
+ * перекрывают эвристику индексера, а не наоборот (curated wins over heuristic).
34
+ * Мета покрывает только 36 из 265+ найденных компонентов — для остальных
35
+ * просто ничего не меняется.
36
+ */
37
+ export function mergeMeta(record) {
38
+ const meta = loadMetaJson();
39
+ const componentMeta = meta?.components?.[record.name];
40
+ if (!componentMeta)
41
+ return record;
42
+ return {
43
+ ...record,
44
+ ...(componentMeta.category ? { category: componentMeta.category } : {}),
45
+ ...(componentMeta.type ? { type: componentMeta.type } : {}),
46
+ ...(componentMeta.role ? { role: componentMeta.role } : {}),
47
+ ...(componentMeta.description
48
+ ? { description: componentMeta.description }
49
+ : {}),
50
+ ...(componentMeta.hint ? { hint: componentMeta.hint } : {}),
51
+ ...(componentMeta.keywords?.length
52
+ ? { keywords: componentMeta.keywords }
53
+ : {}),
54
+ ...(componentMeta.scope ? { scope: componentMeta.scope } : {}),
55
+ ...(componentMeta.docs ? { docs: componentMeta.docs } : {}),
56
+ ...(componentMeta.apiDocs ? { apiDocs: componentMeta.apiDocs } : {}),
57
+ ...(componentMeta.stories?.length
58
+ ? { curatedStories: componentMeta.stories }
59
+ : {}),
60
+ ...(detectLegacy(componentMeta) ? { legacy: true } : {}),
61
+ ...(componentMeta.supersededBy
62
+ ? { supersededBy: componentMeta.supersededBy }
63
+ : {}),
64
+ ...(componentMeta.chooseWhen
65
+ ? { chooseWhen: componentMeta.chooseWhen }
66
+ : {}),
67
+ ...(componentMeta.gotchas?.length
68
+ ? { gotchas: componentMeta.gotchas }
69
+ : {}),
70
+ hasCuratedMeta: true,
71
+ };
72
+ }
73
+ /** Гайд по установке (`guides.installation`) — то же поле, что уже генерирует meta-info, без нового парсинга. */
74
+ export function getInstallationGuide() {
75
+ const meta = loadMetaJson();
76
+ const page = meta?.pages?.[INSTALLATION_PAGE_TITLE];
77
+ if (!page)
78
+ return undefined;
79
+ return {
80
+ title: page.title,
81
+ description: page.description,
82
+ docs: stripStyleBlocks(page.docs),
83
+ };
84
+ }
85
+ //# sourceMappingURL=mergeMeta.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mergeMeta.js","sourceRoot":"","sources":["../../src/indexer/mergeMeta.ts"],"names":[],"mappings":"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"}