@koslibs/configs 0.2.9 → 0.2.10

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koslibs/configs",
-    "version": "0.2.9",
+    "version": "0.2.10",
     "description": "Tool for api usage within react app",
     "main": "./index.js",
     "private": false,
@@ -13,6 +13,7 @@
         "eslint",
         "playwright",
         "prettier",
+        "rstest",
         "shared",
         "tsconfig",
         "vite",
@@ -60,6 +61,14 @@
         "./eslint/react": "./eslint/react.mjs",
         "./playwright": "./playwright/index.mjs",
         "./prettier": "./prettier/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",
@@ -67,24 +76,27 @@
         "./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/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;