zeno-config 2.2.0 → 4.0.0

package/README.md

@@ -47,6 +47,26 @@ export default defineZenoConfig({
 });
 ```
 
+#### React Compiler
+
+If you're using or preparing to adopt [React Compiler](https://react.dev/learn/react-compiler), you can opt in to its ESLint rules:
+
+```javascript
+import { defineZenoConfig } from 'zeno-config/eslint';
+
+// Preparing a codebase — surface compiler violations as warnings
+export default defineZenoConfig({
+	react: true,
+	reactCompiler: 'warn',
+});
+
+// Full enforcement — compiler rules as errors
+export default defineZenoConfig({
+	react: true,
+	reactCompiler: true,
+});
+```
+
 #### `engines` field in `package.json`
 
 Add an `engines` field to your `package.json` with your supported Node.js versions. Some rules for Node.js use this:
@@ -70,7 +90,7 @@ export default defineZenoConfig(
 		ts: true,
 
 		// Additional directories to ignore (added to defaults: node_modules, dist, build, coverage)
-		ignoreDirs: ['out', '.next'],
+		ignores: ['out', '.next'],
 
 		// If using .js extensions for React files, specify React directories
 		reactDirs: ['src/client', 'src/components'],
@@ -166,6 +186,26 @@ Example:
 }
 ```
 
+### Gitignore
+
+Includes a shared `.gitignore` template with common patterns for your projects. Run the following command to add any missing patterns to your project's `.gitignore` (or create one if it doesn't exist):
+
+```bash
+npx zc-gitignore
+```
+
+The command only adds patterns that aren't already present. You can also add it as a setup script:
+
+```json
+{
+	"scripts": {
+		"setup:gitignore": "zc-gitignore"
+	}
+}
+```
+
+See [src/gitignore](src/gitignore) for the full list of included patterns.
+
 ### File Extensions Helpers
 
 Use in your build configs, webpack, etc:
