@uniformdev/mesh-sdk-react 20.75.1-alpha.15.sha-b6ff05804e → 20.75.1-alpha.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -59,27 +59,16 @@ declare function DataResourceDynamicInputProvider(props: DataResourceDynamicInpu
59
59
 
60
60
  /**
61
61
  * Provides convenient access to the current Uniform Mesh location via React hook.
62
- * Intended to be used within `MeshApp`.
62
+ * Intended to be used within <MeshApp />.
63
63
  *
64
64
  * There are three primary ways to invoke this hook:
65
65
  * 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`
66
- * @example
67
- * ```tsx
68
- * const location = useMeshLocation();
69
- * if (location.type === 'paramType') {
70
- * // location is now known to be a paramType
71
- * }
72
- * ```
66
+ * const location = useMeshLocation();
67
+ * if (location.type === 'paramType') { // location is now known to be a paramType }
73
68
  * 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.
74
- * @example
75
- * ```tsx
76
- * const location = useMeshLocation('settings');
77
- * ```
69
+ * const location = useMeshLocation('settings');
78
70
  * 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.
79
- * @example
80
- * ```tsx
81
- * const location = useMeshLocation<'paramType', MyParamTypeValueType>();
82
- * ```
71
+ * const location = useMeshLocation<'paramType', MyParamTypeValueType>();
83
72
  *
84
73
  * You can also combine (2) and (3) to get both explicit value typing and assertion of the location.
85
74
  */
@@ -525,7 +514,7 @@ type InputVariablesProps<TEditorContext = unknown> = {
525
514
  * disable it with this prop.
526
515
  */
527
516
  disableDismissEditorOnChange?: boolean;
528
- /** Enables mutliple lines in the input (newline characters in the value) */
517
+ /** Enables mutliple lines in the input (\n in the value) */
529
518
  multiLine?: boolean;
530
519
  /** Disables the inline variable selection menu when rendering a variables input */
531
520
  disableInlineMenu?: boolean | 'by-label' | 'by-input';
@@ -640,7 +629,7 @@ type ParameterVariablesProps<TEditorContext = unknown> = {
640
629
  /** Sets the test ID of the input */
641
630
  'data-testid'?: string;
642
631
  /**
643
- * Enables mutliple lines in the input (newline characters in the value).
632
+ * Enables mutliple lines in the input (\n in the value).
644
633
  * If a number is passed, the height of the editor is set to that number of lines and overflow scrolls.
645
634
  * If a boolean true is passed, the editor auto-sizes to the content.
646
635
  */
@@ -815,8 +804,7 @@ declare function serializeVariablesEditorSerializedState(serializedEditorState:
815
804
  *
816
805
  * If newValue is undefined, the editor will be set to an empty state.
817
806
  * If newValue is a string, it will be treated as a variable-reference-containing string, and parsed to a Lexical AST
818
- * If newValue is a serialized Lexical AST, omitted Lexical defaults are restored before parse.
819
- * If the AST is invalid, the editor will be set to an empty state.
807
+ * 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.
820
808
  */
821
809
  declare function setVariablesEditorValue(editor: LexicalEditor, newValue: string | undefined | null | SerializedEditorState<SerializedLexicalNode>, tag?: string): void;
822
810
 
@@ -824,12 +812,12 @@ declare function variableDefaultTextValue(defaultValue: unknown): string;
824
812
 
825
813
  /**
826
814
  * Expected prefix for variable expressions
827
- * @deprecated Use the variables binding API instead of string delimiters.
815
+ * @deprecated
828
816
  */
829
817
  declare const variablePrefix = "${";
830
818
  /**
831
819
  * Expected suffix for variable expressions
832
- * @deprecated Use the variables binding API instead of string delimiters.
820
+ * @deprecated
833
821
  */
834
822
  declare const variableSuffix = "}";
835
823
 
@@ -1040,11 +1028,8 @@ type DataRefreshButtonProps = HTMLAttributes<HTMLButtonElement> & {
1040
1028
  onRefreshData: () => void;
1041
1029
  };
1042
1030
  /**
1043
- * The data refresh button is a UI component to indicate to users a request for data is taking place
1044
- * @example
1045
- * ```tsx
1046
- * <DataRefreshButton buttonText="my button" isLoading />
1047
- * ```
1031
+ * @description The data refresh button is a UI component to indicate to users a request for data is taking place
1032
+ * @example <DataRefreshButton buttonText="my button" isLoading />
1048
1033
  * @deprecated this component is not recommended for use in new projects
1049
1034
  */
1050
1035
  declare const DataRefreshButton: ({ buttonText, isLoading, onRefreshData, ...props }: DataRefreshButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
@@ -1072,11 +1057,8 @@ type ObjectSearchContainerProps = {
1072
1057
  children?: ReactNode;
1073
1058
  };
1074
1059
  /**
1075
- * Object search container is an opinionated layout for search parameters and retrieved results
1076
- * @example
1077
- * ```tsx
1078
- * <ObjectSearchContainer searchFilters={<>your component</>} resultList={<>your result list component<>} onSave={yourSaveAction} onCancel={yourCancelAction} />
1079
- * ```
1060
+ * @description Object search container is an opinionated layout for search parameters and retrieved results
1061
+ * @example <ObjectSearchContainer searchFilters={<>your component</>} resultList={<>your result list component<>} onSave={yourSaveAction} onCancel={yourCancelAction} />
1080
1062
  * @deprecated this component is not recommended for use in new projects
1081
1063
  */
1082
1064
  declare const ObjectSearchContainer: ({ label, enableDynamicInputToResultId, searchFilters, resultList, children, }: ObjectSearchContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
@@ -1085,11 +1067,11 @@ type ObjectSearchFilterProps = {
1085
1067
  /** shows or hides the required content type select option */
1086
1068
  requireContentType?: boolean;
1087
1069
  /** sets the text for the required content type select option
1088
- * @defaultValue 'All content types'
1070
+ * @default 'All content types'
1089
1071
  */
1090
1072
  typeSelectorAllTypesOptionText?: string;
1091
1073
  /** sets the select input value label text
1092
- * @defaultValue 'Content Type Select'
1074
+ * @default 'Content Type Select'
1093
1075
  */
1094
1076
  selectLabel?: string;
1095
1077
  /** sets the select input options, if empty - only keyword search field will be rendered */
@@ -1098,21 +1080,18 @@ type ObjectSearchFilterProps = {
1098
1080
  value?: string;
1099
1081
  }>;
1100
1082
  /** sets the search input name value
1101
- * @defaultValue 'searchText'
1083
+ * @default 'searchText'
1102
1084
  */
1103
1085
  searchInputName?: string;
1104
1086
  /** sets the search input placeholder text
1105
- * @defaultValue 'Enter keyword to narrow your results'
1087
+ * @default 'Enter keyword to narrow your results'
1106
1088
  */
1107
1089
  searchInputPlaceholderText?: string;
1108
1090
  };
1109
1091
  /**
1110
- * Object search filter is an opinionated filter that has pre-defined query and setQuery functions
1092
+ * @description Object search filter is an opinionated filter that has pre-defined query and setQuery functions
1111
1093
  * that can be extended with custom functions
1112
- * @example
1113
- * ```tsx
1114
- * <ObjectSearchFilter selectOptions={[{ id: 'id value', name: 'name value'}]} />
1115
- * ```
1094
+ * @example <ObjectSearchFilter selectOptions={[{ id: 'id value', name: 'name value'}]} />
1116
1095
  * @deprecated this component is not recommended for use in new projects
1117
1096
  */
1118
1097
  declare const ObjectSearchFilter: ({ requireContentType, typeSelectorAllTypesOptionText, searchInputName, searchInputPlaceholderText, selectLabel, selectOptions, }: ObjectSearchFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
@@ -1122,11 +1101,8 @@ type ObjectSearchFilterContainerProps = {
1122
1101
  children?: React.ReactNode;
1123
1102
  };
1124
1103
  /**
1125
- * an opinionated layout for search filters
1126
- * @example
1127
- * ```tsx
1128
- * <ObjectSearchFilterContainer label="my label"><input type="text" aria-label="my input" /></ObjectSearchFilterContainer>
1129
- * ```
1104
+ * @description an opinionated layout for search filters
1105
+ * @example <ObjectSearchFilterContainer label="my label"><input type="text" aria-label="my input" /></ObjectSearchFilterContainer>
1130
1106
  * @deprecated this component is not recommended for use in new projects
1131
1107
  */
1132
1108
  declare const ObjectSearchFilterContainer: ({ children }: ObjectSearchFilterContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
@@ -1136,23 +1112,20 @@ type ObjectSearchResultItemProps = SelectedItemProps & {
1136
1112
  /** sets additional remove functionality onto of default removal */
1137
1113
  onRemove?: () => void;
1138
1114
  /** sets whether to show or hide the remove button
1139
- * @defaultValue false
1115
+ * @default false
1140
1116
  */
1141
1117
  hideRemoveButton?: boolean;
1142
1118
  /** sets user defined child nodes that are uncontrolled by Uniform */
1143
1119
  children?: ReactNode;
1144
1120
  /** disable or enable drag and drop functionality
1145
- * @defaultValue false
1121
+ * @default false
1146
1122
  */
1147
1123
  disableDnD?: boolean;
1148
1124
  onClick?: () => void;
1149
1125
  };
1150
1126
  /**
1151
- * An opinionated result item, best used for selected results
1152
- * @example
1153
- * ```tsx
1154
- * <ObjectSearchResultItem id="my-result" title="title" />
1155
- * ```
1127
+ * @description An opinionated result item, best used for selected results
1128
+ * @example <ObjectSearchResultItem id="my-result" title="title" />
1156
1129
  * @deprecated this component is not recommended for use in new projects
1157
1130
  */
1158
1131
  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;
@@ -1189,7 +1162,7 @@ type SelectedItemProps<TExtraProps = unknown> = {
1189
1162
  /** sets the text value of the publish badge */
1190
1163
  text: string;
1191
1164
  /** sets the theme value of the publish badge
1192
- * @defaultValue 'unimportant'
1165
+ * @default 'unimportant'
1193
1166
  */
1194
1167
  theme?: BadgeThemeProps;
1195
1168
  };
@@ -1253,27 +1226,21 @@ type ObjectSearchListItemProps = SelectedItemProps & {
1253
1226
  /** allows authors to add any child component that is not controlled by Uniform */
1254
1227
  children?: React$1.ReactNode;
1255
1228
  /** sets whether multiple entries can be added to the results list context
1256
- * @defaultValue inherit from context or false
1229
+ * @default inherit from context or false
1257
1230
  */
1258
1231
  isMulti?: boolean;
1259
1232
  /** sets disabled state to the interactive element */
1260
1233
  disabled?: boolean;
1261
1234
  } & React$1.HTMLAttributes<HTMLDivElement>;
1262
1235
  /**
1263
- * entry search list item is an opinionated UI component best used for initial retrieved results
1264
- * @example
1265
- * ```tsx
1266
- * <ObjectSearchListItem id="my-result-item" title="title" popoverData={<p>some data info</p>}><div>example of uncontrolled content</div></ObjectSearchListItem>
1267
- * ```
1236
+ * @description entry search list item is an opinionated UI component best used for initial retrieved results
1237
+ * @example <ObjectSearchListItem id="my-result-item" title="title" popoverData={<p>some data info</p>}><div>example of uncontrolled content</div></ObjectSearchListItem>
1268
1238
  * @deprecated this component is not recommended for use in new projects
1269
1239
  */
1270
1240
  declare const ObjectSearchListItem: ({ id, title, contentType, imageUrl, popoverData, onSelect, isMulti, disabled, children, ...props }: ObjectSearchListItemProps & React$1.HTMLAttributes<HTMLDivElement>) => _emotion_react_jsx_runtime.JSX.Element;
1271
1241
  /**
1272
1242
  * An opinionated loading skeleton component best used with ObjectSearchListItem
1273
- * @example
1274
- * ```tsx
1275
- * <ObjectSearchListItemLoadingSkeleton />
1276
- * ```
1243
+ * @example <ObjectSearchListItemLoadingSkeleton />
1277
1244
  */
1278
1245
  declare const ObjectSearchListItemLoadingSkeleton: () => _emotion_react_jsx_runtime.JSX.Element;
1279
1246
 
@@ -1286,28 +1253,22 @@ type ObjectSearchResultItemButtonProps<THtml extends HTMLAttributes<HTMLElement>
1286
1253
  }>;
1287
1254
  } & THtml;
1288
1255
  /**
1289
- * An opinionated button component best used within the ObjectSearchResultItem component
1290
- * @example
1291
- * ```tsx
1292
- * <ObjectSearchResultItemButton text="button text" icon="/my-image.png" onClick={() => myFunction()} />
1293
- * ```
1256
+ * @description An opinionated button component best used within the ObjectSearchResultItem component
1257
+ * @example <ObjectSearchResultItemButton text="button text" icon="/my-image.png" onClick={() => myFunction()} />
1294
1258
  * @deprecated this component is not recommended for use in new projects
1295
1259
  */
1296
1260
  declare const ObjectSearchResultItemButton: ({ text, icon, ...props }: ObjectSearchResultItemButtonProps<HTMLAttributes<HTMLButtonElement>>) => _emotion_react_jsx_runtime.JSX.Element;
1297
1261
  /**
1298
- * An opinionated link component styled the same of the ObjectSearchResultItemButton component,
1262
+ * @description An opinionated link component styled the same of the ObjectSearchResultItemButton component,
1299
1263
  * that automatically sets the target and rel attributes. Best used within the ObjectSearchResultItem component
1300
- * @example
1301
- * ```tsx
1302
- * <LinkButton text="link text" icon="/my-image.png" />
1303
- * ```
1264
+ * @example <LinkButton text="link text" icon="/my-image.png" />
1304
1265
  * @deprecated this component is not recommended for use in new projects
1305
1266
  */
1306
1267
  declare const LinkButton: ({ text, icon, ...props }: ObjectSearchResultItemButtonProps<Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "target" | "rel">>) => _emotion_react_jsx_runtime.JSX.Element;
1307
1268
 
1308
1269
  type ObjectSearchResultListProps<TRenderComponent extends SelectedItemProps = SelectedItemProps> = {
1309
1270
  /** sets the result label value
1310
- * @defaultValue 'Selected'
1271
+ * @default 'Selected'
1311
1272
  */
1312
1273
  resultLabelText?: string;
1313
1274
  /** sets and override react node replacing the whole HTML block for the result label and counter */
@@ -1315,11 +1276,11 @@ type ObjectSearchResultListProps<TRenderComponent extends SelectedItemProps = Se
1315
1276
  /** sets the on remove button click action */
1316
1277
  onRemoveAllSelected?: () => void;
1317
1278
  /** sets the remove button text
1318
- * @defaultValue 'Remove all'
1279
+ * @default 'Remove all'
1319
1280
  */
1320
1281
  removeButtonText?: string;
1321
1282
  /** sets whether to show or hide the remove button
1322
- * @defaultValue false
1283
+ * @default false
1323
1284
  */
1324
1285
  hideRemoveButton?: boolean;
1325
1286
  /** allows additional buttons to be added to the result title group */
@@ -1327,7 +1288,7 @@ type ObjectSearchResultListProps<TRenderComponent extends SelectedItemProps = Se
1327
1288
  /** allows placing child components within the result list area */
1328
1289
  renderResultComponent?: (value: TRenderComponent) => React__default.ReactNode;
1329
1290
  /** disable or enable drag and drop functionality
1330
- * @defaultValue false
1291
+ * @default false
1331
1292
  */
1332
1293
  disableDnD?: boolean;
1333
1294
  /** sets the draggable id value */
@@ -1342,13 +1303,10 @@ type ObjectSearchResultListProps<TRenderComponent extends SelectedItemProps = Se
1342
1303
  getContainerForDnDReparenting?: () => HTMLElement;
1343
1304
  };
1344
1305
  /**
1345
- * An opinionated result list UI component that has built in drag and drop functionality and removal of all selected items from context.
1346
- * The result item component defaults to `ObjectSearchResultItem`, however this can be overridden with any other UI component and still
1306
+ * @description An opinionated result list UI component that has built in drag and drop functionality and removal of all selected items from context.
1307
+ * The result item component defaults to <ObjectSearchResultItem {...props} />, however this can be overridden with any other UI component and still
1347
1308
  * maintain drag and drop functionality
1348
- * @example
1349
- * ```tsx
1350
- * <ObjectSearchResultList id="my-id" title="title" renderResultComponent={(values) => <CustomComponent {...values} />} />
1351
- * ```
1309
+ * @example <ObjectSearchResultList id="my-id" title="title" renderResultComponent={(values) => <CustomComponent {...values} />} />
1352
1310
  * @deprecated this component is not recommended for use in new projects
1353
1311
  */
1354
1312
  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;
@@ -1362,22 +1320,23 @@ type QueryFilterSearchProps = {
1362
1320
  sortOrder: string;
1363
1321
  };
1364
1322
  type QueryFilterSelectionOptionProps = Array<{
1365
- /** contains id or machine values; used as the value attribute on HTML option elements */
1323
+ /** contains id or machine values. will be used as value attribute in <option> */
1366
1324
  value?: string;
1367
- /** Contains human-readable display name for select options. Used as the option label when value is not present. */
1325
+ /** Contains human-readable display name for select options.
1326
+ * Used as value in case value is not present <option> */
1368
1327
  label: string;
1369
1328
  }>;
1370
1329
  type QueryFilterProps<TSelectOptions extends QueryFilterSelectionOptionProps = QueryFilterSelectionOptionProps> = {
1371
1330
  /** sets the query filter title
1372
- * @defaultValue 'Configure Query'
1331
+ * @default 'Configure Query'
1373
1332
  */
1374
1333
  queryFilterTitle?: string;
1375
1334
  /** sets the content type all selected options label
1376
- * @defaultValue 'All content types'
1335
+ * @default 'All content types'
1377
1336
  */
1378
1337
  typeSelectorAllTypesOptionText?: string;
1379
1338
  /** sets the content type label value
1380
- * @defaultValue 'Filter by content type'
1339
+ * @default 'Filter by content type'
1381
1340
  */
1382
1341
  contentTypeLabel?: string;
1383
1342
  /** sets the content type select options */
@@ -1385,42 +1344,39 @@ type QueryFilterProps<TSelectOptions extends QueryFilterSelectionOptionProps = Q
1385
1344
  /** sets whether the content type filter is required */
1386
1345
  requireContentType?: boolean;
1387
1346
  /** sets the count label value
1388
- * @defaultValue 'Count'
1347
+ * @default 'Count'
1389
1348
  */
1390
1349
  countLabel?: string;
1391
1350
  /** sets the sort label text
1392
- * @defaultValue 'Sort'
1351
+ * @default 'Sort'
1393
1352
  */
1394
1353
  sortLabel?: string;
1395
1354
  /** sets the sort select options value */
1396
1355
  sortOptions: TSelectOptions;
1397
1356
  /** sets the sort order lable value
1398
- * @defaultValue 'Sort Order'
1357
+ * @default 'Sort Order'
1399
1358
  */
1400
1359
  sortOrderLabel?: string;
1401
1360
  /** sets the sort order select options value */
1402
1361
  sortOrderOptions: TSelectOptions;
1403
1362
  /** sets the search input name value
1404
- * @defaultValue 'searchText'
1363
+ * @default 'searchText'
1405
1364
  */
1406
1365
  searchInputName?: string;
1407
1366
  /** sets the search input placeholder text
1408
- * @defaultValue 'Enter keyword to narrow your results'
1367
+ * @default 'Enter keyword to narrow your results'
1409
1368
  */
1410
1369
  searchInputPlaceholderText?: string;
1411
1370
  /** sets the label for the search input
1412
- * @defaultValue 'Query'
1371
+ * @default 'Query'
1413
1372
  */
1414
1373
  searchInputLabel?: string;
1415
1374
  /** allows for additional child components, for example more input components */
1416
1375
  children?: ReactNode;
1417
1376
  };
1418
1377
  /**
1419
- * An opinionated multi query filter UI component, best used for querying product data or more complex scenarios
1420
- * @example
1421
- * ```tsx
1422
- * <QueryFilter contentTypeOptions={[{ id: 'id', name: 'name' }]} sortOptions={[{ id: 'id', name: 'name' }]} sortOrderOptions={[{ id: 'id', name: 'name' }]} />
1423
- * ```
1378
+ * @description An opinionated multi query filter UI component, best used for querying product data or more complex scenarios
1379
+ * @example <QueryFilter contentTypeOptions={[{ id: 'id', name: 'name' }]} sortOptions={[{ id: 'id', name: 'name' }]} sortOrderOptions={[{ id: 'id', name: 'name' }]} />
1424
1380
  * @deprecated this component is not recommended for use in new projects
1425
1381
  */
1426
1382
  declare const QueryFilter: ({ requireContentType, queryFilterTitle, contentTypeLabel, typeSelectorAllTypesOptionText, contentTypeOptions, searchInputName, searchInputPlaceholderText, searchInputLabel, countLabel, sortLabel, sortOptions, sortOrderLabel, sortOrderOptions, children, }: QueryFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
@@ -1524,21 +1480,17 @@ declare function useRequest(): RequestContext;
1524
1480
 
1525
1481
  type RequestTypeContainerProps = React$1.HTMLAttributes<HTMLDivElement> & {
1526
1482
  /**sets the background color of the container
1527
- * @defaultValue 'transparent'
1483
+ * @default 'transparent'
1528
1484
  */
1529
1485
  bgColor?: 'transparent' | 'var(--gray-100)';
1530
1486
  children: React$1.ReactNode;
1531
1487
  };
1532
1488
  /**
1533
- * a container to layout content in a 2 column grid format = 12ch 1fr
1534
- * @example
1535
- * ```tsx
1536
- * <RequestTypeContainer bgColor="var(--gray-100)">
1537
- * <label>Name <input type="text" /></label>
1538
- * <label>Name <input type="text" /></label>
1539
- * </RequestTypeContainer>
1540
- * ```
1541
- */
1489
+ * @description a container to layout content in a 2 column grid format = 12ch 1fr
1490
+ * @example <RequestTypeContainer bgColor="var(--gray-100)">
1491
+ * <label>Name <input type="text" /></label>
1492
+ * <label>Name <input type="text" /></label>
1493
+ * </div> */
1542
1494
  declare const RequestTypeContainer: ({ bgColor, children, ...props }: RequestTypeContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
1543
1495
 
1544
1496
  /**
@@ -1755,55 +1707,37 @@ declare const MULTI_SELECT_OPERATORS: OperatorType;
1755
1707
 
1756
1708
  /**
1757
1709
  * Renders a date input field for filtering
1758
- * @example
1759
- * ```tsx
1760
- * <DateEditor ariaLabel="Date" value={value} onChange={onChange} />
1761
- * ```
1710
+ * @example <DateEditor ariaLabel="Date" value={value} onChange={onChange} />
1762
1711
  */
1763
1712
  declare const DateEditor: ({ onChange, ariaLabel, disabled, value, readOnly, valueTestId, }: FilterEditorRendererProps<string>) => _emotion_react_jsx_runtime.JSX.Element;
1764
1713
 
1765
1714
  /**
1766
1715
  * Renders a date range input field for filtering
1767
- * @example
1768
- * ```tsx
1769
- * <DateRangeEditor ariaLabel="Date Range" value={value} onChange={onChange} />
1770
- * ```
1716
+ * @example <DateRangeEditor ariaLabel="Date Range" value={value} onChange={onChange} />
1771
1717
  */
1772
1718
  declare const DateRangeEditor: ({ ariaLabel, onChange, disabled, value, readOnly, valueTestId, }: FilterEditorRendererProps<string[]>) => _emotion_react_jsx_runtime.JSX.Element;
1773
1719
 
1774
1720
  /**
1775
1721
  * Multi select filter component
1776
- * @example
1777
- * ```tsx
1778
- * <FilterMultiChoiceEditor options={options} value={options.filter((option) => values.includes(option.value)} onChange={(e) => onChange(e.map((option) => option.value))} />
1779
- * ```
1722
+ * @example <FilterMultiChoiceEditor options={options} value={options.filter((option) => values.includes(option.value)} onChange={(e) => onChange(e.map((option) => option.value))} />
1780
1723
  */
1781
1724
  declare const FilterMultiChoiceEditor: ({ value, options, disabled, readOnly, valueTestId, ...props }: FilterEditorRendererProps<string[]>) => _emotion_react_jsx_runtime.JSX.Element;
1782
1725
 
1783
1726
  /**
1784
1727
  * Single select filter component
1785
- * @example
1786
- * ```tsx
1787
- * <FilterSingleChoiceEditor options={options} value={options.find((option) => values.includes(option.value)} onChange={(e) => onChange(e.value)} />
1788
- * ```
1728
+ * @example <FilterSingleChoiceEditor options={options} value={options.find((option) => values.includes(option.value)} onChange={(e) => onChange(e.value)} />
1789
1729
  */
1790
1730
  declare const FilterSingleChoiceEditor: ({ options, value, disabled, readOnly, onChange, valueTestId, }: FilterEditorRendererProps<string>) => _emotion_react_jsx_runtime.JSX.Element;
1791
1731
 
1792
1732
  /**
1793
1733
  * Renders a number input field for filtering
1794
- * @example
1795
- * ```tsx
1796
- * <NumberEditor ariaLabel="Number" value={value} onChange={onChange} />
1797
- * ```
1734
+ * @example <NumberEditor ariaLabel="Number" value={value} onChange={onChange} />
1798
1735
  */
1799
1736
  declare const NumberEditor: ({ ariaLabel, onChange, disabled, value, readOnly, valueTestId, }: FilterEditorRendererProps<string>) => _emotion_react_jsx_runtime.JSX.Element;
1800
1737
 
1801
1738
  /**
1802
1739
  * Renders a number range input field for filtering
1803
- * @example
1804
- * ```tsx
1805
- * <NumberRangeEditor ariaLabel="Number Range" value={value} onChange={onChange} />
1806
- * ```
1740
+ * @example <NumberRangeEditor ariaLabel="Number Range" value={value} onChange={onChange} />
1807
1741
  */
1808
1742
  declare const NumberRangeEditor: ({ onChange, disabled, ariaLabel, value, readOnly, valueTestId, }: FilterEditorRendererProps<string[]>) => _emotion_react_jsx_runtime.JSX.Element;
1809
1743
 
@@ -1815,28 +1749,19 @@ declare const readOnlyAttributes: {
1815
1749
 
1816
1750
  /**
1817
1751
  * Status multi select filter component that renders a custom dropdown menu
1818
- * @example
1819
- * ```tsx
1820
- * <StatusMultiEditor options={options} value={value} onChange={onChange} />
1821
- * ```
1752
+ * @example <StatusMultiEditor options={options} value={value} onChange={onChange} />
1822
1753
  */
1823
1754
  declare const StatusMultiEditor: ({ options, value, disabled, readOnly, onChange, valueTestId, }: FilterEditorRendererProps<string[]>) => _emotion_react_jsx_runtime.JSX.Element;
1824
1755
 
1825
1756
  /**
1826
1757
  * Status single select filter component that renders a custom dropdown menu
1827
- * @example
1828
- * ```tsx
1829
- * <StatusSingleEditor options={options} value={value} onChange={onChange} />
1830
- * ```
1758
+ * @example <StatusSingleEditor options={options} value={value} onChange={onChange} />
1831
1759
  */
1832
1760
  declare const StatusSingleEditor: ({ options, value, disabled, readOnly, onChange, valueTestId, }: FilterEditorRendererProps<string>) => _emotion_react_jsx_runtime.JSX.Element;
1833
1761
 
1834
1762
  /**
1835
1763
  * Renders a text input field for filtering
1836
- * @example
1837
- * ```tsx
1838
- * <TextEditor ariaLabel="Search" value={value} onChange={onChange} />
1839
- * ```
1764
+ * @example <TextEditor ariaLabel="Search" value={value} onChange={onChange} />
1840
1765
  */
1841
1766
  declare const TextEditor: ({ onChange, ariaLabel, value, readOnly, valueTestId, }: FilterEditorRendererProps<string>) => _emotion_react_jsx_runtime.JSX.Element;
1842
1767
 
@@ -1847,11 +1772,11 @@ declare const TextMultiChoiceEditor: ({ value, disabled, readOnly, valueTestId,
1847
1772
 
1848
1773
  type FilterButtonProps = {
1849
1774
  /** text to display on the button
1850
- * @defaultValue "Filters"
1775
+ * @default "Filters"
1851
1776
  */
1852
1777
  text?: string;
1853
1778
  /** icon to display on the button
1854
- * @defaultValue "filter-add"
1779
+ * @default "filter-add"
1855
1780
  */
1856
1781
  icon?: IconType;
1857
1782
  /** number of filters to display on the button and sets the styles on the button */
@@ -1865,19 +1790,13 @@ type FilterButtonProps = {
1865
1790
  } & ButtonHTMLAttributes<HTMLButtonElement>;
1866
1791
  /**
1867
1792
  * A filter button component used to display filter menu options
1868
- * @example
1869
- * ```tsx
1870
- * <FilterButton text="Filters" filterCount={3} />
1871
- * ```
1793
+ * @example <FilterButton text="Filters" filterCount={3} />
1872
1794
  */
1873
1795
  declare const FilterButton: ({ text, icon, filterCount, hasSelectedValue, dataTestId, showDropdownIcon, ...props }: FilterButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
1874
1796
 
1875
1797
  /**
1876
1798
  * Default filter controls for search and filter
1877
- * @example
1878
- * ```tsx
1879
- * <FilterControls />
1880
- * ```
1799
+ * @example <FilterControls />
1881
1800
  */
1882
1801
  declare const FilterControls: ({ children, hideSearchInput, }: {
1883
1802
  /** optional param to allow you to add your own controls */
@@ -1888,10 +1807,7 @@ declare const FilterControls: ({ children, hideSearchInput, }: {
1888
1807
 
1889
1808
  /**
1890
1809
  * Renders a filter editor component
1891
- * @example
1892
- * ```tsx
1893
- * <FilterEditorRenderer editorType="multiChoice" options={options} value={value} onChange={onChange} />
1894
- * ```
1810
+ * @example <FilterEditorRenderer editorType="multiChoice" options={options} value={value} onChange={onChange} />
1895
1811
  */
1896
1812
  declare const FilterEditorRenderer: ({ editorType, ...props }: FilterEditorRendererProps<never>) => _emotion_react_jsx_runtime.JSX.Element;
1897
1813
  /** A mapper for filter editor components */
@@ -1937,7 +1853,9 @@ type SearchAndFilterProviderProps = {
1937
1853
  onChange: (filters: Filter[]) => void;
1938
1854
  /** Sets default value for full text search input, useful for bindable search */
1939
1855
  defaultSearchTerm?: string;
1940
- /** sets the reset filter values */
1856
+ /** sets the reset filter values
1857
+ * @default "[{ field: '', operator: '', value: '' }]"
1858
+ */
1941
1859
  resetFilterValues?: Filter[];
1942
1860
  /** sets the list of filter options for each filter row */
1943
1861
  filterOptions: FilterOptionGroup[];
@@ -1989,17 +1907,11 @@ type SearchAndFilterContextProps = {
1989
1907
  declare const SearchAndFilterContext: React$1.Context<SearchAndFilterContextProps>;
1990
1908
  /**
1991
1909
  * Search and filter provider
1992
- * @example
1993
- * ```tsx
1994
- * <SearchAndFilterProvider filters={filters} filterOptions={filterOptions} onSearchChange={onSearchChange} onChange={onChange}>Children</SearchAndFilterProvider>
1995
- * ```
1910
+ * @example <SearchAndFilterProvider filters={filters} filterOptions={filterOptions} onSearchChange={onSearchChange} onChange={onChange}>Children</SearchAndFilterProvider>
1996
1911
  * */
1997
1912
  declare const SearchAndFilterProvider: ({ filters, filterOptions, filterVisible, alwaysVisible, defaultSearchTerm, onSearchChange, onChange, resetFilterValues, onResetFilterValues, totalResults, isLoading, filterMapper, children, allowBindingSearchTerm, }: SearchAndFilterProviderProps) => _emotion_react_jsx_runtime.JSX.Element;
1998
1913
  /** Search and filter hook
1999
- * @example
2000
- * ```tsx
2001
- * const { searchTerm, setSearchTerm, filterVisibility, setFilterVisibility, filters, setFilters, handleAddFilter, handleResetFilters, handleDeleteFilter, filterOptions, validFilterQuery } = useSearchAndFilter();
2002
- * ```
1914
+ * @example const { searchTerm, setSearchTerm, filterVisibility, setFilterVisibility, filters, setFilters, handleAddFilter, handleResetFilters, handleDeleteFilter, filterOptions, validFilterQuery } = useSearchAndFilter();
2003
1915
  */
2004
1916
  declare const useSearchAndFilter: () => {
2005
1917
  /** the search term value */
@@ -2036,7 +1948,7 @@ declare const useSearchAndFilter: () => {
2036
1948
 
2037
1949
  type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
2038
1950
  /** The filter controls to be displayed
2039
- * @defaultValue '<FilterControls />'
1951
+ * @default '<FilterControls />'
2040
1952
  */
2041
1953
  filterControls?: React$1.ReactNode;
2042
1954
  /** sets the filter mode */
@@ -2048,7 +1960,7 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
2048
1960
  /** Whether data is currently loading */
2049
1961
  isLoading?: boolean;
2050
1962
  /** The results container view
2051
- * @defaultValue '<SearchAndFilterResultContainer />'
1963
+ * @default '<SearchAndFilterResultContainer />'
2052
1964
  */
2053
1965
  resultsContainerView?: React$1.ReactNode;
2054
1966
  /** sets the reset filter values */
@@ -2062,10 +1974,7 @@ type SearchAndFilterProps = Omit<SearchAndFilterProviderProps, 'children'> & {
2062
1974
  };
2063
1975
  /**
2064
1976
  * Search and filter component
2065
- * @example
2066
- * ```tsx
2067
- * <SearchAndFilter filters={filters} filterOptions={filterOptions} onChange={onChange} onSearchChange={onSearchChange} onSearchReset={onSearchReset} totalResults={totalResults} />
2068
- * ```
1977
+ * @example <SearchAndFilter filters={filters} filterOptions={filterOptions} onChange={onChange} onSearchChange={onSearchChange} onSearchReset={onSearchReset} totalResults={totalResults} />
2069
1978
  * */
2070
1979
  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;
2071
1980
 
@@ -2088,10 +1997,7 @@ type SearchAndFilterOptionsContainerProps = {
2088
1997
  };
2089
1998
  /**
2090
1999
  * A container component for search and filter options
2091
- * @example
2092
- * ```tsx
2093
- * <SearchAndFilterOptionsContainer buttonRow={<button>Button</button>}>Children</SearchAndFilterOptionsContainer>
2094
- * ```
2000
+ * @example <SearchAndFilterOptionsContainer buttonRow={<button>Button</button>}>Children</SearchAndFilterOptionsContainer>
2095
2001
  * */
2096
2002
  declare const SearchAndFilterOptionsContainer: ({ buttonRow, additionalFiltersContainer, children, }: SearchAndFilterOptionsContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
2097
2003
  type FiltersProps = {
@@ -2106,23 +2012,20 @@ type FiltersProps = {
2106
2012
  /** Sets the data-test-id attribute for the filter menu */
2107
2013
  dataTestId?: string;
2108
2014
  /** The text for the reset button
2109
- * @defaultValue 'reset'
2015
+ * @default 'reset'
2110
2016
  */
2111
2017
  resetButtonText?: string;
2112
2018
  additionalFiltersContainer?: SearchAndFilterProps['additionalFiltersContainer'];
2113
2019
  };
2114
2020
  /**
2115
2021
  * A filter menu component used to display filter options
2116
- * @example
2117
- * ```tsx
2118
- * <FilterMenu id="search-and-filter-options">Children</FilterMenu>
2119
- * ```
2022
+ * @example <FilterMenu id="search-and-filter-options">Children</FilterMenu>
2120
2023
  * */
2121
2024
  declare const FilterMenu: ({ id, filterTitle, menuControls, additionalFiltersContainer, children, dataTestId, resetButtonText, }: FiltersProps) => _emotion_react_jsx_runtime.JSX.Element;
2122
2025
 
2123
2026
  type SearchAndFilterResultContainerProps = {
2124
2027
  /** The label for the clear button
2125
- * @defaultValue 'Clear'
2028
+ * @default 'Clear'
2126
2029
  */
2127
2030
  clearButtonLabel?: string;
2128
2031
  /** The text for the button */
@@ -2142,7 +2045,7 @@ declare const SearchAndFilterResultContainer: ({ buttonText, clearButtonLabel, c
2142
2045
  declare const SearchOnlyContext: React$1.Context<Pick<SearchAndFilterContextProps, "searchTerm" | "setSearchTerm">>;
2143
2046
  type SearchOnlyProviderProps = Pick<SearchAndFilterProviderProps, 'onSearchChange'> & {
2144
2047
  /** sets the max width of input wrapper
2145
- * @defaultValue '712px'
2048
+ * @default '712px'
2146
2049
  */
2147
2050
  maxWidth?: string;
2148
2051
  };
@@ -2150,11 +2053,11 @@ declare const SearchOnlyFilter: ({ onSearchChange, maxWidth }: SearchOnlyProvide
2150
2053
 
2151
2054
  type SortItemsProps = {
2152
2055
  /** The label for the sort by field
2153
- * @defaultValue 'Sort by'
2056
+ * @default 'Sort by'
2154
2057
  */
2155
2058
  sortByLabel?: string;
2156
2059
  /** The label for the locale returned field
2157
- * @defaultValue 'Enabled locale'
2060
+ * @default 'Enabled locale'
2158
2061
  */
2159
2062
  localeLabel?: string;
2160
2063
  /** sets the list of sort options */
@@ -2246,8 +2149,8 @@ declare function useUniformMeshSdk(): _uniformdev_mesh_sdk.UniformMeshSDK;
2246
2149
  /**
2247
2150
  * Creates a validation interceptor between useMeshLocation's setValue function and your code.
2248
2151
  * You can use this utility to write cleaner validation logic for your Mesh Location UIs.
2249
- * @param setValue - The location's raw setValue function
2250
- * @param validate - A function to validate the new location's value.
2152
+ * @param setValue The location's raw setValue function
2153
+ * @param validate A function to validate the new location's value.
2251
2154
  * @returns An equivalent to the setValue function that intercepts sets, performs validation, and emits the result with the new value.
2252
2155
  */
2253
2156
  declare function createLocationValidator<TSetValue>(setValue: SetLocationValueDispatch<TSetValue>, validate: (newValue: TSetValue, currentResult: SetValueOptions | undefined) => SetValueOptions): SetLocationValueDispatch<TSetValue>;
@@ -2256,11 +2159,7 @@ type ContentDataResourceLocaleInfoResult = {
2256
2159
  /**
2257
2160
  * Effective locale for data resource. It can be one of two types:
2258
2161
  * - raw locale string - locale stored in mesh data type/resource (e.g. 'en-US')
2259
- * - variable reference - locale stored in mesh data type/resource as a variable reference
2260
- * @example
2261
- * ```
2262
- * ${locale}
2263
- * ```
2162
+ * - variable reference - locale stored in mesh data type/resource as a variable reference (e.g. '${locale}')
2264
2163
  */
2265
2164
  effectiveLocale: string;
2266
2165
  /** Bound locale value. It can be one of two types:
@@ -2274,11 +2173,7 @@ type ContentDataResourceLocaleInfoProps = {
2274
2173
  * It can be one of tree types:
2275
2174
  * - undefined - no locale stored in mesh data type/resource yet or it is not localized
2276
2175
  * - raw locale string - locale stored in mesh data type/resource (e.g. 'en-US')
2277
- * - variable reference - locale stored in mesh data type/resource as a variable reference
2278
- * @example
2279
- * ```
2280
- * ${locale}
2281
- * ```
2176
+ * - variable reference - locale stored in mesh data type/resource as a variable reference (e.g. '${locale}')
2282
2177
  *
2283
2178
  * If locale is empty, fallback to dynamic locale value if it is available.
2284
2179
  */
@@ -2287,7 +2182,7 @@ type ContentDataResourceLocaleInfoProps = {
2287
2182
  defaultLocale: string | undefined;
2288
2183
  /** Map of dynamic inputs for current composition. Should be passed down from DataResource metadata */
2289
2184
  dynamicInputs: DynamicInputs;
2290
- /** In case of empty locale value, this method is called to bind dynamic locale */
2185
+ /** In case of empty locale value, this method is called to bind dynamic locale (sets locale to '${locale}') */
2291
2186
  setLocale?: (locale: string) => void;
2292
2187
  };
2293
2188
  declare function useContentDataResourceLocaleInfo({ locale, defaultLocale, setLocale, dynamicInputs, }: ContentDataResourceLocaleInfoProps): ContentDataResourceLocaleInfoResult;