@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,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,10 @@
1
+ export declare function getCompositionRecipe(input: {
2
+ pattern: string;
3
+ }): {
4
+ ok: true;
5
+ body: Record<string, unknown>;
6
+ } | {
7
+ ok: false;
8
+ error: string;
9
+ };
10
+ //# sourceMappingURL=composition-engine.d.ts.map
@@ -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,11 @@
1
+ export declare function recommendComponentsForUseCaseV2(input: {
2
+ query: string;
3
+ limit: number;
4
+ }): {
5
+ ok: true;
6
+ body: Record<string, unknown>;
7
+ } | {
8
+ ok: false;
9
+ error: string;
10
+ };
11
+ //# sourceMappingURL=recommendation-engine.d.ts.map
@@ -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":"AAAA,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAUvD,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,KAAK,CAAC,aAAa,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,SAA6B,EAAE,MAAgB;IACrE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YACzB,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnC,SAAS,CAAC,IAAI,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,aAAqB;IAC1C,MAAM,aAAa,GAAG,mBAAmB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAC5D,IAAI,aAAa,CAAC,EAAE,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,MAAM,SAAS,GAAG,qBAAqB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAC1D,IAAI,SAAS,CAAC,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrC,CAAC;IACD,OAAO,gBAAgB,aAAa,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAG/C;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,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;IACrF,CAAC;IAED,MAAM,MAAM,GAA+D,EAAE,CAAC;IAC9E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QACnD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACnF,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC;YACrC,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAC1C,SAAS;YACT,kBAAkB;YAClB,KAAK,EAAE,SAAS,CAAC,SAAS;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7C,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;KAC3C,CAAC,CAAC,CAAC;IACJ,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5E,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;KACrC,CAAC,CAAC,CAAC;IACJ,MAAM,KAAK,GAAG,MAAM;SACjB,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;SAC/E,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEf,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa;YACxC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;YAC9B,QAAQ,EAAE,mDAAmD;YAC7D,WAAW;YACX,YAAY;YACZ,KAAK;SACN;KACF,CAAC;AACJ,CAAC"}
@@ -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"}