@regardio/dev 2.4.0 → 2.4.1

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

@@ -72,15 +72,13 @@ function runShipHotfix(subcommand, subArgs, cwd = process.cwd()) {
 			process.exit(0);
 		}
 		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}`}`);
-			}
-			process.chdir(originalCwd);
+		const hasMajor = bumps.some((b) => b.bump === "major");
+		const hasMinor = bumps.some((b) => b.bump === "minor");
+		const highestBump = hasMajor ? "major" : hasMinor ? "minor" : "patch";
+		try {
+			runScript(`release:${highestBump}`);
+		} catch {
+			console.log("No release script found - skipping versioning (non-publishing repo)");
 		}
 		console.log("\nFetching latest state from origin...");
 		git("fetch", "origin");

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

@@ -42,6 +42,14 @@ function runShipProduction(cwd = process.cwd()) {
 	}
 	console.log("\nCommits to be shipped to production:");
 	console.log(ahead);
+	console.log("\nRunning quality checks on main...");
+	try {
+		runQualityChecks();
+	} catch {
+		console.error("\nQuality checks failed on main. Fix issues before shipping.");
+		process.exit(1);
+	}
+	console.log("✅ Quality checks passed");
 	const packages = getWorkspacePackages(cwd);
 	if (packages.length === 0) {
 		console.error("No publishable workspace packages found.");
@@ -57,24 +65,14 @@ function runShipProduction(cwd = process.cwd()) {
 		console.log("Aborted.");
 		process.exit(0);
 	}
-	console.log("\nRunning quality checks on main...");
+	console.log("\nBumping versions and updating CHANGELOGs...");
+	const hasMajor = bumps.some((b) => b.bump === "major");
+	const hasMinor = bumps.some((b) => b.bump === "minor");
+	const highestBump = hasMajor ? "major" : hasMinor ? "minor" : "patch";
 	try {
-		runQualityChecks();
+		runScript(`release:${highestBump}`);
 	} catch {
-		console.error("\nQuality checks failed on main. Fix issues before shipping.");
-		process.exit(1);
-	}
-	console.log("✅ Quality checks passed");
-	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}`}`);
-		}
-		process.chdir(originalCwd);
+		console.log("No release script found - skipping versioning (non-publishing repo)");
 	}
 	console.log("\nMerging main into production...");
 	git("checkout", "production");

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,11 +1,11 @@
 //#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";
