@progress/kendo-react-grid 14.0.0-develop.1 → 14.0.0-develop.3

package/toolbar-tools/smartbox/hooks/useSmartBoxGridState.d.ts

@@ -0,0 +1,251 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { CompositeFilterDescriptor, GroupDescriptor, SortDescriptor } from '@progress/kendo-data-query';
+import { GridColumnState } from '../../../interfaces/GridColumnState.js';
+import { CompositeHighlightDescriptor } from '../../../interfaces/CompositeHighlightDescriptor.js';
+/**
+ * Represents the grid context type with all available grid operations and state.
+ *
+ * @hidden
+ */
+export interface SmartBoxGridContextType {
+    /**
+     * The current sort descriptors applied to the grid.
+     * Array of sort objects defining field and direction.
+     */
+    sort?: SortDescriptor[];
+    /**
+     * The current filter descriptor applied to the grid.
+     * Composite filter defining logic and filter array.
+     */
+    filter?: CompositeFilterDescriptor;
+    /**
+     * The current group descriptors applied to the grid.
+     * Array of group objects defining field and aggregates.
+     */
+    group?: GroupDescriptor[];
+    /**
+     * The current highlight descriptor applied to the grid.
+     * Used to highlight specific cells or rows based on filter conditions.
+     */
+    highlight?: CompositeHighlightDescriptor;
+    /**
+     * The current selection descriptor applied to the grid.
+     * Used to select specific cells or rows based on filter conditions.
+     */
+    select?: CompositeHighlightDescriptor;
+    /**
+     * The current columns state (visibility, order, width, lock status).
+     * Array of column state objects defining the column configuration.
+     */
+    columnsState?: GridColumnState[];
+    /**
+     * The current skip value for paging.
+     * Zero-based index for the first item to display.
+     */
+    skip?: number;
+    /**
+     * The current take value for paging.
+     * Number of items to display per page.
+     */
+    take?: number;
+    /**
+     * Reference to the visible grid columns.
+     */
+    columnsRef?: any[];
+    /**
+     * Reference to the hidden grid columns.
+     */
+    hiddenColumnsRef?: any[];
+    /**
+     * The data item key field name.
+     */
+    dataItemKey?: string;
+    /**
+     * Gets the total number of data items.
+     */
+    getTotal: () => number;
+    /**
+     * Gets the leaf data items (after grouping).
+     */
+    getLeafDataItems: () => any[];
+    /**
+     * Exports the grid as PDF.
+     */
+    exportAsPdf: () => void;
+    /**
+     * Handles sort changes.
+     *
+     * @param sort - The new sort descriptors to apply.
+     * @param event - The triggering event.
+     */
+    sortChange: (sort: SortDescriptor[], event: any) => void;
+    /**
+     * Handles filter changes.
+     *
+     * @param filter - The new filter descriptor to apply, or undefined to clear filters.
+     * @param event - The triggering event.
+     */
+    filterChange: (filter: CompositeFilterDescriptor | undefined, event: any) => void;
+    /**
+     * Handles group changes.
+     *
+     * @param group - The new group descriptors to apply.
+     * @param event - The triggering event.
+     */
+    groupChange: (group: GroupDescriptor[], event: any) => void;
+    /**
+     * Applies highlight descriptor to the grid.
+     *
+     * @param highlight - The highlight descriptor to apply.
+     */
+    applyHighlightDescriptor: (highlight: CompositeHighlightDescriptor) => void;
+    /**
+     * Applies selection descriptor to the grid.
+     *
+     * @param select - The selection descriptor to apply.
+     */
+    applySelectionDescriptor: (select: CompositeHighlightDescriptor) => void;
+    /**
+     * Handles columns state changes.
+     *
+     * @param columnsState - The new columns state to apply.
+     */
+    onColumnsStateChange: (columnsState: GridColumnState[]) => void;
+    /**
+     * Handles pager page changes.
+     *
+     * @param event - The page change event containing skip and take values.
+     */
+    pagerPageChange: (event: {
+        skip: number;
+        take: number;
+        syntheticEvent: any;
+    }) => void;
+}
+/**
+ * Represents the grid state snapshot.
+ * This interface contains all the stateful properties that can be modified through AI commands.
+ *
+ * @hidden
+ */
+export interface SmartBoxGridState {
+    /**
+     * The current sort descriptors applied to the grid.
+     * Array of sort objects defining field and direction.
+     */
+    sort?: SortDescriptor[];
+    /**
+     * The current filter descriptor applied to the grid.
+     * Composite filter defining logic and filter array.
+     */
+    filter?: CompositeFilterDescriptor;
+    /**
+     * The current group descriptors applied to the grid.
+     * Array of group objects defining field and aggregates.
+     */
+    group?: GroupDescriptor[];
+    /**
+     * The current highlight descriptor applied to the grid.
+     * Used to highlight specific cells or rows based on filter conditions.
+     */
+    highlight?: CompositeHighlightDescriptor;
+    /**
+     * The current selection descriptor applied to the grid.
+     * Used to select specific cells or rows based on filter conditions.
+     */
+    select?: CompositeHighlightDescriptor;
+    /**
+     * The current columns state (visibility, order, width, lock status).
+     * Array of column state objects defining the column configuration.
+     */
+    columnsState?: GridColumnState[];
+    /**
+     * The current skip value for paging.
+     * Zero-based index for the first item to display.
+     */
+    skip?: number;
+    /**
+     * The current take value for paging.
+     * Number of items to display per page.
+     */
+    take?: number;
+}
+/**
+ * Represents a reference to the grid with essential methods.
+ *
+ * @hidden
+ */
+export interface SmartBoxGridRef {
+    /**
+     * Gets the total number of data items.
+     */
+    getTotal: () => number;
+    /**
+     * Gets the leaf data items (after grouping).
+     */
+    getLeafDataItems: () => any[];
+    /**
+     * Exports the grid as PDF.
+     */
+    exportAsPdf: () => void;
+    /**
+     * The grid props.
+     */
+    props: {
+        /**
+         * The data item key field name.
+         */
+        dataItemKey?: string;
+    };
+}
+/**
+ * Represents the return value of the useSmartBoxGridState hook.
+ *
+ * @hidden
+ */
+export interface UseSmartBoxGridStateResult {
+    /**
+     * The grid columns with their field names, IDs, and possible values.
+     */
+    columns: Array<{
+        id?: string;
+        field: string;
+        values?: any[];
+    }>;
+    /**
+     * The current grid state snapshot.
+     */
+    gridState: SmartBoxGridState | undefined;
+    /**
+     * Reference to the grid with essential methods.
+     */
+    gridRef: SmartBoxGridRef | null;
+    /**
+     * Function to handle grid state changes from AI responses.
+     *
+     * @param newState - The new partial state to apply.
+     */
+    handleStateChange: (newState: Partial<SmartBoxGridState>) => void;
+    /**
+     * Function to export the grid as PDF.
+     */
+    exportAsPdf: () => void;
+}
+/**
+ * Hook to manage grid state for SmartBox AI assistant operations.
+ *
+ * This hook extracts the current grid state from the grid context and provides
+ * functions to update the grid state based on AI responses.
+ *
+ * @param gridContext - The grid context providing access to grid operations.
+ * @returns An object containing grid state and management functions.
+ *
+ * @hidden
+ */
+export declare function useSmartBoxGridState(gridContext: SmartBoxGridContextType | null): UseSmartBoxGridStateResult;

