@uniformdev/mesh-sdk-react 20.7.1-alpha.12 → 20.7.1-alpha.120

package/LICENSE.txt

@@ -1,2 +1,2 @@
-© 2024 Uniform Systems, Inc. All Rights Reserved.
+© 2025 Uniform Systems, Inc. All Rights Reserved.
 See details of Uniform Systems, Inc. Master Subscription Agreement here: https://uniform.dev/eula

package/dist/index.d.mts

@@ -8,7 +8,7 @@ import { DataVariableDefinition, DataResourceVariables, DataType, DataSourceVari
 import { Emitter } from 'mitt';
 import { TDate } from 'timeago.js';
 import * as lexical from 'lexical';
-import { SerializedEditorState, SerializedLexicalNode, Spread, DecoratorNode, NodeKey, LexicalNode, LexicalEditor, EditorState, SerializedRootNode } from 'lexical';
+import { SerializedEditorState, SerializedLexicalNode, Spread, DecoratorNode, NodeKey, DOMConversionMap, LexicalNode, LexicalEditor, EditorState, SerializedRootNode } from 'lexical';
 import { Interpolation, Theme, SerializedStyles } from '@emotion/react';
 import { InputSelectProps, IconType } from '@uniformdev/design-system';
 export { AddListButton, AddListButtonProps, Button, ButtonProps, Callout, CalloutProps, DrawerContent, Heading, HeadingProps, Input, InputComboBox, InputComboBoxProps, InputKeywordSearch, InputProps, InputSelect, InputToggle, InputToggleProps, Label, LabelProps, LoadingIndicator, LoadingOverlay, Menu, MenuItem, MenuItemProps, MenuProps, ParameterGroup, ParameterGroupProps, ParameterImage, ParameterImageInner, ParameterImageProps, ParameterInput, ParameterInputInner, ParameterInputProps, ParameterLabel, ParameterLabelProps, ParameterMenuButton, ParameterMenuButtonProps, ParameterSelect, ParameterSelectInner, ParameterSelectProps, ParameterShell, ParameterShellContext, ParameterShellProps, ParameterTextarea, ParameterTextareaInner, ParameterTextareaProps, ParameterToggle, ParameterToggleInner, ParameterToggleProps, ScrollableList, ScrollableListItem, ScrollableListItemProps, ScrollableListProps, Switch, SwitchProps, Textarea, TextareaProps, Theme, ThemeProps, useParameterShell, utilityColors } from '@uniformdev/design-system';
@@ -96,6 +96,12 @@ declare function useMeshLocation<TLocationType extends MeshLocation['type'], TLo
     type: TLocationType;
 }> | Extract<_uniformdev_mesh_sdk.AIGenerateLocation<TLocationValue>, {
     type: TLocationType;
+}> | Extract<_uniformdev_mesh_sdk.PersonalizationCriteriaLocation<TLocationValue, unknown>, {
+    type: TLocationType;
+}> | Extract<_uniformdev_mesh_sdk.DashboardToolLocation<TLocationValue, unknown>, {
+    type: TLocationType;
+}> | Extract<_uniformdev_mesh_sdk.ProjectToolLocation<TLocationValue, unknown>, {
+    type: TLocationType;
 }>, "setValue"> & {
     setValue: SetLocationValueDispatch<(Extract<_uniformdev_mesh_sdk.AssetLibraryLocation, {
         type: TLocationType;
@@ -121,6 +127,12 @@ declare function useMeshLocation<TLocationType extends MeshLocation['type'], TLo
         type: TLocationType;
     }> | Extract<_uniformdev_mesh_sdk.AIGenerateLocation<TLocationValue>, {
         type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.PersonalizationCriteriaLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.DashboardToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.ProjectToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
     }>)["value"], Parameters<(Extract<_uniformdev_mesh_sdk.AssetLibraryLocation, {
         type: TLocationType;
     }> | Extract<_uniformdev_mesh_sdk.AssetParameterLocation, {
@@ -145,6 +157,12 @@ declare function useMeshLocation<TLocationType extends MeshLocation['type'], TLo
         type: TLocationType;
     }> | Extract<_uniformdev_mesh_sdk.AIGenerateLocation<TLocationValue>, {
         type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.PersonalizationCriteriaLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.DashboardToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.ProjectToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
     }>)["setValue"]>[0]>;
 };
 type SetLocationValueDispatch<TValue, TSetValue = TValue> = (dispatch: SetLocationValueFunction<TValue, TSetValue>) => Promise<void> | void;
