@regardio/dev 2.3.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 chooseForEach, o as gitRead, s as runQualityChecks, t as branchExists } from "./utils-VktE94Vs.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.
@@ -72,7 +72,16 @@ function runShipHotfix(subcommand, subArgs, cwd = process.cwd()) {
 			process.exit(0);
 		}
 		console.log("\nBumping versions and updating CHANGELOGs...");
-		for (const { package: pkg, bump } of bumps) runScript(`--filter ${pkg.name} release:${bump}`);
+		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}`}`);
+			}
+			process.chdir(originalCwd);
+		}
 		console.log("\nFetching latest state from origin...");
 		git("fetch", "origin");
 		console.log("\nMerging hotfix into production...");

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 chooseForEach, o as gitRead, r as confirm, s as runQualityChecks, t as branchExists } from "./utils-VktE94Vs.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.
@@ -66,7 +66,16 @@ function runShipProduction(cwd = process.cwd()) {
 	}
 	console.log("✅ Quality checks passed");
 	console.log("\nBumping versions and updating CHANGELOGs...");
-	for (const { package: pkg, bump } of bumps) runScript(`--filter ${pkg.name} release:${bump}`);
+	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}`}`);
+		}
+		process.chdir(originalCwd);
+	}
 	console.log("\nMerging main into production...");
 	git("checkout", "production");
 	git("pull", "--ff-only", "origin", "production");

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-VktE94Vs.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-VktE94Vs.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");
 };
@@ -44,26 +44,34 @@ const chooseForEach = (packages, ttyPath = "/dev/tty") => {
 	const bumps = [];
 	const options = [
 		{
-			label: "skip",
-			value: "skip"
+			label: "0) skip",
+			value: "0"
 		},
 		{
-			label: "patch — bug fixes",
-			value: "patch"
+			label: "1) patch — bug fixes",
+			value: "1"
 		},
 		{
-			label: "minor — new features",
-			value: "minor"
+			label: "2) minor — new features",
+			value: "2"
 		},
 		{
-			label: "major — breaking changes",
-			value: "major"
+			label: "3) major — breaking changes",
+			value: "3"
 		}
 	];
 	for (const pkg of packages) {
 		const answer = choose(`\n${pkg.name}:`, [...options], ttyPath);
-		if (answer !== "skip") bumps.push({
-			bump: answer,
+		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
 		});
 	}
@@ -87,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;

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 all publishable workspace packages and asks you to assign a bump type — `skip`, `patch`, `minor`, or `major` — to each one individually. Packages you skip are left untouched. For each package with a bump, 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`. The branches merge once after all bumps are applied. CI on `production` publishes only the packages whose version changed.
+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 per package at ship time.** When running `ship-production` or `ship-hotfix finish`, every publishable package is listed and you assign it `skip`, `patch`, `minor`, or `major`. Packages you skip are untouched. The conventional commits in the log inform each choice; the decisions are 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
@@ -137,10 +137,10 @@ 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
-4. For each publishable package: choose `skip / patch / minor / major`
+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 `pnpm --filter <pkg> release:<type>` — bumps version, rewrites `CHANGELOG.md`, commits
+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 all new version tags
@@ -167,13 +167,15 @@ git add . && git commit -m "fix: ..."
 pnpm ship:hotfix finish
 ```
 
-`finish` asks you to assign a bump type (`skip`, `patch`, `minor`, or `major`) to each publishable package, runs `pnpm --filter <pkg> release:<type>` 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`.
+`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.3.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",