@progress/kendo-react-mcp 1.5.0 → 1.5.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/dist/index.js +16 -70
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,62 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import{McpServer as lt}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as dt}from"@modelcontextprotocol/sdk/server/stdio.js";import{dirname as Ze,join as et}from"path";import{fileURLToPath as tt}from"url";import{loadLicense as Ve,decodeLicenseKey as je,decodeLicenseEvidence as We}from"@progress/kendo-licensing/utils";var _=class extends Error{constructor(t){super(t),this.name="LicenseError"}};function ee(e){return e.replace(/^\uFEFF/,"")}async function te(){let e=null,t=null;try{let o=Ve();if(!o.success)throw new _(o.message);try{e=(await je(o.value)).licenses.find(async i=>!!(await We(i)).userId)}catch(n){console.log(n.message)}if(!e)return[ee(o.value),null]}catch(o){return t=o.message||"Unknown error loading license.",[null,t]}return[ee(e),null]}import k from"node:fs";import U from"node:path";var q=!1,N=process.env.DEBUG_LOG_FILE,oe=!!(N&&typeof N=="string");if(oe){let e=U.resolve(N),t=U.dirname(e);if(t!=="."&&t!==process.cwd()&&!k.existsSync(t))try{k.mkdirSync(t,{recursive:!0})}catch(o){console.error("Error creating log directory:",o)}if(!k.existsSync(e))try{k.writeFileSync(e,"")}catch(o){console.error("Error creating log file:",o)}}else q=!1;q=oe&&!!N&&k.existsSync(U.resolve(N));function g(...e){if(q&&N){let n=`${new Date().toISOString()}: ${e.join(" ")}
|
|
3
|
-
`,i=U.resolve(N);k.appendFile(i,n,s=>{s&&console.error("Error writing to log file:",s)})}}import Ye from"@grpc/proto-loader";import
|
|
4
|
-
|
|
5
|
-
License Error: ${n}`);let d=new
|
|
6
|
-
|
|
7
|
-
**Core Principles:**
|
|
8
|
-
1. Use semantic HTML and ARIA correctly
|
|
9
|
-
2. Ensure WCAG 2.2 AA compliance
|
|
10
|
-
3. Follow W3C ARIA Authoring Practices
|
|
11
|
-
4. Provide standards-based accessibility fixes
|
|
12
|
-
|
|
13
|
-
**1. Form Control Labels** (WCAG 1.3.1, 3.3.2, 4.1.2)
|
|
14
|
-
Every input must have an associated label.
|
|
15
|
-
CORRECT: \`<input type="search" aria-label="Search products" placeholder="Search...">\`
|
|
16
|
-
WRONG: \`<span>Email</span><input type="email">\` (no association)
|
|
17
|
-
WRONG: \`<input type="email" placeholder="Email">\` (placeholder as label)
|
|
18
|
-
|
|
19
|
-
**2. Button Accessibility** (WCAG 4.1.2, 2.4.6, 2.5.3)
|
|
20
|
-
All buttons need accessible names describing their purpose.
|
|
21
|
-
CORRECT: \`<button type="button">Save Changes</button>\`
|
|
22
|
-
CORRECT: \`<button aria-label="Close dialog"><svg aria-hidden="true" focusable="false">...</svg></button>\`
|
|
23
|
-
WRONG: \`<button><svg>...</svg></button>\` (no accessible name)
|
|
24
|
-
WRONG: \`<button>Click here</button>\` (generic text)
|
|
25
|
-
|
|
26
|
-
**3. Popup/Menu Triggers** (WCAG 4.1.2, 1.3.1)
|
|
27
|
-
Indicate popup purpose and state using aria-haspopup, aria-expanded, aria-controls.
|
|
28
|
-
CORRECT: \`<button aria-expanded="false" aria-haspopup="menu" aria-controls="menu-id">Settings</button>\`
|
|
29
|
-
|
|
30
|
-
**4. Image Accessibility** (WCAG 1.1.1)
|
|
31
|
-
Informative: \`<img src="chart.png" alt="Sales increased 25% in Q4 2024">\`
|
|
32
|
-
Functional: \`<a href="/home"><img src="logo.png" alt="Company Name Home"></a>\`
|
|
33
|
-
Decorative: \`<img src="border.png" alt="" role="presentation">\`
|
|
34
|
-
Complex: \`<img src="chart.png" alt="Sales data" aria-describedby="desc-id">\`
|
|
35
|
-
WRONG: Missing alt, filename as alt, generic alt for decorative images
|
|
36
|
-
|
|
37
|
-
**5. Link Accessibility** (WCAG 2.4.4, 2.4.6)
|
|
38
|
-
Links must be descriptive and understandable out of context.
|
|
39
|
-
CORRECT: \`<a href="/products">View All Products</a>\`
|
|
40
|
-
CORRECT: \`<a href="/article" aria-label="Read more about New Product Launch">Read more</a>\`
|
|
41
|
-
WRONG: "Click here", "Read more", "Learn more" without context
|
|
42
|
-
|
|
43
|
-
**6. Form Validation** (WCAG 3.3.1, 3.3.2, 3.3.3)
|
|
44
|
-
Errors must be identified, associated with inputs, and provide suggestions. Use aria-describedby, aria-invalid="true", and role="alert".
|
|
45
|
-
|
|
46
|
-
**7. Heading Structure** (WCAG 1.3.1, 2.4.6)
|
|
47
|
-
Use hierarchical, descriptive headings. One h1 per page, no skipped levels (h1\u2192h2\u2192h3).
|
|
48
|
-
CORRECT: Logical hierarchy with descriptive headings
|
|
49
|
-
WRONG: Skipped levels (h1\u2192h3), non-descriptive headings
|
|
50
|
-
|
|
51
|
-
**Quick Checklist:**
|
|
52
|
-
- **Forms:** Associated labels, aria-required on required fields, autocomplete attributes, aria-describedby for errors, aria-invalid for invalid fields, fieldsets with legends
|
|
53
|
-
- **Buttons/Links:** Accessible names, aria-label for icon buttons, aria-hidden on decorative icons, descriptive link text
|
|
54
|
-
- **Popups/Dialogs:** aria-haspopup, aria-expanded, aria-controls, role="dialog", aria-modal="true", aria-labelledby, focus trap, Escape to close
|
|
55
|
-
- **Images:** alt on all images, descriptive alt for informative, empty alt for decorative, aria-describedby for complex
|
|
56
|
-
- **Structure:** One h1, logical heading hierarchy, landmarks (header, nav, main, footer), skip links, semantic HTML
|
|
57
|
-
- **Dynamic Content:** role="status"/aria-live="polite" for updates, role="alert"/aria-live="assertive" for critical alerts
|
|
58
|
-
- **Keyboard/Focus:** All interactive elements keyboard accessible, logical focus order, visible focus indicators, no keyboard traps (except modals)
|
|
59
|
-
- **Color/Contrast:** 4.5:1 text contrast (3:1 large text), 3:1 UI component contrast, no color-only information, 3:1 focus indicator contrast`}var p="Kendo UI for React",I="react",E="kendo",x=["ActionSheet","AIPrompt","Animation","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","Breadcrumb","Button","ButtonGroup","Calendar","Card","Chart","ChartWizard","Chat","Checkbox","Chip","ChipList","ChunkProgressBar","CircularGauge","ColorGradient","ColorPalette","ColorPicker","ComboBox","ContextMenu","ConversationalUI","DataGrid","Grid","DataQuery","DateMath","DateInput","DatePicker","DateRangePicker","DateTimePicker","Dialog","Drag&Drop","Drawer","Drawing","DropDownButton","DropDownList","DropDownTree","Editor","Error","ExcelExport","ExpansionPanel","ExternalDropZone","FileSaver","FileManager","Filter","FlatColorPicker","FloatingActionButton","FloatingLabel","FontIcon","Form","Gantt","Gauge","General","GridLayout","Hint","InlineAIPrompt","Input","Label","LinearGauge","ListBox","ListView","Loader","Map","MaskedTextBox","Menu","MultiColumnComboBox","MultiSelect","MultiSelectTree","MultiViewCalendar","Notification","NumericTextBox","OrgChart","PageTemplates/BuildingBlocks","Pager","PanelBar","PDFProcessing","PDFViewer","PivotGrid","Popover","Popup","ProgressBar","QRCode","RadialGauge","RadioButton","RadioGroup","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","Sortable","Sparkline","SpeechToTextButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","StockChart","SVGIcon","Switch","TabStrip","TaskBoard","TextArea","TextBox","TileLayout","Timeline","TimePicker","Toolbar","Tooltip","TreeList","TreeView","Typography","Upload","VSCodeExtension","Window"];var ot=et(Ze(tt(import.meta.url)),"../proto/service.proto"),$=new M("contextapi.telerik.com:443",ot,{libName:I});var le=async()=>$.validateUserLicense();import pt from"fs";import Be from"path";import{fileURLToPath as ut}from"url";import{z as m}from"zod";var b=class{constructor(t,o,n){this.name=t;this.config=o;this.cb=n}register(t){this.server=t,this.server.registerTool(this.name,this.config,this.cb)}hasAccess(t){return!this.config.requiredAccess||this.config.requiredAccess.length===0?!0:t==="full"||this.config.requiredAccess.includes(t)}};var P=(e,t)=>`# ${e.suiteName} - Code Validation & Quality Assurance
|
|
3
|
+
`,i=U.resolve(N);k.appendFile(i,n,s=>{s&&console.error("Error writing to log file:",s)})}}import Ye from"@grpc/proto-loader";import M from"@grpc/grpc-js";import ie from"path";import ne from"fs";import{fileURLToPath as He}from"url";var ze=He(import.meta.url),Qe=ie.dirname(ze),ae={version:"unknown"},se=ie.resolve(Qe,"../package.json");ne.existsSync(se)&&(ae=JSON.parse(ne.readFileSync(se,"utf-8")));function Je(e){return e.replace(/\u2014/g,"--").replace(/\u2013/g,"-").replace(/[^\x20-\x7E]/g,"")}var G=class{constructor(t,o,n){this.contextApiUrl=t;this.protoPath=o;this.options=n;this.toolNameHeader="assistant";let i=Ye.loadSync(this.protoPath,{keepCase:!0,longs:String,enums:String,defaults:!0,oneofs:!0});this.isDev=this.contextApiUrl?.includes("localhost")||this.contextApiUrl?.includes("127.0.0.1"),g("Using ContextApi URl:",this.contextApiUrl);let s=M.loadPackageDefinition(i);this.client=new s.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?M.credentials.createInsecure():M.credentials.createSsl())}async getMetadata({meta:t}={meta:{}}){let[o,n]=this.isDev?"fake_license":await te(),i=process.env.CONTEXTAPI_API_KEY,s=i&&typeof i=="string",c=o&&typeof o=="string";if(!c&&!s&&n)throw new Error(`Failed to authenticate with API key or License key!
|
|
4
|
+
|
|
5
|
+
License Error: ${n}`);let d=new M.Metadata;if(c)try{d.add("x-license-key",o)}catch(h){throw g("Error adding license key to metadata:",h),new Error(`Failed to use license key: ${h.message}`)}s&&d.add("x-api-key",i),this.options?.libName&&d.add("x-library-name",this.options.libName),d.add("x-tool-name",this.toolNameHeader);let m=JSON.stringify({...t,source:"npm",version:ae.version,os:process.platform,node_version:process.version});return d.add("x-request-metadata",Je(m)),d}async query(t){let o=await this.getMetadata();return new Promise((n,i)=>{this.client.query(t,o,(s,c)=>{s?i(new Error(s)):n(c)})})}async queryCssUtils(t){let o=await this.getMetadata();return new Promise((n,i)=>{this.client.cssUtilsSearch(t,o,(s,c)=>{s?(g("Error querying CSS Utils:",s),i(new Error(s))):n(c)})})}async queryIconsSearch(t){let o=await this.getMetadata();return new Promise((n,i)=>{this.client.iconsSearch(t,o,(s,c)=>{s?(g("Error querying Icons Search:",s),i(new Error(s))):n(c)})})}async queryBuildingBlocks(t){let o=await this.getMetadata();return new Promise((n,i)=>{this.client.buildingBlocksSearch(t,o,(s,c)=>{s?(g("Error querying Building Blocks:",s),i(new Error(s))):n(c)})})}async validateUserLicense(){let t=await this.getMetadata();return new Promise((o,n)=>{this.client.validateUserLicense(null,t,(i,s)=>{i?(g("Error validating user license:",i),n(new Error(i))):o(s)})})}async queryThemeGenerate(t){let o=await this.getMetadata();return new Promise((n,i)=>{this.client.generateTheme(t,o,(s,c)=>{s?(g("Error querying context API/GenerateTheme:",s),i(new Error(s))):n(c)})})}async recordOrchestratorUserRequest({meta:t}){let o=await this.getMetadata({meta:t});return new Promise((n,i)=>{this.client.recordOrchestratorUserRequest(null,o,(s,c)=>{s?(g("Error recording orchestrator user request:",s),i(new Error(s))):n(c)})})}};import{z as B}from"zod";var Ut=B.object({user_id:B.string(),user_email:B.string().email()});import{z as f}from"zod";var Xe=f.object({Product:f.object({Id:f.number().int(),Code:f.string(),Name:f.string()}),License:f.nullable(f.object({Id:f.number().int(),Name:f.string(),Type:f.string(),Active:f.boolean()})),Availability:f.array(f.object({LicenseStart:f.nullable(f.string().datetime()),LicenseEnd:f.nullable(f.string().datetime())})),IsLicenseAvailable:f.optional(f.boolean())}),$t=f.array(Xe);async function re(e){let t=process.env.KENDO_MCP_ACCESS;if(t==="true"||t==="1"||t==="full")return"full";if(typeof t=="string"&&(t.toLowerCase()==="agent"||t.toLowerCase()==="assistant"))return t.toLowerCase();let o=await e();return o.toLocaleLowerCase()==="agentic_ui_generator"?"agent":o.toLocaleLowerCase()==="ai_coding_assistants"?"assistant":"none"}function ce(){return'**Accessibility Guidelines: WCAG 2.2 Level AA Compliance**\n\n**Core Principles:**\n1. Use semantic HTML and ARIA correctly\n2. Ensure WCAG 2.2 AA compliance\n3. Follow W3C ARIA Authoring Practices\n4. Provide standards-based accessibility fixes\n\n**1. Form Control Labels** (WCAG 1.3.1, 3.3.2, 4.1.2)\nEvery input must have an associated label.\nCORRECT: `<input type="search" aria-label="Search products" placeholder="Search...">`\nWRONG: `<span>Email</span><input type="email">` (no association)\nWRONG: `<input type="email" placeholder="Email">` (placeholder as label)\n\n**2. Button Accessibility** (WCAG 4.1.2, 2.4.6, 2.5.3)\nAll buttons need accessible names describing their purpose.\nCORRECT: `<button type="button">Save Changes</button>`\nCORRECT: `<button aria-label="Close dialog"><svg aria-hidden="true" focusable="false">...</svg></button>`\nWRONG: `<button><svg>...</svg></button>` (no accessible name)\nWRONG: `<button>Click here</button>` (generic text)\n\n**3. Popup/Menu Triggers** (WCAG 4.1.2, 1.3.1)\nIndicate popup purpose and state using aria-haspopup, aria-expanded, aria-controls.\nCORRECT: `<button aria-expanded="false" aria-haspopup="menu" aria-controls="menu-id">Settings</button>`\n\n**4. Image Accessibility** (WCAG 1.1.1)\nInformative: `<img src="chart.png" alt="Sales increased 25% in Q4 2024">`\nFunctional: `<a href="/home"><img src="logo.png" alt="Company Name Home"></a>`\nDecorative: `<img src="border.png" alt="" role="presentation">`\nComplex: `<img src="chart.png" alt="Sales data" aria-describedby="desc-id">`\nWRONG: Missing alt, filename as alt, generic alt for decorative images\n\n**5. Link Accessibility** (WCAG 2.4.4, 2.4.6)\nLinks must be descriptive and understandable out of context.\nCORRECT: `<a href="/products">View All Products</a>`\nCORRECT: `<a href="/article" aria-label="Read more about New Product Launch">Read more</a>`\nWRONG: "Click here", "Read more", "Learn more" without context\n\n**6. Form Validation** (WCAG 3.3.1, 3.3.2, 3.3.3)\nErrors must be identified, associated with inputs, and provide suggestions. Use aria-describedby, aria-invalid="true", and role="alert".\n\n**7. Heading Structure** (WCAG 1.3.1, 2.4.6)\nEvery page MUST have exactly one `<h1>`. Use hierarchical, descriptive headings with no skipped levels (h1\u2192h2\u2192h3).\nCORRECT: `<h1>Dashboard</h1> <h2>Sales</h2> <h3>By Region</h3>`\nWRONG: No `<h1>` on the page, or skipping levels (h1\u2192h3)\nIf a heading should look smaller than its semantic level, use CSS: `<h2 class="text-sm">Subtitle</h2>`\n\n**8. Page Landmarks and Regions** (WCAG 1.3.1, 2.4.1)\nEvery page MUST have exactly one `<main>` element. ALL visible content MUST be inside landmark regions.\n\nCORRECT:\n```html\n<body>\n <header>\n <nav aria-label="Main navigation">...</nav>\n </header>\n <main>\n <!-- Primary page content -->\n </main>\n <footer>...</footer>\n</body>\n```\n\n- Exactly ONE `<main>` per page \u2014 never zero, never more than one.\n- `<header>`, `<nav>`, `<footer>` are their own landmarks \u2014 place them OUTSIDE `<main>`, not inside it.\n- Never leave content as direct children of `<body>` outside a landmark \u2014 wrap in `<header>`, `<nav>`, `<main>`, `<aside>`, or `<footer>`.\n- Multiple `<nav>` or `<aside>` elements must have distinct `aria-label` values.\nWRONG: `<div class="sidebar">` / `<div class="content">` without landmark wrappers.\n\n**Quick Checklist:**\n- **Forms:** Associated labels, aria-required on required fields, autocomplete attributes, aria-describedby for errors, aria-invalid for invalid fields, fieldsets with legends\n- **Buttons/Links:** Accessible names, aria-label for icon buttons, aria-hidden on decorative icons, descriptive link text\n- **Popups/Dialogs:** aria-haspopup, aria-expanded, aria-controls, role="dialog", aria-modal="true", aria-labelledby, focus trap, Escape to close\n- **Images:** alt on all images, descriptive alt for informative, empty alt for decorative, aria-describedby for complex\n- **Structure:** One h1, logical heading hierarchy, exactly one `<main>` landmark, all content inside landmarks (header, nav, main, aside, footer), skip links, semantic HTML\n- **Dynamic Content:** role="status"/aria-live="polite" for updates, role="alert"/aria-live="assertive" for critical alerts\n- **Keyboard/Focus:** All interactive elements keyboard accessible, logical focus order, visible focus indicators, no keyboard traps (except modals)\n- **Color/Contrast:** 4.5:1 text contrast (3:1 large text), 3:1 UI component contrast, no color-only information, 3:1 focus indicator contrast'}var p="Kendo UI for React",v="react",E="kendo",x=["ActionSheet","AIPrompt","Animation","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","Breadcrumb","Button","ButtonGroup","Calendar","Card","Chart","ChartWizard","Chat","Checkbox","Chip","ChipList","ChunkProgressBar","CircularGauge","ColorGradient","ColorPalette","ColorPicker","ComboBox","ContextMenu","ConversationalUI","DataGrid","Grid","DataQuery","DateMath","DateInput","DatePicker","DateRangePicker","DateTimePicker","Dialog","Drag&Drop","Drawer","Drawing","DropDownButton","DropDownList","DropDownTree","Editor","Error","ExcelExport","ExpansionPanel","ExternalDropZone","FileSaver","FileManager","Filter","FlatColorPicker","FloatingActionButton","FloatingLabel","FontIcon","Form","Gantt","Gauge","General","GridLayout","Hint","InlineAIPrompt","Input","Label","LinearGauge","ListBox","ListView","Loader","Map","MaskedTextBox","Menu","MultiColumnComboBox","MultiSelect","MultiSelectTree","MultiViewCalendar","Notification","NumericTextBox","OrgChart","PageTemplates/BuildingBlocks","Pager","PanelBar","PDFProcessing","PDFViewer","PivotGrid","Popover","Popup","ProgressBar","QRCode","RadialGauge","RadioButton","RadioGroup","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","Sortable","Sparkline","SpeechToTextButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","StockChart","SVGIcon","Switch","TabStrip","TaskBoard","TextArea","TextBox","TileLayout","Timeline","TimePicker","Toolbar","Tooltip","TreeList","TreeView","Typography","Upload","VSCodeExtension","Window"];var ot=et(Ze(tt(import.meta.url)),"../proto/service.proto"),$=new G("contextapi.telerik.com:443",ot,{libName:v});var le=async()=>$.validateUserLicense();import pt from"fs";import Be from"path";import{fileURLToPath as mt}from"url";import{z as u}from"zod";var b=class{constructor(t,o,n){this.name=t;this.config=o;this.cb=n}register(t){this.server=t,this.server.registerTool(this.name,this.config,this.cb)}hasAccess(t){return!this.config.requiredAccess||this.config.requiredAccess.length===0?!0:t==="full"||this.config.requiredAccess.includes(t)}};var P=(e,t)=>`# ${e.suiteName} - Code Validation & Quality Assurance
|
|
60
6
|
|
|
61
7
|
## Comprehensive Code Validation Checklist
|
|
62
8
|
Execute these validation steps systematically to ensure high-quality, maintainable code:
|
|
@@ -457,14 +403,14 @@ After gathering information:
|
|
|
457
403
|
- Consistent ${e} theme application across all components
|
|
458
404
|
- Custom theme variables properly defined and scoped
|
|
459
405
|
- ${e} icon fonts properly loaded and optimized
|
|
460
|
-
- Brand colors integrated with ${e} component themes`});function de(e,t,o){let{name:n,title:i,description:s,layoutAssistantName:c,codeAssistantName:d,styleAssistantName:
|
|
406
|
+
- Brand colors integrated with ${e} component themes`});function de(e,t,o){let{name:n,title:i,description:s,layoutAssistantName:c,codeAssistantName:d,styleAssistantName:m,iconAssistantName:h,accessibilityAssistantName:C,suiteName:r,libKey:A,components:a}=e,y=new b(n,{title:i,description:s,requiredAccess:e.requiredAccess,inputSchema:{userIntent:u.string().describe(`Detailed description and intent of what the user wants to build. Include the type of page/component, main functionality, visual requirements, and any specific ${r} components you want to use.`),needsComponentsDocsConfidence:u.number().min(0).max(1).default(1).describe("Confidence (0-1) to include Component Documentation assistance. Default is 1."),needsLayoutConfidence:u.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Layout assistance. Default is 0."),needsStylingConfidence:u.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Theming/Styling assistance. Default is 0."),needsResponsiveBehaviorConfidence:u.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Responsive Behavior assistance. Default is 0."),needsIconsConfidence:u.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Icons assistance. Default is 0."),componentsNeeded:u.array(u.enum(a)).optional().describe(`Optional list of specific ${r} components needed for the project.`)}},async({userIntent:T,needsComponentsDocsConfidence:S,needsLayoutConfidence:I,needsStylingConfidence:D,needsResponsiveBehaviorConfidence:Q,needsIconsConfidence:J,componentsNeeded:X},{_meta:Fe})=>{g("UI Orchestrator called with:",{userIntent:T,needsComponentsDocsConfidence:S,needsLayoutConfidence:I,needsStylingConfidence:D,needsResponsiveBehaviorConfidence:Q,needsIconsConfidence:J});try{await o.recordOrchestratorUserRequest({meta:{userIntent:T,componentsNeeded:X,_meta:Fe}})}catch(L){throw R(L)}let Ke=y.server?.server.getClientCapabilities?.()?.elicitation,Z;if(Ke&&D>.3&&D<=.6){let L=await y.server?.server.elicitInput({message:"I was unable to determine if you need custom Kendo Theme assistant. Can you please confirm?",requestedSchema:{type:"object",properties:{includeCustomTheming:{type:"boolean",description:"Whether to include Custom Theming assistance in the workflow."}},required:["includeCustomTheming"]}});L?.action==="accept"&&L.content?.includeCustomTheming&&(Z=!0)}return{content:[{type:"text",text:O({name:n,userIntent:T,includeComponentsDocs:S>.3,includeTheming:D>.6||!!Z,includeLayout:I>.5,includeIcons:J>.6,includeResponsive:I>.5&&Q>.4,layoutAssistantName:c,codeAssistantName:d,styleAssistantName:m,iconAssistantName:h,accessibilityAssistantName:C,suiteName:r,libKey:A,components:X},t)}]}});return y}function pe(e,t){let{name:o,title:n,description:i,iconAssistantName:s,codeAssistantName:c,suiteName:d,libKey:m,components:h}=e;return new b(o,{title:n,description:i,inputSchema:{userIntent:u.string().describe(`Describe what you want to build or what components you're looking for. Include the type of functionality, features, or UI elements you need from ${d}.`),needsIconsConfidence:u.number().min(0).max(1).default(.7).describe("Confidence (0-1) to include Icons assistance. Default is 0.7."),componentsNeeded:u.array(u.enum(h)).optional().describe(`Optional list of specific ${d} components you want to learn about.`)},requiredAccess:e.requiredAccess},async({userIntent:r,needsIconsConfidence:A,componentsNeeded:a},{_meta:y})=>{g("Assistant Orchestrator called with:",{userIntent:r,needsIconsConfidence:A,componentsNeeded:a});try{await t.recordOrchestratorUserRequest({meta:{userIntent:r,componentsNeeded:a,_meta:y}})}catch(S){throw R(S)}return{content:[{type:"text",text:F({name:o,userIntent:r,includeComponentsDocs:!0,includeIcons:A>.5,codeAssistantName:c,iconAssistantName:s,suiteName:d,libKey:m,components:a})}]}})}function me(e,t){let{name:o,title:n,description:i,suiteName:s,libKey:c,getPreContent:d}=e;return new b(o,{title:n,description:i,requiredAccess:e.requiredAccess,inputSchema:{prompt:u.string().describe("An enhanced prompt describing the HTML layout structure, design requirements or specific visual effects you want to achieve."),includeBuildingBlockExamples:u.boolean().describe("Whether to include building block examples. Defaults to false.").default(!1)}},async({prompt:m,includeBuildingBlockExamples:h})=>{g("Layout Assistant called with:",{prompt:m,includeBuildingBlockExamples:h});try{let r=(await t.queryCssUtils({query:m})).values.join(`
|
|
461
407
|
`)||"No CSS utilities found for the given prompt.",A=d?.()??"",a=y=>`${A}
|
|
462
408
|
|
|
463
409
|
# Kendo Design System CSS Utilities
|
|
464
410
|
|
|
465
411
|
${r}
|
|
466
412
|
${y??""}
|
|
467
|
-
`;if(h)try{let y=await t.queryBuildingBlocks({query:
|
|
413
|
+
`;if(h)try{let y=await t.queryBuildingBlocks({query:m,lib_name:c}),T="";y.items?.length>0&&(T=`
|
|
468
414
|
## Building Blocks Examples
|
|
469
415
|
|
|
470
416
|
The examples here are for demonstration purpose how CSS utils can be implemented in various building blocks.
|
|
@@ -479,9 +425,9 @@ ${S.description}
|
|
|
479
425
|
${S.code}
|
|
480
426
|
\`\`\`
|
|
481
427
|
`).join(`
|
|
482
|
-
`)}`),r=a(T)}catch(y){g("Error calling building-blocks service:",y),r=a()}else r=a();return{content:[{type:"text",text:r}]}}catch(C){throw R(C)}})}function
|
|
428
|
+
`)}`),r=a(T)}catch(y){g("Error calling building-blocks service:",y),r=a()}else r=a();return{content:[{type:"text",text:r}]}}catch(C){throw R(C)}})}function ue(e,t){let{name:o,title:n,description:i,libKey:s,getPreContent:c}=e;return new b(o,{title:n,description:i,requiredAccess:e.requiredAccess,inputSchema:{prompt:u.string().describe("A natural language description of the desired visual style or theme. For example: 'Create a modern dark theme with high contrast'.")}},async({prompt:d})=>{g("Style Assistant called with:",{prompt:d});let m="";try{let r=await t.queryThemeGenerate({prompt:d});if(r.variables_json){let A=JSON.parse(r.variables_json),a=[];if(A)for(let y of Object.keys(A))typeof A[y]=="string"&&a.push(`${y}: ${A[y]}`);m=a.join(`
|
|
483
429
|
|
|
484
|
-
`)}}catch(r){throw R(r)}let h=c?.()??"";return{content:[{type:"text",text:
|
|
430
|
+
`)}}catch(r){throw R(r)}let h=c?.()??"";return{content:[{type:"text",text:m?`Use the following CSS variables to style the web application, including colors, typography, spacing, and component appearance.
|
|
485
431
|
Ensure the variables are applied consistently across all relevant elements.
|
|
486
432
|
Do NOT set any inline styles. CSS variables should be defined in global or component-level CSS files, or via supported theming mechanisms.
|
|
487
433
|
|
|
@@ -490,29 +436,29 @@ ${h}
|
|
|
490
436
|
## Generated CSS Variables
|
|
491
437
|
|
|
492
438
|
\`\`\`css
|
|
493
|
-
${
|
|
439
|
+
${m}
|
|
494
440
|
\`\`\`
|
|
495
|
-
`:"No CSS variables were generated for the given prompt."}]}})}function he(e,t){let{name:o,title:n,description:i,libKey:s,getPostContent:c}=e;return new b(o,{title:n,description:i,requiredAccess:e.requiredAccess,inputSchema:{query:
|
|
441
|
+
`:"No CSS variables were generated for the given prompt."}]}})}function he(e,t){let{name:o,title:n,description:i,libKey:s,getPostContent:c}=e;return new b(o,{title:n,description:i,requiredAccess:e.requiredAccess,inputSchema:{query:u.string().describe("A search query for finding icons. Be specific about the icon purpose, style, or action."),limit:u.number().min(.1).max(1).default(.1).describe("The proportion of matching icons to return (0.1 = 1 icon, 0.5 = 5 icons, 1.0 = many icons). Default is 0.1.")}},async({query:d,limit:m})=>{g("Icon Search called with:",{query:d,limit:m});try{let h=await t.queryIconsSearch({query:d,limit:m*100}),C=c?.()??"";return{content:[{type:"text",text:`${h.values.join(`
|
|
496
442
|
|
|
497
443
|
`)}
|
|
498
444
|
|
|
499
|
-
${C}`}]}}catch(h){throw R(h)}})}function ge(e,t){let{name:o,title:n,description:i,libKey:s,suiteName:c,components:d,componentAliases:
|
|
445
|
+
${C}`}]}}catch(h){throw R(h)}})}function ge(e,t){let{name:o,title:n,description:i,libKey:s,suiteName:c,components:d,componentAliases:m,getPostContent:h}=e;return new b(o,{title:n,description:i,requiredAccess:e.requiredAccess,inputSchema:{query:u.string().describe("The query to search for."),component:u.enum(d).describe("The component to search for. If not specified, use General.")}},async({query:C,component:r})=>{g("Code Assistant called with:",{query:C,component:r});let A=r;if(m){let a=m[r];a&&(A=a)}try{let y=(await t.query({query:C,component:A?.toLowerCase()??"general",lib_name:s,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]})).values.map(I=>I.replace(/\0/g,"")),T=h?.({component:r})??"";return{content:[{type:"text",text:`${y.join(`
|
|
500
446
|
|
|
501
447
|
`)}
|
|
502
448
|
|
|
503
|
-
${T}`}]}}catch(a){throw R(a)}})}function fe(e,t){let{name:o,title:n,description:i,libKey:s,suiteName:c,components:d,componentAliases:
|
|
449
|
+
${T}`}]}}catch(a){throw R(a)}})}function fe(e,t){let{name:o,title:n,description:i,libKey:s,suiteName:c,components:d,componentAliases:m}=e;return new b(o,{title:n,description:i,requiredAccess:e.requiredAccess,inputSchema:{query:u.string().describe("The query to search for."),component:u.enum(d).describe("The component to search for. If not specified, use General."),includeGeneralGuidelines:u.boolean().default(!1).describe("Set to true only on the first call to include comprehensive WCAG 2.2 Level AA general guidelines. After the first call, set to false to get only component-specific accessibility information. Default is false.")}},async({query:h,component:C,includeGeneralGuidelines:r})=>{g("Accessibility Assistant called with:",{query:h,component:C,includeGeneralGuidelines:r});let A=C;if(m){let a=m[C];a&&(A=a)}try{let a="";if(r){let I=ce();a+=`# WCAG 2.2 Level AA General Accessibility Guidelines
|
|
504
450
|
|
|
505
|
-
`,a+=
|
|
451
|
+
`,a+=I,a+=`
|
|
506
452
|
|
|
507
453
|
---
|
|
508
454
|
|
|
509
|
-
`}let S=(await t.query({query:h,component:A?.toLowerCase()??"general",lib_name:s,text_matches_count:3,code_matches_count:0,allowed_types:[""],filters_json:'{"type":{"$in":["accessibility"]}}'})).values.map(
|
|
455
|
+
`}let S=(await t.query({query:h,component:A?.toLowerCase()??"general",lib_name:s,text_matches_count:3,code_matches_count:0,allowed_types:[""],filters_json:'{"type":{"$in":["accessibility"]}}'})).values.map(I=>I.replace(/\0/g,"")).join(`
|
|
510
456
|
|
|
511
457
|
`);return S?(r&&(a+=`# Component-Specific Accessibility Information
|
|
512
458
|
|
|
513
459
|
`),a+=S):r||(a="No component-specific accessibility guidelines found."),{content:[{type:"text",text:a}]}}catch(a){throw R(a)}})}function R(e){let t=e;return t.code===16?new Error("Error: You are not authenticated. Please verify the Telerik License Key provided is valid."):t.code===8?new Error(`Error: You have exceeded the extension quota. Upgrade to subscription licensing to unlock full access. Message: ${t.message}.`):t.code===7?new Error("Error: You do not have permission to access this resource. Please verify that you have a valid license."):new Error(`Error: An error occurred while calling the service. Please try again later.
|
|
514
460
|
|
|
515
|
-
Error Code: ${t.code} Error Message: ${t.message}`)}var ye=e=>`${e}_ui_generator`,Ae=e=>`${e}_assistant`,Ce=e=>`${e}_layout_assistant`,Se=e=>`${e}_component_assistant`,be=e=>`${e}_style_assistant`,Te=e=>`${e}_icon_assistant`,
|
|
461
|
+
Error Code: ${t.code} Error Message: ${t.message}`)}var ye=e=>`${e}_ui_generator`,Ae=e=>`${e}_assistant`,Ce=e=>`${e}_layout_assistant`,Se=e=>`${e}_component_assistant`,be=e=>`${e}_style_assistant`,Te=e=>`${e}_icon_assistant`,ve=e=>`${e}_accessibility_assistant`;var Ie=e=>`This is the single entry point for all UI-related tasks. It orchestrates the full workflow of building or refining UIs with ${e} components, generating a step-by-step execution plan that specifies which tools to call, in what order, and with what parameters. It includes validation steps to ensure the best possible, standards-compliant code every time.
|
|
516
462
|
|
|
517
463
|
Use the tool when:
|
|
518
464
|
- Want to build or modify a complete page or section layout
|
|
@@ -648,7 +594,7 @@ ${W.THEME_AND_STYLING}
|
|
|
648
594
|
- Make sure theme import mechanism is consistent with existing project setup
|
|
649
595
|
|
|
650
596
|
Accessibility
|
|
651
|
-
- Accessibility guidelines retrieved and applied to all components`;var nt={createOrchestrator:de,createAssistantOrchestrator:pe,createLayoutAssistant:
|
|
597
|
+
- Accessibility guidelines retrieved and applied to all components`;var nt={createOrchestrator:de,createAssistantOrchestrator:pe,createLayoutAssistant:me,createStyleAssistant:ue,createIconSearch:he,createCodeAssistant:ge,createAccessibilityAssistant:fe},st={orchestrator:ye,assistantOrchestrator:Ae,layoutAssistant:Ce,codeAssistant:Se,styleAssistant:be,iconAssistant:Te,accessibilityAssistant:ve},it={orchestrator:Ie,assistantOrchestrator:Ne,layoutAssistant:Ee,styleAssistant:we,iconAssistant:Re,codeAssistant:ke,accessibilityAssistant:xe},at={Orchestrator:{render:O},Validator:{render:P},SharedValidation:{getSteps:w}},rt={Angular:{steps:V,additionalPlan:j},React:{steps:Y}},l={Tools:nt,ToolNames:st,ToolDescriptions:it,Templates:at,Validation:rt};var ct=l.ToolNames.codeAssistant("kendoreact"),Pe=()=>`# Kendo Design System Guidelines for ${p}
|
|
652
598
|
|
|
653
599
|
## Setting up Styles/CSS
|
|
654
600
|
|
|
@@ -862,4 +808,4 @@ Example: If someone asks about "grid", "GRID", or "GrId", you always refer to Da
|
|
|
862
808
|
## Component-Specific Guidelines
|
|
863
809
|
|
|
864
810
|
${e.componentInstructions}
|
|
865
|
-
`),t};var
|
|
811
|
+
`),t};var Me=l.ToolNames.layoutAssistant(E),H=l.ToolNames.codeAssistant(E),Ge=l.ToolNames.styleAssistant(E),z=l.ToolNames.iconAssistant(E),$e=l.ToolNames.accessibilityAssistant(E);function _e(e,t){return[l.Tools.createOrchestrator({name:l.ToolNames.orchestrator(E),title:"KendoReact Generator",description:l.ToolDescriptions.orchestrator(p),layoutAssistantName:Me,codeAssistantName:H,styleAssistantName:Ge,iconAssistantName:z,accessibilityAssistantName:$e,suiteName:p,libKey:v,components:x,requiredAccess:["agent"]},{validationSteps:l.Validation.React.steps},e),l.Tools.createAssistantOrchestrator({name:"kendo_react_assistant",title:"KendoReact Assistant",description:l.ToolDescriptions.assistantOrchestrator(p),codeAssistantName:H,iconAssistantName:z,suiteName:p,libKey:v,components:x,requiredAccess:["assistant"]},e),l.Tools.createLayoutAssistant({name:Me,title:"KendoReact Layout Assistant",description:l.ToolDescriptions.layoutAssistant,suiteName:p,libKey:v,getPreContent:Pe,requiredAccess:["agent"]},e),l.Tools.createStyleAssistant({name:Ge,title:"KendoReact Style Assistant",description:l.ToolDescriptions.styleAssistant,libKey:v,getPreContent:Oe,requiredAccess:["agent"]},e),l.Tools.createIconSearch({name:z,title:"KendoReact Icon Assistant",description:l.ToolDescriptions.iconAssistant,libKey:v,getPostContent:Le,requiredAccess:["assistant","agent"]},e),l.Tools.createCodeAssistant({name:H,title:"KendoReact Component Assistant",description:l.ToolDescriptions.codeAssistant(p),libKey:v,suiteName:p,components:x,componentAliases:{Grid:"DataGrid"},getPostContent:({component:n})=>Ue({component:n}),requiredAccess:["assistant","agent"]},e),l.Tools.createAccessibilityAssistant({name:$e,title:"KendoReact Accessibility Assistant",description:l.ToolDescriptions.accessibilityAssistant(p),libKey:v,suiteName:p,components:x,componentAliases:{Grid:"DataGrid"},requiredAccess:["agent"]},e)].filter(n=>n.hasAccess(t))}var ut=mt(import.meta.url),ht=Be.dirname(ut),gt=Be.resolve(ht,"../package.json"),ft=JSON.parse(pt.readFileSync(gt,"utf-8")),qe=new lt({name:"kendo-mcp",title:"Kendo MCP Server",version:ft.version});async function yt(){let e=new dt;g("Starting server... ");let t=await re(async()=>{let n=(await le())?.entitlement;return n?.Product?.Code||n?.product?.code});t!=="none"&&($.toolNameHeader=t==="agent"||t==="full"?"agent":"assistant",_e($,t).forEach(n=>n.register(qe))),await qe.connect(e)}yt();
|