@ixfx/components 0.16.1 → 0.16.3

package/dist/{detail-list-Bo5ze3SN.js → detail-list-w3GXKO2k.js}

@@ -3,13 +3,14 @@ import { t as themeFallbacks } from "./fallbacks-DQ_5OsmR.js";
 import { n as safeCustomElement, t as __decorate } from "./decorate-VRK8rslU.js";
 import "./icon-1gpwtPx8.js";
 import { t as DataController } from "./data-controller-DOlmqNKb.js";
-import { c as createElementListSearchAdapter, i as ListSearchController, n as listSearchStyles, o as registerListSearchCommands, r as LIST_SEARCH_MODES, u as keyForElement } from "./incr-search-CgbL-OlS.js";
+import { c as createElementListSearchAdapter, d as keysOfElements, i as ListSearchController, n as listSearchStyles, o as registerListSearchCommands, r as LIST_SEARCH_MODES, u as keyForElement } from "./incr-search-Dc6gYpJG.js";
 import { a as toGroupKey, r as partitionByGroup } from "./grouping-RYPnHkrS.js";
 import { i as animateListItemOut, r as animateListItemIn, t as ListNativeDragController } from "./list-native-drag-controller-CcXoS0YX.js";
-import { r as ListDragSelectController, t as ListSelectionController } from "./list-selection-controller-5L0Nj9tR.js";
+import { i as ListDragSelectController, n as gestureOf, t as ListSelectionController } from "./list-selection-controller-D4iIrvJH.js";
 import { a as capKeys, d as partitionKeys, l as keysToArray, o as flagsFromRecord } from "./pending-BGidHppL.js";
-import { a as restoreElementScroll, o as scrollToOffset, r as captureElementScroll, t as ViewStateController } from "./view-state-controller-BdyXWUUM.js";
+import { i as sameKeySet, n as applyPartialAttributes, r as isPartialKey } from "./partial-keys-Ck6CiprB.js";
 import { t as scrollFadeStyles } from "./scroll-fade-Xx28D7mH.js";
+import { a as restoreElementScroll, o as scrollToOffset, r as captureElementScroll, t as ViewStateController } from "./view-state-controller-BdyXWUUM.js";
 import { n as appearanceColor, t as appearanceAbsent } from "./item-appearance-BjcMyauw.js";
 import "./list-group-header.js";
 import { LitElement, css, html, nothing, render } from "lit";
@@ -332,6 +333,7 @@ let DetailListElement = class DetailListElement extends LitElement {
 				interactionMode: this.interactionMode
 			}),
 			getKey: keyForElement,
+			onIntent: (intent) => this._dispatchCancelable(`list-select-intent`, intent) === false,
 			getGroupKey: (el) => this.#groupIndex.get(el) ?? null,
 			crossGroupSelection: () => this.crossGroupSelection,
 			getFallbackGroupKey: () => {
@@ -343,7 +345,8 @@ let DetailListElement = class DetailListElement extends LitElement {
 				this._dispatch(`list-select`, {
 					selected,
 					previous,
-					selectedKeys: this.selection.selectedKeys
+					selectedKeys: this.selection.selectedKeys,
+					previousKeys: keysOfElements(previous)
 				});
 				this.#viewState.notify();
 			}
@@ -436,6 +439,8 @@ let DetailListElement = class DetailListElement extends LitElement {
 			getLabel: (el) => el.getAttribute(`data-search-label`) ?? el.textContent?.trim() ?? ``,
 			highlightKey: SEARCH_HIGHLIGHT_KEY
 		}) });
