@progress/kendo-react-common 13.4.0-develop.3 → 13.4.0-develop.5

package/kendopaste/useKendoPaste.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import * as React from 'react';
+/**
+ * Options for the useKendoPaste hook.
+ */
+export interface UseKendoPasteOptions {
+    /**
+     * The field name to listen for in the smart paste event.
+     * This is typically the component's `name` or `id` prop.
+     * When the event contains a value for this field, the onValueChange callback is called.
+     *
+     * If undefined or empty, the hook will not subscribe to events.
+     */
+    fieldName?: string;
+    /**
+     * Callback fired when a value is received for this field from the smart paste event.
+     *
+     * @param value - The new value from the smart paste event
+     */
+    onValueChange: (value: any) => void;
+    /**
+     * Whether the smart paste subscription is enabled.
+     * When false, the hook will not listen for smart paste events.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * Options for subscribing to smart paste events in class components.
+ */
+export interface KendoPasteSubscriptionOptions {
+    /**
+     * The field name to listen for in the smart paste event.
+     */
+    fieldName?: string;
+    /**
+     * Callback fired when a value is received for this field from the smart paste event.
+     */
+    onValueChange: (value: any) => void;
+}
+/**
+ * Result of subscribing to smart paste events, used to unsubscribe later.
+ */
+export interface KendoPasteSubscription {
+    /**
+     * Unsubscribe from smart paste events.
+     * Call this in componentWillUnmount to clean up the event listener.
+     */
+    unsubscribe: () => void;
+}
+/**
+ * Subscribe to smart paste events for class components.
+ * Call this in componentDidMount and store the result.
+ * Call unsubscribe() in componentWillUnmount.
+ *
+ * @param element - The DOM element to use for finding the event target
+ * @param options - Configuration options for the smart paste subscription
+ * @returns A subscription object with an unsubscribe method
+ *
+ * @example
+ * ```tsx
+ * class MyComponent extends React.Component {
+ *   private KendoPasteSubscription?: KendoPasteSubscription;
+ *
+ *   componentDidMount() {
+ *     this.KendoPasteSubscription = subscribeToKendoPaste(this.element, {
+ *       fieldName: this.props.name,
+ *       onValueChange: (value) => this.handleSmartPasteValue(value)
+ *     });
+ *   }
+ *
+ *   componentWillUnmount() {
+ *     this.KendoPasteSubscription?.unsubscribe();
+ *   }
+ * }
+ * ```
+ */
+export declare function subscribeToKendoPaste(element: Element | null | undefined, options: KendoPasteSubscriptionOptions): KendoPasteSubscription;
+/**
+ * A React hook that subscribes a component to smart paste events.
+ * When a SmartPasteButton dispatches a populate event, this hook will
+ * call the onValueChange callback if the event contains a value for the specified field.
+ *
+ * The field is identified by the `name` or `id` prop of the component.
+ * Works with both KendoReact Form components and native HTML form elements.
+ *
+ * @param elementRef - A ref to the DOM element that will be used to find the event target
+ * @param options - Configuration options for the smart paste subscription
+ *
+ * @example
+ * ```tsx
+ * const inputRef = React.useRef<HTMLInputElement>(null);
+ * const [value, setValue] = React.useState('');
+ *
+ * // Using name prop as field identifier
+ * useKendoPaste(inputRef, {
+ *   fieldName: 'firstName', // matches the name prop
+ *   onValueChange: (newValue) => setValue(newValue)
+ * });
+ *
+ * return <input ref={inputRef} name="firstName" value={value} onChange={(e) => setValue(e.target.value)} />;
+ * ```
+ */
+export declare function useKendoPaste(elementRef: React.RefObject<Element | null>, options: UseKendoPasteOptions): void;

package/kendopaste/useKendoPaste.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 N=require("react"),i=require("./KendoPasteEvent.js");function T(t){const n=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(t){for(const e in t)if(e!=="default"){const o=Object.getOwnPropertyDescriptor(t,e);Object.defineProperty(n,e,o.get?o:{enumerable:!0,get:()=>t[e]})}}return n.default=t,Object.freeze(n)}const d=T(N);function _(t,n){const{fieldName:e,onValueChange:o}=n;if(!t||!e)return{unsubscribe:()=>{}};const s=l(t),c=u=>{const a=u,{fieldValues:r}=a.detail;if(r&&e in r){const f=r[e];o(f)}};return s.addEventListener(i.KENDO_PASTE_EVENT_NAME,c),{unsubscribe:()=>{s.removeEventListener(i.KENDO_PASTE_EVENT_NAME,c)}}}function g(t,n){const{fieldName:e,onValueChange:o,enabled:s=!0}=n,c=d.useRef(o);d.useEffect(()=>{c.current=o},[o]),d.useEffect(()=>{if(!s||!e)return;const u=t.current;if(!u)return;const a=l(u),r=f=>{const b=f,{fieldValues:E}=b.detail;if(E&&e in E){const v=E[e];c.current(v)}};return a.addEventListener(i.KENDO_PASTE_EVENT_NAME,r),()=>{a.removeEventListener(i.KENDO_PASTE_EVENT_NAME,r)}},[t,e,s])}function l(t){const n=t.closest("form");if(n)return n;const e=t.closest(".k-form");return e||document.body}exports.subscribeToKendoPaste=_;exports.useKendoPaste=g;

package/kendopaste/useKendoPaste.mjs

@@ -0,0 +1,60 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import * as l from "react";
+import { KENDO_PASTE_EVENT_NAME as i } from "./KendoPasteEvent.mjs";
+function g(n, t) {
+  const { fieldName: e, onValueChange: r } = t;
+  if (!n || !e)
+    return { unsubscribe: () => {
+    } };
+  const s = E(n), u = (c) => {
+    const a = c, { fieldValues: o } = a.detail;
+    if (o && e in o) {
+      const f = o[e];
+      r(f);
+    }
+  };
+  return s.addEventListener(i, u), {
+    unsubscribe: () => {
+      s.removeEventListener(i, u);
+    }
+  };
+}
+function T(n, t) {
+  const { fieldName: e, onValueChange: r, enabled: s = !0 } = t, u = l.useRef(r);
+  l.useEffect(() => {
+    u.current = r;
+  }, [r]), l.useEffect(() => {
+    if (!s || !e)
+      return;
+    const c = n.current;
+    if (!c)
+      return;
+    const a = E(c), o = (f) => {
+      const v = f, { fieldValues: d } = v.detail;
+      if (d && e in d) {
+        const m = d[e];
+        u.current(m);
+      }
+    };
+    return a.addEventListener(i, o), () => {
+      a.removeEventListener(i, o);
+    };
+  }, [n, e, s]);
+}
+function E(n) {
+  const t = n.closest("form");
+  if (t)
+    return t;
+  const e = n.closest(".k-form");
+  return e || document.body;
+}
+export {
+  g as subscribeToKendoPaste,
+  T as useKendoPaste
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-common",
-  "version": "13.4.0-develop.3",
+  "version": "13.4.0-develop.5",
   "description": "React Common package delivers common utilities that can be used with the KendoReact UI components. KendoReact Common Utilities package",
   "author": "Progress",
   "license": "SEE LICENSE IN LICENSE.md",

package/theme.js

@@ -5,4 +5,4 @@
  * 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={sizeMap:{small:"sm",medium:"md",large:"lg"},roundedMap:{small:"sm",medium:"md",large:"lg",full:"full"},orientationMap:{vertical:"vstack",horizontal:"hstack"}};exports.kendoThemeMaps=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={sizeMap:{small:"sm",medium:"md",large:"lg"},roundedMap:{small:"sm",medium:"md",large:"lg",full:"full",none:"none"},orientationMap:{vertical:"vstack",horizontal:"hstack"}};exports.kendoThemeMaps=e;

package/theme.mjs

@@ -5,7 +5,7 @@
  * Licensed under commercial license. See LICENSE.md in the package root for more information
  *-------------------------------------------------------------------------------------------
  */
-const l = {
+const e = {
   sizeMap: {
     small: "sm",
     medium: "md",
@@ -15,7 +15,8 @@ const l = {
     small: "sm",
     medium: "md",
     large: "lg",
-    full: "full"
+    full: "full",
+    none: "none"
   },
   orientationMap: {
     vertical: "vstack",
@@ -23,5 +24,5 @@ const l = {
   }
 };
 export {
-  l as kendoThemeMaps
+  e as kendoThemeMaps
 };

package/unstyled/json-classes.js

@@ -5,4 +5,4 @@
  * 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={prefix:"k",important:"!",rtl:"rtl",rounded:"rounded",value:"value",state:"state",filter:"filter",virtual:"virtual",infinite:"infinite",clear:"clear",reset:"reset",data:"data",nodata:"nodata",scroller:"scroller"},n={center:"center",hbox:"hbox",vstack:"vstack",hstack:"hstack",overflow:"overflow"},t={actionsheet:"actionsheet",calendar:"calendar",buttongroup:"buttongroup",dateinput:"dateinput",datetime:"datetime",datetimepicker:"datetimepicker",dropdownlist:"dropdownlist",combobox:"combobox",maskedtextbox:"maskedtextbox",menu:"menu",searchbox:"searchbox",timepicker:"timepicker"},l={xsmall:"xs",small:"sm",medium:"md",large:"lg",xlarge:"xl",xxlarge:"xxl",xxxlarge:"xxxl"},s={solid:"solid",outline:"outline",flat:"flat",link:"link",clear:"clear"},c={base:"base",primary:"primary",secondary:"secondary",tertiary:"tertiary",info:"info",success:"success",warning:"warning",error:"error",dark:"dark",light:"light",inherit:"inherit",inverse:"inverse"},d={small:"sm",medium:"md",large:"lg",full:"full"},p={vertical:"vertical",horizontal:"horizontal"},f={height:"height",width:"width"},m={default:"cursor-default"},u={up:"up",down:"down",left:"left",right:"right",start:"start",mid:"mid",end:"end"},r={actions:"actions",container:"container",content:"content",group:"group",row:"row",nav:"nav",wrap:"wrap",wrapper:"wrapper",list:"list",placeholder:"placeholder",popup:"popup",item:"item",part:"part",picker:"picker",separator:"separator",spacer:"spacer",tab:"tab",titlebar:"titlebar",optionLabel:"optionlabel",view:"view"},o={table:"table",text:"text",button:"button",tbody:"tbody",thead:"thead",tr:"tr",th:"th",td:"td",header:"header",footer:"footer",icon:"icon",title:"title",subtitle:"subtitle",link:"link",label:"label",ul:"ul",caption:"caption"},h={increase:"increase",decrease:"decrease",cancel:"cancel",accept:"accept",split:"split"},x={active:"active",adaptive:"adaptive",first:"first",focus:"focus",pending:"pending",last:"last",draggable:"draggable",filterable:"filterable",grouping:"grouping",selected:"selected",highlighted:"highlighted",disabled:"disabled",hidden:"hidden",highlight:"highlight",invalid:"invalid",loading:"loading",required:"required",checked:"checked",empty:"empty",scrollable:"scrollable",sorted:"sorted",sort:"sort",sticky:"sticky",stretched:"stretched",order:"order",alt:"alt",edit:"edit",template:"template",shown:"shown",horizontal:"horizontal",vertical:"vertical",fullscreen:"fullscreen",bottom:"bottom"},b={prefix:"animation",child:"child",relative:"relative",slide:"slide",appear:"appear",active:"active",enter:"enter",exit:"exit",pushRight:"push-right",pushLeft:"push-left",pushDown:"push-down",pushUp:"push-up",expandVertical:"expand-vertical",expandHorizontal:"expand-horizontal",fade:"fade",zoomIn:"zoom-in",zoomOut:"zoom-out",slideIn:"slide-in",slideDown:"slide-down",slideUp:"slide-up",slideRight:"slide-right",slideLeft:"slide-left",revealVertical:"reveal-vertical",revealHorizontal:"reveal-horizontal","animation-container":"animation-container","animation-container-shown":"animation-container-shown","animation-container-relative":"animation-container-relative","animation-container-fixed":"animation-container-fixed","child-animation-container":"child-animation-container"},i={input:"input",inner:"inner",spin:"spin",spinner:"spinner",maskedtextbox:"maskedtextbox",radio:"radio",textbox:"textbox",prefix:"prefix",suffix:"suffix"},g={week:"week",weekdays:"weekdays",weekend:"weekend",month:"month",year:"year",decade:"decade",century:"century",number:"number",navigation:"navigation",marker:"marker",now:"now",range:"range",today:"today",other:"other",date:"date",time:"time",selector:"selector",timeselector:"timeselector"},v={prefix:"icon",svg:"svg",i:"i",color:"color",flipH:"flip-h",flipV:"flip-v"},w={label:"label",text:"text",floatingLabel:"floating-label",container:"container",hint:"form-hint",error:"form-error"},k={form:"form",fieldset:"fieldset",legend:"legend",separator:"separator",field:"field"},y={prefix:"popup"},a={prefix:"grid",ariaRoot:"aria-root",tableWrap:"table-wrap",master:"master",column:"column",cell:"cell",cellInner:"cell-inner",row:"row",group:"group",hierarchy:"hierarchy",detail:"detail",noRecords:"norecords",pager:"pager"},P={drop:"drop",drag:"drag",hint:"hint",vertical:"v",horizontal:"h",clue:"clue",reorder:"reorder"},$=`${e.prefix}-${i.input}`,z=`${e.prefix}-${t.calendar}`,M=`${e.prefix}-${t.maskedtextbox}`,R=`${e.prefix}-${i.radio}`,L=`${e.prefix}-${o.button}`,I=`${e.prefix}-${t.menu}`,D=`${e.prefix}-${r.picker}`,S=`${e.prefix}-${t.dropdownlist}`,U=`${e.prefix}-${t.combobox}`,j=`${e.prefix}-${a.prefix}`,H={base:e,actions:h,animation:b,sizeMap:l,components:t,cssUtils:n,directionMap:u,fillModeMap:s,themeColorMap:c,roundedMap:d,orientationMap:p,elements:o,states:x,dimensions:f,containers:r,cursor:m,inputs:i,dateInputs:g,labels:w,forms:k,popup:y,icon:v,grid:a};exports.actions=h;exports.animationStyles=b;exports.base=e;exports.buttonPrefix=L;exports.calendarPrefix=z;exports.comboBoxPrefix=U;exports.components=t;exports.containers=r;exports.cssUtils=n;exports.cursor=m;exports.dateInputs=g;exports.ddbPrefix=I;exports.dimensions=f;exports.directionMap=u;exports.dropDownListPrefix=S;exports.elements=o;exports.fillModeMap=s;exports.forms=k;exports.grid=a;exports.gridPrefix=j;exports.gridRowReorder=P;exports.icon=v;exports.inputPrefix=$;exports.inputs=i;exports.jsonTheme=H;exports.labels=w;exports.maskedPrefix=M;exports.orientationMap=p;exports.pickerPrefix=D;exports.popup=y;exports.radioPrefix=R;exports.roundedMap=d;exports.sizeMap=l;exports.states=x;exports.themeColorMap=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={prefix:"k",important:"!",rtl:"rtl",rounded:"rounded",value:"value",state:"state",filter:"filter",virtual:"virtual",infinite:"infinite",clear:"clear",reset:"reset",data:"data",nodata:"nodata",scroller:"scroller"},n={center:"center",hbox:"hbox",vstack:"vstack",hstack:"hstack",overflow:"overflow"},t={actionsheet:"actionsheet",calendar:"calendar",buttongroup:"buttongroup",dateinput:"dateinput",datetime:"datetime",datetimepicker:"datetimepicker",dropdownlist:"dropdownlist",combobox:"combobox",maskedtextbox:"maskedtextbox",menu:"menu",searchbox:"searchbox",timepicker:"timepicker"},l={xsmall:"xs",small:"sm",medium:"md",large:"lg",xlarge:"xl",xxlarge:"xxl",xxxlarge:"xxxl"},s={solid:"solid",outline:"outline",flat:"flat",link:"link",clear:"clear"},c={base:"base",primary:"primary",secondary:"secondary",tertiary:"tertiary",info:"info",success:"success",warning:"warning",error:"error",dark:"dark",light:"light",inherit:"inherit",inverse:"inverse"},d={small:"sm",medium:"md",large:"lg",full:"full",none:"none"},p={vertical:"vertical",horizontal:"horizontal"},f={height:"height",width:"width"},m={default:"cursor-default"},u={up:"up",down:"down",left:"left",right:"right",start:"start",mid:"mid",end:"end"},r={actions:"actions",container:"container",content:"content",group:"group",row:"row",nav:"nav",wrap:"wrap",wrapper:"wrapper",list:"list",placeholder:"placeholder",popup:"popup",item:"item",part:"part",picker:"picker",separator:"separator",spacer:"spacer",tab:"tab",titlebar:"titlebar",optionLabel:"optionlabel",view:"view"},o={table:"table",text:"text",button:"button",tbody:"tbody",thead:"thead",tr:"tr",th:"th",td:"td",header:"header",footer:"footer",icon:"icon",title:"title",subtitle:"subtitle",link:"link",label:"label",ul:"ul",caption:"caption"},h={increase:"increase",decrease:"decrease",cancel:"cancel",accept:"accept",split:"split"},x={active:"active",adaptive:"adaptive",first:"first",focus:"focus",pending:"pending",last:"last",draggable:"draggable",filterable:"filterable",grouping:"grouping",selected:"selected",highlighted:"highlighted",disabled:"disabled",hidden:"hidden",highlight:"highlight",invalid:"invalid",loading:"loading",required:"required",checked:"checked",empty:"empty",scrollable:"scrollable",sorted:"sorted",sort:"sort",sticky:"sticky",stretched:"stretched",order:"order",alt:"alt",edit:"edit",template:"template",shown:"shown",horizontal:"horizontal",vertical:"vertical",fullscreen:"fullscreen",bottom:"bottom"},b={prefix:"animation",child:"child",relative:"relative",slide:"slide",appear:"appear",active:"active",enter:"enter",exit:"exit",pushRight:"push-right",pushLeft:"push-left",pushDown:"push-down",pushUp:"push-up",expandVertical:"expand-vertical",expandHorizontal:"expand-horizontal",fade:"fade",zoomIn:"zoom-in",zoomOut:"zoom-out",slideIn:"slide-in",slideDown:"slide-down",slideUp:"slide-up",slideRight:"slide-right",slideLeft:"slide-left",revealVertical:"reveal-vertical",revealHorizontal:"reveal-horizontal","animation-container":"animation-container","animation-container-shown":"animation-container-shown","animation-container-relative":"animation-container-relative","animation-container-fixed":"animation-container-fixed","child-animation-container":"child-animation-container"},i={input:"input",inner:"inner",spin:"spin",spinner:"spinner",maskedtextbox:"maskedtextbox",radio:"radio",textbox:"textbox",prefix:"prefix",suffix:"suffix"},g={week:"week",weekdays:"weekdays",weekend:"weekend",month:"month",year:"year",decade:"decade",century:"century",number:"number",navigation:"navigation",marker:"marker",now:"now",range:"range",today:"today",other:"other",date:"date",time:"time",selector:"selector",timeselector:"timeselector"},v={prefix:"icon",svg:"svg",i:"i",color:"color",flipH:"flip-h",flipV:"flip-v"},w={label:"label",text:"text",floatingLabel:"floating-label",container:"container",hint:"form-hint",error:"form-error"},k={form:"form",fieldset:"fieldset",legend:"legend",separator:"separator",field:"field"},y={prefix:"popup"},a={prefix:"grid",ariaRoot:"aria-root",tableWrap:"table-wrap",master:"master",column:"column",cell:"cell",cellInner:"cell-inner",row:"row",group:"group",hierarchy:"hierarchy",detail:"detail",noRecords:"norecords",pager:"pager"},P={drop:"drop",drag:"drag",hint:"hint",vertical:"v",horizontal:"h",clue:"clue",reorder:"reorder"},$=`${e.prefix}-${i.input}`,z=`${e.prefix}-${t.calendar}`,M=`${e.prefix}-${t.maskedtextbox}`,R=`${e.prefix}-${i.radio}`,L=`${e.prefix}-${o.button}`,I=`${e.prefix}-${t.menu}`,D=`${e.prefix}-${r.picker}`,S=`${e.prefix}-${t.dropdownlist}`,U=`${e.prefix}-${t.combobox}`,j=`${e.prefix}-${a.prefix}`,H={base:e,actions:h,animation:b,sizeMap:l,components:t,cssUtils:n,directionMap:u,fillModeMap:s,themeColorMap:c,roundedMap:d,orientationMap:p,elements:o,states:x,dimensions:f,containers:r,cursor:m,inputs:i,dateInputs:g,labels:w,forms:k,popup:y,icon:v,grid:a};exports.actions=h;exports.animationStyles=b;exports.base=e;exports.buttonPrefix=L;exports.calendarPrefix=z;exports.comboBoxPrefix=U;exports.components=t;exports.containers=r;exports.cssUtils=n;exports.cursor=m;exports.dateInputs=g;exports.ddbPrefix=I;exports.dimensions=f;exports.directionMap=u;exports.dropDownListPrefix=S;exports.elements=o;exports.fillModeMap=s;exports.forms=k;exports.grid=a;exports.gridPrefix=j;exports.gridRowReorder=P;exports.icon=v;exports.inputPrefix=$;exports.inputs=i;exports.jsonTheme=H;exports.labels=w;exports.maskedPrefix=M;exports.orientationMap=p;exports.pickerPrefix=D;exports.popup=y;exports.radioPrefix=R;exports.roundedMap=d;exports.sizeMap=l;exports.states=x;exports.themeColorMap=c;

package/unstyled/json-classes.mjs

@@ -70,7 +70,8 @@ const e = {
   small: "sm",
   medium: "md",
   large: "lg",
-  full: "full"
+  full: "full",
+  none: "none"
 }, p = {
   vertical: "vertical",
   horizontal: "horizontal"