hatchkit 0.1.13 → 0.1.15

package/dist/utils/multiselect.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Multi-select prompt with intuitive keybindings:
+ *   ↑↓     navigate
+ *   Enter  toggle the highlighted option
+ *   Tab    submit (advance to the next prompt)
+ *   Space  also toggles (kept as an alias for inquirer-muscle-memory)
+ *
+ * Built on @inquirer/core so it composes with the rest of the
+ * @inquirer/prompts the CLI already uses (input/select/confirm). The
+ * vanilla `checkbox` from @inquirer/prompts uses Space=toggle +
+ * Enter=submit, which conflicts with the rest of the flow where Enter
+ * is the universal "go" key — this swap makes Enter behave consistently
+ * (it always advances state on the current prompt) and Tab moves to the
+ * next prompt, which is the same convention as web forms.
+ */
+import { Separator } from "@inquirer/core";
+export interface MultiselectChoice<Value> {
+    value: Value;
+    name?: string;
+    description?: string;
+    disabled?: boolean | string;
+    checked?: boolean;
+}
+export interface MultiselectConfig<Value> {
+    message: string;
+    choices: ReadonlyArray<Separator | MultiselectChoice<Value>>;
+    pageSize?: number;
+    loop?: boolean;
+    required?: boolean;
+}
+/** Typed wrapper that gives back `Value[]` for callers. */
+export declare function multiselect<Value>(config: MultiselectConfig<Value>): Promise<Value[]>;
+export { Separator };
+//# sourceMappingURL=multiselect.d.ts.map

package/dist/utils/multiselect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiselect.d.ts","sourceRoot":"","sources":["../../src/utils/multiselect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,SAAS,EAeV,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,iBAAiB,CAAC,KAAK;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkKD,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAErF;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/utils/multiselect.js

