@regardio/dev 0.9.0

package/dist/bin/flow-version.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+function fail(message) {
+    console.error(message);
+    process.exit(1);
+}
+function run(cmd, args, options = {}) {
+    const result = spawnSync(cmd, args, { stdio: 'inherit', ...options });
+    if (result.status !== 0) {
+        fail(`Command failed: ${cmd} ${args.join(' ')}`);
+    }
+}
+const type = process.argv[2];
+if (!type || !['patch', 'minor', 'major'].includes(type)) {
+    fail('Usage: flow-version <patch|minor|major>');
+}
+const pkgPath = path.resolve(process.cwd(), 'package.json');
+if (!fs.existsSync(pkgPath)) {
+    fail('Error: package.json not found in current directory');
+}
+const pkgRaw = fs.readFileSync(pkgPath, 'utf8');
+let pkg;
+try {
+    pkg = JSON.parse(pkgRaw);
+}
+catch (_e) {
+    fail('Error: Failed to parse package.json');
+}
+const current = pkg.version || '0.0.0';
+console.log(`Current version: ${current}`);
+const [majorStr, minorStr, patchStr] = String(current).split('.');
+let major = Number(majorStr);
+let minor = Number(minorStr);
+let patch = Number(patchStr);
+switch (type) {
+    case 'major':
+        major += 1;
+        minor = 0;
+        patch = 0;
+        break;
+    case 'minor':
+        minor += 1;
+        patch = 0;
+        break;
+    case 'patch':
+        patch += 1;
+        break;
+}
+const newVersion = `${major}.${minor}.${patch}`;
+console.log(`New version: ${newVersion}`);
+pkg.version = newVersion;
+fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+run('pnpm', ['lint']);
+const isMajor = type === 'major';
+const isPatch = type === 'patch';
+const conventionalType = isPatch ? 'fix' : 'feat';
+const scope = 'release';
+const subject = `v${newVersion}`;
+const breakingBang = isMajor ? '!' : '';
+const commitMessage = `${conventionalType}(${scope})${breakingBang}: ${subject}` +
+    (isMajor ? `\n\nBREAKING CHANGE: ${subject}` : '');
+const branchRes = spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+    encoding: 'utf8',
+});
+if (branchRes.status !== 0)
+    fail('Error: Not a git repository or git not available');
+const currentBranch = branchRes.stdout.trim();
+if (currentBranch !== 'develop') {
+    fail(`Error: You must run releases from 'develop' (current: ${currentBranch})`);
+}
+run('git', ['add', 'package.json']);
+run('git', ['commit', '-m', commitMessage]);
+run('git', ['checkout', 'main']);
+run('git', ['merge', 'develop', '--no-ff', '-m', commitMessage]);
+run('git', ['tag', '-a', `v${newVersion}`, '-m', commitMessage]);
+run('git', ['push', 'origin', 'main']);
+run('git', ['push', 'origin', '--tags']);
+run('git', ['checkout', 'develop']);
+run('git', ['merge', 'main', '--ff-only']);
+run('git', ['push', 'origin', 'develop']);
+console.log(`Released version ${newVersion} successfully!`);

package/dist/bin/lint-biome.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=lint-biome.d.ts.map

package/dist/bin/lint-biome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-biome.d.ts","sourceRoot":"","sources":["../../src/bin/lint-biome.ts"],"names":[],"mappings":""}

package/dist/bin/lint-biome.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const bin = require.resolve('@biomejs/biome/bin/biome');
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));

package/dist/bin/lint-commit.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=lint-commit.d.ts.map

package/dist/bin/lint-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-commit.d.ts","sourceRoot":"","sources":["../../src/bin/lint-commit.ts"],"names":[],"mappings":""}

package/dist/bin/lint-commit.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const bin = require.resolve('@commitlint/cli/cli.js');
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));

package/dist/bin/lint-md.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=lint-md.d.ts.map

package/dist/bin/lint-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-md.d.ts","sourceRoot":"","sources":["../../src/bin/lint-md.ts"],"names":[],"mappings":""}

package/dist/bin/lint-md.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+const require = createRequire(import.meta.url);
+const packageDir = dirname(require.resolve('markdownlint-cli2'));
+const bin = join(packageDir, 'markdownlint-cli2-bin.mjs');
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));

package/dist/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":""}

package/dist/config.test.js

