pickem 0.1.0 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+All notable changes to pickem will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] — 2026-05-31
+
+The picker engine is now fully native. The public API
+(`pickem`, `pickem.from`, `pickem.checkbox`, `wizard`, `defineSource`) is
+**unchanged and backward compatible** — existing callers need no changes. The
+major bump reflects the engine replacement, the dependency removal, and the
+refreshed prompt visuals.
+
+### Changed
+
+- **Native picker engine.** Replaced `@inquirer/prompts` and `@inquirer/core`
+  with a built-in hook-based picker runtime (`createPicker`). The only
+  remaining runtime dependency is `string-width`.
+- Prompt visuals adopt the Claude Code selector aesthetic — a cyan `❯` cursor
+  rail with truecolor accents and synchronized-output rendering.
+
+### Added
+
+- `src/core/*` — native engine: hook runtime, screen buffer, raw key reader,
+  pagination, chrome/border rendering, theme tokens, color/accent helpers,
+  glyphs, display-width measurement, ANSI primitives, status glyphs, and
+  terminal cleanup.
+- `src/prompts/*` — native implementations of select, input, confirm,
+  checkbox, search, and searchable-checkbox.
+- Release quality gates wired into `npm run release`: `npm audit` (prod deps),
+  manifest audit (`scripts/audit.js`), `publint --strict`, `attw --pack`, and
+  an `npm pack` dry-run.
+
+### Removed
+
+- Runtime dependencies `@inquirer/prompts` and `@inquirer/core`.
+- Dev dependency `@inquirer/testing` — native prompts are now tested via the
+  in-tree `renderTest` harness (`src/core/testing.ts`).
+
+### Fixed
+
+- `package.json` `exports` now lists the `types` condition first (export
+  conditions are order-sensitive), so TypeScript resolves declarations
+  correctly.
+
+## [0.2.0] — 2026-05-09
+
+### Added
+
+- `pickem.checkbox(items, opts) → Promise<V[]>` — multi-select with built-in
+  filter-as-you-type. Built on `@inquirer/core`. Space toggles, Enter submits,
+  Backspace removes filter chars, Esc clears the filter. Pinned items respect
+  the filter (stay pinned within filtered set). Checked items remain in the
+  result even if the filter hides them. Result is in source order, matching
+  `@inquirer/prompts/checkbox` semantics.
+- `searchable?: boolean` option on both `pickem()` and `pickem.checkbox()`.
+  Default `true`. When `false`, falls back to the non-search prompts
+  (`@inquirer/prompts/select` and `/checkbox` respectively).
+- `'checkbox'` step type for `wizard()`. `ctx[step.id]` receives `string[]`.
+- `allowFreeText?: boolean` on `pickem.checkbox()`. When `true`, typing text
+  that matches nothing and pressing Enter appends the typed text to the list
+  as a checked item; the filter clears and the prompt stays open.
+- `npm run demo` — interactive tour of every feature using `tsx`.
+  Uses `MemoryStorage` so demo runs don't pollute `~/.pickem/usage.json`.
+- New direct dep: `@inquirer/core ^10.3.2` (was already pulled transitively
+  by `@inquirer/prompts`).
+- New devDeps: `@inquirer/testing ^3.3.5` (custom prompt smoke-tests),
+  `tsx ^4.21.0` (demo runner).
+- Public type exports: `CheckboxOptions`, `CheckboxStep`.
+
+### Changed
+
+- **BREAKING**: default `badgeStyle` changed from `'bracket'` to `'none'`.
+  Items with a `group` no longer render `[group]` badges by default. Pass
+  `{ badgeStyle: 'bracket' }` or `{ badgeStyle: 'dot' }` to opt back in.
+- `searchableCheckbox` toggle glyphs upgraded from `[ ]`/`[x]` to filled
+  circles (`○`/`●`, green when checked) with a cyan `❯` cursor. Matches
+  the Apple/iOS and `@inquirer/prompts` default visual style.
+- `pickem()` single-select stats lookup no longer reaches into the tracker's
+  private `cache` field — uses the public `getStats()` method instead.
+  Fixes a latent issue when the tracker hadn't been loaded yet.
+- `BadgeStyle` union now includes `'none'`.
+
+### Internal
+
+- Extracted `resolveTrackOptions` to `src/internal/track.ts` (shared between
+  `pickem.ts` and `checkbox.ts`).

