modern-cmdk 1.1.1 → 1.1.4

package/README.md

@@ -99,7 +99,7 @@ A ground-up rewrite of `cmdk` for **React 19**, **ES2026**, and **TypeScript 6**
 | **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 |
+| **Ranking** | Static order | Frecency with time-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 |
@@ -118,8 +118,8 @@ A ground-up rewrite of `cmdk` for **React 19**, **ES2026**, and **TypeScript 6**
 - **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.
+- **Frecency ranking** -- Frequency x recency with time-based exponential decay. Pluggable persistence (memory or IndexedDB).
+- **Keyboard shortcuts** -- Built-in registry with cross-platform `Mod` key, conflict detection, and `RegExp.escape` parsing. Cross-browser helper functions for grouping and set operations.
 - **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.

package/dist/codemod/cli.mjs

@@ -89714,7 +89714,7 @@ var require_core = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = enrichCore(core, getParser());
 }));
 //#endregion
-//#region src/codemod/cli.ts
+//#region src/core/utils/group-by.ts
 var import_jscodeshift = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
 	/**
 	* Copyright (c) Facebook, Inc. and its affiliates.
@@ -89724,6 +89724,22 @@ var import_jscodeshift = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(
 	*/
 	module.exports = require_core();
 })))(), 1);
+/**
+* Groups items from an iterable into a plain object keyed by the string result of `keyFn`.
+* Cross-browser replacement for `Object.groupBy()`.
+*/
+function objectGroupBy(items, keyFn) {
+	const result = Object.create(null);
+	for (const item of items) {
+		const key = keyFn(item);
+		const existing = result[key];
+		if (existing) existing.push(item);
+		else result[key] = [item];
+	}
+	return result;
+}
+//#endregion
+//#region src/codemod/cli.ts
 const AVAILABLE_TRANSFORMS = new Map([
 	["import-rewrite", "Rewrites cmdk imports to modern-cmdk/react"],
 	["data-attrs", "Converts [cmdk-*] selectors to [data-command-*]"],
@@ -89802,7 +89818,10 @@ async function main() {
 		stats: () => {},
 		report: () => {}
 	});
-	const { promise: done, resolve: resolveDone } = Promise.withResolvers();
+	let resolveDone;
+	const done = new Promise((r) => {
+		resolveDone = r;
+	});
 	const allResults = [];
 	for await (const batch of chunked(files, concurrency)) (await Promise.allSettled(batch.map((filePath) => processFile(filePath, transformFn, apiForParser, dryRun)))).values().forEach((result) => {
 		if (result.status === "fulfilled") allResults.push(result.value);
@@ -89813,8 +89832,7 @@ async function main() {
 		});
 	});
 	resolveDone(allResults);
