@momentum-design/components 0.82.3 → 0.83.1

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.
@@ -4,203 +4,509 @@
4
4
  "modules": [
5
5
  {
6
6
  "kind": "javascript-module",
7
- "path": "components/animation/animation.component.js",
7
+ "path": "components/alertchip/alertchip.component.js",
8
8
  "declarations": [
9
9
  {
10
10
  "kind": "class",
11
- "description": "The `mdc-animation` component is a wrapper around the Lottie animation library.\nIt fetches the animation data dynamically based on the provided name and renders it.\nThis is a display only component that does not have any interactive functionality.\nFrom accessibility perspective, (by default) it is a decorative image component.",
12
- "name": "Animation",
11
+ "description": "mdc-alertchip component is an interactive chip that consumers can use to represent an alert.\n\n- It supports a leading icon along with label.\n- It supports 5 variants of alerts - neutral, warning, error, success, and informational\n\nThis component is built by extending Buttonsimple.",
12
+ "name": "AlertChip",
13
+ "cssProperties": [
14
+ {
15
+ "description": "The color of the label text",
16
+ "name": "--mdc-chip-color"
17
+ },
18
+ {
19
+ "description": "The color of the icon",
20
+ "name": "--mdc-chip-icon-color"
21
+ },
22
+ {
23
+ "description": "The border color of the alertchip",
24
+ "name": "--mdc-chip-border-color"
25
+ },
26
+ {
27
+ "description": "The background color of the alertchip",
28
+ "name": "--mdc-chip-background-color"
29
+ }
30
+ ],
13
31
  "members": [
14
32
  {
15
33
  "kind": "field",
16
- "name": "name",
34
+ "name": "variant",
17
35
  "type": {
18
- "text": "AnimationNames | undefined"
36
+ "text": "VariantType"
19
37
  },
20
- "description": "Name of the animation (= filename)",
21
- "attribute": "name",
22
- "reflects": true
38
+ "description": "The variant of the alertchip. It supports 5 variants\n- neutral\n- warning\n- error\n- success\n- informational",
39
+ "default": "neutral",
40
+ "attribute": "variant"
23
41
  },
24
42
  {
25
43
  "kind": "field",
26
- "name": "loop",
44
+ "name": "label",
27
45
  "type": {
28
- "text": "LoopType | undefined"
46
+ "text": "string"
29
47
  },
30
- "description": "How many times to loop the animation\n- \"true\" - infinite\n- \"false\" - no loop\n- number - number of times to loop",
31
- "attribute": "loop",
32
- "reflects": true
48
+ "default": "''",
49
+ "description": "The visible label text of the alertchip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
50
+ "attribute": "label"
33
51
  },
34
52
  {
35
53
  "kind": "field",
36
- "name": "autoplay",
54
+ "name": "autofocus",
55
+ "type": {
56
+ "text": "boolean"
57
+ },
58
+ "default": "false",
59
+ "description": "This property indicates whether the element should receive focus automatically when it is rendered.",
60
+ "attribute": "autofocus",
61
+ "reflects": true,
62
+ "inheritedFrom": {
63
+ "name": "AutoFocusMixin",
64
+ "module": "utils/mixins/AutoFocusMixin.js"
65
+ }
66
+ },
67
+ {
68
+ "kind": "field",
69
+ "name": "tabIndex",
70
+ "type": {
71
+ "text": "number"
72
+ },
73
+ "default": "0",
74
+ "description": "This property specifies the tab order of the element.",
75
+ "attribute": "tabIndex",
76
+ "reflects": true,
77
+ "inheritedFrom": {
78
+ "name": "TabIndexMixin",
79
+ "module": "utils/mixins/TabIndexMixin.js"
80
+ }
81
+ },
82
+ {
83
+ "kind": "field",
84
+ "name": "disabled",
37
85
  "type": {
38
86
  "text": "boolean | undefined"
39
87
  },
40
- "description": "Weather start the animation automatically",
41
- "attribute": "autoplay",
42
- "reflects": true
88
+ "description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
89
+ "default": "undefined",
90
+ "attribute": "disabled",
91
+ "reflects": true,
92
+ "inheritedFrom": {
93
+ "name": "DisabledMixin",
94
+ "module": "utils/mixins/DisabledMixin.js"
95
+ }
43
96
  },
44
97
  {
45
98
  "kind": "field",
46
- "name": "ariaLabel",
99
+ "name": "active",
47
100
  "type": {
48
- "text": "string | null"
101
+ "text": "boolean | undefined"
49
102
  },
50
- "default": "null",
51
- "description": "Aria-label attribute to be set for accessibility",
52
- "attribute": "aria-label"
103
+ "description": "The button's active state indicates whether it is currently toggled on (active) or off (inactive).\nWhen the active state is true, the button is considered to be in an active state, meaning it is toggled on.\nConversely, when the active state is false, the button is in an inactive state, indicating it is toggled off.\n\nThis attribute is used to set the provided `ariaStateKey` to true or false.",
104
+ "default": "undefined",
105
+ "attribute": "active",
106
+ "reflects": true,
107
+ "inheritedFrom": {
108
+ "name": "Buttonsimple",
109
+ "module": "components/buttonsimple/buttonsimple.component.js"
110
+ }
53
111
  },
54
112
  {
55
113
  "kind": "field",
56
- "name": "ariaLabelledBy",
114
+ "name": "softDisabled",
57
115
  "type": {
58
- "text": "string | null"
116
+ "text": "boolean | undefined"
59
117
  },
60
- "default": "null",
61
- "description": "Aria-labelledby attribute to be set for accessibility",
62
- "attribute": "aria-labelledby"
118
+ "description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
119
+ "default": "undefined",
120
+ "attribute": "soft-disabled",
121
+ "reflects": true,
122
+ "inheritedFrom": {
123
+ "name": "Buttonsimple",
124
+ "module": "components/buttonsimple/buttonsimple.component.js"
125
+ }
63
126
  },
64
127
  {
65
128
  "kind": "field",
66
- "name": "lottieInstance",
129
+ "name": "size",
67
130
  "type": {
68
- "text": "AnimationItem | undefined"
131
+ "text": "ButtonSize"
69
132
  },
70
- "privacy": "private",
71
- "description": "Lottie animation instance"
133
+ "description": "Simplebutton size is a super set of all the sizes supported by children components.",
134
+ "default": "32",
135
+ "attribute": "size",
136
+ "reflects": true,
137
+ "inheritedFrom": {
138
+ "name": "Buttonsimple",
139
+ "module": "components/buttonsimple/buttonsimple.component.js"
140
+ }
72
141
  },
73
142
  {
74
143
  "kind": "field",
75
- "name": "containerRef",
144
+ "name": "role",
145
+ "description": "This property defines the ARIA role for the element. By default, it is set to 'button'.\nConsumers should override this role when:\n- The element is being used in a context where a different role is more appropriate.\n- Custom behaviors are implemented that require a specific ARIA role for accessibility purposes.",
146
+ "default": "button",
147
+ "attribute": "role",
148
+ "reflects": true,
149
+ "inheritedFrom": {
150
+ "name": "Buttonsimple",
151
+ "module": "components/buttonsimple/buttonsimple.component.js"
152
+ }
153
+ },
154
+ {
155
+ "kind": "field",
156
+ "name": "ariaStateKey",
76
157
  "type": {
77
- "text": "Ref<HTMLDivElement>"
158
+ "text": "string | undefined"
78
159
  },
79
- "privacy": "private",
80
- "description": "Container for the animation"
160
+ "description": "This property defines the ARIA state key, which will be toggled when the\nButton is set to `active`.\nThe default value is 'aria-pressed', which is commonly used for toggle buttons.\n\nConsumers can override this property to use a different ARIA state key if needed.\nIn case multiple aria attributes should be toggled, they can be passed in as\na comma separated string.\nFor example: `aria-pressed,aria-expanded`",
161
+ "default": "'aria-pressed' (when)",
162
+ "attribute": "ariaStateKey",
163
+ "reflects": true,
164
+ "inheritedFrom": {
165
+ "name": "Buttonsimple",
166
+ "module": "components/buttonsimple/buttonsimple.component.js"
167
+ }
81
168
  },
82
169
  {
83
170
  "kind": "field",
84
- "name": "animation",
85
- "description": "Exposed API of the animation library (lottie)",
86
- "readonly": true
171
+ "name": "type",
172
+ "type": {
173
+ "text": "ButtonType"
174
+ },
175
+ "description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
176
+ "default": "button",
177
+ "attribute": "type",
178
+ "reflects": true,
179
+ "inheritedFrom": {
180
+ "name": "Buttonsimple",
181
+ "module": "components/buttonsimple/buttonsimple.component.js"
182
+ }
87
183
  },
88
184
  {
89
185
  "kind": "method",
90
- "name": "getLoopValue",
91
- "privacy": "private"
186
+ "name": "executeAction",
187
+ "privacy": "protected",
188
+ "inheritedFrom": {
189
+ "name": "Buttonsimple",
190
+ "module": "components/buttonsimple/buttonsimple.component.js"
191
+ }
92
192
  },
93
193
  {
94
194
  "kind": "method",
95
- "name": "onLoadSuccessHandler",
96
- "privacy": "private",
195
+ "name": "setActive",
196
+ "privacy": "protected",
97
197
  "parameters": [
98
198
  {
99
- "name": "animationData",
199
+ "name": "element",
100
200
  "type": {
101
- "text": "any"
102
- }
201
+ "text": "HTMLElement"
202
+ },
203
+ "description": "The button element"
204
+ },
205
+ {
206
+ "name": "active",
207
+ "optional": true,
208
+ "type": {
209
+ "text": "boolean"
210
+ },
211
+ "description": "The active state of the element"
103
212
  }
104
213
  ],
105
- "description": "Create new lotty instance for the loaded data"
214
+ "description": "Sets the ariaStateKey attributes based on the active state of the button.",
215
+ "inheritedFrom": {
216
+ "name": "Buttonsimple",
217
+ "module": "components/buttonsimple/buttonsimple.component.js"
218
+ }
106
219
  },
107
220
  {
108
221
  "kind": "method",
109
- "name": "onLoadFailHandler",
222
+ "name": "setSoftDisabled",
110
223
  "privacy": "private",
111
224
  "parameters": [
112
225
  {
113
- "name": "error",
226
+ "name": "element",
114
227
  "type": {
115
- "text": "Error"
116
- }
228
+ "text": "HTMLElement"
229
+ },
230
+ "description": "The button element."
231
+ },
232
+ {
233
+ "name": "softDisabled",
234
+ "optional": true,
235
+ "type": {
236
+ "text": "boolean"
237
+ },
238
+ "description": "The soft-disabled state."
117
239
  }
118
240
  ],
119
- "description": "Error handler for animation loading"
241
+ "description": "Sets the soft-disabled attribute for the button.\nWhen soft-disabled, the button looks to be disabled but remains focusable and clickable.\nAlso sets/removes aria-disabled attribute.",
242
+ "inheritedFrom": {
243
+ "name": "Buttonsimple",
244
+ "module": "components/buttonsimple/buttonsimple.component.js"
245
+ }
120
246
  },
121
247
  {
122
248
  "kind": "method",
123
- "name": "getAnimationData",
249
+ "name": "setDisabled",
124
250
  "privacy": "private",
125
- "description": "Import animation data dynamically"
251
+ "parameters": [
252
+ {
253
+ "name": "element",
254
+ "type": {
255
+ "text": "HTMLElement"
256
+ },
257
+ "description": "The button element."
258
+ },
259
+ {
260
+ "name": "disabled",
261
+ "type": {
262
+ "text": "boolean"
263
+ },
264
+ "description": "The disabled state."
265
+ }
266
+ ],
267
+ "description": "Sets the disabled attribute for the button.\nWhen disabled, the button is not focusable or clickable, and tabindex is set to -1.\nThe previous tabindex is stored and restored when enabled.\nAlso sets/removes aria-disabled attribute.",
268
+ "inheritedFrom": {
269
+ "name": "Buttonsimple",
270
+ "module": "components/buttonsimple/buttonsimple.component.js"
271
+ }
126
272
  },
127
273
  {
128
- "kind": "field",
129
- "name": "onCompleteHandler",
130
- "description": "Re-dispatch the complete event from the animation library\n\nThis handler called with the animation instance instead of the component instance\nso we need to bind it to the component instance. The arrow function just does that."
131
- }
132
- ],
133
- "events": [
274
+ "kind": "method",
275
+ "name": "triggerClickEvent",
276
+ "privacy": "private",
277
+ "inheritedFrom": {
278
+ "name": "Buttonsimple",
279
+ "module": "components/buttonsimple/buttonsimple.component.js"
280
+ }
281
+ },
134
282
  {
135
- "name": "load",
136
- "type": {
137
- "text": "CustomEvent"
138
- },
139
- "description": "(React: onLoad) This event is dispatched when the animation is loaded",
140
- "reactName": "onLoad"
283
+ "kind": "method",
284
+ "name": "handleBlur",
285
+ "privacy": "private",
286
+ "description": "In case the button is pressed and the focus is lost while pressing,\nthe pressed class is removed.",
287
+ "inheritedFrom": {
288
+ "name": "Buttonsimple",
289
+ "module": "components/buttonsimple/buttonsimple.component.js"
290
+ }
141
291
  },
142
292
  {
143
- "description": "(React: onComplete) This event is dispatched when all animation loops completed",
144
- "name": "complete",
145
- "reactName": "onComplete"
293
+ "kind": "method",
294
+ "name": "handleKeyDown",
295
+ "privacy": "private",
296
+ "parameters": [
297
+ {
298
+ "name": "event",
299
+ "type": {
300
+ "text": "KeyboardEvent"
301
+ },
302
+ "description": "The keyboard event."
303
+ }
304
+ ],
305
+ "description": "Handles the keydown event on the button.\nIf the key is 'Enter' or 'Space', the button is pressed.\nIf the key is 'Enter', the button is pressed. The native HTML button works in the same way.\nIf the key is 'Space', the button's default is prevent to avoid scrolling etc in the host application.",
306
+ "inheritedFrom": {
307
+ "name": "Buttonsimple",
308
+ "module": "components/buttonsimple/buttonsimple.component.js"
309
+ }
146
310
  },
147
311
  {
148
- "description": "(React: onError) This event is dispatched when animation loading failed",
149
- "name": "error",
150
- "reactName": "onError"
312
+ "kind": "method",
313
+ "name": "handleKeyUp",
314
+ "privacy": "private",
315
+ "parameters": [
316
+ {
317
+ "name": "event",
318
+ "type": {
319
+ "text": "KeyboardEvent"
320
+ },
321
+ "description": "The keyboard event."
322
+ }
323
+ ],
324
+ "description": "Handles the keyup event on the button.\nIf the key is 'Enter' or 'Space', the button is clicked.\nIf the key is 'Space', the button is pressed. The native HTML button works in the same way.",
325
+ "inheritedFrom": {
326
+ "name": "Buttonsimple",
327
+ "module": "components/buttonsimple/buttonsimple.component.js"
328
+ }
151
329
  }
152
330
  ],
153
331
  "attributes": [
154
332
  {
155
- "name": "name",
333
+ "name": "variant",
156
334
  "type": {
157
- "text": "AnimationNames | undefined"
335
+ "text": "VariantType"
158
336
  },
159
- "description": "Name of the animation (= filename)",
160
- "fieldName": "name"
337
+ "description": "The variant of the alertchip. It supports 5 variants\n- neutral\n- warning\n- error\n- success\n- informational",
338
+ "default": "neutral",
339
+ "fieldName": "variant"
161
340
  },
162
341
  {
163
- "name": "loop",
342
+ "name": "label",
164
343
  "type": {
165
- "text": "LoopType | undefined"
344
+ "text": "string"
166
345
  },
167
- "description": "How many times to loop the animation\n- \"true\" - infinite\n- \"false\" - no loop\n- number - number of times to loop",
168
- "fieldName": "loop"
346
+ "default": "''",
347
+ "description": "The visible label text of the alertchip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
348
+ "fieldName": "label"
169
349
  },
170
350
  {
171
- "name": "autoplay",
351
+ "name": "autofocus",
352
+ "type": {
353
+ "text": "boolean"
354
+ },
355
+ "default": "false",
356
+ "description": "This property indicates whether the element should receive focus automatically when it is rendered.",
357
+ "fieldName": "autofocus",
358
+ "inheritedFrom": {
359
+ "name": "AutoFocusMixin",
360
+ "module": "src/utils/mixins/AutoFocusMixin.ts"
361
+ }
362
+ },
363
+ {
364
+ "name": "tabIndex",
365
+ "type": {
366
+ "text": "number"
367
+ },
368
+ "default": "0",
369
+ "description": "This property specifies the tab order of the element.",
370
+ "fieldName": "tabIndex",
371
+ "inheritedFrom": {
372
+ "name": "TabIndexMixin",
373
+ "module": "src/utils/mixins/TabIndexMixin.ts"
374
+ }
375
+ },
376
+ {
377
+ "name": "disabled",
172
378
  "type": {
173
379
  "text": "boolean | undefined"
174
380
  },
175
- "description": "Weather start the animation automatically",
176
- "fieldName": "autoplay"
381
+ "description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
382
+ "default": "undefined",
383
+ "fieldName": "disabled",
384
+ "inheritedFrom": {
385
+ "name": "DisabledMixin",
386
+ "module": "src/utils/mixins/DisabledMixin.ts"
387
+ }
177
388
  },
178
389
  {
179
- "name": "aria-label",
390
+ "name": "active",
180
391
  "type": {
181
- "text": "string | null"
392
+ "text": "boolean | undefined"
182
393
  },
183
- "default": "null",
184
- "description": "Aria-label attribute to be set for accessibility",
185
- "fieldName": "ariaLabel"
394
+ "description": "The button's active state indicates whether it is currently toggled on (active) or off (inactive).\nWhen the active state is true, the button is considered to be in an active state, meaning it is toggled on.\nConversely, when the active state is false, the button is in an inactive state, indicating it is toggled off.\n\nThis attribute is used to set the provided `ariaStateKey` to true or false.",
395
+ "default": "undefined",
396
+ "fieldName": "active",
397
+ "inheritedFrom": {
398
+ "name": "Buttonsimple",
399
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
400
+ }
186
401
  },
187
402
  {
188
- "name": "aria-labelledby",
403
+ "name": "soft-disabled",
189
404
  "type": {
190
- "text": "string | null"
405
+ "text": "boolean | undefined"
191
406
  },
192
- "default": "null",
193
- "description": "Aria-labelledby attribute to be set for accessibility",
194
- "fieldName": "ariaLabelledBy"
407
+ "description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
408
+ "default": "undefined",
409
+ "fieldName": "softDisabled",
410
+ "inheritedFrom": {
411
+ "name": "Buttonsimple",
412
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
413
+ }
414
+ },
415
+ {
416
+ "name": "size",
417
+ "type": {
418
+ "text": "ButtonSize"
419
+ },
420
+ "description": "Simplebutton size is a super set of all the sizes supported by children components.",
421
+ "default": "32",
422
+ "fieldName": "size",
423
+ "inheritedFrom": {
424
+ "name": "Buttonsimple",
425
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
426
+ }
427
+ },
428
+ {
429
+ "name": "role",
430
+ "description": "This property defines the ARIA role for the element. By default, it is set to 'button'.\nConsumers should override this role when:\n- The element is being used in a context where a different role is more appropriate.\n- Custom behaviors are implemented that require a specific ARIA role for accessibility purposes.",
431
+ "default": "button",
432
+ "fieldName": "role",
433
+ "inheritedFrom": {
434
+ "name": "Buttonsimple",
435
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
436
+ }
437
+ },
438
+ {
439
+ "name": "ariaStateKey",
440
+ "type": {
441
+ "text": "string | undefined"
442
+ },
443
+ "description": "This property defines the ARIA state key, which will be toggled when the\nButton is set to `active`.\nThe default value is 'aria-pressed', which is commonly used for toggle buttons.\n\nConsumers can override this property to use a different ARIA state key if needed.\nIn case multiple aria attributes should be toggled, they can be passed in as\na comma separated string.\nFor example: `aria-pressed,aria-expanded`",
444
+ "default": "'aria-pressed' (when)",
445
+ "fieldName": "ariaStateKey",
446
+ "inheritedFrom": {
447
+ "name": "Buttonsimple",
448
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
449
+ }
450
+ },
451
+ {
452
+ "name": "type",
453
+ "type": {
454
+ "text": "ButtonType"
455
+ },
456
+ "description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
457
+ "default": "button",
458
+ "fieldName": "type",
459
+ "inheritedFrom": {
460
+ "name": "Buttonsimple",
461
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
462
+ }
195
463
  }
196
464
  ],
197
465
  "superclass": {
198
- "name": "Component",
199
- "module": "/src/models"
466
+ "name": "Buttonsimple",
467
+ "module": "/src/components/buttonsimple/buttonsimple.component"
200
468
  },
201
- "tagName": "mdc-animation",
202
- "jsDoc": "/**\n * The `mdc-animation` component is a wrapper around the Lottie animation library.\n * It fetches the animation data dynamically based on the provided name and renders it.\n * This is a display only component that does not have any interactive functionality.\n * From accessibility perspective, (by default) it is a decorative image component.\n *\n * @tagname mdc-animation\n *\n * @event load - (React: onLoad) This event is dispatched when the animation is loaded\n * @event complete - (React: onComplete) This event is dispatched when all animation loops completed\n * @event error - (React: onError) This event is dispatched when animation loading failed\n */",
203
- "customElement": true
469
+ "tagName": "mdc-alertchip",
470
+ "jsDoc": "/**\n * mdc-alertchip component is an interactive chip that consumers can use to represent an alert.\n *\n * - It supports a leading icon along with label.\n * - It supports 5 variants of alerts - neutral, warning, error, success, and informational\n *\n * This component is built by extending Buttonsimple.\n *\n * @tagname mdc-alertchip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the label text\n * @cssproperty --mdc-chip-icon-color - The color of the icon\n * @cssproperty --mdc-chip-border-color - The border color of the alertchip\n * @cssproperty --mdc-chip-background-color - The background color of the alertchip\n *\n */",
471
+ "customElement": true,
472
+ "events": [
473
+ {
474
+ "description": "(React: onClick) This event is dispatched when the button is clicked.",
475
+ "name": "click",
476
+ "reactName": "onClick",
477
+ "inheritedFrom": {
478
+ "name": "Buttonsimple",
479
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
480
+ }
481
+ },
482
+ {
483
+ "description": "(React: onKeyDown) This event is dispatched when a key is pressed down on the button.",
484
+ "name": "keydown",
485
+ "reactName": "onKeyDown",
486
+ "inheritedFrom": {
487
+ "name": "Buttonsimple",
488
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
489
+ }
490
+ },
491
+ {
492
+ "description": "(React: onKeyUp) This event is dispatched when a key is released on the button.",
493
+ "name": "keyup",
494
+ "reactName": "onKeyUp",
495
+ "inheritedFrom": {
496
+ "name": "Buttonsimple",
497
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
498
+ }
499
+ },
500
+ {
501
+ "description": "(React: onFocus) This event is dispatched when the button receives focus.",
502
+ "name": "focus",
503
+ "reactName": "onFocus",
504
+ "inheritedFrom": {
505
+ "name": "Buttonsimple",
506
+ "module": "src/components/buttonsimple/buttonsimple.component.ts"
507
+ }
508
+ }
509
+ ]
204
510
  }
