@progress/kendo-react-common 14.5.0-develop.8 → 15.0.0-develop.1

package/README.md

@@ -1,4 +1,4 @@
-[![KendoReact NPM Banner](https://raw.githubusercontent.com/telerik/kendo-react/master/images/kendoreact-github-banner.png)](https://www.telerik.com/kendo-react-ui/components/free?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common&utm_content=banner)
+[![KendoReact NPM Banner](https://raw.githubusercontent.com/telerik/kendo-react/master/images/kendoreact-github-banner.png)](https://www.telerik.com/kendo-react-ui/components/getting-started/free-vs-premium?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common&utm_content=banner)
 
 # KendoReact Common Library for React
 
@@ -6,7 +6,7 @@
 >
 > -   This package is а part of [KendoReact](https://www.telerik.com/kendo-react-ui?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)—an enterprise-grade UI library with 120+ free and premium components.
 > -   It contains both free and premium KendoReact components and tools. To use the premium components, you must install a license key file, whether you are on a paid license or a 30-day free trial. To receive a license key, either [purchase a license](https://www.telerik.com/kendo-react-ui/pricing) or start a [free trial](https://www.telerik.com/download-login-v2-kendo-react-ui). You can use the free components without having to sign up or get a license key.
-> -   If you're looking for free React components, check out [Get Started with KendoReact Free](https://www.telerik.com/kendo-react-ui/components/free).
+> -   If you're looking for free React components, check out [Get Started with KendoReact Free](https://www.telerik.com/kendo-react-ui/components/getting-started).
 > -   If you have an active license, visit the [KendoReact My License page](https://www.telerik.com/kendo-react-ui/components/my-license/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) to learn how to configure your KendoReact licensing.
 > -   Installing and working with this package indicates that you [accept the KendoReact License Agreement](https://www.telerik.com/purchase/license-agreement/progress-kendoreact?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common).
 > -   The 30-day free trial gives you access to all KendoReact components and their full functionality. Additionally, for the period of your trial, you can use our legendary technical support provided directly by the KendoReact dev team!
@@ -121,7 +121,7 @@ import { AdaptiveModeContext } from '@progress/kendo-react-common';
 
 The following table outlines the key resources available with KendoReact and KendoReact Free.
 
-|                                  | [KendoReact Free](https://www.telerik.com/kendo-react-ui/components/free)                                                                                                                                | [KendoReact](https://www.telerik.com/kendo-react-ui)                                                                                                                                                     |
+|                                  | [KendoReact Free](https://www.telerik.com/kendo-react-ui/components/getting-started/free-vs-premium)                                                                                                     | [KendoReact](https://www.telerik.com/kendo-react-ui)                                                                                                                                                     |
 | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | React components                 | 50+                                                                                                                                                                                                      | 120+                                                                                                                                                                                                     |
 | Four professional themes         | <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M20.285 2l-11.285 11.567-5.286-5.011-3.714 3.716 9 8.728 15-15.285z" stroke="white" stroke-width="2"/></svg> | <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M20.285 2l-11.285 11.567-5.286-5.011-3.714 3.716 9 8.728 15-15.285z" stroke="white" stroke-width="2"/></svg> |
@@ -146,7 +146,7 @@ For any issues you might encounter while working with the KendoReact Common pack
 General resources:
 
 -   [Getting Started with KendoReact](https://www.telerik.com/kendo-react-ui/components/getting-started/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
--   [Get Started with KendoReact Free](https://www.telerik.com/kendo-react-ui/components/free)
+-   [Get Started with KendoReact Free](https://www.telerik.com/kendo-react-ui/components/getting-started)
 -   [KendoReact Roadmap](https://www.telerik.com/kendo-react-ui/roadmap/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
 -   [Blogs](https://www.telerik.com/blogs/tag/kendoreact?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
 -   [Demos, documentation, and component reference](https://www.telerik.com/kendo-react-ui/components/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)

package/WebMcpProvider.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * WebMcpProvider – Generic React Context Provider for Web MCP configuration.
+ *
+ * Wraps a section of the component tree so that any KendoReact component
+ * (Grid, Form, Scheduler, etc.) inside it automatically registers
+ * browser-native AI agent tools via `navigator.modelContext.registerTool()` (Chrome 146+).
+ *
+ * Lives in `@progress/kendo-react-common` so every component package can
+ * consume the context without cross-package imports.
+ *
+ * @example
+ * ```tsx
+ * import { WebMcpProvider } from '@progress/kendo-react-common';
+ *
+ * <WebMcpProvider>
+ *     <Grid data={dataResult} sortable webMcp={{ dataName: 'employees' }} />
+ * </WebMcpProvider>
+ * ```
+ */
+import * as React from 'react';
+/** @internal Result returned by a registered Web MCP tool. */
+export interface WebMcpToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** @internal Handle returned by `navigator.modelContext.registerTool()`. */
+export interface WebMcpToolRegistration {
+    unregister: () => void;
+}
+/** @internal The `navigator.modelContext` surface in Chrome 146+. */
+export interface WebMcpModelContext {
+    registerTool: (config: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        execute: (args: Record<string, unknown>) => Promise<WebMcpToolResult>;
+    }) => WebMcpToolRegistration;
+}
+/** Describes a single tool to register via WebMcpProvider. */
+export interface McpToolOption {
+    /** Short identifier used as suffix in the tool name. */
+    name: string;
+    /** Human-readable description shown to AI agents. */
+    description: string;
+    /** Internal command identifier used by the component's execution router. */
+    commandType: string;
+    /** Whether this tool should be registered (typically derived from component props). */
+    enabled: boolean;
+}
+/** Configuration object for the `webMcp` prop on individual components. */
+export interface WebMcpProps {
+    /** Human-readable data name exposed to AI agents. Overrides the provider's `dataName`. */
+    dataName?: string;
+    /** Optional callback to filter or customise the tools before registration. */
+    tools?: (tools: McpToolOption[]) => McpToolOption[];
+}
+/** Shared Web MCP configuration propagated via React Context. */
+export interface WebMcpContextValue {
+    /** Human-readable data name exposed to AI agents. Any language works. Optional when each component provides its own via `webMcp={{ dataName }}`. */
+    dataName?: string;
+    /**
+     * Registration callback provided by a smart provider.
+     * Components call this to announce themselves so the provider can
+     * create tools on their behalf. Returns an unregister function.
+     *
+     * @param componentType - Identifier string, e.g. 'textbox', 'grid'.
+     * @param handle        - The imperative handle exposed via forwardRef.
+     * @param props         - The current React props of the component.
+     * @param webMcpConfig  - Component-level webMcp config (when object), or undefined (when boolean).
+     * @returns A cleanup function that removes the registration.
+     */
+    register?: (componentType: string, handle: unknown, propsRef: {
+        current: unknown;
+    }, webMcpConfig?: Record<string, unknown>) => () => void;
+}
+/** Props accepted by `<WebMcpProvider>`. */
+export interface WebMcpProviderProps extends WebMcpContextValue {
+    children: React.ReactNode;
+}
+/** @internal */
+export declare const WebMcpContext: React.Context<WebMcpContextValue | null>;
+/** Provides Web MCP configuration to all descendant KendoReact components. */
+export declare const WebMcpProvider: React.FC<WebMcpProviderProps>;
+/** Returns the `navigator.modelContext` if available (Chrome 146+), or `null`. */
+export declare function getModelContext(): WebMcpModelContext | null;
+/**
+ * Tiny hook that components call to register themselves with a parent
+ * `WebMcpProvider`. Only runs when `webMcp` is truthy — zero cost otherwise.
+ *
+ * The component package only needs this single call — all tool creation
+ * logic lives in the provider's adapter (in `@progress/kendo-react-webmcp`).
+ *
+ * @param componentType - Identifier string, e.g. 'textbox', 'grid'.
+ * @param handle        - Ref to the component's imperative handle.
+ * @param props         - The current React props.
+ * @param webMcp        - The component's `webMcp` prop. `true` for defaults, object for config.
+ */
+export declare function useWebMcpRegister(componentType: string, handle: React.RefObject<unknown>, props: unknown, webMcp?: boolean | WebMcpProps | Record<string, unknown>): void;

package/WebMcpProvider.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use client";
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react");function l(e){const n=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const o in e)if(o!=="default"){const t=Object.getOwnPropertyDescriptor(e,o);Object.defineProperty(n,o,t.get?t:{enumerable:!0,get:()=>e[o]})}}return n.default=e,Object.freeze(n)}const r=l(a),i=r.createContext(null);i.displayName="WebMcpContext";const g=({children:e,dataName:n})=>{const o=r.useMemo(()=>({dataName:n}),[n]);return r.createElement(i.Provider,{value:o},e)};function d(){return typeof navigator!="undefined"&&navigator.modelContext?navigator.modelContext:null}function b(e,n,o,t){const c=r.useContext(i),u=r.useRef(o);u.current=o;const s=r.useMemo(()=>typeof t=="object"?JSON.stringify(t):String(!!t),[t]);r.useEffect(()=>{if(!t||!(c!=null&&c.register))return;const f=typeof t=="object"?t:void 0;return c.register(e,n.current,u,f)},[s,c,e,n])}exports.WebMcpContext=i;exports.WebMcpProvider=g;exports.getModelContext=d;exports.useWebMcpRegister=b;

package/WebMcpProvider.mjs

@@ -0,0 +1,41 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use client";
+import * as t from "react";
+const s = t.createContext(null);
+s.displayName = "WebMcpContext";
+const g = ({ children: r, dataName: o }) => {
+  const i = t.useMemo(() => ({ dataName: o }), [o]);
+  return /* @__PURE__ */ t.createElement(s.Provider, { value: i }, r);
+};
+function a() {
+  return typeof navigator != "undefined" && navigator.modelContext ? navigator.modelContext : null;
+}
+function l(r, o, i, e) {
+  const n = t.useContext(s), u = t.useRef(i);
+  u.current = i;
+  const f = t.useMemo(
+    () => typeof e == "object" ? JSON.stringify(e) : String(!!e),
+    // webMcp is intentionally listed as the only dep — we want a stable key
+    // based on the serialised value, not the object reference.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [e]
+  );
+  t.useEffect(() => {
+    if (!e || !(n != null && n.register))
+      return;
+    const c = typeof e == "object" ? e : void 0;
+    return n.register(r, o.current, u, c);
+  }, [f, n, r, o]);
+}
+export {
+  s as WebMcpContext,
+  g as WebMcpProvider,
+  a as getModelContext,
+  l as useWebMcpRegister
+};