@progress/kendo-angular-webmcp 24.0.0-develop.41

package/lib/webmcp.interfaces.d.ts

@@ -0,0 +1,128 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { NgZone } from '@angular/core';
+/**
+ * Type declarations for the Web Model Context Protocol (MCP) browser API.
+ * Available in Chrome 146+ behind the `chrome://flags/#model-context-protocol` flag.
+ */
+/**
+ * @hidden
+ */
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, any>;
+    outputSchema?: Record<string, any>;
+    execute: (args: Record<string, any>) => unknown;
+}
+/**
+ * @hidden
+ */
+export interface ModelContext {
+    registerTool(tool: McpToolDefinition): {
+        unregister: () => void;
+    };
+}
+declare global {
+    interface Navigator {
+        modelContext?: ModelContext;
+    }
+}
+/**
+ * Represents the result returned by a Web MCP tool callback.
+ */
+export interface WebMcpToolResult {
+    /**
+     * Specifies whether the tool execution succeeded.
+     */
+    success: boolean;
+    /**
+     * Specifies a human-readable message describing the result or error.
+     */
+    message?: string;
+    /**
+     * Represents the data payload returned by the tool.
+     */
+    data?: any;
+}
+/**
+ * Represents a single tool option passed to the {@link WebMcpConfig.tools} callback.
+ * The callback receives the full list with default enabled states and returns a modified list —
+ * tools with `enabled: false` will not be registered.
+ */
+export interface WebMcpToolOption {
+    /**
+     * Specifies the tool name suffix (for example, `'sort-column'`, `'filter'`, `'export-pdf'`).
+     * The full registered name is `{prefix}-{name}` where prefix is `dataName` or the component default.
+     */
+    name: string;
+    /**
+     * Specifies the human-readable description passed to the MCP tool registration.
+     */
+    description: string;
+    /**
+     * Specifies whether this tool will be registered. Set to `false` to suppress it.
+     */
+    enabled: boolean;
+}
+/**
+ * Represents the configuration for the Web MCP directive.
+ *
+ * When set to `true`, registers all supported tools with default settings.
+ * When set to a configuration object, you can specify a custom name prefix and
+ * fine-tune individual tools through the `tools` callback.
+ */
+export interface WebMcpConfig {
+    /**
+     * Specifies the semantic name used as the tool name prefix for multi-instance disambiguation.
+     * Replaces the default `kendo-grid` prefix in registered tool names and descriptions.
+     *
+     * Example: `dataName: 'orders'` produces tools named `orders-sort-column`, `orders-filter`, etc.
+     *
+     * @default undefined (uses `kendo-grid` prefix)
+     */
+    dataName?: string;
+    /**
+     * Specifies the per-tool customization callback. Receives the full list of tool options with their
+     * default enabled states and returns a modified list. Tools returned with `enabled: false` will not
+     * be registered.
+     *
+     * Use this to suppress or adjust individual tools.
+     *
+     * @example
+     * // Disable the CSV export tool while keeping PDF and Excel
+     * tools: (tools) => tools.map(t => t.name === 'export-csv' ? { ...t, enabled: false } : t)
+     *
+     * @example
+     * // Keep only sort and page tools
+     * tools: (tools) => tools.map(t => (['sort-column', 'clear-sort', 'go-to-page'].includes(t.name) ? t : { ...t, enabled: false }))
+     */
+    tools?: (tools: WebMcpToolOption[]) => WebMcpToolOption[];
+}
+/**
+ * Resolves a `boolean | WebMcpConfig` input into a full config with defaults.
+ *
+ * @hidden
+ */
+export declare function resolveConfig(value: boolean | WebMcpConfig): WebMcpConfig | null;
+/**
+ * An adapter registers Web MCP tools for a specific Kendo Angular component.
+ *
+ * @hidden
+ */
+export interface ToolAdapter<T> {
+    /**
+     * CSS selector(s) that identify the host element this adapter handles.
+     * Matched against the host element's tag name or attributes.
+     * Examples: `'kendo-grid'`, `'[kendoButton]'`.
+     */
+    selector: string;
+    /**
+     * Registers MCP tools for the component and returns cleanup handles.
+     */
+    registerTools(component: T, config: WebMcpConfig, modelContext: ModelContext, ngZone: NgZone): Array<{
+        unregister: () => void;
+    }>;
+}

package/package-metadata.d.ts

