urfu-ui-kit-react 2.0.6-next.2 → 2.1.1

package/dist/utils/describeError.d.ts

@@ -78,6 +78,33 @@ export declare function configureErrorTexts(overrides: Partial<Record<Exclude<Er
 export declare function isHumanMessage(message: string | undefined): message is string;
 /** Описать ошибку для человека. Отмену запроса возвращает с group 'aborted' и action 'none' — её не показывают. */
 export declare function describeError(error: unknown, options?: DescribeErrorOptions): ErrorDescription;
+/** Ошибки валидации по полям формы — разбор ответа 400/422 (решение дизайнера 20.10.2026: причину — у поля). */
+export interface FieldErrors {
+    /** Текст ошибки по ключу поля — показывать под полем (проп `error` у полей кита). */
+    fields: Record<string, string>;
+    /** Ключ первого поля с ошибкой в порядке сервера — на него ставят фокус. */
+    firstField?: string;
+    /**
+     * Что показать общим уведомлением: ошибки без поля. Пустая строка — всё разнесено по полям.
+     * Если сервер полей не назвал — то же, что `describeError(error).message`.
+     */
+    message: string;
+}
+export interface DescribeFieldErrorsOptions extends DescribeErrorOptions {
+    /** Текст для полей из `missingFields`: сервер назвал поле, но не причину. */
+    requiredText?: string;
+}
+/**
+ * Разобрать ошибку валидации по полям формы. Понимает три формата тела ответа 400/422:
+ * - `errors: [{ field, message }]` (также `property`/`path`/`name` и `constraints` class-validator);
+ * - `errors: { поле: 'текст' | ['текст', …] }`;
+ * - `missingFields: ['поле', …]` — поле без причины, текст — `requiredText`.
+ *
+ * Принимает то же, что `describeError` (RTK Query, axios, `{ status, data }`); у `fetch` Response
+ * тело ещё не прочитано — передайте `{ status: response.status, data: await response.json() }`.
+ * Другие коды и ответы без полей дают пустые `fields` и общий `message`.
+ */
+export declare function describeFieldErrors(error: unknown, options?: DescribeFieldErrorsOptions): FieldErrors;
 /**
  * Что сервис сообщает о себе для письма в техподдержку и куда ведёт кнопка обращения.
  * Задаётся один раз при запуске сервиса (в шаблоне — в точке входа).

package/dist/utils/describeError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describeError.d.ts","sourceRoot":"","sources":["../../src/utils/describeError.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"describeError.d.ts","sourceRoot":"","sources":["../../src/utils/describeError.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,79 +1,110 @@
-{
-  "name": "urfu-ui-kit-react",
-  "description": "UrFU UI-Kit for React Web",
-  "license": "UNLICENSED",
-  "private": false,
-  "version": "2.0.6-next.2",
-  "type": "module",
-  "main": "dist/urfu-ui-kit-react",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "start": "vite",
-    "build": "tsc && vite build && node scripts/externalize-fonts.mjs && node scripts/generate-no-fonts-css.mjs && tsc -p tsconfig.declaration.json",
-    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.node.json --noEmit && tsc -p docs/tsconfig.json --noEmit",
-    "preview": "vite preview",
-    "sb": "storybook dev -p 6006",
-    "sbb": "storybook build",
-    "pub": "npm run build && npm version patch && npm publish",
-    "pub:next": "npm run build && npm version prerelease --preid next --no-git-tag-version && npm publish --tag next",
-    "vp": "vitepress dev docs",
-    "og:generate": "node scripts/generate-og-images.mjs",
-    "vpb": "npm run og:generate && vitepress build docs",
-    "vpp": "vitepress preview docs",
-    "docs": "start \"sb\" npm run sb && npm run vp",
-    "docsb": "npm run og:generate && storybook build --output-dir uikit-react && vitepress build docs",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
-  },
-  "dependencies": {
-    "date-fns": "^3.6.0",
-    "react-datepicker": "^7.4.0",
-    "urfu-ui-kit-vanilla": "^2.9.4"
-  },
-  "devDependencies": {
-    "@chromatic-com/storybook": "^1.3.3",
-    "@storybook/addon-essentials": "^8.0.9",
-    "@storybook/addon-interactions": "^8.0.9",
-    "@storybook/addon-links": "^8.0.9",
-    "@storybook/addon-mdx-gfm": "^8.0.9",
-    "@storybook/addon-onboarding": "^8.0.9",
-    "@storybook/addon-themes": "^8.6.11",
-    "@storybook/blocks": "^8.0.9",
-    "@storybook/react": "^8.0.9",
-    "@storybook/react-vite": "^8.0.9",
-    "@storybook/test": "^8.0.9",
-    "@testing-library/react": "^16.3.2",
-    "@types/node": "^20.12.7",
-    "@types/react": "^18.2.75",
-    "@types/react-dom": "^18.2.22",
-    "@typescript-eslint/eslint-plugin": "^7.2.0",
-    "@typescript-eslint/parser": "^7.2.0",
-    "@vitejs/plugin-react": "^4.2.1",
-    "@vitest/coverage-v8": "^2.1.9",
-    "eslint": "^8.57.0",
-    "eslint-plugin-react": "^7.34.1",
-    "eslint-plugin-react-hooks": "^4.6.0",
-    "eslint-plugin-react-refresh": "^0.4.6",
-    "eslint-plugin-storybook": "^0.8.0",
-    "jsdom": "^25.0.1",
-    "less": "^4.2.0",
-    "less-loader": "^12.2.0",
-    "sharp": "^0.34.5",
-    "storybook": "^8.0.10",
-    "typescript": "^5.2.2",
-    "vite": "^5.3.1",
-    "vite-plugin-legacy": "^2.1.0",
-    "vite-plugin-style-import": "^2.0.0",
-    "vitepress": "^1.6.4",
-    "vitest": "^2.1.9"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
-  },
-  "files": [
-    "dist"
-  ]
-}
+{
+  "name": "urfu-ui-kit-react",
+  "description": "UrFU UI-Kit for React Web",
+  "license": "UNLICENSED",
+  "private": false,
+  "version": "2.1.1",
+  "type": "module",
+  "main": "dist/urfu-ui-kit-react",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/urfu-ui-kit-react.js",
+      "default": "./dist/urfu-ui-kit-react.js"
+    },
+    "./dev": {
+      "types": "./dist/dev/types/react/src/dev/index.d.ts",
+      "import": "./dist/dev/index.js",
+      "default": "./dist/dev/index.js"
+    },
+    "./style.layer.css": "./dist/style.layer.css",
+    "./style.shell.css": "./dist/style.shell.css",
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "dev": [
+        "dist/dev/types/react/src/dev/index.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "start": "vite",
+    "build": "tsc && vite build && node scripts/externalize-fonts.mjs && node scripts/generate-no-fonts-css.mjs && node ../../tools/styles/style-variants.mjs && tsc -p tsconfig.declaration.json && node scripts/clean-declarations.mjs && vite build -c vite.dev.config.ts && tsc -p tsconfig.dev-declaration.json",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.node.json --noEmit && tsc -p docs/tsconfig.json --noEmit",
+    "preview": "vite preview",
+    "sb": "storybook dev -p 6006",
+    "sbb": "storybook build",
+    "release:check": "node ../../tools/release/release.mjs check-clean && npm test && npm run build && npm run check:package",
+    "pub": "npm run release:check && node ../../tools/release/release.mjs publish react",
+    "pub:next": "npm test && npm run build && npm run check:package && node ../../tools/release/release.mjs publish react --next",
+    "prepublishOnly": "npm run build && npm run check:package",
+    "check:package": "node scripts/check-package.mjs",
+    "vp": "vitepress dev docs",
+    "og:generate": "node scripts/generate-og-images.mjs",
+    "vpb": "npm run og:generate && vitepress build docs",
+    "vpp": "vitepress preview docs",
+    "docs": "start \"sb\" npm run sb && npm run vp",
+    "docsb": "npm run og:generate && storybook build --output-dir uikit-react && vitepress build docs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "parity:dom": "vitest run --config vitest.parity.config.ts",
+    "parity:visual": "playwright test -c playwright-ct.config.ts",
+    "parity:visual:update": "playwright test -c playwright-ct.config.ts --update-snapshots=all"
+  },
+  "dependencies": {
+    "date-fns": "^3.6.0",
+    "react-datepicker": "^7.4.0"
+  },
+  "devDependencies": {
+    "@chromatic-com/storybook": "^1.3.3",
+    "@playwright/experimental-ct-react": "1.58.1",
+    "@playwright/test": "1.58.1",
+    "@storybook/addon-essentials": "^8.0.9",
+    "@storybook/addon-interactions": "^8.0.9",
+    "@storybook/addon-links": "^8.0.9",
+    "@storybook/addon-mdx-gfm": "^8.0.9",
+    "@storybook/addon-onboarding": "^8.0.9",
+    "@storybook/addon-themes": "^8.6.11",
+    "@storybook/blocks": "^8.0.9",
+    "@storybook/react": "^8.0.9",
+    "@storybook/react-vite": "^8.0.9",
+    "@storybook/test": "^8.0.9",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^20.12.7",
+    "@types/react": "^18.2.75",
+    "@types/react-dom": "^18.2.22",
+    "@typescript-eslint/eslint-plugin": "^7.2.0",
+    "@typescript-eslint/parser": "^7.2.0",
+    "@vitejs/plugin-react": "^4.2.1",
+    "@vitest/coverage-v8": "^2.1.9",
+    "eslint": "^8.57.0",
+    "eslint-plugin-react": "^7.34.1",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "eslint-plugin-react-refresh": "^0.4.6",
+    "eslint-plugin-storybook": "^0.8.0",
+    "jsdom": "^25.0.1",
+    "less": "^4.2.0",
+    "less-loader": "^12.2.0",
+    "postcss": "^8.5.6",
+    "sharp": "^0.34.5",
+    "storybook": "^8.0.10",
+    "typescript": "^5.2.2",
+    "vite": "^5.3.1",
+    "vite-plugin-legacy": "^2.1.0",
+    "vite-plugin-style-import": "^2.0.0",
+    "vitepress": "^1.6.4",
+    "vitest": "^2.1.9"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}