package/toolbar-tools/smartbox/hooks/useSmartBoxGridState.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 k=require("react");function v(s){const c=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(s){for(const u in s)if(u!=="default"){const f=Object.getOwnPropertyDescriptor(s,u);Object.defineProperty(c,u,f.get?f:{enumerable:!0,get:()=>s[u]})}}return c.default=s,Object.freeze(c)}const a=v(k);function r(s){const c=a.useMemo(()=>{var l;if(s!=null&&s.columnsRef&&Array.isArray(s.columnsRef)){const e=s.columnsRef,p=(l=s.hiddenColumnsRef)!=null?l:[];return[...e,...p].map(h=>{var m;return{id:h.id,field:h.field,values:(m=h.values)!=null?m:[]}})}return[]},[s==null?void 0:s.columnsRef,s==null?void 0:s.hiddenColumnsRef]),u=a.useMemo(()=>s?{sort:s.sort,filter:s.filter,group:s.group,highlight:s.highlight,select:s.select,columnsState:s.columnsState,skip:s.skip,take:s.take}:void 0,[s]),f=a.useMemo(()=>s?{getTotal:()=>s.getTotal(),getLeafDataItems:()=>s.getLeafDataItems(),exportAsPdf:()=>s.exportAsPdf(),props:{dataItemKey:s.dataItemKey}}:null,[s]),o=a.useCallback(l=>{var e,p;s&&(l.sort!==void 0&&l.sort!==s.sort&&s.sortChange(l.sort,{}),l.filter!==s.filter&&s.filterChange(l.filter,{}),l.group!==void 0&&l.group!==s.group&&s.groupChange(l.group,{}),l.highlight!==void 0&&l.highlight!==s.highlight&&s.applyHighlightDescriptor(l.highlight),l.select!==void 0&&l.select!==s.select&&s.applySelectionDescriptor(l.select),l.columnsState!==void 0&&l.columnsState!==s.columnsState&&s.onColumnsStateChange(l.columnsState),(l.skip!==void 0&&l.skip!==s.skip||l.take!==void 0&&l.take!==s.take)&&s.pagerPageChange({skip:(e=l.skip)!=null?e:0,take:(p=l.take)!=null?p:0,syntheticEvent:{}}))},[s]),i=a.useCallback(()=>{s==null||s.exportAsPdf()},[s]);return{columns:c,gridState:u,gridRef:f,handleStateChange:o,exportAsPdf:i}}exports.useSmartBoxGridState=r;

