@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
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { loadDesignGuidelines } from './repository.js';
|
|
2
|
+
function normalize(name) {
|
|
3
|
+
return name.trim().toLowerCase();
|
|
4
|
+
}
|
|
5
|
+
export function getComponentAntiPatterns(input) {
|
|
6
|
+
const loaded = loadDesignGuidelines();
|
|
7
|
+
if (!loaded.ok)
|
|
8
|
+
return { ok: false, error: loaded.error };
|
|
9
|
+
const guideline = loaded.data.componentsByName.get(normalize(input.component));
|
|
10
|
+
if (!guideline) {
|
|
11
|
+
return { ok: false, error: `No guideline entry found for component: ${input.component}` };
|
|
12
|
+
}
|
|
13
|
+
return {
|
|
14
|
+
ok: true,
|
|
15
|
+
body: {
|
|
16
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
17
|
+
component: guideline.name,
|
|
18
|
+
antiPatterns: guideline.antiPatterns,
|
|
19
|
+
avoidWhen: guideline.avoidWhen
|
|
20
|
+
}
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
export function checkComponentCompatibility(input) {
|
|
24
|
+
const loaded = loadDesignGuidelines();
|
|
25
|
+
if (!loaded.ok)
|
|
26
|
+
return { ok: false, error: loaded.error };
|
|
27
|
+
const primary = loaded.data.componentsByName.get(normalize(input.primary));
|
|
28
|
+
if (!primary) {
|
|
29
|
+
return { ok: false, error: `No guideline entry found for component: ${input.primary}` };
|
|
30
|
+
}
|
|
31
|
+
const normalizedSecondary = normalize(input.secondary);
|
|
32
|
+
const pairing = primary.pairings.find((p) => normalize(p.component) === normalizedSecondary) ?? null;
|
|
33
|
+
const conflict = primary.conflicts.find((c) => normalize(c.component) === normalizedSecondary) ?? null;
|
|
34
|
+
let score = 50;
|
|
35
|
+
if (pairing)
|
|
36
|
+
score = 85;
|
|
37
|
+
if (conflict)
|
|
38
|
+
score = conflict.severity === 'high' ? 10 : conflict.severity === 'medium' ? 25 : 40;
|
|
39
|
+
return {
|
|
40
|
+
ok: true,
|
|
41
|
+
body: {
|
|
42
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
43
|
+
primary: primary.name,
|
|
44
|
+
secondary: input.secondary,
|
|
45
|
+
compatibilityScore: score,
|
|
46
|
+
compatible: pairing !== null && conflict === null,
|
|
47
|
+
pairings: pairing ? [pairing] : [],
|
|
48
|
+
conflicts: conflict ? [conflict] : [],
|
|
49
|
+
guidance: pairing
|
|
50
|
+
? [`Preferred pairing: ${pairing.reason}`, ...(pairing.glue.length ? [`Required glue: ${pairing.glue.join('; ')}`] : [])]
|
|
51
|
+
: conflict
|
|
52
|
+
? [`Avoid pairing: ${conflict.reason}`]
|
|
53
|
+
: ['No explicit guidance found; validate composition manually.']
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=compatibility-engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compatibility-engine.js","sourceRoot":"","sources":["../../src/design-guidelines/compatibility-engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
export declare function getComponentStateMatrix(input: {
|
|
2
|
+
component: string;
|
|
3
|
+
}): {
|
|
4
|
+
ok: true;
|
|
5
|
+
body: Record<string, unknown>;
|
|
6
|
+
} | {
|
|
7
|
+
ok: false;
|
|
8
|
+
error: string;
|
|
9
|
+
};
|
|
10
|
+
export declare function getComponentVariants(input: {
|
|
11
|
+
component: string;
|
|
12
|
+
}): {
|
|
13
|
+
ok: true;
|
|
14
|
+
body: Record<string, unknown>;
|
|
15
|
+
} | {
|
|
16
|
+
ok: false;
|
|
17
|
+
error: string;
|
|
18
|
+
};
|
|
19
|
+
//# sourceMappingURL=component-guideline-engine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"component-guideline-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/component-guideline-engine.ts"],"names":[],"mappings":"AAMA,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAe7E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgB7E"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { loadDesignGuidelines } from './repository.js';
|
|
2
|
+
function normalize(value) {
|
|
3
|
+
return value.trim().toLowerCase();
|
|
4
|
+
}
|
|
5
|
+
export function getComponentStateMatrix(input) {
|
|
6
|
+
const loaded = loadDesignGuidelines();
|
|
7
|
+
if (!loaded.ok)
|
|
8
|
+
return { ok: false, error: loaded.error };
|
|
9
|
+
const guideline = loaded.data.componentsByName.get(normalize(input.component));
|
|
10
|
+
if (!guideline) {
|
|
11
|
+
return { ok: false, error: `No guideline entry found for component: ${input.component}` };
|
|
12
|
+
}
|
|
13
|
+
return {
|
|
14
|
+
ok: true,
|
|
15
|
+
body: {
|
|
16
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
17
|
+
component: guideline.name,
|
|
18
|
+
stateMatrix: guideline.stateMatrix
|
|
19
|
+
}
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
export function getComponentVariants(input) {
|
|
23
|
+
const loaded = loadDesignGuidelines();
|
|
24
|
+
if (!loaded.ok)
|
|
25
|
+
return { ok: false, error: loaded.error };
|
|
26
|
+
const guideline = loaded.data.componentsByName.get(normalize(input.component));
|
|
27
|
+
if (!guideline) {
|
|
28
|
+
return { ok: false, error: `No guideline entry found for component: ${input.component}` };
|
|
29
|
+
}
|
|
30
|
+
return {
|
|
31
|
+
ok: true,
|
|
32
|
+
body: {
|
|
33
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
34
|
+
component: guideline.name,
|
|
35
|
+
variants: guideline.variants,
|
|
36
|
+
propOptions: guideline.propOptions
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=component-guideline-engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"component-guideline-engine.js","sourceRoot":"","sources":["../../src/design-guidelines/component-guideline-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAEvC;IACC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;IAC5F,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa;YACxC,SAAS,EAAE,SAAS,CAAC,IAAI;YACzB,WAAW,EAAE,SAAS,CAAC,WAAW;SACnC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAEpC;IACC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;IAC5F,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa;YACxC,SAAS,EAAE,SAAS,CAAC,IAAI;YACzB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,WAAW,EAAE,SAAS,CAAC,WAAW;SACnC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"composition-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/composition-engine.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyB7E"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { loadDesignGuidelines, getPattern } from './repository.js';
|
|
2
|
+
export function getCompositionRecipe(input) {
|
|
3
|
+
const loaded = loadDesignGuidelines();
|
|
4
|
+
if (!loaded.ok)
|
|
5
|
+
return { ok: false, error: loaded.error };
|
|
6
|
+
const pattern = getPattern(loaded.data, input.pattern);
|
|
7
|
+
if (!pattern) {
|
|
8
|
+
return { ok: false, error: `Unknown pattern or intent: ${input.pattern}` };
|
|
9
|
+
}
|
|
10
|
+
return {
|
|
11
|
+
ok: true,
|
|
12
|
+
body: {
|
|
13
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
14
|
+
pattern: {
|
|
15
|
+
id: pattern.id,
|
|
16
|
+
title: pattern.title,
|
|
17
|
+
intent: pattern.intent
|
|
18
|
+
},
|
|
19
|
+
requiredComponents: pattern.requiredComponents,
|
|
20
|
+
optionalComponents: pattern.optionalComponents,
|
|
21
|
+
composition: pattern.componentTree,
|
|
22
|
+
interactionFlow: pattern.interactionFlow,
|
|
23
|
+
requiredStates: pattern.failureStates,
|
|
24
|
+
accessibilityRules: pattern.accessibilityRules,
|
|
25
|
+
constraints: pattern.constraints
|
|
26
|
+
}
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=composition-engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"composition-engine.js","sourceRoot":"","sources":["../../src/design-guidelines/composition-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE,MAAM,UAAU,oBAAoB,CAAC,KAEpC;IACC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;IAC7E,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa;YACxC,OAAO,EAAE;gBACP,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB;YACD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,WAAW,EAAE,OAAO,CAAC,aAAa;YAClC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,cAAc,EAAE,OAAO,CAAC,aAAa;YACrC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export declare function listUiPatterns(input?: {
|
|
2
|
+
limit?: number;
|
|
3
|
+
offset?: number;
|
|
4
|
+
}): {
|
|
5
|
+
ok: true;
|
|
6
|
+
body: Record<string, unknown>;
|
|
7
|
+
} | {
|
|
8
|
+
ok: false;
|
|
9
|
+
error: string;
|
|
10
|
+
};
|
|
11
|
+
export declare function getUiPattern(input: {
|
|
12
|
+
pattern: string;
|
|
13
|
+
}): {
|
|
14
|
+
ok: true;
|
|
15
|
+
body: Record<string, unknown>;
|
|
16
|
+
} | {
|
|
17
|
+
ok: false;
|
|
18
|
+
error: string;
|
|
19
|
+
};
|
|
20
|
+
//# sourceMappingURL=pattern-engine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pattern-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/pattern-engine.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA2B7E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyB7E"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { getPattern, loadDesignGuidelines } from './repository.js';
|
|
2
|
+
export function listUiPatterns(input) {
|
|
3
|
+
const loaded = loadDesignGuidelines();
|
|
4
|
+
if (!loaded.ok)
|
|
5
|
+
return { ok: false, error: loaded.error };
|
|
6
|
+
const offset = input?.offset ?? 0;
|
|
7
|
+
const limit = input?.limit ?? 50;
|
|
8
|
+
const total = loaded.data.raw.patterns.length;
|
|
9
|
+
const patterns = loaded.data.raw.patterns
|
|
10
|
+
.slice(offset, offset + limit)
|
|
11
|
+
.map((pattern) => ({
|
|
12
|
+
id: pattern.id,
|
|
13
|
+
title: pattern.title,
|
|
14
|
+
intent: pattern.intent,
|
|
15
|
+
requiredComponents: pattern.requiredComponents,
|
|
16
|
+
optionalComponents: pattern.optionalComponents
|
|
17
|
+
}));
|
|
18
|
+
return {
|
|
19
|
+
ok: true,
|
|
20
|
+
body: {
|
|
21
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
22
|
+
total,
|
|
23
|
+
offset,
|
|
24
|
+
limit,
|
|
25
|
+
returned: patterns.length,
|
|
26
|
+
nextOffset: offset + patterns.length < total ? offset + patterns.length : null,
|
|
27
|
+
patterns
|
|
28
|
+
}
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export function getUiPattern(input) {
|
|
32
|
+
const loaded = loadDesignGuidelines();
|
|
33
|
+
if (!loaded.ok)
|
|
34
|
+
return { ok: false, error: loaded.error };
|
|
35
|
+
const pattern = getPattern(loaded.data, input.pattern);
|
|
36
|
+
if (!pattern) {
|
|
37
|
+
return { ok: false, error: `Unknown pattern or intent: ${input.pattern}` };
|
|
38
|
+
}
|
|
39
|
+
return {
|
|
40
|
+
ok: true,
|
|
41
|
+
body: {
|
|
42
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
43
|
+
pattern: {
|
|
44
|
+
id: pattern.id,
|
|
45
|
+
title: pattern.title,
|
|
46
|
+
intent: pattern.intent
|
|
47
|
+
},
|
|
48
|
+
constraints: pattern.constraints,
|
|
49
|
+
requiredComponents: pattern.requiredComponents,
|
|
50
|
+
optionalComponents: pattern.optionalComponents,
|
|
51
|
+
interactionFlow: pattern.interactionFlow,
|
|
52
|
+
failureStates: pattern.failureStates,
|
|
53
|
+
accessibilityRules: pattern.accessibilityRules,
|
|
54
|
+
componentTree: pattern.componentTree
|
|
55
|
+
}
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=pattern-engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pattern-engine.js","sourceRoot":"","sources":["../../src/design-guidelines/pattern-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,MAAM,UAAU,cAAc,CAAC,KAG9B;IACC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ;SACtC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;SAC7B,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;KAC/C,CAAC,CAAC,CAAC;IACN,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa;YACxC,KAAK;YACL,MAAM;YACN,KAAK;YACL,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;YAC9E,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAE5B;IACC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;IAC7E,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa;YACxC,OAAO,EAAE;gBACP,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB;YACD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"recommendation-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/recommendation-engine.ts"],"names":[],"mappings":"AAgDA,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAoD7E"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import { searchComponentsByApi, searchSkyComponents } from '../docs.js';
|
|
2
|
+
import { loadDesignGuidelines } from './repository.js';
|
|
3
|
+
function queryTokens(query) {
|
|
4
|
+
return query
|
|
5
|
+
.toLowerCase()
|
|
6
|
+
.split(/[^a-z0-9]+/g)
|
|
7
|
+
.map((t) => t.trim())
|
|
8
|
+
.filter(Boolean);
|
|
9
|
+
}
|
|
10
|
+
function scoreGuideline(guideline, tokens) {
|
|
11
|
+
const rationale = [];
|
|
12
|
+
const constraintsMatched = [];
|
|
13
|
+
let score = 0;
|
|
14
|
+
for (const statement of guideline.useWhen) {
|
|
15
|
+
const text = statement.toLowerCase();
|
|
16
|
+
const hits = tokens.filter((t) => text.includes(t));
|
|
17
|
+
if (hits.length > 0) {
|
|
18
|
+
score += hits.length * 3;
|
|
19
|
+
constraintsMatched.push(statement);
|
|
20
|
+
rationale.push(`matches useWhen: ${statement}`);
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
return { score, rationale, constraintsMatched };
|
|
24
|
+
}
|
|
25
|
+
function resolveImport(componentName) {
|
|
26
|
+
const catalogSearch = searchSkyComponents(componentName, 1);
|
|
27
|
+
if (catalogSearch.ok && catalogSearch.hits[0]) {
|
|
28
|
+
return catalogSearch.hits[0].npmImport;
|
|
29
|
+
}
|
|
30
|
+
const apiSearch = searchComponentsByApi(componentName, 1);
|
|
31
|
+
if (apiSearch.ok && apiSearch.hits[0]) {
|
|
32
|
+
return apiSearch.hits[0].npmImport;
|
|
33
|
+
}
|
|
34
|
+
return `@sky-ui/core/${componentName}`;
|
|
35
|
+
}
|
|
36
|
+
export function recommendComponentsForUseCaseV2(input) {
|
|
37
|
+
const loaded = loadDesignGuidelines();
|
|
38
|
+
if (!loaded.ok)
|
|
39
|
+
return { ok: false, error: loaded.error };
|
|
40
|
+
const tokens = queryTokens(input.query);
|
|
41
|
+
if (tokens.length === 0) {
|
|
42
|
+
return { ok: false, error: 'Query must include at least one alphanumeric token.' };
|
|
43
|
+
}
|
|
44
|
+
const ranked = [];
|
|
45
|
+
for (const guideline of loaded.data.raw.components) {
|
|
46
|
+
const { score, rationale, constraintsMatched } = scoreGuideline(guideline, tokens);
|
|
47
|
+
if (score <= 0)
|
|
48
|
+
continue;
|
|
49
|
+
ranked.push({
|
|
50
|
+
name: guideline.name,
|
|
51
|
+
import: resolveImport(guideline.name),
|
|
52
|
+
score,
|
|
53
|
+
confidence: Math.min(1, 0.35 + score / 18),
|
|
54
|
+
rationale,
|
|
55
|
+
constraintsMatched,
|
|
56
|
+
avoid: guideline.avoidWhen
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
ranked.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
|
|
60
|
+
const recommended = ranked.slice(0, input.limit).map((row) => ({
|
|
61
|
+
name: row.name,
|
|
62
|
+
import: row.import,
|
|
63
|
+
confidence: Number(row.confidence.toFixed(2)),
|
|
64
|
+
rationale: row.rationale,
|
|
65
|
+
constraintsMatched: row.constraintsMatched
|
|
66
|
+
}));
|
|
67
|
+
const alternatives = ranked.slice(input.limit, input.limit + 3).map((row) => ({
|
|
68
|
+
name: row.name,
|
|
69
|
+
import: row.import,
|
|
70
|
+
rationale: row.rationale.slice(0, 2)
|
|
71
|
+
}));
|
|
72
|
+
const avoid = ranked
|
|
73
|
+
.flatMap((row) => row.avoid.map((a) => ({ component: row.name, condition: a })))
|
|
74
|
+
.slice(0, 6);
|
|
75
|
+
return {
|
|
76
|
+
ok: true,
|
|
77
|
+
body: {
|
|
78
|
+
query: input.query,
|
|
79
|
+
schemaVersion: loaded.data.schemaVersion,
|
|
80
|
+
source: loaded.data.sourcePath,
|
|
81
|
+
strategy: 'guideline.useWhen keyword scoring (deterministic)',
|
|
82
|
+
recommended,
|
|
83
|
+
alternatives,
|
|
84
|
+
avoid
|
|
85
|
+
}
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
//# sourceMappingURL=recommendation-engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"recommendation-engine.js","sourceRoot":"","sources":["../../src/design-guidelines/recommendation-engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { type ComponentGuideline, type DesignGuidelinesFile, type MethodGuideline, type PatternGuideline } from './schema.js';
|
|
2
|
+
export type DesignGuidelineRepo = {
|
|
3
|
+
schemaVersion: string;
|
|
4
|
+
sourcePath: string;
|
|
5
|
+
componentsByName: Map<string, ComponentGuideline>;
|
|
6
|
+
patternsById: Map<string, PatternGuideline>;
|
|
7
|
+
methodsByKey: Map<string, MethodGuideline>;
|
|
8
|
+
raw: DesignGuidelinesFile;
|
|
9
|
+
};
|
|
10
|
+
export declare function guidelinesPath(): string;
|
|
11
|
+
export declare function loadDesignGuidelines(): {
|
|
12
|
+
ok: true;
|
|
13
|
+
data: DesignGuidelineRepo;
|
|
14
|
+
} | {
|
|
15
|
+
ok: false;
|
|
16
|
+
error: string;
|
|
17
|
+
};
|
|
18
|
+
export declare function getPattern(repo: DesignGuidelineRepo, idOrIntent: string): PatternGuideline | null;
|
|
19
|
+
//# sourceMappingURL=repository.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/repository.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAMrB,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAClD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,GAAG,EAAE,oBAAoB,CAAC;CAC3B,CAAC;AAEF,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAgDD,wBAAgB,oBAAoB,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE7G;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAUjG"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { getCached } from '../cache.js';
|
|
4
|
+
import { packagesDir } from '../catalog.js';
|
|
5
|
+
import { designGuidelinesFileSchema } from './schema.js';
|
|
6
|
+
const DATA_RELATIVE = join('mcp', 'data', 'design-guidelines', 'p0-guidelines.json');
|
|
7
|
+
const CACHE_KEY = 'design-guidelines:p0';
|
|
8
|
+
const CACHE_TTL_MS = 60_000;
|
|
9
|
+
export function guidelinesPath() {
|
|
10
|
+
return join(packagesDir(), DATA_RELATIVE);
|
|
11
|
+
}
|
|
12
|
+
function normalizeKey(value) {
|
|
13
|
+
return value.trim().toLowerCase();
|
|
14
|
+
}
|
|
15
|
+
function buildRepo(path, raw) {
|
|
16
|
+
const componentsByName = new Map();
|
|
17
|
+
for (const component of raw.components) {
|
|
18
|
+
componentsByName.set(normalizeKey(component.name), component);
|
|
19
|
+
}
|
|
20
|
+
const patternsById = new Map();
|
|
21
|
+
for (const pattern of raw.patterns) {
|
|
22
|
+
patternsById.set(normalizeKey(pattern.id), pattern);
|
|
23
|
+
}
|
|
24
|
+
const methodsByKey = new Map();
|
|
25
|
+
for (const method of raw.methods) {
|
|
26
|
+
methodsByKey.set(`${normalizeKey(method.component)}::${normalizeKey(method.methodName)}`, method);
|
|
27
|
+
}
|
|
28
|
+
return {
|
|
29
|
+
schemaVersion: raw.schemaVersion,
|
|
30
|
+
sourcePath: path,
|
|
31
|
+
componentsByName,
|
|
32
|
+
patternsById,
|
|
33
|
+
methodsByKey,
|
|
34
|
+
raw
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
function loadDesignGuidelinesImpl() {
|
|
38
|
+
const path = guidelinesPath();
|
|
39
|
+
if (!existsSync(path)) {
|
|
40
|
+
return { ok: false, error: `Design guideline file not found: ${path}` };
|
|
41
|
+
}
|
|
42
|
+
try {
|
|
43
|
+
const text = readFileSync(path, 'utf8');
|
|
44
|
+
const parsed = JSON.parse(text);
|
|
45
|
+
const validated = designGuidelinesFileSchema.safeParse(parsed);
|
|
46
|
+
if (!validated.success) {
|
|
47
|
+
return { ok: false, error: `Invalid guideline schema: ${validated.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ')}` };
|
|
48
|
+
}
|
|
49
|
+
return { ok: true, data: buildRepo(path, validated.data) };
|
|
50
|
+
}
|
|
51
|
+
catch (e) {
|
|
52
|
+
const msg = e instanceof Error ? e.message : String(e);
|
|
53
|
+
return { ok: false, error: `Failed to load design guidelines: ${msg}` };
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
export function loadDesignGuidelines() {
|
|
57
|
+
return getCached(CACHE_KEY, CACHE_TTL_MS, loadDesignGuidelinesImpl);
|
|
58
|
+
}
|
|
59
|
+
export function getPattern(repo, idOrIntent) {
|
|
60
|
+
const query = normalizeKey(idOrIntent);
|
|
61
|
+
const byId = repo.patternsById.get(query);
|
|
62
|
+
if (byId)
|
|
63
|
+
return byId;
|
|
64
|
+
for (const pattern of repo.raw.patterns) {
|
|
65
|
+
if (normalizeKey(pattern.intent).includes(query) || query.includes(normalizeKey(pattern.intent))) {
|
|
66
|
+
return pattern;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
return null;
|
|
70
|
+
}
|
|
71
|
+
//# sourceMappingURL=repository.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/design-guidelines/repository.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export declare function reviewComponentUsage(input: {
|
|
2
|
+
components: string[];
|
|
3
|
+
context?: string;
|
|
4
|
+
}): {
|
|
5
|
+
ok: true;
|
|
6
|
+
body: Record<string, unknown>;
|
|
7
|
+
} | {
|
|
8
|
+
ok: false;
|
|
9
|
+
error: string;
|
|
10
|
+
};
|
|
11
|
+
export declare function reviewDesignSpec(input: {
|
|
12
|
+
spec: string;
|
|
13
|
+
}): {
|
|
14
|
+
ok: true;
|
|
15
|
+
body: Record<string, unknown>;
|
|
16
|
+
} | {
|
|
17
|
+
ok: false;
|
|
18
|
+
error: string;
|
|
19
|
+
};
|
|
20
|
+
//# sourceMappingURL=review-engine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"review-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/review-engine.ts"],"names":[],"mappings":"AAsBA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0F7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyE7E"}
|