@nemigo/helpers 2.4.0 → 2.6.0

package/dist/async/context.js

@@ -56,7 +56,6 @@ export class AsyncContext {
         const result = await this.__async_storage.run(transaction, () => func(transaction));
         if (autoAfterCommit && transaction.length > 0) {
             await this.__submit(transaction);
-            // eslint-disable-next-line require-atomic-updates
             transaction.length = 0;
         }
         return result;

package/dist/async/index.d.ts

@@ -1,4 +1,4 @@
-import type { AnyFunc, Args, CanBePromise, Return } from "../types.js";
+import type { AnyFunc, Args, CanBePromise, IState, Return } from "../types.js";
 /**
  * Промис из {@link createManualPromise}
  */
@@ -30,6 +30,7 @@ export declare const delay: (ms: number, success?: boolean) => Promise<void>;
  * ```
  */
 export declare const debounce: <F extends AnyFunc>(func: F, ms: number) => ((...args: Args<F>) => void);
+export declare const useStateGuard: <F extends AnyFunc>(func: F, state: IState<boolean>) => ((...args: Args<F>) => Promise<void>);
 /**
  * Режимы троттлинга для {@link throttle}:
  * - `"delay"`:
@@ -42,13 +43,20 @@ export declare const debounce: <F extends AnyFunc>(func: F, ms: number) => ((...
  *   * Аргументы обновляются, но не влияют, если функция уже выполняется
  */
 export type ThrottleMode = "urgent" | "delay";
+export interface ThrottleOptions {
+    state?: IState<boolean>;
+    /**
+     * @default "urgent"
+     */
+    mode?: ThrottleMode;
+    /**
+     * @default 250
+     */
+    ms?: number;
+}
 /**
  * Создаёт throttle-функцию, которая вызывает переданную функцию не чаще одного раза в заданный интервал времени
  *
- * @param func - Функция для троттлинга
- * @param [mode="urgent"] - Режим троттлинга
- * @param [ms=250] - Интервал времени в миллисекундах
- *
  * @throws {unknown} Ошибки функции прокидываются в промис
  *
  * @example
@@ -61,7 +69,7 @@ export type ThrottleMode = "urgent" | "delay";
  * const result2 = await throttledFetch("456"); // Возвращает тот же промис с "123"
  * ```
  */
-export declare const throttle: <F extends AnyFunc>(func: F, mode?: "urgent" | "delay", ms?: number) => ((...args: Args<F>) => Promise<Awaited<Return<F>>>);
+export declare const throttle: <F extends AnyFunc>(func: F, { mode, ms, state }: ThrottleOptions) => ((...args: Args<F>) => Promise<Awaited<Return<F>>>);
 export type BoundaryFallback<Fallback> = Fallback | ((err: unknown) => CanBePromise<Fallback>);
 /**
  * Приведение коллбэка к промису с отловом ошибок и fallback-значением

package/dist/async/index.js

@@ -44,13 +44,18 @@ export const debounce = (func, ms) => {
         timeout = setTimeout(() => void func(...args), ms);
     };
 };
+export const useStateGuard = (func, state) => async (...args) => {
+    state.set(true);
+    try {
+        await func(...args);
+    }
+    finally {
+        state.set(false);
+    }
+};
 /**
  * Создаёт throttle-функцию, которая вызывает переданную функцию не чаще одного раза в заданный интервал времени
  *
- * @param func - Функция для троттлинга
- * @param [mode="urgent"] - Режим троттлинга
- * @param [ms=250] - Интервал времени в миллисекундах
- *
  * @throws {unknown} Ошибки функции прокидываются в промис
  *
  * @example
@@ -63,17 +68,19 @@ export const debounce = (func, ms) => {
  * const result2 = await throttledFetch("456"); // Возвращает тот же промис с "123"
  * ```
  */
-export const throttle = (func, mode = "urgent", ms = 250) => {
+export const throttle = (func, { mode = "urgent", ms = 250, state }) => {
     let _promise;
     let _args = [];
     const call = async () => await func(..._args);
     const reset = () => {
         _promise = null;
+        state?.set(false);
     };
     return (...args) => {
         _args = args;
         if (_promise)
             return _promise;
+        state?.set(true);
         const { resolve, reject, promise } = createManualPromise();
         _promise = promise;
         if (mode === "delay") {

package/dist/html/events.js

@@ -44,7 +44,6 @@ export const createEnterHandler = (handler, props = {}) => (event) => {
         secondary?.(event);
     }
 };
-// oxlint-disable-next-line typescript/explicit-module-boundary-types
 export const isKeyboardEvent = (e) => !!e.code;
 /**
  * Создаёт обработчик события контекстного меню

package/dist/mutate.js

@@ -116,7 +116,6 @@ export const inject = (self, key, func, dynamic = false) => {
     const original = self[key];
     if (dynamic) {
         // динамический this
-        // oxlint-disable-next-line eslint/func-names
         // eslint-disable-next-line func-names
         self[key] = function (...args) {
             // eslint-disable-next-line unicorn/consistent-function-scoping

package/dist/script.js

@@ -1,5 +1,4 @@
 /* eslint-disable no-console */
-// oxlint-disable no-console
 import { exec } from "node:child_process";
 import { MS_IN_MINUTE } from "./datetime/delta.js";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/helpers",
-	"version": "2.4.0",
+	"version": "2.6.0",
 	"private": false,
 	"license": "MPL-2.0",
 	"author": {
@@ -183,27 +183,15 @@
 			"types": "./dist/veil.d.ts",
 			"default": "./dist/veil.js"
 		},
-		"./xod": {
-			"types": "./dist/xod.d.ts",
-			"default": "./dist/xod.js"
-		},
 		"./zipper": {
 			"types": "./dist/zipper.d.ts",
 			"default": "./dist/zipper.js"
 		}
 	},
-	"peerDependencies": {
-		"zod": ">=4.2.0"
-	},
-	"peerDependenciesMeta": {
-		"zod": {
-			"optional": true
-		}
-	},
 	"dependencies": {
 		"@std/msgpack": "npm:@jsr/std__msgpack"
 	},
 	"devDependencies": {
-		"@nemigo/configs": "2.4.0"
+		"@nemigo/configs": "2.6.0"
 	}
 }

package/dist/xod.d.ts

@@ -1,246 +0,0 @@
-import { z } from "zod";
-/**
- * Параметры для создания ошибки валидации {@link https://zod.dev Zod}
- */
-export interface InvalidValueIssue {
-    /**
-     * Исходное значение которое не прошло валидацию
-     */
-    value: unknown;
-    /**
-     * Контекст валидации {@link https://zod.dev Zod}
-     */
-    ctx: z.core.$RefinementCtx;
-    /**
-     * Сообщение об ошибке
-     */
-    message: string;
-    /**
-     * Ожидаемый тип значения
-     */
-    expected: string;
-}
-/**
- * Добавляет ошибку валидации в контекст {@link https://zod.dev Zod}-схемы через {@link RefinementCtx.addIssue} и прерывает выполнение
- */
-export declare const throwValueIssue: (props: InvalidValueIssue) => never;
-/**
- * Схема для отсутствующих значений
- *
- * Замаскировано под эквивалент: `z.union([z.null().optional().transform(() => undefined)])`
- *
- * Принимает:
- * - `null` → `undefined`
- * - `undefined` → `undefined`
- * - `"nUll"` (любой регистр) → `undefined`
- * - `"undeFinEd"` (любой регистр) → `undefined`
- * - `""` → `undefined`
- * - `ETC` → ZodError
- */
-export declare const nullSchema: z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>;
-/**
- * Создаёт схему: либо {@link nullSchema}, либо значения по переданной схеме
- *
- * @example
- * ```typescript
- * const nullableString = toNullable(z.string());
- * nullableString.parse("hello"); // "hello"
- * nullableString.parse(null);    // undefined
- * nullableString.parse("null");  // undefined
- * ```
- */
-export declare const toNullable: <T extends z.core.SomeType>(schema: T) => z.ZodUnion<[typeof nullSchema, T]>;
-/**
- * Схема для boolean-значений через {@link caseBoolean}
- *
- * Замаскировано под эквивалент: `z.boolean().transform((v) => v)`
- */
-export declare const booleanSchema: z.ZodPipe<z.ZodBoolean, z.ZodTransform<boolean, boolean>>;
-/**
- * Сочетает {@link nullSchema} и {@link booleanSchema}
- */
-export declare const booleanSchemaOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodBoolean, z.ZodTransform<boolean, boolean>>]>;
-/**
- * Схема для числовых значений через {@link caseNumber}
- *
- * Замаскировано под эквивалент: `z.union([z.number(), z.string()]).transform((v) => Number(v))`
- */
-export declare const numberSchema: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-/**
- * Сочетает {@link nullSchema} и {@link numberSchema}
- */
-export declare const numberSchemaOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>]>;
-/**
- * Отличается типизацией от {@link numberSchema} тем, что якобы не принимает строки
- *
- * Замаскировано под эквивалент: `z.number().transform((v) => v)`
- *
- * @example
- * ```typescript
- * numberStrictSchema.parse(42);     // 42
- * numberStrictSchema.parse("42");   // Ошибка типизации!
- * ```
- */
-export declare const numberStrictSchema: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
-/**
- * Сочетает {@link nullSchema} и {@link numberStrictSchema}
- */
-export declare const numberStrictSchemaOptional: z.ZodUnion<[typeof nullSchema, typeof numberStrictSchema]>;
-/**
- * Схема для строковых значений через {@link caseString}
- *
- * Замаскировано под эквивалент: `z.union([z.number(), z.string()]).transform((v) => String(v))`
- */
-export declare const stringSchema: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>;
-/**
- * Сочетает {@link nullSchema} и {@link stringSchema}
- */
-export declare const stringSchemaOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>]>;
-/**
- * Отличается типизацией от {@link stringSchema} тем, что якобы не принимает числа
- *
- * Замаскировано под эквивалент: `z.string().transform((v) => v)`
- *
- * @example
- * ```typescript
- * stringStrictSchema.parse("hello"); // "hello"
- * stringStrictSchema.parse(42);      // Ошибка типизации!
- * ```
- */
-export declare const stringStrictSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
-/**
- * Сочетает {@link nullSchema} и {@link stringStrictSchema}
- */
-export declare const stringStrictSchemaOptional: z.ZodUnion<[typeof nullSchema, typeof stringStrictSchema]>;
-/**
- * Схема для {@link ZoneStamp}
- */
-export declare const zoneStampSchema: z.ZodObject<{
-    stamp: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    zone: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-}, z.core.$strip>;
-/**
- * Сочетает {@link nullSchema} и {@link zoneStampSchema}
- */
-export declare const zoneStampSchemaOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodObject<{
-    stamp: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    zone: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-}, z.core.$strip>]>;
-/**
- * Строгая версия {@link zoneStampSchema}, которая не якобы принимает строковые представления чисел
- *
- * @example
- * ```typescript
- * zoneStampStrictSchema.parse({ stamp: 1234567890, zone: 3 });     // { stamp: 1234567890, zone: 3 }
- * zoneStampStrictSchema.parse({ stamp: 1234567890, zone: "3" }); // Ошибка типизации!
- * ```
- */
-export declare const zoneStampStrictSchema: z.ZodObject<{
-    stamp: typeof numberStrictSchema;
-    zone: typeof numberStrictSchema;
-}>;
-/**
- * Сочетает {@link nullSchema} и {@link zoneStampStrictSchema}
- */
-export declare const zoneStampStrictSchemaOptional: z.ZodUnion<[typeof nullSchema, typeof zoneStampStrictSchema]>;
-/**
- * Схема для {@link LWH}
- */
-export declare const lwhSchema: z.ZodObject<{
-    length: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    width: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    height: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-}, z.core.$strip>;
-/**
- * Сочетает {@link nullSchema} и {@link lwhSchema}
- */
-export declare const lwhSchemaOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodObject<{
-    length: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    width: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    height: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-}, z.core.$strip>]>;
-/**
- * Отличается типизацией от {@link lwhSchema} тем, что якобы не принимает строковые представления чисел
- *
- * @example
- * ```typescript
- * lwhStrictSchema.parse({ length: 10, width: 20, height: 30 });        // { length: 10, width: 20, height: 30 }
- * lwhStrictSchema.parse({ length: "10", width: "20", height: "30" });  // Ошибка типизации!
- * ```
- */
-export declare const lwhStrictSchema: z.ZodObject<{
-    length: typeof numberStrictSchema;
-    width: typeof numberStrictSchema;
-    height: typeof numberStrictSchema;
-}>;
-/**
- * Сочетает {@link nullSchema} и {@link lwhStrictSchema}
- */
-export declare const lwhStrictSchemaOptional: z.ZodUnion<[typeof nullSchema, typeof lwhStrictSchema]>;
-/**
- * Коллекция расширенных {@link https://zod.dev Zod}-схем со встроенными преобразованиями типов
- *
- * @example
- * ```typescript
- * import { xod } from "./xod.js"; // or import xod from "./xod.js";
- *
- * const userSchema = z.object({
- *   name: xod.string,           // Принимает string и number
- *   age: xod.number,            // Принимает number и string
- *   isActive: xod.boolean,      // Принимает boolean, number, string
- *   notes: xod.stringOptional,  // Принимает string, number, null, undefined
- *   created: xod.zoneStamp,     // Принимает объект с временной меткой и зоной
- * });
- * ```
- */
-export declare const xod: {
-    throwValueIssue: (props: InvalidValueIssue) => never;
-    toNullable: <T extends z.core.SomeType>(schema: T) => z.ZodUnion<[typeof nullSchema, T]>;
-    null: z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>;
-    boolean: z.ZodPipe<z.ZodBoolean, z.ZodTransform<boolean, boolean>>;
-    booleanOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodBoolean, z.ZodTransform<boolean, boolean>>]>;
-    number: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    numberStrict: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
-    numberOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>]>;
-    numberStrictOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>]>;
-    string: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>;
-    stringStrict: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
-    stringOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>]>;
-    stringStrictOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>]>;
-    zoneStamp: z.ZodObject<{
-        stamp: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-        zone: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    }, z.core.$strip>;
-    zoneStampOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodObject<{
-        stamp: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-        zone: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    }, z.core.$strip>]>;
-    zoneStampStrict: z.ZodObject<{
-        stamp: typeof numberStrictSchema;
-        zone: typeof numberStrictSchema;
-    }, z.core.$strip>;
-    zoneStampStrictOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodObject<{
-        stamp: typeof numberStrictSchema;
-        zone: typeof numberStrictSchema;
-    }, z.core.$strip>]>;
-    lwh: z.ZodObject<{
-        length: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-        width: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-        height: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    }, z.core.$strip>;
-    lwhOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodObject<{
-        length: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-        width: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-        height: z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
-    }, z.core.$strip>]>;
-    lwhStrict: z.ZodObject<{
-        length: typeof numberStrictSchema;
-        width: typeof numberStrictSchema;
-        height: typeof numberStrictSchema;
-    }, z.core.$strip>;
-    lwhStrictOptional: z.ZodUnion<[z.ZodPipe<z.ZodOptional<z.ZodNull>, z.ZodTransform<undefined, null | undefined>>, z.ZodObject<{
-        length: typeof numberStrictSchema;
-        width: typeof numberStrictSchema;
-        height: typeof numberStrictSchema;
-    }, z.core.$strip>]>;
-};

