@muraldevkit/ui-toolkit 4.79.1 → 4.80.0

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.
Files changed (133) hide show
  1. package/dist/cjs/components/avatar/MrlAvatar/MrlAvatar.js.map +1 -1
  2. package/dist/cjs/components/badge/MrlBadge/MrlBadge.js.map +1 -1
  3. package/dist/cjs/components/badge/MrlBadgeNotification/MrlBadgeNotification.js.map +1 -1
  4. package/dist/cjs/components/button/MrlAnimatedIconButton/MrlAnimatedIconButton.js.map +1 -1
  5. package/dist/cjs/components/callout/MrlCallout/MrlCallout.js.map +1 -1
  6. package/dist/cjs/components/empty/default/MrlEmpty.js.map +1 -1
  7. package/dist/cjs/components/empty/large/MrlEmptyLarge.js.map +1 -1
  8. package/dist/cjs/components/form/date-picker/MrlDatePicker.js.map +1 -1
  9. package/dist/cjs/components/form/select/MrlCreatableSelect/MrlCreatableSelect.js.map +1 -1
  10. package/dist/cjs/components/form/select/MrlMultiCreatableSelect/MrlMultiCreatableSelect.js.map +1 -1
  11. package/dist/cjs/components/form/select/MrlMultiSelect/MrlMultiSelect.js.map +1 -1
  12. package/dist/cjs/components/form/select/MrlSelect/MrlSelect.js.map +1 -1
  13. package/dist/cjs/components/form/switch/MrlSwitch/MrlSwitch.js.map +1 -1
  14. package/dist/cjs/components/form/text-input/MrlEditableTextInput/MrlEditableTextInput.js.map +1 -1
  15. package/dist/cjs/components/form/textarea/MrlEditableTextarea/MrlEditableTextarea.js.map +1 -1
  16. package/dist/cjs/components/grid/constants.js.map +1 -1
  17. package/dist/cjs/components/layout/MrlSidebar/MrlSidebar.js.map +1 -1
  18. package/dist/cjs/components/live-region/MrlLiveRegion/MrlLiveRegion.js.map +1 -1
  19. package/dist/cjs/components/notification/MrlToast/MrlToast.js.map +1 -1
  20. package/dist/cjs/components/pagination/MrlPaginationButton/MrlPaginationButton.js.map +1 -1
  21. package/dist/cjs/components/portal/MrlPortal.js.map +1 -1
  22. package/dist/cjs/components/rovingTabindex/MrlRovingTabindex/MrlRovingTabindex.js.map +1 -1
  23. package/dist/cjs/components/svg/MrlSvg/MrlSvg.js.map +1 -1
  24. package/dist/cjs/components/table/MrlTableCell/MrlTableCell.js.map +1 -1
  25. package/dist/cjs/components/table/MrlTableColumn/MrlTableColumn.js.map +1 -1
  26. package/dist/cjs/components/tabs/MrlTab/MrlTab.js.map +1 -1
  27. package/dist/cjs/components/tabs/MrlTabGroup/MrlTabGroup.js.map +1 -1
  28. package/dist/cjs/components/tabs/MrlTabLink/MrlTabLink.js.map +1 -1
  29. package/dist/cjs/components/tabs/MrlTabs/MrlTabs.js.map +1 -1
  30. package/dist/cjs/components/text/MrlTextHeading/MrlTextHeading.js.map +1 -1
  31. package/dist/cjs/components/toolbar/MrlToolbar/MrlToolbar.js.map +1 -1
  32. package/dist/cjs/components/toolbar/MrlToolbarButton/MrlToolbarButton.js.map +1 -1
  33. package/dist/cjs/version.js +1 -1
  34. package/dist/cjs/version.js.map +1 -1
  35. package/dist/components/avatar/MrlAvatar/MrlAvatar.d.ts +8 -0
  36. package/dist/components/badge/MrlBadge/MrlBadge.d.ts +2 -0
  37. package/dist/components/badge/MrlBadgeNotification/MrlBadgeNotification.d.ts +1 -0
  38. package/dist/components/button/MrlAnimatedIconButton/MrlAnimatedIconButton.d.ts +1 -0
  39. package/dist/components/callout/MrlCallout/MrlCallout.d.ts +9 -0
  40. package/dist/components/empty/default/MrlEmpty.d.ts +4 -0
  41. package/dist/components/empty/large/MrlEmptyLarge.d.ts +4 -0
  42. package/dist/components/form/date-picker/MrlDatePicker.d.ts +2 -0
  43. package/dist/components/form/select/MrlCreatableSelect/MrlCreatableSelect.d.ts +4 -0
  44. package/dist/components/form/select/MrlMultiCreatableSelect/MrlMultiCreatableSelect.d.ts +4 -0
  45. package/dist/components/form/select/MrlMultiSelect/MrlMultiSelect.d.ts +3 -0
  46. package/dist/components/form/select/MrlSelect/MrlSelect.d.ts +3 -0
  47. package/dist/components/form/switch/MrlSwitch/MrlSwitch.d.ts +3 -0
  48. package/dist/components/form/text-input/MrlEditableTextInput/MrlEditableTextInput.d.ts +3 -0
  49. package/dist/components/form/textarea/MrlEditableTextarea/MrlEditableTextarea.d.ts +3 -0
  50. package/dist/components/grid/constants.d.ts +21 -0
  51. package/dist/components/layout/MrlSidebar/MrlSidebar.d.ts +2 -0
  52. package/dist/components/live-region/MrlLiveRegion/MrlLiveRegion.d.ts +6 -0
  53. package/dist/components/notification/MrlToast/MrlToast.d.ts +8 -0
  54. package/dist/components/pagination/MrlPaginationButton/MrlPaginationButton.d.ts +1 -0
  55. package/dist/components/portal/MrlPortal.d.ts +1 -0
  56. package/dist/components/rovingTabindex/MrlRovingTabindex/MrlRovingTabindex.d.ts +10 -0
  57. package/dist/components/svg/MrlSvg/MrlSvg.d.ts +1 -0
  58. package/dist/components/table/MrlTableCell/MrlTableCell.d.ts +3 -0
  59. package/dist/components/table/MrlTableColumn/MrlTableColumn.d.ts +3 -0
  60. package/dist/components/tabs/MrlTab/MrlTab.d.ts +2 -0
  61. package/dist/components/tabs/MrlTabGroup/MrlTabGroup.d.ts +1 -0
  62. package/dist/components/tabs/MrlTabLink/MrlTabLink.d.ts +1 -0
  63. package/dist/components/tabs/MrlTabs/MrlTabs.d.ts +2 -0
  64. package/dist/components/text/MrlTextHeading/MrlTextHeading.d.ts +1 -0
  65. package/dist/components/toolbar/MrlToolbar/MrlToolbar.d.ts +12 -0
  66. package/dist/components/toolbar/MrlToolbarButton/MrlToolbarButton.d.ts +2 -0
  67. package/dist/esm/components/avatar/MrlAvatar/MrlAvatar.js.map +1 -1
  68. package/dist/esm/components/badge/MrlBadge/MrlBadge.js.map +1 -1
  69. package/dist/esm/components/badge/MrlBadgeNotification/MrlBadgeNotification.js.map +1 -1
  70. package/dist/esm/components/button/MrlAnimatedIconButton/MrlAnimatedIconButton.js.map +1 -1
  71. package/dist/esm/components/callout/MrlCallout/MrlCallout.js.map +1 -1
  72. package/dist/esm/components/empty/default/MrlEmpty.js.map +1 -1
  73. package/dist/esm/components/empty/large/MrlEmptyLarge.js.map +1 -1
  74. package/dist/esm/components/form/date-picker/MrlDatePicker.js.map +1 -1
  75. package/dist/esm/components/form/select/MrlCreatableSelect/MrlCreatableSelect.js.map +1 -1
  76. package/dist/esm/components/form/select/MrlMultiCreatableSelect/MrlMultiCreatableSelect.js.map +1 -1
  77. package/dist/esm/components/form/select/MrlMultiSelect/MrlMultiSelect.js.map +1 -1
  78. package/dist/esm/components/form/select/MrlSelect/MrlSelect.js.map +1 -1
  79. package/dist/esm/components/form/switch/MrlSwitch/MrlSwitch.js.map +1 -1
  80. package/dist/esm/components/form/text-input/MrlEditableTextInput/MrlEditableTextInput.js.map +1 -1
  81. package/dist/esm/components/form/textarea/MrlEditableTextarea/MrlEditableTextarea.js.map +1 -1
  82. package/dist/esm/components/grid/constants.js.map +1 -1
  83. package/dist/esm/components/layout/MrlSidebar/MrlSidebar.js.map +1 -1
  84. package/dist/esm/components/live-region/MrlLiveRegion/MrlLiveRegion.js.map +1 -1
  85. package/dist/esm/components/notification/MrlToast/MrlToast.js.map +1 -1
  86. package/dist/esm/components/pagination/MrlPaginationButton/MrlPaginationButton.js.map +1 -1
  87. package/dist/esm/components/portal/MrlPortal.js.map +1 -1
  88. package/dist/esm/components/rovingTabindex/MrlRovingTabindex/MrlRovingTabindex.js.map +1 -1
  89. package/dist/esm/components/svg/MrlSvg/MrlSvg.js.map +1 -1
  90. package/dist/esm/components/table/MrlTableCell/MrlTableCell.js.map +1 -1
  91. package/dist/esm/components/table/MrlTableColumn/MrlTableColumn.js.map +1 -1
  92. package/dist/esm/components/tabs/MrlTab/MrlTab.js.map +1 -1
  93. package/dist/esm/components/tabs/MrlTabGroup/MrlTabGroup.js.map +1 -1
  94. package/dist/esm/components/tabs/MrlTabLink/MrlTabLink.js.map +1 -1
  95. package/dist/esm/components/tabs/MrlTabs/MrlTabs.js.map +1 -1
  96. package/dist/esm/components/text/MrlTextHeading/MrlTextHeading.js.map +1 -1
  97. package/dist/esm/components/toolbar/MrlToolbar/MrlToolbar.js.map +1 -1
  98. package/dist/esm/components/toolbar/MrlToolbarButton/MrlToolbarButton.js.map +1 -1
  99. package/dist/esm/version.js +1 -1
  100. package/dist/esm/version.js.map +1 -1
  101. package/dist/types/components/avatar/MrlAvatar/MrlAvatar.d.ts +8 -0
  102. package/dist/types/components/badge/MrlBadge/MrlBadge.d.ts +2 -0
  103. package/dist/types/components/badge/MrlBadgeNotification/MrlBadgeNotification.d.ts +1 -0
  104. package/dist/types/components/button/MrlAnimatedIconButton/MrlAnimatedIconButton.d.ts +1 -0
  105. package/dist/types/components/callout/MrlCallout/MrlCallout.d.ts +9 -0
  106. package/dist/types/components/empty/default/MrlEmpty.d.ts +4 -0
  107. package/dist/types/components/empty/large/MrlEmptyLarge.d.ts +4 -0
  108. package/dist/types/components/form/date-picker/MrlDatePicker.d.ts +2 -0
  109. package/dist/types/components/form/select/MrlCreatableSelect/MrlCreatableSelect.d.ts +4 -0
  110. package/dist/types/components/form/select/MrlMultiCreatableSelect/MrlMultiCreatableSelect.d.ts +4 -0
  111. package/dist/types/components/form/select/MrlMultiSelect/MrlMultiSelect.d.ts +3 -0
  112. package/dist/types/components/form/select/MrlSelect/MrlSelect.d.ts +3 -0
  113. package/dist/types/components/form/switch/MrlSwitch/MrlSwitch.d.ts +3 -0
  114. package/dist/types/components/form/text-input/MrlEditableTextInput/MrlEditableTextInput.d.ts +3 -0
  115. package/dist/types/components/form/textarea/MrlEditableTextarea/MrlEditableTextarea.d.ts +3 -0
  116. package/dist/types/components/grid/constants.d.ts +21 -0
  117. package/dist/types/components/layout/MrlSidebar/MrlSidebar.d.ts +2 -0
  118. package/dist/types/components/live-region/MrlLiveRegion/MrlLiveRegion.d.ts +6 -0
  119. package/dist/types/components/notification/MrlToast/MrlToast.d.ts +8 -0
  120. package/dist/types/components/pagination/MrlPaginationButton/MrlPaginationButton.d.ts +1 -0
  121. package/dist/types/components/portal/MrlPortal.d.ts +1 -0
  122. package/dist/types/components/rovingTabindex/MrlRovingTabindex/MrlRovingTabindex.d.ts +10 -0
  123. package/dist/types/components/svg/MrlSvg/MrlSvg.d.ts +1 -0
  124. package/dist/types/components/table/MrlTableCell/MrlTableCell.d.ts +3 -0
  125. package/dist/types/components/table/MrlTableColumn/MrlTableColumn.d.ts +3 -0
  126. package/dist/types/components/tabs/MrlTab/MrlTab.d.ts +2 -0
  127. package/dist/types/components/tabs/MrlTabGroup/MrlTabGroup.d.ts +1 -0
  128. package/dist/types/components/tabs/MrlTabLink/MrlTabLink.d.ts +1 -0
  129. package/dist/types/components/tabs/MrlTabs/MrlTabs.d.ts +2 -0
  130. package/dist/types/components/text/MrlTextHeading/MrlTextHeading.d.ts +1 -0
  131. package/dist/types/components/toolbar/MrlToolbar/MrlToolbar.d.ts +12 -0
  132. package/dist/types/components/toolbar/MrlToolbarButton/MrlToolbarButton.d.ts +2 -0
  133. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"MrlToolbarButton.js","sources":["../../../../../src/components/toolbar/MrlToolbarButton/MrlToolbarButton.tsx"],"sourcesContent":["import * as React from 'react';\nimport { MrlIconButton, MrlIconButtonProps } from '../../button/MrlIconButton/MrlIconButton';\nimport { MrlMenuItem, MrlMenuItemProps } from '../../menu/MrlMenuItem/MrlMenuItem';\n\nimport styles from './MrlToolbarButton.module.scss';\nimport classnames from 'classnames';\nimport { useMrlTrackInteraction } from '../../../hooks/useMrlAnalytics';\n\n/**\n * Props for the MrlToolbarButton component.\n */\nexport interface MrlToolbarButtonProps {\n\t/** Additional class to add to the Toolbar button */\n\tclassName?: string;\n\t/**\n\t * The icon that will be rendered.\n\t */\n\ticon: React.ReactElement;\n\tincludeInRoving?: boolean;\n\t/**\n\t * A prop used to set a toolbar button to never move into the menu.\n\t */\n\tlockedInToolbar?: boolean;\n\t/**\n\t * onClick event for the button.\n\t */\n\tonClick?: (e?: React.MouseEvent<HTMLButtonElement>) => void;\n\t/**\n\t * Props used to control the display of the button in the menu.\n\t */\n\tmenuItemProps?: Omit<MrlMenuItemProps, 'onClick'>;\n\tqa?: string;\n\t/**\n\t * A prop used to render the item in the menu instead of the toolbar.\n\t */\n\trenderInMenu?: boolean;\n\ttext: string;\n\t/**\n\t * Enables interaction tracking for this button. Provide a stable, non-PII id\n\t * (e.g. 'canvas-toolbar-shapes'). When omitted, the button emits no analytics.\n\t */\n\teventId?: string;\n\t/**\n\t * Props used to control the display of the button in the toolbar.\n\t */\n\ttoolbarButtonProps?: {\n\t\tbadge?: MrlIconButtonProps['badge'];\n\t\tdisableEvents?: MrlIconButtonProps['disableEvents'];\n\t\tkind?: MrlIconButtonProps['kind'];\n\t\tloading?: MrlIconButtonProps['loading'];\n\t\tloadingText?: MrlIconButtonProps['loadingText'];\n\t\tonKeyUp?: MrlIconButtonProps['onKeyUp'];\n\t\tonMouseUp?: MrlIconButtonProps['onMouseUp'];\n\t\tposition?: MrlIconButtonProps['position'];\n\t\tsize?: MrlIconButtonProps['size'];\n\t\tstate?: MrlIconButtonProps['state'];\n\t\ttipAnchor?: MrlIconButtonProps['tipAnchor'];\n\t\ttooltipCustomRender?: MrlIconButtonProps['tooltipCustomRender'];\n\t\ttoggleAria?: MrlIconButtonProps['toggleAria'];\n\t\ttoggleStyle?: MrlIconButtonProps['toggleStyle'];\n\t};\n}\n\n/**\n * MrlToolbarButton component.\n * @param props The MrlToolbarButton component properties.\n * @returns The MrlToolbarButton component.\n */\nexport const MrlToolbarButton = React.forwardRef<HTMLButtonElement, MrlToolbarButtonProps>(\n\tfunction MrlToolbarButton(props, ref): JSX.Element {\n\t\tconst {\n\t\t\tclassName,\n\t\t\ticon,\n\t\t\tincludeInRoving = false,\n\t\t\tmenuItemProps,\n\t\t\tonClick,\n\t\t\tqa,\n\t\t\trenderInMenu,\n\t\t\ttext,\n\t\t\ttoolbarButtonProps = {\n\t\t\t\tposition: 'bottom',\n\t\t\t\tsize: 'small',\n\t\t\t\tstate: 'default'\n\t\t\t},\n\t\t\t// pulled out of `rest` so the nested MrlIconButton/MrlMenuItem doesn't emit a\n\t\t\t// second, less specific event for the same interaction.\n\t\t\teventId,\n\t\t\t...rest\n\t\t} = props;\n\t\tconst classes = classnames('MrlToolbarButton', className);\n\n\t\tconst trackInteraction = useMrlTrackInteraction('MrlToolbarButton', eventId);\n\n\t\t/**\n\t\t * Handle onClick events\n\t\t *\n\t\t * @param {React.MouseEvent<HTMLButtonElement>} e - mouse event\n\t\t */\n\t\tconst handleOnClick = (e?: React.MouseEvent<HTMLButtonElement>) => {\n\t\t\ttrackInteraction({\n\t\t\t\taction: 'click',\n\t\t\t\tvariant: renderInMenu ? 'menu' : 'toolbar'\n\t\t\t});\n\n\t\t\tonClick?.(e);\n\t\t};\n\n\t\tif (renderInMenu) {\n\t\t\treturn (\n\t\t\t\t<MrlMenuItem {...menuItemProps} className={classes} data-qa={qa} onClick={handleOnClick}>\n\t\t\t\t\t<span className={styles.MrlToolbarButtonIcon}>{icon}</span>\n\t\t\t\t\t{text}\n\t\t\t\t</MrlMenuItem>\n\t\t\t);\n\t\t}\n\n\t\treturn (\n\t\t\t<MrlIconButton\n\t\t\t\t{...rest}\n\t\t\t\t{...toolbarButtonProps}\n\t\t\t\tclassName={classes}\n\t\t\t\tdata-qa={qa}\n\t\t\t\tdata-roving={includeInRoving ? 'true' : undefined}\n\t\t\t\ticon={icon}\n\t\t\t\tonClick={handleOnClick}\n\t\t\t\tref={ref}\n\t\t\t\ttext={text}\n\t\t\t/>\n\t\t);\n\t}\n);\n"],"names":["MrlToolbarButton","React","forwardRef","props","ref","className","icon","_props$includeInRovin","includeInRoving","menuItemProps","onClick","qa","renderInMenu","text","_props$toolbarButtonP","toolbarButtonProps","position","size","state","eventId","rest","_objectWithoutProperties","_excluded","classes","classnames","trackInteraction","useMrlTrackInteraction","handleOnClick","e","action","variant","createElement","MrlMenuItem","_extends","styles","MrlToolbarButtonIcon","MrlIconButton","undefined"],"mappings":";;;;;;;;;;AAQA;AACA;AACA;;AAqDA;AACA;AACA;AACA;AACA;AACO,IAAMA,gBAAgB,gBAAGC,KAAK,CAACC,UAAU,CAC/C,SAASF,gBAAgBA,CAACG,KAAK,EAAEC,GAAG,EAAe;AAClD,EAAA,IACCC,SAAS,GAiBNF,KAAK,CAjBRE,SAAS;IACTC,IAAI,GAgBDH,KAAK,CAhBRG,IAAI;IAAAC,qBAAA,GAgBDJ,KAAK,CAfRK,eAAe;AAAfA,IAAAA,eAAe,GAAAD,qBAAA,KAAA,MAAA,GAAG,KAAK,GAAAA,qBAAA;IACvBE,aAAa,GAcVN,KAAK,CAdRM,aAAa;IACbC,OAAO,GAaJP,KAAK,CAbRO,OAAO;IACPC,EAAE,GAYCR,KAAK,CAZRQ,EAAE;IACFC,YAAY,GAWTT,KAAK,CAXRS,YAAY;IACZC,IAAI,GAUDV,KAAK,CAVRU,IAAI;IAAAC,qBAAA,GAUDX,KAAK,CATRY,kBAAkB;IAAlBA,kBAAkB,GAAAD,qBAAA,KAAA,MAAA,GAAG;AACpBE,MAAAA,QAAQ,EAAE,QAAQ;AAClBC,MAAAA,IAAI,EAAE,OAAO;AACbC,MAAAA,KAAK,EAAE;AACR,KAAC,GAAAJ,qBAAA;IAGDK,OAAO,GAEJhB,KAAK,CAFRgB,OAAO;AACJC,IAAAA,IAAI,GAAAC,wBAAA,CACJlB,KAAK,EAAAmB,SAAA,CAAA;AACT,EAAA,IAAMC,OAAO,GAAGC,UAAU,CAAC,kBAAkB,EAAEnB,SAAS,CAAC;AAEzD,EAAA,IAAMoB,gBAAgB,GAAGC,sBAAsB,CAAC,kBAAkB,EAAEP,OAAO,CAAC;;AAE5E;AACF;AACA;AACA;AACA;EACE,IAAMQ,aAAa,GAAIC,CAAuC,IAAK;AAClEH,IAAAA,gBAAgB,CAAC;AAChBI,MAAAA,MAAM,EAAE,OAAO;AACfC,MAAAA,OAAO,EAAElB,YAAY,GAAG,MAAM,GAAG;AAClC,KAAC,CAAC;AAEFF,IAAAA,OAAO,aAAPA,OAAO,KAAA,MAAA,GAAA,MAAA,GAAPA,OAAO,CAAGkB,CAAC,CAAC;EACb,CAAC;AAED,EAAA,IAAIhB,YAAY,EAAE;IACjB,oBACCX,KAAA,CAAA8B,aAAA,CAACC,WAAW,EAAAC,QAAA,KAAKxB,aAAa,EAAA;AAAEJ,MAAAA,SAAS,EAAEkB,OAAQ;AAAC,MAAA,SAAA,EAASZ,EAAG;AAACD,MAAAA,OAAO,EAAEiB;KAAc,CAAA,eACvF1B,KAAA,CAAA8B,aAAA,CAAA,MAAA,EAAA;MAAM1B,SAAS,EAAE6B,MAAM,CAACC;AAAqB,KAAA,EAAE7B,IAAW,CAAC,EAC1DO,IACW,CAAC;AAEhB,EAAA;EAEA,oBACCZ,KAAA,CAAA8B,aAAA,CAACK,aAAa,EAAAH,QAAA,CAAA,EAAA,EACTb,IAAI,EACJL,kBAAkB,EAAA;AACtBV,IAAAA,SAAS,EAAEkB,OAAQ;AACnB,IAAA,SAAA,EAASZ,EAAG;AACZ,IAAA,aAAA,EAAaH,eAAe,GAAG,MAAM,GAAG6B,SAAU;AAClD/B,IAAAA,IAAI,EAAEA,IAAK;AACXI,IAAAA,OAAO,EAAEiB,aAAc;AACvBvB,IAAAA,GAAG,EAAEA,GAAI;AACTS,IAAAA,IAAI,EAAEA;AAAK,GAAA,CACX,CAAC;AAEJ,CACD;;;;"}
