@progress/kendo-react-webmcp 15.0.0-develop.2

package/schemas/gantt.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./common.js");function r(){return{type:"object",properties:{view:{type:"string",description:"The Gantt view to switch to",enum:["Day","Week","Month","Year"]}},required:["view"]}}function i(){return{type:"object",properties:{title:{type:"string",description:"The title of the new task"},start:{type:"string",format:"date-time",description:"The start date of the task (ISO 8601 format)"},end:{type:"string",format:"date-time",description:"The end date of the task (ISO 8601 format)"}},required:["title"]}}function a(e){return t.getFilterSchema(e)}exports.getChangeViewSchema=r;exports.getCreateTaskSchema=i;exports.getDeleteTaskSchema=a;

package/schemas/gantt.mjs

@@ -0,0 +1,51 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { getFilterSchema as t } from "./common.mjs";
+function i() {
+  return {
+    type: "object",
+    properties: {
+      view: {
+        type: "string",
+        description: "The Gantt view to switch to",
+        enum: ["Day", "Week", "Month", "Year"]
+      }
+    },
+    required: ["view"]
+  };
+}
+function a() {
+  return {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description: "The title of the new task"
+      },
+      start: {
+        type: "string",
+        format: "date-time",
+        description: "The start date of the task (ISO 8601 format)"
+      },
+      end: {
+        type: "string",
+        format: "date-time",
+        description: "The end date of the task (ISO 8601 format)"
+      }
+    },
+    required: ["title"]
+  };
+}
+function n(e) {
+  return t(e);
+}
+export {
+  i as getChangeViewSchema,
+  a as getCreateTaskSchema,
+  n as getDeleteTaskSchema
+};

package/schemas/grid.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+export declare function getGroupSchema(columnFields: string[]): object;
+export declare function getAggregateSchema(columnFields: string[]): object;
+export declare function getGroupExpandSchema(columnFields: string[]): object;

package/schemas/grid.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function t(e){return{type:"object",properties:{field:{type:"string",enum:e,description:"Column field name to group by"},dir:{type:"string",enum:["asc","desc"],description:"Sort direction within the group"}},required:["field"]}}function r(e){return{type:"object",properties:{field:{type:"string",enum:e,description:"Column field name to aggregate"},aggregate:{type:"string",enum:["sum","average","count","min","max"],description:"Aggregate function to apply"}},required:["field","aggregate"]}}function i(e){return{type:"object",properties:{field:{type:"string",enum:e,description:"The grouped field name"},value:{type:"string",description:"The group value to expand or collapse"}},required:["field","value"]}}exports.getAggregateSchema=r;exports.getGroupExpandSchema=i;exports.getGroupSchema=t;

package/schemas/grid.mjs

@@ -0,0 +1,46 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+function t(e) {
+  return {
+    type: "object",
+    properties: {
+      field: { type: "string", enum: e, description: "Column field name to group by" },
+      dir: { type: "string", enum: ["asc", "desc"], description: "Sort direction within the group" }
+    },
+    required: ["field"]
+  };
+}
+function r(e) {
+  return {
+    type: "object",
+    properties: {
+      field: { type: "string", enum: e, description: "Column field name to aggregate" },
+      aggregate: {
+        type: "string",
+        enum: ["sum", "average", "count", "min", "max"],
+        description: "Aggregate function to apply"
+      }
+    },
+    required: ["field", "aggregate"]
+  };
+}
+function i(e) {
+  return {
+    type: "object",
+    properties: {
+      field: { type: "string", enum: e, description: "The grouped field name" },
+      value: { type: "string", description: "The group value to expand or collapse" }
+    },
+    required: ["field", "value"]
+  };
+}
+export {
+  r as getAggregateSchema,
+  i as getGroupExpandSchema,
+  t as getGroupSchema
+};

