@regardio/dev 1.18.3 → 1.20.0

package/README.md

@@ -51,23 +51,28 @@ Detailed documentation is organized by topic:
 
 ### Concepts
 
-- [Development Principles](./docs/concepts/development-principles.md) - Code quality, architecture, maintainability
-- [Coding Standards](./docs/concepts/coding-standards.md) - TypeScript, React, and general patterns
-- [Naming Conventions](./docs/concepts/naming-conventions.md) - Consistent naming across languages
-- [Commit Conventions](./docs/concepts/commits.md) - Conventional commits and changelog generation
-- [Testing Approach](./docs/concepts/testing.md) - Testing philosophy and patterns
-- [AI Agent Guidelines](./docs/concepts/ai-agents.md) - Instructions for AI coding assistants
+- [AI Agents](./docs/en/agents.md) - Instructions for AI coding assistants
+- [API](./docs/en/api.md) - API design and implementation guidelines
+- [Coding](./docs/en/coding.md) - TypeScript, React, and general patterns
+- [Commits](./docs/en/commits.md) - Conventional commits and changelog generation
+- [Documentation](./docs/en/documentation.md) - Documentation structure and conventions
+- [Naming](./docs/en/naming.md) - Consistent naming across languages
+- [Principles](./docs/en/principles.md) - Code quality, architecture, maintainability
+- [React](./docs/en/react.md) - React and TypeScript development patterns
+- [SQL](./docs/en/sql.md) - PostgreSQL/Supabase schema styling and structure
+- [Testing](./docs/en/testing.md) - Testing philosophy and patterns
+- [Writing](./docs/en/writing.md) - Voice, tone, and language for content
 
 ### Toolchain
 
-- [TypeScript](./docs/toolchain/typescript.md) - Strict TypeScript configuration
-- [Biome](./docs/toolchain/biome.md) - Linting and formatting
-- [Vitest](./docs/toolchain/vitest.md) - Unit and integration testing
-- [Playwright](./docs/toolchain/playwright.md) - End-to-end testing
-- [Commitlint](./docs/toolchain/commitlint.md) - Commit message validation
-- [Markdownlint](./docs/toolchain/markdownlint.md) - Markdown quality
-- [Husky](./docs/toolchain/husky.md) - Git hooks
-- [Release Workflow](./docs/toolchain/release-workflow.md) - GitLab-flow-based versioning and releases
+- [Biome](./docs/en/toolchain/biome.md) - Linting and formatting
+- [Commitlint](./docs/en/toolchain/commitlint.md) - Commit message validation
+- [Husky](./docs/en/toolchain/husky.md) - Git hooks
+- [Markdownlint](./docs/en/toolchain/markdownlint.md) - Markdown quality
+- [Playwright](./docs/en/toolchain/playwright.md) - End-to-end testing
+- [Releases](./docs/en/toolchain/releases.md) - GitLab-flow-based versioning and releases
+- [TypeScript](./docs/en/toolchain/typescript.md) - Strict TypeScript configuration
+- [Vitest](./docs/en/toolchain/vitest.md) - Unit and integration testing
 
 ## Portability
 