1
+ {"version":3,"file":"MrlToolbarButton.js","sources":["../../../../../src/components/toolbar/MrlToolbarButton/MrlToolbarButton.tsx"],"sourcesContent":["import * as React from 'react';\nimport { MrlIconButton, MrlIconButtonProps } from '../../button/MrlIconButton/MrlIconButton';\nimport { MrlMenuItem, MrlMenuItemProps } from '../../menu/MrlMenuItem/MrlMenuItem';\n\nimport styles from './MrlToolbarButton.module.scss';\nimport classnames from 'classnames';\nimport { useMrlTrackInteraction } from '../../../hooks/useMrlAnalytics';\n\n/**\n * Props for the MrlToolbarButton component.\n */\nexport interface MrlToolbarButtonProps {\n\t/** Additional class to add to the Toolbar button */\n\tclassName?: string;\n\t/**\n\t * The icon that will be rendered.\n\t */\n\ticon: React.ReactElement;\n\t/** Adds the button to the toolbar's roving tabindex (see `shouldUseRti`). */\n\tincludeInRoving?: boolean;\n\t/**\n\t * A prop used to set a toolbar button to never move into the menu.\n\t */\n\tlockedInToolbar?: boolean;\n\t/**\n\t * onClick event for the button.\n\t */\n\tonClick?: (e?: React.MouseEvent<HTMLButtonElement>) => void;\n\t/**\n\t * Props used to control the display of the button in the menu.\n\t */\n\tmenuItemProps?: Omit<MrlMenuItemProps, 'onClick'>;\n\tqa?: string;\n\t/**\n\t * A prop used to render the item in the menu instead of the toolbar.\n\t */\n\trenderInMenu?: boolean;\n\t/** Accessible label of the button. Also its tooltip and its text when it moves into the menu. */\n\ttext: string;\n\t/**\n\t * Enables interaction tracking for this button. Provide a stable, non-PII id\n\t * (e.g. 'canvas-toolbar-shapes'). When omitted, the button emits no analytics.\n\t */\n\teventId?: string;\n\t/**\n\t * Props used to control the display of the button in the toolbar.\n\t */\n\ttoolbarButtonProps?: {\n\t\tbadge?: MrlIconButtonProps['badge'];\n\t\tdisableEvents?: MrlIconButtonProps['disableEvents'];\n\t\tkind?: MrlIconButtonProps['kind'];\n\t\tloading?: MrlIconButtonProps['loading'];\n\t\tloadingText?: MrlIconButtonProps['loadingText'];\n\t\tonKeyUp?: MrlIconButtonProps['onKeyUp'];\n\t\tonMouseUp?: MrlIconButtonProps['onMouseUp'];\n\t\tposition?: MrlIconButtonProps['position'];\n\t\tsize?: MrlIconButtonProps['size'];\n\t\tstate?: MrlIconButtonProps['state'];\n\t\ttipAnchor?: MrlIconButtonProps['tipAnchor'];\n\t\ttooltipCustomRender?: MrlIconButtonProps['tooltipCustomRender'];\n\t\ttoggleAria?: MrlIconButtonProps['toggleAria'];\n\t\ttoggleStyle?: MrlIconButtonProps['toggleStyle'];\n\t};\n}\n\n/**\n * MrlToolbarButton component.\n * @param props The MrlToolbarButton component properties.\n * @returns The MrlToolbarButton component.\n */\nexport const MrlToolbarButton = React.forwardRef<HTMLButtonElement, MrlToolbarButtonProps>(\n\tfunction MrlToolbarButton(props, ref): JSX.Element {\n\t\tconst {\n\t\t\tclassName,\n\t\t\ticon,\n\t\t\tincludeInRoving = false,\n\t\t\tmenuItemProps,\n\t\t\tonClick,\n\t\t\tqa,\n\t\t\trenderInMenu,\n\t\t\ttext,\n\t\t\ttoolbarButtonProps = {\n\t\t\t\tposition: 'bottom',\n\t\t\t\tsize: 'small',\n\t\t\t\tstate: 'default'\n\t\t\t},\n\t\t\t// pulled out of `rest` so the nested MrlIconButton/MrlMenuItem doesn't emit a\n\t\t\t// second, less specific event for the same interaction.\n\t\t\teventId,\n\t\t\t...rest\n\t\t} = props;\n\t\tconst classes = classnames('MrlToolbarButton', className);\n\n\t\tconst trackInteraction = useMrlTrackInteraction('MrlToolbarButton', eventId);\n\n\t\t/**\n\t\t * Handle onClick events\n\t\t *\n\t\t * @param {React.MouseEvent<HTMLButtonElement>} e - mouse event\n\t\t */\n\t\tconst handleOnClick = (e?: React.MouseEvent<HTMLButtonElement>) => {\n\t\t\ttrackInteraction({\n\t\t\t\taction: 'click',\n\t\t\t\tvariant: renderInMenu ? 'menu' : 'toolbar'\n\t\t\t});\n\n\t\t\tonClick?.(e);\n\t\t};\n\n\t\tif (renderInMenu) {\n\t\t\treturn (\n\t\t\t\t<MrlMenuItem {...menuItemProps} className={classes} data-qa={qa} onClick={handleOnClick}>\n\t\t\t\t\t<span className={styles.MrlToolbarButtonIcon}>{icon}</span>\n\t\t\t\t\t{text}\n\t\t\t\t</MrlMenuItem>\n\t\t\t);\n\t\t}\n\n\t\treturn (\n\t\t\t<MrlIconButton\n\t\t\t\t{...rest}\n\t\t\t\t{...toolbarButtonProps}\n\t\t\t\tclassName={classes}\n\t\t\t\tdata-qa={qa}\n\t\t\t\tdata-roving={includeInRoving ? 'true' : undefined}\n\t\t\t\ticon={icon}\n\t\t\t\tonClick={handleOnClick}\n\t\t\t\tref={ref}\n\t\t\t\ttext={text}\n\t\t\t/>\n\t\t);\n\t}\n);\n"],"names":["MrlToolbarButton","React","forwardRef","props","ref","className","icon","_props$includeInRovin","includeInRoving","menuItemProps","onClick","qa","renderInMenu","text","_props$toolbarButtonP","toolbarButtonProps","position","size","state","eventId","rest","_objectWithoutProperties","_excluded","classes","classnames","trackInteraction","useMrlTrackInteraction","handleOnClick","e","action","variant","createElement","MrlMenuItem","_extends","styles","MrlToolbarButtonIcon","MrlIconButton","undefined"],"mappings":";;;;;;;;;;AAQA;AACA;AACA;;AAuDA;AACA;AACA;AACA;AACA;AACO,IAAMA,gBAAgB,gBAAGC,KAAK,CAACC,UAAU,CAC/C,SAASF,gBAAgBA,CAACG,KAAK,EAAEC,GAAG,EAAe;AAClD,EAAA,IACCC,SAAS,GAiBNF,KAAK,CAjBRE,SAAS;IACTC,IAAI,GAgBDH,KAAK,CAhBRG,IAAI;IAAAC,qBAAA,GAgBDJ,KAAK,CAfRK,eAAe;AAAfA,IAAAA,eAAe,GAAAD,qBAAA,KAAA,MAAA,GAAG,KAAK,GAAAA,qBAAA;IACvBE,aAAa,GAcVN,KAAK,CAdRM,aAAa;IACbC,OAAO,GAaJP,KAAK,CAbRO,OAAO;IACPC,EAAE,GAYCR,KAAK,CAZRQ,EAAE;IACFC,YAAY,GAWTT,KAAK,CAXRS,YAAY;IACZC,IAAI,GAUDV,KAAK,CAVRU,IAAI;IAAAC,qBAAA,GAUDX,KAAK,CATRY,kBAAkB;IAAlBA,kBAAkB,GAAAD,qBAAA,KAAA,MAAA,GAAG;AACpBE,MAAAA,QAAQ,EAAE,QAAQ;AAClBC,MAAAA,IAAI,EAAE,OAAO;AACbC,MAAAA,KAAK,EAAE;AACR,KAAC,GAAAJ,qBAAA;IAGDK,OAAO,GAEJhB,KAAK,CAFRgB,OAAO;AACJC,IAAAA,IAAI,GAAAC,wBAAA,CACJlB,KAAK,EAAAmB,SAAA,CAAA;AACT,EAAA,IAAMC,OAAO,GAAGC,UAAU,CAAC,kBAAkB,EAAEnB,SAAS,CAAC;AAEzD,EAAA,IAAMoB,gBAAgB,GAAGC,sBAAsB,CAAC,kBAAkB,EAAEP,OAAO,CAAC;;AAE5E;AACF;AACA;AACA;AACA;EACE,IAAMQ,aAAa,GAAIC,CAAuC,IAAK;AAClEH,IAAAA,gBAAgB,CAAC;AAChBI,MAAAA,MAAM,EAAE,OAAO;AACfC,MAAAA,OAAO,EAAElB,YAAY,GAAG,MAAM,GAAG;AAClC,KAAC,CAAC;AAEFF,IAAAA,OAAO,aAAPA,OAAO,KAAA,MAAA,GAAA,MAAA,GAAPA,OAAO,CAAGkB,CAAC,CAAC;EACb,CAAC;AAED,EAAA,IAAIhB,YAAY,EAAE;IACjB,oBACCX,KAAA,CAAA8B,aAAA,CAACC,WAAW,EAAAC,QAAA,KAAKxB,aAAa,EAAA;AAAEJ,MAAAA,SAAS,EAAEkB,OAAQ;AAAC,MAAA,SAAA,EAASZ,EAAG;AAACD,MAAAA,OAAO,EAAEiB;KAAc,CAAA,eACvF1B,KAAA,CAAA8B,aAAA,CAAA,MAAA,EAAA;MAAM1B,SAAS,EAAE6B,MAAM,CAACC;AAAqB,KAAA,EAAE7B,IAAW,CAAC,EAC1DO,IACW,CAAC;AAEhB,EAAA;EAEA,oBACCZ,KAAA,CAAA8B,aAAA,CAACK,aAAa,EAAAH,QAAA,CAAA,EAAA,EACTb,IAAI,EACJL,kBAAkB,EAAA;AACtBV,IAAAA,SAAS,EAAEkB,OAAQ;AACnB,IAAA,SAAA,EAASZ,EAAG;AACZ,IAAA,aAAA,EAAaH,eAAe,GAAG,MAAM,GAAG6B,SAAU;AAClD/B,IAAAA,IAAI,EAAEA,IAAK;AACXI,IAAAA,OAAO,EAAEiB,aAAc;AACvBvB,IAAAA,GAAG,EAAEA,GAAI;AACTS,IAAAA,IAAI,EAAEA;AAAK,GAAA,CACX,CAAC;AAEJ,CACD;;;;"}
@@ -1,4 +1,4 @@
1
- var TOOLKIT_VERSION = "4.79.1";
1
+ var TOOLKIT_VERSION = "4.80.0";
2
2
 