package/schemas/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+export { FILTER_OPERATORS, getEmptySchema, getFilterSchema, getSortSchema, getPageSchema, getPageSizeSchema, getExportSchema, buildFilterPayload, buildSortPayload, getExpandCollapseSchema, buildExpandCollapsePayload } from './common.js';
+export { getStringValueSchema, getNumberValueSchema, getBooleanValueSchema, getDateValueSchema, getTimeValueSchema, getDateTimeValueSchema, getDateRangeValueSchema, getNumericRangeValueSchema, getColorValueSchema, getDropDownValueSchema, getMultiSelectAddValueSchema, getMultiSelectRemoveValueSchema } from './input.js';
+export { getGroupSchema, getAggregateSchema, getGroupExpandSchema } from './grid.js';
+export { getColumnIdSchema, getColumnReorderSchema, getColumnResizeSchema, getRowMatchSchema, buildRowMatchPayload } from './table.js';
+export { getCreateSchema as getSchedulerCreateSchema, getDeleteSchema as getSchedulerDeleteSchema, getNavigateSchema as getSchedulerNavigateSchema, getViewSchema as getSchedulerViewSchema } from './scheduler.js';
+export { getChangeViewSchema as getGanttChangeViewSchema, getCreateTaskSchema as getGanttCreateTaskSchema, getDeleteTaskSchema as getGanttDeleteTaskSchema } from './gantt.js';

package/schemas/input.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+export declare function getStringValueSchema(): object;
+export declare function getNumberValueSchema(): object;
+export declare function getBooleanValueSchema(): object;
+export declare function getDateValueSchema(): object;
+export declare function getTimeValueSchema(): object;
+export declare function getDateTimeValueSchema(): object;
+export declare function getDateRangeValueSchema(): object;
+export declare function getNumericRangeValueSchema(): object;
+export declare function getColorValueSchema(): object;
+export declare function getDropDownValueSchema(): object;
+export declare function getMultiSelectAddValueSchema(): object;
+export declare function getMultiSelectRemoveValueSchema(): object;

package/schemas/input.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function e(){return{type:"object",properties:{value:{type:"string",description:"The text value to set."}},required:["value"]}}function t(){return{type:"object",properties:{value:{type:"number",description:"The numeric value to set."}},required:["value"]}}function r(){return{type:"object",properties:{value:{type:"boolean",description:"The boolean value to set (true or false)."}},required:["value"]}}function a(){return{type:"object",properties:{value:{type:"string",description:'The date value in ISO 8601 format (e.g. "2026-04-23").'}},required:["value"]}}function u(){return{type:"object",properties:{value:{type:"string",description:'The time value in ISO 8601 format (e.g. "14:30:00").'}},required:["value"]}}function i(){return{type:"object",properties:{value:{type:"string",description:'The date and time value in ISO 8601 format (e.g. "2026-04-23T14:30:00").'}},required:["value"]}}function o(){return{type:"object",properties:{startValue:{type:"string",description:'The start date in ISO 8601 format (e.g. "2026-04-01").'},endValue:{type:"string",description:'The end date in ISO 8601 format (e.g. "2026-04-30").'}},required:["startValue","endValue"]}}function n(){return{type:"object",properties:{startValue:{type:"number",description:"The start value of the range."},endValue:{type:"number",description:"The end value of the range."}},required:["startValue","endValue"]}}function l(){return{type:"object",properties:{value:{type:"string",description:'The color value as a hex string (e.g. "#ff6358") or named CSS color.'}},required:["value"]}}function c(){return{type:"object",properties:{value:{type:"string",description:"The value to select from the available options."}},required:["value"]}}function p(){return{type:"object",properties:{value:{type:"string",description:"The value to add to the selection."}},required:["value"]}}function s(){return{type:"object",properties:{value:{type:"string",description:"The value to remove from the selection."}},required:["value"]}}exports.getBooleanValueSchema=r;exports.getColorValueSchema=l;exports.getDateRangeValueSchema=o;exports.getDateTimeValueSchema=i;exports.getDateValueSchema=a;exports.getDropDownValueSchema=c;exports.getMultiSelectAddValueSchema=p;exports.getMultiSelectRemoveValueSchema=s;exports.getNumberValueSchema=t;exports.getNumericRangeValueSchema=n;exports.getStringValueSchema=e;exports.getTimeValueSchema=u;