@@ -0,0 +1,9 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { type PackageMetadata } from '@progress/kendo-licensing';
+/**
+ * @hidden
+ */
+export declare const packageMetadata: PackageMetadata;

package/package-metadata.mjs

@@ -0,0 +1,13 @@
+// Generated file. DO NOT EDIT.
+
+export const packageMetadata = {
+  "name": "@progress/kendo-angular-webmcp",
+  "productName": "Kendo UI for Angular",
+  "productCode": "KENDOUIANGULAR",
+  "productCodes": [
+    "KENDOUIANGULAR"
+  ],
+  "publishDate": 1779255940,
+  "version": "24.0.0-develop.41",
+  "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/?utm_medium=product&utm_source=kendoangular&utm_campaign=kendo-ui-angular-purchase-license-keys-warning"
+};

package/package.json

@@ -0,0 +1,168 @@
+{
+  "name": "@progress/kendo-angular-webmcp",
+  "version": "24.0.0-develop.41",
+  "description": "Web MCP Tools for Kendo UI for Angular",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "author": "Progress",
+  "homepage": "https://www.telerik.com/kendo-angular-ui/components/",
+  "bugs": {
+    "url": "https://github.com/telerik/kendo-angular"
+  },
+  "keywords": [
+    "Angular",
+    "Kendo UI",
+    "MCP",
+    "Web MCP",
+    "AI",
+    "Progress"
+  ],
+  "@progress": {
+    "friendlyName": "Web MCP Tools",
+    "package": {
+      "productName": "Kendo UI for Angular",
+      "productCode": "KENDOUIANGULAR",
+      "publishDate": 1779255940,
+      "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/?utm_medium=product&utm_source=kendoangular&utm_campaign=kendo-ui-angular-purchase-license-keys-warning"
+    }
+  },
+  "peerDependencies": {
+    "@angular/common": "19 - 21",
+    "@angular/core": "19 - 21",
+    "@progress/kendo-licensing": "^1.11.0",
+    "@progress/kendo-angular-buttons": "24.0.0-develop.41",
+    "@progress/kendo-angular-charts": "24.0.0-develop.41",
+    "@progress/kendo-angular-common": "24.0.0-develop.41",
+    "@progress/kendo-angular-conversational-ui": "24.0.0-develop.41",
+    "@progress/kendo-angular-dateinputs": "24.0.0-develop.41",
+    "@progress/kendo-angular-dialog": "24.0.0-develop.41",
+    "@progress/kendo-angular-dropdowns": "24.0.0-develop.41",
+    "@progress/kendo-angular-editor": "24.0.0-develop.41",
+    "@progress/kendo-angular-gantt": "24.0.0-develop.41",
+    "@progress/kendo-angular-gauges": "24.0.0-develop.41",
+    "@progress/kendo-angular-grid": "24.0.0-develop.41",
+    "@progress/kendo-angular-indicators": "24.0.0-develop.41",
+    "@progress/kendo-angular-inputs": "24.0.0-develop.41",
+    "@progress/kendo-angular-layout": "24.0.0-develop.41",
+    "@progress/kendo-angular-listbox": "24.0.0-develop.41",
+    "@progress/kendo-angular-listview": "24.0.0-develop.41",
+    "@progress/kendo-angular-map": "24.0.0-develop.41",
+    "@progress/kendo-angular-menu": "24.0.0-develop.41",
+    "@progress/kendo-angular-notification": "24.0.0-develop.41",
+    "@progress/kendo-angular-pager": "24.0.0-develop.41",
+    "@progress/kendo-angular-pivotgrid": "24.0.0-develop.41",
+    "@progress/kendo-angular-scheduler": "24.0.0-develop.41",
+    "@progress/kendo-angular-scrollview": "24.0.0-develop.41",
+    "@progress/kendo-angular-sortable": "24.0.0-develop.41",
+    "@progress/kendo-angular-spreadsheet": "24.0.0-develop.41",
+    "@progress/kendo-angular-toolbar": "24.0.0-develop.41",
+    "@progress/kendo-angular-treelist": "24.0.0-develop.41",
+    "@progress/kendo-angular-treeview": "24.0.0-develop.41",
+    "@progress/kendo-angular-upload": "24.0.0-develop.41",
+    "rxjs": "^6.5.3 || ^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@progress/kendo-angular-buttons": {
+      "optional": true
+    },
+    "@progress/kendo-angular-charts": {
+      "optional": true
+    },
+    "@progress/kendo-angular-conversational-ui": {
+      "optional": true
+    },
+    "@progress/kendo-angular-dateinputs": {
+      "optional": true
+    },
+    "@progress/kendo-angular-dialog": {
+      "optional": true
+    },
+    "@progress/kendo-angular-dropdowns": {
+      "optional": true
+    },
+    "@progress/kendo-angular-editor": {
+      "optional": true
+    },
+    "@progress/kendo-angular-gantt": {
+      "optional": true
+    },
+    "@progress/kendo-angular-gauges": {
+      "optional": true
+    },
+    "@progress/kendo-angular-grid": {
+      "optional": true
+    },
+    "@progress/kendo-angular-indicators": {
+      "optional": true
+    },
+    "@progress/kendo-angular-inputs": {
+      "optional": true
+    },
+    "@progress/kendo-angular-layout": {
+      "optional": true
+    },
+    "@progress/kendo-angular-listbox": {
+      "optional": true
+    },
+    "@progress/kendo-angular-listview": {
+      "optional": true
+    },
+    "@progress/kendo-angular-map": {
+      "optional": true
+    },
+    "@progress/kendo-angular-menu": {
+      "optional": true
+    },
+    "@progress/kendo-angular-notification": {
+      "optional": true
+    },
+    "@progress/kendo-angular-pager": {
+      "optional": true
+    },
+    "@progress/kendo-angular-pivotgrid": {
+      "optional": true
+    },
+    "@progress/kendo-angular-scheduler": {
+      "optional": true
+    },
+    "@progress/kendo-angular-scrollview": {
+      "optional": true
+    },
+    "@progress/kendo-angular-sortable": {
+      "optional": true
+    },
+    "@progress/kendo-angular-spreadsheet": {
+      "optional": true
+    },
+    "@progress/kendo-angular-toolbar": {
+      "optional": true
+    },
+    "@progress/kendo-angular-treelist": {
+      "optional": true
+    },
+    "@progress/kendo-angular-treeview": {
+      "optional": true
+    },
+    "@progress/kendo-angular-upload": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@progress/kendo-file-saver": "^1.1.1",
+    "@progress/kendo-ooxml": "^1.9.0",
+    "@progress/kendo-angular-schematics": "24.0.0-develop.41",
+    "tslib": "^2.3.1"
+  },
+  "schematics": "./schematics/collection.json",
+  "module": "fesm2022/progress-kendo-angular-webmcp.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/progress-kendo-angular-webmcp.mjs"
+    }
+  },
+  "sideEffects": false
+}