3
3
  export { TOOLKIT_VERSION };
4
4
  //# sourceMappingURL=version.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"version.js","sources":["../../src/version.ts"],"sourcesContent":["export const TOOLKIT_VERSION = \"4.79.1\";"],"names":["TOOLKIT_VERSION"],"mappings":"AAAO,IAAMA,eAAe,GAAG;;;;"}
1
+ {"version":3,"file":"version.js","sources":["../../src/version.ts"],"sourcesContent":["export const TOOLKIT_VERSION = \"4.80.0\";"],"names":["TOOLKIT_VERSION"],"mappings":"AAAO,IAAMA,eAAe,GAAG;;;;"}
@@ -7,14 +7,22 @@ interface avatarDefaults {
7
7
  avatarColor: string;
8
8
  }
9
9
  export interface MrlAvatarPropTypes {
10
+ /** Alt text when `image` is a URL. Defaults to "<name>'s avatar", or "Participant avatar" without a name. */
10
11
  alt?: string;
11
12
  dataQa?: string;
13
+ /** Image shown instead of the initials: a URL rendered as an `img`, or a custom element. */
12
14
  image?: React.ReactNode | string;
15
+ /** Badge shown on the corner of small and xsmall avatars: a facilitator badge or a lock icon. Also draws the border in `avatarColor`. */
13
16
  kind?: AvatarKind;
17
+ /** Name of the person. Used for the initials when there is no image, and set as `aria-label` on the avatar content. */
14
18
  name?: string;
19
+ /** Called when the `image` URL fails to load. */
15
20
  onImageError?: React.ReactEventHandler<HTMLImageElement>;
21
+ /** Draws a border in `avatarColor` around the avatar. */
16
22
  showBorder?: boolean;
23
+ /** Size of the avatar. xsmall shows one initial, the other sizes up to two. */
17
24
  size?: AvatarSize;
25
+ /** Color of the person as hex, rgb or rgba, used to tint the avatar. */
18
26
  avatarColor?: string;
19
27
  }
