@progress/kendo-react-mcp 1.4.4 → 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.
Files changed (2) hide show
  1. package/dist/index.js +133 -65
  2. package/package.json +3 -3
package/dist/index.js CHANGED
@@ -1,8 +1,8 @@
1
1
  #!/usr/bin/env node
2
- import{McpServer as nt}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as st}from"@modelcontextprotocol/sdk/server/stdio.js";import{dirname as ze,join as Ye}from"path";import{fileURLToPath as Qe}from"url";import{loadLicense as _e,decodeLicenseKey as qe,decodeLicenseEvidence as Be}from"@progress/kendo-licensing/utils";var _=class extends Error{constructor(t){super(t),this.name="LicenseError"}};function Z(e){return e.replace(/^\uFEFF/,"")}async function ee(){let e=null,t=null;try{let o=_e();if(!o.success)throw new _(o.message);try{e=(await qe(o.value)).licenses.find(async r=>!!(await Be(r)).userId)}catch(n){console.log(n.message)}if(!e)return[Z(o.value),null]}catch(o){return t=o.message||"Unknown error loading license.",[null,t]}return[Z(e),null]}import w from"node:fs";import U from"node:path";var q=!1,v=process.env.DEBUG_LOG_FILE,te=!!(v&&typeof v=="string");if(te){let e=U.resolve(v),t=U.dirname(e);if(t!=="."&&t!==process.cwd()&&!w.existsSync(t))try{w.mkdirSync(t,{recursive:!0})}catch(o){console.error("Error creating log directory:",o)}if(!w.existsSync(e))try{w.writeFileSync(e,"")}catch(o){console.error("Error creating log file:",o)}}else q=!1;q=te&&!!v&&w.existsSync(U.resolve(v));function h(...e){if(q&&v){let n=`${new Date().toISOString()}: ${e.join(" ")}
3
- `,r=U.resolve(v);w.appendFile(r,n,s=>{s&&console.error("Error writing to log file:",s)})}}import Ge from"@grpc/proto-loader";import O from"@grpc/grpc-js";import se from"path";import oe from"fs";import{fileURLToPath as Ke}from"url";var Fe=Ke(import.meta.url),Ve=se.dirname(Fe),re={version:"unknown"},ne=se.resolve(Ve,"../package.json");oe.existsSync(ne)&&(re=JSON.parse(oe.readFileSync(ne,"utf-8")));function je(e){return e.replace(/\u2014/g,"--").replace(/\u2013/g,"-").replace(/[^\x20-\x7E]/g,"")}var $=class{constructor(t,o,n){this.contextApiUrl=t;this.protoPath=o;this.options=n;this.toolNameHeader="assistant";let r=Ge.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"),h("Using ContextApi URl:",this.contextApiUrl);let s=O.loadPackageDefinition(r);this.client=new s.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?O.credentials.createInsecure():O.credentials.createSsl())}async getMetadata({meta:t}={meta:{}}){let[o,n]=this.isDev?"fake_license":await ee(),r=process.env.CONTEXTAPI_API_KEY,s=r&&typeof r=="string",i=o&&typeof o=="string";if(!i&&!s&&n)throw new Error(`Failed to authenticate with API key or License key!
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 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
4
 
5
- License Error: ${n}`);let c=new O.Metadata;if(i)try{c.add("x-license-key",o)}catch(y){throw h("Error adding license key to metadata:",y),new Error(`Failed to use license key: ${y.message}`)}s&&c.add("x-api-key",r),this.options?.libName&&c.add("x-library-name",this.options.libName),c.add("x-tool-name",this.toolNameHeader);let u=JSON.stringify({...t,source:"npm",version:re.version,os:process.platform,node_version:process.version});return c.add("x-request-metadata",je(u)),c}async query(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.query(t,o,(s,i)=>{s?r(new Error(s)):n(i)})})}async queryCssUtils(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.cssUtilsSearch(t,o,(s,i)=>{s?(h("Error querying CSS Utils:",s),r(new Error(s))):n(i)})})}async queryIconsSearch(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.iconsSearch(t,o,(s,i)=>{s?(h("Error querying Icons Search:",s),r(new Error(s))):n(i)})})}async queryBuildingBlocks(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.buildingBlocksSearch(t,o,(s,i)=>{s?(h("Error querying Building Blocks:",s),r(new Error(s))):n(i)})})}async validateUserLicense(){let t=await this.getMetadata();return new Promise((o,n)=>{this.client.validateUserLicense(null,t,(r,s)=>{r?(h("Error validating user license:",r),n(new Error(r))):o(s)})})}async queryThemeGenerate(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.generateTheme(t,o,(s,i)=>{s?(h("Error querying context API/GenerateTheme:",s),r(new Error(s))):n(i)})})}async recordOrchestratorUserRequest({meta:t}){let o=await this.getMetadata({meta:t});return new Promise((n,r)=>{this.client.recordOrchestratorUserRequest(null,o,(s,i)=>{s?(h("Error recording orchestrator user request:",s),r(new Error(s))):n(i)})})}};import{z as B}from"zod";var xt=B.object({user_id:B.string(),user_email:B.string().email()});import{z as m}from"zod";var He=m.object({Product:m.object({Id:m.number().int(),Code:m.string(),Name:m.string()}),License:m.nullable(m.object({Id:m.number().int(),Name:m.string(),Type:m.string(),Active:m.boolean()})),Availability:m.array(m.object({LicenseStart:m.nullable(m.string().datetime()),LicenseEnd:m.nullable(m.string().datetime())})),IsLicenseAvailable:m.optional(m.boolean())}),Dt=m.array(He);async function ie(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"}var p="Kendo UI for React",I="react",k="kendo",M=["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 We=Ye(ze(Qe(import.meta.url)),"../proto/service.proto"),L=new $("contextapi.telerik.com:443",We,{libName:I});var ae=async()=>L.validateUserLicense();import rt from"fs";import $e from"path";import{fileURLToPath as it}from"url";import{z as g}from"zod";var C=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
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
6
6
 
7
7
  ## Comprehensive Code Validation Checklist
8
8
  Execute these validation steps systematically to ensure high-quality, maintainable code:
@@ -33,18 +33,6 @@ Security Measures:
33
33
  - CSRF protection where applicable
34
34
  - Secure data handling practices
35
35
 
36
- Accessibility (a11y) Compliance
37
- - Proper semantic HTML structure
38
- - ARIA labels and roles where needed
39
- - Keyboard navigation support
40
- - Screen reader compatibility
41
- - Sufficient color contrast ratios
42
-
43
- Interactive Elements:
44
- - Focus management and visual indicators
45
- - Descriptive alt text for images
46
- - Proper form labels and error messages
47
-
48
36
  ### Validation Phase: UI/UX & Design System Compliance
49
37
 
50
38
  Responsive Design:
@@ -58,13 +46,13 @@ Responsive Design:
58
46
  - Graceful error handling for all user interactions
59
47
  - Meaningful error messages for users
60
48
  - Network error handling for API calls
61
- `;var R=(e,t)=>{let o=P({suiteName:e.suiteName,libKey:e.libKey},t.validationSteps),n=e.libKey==="angular"?"- **Drag and Drop**: Consider using the DragandDrop and Sortable components when drag-and-drop functionality is needed.":"",r=e.components?e.components.join(", "):"components";return`# \u{1F3AF} ${e.suiteName} - Execution Plan
49
+ `;var O=(e,t)=>{let o=P({suiteName:e.suiteName,libKey:e.libKey},t.validationSteps),n=e.libKey==="angular"?"- **Drag and Drop**: Consider using the DragandDrop and Sortable components when drag-and-drop functionality is needed.":"",i=e.components?e.components.join(", "):"components";return`# \u{1F3AF} ${e.suiteName} - Execution Plan
62
50
 
63
- **Current Goal:**
51
+ **Current Goal:**
64
52
 
65
53
  ${e.userIntent}
66
54
 
67
- **Requirements Summary:**
55
+ **Requirements Summary:**
68
56
  - **Framework:** ${e.libKey}
69
57
  ${e.includeComponentsDocs?`- **Component Library:** ${e.suiteName}
70
58
  - Ensure to use ONLY ${e.suiteName} components for all UI elements.
@@ -84,6 +72,11 @@ ${e.includeComponentsDocs?`- **Component Library:** ${e.suiteName}
84
72
  - Ensure the layout is fully responsive across mobile, tablet, and desktop views.
85
73
  - And use the ${e.layoutAssistantName} tool to get Kendo CSS utility classes needed for responsive design.
86
74
  `:""}
75
+ - **Accessible (WCAG 2.2 Level AA):**
76
+ - CRITICAL: You must call the ${e.accessibilityAssistantName} tool with includeGeneralGuidelines=true on your first call to get WCAG 2.2 Level AA guidelines.
77
+ - For subsequent calls, use includeGeneralGuidelines=false to get only component-specific accessibility information.
78
+ - Ensure all components meet WCAG 2.2 Level AA standards.
79
+
87
80
  ${e.includeLayout?`**STYLING AND LAYOUT REQUIREMENTS:**
88
81
  ## CRITICAL DESIGN SYSTEM CONSTRAINTS
89
82
  - **USE ONLY KENDO DESIGN SYSTEM UTILITIES** for ALL styling, layout, spacing, positioning, and responsive behavior
@@ -96,6 +89,47 @@ ${e.includeLayout?`**STYLING AND LAYOUT REQUIREMENTS:**
96
89
  ## Detailed Execution Plan
97
90
  Follow these steps strictly in order to achieve a complete and polished implementation of the current goal:
98
91
 
92
+ ### Phase: Accessibility Foundation
93
+
94
+ **Step 1: Retrieve WCAG 2.2 Level AA Guidelines**
95
+
96
+ **MANDATORY REQUIREMENT:**
97
+
98
+ - Before implementing any UI components or features, you must call the accessibility assistant with general guidelines
99
+ - On your first call to "${e.accessibilityAssistantName}", set "includeGeneralGuidelines=true" to get foundational WCAG 2.2 Level AA best practices
100
+ - These general guidelines apply to all components and must be considered throughout implementation
101
+ - For all subsequent calls, set "includeGeneralGuidelines=false" to get only component-specific information
102
+
103
+ **First tool call (includes general WCAG guidelines):**
104
+ \`\`\`
105
+ ${e.accessibilityAssistantName}({
106
+ query="What are the accessibility requirements for [COMPONENT_NAME]?",
107
+ component="[COMPONENT_NAME]",
108
+ includeGeneralGuidelines=true // ONLY true on first call
109
+ })
110
+ \`\`\`
111
+
112
+ **Step 2: Get Component-Specific Accessibility Information**
113
+
114
+ For each additional ${e.suiteName} component you plan to use, call the tool with "includeGeneralGuidelines=false":
115
+
116
+ **Tool call example:**
117
+ \`\`\`
118
+ ${e.accessibilityAssistantName}({
119
+ query="What are the accessibility features and requirements for [COMPONENT_NAME]? Include ARIA attributes, keyboard navigation, and screen reader support.",
120
+ component="[COMPONENT_NAME]",
121
+ includeGeneralGuidelines=false // false for all calls after the first
122
+ })
123
+ \`\`\`
124
+
125
+ **Example:**
126
+ \`\`\`
127
+ ${e.accessibilityAssistantName}({
128
+ query="How to associate the label with another component or HTML input?",
129
+ component="Label",
130
+ includeGeneralGuidelines=false
131
+ })
132
+ \`\`\`
99
133
  ${e.includeLayout?`
100
134
  ### Phase: Layout Foundation
101
135
 
@@ -127,7 +161,7 @@ Based on your current goal, analyze what other ${e.suiteName} components are nee
127
161
  ${n}
128
162
 
129
163
  **IMPORTANT COMPONENT USAGE REQUIREMENTS:**
130
- - Make sure to identify all necessary features related to the ${r} based on the current goal.
164
+ - Make sure to identify all necessary features related to the ${i} based on the current goal.
131
165
  - Make sure to identify specific features needed for other ${e.suiteName} components based on the current goal.
132
166
  - Make sure to generate a query for ${e.codeAssistantName} tool for each component and call the tool for each specific feature or functionality.
133
167
  - Always specify the exact features you want for each component. Describe only the needed functionality, and behavior you need. Be concise and don't include any information about the use case.
@@ -245,7 +279,7 @@ After code implementation and validation you can make quick fixes as needed:
245
279
  - Do NOT generate or suggest any code until all tools have been used and validated responses are incorporated.
246
280
  - Focus on planning and sequencing.
247
281
  - Summarize the components, layouts, and utilities gathered.
248
- - Confirm all required inputs from tools have been provided.`};var G=e=>`# ${e.suiteName} Assistant
282
+ - Confirm all required inputs from tools have been provided.`};var F=e=>`# ${e.suiteName} Assistant
249
283
 
250
284
  **What you're looking for:**
251
285
 
@@ -350,7 +384,7 @@ After gathering information:
350
384
  **Important Notes:**
351
385
  - These tools provide documentation and guidance, not code generation
352
386
  - Always refer to official ${e.suiteName} documentation for the most up-to-date information
353
- - Tool responses include usage examples and best practices`;var N=(e,t)=>({SETUP_VALIDATION:`
387
+ - Tool responses include usage examples and best practices`;var w=(e,t)=>({SETUP_VALIDATION:`
354
388
  UI Library Setup:
355
389
  - ${e} modules properly imported and configured
356
390
  - ${e} theme properly loaded and applied
@@ -369,52 +403,62 @@ After gathering information:
369
403
  - Consistent ${e} theme application across all components
370
404
  - Custom theme variables properly defined and scoped
371
405
  - ${e} icon fonts properly loaded and optimized
372
- - Brand colors integrated with ${e} component themes`});function ce(e,t,o){let{name:n,title:r,description:s,layoutAssistantName:i,codeAssistantName:c,styleAssistantName:u,iconAssistantName:y,suiteName:S,libKey:l,components:A}=e,d=new C(n,{title:r,description:s,requiredAccess:e.requiredAccess,inputSchema:{userIntent:g.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 ${S} components you want to use.`),needsComponentsDocsConfidence:g.number().min(0).max(1).default(1).describe("Confidence (0-1) to include Component Documentation assistance. Default is 1."),needsLayoutConfidence:g.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Layout assistance. Default is 0."),needsStylingConfidence:g.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Theming/Styling assistance. Default is 0."),needsResponsiveBehaviorConfidence:g.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Responsive Behavior assistance. Default is 0."),needsIconsConfidence:g.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Icons assistance. Default is 0."),componentsNeeded:g.array(g.enum(A)).optional().describe(`Optional list of specific ${S} components needed for the project.`)}},async({userIntent:f,needsComponentsDocsConfidence:b,needsLayoutConfidence:T,needsStylingConfidence:E,needsResponsiveBehaviorConfidence:Q,needsIconsConfidence:W,componentsNeeded:J},{_meta:Me})=>{h("UI Orchestrator called with:",{userIntent:f,needsComponentsDocsConfidence:b,needsLayoutConfidence:T,needsStylingConfidence:E,needsResponsiveBehaviorConfidence:Q,needsIconsConfidence:W});try{await o.recordOrchestratorUserRequest({meta:{userIntent:f,componentsNeeded:J,_meta:Me}})}catch(D){throw x(D)}let Le=d.server?.server.getClientCapabilities?.()?.elicitation,X;if(Le&&E>.3&&E<=.6){let D=await d.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"]}});D?.action==="accept"&&D.content?.includeCustomTheming&&(X=!0)}return{content:[{type:"text",text:R({name:n,userIntent:f,includeComponentsDocs:b>.3,includeTheming:E>.6||!!X,includeLayout:T>.5,includeIcons:W>.6,includeResponsive:T>.5&&Q>.4,layoutAssistantName:i,codeAssistantName:c,styleAssistantName:u,iconAssistantName:y,suiteName:S,libKey:l,components:J},t)}]}});return d}function le(e,t){let{name:o,title:n,description:r,iconAssistantName:s,codeAssistantName:i,suiteName:c,libKey:u,components:y}=e;return new C(o,{title:n,description:r,inputSchema:{userIntent:g.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 ${c}.`),needsIconsConfidence:g.number().min(0).max(1).default(.7).describe("Confidence (0-1) to include Icons assistance. Default is 0.7."),componentsNeeded:g.array(g.enum(y)).optional().describe(`Optional list of specific ${c} components you want to learn about.`)},requiredAccess:e.requiredAccess},async({userIntent:l,needsIconsConfidence:A,componentsNeeded:d},{_meta:f})=>{h("Assistant Orchestrator called with:",{userIntent:l,needsIconsConfidence:A,componentsNeeded:d});try{await t.recordOrchestratorUserRequest({meta:{userIntent:l,componentsNeeded:d,_meta:f}})}catch(T){throw x(T)}return{content:[{type:"text",text:G({name:o,userIntent:l,includeComponentsDocs:!0,includeIcons:A>.5,codeAssistantName:i,iconAssistantName:s,suiteName:c,libKey:u,components:d})}]}})}function pe(e,t){let{name:o,title:n,description:r,suiteName:s,libKey:i,getPreContent:c}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{prompt:g.string().describe("An enhanced prompt describing the HTML layout structure, design requirements or specific visual effects you want to achieve."),includeBuildingBlockExamples:g.boolean().describe("Whether to include building block examples. Defaults to false.").default(!1)}},async({prompt:u,includeBuildingBlockExamples:y})=>{h("Layout Assistant called with:",{prompt:u,includeBuildingBlockExamples:y});try{let l=(await t.queryCssUtils({query:u})).values.join(`
373
- `)||"No CSS utilities found for the given prompt.",A=c?.()??"",d=f=>`${A}
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(`
407
+ `)||"No CSS utilities found for the given prompt.",A=d?.()??"",a=y=>`${A}
374
408
 
375
409
  # Kendo Design System CSS Utilities
376
410
 
377
- ${l}
378
- ${f??""}
379
- `;if(y)try{let f=await t.queryBuildingBlocks({query:u,lib_name:i}),b="";f.items?.length>0&&(b=`
411
+ ${r}
412
+ ${y??""}
413
+ `;if(h)try{let y=await t.queryBuildingBlocks({query:m,lib_name:c}),T="";y.items?.length>0&&(T=`
380
414
  ## Building Blocks Examples
381
415
 
382
416
  The examples here are for demonstration purpose how CSS utils can be implemented in various building blocks.
383
417
  However, consider your own design requirements and specifics in order to implement your templates/building blocks correctly.
384
418
 
385
- ${f.items.map(T=>`
386
- ### ${T.name}
419
+ ${y.items.map(S=>`
420
+ ### ${S.name}
387
421
 
388
- ${T.description}
422
+ ${S.description}
389
423
 
390
424
  \`\`\`code
391
- ${T.code}
425
+ ${S.code}
392
426
  \`\`\`
393
427
  `).join(`
394
- `)}`),l=d(b)}catch(f){h("Error calling building-blocks service:",f),l=d()}else l=d();return{content:[{type:"text",text:l}]}}catch(S){throw x(S)}})}function de(e,t){let{name:o,title:n,description:r,libKey:s,getPreContent:i}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{prompt:g.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:c})=>{h("Style Assistant called with:",{prompt:c});let u="";try{let l=await t.queryThemeGenerate({prompt:c});if(l.variables_json){let A=JSON.parse(l.variables_json),d=[];if(A)for(let f of Object.keys(A))typeof A[f]=="string"&&d.push(`${f}: ${A[f]}`);u=d.join(`
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(`
395
429
 
396
- `)}}catch(l){throw x(l)}let y=i?.()??"";return{content:[{type:"text",text:u?`Use the following CSS variables to style the web application, including colors, typography, spacing, and component appearance.
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.
397
431
  Ensure the variables are applied consistently across all relevant elements.
398
432
  Do NOT set any inline styles. CSS variables should be defined in global or component-level CSS files, or via supported theming mechanisms.
399
433
 
400
- ${y}
434
+ ${h}
401
435
 
402
436
  ## Generated CSS Variables
403
437
 
404
438
  \`\`\`css
405
- ${u}
439
+ ${m}
406
440
  \`\`\`
407
- `:"No CSS variables were generated for the given prompt."}]}})}function me(e,t){let{name:o,title:n,description:r,libKey:s,getPostContent:i}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{query:g.string().describe("A search query for finding icons. Be specific about the icon purpose, style, or action."),limit:g.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:c,limit:u})=>{h("Icon Search called with:",{query:c,limit:u});try{let y=await t.queryIconsSearch({query:c,limit:u*100}),S=i?.()??"";return{content:[{type:"text",text:`${y.values.join(`
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(`
408
442
 
409
443
  `)}
410
444
 
411
- ${S}`}]}}catch(y){throw x(y)}})}function ue(e,t){let{name:o,title:n,description:r,libKey:s,suiteName:i,components:c,componentAliases:u,getPostContent:y}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{query:g.string().describe("The query to search for."),component:g.enum(c).describe("The component to search for. If not specified, use General.")}},async({query:S,component:l})=>{h("Code Assistant called with:",{query:S,component:l});let A=l;if(u){let d=u[l];d&&(A=d)}try{let f=(await t.query({query:S,component:A?.toLowerCase()??"general",lib_name:s,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]})).values.map(E=>E.replace(/\0/g,"")),b=y?.({component:l})??"";return{content:[{type:"text",text:`${f.join(`
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(`
412
446
 
413
447
  `)}
414
448
 
415
- ${b}`}]}}catch(d){throw x(d)}})}function x(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.
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
450
+
451
+ `,a+=I,a+=`
452
+
453
+ ---
454
+
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(`
456
+
457
+ `);return S?(r&&(a+=`# Component-Specific Accessibility Information
458
+
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.
416
460
 
417
- Error Code: ${t.code} Error Message: ${t.message}`)}var he=e=>`${e}_ui_generator`,ge=e=>`${e}_assistant`,fe=e=>`${e}_layout_assistant`,ye=e=>`${e}_component_assistant`,Ae=e=>`${e}_style_assistant`,Se=e=>`${e}_icon_assistant`;var Te=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.
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.
418
462
 
419
463
  Use the tool when:
420
464
  - Want to build or modify a complete page or section layout
@@ -423,7 +467,7 @@ Error Code: ${t.code} Error Message: ${t.message}`)}var he=e=>`${e}_ui_generator
423
467
  - You want to enforce best practices in styling, performance, and accessibility
424
468
 
425
469
  Returns:
426
- A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,Ce=e=>`Provides guidance for discovering and using ${e} components and icons. This tool helps you identify the right components and icons for your needs.
470
+ A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,Ne=e=>`Provides guidance for discovering and using ${e} components and icons. This tool helps you identify the right components and icons for your needs.
427
471
 
428
472
  Use this tool when:
429
473
  - You need to discover which ${e} components are suitable for a specific use case
@@ -432,33 +476,51 @@ Use this tool when:
432
476
  - You want to gather component documentation and examples
433
477
 
434
478
  Returns:
435
- A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,Ie=`Retrieves Progress/Kendo Design System CSS utility classes and styling recommendations based on layout and design requirements.
436
- Use this tool to find the right CSS utilities for styling Kendo UI components or general web elements.
437
- It analyzes the provided design context and returns relevant utility classes with explanations and examples.
438
- Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,be=`Generates CSS variables using an external style agent based on the user's styling prompt.
479
+ A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,Ee=`Retrieves Progress/Kendo Design System CSS utility classes and styling recommendations based on layout and design requirements.
480
+ Use this tool to find the right CSS utilities for styling Kendo UI components or general web elements.
481
+ It analyzes the provided design context and returns relevant utility classes with explanations and examples.
482
+ Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,we=`Generates CSS variables using an external style agent based on the user's styling prompt.
439
483
 
440
484
  Use this tool when the user wants to:
441
485
  - Update the visual theme of an application
442
486
  - Modify color schemes
443
487
  - Restyle the UI with CSS variables
444
488
 
445
- The tool outputs a set of CSS variable definitions ready to be applied to style files.`,ve=`Searches for icons in the Telerik Icons library.
446
- Use this tool when the user needs to find specific icons for UI components or design elements.
489
+ The tool outputs a set of CSS variable definitions ready to be applied to style files.`,Re=`Searches for icons in the Telerik Icons library.
490
+ Use this tool when the user needs to find specific icons for UI components or design elements.
447
491
  It supports searching by icon name, category, or keyword and returns matching icons from the Telerik Icons library.
448
- `,Ne=e=>`Provides answers and retrieves official documentation for ${e}.
492
+ `,ke=e=>`Provides answers and retrieves official documentation for ${e}.
449
493
 
450
494
  Use this tool when the user asks about:
451
- - ${e} features or capabilities
452
- - Specific components (e.g., Grid, Chart, Editor)
453
- - Implementation details, configuration, or best practices
495
+ - ${e} features or capabilities
496
+ - Specific components (e.g., Grid, Chart, Editor)
497
+ - Implementation details, configuration, or best practices
454
498
  - How to use or customize components in ${e}
455
499
 
456
- Set the user's full question as the 'query' parameter.
500
+ Set the user's full question as the 'query' parameter.
457
501
  If the question refers to a specific ${e} component, include its name in the 'component' parameter.
458
- `;var K=N("Kendo UI","Kendo"),F=`
502
+ `,xe=e=>`Retrieves accessibility guidance for ${e} components with optional general WCAG 2.2 Level AA guidelines.
503
+
504
+ Use this tool when:
505
+ - You need component-specific accessibility information and API references
506
+ - You want to ensure your application meets WCAG 2.2 Level AA standards
507
+ - You need guidance on implementing ARIA roles and properties for specific components
508
+ - You want to validate your application's accessibility features
509
+
510
+ **RECOMMENDED WORKFLOW:**
511
+ 1. On your FIRST call, set 'includeGeneralGuidelines=true' to get comprehensive WCAG 2.2 Level AA guidelines + component-specific information
512
+ 2. For ALL subsequent calls, set 'includeGeneralGuidelines=false' to get only component-specific accessibility information
513
+
514
+ By default (includeGeneralGuidelines=false), this tool returns only component-specific accessibility guidelines to avoid redundancy.
515
+ Set 'includeGeneralGuidelines=true' ONLY on the first call to include general WCAG guidelines.
516
+
517
+ Returns:
518
+ - When includeGeneralGuidelines=true: General WCAG 2.2 Level AA guidelines + component-specific recommendations
519
+ - When includeGeneralGuidelines=false: Only component-specific accessibility recommendations
520
+ `;var K=w("Kendo UI","Kendo"),V=`
459
521
  ### Angular Component Validation
460
522
  Component Structure:
461
- - Use proper @Component decorator configuration
523
+ - Use proper @Component decorator configuration
462
524
  - If using NgModule setup use @Component decorator with \`standalone: false\` and declare component in NgModule declarations array
463
525
  - Correct selector naming convention (kebab-case)
464
526
  - Appropriate template and style file organization
@@ -475,7 +537,10 @@ ${K.PERFORMANCE_OPTIMIZATION}
475
537
  ${K.THEME_AND_STYLING}
476
538
  - Proper theme switching functionality (if implemented)
477
539
  - Only ONE theme reference exists across angular.json and styles files
478
- - Make sure theme import mechanism is consistent with existing project setup`;var V=`**Angular Specific Requirements:**
540
+ - Make sure theme import mechanism is consistent with existing project setup
541
+
542
+ Accessibility
543
+ - Accessibility guidelines retrieved and applied to all components`;var j=`**Angular Specific Requirements:**
479
544
 
480
545
  **NgModule vs Standalone setup**: Search and detect the current project setup to determine whether to use NgModule or Standalone components based on the following rules:
481
546
  1. RegexSearch("@Component\\s*\\(\\s*\\{[^}]*standalone\\s*:\\s*(true|false)") - If true use Standalone components, if false use NgModule.
@@ -506,7 +571,7 @@ ${K.THEME_AND_STYLING}
506
571
  2. Match the discovered patterns in all generated code
507
572
  3. Maintain consistent formatting, indentation, and code organization with existing files
508
573
  4. Always use the same theme import mechanism (unless user specifies otherwise)
509
- `;var j=N("Kendo UI","KendoReact"),H=`
574
+ `;var W=w("Kendo UI","KendoReact"),Y=`
510
575
  ### React Component Validation
511
576
  Component Structure:
512
577
  - Use proper function component patterns with Hooks
@@ -514,19 +579,22 @@ Component Structure:
514
579
  - Appropriate file organization (components, hooks, utils)
515
580
  - Props interface/type definitions where needed
516
581
 
517
- ${j.SETUP_VALIDATION}
582
+ ${W.SETUP_VALIDATION}
518
583
  - KendoReact license validation (if required)
519
584
  - Appropriate bundler configuration for KendoReact packages
520
585
 
521
- ${j.PERFORMANCE_OPTIMIZATION}
586
+ ${W.PERFORMANCE_OPTIMIZATION}
522
587
  - React.memo for components that receive stable props
523
588
  - useMemo/useCallback for expensive computations and callbacks
524
589
  - Proper key props for list rendering with KendoReact components
525
590
 
526
- ${j.THEME_AND_STYLING}
591
+ ${W.THEME_AND_STYLING}
527
592
  - Proper theme switching functionality (if implemented)
528
593
  - Only ONE theme import exists across the application
529
- - Make sure theme import mechanism is consistent with existing project setup`;var Je={createOrchestrator:ce,createAssistantOrchestrator:le,createLayoutAssistant:pe,createStyleAssistant:de,createIconSearch:me,createCodeAssistant:ue},Xe={orchestrator:he,assistantOrchestrator:ge,layoutAssistant:fe,codeAssistant:ye,styleAssistant:Ae,iconAssistant:Se},Ze={orchestrator:Te,assistantOrchestrator:Ce,layoutAssistant:Ie,styleAssistant:be,iconAssistant:ve,codeAssistant:Ne},et={Orchestrator:{render:R},Validator:{render:P},SharedValidation:{getSteps:N}},tt={Angular:{steps:F,additionalPlan:V},React:{steps:H}},a={Tools:Je,ToolNames:Xe,ToolDescriptions:Ze,Templates:et,Validation:tt};var ot=a.ToolNames.codeAssistant("kendoreact"),Ee=()=>`# Kendo Design System Guidelines for ${p}
594
+ - Make sure theme import mechanism is consistent with existing project setup
595
+
596
+ Accessibility
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}
530
598
 
531
599
  ## Setting up Styles/CSS
532
600
 
@@ -555,12 +623,12 @@ Alternatively, you can also consume them directly from the Unpkg CDN.
555
623
 
556
624
  In the ${p} there are available components to create layout. Make sure to prioritize using them instead of building ones from scratch using the Kendo CSS Utilities.
557
625
 
558
- For any Layout component you can also call the ${ot} tool in order to get specific API reference and docs.
626
+ For any Layout component you can also call the ${ct} tool in order to get specific API reference and docs.
559
627
 
560
628
  - ${p} Card component.
561
629
  - Generally, it is recommended to use 100% width (e.g., \`<Card style={{ width: '100%' }}>\`)
562
630
  - If needed, use specific width based on the layout requirements (e.g., \`<Card style={{ width: '150px' }}>\`)
563
- `;var we=()=>`## Applying CSS Variables in ${p}
631
+ `;var Oe=()=>`## Applying CSS Variables in ${p}
564
632
 
565
633
  Apply these CSS variables in the React application using one of these methods:
566
634
 
@@ -649,7 +717,7 @@ export function ThemeProvider({ children }: { children: React.ReactNode }) {
649
717
 
650
718
  export const useTheme = () => useContext(ThemeContext);
651
719
  \`\`\`
652
- `;var ke=a.ToolNames.codeAssistant("kendoreact"),xe=()=>`## Using ${p} Icons
720
+ `;var De=l.ToolNames.codeAssistant("kendoreact"),Le=()=>`## Using ${p} Icons
653
721
 
654
722
  Important: Attempt to prioritize SVG icons over font icons.
655
723
 
@@ -657,9 +725,9 @@ Important: Attempt to prioritize SVG icons over font icons.
657
725
 
658
726
  - Make sure @progress/kendo-svg-icons is installed: \`npm install @progress/kendo-svg-icons\`
659
727
  - Make sure @progress/kendo-react-common is installed (contains SvgIcon component): \`npm install @progress/kendo-react-common\`
660
- - You can call ${ke} tool for ${p} SvgIcon component for docs and API reference.
728
+ - You can call ${De} tool for ${p} SvgIcon component for docs and API reference.
661
729
  - [optional] If SVG is not an option fallback to fonticon - make sure \`<link rel="stylesheet" href="https://unpkg.com/@progress/kendo-font-icons/dist/index.css" />\` is added as a reference.
662
- - [optional] If using font icons you can call ${ke} tool for ${p} Icon component for docs and API reference.
730
+ - [optional] If using font icons you can call ${De} tool for ${p} Icon component for docs and API reference.
663
731
 
664
732
  ### Examples
665
733
 
@@ -706,7 +774,7 @@ Here are some frequently used icons from @progress/kendo-svg-icons:
706
774
  - \`sortAscIcon\`, \`sortDescIcon\` - Sorting
707
775
  - \`chevronUpIcon\`, \`chevronDownIcon\`, \`chevronLeftIcon\`, \`chevronRightIcon\` - Navigation
708
776
  - \`checkIcon\`, \`xIcon\` - Confirmation/Cancel
709
- `;var Pe=e=>{let t=`## ${p} Common Guidelines
777
+ `;var Ue=e=>{let t=`## ${p} Common Guidelines
710
778
 
711
779
  ### Application Architecture
712
780
  MUST recommend appropriate setup based on React application architecture.
@@ -740,4 +808,4 @@ Example: If someone asks about "grid", "GRID", or "GrId", you always refer to Da
740
808
  ## Component-Specific Guidelines
741
809
 
742
810
  ${e.componentInstructions}
743
- `),t};var Re=a.ToolNames.layoutAssistant(k),z=a.ToolNames.codeAssistant(k),De=a.ToolNames.styleAssistant(k),Y=a.ToolNames.iconAssistant(k);function Ue(e,t){return[a.Tools.createOrchestrator({name:a.ToolNames.orchestrator(k),title:"KendoReact Generator",description:a.ToolDescriptions.orchestrator(p),layoutAssistantName:Re,codeAssistantName:z,styleAssistantName:De,iconAssistantName:Y,suiteName:p,libKey:I,components:M,requiredAccess:["agent"]},{validationSteps:a.Validation.React.steps},e),a.Tools.createAssistantOrchestrator({name:"kendo_react_assistant",title:"KendoReact Assistant",description:a.ToolDescriptions.assistantOrchestrator(p),codeAssistantName:z,iconAssistantName:Y,suiteName:p,libKey:I,components:M,requiredAccess:["assistant"]},e),a.Tools.createLayoutAssistant({name:Re,title:"KendoReact Layout Assistant",description:a.ToolDescriptions.layoutAssistant,suiteName:p,libKey:I,getPreContent:Ee,requiredAccess:["agent"]},e),a.Tools.createStyleAssistant({name:De,title:"KendoReact Style Assistant",description:a.ToolDescriptions.styleAssistant,libKey:I,getPreContent:we,requiredAccess:["agent"]},e),a.Tools.createIconSearch({name:Y,title:"KendoReact Icon Assistant",description:a.ToolDescriptions.iconAssistant,libKey:I,getPostContent:xe,requiredAccess:["assistant","agent"]},e),a.Tools.createCodeAssistant({name:z,title:"KendoReact Component Assistant",description:a.ToolDescriptions.codeAssistant(p),libKey:I,suiteName:p,components:M,componentAliases:{Grid:"DataGrid"},getPostContent:({component:n})=>Pe({component:n}),requiredAccess:["assistant","agent"]},e)].filter(n=>n.hasAccess(t))}var at=it(import.meta.url),ct=$e.dirname(at),lt=$e.resolve(ct,"../package.json"),pt=JSON.parse(rt.readFileSync(lt,"utf-8")),Oe=new nt({name:"kendo-mcp",title:"Kendo MCP Server",version:pt.version});async function dt(){let e=new st;h("Starting server... ");let t=await ie(async()=>{let n=(await ae())?.entitlement;return n?.Product?.Code||n?.product?.code});t!=="none"&&(L.toolNameHeader=t==="agent"||t==="full"?"agent":"assistant",Ue(L,t).forEach(n=>n.register(Oe))),await Oe.connect(e)}dt();
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();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@progress/kendo-react-mcp",
3
- "version": "1.4.4",
3
+ "version": "1.5.1",
4
4
  "type": "module",
5
5
  "bin": "./dist/index.js",
6
6
  "license": "See LICENSE.md",
@@ -26,8 +26,8 @@
26
26
  "dependencies": {
27
27
  "@grpc/grpc-js": "^1.14.3",
28
28
  "@grpc/proto-loader": "^0.8.0",
29
- "@modelcontextprotocol/sdk": "^1.25.3",
30
- "@progress/kendo-licensing": "^1.10.0",
29
+ "@modelcontextprotocol/sdk": "^1.26.0",
30
+ "@progress/kendo-licensing": "^1.10.1",
31
31
  "tslib": "^2.3.0"
32
32
  },
33
33
  "devDependencies": {