modern-cmdk 1.3.0 → 1.5.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Crimson Dev
+Copyright (c) 2026 Albert Badalov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -9,11 +9,7 @@
 
 <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://github.com/ABCrimson/modern-cmdk/blob/main/package.json"><img alt="core size budget" src="https://img.shields.io/badge/core-%3C%206.5%20kB%20gzip-dc2626?style=flat-square&labelColor=0a0e27"/></a>
-  <a href="https://github.com/ABCrimson/modern-cmdk/blob/main/package.json"><img alt="react size budget" src="https://img.shields.io/badge/react-%3C%2012%20kB%20gzip-dc2626?style=flat-square&labelColor=0a0e27"/></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-7-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>
 
@@ -26,32 +22,42 @@
 
 ---
 
+A ground-up rewrite of `cmdk` for **React 19**, written in modern ECMAScript: a framework-agnostic state machine (search, frecency ranking, keyboard shortcuts) in the core, and a thin React adapter on top.
+
 ## Install
 
 ```bash
 npm install modern-cmdk
 ```
 
-> [!NOTE]
-> `modern-cmdk` is ESM-only and declares `engines.node >= 26.4.0`. The optional WASM search
-> engine (`modern-cmdk-search-wasm`) is a private, unpublished workspace package (0.9.0) that you
-> build from source; it is not on npm.
-
-The package exports three entry points:
+The package exports four 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
+import { createCommandMachine } from 'modern-cmdk';            // Core engine (no React)
+import { Command } from 'modern-cmdk/react';                    // React components
+import { CommandDialog } from 'modern-cmdk/react/dialog';       // CommandDialog alone
+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. `modern-cmdk/react` imports `react`, `react-dom` and `radix-ui`, which are optional peers that npm and pnpm do not install for you, so add them yourself (the Quick Start below needs all three):
+`modern-cmdk` is ESM-only. The core entry imports no peer. Every import of `modern-cmdk/react` and of `modern-cmdk/react/dialog` loads `react`, `react-dom` and `radix-ui` (the `radix-ui` import is static), so these are the peers:
+
+| Peer | Range | Status |
+|---|---|---|
+| `react` | `>=19.0.0 <21.0.0` | optional (only the React entries use it) |
+| `react-dom` | `>=19.0.0 <21.0.0` | optional (only the React entries use it) |
+| `radix-ui` | `>=1.4.0 <2.0.0` | required through 1.x |
+
+`radix-ui` is a required peer of `modern-cmdk` in 1.x, so npm 7+ and pnpm install it with `modern-cmdk` (or warn when they cannot), and with it its own required peers `react` and `react-dom`, even when you use only the core; `modern-cmdk` itself marks only `react` and `react-dom` optional. It becomes optional again in 2.0, when the barrel drops `Command.Dialog` and only `modern-cmdk/react/dialog` needs it. For the React entries, add the React peers yourself:
 
 ```bash
-npm install modern-cmdk react react-dom radix-ui
+npm install modern-cmdk react react-dom
 ```
 
----
+`Command.Dialog` stays on the `modern-cmdk/react` barrel through 1.x and leaves it in 2.0; `modern-cmdk/react/dialog` exports `CommandDialog` alone.
+
+`modern-cmdk-codemod` and `create-modern-cmdk` support Node >=26.4.0 and declare it in `engines`; the deprecated `modern-cmdk` bin is supported on it too. `modern-cmdk` itself declares no `engines`.
+
+`sideEffects` lists only `./dist/react/styles.css`; every JavaScript entry is side-effect-free for bundlers.
 
 ## Quick Start
 