205
511
  ],
206
512
  "exports": [
@@ -208,21 +514,233 @@
208
514
  "kind": "js",
209
515
  "name": "default",
210
516
  "declaration": {
211
- "name": "Animation",
212
- "module": "components/animation/animation.component.js"
517
+ "name": "AlertChip",
518
+ "module": "components/alertchip/alertchip.component.js"
213
519
  }
214
520
  }
215
521
  ]
216
522
  },
217
523
  {
218
524
  "kind": "javascript-module",
219
- "path": "components/appheader/appheader.component.js",
525
+ "path": "components/animation/animation.component.js",
220
526
  "declarations": [
221
527
  {
222
528
  "kind": "class",
223
- "description": "The `mdc-appheader` component provides a structured and accessible app header layout.\nIt consists of three primary sections: leading, center, and trailing.\n\n- The **leading section** typically holds a **brand logo**, **brand name** or **menu icon**.\n- The **center section** can contain a **search bar**, **icons** or action controls.\n- The **trailing section** generally includes a **profile avatar**, **additional icons** or **action controls**.",
224
- "name": "Appheader",
225
- "cssParts": [
529
+ "description": "The `mdc-animation` component is a wrapper around the Lottie animation library.\nIt fetches the animation data dynamically based on the provided name and renders it.\nThis is a display only component that does not have any interactive functionality.\nFrom accessibility perspective, (by default) it is a decorative image component.",
530
+ "name": "Animation",
531
+ "members": [
532
+ {
533
+ "kind": "field",
534
+ "name": "name",
535
+ "type": {
536
+ "text": "AnimationNames | undefined"
537
+ },
538
+ "description": "Name of the animation (= filename)",
539
+ "attribute": "name",
540
+ "reflects": true
541
+ },
542
+ {
543
+ "kind": "field",
544
+ "name": "loop",
545
+ "type": {
546
+ "text": "LoopType | undefined"
547
+ },
548
+ "description": "How many times to loop the animation\n- \"true\" - infinite\n- \"false\" - no loop\n- number - number of times to loop",
549
+ "attribute": "loop",
550
+ "reflects": true
551
+ },
552
+ {
553
+ "kind": "field",
554
+ "name": "autoplay",
555
+ "type": {
556
+ "text": "boolean | undefined"
557
+ },
558
+ "description": "Weather start the animation automatically",
559
+ "attribute": "autoplay",
560
+ "reflects": true
561
+ },
562
+ {
563
+ "kind": "field",
564
+ "name": "ariaLabel",
565
+ "type": {
566
+ "text": "string | null"
567
+ },
568
+ "default": "null",
569
+ "description": "Aria-label attribute to be set for accessibility",
570
+ "attribute": "aria-label"
571
+ },
572
+ {
573
+ "kind": "field",
574
+ "name": "ariaLabelledBy",
575
+ "type": {
576
+ "text": "string | null"
577
+ },
578
+ "default": "null",
579
+ "description": "Aria-labelledby attribute to be set for accessibility",
580
+ "attribute": "aria-labelledby"
581
+ },
582
+ {
583
+ "kind": "field",
584
+ "name": "lottieInstance",
585
+ "type": {
586
+ "text": "AnimationItem | undefined"
587
+ },
588
+ "privacy": "private",
589
+ "description": "Lottie animation instance"
590
+ },
591
+ {
592
+ "kind": "field",
593
+ "name": "containerRef",
594
+ "type": {
595
+ "text": "Ref<HTMLDivElement>"
596
+ },
597
+ "privacy": "private",
598
+ "description": "Container for the animation"
599
+ },
600
+ {
601
+ "kind": "field",
602
+ "name": "animation",
603
+ "description": "Exposed API of the animation library (lottie)",
604
+ "readonly": true
605
+ },
606
+ {
607
+ "kind": "method",
608
+ "name": "getLoopValue",
609
+ "privacy": "private"
610
+ },
611
+ {
612
+ "kind": "method",
613
+ "name": "onLoadSuccessHandler",
614
+ "privacy": "private",
615
+ "parameters": [
616
+ {
617
+ "name": "animationData",
618
+ "type": {
619
+ "text": "any"
620
+ }
621
+ }
622
+ ],
623
+ "description": "Create new lotty instance for the loaded data"
624
+ },
625
+ {
626
+ "kind": "method",
627
+ "name": "onLoadFailHandler",
628
+ "privacy": "private",
629
+ "parameters": [
630
+ {
631
+ "name": "error",
632
+ "type": {
633
+ "text": "Error"
634
+ }
635
+ }
636
+ ],
637
+ "description": "Error handler for animation loading"
638
+ },
639
+ {
640
+ "kind": "method",
641
+ "name": "getAnimationData",
642
+ "privacy": "private",
643
+ "description": "Import animation data dynamically"
644
+ },
645
+ {
646
+ "kind": "field",
647
+ "name": "onCompleteHandler",
648
+ "description": "Re-dispatch the complete event from the animation library\n\nThis handler called with the animation instance instead of the component instance\nso we need to bind it to the component instance. The arrow function just does that."
649
+ }
650
+ ],
651
+ "events": [
652
+ {
653
+ "name": "load",
654
+ "type": {
655
+ "text": "CustomEvent"
656
+ },
657
+ "description": "(React: onLoad) This event is dispatched when the animation is loaded",
658
+ "reactName": "onLoad"
659
+ },
660
+ {
661
+ "description": "(React: onComplete) This event is dispatched when all animation loops completed",
662
+ "name": "complete",
663
+ "reactName": "onComplete"
664
+ },
665
+ {
666
+ "description": "(React: onError) This event is dispatched when animation loading failed",
667
+ "name": "error",
668
+ "reactName": "onError"
669
+ }
670
+ ],
671
+ "attributes": [
672
+ {
673
+ "name": "name",
674
+ "type": {
675
+ "text": "AnimationNames | undefined"
676
+ },
677
+ "description": "Name of the animation (= filename)",
678
+ "fieldName": "name"
679
+ },
680
+ {
681
+ "name": "loop",
682
+ "type": {
683
+ "text": "LoopType | undefined"
684
+ },
685
+ "description": "How many times to loop the animation\n- \"true\" - infinite\n- \"false\" - no loop\n- number - number of times to loop",
686
+ "fieldName": "loop"
687
+ },
688
+ {
689
+ "name": "autoplay",
690
+ "type": {
691
+ "text": "boolean | undefined"
692
+ },
693
+ "description": "Weather start the animation automatically",
694
+ "fieldName": "autoplay"
695
+ },
696
+ {
697
+ "name": "aria-label",
698
+ "type": {
699
+ "text": "string | null"
700
+ },
701
+ "default": "null",
702
+ "description": "Aria-label attribute to be set for accessibility",
703
+ "fieldName": "ariaLabel"
704
+ },
705
+ {
706
+ "name": "aria-labelledby",
707
+ "type": {
708
+ "text": "string | null"
709
+ },
710
+ "default": "null",
711
+ "description": "Aria-labelledby attribute to be set for accessibility",
712
+ "fieldName": "ariaLabelledBy"
713
+ }
714
+ ],
715
+ "superclass": {
716
+ "name": "Component",
717
+ "module": "/src/models"
718
+ },
719
+ "tagName": "mdc-animation",
720
+ "jsDoc": "/**\n * The `mdc-animation` component is a wrapper around the Lottie animation library.\n * It fetches the animation data dynamically based on the provided name and renders it.\n * This is a display only component that does not have any interactive functionality.\n * From accessibility perspective, (by default) it is a decorative image component.\n *\n * @tagname mdc-animation\n *\n * @event load - (React: onLoad) This event is dispatched when the animation is loaded\n * @event complete - (React: onComplete) This event is dispatched when all animation loops completed\n * @event error - (React: onError) This event is dispatched when animation loading failed\n */",
721
+ "customElement": true
722
+ }
723
+ ],
724
+ "exports": [
725
+ {
726
+ "kind": "js",
727
+ "name": "default",
728
+ "declaration": {
729
+ "name": "Animation",
730
+ "module": "components/animation/animation.component.js"
731
+ }
732
+ }
733
+ ]
734
+ },
735
+ {
736
+ "kind": "javascript-module",
737
+ "path": "components/appheader/appheader.component.js",
738
+ "declarations": [
739
+ {
740
+ "kind": "class",
741
+ "description": "The `mdc-appheader` component provides a structured and accessible app header layout.\nIt consists of three primary sections: leading, center, and trailing.\n\n- The **leading section** typically holds a **brand logo**, **brand name** or **menu icon**.\n- The **center section** can contain a **search bar**, **icons** or action controls.\n- The **trailing section** generally includes a **profile avatar**, **additional icons** or **action controls**.",
742
+ "name": "Appheader",
743
+ "cssParts": [
226
744
  {
227
745
  "description": "The main container for styling the header.",
228
746
  "name": "container"
@@ -282,745 +800,227 @@
282
800
  {
283
801
  "kind": "class",
284
802
  "description": "The `mdc-avatar` component is used to represent a person or a space.\nAn avatar can be an icon, initials, counter and photo.\n\nTo set the photo of an avatar,\nyou need to set \"src\" attribute.\n\nWhile the avatar image is loading, as a placeholder,\nwe will show the initials text.\nIf the initials are not specified then,\nwe will show `user-regular` icon as a placeholder.\n\nBy default, if there are no attributes specified,\nthen the default avatar will be an icon with `user-regular` name.\n\nThe avatar component is non clickable and non interactive/focusable component.\nIf the avatar is typing, then the loading indicator will be displayed.\nIf the counter type avatar is set to a negative number, then we will display 0.\nThe presence indicator will be hidden when the counter property is set.",
285
- "name": "Avatar",
286
- "cssProperties": [
287
- {
288
- "description": "Allows customization of the default background color.",
289
- "name": "--mdc-avatar-default-background-color"
290
- },
291
- {
292
- "description": "Allows customization of the default foreground color.",
293
- "name": "--mdc-avatar-default-foreground-color"
294
- },
295
- {
296
- "description": "Allows customization of the loading indicator background color.",
297
- "name": "--mdc-avatar-loading-indicator-background-color"
298
- },
299
- {
300
- "description": "Allows customization of the loading indicator foreground color.",
301
- "name": "--mdc-avatar-loading-indicator-foreground-color"
302
- },
303
- {
304
- "description": "Allows customization of the loading overlay background color.",
305
- "name": "--mdc-avatar-loading-overlay-background-color"
306
- }
307
- ],
308
- "members": [
309
- {
310
- "kind": "field",
311
- "name": "src",
312
- "type": {
313
- "text": "string | undefined"
314
- },
315
- "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
316
- "attribute": "src",
317
- "inheritedFrom": {
318
- "name": "AvatarComponentMixin",
319
- "module": "utils/mixins/AvatarComponentMixin.js"
320
- }
321
- },
322
- {
323
- "kind": "field",
324
- "name": "initials",
325
- "type": {
326
- "text": "string | undefined"
327
- },
328
- "description": "The initials to be displayed for the avatar.",
329
- "attribute": "initials",
330
- "inheritedFrom": {
331
- "name": "AvatarComponentMixin",
332
- "module": "utils/mixins/AvatarComponentMixin.js"
333
- }
334
- },
335
- {
336
- "kind": "field",
337
- "name": "presence",
338
- "type": {
339
- "text": "PresenceType | undefined"
340
- },
341
- "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
342
- "attribute": "presence",
343
- "inheritedFrom": {
344
- "name": "AvatarComponentMixin",
345
- "module": "utils/mixins/AvatarComponentMixin.js"
346
- }
347
- },
348
- {
349
- "kind": "field",
350
- "name": "size",
351
- "type": {
352
- "text": "AvatarSize"
353
- },
354
- "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
355
- "default": "32",
356
- "attribute": "size",
357
- "reflects": true,
358
- "inheritedFrom": {
359
- "name": "AvatarComponentMixin",
360
- "module": "utils/mixins/AvatarComponentMixin.js"
361
- }
362
- },
363
- {
364
- "kind": "field",
365
- "name": "counter",
366
- "type": {
367
- "text": "number | undefined"
368
- },
369
- "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
370
- "attribute": "counter",
371
- "inheritedFrom": {
372
- "name": "AvatarComponentMixin",
373
- "module": "utils/mixins/AvatarComponentMixin.js"
374
- }
375
- },
376
- {
377
- "kind": "field",
378
- "name": "isTyping",
379
- "type": {
380
- "text": "boolean"
381
- },
382
- "default": "false",
383
- "description": "Represents the typing indicator when the user is typing.",
384
- "attribute": "is-typing",
385
- "inheritedFrom": {
386
- "name": "AvatarComponentMixin",
387
- "module": "utils/mixins/AvatarComponentMixin.js"
388
- }
389
- },
390
- {
391
- "kind": "field",
392
- "name": "iconName",
393
- "type": {
394
- "text": "IconNames | undefined"
395
- },
396
- "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
397
- "attribute": "icon-name",
398
- "inheritedFrom": {
399
- "name": "IconNameMixin",
400
- "module": "utils/mixins/IconNameMixin.js"
401
- }
402
- }
403
- ],
404
- "mixins": [
405
- {
406
- "name": "AvatarComponentMixin",
407
- "module": "/src/utils/mixins/AvatarComponentMixin"
408
- },
409
- {
410
- "name": "IconNameMixin",
411
- "module": "/src/utils/mixins/IconNameMixin"
412
- }
413
- ],
414
- "superclass": {
415
- "name": "Component",
416
- "module": "/src/models"
417
- },
418
- "tagName": "mdc-avatar",
419
- "jsDoc": "/**\n * The `mdc-avatar` component is used to represent a person or a space.\n * An avatar can be an icon, initials, counter and photo.\n *\n * To set the photo of an avatar,\n * you need to set \"src\" attribute.\n *\n * While the avatar image is loading, as a placeholder,\n * we will show the initials text.\n * If the initials are not specified then,\n * we will show `user-regular` icon as a placeholder.\n *\n * By default, if there are no attributes specified,\n * then the default avatar will be an icon with `user-regular` name.\n *\n * The avatar component is non clickable and non interactive/focusable component.\n * If the avatar is typing, then the loading indicator will be displayed.\n * If the counter type avatar is set to a negative number, then we will display 0.\n * The presence indicator will be hidden when the counter property is set.\n *\n * @dependency mdc-icon\n * @dependency mdc-presence\n * @dependency mdc-text\n *\n * @tagname mdc-avatar\n *\n * @cssproperty --mdc-avatar-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-avatar-default-foreground-color - Allows customization of the default foreground color.\n * @cssproperty --mdc-avatar-loading-indicator-background-color -\n * Allows customization of the loading indicator background color.\n * @cssproperty --mdc-avatar-loading-indicator-foreground-color -\n * Allows customization of the loading indicator foreground color.\n * @cssproperty --mdc-avatar-loading-overlay-background-color -\n * Allows customization of the loading overlay background color.\n */",
420
- "customElement": true,
421
- "attributes": [
422
- {
423
- "name": "src",
424
- "type": {
425
- "text": "string | undefined"
426
- },
427
- "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
428
- "fieldName": "src",
429
- "inheritedFrom": {
430
- "name": "AvatarComponentMixin",
431
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
432
- }
433
- },
434
- {
435
- "name": "initials",
436
- "type": {
437
- "text": "string | undefined"
438
- },
439
- "description": "The initials to be displayed for the avatar.",
440
- "fieldName": "initials",
441
- "inheritedFrom": {
442
- "name": "AvatarComponentMixin",
443
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
444
- }
445
- },
446
- {
447
- "name": "presence",
448
- "type": {
449
- "text": "PresenceType | undefined"
450
- },
451
- "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
452
- "fieldName": "presence",
453
- "inheritedFrom": {
454
- "name": "AvatarComponentMixin",
455
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
456
- }
457
- },
458
- {
459
- "name": "size",
460
- "type": {
461
- "text": "AvatarSize"
462
- },
463
- "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
464
- "default": "32",
465
- "fieldName": "size",
466
- "inheritedFrom": {
467
- "name": "AvatarComponentMixin",
468
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
469
- }
470
- },
471
- {
472
- "name": "counter",
473
- "type": {
474
- "text": "number | undefined"
475
- },
476
- "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
477
- "fieldName": "counter",
478
- "inheritedFrom": {
479
- "name": "AvatarComponentMixin",
480
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
481
- }
482
- },
483
- {
484
- "name": "is-typing",
485
- "type": {
486
- "text": "boolean"
487
- },
488
- "default": "false",
489
- "description": "Represents the typing indicator when the user is typing.",
490
- "fieldName": "isTyping",
491
- "inheritedFrom": {
492
- "name": "AvatarComponentMixin",
493
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
494
- }
495
- },
496
- {
497
- "name": "icon-name",
498
- "type": {
499
- "text": "IconNames | undefined"
500
- },
501
- "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
502
- "fieldName": "iconName",
503
- "inheritedFrom": {
504
- "name": "IconNameMixin",
505
- "module": "src/utils/mixins/IconNameMixin.ts"
506
- }
507
- }
508
- ]
509
- }
510
- ],
511
- "exports": [
512
- {
513
- "kind": "js",
514
- "name": "default",
515
- "declaration": {
516
- "name": "Avatar",
517
- "module": "components/avatar/avatar.component.js"
518
- }
519
- }
520
- ]
521
- },
522
- {
523
- "kind": "javascript-module",
524
- "path": "components/alertchip/alertchip.component.js",
525
- "declarations": [
526
- {
527
- "kind": "class",
528
- "description": "mdc-alertchip component is an interactive chip that consumers can use to represent an alert.\n\n- It supports a leading icon along with label.\n- It supports 5 variants of alerts - neutral, warning, error, success, and informational\n\nThis component is built by extending Buttonsimple.",
529
- "name": "AlertChip",
530
- "cssProperties": [
531
- {
532
- "description": "The color of the label text",
533
- "name": "--mdc-chip-color"
534
- },
535
- {
536
- "description": "The color of the icon",
537
- "name": "--mdc-chip-icon-color"
538
- },
539
- {
540
- "description": "The border color of the alertchip",
541
- "name": "--mdc-chip-border-color"
542
- },
543
- {
544
- "description": "The background color of the alertchip",
545
- "name": "--mdc-chip-background-color"
546
- }
547
- ],
548
- "members": [
549
- {
550
- "kind": "field",
551
- "name": "variant",
552
- "type": {
553
- "text": "VariantType"
554
- },
555
- "description": "The variant of the alertchip. It supports 5 variants\n- neutral\n- warning\n- error\n- success\n- informational",
556
- "default": "neutral",
557
- "attribute": "variant"
558
- },
559
- {
560
- "kind": "field",
561
- "name": "label",
562
- "type": {
563
- "text": "string"
564
- },
565
- "default": "''",
566
- "description": "The visible label text of the alertchip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
567
- "attribute": "label"
568
- },
569
- {
570
- "kind": "field",
571
- "name": "autofocus",
572
- "type": {
573
- "text": "boolean"
574
- },
575
- "default": "false",
576
- "description": "This property indicates whether the element should receive focus automatically when it is rendered.",
577
- "attribute": "autofocus",
578
- "reflects": true,
579
- "inheritedFrom": {
580
- "name": "AutoFocusMixin",
581
- "module": "utils/mixins/AutoFocusMixin.js"
582
- }
583
- },
584
- {
585
- "kind": "field",
586
- "name": "tabIndex",
587
- "type": {
588
- "text": "number"
589
- },
590
- "default": "0",
591
- "description": "This property specifies the tab order of the element.",
592
- "attribute": "tabIndex",
593
- "reflects": true,
594
- "inheritedFrom": {
595
- "name": "TabIndexMixin",
596
- "module": "utils/mixins/TabIndexMixin.js"
597
- }
598
- },
599
- {
600
- "kind": "field",
601
- "name": "disabled",
602
- "type": {
603
- "text": "boolean | undefined"
604
- },
605
- "description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
606
- "default": "undefined",
607
- "attribute": "disabled",
608
- "reflects": true,
609
- "inheritedFrom": {
610
- "name": "DisabledMixin",
611
- "module": "utils/mixins/DisabledMixin.js"
612
- }
613
- },
614
- {
615
- "kind": "field",
616
- "name": "active",
617
- "type": {
618
- "text": "boolean | undefined"
619
- },
620
- "description": "The button's active state indicates whether it is currently toggled on (active) or off (inactive).\nWhen the active state is true, the button is considered to be in an active state, meaning it is toggled on.\nConversely, when the active state is false, the button is in an inactive state, indicating it is toggled off.\n\nThis attribute is used to set the provided `ariaStateKey` to true or false.",
621
- "default": "undefined",
622
- "attribute": "active",
623
- "reflects": true,
624
- "inheritedFrom": {
625
- "name": "Buttonsimple",
626
- "module": "components/buttonsimple/buttonsimple.component.js"
627
- }
628
- },
629
- {
630
- "kind": "field",
631
- "name": "softDisabled",
632
- "type": {
633
- "text": "boolean | undefined"
634
- },
635
- "description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
636
- "default": "undefined",
637
- "attribute": "soft-disabled",
638
- "reflects": true,
639
- "inheritedFrom": {
640
- "name": "Buttonsimple",
641
- "module": "components/buttonsimple/buttonsimple.component.js"
642
- }
643
- },
644
- {
645
- "kind": "field",
646
- "name": "size",
647
- "type": {
648
- "text": "ButtonSize"
649
- },
650
- "description": "Simplebutton size is a super set of all the sizes supported by children components.",
651
- "default": "32",
652
- "attribute": "size",
653
- "reflects": true,
654
- "inheritedFrom": {
655
- "name": "Buttonsimple",
656
- "module": "components/buttonsimple/buttonsimple.component.js"
657
- }
658
- },
659
- {
660
- "kind": "field",
661
- "name": "role",
662
- "description": "This property defines the ARIA role for the element. By default, it is set to 'button'.\nConsumers should override this role when:\n- The element is being used in a context where a different role is more appropriate.\n- Custom behaviors are implemented that require a specific ARIA role for accessibility purposes.",
663
- "default": "button",
664
- "attribute": "role",
665
- "reflects": true,
666
- "inheritedFrom": {
667
- "name": "Buttonsimple",
668
- "module": "components/buttonsimple/buttonsimple.component.js"
669
- }
670
- },
671
- {
672
- "kind": "field",
673
- "name": "ariaStateKey",
674
- "type": {
675
- "text": "string | undefined"
676
- },
677
- "description": "This property defines the ARIA state key, which will be toggled when the\nButton is set to `active`.\nThe default value is 'aria-pressed', which is commonly used for toggle buttons.\n\nConsumers can override this property to use a different ARIA state key if needed.\nIn case multiple aria attributes should be toggled, they can be passed in as\na comma separated string.\nFor example: `aria-pressed,aria-expanded`",
678
- "default": "'aria-pressed' (when)",
679
- "attribute": "ariaStateKey",
680
- "reflects": true,
681
- "inheritedFrom": {
682
- "name": "Buttonsimple",
683
- "module": "components/buttonsimple/buttonsimple.component.js"
684
- }
685
- },
686
- {
687
- "kind": "field",
688
- "name": "type",
689
- "type": {
690
- "text": "ButtonType"
691
- },
692
- "description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
693
- "default": "button",
694
- "attribute": "type",
695
- "reflects": true,
696
- "inheritedFrom": {
697
- "name": "Buttonsimple",
698
- "module": "components/buttonsimple/buttonsimple.component.js"
699
- }
700
- },
701
- {
702
- "kind": "method",
703
- "name": "executeAction",
704
- "privacy": "protected",
705
- "inheritedFrom": {
706
- "name": "Buttonsimple",
707
- "module": "components/buttonsimple/buttonsimple.component.js"
708
- }
709
- },
710
- {
711
- "kind": "method",
712
- "name": "setActive",
713
- "privacy": "protected",
714
- "parameters": [
715
- {
716
- "name": "element",
717
- "type": {
718
- "text": "HTMLElement"
719
- },
720
- "description": "The button element"
721
- },
722
- {
723
- "name": "active",
724
- "optional": true,
725
- "type": {
726
- "text": "boolean"
727
- },
728
- "description": "The active state of the element"
729
- }
730
- ],
731
- "description": "Sets the ariaStateKey attributes based on the active state of the button.",
732
- "inheritedFrom": {
733
- "name": "Buttonsimple",
734
- "module": "components/buttonsimple/buttonsimple.component.js"
735
- }
736
- },
737
- {
738
- "kind": "method",
739
- "name": "setSoftDisabled",
740
- "privacy": "private",
741
- "parameters": [
742
- {
743
- "name": "element",
744
- "type": {
745
- "text": "HTMLElement"
746
- },
747
- "description": "The button element."
748
- },
749
- {
750
- "name": "softDisabled",
751
- "optional": true,
752
- "type": {
753
- "text": "boolean"
754
- },
755
- "description": "The soft-disabled state."
756
- }
757
- ],
758
- "description": "Sets the soft-disabled attribute for the button.\nWhen soft-disabled, the button looks to be disabled but remains focusable and clickable.\nAlso sets/removes aria-disabled attribute.",
759
- "inheritedFrom": {
760
- "name": "Buttonsimple",
761
- "module": "components/buttonsimple/buttonsimple.component.js"
762
- }
763
- },
764
- {
765
- "kind": "method",
766
- "name": "setDisabled",
767
- "privacy": "private",
768
- "parameters": [
769
- {
770
- "name": "element",
771
- "type": {
772
- "text": "HTMLElement"
773
- },
774
- "description": "The button element."
775
- },
776
- {
777
- "name": "disabled",
778
- "type": {
779
- "text": "boolean"
780
- },
781
- "description": "The disabled state."
782
- }
783
- ],
784
- "description": "Sets the disabled attribute for the button.\nWhen disabled, the button is not focusable or clickable, and tabindex is set to -1.\nThe previous tabindex is stored and restored when enabled.\nAlso sets/removes aria-disabled attribute.",
785
- "inheritedFrom": {
786
- "name": "Buttonsimple",
787
- "module": "components/buttonsimple/buttonsimple.component.js"
788
- }
789
- },
790
- {
791
- "kind": "method",
792
- "name": "triggerClickEvent",
793
- "privacy": "private",
794
- "inheritedFrom": {
795
- "name": "Buttonsimple",
796
- "module": "components/buttonsimple/buttonsimple.component.js"
797
- }
798
- },
799
- {
800
- "kind": "method",
801
- "name": "handleBlur",
802
- "privacy": "private",
803
- "description": "In case the button is pressed and the focus is lost while pressing,\nthe pressed class is removed.",
804
- "inheritedFrom": {
805
- "name": "Buttonsimple",
806
- "module": "components/buttonsimple/buttonsimple.component.js"
807
- }
808
- },
809
- {
810
- "kind": "method",
811
- "name": "handleKeyDown",
812
- "privacy": "private",
813
- "parameters": [
814
- {
815
- "name": "event",
816
- "type": {
817
- "text": "KeyboardEvent"
818
- },
819
- "description": "The keyboard event."
820
- }
821
- ],
822
- "description": "Handles the keydown event on the button.\nIf the key is 'Enter' or 'Space', the button is pressed.\nIf the key is 'Enter', the button is pressed. The native HTML button works in the same way.\nIf the key is 'Space', the button's default is prevent to avoid scrolling etc in the host application.",
823
- "inheritedFrom": {
824
- "name": "Buttonsimple",
825
- "module": "components/buttonsimple/buttonsimple.component.js"
826
- }
827
- },
828
- {
829
- "kind": "method",
830
- "name": "handleKeyUp",
831
- "privacy": "private",
832
- "parameters": [
833
- {
834
- "name": "event",
835
- "type": {
836
- "text": "KeyboardEvent"
837
- },
838
- "description": "The keyboard event."
839
- }
840
- ],
841
- "description": "Handles the keyup event on the button.\nIf the key is 'Enter' or 'Space', the button is clicked.\nIf the key is 'Space', the button is pressed. The native HTML button works in the same way.",
842
- "inheritedFrom": {
843
- "name": "Buttonsimple",
844
- "module": "components/buttonsimple/buttonsimple.component.js"
845
- }
846
- }
847
- ],
848
- "attributes": [
803
+ "name": "Avatar",
804
+ "cssProperties": [
849
805
  {
850
- "name": "variant",
851
- "type": {
852
- "text": "VariantType"
853
- },
854
- "description": "The variant of the alertchip. It supports 5 variants\n- neutral\n- warning\n- error\n- success\n- informational",
855
- "default": "neutral",
856
- "fieldName": "variant"
806
+ "description": "Allows customization of the default background color.",
807
+ "name": "--mdc-avatar-default-background-color"
857
808
  },
858
809
  {
859
- "name": "label",
810
+ "description": "Allows customization of the default foreground color.",
811
+ "name": "--mdc-avatar-default-foreground-color"
812
+ },
813
+ {
814
+ "description": "Allows customization of the loading indicator background color.",
815
+ "name": "--mdc-avatar-loading-indicator-background-color"
816
+ },
817
+ {
818
+ "description": "Allows customization of the loading indicator foreground color.",
819
+ "name": "--mdc-avatar-loading-indicator-foreground-color"
820
+ },
821
+ {
822
+ "description": "Allows customization of the loading overlay background color.",
823
+ "name": "--mdc-avatar-loading-overlay-background-color"
824
+ }
825
+ ],
826
+ "members": [
827
+ {
828
+ "kind": "field",
829
+ "name": "src",
860
830
  "type": {
861
- "text": "string"
831
+ "text": "string | undefined"
862
832
  },
863
- "default": "''",
864
- "description": "The visible label text of the alertchip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
865
- "fieldName": "label"
833
+ "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
834
+ "attribute": "src",
835
+ "inheritedFrom": {
836
+ "name": "AvatarComponentMixin",
837
+ "module": "utils/mixins/AvatarComponentMixin.js"
838
+ }
866
839
  },
867
840
  {
868
- "name": "autofocus",
841
+ "kind": "field",
842
+ "name": "initials",
869
843
  "type": {
870
- "text": "boolean"
844
+ "text": "string | undefined"
871
845
  },
872
- "default": "false",
873
- "description": "This property indicates whether the element should receive focus automatically when it is rendered.",
874
- "fieldName": "autofocus",
846
+ "description": "The initials to be displayed for the avatar.",
847
+ "attribute": "initials",
875
848
  "inheritedFrom": {
876
- "name": "AutoFocusMixin",
877
- "module": "src/utils/mixins/AutoFocusMixin.ts"
849
+ "name": "AvatarComponentMixin",
850
+ "module": "utils/mixins/AvatarComponentMixin.js"
878
851
  }
879
852
  },
880
853
  {
881
- "name": "tabIndex",
854
+ "kind": "field",
855
+ "name": "presence",
882
856
  "type": {
883
- "text": "number"
857
+ "text": "PresenceType | undefined"
884
858
  },
885
- "default": "0",
886
- "description": "This property specifies the tab order of the element.",
887
- "fieldName": "tabIndex",
859
+ "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
860
+ "attribute": "presence",
888
861
  "inheritedFrom": {
889
- "name": "TabIndexMixin",
890
- "module": "src/utils/mixins/TabIndexMixin.ts"
862
+ "name": "AvatarComponentMixin",
863
+ "module": "utils/mixins/AvatarComponentMixin.js"
891
864
  }
892
865
  },
893
866
  {
894
- "name": "disabled",
867
+ "kind": "field",
868
+ "name": "size",
895
869
  "type": {
896
- "text": "boolean | undefined"
870
+ "text": "AvatarSize"
897
871
  },
898
- "description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
899
- "default": "undefined",
900
- "fieldName": "disabled",
872
+ "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
873
+ "default": "32",
874
+ "attribute": "size",
875
+ "reflects": true,
901
876
  "inheritedFrom": {
902
- "name": "DisabledMixin",
903
- "module": "src/utils/mixins/DisabledMixin.ts"
877
+ "name": "AvatarComponentMixin",
878
+ "module": "utils/mixins/AvatarComponentMixin.js"
904
879
  }
905
880
  },
906
881
  {
907
- "name": "active",
882
+ "kind": "field",
883
+ "name": "counter",
908
884
  "type": {
909
- "text": "boolean | undefined"
885
+ "text": "number | undefined"
910
886
  },
911
- "description": "The button's active state indicates whether it is currently toggled on (active) or off (inactive).\nWhen the active state is true, the button is considered to be in an active state, meaning it is toggled on.\nConversely, when the active state is false, the button is in an inactive state, indicating it is toggled off.\n\nThis attribute is used to set the provided `ariaStateKey` to true or false.",
912
- "default": "undefined",
913
- "fieldName": "active",
887
+ "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
888
+ "attribute": "counter",
914
889
  "inheritedFrom": {
915
- "name": "Buttonsimple",
916
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
890
+ "name": "AvatarComponentMixin",
891
+ "module": "utils/mixins/AvatarComponentMixin.js"
917
892
  }
918
893
  },
919
894
  {
920
- "name": "soft-disabled",
895
+ "kind": "field",
896
+ "name": "isTyping",
921
897
  "type": {
922
- "text": "boolean | undefined"
898
+ "text": "boolean"
923
899
  },
924
- "description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
925
- "default": "undefined",
926
- "fieldName": "softDisabled",
900
+ "default": "false",
901
+ "description": "Represents the typing indicator when the user is typing.",
902
+ "attribute": "is-typing",
927
903
  "inheritedFrom": {
928
- "name": "Buttonsimple",
929
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
904
+ "name": "AvatarComponentMixin",
905
+ "module": "utils/mixins/AvatarComponentMixin.js"
930
906
  }
931
907
  },
932
908
  {
933
- "name": "size",
909
+ "kind": "field",
910
+ "name": "iconName",
934
911
  "type": {
935
- "text": "ButtonSize"
912
+ "text": "IconNames | undefined"
936
913
  },
937
- "description": "Simplebutton size is a super set of all the sizes supported by children components.",
938
- "default": "32",
939
- "fieldName": "size",
914
+ "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
915
+ "attribute": "icon-name",
940
916
  "inheritedFrom": {
941
- "name": "Buttonsimple",
942
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
917
+ "name": "IconNameMixin",
918
+ "module": "utils/mixins/IconNameMixin.js"
943
919
  }
920
+ }
921
+ ],
922
+ "mixins": [
923
+ {
924
+ "name": "AvatarComponentMixin",
925
+ "module": "/src/utils/mixins/AvatarComponentMixin"
944
926
  },
945
927
  {
946
- "name": "role",
947
- "description": "This property defines the ARIA role for the element. By default, it is set to 'button'.\nConsumers should override this role when:\n- The element is being used in a context where a different role is more appropriate.\n- Custom behaviors are implemented that require a specific ARIA role for accessibility purposes.",
948
- "default": "button",
949
- "fieldName": "role",
928
+ "name": "IconNameMixin",
929
+ "module": "/src/utils/mixins/IconNameMixin"
930
+ }
931
+ ],
932
+ "superclass": {
933
+ "name": "Component",
934
+ "module": "/src/models"
935
+ },
936
+ "tagName": "mdc-avatar",
937
+ "jsDoc": "/**\n * The `mdc-avatar` component is used to represent a person or a space.\n * An avatar can be an icon, initials, counter and photo.\n *\n * To set the photo of an avatar,\n * you need to set \"src\" attribute.\n *\n * While the avatar image is loading, as a placeholder,\n * we will show the initials text.\n * If the initials are not specified then,\n * we will show `user-regular` icon as a placeholder.\n *\n * By default, if there are no attributes specified,\n * then the default avatar will be an icon with `user-regular` name.\n *\n * The avatar component is non clickable and non interactive/focusable component.\n * If the avatar is typing, then the loading indicator will be displayed.\n * If the counter type avatar is set to a negative number, then we will display 0.\n * The presence indicator will be hidden when the counter property is set.\n *\n * @dependency mdc-icon\n * @dependency mdc-presence\n * @dependency mdc-text\n *\n * @tagname mdc-avatar\n *\n * @cssproperty --mdc-avatar-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-avatar-default-foreground-color - Allows customization of the default foreground color.\n * @cssproperty --mdc-avatar-loading-indicator-background-color -\n * Allows customization of the loading indicator background color.\n * @cssproperty --mdc-avatar-loading-indicator-foreground-color -\n * Allows customization of the loading indicator foreground color.\n * @cssproperty --mdc-avatar-loading-overlay-background-color -\n * Allows customization of the loading overlay background color.\n */",
938
+ "customElement": true,
939
+ "attributes": [
940
+ {
941
+ "name": "src",
942
+ "type": {
943
+ "text": "string | undefined"
944
+ },
945
+ "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
946
+ "fieldName": "src",
950
947
  "inheritedFrom": {
951
- "name": "Buttonsimple",
952
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
948
+ "name": "AvatarComponentMixin",
949
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
953
950
  }
954
951
  },
955
952
  {
956
- "name": "ariaStateKey",
953
+ "name": "initials",
957
954
  "type": {
958
955
  "text": "string | undefined"
959
956
  },
960
- "description": "This property defines the ARIA state key, which will be toggled when the\nButton is set to `active`.\nThe default value is 'aria-pressed', which is commonly used for toggle buttons.\n\nConsumers can override this property to use a different ARIA state key if needed.\nIn case multiple aria attributes should be toggled, they can be passed in as\na comma separated string.\nFor example: `aria-pressed,aria-expanded`",
961
- "default": "'aria-pressed' (when)",
962
- "fieldName": "ariaStateKey",
957
+ "description": "The initials to be displayed for the avatar.",
958
+ "fieldName": "initials",
963
959
  "inheritedFrom": {
964
- "name": "Buttonsimple",
965
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
960
+ "name": "AvatarComponentMixin",
961
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
966
962
  }
967
963
  },
968
964
  {
969
- "name": "type",
965
+ "name": "presence",
970
966
  "type": {
971
- "text": "ButtonType"
967
+ "text": "PresenceType | undefined"
972
968
  },
973
- "description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
974
- "default": "button",
975
- "fieldName": "type",
969
+ "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
970
+ "fieldName": "presence",
976
971
  "inheritedFrom": {
977
- "name": "Buttonsimple",
978
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
972
+ "name": "AvatarComponentMixin",
973
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
979
974
  }
980
- }
981
- ],
982
- "superclass": {
983
- "name": "Buttonsimple",
984
- "module": "/src/components/buttonsimple/buttonsimple.component"
985
- },
986
- "tagName": "mdc-alertchip",
987
- "jsDoc": "/**\n * mdc-alertchip component is an interactive chip that consumers can use to represent an alert.\n *\n * - It supports a leading icon along with label.\n * - It supports 5 variants of alerts - neutral, warning, error, success, and informational\n *\n * This component is built by extending Buttonsimple.\n *\n * @tagname mdc-alertchip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the label text\n * @cssproperty --mdc-chip-icon-color - The color of the icon\n * @cssproperty --mdc-chip-border-color - The border color of the alertchip\n * @cssproperty --mdc-chip-background-color - The background color of the alertchip\n *\n */",
988
- "customElement": true,
989
- "events": [
975
+ },
990
976
  {
991
- "description": "(React: onClick) This event is dispatched when the button is clicked.",
992
- "name": "click",
993
- "reactName": "onClick",
977
+ "name": "size",
978
+ "type": {
979
+ "text": "AvatarSize"
980
+ },
981
+ "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
982
+ "default": "32",
983
+ "fieldName": "size",
994
984
  "inheritedFrom": {
995
- "name": "Buttonsimple",
996
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
985
+ "name": "AvatarComponentMixin",
986
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
997
987
  }
998
988
  },
999
989
  {
1000
- "description": "(React: onKeyDown) This event is dispatched when a key is pressed down on the button.",
1001
- "name": "keydown",
1002
- "reactName": "onKeyDown",
990
+ "name": "counter",
991
+ "type": {
992
+ "text": "number | undefined"
993
+ },
994
+ "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
995
+ "fieldName": "counter",
1003
996
  "inheritedFrom": {
1004
- "name": "Buttonsimple",
1005
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
997
+ "name": "AvatarComponentMixin",
998
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
1006
999
  }
1007
1000
  },
1008
1001
  {
1009
- "description": "(React: onKeyUp) This event is dispatched when a key is released on the button.",
1010
- "name": "keyup",
1011
- "reactName": "onKeyUp",
1002
+ "name": "is-typing",
1003
+ "type": {
1004
+ "text": "boolean"
1005
+ },
1006
+ "default": "false",
1007
+ "description": "Represents the typing indicator when the user is typing.",
1008
+ "fieldName": "isTyping",
1012
1009
  "inheritedFrom": {
1013
- "name": "Buttonsimple",
1014
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
1010
+ "name": "AvatarComponentMixin",
1011
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
1015
1012
  }
1016
1013
  },
1017
1014
  {
1018
- "description": "(React: onFocus) This event is dispatched when the button receives focus.",
1019
- "name": "focus",
1020
- "reactName": "onFocus",
1015
+ "name": "icon-name",
1016
+ "type": {
1017
+ "text": "IconNames | undefined"
1018
+ },
1019
+ "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
1020
+ "fieldName": "iconName",
1021
1021
  "inheritedFrom": {
1022
- "name": "Buttonsimple",
1023
- "module": "src/components/buttonsimple/buttonsimple.component.ts"
1022
+ "name": "IconNameMixin",
1023
+ "module": "src/utils/mixins/IconNameMixin.ts"
1024
1024
  }
1025
1025
  }
1026
1026
  ]
@@ -1031,8 +1031,8 @@
1031
1031
  "kind": "js",
1032
1032
  "name": "default",
1033
1033
  "declaration": {
1034
- "name": "AlertChip",
1035
- "module": "components/alertchip/alertchip.component.js"
1034
+ "name": "Avatar",
1035
+ "module": "components/avatar/avatar.component.js"
1036
1036
  }
1037
1037
  }
1038
1038
  ]