@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.
@@ -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 exclusive to the Rippling brand. 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.
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 as a child. helperMessage can be a plain string or an object { message, status } where status "ERROR" shows the message as an error.
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: children (if any) are rendered as the checkbox label and take precedence over the `label` prop; `label` remains the string fallback. Use this for labels containing inline elements, e.g. an agreement checkbox whose label embeds a Link. 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.
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.2`
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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rippling/pebble-sdui-web",
3
- "version": "0.18.2",
3
+ "version": "0.18.4",
4
4
  "description": "Type-safe TypeScript web SDK for authoring json-render specs",
5
5
  "repository": {
6
6
  "type": "git",