@ixfx/components 0.2.3 → 0.2.5

package/dist/incr-search-BjCNClnC.js

@@ -0,0 +1,311 @@
+import { n as buildHighlightTargets, r as clearHighlights, t as applyHighlights } from "./highlight-CAjwQ4GE.js";
+import { Fzf } from "fzf";
+//#region src/incr-search/fuzzy.ts
+const defaultSelector = (item) => {
+	if (typeof item === `string`) return item;
+	const r = item;
+	if (typeof r[`label`] === `string`) return r[`label`];
+	if (typeof r[`key`] === `string`) return r[`key`];
+	if (typeof r[`value`] === `string`) return r[`value`];
+	return String(item);
+};
+function createFuzzySearch(items, options = {}) {
+	const fzf = new Fzf(items, {
+		selector: options.selector ?? defaultSelector,
+		...options.fzf ?? {}
+	});
+	const find = (query) => {
+		if (!query.trim()) return items.map((item) => ({
+			item,
+			positions: /* @__PURE__ */ new Set(),
+			score: 0
+		}));
+		return fzf.find(query).map((r) => ({
+			item: r.item,
+			positions: r.positions,
+			score: r.score
+		}));
+	};
+	return {
+		find,
+		items
+	};
+}
+//#endregion
+//#region src/incr-search/incr-search.ts
+const buildState = (results, query) => {
+	const positionsByItem = /* @__PURE__ */ new Map();
+	for (const r of results) positionsByItem.set(r.item, r.positions);
+	return Object.freeze({
+		query,
+		results: Object.freeze([...results]),
+		positionsByItem
+	});
+};
+function createIncrSearch(options = {}) {
+	let items = options.items ?? [];
+	let query = ``;
+	let fuzzy = createFuzzySearch(items, {
+		selector: options.selector,
+		fzf: options.fzf
+	});
+	let state = buildState(fuzzy.find(query), query);
+	let disposed = false;
+	const observers = /* @__PURE__ */ new Set();
+	if (options.onChange) observers.add(options.onChange);
+	const notify = (s) => {
+		for (const cb of observers) cb(s);
+	};
+	const run = async (q, signal) => {
+		await Promise.resolve();
+		if (signal?.aborted || disposed) return state;
+		const results = fuzzy.find(q);
+		if (signal?.aborted || disposed) return state;
+		state = buildState(results, q);
+		notify(state);
+		return state;
+	};
+	return {
+		get state() {
+			return state;
+		},
+		async setItems(newItems, signal) {
+			items = newItems;
+			fuzzy = createFuzzySearch(items, {
+				selector: options.selector,
+				fzf: options.fzf
+			});
+			await run(query, signal);
+		},
+		async setQuery(q, signal) {
+			query = q;
+			return run(q, signal);
+		},
+		async clearQuery() {
+			query = ``;
+			await run(``, void 0);
+		},
+		onChange(cb) {
+			observers.add(cb);
+			cb(state);
+			return () => {
+				observers.delete(cb);
+			};
+		},
+		dispose() {
+			disposed = true;
+			observers.clear();
+			items = [];
+		}
+	};
+}
+//#endregion
+//#region src/incr-search/element-search.ts
+const defaultGetLabel = (el) => el.textContent?.trim() ?? ``;
+const defaultGetKey = (el) => el.getAttribute(`data-key`) ?? el.getAttribute(`data-value`) ?? el.textContent?.trim() ?? ``;
+function createElementIncrSearch(opts) {
+	const { container, itemSelector, getLabel = defaultGetLabel, getKey = defaultGetKey, labelSelector, highlightKey } = opts;
+	let elementByKey = /* @__PURE__ */ new Map();
+	const search = createIncrSearch({
+		selector: (item) => item.label,
+		fzf: opts.fzf
+	});
+	const updateVisibility = (state) => {
+		const matchedKeys = new Set(state.results.map((r) => r.item.key));
+		const hasQuery = state.query.trim().length > 0;
+		for (const [key, el] of elementByKey) el.hidden = hasQuery ? !matchedKeys.has(key) : false;
+	};
+	const updateHighlights = (state) => {
+		if (!state.query.trim()) {
+			clearHighlights({ key: highlightKey });
+			return;
+		}
+		applyHighlights(buildHighlightTargets(container, labelSelector ?? itemSelector, state.positionsByItem, (el) => {
+			const key = getKey(el);
+			return state.results.find((r) => r.item.key === key)?.item;
+		}, (el) => getLabel(el)), { key: highlightKey });
+	};
+	const unsubscribeState = search.onChange((state) => {
+		updateVisibility(state);
+		updateHighlights(state);
+		opts.onChange?.(state);
+	});
+	let refreshPending = false;
+	const refresh = () => {
+		if (refreshPending) return;
+		refreshPending = true;
+		Promise.resolve().then(() => {
+			refreshPending = false;
+			elementByKey = /* @__PURE__ */ new Map();
+			const els = container.querySelectorAll(itemSelector);
+			const items = [];
+			for (const el of els) {
+				const key = getKey(el);
+				elementByKey.set(key, el);
+				items.push({
+					key,
+					label: getLabel(el)
+				});
+			}
+			search.setItems(items);
+		});
+	};
+	const observer = new MutationObserver(() => refresh());
+	observer.observe(container, {
+		childList: true,
+		subtree: false
+	});
+	refresh();
+	return {
+		async setQuery(query, signal) {
+			await search.setQuery(query, signal);
+		},
+		async clearQuery() {
+			await search.clearQuery();
+		},
+		refresh,
+		onChange(cb) {
+			return search.onChange(cb);
+		},
+		dispose() {
+			observer.disconnect();
+			unsubscribeState();
+			search.dispose();
+			clearHighlights({ key: highlightKey });
+		}
+	};
+}
+//#endregion
+//#region src/incr-search/ac-adapter.ts
+/**
+* Creates an ixfx-ac-text-compatible `completionProvider` function from a
+* static item list. Uses synchronous fuzzy search wrapped in a Promise so it
+* fits the async provider signature.
+*
+* Each returned item has `positions` populated with matched character indices,
+* which `ixfx-ac-text` uses to render CSS Custom Highlights on the label.
+*
+* Empty query returns all items in original order (no positions).
+* A cancelled signal causes the returned promise to reject with an AbortError.
+*/
+function createAcCompletionProvider(items, options = {}) {
+	const fuzzy = createFuzzySearch(items, { selector: options.selector ?? ((item) => item.label) });
+	return (query, signal) => new Promise((resolve, reject) => {
+		if (signal.aborted) {
+			reject(new DOMException(`Aborted`, `AbortError`));
+			return;
+		}
+		const results = fuzzy.find(query).map((r) => ({
+			...r.item,
+			positions: r.positions
+		}));
+		if (signal.aborted) {
+			reject(new DOMException(`Aborted`, `AbortError`));
+			return;
+		}
+		resolve(results);
+	});
+}
+//#endregion
+//#region src/incr-search/controller-tree.ts
+const DEFAULT_HIGHLIGHT_KEY = `incr-search-highlight`;
+/**
+* Incremental-search controller for any component implementing `TreeSearchHost`
+* (i.e. `ixfx-tree-list`, `ixfx-miller-list`, `ixfx-crumb-navigation`).
+*
+* Replaces the previous separate `IncrSearchTreeController` / `IncrSearchMillerController`
+* classes — the unified `TreeFilterPredicate` (with depth) means one implementation works
+* for all tree-like components.
+*
+* @example Using with ixfx-tree-list:
+* ```typescript
+* const ctrl = new IncrSearchTreeController(myTreeList, {
+*   selector: item => item.node.item.label,
+* });
+* ctrl.connect();
+* ```
+*
+* @example Using with ixfx-miller-list (different label selector):
+* ```typescript
+* const ctrl = new IncrSearchTreeController(myMillerList, {
+*   selector: item => item.node.item.label,
+*   labelSelector: '.label',
+* });
+* ctrl.connect();
+* ```
+*/
+var IncrSearchTreeController = class {
+	#el;
+	#opts;
+	#search;
+	#unsub;
+	#labelMap = /* @__PURE__ */ new Map();
+	constructor(el, opts) {
+		this.#el = el;
+		this.#opts = opts;
+		this.#search = createIncrSearch({
+			selector: opts.selector,
+			fzf: opts.fzf
+		});
+	}
+	connect() {
+		this.disconnect();
+		const items = this.#el.getNodes();
+		for (const item of items) this.#labelMap.set(this.#opts.selector(item), item);
+		this.#search.setItems(items);
+		if (this.#opts.input) {
+			this.#opts.input.addEventListener(`input`, this.#onInput);
+			this.#opts.input.addEventListener(`keydown`, this.#onKeydown);
+		}
+		this.#unsub = this.#search.onChange((state) => this.#onStateChange(state));
+	}
+	disconnect() {
+		if (this.#unsub) {
+			this.#unsub();
+			this.#unsub = void 0;
+		}
+		if (this.#opts.input) {
+			this.#opts.input.removeEventListener(`input`, this.#onInput);
+			this.#opts.input.removeEventListener(`keydown`, this.#onKeydown);
+		}
+		this.#el.filterPredicate = void 0;
+		clearHighlights({ key: this.#opts.highlightKey ?? DEFAULT_HIGHLIGHT_KEY });
+		this.#labelMap.clear();
+	}
+	async setQuery(query) {
+		await this.#search.setQuery(query);
+	}
+	async clearQuery() {
+		await this.#search.clearQuery();
+	}
+	#onInput = () => {
+		const value = this.#opts.input?.value ?? ``;
+		this.setQuery(value);
+	};
+	#onKeydown = (e) => {
+		if (e.key === `Escape` && this.#opts.input) {
+			this.#opts.input.value = ``;
+			this.clearQuery();
+		}
+	};
+	#onStateChange(state) {
+		const matched = new Set(state.results.map((r) => r.item.node.item.key));
+		const hasQuery = state.query.trim().length > 0;
+		this.#el.filterPredicate = hasQuery && matched.size > 0 ? (node, _depth) => matched.has(node.item.key) : void 0;
+		const key = this.#opts.highlightKey ?? DEFAULT_HIGHLIGHT_KEY;
+		if (!this.#el.shadowRoot) return;
+		if (!state.query.trim()) {
+			clearHighlights({ key });
+			return;
+		}
+		const labelSelector = this.#opts.labelSelector ?? `.tree-label`;
+		applyHighlights(buildHighlightTargets(this.#el.shadowRoot, labelSelector, state.positionsByItem, (labelEl) => {
+			const text = labelEl.textContent ?? ``;
+			return this.#labelMap.get(text);
+		}, (labelEl) => labelEl.textContent ?? ``), { key });
+	}
+};
+//#endregion
+export { createFuzzySearch as a, createIncrSearch as i, createAcCompletionProvider as n, createElementIncrSearch as r, IncrSearchTreeController as t };
+
+//# sourceMappingURL=incr-search-BjCNClnC.js.map