package/dist/bin/ship/hotfix.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { execSync } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { branchExists, bumpVersion, git, gitRead, insertChangelog, runQualityChecks, runScript, } from './utils.js';
@@ -77,7 +78,31 @@ if (subcommand === 'finish') {
     const today = new Date().toISOString().slice(0, 10);
     insertChangelog(changelogPath, `## [${newVersion}] - ${today} (hotfix)\n\n${message}\n`);
     try {
-        runScript('fix');
+        runScript('fix:pkg');
+    }
+    catch {
+    }
+    try {
+        git('add', '-A');
+        const changedFiles = gitRead('diff', '--cached', '--name-only').split('\n').filter(Boolean);
+        for (const file of changedFiles) {
+            if (file.endsWith('.json')) {
+                try {
+                    execSync(`npx biome check --write ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+                }
+                catch {
+                }
+            }
+        }
+        for (const file of changedFiles) {
+            if (file.endsWith('.md')) {
+                try {
+                    execSync(`npx markdownlint-cli2 --fix ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+                }
+                catch {
+                }
+            }
+        }
     }
     catch {
     }

package/dist/bin/ship/production.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { execSync } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { branchExists, bumpVersion, confirm, git, gitRead, insertChangelog, runQualityChecks, runScript, } from './utils.js';
@@ -77,7 +78,31 @@ const changelogPath = join(process.cwd(), 'CHANGELOG.md');
 const today = new Date().toISOString().slice(0, 10);
 insertChangelog(changelogPath, `## [${newVersion}] - ${today}\n\n${changeBody}\n`);
 try {
-    runScript('fix');
+    runScript('fix:pkg');
+}
+catch {
+}
+try {
+    git('add', '-A');
+    const changedFiles = gitRead('diff', '--cached', '--name-only').split('\n').filter(Boolean);
+    for (const file of changedFiles) {
+        if (file.endsWith('.json')) {
+            try {
+                execSync(`npx biome check --write ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+            }
+            catch {
+            }
+        }
+    }
+    for (const file of changedFiles) {
+        if (file.endsWith('.md')) {
+            try {
+                execSync(`npx markdownlint-cli2 --fix ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+            }
+            catch {
+            }
+        }
+    }
 }
 catch {
 }

package/dist/bin/ship/staging.js

@@ -1,9 +1,7 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { branchExists, git, gitRead, runQualityChecks, runScript } from './utils.js';
-const args = process.argv.slice(2);
-const message = args.join(' ') || 'auto-fix formatting';
+import { branchExists, git, gitRead, runQualityChecks } from './utils.js';
 const currentBranch = gitRead('branch', '--show-current');
 if (currentBranch !== 'main') {
     console.error(`Must be on the main branch to release. Currently on: ${currentBranch}`);
@@ -42,16 +40,6 @@ catch {
     process.exit(1);
 }
 console.log('✅ Quality checks passed');
-try {
-    runScript('fix');
-}
-catch {
-}
-git('add', '-A');
-const hasStagedChanges = gitRead('diff', '--cached', '--name-only') !== '';
-if (hasStagedChanges) {
-    git('commit', '-m', `chore(staging): ${message}`);
-}
 console.log('\nMerging main into staging...');
 git('checkout', 'staging');
 git('merge', '--ff-only', 'main');

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "@regardio/dev",
-  "version": "1.18.3",
+  "version": "1.20.0",
   "private": false,
   "description": "Regardio developer tooling for testing, linting, and build workflows",
   "keywords": [
@@ -93,7 +93,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@biomejs/biome": "2.4.9",
+    "@biomejs/biome": "2.4.10",
     "@commitlint/cli": "20.5.0",
     "@commitlint/config-conventional": "20.5.0",
     "@playwright/test": "1.58.2",
@@ -101,19 +101,19 @@
     "@testing-library/react": "16.3.2",
     "@total-typescript/ts-reset": "0.6.1",
     "@types/node": "25.5.0",
-    "@vitest/coverage-v8": "4.1.1",
-    "@vitest/ui": "4.1.1",
+    "@vitest/coverage-v8": "4.1.2",
+    "@vitest/ui": "4.1.2",
     "husky": "9.1.7",
     "jsdom": "29.0.1",
     "markdownlint-cli2": "0.22.0",
     "npm-run-all": "4.1.5",
     "postcss": "8.5.8",
     "rimraf": "6.1.3",
-    "rollup": "4.60.0",
+    "rollup": "4.60.1",
     "sort-package-json": "3.6.1",
     "typescript": "6.0.2",
-    "vite": "8.0.2",
-    "vitest": "4.1.1"
+    "vite": "8.0.3",
+    "vitest": "4.1.2"
   },
   "devDependencies": {
     "tsx": "4.21.0"

package/src/bin/ship/hotfix.ts

@@ -22,6 +22,7 @@
  *   7. Pushes all three branches, deletes the hotfix branch
  *   8. Checks out main
  */
+import { execSync } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 
@@ -146,11 +147,41 @@ if (subcommand === 'finish') {
   const today = new Date().toISOString().slice(0, 10);
   insertChangelog(changelogPath, `## [${newVersion}] - ${today} (hotfix)\n\n${message}\n`);
 
-  // Fix formatting if available
+  // Fix formatting of modified files (package.json, CHANGELOG.md)
   try {
-    runScript('fix');
+    runScript('fix:pkg');
   } catch {
-    // fix may not exist in all packages
+    // fix:pkg may not exist
+  }
+
+  // Format modified files
+  try {
+    git('add', '-A');
+    const changedFiles = gitRead('diff', '--cached', '--name-only').split('\n').filter(Boolean);
+
+    // Format JSON files with biome
+    for (const file of changedFiles) {
+      if (file.endsWith('.json')) {
+        try {
+          execSync(`npx biome check --write ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+        } catch {
+          // File might not need formatting or biome not available
+        }
+      }
+    }
+
+    // Format markdown files with markdownlint
+    for (const file of changedFiles) {
+      if (file.endsWith('.md')) {
+        try {
+          execSync(`npx markdownlint-cli2 --fix ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+        } catch {
+          // File might not need formatting or markdownlint not available
+        }
+      }
+    }
+  } catch {
+    // Formatters not available
   }
 
   // Commit

package/src/bin/ship/production.ts

@@ -23,6 +23,7 @@
  * 10. Merges production back into main to ensure consistency
  * 11. Returns to main
  */
+import { execSync } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 
@@ -167,12 +168,42 @@ const today = new Date().toISOString().slice(0, 10);
 insertChangelog(changelogPath, `## [${newVersion}] - ${today}\n\n${changeBody}\n`);
 
 // ---------------------------------------------------------------------------
-// Fix formatting if available
+// Fix formatting of modified files (package.json, CHANGELOG.md)
 // ---------------------------------------------------------------------------
 try {
-  runScript('fix');
+  runScript('fix:pkg');
 } catch {
-  // fix may not exist in all packages
+  // fix:pkg may not exist
+}
+
+// Format modified files
+try {
+  git('add', '-A');
+  const changedFiles = gitRead('diff', '--cached', '--name-only').split('\n').filter(Boolean);
+
+  // Format JSON files with biome
+  for (const file of changedFiles) {
+    if (file.endsWith('.json')) {
+      try {
+        execSync(`npx biome check --write ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+      } catch {
+        // File might not need formatting or biome not available
+      }
+    }
+  }
+
+  // Format markdown files with markdownlint
+  for (const file of changedFiles) {
+    if (file.endsWith('.md')) {
+      try {
+        execSync(`npx markdownlint-cli2 --fix ${file}`, { cwd: process.cwd(), stdio: 'inherit' });
+      } catch {
+        // File might not need formatting or markdownlint not available
+      }
+    }
+  }
+} catch {
+  // Formatters not available
 }
 
 // ---------------------------------------------------------------------------

package/src/bin/ship/staging.ts

@@ -19,18 +19,14 @@
  * This script:
  * 1. Ensures the current branch is main and the working tree is clean
  * 2. Pulls latest main from origin
- * 3. Runs quality checks locally (build, typecheck, tests)
- * 4. Runs fix — commits formatting output (if any) with a commitlint-compliant message
- * 5. Merges main into staging (fast-forward) and pushes
- * 6. Pushes main and returns so work can continue
+ * 3. Runs quality checks locally (build, lint, typecheck, tests)
+ * 4. Merges main into staging (fast-forward) and pushes
+ * 5. Pushes main and returns so work can continue
  */
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 
-import { branchExists, git, gitRead, runQualityChecks, runScript } from './utils.js';
-
-const args = process.argv.slice(2);
-const message = args.join(' ') || 'auto-fix formatting';
+import { branchExists, git, gitRead, runQualityChecks } from './utils.js';
 
 // ---------------------------------------------------------------------------
 // Guard: must be on main
@@ -93,24 +89,6 @@ try {
 }
 console.log('✅ Quality checks passed');
 
-// ---------------------------------------------------------------------------
-// Fix formatting if available
-// ---------------------------------------------------------------------------
-try {
-  runScript('fix');
-} catch {
-  // fix may not exist in all packages
-}
-
-// ---------------------------------------------------------------------------
-// Commit formatting fixes (if any)
-// ---------------------------------------------------------------------------
-git('add', '-A');
-const hasStagedChanges = gitRead('diff', '--cached', '--name-only') !== '';
-if (hasStagedChanges) {
-  git('commit', '-m', `chore(staging): ${message}`);
-}
-
 // ---------------------------------------------------------------------------
 // Merge into staging
 // ---------------------------------------------------------------------------