@ixfx/components 0.2.6 → 0.3.1

package/dist/index.js

@@ -1,33 +1,33 @@
-import { n as buildHighlightTargets, r as clearHighlights, t as applyHighlights } from "./highlight-CAjwQ4GE.js";
-import { r as TickledController } from "./tickled-styles-Bg3QbcrD.js";
-import { a as svgToDataUri, i as registerIcon, n as hasIcon, r as iconBus, t as getIcon } from "./registry-CZEB1YI9.js";
-import { n as safeCustomElement, t as __decorate } from "./decorate-O4m1U4l3.js";
-import { t as IxfxIconElement } from "./icon-CYACf6o8.js";
+import { n as buildHighlightTargets, r as clearHighlights, t as applyHighlights } from "./highlight-TPbSHruI.js";
+import { n as tickledStyles, r as TickledController } from "./tickled-styles-Bg3QbcrD.js";
+import { n as safeCustomElement, t as __decorate } from "./decorate-D7rC1gLP.js";
+import { a as svgToDataUri, i as registerIcon, n as hasIcon, r as iconBus, t as getIcon } from "./registry-Q2gYQCHM.js";
+import { t as IxfxIconElement } from "./icon-9NWTXtE1.js";
 import { AcTextElement } from "./ac-text.js";
-import { i as ICON_CLOSE, n as ICON_CHECK, r as ICON_CHEVRON_DOWN, t as ICON_CARET_RIGHT } from "./defaults-FEZaGiYZ.js";
+import { a as createFuzzySearch, i as createAcCompletionProvider, n as IncrSearchTreeController, r as createIncrSearch, t as createElementIncrSearch } from "./incr-search-DSKKsk6w.js";
+import { i as ICON_CLOSE, n as ICON_CHECK, r as ICON_CHEVRON_DOWN, t as ICON_CARET_RIGHT } from "./defaults-C7elhuyJ.js";
 import "./icons.js";
-import { t as prominenceStyles } from "./prominence-CreDBdCs.js";
-import { n as buttonStyles, t as ButtonElement } from "./button-B9ztaKyl.js";
-import { t as popupSurfaceStyles } from "./popup-Ddx9LCzY.js";
-import "./menu-item-6IU5weHi.js";
+import { t as prominenceStyles } from "./prominence--ic9uWBl.js";
+import { n as buttonStyles, t as ButtonElement } from "./button-DMt5XWUK.js";
+import { t as popupSurfaceStyles } from "./popup-ImtS9KnS.js";
+import "./menu-item-CKRfP0pN.js";
 import { Checkbox } from "./checkbox.js";
-import { C as resultThrow, E as throwIfFailed, d as scaler, h as without, n as clamper, p as containsDuplicateInstances, y as nullUndefTest } from "./dist-D7kJgnSE.js";
-import { a as computeColour, c as last, i as applyAgeModification, l as QueueMutable, n as PlotSingleAxis, o as parseColourScaleAttr, r as PlotDataSeries, s as readBaseColour, t as PlotXyAxis, u as __exportAll } from "./xy-axis-C7fNxDwY.js";
-import { a as toStringAbbreviate, c as isEqualDefault, l as isEqualValueDefault, o as defaultComparer, r as isPrimitive, u as isEqualValueIgnoreOrder } from "./dist-By5URG0Y.js";
-import { n as ColourPicker, t as ColourPickerPopup } from "./colour-picker-BNqDz4wK.js";
+import { C as resultThrow, E as throwIfFailed, d as scaler, h as without, n as clamper, p as containsDuplicateInstances, y as nullUndefTest } from "./dist-TAGYwaju.js";
+import { a as computeColour, c as last, i as applyAgeModification, l as QueueMutable, n as PlotSingleAxis, o as parseColourScaleAttr, r as PlotDataSeries, s as readBaseColour, t as PlotXyAxis, u as __exportAll } from "./xy-axis-DL0tfJDr.js";
+import { a as toStringAbbreviate, c as isEqualDefault, l as isEqualValueDefault, o as defaultComparer, r as isPrimitive, u as isEqualValueIgnoreOrder } from "./dist-BX0OVIm7.js";
+import { n as ColourPicker, t as ColourPickerPopup } from "./colour-picker-K6zu82lm.js";
 import { LabelledRangeInput } from "./labelled-range-input.js";
-import { t as TreeDataModel } from "./tree-data-model-DGvRVOFY.js";
-import { a as createFuzzySearch, i as createAcCompletionProvider, n as IncrSearchTreeController, r as createIncrSearch, t as createElementIncrSearch } from "./incr-search-BZawvrfl.js";
+import { i as TreeDataModel, n as TreeController, r as TreeBaseElement, t as TreeListElement } from "./tree-CvvKbO-f.js";
 import { NarrowedTextElement } from "./narrowed-text.js";
 import { CrumbNavigationElement } from "./crumbs.js";
 import { DataDisplayComponent } from "./data-display.js";
 import { EditableLabel } from "./editable-label.js";
 import { t as resolveStep } from "./keyboard-De_vOHLg.js";
-import { t as IxfxHexEditorElement } from "./hex-editor-gH3mteMr.js";
-import { t as RadialInputElement } from "./radial-input-Dbc6fgCK.js";
+import { t as IxfxHexEditorElement } from "./hex-editor-CsN_ySkH.js";
+import { t as RadialInputElement } from "./radial-input-DZA6WaFu.js";
 import { LabelledRadialInput } from "./labelled-radial-input.js";
 import { LedElement } from "./led.js";