package/dist/incr-search-BjCNClnC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incr-search-BjCNClnC.js","names":["FzfAny","#el","#opts","#search","#labelMap","#onInput","#onKeydown","#unsub","#onStateChange"],"sources":["../src/incr-search/fuzzy.ts","../src/incr-search/incr-search.ts","../src/incr-search/element-search.ts","../src/incr-search/ac-adapter.ts","../src/incr-search/controller-tree.ts"],"sourcesContent":["import { Fzf } from 'fzf';\nimport type { FuzzySearch, FuzzySearchOptions, IncrSearchResult } from './types.js';\n\nconst defaultSelector = <T>(item: T): string => {\n  if (typeof item === `string`) return item;\n  const r = item as Record<string, unknown>;\n  if (typeof r[`label`] === `string`) return r[`label`];\n  if (typeof r[`key`] === `string`) return r[`key`];\n  if (typeof r[`value`] === `string`) return r[`value`];\n  return String(item);\n};\n\nexport function createFuzzySearch<T>(\n  items: readonly T[],\n  options: FuzzySearchOptions<T> = {},\n): FuzzySearch<T> {\n  const selector = options.selector ?? defaultSelector<T>;\n  // fzf uses a conditional SyncOptionsTuple<T> rest-parameter overload that TypeScript\n  // cannot narrow through a spread when T is generic.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const FzfAny = Fzf as new (list: readonly T[], opts: any) => { find(q: string): { item: T; positions: ReadonlySet<number>; score: number }[] };\n  const fzf = new FzfAny(items as readonly T[], { selector, ...(options.fzf ?? {}) });\n\n  const find = (query: string): readonly IncrSearchResult<T>[] => {\n    if (!query.trim()) {\n      return items.map(item => ({\n        item,\n        positions: new Set<number>(),\n        score: 0,\n      }));\n    }\n    return fzf.find(query).map(r => ({\n      item: r.item,\n      positions: r.positions,\n      score: r.score,\n    }));\n  };\n\n  return { find, items };\n}\n","import type {\n  IncrSearch,\n  IncrSearchChangeCallback,\n  IncrSearchOptions,\n  IncrSearchState,\n} from './types.js';\nimport { createFuzzySearch } from './fuzzy.js';\n\nconst buildState = <T>(\n  results: ReturnType<ReturnType<typeof createFuzzySearch<T>>[`find`]>,\n  query: string,\n): IncrSearchState<T> => {\n  const positionsByItem = new Map<T, ReadonlySet<number>>();\n  for (const r of results) {\n    positionsByItem.set(r.item, r.positions);\n  }\n  return Object.freeze({\n    query,\n    results: Object.freeze([...results]),\n    positionsByItem,\n  });\n};\n\nexport function createIncrSearch<T>(options: IncrSearchOptions<T> = {}): IncrSearch<T> {\n  let items: readonly T[] = options.items ?? [];\n  let query = ``;\n  let fuzzy = createFuzzySearch(items, { selector: options.selector, fzf: options.fzf });\n  let state: IncrSearchState<T> = buildState(fuzzy.find(query), query);\n  let disposed = false;\n\n  const observers = new Set<IncrSearchChangeCallback<T>>();\n\n  if (options.onChange) {\n    observers.add(options.onChange);\n  }\n\n  const notify = (s: IncrSearchState<T>): void => {\n    for (const cb of observers) {\n      cb(s);\n    }\n  };\n\n  const run = async (q: string, signal?: AbortSignal): Promise<IncrSearchState<T>> => {\n    // Yield to the microtask queue for a consistent async interface\n    await Promise.resolve();\n    if (signal?.aborted || disposed) {\n      return state;\n    }\n    const results = fuzzy.find(q);\n    if (signal?.aborted || disposed) {\n      return state;\n    }\n    state = buildState(results, q);\n    notify(state);\n    return state;\n  };\n\n  return {\n    get state() {\n      return state;\n    },\n\n    async setItems(newItems: readonly T[], signal?: AbortSignal): Promise<void> {\n      items = newItems;\n      fuzzy = createFuzzySearch(items, { selector: options.selector, fzf: options.fzf });\n      await run(query, signal);\n    },\n\n    async setQuery(q: string, signal?: AbortSignal): Promise<IncrSearchState<T>> {\n      query = q;\n      return run(q, signal);\n    },\n\n    async clearQuery(): Promise<void> {\n      query = ``;\n      await run(``, undefined);\n    },\n\n    onChange(cb: IncrSearchChangeCallback<T>): () => void {\n      observers.add(cb);\n      cb(state);\n      return () => {\n        observers.delete(cb);\n      };\n    },\n\n    dispose(): void {\n      disposed = true;\n      observers.clear();\n      items = [];\n    },\n  };\n}\n","import type {\n  ElementIncrSearchOptions,\n  IncrSearchChangeCallback,\n  IncrSearchState,\n} from './types.js';\nimport { createIncrSearch } from './incr-search.js';\nimport { applyHighlights, buildHighlightTargets, clearHighlights } from './highlight.js';\n\ntype ElementItem = { readonly key: string; readonly label: string };\n\nconst defaultGetLabel = (el: Element): string => el.textContent?.trim() ?? ``;\n\nconst defaultGetKey = (el: Element): string =>\n  el.getAttribute(`data-key`)\n  ?? el.getAttribute(`data-value`)\n  ?? el.textContent?.trim()\n  ?? ``;\n\nexport type ElementIncrSearch = {\n  readonly setQuery: (query: string, signal?: AbortSignal) => Promise<void>;\n  readonly clearQuery: () => Promise<void>;\n  readonly refresh: () => void;\n  readonly onChange: (cb: IncrSearchChangeCallback<ElementItem>) => () => void;\n  readonly dispose: () => void;\n};\n\nexport function createElementIncrSearch(opts: ElementIncrSearchOptions): ElementIncrSearch {\n  const {\n    container,\n    itemSelector,\n    getLabel = defaultGetLabel,\n    getKey = defaultGetKey,\n    labelSelector,\n    highlightKey,\n  } = opts;\n\n  // Map from key → element reference for highlight lookup\n  let elementByKey = new Map<string, Element>();\n\n  const search = createIncrSearch<ElementItem>({\n    selector: item => item.label,\n    fzf: opts.fzf,\n  });\n\n  const updateVisibility = (state: IncrSearchState<ElementItem>): void => {\n    const matchedKeys = new Set(state.results.map(r => r.item.key));\n    const hasQuery = state.query.trim().length > 0;\n\n    for (const [key, el] of elementByKey) {\n      (el as HTMLElement).hidden = hasQuery ? !matchedKeys.has(key) : false;\n    }\n  };\n\n  const updateHighlights = (state: IncrSearchState<ElementItem>): void => {\n    if (!state.query.trim()) {\n      clearHighlights({ key: highlightKey });\n      return;\n    }\n\n    const sel = labelSelector ?? itemSelector;\n    const targets = buildHighlightTargets(\n      container,\n      sel,\n      state.positionsByItem,\n      el => {\n        const key = getKey(el);\n        // Find the ElementItem whose key matches this element's key\n        const result = state.results.find(r => r.item.key === key);\n        return result?.item;\n      },\n      el => getLabel(el),\n    );\n    applyHighlights(targets, { key: highlightKey });\n  };\n\n  const unsubscribeState = search.onChange(state => {\n    updateVisibility(state);\n    updateHighlights(state);\n    opts.onChange?.(state);\n  });\n\n  let refreshPending = false;\n\n  const refresh = (): void => {\n    if (refreshPending) return;\n    refreshPending = true;\n    void Promise.resolve().then(() => {\n      refreshPending = false;\n      elementByKey = new Map<string, Element>();\n      const els = container.querySelectorAll(itemSelector);\n      const items: ElementItem[] = [];\n      for (const el of els) {\n        const key = getKey(el);\n        elementByKey.set(key, el);\n        items.push({ key, label: getLabel(el) });\n      }\n      void search.setItems(items);\n    });\n  };\n\n  const observer = new MutationObserver(() => refresh());\n  observer.observe(container, { childList: true, subtree: false });\n\n  refresh();\n\n  return {\n    async setQuery(query, signal) {\n      await search.setQuery(query, signal);\n    },\n\n    async clearQuery() {\n      await search.clearQuery();\n    },\n\n    refresh,\n\n    onChange(cb) {\n      return search.onChange(cb);\n    },\n\n    dispose() {\n      observer.disconnect();\n      unsubscribeState();\n      search.dispose();\n      clearHighlights({ key: highlightKey });\n    },\n  };\n}\n","import { createFuzzySearch } from './fuzzy.js';\nimport type { FuzzySearchOptions } from './types.js';\n\n/**\n * Creates an ixfx-ac-text-compatible `completionProvider` function from a\n * static item list. Uses synchronous fuzzy search wrapped in a Promise so it\n * fits the async provider signature.\n *\n * Each returned item has `positions` populated with matched character indices,\n * which `ixfx-ac-text` uses to render CSS Custom Highlights on the label.\n *\n * Empty query returns all items in original order (no positions).\n * A cancelled signal causes the returned promise to reject with an AbortError.\n */\nexport function createAcCompletionProvider<T extends { label: string }>(\n  items: readonly T[],\n  options: Pick<FuzzySearchOptions<T>, `selector`> = {},\n): (query: string, signal: AbortSignal) => Promise<(T & { positions: ReadonlySet<number> })[]> {\n  const selector = options.selector ?? ((item: T) => item.label);\n  const fuzzy = createFuzzySearch(items, { selector });\n\n  return (\n    query: string,\n    signal: AbortSignal,\n  ): Promise<(T & { positions: ReadonlySet<number> })[]> =>\n    new Promise((resolve, reject) => {\n      if (signal.aborted) {\n        reject(new DOMException(`Aborted`, `AbortError`));\n        return;\n      }\n\n      const results = fuzzy.find(query).map(r => ({ ...r.item, positions: r.positions }));\n\n      if (signal.aborted) {\n        reject(new DOMException(`Aborted`, `AbortError`));\n        return;\n      }\n\n      resolve(results);\n    });\n}\n","import type { FzfOptions } from 'fzf';\nimport type { IncrSearchState } from './types.js';\nimport { createIncrSearch } from './incr-search.js';\nimport { applyHighlights, clearHighlights, buildHighlightTargets } from './highlight.js';\nimport type { TreeSearchHost } from '../common/searchable.js';\nimport type { TreeNode } from '../common/types.js';\n\nconst DEFAULT_HIGHLIGHT_KEY = `incr-search-highlight`;\n\nexport type IncrSearchTreeOptions = {\n  selector: (item: { node: TreeNode; depth: number }) => string;\n  /**\n   * CSS selector for the label elements inside the shadow root.\n   * Defaults to `.tree-label` (suitable for ixfx-tree-list).\n   * Use `.label` for ixfx-miller-list.\n   */\n  labelSelector?: string;\n  highlightKey?: string;\n  input?: HTMLInputElement;\n  fzf?: Partial<FzfOptions<{ node: TreeNode; depth: number }>>;\n};\n\ntype SearchItem = { node: TreeNode; depth: number };\n\n/**\n * Incremental-search controller for any component implementing `TreeSearchHost`\n * (i.e. `ixfx-tree-list`, `ixfx-miller-list`, `ixfx-crumb-navigation`).\n *\n * Replaces the previous separate `IncrSearchTreeController` / `IncrSearchMillerController`\n * classes — the unified `TreeFilterPredicate` (with depth) means one implementation works\n * for all tree-like components.\n *\n * @example Using with ixfx-tree-list:\n * ```typescript\n * const ctrl = new IncrSearchTreeController(myTreeList, {\n *   selector: item => item.node.item.label,\n * });\n * ctrl.connect();\n * ```\n *\n * @example Using with ixfx-miller-list (different label selector):\n * ```typescript\n * const ctrl = new IncrSearchTreeController(myMillerList, {\n *   selector: item => item.node.item.label,\n *   labelSelector: '.label',\n * });\n * ctrl.connect();\n * ```\n */\nexport class IncrSearchTreeController {\n  #el: TreeSearchHost;\n  #opts: IncrSearchTreeOptions;\n  #search: ReturnType<typeof createIncrSearch<SearchItem>>;\n  #unsub: (() => void) | undefined;\n  #labelMap = new Map<string, SearchItem>();\n\n  constructor(el: TreeSearchHost, opts: IncrSearchTreeOptions) {\n    this.#el = el;\n    this.#opts = opts;\n    this.#search = createIncrSearch<SearchItem>({\n      selector: opts.selector,\n      fzf: opts.fzf,\n    });\n  }\n\n  connect(): void {\n    this.disconnect();\n\n    const items = this.#el.getNodes();\n    for (const item of items) {\n      this.#labelMap.set(this.#opts.selector(item), item);\n    }\n    void this.#search.setItems(items);\n\n    if (this.#opts.input) {\n      this.#opts.input.addEventListener(`input`, this.#onInput);\n      this.#opts.input.addEventListener(`keydown`, this.#onKeydown);\n    }\n\n    this.#unsub = this.#search.onChange(state => this.#onStateChange(state));\n  }\n\n  disconnect(): void {\n    if (this.#unsub) {\n      this.#unsub();\n      this.#unsub = undefined;\n    }\n    if (this.#opts.input) {\n      this.#opts.input.removeEventListener(`input`, this.#onInput);\n      this.#opts.input.removeEventListener(`keydown`, this.#onKeydown);\n    }\n    this.#el.filterPredicate = undefined;\n    clearHighlights({ key: this.#opts.highlightKey ?? DEFAULT_HIGHLIGHT_KEY });\n    this.#labelMap.clear();\n  }\n\n  async setQuery(query: string): Promise<void> {\n    await this.#search.setQuery(query);\n  }\n\n  async clearQuery(): Promise<void> {\n    await this.#search.clearQuery();\n  }\n\n  #onInput = () => {\n    const value = this.#opts.input?.value ?? ``;\n    void this.setQuery(value);\n  };\n\n  #onKeydown = (e: KeyboardEvent) => {\n    if (e.key === `Escape` && this.#opts.input) {\n      this.#opts.input.value = ``;\n      void this.clearQuery();\n    }\n  };\n\n  #onStateChange(state: IncrSearchState<SearchItem>): void {\n    const matched = new Set(state.results.map(r => r.item.node.item.key));\n    const hasQuery = state.query.trim().length > 0;\n    this.#el.filterPredicate = hasQuery && matched.size > 0\n      ? (node: TreeNode, _depth: number) => matched.has(node.item.key)\n      : undefined;\n\n    const key = this.#opts.highlightKey ?? DEFAULT_HIGHLIGHT_KEY;\n    if (!this.#el.shadowRoot) return;\n\n    if (!state.query.trim()) {\n      clearHighlights({ key });\n      return;\n    }\n\n    const labelSelector = this.#opts.labelSelector ?? `.tree-label`;\n    const targets = buildHighlightTargets(\n      this.#el.shadowRoot,\n      labelSelector,\n      state.positionsByItem,\n      (labelEl) => {\n        const text = labelEl.textContent ?? ``;\n        return this.#labelMap.get(text);\n      },\n      (labelEl) => labelEl.textContent ?? ``,\n    );\n    applyHighlights(targets, { key });\n  }\n}\n"],"mappings":"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"}