package/schemas/input.mjs

@@ -0,0 +1,137 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+function e() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "string", description: "The text value to set." }
+    },
+    required: ["value"]
+  };
+}
+function t() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "number", description: "The numeric value to set." }
+    },
+    required: ["value"]
+  };
+}
+function r() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "boolean", description: "The boolean value to set (true or false)." }
+    },
+    required: ["value"]
+  };
+}
+function a() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "string", description: 'The date value in ISO 8601 format (e.g. "2026-04-23").' }
+    },
+    required: ["value"]
+  };
+}
+function u() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "string", description: 'The time value in ISO 8601 format (e.g. "14:30:00").' }
+    },
+    required: ["value"]
+  };
+}
+function i() {
+  return {
+    type: "object",
+    properties: {
+      value: {
+        type: "string",
+        description: 'The date and time value in ISO 8601 format (e.g. "2026-04-23T14:30:00").'
+      }
+    },
+    required: ["value"]
+  };
+}
+function n() {
+  return {
+    type: "object",
+    properties: {
+      startValue: { type: "string", description: 'The start date in ISO 8601 format (e.g. "2026-04-01").' },
+      endValue: { type: "string", description: 'The end date in ISO 8601 format (e.g. "2026-04-30").' }
+    },
+    required: ["startValue", "endValue"]
+  };
+}
+function o() {
+  return {
+    type: "object",
+    properties: {
+      startValue: { type: "number", description: "The start value of the range." },
+      endValue: { type: "number", description: "The end value of the range." }
+    },
+    required: ["startValue", "endValue"]
+  };
+}
+function l() {
+  return {
+    type: "object",
+    properties: {
+      value: {
+        type: "string",
+        description: 'The color value as a hex string (e.g. "#ff6358") or named CSS color.'
+      }
+    },
+    required: ["value"]
+  };
+}
+function p() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "string", description: "The value to select from the available options." }
+    },
+    required: ["value"]
+  };
+}
+function c() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "string", description: "The value to add to the selection." }
+    },
+    required: ["value"]
+  };
+}
+function s() {
+  return {
+    type: "object",
+    properties: {
+      value: { type: "string", description: "The value to remove from the selection." }
+    },
+    required: ["value"]
+  };
+}
+export {
+  r as getBooleanValueSchema,
+  l as getColorValueSchema,
+  n as getDateRangeValueSchema,
+  i as getDateTimeValueSchema,
+  a as getDateValueSchema,
+  p as getDropDownValueSchema,
+  c as getMultiSelectAddValueSchema,
+  s as getMultiSelectRemoveValueSchema,
+  t as getNumberValueSchema,
+  o as getNumericRangeValueSchema,
+  e as getStringValueSchema,
+  u as getTimeValueSchema
+};

package/schemas/scheduler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+export declare function getCreateSchema(): object;
+export declare function getDeleteSchema(): object;
+export declare function getNavigateSchema(): object;
+export declare function getViewSchema(): object;

package/schemas/scheduler.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=["Day","MultiDay","Week","Month","Timeline","Agenda"];function t(){return{type:"object",properties:{title:{type:"string",description:"Title of the new event"},start:{type:"string",description:'Start date and time in ISO 8601 format (e.g. "2026-04-08T09:00:00")'},end:{type:"string",description:'End date and time in ISO 8601 format (e.g. "2026-04-08T10:00:00")'},isAllDay:{type:"boolean",description:"Whether the event spans the entire day"},description:{type:"string",description:"Optional description of the event"}},required:["title","start","end"]}}function i(){return{type:"object",properties:{title:{type:"string",description:"Title of the event to delete"},start:{type:"string",description:"Start date/time of the event to identify it (ISO 8601)"}},required:["title"]}}function r(){return{type:"object",properties:{date:{type:"string",description:'Date to navigate to in ISO 8601 format (e.g. "2026-04-15")'}},required:["date"]}}function n(){return{type:"object",properties:{view:{type:"string",enum:e,description:"The scheduler view to switch to"}},required:["view"]}}exports.getCreateSchema=t;exports.getDeleteSchema=i;exports.getNavigateSchema=r;exports.getViewSchema=n;