-import { t as menu_exports } from "./menu-C3eANB5M.js";
+import { t as menu_exports } from "./menu-DJJuCm-5.js";
 import { MillerBaseElement, MillerListElement, MillerTreeController } from "./miller.js";
 import { PanelElement } from "./panel.js";
 import { PolarPad } from "./polar-pad.js";
@@ -39,14 +39,633 @@ import { SnapContainer } from "./snap-container.js";
 import { SplitLayoutElement } from "./split-layout.js";
 import { SwipeElement } from "./swipe.js";
 import { TabListElement } from "./tabs.js";
-import { a as attachTimelineInteractions, i as timelineStyles, n as IxfxTimelineElement, o as resolveCssVars, r as TimelineTrackTabElement, s as resolveGrid, t as TimelineController } from "./timeline-B62Sz6J_.js";
-import { TreeBaseElement, TreeController, TreeListElement } from "./tree.js";
+import { a as resolveCssVars, i as attachTimelineInteractions, n as TimelineTrackTabElement, o as resolveGrid, r as timelineStyles, s as TimelineController, t as IxfxTimelineElement } from "./timeline-Cv75Th2U.js";
 import { XyPad } from "./xy-pad.js";
 import { LitElement, css, html, nothing } from "lit";
 import { eventOptions, property, query, queryAssignedElements, state } from "lit/decorators.js";
 import { unsafeHTML } from "lit/directives/unsafe-html.js";
 import { keyed } from "lit/directives/keyed.js";
 import { classMap } from "lit/directives/class-map.js";