package/toolbar-tools/smartbox/hooks/useSmartBoxGridState.mjs

@@ -0,0 +1,68 @@
+/**
+ * @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 u from "react";
+function i(s) {
+  const p = u.useMemo(() => {
+    var l;
+    if (s != null && s.columnsRef && Array.isArray(s.columnsRef)) {
+      const f = s.columnsRef, h = (l = s.hiddenColumnsRef) != null ? l : [];
+      return [...f, ...h].map((a) => {
+        var c;
+        return {
+          id: a.id,
+          field: a.field,
+          values: (c = a.values) != null ? c : []
+        };
+      });
+    }
+    return [];
+  }, [s == null ? void 0 : s.columnsRef, s == null ? void 0 : s.hiddenColumnsRef]), m = u.useMemo(
+    () => s ? {
+      sort: s.sort,
+      filter: s.filter,
+      group: s.group,
+      highlight: s.highlight,
+      select: s.select,
+      columnsState: s.columnsState,
+      skip: s.skip,
+      take: s.take
+    } : void 0,
+    [s]
+  ), k = u.useMemo(
+    () => s ? {
+      getTotal: () => s.getTotal(),
+      getLeafDataItems: () => s.getLeafDataItems(),
+      exportAsPdf: () => s.exportAsPdf(),
+      props: { dataItemKey: s.dataItemKey }
+    } : null,
+    [s]
+  ), v = u.useCallback(
+    (l) => {
+      var f, h;
+      s && (l.sort !== void 0 && l.sort !== s.sort && s.sortChange(l.sort, {}), l.filter !== s.filter && s.filterChange(l.filter, {}), l.group !== void 0 && l.group !== s.group && s.groupChange(l.group, {}), l.highlight !== void 0 && l.highlight !== s.highlight && s.applyHighlightDescriptor(l.highlight), l.select !== void 0 && l.select !== s.select && s.applySelectionDescriptor(l.select), l.columnsState !== void 0 && l.columnsState !== s.columnsState && s.onColumnsStateChange(l.columnsState), (l.skip !== void 0 && l.skip !== s.skip || l.take !== void 0 && l.take !== s.take) && s.pagerPageChange({
+        skip: (f = l.skip) != null ? f : 0,
+        take: (h = l.take) != null ? h : 0,
+        syntheticEvent: {}
+      }));
+    },
+    [s]
+  ), R = u.useCallback(() => {
+    s == null || s.exportAsPdf();
+  }, [s]);
+  return {
+    columns: p,
+    gridState: m,
+    gridRef: k,
+    handleStateChange: v,
+    exportAsPdf: R
+  };
+}
+export {
+  i as useSmartBoxGridState
+};

package/toolbar-tools/smartbox/hooks/useSmartBoxHistory.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { HistoryItem, SmartBoxMode } from '../interfaces/index.js';
+import { GridSmartBoxHistoryProps } from '../interfaces/utilTypes.js';
+/**
+ * Represents the props for the useSmartBoxHistory hook.
+ *
+ * @hidden
+ */
+export interface UseSmartBoxHistoryProps {
+    /**
+     * The currently selected view mode.
+     */
+    selectedView: SmartBoxMode | null;
+    /**
+     * The history settings for search mode.
+     */
+    searchHistorySettings: GridSmartBoxHistoryProps | null;
+    /**
+     * The history settings for semantic search mode.
+     */
+    semanticSearchHistorySettings: GridSmartBoxHistoryProps | null;
+    /**
+     * The history settings for AI assistant mode.
+     */
+    aiAssistantHistorySettings: GridSmartBoxHistoryProps | null;
+}
+/**
+ * Represents the return value of the useSmartBoxHistory hook.
+ *
+ * @hidden
+ */
+export interface UseSmartBoxHistoryReturn {
+    /**
+     * The history items for search mode.
+     */
+    searchHistory: HistoryItem[];
+    /**
+     * The history items for semantic search mode.
+     */
+    semanticSearchHistory: HistoryItem[];
+    /**
+     * The history items for AI assistant mode.
+     */
+    aiAssistantHistory: HistoryItem[];
+    /**
+     * The history items for the currently selected mode.
+     */
+    currentHistory: HistoryItem[];
+    /**
+     * The history settings for the currently selected mode.
+     */
+    currentHistorySettings: GridSmartBoxHistoryProps | null;
+    /**
+     * Function to add a new item to the history for a specific mode.
+     *
+     * @param mode - The mode to add the history item to.
+     * @param value - The text value to add to history.
+     * @param historySettings - The history settings for the mode.
+     */
+    addToHistory: (mode: SmartBoxMode, value: string, historySettings: GridSmartBoxHistoryProps | null) => void;
+}
+/**
+ * Hook to manage SmartBox history for all modes.
+ *
+ * This hook maintains separate history lists for each mode (search, semantic search,
+ * and AI assistant) and provides functions to add items to history while respecting
+ * the configured history size limits.
+ *
+ * @param props - The hook properties.
+ * @returns An object containing history arrays and management functions.
+ *
+ * @hidden
+ */
+export declare function useSmartBoxHistory({ selectedView, searchHistorySettings, semanticSearchHistorySettings, aiAssistantHistorySettings }: UseSmartBoxHistoryProps): UseSmartBoxHistoryReturn;