package/dist/incr-search.d.ts

@@ -0,0 +1,2 @@
+import { _ as IncrSearchChangeCallback, a as createElementIncrSearch, b as IncrSearchState, c as clearHighlights, d as ElementIncrSearchOptions, f as FuzzySearch, g as IncrSearch, h as HighlightTarget, i as ElementIncrSearch, l as createIncrSearch, m as HighlightOptions, n as IncrSearchTreeOptions, o as applyHighlights, p as FuzzySearchOptions, r as createAcCompletionProvider, s as buildHighlightTargets, t as IncrSearchTreeController, u as createFuzzySearch, v as IncrSearchOptions, y as IncrSearchResult } from "./index-C9iBN908.js";
+export { ElementIncrSearch, ElementIncrSearchOptions, FuzzySearch, FuzzySearchOptions, HighlightOptions, HighlightTarget, IncrSearch, IncrSearchChangeCallback, IncrSearchTreeController as IncrSearchMillerController, IncrSearchTreeController, IncrSearchTreeOptions as IncrSearchMillerOptions, IncrSearchTreeOptions, IncrSearchOptions, IncrSearchResult, IncrSearchState, applyHighlights, buildHighlightTargets, clearHighlights, createAcCompletionProvider, createElementIncrSearch, createFuzzySearch, createIncrSearch };

