@koslibs/configs 0.1.0 → 0.2.10

package/eslint/{index.ts → index.mjs}

@@ -1,74 +1,48 @@
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { FlatCompat } from '@eslint/eslintrc';
 import js from '@eslint/js';
 import tsParser from '@typescript-eslint/parser';
-import prettier from 'eslint-plugin-prettier';
 import eslintConfigPrettier from 'eslint-config-prettier';
-import tseslint from 'typescript-eslint';
 import importPlugin from 'eslint-plugin-import-helpers';
-import { defineConfig, globalIgnores } from 'eslint/config';
+import prettier from 'eslint-plugin-prettier';
 import globals from 'globals';
+import tseslint from 'typescript-eslint';
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const compat = new FlatCompat({
-    baseDirectory: __dirname,
-    recommendedConfig: js.configs.recommended,
-    allConfig: js.configs.all,
-});
-
-export default defineConfig([
-    globalIgnores(['**/node_modules', '**/wailsjs', '**/dist', '**/vite.config.ts', '**/.cache']),
-    js.configs.recommended,
-    tseslint.configs.recommended,
-    {
-        files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.mjs', '**/*.cjs'],
+import { globalIgnores } from './config.mjs';
 
-        extends: compat.extends(
-            'plugin:@typescript-eslint/recommended',
-            'plugin:storybook/recommended'
-        ),
+const ignores = ['**/node_modules', '**/wailsjs', '**/dist', '**/.cache', '**/*.json'];
+const files = ['**/*.{ts,tsx,js,jsx,mjs,cjs}'];
+const prettierFiles = ['**/*.{ts,tsx,js,jsx,mjs,cjs,json}'];
 
+export const baseEslintConfig = [
+    globalIgnores(ignores),
+    {
+        ...js.configs.recommended,
+        files,
+    },
+    ...tseslint.configs.recommended.map((config) => ({
+        ...config,
+        files: config.files ?? files,
+    })),
+    {
+        files,
         languageOptions: {
             globals: {
                 ...globals.node,
                 ...globals.browser,
                 Controller: 'readonly',
             },
-
             parser: tsParser,
             ecmaVersion: 'latest',
             sourceType: 'module',
-
             parserOptions: {
                 ecmaFeatures: {
                     jsx: true,
                 },
                 sourceType: 'module',
-                project: '../tsconfig/index.json',
-                tsconfigRootDir: __dirname,
             },
         },
-
         plugins: {
-            // @ts-ignore
             'import-helpers': importPlugin,
-            js,
-        },
-
-        settings: {
-            react: {
-                version: 'detect',
-            },
-            'import/resolver': {
-                typescript: {
-                    alwaysTryTypes: true,
-                },
-            },
         },
-
         rules: {
             'import-helpers/order-imports': [
                 'error',
@@ -78,7 +52,6 @@ export default defineConfig([
                     alphabetize: { order: 'asc', ignoreCase: true },
                 },
             ],
-
             'no-restricted-imports': [
                 'error',
                 {
@@ -119,11 +92,9 @@ export default defineConfig([
                                 'vm',
                                 'zlib',
                             ],
-
                             message: 'Use prefix node: for node packages',
                         },
                     ],
-
                     paths: [
                         {
                             name: 'node:assert',
@@ -142,14 +113,12 @@ export default defineConfig([
             '@typescript-eslint/ban-ts-ignore': 'off',
             '@typescript-eslint/ban-ts-comment': 'off',
             '@typescript-eslint/no-explicit-any': 'error',
-
             '@typescript-eslint/no-empty-function': [
                 'error',
                 {
                     allow: ['arrowFunctions'],
                 },
             ],
-
             '@typescript-eslint/no-unused-vars': [
                 'error',
                 {
@@ -159,25 +128,12 @@ export default defineConfig([
                     caughtErrorsIgnorePattern: '^error',
                 },
             ],
-
-            // '@typescript-eslint/ban-types': [
-            //     'error',
-            //     {
-            //         extendDefaults: true,
-
-            //         types: {
-            //             '{}': false,
-            //         },
-            //     },
-            // ],
-
             '@typescript-eslint/consistent-type-imports': [
                 'error',
                 {
                     fixStyle: 'inline-type-imports',
                 },
             ],
-
             'no-cond-assign': 'error',
             'no-control-regex': 'error',
             'no-debugger': 'error',
@@ -195,7 +151,6 @@ export default defineConfig([
             'no-unreachable': 'error',
             'no-unreachable-loop': 'error',
             'no-var': 'error',
-
             'no-multiple-empty-lines': [
                 'error',
                 {
@@ -203,16 +158,13 @@ export default defineConfig([
                     maxEOF: 1,
                 },
             ],
-
             'no-unsafe-negation': 'error',
-
             'no-console': [
                 'error',
                 {
                     allow: ['info', 'error'],
                 },
             ],
-
             'no-use-before-define': 'off',
             'no-shadow': 'off',
             'no-const-assign': 'error',
@@ -266,7 +218,6 @@ export default defineConfig([
             quotes: ['error', 'single'],
             'object-curly-spacing': [1, 'always'],
             'default-case': 'error',
-
             'comma-dangle': [
                 'error',
                 {
@@ -277,20 +228,16 @@ export default defineConfig([
                     objects: 'always-multiline',
                 },
             ],
-
             'max-params': [2, 6],
             'max-nested-callbacks': ['error', 3],
             'brace-style': 'error',
-
             camelcase: [
                 'error',
                 {
                     properties: 'never',
                 },
             ],
-
             'new-parens': 'error',
-
             'max-len': [
                 'error',
                 {
@@ -306,11 +253,12 @@ export default defineConfig([
         },
     },
     {
-        files: ['**/*.ts', '**/*.tsx'],
+        files: prettierFiles,
         plugins: {
             prettier,
-            // @ts-ignore
-            rules: [
+        },
+        rules: {
+            'prettier/prettier': [
                 'error',
                 {
                     trailingComma: 'es5',
@@ -325,4 +273,6 @@ export default defineConfig([
         },
     },
     eslintConfigPrettier,
-]);
+];
+
+export default baseEslintConfig;

package/eslint/react.mjs

@@ -0,0 +1,11 @@
+export const reactConfig = {
+    name: 'koslibs-lint/react',
+    settings: {
+        react: {
+            pragma: 'React',
+            version: 'detect',
+        },
+    },
+};
+
+export default reactConfig;

package/eslint.config.mjs

@@ -0,0 +1,4 @@
+import { defineConfig } from './eslint/config.mjs';
+import eslintConfig from './eslint/index.mjs';
+
+export default defineConfig(eslintConfig);

package/index.js

@@ -0,0 +1,7 @@
+export { default as eslintConfig } from './eslint/index.mjs';
+export { default as playwrightConfig } from './playwright/index.mjs';
+export { default as prettierConfig } from './prettier/index.js';
+export { default as viteConfig } from './vite/index.mjs';
+
+export { createPlaywrightConfig } from './playwright/index.mjs';
+export { createViteConfig } from './vite/index.mjs';

package/package.json

@@ -1,21 +1,39 @@
 {
     "name": "@koslibs/configs",
-    "version": "0.1.0",
+    "version": "0.2.10",
     "description": "Tool for api usage within react app",
-    "main": "index.js",
+    "main": "./index.js",
     "private": false,
     "license": "MIT",
     "author": "holypower777",
     "type": "module",
+    "files": [
+        "cli",
+        "commitlint",
+        "eslint",
+        "playwright",
+        "prettier",
+        "rstest",
+        "shared",
+        "tsconfig",
+        "vite",
+        "index.js",
+        "eslint.config.mjs",
+        "LICENSE"
+    ],
+    "bin": {
+        "koslibs-lint": "cli/lint.js"
+    },
     "scripts": {
         "lint": "npm run lint:js && npm run format:check",
         "lint:fix": "npm run lint:js --fix && npm run format",
-        "lint:js": "node ./cli/index.mjs js",
-        "format": "node ./cli/index.mjs format",
-        "format:check": "node ./cli/index.mjs format:check",
+        "lint:js": "node ./cli/lint.js js",
+        "format": "node ./cli/lint.js format",
+        "format:check": "node ./cli/lint.js format:check",
         "release": "changeset publish",
         "release:snapshot": "changeset publish --tag snapshot --no-git-tag",
         "version-package": "changeset version",
+        "version-package:patch": "npm version patch --no-git-tag-version",
         "version-package:snapshot": "changeset version --snapshot snapshot"
     },
     "bugs": {
@@ -24,7 +42,10 @@
     "homepage": "https://github.com/koslibs/configs",
     "repository": {
         "type": "git",
-        "url": "https://github.com/koslibs/configs"
+        "url": "git+https://github.com/koslibs/configs.git"
+    },
+    "publishConfig": {
+        "access": "public"
     },
     "engines": {
         "node": ">=22.14.0"
@@ -33,33 +54,49 @@
     "commitlint": {
         "extends": "./commitlint"
     },
-    "eslintConfig": {
-        "extends": "./eslint"
-    },
     "exports": {
+        ".": "./index.js",
         "./eslint": "./eslint/index.mjs",
+        "./eslint/config": "./eslint/config.mjs",
+        "./eslint/react": "./eslint/react.mjs",
+        "./playwright": "./playwright/index.mjs",
         "./prettier": "./prettier/index.js",
-        "./commitlint": "./commitlint/index.js"
+        "./rstest": {
+            "types": "./rstest/index.d.ts",
+            "default": "./rstest/index.mjs"
+        },
+        "./rstest/react": {
+            "types": "./rstest/react.d.ts",
+            "default": "./rstest/react.mjs"
+        },
+        "./commitlint": "./commitlint/index.js",
+        "./tsconfig": "./tsconfig/index.json",
+        "./tsconfig/base": "./tsconfig/base.json",
+        "./tsconfig/node": "./tsconfig/node.json",
+        "./vite": "./vite/index.mjs"
     },
     "dependencies": {
-        "@commitlint/cli": "20.3.1",
         "@commitlint/config-conventional": "20.3.1",
-        "@eslint/eslintrc": "3.3.1",
         "@eslint/js": "9.36.0",
+        "@rsbuild/plugin-react": "2.1.1",
+        "@rstest/core": "0.12.2",
+        "@typescript-eslint/parser": "8.44.0",
         "eslint": "9.36.0",
         "eslint-config-prettier": "10.1.8",
         "eslint-plugin-import-helpers": "2.0.1",
         "eslint-plugin-prettier": "5.5.4",
         "eslint-plugin-storybook": "0.11.2",
         "globals": "16.4.0",
-        "lefthook": "2.0.13",
+        "happy-dom": "20.14.5",
         "prettier": "3.6.2",
         "typescript": "5.7.2",
         "typescript-eslint": "8.44.0"
     },
     "devDependencies": {
-        "@changesets/changelog-github": "^0.5.2",
-        "@changesets/cli": "^2.29.8",
-        "@types/node": "^24.4.0"
+        "@changesets/changelog-github": "0.5.2",
+        "@changesets/cli": "2.29.8",
+        "@commitlint/cli": "20.3.1",
+        "@types/node": "24.10.4",
+        "lefthook": "2.0.13"
     }
 }

package/playwright/index.mjs

@@ -0,0 +1,23 @@
+import mergeConfig from '../shared/merge-config.mjs';
+
+const defaultReporter = process.env.CI
+    ? [['github'], ['html', { open: 'never' }]]
+    : [['html', { open: 'never' }]];
+
+export const playwrightConfig = {
+    testDir: './playwright',
+    fullyParallel: true,
+    forbidOnly: Boolean(process.env.CI),
+    retries: process.env.CI ? 2 : 0,
+    workers: process.env.CI ? 1 : undefined,
+    reporter: defaultReporter,
+    use: {
+        trace: 'on-first-retry',
+        screenshot: 'only-on-failure',
+        video: 'retain-on-failure',
+    },
+};
+
+export const createPlaywrightConfig = (overrides = {}) => mergeConfig(playwrightConfig, overrides);
+
+export default playwrightConfig;

package/rstest/README.md

@@ -0,0 +1,67 @@
+# Rstest presets
+
+## Libraries (Node environment)
+
+Install `@koslibs/configs` as a development dependency, then create `rstest.config.mjs`.
+The package installs pinned versions of Rstest and its preset dependencies:
+
+```js
+import { createRstestConfig } from '@koslibs/configs/rstest';
+
+export default createRstestConfig({
+    include: ['src/**/*.test.ts'],
+});
+```
+
+## React applications and component libraries
+
+The React plugin and `happy-dom` are included in `@koslibs/configs` dependencies.
+React and React DOM belong to the consuming project.
+
+```js
+import { createReactRstestConfig } from '@koslibs/configs/rstest/react';
+
+export default createReactRstestConfig({
+    include: ['src/**/*.test.{ts,tsx}'],
+    setupFiles: ['./rstest.setup.ts'],
+});
+```
+
+The React preset enables JSX through the React plugin and uses a simulated DOM.
+It does not run browser, screenshot or Playwright tests. Keep their file patterns
+separate from unit tests using `include` / `exclude` in the consuming project.
+
+For Testing Library, install `@testing-library/react` and
+`@testing-library/jest-dom` and create the optional setup file:
+
+```ts
+import { afterEach, expect } from '@rstest/core';
+import { cleanup } from '@testing-library/react';
+import * as matchers from '@testing-library/jest-dom/matchers';
+
+expect.extend(matchers);
+afterEach(() => cleanup());
+```
+
+## Defaults and overrides
+
+Both presets use explicit test imports (`globals: false`), clear mock histories,
+restore spies between tests and fail when no tests are found. Coverage is opt-in
+with `rstest run --coverage`; reports use text, HTML and LCOV. No coverage threshold
+or automatic retry is imposed. Use `rstest run` in CI and `rstest` locally.
+
+Factories follow the shared configuration merge convention: nested objects merge,
+arrays append, and scalar values override. Additional React plugins append after
+the built-in React plugin. Paths are relative to the consuming project. Configure
+aliases, setup files, test patterns and coverage thresholds locally.
+
+Rstest, the React plugin and `happy-dom` are installed for every consumer, with
+exact versions managed by `@koslibs/configs`. Import the React preset through
+`/rstest/react` explicitly. Package managers with strict dependency isolation may
+still require a direct `@rstest/core` dependency when tests import from it or
+project scripts invoke its CLI; use the same version declared by this package.
+
+Types are verified with TypeScript's `moduleResolution: "Bundler"`. With the tested
+Rstest 0.12.2 dependency tree, `NodeNext` and `skipLibCheck: false` report TS1479 in
+Rsbuild's bundled plugin declarations. For configuration files using NodeNext,
+`skipLibCheck: true` avoids checking those third-party declarations.

package/rstest/index.d.ts

@@ -0,0 +1,5 @@
+import type { RstestConfig } from '@rstest/core';
+
+export declare const rstestConfig: RstestConfig;
+export declare const createRstestConfig: (overrides?: RstestConfig) => RstestConfig;
+export default rstestConfig;

package/rstest/index.mjs

@@ -0,0 +1,16 @@
+import mergeConfig from '../shared/merge-config.mjs';
+
+export const rstestConfig = {
+    testEnvironment: 'node',
+    globals: false,
+    clearMocks: true,
+    restoreMocks: true,
+    passWithNoTests: false,
+    coverage: {
+        reporters: ['text', 'html', 'lcov'],
+    },
+};
+
+export const createRstestConfig = (overrides = {}) => mergeConfig(rstestConfig, overrides);
+
+export default rstestConfig;

package/rstest/react.d.ts

@@ -0,0 +1,5 @@
+import type { RstestConfig } from '@rstest/core';
+
+export declare const reactRstestConfig: RstestConfig;
+export declare const createReactRstestConfig: (overrides?: RstestConfig) => RstestConfig;
+export default reactRstestConfig;

package/rstest/react.mjs

@@ -0,0 +1,14 @@
+import { pluginReact } from '@rsbuild/plugin-react';
+
+import { createRstestConfig } from './index.mjs';
+
+export const createReactRstestConfig = (overrides = {}) =>
+    createRstestConfig({
+        testEnvironment: 'happy-dom',
+        ...overrides,
+        plugins: [pluginReact(), ...(overrides.plugins ?? [])],
+    });
+
+export const reactRstestConfig = createReactRstestConfig();
+
+export default reactRstestConfig;

package/shared/merge-config.mjs

@@ -0,0 +1,41 @@
+const isPlainObject = (value) => Object.prototype.toString.call(value) === '[object Object]';
+
+const cloneValue = (value) => {
+    if (Array.isArray(value)) {
+        return value.map(cloneValue);
+    }
+
+    if (isPlainObject(value)) {
+        return Object.fromEntries(
+            Object.entries(value).map(([key, nestedValue]) => [key, cloneValue(nestedValue)])
+        );
+    }
+
+    return value;
+};
+
+const mergeValue = (target, source) => {
+    if (Array.isArray(target) && Array.isArray(source)) {
+        return [...target, ...source];
+    }
+
+    if (isPlainObject(target) && isPlainObject(source)) {
+        const nextValue = { ...target };
+
+        for (const [key, nestedValue] of Object.entries(source)) {
+            nextValue[key] =
+                key in nextValue
+                    ? mergeValue(nextValue[key], nestedValue)
+                    : cloneValue(nestedValue);
+        }
+
+        return nextValue;
+    }
+
+    return cloneValue(source);
+};
+
+export const mergeConfig = (...parts) =>
+    parts.filter(Boolean).reduce((mergedValue, part) => mergeValue(mergedValue, part), {});
+
+export default mergeConfig;

package/tsconfig/base.json

@@ -0,0 +1,15 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "useDefineForClassFields": true,
+        "allowJs": false,
+        "skipLibCheck": true,
+        "esModuleInterop": false,
+        "allowSyntheticDefaultImports": true,
+        "strict": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "isolatedModules": true,
+        "noEmit": true
+    }
+}

package/tsconfig/index.json

@@ -1,29 +1,9 @@
 {
+    "extends": "./base.json",
     "compilerOptions": {
-        "target": "ESNext",
-        "useDefineForClassFields": true,
         "lib": ["DOM", "DOM.Iterable", "ESNext"],
-        "allowJs": false,
-        "skipLibCheck": true,
-        "esModuleInterop": false,
-        "allowSyntheticDefaultImports": true,
-        "strict": true,
-        "forceConsistentCasingInFileNames": true,
         "module": "ESNext",
-        "moduleResolution": "Node",
-        "resolveJsonModule": true,
-        "isolatedModules": true,
-        "noEmit": true,
+        "moduleResolution": "Bundler",
         "jsx": "react-jsx"
-    },
-    "include": [
-        "src",
-        ".storybook/**/*",
-        "eslint.config.mjs",
-        "prettier.config.mjs",
-        "playwright/**/*.tsx",
-        "playwright-ct.config.ts",
-        "playwright.config.ts",
-        "**/*.spec.tsx"
-    ]
+    }
 }

package/tsconfig/node.json

@@ -0,0 +1,9 @@
+{
+    "extends": "./base.json",
+    "compilerOptions": {
+        "lib": ["ES2022"],
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "types": ["node"]
+    }
+}

package/vite/index.mjs

@@ -0,0 +1,18 @@
+import mergeConfig from '../shared/merge-config.mjs';
+
+export const viteConfig = {
+    server: {
+        host: true,
+        port: 5173,
+        strictPort: true,
+    },
+    preview: {
+        host: true,
+        port: 4173,
+        strictPort: true,
+    },
+};
+
+export const createViteConfig = (overrides = {}) => mergeConfig(viteConfig, overrides);
+
+export default viteConfig;

package/.changeset/README.md

@@ -1,8 +0,0 @@
-# Changesets
-
-Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
-with multi-package repos, or single-package repos to help you version and publish your code. You can
-find the full documentation for it [in our repository](https://github.com/changesets/changesets)
-
-We have a quick list of common questions to get you started engaging with this project in
-[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/.changeset/config.json

@@ -1,15 +0,0 @@
-{
-    "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
-    "changelog": ["@changesets/changelog-github", { "repo": "koslibs/configs" }],
-    "commit": false,
-    "fixed": [],
-    "linked": [],
-    "access": "public",
-    "baseBranch": "main",
-    "updateInternalDependencies": "patch",
-    "ignore": [],
-    "snapshot": {
-        "prereleaseTemplate": "{tag}-{commit}",
-        "useCalculatedVersion": true
-    }
-}

package/eslint.config.js

@@ -1,4 +0,0 @@
-import { defineConfig } from './eslint/config';
-import { eslintConfig } from './eslint';
-
-export default defineConfig(eslintConfig);

package/lefthook/index.yml

@@ -1,16 +0,0 @@
-#   Refer for explanation to following link:
-#   https://lefthook.dev/configuration/
-
-pre-commit:
-    parallel: true
-    commands:
-        check-scripts:
-            glob: '*.{js,ts,jsx,tsx,mts,mjs,cjs,cts,ctsx,mtsx,cjsx,mjsx}'
-            run: npx --no-install prettier --write {staged_files} --cache && npx --no-install eslint {staged_files} --no-warn-ignored && git add {staged_files}
-        check-json:
-            glob: '*.{json}'
-            run: npx --no-install prettier --write {staged_files} --cache && git add {staged_files}
-commit-msg:
-    commands:
-        commitlint:
-            run: npx --no-install commitlint --edit {1}