20
28
  declare const avatarValues: {
@@ -8,12 +8,14 @@ export interface MrlBadgeProps extends Omit<MrlComponentProps, 'style' | 'attrs'
8
8
  * Should be passed as an MrlSvg JSX Element.
9
9
  */
10
10
  icon?: JSX.Element;
11
+ /** Visual variant of the badge. Also picks the default icon shown with `showIcon`. */
11
12
  kind?: MrlBadgeKinds;
12
13
  /**
13
14
  * Displays a default icon for non-default badge kinds.
14
15
  * To have an icon in `kind="default"` you must use the `icon` prop.
15
16
  */
16
17
  showIcon?: boolean;
18
+ /** Text displayed inside the badge. */
17
19
  text: string;
18
20
  }
19
21
  /**
@@ -3,6 +3,7 @@ import { MrlComponentProps } from '../../../utils';
3
3
  export type MrlBadgeNotificationKinds = 'general' | 'info';
4
4
  export interface MrlBadgeNotificationProps extends Omit<MrlComponentProps, 'style' | 'attrs'>, React.ComponentProps<'div'> {
5
5
  className?: string;
6
+ /** Visual variant of the notification badge. */
6
7
  kind?: MrlBadgeNotificationKinds;
7
8
  /**
8
9
  * A string of text to tell screen reader users what type of notification this is.
@@ -3,6 +3,7 @@ import { MrlSvgAnimateProps } from '../../svg/MrlSvgAnimate/MrlSvgAnimate';
3
3
  import { MrlIconButtonProps } from '../MrlIconButton/MrlIconButton';
4
4
  import './MrlAnimatedIconButton.scss';
5
5
  interface MrlAnimatedIconButtonProps extends Omit<MrlIconButtonProps, 'icon'> {
6
+ /** Props of the animated icon to render. */
6
7
  icon: MrlSvgAnimateProps;
