@sklv-labs/ts-dev-configs 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-01-XX
+
+### Added
+
+- Initial release of @sklv-labs/ts-dev-configs
+- Base preset with ESLint 9 (flat config), Prettier 3.6, TypeScript 5.9, Jest 29, and Vitest 4 configurations
+- React preset extending base with React-specific configurations
+- NestJS preset extending base with NestJS-specific configurations
+- Git configs: lint-staged, commitlint, and husky hooks
+- Build tool configs: Vite 7 and Webpack base configurations
+- Editor configs: .editorconfig and VS Code settings
+- Main TypeScript exports with type definitions
+- Comprehensive documentation and usage examples
+
+### Features
+
+- **ESLint 9 Flat Config**: All ESLint configs use the modern flat config format (eslint.config.mjs)
+- **Node.js 24 LTS**: Optimized for Node.js 24 with ES2024 target and nodenext module resolution
+- **Latest Tooling**: All configs use the latest stable versions of development tools
+- **TypeScript 5.9**: Latest TypeScript features and compiler options

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sklv-labs
+
+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,335 @@
+# @sklv-labs/ts-dev-configs
+
+Unified development configurations for TypeScript projects with support for React, NestJS, and more. This package provides a consistent set of ESLint, Prettier, TypeScript, Jest, Vitest, and other development tool configurations that can be easily extended and reused across projects.
+
+**Latest versions:** Node.js 24 LTS, TypeScript 5.9+, ESLint 9 (flat config), Prettier 3.6+, Vitest 4+, Vite 7+
+
+## Features
+
+- 🎯 **Preset-based architecture** - Choose from base, React, or NestJS presets
+- 🔧 **Extensible configs** - All configs use the `extends` pattern for easy customization
+- 📦 **Zero dependencies** - Uses peer dependencies to avoid version conflicts
+- 🚀 **Framework support** - Optimized configs for React and NestJS
+- 🛠️ **Additional tooling** - Includes git hooks, build tools, and editor configs
+
+## Installation
+
+```bash
+npm install --save-dev @sklv-labs/ts-dev-configs
+```
+
+### Peer Dependencies
+
+This package requires the following peer dependencies. Install them based on your needs:
+
+```bash
+# Required (latest versions)
+npm install --save-dev typescript@^5.9.0 eslint@^9.0.0 prettier@^3.6.0
+
+# For ESLint flat config (ESLint 9)
+npm install --save-dev @eslint/js typescript-eslint globals eslint-config-prettier eslint-plugin-import-x
+
+# For React preset
+npm install --save-dev eslint-plugin-react eslint-plugin-react-hooks @vitejs/plugin-react
+
+# For NestJS preset
+npm install --save-dev @nestjs/eslint-plugin-nestjs
+
+# For testing
+npm install --save-dev jest@^29.7.0 ts-jest@^29.2.0 @types/jest
+# or
+npm install --save-dev vitest@^4.0.0 @vitest/ui
+
+# For Vite (React preset)
+npm install --save-dev vite@^7.0.0
+```
+
+**Note:** This package requires Node.js 24 LTS or higher.
+
+## Usage
+
+### Base Preset
+
+The base preset includes configurations for TypeScript, ESLint, Prettier, Jest, and Vitest.
+
+#### TypeScript Config
+
+```json
+// tsconfig.json
+{
+  "extends": "@sklv-labs/ts-dev-configs/presets/base/tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  }
+}
+```
+
+#### ESLint Config (Flat Config - ESLint 9)
+
+```js
+// eslint.config.mjs
+import baseEslint from '@sklv-labs/ts-dev-configs/eslint/base';
+
+export default baseEslint;
+```
+
+Or extend it:
+
+```js
+// eslint.config.mjs
+import { defineConfig } from 'eslint/config';
+import baseEslint from '@sklv-labs/ts-dev-configs/eslint/base';
+
+export default defineConfig([
+  ...baseEslint,
+  {
+    rules: {
+      // Your custom rules
+    },
+  },
+]);
+```
+
+#### Prettier Config
+
+```js
+// .prettierrc.js
+module.exports = require('@sklv-labs/ts-dev-configs/presets/base/prettier.js');
+```
+
+#### Jest Config
+
+```js
+// jest.config.js
+module.exports = require('@sklv-labs/ts-dev-configs/presets/base/jest.config.js');
+```
+
+#### Vitest Config
+
+```ts
+// vitest.config.ts
+import { defineConfig } from 'vitest/config';
+import baseVitest from '@sklv-labs/ts-dev-configs/presets/base/vitest.config.ts';
+
+export default defineConfig({
+  ...baseVitest,
+  // Your custom config
+});
+```
+
+### React Preset
+
+The React preset extends the base preset with React-specific configurations.
+
+#### TypeScript Config
+
+```json
+// tsconfig.json
+{
+  "extends": "@sklv-labs/ts-dev-configs/presets/react/tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  }
+}
+```
+
+#### ESLint Config (Flat Config - ESLint 9)
+
+```js
+// eslint.config.mjs
+import reactEslint from '@sklv-labs/ts-dev-configs/eslint/react';
+
+export default reactEslint;
+```
+
+#### Vite Config
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import reactVite from '@sklv-labs/ts-dev-configs/presets/react/vite.config.ts';
+
+export default defineConfig({
+  ...reactVite,
+  // Your custom config
+});
+```
+
+### NestJS Preset
+
+The NestJS preset extends the base preset with NestJS-specific configurations.
+
+#### TypeScript Config
+
+```json
+// tsconfig.json
+{
+  "extends": "@sklv-labs/ts-dev-configs/presets/nestjs/tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  }
+}
+```
+
+#### ESLint Config (Flat Config - ESLint 9)
+
+```js
+// eslint.config.mjs
+import nestjsEslint from '@sklv-labs/ts-dev-configs/eslint/nestjs';
+
+export default nestjsEslint;
+```
+
+#### Jest Config
+
+```js
+// jest.config.js
+module.exports = require('@sklv-labs/ts-dev-configs/presets/nestjs/jest.config.js');
+```
+
+## Additional Configs
+
+### Git Hooks
+
+#### Lint-Staged
+
+```js
+// .lintstagedrc.js
+module.exports = require('@sklv-labs/ts-dev-configs/configs/git/lint-staged.js');
+```
+
+#### Commitlint
+
+```js
+// commitlint.config.js
+module.exports = require('@sklv-labs/ts-dev-configs/configs/git/commitlint.js');
+```
+
+#### Husky Hooks
+
+Copy the husky hooks from `@sklv-labs/ts-dev-configs/configs/git/husky/` to your `.husky/` directory.
+
+### Build Tools
+
+#### Vite Base Config
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import viteBase from '@sklv-labs/ts-dev-configs/configs/build/vite.base';
+
+export default defineConfig({
+  ...viteBase,
+  // Your custom config
+});
+```
+
+#### Webpack Base Config
+
+```js
+// webpack.config.js
+const webpackBase = require('@sklv-labs/ts-dev-configs/configs/build/webpack.base');
+
+module.exports = {
+  ...webpackBase,
+  // Your custom config
+};
+```
+
+### Editor Configs
+
+#### EditorConfig
+
+Copy `.editorconfig` from `@sklv-labs/ts-dev-configs/configs/editor/.editorconfig` to your project root.
+
+#### VS Code Settings
+
+Copy the VS Code settings from `@sklv-labs/ts-dev-configs/configs/editor/vscode/` to your `.vscode/` directory.
+
+## Extending Configs
+
+All configs are designed to be extended. You can override specific rules or settings:
+
+### Extending ESLint (Flat Config)
+
+```js
+// eslint.config.mjs
+import { defineConfig } from 'eslint/config';
+import reactEslint from '@sklv-labs/ts-dev-configs/eslint/react';
+
+export default defineConfig([
+  ...reactEslint,
+  {
+    rules: {
+      // Override or add rules
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  },
+]);
+```
+
+### Extending TypeScript Config
+
+```json
+// tsconfig.json
+{
+  "extends": "@sklv-labs/ts-dev-configs/presets/react/tsconfig.json",
+  "compilerOptions": {
+    "strict": true,
+    "noUnusedLocals": true
+  }
+}
+```
+
+### Extending Prettier
+
+```js
+// .prettierrc.js
+module.exports = {
+  ...require('@sklv-labs/ts-dev-configs/presets/base/prettier.js'),
+  printWidth: 120, // Override
+};
+```
+
+## Programmatic Usage
+
+You can also import configs programmatically:
+
+```ts
+import { presets, configs } from '@sklv-labs/ts-dev-configs';
+
+// Access preset paths
+const baseEslintPath = presets.base.eslint;
+const reactTsconfigPath = presets.react.tsconfig;
+
+// Access config paths
+const lintStagedPath = configs.git.lintStaged;
+const viteBasePath = configs.build.vite;
+```
+
+## Project Structure
+
+```
+@sklv-labs/ts-dev-configs/
+├── presets/
+│   ├── base/          # Base preset (ESLint, Prettier, TypeScript, Jest, Vitest)
+│   ├── react/         # React preset (extends base + React-specific)
+│   └── nestjs/        # NestJS preset (extends base + NestJS-specific)
+├── configs/
+│   ├── git/           # Git hooks (husky, lint-staged, commitlint)
+│   ├── build/         # Build tools (Vite, Webpack)
+│   └── editor/        # Editor configs (.editorconfig, VS Code)
+└── src/
+    └── index.ts       # Main exports
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © [sklv-labs](https://github.com/sklv-labs)

package/configs/build/index.js

@@ -0,0 +1,6 @@
+const path = require('path');
+
+module.exports = {
+  vite: path.resolve(__dirname, 'vite.base.ts'),
+  webpack: path.resolve(__dirname, 'webpack.base.js'),
+};

package/configs/build/vite.base.ts

@@ -0,0 +1,35 @@
+// @ts-nocheck - Template file for consuming projects, peer dependencies not installed here
+import { defineConfig } from 'vite';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, '../../src'),
+    },
+  },
+  build: {
+    outDir: 'dist',
+    sourcemap: true,
+    minify: 'esbuild',
+    target: 'esnext',
+    rollupOptions: {
+      output: {
+        manualChunks: undefined,
+      },
+    },
+  },
+  server: {
+    port: 3000,
+    open: false,
+    cors: true,
+    strictPort: false,
+  },
+  preview: {
+    port: 3000,
+    strictPort: false,
+  },
+});

package/configs/build/webpack.base.js

@@ -0,0 +1,27 @@
+const path = require('path');
+
+module.exports = {
+  entry: './src/index.ts',
+  output: {
+    path: path.resolve(__dirname, '../../dist'),
+    filename: 'bundle.js',
+    clean: true,
+  },
+  resolve: {
+    extensions: ['.ts', '.tsx', '.js', '.jsx'],
+    alias: {
+      '@': path.resolve(__dirname, '../../src'),
+    },
+  },
+  module: {
+    rules: [
+      {
+        test: /\.tsx?$/,
+        use: 'ts-loader',
+        exclude: /node_modules/,
+      },
+    ],
+  },
+  devtool: 'source-map',
+  mode: process.env.NODE_ENV || 'development',
+};

package/configs/editor/.editorconfig

@@ -0,0 +1,35 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+trim_trailing_whitespace = true
+
+# TypeScript and JavaScript files
+[*.{ts,tsx,js,jsx}]
+indent_style = space
+indent_size = 2
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+
+# Package files
+[{package.json,package-lock.json}]
+indent_style = space
+indent_size = 2

package/configs/editor/index.js

@@ -0,0 +1,9 @@
+const path = require('path');
+
+module.exports = {
+  editorconfig: path.resolve(__dirname, '.editorconfig'),
+  vscode: {
+    settings: path.resolve(__dirname, 'vscode/settings.json'),
+    extensions: path.resolve(__dirname, 'vscode/extensions.json'),
+  },
+};

package/configs/editor/vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+    "recommendations": [
+        "dbaeumer.vscode-eslint",
+        "prettier.prettier-vscode",
+        "ms-vscode.vscode-typescript-next"
+    ]
+}

package/configs/editor/vscode/settings.json

@@ -0,0 +1,36 @@
+{
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "prettier.prettier-vscode",
+    "editor.codeActionsOnSave": {
+        "source.fixAll.eslint": "explicit"
+    },
+    "typescript.tsdk": "node_modules/typescript/lib",
+    "typescript.enablePromptUseWorkspaceTsdk": true,
+    "typescript.preferences.includePackageJsonAutoImports": "off",
+    "[typescript]": {
+        "editor.defaultFormatter": "prettier.prettier-vscode"
+    },
+    "[typescriptreact]": {
+        "editor.defaultFormatter": "prettier.prettier-vscode"
+    },
+    "[javascript]": {
+        "editor.defaultFormatter": "prettier.prettier-vscode"
+    },
+    "[javascriptreact]": {
+        "editor.defaultFormatter": "prettier.prettier-vscode"
+    },
+    "[json]": {
+        "editor.defaultFormatter": "prettier.prettier-vscode"
+    },
+    "[jsonc]": {
+        "editor.defaultFormatter": "prettier.prettier-vscode"
+    },
+    "files.eol": "\n",
+    "files.insertFinalNewline": true,
+    "files.trimTrailingWhitespace": true,
+    "files.exclude": {
+        "**/presets/**/tsconfig.json": false
+    },
+    "typescript.validate.enable": true,
+    "typescript.tsserver.experimental.enableProjectDiagnostics": false
+}

package/configs/git/commitlint.js

@@ -0,0 +1,28 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',
+        'fix',
+        'docs',
+        'style',
+        'refactor',
+        'perf',
+        'test',
+        'chore',
+        'revert',
+        'build',
+        'ci',
+      ],
+    ],
+    'type-case': [2, 'always', 'lower-case'],
+    'type-empty': [2, 'never'],
+    'scope-case': [2, 'always', 'lower-case'],
+    'subject-empty': [2, 'never'],
+    'subject-full-stop': [2, 'never', '.'],
+    'header-max-length': [2, 'always', 100],
+  },
+};

package/configs/git/husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no -- commitlint --edit ${1}

package/configs/git/husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx lint-staged

package/configs/git/index.js

@@ -0,0 +1,10 @@
+const path = require('path');
+
+module.exports = {
+  lintStaged: path.resolve(__dirname, 'lint-staged.js'),
+  commitlint: path.resolve(__dirname, 'commitlint.js'),
+  husky: {
+    preCommit: path.resolve(__dirname, 'husky/pre-commit'),
+    commitMsg: path.resolve(__dirname, 'husky/commit-msg'),
+  },
+};

package/configs/git/lint-staged.js

@@ -0,0 +1,9 @@
+module.exports = {
+  '*.{ts,tsx}': [
+    'eslint --fix',
+    'prettier --write',
+  ],
+  '*.{js,jsx,json,md,yml,yaml}': [
+    'prettier --write',
+  ],
+};

package/package.json

@@ -0,0 +1,74 @@
+{
+    "name": "@sklv-labs/ts-dev-configs",
+    "version": "0.1.0",
+    "description": "Unified development configurations for TypeScript projects with support for React, NestJS, and more",
+    "keywords": [
+        "typescript",
+        "eslint",
+        "prettier",
+        "jest",
+        "vitest",
+        "config",
+        "preset",
+        "react",
+        "nestjs"
+    ],
+    "license": "MIT",
+    "author": "sklv-labs",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/sklv-labs/ts-dev-configs.git"
+    },
+    "main": "./src/index.ts",
+    "types": "./src/index.ts",
+    "exports": {
+        ".": "./src/index.ts",
+        "./base": "./presets/base/index.js",
+        "./react": "./presets/react/index.js",
+        "./nestjs": "./presets/nestjs/index.js",
+        "./presets/base": "./presets/base/index.js",
+        "./presets/react": "./presets/react/index.js",
+        "./presets/nestjs": "./presets/nestjs/index.js",
+        "./eslint/base": "./presets/base/eslint.config.mjs",
+        "./eslint/react": "./presets/react/eslint.config.mjs",
+        "./eslint/nestjs": "./presets/nestjs/eslint.config.mjs",
+        "./configs/git": "./configs/git/index.js",
+        "./configs/build": "./configs/build/index.js",
+        "./configs/editor": "./configs/editor/index.js"
+    },
+    "files": [
+        "src",
+        "presets",
+        "configs",
+        "README.md",
+        "CHANGELOG.md"
+    ],
+    "peerDependencies": {
+        "typescript": "^5.9.0",
+        "eslint": "^9.0.0",
+        "prettier": "^3.6.0"
+    },
+    "peerDependenciesMeta": {
+        "typescript": {
+            "optional": false
+        },
+        "eslint": {
+            "optional": false
+        },
+        "prettier": {
+            "optional": false
+        }
+    },
+    "devDependencies": {
+        "@types/node": "^24.0.0",
+        "typescript": "^5.9.2",
+        "vitest": "^4.0.7"
+    },
+    "scripts": {
+        "type-check": "tsc --noEmit",
+        "prepublishOnly": "npm run type-check"
+    },
+    "engines": {
+        "node": ">=24.0.0"
+    }
+}

package/presets/base/eslint.config.mjs

@@ -0,0 +1,91 @@
+import eslint from '@eslint/js';
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+import importPlugin from 'eslint-plugin-import-x';
+import globals from 'globals';
+import prettier from 'eslint-config-prettier';
+
+export default defineConfig([
+    // Base recommended configs
+    eslint.configs.recommended,
+    ...tseslint.configs.recommended,
+    ...tseslint.configs.recommendedTypeChecked,
+
+    // Global ignores
+    {
+        ignores: ['dist/**', 'build/**', 'node_modules/**', '*.config.js', '*.config.ts', '*.config.mjs'],
+    },
+
+    // TypeScript files configuration
+    {
+        files: ['**/*.{ts,tsx}'],
+        languageOptions: {
+            ecmaVersion: 2024,
+            sourceType: 'module',
+            globals: {
+                ...globals.node,
+                ...globals.es2024,
+            },
+            parser: tseslint.parser,
+            parserOptions: {
+                projectService: true,
+                tsconfigRootDir: import.meta.dirname,
+            },
+        },
+        plugins: {
+            '@typescript-eslint': tseslint.plugin,
+            'import-x': importPlugin,
+        },
+        rules: {
+            // TypeScript specific rules
+            '@typescript-eslint/explicit-function-return-type': 'off',
+            '@typescript-eslint/explicit-module-boundary-types': 'off',
+            '@typescript-eslint/no-explicit-any': 'warn',
+            '@typescript-eslint/no-unused-vars': [
+                'error',
+                {
+                    argsIgnorePattern: '^_',
+                    varsIgnorePattern: '^_',
+                },
+            ],
+            '@typescript-eslint/prefer-const': 'error',
+            '@typescript-eslint/no-non-null-assertion': 'warn',
+
+            // General best practices
+            'no-console': ['warn', { allow: ['warn', 'error'] }],
+            'no-debugger': 'error',
+            'no-duplicate-imports': 'error',
+            'no-unused-expressions': 'error',
+            'prefer-const': 'error',
+            'prefer-arrow-callback': 'error',
+            'prefer-template': 'error',
+
+            // Import order rules
+            'import-x/order': [
+                'error',
+                {
+                    groups: [
+                        'builtin',
+                        'external',
+                        'internal',
+                        'parent',
+                        'sibling',
+                        'index',
+                        'object',
+                        'type',
+                    ],
+                    'newlines-between': 'always',
+                    alphabetize: {
+                        order: 'asc',
+                        caseInsensitive: true,
+                    },
+                },
+            ],
+            'import-x/no-duplicates': 'error',
+            'import-x/no-unresolved': 'off', // TypeScript handles this
+        },
+    },
+
+    // Prettier config (must be last to override formatting rules)
+    prettier,
+]);

package/presets/base/index.js

@@ -0,0 +1,9 @@
+const path = require('path');
+
+module.exports = {
+    eslint: path.resolve(__dirname, 'eslint.config.mjs'),
+    prettier: path.resolve(__dirname, 'prettier.js'),
+    tsconfig: path.resolve(__dirname, 'tsconfig.json'),
+    jest: path.resolve(__dirname, 'jest.config.js'),
+    vitest: path.resolve(__dirname, 'vitest.config.ts'),
+};

package/presets/base/jest.config.js

@@ -0,0 +1,33 @@
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    roots: ['<rootDir>/src', '<rootDir>/test'],
+    testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
+    transform: {
+        '^.+\\.ts$': [
+            'ts-jest',
+            {
+                tsconfig: {
+                    compilerOptions: {
+                        module: 'nodenext',
+                        target: 'ES2024',
+                    },
+                },
+            },
+        ],
+    },
+    collectCoverageFrom: [
+        'src/**/*.ts',
+        '!src/**/*.d.ts',
+        '!src/**/*.test.ts',
+        '!src/**/*.spec.ts',
+    ],
+    coverageDirectory: 'coverage',
+    coverageReporters: ['text', 'lcov', 'html', 'json'],
+    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
+    verbose: true,
+    clearMocks: true,
+    resetMocks: true,
+    restoreMocks: true,
+    testTimeout: 10000,
+};

package/presets/base/prettier.js

@@ -0,0 +1,12 @@
+module.exports = {
+  semi: true,
+  trailingComma: 'es5',
+  singleQuote: true,
+  printWidth: 100,
+  tabWidth: 2,
+  useTabs: false,
+  arrowParens: 'always',
+  endOfLine: 'lf',
+  bracketSpacing: true,
+  bracketSameLine: false,
+};

package/presets/base/tsconfig.json

@@ -0,0 +1,34 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "compilerOptions": {
+        "target": "ES2024",
+        "module": "nodenext",
+        "lib": [
+            "ES2024"
+        ],
+        "moduleResolution": "nodenext",
+        "resolveJsonModule": true,
+        "allowJs": true,
+        "checkJs": false,
+        "outDir": "./dist",
+        "rootDir": "./",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noImplicitReturns": true,
+        "noFallthroughCasesInSwitch": true,
+        "isolatedModules": true,
+        "allowSyntheticDefaultImports": true
+    },
+    "exclude": [
+        "node_modules",
+        "dist",
+        "build"
+    ]
+}

package/presets/base/vitest.config.ts

@@ -0,0 +1,48 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['**/*.{test,spec}.{js,ts,jsx,tsx}'],
+    exclude: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+    pool: 'forks',
+    fileParallelism: true,
+    testTimeout: 5000,
+    hookTimeout: 10000,
+    reporters: ['default', 'json', 'html'],
+    outputFile: {
+      json: './test-results.json',
+      html: './test-results/index.html',
+    },
+    coverage: {
+      provider: 'v8',
+      enabled: false,
+      reporter: ['text', 'json', 'html', 'lcov'],
+      reportsDirectory: './coverage',
+      include: ['src/**/*.{ts,tsx}'],
+      exclude: [
+        'node_modules/',
+        'dist/',
+        'build/',
+        '**/*.d.ts',
+        '**/*.config.{ts,js,mjs}',
+        '**/*.test.{ts,tsx}',
+        '**/*.spec.{ts,tsx}',
+      ],
+      thresholds: {
+        lines: 80,
+        functions: 80,
+        branches: 80,
+        statements: 80,
+      },
+    },
+    clearMocks: true,
+    restoreMocks: true,
+    sequence: {
+      shuffle: false,
+      concurrent: false,
+      hooks: 'stack',
+    },
+  },
+});

package/presets/nestjs/eslint.config.mjs

@@ -0,0 +1,98 @@
+import eslint from '@eslint/js';
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+import nestjsPlugin from '@nestjs/eslint-plugin-nestjs';
+import importPlugin from 'eslint-plugin-import-x';
+import globals from 'globals';
+import prettier from 'eslint-config-prettier';
+
+export default defineConfig([
+    // Base recommended configs
+    eslint.configs.recommended,
+    ...tseslint.configs.recommended,
+    ...tseslint.configs.recommendedTypeChecked,
+
+    // Global ignores
+    {
+        ignores: ['dist/**', 'build/**', 'node_modules/**', '*.config.js', '*.config.ts', '*.config.mjs'],
+    },
+
+    // TypeScript files configuration
+    {
+        files: ['**/*.ts'],
+        languageOptions: {
+            ecmaVersion: 2024,
+            sourceType: 'module',
+            globals: {
+                ...globals.node,
+                ...globals.es2024,
+            },
+            parser: tseslint.parser,
+            parserOptions: {
+                projectService: true,
+                tsconfigRootDir: import.meta.dirname,
+            },
+        },
+        plugins: {
+            '@typescript-eslint': tseslint.plugin,
+            '@nestjs': nestjsPlugin,
+            'import-x': importPlugin,
+        },
+        rules: {
+            // TypeScript specific rules
+            '@typescript-eslint/explicit-function-return-type': 'off',
+            '@typescript-eslint/explicit-module-boundary-types': 'off',
+            '@typescript-eslint/no-explicit-any': 'warn',
+            '@typescript-eslint/no-unused-vars': [
+                'error',
+                {
+                    argsIgnorePattern: '^_',
+                    varsIgnorePattern: '^_',
+                },
+            ],
+            '@typescript-eslint/prefer-const': 'error',
+            '@typescript-eslint/no-non-null-assertion': 'warn',
+            '@typescript-eslint/interface-name-prefix': 'off',
+
+            // NestJS specific rules
+            '@nestjs/use-validation-pipe': 'warn',
+            '@nestjs/use-pipes-decorator': 'warn',
+
+            // General best practices
+            'no-console': ['warn', { allow: ['warn', 'error'] }],
+            'no-debugger': 'error',
+            'no-duplicate-imports': 'error',
+            'no-unused-expressions': 'error',
+            'prefer-const': 'error',
+            'prefer-arrow-callback': 'error',
+            'prefer-template': 'error',
+
+            // Import order rules
+            'import-x/order': [
+                'error',
+                {
+                    groups: [
+                        'builtin',
+                        'external',
+                        'internal',
+                        'parent',
+                        'sibling',
+                        'index',
+                        'object',
+                        'type',
+                    ],
+                    'newlines-between': 'always',
+                    alphabetize: {
+                        order: 'asc',
+                        caseInsensitive: true,
+                    },
+                },
+            ],
+            'import-x/no-duplicates': 'error',
+            'import-x/no-unresolved': 'off', // TypeScript handles this
+        },
+    },
+
+    // Prettier config (must be last to override formatting rules)
+    prettier,
+]);

package/presets/nestjs/index.js

@@ -0,0 +1,9 @@
+const path = require('path');
+
+module.exports = {
+    eslint: path.resolve(__dirname, 'eslint.config.mjs'),
+    prettier: path.resolve(__dirname, '../base/prettier.js'),
+    tsconfig: path.resolve(__dirname, 'tsconfig.json'),
+    jest: path.resolve(__dirname, 'jest.config.js'),
+    vitest: path.resolve(__dirname, '../base/vitest.config.ts'),
+};

package/presets/nestjs/jest.config.js

@@ -0,0 +1,24 @@
+const baseJest = require('../base/jest.config.js');
+
+module.exports = {
+  ...baseJest,
+  moduleNameMapper: {
+    '^src/(.*)$': '<rootDir>/src/$1',
+  },
+  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/**/*.spec.ts',
+    '!src/**/*.interface.ts',
+    '!src/main.ts',
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+  },
+};

package/presets/nestjs/tsconfig.json

@@ -0,0 +1,36 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": "../base/tsconfig.json",
+    "compilerOptions": {
+        "module": "CommonJS",
+        "moduleResolution": "node",
+        "target": "ES2024",
+        "lib": [
+            "ES2024"
+        ],
+        "declaration": true,
+        "removeComments": true,
+        "emitDecoratorMetadata": true,
+        "experimentalDecorators": true,
+        "allowSyntheticDefaultImports": true,
+        "sourceMap": true,
+        "outDir": "./dist",
+        "baseUrl": "./",
+        "incremental": true,
+        "skipLibCheck": true,
+        "strictNullChecks": true,
+        "noImplicitAny": true,
+        "strictBindCallApply": true,
+        "forceConsistentCasingInFileNames": true,
+        "noFallthroughCasesInSwitch": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "test",
+        "**/*spec.ts"
+    ]
+}

package/presets/react/eslint.config.mjs

@@ -0,0 +1,111 @@
+import eslint from '@eslint/js';
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import importPlugin from 'eslint-plugin-import-x';
+import globals from 'globals';
+import prettier from 'eslint-config-prettier';
+
+export default defineConfig([
+  // Base recommended configs
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+
+  // Global ignores
+  {
+    ignores: ['dist/**', 'build/**', 'node_modules/**', '*.config.js', '*.config.ts', '*.config.mjs'],
+  },
+
+  // TypeScript and React files configuration
+  {
+    files: ['**/*.{ts,tsx,js,jsx}'],
+    languageOptions: {
+      ecmaVersion: 2024,
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.es2024,
+      },
+      parser: tseslint.parser,
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint.plugin,
+      react: reactPlugin,
+      'react-hooks': reactHooksPlugin,
+      'import-x': importPlugin,
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+    rules: {
+      // TypeScript specific rules
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/prefer-const': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+
+      // General best practices
+      'no-console': ['warn', { allow: ['warn', 'error'] }],
+      'no-debugger': 'error',
+      'no-duplicate-imports': 'error',
+      'no-unused-expressions': 'error',
+      'prefer-const': 'error',
+      'prefer-arrow-callback': 'error',
+      'prefer-template': 'error',
+
+      // React specific rules
+      'react/prop-types': 'off', // TypeScript handles this
+      'react/react-in-jsx-scope': 'off', // Not needed with new JSX transform
+      'react/display-name': 'off',
+      'react-hooks/rules-of-hooks': 'error',
+      'react-hooks/exhaustive-deps': 'warn',
+
+      // Import order rules
+      'import-x/order': [
+        'error',
+        {
+          groups: [
+            'builtin',
+            'external',
+            'internal',
+            'parent',
+            'sibling',
+            'index',
+            'object',
+            'type',
+          ],
+          'newlines-between': 'always',
+          alphabetize: {
+            order: 'asc',
+            caseInsensitive: true,
+          },
+        },
+      ],
+      'import-x/no-duplicates': 'error',
+      'import-x/no-unresolved': 'off', // TypeScript handles this
+    },
+  },
+
+  // Prettier config (must be last to override formatting rules)
+  prettier,
+]);

package/presets/react/index.js

@@ -0,0 +1,10 @@
+const path = require('path');
+
+module.exports = {
+  eslint: path.resolve(__dirname, 'eslint.config.mjs'),
+  prettier: path.resolve(__dirname, '../base/prettier.js'),
+  tsconfig: path.resolve(__dirname, 'tsconfig.json'),
+  vite: path.resolve(__dirname, 'vite.config.ts'),
+  jest: path.resolve(__dirname, '../base/jest.config.js'),
+  vitest: path.resolve(__dirname, '../base/vitest.config.ts'),
+};

package/presets/react/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "../base/tsconfig.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "lib": ["ES2024", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["vite/client"],
+    "rootDir": "./"
+  },
+  "include": ["src/**/*", "**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules", "dist", "build"]
+}

package/presets/react/vite.config.ts

@@ -0,0 +1,38 @@
+// @ts-nocheck - Template file for consuming projects, peer dependencies not installed here
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, 'src'),
+    },
+  },
+  build: {
+    outDir: 'dist',
+    sourcemap: true,
+    target: 'esnext',
+    minify: 'esbuild',
+    rollupOptions: {
+      output: {
+        manualChunks: {
+          vendor: ['react', 'react-dom'],
+        },
+      },
+    },
+  },
+  server: {
+    port: 3000,
+    open: true,
+    strictPort: false,
+  },
+  preview: {
+    port: 3000,
+    strictPort: false,
+  },
+});

package/src/index.ts

@@ -0,0 +1,60 @@
+/**
+ * @sklv-labs/ts-dev-configs
+ * Unified development configurations for TypeScript projects
+ */
+
+// Note: Paths are relative to package root
+// Users can resolve them using require.resolve() or import.meta.resolve()
+
+// Preset paths (for extends in config files)
+export const presets = {
+  base: {
+    eslint: '@sklv-labs/ts-dev-configs/presets/base/eslint.config.mjs',
+    prettier: '@sklv-labs/ts-dev-configs/presets/base/prettier.js',
+    tsconfig: '@sklv-labs/ts-dev-configs/presets/base/tsconfig.json',
+    jest: '@sklv-labs/ts-dev-configs/presets/base/jest.config.js',
+    vitest: '@sklv-labs/ts-dev-configs/presets/base/vitest.config.ts',
+  },
+  react: {
+    eslint: '@sklv-labs/ts-dev-configs/presets/react/eslint.config.mjs',
+    prettier: '@sklv-labs/ts-dev-configs/presets/base/prettier.js',
+    tsconfig: '@sklv-labs/ts-dev-configs/presets/react/tsconfig.json',
+    vite: '@sklv-labs/ts-dev-configs/presets/react/vite.config.ts',
+    jest: '@sklv-labs/ts-dev-configs/presets/base/jest.config.js',
+    vitest: '@sklv-labs/ts-dev-configs/presets/base/vitest.config.ts',
+  },
+  nestjs: {
+    eslint: '@sklv-labs/ts-dev-configs/presets/nestjs/eslint.config.mjs',
+    prettier: '@sklv-labs/ts-dev-configs/presets/base/prettier.js',
+    tsconfig: '@sklv-labs/ts-dev-configs/presets/nestjs/tsconfig.json',
+    jest: '@sklv-labs/ts-dev-configs/presets/nestjs/jest.config.js',
+    vitest: '@sklv-labs/ts-dev-configs/presets/base/vitest.config.ts',
+  },
+} as const;
+
+// Config paths
+export const configs = {
+  git: {
+    lintStaged: '@sklv-labs/ts-dev-configs/configs/git/lint-staged.js',
+    commitlint: '@sklv-labs/ts-dev-configs/configs/git/commitlint.js',
+    husky: {
+      preCommit: '@sklv-labs/ts-dev-configs/configs/git/husky/pre-commit',
+      commitMsg: '@sklv-labs/ts-dev-configs/configs/git/husky/commit-msg',
+    },
+  },
+  build: {
+    vite: '@sklv-labs/ts-dev-configs/configs/build/vite.base.ts',
+    webpack: '@sklv-labs/ts-dev-configs/configs/build/webpack.base.js',
+  },
+  editor: {
+    editorconfig: '@sklv-labs/ts-dev-configs/configs/editor/.editorconfig',
+    vscode: {
+      settings: '@sklv-labs/ts-dev-configs/configs/editor/vscode/settings.json',
+      extensions: '@sklv-labs/ts-dev-configs/configs/editor/vscode/extensions.json',
+    },
+  },
+} as const;
+
+// Type definitions
+export type PresetName = 'base' | 'react' | 'nestjs';
+export type ConfigCategory = 'git' | 'build' | 'editor';