@mweinbach/apple-docs-mcp 1.0.0

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 (267) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +560 -0
  3. package/dist/constants/browser-headers.d.ts +48 -0
  4. package/dist/constants/browser-headers.d.ts.map +1 -0
  5. package/dist/constants/browser-headers.js +166 -0
  6. package/dist/constants/browser-headers.js.map +1 -0
  7. package/dist/index.d.ts +83 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +215 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/schemas/analyze-api.schema.d.ts +42 -0
  12. package/dist/schemas/analyze-api.schema.d.ts.map +1 -0
  13. package/dist/schemas/analyze-api.schema.js +23 -0
  14. package/dist/schemas/analyze-api.schema.js.map +1 -0
  15. package/dist/schemas/apple-docs.schema.d.ts +18 -0
  16. package/dist/schemas/apple-docs.schema.d.ts.map +1 -0
  17. package/dist/schemas/apple-docs.schema.js +10 -0
  18. package/dist/schemas/apple-docs.schema.js.map +1 -0
  19. package/dist/schemas/doc-content.schema.d.ts +24 -0
  20. package/dist/schemas/doc-content.schema.d.ts.map +1 -0
  21. package/dist/schemas/doc-content.schema.js +10 -0
  22. package/dist/schemas/doc-content.schema.js.map +1 -0
  23. package/dist/schemas/documentation-updates.schema.d.ts +27 -0
  24. package/dist/schemas/documentation-updates.schema.d.ts.map +1 -0
  25. package/dist/schemas/documentation-updates.schema.js +12 -0
  26. package/dist/schemas/documentation-updates.schema.js.map +1 -0
  27. package/dist/schemas/framework-symbols.schema.d.ts +24 -0
  28. package/dist/schemas/framework-symbols.schema.d.ts.map +1 -0
  29. package/dist/schemas/framework-symbols.schema.js +11 -0
  30. package/dist/schemas/framework-symbols.schema.js.map +1 -0
  31. package/dist/schemas/index.d.ts +15 -0
  32. package/dist/schemas/index.d.ts.map +1 -0
  33. package/dist/schemas/index.js +15 -0
  34. package/dist/schemas/index.js.map +1 -0
  35. package/dist/schemas/platform-compatibility.schema.d.ts +18 -0
  36. package/dist/schemas/platform-compatibility.schema.d.ts.map +1 -0
  37. package/dist/schemas/platform-compatibility.schema.js +8 -0
  38. package/dist/schemas/platform-compatibility.schema.js.map +1 -0
  39. package/dist/schemas/references.schema.d.ts +18 -0
  40. package/dist/schemas/references.schema.d.ts.map +1 -0
  41. package/dist/schemas/references.schema.js +9 -0
  42. package/dist/schemas/references.schema.js.map +1 -0
  43. package/dist/schemas/related-apis.schema.d.ts +21 -0
  44. package/dist/schemas/related-apis.schema.d.ts.map +1 -0
  45. package/dist/schemas/related-apis.schema.js +9 -0
  46. package/dist/schemas/related-apis.schema.js.map +1 -0
  47. package/dist/schemas/sample-code.schema.d.ts +21 -0
  48. package/dist/schemas/sample-code.schema.d.ts.map +1 -0
  49. package/dist/schemas/sample-code.schema.js +10 -0
  50. package/dist/schemas/sample-code.schema.js.map +1 -0
  51. package/dist/schemas/search.schema.d.ts +15 -0
  52. package/dist/schemas/search.schema.d.ts.map +1 -0
  53. package/dist/schemas/search.schema.js +8 -0
  54. package/dist/schemas/search.schema.js.map +1 -0
  55. package/dist/schemas/similar-apis.schema.d.ts +21 -0
  56. package/dist/schemas/similar-apis.schema.d.ts.map +1 -0
  57. package/dist/schemas/similar-apis.schema.js +9 -0
  58. package/dist/schemas/similar-apis.schema.js.map +1 -0
  59. package/dist/schemas/technologies.schema.d.ts +21 -0
  60. package/dist/schemas/technologies.schema.d.ts.map +1 -0
  61. package/dist/schemas/technologies.schema.js +10 -0
  62. package/dist/schemas/technologies.schema.js.map +1 -0
  63. package/dist/schemas/technology-overviews.schema.d.ts +24 -0
  64. package/dist/schemas/technology-overviews.schema.d.ts.map +1 -0
  65. package/dist/schemas/technology-overviews.schema.js +11 -0
  66. package/dist/schemas/technology-overviews.schema.js.map +1 -0
  67. package/dist/schemas/wwdc.schemas.d.ts +208 -0
  68. package/dist/schemas/wwdc.schemas.d.ts.map +1 -0
  69. package/dist/schemas/wwdc.schemas.js +97 -0
  70. package/dist/schemas/wwdc.schemas.js.map +1 -0
  71. package/dist/tools/definitions.d.ts +10 -0
  72. package/dist/tools/definitions.d.ts.map +1 -0
  73. package/dist/tools/definitions.js +690 -0
  74. package/dist/tools/definitions.js.map +1 -0
  75. package/dist/tools/doc-fetcher.d.ts +19 -0
  76. package/dist/tools/doc-fetcher.d.ts.map +1 -0
  77. package/dist/tools/doc-fetcher.js +487 -0
  78. package/dist/tools/doc-fetcher.js.map +1 -0
  79. package/dist/tools/doc-formatter.d.ts +69 -0
  80. package/dist/tools/doc-formatter.d.ts.map +1 -0
  81. package/dist/tools/doc-formatter.js +208 -0
  82. package/dist/tools/doc-formatter.js.map +1 -0
  83. package/dist/tools/find-similar-apis.d.ts +5 -0
  84. package/dist/tools/find-similar-apis.d.ts.map +1 -0
  85. package/dist/tools/find-similar-apis.js +275 -0
  86. package/dist/tools/find-similar-apis.js.map +1 -0
  87. package/dist/tools/get-documentation-updates.d.ts +5 -0
  88. package/dist/tools/get-documentation-updates.d.ts.map +1 -0
  89. package/dist/tools/get-documentation-updates.js +244 -0
  90. package/dist/tools/get-documentation-updates.js.map +1 -0
  91. package/dist/tools/get-platform-compatibility.d.ts +5 -0
  92. package/dist/tools/get-platform-compatibility.d.ts.map +1 -0
  93. package/dist/tools/get-platform-compatibility.js +205 -0
  94. package/dist/tools/get-platform-compatibility.js.map +1 -0
  95. package/dist/tools/get-related-apis.d.ts +5 -0
  96. package/dist/tools/get-related-apis.d.ts.map +1 -0
  97. package/dist/tools/get-related-apis.js +155 -0
  98. package/dist/tools/get-related-apis.js.map +1 -0
  99. package/dist/tools/get-sample-code.d.ts +5 -0
  100. package/dist/tools/get-sample-code.d.ts.map +1 -0
  101. package/dist/tools/get-sample-code.js +375 -0
  102. package/dist/tools/get-sample-code.js.map +1 -0
  103. package/dist/tools/get-technology-overviews.d.ts +5 -0
  104. package/dist/tools/get-technology-overviews.d.ts.map +1 -0
  105. package/dist/tools/get-technology-overviews.js +306 -0
  106. package/dist/tools/get-technology-overviews.js.map +1 -0
  107. package/dist/tools/handlers.d.ts +29 -0
  108. package/dist/tools/handlers.d.ts.map +1 -0
  109. package/dist/tools/handlers.js +350 -0
  110. package/dist/tools/handlers.js.map +1 -0
  111. package/dist/tools/list-technologies.d.ts +5 -0
  112. package/dist/tools/list-technologies.d.ts.map +1 -0
  113. package/dist/tools/list-technologies.js +165 -0
  114. package/dist/tools/list-technologies.js.map +1 -0
  115. package/dist/tools/resolve-references-batch.d.ts +5 -0
  116. package/dist/tools/resolve-references-batch.d.ts.map +1 -0
  117. package/dist/tools/resolve-references-batch.js +199 -0
  118. package/dist/tools/resolve-references-batch.js.map +1 -0
  119. package/dist/tools/search-framework-symbols.d.ts +7 -0
  120. package/dist/tools/search-framework-symbols.d.ts.map +1 -0
  121. package/dist/tools/search-framework-symbols.js +235 -0
  122. package/dist/tools/search-framework-symbols.js.map +1 -0
  123. package/dist/tools/search-parser.d.ts +15 -0
  124. package/dist/tools/search-parser.d.ts.map +1 -0
  125. package/dist/tools/search-parser.js +188 -0
  126. package/dist/tools/search-parser.js.map +1 -0
  127. package/dist/tools/search-result-parser.d.ts +52 -0
  128. package/dist/tools/search-result-parser.d.ts.map +1 -0
  129. package/dist/tools/search-result-parser.js +137 -0
  130. package/dist/tools/search-result-parser.js.map +1 -0
  131. package/dist/tools/tools-guide.d.ts +124 -0
  132. package/dist/tools/tools-guide.d.ts.map +1 -0
  133. package/dist/tools/tools-guide.js +389 -0
  134. package/dist/tools/tools-guide.js.map +1 -0
  135. package/dist/tools/wwdc/content-extractor.d.ts +9 -0
  136. package/dist/tools/wwdc/content-extractor.d.ts.map +1 -0
  137. package/dist/tools/wwdc/content-extractor.js +520 -0
  138. package/dist/tools/wwdc/content-extractor.js.map +1 -0
  139. package/dist/tools/wwdc/topics-extractor.d.ts +32 -0
  140. package/dist/tools/wwdc/topics-extractor.d.ts.map +1 -0
  141. package/dist/tools/wwdc/topics-extractor.js +146 -0
  142. package/dist/tools/wwdc/topics-extractor.js.map +1 -0
  143. package/dist/tools/wwdc/video-list-extractor.d.ts +13 -0
  144. package/dist/tools/wwdc/video-list-extractor.d.ts.map +1 -0
  145. package/dist/tools/wwdc/video-list-extractor.js +238 -0
  146. package/dist/tools/wwdc/video-list-extractor.js.map +1 -0
  147. package/dist/tools/wwdc/wwdc-handlers.d.ts +32 -0
  148. package/dist/tools/wwdc/wwdc-handlers.d.ts.map +1 -0
  149. package/dist/tools/wwdc/wwdc-handlers.js +791 -0
  150. package/dist/tools/wwdc/wwdc-handlers.js.map +1 -0
  151. package/dist/types/apple-docs.d.ts +112 -0
  152. package/dist/types/apple-docs.d.ts.map +1 -0
  153. package/dist/types/apple-docs.js +5 -0
  154. package/dist/types/apple-docs.js.map +1 -0
  155. package/dist/types/cache.d.ts +28 -0
  156. package/dist/types/cache.d.ts.map +1 -0
  157. package/dist/types/cache.js +5 -0
  158. package/dist/types/cache.js.map +1 -0
  159. package/dist/types/content-sections.d.ts +37 -0
  160. package/dist/types/content-sections.d.ts.map +1 -0
  161. package/dist/types/content-sections.js +5 -0
  162. package/dist/types/content-sections.js.map +1 -0
  163. package/dist/types/error.d.ts +39 -0
  164. package/dist/types/error.d.ts.map +1 -0
  165. package/dist/types/error.js +21 -0
  166. package/dist/types/error.js.map +1 -0
  167. package/dist/types/headers.d.ts +95 -0
  168. package/dist/types/headers.d.ts.map +1 -0
  169. package/dist/types/headers.js +5 -0
  170. package/dist/types/headers.js.map +1 -0
  171. package/dist/types/http.d.ts +31 -0
  172. package/dist/types/http.d.ts.map +1 -0
  173. package/dist/types/http.js +5 -0
  174. package/dist/types/http.js.map +1 -0
  175. package/dist/types/index.d.ts +11 -0
  176. package/dist/types/index.d.ts.map +1 -0
  177. package/dist/types/index.js +12 -0
  178. package/dist/types/index.js.map +1 -0
  179. package/dist/types/search.d.ts +62 -0
  180. package/dist/types/search.d.ts.map +1 -0
  181. package/dist/types/search.js +5 -0
  182. package/dist/types/search.js.map +1 -0
  183. package/dist/types/sections.d.ts +64 -0
  184. package/dist/types/sections.d.ts.map +1 -0
  185. package/dist/types/sections.js +5 -0
  186. package/dist/types/sections.js.map +1 -0
  187. package/dist/types/tools/platform.d.ts +33 -0
  188. package/dist/types/tools/platform.d.ts.map +1 -0
  189. package/dist/types/tools/platform.js +5 -0
  190. package/dist/types/tools/platform.js.map +1 -0
  191. package/dist/types/tools/sample-code.d.ts +23 -0
  192. package/dist/types/tools/sample-code.d.ts.map +1 -0
  193. package/dist/types/tools/sample-code.js +5 -0
  194. package/dist/types/tools/sample-code.js.map +1 -0
  195. package/dist/types/tools/technology.d.ts +18 -0
  196. package/dist/types/tools/technology.d.ts.map +1 -0
  197. package/dist/types/tools/technology.js +5 -0
  198. package/dist/types/tools/technology.js.map +1 -0
  199. package/dist/types/tools/updates.d.ts +23 -0
  200. package/dist/types/tools/updates.d.ts.map +1 -0
  201. package/dist/types/tools/updates.js +5 -0
  202. package/dist/types/tools/updates.js.map +1 -0
  203. package/dist/types/wwdc.d.ts +200 -0
  204. package/dist/types/wwdc.d.ts.map +1 -0
  205. package/dist/types/wwdc.js +5 -0
  206. package/dist/types/wwdc.js.map +1 -0
  207. package/dist/utils/cache-warmer.d.ts +22 -0
  208. package/dist/utils/cache-warmer.d.ts.map +1 -0
  209. package/dist/utils/cache-warmer.js +115 -0
  210. package/dist/utils/cache-warmer.js.map +1 -0
  211. package/dist/utils/cache.d.ts +109 -0
  212. package/dist/utils/cache.d.ts.map +1 -0
  213. package/dist/utils/cache.js +302 -0
  214. package/dist/utils/cache.js.map +1 -0
  215. package/dist/utils/constants.d.ts +178 -0
  216. package/dist/utils/constants.d.ts.map +1 -0
  217. package/dist/utils/constants.js +266 -0
  218. package/dist/utils/constants.js.map +1 -0
  219. package/dist/utils/error-handler.d.ts +80 -0
  220. package/dist/utils/error-handler.d.ts.map +1 -0
  221. package/dist/utils/error-handler.js +437 -0
  222. package/dist/utils/error-handler.js.map +1 -0
  223. package/dist/utils/framework-mapper.d.ts +84 -0
  224. package/dist/utils/framework-mapper.d.ts.map +1 -0
  225. package/dist/utils/framework-mapper.js +534 -0
  226. package/dist/utils/framework-mapper.js.map +1 -0
  227. package/dist/utils/http-client.d.ts +130 -0
  228. package/dist/utils/http-client.d.ts.map +1 -0
  229. package/dist/utils/http-client.js +464 -0
  230. package/dist/utils/http-client.js.map +1 -0
  231. package/dist/utils/http-headers-generator.d.ts +151 -0
  232. package/dist/utils/http-headers-generator.d.ts.map +1 -0
  233. package/dist/utils/http-headers-generator.js +407 -0
  234. package/dist/utils/http-headers-generator.js.map +1 -0
  235. package/dist/utils/logger.d.ts +44 -0
  236. package/dist/utils/logger.d.ts.map +1 -0
  237. package/dist/utils/logger.js +73 -0
  238. package/dist/utils/logger.js.map +1 -0
  239. package/dist/utils/preloader.d.ts +20 -0
  240. package/dist/utils/preloader.d.ts.map +1 -0
  241. package/dist/utils/preloader.js +82 -0
  242. package/dist/utils/preloader.js.map +1 -0
  243. package/dist/utils/rate-limiter.d.ts +28 -0
  244. package/dist/utils/rate-limiter.d.ts.map +1 -0
  245. package/dist/utils/rate-limiter.js +48 -0
  246. package/dist/utils/rate-limiter.js.map +1 -0
  247. package/dist/utils/topic-mapper.d.ts +18 -0
  248. package/dist/utils/topic-mapper.d.ts.map +1 -0
  249. package/dist/utils/topic-mapper.js +182 -0
  250. package/dist/utils/topic-mapper.js.map +1 -0
  251. package/dist/utils/url-converter.d.ts +22 -0
  252. package/dist/utils/url-converter.d.ts.map +1 -0
  253. package/dist/utils/url-converter.js +70 -0
  254. package/dist/utils/url-converter.js.map +1 -0
  255. package/dist/utils/user-agent-pool.d.ts +241 -0
  256. package/dist/utils/user-agent-pool.d.ts.map +1 -0
  257. package/dist/utils/user-agent-pool.js +557 -0
  258. package/dist/utils/user-agent-pool.js.map +1 -0
  259. package/dist/utils/wwdc-data-source-path.d.ts +9 -0
  260. package/dist/utils/wwdc-data-source-path.d.ts.map +1 -0
  261. package/dist/utils/wwdc-data-source-path.js +22 -0
  262. package/dist/utils/wwdc-data-source-path.js.map +1 -0
  263. package/dist/utils/wwdc-data-source.d.ts +36 -0
  264. package/dist/utils/wwdc-data-source.d.ts.map +1 -0
  265. package/dist/utils/wwdc-data-source.js +133 -0
  266. package/dist/utils/wwdc-data-source.js.map +1 -0
  267. package/package.json +83 -0
