modern-cmdk 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,261 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ABCrimson/modern-cmdk/main/apps/docs/public/og-image.svg" alt="modern-cmdk" width="640" />
+</p>
+
+<p align="center">
+  <strong>modern-cmdk</strong><br/>
+  The definitive command palette engine for the modern web.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/modern-cmdk"><img alt="npm version" src="https://img.shields.io/npm/v/modern-cmdk?style=flat-square&color=dc2626&labelColor=0a0e27"/></a>
+  <a href="https://bundlephobia.com/package/modern-cmdk"><img alt="bundle size" src="https://img.shields.io/bundlephobia/minzip/modern-cmdk?style=flat-square&color=dc2626&labelColor=0a0e27&label=core"/></a>
+  <a href="https://github.com/ABCrimson/modern-cmdk/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/ABCrimson/modern-cmdk/ci.yml?style=flat-square&color=dc2626&labelColor=0a0e27&label=CI"/></a>
+  <a href="https://www.typescriptlang.org/"><img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-6.0-dc2626?style=flat-square&labelColor=0a0e27"/></a>
+  <a href="https://react.dev/"><img alt="React" src="https://img.shields.io/badge/React-19-dc2626?style=flat-square&labelColor=0a0e27"/></a>
+  <a href="https://github.com/ABCrimson/modern-cmdk/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/npm/l/modern-cmdk?style=flat-square&color=dc2626&labelColor=0a0e27"/></a>
+</p>
+
+<p align="center">
+  <a href="https://command.crimson.dev">Documentation</a> &middot;
+  <a href="https://command.crimson.dev/guide/getting-started">Getting Started</a> &middot;
+  <a href="https://command.crimson.dev/api/command">API Reference</a> &middot;
+  <a href="https://command.crimson.dev/examples/basic">Examples</a>
+</p>
+
+---
+
+## Install
+
+```bash
+npm install modern-cmdk
+```
+
+The package exports three entry points:
+
+```ts
+import { createCommandMachine } from 'modern-cmdk';       // Core engine (no React)
+import { Command } from 'modern-cmdk/react';               // React 19 components
+import 'modern-cmdk/styles.css';                            // Default styles
+```
+
+React is an **optional** peer dependency — use the core engine standalone in any framework, or pair it with the React adapter for a batteries-included experience.
+
+---
+
+## Quick Start
+
+```tsx
+'use client';
+
+import { Command } from 'modern-cmdk/react';
+import 'modern-cmdk/styles.css';
+
+function CommandPalette() {
+  return (
+    <Command.Dialog>
+      <Command.Input placeholder="Type a command..." />
+      <Command.List>
+        <Command.Empty>No results found.</Command.Empty>
+
+        <Command.Group heading="Actions">
+          <Command.Item value="copy" onSelect={() => copyToClipboard()}>
+            <Command.Highlight>Copy to Clipboard</Command.Highlight>
+            <Command.Shortcut>Mod+C</Command.Shortcut>
+          </Command.Item>
+          <Command.Item value="paste" onSelect={() => paste()}>
+            <Command.Highlight>Paste</Command.Highlight>
+            <Command.Shortcut>Mod+V</Command.Shortcut>
+          </Command.Item>
+        </Command.Group>
+
+        <Command.Group heading="Navigation">
+          <Command.Item value="settings" onSelect={() => navigate('/settings')}>
+            Settings
+            <Command.Badge>New</Command.Badge>
+          </Command.Item>
+        </Command.Group>
+      </Command.List>
+      <Command.Loading>Searching...</Command.Loading>
+    </Command.Dialog>
+  );
+}
+```
+
+Or scaffold a new project instantly:
+
+```bash
+npm create modern-cmdk
+```
+
+---
+
+## Why modern-cmdk?
+
+A ground-up rewrite of `cmdk` for **React 19**, **ES2026**, and **TypeScript 6**. Framework-agnostic core. Zero compromise on performance, accessibility, or developer experience.
+
+| | cmdk | modern-cmdk |
+|---|---|---|
+| **Architecture** | React-only, tightly coupled | Framework-agnostic core + thin adapters |
+| **React** | 18 | 19 (`use()`, `useOptimistic`, `useId`, `ref` as prop) |
+| **Search** | Basic substring | Fuzzy scoring + optional WASM (sub-1ms on 100K items) |
+| **Ranking** | Static order | Frecency with `Temporal`-based exponential decay |
+| **Virtualization** | None | Automatic variable-height, `content-visibility: auto` |
+| **Animations** | CSS transitions | GPU-composited: `@starting-style`, `scroll-timeline`, spring easing |
+| **Keyboard** | External | Built-in registry, `Mod` key, conflict detection |
+| **Accessibility** | Partial ARIA | Full WAI-ARIA combobox, `forced-colors`, `prefers-contrast` |
+| **Bundle** | ~6 KB | Core ~5.2 KB, React ~6.3 KB |
+| **TypeScript** | 4.x/5.x | 6.0, isolated declarations, branded types |
+| **Cleanup** | Manual | `using`/`await using` (Explicit Resource Management) |
+| **Error handling** | None | `CommandErrorBoundary` with fallback UI |
+| **DevTools** | None | Built-in devtools hook for browser inspection |
+
+---
+
+## Features
+
+- **Framework-agnostic core** -- Pure TypeScript state machine. Zero DOM dependencies. Portable to any runtime.
+- **React 19 adapter** -- 14 compound components. `useSyncExternalStore`, `useTransition`, `useOptimistic`, `use()` for Suspense. React Compiler compatible.
+- **Automatic virtualization** -- Variable-height virtual scrolling kicks in at 100+ items. Handles 100K+ items smoothly with `content-visibility: auto`.
+- **Fuzzy search** -- Built-in TypeScript scorer with incremental filtering. Optional [WASM engine](https://www.npmjs.com/package/modern-cmdk-search-wasm) for sub-1ms on 100K items.
+- **Frecency ranking** -- Frequency x recency with `Temporal`-based exponential decay. Pluggable persistence (memory or IndexedDB).
+- **Keyboard shortcuts** -- Built-in registry with cross-platform `Mod` key, conflict detection, and `RegExp.escape` parsing.
+- **Full accessibility** -- WAI-ARIA combobox pattern, `aria-live` announcements, `forced-colors`, `prefers-contrast`, `prefers-reduced-motion`.
+- **GPU-composited animations** -- `@starting-style` entry, `scroll-timeline` progress, spring `linear()` easing. All customizable via CSS custom properties.
+- **Error boundary** -- `CommandErrorBoundary` with static or render-function fallback.
+- **DevTools** -- `useCommandDevtools()` exposes machine state via `CustomEvent` for browser inspection.
+- **Telemetry middleware** -- Pluggable hooks for palette open/close, search, and item selection analytics.
+- **ESM-only** -- Zero CommonJS. Tree-shakeable. `sideEffects: false`. Isolated declarations.
+
+---
+
+## React Components
+
+```tsx
+<Command>                {/* Root -- state machine provider */}
+  <Command.Input />      {/* Search input */}
+  <Command.List>         {/* Scrollable list with auto-virtualization */}
+    <Command.Empty />    {/* Shown when filteredCount === 0 */}
+    <Command.Loading />  {/* Shown when loading */}
+    <Command.Group>      {/* Labeled group of items */}
+      <Command.Item>     {/* Selectable item */}
+        <Command.Highlight />   {/* Fuzzy match highlighting */}
+        <Command.Badge />       {/* Status badge */}
+        <Command.Shortcut />    {/* Keyboard shortcut display */}
+      </Command.Item>
+    </Command.Group>
+    <Command.Separator />
+  </Command.List>
+</Command>
+
+<Command.Dialog />       {/* Radix Dialog + overlay + portal */}
+<Command.Page />         {/* Nested page navigation */}
+<Command.AsyncItems />   {/* Suspense-powered async loading */}
+```
+
+---
+
+## Core API (No React)
+
+Use the core engine standalone in any framework or runtime:
+
+```ts
+import { createCommandMachine, itemId } from 'modern-cmdk';
+
+using machine = createCommandMachine({
+  items: [
+    { id: itemId('copy'), value: 'Copy', shortcut: 'Mod+C', onSelect: () => copy() },
+    { id: itemId('paste'), value: 'Paste', shortcut: 'Mod+V', onSelect: () => paste() },
+  ],
+  frecency: { enabled: true },
+  loop: true,
+});
+
+machine.send({ type: 'SEARCH_CHANGE', query: 'cop' });
+machine.send({ type: 'NAVIGATE', direction: 'next' });
+machine.send({ type: 'ITEM_SELECT', id: itemId('copy') });
+
+machine.subscribe(() => {
+  console.log(machine.getState());
+});
+// Automatic cleanup via `using` -- no manual dispose needed
+```
+
+---
+
+## Performance
+
+| Benchmark | Target | Measured |
+|---|---|---|
+| Search 10K items (TS scorer) | < 16 ms | ~8.2 ms |
+| Search 100K items (WASM) | < 1 ms | ~0.7 ms |
+| Filter 10K (incremental) | < 2 ms | ~1.1 ms |
+| State update cycle | < 4 ms | ~2.3 ms |
+| Core bundle (gzipped) | <= 6 KB | ~5.2 KB |
+| React bundle (gzipped) | <= 25 KB | ~6.3 KB |
+
+CI enforces 5% warning / 15% failure regression thresholds with 3-run averaging.
+
+---
+
+## CSS Customization
+
+All animations and dimensions are customizable via CSS custom properties:
+
+```css
+[data-command-root] {
+  --command-duration-enter: 200ms;
+  --command-duration-exit: 150ms;
+  --command-scale-from: 0.96;
+  --command-overlay-blur: 4px;
+  --command-dialog-radius: 12px;
+  --command-dialog-max-width: 640px;
+  --command-item-height: 44px;
+  --command-highlight-color: oklch(0.85 0.15 90 / 0.3);
+}
+```
+
+All styles use `@layer command` for zero-specificity conflicts and CSS logical properties for full RTL support.
+
+---
+
+## Migration from cmdk
+
+Automated codemods handle the most common migration patterns:
+
+```bash
+npx modern-cmdk --transform import-rewrite ./src
+npx modern-cmdk --transform data-attrs ./src
+npx modern-cmdk --transform forward-ref ./src
+npx modern-cmdk --transform should-filter ./src
+```
+
+See the [full migration guide](https://command.crimson.dev/guide/migration-from-cmdk).
+
+---
+
+## Documentation
+
+**[command.crimson.dev](https://command.crimson.dev)**
+
+**Guides:** [Getting Started](https://command.crimson.dev/guide/getting-started) | [Installation](https://command.crimson.dev/guide/installation) | [Basic Usage](https://command.crimson.dev/guide/basic-usage) | [Async Items](https://command.crimson.dev/guide/async-items) | [WASM Search](https://command.crimson.dev/guide/wasm-search) | [Frecency](https://command.crimson.dev/guide/frecency) | [Shortcuts](https://command.crimson.dev/guide/shortcuts) | [Virtualization](https://command.crimson.dev/guide/virtualization) | [SSR / Next.js](https://command.crimson.dev/guide/ssr) | [Theming](https://command.crimson.dev/guide/theming) | [Accessibility](https://command.crimson.dev/guide/accessibility)
+
+**Recipes:** [File Picker](https://command.crimson.dev/recipes/file-picker) | [Emoji Picker](https://command.crimson.dev/recipes/emoji-picker) | [AI Chat Commands](https://command.crimson.dev/recipes/ai-chat-commands) | [Nested Commands](https://command.crimson.dev/recipes/nested-commands) | [Spotlight Search](https://command.crimson.dev/recipes/spotlight-search)
+
+**API:** [Core Engine](https://command.crimson.dev/api/command) | [React Adapter](https://command.crimson.dev/api/command-react) | [WASM Search](https://command.crimson.dev/api/command-search-wasm)
+
+---
+
+## Related Packages
+
+| Package | Description |
+|---|---|
+| [`create-modern-cmdk`](https://www.npmjs.com/package/create-modern-cmdk) | `npm create modern-cmdk` -- scaffold a new project |
+| [`modern-cmdk-search-wasm`](https://www.npmjs.com/package/modern-cmdk-search-wasm) | Rust/WASM fuzzy search -- sub-1ms on 100K items |
+| [`vscode-modern-cmdk`](https://marketplace.visualstudio.com/items?itemName=crimson-dev.vscode-modern-cmdk) | VS Code snippets extension |
+
+---
+
+## License
+
+[MIT](https://github.com/ABCrimson/modern-cmdk/blob/main/LICENSE) -- Copyright (c) 2026 Crimson Dev

package/dist/core/index.d.mts

@@ -1,2 +1,2 @@
-import { A as DEFAULT_FRECENCY_DECAY, B as groupId, C as computeFrecencyBonus, D as CommandItem, E as CommandGroup, F as FrecencyRecord, H as ScorerFn, I as FrecencyStorage, L as GroupId, M as FrecencyData, N as FrecencyDecayConfig, O as CommandMachineOptions, P as FrecencyOptions, R as ItemId, S as FrecencyEngine, T as CommandEvent, U as SearchEngine, V as itemId, W as SearchResult, _ as matchesShortcut, a as TelemetryMiddleware, b as parseShortcut, c as batchScoreItems, d as CommandMachine, f as createCommandMachine, g as findMatchingShortcut, h as detectConflicts, i as CommandTelemetryHooks, j as DEFAULT_MACHINE_OPTIONS, k as CommandState, l as scoreItemAsync, m as KeyboardShortcutRegistry, n as createScheduler, o as createTelemetryMiddleware, p as CommandRegistry, r as TypedEmitter, s as createSearchEngine, t as Scheduler, u as scoreItem, v as ParsedShortcut, w as IdbFrecencyStorage, x as MemoryFrecencyStorage, y as formatShortcut, z as createInitialState } from "../index-Ctz7l29k.mjs";
+import { A as DEFAULT_FRECENCY_DECAY, B as groupId, C as computeFrecencyBonus, D as CommandItem, E as CommandGroup, F as FrecencyRecord, H as ScorerFn, I as FrecencyStorage, L as GroupId, M as FrecencyData, N as FrecencyDecayConfig, O as CommandMachineOptions, P as FrecencyOptions, R as ItemId, S as FrecencyEngine, T as CommandEvent, U as SearchEngine, V as itemId, W as SearchResult, _ as matchesShortcut, a as TelemetryMiddleware, b as parseShortcut, c as batchScoreItems, d as CommandMachine, f as createCommandMachine, g as findMatchingShortcut, h as detectConflicts, i as CommandTelemetryHooks, j as DEFAULT_MACHINE_OPTIONS, k as CommandState, l as scoreItemAsync, m as KeyboardShortcutRegistry, n as createScheduler, o as createTelemetryMiddleware, p as CommandRegistry, r as TypedEmitter, s as createSearchEngine, t as Scheduler, u as scoreItem, v as ParsedShortcut, w as IdbFrecencyStorage, x as MemoryFrecencyStorage, y as formatShortcut, z as createInitialState } from "../index-C6g94P7V.mjs";
 export { CommandEvent, CommandGroup, CommandItem, CommandMachine, CommandMachineOptions, CommandRegistry, CommandState, CommandTelemetryHooks, DEFAULT_FRECENCY_DECAY, DEFAULT_MACHINE_OPTIONS, FrecencyData, FrecencyDecayConfig, FrecencyEngine, FrecencyOptions, FrecencyRecord, FrecencyStorage, GroupId, IdbFrecencyStorage, ItemId, KeyboardShortcutRegistry, MemoryFrecencyStorage, ParsedShortcut, Scheduler, ScorerFn, SearchEngine, SearchResult, TelemetryMiddleware, TypedEmitter, batchScoreItems, computeFrecencyBonus, createCommandMachine, createInitialState, createScheduler, createSearchEngine, createTelemetryMiddleware, detectConflicts, findMatchingShortcut, formatShortcut, groupId, itemId, matchesShortcut, parseShortcut, scoreItem, scoreItemAsync };

package/dist/core/index.mjs

@@ -1,2 +1,2 @@
-import { C as itemId, S as groupId, _ as computeFrecencyBonus, a as createScheduler, b as DEFAULT_MACHINE_OPTIONS, c as scoreItem, d as formatShortcut, f as parseShortcut, g as FrecencyEngine, h as matchesShortcut, i as createCommandMachine, l as CommandRegistry, m as findMatchingShortcut, n as batchScoreItems, o as TypedEmitter, p as detectConflicts, r as scoreItemAsync, s as createSearchEngine, t as createTelemetryMiddleware, u as KeyboardShortcutRegistry, v as MemoryFrecencyStorage, w as IdbFrecencyStorage, x as createInitialState, y as DEFAULT_FRECENCY_DECAY } from "../core-Bq0eDvlc.mjs";
+import { C as itemId, S as groupId, _ as computeFrecencyBonus, a as createScheduler, b as DEFAULT_MACHINE_OPTIONS, c as scoreItem, d as formatShortcut, f as parseShortcut, g as FrecencyEngine, h as matchesShortcut, i as createCommandMachine, l as CommandRegistry, m as findMatchingShortcut, n as batchScoreItems, o as TypedEmitter, p as detectConflicts, r as scoreItemAsync, s as createSearchEngine, t as createTelemetryMiddleware, u as KeyboardShortcutRegistry, v as MemoryFrecencyStorage, w as IdbFrecencyStorage, x as createInitialState, y as DEFAULT_FRECENCY_DECAY } from "../core-CgQYpHK3.mjs";
 export { CommandRegistry, DEFAULT_FRECENCY_DECAY, DEFAULT_MACHINE_OPTIONS, FrecencyEngine, IdbFrecencyStorage, KeyboardShortcutRegistry, MemoryFrecencyStorage, TypedEmitter, batchScoreItems, computeFrecencyBonus, createCommandMachine, createInitialState, createScheduler, createSearchEngine, createTelemetryMiddleware, detectConflicts, findMatchingShortcut, formatShortcut, groupId, itemId, matchesShortcut, parseShortcut, scoreItem, scoreItemAsync };

package/dist/{core-Bq0eDvlc.mjs → core-CgQYpHK3.mjs}

@@ -45,10 +45,10 @@ var IdbFrecencyStorage = class {
 	/**
 	* Create an IDB-backed frecency storage.
 	*
-	* @param dbName — IndexedDB database name (default: 'crimson-command')
+	* @param dbName — IndexedDB database name (default: 'modern-cmdk')
 	* @param storeName — IndexedDB object store name (default: 'frecency')
 	*/
-	constructor(dbName = "crimson-command", storeName = "frecency") {
+	constructor(dbName = "modern-cmdk", storeName = "frecency") {
 		this.#store = createStore(dbName, storeName);
 	}
 	/** Load frecency data from IndexedDB for the given namespace */
@@ -141,6 +141,8 @@ var MemoryFrecencyStorage = class {
 };
 //#endregion
 //#region src/core/frecency/index.ts
+/** Shared empty bonus map — avoids allocation when no frecency records exist */
+const EMPTY_BONUS_MAP = /* @__PURE__ */ new Map();
 /** Pre-computed bucket boundaries in hours — avoids Duration.total() per call */
 const BUCKET_HOURS = {
 	hour: 1,
@@ -187,9 +189,7 @@ var FrecencyEngine = class {
 			frequency: (this.#data.records.get(itemId)?.frequency ?? 0) + 1,
 			lastUsed: now
 		};
-		const newRecords = new Map(this.#data.records);
-		newRecords.set(itemId, updated);
-		this.#data = { records: newRecords };
+		this.#data.records.set(itemId, updated);
 		this.#dirty = true;
 	}
 	/** Get frecency bonus for an item */
@@ -200,6 +200,7 @@ var FrecencyEngine = class {
 	}
 	/** Get all frecency bonuses as a map — for...of for hot ranking path (no closure overhead) */
 	getAllBonuses(now = Temporal.Now.instant()) {
+		if (this.#data.records.size === 0) return EMPTY_BONUS_MAP;
 		const bonuses = /* @__PURE__ */ new Map();
 		for (const [id, record] of this.#data.records) bonuses.set(id, computeFrecencyBonus(record, now, this.#config));
 		return bonuses;
@@ -277,7 +278,6 @@ const MODIFIER_MAP = {
 };
 /**
 * Parse a shortcut string like "Mod+Shift+K" into a structured ParsedShortcut.
-* Uses RegExp.escape (ES2026) for safe pattern construction from user-provided strings.
 * Uses String.isWellFormed() (ES2026) to ensure valid Unicode input.
 */
 function parseShortcut(shortcut) {
@@ -368,11 +368,9 @@ var KeyboardShortcutRegistry = class {
 		const shortcut = parseShortcut(shortcutStr);
 		this.#bindings.delete(shortcut.normalized);
 	}
-	/** Unregister all shortcuts for a given item — for...of with deferred delete (avoids mutation during iteration) */
+	/** Unregister all shortcuts for a given item — Map spec allows deletion during iteration */
 	unregisterByItem(itemId) {
-		const keysToDelete = [];
-		for (const [key, binding] of this.#bindings) if (binding.itemId === itemId) keysToDelete.push(key);
-		for (const key of keysToDelete) this.#bindings.delete(key);
+		for (const [key, binding] of this.#bindings) if (binding.itemId === itemId) this.#bindings.delete(key);
 	}
 	/** Check for conflicting shortcuts */
 	getConflicts() {
@@ -423,9 +421,13 @@ var CommandRegistry = class {
 	#itemOrder = [];
 	#itemOrderSet = /* @__PURE__ */ new Set();
 	#cachedItems = null;
+	#cachedGroups = null;
 	#invalidateCache() {
 		this.#cachedItems = null;
 	}
+	#invalidateGroupCache() {
+		this.#cachedGroups = null;
+	}
 	/** Register an item — returns Disposable for `using` auto-deregister */
 	registerItem(item) {
 		this.#items.set(item.id, item);
@@ -471,13 +473,16 @@ var CommandRegistry = class {
 	/** Register a group */
 	registerGroup(group) {
 		this.#groups.set(group.id, group);
+		this.#invalidateGroupCache();
 		return { [Symbol.dispose]: () => {
 			this.#groups.delete(group.id);
+			this.#invalidateGroupCache();
 		} };
 	}
 	/** Unregister a group */
 	unregisterGroup(id) {
 		this.#groups.delete(id);
+		this.#invalidateGroupCache();
 	}
 	/** Get an item by ID — O(1) */
 	getItem(id) {
@@ -493,9 +498,11 @@ var CommandRegistry = class {
 		this.#cachedItems = this.#itemOrder.values().map((id) => this.#items.get(id)).filter((item) => item != null).toArray();
 		return this.#cachedItems;
 	}
-	/** Get all registered groups sorted by priority */
+	/** Get all registered groups sorted by priority — cached between group mutations */
 	getGroups() {
-		return this.#groups.values().toArray().sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+		if (this.#cachedGroups !== null) return this.#cachedGroups;
+		this.#cachedGroups = this.#groups.values().toArray().sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+		return this.#cachedGroups;
 	}
 	/** Get items grouped by groupId using Map.groupBy (ES2026) — direct Map, no Object.entries conversion */
 	getGroupedItems() {
@@ -557,6 +564,7 @@ var CommandRegistry = class {
 		this.#itemOrder = [];
 		this.#itemOrderSet.clear();
 		this.#invalidateCache();
+		this.#invalidateGroupCache();
 	}
 	[Symbol.dispose]() {
 		this.clear();
@@ -763,7 +771,7 @@ function createSearchEngine(options) {
 				}));
 			}
 			const lowerQuery = query.toLowerCase();
-			const candidateItems = query.startsWith(previousQuery) && previousQuery.length > 0 ? items.filter((item) => previousResults.has(item.id)) : items;
+			const candidateItems = query.startsWith(previousQuery) && previousQuery.length > 0 ? items.values().filter((item) => previousResults.has(item.id)) : items;
 			const results = [];
 			if (useDefaultScorer) for (const item of candidateItems) {
 				const entry = indexedEntries.get(item.id);
@@ -908,6 +916,7 @@ function createScheduler() {
 function createCommandMachine(options = {}) {
 	let state = createInitialState(options);
 	let filteredIdSet = /* @__PURE__ */ new Set();
+	let filteredIdIndex = /* @__PURE__ */ new Map();
 	const registry = new CommandRegistry();
 	const searchEngine = options.search ?? createSearchEngine(typeof options.filter === "function" ? { scorer: (query, item) => {
 		const score = options.filter(item, query);
@@ -953,7 +962,13 @@ function createCommandMachine(options = {}) {
 			}
 			filteredIds = results.map((r) => r.id);
 		}
-		filteredIdSet = new Set(filteredIds);
+		filteredIdSet = /* @__PURE__ */ new Set();
+		filteredIdIndex = /* @__PURE__ */ new Map();
+		for (let i = 0; i < filteredIds.length; i++) {
+			const id = filteredIds[i];
+			filteredIdSet.add(id);
+			filteredIdIndex.set(id, i);
+		}
 		const groupedIds = Map.groupBy(filteredIds, (id) => {
 			return registry.getItem(id)?.groupId ?? "__ungrouped";
 		});
@@ -996,7 +1011,7 @@ function createCommandMachine(options = {}) {
 			return;
 		}
 		const loop = options.loop ?? true;
-		const currentIdx = activeId ? filteredIds.indexOf(activeId) : -1;
+		const currentIdx = activeId ? filteredIdIndex.get(activeId) ?? -1 : -1;
 		let newIdx;
 		if (direction === "next") if (currentIdx === -1 || currentIdx >= filteredIds.length - 1) newIdx = loop ? 0 : filteredIds.length - 1;
 		else newIdx = currentIdx + 1;
@@ -1139,6 +1154,9 @@ function createCommandMachine(options = {}) {
 		getKeyboardRegistry() {
 			return keyboardRegistry;
 		},
+		getFilteredIdSet() {
+			return filteredIdSet;
+		},
 		[Symbol.dispose]() {
 			scheduler[Symbol.dispose]();
 			registry[Symbol.dispose]();
@@ -1163,7 +1181,7 @@ async function scoreItemAsync(query, item) {
 * Enables streaming consumption and lazy evaluation of scoring operations.
 */
 async function* scoreItemsGenerator(query, items) {
-	for (const item of items) yield Promise.try(() => scoreItem(query, item));
+	for (const item of items) yield Promise.try(() => scoreItem(query, item)).catch(() => null);
 }
 /**
 * Batch score items using Array.fromAsync (ES2026) with an async generator pipeline.
@@ -1214,4 +1232,4 @@ function createTelemetryMiddleware(hooks) {
 //#endregion
 export { itemId as C, groupId as S, computeFrecencyBonus as _, createScheduler as a, DEFAULT_MACHINE_OPTIONS as b, scoreItem as c, formatShortcut as d, parseShortcut as f, FrecencyEngine as g, matchesShortcut as h, createCommandMachine as i, CommandRegistry as l, findMatchingShortcut as m, batchScoreItems as n, TypedEmitter as o, detectConflicts as p, scoreItemAsync as r, createSearchEngine as s, createTelemetryMiddleware as t, KeyboardShortcutRegistry as u, MemoryFrecencyStorage as v, IdbFrecencyStorage as w, createInitialState as x, DEFAULT_FRECENCY_DECAY as y };
 
-//# sourceMappingURL=core-Bq0eDvlc.mjs.map
+//# sourceMappingURL=core-CgQYpHK3.mjs.map