@@ -0,0 +1,101 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+const srcDir = path.dirname(fileURLToPath(import.meta.url));
+function readJson(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+describe('Config Structure Validation', () => {
+    describe('biome/preset.json', () => {
+        const configPath = path.join(srcDir, 'biome/preset.json');
+        const config = readJson(configPath);
+        it('has $schema defined', () => {
+            expect(config.$schema).toContain('biomejs.dev');
+        });
+        it('has linter enabled', () => {
+            expect(config.linter?.enabled).toBe(true);
+        });
+        it('has formatter enabled', () => {
+            expect(config.formatter?.enabled).toBe(true);
+        });
+        it('has recommended rules enabled', () => {
+            expect(config.linter?.rules?.recommended).toBe(true);
+        });
+        it('disallows explicit any', () => {
+            expect(config.linter?.rules?.suspicious?.noExplicitAny).toBe('error');
+        });
+    });
+    describe('typescript/base.json', () => {
+        const configPath = path.join(srcDir, 'typescript/base.json');
+        const config = readJson(configPath);
+        it('has $schema defined', () => {
+            expect(config.$schema).toContain('schemastore.org');
+        });
+        it('has strict mode enabled', () => {
+            expect(config.compilerOptions?.strict).toBe(true);
+        });
+        it('has noUncheckedIndexedAccess enabled', () => {
+            expect(config.compilerOptions?.noUncheckedIndexedAccess).toBe(true);
+        });
+        it('has strictNullChecks enabled', () => {
+            expect(config.compilerOptions?.strictNullChecks).toBe(true);
+        });
+        it('has noImplicitAny enabled', () => {
+            expect(config.compilerOptions?.noImplicitAny).toBe(true);
+        });
+        it('targets ES2022', () => {
+            expect(config.compilerOptions?.target).toBe('ES2022');
+        });
+        it('uses ESNext module', () => {
+            expect(config.compilerOptions?.module).toBe('ESNext');
+        });
+    });
+    describe('typescript/react.json', () => {
+        const configPath = path.join(srcDir, 'typescript/react.json');
+        const config = readJson(configPath);
+        it('extends base.json', () => {
+            expect(config.extends).toContain('./base.json');
+        });
+        it('has jsx set to react-jsx', () => {
+            expect(config.compilerOptions?.jsx).toBe('react-jsx');
+        });
+    });
+    describe('markdownlint/markdownlint.json', () => {
+        const configPath = path.join(srcDir, 'markdownlint/markdownlint.json');
+        const config = readJson(configPath);
+        it('is a valid JSON object', () => {
+            expect(typeof config).toBe('object');
+            expect(config).not.toBeNull();
+        });
+        it('has MD013 (line-length) rule configured', () => {
+            expect(config.MD013).toBeDefined();
+        });
+    });
+    describe('commitlint/commitlint.cjs', () => {
+        const configPath = path.join(srcDir, 'commitlint/commitlint.cjs');
+        it('file exists', () => {
+            expect(fs.existsSync(configPath)).toBe(true);
+        });
+        it('exports extends with conventional config', () => {
+            const content = fs.readFileSync(configPath, 'utf8');
+            expect(content).toContain('@commitlint/config-conventional');
+        });
+    });
+});
+describe('Vitest Configs', () => {
+    describe('vitest/node', () => {
+        it('exports vitestNodeConfig', async () => {
+            const { vitestNodeConfig } = await import('./vitest/node.js');
+            expect(vitestNodeConfig).toBeDefined();
+            expect(vitestNodeConfig.environment).toBe('node');
+        });
+    });
+    describe('vitest/react', () => {
+        it('exports vitestReactConfig', async () => {
+            const { vitestReactConfig } = await import('./vitest/react.js');
+            expect(vitestReactConfig).toBeDefined();
+            expect(vitestReactConfig.environment).toBe('jsdom');
+        });
+    });
+});

package/dist/playwright/index.d.ts

@@ -0,0 +1,10 @@
+import type { PlaywrightTestConfig } from '@playwright/test';
+export interface BuildPlaywrightBaseConfigParams {
+    appUrl: string;
+    appPort: number;
+    devices: typeof import('@playwright/test').devices;
+    ci?: boolean;
+    webServerCommand: string;
+}
+export declare function buildPlaywrightBaseConfig({ appUrl, appPort, devices, ci, webServerCommand, }: BuildPlaywrightBaseConfigParams): PlaywrightTestConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,kBAAkB,EAAE,OAAO,CAAC;IACnD,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,yBAAyB,CAAC,EACxC,MAAM,EACN,OAAO,EACP,OAAO,EACP,EAAqB,EACrB,gBAAgB,GACjB,EAAE,+BAA+B,GAAG,oBAAoB,CA0CxD"}

package/dist/playwright/index.js

@@ -0,0 +1,42 @@
+export function buildPlaywrightBaseConfig({ appUrl, appPort, devices, ci = !!process.env.CI, webServerCommand, }) {
+    if (!appUrl || typeof appUrl !== 'string') {
+        throw new Error('[playwright] appUrl must be a non-empty string');
+    }
+    if (!appPort || typeof appPort !== 'number') {
+        throw new Error('[playwright] appPort must be a number');
+    }
+    if (!devices) {
+        throw new Error('[playwright] devices must be provided from "@playwright/test"');
+    }
+    return {
+        forbidOnly: ci,
+        fullyParallel: true,
+        outputDir: './tests/test-results',
+        projects: [
+            { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+            { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
+            { name: 'webkit', use: { ...devices['Desktop Safari'] } },
+            {
+                name: 'iPad Pro 11 landscape',
+                use: { ...devices['iPad Pro 11 landscape'] },
+            },
+            { name: 'iPhone 14 portrait', use: { ...devices['iPhone 14'] } },
+            { name: 'Pixel 7 portrait', use: { ...devices['Pixel 7'] } },
+        ],
+        reporter: [['html', { open: 'never', outputFolder: './tests/playwright-report' }]],
+        retries: ci ? 2 : 0,
+        testDir: './tests',
+        testMatch: '**/*.e2e.ts',
+        use: {
+            baseURL: appUrl,
+            trace: 'on-first-retry',
+        },
+        webServer: {
+            command: webServerCommand,
+            ignoreHTTPSErrors: true,
+            reuseExistingServer: !ci,
+            url: appUrl,
+        },
+        ...(ci ? { workers: 1 } : {}),
+    };
+}

package/dist/playwright/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/playwright/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/playwright/index.test.ts"],"names":[],"mappings":""}

package/dist/playwright/index.test.js

@@ -0,0 +1,55 @@
+import { devices } from '@playwright/test';
+import { describe, expect, it } from 'vitest';
+import { buildPlaywrightBaseConfig } from './index.js';
+describe('buildPlaywrightBaseConfig', () => {
+    const validParams = {
+        appPort: 3000,
+        appUrl: 'http://localhost:3000',
+        devices,
+        webServerCommand: 'pnpm dev',
+    };
+    describe('validation', () => {
+        it('throws if appUrl is missing', () => {
+            expect(() => buildPlaywrightBaseConfig({ ...validParams, appUrl: '' })).toThrow('[playwright] appUrl must be a non-empty string');
+        });
+        it('throws if appPort is not a number', () => {
+            expect(() => buildPlaywrightBaseConfig({ ...validParams, appPort: '3000' })).toThrow('[playwright] appPort must be a number');
+        });
+        it('throws if devices is missing', () => {
+            expect(() => buildPlaywrightBaseConfig({
+                ...validParams,
+                devices: undefined,
+            })).toThrow('[playwright] devices must be provided');
+        });
+    });
+    describe('config output', () => {
+        it('returns valid Playwright config structure', () => {
+            const config = buildPlaywrightBaseConfig(validParams);
+            expect(config).toHaveProperty('projects');
+            expect(config).toHaveProperty('testDir', './tests');
+            expect(config).toHaveProperty('testMatch', '**/*.e2e.ts');
+            expect(config).toHaveProperty('webServer');
+            expect(config).toHaveProperty('use.baseURL', 'http://localhost:3000');
+        });
+        it('configures 6 browser projects', () => {
+            const config = buildPlaywrightBaseConfig(validParams);
+            expect(config.projects).toHaveLength(6);
+        });
+        it('sets retries to 0 when not in CI', () => {
+            const config = buildPlaywrightBaseConfig({ ...validParams, ci: false });
+            expect(config.retries).toBe(0);
+        });
+        it('sets retries to 2 in CI', () => {
+            const config = buildPlaywrightBaseConfig({ ...validParams, ci: true });
+            expect(config.retries).toBe(2);
+        });
+        it('sets workers to 1 in CI', () => {
+            const config = buildPlaywrightBaseConfig({ ...validParams, ci: true });
+            expect(config.workers).toBe(1);
+        });
+        it('sets forbidOnly to true in CI', () => {
+            const config = buildPlaywrightBaseConfig({ ...validParams, ci: true });
+            expect(config.forbidOnly).toBe(true);
+        });
+    });
+});

package/dist/testing/setup-react.d.ts

@@ -0,0 +1,2 @@
+import '@testing-library/jest-dom/vitest';
+//# sourceMappingURL=setup-react.d.ts.map

package/dist/testing/setup-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-react.d.ts","sourceRoot":"","sources":["../../src/testing/setup-react.ts"],"names":[],"mappings":"AAOA,OAAO,kCAAkC,CAAC"}

package/dist/testing/setup-react.js

@@ -0,0 +1 @@
+import '@testing-library/jest-dom/vitest';

package/dist/vitest/node.d.ts

@@ -0,0 +1,3 @@
+import type { TestUserConfig } from 'vitest/node';
+export declare const vitestNodeConfig: TestUserConfig;
+//# sourceMappingURL=node.d.ts.map

package/dist/vitest/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/vitest/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,eAAO,MAAM,gBAAgB,EAAE,cAK9B,CAAC"}

package/dist/vitest/node.js

@@ -0,0 +1,6 @@
+export const vitestNodeConfig = {
+    environment: 'node',
+    exclude: ['node_modules', 'dist', 'build', '.turbo', '.react-router'],
+    globals: true,
+    include: ['**/*.test.ts', '**/*.test.tsx'],
+};

package/dist/vitest/react.d.ts

@@ -0,0 +1,3 @@
+import type { TestUserConfig } from 'vitest/node';
+export declare const vitestReactConfig: TestUserConfig;
+//# sourceMappingURL=react.d.ts.map

package/dist/vitest/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/vitest/react.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,eAAO,MAAM,iBAAiB,EAAE,cAM/B,CAAC"}

package/dist/vitest/react.js

@@ -0,0 +1,7 @@
+export const vitestReactConfig = {
+    environment: 'jsdom',
+    exclude: ['node_modules', 'dist', 'build', '.turbo', '.react-router'],
+    globals: true,
+    include: ['**/*.test.ts', '**/*.test.tsx'],
+    setupFiles: ['./src/test-setup.ts'],
+};

package/package.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://www.schemastore.org/package.json",
+  "author": "Bernd Matzner <bernd.matzner@regard.io>",
+  "bin": {
+    "exec-clean": "./dist/bin/exec-clean.js",
+    "exec-husky": "./dist/bin/exec-husky.js",
+    "exec-p": "./dist/bin/exec-p.js",
+    "exec-s": "./dist/bin/exec-s.js",
+    "exec-ts": "./dist/bin/exec-ts.js",
+    "exec-tsc": "./dist/bin/exec-tsc.js",
+    "lint-biome": "./dist/bin/lint-biome.js",
+    "lint-commit": "./dist/bin/lint-commit.js",
+    "lint-md": "./dist/bin/lint-md.js"
+  },
+  "bugs": {
+    "url": "https://github.com/regardio/dev/issues"
+  },
+  "description": "Regardio developer tooling for testing, linting, and build workflows",
+  "devDependencies": {
+    "@biomejs/biome": "2.3.10",
+    "@changesets/changelog-github": "0.5.2",
+    "@changesets/cli": "2.29.8",
+    "@commitlint/cli": "20.2.0",
+    "@commitlint/config-conventional": "20.2.0",
+    "@playwright/test": "1.57.0",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "16.3.1",
+    "@total-typescript/ts-reset": "0.6.1",
+    "@types/node": "25.0.3",
+    "@vitest/ui": "4.0.16",
+    "husky": "9.1.7",
+    "jsdom": "27.3.0",
+    "markdownlint-cli2": "0.20.0",
+    "npm-run-all": "4.1.5",
+    "rimraf": "6.1.2",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vite": "7.3.0",
+    "vitest": "4.0.16"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./biome": "./src/biome/preset.json",
+    "./commitlint": "./src/commitlint/commitlint.cjs",
+    "./markdownlint": "./src/markdownlint/markdownlint.json",
+    "./playwright": {
+      "default": "./dist/playwright/index.js",
+      "types": "./dist/playwright/index.d.ts"
+    },
+    "./testing/setup-react": {
+      "default": "./dist/testing/setup-react.js",
+      "types": "./dist/testing/setup-react.d.ts"
+    },
+    "./typescript/base.json": "./src/typescript/base.json",
+    "./typescript/build.json": "./src/typescript/build.json",
+    "./typescript/react.json": "./src/typescript/react.json",
+    "./vitest/node": {
+      "default": "./dist/vitest/node.js",
+      "types": "./dist/vitest/node.d.ts"
+    },
+    "./vitest/react": {
+      "default": "./dist/vitest/react.js",
+      "types": "./dist/vitest/react.d.ts"
+    }
+  },
+  "files": ["dist", "src"],
+  "homepage": "https://github.com/regardio/dev/blob/main/README.md",
+  "keywords": ["dev", "tooling", "testing", "linting", "biome", "vitest", "playwright"],
+  "license": "MIT",
+  "name": "@regardio/dev",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "directory": "packages/dev",
+    "type": "git",
+    "url": "https://github.com/regardio/dev.git"
+  },
+  "scripts": {
+    "build": "pnpm exec tsc -p tsconfig.build.json",
+    "clean": "pnpm exec tsx src/bin/exec-clean.ts .turbo dist",
+    "fix": "exec-p fix:*",
+    "fix:biome": "biome check --write --unsafe .",
+    "fix:md": "markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdx\" \"!**/node_modules/**\" \"!**/dist/**\"",
+    "lint": "run-p lint:*",
+    "lint:biome": "biome check .",
+    "lint:md": "markdownlint-cli2 \"**/*.md\" \"**/*.mdx\" \"!**/node_modules/**\" \"!**/dist/**\"",
+    "prepare": "pnpm run build && husky",
+    "release": "pnpm changeset publish",
+    "test": "run-p test:*",
+    "test:unit": "vitest run",
+    "version": "pnpm changeset version"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "version": "0.9.0"
+}

package/src/bin/exec-clean.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * exec-clean: Thin wrapper around rimraf for cleaning paths.
+ * Usage: exec-clean <path> [morePaths...]
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+
+const require = createRequire(import.meta.url);
+const pkgPath = require.resolve('rimraf/package.json');
+const pkg = require(pkgPath);
+let binRel = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.rimraf;
+if (!binRel) {
+  console.error('Unable to locate rimraf binary from package.json bin field');
+  process.exit(1);
+}
+if (binRel.startsWith('./')) binRel = binRel.slice(2);
+// Build an absolute path to the bin file relative to the resolved package root
+const bin = path.join(path.dirname(pkgPath), binRel);
+
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));

