@uniformdev/mesh-sdk-react 20.50.2-alpha.2 → 20.50.2-alpha.77

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import * as _emotion_react_jsx_runtime from '@emotion/react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { SVGProps, ReactNode, MutableRefObject, ComponentType, PropsWithChildren, HTMLAttributes, AnchorHTMLAttributes, ButtonHTMLAttributes } from 'react';
 import * as _uniformdev_mesh_sdk from '@uniformdev/mesh-sdk';
-import { DynamicInputs, MeshLocation, SetValueOptions, EditConnectedDataResponseCancellationContext, DataSourceLocationValue, DataTypeLocationValue, BindableTypes } from '@uniformdev/mesh-sdk';
+import { DynamicInputs, MeshLocation, SetValueOptions, EditConnectedDataResponseCancellationContext, DataSourceLocationValue, DataTypeLocationValue, UniformMeshSDK, BindableTypes } from '@uniformdev/mesh-sdk';
 export * from '@uniformdev/mesh-sdk';
 import { DataVariableDefinition, DataResourceVariables, DataType, DataSourceVariantsKeys } from '@uniformdev/canvas';
 import { Emitter } from 'mitt';
@@ -892,6 +892,100 @@ type DataTypeEditorProps = PropsWithChildren<{
  */
 declare function DataTypeEditor({ onChange, children, editVariableComponent }: DataTypeEditorProps): _emotion_react_jsx_runtime.JSX.Element;
 
+/**
+ * Status of the delegation session as seen from the React provider.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+type DelegationStatus = 'idle' | 'acquiring' | 'active' | 'disabled' | 'error';
+/**
+ * Value provided by DelegationProvider via React context.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+interface DelegationContextValue {
+    status: DelegationStatus;
+    error: Error | null;
+    reacquire: () => void;
+}
+/** @deprecated This beta identity delegation API may change with breaking changes. */
+declare const DelegationContext: React$1.Context<DelegationContextValue | null>;
+
+/**
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+interface DelegationGateProps {
+    children: React__default.ReactNode;
+    /** Shown while delegation is starting. Omit to use the default loading UI. */
+    loadingComponent?: React__default.ReactNode;
+    /** Shown when identity delegation is not enabled for this integration. Omit to use the default callout. */
+    disabledComponent?: React__default.ReactNode;
+    /** Shown when delegation fails. Omit to use the default error callout. */
+    errorComponent?: React__default.ReactNode | ((props: {
+        error: Error;
+    }) => React__default.ReactNode);
+}
+/**
+ * Renders children only when the delegation session is active.
+ * Shows appropriate fallback UI for loading, disabled, and error states.
+ *
+ * Sensible defaults use the design system (loading overlay, callouts). Pass `loadingComponent`,
+ * `disabledComponent`, or `errorComponent` to customize; pass `null` to render nothing for that state.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+declare function DelegationGate({ children, loadingComponent, disabledComponent, errorComponent, }: DelegationGateProps): _emotion_react_jsx_runtime.JSX.Element | null;
+
+/**
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+interface DelegationProviderProps {
+    /** `UniformMeshSDK` instance obtained from `useUniformMeshSdk()`. */
+    sdk: UniformMeshSDK;
+    /**
+     * Called with the session token to exchange it for a delegation token on your backend.
+     * Resolve on success, throw on failure.
+     */
+    onSessionToken: (sessionToken: string) => Promise<void>;
+    /**
+     * Called to check if a delegation session is already active (e.g. a valid cookie exists).
+     * Return `true` to skip the session-token exchange.
+     */
+    checkActive: () => Promise<boolean>;
+    /**
+     * When `true`, re-checks the delegation session after the tab becomes visible again
+     * following a period of being hidden. If the server reports the session is no longer
+     * active (e.g. the access token expired and the refresh token is gone/invalid), the
+     * full session-token exchange is re-run; otherwise the check is silent and does not
+     * flip the status back to `acquiring`.
+     *
+     * Defaults to `true`.
+     */
+    revalidateOnFocus?: boolean;
+    /**
+     * Minimum number of milliseconds the tab must have been hidden before a
+     * `revalidateOnFocus` check runs. Prevents hammering the server on rapid tab
+     * switches. Defaults to 5 minutes.
+     */
+    revalidateAfterMs?: number;
+    children: React__default.ReactNode;
+}
+/**
+ * Manages the identity delegation lifecycle: checks for an existing session, acquires a
+ * session token from the dashboard parent if needed, and delegates exchange to the caller.
+ *
+ * Should ONLY be used to wrap locations which actually needed delegation and not the entire app like <MeshApp />.
+ *
+ * Also handles stale-session recovery: when the tab becomes visible again after being
+ * hidden for longer than `revalidateAfterMs`, the provider silently re-checks via
+ * `checkActive` and re-runs the session exchange only if the server says the session is
+ * no longer active. This covers the "returned after a long time" case where the stored
+ * access token has expired and the refresh token is also gone or no longer valid.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+declare function DelegationProvider({ sdk, onSessionToken, checkActive, revalidateOnFocus, revalidateAfterMs, children, }: DelegationProviderProps): _emotion_react_jsx_runtime.JSX.Element;
+
 type MeshAppProps = {
     loadingComponent?: React__default.ComponentType;
     errorComponent?: React__default.ComponentType<{
@@ -1555,7 +1649,7 @@ type FilterEditorRendererProps<TValue extends string | string[]> = Pick<FilterOp
 };
 
 /** a list of possible operator values that sync with uniform search api */