7
8
  }
8
9
  export declare const MrlAnimatedIconButton: React.ForwardRefExoticComponent<Omit<MrlAnimatedIconButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
@@ -9,17 +9,26 @@ interface MrlCalloutCTA {
9
9
  export interface MrlCalloutProps extends MrlCalloutPopoverProps {
10
10
  /** a unique id that binds the callout content and the trigger for assistive technologies */
11
11
  ariaControls?: string;
12
+ /** Has no effect (passed to the popover container, which ignores it). Focus on open is handled by the popover; see `disableFocusTrap`. Kept for backwards compatibility. */
12
13
  autoFocus?: boolean;
13
14
  children: React.ReactElement;
14
15
  disableClickOutside?: boolean;
16
+ /** Body text of the callout. A string renders as MrlText; pass an element for rich content. */
15
17
  description?: string | JSX.Element;
18
+ /** Short label rendered above the title. */
16
19
  eyebrow?: string;
17
20
  id?: string;
21
+ /** Illustration rendered between the description and the actions. */
18
22
  image?: JSX.Element;
23
+ /** Has no effect. Kept for backwards compatibility. The callout renders in the callout portal layer unless `portalProps` is overridden. */
19
24
  renderWithPortal?: boolean;
25
+ /** Whether the callout is open. The consumer controls visibility; the trigger child gets `aria-expanded` from it. */
20
26
  show: boolean;
27
+ /** Heading of the callout, rendered as a level 2 heading. */
21
28
  title?: string;
29
+ /** Primary action button rendered at the bottom of the callout. */
22
30
  primaryCta?: MrlCalloutCTA;
31
+ /** Secondary action button rendered before the primary one. */
23
32
  secondaryCta?: MrlCalloutCTA;
24
33
  /**
25
34
  * Enables interaction tracking for this callout. Provide a stable, non-PII id
@@ -1,7 +1,11 @@
1
1
  interface MrlEmptyProps {
2
+ /** Icon or illustration shown above the heading. */
2
3
  graphic?: JSX.Element;
4
+ /** Heading of the empty state. */
3
5
  heading: string;
6
+ /** Text shown under the heading. */
4
7
  description: string;
8
+ /** Call to action, usually a button, shown below the description. */
5
9
  action?: JSX.Element;
6
10
  }
7
11
  /**
@@ -1,7 +1,11 @@
1
1
  interface MrlEmptyLargeProps {
2
+ /** Icon or illustration shown above the heading. */
2
3
  graphic?: JSX.Element;
4
+ /** Heading of the empty state. */
3
5
  heading: string;
6
+ /** Text shown under the heading. */
4
7
  description: string;
8
+ /** Call to action, usually a button, shown below the description. */
5
9
  action?: JSX.Element;
6
10
  }
