@urbicon-ui/docs-gen 6.1.4

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 (263) hide show
  1. package/README.md +92 -0
  2. package/dist/cli/CLI.d.ts +10 -0
  3. package/dist/cli/CLI.d.ts.map +1 -0
  4. package/dist/cli/CLI.js +340 -0
  5. package/dist/cli/CLI.js.map +1 -0
  6. package/dist/cli/index.d.ts +2 -0
  7. package/dist/cli/index.d.ts.map +1 -0
  8. package/dist/cli/index.js +7 -0
  9. package/dist/cli/index.js.map +1 -0
  10. package/dist/core/discovery/ComponentFinder.d.ts +43 -0
  11. package/dist/core/discovery/ComponentFinder.d.ts.map +1 -0
  12. package/dist/core/discovery/ComponentFinder.js +421 -0
  13. package/dist/core/discovery/ComponentFinder.js.map +1 -0
  14. package/dist/core/discovery/FileStructureAnalyzer.d.ts +15 -0
  15. package/dist/core/discovery/FileStructureAnalyzer.d.ts.map +1 -0
  16. package/dist/core/discovery/FileStructureAnalyzer.js +35 -0
  17. package/dist/core/discovery/FileStructureAnalyzer.js.map +1 -0
  18. package/dist/core/discovery/MetadataExtractor.d.ts +15 -0
  19. package/dist/core/discovery/MetadataExtractor.d.ts.map +1 -0
  20. package/dist/core/discovery/MetadataExtractor.js +47 -0
  21. package/dist/core/discovery/MetadataExtractor.js.map +1 -0
  22. package/dist/core/discovery/index.d.ts +2 -0
  23. package/dist/core/discovery/index.d.ts.map +1 -0
  24. package/dist/core/discovery/index.js +2 -0
  25. package/dist/core/discovery/index.js.map +1 -0
  26. package/dist/core/enrichment/APIDataGenerator.d.ts +77 -0
  27. package/dist/core/enrichment/APIDataGenerator.d.ts.map +1 -0
  28. package/dist/core/enrichment/APIDataGenerator.js +663 -0
  29. package/dist/core/enrichment/APIDataGenerator.js.map +1 -0
  30. package/dist/core/enrichment/index.d.ts +2 -0
  31. package/dist/core/enrichment/index.d.ts.map +1 -0
  32. package/dist/core/enrichment/index.js +6 -0
  33. package/dist/core/enrichment/index.js.map +1 -0
  34. package/dist/core/extraction/ExtractionCoordinator.d.ts +53 -0
  35. package/dist/core/extraction/ExtractionCoordinator.d.ts.map +1 -0
  36. package/dist/core/extraction/ExtractionCoordinator.js +352 -0
  37. package/dist/core/extraction/ExtractionCoordinator.js.map +1 -0
  38. package/dist/core/extraction/index.d.ts +2 -0
  39. package/dist/core/extraction/index.d.ts.map +1 -0
  40. package/dist/core/extraction/index.js +2 -0
  41. package/dist/core/extraction/index.js.map +1 -0
  42. package/dist/core/generation/GenerationCoordinator.d.ts +51 -0
  43. package/dist/core/generation/GenerationCoordinator.d.ts.map +1 -0
  44. package/dist/core/generation/GenerationCoordinator.js +206 -0
  45. package/dist/core/generation/GenerationCoordinator.js.map +1 -0
  46. package/dist/core/generation/index.d.ts +2 -0
  47. package/dist/core/generation/index.d.ts.map +1 -0
  48. package/dist/core/generation/index.js +2 -0
  49. package/dist/core/generation/index.js.map +1 -0
  50. package/dist/core/index.d.ts +7 -0
  51. package/dist/core/index.d.ts.map +1 -0
  52. package/dist/core/index.js +16 -0
  53. package/dist/core/index.js.map +1 -0
  54. package/dist/core/pipeline/ErrorHandler.d.ts +129 -0
  55. package/dist/core/pipeline/ErrorHandler.d.ts.map +1 -0
  56. package/dist/core/pipeline/ErrorHandler.js +321 -0
  57. package/dist/core/pipeline/ErrorHandler.js.map +1 -0
  58. package/dist/core/pipeline/PipelineOrchestrator.d.ts +45 -0
  59. package/dist/core/pipeline/PipelineOrchestrator.d.ts.map +1 -0
  60. package/dist/core/pipeline/PipelineOrchestrator.js +216 -0
  61. package/dist/core/pipeline/PipelineOrchestrator.js.map +1 -0
  62. package/dist/core/pipeline/index.d.ts +1 -0
  63. package/dist/core/pipeline/index.d.ts.map +1 -0
  64. package/dist/core/pipeline/index.js +2 -0
  65. package/dist/core/pipeline/index.js.map +1 -0
  66. package/dist/extractors/BaseExtractor.d.ts +33 -0
  67. package/dist/extractors/BaseExtractor.d.ts.map +1 -0
  68. package/dist/extractors/BaseExtractor.js +68 -0
  69. package/dist/extractors/BaseExtractor.js.map +1 -0
  70. package/dist/extractors/ExtractorFactory.d.ts +35 -0
  71. package/dist/extractors/ExtractorFactory.d.ts.map +1 -0
  72. package/dist/extractors/ExtractorFactory.js +88 -0
  73. package/dist/extractors/ExtractorFactory.js.map +1 -0
  74. package/dist/extractors/documentation/index.d.ts +1 -0
  75. package/dist/extractors/documentation/index.d.ts.map +1 -0
  76. package/dist/extractors/documentation/index.js +2 -0
  77. package/dist/extractors/documentation/index.js.map +1 -0
  78. package/dist/extractors/index.d.ts +1 -0
  79. package/dist/extractors/index.d.ts.map +1 -0
  80. package/dist/extractors/index.js +2 -0
  81. package/dist/extractors/index.js.map +1 -0
  82. package/dist/extractors/typescript/ExamplesExtractor.d.ts +32 -0
  83. package/dist/extractors/typescript/ExamplesExtractor.d.ts.map +1 -0
  84. package/dist/extractors/typescript/ExamplesExtractor.js +209 -0
  85. package/dist/extractors/typescript/ExamplesExtractor.js.map +1 -0
  86. package/dist/extractors/typescript/InheritanceExtractor.d.ts +45 -0
  87. package/dist/extractors/typescript/InheritanceExtractor.d.ts.map +1 -0
  88. package/dist/extractors/typescript/InheritanceExtractor.js +368 -0
  89. package/dist/extractors/typescript/InheritanceExtractor.js.map +1 -0
  90. package/dist/extractors/typescript/LocalTypesExtractor.d.ts +20 -0
  91. package/dist/extractors/typescript/LocalTypesExtractor.d.ts.map +1 -0
  92. package/dist/extractors/typescript/LocalTypesExtractor.js +100 -0
  93. package/dist/extractors/typescript/LocalTypesExtractor.js.map +1 -0
  94. package/dist/extractors/typescript/PropsExtractor.d.ts +142 -0
  95. package/dist/extractors/typescript/PropsExtractor.d.ts.map +1 -0
  96. package/dist/extractors/typescript/PropsExtractor.js +709 -0
  97. package/dist/extractors/typescript/PropsExtractor.js.map +1 -0
  98. package/dist/extractors/typescript/TypeScriptBaseExtractor.d.ts +74 -0
  99. package/dist/extractors/typescript/TypeScriptBaseExtractor.d.ts.map +1 -0
  100. package/dist/extractors/typescript/TypeScriptBaseExtractor.js +249 -0
  101. package/dist/extractors/typescript/TypeScriptBaseExtractor.js.map +1 -0
  102. package/dist/extractors/typescript/index.d.ts +1 -0
  103. package/dist/extractors/typescript/index.d.ts.map +1 -0
  104. package/dist/extractors/typescript/index.js +2 -0
  105. package/dist/extractors/typescript/index.js.map +1 -0
  106. package/dist/extractors/variants/TailwindVariantsParser.d.ts +16 -0
  107. package/dist/extractors/variants/TailwindVariantsParser.d.ts.map +1 -0
  108. package/dist/extractors/variants/TailwindVariantsParser.js +53 -0
  109. package/dist/extractors/variants/TailwindVariantsParser.js.map +1 -0
  110. package/dist/extractors/variants/VariantsExtractor.d.ts +45 -0
  111. package/dist/extractors/variants/VariantsExtractor.d.ts.map +1 -0
  112. package/dist/extractors/variants/VariantsExtractor.js +340 -0
  113. package/dist/extractors/variants/VariantsExtractor.js.map +1 -0
  114. package/dist/extractors/variants/index.d.ts +2 -0
  115. package/dist/extractors/variants/index.d.ts.map +1 -0
  116. package/dist/extractors/variants/index.js +2 -0
  117. package/dist/extractors/variants/index.js.map +1 -0
  118. package/dist/generators/api/APIFileGenerator.d.ts +32 -0
  119. package/dist/generators/api/APIFileGenerator.d.ts.map +1 -0
  120. package/dist/generators/api/APIFileGenerator.js +450 -0
  121. package/dist/generators/api/APIFileGenerator.js.map +1 -0
  122. package/dist/generators/api/TypeDefinitionGenerator.d.ts +1 -0
  123. package/dist/generators/api/TypeDefinitionGenerator.d.ts.map +1 -0
  124. package/dist/generators/api/TypeDefinitionGenerator.js +2 -0
  125. package/dist/generators/api/TypeDefinitionGenerator.js.map +1 -0
  126. package/dist/generators/api/index.d.ts +2 -0
  127. package/dist/generators/api/index.d.ts.map +1 -0
  128. package/dist/generators/api/index.js +2 -0
  129. package/dist/generators/api/index.js.map +1 -0
  130. package/dist/generators/index.d.ts +5 -0
  131. package/dist/generators/index.d.ts.map +1 -0
  132. package/dist/generators/index.js +4 -0
  133. package/dist/generators/index.js.map +1 -0
  134. package/dist/generators/llm/LLMDocumentationGenerator.d.ts +34 -0
  135. package/dist/generators/llm/LLMDocumentationGenerator.d.ts.map +1 -0
  136. package/dist/generators/llm/LLMDocumentationGenerator.js +480 -0
  137. package/dist/generators/llm/LLMDocumentationGenerator.js.map +1 -0
  138. package/dist/generators/llm/LLMFormatter.d.ts +4 -0
  139. package/dist/generators/llm/LLMFormatter.d.ts.map +1 -0
  140. package/dist/generators/llm/LLMFormatter.js +8 -0
  141. package/dist/generators/llm/LLMFormatter.js.map +1 -0
  142. package/dist/generators/llm/LlmsFullAssembler.d.ts +20 -0
  143. package/dist/generators/llm/LlmsFullAssembler.d.ts.map +1 -0
  144. package/dist/generators/llm/LlmsFullAssembler.js +63 -0
  145. package/dist/generators/llm/LlmsFullAssembler.js.map +1 -0
  146. package/dist/generators/llm/index.d.ts +1 -0
  147. package/dist/generators/llm/index.d.ts.map +1 -0
  148. package/dist/generators/llm/index.js +2 -0
  149. package/dist/generators/llm/index.js.map +1 -0
  150. package/dist/generators/mcp/MCPCatalogAssembler.d.ts +27 -0
  151. package/dist/generators/mcp/MCPCatalogAssembler.d.ts.map +1 -0
  152. package/dist/generators/mcp/MCPCatalogAssembler.js +147 -0
  153. package/dist/generators/mcp/MCPCatalogAssembler.js.map +1 -0
  154. package/dist/generators/mcp/MCPCatalogGenerator.d.ts +55 -0
  155. package/dist/generators/mcp/MCPCatalogGenerator.d.ts.map +1 -0
  156. package/dist/generators/mcp/MCPCatalogGenerator.js +153 -0
  157. package/dist/generators/mcp/MCPCatalogGenerator.js.map +1 -0
  158. package/dist/generators/svelte/PageGenerator.d.ts +82 -0
  159. package/dist/generators/svelte/PageGenerator.d.ts.map +1 -0
  160. package/dist/generators/svelte/PageGenerator.js +557 -0
  161. package/dist/generators/svelte/PageGenerator.js.map +1 -0
  162. package/dist/generators/svelte/PlaygroundPresets.d.ts +2 -0
  163. package/dist/generators/svelte/PlaygroundPresets.d.ts.map +1 -0
  164. package/dist/generators/svelte/PlaygroundPresets.js +4 -0
  165. package/dist/generators/svelte/PlaygroundPresets.js.map +1 -0
  166. package/dist/generators/svelte/SectionMerger.d.ts +38 -0
  167. package/dist/generators/svelte/SectionMerger.d.ts.map +1 -0
  168. package/dist/generators/svelte/SectionMerger.js +154 -0
  169. package/dist/generators/svelte/SectionMerger.js.map +1 -0
  170. package/dist/generators/svelte/TemplateEngine.d.ts +91 -0
  171. package/dist/generators/svelte/TemplateEngine.d.ts.map +1 -0
  172. package/dist/generators/svelte/TemplateEngine.js +500 -0
  173. package/dist/generators/svelte/TemplateEngine.js.map +1 -0
  174. package/dist/generators/svelte/index.d.ts +8 -0
  175. package/dist/generators/svelte/index.d.ts.map +1 -0
  176. package/dist/generators/svelte/index.js +11 -0
  177. package/dist/generators/svelte/index.js.map +1 -0
  178. package/dist/generators/svelte/renderers/ApiRenderer.d.ts +17 -0
  179. package/dist/generators/svelte/renderers/ApiRenderer.d.ts.map +1 -0
  180. package/dist/generators/svelte/renderers/ApiRenderer.js +44 -0
  181. package/dist/generators/svelte/renderers/ApiRenderer.js.map +1 -0
  182. package/dist/generators/svelte/renderers/ExampleRenderer.d.ts +33 -0
  183. package/dist/generators/svelte/renderers/ExampleRenderer.d.ts.map +1 -0
  184. package/dist/generators/svelte/renderers/ExampleRenderer.js +137 -0
  185. package/dist/generators/svelte/renderers/ExampleRenderer.js.map +1 -0
  186. package/dist/generators/svelte/renderers/OverviewRenderer.d.ts +9 -0
  187. package/dist/generators/svelte/renderers/OverviewRenderer.d.ts.map +1 -0
  188. package/dist/generators/svelte/renderers/OverviewRenderer.js +45 -0
  189. package/dist/generators/svelte/renderers/OverviewRenderer.js.map +1 -0
  190. package/dist/generators/svelte/renderers/PlaygroundRenderer.d.ts +35 -0
  191. package/dist/generators/svelte/renderers/PlaygroundRenderer.d.ts.map +1 -0
  192. package/dist/generators/svelte/renderers/PlaygroundRenderer.js +319 -0
  193. package/dist/generators/svelte/renderers/PlaygroundRenderer.js.map +1 -0
  194. package/dist/generators/svelte/renderers/TypesRenderer.d.ts +9 -0
  195. package/dist/generators/svelte/renderers/TypesRenderer.d.ts.map +1 -0
  196. package/dist/generators/svelte/renderers/TypesRenderer.js +23 -0
  197. package/dist/generators/svelte/renderers/TypesRenderer.js.map +1 -0
  198. package/dist/generators/svelte/renderers/UsageRenderer.d.ts +14 -0
  199. package/dist/generators/svelte/renderers/UsageRenderer.d.ts.map +1 -0
  200. package/dist/generators/svelte/renderers/UsageRenderer.js +91 -0
  201. package/dist/generators/svelte/renderers/UsageRenderer.js.map +1 -0
  202. package/dist/generators/svelte/renderers/VariantsRenderer.d.ts +43 -0
  203. package/dist/generators/svelte/renderers/VariantsRenderer.d.ts.map +1 -0
  204. package/dist/generators/svelte/renderers/VariantsRenderer.js +277 -0
  205. package/dist/generators/svelte/renderers/VariantsRenderer.js.map +1 -0
  206. package/dist/generators/svelte/renderers/index.d.ts +8 -0
  207. package/dist/generators/svelte/renderers/index.d.ts.map +1 -0
  208. package/dist/generators/svelte/renderers/index.js +8 -0
  209. package/dist/generators/svelte/renderers/index.js.map +1 -0
  210. package/dist/generators/svelte/types.d.ts +13 -0
  211. package/dist/generators/svelte/types.d.ts.map +1 -0
  212. package/dist/generators/svelte/types.js +2 -0
  213. package/dist/generators/svelte/types.js.map +1 -0
  214. package/dist/index.d.ts +5 -0
  215. package/dist/index.d.ts.map +1 -0
  216. package/dist/index.js +4 -0
  217. package/dist/index.js.map +1 -0
  218. package/dist/parsers/SvelteDocsParser.d.ts +44 -0
  219. package/dist/parsers/SvelteDocsParser.d.ts.map +1 -0
  220. package/dist/parsers/SvelteDocsParser.js +141 -0
  221. package/dist/parsers/SvelteDocsParser.js.map +1 -0
  222. package/dist/parsers/index.d.ts +2 -0
  223. package/dist/parsers/index.d.ts.map +1 -0
  224. package/dist/parsers/index.js +6 -0
  225. package/dist/parsers/index.js.map +1 -0
  226. package/dist/schema/ConfigurationBuilder.d.ts +55 -0
  227. package/dist/schema/ConfigurationBuilder.d.ts.map +1 -0
  228. package/dist/schema/ConfigurationBuilder.js +447 -0
  229. package/dist/schema/ConfigurationBuilder.js.map +1 -0
  230. package/dist/schema/index.d.ts +1 -0
  231. package/dist/schema/index.d.ts.map +1 -0
  232. package/dist/schema/index.js +2 -0
  233. package/dist/schema/index.js.map +1 -0
  234. package/dist/tsconfig.tsbuildinfo +1 -0
  235. package/dist/types/configuration.d.ts +255 -0
  236. package/dist/types/configuration.d.ts.map +1 -0
  237. package/dist/types/configuration.js +2 -0
  238. package/dist/types/configuration.js.map +1 -0
  239. package/dist/types/core.d.ts +96 -0
  240. package/dist/types/core.d.ts.map +1 -0
  241. package/dist/types/core.js +2 -0
  242. package/dist/types/core.js.map +1 -0
  243. package/dist/types/docs-config.d.ts +5 -0
  244. package/dist/types/docs-config.d.ts.map +1 -0
  245. package/dist/types/docs-config.js +51 -0
  246. package/dist/types/docs-config.js.map +1 -0
  247. package/dist/types/index.d.ts +6 -0
  248. package/dist/types/index.d.ts.map +1 -0
  249. package/dist/types/index.js +9 -0
  250. package/dist/types/index.js.map +1 -0
  251. package/dist/types/validation.d.ts +321 -0
  252. package/dist/types/validation.d.ts.map +1 -0
  253. package/dist/types/validation.js +2 -0
  254. package/dist/types/validation.js.map +1 -0
  255. package/dist/utils/DeploymentManager.d.ts +80 -0
  256. package/dist/utils/DeploymentManager.d.ts.map +1 -0
  257. package/dist/utils/DeploymentManager.js +360 -0
  258. package/dist/utils/DeploymentManager.js.map +1 -0
  259. package/dist/utils/index.d.ts +1 -0
  260. package/dist/utils/index.d.ts.map +1 -0
  261. package/dist/utils/index.js +2 -0
  262. package/dist/utils/index.js.map +1 -0
  263. package/package.json +74 -0