@@ -0,0 +1,156 @@
+/**
+ * Multi-select prompt with intuitive keybindings:
+ *   ↑↓     navigate
+ *   Enter  toggle the highlighted option
+ *   Tab    submit (advance to the next prompt)
+ *   Space  also toggles (kept as an alias for inquirer-muscle-memory)
+ *
+ * Built on @inquirer/core so it composes with the rest of the
+ * @inquirer/prompts the CLI already uses (input/select/confirm). The
+ * vanilla `checkbox` from @inquirer/prompts uses Space=toggle +
+ * Enter=submit, which conflicts with the rest of the flow where Enter
+ * is the universal "go" key — this swap makes Enter behave consistently
+ * (it always advances state on the current prompt) and Tab moves to the
+ * next prompt, which is the same convention as web forms.
+ */
+import { Separator, ValidationError, createPrompt, isDownKey, isEnterKey, isNumberKey, isSpaceKey, isTabKey, isUpKey, makeTheme, useKeypress, useMemo, usePagination, usePrefix, useState, } from "@inquirer/core";
+import figures from "@inquirer/figures";
+import chalk from "chalk";
+function isSelectable(item) {
+    return !Separator.isSeparator(item) && !item.disabled;
+}
+function normalize(choices) {
+    return choices.map((c) => {
+        if (Separator.isSeparator(c))
+            return c;
+        const name = c.name ?? String(c.value);
+        return {
+            value: c.value,
+            name,
+            description: c.description,
+            disabled: c.disabled ?? false,
+            checked: c.checked ?? false,
+        };
+    });
+}
+const corePrompt = createPrompt((config, done) => {
+    const { pageSize = 10, loop = true, required = false } = config;
+    const theme = makeTheme();
+    const [status, setStatus] = useState("idle");
+    const prefix = usePrefix({ status, theme });
+    const [items, setItems] = useState(normalize(config.choices));
+    const bounds = useMemo(() => {
+        const first = items.findIndex(isSelectable);
+        let last = -1;
+        for (let i = items.length - 1; i >= 0; i--) {
+            if (isSelectable(items[i])) {
+                last = i;
+                break;
+            }
+        }
+        if (first === -1) {
+            throw new ValidationError("[multiselect] No selectable choices.");
+        }
+        return { first, last };
+    }, [items]);
+    const [active, setActive] = useState(bounds.first);
+    const [errorMsg, setError] = useState();
+    const toggleAt = (index) => {
+        setError(undefined);
+        setItems(items.map((c, i) => {
+            if (i !== index)
+                return c;
+            if (!isSelectable(c))
+                return c;
+            return { ...c, checked: !c.checked };
+        }));
+    };
+    useKeypress((key) => {
+        if (isTabKey(key)) {
+            const selection = items.filter((c) => isSelectable(c) && c.checked);
+            if (required && selection.length === 0) {
+                setError("Pick at least one (use Enter to toggle).");
+                return;
+            }
+            setStatus("done");
+            done(selection.map((c) => c.value));
+            return;
+        }
+        if (isEnterKey(key) || isSpaceKey(key)) {
+            toggleAt(active);
+            return;
+        }
+        if (isUpKey(key) || isDownKey(key)) {
+            if (loop ||
+                (isUpKey(key) && active !== bounds.first) ||
+                (isDownKey(key) && active !== bounds.last)) {
+                const offset = isUpKey(key) ? -1 : 1;
+                let next = active;
+                do {
+                    next = (next + offset + items.length) % items.length;
+                } while (!isSelectable(items[next]));
+                setActive(next);
+            }
+            return;
+        }
+        if (isNumberKey(key)) {
+            const idx = Number(key.name) - 1;
+            let seen = -1;
+            const pos = items.findIndex((it) => {
+                if (Separator.isSeparator(it))
+                    return false;
+                seen++;
+                return seen === idx;
+            });
+            if (pos !== -1 && isSelectable(items[pos])) {
+                setActive(pos);
+                toggleAt(pos);
+            }
+        }
+    });
+    const message = theme.style.message(config.message, status);
+    if (status === "done") {
+        const selected = items.filter((c) => isSelectable(c) && c.checked);
+        const tail = selected.length > 0 ? selected.map((c) => c.name).join(", ") : chalk.dim("none");
+        return `${prefix} ${message} ${theme.style.answer(tail)}`;
+    }
+    let description;
+    const page = usePagination({
+        items,
+        active,
+        renderItem({ item, isActive }) {
+            if (Separator.isSeparator(item))
+                return ` ${item.separator}`;
+            if (item.disabled) {
+                const label = typeof item.disabled === "string" ? item.disabled : "(disabled)";
+                return chalk.dim(`- ${item.name} ${label}`);
+            }
+            if (isActive)
+                description = item.description;
+            const box = item.checked ? chalk.green(figures.circleFilled) : figures.circle;
+            const cursor = isActive ? figures.pointer : " ";
+            const line = `${cursor}${box} ${item.name}`;
+            return isActive ? theme.style.highlight(line) : line;
+        },
+        pageSize,
+        loop,
+    });
+    const help = chalk.dim(`${chalk.bold("↑↓")} navigate · ${chalk.bold("enter")} toggle · ${chalk.bold("tab")} submit`);
+    return [
+        `${prefix} ${message}`,
+        page,
+        " ",
+        description ? chalk.cyan(description) : "",
+        errorMsg ? theme.style.error(errorMsg) : "",
+        help,
+    ]
+        .filter(Boolean)
+        .join("\n")
+        .trimEnd();
+});
+/** Typed wrapper that gives back `Value[]` for callers. */
+export function multiselect(config) {
+    return corePrompt(config);
+}
+export { Separator };
+//# sourceMappingURL=multiselect.js.map

package/dist/utils/multiselect.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hatchkit",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "packageManager": "pnpm@10.33.2",
   "description": "Interactive CLI for scaffolding full-stack projects and provisioning observability/email clients",
   "type": "module",
@@ -24,13 +24,15 @@
     "check": "pnpm run typecheck && pnpm run lint && pnpm run test",
     "install-local": "pnpm run build && npm install -g .",
     "release": "pnpm run release:patch",