package/dist/incr-search.js

@@ -0,0 +1,3 @@
+import { n as buildHighlightTargets, r as clearHighlights, t as applyHighlights } from "./highlight-CAjwQ4GE.js";
+import { a as createFuzzySearch, i as createIncrSearch, n as createAcCompletionProvider, r as createElementIncrSearch, t as IncrSearchTreeController } from "./incr-search-BjCNClnC.js";
+export { IncrSearchTreeController as IncrSearchMillerController, IncrSearchTreeController, applyHighlights, buildHighlightTargets, clearHighlights, createAcCompletionProvider, createElementIncrSearch, createFuzzySearch, createIncrSearch };

package/dist/index-B1hNR7Z9.d.ts

@@ -0,0 +1,36 @@
+//#region src/icons/defaults.d.ts
+/**
+ * Chevron pointing down. Used for split-button dropdown toggle.
+ * fill="currentColor" so it inherits CSS color.
+ */
+declare const ICON_CHEVRON_DOWN = "<svg viewBox=\"0 0 20 20\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z\"/></svg>";
+/**
+ * Caret pointing right. Used for tree-basic expand indicator as a CSS mask.
+ * fill="black" is correct for CSS mask-image use (shape only, color comes from background-color).
+ */
+declare const ICON_CARET_RIGHT = "<svg viewBox=\"0 0 24 24\" fill=\"black\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M10 7l6 5-6 5V7z\"/></svg>";
+/**
+ * Checkmark. Useful for menu-check-item or confirmation states.
+ * fill="currentColor" so it inherits CSS color.
+ */
+declare const ICON_CHECK = "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41L9 16.17z\"/></svg>";
+/**
+ * Close / X icon. Useful for dialogs, notifications, dismissible elements.
+ * fill="currentColor" so it inherits CSS color.
+ */
+declare const ICON_CLOSE = "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z\"/></svg>";
+//#endregion
+//#region src/icons/registry.d.ts
+declare const iconBus: EventTarget;
+type IconChangedDetail = {
+  readonly name: string;
+};
+type IconChangedEvent = CustomEvent<IconChangedDetail>;
+declare function registerIcon(name: string, svg: string): void;
+declare function getIcon(name: string): string | undefined;
+declare function hasIcon(name: string): boolean;
+/** Converts an SVG string to a CSS data-URI value, e.g. for use as a mask-image. */
+declare function svgToDataUri(svg: string): string;
+//#endregion
+export { iconBus as a, ICON_CARET_RIGHT as c, ICON_CLOSE as d, hasIcon as i, ICON_CHECK as l, IconChangedEvent as n, registerIcon as o, getIcon as r, svgToDataUri as s, IconChangedDetail as t, ICON_CHEVRON_DOWN as u };
+//# sourceMappingURL=index-B1hNR7Z9.d.ts.map

