@rtorcato/js-tooling 2.6.0 → 2.8.0

package/README.md

@@ -1,5 +1,9 @@
+![js-tooling banner](./banner.png)
+
 # js-tooling
 
+![js-common banner](./banner.jpeg)
+
 JavaScript and TypeScript tooling for Node.js, React, Next.js, and Vitest.
 
 [![CI](https://github.com/rtorcato/js-tooling/actions/workflows/ci.yml/badge.svg)](https://github.com/rtorcato/js-tooling/actions/workflows/ci.yml)

package/dist/cli/commands/doctor.js

@@ -297,6 +297,36 @@ async function checkKnip(dir, pkg) {
         hint: 'Add `knip` to detect unused files, deps, and exports',
     };
 }
+const SIZE_LIMIT_FILES = [
+    '.size-limit.json',
+    '.size-limit.js',
+    '.size-limit.cjs',
+    '.size-limit.mjs',
+    '.size-limit.ts',
+];
+async function checkSizeLimit(dir, pkg) {
+    const inPkg = pkg ? 'size-limit' in pkg : false;
+    let inFile = null;
+    for (const candidate of SIZE_LIMIT_FILES) {
+        if (await fs.pathExists(path.join(dir, candidate))) {
+            inFile = candidate;
+            break;
+        }
+    }
+    if (inPkg || inFile) {
+        return {
+            check: 'size-limit',
+            status: 'ok',
+            detail: inPkg ? '`size-limit` field in package.json' : `${inFile} found`,
+        };
+    }
+    return {
+        check: 'size-limit',
+        status: 'optional-missing',
+        detail: 'size-limit not configured',
+        hint: 'Add `size-limit` to enforce bundle-size budgets in CI for library projects',
+    };
+}
 const SEMANTIC_RELEASE_FILES = [
     '.releaserc',
     '.releaserc.json',
@@ -488,6 +518,7 @@ export async function runDoctor(dir) {
     results.push(await checkLintStaged(targetDir, pkg));
     results.push(await checkSemanticRelease(targetDir, pkg));
     results.push(await checkKnip(targetDir, pkg));
+    results.push(await checkSizeLimit(targetDir, pkg));
     results.push(await checkGitHubActions(targetDir));
     results.push(await checkDependabot(targetDir));
     results.push(await checkCodeQL(targetDir));

package/dist/cli/commands/fix-targets.js

@@ -13,6 +13,7 @@ export const FIX_TARGETS = {
     'lint-staged': 'husky',
     'semantic-release': 'semantic-release',
     knip: 'knip',
+    'size-limit': 'size-limit',
     'GitHub Actions': 'github-actions',
     Dependabot: 'dependabot',
     CodeQL: 'codeql',

package/dist/cli/commands/fix.js

@@ -6,7 +6,7 @@ import { generateSemanticReleaseConfig } from '../generators/build.js';
 import { generateCommitlintConfig, generateHuskyConfig } from '../generators/git.js';
 import { generateGitHubActions } from '../generators/github-actions.js';
 import { generateESLintConfig, generatePrettierConfig } from '../generators/linting.js';
-import { ensureEnginesNode, generateEditorConfig, generateKnipConfig, generateNvmrc, } from '../generators/misc.js';
+import { ensureEnginesNode, generateEditorConfig, generateKnipConfig, generateNvmrc, generateSizeLimitConfig, } from '../generators/misc.js';
 import { generateCodeQLWorkflow, generateDependabotConfig } from '../generators/security.js';
 import { generateVitestConfig } from '../generators/testing.js';
 import { copyPreset } from '../utils/copy-preset.js';
@@ -231,6 +231,17 @@ const FIXERS = [
             return { filesWritten: ['knip.json'] };
         },
     },
+    {
+        target: 'size-limit',
+        description: 'Scaffold .size-limit.json with a default 10 kB budget (customize per-subpath for libraries)',
+        appliesTo: ['size-limit'],
+        outputs: ['.size-limit.json'],
+        canFixDrift: true,
+        async run({ targetDir }) {
+            await generateSizeLimitConfig(targetDir);
+            return { filesWritten: ['.size-limit.json'] };
+        },
+    },
     {
         target: 'package-json',
         description: 'Add @rtorcato/js-tooling to devDependencies',

package/dist/cli/generators/misc.js

@@ -23,6 +23,13 @@ const KNIP_CONFIG = {
     entry: ['src/index.ts'],
     project: ['src/**/*.ts'],
 };
+const SIZE_LIMIT_CONFIG = [
+    {
+        name: 'package (default entry)',
+        path: 'dist/index.js',
+        limit: '10 kB',
+    },
+];
 export async function generateEditorConfig(targetDir) {
     await fs.writeFile(path.join(targetDir, '.editorconfig'), EDITORCONFIG_CONTENT);
 }
@@ -44,6 +51,9 @@ export async function ensureEnginesNode(targetDir, version = '>=22') {
 export async function generateKnipConfig(targetDir) {
     await fs.writeJson(path.join(targetDir, 'knip.json'), KNIP_CONFIG, { spaces: 2 });
 }
+export async function generateSizeLimitConfig(targetDir) {
+    await fs.writeJson(path.join(targetDir, '.size-limit.json'), SIZE_LIMIT_CONFIG, { spaces: 2 });
+}
 export async function generateMiscBaseline(targetDir) {
     await generateEditorConfig(targetDir);
     await generateNvmrc(targetDir);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rtorcato/js-tooling",
-	"version": "2.6.0",
+	"version": "2.8.0",
 	"description": "JavaScript and TypeScript tooling for Node.js, React, Next.js, and Vitest.",
 	"type": "module",
 	"keywords": [
@@ -61,6 +61,8 @@
 		"tooling/vitest/vitest.config.react.d.mts",
 		"tooling/vitest/vitest.setup.mjs",
 		"tooling/vitest/vitest.setup.d.mts",
+		"tooling/vitest/jsdom-shims.mjs",
+		"tooling/vitest/jsdom-shims.d.mts",
 		"tooling/tsup/index.ts",
 		"tooling/biome/biome.json",
 		"tooling/semantic-release/*.mjs",
@@ -123,6 +125,10 @@
 			"types": "./tooling/vitest/vitest.setup.d.mts",
 			"import": "./tooling/vitest/vitest.setup.mjs"
 		},
+		"./vitest/jsdom-shims": {
+			"types": "./tooling/vitest/jsdom-shims.d.mts",
+			"import": "./tooling/vitest/jsdom-shims.mjs"
+		},
 		"./tsup": "./tooling/tsup/index.ts",
 		"./biome": "./tooling/biome/biome.json",
 		"./semantic-release": {
@@ -142,24 +148,24 @@
 		"chalk": "^5.6.2",
 		"commander": "^14.0.3",
 		"fs-extra": "^11.3.2",
-		"inquirer": "^14.0.0"
+		"inquirer": "^14.0.2"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.3.0",
+		"@biomejs/biome": "^2.4.16",
+		"@commitlint/cli": "^20.1.0",
+		"@commitlint/config-conventional": "^21.0.2",
 		"@commitlint/types": "^20.0.0",
 		"@eslint/js": "^9.38.0",
 		"@ianvs/prettier-plugin-sort-imports": "^4.4.2",
-		"@commitlint/cli": "^20.1.0",
-		"@commitlint/config-conventional": "^21.0.1",
-		"@next/eslint-plugin-next": "^16.0.0",
+		"@next/eslint-plugin-next": "^16.2.7",
 		"@playwright/test": "^1.56.1",
 		"@semantic-release/changelog": "^6.0.3",
 		"@semantic-release/commit-analyzer": "^13.0.1",
 		"@semantic-release/exec": "^7.1.0",
 		"@semantic-release/git": "^10.0.1",
-		"@semantic-release/github": "^12.0.0",
-		"@semantic-release/npm": "^13.1.1",
-		"@semantic-release/release-notes-generator": "^14.1.0",
+		"@semantic-release/github": "^12.0.8",
+		"@semantic-release/npm": "^13.1.5",
+		"@semantic-release/release-notes-generator": "^14.1.1",
 		"@total-typescript/ts-reset": "0.6.1",
 		"@types/fs-extra": "^11.0.4",
 		"@types/node": "^25.9.1",
@@ -175,33 +181,34 @@
 		"eslint": "9.38.0",
 		"eslint-plugin-import": "^2.32.0",
 		"eslint-plugin-jest": "29.0.1",
-		"jest": "^29.7.0",
 		"husky": "^9.1.7",
 		"is-ci": "^4.1.0",
+		"jest": "^29.7.0",
+		"jsdom": "^26.1.0",
+		"knip": "^5.61.3",
 		"lint-staged": "^16.2.6",
-		"prettier": "^3.6.2",
-		"rimraf": "6.0.1",
-		"semantic-release": "^25.0.1",
-		"ts-jest": "^29.4.5",
+		"prettier": "^3.8.3",
+		"rimraf": "6.1.3",
+		"semantic-release": "^25.0.3",
+		"ts-jest": "^29.4.11",
 		"tsup": "8.5.1",
 		"typescript": "^5.9.3",
 		"typescript-eslint": "^8.60.0",
-		"vitest": "4.0.3",
-		"knip": "^5.61.3"
+		"vitest": "4.0.3"
 	},
 	"peerDependencies": {
 		"@biomejs/biome": "^2.0.0",
 		"@commitlint/cli": "^20.0.0",
-		"@commitlint/config-conventional": "^21.0.1",
+		"@commitlint/config-conventional": "^21.0.2",
 		"@commitlint/types": "^20.0.0",
 		"@eslint/js": "^9.0.0",
 		"@ianvs/prettier-plugin-sort-imports": "^4.0.0",
-		"@next/eslint-plugin-next": "^16.0.0",
+		"@next/eslint-plugin-next": "^16.2.7",
 		"@semantic-release/changelog": "^6.0.0",
 		"@semantic-release/commit-analyzer": "^13.0.0",
 		"@semantic-release/exec": "^7.0.0",
 		"@semantic-release/git": "^10.0.0",
-		"@semantic-release/github": "^12.0.0",
+		"@semantic-release/github": "^12.0.8",
 		"@semantic-release/npm": "^13.0.0",
 		"@semantic-release/release-notes-generator": "^14.0.0",
 		"@total-typescript/ts-reset": "^0.6.0",
@@ -216,6 +223,8 @@
 		"jest": "^29.0.0",
 		"prettier": "^3.0.0",
 		"semantic-release": "^25.0.0",
+		"size-limit": "^12.0.0",
+		"@size-limit/preset-small-lib": "^12.0.0",
 		"ts-jest": "^29.0.0",
 		"tsup": "^8.0.0",
 		"typescript": ">=5.0.0",
@@ -301,6 +310,12 @@
 		"semantic-release": {
 			"optional": true
 		},
+		"size-limit": {
+			"optional": true
+		},
+		"@size-limit/preset-small-lib": {
+			"optional": true
+		},
 		"ts-jest": {
 			"optional": true
 		},

package/tooling/vitest/jsdom-shims.d.mts

@@ -0,0 +1 @@
+export {}

package/tooling/vitest/jsdom-shims.mjs

@@ -0,0 +1,58 @@
+// jsdom doesn't ship the browser APIs that Radix UI, cmdk, embla-carousel,
+// react-day-picker and friends call at mount time. Import this file from your
+// vitest setupFiles to install no-op polyfills for all of them:
+//
+//   // vitest.config.ts -> test.setupFiles
+//   import '@rtorcato/js-tooling/vitest/jsdom-shims'
+//
+// Side-effect only; nothing is exported.
+
+if (typeof Element !== 'undefined') {
+	if (!Element.prototype.hasPointerCapture) {
+		Element.prototype.hasPointerCapture = () => false
+	}
+	if (!Element.prototype.setPointerCapture) {
+		Element.prototype.setPointerCapture = () => {}
+	}
+	if (!Element.prototype.releasePointerCapture) {
+		Element.prototype.releasePointerCapture = () => {}
+	}
+	if (!Element.prototype.scrollIntoView) {
+		Element.prototype.scrollIntoView = () => {}
+	}
+}
+
+if (typeof globalThis.ResizeObserver === 'undefined') {
+	globalThis.ResizeObserver = class ResizeObserver {
+		observe() {}
+		unobserve() {}
+		disconnect() {}
+	}
+}
+
+if (typeof globalThis.IntersectionObserver === 'undefined') {
+	globalThis.IntersectionObserver = class IntersectionObserver {
+		observe() {}
+		unobserve() {}
+		disconnect() {}
+		takeRecords() {
+			return []
+		}
+		root = null
+		rootMargin = ''
+		thresholds = []
+	}
+}
+
+if (typeof window !== 'undefined' && typeof window.matchMedia === 'undefined') {
+	window.matchMedia = (query) => ({
+		matches: false,
+		media: query,
+		onchange: null,
+		addListener: () => {},
+		removeListener: () => {},
+		addEventListener: () => {},
+		removeEventListener: () => {},
+		dispatchEvent: () => false,
+	})
+}