@sklv-labs/dev-configs 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# 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).
+
+## Unreleased
+
+First release from the [sklv-labs/ts](https://github.com/sklv-labs/ts) monorepo, replacing the
+standalone `@sklv-labs/ts-dev-configs` package.
+
+### Added
+
+- `base` and `nestjs` presets for TypeScript, ESLint, Jest and Prettier.
+- `presets/base/tsconfig.spec.json`, so non-NestJS packages no longer borrow the NestJS one.
+- ESLint plugins are now declared as real `dependencies`, so the presets resolve under pnpm's
+  strict `node_modules` layout without hoisting workarounds.
+
+### Removed
+
+- `src/index.ts` and the `presets/*/index.js` shims, which restated every path already declared
+  in `exports`. Reference the subpath exports directly.
+- The unused `react` preset and the vite / vitest / webpack / vscode configs.
+
+### Fixed
+
+- Presets no longer set `tsconfigRootDir` to their own location inside `node_modules`, which broke
+  type-checked linting for consumers.
+- Dropped rules for uninstalled plugins (`@darraghor/nestjs-typed/*`) and for
+  `@typescript-eslint/interface-name-prefix`, which no longer exists.

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,58 @@
+# @sklv-labs/dev-configs
+
+Shared TypeScript, ESLint, Prettier and Jest presets for sklv-labs projects.
+
+## Installation
+
+```bash
+pnpm add -D @sklv-labs/dev-configs eslint prettier typescript
+# add jest + ts-jest too if you use the jest presets
+```
+
+## Presets
+
+Two flavours: `base` for plain TypeScript, `nestjs` for NestJS packages (adds decorator metadata,
+`prettier/prettier` as an error, and coverage thresholds).
+
+`tsconfig.json`
+
+```json
+{
+  "extends": "@sklv-labs/dev-configs/presets/base/tsconfig.json",
+  "compilerOptions": { "outDir": "./dist", "rootDir": "./src" },
+  "include": ["src/**/*"]
+}
+```
+
+`eslint.config.mjs`
+
+```js
+import baseEslint from '@sklv-labs/dev-configs/eslint/base';
+import { defineConfig } from 'eslint/config';
+
+export default defineConfig([...baseEslint]);
+```
+
+`jest.config.js` · `.prettierrc.js` · `commitlint.config.js` · `.lintstagedrc.js`
+
+```js
+module.exports = require('@sklv-labs/dev-configs/presets/base/jest.config.js');
+module.exports = require('@sklv-labs/dev-configs/presets/base/prettier.js');
+module.exports = require('@sklv-labs/dev-configs/configs/git/commitlint.js');
+module.exports = require('@sklv-labs/dev-configs/configs/git/lint-staged.js');
+```
+
+Swap `base` for `nestjs` where a NestJS variant exists. The full list of importable paths is the
+`exports` map in `package.json`.
+
+## Notes
+
+The presets set `projectService: true` but deliberately do **not** set `tsconfigRootDir` — ESLint
+resolves it from the directory it runs in, which is what you want in a workspace.
+
+`eslint`, `prettier`, `typescript`, `jest` and `ts-jest` are peer dependencies; the ESLint plugins
+the presets import are ordinary dependencies, so they resolve under pnpm without hoisting.
+
+## License
+
+MIT

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/lint-staged.js

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@sklv-labs/dev-configs",
+  "version": "0.1.0",
+  "description": "Shared TypeScript, ESLint, Prettier and Jest presets for sklv-labs projects",
+  "keywords": [
+    "typescript",
+    "eslint",
+    "prettier",
+    "jest",
+    "config",
+    "preset",
+    "nestjs"
+  ],
+  "author": "sklv-labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sklv-labs/ts.git",
+    "directory": "packages/dev-configs"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "exports": {
+    "./presets/base/tsconfig.json": "./presets/base/tsconfig.json",
+    "./presets/base/tsconfig.spec.json": "./presets/base/tsconfig.spec.json",
+    "./presets/base/prettier.js": "./presets/base/prettier.js",
+    "./presets/base/jest.config.js": "./presets/base/jest.config.js",
+    "./presets/nestjs/tsconfig.json": "./presets/nestjs/tsconfig.json",
+    "./presets/nestjs/tsconfig.spec.json": "./presets/nestjs/tsconfig.spec.json",
+    "./presets/nestjs/jest.config.js": "./presets/nestjs/jest.config.js",
+    "./eslint/base": "./presets/base/eslint.config.mjs",
+    "./eslint/nestjs": "./presets/nestjs/eslint.config.mjs",
+    "./configs/git/commitlint.js": "./configs/git/commitlint.js",
+    "./configs/git/lint-staged.js": "./configs/git/lint-staged.js"
+  },
+  "files": [
+    "presets",
+    "configs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-prettier": "^5.5.6",
+    "globals": "^17.12.0",
+    "typescript-eslint": "^8.69.0"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0 || ^10.0.0",
+    "jest": "^30.0.0",
+    "prettier": "^3.6.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.9.0 || ^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "jest": {
+      "optional": true
+    },
+    "ts-jest": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}

package/presets/base/eslint.config.mjs

@@ -0,0 +1,97 @@
+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/**',
+      'coverage/**',
+      '*.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,
+      },
+    },
+    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/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/jest.config.js

@@ -0,0 +1,28 @@
+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,28 @@
+{
+  "$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,
+    "types": ["node"]
+  }
+}

package/presets/base/tsconfig.spec.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "types": ["node", "jest"],
+    "noEmit": true
+  },
+  "include": ["**/*.spec.ts", "**/*.test.ts"],
+  "exclude": []
+}

package/presets/nestjs/eslint.config.mjs

@@ -0,0 +1,102 @@
+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';
+import prettierPlugin from 'eslint-plugin-prettier';
+
+export default defineConfig([
+  // Base recommended configs
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+
+  // Global ignores
+  {
+    ignores: [
+      'dist/**',
+      'build/**',
+      'node_modules/**',
+      'coverage/**',
+      '*.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,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint.plugin,
+      'import-x': importPlugin,
+      prettier: prettierPlugin,
+    },
+    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/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 rules
+      'prettier/prettier': 'error',
+    },
+  },
+
+  // Prettier config (must be last to override formatting rules)
+  prettier,
+]);

package/presets/nestjs/jest.config.js

@@ -0,0 +1,33 @@
+const baseJest = require('../base/jest.config.js');
+
+module.exports = {
+  ...baseJest,
+  roots: ['<rootDir>/src'],
+  moduleNameMapper: {
+    '^src/(.*)$': '<rootDir>/src/$1',
+  },
+  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
+  transform: {
+    '^.+\\.ts$': [
+      'ts-jest',
+      {
+        tsconfig: 'tsconfig.spec.json',
+      },
+    ],
+  },
+  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,26 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "../base/tsconfig.json",
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "target": "ES2024",
+    "lib": ["ES2024"],
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "sourceMap": true,
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "strictPropertyInitialization": false,
+    "noImplicitAny": true,
+    "strictBindCallApply": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "types": ["node", "jest"]
+  },
+  "files": []
+}

package/presets/nestjs/tsconfig.spec.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "types": ["jest", "node"],
+    "noEmit": true
+  },
+  "include": ["**/*.spec.ts", "**/*.test.ts"],
+  "exclude": []
+}