@progress/kendo-angular-mcp 1.3.5 → 1.4.0
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 +191 -69
- package/package.json +3 -3
package/dist/index.js
CHANGED
|
@@ -1,8 +1,62 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{McpServer as
|
|
3
|
-
`,r=
|
|
4
|
-
|
|
5
|
-
License Error: ${n}`);let l=new D.Metadata;if(a)try{l.add("x-license-key",o)}catch(y){throw g("Error adding license key to metadata:",y),new Error(`Failed to use license key: ${y.message}`)}s&&l.add("x-api-key",r),this.options?.libName&&l.add("x-library-name",this.options.libName),l.add("x-tool-name",this.toolNameHeader);let m=JSON.stringify({...t,source:"npm",version:re.version,os:process.platform,node_version:process.version});return l.add("x-request-metadata",ze(m)),l}async query(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.query(t,o,(s,a)=>{s?r(new Error(s)):n(a)})})}async queryCssUtils(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.cssUtilsSearch(t,o,(s,a)=>{s?(g("Error querying CSS Utils:",s),r(new Error(s))):n(a)})})}async queryIconsSearch(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.iconsSearch(t,o,(s,a)=>{s?(g("Error querying Icons Search:",s),r(new Error(s))):n(a)})})}async queryBuildingBlocks(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.buildingBlocksSearch(t,o,(s,a)=>{s?(g("Error querying Building Blocks:",s),r(new Error(s))):n(a)})})}async validateUserLicense(){let t=await this.getMetadata();return new Promise((o,n)=>{this.client.validateUserLicense(null,t,(r,s)=>{r?(g("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,a)=>{s?(g("Error querying context API/GenerateTheme:",s),r(new Error(s))):n(a)})})}async recordOrchestratorUserRequest({meta:t}){let o=await this.getMetadata({meta:t});return new Promise((n,r)=>{this.client.recordOrchestratorUserRequest(null,o,(s,a)=>{s?(g("Error recording orchestrator user request:",s),r(new Error(s))):n(a)})})}};import{z as B}from"zod";var Pt=B.object({user_id:B.string(),user_email:B.string().email()});import{z as u}from"zod";var Ye=u.object({Product:u.object({Id:u.number().int(),Code:u.string(),Name:u.string()}),License:u.nullable(u.object({Id:u.number().int(),Name:u.string(),Type:u.string(),Active:u.boolean()})),Availability:u.array(u.object({LicenseStart:u.nullable(u.string().datetime()),LicenseEnd:u.nullable(u.string().datetime())})),IsLicenseAvailable:u.optional(u.boolean())}),Rt=u.array(Ye);async function ae(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 Angular",b="angular",E="kendo",_=["AIPrompt","ActionSheet","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","BreadCrumb","Button","ButtonGroup","Calendar","Card","ChartWizard","Charts","CheckBox","Chip","ChipList","ChunkProgressBar","CircularGauge","CircularProgressBar","ColorGradient","ColorPalette","ColorPicker","ComboBox","ContextMenu","ConversationalUI","DataQuery","DateInput","DateMath","DatePicker","DateRange","DateTimePicker","Diagram","Dialog","DragandDrop","Drawer","Drawing","DropDownButton","DropDownList","DropDownTree","Editor","ExcelExport","ExpansionPanel","FileSaver","FileSelect","Filter","FlatColorPicker","FloatingActionButton","FloatingLabel","Forms","FormField","Gantt","Gauges","General","Grid","GridLayout","Icon","InlineAIPrompt","Label","LinearGauge","ListBox","ListView","Loader","Map","MaskedTextBox","Menu","MultiColumnComboBox","MultiSelect","MultiSelectTree","MultiViewCalendar","Notification","NumericTextBox","OTPInput","Pager","PanelBar","PDFExport","PDFViewer","PivotGrid","Popover","Popup","ProgressBar","PromptBox","QRCode","RadialGauge","RadioButton","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","SmartPasteButton","Sortable","StockChart","Sparkline","SpeechToTextButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","SVGIcon","Switch","TabStrip","TextArea","TextBox","TileLayout","Timeline","TimePicker","ToolBar","Tooltip","TreeList","TreeView","Typography","Upload","Window"],ie=new Map([["actionsheet","@progress/kendo-angular-navigation"],["aiprompt","@progress/kendo-angular-conversational-ui"],["appbar","@progress/kendo-angular-navigation"],["arcgauge","@progress/kendo-angular-gauges"],["autocomplete","@progress/kendo-angular-dropdowns"],["avatar","@progress/kendo-angular-layout"],["badge","@progress/kendo-angular-indicators"],["barcode","@progress/kendo-angular-barcodes"],["bottomnavigation","@progress/kendo-angular-navigation"],["breadcrumb","@progress/kendo-angular-navigation"],["button","@progress/kendo-angular-buttons"],["buttongroup","@progress/kendo-angular-buttons"],["calendar","@progress/kendo-angular-dateinputs"],["card","@progress/kendo-angular-layout"],["chartwizard","@progress/kendo-angular-chart-wizard"],["checkbox","@progress/kendo-angular-inputs"],["chip","@progress/kendo-angular-buttons"],["chiplist","@progress/kendo-angular-buttons"],["chunkprogressbar","@progress/kendo-angular-progressbar"],["circulargauge","@progress/kendo-angular-gauges"],["circularprogressbar","@progress/kendo-angular-progressbar"],["colorgradient","@progress/kendo-angular-inputs"],["colorpalette","@progress/kendo-angular-inputs"],["colorpicker","@progress/kendo-angular-inputs"],["combobox","@progress/kendo-angular-dropdowns"],["contextmenu","@progress/kendo-angular-menu"],["dataquery","@progress/kendo-data-query"],["dateinput","@progress/kendo-angular-dateinputs"],["datemath","@progress/kendo-date-math"],["datepicker","@progress/kendo-angular-dateinputs"],["daterangepicker","@progress/kendo-angular-dateinputs"],["datetimepicker","@progress/kendo-angular-dateinputs"],["diagram","@progress/kendo-angular-diagrams"],["dialog","@progress/kendo-angular-dialog"],["drawer","@progress/kendo-angular-layout"],["drawing","@progress/kendo-drawing"],["dropdownbutton","@progress/kendo-angular-buttons"],["dropdownlist","@progress/kendo-angular-dropdowns"],["dropdowntree","@progress/kendo-angular-dropdowns"],["editor","@progress/kendo-angular-editor"],["excelexport","@progress/kendo-angular-excel-export"],["expansionpanel","@progress/kendo-angular-layout"],["filesaver","@progress/kendo-file-saver"],["fileselect","@progress/kendo-angular-upload"],["filter","@progress/kendo-angular-filter"],["flatcolorpicker","@progress/kendo-angular-inputs"],["floatingactionbutton","@progress/kendo-angular-buttons"],["floatinglabel","@progress/kendo-angular-label"],["formfield","@progress/kendo-angular-inputs"],["forms","@progress/kendo-angular-inputs"],["gantt","@progress/kendo-angular-gantt"],["grid","@progress/kendo-angular-grid"],["gridlayout","@progress/kendo-angular-layout"],["icon","@progress/kendo-angular-icons"],["inlineaiprompt","@progress/kendo-angular-conversational-ui"],["label","@progress/kendo-angular-label"],["lineargauge","@progress/kendo-angular-gauges"],["listbox","@progress/kendo-angular-listbox"],["listview","@progress/kendo-angular-listview"],["loader","@progress/kendo-angular-indicators"],["map","@progress/kendo-angular-map"],["maskedtextbox","@progress/kendo-angular-inputs"],["menu","@progress/kendo-angular-menu"],["multicolumncombobox","@progress/kendo-angular-dropdowns"],["multiselect","@progress/kendo-angular-dropdowns"],["multiselecttree","@progress/kendo-angular-dropdowns"],["multiviewcalendar","@progress/kendo-angular-dateinputs"],["notification","@progress/kendo-angular-notification"],["numerictextbox","@progress/kendo-angular-inputs"],["otpinput","@progress/kendo-angular-inputs"],["pager","@progress/kendo-angular-pager"],["panelbar","@progress/kendo-angular-layout"],["pdfexport","@progress/kendo-angular-pdf-export"],["pdfviewer","@progress/kendo-angular-pdfviewer"],["pivotgrid","@progress/kendo-angular-pivotgrid"],["popover","@progress/kendo-angular-tooltip"],["popup","@progress/kendo-angular-popup"],["progressbar","@progress/kendo-angular-progressbar"],["promptbox","@progress/kendo-angular-conversational-ui"],["qrcode","@progress/kendo-angular-barcodes"],["radialgauge","@progress/kendo-angular-gauges"],["radiobutton","@progress/kendo-angular-inputs"],["rangeslider","@progress/kendo-angular-inputs"],["rating","@progress/kendo-angular-inputs"],["ripple","@progress/kendo-angular-ripple"],["sankey","@progress/kendo-angular-charts"],["scheduler","@progress/kendo-angular-scheduler"],["scrollview","@progress/kendo-angular-scrollview"],["signature","@progress/kendo-angular-inputs"],["skeleton","@progress/kendo-angular-indicators"],["slider","@progress/kendo-angular-inputs"],["smartpastebutton","@progress/kendo-angular-buttons"],["sortable","@progress/kendo-angular-sortable"],["sparkline","@progress/kendo-angular-charts"],["speechtotextbutton","@progress/kendo-angular-buttons"],["splitbutton","@progress/kendo-angular-buttons"],["splitter","@progress/kendo-angular-layout"],["spreadsheet","@progress/kendo-angular-spreadsheet"],["stacklayout","@progress/kendo-angular-layout"],["stepper","@progress/kendo-angular-layout"],["stockchart","@progress/kendo-angular-charts"],["svgicon","@progress/kendo-angular-icons"],["switch","@progress/kendo-angular-inputs"],["tabstrip","@progress/kendo-angular-layout"],["textarea","@progress/kendo-angular-inputs"],["textbox","@progress/kendo-angular-inputs"],["tilelayout","@progress/kendo-angular-layout"],["timeline","@progress/kendo-angular-layout"],["timepicker","@progress/kendo-angular-dateinputs"],["toolbar","@progress/kendo-angular-toolbar"],["treelist","@progress/kendo-angular-treelist"],["treeview","@progress/kendo-angular-treeview"],["typography","@progress/kendo-angular-typography"],["upload","@progress/kendo-angular-upload"],["window","@progress/kendo-angular-dialog"],["charts","@progress/kendo-angular-charts"],["conversationalui","@progress/kendo-angular-conversational-ui"],["tooltip","@progress/kendo-angular-tooltip"]]);var Je=Qe(He(We(import.meta.url)),"../proto/service.proto"),L=new $("contextapi.telerik.com:443",Je,{libName:b});var le=async()=>L.validateUserLicense();import at from"fs";import _e from"path";import{fileURLToPath as it}from"url";import{z as h}from"zod";var k=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
|
|
2
|
+
import{McpServer as pt}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as dt}from"@modelcontextprotocol/sdk/server/stdio.js";import{dirname as et,join as tt}from"path";import{fileURLToPath as ot}from"url";import{loadLicense as je,decodeLicenseKey as We,decodeLicenseEvidence as Ye}from"@progress/kendo-licensing/utils";var M=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=je();if(!o.success)throw new M(o.message);try{e=(await We(o.value)).licenses.find(async r=>!!(await Ye(r)).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 x from"node:fs";import D from"node:path";var q=!1,N=process.env.DEBUG_LOG_FILE,oe=!!(N&&typeof N=="string");if(oe){let e=D.resolve(N),t=D.dirname(e);if(t!=="."&&t!==process.cwd()&&!x.existsSync(t))try{x.mkdirSync(t,{recursive:!0})}catch(o){console.error("Error creating log directory:",o)}if(!x.existsSync(e))try{x.writeFileSync(e,"")}catch(o){console.error("Error creating log file:",o)}}else q=!1;q=oe&&!!N&&x.existsSync(D.resolve(N));function h(...e){if(q&&N){let n=`${new Date().toISOString()}: ${e.join(" ")}
|
|
3
|
+
`,r=D.resolve(N);x.appendFile(r,n,s=>{s&&console.error("Error writing to log file:",s)})}}import ze from"@grpc/proto-loader";import _ from"@grpc/grpc-js";import re from"path";import ne from"fs";import{fileURLToPath as He}from"url";var Qe=He(import.meta.url),Je=re.dirname(Qe),ae={version:"unknown"},se=re.resolve(Je,"../package.json");ne.existsSync(se)&&(ae=JSON.parse(ne.readFileSync(se,"utf-8")));function Xe(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=ze.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=_.loadPackageDefinition(r);this.client=new s.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?_.credentials.createInsecure():_.credentials.createSsl())}async getMetadata({meta:t}={meta:{}}){let[o,n]=this.isDev?"fake_license":await te(),r=process.env.CONTEXTAPI_API_KEY,s=r&&typeof r=="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 p=new _.Metadata;if(c)try{p.add("x-license-key",o)}catch(g){throw h("Error adding license key to metadata:",g),new Error(`Failed to use license key: ${g.message}`)}s&&p.add("x-api-key",r),this.options?.libName&&p.add("x-library-name",this.options.libName),p.add("x-tool-name",this.toolNameHeader);let u=JSON.stringify({...t,source:"npm",version:ae.version,os:process.platform,node_version:process.version});return p.add("x-request-metadata",Xe(u)),p}async query(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.query(t,o,(s,c)=>{s?r(new Error(s)):n(c)})})}async queryCssUtils(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.cssUtilsSearch(t,o,(s,c)=>{s?(h("Error querying CSS Utils:",s),r(new Error(s))):n(c)})})}async queryIconsSearch(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.iconsSearch(t,o,(s,c)=>{s?(h("Error querying Icons Search:",s),r(new Error(s))):n(c)})})}async queryBuildingBlocks(t){let o=await this.getMetadata();return new Promise((n,r)=>{this.client.buildingBlocksSearch(t,o,(s,c)=>{s?(h("Error querying Building Blocks:",s),r(new Error(s))):n(c)})})}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,c)=>{s?(h("Error querying context API/GenerateTheme:",s),r(new Error(s))):n(c)})})}async recordOrchestratorUserRequest({meta:t}){let o=await this.getMetadata({meta:t});return new Promise((n,r)=>{this.client.recordOrchestratorUserRequest(null,o,(s,c)=>{s?(h("Error recording orchestrator user request:",s),r(new Error(s))):n(c)})})}};import{z as B}from"zod";var _t=B.object({user_id:B.string(),user_email:B.string().email()});import{z as f}from"zod";var Ze=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())}),Mt=f.array(Ze);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"}function le(){return`**Accessibility Guidelines: WCAG 2.2 Level AA Compliance**
|
|
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 d="Kendo UI for Angular",k="angular",I="kendo",P=["AIPrompt","ActionSheet","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","BreadCrumb","Button","ButtonGroup","Calendar","Card","ChartWizard","Charts","CheckBox","Chip","ChipList","ChunkProgressBar","CircularGauge","CircularProgressBar","ColorGradient","ColorPalette","ColorPicker","ComboBox","ContextMenu","ConversationalUI","DataQuery","DateInput","DateMath","DatePicker","DateRange","DateTimePicker","Diagram","Dialog","DragandDrop","Drawer","Drawing","DropDownButton","DropDownList","DropDownTree","Editor","ExcelExport","ExpansionPanel","FileSaver","FileSelect","Filter","FlatColorPicker","FloatingActionButton","FloatingLabel","Forms","FormField","Gantt","Gauges","General","Grid","GridLayout","Icon","InlineAIPrompt","Label","LinearGauge","ListBox","ListView","Loader","Map","MaskedTextBox","Menu","MultiColumnComboBox","MultiSelect","MultiSelectTree","MultiViewCalendar","Notification","NumericTextBox","OTPInput","Pager","PanelBar","PDFExport","PDFViewer","PivotGrid","Popover","Popup","ProgressBar","PromptBox","QRCode","RadialGauge","RadioButton","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","SmartPasteButton","Sortable","StockChart","Sparkline","SpeechToTextButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","SVGIcon","Switch","TabStrip","TextArea","TextBox","TileLayout","Timeline","TimePicker","ToolBar","Tooltip","TreeList","TreeView","Typography","Upload","Window"],ce=new Map([["actionsheet","@progress/kendo-angular-navigation"],["aiprompt","@progress/kendo-angular-conversational-ui"],["appbar","@progress/kendo-angular-navigation"],["arcgauge","@progress/kendo-angular-gauges"],["autocomplete","@progress/kendo-angular-dropdowns"],["avatar","@progress/kendo-angular-layout"],["badge","@progress/kendo-angular-indicators"],["barcode","@progress/kendo-angular-barcodes"],["bottomnavigation","@progress/kendo-angular-navigation"],["breadcrumb","@progress/kendo-angular-navigation"],["button","@progress/kendo-angular-buttons"],["buttongroup","@progress/kendo-angular-buttons"],["calendar","@progress/kendo-angular-dateinputs"],["card","@progress/kendo-angular-layout"],["chartwizard","@progress/kendo-angular-chart-wizard"],["checkbox","@progress/kendo-angular-inputs"],["chip","@progress/kendo-angular-buttons"],["chiplist","@progress/kendo-angular-buttons"],["chunkprogressbar","@progress/kendo-angular-progressbar"],["circulargauge","@progress/kendo-angular-gauges"],["circularprogressbar","@progress/kendo-angular-progressbar"],["colorgradient","@progress/kendo-angular-inputs"],["colorpalette","@progress/kendo-angular-inputs"],["colorpicker","@progress/kendo-angular-inputs"],["combobox","@progress/kendo-angular-dropdowns"],["contextmenu","@progress/kendo-angular-menu"],["dataquery","@progress/kendo-data-query"],["dateinput","@progress/kendo-angular-dateinputs"],["datemath","@progress/kendo-date-math"],["datepicker","@progress/kendo-angular-dateinputs"],["daterangepicker","@progress/kendo-angular-dateinputs"],["datetimepicker","@progress/kendo-angular-dateinputs"],["diagram","@progress/kendo-angular-diagrams"],["dialog","@progress/kendo-angular-dialog"],["drawer","@progress/kendo-angular-layout"],["drawing","@progress/kendo-drawing"],["dropdownbutton","@progress/kendo-angular-buttons"],["dropdownlist","@progress/kendo-angular-dropdowns"],["dropdowntree","@progress/kendo-angular-dropdowns"],["editor","@progress/kendo-angular-editor"],["excelexport","@progress/kendo-angular-excel-export"],["expansionpanel","@progress/kendo-angular-layout"],["filesaver","@progress/kendo-file-saver"],["fileselect","@progress/kendo-angular-upload"],["filter","@progress/kendo-angular-filter"],["flatcolorpicker","@progress/kendo-angular-inputs"],["floatingactionbutton","@progress/kendo-angular-buttons"],["floatinglabel","@progress/kendo-angular-label"],["formfield","@progress/kendo-angular-inputs"],["forms","@progress/kendo-angular-inputs"],["gantt","@progress/kendo-angular-gantt"],["grid","@progress/kendo-angular-grid"],["gridlayout","@progress/kendo-angular-layout"],["icon","@progress/kendo-angular-icons"],["inlineaiprompt","@progress/kendo-angular-conversational-ui"],["label","@progress/kendo-angular-label"],["lineargauge","@progress/kendo-angular-gauges"],["listbox","@progress/kendo-angular-listbox"],["listview","@progress/kendo-angular-listview"],["loader","@progress/kendo-angular-indicators"],["map","@progress/kendo-angular-map"],["maskedtextbox","@progress/kendo-angular-inputs"],["menu","@progress/kendo-angular-menu"],["multicolumncombobox","@progress/kendo-angular-dropdowns"],["multiselect","@progress/kendo-angular-dropdowns"],["multiselecttree","@progress/kendo-angular-dropdowns"],["multiviewcalendar","@progress/kendo-angular-dateinputs"],["notification","@progress/kendo-angular-notification"],["numerictextbox","@progress/kendo-angular-inputs"],["otpinput","@progress/kendo-angular-inputs"],["pager","@progress/kendo-angular-pager"],["panelbar","@progress/kendo-angular-layout"],["pdfexport","@progress/kendo-angular-pdf-export"],["pdfviewer","@progress/kendo-angular-pdfviewer"],["pivotgrid","@progress/kendo-angular-pivotgrid"],["popover","@progress/kendo-angular-tooltip"],["popup","@progress/kendo-angular-popup"],["progressbar","@progress/kendo-angular-progressbar"],["promptbox","@progress/kendo-angular-conversational-ui"],["qrcode","@progress/kendo-angular-barcodes"],["radialgauge","@progress/kendo-angular-gauges"],["radiobutton","@progress/kendo-angular-inputs"],["rangeslider","@progress/kendo-angular-inputs"],["rating","@progress/kendo-angular-inputs"],["ripple","@progress/kendo-angular-ripple"],["sankey","@progress/kendo-angular-charts"],["scheduler","@progress/kendo-angular-scheduler"],["scrollview","@progress/kendo-angular-scrollview"],["signature","@progress/kendo-angular-inputs"],["skeleton","@progress/kendo-angular-indicators"],["slider","@progress/kendo-angular-inputs"],["smartpastebutton","@progress/kendo-angular-buttons"],["sortable","@progress/kendo-angular-sortable"],["sparkline","@progress/kendo-angular-charts"],["speechtotextbutton","@progress/kendo-angular-buttons"],["splitbutton","@progress/kendo-angular-buttons"],["splitter","@progress/kendo-angular-layout"],["spreadsheet","@progress/kendo-angular-spreadsheet"],["stacklayout","@progress/kendo-angular-layout"],["stepper","@progress/kendo-angular-layout"],["stockchart","@progress/kendo-angular-charts"],["svgicon","@progress/kendo-angular-icons"],["switch","@progress/kendo-angular-inputs"],["tabstrip","@progress/kendo-angular-layout"],["textarea","@progress/kendo-angular-inputs"],["textbox","@progress/kendo-angular-inputs"],["tilelayout","@progress/kendo-angular-layout"],["timeline","@progress/kendo-angular-layout"],["timepicker","@progress/kendo-angular-dateinputs"],["toolbar","@progress/kendo-angular-toolbar"],["treelist","@progress/kendo-angular-treelist"],["treeview","@progress/kendo-angular-treeview"],["typography","@progress/kendo-angular-typography"],["upload","@progress/kendo-angular-upload"],["window","@progress/kendo-angular-dialog"],["charts","@progress/kendo-angular-charts"],["conversationalui","@progress/kendo-angular-conversational-ui"],["tooltip","@progress/kendo-angular-tooltip"]]);var nt=tt(et(ot(import.meta.url)),"../proto/service.proto"),G=new $("contextapi.telerik.com:443",nt,{libName:k});var pe=async()=>G.validateUserLicense();import ut from"fs";import Fe from"path";import{fileURLToPath as mt}from"url";import{z as m}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 R=(e,t)=>`# ${e.suiteName} - Code Validation & Quality Assurance
|
|
6
60
|
|
|
7
61
|
## Comprehensive Code Validation Checklist
|
|
8
62
|
Execute these validation steps systematically to ensure high-quality, maintainable code:
|
|
@@ -33,18 +87,6 @@ Security Measures:
|
|
|
33
87
|
- CSRF protection where applicable
|
|
34
88
|
- Secure data handling practices
|
|
35
89
|
|
|
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
90
|
### Validation Phase: UI/UX & Design System Compliance
|
|
49
91
|
|
|
50
92
|
Responsive Design:
|
|
@@ -58,13 +100,13 @@ Responsive Design:
|
|
|
58
100
|
- Graceful error handling for all user interactions
|
|
59
101
|
- Meaningful error messages for users
|
|
60
102
|
- Network error handling for API calls
|
|
61
|
-
`;var
|
|
103
|
+
`;var O=(e,t)=>{let o=R({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
|
|
62
104
|
|
|
63
|
-
**Current Goal:**
|
|
105
|
+
**Current Goal:**
|
|
64
106
|
|
|
65
107
|
${e.userIntent}
|
|
66
108
|
|
|
67
|
-
**Requirements Summary:**
|
|
109
|
+
**Requirements Summary:**
|
|
68
110
|
- **Framework:** ${e.libKey}
|
|
69
111
|
${e.includeComponentsDocs?`- **Component Library:** ${e.suiteName}
|
|
70
112
|
- Ensure to use ONLY ${e.suiteName} components for all UI elements.
|
|
@@ -84,6 +126,11 @@ ${e.includeComponentsDocs?`- **Component Library:** ${e.suiteName}
|
|
|
84
126
|
- Ensure the layout is fully responsive across mobile, tablet, and desktop views.
|
|
85
127
|
- And use the ${e.layoutAssistantName} tool to get Kendo CSS utility classes needed for responsive design.
|
|
86
128
|
`:""}
|
|
129
|
+
- **Accessible (WCAG 2.2 Level AA):**
|
|
130
|
+
- CRITICAL: You must call the ${e.accessibilityAssistantName} tool with includeGeneralGuidelines=true on your first call to get WCAG 2.2 Level AA guidelines.
|
|
131
|
+
- For subsequent calls, use includeGeneralGuidelines=false to get only component-specific accessibility information.
|
|
132
|
+
- Ensure all components meet WCAG 2.2 Level AA standards.
|
|
133
|
+
|
|
87
134
|
${e.includeLayout?`**STYLING AND LAYOUT REQUIREMENTS:**
|
|
88
135
|
## CRITICAL DESIGN SYSTEM CONSTRAINTS
|
|
89
136
|
- **USE ONLY KENDO DESIGN SYSTEM UTILITIES** for ALL styling, layout, spacing, positioning, and responsive behavior
|
|
@@ -96,6 +143,47 @@ ${e.includeLayout?`**STYLING AND LAYOUT REQUIREMENTS:**
|
|
|
96
143
|
## Detailed Execution Plan
|
|
97
144
|
Follow these steps strictly in order to achieve a complete and polished implementation of the current goal:
|
|
98
145
|
|
|
146
|
+
### Phase: Accessibility Foundation
|
|
147
|
+
|
|
148
|
+
**Step 1: Retrieve WCAG 2.2 Level AA Guidelines**
|
|
149
|
+
|
|
150
|
+
**MANDATORY REQUIREMENT:**
|
|
151
|
+
|
|
152
|
+
- Before implementing any UI components or features, you must call the accessibility assistant with general guidelines
|
|
153
|
+
- On your first call to "${e.accessibilityAssistantName}", set "includeGeneralGuidelines=true" to get foundational WCAG 2.2 Level AA best practices
|
|
154
|
+
- These general guidelines apply to all components and must be considered throughout implementation
|
|
155
|
+
- For all subsequent calls, set "includeGeneralGuidelines=false" to get only component-specific information
|
|
156
|
+
|
|
157
|
+
**First tool call (includes general WCAG guidelines):**
|
|
158
|
+
\`\`\`
|
|
159
|
+
${e.accessibilityAssistantName}({
|
|
160
|
+
query="What are the accessibility requirements for [COMPONENT_NAME]?",
|
|
161
|
+
component="[COMPONENT_NAME]",
|
|
162
|
+
includeGeneralGuidelines=true // ONLY true on first call
|
|
163
|
+
})
|
|
164
|
+
\`\`\`
|
|
165
|
+
|
|
166
|
+
**Step 2: Get Component-Specific Accessibility Information**
|
|
167
|
+
|
|
168
|
+
For each additional ${e.suiteName} component you plan to use, call the tool with "includeGeneralGuidelines=false":
|
|
169
|
+
|
|
170
|
+
**Tool call example:**
|
|
171
|
+
\`\`\`
|
|
172
|
+
${e.accessibilityAssistantName}({
|
|
173
|
+
query="What are the accessibility features and requirements for [COMPONENT_NAME]? Include ARIA attributes, keyboard navigation, and screen reader support.",
|
|
174
|
+
component="[COMPONENT_NAME]",
|
|
175
|
+
includeGeneralGuidelines=false // false for all calls after the first
|
|
176
|
+
})
|
|
177
|
+
\`\`\`
|
|
178
|
+
|
|
179
|
+
**Example:**
|
|
180
|
+
\`\`\`
|
|
181
|
+
${e.accessibilityAssistantName}({
|
|
182
|
+
query="How to associate the label with another component or HTML input?",
|
|
183
|
+
component="Label",
|
|
184
|
+
includeGeneralGuidelines=false
|
|
185
|
+
})
|
|
186
|
+
\`\`\`
|
|
99
187
|
${e.includeLayout?`
|
|
100
188
|
### Phase: Layout Foundation
|
|
101
189
|
|
|
@@ -245,7 +333,7 @@ After code implementation and validation you can make quick fixes as needed:
|
|
|
245
333
|
- Do NOT generate or suggest any code until all tools have been used and validated responses are incorporated.
|
|
246
334
|
- Focus on planning and sequencing.
|
|
247
335
|
- Summarize the components, layouts, and utilities gathered.
|
|
248
|
-
- Confirm all required inputs from tools have been provided.`};var
|
|
336
|
+
- Confirm all required inputs from tools have been provided.`};var F=e=>`# ${e.suiteName} Assistant
|
|
249
337
|
|
|
250
338
|
**What you're looking for:**
|
|
251
339
|
|
|
@@ -350,7 +438,7 @@ After gathering information:
|
|
|
350
438
|
**Important Notes:**
|
|
351
439
|
- These tools provide documentation and guidance, not code generation
|
|
352
440
|
- Always refer to official ${e.suiteName} documentation for the most up-to-date information
|
|
353
|
-
- Tool responses include usage examples and best practices`;var
|
|
441
|
+
- Tool responses include usage examples and best practices`;var w=(e,t)=>({SETUP_VALIDATION:`
|
|
354
442
|
UI Library Setup:
|
|
355
443
|
- ${e} modules properly imported and configured
|
|
356
444
|
- ${e} theme properly loaded and applied
|
|
@@ -369,52 +457,62 @@ After gathering information:
|
|
|
369
457
|
- Consistent ${e} theme application across all components
|
|
370
458
|
- Custom theme variables properly defined and scoped
|
|
371
459
|
- ${e} icon fonts properly loaded and optimized
|
|
372
|
-
- Brand colors integrated with ${e} component themes`});function
|
|
373
|
-
`)||"No CSS utilities found for the given prompt.",A=
|
|
460
|
+
- Brand colors integrated with ${e} component themes`});function de(e,t,o){let{name:n,title:r,description:s,layoutAssistantName:c,codeAssistantName:p,styleAssistantName:u,iconAssistantName:g,accessibilityAssistantName:b,suiteName:i,libKey:A,components:a}=e,y=new C(n,{title:r,description:s,requiredAccess:e.requiredAccess,inputSchema:{userIntent:m.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 ${i} components you want to use.`),needsComponentsDocsConfidence:m.number().min(0).max(1).default(1).describe("Confidence (0-1) to include Component Documentation assistance. Default is 1."),needsLayoutConfidence:m.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Layout assistance. Default is 0."),needsStylingConfidence:m.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Theming/Styling assistance. Default is 0."),needsResponsiveBehaviorConfidence:m.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Responsive Behavior assistance. Default is 0."),needsIconsConfidence:m.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Icons assistance. Default is 0."),componentsNeeded:m.array(m.enum(a)).optional().describe(`Optional list of specific ${i} components needed for the project.`)}},async({userIntent:T,needsComponentsDocsConfidence:S,needsLayoutConfidence:v,needsStylingConfidence:L,needsResponsiveBehaviorConfidence:Q,needsIconsConfidence:J,componentsNeeded:X},{_meta:Ke})=>{h("UI Orchestrator called with:",{userIntent:T,needsComponentsDocsConfidence:S,needsLayoutConfidence:v,needsStylingConfidence:L,needsResponsiveBehaviorConfidence:Q,needsIconsConfidence:J});try{await o.recordOrchestratorUserRequest({meta:{userIntent:T,componentsNeeded:X,_meta:Ke}})}catch(U){throw E(U)}let Ve=y.server?.server.getClientCapabilities?.()?.elicitation,Z;if(Ve&&L>.3&&L<=.6){let U=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"]}});U?.action==="accept"&&U.content?.includeCustomTheming&&(Z=!0)}return{content:[{type:"text",text:O({name:n,userIntent:T,includeComponentsDocs:S>.3,includeTheming:L>.6||!!Z,includeLayout:v>.5,includeIcons:J>.6,includeResponsive:v>.5&&Q>.4,layoutAssistantName:c,codeAssistantName:p,styleAssistantName:u,iconAssistantName:g,accessibilityAssistantName:b,suiteName:i,libKey:A,components:X},t)}]}});return y}function ue(e,t){let{name:o,title:n,description:r,iconAssistantName:s,codeAssistantName:c,suiteName:p,libKey:u,components:g}=e;return new C(o,{title:n,description:r,inputSchema:{userIntent:m.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 ${p}.`),needsIconsConfidence:m.number().min(0).max(1).default(.7).describe("Confidence (0-1) to include Icons assistance. Default is 0.7."),componentsNeeded:m.array(m.enum(g)).optional().describe(`Optional list of specific ${p} components you want to learn about.`)},requiredAccess:e.requiredAccess},async({userIntent:i,needsIconsConfidence:A,componentsNeeded:a},{_meta:y})=>{h("Assistant Orchestrator called with:",{userIntent:i,needsIconsConfidence:A,componentsNeeded:a});try{await t.recordOrchestratorUserRequest({meta:{userIntent:i,componentsNeeded:a,_meta:y}})}catch(S){throw E(S)}return{content:[{type:"text",text:F({name:o,userIntent:i,includeComponentsDocs:!0,includeIcons:A>.5,codeAssistantName:c,iconAssistantName:s,suiteName:p,libKey:u,components:a})}]}})}function me(e,t){let{name:o,title:n,description:r,suiteName:s,libKey:c,getPreContent:p}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{prompt:m.string().describe("An enhanced prompt describing the HTML layout structure, design requirements or specific visual effects you want to achieve."),includeBuildingBlockExamples:m.boolean().describe("Whether to include building block examples. Defaults to false.").default(!1)}},async({prompt:u,includeBuildingBlockExamples:g})=>{h("Layout Assistant called with:",{prompt:u,includeBuildingBlockExamples:g});try{let i=(await t.queryCssUtils({query:u})).values.join(`
|
|
461
|
+
`)||"No CSS utilities found for the given prompt.",A=p?.()??"",a=y=>`${A}
|
|
374
462
|
|
|
375
463
|
# Kendo Design System CSS Utilities
|
|
376
464
|
|
|
377
|
-
${
|
|
378
|
-
${
|
|
379
|
-
`;if(
|
|
465
|
+
${i}
|
|
466
|
+
${y??""}
|
|
467
|
+
`;if(g)try{let y=await t.queryBuildingBlocks({query:u,lib_name:c}),T="";y.items?.length>0&&(T=`
|
|
380
468
|
## Building Blocks Examples
|
|
381
469
|
|
|
382
470
|
The examples here are for demonstration purpose how CSS utils can be implemented in various building blocks.
|
|
383
471
|
However, consider your own design requirements and specifics in order to implement your templates/building blocks correctly.
|
|
384
472
|
|
|
385
|
-
${
|
|
386
|
-
### ${
|
|
473
|
+
${y.items.map(S=>`
|
|
474
|
+
### ${S.name}
|
|
387
475
|
|
|
388
|
-
${
|
|
476
|
+
${S.description}
|
|
389
477
|
|
|
390
478
|
\`\`\`code
|
|
391
|
-
${
|
|
479
|
+
${S.code}
|
|
392
480
|
\`\`\`
|
|
393
481
|
`).join(`
|
|
394
|
-
`)}`),
|
|
482
|
+
`)}`),i=a(T)}catch(y){h("Error calling building-blocks service:",y),i=a()}else i=a();return{content:[{type:"text",text:i}]}}catch(b){throw E(b)}})}function ge(e,t){let{name:o,title:n,description:r,libKey:s,getPreContent:c}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{prompt:m.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:p})=>{h("Style Assistant called with:",{prompt:p});let u="";try{let i=await t.queryThemeGenerate({prompt:p});if(i.variables_json){let A=JSON.parse(i.variables_json),a=[];if(A)for(let y of Object.keys(A))typeof A[y]=="string"&&a.push(`${y}: ${A[y]}`);u=a.join(`
|
|
395
483
|
|
|
396
|
-
`)}}catch(
|
|
484
|
+
`)}}catch(i){throw E(i)}let g=c?.()??"";return{content:[{type:"text",text:u?`Use the following CSS variables to style the web application, including colors, typography, spacing, and component appearance.
|
|
397
485
|
Ensure the variables are applied consistently across all relevant elements.
|
|
398
486
|
Do NOT set any inline styles. CSS variables should be defined in global or component-level CSS files, or via supported theming mechanisms.
|
|
399
487
|
|
|
400
|
-
${
|
|
488
|
+
${g}
|
|
401
489
|
|
|
402
490
|
## Generated CSS Variables
|
|
403
491
|
|
|
404
492
|
\`\`\`css
|
|
405
|
-
${
|
|
493
|
+
${u}
|
|
406
494
|
\`\`\`
|
|
407
|
-
`:"No CSS variables were generated for the given prompt."}]}})}function
|
|
495
|
+
`:"No CSS variables were generated for the given prompt."}]}})}function he(e,t){let{name:o,title:n,description:r,libKey:s,getPostContent:c}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{query:m.string().describe("A search query for finding icons. Be specific about the icon purpose, style, or action."),limit:m.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:p,limit:u})=>{h("Icon Search called with:",{query:p,limit:u});try{let g=await t.queryIconsSearch({query:p,limit:u*100}),b=c?.()??"";return{content:[{type:"text",text:`${g.values.join(`
|
|
408
496
|
|
|
409
497
|
`)}
|
|
410
498
|
|
|
411
|
-
${
|
|
499
|
+
${b}`}]}}catch(g){throw E(g)}})}function fe(e,t){let{name:o,title:n,description:r,libKey:s,suiteName:c,components:p,componentAliases:u,getPostContent:g}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{query:m.string().describe("The query to search for."),component:m.enum(p).describe("The component to search for. If not specified, use General.")}},async({query:b,component:i})=>{h("Code Assistant called with:",{query:b,component:i});let A=i;if(u){let a=u[i];a&&(A=a)}try{let y=(await t.query({query:b,component:A?.toLowerCase()??"general",lib_name:s,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]})).values.map(v=>v.replace(/\0/g,"")),T=g?.({component:i})??"";return{content:[{type:"text",text:`${y.join(`
|
|
412
500
|
|
|
413
501
|
`)}
|
|
414
502
|
|
|
415
|
-
${T}`}]}}catch(
|
|
503
|
+
${T}`}]}}catch(a){throw E(a)}})}function ye(e,t){let{name:o,title:n,description:r,libKey:s,suiteName:c,components:p,componentAliases:u}=e;return new C(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{query:m.string().describe("The query to search for."),component:m.enum(p).describe("The component to search for. If not specified, use General."),includeGeneralGuidelines:m.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:g,component:b,includeGeneralGuidelines:i})=>{h("Accessibility Assistant called with:",{query:g,component:b,includeGeneralGuidelines:i});let A=b;if(u){let a=u[b];a&&(A=a)}try{let a="";if(i){let v=le();a+=`# WCAG 2.2 Level AA General Accessibility Guidelines
|
|
504
|
+
|
|
505
|
+
`,a+=v,a+=`
|
|
506
|
+
|
|
507
|
+
---
|
|
508
|
+
|
|
509
|
+
`}let S=(await t.query({query:g,component:A?.toLowerCase()??"general",lib_name:s,text_matches_count:3,code_matches_count:0,allowed_types:[""],filters_json:'{"type":{"$in":["accessibility"]}}'})).values.map(v=>v.replace(/\0/g,"")).join(`
|
|
510
|
+
|
|
511
|
+
`);return S?(i&&(a+=`# Component-Specific Accessibility Information
|
|
416
512
|
|
|
417
|
-
|
|
513
|
+
`),a+=S):i||(a="No component-specific accessibility guidelines found."),{content:[{type:"text",text:a}]}}catch(a){throw E(a)}})}function E(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
|
+
|
|
515
|
+
Error Code: ${t.code} Error Message: ${t.message}`)}var Ae=e=>`${e}_ui_generator`,be=e=>`${e}_assistant`,Se=e=>`${e}_layout_assistant`,Ce=e=>`${e}_component_assistant`,Te=e=>`${e}_style_assistant`,ke=e=>`${e}_icon_assistant`,ve=e=>`${e}_accessibility_assistant`;var Ne=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
516
|
|
|
419
517
|
Use the tool when:
|
|
420
518
|
- Want to build or modify a complete page or section layout
|
|
@@ -423,7 +521,7 @@ Error Code: ${t.code} Error Message: ${t.message}`)}var he=e=>`${e}_ui_generator
|
|
|
423
521
|
- You want to enforce best practices in styling, performance, and accessibility
|
|
424
522
|
|
|
425
523
|
Returns:
|
|
426
|
-
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,
|
|
524
|
+
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,Ie=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
525
|
|
|
428
526
|
Use this tool when:
|
|
429
527
|
- You need to discover which ${e} components are suitable for a specific use case
|
|
@@ -432,33 +530,51 @@ Use this tool when:
|
|
|
432
530
|
- You want to gather component documentation and examples
|
|
433
531
|
|
|
434
532
|
Returns:
|
|
435
|
-
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,
|
|
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.`,
|
|
533
|
+
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,we=`Retrieves Progress/Kendo Design System CSS utility classes and styling recommendations based on layout and design requirements.
|
|
534
|
+
Use this tool to find the right CSS utilities for styling Kendo UI components or general web elements.
|
|
535
|
+
It analyzes the provided design context and returns relevant utility classes with explanations and examples.
|
|
536
|
+
Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,Ee=`Generates CSS variables using an external style agent based on the user's styling prompt.
|
|
439
537
|
|
|
440
538
|
Use this tool when the user wants to:
|
|
441
539
|
- Update the visual theme of an application
|
|
442
540
|
- Modify color schemes
|
|
443
541
|
- Restyle the UI with CSS variables
|
|
444
542
|
|
|
445
|
-
The tool outputs a set of CSS variable definitions ready to be applied to style files.`,
|
|
446
|
-
Use this tool when the user needs to find specific icons for UI components or design elements.
|
|
543
|
+
The tool outputs a set of CSS variable definitions ready to be applied to style files.`,xe=`Searches for icons in the Telerik Icons library.
|
|
544
|
+
Use this tool when the user needs to find specific icons for UI components or design elements.
|
|
447
545
|
It supports searching by icon name, category, or keyword and returns matching icons from the Telerik Icons library.
|
|
448
|
-
`,
|
|
546
|
+
`,Pe=e=>`Provides answers and retrieves official documentation for ${e}.
|
|
449
547
|
|
|
450
548
|
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
|
|
549
|
+
- ${e} features or capabilities
|
|
550
|
+
- Specific components (e.g., Grid, Chart, Editor)
|
|
551
|
+
- Implementation details, configuration, or best practices
|
|
454
552
|
- How to use or customize components in ${e}
|
|
455
553
|
|
|
456
|
-
Set the user's full question as the 'query' parameter.
|
|
554
|
+
Set the user's full question as the 'query' parameter.
|
|
457
555
|
If the question refers to a specific ${e} component, include its name in the 'component' parameter.
|
|
458
|
-
|
|
556
|
+
`,Re=e=>`Retrieves accessibility guidance for ${e} components with optional general WCAG 2.2 Level AA guidelines.
|
|
557
|
+
|
|
558
|
+
Use this tool when:
|
|
559
|
+
- You need component-specific accessibility information and API references
|
|
560
|
+
- You want to ensure your application meets WCAG 2.2 Level AA standards
|
|
561
|
+
- You need guidance on implementing ARIA roles and properties for specific components
|
|
562
|
+
- You want to validate your application's accessibility features
|
|
563
|
+
|
|
564
|
+
**RECOMMENDED WORKFLOW:**
|
|
565
|
+
1. On your FIRST call, set 'includeGeneralGuidelines=true' to get comprehensive WCAG 2.2 Level AA guidelines + component-specific information
|
|
566
|
+
2. For ALL subsequent calls, set 'includeGeneralGuidelines=false' to get only component-specific accessibility information
|
|
567
|
+
|
|
568
|
+
By default (includeGeneralGuidelines=false), this tool returns only component-specific accessibility guidelines to avoid redundancy.
|
|
569
|
+
Set 'includeGeneralGuidelines=true' ONLY on the first call to include general WCAG guidelines.
|
|
570
|
+
|
|
571
|
+
Returns:
|
|
572
|
+
- When includeGeneralGuidelines=true: General WCAG 2.2 Level AA guidelines + component-specific recommendations
|
|
573
|
+
- When includeGeneralGuidelines=false: Only component-specific accessibility recommendations
|
|
574
|
+
`;var K=w("Kendo UI","Kendo"),V=`
|
|
459
575
|
### Angular Component Validation
|
|
460
576
|
Component Structure:
|
|
461
|
-
- Use proper @Component decorator configuration
|
|
577
|
+
- Use proper @Component decorator configuration
|
|
462
578
|
- If using NgModule setup use @Component decorator with \`standalone: false\` and declare component in NgModule declarations array
|
|
463
579
|
- Correct selector naming convention (kebab-case)
|
|
464
580
|
- Appropriate template and style file organization
|
|
@@ -475,7 +591,10 @@ ${K.PERFORMANCE_OPTIMIZATION}
|
|
|
475
591
|
${K.THEME_AND_STYLING}
|
|
476
592
|
- Proper theme switching functionality (if implemented)
|
|
477
593
|
- Only ONE theme reference exists across angular.json and styles files
|
|
478
|
-
- Make sure theme import mechanism is consistent with existing project setup
|
|
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 j=`**Angular Specific Requirements:**
|
|
479
598
|
|
|
480
599
|
**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
600
|
1. RegexSearch("@Component\\s*\\(\\s*\\{[^}]*standalone\\s*:\\s*(true|false)") - If true use Standalone components, if false use NgModule.
|
|
@@ -506,7 +625,7 @@ ${K.THEME_AND_STYLING}
|
|
|
506
625
|
2. Match the discovered patterns in all generated code
|
|
507
626
|
3. Maintain consistent formatting, indentation, and code organization with existing files
|
|
508
627
|
4. Always use the same theme import mechanism (unless user specifies otherwise)
|
|
509
|
-
`;var
|
|
628
|
+
`;var W=w("Kendo UI","KendoReact"),Y=`
|
|
510
629
|
### React Component Validation
|
|
511
630
|
Component Structure:
|
|
512
631
|
- Use proper function component patterns with Hooks
|
|
@@ -514,19 +633,22 @@ Component Structure:
|
|
|
514
633
|
- Appropriate file organization (components, hooks, utils)
|
|
515
634
|
- Props interface/type definitions where needed
|
|
516
635
|
|
|
517
|
-
${
|
|
636
|
+
${W.SETUP_VALIDATION}
|
|
518
637
|
- KendoReact license validation (if required)
|
|
519
638
|
- Appropriate bundler configuration for KendoReact packages
|
|
520
639
|
|
|
521
|
-
${
|
|
640
|
+
${W.PERFORMANCE_OPTIMIZATION}
|
|
522
641
|
- React.memo for components that receive stable props
|
|
523
642
|
- useMemo/useCallback for expensive computations and callbacks
|
|
524
643
|
- Proper key props for list rendering with KendoReact components
|
|
525
644
|
|
|
526
|
-
${
|
|
645
|
+
${W.THEME_AND_STYLING}
|
|
527
646
|
- Proper theme switching functionality (if implemented)
|
|
528
647
|
- Only ONE theme import exists across the application
|
|
529
|
-
- Make sure theme import mechanism is consistent with existing project setup
|
|
648
|
+
- Make sure theme import mechanism is consistent with existing project setup
|
|
649
|
+
|
|
650
|
+
Accessibility
|
|
651
|
+
- Accessibility guidelines retrieved and applied to all components`;var st={createOrchestrator:de,createAssistantOrchestrator:ue,createLayoutAssistant:me,createStyleAssistant:ge,createIconSearch:he,createCodeAssistant:fe,createAccessibilityAssistant:ye},rt={orchestrator:Ae,assistantOrchestrator:be,layoutAssistant:Se,codeAssistant:Ce,styleAssistant:Te,iconAssistant:ke,accessibilityAssistant:ve},at={orchestrator:Ne,assistantOrchestrator:Ie,layoutAssistant:we,styleAssistant:Ee,iconAssistant:xe,codeAssistant:Pe,accessibilityAssistant:Re},it={Orchestrator:{render:O},Validator:{render:R},SharedValidation:{getSteps:w}},lt={Angular:{steps:V,additionalPlan:j},React:{steps:Y}},l={Tools:st,ToolNames:rt,ToolDescriptions:at,Templates:it,Validation:lt};var ct=l.ToolNames.codeAssistant("kendo"),Oe=()=>`# Kendo Design System Guidelines for ${d}
|
|
530
652
|
|
|
531
653
|
## Setting up Styles/CSS
|
|
532
654
|
|
|
@@ -553,14 +675,14 @@ Alternatively, you can also consume them directly from the Unpkg CDN.
|
|
|
553
675
|
|
|
554
676
|
## Ready-to-use Layout Components
|
|
555
677
|
|
|
556
|
-
In the ${
|
|
678
|
+
In the ${d} 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
679
|
|
|
558
|
-
For any Layout component you can also call the ${
|
|
680
|
+
For any Layout component you can also call the ${ct} tool in order to get specific API reference and docs.
|
|
559
681
|
|
|
560
|
-
- ${
|
|
682
|
+
- ${d} Card component.
|
|
561
683
|
- Generally, it is recommended to use 100% width (e.g., \`<kendo-card width="100%">\`)
|
|
562
684
|
- If needed, use specific width based on the layout requirements (e.g., \`<kendo-card width="150px">\`)
|
|
563
|
-
`;var
|
|
685
|
+
`;var Le=()=>`## Applying CSS Variables in ${d}
|
|
564
686
|
|
|
565
687
|
Apply these CSS variables in the Angular application using one of these methods:
|
|
566
688
|
|
|
@@ -622,7 +744,7 @@ export class ThemeService {
|
|
|
622
744
|
}
|
|
623
745
|
}
|
|
624
746
|
\`\`\`
|
|
625
|
-
`;var
|
|
747
|
+
`;var Ue=l.ToolNames.codeAssistant("kendo"),De=()=>`## Using ${d} Icons
|
|
626
748
|
|
|
627
749
|
Important: Attempt to prioritize SVG icons over font icons.
|
|
628
750
|
|
|
@@ -630,13 +752,13 @@ Important: Attempt to prioritize SVG icons over font icons.
|
|
|
630
752
|
|
|
631
753
|
- Make sure @progress/kendo-svg-icons is installed.
|
|
632
754
|
- Make sure @progress/kendo-angular-icons is installed.
|
|
633
|
-
- You can call ${
|
|
755
|
+
- You can call ${Ue} tool for ${d} SVGIcon component for docs and API reference.
|
|
634
756
|
- [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.
|
|
635
|
-
- [optional] If using font icons you can call ${
|
|
757
|
+
- [optional] If using font icons you can call ${Ue} tool for ${d} Icon component for docs and API reference.
|
|
636
758
|
|
|
637
759
|
### Examples
|
|
638
760
|
|
|
639
|
-
Using ${
|
|
761
|
+
Using ${d} SVGIcon component:
|
|
640
762
|
|
|
641
763
|
\`\`\`ts
|
|
642
764
|
import { Component } from "@angular/core";
|
|
@@ -657,7 +779,7 @@ export class AppComponent {
|
|
|
657
779
|
|
|
658
780
|
\`\`\`
|
|
659
781
|
|
|
660
|
-
Using ${
|
|
782
|
+
Using ${d} Icon component:
|
|
661
783
|
|
|
662
784
|
\`\`\`ts
|
|
663
785
|
import { Component } from "@angular/core";
|
|
@@ -673,7 +795,7 @@ import { KENDO_ICONS } from "@progress/kendo-angular-icons";
|
|
|
673
795
|
})
|
|
674
796
|
export class AppComponent {}
|
|
675
797
|
\`\`\`
|
|
676
|
-
`;var
|
|
798
|
+
`;var _e=e=>{let t=e.component?.trim().toLowerCase(),o=ce.get(t),n=`## ${d} Common Guidelines
|
|
677
799
|
|
|
678
800
|
`;return o&&(n+=`### Package Installation
|
|
679
801
|
Always use minimal, targeted package installation.
|
|
@@ -689,4 +811,4 @@ For ${e.component} component: \`ng add ${o}\`
|
|
|
689
811
|
## Component-Specific Guidelines
|
|
690
812
|
|
|
691
813
|
${e.componentInstructions}
|
|
692
|
-
`),n};var
|
|
814
|
+
`),n};var $e=l.ToolNames.layoutAssistant(I),z=l.ToolNames.codeAssistant(I),Ge=l.ToolNames.styleAssistant(I),H=l.ToolNames.iconAssistant(I),Me=l.ToolNames.accessibilityAssistant(I);function qe(e,t){return[l.Tools.createOrchestrator({name:l.ToolNames.orchestrator(I),title:"Kendo UI Generator",description:l.ToolDescriptions.orchestrator(d),layoutAssistantName:$e,codeAssistantName:z,styleAssistantName:Ge,iconAssistantName:H,accessibilityAssistantName:Me,suiteName:d,libKey:k,components:P,requiredAccess:["agent"]},{validationSteps:l.Validation.Angular.steps,injectedPlan:l.Validation.Angular.additionalPlan},e),l.Tools.createAssistantOrchestrator({name:"kendo_angular_assistant",title:"Kendo UI Assistant",description:l.ToolDescriptions.assistantOrchestrator(d),codeAssistantName:z,iconAssistantName:H,suiteName:d,libKey:k,components:P,requiredAccess:["assistant"]},e),l.Tools.createLayoutAssistant({name:$e,title:"Kendo UI Layout Assistant",description:l.ToolDescriptions.layoutAssistant,suiteName:d,libKey:k,getPreContent:Oe,requiredAccess:["agent"]},e),l.Tools.createStyleAssistant({name:Ge,title:"Kendo UI Style Assistant",description:l.ToolDescriptions.styleAssistant,libKey:k,getPreContent:Le,requiredAccess:["agent"]},e),l.Tools.createIconSearch({name:H,title:"Kendo UI Icon Assistant",description:l.ToolDescriptions.iconAssistant,libKey:k,getPostContent:De,requiredAccess:["assistant","agent"]},e),l.Tools.createCodeAssistant({name:z,title:"Kendo UI Component Assistant",description:l.ToolDescriptions.codeAssistant(d),libKey:k,suiteName:d,components:P,getPostContent:({component:n})=>_e({component:n}),requiredAccess:["assistant","agent"]},e),l.Tools.createAccessibilityAssistant({name:Me,title:"Kendo UI Accessibility Assistant",description:l.ToolDescriptions.accessibilityAssistant(d),libKey:k,suiteName:d,components:P,requiredAccess:["agent"]},e)].filter(n=>n.hasAccess(t))}var gt=mt(import.meta.url),ht=Fe.dirname(gt),ft=Fe.resolve(ht,"../package.json"),yt=JSON.parse(ut.readFileSync(ft,"utf-8")),Be=new pt({name:"kendo-mcp",title:"Kendo MCP Server",version:yt.version});async function At(){let e=new dt;h("Starting server...");let t=await ie(async()=>{let n=(await pe())?.entitlement;return n?.Product?.Code||n?.product?.code});t!=="none"&&(G.toolNameHeader=t==="agent"||t==="full"?"agent":"assistant",qe(G,t).forEach(n=>n.register(Be))),await Be.connect(e)}At();
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@progress/kendo-angular-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.4.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": "./dist/index.js",
|
|
6
6
|
"license": "See LICENSE.md",
|
|
@@ -25,8 +25,8 @@
|
|
|
25
25
|
"dependencies": {
|
|
26
26
|
"@grpc/grpc-js": "^1.14.3",
|
|
27
27
|
"@grpc/proto-loader": "^0.8.0",
|
|
28
|
-
"@modelcontextprotocol/sdk": "^1.
|
|
29
|
-
"@progress/kendo-licensing": "^1.10.
|
|
28
|
+
"@modelcontextprotocol/sdk": "^1.26.0",
|
|
29
|
+
"@progress/kendo-licensing": "^1.10.1",
|
|
30
30
|
"tslib": "^2.3.0"
|
|
31
31
|
},
|
|
32
32
|
"devDependencies": {
|