-type OperatorValue = 'eq' | 'sys-date-eq' | 'neq' | 'gt' | 'sys-date-gt' | 'gte' | 'sys-date-gte' | 'lt' | 'sys-date-lt' | 'lte' | 'sys-date-lte' | 'in' | 'nin' | 'between' | 'sys-date-between' | 'ndef' | 'def' | 'match' | 'starts' | 'checked' | 'nchecked';
+type OperatorValue = 'eq' | 'sys-date-eq' | 'neq' | 'gt' | 'sys-date-gt' | 'gte' | 'sys-date-gte' | 'lt' | 'sys-date-lt' | 'lte' | 'sys-date-lte' | 'in' | 'nin' | 'all' | 'between' | 'sys-date-between' | 'ndef' | 'def' | 'match' | 'starts' | 'checked' | 'nchecked';
 type OperatorValueType = {
     value: OperatorValue;
 };
@@ -1742,6 +1836,8 @@ type SearchAndFilterProviderProps = {
     onResetFilterValues?: () => void;
     /** the total number of results */
     totalResults?: number;
+    /** whether data is currently loading */
+    isLoading?: boolean;
     /** the filter mapper function */
     filterMapper?: FilterMapper;
     /** sets child components giving access to useSearchAndFilter context */
@@ -1776,6 +1872,8 @@ type SearchAndFilterContextProps = {
     filterMapper?: FilterMapper;
     /** the total number of results */
     totalResults?: number;
+    /** whether data is currently loading */
+    isLoading?: boolean;
     /** Allow to bind dynamic inputs to the search term */
     allowBindingSearchTerm?: boolean;
 };
@@ -1784,7 +1882,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, onResetFilterValues, totalResults, filterMapper, children, allowBindingSearchTerm, }: SearchAndFilterProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilterProvider: ({ filters, filterOptions, filterVisible, alwaysVisible, defaultSearchTerm, onSearchChange, onChange, resetFilterValues, onResetFilterValues, totalResults, isLoading, 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();
  */
@@ -1815,6 +1913,8 @@ declare const useSearchAndFilter: () => {
     filterMapper?: FilterMapper;
     /** the total number of results */
     totalResults?: number;
+    /** whether data is currently loading */
+    isLoading?: boolean;
     /** Allow to bind dynamic inputs to the search term */
     allowBindingSearchTerm?: boolean;
 };
@@ -1830,6 +1930,8 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
     viewSwitchControls?: React$1.ReactNode;
     /** The number of total results */
     totalResults?: number;
+    /** Whether data is currently loading */
+    isLoading?: boolean;
     /** The results container view
      * @default '<SearchAndFilterResultContainer />'
      */
@@ -1847,7 +1949,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, onResetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilter: ({ filters, filterOptions, filterVisible, filterControls, viewSwitchControls, resultsContainerView, filterMapper, additionalFiltersContainer, onChange, defaultSearchTerm, onSearchChange, totalResults, isLoading, allowBindingSearchTerm, resetFilterValues, onResetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type FilterItemsProps = {
     /** The text for the add button */
@@ -1957,6 +2059,14 @@ declare const SortItems: ({ sortByLabel, localeLabel, sortOptions, sortByValue,
 /** Converts connected data map into VariablesProvider-format variables */
 declare function useConnectedDataAsVariables(connectedData: Record<string, unknown> | undefined): Record<string, MeshDataVariableDefinition>;
 
+/**
+ * Returns the current delegation session state.
+ * Must be used within a `DelegationProvider`.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+declare function useDelegation(): DelegationContextValue;
+
 /** Converts dynamic inputs into VariablesProvider-format variables */
 declare function useDynamicInputsAsVariables(dynamicInputs: DynamicInputs): Record<string, MeshDataVariableDefinition>;
 
@@ -2007,4 +2117,4 @@ type ContentDataResourceLocaleInfoProps = {
 };
 declare function useContentDataResourceLocaleInfo({ locale, defaultLocale, setLocale, dynamicInputs, }: ContentDataResourceLocaleInfoProps): ContentDataResourceLocaleInfoResult;
 
-export { $createVariableNode, $isVariableNode, type BadgeThemeProps, type BaseRequestData, CHECKBOX_OPERATORS, type ContentDataResourceLocaleInfoProps, type ContentDataResourceLocaleInfoResult, ControlledValuePlugin, DATE_OPERATORS, DATE_TIME_OPERATORS, DISCONNECT_VARIABLE_COMMAND, DataRefreshButton, type DataRefreshButtonProps, DataResourceDynamicInputProvider, type DataResourceDynamicInputProviderProps, type DataResourceVariableRendererProps, DataResourceVariablesList, DataResourceVariablesListExplicit, type DataResourceVariablesListProps, DataSourceEditor, type DataSourceEditorProps, DataTypeEditor, type DataTypeEditorProps, type DataVariableDefinitionWithName, DateEditor, DateRangeEditor, type DisconnectVariableCommandArguments, type DispatchResult, EDIT_VARIABLE_COMMAND, type EditVariableCommandArguments, type Filter, FilterButton, type FilterButtonProps, FilterControls, type FilterEditor, FilterEditorRenderer, type FilterEditorRendererProps, FilterItem, type FilterItemProps, FilterItems, type FilterItemsProps, type FilterMapper, FilterMenu, FilterMultiChoiceEditor, type FilterOption, type FilterOptionGroup, type FilterOptionLeftHandComponentProps, FilterSingleChoiceEditor, type FiltersProps, INSERT_VARIABLE_COMMAND, index as Icons, type InputOption, type InputOptionGroup, type InputOptionValue, InputVariables, type InputVariablesProps, type InsertVariableCommandArguments, type ItemListProps, type KnownUndefinedVariableInfo, type KnownUndefinedVariableInfoWithName, LinkButton, MULTI_SELECT_OPERATORS, MeshApp, type MeshAppProps, type MeshDataVariableDefinition, NUMBER_OPERATORS, NumberEditor, NumberRangeEditor, OPEN_INSERT_VARIABLE_COMMAND, OPTIONAL_SYSTEM_FIELD_OPERATORS, ObjectSearchContainer, type ObjectSearchContainerProps, type ObjectSearchContextProps, ObjectSearchFilter, ObjectSearchFilterContainer, type ObjectSearchFilterContainerProps, type ObjectSearchFilterProps, ObjectSearchListItem, ObjectSearchListItemLoadingSkeleton, type ObjectSearchListItemProps, ObjectSearchProvider, type ObjectSearchProviderProps, ObjectSearchResultItem, ObjectSearchResultItemButton, type ObjectSearchResultItemButtonProps, type ObjectSearchResultItemProps, ObjectSearchResultList, type ObjectSearchResultListProps, type Operator, type OperatorType, type OperatorValue, type OperatorValueType, PUBLISH_STATUS_FIELD_OPERATORS, ParamTypeDynamicDataProvider, type ParamTypeDynamicDataProviderProps, type ParameterConnectOptions, ParameterConnectionIndicator, type ParameterConnectionIndicatorProps, ParameterOrSingleVariable, type ParameterOrSingleVariableProps, ParameterVariables, type ParameterVariablesProps, QueryFilter, type QueryFilterProps, type QueryFilterSearchProps, RICHTEXT_OPERATORS, type RequestAction, type RequestActionContext, RequestBody, type RequestContext, type RequestData, RequestHeaders, RequestMethodSelect, type RequestParameter, RequestParameters, type RequestParametersProps, RequestProvider, type RequestProviderProps, RequestTypeContainer, type RequestTypeContainerProps, RequestUrl, RequestUrlInput, SELECT_OPERATORS, SYSTEM_FIELD_OPERATORS, SearchAndFilter, SearchAndFilterContext, type SearchAndFilterContextProps, SearchAndFilterOptionsContainer, type SearchAndFilterOptionsContainerProps, type SearchAndFilterProps, SearchAndFilterProvider, type SearchAndFilterProviderProps, SearchAndFilterResultContainer, type SearchAndFilterResultContainerProps, SearchOnlyContext, SearchOnlyFilter, type SearchOnlyProviderProps, type SearchQueryProps, type SelectedItemProps, type SerializedVariableNode, type SetLocationValueDispatch, type SetLocationValueFunction, SortItems, type SortItemsProps, StatusMultiEditor, StatusSingleEditor, TEXTBOX_OPERATORS, TextEditor, TextMultiChoiceEditor, TextVariableRenderer, USER_OPERATORS, type UseVariablesMenu, type UseVariablesMenuInput, VariableChip, VariableEditor, type VariableEditorCompleteEvent, type VariableEditorProps, VariableNode, type VariableNodeState, type VariableSourceGroup, type VariablesAction, type VariablesContext, type VariablesEvents, VariablesList, VariablesPlugin, type VariablesPluginProps, VariablesProvider, type VariablesProviderProps, bindableFiltersMapper, convertConnectedDataToVariable, createLocationValidator, filterMapper, prettifyBindExpression, readOnlyAttributes, serializeVariablesEditorSerializedState, serializeVariablesEditorState, setVariablesEditorValue, urlEncodeRequestParameter, urlEncodeRequestUrl, useConnectedDataAsVariables, useContentDataResourceLocaleInfo, useDynamicInputsAsVariables, useMeshLocation, useObjectSearchContext, useRequest, useRequestHeader, useRequestParameter, useSearchAndFilter, useUniformMeshSdk, useVariableEditor, useVariables, useVariablesMenu, variableDefaultTextValue, variablePrefix, variableSuffix, variablesToGroupedList, variablesToList };
+export { $createVariableNode, $isVariableNode, type BadgeThemeProps, type BaseRequestData, CHECKBOX_OPERATORS, type ContentDataResourceLocaleInfoProps, type ContentDataResourceLocaleInfoResult, ControlledValuePlugin, DATE_OPERATORS, DATE_TIME_OPERATORS, DISCONNECT_VARIABLE_COMMAND, DataRefreshButton, type DataRefreshButtonProps, DataResourceDynamicInputProvider, type DataResourceDynamicInputProviderProps, type DataResourceVariableRendererProps, DataResourceVariablesList, DataResourceVariablesListExplicit, type DataResourceVariablesListProps, DataSourceEditor, type DataSourceEditorProps, DataTypeEditor, type DataTypeEditorProps, type DataVariableDefinitionWithName, DateEditor, DateRangeEditor, DelegationContext, type DelegationContextValue, DelegationGate, type DelegationGateProps, DelegationProvider, type DelegationProviderProps, type DelegationStatus, type DisconnectVariableCommandArguments, type DispatchResult, EDIT_VARIABLE_COMMAND, type EditVariableCommandArguments, type Filter, FilterButton, type FilterButtonProps, FilterControls, type FilterEditor, FilterEditorRenderer, type FilterEditorRendererProps, FilterItem, type FilterItemProps, FilterItems, type FilterItemsProps, type FilterMapper, FilterMenu, FilterMultiChoiceEditor, type FilterOption, type FilterOptionGroup, type FilterOptionLeftHandComponentProps, FilterSingleChoiceEditor, type FiltersProps, INSERT_VARIABLE_COMMAND, index as Icons, type InputOption, type InputOptionGroup, type InputOptionValue, InputVariables, type InputVariablesProps, type InsertVariableCommandArguments, type ItemListProps, type KnownUndefinedVariableInfo, type KnownUndefinedVariableInfoWithName, LinkButton, MULTI_SELECT_OPERATORS, MeshApp, type MeshAppProps, type MeshDataVariableDefinition, NUMBER_OPERATORS, NumberEditor, NumberRangeEditor, OPEN_INSERT_VARIABLE_COMMAND, OPTIONAL_SYSTEM_FIELD_OPERATORS, ObjectSearchContainer, type ObjectSearchContainerProps, type ObjectSearchContextProps, ObjectSearchFilter, ObjectSearchFilterContainer, type ObjectSearchFilterContainerProps, type ObjectSearchFilterProps, ObjectSearchListItem, ObjectSearchListItemLoadingSkeleton, type ObjectSearchListItemProps, ObjectSearchProvider, type ObjectSearchProviderProps, ObjectSearchResultItem, ObjectSearchResultItemButton, type ObjectSearchResultItemButtonProps, type ObjectSearchResultItemProps, ObjectSearchResultList, type ObjectSearchResultListProps, type Operator, type OperatorType, type OperatorValue, type OperatorValueType, PUBLISH_STATUS_FIELD_OPERATORS, ParamTypeDynamicDataProvider, type ParamTypeDynamicDataProviderProps, type ParameterConnectOptions, ParameterConnectionIndicator, type ParameterConnectionIndicatorProps, ParameterOrSingleVariable, type ParameterOrSingleVariableProps, ParameterVariables, type ParameterVariablesProps, QueryFilter, type QueryFilterProps, type QueryFilterSearchProps, RICHTEXT_OPERATORS, type RequestAction, type RequestActionContext, RequestBody, type RequestContext, type RequestData, RequestHeaders, RequestMethodSelect, type RequestParameter, RequestParameters, type RequestParametersProps, RequestProvider, type RequestProviderProps, RequestTypeContainer, type RequestTypeContainerProps, RequestUrl, RequestUrlInput, SELECT_OPERATORS, SYSTEM_FIELD_OPERATORS, SearchAndFilter, SearchAndFilterContext, type SearchAndFilterContextProps, SearchAndFilterOptionsContainer, type SearchAndFilterOptionsContainerProps, type SearchAndFilterProps, SearchAndFilterProvider, type SearchAndFilterProviderProps, SearchAndFilterResultContainer, type SearchAndFilterResultContainerProps, SearchOnlyContext, SearchOnlyFilter, type SearchOnlyProviderProps, type SearchQueryProps, type SelectedItemProps, type SerializedVariableNode, type SetLocationValueDispatch, type SetLocationValueFunction, SortItems, type SortItemsProps, StatusMultiEditor, StatusSingleEditor, TEXTBOX_OPERATORS, TextEditor, TextMultiChoiceEditor, TextVariableRenderer, USER_OPERATORS, type UseVariablesMenu, type UseVariablesMenuInput, VariableChip, VariableEditor, type VariableEditorCompleteEvent, type VariableEditorProps, VariableNode, type VariableNodeState, type VariableSourceGroup, type VariablesAction, type VariablesContext, type VariablesEvents, VariablesList, VariablesPlugin, type VariablesPluginProps, VariablesProvider, type VariablesProviderProps, bindableFiltersMapper, convertConnectedDataToVariable, createLocationValidator, filterMapper, prettifyBindExpression, readOnlyAttributes, serializeVariablesEditorSerializedState, serializeVariablesEditorState, setVariablesEditorValue, urlEncodeRequestParameter, urlEncodeRequestUrl, useConnectedDataAsVariables, useContentDataResourceLocaleInfo, useDelegation, useDynamicInputsAsVariables, useMeshLocation, useObjectSearchContext, useRequest, useRequestHeader, useRequestParameter, useSearchAndFilter, useUniformMeshSdk, useVariableEditor, useVariables, useVariablesMenu, variableDefaultTextValue, variablePrefix, variableSuffix, variablesToGroupedList, variablesToList };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as _emotion_react_jsx_runtime from '@emotion/react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { SVGProps, ReactNode, MutableRefObject, ComponentType, PropsWithChildren, HTMLAttributes, AnchorHTMLAttributes, ButtonHTMLAttributes } from 'react';
 import * as _uniformdev_mesh_sdk from '@uniformdev/mesh-sdk';
-import { DynamicInputs, MeshLocation, SetValueOptions, EditConnectedDataResponseCancellationContext, DataSourceLocationValue, DataTypeLocationValue, BindableTypes } from '@uniformdev/mesh-sdk';
+import { DynamicInputs, MeshLocation, SetValueOptions, EditConnectedDataResponseCancellationContext, DataSourceLocationValue, DataTypeLocationValue, UniformMeshSDK, BindableTypes } from '@uniformdev/mesh-sdk';
 export * from '@uniformdev/mesh-sdk';
 import { DataVariableDefinition, DataResourceVariables, DataType, DataSourceVariantsKeys } from '@uniformdev/canvas';
 import { Emitter } from 'mitt';
@@ -892,6 +892,100 @@ type DataTypeEditorProps = PropsWithChildren<{
  */
 declare function DataTypeEditor({ onChange, children, editVariableComponent }: DataTypeEditorProps): _emotion_react_jsx_runtime.JSX.Element;
 
+/**
+ * Status of the delegation session as seen from the React provider.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+type DelegationStatus = 'idle' | 'acquiring' | 'active' | 'disabled' | 'error';
+/**
+ * Value provided by DelegationProvider via React context.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+interface DelegationContextValue {
+    status: DelegationStatus;
+    error: Error | null;
+    reacquire: () => void;
+}
+/** @deprecated This beta identity delegation API may change with breaking changes. */
+declare const DelegationContext: React$1.Context<DelegationContextValue | null>;
+
+/**
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+interface DelegationGateProps {
+    children: React__default.ReactNode;
+    /** Shown while delegation is starting. Omit to use the default loading UI. */
+    loadingComponent?: React__default.ReactNode;
+    /** Shown when identity delegation is not enabled for this integration. Omit to use the default callout. */
+    disabledComponent?: React__default.ReactNode;
+    /** Shown when delegation fails. Omit to use the default error callout. */
+    errorComponent?: React__default.ReactNode | ((props: {
+        error: Error;
+    }) => React__default.ReactNode);
+}
+/**
+ * Renders children only when the delegation session is active.
+ * Shows appropriate fallback UI for loading, disabled, and error states.
+ *
+ * Sensible defaults use the design system (loading overlay, callouts). Pass `loadingComponent`,
+ * `disabledComponent`, or `errorComponent` to customize; pass `null` to render nothing for that state.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+declare function DelegationGate({ children, loadingComponent, disabledComponent, errorComponent, }: DelegationGateProps): _emotion_react_jsx_runtime.JSX.Element | null;
+
+/**
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+interface DelegationProviderProps {
+    /** `UniformMeshSDK` instance obtained from `useUniformMeshSdk()`. */
+    sdk: UniformMeshSDK;
+    /**
+     * Called with the session token to exchange it for a delegation token on your backend.
+     * Resolve on success, throw on failure.
+     */
+    onSessionToken: (sessionToken: string) => Promise<void>;
+    /**
+     * Called to check if a delegation session is already active (e.g. a valid cookie exists).
+     * Return `true` to skip the session-token exchange.
+     */
+    checkActive: () => Promise<boolean>;
+    /**
+     * When `true`, re-checks the delegation session after the tab becomes visible again
+     * following a period of being hidden. If the server reports the session is no longer
+     * active (e.g. the access token expired and the refresh token is gone/invalid), the
+     * full session-token exchange is re-run; otherwise the check is silent and does not
+     * flip the status back to `acquiring`.
+     *
+     * Defaults to `true`.
+     */
+    revalidateOnFocus?: boolean;
+    /**
+     * Minimum number of milliseconds the tab must have been hidden before a
+     * `revalidateOnFocus` check runs. Prevents hammering the server on rapid tab
+     * switches. Defaults to 5 minutes.
+     */
+    revalidateAfterMs?: number;
+    children: React__default.ReactNode;
+}
+/**
+ * Manages the identity delegation lifecycle: checks for an existing session, acquires a
+ * session token from the dashboard parent if needed, and delegates exchange to the caller.
+ *
+ * Should ONLY be used to wrap locations which actually needed delegation and not the entire app like <MeshApp />.
+ *
+ * Also handles stale-session recovery: when the tab becomes visible again after being
+ * hidden for longer than `revalidateAfterMs`, the provider silently re-checks via
+ * `checkActive` and re-runs the session exchange only if the server says the session is
+ * no longer active. This covers the "returned after a long time" case where the stored
+ * access token has expired and the refresh token is also gone or no longer valid.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+declare function DelegationProvider({ sdk, onSessionToken, checkActive, revalidateOnFocus, revalidateAfterMs, children, }: DelegationProviderProps): _emotion_react_jsx_runtime.JSX.Element;
+
 type MeshAppProps = {
     loadingComponent?: React__default.ComponentType;
     errorComponent?: React__default.ComponentType<{
@@ -1555,7 +1649,7 @@ type FilterEditorRendererProps<TValue extends string | string[]> = Pick<FilterOp
 };
 
 /** a list of possible operator values that sync with uniform search api */
-type OperatorValue = 'eq' | 'sys-date-eq' | 'neq' | 'gt' | 'sys-date-gt' | 'gte' | 'sys-date-gte' | 'lt' | 'sys-date-lt' | 'lte' | 'sys-date-lte' | 'in' | 'nin' | 'between' | 'sys-date-between' | 'ndef' | 'def' | 'match' | 'starts' | 'checked' | 'nchecked';
+type OperatorValue = 'eq' | 'sys-date-eq' | 'neq' | 'gt' | 'sys-date-gt' | 'gte' | 'sys-date-gte' | 'lt' | 'sys-date-lt' | 'lte' | 'sys-date-lte' | 'in' | 'nin' | 'all' | 'between' | 'sys-date-between' | 'ndef' | 'def' | 'match' | 'starts' | 'checked' | 'nchecked';
 type OperatorValueType = {
     value: OperatorValue;
 };
@@ -1742,6 +1836,8 @@ type SearchAndFilterProviderProps = {
     onResetFilterValues?: () => void;
     /** the total number of results */
     totalResults?: number;
+    /** whether data is currently loading */
+    isLoading?: boolean;
     /** the filter mapper function */
     filterMapper?: FilterMapper;
     /** sets child components giving access to useSearchAndFilter context */
@@ -1776,6 +1872,8 @@ type SearchAndFilterContextProps = {
     filterMapper?: FilterMapper;
     /** the total number of results */
     totalResults?: number;
+    /** whether data is currently loading */
+    isLoading?: boolean;
     /** Allow to bind dynamic inputs to the search term */
     allowBindingSearchTerm?: boolean;
 };
@@ -1784,7 +1882,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, onResetFilterValues, totalResults, filterMapper, children, allowBindingSearchTerm, }: SearchAndFilterProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilterProvider: ({ filters, filterOptions, filterVisible, alwaysVisible, defaultSearchTerm, onSearchChange, onChange, resetFilterValues, onResetFilterValues, totalResults, isLoading, 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();
  */
@@ -1815,6 +1913,8 @@ declare const useSearchAndFilter: () => {
     filterMapper?: FilterMapper;
     /** the total number of results */
     totalResults?: number;
+    /** whether data is currently loading */
+    isLoading?: boolean;
     /** Allow to bind dynamic inputs to the search term */
     allowBindingSearchTerm?: boolean;
 };
@@ -1830,6 +1930,8 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
     viewSwitchControls?: React$1.ReactNode;
     /** The number of total results */
     totalResults?: number;
+    /** Whether data is currently loading */
+    isLoading?: boolean;
     /** The results container view
      * @default '<SearchAndFilterResultContainer />'
      */
@@ -1847,7 +1949,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, onResetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const SearchAndFilter: ({ filters, filterOptions, filterVisible, filterControls, viewSwitchControls, resultsContainerView, filterMapper, additionalFiltersContainer, onChange, defaultSearchTerm, onSearchChange, totalResults, isLoading, allowBindingSearchTerm, resetFilterValues, onResetFilterValues, }: SearchAndFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type FilterItemsProps = {
     /** The text for the add button */
@@ -1957,6 +2059,14 @@ declare const SortItems: ({ sortByLabel, localeLabel, sortOptions, sortByValue,
 /** Converts connected data map into VariablesProvider-format variables */
 declare function useConnectedDataAsVariables(connectedData: Record<string, unknown> | undefined): Record<string, MeshDataVariableDefinition>;
 
+/**
+ * Returns the current delegation session state.
+ * Must be used within a `DelegationProvider`.
+ *
+ * @deprecated This beta identity delegation API may change with breaking changes.
+ */
+declare function useDelegation(): DelegationContextValue;
+
 /** Converts dynamic inputs into VariablesProvider-format variables */
 declare function useDynamicInputsAsVariables(dynamicInputs: DynamicInputs): Record<string, MeshDataVariableDefinition>;
 
@@ -2007,4 +2117,4 @@ type ContentDataResourceLocaleInfoProps = {
 };
 declare function useContentDataResourceLocaleInfo({ locale, defaultLocale, setLocale, dynamicInputs, }: ContentDataResourceLocaleInfoProps): ContentDataResourceLocaleInfoResult;
 
-export { $createVariableNode, $isVariableNode, type BadgeThemeProps, type BaseRequestData, CHECKBOX_OPERATORS, type ContentDataResourceLocaleInfoProps, type ContentDataResourceLocaleInfoResult, ControlledValuePlugin, DATE_OPERATORS, DATE_TIME_OPERATORS, DISCONNECT_VARIABLE_COMMAND, DataRefreshButton, type DataRefreshButtonProps, DataResourceDynamicInputProvider, type DataResourceDynamicInputProviderProps, type DataResourceVariableRendererProps, DataResourceVariablesList, DataResourceVariablesListExplicit, type DataResourceVariablesListProps, DataSourceEditor, type DataSourceEditorProps, DataTypeEditor, type DataTypeEditorProps, type DataVariableDefinitionWithName, DateEditor, DateRangeEditor, type DisconnectVariableCommandArguments, type DispatchResult, EDIT_VARIABLE_COMMAND, type EditVariableCommandArguments, type Filter, FilterButton, type FilterButtonProps, FilterControls, type FilterEditor, FilterEditorRenderer, type FilterEditorRendererProps, FilterItem, type FilterItemProps, FilterItems, type FilterItemsProps, type FilterMapper, FilterMenu, FilterMultiChoiceEditor, type FilterOption, type FilterOptionGroup, type FilterOptionLeftHandComponentProps, FilterSingleChoiceEditor, type FiltersProps, INSERT_VARIABLE_COMMAND, index as Icons, type InputOption, type InputOptionGroup, type InputOptionValue, InputVariables, type InputVariablesProps, type InsertVariableCommandArguments, type ItemListProps, type KnownUndefinedVariableInfo, type KnownUndefinedVariableInfoWithName, LinkButton, MULTI_SELECT_OPERATORS, MeshApp, type MeshAppProps, type MeshDataVariableDefinition, NUMBER_OPERATORS, NumberEditor, NumberRangeEditor, OPEN_INSERT_VARIABLE_COMMAND, OPTIONAL_SYSTEM_FIELD_OPERATORS, ObjectSearchContainer, type ObjectSearchContainerProps, type ObjectSearchContextProps, ObjectSearchFilter, ObjectSearchFilterContainer, type ObjectSearchFilterContainerProps, type ObjectSearchFilterProps, ObjectSearchListItem, ObjectSearchListItemLoadingSkeleton, type ObjectSearchListItemProps, ObjectSearchProvider, type ObjectSearchProviderProps, ObjectSearchResultItem, ObjectSearchResultItemButton, type ObjectSearchResultItemButtonProps, type ObjectSearchResultItemProps, ObjectSearchResultList, type ObjectSearchResultListProps, type Operator, type OperatorType, type OperatorValue, type OperatorValueType, PUBLISH_STATUS_FIELD_OPERATORS, ParamTypeDynamicDataProvider, type ParamTypeDynamicDataProviderProps, type ParameterConnectOptions, ParameterConnectionIndicator, type ParameterConnectionIndicatorProps, ParameterOrSingleVariable, type ParameterOrSingleVariableProps, ParameterVariables, type ParameterVariablesProps, QueryFilter, type QueryFilterProps, type QueryFilterSearchProps, RICHTEXT_OPERATORS, type RequestAction, type RequestActionContext, RequestBody, type RequestContext, type RequestData, RequestHeaders, RequestMethodSelect, type RequestParameter, RequestParameters, type RequestParametersProps, RequestProvider, type RequestProviderProps, RequestTypeContainer, type RequestTypeContainerProps, RequestUrl, RequestUrlInput, SELECT_OPERATORS, SYSTEM_FIELD_OPERATORS, SearchAndFilter, SearchAndFilterContext, type SearchAndFilterContextProps, SearchAndFilterOptionsContainer, type SearchAndFilterOptionsContainerProps, type SearchAndFilterProps, SearchAndFilterProvider, type SearchAndFilterProviderProps, SearchAndFilterResultContainer, type SearchAndFilterResultContainerProps, SearchOnlyContext, SearchOnlyFilter, type SearchOnlyProviderProps, type SearchQueryProps, type SelectedItemProps, type SerializedVariableNode, type SetLocationValueDispatch, type SetLocationValueFunction, SortItems, type SortItemsProps, StatusMultiEditor, StatusSingleEditor, TEXTBOX_OPERATORS, TextEditor, TextMultiChoiceEditor, TextVariableRenderer, USER_OPERATORS, type UseVariablesMenu, type UseVariablesMenuInput, VariableChip, VariableEditor, type VariableEditorCompleteEvent, type VariableEditorProps, VariableNode, type VariableNodeState, type VariableSourceGroup, type VariablesAction, type VariablesContext, type VariablesEvents, VariablesList, VariablesPlugin, type VariablesPluginProps, VariablesProvider, type VariablesProviderProps, bindableFiltersMapper, convertConnectedDataToVariable, createLocationValidator, filterMapper, prettifyBindExpression, readOnlyAttributes, serializeVariablesEditorSerializedState, serializeVariablesEditorState, setVariablesEditorValue, urlEncodeRequestParameter, urlEncodeRequestUrl, useConnectedDataAsVariables, useContentDataResourceLocaleInfo, useDynamicInputsAsVariables, useMeshLocation, useObjectSearchContext, useRequest, useRequestHeader, useRequestParameter, useSearchAndFilter, useUniformMeshSdk, useVariableEditor, useVariables, useVariablesMenu, variableDefaultTextValue, variablePrefix, variableSuffix, variablesToGroupedList, variablesToList };
+export { $createVariableNode, $isVariableNode, type BadgeThemeProps, type BaseRequestData, CHECKBOX_OPERATORS, type ContentDataResourceLocaleInfoProps, type ContentDataResourceLocaleInfoResult, ControlledValuePlugin, DATE_OPERATORS, DATE_TIME_OPERATORS, DISCONNECT_VARIABLE_COMMAND, DataRefreshButton, type DataRefreshButtonProps, DataResourceDynamicInputProvider, type DataResourceDynamicInputProviderProps, type DataResourceVariableRendererProps, DataResourceVariablesList, DataResourceVariablesListExplicit, type DataResourceVariablesListProps, DataSourceEditor, type DataSourceEditorProps, DataTypeEditor, type DataTypeEditorProps, type DataVariableDefinitionWithName, DateEditor, DateRangeEditor, DelegationContext, type DelegationContextValue, DelegationGate, type DelegationGateProps, DelegationProvider, type DelegationProviderProps, type DelegationStatus, type DisconnectVariableCommandArguments, type DispatchResult, EDIT_VARIABLE_COMMAND, type EditVariableCommandArguments, type Filter, FilterButton, type FilterButtonProps, FilterControls, type FilterEditor, FilterEditorRenderer, type FilterEditorRendererProps, FilterItem, type FilterItemProps, FilterItems, type FilterItemsProps, type FilterMapper, FilterMenu, FilterMultiChoiceEditor, type FilterOption, type FilterOptionGroup, type FilterOptionLeftHandComponentProps, FilterSingleChoiceEditor, type FiltersProps, INSERT_VARIABLE_COMMAND, index as Icons, type InputOption, type InputOptionGroup, type InputOptionValue, InputVariables, type InputVariablesProps, type InsertVariableCommandArguments, type ItemListProps, type KnownUndefinedVariableInfo, type KnownUndefinedVariableInfoWithName, LinkButton, MULTI_SELECT_OPERATORS, MeshApp, type MeshAppProps, type MeshDataVariableDefinition, NUMBER_OPERATORS, NumberEditor, NumberRangeEditor, OPEN_INSERT_VARIABLE_COMMAND, OPTIONAL_SYSTEM_FIELD_OPERATORS, ObjectSearchContainer, type ObjectSearchContainerProps, type ObjectSearchContextProps, ObjectSearchFilter, ObjectSearchFilterContainer, type ObjectSearchFilterContainerProps, type ObjectSearchFilterProps, ObjectSearchListItem, ObjectSearchListItemLoadingSkeleton, type ObjectSearchListItemProps, ObjectSearchProvider, type ObjectSearchProviderProps, ObjectSearchResultItem, ObjectSearchResultItemButton, type ObjectSearchResultItemButtonProps, type ObjectSearchResultItemProps, ObjectSearchResultList, type ObjectSearchResultListProps, type Operator, type OperatorType, type OperatorValue, type OperatorValueType, PUBLISH_STATUS_FIELD_OPERATORS, ParamTypeDynamicDataProvider, type ParamTypeDynamicDataProviderProps, type ParameterConnectOptions, ParameterConnectionIndicator, type ParameterConnectionIndicatorProps, ParameterOrSingleVariable, type ParameterOrSingleVariableProps, ParameterVariables, type ParameterVariablesProps, QueryFilter, type QueryFilterProps, type QueryFilterSearchProps, RICHTEXT_OPERATORS, type RequestAction, type RequestActionContext, RequestBody, type RequestContext, type RequestData, RequestHeaders, RequestMethodSelect, type RequestParameter, RequestParameters, type RequestParametersProps, RequestProvider, type RequestProviderProps, RequestTypeContainer, type RequestTypeContainerProps, RequestUrl, RequestUrlInput, SELECT_OPERATORS, SYSTEM_FIELD_OPERATORS, SearchAndFilter, SearchAndFilterContext, type SearchAndFilterContextProps, SearchAndFilterOptionsContainer, type SearchAndFilterOptionsContainerProps, type SearchAndFilterProps, SearchAndFilterProvider, type SearchAndFilterProviderProps, SearchAndFilterResultContainer, type SearchAndFilterResultContainerProps, SearchOnlyContext, SearchOnlyFilter, type SearchOnlyProviderProps, type SearchQueryProps, type SelectedItemProps, type SerializedVariableNode, type SetLocationValueDispatch, type SetLocationValueFunction, SortItems, type SortItemsProps, StatusMultiEditor, StatusSingleEditor, TEXTBOX_OPERATORS, TextEditor, TextMultiChoiceEditor, TextVariableRenderer, USER_OPERATORS, type UseVariablesMenu, type UseVariablesMenuInput, VariableChip, VariableEditor, type VariableEditorCompleteEvent, type VariableEditorProps, VariableNode, type VariableNodeState, type VariableSourceGroup, type VariablesAction, type VariablesContext, type VariablesEvents, VariablesList, VariablesPlugin, type VariablesPluginProps, VariablesProvider, type VariablesProviderProps, bindableFiltersMapper, convertConnectedDataToVariable, createLocationValidator, filterMapper, prettifyBindExpression, readOnlyAttributes, serializeVariablesEditorSerializedState, serializeVariablesEditorState, setVariablesEditorValue, urlEncodeRequestParameter, urlEncodeRequestUrl, useConnectedDataAsVariables, useContentDataResourceLocaleInfo, useDelegation, useDynamicInputsAsVariables, useMeshLocation, useObjectSearchContext, useRequest, useRequestHeader, useRequestParameter, useSearchAndFilter, useUniformMeshSdk, useVariableEditor, useVariables, useVariablesMenu, variableDefaultTextValue, variablePrefix, variableSuffix, variablesToGroupedList, variablesToList };