Uniform Platform API

Home > @uniformdev/mesh-sdk-react

mesh-sdk-react package

Classes

Class

</th><th>

Description

</th></tr></thead> <tbody><tr><td>

VariableNode

</td><td>

Renders a variable reference node within a Lexical editor

</td></tr> </tbody></table>

Functions

Function

</th><th>

Description

</th></tr></thead> <tbody><tr><td>

$createVariableNode(variableReference, state)

</td><td>

</td></tr> <tr><td>

$isVariableNode(node)

</td><td>

</td></tr> <tr><td>

ControlledValuePlugin({ enabled, value, extraDependencies, })

</td><td>

Updates the Lexical editor state automatically when a controlled value changes, effectively turning the Lexical editor into a controlled component.

DO NOT USE THIS when actually editing with Lexical as it will cause performance problems. This is intended to be used: * To simplify a read-only "preview" editor, where the user can't edit the value * To sync an external state with the Lexical editor state under certain conditions (i.e. composer mounted, but editor hidden)

</td></tr> <tr><td>

convertConnectedDataToVariable(bindExpression, value)

</td><td>

Converts a connected data map entry to a VariablesProvider-format variable

</td></tr> <tr><td>

createLocationValidator(setValue, validate)

</td><td>

Creates a validation interceptor between useMeshLocation's setValue function and your code. You can use this utility to write cleaner validation logic for your Mesh Location UIs.

</td></tr> <tr><td>

DamSelectedItem({ selectedItem, onDeselect, onEditClosed, logoIcon, itemDetailsRendererComponent, })

</td><td>

</td></tr> <tr><td>

DataResourceDynamicInputProvider(props)

</td><td>

Wrapper for data resource locations. Provides read-only access to dynamic inputs as if they were variables, using variables-aware components (i.e. InputVariables). This simplifies building dynamic-input-aware editors, where a data resource variable could be a static value or bound to a dynamic input from the route (project map).

</td></tr> <tr><td>

DataResourceVariablesList(props)

</td><td>

Renders a list of Data Type-provided variables that can be set on a Data Resource. Intended to provide a solid base for data resource editors that need to edit a list of variables. Using the optional type attribute of variables, one can use custom components to render different variables using this component, enabling flexibility for more than just text inputs.

</td></tr> <tr><td>

DataResourceVariablesListExplicit({ setVariables, noVariables: NoVariablesComponent, typeRenderers, dataType, dynamicInputs, value, })

</td><td>

Renders a list of Data Type-provided variables that can be set on a Data Resource.

This is a version of DataResourceVariablesList that does not use any Mesh context data. For most uses you will want to use DataResourceVariablesList instead.

</td></tr> <tr><td>

DataSourceEditor({ onChange, children, editVariableComponent })

</td><td>

Wrapper for editing a data source using Uniform Mesh SDK components that rely on useRequest() or useVariables(), or custom components that use the same hooks.

</td></tr> <tr><td>

DataTypeEditor({ onChange, children, editVariableComponent })

</td><td>

Wrapper for editing a data type using Uniform Mesh SDK components that rely on useRequest() or useVariables(), or custom components that use the same hooks.

</td></tr> <tr><td>

hasReferencedVariables(value)

</td><td>

Returns true if the string expression has variable references in it

</td></tr> <tr><td>

InputVariables(props)

</td><td>

An input box that enables insertion of 'variables', provided by VariablesProvider, into its value.

</td></tr> <tr><td>

ObjectSearchResultList({ resultLabelText, removeButtonText, onRemoveAllSelected, hideRemoveButton, resultLabelOverride, additionalButtons, renderResultComponent, multiSelectId, disableDnD, getContainerForDnDReparenting, whenNothingSelected, })

</td><td>

An opinionated result list UI component that has built in drag and drop functionality and removal of all selected items from context. The result item component defaults to <, however this can be overridden with any other UI component and still maintain drag and drop functionality

</td></tr> <tr><td>

ParameterConnectionIndicator({ children, value, menuOptions, disabled, menuTooltip, })

</td><td>

An input box that enables insertion of 'variables', provided by VariablesProvider, into its value. Designed specifically for use in the Canvas Parameter Editor.

</td></tr> <tr><td>

ParameterOrSingleVariable(props)

</td><td>

A parameter which can be one of a custom parameter editor (inputWhenNoVariables), or one single variable value (not multiple). Use for parameters which can only have one variable value, possibly because they bind to objects or arrays. Designed visually for use in the Canvas Parameter Editor.

</td></tr> <tr><td>

ParameterVariables(props)

</td><td>