package/dist/index-B1hNR7Z9.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-B1hNR7Z9.d.ts","names":[],"sources":["../src/icons/defaults.ts","../src/icons/registry.ts"],"mappings":";;;;AAMA;cAAa,iBAAA;;;;AAMb;cAAa,gBAAA;;;;AAMb;cAAa,UAAA;;;;AAMb;cAAa,UAAA;;;cCtBA,OAAA,EAAO,WAAA;AAAA,KAER,iBAAA;EAAA,SAA+B,IAAA;AAAA;AAAA,KAC/B,gBAAA,GAAmB,WAAA,CAAY,iBAAA;AAAA,iBAE3B,YAAA,CAAa,IAAA,UAAc,GAAA;AAAA,iBAK3B,OAAA,CAAQ,IAAA;AAAA,iBAIR,OAAA,CAAQ,IAAA;ADJxB;AAAA,iBCSgB,YAAA,CAAa,GAAA"}

package/dist/index-C5dK8RZa.d.ts

@@ -0,0 +1,23 @@
+import { t as LabelledInputBase } from "./labelled-input-base-DnRh4reU.js";
+import * as _$lit from "lit";
+import { CSSResultGroup } from "lit";
+
+//#region src/labelled-range-input/labelled-range-input.d.ts
+declare class LabelledRangeInput extends LabelledInputBase {
+  readonly inputSelector = "ixfx-range-input";
+  orientation: `horizontal` | `vertical`;
+  tooltip: boolean;
+  noTooltip: boolean;
+  tooltipOrientation: `top` | `right`;
+  switchHeight: number;
+  render(): _$lit.TemplateResult<1>;
+  static styles: CSSResultGroup;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'ixfx-labelled-range-input': LabelledRangeInput;
+  }
+} //# sourceMappingURL=labelled-range-input.d.ts.map
+//#endregion
+export { LabelledRangeInput as t };
+//# sourceMappingURL=index-C5dK8RZa.d.ts.map