@@ -0,0 +1,154 @@
1
+ import { getDefaultSectionOrder } from '@/types';
2
+ /**
3
+ * Merges auto-generated sections with custom Svelte sections
4
+ * Implements the "Auto-First + Svelte Override" strategy
5
+ */
6
+ export class SectionMerger {
7
+ /**
8
+ * Merge auto-generated sections and apply docsConfig filters/order.
9
+ * Note: Custom Svelte sections are not parsed anymore; they are included separately as a component.
10
+ */
11
+ merge(autoSections, docsConfig) {
12
+ console.log(`🔄 SectionMerger: Processing ${autoSections.length} auto sections`);
13
+ console.log(`🔄 SectionMerger: Auto section IDs: ${autoSections.map((s) => s.id).join(', ')}`);
14
+ const sectionMap = new Map();
15
+ const conflicts = [];
16
+ const replaced = [];
17
+ const added = [];
18
+ // 1. Add auto-generated sections first (baseline)
19
+ autoSections.forEach((autoSection) => {
20
+ const mergedSection = {
21
+ id: autoSection.id,
22
+ title: autoSection.title,
23
+ content: autoSection.content,
24
+ type: 'auto',
25
+ order: autoSection.order || getDefaultSectionOrder(autoSection.id),
26
+ ...(autoSection.scriptData ? { scriptData: autoSection.scriptData } : {}),
27
+ llm: this.shouldIncludeInLLM(autoSection.id, autoSection.type, docsConfig),
28
+ source: {
29
+ auto: true,
30
+ custom: false
31
+ }
32
+ };
33
+ sectionMap.set(autoSection.id, mergedSection);
34
+ console.log(`➕ SectionMerger: Added auto section: ${autoSection.id} (order: ${mergedSection.order})`);
35
+ });
36
+ // 2. No custom sections to process in current architecture
37
+ // Debug: Show sections before config filters
38
+ console.log(`🔍 SectionMerger: Before config filters - sections: ${Array.from(sectionMap.keys()).join(', ')}`);
39
+ // 3. Apply docsConfig filters
40
+ this.applyConfigFilters(sectionMap, docsConfig);
41
+ // Debug: Show sections after config filters
42
+ console.log(`🔍 SectionMerger: After config filters - sections: ${Array.from(sectionMap.keys()).join(', ')}`);
43
+ // 4. Sort sections by order
44
+ const finalSections = this.sortSections(Array.from(sectionMap.values()));
45
+ console.log(`✅ SectionMerger: Merge complete - ${finalSections.length} total sections`);
46
+ console.log(` 📊 Replaced: ${replaced.length} (${replaced.join(', ')}), Added: ${added.length} (${added.join(', ')}), Conflicts: ${conflicts.length}`);
47
+ console.log(` 📝 Final section IDs: ${finalSections.map((s) => `${s.id}(${s.type})`).join(', ')}`);
48
+ return { sections: finalSections, replaced, added, conflicts };
49
+ }
50
+ /**
51
+ * Apply configuration filters (disable sections, etc.)
52
+ */
53
+ applyConfigFilters(sectionMap, docsConfig) {
54
+ // Check examples config - this is important!
55
+ console.log(`🔍 SectionMerger: examples config:`, docsConfig.generation?.examples);
56
+ // Filter based on generation config
57
+ // IMPORTANT: Only remove AUTO-GENERATED examples, not custom ones!
58
+ if (docsConfig.generation?.examples === false ||
59
+ (typeof docsConfig.generation?.examples === 'object' &&
60
+ docsConfig.generation?.examples?.enabled === false)) {
61
+ const examplesSection = sectionMap.get('examples');
62
+ if (examplesSection && examplesSection.type === 'auto') {
63
+ console.log(`🚫 SectionMerger: Removing AUTO-GENERATED examples section (disabled in config)`);
64
+ sectionMap.delete('examples');
65
+ }
66
+ else if (examplesSection && examplesSection.type === 'custom') {
67
+ console.log(`✅ SectionMerger: Keeping CUSTOM examples section (config only disables auto-generated)`);
68
+ }
69
+ }
70
+ else {
71
+ console.log(`✅ SectionMerger: examples section allowed by config`);
72
+ }
73
+ // Apply playground config
74
+ if (docsConfig.generation?.playground?.enabled === false) {
75
+ if (sectionMap.has('playground')) {
76
+ console.log(`🚫 SectionMerger: Removing playground section (disabled in config)`);
77
+ sectionMap.delete('playground');
78
+ }
79
+ }
80
+ // Apply overview config
81
+ if (docsConfig.generation?.overview?.enabled === false) {
82
+ if (sectionMap.has('overview')) {
83
+ console.log(`🚫 SectionMerger: Removing overview section (disabled in config)`);
84
+ sectionMap.delete('overview');
85
+ }
86
+ }
87
+ // Apply variants config
88
+ if (docsConfig.generation?.variants?.enabled === false) {
89
+ if (sectionMap.has('variants')) {
90
+ console.log(`🚫 SectionMerger: Removing variants section (disabled in config)`);
91
+ sectionMap.delete('variants');
92
+ }
93
+ }
94
+ // Apply API config
95
+ if (docsConfig.generation?.api?.enabled === false) {
96
+ if (sectionMap.has('api')) {
97
+ console.log(`🚫 SectionMerger: Removing api section (disabled in config)`);
98
+ sectionMap.delete('api');
99
+ }
100
+ }
101
+ }
102
+ /**
103
+ * Sort sections by order value
104
+ */
105
+ sortSections(sections) {
106
+ return sections.sort((a, b) => {
107
+ // Primary sort: order
108
+ const orderDiff = a.order - b.order;
109
+ if (orderDiff !== 0)
110
+ return orderDiff;
111
+ // Secondary sort: type priority (auto before custom for same order)
112
+ const typePriority = { auto: 1, custom: 2, merged: 3 };
113
+ return typePriority[a.type] - typePriority[b.type];
114
+ });
115
+ }
116
+ /**
117
+ * Determine if section should be included in LLM documentation
118
+ */
119
+ shouldIncludeInLLM(sectionId, sectionType, docsConfig) {
120
+ // Check global LLM inclusion
121
+ if (docsConfig.llm?.include === false) {
122
+ return false;
123
+ }
124
+ // Check excluded types
125
+ if (docsConfig.llm?.excludeTypes?.includes(sectionType)) {
126
+ return false;
127
+ }
128
+ // Check priority list (if specified, only include priority sections)
129
+ if (docsConfig.llm?.priority && docsConfig.llm.priority.length > 0) {
130
+ return docsConfig.llm.priority.includes(sectionId);
131
+ }
132
+ // Default inclusion rules
133
+ const defaultExclude = ['playground']; // Playground is too interactive for LLM
134
+ return !defaultExclude.includes(sectionType);
135
+ }
136
+ // Custom ParsedSvelteSection handling removed
137
+ /**
138
+ * Get statistics about the merge operation
139
+ */
140
+ getMergeStats(result) {
141
+ const autoCount = result.sections.filter((s) => s.type === 'auto').length;
142
+ const customCount = result.sections.filter((s) => s.type === 'custom').length;
143
+ const llmCount = result.sections.filter((s) => s.llm).length;
144
+ return {
145
+ total: result.sections.length,
146
+ auto: autoCount,
147
+ custom: customCount,
148
+ replaced: result.replaced.length,
149
+ added: result.added.length,
150
+ llmIncluded: llmCount
151
+ };
152
+ }
153
+ }
154
+ //# sourceMappingURL=SectionMerger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SectionMerger.js","sourceRoot":"","sources":["../../../src/generators/svelte/SectionMerger.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EAIvB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB;;;OAGG;IACH,KAAK,CAAC,YAA+B,EAAE,UAA4B;QACjE,OAAO,CAAC,GAAG,CAAC,gCAAgC,YAAY,CAAC,MAAM,gBAAgB,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,uCAAuC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE/F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;QACpD,MAAM,SAAS,GAAsB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,kDAAkD;QAClD,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YACnC,MAAM,aAAa,GAAkB;gBACnC,EAAE,EAAE,WAAW,CAAC,EAAE;gBAClB,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,GAAG,EAAE,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC;gBAC1E,MAAM,EAAE;oBACN,IAAI,EAAE,IAAI;oBACV,MAAM,EAAE,KAAK;iBACd;aACF,CAAC;YAEF,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CACT,wCAAwC,WAAW,CAAC,EAAE,YAAY,aAAa,CAAC,KAAK,GAAG,CACzF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,2DAA2D;QAE3D,6CAA6C;QAC7C,OAAO,CAAC,GAAG,CACT,uDAAuD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClG,CAAC;QAEF,8BAA8B;QAC9B,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAEhD,4CAA4C;QAC5C,OAAO,CAAC,GAAG,CACT,sDAAsD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjG,CAAC;QAEF,4BAA4B;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEzE,OAAO,CAAC,GAAG,CAAC,qCAAqC,aAAa,CAAC,MAAM,iBAAiB,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,CACT,mBAAmB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,MAAM,EAAE,CAC5I,CAAC;QACF,OAAO,CAAC,GAAG,CACT,4BAA4B,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxF,CAAC;QAEF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,UAAsC,EACtC,UAA4B;QAE5B,6CAA6C;QAC7C,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEnF,oCAAoC;QACpC,mEAAmE;QACnE,IACE,UAAU,CAAC,UAAU,EAAE,QAAQ,KAAK,KAAK;YACzC,CAAC,OAAO,UAAU,CAAC,UAAU,EAAE,QAAQ,KAAK,QAAQ;gBAClD,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,KAAK,KAAK,CAAC,EACrD,CAAC;YACD,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACnD,IAAI,eAAe,IAAI,eAAe,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACvD,OAAO,CAAC,GAAG,CACT,iFAAiF,CAClF,CAAC;gBACF,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,eAAe,IAAI,eAAe,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAChE,OAAO,CAAC,GAAG,CACT,wFAAwF,CACzF,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACrE,CAAC;QAED,0BAA0B;QAC1B,IAAI,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACzD,IAAI,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;gBAClF,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACvD,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;gBAChF,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACvD,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;gBAChF,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,IAAI,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAClD,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;gBAC3E,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,QAAyB;QAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC5B,sBAAsB;YACtB,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YACpC,IAAI,SAAS,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YAEtC,oEAAoE;YACpE,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACvD,OAAO,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,SAAiB,EACjB,WAAmB,EACnB,UAA4B;QAE5B,6BAA6B;QAC7B,IAAI,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uBAAuB;QACvB,IAAI,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,qEAAqE;QACrE,IAAI,UAAU,CAAC,GAAG,EAAE,QAAQ,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAED,0BAA0B;QAC1B,MAAM,cAAc,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,wCAAwC;QAC/E,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,8CAA8C;IAE9C;;OAEG;IACH,aAAa,CAAC,MAA0B;QAQtC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAC1E,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QAC9E,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QAE7D,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC7B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAChC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YAC1B,WAAW,EAAE,QAAQ;SACtB,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,91 @@
1
+ import type { ComponentAPIData, EnrichedComponentInfo, TemplateConfig } from '@/types';
2
+ import type { RenderedSection } from './types';
3
+ export interface IndexPageData {
4
+ title: string;
5
+ description: string;
6
+ groupedComponents: Record<string, EnrichedComponentInfo[]>;
7
+ stats: {
8
+ totalComponents: number;
9
+ totalProps: number;
10
+ averageProps: number;
11
+ lastGenerated: string;
12
+ };
13
+ showTiers: boolean;
14
+ showStats: boolean;
15
+ }
16
+ export interface ComponentPageData {
17
+ component: EnrichedComponentInfo;
18
+ componentApiData: ComponentAPIData;
19
+ sections: RenderedSection[];
20
+ title: string;
21
+ description: string;
22
+ navigation: Array<{
23
+ id: string;
24
+ title: string;
25
+ order?: number;
26
+ }>;
27
+ scriptData?: ScriptData;
28
+ includeCustomDocs?: boolean;
29
+ }
30
+ export interface ScriptData {
31
+ variables: Record<string, any>;
32
+ functions: Record<string, string>;
33
+ imports: string[];
34
+ }
35
+ /**
36
+ * Template engine for generating Svelte documentation pages
37
+ * Creates templates that match the existing docs package structure
38
+ */
39
+ export declare class TemplateEngine {
40
+ private config;
41
+ constructor(config?: TemplateConfig);
42
+ /**
43
+ * Render the main index page with component overview
44
+ */
45
+ renderIndexPage(data: IndexPageData): string;
46
+ /**
47
+ * Render statistics section for index page
48
+ */
49
+ private renderStatsSection;
50
+ /**
51
+ * Render component group section
52
+ */
53
+ private renderComponentGroup;
54
+ /**
55
+ * Render individual component card
56
+ */
57
+ private renderComponentCard;
58
+ /**
59
+ * Render individual component documentation page
60
+ */
61
+ renderComponentPage(data: ComponentPageData): string;
62
+ /**
63
+ * Render component layout file
64
+ */
65
+ renderComponentLayout(component: EnrichedComponentInfo): string;
66
+ /**
67
+ * Generate breadcrumb navigation
68
+ */
69
+ renderBreadcrumbs(component: EnrichedComponentInfo): string;
70
+ /**
71
+ * Generate next/previous navigation
72
+ */
73
+ renderNextPrevNavigation(currentComponent: EnrichedComponentInfo, allComponents: EnrichedComponentInfo[]): string;
74
+ /**
75
+ * Generate custom imports from script data
76
+ */
77
+ private generateCustomImports;
78
+ /**
79
+ * Generate script variables from component page data
80
+ */
81
+ private generateScriptVariables;
82
+ /**
83
+ * Generate script functions from script data
84
+ */
85
+ private generateScriptFunctions;
86
+ /**
87
+ * Generate meta tags for SEO
88
+ */
89
+ generateMetaTags(title: string, description: string, component?: EnrichedComponentInfo): string;
90
+ }
91
+ //# sourceMappingURL=TemplateEngine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../../src/generators/svelte/TemplateEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC3D,KAAK,EAAE;QACN,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,qBAAqB,CAAC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,UAAU,CAAC,EAAE,UAAU,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,MAAM,WAAW,UAAU;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,CAAC,EAAE,cAAc;IAQnC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAqC5C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACA,OAAO,CAAC,mBAAmB;IAiD9B;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM;IAgIpD;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,qBAAqB,GAAG,MAAM;IAkB/D;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,qBAAqB,GAAG,MAAM;IAU3D;;OAEG;IACH,wBAAwB,CACvB,gBAAgB,EAAE,qBAAqB,EACvC,aAAa,EAAE,qBAAqB,EAAE,GACpC,MAAM;IAyCT;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkG7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6D/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,qBAAqB,GAAG,MAAM;CAoB/F"}