@@ -230,6 +248,7 @@ declare class VariableNode extends DecoratorNode<JSX.Element> {
     /** Creates the DOM wrapper that hosts the node */
     createDOM(): HTMLSpanElement;
     updateDOM(): boolean;
+    static importDOM(): DOMConversionMap | null;
     /**
      * Render the variable node using React.
      * NOTE: this is effectively an island of React, and you may not call hooks,
@@ -397,6 +416,11 @@ type VariablesPluginProps<TEditorContext = unknown> = {
     filterVariable?: SelectVariableMenuProps<TEditorContext>['filterVariable'];
     /** If true, the whole value of the editor is replaced when a variable is inserted */
     replaceValueOnVariableInsert: boolean;
+    /**
+     * Disables display names for variables; the variable's (prettified) name is used instead even if a DN exists
+     * Use this to render dynamic tokens as paths instead of bound values.
+     */
+    disableVariableDisplayNames?: boolean;
 };
 type UseVariablesMenuInput<TEditorContext> = Pick<VariablesPluginProps<TEditorContext>, 'showAddVariableMenuOption' | 'enableEditingVariables' | 'filterVariable' | 'getEditorContext'>;
 type OnVariableSelectInput = {
@@ -417,7 +441,7 @@ declare function useVariablesMenu<TEditorContext>({ showAddVariableMenuOption, e
  * Enables variables auto-complete and reference management to a Lexical editor.
  * Must also activate the VariableNode node to make this work.
  */
-declare function VariablesPlugin<TEditorContext = unknown>({ disableVariables, showAddVariableMenuOption, enableEditingVariables, getEditorContext, replaceValueOnVariableInsert, filterVariable, }: VariablesPluginProps<TEditorContext>): JSX.Element | null;
+declare function VariablesPlugin<TEditorContext = unknown>({ disableVariables, showAddVariableMenuOption, enableEditingVariables, getEditorContext, replaceValueOnVariableInsert, filterVariable, disableVariableDisplayNames, }: VariablesPluginProps<TEditorContext>): JSX.Element | null;
 
 type PasteTransformerPluginProps = {
     /**
@@ -534,6 +558,11 @@ type InputVariablesProps<TEditorContext = unknown> = {
      * any existing value on insert a new dynamic token.
      */
     singleTokenMode?: boolean;
+    /**
+     * Disables display names for variables; the variable's (prettified) name is used instead even if a DN exists
+     * Use this to render dynamic tokens as paths instead of bound values.
+     */
+    disableVariableDisplayNames?: boolean;
 } & PasteTransformerPluginProps & UseInputVariablesStateProps<TEditorContext>;
 /**
  * An input box that enables insertion of 'variables', provided by VariablesProvider,
@@ -881,7 +910,9 @@ type DataRefreshButtonProps = HTMLAttributes<HTMLButtonElement> & {
 };
 /**
  * @description The data refresh button is a UI component to indicate to users a request for data is taking place
- * @example <DataRefreshButton buttonText="my button" isLoading /> */
+ * @example <DataRefreshButton buttonText="my button" isLoading />
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const DataRefreshButton: ({ buttonText, isLoading, onRefreshData, ...props }: DataRefreshButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ObjectSearchContainerProps = {
@@ -908,7 +939,9 @@ type ObjectSearchContainerProps = {
 };
 /**
  * @description Object search container is an opinionated layout for search parameters and retrieved results
- * @example  <ObjectSearchContainer searchFilters={<>your component</>} resultList={<>your result list component<>} onSave={yourSaveAction} onCancel={yourCancelAction} /> */
+ * @example  <ObjectSearchContainer searchFilters={<>your component</>} resultList={<>your result list component<>} onSave={yourSaveAction} onCancel={yourCancelAction} />
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchContainer: ({ label, enableDynamicInputToResultId, searchFilters, resultList, children, }: ObjectSearchContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ObjectSearchFilterProps = {
@@ -939,7 +972,9 @@ type ObjectSearchFilterProps = {
 /**
  * @description Object search filter is an opinionated filter that has pre-defined query and setQuery functions
  * that can be extended with custom functions
- * @example  <ObjectSearchFilter selectOptions={[{ id: 'id value', name: 'name value'}]} /> */
+ * @example  <ObjectSearchFilter selectOptions={[{ id: 'id value', name: 'name value'}]} />
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchFilter: ({ requireContentType, typeSelectorAllTypesOptionText, searchInputName, searchInputPlaceholderText, selectLabel, selectOptions, }: ObjectSearchFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ObjectSearchFilterContainerProps = {
@@ -949,6 +984,7 @@ type ObjectSearchFilterContainerProps = {
 /**
  * @description an opinionated layout for search filters
  * @example <ObjectSearchFilterContainer label="my label"><input type="text" aria-label="my input" /></ObjectSearchFilterContainer>
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const ObjectSearchFilterContainer: ({ children }: ObjectSearchFilterContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -966,12 +1002,14 @@ type ObjectSearchResultItemProps = SelectedItemProps & {
      * @default false
      */
     disableDnD?: boolean;
+    onClick?: () => void;
 };
 /**
  * @description An opinionated result item, best used for selected results
  * @example <ObjectSearchResultItem id="my-result" title="title" />
+ * @deprecated this component is not recommended for use in new projects
  */
-declare const ObjectSearchResultItem: ({ id, title, contentType, popoverData, publishStatus, editLinkIcon, editLink, imageUrl, onRemove, createdAt, publishedAt, hideRemoveButton, disableDnD, children, }: ObjectSearchResultItemProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const ObjectSearchResultItem: ({ id, title, contentType, popoverData, publishStatus, editLinkIcon, editLink, imageUrl, onRemove, createdAt, publishedAt, hideRemoveButton, disableDnD, children, onClick, }: ObjectSearchResultItemProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type SearchQueryProps<TExtraFilters = unknown> = {
     /** sets the content type in the search context */
@@ -1049,7 +1087,13 @@ type ObjectSearchProviderProps = {
     isMulti?: boolean;
     defaultQuery?: SearchQueryProps;
 };
+/**
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchProvider: ({ currentlySelectedItems, isMulti, children, defaultQuery, }: ObjectSearchProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare function useObjectSearchContext<TExtraSearchFilters = unknown, TExtraItemProps = unknown>(): ObjectSearchContextProps<TExtraSearchFilters, TExtraItemProps>;
 
 type ObjectSearchListItemProps = SelectedItemProps & {
@@ -1071,7 +1115,9 @@ type ObjectSearchListItemProps = SelectedItemProps & {
 } & React$1.HTMLAttributes<HTMLDivElement>;
 /**
  * @description entry search list item is an opinionated UI component best used for initial retrieved results
- * @example <ObjectSearchListItem  id="my-result-item" title="title" popoverData={<p>some data info</p>}><div>example of uncontrolled content</div></ObjectSearchListItem> */
+ * @example <ObjectSearchListItem  id="my-result-item" title="title" popoverData={<p>some data info</p>}><div>example of uncontrolled content</div></ObjectSearchListItem>
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchListItem: ({ id, title, contentType, imageUrl, popoverData, onSelect, isMulti, disabled, children, ...props }: ObjectSearchListItemProps & React$1.HTMLAttributes<HTMLDivElement>) => _emotion_react_jsx_runtime.JSX.Element;
 /**
  * An opinionated loading skeleton component best used with ObjectSearchListItem
@@ -1090,12 +1136,14 @@ type ObjectSearchResultItemButtonProps<THtml extends HTMLAttributes<HTMLElement>
 /**
  * @description An opinionated button component best used within the ObjectSearchResultItem component
  * @example <ObjectSearchResultItemButton text="button text" icon="/my-image.png" onClick={() => myFunction()} />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const ObjectSearchResultItemButton: ({ text, icon, ...props }: ObjectSearchResultItemButtonProps<HTMLAttributes<HTMLButtonElement>>) => _emotion_react_jsx_runtime.JSX.Element;
 /**
  * @description An opinionated link component styled the same of the ObjectSearchResultItemButton component,
  * that automatically sets the target and rel attributes. Best used within the ObjectSearchResultItem component
  * @example <LinkButton text="link text" icon="/my-image.png" />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const LinkButton: ({ text, icon, ...props }: ObjectSearchResultItemButtonProps<Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "target" | "rel">>) => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -1140,6 +1188,7 @@ type ObjectSearchResultListProps<TRenderComponent extends SelectedItemProps = Se
  * The result item component defaults to <ObjectSearchResultItem {...props} />, however this can be overridden with any other UI component and still
  * maintain drag and drop functionality
  * @example <ObjectSearchResultList id="my-id" title="title" renderResultComponent={(values) => <CustomComponent {...values} />} />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare function ObjectSearchResultList<TRenderComponent extends SelectedItemProps = SelectedItemProps>({ resultLabelText, removeButtonText, onRemoveAllSelected, hideRemoveButton, resultLabelOverride, additionalButtons, renderResultComponent, multiSelectId, disableDnD, getContainerForDnDReparenting, whenNothingSelected, }: ObjectSearchResultListProps<TRenderComponent>): _emotion_react_jsx_runtime.JSX.Element;
 
@@ -1209,6 +1258,7 @@ type QueryFilterProps<TSelectOptions extends QueryFilterSelectionOptionProps = Q
 /**
  * @description An opinionated multi query filter UI component, best used for querying product data or more complex scenarios
  * @example <QueryFilter contentTypeOptions={[{ id: 'id', name: 'name' }]} sortOptions={[{ id: 'id', name: 'name' }]} sortOrderOptions={[{ id: 'id', name: 'name' }]} />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const QueryFilter: ({ requireContentType, queryFilterTitle, contentTypeLabel, typeSelectorAllTypesOptionText, contentTypeOptions, searchInputName, searchInputPlaceholderText, searchInputLabel, countLabel, sortLabel, sortOptions, sortOrderLabel, sortOrderOptions, children, }: QueryFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -1681,6 +1731,8 @@ type SearchAndFilterProviderProps = {
     resetFilterValues?: Filter[];
     /** sets the list of filter options for each filter row */
     filterOptions: FilterOptionGroup[];
+    /** optional function that is used instead of the default reset filter functionality */
+    onResetFilterValues?: () => void;
     /** the total number of results */
     totalResults?: number;
     /** the filter mapper function */
@@ -1725,7 +1777,7 @@ declare const SearchAndFilterContext: React$1.Context<SearchAndFilterContextProp
  * Search and filter provider
  * @example <SearchAndFilterProvider filters={filters} filterOptions={filterOptions} onSearchChange={onSearchChange} onChange={onChange}>Children</SearchAndFilterProvider>
  * */
-declare const SearchAndFilterProvider: ({ filters, filterOptions, filterVisible, alwaysVisible, defaultSearchTerm, onSearchChange, onChange, resetFilterValues, totalResults, filterMapper, children, allowBindingSearchTerm, }: SearchAndFilterProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilterProvider: ({ filters, filterOptions, filterVisible, alwaysVisible, defaultSearchTerm, onSearchChange, onChange, resetFilterValues, onResetFilterValues, totalResults, filterMapper, children, allowBindingSearchTerm, }: SearchAndFilterProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
 /** Search and filter hook
  * @example const { searchTerm, setSearchTerm, filterVisibility, setFilterVisibility, filters, setFilters, handleAddFilter, handleResetFilters, handleDeleteFilter, filterOptions, validFilterQuery } = useSearchAndFilter();
  */
@@ -1778,7 +1830,7 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
     /** sets the reset filter values */
     resetFilterValues?: Filter[];
     /** The filter mapper function */
-    filterMapper?: Record<FilterEditor, React$1.ComponentType<any> | null>;
+    filterMapper?: FilterMapper;
     /** Component to render inside filters container right below main Filters widget
      *  that should contain additional controls like filters
      *  which do not fit main structure or sorting */
@@ -1788,7 +1840,7 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
  * Search and filter component
  * @example <SearchAndFilter filters={filters} filterOptions={filterOptions} onChange={onChange} onSearchChange={onSearchChange} onSearchReset={onSearchReset} totalResults={totalResults} />
  * */
-declare const SearchAndFilter: ({ filters, filterOptions, filterVisible, filterControls, viewSwitchControls, resultsContainerView, filterMapper, additionalFiltersContainer, onChange, defaultSearchTerm, onSearchChange, totalResults, allowBindingSearchTerm, resetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilter: ({ filters, filterOptions, filterVisible, filterControls, viewSwitchControls, resultsContainerView, filterMapper, additionalFiltersContainer, onChange, defaultSearchTerm, onSearchChange, totalResults, allowBindingSearchTerm, resetFilterValues, onResetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type FilterItemsProps = {
     /** The text for the add button */

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { DataVariableDefinition, DataResourceVariables, DataType, DataSourceVari
 import { Emitter } from 'mitt';
 import { TDate } from 'timeago.js';
 import * as lexical from 'lexical';
-import { SerializedEditorState, SerializedLexicalNode, Spread, DecoratorNode, NodeKey, LexicalNode, LexicalEditor, EditorState, SerializedRootNode } from 'lexical';
+import { SerializedEditorState, SerializedLexicalNode, Spread, DecoratorNode, NodeKey, DOMConversionMap, LexicalNode, LexicalEditor, EditorState, SerializedRootNode } from 'lexical';
 import { Interpolation, Theme, SerializedStyles } from '@emotion/react';
 import { InputSelectProps, IconType } from '@uniformdev/design-system';
 export { AddListButton, AddListButtonProps, Button, ButtonProps, Callout, CalloutProps, DrawerContent, Heading, HeadingProps, Input, InputComboBox, InputComboBoxProps, InputKeywordSearch, InputProps, InputSelect, InputToggle, InputToggleProps, Label, LabelProps, LoadingIndicator, LoadingOverlay, Menu, MenuItem, MenuItemProps, MenuProps, ParameterGroup, ParameterGroupProps, ParameterImage, ParameterImageInner, ParameterImageProps, ParameterInput, ParameterInputInner, ParameterInputProps, ParameterLabel, ParameterLabelProps, ParameterMenuButton, ParameterMenuButtonProps, ParameterSelect, ParameterSelectInner, ParameterSelectProps, ParameterShell, ParameterShellContext, ParameterShellProps, ParameterTextarea, ParameterTextareaInner, ParameterTextareaProps, ParameterToggle, ParameterToggleInner, ParameterToggleProps, ScrollableList, ScrollableListItem, ScrollableListItemProps, ScrollableListProps, Switch, SwitchProps, Textarea, TextareaProps, Theme, ThemeProps, useParameterShell, utilityColors } from '@uniformdev/design-system';
@@ -96,6 +96,12 @@ declare function useMeshLocation<TLocationType extends MeshLocation['type'], TLo
     type: TLocationType;
 }> | Extract<_uniformdev_mesh_sdk.AIGenerateLocation<TLocationValue>, {
     type: TLocationType;
+}> | Extract<_uniformdev_mesh_sdk.PersonalizationCriteriaLocation<TLocationValue, unknown>, {
+    type: TLocationType;
+}> | Extract<_uniformdev_mesh_sdk.DashboardToolLocation<TLocationValue, unknown>, {
+    type: TLocationType;
+}> | Extract<_uniformdev_mesh_sdk.ProjectToolLocation<TLocationValue, unknown>, {
+    type: TLocationType;
 }>, "setValue"> & {
     setValue: SetLocationValueDispatch<(Extract<_uniformdev_mesh_sdk.AssetLibraryLocation, {
         type: TLocationType;
@@ -121,6 +127,12 @@ declare function useMeshLocation<TLocationType extends MeshLocation['type'], TLo
         type: TLocationType;
     }> | Extract<_uniformdev_mesh_sdk.AIGenerateLocation<TLocationValue>, {
         type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.PersonalizationCriteriaLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.DashboardToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.ProjectToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
     }>)["value"], Parameters<(Extract<_uniformdev_mesh_sdk.AssetLibraryLocation, {
         type: TLocationType;
     }> | Extract<_uniformdev_mesh_sdk.AssetParameterLocation, {
@@ -145,6 +157,12 @@ declare function useMeshLocation<TLocationType extends MeshLocation['type'], TLo
         type: TLocationType;
     }> | Extract<_uniformdev_mesh_sdk.AIGenerateLocation<TLocationValue>, {
         type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.PersonalizationCriteriaLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.DashboardToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
+    }> | Extract<_uniformdev_mesh_sdk.ProjectToolLocation<TLocationValue, unknown>, {
+        type: TLocationType;
     }>)["setValue"]>[0]>;
 };
 type SetLocationValueDispatch<TValue, TSetValue = TValue> = (dispatch: SetLocationValueFunction<TValue, TSetValue>) => Promise<void> | void;
@@ -230,6 +248,7 @@ declare class VariableNode extends DecoratorNode<JSX.Element> {
     /** Creates the DOM wrapper that hosts the node */
     createDOM(): HTMLSpanElement;
     updateDOM(): boolean;
+    static importDOM(): DOMConversionMap | null;
     /**
      * Render the variable node using React.
      * NOTE: this is effectively an island of React, and you may not call hooks,
@@ -397,6 +416,11 @@ type VariablesPluginProps<TEditorContext = unknown> = {
     filterVariable?: SelectVariableMenuProps<TEditorContext>['filterVariable'];
     /** If true, the whole value of the editor is replaced when a variable is inserted */
     replaceValueOnVariableInsert: boolean;
+    /**
+     * Disables display names for variables; the variable's (prettified) name is used instead even if a DN exists
+     * Use this to render dynamic tokens as paths instead of bound values.
+     */
+    disableVariableDisplayNames?: boolean;
 };
 type UseVariablesMenuInput<TEditorContext> = Pick<VariablesPluginProps<TEditorContext>, 'showAddVariableMenuOption' | 'enableEditingVariables' | 'filterVariable' | 'getEditorContext'>;
 type OnVariableSelectInput = {
@@ -417,7 +441,7 @@ declare function useVariablesMenu<TEditorContext>({ showAddVariableMenuOption, e
  * Enables variables auto-complete and reference management to a Lexical editor.
  * Must also activate the VariableNode node to make this work.
  */
-declare function VariablesPlugin<TEditorContext = unknown>({ disableVariables, showAddVariableMenuOption, enableEditingVariables, getEditorContext, replaceValueOnVariableInsert, filterVariable, }: VariablesPluginProps<TEditorContext>): JSX.Element | null;
+declare function VariablesPlugin<TEditorContext = unknown>({ disableVariables, showAddVariableMenuOption, enableEditingVariables, getEditorContext, replaceValueOnVariableInsert, filterVariable, disableVariableDisplayNames, }: VariablesPluginProps<TEditorContext>): JSX.Element | null;
 
 type PasteTransformerPluginProps = {
     /**
@@ -534,6 +558,11 @@ type InputVariablesProps<TEditorContext = unknown> = {
      * any existing value on insert a new dynamic token.
      */
     singleTokenMode?: boolean;
+    /**
+     * Disables display names for variables; the variable's (prettified) name is used instead even if a DN exists
+     * Use this to render dynamic tokens as paths instead of bound values.
+     */
+    disableVariableDisplayNames?: boolean;
 } & PasteTransformerPluginProps & UseInputVariablesStateProps<TEditorContext>;
 /**
  * An input box that enables insertion of 'variables', provided by VariablesProvider,
@@ -881,7 +910,9 @@ type DataRefreshButtonProps = HTMLAttributes<HTMLButtonElement> & {
 };
 /**
  * @description The data refresh button is a UI component to indicate to users a request for data is taking place
- * @example <DataRefreshButton buttonText="my button" isLoading /> */
+ * @example <DataRefreshButton buttonText="my button" isLoading />
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const DataRefreshButton: ({ buttonText, isLoading, onRefreshData, ...props }: DataRefreshButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ObjectSearchContainerProps = {
@@ -908,7 +939,9 @@ type ObjectSearchContainerProps = {
 };
 /**
  * @description Object search container is an opinionated layout for search parameters and retrieved results
- * @example  <ObjectSearchContainer searchFilters={<>your component</>} resultList={<>your result list component<>} onSave={yourSaveAction} onCancel={yourCancelAction} /> */
+ * @example  <ObjectSearchContainer searchFilters={<>your component</>} resultList={<>your result list component<>} onSave={yourSaveAction} onCancel={yourCancelAction} />
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchContainer: ({ label, enableDynamicInputToResultId, searchFilters, resultList, children, }: ObjectSearchContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ObjectSearchFilterProps = {
@@ -939,7 +972,9 @@ type ObjectSearchFilterProps = {
 /**
  * @description Object search filter is an opinionated filter that has pre-defined query and setQuery functions
  * that can be extended with custom functions
- * @example  <ObjectSearchFilter selectOptions={[{ id: 'id value', name: 'name value'}]} /> */
+ * @example  <ObjectSearchFilter selectOptions={[{ id: 'id value', name: 'name value'}]} />
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchFilter: ({ requireContentType, typeSelectorAllTypesOptionText, searchInputName, searchInputPlaceholderText, selectLabel, selectOptions, }: ObjectSearchFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ObjectSearchFilterContainerProps = {
@@ -949,6 +984,7 @@ type ObjectSearchFilterContainerProps = {
 /**
  * @description an opinionated layout for search filters
  * @example <ObjectSearchFilterContainer label="my label"><input type="text" aria-label="my input" /></ObjectSearchFilterContainer>
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const ObjectSearchFilterContainer: ({ children }: ObjectSearchFilterContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -966,12 +1002,14 @@ type ObjectSearchResultItemProps = SelectedItemProps & {
      * @default false
      */
     disableDnD?: boolean;
+    onClick?: () => void;
 };
 /**
  * @description An opinionated result item, best used for selected results
  * @example <ObjectSearchResultItem id="my-result" title="title" />
+ * @deprecated this component is not recommended for use in new projects
  */
-declare const ObjectSearchResultItem: ({ id, title, contentType, popoverData, publishStatus, editLinkIcon, editLink, imageUrl, onRemove, createdAt, publishedAt, hideRemoveButton, disableDnD, children, }: ObjectSearchResultItemProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const ObjectSearchResultItem: ({ id, title, contentType, popoverData, publishStatus, editLinkIcon, editLink, imageUrl, onRemove, createdAt, publishedAt, hideRemoveButton, disableDnD, children, onClick, }: ObjectSearchResultItemProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type SearchQueryProps<TExtraFilters = unknown> = {
     /** sets the content type in the search context */
@@ -1049,7 +1087,13 @@ type ObjectSearchProviderProps = {
     isMulti?: boolean;
     defaultQuery?: SearchQueryProps;
 };
+/**
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchProvider: ({ currentlySelectedItems, isMulti, children, defaultQuery, }: ObjectSearchProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare function useObjectSearchContext<TExtraSearchFilters = unknown, TExtraItemProps = unknown>(): ObjectSearchContextProps<TExtraSearchFilters, TExtraItemProps>;
 
 type ObjectSearchListItemProps = SelectedItemProps & {
@@ -1071,7 +1115,9 @@ type ObjectSearchListItemProps = SelectedItemProps & {
 } & React$1.HTMLAttributes<HTMLDivElement>;
 /**
  * @description entry search list item is an opinionated UI component best used for initial retrieved results
- * @example <ObjectSearchListItem  id="my-result-item" title="title" popoverData={<p>some data info</p>}><div>example of uncontrolled content</div></ObjectSearchListItem> */
+ * @example <ObjectSearchListItem  id="my-result-item" title="title" popoverData={<p>some data info</p>}><div>example of uncontrolled content</div></ObjectSearchListItem>
+ * @deprecated this component is not recommended for use in new projects
+ */
 declare const ObjectSearchListItem: ({ id, title, contentType, imageUrl, popoverData, onSelect, isMulti, disabled, children, ...props }: ObjectSearchListItemProps & React$1.HTMLAttributes<HTMLDivElement>) => _emotion_react_jsx_runtime.JSX.Element;
 /**
  * An opinionated loading skeleton component best used with ObjectSearchListItem
@@ -1090,12 +1136,14 @@ type ObjectSearchResultItemButtonProps<THtml extends HTMLAttributes<HTMLElement>
 /**
  * @description An opinionated button component best used within the ObjectSearchResultItem component
  * @example <ObjectSearchResultItemButton text="button text" icon="/my-image.png" onClick={() => myFunction()} />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const ObjectSearchResultItemButton: ({ text, icon, ...props }: ObjectSearchResultItemButtonProps<HTMLAttributes<HTMLButtonElement>>) => _emotion_react_jsx_runtime.JSX.Element;
 /**
  * @description An opinionated link component styled the same of the ObjectSearchResultItemButton component,
  * that automatically sets the target and rel attributes. Best used within the ObjectSearchResultItem component
  * @example <LinkButton text="link text" icon="/my-image.png" />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const LinkButton: ({ text, icon, ...props }: ObjectSearchResultItemButtonProps<Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "target" | "rel">>) => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -1140,6 +1188,7 @@ type ObjectSearchResultListProps<TRenderComponent extends SelectedItemProps = Se
  * The result item component defaults to <ObjectSearchResultItem {...props} />, however this can be overridden with any other UI component and still
  * maintain drag and drop functionality
  * @example <ObjectSearchResultList id="my-id" title="title" renderResultComponent={(values) => <CustomComponent {...values} />} />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare function ObjectSearchResultList<TRenderComponent extends SelectedItemProps = SelectedItemProps>({ resultLabelText, removeButtonText, onRemoveAllSelected, hideRemoveButton, resultLabelOverride, additionalButtons, renderResultComponent, multiSelectId, disableDnD, getContainerForDnDReparenting, whenNothingSelected, }: ObjectSearchResultListProps<TRenderComponent>): _emotion_react_jsx_runtime.JSX.Element;
 
@@ -1209,6 +1258,7 @@ type QueryFilterProps<TSelectOptions extends QueryFilterSelectionOptionProps = Q
 /**
  * @description An opinionated multi query filter UI component, best used for querying product data or more complex scenarios
  * @example <QueryFilter contentTypeOptions={[{ id: 'id', name: 'name' }]} sortOptions={[{ id: 'id', name: 'name' }]} sortOrderOptions={[{ id: 'id', name: 'name' }]} />
+ * @deprecated this component is not recommended for use in new projects
  */
 declare const QueryFilter: ({ requireContentType, queryFilterTitle, contentTypeLabel, typeSelectorAllTypesOptionText, contentTypeOptions, searchInputName, searchInputPlaceholderText, searchInputLabel, countLabel, sortLabel, sortOptions, sortOrderLabel, sortOrderOptions, children, }: QueryFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -1681,6 +1731,8 @@ type SearchAndFilterProviderProps = {
     resetFilterValues?: Filter[];
     /** sets the list of filter options for each filter row */
     filterOptions: FilterOptionGroup[];
+    /** optional function that is used instead of the default reset filter functionality */
+    onResetFilterValues?: () => void;
     /** the total number of results */
     totalResults?: number;
     /** the filter mapper function */
@@ -1725,7 +1777,7 @@ declare const SearchAndFilterContext: React$1.Context<SearchAndFilterContextProp
  * Search and filter provider
  * @example <SearchAndFilterProvider filters={filters} filterOptions={filterOptions} onSearchChange={onSearchChange} onChange={onChange}>Children</SearchAndFilterProvider>
  * */
-declare const SearchAndFilterProvider: ({ filters, filterOptions, filterVisible, alwaysVisible, defaultSearchTerm, onSearchChange, onChange, resetFilterValues, totalResults, filterMapper, children, allowBindingSearchTerm, }: SearchAndFilterProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilterProvider: ({ filters, filterOptions, filterVisible, alwaysVisible, defaultSearchTerm, onSearchChange, onChange, resetFilterValues, onResetFilterValues, totalResults, filterMapper, children, allowBindingSearchTerm, }: SearchAndFilterProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
 /** Search and filter hook
  * @example const { searchTerm, setSearchTerm, filterVisibility, setFilterVisibility, filters, setFilters, handleAddFilter, handleResetFilters, handleDeleteFilter, filterOptions, validFilterQuery } = useSearchAndFilter();
  */
@@ -1778,7 +1830,7 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
     /** sets the reset filter values */
     resetFilterValues?: Filter[];
     /** The filter mapper function */
-    filterMapper?: Record<FilterEditor, React$1.ComponentType<any> | null>;
+    filterMapper?: FilterMapper;
     /** Component to render inside filters container right below main Filters widget
      *  that should contain additional controls like filters
      *  which do not fit main structure or sorting */
@@ -1788,7 +1840,7 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
  * Search and filter component
  * @example <SearchAndFilter filters={filters} filterOptions={filterOptions} onChange={onChange} onSearchChange={onSearchChange} onSearchReset={onSearchReset} totalResults={totalResults} />
  * */
-declare const SearchAndFilter: ({ filters, filterOptions, filterVisible, filterControls, viewSwitchControls, resultsContainerView, filterMapper, additionalFiltersContainer, onChange, defaultSearchTerm, onSearchChange, totalResults, allowBindingSearchTerm, resetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilter: ({ filters, filterOptions, filterVisible, filterControls, viewSwitchControls, resultsContainerView, filterMapper, additionalFiltersContainer, onChange, defaultSearchTerm, onSearchChange, totalResults, allowBindingSearchTerm, resetFilterValues, onResetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type FilterItemsProps = {
     /** The text for the add button */