@sky.ui/mcp 0.0.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 (184) hide show
  1. package/LICENSE.md +139 -0
  2. package/README.md +182 -0
  3. package/data/chart-api-sections.json +4185 -0
  4. package/data/component-tier.json +25 -0
  5. package/data/design-guidelines/p0-guidelines.json +13381 -0
  6. package/data/reactivity-readme-snapshot.json +1 -0
  7. package/data/theme-authoring-contract.json +598 -0
  8. package/data/utils-suggestion-snapshot.json +1 -0
  9. package/dist/cache.d.ts +3 -0
  10. package/dist/cache.d.ts.map +1 -0
  11. package/dist/cache.js +15 -0
  12. package/dist/cache.js.map +1 -0
  13. package/dist/catalog.d.ts +60 -0
  14. package/dist/catalog.d.ts.map +1 -0
  15. package/dist/catalog.js +343 -0
  16. package/dist/catalog.js.map +1 -0
  17. package/dist/cem.d.ts +26 -0
  18. package/dist/cem.d.ts.map +1 -0
  19. package/dist/cem.js +348 -0
  20. package/dist/cem.js.map +1 -0
  21. package/dist/chart-usage-tool.d.ts +20 -0
  22. package/dist/chart-usage-tool.d.ts.map +1 -0
  23. package/dist/chart-usage-tool.js +153 -0
  24. package/dist/chart-usage-tool.js.map +1 -0
  25. package/dist/component-docs-tool.d.ts +45 -0
  26. package/dist/component-docs-tool.d.ts.map +1 -0
  27. package/dist/component-docs-tool.js +217 -0
  28. package/dist/component-docs-tool.js.map +1 -0
  29. package/dist/component-method-filter.d.ts +3 -0
  30. package/dist/component-method-filter.d.ts.map +1 -0
  31. package/dist/component-method-filter.js +32 -0
  32. package/dist/component-method-filter.js.map +1 -0
  33. package/dist/component-tier.d.ts +20 -0
  34. package/dist/component-tier.d.ts.map +1 -0
  35. package/dist/component-tier.js +59 -0
  36. package/dist/component-tier.js.map +1 -0
  37. package/dist/component-usage-tool.d.ts +20 -0
  38. package/dist/component-usage-tool.d.ts.map +1 -0
  39. package/dist/component-usage-tool.js +90 -0
  40. package/dist/component-usage-tool.js.map +1 -0
  41. package/dist/design-guidelines/a11y-engine.d.ts +22 -0
  42. package/dist/design-guidelines/a11y-engine.d.ts.map +1 -0
  43. package/dist/design-guidelines/a11y-engine.js +78 -0
  44. package/dist/design-guidelines/a11y-engine.js.map +1 -0
  45. package/dist/design-guidelines/compatibility-engine.d.ts +20 -0
  46. package/dist/design-guidelines/compatibility-engine.d.ts.map +1 -0
  47. package/dist/design-guidelines/compatibility-engine.js +57 -0
  48. package/dist/design-guidelines/compatibility-engine.js.map +1 -0
  49. package/dist/design-guidelines/component-guideline-engine.d.ts +19 -0
  50. package/dist/design-guidelines/component-guideline-engine.d.ts.map +1 -0
  51. package/dist/design-guidelines/component-guideline-engine.js +40 -0
  52. package/dist/design-guidelines/component-guideline-engine.js.map +1 -0
  53. package/dist/design-guidelines/composition-engine.d.ts +10 -0
  54. package/dist/design-guidelines/composition-engine.d.ts.map +1 -0
  55. package/dist/design-guidelines/composition-engine.js +29 -0
  56. package/dist/design-guidelines/composition-engine.js.map +1 -0
  57. package/dist/design-guidelines/pattern-engine.d.ts +20 -0
  58. package/dist/design-guidelines/pattern-engine.d.ts.map +1 -0
  59. package/dist/design-guidelines/pattern-engine.js +58 -0
  60. package/dist/design-guidelines/pattern-engine.js.map +1 -0
  61. package/dist/design-guidelines/recommendation-engine.d.ts +11 -0
  62. package/dist/design-guidelines/recommendation-engine.d.ts.map +1 -0
  63. package/dist/design-guidelines/recommendation-engine.js +88 -0
  64. package/dist/design-guidelines/recommendation-engine.js.map +1 -0
  65. package/dist/design-guidelines/repository.d.ts +19 -0
  66. package/dist/design-guidelines/repository.d.ts.map +1 -0
  67. package/dist/design-guidelines/repository.js +71 -0
  68. package/dist/design-guidelines/repository.js.map +1 -0
  69. package/dist/design-guidelines/review-engine.d.ts +20 -0
  70. package/dist/design-guidelines/review-engine.d.ts.map +1 -0
  71. package/dist/design-guidelines/review-engine.js +179 -0
  72. package/dist/design-guidelines/review-engine.js.map +1 -0
  73. package/dist/design-guidelines/schema.d.ts +256 -0
  74. package/dist/design-guidelines/schema.d.ts.map +1 -0
  75. package/dist/design-guidelines/schema.js +124 -0
  76. package/dist/design-guidelines/schema.js.map +1 -0
  77. package/dist/design-guidelines/token-engine.d.ts +23 -0
  78. package/dist/design-guidelines/token-engine.d.ts.map +1 -0
  79. package/dist/design-guidelines/token-engine.js +119 -0
  80. package/dist/design-guidelines/token-engine.js.map +1 -0
  81. package/dist/docs-read.d.ts +28 -0
  82. package/dist/docs-read.d.ts.map +1 -0
  83. package/dist/docs-read.js +102 -0
  84. package/dist/docs-read.js.map +1 -0
  85. package/dist/docs.d.ts +73 -0
  86. package/dist/docs.d.ts.map +1 -0
  87. package/dist/docs.js +323 -0
  88. package/dist/docs.js.map +1 -0
  89. package/dist/example-site-doc-enrichment.d.ts +27 -0
  90. package/dist/example-site-doc-enrichment.d.ts.map +1 -0
  91. package/dist/example-site-doc-enrichment.js +171 -0
  92. package/dist/example-site-doc-enrichment.js.map +1 -0
  93. package/dist/example-site-fetch.d.ts +44 -0
  94. package/dist/example-site-fetch.d.ts.map +1 -0
  95. package/dist/example-site-fetch.js +255 -0
  96. package/dist/example-site-fetch.js.map +1 -0
  97. package/dist/framework-wrappers.d.ts +46 -0
  98. package/dist/framework-wrappers.d.ts.map +1 -0
  99. package/dist/framework-wrappers.js +131 -0
  100. package/dist/framework-wrappers.js.map +1 -0
  101. package/dist/mcp-response-truth.d.ts +18 -0
  102. package/dist/mcp-response-truth.d.ts.map +1 -0
  103. package/dist/mcp-response-truth.js +45 -0
  104. package/dist/mcp-response-truth.js.map +1 -0
  105. package/dist/mcp-runtime-status.d.ts +37 -0
  106. package/dist/mcp-runtime-status.d.ts.map +1 -0
  107. package/dist/mcp-runtime-status.js +96 -0
  108. package/dist/mcp-runtime-status.js.map +1 -0
  109. package/dist/mcp-stdio-entry.d.ts +3 -0
  110. package/dist/mcp-stdio-entry.d.ts.map +1 -0
  111. package/dist/mcp-stdio-entry.js +35 -0
  112. package/dist/mcp-stdio-entry.js.map +1 -0
  113. package/dist/mcp-tool-errors.d.ts +35 -0
  114. package/dist/mcp-tool-errors.d.ts.map +1 -0
  115. package/dist/mcp-tool-errors.js +42 -0
  116. package/dist/mcp-tool-errors.js.map +1 -0
  117. package/dist/parse-component-ast.d.ts +112 -0
  118. package/dist/parse-component-ast.d.ts.map +1 -0
  119. package/dist/parse-component-ast.js +695 -0
  120. package/dist/parse-component-ast.js.map +1 -0
  121. package/dist/post-endpoint-server.d.ts +19 -0
  122. package/dist/post-endpoint-server.d.ts.map +1 -0
  123. package/dist/post-endpoint-server.js +777 -0
  124. package/dist/post-endpoint-server.js.map +1 -0
  125. package/dist/reactivity-info.d.ts +22 -0
  126. package/dist/reactivity-info.d.ts.map +1 -0
  127. package/dist/reactivity-info.js +99 -0
  128. package/dist/reactivity-info.js.map +1 -0
  129. package/dist/reactivity-layer-tool.d.ts +18 -0
  130. package/dist/reactivity-layer-tool.d.ts.map +1 -0
  131. package/dist/reactivity-layer-tool.js +58 -0
  132. package/dist/reactivity-layer-tool.js.map +1 -0
  133. package/dist/reactivity-readme-topics.d.ts +46 -0
  134. package/dist/reactivity-readme-topics.d.ts.map +1 -0
  135. package/dist/reactivity-readme-topics.js +206 -0
  136. package/dist/reactivity-readme-topics.js.map +1 -0
  137. package/dist/read-only-tool-allowlist.d.ts +7 -0
  138. package/dist/read-only-tool-allowlist.d.ts.map +1 -0
  139. package/dist/read-only-tool-allowlist.js +17 -0
  140. package/dist/read-only-tool-allowlist.js.map +1 -0
  141. package/dist/server.d.ts +7 -0
  142. package/dist/server.d.ts.map +1 -0
  143. package/dist/server.js +786 -0
  144. package/dist/server.js.map +1 -0
  145. package/dist/source-read.d.ts +31 -0
  146. package/dist/source-read.d.ts.map +1 -0
  147. package/dist/source-read.js +213 -0
  148. package/dist/source-read.js.map +1 -0
  149. package/dist/theme-authoring/contract-schema.d.ts +191 -0
  150. package/dist/theme-authoring/contract-schema.d.ts.map +1 -0
  151. package/dist/theme-authoring/contract-schema.js +49 -0
  152. package/dist/theme-authoring/contract-schema.js.map +1 -0
  153. package/dist/theme-authoring/repository.d.ts +18 -0
  154. package/dist/theme-authoring/repository.d.ts.map +1 -0
  155. package/dist/theme-authoring/repository.js +55 -0
  156. package/dist/theme-authoring/repository.js.map +1 -0
  157. package/dist/theme-tool.d.ts +26 -0
  158. package/dist/theme-tool.d.ts.map +1 -0
  159. package/dist/theme-tool.js +312 -0
  160. package/dist/theme-tool.js.map +1 -0
  161. package/dist/utils-guide-topics.d.ts +39 -0
  162. package/dist/utils-guide-topics.d.ts.map +1 -0
  163. package/dist/utils-guide-topics.js +202 -0
  164. package/dist/utils-guide-topics.js.map +1 -0
  165. package/dist/utils-info.d.ts +75 -0
  166. package/dist/utils-info.d.ts.map +1 -0
  167. package/dist/utils-info.js +219 -0
  168. package/dist/utils-info.js.map +1 -0
  169. package/dist/utils-suggestion-grounding.d.ts +59 -0
  170. package/dist/utils-suggestion-grounding.d.ts.map +1 -0
  171. package/dist/utils-suggestion-grounding.js +267 -0
  172. package/dist/utils-suggestion-grounding.js.map +1 -0
  173. package/docs/agent-recipe-example-site.md +91 -0
  174. package/docs/ai-design-mcp-blueprint.md +75 -0
  175. package/docs/cross-model-mcp-playbook.md +127 -0
  176. package/docs/example-site-and-mcp-training.md +82 -0
  177. package/docs/mcp-capability-status.md +51 -0
  178. package/docs/mcp-tooling-roadmap.md +36 -0
  179. package/docs/sky-chart-option-api.md +47 -0
  180. package/docs/starter-prompt.md +17 -0
  181. package/docs/theme-config-guide.md +178 -0
  182. package/docs/utils-usage-guide.md +110 -0
  183. package/docs/vue-wrapper-v-model.md +36 -0
  184. package/package.json +63 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import { type SkyComponentDocsOptions } from './docs.js';
