@lazyconfig/presets 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ruben-omh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,367 @@
+# @lazyconfig/presets
+
+[![npm](https://img.shields.io/npm/v/@lazyconfig/presets?style=flat-square&logo=npm&logoColor=white&color=FFCA28)](https://www.npmjs.com/package/@lazyconfig/presets)
+[![Downloads](https://img.shields.io/npm/dm/@lazyconfig/presets?style=flat-square&logo=npm&logoColor=white&label=downloads&color=8957E5)](https://www.npmjs.com/package/@lazyconfig/presets)
+[![License](https://img.shields.io/npm/l/@lazyconfig/presets?style=flat-square&color=blue)](LICENSE)
+[![Sponsor](https://img.shields.io/github/sponsors/ruben-omh?style=flat-square&logo=githubsponsors&logoColor=white&color=EA4AAA&label=Sponsor)](https://github.com/sponsors/ruben-omh)
+
+Single-install meta-package that bundles the full lazyconfig toolchain. Install once and get TypeScript, ESLint, Jest, Rollup, Prettier, Commitlint, and API Extractor configurations — all pre-configured and ready to use.
+
+All presets are re-exported through `@lazyconfig/presets/*` subpath exports, so you only need this one package installed.
+
+---
+
+## Installation
+
+```sh
+# pnpm
+pnpm add -D @lazyconfig/presets
+
+# npm
+npm install --save-dev @lazyconfig/presets
+
+# yarn
+yarn add --dev @lazyconfig/presets
+
+# bun
+bun add --dev @lazyconfig/presets
+```
+
+---
+
+## Included presets
+
+| Subpath export                                                         | Description                 |
+| ---------------------------------------------------------------------- | --------------------------- |
+| [`@lazyconfig/presets/tsconfig/*`](#lazyconfigpresetstsconfig)         | TypeScript compiler presets |
+| [`@lazyconfig/presets/eslint`](#lazyconfigpresetseslint)               | ESLint flat config factory  |
+| [`@lazyconfig/presets/jest`](#lazyconfigpresetsjest)                   | Jest config factory         |
+| [`@lazyconfig/presets/rollup`](#lazyconfigpresetsrollup)               | Rollup config factory       |
+| [`@lazyconfig/presets/prettier`](#lazyconfigpresetsprettier)           | Prettier preset             |
+| [`@lazyconfig/presets/commitlint`](#lazyconfigpresetscommitlint)       | Commitlint config           |
+| [`@lazyconfig/presets/api-extractor`](#lazyconfigpresetsapi-extractor) | API Extractor base config   |
+
+---
+
+## `@lazyconfig/presets/tsconfig/*`
+
+Reusable TypeScript compiler presets. Extend the preset that matches your project type.
+
+### Requirements
+
+No peer dependencies.
+
+| Tool         | Version | Notes                              |
+| ------------ | ------- | ---------------------------------- |
+| `typescript` | `>=5.0` | Must be installed in your project  |
+| Node.js      | `>=18`  | Required by the `node` preset only |
+
+### Presets
+
+| Preset  | Path                                 | Use case                           |
+| ------- | ------------------------------------ | ---------------------------------- |
+| `base`  | `@lazyconfig/presets/tsconfig/base`  | Foundation for all other presets   |
+| `node`  | `@lazyconfig/presets/tsconfig/node`  | Node.js applications and CLI tools |
+| `lib`   | `@lazyconfig/presets/tsconfig/lib`   | Framework-agnostic libraries       |
+| `react` | `@lazyconfig/presets/tsconfig/react` | React applications                 |
+
+### Usage
+
+```json
+// tsconfig.json — Node.js application
+{
+	"extends": "@lazyconfig/presets/tsconfig/node",
+	"compilerOptions": {
+		"outDir": "dist",
+		"rootDir": "src"
+	},
+	"include": ["src"]
+}
+```
+
+```json
+// tsconfig.json — library consumed by bundlers
+{
+	"extends": "@lazyconfig/presets/tsconfig/lib",
+	"compilerOptions": {
+		"outDir": "out-tsc",
+		"rootDir": "src"
+	},
+	"include": ["src"]
+}
+```
+
+```json
+// tsconfig.json — React application
+{
+	"extends": "@lazyconfig/presets/tsconfig/react",
+	"include": ["src"]
+}
+```
+
+#### Build-time constants (`env`)
+
+Provides ambient types for `__DEV__` and `__PROD__` constants injected by bundlers:
+
+```json
+{
+	"compilerOptions": {
+		"types": ["@lazyconfig/presets/tsconfig/env"]
+	}
+}
+```
+
+---
+
+## `@lazyconfig/presets/eslint`
+
+ESLint flat config factory with opt-in presets for TypeScript, React, accessibility, Node.js, and Prettier.
+
+### Requirements
+
+| Package                     | Version | Required | Enables                                                                  |
+| --------------------------- | ------- | -------- | ------------------------------------------------------------------------ |
+| `eslint`                    | `^10`   | **Yes**  | Core ESLint engine                                                       |
+| `@eslint/js`                | `^10`   | **Yes**  | Built-in ESLint rules                                                    |
+| `typescript-eslint`         | `^8`    | Optional | TypeScript-aware rules (`typescript: true`)                              |
+| `globals`                   | `^17`   | Optional | Global variable definitions (`typescript: true`)                         |
+| `eslint-plugin-react`       | `^7`    | Optional | React rules (`react: true`)                                              |
+| `eslint-plugin-react-hooks` | `^5`    | Optional | React hooks rules (`react: true`)                                        |
+| `eslint-plugin-jsx-a11y`    | `^6`    | Optional | Accessibility rules (`a11y: true`)                                       |
+| `eslint-plugin-n`           | `^18`   | Optional | Node.js rules (`node: true`)                                             |
+| `eslint-config-prettier`    | `^10`   | Optional | Disables formatting rules that conflict with Prettier (`prettier: true`) |
+
+Install only what you plan to use:
+
+```sh
+# required
+pnpm add -D eslint @eslint/js
+
+# TypeScript support
+pnpm add -D typescript-eslint globals
+
+# React support
+pnpm add -D eslint-plugin-react eslint-plugin-react-hooks
+
+# accessibility support
+pnpm add -D eslint-plugin-jsx-a11y
+
+# Node.js support
+pnpm add -D eslint-plugin-n globals
+
+# Prettier conflict resolution
+pnpm add -D eslint-config-prettier
+```
+
+### Usage
+
+```ts
+// eslint.config.ts
+import { defineConfig } from "@lazyconfig/presets/eslint";
+
+export default defineConfig({
+	typescript: true,
+	node: true,
+	prettier: true,
+});
+```
+
+```ts
+// with React and accessibility
+import { defineConfig } from "@lazyconfig/presets/eslint";
+
+export default defineConfig({
+	typescript: true,
+	react: true,
+	a11y: true,
+	prettier: true,
+});
+```
+
+---
+
+## `@lazyconfig/presets/jest`
+
+Jest config factory with opt-in TypeScript (SWC), browser environment, coverage, and JUnit reporting.
+
+### Requirements
+
+| Package                  | Version | Required | Enables                                        |
+| ------------------------ | ------- | -------- | ---------------------------------------------- |
+| `jest`                   | `^30`   | **Yes**  | Core test runner                               |
+| `@swc/core`              | `^1`    | Optional | TypeScript transformation (`typescript: true`) |
+| `@swc/jest`              | `^0.2`  | Optional | SWC Jest transform (`typescript: true`)        |
+| `jest-environment-jsdom` | `^30`   | Optional | Browser environment (`browser: true`)          |
+| `jest-junit`             | `^17`   | Optional | JUnit XML reporting (`junit: true`)            |
+
+Install only what you plan to use:
+
+```sh
+# required
+pnpm add -D jest
+
+# TypeScript transformation (recommended)
+pnpm add -D @swc/core @swc/jest
+
+# browser environment
+pnpm add -D jest-environment-jsdom
+
+# JUnit XML reporting
+pnpm add -D jest-junit
+```
+
+### Usage
+
+```js
+// jest.config.js
+import { defineConfig } from "@lazyconfig/presets/jest";
+
+export default defineConfig({
+	typescript: true,
+	coverage: true,
+	junit: {
+		outputDirectory: "reports/unit",
+		outputName: "test-results.xml",
+		suiteName: "My test suite",
+	},
+});
+```
+
+---
+
+## `@lazyconfig/presets/rollup`
+
+Declarative, format-aware Rollup config factory with opt-in pre-configured plugins.
+
+### Requirements
+
+| Package                       | Version   | Required | Enables                                              |
+| ----------------------------- | --------- | -------- | ---------------------------------------------------- |
+| `rollup`                      | `^4.0.0`  | **Yes**  | Core bundler                                         |
+| `@rollup/plugin-node-resolve` | `^16.0.0` | Optional | `plugins.node` — resolves bare module specifiers     |
+| `@rollup/plugin-babel`        | `^7.0.0`  | Optional | `plugins.babel` — Babel transpilation                |
+| `@rollup/plugin-json`         | `^6.0.0`  | Optional | `plugins.json` — JSON file imports                   |
+| `@rollup/plugin-replace`      | `^6.0.0`  | Optional | `plugins.replace` — string replacement at build time |
+| `@rollup/plugin-terser`       | `^1.0.0`  | Optional | `plugins.terser` — output minification               |
+
+Install only what you plan to use:
+
+```sh
+# required
+pnpm add -D rollup
+
+# node resolution and Babel transpilation
+pnpm add -D @rollup/plugin-node-resolve @rollup/plugin-babel
+
+# JSON imports
+pnpm add -D @rollup/plugin-json
+
+# string replacement and minification
+pnpm add -D @rollup/plugin-replace @rollup/plugin-terser
+```
+
+### Usage
+
+```ts
+// rollup.config.ts
+import { defineConfig } from "@lazyconfig/presets/rollup";
+
+export default defineConfig({
+	bundles: [{ input: "src/index.ts", file: "my-lib", name: "MyLib" }],
+	external: ["react"],
+	plugins: { node: true, babel: true },
+	formats: { es: true, cjs: true },
+});
+```
+
+---
+
+## `@lazyconfig/presets/prettier`
+
+Shared Prettier preset for consistent code formatting.
+
+### Requirements
+
+No peer dependencies.
+
+| Tool       | Version | Notes                             |
+| ---------- | ------- | --------------------------------- |
+| `prettier` | `^3`    | Must be installed in your project |
+
+```sh
+pnpm add -D prettier
+```
+
+### Usage
+
+```json
+// .prettierrc.json
+"@lazyconfig/presets/prettier"
+```
+
+---
+
+## `@lazyconfig/presets/commitlint`
+
+Commitlint configuration enforcing [Conventional Commits](https://www.conventionalcommits.org/).
+
+### Requirements
+
+No peer dependencies.
+
+| Tool                              | Version | Notes                             |
+| --------------------------------- | ------- | --------------------------------- |
+| `@commitlint/cli`                 | `^20`   | Must be installed in your project |
+| `@commitlint/config-conventional` | `^20`   | Must be installed in your project |
+
+```sh
+pnpm add -D @commitlint/cli @commitlint/config-conventional
+```
+
+### Usage
+
+```js
+// commitlint.config.cjs
+module.exports = {
+	extends: ["@lazyconfig/presets/commitlint"],
+};
+```
+
+---
+
+## `@lazyconfig/presets/api-extractor`
+
+Shared API Extractor base configuration for generating rolled-up `.d.ts` declaration files.
+
+### Requirements
+
+No peer dependencies.
+
+| Tool                       | Version   | Notes                             |
+| -------------------------- | --------- | --------------------------------- |
+| `@microsoft/api-extractor` | `>=7.0.0` | Must be installed in your project |
+
+```sh
+pnpm add -D @microsoft/api-extractor
+```
+
+### Usage
+
+```json
+// api-extractor.json
+{
+	"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+	"extends": "@lazyconfig/presets/src/api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/out-tsc/src/index.d.ts",
+	"dtsRollup": {
+		"enabled": true,
+		"untrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>.index.d.ts"
+	}
+}
+```
+
+---
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,72 @@
+{
+	"name": "@lazyconfig/presets",
+	"version": "0.1.0",
+	"description": "Meta-package that bundles all lazyconfig presets for a single-install setup.",
+	"type": "module",
+	"files": [
+		"src",
+		"package.json",
+		"README.md",
+		"LICENSE"
+	],
+	"exports": {
+		"./package.json": "./package.json",
+		"./rollup": {
+			"types": "./src/rollup.d.ts",
+			"default": "./src/rollup.js"
+		},
+		"./jest": {
+			"types": "./src/jest.d.ts",
+			"default": "./src/jest.js"
+		},
+		"./eslint": {
+			"types": "./src/eslint.d.ts",
+			"default": "./src/eslint.js"
+		},
+		"./tsconfig/base": "./src/tsconfig/base.json",
+		"./tsconfig/lib": "./src/tsconfig/lib.json",
+		"./tsconfig/node": "./src/tsconfig/node.json",
+		"./tsconfig/react": "./src/tsconfig/react.json",
+		"./tsconfig/env": "./src/tsconfig/env.d.ts",
+		"./api-extractor": "./src/api-extractor.json",
+		"./prettier": "./src/prettier.json",
+		"./commitlint": "./src/commitlint.json"
+	},
+	"scripts": {
+		"build": "node scripts/copy-configs.mjs",
+		"test": "node --test --test-reporter=spec \"test/**/*.test.mjs\""
+	},
+	"dependencies": {
+		"@lazyconfig/api-extractor": "workspace:*",
+		"@lazyconfig/commitlint": "workspace:*",
+		"@lazyconfig/eslint": "workspace:*",
+		"@lazyconfig/jest": "workspace:*",
+		"@lazyconfig/prettier": "workspace:*",
+		"@lazyconfig/rollup": "workspace:*",
+		"@lazyconfig/tsconfig": "workspace:*"
+	},
+	"keywords": [
+		"lazyconfig",
+		"presets",
+		"meta"
+	],
+	"packageManager": "pnpm@11.5.2",
+	"engines": {
+		"node": ">=22.0.0",
+		"pnpm": ">=10.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"homepage": "https://github.com/ruben-omh/lazyconfig/tree/main/packages/presets#readme",
+	"bugs": {
+		"url": "https://github.com/ruben-omh/lazyconfig/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/ruben-omh/lazyconfig",
+		"directory": "packages/presets"
+	},
+	"author": "ruben-omh",
+	"license": "MIT"
+}

package/src/api-extractor.json

@@ -0,0 +1,55 @@
+{
+	"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+	"projectFolder": ".",
+	"mainEntryPointFilePath": "<projectFolder>/out-tsc/index.d.ts",
+	"bundledPackages": [],
+	"newlineKind": "lf",
+	"enumMemberOrder": "preserve",
+	"compiler": {
+		"tsconfigFilePath": "<projectFolder>/tsconfig.lib.json",
+		"overrideTsconfig": {
+			"compilerOptions": {
+				"moduleResolution": "Bundler",
+				"target": "ES2022",
+				"lib": ["ES2022"],
+				"types": ["node"],
+				"skipLibCheck": true
+			}
+		}
+	},
+	"apiReport": {
+		"enabled": false
+	},
+	"docModel": {
+		"enabled": false
+	},
+	"dtsRollup": {
+		"enabled": true
+	},
+	"tsdocMetadata": {
+		"enabled": false
+	},
+	"messages": {
+		"compilerMessageReporting": {
+			"default": {
+				"logLevel": "warning"
+			}
+		},
+		"extractorMessageReporting": {
+			"default": {
+				"logLevel": "warning"
+			},
+			"ae-missing-release-tag": {
+				"logLevel": "none"
+			},
+			"ae-undocumented": {
+				"logLevel": "none"
+			}
+		},
+		"tsdocMessageReporting": {
+			"default": {
+				"logLevel": "none"
+			}
+		}
+	}
+}

package/src/commitlint.json

@@ -0,0 +1,24 @@
+{
+	"extends": ["@commitlint/config-conventional"],
+	"rules": {
+		"type-enum": [
+			2,
+			"always",
+			["ci", "chore", "docs", "feat", "fix", "refactor", "revert", "style", "perf", "test", "build"]
+		],
+		"type-empty": [2, "never"],
+		"type-case": [2, "always", ["lower-case"]],
+		"scope-case": [2, "always", "lower-case"],
+		"scope-empty": [1, "never"],
+		"scope-max-length": [2, "always", 25],
+		"header-max-length": [2, "always", 100],
+		"subject-max-length": [2, "always", 72],
+		"subject-empty": [2, "never"],
+		"subject-case": [2, "never", ["sentence-case", "start-case", "pascal-case", "upper-case"]],
+		"subject-full-stop": [2, "never", "."],
+		"body-leading-blank": [1, "always"],
+		"body-min-length": [2, "always", 2],
+		"footer-leading-blank": [1, "always"]
+	},
+	"helpUrl": "https://github.com/conventional-changelog/commitlint/#what-is-commitlint"
+}

package/src/eslint.d.ts

@@ -0,0 +1 @@
+export * from "@lazyconfig/eslint";

package/src/eslint.js

@@ -0,0 +1 @@
+export * from "@lazyconfig/eslint";

package/src/jest.d.ts

@@ -0,0 +1 @@
+export * from "@lazyconfig/jest";

package/src/jest.js

@@ -0,0 +1 @@
+export * from "@lazyconfig/jest";

package/src/prettier.json

@@ -0,0 +1,16 @@
+{
+	"trailingComma": "all",
+	"tabWidth": 2,
+	"semi": true,
+	"printWidth": 100,
+	"useTabs": true,
+	"quoteProps": "as-needed",
+	"bracketSpacing": true,
+	"bracketSameLine": false,
+	"arrowParens": "always",
+	"htmlWhitespaceSensitivity": "strict",
+	"singleAttributePerLine": true,
+	"endOfLine": "lf",
+	"embeddedLanguageFormatting": "auto",
+	"proseWrap": "preserve"
+}

package/src/rollup.d.ts

@@ -0,0 +1 @@
+export * from "@lazyconfig/rollup";

package/src/rollup.js

@@ -0,0 +1 @@
+export * from "@lazyconfig/rollup";

package/src/tsconfig/base.json

@@ -0,0 +1,9 @@
+{
+	"compilerOptions": {
+		"strict": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"esModuleInterop": true,
+		"verbatimModuleSyntax": true
+	}
+}

package/src/tsconfig/env.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Ambient type declarations for build-time constants injected by bundlers.
+ * Include this file in your `tsconfig.json` to make these constants
+ * available across your project without explicit imports.
+ *
+ * @example
+ * ```json
+ * {
+ *   "compilerOptions": {
+ *     "types": ["@lazyconfig/tsconfig/env"]
+ *   }
+ * }
+ * ```
+ */
+
+/** Indicates whether the current build is running in development mode. */
+declare const __DEV__: boolean;
+
+/** Indicates whether the current build is running in production mode. */
+declare const __PROD__: boolean;

package/src/tsconfig/lib.json

@@ -0,0 +1,13 @@
+{
+	"extends": "./base.json",
+	"compilerOptions": {
+		"target": "ES2022",
+		"lib": ["ES2022"],
+		"module": "ESNext",
+		"moduleResolution": "Bundler",
+		"declaration": true,
+		"declarationMap": true,
+		"emitDeclarationOnly": true,
+		"noEmitOnError": true
+	}
+}

package/src/tsconfig/node.json

@@ -0,0 +1,13 @@
+{
+	"extends": "./base.json",
+	"compilerOptions": {
+		"target": "ES2022",
+		"lib": ["ES2022"],
+		"module": "NodeNext",
+		"moduleResolution": "NodeNext",
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": true,
+		"noEmitOnError": true
+	}
+}

package/src/tsconfig/react.json

@@ -0,0 +1,11 @@
+{
+	"extends": "./base.json",
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "ESNext",
+		"moduleResolution": "Bundler",
+		"lib": ["DOM", "DOM.Iterable", "ES2022"],
+		"jsx": "react-jsx",
+		"noEmit": true
+	}
+}