package/src/bin/exec-husky.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * exec-husky: Initializes Husky git hooks (delegates to husky's bin).
+ * Usage: exec-husky
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const bin = require.resolve('husky');
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));

package/src/bin/exec-p.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * exec-p: Run npm scripts in parallel via npm-run-all's run-p.
+ * Usage: exec-p <script-patterns>
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const bin = require.resolve('npm-run-all/bin/run-p/index.js');
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));

package/src/bin/exec-s.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * exec-s: Run npm scripts sequentially via npm-run-all's run-s.
+ * Usage: exec-s <script-patterns>
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const bin = require.resolve('npm-run-all/bin/run-s/index.js');
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));

package/src/bin/exec-ts.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * exec-ts: Run a local TypeScript file via tsx with TS support.
+ * Usage: exec-ts path/to/script.ts [args...]
+ */
+import { type SpawnOptions, spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+
+const args = process.argv.slice(2);
+if (args.length === 0) {
+  console.error('Usage: exec-ts <script.ts> [args...]');
+  process.exit(1);
+}
+
+const [scriptArg, ...rest] = args;
+const script = scriptArg ?? '';
+
+// Delegate to tsx to run a local TypeScript file with full TypeScript support
+const require = createRequire(import.meta.url);
+const pkgPath = require.resolve('tsx/package.json');
+const pkg = require(pkgPath);
+const binRel = pkg.bin;
+const binPath: string | undefined =
+  typeof binRel === 'string'
+    ? binRel
+    : typeof binRel === 'object' && binRel !== null && 'tsx' in binRel
+      ? (binRel as Record<string, string>).tsx
+      : undefined;
+
+if (!binPath) {
+  console.error('Unable to locate tsx binary from package.json bin field');
+  process.exit(1);
+}
+// Build an absolute path to the bin file relative to the resolved package root
+const bin = path.join(path.dirname(pkgPath), binPath);
+const spawnOptions: SpawnOptions = { stdio: 'inherit' };
+const child = spawn(process.execPath, [bin, script, ...rest], spawnOptions);
+child.on('exit', (code: number | null) => process.exit(code ?? 0));

package/src/bin/exec-tsc.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * exec-tsc: Run the TypeScript compiler (tsc) via local dependency.
+ * Usage: exec-tsc [tsc args...]
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const bin = require.resolve('typescript/bin/tsc');
+const args = process.argv.slice(2);
+const child = spawn(process.execPath, [bin, ...args], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));