2
+ import type { ComponentDocumentation } from './parse-component-ast.js';
3
+ export type EnrichedComponentDocsPayload = {
4
+ doc: ComponentDocumentation;
5
+ dataSource: 'cem' | 'ast';
6
+ truncatedExamples: boolean;
7
+ /** `pageAi` from `GET /api/mcp/component/{id}` when present */
8
+ exampleSitePageAi?: unknown;
9
+ /** Doc-page snippet sections (`sections[].frameworks`) from the example site */
10
+ exampleSiteSections?: unknown[];
11
+ exampleSiteSourceUrl?: string;
12
+ /** Set when `SKY_UI_EXAMPLE_SITE_BASE_URL` is invalid or the example request failed */
13
+ exampleSiteEnrichmentError?: string;
14
+ };
15
+ /**
16
+ * When `SKY_UI_EXAMPLE_SITE_BASE_URL` points at a sky-ui-example origin, fetches
17
+ * `/api/mcp/component/{slug}` and merges `pageAi.customEvents` / `pageAi.publicMethods`
18
+ * into a **clone** of the core doc (CEM/AST) so the cache is not mutated.
19
+ */
20
+ export declare function getSkyComponentDocsEnrichedFromExampleSite(nameInput: string, options?: SkyComponentDocsOptions): Promise<{
21
+ ok: true;
22
+ result: EnrichedComponentDocsPayload;
23
+ } | {
24
+ ok: false;
25
+ error: string;
26
+ }>;
27
+ //# sourceMappingURL=example-site-doc-enrichment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example-site-doc-enrichment.d.ts","sourceRoot":"","sources":["../src/example-site-doc-enrichment.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,MAAM,4BAA4B,GAAG;IACzC,GAAG,EAAE,sBAAsB,CAAC;IAC5B,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uFAAuF;IACvF,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAoGF;;;;GAIG;AACH,wBAAsB,0CAA0C,CAC9D,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA8E5F"}
@@ -0,0 +1,171 @@
1
+ import { fetchExampleSiteDocs, parseExampleSiteBaseUrl, resolveExampleSiteBaseUrl } from './example-site-fetch.js';
2
+ import { getSkyComponentDocs } from './docs.js';
3
+ function cloneDoc(doc) {
4
+ return structuredClone(doc);
5
+ }
6
+ function mergeDescriptions(cem, hint) {
7
+ const a = cem?.trim();
8
+ const b = hint?.trim();
9
+ if (a && b && a !== b)
10
+ return `${a} Example site: ${b}`;
11
+ return a ?? b;
12
+ }
13
+ function mergeEventTypes(cemType, detailShape) {
14
+ const t = cemType?.trim();
15
+ const d = detailShape?.trim();
16
+ if (t && d)
17
+ return `${t} (detail: ${d})`;
18
+ return t ?? d;
19
+ }
20
+ function mergeEventHints(events, hints) {
21
+ const out = events.map((e) => ({ ...e }));
22
+ for (const h of hints) {
23
+ const name = typeof h.name === 'string' ? h.name.trim() : '';
24
+ if (!name)
25
+ continue;
26
+ const desc = typeof h.description === 'string' ? h.description : undefined;
27
+ const detailShape = typeof h.detailShape === 'string' ? h.detailShape : undefined;
28
+ const idx = out.findIndex((e) => e.name === name);
29
+ if (idx >= 0) {
30
+ const cur = out[idx];
31
+ out[idx] = {
32
+ ...cur,
33
+ description: mergeDescriptions(cur.description, desc),
34
+ type: mergeEventTypes(cur.type, detailShape)
35
+ };
36
+ }
37
+ else {
38
+ out.push({
39
+ name,
40
+ type: detailShape?.trim(),
41
+ description: desc?.trim()
42
+ });
43
+ }
44
+ }
45
+ return out;
46
+ }
47
+ function mergeMethodHints(methods, hints) {
48
+ const out = methods.map((m) => ({
49
+ ...m,
50
+ params: m.params.map((p) => ({ ...p }))
51
+ }));
52
+ for (const h of hints) {
53
+ const methodName = typeof h.methodName === 'string' ? h.methodName.trim() : '';
54
+ if (!methodName)
55
+ continue;
56
+ const desc = typeof h.description === 'string' ? h.description : undefined;
57
+ const idx = out.findIndex((m) => m.name === methodName);
58
+ if (idx >= 0) {
59
+ const cur = out[idx];
60
+ out[idx] = {
61
+ ...cur,
62
+ description: mergeDescriptions(cur.description, desc)
63
+ };
64
+ }
65
+ else {
66
+ out.push({
67
+ name: methodName,
68
+ description: desc?.trim(),
69
+ params: []
70
+ });
71
+ }
72
+ }
73
+ return out;
74
+ }
75
+ function mergePageAiIntoDoc(doc, payload) {
76
+ const pageAi = payload.pageAi;
77
+ if (!pageAi || typeof pageAi !== 'object') {
78
+ return cloneDoc(doc);
79
+ }
80
+ const pa = pageAi;
81
+ const customEvents = pa.customEvents;
82
+ const publicMethods = pa.publicMethods;
83
+ const next = cloneDoc(doc);
84
+ if (Array.isArray(customEvents)) {
85
+ next.events = mergeEventHints(next.events, customEvents);
86
+ }
87
+ if (Array.isArray(publicMethods)) {
88
+ next.methods = mergeMethodHints(next.methods, publicMethods);
89
+ }
90
+ return next;
91
+ }
92
+ /**
93
+ * When `SKY_UI_EXAMPLE_SITE_BASE_URL` points at a sky-ui-example origin, fetches
94
+ * `/api/mcp/component/{slug}` and merges `pageAi.customEvents` / `pageAi.publicMethods`
95
+ * into a **clone** of the core doc (CEM/AST) so the cache is not mutated.
96
+ */
97
+ export async function getSkyComponentDocsEnrichedFromExampleSite(nameInput, options) {
98
+ const r = getSkyComponentDocs(nameInput, options);
99
+ if (!r.ok)
100
+ return r;
101
+ const baseRaw = resolveExampleSiteBaseUrl();
102
+ if (!baseRaw) {
103
+ return {
104
+ ok: true,
105
+ result: {
106
+ doc: r.result.doc,
107
+ dataSource: r.result.dataSource,
108
+ truncatedExamples: r.result.truncatedExamples
109
+ }
110
+ };
111
+ }
112
+ const parsed = parseExampleSiteBaseUrl(baseRaw);
113
+ if (!parsed.ok) {
114
+ return {
115
+ ok: true,
116
+ result: {
117
+ doc: r.result.doc,
118
+ dataSource: r.result.dataSource,
119
+ truncatedExamples: r.result.truncatedExamples,
120
+ exampleSiteEnrichmentError: parsed.error
121
+ }
122
+ };
123
+ }
124
+ const slug = r.result.doc.name.replace(/^sky-/, '');
125
+ const fetched = await fetchExampleSiteDocs({
126
+ resource: 'component',
127
+ component: slug,
128
+ format: 'json'
129
+ });
130
+ if (!fetched.ok) {
131
+ const noExamplePage = fetched.httpStatus === 404;
132
+ return {
133
+ ok: true,
134
+ result: {
135
+ doc: r.result.doc,
136
+ dataSource: r.result.dataSource,
137
+ truncatedExamples: r.result.truncatedExamples,
138
+ ...(!noExamplePage ? { exampleSiteEnrichmentError: fetched.error } : {})
139
+ }
140
+ };
141
+ }
142
+ let payload;
143
+ try {
144
+ payload = JSON.parse(fetched.body);
145
+ }
146
+ catch {
147
+ return {
148
+ ok: true,
149
+ result: {
150
+ doc: r.result.doc,
151
+ dataSource: r.result.dataSource,
152
+ truncatedExamples: r.result.truncatedExamples,
153
+ exampleSiteEnrichmentError: 'Example site response was not valid JSON'
154
+ }
155
+ };
156
+ }
157
+ const mergedDoc = mergePageAiIntoDoc(r.result.doc, payload);
158
+ const sections = payload.sections;
159
+ return {
160
+ ok: true,
161
+ result: {
162
+ doc: mergedDoc,
163
+ dataSource: r.result.dataSource,
164
+ truncatedExamples: r.result.truncatedExamples,
165
+ exampleSitePageAi: typeof payload.pageAi === 'object' ? payload.pageAi : undefined,
166
+ ...(Array.isArray(sections) ? { exampleSiteSections: sections } : {}),
167
+ exampleSiteSourceUrl: fetched.url
168
+ }
169
+ };
170
+ }
171
+ //# sourceMappingURL=example-site-doc-enrichment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example-site-doc-enrichment.js","sourceRoot":"","sources":["../src/example-site-doc-enrichment.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ /** Origin only, e.g. `https://library.sky-ui.com` (no path). */
2
+ export declare const SKY_UI_EXAMPLE_SITE_BASE_URL_ENV = "SKY_UI_EXAMPLE_SITE_BASE_URL";
3
+ /** Set to `1` to skip live example-site fetches (offline / air-gapped). */
4
+ export declare const SKY_UI_EXAMPLE_SITE_DISABLE_ENV = "SKY_UI_EXAMPLE_SITE_DISABLE";
5
+ /** Comma-separated extra hostnames allowed after redirects (lowercase), e.g. `cdn.example.com`. */
6
+ export declare const SKY_UI_EXAMPLE_SITE_EXTRA_HOSTS_ENV = "SKY_UI_EXAMPLE_SITE_EXTRA_HOSTS";
7
+ /** HeroUI-style default: published docs site (override with env or disable flag). */
8
+ export declare const DEFAULT_SKY_UI_EXAMPLE_SITE_BASE_URL = "https://library.sky-ui.com";
9
+ /** Effective origin for example-site enrichment (env → default → null when disabled). */
10
+ export declare function resolveExampleSiteBaseUrl(): string | null;
11
+ /** Synthetic origin reported when serving payloads from `p0-guidelines.json` → `exampleSiteEmbed`. */
12
+ export declare const EMBEDDED_EXAMPLE_SITE_ORIGIN = "sky-ui://embedded-example-site";
13
+ type ParsedBase = {
14
+ ok: true;
15
+ origin: string;
16
+ hostname: string;
17
+ } | {
18
+ ok: false;
19
+ error: string;
20
+ };
21
+ export declare function parseExampleSiteBaseUrl(raw: string): ParsedBase;
22
+ export declare function collectAllowedHosts(baseHostname: string, extraHostsCsv?: string): Set<string>;
23
+ export declare function buildExampleSiteRequestUrl(origin: string, resource: 'manifest' | 'component', component?: string, format?: 'json' | 'markdown'): URL;
24
+ export type FetchExampleSiteArgs = {
25
+ resource: 'manifest' | 'component';
26
+ component?: string;
27
+ format?: 'json' | 'markdown';
28
+ };
29
+ type FetchOk = {
30
+ ok: true;
31
+ url: string;
32
+ mimeType: string;
33
+ truncated: boolean;
34
+ body: string;
35
+ };
36
+ type FetchErr = {
37
+ ok: false;
38
+ error: string;
39
+ hint?: string; /** Set for failed HTTP responses from the example origin */
40
+ httpStatus?: number;
41
+ };
42
+ export declare function fetchExampleSiteDocs(options: FetchExampleSiteArgs): Promise<FetchOk | FetchErr>;
43
+ export {};
44
+ //# sourceMappingURL=example-site-fetch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example-site-fetch.d.ts","sourceRoot":"","sources":["../src/example-site-fetch.ts"],"names":[],"mappings":"AAGA,gEAAgE;AAChE,eAAO,MAAM,gCAAgC,iCAAiC,CAAC;AAE/E,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAE7E,mGAAmG;AACnG,eAAO,MAAM,mCAAmC,oCAAoC,CAAC;AAErF,qFAAqF;AACrF,eAAO,MAAM,oCAAoC,+BAA+B,CAAC;AAEjF,yFAAyF;AACzF,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAKzD;AAKD,sGAAsG;AACtG,eAAO,MAAM,4BAA4B,mCAAmC,CAAC;AAE7E,KAAK,UAAU,GACX;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA8B/D;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAS7F;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,UAAU,GAAG,WAAW,EAClC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAC3B,GAAG,CAUL;AAMD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,UAAU,GAAG,WAAW,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC9B,CAAC;AAEF,KAAK,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7F,KAAK,QAAQ,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,4DAA4D;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAkM9I,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,CAsBrG"}
@@ -0,0 +1,255 @@
1
+ import { loadDesignGuidelines } from './design-guidelines/repository.js';
2
+ /** Origin only, e.g. `https://library.sky-ui.com` (no path). */
3
+ export const SKY_UI_EXAMPLE_SITE_BASE_URL_ENV = 'SKY_UI_EXAMPLE_SITE_BASE_URL';
4
+ /** Set to `1` to skip live example-site fetches (offline / air-gapped). */
5
+ export const SKY_UI_EXAMPLE_SITE_DISABLE_ENV = 'SKY_UI_EXAMPLE_SITE_DISABLE';
6
+ /** Comma-separated extra hostnames allowed after redirects (lowercase), e.g. `cdn.example.com`. */
7
+ export const SKY_UI_EXAMPLE_SITE_EXTRA_HOSTS_ENV = 'SKY_UI_EXAMPLE_SITE_EXTRA_HOSTS';
8
+ /** HeroUI-style default: published docs site (override with env or disable flag). */
9
+ export const DEFAULT_SKY_UI_EXAMPLE_SITE_BASE_URL = 'https://library.sky-ui.com';
10
+ /** Effective origin for example-site enrichment (env → default → null when disabled). */
11
+ export function resolveExampleSiteBaseUrl() {
12
+ if (process.env[SKY_UI_EXAMPLE_SITE_DISABLE_ENV]?.trim() === '1')
13
+ return null;
14
+ const raw = process.env[SKY_UI_EXAMPLE_SITE_BASE_URL_ENV]?.trim();
15
+ if (raw)
16
+ return raw;
17
+ return DEFAULT_SKY_UI_EXAMPLE_SITE_BASE_URL;
18
+ }
19
+ const MAX_BYTES = 600_000;
20
+ const TIMEOUT_MS = 25_000;
21
+ /** Synthetic origin reported when serving payloads from `p0-guidelines.json` → `exampleSiteEmbed`. */
22
+ export const EMBEDDED_EXAMPLE_SITE_ORIGIN = 'sky-ui://embedded-example-site';
23
+ export function parseExampleSiteBaseUrl(raw) {
24
+ let u;
25
+ try {
26
+ u = new URL(raw.trim());
27
+ }
28
+ catch {
29
+ return { ok: false, error: `Invalid ${SKY_UI_EXAMPLE_SITE_BASE_URL_ENV}` };
30
+ }
31
+ if (u.hash || u.search) {
32
+ return { ok: false, error: 'Base URL must not include query or hash' };
33
+ }
34
+ if (u.pathname !== '/' && u.pathname !== '') {
35
+ return {
36
+ ok: false,
37
+ error: 'Base URL must be an origin only (no path), e.g. https://docs.example.com'
38
+ };
39
+ }
40
+ const host = u.hostname.toLowerCase();
41
+ const protocol = u.protocol;
42
+ if (protocol !== 'https:' &&
43
+ !(protocol === 'http:' && (host === 'localhost' || host === '127.0.0.1'))) {
44
+ return {
45
+ ok: false,
46
+ error: 'Only https origins are allowed, except http://localhost or http://127.0.0.1 for local dev'
47
+ };
48
+ }
49
+ const origin = `${u.protocol}//${u.host}`;
50
+ return { ok: true, origin, hostname: host };
51
+ }
52
+ export function collectAllowedHosts(baseHostname, extraHostsCsv) {
53
+ const hosts = new Set([baseHostname.toLowerCase()]);
54
+ if (extraHostsCsv?.trim()) {
55
+ for (const part of extraHostsCsv.split(',')) {
56
+ const h = part.trim().toLowerCase();
57
+ if (h)
58
+ hosts.add(h);
59
+ }
60
+ }
61
+ return hosts;
62
+ }
63
+ export function buildExampleSiteRequestUrl(origin, resource, component, format) {
64
+ const path = resource === 'manifest'
65
+ ? '/api/mcp/manifest'
66
+ : `/api/mcp/component/${encodeURIComponent(component)}`;
67
+ const u = new URL(path, origin.endsWith('/') ? origin : `${origin}/`);
68
+ if (resource === 'component' && format === 'markdown') {
69
+ u.searchParams.set('format', 'markdown');
70
+ }
71
+ return u;
72
+ }
73
+ function hostAllowed(hostname, hosts) {
74
+ return hosts.has(hostname.toLowerCase());
75
+ }
76
+ function embedHasPayload(embed) {
77
+ if (embed.manifest !== undefined)
78
+ return true;
79
+ const keys = embed.components ? Object.keys(embed.components) : [];
80
+ return keys.length > 0;
81
+ }
82
+ function synthesizeManifest(embed) {
83
+ const ids = embed.components ? Object.keys(embed.components).sort() : [];
84
+ return {
85
+ schema: 'sky-ui-example-mcp/manifest/1',
86
+ siteUrl: EMBEDDED_EXAMPLE_SITE_ORIGIN,
87
+ endpoints: {
88
+ manifestPath: '(embedded: p0-guidelines.json → exampleSiteEmbed.manifest)',
89
+ componentPathPattern: '(embedded: p0-guidelines.json → exampleSiteEmbed.components[id])'
90
+ },
91
+ components: ids.map((id) => ({
92
+ id,
93
+ pageTitle: id,
94
+ pageDescription: '',
95
+ docPath: ''
96
+ }))
97
+ };
98
+ }
99
+ function resolveFromGuidelinesEmbed(embed, options) {
100
+ if (options.resource === 'manifest') {
101
+ const manifest = embed.manifest !== undefined ? embed.manifest : synthesizeManifest(embed);
102
+ const body = JSON.stringify(manifest);
103
+ if (body.length > MAX_BYTES) {
104
+ return { ok: false, error: `Embedded manifest exceeds ${MAX_BYTES} bytes` };
105
+ }
106
+ return {
107
+ ok: true,
108
+ url: `${EMBEDDED_EXAMPLE_SITE_ORIGIN}/api/mcp/manifest`,
109
+ mimeType: 'application/json',
110
+ truncated: false,
111
+ body
112
+ };
113
+ }
114
+ const id = options.component?.trim();
115
+ if (!id || !/^[a-z0-9][a-z0-9-]{0,63}$/.test(id)) {
116
+ return {
117
+ ok: false,
118
+ error: 'component is required for resource=component (kebab-case slug, e.g. accordion)',
119
+ hint: 'Call resource manifest first to list ids.'
120
+ };
121
+ }
122
+ const payload = embed.components?.[id];
123
+ if (payload === undefined) {
124
+ return {
125
+ ok: false,
126
+ error: `No embedded example payload for component "${id}"`,
127
+ hint: 'Add it under exampleSiteEmbed.components in design-guidelines/p0-guidelines.json, or set SKY_UI_EXAMPLE_SITE_BASE_URL.'
128
+ };
129
+ }
130
+ const body = JSON.stringify(payload);
131
+ if (body.length > MAX_BYTES) {
132
+ return { ok: false, error: `Embedded component payload exceeds ${MAX_BYTES} bytes` };
133
+ }
134
+ const fmt = options.format ?? 'json';
135
+ if (fmt === 'markdown') {
136
+ return {
137
+ ok: true,
138
+ url: `${EMBEDDED_EXAMPLE_SITE_ORIGIN}/api/mcp/component/${encodeURIComponent(id)}?format=markdown`,
139
+ mimeType: 'text/markdown',
140
+ truncated: false,
141
+ body: [
142
+ 'Embedded `exampleSiteEmbed` only stores JSON; markdown was requested.',
143
+ '',
144
+ '```json',
145
+ JSON.stringify(payload, null, 2),
146
+ '```'
147
+ ].join('\n')
148
+ };
149
+ }
150
+ return {
151
+ ok: true,
152
+ url: `${EMBEDDED_EXAMPLE_SITE_ORIGIN}/api/mcp/component/${encodeURIComponent(id)}`,
153
+ mimeType: 'application/json',
154
+ truncated: false,
155
+ body
156
+ };
157
+ }
158
+ function tryGuidelinesEmbed(options) {
159
+ const loaded = loadDesignGuidelines();
160
+ if (!loaded.ok)
161
+ return null;
162
+ const embed = loaded.data.raw.exampleSiteEmbed;
163
+ if (!embed || !embedHasPayload(embed))
164
+ return null;
165
+ return resolveFromGuidelinesEmbed(embed, options);
166
+ }
167
+ async function fetchExampleSiteDocsViaHttp(parsed, extraHostsCsv, options) {
168
+ const hosts = collectAllowedHosts(parsed.hostname, extraHostsCsv);
169
+ const fmt = options.resource === 'component' ? (options.format ?? 'json') : 'json';
170
+ if (options.resource === 'component') {
171
+ const id = options.component?.trim();
172
+ if (!id || !/^[a-z0-9][a-z0-9-]{0,63}$/.test(id)) {
173
+ return {
174
+ ok: false,
175
+ error: 'component is required for resource=component (kebab-case slug, e.g. accordion)',
176
+ hint: 'Call resource manifest first to list ids.'
177
+ };
178
+ }
179
+ }
180
+ const url = buildExampleSiteRequestUrl(parsed.origin, options.resource, options.component, fmt === 'markdown' ? 'markdown' : 'json');
181
+ if (!url.pathname.startsWith('/api/mcp/')) {
182
+ return { ok: false, error: 'Internal URL build error (path guard)' };
183
+ }
184
+ const controller = new AbortController();
185
+ const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
186
+ try {
187
+ const res = await fetch(url, {
188
+ method: 'GET',
189
+ redirect: 'follow',
190
+ signal: controller.signal,
191
+ headers: {
192
+ Accept: '*/*',
193
+ 'User-Agent': 'sky-ui-mcp/example-site-enrichment'
194
+ }
195
+ });
196
+ clearTimeout(timer);
197
+ const finalUrl = new URL(res.url);
198
+ if (!hostAllowed(finalUrl.hostname, hosts)) {
199
+ return { ok: false, error: `Response URL host not allowlisted: ${finalUrl.hostname}` };
200
+ }
201
+ if (!finalUrl.pathname.startsWith('/api/mcp/')) {
202
+ return { ok: false, error: 'Redirect led to a disallowed path (must stay under /api/mcp/)' };
203
+ }
204
+ const lenHeader = res.headers.get('content-length');
205
+ if (lenHeader) {
206
+ const n = Number(lenHeader);
207
+ if (Number.isFinite(n) && n > MAX_BYTES) {
208
+ return { ok: false, error: `Response too large (${n} bytes); max ${MAX_BYTES}` };
209
+ }
210
+ }
211
+ const buf = await res.arrayBuffer();
212
+ if (buf.byteLength > MAX_BYTES) {
213
+ return { ok: false, error: `Response body exceeds ${MAX_BYTES} bytes` };
214
+ }
215
+ const body = new TextDecoder('utf8', { fatal: false }).decode(buf);
216
+ if (!res.ok) {
217
+ return {
218
+ ok: false,
219
+ error: `HTTP ${res.status} ${res.statusText}: ${body.slice(0, 600)}`,
220
+ httpStatus: res.status
221
+ };
222
+ }
223
+ const mime = res.headers.get('content-type')?.split(';')[0]?.trim() ?? 'application/octet-stream';
224
+ return { ok: true, url: res.url, mimeType: mime, truncated: false, body };
225
+ }
226
+ catch (e) {
227
+ clearTimeout(timer);
228
+ const msg = e instanceof Error ? e.message : String(e);
229
+ if (msg.includes('abort') || msg.includes('Aborted')) {
230
+ return { ok: false, error: `Fetch timed out after ${TIMEOUT_MS}ms` };
231
+ }
232
+ return { ok: false, error: msg };
233
+ }
234
+ }
235
+ export async function fetchExampleSiteDocs(options) {
236
+ const baseRaw = resolveExampleSiteBaseUrl();
237
+ const extraRaw = process.env[SKY_UI_EXAMPLE_SITE_EXTRA_HOSTS_ENV];
238
+ if (baseRaw) {
239
+ const parsed = parseExampleSiteBaseUrl(baseRaw);
240
+ if (!parsed.ok) {
241
+ return { ok: false, error: parsed.error };
242
+ }
243
+ return fetchExampleSiteDocsViaHttp(parsed, extraRaw, options);
244
+ }
245
+ const embedded = tryGuidelinesEmbed(options);
246
+ if (embedded) {
247
+ return embedded;
248
+ }
249
+ return {
250
+ ok: false,
251
+ error: `Missing ${SKY_UI_EXAMPLE_SITE_BASE_URL_ENV} and no usable exampleSiteEmbed in design guidelines`,
252
+ hint: `Set ${SKY_UI_EXAMPLE_SITE_BASE_URL_ENV} (defaults to ${DEFAULT_SKY_UI_EXAMPLE_SITE_BASE_URL}), add exampleSiteEmbed to p0-guidelines.json, or set ${SKY_UI_EXAMPLE_SITE_DISABLE_ENV}=1 for offline-only.`
253
+ };
254
+ }
255
+ //# sourceMappingURL=example-site-fetch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example-site-fetch.js","sourceRoot":"","sources":["../src/example-site-fetch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,46 @@
1
+ /** How imports are organized in app code (matches README patterns). */
2
+ export type WrapperImportStyle = 'per_component' | 'barrel' | 'auto_import_note';
3
+ export declare function kebabTagToPascal(tag: string): string;
4
+ export type FrameworkWrapperDetails = {
5
+ framework: 'react' | 'vue';
6
+ componentKebab: string;
7
+ /** Wrapper export / JSX tag name, e.g. SkyButton */
8
+ pascalName: string;
9
+ /** Single recommended import line for copy-paste */
10
+ primaryImportLine: string;
11
+ /** Subpath import @sky.ui/react/sky-button */
12
+ importPerComponent: string;
13
+ /** Barrel: everything from package root */
14
+ importBarrel: string;
15
+ /** Also valid in Vue templates (native tag form) */
16
+ vueKebabTagInTemplate: string;
17
+ snippets: {
18
+ reactPerComponent: string;
19
+ reactBarrel: string;
20
+ reactAutoImportNote: string;
21
+ vuePerComponent: string;
22
+ vueBarrel: string;
23
+ vueAutoImportNote: string;
24
+ vueTemplateKebab: string;
25
+ };
26
+ conventions: string[];
27
+ relatedMcpTools: string[];
28
+ packageVersion: string | null;
29
+ peerDependencies: Record<string, string>;
30
+ };
31
+ export declare function buildFrameworkWrapperDetails(framework: 'react' | 'vue', nameInput: string): {
32
+ ok: true;
33
+ details: FrameworkWrapperDetails;
34
+ } | {
35
+ ok: false;
36
+ error: string;
37
+ };
38
+ export declare function buildUsageSnippetForFramework(framework: 'react' | 'vue', componentInput: string, style: WrapperImportStyle): {
39
+ ok: true;
40
+ snippet: string;
41
+ componentName: string;
42
+ } | {
43
+ ok: false;
44
+ error: string;
45
+ };
46
+ //# sourceMappingURL=framework-wrappers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"framework-wrappers.d.ts","sourceRoot":"","sources":["../src/framework-wrappers.ts"],"names":[],"mappings":"AAOA,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAEjF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,OAAO,GAAG,KAAK,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE;QACR,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAiEF,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,OAAO,GAAG,KAAK,EAC1B,SAAS,EAAE,MAAM,GAChB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyD/E;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,OAAO,GAAG,KAAK,EAC1B,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,kBAAkB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAYrF"}