package/schemas/scheduler.mjs

@@ -0,0 +1,58 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+const e = ["Day", "MultiDay", "Week", "Month", "Timeline", "Agenda"];
+function t() {
+  return {
+    type: "object",
+    properties: {
+      title: { type: "string", description: "Title of the new event" },
+      start: {
+        type: "string",
+        description: 'Start date and time in ISO 8601 format (e.g. "2026-04-08T09:00:00")'
+      },
+      end: { type: "string", description: 'End date and time in ISO 8601 format (e.g. "2026-04-08T10:00:00")' },
+      isAllDay: { type: "boolean", description: "Whether the event spans the entire day" },
+      description: { type: "string", description: "Optional description of the event" }
+    },
+    required: ["title", "start", "end"]
+  };
+}
+function i() {
+  return {
+    type: "object",
+    properties: {
+      title: { type: "string", description: "Title of the event to delete" },
+      start: { type: "string", description: "Start date/time of the event to identify it (ISO 8601)" }
+    },
+    required: ["title"]
+  };
+}
+function n() {
+  return {
+    type: "object",
+    properties: {
+      date: { type: "string", description: 'Date to navigate to in ISO 8601 format (e.g. "2026-04-15")' }
+    },
+    required: ["date"]
+  };
+}
+function r() {
+  return {
+    type: "object",
+    properties: {
+      view: { type: "string", enum: e, description: "The scheduler view to switch to" }
+    },
+    required: ["view"]
+  };
+}
+export {
+  t as getCreateSchema,
+  i as getDeleteSchema,
+  n as getNavigateSchema,
+  r as getViewSchema
+};

package/schemas/table.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+export declare function getColumnIdSchema(columnIds: string[]): object;
+export declare function getColumnReorderSchema(columnIds: string[]): object;
+export declare function getColumnResizeSchema(columnIds: string[]): object;
+export declare function getRowMatchSchema(columnFields: string[]): object;
+export declare function buildRowMatchPayload(args: Record<string, unknown>): object | null;

package/schemas/table.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./common.js");function n(e){return{type:"object",properties:{id:{type:"string",description:"Column identifier",...e.length>0?{enum:e}:{}}},required:["id"]}}function l(e){return{type:"object",properties:{id:{type:"string",description:"Column identifier to move",...e.length>0?{enum:e}:{}},position:{type:"number",description:"Target position index (0-based)"}},required:["id","position"]}}function d(e){return{type:"object",properties:{id:{type:"string",description:"Column identifier to resize",...e.length>0?{enum:e}:{}},size:{type:"string",description:'New column width (e.g. "200px")'}},required:["id","size"]}}function p(e){return{type:"object",properties:{field:{type:"string",enum:e,description:"Column field name to match"},operator:{type:"string",enum:o.FILTER_OPERATORS,description:"Filter operator"},value:{description:"Filter value (string, number, or boolean depending on column type)"},cells:{type:"array",items:{type:"string",enum:e},description:"Optional list of column fields to target. When provided, only the specified cells in matching rows are affected instead of entire rows."}},required:["field","operator","value"]}}function u(e){if(!e.field||!e.operator)return null;const t={logic:"and",filters:[{field:e.field,operator:e.operator,value:e.value}]};return e.cells&&(t.cells=e.cells.reduce((i,r)=>(i[r]=!0,i),{})),t}exports.buildRowMatchPayload=u;exports.getColumnIdSchema=n;exports.getColumnReorderSchema=l;exports.getColumnResizeSchema=d;exports.getRowMatchSchema=p;