+		this.#partialKeys = /* @__PURE__ */ new Set();
+		this.#markedPartial = /* @__PURE__ */ new Set();
 		this.#onListScroll = () => {
 			if (!this.#viewState.pendingScroll) this.#viewState.notify();
 			if (this.#viewportScrollRaf !== 0) return;
@@ -459,7 +464,7 @@ let DetailListElement = class DetailListElement extends LitElement {
 			if ((e.ctrlKey || e.metaKey) && e.key === `a`) {
 				if (this.selection.canSelectAll()) {
 					e.preventDefault();
-					this.selection.selectAll();
+					this.selection.selectAll(`keyboard`);
 				}
 				return;
 			}
@@ -468,17 +473,17 @@ let DetailListElement = class DetailListElement extends LitElement {
 				case `ArrowDown`:
 					e.preventDefault();
 					this.#navigateDown();
-					if (e.shiftKey && this.interactionMode === `vscode`) {
+					if (e.shiftKey && (this.interactionMode === `vscode` || this.interactionMode === `manual`)) {
 						const cur = this.tickled.tickledId;
-						if (cur) this.selection.rangeTo(cur);
+						if (cur) this.selection.handleExtend(cur);
 					}
 					break;
 				case `ArrowUp`:
 					e.preventDefault();
 					this.#navigateUp();
-					if (e.shiftKey && this.interactionMode === `vscode`) {
+					if (e.shiftKey && (this.interactionMode === `vscode` || this.interactionMode === `manual`)) {
 						const cur = this.tickled.tickledId;
-						if (cur) this.selection.rangeTo(cur);
+						if (cur) this.selection.handleExtend(cur);
 					}
 					break;
 				case `ArrowRight`:
@@ -502,7 +507,7 @@ let DetailListElement = class DetailListElement extends LitElement {
 					if (id) {
 						e.preventDefault();
 						this._dispatch(`list-item-click`, { item: id });
-						this._activateItem(id);
+						this._activateItem(id, `keyboard`);
 					}
 					break;
 				}
@@ -514,7 +519,7 @@ let DetailListElement = class DetailListElement extends LitElement {
 					}
 					break;
 				}
-				case `Escape`: this.selection.clear();
+				case `Escape`: this.selection.handleClear(`keyboard`);
 			}
 		};
 		this._onClick = (e) => {
@@ -529,7 +534,7 @@ let DetailListElement = class DetailListElement extends LitElement {
 			if (!item) return;
 			this.focus();
 			this._dispatch(`list-item-click`, { item });
-			this.selection.handleClick(item, e);
+			this.selection.handleClick(item, gestureOf(e));
 		};
 		this._onDblClick = (e) => {
 			const item = this._findListItem(e.composedPath());
@@ -1807,7 +1812,41 @@ let DetailListElement = class DetailListElement extends LitElement {
 		this.#appliedSelected = new Set(selected);
 		this.#appliedChecked = checked;
 		if (this.dataset.inputMode !== this.tickled.inputMode) this.dataset.inputMode = this.tickled.inputMode;
-		if (selectionChanged) this._syncCheckboxes();
+		if (selectionChanged) {
+			this.#syncPartial();
+			this._syncCheckboxes();
+		}
+	}
+	#partialKeys;
+	/** Rows currently carrying `data-partial`. */
+	#markedPartial;
+	/**
+	* Rows shown as *partially* selected (a part of the resource is selected):
+	* `data-partial`, an indeterminate checkbox in `checked` mode, and an
+	* accessible description. Independent of `selectedKeys` — a key in both
+	* counts as selected. Replace-on-set.
+	*/
+	get partialKeys() {
+		return this.#partialKeys;
+	}
+	set partialKeys(keys) {
+		const next = new Set(keys);
+		if (sameKeySet(next, this.#partialKeys)) return;
+		this.#partialKeys = next;
+		this.#itemStatesFullSync = true;
+		this._syncItemStates();
+	}
+	/** Touch only the rows whose partial state changed: O(partial keys), not O(rows). */
+	#syncPartial() {
+		const selected = this.selection.selected;
+		const next = /* @__PURE__ */ new Set();
+		for (const key of this.#partialKeys) {
+			const el = this.#itemForKey(key);
+			if (el && isPartialKey(key, this.#partialKeys, selected.has(el))) next.add(el);
+		}
+		for (const el of this.#markedPartial) if (!next.has(el)) applyPartialAttributes(el, false);
+		for (const el of next) if (!this.#markedPartial.has(el)) applyPartialAttributes(el, true);
+		this.#markedPartial = next;
 	}
 	_syncCheckboxes() {
 		const inCheckedMode = this.interactionMode === `checked`;
@@ -1837,16 +1876,22 @@ let DetailListElement = class DetailListElement extends LitElement {
 				el.prepend(cb);
 			}
 			const checked = this.selection.selected.has(el);
+			const partial = isPartialKey(keyForElement(el), this.#partialKeys, checked);
 			if (wantsCustom) {
-				cb.setAttribute(`aria-checked`, String(checked));
+				cb.setAttribute(`aria-checked`, partial ? `mixed` : String(checked));
 				cb.toggleAttribute(`data-checked`, checked);
+				cb.toggleAttribute(`data-partial`, partial);
 				if (this.checkboxRenderer) {
 					const renderer = typeof this.checkboxRenderer === `function` ? this.checkboxRenderer : this.checkboxRenderer.renderer;
 					render(renderer(checked), cb);
 				}
 			} else {
 				const input = cb.querySelector(`input.ixfx-list-checkbox`);
-				if (input) input.checked = checked;
+				if (input) {
+					input.checked = checked;
+					input.indeterminate = partial;
+				}
+				cb.setAttribute(`aria-checked`, partial ? `mixed` : String(checked));
 			}
 		}
 	}
@@ -1865,7 +1910,7 @@ let DetailListElement = class DetailListElement extends LitElement {
 		cell.setAttribute(`part`, `checkbox`);
 		cell.addEventListener(`click`, (e) => {
 			e.stopPropagation();
-			this.selection.toggle(el);
+			this.selection.handleCheckbox(el);
 		});
 		const input = document.createElement(`input`);
 		input.type = `checkbox`;
@@ -1884,7 +1929,7 @@ let DetailListElement = class DetailListElement extends LitElement {
 		span.setAttribute(`part`, `checkbox`);
 		span.addEventListener(`click`, (e) => {
 			e.stopPropagation();
-			this.selection.toggle(el);
+			this.selection.handleCheckbox(el);
 		});
 		return span;
 	}
@@ -1949,8 +1994,8 @@ let DetailListElement = class DetailListElement extends LitElement {
 			visibleKeys
 		});
 	}
-	_activateItem(item) {
-		if (this.interactionMode !== `manual`) this.selection.replace(item);
+	_activateItem(item, source = `pointer`) {
+		this.selection.handleReplace(item, source);
 		this._dispatch(`list-activate`, { item });
 	}
 	static {
@@ -2070,6 +2115,13 @@ let DetailListElement = class DetailListElement extends LitElement {
       outline: 1px solid transparent;
     }
 
+    /* Partially selected: a dashed edge, lighter than a full selection. Hook: --item-bg-partial. */
+    ::slotted([data-partial]) {
+      background: var(--item-bg-partial, color-mix(in srgb, var(--item-bg-selected) 35%, transparent));
+      outline: 1px dashed var(--item-border-partial, var(--border));
+      outline-offset: -1px;
+    }
+
     ::slotted([data-selected][data-tickled]) {
       background: var(--item-bg-selected-tickled);
       outline: 2px dashed var(--surface-3);

package/dist/detail-list.d.ts

@@ -1,6 +1,6 @@
 import { B as ListNativeDragStartDetail, F as ListDragPreview, I as ListDragPreviewContext, L as ListDragPreviewRenderer, P as ListDragEntry, V as ListNativeDragStartEvent, z as ListDragSource } from "./tree-component-DgfkxmVY.js";
 import { n as ListViewportChangeEvent, t as ListViewportChangeDetail } from "./list-viewport-types-BRZsLcvp.js";
 import { i as ListGroupChangeEvent, l as ListGroupToggleDetail, n as ListGroupBy, o as ListGroupInfo, r as ListGroupChangeDetail, s as ListGroupLabel, u as ListGroupToggleEvent } from "./grouping-CUKgmkMm.js";
-import { a as DetailSortComparator, c as DetailListViewState, i as DetailGroupBy, n as DetailListElementEventMap, o as DetailSortItem, r as DetailFormatter, s as DetailSortMode, t as DetailListElement } from "./detail-list-DSZ1DDor.js";
-import { n as CustomCheckboxOptions, t as AddItemOptions } from "./vertical-list-SAx56U-l.js";
+import { a as DetailSortComparator, c as DetailListViewState, i as DetailGroupBy, n as DetailListElementEventMap, o as DetailSortItem, r as DetailFormatter, s as DetailSortMode, t as DetailListElement } from "./detail-list-n1MbNbhF.js";
+import { n as CustomCheckboxOptions, t as AddItemOptions } from "./vertical-list-DtHX26JO.js";
 export { type AddItemOptions, type CustomCheckboxOptions, type DetailFormatter, type DetailGroupBy, DetailListElement, DetailListElementEventMap, type DetailListViewState, type DetailSortComparator, type DetailSortItem, type DetailSortMode, type ListDragEntry, type ListDragPreview, type ListDragPreviewContext, type ListDragPreviewRenderer, type ListDragSource, type ListGroupBy, type ListGroupChangeDetail, type ListGroupChangeEvent, type ListGroupInfo, type ListGroupLabel, type ListGroupToggleDetail, type ListGroupToggleEvent, type ListNativeDragStartDetail, type ListNativeDragStartEvent, type ListViewportChangeDetail, type ListViewportChangeEvent };

package/dist/detail-list.js

@@ -1,3 +1,3 @@
-import { t as DetailListElement } from "./detail-list-Bo5ze3SN.js";
+import { t as DetailListElement } from "./detail-list-w3GXKO2k.js";
 import "./list-group-header.js";
 export { DetailListElement };

package/dist/{flat-list-CT9kX3TQ.d.ts → flat-list-D_4y3wgn.d.ts}

@@ -4,8 +4,8 @@ import { o as TreeNode, r as TreeFilterPredicate, t as LoadChildrenCallback } fr
 import { a as ViewStateBase, t as GetViewStateOptions } from "./types-LU1u0CB8.js";
 import "./index-9ttcdwlL.js";
 import "./crumb-navigation-BbqfmkYs.js";
-import { i as ListInteractionMode, l as ListSelectionMode } from "./list-selection-types-PjKdhF-a.js";
-import { r as VerticalListElement } from "./vertical-list-SAx56U-l.js";
+import { h as ListSelectionMode, i as ListInteractionMode } from "./list-selection-types-Dnamh2Lu.js";
+import { r as VerticalListElement } from "./vertical-list-DtHX26JO.js";
 import { LitElement, PropertyValues } from "lit";
 //#region src/flat-list/types.d.ts
 /** How branches and leaves are ordered within one level. */
@@ -121,6 +121,11 @@ declare class FlatListElement extends LitElement {
   branchOrder: FlatListBranchOrder;
   selectionMode: ListSelectionMode;
   interactionMode: ListInteractionMode;
+  /**
+   * Row keys shown as *partially* selected (see `ixfx-vertical-list`'s
+   * `partialKeys`). Independent of the selection; a key in both counts as selected.
+   */
+  partialKeys: ReadonlySet<string>;
   itemWrap: `stop` | `wrap`;
   searchModes: string | undefined;
   itemsDraggable: boolean;

package/dist/flat-list.d.ts

@@ -1,2 +1,2 @@
-import { _ as FlatListSelectEvent, a as FlatListContextMenuDetail, c as FlatListDropEvent, d as FlatListEditCommitDetail, f as FlatListEditCommitEvent, g as FlatListSelectDetail, h as FlatListNavigateEvent, i as FlatListBranchOrder, l as FlatListEditCancelDetail, m as FlatListNavigateDetail, n as FlatListActivateDetail, o as FlatListContextMenuEvent, p as FlatListElementEventMap, r as FlatListActivateEvent, s as FlatListDropDetail, t as FlatListElement, u as FlatListEditCancelEvent, v as FlatListViewState } from "./flat-list-CT9kX3TQ.js";
+import { _ as FlatListSelectEvent, a as FlatListContextMenuDetail, c as FlatListDropEvent, d as FlatListEditCommitDetail, f as FlatListEditCommitEvent, g as FlatListSelectDetail, h as FlatListNavigateEvent, i as FlatListBranchOrder, l as FlatListEditCancelDetail, m as FlatListNavigateDetail, n as FlatListActivateDetail, o as FlatListContextMenuEvent, p as FlatListElementEventMap, r as FlatListActivateEvent, s as FlatListDropDetail, t as FlatListElement, u as FlatListEditCancelEvent, v as FlatListViewState } from "./flat-list-D_4y3wgn.js";
 export { type FlatListActivateDetail, type FlatListActivateEvent, type FlatListBranchOrder, type FlatListContextMenuDetail, type FlatListContextMenuEvent, type FlatListDropDetail, type FlatListDropEvent, type FlatListEditCancelDetail, type FlatListEditCancelEvent, type FlatListEditCommitDetail, type FlatListEditCommitEvent, FlatListElement, type FlatListElementEventMap, type FlatListNavigateDetail, type FlatListNavigateEvent, type FlatListSelectDetail, type FlatListSelectEvent, type FlatListViewState };

package/dist/flat-list.js

@@ -4,9 +4,9 @@ import { n as safeCustomElement, t as __decorate } from "./decorate-VRK8rslU.js"
 import "./icon-1gpwtPx8.js";
 import { t as collectDataResult } from "./data-provider-35TyWclX.js";
 import { t as ViewStateController } from "./view-state-controller-BdyXWUUM.js";
-import { n as resolveKeyPath } from "./crumb-navigation-YnFVFqrx.js";
+import { n as resolveKeyPath } from "./crumb-navigation-D3ndPgFg.js";
 import { n as appearanceColor, t as appearanceAbsent } from "./item-appearance-BjcMyauw.js";
-import "./vertical-list-DyKPKGxK.js";
+import "./vertical-list-o5hfqH87.js";
 import { LitElement, css, html, nothing } from "lit";
 import { property, state } from "lit/decorators.js";
 //#region src/flat-list/flat-list.ts
@@ -73,6 +73,7 @@ let FlatListElement = class FlatListElement extends LitElement {
 		this.branchOrder = `first`;
 		this.selectionMode = `single`;
 		this.interactionMode = `standard`;
+		this.partialKeys = /* @__PURE__ */ new Set();
 		this.itemWrap = `stop`;
 		this.itemsDraggable = false;
 		this.itemsDroppable = false;
@@ -597,6 +598,7 @@ let FlatListElement = class FlatListElement extends LitElement {
           key-property="key"
           .selectionMode=${this.selectionMode}
           .interactionMode=${this.interactionMode}
+          .partialKeys=${this.partialKeys}
           .itemWrap=${this.itemWrap}
           .searchModes=${this.searchModes}
           ?items-draggable=${this.itemsDraggable}
@@ -742,6 +744,7 @@ __decorate([property({
 	type: String,
 	attribute: `interaction-mode`
 })], FlatListElement.prototype, "interactionMode", void 0);
+__decorate([property({ attribute: false })], FlatListElement.prototype, "partialKeys", void 0);
 __decorate([property({
 	type: String,
 	attribute: `item-wrap`

package/dist/{grid-list-DDLrWRxm.d.ts → grid-list-CqYS28NY.d.ts}

@@ -1,10 +1,10 @@
 import { L as ListDragPreviewRenderer, R as ListDragPreviewSourceResolver, V as ListNativeDragStartEvent } from "./tree-component-DgfkxmVY.js";
 import { a as ViewStateBase, t as GetViewStateOptions } from "./types-LU1u0CB8.js";
 import "./index-9ttcdwlL.js";
-import { S as ListSearchController } from "./index-CUErGhCg.js";
+import { h as ListSelectionMode, i as ListInteractionMode, p as ListSelectIntentSource, s as ListMarqueeMode, u as ListSelectIntentDetail } from "./list-selection-types-Dnamh2Lu.js";
+import { S as ListSearchController } from "./index-Bm9a9S3_.js";
 import "./pan-text-CoYmt2qd.js";
 import { i as ListGroupChangeEvent, n as ListGroupBy, o as ListGroupInfo, s as ListGroupLabel, u as ListGroupToggleEvent } from "./grouping-CUKgmkMm.js";
-import { i as ListInteractionMode, l as ListSelectionMode } from "./list-selection-types-PjKdhF-a.js";
 import "./list-group-header.js";
 import "./list-native-drag-controller-D_UrXipS.js";
 import { i as TickledItem, n as TickledController } from "./tickled-controller-DodxD3eQ.js";
@@ -86,10 +86,13 @@ type ListDragSelectControllerConfig<T> = {
   /**
    * Fired once on release with the final set. Host applies it to its
    * selection. `additive` is `true` when the drag ran with Shift (add) or
-   * Cmd / Ctrl (invert) held.
+   * Cmd / Ctrl (invert) held. `covered` is the set the marquee itself hit,
+   * before combining with the base selection.
    */
   onCommit: (finalSet: ReadonlySet<T>, info: {
     additive: boolean;
+    covered: ReadonlySet<T>;
+    mode: ListMarqueeMode;
   }) => void;
   /** Optional: scroll the surface when the pointer nears an edge during a drag. */
   autoScroll?: (dx: number, dy: number) => void;
@@ -133,7 +136,11 @@ type ListSelectionGesture = {
   readonly ctrlKey: boolean;
   readonly metaKey: boolean;
   readonly shiftKey: boolean;
+  /** `PointerEvent.pointerType`, when known; a `touch` tap reports source `touch`. */
+  readonly pointerType?: string;
 };
+/** Capture the modifier / pointer-type state of a click for `handleClick`. */
+declare function gestureOf(e: MouseEvent): ListSelectionGesture;
 type ListSelectionModes = {
   readonly selectionMode: ListSelectionMode;
   readonly interactionMode: ListInteractionMode;
@@ -157,6 +164,13 @@ type ListSelectionControllerConfig<T> = {
    * requests an update.
    */
   readonly onChange: (selected: ReadonlySet<T>, previous: ReadonlySet<T>) => void;
+  /**
+   * Optional: called with the intent behind a gesture (or `selectAll()`)
+   * before the selection changes. Return `true` when the caller took over
+   * (`preventDefault()`); the controller then leaves the selection alone but
+   * still moves the range anchor.
+   */
+  readonly onIntent?: (intent: ListSelectIntentDetail) => boolean;
   /**
    * Optional: derive a stable string key for an item. Enables `selectedKeys`
    * and `selectKeys()`. When omitted, `selectedKeys` is always empty.
@@ -225,8 +239,11 @@ declare class ListSelectionController<T> {
   rangeTo(item: T): void;
   /** Clear the selection. No change event when the selection is already empty. */
   clear(): void;
-  /** Select every ordered item that passes `isSelectable`. */
-  selectAll(): void;
+  /**
+   * Select every ordered item that passes `isSelectable`. Fires an `all`
+   * intent first; the caller may take over.
+   */
+  selectAll(source?: ListSelectIntentSource): void;
   /**
    * Replace the selection with many items at once. Requires
    * `selectionMode="multiple"`, throws otherwise. Updates the anchor.
@@ -248,24 +265,30 @@ declare class ListSelectionController<T> {
    * non-empty selection (e.g. a Cmd-drag that toggles everything off) but is
    * a no-op when nothing is selected.
    */
-  applyDragSelection(items: Iterable<T>): void;
+  applyDragSelection(items: Iterable<T>, info?: {
+    additive: boolean;
+    covered: Iterable<T>;
+    mode?: ListMarqueeMode;
+  }): void;
   /** Remove a single item from the selection. */
   deselect(item: T): void;
   /**
    * Replace the selection with the items resolved from `keys`. Keys that
-   * `resolve` cannot map, or that resolve to a non-selectable item, are
-   * ignored. `selectionMode="none"` is a no-op. When multi-select is not
-   * available, only the last resolvable key is kept. `onChange` fires once.
+   * `resolve` cannot map yet are kept pending and selected when their items
+   * appear (see `resolvePending()`); keys that resolve to a non-selectable
+   * item are ignored. `selectionMode="none"` is a no-op. When multi-select is
+   * not available, only the last key is kept. `onChange` fires once.
    */
   selectKeys(keys: Iterable<string>, resolve: (key: string) => T | undefined): void;
   /**
    * Add the items resolved from `keys` to the selection (multi-select only;
-   * a no-op otherwise). `onChange` fires once if anything changed.
+   * a no-op otherwise). Keys not present yet are kept pending. `onChange`
+   * fires once if anything changed.
    */
   addKeys(keys: Iterable<string>, resolve: (key: string) => T | undefined): void;
   /**
-   * Remove the items resolved from `keys` from the selection. `onChange`
-   * fires once if anything changed.
+   * Remove the items resolved from `keys` from the selection, and drop them
+   * from the pending keys. `onChange` fires once if anything changed.
    */
   removeKeys(keys: Iterable<string>, resolve: (key: string) => T | undefined): void;
   /** Selected keys waiting for their items to appear. */
@@ -291,10 +314,25 @@ declare class ListSelectionController<T> {
   demote(items: Iterable<T>): boolean;
   /** Drop pending keys without touching the live selection. */
   clearPending(): void;
-  /** Route a click on `item` according to the current interaction mode. */
+  /**
+   * Route a click on `item` according to the current interaction mode. In
+   * `manual` mode nothing is selected, but the intent is still reported so
+   * the caller can apply it.
+   */
   handleClick(item: T, gesture: ListSelectionGesture): void;
   /** Route a Space keypress on `item` according to the current interaction mode. */
   handleSpace(item: T): void;
+  /** Route a checkbox (checked-mode) toggle on `item`. */
+  handleCheckbox(item: T, source?: ListSelectIntentSource): void;
+  /** Route a plain "select only this" gesture (Enter, double-click) on `item`. */
+  handleReplace(item: T, source?: ListSelectIntentSource): void;
+  /** Route Shift+Arrow: extend the range from the anchor to the cursor `item`. */
+  handleExtend(item: T): void;
+  /**
+   * Route Escape / empty-space click: clear the selection. `reportOnly`
+   * suppresses the default action in `manual` mode (the caller owns it).
+   */
+  handleClear(source?: ListSelectIntentSource, reportOnly?: boolean): void;
   /** Drop the range-selection anchor (e.g. when the interaction mode changes). */
   clearAnchor(): void;
   /**
@@ -773,6 +811,14 @@ declare class GridListElement<T = unknown> extends LitElement {
    * Auto-assigned keyless-item keys are omitted.
    */
   visibleKeys(): string[];
+  /**
+   * Cells shown as *partially* selected (a part of the resource is selected):
+   * `data-partial` / `part="item partial"` and an accessible description.
+   * Independent of `selectedKeys` — a key in both counts as selected.
+   * Replace-on-set; keys without a cell are kept for when it appears.
+   */
+  get partialKeys(): ReadonlySet<string>;
+  set partialKeys(keys: Iterable<string>);
   /**
    * Mirror cursor / selection onto the light-DOM items as `data-tickled` /
    * `data-selected`. Only the items whose state changed are touched, so a
@@ -795,4 +841,4 @@ interface GridListElement {
   addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
 }
 //#endregion
-export { isMultiMode as A, capKeys as B, TreeKeyboardNavController as C, ListSelectionControllerConfig as D, ListSelectionController as E, EMPTY_KEYS as F, partitionFlags as G, flagsToRecord as H, MAX_PENDING_KEYS as I, partitionKeys as K, PendingFlags as L, ListDragSelectController as M, ListDragSelectControllerConfig as N, ListSelectionGesture as O, EMPTY_FLAGS as P, PendingKeys as R, TreeKeyboardNavCallbacks as S, TreeKeyboardNavItemId as T, keysAsFlags as U, flagsFromRecord as V, keysToArray as W, GridListSelectEvent as _, GridListCaptionAlign as a, GridListViewportChangeDetail as b, GridListCaptionStyle as c, GridListFullElementEventMap as d, GridListItemClickDetail as f, GridListSelectDetail as g, GridListOrientation as h, GridListActivateEvent as i, DragSelectRect as j, ListSelectionModes as k, GridListDataAdapter as l, GridListItemEventDetail as m, GridListViewState as n, GridListCaptionBackdrop as o, GridListItemClickEvent as p, withoutFlag as q, GridListActivateDetail as r, GridListCaptionPosition as s, GridListElement as t, GridListElementEventMap as u, GridListTickleDetail as v, TreeKeyboardNavControllerConfig as w, GridListViewportChangeEvent as x, GridListTickleEvent as y, capFlags as z };
+export { gestureOf as A, capFlags as B, TreeKeyboardNavController as C, ListSelectionControllerConfig as D, ListSelectionController as E, EMPTY_FLAGS as F, keysToArray as G, flagsFromRecord as H, EMPTY_KEYS as I, withoutFlag as J, partitionFlags as K, MAX_PENDING_KEYS as L, DragSelectRect as M, ListDragSelectController as N, ListSelectionGesture as O, ListDragSelectControllerConfig as P, PendingFlags as R, TreeKeyboardNavCallbacks as S, TreeKeyboardNavItemId as T, flagsToRecord as U, capKeys as V, keysAsFlags as W, GridListSelectEvent as _, GridListCaptionAlign as a, GridListViewportChangeDetail as b, GridListCaptionStyle as c, GridListFullElementEventMap as d, GridListItemClickDetail as f, GridListSelectDetail as g, GridListOrientation as h, GridListActivateEvent as i, isMultiMode as j, ListSelectionModes as k, GridListDataAdapter as l, GridListItemEventDetail as m, GridListViewState as n, GridListCaptionBackdrop as o, GridListItemClickEvent as p, partitionKeys as q, GridListActivateDetail as r, GridListCaptionPosition as s, GridListElement as t, GridListElementEventMap as u, GridListTickleDetail as v, TreeKeyboardNavControllerConfig as w, GridListViewportChangeEvent as x, GridListTickleEvent as y, PendingKeys as z };