@@ -106,92 +112,17 @@ function CommandPalette() {
 }
 ```
 
-`<Command label="Command menu">` takes the same children inline, with no dialog; `<Command.Highlight text={...} ranges={...} />` renders match highlighting from scorer ranges.
-
-Or scaffold a new project:
-
-```bash
-npm create modern-cmdk@latest my-palette -- --template=react-basic
-```
-
----
-
-## Why modern-cmdk?
-
-A ground-up rewrite of `cmdk` for **React 19** and **TypeScript 7**, written in modern ECMAScript. 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 | 19 (`use()`, `useOptimistic`, `useId`, `ref` as prop) |
-| **Search** | Fuzzy (`command-score`) | Fuzzy scoring with match ranges; an experimental WASM engine (unpublished, does not work yet) |
-| **Ranking** | Static order | Frecency: frequency x bucketed recency weights |
-| **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** | not compared | Core ~6.4 kB, React ~9.8 kB gzip (budgets: < 6.5 kB, < 12 kB) |
-| **TypeScript** | 4.x/5.x | 7, 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. No React. No hard DOM dependency; DOM APIs are feature-detected and SSR-safe. Portable to any runtime. The sole runtime dependency (`idb-keyval`) is lazy-loaded only if you opt into IndexedDB frecency persistence.
-- **React 19 adapter** -- a `Command` root with 14 compound sub-components (`Command.Input` through `Command.Activity`). `useSyncExternalStore`, `useTransition`, `useOptimistic`, `use()` for Suspense. React Compiler compatible.
-- **Automatic virtualization** -- Variable-height virtual scrolling turns on when more than 100 items match and off again at 50 or fewer (fixed thresholds; force it with `<Command.List virtualize>`). Off-screen items use `content-visibility: auto`. The `virtualizeThreshold` option is accepted but not read yet.
-- **Fuzzy search** -- Built-in TypeScript scorer with incremental filtering. Experimental Rust/WASM engine _(private, not published to npm)_; it does not work yet and always falls back to the TS scorer.
-- **Frecency ranking** -- Frequency x recency, weighted by hour/day/week/month buckets. Pluggable persistence (memory or IndexedDB).
-- **Keyboard shortcuts** -- Built-in registry with cross-platform `Mod` key, and conflict detection. 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.
-- **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 -- the framework-agnostic core is side-effect-free; only the React entry and `styles.css` are flagged in `sideEffects`. Isolated declarations.
+`<Command label="Command menu">` takes the same children inline, with no dialog; `<Command.Highlight text={...} ranges={...} />` renders match highlighting from scorer ranges. To scaffold a project instead: `npm create modern-cmdk@latest my-palette -- --template=react-basic`.
 
----
-
-## 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 />  {/* renders when the `loading` prop is true (or while the active-item transition is pending) */}
-    <Command.Group>      {/* Labeled group of items */}
-      <Command.Item>     {/* Selectable item */}
-        <Command.Highlight text={label} ranges={ranges} />   {/* 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:
+## Core API (no React)
 
 ```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() },
+    { id: itemId('copy'), value: 'Copy', shortcut: 'Mod+C', onSelect: () => navigator.clipboard.writeText(getSelection()?.toString() ?? '') },
+    { id: itemId('paste'), value: 'Paste', shortcut: 'Mod+V', onSelect: () => navigator.clipboard.readText().then((text) => console.log('Pasted:', text)) },
   ],
   frecency: { enabled: true },
   loop: true,