+    provider: 'v8';
     thresholds: {
       branches: number;
       functions: number;

package/dist/vitest/react.d.mts

@@ -1,11 +1,11 @@
 //#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";
+    provider: 'v8';
     thresholds: {
       branches: number;
       functions: number;

package/docs/en/tools/releases.md

@@ -25,7 +25,7 @@ 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 — `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.
+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. It determines the highest bump type across all selected packages and runs `pnpm release:<type>` at the root, which bumps versions, rewrites `CHANGELOG.md`, and commits on `main`. If no release script exists (non-publishing repos like channels), versioning is skipped entirely and only the git merges happen. The branches merge once after all bumps are applied. CI on `production` publishes only the packages whose version changed.
 
 ## How It Works
 
@@ -53,7 +53,8 @@ main ───────────┤ quality checks pass      ├──►
                 ship-production
                 ┌──────────────────────────┐
                 │ quality checks on main   │
-                │ pnpm release             │
+                │ select packages/bumps    │
+                │ pnpm release:<type>*      │
 main ───────────┤ bumps version +          ├──► production
                 │ rewrites CHANGELOG.md    │
                 │ ff-merge main → prod     │
@@ -76,7 +77,7 @@ production ─────┤ create hotfix/fix-name   ├──► hotfix/fix-n
                 ship-hotfix finish
                 ┌──────────────────────────┐
                 │ quality checks           │
-                │ pnpm release             │
+                │ pnpm release:<type>*      │
 hotfix/fix-name ┤ bumps version +          ├──► production → staging → main
                 │ rewrites CHANGELOG.md    │
                 │ merge to production      │
@@ -137,10 +138,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 `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
+4. Run full quality suite on `main` — aborts on failure
+5. For each publishable package: choose `0 (skip) / 1 (patch) / 2 (minor) / 3 (major)`
+6. Confirm the planned bumps — abort if declined or all skipped
+7. Run `pnpm release:<type>` at the root (highest bump type) — bumps versions, rewrites `CHANGELOG.md`, commits. If no release script exists, skip versioning.
 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,15 +168,15 @@ git add . && git commit -m "fix: ..."
 pnpm ship:hotfix finish
 ```
 
-`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`.
+`finish` asks you to assign a bump type (`0` (skip), `1` (patch), `2` (minor), or `3` (major)) to each publishable package, runs `pnpm release:<type>` at the root (highest bump type) to bump versions and update `CHANGELOG.md`. If no release script exists, versioning is skipped. Then it 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`** (optional, for monorepos):
+1. **Add the scripts to `package.json`** (optional, for publishing repos):
 
-   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.
+   For repos that publish to npm, add release scripts to the root `package.json`:
 
    ```json
    {
@@ -191,7 +192,7 @@ 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.
+   For non-publishing repos (e.g., channels that deploy to servers), omit the release scripts — the ship commands will skip versioning and only perform the git merges. This makes the tools reusable across both publishing and non-publishing repositories.
 
 2. **Add a `.versionrc.json` to each publishable package** with a scoped `tagPrefix` so tags and changelogs stay isolated per package:
 
@@ -238,9 +239,11 @@ pnpm typecheck  # Must succeed
 pnpm test       # Must succeed
 ```
 
-## Private Packages
+## Private Packages and Non-Publishing Repos
 
-Packages that should never be published to npm must set `"private": true` in `package.json`. `pnpm -r publish` skips them automatically. The git flow (`ship-staging`, `ship-production`, `ship-hotfix`) works identically — version bumps and branch promotion continue as normal; only the npm publish step is skipped.
+Packages that should never be published to npm must set `"private": true` in `package.json`. `pnpm -r publish` skips them automatically.
+
+For non-publishing repos (e.g., channels that deploy directly to servers instead of npm), omit the `release:*` scripts from `package.json`. The ship tools will skip versioning entirely and only perform the git merges. CI can then handle deployment to servers based on the `production` branch.
 
 ## Related
 

package/docs/en/tools/typescript.md

@@ -17,33 +17,62 @@ Strict, shared TypeScript presets for Regardio projects. Extending from `@regard
 
 | Preset | Use case |
 |--------|----------|
-| `@regardio/dev/typescript/base` | Node.js packages, libraries |
-| `@regardio/dev/typescript/react` | React applications and components |
-| `@regardio/dev/typescript/build` | Build-specific settings (extends base) |
+| `@regardio/dev/typescript/base` | Non-publishing packages and meta-configs (e.g. the workspace root) |
+| `@regardio/dev/typescript/library` | Published Node.js packages — adds declaration enforcement |
+| `@regardio/dev/typescript/react` | React apps and channels — adds JSX and DOM libs |
+| `@regardio/dev/typescript/react-library` | Published React packages — JSX, DOM libs, and declaration enforcement |
+| `@regardio/dev/typescript/build` | Build-time emission settings (pair with any of the above) |
+
+### Choosing a preset
+
+The guiding question is whether the package **publishes type declarations** to consumers.
+
+- **App or channel** (`private: true`) → `react` (or `base` for non-React)
+- **Published library without React** → `library`
+- **Published library with React** → `react-library`
+
+The `library` and `react-library` presets add two settings on top of the base:
+
+- `declaration: true` — validates that `.d.ts` files can be generated (even when `noEmit: true` during typecheck)
+- `isolatedDeclarations: true` — enforces that every exported declaration carries an explicit type annotation, enabling per-file parallel declaration generation
+
+`isolatedDeclarations` is a library-authoring constraint. It requires explicit return types on exported functions and explicit annotations on exported variables. Applying it to app code is unnecessarily strict — especially with frameworks like TanStack Router whose `Route` objects carry deeply inferred generics that cannot be spelled out without extraordinary verbosity.
 
 ## Configuration
 
-### `tsconfig.json`
+### App or channel
 
 ```json
 {
-  "extends": "@regardio/dev/typescript/base",
+  "compilerOptions": {
+    "paths": { "#/*": ["./src/*"] }
+  },
+  "extends": "@regardio/dev/typescript/react",
+  "include": ["**/*.ts", "**/*.tsx", "**/*.d.ts"]
+}
+```
+
+### Published Node.js library
+
+```json
+{
+  "extends": "@regardio/dev/typescript/library",
   "include": ["src/**/*.ts"]
 }
 ```
 
-For React projects:
+### Published React library
 
 ```json
 {
-  "extends": "@regardio/dev/typescript/react",
+  "extends": "@regardio/dev/typescript/react-library",
   "include": ["src/**/*.ts", "src/**/*.tsx"]
 }
 ```
 
 ### `tsconfig.build.json`
 
-A separate build config for production output:
+Pair any preset with `build` for production output:
 
 ```json
 {
@@ -51,28 +80,26 @@ A separate build config for production output:
     "outDir": "./dist",
     "rootDir": "./src"
   },
-  "extends": ["./tsconfig.json", "@regardio/dev/typescript/build"],
-  "include": ["src/**/*.ts"]
+  "extends": ["./tsconfig.json", "@regardio/dev/typescript/build"]
 }
 ```
 
 ## Strict settings
 
-The base config turns on strict type-checking across the board:
+All presets share the same strict type-checking baseline:
 
 - `strict: true` — every strict type-checking option
 - `noUncheckedIndexedAccess: true` — adds `undefined` to index signatures
-- `exactOptionalPropertyTypes: true` — distinguishes `undefined` from missing
 - `noImplicitReturns: true` — every code path returns a value
 - `noFallthroughCasesInSwitch: true` — prevents switch-fallthrough surprises
+- `verbatimModuleSyntax: true` — `import type` vs. `import` must be explicit
 
 ## Scripts
 
 ```json
 {
   "scripts": {
-    "build": "exec-tsc --project tsconfig.build.json",
-    "typecheck": "exec-tsc --noEmit"
+    "typecheck": "tsc --noEmit"
   }
 }
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "@regardio/dev",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "private": false,
   "description": "Regardio development presets: biome, typescript, commitlint, markdownlint, vitest, playwright, sqlfluff, husky, and GitLab-flow ship tooling",
   "keywords": [
@@ -44,7 +44,9 @@
     },
     "./typescript/base": "./src/typescript/base.json",
     "./typescript/build": "./src/typescript/build.json",
+    "./typescript/library": "./src/typescript/library.json",
     "./typescript/react": "./src/typescript/react.json",
+    "./typescript/react-library": "./src/typescript/react-library.json",
     "./vitest/node": {
       "import": "./dist/vitest/node.mjs",
       "types": "./dist/vitest/node.d.mts"
@@ -61,6 +63,7 @@
   },
   "files": [
     "dist",
+    "LICENSE",
     "src/biome",
     "src/commitlint",
     "src/markdownlint",
@@ -73,7 +76,7 @@
     "@total-typescript/ts-reset": "0.6.1",
     "@types/node": "25.6.0",
     "@vitest/coverage-v8": "4.1.5",
-    "tsdown": "0.21.10",
+    "tsdown": "0.22.0",
     "vitest": "4.1.5"
   },
   "peerDependencies": {
@@ -90,9 +93,6 @@
     "typescript": ">=6",
     "vitest": ">=4"
   },
-  "engines": {
-    "node": ">=24"
-  },
   "scripts": {
     "build": "tsdown",
     "clean": "rimraf .turbo dist",

package/src/typescript/base.json

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

package/src/typescript/library.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://www.schemastore.org/tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "isolatedDeclarations": true
+  },
+  "extends": "./base.json"
+}

package/src/typescript/react-library.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://www.schemastore.org/tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "isolatedDeclarations": true
+  },
+  "extends": "./react.json"
+}