@krutoo/presets 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dmitriy Petrov
+
+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,69 @@
+# Presets
+
+Set of presets for format/lint/test/build etc.
+
+## Install
+
+```sh
+npm add -D @krutoo/presets
+```
+
+## Usage
+
+### ESLint
+
+```ts
+// eslint.config.{js,ts}
+import preset from '@krutoo/presets/eslint';
+
+export default [
+  ...preset,
+  // ...optionally your overrides and other configs
+];
+```
+
+### Prettier
+
+When using JS/TS:
+
+```ts
+// prettier.config.{js,ts}
+export { default } from '@krutoo/presets/prettier';
+```
+
+When using JSON:
+
+```jsonc
+// .prettierrc.json
+"@krutoo/presets/prettier"
+```
+
+### TypeScript
+
+For static analysis in your editor/IDE and for `tsc -p . --noEmit`:
+
+```jsonc
+// tsconfig.json
+{
+  "extends": "@krutoo/presets/tsconfig.check.json",
+}
+```
+
+This preset will check all files in your project root, where `tsconfig.json` placed.
+
+---
+
+For build your package via `tsc -p tsconfig.build.json`:
+
+```jsonc
+// tsconfig.build.json
+{
+  "extends": "@krutoo/presets/tsconfig.build.json",
+}
+```
+
+This preset will try to build from `src` folder to `dist` folder.
+
+### To Do
+
+- `bin` to use like `npx presets --init --all` for automatically create config files

package/dist/eslint.d.ts

@@ -0,0 +1,4 @@
+import { type Config } from 'eslint/config';
+
+declare const configs: Config[];
+export default configs;

package/dist/eslint.js

@@ -0,0 +1,125 @@
+import path from 'node:path';
+import { includeIgnoreFile } from '@eslint/compat';
+import pluginJs from '@eslint/js';
+import confusingBrowserGlobals from 'confusing-browser-globals';
+import pluginJSDoc from 'eslint-plugin-jsdoc';
+import pluginReact from 'eslint-plugin-react';
+import pluginReactHooks from 'eslint-plugin-react-hooks';
+import { defineConfig } from 'eslint/config';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+// @todo сделать namespace с отдельными config'ами чтобы можно было точечно подключать?
+// @todo сделать функцию с настройками вроде preset({ gitignore: false, react: false })?
+const gitignorePath = path.resolve(process.cwd(), '.gitignore');
+const configs = defineConfig([
+  // Global ignores
+  includeIgnoreFile(gitignorePath, 'Imported .gitignore patterns'),
+  // Basics
+  {
+    files: ['**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'],
+  },
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+  },
+  pluginJs.configs.recommended,
+  tseslint.configs.recommended,
+  {
+    rules: {
+      'object-shorthand': 'error',
+      'no-console': 'error',
+      eqeqeq: 'error',
+      'no-param-reassign': 'error',
+      'no-restricted-globals': ['error', { globals: confusingBrowserGlobals }],
+      '@typescript-eslint/no-explicit-any': 'error',
+      'no-shadow': 'off',
+      '@typescript-eslint/no-shadow': 'error',
+      '@typescript-eslint/no-empty-object-type': [
+        'error',
+        {
+          allowInterfaces: 'always',
+        },
+      ],
+    },
+  },
+  // CommonJS
+  {
+    files: ['**/*.{cjs,cts}'],
+    rules: {
+      '@typescript-eslint/no-require-imports': 'off',
+    },
+  },
+  // React
+  pluginReact.configs.flat.recommended,
+  pluginReact.configs.flat['jsx-runtime'],
+  {
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+    rules: {
+      'react/prop-types': 'off',
+      'react/jsx-curly-brace-presence': 'warn',
+    },
+  },
+  // React hooks
+  pluginReactHooks.configs.flat['recommended-latest'],
+  {
+    rules: {
+      'react-hooks/rules-of-hooks': 'error',
+      'react-hooks/exhaustive-deps': [
+        'warn',
+        {
+          additionalHooks: '(useIsomorphicLayoutEffect)',
+        },
+      ],
+      // next rules are disabled because it downgrades DX of creating components
+      'react-hooks/immutability': 'off',
+      'react-hooks/refs': 'off',
+      'react-hooks/set-state-in-effect': 'off',
+      'react-hooks/use-memo': 'off',
+    },
+  },
+  // JSDoc
+  pluginJSDoc.configs['flat/recommended'],
+  {
+    rules: {
+      'jsdoc/require-description-complete-sentence': 'warn',
+      'jsdoc/require-param': [
+        'warn',
+        {
+          checkDestructured: false,
+        },
+      ],
+      'jsdoc/check-param-names': [
+        'warn',
+        {
+          checkDestructured: false,
+        },
+      ],
+      'jsdoc/require-jsdoc': 'error',
+      'jsdoc/tag-lines': 'off',
+      // no types required in JSDoc because TS types is preferred
+      'jsdoc/require-param-type': 'off',
+      'jsdoc/require-property-type': 'off',
+      'jsdoc/require-returns-type': 'off',
+      'jsdoc/require-yields-type': 'off',
+      'jsdoc/require-throws-type': 'off',
+    },
+  },
+  {
+    // no require JSDoc in tests
+    files: ['**/*.{test,spec}.{js,mjs,cjs,ts,jsx,tsx}'],
+    rules: {
+      'jsdoc/require-jsdoc': 'off',
+    },
+  },
+]);
+export default configs;
+//# sourceMappingURL=eslint.js.map

