@brightspace-ui/core 1.197.0 → 1.197.4

package/components/overflow-group/overflow-group.js

@@ -111,9 +111,7 @@ function convertToDropdownItem(node) {
 }
 /**
  *
- * A component that can be used to display a set of buttons, links or menus that will be put into a
- * dropdown menu when they no longer fit on the first line of their container
- *
+ * A component that can be used to display a set of buttons, links or menus that will be put into a dropdown menu when they no longer fit on the first line of their container
  * @slot - Buttons, dropdown buttons, links or other items to be added to the container
  * @fires d2l-overflow-group-updated - Dispatched when there is an update performed to the overflow group
 */
@@ -123,6 +121,7 @@ class OverflowGroup extends RtlMixin(LocalizeCoreElement(LitElement)) {
 		return {
 			/**
 			 * Use predefined classes on slot elements to set min and max buttons to show
+			 * @type {boolean}
 			 */
 			autoShow: {
 				type: Boolean,
@@ -130,6 +129,7 @@ class OverflowGroup extends RtlMixin(LocalizeCoreElement(LitElement)) {
 			},
 			/**
 			 * minimum amount of buttons to show
+			 * @type {number}
 			 */
 			minToShow: {
 				type: Number,
@@ -138,6 +138,7 @@ class OverflowGroup extends RtlMixin(LocalizeCoreElement(LitElement)) {
 			},
 			/**
 			 * maximum amount of buttons to show
+			 * @type {number}
 			 */
 			maxToShow: {
 				type: Number,

package/components/scroll-wrapper/scroll-wrapper.js

@@ -12,7 +12,6 @@ const SCROLL_AMOUNT = 0.8;
 /**
  *
  * Wraps content which may overflow its horizontal boundaries, providing left/right scroll buttons.
- *
  * @slot - User provided content to wrap
  */
 class ScrollWrapper extends FocusVisiblePolyfillMixin(RtlMixin(LitElement)) {
@@ -54,7 +53,7 @@ class ScrollWrapper extends FocusVisiblePolyfillMixin(RtlMixin(LitElement)) {
 			:host([hidden]) {
 				display: none;
 			}
-			
+
 			.d2l-scroll-wrapper-container {
 				box-sizing: border-box;
 				outline: none;

package/components/selection/selection-action.js

@@ -12,6 +12,7 @@ import { SelectionObserverMixin } from './selection-observer-mixin.js';
 /**
  * An action associated with a selection component.
  * @fires d2l-selection-action-click - Dispatched when the user clicks the action; provides the selection info
+ * @fires d2l-selection-observer-subscribe - Internal event
  */
 class Action extends LocalizeCoreElement(SelectionObserverMixin(ButtonMixin(RtlMixin(LitElement)))) {
 
@@ -19,14 +20,17 @@ class Action extends LocalizeCoreElement(SelectionObserverMixin(ButtonMixin(RtlM
 		return {
 			/**
 			 * Preset icon key (e.g. "tier1:gear")
+			 * @type {string}
 			 */
 			icon: { type: String, reflect: true },
 			/**
 			 * Whether the action requires one or more selected items
+			 * @type {boolean}
 			 */
 			requiresSelection: { type: Boolean, attribute: 'requires-selection', reflect: true },
 			/**
 			 * REQUIRED: The text for the action
+			 * @type {string}
 			 */
 			text: { type: String, reflect: true }
 		};

package/components/selection/selection-input.js

@@ -13,6 +13,7 @@ const keyCodes = {
 /**
  * An input (radio or checkbox) for use in selection components such as lists and tables.
  * @fires d2l-selection-change - Dispatched when the selected state changes
+ * @fires d2l-selection-input-subscribe - Internal event
  */
 class Input extends SkeletonMixin(LabelledMixin(LitElement)) {
 
@@ -20,18 +21,22 @@ class Input extends SkeletonMixin(LabelledMixin(LitElement)) {
 		return {
 			/**
 			 * State of the input
+			 * @type {boolean}
 			 */
 			selected: { type: Boolean },
 			/**
 			 * Disables the input
+			 * @type {boolean}
 			 */
 			disabled: { type: Boolean },
 			/**
 			 * Private. Force hovering state of input
+			 * @type {boolean}
 			 */
 			hovering: { type: Boolean },
 			/**
 			 * Key for the selectable
+			 * @type {string}
 			 */
 			key: { type: String },
 			_indeterminate: { type: Boolean },

package/components/selection/selection-mixin.js

@@ -39,7 +39,8 @@ export const SelectionMixin = superclass => class extends RtlMixin(superclass) {
 	static get properties() {
 		return {
 			/**
-			 * Whether the selection control is limited to single selection.
+			 * Whether the selection control is limited to single selection
+			 * @type {boolean}
 			 */
 			selectionSingle: { type: Boolean, attribute: 'selection-single' }
 		};

package/components/selection/selection-observer-mixin.js

@@ -7,10 +7,12 @@ export const SelectionObserverMixin = superclass => class extends superclass {
 		return {
 			/**
 			 * Id of the SelectionMixin component this component wants to observe (if not located within that component)
+			 * @type {string}
 			 */
 			selectionFor: { type: String, reflect: true, attribute: 'selection-for' },
 			/**
-			 * The selection info (set by the selection component).
+			 * The selection info (set by the selection component)
+			 * @type {object}
 			 */
 			selectionInfo: { type: Object },
 			_provider: { type: Object, attribute: false }

package/components/selection/selection-select-all.js

@@ -7,6 +7,7 @@ import { SelectionObserverMixin } from './selection-observer-mixin.js';
 
 /**
  * A checkbox that provides select-all behavior for selection components such as tables and lists.
+ * @fires d2l-selection-observer-subscribe - Internal event
  */
 class SelectAll extends LocalizeCoreElement(SelectionObserverMixin(LitElement)) {
 
@@ -14,6 +15,7 @@ class SelectAll extends LocalizeCoreElement(SelectionObserverMixin(LitElement))
 		return {
 			/**
 			 * Disables the select all checkbox
+			 * @type {boolean}
 			 */
 			disabled: { type: Boolean }
 		};

package/components/selection/selection-summary.js

@@ -6,13 +6,15 @@ import { SelectionObserverMixin } from './selection-observer-mixin.js';
 
 /**
  * A summary showing the current selected count.
+ * @fires d2l-selection-observer-subscribe - Internal event
  */
 class Summary extends LocalizeCoreElement(SelectionObserverMixin(LitElement)) {
 
 	static get properties() {
 		return {
 			/**
-			 * Text to display if no items are selected.
+			 * Text to display if no items are selected
+			 * @type {string}
 			 */
 			noSelectionText: { type: String, attribute: 'no-selection-text' }
 		};

package/components/skeleton/skeleton-mixin.js

@@ -148,6 +148,7 @@ export const SkeletonMixin = dedupeMixin(superclass => class extends RtlMixin(su
 		return {
 			/**
 			 * Renders the input as a [skeleton loader](https://github.com/BrightspaceUI/core/tree/main/components/skeleton)
+			 * @type {boolean}
 			 */
 			skeleton: { reflect: true, type: Boolean  }
 		};

package/components/status-indicator/status-indicator.js

@@ -18,12 +18,14 @@ class StatusIndicator extends LitElement {
 			},
 			/**
 			 * REQUIRED: The text that is displayed within the status indicator
+			 * @type {string}
 			 */
 			text: {
 				type: String
 			},
 			/**
 			 * Use when the status is very important and needs to have a lot of prominence
+			 * @type {boolean}
 			 */
 			bold: {
 				type: Boolean,

package/components/switch/switch-visibility.js

@@ -3,6 +3,9 @@ import { html, LitElement } from 'lit-element/lit-element.js';
 import { LocalizeCoreElement } from '../../lang/localize-core-element.js';
 import { SwitchMixin } from './switch-mixin.js';
 
+/**
+ * A variant of the generic switch configured with special icons and default text for toggling "visibility".
+ */
 class VisibilitySwitch extends LocalizeCoreElement(SwitchMixin(LitElement)) {
 
 	get text() {

package/components/switch/switch.js

@@ -4,6 +4,9 @@ import '../icons/icon-custom.js';
 import { html, LitElement } from 'lit-element/lit-element.js';
 import { SwitchMixin } from './switch-mixin.js';
 
+/**
+ * A generic switch with on/off semantics.
+ */
 class Switch extends SwitchMixin(LitElement) {
 
 	get offIcon() {

package/components/table/table-col-sort-button.js

@@ -2,9 +2,7 @@ import '../icons/icon.js';
 import { css, html, LitElement } from 'lit-element/lit-element.js';
 
 /**
- *
  * Button for sorting a table column in ascending/descending order.
- *
  * @slot - Text of the sort button
  */
 export class TableColSortButton extends LitElement {

package/components/table/table-wrapper.js

@@ -164,9 +164,7 @@ export const tableStyles = css`
 `;
 
 /**
- *
  * Wraps a native <table> element, providing styling and scroll buttons for overflow.
- *
  * @slot - Content to wrap
  */
 export class TableWrapper extends RtlMixin(LitElement) {

package/components/tabs/tab-panel-mixin.js

@@ -55,6 +55,7 @@ export const TabPanelMixin = superclass => class extends superclass {
 		super.attributeChangedCallback(name, oldval, newval);
 		if (name === 'text') {
 			this.setAttribute('aria-label', this.text);
+			/** Dispatched when the text attribute is changed */
 			this.dispatchEvent(new CustomEvent(
 				'd2l-tab-panel-text-changed', { bubbles: true, composed: true, detail: { text: this.text } }
 			));
@@ -73,6 +74,7 @@ export const TabPanelMixin = superclass => class extends superclass {
 			if (prop === 'selected') {
 				if (this.selected) {
 					requestAnimationFrame(() => {
+						/** Dispatched when a tab is selected */
 						this.dispatchEvent(new CustomEvent(
 							'd2l-tab-panel-selected', { bubbles: true, composed: true }
 						));

package/components/tabs/tab-panel.js

@@ -4,8 +4,6 @@ import { TabPanelMixin } from './tab-panel-mixin.js';
 /**
  * A component for tab panel content.
  * @slot - Default content in tab panel
- * @fires d2l-tab-panel-text-changed - Dispatched when the text attribute is changed
- * @fires d2l-tab-panel-selected - Dispatched when a tab is selected
  */
 class TabPanel extends TabPanelMixin(LitElement) {