@@ -207,114 +138,87 @@ machine.subscribe(() => {
 // Automatic cleanup via `using` -- no manual dispose needed
 ```
 
----
-
-## Performance
+## What is in it
 
-| Benchmark | Target | Measured (CI runner) |
-|---|---|---|
-| Search 10K items (TS scorer) | < 16 ms | ~3.5 ms median |
-| State update: `SEARCH_CHANGE` | < 4 ms | ~0.37 ms median |
-| State update: `NAVIGATE` | < 1 ms | ~0.00075 ms median |
-| Core bundle (gzipped) | <= 6.5 KB | ~6.4 KB |
-| React bundle (gzipped) | <= 12 KB | ~9.8 KB |
+- **Framework-agnostic core** -- a pure TypeScript state machine; DOM APIs are feature-detected and SSR-safe. The sole runtime dependency (`idb-keyval`) is lazy-loaded only if you opt into IndexedDB frecency persistence.
+- **React 19 adapter** -- compound components over `useSyncExternalStore`, `useTransition` and `use()`; React Compiler compatible.
+- **Automatic virtualization** -- turns on when more than 100 items match and off again at 50 or fewer (fixed thresholds; force it with `<Command.List virtualize>` or `virtualize={false}`). The `virtualizeThreshold` option is accepted but not read yet.
+- **Fuzzy search and frecency** -- a built-in TypeScript scorer with match ranges, and frequency x recency ranking with memory or IndexedDB persistence. `modern-cmdk-search-wasm` is an experimental, unpublished workspace package that does not work yet.
+- **Keyboard shortcuts** -- a registry with a cross-platform `Mod` key and conflict detection.
+- **Accessibility** -- WAI-ARIA combobox pattern, `aria-live` announcements, `forced-colors`, `prefers-contrast`, `prefers-reduced-motion`.
+- **Animation** -- the stylesheet defines the dialog enter and exit on opacity, scale and translate, which are compositor-only; the overlay fades opacity and also transitions `--command-overlay-opacity`, its background alpha, which repaints, and the list height and item background-color transitions are not compositor-only either. In 1.x neither the dialog nor the overlay animates on enter or exit, because their duration and easing tokens are declared only on `[data-command-root]`, which sits inside the dialog (DT-19, planned for 1.8.0).
+- **Extras** -- `CommandErrorBoundary`, `useCommandDevtools()` and telemetry middleware.
 
-Timings are medians from `benchmarks/baseline.json`: one CI run of the standalone harness, three runs of 1,000 iterations averaged, measured on a shared GitHub Actions
-runner (noise is +/-20-40 %). CI compares new runs against that baseline with 5 % warning / 15 % failure
-thresholds as a coarse tripwire, not a precise regression gate; the `NAVIGATE` baseline sits below the 0.01 ms noise floor and is reported, not compared, and a median above its target fails. There is no published WASM benchmark.
+Theming (CSS custom properties, `@layer command`) is covered in the [theming guide](https://abcrimson.github.io/modern-cmdk/guide/theming.html).
 
----
+## Sizes
 
-## 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);
-  --command-muted-color: light-dark(oklch(0.45 0.015 260), oklch(0.75 0.015 260));
-}
-```
+Figures come from [`benchmarks/size-history/1.5.0.json`](https://github.com/ABCrimson/modern-cmdk/blob/4498a0f/benchmarks/size-history/1.5.0.json) (committed in `4498a0f`, measured at `d5ce6ff` on 2026-11-07 with size-limit 14.3.0 and `npm pack --dry-run --json`). Method: size-limit, gzip, peers (`react`, `react-dom`, `radix-ui`) ignored; the codemod entries are raw installed size of the files named.
 
-`--command-muted-color` colours secondary text (group headings, shortcuts, the empty state, the
-placeholder). Its default uses `light-dark()`, which follows the used `color-scheme`: set
-`color-scheme` on `:root` or a parent (for example `color-scheme: dark` on a dark theme), or override
-`--command-muted-color`. A dark-themed page that sets no `color-scheme` gets the light value on its dark
-surface (about 2.4:1 contrast).
+| Entry | Bytes | Limit | Method |
+|---|---|---|---|
+| `modern-cmdk` (core) | 6399 | 6500 | gzip |
+| `modern-cmdk/react`, adapter only | 5539 | 5600 | gzip, `modern-cmdk` ignored |
+| `modern-cmdk` + `modern-cmdk/react` | 10003 | 10100 | gzip, core included |
+| `modern-cmdk/react/dialog`, adapter only | 1422 | 1500 | gzip, `modern-cmdk` ignored |
+| `modern-cmdk/react`, `CommandSeparator` only | 4812 | 5000 | gzip, `modern-cmdk` ignored; still contains `CommandDialog`, `CommandRoot` and the `radix-ui` import (tree-shaking of the barrel is a 2.0 item) |
+| `modern-cmdk/styles.css` | 3959 | 4000 | gzip |
+| codemod bin (`dist/codemod/*.mjs` plus `dist/codemod/transforms/*.mjs`) | 3150372 | 3400000 | raw installed size, not gzip |
+| codemod shim (`dist/codemod/bin.mjs`) | 897 | 1000 | raw installed size, not gzip |
 
-All styles use `@layer command` for zero-specificity conflicts and CSS logical properties for full RTL support.
-
----
+The packed `modern-cmdk` tarball: 1.4 (built from `release/1.4.0` at `b77f133` and measured on 2026-11-05; not on npm) is 992157 B packed and 3473079 B unpacked in 16 entries, of which 147286 B is runtime and 3325793 B is the codemod; the 1.5 release candidate is 962822 B packed and 3315632 B unpacked in 22 entries, of which 165260 B is runtime (152384 B without `THIRD-PARTY-NOTICES.md`, which is 12876 B) and 3150372 B is the codemod, including the 897 B shim. The codemod's own package, `modern-cmdk-codemod`, is 33119 B packed and 113416 B unpacked in 11 entries; `jscodeshift` is not in that tarball.
 
 ## Migration from cmdk
 
-Four codemods ship as the `modern-cmdk` bin. Pass a transform name and a glob (quote the glob so your
-shell does not expand it):
+The codemods live in their own package, [`modern-cmdk-codemod`](https://github.com/ABCrimson/modern-cmdk/tree/main/packages/modern-cmdk-codemod) (Node >= 26.4.0; see its README for every option and exit code). Pass a transform name and a directory or a glob (quote the glob so your shell does not expand it). A real run needs a git work tree with the matched files committed, or `--force`; a dry run needs neither:
 
 ```bash
-npx modern-cmdk --help
-npx modern-cmdk import-rewrite "./src/**/*.tsx" --dry-run
-npx modern-cmdk import-rewrite "./src/**/*.tsx"
+npx modern-cmdk-codemod --help
+npx modern-cmdk-codemod --dry-run import-rewrite ./src
+git status --short   # empty: everything committed
+npx modern-cmdk-codemod import-rewrite ./src
 ```
 
+Run all four in this order, committing after each: `should-filter`, `forward-ref`, `data-attrs`, `import-rewrite`.
+
 | Transform | What it does |
 |---|---|
-| `import-rewrite` | Rewrites `cmdk` imports to `modern-cmdk/react` |
-| `data-attrs` | Converts `[cmdk-*]` selectors to `[data-command-*]` |
-| `forward-ref` | Removes `React.forwardRef` wrappers (React 19) |
-| `should-filter` | Converts the `shouldFilter` prop to `filter` |
+| `import-rewrite` | Rewrites imports, re-exports, `import()`, `require()` and `vi.mock` or `jest.mock` of `'cmdk'` to `'modern-cmdk/react'`; reports the names and subpaths `modern-cmdk/react` lacks |
+| `data-attrs` | Renames `cmdk-*` attributes to `data-command-*` and `--cmdk-list-height` to `--command-list-height` in JSX, in selectors inside JS/TS strings and in `.css` and `.scss` files; rewrites cmdk's state attributes beside them (`[data-selected="true"]` becomes `[data-active]`, `[data-disabled="true"]` becomes `[data-disabled]`) and the Tailwind variants on cmdk elements; reports what has no equivalent (`cmdk-label`, `cmdk-item-select`) or cannot be migrated automatically |
+| `forward-ref` | Unwraps `forwardRef` from `react` into a function component that takes `ref` as a prop (React 19) |
+| `should-filter` | Converts the `shouldFilter` prop to `filter` and wraps a cmdk `filter` function in an adapter to the `(item, query)` signature |
 
-Options: `--dry-run` lists the files that would change and writes nothing; `--concurrency=N` sets how
-many files are processed at once (default 8); `--strict` is described below.
+Every site a transform cannot migrate is printed as `<path>: <message>` on stderr and left unchanged. Exit codes of `modern-cmdk-codemod`: `0` success (reports included), `1` a file errored or no file matched, `2` a usage error or a refused dirty tree.
 
-A run prints one `changed <file>` line per rewritten file and a summary. With `--dry-run` the lines read
-`would change <file>` and the summary ends in `(dry run, nothing written)`:
+### The deprecated `modern-cmdk` bin
 
-```text
-would change src/a.tsx
-1 changed, 0 unchanged, 0 errors (dry run, nothing written)
-```
+`modern-cmdk` still ships the old `modern-cmdk` bin until 2.0, as a shim (`dist/codemod/bin.mjs`) over the same four transforms. It is deprecated: it writes one deprecation warning to stderr per run and points to `modern-cmdk-codemod`. It keeps the 1.x behaviour: lenient exit codes unless argv carries `--strict` (without `--strict`, `0` for `--help`, missing arguments, usage errors and per-file errors; `1` for an unknown transform, no matching files and an uncaught error), 1.4's excludes (of the ten directories `modern-cmdk-codemod` skips, it skips only `node_modules`, `dist`, `build` and `.next`, and applies no `.gitignore`; like `modern-cmdk-codemod`, it reads only the ten script and stylesheet extensions from a directory, leaves out files and directories whose names start with a dot unless a pattern segment starts with that dot or a directory argument names that directory, descends no symlinked directory under `**` or a directory argument, reads no symlinked file and on Windows matches names case-insensitively; unlike it, it follows a symlinked directory that a pattern names or that a directory argument names, such as `"./src/link/*.tsx"` or `./src/link`), and no git check. The bin leaves in 2.0.
 
-Exit codes in 1.x are unchanged by default: `0` for `--help`, missing arguments and per-file errors, and
-`1` for an unknown transform, a glob that matches no files, or an uncaught error. An unknown option is
-warned about on stderr and ignored when the transform and glob are present. A malformed known option
-(`--concurrency` with no value, `--dry-run=yes`) is a usage error that writes nothing and exits `0`.
-With `--strict`, every usage error (including an unknown option, an unknown transform and a malformed
-option) exits `2`, and any file error exits `1`.
+### Third-party notices
 
-See the [full migration guide](https://abcrimson.github.io/modern-cmdk/guide/migration-from-cmdk.html).
+The ten packages bundled into `dist/codemod` are listed with their licences in `THIRD-PARTY-NOTICES.md`, which ships in the `modern-cmdk` tarball. It is generated by `scripts/third-party-notices.ts` and checked by `pnpm check:notices`.
 
----
+See the [full migration guide](https://abcrimson.github.io/modern-cmdk/guide/migration-from-cmdk.html).
 
 ## Documentation
 
-**[abcrimson.github.io/modern-cmdk](https://abcrimson.github.io/modern-cmdk/)**
+**[abcrimson.github.io/modern-cmdk](https://abcrimson.github.io/modern-cmdk/)** -- [Installation](https://abcrimson.github.io/modern-cmdk/guide/installation.html) | [Basic Usage](https://abcrimson.github.io/modern-cmdk/guide/basic-usage.html) | [SSR / Next.js](https://abcrimson.github.io/modern-cmdk/guide/ssr.html) | [Theming](https://abcrimson.github.io/modern-cmdk/guide/theming.html) | [Accessibility](https://abcrimson.github.io/modern-cmdk/guide/accessibility.html) | [Core API](https://abcrimson.github.io/modern-cmdk/api/command.html) | [React API](https://abcrimson.github.io/modern-cmdk/api/command-react.html) | [Benchmarks](https://abcrimson.github.io/modern-cmdk/benchmarks.html)
 
-**Guides:** [Getting Started](https://abcrimson.github.io/modern-cmdk/guide/getting-started.html) | [Installation](https://abcrimson.github.io/modern-cmdk/guide/installation.html) | [Basic Usage](https://abcrimson.github.io/modern-cmdk/guide/basic-usage.html) | [Async Items](https://abcrimson.github.io/modern-cmdk/guide/async-items.html) | [WASM Search](https://abcrimson.github.io/modern-cmdk/guide/wasm-search.html) | [Frecency](https://abcrimson.github.io/modern-cmdk/guide/frecency.html) | [Shortcuts](https://abcrimson.github.io/modern-cmdk/guide/shortcuts.html) | [Virtualization](https://abcrimson.github.io/modern-cmdk/guide/virtualization.html) | [SSR / Next.js](https://abcrimson.github.io/modern-cmdk/guide/ssr.html) | [Theming](https://abcrimson.github.io/modern-cmdk/guide/theming.html) | [Accessibility](https://abcrimson.github.io/modern-cmdk/guide/accessibility.html)
+**More guides:** [Async Items](https://abcrimson.github.io/modern-cmdk/guide/async-items.html) | [Frecency](https://abcrimson.github.io/modern-cmdk/guide/frecency.html) | [Shortcuts](https://abcrimson.github.io/modern-cmdk/guide/shortcuts.html) | [Virtualization](https://abcrimson.github.io/modern-cmdk/guide/virtualization.html) | [TypeScript](https://abcrimson.github.io/modern-cmdk/guide/typescript-integration.html) | [Controlled Dialog](https://abcrimson.github.io/modern-cmdk/guide/controlled-dialog.html) | [WASM Search (experimental)](https://abcrimson.github.io/modern-cmdk/guide/wasm-search.html) | [WASM Search API (experimental)](https://abcrimson.github.io/modern-cmdk/api/command-search-wasm.html)
 
 **Recipes:** [File Picker](https://abcrimson.github.io/modern-cmdk/recipes/file-picker.html) | [Emoji Picker](https://abcrimson.github.io/modern-cmdk/recipes/emoji-picker.html) | [AI Chat Commands](https://abcrimson.github.io/modern-cmdk/recipes/ai-chat-commands.html) | [Nested Commands](https://abcrimson.github.io/modern-cmdk/recipes/nested-commands.html) | [Spotlight Search](https://abcrimson.github.io/modern-cmdk/recipes/spotlight-search.html)
 
-**API:** [Core Engine](https://abcrimson.github.io/modern-cmdk/api/command.html) | [React Adapter](https://abcrimson.github.io/modern-cmdk/api/command-react.html) | [WASM Search](https://abcrimson.github.io/modern-cmdk/api/command-search-wasm.html)
-
----
+## Related packages
 
-## Related Packages
-
-| Package | Description |
+| Package | Status |
 |---|---|
-| [`create-modern-cmdk`](https://www.npmjs.com/package/create-modern-cmdk) | `npm create modern-cmdk@latest <name>` -- scaffold a new project |
-| `modern-cmdk-search-wasm` _(private 0.9.0, not published; build from source)_ | Experimental Rust/WASM fuzzy search |
-| `vscode-modern-cmdk` _(not yet published)_ | VS Code snippets extension |
+| [`modern-cmdk-codemod`](https://github.com/ABCrimson/modern-cmdk/tree/main/packages/modern-cmdk-codemod) | The cmdk migration codemods as their own package from 1.5 (`npx modern-cmdk-codemod <transform> <dir or glob>`), strict by default. |
+| [`create-modern-cmdk`](https://www.npmjs.com/package/create-modern-cmdk) | Published. `npm create modern-cmdk@latest <name>` scaffolds a new project. |
+| `modern-cmdk-search-wasm` | Experimental Rust/WASM fuzzy search; private (0.9.0), not on npm. |
+| `vscode-modern-cmdk` | Not on the VS Code Marketplace. The npm 1.0.0 of that name was an accidental publish and is not the extension; the package is private from 1.4.0. |
 
----
+The repository page, with development and contributing notes, is [github.com/ABCrimson/modern-cmdk](https://github.com/ABCrimson/modern-cmdk).
 
 ## License
 
-[MIT](https://github.com/ABCrimson/modern-cmdk/blob/main/LICENSE) -- Copyright (c) 2026 Crimson Dev
+[MIT](https://github.com/ABCrimson/modern-cmdk/blob/main/LICENSE) -- Copyright (c) 2026 Albert Badalov