@@ -194,18 +234,19 @@ import {
 
 ### `defineZenoConfig(options, additionalESLintConfig)`
 
-| Option                      | Type       | Default     | Description                                                                                   |
-| --------------------------- | ---------- | ----------- | --------------------------------------------------------------------------------------------- |
-| `react`                     | `boolean`  | `false`     | Enable React-specific rules                                                                   |
-| `ts`                        | `boolean`  | `false`     | Enable TypeScript-specific rules                                                              |
-| `performanceMode`           | `boolean`  | `false`     | Disables expensive rules for better performance                                               |
-| `ignoreDirs`                | `string[]` | `[]`        | Additional directories to ignore (added to defaults: node_modules, dist, build, coverage)     |
-| `reactDirs`                 | `string[]` | `[]`        | Directories containing React files (for projects using .js for both React and Node)           |
-| `nodeIgnoreDirs`            | `string[]` | `[]`        | Directories to ignore for Node-specific rules (defaults to `reactDirs` if not set)            |
-| `ignoreExports`             | `string[]` | `[]`        | Export patterns to ignore for import/no-unresolved rule                                       |
-| `additionalDevDependencies` | `string[]` | `[]`        | Additional file patterns to allow dev dependencies in (for import/no-extraneous-dependencies) |
-| `extensionsIgnorePattern`   | `object`   | `{}`        | Extension patterns to ignore for import/extensions rule                                       |
-| `webpackConfig`             | `string`   | `undefined` | Path to webpack config for import resolver                                                    |
+| Option                      | Type                    | Default     | Description                                                                                                           |
+| --------------------------- | ----------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------- |
+| `react`                     | `boolean`               | `false`     | Enable React-specific rules                                                                                           |
+| `reactCompiler`             | `boolean \| 'warn'`     | `false`     | Enable React Compiler rules. Set to `'warn'` to surface violations as warnings (for preparing a codebase), or `true` to enforce as errors |
+| `ts`                        | `boolean`               | `false`     | Enable TypeScript-specific rules                                                                                      |
+| `performanceMode`           | `boolean`               | `false`     | Disables expensive rules for better performance                                                                       |
+| `ignores`                   | `string[]`              | `[]`        | Additional directories to ignore (added to defaults: node_modules, dist, build, coverage)                             |
+| `reactDirs`                 | `string[]`              | `[]`        | Directories containing React files (for projects using .js for both React and Node)                                   |
+| `nodeIgnoreDirs`            | `string[]`              | `[]`        | Directories to ignore for Node-specific rules (defaults to `reactDirs` if not set)                                    |
+| `ignoreExports`             | `string[]`              | `[]`        | Export patterns to ignore for import/no-unresolved rule                                                               |
+| `additionalDevDependencies` | `string[]`              | `[]`        | Additional file patterns to allow dev dependencies in (for import/no-extraneous-dependencies)                         |
+| `extensionsIgnorePattern`   | `object`                | `{}`        | Extension patterns to ignore for import/extensions rule                                                               |
+| `webpackConfig`             | `string`                | `undefined` | Path to webpack config for import resolver                                                                            |
 
 ## Advanced Usage
 
@@ -270,7 +311,7 @@ See the TypeScript configuration files:
 - `eslint-plugin-n` - Node.js specific rules ([rules](src/eslint/rules/nodePluginRules.js))
 - `eslint-plugin-prettier` - Prettier integration
 - `eslint-plugin-react` (optional) - React specific rules ([rules](src/eslint/rules/reactPluginRules.js))
-- `eslint-plugin-react-hooks` (optional) - React Hooks rules ([rules](src/eslint/rules/reactHooksPluginRules.js))
+- `eslint-plugin-react-hooks` (optional) - React Hooks rules ([rules](src/eslint/rules/reactHooksPluginRules.js)) and React Compiler rules ([rules](src/eslint/rules/reactCompilerPluginRules.js))
 - `eslint-plugin-jsx-a11y` (optional) - Accessibility rules for JSX ([rules](src/eslint/rules/jsxA11yPluginRules.js))
 - `eslint-plugin-react-you-might-not-need-an-effect` (optional) - React Effect optimization ([rules](src/eslint/rules/reactYouMightNotNeedAnEffectPluginRules.js))
 - `typescript-eslint` (optional) - TypeScript rules ([rules](src/eslint/rules/typescriptPluginRules.js))

package/bin/gitignore.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+/* eslint-disable no-console */
+
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatePath = resolve(__dirname, '..', 'src', 'gitignore');
+const targetPath = resolve(process.cwd(), '.gitignore');
+
+const template = readFileSync(templatePath, 'utf8');
+
+if (!existsSync(targetPath)) {
+	writeFileSync(targetPath, template);
+	console.log('Created .gitignore');
+	process.exit(0);
+}
+
+function parseSections(content) {
+	const sections = [];
+	let current = null;
+
+	for (const line of content.split('\n')) {
+		if (line.startsWith('#')) {
+			if (current) {
+				sections.push(current);
+			}
+			current = { comments: [line], patterns: [] };
+		} else if (line.trim()) {
+			if (!current) {
+				current = { comments: [], patterns: [] };
+			}
+			current.patterns.push(line);
+		}
+	}
+
+	if (current) {
+		sections.push(current);
+	}
+	return sections;
+}
+
+const existing = readFileSync(targetPath, 'utf8');
+const existingPatterns = new Set(
+	existing
+		.split('\n')
+		.map((line) => line.trim())
+		.filter((line) => line && !line.startsWith('#'))
+);
+
+const templateSections = parseSections(template);
+const sectionsToAdd = [];
+
+for (const section of templateSections) {
+	const missing = section.patterns.filter((p) => !existingPatterns.has(p));
+	if (missing.length > 0) {
+		sectionsToAdd.push({ comments: section.comments, patterns: missing });
+	}
+}
+
+if (sectionsToAdd.length === 0) {
+	console.log('.gitignore is already up to date');
+	process.exit(0);
+}
+
+const lines = sectionsToAdd.flatMap((section) => [
+	'',
+	...section.comments,
+	...section.patterns,
+]);
+const updated = `${existing.trimEnd()}\n${lines.join('\n')}\n`;
+
+writeFileSync(targetPath, updated);
+
+const count = sectionsToAdd.reduce((sum, s) => sum + s.patterns.length, 0);
+for (const section of sectionsToAdd) {
+	console.log(section.comments.join('\n'));
+	for (const p of section.patterns) {
+		console.log(`  ${p}`);
+	}
+}
+console.log(`\nAdded ${count} pattern(s) to .gitignore`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zeno-config",
-  "version": "2.2.0",
+  "version": "4.0.0",
   "description": "Preconfigured and opinionated ESLint, Prettier, and TypeScript setup",
   "author": "Rick Brenn <brenn.rick@gmail.com>",
   "license": "MIT",
@@ -42,8 +42,12 @@
       "default": "./src/extensions.js"
     }
   },