7
11
  /**
@@ -4,6 +4,7 @@ import { DataQa } from '../../../utils/dataQa';
4
4
  export interface MrlDatePickerProps extends React.ComponentPropsWithRef<'input'>, DataQa {
5
5
  /** Id of the text input */
6
6
  inputId: string;
7
+ /** Visual variant. 'borderless' hides the border and uses a subtle filled background. */
7
8
  kind?: 'default' | 'borderless';
8
9
  /** The value of the text input used to make it a controlled input */
9
10
  value?: string;
@@ -11,6 +12,7 @@ export interface MrlDatePickerProps extends React.ComponentPropsWithRef<'input'>
11
12
  * Changes the state of the input based on user permissions or actions.
12
13
  */
13
14
  state?: InputStates;
15
+ /** Focuses the input when it mounts. */
14
16
  autofocus?: boolean;
15
17
  /**
16
18
  * Event handler for onChange Events
@@ -2,8 +2,11 @@ import { CreatableProps } from 'react-select/creatable';
2
2
  import { GroupBase } from 'react-select';
3
3
  import { SelectKind } from '../types';
4
4
  export interface MrlCreatableSelectProps<Option, IsMulti extends boolean = false, Group extends GroupBase<Option> = GroupBase<Option>> extends CreatableProps<Option, IsMulti, Group> {
5
+ /** Applies the error styling and sets `aria-invalid`. Render the error message outside the select. */
5
6
  hasError?: boolean;
7
+ /** Makes the select read-only: the menu never opens and values cannot be removed. */
6
8
  isReadOnly?: boolean;
9
+ /** Visual variant. The inline kinds have no border unless `hasError` is set. */
7
10
  kind?: SelectKind;
8
11
  /**
9
12
  * The data-qa prefix, it will be used to add data-qa attributes to different sub components of the MrlCreatableSelect component.
@@ -13,6 +16,7 @@ export interface MrlCreatableSelectProps<Option, IsMulti extends boolean = false
13
16
  * - value-container, <data-qa-prefix>-value-container
14
17
  */
15
18
  ['data-qa']?: string;
19
+ /** Shows the clear indicator of a clearable select. Hidden by default. */
16
20
  showClearIndicatorIcon?: boolean;
17
21
  /**
18
22
  * Enables interaction tracking for this select. Provide a stable, non-PII id
@@ -2,8 +2,11 @@ import { CreatableProps } from 'react-select/creatable';
2
2
  import { GroupBase } from 'react-select';
3
3
  import { DefaultOption, SelectKind } from '../types';
4
4
  export interface MrlMultiCreatableSelectProps<Option, IsMulti extends boolean = true, Group extends GroupBase<Option> = GroupBase<Option>> extends CreatableProps<Option, IsMulti, Group> {
5
+ /** Applies the error styling and sets `aria-invalid`. Render the error message outside the select. */
5
6
  hasError?: boolean;
7
+ /** Keeps the menu closed and turns off Backspace removal. Values can still be removed with their remove buttons. */
6
8
  isReadOnly?: boolean;
9
+ /** Visual variant. The inline kinds have no border unless `hasError` is set. */
7
10
  kind?: SelectKind;
8
11
  /**
9
12
  * The data-qa prefix, it will be used to add data-qa attributes to different sub components of the MrlMultiCreatableSelect component.
@@ -13,6 +16,7 @@ export interface MrlMultiCreatableSelectProps<Option, IsMulti extends boolean =
13
16
  * - value-container, <data-qa-prefix>-value-container
14
17
  */
15
18
  ['data-qa']?: string;
19
+ /** Shows the clear indicator of a clearable select. Hidden by default. */
16
20
  showClearIndicatorIcon?: boolean;
17
21
  /**
18
22
  * Enables interaction tracking for this select. Provide a stable, non-PII id
@@ -1,8 +1,11 @@
1
1
  import { GroupBase, Props } from 'react-select';
2
2
  import { DefaultOption, SelectKind } from '../types';
3
3
  export interface MrlMultiSelectProps<T, IsMulti extends boolean = false, Group extends GroupBase<T> = GroupBase<T>> extends Omit<Props<T, IsMulti, Group>, 'isMulti' | 'hideSelectedOptions'> {
4
+ /** Applies the error styling and sets `aria-invalid`. Render the error message outside the select. */
4
5
  hasError?: boolean;
6
+ /** Keeps the menu closed and renders values as text without remove buttons. */
5
7
  isReadOnly?: boolean;
8
+ /** Visual variant. The inline kinds have no border unless `hasError` is set. */
6
9
  kind?: SelectKind;
7
10
  /**
8
11
  * The data-qa prefix, it will be used to add data-qa attributes to different sub components of the MrlMultiSelect component.
@@ -1,8 +1,11 @@
1
1
  import { GroupBase, Props } from 'react-select';
2
2
  import { SelectKind } from '../types';
3
3
  export interface MrlSelectProps<Option, IsMulti extends boolean = false, Group extends GroupBase<Option> = GroupBase<Option>> extends Props<Option, IsMulti, Group> {
4
+ /** Applies the error styling and sets `aria-invalid`. Render the error message outside the select. */
4
5
  hasError?: boolean;
6
+ /** Makes the select read-only: the menu never opens and values cannot be removed. */
5
7
  isReadOnly?: boolean;
8
+ /** Visual variant. The inline kinds have no border unless `hasError` is set. */
6
9
  kind?: SelectKind;
7
10
  /**
8
11
  * The data-qa prefix, it will be used to add data-qa attributes to different sub components of the MrlSelect component.
@@ -1,6 +1,7 @@
1
1
  import * as React from 'react';
2
2
  interface MrlSwitchProps extends React.ComponentPropsWithoutRef<'input'> {
3
3
  className?: string;
4
+ /** Disables the switch. */
4
5
  disabled?: boolean;
5
6
  id?: string;
6
7
  /**
@@ -13,7 +14,9 @@ interface MrlSwitchProps extends React.ComponentPropsWithoutRef<'input'> {
13
14
  * If you need custom styles, you can use `className` or use a span that you style as `label`
14
15
  */
15
16
  label: string | React.ReactNode;
17
+ /** Called with the change event when the switch is toggled. */
16
18
  onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
19
+ /** Whether the switch is on. Syncs when this value changes; the switch also toggles itself on click. */
17
20
  selected?: boolean;
18
21
  }
19
22
  export declare const MrlSwitch: React.MemoExoticComponent<({ className, disabled, id, label, onChange, selected, eventId, ...rest }: MrlSwitchProps) => React.JSX.Element>;
@@ -22,9 +22,12 @@ interface MrlEditableTextInputProps extends React.InputHTMLAttributes<HTMLInputE
22
22
  * Changes the state of the input based on user permissions or actions.
23
23
  */
24
24
  state?: InputStates;
25
+ /** Error shown under the field when `state` is 'error'. */
25
26
  error?: MrlFormInputError;
26
27
  'data-qa': string;
28
+ /** Whether the field is in edit mode. Omit to let the component manage it; pair with `setIsEditable` to control it. */
27
29
  isEditable?: boolean;
30
+ /** Called when the field wants to enter or leave edit mode. Required when `isEditable` is controlled. */
28
31
  setIsEditable?: (isEditableUpdate: boolean) => void;
