refactor: removes type definitions

.mocharc.cjs

@@ -1,4 +0,0 @@
-module.exports = {
-  extension: ['js'],
-  spec: 'src/**/*.spec.js',
-}

.mocharc.json

@@ -0,0 +1,4 @@
+{
+  "extension": ["js"],
+  "spec": "src/**/*.spec.js"
+}

README.md

@@ -36,12 +36,12 @@ npm install @e22m4u/js-spy
 
 *ESM*
 ```js
-import {createSpy, createSpiesGroup} from '@e22m4u/js-spy';
+import {createSpy} from '@e22m4u/js-spy';
 ```
 
 *CommonJS*
 ```js
-const {createSpy, createSpiesGroup} = require('@e22m4u/js-spy');
+const {createSpy} = require('@e22m4u/js-spy');
 ```
 
 ## Использование

build-cjs.js

@@ -1,15 +1,12 @@
-import {rmSync} from 'node:fs';
 import * as esbuild from 'esbuild';
 import packageJson from './package.json' with {type: 'json'};
 
-rmSync('./dist/cjs', {recursive: true, force: true});
-
 await esbuild.build({
   entryPoints: ['src/index.js'],
   outfile: 'dist/cjs/index.cjs',
   format: 'cjs',
   platform: 'node',
-  target: ['node18'],
+  target: ['node12'],
   bundle: true,
   keepNames: true,
   external: [

dist/cjs/index.cjs

@@ -171,10 +171,7 @@ function createSpy(target = void 0, methodNameOrImpl = void 0, customImplForMeth
 __name(createSpy, "createSpy");
 
 // src/create-spies-group.js
-var SpiesGroup = class {
-  static {
-    __name(this, "SpiesGroup");
-  }
+var _SpiesGroup = class _SpiesGroup {
   /**
    * Constructor.
    */
@@ -185,9 +182,10 @@ var SpiesGroup = class {
    * Создает шпиона для отдельной функции
    * или метода объекта и добавляет его в группу.
    *
-   * @param target
-   * @param methodNameOrImpl
-   * @param customImplForMethod
+   * @param {Function|object} target
+   * @param {Function|string} [methodNameOrImpl]
+   * @param {Function} [customImplForMethod]
+   * @returns {Function}
    */
   on(target, methodNameOrImpl, customImplForMethod) {
     const spy = createSpy(target, methodNameOrImpl, customImplForMethod);
@@ -199,6 +197,8 @@ var SpiesGroup = class {
    * для которых были созданы шпионы в этой группе,
    * и сброс истории вызовов для всех шпионов в группе.
    * Очищает внутренний список шпионов.
+   *
+   * @returns {SpiesGroup}
    */
   restore() {
     this.spies.forEach((spy) => spy.restore());
@@ -206,6 +206,8 @@ var SpiesGroup = class {
     return this;
   }
 };
+__name(_SpiesGroup, "SpiesGroup");
+var SpiesGroup = _SpiesGroup;
 function createSpiesGroup() {
   return new SpiesGroup();
 }

eslint.config.js

@@ -1,6 +1,8 @@
 import globals from 'globals';
 import eslintJs from '@eslint/js';
+import eslintJsdocPlugin from 'eslint-plugin-jsdoc';
 import eslintMochaPlugin from 'eslint-plugin-mocha';
+import eslintImportPlugin from 'eslint-plugin-import';
 import eslintPrettierConfig from 'eslint-config-prettier';
 import eslintChaiExpectPlugin from 'eslint-plugin-chai-expect';
 
@@ -14,16 +16,25 @@ export default [{
     },
   },
   plugins: {
+    'jsdoc': eslintJsdocPlugin,
     'mocha': eslintMochaPlugin,
+    'import': eslintImportPlugin,
     'chai-expect': eslintChaiExpectPlugin,
   },
   rules: {
     ...eslintJs.configs.recommended.rules,
     ...eslintPrettierConfig.rules,
+    ...eslintImportPlugin.flatConfigs.recommended.rules,
     ...eslintMochaPlugin.configs.recommended.rules,
     ...eslintChaiExpectPlugin.configs['recommended-flat'].rules,
-    "no-unused-vars": ["error", {caughtErrors: "none"}],
+    ...eslintJsdocPlugin.configs['flat/recommended-error'].rules,
     'no-duplicate-imports': 'error',
+    'jsdoc/reject-any-type': 0,
+    'jsdoc/reject-function-type': 0,
+    'jsdoc/require-param-description': 0,
+    'jsdoc/require-returns-description': 0,
+    'jsdoc/require-property-description': 0,
+    'jsdoc/tag-lines': ['error', 'any', {startLines: 1}],
   },
   files: ['src/**/*.js'],
 }];

package.json

@@ -10,49 +10,47 @@
     "test",
     "unit"
   ],
-  "homepage": "https://github.com/e22m4u/js-spy",
+  "homepage": "https://gitrepos.ru/e22m4u/js-spy",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/e22m4u/js-spy.git"
+    "url": "git+https://gitrepos.ru/e22m4u/js-spy.git"
   },
   "type": "module",
-  "types": "./src/index.d.ts",
   "module": "./src/index.js",
   "main": "./dist/cjs/index.cjs",
   "exports": {
-    "types": "./src/index.d.ts",
     "import": "./src/index.js",
     "require": "./dist/cjs/index.cjs"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=12"
   },
   "scripts": {
-    "lint": "tsc && eslint ./src",
-    "lint:fix": "tsc && eslint ./src --fix",
+    "lint": "eslint ./src",
+    "lint:fix": "eslint ./src --fix",
     "format": "prettier --write \"./src/**/*.js\"",
     "test": "npm run lint && c8 --reporter=text-summary mocha",
     "test:coverage": "npm run lint && c8 --reporter=text mocha",
-    "build:cjs": "node --no-warnings=ExperimentalWarning build-cjs.js",
+    "build:cjs": "rimraf ./dist/cjs && node build-cjs.js",
     "prepare": "husky"
   },
   "devDependencies": {
     "@commitlint/cli": "~20.1.0",
     "@commitlint/config-conventional": "~20.0.0",
     "@eslint/js": "~9.39.1",
-    "@types/chai": "~5.2.3",
-    "@types/mocha": "~10.0.10",
     "c8": "~10.1.3",
     "chai": "~6.2.1",
     "esbuild": "~0.27.0",
     "eslint": "~9.39.1",
     "eslint-config-prettier": "~10.1.8",
     "eslint-plugin-chai-expect": "~3.1.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jsdoc": "^61.4.1",
     "eslint-plugin-mocha": "~11.2.0",
     "globals": "~16.5.0",
     "husky": "~9.1.7",
     "mocha": "~11.7.5",
     "prettier": "~3.6.2",
-    "typescript": "~5.9.3"
+    "rimraf": "~6.1.2"
   }
 }

src/create-spies-group.d.ts

@@ -1,56 +0,0 @@
-import {Spy} from './create-spy.js';
-import {MethodKey, AnyCallable} from './types.js';
-
-/**
- * Представляет группу шпионов, позволяющую
- * управлять ими коллективно.
- */
-export declare class SpiesGroup {
-  /**
-   * Внутренний массив, хранящий все шпионы,
-   * созданные в этой группе. Не предназначен
-   * для прямого доступа.
-   */
-  spies: Spy<any>[];
-
-  /**
-   * Создает шпиона для отдельной функции
-   * и добавляет его в группу.
-   *
-   * @param target
-   * @param customImpl
-   */
-  on<TFunc extends AnyCallable>(
-    target: TFunc,
-    customImpl?: TFunc,
-  ): Spy<TFunc>;
-
-  /**
-   * Создает шпиона для метода объекта, добавляет
-   * его в группу и заменяет оригинальный метод
-   * объекта шпионом.
-   *
-   * @param target
-   * @param methodName
-   * @param customImpl
-   */
-  on<TObj extends object, K extends MethodKey<TObj>>(
-    target: TObj,
-    methodName: K,
-    customImpl?: TObj[K],
-  ): Spy<Extract<TObj[K], AnyCallable>>;
-
-  /**
-   * Восстановление всех оригинальных методов объектов,
-   * для которых были созданы шпионы в этой группе,
-   * и сброс истории вызовов для всех шпионов в группе.
-   * Очищает внутренний список шпионов.
-   */
-  restore(): this;
-}
-
-/**
- * Фабричная функция для создания
- * нового экземпляра `SpiesGroup`.
- */
-export function createSpiesGroup(): SpiesGroup;

src/create-spies-group.js

@@ -16,9 +16,10 @@ export class SpiesGroup {
    * Создает шпиона для отдельной функции
    * или метода объекта и добавляет его в группу.
    *
-   * @param target
-   * @param methodNameOrImpl
-   * @param customImplForMethod
+   * @param {Function|object} target
+   * @param {Function|string} [methodNameOrImpl]
+   * @param {Function} [customImplForMethod]
+   * @returns {Function}
    */
   on(target, methodNameOrImpl, customImplForMethod) {
     const spy = createSpy(target, methodNameOrImpl, customImplForMethod);
@@ -31,6 +32,8 @@ export class SpiesGroup {
    * для которых были созданы шпионы в этой группе,
    * и сброс истории вызовов для всех шпионов в группе.
    * Очищает внутренний список шпионов.
+   *
+   * @returns {SpiesGroup}
    */
   restore() {
     this.spies.forEach(spy => spy.restore());

src/create-spy.d.ts

@@ -1,110 +0,0 @@
-import {AnyCallable, MethodKey} from './types.js';
-
-/**
- * Информация о единичном вызове
- * отслеживаемой функции.
- *
- * @template Args
- * @template Return
- */
-export interface CallInfo<Args extends any[] = any[], Return = any> {
-  /**
-   * Аргументы, с которыми был вызван шпион.
-   */
-  readonly args: Args;
-
-  /**
-   * Контекст this, с которым был вызван шпион.
-   */
-  readonly thisArg: any;
-
-  /**
-   * Значение, возвращенное шпионом.
-   * (undefined, если шпион выбросил ошибку)
-   */
-  readonly returnValue: Return | undefined;
-
-  /**
-   * Ошибка, выброшенная шпионом.
-   * (undefined, если шпион не выбросил ошибку)
-   */
-  readonly error: unknown | undefined;
-}
-
-/**
- * Представляет функцию-шпиона, созданную `createSpy`.
- * Это вызываемая функция, которая также имеет свойства
- * и методы для инспекции вызовов.
- *
- * @template TFunc
- */
-export interface Spy<TFunc extends AnyCallable = AnyCallable> {
-  /**
-   * Сама функция-шпион.
-   */
-  (...args: Parameters<TFunc>): ReturnType<TFunc>;
-
-  /**
-   * Вызовы шпиона.
-   *
-   * @readonly
-   */
-  readonly calls: CallInfo[];
-
-  /**
-   * Количество вызовов шпиона.
-   *
-   * @readonly
-   */
-  readonly callCount: number;
-
-  /**
-   * Булево значение, указывающее,
-   * был ли шпион вызван хотя бы один раз.
-   *
-   * @readonly
-   */
-  readonly isCalled: boolean;
-
-  /**
-   * Восстанавливает оригинальный метод,
-   * если шпион был создан для метода объекта.
-   * Ничего не делает, если шпион был создан
-   * для отдельной функции.
-   */
-  restore(): void;
-}
-
-/**
- * Создает шпиона.
- */
-export declare function createSpy(): Spy<(...args: any[]) => void>;
-
-/**
- * Создает шпиона для отдельной функции.
- *
- * @param targetFn
- * @param customImpl
- */
-export declare function createSpy<TFunc extends AnyCallable>(
-  targetFn: TFunc,
-  customImpl?: TFunc,
-): Spy<TFunc>;
-
-/**
- * Создание шпиона для метода объекта. Оригинальный метод
- * объекта будет заменен шпионом. Используйте `spy.restore()`
- * для восстановления оригинального метода.
- *
- * @param targetObject
- * @param methodName
- * @param customImpl
- */
-export declare function createSpy<
-  TObj extends object,
-  K extends MethodKey<TObj>,
->(
-  targetObject: TObj,
-  methodName: K,
-  customImpl?: TObj[K],
-): Spy<Extract<TObj[K], AnyCallable>>;

src/create-spy.js

@@ -2,8 +2,8 @@
  * Вспомогательная функция для разбора аргументов createSpy.
  *
  * @param {Function|object} target
- * @param {Function|string|undefined} methodNameOrImpl
- * @param {Function|undefined} customImplForMethod
+ * @param {Function|string} [methodNameOrImpl]
+ * @param {Function} [customImplForMethod]
  * @returns {object}
  */
 function _parseSpyArgs(target, methodNameOrImpl, customImplForMethod) {
@@ -142,9 +142,9 @@ function _parseSpyArgs(target, methodNameOrImpl, customImplForMethod) {
  * Шпионить за методом объекта:
  * createSpy(targetObject, methodName, [customImplementation])
  *
- * @param {Function|object|undefined} target
- * @param {Function|string|undefined} methodNameOrImpl
- * @param {Function|undefined} customImplForMethod
+ * @param {Function|object} [target]
+ * @param {Function|string} [methodNameOrImpl]
+ * @param {Function} [customImplForMethod]
  * @returns {Function}
  */
 export function createSpy(

src/create-spy.spec.js

@@ -157,6 +157,7 @@ describe('createSpy', function () {
       // определение объекта с методом, который
       // будет использоваться как target функция
       const contextObj = {val: 10};
+      // eslint-disable-next-line jsdoc/require-jsdoc
       function originalFn() {
         return this.val;
       }
@@ -177,6 +178,7 @@ describe('createSpy', function () {
       // использующей контекст this
       const contextObj = {val: 20};
       const originalFn = () => {};
+      // eslint-disable-next-line jsdoc/require-jsdoc
       function customImpl() {
         return this.val;
       }

src/index.d.ts

@@ -1,2 +0,0 @@
-export * from './create-spy.js';
-export * from './create-spies-group.js';

src/types.d.ts

@@ -1,18 +0,0 @@
-/**
- * Тип любой функции.
- */
-export type AnyCallable = (...args: any[]) => any;
-
-/**
- * Конструктор любой ошибки.
- */
-export type AnyErrorCtor = (new (...args: any[]) => Error);
-
-/**
- * Ключ любого метода в объекте.
- * Должен быть ключом `TObj`, значение
- * которого является функцией.
- */
-export type MethodKey<TObj extends object> = {
-  [P in keyof TObj]: TObj[P] extends AnyCallable ? P : never
-}[keyof TObj];

tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "noEmit": true,
-    "target": "es2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "allowJs": true,
-    "checkJs": true
-  },
-  "include": [
-    "./src/**/*.ts",
-    "./src/**/*.js"
-  ]
-}