An input box that enables insertion of 'variables', provided by VariablesProvider, into its value. Designed visually for use in the Canvas Parameter Editor.

</td></tr> <tr><td>

ParamTypeDynamicDataProvider(props)

</td><td>

</td></tr> <tr><td>

prettifyBindExpression(bindExpression)

</td><td>

</td></tr> <tr><td>

ProductSearch({ selectedProducts, setSelectedProducts, onGetCategories, onSearchProducts, logoIcon, multiSelect, multiSelectId, selectedItemComponent, rowComponent, errorComponent, helpComponent, noResultsComponent, onSort, typeSelectorAllTypesOptionText, typeSelectorLabel, })

</td><td>

</td></tr> <tr><td>

ProductSearchRow({ result, isSelected, triggerSelection, })

</td><td>

</td></tr> <tr><td>

ProductSelectedItem({ selectedItem, onDeselect, })

</td><td>

</td></tr> <tr><td>

RequestBody()

</td><td>

Editor component to let you write a request body for POST requests

</td></tr> <tr><td>

RequestHeaders({ disableVariables, addOmitIfEmpty, })

</td><td>

Editor component to manage HTTP headers on a request

</td></tr> <tr><td>

RequestMethodSelect(props)

</td><td>

Dropdown to pick a HTTP method for a request

</td></tr> <tr><td>

RequestParameters({ disableVariables, addOmitIfEmpty, })

</td><td>

Component to manage query parameters on a request

</td></tr> <tr><td>

RequestProvider({ value, onChange, children })

</td><td>

Provides a mutable HTTP request object context. Components such as RequestBody and RequestUrl use this context to render.

</td></tr> <tr><td>

RequestUrl()

</td><td>

Displays the current full URL of the request, including the base URL if one is set

</td></tr> <tr><td>

RequestUrlInput(props)

</td><td>

Editor to modify the current URL of the request Note: entering query string parameters automatically converts them and syncs the request state with them

</td></tr> <tr><td>

serializeVariablesEditorState(editorState)

</td><td>

Serializes a Lexical variables-editor state (as a Lexical AST) to a Uniform-variable-reference formatted string Note: if no content is in the editor state, undefined will be returned.

</td></tr> <tr><td>

setVariablesEditorValue(editor, newValue)

</td><td>

Programmatically sets the current value of a variables editor after it has already initialized and become an uncontrolled component. Passing the editorRef prop to the component will give a reference to editor, or use ControlledValuePlugin to manage this automatically.

If newValue is undefined, the editor will be set to an empty state. If newValue is a string, it will be treated as a variable-reference-containing string, and parsed to a Lexical AST If newValue is a serialized Lexical AST, it will be used as-is. If the AST is invalid, the editor will be set to an empty state.

</td></tr> <tr><td>

TextVariableRenderer({ definition, value, setValue })

</td><td>

Default data resource variable renderer, uses a text input that supports dynamic input binding

</td></tr> <tr><td>

urlEncodeRequestParameter(parameter, varValues)

</td><td>

</td></tr> <tr><td>

urlEncodeRequestUrl(url, varValues)

</td><td>

</td></tr> <tr><td>

useConnectedDataAsVariables(connectedData)

</td><td>

Converts connected data map into VariablesProvider-format variables

</td></tr> <tr><td>

useContentDataResourceLocaleInfo({ locale, setLocale, dynamicInputs, })

</td><td>

</td></tr> <tr><td>

useDynamicInputsAsVariables(dynamicInputs)

</td><td>

Converts dynamic inputs into VariablesProvider-format variables

</td></tr> <tr><td>

useMeshLocation(expectedLocation)

</td><td>

Provides convenient access to the current Uniform Mesh location via React hook. Intended to be used within <MeshApp />.