package/schemas/table.mjs

@@ -0,0 +1,87 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { FILTER_OPERATORS as n } from "./common.mjs";
+function p(e) {
+  return {
+    type: "object",
+    properties: {
+      id: {
+        type: "string",
+        description: "Column identifier",
+        ...e.length > 0 ? { enum: e } : {}
+      }
+    },
+    required: ["id"]
+  };
+}
+function l(e) {
+  return {
+    type: "object",
+    properties: {
+      id: {
+        type: "string",
+        description: "Column identifier to move",
+        ...e.length > 0 ? { enum: e } : {}
+      },
+      position: { type: "number", description: "Target position index (0-based)" }
+    },
+    required: ["id", "position"]
+  };
+}
+function d(e) {
+  return {
+    type: "object",
+    properties: {
+      id: {
+        type: "string",
+        description: "Column identifier to resize",
+        ...e.length > 0 ? { enum: e } : {}
+      },
+      size: { type: "string", description: 'New column width (e.g. "200px")' }
+    },
+    required: ["id", "size"]
+  };
+}
+function u(e) {
+  return {
+    type: "object",
+    properties: {
+      field: { type: "string", enum: e, description: "Column field name to match" },
+      operator: { type: "string", enum: n, description: "Filter operator" },
+      value: { description: "Filter value (string, number, or boolean depending on column type)" },
+      cells: {
+        type: "array",
+        items: { type: "string", enum: e },
+        description: "Optional list of column fields to target. When provided, only the specified cells in matching rows are affected instead of entire rows."
+      }
+    },
+    required: ["field", "operator", "value"]
+  };
+}
+function c(e) {
+  if (!e.field || !e.operator)
+    return null;
+  const t = {
+    logic: "and",
+    filters: [
+      {
+        field: e.field,
+        operator: e.operator,
+        value: e.value
+      }
+    ]
+  };
+  return e.cells && (t.cells = e.cells.reduce((i, r) => (i[r] = !0, i), {})), t;
+}
+export {
+  c as buildRowMatchPayload,
+  p as getColumnIdSchema,
+  l as getColumnReorderSchema,
+  d as getColumnResizeSchema,
+  u as getRowMatchSchema
+};

package/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { WebMcpToolRegistration, WebMcpModelContext } from '@progress/kendo-react-common';
+/** Configuration passed from the provider to every adapter. */
+export interface WebMcpConfig {
+    /** Human-readable data name exposed to AI agents. */
+    dataName: string;
+    /** Tool name prefix — `${dataName}_${componentSuffix}` by default. */
+    groupName: string;
+}
+/**
+ * A tool adapter creates a set of Web MCP tool registrations for a
+ * specific KendoReact component type.
+ *
+ * The provider calls `createTools` once the child component is mounted
+ * and its ref (imperative handle) is available.
+ */
+export interface ToolAdapter<THandle = unknown, TProps = unknown> {
+    /** Component-type suffix used to build the default tool name prefix (e.g. 'textbox', 'grid'). */
+    componentSuffix: string;
+    /**
+     * Create MCP tool registrations for a component instance.
+     *
+     * @param handle   - The component's imperative handle (snapshot from registration time).
+     * @param propsRef - A ref to the component's current props. Read `.current` inside tool
+     *                   execute callbacks for live values.
+     * @param config   - Resolved MCP configuration (dataName, groupName).
+     * @param mc       - The browser's `navigator.modelContext` surface.
+     * @returns An array of tool registrations (each has `.unregister()`).
+     */
+    createTools(handle: THandle | null, propsRef: {
+        current: TProps;
+    }, config: WebMcpConfig, mc: WebMcpModelContext): WebMcpToolRegistration[];
+}