@progress/kendo-react-mcp 1.8.0 → 1.9.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 +134 -82
- package/package.json +4 -4
package/dist/index.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{McpServer as
|
|
3
|
-
`,s=
|
|
2
|
+
import{McpServer as Kt}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as jt}from"@modelcontextprotocol/sdk/server/stdio.js";import{dirname as Tt,join as xt}from"path";import{fileURLToPath as It}from"url";import{loadLicense as ht,decodeLicenseKey as gt,decodeLicenseEvidence as ft}from"@progress/kendo-licensing/utils";var W=class extends Error{constructor(t){super(t),this.name="LicenseError"}};function me(e){return e.replace(/^\uFEFF/,"")}async function z(e){let t=null,n=null;try{let o=ht();if(!o.success){let s=new W(o.message);throw e&&await e("license_load_failed",{error:o.message}).catch(()=>{}),s}try{t=(await gt(o.value)).licenses.find(async i=>!!(await ft(i)).userId)}catch(s){console.log(s.message),e&&await e("license_load_failed",{error:s.message||"Unknown decoding error"}).catch(()=>{})}if(!t)return[me(o.value),null]}catch(o){return n=o.message||"Unknown error loading license.",e&&await e("license_load_failed",{error:n}).catch(()=>{}),[null,n]}return[me(t),null]}import L from"node:fs";import V from"node:path";var Y=!1,U=process.env.DEBUG_LOG_FILE,he=!!(U&&typeof U=="string");if(he){let e=V.resolve(U),t=V.dirname(e);if(t!=="."&&t!==process.cwd()&&!L.existsSync(t))try{L.mkdirSync(t,{recursive:!0})}catch(n){console.error("Error creating log directory:",n)}if(!L.existsSync(e))try{L.writeFileSync(e,"")}catch(n){console.error("Error creating log file:",n)}}else Y=!1;Y=he&&!!U&&L.existsSync(V.resolve(U));function C(...e){if(Y&&U){let o=`${new Date().toISOString()}: ${e.join(" ")}
|
|
3
|
+
`,s=V.resolve(U);L.appendFile(s,o,i=>{i&&console.error("Error writing to log file:",i)})}}import yt from"@grpc/proto-loader";import $ from"@grpc/grpc-js";import ye from"path";import ge from"fs";import{fileURLToPath as bt}from"url";var At=bt(import.meta.url),Ct=ye.dirname(At),be={version:"unknown"},fe=ye.resolve(Ct,"../package.json");ge.existsSync(fe)&&(be=JSON.parse(ge.readFileSync(fe,"utf-8")));function vt(e){return e.replace(/\u2014/g,"--").replace(/\u2013/g,"-").replace(/[^\x20-\x7E]/g,"")}var H=class{constructor(t,n,o){this.contextApiUrl=t;this.protoPath=n;this.options=o;this.toolNameHeader="assistant";let s=yt.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"),C("Using ContextApi URl:",this.contextApiUrl);let i=$.loadPackageDefinition(s);this.client=new i.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?$.credentials.createInsecure():$.credentials.createSsl())}buildRequestMetadata(t={}){return vt(JSON.stringify({...t,source:"npm",version:be.version,os:process.platform,node_version:process.version}))}async getMetadata({meta:t}={meta:{}}){let[n,o]=this.isDev?["fake_license",null]:await z((d,p)=>this.logEvent(d,p)),s=process.env.CONTEXTAPI_API_KEY,i=s&&typeof s=="string",a=n&&typeof n=="string";if(!a&&!i&&o)throw new Error(`Failed to authenticate with API key or License key!
|
|
4
4
|
|
|
5
|
-
License Error: ${o}`);let i=new G.Metadata;if(a)try{i.add("x-license-key",n)}catch(l){throw b("Error adding license key to metadata:",l),new Error(`Failed to use license key: ${l.message}`)}return r&&i.add("x-api-key",s),this.options?.libName&&i.add("x-library-name",this.options.libName),i.add("x-tool-name",this.toolNameHeader),i.add("x-request-metadata",this.buildRequestMetadata(t)),i}async query(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,r)=>{this.client.query(t,o,(a,i)=>{a?r(new Error(a)):s(i)})})}async getApiRefMatches(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,r)=>{this.client.getApiRefMatches(t,o,(a,i)=>{a?r(new Error(a)):s(i)})})}async queryCssUtils(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,r)=>{this.client.cssUtilsSearch(t,o,(a,i)=>{a?(b("Error querying CSS Utils:",a),r(new Error(a))):s(i)})})}async queryIconsSearch(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,r)=>{this.client.iconsSearch(t,o,(a,i)=>{a?(b("Error querying Icons Search:",a),r(new Error(a))):s(i)})})}async queryBuildingBlocks(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,r)=>{this.client.buildingBlocksSearch(t,o,(a,i)=>{a?(b("Error querying Building Blocks:",a),r(new Error(a))):s(i)})})}async validateUserLicense(){let t=await this.getMetadata();return new Promise((n,o)=>{this.client.validateUserLicense(null,t,(s,r)=>{s?(b("Error validating user license:",s),o(new Error(s))):n(r)})})}async queryThemeGenerate(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,r)=>{this.client.generateTheme(t,o,(a,i)=>{a?(b("Error querying context API/GenerateTheme:",a),r(new Error(a))):s(i)})})}async recordOrchestratorUserRequest({meta:t}){let n=await this.getMetadata({meta:t});return new Promise((o,s)=>{this.client.recordOrchestratorUserRequest(null,n,(r,a)=>{r?(b("Error recording orchestrator user request:",r),s(new Error(r))):o(a)})})}async recordToolUserRequest({toolName:t,meta:n}){let o=await this.getMetadata({meta:n});return new Promise((s,r)=>{this.client.recordToolUserRequest({tool_name:t},o,(a,i)=>{a?(b("Error recording tool user request:",a),r(new Error(a))):s(i)})})}async logEvent(t,n,o={}){let s="h8utJ6rk4PpIWX4JMn9beQDsjVUri6KV0XYfiVwq",{enrichWithUserData:r=!1,meta:a={}}=o,i=s&&typeof s=="string",l=null;if(r)try{let[u]=this.isDev?["fake_license",null]:await j();u&&typeof u=="string"&&(l=u)}catch{}if(!i&&!l){b("Neither LOGGING_API_KEY nor license key available, skipping log event");return}let d=new G.Metadata;return i&&d.add("x-api-key",s),l&&(d.add("x-license-key",l),d.add("x-request-metadata",this.buildRequestMetadata(a)),this.options?.libName&&d.add("x-library-name",this.options.libName)),new Promise((u,f)=>{this.client.logEvent({event_name:t,fields:n||{}},d,(m,y)=>{m?(b("Error logging event:",m),f(new Error(m))):u()})})}};import{z as H}from"zod";var eo=H.object({user_id:H.string(),user_email:H.string().email()});import{z as S}from"zod";var mt=S.object({Product:S.object({Id:S.number().int(),Code:S.string(),Name:S.string()}),License:S.nullable(S.object({Id:S.number().int(),Name:S.string(),Type:S.string(),Active:S.boolean()})),Availability:S.array(S.object({LicenseStart:S.nullable(S.string().datetime()),LicenseEnd:S.nullable(S.string().datetime())})),IsLicenseAvailable:S.optional(S.boolean())}),no=S.array(mt);function T(e,t){let n=e.server?.server.getClientVersion?.(),o=t||{};return n&&(o.clientInfo={name:n.name,version:n.version}),o}async function me(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 n=await e();return n?.toLocaleLowerCase()==="agentic_ui_generator"?"agent":n?.toLocaleLowerCase()==="ai_coding_assistants"?"assistant":"none"}function ue(){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...">`\nCORRECT: `<label for="qty">Quantity</label><input type="number" id="qty">`\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)\nEach page must have an `<h1>` that describes its content. 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 Component Landmark Rules** (WCAG 1.3.1, 4.1.2)\nPage components (route components) may be rendered inside a layout that already provides `<main>`, `<header>`, or `<footer>`. Since the layout configuration is unknown, avoid using these landmarks in page components to prevent potential duplication and nesting violations. Use `<div>`, `<section>`, or `<article>` as the top-level wrapper instead.\n- Avoid adding `<main>`, `role="main"`, `<header>`, or `<footer>` in page components \u2014 the layout typically provides them. Duplicating them can cause `landmark-no-duplicate-main` and `landmark-main-is-top-level` violations.\n- Avoid adding `role="banner"` or using a semantic `<header>` element in page components \u2014 the layout\'s `<header>` already claims the banner landmark. Adding another causes `landmark-banner-is-top-level` violations.\n- Avoid adding `role="contentinfo"` to elements inside page components \u2014 the contentinfo landmark should be a top-level landmark, not nested inside `<main>` or other landmarks. Nesting it can cause `landmark-contentinfo-is-top-level` violations.\n- When multiple `<section>` or `<nav>` elements exist on a page, give each a unique `aria-label` to avoid `landmark-unique` violations.\n\n**9. ARIA Role and Attribute Restrictions** (WCAG 4.1.2)\nOnly use ARIA roles that are valid for the given HTML element. Avoid adding `aria-label` or `aria-labelledby` to elements that do not permit naming.\n- `<article>` has an implicit `article` role. Do NOT override it with `role="listitem"`, `role="button"`, `role="link"`, or any other role \u2014 none are allowed on `<article>`. Use `<li>` for list items, `<button>` for interactive cards, or `<a>` for clickable cards instead.\n- `<button>` already has an implicit `button` role. Do NOT add `role="listitem"` or other incompatible roles.\n- `<span>` and `<div>` without roles are generic elements. Do NOT add `aria-label` to them \u2014 it is a prohibited attribute on elements with no accessible role and can cause `aria-prohibited-attr` violations. Instead, use `role="img"` + `aria-label` for visual indicators, or use visually hidden text.\n- Do NOT add `aria-label` to non-interactive `<div>` wrappers \u2014 it has no effect and triggers violations.\n- `aria-pressed` is only valid on elements with `role="button"`, `role="checkbox"`, `role="menuitemcheckbox"`, `role="option"`, `role="radio"`, or `role="switch"`. Do NOT use `aria-pressed` on elements with `role="listitem"` or other roles.\nCORRECT: `<ul role="list"><li class="product-card">...</li></ul>` (listitem inside list)\nCORRECT: `<span role="img" aria-label="Status: pending" class="status-dot"></span>` (role added before aria-label)\nCORRECT: `<span class="status-dot" aria-hidden="true"></span><span class="visually-hidden">Pending</span>` (hidden text alternative)\nWRONG: `<article role="listitem">` (listitem not allowed on article)\nWRONG: `<article role="button">` (button not allowed on article \u2014 use `<button>` or `<div role="button">`)\nWRONG: `<span aria-label="pending" class="status-dot"></span>` (aria-label prohibited on generic span)\nWRONG: `<div aria-label="Product badges" class="badges"></div>` (aria-label prohibited on generic div)\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, avoid `<main>`, `<header>`, `<footer>`, `role="main"`, `role="contentinfo"`, `role="banner"` in page/route components (the layout may already provide them), use `<section>` or `<div>` as page-level wrappers, unique aria-labels on duplicate landmark types\n- **ARIA Rules:** Avoid adding `aria-label` to generic `<span>`/`<div>` without a role, avoid using `role="listitem"` or `role="button"` on `<article>` \u2014 use `<li>` for list items, add `role="img"` before `aria-label` on visual indicators, `aria-pressed` only on button-like roles\n- **Scrollable Regions:** Any scrollable container must have `tabindex="0"` or contain keyboard-interactive children\n- **Nested Interactive:** Do not add interactive role/tabindex to a container that already has focusable children\n- **List Roles:** `role="list"` containers must have `role="listitem"` children \u2014 prefer `<ul>/<li>` natively\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 ut=1440*60*1e3;function he(e){let{serverName:t,contextApi:n,additionalFields:o={},intervalMs:s=ut,enrichWithUserData:r=!1}=e,a="mcp_server_heartbeat",i=async()=>{try{let d={server_name:t,timestamp:new Date().toISOString(),...o};await n.logEvent(a,d,{enrichWithUserData:r})}catch(d){b(`Failed to send heartbeat for ${t}:`,d)}};i();let l=setInterval(i,s);return()=>{clearInterval(l),b(`Heartbeat stopped for ${t}`)}}import{z as W}from"zod";var ht=["default","bootstrap","material","fluent"];function ge(e,t){return{projectName:W.string().default(t).describe("The name of the project. Used as the project folder name when creating a new project."),createNewProject:W.boolean().default(!0).describe(`Whether to create a new project before configuring ${e}. Set to true to scaffold a brand-new project, or false if the project already exists and you only want to add ${e} to it.`),theme:W.enum(ht).default("default").describe("The Kendo UI theme to use. Determines which theme package is installed and imported.")}}var c="Kendo UI for React",x="react",E="kendo";var L=["ActionSheet","AIPrompt","Animation","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","Breadcrumb","Button","ButtonGroup","BreadCrumb","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","Form","Gantt","Gauge","General","GridLayout","Hint","Icon","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","PromptBox","QRCode","RadialGauge","RadioButton","RadioGroup","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","Sortable","Sparkline","SpeechToTextButton","SmartPasteButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","StockChart","SVGIcon","Switch","TabStrip","TaskBoard","TextArea","TextBox","TileLayout","Timeline","TimePicker","Toolbar","Tooltip","TreeList","TreeView","Typography","Upload","VSCodeExtension","Window"];var bt=ft(gt(yt(import.meta.url)),"../proto/service.proto"),M=new B("contextapi.telerik.com:443",bt,{libName:x});var fe=async()=>M.validateUserLicense();import Pt from"fs";import Ze from"path";import{fileURLToPath as Dt}from"url";import{z as v}from"zod";var w=class{constructor(t,n,o){this.name=t;this.config=n;this.cb=o}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 $=(e,t)=>`# ${e.suiteName} - Code Validation & Quality Assurance
|
|
5
|
+
License Error: ${o}`);let r=new $.Metadata;if(a)try{r.add("x-license-key",n)}catch(d){throw C("Error adding license key to metadata:",d),new Error(`Failed to use license key: ${d.message}`)}return i&&r.add("x-api-key",s),this.options?.libName&&r.add("x-library-name",this.options.libName),r.add("x-tool-name",this.toolNameHeader),r.add("x-request-metadata",this.buildRequestMetadata(t)),r}async query(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,i)=>{this.client.query(t,o,(a,r)=>{a?i(new Error(a)):s(r)})})}async getApiRefMatches(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,i)=>{this.client.getApiRefMatches(t,o,(a,r)=>{a?i(new Error(a)):s(r)})})}async queryCssUtils(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,i)=>{this.client.cssUtilsSearch(t,o,(a,r)=>{a?(C("Error querying CSS Utils:",a),i(new Error(a))):s(r)})})}async queryIconsSearch(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,i)=>{this.client.iconsSearch(t,o,(a,r)=>{a?(C("Error querying Icons Search:",a),i(new Error(a))):s(r)})})}async queryBuildingBlocks(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,i)=>{this.client.buildingBlocksSearch(t,o,(a,r)=>{a?(C("Error querying Building Blocks:",a),i(new Error(a))):s(r)})})}async validateUserLicense(){let t=await this.getMetadata();return new Promise((n,o)=>{this.client.validateUserLicense({},t,(s,i)=>{s?(C("Error validating user license:",s),o(new Error(s))):n(i)})})}async queryThemeGenerate(t,n){let o=await this.getMetadata({meta:n});return new Promise((s,i)=>{this.client.generateTheme(t,o,(a,r)=>{a?(C("Error querying context API/GenerateTheme:",a),i(new Error(a))):s(r)})})}async recordOrchestratorUserRequest({meta:t}){let n=await this.getMetadata({meta:t});return new Promise((o,s)=>{this.client.recordOrchestratorUserRequest({},n,(i,a)=>{i?(C("Error recording orchestrator user request:",i),s(new Error(i))):o(a)})})}async recordToolUserRequest({toolName:t,meta:n}){let o=await this.getMetadata({meta:n});return new Promise((s,i)=>{this.client.recordToolUserRequest({tool_name:t},o,(a,r)=>{a?(C("Error recording tool user request:",a),i(new Error(a))):s(r)})})}async logEvent(t,n,o={}){let s="h8utJ6rk4PpIWX4JMn9beQDsjVUri6KV0XYfiVwq",{enrichWithUserData:i=!1,meta:a={}}=o,r=s&&typeof s=="string",d=null;if(i)try{let[g]=this.isDev?["fake_license",null]:await z();g&&typeof g=="string"&&(d=g)}catch{}if(!r&&!d){C("Neither LOGGING_API_KEY nor license key available, skipping log event");return}let p=new $.Metadata;return r&&p.add("x-api-key",s),d&&(p.add("x-license-key",d),p.add("x-request-metadata",this.buildRequestMetadata(a)),this.options?.libName&&p.add("x-library-name",this.options.libName)),new Promise((g,b)=>{this.client.logEvent({event_name:t,fields:n||{}},p,(l,m)=>{l?(C("Error logging event:",l),b(new Error(l))):g()})})}};import{z as Q}from"zod";var mo=Q.object({user_id:Q.string(),user_email:Q.string().email()});import{z as w}from"zod";var wt=w.object({Product:w.object({Id:w.number().int(),Code:w.string(),Name:w.string()}),License:w.nullable(w.object({Id:w.number().int(),Name:w.string(),Type:w.string(),Active:w.boolean()})),Availability:w.array(w.object({LicenseStart:w.nullable(w.string().datetime()),LicenseEnd:w.nullable(w.string().datetime())})),IsLicenseAvailable:w.optional(w.boolean())}),fo=w.array(wt);function T(e,t){let n=e.server?.server.getClientVersion?.(),o=t||{};return n&&(o.clientInfo={name:n.name,version:n.version}),o}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 n=await e();return n?.toLocaleLowerCase()==="agentic_ui_generator"?"agent":n?.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...">`\nCORRECT: `<label for="qty">Quantity</label><input type="number" id="qty">`\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)\nEach page must have an `<h1>` that describes its content. 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 Component Landmark Rules** (WCAG 1.3.1, 4.1.2)\nPage components (route components) may be rendered inside a layout that already provides `<main>`, `<header>`, or `<footer>`. Since the layout configuration is unknown, avoid using these landmarks in page components to prevent potential duplication and nesting violations. Use `<div>`, `<section>`, or `<article>` as the top-level wrapper instead.\n- Avoid adding `<main>`, `role="main"`, `<header>`, or `<footer>` in page components \u2014 the layout typically provides them. Duplicating them can cause `landmark-no-duplicate-main` and `landmark-main-is-top-level` violations.\n- Avoid adding `role="banner"` or using a semantic `<header>` element in page components \u2014 the layout\'s `<header>` already claims the banner landmark. Adding another causes `landmark-banner-is-top-level` violations.\n- Avoid adding `role="contentinfo"` to elements inside page components \u2014 the contentinfo landmark should be a top-level landmark, not nested inside `<main>` or other landmarks. Nesting it can cause `landmark-contentinfo-is-top-level` violations.\n- When multiple `<section>` or `<nav>` elements exist on a page, give each a unique `aria-label` to avoid `landmark-unique` violations.\n\n**9. ARIA Role and Attribute Restrictions** (WCAG 4.1.2)\nOnly use ARIA roles that are valid for the given HTML element. Avoid adding `aria-label` or `aria-labelledby` to elements that do not permit naming.\n- `<article>` has an implicit `article` role. Do NOT override it with `role="listitem"`, `role="button"`, `role="link"`, or any other role \u2014 none are allowed on `<article>`. Use `<li>` for list items, `<button>` for interactive cards, or `<a>` for clickable cards instead.\n- `<button>` already has an implicit `button` role. Do NOT add `role="listitem"` or other incompatible roles.\n- `<span>` and `<div>` without roles are generic elements. Do NOT add `aria-label` to them \u2014 it is a prohibited attribute on elements with no accessible role and can cause `aria-prohibited-attr` violations. Instead, use `role="img"` + `aria-label` for visual indicators, or use visually hidden text.\n- Do NOT add `aria-label` to non-interactive `<div>` wrappers \u2014 it has no effect and triggers violations.\n- `aria-pressed` is only valid on elements with `role="button"`, `role="checkbox"`, `role="menuitemcheckbox"`, `role="option"`, `role="radio"`, or `role="switch"`. Do NOT use `aria-pressed` on elements with `role="listitem"` or other roles.\nCORRECT: `<ul role="list"><li class="product-card">...</li></ul>` (listitem inside list)\nCORRECT: `<span role="img" aria-label="Status: pending" class="status-dot"></span>` (role added before aria-label)\nCORRECT: `<span class="status-dot" aria-hidden="true"></span><span class="visually-hidden">Pending</span>` (hidden text alternative)\nWRONG: `<article role="listitem">` (listitem not allowed on article)\nWRONG: `<article role="button">` (button not allowed on article \u2014 use `<button>` or `<div role="button">`)\nWRONG: `<span aria-label="pending" class="status-dot"></span>` (aria-label prohibited on generic span)\nWRONG: `<div aria-label="Product badges" class="badges"></div>` (aria-label prohibited on generic div)\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, avoid `<main>`, `<header>`, `<footer>`, `role="main"`, `role="contentinfo"`, `role="banner"` in page/route components (the layout may already provide them), use `<section>` or `<div>` as page-level wrappers, unique aria-labels on duplicate landmark types\n- **ARIA Rules:** Avoid adding `aria-label` to generic `<span>`/`<div>` without a role, avoid using `role="listitem"` or `role="button"` on `<article>` \u2014 use `<li>` for list items, add `role="img"` before `aria-label` on visual indicators, `aria-pressed` only on button-like roles\n- **Scrollable Regions:** Any scrollable container must have `tabindex="0"` or contain keyboard-interactive children\n- **Nested Interactive:** Do not add interactive role/tabindex to a container that already has focusable children\n- **List Roles:** `role="list"` containers must have `role="listitem"` children \u2014 prefer `<ul>/<li>` natively\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 St=1440*60*1e3;function ve(e){let{serverName:t,contextApi:n,additionalFields:o={},intervalMs:s=St,enrichWithUserData:i=!1}=e,a="mcp_server_heartbeat",r=async()=>{try{let p={server_name:t,timestamp:new Date().toISOString(),...o};await n.logEvent(a,p,{enrichWithUserData:i})}catch(p){C(`Failed to send heartbeat for ${t}:`,p)}};r();let d=setInterval(r,s);return()=>{clearInterval(d),C(`Heartbeat stopped for ${t}`)}}import{z as X}from"zod";var kt=["meridian","default","bootstrap","material","fluent"];function we(e,t){return{projectName:X.string().default(t).describe("The name of the project. Used as the project folder name when creating a new project."),createNewProject:X.boolean().default(!0).describe(`Whether to create a new project before configuring ${e}. Set to true to scaffold a brand-new project, or false if the project already exists and you only want to add ${e} to it.`),theme:X.enum(kt).default("meridian").describe("The Kendo UI theme to use. Determines which theme package is installed and imported. Available themes: meridian (default), default, bootstrap, material, fluent.")}}var u="Kendo UI for React",N="react",D="kendo";var _=["ActionSheet","AIPrompt","Animation","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","Breadcrumb","Button","ButtonGroup","BreadCrumb","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","Form","Gantt","Gauge","General","GridLayout","Hint","Icon","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","PromptBox","QRCode","RadialGauge","RadioButton","RadioGroup","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","Sortable","Sparkline","SpeechToTextButton","SmartPasteButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","StockChart","SVGIcon","Switch","TabStrip","TaskBoard","TextArea","TextBox","TileLayout","Timeline","TimePicker","Toolbar","Tooltip","TreeList","TreeView","Typography","Upload","VSCodeExtension","Window"];var Nt=xt(Tt(It(import.meta.url)),"../proto/service.proto"),F=new H("contextapi.telerik.com:443",Nt,{libName:N});var Se=async()=>F.validateUserLicense();import Vt from"fs";import ut from"path";import{fileURLToPath as Ht}from"url";import{z as v}from"zod";var k=class{constructor(t,n,o){this.name=t;this.config=n;this.cb=o}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 q=(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:
|
|
@@ -46,7 +46,7 @@ Responsive Design:
|
|
|
46
46
|
- Graceful error handling for all user interactions
|
|
47
47
|
- Meaningful error messages for users
|
|
48
48
|
- Network error handling for API calls
|
|
49
|
-
`;var
|
|
49
|
+
`;var J=()=>`## UX/UI Design Best Practices
|
|
50
50
|
|
|
51
51
|
> **These are default guidelines \u2014 follow them when the user has not stated otherwise.** If the user explicitly requests different behavior (e.g., a specific component size, a custom row limit, alternate breakpoints, a different layout pattern), defer to the user's stated preference and disregard the conflicting default below. Only accessibility and WCAG requirements (contrast ratios, focus indicators, semantic HTML, ARIA) apply regardless of user preference.
|
|
52
52
|
|
|
@@ -147,7 +147,7 @@ When no design token system is defined by the project, apply these minimum spaci
|
|
|
147
147
|
- Section separators: \u2265 24px vertical gap between distinct content areas.
|
|
148
148
|
- Card internal padding: 16\u201324px.
|
|
149
149
|
- Form field vertical gap: \u2265 16px between fields (24px for multi-column groups).
|
|
150
|
-
- Page left/right margin: 24\u201332px minimum, even at desktop widths.`;var
|
|
150
|
+
- Page left/right margin: 24\u201332px minimum, even at desktop widths.`;var B=(e,t)=>{let n=q({suiteName:e.suiteName,libKey:e.libKey},t.validationSteps),o=e.libKey==="angular"?"- **Drag and Drop**: Consider using the DragandDrop and Sortable components when drag-and-drop functionality is needed.":"",s=e.components?e.components.join(", "):"components";return`# \u{1F3AF} ${e.suiteName} - Execution Plan
|
|
151
151
|
|
|
152
152
|
**Current Goal:**
|
|
153
153
|
|
|
@@ -187,7 +187,7 @@ ${e.includeLayout?`**STYLING AND LAYOUT REQUIREMENTS:**
|
|
|
187
187
|
|
|
188
188
|
`:""}---
|
|
189
189
|
|
|
190
|
-
${
|
|
190
|
+
${J()}
|
|
191
191
|
|
|
192
192
|
---
|
|
193
193
|
|
|
@@ -386,7 +386,7 @@ After code implementation and validation you can make quick fixes as needed:
|
|
|
386
386
|
- Do NOT generate or suggest any code until all tools have been used and validated responses are incorporated.
|
|
387
387
|
- Focus on planning and sequencing.
|
|
388
388
|
- Summarize the components, layouts, and utilities gathered.
|
|
389
|
-
- Confirm all required inputs from tools have been provided.`};var
|
|
389
|
+
- Confirm all required inputs from tools have been provided.`};var Z=e=>`# ${e.suiteName} Assistant
|
|
390
390
|
|
|
391
391
|
**What you're looking for:**
|
|
392
392
|
|
|
@@ -500,7 +500,7 @@ After implementing the code:
|
|
|
500
500
|
**Important Notes:**
|
|
501
501
|
- These tools provide documentation and guidance, not code generation
|
|
502
502
|
- Always refer to official ${e.suiteName} documentation for the most up-to-date information
|
|
503
|
-
- Tool responses include usage examples and best practices`;var
|
|
503
|
+
- Tool responses include usage examples and best practices`;var O=(e,t)=>({SETUP_VALIDATION:`
|
|
504
504
|
UI Library Setup:
|
|
505
505
|
- ${e} modules properly imported and configured
|
|
506
506
|
- ${e} theme properly loaded and applied
|
|
@@ -519,77 +519,104 @@ After implementing the code:
|
|
|
519
519
|
- Consistent ${e} theme application across all components
|
|
520
520
|
- Custom theme variables properly defined and scoped
|
|
521
521
|
- ${e} icons properly loaded and optimized
|
|
522
|
-
- Brand colors integrated with ${e} component themes`});
|
|
523
|
-
|
|
522
|
+
- Brand colors integrated with ${e} component themes`});var ee=()=>`
|
|
523
|
+
**REQUIRED ACTIONS \u2014 apply all fixes directly to the source files:**
|
|
524
|
+
- Search all .ts files for every outdated API mentioned in the codemod output \u2014 this includes renamed or removed properties, method names, and enum values.
|
|
525
|
+
- Search all .ts, .css, and .scss files for every outdated CSS class mentioned in the codemod output and update it with an appropriate replacement.
|
|
526
|
+
- Fix any logic errors or unintended side effects introduced by the codemods
|
|
527
|
+
- Update any edge cases, custom implementations, or complex code patterns that were broken or left incomplete by the automated migration
|
|
528
|
+
- Replace hardcoded values, dynamic expressions, or conditional logic that the codemod could not handle automatically
|
|
529
|
+
- Correct any TypeScript type errors or mismatches introduced by the upgrade
|
|
530
|
+
- Adjust any patterns that do not align with the project's existing coding standards
|
|
531
|
+
|
|
532
|
+
**OUTPUT REQUIREMENTS:**
|
|
533
|
+
- For each file you change, briefly describe what was wrong and what fix you applied
|
|
534
|
+
- If a problem requires a decision from the developer that you cannot make automatically, call it out explicitly with the file path
|
|
535
|
+
- If all automated changes look correct and no further fixes are needed, explicitly confirm this`;import{execFile as Et}from"child_process";import{access as Rt}from"fs/promises";import{promisify as Pt}from"util";var ke=Pt(Et);function Dt(e,t){let n;try{n=JSON.parse(e)}catch{return e}let o=n?.Item;if(!o)return e;let s=[],i=o.FullName??o.Name??"",a=o.Type??"",r=o.Summary??"",d=o.SyntaxContent??"";s.push(`## API Reference Item
|
|
536
|
+
- Name: ${i}
|
|
524
537
|
- Type: ${a}
|
|
525
|
-
- Summary: ${
|
|
526
|
-
- Syntax: ${
|
|
527
|
-
`,h=0;for(let
|
|
538
|
+
- Summary: ${r}
|
|
539
|
+
- Syntax: ${d}`);let p=n.RelatedItemsByType?.return_type;if(p?.length){let m=p[0].Text;m&&s.push(`- Return Type: ${m}`)}let g=o.Examples??[];if(g.length>0){let m=`## Examples
|
|
540
|
+
`,h=0;for(let y of g){let c=(y.Component??"").toLowerCase(),f=t.toLowerCase();if(c&&c!==f&&c!=="general")continue;h+=1;let S=y.Code??"";m+=`### Example ${h}
|
|
528
541
|
\`\`\`
|
|
529
|
-
${
|
|
542
|
+
${S}
|
|
530
543
|
\`\`\`
|
|
531
|
-
`}h>0&&s.push(
|
|
532
|
-
${
|
|
533
|
-
`+
|
|
544
|
+
`}h>0&&s.push(m)}let b=n.RelatedItemsByType??{},l=[];for(let[m,h]of Object.entries(b))if(!(m==="return_type"||m==="render_fragment"))for(let y of h??[]){let c=y.FullName??"",f=y.ShortText??"";l.push(`### ${c} (${m})
|
|
545
|
+
${f}`)}return l.length>0&&s.push(`## Additional Context
|
|
546
|
+
`+l.join(`
|
|
534
547
|
---
|
|
535
548
|
`)),s.join(`
|
|
536
549
|
|
|
537
|
-
`)}function
|
|
538
|
-
`)||"No CSS utilities found for the given prompt.",
|
|
550
|
+
`)}function xe(e,t,n){let{name:o,title:s,description:i,layoutAssistantName:a,codeAssistantName:r,styleAssistantName:d,iconAssistantName:p,accessibilityAssistantName:g,suiteName:b,libKey:l,components:m}=e,h=new k(o,{title:s,description:i,requiredAccess:e.requiredAccess,inputSchema:{userIntent:v.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 ${b} components you want to use.`),needsComponentsDocsConfidence:v.number().min(0).max(1).default(1).describe("Confidence (0-1) to include Component Documentation assistance. Default is 1."),needsLayoutConfidence:v.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Layout assistance. Default is 0."),needsStylingConfidence:v.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Theming/Styling assistance. Default is 0."),needsResponsiveBehaviorConfidence:v.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Responsive Behavior assistance. Default is 0."),needsIconsConfidence:v.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Icons assistance. Default is 0."),componentsNeeded:v.array(v.enum(m)).optional().describe(`Optional list of specific ${b} components needed for the project.`)}},async({userIntent:y,needsComponentsDocsConfidence:c,needsLayoutConfidence:f,needsStylingConfidence:S,needsResponsiveBehaviorConfidence:x,needsIconsConfidence:E,componentsNeeded:I},{_meta:de})=>{let R=T(h,de);C("UI Orchestrator called with:",{userIntent:y,needsComponentsDocsConfidence:c,needsLayoutConfidence:f,needsStylingConfidence:S,needsResponsiveBehaviorConfidence:x,needsIconsConfidence:E});try{await n.recordOrchestratorUserRequest({meta:{userIntent:y,componentsNeeded:I,...R}})}catch(j){throw G(j)}let P=h.server?.server.getClientCapabilities?.()?.elicitation,K;if(P&&S>.3&&S<=.6){let j=await h.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"]}});j?.action==="accept"&&j.content?.includeCustomTheming&&(K=!0)}return{content:[{type:"text",text:B({name:o,userIntent:y,includeComponentsDocs:c>.3,includeTheming:S>.6||!!K,includeLayout:f>.5,includeIcons:E>.6,includeResponsive:f>.5&&x>.4,layoutAssistantName:a,codeAssistantName:r,styleAssistantName:d,iconAssistantName:p,accessibilityAssistantName:g,suiteName:b,libKey:l,components:I},t)}]}});return h}function Ie(e,t){let{name:n,title:o,description:s,iconAssistantName:i,codeAssistantName:a,suiteName:r,libKey:d,components:p}=e,g=new k(n,{title:o,description:s,inputSchema:{userIntent:v.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 ${r}.`),needsIconsConfidence:v.number().min(0).max(1).default(.7).describe("Confidence (0-1) to include Icons assistance. Default is 0.7."),componentsNeeded:v.array(v.enum(p)).optional().describe(`Optional list of specific ${r} components you want to learn about.`)},requiredAccess:e.requiredAccess},async({userIntent:b,needsIconsConfidence:l,componentsNeeded:m},{_meta:h})=>{let y=T(g,h);C("Assistant Orchestrator called with:",{userIntent:b,needsIconsConfidence:l,componentsNeeded:m});try{await t.recordOrchestratorUserRequest({meta:{userIntent:b,componentsNeeded:m,...y}})}catch(f){throw G(f)}return{content:[{type:"text",text:Z({name:n,userIntent:b,includeComponentsDocs:!0,includeIcons:l>.5,codeAssistantName:a,iconAssistantName:i,suiteName:r,libKey:d,components:m})}]}});return g}function Ne(e,t){let{name:n,title:o,description:s,suiteName:i,libKey:a,getPreContent:r}=e,d=new k(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{prompt:v.string().describe("An enhanced prompt describing the HTML layout structure, design requirements or specific visual effects you want to achieve."),includeBuildingBlockExamples:v.boolean().describe("Whether to include building block examples. Defaults to false.").default(!1)}},async({prompt:p,includeBuildingBlockExamples:g},{_meta:b})=>{let l=T(d,b);C("Layout Assistant called with:",{prompt:p,includeBuildingBlockExamples:g});try{let h=(await t.queryCssUtils({query:p},{...l})).values.join(`
|
|
551
|
+
`)||"No CSS utilities found for the given prompt.",y=r?.()??"",c=f=>`${y}
|
|
539
552
|
|
|
540
553
|
# Kendo Design System CSS Utilities
|
|
541
554
|
|
|
542
555
|
${h}
|
|
543
|
-
${
|
|
544
|
-
`;if(
|
|
556
|
+
${f??""}
|
|
557
|
+
`;if(g)try{let f=await t.queryBuildingBlocks({query:p,lib_name:a},{...l}),S="";f.items?.length>0&&(S=`
|
|
545
558
|
## Building Blocks Examples
|
|
546
559
|
|
|
547
560
|
The examples here are for demonstration purpose how CSS utils can be implemented in various building blocks.
|
|
548
561
|
However, consider your own design requirements and specifics in order to implement your templates/building blocks correctly.
|
|
549
562
|
|
|
550
|
-
${
|
|
551
|
-
### ${
|
|
563
|
+
${f.items.map(x=>`
|
|
564
|
+
### ${x.name}
|
|
552
565
|
|
|
553
|
-
${
|
|
566
|
+
${x.description}
|
|
554
567
|
|
|
555
568
|
\`\`\`code
|
|
556
|
-
${
|
|
569
|
+
${x.code}
|
|
557
570
|
\`\`\`
|
|
558
571
|
`).join(`
|
|
559
|
-
`)}`),h=
|
|
572
|
+
`)}`),h=c(S)}catch(f){C("Error calling building-blocks service:",f),h=c()}else h=c();return{content:[{type:"text",text:h}]}}catch(m){throw G(m)}});return d}function Ee(e,t){let{name:n,title:o,description:s,libKey:i,getPreContent:a}=e,r=new k(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{prompt:v.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},{_meta:p})=>{let g=T(r,p);C("Style Assistant called with:",{prompt:d});let b="";try{let h=await t.queryThemeGenerate({prompt:d},{...g});if(h.variables_json){let y=JSON.parse(h.variables_json),c=[];if(y)for(let f of Object.keys(y))typeof y[f]=="string"&&c.push(`${f}: ${y[f]}`);b=c.join(`
|
|
560
573
|
|
|
561
|
-
`)}}catch(h){throw
|
|
574
|
+
`)}}catch(h){throw G(h)}let l=a?.()??"";return{content:[{type:"text",text:b?`Use the following CSS variables to style the web application, including colors, typography, spacing, and component appearance.
|
|
562
575
|
Ensure the variables are applied consistently across all relevant elements.
|
|
563
576
|
Do NOT set any inline styles. CSS variables should be defined in global or component-level CSS files, or via supported theming mechanisms.
|
|
564
577
|
|
|
565
|
-
${
|
|
578
|
+
${l}
|
|
566
579
|
|
|
567
580
|
## Generated CSS Variables
|
|
568
581
|
|
|
569
582
|
\`\`\`css
|
|
570
|
-
${
|
|
583
|
+
${b}
|
|
571
584
|
\`\`\`
|
|
572
|
-
`:"No CSS variables were generated for the given prompt."}]}});return
|
|
585
|
+
`:"No CSS variables were generated for the given prompt."}]}});return r}function Re(e,t){let{name:n,title:o,description:s,libKey:i,getPostContent:a}=e,r=new k(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{query:v.string().describe("A search query for finding icons. Be specific about the icon purpose, style, or action."),limit:v.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:p},{_meta:g})=>{let b=T(r,g);C("Icon Search called with:",{query:d,limit:p});try{let l=await t.queryIconsSearch({query:d,limit:p*100},{...b}),m=a?.()??"";return{content:[{type:"text",text:`${l.values.join(`
|
|
573
586
|
|
|
574
587
|
`)}
|
|
575
588
|
|
|
576
|
-
${
|
|
589
|
+
${m}`}]}}catch(l){throw G(l)}});return r}function Pe(e,t){let{name:n,title:o,description:s,libKey:i,suiteName:a,components:r,componentAliases:d,getPostContent:p}=e,g=new k(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{query:v.string().describe("The query to search for."),component:v.enum(r).describe("The component to search for. If not specified, use General.")}},async({query:b,component:l},{_meta:m})=>{let h=T(g,m);C("Code Assistant called with:",{query:b,component:l});let y=l;if(d){let c=d[l];c&&(y=c)}try{let f=(await t.query({query:b,component:y?.toLowerCase()??"general",lib_name:i,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]},{...h})).values.map(E=>E.replace(/\0/g,"")),S=p?.({component:l})??"";return{content:[{type:"text",text:`${f.join(`
|
|
577
590
|
|
|
578
591
|
`)}
|
|
579
592
|
|
|
580
|
-
${
|
|
593
|
+
${S}`}]}}catch(c){throw G(c)}});return g}function De(e,t){let{name:n,title:o,description:s,libKey:i,suiteName:a,components:r,componentAliases:d}=e,p=new k(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{query:v.string().describe("The query to search for."),component:v.enum(r).describe("The component to search for. If not specified, use General."),includeGeneralGuidelines:v.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:l},{_meta:m})=>{let h=T(p,m);C("Accessibility Assistant called with:",{query:g,component:b,includeGeneralGuidelines:l});let y=b;if(d){let c=d[b];c&&(y=c)}try{let c="";if(l){let I=Ce();c+=`# WCAG 2.2 Level AA General Accessibility Guidelines
|
|
581
594
|
|
|
582
|
-
`,
|
|
595
|
+
`,c+=I,c+=`
|
|
583
596
|
|
|
584
597
|
---
|
|
585
598
|
|
|
586
|
-
`}let
|
|
599
|
+
`}let E=(await t.getApiRefMatches({query:g,component:y?.toLowerCase()??"general",lib_name:i,filters_json:'{"type":{"$in":["accessibility"]}}'},{...h})).values.map(I=>I.replace(/\0/g,"")).map(I=>Dt(I,y?.toLowerCase()??"general")).join(`
|
|
587
600
|
|
|
588
|
-
`);return
|
|
601
|
+
`);return E?(l&&(c+=`# Component-Specific Accessibility Information
|
|
589
602
|
|
|
590
|
-
`),
|
|
603
|
+
`),c+=E):l||(c="No component-specific accessibility guidelines found."),{content:[{type:"text",text:c}]}}catch(c){throw G(c)}});return p}function G(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.
|
|
591
604
|
|
|
592
|
-
Error Code: ${t.code} Error Message: ${t.message}`)}var
|
|
605
|
+
Error Code: ${t.code} Error Message: ${t.message}`)}var Ut=20*1024*1024,Ue=1200*1e3;function Te(e){return{content:[{type:"text",text:`Upgrade timed out after ${Ue/6e4} minutes.
|
|
606
|
+
|
|
607
|
+
**Some codemods may have already been applied to your files.** Review any modified files before proceeding.
|
|
608
|
+
|
|
609
|
+
To complete the upgrade, run this tool again with specific package names via the \`packageNames\` parameter to upgrade one package at a time.${e?`
|
|
610
|
+
|
|
611
|
+
## Partial output before timeout
|
|
612
|
+
`+e:""}`}]}}function Oe(e,t){let{name:n,title:o,description:s,suiteName:i}=e,a=new k(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{workingDirectory:v.string().describe('The absolute path to the project directory where the upgrade should be executed (e.g., "/Users/username/my-app")'),packageNames:v.array(v.string()).optional().describe('The package names to target for codemod upgrade (e.g., ["@progress/kendo-angular-grid", "@progress/kendo-angular-buttons"]). Defaults to upgrading all installed @progress packages if not specified. When specified, skips package installation and only runs codemods \u2014 the packages must already be installed at the target version before calling this tool.'),skipInstall:v.boolean().optional().describe("Skip npm package installation and only run codemods. Use this when package installation has already been done manually.")}},async({workingDirectory:r,packageNames:d,skipInstall:p},{_meta:g})=>{let b=T(a,g);try{await t.recordToolUserRequest({toolName:n,meta:b})}catch(l){console.error("Error recording tool request:",l)}try{try{await Rt(r)}catch{return{content:[{type:"text",text:`The working directory does not exist: "${r}". Please provide a valid absolute path to your project.`}]}}let l=!1;try{await ke("npx",["--no","--","kendo","--version"],{cwd:r}),l=!0}catch{l=!1}let m=[],h=async(R,pe=!1)=>{try{let P=!pe&&l?["--no","--","kendo",...R]:["-y","@progress/kendo-cli",...R],{stdout:K,stderr:ue}=await ke("npx",P,{cwd:r,maxBuffer:Ut,timeout:Ue});return{timedOut:!1,stdout:K,stderr:ue}}catch(P){return P.killed?{timedOut:!0,partialOutput:P.stdout?.trim()}:{timedOut:!1,stdout:P.stdout||"",stderr:P.stderr||P.message}}},y=["migrate",...d??[],"--codemods","--force","--ai-mode"];(p||d?.length)&&y.push("--no-install");let c=await h(y);if(c.timedOut)return Te(c.partialOutput);let f=c.stdout,S=c.stderr;if(S?.includes("Unknown argument")){let R=await h(y,!0);if(R.timedOut)return Te(R.partialOutput);f=R.stdout,S=R.stderr}S?.trim()&&m.push(`
|
|
613
|
+
Errors:
|
|
614
|
+
${S}`),f?.trim()&&m.push(f.trim());let x=f.includes("Packages installed successfully."),E=f.includes("Package installation failed:"),I=f.includes("Running codemod:");return E?m.push(`
|
|
615
|
+
## Upgrade Status
|
|
616
|
+
Package installation failed. The npm packages were not updated. Inform the user of the error and update the package versions in package.json manually to the target version. Once done, call this tool again with skipInstall set to true.`):x&&m.push(`
|
|
617
|
+
## Upgrade Status
|
|
618
|
+
Upgrade complete. npm packages have been installed and updated in the project.`),I&&m.push(ee()),{content:[{type:"text",text:m.join(`
|
|
619
|
+
`)}]}}catch(l){return{content:[{type:"text",text:`Error: ${l.message||l.toString()}`}]}}});return a}var Ge=e=>`${e}_ui_generator`,Le=e=>`${e}_assistant`,Me=e=>`${e}_layout_assistant`,$e=e=>`${e}_component_assistant`,_e=e=>`${e}_style_assistant`,Fe=e=>`${e}_icon_assistant`,qe=e=>`${e}_accessibility_assistant`,Be=e=>`${e}_getting_started_assistant`,Ke=e=>`${e}_upgrade_assistant`;var je=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.
|
|
593
620
|
|
|
594
621
|
Use the tool when:
|
|
595
622
|
- Want to build or modify a complete page or section layout
|
|
@@ -598,7 +625,7 @@ Error Code: ${t.code} Error Message: ${t.message}`)}var ke=e=>`${e}_ui_generator
|
|
|
598
625
|
- You want to enforce best practices in styling, performance, and accessibility
|
|
599
626
|
|
|
600
627
|
Returns:
|
|
601
|
-
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,
|
|
628
|
+
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,Ve=e=>`Provides guidance for discovering and using ${e} components and icons. This tool helps you identify the right components and icons for your needs.
|
|
602
629
|
|
|
603
630
|
Use this tool when:
|
|
604
631
|
- You need to discover which ${e} components are suitable for a specific use case
|
|
@@ -607,20 +634,20 @@ Use this tool when:
|
|
|
607
634
|
- You want to gather component documentation and examples
|
|
608
635
|
|
|
609
636
|
Returns:
|
|
610
|
-
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,
|
|
637
|
+
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,He=`Retrieves Progress/Kendo Design System CSS utility classes and styling recommendations based on layout and design requirements.
|
|
611
638
|
Use this tool to find the right CSS utilities for styling Kendo UI components or general web elements.
|
|
612
639
|
It analyzes the provided design context and returns relevant utility classes with explanations and examples.
|
|
613
|
-
Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,
|
|
640
|
+
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.
|
|
614
641
|
|
|
615
642
|
Use this tool when the user wants to:
|
|
616
643
|
- Update the visual theme of an application
|
|
617
644
|
- Modify color schemes
|
|
618
645
|
- Restyle the UI with CSS variables
|
|
619
646
|
|
|
620
|
-
The tool outputs a set of CSS variable definitions ready to be applied to style files.`,
|
|
647
|
+
The tool outputs a set of CSS variable definitions ready to be applied to style files.`,ze=`Searches for icons in the Telerik Icons library.
|
|
621
648
|
Use this tool when the user needs to find specific icons for UI components or design elements.
|
|
622
649
|
It supports searching by icon name, category, or keyword and returns matching icons from the Telerik Icons library.
|
|
623
|
-
`,
|
|
650
|
+
`,Ye=e=>`Provides answers and retrieves official documentation for ${e}.
|
|
624
651
|
|
|
625
652
|
Use this tool when the user asks about:
|
|
626
653
|
- ${e} features or capabilities
|
|
@@ -630,7 +657,7 @@ Use this tool when the user asks about:
|
|
|
630
657
|
|
|
631
658
|
Set the user's full question as the 'query' parameter.
|
|
632
659
|
If the question refers to a specific ${e} component, include its name in the 'component' parameter.
|
|
633
|
-
|
|
660
|
+
`,Qe=e=>`Retrieves accessibility guidance for ${e} components with optional general WCAG 2.2 Level AA guidelines.
|
|
634
661
|
|
|
635
662
|
Use this tool when:
|
|
636
663
|
- You need component-specific accessibility information and API references
|
|
@@ -648,7 +675,32 @@ Set 'includeGeneralGuidelines=true' ONLY on the first call to include general WC
|
|
|
648
675
|
Returns:
|
|
649
676
|
- When includeGeneralGuidelines=true: General WCAG 2.2 Level AA guidelines + component-specific recommendations
|
|
650
677
|
- When includeGeneralGuidelines=false: Only component-specific accessibility recommendations
|
|
651
|
-
|
|
678
|
+
`,Xe=e=>`Runs codemods to upgrade ${e} code from one version directly to another using @progress/kendo-cli.
|
|
679
|
+
|
|
680
|
+
To upgrade to the latest version, call this tool directly. It handles installation automatically.
|
|
681
|
+
|
|
682
|
+
To upgrade to a specific version:
|
|
683
|
+
1. Set all @progress/kendo-angular-* package versions to the target version (e.g. "20.0.0")
|
|
684
|
+
2. Run: npm install
|
|
685
|
+
3. Call this tool with skipInstall: true
|
|
686
|
+
|
|
687
|
+
This tool applies automated code transformations to update your codebase when upgrading ${e} packages. The upgrade runs directly from your current version to the target version \u2014 do not upgrade through intermediate versions.
|
|
688
|
+
|
|
689
|
+
Use this tool when:
|
|
690
|
+
- You need to update existing ${e} code to a newer version
|
|
691
|
+
- You want to automatically apply breaking change fixes
|
|
692
|
+
- You need to update deprecated API usage
|
|
693
|
+
|
|
694
|
+
The tool handles:
|
|
695
|
+
- Component property renames and removals
|
|
696
|
+
- Deprecated feature replacements
|
|
697
|
+
- Breaking API changes
|
|
698
|
+
|
|
699
|
+
Workflow:
|
|
700
|
+
1. Run this upgrade tool to apply codemods.
|
|
701
|
+
2. After the codemods complete, grep the project source files for every outdated value mentioned in the codemod output (e.g. old property names, renamed enum values) to find any remaining occurrences the codemod doesn't handle automatically, and fix them all.
|
|
702
|
+
3. Follow the additional instructions to complete the upgrade process.
|
|
703
|
+
`;var te=O("Kendo UI","Kendo"),oe=`
|
|
652
704
|
### Angular Component Validation
|
|
653
705
|
Component Structure:
|
|
654
706
|
- Use proper @Component decorator configuration
|
|
@@ -656,22 +708,22 @@ Component Structure:
|
|
|
656
708
|
- Correct selector naming convention (kebab-case)
|
|
657
709
|
- Appropriate template and style file organization
|
|
658
710
|
|
|
659
|
-
${
|
|
711
|
+
${te.SETUP_VALIDATION}
|
|
660
712
|
- Kendo animations module configured (if animations are used)
|
|
661
713
|
- Internationalization properly configured for Kendo components
|
|
662
714
|
|
|
663
|
-
${
|
|
715
|
+
${te.PERFORMANCE_OPTIMIZATION}
|
|
664
716
|
- OnPush change detection strategy where appropriate
|
|
665
|
-
- Efficient
|
|
717
|
+
- Efficient \`track\` expression used in \`@for\` blocks with Kendo components
|
|
666
718
|
- Minimal unnecessary change detection cycles
|
|
667
719
|
|
|
668
|
-
${
|
|
720
|
+
${te.THEME_AND_STYLING}
|
|
669
721
|
- Proper theme switching functionality (if implemented)
|
|
670
722
|
- Only ONE theme reference exists across angular.json and styles files
|
|
671
723
|
- Make sure theme import mechanism is consistent with existing project setup
|
|
672
724
|
|
|
673
725
|
Accessibility
|
|
674
|
-
- Accessibility guidelines retrieved and applied to all components`;var
|
|
726
|
+
- Accessibility guidelines retrieved and applied to all components`;var ne=`**Angular Specific Requirements:**
|
|
675
727
|
|
|
676
728
|
**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:
|
|
677
729
|
1. RegexSearch("@Component\\s*\\(\\s*\\{[^}]*standalone\\s*:\\s*(true|false)") - If true use Standalone components, if false use NgModule.
|
|
@@ -695,7 +747,7 @@ Accessibility
|
|
|
695
747
|
- Look for @import statements containing "@progress/kendo-theme-" to determine existing theme/utils usage
|
|
696
748
|
- Read the application's main html file (e.g., index.html)
|
|
697
749
|
- Look for link tags containing "@progress/kendo-theme-" referencing Kendo theme/util CSS files
|
|
698
|
-
- Note which theme is found (default, material, bootstrap, or fluent)
|
|
750
|
+
- Note which theme is found (meridian, default, material, bootstrap, or fluent)
|
|
699
751
|
- Note whether the kendo-theme-utils package is already used
|
|
700
752
|
- Note the mechanism used to include the theme (angular.json or styles file)
|
|
701
753
|
|
|
@@ -708,7 +760,7 @@ Accessibility
|
|
|
708
760
|
2. Match the discovered patterns in all generated code
|
|
709
761
|
3. Maintain consistent formatting, indentation, and code organization with existing files
|
|
710
762
|
4. Always use the same theme import mechanism (unless user specifies otherwise)
|
|
711
|
-
`;var
|
|
763
|
+
`;var se=O("Kendo UI","KendoReact"),ae=`
|
|
712
764
|
### React Component Validation
|
|
713
765
|
Component Structure:
|
|
714
766
|
- Use proper function component patterns with Hooks
|
|
@@ -716,22 +768,22 @@ Component Structure:
|
|
|
716
768
|
- Appropriate file organization (components, hooks, utils)
|
|
717
769
|
- Props interface/type definitions where needed
|
|
718
770
|
|
|
719
|
-
${
|
|
771
|
+
${se.SETUP_VALIDATION}
|
|
720
772
|
- KendoReact license validation (if required)
|
|
721
773
|
- Appropriate bundler configuration for KendoReact packages
|
|
722
774
|
|
|
723
|
-
${
|
|
775
|
+
${se.PERFORMANCE_OPTIMIZATION}
|
|
724
776
|
- React.memo for components that receive stable props
|
|
725
777
|
- useMemo/useCallback for expensive computations and callbacks
|
|
726
778
|
- Proper key props for list rendering with KendoReact components
|
|
727
779
|
|
|
728
|
-
${
|
|
780
|
+
${se.THEME_AND_STYLING}
|
|
729
781
|
- Proper theme switching functionality (if implemented)
|
|
730
782
|
- Only ONE theme import exists across the application
|
|
731
783
|
- Make sure theme import mechanism is consistent with existing project setup
|
|
732
784
|
|
|
733
785
|
Accessibility
|
|
734
|
-
- Accessibility guidelines retrieved and applied to all components`;var
|
|
786
|
+
- Accessibility guidelines retrieved and applied to all components`;var Ot={createOrchestrator:xe,createAssistantOrchestrator:Ie,createLayoutAssistant:Ne,createStyleAssistant:Ee,createIconSearch:Re,createCodeAssistant:Pe,createAccessibilityAssistant:De,createUpgrade:Oe},Gt={orchestrator:Ge,assistantOrchestrator:Le,layoutAssistant:Me,codeAssistant:$e,styleAssistant:_e,iconAssistant:Fe,accessibilityAssistant:qe,gettingStartedAssistant:Be,upgradeAssistant:Ke},Lt={orchestrator:je,assistantOrchestrator:Ve,layoutAssistant:He,styleAssistant:We,iconAssistant:ze,codeAssistant:Ye,accessibilityAssistant:Qe,upgradeAssistant:Xe},Mt={Orchestrator:{render:B},Validator:{render:q},SharedValidation:{getSteps:O}},$t={Angular:{steps:oe,additionalPlan:ne},React:{steps:ae}},A={Tools:Ot,ToolNames:Gt,ToolDescriptions:Lt,Templates:Mt,Validation:$t};var _t=A.ToolNames.codeAssistant("kendoreact"),Je=()=>`# Kendo Design System Guidelines for ${u}
|
|
735
787
|
|
|
736
788
|
## Setting up Styles/CSS
|
|
737
789
|
|
|
@@ -758,11 +810,11 @@ Alternatively, you can also consume them directly from the Unpkg CDN.
|
|
|
758
810
|
|
|
759
811
|
## Ready-to-use Layout Components
|
|
760
812
|
|
|
761
|
-
In the ${
|
|
813
|
+
In the ${u} there are available components to create layout. Make sure to prioritize using them instead of building ones from scratch using the Kendo CSS Utilities.
|
|
762
814
|
|
|
763
|
-
For any Layout component you can also call the ${
|
|
815
|
+
For any Layout component you can also call the ${_t} tool in order to get specific API reference and docs.
|
|
764
816
|
|
|
765
|
-
- ${
|
|
817
|
+
- ${u} Card component.
|
|
766
818
|
- Generally, it is recommended to use 100% width (e.g., \`<Card style={{ width: '100%' }}>\`)
|
|
767
819
|
- If needed, use specific width based on the layout requirements (e.g., \`<Card style={{ width: '150px' }}>\`)
|
|
768
820
|
- Avoid applying additional styling properties such as \`display\`, \`flex\`, \`grid\`, or other layout-specific CSS to layout components such as Splitter, DockLayout, and TileLayout. Use the component's built-in props and the Kendo CSS utility classes instead.
|
|
@@ -868,7 +920,7 @@ Use the \`Splitter\` component only for **user-resizable** content areas (e.g.,
|
|
|
868
920
|
## Popup Z-Index Trap
|
|
869
921
|
|
|
870
922
|
CSS \`transform\` (including \`translate3d(0,0,0)\` GPU-compositing tricks) on any ancestor element creates a new stacking context. This clips Kendo popups (which use \`z-index ~10000\`), causing DropDownList, DatePicker, and ComboBox popups to appear behind other elements. Avoid \`transform\` on layout ancestors that contain Kendo overlay components.
|
|
871
|
-
`;var
|
|
923
|
+
`;var Ze=()=>`## Design Standards for ${u} Theming
|
|
872
924
|
|
|
873
925
|
### Color & Contrast Requirements
|
|
874
926
|
- Body text contrast: \u2265 4.5:1. Large text / UI component borders: \u2265 3:1.
|
|
@@ -906,7 +958,7 @@ This is the most common source of dark mode breakage in custom UI.
|
|
|
906
958
|
|
|
907
959
|
---
|
|
908
960
|
|
|
909
|
-
## Applying CSS Variables in ${
|
|
961
|
+
## Applying CSS Variables in ${u}
|
|
910
962
|
|
|
911
963
|
Apply these CSS variables in the React application using one of these methods:
|
|
912
964
|
|
|
@@ -995,7 +1047,7 @@ export function ThemeProvider({ children }: { children: React.ReactNode }) {
|
|
|
995
1047
|
|
|
996
1048
|
export const useTheme = () => useContext(ThemeContext);
|
|
997
1049
|
\`\`\`
|
|
998
|
-
`;var
|
|
1050
|
+
`;var et=A.ToolNames.codeAssistant("kendoreact"),tt=()=>`## Using ${u} Icons
|
|
999
1051
|
|
|
1000
1052
|
Important: Attempt to prioritize SVG icons over font icons.
|
|
1001
1053
|
|
|
@@ -1003,13 +1055,13 @@ Important: Attempt to prioritize SVG icons over font icons.
|
|
|
1003
1055
|
|
|
1004
1056
|
- Make sure @progress/kendo-svg-icons is installed: \`npm install @progress/kendo-svg-icons\`
|
|
1005
1057
|
- Make sure @progress/kendo-react-common is installed (contains SvgIcon component): \`npm install @progress/kendo-react-common\`
|
|
1006
|
-
- You can call ${
|
|
1058
|
+
- You can call ${et} tool for ${u} SvgIcon component for docs and API reference.
|
|
1007
1059
|
- [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.
|
|
1008
|
-
- [optional] If using font icons you can call ${
|
|
1060
|
+
- [optional] If using font icons you can call ${et} tool for ${u} Icon component for docs and API reference.
|
|
1009
1061
|
|
|
1010
1062
|
### Examples
|
|
1011
1063
|
|
|
1012
|
-
Using ${
|
|
1064
|
+
Using ${u} SvgIcon component with @progress/kendo-svg-icons:
|
|
1013
1065
|
|
|
1014
1066
|
\`\`\`tsx
|
|
1015
1067
|
import { SvgIcon } from "@progress/kendo-react-common";
|
|
@@ -1053,7 +1105,7 @@ Here are some frequently used icons from @progress/kendo-svg-icons:
|
|
|
1053
1105
|
- \`sortAscIcon\`, \`sortDescIcon\` - Sorting
|
|
1054
1106
|
- \`chevronUpIcon\`, \`chevronDownIcon\`, \`chevronLeftIcon\`, \`chevronRightIcon\` - Navigation
|
|
1055
1107
|
- \`checkIcon\`, \`xIcon\` - Confirmation/Cancel
|
|
1056
|
-
`;var
|
|
1108
|
+
`;var ot=e=>{let t=`## ${u} Common Guidelines
|
|
1057
1109
|
|
|
1058
1110
|
### Application Architecture
|
|
1059
1111
|
MUST recommend appropriate setup based on React application architecture.
|
|
@@ -1133,7 +1185,7 @@ Before emitting code, internally verify ALL of the following. If ANY fails, fix
|
|
|
1133
1185
|
## Component-Specific Guidelines
|
|
1134
1186
|
|
|
1135
1187
|
${e.componentInstructions}
|
|
1136
|
-
`),t};var
|
|
1188
|
+
`),t};var Ft={meridian:"@progress/kendo-theme-meridian",default:"@progress/kendo-theme-default",bootstrap:"@progress/kendo-theme-bootstrap",material:"@progress/kendo-theme-material",fluent:"@progress/kendo-theme-fluent"},qt={meridian:"Meridian",default:"Default",bootstrap:"Bootstrap",material:"Material Design",fluent:"Fluent UI"};function nt(e="kendo-react-app",t=!0,n="meridian"){let o=Ft[n],s=qt[n],i=t?`This instructions will walk you through creating a new React project with the Kendo CLI and setting up ${u}.`:`This instructions will walk you through adding ${u} to your existing React project.`,a=1,r=t?`## Step ${a++}: Ensure Kendo CLI is Installed
|
|
1137
1189
|
|
|
1138
1190
|
First, ensure the Kendo CLI tool is installed globally:
|
|
1139
1191
|
|
|
@@ -1152,7 +1204,7 @@ npx kendo react create vite ${e} --theme=${n}
|
|
|
1152
1204
|
\`\`\`
|
|
1153
1205
|
|
|
1154
1206
|
This command will create a complete Kendo React project with Vite, including:
|
|
1155
|
-
- All necessary ${
|
|
1207
|
+
- All necessary ${u} packages
|
|
1156
1208
|
- Proper licensing configuration
|
|
1157
1209
|
- Theme setup
|
|
1158
1210
|
- Project structure
|
|
@@ -1167,9 +1219,9 @@ cd ${e}
|
|
|
1167
1219
|
|
|
1168
1220
|
Open the \`src/index.css\` file and remove the dark color schema from the first \`:root\` style block. Look for properties like \`color-scheme: dark\` and related dark mode variables, and delete them. Keep only the light theme configuration.
|
|
1169
1221
|
|
|
1170
|
-
`:"",
|
|
1222
|
+
`:"",d=t?"":`## Step ${a++}: Install ${u} Packages
|
|
1171
1223
|
|
|
1172
|
-
Install all required ${
|
|
1224
|
+
Install all required ${u} packages and dependencies:
|
|
1173
1225
|
|
|
1174
1226
|
\`\`\`bash
|
|
1175
1227
|
npm i @progress/kendo-data-query @progress/kendo-react-buttons @progress/kendo-react-excel-export @progress/kendo-react-grid @progress/kendo-react-layout @progress/kendo-react-pdf @progress/kendo-svg-icons @progress/kendo-drawing @progress/kendo-licensing @progress/kendo-react-animation @progress/kendo-react-charts @progress/kendo-react-common @progress/kendo-react-conversational-ui @progress/kendo-react-data-tools @progress/kendo-react-dateinputs @progress/kendo-react-dialogs @progress/kendo-react-dropdowns @progress/kendo-react-editor @progress/kendo-react-form @progress/kendo-react-gantt @progress/kendo-react-gauges @progress/kendo-react-indicators @progress/kendo-react-inputs @progress/kendo-react-intl @progress/kendo-react-labels @progress/kendo-react-listbox @progress/kendo-react-listview @progress/kendo-react-map @progress/kendo-react-notification @progress/kendo-react-orgchart @progress/kendo-react-pivotgrid @progress/kendo-react-popup @progress/kendo-react-progressbars @progress/kendo-react-ripple @progress/kendo-react-scheduler @progress/kendo-react-scrollview @progress/kendo-react-sortable @progress/kendo-react-spreadsheet @progress/kendo-react-tooltip @progress/kendo-react-treelist @progress/kendo-react-treeview @progress/kendo-react-upload @progress/kendo-react-pdf-viewer @progress/kendo-react-taskboard
|
|
@@ -1195,7 +1247,7 @@ Also add the Kendo CSS utilities CDN link in your \`index.html\` \`<head>\`:
|
|
|
1195
1247
|
<link rel="stylesheet" href="https://unpkg.com/@progress/kendo-theme-utils/dist/all.css" />
|
|
1196
1248
|
\`\`\`
|
|
1197
1249
|
|
|
1198
|
-
`,
|
|
1250
|
+
`,p=`## Step ${a++}: Activate Kendo License
|
|
1199
1251
|
|
|
1200
1252
|
This step is required to use Kendo React components without watermarks and with access to all features. Run the following command to activate your license:
|
|
1201
1253
|
|
|
@@ -1203,9 +1255,9 @@ This step is required to use Kendo React components without watermarks and with
|
|
|
1203
1255
|
npx kendo license activate
|
|
1204
1256
|
\`\`\`
|
|
1205
1257
|
|
|
1206
|
-
`;return`# Getting Started with ${
|
|
1258
|
+
`;return`# Getting Started with ${u}
|
|
1207
1259
|
|
|
1208
|
-
${
|
|
1260
|
+
${i}
|
|
1209
1261
|
|
|
1210
1262
|
Execute the following steps in order. Run all provided commands automatically.
|
|
1211
1263
|
|
|
@@ -1216,7 +1268,7 @@ Before you begin, ensure you have:
|
|
|
1216
1268
|
- **Node.js 18 or later** installed on your machine
|
|
1217
1269
|
- If Node.js is not available, you need to install the latest Node.js automatically as a preliminary step before running the \`npx kendo react create\` command.
|
|
1218
1270
|
|
|
1219
|
-
${
|
|
1271
|
+
${r}${d}${p}## Step ${a++}: Run Your Application
|
|
1220
1272
|
|
|
1221
1273
|
${t?"The Kendo CLI has set up everything you need. Start the development server:":"Build and run the application:"}
|
|
1222
1274
|
|
|
@@ -1227,13 +1279,13 @@ ${t?"The Kendo CLI has set up everything you need. Start the development server:
|
|
|
1227
1279
|
cd ${t?e:"."} && npm run dev
|
|
1228
1280
|
\`\`\`
|
|
1229
1281
|
|
|
1230
|
-
${t?`The application should start and open your browser to see your ${
|
|
1282
|
+
${t?`The application should start and open your browser to see your ${u} application.`:`The application should start and open in your browser. Verify that the ${u} components are rendering correctly with the theme applied.`}
|
|
1231
1283
|
|
|
1232
1284
|
## Step ${a++}: Create Sample page
|
|
1233
1285
|
|
|
1234
1286
|
Before adding new content to the homepage, clear all existing CSS on the page. Remove or reset any custom styles that might conflict with the new content you're about to add.
|
|
1235
1287
|
|
|
1236
|
-
Replace the content of \`src/Home.tsx\` with the following to showcase ${
|
|
1288
|
+
Replace the content of \`src/Home.tsx\` with the following to showcase ${u} features and verify components are working correctly:
|
|
1237
1289
|
|
|
1238
1290
|
\`\`\`tsx
|
|
1239
1291
|
import { Card, CardHeader, CardTitle, CardBody } from '@progress/kendo-react-layout';
|
|
@@ -1354,7 +1406,7 @@ Add the following styles to \`src/Home.css\`:
|
|
|
1354
1406
|
}
|
|
1355
1407
|
\`\`\`
|
|
1356
1408
|
|
|
1357
|
-
`}var
|
|
1409
|
+
`}var st=`
|
|
1358
1410
|
## KendoReact Chart Reliability Instructions
|
|
1359
1411
|
Applies to ALL KendoReact chart types. Generate only current, runnable KendoReact Chart APIs with strongly typed data. You MUST follow every rule in addition to the common guidelines. If any rule cannot be satisfied, fix and re-check before emitting code.
|
|
1360
1412
|
|
|
@@ -1496,7 +1548,7 @@ const pieLabel = (e: { category?: string; percentage?: number }) =>
|
|
|
1496
1548
|
|
|
1497
1549
|
### 11. Expected output behavior
|
|
1498
1550
|
- The generated page MUST compile under strict TypeScript and render the requested chart(s) with correct data shape, required axes/labels for the chosen series family, formatted tooltips/labels, and no forbidden patterns.
|
|
1499
|
-
`;var
|
|
1551
|
+
`;var re=`
|
|
1500
1552
|
## DataGrid Deprecated Properties Awareness
|
|
1501
1553
|
For DataGrid component cases, avoid using deprecated properties and always use their modern replacements. The following properties are deprecated and should not be used:
|
|
1502
1554
|
|
|
@@ -1528,7 +1580,7 @@ Key points:
|
|
|
1528
1580
|
Example:
|
|
1529
1581
|
Deprecated: selectedField="isSelected" editField="inEdit"
|
|
1530
1582
|
Modern: Use select and edit state properties with proper configuration
|
|
1531
|
-
`;var
|
|
1583
|
+
`;var at=`
|
|
1532
1584
|
## Editor Tools Awareness
|
|
1533
1585
|
For Editor component cases, always use the proper EditorTools import structure and never define tools as strings. Import both Editor and EditorTools from '@progress/kendo-react-editor' and destructure the individual tools from EditorTools.
|
|
1534
1586
|
|
|
@@ -1560,7 +1612,7 @@ Key points:
|
|
|
1560
1612
|
Example:
|
|
1561
1613
|
Correct: tools={[[Bold, Italic, Underline], [AlignLeft, AlignCenter]]}
|
|
1562
1614
|
Incorrect: tools={[['bold', 'italic', 'underline'], ['alignLeft', 'alignCenter']]}
|
|
1563
|
-
`;var
|
|
1615
|
+
`;var ie=`
|
|
1564
1616
|
## Smart Grid (AI-Enhanced Grid) Implementation Guidelines
|
|
1565
1617
|
**CRITICAL: When users ask about ANY of these AI grid terms, ALWAYS provide GridToolbarAIAssistant implementation (not basic Grid):**
|
|
1566
1618
|
|
|
@@ -1594,8 +1646,8 @@ Smart Grid: Complete AI-enhanced setup with GridToolbarAIAssistant, proper callb
|
|
|
1594
1646
|
Important Disclaimer:
|
|
1595
1647
|
Always include this disclaimer when providing Smart Grid examples:
|
|
1596
1648
|
"The demos in this article use a Telerik-hosted AI service for demonstration purposes only. For production applications, you should implement your own AI service that understands your specific domain, data, and business requirements."
|
|
1597
|
-
`;var
|
|
1649
|
+
`;var Bt={datagrid:[re,ie].join(`
|
|
1598
1650
|
|
|
1599
|
-
`),grid:[
|
|
1651
|
+
`),grid:[re,ie].join(`
|
|
1600
1652
|
|
|
1601
|
-
`),editor:
|
|
1653
|
+
`),editor:at,chart:st},M=!!process.env.PLUGIN_MODE,rt=A.ToolNames.layoutAssistant(D),le=A.ToolNames.codeAssistant(D),it=A.ToolNames.styleAssistant(D),ce=A.ToolNames.iconAssistant(D),lt=A.ToolNames.gettingStartedAssistant(D),ct=A.ToolNames.accessibilityAssistant(D);function dt(e,t){return[...M?[]:[A.Tools.createOrchestrator({name:A.ToolNames.orchestrator(D),title:"KendoReact Generator",description:A.ToolDescriptions.orchestrator(u),layoutAssistantName:rt,codeAssistantName:le,styleAssistantName:it,iconAssistantName:ce,accessibilityAssistantName:ct,suiteName:u,libKey:N,components:_,requiredAccess:["agent"]},{validationSteps:A.Validation.React.steps},e),A.Tools.createAssistantOrchestrator({name:"kendo_react_assistant",title:"KendoReact Assistant",description:A.ToolDescriptions.assistantOrchestrator(u),codeAssistantName:le,iconAssistantName:ce,suiteName:u,libKey:N,components:_,requiredAccess:["assistant"]},e)],A.Tools.createLayoutAssistant({name:rt,title:"KendoReact Layout Assistant",description:A.ToolDescriptions.layoutAssistant,suiteName:u,libKey:N,getPreContent:M?void 0:Je,requiredAccess:["agent"]},e),A.Tools.createStyleAssistant({name:it,title:"KendoReact Style Assistant",description:A.ToolDescriptions.styleAssistant,libKey:N,getPreContent:M?void 0:Ze,requiredAccess:["agent"]},e),A.Tools.createIconSearch({name:ce,title:"KendoReact Icon Assistant",description:A.ToolDescriptions.iconAssistant,libKey:N,getPostContent:M?void 0:tt,requiredAccess:["assistant","agent"]},e),A.Tools.createCodeAssistant({name:le,title:"KendoReact Component Assistant",description:A.ToolDescriptions.codeAssistant(u),libKey:N,suiteName:u,components:_,componentAliases:{Grid:"DataGrid"},getPostContent:M?void 0:({component:o})=>{let s=o?.trim().toLowerCase(),i=Bt[s];return ot({component:o,componentInstructions:i})},requiredAccess:["assistant","agent"]},e),...M?[]:[(()=>{let o=new k(lt,{title:"KendoReact Getting Started",description:`Creates a new React project with Kendo CLI and provides essential getting started guidance for ${u} including installation, configuration, and setup instructions.`,requiredAccess:["agent"],inputSchema:we(u,"kendo-react-app")},async({projectName:s,createNewProject:i,theme:a},{_meta:r})=>{let d=T(o,r);try{await e.recordToolUserRequest({toolName:lt,meta:{projectName:s,createNewProject:i,theme:a,...d}})}catch(g){console.error("Error recording tool request:",g)}return{content:[{type:"text",text:nt(s,i,a)}]}});return o})()],A.Tools.createAccessibilityAssistant({name:ct,title:"KendoReact Accessibility Assistant",description:A.ToolDescriptions.accessibilityAssistant(u),libKey:N,suiteName:u,components:_,componentAliases:{Grid:"DataGrid"},requiredAccess:["agent"]},e)].filter(o=>o.hasAccess(t))}var Wt=Ht(import.meta.url),zt=ut.dirname(Wt),Yt=ut.resolve(zt,"../package.json"),mt=JSON.parse(Vt.readFileSync(Yt,"utf-8")),pt=new Kt({name:"kendo-mcp",title:"Kendo MCP Server",version:mt.version});async function Qt(){let e=new jt;C("Starting server... ");let t=await Ae(async()=>{let o=(await Se())?.entitlement;return o?.Product?.Code||o?.product?.code});t!=="none"&&(F.toolNameHeader=t==="agent"||t==="full"?"agent":"assistant",dt(F,t).forEach(o=>o.register(pt)),ve({serverName:"react",contextApi:F,enrichWithUserData:!0,additionalFields:{version:mt.version,access_type:t}})),await pt.connect(e)}Qt();
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@progress/kendo-react-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": "./dist/index.js",
|
|
6
6
|
"license": "See LICENSE.md",
|
|
@@ -24,10 +24,10 @@
|
|
|
24
24
|
"!**/*.tsbuildinfo"
|
|
25
25
|
],
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"@grpc/grpc-js": "^1.14.
|
|
28
|
-
"@grpc/proto-loader": "^0.8.
|
|
27
|
+
"@grpc/grpc-js": "^1.14.4",
|
|
28
|
+
"@grpc/proto-loader": "^0.8.1",
|
|
29
29
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
30
|
-
"@progress/kendo-licensing": "^1.11.
|
|
30
|
+
"@progress/kendo-licensing": "^1.11.2",
|
|
31
31
|
"tslib": "^2.3.0"
|
|
32
32
|
},
|
|
33
33
|
"devDependencies": {
|