@@ -0,0 +1,199 @@
1
+ import { convertToJsonApiUrl } from '../utils/url-converter.js';
2
+ import { httpClient } from '../utils/http-client.js';
3
+ import { logger } from '../utils/logger.js';
4
+ /**
5
+ * 批量解析引用
6
+ */
7
+ export async function handleResolveReferencesBatch(sourceUrl, maxReferences = 20, filterByType = 'all') {
8
+ try {
9
+ logger.info(`Resolving references from: ${sourceUrl}`);
10
+ // 将网页URL转换为JSON API URL
11
+ const jsonApiUrl = convertToJsonApiUrl(sourceUrl);
12
+ if (!jsonApiUrl) {
13
+ throw new Error('Invalid Apple Developer Documentation URL');
14
+ }
15
+ const data = await httpClient.getJson(jsonApiUrl);
16
+ if (!data.references || Object.keys(data.references).length === 0) {
17
+ return `No references found in: ${sourceUrl}`;
18
+ }
19
+ // 过滤和限制引用数量
20
+ const filteredReferences = filterReferences(data.references, filterByType);
21
+ const limitedReferences = Object.entries(filteredReferences).slice(0, maxReferences);
22
+ // 解析引用信息
23
+ const resolvedReferences = [];
24
+ for (const [identifier, refData] of limitedReferences) {
25
+ const resolved = await resolveReference(identifier, refData);
26
+ if (resolved) {
27
+ resolvedReferences.push(resolved);
28
+ }
29
+ }
30
+ // 格式化输出
31
+ return formatResolvedReferences(sourceUrl, resolvedReferences, data.metadata?.title);
32
+ }
33
+ catch (error) {
34
+ const errorMessage = error instanceof Error ? error.message : String(error);
35
+ return `Error: Failed to resolve references: ${errorMessage}`;
36
+ }
37
+ }
38
+ /**
39
+ * 过滤引用
40
+ */
41
+ function filterReferences(references, filterByType) {
42
+ if (filterByType === 'all') {
43
+ return references;
44
+ }
45
+ const filtered = {};
46
+ for (const [identifier, refData] of Object.entries(references)) {
47
+ const matchesFilter = refData.role === filterByType ||
48
+ refData.kind === filterByType ||
49
+ refData.type === filterByType ||
50
+ refData.symbolKind === filterByType;
51
+ if (matchesFilter) {
52
+ filtered[identifier] = refData;
53
+ }
54
+ }
55
+ return filtered;
56
+ }
57
+ /**
58
+ * 解析单个引用
59
+ */
60
+ async function resolveReference(identifier, refData) {
61
+ try {
62
+ // 基本信息
63
+ const resolved = {
64
+ identifier,
65
+ title: refData.title || 'Unknown',
66
+ url: refData.url ? `https://developer.apple.com${refData.url}` : '#',
67
+ type: refData.type || 'unknown',
68
+ role: refData.role || 'unknown',
69
+ kind: refData.kind,
70
+ symbolKind: refData.symbolKind,
71
+ };
72
+ // 处理摘要
73
+ if (refData.abstract && Array.isArray(refData.abstract)) {
74
+ resolved.abstract = refData.abstract
75
+ .map(item => item.text || '')
76
+ .join(' ')
77
+ .trim();
78
+ }
79
+ // 处理代码片段
80
+ if (refData.fragments && Array.isArray(refData.fragments)) {
81
+ resolved.fragments = refData.fragments.map(fragment => ({
82
+ kind: fragment.kind || 'text',
83
+ text: fragment.text || '',
84
+ }));
85
+ }
86
+ // 处理平台信息
87
+ if (refData.platforms && Array.isArray(refData.platforms)) {
88
+ resolved.platforms = refData.platforms.map(platform => ({
89
+ name: platform.name || 'Unknown',
90
+ introducedAt: platform.introducedAt,
91
+ beta: platform.beta || false,
92
+ deprecated: platform.deprecated || false,
93
+ }));
94
+ }
95
+ return resolved;
96
+ }
97
+ catch (error) {
98
+ logger.error(`Failed to resolve reference ${identifier}:`, error);
99
+ return null;
100
+ }
101
+ }
102
+ /**
103
+ * 格式化解析结果
104
+ */
105
+ function formatResolvedReferences(sourceUrl, references, sourceTitle) {
106
+ if (references.length === 0) {
107
+ return `No references could be resolved from: ${sourceUrl}`;
108
+ }
109
+ const title = sourceTitle || new URL(sourceUrl).pathname.split('/').pop() || 'Document';
110
+ let content = `# References from ${title}\n\n`;
111
+ content += `**Source:** [${sourceUrl}](${sourceUrl})\n\n`;
112
+ content += `**Resolved ${references.length} references:**\n\n`;
113
+ // 按类型分组
114
+ const groupedReferences = groupReferencesByRole(references);
115
+ for (const [role, refs] of Object.entries(groupedReferences)) {
116
+ content += `## ${formatRoleTitle(role)} (${refs.length})\n\n`;
117
+ for (const ref of refs) {
118
+ content += formatSingleReference(ref);
119
+ }
120
+ }
121
+ content += `---\n\n*Total: ${references.length} references resolved*`;
122
+ return content;
123
+ }
124
+ /**
125
+ * 按角色分组引用
126
+ */
127
+ function groupReferencesByRole(references) {
128
+ const groups = {};
129
+ for (const ref of references) {
130
+ const role = ref.role || 'unknown';
131
+ if (!groups[role]) {
132
+ groups[role] = [];
133
+ }
134
+ groups[role].push(ref);
135
+ }
136
+ return groups;
137
+ }
138
+ /**
139
+ * 格式化角色标题
140
+ */
141
+ function formatRoleTitle(role) {
142
+ const roleTitles = {
143
+ 'symbol': 'API Symbols',
144
+ 'collection': 'Collections',
145
+ 'article': 'Articles',
146
+ 'sampleCode': 'Sample Code',
147
+ 'overview': 'Overviews',
148
+ 'collectionGroup': 'Collection Groups',
149
+ 'unknown': 'Other References',
150
+ };
151
+ return roleTitles[role] || role.charAt(0).toUpperCase() + role.slice(1);
152
+ }
153
+ /**
154
+ * 格式化单个引用
155
+ */
156
+ function formatSingleReference(ref) {
157
+ let content = `### [${ref.title}](${ref.url})\n`;
158
+ // 添加代码片段(如果是符号)
159
+ if (ref.fragments && ref.fragments.length > 0) {
160
+ const codeSignature = ref.fragments.map(f => f.text).join('');
161
+ if (codeSignature.trim()) {
162
+ content += `\`\`\`swift\n${codeSignature}\`\`\`\n\n`;
163
+ }
164
+ }
165
+ // 添加摘要
166
+ if (ref.abstract) {
167
+ content += `${ref.abstract}\n\n`;
168
+ }
169
+ // 添加元数据
170
+ const metadata = [];
171
+ if (ref.kind) {
172
+ metadata.push(`Kind: ${ref.kind}`);
173
+ }
174
+ if (ref.symbolKind) {
175
+ metadata.push(`Symbol: ${ref.symbolKind}`);
176
+ }
177
+ if (metadata.length > 0) {
178
+ content += `*${metadata.join(' | ')}*\n\n`;
179
+ }
180
+ // 添加平台信息
181
+ if (ref.platforms && ref.platforms.length > 0) {
182
+ const platformInfo = ref.platforms.map(p => {
183
+ let info = p.name;
184
+ if (p.introducedAt) {
185
+ info += ` ${p.introducedAt}+`;
186
+ }
187
+ if (p.beta) {
188
+ info += ' (Beta)';
189
+ }
190
+ if (p.deprecated) {
191
+ info += ' (Deprecated)';
192
+ }
193
+ return info;
194
+ }).join(', ');
195
+ content += `**Platforms:** ${platformInfo}\n\n`;
196
+ }
197
+ return content;
198
+ }
199
+ //# sourceMappingURL=resolve-references-batch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-references-batch.js","sourceRoot":"","sources":["../../src/tools/resolve-references-batch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { Tool } from '@modelcontextprotocol/sdk/types.js';
2
+ /**
3
+ * MCP Tool Definition
4
+ */
5
+ export declare const searchFrameworkSymbolsTool: Tool;
6
+ export declare function searchFrameworkSymbols(framework: string, symbolType?: string, namePattern?: string, language?: string, limit?: number): Promise<string>;
7
+ //# sourceMappingURL=search-framework-symbols.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-framework-symbols.d.ts","sourceRoot":"","sources":["../../src/tools/search-framework-symbols.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAO/D;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,IAiCxC,CAAC;AAiEF,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAc,EAC1B,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAgB,EAC1B,KAAK,GAAE,MAAmD,GACzD,OAAO,CAAC,MAAM,CAAC,CAmFjB"}
@@ -0,0 +1,235 @@
1
+ import { indexCache, generateUrlCacheKey } from '../utils/cache.js';
2
+ import { APPLE_URLS, API_LIMITS, PROCESSING_LIMITS } from '../utils/constants.js';
3
+ import { httpClient } from '../utils/http-client.js';
4
+ import { logger } from '../utils/logger.js';
5
+ import { normalizeFrameworkName } from '../utils/framework-mapper.js';
6
+ /**
7
+ * MCP Tool Definition
8
+ */
9
+ export const searchFrameworkSymbolsTool = {
10
+ name: 'search_framework_symbols',
11
+ description: 'Browse and search symbols within a specific Apple framework. Perfect for exploring framework APIs, finding all views/controllers/delegates in a framework, or discovering available types. Use after list_technologies to get framework identifiers.',
12
+ inputSchema: {
13
+ type: 'object',
14
+ properties: {
15
+ framework: {
16
+ type: 'string',
17
+ description: 'Framework identifier in lowercase. Common: "uikit", "swiftui", "foundation", "combine", "coredata". Get exact names from list_technologies. Example: "swiftui" for SwiftUI framework.',
18
+ },
19
+ symbolType: {
20
+ type: 'string',
21
+ enum: ['all', 'class', 'struct', 'enum', 'protocol', 'method', 'property', 'init', 'func', 'var', 'let', 'typealias'],
22
+ description: 'Filter by symbol type. Use "class" for UIViewController subclasses, "protocol" for delegates, "struct" for value types. Default: "all" shows everything.',
23
+ },
24
+ namePattern: {
25
+ type: 'string',
26
+ description: 'Filter by name pattern. Use "*View" for all views, "UI*" for UI-prefixed symbols, "*Delegate" for delegates. Case-sensitive. Leave empty for all symbols.',
27
+ },
28
+ language: {
29
+ type: 'string',
30
+ enum: ['swift', 'occ'],
31
+ description: 'Language preference. Some APIs differ between Swift and Objective-C. Default: "swift"',
32
+ },
33
+ limit: {
34
+ type: 'number',
35
+ description: `Results limit (default: ${API_LIMITS.DEFAULT_FRAMEWORK_SYMBOLS_LIMIT}, max: ${API_LIMITS.MAX_FRAMEWORK_SYMBOLS_LIMIT}). Includes nested symbols.`,
36
+ minimum: 1,
37
+ maximum: API_LIMITS.MAX_FRAMEWORK_SYMBOLS_LIMIT,
38
+ },
39
+ },
40
+ required: ['framework'],
41
+ },
42
+ };
43
+ /**
44
+ * 搜索框架中的符号(类、结构体、协议等)
45
+ */
46
+ // Function to find symbols recursively (defined outside to reduce complexity)
47
+ function findSymbolsRecursive(items, symbolType, namePattern, limit, symbols, depth = 0) {
48
+ if (depth > 6) {
49
+ return false;
50
+ }
51
+ for (const item of items) {
52
+ if (symbols.length >= limit) {
53
+ return true; // Limit reached
54
+ }
55
+ // Check if symbol type matches
56
+ if (symbolType === 'all' || item.type === symbolType) {
57
+ // Check name pattern if provided
58
+ if (!namePattern || matchesPattern(item.title, namePattern)) {
59
+ symbols.push(item);
60
+ }
61
+ }
62
+ if (item.children && symbols.length < limit) {
63
+ const limitReached = findSymbolsRecursive(item.children, symbolType, namePattern, limit, symbols, depth + 1);
64
+ if (limitReached) {
65
+ return true;
66
+ }
67
+ }
68
+ }
69
+ return false;
70
+ }
71
+ export async function searchFrameworkSymbols(framework, symbolType = 'all', namePattern, language = 'swift', limit = API_LIMITS.DEFAULT_FRAMEWORK_SYMBOLS_LIMIT) {
72
+ try {
73
+ // Normalize framework name for consistent processing
74
+ const normalizedFramework = normalizeFrameworkName(framework);
75
+ logger.info(`Searching ${symbolType} symbols in ${normalizedFramework} framework`);
76
+ // 获取框架索引
77
+ const indexUrl = `${APPLE_URLS.TUTORIALS_DATA}index/${framework.toLowerCase()}`;
78
+ const cacheKey = generateUrlCacheKey(indexUrl, { framework: normalizedFramework, symbolType, namePattern, language, limit });
79
+ // Check cache
80
+ const cachedResult = indexCache.get(cacheKey);
81
+ if (cachedResult) {
82
+ return cachedResult;
83
+ }
84
+ const data = await httpClient.getJson(indexUrl);
85
+ // Get language-specific index
86
+ const indexItems = data.interfaceLanguages?.[language] || [];
87
+ if (indexItems.length === 0) {
88
+ const availableLanguages = Object.keys(data.interfaceLanguages || {});
89
+ return `Language "${language}" not available for ${framework}. Available languages: ${availableLanguages.join(', ')}`;
90
+ }
91
+ // Find all symbols recursively
92
+ const symbols = [];
93
+ findSymbolsRecursive(indexItems, symbolType, namePattern, limit, symbols);
94
+ // Format results
95
+ const typeLabel = symbolType === 'all' ? 'Symbols' : pluralizeType(symbolType);
96
+ let result = `# ${framework} Framework ${typeLabel}\n\n`;
97
+ if (symbols.length === 0) {
98
+ const typeText = symbolType === 'all' ? 'symbols' : pluralizeType(symbolType).toLowerCase();
99
+ result += `No ${typeText} found`;
100
+ if (namePattern) {
101
+ result += ` matching pattern "${namePattern}"`;
102
+ }
103
+ result += ` in ${framework} framework.\n`;
104
+ // Suggest exploring collections
105
+ const collections = findCollections(indexItems);
106
+ if (collections.length > 0) {
107
+ result += '\n## Try exploring these collections:\n\n';
108
+ for (const col of collections.slice(0, PROCESSING_LIMITS.MAX_COLLECTIONS_TO_SHOW)) {
109
+ result += `- [${col.title}](https://developer.apple.com${col.path})\n`;
110
+ }
111
+ }
112
+ }
113
+ else {
114
+ result += `**Found:** ${symbols.length} ${symbolType === 'all' ? 'symbols' : pluralizeType(symbolType).toLowerCase()}`;
115
+ if (namePattern) {
116
+ result += ` matching "${namePattern}"`;
117
+ }
118
+ result += '\n\n';
119
+ // Group by type if searching all
120
+ if (symbolType === 'all') {
121
+ const grouped = groupByType(symbols);
122
+ for (const [type, items] of Object.entries(grouped)) {
123
+ result += `## ${pluralizeType(type)} (${items.length})\n\n`;
124
+ for (const item of items) {
125
+ result += formatSymbolItem(item);
126
+ }
127
+ result += '\n';
128
+ }
129
+ }
130
+ else {
131
+ // List symbols
132
+ for (const symbol of symbols) {
133
+ result += formatSymbolItem(symbol);
134
+ }
135
+ }
136
+ }
137
+ // Cache result
138
+ indexCache.set(cacheKey, result);
139
+ return result;
140
+ }
141
+ catch (error) {
142
+ return `Error searching classes: ${error instanceof Error ? error.message : String(error)}`;
143
+ }
144
+ }
145
+ function formatSymbolItem(item) {
146
+ const url = `https://developer.apple.com${item.path}`;
147
+ let result = `- [**${item.title}**](${url})`;
148
+ const metadata = [];
149
+ if (item.beta) {
150
+ metadata.push('Beta');
151
+ }
152
+ if (item.deprecated) {
153
+ metadata.push('Deprecated');
154
+ }
155
+ if (item.type && item.type !== 'groupMarker') {
156
+ metadata.push(formatTypeLabel(item.type));
157
+ }
158
+ if (metadata.length > 0) {
159
+ result += ` *(${metadata.join(', ')})*`;
160
+ }
161
+ return result + '\n';
162
+ }
163
+ function groupByType(symbols) {
164
+ const groups = {};
165
+ for (const symbol of symbols) {
166
+ if (!groups[symbol.type]) {
167
+ groups[symbol.type] = [];
168
+ }
169
+ groups[symbol.type].push(symbol);
170
+ }
171
+ return groups;
172
+ }
173
+ function formatTypeLabel(type) {
174
+ const typeLabels = {
175
+ 'symbol': 'Symbol',
176
+ 'module': 'Module',
177
+ 'class': 'Class',
178
+ 'struct': 'Struct',
179
+ 'enum': 'Enum',
180
+ 'protocol': 'Protocol',
181
+ 'method': 'Method',
182
+ 'property': 'Property',
183
+ 'init': 'Initializer',
184
+ 'case': 'Case',
185
+ 'associatedtype': 'Associated Type',
186
+ 'typealias': 'Type Alias',
187
+ 'article': 'Article',
188
+ 'sampleCode': 'Sample Code',
189
+ 'overview': 'Overview',
190
+ 'collection': 'Collection',
191
+ 'func': 'Function',
192
+ 'var': 'Variable',
193
+ 'let': 'Constant',
194
+ 'operator': 'Operator',
195
+ 'macro': 'Macro',
196
+ 'namespace': 'Namespace',
197
+ };
198
+ return typeLabels[type] || type.charAt(0).toUpperCase() + type.slice(1);
199
+ }
200
+ function pluralizeType(type) {
201
+ const typeLabel = formatTypeLabel(type);
202
+ // Special cases for pluralization
203
+ const pluralRules = {
204
+ 'Class': 'Classes',
205
+ 'Property': 'Properties',
206
+ 'Associated Type': 'Associated Types',
207
+ 'Type Alias': 'Type Aliases',
208
+ 'Sample Code': 'Sample Code',
209
+ };
210
+ return pluralRules[typeLabel] || typeLabel + 's';
211
+ }
212
+ function matchesPattern(name, pattern) {
213
+ const regexPattern = pattern
214
+ .split('*')
215
+ .map(part => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
216
+ .join('.*');
217
+ const regex = new RegExp(`^${regexPattern}$`, 'i');
218
+ return regex.test(name);
219
+ }
220
+ function findCollections(items) {
221
+ const collections = [];
222
+ function search(itemList) {
223
+ for (const item of itemList) {
224
+ if (item.type === 'collection') {
225
+ collections.push(item);
226
+ }
227
+ if (item.children) {
228
+ search(item.children);
229
+ }
230
+ }
231
+ }
232
+ search(items);
233
+ return collections;
234
+ }
235
+ //# sourceMappingURL=search-framework-symbols.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-framework-symbols.js","sourceRoot":"","sources":["../../src/tools/search-framework-symbols.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import type { SearchResult } from './search-result-parser.js';
2
+ /**
3
+ * Formats search results for display
4
+ */
5
+ export declare function formatSearchResults(results: SearchResult[], query: string, filterType: string, searchUrl: string): string;
6
+ /**
7
+ * Parse search results with reduced complexity
8
+ */
9
+ export declare function parseSearchResults(html: string, query: string, searchUrl: string, filterType?: string): {
10
+ content: Array<{
11
+ type: string;
12
+ text: string;
13
+ }>;
14
+ };
15
+ //# sourceMappingURL=search-parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-parser.d.ts","sourceRoot":"","sources":["../../src/tools/search-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAgCR;AA+ID;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAc,GACzB;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAmCpD"}