@rippling/pebble-sdui-web 0.18.2 → 0.18.4
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/catalogs/custom-apps/catalog.d.ts +1 -1
- package/dist/catalogs/custom-apps/component-props.d.ts +44 -5
- package/dist/catalogs/custom-apps/components.d.ts +35 -35
- package/dist/catalogs/custom-apps/index.cjs +2 -2
- package/dist/catalogs/custom-apps/index.cjs.map +1 -1
- package/dist/catalogs/custom-apps/index.d.ts +1 -1
- package/dist/catalogs/custom-apps/index.js +1003 -29
- package/dist/catalogs/custom-apps/index.js.map +1 -1
- package/dist/docs/typescript/web/catalogs/custom-apps/components.md +39 -3
- package/dist/docs/typescript/web/catalogs/custom-apps/definitions.md +99 -2
- package/dist/docs/typescript/web/catalogs/custom-apps/readme.md +1 -1
- package/dist/docs/typescript/web/catalogs/custom-apps/types.md +72 -0
- package/package.json +1 -1
|
@@ -255,7 +255,7 @@ No additional properties.
|
|
|
255
255
|
|
|
256
256
|
A visual representation of an entity, such as a user, organization, or product. Use circular shape (isRounded=true) for people and rounded square (isRounded=false) for non-human entities like organizations or brands.
|
|
257
257
|
|
|
258
|
-
Type semantics: USER is the default for people (shows image or initials fallback). TEXT shows first+last initials from title. ICON displays a specified icon to represent an entity. NUMBER indicates overflow count in avatar lists. RIPPLING is
|
|
258
|
+
Type semantics: USER is the default for people (shows image or initials fallback). TEXT shows first+last initials from title. ICON displays a specified icon to represent an entity. LOGO renders a known brand from Avatar.LOGOS and falls back to an icon placeholder while loading or on failure. NUMBER indicates overflow count in avatar lists. RIPPLING is the dedicated Rippling brand path. Badge and flag are mutually exclusive — use either badge or flagCountryCode, not both. When using flagCountryCode, surfaceColor is required. tip.content accepts a plain string for tooltip text shown on hover.
|
|
259
259
|
|
|
260
260
|
Catalog key: `Avatar`
|
|
261
261
|
Builder: `Avatar`
|
|
@@ -279,6 +279,8 @@ Events: `press`
|
|
|
279
279
|
| `imageBackground` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | Surface color token behind the avatar image |
|
|
280
280
|
| `isCompact` | no | boolean | Compact mode hides title and caption. Default: false |
|
|
281
281
|
| `isRounded` | no | boolean | Fully rounded (circle) shape. Default: true |
|
|
282
|
+
| `logo` | no | [AvatarLogo](./definitions.md#avatarlogo) | Logo id from Avatar.LOGOS when type is LOGO |
|
|
283
|
+
| `placeholderIcon` | no | string \| [AvatarPlaceholderIcon](./types.md#avatarplaceholdericon) | Placeholder icon for LOGO avatars while loading or if the logo cannot be shown. Defaults to IMAGE_OUTLINE |
|
|
282
284
|
| `size` | no | 24 \| 32 \| 40 \| 56 \| 64 | Avatar size in pixels. One of: 24, 32, 40, 56, 64. Default: 40 |
|
|
283
285
|
| `surfaceColor` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | Surface color for flag background. Pebble color token. Required with flagCountryCode |
|
|
284
286
|
| `tip` | no | [AvatarTip](./types.md#avatartip) | Tooltip shown on avatar hover. Object with content string and optional title |
|
|
@@ -310,6 +312,7 @@ Events: _none_
|
|
|
310
312
|
| `aria-labelledby` | no | string | ID of element that labels the avatar list |
|
|
311
313
|
| `isRounded` | no | boolean | If false, avatars render as rounded squares |
|
|
312
314
|
| `limit` | no | number | Maximum number of avatars to display before +N overflow |
|
|
315
|
+
| `logo` | no | [AvatarLogo](./definitions.md#avatarlogo) | Shared logo id for list-level LOGO avatars. Prefer roles[].avatar.logo when entries differ |
|
|
313
316
|
| `modalTitle` | no | string | Title of the modal shown when clicking overflow |
|
|
314
317
|
| `roles` | no | [Role](./types.md#role)[] | Array of role/person objects for avatars |
|
|
315
318
|
| `size` | no | 24 \| 32 \| 40 \| 56 \| 64 | Avatar size in pixels. One of: 24, 32, 40, 56, 64. Default: 40 |
|
|
@@ -1590,7 +1593,7 @@ No additional properties.
|
|
|
1590
1593
|
|
|
1591
1594
|
A layout wrapper that provides consistent structure around form inputs, including a label, required indicator, helper or error message, tooltip, read-only mode, and inline (side-by-side) layout option. Use Field to wrap any form input component.
|
|
1592
1595
|
|
|
1593
|
-
Field is a layout wrapper for form inputs. Place the actual input component
|
|
1596
|
+
Field is a layout wrapper for form inputs. Place the actual input component in `children`. Use the string `label` prop for plain text or `slots.label` for rich label content; the named slot takes precedence. helperMessage can be a plain string or an object { message, status } where status "ERROR" shows the message as an error.
|
|
1594
1597
|
|
|
1595
1598
|
Catalog key: `Field`
|
|
1596
1599
|
Builder: `Field`
|
|
@@ -1812,7 +1815,7 @@ Stores a boolean (true/false) value keyed by `name` in the parent Form's values.
|
|
|
1812
1815
|
Use `defaultValue: true` to pre-check the box.
|
|
1813
1816
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync. Reads initial value from state (controlled); access current value in on.change actions via `{ $state: "/path" }`.
|
|
1814
1817
|
onChange emits "change".
|
|
1815
|
-
Rich labels:
|
|
1818
|
+
Rich labels: `slots.label` takes precedence over legacy label children, which take precedence over the string `label` prop. Use Text with inline=true so copy and links flow inline, and Link with href. Note: the label container programmatically clicks the input, so clicking an embedded Link will also toggle the checkbox. Prefer the plain string `label` for simple text.
|
|
1816
1819
|
|
|
1817
1820
|
Catalog key: `FormCheckbox`
|
|
1818
1821
|
Builder: `FormCheckbox`
|
|
@@ -1848,6 +1851,7 @@ No additional properties.
|
|
|
1848
1851
|
|
|
1849
1852
|
A Form-registered checkbox group for use inside a Form component.
|
|
1850
1853
|
|
|
1854
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
1851
1855
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
1852
1856
|
Stores an array of selected values keyed by `name` in the parent Form's values.
|
|
1853
1857
|
Uses Form.Input.Checkbox.Group internally — the Form-aware variant of CheckboxGroup.
|
|
@@ -1908,6 +1912,7 @@ No additional properties.
|
|
|
1908
1912
|
|
|
1909
1913
|
A Form-registered currency field for use inside a Form component.
|
|
1910
1914
|
|
|
1915
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
1911
1916
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
1912
1917
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
1913
1918
|
Use `prefix` to set the currency symbol (e.g. "USD", "$").
|
|
@@ -1951,6 +1956,7 @@ No additional properties.
|
|
|
1951
1956
|
|
|
1952
1957
|
A Form-registered date picker for use inside a Form component.
|
|
1953
1958
|
|
|
1959
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
1954
1960
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
1955
1961
|
Stores a date string in the chosen format (default: `yyyy-MM-dd`) keyed by `name` in the parent Form's values.
|
|
1956
1962
|
Always supply defaultValue as a yyyy-MM-dd string regardless of the display format.
|
|
@@ -1996,6 +2002,7 @@ No additional properties.
|
|
|
1996
2002
|
|
|
1997
2003
|
A Form-registered date range picker for selecting start and end dates inside a Form component.
|
|
1998
2004
|
|
|
2005
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
1999
2006
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2000
2007
|
Stores an array of two date strings [startDate, endDate] keyed by `name` in the parent Form values.
|
|
2001
2008
|
Bind `value` with `{ $bindState: "/path" }` to initialize the range picker from state and keep state in sync.
|
|
@@ -2049,6 +2056,7 @@ No additional properties.
|
|
|
2049
2056
|
|
|
2050
2057
|
A Form-registered day-of-week selector for use inside a Form component.
|
|
2051
2058
|
|
|
2059
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2052
2060
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2053
2061
|
Single-select stores a day name string; isMulti stores an array of day name strings.
|
|
2054
2062
|
Valid day names: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
|
|
@@ -2085,6 +2093,7 @@ No additional properties.
|
|
|
2085
2093
|
|
|
2086
2094
|
A Form-registered email field with built-in email validation, for use inside a Form component.
|
|
2087
2095
|
|
|
2096
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2088
2097
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2089
2098
|
Pebble applies isEmail validation by default for Form.Input.Email.
|
|
2090
2099
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
@@ -2157,6 +2166,7 @@ No additional properties.
|
|
|
2157
2166
|
|
|
2158
2167
|
A Form-registered file upload field for use inside a Form component.
|
|
2159
2168
|
|
|
2169
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2160
2170
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2161
2171
|
Individual values are not bound to state; they flow through the parent Form's `values` push-binding on submit/change.
|
|
2162
2172
|
Use `validations` for Form rule strings.
|
|
@@ -2205,6 +2215,7 @@ No additional properties.
|
|
|
2205
2215
|
|
|
2206
2216
|
A Form-registered file upload field for use inside a Form component.
|
|
2207
2217
|
|
|
2218
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2208
2219
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2209
2220
|
Individual values are not bound to state; they flow through the parent Form's `values` push-binding on submit/change.
|
|
2210
2221
|
Use `validations` for Form rule strings.
|
|
@@ -2351,6 +2362,7 @@ No additional properties.
|
|
|
2351
2362
|
|
|
2352
2363
|
A Form-registered grouped input layout that combines one main input with optional prefix and suffix inputs.
|
|
2353
2364
|
|
|
2365
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2354
2366
|
Must be placed inside a Form element.
|
|
2355
2367
|
`input`, `prefix`, and `suffix` use the same input configuration shape as standalone InputGroup; their `inputProps` are direct Pebble input props.
|
|
2356
2368
|
For nested Select inputs, use Pebble `list` instead of the json-render Select catalog `options` prop.
|
|
@@ -2397,6 +2409,7 @@ No additional properties.
|
|
|
2397
2409
|
|
|
2398
2410
|
A Form-registered masked text input for values with a fixed format.
|
|
2399
2411
|
|
|
2412
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2400
2413
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2401
2414
|
Mask characters: 9 = digit, a = letter, * = any character.
|
|
2402
2415
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync.
|
|
@@ -2446,6 +2459,7 @@ No additional properties.
|
|
|
2446
2459
|
|
|
2447
2460
|
A Form-registered numeric field for use inside a Form component.
|
|
2448
2461
|
|
|
2462
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2449
2463
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2450
2464
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
2451
2465
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync. Reads initial value from state (controlled); access current value in on.change actions via `{ $state: "/path" }`.
|
|
@@ -2500,6 +2514,7 @@ No additional properties.
|
|
|
2500
2514
|
|
|
2501
2515
|
A Form-registered password field with show/hide toggle, for use inside a Form component.
|
|
2502
2516
|
|
|
2517
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2503
2518
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2504
2519
|
Includes a built-in show/hide toggle for the password.
|
|
2505
2520
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
@@ -2551,6 +2566,7 @@ No additional properties.
|
|
|
2551
2566
|
|
|
2552
2567
|
A Form-registered percentage field for use inside a Form component.
|
|
2553
2568
|
|
|
2569
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2554
2570
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2555
2571
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
2556
2572
|
Use `lowerLimit` and `upperLimit` to constrain the allowed range.
|
|
@@ -2595,6 +2611,7 @@ No additional properties.
|
|
|
2595
2611
|
|
|
2596
2612
|
A Form-registered phone number field with region-based formatting, for use inside a Form component.
|
|
2597
2613
|
|
|
2614
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2598
2615
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2599
2616
|
Stores the formatted phone number string keyed by `name` in the parent Form's values.
|
|
2600
2617
|
Use defaultRegion to set the formatting region (US, IN, CA, etc.). Defaults to US.
|
|
@@ -2646,6 +2663,7 @@ No additional properties.
|
|
|
2646
2663
|
|
|
2647
2664
|
A Form-registered radio group for use inside a Form component.
|
|
2648
2665
|
|
|
2666
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2649
2667
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2650
2668
|
Stores the selected option's `value` keyed by `name` in the parent Form's values.
|
|
2651
2669
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync. Reads initial value from state (controlled); access current value in on.change actions via `{ $state: "/path" }`.
|
|
@@ -2716,6 +2734,7 @@ No additional properties.
|
|
|
2716
2734
|
|
|
2717
2735
|
A Form-registered segmented control for use inside a Form component.
|
|
2718
2736
|
|
|
2737
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2719
2738
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2720
2739
|
Single-select stores a string; isMulti stores an array of strings.
|
|
2721
2740
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
@@ -2757,6 +2776,7 @@ No additional properties.
|
|
|
2757
2776
|
|
|
2758
2777
|
A Form-registered dropdown select for use inside a Form component.
|
|
2759
2778
|
|
|
2779
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2760
2780
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2761
2781
|
Single-select stores the selected value; isMulti stores an array of selected values.
|
|
2762
2782
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
@@ -2811,6 +2831,7 @@ No additional properties.
|
|
|
2811
2831
|
|
|
2812
2832
|
A Form-registered card-based selection group for single or multi-choice choices inside a Form.
|
|
2813
2833
|
|
|
2834
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2814
2835
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2815
2836
|
Single-select stores one value; `isMulti` stores an array of selected values.
|
|
2816
2837
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync.
|
|
@@ -2853,6 +2874,7 @@ No additional properties.
|
|
|
2853
2874
|
|
|
2854
2875
|
A Form-registered signature capture input for drawing or typing a signature inside a Form.
|
|
2855
2876
|
|
|
2877
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2856
2878
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
2857
2879
|
Stores a base64 PNG data URL string keyed by `name` in the parent Form values.
|
|
2858
2880
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync.
|
|
@@ -2894,6 +2916,7 @@ No additional properties.
|
|
|
2894
2916
|
|
|
2895
2917
|
A Form-registered SIN (Social Insurance Number) masked field for use inside a Form. Applies the Canadian SIN format mask (999 999 999) automatically.
|
|
2896
2918
|
|
|
2919
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2897
2920
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2898
2921
|
The Canadian SIN mask (999 999 999) is applied automatically — no need to configure the mask.
|
|
2899
2922
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync. Reads initial value from state (controlled); access current value in on.change actions via `{ $state: "/path" }`.
|
|
@@ -2931,6 +2954,7 @@ No additional properties.
|
|
|
2931
2954
|
|
|
2932
2955
|
A Form-registered slider for use inside a Form component.
|
|
2933
2956
|
|
|
2957
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2934
2958
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2935
2959
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
2936
2960
|
Use `marks` to label specific positions on the slider track.
|
|
@@ -2973,6 +2997,7 @@ No additional properties.
|
|
|
2973
2997
|
|
|
2974
2998
|
A Form-registered SSN (Social Security Number) masked field for use inside a Form. Applies the US SSN format mask (999-99-9999) automatically.
|
|
2975
2999
|
|
|
3000
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
2976
3001
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
2977
3002
|
The US SSN mask (999-99-9999) is applied automatically — no need to configure the mask.
|
|
2978
3003
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync. Reads initial value from state (controlled); access current value in on.change actions via `{ $state: "/path" }`.
|
|
@@ -3010,6 +3035,7 @@ No additional properties.
|
|
|
3010
3035
|
|
|
3011
3036
|
A Form-registered survey/rating input for collecting a bounded opinion or score inside a Form.
|
|
3012
3037
|
|
|
3038
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3013
3039
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
3014
3040
|
Single-select stores one value; `isMulti` stores an array of selected values.
|
|
3015
3041
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync.
|
|
@@ -3049,6 +3075,7 @@ No additional properties.
|
|
|
3049
3075
|
|
|
3050
3076
|
A Form-registered toggle switch for use inside a Form component.
|
|
3051
3077
|
|
|
3078
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3052
3079
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
3053
3080
|
Stores a boolean (true/false) value keyed by `name` in the parent Form's values.
|
|
3054
3081
|
Use `defaultValue: true` to pre-toggle the switch on.
|
|
@@ -3096,6 +3123,7 @@ Browser/input behavior props such as `minLength`, `autoCapitalize`, `autoCorrect
|
|
|
3096
3123
|
Use `validationErrors` to override default error messages per rule.
|
|
3097
3124
|
`helperMessage` displays supporting text below the input. Validation errors temporarily replace it, and it returns when validation clears.
|
|
3098
3125
|
`isRequired` blocks form submission when empty and shows an error.
|
|
3126
|
+
Labels: use the string `label` prop for plain text. For rich labels, provide element IDs through the named `slots.label` slot; it takes precedence over `label` and can compose inline Text, Link, or other renderable SDUI elements.
|
|
3099
3127
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync. Reads initial value from state (controlled); access current value in on.change actions via `{ $state: "/path" }`.
|
|
3100
3128
|
onChange emits "change"; onBlur emits "blur".
|
|
3101
3129
|
|
|
@@ -3145,6 +3173,7 @@ No additional properties.
|
|
|
3145
3173
|
|
|
3146
3174
|
A Form-registered multi-line textarea for use inside a Form component.
|
|
3147
3175
|
|
|
3176
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3148
3177
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
3149
3178
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
3150
3179
|
Set hasCharsLimit with maxLength to show a character counter.
|
|
@@ -3188,6 +3217,7 @@ No additional properties.
|
|
|
3188
3217
|
|
|
3189
3218
|
A Form-registered text field with auto-suggest dropdown for use inside a Form component.
|
|
3190
3219
|
|
|
3220
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3191
3221
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
3192
3222
|
Values flow through the parent Form's `values` push-binding on submit/change.
|
|
3193
3223
|
Pass `list` as the React-style flat suggestion list. Common fields are `label`, `value`, and `isDisabled`; extra serializable item metadata is preserved.
|
|
@@ -3230,6 +3260,7 @@ No additional properties.
|
|
|
3230
3260
|
|
|
3231
3261
|
A Form-registered time picker field for use inside a Form component.
|
|
3232
3262
|
|
|
3263
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3233
3264
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
3234
3265
|
Accepts ISO 8601 time strings or "HH:MM AM/PM" format as defaultValue.
|
|
3235
3266
|
Use timezone to specify the IANA timezone name for display and value handling.
|
|
@@ -3279,6 +3310,7 @@ No additional properties.
|
|
|
3279
3310
|
|
|
3280
3311
|
A Form-registered timezone selector for choosing an IANA timezone inside a Form.
|
|
3281
3312
|
|
|
3313
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3282
3314
|
Must be placed inside a Form element — registers with Form and does not work standalone.
|
|
3283
3315
|
Stores an IANA timezone identifier string keyed by `name` in the parent Form values.
|
|
3284
3316
|
Bind `value` with `{ $bindState: "/path" }` to initialize the input from state and keep state in sync.
|
|
@@ -3326,6 +3358,7 @@ No additional properties.
|
|
|
3326
3358
|
|
|
3327
3359
|
A Form-registered tree selection field for use inside a Form component.
|
|
3328
3360
|
|
|
3361
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3329
3362
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
3330
3363
|
Set parent to the value of the parent node to build tree hierarchy; null for root nodes.
|
|
3331
3364
|
Use isMulti to allow selecting multiple nodes.
|
|
@@ -3376,6 +3409,7 @@ No additional properties.
|
|
|
3376
3409
|
|
|
3377
3410
|
A Form-registered tree-select dropdown field for use inside a Form component.
|
|
3378
3411
|
|
|
3412
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3379
3413
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
3380
3414
|
Set parent to the value of the parent node to build tree hierarchy; null for root nodes.
|
|
3381
3415
|
Use isMulti to allow selecting multiple values displayed as chips.
|
|
@@ -3430,6 +3464,7 @@ No additional properties.
|
|
|
3430
3464
|
|
|
3431
3465
|
A Form-registered work email field for use inside a Form component.
|
|
3432
3466
|
|
|
3467
|
+
Labels: use the string `label` prop for plain text or provide element IDs through `slots.label` for rich content; the named slot takes precedence over the string fallback.
|
|
3433
3468
|
Must be placed inside a Form element — it registers with Form and does not work standalone.
|
|
3434
3469
|
Use domainList to restrict suggestions to specific email domains.
|
|
3435
3470
|
The field validates email format automatically.
|
|
@@ -6047,6 +6082,7 @@ Use prefix/suffix for units or icons - pass Icon.TYPES names like "SEARCH_OUTLIN
|
|
|
6047
6082
|
Use inputMode to hint the virtual keyboard type on mobile devices
|
|
6048
6083
|
Use stringPadding to automatically pad values (e.g., "1" → "001" with {position: "start", maxLength: 3, character: "0"})
|
|
6049
6084
|
ARIA attributes support accessibility - use aria-label or aria-labelledby for screen reader labels
|
|
6085
|
+
Use the string `label` prop for plain text. For rich labels, provide element IDs through `slots.label`; the named slot takes precedence over the string fallback.
|
|
6050
6086
|
Standalone — does not register with Form; use FormText inside a Form instead.
|
|
6051
6087
|
|
|
6052
6088
|
Catalog key: `TextInput`
|
|
@@ -156,6 +156,9 @@ Referenced by:
|
|
|
156
156
|
| component | `ToggleableArrow` | `arrowUpColor` |
|
|
157
157
|
| component | `VStack` | `color` |
|
|
158
158
|
| type | `AvatarIcon` | `color` |
|
|
159
|
+
| type | `AvatarListIcon` | `color` |
|
|
160
|
+
| type | `AvatarListPlaceholderIcon` | `color` |
|
|
161
|
+
| type | `AvatarPlaceholderIcon` | `color` |
|
|
159
162
|
| type | `ButtonIcon` | `color` |
|
|
160
163
|
| type | `ChipIcon` | `color` |
|
|
161
164
|
| type | `CountryIcon` | `color` |
|
|
@@ -170,6 +173,7 @@ Referenced by:
|
|
|
170
173
|
| type | `ObjectUIStatsAction` | `color` |
|
|
171
174
|
| type | `ObjectUIStatsLeftIcon` | `color` |
|
|
172
175
|
| type | `ObjectUIStatsRightIcon` | `color` |
|
|
176
|
+
| type | `StepperPlaceholderIcon` | `color` |
|
|
173
177
|
|
|
174
178
|
## AiIconSize
|
|
175
179
|
|
|
@@ -544,17 +548,107 @@ Referenced by:
|
|
|
544
548
|
| component | `SupportButton` | `imageBackground` |
|
|
545
549
|
| component | `VStack` | `backgroundColor` |
|
|
546
550
|
| type | `AvatarIcon` | `backgroundColor` |
|
|
551
|
+
| type | `AvatarListIcon` | `backgroundColor` |
|
|
552
|
+
| type | `AvatarListPlaceholderIcon` | `backgroundColor` |
|
|
553
|
+
| type | `AvatarPlaceholderIcon` | `backgroundColor` |
|
|
547
554
|
| type | `FormSurveyList` | `selectionColor` |
|
|
548
555
|
| type | `ObjectUIAvatarProp` | `imageBackground` |
|
|
549
556
|
| type | `ObjectUIHeaderAvatarProp` | `imageBackground` |
|
|
557
|
+
| type | `StepperPlaceholderIcon` | `backgroundColor` |
|
|
550
558
|
| type | `SurveyList` | `selectionColor` |
|
|
551
559
|
|
|
560
|
+
## AvatarLogo
|
|
561
|
+
|
|
562
|
+
TypeScript type:
|
|
563
|
+
|
|
564
|
+
```ts
|
|
565
|
+
"amplitude" | "asana" | "ashby" | "atlassian" | "bitrise" | "box" | "buildkite" | "cloudflare" | "contentful" | "context7" | "datadog" | "deel" | "dropbox" | "excalidraw" | "expo" | "figma" | "gem" | "github" | "gitlab" | "gmail" | "gong" | "googlecalendar" | "googlechat" | "googledocs" | "googledrive" | "googleforms" | "googlesheets" | "googleslides" | "googleworkspace" | "greenhouse" | "incidentio" | "ironclad" | "iterable" | "jumpcloud" | "launchdarkly" | "linear" | "logrocket" | "lucid" | "mermaidchart" | "metaview" | "microsoftcalendar" | "microsoftexcel" | "microsoftonedrive" | "microsoftoutlook" | "microsoftteams" | "microsoftword" | "mutiny" | "netsuite" | "notion" | "peopleapi" | "ramp" | "ranger" | "rippling" | "salesforce" | "sendoso" | "sentry" | "slack" | "snowflake" | "stripe" | "symmetrypayroll" | "vantage" | "zoom"
|
|
566
|
+
```
|
|
567
|
+
|
|
568
|
+
Allowed values:
|
|
569
|
+
|
|
570
|
+
| Value |
|
|
571
|
+
|---|
|
|
572
|
+
| `amplitude` |
|
|
573
|
+
| `asana` |
|
|
574
|
+
| `ashby` |
|
|
575
|
+
| `atlassian` |
|
|
576
|
+
| `bitrise` |
|
|
577
|
+
| `box` |
|
|
578
|
+
| `buildkite` |
|
|
579
|
+
| `cloudflare` |
|
|
580
|
+
| `contentful` |
|
|
581
|
+
| `context7` |
|
|
582
|
+
| `datadog` |
|
|
583
|
+
| `deel` |
|
|
584
|
+
| `dropbox` |
|
|
585
|
+
| `excalidraw` |
|
|
586
|
+
| `expo` |
|
|
587
|
+
| `figma` |
|
|
588
|
+
| `gem` |
|
|
589
|
+
| `github` |
|
|
590
|
+
| `gitlab` |
|
|
591
|
+
| `gmail` |
|
|
592
|
+
| `gong` |
|
|
593
|
+
| `googlecalendar` |
|
|
594
|
+
| `googlechat` |
|
|
595
|
+
| `googledocs` |
|
|
596
|
+
| `googledrive` |
|
|
597
|
+
| `googleforms` |
|
|
598
|
+
| `googlesheets` |
|
|
599
|
+
| `googleslides` |
|
|
600
|
+
| `googleworkspace` |
|
|
601
|
+
| `greenhouse` |
|
|
602
|
+
| `incidentio` |
|
|
603
|
+
| `ironclad` |
|
|
604
|
+
| `iterable` |
|
|
605
|
+
| `jumpcloud` |
|
|
606
|
+
| `launchdarkly` |
|
|
607
|
+
| `linear` |
|
|
608
|
+
| `logrocket` |
|
|
609
|
+
| `lucid` |
|
|
610
|
+
| `mermaidchart` |
|
|
611
|
+
| `metaview` |
|
|
612
|
+
| `microsoftcalendar` |
|
|
613
|
+
| `microsoftexcel` |
|
|
614
|
+
| `microsoftonedrive` |
|
|
615
|
+
| `microsoftoutlook` |
|
|
616
|
+
| `microsoftteams` |
|
|
617
|
+
| `microsoftword` |
|
|
618
|
+
| `mutiny` |
|
|
619
|
+
| `netsuite` |
|
|
620
|
+
| `notion` |
|
|
621
|
+
| `peopleapi` |
|
|
622
|
+
| `ramp` |
|
|
623
|
+
| `ranger` |
|
|
624
|
+
| `rippling` |
|
|
625
|
+
| `salesforce` |
|
|
626
|
+
| `sendoso` |
|
|
627
|
+
| `sentry` |
|
|
628
|
+
| `slack` |
|
|
629
|
+
| `snowflake` |
|
|
630
|
+
| `stripe` |
|
|
631
|
+
| `symmetrypayroll` |
|
|
632
|
+
| `vantage` |
|
|
633
|
+
| `zoom` |
|
|
634
|
+
|
|
635
|
+
Referenced by:
|
|
636
|
+
|
|
637
|
+
| Kind | Entity | Field |
|
|
638
|
+
|---|---|---|
|
|
639
|
+
| component | `Avatar` | `logo` |
|
|
640
|
+
| component | `AvatarList` | `logo` |
|
|
641
|
+
| type | `AvatarListAvatar` | `logo` |
|
|
642
|
+
| type | `ObjectUIAvatarProp` | `logo` |
|
|
643
|
+
| type | `ObjectUIHeaderAvatarProp` | `logo` |
|
|
644
|
+
| type | `StepperAvatar` | `logo` |
|
|
645
|
+
|
|
552
646
|
## AvatarType
|
|
553
647
|
|
|
554
648
|
TypeScript type:
|
|
555
649
|
|
|
556
650
|
```ts
|
|
557
|
-
"USER" | "ICON" | "TEXT" | "NUMBER" | "RIPPLING"
|
|
651
|
+
"USER" | "ICON" | "TEXT" | "NUMBER" | "RIPPLING" | "LOGO"
|
|
558
652
|
```
|
|
559
653
|
|
|
560
654
|
Allowed values:
|
|
@@ -566,6 +660,7 @@ Allowed values:
|
|
|
566
660
|
| `TEXT` |
|
|
567
661
|
| `NUMBER` |
|
|
568
662
|
| `RIPPLING` |
|
|
663
|
+
| `LOGO` |
|
|
569
664
|
|
|
570
665
|
Referenced by:
|
|
571
666
|
|
|
@@ -573,6 +668,7 @@ Referenced by:
|
|
|
573
668
|
|---|---|---|
|
|
574
669
|
| component | `Avatar` | `type` |
|
|
575
670
|
| component | `AvatarList` | `type` |
|
|
671
|
+
| type | `AvatarListAvatar` | `type` |
|
|
576
672
|
| type | `ObjectUIAvatarProp` | `type` |
|
|
577
673
|
| type | `ObjectUIHeaderAvatarProp` | `type` |
|
|
578
674
|
|
|
@@ -4104,7 +4200,7 @@ Referenced by:
|
|
|
4104
4200
|
TypeScript type:
|
|
4105
4201
|
|
|
4106
4202
|
```ts
|
|
4107
|
-
"ICON" | "RIPPLING" | "TEXT" | "USER" | "NUMBER"
|
|
4203
|
+
"ICON" | "RIPPLING" | "TEXT" | "USER" | "NUMBER" | "LOGO"
|
|
4108
4204
|
```
|
|
4109
4205
|
|
|
4110
4206
|
Allowed values:
|
|
@@ -4116,6 +4212,7 @@ Allowed values:
|
|
|
4116
4212
|
| `TEXT` |
|
|
4117
4213
|
| `USER` |
|
|
4118
4214
|
| `NUMBER` |
|
|
4215
|
+
| `LOGO` |
|
|
4119
4216
|
|
|
4120
4217
|
Referenced by:
|
|
4121
4218
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
# custom-apps Catalog
|
|
3
3
|
|
|
4
4
|
Catalog: `custom-apps`
|
|
5
|
-
Version: `1.9.
|
|
5
|
+
Version: `1.9.4`
|
|
6
6
|
SDK language: `typescript`
|
|
7
7
|
|
|
8
8
|
Use this catalog index after you have chosen this catalog for the spec. Do not mix components, actions, computed functions, or render helpers from another catalog unless that catalog explicitly documents compatibility.
|
|
@@ -287,6 +287,59 @@ No additional properties.
|
|
|
287
287
|
|
|
288
288
|
No additional properties.
|
|
289
289
|
|
|
290
|
+
## AvatarListAvatar
|
|
291
|
+
|
|
292
|
+
Per-role avatar overrides. Use this when different entries need different avatar types or logos
|
|
293
|
+
|
|
294
|
+
### Fields
|
|
295
|
+
|
|
296
|
+
| Name | Required | Type | Description |
|
|
297
|
+
|---|---:|---|---|
|
|
298
|
+
| `icon` | no | string \| [AvatarListIcon](./types.md#avatarlisticon) | Icon override when this role uses avatar type ICON |
|
|
299
|
+
| `image` | no | string | Avatar image URL override for this role |
|
|
300
|
+
| `isRounded` | no | boolean | Rounded shape override for this role |
|
|
301
|
+
| `logo` | no | [AvatarLogo](./definitions.md#avatarlogo) | Logo id from Avatar.LOGOS for this role |
|
|
302
|
+
| `placeholderIcon` | no | string \| [AvatarListPlaceholderIcon](./types.md#avatarlistplaceholdericon) | Placeholder icon shown while a role logo loads or if it cannot be shown |
|
|
303
|
+
| `type` | no | [AvatarType](./definitions.md#avatartype) | Avatar type override for this role |
|
|
304
|
+
|
|
305
|
+
No additional properties.
|
|
306
|
+
|
|
307
|
+
## AvatarListIcon
|
|
308
|
+
|
|
309
|
+
### Fields
|
|
310
|
+
|
|
311
|
+
| Name | Required | Type | Description |
|
|
312
|
+
|---|---:|---|---|
|
|
313
|
+
| `backgroundColor` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | |
|
|
314
|
+
| `color` | no | [ActionCardIconColor](./definitions.md#actioncardiconcolor) | |
|
|
315
|
+
| `type` | yes | string | |
|
|
316
|
+
|
|
317
|
+
No additional properties.
|
|
318
|
+
|
|
319
|
+
## AvatarListPlaceholderIcon
|
|
320
|
+
|
|
321
|
+
### Fields
|
|
322
|
+
|
|
323
|
+
| Name | Required | Type | Description |
|
|
324
|
+
|---|---:|---|---|
|
|
325
|
+
| `backgroundColor` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | |
|
|
326
|
+
| `color` | no | [ActionCardIconColor](./definitions.md#actioncardiconcolor) | |
|
|
327
|
+
| `type` | yes | string | |
|
|
328
|
+
|
|
329
|
+
No additional properties.
|
|
330
|
+
|
|
331
|
+
## AvatarPlaceholderIcon
|
|
332
|
+
|
|
333
|
+
### Fields
|
|
334
|
+
|
|
335
|
+
| Name | Required | Type | Description |
|
|
336
|
+
|---|---:|---|---|
|
|
337
|
+
| `backgroundColor` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | |
|
|
338
|
+
| `color` | no | [ActionCardIconColor](./definitions.md#actioncardiconcolor) | |
|
|
339
|
+
| `type` | yes | string | |
|
|
340
|
+
|
|
341
|
+
No additional properties.
|
|
342
|
+
|
|
290
343
|
## AvatarTip
|
|
291
344
|
|
|
292
345
|
Tooltip shown on avatar hover. Object with content string and optional title
|
|
@@ -3116,6 +3169,8 @@ Avatar configuration for the header
|
|
|
3116
3169
|
| `image` | no | string | Image URL for the avatar |
|
|
3117
3170
|
| `imageBackground` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | Surface color token for avatar image background |
|
|
3118
3171
|
| `isRound` | no | boolean | If false, square avatar is shown. Default: true |
|
|
3172
|
+
| `logo` | no | [AvatarLogo](./definitions.md#avatarlogo) | Logo id from Avatar.LOGOS when type is LOGO |
|
|
3173
|
+
| `placeholderIcon` | no | string | Placeholder icon for LOGO avatars while loading or if the logo cannot be shown |
|
|
3119
3174
|
| `type` | no | [AvatarType](./definitions.md#avatartype) | Avatar content type |
|
|
3120
3175
|
|
|
3121
3176
|
No additional properties.
|
|
@@ -3132,6 +3187,8 @@ Avatar configuration for the header
|
|
|
3132
3187
|
| `image` | no | string | Image URL for the avatar |
|
|
3133
3188
|
| `imageBackground` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | Surface color token for avatar image background |
|
|
3134
3189
|
| `isRound` | no | boolean | If false, square avatar is shown. Default: true |
|
|
3190
|
+
| `logo` | no | [AvatarLogo](./definitions.md#avatarlogo) | Logo id from Avatar.LOGOS when type is LOGO |
|
|
3191
|
+
| `placeholderIcon` | no | string | Placeholder icon for LOGO avatars while loading or if the logo cannot be shown |
|
|
3135
3192
|
| `type` | no | [AvatarType](./definitions.md#avatartype) | Avatar content type |
|
|
3136
3193
|
|
|
3137
3194
|
No additional properties.
|
|
@@ -3636,6 +3693,7 @@ Additional properties: string.
|
|
|
3636
3693
|
|
|
3637
3694
|
| Name | Required | Type | Description |
|
|
3638
3695
|
|---|---:|---|---|
|
|
3696
|
+
| `avatar` | no | [AvatarListAvatar](./types.md#avatarlistavatar) | Per-role avatar overrides. Use this when different entries need different avatar types or logos |
|
|
3639
3697
|
| `fullName` | no | string | Display name |
|
|
3640
3698
|
| `id` | no | string | Unique identifier |
|
|
3641
3699
|
| `image` | no | string | Avatar image URL |
|
|
@@ -4103,6 +4161,8 @@ Avatar configuration to display with the step. Supports image URLs
|
|
|
4103
4161
|
| Name | Required | Type | Description |
|
|
4104
4162
|
|---|---:|---|---|
|
|
4105
4163
|
| `imageUrl` | no | string | URL of the avatar image |
|
|
4164
|
+
| `logo` | no | [AvatarLogo](./definitions.md#avatarlogo) | Logo id from Avatar.LOGOS when type is LOGO |
|
|
4165
|
+
| `placeholderIcon` | no | string \| [StepperPlaceholderIcon](./types.md#stepperplaceholdericon) | Placeholder icon for LOGO avatars while loading or if the logo cannot be shown |
|
|
4106
4166
|
| `type` | no | [StepperAvatarType](./definitions.md#stepperavatartype) | Avatar type |
|
|
4107
4167
|
|
|
4108
4168
|
No additional properties.
|
|
@@ -4121,6 +4181,18 @@ Badge configuration to display alongside the step title
|
|
|
4121
4181
|
|
|
4122
4182
|
No additional properties.
|
|
4123
4183
|
|
|
4184
|
+
## StepperPlaceholderIcon
|
|
4185
|
+
|
|
4186
|
+
### Fields
|
|
4187
|
+
|
|
4188
|
+
| Name | Required | Type | Description |
|
|
4189
|
+
|---|---:|---|---|
|
|
4190
|
+
| `backgroundColor` | no | [AvatarImageBackground](./definitions.md#avatarimagebackground) | |
|
|
4191
|
+
| `color` | no | [ActionCardIconColor](./definitions.md#actioncardiconcolor) | |
|
|
4192
|
+
| `type` | yes | string | |
|
|
4193
|
+
|
|
4194
|
+
No additional properties.
|
|
4195
|
+
|
|
4124
4196
|
## StepperStep
|
|
4125
4197
|
|
|
4126
4198
|
### Fields
|