modern-cmdk 1.2.2 → 1.3.0

package/dist/codemod/transforms/data-attrs.d.mts

@@ -1,8 +1,6 @@
 import { API, FileInfo } from "jscodeshift";
-//#region src/codemod/transforms/data-attrs.d.ts
 /**
  * jscodeshift transform — renames cmdk data attributes in JSX and
  * CSS selectors within string/template literals.
  */
-export default function transform(fileInfo: FileInfo, api: API): string;
-//#endregion
+export default function transform(fileInfo: FileInfo, api: API): string;

package/dist/codemod/transforms/data-attrs.mjs

@@ -1,4 +1,4 @@
-//#region src/codemod/transforms/data-attrs.ts
+// src/codemod/transforms/data-attrs.ts
 /** Mapping from old bare attribute names to new data-attribute names */
 const ATTR_MAP = /* @__PURE__ */ new Map([
 	["cmdk-root", "data-command"],
@@ -14,7 +14,7 @@ const ATTR_MAP = /* @__PURE__ */ new Map([
 const CSS_VAR_MAP = /* @__PURE__ */ new Map([["--cmdk-list-height", "--command-list-height"]]);
 /**
 * Replace all cmdk attribute selectors (bracketed) and CSS vars in a string.
-* Uses ES2026 Set.union to combine both maps into a single pass.
+* Runs replaceAll for each ATTR_MAP entry (bracketed selectors), then for each CSS_VAR_MAP entry.
 */
 function replaceInString(input) {
 	let result = input;
@@ -62,5 +62,4 @@ function transform(fileInfo, api) {
 	});
 	return hasChanges ? root.toSource() : fileInfo.source;
 }
-//#endregion
 export { transform as default };

package/dist/codemod/transforms/forward-ref.d.mts

@@ -1,8 +1,6 @@
 import { API, FileInfo } from "jscodeshift";
-//#region src/codemod/transforms/forward-ref.d.ts
 /**
  * jscodeshift transform — removes forwardRef wrappers and merges the
  * ref parameter into the props object as a regular prop.
  */
-export default function transform(fileInfo: FileInfo, api: API): string;
-//#endregion
+export default function transform(fileInfo: FileInfo, api: API): string;

package/dist/codemod/transforms/forward-ref.mjs

@@ -1,4 +1,4 @@
-//#region src/codemod/transforms/forward-ref.ts
+// src/codemod/transforms/forward-ref.ts
 /**
 * jscodeshift transform — removes forwardRef wrappers and merges the
 * ref parameter into the props object as a regular prop.
@@ -47,5 +47,4 @@ function transform(fileInfo, api) {
 	}
 	return hasChanges ? root.toSource() : fileInfo.source;
 }
-//#endregion
 export { transform as default };

package/dist/codemod/transforms/import-rewrite.d.mts

@@ -1,8 +1,6 @@
 import { API, FileInfo } from "jscodeshift";
-//#region src/codemod/transforms/import-rewrite.d.ts
 /**
  * jscodeshift transform — rewrites all import/require/re-export paths
  * from `cmdk` to `modern-cmdk/react`.
  */
-export default function transform(fileInfo: FileInfo, api: API): string;
-//#endregion
+export default function transform(fileInfo: FileInfo, api: API): string;

package/dist/codemod/transforms/import-rewrite.mjs

@@ -1,4 +1,4 @@
-//#region src/codemod/transforms/import-rewrite.ts
+// src/codemod/transforms/import-rewrite.ts
 const OLD_PACKAGE = "cmdk";
 const NEW_PACKAGE = "modern-cmdk/react";
 /**
@@ -39,5 +39,4 @@ function transform(fileInfo, api) {
 	});
 	return hasChanges ? root.toSource() : fileInfo.source;
 }
-//#endregion
 export { transform as default };

package/dist/codemod/transforms/should-filter.d.mts

@@ -1,7 +1,5 @@
 import { API, FileInfo } from "jscodeshift";
-//#region src/codemod/transforms/should-filter.d.ts
 /**
  * jscodeshift transform — migrates shouldFilter prop to filter.
  */
-export default function transform(fileInfo: FileInfo, api: API): string;
-//#endregion
+export default function transform(fileInfo: FileInfo, api: API): string;

package/dist/codemod/transforms/should-filter.mjs

@@ -1,4 +1,4 @@
-//#region src/codemod/transforms/should-filter.ts
+// src/codemod/transforms/should-filter.ts
 /**
 * jscodeshift transform — migrates shouldFilter prop to filter.
 */
@@ -15,5 +15,4 @@ function transform(fileInfo, api) {
 	});
 	return hasChanges ? root.toSource() : fileInfo.source;
 }
-//#endregion
 export { transform as default };

package/dist/core/index.d.mts

@@ -1,9 +1,8 @@
-//#region src/core/search/types.d.ts
 /** Result of scoring a single item against a query */
 interface SearchResult {
   readonly id: ItemId;
   readonly score: number;
-  /** Character ranges that matched (for highlighting) — [start, end] tuples */
+  /** Character ranges that matched (for highlighting) — half-open [start, end) tuples, end exclusive */
   readonly matches: ReadonlyArray<readonly [start: number, end: number]>;
 }
 /** A scoring function that evaluates a single item against a query */
@@ -14,15 +13,13 @@ interface SearchEngine extends Disposable {
   index(items: readonly CommandItem[]): void;
   /** Search items by query, return ordered results — uses Iterator pipeline */
   search(query: string, items: readonly CommandItem[]): IteratorObject<SearchResult>;
-  /** Remove items from index — uses Set.difference for efficient bulk removal */
+  /** Remove items from index by id */
   remove(ids: ReadonlySet<ItemId>): void;
   /** Clear the entire index */
   clear(): void;
   /** Dispose resources */
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/types.d.ts
 /**
  * Branded type for command item IDs.
  * Prevents accidental mixing with plain strings at the type level.
@@ -165,7 +162,7 @@ interface FrecencyStorage extends Disposable {
   load(namespace: string): FrecencyData | Promise<FrecencyData>;
   save(namespace: string, data: FrecencyData): void | Promise<void>;
 }
-/** Frecency exponential decay bucket configuration */
+/** Frecency step-weight configuration per recency bucket (hour/day/week/month/older) */
 interface FrecencyDecayConfig {
   readonly hourWeight?: number | undefined;
   readonly dayWeight?: number | undefined;
@@ -182,7 +179,7 @@ interface FrecencyOptions {
 }
 /** Default frecency decay configuration */
 export declare const DEFAULT_FRECENCY_DECAY: Required<FrecencyDecayConfig>;
-/** Options for creating a command machine — const type param for narrowed option inference */
+/** Options for creating a command machine */
 interface CommandMachineOptions {
   /** Pre-registered items to populate on creation */
   readonly items?: readonly CommandItem[] | undefined;
@@ -208,17 +205,15 @@ interface CommandMachineOptions {
   readonly onSearchChange?: ((query: string) => void) | undefined;
   /** Whether keyboard navigation loops from last to first item (default: true) */
   readonly loop?: boolean | undefined;
-  /** Item count threshold for automatic virtualization (default: 100) */
+  /** Accepted but not read yet: Command.List uses fixed thresholds (on above 100 matches, off at 50 or fewer) (default: 100) */
   readonly virtualizeThreshold?: number | undefined;
 }
 /** Default machine options */
 export declare const DEFAULT_MACHINE_OPTIONS: Partial<CommandMachineOptions>;
 /** Initial state factory */
 export declare function createInitialState(options?: CommandMachineOptions): CommandState;
-//#endregion
-//#region src/core/frecency/idb-storage.d.ts
 /**
- * IndexedDB-backed frecency storage using idb-keyval 6.2.2.
+ * IndexedDB-backed frecency storage using idb-keyval.
  *
  * Persists frecency data across browser sessions. Implements both
  * `Disposable` and `AsyncDisposable` for use with `using` and `await using`.
@@ -252,12 +247,10 @@ export declare class IdbFrecencyStorage implements FrecencyStorage, AsyncDisposa
   /** Async dispose — marks as disposed, suitable for `await using` */
   [Symbol.asyncDispose](): Promise<void>;
 }
-//#endregion
-//#region src/core/frecency/index.d.ts
 /**
  * Computes a frecency bonus for an item based on usage frequency and recency.
  * Uses hour/day/week/month bucket boundaries with
- * configurable exponential decay weights per time bucket.
+ * configurable step weights per recency bucket (hour/day/week/month/older).
  */
 export declare function computeFrecencyBonus(history: FrecencyRecord, now?: number, config?: FrecencyDecayConfig): number;
 /**
@@ -288,8 +281,6 @@ export declare class FrecencyEngine implements Disposable, AsyncDisposable {
   [Symbol.asyncDispose](): Promise<void>;
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/frecency/memory-storage.d.ts
 /**
  * In-memory implementation of FrecencyStorage using a Map.
  * Data does not persist across page reloads. Suitable for ephemeral
@@ -299,14 +290,12 @@ export declare class MemoryFrecencyStorage implements FrecencyStorage {
   #private;
   load(namespace: string): FrecencyData;
   save(namespace: string, data: FrecencyData): void;
-  /** Serialize all stored data — Iterator Helpers pipeline (ES2026) */
+  /** Serialize all stored data — Iterator Helpers pipeline (ES2025) */
   toJSON(): Record<string, {
     records: Array<[string, FrecencyRecord]>;
   }>;
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/keyboard/parser.d.ts
 /**
  * Structured representation of a keyboard shortcut after parsing.
  * The `normalized` field provides a deterministic string for dedup and comparison.
@@ -330,8 +319,6 @@ export declare function parseShortcut(shortcut: string): ParsedShortcut;
  * On macOS: renders glyphs (⌘, ⇧, ⌥, ⌃). On other platforms: text labels joined by "+".
  */
 export declare function formatShortcut(parsed: ParsedShortcut): string;
-//#endregion
-//#region src/core/keyboard/matcher.d.ts
 /**
  * Tests whether a KeyboardEvent exactly matches a ParsedShortcut,
  * comparing all four modifier keys (meta, ctrl, shift, alt) and the primary key.
@@ -345,8 +332,6 @@ export declare function findMatchingShortcut(event: KeyboardEvent, shortcuts: re
  * mapGroupBy returns a Map directly — no Object.entries conversion needed.
  */
 export declare function detectConflicts(shortcuts: readonly ParsedShortcut[]): ReadonlyMap<string, readonly ParsedShortcut[]>;
-//#endregion
-//#region src/core/keyboard/index.d.ts
 interface ShortcutBinding {
   readonly shortcut: ParsedShortcut;
   readonly itemId: ItemId;
@@ -355,7 +340,7 @@ interface ShortcutBinding {
 /**
  * Manages keyboard shortcut bindings with global keydown listening.
  * Supports `using` for automatic cleanup of both individual bindings and the
- * global document listener. Detects conflicts via Map.groupBy (ES2026).
+ * global document listener. Detects conflicts with the local mapGroupBy helper (core/utils/group-by.ts).
  */
 export declare class KeyboardShortcutRegistry implements Disposable {
   #private;
@@ -376,8 +361,6 @@ export declare class KeyboardShortcutRegistry implements Disposable {
   getBindings(): ReadonlyMap<string, ShortcutBinding>;
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/registry.d.ts
 /**
  * Manages registration and lookup of command items and groups.
  * Uses set operation helpers (union/intersection/difference) for efficient ID operations.
@@ -431,8 +414,6 @@ export declare class CommandRegistry implements Disposable {
   clear(): void;
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/machine.d.ts
 /** Command machine — explicit resource management via `using` */
 interface CommandMachine extends Disposable {
   getState(): CommandState;
@@ -460,8 +441,6 @@ interface CommandMachine extends Disposable {
  * ```
  */
 export declare function createCommandMachine(options?: CommandMachineOptions): CommandMachine;
-//#endregion
-//#region src/core/search/default-scorer.d.ts
 /**
  * Public API: scores a command item against a search query.
  * Multi-strategy: exact → prefix → substring → word-boundary → fuzzy.
@@ -469,8 +448,6 @@ export declare function createCommandMachine(options?: CommandMachineOptions): C
  * which pre-caches lowercase and normalizes query once.
  */
 export declare function scoreItem(query: string, item: CommandItem): SearchResult | null;
-//#endregion
-//#region src/core/search/fuzzy-scorer.d.ts
 /**
  * Async-safe fuzzy scorer — wraps scoring in Promise for error resilience.
  * Falls back gracefully on error via synchronous-throw capture.
@@ -482,8 +459,6 @@ export declare function scoreItemAsync(query: string, item: CommandItem): Promis
  * entire scoring pipeline in one synchronous pass, wrapped for error safety.
  */
 export declare function batchScoreItems(query: string, items: readonly CommandItem[]): Promise<SearchResult[]>;
-//#endregion
-//#region src/core/search/index.d.ts
 interface SearchEngineOptions {
   readonly scorer?: ScorerFn | undefined;
 }
@@ -491,11 +466,9 @@ interface SearchEngineOptions {
  * Creates a search engine with pluggable scorer and incremental filtering.
  * When the query extends the previous one, only prior matches are re-scored.
  * Pre-caches lowercase at index time — zero toLowerCase() calls during search.
- * Uses Iterator Helpers (ES2026) for result pipelines and Set.difference for pruning.
+ * Uses Iterator Helpers (ES2025) for result pipelines.
  */
 export declare function createSearchEngine(options?: SearchEngineOptions): SearchEngine;
-//#endregion
-//#region src/core/telemetry.d.ts
 interface CommandTelemetryHooks {
   /** Called when the command palette opens */
   readonly onPaletteOpen?: () => void;
@@ -526,8 +499,6 @@ interface TelemetryMiddleware {
  * ```
  */
 export declare function createTelemetryMiddleware(hooks: CommandTelemetryHooks): TelemetryMiddleware;
-//#endregion
-//#region src/core/utils/event-emitter.d.ts
 type EventMap = {
   [key: string]: unknown;
 };
@@ -549,8 +520,6 @@ export declare class TypedEmitter<T extends EventMap> implements Disposable {
   removeAll(): void;
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/utils/scheduler.d.ts
 /**
  * Batched update scheduler that coalesces state updates into a single tick.
  * Uses requestAnimationFrame in browsers, queueMicrotask in Node.js/tests.
@@ -565,5 +534,4 @@ interface Scheduler extends Disposable {
  * execution pass using rAF (browser) or queueMicrotask (Node.js).
  */
 export declare function createScheduler(): Scheduler;
-//#endregion
 export type { CommandEvent, CommandGroup, CommandItem, CommandMachine, CommandMachineOptions, CommandState, CommandTelemetryHooks, FrecencyData, FrecencyDecayConfig, FrecencyOptions, FrecencyRecord, FrecencyStorage, GroupId, ItemId, ParsedShortcut, Scheduler, ScorerFn, SearchEngine, SearchResult, TelemetryMiddleware };

package/dist/core/index.mjs

@@ -1,4 +1,4 @@
-//#region src/core/utils/string-wellformed.ts
+// src/core/utils/string-wellformed.ts
 /**
 * Regex matching lone surrogates (unpaired high or low surrogates).
 * A lone high surrogate (U+D800–U+DBFF) not followed by a low surrogate,
@@ -15,8 +15,7 @@ const REPLACEMENT_CHAR = "�";
 function ensureWellFormed(str) {
 	return str.replace(LONE_SURROGATE_RE, REPLACEMENT_CHAR);
 }
-//#endregion
-//#region src/core/frecency/idb-storage.ts
+// src/core/frecency/idb-storage.ts
 /** Serialize a FrecencyRecord to a JSON-safe format */
 function serializeRecord(record) {
 	return {
@@ -45,7 +44,7 @@ function storageKey(namespace) {
 }
 let idbModule;
 /**
-* IndexedDB-backed frecency storage using idb-keyval 6.2.2.
+* IndexedDB-backed frecency storage using idb-keyval.
 *
 * Persists frecency data across browser sessions. Implements both
 * `Disposable` and `AsyncDisposable` for use with `using` and `await using`.
@@ -119,8 +118,7 @@ var IdbFrecencyStorage = class {
 		this.#disposed = true;
 	}
 };
-//#endregion
-//#region src/core/types.ts
+// src/core/types.ts
 /** Create a branded {@link ItemId} from a plain string. Ensures well-formed Unicode. */
 function itemId(id) {
 	return ensureWellFormed(id);
@@ -158,8 +156,7 @@ function createInitialState(options) {
 		lastUpdated: Date.now()
 	};
 }
-//#endregion
-//#region src/core/frecency/memory-storage.ts
+// src/core/frecency/memory-storage.ts
 /**
 * In-memory implementation of FrecencyStorage using a Map.
 * Data does not persist across page reloads. Suitable for ephemeral
@@ -173,7 +170,7 @@ var MemoryFrecencyStorage = class {
 	save(namespace, data) {
 		this.#store.set(namespace, data);
 	}
-	/** Serialize all stored data — Iterator Helpers pipeline (ES2026) */
+	/** Serialize all stored data — Iterator Helpers pipeline (ES2025) */
 	toJSON() {
 		return Object.fromEntries(this.#store.entries().map(([namespace, data]) => [namespace, { records: data.records.entries().toArray() }]));
 	}
@@ -181,11 +178,10 @@ var MemoryFrecencyStorage = class {
 		this.#store.clear();
 	}
 };
-//#endregion
-//#region src/core/frecency/index.ts
+// 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 */
+/** Bucket boundaries as hour constants — no per-call unit conversion */
 const BUCKET_HOURS = {
 	hour: 1,
 	day: 24,
@@ -195,7 +191,7 @@ const BUCKET_HOURS = {
 /**
 * Computes a frecency bonus for an item based on usage frequency and recency.
 * Uses hour/day/week/month bucket boundaries with
-* configurable exponential decay weights per time bucket.
+* configurable step weights per recency bucket (hour/day/week/month/older).
 */
 function computeFrecencyBonus(history, now = Date.now(), config = DEFAULT_FRECENCY_DECAY) {
 	const hours = (now - history.lastUsed) / 36e5;
@@ -284,8 +280,7 @@ var FrecencyEngine = class {
 		this.#storage[Symbol.dispose]();
 	}
 };
-//#endregion
-//#region src/core/utils/group-by.ts
+// src/core/utils/group-by.ts
 /**
 * Groups items from an iterable into a Map keyed by the result of `keyFn`.
 * Cross-browser replacement for `Map.groupBy()`.
@@ -300,8 +295,7 @@ function mapGroupBy(items, keyFn) {
 	}
 	return map;
 }
-//#endregion
-//#region src/core/keyboard/matcher.ts
+// src/core/keyboard/matcher.ts
 /**
 * Tests whether a KeyboardEvent exactly matches a ParsedShortcut,
 * comparing all four modifier keys (meta, ctrl, shift, alt) and the primary key.
@@ -326,8 +320,7 @@ function detectConflicts(shortcuts) {
 	const grouped = mapGroupBy(shortcuts, (s) => s.normalized);
 	return new Map(grouped.entries().filter(([, group]) => group.length > 1));
 }
-//#endregion
-//#region src/core/keyboard/parser.ts
+// src/core/keyboard/parser.ts
 const isMac = typeof navigator !== "undefined" && (navigator.userAgentData?.platform === "macOS" || /Mac|iPod|iPhone|iPad/.test(navigator.platform));
 /** Modifier aliases — cross-platform Mod resolution */
 const MODIFIER_MAP = {
@@ -400,12 +393,11 @@ function formatShortcut(parsed) {
 	parts.push(displayKey);
 	return isMac ? parts.join("") : parts.join("+");
 }
-//#endregion
-//#region src/core/keyboard/index.ts
+// src/core/keyboard/index.ts
 /**
 * Manages keyboard shortcut bindings with global keydown listening.
 * Supports `using` for automatic cleanup of both individual bindings and the
-* global document listener. Detects conflicts via Map.groupBy (ES2026).
+* global document listener. Detects conflicts with the local mapGroupBy helper (core/utils/group-by.ts).
 */
 var KeyboardShortcutRegistry = class {
 	#bindings = /* @__PURE__ */ new Map();
@@ -472,8 +464,7 @@ var KeyboardShortcutRegistry = class {
 		this.#bindings.clear();
 	}
 };
-//#endregion
-//#region src/core/utils/set-ops.ts
+// src/core/utils/set-ops.ts
 /** Returns a new Set containing elements present in both `a` and `b`. */
 function setIntersection(a, b) {
 	const result = /* @__PURE__ */ new Set();
@@ -516,8 +507,7 @@ function setSymmetricDifference(a, b) {
 	else result.add(item);
 	return result;
 }
-//#endregion
-//#region src/core/registry.ts
+// src/core/registry.ts
 /**
 * Manages registration and lookup of command items and groups.
 * Uses set operation helpers (union/intersection/difference) for efficient ID operations.
@@ -678,8 +668,23 @@ var CommandRegistry = class {
 		this.clear();
 	}
 };
-//#endregion
-//#region src/core/search/default-scorer.ts
+// src/core/utils/env.ts
+/**
+* `true` unless `process.env.NODE_ENV` is `'production'`.
+*
+* Consumer bundlers (Vite, webpack, Next, esbuild) replace `process.env.NODE_ENV` statically,
+* so the dev-only branches guarded by this flag fold away in production builds. A browser
+* running the unbundled module throws a ReferenceError on the bare `process` reference;
+* the catch turns that into the production value (`false`), so dev-only code stays off.
+*/
+const isDev = (() => {
+	try {
+		return process.env.NODE_ENV !== "production";
+	} catch {
+		return false;
+	}
+})();
+// src/core/search/default-scorer.ts
 function isWordSeparator(code) {
 	return code === 32 || code === 9 || code === 45 || code === 95 || code === 46 || code === 47 || code === 92;
 }
@@ -841,18 +846,16 @@ function scoreFuzzy(query, qLen, lowerTarget, tLen) {
 		matches
 	};
 }
-//#endregion
-//#region src/core/search/index.ts
-const __DEV__ = globalThis.process ? globalThis.process.env.NODE_ENV !== "production" : false;
+// src/core/search/index.ts
 let leakRegistry;
-if (__DEV__) leakRegistry = new FinalizationRegistry((label) => {
+if (isDev && typeof window !== "undefined") leakRegistry = new FinalizationRegistry((label) => {
 	console.warn(`[modern-cmdk] ${label} was garbage collected without being disposed. Use \`using\` or call [Symbol.dispose]() to prevent leaks.`);
 });
 /**
 * Creates a search engine with pluggable scorer and incremental filtering.
 * When the query extends the previous one, only prior matches are re-scored.
 * Pre-caches lowercase at index time — zero toLowerCase() calls during search.
-* Uses Iterator Helpers (ES2026) for result pipelines and Set.difference for pruning.
+* Uses Iterator Helpers (ES2025) for result pipelines.
 */
 function createSearchEngine(options) {
 	const customScorer = options?.scorer;
@@ -861,7 +864,7 @@ function createSearchEngine(options) {
 	let previousQuery = "";
 	let previousResults = /* @__PURE__ */ new Set();
 	const sentinel = {};
-	if (__DEV__ && leakRegistry) leakRegistry.register(sentinel, "SearchEngine", sentinel);
+	if (leakRegistry) leakRegistry.register(sentinel, "SearchEngine", sentinel);
 	return {
 		index(items) {
 			for (const item of items) indexedEntries.set(item.id, {
@@ -911,12 +914,11 @@ function createSearchEngine(options) {
 		[Symbol.dispose]() {
 			indexedEntries.clear();
 			previousResults.clear();
-			if (__DEV__ && leakRegistry) leakRegistry.unregister(sentinel);
+			if (leakRegistry) leakRegistry.unregister(sentinel);
 		}
 	};
 }
-//#endregion
-//#region src/core/utils/event-emitter.ts
+// src/core/utils/event-emitter.ts
 /**
 * Type-safe event emitter with strong references and Disposable subscriptions.
 * Returns Disposable from `on()` for automatic unsubscription via `using`.
@@ -959,13 +961,13 @@ var TypedEmitter = class {
 		this.#listeners.clear();
 	}
 };
-//#endregion
-//#region src/core/utils/scheduler.ts
+// src/core/utils/scheduler.ts
 /** Whether we're in a browser environment with rAF available */
 const hasRAF = typeof requestAnimationFrame === "function";
-/** Feature detection for cutting-edge scheduling APIs */
+/** Feature detection for cutting-edge scheduling APIs, read through globalThis: typeof guards only a bare
+* identifier, so `typeof navigator?.scheduling` would throw where navigator is undeclared (runtimes without one). */
 const canYield = typeof globalThis.scheduler?.yield === "function";
-const hasInputPending = typeof navigator?.scheduling?.isInputPending === "function";
+const hasInputPending = typeof globalThis.navigator?.scheduling?.isInputPending === "function";
 /**
 * Creates a batched update scheduler. Coalesces rapid state updates into a single
 * execution pass using rAF (browser) or queueMicrotask (Node.js).
@@ -1021,8 +1023,7 @@ function createScheduler() {
 		}
 	};
 }
-//#endregion
-//#region src/core/machine.ts
+// src/core/machine.ts
 /**
 * Creates a headless command palette state machine with search, frecency,
 * and keyboard shortcut support. Implements Disposable for `using` cleanup.
@@ -1288,8 +1289,7 @@ function createCommandMachine(options = {}) {
 		}
 	};
 }
-//#endregion
-//#region src/core/search/fuzzy-scorer.ts
+// src/core/search/fuzzy-scorer.ts
 /**
 * Async-safe fuzzy scorer — wraps scoring in Promise for error resilience.
 * Falls back gracefully on error via synchronous-throw capture.
@@ -1309,8 +1309,7 @@ function batchScoreItems(query, items) {
 		resolve(items.values().map((item) => scoreItem(query, item)).filter((r) => r != null).toArray().toSorted((a, b) => b.score - a.score));
 	});
 }
-//#endregion
-//#region src/core/telemetry.ts
+// src/core/telemetry.ts
 /**
 * Creates a telemetry middleware that measures command palette interactions.
 * Uses Date.now() for millisecond-precision timestamps
@@ -1347,5 +1346,4 @@ function createTelemetryMiddleware(hooks) {
 		}
 	};
 }
-//#endregion
 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 };