@modulify/validator 0.2.1 → 0.3.1

package/docs/ru/README.md

@@ -207,7 +207,7 @@ if (ok) {
 
 ## API объектных схем
 
-`shape(...)` — это переиспользуемый API объектных схем. Он валидирует вложенные record-like objects и предоставляет небольшой неизменяемый API вроде `strict()`, `pick()`, `omit()`, `partial()`, `extend()`, `merge()`, `refine()` и `fieldsMatch(...)`.
+`shape(...)` — это переиспользуемый API объектных схем. Он валидирует вложенные record-like objects и предоставляет небольшой неизменяемый API вроде `strict()`, `pick()`, `omit()`, `partial()`, `extend()`, `merge()`, async-first `refine()`, явного `refine.sync()` и `fieldsMatch(...)`.
 
 ```typescript
 import {
@@ -273,11 +273,17 @@ const node = describe(registration)
 
 В текущем API это обычно выглядит так:
 
-- leaf checks через assertions вроде `isString`, `isDefined`, `hasLength`, `oneOf`;
+- guard assertions вроде `isString`, `isNumber`, `isDefined`, `oneOf(...)` задают базовый домен значения;
+- refinement assertions вроде `hasLength(...)`, `hasPattern(...)`, `startsWith(...)`, `hasValue(...)`, `multipleOf(...)` проверяют свойства уже внутри этого домена;
 - композиция схем через combinators вроде `exact`, `optional`, `nullable`, `nullish`, `shape(...)`, `each(...)`;
 - типизированная валидация через `validate(...)` или `validate.sync(...)`;
 - narrowing исходной переменной в sync-коде через `matches.sync(...)`.
 
+Последовательные массивы assertions теперь stage-aware. Кортеж вроде `[isString, hasLength({ min: 3 })]` типизируется, а несовместимые комбинации вроде `[isNumber, hasLength({ min: 3 })]` TypeScript отсекает.
+Refinement assertions не предполагаются для одиночной передачи в `validate(...)` или `matches.sync(...)`.
+
+`validate(...)` — основной async-first entrypoint. `validate.sync(...)` и `matches.sync(...)` остаются специализированными sync API и выбрасывают ошибку, если встречают async validators или async object-level rules из `shape(...).refine(...)`.
+
 ## Нарушения
 
 `validate(...)` возвращает машиночитаемый список `Violation[]`, а `collection(...)` может обернуть его в небольшой helper API для точного поиска по path и обхода дерева.
@@ -357,6 +363,8 @@ const jsonSchema = toJsonSchema(profile)
 - [Практические рецепты](./06-common-recipes.md) - практические примеры для валидации payload, выбора wrappers, переиспользуемых shape, сопоставления ошибок формы и экспорта JSON Schema.
 - [Справка для AI](./07-ai-reference.md) - компактное описание контракта для agents, инструментов и быстрого поиска семантики библиотеки.
 
+- [Миграция с 0.2.1](./09-migration.md)
+
 ## Заметки
 
 - Assertions возвращают структурированные метаданные вместо сообщений.

package/package.json

@@ -3,40 +3,66 @@
   "type": "module",
   "description": "Declarative validation util for JavaScript",
   "license": "MIT",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs",
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
       "default": "./dist/index.mjs"
     },
     "./assertions": {
-      "types": "./dist/assertions.d.ts",
-      "import": "./dist/assertions.mjs",
-      "require": "./dist/assertions.cjs",
+      "import": {
+        "types": "./dist/assertions.d.mts",
+        "default": "./dist/assertions.mjs"
+      },
+      "require": {
+        "types": "./dist/assertions.d.cts",
+        "default": "./dist/assertions.cjs"
+      },
       "default": "./dist/assertions.mjs"
     },
     "./combinators": {
-      "types": "./dist/combinators.d.ts",
-      "import": "./dist/combinators.mjs",
-      "require": "./dist/combinators.cjs",
+      "import": {
+        "types": "./dist/combinators.d.mts",
+        "default": "./dist/combinators.mjs"
+      },
+      "require": {
+        "types": "./dist/combinators.d.cts",
+        "default": "./dist/combinators.cjs"
+      },
       "default": "./dist/combinators.mjs"
     },
     "./json-schema": {
-      "types": "./dist/json-schema.d.ts",
-      "import": "./dist/json-schema.mjs",
-      "require": "./dist/json-schema.cjs",
+      "import": {
+        "types": "./dist/json-schema.d.mts",
+        "default": "./dist/json-schema.mjs"
+      },
+      "require": {
+        "types": "./dist/json-schema.d.cts",
+        "default": "./dist/json-schema.cjs"
+      },
       "default": "./dist/json-schema.mjs"
     },
     "./predicates": {
-      "types": "./dist/predicates.d.ts",
-      "import": "./dist/predicates.mjs",
-      "require": "./dist/predicates.cjs",
+      "import": {
+        "types": "./dist/predicates.d.mts",
+        "default": "./dist/predicates.mjs"
+      },
+      "require": {
+        "types": "./dist/predicates.d.cts",
+        "default": "./dist/predicates.cjs"
+      },
       "default": "./dist/predicates.mjs"
     }
   },
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "typesVersions": {
     "*": {
       "assertions": [
@@ -55,36 +81,36 @@
   },
   "scripts": {
     "build": "vite build",
-    "lint": "eslint src tests types",
+    "lint": "eslint src tests types scripts vite.config.ts release.config.mjs",
     "prepare": "husky",
-    "release": "npx --yes standard-version",
-    "release:minor": "npx --yes standard-version --release-as minor",
-    "release:patch": "npx --yes standard-version --release-as patch",
-    "release:major": "npx --yes standard-version --release-as major",
+    "release": "conventional-release --tags",
+    "release:dry": "conventional-release --dry --verbose --tags",
+    "release:minor": "conventional-release --tags --release-as minor",
+    "release:patch": "conventional-release --tags --release-as patch",
+    "release:major": "conventional-release --tags --release-as major",
     "stats": "gzip -c ./dist/index.mjs | wc -c",
     "test": "vitest run",
-    "test:d": "vitest run --typecheck.only",
-    "test:coverage": "vitest run --coverage",
-    "test:coverage:html": "vitest run --coverage --reporter=html --outputFile.html=./reports/html/report.html",
+    "test:d": "vitest run --typecheck.only --coverage.enabled=false",
+    "test:package": "yarn build && node scripts/check-package.mjs",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.4.3",
-    "@commitlint/config-conventional": "^20.4.3",
+    "@commitlint/cli": "^21.2.3",
+    "@commitlint/config-conventional": "^21.2.3",
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.3.5",
-    "@vitest/coverage-v8": "4.0.18",
-    "@vitest/ui": "4.0.18",
-    "eslint": "^10.0.3",
-    "globals": "^17.4.0",
+    "@modulify/conventional-release": "^0.1.3",
+    "@types/node": "^24.19.0",
+    "@vitest/coverage-v8": "5.0.2",
+    "@vitest/ui": "5.0.2",
+    "eslint": "^10.11.0",
+    "globals": "^17.12.0",
     "husky": "^9.1.7",
-    "ts-node": "^10.9.2",
     "tslib": "^2.8.1",
-    "typescript": "^5.5.4",
-    "typescript-eslint": "^8.56.1",
-    "vite": "^7.3.1",
-    "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.0.18"
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.70.1",
+    "unplugin-dts": "^1.1.1",
+    "vite": "^8.3.1",
+    "vitest": "5.0.2"
   },
   "resolutions": {
     "minimatch@npm:10.2.1": "npm:10.2.4",