package/schematics/collection.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "./node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Adds Kendo Angular Package to the application.",
+      "factory": "./ngAdd",
+      "schema": "./ngAdd/schema.json",
+      "hidden": true,
+      "private": true
+    }
+  }
+}

package/schematics/ngAdd/index.js

@@ -0,0 +1,12 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const schematics_1 = require("@angular-devkit/schematics");
+function default_1(options) {
+    const finalOptions = Object.assign(Object.assign({}, options), { mainNgModule: 'WebMcpModule', package: 'webmcp' });
+    return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
+}

package/schematics/ngAdd/schema.json

@@ -0,0 +1,24 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "$id": "SchematicsKendoAngularWebmcp",
+    "title": "Kendo Angular WebMCP Options Schema",
+    "type": "object",
+    "properties": {
+        "theme": {
+            "enum": ["default", "bootstrap", "material"],
+            "default": "default",
+            "description": "The theme to apply"
+        },
+        "export": {
+            "type": "boolean",
+            "default": false,
+            "description": "Specifies if declaring module exports the component."
+        },
+        "skipInstall": {
+            "description": "Skip installing Kendo dependency packages.",
+            "type": "boolean",
+            "default": false
+        }
+    },
+    "required": []
+}

package/webmcp.module.d.ts

@@ -0,0 +1,31 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import * as i0 from "@angular/core";
+import * as i1 from "./lib/webmcp.directive";
+/**
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
+ * definition for the Web MCP directive.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { WebMcpModule } from '@progress/kendo-angular-webmcp';
+ * import { GridModule } from '@progress/kendo-angular-grid';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, GridModule, WebMcpModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class WebMcpModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<WebMcpModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<WebMcpModule, never, [typeof i1.WebMcpDirective], [typeof i1.WebMcpDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<WebMcpModule>;
+}