package/toolbar-tools/smartbox/hooks/useSmartBoxHistory.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 O=require("react");function j(t){const s=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(t){for(const e in t)if(e!=="default"){const a=Object.getOwnPropertyDescriptor(t,e);Object.defineProperty(s,e,a.get?a:{enumerable:!0,get:()=>t[e]})}}return s.default=t,Object.freeze(s)}const r=j(O);function A({selectedView:t,searchHistorySettings:s,semanticSearchHistorySettings:e,aiAssistantHistorySettings:a}){const[n,y]=r.useState([]),[c,f]=r.useState([]),[o,l]=r.useState([]),H=r.useCallback((b,i,u)=>{if(!u||!i.trim())return;const h={text:i,timestamp:new Date,format:u.timestampFormat},d={search:y,semanticSearch:f,aiAssistant:l}[b];d(m=>m.some(M=>M.text===i)?m:[h,...m].slice(0,u.size))},[]),p=r.useMemo(()=>{switch(t){case"search":return n;case"semanticSearch":return c;case"aiAssistant":return o;default:return[]}},[t,n,c,o]),S=r.useMemo(()=>{switch(t){case"search":return s;case"semanticSearch":return e;case"aiAssistant":return a;default:return null}},[t,s,e,a]);return{searchHistory:n,semanticSearchHistory:c,aiAssistantHistory:o,currentHistory:p,currentHistorySettings:S,addToHistory:H}}exports.useSmartBoxHistory=A;

package/toolbar-tools/smartbox/hooks/useSmartBoxHistory.mjs