-	const results = await done;
-	const grouped = Object.groupBy(results, (r) => {
+	const grouped = objectGroupBy(await done, (r) => {
 		if (r.error) return "errors";
 		if (r.changed) return "changed";
 		return "unchanged";

package/dist/core/index.d.mts

@@ -45,9 +45,9 @@ declare const __groupIdBrand: unique symbol;
 type GroupId = string & {
   readonly [__groupIdBrand]: never;
 };
-/** Create a branded {@link ItemId} from a plain string. Ensures well-formed Unicode (ES2026). */
+/** Create a branded {@link ItemId} from a plain string. Ensures well-formed Unicode. */
 declare function itemId(id: string): ItemId;
-/** Create a branded {@link GroupId} from a plain string. Ensures well-formed Unicode (ES2026). */
+/** Create a branded {@link GroupId} from a plain string. Ensures well-formed Unicode. */
 declare function groupId(id: string): GroupId;
 /**
 * A registered command item in the palette.
@@ -107,8 +107,8 @@ interface CommandState {
   readonly pageStack: readonly string[];
   /** Whether the command palette dialog is open */
   readonly open: boolean;
-  /** Temporal.Instant of the last state mutation (ES2026) */
-  readonly lastUpdated: Temporal.Instant;
+  /** Epoch-millisecond timestamp of the last state mutation */
+  readonly lastUpdated: number;
 }
 /** All possible events the state machine accepts */
 type CommandEvent = {
@@ -153,7 +153,8 @@ type CommandEvent = {
 /** Frecency record for a single item */
 interface FrecencyRecord {
   readonly frequency: number;
-  readonly lastUsed: Temporal.Instant;
+  /** Epoch-millisecond timestamp of last usage */
+  readonly lastUsed: number;
 }
 /** Complete frecency data for persistence */
 interface FrecencyData {
@@ -255,14 +256,14 @@ declare class IdbFrecencyStorage implements FrecencyStorage, AsyncDisposable {
 //#region src/core/frecency/index.d.ts
 /**
 * Computes a frecency bonus for an item based on usage frequency and recency.
-* Uses Temporal.Duration bucket boundaries (hour/day/week/month) with
+* Uses hour/day/week/month bucket boundaries with
 * configurable exponential decay weights per time bucket.
 */
-declare function computeFrecencyBonus(history: FrecencyRecord, now?: Temporal.Instant, config?: FrecencyDecayConfig): number;
+declare function computeFrecencyBonus(history: FrecencyRecord, now?: number, config?: FrecencyDecayConfig): number;
 /**
 * Stateful frecency engine that tracks item selection history and provides
 * ranking boosts for search results. Supports pluggable storage backends
-* and automatic flush on dispose. Uses Temporal.Now.instant() for timestamps.
+* and automatic flush on dispose. Uses Date.now() for timestamps.
 */
 declare class FrecencyEngine implements Disposable, AsyncDisposable {
   #private;
@@ -272,9 +273,9 @@ declare class FrecencyEngine implements Disposable, AsyncDisposable {
   /** Record a selection event for an item */
   recordSelection(itemId: ItemId): void;
   /** Get frecency bonus for an item */
-  getBonus(itemId: ItemId, now?: Temporal.Instant): number;
+  getBonus(itemId: ItemId, now?: number): number;
   /** Get all frecency bonuses as a map — for...of for hot ranking path (no closure overhead) */
-  getAllBonuses(now?: Temporal.Instant): ReadonlyMap<ItemId, number>;
+  getAllBonuses(now?: number): ReadonlyMap<ItemId, number>;
   /** Get the decay configuration */
   getConfig(): FrecencyDecayConfig;
   /** Update decay configuration at runtime */
@@ -321,7 +322,7 @@ interface ParsedShortcut {
 }
 /**
 * Parse a shortcut string like "Mod+Shift+K" into a structured ParsedShortcut.
-* Uses String.isWellFormed() (ES2026) to ensure valid Unicode input.
+* Ensures valid Unicode input via ensureWellFormed helper.
 */
 declare function parseShortcut(shortcut: string): ParsedShortcut;
 /**
@@ -340,8 +341,8 @@ declare function matchesShortcut(event: KeyboardEvent, shortcut: ParsedShortcut)
 declare function findMatchingShortcut(event: KeyboardEvent, shortcuts: readonly ParsedShortcut[]): ParsedShortcut | null;
 /**
 * Detects conflicting shortcut bindings by grouping on their normalized form
-* via Map.groupBy (ES2026). Returns only groups with two or more colliding shortcuts.
-* Map.groupBy returns a Map directly — no Object.entries conversion needed.
+* via mapGroupBy helper. Returns only groups with two or more colliding shortcuts.
+* mapGroupBy returns a Map directly — no Object.entries conversion needed.
 */
 declare function detectConflicts(shortcuts: readonly ParsedShortcut[]): ReadonlyMap<string, readonly ParsedShortcut[]>;
 //#endregion
@@ -379,7 +380,7 @@ declare class KeyboardShortcutRegistry implements Disposable {
 //#region src/core/registry.d.ts
 /**
 * Manages registration and lookup of command items and groups.
-* Uses ES2026 Set methods (union/intersection/difference) for efficient ID operations.
+* Uses set operation helpers (union/intersection/difference) for efficient ID operations.
 * All registration methods return Disposable for automatic cleanup via `using`.
 */
 declare class CommandRegistry implements Disposable {
@@ -390,7 +391,7 @@ declare class CommandRegistry implements Disposable {
   registerItems(items: readonly CommandItem[]): Disposable;
   /** Unregister a single item — O(1) Map/Set delete, indexOf+toSpliced for order */
   unregisterItem(id: ItemId): void;
-  /** Bulk unregister using Set.difference (ES2026) — for...of for hot path */
+  /** Bulk unregister — for...of for hot path */
   unregisterItems(ids: ReadonlySet<ItemId>): void;
   /** Register a group */
   registerGroup(group: CommandGroup): Disposable;
@@ -404,23 +405,23 @@ declare class CommandRegistry implements Disposable {
   getItems(): readonly CommandItem[];
   /** Get all registered groups sorted by priority — cached between group mutations */
   getGroups(): readonly CommandGroup[];
-  /** Get items grouped by groupId using Map.groupBy (ES2026) — direct Map, no Object.entries conversion */
+  /** Get items grouped by groupId — direct Map, no Object.entries conversion */
   getGroupedItems(): ReadonlyMap<GroupId, readonly CommandItem[]>;
   /** Get item IDs as a Set — returns internal set (O(1), no allocation) */
   getItemIds(): ReadonlySet<ItemId>;
-  /** Find intersection of registered items with a candidate set (ES2026 Set.intersection) */
+  /** Find intersection of registered items with a candidate set */
   intersectWith(candidateIds: ReadonlySet<ItemId>): ReadonlySet<ItemId>;
-  /** Find items registered but not in a given set (ES2026 Set.difference) */
+  /** Find items registered but not in a given set */
   differenceFrom(otherIds: ReadonlySet<ItemId>): ReadonlySet<ItemId>;
-  /** Union of registered IDs with another set (ES2026 Set.union) */
+  /** Union of registered IDs with another set */
   unionWith(otherIds: ReadonlySet<ItemId>): ReadonlySet<ItemId>;
-  /** Check if registered items are a subset of the given set (ES2026 Set.isSubsetOf) */
+  /** Check if registered items are a subset of the given set */
   isSubsetOf(otherIds: ReadonlySet<ItemId>): boolean;
-  /** Check if registered items are a superset of the given set (ES2026 Set.isSupersetOf) */
+  /** Check if registered items are a superset of the given set */
   isSupersetOf(otherIds: ReadonlySet<ItemId>): boolean;
-  /** Check if registered items share no IDs with the given set (ES2026 Set.isDisjointFrom) */
+  /** Check if registered items share no IDs with the given set */
   isDisjointFrom(otherIds: ReadonlySet<ItemId>): boolean;
-  /** Symmetric difference between registered IDs and another set (ES2026 Set.symmetricDifference) */
+  /** Symmetric difference between registered IDs and another set */
   symmetricDifferenceWith(otherIds: ReadonlySet<ItemId>): ReadonlySet<ItemId>;
   /** Total number of registered items */
   get size(): number;
@@ -471,12 +472,12 @@ declare function scoreItem(query: string, item: CommandItem): SearchResult | nul
 //#endregion
 //#region src/core/search/fuzzy-scorer.d.ts
 /**
-* Async-safe fuzzy scorer — wraps scoring in Promise.try (ES2026) for error resilience.
-* Falls back gracefully on error via Promise.try's synchronous-throw capture.
+* Async-safe fuzzy scorer — wraps scoring in Promise for error resilience.
+* Falls back gracefully on error via synchronous-throw capture.
 */
 declare function scoreItemAsync(query: string, item: CommandItem): Promise<SearchResult | null>;
 /**
-* Batch score items synchronously inside a single Promise.try (ES2026).
+* Batch score items synchronously inside a single Promise.
 * Eliminates per-item microtask overhead from async generators — runs the
 * entire scoring pipeline in one synchronous pass, wrapped for error safety.
 */
@@ -508,13 +509,13 @@ interface CommandTelemetryHooks {
 interface TelemetryMiddleware {
   readonly onOpen: () => void;
   readonly onClose: () => void;
-  readonly onSearch: (query: string, resultCount: number, startTime: Temporal.Instant) => void;
+  readonly onSearch: (query: string, resultCount: number, startTime: number) => void;
   readonly onSelect: (itemId: ItemId, query: string, position: number) => void;
 }
 /**
 * Creates a telemetry middleware that measures command palette interactions.
-* Uses Temporal.Now.instant() (ES2026) for nanosecond-precision timestamps
-* and Temporal.Instant.since() for accurate duration computation.
+* Uses Date.now() for millisecond-precision timestamps
+* and subtraction for duration computation.
 *
 * @example
 * ```ts