pickem 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 pickone contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# pickone
+
+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.
+
+## Install
+
+```bash
+npm install pickone
+```
+
+## Quick Start
+
+```typescript
+import { pickone } from 'pickone'
+
+const choice = await pickone([
+  { label: 'Deploy', value: 'deploy', description: 'Push to production' },
+  { label: 'Test', value: 'test', description: 'Run test suite' },
+  { label: 'Lint', value: 'lint', description: 'Check formatting' },
+])
+```
+
+## Usage Tracking
+
+Items sort by how often they're used. Enable with `track: true`:
+
+```typescript
+const choice = await pickone(items, {
+  track: true,                          // Uses ~/.pickone/usage.json
+  // or:
+  track: { storePath: '~/.myapp/usage.json' },
+})
+```
+
+3-tier sort: count desc, lastUsed desc, alphabetical.
+
+## Multiple Sources
+
+```typescript
+import { pickone, defineSource } from 'pickone'
+
+const scripts = defineSource('scripts', async () => [
+  { label: 'deploy.sh', value: './scripts/deploy.sh' },
+  { label: 'backup.sh', value: './scripts/backup.sh' },
+])
+
+const npm = defineSource('npm', async () => [
+  { label: 'build', value: 'npm run build' },
+  { label: 'test', value: 'npm test' },
+])
+
+const choice = await pickone.from([scripts, npm], { track: true })
+// Items get group badges: [scripts], [npm]
+```
+
+## Wizard Flows
+
+Chain multiple prompts with branching logic:
+
+```typescript
+import { wizard } from 'pickone'
+
+const result = await wizard([
+  { id: 'action', type: 'pick', message: 'What to do?', items: allScripts },
+  { id: 'env', type: 'select', message: 'Environment:', choices: [
+    { label: 'Production', value: 'prod' },
+    { label: 'Staging', value: 'staging' },
+  ], when: ctx => ctx.action === 'deploy' },
+  { id: 'confirm', type: 'confirm', message: 'Are you sure?' },
+  { id: 'route', type: 'branch', on: ctx => ctx.confirm ? 'done' : 'action' },
+])
+```
+
+### Step types
+
+| Type | Purpose |
+|------|---------|
+| `pick` | Searchable usage-sorted selection |
+| `select` | Simple choice list |
+| `input` | Free text entry |
+| `confirm` | Yes/no |
+| `branch` | Route to a step ID or inject dynamic steps |
+
+Each step supports `when` (conditional) and `before` (pre-step hook).
+
+## Standalone Usage Tracker
+
+```typescript
+import { UsageTracker } from 'pickone'
+
+const tracker = new UsageTracker({ storePath: '~/.myapp/usage.json' })
+await tracker.track('deploy')
+await tracker.track('deploy')
+
+const sorted = await tracker.sortItems(items)
+const top = await tracker.getTop(10)
+const stats = await tracker.getStats('deploy') // { count: 2, lastUsed: ... }
+```
+
+## Options
+
+```typescript
+await pickone(items, {
+  message: 'Pick one:',       // Prompt message
+  pageSize: 15,               // Visible items
+  track: true | TrackOptions, // Enable usage tracking
+  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
+  badgeColors: { npm: 'red' },            // Badge color overrides
+  sort: (a, b) => number,                 // Tiebreaker after usage sort
+  onSelect: (item) => {},                 // Post-selection callback
+})
+```
+
+## Requirements
+
+- Node >= 18
+- ESM only

package/display/format.d.ts

@@ -0,0 +1,9 @@
+import type { PickItem, UsageStats } from '../types.js';
+type BadgeStyle = 'bracket' | 'dot' | ((group: string) => string);
+export interface FormatOptions {
+    badgeStyle?: BadgeStyle;
+    badgeColors?: Record<string, string>;
+}
+export declare function createFormatter<V>(options?: FormatOptions): (item: PickItem<V>, stats: UsageStats | null) => string;
+export {};
+//# sourceMappingURL=format.d.ts.map

