@progress/kendo-angular-mcp 1.4.4 → 1.5.0-dev.fb926bc2.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 +308 -61
- package/package.json +1 -1
- package/proto/service.proto +5 -0
package/dist/index.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{McpServer as
|
|
3
|
-
`,
|
|
2
|
+
import{McpServer as kt}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as St}from"@modelcontextprotocol/sdk/server/stdio.js";import{dirname as ct,join as dt}from"path";import{fileURLToPath as pt}from"url";import{loadLicense as Ze,decodeLicenseKey as Xe,decodeLicenseEvidence as et}from"@progress/kendo-licensing/utils";var q=class extends Error{constructor(t){super(t),this.name="LicenseError"}};function te(e){return e.replace(/^\uFEFF/,"")}async function oe(e){let t=null,s=null;try{let o=Ze();if(!o.success){let n=new q(o.message);throw e&&await e("license_load_failed",{error:o.message}).catch(()=>{}),n}try{t=(await Xe(o.value)).licenses.find(async r=>!!(await et(r)).userId)}catch(n){console.log(n.message),e&&await e("license_load_failed",{error:n.message||"Unknown decoding error"}).catch(()=>{})}if(!t)return[te(o.value),null]}catch(o){return s=o.message||"Unknown error loading license.",e&&await e("license_load_failed",{error:s}).catch(()=>{}),[null,s]}return[te(t),null]}import P from"node:fs";import G from"node:path";var B=!1,E=process.env.DEBUG_LOG_FILE,ne=!!(E&&typeof E=="string");if(ne){let e=G.resolve(E),t=G.dirname(e);if(t!=="."&&t!==process.cwd()&&!P.existsSync(t))try{P.mkdirSync(t,{recursive:!0})}catch(s){console.error("Error creating log directory:",s)}if(!P.existsSync(e))try{P.writeFileSync(e,"")}catch(s){console.error("Error creating log file:",s)}}else B=!1;B=ne&&!!E&&P.existsSync(G.resolve(E));function h(...e){if(B&&E){let o=`${new Date().toISOString()}: ${e.join(" ")}
|
|
3
|
+
`,n=G.resolve(E);P.appendFile(n,o,r=>{r&&console.error("Error writing to log file:",r)})}}import tt from"@grpc/proto-loader";import O from"@grpc/grpc-js";import ae from"path";import se from"fs";import{fileURLToPath as ot}from"url";var nt=ot(import.meta.url),st=ae.dirname(nt),ie={version:"unknown"},re=ae.resolve(st,"../package.json");se.existsSync(re)&&(ie=JSON.parse(se.readFileSync(re,"utf-8")));function rt(e){return e.replace(/\u2014/g,"--").replace(/\u2013/g,"-").replace(/[^\x20-\x7E]/g,"")}var M=class{constructor(t,s,o){this.contextApiUrl=t;this.protoPath=s;this.options=o;this.toolNameHeader="assistant";let n=tt.loadSync(this.protoPath,{keepCase:!0,longs:String,enums:String,defaults:!0,oneofs:!0});this.isDev=this.contextApiUrl?.includes("localhost")||this.contextApiUrl?.includes("127.0.0.1"),h("Using ContextApi URl:",this.contextApiUrl);let r=O.loadPackageDefinition(n);this.client=new r.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?O.credentials.createInsecure():O.credentials.createSsl())}async getMetadata({meta:t}={meta:{}}){let[s,o]=this.isDev?["fake_license",null]:await oe((m,A)=>this.logEvent(m,A)),n=process.env.CONTEXTAPI_API_KEY,r=n&&typeof n=="string",a=s&&typeof s=="string";if(!a&&!r&&o)throw new Error(`Failed to authenticate with API key or License key!
|
|
4
4
|
|
|
5
|
-
License Error: ${n}`);let i=new _.Metadata;if(r)try{i.add("x-license-key",o)}catch(h){throw b("Error adding license key to metadata:",h),new Error(`Failed to use license key: ${h.message}`)}a&&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 f=JSON.stringify({...t,source:"npm",version:ae.version,os:process.platform,node_version:process.version});return i.add("x-request-metadata",Xe(f)),i}async query(t,o){let n=await this.getMetadata({meta:o});return new Promise((s,a)=>{this.client.query(t,n,(r,i)=>{r?a(new Error(r)):s(i)})})}async getApiRefMatches(t,o){let n=await this.getMetadata({meta:o});return new Promise((s,a)=>{this.client.getApiRefMatches(t,n,(r,i)=>{r?a(new Error(r)):s(i)})})}async queryCssUtils(t,o){let n=await this.getMetadata({meta:o});return new Promise((s,a)=>{this.client.cssUtilsSearch(t,n,(r,i)=>{r?(b("Error querying CSS Utils:",r),a(new Error(r))):s(i)})})}async queryIconsSearch(t,o){let n=await this.getMetadata({meta:o});return new Promise((s,a)=>{this.client.iconsSearch(t,n,(r,i)=>{r?(b("Error querying Icons Search:",r),a(new Error(r))):s(i)})})}async queryBuildingBlocks(t,o){let n=await this.getMetadata({meta:o});return new Promise((s,a)=>{this.client.buildingBlocksSearch(t,n,(r,i)=>{r?(b("Error querying Building Blocks:",r),a(new Error(r))):s(i)})})}async validateUserLicense(){let t=await this.getMetadata();return new Promise((o,n)=>{this.client.validateUserLicense(null,t,(s,a)=>{s?(b("Error validating user license:",s),n(new Error(s))):o(a)})})}async queryThemeGenerate(t,o){let n=await this.getMetadata({meta:o});return new Promise((s,a)=>{this.client.generateTheme(t,n,(r,i)=>{r?(b("Error querying context API/GenerateTheme:",r),a(new Error(r))):s(i)})})}async recordOrchestratorUserRequest({meta:t}){let o=await this.getMetadata({meta:t});return new Promise((n,s)=>{this.client.recordOrchestratorUserRequest(null,o,(a,r)=>{a?(b("Error recording orchestrator user request:",a),s(new Error(a))):n(r)})})}};import{z as F}from"zod";var _t=F.object({user_id:F.string(),user_email:F.string().email()});import{z as S}from"zod";var Ze=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())}),qt=S.array(Ze);async function ie(e){let t=process.env.KENDO_MCP_ACCESS;if(t==="true"||t==="1"||t==="full")return"full";if(typeof t=="string"&&(t.toLowerCase()==="agent"||t.toLowerCase()==="assistant"))return t.toLowerCase();let o=await e();return o.toLocaleLowerCase()==="agentic_ui_generator"?"agent":o.toLocaleLowerCase()==="ai_coding_assistants"?"assistant":"none"}function le(){return'**Accessibility Guidelines: WCAG 2.2 Level AA Compliance**\n\n**Core Principles:**\n1. Use semantic HTML and ARIA correctly\n2. Ensure WCAG 2.2 AA compliance\n3. Follow W3C ARIA Authoring Practices\n4. Provide standards-based accessibility fixes\n\n**1. Form Control Labels** (WCAG 1.3.1, 3.3.2, 4.1.2)\nEvery input must have an associated label.\nCORRECT: `<input type="search" aria-label="Search products" placeholder="Search...">`\nWRONG: `<span>Email</span><input type="email">` (no association)\nWRONG: `<input type="email" placeholder="Email">` (placeholder as label)\n\n**2. Button Accessibility** (WCAG 4.1.2, 2.4.6, 2.5.3)\nAll buttons need accessible names describing their purpose.\nCORRECT: `<button type="button">Save Changes</button>`\nCORRECT: `<button aria-label="Close dialog"><svg aria-hidden="true" focusable="false">...</svg></button>`\nWRONG: `<button><svg>...</svg></button>` (no accessible name)\nWRONG: `<button>Click here</button>` (generic text)\n\n**3. Popup/Menu Triggers** (WCAG 4.1.2, 1.3.1)\nIndicate popup purpose and state using aria-haspopup, aria-expanded, aria-controls.\nCORRECT: `<button aria-expanded="false" aria-haspopup="menu" aria-controls="menu-id">Settings</button>`\n\n**4. Image Accessibility** (WCAG 1.1.1)\nInformative: `<img src="chart.png" alt="Sales increased 25% in Q4 2024">`\nFunctional: `<a href="/home"><img src="logo.png" alt="Company Name Home"></a>`\nDecorative: `<img src="border.png" alt="" role="presentation">`\nComplex: `<img src="chart.png" alt="Sales data" aria-describedby="desc-id">`\nWRONG: Missing alt, filename as alt, generic alt for decorative images\n\n**5. Link Accessibility** (WCAG 2.4.4, 2.4.6)\nLinks must be descriptive and understandable out of context.\nCORRECT: `<a href="/products">View All Products</a>`\nCORRECT: `<a href="/article" aria-label="Read more about New Product Launch">Read more</a>`\nWRONG: "Click here", "Read more", "Learn more" without context\n\n**6. Form Validation** (WCAG 3.3.1, 3.3.2, 3.3.3)\nErrors must be identified, associated with inputs, and provide suggestions. Use aria-describedby, aria-invalid="true", and role="alert".\n\n**7. Heading Structure** (WCAG 1.3.1, 2.4.6)\nEach page should 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\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>`, or `<footer>` in page/route components (the layout may already provide them), use `<section>` or `<div>` as page-level wrappers, semantic HTML\n- **Dynamic Content:** role="status"/aria-live="polite" for updates, role="alert"/aria-live="assertive" for critical alerts\n- **Keyboard/Focus:** All interactive elements keyboard accessible, logical focus order, visible focus indicators, no keyboard traps (except modals)\n- **Color/Contrast:** 4.5:1 text contrast (3:1 large text), 3:1 UI component contrast, no color-only information, 3:1 focus indicator contrast'}var g="Kendo UI for Angular",N="angular",E="kendo",O=["AIPrompt","ActionSheet","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","BreadCrumb","Button","ButtonGroup","Calendar","Card","ChartWizard","Charts","CheckBox","Chip","ChipList","ChunkProgressBar","CircularGauge","CircularProgressBar","ColorGradient","ColorPalette","ColorPicker","ComboBox","ContextMenu","ConversationalUI","DataQuery","DateInput","DateMath","DatePicker","DateRange","DateTimePicker","Diagram","Dialog","DragandDrop","Drawer","Drawing","DropDownButton","DropDownList","DropDownTree","Editor","ExcelExport","ExpansionPanel","FileSaver","FileSelect","Filter","FlatColorPicker","FloatingActionButton","FloatingLabel","Forms","FormField","Gantt","Gauges","General","Grid","GridLayout","Icon","InlineAIPrompt","Label","LinearGauge","ListBox","ListView","Loader","Map","MaskedTextBox","Menu","MultiColumnComboBox","MultiSelect","MultiSelectTree","MultiViewCalendar","Notification","NumericTextBox","OTPInput","Pager","PanelBar","PDFExport","PDFViewer","PivotGrid","Popover","Popup","ProgressBar","PromptBox","QRCode","RadialGauge","RadioButton","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","SmartPasteButton","Sortable","StockChart","Sparkline","SpeechToTextButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","SVGIcon","Switch","TabStrip","TextArea","TextBox","TileLayout","Timeline","TimePicker","ToolBar","Tooltip","TreeList","TreeView","Typography","Upload","Window"],ce=new Map([["actionsheet","@progress/kendo-angular-navigation"],["aiprompt","@progress/kendo-angular-conversational-ui"],["appbar","@progress/kendo-angular-navigation"],["arcgauge","@progress/kendo-angular-gauges"],["autocomplete","@progress/kendo-angular-dropdowns"],["avatar","@progress/kendo-angular-layout"],["badge","@progress/kendo-angular-indicators"],["barcode","@progress/kendo-angular-barcodes"],["bottomnavigation","@progress/kendo-angular-navigation"],["breadcrumb","@progress/kendo-angular-navigation"],["button","@progress/kendo-angular-buttons"],["buttongroup","@progress/kendo-angular-buttons"],["calendar","@progress/kendo-angular-dateinputs"],["card","@progress/kendo-angular-layout"],["chartwizard","@progress/kendo-angular-chart-wizard"],["checkbox","@progress/kendo-angular-inputs"],["chip","@progress/kendo-angular-buttons"],["chiplist","@progress/kendo-angular-buttons"],["chunkprogressbar","@progress/kendo-angular-progressbar"],["circulargauge","@progress/kendo-angular-gauges"],["circularprogressbar","@progress/kendo-angular-progressbar"],["colorgradient","@progress/kendo-angular-inputs"],["colorpalette","@progress/kendo-angular-inputs"],["colorpicker","@progress/kendo-angular-inputs"],["combobox","@progress/kendo-angular-dropdowns"],["contextmenu","@progress/kendo-angular-menu"],["dataquery","@progress/kendo-data-query"],["dateinput","@progress/kendo-angular-dateinputs"],["datemath","@progress/kendo-date-math"],["datepicker","@progress/kendo-angular-dateinputs"],["daterangepicker","@progress/kendo-angular-dateinputs"],["datetimepicker","@progress/kendo-angular-dateinputs"],["diagram","@progress/kendo-angular-diagrams"],["dialog","@progress/kendo-angular-dialog"],["drawer","@progress/kendo-angular-layout"],["drawing","@progress/kendo-drawing"],["dropdownbutton","@progress/kendo-angular-buttons"],["dropdownlist","@progress/kendo-angular-dropdowns"],["dropdowntree","@progress/kendo-angular-dropdowns"],["editor","@progress/kendo-angular-editor"],["excelexport","@progress/kendo-angular-excel-export"],["expansionpanel","@progress/kendo-angular-layout"],["filesaver","@progress/kendo-file-saver"],["fileselect","@progress/kendo-angular-upload"],["filter","@progress/kendo-angular-filter"],["flatcolorpicker","@progress/kendo-angular-inputs"],["floatingactionbutton","@progress/kendo-angular-buttons"],["floatinglabel","@progress/kendo-angular-label"],["formfield","@progress/kendo-angular-inputs"],["forms","@progress/kendo-angular-inputs"],["gantt","@progress/kendo-angular-gantt"],["grid","@progress/kendo-angular-grid"],["gridlayout","@progress/kendo-angular-layout"],["icon","@progress/kendo-angular-icons"],["inlineaiprompt","@progress/kendo-angular-conversational-ui"],["label","@progress/kendo-angular-label"],["lineargauge","@progress/kendo-angular-gauges"],["listbox","@progress/kendo-angular-listbox"],["listview","@progress/kendo-angular-listview"],["loader","@progress/kendo-angular-indicators"],["map","@progress/kendo-angular-map"],["maskedtextbox","@progress/kendo-angular-inputs"],["menu","@progress/kendo-angular-menu"],["multicolumncombobox","@progress/kendo-angular-dropdowns"],["multiselect","@progress/kendo-angular-dropdowns"],["multiselecttree","@progress/kendo-angular-dropdowns"],["multiviewcalendar","@progress/kendo-angular-dateinputs"],["notification","@progress/kendo-angular-notification"],["numerictextbox","@progress/kendo-angular-inputs"],["otpinput","@progress/kendo-angular-inputs"],["pager","@progress/kendo-angular-pager"],["panelbar","@progress/kendo-angular-layout"],["pdfexport","@progress/kendo-angular-pdf-export"],["pdfviewer","@progress/kendo-angular-pdfviewer"],["pivotgrid","@progress/kendo-angular-pivotgrid"],["popover","@progress/kendo-angular-tooltip"],["popup","@progress/kendo-angular-popup"],["progressbar","@progress/kendo-angular-progressbar"],["promptbox","@progress/kendo-angular-conversational-ui"],["qrcode","@progress/kendo-angular-barcodes"],["radialgauge","@progress/kendo-angular-gauges"],["radiobutton","@progress/kendo-angular-inputs"],["rangeslider","@progress/kendo-angular-inputs"],["rating","@progress/kendo-angular-inputs"],["ripple","@progress/kendo-angular-ripple"],["sankey","@progress/kendo-angular-charts"],["scheduler","@progress/kendo-angular-scheduler"],["scrollview","@progress/kendo-angular-scrollview"],["signature","@progress/kendo-angular-inputs"],["skeleton","@progress/kendo-angular-indicators"],["slider","@progress/kendo-angular-inputs"],["smartpastebutton","@progress/kendo-angular-buttons"],["sortable","@progress/kendo-angular-sortable"],["sparkline","@progress/kendo-angular-charts"],["speechtotextbutton","@progress/kendo-angular-buttons"],["splitbutton","@progress/kendo-angular-buttons"],["splitter","@progress/kendo-angular-layout"],["spreadsheet","@progress/kendo-angular-spreadsheet"],["stacklayout","@progress/kendo-angular-layout"],["stepper","@progress/kendo-angular-layout"],["stockchart","@progress/kendo-angular-charts"],["svgicon","@progress/kendo-angular-icons"],["switch","@progress/kendo-angular-inputs"],["tabstrip","@progress/kendo-angular-layout"],["textarea","@progress/kendo-angular-inputs"],["textbox","@progress/kendo-angular-inputs"],["tilelayout","@progress/kendo-angular-layout"],["timeline","@progress/kendo-angular-layout"],["timepicker","@progress/kendo-angular-dateinputs"],["toolbar","@progress/kendo-angular-toolbar"],["treelist","@progress/kendo-angular-treelist"],["treeview","@progress/kendo-angular-treeview"],["typography","@progress/kendo-angular-typography"],["upload","@progress/kendo-angular-upload"],["window","@progress/kendo-angular-dialog"],["charts","@progress/kendo-angular-charts"],["conversationalui","@progress/kendo-angular-conversational-ui"],["tooltip","@progress/kendo-angular-tooltip"]]);var nt=tt(et(ot(import.meta.url)),"../proto/service.proto"),G=new M("contextapi.telerik.com:443",nt,{libName:N});var pe=async()=>G.validateUserLicense();import mt from"fs";import Fe from"path";import{fileURLToPath as gt}from"url";import{z as y}from"zod";var v=class{constructor(t,o,n){this.name=t;this.config=o;this.cb=n}register(t){this.server=t,this.server.registerTool(this.name,this.config,this.cb)}hasAccess(t){return!this.config.requiredAccess||this.config.requiredAccess.length===0?!0:t==="full"||this.config.requiredAccess.includes(t)}};var L=(e,t)=>`# ${e.suiteName} - Code Validation & Quality Assurance
|
|
5
|
+
License Error: ${o}`);let i=new O.Metadata;if(a)try{i.add("x-license-key",s)}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",n),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:ie.version,os:process.platform,node_version:process.version});return i.add("x-request-metadata",rt(d)),i}async query(t,s){let o=await this.getMetadata({meta:s});return new Promise((n,r)=>{this.client.query(t,o,(a,i)=>{a?r(new Error(a)):n(i)})})}async getApiRefMatches(t,s){let o=await this.getMetadata({meta:s});return new Promise((n,r)=>{this.client.getApiRefMatches(t,o,(a,i)=>{a?r(new Error(a)):n(i)})})}async queryCssUtils(t,s){let o=await this.getMetadata({meta:s});return new Promise((n,r)=>{this.client.cssUtilsSearch(t,o,(a,i)=>{a?(h("Error querying CSS Utils:",a),r(new Error(a))):n(i)})})}async queryIconsSearch(t,s){let o=await this.getMetadata({meta:s});return new Promise((n,r)=>{this.client.iconsSearch(t,o,(a,i)=>{a?(h("Error querying Icons Search:",a),r(new Error(a))):n(i)})})}async queryBuildingBlocks(t,s){let o=await this.getMetadata({meta:s});return new Promise((n,r)=>{this.client.buildingBlocksSearch(t,o,(a,i)=>{a?(h("Error querying Building Blocks:",a),r(new Error(a))):n(i)})})}async validateUserLicense(){let t=await this.getMetadata();return new Promise((s,o)=>{this.client.validateUserLicense(null,t,(n,r)=>{n?(h("Error validating user license:",n),o(new Error(n))):s(r)})})}async queryThemeGenerate(t,s){let o=await this.getMetadata({meta:s});return new Promise((n,r)=>{this.client.generateTheme(t,o,(a,i)=>{a?(h("Error querying context API/GenerateTheme:",a),r(new Error(a))):n(i)})})}async recordOrchestratorUserRequest({meta:t}){let s=await this.getMetadata({meta:t});return new Promise((o,n)=>{this.client.recordOrchestratorUserRequest(null,s,(r,a)=>{r?(h("Error recording orchestrator user request:",r),n(new Error(r))):o(a)})})}async logEvent(t,s){let o="h8utJ6rk4PpIWX4JMn9beQDsjVUri6KV0XYfiVwq";if(!o||typeof o!="string"){h("LOGGING_API_KEY not configured, skipping log event");return}let n=new O.Metadata;return n.add("x-api-key",o),new Promise((r,a)=>{this.client.logEvent({event_name:t,fields:s||{}},n,(i,d)=>{i?(h("Error logging event:",i),a(new Error(i))):r()})})}};import{z as F}from"zod";var Vt=F.object({user_id:F.string(),user_email:F.string().email()});import{z as k}from"zod";var at=k.object({Product:k.object({Id:k.number().int(),Code:k.string(),Name:k.string()}),License:k.nullable(k.object({Id:k.number().int(),Name:k.string(),Type:k.string(),Active:k.boolean()})),Availability:k.array(k.object({LicenseStart:k.nullable(k.string().datetime()),LicenseEnd:k.nullable(k.string().datetime())})),IsLicenseAvailable:k.optional(k.boolean())}),Yt=k.array(at);async function le(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 s=await e();return s.toLocaleLowerCase()==="agentic_ui_generator"?"agent":s.toLocaleLowerCase()==="ai_coding_assistants"?"assistant":"none"}function ce(){return'**Accessibility Guidelines: WCAG 2.2 Level AA Compliance**\n\n**Core Principles:**\n1. Use semantic HTML and ARIA correctly\n2. Ensure WCAG 2.2 AA compliance\n3. Follow W3C ARIA Authoring Practices\n4. Provide standards-based accessibility fixes\n\n**1. Form Control Labels** (WCAG 1.3.1, 3.3.2, 4.1.2)\nEvery input must have an associated label.\nCORRECT: `<input type="search" aria-label="Search products" placeholder="Search...">`\nWRONG: `<span>Email</span><input type="email">` (no association)\nWRONG: `<input type="email" placeholder="Email">` (placeholder as label)\n\n**2. Button Accessibility** (WCAG 4.1.2, 2.4.6, 2.5.3)\nAll buttons need accessible names describing their purpose.\nCORRECT: `<button type="button">Save Changes</button>`\nCORRECT: `<button aria-label="Close dialog"><svg aria-hidden="true" focusable="false">...</svg></button>`\nWRONG: `<button><svg>...</svg></button>` (no accessible name)\nWRONG: `<button>Click here</button>` (generic text)\n\n**3. Popup/Menu Triggers** (WCAG 4.1.2, 1.3.1)\nIndicate popup purpose and state using aria-haspopup, aria-expanded, aria-controls.\nCORRECT: `<button aria-expanded="false" aria-haspopup="menu" aria-controls="menu-id">Settings</button>`\n\n**4. Image Accessibility** (WCAG 1.1.1)\nInformative: `<img src="chart.png" alt="Sales increased 25% in Q4 2024">`\nFunctional: `<a href="/home"><img src="logo.png" alt="Company Name Home"></a>`\nDecorative: `<img src="border.png" alt="" role="presentation">`\nComplex: `<img src="chart.png" alt="Sales data" aria-describedby="desc-id">`\nWRONG: Missing alt, filename as alt, generic alt for decorative images\n\n**5. Link Accessibility** (WCAG 2.4.4, 2.4.6)\nLinks must be descriptive and understandable out of context.\nCORRECT: `<a href="/products">View All Products</a>`\nCORRECT: `<a href="/article" aria-label="Read more about New Product Launch">Read more</a>`\nWRONG: "Click here", "Read more", "Learn more" without context\n\n**6. Form Validation** (WCAG 3.3.1, 3.3.2, 3.3.3)\nErrors must be identified, associated with inputs, and provide suggestions. Use aria-describedby, aria-invalid="true", and role="alert".\n\n**7. Heading Structure** (WCAG 1.3.1, 2.4.6)\nEach page should 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\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>`, or `<footer>` in page/route components (the layout may already provide them), use `<section>` or `<div>` as page-level wrappers, semantic HTML\n- **Dynamic Content:** role="status"/aria-live="polite" for updates, role="alert"/aria-live="assertive" for critical alerts\n- **Keyboard/Focus:** All interactive elements keyboard accessible, logical focus order, visible focus indicators, no keyboard traps (except modals)\n- **Color/Contrast:** 4.5:1 text contrast (3:1 large text), 3:1 UI component contrast, no color-only information, 3:1 focus indicator contrast'}var it=1440*60*1e3;function de(e){let{serverName:t,contextApi:s,additionalFields:o={},intervalMs:n=it}=e,r="mcp_server_heartbeat",a=async()=>{try{let d={server_name:t,timestamp:new Date().toISOString(),...o};await s.logEvent(r,d)}catch(d){h(`Failed to send heartbeat for ${t}:`,d)}};a();let i=setInterval(a,n);return()=>{clearInterval(i),h(`Heartbeat stopped for ${t}`)}}import{z as K}from"zod";var lt=["default","bootstrap","material","fluent"];function pe(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(lt).default("default").describe("The Kendo UI theme to use. Determines which theme package is installed and imported.")}}var c="Kendo UI for Angular",w="angular",N="kendo",$=["AIPrompt","ActionSheet","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","BreadCrumb","Button","ButtonGroup","Calendar","Card","ChartWizard","Charts","CheckBox","Chip","ChipList","ChunkProgressBar","CircularGauge","CircularProgressBar","ColorGradient","ColorPalette","ColorPicker","ComboBox","ContextMenu","ConversationalUI","DataQuery","DateInput","DateMath","DatePicker","DateRange","DateTimePicker","Diagram","Dialog","DragandDrop","Drawer","Drawing","DropDownButton","DropDownList","DropDownTree","Editor","ExcelExport","ExpansionPanel","FileSaver","FileSelect","Filter","FlatColorPicker","FloatingActionButton","FloatingLabel","Forms","FormField","Gantt","Gauges","General","Grid","GridLayout","Icon","InlineAIPrompt","Label","LinearGauge","ListBox","ListView","Loader","Map","MaskedTextBox","Menu","MultiColumnComboBox","MultiSelect","MultiSelectTree","MultiViewCalendar","Notification","NumericTextBox","OTPInput","Pager","PanelBar","PDFExport","PDFViewer","PivotGrid","Popover","Popup","ProgressBar","PromptBox","QRCode","RadialGauge","RadioButton","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","SmartPasteButton","Sortable","StockChart","Sparkline","SpeechToTextButton","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","SVGIcon","Switch","TabStrip","TextArea","TextBox","TileLayout","Timeline","TimePicker","ToolBar","Tooltip","TreeList","TreeView","Typography","Upload","Window"],ue=new Map([["actionsheet","@progress/kendo-angular-navigation"],["aiprompt","@progress/kendo-angular-conversational-ui"],["appbar","@progress/kendo-angular-navigation"],["arcgauge","@progress/kendo-angular-gauges"],["autocomplete","@progress/kendo-angular-dropdowns"],["avatar","@progress/kendo-angular-layout"],["badge","@progress/kendo-angular-indicators"],["barcode","@progress/kendo-angular-barcodes"],["bottomnavigation","@progress/kendo-angular-navigation"],["breadcrumb","@progress/kendo-angular-navigation"],["button","@progress/kendo-angular-buttons"],["buttongroup","@progress/kendo-angular-buttons"],["calendar","@progress/kendo-angular-dateinputs"],["card","@progress/kendo-angular-layout"],["chartwizard","@progress/kendo-angular-chart-wizard"],["checkbox","@progress/kendo-angular-inputs"],["chip","@progress/kendo-angular-buttons"],["chiplist","@progress/kendo-angular-buttons"],["chunkprogressbar","@progress/kendo-angular-progressbar"],["circulargauge","@progress/kendo-angular-gauges"],["circularprogressbar","@progress/kendo-angular-progressbar"],["colorgradient","@progress/kendo-angular-inputs"],["colorpalette","@progress/kendo-angular-inputs"],["colorpicker","@progress/kendo-angular-inputs"],["combobox","@progress/kendo-angular-dropdowns"],["contextmenu","@progress/kendo-angular-menu"],["dataquery","@progress/kendo-data-query"],["dateinput","@progress/kendo-angular-dateinputs"],["datemath","@progress/kendo-date-math"],["datepicker","@progress/kendo-angular-dateinputs"],["daterangepicker","@progress/kendo-angular-dateinputs"],["datetimepicker","@progress/kendo-angular-dateinputs"],["diagram","@progress/kendo-angular-diagrams"],["dialog","@progress/kendo-angular-dialog"],["drawer","@progress/kendo-angular-layout"],["drawing","@progress/kendo-drawing"],["dropdownbutton","@progress/kendo-angular-buttons"],["dropdownlist","@progress/kendo-angular-dropdowns"],["dropdowntree","@progress/kendo-angular-dropdowns"],["editor","@progress/kendo-angular-editor"],["excelexport","@progress/kendo-angular-excel-export"],["expansionpanel","@progress/kendo-angular-layout"],["filesaver","@progress/kendo-file-saver"],["fileselect","@progress/kendo-angular-upload"],["filter","@progress/kendo-angular-filter"],["flatcolorpicker","@progress/kendo-angular-inputs"],["floatingactionbutton","@progress/kendo-angular-buttons"],["floatinglabel","@progress/kendo-angular-label"],["formfield","@progress/kendo-angular-inputs"],["forms","@progress/kendo-angular-inputs"],["gantt","@progress/kendo-angular-gantt"],["grid","@progress/kendo-angular-grid"],["gridlayout","@progress/kendo-angular-layout"],["icon","@progress/kendo-angular-icons"],["inlineaiprompt","@progress/kendo-angular-conversational-ui"],["label","@progress/kendo-angular-label"],["lineargauge","@progress/kendo-angular-gauges"],["listbox","@progress/kendo-angular-listbox"],["listview","@progress/kendo-angular-listview"],["loader","@progress/kendo-angular-indicators"],["map","@progress/kendo-angular-map"],["maskedtextbox","@progress/kendo-angular-inputs"],["menu","@progress/kendo-angular-menu"],["multicolumncombobox","@progress/kendo-angular-dropdowns"],["multiselect","@progress/kendo-angular-dropdowns"],["multiselecttree","@progress/kendo-angular-dropdowns"],["multiviewcalendar","@progress/kendo-angular-dateinputs"],["notification","@progress/kendo-angular-notification"],["numerictextbox","@progress/kendo-angular-inputs"],["otpinput","@progress/kendo-angular-inputs"],["pager","@progress/kendo-angular-pager"],["panelbar","@progress/kendo-angular-layout"],["pdfexport","@progress/kendo-angular-pdf-export"],["pdfviewer","@progress/kendo-angular-pdfviewer"],["pivotgrid","@progress/kendo-angular-pivotgrid"],["popover","@progress/kendo-angular-tooltip"],["popup","@progress/kendo-angular-popup"],["progressbar","@progress/kendo-angular-progressbar"],["promptbox","@progress/kendo-angular-conversational-ui"],["qrcode","@progress/kendo-angular-barcodes"],["radialgauge","@progress/kendo-angular-gauges"],["radiobutton","@progress/kendo-angular-inputs"],["rangeslider","@progress/kendo-angular-inputs"],["rating","@progress/kendo-angular-inputs"],["ripple","@progress/kendo-angular-ripple"],["sankey","@progress/kendo-angular-charts"],["scheduler","@progress/kendo-angular-scheduler"],["scrollview","@progress/kendo-angular-scrollview"],["signature","@progress/kendo-angular-inputs"],["skeleton","@progress/kendo-angular-indicators"],["slider","@progress/kendo-angular-inputs"],["smartpastebutton","@progress/kendo-angular-buttons"],["sortable","@progress/kendo-angular-sortable"],["sparkline","@progress/kendo-angular-charts"],["speechtotextbutton","@progress/kendo-angular-buttons"],["splitbutton","@progress/kendo-angular-buttons"],["splitter","@progress/kendo-angular-layout"],["spreadsheet","@progress/kendo-angular-spreadsheet"],["stacklayout","@progress/kendo-angular-layout"],["stepper","@progress/kendo-angular-layout"],["stockchart","@progress/kendo-angular-charts"],["svgicon","@progress/kendo-angular-icons"],["switch","@progress/kendo-angular-inputs"],["tabstrip","@progress/kendo-angular-layout"],["textarea","@progress/kendo-angular-inputs"],["textbox","@progress/kendo-angular-inputs"],["tilelayout","@progress/kendo-angular-layout"],["timeline","@progress/kendo-angular-layout"],["timepicker","@progress/kendo-angular-dateinputs"],["toolbar","@progress/kendo-angular-toolbar"],["treelist","@progress/kendo-angular-treelist"],["treeview","@progress/kendo-angular-treeview"],["typography","@progress/kendo-angular-typography"],["upload","@progress/kendo-angular-upload"],["window","@progress/kendo-angular-dialog"],["charts","@progress/kendo-angular-charts"],["conversationalui","@progress/kendo-angular-conversational-ui"],["tooltip","@progress/kendo-angular-tooltip"]]);var ut=dt(ct(pt(import.meta.url)),"../proto/service.proto"),_=new M("contextapi.telerik.com:443",ut,{libName:w});var me=async()=>_.validateUserLicense();import Ct from"fs";import Ye from"path";import{fileURLToPath as vt}from"url";import{z as b}from"zod";var v=class{constructor(t,s,o){this.name=t;this.config=s;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
|
|
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 U=(e,t)=>{let
|
|
49
|
+
`;var U=(e,t)=>{let s=L({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.":"",n=e.components?e.components.join(", "):"components";return`# \u{1F3AF} ${e.suiteName} - Execution Plan
|
|
50
50
|
|
|
51
51
|
**Current Goal:**
|
|
52
52
|
|
|
@@ -158,10 +158,10 @@ Based on your current goal, analyze what other ${e.suiteName} components are nee
|
|
|
158
158
|
- **Data Entry**: Consider Form, TextBox, DatePicker, DropDownList, Upload, Validation components
|
|
159
159
|
- **Content Management**: Consider Grid, Editor, TreeView, FileManager, Dialog components
|
|
160
160
|
- **E-commerce**: Consider ListView, Card, Button, Rating, Badge, Carousel components
|
|
161
|
-
${
|
|
161
|
+
${o}
|
|
162
162
|
|
|
163
163
|
**IMPORTANT COMPONENT USAGE REQUIREMENTS:**
|
|
164
|
-
- Make sure to identify all necessary features related to the ${
|
|
164
|
+
- Make sure to identify all necessary features related to the ${n} based on the current goal.
|
|
165
165
|
- Make sure to identify specific features needed for other ${e.suiteName} components based on the current goal.
|
|
166
166
|
- Make sure to generate a query for ${e.codeAssistantName} tool for each component and call the tool for each specific feature or functionality.
|
|
167
167
|
- Always specify the exact features you want for each component. Describe only the needed functionality, and behavior you need. Be concise and don't include any information about the use case.
|
|
@@ -259,7 +259,7 @@ ${t.injectedPlan??""}
|
|
|
259
259
|
**Step 1: Code Validation**
|
|
260
260
|
** CRITICAL REQUIREMENT: You MUST validate the generated UI code using this comprehensive checklist to ensure code quality and compliance:**
|
|
261
261
|
|
|
262
|
-
${
|
|
262
|
+
${s}
|
|
263
263
|
|
|
264
264
|
**Step 2: Final Review and Testing**
|
|
265
265
|
** Implementation Validation:**
|
|
@@ -279,7 +279,7 @@ After code implementation and validation you can make quick fixes as needed:
|
|
|
279
279
|
- Do NOT generate or suggest any code until all tools have been used and validated responses are incorporated.
|
|
280
280
|
- Focus on planning and sequencing.
|
|
281
281
|
- Summarize the components, layouts, and utilities gathered.
|
|
282
|
-
- Confirm all required inputs from tools have been provided.`};var
|
|
282
|
+
- Confirm all required inputs from tools have been provided.`};var j=e=>`# ${e.suiteName} Assistant
|
|
283
283
|
|
|
284
284
|
**What you're looking for:**
|
|
285
285
|
|
|
@@ -403,46 +403,46 @@ After gathering information:
|
|
|
403
403
|
- Consistent ${e} theme application across all components
|
|
404
404
|
- Custom theme variables properly defined and scoped
|
|
405
405
|
- ${e} icon fonts properly loaded and optimized
|
|
406
|
-
- Brand colors integrated with ${e} component themes`});function
|
|
407
|
-
- Name: ${
|
|
408
|
-
- Type: ${
|
|
406
|
+
- Brand colors integrated with ${e} component themes`});function mt(e,t){let s;try{s=JSON.parse(e)}catch{return e}let o=s?.Item;if(!o)return e;let n=[],r=o.FullName??o.Name??"",a=o.Type??"",i=o.Summary??"",d=o.SyntaxContent??"";n.push(`## API Reference Item
|
|
407
|
+
- Name: ${r}
|
|
408
|
+
- Type: ${a}
|
|
409
409
|
- Summary: ${i}
|
|
410
|
-
- Syntax: ${
|
|
411
|
-
`,l=0;for(let
|
|
410
|
+
- Syntax: ${d}`);let m=s.RelatedItemsByType?.return_type;if(m?.length){let p=m[0].Text;p&&n.push(`- Return Type: ${p}`)}let A=o.Examples??[];if(A.length>0){let p=`## Examples
|
|
411
|
+
`,l=0;for(let y of A){let S=(y.Component??"").toLowerCase(),C=t.toLowerCase();if(S&&S!==C&&S!=="general")continue;l+=1;let T=y.Code??"";p+=`### Example ${l}
|
|
412
412
|
\`\`\`
|
|
413
|
-
${
|
|
413
|
+
${T}
|
|
414
414
|
\`\`\`
|
|
415
|
-
`}l>0&&
|
|
416
|
-
${
|
|
417
|
-
`+
|
|
415
|
+
`}l>0&&n.push(p)}let g=s.RelatedItemsByType??{},f=[];for(let[p,l]of Object.entries(g))if(!(p==="return_type"||p==="render_fragment"))for(let y of l??[]){let S=y.FullName??"",C=y.ShortText??"";f.push(`### ${S} (${p})
|
|
416
|
+
${C}`)}return f.length>0&&n.push(`## Additional Context
|
|
417
|
+
`+f.join(`
|
|
418
418
|
---
|
|
419
|
-
`)),
|
|
419
|
+
`)),n.join(`
|
|
420
420
|
|
|
421
|
-
`)}function
|
|
422
|
-
`)||"No CSS utilities found for the given prompt.",
|
|
421
|
+
`)}function ge(e,t,s){let{name:o,title:n,description:r,layoutAssistantName:a,codeAssistantName:i,styleAssistantName:d,iconAssistantName:m,accessibilityAssistantName:A,suiteName:g,libKey:f,components:p}=e,l=new v(o,{title:n,description:r,requiredAccess:e.requiredAccess,inputSchema:{userIntent:b.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 ${g} components you want to use.`),needsComponentsDocsConfidence:b.number().min(0).max(1).default(1).describe("Confidence (0-1) to include Component Documentation assistance. Default is 1."),needsLayoutConfidence:b.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Layout assistance. Default is 0."),needsStylingConfidence:b.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Theming/Styling assistance. Default is 0."),needsResponsiveBehaviorConfidence:b.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Responsive Behavior assistance. Default is 0."),needsIconsConfidence:b.number().min(0).max(1).default(0).describe("Confidence (0-1) to include Icons assistance. Default is 0."),componentsNeeded:b.array(b.enum(p)).optional().describe(`Optional list of specific ${g} components needed for the project.`)}},async({userIntent:y,needsComponentsDocsConfidence:S,needsLayoutConfidence:C,needsStylingConfidence:T,needsResponsiveBehaviorConfidence:I,needsIconsConfidence:Z,componentsNeeded:X},{_meta:Qe})=>{h("UI Orchestrator called with:",{userIntent:y,needsComponentsDocsConfidence:S,needsLayoutConfidence:C,needsStylingConfidence:T,needsResponsiveBehaviorConfidence:I,needsIconsConfidence:Z});try{await s.recordOrchestratorUserRequest({meta:{userIntent:y,componentsNeeded:X,_meta:Qe}})}catch(D){throw R(D)}let Je=l.server?.server.getClientCapabilities?.()?.elicitation,ee;if(Je&&T>.3&&T<=.6){let D=await l.server?.server.elicitInput({message:"I was unable to determine if you need custom Kendo Theme assistant. Can you please confirm?",requestedSchema:{type:"object",properties:{includeCustomTheming:{type:"boolean",description:"Whether to include Custom Theming assistance in the workflow."}},required:["includeCustomTheming"]}});D?.action==="accept"&&D.content?.includeCustomTheming&&(ee=!0)}return{content:[{type:"text",text:U({name:o,userIntent:y,includeComponentsDocs:S>.3,includeTheming:T>.6||!!ee,includeLayout:C>.5,includeIcons:Z>.6,includeResponsive:C>.5&&I>.4,layoutAssistantName:a,codeAssistantName:i,styleAssistantName:d,iconAssistantName:m,accessibilityAssistantName:A,suiteName:g,libKey:f,components:X},t)}]}});return l}function he(e,t){let{name:s,title:o,description:n,iconAssistantName:r,codeAssistantName:a,suiteName:i,libKey:d,components:m}=e;return new v(s,{title:o,description:n,inputSchema:{userIntent:b.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:b.number().min(0).max(1).default(.7).describe("Confidence (0-1) to include Icons assistance. Default is 0.7."),componentsNeeded:b.array(b.enum(m)).optional().describe(`Optional list of specific ${i} components you want to learn about.`)},requiredAccess:e.requiredAccess},async({userIntent:g,needsIconsConfidence:f,componentsNeeded:p},{_meta:l})=>{h("Assistant Orchestrator called with:",{userIntent:g,needsIconsConfidence:f,componentsNeeded:p});try{await t.recordOrchestratorUserRequest({meta:{userIntent:g,componentsNeeded:p,_meta:l}})}catch(S){throw R(S)}return{content:[{type:"text",text:j({name:s,userIntent:g,includeComponentsDocs:!0,includeIcons:f>.5,codeAssistantName:a,iconAssistantName:r,suiteName:i,libKey:d,components:p})}]}})}function fe(e,t){let{name:s,title:o,description:n,suiteName:r,libKey:a,getPreContent:i}=e;return new v(s,{title:o,description:n,requiredAccess:e.requiredAccess,inputSchema:{prompt:b.string().describe("An enhanced prompt describing the HTML layout structure, design requirements or specific visual effects you want to achieve."),includeBuildingBlockExamples:b.boolean().describe("Whether to include building block examples. Defaults to false.").default(!1)}},async({prompt:d,includeBuildingBlockExamples:m},{_meta:A})=>{h("Layout Assistant called with:",{prompt:d,includeBuildingBlockExamples:m});try{let f=(await t.queryCssUtils({query:d},{_meta:A})).values.join(`
|
|
422
|
+
`)||"No CSS utilities found for the given prompt.",p=i?.()??"",l=y=>`${p}
|
|
423
423
|
|
|
424
424
|
# Kendo Design System CSS Utilities
|
|
425
425
|
|
|
426
|
-
${
|
|
427
|
-
${
|
|
428
|
-
`;if(
|
|
426
|
+
${f}
|
|
427
|
+
${y??""}
|
|
428
|
+
`;if(m)try{let y=await t.queryBuildingBlocks({query:d,lib_name:a},{_meta:A}),S="";y.items?.length>0&&(S=`
|
|
429
429
|
## Building Blocks Examples
|
|
430
430
|
|
|
431
431
|
The examples here are for demonstration purpose how CSS utils can be implemented in various building blocks.
|
|
432
432
|
However, consider your own design requirements and specifics in order to implement your templates/building blocks correctly.
|
|
433
433
|
|
|
434
|
-
${
|
|
435
|
-
### ${
|
|
434
|
+
${y.items.map(C=>`
|
|
435
|
+
### ${C.name}
|
|
436
436
|
|
|
437
|
-
${
|
|
437
|
+
${C.description}
|
|
438
438
|
|
|
439
439
|
\`\`\`code
|
|
440
|
-
${
|
|
440
|
+
${C.code}
|
|
441
441
|
\`\`\`
|
|
442
442
|
`).join(`
|
|
443
|
-
`)}`),
|
|
443
|
+
`)}`),f=l(S)}catch(y){h("Error calling building-blocks service:",y),f=l()}else f=l();return{content:[{type:"text",text:f}]}}catch(g){throw R(g)}})}function ye(e,t){let{name:s,title:o,description:n,libKey:r,getPreContent:a}=e;return new v(s,{title:o,description:n,requiredAccess:e.requiredAccess,inputSchema:{prompt:b.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:i},{_meta:d})=>{h("Style Assistant called with:",{prompt:i});let m="";try{let f=await t.queryThemeGenerate({prompt:i},{_meta:d});if(f.variables_json){let p=JSON.parse(f.variables_json),l=[];if(p)for(let y of Object.keys(p))typeof p[y]=="string"&&l.push(`${y}: ${p[y]}`);m=l.join(`
|
|
444
444
|
|
|
445
|
-
`)}}catch(
|
|
445
|
+
`)}}catch(f){throw R(f)}let A=a?.()??"";return{content:[{type:"text",text:m?`Use the following CSS variables to style the web application, including colors, typography, spacing, and component appearance.
|
|
446
446
|
Ensure the variables are applied consistently across all relevant elements.
|
|
447
447
|
Do NOT set any inline styles. CSS variables should be defined in global or component-level CSS files, or via supported theming mechanisms.
|
|
448
448
|
|
|
@@ -451,29 +451,29 @@ ${A}
|
|
|
451
451
|
## Generated CSS Variables
|
|
452
452
|
|
|
453
453
|
\`\`\`css
|
|
454
|
-
${
|
|
454
|
+
${m}
|
|
455
455
|
\`\`\`
|
|
456
|
-
`:"No CSS variables were generated for the given prompt."}]}})}function
|
|
456
|
+
`:"No CSS variables were generated for the given prompt."}]}})}function Ae(e,t){let{name:s,title:o,description:n,libKey:r,getPostContent:a}=e;return new v(s,{title:o,description:n,requiredAccess:e.requiredAccess,inputSchema:{query:b.string().describe("A search query for finding icons. Be specific about the icon purpose, style, or action."),limit:b.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:i,limit:d},{_meta:m})=>{h("Icon Search called with:",{query:i,limit:d});try{let A=await t.queryIconsSearch({query:i,limit:d*100},{_meta:m}),g=a?.()??"";return{content:[{type:"text",text:`${A.values.join(`
|
|
457
457
|
|
|
458
458
|
`)}
|
|
459
459
|
|
|
460
|
-
${
|
|
460
|
+
${g}`}]}}catch(A){throw R(A)}})}function be(e,t){let{name:s,title:o,description:n,libKey:r,suiteName:a,components:i,componentAliases:d,getPostContent:m}=e;return new v(s,{title:o,description:n,requiredAccess:e.requiredAccess,inputSchema:{query:b.string().describe("The query to search for."),component:b.enum(i).describe("The component to search for. If not specified, use General.")}},async({query:A,component:g},{_meta:f})=>{h("Code Assistant called with:",{query:A,component:g});let p=g;if(d){let l=d[g];l&&(p=l)}try{let y=(await t.query({query:A,component:p?.toLowerCase()??"general",lib_name:r,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]},{_meta:f})).values.map(T=>T.replace(/\0/g,"")),S=m?.({component:g})??"";return{content:[{type:"text",text:`${y.join(`
|
|
461
461
|
|
|
462
462
|
`)}
|
|
463
463
|
|
|
464
|
-
${
|
|
464
|
+
${S}`}]}}catch(l){throw R(l)}})}function ke(e,t){let{name:s,title:o,description:n,libKey:r,suiteName:a,components:i,componentAliases:d}=e;return new v(s,{title:o,description:n,requiredAccess:e.requiredAccess,inputSchema:{query:b.string().describe("The query to search for."),component:b.enum(i).describe("The component to search for. If not specified, use General."),includeGeneralGuidelines:b.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:m,component:A,includeGeneralGuidelines:g},{_meta:f})=>{h("Accessibility Assistant called with:",{query:m,component:A,includeGeneralGuidelines:g});let p=A;if(d){let l=d[A];l&&(p=l)}try{let l="";if(g){let I=ce();l+=`# WCAG 2.2 Level AA General Accessibility Guidelines
|
|
465
465
|
|
|
466
466
|
`,l+=I,l+=`
|
|
467
467
|
|
|
468
468
|
---
|
|
469
469
|
|
|
470
|
-
`}let
|
|
470
|
+
`}let T=(await t.getApiRefMatches({query:m,component:p?.toLowerCase()??"general",lib_name:r,filters_json:'{"type":{"$in":["accessibility"]}}'},{_meta:f})).values.map(I=>I.replace(/\0/g,"")).map(I=>mt(I,p?.toLowerCase()??"general")).join(`
|
|
471
471
|
|
|
472
|
-
`);return
|
|
472
|
+
`);return T?(g&&(l+=`# Component-Specific Accessibility Information
|
|
473
473
|
|
|
474
|
-
`),l+=
|
|
474
|
+
`),l+=T):g||(l="No component-specific accessibility guidelines found."),{content:[{type:"text",text:l}]}}catch(l){throw R(l)}})}function R(e){let t=e;return t.code===16?new Error("Error: You are not authenticated. Please verify the Telerik License Key provided is valid."):t.code===8?new Error(`Error: You have exceeded the extension quota. Upgrade to subscription licensing to unlock full access. Message: ${t.message}.`):t.code===7?new Error("Error: You do not have permission to access this resource. Please verify that you have a valid license."):new Error(`Error: An error occurred while calling the service. Please try again later.
|
|
475
475
|
|
|
476
|
-
Error Code: ${t.code} Error Message: ${t.message}`)}var
|
|
476
|
+
Error Code: ${t.code} Error Message: ${t.message}`)}var Se=e=>`${e}_ui_generator`,Ce=e=>`${e}_assistant`,ve=e=>`${e}_layout_assistant`,Te=e=>`${e}_component_assistant`,we=e=>`${e}_style_assistant`,Ie=e=>`${e}_icon_assistant`,Ne=e=>`${e}_accessibility_assistant`,Ee=e=>`${e}_getting_started_assistant`;var xe=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.
|
|
477
477
|
|
|
478
478
|
Use the tool when:
|
|
479
479
|
- Want to build or modify a complete page or section layout
|
|
@@ -482,7 +482,7 @@ Error Code: ${t.code} Error Message: ${t.message}`)}var Ae=e=>`${e}_ui_generator
|
|
|
482
482
|
- You want to enforce best practices in styling, performance, and accessibility
|
|
483
483
|
|
|
484
484
|
Returns:
|
|
485
|
-
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,
|
|
485
|
+
A detailed execution plan with validated tool calls, parameters, and reasoning \u2014 ensuring consistent, high-quality UI generation.`,Re=e=>`Provides guidance for discovering and using ${e} components and icons. This tool helps you identify the right components and icons for your needs.
|
|
486
486
|
|
|
487
487
|
Use this tool when:
|
|
488
488
|
- You need to discover which ${e} components are suitable for a specific use case
|
|
@@ -491,20 +491,20 @@ Use this tool when:
|
|
|
491
491
|
- You want to gather component documentation and examples
|
|
492
492
|
|
|
493
493
|
Returns:
|
|
494
|
-
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,
|
|
494
|
+
A focused plan for gathering component documentation and icon suggestions using the Component Assistant and Icon Assistant tools.`,Pe=`Retrieves Progress/Kendo Design System CSS utility classes and styling recommendations based on layout and design requirements.
|
|
495
495
|
Use this tool to find the right CSS utilities for styling Kendo UI components or general web elements.
|
|
496
496
|
It analyzes the provided design context and returns relevant utility classes with explanations and examples.
|
|
497
|
-
Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,
|
|
497
|
+
Best suited for styling questions related to typography, spacing, colors, layout, transforms, and other utilities in the Progress/Kendo Design System.`,Oe=`Generates CSS variables using an external style agent based on the user's styling prompt.
|
|
498
498
|
|
|
499
499
|
Use this tool when the user wants to:
|
|
500
500
|
- Update the visual theme of an application
|
|
501
501
|
- Modify color schemes
|
|
502
502
|
- Restyle the UI with CSS variables
|
|
503
503
|
|
|
504
|
-
The tool outputs a set of CSS variable definitions ready to be applied to style files
|
|
504
|
+
The tool outputs a set of CSS variable definitions ready to be applied to style files.`,$e=`Searches for icons in the Telerik Icons library.
|
|
505
505
|
Use this tool when the user needs to find specific icons for UI components or design elements.
|
|
506
506
|
It supports searching by icon name, category, or keyword and returns matching icons from the Telerik Icons library.
|
|
507
|
-
`,
|
|
507
|
+
`,_e=e=>`Provides answers and retrieves official documentation for ${e}.
|
|
508
508
|
|
|
509
509
|
Use this tool when the user asks about:
|
|
510
510
|
- ${e} features or capabilities
|
|
@@ -514,7 +514,7 @@ Use this tool when the user asks about:
|
|
|
514
514
|
|
|
515
515
|
Set the user's full question as the 'query' parameter.
|
|
516
516
|
If the question refers to a specific ${e} component, include its name in the 'component' parameter.
|
|
517
|
-
`,
|
|
517
|
+
`,Le=e=>`Retrieves accessibility guidance for ${e} components with optional general WCAG 2.2 Level AA guidelines.
|
|
518
518
|
|
|
519
519
|
Use this tool when:
|
|
520
520
|
- You need component-specific accessibility information and API references
|
|
@@ -532,7 +532,7 @@ Set 'includeGeneralGuidelines=true' ONLY on the first call to include general WC
|
|
|
532
532
|
Returns:
|
|
533
533
|
- When includeGeneralGuidelines=true: General WCAG 2.2 Level AA guidelines + component-specific recommendations
|
|
534
534
|
- When includeGeneralGuidelines=false: Only component-specific accessibility recommendations
|
|
535
|
-
`;var V=x("Kendo UI","Kendo"),
|
|
535
|
+
`;var V=x("Kendo UI","Kendo"),z=`
|
|
536
536
|
### Angular Component Validation
|
|
537
537
|
Component Structure:
|
|
538
538
|
- Use proper @Component decorator configuration
|
|
@@ -586,7 +586,7 @@ Accessibility
|
|
|
586
586
|
2. Match the discovered patterns in all generated code
|
|
587
587
|
3. Maintain consistent formatting, indentation, and code organization with existing files
|
|
588
588
|
4. Always use the same theme import mechanism (unless user specifies otherwise)
|
|
589
|
-
`;var Y=x("Kendo UI","KendoReact"),
|
|
589
|
+
`;var Y=x("Kendo UI","KendoReact"),H=`
|
|
590
590
|
### React Component Validation
|
|
591
591
|
Component Structure:
|
|
592
592
|
- Use proper function component patterns with Hooks
|
|
@@ -609,7 +609,7 @@ ${Y.THEME_AND_STYLING}
|
|
|
609
609
|
- Make sure theme import mechanism is consistent with existing project setup
|
|
610
610
|
|
|
611
611
|
Accessibility
|
|
612
|
-
- Accessibility guidelines retrieved and applied to all components`;var
|
|
612
|
+
- Accessibility guidelines retrieved and applied to all components`;var gt={createOrchestrator:ge,createAssistantOrchestrator:he,createLayoutAssistant:fe,createStyleAssistant:ye,createIconSearch:Ae,createCodeAssistant:be,createAccessibilityAssistant:ke},ht={orchestrator:Se,assistantOrchestrator:Ce,layoutAssistant:ve,codeAssistant:Te,styleAssistant:we,iconAssistant:Ie,accessibilityAssistant:Ne,gettingStartedAssistant:Ee},ft={orchestrator:xe,assistantOrchestrator:Re,layoutAssistant:Pe,styleAssistant:Oe,iconAssistant:$e,codeAssistant:_e,accessibilityAssistant:Le},yt={Orchestrator:{render:U},Validator:{render:L},SharedValidation:{getSteps:x}},At={Angular:{steps:z,additionalPlan:W},React:{steps:H}},u={Tools:gt,ToolNames:ht,ToolDescriptions:ft,Templates:yt,Validation:At};var bt=u.ToolNames.codeAssistant("kendo"),Ue=()=>`# Kendo Design System Guidelines for ${c}
|
|
613
613
|
|
|
614
614
|
## Setting up Styles/CSS
|
|
615
615
|
|
|
@@ -636,14 +636,14 @@ Alternatively, you can also consume them directly from the Unpkg CDN.
|
|
|
636
636
|
|
|
637
637
|
## Ready-to-use Layout Components
|
|
638
638
|
|
|
639
|
-
In the ${
|
|
639
|
+
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.
|
|
640
640
|
|
|
641
|
-
For any Layout component you can also call the ${
|
|
641
|
+
For any Layout component you can also call the ${bt} tool in order to get specific API reference and docs.
|
|
642
642
|
|
|
643
|
-
- ${
|
|
643
|
+
- ${c} Card component.
|
|
644
644
|
- Generally, it is recommended to use 100% width (e.g., \`<kendo-card width="100%">\`)
|
|
645
645
|
- If needed, use specific width based on the layout requirements (e.g., \`<kendo-card width="150px">\`)
|
|
646
|
-
`;var
|
|
646
|
+
`;var De=()=>`## Applying CSS Variables in ${c}
|
|
647
647
|
|
|
648
648
|
Apply these CSS variables in the Angular application using one of these methods:
|
|
649
649
|
|
|
@@ -705,7 +705,7 @@ export class ThemeService {
|
|
|
705
705
|
}
|
|
706
706
|
}
|
|
707
707
|
\`\`\`
|
|
708
|
-
`;var
|
|
708
|
+
`;var Ge=u.ToolNames.codeAssistant("kendo"),Me=()=>`## Using ${c} Icons
|
|
709
709
|
|
|
710
710
|
Important: Attempt to prioritize SVG icons over font icons.
|
|
711
711
|
|
|
@@ -713,13 +713,13 @@ Important: Attempt to prioritize SVG icons over font icons.
|
|
|
713
713
|
|
|
714
714
|
- Make sure @progress/kendo-svg-icons is installed.
|
|
715
715
|
- Make sure @progress/kendo-angular-icons is installed.
|
|
716
|
-
- You can call ${
|
|
716
|
+
- You can call ${Ge} tool for ${c} SVGIcon component for docs and API reference.
|
|
717
717
|
- [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.
|
|
718
|
-
- [optional] If using font icons you can call ${
|
|
718
|
+
- [optional] If using font icons you can call ${Ge} tool for ${c} Icon component for docs and API reference.
|
|
719
719
|
|
|
720
720
|
### Examples
|
|
721
721
|
|
|
722
|
-
Using ${
|
|
722
|
+
Using ${c} SVGIcon component:
|
|
723
723
|
|
|
724
724
|
\`\`\`ts
|
|
725
725
|
import { Component } from "@angular/core";
|
|
@@ -740,7 +740,7 @@ export class AppComponent {
|
|
|
740
740
|
|
|
741
741
|
\`\`\`
|
|
742
742
|
|
|
743
|
-
Using ${
|
|
743
|
+
Using ${c} Icon component:
|
|
744
744
|
|
|
745
745
|
\`\`\`ts
|
|
746
746
|
import { Component } from "@angular/core";
|
|
@@ -756,20 +756,267 @@ import { KENDO_ICONS } from "@progress/kendo-angular-icons";
|
|
|
756
756
|
})
|
|
757
757
|
export class AppComponent {}
|
|
758
758
|
\`\`\`
|
|
759
|
-
`;var
|
|
759
|
+
`;var qe=e=>{let t=e.component?.trim().toLowerCase(),s=ue.get(t),o=`## ${c} Common Guidelines
|
|
760
760
|
|
|
761
|
-
`;return
|
|
761
|
+
`;return s&&(o+=`### Package Installation
|
|
762
762
|
Always use minimal, targeted package installation.
|
|
763
763
|
Ensure all necessary Angular packages are installed, including @angular/localize.
|
|
764
764
|
|
|
765
765
|
Process:
|
|
766
766
|
1. Identify the required components
|
|
767
767
|
2. Determine the specific Kendo Angular packages needed
|
|
768
|
-
3. Use the "ng add ${
|
|
768
|
+
3. Use the "ng add ${s}" command
|
|
769
769
|
|
|
770
|
-
For ${e.component} component: \`ng add ${
|
|
771
|
-
`),e.componentInstructions&&(
|
|
770
|
+
For ${e.component} component: \`ng add ${s}\`
|
|
771
|
+
`),e.componentInstructions&&(o+=`
|
|
772
772
|
## Component-Specific Guidelines
|
|
773
773
|
|
|
774
774
|
${e.componentInstructions}
|
|
775
|
-
`),
|
|
775
|
+
`),o};function Be(e="kendo-angular-app",t=!0,s="default"){let o=t?`These instructions will walk you through creating a new Angular project and setting up ${c}.`:`These instructions will walk you through adding ${c} to your existing Angular project.`,n=1,r=t?`## Step ${n++}: Install Angular CLI
|
|
776
|
+
|
|
777
|
+
First, ensure the Angular CLI is installed globally:
|
|
778
|
+
|
|
779
|
+
\`\`\`bash
|
|
780
|
+
npm install -g @angular/cli@latest
|
|
781
|
+
\`\`\`
|
|
782
|
+
|
|
783
|
+
## Step ${n++}: Create the Project
|
|
784
|
+
|
|
785
|
+
Create a new Angular project using the Angular CLI:
|
|
786
|
+
|
|
787
|
+
\`\`\`bash
|
|
788
|
+
ng new ${e} --style=css --ai-config=none --no-ssr --routing
|
|
789
|
+
\`\`\`
|
|
790
|
+
|
|
791
|
+
Navigate to the project directory:
|
|
792
|
+
|
|
793
|
+
\`\`\`bash
|
|
794
|
+
cd ${e}
|
|
795
|
+
\`\`\`
|
|
796
|
+
|
|
797
|
+
`:"";return`# Getting Started with ${c}
|
|
798
|
+
|
|
799
|
+
${o}
|
|
800
|
+
|
|
801
|
+
Execute the following steps in order.
|
|
802
|
+
|
|
803
|
+
**Run all provided commands automatically and create the project directly for the user, rather than just providing instructions.**
|
|
804
|
+
|
|
805
|
+
|
|
806
|
+
## Prerequisites
|
|
807
|
+
|
|
808
|
+
Before you begin, ensure you have:
|
|
809
|
+
- **Node.js 18 or later** installed on your machine
|
|
810
|
+
- If Node.js is not available, you need to install the latest Node.js automatically as a preliminary step before installing the Angular CLI tool.
|
|
811
|
+
|
|
812
|
+
${r}## Step ${n++}: Configure Zone Change Detection and animations
|
|
813
|
+
|
|
814
|
+
This ensures the Zone, change detection behavior, and animations that ${c} components rely on.
|
|
815
|
+
|
|
816
|
+
1. Install ZoneJS. This shouyld be done manually, because newest versions of Angular do not include it by default:
|
|
817
|
+
\`\`\`bash
|
|
818
|
+
npm install zone.js
|
|
819
|
+
\`\`\`
|
|
820
|
+
|
|
821
|
+
${c} components rely on ZoneJS to trigger change detection.
|
|
822
|
+
|
|
823
|
+
2. In your \`src/main.ts\`, ensure you import 'zone.js':
|
|
824
|
+
\`\`\` typescript
|
|
825
|
+
import 'zone.js';
|
|
826
|
+
\`\`\`
|
|
827
|
+
|
|
828
|
+
3. Open the \`src/app/app.config.ts\` file and add \`provideZoneChangeDetection\`.
|
|
829
|
+
\`\`\`typescript
|
|
830
|
+
import { provideZoneChangeDetection } from '@angular/core';
|
|
831
|
+
import {provideAnimations} from '@angular/platform-browser/animations';
|
|
832
|
+
|
|
833
|
+
export const appConfig: ApplicationConfig = {
|
|
834
|
+
providers: [
|
|
835
|
+
provideZoneChangeDetection({ eventCoalescing: true }),
|
|
836
|
+
provideAnimations(),
|
|
837
|
+
// ... other providers
|
|
838
|
+
]
|
|
839
|
+
};
|
|
840
|
+
\`\`\`
|
|
841
|
+
|
|
842
|
+
In your \`src/main.ts\`, ensure you import 'zone.js':
|
|
843
|
+
\`\`\` typescript
|
|
844
|
+
import 'zone.js';
|
|
845
|
+
\`\`\`
|
|
846
|
+
|
|
847
|
+
## Step ${n++}: Install ${c} Packages
|
|
848
|
+
|
|
849
|
+
Use angular CLI to install grid package. While installing, confirm that you also want to install the underlying npm package with the suggested version from the ng tool.
|
|
850
|
+
|
|
851
|
+
\`\`\`bash
|
|
852
|
+
ng add @progress/kendo-angular-grid@latest --skip-confirmation --theme=${s}
|
|
853
|
+
\`\`\`
|
|
854
|
+
|
|
855
|
+
Use npm to install additional required ${c} packages:
|
|
856
|
+
|
|
857
|
+
\`\`\`bash
|
|
858
|
+
npm install @progress/kendo-angular-barcodes @progress/kendo-angular-chart-wizard @progress/kendo-angular-charts @progress/kendo-angular-dateinputs @progress/kendo-angular-diagrams @progress/kendo-angular-editor @progress/kendo-angular-filter @progress/kendo-angular-gantt @progress/kendo-angular-gauges @progress/kendo-angular-icons @progress/kendo-angular-listbox @progress/kendo-angular-listview @progress/kendo-angular-map @progress/kendo-angular-pdfviewer @progress/kendo-angular-pivotgrid @progress/kendo-angular-ripple @progress/kendo-angular-scheduler @progress/kendo-angular-scrollview @progress/kendo-angular-sortable @progress/kendo-angular-spreadsheet @progress/kendo-angular-tooltip @progress/kendo-angular-treelist @progress/kendo-angular-typography @progress/kendo-file-saver
|
|
859
|
+
\`\`\`
|
|
860
|
+
|
|
861
|
+
## Step ${n++}: Activate Kendo license
|
|
862
|
+
|
|
863
|
+
This step is required to use Kendo UI for Angular components without watermarks and with access to all features. Run the following command to activate your license:
|
|
864
|
+
|
|
865
|
+
\`\`\`bash
|
|
866
|
+
npx kendo license activate
|
|
867
|
+
\`\`\`
|
|
868
|
+
|
|
869
|
+
## Step ${n++}: Install the Kendo utils package
|
|
870
|
+
|
|
871
|
+
Add the following script to index.html to include the Kendo theme utils, which are required for the themes to work correctly:
|
|
872
|
+
|
|
873
|
+
\`\`\`html
|
|
874
|
+
<link rel="stylesheet" href="https://unpkg.com/@progress/kendo-theme-utils/dist/all.css" />
|
|
875
|
+
\`\`\`
|
|
876
|
+
|
|
877
|
+
${t?`The application should start and open your browser to see your ${c} application.`:`The application should start and open in your browser. Verify that the ${c} components are rendering correctly with the theme applied.`}
|
|
878
|
+
|
|
879
|
+
## Step ${n++}: Create Sample Page
|
|
880
|
+
|
|
881
|
+
Add the sample page below to your application to verify that everything is working correctly.
|
|
882
|
+
|
|
883
|
+
It's important to use this exact code for the getting started experience, as it includes a variety of components and layouts to verify that everything is working correctly.
|
|
884
|
+
|
|
885
|
+
1. Replace the content of \`src/app/app.ts\` with the following:
|
|
886
|
+
|
|
887
|
+
\`\`\`typescript
|
|
888
|
+
import { Component } from '@angular/core';
|
|
889
|
+
import { CardModule } from '@progress/kendo-angular-layout';
|
|
890
|
+
|
|
891
|
+
@Component({
|
|
892
|
+
selector: 'app-root',
|
|
893
|
+
standalone: true,
|
|
894
|
+
imports: [CardModule],
|
|
895
|
+
templateUrl: './app.html',
|
|
896
|
+
styleUrl: './app.css'
|
|
897
|
+
})
|
|
898
|
+
export class App {}
|
|
899
|
+
\`\`\`
|
|
900
|
+
|
|
901
|
+
2. Replace the content of \`src/app/app.html\` with the following:
|
|
902
|
+
|
|
903
|
+
\`\`\`html
|
|
904
|
+
<div class="k-d-flex k-flex-col k-gap-5 k-p-6">
|
|
905
|
+
<div class="k-d-flex k-flex-col k-align-items-center k-gap-3 k-py-4">
|
|
906
|
+
<h1 class="k-h2 k-text-center">${c}</h1>
|
|
907
|
+
<p class="k-h5 k-text-center k-color-subtle k-font-weight-normal k-max-w-3xl">
|
|
908
|
+
Create sophisticated Angular UIs with AI-powered agents using natural language prompts
|
|
909
|
+
</p>
|
|
910
|
+
</div>
|
|
911
|
+
|
|
912
|
+
<div class="k-text-center k-py-2">
|
|
913
|
+
<p class="k-font-size-lg k-font-weight-bold k-mb-4">\u{1F60A} Ready to build? Copy any prompt below directly into your coding agent to get started</p>
|
|
914
|
+
<div class="k-d-grid k-grid-cols-3 k-gap-4 k-max-w-screen-xl k-mx-auto">
|
|
915
|
+
<div class="prompt-box k-p-4 k-rounded-md">
|
|
916
|
+
<p class="k-font-family-monospace k-text-base k-m-0">'#kendo_ui_generator Create a dashboard with sales charts, revenue KPIs, and a recent orders grid'</p>
|
|
917
|
+
</div>
|
|
918
|
+
<div class="prompt-box k-p-4 k-rounded-md">
|
|
919
|
+
<p class="k-font-family-monospace k-text-base k-m-0">'#kendo_ui_generator Create an ecommerce product details page with product images, specifications, reviews, and an add to cart button'</p>
|
|
920
|
+
</div>
|
|
921
|
+
<div class="prompt-box k-p-4 k-rounded-md">
|
|
922
|
+
<p class="k-font-family-monospace k-text-base k-m-0">'#kendo_ui_generator Build a registration form with email and password inputs, where did you learn about us text area, and agreement checkbox'</p>
|
|
923
|
+
</div>
|
|
924
|
+
</div>
|
|
925
|
+
</div>
|
|
926
|
+
|
|
927
|
+
<div class="k-text-center">
|
|
928
|
+
<p class="k-font-size-lg k-font-weight-bold k-mb-0 k-mt-4">\u{1F6E0} Explore the tools available to help you build faster</p>
|
|
929
|
+
</div>
|
|
930
|
+
|
|
931
|
+
<div class="k-d-grid k-grid-cols-3 k-gap-5 k-max-w-screen-xl k-mx-auto">
|
|
932
|
+
<kendo-card width="auto">
|
|
933
|
+
<kendo-card-header class="k-py-2">
|
|
934
|
+
<span kendoCardTitle class="card-title k-font-weight-bold">\u{1F3A8} UI Generator</span>
|
|
935
|
+
</kendo-card-header>
|
|
936
|
+
<kendo-card-body>
|
|
937
|
+
<p class="k-mb-3 k-font-size-lg">Build complete pages and sections from a plain-language description, combining the right tools automatically.</p>
|
|
938
|
+
<p class="k-font-size-lg"><strong>Examples:</strong> Dashboards, landing pages, admin panels</p>
|
|
939
|
+
</kendo-card-body>
|
|
940
|
+
</kendo-card>
|
|
941
|
+
|
|
942
|
+
<kendo-card width="auto">
|
|
943
|
+
<kendo-card-header class="k-py-2">
|
|
944
|
+
<span kendoCardTitle class="card-title k-font-weight-bold">\u{1F9E9} Component Assistant</span>
|
|
945
|
+
</kendo-card-header>
|
|
946
|
+
<kendo-card-body>
|
|
947
|
+
<p class="k-mb-3 k-font-size-lg">Generate Angular components with the necessary configuration tailored to your specific requirements.</p>
|
|
948
|
+
<p class="k-font-size-lg"><strong>Components:</strong> Grid, Chart, Scheduler, Form, Navigation</p>
|
|
949
|
+
</kendo-card-body>
|
|
950
|
+
</kendo-card>
|
|
951
|
+
|
|
952
|
+
<kendo-card width="auto">
|
|
953
|
+
<kendo-card-header class="k-py-2">
|
|
954
|
+
<span kendoCardTitle class="card-title k-font-weight-bold">\u{1F4D0} Layout Assistant</span>
|
|
955
|
+
</kendo-card-header>
|
|
956
|
+
<kendo-card-body>
|
|
957
|
+
<p class="k-mb-3 k-font-size-lg">Build and arrange layouts, spacing your UI elements precisely for any screen size without writing custom CSS.</p>
|
|
958
|
+
<p class="k-font-size-lg"><strong>Utilities:</strong> Flexbox, Grid, Spacing, Typography</p>
|
|
959
|
+
</kendo-card-body>
|
|
960
|
+
</kendo-card>
|
|
961
|
+
|
|
962
|
+
<kendo-card width="auto">
|
|
963
|
+
<kendo-card-header class="k-py-2">
|
|
964
|
+
<span kendoCardTitle class="card-title k-font-weight-bold">\u{1F3AF} Icon Assistant</span>
|
|
965
|
+
</kendo-card-header>
|
|
966
|
+
<kendo-card-body>
|
|
967
|
+
<p class="k-mb-3 k-font-size-lg">Find the right icon for any action or concept and get it wired up with the correct Angular syntax.</p>
|
|
968
|
+
<p class="k-font-size-lg"><strong>Features:</strong> Suggests the best icons based on your scenario</p>
|
|
969
|
+
</kendo-card-body>
|
|
970
|
+
</kendo-card>
|
|
971
|
+
|
|
972
|
+
<kendo-card width="auto">
|
|
973
|
+
<kendo-card-header class="k-py-2">
|
|
974
|
+
<span kendoCardTitle class="card-title k-font-weight-bold">\u267F Accessibility Assistant</span>
|
|
975
|
+
</kendo-card-header>
|
|
976
|
+
<kendo-card-body>
|
|
977
|
+
<p class="k-mb-3 k-font-size-lg">Ensure your components meet modern accessibility standards and best practices for inclusive design.</p>
|
|
978
|
+
<p class="k-font-size-lg"><strong>Checks:</strong> ARIA attributes, keyboard navigation, color contrast, screen reader support</p>
|
|
979
|
+
</kendo-card-body>
|
|
980
|
+
</kendo-card>
|
|
981
|
+
|
|
982
|
+
<kendo-card width="auto">
|
|
983
|
+
<kendo-card-header class="k-py-2">
|
|
984
|
+
<span kendoCardTitle class="card-title k-font-weight-bold">\u{1F3A8} Style Assistant</span>
|
|
985
|
+
</kendo-card-header>
|
|
986
|
+
<kendo-card-body>
|
|
987
|
+
<p class="k-mb-3 k-font-size-lg">Apply a custom color scheme or brand identity consistently across all components in one step.</p>
|
|
988
|
+
<p class="k-font-size-lg"><strong>Customization:</strong> Color schemes, branding, appearance</p>
|
|
989
|
+
</kendo-card-body>
|
|
990
|
+
</kendo-card>
|
|
991
|
+
</div>
|
|
992
|
+
</div>
|
|
993
|
+
\`\`\`
|
|
994
|
+
|
|
995
|
+
3. Replace the content of \`src/app/app.css\` with the following styles:
|
|
996
|
+
|
|
997
|
+
\`\`\`css
|
|
998
|
+
.prompt-box {
|
|
999
|
+
position: relative;
|
|
1000
|
+
border-radius: var(--kendo-border-radius-lg, 0.375rem);
|
|
1001
|
+
border: 2px solid transparent;
|
|
1002
|
+
background: linear-gradient(#fff, #fff) padding-box,
|
|
1003
|
+
linear-gradient(105deg, #c158e4 11.99%, #0bf 49.33%, #001dff 88.12%) border-box;
|
|
1004
|
+
box-shadow: var(--kendo-elevation-4);
|
|
1005
|
+
}
|
|
1006
|
+
|
|
1007
|
+
.card-title {
|
|
1008
|
+
font-size: 1.2rem;
|
|
1009
|
+
letter-spacing: 0.01em;
|
|
1010
|
+
}
|
|
1011
|
+
\`\`\`
|
|
1012
|
+
|
|
1013
|
+
## Step ${n++}: Run Your Application
|
|
1014
|
+
|
|
1015
|
+
**Verification:** Automatically run the application. Do not just inform the user\u2014execute the following command and keep the application running:
|
|
1016
|
+
|
|
1017
|
+
\`\`\`bash
|
|
1018
|
+
cd ${e}
|
|
1019
|
+
ng serve
|
|
1020
|
+
\`\`\`
|
|
1021
|
+
|
|
1022
|
+
`}var Fe=u.ToolNames.layoutAssistant(N),Q=u.ToolNames.codeAssistant(N),Ke=u.ToolNames.styleAssistant(N),J=u.ToolNames.iconAssistant(N),je=u.ToolNames.gettingStartedAssistant(N),Ve=u.ToolNames.accessibilityAssistant(N);function ze(e,t){return[u.Tools.createOrchestrator({name:u.ToolNames.orchestrator(N),title:"Kendo UI Generator",description:u.ToolDescriptions.orchestrator(c),layoutAssistantName:Fe,codeAssistantName:Q,styleAssistantName:Ke,iconAssistantName:J,accessibilityAssistantName:Ve,suiteName:c,libKey:w,components:$,requiredAccess:["agent"]},{validationSteps:u.Validation.Angular.steps,injectedPlan:u.Validation.Angular.additionalPlan},e),u.Tools.createAssistantOrchestrator({name:"kendo_angular_assistant",title:"Kendo UI Assistant",description:u.ToolDescriptions.assistantOrchestrator(c),codeAssistantName:Q,iconAssistantName:J,suiteName:c,libKey:w,components:$,requiredAccess:["assistant"]},e),u.Tools.createLayoutAssistant({name:Fe,title:"Kendo UI Layout Assistant",description:u.ToolDescriptions.layoutAssistant,suiteName:c,libKey:w,getPreContent:Ue,requiredAccess:["agent"]},e),u.Tools.createStyleAssistant({name:Ke,title:"Kendo UI Style Assistant",description:u.ToolDescriptions.styleAssistant,libKey:w,getPreContent:De,requiredAccess:["agent"]},e),u.Tools.createIconSearch({name:J,title:"Kendo UI Icon Assistant",description:u.ToolDescriptions.iconAssistant,libKey:w,getPostContent:Me,requiredAccess:["assistant","agent"]},e),u.Tools.createCodeAssistant({name:Q,title:"Kendo UI Component Assistant",description:u.ToolDescriptions.codeAssistant(c),libKey:w,suiteName:c,components:$,getPostContent:({component:o})=>qe({component:o}),requiredAccess:["assistant","agent"]},e),new v(je,{title:"Kendo UI Getting Started",description:`Creates a new Angular project with Angular CLI and provides essential getting started guidance for ${c} including installation, configuration, and setup instructions.`,requiredAccess:["agent"],inputSchema:pe(c,"kendo-angular-app")},async({projectName:o,createNewProject:n,theme:r},{_meta:a})=>{try{await e.recordOrchestratorUserRequest({meta:{tool:je,projectName:o,createNewProject:n,theme:r,_meta:a}})}catch(d){console.error("Error recording orchestrator request:",d)}return{content:[{type:"text",text:Be(o,n,r)}]}}),u.Tools.createAccessibilityAssistant({name:Ve,title:"Kendo UI Accessibility Assistant",description:u.ToolDescriptions.accessibilityAssistant(c),libKey:w,suiteName:c,components:$,requiredAccess:["agent"]},e)].filter(o=>o.hasAccess(t))}var Tt=vt(import.meta.url),wt=Ye.dirname(Tt),It=Ye.resolve(wt,"../package.json"),He=JSON.parse(Ct.readFileSync(It,"utf-8")),We=new kt({name:"kendo-mcp",title:"Kendo MCP Server",version:He.version});async function Nt(){let e=new St;h("Starting server...");let t=await le(async()=>{let o=(await me())?.entitlement;return o?.Product?.Code||o?.product?.code});t!=="none"&&(_.toolNameHeader=t==="agent"||t==="full"?"agent":"assistant",ze(_,t).forEach(o=>o.register(We)),de({serverName:"angular",contextApi:_,additionalFields:{version:He.version,access_type:t}})),await We.connect(e)}Nt();
|
package/package.json
CHANGED
package/proto/service.proto
CHANGED
|
@@ -57,6 +57,10 @@ message ThemeGenerateResponse {
|
|
|
57
57
|
string variables_json = 1; // JSON string of nested theme variables
|
|
58
58
|
}
|
|
59
59
|
|
|
60
|
+
message LogEventRequest {
|
|
61
|
+
string event_name = 1;
|
|
62
|
+
map<string, string> fields = 2;
|
|
63
|
+
}
|
|
60
64
|
|
|
61
65
|
message ProductInfo {
|
|
62
66
|
int32 id = 1;
|
|
@@ -118,4 +122,5 @@ service ContextQueryService {
|
|
|
118
122
|
rpc GenerateTheme(ThemeGenerateRequest) returns (ThemeGenerateResponse);
|
|
119
123
|
rpc ValidateUserLicense(google.protobuf.Empty) returns (ValidateUserLicenseResponse);
|
|
120
124
|
rpc RecordOrchestratorUserRequest(google.protobuf.Empty) returns (google.protobuf.Empty);
|
|
125
|
+
rpc LogEvent(LogEventRequest) returns (google.protobuf.Empty);
|
|
121
126
|
}
|