@regardio/dev 2.2.0 → 2.4.0

package/dist/bin/ship/hotfix.bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as git, c as runScript, i as getWorkspacePackages, n as choose, o as gitRead, s as runQualityChecks, t as branchExists } from "./utils-CGXmpKxp.mjs";
+import { a as git, c as runScript, i as getWorkspacePackages, n as chooseForEach, o as gitRead, s as runQualityChecks, t as branchExists } from "./utils-rnvdLrkF.mjs";
 //#region src/bin/ship/hotfix.ts
 /**
 * ship-hotfix: Manage hotfix branches based on production code.
@@ -65,30 +65,23 @@ function runShipHotfix(subcommand, subArgs, cwd = process.cwd()) {
 			console.error("No publishable workspace packages found.");
 			process.exit(1);
 		}
-		const packageName = packages.length === 1 ? packages[0]?.name ?? "" : choose("Which package to ship?", packages.map((p) => ({
-			label: p.name,
-			value: p.name
-		})));
-		if (!packageName) {
-			console.error("Could not determine package to ship.");
-			process.exit(1);
+		console.log("\nSelect a version bump for each package (or skip):");
+		const bumps = chooseForEach(packages);
+		if (bumps.length === 0) {
+			console.log("\nNo packages selected for release. Aborted.");
+			process.exit(0);
 		}
-		const bumpType = choose("Select version bump:", [
-			{
-				label: "patch — bug fixes",
-				value: "patch"
-			},
-			{
-				label: "minor — new features",
-				value: "minor"
-			},
-			{
-				label: "major — breaking changes",
-				value: "major"
+		console.log("\nBumping versions and updating CHANGELOGs...");
+		for (const { package: pkg, bump } of bumps) {
+			const originalCwd = process.cwd();
+			process.chdir(pkg.path);
+			try {
+				runScript(`--filter-root release:${bump}`);
+			} catch {
+				runScript(`commit-and-tag-version ${bump === "patch" ? "" : `--release-as ${bump}`}`);
 			}
-		]);
-		console.log("\nBumping version and updating CHANGELOG...");
-		runScript(`--filter ${packageName} release:${bumpType}`);
+			process.chdir(originalCwd);
+		}
 		console.log("\nFetching latest state from origin...");
 		git("fetch", "origin");
 		console.log("\nMerging hotfix into production...");
@@ -110,7 +103,8 @@ function runShipHotfix(subcommand, subArgs, cwd = process.cwd()) {
 		try {
 			git("push", "origin", "--delete", currentBranch);
 		} catch {}
-		console.log(`\n✅ Hotfix ${packageName} shipped to production → staging → main`);
+		const shipped = bumps.map((b) => b.package.name).join(", ");
+		console.log(`\n✅ Hotfix ${shipped} shipped to production → staging → main`);
 		console.log("CI will publish changed packages to npm.");
 		console.log("You are on main and ready to keep working.");
 		process.exit(0);

package/dist/bin/ship/production.bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as git, c as runScript, i as getWorkspacePackages, n as choose, o as gitRead, r as confirm, s as runQualityChecks, t as branchExists } from "./utils-CGXmpKxp.mjs";
+import { a as git, c as runScript, i as getWorkspacePackages, n as chooseForEach, o as gitRead, r as confirm, s as runQualityChecks, t as branchExists } from "./utils-rnvdLrkF.mjs";
 //#region src/bin/ship/production.ts
 /**
 * ship-production: Promote main to production following the GitLab workflow.
@@ -47,15 +47,13 @@ function runShipProduction(cwd = process.cwd()) {
 		console.error("No publishable workspace packages found.");
 		process.exit(1);
 	}
-	const packageName = packages.length === 1 ? packages[0]?.name ?? "" : choose("Which package to ship?", packages.map((p) => ({
-		label: p.name,
-		value: p.name
-	})));
-	if (!packageName) {
-		console.error("Could not determine package to ship.");
-		process.exit(1);
+	console.log("\nSelect a version bump for each package (or skip):");
+	const bumps = chooseForEach(packages);
+	if (bumps.length === 0) {
+		console.log("\nNo packages selected for release. Aborted.");
+		process.exit(0);
 	}
-	if (!confirm(`Ship ${packageName} to production?`)) {
+	if (!confirm(`\nShip to production?\n${bumps.map((b) => `  ${b.package.name}  →  ${b.bump}`).join("\n")}\n`)) {
 		console.log("Aborted.");
 		process.exit(0);
 	}
@@ -67,22 +65,17 @@ function runShipProduction(cwd = process.cwd()) {
 		process.exit(1);
 	}
 	console.log("✅ Quality checks passed");
-	const bumpType = choose("Select version bump:", [
-		{
-			label: "patch — bug fixes",
-			value: "patch"
-		},
-		{
-			label: "minor — new features",
-			value: "minor"
-		},
-		{
-			label: "major — breaking changes",
-			value: "major"
+	console.log("\nBumping versions and updating CHANGELOGs...");
+	for (const { package: pkg, bump } of bumps) {
+		const originalCwd = process.cwd();
+		process.chdir(pkg.path);
+		try {
+			runScript(`--filter-root release:${bump}`);
+		} catch {
+			runScript(`commit-and-tag-version ${bump === "patch" ? "" : `--release-as ${bump}`}`);
 		}
-	]);
-	console.log("\nBumping version and updating CHANGELOG...");
-	runScript(`--filter ${packageName} release:${bumpType}`);
+		process.chdir(originalCwd);
+	}
 	console.log("\nMerging main into production...");
 	git("checkout", "production");
 	git("pull", "--ff-only", "origin", "production");
@@ -95,7 +88,8 @@ function runShipProduction(cwd = process.cwd()) {
 	git("push", "origin", "staging");
 	git("checkout", "main");
 	git("push", "--follow-tags", "origin", "main");
-	console.log(`\n✅ Shipped ${packageName} to production. CI will publish changed packages to npm.`);
+	const shipped = bumps.map((b) => b.package.name).join(", ");
+	console.log(`\n✅ Shipped ${shipped} to production. CI will publish changed packages to npm.`);
 	console.log("You are on main and ready to keep working.");
 }
 //#endregion

package/dist/bin/ship/staging.bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as git, o as gitRead, s as runQualityChecks, t as branchExists } from "./utils-CGXmpKxp.mjs";
+import { a as git, o as gitRead, s as runQualityChecks, t as branchExists } from "./utils-rnvdLrkF.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/bin/ship/staging.ts

package/dist/bin/ship/{utils-CGXmpKxp.mjs → utils-rnvdLrkF.mjs}

@@ -20,7 +20,7 @@ const runScript = (script) => {
 	execSync(`pnpm ${script}`, { stdio: "inherit" });
 };
 const runQualityChecks = () => {
-	runScript("build");
+	runScript("lint");
 	runScript("typecheck");
 	runScript("test");
 };
@@ -40,6 +40,43 @@ const getWorkspacePackages = (cwd = process.cwd()) => {
 		path
 	}));
 };
+const chooseForEach = (packages, ttyPath = "/dev/tty") => {
+	const bumps = [];
+	const options = [
+		{
+			label: "0) skip",
+			value: "0"
+		},
+		{
+			label: "1) patch — bug fixes",
+			value: "1"
+		},
+		{
+			label: "2) minor — new features",
+			value: "2"
+		},
+		{
+			label: "3) major — breaking changes",
+			value: "3"
+		}
+	];
+	for (const pkg of packages) {
+		const answer = choose(`\n${pkg.name}:`, [...options], ttyPath);
+		if (answer === "1") bumps.push({
+			bump: "patch",
+			package: pkg
+		});
+		else if (answer === "2") bumps.push({
+			bump: "minor",
+			package: pkg
+		});
+		else if (answer === "3") bumps.push({
+			bump: "major",
+			package: pkg
+		});
+	}
+	return bumps;
+};
 const branchExists = (name) => gitRead("branch", "--list", name) !== "" || gitRead("branch", "--list", "--remotes", `origin/${name}`) !== "";
 const confirm = (prompt, ttyPath = "/dev/tty") => {
 	process.stdout.write(`${prompt} (y/N) `);
@@ -58,8 +95,8 @@ const confirm = (prompt, ttyPath = "/dev/tty") => {
 	return answer === "y" || answer === "Y";
 };
 const choose = (prompt, options, ttyPath = "/dev/tty") => {
-	const keys = options.map((_, i) => String(i + 1));
-	const optionList = options.map((o, i) => `  ${i + 1}) ${o.label}`).join("\n");
+	const keys = options.map((o) => o.value);
+	const optionList = options.map((o) => `  ${o.label}`).join("\n");
 	process.stdout.write(`${prompt}\n${optionList}\nChoice [${keys.join("/")}]: `);
 	const buf = Buffer.alloc(1024);
 	let fd;
@@ -83,4 +120,4 @@ const choose = (prompt, options, ttyPath = "/dev/tty") => {
 	return chosen.value;
 };
 //#endregion
-export { git as a, runScript as c, getWorkspacePackages as i, choose as n, gitRead as o, confirm as r, runQualityChecks as s, branchExists as t };
+export { git as a, runScript as c, getWorkspacePackages as i, chooseForEach as n, gitRead as o, confirm as r, runQualityChecks as s, branchExists as t };

package/dist/playwright/index.d.mts

@@ -10,9 +10,9 @@ interface BuildPlaywrightBaseConfigParams {
   webServerCommand: string;
 }
 /**
- * Build a base Playwright config object with Regardio defaults.
- * Consumers should wrap with defineConfig() in their local playwright.config.ts
- */
+* Build a base Playwright config object with Regardio defaults.
+* Consumers should wrap with defineConfig() in their local playwright.config.ts
+*/
 declare function buildPlaywrightBaseConfig({
   appUrl,
   appPort,

package/dist/vitest/node.d.mts

@@ -1,8 +1,8 @@
 //#region src/vitest/node.d.ts
 /**
- * Base Vitest configuration for Node.js packages.
- * Use with defineConfig() in your vitest.config.ts
- */
+* Base Vitest configuration for Node.js packages.
+* Use with defineConfig() in your vitest.config.ts
+*/
 declare const vitestNodeConfig: {
   coverage: {
     provider: "v8";

package/dist/vitest/react.d.mts

@@ -1,8 +1,8 @@
 //#region src/vitest/react.d.ts
 /**
- * Vitest configuration for React packages with jsdom environment.
- * Use with defineConfig() in your vitest.config.ts
- */
+* Vitest configuration for React packages with jsdom environment.
+* Use with defineConfig() in your vitest.config.ts
+*/
 declare const vitestReactConfig: {
   coverage: {
     provider: "v8";

package/docs/en/tools/releases.md

@@ -25,17 +25,17 @@ main → staging (optional) → production
 - **`staging`** — optional validation environment. No versioning happens here.
 - **`production`** — versioned, published code only.
 
-When `ship-production` runs, it discovers publishable workspace packages. In a monorepo with multiple packages, you choose which package to ship; in a single-package repo the choice is automatic. Then you choose the bump type (`patch`, `minor`, `major`) and it calls `pnpm --filter <package> release:<type>`, which bumps that package's version, rewrites its `CHANGELOG.md` using commits since its last scoped tag, and commits on `main` before merging to `production`. CI on `production` publishes changed packages to npm.
+When `ship-production` runs, it discovers all publishable workspace packages and asks you to assign a bump type — `0` (skip), `1` (patch), `2` (minor), or `3` (major) — to each one individually. Packages you skip are left untouched. For each package with a bump, it first tries to run the release script from the root package.json (using `--filter-root release:<type>`), and if that fails, falls back to running `commit-and-tag-version` directly with the appropriate bump flag. This bumps that package's version, rewrites its `CHANGELOG.md` using commits since its last scoped tag, and commits on `main`. The branches merge once after all bumps are applied. CI on `production` publishes only the packages whose version changed.
 
 ## How It Works
 
 ### Design principles
 
 1. **Branches mirror environments.** `staging` reflects what is deployed to the staging server (when used); `production` always reflects what is published to npm. There is never ambiguity about what is running where.
-2. **You choose the bump at ship time.** When running `ship-production` or `ship-hotfix finish`, you are prompted to select `patch`, `minor`, or `major`. The conventional commits in the log inform that choice; the decision is always explicit.
+2. **You choose the bump per package at ship time.** When running `ship-production` or `ship-hotfix finish`, every publishable package is listed and you assign it `0` (skip), `1` (patch), `2` (minor), or `3` (major). Packages you skip are untouched. The conventional commits in the log inform each choice; the decisions are always explicit.
 3. **Version numbers are a production guarantee.** Bumps are applied only at `ship-production` time. Every version tag in git and every release on npm corresponds to code that has been validated and shipped.
 4. **Staging is optional.** You can ship directly from `main` to `production`. Use `ship-staging` when you want to test changes in a staging environment first.
-5. **Tests are a local gate, not a CI gate.** Quality checks (`build`, `typecheck`, `test`) run on your machine before any commit is made. Broken code cannot enter the repository.
+5. **Tests are a local gate, not a CI gate.** Quality checks (`lint`, `typecheck`, `test`) run on your machine before any commit is made. Broken code cannot enter the repository.
 6. **You always land back on `main`.** Every command returns you to `main` when it finishes.
 
 ### Full flow diagram
@@ -136,14 +136,14 @@ This will:
 
 1. Guard: must be on `main`, working tree clean
 2. Fetch and verify `staging` + `production` branches exist
-3. Show commits to be shipped, ask for confirmation
-4. Run full quality suite on `main` — aborts on failure
-5. If multiple publishable packages exist: prompt for which package to ship
-6. Prompt for bump type: `patch`, `minor`, or `major`
-7. Run `pnpm --filter <package> release:<type>` — bumps version, rewrites `CHANGELOG.md`, commits
+3. Show commits to be shipped
+4. For each publishable package: choose `0 (skip) / 1 (patch) / 2 (minor) / 3 (major)`
+5. Confirm the planned bumps — abort if declined or all skipped
+6. Run full quality suite on `main` — aborts on failure
+7. For each non-skipped package: run release script from root (if defined) or `commit-and-tag-version` directly — bumps version, rewrites `CHANGELOG.md`, commits
 8. Fast-forward merge `main` into `production` and push
 9. Sync `staging` with `production`
-10. Push `main` with `--follow-tags` to push the version tag
+10. Push `main` with `--follow-tags` to push all new version tags
 11. Return to `main`
 
 CI on `production` runs `pnpm -r publish` to push changed packages to npm.
@@ -167,13 +167,15 @@ git add . && git commit -m "fix: ..."
 pnpm ship:hotfix finish
 ```
 
-`finish` prompts for a bump type (`patch`, `minor`, or `major`), runs `pnpm release:<type>` to bump the version and update `CHANGELOG.md`, then merges `hotfix → production → staging → main` and deletes the hotfix branch. CI publishes from `production`.
+`finish` asks you to assign a bump type (`0` (skip), `1` (patch), `2` (minor), or `3` (major)) to each publishable package, runs the release script from root (if defined) or `commit-and-tag-version` directly for each non-skipped one to bump versions and update `CHANGELOG.md`, then merges `hotfix → production → staging → main` and deletes the hotfix branch. CI publishes from `production`.
 
 ## Adoption
 
 Install `@regardio/dev` and:
 
-1. **Add the scripts to `package.json`**:
+1. **Add the scripts to `package.json`** (optional, for monorepos):
+
+   In a monorepo, you can define release scripts in the root `package.json` to centralize version management. The ship scripts will use these if available, and fall back to running `commit-and-tag-version` directly if not.
 
    ```json
    {
@@ -189,6 +191,8 @@ Install `@regardio/dev` and:
    }
    ```
 
+   For single-package repos or when you prefer direct `commit-and-tag-version` usage, you can omit the release scripts — the ship commands will call `commit-and-tag-version` directly.
+
 2. **Add a `.versionrc.json` to each publishable package** with a scoped `tagPrefix` so tags and changelogs stay isolated per package:
 
    ```bash

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "@regardio/dev",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "private": false,
   "description": "Regardio development presets: biome, typescript, commitlint, markdownlint, vitest, playwright, sqlfluff, husky, and GitLab-flow ship tooling",
   "keywords": [
@@ -98,10 +98,6 @@
     "clean": "rimraf .turbo dist",
     "dev": "tsdown --watch",
     "fix": "run-s fix:pkg fix:md fix:biome",
-    "release": "commit-and-tag-version",
-    "release:major": "commit-and-tag-version --release-as major",
-    "release:minor": "commit-and-tag-version --release-as minor",
-    "release:patch": "commit-and-tag-version --release-as patch",
     "fix:biome": "biome check --write --unsafe .",
     "fix:md": "markdownlint-cli2 --config ../../.markdownlint-cli2.jsonc --fix",
     "fix:pkg": "sort-package-json",

package/src/typescript/base.json

@@ -7,12 +7,13 @@
     "allowUnusedLabels": false,
     "alwaysStrict": true,
     "checkJs": false,
+    "declaration": true,
     "esModuleInterop": true,
     "exactOptionalPropertyTypes": false,
     "forceConsistentCasingInFileNames": true,
     "incremental": false,
     "inlineSources": false,
-    "isolatedDeclarations": false,
+    "isolatedDeclarations": true,
     "isolatedModules": true,
     "module": "ESNext",
     "moduleDetection": "force",