-    "release:patch": "node scripts/release-prep.mjs && npm version patch -m \"chore: release v%s\" && pnpm run _release:finish",
-    "release:minor": "node scripts/release-prep.mjs && npm version minor -m \"chore: release v%s\" && pnpm run _release:finish",
-    "release:major": "node scripts/release-prep.mjs && npm version major -m \"chore: release v%s\" && pnpm run _release:finish",
+    "release:patch": "node scripts/release-prep.mjs && node scripts/release-bump.mjs patch && pnpm run _release:finish",
+    "release:minor": "node scripts/release-prep.mjs && node scripts/release-bump.mjs minor && pnpm run _release:finish",
+    "release:major": "node scripts/release-prep.mjs && node scripts/release-bump.mjs major && pnpm run _release:finish",
     "_release:finish": "pnpm run build && pnpm run typecheck && npm publish --access public && git push --follow-tags && npm install -g .",
     "prepublishOnly": "pnpm run build"
   },
   "dependencies": {
+    "@inquirer/core": "^10.3.0",
+    "@inquirer/figures": "^1.0.0",
     "@inquirer/prompts": "^7.0.0",
     "chalk": "^5.3.0",
     "conf": "^13.0.0",

package/scripts/release-bump.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/*
+ * release-bump — bump cli/package.json + commit + tag, atomically.
+ *
+ * Replaces `npm version <bump> -m "..."` because npm's built-in
+ * version command silently skips the commit/tag step in this monorepo
+ * layout (cli/ is a workspace member, not the repo root, and the lock
+ * file npm tries to stage doesn't exist anymore — pnpm-lock.yaml at
+ * the workspace root is the source of truth). The result: every
+ * release left cli/package.json modified-but-uncommitted, the publish
+ * succeeded against an untracked version, and the release machinery
+ * drifted from git history.
+ *
+ * Doing the three steps ourselves is unambiguous: bump, stage, commit,
+ * tag. release-prep.mjs has already verified the working tree is
+ * clean before this runs, so the commit only contains the version bump.
+ *
+ * Usage: node scripts/release-bump.mjs <patch|minor|major>
+ */
+import { execSync } from "node:child_process";
+import { readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const cliDir = join(here, "..");
+const pkgPath = join(cliDir, "package.json");
+
+const bumpKind = process.argv[2];
+if (!["patch", "minor", "major"].includes(bumpKind)) {
+  console.error(`release-bump: expected patch|minor|major, got ${bumpKind ?? "(nothing)"}`);
+  process.exit(1);
+}
+
+function sh(cmd, opts = {}) {
+  return execSync(cmd, { encoding: "utf-8", ...opts }).trim();
+}
+
+const repoRoot = sh("git rev-parse --show-toplevel");
+
+const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+const current = pkg.version;
+const [maj, min, pat] = current.split(".").map((n) => Number(n) || 0);
+const next =
+  bumpKind === "major"
+    ? `${maj + 1}.0.0`
+    : bumpKind === "minor"
+      ? `${maj}.${min + 1}.0`
+      : `${maj}.${min}.${pat + 1}`;
+
+pkg.version = next;
+// npm's `npm version` keeps a trailing newline; preserve that so diffs
+// stay 1 line and don't churn whitespace.
+writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf-8");
+console.log(`  release-bump: ${current} → ${next}`);
+
+// Stage + commit + tag from the repo root so the path in the commit
+// is `cli/package.json` regardless of where the script was invoked.
+sh(`git add ${JSON.stringify(join("cli", "package.json"))}`, { cwd: repoRoot });
+sh(`git commit -m ${JSON.stringify(`chore: release v${next}`)}`, { cwd: repoRoot });
+sh(`git tag ${JSON.stringify(`v${next}`)}`, { cwd: repoRoot });
+console.log(`  release-bump: committed + tagged v${next}`);

package/scripts/release-prep.mjs

@@ -8,11 +8,10 @@
  * same baseline.
  *
  * ALSO refuses when the local cli/package.json version is at-or-
- * behind the version published to npm. `npm version patch` increments
- * from the LOCAL version, not the registry's, so drift between the
- * two leads to the script generating a number that's already taken
- * and the publish step crashing after build/typecheck. Catch it up
- * front instead.
+ * behind the version published to npm. release-bump.mjs increments
+ * from the LOCAL version, so drift between local and registry leads
+ * to the bump generating a number that's already taken and the
+ * publish step crashing after build/typecheck. Catch it up front.
  *
  * Skip with RELEASE_SKIP_PREP=1 (e.g. a CI-driven release that's
  * already vouched for cleanliness). RELEASE_SKIP_NPM_CHECK=1 only
@@ -118,13 +117,13 @@ function checkNpmDrift(repoRoot) {
     return [
       `local ${name}@${local} is behind the registry's ${registry}.`,
       "",
-      "  `npm version patch` increments from the LOCAL version, so a release now",
+      "  release-bump.mjs increments from the LOCAL version, so a release now",
       "  would try to publish a version that's already taken. Sync first:",
       "",
       `      cd ${join(repoRoot, "cli")}`,
       `      npm version ${registry} --no-git-tag-version    # match the registry`,
       `      cd ${repoRoot}`,
-      `      git add cli/package.json cli/package-lock.json`,
+      `      git add cli/package.json`,
       `      git commit -m "chore: release v${registry}"`,
       `      git tag v${registry}`,
       "",