@@ -0,0 +1,66 @@
+/**
+ * @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";
+function d({
+  selectedView: s,
+  searchHistorySettings: i,
+  semanticSearchHistorySettings: u,
+  aiAssistantHistorySettings: m
+}) {
+  const [r, H] = t.useState([]), [e, y] = t.useState([]), [a, h] = t.useState([]), f = t.useCallback(
+    (A, c, n) => {
+      if (!n || !c.trim())
+        return;
+      const l = {
+        text: c,
+        timestamp: /* @__PURE__ */ new Date(),
+        format: n.timestampFormat
+      }, x = {
+        search: H,
+        semanticSearch: y,
+        aiAssistant: h
+      }[A];
+      x((o) => o.some((M) => M.text === c) ? o : [l, ...o].slice(0, n.size));
+    },
+    []
+  ), p = t.useMemo(() => {
+    switch (s) {
+      case "search":
+        return r;
+      case "semanticSearch":
+        return e;
+      case "aiAssistant":
+        return a;
+      default:
+        return [];
+    }
+  }, [s, r, e, a]), S = t.useMemo(() => {
+    switch (s) {
+      case "search":
+        return i;
+      case "semanticSearch":
+        return u;
+      case "aiAssistant":
+        return m;
+      default:
+        return null;
+    }
+  }, [s, i, u, m]);
+  return {
+    searchHistory: r,
+    semanticSearchHistory: e,
+    aiAssistantHistory: a,
+    currentHistory: p,
+    currentHistorySettings: S,
+    addToHistory: f
+  };
+}
+export {
+  d as useSmartBoxHistory
+};

package/toolbar-tools/smartbox/hooks/useSmartBoxInput.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { SpeechToTextResultEvent } from '@progress/kendo-react-buttons';
+import { SmartBoxMode } from '../interfaces/index.js';
+import * as React from 'react';
+/**
+ * Represents the props for the useSmartBoxInput hook.
+ *
+ * @hidden
+ */
+export interface UseSmartBoxInputProps {
+    /**
+     * The currently selected view mode.
+     */
+    selectedView: SmartBoxMode | null;
+    /**
+     * Ref to the input element.
+     */
+    inputRef: React.RefObject<HTMLInputElement | null>;
+    /**
+     * Function to toggle the popup visibility.
+     */
+    togglePopup: (open: boolean) => void;
+    /**
+     * Function to emit a search event with the provided value.
+     */
+    emitSearchEvent: (value: string) => void;
+    /**
+     * State setter for the search value.
+     */
+    setSearchValue: React.Dispatch<React.SetStateAction<string | null>>;
+    /**
+     * Callback fired when the input receives focus.
+     */
+    onFocus?: () => void;
+    /**
+     * Callback fired when the input loses focus.
+     */
+    onBlur?: () => void;
+}
+/**
+ * Represents the return value of the useSmartBoxInput hook.
+ *
+ * @hidden
+ */
+export interface UseSmartBoxInputResult {
+    /**
+     * The current value of the input.
+     */
+    inputValue: string;
+    /**
+     * State setter for the input value.
+     */
+    setInputValue: React.Dispatch<React.SetStateAction<string>>;
+    /**
+     * Handler for input change events.
+     */
+    handleInputChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
+    /**
+     * Handler for input focus events.
+     */
+    handleInputFocus: () => void;
+    /**
+     * Handler for input click events.
+     */
+    handleInputClick: () => void;
+    /**
+     * Handler for clearing the input value.
+     */
+    handleClearValue: (event: React.MouseEvent) => void;
+    /**
+     * Handler for speech-to-text result events.
+     */
+    handleSpeechResult: (event: SpeechToTextResultEvent) => void;
+    /**
+     * Handler for blur events on the wrapper element.
+     */
+    handleWrapperBlur: (event: React.FocusEvent<HTMLDivElement>, wrapperRef: React.RefObject<HTMLDivElement | null>) => void;
+}
+/**
+ * Hook to manage SmartBox input state and event handlers.
+ *
+ * This hook provides input value management and event handlers for
+ * text input, focus, blur, clear, and speech-to-text functionality.
+ *
+ * @param props - The hook properties.
+ * @returns An object containing input state and event handlers.
+ *
+ * @hidden
+ */
+export declare function useSmartBoxInput({ selectedView, inputRef, togglePopup, emitSearchEvent, setSearchValue, onFocus, onBlur }: UseSmartBoxInputProps): UseSmartBoxInputResult;

