feat!: migrate to pnpm + TypeScript ESM (Node 20+), bump every package to 1.0.0

.c8rc.json

@@ -0,0 +1,15 @@
+{
+  "reporter": ["text", "lcov", "html"],
+  "include": ["packages/*/src/**/*.ts"],
+  "exclude": [
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "**/dist/**",
+    "**/node_modules/**",
+    "**/test/**",
+    "**/spec/**",
+    "**/types/**"
+  ],
+  "all": true,
+  "extension": [".ts"]
+}

.changeset/README.md

@@ -0,0 +1,18 @@
+# Changesets
+
+Используется для управления версиями и публикации пакетов в монорепо.
+
+## Как добавить запись
+
+```sh
+pnpm changeset
+```
+
+Команда задаст вопросы про затронутые пакеты, тип bump (major/minor/patch) и описание.
+
+## Как выпустить релиз
+
+```sh
+pnpm version    # bump версий по changeset-файлам
+pnpm release    # build + publish в npm
+```

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "master",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [20, 22, 24]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: pnpm
+
+      - run: pnpm install --frozen-lockfile
+
+      - run: pnpm typecheck
+
+      - run: pnpm lint
+
+      - run: pnpm test:cover
+
+      - if: matrix.node == 22
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: coverage/

.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    branches: [master]
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+          registry-url: https://registry.npmjs.org
+
+      - run: pnpm install --frozen-lockfile
+
+      - run: pnpm -r build
+
+      - run: pnpm typecheck
+
+      - run: pnpm test
+
+      - id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: pnpm release
+          version: pnpm version
+          commit: 'chore(release): version packages'
+          title: 'chore(release): version packages'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -1,6 +1,14 @@
-.nyc_output
-coverage
-
 node_modules
+.pnpm-store
+.pnpm-debug.log
 npm-debug.log
 lerna-debug.log
+
+.nyc_output
+coverage
+
+dist
+*.tsbuildinfo
+
+.worktrees
+.DS_Store

.mocharc.json

@@ -0,0 +1,8 @@
+{
+  "extension": ["ts"],
+  "spec": "packages/*/src/**/*.{test,spec}.ts",
+  "node-option": ["import=tsx"],
+  "reporter": "spec",
+  "timeout": 5000,
+  "ui": "bdd"
+}

CONTRIBUTING.md

@@ -5,16 +5,58 @@ email, or any other method with the owners of this repository before making a ch
 
 Please note we have a code of conduct, please follow it in all your interactions with the project.
 
+## Local development
+
+Requirements:
+
+- **Node.js >= 20** (CI matrix: 20, 22, 24).
+- **pnpm 11**, installed via [Corepack](https://nodejs.org/api/corepack.html):
+
+  ```sh
+  corepack enable
+  ```
+
+Setup:
+
+```sh
+pnpm install
+pnpm typecheck    # tsc --build (production) + tsc on test files
+pnpm lint         # ESLint 10 flat config
+pnpm test         # Mocha 11 + Chai 6 + tsx (TypeScript ESM)
+pnpm test:cover   # c8 coverage
+```
+
+Project layout:
+
+- `packages/*` — independent published packages, each ESM-only TypeScript.
+- `pnpm-workspace.yaml` — workspace + version catalog.
+- `tsconfig.base.json` — strict TS baseline (NodeNext, ES2023, composite).
+- `eslint.config.js` — flat config.
+- `.mocharc.json` — mocha config rooted at `packages/*/src/**/*.test.ts`.
+- `.changeset/` — pending changesets (each one PR-able).
+- `.github/workflows/` — CI (Node 20/22/24 matrix) and changesets-driven release.
+
 ## Pull Request Process
 
-1. Ensure any install or build dependencies are removed before the end of the layer when doing a
-   build.
-2. Update the README.md with details of changes to the interface, this includes new environment
-   variables, exposed ports, useful file locations and container parameters.
-3. Increase the version numbers in any examples files and the README.md to the new version that this
-   Pull Request would represent. The versioning scheme we use is [SemVer](http://semver.org/).
-4. You may merge the Pull Request in once you have the sign-off of two other developers, or if you
-   do not have permission to do that, you may request the second reviewer to merge it for you.
+1. Add a changeset describing your change:
+
+   ```sh
+   pnpm changeset
+   ```
+
+   Pick the affected package(s), the bump level (major/minor/patch) and write a
+   one-paragraph explanation of the user-visible change. The file lands under
+   `.changeset/` and gets committed together with your code.
+
+2. Make sure `pnpm typecheck`, `pnpm lint` and `pnpm test` are all green
+   locally — these are the same checks CI runs.
+
+3. Update the package's README if the public API changed (entry name, options,
+   types, etc.).
+
+4. Open the PR. CI is required to pass before merge. Releases are produced
+   automatically by the `changesets/action` workflow when the changeset PR
+   is merged into `master`.
 
 ## Code of Conduct