There are three primary ways to invoke this hook: 1. Without any arguments, this hook will return the current location regardless of its type. The result will be a union of all possible locations you can discriminate between i.e. with an if statement on the type const location = useMeshLocation(); if (location.type === 'paramType') { // location is now known to be a paramType } 2. With a string argument, this hook will assert that the current location is the expected one and return the correct typings for that location. const location = useMeshLocation('settings'); 3. With an explicit generic to set the expected param type data or param type settings data. This is useful because (2) will return unknown as the value type for param types. const location = useMeshLocation();

You can also combine (2) and (3) to get both explicit value typing and assertion of the location.

</td></tr> <tr><td>

useObjectSearchContext()

</td><td>

</td></tr> <tr><td>

useRequest()

</td><td>

</td></tr> <tr><td>

useRequestHeader(headerName)

</td><td>

Hook to make it simple to read and write a specific request header by name, instead of supporting multiple values in an array like native dispatch.

NOTE: if multiple values are added for the named header, this hook will bind to the FIRST instance of the header and leave the other values alone.

</td></tr> <tr><td>

useRequestParameter(paramName)

</td><td>

Hook to make it simple to read and write a specific request query string parameter by name, instead of supporting multiple values in an array like native dispatch.

NOTE: if multiple values are added for the named parameter, this hook will bind to the FIRST instance of the parameter and leave the other values alone.

</td></tr> <tr><td>

useUniformMeshSdk()

</td><td>

Provides convenient access to the current Uniform Mesh SDK instance via React hook. Intended to be used within <MeshApp />.

</td></tr> <tr><td>

useVariableEditor()

</td><td>

</td></tr> <tr><td>

useVariables(returnEmptyWithoutProvider)

</td><td>

</td></tr> <tr><td>

useVariablesMenu({ showAddVariableMenuOption, enableEditingVariables, filterVariable, getEditorContext, })

</td><td>

Hook to use the lexical variables typeahead/dropdown menu

</td></tr> <tr><td>

variableDefaultTextValue(defaultValue)

</td><td>

</td></tr> <tr><td>

VariableEditor({ variable, onSubmit, onCancel, showDisplayName, disableMeshTip, })

</td><td>

</td></tr> <tr><td>

VariablesList()

</td><td>

</td></tr> <tr><td>

VariablesPlugin({ disableVariables, showAddVariableMenuOption, enableEditingVariables, getEditorContext, replaceValueOnVariableInsert, filterVariable, })

</td><td>

Enables variables auto-complete and reference management to a Lexical editor. Must also activate the VariableNode node to make this work.

</td></tr> <tr><td>

VariablesProvider({ value, onChange, editVariableComponent, readOnly, isLoading, children, knownUndefinedValues, })

</td><td>

</td></tr> <tr><td>

variablesToGroupedList(variables, filterFn, context)

</td><td>

Groups variable definitions by their source property, and sorts the groups using variablesToList. Returns a flat list of groups and variables. Groups are sorted alphabetically.

</td></tr> <tr><td>

variablesToList(variables)

</td><td>

Converts variable definitions stored in a map into a flat list, respecting their order property if set, and sorting by display name otherwise.

</td></tr> </tbody></table>

Interfaces

Interface

</th><th>

Description

</th></tr></thead> <tbody><tr><td>

Brand

</td><td>

</td></tr> <tr><td>

DamItem

</td><td>

</td></tr> <tr><td>

DamSelectedItemProps

</td><td>

</td></tr> <tr><td>

EntrySearchContentType

</td><td>

</td></tr> <tr><td>

EntrySearchResult

</td><td>

</td></tr> <tr><td>

EntrySearchRowProps

</td><td>

</td></tr> <tr><td>

EntrySearchSelectedItemProps

</td><td>

</td></tr> <tr><td>

GetProductOptions

</td><td>

</td></tr> <tr><td>

NoResultsProps

</td><td>

</td></tr> <tr><td>

ProductCategory

</td><td>

</td></tr> <tr><td>

ProductDynamicSelectorValue

</td><td>

</td></tr> <tr><td>

ProductQueryCategory

</td><td>

</td></tr> <tr><td>

ProductQueryContextValue

</td><td>

</td></tr> <tr><td>

ProductQueryProps

</td><td>

</td></tr> <tr><td>

ProductSearchContextValue

</td><td>

</td></tr> <tr><td>

ProductSearchResults

</td><td>

</td></tr> </tbody></table>

Namespaces

Namespace

</th><th>

Description

</th></tr></thead> <tbody><tr><td>

Icons

</td><td>

</td></tr> </tbody></table>

Variables

Variable

</th><th>

Description

</th></tr></thead> <tbody><tr><td>

badgeIcon

</td><td>

</td></tr> <tr><td>

bindableFiltersMapper

</td><td>

</td></tr> <tr><td>

damSelectedItemContainer

</td><td>

</td></tr> <tr><td>

damSelectedItemCopy

</td><td>

</td></tr> <tr><td>

damSelectedItemDetails

</td><td>

</td></tr> <tr><td>

damSelectedItemIcon

</td><td>

</td></tr> <tr><td>

damSelectedItemInfoBtn

</td><td>

</td></tr> <tr><td>

damSelectedItemInner

</td><td>

</td></tr> <tr><td>

damSelectedItemLinkBtn

</td><td>

</td></tr> <tr><td>

damSelectedItemLinkContainer

</td><td>

</td></tr> <tr><td>

damSelectedItemMediaContainer

</td><td>

</td></tr> <tr><td>

damSelectedItemPopover

</td><td>

</td></tr> <tr><td>

damSelectedItemPopoverLabel

</td><td>

</td></tr> <tr><td>

damSelectedItemSmallText

</td><td>

</td></tr> <tr><td>

damSelectedItemTitle

</td><td>

</td></tr> <tr><td>

damSelectItemImage

</td><td>

</td></tr> <tr><td>

DataRefreshButton

</td><td>

The data refresh button is a UI component to indicate to users a request for data is taking place

</td></tr> <tr><td>

DefaultSearchRow

</td><td>

</td></tr> <tr><td>

DefaultSelectedItem

</td><td>

</td></tr> <tr><td>

DISCONNECT_VARIABLE_COMMAND

</td><td>

Disconnects a variable node from its binding, leaving the current value of the binding behind

</td></tr> <tr><td>

draggableContainer

</td><td>

</td></tr> <tr><td>

draggableIcon

</td><td>

</td></tr> <tr><td>

draggableIconOffset

</td><td>

</td></tr> <tr><td>

draggableIconWrapper

</td><td>

</td></tr> <tr><td>

EDIT_VARIABLE_COMMAND

</td><td>

Opens the variable editor for an existing variable node

</td></tr> <tr><td>

EntrySearch

</td><td>

</td></tr> <tr><td>

entrySearchBtn

</td><td>

</td></tr> <tr><td>

entrySearchConfig

</td><td>

</td></tr> <tr><td>

entrySearchConfigHidden

</td><td>

</td></tr> <tr><td>

entrySearchLoadMoreBtn

</td><td>

</td></tr> <tr><td>

entrySearchResultList

</td><td>

</td></tr> <tr><td>

entrySearchSelectIcon

</td><td>

</td></tr> <tr><td>

entrySearchSelectImg

</td><td>

</td></tr> <tr><td>

entrySearchSelectInput

</td><td>

</td></tr> <tr><td>

entrySearchSelectOption

</td><td>

</td></tr> <tr><td>

entrySearchWrapper

</td><td>

</td></tr> <tr><td>

INSERT_VARIABLE_COMMAND

</td><td>

Inserts a new variable node at the current selection, or replacing a specific node key

</td></tr> <tr><td>

LinkButton

</td><td>

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

</td></tr> <tr><td>

MeshApp

</td><td>

</td></tr> <tr><td>

ObjectSearchContainer

</td><td>

Object search container is an opinionated layout for search parameters and retrieved results

</td></tr> <tr><td>

ObjectSearchFilter

</td><td>

Object search filter is an opinionated filter that has pre-defined query and setQuery functions that can be extended with custom functions

</td></tr> <tr><td>

ObjectSearchFilterContainer

</td><td>

an opinionated layout for search filters

</td></tr> <tr><td>

ObjectSearchListItem

</td><td>

entry search list item is an opinionated UI component best used for initial retrieved results

</td></tr> <tr><td>

ObjectSearchListItemLoadingSkeleton

</td><td>

An opinionated loading skeleton component best used with ObjectSearchListItem

</td></tr> <tr><td>

ObjectSearchProvider

</td><td>

</td></tr> <tr><td>

ObjectSearchResultItem

</td><td>

An opinionated result item, best used for selected results

</td></tr> <tr><td>

ObjectSearchResultItemButton

</td><td>

An opinionated button component best used within the ObjectSearchResultItem component

</td></tr> <tr><td>

OPEN_INSERT_VARIABLE_COMMAND

</td><td>

Opens the variable editor and when a result is selected, inserts it at the current cursor location NOTE: differs from INSERT_VARIABLE_COMMAND because this opens a variable picker, and that command inserts a known variable reference with no picker.

</td></tr> <tr><td>

productedSelectedItemLinkBtn

</td><td>

</td></tr> <tr><td>

productedSelectedItemSmallText

</td><td>

</td></tr> <tr><td>

ProductPreviewList

</td><td>

</td></tr> <tr><td>

ProductQuery

</td><td>

</td></tr> <tr><td>

ProductQueryContext

</td><td>

</td></tr> <tr><td>

ProductSearchContext

</td><td>

</td></tr> <tr><td>

productSearchRowActiveIcon

</td><td>

</td></tr> <tr><td>

productSearchRowCategory

</td><td>

</td></tr> <tr><td>

productSearchRowContainer

</td><td>

</td></tr> <tr><td>

productSearchRowContent

</td><td>

</td></tr> <tr><td>

productSearchRowContentActive

</td><td>

</td></tr> <tr><td>

productSearchRowDetails

</td><td>

</td></tr> <tr><td>

productSearchRowTitle

</td><td>

</td></tr> <tr><td>

productSelectedItemContainer

</td><td>

</td></tr> <tr><td>

productSelectedItemContent

</td><td>

</td></tr> <tr><td>

productSelectedItemDetails

</td><td>

</td></tr> <tr><td>

productSelectedItemIcon

</td><td>

</td></tr> <tr><td>

productSelectedItemImage

</td><td>

</td></tr> <tr><td>

productSelectedItemLinkContainer

</td><td>

</td></tr> <tr><td>

QueryFilter

</td><td>

An opinionated multi query filter UI component, best used for querying product data or more complex scenarios

</td></tr> <tr><td>

RequestTypeContainer

</td><td>

a container to layout content in a 2 column grid format = 12ch 1fr

</td></tr> <tr><td>

ResolvableLoadingValue

</td><td>

</td></tr> <tr><td>

searchRowBtn

</td><td>

</td></tr> <tr><td>

searchRowContainer

</td><td>

</td></tr> <tr><td>

searchRowContainerActive

</td><td>

</td></tr> <tr><td>

searchRowContainerWithPopover

</td><td>

</td></tr> <tr><td>

searchRowPopover

</td><td>

</td></tr> <tr><td>

searchRowText

</td><td>

</td></tr> <tr><td>

searchRowTextSmall

</td><td>

</td></tr> <tr><td>

selectedItemContainer

</td><td>

</td></tr> <tr><td>

selectedItemCopy

</td><td>

</td></tr> <tr><td>

selectedItemDetails

</td><td>

</td></tr> <tr><td>

selectedItemIcon

</td><td>

</td></tr> <tr><td>

selectedItemInner

</td><td>

</td></tr> <tr><td>

selectedItemTitle

</td><td>

</td></tr> <tr><td>

SelectionField

</td><td>

</td></tr> <tr><td>

selectItemLinkBtn

</td><td>

</td></tr> <tr><td>

selectItemLinkContainer

</td><td>

</td></tr> <tr><td>

selectItemPopover

</td><td>

</td></tr> <tr><td>

selectItemPopoverLabel

</td><td>

</td></tr> <tr><td>

selectItemSmallText

</td><td>

</td></tr> <tr><td>

useProductQueryContext

</td><td>

</td></tr> <tr><td>

useProductSearchContext

</td><td>

</td></tr> <tr><td>

variablePrefix

</td><td>

Expected prefix for variable expressions

</td></tr> <tr><td>

variableSuffix

</td><td>

Expected suffix for variable expressions

</td></tr> </tbody></table>

Type Aliases

Type Alias

</th><th>

Description

</th></tr></thead> <tbody><tr><td>

BaseRequestData

</td><td>

</td></tr> <tr><td>

ContentDataResourceLocaleInfoProps

</td><td>

</td></tr> <tr><td>

ContentDataResourceLocaleInfoResult

</td><td>

</td></tr> <tr><td>

DataRefreshButtonProps

</td><td>

</td></tr> <tr><td>

DataResourceDynamicInputProviderProps

</td><td>

</td></tr> <tr><td>

DataResourceVariableRendererProps

</td><td>

</td></tr> <tr><td>

DataResourceVariablesListProps

</td><td>

</td></tr> <tr><td>

DataSourceEditorProps

</td><td>

</td></tr> <tr><td>

DataTypeEditorProps

</td><td>

</td></tr> <tr><td>

DataVariableDefinitionWithName

</td><td>

</td></tr> <tr><td>

DisconnectVariableCommandArguments

</td><td>

</td></tr> <tr><td>

DispatchResult

</td><td>

</td></tr> <tr><td>

EditVariableCommandArguments

</td><td>

</td></tr> <tr><td>

EntrySearchProps

</td><td>

</td></tr> <tr><td>

EntrySearchQueryOptions

</td><td>

</td></tr> <tr><td>

GetProductsOptions

</td><td>

</td></tr> <tr><td>

InputVariablesProps

</td><td>

</td></tr> <tr><td>

InsertVariableCommandArguments

</td><td>

</td></tr> <tr><td>

ItemListProps

</td><td>

</td></tr> <tr><td>

KnownUndefinedVariableInfo

</td><td>

Provides information for an undefined variable that might be referenced in data, but is undefined in the variables context due to some sort of error or informational message.

If an undefined variable matches one of these, the error or info message will be shown instead of the generic "undefined variable" message.

</td></tr> <tr><td>

MeshAppProps

</td><td>

</td></tr> <tr><td>

MeshDataVariableDefinition

</td><td>

</td></tr> <tr><td>

ObjectSearchContainerProps

</td><td>

</td></tr> <tr><td>

ObjectSearchContextProps