package/dist/index-C5dK8RZa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-C5dK8RZa.d.ts","names":[],"sources":["../src/labelled-range-input/labelled-range-input.ts"],"mappings":";;;;;cAoEa,kBAAA,SAA2B,iBAAA;EAAA,SAC7B,aAAA;EAEmB,WAAA;EACC,OAAA;EACyB,SAAA;EACQ,kBAAA;EAEN,YAAA;EAE/C,MAAA,CAAA,GAVqB,KAAA,CAUf,cAAA;EAAA,OA0BR,MAAA,EAAQ,cAAA;AAAA;AAAA,QA2ET,MAAA;EAAA,UACI,qBAAA;IACR,2BAAA,EAA6B,kBAAA;EAAA;AAAA"}

package/dist/index-C9iBN908.d.ts

@@ -0,0 +1,160 @@
+import { C as TreeNode, d as TreeSearchHost } from "./tree-component-CQpoPo4s.js";
+import { FzfOptions } from "fzf";
+
+//#region src/incr-search/types.d.ts
+type IncrSearchResult<T> = {
+  readonly item: T;
+  readonly positions: ReadonlySet<number>;
+  readonly score: number;
+};
+type IncrSearchState<T> = {
+  readonly query: string;
+  readonly results: readonly IncrSearchResult<T>[];
+  readonly positionsByItem: ReadonlyMap<T, ReadonlySet<number>>;
+};
+type IncrSearchChangeCallback<T> = (state: IncrSearchState<T>) => void;
+type IncrSearchOptions<T> = {
+  readonly items?: readonly T[];
+  readonly selector?: (item: T) => string;
+  readonly fzf?: Partial<FzfOptions<T>>;
+  readonly onChange?: IncrSearchChangeCallback<T>;
+};
+type IncrSearch<T> = {
+  readonly setItems: (items: readonly T[], signal?: AbortSignal) => Promise<void>;
+  readonly setQuery: (query: string, signal?: AbortSignal) => Promise<IncrSearchState<T>>;
+  readonly clearQuery: () => Promise<void>;
+  readonly state: IncrSearchState<T>;
+  readonly onChange: (cb: IncrSearchChangeCallback<T>) => () => void;
+  readonly dispose: () => void;
+};
+type FuzzySearchOptions<T> = {
+  readonly selector?: (item: T) => string;
+  readonly fzf?: Partial<FzfOptions<T>>;
+};
+type FuzzySearch<T> = {
+  readonly find: (query: string) => readonly IncrSearchResult<T>[];
+  readonly items: readonly T[];
+};
+type HighlightTarget = {
+  readonly element: Element;
+  readonly text?: string;
+  readonly positions: ReadonlySet<number>;
+};
+type HighlightOptions = {
+  readonly key?: string;
+};
+type ElementIncrSearchOptions = {
+  readonly container: Element;
+  readonly itemSelector: string;
+  readonly getLabel?: (el: Element) => string;
+  readonly getKey?: (el: Element) => string;
+  readonly labelSelector?: string;
+  readonly highlightKey?: string;
+  readonly fzf?: Partial<FzfOptions<{
+    key: string;
+    label: string;
+  }>>;
+  readonly onChange?: IncrSearchChangeCallback<{
+    key: string;
+    label: string;
+  }>;
+};
+//#endregion
+//#region src/incr-search/fuzzy.d.ts
+declare function createFuzzySearch<T>(items: readonly T[], options?: FuzzySearchOptions<T>): FuzzySearch<T>;
+//#endregion
+//#region src/incr-search/incr-search.d.ts
+declare function createIncrSearch<T>(options?: IncrSearchOptions<T>): IncrSearch<T>;
+//#endregion
+//#region src/incr-search/highlight.d.ts
+declare function applyHighlights(targets: readonly HighlightTarget[], options?: HighlightOptions): void;
+declare function clearHighlights(options?: HighlightOptions): void;
+declare function buildHighlightTargets<T>(root: ShadowRoot | Element, itemSelector: string, positionsByItem: ReadonlyMap<T, ReadonlySet<number>>, getItem: (el: Element) => T | undefined, getText: (el: Element) => string): HighlightTarget[];
+//#endregion
+//#region src/incr-search/element-search.d.ts
+type ElementItem = {
+  readonly key: string;
+  readonly label: string;
+};
+type ElementIncrSearch = {
+  readonly setQuery: (query: string, signal?: AbortSignal) => Promise<void>;
+  readonly clearQuery: () => Promise<void>;
+  readonly refresh: () => void;
+  readonly onChange: (cb: IncrSearchChangeCallback<ElementItem>) => () => void;
+  readonly dispose: () => void;
+};
+declare function createElementIncrSearch(opts: ElementIncrSearchOptions): ElementIncrSearch;
+//#endregion
+//#region src/incr-search/ac-adapter.d.ts
+/**
+ * Creates an ixfx-ac-text-compatible `completionProvider` function from a
+ * static item list. Uses synchronous fuzzy search wrapped in a Promise so it
+ * fits the async provider signature.
+ *
+ * Each returned item has `positions` populated with matched character indices,
+ * which `ixfx-ac-text` uses to render CSS Custom Highlights on the label.
+ *
+ * Empty query returns all items in original order (no positions).
+ * A cancelled signal causes the returned promise to reject with an AbortError.
+ */
+declare function createAcCompletionProvider<T extends {
+  label: string;
+}>(items: readonly T[], options?: Pick<FuzzySearchOptions<T>, `selector`>): (query: string, signal: AbortSignal) => Promise<(T & {
+  positions: ReadonlySet<number>;
+})[]>;
+//#endregion
+//#region src/incr-search/controller-tree.d.ts
+type IncrSearchTreeOptions = {
+  selector: (item: {
+    node: TreeNode;
+    depth: number;
+  }) => string;
+  /**
+   * CSS selector for the label elements inside the shadow root.
+   * Defaults to `.tree-label` (suitable for ixfx-tree-list).
+   * Use `.label` for ixfx-miller-list.
+   */
+  labelSelector?: string;
+  highlightKey?: string;
+  input?: HTMLInputElement;
+  fzf?: Partial<FzfOptions<{
+    node: TreeNode;
+    depth: number;
+  }>>;
+};
+/**
+ * Incremental-search controller for any component implementing `TreeSearchHost`
+ * (i.e. `ixfx-tree-list`, `ixfx-miller-list`, `ixfx-crumb-navigation`).
+ *
+ * Replaces the previous separate `IncrSearchTreeController` / `IncrSearchMillerController`
+ * classes — the unified `TreeFilterPredicate` (with depth) means one implementation works
+ * for all tree-like components.
+ *
+ * @example Using with ixfx-tree-list:
+ * ```typescript
+ * const ctrl = new IncrSearchTreeController(myTreeList, {
+ *   selector: item => item.node.item.label,
+ * });
+ * ctrl.connect();
+ * ```
+ *
+ * @example Using with ixfx-miller-list (different label selector):
+ * ```typescript
+ * const ctrl = new IncrSearchTreeController(myMillerList, {
+ *   selector: item => item.node.item.label,
+ *   labelSelector: '.label',
+ * });
+ * ctrl.connect();
+ * ```
+ */
+declare class IncrSearchTreeController {
+  #private;
+  constructor(el: TreeSearchHost, opts: IncrSearchTreeOptions);
+  connect(): void;
+  disconnect(): void;
+  setQuery(query: string): Promise<void>;
+  clearQuery(): Promise<void>;
+}
+//#endregion
+export { IncrSearchChangeCallback as _, createElementIncrSearch as a, IncrSearchState as b, clearHighlights as c, ElementIncrSearchOptions as d, FuzzySearch as f, IncrSearch as g, HighlightTarget as h, ElementIncrSearch as i, createIncrSearch as l, HighlightOptions as m, IncrSearchTreeOptions as n, applyHighlights as o, FuzzySearchOptions as p, createAcCompletionProvider as r, buildHighlightTargets as s, IncrSearchTreeController as t, createFuzzySearch as u, IncrSearchOptions as v, IncrSearchResult as y };
+//# sourceMappingURL=index-C9iBN908.d.ts.map

package/dist/index-C9iBN908.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-C9iBN908.d.ts","names":[],"sources":["../src/incr-search/types.ts","../src/incr-search/fuzzy.ts","../src/incr-search/incr-search.ts","../src/incr-search/highlight.ts","../src/incr-search/element-search.ts","../src/incr-search/ac-adapter.ts","../src/incr-search/controller-tree.ts"],"mappings":"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"}