package/dist/eslint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.js","sourceRoot":"","sources":["../src/eslint.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path';\nimport { includeIgnoreFile } from '@eslint/compat';\nimport pluginJs from '@eslint/js';\nimport confusingBrowserGlobals from 'confusing-browser-globals';\nimport pluginJSDoc from 'eslint-plugin-jsdoc';\nimport pluginReact from 'eslint-plugin-react';\nimport pluginReactHooks from 'eslint-plugin-react-hooks';\nimport { type Config, defineConfig } from 'eslint/config';\nimport globals from 'globals';\nimport tseslint from 'typescript-eslint';\n\n// @todo сделать namespace с отдельными config'ами чтобы можно было точечно подключать?\n// @todo сделать функцию с настройками вроде preset({ gitignore: false, react: false })?\n\nconst gitignorePath = path.resolve(process.cwd(), '.gitignore');\n\nconst configs: Config[] = defineConfig([\n  // Global ignores\n  includeIgnoreFile(gitignorePath, 'Imported .gitignore patterns'),\n\n  // Basics\n  {\n    files: ['**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'],\n  },\n  {\n    languageOptions: {\n      globals: {\n        ...globals.browser,\n        ...globals.node,\n      },\n    },\n  },\n  pluginJs.configs.recommended,\n  tseslint.configs.recommended,\n  {\n    rules: {\n      'object-shorthand': 'error',\n      'no-console': 'error',\n      eqeqeq: 'error',\n      'no-param-reassign': 'error',\n      'no-restricted-globals': ['error', { globals: confusingBrowserGlobals }],\n      '@typescript-eslint/no-explicit-any': 'error',\n      'no-shadow': 'off',\n      '@typescript-eslint/no-shadow': 'error',\n      '@typescript-eslint/no-empty-object-type': [\n        'error',\n        {\n          allowInterfaces: 'always',\n        },\n      ],\n    },\n  },\n\n  // CommonJS\n  {\n    files: ['**/*.{cjs,cts}'],\n    rules: {\n      '@typescript-eslint/no-require-imports': 'off',\n    },\n  },\n\n  // React\n  pluginReact.configs.flat.recommended!,\n  pluginReact.configs.flat['jsx-runtime']!,\n  {\n    settings: {\n      react: {\n        version: 'detect',\n      },\n    },\n    rules: {\n      'react/prop-types': 'off',\n      'react/jsx-curly-brace-presence': 'warn',\n    },\n  },\n\n  // React hooks\n  pluginReactHooks.configs.flat['recommended-latest'],\n  {\n    rules: {\n      'react-hooks/rules-of-hooks': 'error',\n      'react-hooks/exhaustive-deps': [\n        'warn',\n        {\n          additionalHooks: '(useIsomorphicLayoutEffect)',\n        },\n      ],\n\n      // next rules are disabled because it downgrades DX of creating components\n      'react-hooks/immutability': 'off',\n      'react-hooks/refs': 'off',\n      'react-hooks/set-state-in-effect': 'off',\n      'react-hooks/use-memo': 'off',\n    },\n  },\n\n  // JSDoc\n  pluginJSDoc.configs['flat/recommended'],\n  {\n    rules: {\n      'jsdoc/require-description-complete-sentence': 'warn',\n      'jsdoc/require-param': [\n        'warn',\n        {\n          checkDestructured: false,\n        },\n      ],\n      'jsdoc/check-param-names': [\n        'warn',\n        {\n          checkDestructured: false,\n        },\n      ],\n      'jsdoc/require-jsdoc': 'error',\n      'jsdoc/tag-lines': 'off',\n\n      // no types required in JSDoc because TS types is preferred\n      'jsdoc/require-param-type': 'off',\n      'jsdoc/require-property-type': 'off',\n      'jsdoc/require-returns-type': 'off',\n      'jsdoc/require-yields-type': 'off',\n      'jsdoc/require-throws-type': 'off',\n    },\n  },\n  {\n    // no require JSDoc in tests\n    files: ['**/*.{test,spec}.{js,mjs,cjs,ts,jsx,tsx}'],\n    rules: {\n      'jsdoc/require-jsdoc': 'off',\n    },\n  },\n]);\n\nexport default configs;\n"]}