package/display/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/display/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEvD,KAAK,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAA;AAmCjE,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,GAAE,aAAkB,GAC1B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,MAAM,CAoBzD"}

package/display/format.js

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+const DEFAULT_BADGE_COLORS = {
+    npm: 'red',
+    script: 'blue',
+    builtin: 'green',
+    workflow: 'magenta',
+    tool: 'yellow',
+};
+function renderBadge(group, style, colors) {
+    if (typeof style === 'function') {
+        return style(group);
+    }
+    const colorName = colors[group] ?? 'gray';
+    const colorFn = chalk[colorName] ?? chalk.gray;
+    if (style === 'dot') {
+        return colorFn('●') + ' ';
+    }
+    // bracket (default)
+    return colorFn(`[${group}]`) + ' ';
+}
+function renderUsageCount(count) {
+    if (count === 0)
+        return '';
+    return chalk.dim(` (${count})`);
+}
+export function createFormatter(options = {}) {
+    const style = options.badgeStyle ?? 'bracket';
+    const colors = { ...DEFAULT_BADGE_COLORS, ...options.badgeColors };
+    return (item, stats) => {
+        let result = '';
+        if (item.group) {
+            result += renderBadge(item.group, style, colors);
+        }
+        result += item.label;
+        result += renderUsageCount(stats?.count ?? 0);
+        if (item.description) {
+            result += chalk.dim(` — ${item.description}`);
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=format.js.map

package/display/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/display/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,MAAM,oBAAoB,GAA2B;IACnD,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,QAAQ;CACf,CAAA;AAED,SAAS,WAAW,CAClB,KAAa,EACb,KAAiB,EACjB,MAA8B;IAE9B,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAA;IACzC,MAAM,OAAO,GAAI,KAAa,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,CAAA;IAEvD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;IAC3B,CAAC;IAED,oBAAoB;IACpB,OAAO,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,GAAG,GAAG,CAAA;AACpC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,CAAA;AACjC,CAAC;AAOD,MAAM,UAAU,eAAe,CAC7B,UAAyB,EAAE;IAE3B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAA;IAC7C,MAAM,MAAM,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;IAElE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,MAAM,GAAG,EAAE,CAAA;QAEf,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAClD,CAAC;QAED,MAAM,IAAI,IAAI,CAAC,KAAK,CAAA;QACpB,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC,CAAA;QAE7C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QAC/C,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC"}

package/index.d.ts

@@ -0,0 +1,10 @@
+export { pickone } from './pickone.js';
+export { wizard } from './wizard.js';
+export { UsageTracker } from './usage/tracker.js';
+export { JsonFileStorage, MemoryStorage } from './usage/storage.js';
+export { sortByUsage } from './usage/sort.js';
+export { defineSource, loadSources } from './source/source.js';
+export { createSearchFn } from './search/search.js';
+export { createFormatter } from './display/format.js';
+export type { PickItem, PickOptions, TrackOptions, UsageStats, UsageRecord, UsageData, UsageStorage, Source, WizardContext, WizardStep, PickStep, SelectStep, InputStep, ConfirmStep, BranchStep, SelectChoice, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG7C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAG9D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGrD,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,MAAM,EACN,aAAa,EACb,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAA"}

package/index.js

@@ -0,0 +1,14 @@
+// Core
+export { pickone } from './pickone.js';
+export { wizard } from './wizard.js';
+// Usage tracking
+export { UsageTracker } from './usage/tracker.js';
+export { JsonFileStorage, MemoryStorage } from './usage/storage.js';
+export { sortByUsage } from './usage/sort.js';
+// Sources
+export { defineSource, loadSources } from './source/source.js';
+// Search
+export { createSearchFn } from './search/search.js';
+// Display
+export { createFormatter } from './display/format.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAE9D,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "pickem",
+  "version": "0.0.1",
+  "description": "Usage-sorted searchable autocomplete for CLI tools",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "keywords": [
+    "cli",
+    "autocomplete",
+    "interactive",
+    "usage-sorted",
+    "searchable",
+    "picker",
+    "wizard"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0"
+  }
+}

package/pickone.d.ts

@@ -0,0 +1,11 @@
+import type { PickItem, PickOptions, Source } from './types.js';
+declare function pick<V = string>(items: PickItem<V>[], options?: PickOptions<V>): Promise<V>;
+/**
+ * Pick from multiple sources loaded in parallel.
+ */
+declare function pickFrom<V = string>(sources: Source<V>[], options?: PickOptions<V>): Promise<V>;
+declare const pickone: typeof pick & {
+    from: typeof pickFrom;
+};
+export { pickone };
+//# sourceMappingURL=pickone.d.ts.map

package/pickone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickone.d.ts","sourceRoot":"","sources":["../src/pickone.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAgB,MAAM,YAAY,CAAA;AAY7E,iBAAe,IAAI,CAAC,CAAC,GAAG,MAAM,EAC5B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EACpB,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAC3B,OAAO,CAAC,CAAC,CAAC,CA6DZ;AAED;;GAEG;AACH,iBAAe,QAAQ,CAAC,CAAC,GAAG,MAAM,EAChC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EACpB,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAC3B,OAAO,CAAC,CAAC,CAAC,CAGZ;AAGD,QAAA,MAAM,OAAO;;CAA0C,CAAA;AAEvD,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/pickone.js

@@ -0,0 +1,79 @@
+import { search } from '@inquirer/prompts';
+import { UsageTracker } from './usage/tracker.js';
+import { createSearchFn } from './search/search.js';
+import { createFormatter } from './display/format.js';
+import { loadSources } from './source/source.js';
+function resolveTrackOptions(track) {
+    if (!track)
+        return null;
+    if (track === true)
+        return {};
+    return track;
+}
+async function pick(items, options = {}) {
+    const trackOpts = resolveTrackOptions(options.track);
+    const tracker = trackOpts ? new UsageTracker(trackOpts) : null;
+    const keyFn = trackOpts?.key ?? ((item) => item.label);
+    // Sort by usage
+    let sorted;
+    if (tracker) {
+        sorted = await tracker.sortItems(items, keyFn, options.sort);
+    }
+    else if (options.sort) {
+        sorted = [...items].sort(options.sort);
+    }
+    else {
+        sorted = items;
+    }
+    // Search function
+    const searchFn = options.search ?? createSearchFn(options.searchFields);
+    // Formatter
+    const formatFn = options.format ??
+        createFormatter({
+            badgeStyle: options.badgeStyle,
+            badgeColors: options.badgeColors,
+        });
+    const result = await search({
+        message: options.message ?? 'Pick one:',
+        pageSize: options.pageSize ?? 15,
+        source: async (term) => {
+            const filtered = term ? sorted.filter((item) => searchFn(item, term)) : sorted;
+            return filtered.map((item) => {
+                const stats = tracker
+                    ? { count: 0, lastUsed: 0, ...tracker.cache?.[keyFn(item)] }
+                    : null;
+                return {
+                    name: formatFn(item, stats),
+                    value: item.value,
+                    description: undefined, // We handle description in formatFn
+                };
+            });
+        },
+    });
+    // Track usage
+    if (tracker) {
+        const selected = sorted.find((item) => item.value === result);
+        if (selected) {
+            await tracker.track(keyFn(selected), trackOpts?.source);
+        }
+    }
+    // onSelect callback
+    if (options.onSelect) {
+        const selected = sorted.find((item) => item.value === result);
+        if (selected) {
+            await options.onSelect(selected);
+        }
+    }
+    return result;
+}
+/**
+ * Pick from multiple sources loaded in parallel.
+ */
+async function pickFrom(sources, options = {}) {
+    const items = await loadSources(sources);
+    return pick(items, options);
+}
+// Attach .from as a method
+const pickone = Object.assign(pick, { from: pickFrom });
+export { pickone };
+//# sourceMappingURL=pickone.js.map

package/pickone.js.map

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

package/search/search.d.ts

@@ -0,0 +1,7 @@
+import type { PickItem } from '../types.js';
+/**
+ * Case-insensitive substring search across configured fields.
+ * Each term (space-separated) must match somewhere in the search text.
+ */
+export declare function createSearchFn<V>(fields?: string[]): (item: PickItem<V>, term: string) => boolean;
+//# sourceMappingURL=search.d.ts.map

package/search/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAsC3C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,GAAE,MAAM,EAA6B,GAC1C,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAM9C"}

package/search/search.js

@@ -0,0 +1,48 @@
+/**
+ * Get a nested value from an object using dot-notation path.
+ * e.g. getByPath({ a: { b: 'hello' } }, 'a.b') → 'hello'
+ */
+function getByPath(obj, path) {
+    let current = obj;
+    for (const part of path.split('.')) {
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Extract searchable text from an item based on field paths.
+ * Fields can reference top-level item properties or nested meta properties via dot-notation.
+ */
+function extractSearchText(item, fields) {
+    if (item.searchText)
+        return item.searchText;
+    const parts = [];
+    for (const field of fields) {
+        let val;
+        if (field.includes('.')) {
+            // dot-notation — look in meta first, then top-level
+            val = getByPath(item.meta, field) ?? getByPath(item, field);
+        }
+        else {
+            val = item[field] ?? getByPath(item.meta, field);
+        }
+        if (typeof val === 'string') {
+            parts.push(val);
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Case-insensitive substring search across configured fields.
+ * Each term (space-separated) must match somewhere in the search text.
+ */
+export function createSearchFn(fields = ['label', 'description']) {
+    return (item, term) => {
+        const text = extractSearchText(item, fields).toLowerCase();
+        const terms = term.toLowerCase().split(/\s+/).filter(Boolean);
+        return terms.every((t) => text.includes(t));
+    };
+}
+//# sourceMappingURL=search.js.map

package/search/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,SAAS,SAAS,CAAC,GAAQ,EAAE,IAAY;IACvC,IAAI,OAAO,GAAG,GAAG,CAAA;IACjB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QACpE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAI,IAAiB,EAAE,MAAgB;IAC/D,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC,UAAU,CAAA;IAE3C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,GAAY,CAAA;QAChB,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,oDAAoD;YACpD,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC7D,CAAC;aAAM,CAAC;YACN,GAAG,GAAI,IAAY,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC3D,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAmB,CAAC,OAAO,EAAE,aAAa,CAAC;IAE3C,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC7D,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,CAAC,CAAA;AACH,CAAC"}

package/source/source.d.ts

@@ -0,0 +1,8 @@
+import type { PickItem, Source } from '../types.js';
+export declare function defineSource<V = string>(name: string, load: () => Promise<PickItem<V>[]>): Source<V>;
+/**
+ * Load items from multiple sources in parallel.
+ * Each item gets its group set to the source name (unless already set).
+ */
+export declare function loadSources<V>(sources: Source<V>[]): Promise<PickItem<V>[]>;
+//# sourceMappingURL=source.d.ts.map

package/source/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/source/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEnD,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,EACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,GACjC,MAAM,CAAC,CAAC,CAAC,CAEX;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAWjF"}

package/source/source.js

@@ -0,0 +1,18 @@
+export function defineSource(name, load) {
+    return { name, load };
+}
+/**
+ * Load items from multiple sources in parallel.
+ * Each item gets its group set to the source name (unless already set).
+ */
+export async function loadSources(sources) {
+    const results = await Promise.all(sources.map(async (source) => {
+        const items = await source.load();
+        return items.map((item) => ({
+            ...item,
+            group: item.group ?? source.name,
+        }));
+    }));
+    return results.flat();
+}
+//# sourceMappingURL=source.js.map

package/source/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/source/source.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,IAAkC;IAElC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAAoB;IACvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QACjC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI;SACjC,CAAC,CAAC,CAAA;IACL,CAAC,CAAC,CACH,CAAA;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;AACvB,CAAC"}

package/types.d.ts

@@ -0,0 +1,89 @@
+export interface PickItem<V = string> {
+    label: string;
+    value: V;
+    description?: string;
+    group?: string;
+    meta?: Record<string, any>;
+    searchText?: string;
+}
+export interface PickOptions<V = string> {
+    message?: string;
+    pageSize?: number;
+    track?: boolean | TrackOptions;
+    searchFields?: string[];
+    search?: (item: PickItem<V>, term: string) => boolean;
+    format?: (item: PickItem<V>, stats: UsageStats | null) => string;
+    badgeStyle?: 'bracket' | 'dot' | ((group: string) => string);
+    badgeColors?: Record<string, string>;
+    sort?: (a: PickItem<V>, b: PickItem<V>) => number;
+    onSelect?: (item: PickItem<V>) => void | Promise<void>;
+}
+export interface TrackOptions {
+    storePath?: string;
+    namespace?: string;
+    key?: (item: PickItem<any>) => string;
+    storage?: UsageStorage;
+    source?: string;
+}
+export interface UsageStats {
+    count: number;
+    lastUsed: number;
+}
+export interface UsageRecord {
+    count: number;
+    lastUsed: number;
+    source?: string;
+}
+export interface UsageData {
+    [key: string]: UsageRecord;
+}
+export interface UsageStorage {
+    read(): Promise<UsageData>;
+    write(data: UsageData): Promise<void>;
+}
+export interface Source<V = string> {
+    name: string;
+    load: () => Promise<PickItem<V>[]>;
+}
+export interface WizardContext {
+    [key: string]: any;
+}
+export type WizardStep<V = string> = PickStep<V> | SelectStep | InputStep | ConfirmStep | BranchStep;
+interface BaseStep {
+    id: string;
+    when?: (ctx: WizardContext) => boolean | Promise<boolean>;
+    before?: (ctx: WizardContext) => void | Promise<void>;
+}
+export interface PickStep<V = string> extends BaseStep {
+    type: 'pick';
+    message?: string;
+    items: PickItem<V>[] | ((ctx: WizardContext) => PickItem<V>[] | Promise<PickItem<V>[]>);
+    options?: Omit<PickOptions<V>, 'message'>;
+}
+export interface SelectStep extends BaseStep {
+    type: 'select';
+    message?: string;
+    choices: SelectChoice[] | ((ctx: WizardContext) => SelectChoice[] | Promise<SelectChoice[]>);
+}
+export interface SelectChoice {
+    label: string;
+    value: string;
+    description?: string;
+}
+export interface InputStep extends BaseStep {
+    type: 'input';
+    message?: string;
+    default?: string | ((ctx: WizardContext) => string);
+    validate?: (value: string, ctx: WizardContext) => boolean | string | Promise<boolean | string>;
+}
+export interface ConfirmStep extends BaseStep {
+    type: 'confirm';
+    message?: string;
+    default?: boolean;
+}
+export interface BranchStep extends BaseStep {
+    type: 'branch';
+    on: (ctx: WizardContext) => string | WizardStep[] | Promise<string | WizardStep[]>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

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

package/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/usage/sort.d.ts

@@ -0,0 +1,7 @@
+import type { PickItem, UsageData } from '../types.js';
+/**
+ * 3-tier sort: count desc → lastUsed desc → label alpha.
+ * Items with no usage data sort after items with usage.
+ */
+export declare function sortByUsage<V>(items: PickItem<V>[], usage: UsageData, keyFn?: (item: PickItem<V>) => string, tiebreaker?: (a: PickItem<V>, b: PickItem<V>) => number): PickItem<V>[];
+//# sourceMappingURL=sort.d.ts.map

package/usage/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/usage/sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEtD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EACpB,KAAK,EAAE,SAAS,EAChB,KAAK,GAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,MAA6B,EAC3D,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,GACtD,QAAQ,CAAC,CAAC,CAAC,EAAE,CA0Bf"}

package/usage/sort.js

@@ -0,0 +1,31 @@
+/**
+ * 3-tier sort: count desc → lastUsed desc → label alpha.
+ * Items with no usage data sort after items with usage.
+ */
+export function sortByUsage(items, usage, keyFn = (item) => item.label, tiebreaker) {
+    return [...items].sort((a, b) => {
+        const aKey = keyFn(a);
+        const bKey = keyFn(b);
+        const aUsage = usage[aKey];
+        const bUsage = usage[bKey];
+        const aCount = aUsage?.count ?? 0;
+        const bCount = bUsage?.count ?? 0;
+        // Count descending
+        if (aCount !== bCount)
+            return bCount - aCount;
+        // Last used descending
+        const aLast = aUsage?.lastUsed ?? 0;
+        const bLast = bUsage?.lastUsed ?? 0;
+        if (aLast !== bLast)
+            return bLast - aLast;
+        // Custom tiebreaker
+        if (tiebreaker) {
+            const tie = tiebreaker(a, b);
+            if (tie !== 0)
+                return tie;
+        }
+        // Alpha ascending
+        return a.label.localeCompare(b.label);
+    });
+}
+//# sourceMappingURL=sort.js.map

package/usage/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../src/usage/sort.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAoB,EACpB,KAAgB,EAChB,QAAuC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAC3D,UAAuD;IAEvD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,CAAA;QACjC,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,CAAA;QAEjC,mBAAmB;QACnB,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,MAAM,GAAG,MAAM,CAAA;QAE7C,uBAAuB;QACvB,MAAM,KAAK,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAA;QACnC,MAAM,KAAK,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAA;QACnC,IAAI,KAAK,KAAK,KAAK;YAAE,OAAO,KAAK,GAAG,KAAK,CAAA;QAEzC,oBAAoB;QACpB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YAC5B,IAAI,GAAG,KAAK,CAAC;gBAAE,OAAO,GAAG,CAAA;QAC3B,CAAC;QAED,kBAAkB;QAClB,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/usage/storage.d.ts

@@ -0,0 +1,13 @@
+import type { UsageData, UsageStorage } from '../types.js';
+export declare class JsonFileStorage implements UsageStorage {
+    private path;
+    constructor(path: string);
+    read(): Promise<UsageData>;
+    write(data: UsageData): Promise<void>;
+}
+export declare class MemoryStorage implements UsageStorage {
+    private data;
+    read(): Promise<UsageData>;
+    write(data: UsageData): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/usage/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/usage/storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAS1D,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,IAAI,CAAQ;gBAER,IAAI,EAAE,MAAM;IAIlB,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IAS1B,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ5C;AAED,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,IAAI,CAAgB;IAEtB,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IAI1B,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5C"}

package/usage/storage.js

@@ -0,0 +1,43 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { homedir } from 'node:os';
+function expandHome(p) {
+    if (p.startsWith('~/') || p === '~') {
+        return p.replace('~', homedir());
+    }
+    return p;
+}
+export class JsonFileStorage {
+    path;
+    constructor(path) {
+        this.path = expandHome(path);
+    }
+    async read() {
+        try {
+            const raw = await readFile(this.path, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return {};
+        }
+    }
+    async write(data) {
+        try {
+            await mkdir(dirname(this.path), { recursive: true });
+            await writeFile(this.path, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+        }
+        catch {
+            // Silent failure — usage tracking should never crash the picker
+        }
+    }
+}
+export class MemoryStorage {
+    data = {};
+    async read() {
+        return { ...this.data };
+    }
+    async write(data) {
+        this.data = { ...data };
+    }
+}
+//# sourceMappingURL=storage.js.map

package/usage/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/usage/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGjC,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IAClC,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,OAAO,eAAe;IAClB,IAAI,CAAQ;IAEpB,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAA;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAe;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACpD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QAC3E,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,aAAa;IAChB,IAAI,GAAc,EAAE,CAAA;IAE5B,KAAK,CAAC,IAAI;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAe;QACzB,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;IACzB,CAAC;CACF"}

package/usage/tracker.d.ts

@@ -0,0 +1,23 @@
+import type { PickItem, UsageData, UsageStats, UsageStorage } from '../types.js';
+export interface TrackerOptions {
+    storePath?: string;
+    namespace?: string;
+    storage?: UsageStorage;
+}
+export declare class UsageTracker {
+    private storage;
+    private namespace;
+    private cache;
+    constructor(options?: TrackerOptions);
+    private prefixKey;
+    load(): Promise<UsageData>;
+    track(key: string, source?: string): Promise<void>;
+    getStats(key: string): Promise<UsageStats | null>;
+    sortItems<V>(items: PickItem<V>[], keyFn?: (item: PickItem<V>) => string, tiebreaker?: (a: PickItem<V>, b: PickItem<V>) => number): Promise<PickItem<V>[]>;
+    getTop(n: number): Promise<Array<{
+        key: string;
+        count: number;
+        lastUsed: number;
+    }>>;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/usage/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/usage/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAe,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM7F,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,KAAK,CAAyB;gBAE1B,OAAO,GAAE,cAAmB;IAKxC,OAAO,CAAC,SAAS;IAIX,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IAM1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAalD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOjD,SAAS,CAAC,CAAC,EACf,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EACpB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,EACrC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,GACtD,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAgBnB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAa1F"}

package/usage/tracker.js

@@ -0,0 +1,69 @@
+import { JsonFileStorage } from './storage.js';
+import { sortByUsage } from './sort.js';
+const DEFAULT_STORE_PATH = '~/.pickone/usage.json';
+export class UsageTracker {
+    storage;
+    namespace;
+    cache = null;
+    constructor(options = {}) {
+        this.storage = options.storage ?? new JsonFileStorage(options.storePath ?? DEFAULT_STORE_PATH);
+        this.namespace = options.namespace;
+    }
+    prefixKey(key) {
+        return this.namespace ? `${this.namespace}:${key}` : key;
+    }
+    async load() {
+        if (this.cache)
+            return this.cache;
+        this.cache = await this.storage.read();
+        return this.cache;
+    }
+    async track(key, source) {
+        const data = await this.load();
+        const prefixed = this.prefixKey(key);
+        const existing = data[prefixed];
+        data[prefixed] = {
+            count: (existing?.count ?? 0) + 1,
+            lastUsed: Date.now(),
+            source: source ?? existing?.source,
+        };
+        this.cache = data;
+        await this.storage.write(data);
+    }
+    async getStats(key) {
+        const data = await this.load();
+        const record = data[this.prefixKey(key)];
+        if (!record)
+            return null;
+        return { count: record.count, lastUsed: record.lastUsed };
+    }
+    async sortItems(items, keyFn, tiebreaker) {
+        const data = await this.load();
+        // If namespace, we need to remap keys for sort
+        if (this.namespace) {
+            const remapped = {};
+            for (const [k, v] of Object.entries(data)) {
+                const prefix = `${this.namespace}:`;
+                if (k.startsWith(prefix)) {
+                    remapped[k.slice(prefix.length)] = v;
+                }
+            }
+            return sortByUsage(items, remapped, keyFn, tiebreaker);
+        }
+        return sortByUsage(items, data, keyFn, tiebreaker);
+    }
+    async getTop(n) {
+        const data = await this.load();
+        const prefix = this.namespace ? `${this.namespace}:` : '';
+        return Object.entries(data)
+            .filter(([k]) => !this.namespace || k.startsWith(prefix))
+            .map(([k, v]) => ({
+            key: this.namespace ? k.slice(prefix.length) : k,
+            count: v.count,
+            lastUsed: v.lastUsed,
+        }))
+            .sort((a, b) => b.count - a.count || b.lastUsed - a.lastUsed)
+            .slice(0, n);
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/usage/tracker.js.map

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

package/wizard.d.ts

@@ -0,0 +1,3 @@
+import type { WizardContext, WizardStep } from './types.js';
+export declare function wizard<T extends WizardContext = WizardContext>(steps: WizardStep[], initialContext?: Partial<T>): Promise<T>;
+//# sourceMappingURL=wizard.d.ts.map

package/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../src/wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EAMX,MAAM,YAAY,CAAA;AA8FnB,wBAAsB,MAAM,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAClE,KAAK,EAAE,UAAU,EAAE,EACnB,cAAc,GAAE,OAAO,CAAC,CAAC,CAAM,GAC9B,OAAO,CAAC,CAAC,CAAC,CA8BZ"}

package/wizard.js

@@ -0,0 +1,105 @@
+import { select, input, confirm } from '@inquirer/prompts';
+import { pickone } from './pickone.js';
+async function executePick(step, ctx) {
+    const items = typeof step.items === 'function' ? await step.items(ctx) : step.items;
+    return pickone(items, {
+        message: step.message,
+        ...step.options,
+    });
+}
+async function executeSelect(step, ctx) {
+    const choices = typeof step.choices === 'function' ? await step.choices(ctx) : step.choices;
+    return select({
+        message: step.message ?? 'Select:',
+        choices: choices.map((c) => ({
+            name: c.label,
+            value: c.value,
+            description: c.description,
+        })),
+    });
+}
+async function executeInput(step, ctx) {
+    const defaultVal = typeof step.default === 'function' ? step.default(ctx) : step.default;
+    return input({
+        message: step.message ?? 'Enter value:',
+        default: defaultVal,
+        validate: step.validate
+            ? (value) => step.validate(value, ctx)
+            : undefined,
+    });
+}
+async function executeConfirm(step) {
+    return confirm({
+        message: step.message ?? 'Confirm?',
+        default: step.default,
+    });
+}
+async function executeStep(step, ctx) {
+    // Run before hook
+    if (step.before) {
+        await step.before(ctx);
+    }
+    // Check when condition
+    if (step.when) {
+        const shouldRun = await step.when(ctx);
+        if (!shouldRun)
+            return;
+    }
+    switch (step.type) {
+        case 'pick':
+            ctx[step.id] = await executePick(step, ctx);
+            break;
+        case 'select':
+            ctx[step.id] = await executeSelect(step, ctx);
+            break;
+        case 'input':
+            ctx[step.id] = await executeInput(step, ctx);
+            break;
+        case 'confirm':
+            ctx[step.id] = await executeConfirm(step);
+            break;
+        case 'branch':
+            await executeBranch(step, ctx);
+            break;
+    }
+}
+async function executeBranch(step, ctx) {
+    const result = await step.on(ctx);
+    if (Array.isArray(result)) {
+        // Inject dynamic steps
+        for (const dynamicStep of result) {
+            await executeStep(dynamicStep, ctx);
+        }
+    }
+    // If result is a string, it's a step ID — handled by the main loop as a goto
+    // We store it in context so the main loop can jump
+    if (typeof result === 'string') {
+        ctx.__branch_target = result;
+    }
+}
+export async function wizard(steps, initialContext = {}) {
+    const ctx = { ...initialContext };
+    let i = 0;
+    while (i < steps.length) {
+        const step = steps[i];
+        await executeStep(step, ctx);
+        // Handle branch jump
+        if (ctx.__branch_target) {
+            const target = ctx.__branch_target;
+            delete ctx.__branch_target;
+            if (target === 'done')
+                break;
+            const targetIndex = steps.findIndex((s) => s.id === target);
+            if (targetIndex >= 0) {
+                i = targetIndex;
+                continue;
+            }
+            // If target not found, just move forward
+        }
+        i++;
+    }
+    // Clean up internal keys
+    delete ctx.__branch_target;
+    return ctx;
+}
+//# sourceMappingURL=wizard.js.map

package/wizard.js.map

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