@progress/kendo-react-mcp 1.7.0 → 1.8.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 +270 -67
- package/package.json +2 -2
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 Et}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as Rt}from"@modelcontextprotocol/sdk/server/stdio.js";import{dirname as gt,join as ft}from"path";import{fileURLToPath as yt}from"url";import{loadLicense as st,decodeLicenseKey as at,decodeLicenseEvidence as rt}from"@progress/kendo-licensing/utils";var K=class extends Error{constructor(t){super(t),this.name="LicenseError"}};function re(e){return e.replace(/^\uFEFF/,"")}async function j(e){let t=null,n=null;try{let o=st();if(!o.success){let s=new K(o.message);throw e&&await e("license_load_failed",{error:o.message}).catch(()=>{}),s}try{t=(await at(o.value)).licenses.find(async r=>!!(await rt(r)).userId)}catch(s){console.log(s.message),e&&await e("license_load_failed",{error:s.message||"Unknown decoding error"}).catch(()=>{})}if(!t)return[re(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[re(t),null]}import O from"node:fs";import q from"node:path";var V=!1,P=process.env.DEBUG_LOG_FILE,ie=!!(P&&typeof P=="string");if(ie){let e=q.resolve(P),t=q.dirname(e);if(t!=="."&&t!==process.cwd()&&!O.existsSync(t))try{O.mkdirSync(t,{recursive:!0})}catch(n){console.error("Error creating log directory:",n)}if(!O.existsSync(e))try{O.writeFileSync(e,"")}catch(n){console.error("Error creating log file:",n)}}else V=!1;V=ie&&!!P&&O.existsSync(q.resolve(P));function b(...e){if(V&&P){let o=`${new Date().toISOString()}: ${e.join(" ")}
|
|
3
|
+
`,s=q.resolve(P);O.appendFile(s,o,r=>{r&&console.error("Error writing to log file:",r)})}}import it from"@grpc/proto-loader";import G from"@grpc/grpc-js";import de from"path";import le from"fs";import{fileURLToPath as lt}from"url";var ct=lt(import.meta.url),dt=de.dirname(ct),pe={version:"unknown"},ce=de.resolve(dt,"../package.json");le.existsSync(ce)&&(pe=JSON.parse(le.readFileSync(ce,"utf-8")));function pt(e){return e.replace(/\u2014/g,"--").replace(/\u2013/g,"-").replace(/[^\x20-\x7E]/g,"")}var B=class{constructor(t,n,o){this.contextApiUrl=t;this.protoPath=n;this.options=o;this.toolNameHeader="assistant";let s=it.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"),b("Using ContextApi URl:",this.contextApiUrl);let r=G.loadPackageDefinition(s);this.client=new r.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?G.credentials.createInsecure():G.credentials.createSsl())}buildRequestMetadata(t={}){return pt(JSON.stringify({...t,source:"npm",version:pe.version,os:process.platform,node_version:process.version}))}async getMetadata({meta:t}={meta:{}}){let[n,o]=this.isDev?["fake_license",null]:await j((l,d)=>this.logEvent(l,d)),s=process.env.CONTEXTAPI_API_KEY,r=s&&typeof s=="string",a=n&&typeof n=="string";if(!a&&!r&&o)throw new Error(`Failed to authenticate with API key or License key!
|
|
4
4
|
|
|
5
|
-
License Error: ${o}`);let i=new D.Metadata;if(a)try{i.add("x-license-key",n)}catch(m){throw h("Error adding license key to metadata:",m),new Error(`Failed to use license key: ${m.message}`)}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);let d=JSON.stringify({...t,source:"npm",version:de.version,os:process.platform,node_version:process.version});return i.add("x-request-metadata",lt(d)),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?(h("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?(h("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?(h("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?(h("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?(h("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?(h("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?(h("Error recording tool user request:",a),r(new Error(a))):s(i)})})}async logEvent(t,n){let o="h8utJ6rk4PpIWX4JMn9beQDsjVUri6KV0XYfiVwq";if(!o||typeof o!="string"){h("LOGGING_API_KEY not configured, skipping log event");return}let s=new D.Metadata;return s.add("x-api-key",o),new Promise((r,a)=>{this.client.logEvent({event_name:t,fields:n||{}},s,(i,d)=>{i?(h("Error logging event:",i),a(new Error(i))):r()})})}};import{z as F}from"zod";var Jt=F.object({user_id:F.string(),user_email:F.string().email()});import{z as C}from"zod";var ct=C.object({Product:C.object({Id:C.number().int(),Code:C.string(),Name:C.string()}),License:C.nullable(C.object({Id:C.number().int(),Name:C.string(),Type:C.string(),Active:C.boolean()})),Availability:C.array(C.object({LicenseStart:C.nullable(C.string().datetime()),LicenseEnd:C.nullable(C.string().datetime())})),IsLicenseAvailable:C.optional(C.boolean())}),eo=C.array(ct);async function pe(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 me(){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 dt=1440*60*1e3;function ue(e){let{serverName:t,contextApi:n,additionalFields:o={},intervalMs:s=dt}=e,r="mcp_server_heartbeat",a=async()=>{try{let d={server_name:t,timestamp:new Date().toISOString(),...o};await n.logEvent(r,d)}catch(d){h(`Failed to send heartbeat for ${t}:`,d)}};a();let i=setInterval(a,s);return()=>{clearInterval(i),h(`Heartbeat stopped for ${t}`)}}import{z as K}from"zod";var pt=["default","bootstrap","material","fluent"];function he(e,t){return{projectName:K.string().default(t).describe("The name of the project. Used as the project folder name when creating a new project."),createNewProject:K.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:K.enum(pt).default("default").describe("The Kendo UI theme to use. Determines which theme package is installed and imported.")}}var c="Kendo UI for React",T="react",N="kendo";var G=["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 gt=ut(mt(ht(import.meta.url)),"../proto/service.proto"),O=new M("contextapi.telerik.com:443",gt,{libName:T});var ge=async()=>O.validateUserLicense();import xt from"fs";import Je from"path";import{fileURLToPath as Et}from"url";import{z as A}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 L=(e,t)=>`# ${e.suiteName} - Code Validation & Quality Assurance
|
|
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
|
|
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 z=()=>`## 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 _=(e,t)=>{let n=$({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
|
+
${z()}
|
|
191
191
|
|
|
192
192
|
---
|
|
193
193
|
|
|
@@ -377,7 +377,7 @@ ${e.includeResponsive?"- Responsive layout works across breakpoints":""}
|
|
|
377
377
|
**Quick Fixes (if needed):**
|
|
378
378
|
|
|
379
379
|
After code implementation and validation you can make quick fixes as needed:
|
|
380
|
-
- If any build errors are found, fix them and re-run the application.
|
|
380
|
+
- If any build errors are found, fix them and re-run the application. Do NOT present the implementation as complete until the build succeeds without errors.
|
|
381
381
|
- Use ${e.codeAssistantName} for component-specific issues
|
|
382
382
|
- Use ${e.layoutAssistantName} for styling adjustments
|
|
383
383
|
|
|
@@ -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 Y=e=>`# ${e.suiteName} Assistant
|
|
390
390
|
|
|
391
391
|
**What you're looking for:**
|
|
392
392
|
|
|
@@ -479,6 +479,14 @@ After gathering information:
|
|
|
479
479
|
3. Use the official ${e.suiteName} documentation for detailed implementation guides
|
|
480
480
|
4. Refer to the component examples and code snippets provided
|
|
481
481
|
|
|
482
|
+
### Step 4: Build and Validation
|
|
483
|
+
|
|
484
|
+
After implementing the code:
|
|
485
|
+
- Run \`npm run build\` to verify the implementation compiles successfully without any build errors.
|
|
486
|
+
- If any build errors are found, fix them and re-run the build.
|
|
487
|
+
- Use ${e.codeAssistantName} for component-specific issues.
|
|
488
|
+
- Do NOT present the implementation as complete until the build succeeds without errors.
|
|
489
|
+
|
|
482
490
|
---
|
|
483
491
|
|
|
484
492
|
## Getting Started
|
|
@@ -487,11 +495,12 @@ After gathering information:
|
|
|
487
495
|
1. Start by calling ${e.codeAssistantName} for the components you need
|
|
488
496
|
2. ${e.includeIcons?`Search for icons using ${e.iconAssistantName}`:"Review the component documentation"}
|
|
489
497
|
3. Follow the ${e.suiteName} official documentation for implementation details
|
|
498
|
+
4. Run \`npm run build\` to verify the implementation compiles successfully
|
|
490
499
|
|
|
491
500
|
**Important Notes:**
|
|
492
501
|
- These tools provide documentation and guidance, not code generation
|
|
493
502
|
- Always refer to official ${e.suiteName} documentation for the most up-to-date information
|
|
494
|
-
- Tool responses include usage examples and best practices`;var
|
|
503
|
+
- Tool responses include usage examples and best practices`;var D=(e,t)=>({SETUP_VALIDATION:`
|
|
495
504
|
UI Library Setup:
|
|
496
505
|
- ${e} modules properly imported and configured
|
|
497
506
|
- ${e} theme properly loaded and applied
|
|
@@ -509,78 +518,78 @@ After gathering information:
|
|
|
509
518
|
- Do not use inline styles
|
|
510
519
|
- Consistent ${e} theme application across all components
|
|
511
520
|
- Custom theme variables properly defined and scoped
|
|
512
|
-
- ${e}
|
|
513
|
-
- Brand colors integrated with ${e} component themes`});function
|
|
521
|
+
- ${e} icons properly loaded and optimized
|
|
522
|
+
- Brand colors integrated with ${e} component themes`});function At(e,t){let n;try{n=JSON.parse(e)}catch{return e}let o=n?.Item;if(!o)return e;let s=[],r=o.FullName??o.Name??"",a=o.Type??"",i=o.Summary??"",l=o.SyntaxContent??"";s.push(`## API Reference Item
|
|
514
523
|
- Name: ${r}
|
|
515
524
|
- Type: ${a}
|
|
516
525
|
- Summary: ${i}
|
|
517
|
-
- Syntax: ${
|
|
518
|
-
`,
|
|
526
|
+
- Syntax: ${l}`);let d=n.RelatedItemsByType?.return_type;if(d?.length){let y=d[0].Text;y&&s.push(`- Return Type: ${y}`)}let u=o.Examples??[];if(u.length>0){let y=`## Examples
|
|
527
|
+
`,h=0;for(let A of u){let p=(A.Component??"").toLowerCase(),C=t.toLowerCase();if(p&&p!==C&&p!=="general")continue;h+=1;let k=A.Code??"";y+=`### Example ${h}
|
|
519
528
|
\`\`\`
|
|
520
529
|
${k}
|
|
521
530
|
\`\`\`
|
|
522
|
-
`}
|
|
523
|
-
${
|
|
524
|
-
`+
|
|
531
|
+
`}h>0&&s.push(y)}let f=n.RelatedItemsByType??{},m=[];for(let[y,h]of Object.entries(f))if(!(y==="return_type"||y==="render_fragment"))for(let A of h??[]){let p=A.FullName??"",C=A.ShortText??"";m.push(`### ${p} (${y})
|
|
532
|
+
${C}`)}return m.length>0&&s.push(`## Additional Context
|
|
533
|
+
`+m.join(`
|
|
525
534
|
---
|
|
526
535
|
`)),s.join(`
|
|
527
536
|
|
|
528
|
-
`)}function
|
|
529
|
-
`)||"No CSS utilities found for the given prompt.",
|
|
537
|
+
`)}function ye(e,t,n){let{name:o,title:s,description:r,layoutAssistantName:a,codeAssistantName:i,styleAssistantName:l,iconAssistantName:d,accessibilityAssistantName:u,suiteName:f,libKey:m,components:y}=e,h=new w(o,{title:s,description:r,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 ${f} 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(y)).optional().describe(`Optional list of specific ${f} components needed for the project.`)}},async({userIntent:A,needsComponentsDocsConfidence:p,needsLayoutConfidence:C,needsStylingConfidence:k,needsResponsiveBehaviorConfidence:I,needsIconsConfidence:R,componentsNeeded:N},{_meta:tt})=>{let ot=T(h,tt);b("UI Orchestrator called with:",{userIntent:A,needsComponentsDocsConfidence:p,needsLayoutConfidence:C,needsStylingConfidence:k,needsResponsiveBehaviorConfidence:I,needsIconsConfidence:R});try{await n.recordOrchestratorUserRequest({meta:{userIntent:A,componentsNeeded:N,...ot}})}catch(F){throw U(F)}let nt=h.server?.server.getClientCapabilities?.()?.elicitation,ae;if(nt&&k>.3&&k<=.6){let F=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"]}});F?.action==="accept"&&F.content?.includeCustomTheming&&(ae=!0)}return{content:[{type:"text",text:_({name:o,userIntent:A,includeComponentsDocs:p>.3,includeTheming:k>.6||!!ae,includeLayout:C>.5,includeIcons:R>.6,includeResponsive:C>.5&&I>.4,layoutAssistantName:a,codeAssistantName:i,styleAssistantName:l,iconAssistantName:d,accessibilityAssistantName:u,suiteName:f,libKey:m,components:N},t)}]}});return h}function be(e,t){let{name:n,title:o,description:s,iconAssistantName:r,codeAssistantName:a,suiteName:i,libKey:l,components:d}=e,u=new w(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 ${i}.`),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(d)).optional().describe(`Optional list of specific ${i} components you want to learn about.`)},requiredAccess:e.requiredAccess},async({userIntent:f,needsIconsConfidence:m,componentsNeeded:y},{_meta:h})=>{let A=T(u,h);b("Assistant Orchestrator called with:",{userIntent:f,needsIconsConfidence:m,componentsNeeded:y});try{await t.recordOrchestratorUserRequest({meta:{userIntent:f,componentsNeeded:y,...A}})}catch(C){throw U(C)}return{content:[{type:"text",text:Y({name:n,userIntent:f,includeComponentsDocs:!0,includeIcons:m>.5,codeAssistantName:a,iconAssistantName:r,suiteName:i,libKey:l,components:y})}]}});return u}function Ae(e,t){let{name:n,title:o,description:s,suiteName:r,libKey:a,getPreContent:i}=e,l=new w(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:d,includeBuildingBlockExamples:u},{_meta:f})=>{let m=T(l,f);b("Layout Assistant called with:",{prompt:d,includeBuildingBlockExamples:u});try{let h=(await t.queryCssUtils({query:d},{...m})).values.join(`
|
|
538
|
+
`)||"No CSS utilities found for the given prompt.",A=i?.()??"",p=C=>`${A}
|
|
530
539
|
|
|
531
540
|
# Kendo Design System CSS Utilities
|
|
532
541
|
|
|
533
|
-
${
|
|
534
|
-
${
|
|
535
|
-
`;if(
|
|
542
|
+
${h}
|
|
543
|
+
${C??""}
|
|
544
|
+
`;if(u)try{let C=await t.queryBuildingBlocks({query:d,lib_name:a},{...m}),k="";C.items?.length>0&&(k=`
|
|
536
545
|
## Building Blocks Examples
|
|
537
546
|
|
|
538
547
|
The examples here are for demonstration purpose how CSS utils can be implemented in various building blocks.
|
|
539
548
|
However, consider your own design requirements and specifics in order to implement your templates/building blocks correctly.
|
|
540
549
|
|
|
541
|
-
${
|
|
542
|
-
### ${
|
|
550
|
+
${C.items.map(I=>`
|
|
551
|
+
### ${I.name}
|
|
543
552
|
|
|
544
|
-
${
|
|
553
|
+
${I.description}
|
|
545
554
|
|
|
546
555
|
\`\`\`code
|
|
547
|
-
${
|
|
556
|
+
${I.code}
|
|
548
557
|
\`\`\`
|
|
549
558
|
`).join(`
|
|
550
|
-
`)}`),
|
|
559
|
+
`)}`),h=p(k)}catch(C){b("Error calling building-blocks service:",C),h=p()}else h=p();return{content:[{type:"text",text:h}]}}catch(y){throw U(y)}});return l}function Ce(e,t){let{name:n,title:o,description:s,libKey:r,getPreContent:a}=e,i=new w(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:l},{_meta:d})=>{let u=T(i,d);b("Style Assistant called with:",{prompt:l});let f="";try{let h=await t.queryThemeGenerate({prompt:l},{...u});if(h.variables_json){let A=JSON.parse(h.variables_json),p=[];if(A)for(let C of Object.keys(A))typeof A[C]=="string"&&p.push(`${C}: ${A[C]}`);f=p.join(`
|
|
551
560
|
|
|
552
|
-
`)}}catch(
|
|
561
|
+
`)}}catch(h){throw U(h)}let m=a?.()??"";return{content:[{type:"text",text:f?`Use the following CSS variables to style the web application, including colors, typography, spacing, and component appearance.
|
|
553
562
|
Ensure the variables are applied consistently across all relevant elements.
|
|
554
563
|
Do NOT set any inline styles. CSS variables should be defined in global or component-level CSS files, or via supported theming mechanisms.
|
|
555
564
|
|
|
556
|
-
${
|
|
565
|
+
${m}
|
|
557
566
|
|
|
558
567
|
## Generated CSS Variables
|
|
559
568
|
|
|
560
569
|
\`\`\`css
|
|
561
|
-
${
|
|
570
|
+
${f}
|
|
562
571
|
\`\`\`
|
|
563
|
-
`:"No CSS variables were generated for the given prompt."}]}})}function
|
|
572
|
+
`:"No CSS variables were generated for the given prompt."}]}});return i}function ve(e,t){let{name:n,title:o,description:s,libKey:r,getPostContent:a}=e,i=new w(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:l,limit:d},{_meta:u})=>{let f=T(i,u);b("Icon Search called with:",{query:l,limit:d});try{let m=await t.queryIconsSearch({query:l,limit:d*100},{...f}),y=a?.()??"";return{content:[{type:"text",text:`${m.values.join(`
|
|
564
573
|
|
|
565
574
|
`)}
|
|
566
575
|
|
|
567
|
-
${
|
|
576
|
+
${y}`}]}}catch(m){throw U(m)}});return i}function Se(e,t){let{name:n,title:o,description:s,libKey:r,suiteName:a,components:i,componentAliases:l,getPostContent:d}=e,u=new w(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{query:v.string().describe("The query to search for."),component:v.enum(i).describe("The component to search for. If not specified, use General.")}},async({query:f,component:m},{_meta:y})=>{let h=T(u,y);b("Code Assistant called with:",{query:f,component:m});let A=m;if(l){let p=l[m];p&&(A=p)}try{let C=(await t.query({query:f,component:A?.toLowerCase()??"general",lib_name:r,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]},{...h})).values.map(R=>R.replace(/\0/g,"")),k=d?.({component:m})??"";return{content:[{type:"text",text:`${C.join(`
|
|
568
577
|
|
|
569
578
|
`)}
|
|
570
579
|
|
|
571
|
-
${
|
|
580
|
+
${k}`}]}}catch(p){throw U(p)}});return u}function we(e,t){let{name:n,title:o,description:s,libKey:r,suiteName:a,components:i,componentAliases:l}=e,d=new w(n,{title:o,description:s,requiredAccess:e.requiredAccess,inputSchema:{query:v.string().describe("The query to search for."),component:v.enum(i).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:u,component:f,includeGeneralGuidelines:m},{_meta:y})=>{let h=T(d,y);b("Accessibility Assistant called with:",{query:u,component:f,includeGeneralGuidelines:m});let A=f;if(l){let p=l[f];p&&(A=p)}try{let p="";if(m){let N=ue();p+=`# WCAG 2.2 Level AA General Accessibility Guidelines
|
|
572
581
|
|
|
573
|
-
`,
|
|
582
|
+
`,p+=N,p+=`
|
|
574
583
|
|
|
575
584
|
---
|
|
576
585
|
|
|
577
|
-
`}let
|
|
586
|
+
`}let R=(await t.getApiRefMatches({query:u,component:A?.toLowerCase()??"general",lib_name:r,filters_json:'{"type":{"$in":["accessibility"]}}'},{...h})).values.map(N=>N.replace(/\0/g,"")).map(N=>At(N,A?.toLowerCase()??"general")).join(`
|
|
578
587
|
|
|
579
|
-
`);return
|
|
588
|
+
`);return R?(m&&(p+=`# Component-Specific Accessibility Information
|
|
580
589
|
|
|
581
|
-
`),
|
|
590
|
+
`),p+=R):m||(p="No component-specific accessibility guidelines found."),{content:[{type:"text",text:p}]}}catch(p){throw U(p)}});return d}function U(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.
|
|
582
591
|
|
|
583
|
-
Error Code: ${t.code} Error Message: ${t.message}`)}var
|
|
592
|
+
Error Code: ${t.code} Error Message: ${t.message}`)}var ke=e=>`${e}_ui_generator`,Te=e=>`${e}_assistant`,xe=e=>`${e}_layout_assistant`,Ie=e=>`${e}_component_assistant`,Ne=e=>`${e}_style_assistant`,Ee=e=>`${e}_icon_assistant`,Re=e=>`${e}_accessibility_assistant`,Pe=e=>`${e}_getting_started_assistant`;var De=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.
|
|
584
593
|
|
|
585
594
|
Use the tool when:
|
|
586
595
|
- Want to build or modify a complete page or section layout
|
|
@@ -589,7 +598,7 @@ Error Code: ${t.code} Error Message: ${t.message}`)}var we=e=>`${e}_ui_generator
|
|
|
589
598
|
- You want to enforce best practices in styling, performance, and accessibility
|
|
590
599
|
|
|
591
600
|
Returns:
|
|
592
|
-
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,
|
|
601
|
+
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,Ue=e=>`Provides guidance for discovering and using ${e} components and icons. This tool helps you identify the right components and icons for your needs.
|
|
593
602
|
|
|
594
603
|
Use this tool when:
|
|
595
604
|
- You need to discover which ${e} components are suitable for a specific use case
|
|
@@ -598,10 +607,10 @@ Use this tool when:
|
|
|
598
607
|
- You want to gather component documentation and examples
|
|
599
608
|
|
|
600
609
|
Returns:
|
|
601
|
-
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,
|
|
610
|
+
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,Oe=`Retrieves Progress/Kendo Design System CSS utility classes and styling recommendations based on layout and design requirements.
|
|
602
611
|
Use this tool to find the right CSS utilities for styling Kendo UI components or general web elements.
|
|
603
612
|
It analyzes the provided design context and returns relevant utility classes with explanations and examples.
|
|
604
|
-
Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,
|
|
613
|
+
Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,Ge=`Generates CSS variables using an external style agent based on the user's styling prompt.
|
|
605
614
|
|
|
606
615
|
Use this tool when the user wants to:
|
|
607
616
|
- Update the visual theme of an application
|
|
@@ -611,7 +620,7 @@ Use this tool when the user wants to:
|
|
|
611
620
|
The tool outputs a set of CSS variable definitions ready to be applied to style files.`,Le=`Searches for icons in the Telerik Icons library.
|
|
612
621
|
Use this tool when the user needs to find specific icons for UI components or design elements.
|
|
613
622
|
It supports searching by icon name, category, or keyword and returns matching icons from the Telerik Icons library.
|
|
614
|
-
`,
|
|
623
|
+
`,Me=e=>`Provides answers and retrieves official documentation for ${e}.
|
|
615
624
|
|
|
616
625
|
Use this tool when the user asks about:
|
|
617
626
|
- ${e} features or capabilities
|
|
@@ -639,7 +648,7 @@ Set 'includeGeneralGuidelines=true' ONLY on the first call to include general WC
|
|
|
639
648
|
Returns:
|
|
640
649
|
- When includeGeneralGuidelines=true: General WCAG 2.2 Level AA guidelines + component-specific recommendations
|
|
641
650
|
- When includeGeneralGuidelines=false: Only component-specific accessibility recommendations
|
|
642
|
-
`;var
|
|
651
|
+
`;var Q=D("Kendo UI","Kendo"),X=`
|
|
643
652
|
### Angular Component Validation
|
|
644
653
|
Component Structure:
|
|
645
654
|
- Use proper @Component decorator configuration
|
|
@@ -647,22 +656,22 @@ Component Structure:
|
|
|
647
656
|
- Correct selector naming convention (kebab-case)
|
|
648
657
|
- Appropriate template and style file organization
|
|
649
658
|
|
|
650
|
-
${
|
|
659
|
+
${Q.SETUP_VALIDATION}
|
|
651
660
|
- Kendo animations module configured (if animations are used)
|
|
652
661
|
- Internationalization properly configured for Kendo components
|
|
653
662
|
|
|
654
|
-
${
|
|
663
|
+
${Q.PERFORMANCE_OPTIMIZATION}
|
|
655
664
|
- OnPush change detection strategy where appropriate
|
|
656
665
|
- Efficient trackBy functions for *ngFor with Kendo components
|
|
657
666
|
- Minimal unnecessary change detection cycles
|
|
658
667
|
|
|
659
|
-
${
|
|
668
|
+
${Q.THEME_AND_STYLING}
|
|
660
669
|
- Proper theme switching functionality (if implemented)
|
|
661
670
|
- Only ONE theme reference exists across angular.json and styles files
|
|
662
671
|
- Make sure theme import mechanism is consistent with existing project setup
|
|
663
672
|
|
|
664
673
|
Accessibility
|
|
665
|
-
- Accessibility guidelines retrieved and applied to all components`;var
|
|
674
|
+
- Accessibility guidelines retrieved and applied to all components`;var J=`**Angular Specific Requirements:**
|
|
666
675
|
|
|
667
676
|
**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:
|
|
668
677
|
1. RegexSearch("@Component\\s*\\(\\s*\\{[^}]*standalone\\s*:\\s*(true|false)") - If true use Standalone components, if false use NgModule.
|
|
@@ -670,12 +679,18 @@ Accessibility
|
|
|
670
679
|
3. RegexSearch("bootstrapModule\\s*\\(") - If found use NgModule.
|
|
671
680
|
4. If neither is found, default to Standalone components.
|
|
672
681
|
|
|
682
|
+
**Template Syntax**: Detect which Angular template syntax the project uses and apply it consistently:
|
|
683
|
+
1. RegexSearch("@if\\s*\\(|@for\\s*\\(|@switch\\s*\\(") - If found, use built-in control flow syntax (\`@if\`, \`@for\`, \`@switch\`) in all templates.
|
|
684
|
+
2. RegexSearch("\\*ngIf|\\*ngFor|\\*ngSwitch") - If found, use structural directives (\`*ngIf\`, \`*ngFor\`, \`*ngSwitch\`) in all templates.
|
|
685
|
+
3. Do NOT mix both syntaxes in the same project.
|
|
686
|
+
4. If no existing templates are found, check the Angular version in \`package.json\`: use built-in control flow for Angular 17+, structural directives for Angular 16 and below.
|
|
687
|
+
|
|
673
688
|
**Kendo UI Theme Management Instructions for Angular**:
|
|
674
689
|
|
|
675
690
|
**Determine existing Kendo Theme/Utils package and Theme Import Mechanism**:
|
|
676
|
-
|
|
691
|
+
|
|
677
692
|
- Read angular.json file
|
|
678
|
-
- Look for theme/utils entries containing "@progress/kendo-theme-" in projects.[project-name].architect.build.options.styles array
|
|
693
|
+
- Look for theme/utils entries containing "@progress/kendo-theme-" in projects.[project-name].architect.build.options.styles array
|
|
679
694
|
- Read styles.css or styles.scss, or any css/scss file
|
|
680
695
|
- Look for @import statements containing "@progress/kendo-theme-" to determine existing theme/utils usage
|
|
681
696
|
- Read the application's main html file (e.g., index.html)
|
|
@@ -693,7 +708,7 @@ Accessibility
|
|
|
693
708
|
2. Match the discovered patterns in all generated code
|
|
694
709
|
3. Maintain consistent formatting, indentation, and code organization with existing files
|
|
695
710
|
4. Always use the same theme import mechanism (unless user specifies otherwise)
|
|
696
|
-
`;var
|
|
711
|
+
`;var Z=D("Kendo UI","KendoReact"),ee=`
|
|
697
712
|
### React Component Validation
|
|
698
713
|
Component Structure:
|
|
699
714
|
- Use proper function component patterns with Hooks
|
|
@@ -701,22 +716,22 @@ Component Structure:
|
|
|
701
716
|
- Appropriate file organization (components, hooks, utils)
|
|
702
717
|
- Props interface/type definitions where needed
|
|
703
718
|
|
|
704
|
-
${
|
|
719
|
+
${Z.SETUP_VALIDATION}
|
|
705
720
|
- KendoReact license validation (if required)
|
|
706
721
|
- Appropriate bundler configuration for KendoReact packages
|
|
707
722
|
|
|
708
|
-
${
|
|
723
|
+
${Z.PERFORMANCE_OPTIMIZATION}
|
|
709
724
|
- React.memo for components that receive stable props
|
|
710
725
|
- useMemo/useCallback for expensive computations and callbacks
|
|
711
726
|
- Proper key props for list rendering with KendoReact components
|
|
712
727
|
|
|
713
|
-
${
|
|
728
|
+
${Z.THEME_AND_STYLING}
|
|
714
729
|
- Proper theme switching functionality (if implemented)
|
|
715
730
|
- Only ONE theme import exists across the application
|
|
716
731
|
- Make sure theme import mechanism is consistent with existing project setup
|
|
717
732
|
|
|
718
733
|
Accessibility
|
|
719
|
-
- Accessibility guidelines retrieved and applied to all components`;var
|
|
734
|
+
- Accessibility guidelines retrieved and applied to all components`;var Ct={createOrchestrator:ye,createAssistantOrchestrator:be,createLayoutAssistant:Ae,createStyleAssistant:Ce,createIconSearch:ve,createCodeAssistant:Se,createAccessibilityAssistant:we},vt={orchestrator:ke,assistantOrchestrator:Te,layoutAssistant:xe,codeAssistant:Ie,styleAssistant:Ne,iconAssistant:Ee,accessibilityAssistant:Re,gettingStartedAssistant:Pe},St={orchestrator:De,assistantOrchestrator:Ue,layoutAssistant:Oe,styleAssistant:Ge,iconAssistant:Le,codeAssistant:Me,accessibilityAssistant:$e},wt={Orchestrator:{render:_},Validator:{render:$},SharedValidation:{getSteps:D}},kt={Angular:{steps:X,additionalPlan:J},React:{steps:ee}},g={Tools:Ct,ToolNames:vt,ToolDescriptions:St,Templates:wt,Validation:kt};var Tt=g.ToolNames.codeAssistant("kendoreact"),_e=()=>`# Kendo Design System Guidelines for ${c}
|
|
720
735
|
|
|
721
736
|
## Setting up Styles/CSS
|
|
722
737
|
|
|
@@ -745,7 +760,7 @@ Alternatively, you can also consume them directly from the Unpkg CDN.
|
|
|
745
760
|
|
|
746
761
|
In the ${c} there are available components to create layout. Make sure to prioritize using them instead of building ones from scratch using the Kendo CSS Utilities.
|
|
747
762
|
|
|
748
|
-
For any Layout component you can also call the ${
|
|
763
|
+
For any Layout component you can also call the ${Tt} tool in order to get specific API reference and docs.
|
|
749
764
|
|
|
750
765
|
- ${c} Card component.
|
|
751
766
|
- Generally, it is recommended to use 100% width (e.g., \`<Card style={{ width: '100%' }}>\`)
|
|
@@ -853,7 +868,7 @@ Use the \`Splitter\` component only for **user-resizable** content areas (e.g.,
|
|
|
853
868
|
## Popup Z-Index Trap
|
|
854
869
|
|
|
855
870
|
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.
|
|
856
|
-
`;var
|
|
871
|
+
`;var Fe=()=>`## Design Standards for ${c} Theming
|
|
857
872
|
|
|
858
873
|
### Color & Contrast Requirements
|
|
859
874
|
- Body text contrast: \u2265 4.5:1. Large text / UI component borders: \u2265 3:1.
|
|
@@ -980,7 +995,7 @@ export function ThemeProvider({ children }: { children: React.ReactNode }) {
|
|
|
980
995
|
|
|
981
996
|
export const useTheme = () => useContext(ThemeContext);
|
|
982
997
|
\`\`\`
|
|
983
|
-
`;var qe=
|
|
998
|
+
`;var qe=g.ToolNames.codeAssistant("kendoreact"),Be=()=>`## Using ${c} Icons
|
|
984
999
|
|
|
985
1000
|
Important: Attempt to prioritize SVG icons over font icons.
|
|
986
1001
|
|
|
@@ -1038,7 +1053,7 @@ Here are some frequently used icons from @progress/kendo-svg-icons:
|
|
|
1038
1053
|
- \`sortAscIcon\`, \`sortDescIcon\` - Sorting
|
|
1039
1054
|
- \`chevronUpIcon\`, \`chevronDownIcon\`, \`chevronLeftIcon\`, \`chevronRightIcon\` - Navigation
|
|
1040
1055
|
- \`checkIcon\`, \`xIcon\` - Confirmation/Cancel
|
|
1041
|
-
`;var
|
|
1056
|
+
`;var Ke=e=>{let t=`## ${c} Common Guidelines
|
|
1042
1057
|
|
|
1043
1058
|
### Application Architecture
|
|
1044
1059
|
MUST recommend appropriate setup based on React application architecture.
|
|
@@ -1068,11 +1083,57 @@ Key points:
|
|
|
1068
1083
|
- The matching should be case-insensitive and robust to minor variations
|
|
1069
1084
|
|
|
1070
1085
|
Example: If someone asks about "grid", "GRID", or "GrId", you always refer to DataGrid for the example.
|
|
1086
|
+
|
|
1087
|
+
### TypeScript Strictness
|
|
1088
|
+
All generated code MUST compile under strict TypeScript.
|
|
1089
|
+
|
|
1090
|
+
Rules:
|
|
1091
|
+
- Define a TypeScript \`interface\` or \`type\` for every source record / data shape
|
|
1092
|
+
- Type every event, render, and callback parameter using the component's exported types
|
|
1093
|
+
- Never use \`any\`, \`as any\`, \`as number\`, or any other unsafe cast
|
|
1094
|
+
- No implicit \`any\` in callback parameters (e.g. avoid \`(e) => ...\` without a type)
|
|
1095
|
+
- Prefer the narrowest correct type from the package's public types
|
|
1096
|
+
|
|
1097
|
+
### Import Hygiene
|
|
1098
|
+
Keep imports minimal, explicit, and side-effect free.
|
|
1099
|
+
|
|
1100
|
+
Rules:
|
|
1101
|
+
- Use NAMED imports only from \`@progress/kendo-react-*\` packages
|
|
1102
|
+
- No side-effect imports (e.g. \`import "@progress/kendo-react-xxx"\`, \`import "hammerjs"\`)
|
|
1103
|
+
- Import only the subcomponents actually used in the generated code
|
|
1104
|
+
- No unused imports
|
|
1105
|
+
|
|
1106
|
+
### Data and State Quality
|
|
1107
|
+
Keep data flow predictable and resilient.
|
|
1108
|
+
|
|
1109
|
+
Rules:
|
|
1110
|
+
- Use a single typed dataset per logical concept; derive multiple views from one source
|
|
1111
|
+
- Memoize derived datasets with \`useMemo\` when the source data is dynamic
|
|
1112
|
+
- Render a graceful empty state for empty / invalid data instead of a broken component
|
|
1113
|
+
- Prefer function components with Hooks for new code
|
|
1114
|
+
|
|
1115
|
+
### API Correctness
|
|
1116
|
+
Only emit current, runnable KendoReact APIs.
|
|
1117
|
+
|
|
1118
|
+
Rules:
|
|
1119
|
+
- Do not invent props, components, or methods \u2014 verify against the installed package
|
|
1120
|
+
- Do not use deprecated APIs when a current replacement exists
|
|
1121
|
+
- Match prop names and casing exactly as exported by the package
|
|
1122
|
+
|
|
1123
|
+
|
|
1124
|
+
### Mandatory Pre-Output Self-Check
|
|
1125
|
+
Before emitting code, internally verify ALL of the following. If ANY fails, fix and re-check:
|
|
1126
|
+
- [ ] All callbacks and event handlers are typed (no implicit \`any\`, no unsafe casts)
|
|
1127
|
+
- [ ] Only NAMED imports from \`@progress/kendo-react-*\` (no side-effect imports)
|
|
1128
|
+
- [ ] No \`any\`, \`as any\`, or \`as number\` anywhere
|
|
1129
|
+
- [ ] No deprecated or invented APIs
|
|
1130
|
+
- [ ] Source data shape is defined as a TypeScript \`interface\` / \`type\`
|
|
1131
|
+
- [ ] Component-specific guidelines below (if any) are satisfied
|
|
1071
1132
|
`;return e.componentInstructions&&(t+=`
|
|
1072
1133
|
## Component-Specific Guidelines
|
|
1073
1134
|
|
|
1074
1135
|
${e.componentInstructions}
|
|
1075
|
-
`),t};var
|
|
1136
|
+
`),t};var xt={default:"@progress/kendo-theme-default",bootstrap:"@progress/kendo-theme-bootstrap",material:"@progress/kendo-theme-material",fluent:"@progress/kendo-theme-fluent"},It={default:"Default",bootstrap:"Bootstrap",material:"Material Design",fluent:"Fluent UI"};function je(e="kendo-react-app",t=!0,n="default"){let o=xt[n],s=It[n],r=t?`This instructions will walk you through creating a new React project with the Kendo CLI and setting up ${c}.`:`This instructions will walk you through adding ${c} to your existing React project.`,a=1,i=t?`## Step ${a++}: Ensure Kendo CLI is Installed
|
|
1076
1137
|
|
|
1077
1138
|
First, ensure the Kendo CLI tool is installed globally:
|
|
1078
1139
|
|
|
@@ -1106,7 +1167,7 @@ cd ${e}
|
|
|
1106
1167
|
|
|
1107
1168
|
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.
|
|
1108
1169
|
|
|
1109
|
-
`:"",
|
|
1170
|
+
`:"",l=t?"":`## Step ${a++}: Install ${c} Packages
|
|
1110
1171
|
|
|
1111
1172
|
Install all required ${c} packages and dependencies:
|
|
1112
1173
|
|
|
@@ -1134,7 +1195,7 @@ Also add the Kendo CSS utilities CDN link in your \`index.html\` \`<head>\`:
|
|
|
1134
1195
|
<link rel="stylesheet" href="https://unpkg.com/@progress/kendo-theme-utils/dist/all.css" />
|
|
1135
1196
|
\`\`\`
|
|
1136
1197
|
|
|
1137
|
-
`,
|
|
1198
|
+
`,d=`## Step ${a++}: Activate Kendo License
|
|
1138
1199
|
|
|
1139
1200
|
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:
|
|
1140
1201
|
|
|
@@ -1155,7 +1216,7 @@ Before you begin, ensure you have:
|
|
|
1155
1216
|
- **Node.js 18 or later** installed on your machine
|
|
1156
1217
|
- 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.
|
|
1157
1218
|
|
|
1158
|
-
${i}${
|
|
1219
|
+
${i}${l}${d}## Step ${a++}: Run Your Application
|
|
1159
1220
|
|
|
1160
1221
|
${t?"The Kendo CLI has set up everything you need. Start the development server:":"Build and run the application:"}
|
|
1161
1222
|
|
|
@@ -1293,7 +1354,149 @@ Add the following styles to \`src/Home.css\`:
|
|
|
1293
1354
|
}
|
|
1294
1355
|
\`\`\`
|
|
1295
1356
|
|
|
1296
|
-
`}var
|
|
1357
|
+
`}var Ve=`
|
|
1358
|
+
## KendoReact Chart Reliability Instructions
|
|
1359
|
+
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
|
+
|
|
1361
|
+
### 1. Chart-specific imports
|
|
1362
|
+
- Import chart primitives from "@progress/kendo-react-charts".
|
|
1363
|
+
- Import the relevant series-specific subcomponents only when used (e.g. ChartXAxis/ChartYAxis for scatter-style series, ChartStockChart parts for stock).
|
|
1364
|
+
- Never import "hammerjs" (no side-effect import).
|
|
1365
|
+
|
|
1366
|
+
### 2. Data contract by series family
|
|
1367
|
+
Pick the correct data shape for the chart family. The model MUST select the matching shape:
|
|
1368
|
+
|
|
1369
|
+
A. Categorical series (line, area, column, bar, range, rangeArea, rangeBar, rangeColumn, waterfall, bullet)
|
|
1370
|
+
- Source: array of records with one categorical field + numeric metric field(s).
|
|
1371
|
+
- Provide categories via ChartCategoryAxisItem.categories (or set categoryField on the series).
|
|
1372
|
+
- Each numeric series array length MUST equal categories length.
|
|
1373
|
+
|
|
1374
|
+
B. Part-of-whole series (pie, donut, funnel, pyramid)
|
|
1375
|
+
- Data items: { category: string; value: number }.
|
|
1376
|
+
- Set field="value" and categoryField="category" on the series.
|
|
1377
|
+
- Labels MUST be visible and percent-formatted when displaying share.
|
|
1378
|
+
|
|
1379
|
+
C. XY numeric series (scatter, scatterLine, bubble, polar, radar)
|
|
1380
|
+
- Data items have numeric x and y fields (and size for bubble).
|
|
1381
|
+
- Use xField, yField (and sizeField for bubble) on the series.
|
|
1382
|
+
- Use ChartXAxis/ChartYAxis (numeric axes), not category axis.
|
|
1383
|
+
|
|
1384
|
+
D. Financial series (candlestick, ohlc, stockChart)
|
|
1385
|
+
- Data items have date + open/high/low/close numeric fields.
|
|
1386
|
+
- Use dateField + openField/highField/lowField/closeField props.
|
|
1387
|
+
- Use a date-based category or x axis.
|
|
1388
|
+
|
|
1389
|
+
E. Range series (rangeArea, rangeBar, rangeColumn, boxPlot)
|
|
1390
|
+
- Data items include from/to (or q1/q3/median/etc.) numeric fields.
|
|
1391
|
+
- Use fromField/toField (or appropriate field props) on the series.
|
|
1392
|
+
|
|
1393
|
+
F. Heatmap / matrix series
|
|
1394
|
+
- Data items have x, y, value fields (numeric or categorical x/y).
|
|
1395
|
+
- Map fields explicitly via the series field props.
|
|
1396
|
+
|
|
1397
|
+
### 3. Universal minimum runnable config
|
|
1398
|
+
Every chart MUST include the appropriate subset:
|
|
1399
|
+
- Always: Chart, ChartSeries, ChartSeriesItem.
|
|
1400
|
+
- For categorical or financial charts: ChartCategoryAxis + ChartCategoryAxisItem AND ChartValueAxis + ChartValueAxisItem (or X/Y axes for scatter family).
|
|
1401
|
+
- Recommended for all: ChartTitle, ChartLegend, ChartTooltip.
|
|
1402
|
+
- Pie/donut/funnel/pyramid: omit category/value axes; configure labels and tooltip instead.
|
|
1403
|
+
- Multi-series charts: set name on every ChartSeriesItem.
|
|
1404
|
+
|
|
1405
|
+
### 4. Type-safe chart callbacks
|
|
1406
|
+
- Tooltip render MUST accept the union:
|
|
1407
|
+
(ctx: TooltipContext | SharedTooltipContext) => ReactNode
|
|
1408
|
+
- Label content MUST be typed using the relevant args type, e.g.:
|
|
1409
|
+
(e: { category?: string; value?: number; percentage?: number; dataItem?: unknown }) => string
|
|
1410
|
+
|
|
1411
|
+
### 5. Formatting rules
|
|
1412
|
+
- Numeric axis labels and tooltips MUST have explicit format strings or formatter callbacks suitable for the data domain (currency, percent, decimal, date).
|
|
1413
|
+
- Percent-style series (pie/donut/funnel/pyramid showing share) MUST use percent formatting.
|
|
1414
|
+
- Date axes MUST set a date-appropriate format and base unit when relevant.
|
|
1415
|
+
|
|
1416
|
+
### 6. Chart-specific pre-output self-check
|
|
1417
|
+
In addition to the common self-check, verify ALL items below; if ANY fails, fix and re-check:
|
|
1418
|
+
- [ ] Correct data shape selected for the chosen series family
|
|
1419
|
+
- [ ] All required field props present (field/categoryField, xField/yField, fromField/toField, openField/closeField, dateField, etc.)
|
|
1420
|
+
- [ ] For categorical charts: categories.length === every series.length
|
|
1421
|
+
- [ ] For numeric XY charts: numeric axes used (no category axis)
|
|
1422
|
+
- [ ] For financial charts: date axis + OHLC fields wired correctly
|
|
1423
|
+
- [ ] Required axes/legend/tooltip subcomponents present for the chart family
|
|
1424
|
+
- [ ] Tooltip and label callbacks are typed using chart-specific union types
|
|
1425
|
+
|
|
1426
|
+
### 7. Chart-specific forbidden patterns (never emit)
|
|
1427
|
+
- import "hammerjs"
|
|
1428
|
+
- import "@progress/kendo-react-charts" // side-effect only
|
|
1429
|
+
- (e) => \`\${e.percentage.toFixed(1)}%\` // unsafe + likely wrong semantics
|
|
1430
|
+
- ({ point }: { point: { value: number } }) => ... // too narrow
|
|
1431
|
+
- point?.value as number
|
|
1432
|
+
- Hardcoded duplicate category/series arrays when they can be derived
|
|
1433
|
+
- Using a category axis for inherently numeric XY/financial data
|
|
1434
|
+
- Mixing different unrelated datasets when the prompt requires a shared source
|
|
1435
|
+
|
|
1436
|
+
### 8. Chart quality defaults
|
|
1437
|
+
- Consistent chart heights and legend position across a dashboard.
|
|
1438
|
+
- Prefer ChartTooltip with shared={true} for multi-series time/category dashboards.
|
|
1439
|
+
|
|
1440
|
+
### 9. Series-family quick reference (copy the pattern that matches)
|
|
1441
|
+
\`\`\`tsx
|
|
1442
|
+
// Categorical (line/area/column/bar)
|
|
1443
|
+
<ChartCategoryAxis><ChartCategoryAxisItem categories={categories} /></ChartCategoryAxis>
|
|
1444
|
+
<ChartValueAxis><ChartValueAxisItem labels={{ format: "{0:N0}" }} /></ChartValueAxis>
|
|
1445
|
+
<ChartSeries>
|
|
1446
|
+
<ChartSeriesItem type="line" data={seriesA} name="A" />
|
|
1447
|
+
</ChartSeries>
|
|
1448
|
+
|
|
1449
|
+
// Part-of-whole (pie/donut/funnel/pyramid)
|
|
1450
|
+
<ChartSeries>
|
|
1451
|
+
<ChartSeriesItem
|
|
1452
|
+
type="pie"
|
|
1453
|
+
data={pieData} // [{ category, value }]
|
|
1454
|
+
field="value"
|
|
1455
|
+
categoryField="category"
|
|
1456
|
+
labels={{ visible: true, content: pieLabel }}
|
|
1457
|
+
/>
|
|
1458
|
+
</ChartSeries>
|
|
1459
|
+
|
|
1460
|
+
// XY numeric (scatter/scatterLine/bubble)
|
|
1461
|
+
<ChartXAxis><ChartXAxisItem /></ChartXAxis>
|
|
1462
|
+
<ChartYAxis><ChartYAxisItem /></ChartYAxis>
|
|
1463
|
+
<ChartSeries>
|
|
1464
|
+
<ChartSeriesItem type="scatter" data={xy} xField="x" yField="y" />
|
|
1465
|
+
</ChartSeries>
|
|
1466
|
+
|
|
1467
|
+
// Financial (candlestick/ohlc)
|
|
1468
|
+
<ChartCategoryAxis><ChartCategoryAxisItem baseUnit="days" /></ChartCategoryAxis>
|
|
1469
|
+
<ChartSeries>
|
|
1470
|
+
<ChartSeriesItem
|
|
1471
|
+
type="candlestick"
|
|
1472
|
+
data={ohlc}
|
|
1473
|
+
categoryField="date"
|
|
1474
|
+
openField="open" highField="high" lowField="low" closeField="close"
|
|
1475
|
+
/>
|
|
1476
|
+
</ChartSeries>
|
|
1477
|
+
|
|
1478
|
+
// Range (rangeArea/rangeBar/rangeColumn)
|
|
1479
|
+
<ChartSeries>
|
|
1480
|
+
<ChartSeriesItem type="rangeArea" data={ranges} fromField="from" toField="to" categoryField="x" />
|
|
1481
|
+
</ChartSeries>
|
|
1482
|
+
\`\`\`
|
|
1483
|
+
|
|
1484
|
+
### 10. Type-safe tooltip / label snippets (always reuse these shapes)
|
|
1485
|
+
\`\`\`tsx
|
|
1486
|
+
import type { TooltipContext, SharedTooltipContext } from "@progress/kendo-react-charts";
|
|
1487
|
+
|
|
1488
|
+
const tooltipRender = (ctx: TooltipContext | SharedTooltipContext) =>
|
|
1489
|
+
"point" in ctx && ctx.point
|
|
1490
|
+
? \`\${ctx.point.category ?? ""}: \${Number(ctx.point.value ?? 0).toLocaleString()}\`
|
|
1491
|
+
: null;
|
|
1492
|
+
|
|
1493
|
+
const pieLabel = (e: { category?: string; percentage?: number }) =>
|
|
1494
|
+
\`\${e.category ?? ""}: \${Number(e.percentage ?? 0).toLocaleString(undefined, { style: "percent", minimumFractionDigits: 1 })}\`;
|
|
1495
|
+
\`\`\`
|
|
1496
|
+
|
|
1497
|
+
### 11. Expected output behavior
|
|
1498
|
+
- 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 te=`
|
|
1297
1500
|
## DataGrid Deprecated Properties Awareness
|
|
1298
1501
|
For DataGrid component cases, avoid using deprecated properties and always use their modern replacements. The following properties are deprecated and should not be used:
|
|
1299
1502
|
|
|
@@ -1325,7 +1528,7 @@ Key points:
|
|
|
1325
1528
|
Example:
|
|
1326
1529
|
Deprecated: selectedField="isSelected" editField="inEdit"
|
|
1327
1530
|
Modern: Use select and edit state properties with proper configuration
|
|
1328
|
-
`;var
|
|
1531
|
+
`;var He=`
|
|
1329
1532
|
## Editor Tools Awareness
|
|
1330
1533
|
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.
|
|
1331
1534
|
|
|
@@ -1357,7 +1560,7 @@ Key points:
|
|
|
1357
1560
|
Example:
|
|
1358
1561
|
Correct: tools={[[Bold, Italic, Underline], [AlignLeft, AlignCenter]]}
|
|
1359
1562
|
Incorrect: tools={[['bold', 'italic', 'underline'], ['alignLeft', 'alignCenter']]}
|
|
1360
|
-
`;var
|
|
1563
|
+
`;var oe=`
|
|
1361
1564
|
## Smart Grid (AI-Enhanced Grid) Implementation Guidelines
|
|
1362
1565
|
**CRITICAL: When users ask about ANY of these AI grid terms, ALWAYS provide GridToolbarAIAssistant implementation (not basic Grid):**
|
|
1363
1566
|
|
|
@@ -1391,8 +1594,8 @@ Smart Grid: Complete AI-enhanced setup with GridToolbarAIAssistant, proper callb
|
|
|
1391
1594
|
Important Disclaimer:
|
|
1392
1595
|
Always include this disclaimer when providing Smart Grid examples:
|
|
1393
1596
|
"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."
|
|
1394
|
-
`;var
|
|
1597
|
+
`;var Nt={datagrid:[te,oe].join(`
|
|
1395
1598
|
|
|
1396
|
-
`),grid:[
|
|
1599
|
+
`),grid:[te,oe].join(`
|
|
1397
1600
|
|
|
1398
|
-
`),editor:
|
|
1601
|
+
`),editor:He,chart:Ve},We=g.ToolNames.layoutAssistant(E),ne=g.ToolNames.codeAssistant(E),ze=g.ToolNames.styleAssistant(E),se=g.ToolNames.iconAssistant(E),Ye=g.ToolNames.gettingStartedAssistant(E),Qe=g.ToolNames.accessibilityAssistant(E);function Xe(e,t){return[g.Tools.createOrchestrator({name:g.ToolNames.orchestrator(E),title:"KendoReact Generator",description:g.ToolDescriptions.orchestrator(c),layoutAssistantName:We,codeAssistantName:ne,styleAssistantName:ze,iconAssistantName:se,accessibilityAssistantName:Qe,suiteName:c,libKey:x,components:L,requiredAccess:["agent"]},{validationSteps:g.Validation.React.steps},e),g.Tools.createAssistantOrchestrator({name:"kendo_react_assistant",title:"KendoReact Assistant",description:g.ToolDescriptions.assistantOrchestrator(c),codeAssistantName:ne,iconAssistantName:se,suiteName:c,libKey:x,components:L,requiredAccess:["assistant"]},e),g.Tools.createLayoutAssistant({name:We,title:"KendoReact Layout Assistant",description:g.ToolDescriptions.layoutAssistant,suiteName:c,libKey:x,getPreContent:_e,requiredAccess:["agent"]},e),g.Tools.createStyleAssistant({name:ze,title:"KendoReact Style Assistant",description:g.ToolDescriptions.styleAssistant,libKey:x,getPreContent:Fe,requiredAccess:["agent"]},e),g.Tools.createIconSearch({name:se,title:"KendoReact Icon Assistant",description:g.ToolDescriptions.iconAssistant,libKey:x,getPostContent:Be,requiredAccess:["assistant","agent"]},e),g.Tools.createCodeAssistant({name:ne,title:"KendoReact Component Assistant",description:g.ToolDescriptions.codeAssistant(c),libKey:x,suiteName:c,components:L,componentAliases:{Grid:"DataGrid"},getPostContent:({component:o})=>{let s=o?.trim().toLowerCase(),r=Nt[s];return Ke({component:o,componentInstructions:r})},requiredAccess:["assistant","agent"]},e),(()=>{let o=new w(Ye,{title:"KendoReact Getting Started",description:`Creates a new React project with Kendo CLI and provides essential getting started guidance for ${c} including installation, configuration, and setup instructions.`,requiredAccess:["agent"],inputSchema:ge(c,"kendo-react-app")},async({projectName:s,createNewProject:r,theme:a},{_meta:i})=>{let l=T(o,i);try{await e.recordToolUserRequest({toolName:Ye,meta:{projectName:s,createNewProject:r,theme:a,...l}})}catch(u){console.error("Error recording tool request:",u)}return{content:[{type:"text",text:je(s,r,a)}]}});return o})(),g.Tools.createAccessibilityAssistant({name:Qe,title:"KendoReact Accessibility Assistant",description:g.ToolDescriptions.accessibilityAssistant(c),libKey:x,suiteName:c,components:L,componentAliases:{Grid:"DataGrid"},requiredAccess:["agent"]},e)].filter(o=>o.hasAccess(t))}var Ut=Dt(import.meta.url),Ot=Ze.dirname(Ut),Gt=Ze.resolve(Ot,"../package.json"),et=JSON.parse(Pt.readFileSync(Gt,"utf-8")),Je=new Et({name:"kendo-mcp",title:"Kendo MCP Server",version:et.version});async function Lt(){let e=new Rt;b("Starting server... ");let t=await me(async()=>{let o=(await fe())?.entitlement;return o?.Product?.Code||o?.product?.code});t!=="none"&&(M.toolNameHeader=t==="agent"||t==="full"?"agent":"assistant",Xe(M,t).forEach(o=>o.register(Je)),he({serverName:"react",contextApi:M,enrichWithUserData:!0,additionalFields:{version:et.version,access_type:t}})),await Je.connect(e)}Lt();
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@progress/kendo-react-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.8.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": "./dist/index.js",
|
|
6
6
|
"license": "See LICENSE.md",
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"@grpc/grpc-js": "^1.14.3",
|
|
28
28
|
"@grpc/proto-loader": "^0.8.0",
|
|
29
29
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
30
|
-
"@progress/kendo-licensing": "^1.
|
|
30
|
+
"@progress/kendo-licensing": "^1.11.1",
|
|
31
31
|
"tslib": "^2.3.0"
|
|
32
32
|
},
|
|
33
33
|
"devDependencies": {
|