package/dist/prettier.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from 'prettier';
+
+declare const config: Config;
+export default config;

package/dist/prettier.js

@@ -0,0 +1,29 @@
+const config = {
+  arrowParens: 'avoid',
+  bracketSpacing: true,
+  jsxSingleQuote: true,
+  printWidth: 100,
+  semi: true,
+  singleQuote: true,
+  tabWidth: 2,
+  trailingComma: 'all',
+  plugins: ['@trivago/prettier-plugin-sort-imports'],
+  // plugin sort imports:
+  importOrderSortSpecifiers: true,
+  importOrderSeparation: false,
+  importOrder: [
+    // builtin modules:
+    '^node:', // @todo как быть с deno:, npm:, bun: и тд?
+    // packages:
+    '^react',
+    '<THIRD_PARTY_MODULES>',
+    // project aliases:
+    '^#(.*)$',
+    // any other relative/absolute path that are not styles
+    '^[./]((?!.css$).)*$',
+    // styles
+    '\\.css$',
+  ],
+};
+export default config;
+//# sourceMappingURL=prettier.js.map

package/dist/prettier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettier.js","sourceRoot":"","sources":["../src/prettier.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAW;IACrB,WAAW,EAAE,OAAO;IACpB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,GAAG;IACf,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,IAAI;IACjB,QAAQ,EAAE,CAAC;IACX,aAAa,EAAE,KAAK;IACpB,OAAO,EAAE,CAAC,uCAAuC,CAAC;IAElD,uBAAuB;IACvB,yBAAyB,EAAE,IAAI;IAC/B,qBAAqB,EAAE,KAAK;IAC5B,WAAW,EAAE;QACX,mBAAmB;QACnB,QAAQ,EAAE,2CAA2C;QAErD,YAAY;QACZ,QAAQ;QACR,uBAAuB;QAEvB,mBAAmB;QACnB,SAAS;QAET,uDAAuD;QACvD,qBAAqB;QAErB,SAAS;QACT,SAAS;KACV;CACF,CAAC;AAEF,eAAe,MAAM,CAAC","sourcesContent":["import type { Config } from 'prettier';\n\nconst config: Config = {\n  arrowParens: 'avoid',\n  bracketSpacing: true,\n  jsxSingleQuote: true,\n  printWidth: 100,\n  semi: true,\n  singleQuote: true,\n  tabWidth: 2,\n  trailingComma: 'all',\n  plugins: ['@trivago/prettier-plugin-sort-imports'],\n\n  // plugin sort imports:\n  importOrderSortSpecifiers: true,\n  importOrderSeparation: false,\n  importOrder: [\n    // builtin modules:\n    '^node:', // @todo как быть с deno:, npm:, bun: и тд?\n\n    // packages:\n    '^react',\n    '<THIRD_PARTY_MODULES>',\n\n    // project aliases:\n    '^#(.*)$',\n\n    // any other relative/absolute path that are not styles\n    '^[./]((?!.css$).)*$',\n\n    // styles\n    '\\\\.css$',\n  ],\n};\n\nexport default config;\n"]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@krutoo/presets",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "Configs and other presets",
+  "author": "Dmitriy Petrov <dima.krutoo@yandex.ru>",
+  "license": "MIT",
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": ">=24.14.0",
+      "onFail": "error"
+    },
+    "packageManager": {
+      "name": "npm",
+      "version": ">=10.9.3",
+      "onFail": "error"
+    }
+  },
+  "scripts": {
+    "check": "tsc -p . --noEmit",
+    "fmt": "prettier . --write",
+    "build": "node scripts/build.ts"
+  },
+  "devDependencies": {
+    "@types/confusing-browser-globals": "^1.0.3",
+    "@types/node": "^24.12.2",
+    "eslint": "^9.39.4",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "@eslint/compat": "^2.0.5",
+    "@eslint/js": "^9 || ^10",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+    "confusing-browser-globals": "^1.0.11",
+    "eslint": "^9 || ^10",
+    "eslint-plugin-jsdoc": "^62.9.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "prettier": "^3.8.2",
+    "typescript": "^5 || ^6",
+    "typescript-eslint": "^8.58.1"
+  },
+  "peerDependenciesMeta": {
+    "@eslint/js": {
+      "optional": true
+    },
+    "eslint": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    },
+    "prettier": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "dist",
+    "public"
+  ],
+  "exports": {
+    "./eslint": "./dist/eslint.js",
+    "./prettier": "./dist/prettier.js",
+    "./tsconfig.build.json": "./public/tsconfig.build.json",
+    "./tsconfig.check.json": "./public/tsconfig.check.json"
+  },
+  "sideEffects": false
+}