package/README.md

@@ -1,6 +1,8 @@
 # pickem
 
-Usage-sorted searchable autocomplete for CLI tools. One dependency-light module that gives every CLI the same interactive picker pattern: discover items, sort by usage, search, select, track.
+Usage-sorted searchable autocomplete for CLI tools. One near-zero-dependency module that gives every CLI the same interactive picker pattern: discover items, sort by usage, search, select, track.
+
+pickem runs on its **own native picker engine** — no `@inquirer`, no prompt-library dependency. The only runtime dependency is [`string-width`](https://github.com/sindresorhus/string-width) (for correct CJK/emoji column width). The look is a Claude Code `/skills`-style selector: an accent title, a dim hint line, a rounded search box, columnar rows with a `❯` chevron on the active item, and a `↓ N more below` footer — truecolor with graceful 256/ASCII fallbacks. See [`docs/standards/selector-ui.md`](docs/standards/selector-ui.md) and [`docs/architecture/picker-engine.md`](docs/architecture/picker-engine.md).
 
 ## Install
 
@@ -8,6 +10,15 @@ Usage-sorted searchable autocomplete for CLI tools. One dependency-light module
 npm install pickem
 ```
 
+## Demo
+
+An interactive tour of every feature ships with the repo:
+
+```bash
+git clone https://github.com/calebogden/pickem
+cd pickem && npm install && npm run demo
+```
+
 ## Quick Start
 
 ```typescript
@@ -20,6 +31,35 @@ const choice = await pickem([
 ])
 ```
 
+## Multi-select (checkbox)
+
+`pickem.checkbox(items, opts)` returns `string[]` — the values of every checked item.
+
+```typescript
+import { pickem } from 'pickem'
+
+const choices = await pickem.checkbox([
+  { label: 'Deploy', value: 'deploy' },
+  { label: 'Test',   value: 'test' },
+  { label: 'Lint',   value: 'lint' },
+], { message: 'Which steps?', defaultChecked: ['test'] })
+// => ['deploy', 'test']
+```
+
+Key bindings: Space toggles a selection, Enter submits, type to filter, Esc clears the filter, Backspace removes filter characters.
+
+Pass `searchable: false` to fall back to the plain native checkbox picker (no search bar):
+
+```typescript
+const choices = await pickem.checkbox(items, { searchable: false })
+```
+
+Pass `{ allowFreeText: true }` to let the user add ad-hoc entries: type text that doesn't match any item, press Enter, and the typed text is appended to the list as a checked item. The filter clears and the prompt stays open so they can keep toggling or add more.
+
+```typescript
+const tags = await pickem.checkbox(KNOWN_TAGS, { allowFreeText: true })
+```
+
 ## Usage Tracking
 
 Items sort by how often they're used. Enable with `track: true`:
@@ -50,7 +90,7 @@ const npm = defineSource('npm', async () => [
 ])
 
 const choice = await pickem.from([scripts, npm], { track: true })
-// Items get group badges: [scripts], [npm]
+// Items get group badges when badgeStyle is set: [scripts], [npm]
 ```
 
 ## Wizard Flows
@@ -76,6 +116,7 @@ const result = await wizard([
 | Type | Purpose |
 |------|---------|
 | `pick` | Searchable usage-sorted selection |
+| `checkbox` | Searchable multi-select, returns an array |
 | `select` | Simple choice list |
 | `input` | Free text entry |
 | `confirm` | Yes/no |
@@ -104,16 +145,36 @@ await pickem(items, {
   message: 'Pick one:',       // Prompt message
   pageSize: 15,               // Visible items
   track: true | TrackOptions, // Enable usage tracking
+  searchable: true,           // Set false to skip the search bar (falls back to select)
   searchFields: ['label', 'description'],  // Fields to search (dot-notation for meta)
   search: (item, term) => boolean,         // Custom search function
   format: (item, stats) => string,         // Custom display formatter
-  badgeStyle: 'bracket' | 'dot' | fn,     // Group badge style
+  badgeStyle: 'none' | 'bracket' | 'dot' | fn,  // Group badge style (default: 'none')
   badgeColors: { npm: 'red' },            // Badge color overrides
   sort: (a, b) => number,                 // Tiebreaker after usage sort
   onSelect: (item) => {},                 // Post-selection callback
+  allowFreeText: true,                    // Surface unmatched input as a selectable option
+})
+```
+
+`pickem.checkbox` accepts the same options, plus:
+
+```typescript
+await pickem.checkbox(items, {
+  required: false,          // Require at least one selection before Enter submits
+  defaultChecked: ['test'], // Pre-checked values
+  allowFreeText: true,      // Type unmatched text + Enter to add as a checked item
 })
 ```
 
+### `badgeStyle` default changed in v0.2.0
+
+The default `badgeStyle` is now `'none'` — group labels are hidden unless you opt in. This is a breaking change if your code relied on the old default of `'bracket'`. To restore the previous behavior:
+
+```typescript
+await pickem(items, { badgeStyle: 'bracket' })
+```
+
 ## Requirements
 
 - Node >= 18

package/checkbox.d.ts

@@ -0,0 +1,3 @@
+import type { CheckboxOptions, PickItem } from './types.js';
+export declare function checkbox<V = string>(items: PickItem<V>[], options?: CheckboxOptions<V>): Promise<V[]>;
+//# sourceMappingURL=checkbox.d.ts.map

package/checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../src/checkbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAc,MAAM,YAAY,CAAA;AAQvE,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,EACvC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EACpB,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC,CAwEd"}

package/checkbox.js

@@ -0,0 +1,77 @@
+import { checkboxPicker as standardCheckbox } from './prompts/checkbox.js';
+import { UsageTracker } from './usage/tracker.js';
+import { createFormatter } from './display/format.js';
+import { createSearchFn } from './search/search.js';
+import { resolveTrackOptions } from './internal/track.js';
+import { searchableCheckbox } from './prompts/searchable-checkbox.js';
+export async function checkbox(items, options = {}) {
+    const trackOpts = resolveTrackOptions(options.track);
+    const tracker = trackOpts ? new UsageTracker(trackOpts) : null;
+    const keyFn = trackOpts?.key ?? ((item) => item.label);
+    let sorted;
+    if (tracker) {
+        sorted = await tracker.sortItems(items, keyFn, options.sort);
+    }
+    else if (options.sort) {
+        sorted = [...items].sort(options.sort);
+    }
+    else {
+        sorted = items;
+    }
+    const formatFn = options.format ??
+        createFormatter({
+            badgeStyle: options.badgeStyle,
+            badgeColors: options.badgeColors,
+        });
+    const searchFn = options.search ?? createSearchFn(options.searchFields);
+    const statsMap = new Map();
+    if (tracker) {
+        for (const item of sorted) {
+            statsMap.set(item.value, await tracker.getStats(keyFn(item)));
+        }
+    }
+    // Build a value→item map once for O(n) post-submit lookups
+    const valueToItem = new Map(sorted.map((item) => [item.value, item]));
+    const useSearchable = options.searchable !== false;
+    let result;
+    if (useSearchable) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        result = (await searchableCheckbox({
+            message: options.message ?? 'Pick:',
+            items: sorted,
+            pageSize: options.pageSize ?? 15,
+            required: options.required ?? false,
+            defaultChecked: (options.defaultChecked ?? []),
+            allowFreeText: options.allowFreeText ?? false,
+            searchFn: searchFn,
+            formatFn: formatFn,
+            usageStats: tracker ? statsMap : null,
+        }));
+    }
+    else {
+        const defaultCheckedSet = new Set(options.defaultChecked ?? []);
+        result = (await standardCheckbox({
+            message: options.message ?? 'Pick:',
+            pageSize: options.pageSize ?? 15,
+            required: options.required ?? false,
+            choices: sorted.map((item) => ({
+                name: formatFn(item, statsMap.get(item.value) ?? null),
+                value: item.value,
+                checked: defaultCheckedSet.has(item.value),
+                description: undefined, // We handle description in formatFn
+            })),
+        }));
+    }
+    // Single combined pass — track usage and fire onSelect for each selected item
+    for (const v of result) {
+        const item = valueToItem.get(v);
+        if (!item)
+            continue;
+        if (tracker)
+            await tracker.track(keyFn(item), trackOpts?.source);
+        if (options.onSelect)
+            await options.onSelect(item);
+    }
+    return result;
+}
+//# sourceMappingURL=checkbox.js.map

package/checkbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.js","sourceRoot":"","sources":["../src/checkbox.ts"],"names":[],"mappings":"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"}

package/core/ansi.d.ts

@@ -0,0 +1,16 @@
+export declare const ansi: {
+    readonly cursorUp: (n?: number) => string;
+    readonly cursorDown: (n?: number) => string;
+    readonly cursorTo: (col: number) => string;
+    readonly hideCursor: "\u001B[?25l";
+    readonly showCursor: "\u001B[?25h";
+    readonly eraseLine: "\u001B[2K";
+    readonly eraseDown: "\u001B[0J";
+    readonly eraseScreen: "\u001B[2J";
+    readonly beginSync: "\u001B[?2026h";
+    readonly endSync: "\u001B[?2026l";
+    readonly enterAltScreen: "\u001B[?1049h";
+    readonly exitAltScreen: "\u001B[?1049l";
+    readonly link: (url: string, text: string) => string;
+};
+//# sourceMappingURL=ansi.d.ts.map

package/core/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/core/ansi.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI;;;6BAGC,MAAM;;;;;;;;;;yBAYV,MAAM,QAAQ,MAAM;CACxB,CAAA"}

package/core/ansi.js

@@ -0,0 +1,21 @@
+// src/core/ansi.ts
+const ESC = '\x1b';
+const CSI = `${ESC}[`;
+export const ansi = {
+    cursorUp: (n = 1) => `${CSI}${n}A`,
+    cursorDown: (n = 1) => `${CSI}${n}B`,
+    cursorTo: (col) => `${CSI}${col + 1}G`, // 0-based → 1-based column
+    hideCursor: `${CSI}?25l`,
+    showCursor: `${CSI}?25h`,
+    eraseLine: `${CSI}2K`,
+    eraseDown: `${CSI}0J`,
+    eraseScreen: `${CSI}2J`,
+    // DEC private mode 2026 — atomic frame repaint (anti-flicker); ignored if unsupported
+    beginSync: `${CSI}?2026h`,
+    endSync: `${CSI}?2026l`,
+    enterAltScreen: `${CSI}?1049h`,
+    exitAltScreen: `${CSI}?1049l`,
+    // OSC-8 hyperlink — degrades to plain text on unsupporting terminals
+    link: (url, text) => `${ESC}]8;;${url}\x07${text}${ESC}]8;;\x07`,
+};
+//# sourceMappingURL=ansi.js.map

package/core/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/core/ansi.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,MAAM,GAAG,GAAG,MAAM,CAAA;AAClB,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAErB,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG;IAClC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG;IACpC,QAAQ,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,2BAA2B;IAC3E,UAAU,EAAE,GAAG,GAAG,MAAM;IACxB,UAAU,EAAE,GAAG,GAAG,MAAM;IACxB,SAAS,EAAE,GAAG,GAAG,IAAI;IACrB,SAAS,EAAE,GAAG,GAAG,IAAI;IACrB,WAAW,EAAE,GAAG,GAAG,IAAI;IACvB,sFAAsF;IACtF,SAAS,EAAE,GAAG,GAAG,QAAQ;IACzB,OAAO,EAAE,GAAG,GAAG,QAAQ;IACvB,cAAc,EAAE,GAAG,GAAG,QAAQ;IAC9B,aAAa,EAAE,GAAG,GAAG,QAAQ;IAC7B,qEAAqE;IACrE,IAAI,EAAE,CAAC,GAAW,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,GAAG,OAAO,IAAI,GAAG,GAAG,UAAU;CACxE,CAAA"}

package/core/chrome.d.ts

@@ -0,0 +1,37 @@
+import type { Colors } from './colors.js';
+import type { Symbols } from './symbols.js';
+export interface ChromeDeps {
+    colors: Colors;
+    symbols: Symbols;
+}
+export interface RowArgs {
+    label: string;
+    meta?: string[];
+    active?: boolean;
+    glyph?: string;
+    state?: string;
+    maxWidth?: number;
+}
+export interface SearchBoxArgs {
+    value: string;
+    placeholder?: string;
+    focused?: boolean;
+    width?: number;
+}
+export interface FooterArgs {
+    moreAbove?: number;
+    moreBelow?: number;
+    summary?: string;
+}
+export declare function makeChrome({ colors, symbols }: ChromeDeps): {
+    /** Accent+bold title, then a dim "·"-joined hint line. */
+    header(title: string, hints?: string[]): string;
+    /** Rounded boxed search input (searchable pickers only). */
+    searchBox({ value, placeholder, focused, width }: SearchBoxArgs): string;
+    /** One columnar list row: pointer [glyph] [state] name · dim-meta. */
+    row({ label, meta, active, glyph, state, maxWidth }: RowArgs): string;
+    /** Dim pagination/summary footer. */
+    footer({ moreAbove, moreBelow, summary }: FooterArgs): string;
+};
+export type Chrome = ReturnType<typeof makeChrome>;
+//# sourceMappingURL=chrome.d.ts.map

package/core/chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../src/core/chrome.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAOD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,UAAU;IAKtD,0DAA0D;kBAC5C,MAAM,UAAS,MAAM,EAAE,GAAQ,MAAM;IAMnD,4DAA4D;sDACO,aAAa,GAAG,MAAM;IAYzF,sEAAsE;yDACW,OAAO,GAAG,MAAM;IASjG,qCAAqC;8CACkB,UAAU,GAAG,MAAM;EAQ7E;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/core/chrome.js

@@ -0,0 +1,51 @@
+import { displayWidth, truncateToWidth } from './width.js';
+function padToWidth(str, width) {
+    const w = displayWidth(str);
+    return w >= width ? str : str + ' '.repeat(width - w);
+}
+export function makeChrome({ colors, symbols }) {
+    const dot = colors.dim(' · ');
+    const accent = colors.accent;
+    return {
+        /** Accent+bold title, then a dim "·"-joined hint line. */
+        header(title, hints = []) {
+            const head = colors.bold(accent(title));
+            if (hints.length === 0)
+                return head;
+            return `${head}\n${colors.dim(hints.join(' · '))}`;
+        },
+        /** Rounded boxed search input (searchable pickers only). */
+        searchBox({ value, placeholder = '', focused = true, width = 40 }) {
+            const w = Math.max(20, Math.min(width, 60));
+            const cursor = focused ? colors.inverse(' ') : '';
+            const text = value.length ? value + cursor : colors.dim(placeholder) + cursor;
+            const content = `${colors.dim(symbols.search)} ${text}`;
+            const inner = padToWidth(content, w);
+            const top = colors.dim(symbols.cornerTL + symbols.line.repeat(w + 1) + symbols.cornerTR);
+            const mid = `${colors.dim(symbols.boxV)} ${inner}${colors.dim(symbols.boxV)}`;
+            const bot = colors.dim(symbols.cornerBL + symbols.line.repeat(w + 1) + symbols.cornerBR);
+            return `${top}\n${mid}\n${bot}`;
+        },
+        /** One columnar list row: pointer [glyph] [state] name · dim-meta. */
+        row({ label, meta = [], active = false, glyph = '', state = '', maxWidth = 80 }) {
+            const pointer = active ? accent(symbols.pointer) : ' ';
+            const g = glyph ? `${glyph} ` : '';
+            const s = state ? `${colors.dim(state)}  ` : '';
+            const name = active ? accent(truncateToWidth(label, maxWidth)) : truncateToWidth(label, maxWidth);
+            const m = meta.length ? dot + colors.dim(meta.join(' · ')) : '';
+            return `${pointer} ${g}${s}${name}${m}`;
+        },
+        /** Dim pagination/summary footer. */
+        footer({ moreAbove = 0, moreBelow = 0, summary = '' }) {
+            const bits = [];
+            if (moreAbove)
+                bits.push(colors.dim(`${symbols.moreAbove} ${moreAbove} more above`));
+            if (moreBelow)
+                bits.push(colors.dim(`${symbols.moreBelow} ${moreBelow} more below`));
+            if (summary)
+                bits.push(colors.dim(summary));
+            return bits.join('   ');
+        },
+    };
+}
+//# sourceMappingURL=chrome.js.map

package/core/chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.js","sourceRoot":"","sources":["../../src/core/chrome.ts"],"names":[],"mappings":"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"}

package/core/cleanup.d.ts

@@ -0,0 +1,5 @@
+type Handler = () => void;
+/** Register a terminal-restore handler that runs on any process exit path. */
+export declare function onExit(fn: Handler): () => void;
+export {};
+//# sourceMappingURL=cleanup.d.ts.map

package/core/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/core/cleanup.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,IAAI,CAAA;AA0BzB,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,IAAI,CAI9C"}

package/core/cleanup.js

@@ -0,0 +1,31 @@
+const handlers = new Set();
+let installed = false;
+function fireAll() {
+    for (const h of [...handlers]) {
+        try {
+            h();
+        }
+        catch {
+            /* never throw during teardown */
+        }
+    }
+}
+function install() {
+    if (installed)
+        return;
+    installed = true;
+    process.once('exit', fireAll);
+    for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+        process.once(sig, () => {
+            fireAll();
+            process.exit(sig === 'SIGINT' ? 130 : 1);
+        });
+    }
+}
+/** Register a terminal-restore handler that runs on any process exit path. */
+export function onExit(fn) {
+    install();
+    handlers.add(fn);
+    return () => handlers.delete(fn);
+}
+//# sourceMappingURL=cleanup.js.map

package/core/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/core/cleanup.ts"],"names":[],"mappings":"AACA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAA;AACnC,IAAI,SAAS,GAAG,KAAK,CAAA;AAErB,SAAS,OAAO;IACd,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,CAAC,EAAE,CAAA;QACL,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,OAAO;IACd,IAAI,SAAS;QAAE,OAAM;IACrB,SAAS,GAAG,IAAI,CAAA;IAChB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,EAAE,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;YACrB,OAAO,EAAE,CAAA;YACT,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,MAAM,CAAC,EAAW;IAChC,OAAO,EAAE,CAAA;IACT,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAChB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAClC,CAAC"}

package/core/colors.d.ts

@@ -0,0 +1,24 @@
+export interface ColorOptions {
+    level?: 0 | 1 | 2 | 3;
+    env?: NodeJS.ProcessEnv;
+    isTTY?: boolean;
+}
+export declare function detectLevel(env: NodeJS.ProcessEnv, isTTY: boolean): 0 | 1 | 2 | 3;
+export declare function makeColors(opts?: ColorOptions): {
+    level: 0 | 1 | 2 | 3;
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    italic: (s: string) => string;
+    underline: (s: string) => string;
+    inverse: (s: string) => string;
+    cyan: (s: string) => string;
+    green: (s: string) => string;
+    red: (s: string) => string;
+    yellow: (s: string) => string;
+    gray: (s: string) => string;
+    accent: (s: string) => string;
+    rgb: (r: number, g: number, b: number) => (s: string) => string;
+    gradient: (from: [number, number, number], to: [number, number, number]) => (s: string) => string;
+};
+export type Colors = ReturnType<typeof makeColors>;
+//# sourceMappingURL=colors.d.ts.map

package/core/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/core/colors.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAajF;AAQD,wBAAgB,UAAU,CAAC,IAAI,GAAE,YAAiB;;cAEb,MAAM;aAAN,MAAM;gBAAN,MAAM;mBAAN,MAAM;iBAAN,MAAM;cAAN,MAAM;eAAN,MAAM;aAAN,MAAM;gBAAN,MAAM;cAAN,MAAM;gBACY,MAAM;aAA3C,MAAM,KAAK,MAAM,KAAK,MAAM,MAAM,GAAG,MAAM;qBAMnC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM;EA6B9F;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/core/colors.js

@@ -0,0 +1,67 @@
+export function detectLevel(env, isTTY) {
+    if ('NO_COLOR' in env && env.NO_COLOR !== '')
+        return 0;
+    if (env.FORCE_COLOR != null) {
+        const n = Number(env.FORCE_COLOR);
+        return (Number.isNaN(n) ? 1 : Math.max(0, Math.min(3, n)));
+    }
+    if (!isTTY)
+        return 0;
+    const ct = env.COLORTERM ?? '';
+    if (ct === 'truecolor' || ct === '24bit')
+        return 3;
+    const term = env.TERM ?? '';
+    if (/-256(color)?$/.test(term))
+        return 2;
+    if (term && term !== 'dumb')
+        return 1;
+    return 0;
+}
+// Map an 8-bit RGB triple to the closest xterm-256 cube index.
+function rgbTo256(r, g, b) {
+    const q = (v) => (v < 48 ? 0 : v < 115 ? 1 : Math.round((v - 35) / 40));
+    return 16 + 36 * q(r) + 6 * q(g) + q(b);
+}
+export function makeColors(opts = {}) {
+    const level = opts.level ?? detectLevel(opts.env ?? process.env, opts.isTTY ?? !!process.stdout.isTTY);
+    const wrap = (open) => (s) => (level === 0 ? s : `\x1b[${open}m${s}\x1b[0m`);
+    const rgb = (r, g, b) => (s) => {
+        if (level === 0)
+            return s;
+        if (level >= 3)
+            return `\x1b[38;2;${r};${g};${b}m${s}\x1b[0m`;
+        return `\x1b[38;5;${rgbTo256(r, g, b)}m${s}\x1b[0m`;
+    };
+    // Per-character truecolor interpolation (the Vite/Astro banner look).
+    const gradient = (from, to) => (s) => {
+        if (level === 0)
+            return s;
+        const chars = [...s];
+        return chars
+            .map((ch, i) => {
+            const t = chars.length <= 1 ? 0 : i / (chars.length - 1);
+            const c = [0, 1, 2].map((k) => Math.round(from[k] + (to[k] - from[k]) * t));
+            return rgb(c[0], c[1], c[2])(ch);
+        })
+            .join('');
+    };
+    return {
+        level,
+        bold: wrap('1'),
+        dim: wrap('2'),
+        italic: wrap('3'),
+        underline: wrap('4'),
+        inverse: wrap('7'),
+        cyan: wrap('36'),
+        green: wrap('32'),
+        red: wrap('31'),
+        yellow: wrap('33'),
+        gray: wrap('90'),
+        // pickem accent — lavender/violet (selector UI, see docs/standards/selector-ui.md).
+        // truecolor → 256 fallback is handled by rgb().
+        accent: rgb(180, 160, 250),
+        rgb,
+        gradient,
+    };
+}
+//# sourceMappingURL=colors.js.map

package/core/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/core/colors.ts"],"names":[],"mappings":"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"}

package/core/hooks.d.ts

@@ -0,0 +1,26 @@
+import type { KeyEvent } from './keys.js';
+import type { PickerInput } from './runtime.js';
+interface Slot {
+    value?: unknown;
+    deps?: unknown[];
+    cleanup?: () => void;
+}
+export interface HookStore {
+    slots: Slot[];
+    cursor: number;
+    scheduleRender: () => void;
+    keypressHandlers: ((key: KeyEvent, input: PickerInput) => void)[];
+    effects: (() => void)[];
+    reset(): void;
+}
+export declare function createHookStore(scheduleRender: () => void): HookStore;
+export declare function withHookStore<T>(store: HookStore, fn: () => T): T;
+export declare function useState<T>(initial: T): [T, (next: T) => void];
+export declare function useRef<T>(initial: T): {
+    current: T;
+};
+export declare function useMemo<T>(factory: () => T, deps: unknown[]): T;
+export declare function useEffect(effect: () => void | (() => void), deps: unknown[]): void;
+export declare function useKeypress(handler: (key: KeyEvent, input: PickerInput) => void): void;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/core/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,UAAU,IAAI;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,gBAAgB,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,EAAE,CAAA;IACjE,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAA;IACvB,KAAK,IAAI,IAAI,CAAA;CACd;AAID,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,IAAI,GAAG,SAAS,CAcrE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEjE;AAeD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAU9D;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAIpD;AAOD,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAO/D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAWlF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAEtF"}