package/dist/xod.js

@@ -1,241 +0,0 @@
-import { z } from "zod";
-import { caseBoolean, caseNumber, caseString } from "./cases.js";
-/**
- * Добавляет ошибку валидации в контекст {@link https://zod.dev Zod}-схемы через {@link RefinementCtx.addIssue} и прерывает выполнение
- */
-export const throwValueIssue = (props) => {
-    props.ctx.addIssue({
-        code: "invalid_type",
-        message: props.message,
-        input: props.value,
-        expected: props.expected,
-    });
-    return z.NEVER;
-};
-//...
-/**
- * Схема для отсутствующих значений
- *
- * Замаскировано под эквивалент: `z.union([z.null().optional().transform(() => undefined)])`
- *
- * Принимает:
- * - `null` → `undefined`
- * - `undefined` → `undefined`
- * - `"nUll"` (любой регистр) → `undefined`
- * - `"undeFinEd"` (любой регистр) → `undefined`
- * - `""` → `undefined`
- * - `ETC` → ZodError
- */
-export const nullSchema = z.union([
-    // biome-ignore format : потеря смысла
-    // oxlint-disable-next-line unicorn/no-useless-undefined
-    // eslint-disable-next-line unicorn/no-useless-undefined
-    z.null().optional().transform(() => undefined),
-    z.string().transform((value, ctx) => {
-        if (!value)
-            return;
-        const flat = value.trim().toLowerCase();
-        if (flat === "undefined" || flat === "null")
-            return;
-        return throwValueIssue({
-            ctx,
-            value,
-            message: "It isn't a null / undefined",
-            expected: "null / undefined (or string like null / undefined)",
-        });
-    }),
-]);
-/**
- * Создаёт схему: либо {@link nullSchema}, либо значения по переданной схеме
- *
- * @example
- * ```typescript
- * const nullableString = toNullable(z.string());
- * nullableString.parse("hello"); // "hello"
- * nullableString.parse(null);    // undefined
- * nullableString.parse("null");  // undefined
- * ```
- */
-export const toNullable = (schema) => z.union([nullSchema, schema]);
-//...
-/**
- * Схема для boolean-значений через {@link caseBoolean}
- *
- * Замаскировано под эквивалент: `z.boolean().transform((v) => v)`
- */
-export const booleanSchema = z.unknown().transform((value, ctx) => caseBoolean(value, (result) => result === undefined
-    ? throwValueIssue({
-        ctx,
-        value,
-        message: "It isn't a boolean",
-        expected: "boolean (or string / number like boolean)",
-    })
-    : result));
-/**
- * Сочетает {@link nullSchema} и {@link booleanSchema}
- */
-export const booleanSchemaOptional = toNullable(booleanSchema);
-//...
-/**
- * Схема для числовых значений через {@link caseNumber}
- *
- * Замаскировано под эквивалент: `z.union([z.number(), z.string()]).transform((v) => Number(v))`
- */
-export const numberSchema = z.unknown().transform((value, ctx) => caseNumber(value, (result) => result === undefined
-    ? throwValueIssue({
-        ctx,
-        value,
-        message: "It isn't a number",
-        expected: "number (or string like number)",
-    })
-    : result));
-/**
- * Сочетает {@link nullSchema} и {@link numberSchema}
- */
-export const numberSchemaOptional = toNullable(numberSchema);
-/**
- * Отличается типизацией от {@link numberSchema} тем, что якобы не принимает строки
- *
- * Замаскировано под эквивалент: `z.number().transform((v) => v)`
- *
- * @example
- * ```typescript
- * numberStrictSchema.parse(42);     // 42
- * numberStrictSchema.parse("42");   // Ошибка типизации!
- * ```
- */
-export const numberStrictSchema = numberSchema;
-/**
- * Сочетает {@link nullSchema} и {@link numberStrictSchema}
- */
-export const numberStrictSchemaOptional = numberSchemaOptional;
-//...
-/**
- * Схема для строковых значений через {@link caseString}
- *
- * Замаскировано под эквивалент: `z.union([z.number(), z.string()]).transform((v) => String(v))`
- */
-export const stringSchema = z.unknown().transform((value, ctx) => caseString(value, (result) => {
-    const trimmed = result === undefined ? "" : result.trim();
-    return trimmed === ""
-        ? throwValueIssue({
-            ctx,
-            value,
-            message: "It isn't a string or empty string",
-            expected: "string (or number)",
-        })
-        : trimmed;
-}));
-/**
- * Сочетает {@link nullSchema} и {@link stringSchema}
- */
-export const stringSchemaOptional = toNullable(stringSchema);
-/**
- * Отличается типизацией от {@link stringSchema} тем, что якобы не принимает числа
- *
- * Замаскировано под эквивалент: `z.string().transform((v) => v)`
- *
- * @example
- * ```typescript
- * stringStrictSchema.parse("hello"); // "hello"
- * stringStrictSchema.parse(42);      // Ошибка типизации!
- * ```
- */
-export const stringStrictSchema = stringSchema;
-/**
- * Сочетает {@link nullSchema} и {@link stringStrictSchema}
- */
-export const stringStrictSchemaOptional = stringSchemaOptional;
-//...
-/**
- * Схема для {@link ZoneStamp}
- */
-export const zoneStampSchema = z.object({
-    stamp: numberSchema,
-    zone: numberSchema,
-});
-/**
- * Сочетает {@link nullSchema} и {@link zoneStampSchema}
- */
-export const zoneStampSchemaOptional = toNullable(zoneStampSchema);
-/**
- * Строгая версия {@link zoneStampSchema}, которая не якобы принимает строковые представления чисел
- *
- * @example
- * ```typescript
- * zoneStampStrictSchema.parse({ stamp: 1234567890, zone: 3 });     // { stamp: 1234567890, zone: 3 }
- * zoneStampStrictSchema.parse({ stamp: 1234567890, zone: "3" }); // Ошибка типизации!
- * ```
- */
-export const zoneStampStrictSchema = zoneStampSchema;
-/**
- * Сочетает {@link nullSchema} и {@link zoneStampStrictSchema}
- */
-export const zoneStampStrictSchemaOptional = zoneStampSchemaOptional;
-//...
-/**
- * Схема для {@link LWH}
- */
-export const lwhSchema = z.object({
-    length: numberSchema,
-    width: numberSchema,
-    height: numberSchema,
-});
-/**
- * Сочетает {@link nullSchema} и {@link lwhSchema}
- */
-export const lwhSchemaOptional = toNullable(lwhSchema);
-/**
- * Отличается типизацией от {@link lwhSchema} тем, что якобы не принимает строковые представления чисел
- *
- * @example
- * ```typescript
- * lwhStrictSchema.parse({ length: 10, width: 20, height: 30 });        // { length: 10, width: 20, height: 30 }
- * lwhStrictSchema.parse({ length: "10", width: "20", height: "30" });  // Ошибка типизации!
- * ```
- */
-export const lwhStrictSchema = lwhSchema;
-/**
- * Сочетает {@link nullSchema} и {@link lwhStrictSchema}
- */
-export const lwhStrictSchemaOptional = lwhSchemaOptional;
-//...
-/**
- * Коллекция расширенных {@link https://zod.dev Zod}-схем со встроенными преобразованиями типов
- *
- * @example
- * ```typescript
- * import { xod } from "./xod.js"; // or import xod from "./xod.js";
- *
- * const userSchema = z.object({
- *   name: xod.string,           // Принимает string и number
- *   age: xod.number,            // Принимает number и string
- *   isActive: xod.boolean,      // Принимает boolean, number, string
- *   notes: xod.stringOptional,  // Принимает string, number, null, undefined
- *   created: xod.zoneStamp,     // Принимает объект с временной меткой и зоной
- * });
- * ```
- */
-export const xod = {
-    throwValueIssue,
-    toNullable,
-    null: nullSchema,
-    boolean: booleanSchema,
-    booleanOptional: booleanSchemaOptional,
-    number: numberSchema,
-    numberStrict: numberStrictSchema,
-    numberOptional: numberSchemaOptional,
-    numberStrictOptional: numberStrictSchemaOptional,
-    string: stringSchema,
-    stringStrict: stringStrictSchema,
-    stringOptional: stringSchemaOptional,
-    stringStrictOptional: stringStrictSchemaOptional,
-    zoneStamp: zoneStampSchema,
-    zoneStampOptional: zoneStampSchemaOptional,
-    zoneStampStrict: zoneStampStrictSchema,
-    zoneStampStrictOptional: zoneStampStrictSchemaOptional,
-    lwh: lwhSchema,
-    lwhOptional: lwhSchemaOptional,
-    lwhStrict: lwhStrictSchema,
-    lwhStrictOptional: lwhStrictSchemaOptional,
-};