package/public/tsconfig.build.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig.check.json",
+  "compilerOptions": {
+    // project:
+    "rootDir": "${configDir}/src", // build only src folder
+
+    // emit:
+    "noEmit": false,
+    "outDir": "${configDir}/dist",
+    "declaration": true,
+    "sourceMap": true,
+    "inlineSources": true
+  },
+  "include": ["${configDir}/src"], // build only src folder
+  "exclude": ["**/node_modules", "${configDir}/dist", "**/*.{test,spec}.*"] // exclude from build dependencies, tests and compilation result
+}

package/public/tsconfig.check.json

@@ -0,0 +1,38 @@
+{
+  "compilerOptions": {
+    // project:
+    "rootDir": "${configDir}", // check all files in directory where your tsconfig placed
+    "target": "esnext",
+    "module": "nodenext", // for ability to run compiled code directly in Node.js (without bundlers)
+    "types": ["node"],
+    "lib": ["ESNext", "DOM", "DOM.Iterable", "DOM.AsyncIterable"],
+    "jsx": "react-jsx", // targets to modern React with automatic JSX runtime
+
+    // emit:
+    "noEmit": true,
+    "outDir": "${configDir}/dist", // compiled files will be in dist folder
+    "declaration": true,
+    "sourceMap": true,
+    "inlineSources": true,
+    "rewriteRelativeImportExtensions": true, // compiled code will have correct paths (`import './a.ts'` >> `import './a.js'`)
+
+    // code style:
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "forceConsistentCasingInFileNames": true,
+
+    // recommended:
+    "strict": true,
+    "moduleDetection": "force",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true, // ban import some side effect without type declaration
+    "noUncheckedIndexedAccess": true,
+    "allowImportingTsExtensions": true, // for ability to have correct import paths
+    "verbatimModuleSyntax": true, // requires to import types with `type` keyword
+    "erasableSyntaxOnly": true, // no enums, namespaces, parameter properties, etc.
+    "isolatedDeclarations": true // make code comply with the "no-slow-types" rule from JSR
+  },
+  "exclude": ["**/node_modules", "${configDir}/dist"]
+}