+  "bin": {
+    "zc-gitignore": "./bin/gitignore.js"
+  },
   "files": [
-    "src/**"
+    "src/**",
+    "bin/**"
   ],
   "peerDependencies": {
     "eslint": "^9.39.2",
@@ -57,24 +61,24 @@
   },
   "devDependencies": {
     "eslint": "9.39.2",
-    "prettier": "3.8.0",
+    "prettier": "3.8.1",
     "typescript": "5.9.3"
   },
   "dependencies": {
     "@eslint/js": "9.39.2",
-    "@stylistic/eslint-plugin": "5.7.0",
+    "@stylistic/eslint-plugin": "5.10.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-import-resolver-webpack": "^0.13.10",
-    "eslint-plugin-import-x": "4.16.1",
+    "eslint-plugin-import-x": "4.16.2",
     "eslint-plugin-jsx-a11y": "6.10.2",
-    "eslint-plugin-n": "17.23.2",
+    "eslint-plugin-n": "17.24.0",
     "eslint-plugin-prettier": "5.5.5",
     "eslint-plugin-react": "7.37.5",
     "eslint-plugin-react-hooks": "7.0.1",
-    "eslint-plugin-react-you-might-not-need-an-effect": "0.8.5",
-    "eslint-plugin-unicorn": "62.0.0",
-    "globals": "17.0.0",
-    "typescript-eslint": "8.53.1"
+    "eslint-plugin-react-you-might-not-need-an-effect": "0.9.2",
+    "eslint-plugin-unicorn": "63.0.0",
+    "globals": "17.4.0",
+    "typescript-eslint": "8.57.1"
   },
   "scripts": {
     "inspect": "eslint --inspect-config",

package/src/eslint/index.d.ts

@@ -23,6 +23,8 @@ interface ReactConfigOptions {
 	reactDirs?: string[];
 	/** Extension patterns to ignore for import rules */
 	extensionsIgnorePattern?: Record<string, string>;
+	/** Enable React Compiler rules. Set to 'warn' for warnings or true for errors. */
+	reactCompiler?: boolean | 'warn';
 }
 
 interface TypescriptConfigOptions {
@@ -33,12 +35,14 @@ interface TypescriptConfigOptions {
 interface DefineZenoConfigOptions {
 	/** Enable React-specific rules */
 	react?: boolean;
+	/** Enable React Compiler rules. Set to 'warn' for warnings or true for errors. */
+	reactCompiler?: boolean | 'warn';
 	/** Enable TypeScript-specific rules */
 	ts?: boolean;
 	/** Disables expensive rules for performance */
 	performanceMode?: boolean;
 	/** Additional directories to ignore (added to defaults: dist, build) */
-	ignoreDirs?: string[];
+	ignores?: string[];
 	/** Directories containing React files (for projects using .js for both React and Node) */
 	reactDirs?: string[];
 	/** Directories to ignore for Node-specific rules only */
@@ -90,6 +94,9 @@ interface Rules {
 		extensions?: string[];
 	}) => Linter.RulesRecord;
 	getReactHooksPluginRules: () => Linter.RulesRecord;
+	getReactCompilerPluginRules: (
+		mode?: boolean | 'warn'
+	) => Linter.RulesRecord;
 	getReactYouMightNotNeedAnEffectPluginRules: () => Linter.RulesRecord;
 	getJsxA11yPluginRules: () => Linter.RulesRecord;
 }

package/src/eslint/index.js

@@ -15,6 +15,7 @@ import getBaseRules from './rules/baseRules.js';
 import getImportPluginRules from './rules/importPluginRules.js';
 import getReactPluginRules from './rules/reactPluginRules.js';
 import getReactHooksPluginRules from './rules/reactHooksPluginRules.js';
+import getReactCompilerPluginRules from './rules/reactCompilerPluginRules.js';
 import getStylisticPluginRules from './rules/stylisticPluginRules.js';
 import getNodePluginRules from './rules/nodePluginRules.js';
 import getReactYouMightNotNeedAnEffectPluginRules from './rules/reactYouMightNotNeedAnEffectPluginRules.js';
@@ -142,6 +143,7 @@ const nodeConfig = (options = {}) => {
  * @param {Object} [options={}] - Configuration options.
  * @param {string[]} [options.reactDirs] - Directories containing React files (for projects using .js for both React and Node).
  * @param {Object} [options.extensionsIgnorePattern] - Extension patterns to ignore for import rules.
+ * @param {boolean|string} [options.reactCompiler=false] - Enable React Compiler rules. Set to 'warn' for warnings or true for errors.
  * @returns {Array} ESLint flat config array.
  */
 const reactConfig = (options = {}) => {
@@ -181,6 +183,9 @@ const reactConfig = (options = {}) => {
 			rules: {
 				...getReactPluginRules({ extensions }),
 				...getReactHooksPluginRules(),
+				...(options.reactCompiler
+					? getReactCompilerPluginRules(options.reactCompiler)
+					: {}),
 				...getReactYouMightNotNeedAnEffectPluginRules(),
 				...getJsxA11yPluginRules(),
 
@@ -296,6 +301,7 @@ const internals = {
 		getUnicornPluginRules,
 		getReactPluginRules,
 		getReactHooksPluginRules,
+		getReactCompilerPluginRules,
 		getReactYouMightNotNeedAnEffectPluginRules,
 		getJsxA11yPluginRules,
 	},
@@ -306,9 +312,10 @@ const internals = {
  *
  * @param {Object|Array} arg1 - Options object or additional config array. If an array, treated as additional config.
  * @param {boolean} [arg1.react=false] - Enable React-specific rules.
+ * @param {boolean|string} [arg1.reactCompiler=false] - Enable React Compiler rules. Set to 'warn' for warnings or true for errors.
  * @param {boolean} [arg1.ts=true] - Enable TypeScript-specific rules.
  * @param {boolean} [arg1.performanceMode=false] - Disables expensive rules for performance.
- * @param {string[]} [arg1.ignoreDirs=[]] - Additional directories to ignore (added to defaults: dist, build).
+ * @param {string[]} [arg1.ignores=[]] - Additional directories to ignore (added to defaults: dist, build).
  * @param {string[]} [arg1.reactDirs=[]] - Directories containing React files (for projects using .js for both React and Node).
  * @param {string[]} [arg1.nodeIgnoreDirs=[]] - Directories to ignore for Node-specific rules only.
  * @param {string[]} [arg1.ignoreExports=[]] - Export patterns to ignore for import rules.
@@ -333,11 +340,12 @@ const internals = {
 const defineZenoConfig = (arg1, arg2) => {
 	let options = {
 		react: false,
+		reactCompiler: false,
 		ts: false,
 		performanceMode: false,
 
 		// additional directories to ignore (added to defaults: dist, build)
-		ignoreDirs: [],
+		ignores: [],
 
 		// if a project uses .js file extension for both react and node files this will help separate the rules for each
 		reactDirs: [],
@@ -358,8 +366,8 @@ const defineZenoConfig = (arg1, arg2) => {
 	}
 
 	// Ensure array options are arrays
-	if (!Array.isArray(options.ignoreDirs)) {
-		options.ignoreDirs = [];
+	if (!Array.isArray(options.ignores)) {
+		options.ignores = [];
 	}
 	if (!Array.isArray(options.reactDirs)) {
 		options.reactDirs = [];
@@ -394,6 +402,7 @@ const defineZenoConfig = (arg1, arg2) => {
 		? configs.getReact({
 				reactDirs: options.reactDirs,
 				extensionsIgnorePattern: options.extensionsIgnorePattern,
+				reactCompiler: options.reactCompiler,
 			})
 		: [];
 	const tsConfigResult = options.ts
@@ -401,7 +410,7 @@ const defineZenoConfig = (arg1, arg2) => {
 		: [];
 
 	return defineConfig([
-		{ ignores: [...defaultIgnoreDirs, ...options.ignoreDirs] },
+		{ ignores: [...defaultIgnoreDirs, ...options.ignores] },
 		...configs.getBase({
 			ignoreExports: options.ignoreExports,
 			additionalDevDependencies: options.additionalDevDependencies,

package/src/eslint/rules/baseRules.js

@@ -190,7 +190,7 @@ const getBaseRules = () => {
 		],
 
 		// https://eslint.org/docs/latest/rules/no-useless-assignment
-		'no-useless-assignment': 'error',
+		'no-useless-assignment': 'off',
 
 		// https://eslint.org/docs/latest/rules/no-useless-backreference
 		'no-useless-backreference': 'error',
@@ -395,7 +395,7 @@ const getBaseRules = () => {
 
 		// https://eslint.org/docs/latest/rules/no-implicit-coercion
 		'no-implicit-coercion': [
-			'error',
+			'off',
 			{
 				boolean: true,
 				number: true,
@@ -488,7 +488,7 @@ const getBaseRules = () => {
 		],
 
 		// https://eslint.org/docs/latest/rules/no-plusplus
-		'no-plusplus': ['error', { allowForLoopAfterthoughts: true }],
+		'no-plusplus': ['off', { allowForLoopAfterthoughts: true }],
 
 		// https://eslint.org/docs/latest/rules/no-proto
 		'no-proto': 'error',

package/src/eslint/rules/nodePluginRules.js

@@ -96,6 +96,9 @@ const getNodePluginRules = () => {
 		// https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/console.md
 		'n/prefer-global/console': 'error',
 
+		// https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/crypto.md
+		'n/prefer-global/crypto': 'error',
+
 		// https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/process.md
 		'n/prefer-global/process': 'error',
 
@@ -105,6 +108,9 @@ const getNodePluginRules = () => {
 		// https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/text-encoder.md
 		'n/prefer-global/text-encoder': 'error',
 
+		// https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/timers.md
+		'n/prefer-global/timers': 'error',
+
 		// https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/url.md
 		'n/prefer-global/url': 'error',
 

package/src/eslint/rules/reactCompilerPluginRules.js

@@ -0,0 +1,24 @@
+const getReactCompilerPluginRules = (mode) => {
+	const level = mode === 'warn' ? 'warn' : 'error';
+
+	return {
+		// https://github.com/facebook/react/tree/main/packages/eslint-plugin-react-hooks
+		'react-hooks/config': level,
+		'react-hooks/error-boundaries': level,
+		'react-hooks/component-hook-factories': level,
+		'react-hooks/gating': level,
+		'react-hooks/globals': level,
+		'react-hooks/immutability': level,
+		'react-hooks/preserve-manual-memoization': level,
+		'react-hooks/purity': level,
+		'react-hooks/refs': level,
+		'react-hooks/set-state-in-effect': 'warn',
+		'react-hooks/set-state-in-render': level,
+		'react-hooks/static-components': level,
+		'react-hooks/unsupported-syntax': 'warn',
+		'react-hooks/use-memo': level,
+		'react-hooks/incompatible-library': 'warn',
+	};
+};
+
+export default getReactCompilerPluginRules;

package/src/eslint/rules/reactHooksPluginRules.js

@@ -1,26 +1,8 @@
 const getReactHooksPluginRules = () => {
 	return {
 		// https://github.com/facebook/react/tree/main/packages/eslint-plugin-react-hooks
-		// Core hooks rules
 		'react-hooks/rules-of-hooks': 'error',
 		'react-hooks/exhaustive-deps': 'error',
-
-		// React Compiler rules
-		'react-hooks/config': 'error',
-		'react-hooks/error-boundaries': 'error',
-		'react-hooks/component-hook-factories': 'error',
-		'react-hooks/gating': 'error',
-		'react-hooks/globals': 'error',
-		'react-hooks/immutability': 'error',
-		'react-hooks/preserve-manual-memoization': 'error',
-		'react-hooks/purity': 'error',
-		'react-hooks/refs': 'error',
-		'react-hooks/set-state-in-effect': 'warn',
-		'react-hooks/set-state-in-render': 'error',
-		'react-hooks/static-components': 'error',
-		'react-hooks/unsupported-syntax': 'warn',
-		'react-hooks/use-memo': 'error',
-		'react-hooks/incompatible-library': 'warn',
 	};
 };
 

package/src/eslint/rules/reactYouMightNotNeedAnEffectPluginRules.js

@@ -10,7 +10,6 @@ const getReactYouMightNotNeedAnEffectPluginRules = () => {
 		'react-you-might-not-need-an-effect/no-pass-live-state-to-parent':
 			'warn',
 		'react-you-might-not-need-an-effect/no-pass-data-to-parent': 'warn',
-		'react-you-might-not-need-an-effect/no-pass-ref-to-parent': 'warn',
 		'react-you-might-not-need-an-effect/no-initialize-state': 'warn',
 		'react-you-might-not-need-an-effect/no-chain-state-updates': 'warn',
 		'react-you-might-not-need-an-effect/no-derived-state': 'warn',

package/src/eslint/rules/typescriptPluginRules.js

@@ -505,6 +505,10 @@ const getTypescriptPluginRules = () => {
 		// requires type information
 		'@typescript-eslint/strict-boolean-expressions': 'off',
 
+		// https://typescript-eslint.io/rules/strict-void-return
+		// requires type information
+		'@typescript-eslint/strict-void-return': 'off',
+
 		// https://typescript-eslint.io/rules/switch-exhaustiveness-check
 		// requires type information
 		'@typescript-eslint/switch-exhaustiveness-check': 'off',

package/src/eslint/rules/unicornPluginRules.js

@@ -56,9 +56,8 @@ const getUnicornPluginRules = () => {
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/import-style.md
 		'unicorn/import-style': 'off',
 
-		// TODO: new rule, enable once released
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/isolated-functions.md
-		// 'unicorn/isolated-functions': 'error',
+		'unicorn/isolated-functions': 'error',
 
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/new-for-builtins.md
 		'unicorn/new-for-builtins': 'error',
@@ -347,7 +346,7 @@ const getUnicornPluginRules = () => {
 		'unicorn/prefer-prototype-methods': 'error',
 
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-query-selector.md
-		'unicorn/prefer-query-selector': 'warn',
+		'unicorn/prefer-query-selector': 'off',
 
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-reflect-apply.md
 		'unicorn/prefer-reflect-apply': 'warn',
@@ -386,7 +385,7 @@ const getUnicornPluginRules = () => {
 		'unicorn/prefer-string-trim-start-end': 'warn',
 
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-structured-clone.md
-		'unicorn/prefer-structured-clone': 'error',
+		'unicorn/prefer-structured-clone': 'off',
 
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-switch.md
 		'unicorn/prefer-switch': 'off',
@@ -395,7 +394,7 @@ const getUnicornPluginRules = () => {
 		'unicorn/prefer-ternary': 'off',
 
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-top-level-await.md
-		'unicorn/prefer-top-level-await': 'error',
+		'unicorn/prefer-top-level-await': 'off',
 
 		// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-type-error.md
 		'unicorn/prefer-type-error': 'warn',

package/src/gitignore

@@ -0,0 +1,60 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Coverage directory
+coverage
+
+# Dependency directories
+node_modules
+
+# Build output
+dist
+build
+
+# Environment variables
+.env
+.env.*
+!.env.example
+
+# pnpm
+.pnpm-store
+
+# npm
+npm-debug.log*
+
+# OS files
+.DS_Store
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Output of 'npm pack'
+*.tgz
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# temp lerna install file
+*.lerna_backup
+
+# storybook
+storybook-static

package/src/tsconfig.base.json

@@ -2,30 +2,30 @@
 	"$schema": "https://json.schemastore.org/tsconfig",
 	"compilerOptions": {
 		/* Language and Environment */
-		"target": "ES2022", // output code
-		"lib": ["ES2022"], // input code - Node.js ES support
+		"target": "ES2023",
+		"lib": ["ES2023"],
 
 		/* Modules */
 		"module": "NodeNext", // Node.js native ESM
 		"moduleResolution": "NodeNext", // Node.js native ESM resolution
-		"resolveJsonModule": true,
+		"moduleDetection": "force", // treat all files as modules
+		"verbatimModuleSyntax": true, // enforce explicit import type syntax and matching module syntax
 
 		/* Emit */
-		"outDir": "./dist",
 		"noEmit": true, // using external tools for compilation
 		"incremental": true, // cache type checking results
+		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
 
-		/* Interop Constraints */
-		"esModuleInterop": true, // CommonJS/ESM interop
-		"allowSyntheticDefaultImports": true, // allows default imports from modules with no default export
-		"isolatedModules": true, // ensures each file can be independently transpiled
+		/* Transpiler Compatibility */
+		"erasableSyntaxOnly": true, // disallow const enum, namespace, etc. for type-stripping tool compat
 
 		/* Type Checking */
-		"strict": true, // includes several rules it enables
+		"strict": true,
 		"noUnusedLocals": false, // using @typescript-eslint/no-unused-vars instead
 		"noUnusedParameters": false, // using @typescript-eslint/no-unused-vars instead
-		"noFallthroughCasesInSwitch": true,
-		"skipLibCheck": true, // skip dependency type checking (standard to set as true)
-		"noUncheckedIndexedAccess": true
+		"noFallthroughCasesInSwitch": false, // using eslint no-fallthrough instead
+		"noUncheckedIndexedAccess": true, // force handling undefined on index access
+		"noUncheckedSideEffectImports": true, // validate side-effect imports resolve
+		"skipLibCheck": true // skip type checking of declaration files
 	}
 }

package/src/tsconfig.react.json

@@ -3,11 +3,15 @@
 	"extends": "./tsconfig.base.json",
 	"compilerOptions": {
 		/* Language and Environment */
-		"lib": ["ES2022", "DOM", "DOM.Iterable"], // browser APIs
-		"jsx": "react-jsx", // React 17+ jsx transform (automatic runtime / no React import)
+		"lib": ["ES2023", "DOM", "DOM.Iterable"], // browser APIs
+		"jsx": "react-jsx", // React 17+ automatic jsx transform
 
 		/* Modules */
-		"module": "ESNext", // needed since webpack/babel is handling compilation
-		"moduleResolution": "bundler" // needed since webpack/babel is handling compilation
+		"module": "ESNext", // bundler handles module compilation
+		"moduleResolution": "bundler", // bundler-style resolution
+		"allowImportingTsExtensions": true, // allow .ts/.tsx imports (bundler resolves them)
+
+		/* Emit */
+		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.react.tsbuildinfo"
 	}
 }