@skyux/lists 15.0.0-alpha.2 → 15.0.0-alpha.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/lists",
-  "version": "15.0.0-alpha.2",
+  "version": "15.0.0-alpha.4",
   "author": "Blackbaud, Inc.",
   "keywords": [
     "blackbaud",
@@ -20,15 +20,15 @@
     "@angular/common": "^22.0.6",
     "@angular/core": "^22.0.6",
     "@angular/platform-browser": "^22.0.6",
-    "@skyux-sdk/testing": "15.0.0-alpha.2",
-    "@skyux/core": "15.0.0-alpha.2",
-    "@skyux/forms": "15.0.0-alpha.2",
-    "@skyux/i18n": "15.0.0-alpha.2",
-    "@skyux/icon": "15.0.0-alpha.2",
-    "@skyux/indicators": "15.0.0-alpha.2",
-    "@skyux/inline-form": "15.0.0-alpha.2",
-    "@skyux/popovers": "15.0.0-alpha.2",
-    "@skyux/theme": "15.0.0-alpha.2"
+    "@skyux-sdk/testing": "15.0.0-alpha.4",
+    "@skyux/core": "15.0.0-alpha.4",
+    "@skyux/forms": "15.0.0-alpha.4",
+    "@skyux/i18n": "15.0.0-alpha.4",
+    "@skyux/icon": "15.0.0-alpha.4",
+    "@skyux/indicators": "15.0.0-alpha.4",
+    "@skyux/inline-form": "15.0.0-alpha.4",
+    "@skyux/popovers": "15.0.0-alpha.4",
+    "@skyux/theme": "15.0.0-alpha.4"
   },
   "dependencies": {
     "tslib": "^2.8.1"

package/types/skyux-lists-testing.d.ts

@@ -535,7 +535,9 @@ declare class SkyRepeaterItemHarness extends SkyQueryableComponentHarness {
      */
     collapse(): Promise<void>;
     /**
-     * Deselects the repeater item.
+     * Deselects the repeater item. Throws an error if the item belongs to a
+     * single-select repeater, since a single-select item can only be replaced
+     * by selecting a different item, not cleared directly.
      */
     deselect(): Promise<void>;
     /**
@@ -567,7 +569,8 @@ declare class SkyRepeaterItemHarness extends SkyQueryableComponentHarness {
      */
     isCollapsible(): Promise<boolean>;
     /**
-     * Whether a selectable repeater item is disabled.
+     * Whether a selectable repeater item is disabled, either via a checkbox's disabled state, or,
+     * for a single-select repeater item, via the `aria-disabled` attribute on the item's row.
      */
     isDisabled(): Promise<boolean>;
     /**
@@ -579,7 +582,10 @@ declare class SkyRepeaterItemHarness extends SkyQueryableComponentHarness {
      */
     isReorderable(): Promise<boolean>;
     /**
-     * Whether a repeater item has selection enabled.
+     * Whether a repeater item has selection enabled, either via a checkbox (the
+     * repeater's `selectionMode` property set to `multiple` or the item's deprecated
+     * `selectable` property) or via the repeater's `selectionMode` property set
+     * to `single`.
      */
     isSelectable(): Promise<boolean>;
     /**
@@ -587,7 +593,9 @@ declare class SkyRepeaterItemHarness extends SkyQueryableComponentHarness {
      */
     isSelected(): Promise<boolean>;
     /**
-     * Selects the repeater item.
+     * Selects the repeater item. For a checkbox-selectable item, checks its
+     * checkbox. For a single-select repeater item, clicks the item, which also
+     * clears any previously selected item.
      */
     select(): Promise<void>;
     /**

package/types/skyux-lists.d.ts

@@ -308,6 +308,8 @@ declare class SkyPagingModule {
 
 type SkyRepeaterExpandModeType = 'single' | 'multiple' | 'none';
 
+type SkyRepeaterSelectionModeType = 'none' | 'single' | 'multiple';
+
 /**
  * Displays content text when the repeater is expanded.
  */
@@ -317,7 +319,7 @@ declare class SkyRepeaterItemContentComponent {
 }
 
 interface SkyRepeaterItemRolesType {
-    item: 'listitem' | 'row' | undefined;
+    item: 'listitem' | 'row' | 'option' | undefined;
     title: 'rowheader' | undefined;
     content: 'gridcell' | undefined;
 }
@@ -331,6 +333,8 @@ declare class SkyRepeaterItemComponent implements OnDestroy, OnInit, AfterViewIn
      * Make the first, non-disabled item tab-focusable in a selectable repeater.
      * - Disabled items should not be focusable per [W3C](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#focusabilityofdisabledcontrols).
      * - One item per grid should be tab focusable per [W3C](https://www.w3.org/WAI/ARIA/apg/patterns/grid/).
+     * - In a single-select repeater, the tab-focusable item is the selected item, or the
+     * first non-disabled item when nothing is selected, per [W3C](https://www.w3.org/WAI/ARIA/apg/patterns/listbox/).
      */
     get tabindex(): 0 | -1;
     /**
@@ -366,12 +370,33 @@ declare class SkyRepeaterItemComponent implements OnDestroy, OnInit, AfterViewIn
     set isExpanded(value: boolean | undefined);
     get isExpanded(): boolean;
     /**
-     * Whether the repeater item's checkbox is selected.
+     * Whether the repeater item is selected, either via its own checkbox or via the
+     * repeater's `selectionMode` property.
      * When users select the repeater item, the specified property on your model is updated accordingly.
      * @default false
      */
     set isSelected(value: boolean | undefined);
     get isSelected(): boolean | undefined;
+    /**
+     * The `aria-selected` value to render for this item. In a single-select repeater,
+     * every item receives `true` or `false` since the item's role is `option`, which
+     * requires `aria-selected` to be explicitly set on all options.
+     */
+    protected readonly ariaSelected: i0.Signal<boolean | undefined>;
+    protected readonly isSelectionModeSingle: i0.Signal<boolean>;
+    /**
+     * Whether to render a selection checkbox for this item, either via the repeater's
+     * `selectionMode` property set to `multiple` or via the item's deprecated
+     * `selectable` property.
+     */
+    protected readonly showCheckbox: i0.Signal<boolean>;
+    /**
+     * The `aria-disabled` value to render for this item. In a single-select repeater,
+     * the item's row is the entire selection control (there is no separate checkbox), so it
+     * needs its own ARIA-equivalent indication that it cannot be selected. Multi-select items
+     * convey this via the checkbox's own `disabled` state instead.
+     */
+    protected readonly ariaDisabled: i0.Signal<true | undefined>;
     /**
      * Whether users can change the order of the repeater item.
      * The repeater component's `reorderable` property must also be set to `true`.
@@ -379,9 +404,13 @@ declare class SkyRepeaterItemComponent implements OnDestroy, OnInit, AfterViewIn
      */
     reorderable: boolean | undefined;
     /**
-     * Whether to display a checkbox in the left of the repeater item.
+     * Whether to display a checkbox in the left of the repeater item. This property
+     * never displays a checkbox when the repeater's `selectionMode` property is set
+     * to `single`.
+     * @deprecated Set the repeater's `selectionMode` property to `multiple` instead.
      */
-    selectable: boolean | undefined;
+    set selectable(value: boolean | undefined);
+    get selectable(): boolean | undefined;
     /**
      * Whether to display an inline form within the repeater.
      * Users can toggle between displaying and hiding the inline form.
@@ -446,7 +475,7 @@ declare class SkyRepeaterItemComponent implements OnDestroy, OnInit, AfterViewIn
     static ɵcmp: i0.ɵɵComponentDeclaration<SkyRepeaterItemComponent, "sky-repeater-item", never, { "disabled": { "alias": "disabled"; "required": false; }; "itemName": { "alias": "itemName"; "required": false; }; "inlineFormConfig": { "alias": "inlineFormConfig"; "required": false; }; "inlineFormTemplate": { "alias": "inlineFormTemplate"; "required": false; }; "isExpanded": { "alias": "isExpanded"; "required": false; }; "isSelected": { "alias": "isSelected"; "required": false; }; "reorderable": { "alias": "reorderable"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "showInlineForm": { "alias": "showInlineForm"; "required": false; }; "tag": { "alias": "tag"; "required": false; }; }, { "collapse": "collapse"; "expand": "expand"; "inlineFormClose": "inlineFormClose"; "isSelectedChange": "isSelectedChange"; }, ["contextMenu", "titleComponent", "repeaterItemContentComponents"], ["sky-inline-delete", "sky-repeater-item-context-menu", "sky-repeater-item-title", "sky-repeater-item-content"], false, never>;
 }
 
-type SkyRepeaterRoleType = 'list' | 'grid';
+type SkyRepeaterRoleType = 'list' | 'grid' | 'listbox';
 
 /**
  * Creates a container to display repeater items.
@@ -495,6 +524,20 @@ declare class SkyRepeaterComponent implements AfterContentInit, AfterViewChecked
      */
     set expandMode(value: SkyRepeaterExpandModeType | undefined);
     get expandMode(): SkyRepeaterExpandModeType;
+    /**
+     * The selection interaction to apply to repeater items. The valid options are `none`,
+     * `single`, and `multiple`.
+     * - `none` (the default) does not add any selection interaction.
+     * - `single` lets users select one repeater item at a time. Clicking anywhere on a
+     * repeater item, or pressing the Space or Enter key while it has focus, selects it and
+     * clears any previously-selected item. Users can move focus between repeater items with
+     * the arrow keys, Home, and End
+     * [to support accessibility](https://developer.blackbaud.com/skyux/learn/accessibility).
+     * - `multiple` displays a checkbox on each repeater item so users can select
+     * multiple items at a time. The checkbox on a disabled repeater item is disabled.
+     * @default "none"
+     */
+    readonly selectionMode: i0.InputSignalWithTransform<SkyRepeaterSelectionModeType, SkyRepeaterSelectionModeType | undefined>;
     /**
      * Fires when the active repeater item changes.
      */
@@ -514,12 +557,12 @@ declare class SkyRepeaterComponent implements AfterContentInit, AfterViewChecked
     ngOnInit(): void;
     onCdkObserveContent(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyRepeaterComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyRepeaterComponent, "sky-repeater", never, { "activeIndex": { "alias": "activeIndex"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "reorderable": { "alias": "reorderable"; "required": false; }; "expandMode": { "alias": "expandMode"; "required": false; }; }, { "activeIndexChange": "activeIndexChange"; "orderChange": "orderChange"; }, ["items"], ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyRepeaterComponent, "sky-repeater", never, { "activeIndex": { "alias": "activeIndex"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "reorderable": { "alias": "reorderable"; "required": false; }; "expandMode": { "alias": "expandMode"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; }, { "activeIndexChange": "activeIndexChange"; "orderChange": "orderChange"; }, ["items"], ["*"], false, never>;
 }
 
 /**
  * Wraps and styles a
- * [`sky-dropdown` component](https://developer.blackbaud.com/skyux-popovers/docs/dropdown).
+ * [`sky-dropdown` component](https://developer.blackbaud.com/skyux/components/dropdown).
  */
 declare class SkyRepeaterItemContextMenuComponent {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyRepeaterItemContextMenuComponent, never>;
@@ -658,4 +701,4 @@ declare class SkySortModule {
 }
 
 export { SkyFilterModule, SkyFilterStateService, SkyInfiniteScrollModule, SkyListSummaryModule, SkyPagingModule, SkyRepeaterModule, SkySortModule, SkyFilterButtonComponent as λ1, SkyRepeaterItemComponent as λ10, SkyRepeaterComponent as λ11, SkyRepeaterItemTitleComponent as λ12, SkySortItemComponent as λ13, SkySortComponent as λ14, SkyPagingContentComponent as λ15, SkyListSummaryComponent as λ16, SkyListSummaryItemComponent as λ17, SkyFilterInlineComponent as λ2, SkyFilterInlineItemComponent as λ3, SkyFilterSummaryItemComponent as λ4, SkyFilterSummaryComponent as λ5, SkyInfiniteScrollComponent as λ6, SkyPagingComponent as λ7, SkyRepeaterItemContentComponent as λ8, SkyRepeaterItemContextMenuComponent as λ9 };
-export type { SkyFilterState, SkyFilterStateFilterItem, SkyFilterStateFilterValue, SkyPagingContentChangeArgs, SkyRepeaterExpandModeType };
+export type { SkyFilterState, SkyFilterStateFilterItem, SkyFilterStateFilterValue, SkyPagingContentChangeArgs, SkyRepeaterExpandModeType, SkyRepeaterSelectionModeType };