29
32
  /**
30
33
  * Show icon on hover, if true the icon will be hidden and show on hover and focus
@@ -29,8 +29,11 @@ interface MrlEditableTextareaProps extends React.TextareaHTMLAttributes<HTMLText
29
29
  /** Additional class to add to the textarea */
30
30
  className?: string;
31
31
  'data-qa': string;
32
+ /** Error shown under the field when `state` is 'error'. */
32
33
  error?: MrlFormInputError;
34
+ /** Whether the field is in edit mode. Omit to let the component manage it; pair with `setIsEditable` to control it. */
33
35
  isEditable?: boolean;
36
+ /** Called when the field wants to enter or leave edit mode. Required when `isEditable` is controlled. */
34
37
  setIsEditable?: (isEditableUpdate: boolean) => void;
35
38
  /** Autoexpand will automatically adjust the height of the textarea based on the amount of text within it */
36
39
  autoExpand?: boolean;
@@ -35,12 +35,33 @@ type GridClassConfig = {
35
35
  */
36
36
  type ColumnConfig = NumCols | 'auto' | GridClassConfig | undefined;
37
37
  export interface GridColumns {
38
+ /**
39
+ * Columns that are the same from the smallest of devices to the largest.
40
+ */
38
41
  col?: ColumnConfig;
42
+ /**
43
+ * @deprecated xs maps to col. Bootstrap grid removed xs in favor of col.
44
+ */
39
45
  xs?: ColumnConfig;
46
+ /**
47
+ * The number of columns to span from the sm breakpoint up.
48
+ */
40
49
  sm?: ColumnConfig;
50
+ /**
51
+ * The number of columns to span from the md breakpoint up.
52
+ */
41
53
  md?: ColumnConfig;
54
+ /**
55
+ * The number of columns to span from the lg breakpoint up.
56
+ */
42
57
  lg?: ColumnConfig;
58
+ /**
59
+ * The number of columns to span from the xl breakpoint up.
60
+ */
43
61
  xl?: ColumnConfig;
62
+ /**
63
+ * The number of columns to span from the xxl breakpoint up.
64
+ */
44
65
  xxl?: ColumnConfig;
45
66
  }
46
67
  /**
@@ -4,7 +4,9 @@ export type MrlSidebarHookInfo = {
4
4
  source: 'userInteraction' | 'imperativeHandler';
5
5
  };
6
6
  interface MrlSidebarHook {
7
+ /** Called on every close request, even if the sidebar is already closed. `info.source` tells whether a user or the imperative handle made it. */
7
8
  hookClose?: (info: MrlSidebarHookInfo) => void;
9
+ /** Called on every open request, even if the sidebar is already open. `info.source` tells whether a user or the imperative handle made it. */
8
10
  hookOpen?: (info: MrlSidebarHookInfo) => void;
9
11
  }
10
12
  interface MrlSidebarAnalytics {
@@ -1,12 +1,18 @@
1
1
  import * as React from 'react';
2
2
  type AriaRelevant = 'additions' | 'all' | 'removals' | 'text' | 'additions text' | undefined;
3
3
  export interface MrlLiveRegionProps extends React.HTMLAttributes<HTMLParagraphElement> {
4
+ /** Sets `aria-atomic`: announce the whole region on every change instead of only the changed part. */
4
5
  ariaAtomic?: boolean;
6
+ /** Sets `aria-live`: how urgently screen readers announce changes. */
5
7
  ariaLive: 'polite' | 'assertive' | 'off';
8
+ /** Sets `aria-relevant`: which kinds of change are announced. */
6
9
  ariaRelevant?: AriaRelevant;
7
10
  id?: string;
11
+ /** Empties the region one second after `srContent` changes. */
8
12
  shouldClearContent?: boolean;
13
+ /** Text announced by the live region. */
9
14
  srContent: string;
15
+ /** Shows the text on screen. By default the region is visually hidden. */
10
16
  visible?: boolean;
11
17
  }
12
18
  /**
@@ -47,15 +47,23 @@ export interface MrlToastProps {
47
47
  * The time in milliseconds after which the toast notification should automatically close.
48
48
  */
49
49
  closeAfterMs?: number;
50
+ /** Visual variant of the toast. Also picks its default icon. */
50
51
  kind?: MrlToastKind;
52
+ /** Link rendered after the messages. */
51
53
  link?: MrlToastLink;
54
+ /** Called when the toast closes, through the close button or auto-close. */
52
55
  onClose?: () => void;
56
+ /** Primary action button. */
53
57
  primaryCTA?: MrlToastCTA;
58
+ /** Main message of the toast. */
54
59
  primaryMessage: string | JSX.Element;
60
+ /** Secondary action button, rendered before the primary one. */
55
61
  secondaryCTA?: MrlToastCTA;
62
+ /** Supporting message rendered after the primary one. */
56
63
  secondaryMessage?: string | JSX.Element;
57
64
  /** Determines whether the close icon button should be shown. */
58
65
  showCloseButton?: boolean;
66
+ /** Shows the icon of the `kind` before the message. Ignored when an `avatar` is shown. */
59
67
  showIcon?: boolean;
60
68
  /**
61
69
  * Enables interaction tracking for this toast. Provide a stable, non-PII id
@@ -7,6 +7,7 @@ interface MrlPaginationButtonProps {
7
7
  buttonClass?: string;
8
8
  /** Additional class to add to the container element */
9
9
  className?: string;
10
+ /** Disables the button. */
10
11
  disabled?: boolean;
11
12
  /**
12
13
  * The type of pagination item.
@@ -6,6 +6,7 @@ export interface PortalProps extends React.HTMLAttributes<HTMLDivElement> {
6
6
  className?: string;
7
7
  ['data-qa']?: string;
8
8
  id?: string;
9
+ /** Stacking layer from `PORTAL_LAYERS`. Its name is used as the container id (over `id`) and its z-index is applied to the container's first child. Without it, the container is `id` or the root portal, with the root z-index. */
9
10
  layer?: PortalLayer;
10
11
  }
11
12
  export declare const MRL_PORTAL_ID: "mrl-root-portal";
@@ -9,6 +9,7 @@ type RefType = HTMLElement | HTMLDivElement | null;
9
9
  export declare const getTabbableElements: (ref: RefType, selector: string) => HTMLElement[];
10
10
  export type FocusOnInitPosition = 'first' | 'last';
11
11
  export interface RovingPropTypes {
12
+ /** CSS selector of the element that starts as the tab stop, for example a checked custom radio. Falls back to `[data-roving-active]`, then to the first `[data-roving]` element. */
12
13
  activeSelector?: string;
13
14
  /**
14
15
  * If true, disabled elements (with disabled attribute or aria-disabled="true")
@@ -23,14 +24,23 @@ export interface RovingPropTypes {
23
24
  * rendered by the time the componentDidMount function is triggered
24
25
  */
25
26
  delayMount?: number;
27
+ /** Moves focus to the first or last element when the component mounts (after `delayMount`, if set). */
26
28
  focusOnInit?: FocusOnInitPosition;
29
+ /** Keeps every element out of the tab order until `isFocused` becomes true. For groups reached through a keyboard shortcut instead of Tab. */
27
30
  focusWithShortcut?: boolean;
31
+ /** Has no effect. Kept for backwards compatibility. */
28
32
  forceUpdate?: boolean;
33
+ /** Set when another roving tabindex is nested inside this one, so its elements are left to the inner instance. */
29
34
  hasChildRoving?: boolean;
35
+ /** CSS selector. Keyboard navigation is ignored while focus is inside a matching element, for example a text input. */
30
36
  ignoreElements?: string;
37
+ /** With `focusWithShortcut`, whether the group holds focus. Turning it on focuses the active element; turning it off removes the group from the tab order. */
31
38
  isFocused?: boolean;
39
+ /** Called when focus moves from the group to another element outside it. With `focusWithShortcut`, also called when `isFocused` turns off while focus is outside the group. */
32
40
  onBlur?: () => void;
41
+ /** Pass it after moving focus into the group programmatically. On the next update the focused element becomes the tab stop and the callback receives `false`, so the consumer can drop it. */
33
42
  onRefocus?: (shouldRefocus: boolean) => void;
43
+ /** Axis of the group, read once at mount. Every arrow key moves focus, but the keys across the axis are left to a focused element with `aria-haspopup="true"` or role combobox, listbox or option. Defaults to horizontal. */
34
44
  orientation?: RovingOrientation;
35
45
  qa?: string;
36
46
  }