package/toolbar-tools/smartbox/hooks/useSmartBoxLabels.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { SVGIcon } from '@progress/kendo-svg-icons';
+import { SmartBoxMode } from '../interfaces/index.js';
+/**
+ * Represents a minimal mode configuration for labels.
+ *
+ * @hidden
+ */
+export interface SmartBoxLabelsModeConfig {
+    /**
+     * Specifies whether the mode is enabled.
+     */
+    enabled?: boolean;
+    /**
+     * The placeholder text for the mode.
+     */
+    placeholder?: string;
+}
+/**
+ * Represents the props for the useSmartBoxLabels hook.
+ *
+ * @hidden
+ */
+export interface UseSmartBoxLabelsProps {
+    /**
+     * The currently selected view mode.
+     */
+    selectedView: SmartBoxMode | null;
+    /**
+     * The search mode configuration.
+     */
+    searchMode: SmartBoxLabelsModeConfig | null;
+    /**
+     * The semantic search mode configuration.
+     */
+    semanticSearchMode: SmartBoxLabelsModeConfig | null;
+    /**
+     * The AI assistant mode configuration.
+     */
+    aiAssistantMode: SmartBoxLabelsModeConfig | null;
+    /**
+     * The shared placeholder text that overrides mode-specific placeholders.
+     */
+    sharedPlaceholder?: string;
+}
+/**
+ * Represents a prefix icon configuration.
+ *
+ * @hidden
+ */
+export interface SmartBoxPrefixIcon {
+    /**
+     * The icon name.
+     */
+    name: string;
+    /**
+     * The SVG icon.
+     */
+    svgIcon: SVGIcon;
+}
+/**
+ * Represents the return value of the useSmartBoxLabels hook.
+ *
+ * @hidden
+ */
+export interface UseSmartBoxLabelsResult {
+    /**
+     * The placeholder text for the input based on the selected mode.
+     */
+    inputPlaceholder: string;
+    /**
+     * The prefix icon configuration based on the selected mode.
+     */
+    prefixIcon: SmartBoxPrefixIcon;
+}
+/**
+ * Hook to compute SmartBox labels and icons based on the selected mode.
+ *
+ * This hook determines the appropriate placeholder text and prefix icon
+ * based on the currently selected mode, using localized strings.
+ *
+ * @param props - The hook properties.
+ * @returns An object containing the input placeholder and prefix icon.
+ *
+ * @hidden
+ */
+export declare function useSmartBoxLabels({ selectedView, searchMode, semanticSearchMode, aiAssistantMode, sharedPlaceholder }: UseSmartBoxLabelsProps): UseSmartBoxLabelsResult;

package/toolbar-tools/smartbox/hooks/useSmartBoxLabels.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 g=require("react"),m=require("@progress/kendo-react-intl"),o=require("@progress/kendo-svg-icons"),t=require("../../../messages/index.js");function i(e){const n=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const a=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(n,r,a.get?a:{enumerable:!0,get:()=>e[r]})}}return n.default=e,Object.freeze(n)}const u=i(g);function p({selectedView:e,searchMode:n,semanticSearchMode:r,aiAssistantMode:a,sharedPlaceholder:s}){const c=m.useLocalization(),l=u.useMemo(()=>{switch(e){case"search":return{name:"search",svgIcon:o.searchIcon};case"semanticSearch":return{name:"zoom-sparkle",svgIcon:o.zoomSparkleIcon};case"aiAssistant":return{name:"sparkles",svgIcon:o.sparklesIcon};default:return{name:"search",svgIcon:o.searchIcon}}},[e]);return{inputPlaceholder:u.useMemo(()=>{if(s)return s;switch(e){case"search":return(n==null?void 0:n.placeholder)||c.toLanguageString(t.smartBoxSearchPlaceholder,t.messages[t.smartBoxSearchPlaceholder]);case"semanticSearch":return(r==null?void 0:r.placeholder)||c.toLanguageString(t.smartBoxSemanticSearchPlaceholder,t.messages[t.smartBoxSemanticSearchPlaceholder]);case"aiAssistant":return(a==null?void 0:a.placeholder)||c.toLanguageString(t.smartBoxAIAssistantPlaceholder,t.messages[t.smartBoxAIAssistantPlaceholder]);default:return""}},[e,n,r,a,s,c]),prefixIcon:l}}exports.useSmartBoxLabels=p;