+//#region src/ac-token/ac-token.ts
+const DEFAULT_TOKENIZER = (text) => text.split(/[\s,;]+/);
+function makeLruCache(maxSize) {
+	const map = /* @__PURE__ */ new Map();
+	return {
+		get: (k) => map.get(k),
+		set: (k, v) => {
+			if (map.has(k)) map.delete(k);
+			map.set(k, v);
+			if (map.size > maxSize) map.delete(map.keys().next().value);
+		},
+		has: (k) => map.has(k),
+		clear: () => map.clear()
+	};
+}
+let AcTokenElement = class AcTokenElement extends LitElement {
+	#cache;
+	#debounceTimer;
+	#abortController;
+	#staticProvider;
+	constructor() {
+		super();
+		this.placeholder = ``;
+		this.cacheSize = 20;
+		this.debounceMs = 150;
+		this.strict = false;
+		this._tokens = [];
+		this._draft = ``;
+		this._suggestions = [];
+		this._isOpen = false;
+		this._isLoading = false;
+		this._tickled = new TickledController(this, { getItems: () => this._suggestions.map((_, i) => ({
+			id: i,
+			enabled: true
+		})) });
+		this.#cache = makeLruCache(20);
+		this.#onWrapperClick = (e) => {
+			if (!e.target.closest(`.token-chip`)) this.shadowRoot?.querySelector(`input.draft`)?.focus();
+		};
+		this.#onFocus = () => {
+			this._selectedTokenIndex = void 0;
+			this.#scheduleSuggestionFetch(this._draft);
+		};
+		this.#onBlur = () => {
+			setTimeout(() => {
+				this._isOpen = false;
+				this._tickled.clearTickled();
+				this._selectedTokenIndex = void 0;
+			}, 120);
+		};
+		this.#onInput = (e) => {
+			const value = e.target.value;
+			this._selectedTokenIndex = void 0;
+			const parts = (this.tokenizer ?? DEFAULT_TOKENIZER)(value);
+			if (parts.length > 1) {
+				for (let i = 0; i < parts.length - 1; i++) {
+					const label = parts[i].trim();
+					if (label) this.#addToken({ label });
+				}
+				this._draft = parts[parts.length - 1] ?? ``;
+			} else this._draft = value;
+			this.#scheduleSuggestionFetch(this._draft);
+		};
+		this.#onKeyDown = (e) => {
+			const input = e.target;
+			if ((e.metaKey || e.ctrlKey) && e.key === `a`) {
+				e.preventDefault();
+				const parts = [...this._tokens.map((t) => t.label), this._draft.trim()].filter(Boolean);
+				navigator.clipboard.writeText(parts.join(` `)).catch(() => {});
+				return;
+			}
+			if (this._selectedTokenIndex !== void 0 && e.key.length === 1 && !e.metaKey && !e.ctrlKey && !e.altKey) {
+				e.preventDefault();
+				this.#startEditingSelectedToken(e.key);
+				return;
+			}
+			this.#handleNavigationKey(e, input);
+		};
+		this.#onPaste = (e) => {
+			e.preventDefault();
+			const text = e.clipboardData?.getData(`text/plain`) ?? ``;
+			if (!text) return;
+			const parts = (this.tokenizer ?? DEFAULT_TOKENIZER)(this._draft + text).filter(Boolean);
+			if (parts.length === 0) return;
+			if (parts.length === 1) this._draft = parts[0];
+			else {
+				for (let i = 0; i < parts.length - 1; i++) {
+					const label = parts[i].trim();
+					if (label) this.#addToken({ label });
+				}
+				this._draft = parts[parts.length - 1] ?? ``;
+			}
+			this.updateComplete.then(() => {
+				this.shadowRoot?.querySelector(`input.draft`)?.setSelectionRange(this._draft.length, this._draft.length);
+			});
+			this.#scheduleSuggestionFetch(this._draft);
+		};
+		this.#onSuggestionPointerDown = (e, item) => {
+			e.preventDefault();
+			this.#selectSuggestion(item);
+		};
+		this.#onChipPointerDown = (e, index) => {
+			if (e.button !== 0) return;
+			e.preventDefault();
+			const el = e.currentTarget;
+			const startY = e.clientY;
+			let dragged = false;
+			el.setPointerCapture(e.pointerId);
+			const cleanup = () => {
+				el.removeEventListener(`pointermove`, onMove);
+				el.removeEventListener(`pointerup`, onUp);
+			};
+			const onMove = (me) => {
+				if (Math.abs(me.clientY - startY) > 28) {
+					dragged = true;
+					el.releasePointerCapture(me.pointerId);
+					cleanup();
+					this.#removeToken(index);
+					this.shadowRoot?.querySelector(`input.draft`)?.focus();
+				}
+			};
+			const onUp = () => {
+				cleanup();
+				if (!dragged) {
+					this._selectedTokenIndex = this._selectedTokenIndex === index ? void 0 : index;
+					this.shadowRoot?.querySelector(`input.draft`)?.focus();
+				}
+			};
+			el.addEventListener(`pointermove`, onMove);
+			el.addEventListener(`pointerup`, onUp);
+		};
+		this.#cache = makeLruCache(this.cacheSize);
+	}
+	get tokens() {
+		return this._tokens;
+	}
+	set tokens(value) {
+		this._tokens = [...value];
+		this.#emitChange();
+	}
+	/** All committed token labels joined with commas. */
+	get value() {
+		return this._tokens.map((t) => t.label).join(`, `);
+	}
+	connectedCallback() {
+		super.connectedCallback();
+		this.#buildStaticProvider();
+	}
+	disconnectedCallback() {
+		super.disconnectedCallback();
+		this.#cancelPending();
+	}
+	updated(changedProps) {
+		if (changedProps.has(`completionProvider`) || changedProps.has(`cacheSize`)) this.#cache = makeLruCache(this.cacheSize);
+		if (changedProps.has(`completionProvider`)) this.#buildStaticProvider();
+	}
+	#buildStaticProvider() {
+		const raw = this.getAttribute(`data-tokens`);
+		if (!raw || this.completionProvider) {
+			this.#staticProvider = void 0;
+			return;
+		}
+		const items = raw.trim().split(/[\s,;]+/).filter(Boolean).map((label) => ({ label }));
+		this.#staticProvider = createAcCompletionProvider(items);
+	}
+	#onWrapperClick;
+	#onFocus;
+	#onBlur;
+	#onInput;
+	#onKeyDown;
+	#handleNavigationKey(e, input) {
+		switch (e.key) {
+			case `ArrowLeft`:
+				if (input.selectionStart === 0 && input.selectionEnd === 0) {
+					e.preventDefault();
+					if (this._selectedTokenIndex === void 0) {
+						if (this._tokens.length > 0) this._selectedTokenIndex = this._tokens.length - 1;
+					} else if (this._selectedTokenIndex > 0) this._selectedTokenIndex--;
+				}
+				break;
+			case `ArrowRight`:
+				if (this._selectedTokenIndex !== void 0) {
+					e.preventDefault();
+					if (this._selectedTokenIndex < this._tokens.length - 1) this._selectedTokenIndex++;
+					else this._selectedTokenIndex = void 0;
+				}
+				break;
+			case `Backspace`:
+				if (input.selectionStart === 0 && input.selectionEnd === 0) {
+					e.preventDefault();
+					if (this._selectedTokenIndex !== void 0) this.#removeToken(this._selectedTokenIndex);
+					else if (this._tokens.length > 0) this.#removeToken(this._tokens.length - 1);
+				}
+				break;
+			case `Enter`: {
+				const tickledIdx = this._tickled.tickledId;
+				if (this._isOpen && tickledIdx !== void 0 && this._suggestions[tickledIdx]) {
+					e.preventDefault();
+					this.#selectSuggestion(this._suggestions[tickledIdx]);
+				} else if (!this.strict && this._draft.trim()) {
+					e.preventDefault();
+					this.#addToken({ label: this._draft.trim() });
+					this._draft = ``;
+					this.#closePopup();
+				}
+				break;
+			}
+			case `ArrowDown`:
+				if (!this._isOpen) return;
+				e.preventDefault();
+				this._tickled.handleKeyboardNavigation(`next`);
+				this.#scrollSuggestionIntoView();
+				break;
+			case `ArrowUp`:
+				if (!this._isOpen) return;
+				e.preventDefault();
+				this._tickled.handleKeyboardNavigation(`previous`);
+				this.#scrollSuggestionIntoView();
+				break;
+			case `Escape`:
+				e.preventDefault();
+				this.#closePopup();
+				this._selectedTokenIndex = void 0;
+				break;
+		}
+	}
+	#onPaste;
+	#onSuggestionPointerDown;
+	#onChipPointerDown;
+	#startEditingSelectedToken(key) {
+		const idx = this._selectedTokenIndex;
+		if (idx === void 0) return;
+		const token = this._tokens[idx];
+		if (!token) return;
+		const newDraft = token.label + key;
+		this.#removeToken(idx);
+		this._selectedTokenIndex = void 0;
+		this._draft = newDraft;
+		this.updateComplete.then(() => {
+			const inp = this.shadowRoot?.querySelector(`input.draft`);
+			if (!inp) return;
+			inp.setSelectionRange(inp.value.length, inp.value.length);
+		});
+		this.#scheduleSuggestionFetch(newDraft);
+	}
+	#addToken(item) {
+		const index = this._tokens.length;
+		this._tokens = [...this._tokens, item];
+		this.dispatchEvent(new CustomEvent(`ac-token-add`, {
+			detail: {
+				item,
+				index
+			},
+			bubbles: true,
+			composed: true
+		}));
+		this.#emitChange();
+	}
+	#removeToken(index) {
+		const item = this._tokens[index];
+		if (!item) return;
+		this._tokens = this._tokens.filter((_, i) => i !== index);
+		if (this._selectedTokenIndex !== void 0) {
+			if (this._selectedTokenIndex === index) this._selectedTokenIndex = void 0;
+			else if (this._selectedTokenIndex > index) this._selectedTokenIndex--;
+		}
+		this.dispatchEvent(new CustomEvent(`ac-token-remove`, {
+			detail: {
+				item,
+				index
+			},
+			bubbles: true,
+			composed: true
+		}));
+		this.#emitChange();
+	}
+	#selectSuggestion(item) {
+		this.#addToken(item);
+		this._draft = ``;
+		this.#closePopup();
+	}
+	#emitChange() {
+		this.dispatchEvent(new CustomEvent(`ac-token-change`, {
+			detail: { tokens: this._tokens },
+			bubbles: true,
+			composed: true
+		}));
+	}
+	#closePopup() {
+		this._isOpen = false;
+		this._tickled.clearTickled();
+	}
+	#cancelPending() {
+		if (this.#debounceTimer !== void 0) {
+			clearTimeout(this.#debounceTimer);
+			this.#debounceTimer = void 0;
+		}
+		this.#abortController?.abort();
+		this.#abortController = void 0;
+		this._isLoading = false;
+	}
+	#scheduleSuggestionFetch(query) {
+		const provider = this.completionProvider ?? this.#staticProvider;
+		if (!provider) {
+			this._isOpen = false;
+			return;
+		}
+		if (this.#debounceTimer !== void 0) clearTimeout(this.#debounceTimer);
+		this._isOpen = true;
+		this.#debounceTimer = setTimeout(() => {
+			this.#fetchSuggestions(query, provider);
+		}, this.debounceMs);
+	}
+	#fetchSuggestions(query, provider) {
+		const cached = this.#cache.get(query);
+		if (cached !== void 0) {
+			this._suggestions = cached;
+			this._tickled.clearTickled();
+			this._isLoading = false;
+			return;
+		}
+		this.#abortController?.abort();
+		this.#abortController = new AbortController();
+		const { signal } = this.#abortController;
+		this._isLoading = true;
+		Promise.resolve(provider(query, signal)).then((results) => {
+			if (signal.aborted) return;
+			this.#cache.set(query, results);
+			this._suggestions = results;
+			this._tickled.clearTickled();
+			this._isLoading = false;
+		}).catch((err) => {
+			if (signal.aborted) return;
+			console.error(`[ixfx-ac-token] completionProvider error:`, err);
+			this._suggestions = [];
+			this._isLoading = false;
+		});
+	}
+	#scrollSuggestionIntoView() {
+		this.updateComplete.then(() => {
+			this.shadowRoot?.querySelector(`.suggestion.tickled`)?.scrollIntoView({ block: `nearest` });
+		});
+	}
+	#renderChip(item, index) {
+		return html`
+      <span
+        class="token-chip ${this._selectedTokenIndex === index ? `selected` : ``}"
+        title=${item.subLabel ?? nothing}
+        @pointerdown=${(e) => this.#onChipPointerDown(e, index)}
+      >
+        ${item.icon ? html`<ixfx-icon class="chip-icon" name=${item.icon}></ixfx-icon>` : nothing}
+        <span class="chip-label">${item.label}</span>
+      </span>
+    `;
+	}
+	#renderSuggestion(item, index) {
+		const isTickled = this._tickled.isTickled(index);
+		return html`
+      <div
+        class="suggestion ${isTickled ? `tickled` : ``}"
+        role="option"
+        id="ac-token-sugg-${index}"
+        aria-selected=${isTickled}
+        @pointerenter=${() => this._tickled.handlePointerEnter(index)}
+        @pointerdown=${(e) => this.#onSuggestionPointerDown(e, item)}
+      >
+        ${item.icon ? html`<ixfx-icon class="sugg-icon" name=${item.icon}></ixfx-icon>` : nothing}
+        <span class="sugg-label">${item.label}</span>
+        ${item.subLabel ? html`<span class="sugg-sublabel">${item.subLabel}</span>` : nothing}
+      </div>
+    `;
+	}
+	#renderPopup() {
+		const showEmpty = !this._isLoading && this._suggestions.length === 0;
+		return html`
+      <div
+        class="popup"
+        role="listbox"
+        aria-label="Suggestions"
+        data-input-mode=${this._tickled.inputMode}
+        @pointerleave=${(e) => this._tickled.handlePointerLeave(e)}
+      >
+        ${showEmpty ? html`<div class="no-results">No matching results</div>` : this._suggestions.map((item, i) => this.#renderSuggestion(item, i))}
+      </div>
+    `;
+	}
+	render() {
+		const tickledIdx = this._tickled.tickledId ?? -1;
+		const activeDescendant = tickledIdx >= 0 ? `ac-token-sugg-${tickledIdx}` : void 0;
+		const showPlaceholder = this._tokens.length === 0 ? this.placeholder || nothing : nothing;
+		return html`
+      <div class="wrapper" @click=${this.#onWrapperClick}>
+        ${this._tokens.map((t, i) => this.#renderChip(t, i))}
+        <input
+          type="text"
+          class="draft"
+          .value=${this._draft}
+          placeholder=${showPlaceholder}
+          autocomplete="off"
+          spellcheck="false"
+          role="combobox"
+          aria-autocomplete="list"
+          aria-expanded=${this._isOpen}
+          aria-activedescendant=${activeDescendant ?? nothing}
+          @input=${this.#onInput}
+          @keydown=${this.#onKeyDown}
+          @focus=${this.#onFocus}
+          @blur=${this.#onBlur}
+          @paste=${this.#onPaste}
+        >
+        ${this._isLoading ? html`<span class="spinner" aria-hidden="true"></span>` : nothing}
+      </div>
+      ${this._isOpen ? this.#renderPopup() : nothing}
+    `;
+	}
+	static {
+		this.styles = [tickledStyles, css`
+    :host {
+      display: block;
+      position: relative;
+      font-family: var(--font-family, system-ui, sans-serif);
+      font-size: var(--text-m, 12px);
+      color: var(--surface-2-text);
+    }
+
+    /* ---- Wrapper (looks like a text input) ---- */
+
+    .wrapper {
+      display: flex;
+      flex-wrap: wrap;
+      align-items: center;
+      gap: var(--ac-token-chip-gap, var(--space-xs, 3px));
+      padding: var(--ac-token-input-padding, var(--space-xs, 3px) var(--space-m, 8px));
+      background: var(--ac-token-input-background, var(--surface-3, var(--surface-2)));
+      color: var(--surface-2-text);
+      border: var(--ac-token-input-border, var(--border));
+      border-radius: var(--ac-token-input-border-radius, var(--radius-m, 4px));
+      cursor: text;
+      min-height: 32px;
+      box-sizing: border-box;
+      transition: border-color var(--transition, 0.15s ease-out);
+    }
+
+    .wrapper:focus-within {
+      border-color: var(--accent);
+    }
+
+    /* ---- Token chips ---- */
+
+    .token-chip {
+      display: inline-flex;
+      align-items: center;
+      gap: var(--space-xs, 3px);
+      padding: 1px var(--space-m, 8px);
+      background: var(--ac-token-chip-background, var(--surface-4));
+      border: var(--ac-token-chip-border, var(--border));
+      border-radius: var(--ac-token-chip-border-radius, var(--radius-s, 3px));
+      user-select: none;
+      cursor: default;
+      font-size: var(--text-s, 11px);
+      white-space: nowrap;
+      touch-action: none;
+      transition:
+        background var(--transition, 0.1s ease-out),
+        border-color var(--transition, 0.1s ease-out),
+        color var(--transition, 0.1s ease-out);
+    }
+
+    .token-chip.selected {
+      background: var(--ac-token-chip-selected-background, var(--accent));
+      color: var(--ac-token-chip-selected-color, var(--accent-text, #fff));
+      border-color: var(--accent);
+    }
+
+    .chip-icon {
+      flex-shrink: 0;
+      width: 1em;
+      height: 1em;
+    }
+
+    /* ---- Draft input ---- */
+
+    input.draft {
+      flex: 1;
+      min-width: 60px;
+      border: none;
+      background: transparent;
+      color: inherit;
+      font: inherit;
+      outline: none;
+      caret-color: var(--accent);
+      padding: 1px 0;
+      anchor-name: --ac-token-draft;
+    }
+
+    input.draft::placeholder {
+      color: var(--surface-muted-text);
+    }
+
+    /* ---- Spinner ---- */
+
+    .spinner {
+      width: 12px;
+      height: 12px;
+      border: 2px solid var(--surface-5);
+      border-top-color: var(--accent);
+      border-radius: 50%;
+      animation: ac-token-spin 0.7s linear infinite;
+      flex-shrink: 0;
+      pointer-events: none;
+      margin-left: var(--space-xs, 3px);
+    }
+
+    @keyframes ac-token-spin {
+      to { transform: rotate(360deg); }
+    }
+
+    /* ---- Popup ---- */
+
+    .popup {
+      position: fixed;
+      position-anchor: --ac-token-draft;
+      top: anchor(bottom);
+      left: anchor(left);
+      margin-top: 2px;
+      position-try-fallbacks: --ac-token-popup-above;
+      z-index: 200;
+      background: var(--surface-3, var(--surface-2));
+      border: var(--border);
+      border-radius: var(--radius-m, 4px);
+      box-shadow: var(--shadow-l, 0 4px 24px rgba(0, 0, 0, 0.5));
+      padding: var(--space-xs, 3px) 0;
+      max-height: 260px;
+      min-width: 160px;
+      overflow-y: auto;
+      font-size: var(--ac-token-popup-font-size, var(--text-s, 11px));
+    }
+
+    @position-try --ac-token-popup-above {
+      top: auto;
+      bottom: anchor(top);
+      left: anchor(left);
+      margin-top: 0;
+      margin-bottom: 2px;
+    }
+
+    /* ---- Suggestion items ---- */
+
+    .suggestion {
+      display: flex;
+      align-items: center;
+      gap: var(--space-m, 8px);
+      padding: var(--space-xs, 3px) var(--space-l, 12px);
+      cursor: pointer;
+      border-radius: var(--radius-s, 3px);
+      margin: 0 var(--space-xs, 3px);
+      transition: background var(--transition, 0.1s ease-out);
+      user-select: none;
+      white-space: nowrap;
+      min-height: 28px;
+    }
+
+    .suggestion.tickled {
+      background: var(--_item-focused-bg, var(--accent));
+      color: var(--accent-text, #fff);
+    }
+
+    .suggestion.tickled .sugg-sublabel {
+      color: color-mix(in srgb, var(--accent-text, #fff) 70%, transparent);
+    }
+
+    .sugg-icon {
+      flex-shrink: 0;
+      width: 1em;
+      height: 1em;
+    }
+
+    .sugg-label {
+      flex: 1;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+
+    .sugg-sublabel {
+      flex-shrink: 0;
+      margin-left: auto;
+      color: var(--surface-muted-text);
+      font-size: var(--text-s, 11px);
+    }
+
+    /* ---- Empty state ---- */
+
+    .no-results {
+      padding: var(--space-m, 8px) var(--space-l, 12px);
+      color: var(--surface-muted-text);
+      font-style: italic;
+    }
+  `];
+	}
+};
+__decorate([property({ type: Object })], AcTokenElement.prototype, "completionProvider", void 0);
+__decorate([property({ type: Object })], AcTokenElement.prototype, "tokenizer", void 0);
+__decorate([property({ type: String })], AcTokenElement.prototype, "placeholder", void 0);
+__decorate([property({
+	type: Number,
+	attribute: `cache-size`
+})], AcTokenElement.prototype, "cacheSize", void 0);
+__decorate([property({
+	type: Number,
+	attribute: `debounce-ms`
+})], AcTokenElement.prototype, "debounceMs", void 0);
+__decorate([property({ type: Boolean })], AcTokenElement.prototype, "strict", void 0);
+__decorate([state()], AcTokenElement.prototype, "_tokens", void 0);
+__decorate([state()], AcTokenElement.prototype, "_draft", void 0);
+__decorate([state()], AcTokenElement.prototype, "_selectedTokenIndex", void 0);
+__decorate([state()], AcTokenElement.prototype, "_suggestions", void 0);
+__decorate([state()], AcTokenElement.prototype, "_isOpen", void 0);
+__decorate([state()], AcTokenElement.prototype, "_isLoading", void 0);
+AcTokenElement = __decorate([safeCustomElement(`ixfx-ac-token`)], AcTokenElement);
+//#endregion
 //#region src/button/radio-group.ts
 let RadioGroup = class RadioGroup extends LitElement {
 	constructor(..._args) {
@@ -5409,16 +6028,19 @@ let TabListItemElement = class TabListItemElement extends LitElement {
       <div>
         ${this.iconName ? html`<ixfx-icon name="${this.iconName}"></ixfx-icon>` : nothing}
         ${showLabel ? html`<span class="label"><slot></slot></span>` : nothing}
-        ${this.closeable ? html`
-          <button
-            class="close-btn"
-            type="button"
-            aria-label="Close tab"
-            @click=${this._onCloseClick}
-          >
-            <ixfx-icon name="close"></ixfx-icon>
-          </button>
-        ` : nothing}
+        <div class="actions">
+          <div class="toolbar"><slot name="toolbar"></slot></div>
+          ${this.closeable ? html`
+            <button
+              class="close-btn"
+              type="button"
+              aria-label="Close tab"
+              @click=${this._onCloseClick}
+            >
+              <ixfx-icon name="close"></ixfx-icon>
+            </button>
+          ` : nothing}
+        </div>
       </div>
     `;
 	}
@@ -5442,7 +6064,7 @@ let TabListItemElement = class TabListItemElement extends LitElement {
         box-sizing: border-box;
       }
 
-      div {
+      :host > div {
         display: flex;
         align-items: center;
         gap: var(--space-s, 4px);
@@ -5473,6 +6095,28 @@ let TabListItemElement = class TabListItemElement extends LitElement {
         flex-shrink: 0;
       }
 
+      .actions {
+        display: flex;
+        align-items: center;
+        gap: var(--space-xs);
+        margin-left: auto;
+        flex-shrink: 0;
+      }
+
+      .toolbar {
+        display: none;
+        align-items: center;
+        gap: var(--space-xs);
+      }
+
+      :host([selected]) .toolbar {
+        display: flex;
+      }
+
+      slot[name="toolbar"] {
+        display: contents;
+      }
+
       .close-btn {
         display: inline-flex;
         align-items: center;
@@ -5480,7 +6124,6 @@ let TabListItemElement = class TabListItemElement extends LitElement {
         background: none;
         border: none;
         padding: var(--space-xs);
-        margin-left: auto;
         cursor: pointer;
         color: inherit;
         border-radius: var(--radius-s);
@@ -5562,14 +6205,17 @@ let TabPanelsElement = class TabPanelsElement extends LitElement {
 		if (this.onSelectedPanel) this.onSelectedPanel(el.id, el);
 	}
 	syncWithList(el) {
+		const apply = (t) => {
+			if (!t) return;
+			const forEl = t.getAttribute(`for`);
+			if (forEl) this.selectPanel(forEl);
+		};
 		const t = el.getSelectedElement();
 		if (!t) {
-			el.updateComplete.then(() => this.syncWithList(el));
+			el.updateComplete.then(() => apply(el.getSelectedElement()));
 			return;
 		}
-		const forEl = t.getAttribute(`for`);
-		if (!forEl) return;
-		this.selectPanel(forEl);
+		apply(t);
 	}
 	selectPanel(id) {
 		const current = this.getSelectedElement();
@@ -5967,7 +6613,9 @@ TooltipElement = _TooltipElement = __decorate([safeCustomElement(`ixfx-tooltip`)
 //#endregion
 //#region src/vertical-list/vertical-list.ts
 const ITEM_SELECTOR = `li, [data-list-item]`;
-const isMultiMode = (mode) => mode === `checked` || mode === `vscode` || mode === `standard`;
+function isMultiMode(mode) {
+	return mode === `checked` || mode === `vscode` || mode === `standard`;
+}
 let VerticalListElement = class VerticalListElement extends LitElement {
 	constructor(..._args) {
 		super(..._args);
@@ -5976,6 +6624,7 @@ let VerticalListElement = class VerticalListElement extends LitElement {
 		this._selectedItems = /* @__PURE__ */ new Set();
 		this._searchVisible = false;
 		this._searchQuery = ``;
+		this.#customWrappers = /* @__PURE__ */ new Map();
 		this.tickled = new TickledController(this, {
 			getItems: () => this._getVisibleItems().map((el) => ({
 				id: el,
@@ -6085,6 +6734,7 @@ let VerticalListElement = class VerticalListElement extends LitElement {
 	}
 	#search;
 	#selectionAnchor;
+	#customWrappers;
 	connectedCallback() {
 		super.connectedCallback();
 		if (!this.hasAttribute(`tabindex`)) this.tabIndex = 0;
@@ -6117,9 +6767,29 @@ let VerticalListElement = class VerticalListElement extends LitElement {
 		super.updated(changed);
 		if (changed.has(`interactionMode`)) {
 			this.#selectionAnchor = void 0;
-			this._clearSelection();
+			const previousSelected = this._selectedItems;
+			const savedWrappers = changed.get(`interactionMode`) === `checked` ? new Map(this.#customWrappers) : null;
+			this._syncCheckboxes();
+			if (previousSelected.size > 0) {
+				let remapped;
+				if (savedWrappers && savedWrappers.size > 0) remapped = new Set([...previousSelected].map((el) => savedWrappers.get(el) ?? el));
+				else if (this.#customWrappers.size > 0) {
+					const innerToWrapper = new Map([...this.#customWrappers].map(([w, i]) => [i, w]));
+					remapped = new Set([...previousSelected].map((el) => innerToWrapper.get(el) ?? el));
+				} else remapped = new Set(previousSelected);
+				this._selectedItems = remapped;
+			}
+			this._syncItemStates();
 		}
 	}
+	/** The most recently selected item, or `undefined` if nothing is selected. */
+	get selectedItem() {
+		return [...this._selectedItems].at(-1);
+	}
+	/** The full current selection set (read-only). */
+	get selectedItems() {
+		return this._selectedItems;
+	}
 	addItem(item) {
 		if (typeof item === `string`) {
 			const li = document.createElement(`li`);
@@ -6132,6 +6802,7 @@ let VerticalListElement = class VerticalListElement extends LitElement {
 		item.remove();
 	}
 	clearItems() {
+		this.#customWrappers.clear();
 		this.replaceChildren();
 		this.#selectionAnchor = void 0;
 		this._selectedItems = /* @__PURE__ */ new Set();
@@ -6140,6 +6811,19 @@ let VerticalListElement = class VerticalListElement extends LitElement {
 	select(item) {
 		this._replaceSelection(item);
 	}
+	selectMany(items) {
+		if (this.selectionMode !== `multiple`) throw new Error(`selectMany requires selectionMode="multiple" (current: "${this.selectionMode}")`);
+		const previous = this._selectedItems;
+		const next = new Set(items);
+		if (next.size === 0) return;
+		this._selectedItems = next;
+		this.#selectionAnchor = [...next].at(-1);
+		this._syncItemStates();
+		this._dispatch(`list-select`, {
+			selected: next,
+			previous
+		});
+	}
 	deselect(item) {
 		if (!this._selectedItems.has(item)) return;
 		const previous = this._selectedItems;
@@ -6271,11 +6955,34 @@ let VerticalListElement = class VerticalListElement extends LitElement {
 			if (this.interactionMode === `checked`) el.toggleAttribute(`data-checked`, this._selectedItems.has(el));
 			else el.removeAttribute(`data-checked`);
 		}
-		this.dataset[`inputMode`] = this.tickled.inputMode;
+		this.dataset.inputMode = this.tickled.inputMode;
 		this._syncCheckboxes();
 	}
 	_syncCheckboxes() {
 		const inCheckedMode = this.interactionMode === `checked`;
+		if (inCheckedMode) for (const inner of Array.from(this.children)) {
+			if (!inner.hasAttribute(`data-list-item`)) continue;
+			if (inner.parentElement !== this) continue;
+			const wrapper = document.createElement(`li`);
+			wrapper.className = `ixfx-custom-row`;
+			const key = inner.getAttribute(`data-key`);
+			const label = inner.getAttribute(`data-search-label`);
+			if (key !== null) wrapper.setAttribute(`data-key`, key);
+			if (label !== null) wrapper.setAttribute(`data-search-label`, label);
+			inner.removeAttribute(`data-list-item`);
+			this.insertBefore(wrapper, inner);
+			wrapper.appendChild(inner);
+			this.#customWrappers.set(wrapper, inner);
+		}
+		else {
+			for (const [wrapper, inner] of this.#customWrappers) {
+				if (wrapper.parentElement !== this) continue;
+				inner.setAttribute(`data-list-item`, ``);
+				this.insertBefore(inner, wrapper);
+				wrapper.remove();
+			}
+			this.#customWrappers.clear();
+		}
 		for (const el of this.querySelectorAll(`li`)) {
 			let cb = el.querySelector(`input.ixfx-list-checkbox`);
 			if (inCheckedMode) {
@@ -6417,17 +7124,6 @@ let VerticalListElement = class VerticalListElement extends LitElement {
       outline: 1px solid var(--accent, #60a5fa);
     }
 
-    /* checked mode: left-border indicator for custom shadow-DOM items (no checkbox injection possible) */
-    :host([interaction-mode="checked"]) ::slotted([data-list-item]) {
-      border-left: 3px solid transparent;
-      transition: background var(--transition, 0.1s ease-out),
-                  border-color var(--transition, 0.1s ease-out);
-    }
-
-    :host([interaction-mode="checked"]) ::slotted([data-list-item][data-checked]) {
-      border-left: 3px solid var(--accent, #60a5fa);
-    }
-
     .search-overlay {
       position: absolute;
       top: 8px;
@@ -6516,6 +7212,6 @@ function init() {
 	console.log(`Init`);
 }
 //#endregion
-export { AcTextElement, ButtonElement, Checkbox, ColourPicker, ColourPickerPopup, CrumbNavigationElement, CrumbPathController, CrumbPathElement, DataDisplayComponent, EditableLabel, EditableNumber, ICON_CARET_RIGHT, ICON_CHECK, ICON_CHEVRON_DOWN, ICON_CLOSE, IncrSearchTreeController as IncrSearchMillerController, IncrSearchTreeController, IxfxHexEditorElement, IxfxIconElement, IxfxTimelineElement, LabelledRadialInput, LabelledRangeInput, LedElement, menu_exports as Menu, MillerBaseElement, MillerListElement, MillerTreeController, NarrowedTextElement, PanelElement, PanelGroupElement, PlotDataSeries, PlotSingleAxis, PlotXyAxis, PolarPad, RadialInputElement, RadioGroup, RangeElement, RangeInput, RangeMultiElement, SelectHorizontalElement, SnapContainer, SplitButton, SplitLayoutElement, SwipeElement, TabListElement, TabListItemElement, TabPanelElement, TabPanelsElement, TimelineController, TimelineTrackTabElement, TooltipElement, TransitoryLabelElement, TreeBaseElement, TreeController, TreeDataModel, TreeListElement, VerticalListElement, XyPad, applyAgeModification, applyHighlights, attachTimelineInteractions, buildHighlightTargets, clearHighlights, computeColour, createAcCompletionProvider, createElementIncrSearch, createFuzzySearch, createIncrSearch, getIcon, hasIcon, iconBus, init, monitorIndeterminate, parseColourScaleAttr, readBaseColour, registerIcon, resolveCssVars, resolveGrid, svgToDataUri, timelineStyles };
+export { AcTextElement, AcTokenElement, ButtonElement, Checkbox, ColourPicker, ColourPickerPopup, CrumbNavigationElement, CrumbPathController, CrumbPathElement, DataDisplayComponent, EditableLabel, EditableNumber, ICON_CARET_RIGHT, ICON_CHECK, ICON_CHEVRON_DOWN, ICON_CLOSE, IncrSearchTreeController as IncrSearchMillerController, IncrSearchTreeController, IxfxHexEditorElement, IxfxIconElement, IxfxTimelineElement, LabelledRadialInput, LabelledRangeInput, LedElement, menu_exports as Menu, MillerBaseElement, MillerListElement, MillerTreeController, NarrowedTextElement, PanelElement, PanelGroupElement, PlotDataSeries, PlotSingleAxis, PlotXyAxis, PolarPad, RadialInputElement, RadioGroup, RangeElement, RangeInput, RangeMultiElement, SelectHorizontalElement, SnapContainer, SplitButton, SplitLayoutElement, SwipeElement, TabListElement, TabListItemElement, TabPanelElement, TabPanelsElement, TimelineController, TimelineTrackTabElement, TooltipElement, TransitoryLabelElement, TreeBaseElement, TreeController, TreeDataModel, TreeListElement, VerticalListElement, XyPad, applyAgeModification, applyHighlights, attachTimelineInteractions, buildHighlightTargets, clearHighlights, computeColour, createAcCompletionProvider, createElementIncrSearch, createFuzzySearch, createIncrSearch, getIcon, hasIcon, iconBus, init, monitorIndeterminate, parseColourScaleAttr, readBaseColour, registerIcon, resolveCssVars, resolveGrid, svgToDataUri, timelineStyles };
 
 //# sourceMappingURL=index.js.map