@@ -13,6 +13,7 @@ export interface SvgPropTypes extends Omit<MrlComponentProps, 'style'>, Omit<Rea
13
13
  path?: string;
14
14
  /** Enable lazy loading when a path is provided. */
15
15
  lazyLoad?: boolean;
16
+ /** Renders an empty span instead of the SVG. */
16
17
  isClone?: boolean;
17
18
  /** The size of an SVG Component */
18
19
  size?: SVGSize;
@@ -13,8 +13,11 @@ export interface MrlTableCellProps extends React.ComponentPropsWithoutRef<'td'>
13
13
  * Whether this cell is sticky 'left' or sticky 'right' or not sticky at all
14
14
  */
15
15
  sticky?: MrlTableColumnSticky;
16
+ /** Draws the scroll shadow on a cell that is sticky 'left'. Set it while the content is scrolled away from the left edge. */
16
17
  hasScrollShadowLeft?: boolean;
18
+ /** Draws the scroll shadow on a cell that is sticky 'right'. Set it while more columns remain to the right. */
17
19
  hasScrollShadowRight?: boolean;
20
+ /** Horizontal alignment of the cell content. */
18
21
  horizontalAlign?: MrlTableCellHorizontalAlign;
19
22
  }
20
23
  /**
@@ -13,8 +13,11 @@ export interface MrlTableColumnProps extends React.ComponentPropsWithoutRef<'th'
13
13
  * Whether this column is sticky 'left' or sticky 'right' or not sticky at all
14
14
  */
15
15
  sticky?: MrlTableColumnSticky;
16
+ /** Draws the scroll shadow on a header cell that is sticky 'left'. Set it while the content is scrolled away from the left edge. */
16
17
  hasScrollShadowLeft?: boolean;
18
+ /** Draws the scroll shadow on a header cell that is sticky 'right'. Set it while more columns remain to the right. */
17
19
  hasScrollShadowRight?: boolean;
20
+ /** Horizontal alignment of the header cell content. */
18
21
  horizontalAlign?: MrlTableCellHorizontalAlign;
19
22
  }
20
23
  /**
@@ -2,6 +2,7 @@ import * as React from 'react';
2
2
  export interface MrlTabProps extends React.ComponentProps<'button'> {
3
3
  /** Class to be applied to the button element of the MrlTab */
4
4
  className?: string;
5
+ /** Icon rendered before the tab text. */
5
6
  icon?: React.ReactElement;
6
7
  /**
7
8
  * The id that will be passed to the MrlTabContext to set the active state.
@@ -10,6 +11,7 @@ export interface MrlTabProps extends React.ComponentProps<'button'> {
10
11
  id: string;
11
12
  /** An addition function to call when clicking on a tab */
12
13
  hookClick?: () => void;
14
+ /** Label of the tab. */
13
15
  text: string;
14
16
  /**
15
17
  * Enables interaction tracking for this tab. Provide a stable, non-PII id
@@ -3,6 +3,7 @@ export interface MrlTabGroupPropTypes {
3
3
  children: React.ReactNode;
4
4
  /** Class to be applied to the container element of the MrlTabGroup */
5
5
  className?: string;
6
+ /** Hides the previous and next buttons that page through tabs overflowing the container. */
6
7
  disablePageControls?: boolean;
7
8
  /** A hidden label for the tab group for accessiblity purposes */
8
9
  label?: string;
@@ -5,6 +5,7 @@ export interface MrlTabLinkProps extends NavLinkProps {
5
5
  className?: string;
6
6
  /** Children to be rendered within the text component */
7
7
  children?: React.ReactNode;
8
+ /** Icon rendered before the tab text. */
8
9
  icon?: React.ReactElement;
9
10
  /**
10
11
  * The id that will be passed to the MrlTabContext to set the active state.
@@ -9,7 +9,9 @@ export interface MrlTabsPropTypes {
9
9
  className?: string;
10
10
  /** Sets the default active tab by id */
11
11
  selectedTab?: string;
12
+ /** Size of the tabs. */
12
13
  size?: MrlTabSize;
14
+ /** Stretches the tabs so they share the row width equally. */
13
15
  spaceTabsEvenly?: boolean;
14
16
  }
15
17
  export declare const MrlTabs: React.FC<MrlTabsPropTypes>;
@@ -26,6 +26,7 @@ interface MrlTextHeadingProps extends React.ComponentPropsWithRef<'h1'>, DataQa
26
26
  * Note: hierarchy only impacts MrlTextHeading components with `kind="title"`
27
27
  */
28
28
  hierarchy?: HeadingHierarchies;
29
+ /** Text of the heading. Takes precedence over `children`. */
29
30
  text?: string;
30
31
  }
31
32
  /**
@@ -6,19 +6,24 @@ import { MrlMenuProps } from '../../menu/MrlMenu/MrlMenu';
6
6
  */
7
7
  export interface MrlToolbarProps extends React.ComponentPropsWithRef<'div'> {
8
8
  children?: React.ReactNode;
9
+ /** Visual variant. 'inverse' uses the dark inverse background; 'skeleton' renders a blank placeholder whose length is estimated from the number of items. */
9
10
  kind?: 'default' | 'inverse' | 'skeleton';
10
11
  /**
11
12
  * An optional prop to apply an aria-label to the MrlToobar
12
13
  */
13
14
  label?: string;
15
+ /** Has no effect. Kept for backwards compatibility. */
14
16
  lastToolbarInRow?: boolean;
15
17
  /**
16
18
  * An optional prop to set the maximum number of visible items in a toolbar.
17
19
  * Additional items will appear in a menu.
18
20
  */
19
21
  maxVisibleItems?: number;
22
+ /** Props of the icon button that opens the overflow menu. Replaces the defaults (text "More tools", ghost, small) entirely, so include `text`. */
20
23
  menuButtonProps?: MrlIconButtonProps;
24
+ /** Props of the overflow menu that holds the items beyond `maxVisibleItems`. Replaces the default menu props entirely. */
21
25
  menuProps?: MrlMenuProps;
26
+ /** Direction in which the items are laid out. Defaults to horizontal. */
22
27
  orientation?: 'horizontal' | 'vertical';
23
28
  /**
24
29
  * A boolean prop that sets RovingTabindex in the MrlToolbar
@@ -28,6 +33,13 @@ export interface MrlToolbarProps extends React.ComponentPropsWithRef<'div'> {
28
33
  * Sets the size of the toolbar - defaults to 'small'
29
34
  */
30
35
  size?: 'xsmall' | 'small' | 'medium';
36
+ /**
37
+ * Spaced toolbars provide more space between elements. This is
38
+ * meant to be used for toolbars that have "bigger" elements inside
39
+ * (i.e. long title, ToolbarButtonAdapters, etc).
40
+ *
41
+ * Currently used for all secondary toolbars.
42
+ */
31
43
  spaced?: boolean;
32
44
  }
33
45
  /**
@@ -11,6 +11,7 @@ export interface MrlToolbarButtonProps {
11
11
  * The icon that will be rendered.
12
12
  */
13
13
  icon: React.ReactElement;
14
+ /** Adds the button to the toolbar's roving tabindex (see `shouldUseRti`). */
14
15
  includeInRoving?: boolean;
15
16
  /**
16
17
  * A prop used to set a toolbar button to never move into the menu.
@@ -29,6 +30,7 @@ export interface MrlToolbarButtonProps {
29
30
  * A prop used to render the item in the menu instead of the toolbar.
30
31
  */
31
32
  renderInMenu?: boolean;
33
+ /** Accessible label of the button. Also its tooltip and its text when it moves into the menu. */
32
34
  text: string;
33
35
  /**
34
36
  * Enables interaction tracking for this button. Provide a stable, non-PII id
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@muraldevkit/ui-toolkit",
3
- "version": "4.79.1",
3
+ "version": "4.80.0",
4
4
  "description": "Mural's UI Toolkit",
5
5
  "main": "./dist/cjs/index.js",
6
6
  "module": "./dist/esm/index.js",