@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.
- package/LICENSE.md +139 -0
- package/README.md +182 -0
- package/data/chart-api-sections.json +4185 -0
- package/data/component-tier.json +25 -0
- package/data/design-guidelines/p0-guidelines.json +13381 -0
- package/data/reactivity-readme-snapshot.json +1 -0
- package/data/theme-authoring-contract.json +598 -0
- package/data/utils-suggestion-snapshot.json +1 -0
- package/dist/cache.d.ts +3 -0
- package/dist/cache.d.ts.map +1 -0
- package/dist/cache.js +15 -0
- package/dist/cache.js.map +1 -0
- package/dist/catalog.d.ts +60 -0
- package/dist/catalog.d.ts.map +1 -0
- package/dist/catalog.js +343 -0
- package/dist/catalog.js.map +1 -0
- package/dist/cem.d.ts +26 -0
- package/dist/cem.d.ts.map +1 -0
- package/dist/cem.js +348 -0
- package/dist/cem.js.map +1 -0
- package/dist/chart-usage-tool.d.ts +20 -0
- package/dist/chart-usage-tool.d.ts.map +1 -0
- package/dist/chart-usage-tool.js +153 -0
- package/dist/chart-usage-tool.js.map +1 -0
- package/dist/component-docs-tool.d.ts +45 -0
- package/dist/component-docs-tool.d.ts.map +1 -0
- package/dist/component-docs-tool.js +217 -0
- package/dist/component-docs-tool.js.map +1 -0
- package/dist/component-method-filter.d.ts +3 -0
- package/dist/component-method-filter.d.ts.map +1 -0
- package/dist/component-method-filter.js +32 -0
- package/dist/component-method-filter.js.map +1 -0
- package/dist/component-tier.d.ts +20 -0
- package/dist/component-tier.d.ts.map +1 -0
- package/dist/component-tier.js +59 -0
- package/dist/component-tier.js.map +1 -0
- package/dist/component-usage-tool.d.ts +20 -0
- package/dist/component-usage-tool.d.ts.map +1 -0
- package/dist/component-usage-tool.js +90 -0
- package/dist/component-usage-tool.js.map +1 -0
- package/dist/design-guidelines/a11y-engine.d.ts +22 -0
- package/dist/design-guidelines/a11y-engine.d.ts.map +1 -0
- package/dist/design-guidelines/a11y-engine.js +78 -0
- package/dist/design-guidelines/a11y-engine.js.map +1 -0
- package/dist/design-guidelines/compatibility-engine.d.ts +20 -0
- package/dist/design-guidelines/compatibility-engine.d.ts.map +1 -0
- package/dist/design-guidelines/compatibility-engine.js +57 -0
- package/dist/design-guidelines/compatibility-engine.js.map +1 -0
- package/dist/design-guidelines/component-guideline-engine.d.ts +19 -0
- package/dist/design-guidelines/component-guideline-engine.d.ts.map +1 -0
- package/dist/design-guidelines/component-guideline-engine.js +40 -0
- package/dist/design-guidelines/component-guideline-engine.js.map +1 -0
- package/dist/design-guidelines/composition-engine.d.ts +10 -0
- package/dist/design-guidelines/composition-engine.d.ts.map +1 -0
- package/dist/design-guidelines/composition-engine.js +29 -0
- package/dist/design-guidelines/composition-engine.js.map +1 -0
- package/dist/design-guidelines/pattern-engine.d.ts +20 -0
- package/dist/design-guidelines/pattern-engine.d.ts.map +1 -0
- package/dist/design-guidelines/pattern-engine.js +58 -0
- package/dist/design-guidelines/pattern-engine.js.map +1 -0
- package/dist/design-guidelines/recommendation-engine.d.ts +11 -0
- package/dist/design-guidelines/recommendation-engine.d.ts.map +1 -0
- package/dist/design-guidelines/recommendation-engine.js +88 -0
- package/dist/design-guidelines/recommendation-engine.js.map +1 -0
- package/dist/design-guidelines/repository.d.ts +19 -0
- package/dist/design-guidelines/repository.d.ts.map +1 -0
- package/dist/design-guidelines/repository.js +71 -0
- package/dist/design-guidelines/repository.js.map +1 -0
- package/dist/design-guidelines/review-engine.d.ts +20 -0
- package/dist/design-guidelines/review-engine.d.ts.map +1 -0
- package/dist/design-guidelines/review-engine.js +179 -0
- package/dist/design-guidelines/review-engine.js.map +1 -0
- package/dist/design-guidelines/schema.d.ts +256 -0
- package/dist/design-guidelines/schema.d.ts.map +1 -0
- package/dist/design-guidelines/schema.js +124 -0
- package/dist/design-guidelines/schema.js.map +1 -0
- package/dist/design-guidelines/token-engine.d.ts +23 -0
- package/dist/design-guidelines/token-engine.d.ts.map +1 -0
- package/dist/design-guidelines/token-engine.js +119 -0
- package/dist/design-guidelines/token-engine.js.map +1 -0
- package/dist/docs-read.d.ts +28 -0
- package/dist/docs-read.d.ts.map +1 -0
- package/dist/docs-read.js +102 -0
- package/dist/docs-read.js.map +1 -0
- package/dist/docs.d.ts +73 -0
- package/dist/docs.d.ts.map +1 -0
- package/dist/docs.js +323 -0
- package/dist/docs.js.map +1 -0
- package/dist/example-site-doc-enrichment.d.ts +27 -0
- package/dist/example-site-doc-enrichment.d.ts.map +1 -0
- package/dist/example-site-doc-enrichment.js +171 -0
- package/dist/example-site-doc-enrichment.js.map +1 -0
- package/dist/example-site-fetch.d.ts +44 -0
- package/dist/example-site-fetch.d.ts.map +1 -0
- package/dist/example-site-fetch.js +255 -0
- package/dist/example-site-fetch.js.map +1 -0
- package/dist/framework-wrappers.d.ts +46 -0
- package/dist/framework-wrappers.d.ts.map +1 -0
- package/dist/framework-wrappers.js +131 -0
- package/dist/framework-wrappers.js.map +1 -0
- package/dist/mcp-response-truth.d.ts +18 -0
- package/dist/mcp-response-truth.d.ts.map +1 -0
- package/dist/mcp-response-truth.js +45 -0
- package/dist/mcp-response-truth.js.map +1 -0
- package/dist/mcp-runtime-status.d.ts +37 -0
- package/dist/mcp-runtime-status.d.ts.map +1 -0
- package/dist/mcp-runtime-status.js +96 -0
- package/dist/mcp-runtime-status.js.map +1 -0
- package/dist/mcp-stdio-entry.d.ts +3 -0
- package/dist/mcp-stdio-entry.d.ts.map +1 -0
- package/dist/mcp-stdio-entry.js +35 -0
- package/dist/mcp-stdio-entry.js.map +1 -0
- package/dist/mcp-tool-errors.d.ts +35 -0
- package/dist/mcp-tool-errors.d.ts.map +1 -0
- package/dist/mcp-tool-errors.js +42 -0
- package/dist/mcp-tool-errors.js.map +1 -0
- package/dist/parse-component-ast.d.ts +112 -0
- package/dist/parse-component-ast.d.ts.map +1 -0
- package/dist/parse-component-ast.js +695 -0
- package/dist/parse-component-ast.js.map +1 -0
- package/dist/post-endpoint-server.d.ts +19 -0
- package/dist/post-endpoint-server.d.ts.map +1 -0
- package/dist/post-endpoint-server.js +777 -0
- package/dist/post-endpoint-server.js.map +1 -0
- package/dist/reactivity-info.d.ts +22 -0
- package/dist/reactivity-info.d.ts.map +1 -0
- package/dist/reactivity-info.js +99 -0
- package/dist/reactivity-info.js.map +1 -0
- package/dist/reactivity-layer-tool.d.ts +18 -0
- package/dist/reactivity-layer-tool.d.ts.map +1 -0
- package/dist/reactivity-layer-tool.js +58 -0
- package/dist/reactivity-layer-tool.js.map +1 -0
- package/dist/reactivity-readme-topics.d.ts +46 -0
- package/dist/reactivity-readme-topics.d.ts.map +1 -0
- package/dist/reactivity-readme-topics.js +206 -0
- package/dist/reactivity-readme-topics.js.map +1 -0
- package/dist/read-only-tool-allowlist.d.ts +7 -0
- package/dist/read-only-tool-allowlist.d.ts.map +1 -0
- package/dist/read-only-tool-allowlist.js +17 -0
- package/dist/read-only-tool-allowlist.js.map +1 -0
- package/dist/server.d.ts +7 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +786 -0
- package/dist/server.js.map +1 -0
- package/dist/source-read.d.ts +31 -0
- package/dist/source-read.d.ts.map +1 -0
- package/dist/source-read.js +213 -0
- package/dist/source-read.js.map +1 -0
- package/dist/theme-authoring/contract-schema.d.ts +191 -0
- package/dist/theme-authoring/contract-schema.d.ts.map +1 -0
- package/dist/theme-authoring/contract-schema.js +49 -0
- package/dist/theme-authoring/contract-schema.js.map +1 -0
- package/dist/theme-authoring/repository.d.ts +18 -0
- package/dist/theme-authoring/repository.d.ts.map +1 -0
- package/dist/theme-authoring/repository.js +55 -0
- package/dist/theme-authoring/repository.js.map +1 -0
- package/dist/theme-tool.d.ts +26 -0
- package/dist/theme-tool.d.ts.map +1 -0
- package/dist/theme-tool.js +312 -0
- package/dist/theme-tool.js.map +1 -0
- package/dist/utils-guide-topics.d.ts +39 -0
- package/dist/utils-guide-topics.d.ts.map +1 -0
- package/dist/utils-guide-topics.js +202 -0
- package/dist/utils-guide-topics.js.map +1 -0
- package/dist/utils-info.d.ts +75 -0
- package/dist/utils-info.d.ts.map +1 -0
- package/dist/utils-info.js +219 -0
- package/dist/utils-info.js.map +1 -0
- package/dist/utils-suggestion-grounding.d.ts +59 -0
- package/dist/utils-suggestion-grounding.d.ts.map +1 -0
- package/dist/utils-suggestion-grounding.js +267 -0
- package/dist/utils-suggestion-grounding.js.map +1 -0
- package/docs/agent-recipe-example-site.md +91 -0
- package/docs/ai-design-mcp-blueprint.md +75 -0
- package/docs/cross-model-mcp-playbook.md +127 -0
- package/docs/example-site-and-mcp-training.md +82 -0
- package/docs/mcp-capability-status.md +51 -0
- package/docs/mcp-tooling-roadmap.md +36 -0
- package/docs/sky-chart-option-api.md +47 -0
- package/docs/starter-prompt.md +17 -0
- package/docs/theme-config-guide.md +178 -0
- package/docs/utils-usage-guide.md +110 -0
- package/docs/vue-wrapper-v-model.md +36 -0
- package/package.json +63 -0
package/dist/docs.js.map
ADDED
|
@@ -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"}
|