@elcrm/form 0.0.63 → 0.0.65

package/dist/fields/Range.js

@@ -0,0 +1,103 @@
+import e from "../styles/Field.module.js";
+import t from "../core/Field.js";
+import { useFormFieldState as n } from "../hooks/use.js";
+import r from "react";
+import { jsx as i, jsxs as a } from "react/jsx-runtime";
+//#region src/lib/fields/Range.tsx
+function o(e, t, n) {
+	let r = e;
+	return Number.isFinite(r) || (r = t), Math.min(n, Math.max(t, r));
+}
+function s(e, t, n, r) {
+	return o(!Number.isFinite(r) || r <= 0 ? e : t + Math.round((e - t) / r) * r, t, n);
+}
+function c({ value: c = 0, form: l, onValue: u, onBlur: d, name: f = "", placeholder: p = "", label: m = "", error: h = "", hidden: g = !1, disabled: _ = !1, className: v = "", after: y = "", before: b = "", min: x = 0, max: S = 100, step: C = 1 }) {
+	let { value: w } = n(l, f, c), T = o(Number(w), x, S), E = S === x ? 0 : (T - x) / (S - x) * 100, D = E >= 99.999, O = !_, k = r.useRef(null), A = r.useCallback((e) => {
+		let t = {
+			value: s(e, x, S, C),
+			name: f || ""
+		};
+		l && f && l.setValue(t), u && u !== l?.onValue && u(t);
+	}, [
+		l,
+		f,
+		u,
+		x,
+		S,
+		C
+	]), j = r.useCallback((e) => {
+		let t = k.current;
+		if (!t) return x;
+		let n = t.getBoundingClientRect(), r = n.width || 1;
+		return s(x + (e - n.left) / r * (S - x), x, S, C);
+	}, [
+		x,
+		S,
+		C
+	]), M = (e) => {
+		O && (e.preventDefault(), e.currentTarget.setPointerCapture(e.pointerId), A(j(e.clientX)));
+	}, N = (e) => {
+		O && e.currentTarget.hasPointerCapture(e.pointerId) && A(j(e.clientX));
+	}, P = (e) => {
+		try {
+			e.currentTarget.releasePointerCapture(e.pointerId);
+		} catch {}
+	}, F = (e) => {
+		if (!O) return;
+		let t = T;
+		if (e.key === "ArrowRight" || e.key === "ArrowUp") t = T + C;
+		else if (e.key === "ArrowLeft" || e.key === "ArrowDown") t = T - C;
+		else if (e.key === "Home") t = x;
+		else if (e.key === "End") t = S;
+		else if (e.key === "PageUp") t = T + C * 10;
+		else if (e.key === "PageDown") t = T - C * 10;
+		else return;
+		e.preventDefault(), A(s(t, x, S, C));
+	}, I = () => {
+		if (!d || !f) return;
+		let e = l && f ? l.getValue(f, c) : T;
+		d({
+			value: o(Number(e), x, S),
+			name: f
+		});
+	};
+	return g && (w == null || w === "") ? null : /* @__PURE__ */ a(t, {
+		type: "range",
+		label: m,
+		error: h,
+		element_blok: { className: [v || ""] },
+		element_input: {
+			className: [e.w, e.range],
+			props: { "data-disabled": _ || !O ? "true" : void 0 }
+		},
+		children: [
+			b,
+			/* @__PURE__ */ i("div", { children: /* @__PURE__ */ i("div", {
+				ref: k,
+				className: e.rangeTrack,
+				role: "slider",
+				tabIndex: O ? 0 : -1,
+				"aria-label": m || p || "Диапазон",
+				"aria-valuemin": x,
+				"aria-valuemax": S,
+				"aria-valuenow": T,
+				"data-disabled": _ || !O ? "true" : void 0,
+				onPointerDown: M,
+				onPointerMove: N,
+				onPointerUp: P,
+				onPointerCancel: P,
+				onKeyDown: F,
+				onBlur: I,
+				children: /* @__PURE__ */ i("div", {
+					className: D ? `${e.rangeFill} ${e.rangeFillFull}` : e.rangeFill,
+					style: { width: `${E}%` },
+					"aria-hidden": !0
+				})
+			}) }),
+			y
+		]
+	});
+}
+c.displayName = "RangeField";
+//#endregion
+export { c as default };

package/dist/fields/Select.d.ts

@@ -0,0 +1,21 @@
+import { TInput } from './type';
+type SelectOptionObject = Record<number, {
+    n: string;
+    s: number;
+}>;
+type SelectOptionArrayItem = {
+    id?: number;
+    i?: number;
+    n: string;
+    s?: number;
+};
+type SelectOptions = SelectOptionObject | SelectOptionArrayItem[];
+export type TSelect = TInput & {
+    options?: SelectOptions;
+    order?: number[];
+};
+declare function SelectField({ value, form, onValue, name, placeholder, label, error, hidden, disabled, className, after, before, options, order, }: TSelect): import("react/jsx-runtime").JSX.Element | "";
+declare namespace SelectField {
+    var displayName: string;
+}
+export default SelectField;

package/dist/fields/Select.js

@@ -0,0 +1,146 @@
+import e from "../core/Field.js";
+import { useFormFieldState as t } from "../hooks/use.js";
+import n from "../styles/Select.module.js";
+import r from "react";
+import { Fragment as i, jsx as a, jsxs as o } from "react/jsx-runtime";
+import { createPortal as s } from "react-dom";
+//#region src/lib/fields/Select.tsx
+function c({ value: c = 0, form: u, onValue: d, name: f = "", placeholder: p = "", label: m, error: h, hidden: g = !1, disabled: _ = !1, className: v, after: y = "", before: b = "", options: x, order: S }) {
+	let [C, w] = r.useState(!1), [T, E] = r.useState(0), [D, O] = r.useState(null), k = r.useId(), { value: A } = t(u, f, c ?? 0), j = Number(A), M = [];
+	x && (M = Array.isArray(x) ? x.map((e) => ({
+		id: e.id ?? e.i ?? 0,
+		label: e.n || "",
+		hidden: e.s === 0
+	})).filter((e) => e.id !== 0 && e.label.length > 0) : Object.keys(x).map((e) => {
+		let t = Number(e), n = x[t];
+		return {
+			id: t,
+			label: n?.n || "",
+			hidden: n?.s === 0
+		};
+	}).filter((e) => e.label.length > 0));
+	let N = (() => {
+		if (!S || S.length === 0) return M;
+		let e = new Map(M.map((e) => [e.id, e]));
+		return S.map((t) => e.get(t)).filter((e) => !!e);
+	})().filter((e) => !e.hidden), P = (e) => N.find((t) => t.id === e)?.label, F = C && N.length > 0 ? `${k}-opt-${T}` : void 0, I = (e) => {
+		let t = {
+			value: e,
+			name: f
+		};
+		u && f && u.onValue(t), d && d !== u?.onValue && d(t);
+	}, L = (e) => {
+		if (N.length === 0 || _) return;
+		let t = N.findIndex((e) => e.id === j);
+		O(e.getBoundingClientRect()), E(t >= 0 ? t : 0), w(!0);
+	}, R = (e) => {
+		L(e.currentTarget);
+	}, z = (e) => {
+		if (!_ && N.length !== 0) {
+			if (!C && (e.key === "ArrowDown" || e.key === "Enter" || e.key === " ")) {
+				e.preventDefault(), L(e.currentTarget);
+				return;
+			}
+			if (C) {
+				if (e.key === "Escape") {
+					e.preventDefault(), w(!1);
+					return;
+				}
+				if (e.key === "ArrowDown") {
+					e.preventDefault(), E((e) => (e + 1) % N.length);
+					return;
+				}
+				if (e.key === "ArrowUp") {
+					e.preventDefault(), E((e) => e - 1 < 0 ? N.length - 1 : e - 1);
+					return;
+				}
+				if (e.key === "Enter") {
+					e.preventDefault();
+					let t = N[T];
+					t && I(t.id), w(!1);
+				}
+			}
+		}
+	}, B = {};
+	p && (B.placeholder = p);
+	let V = j === 0 || P(j) === void 0;
+	return g && V ? "" : /* @__PURE__ */ o(i, { children: [/* @__PURE__ */ o(e, {
+		type: "select",
+		label: m,
+		element_blok: { className: [v || ""] },
+		error: h,
+		element_input: {
+			className: [n.f],
+			props: {
+				onClick: R,
+				onKeyDown: z,
+				tabIndex: _ ? -1 : 0,
+				role: "combobox",
+				"aria-expanded": C,
+				"aria-haspopup": "listbox",
+				"aria-controls": k,
+				...F ? { "aria-activedescendant": F } : {},
+				"aria-disabled": _,
+				"data-disabled": _
+			}
+		},
+		children: [
+			b,
+			/* @__PURE__ */ a("div", {
+				...B,
+				children: P(j) || p || ""
+			}),
+			y
+		]
+	}), C && s(/* @__PURE__ */ a(l, {
+		parent: D || void 0,
+		onValue: I,
+		className: v,
+		items: N,
+		setOpen: w,
+		listId: k,
+		activeIndex: T,
+		currentValue: j
+	}), document.body)] });
+}
+c.displayName = "SelectField";
+var l = ({ onValue: e, parent: t, className: r, items: s, setOpen: c, listId: l, activeIndex: d, currentValue: f }) => {
+	if (!t) return null;
+	let p = () => {
+		c(!1);
+	}, m = (t) => {
+		c(!1), e(t);
+	}, h = window.innerHeight - t.bottom < 306 ? Math.max(6, t.top - 300 - 6) : Math.min(window.innerHeight - 300 - 6, t.bottom + 6), g = Math.max(t.width, 260), _ = Math.min(Math.max(6, t.left), window.innerWidth - g - 6);
+	return /* @__PURE__ */ o(i, { children: [/* @__PURE__ */ a("div", {
+		className: n.o,
+		onClick: p,
+		"aria-hidden": !0
+	}), /* @__PURE__ */ a("div", {
+		className: [n.l, r].filter((e) => e !== void 0).join(" "),
+		style: {
+			top: h + "px",
+			left: _ + "px",
+			width: g
+		},
+		children: /* @__PURE__ */ a(u, {
+			listId: l,
+			items: s,
+			link: m,
+			activeIndex: d,
+			currentValue: f
+		})
+	})] });
+}, u = ({ listId: e, items: t, link: n, activeIndex: r, currentValue: i }) => /* @__PURE__ */ a("ul", {
+	id: e,
+	role: "listbox",
+	children: t.map((t, o) => /* @__PURE__ */ a("li", {
+		id: `${e}-opt-${o}`,
+		role: "option",
+		"aria-selected": i === t.id,
+		"data-focus": r === o ? "true" : "false",
+		onClick: () => n(t.id),
+		children: t.label
+	}, t.id))
+});
+//#endregion
+export { c as default };

package/dist/fields/Textarea.d.ts

@@ -0,0 +1,7 @@
+import { TInput } from './type';
+/** TextareaField — многострочное поле (contentEditable). */
+declare function TextareaField({ value, form, onValue, name, placeholder, label, hidden, disabled, onBlur: onBlurField, className, after, before, error, inputmode, maxLength, spellCheck, }: TInput): import("react/jsx-runtime").JSX.Element;
+declare namespace TextareaField {
+    var displayName: string;
+}
+export default TextareaField;

package/dist/fields/Textarea.js

@@ -0,0 +1,52 @@
+import e from "../styles/Field.module.js";
+import t from "../core/Field.js";
+import { useFormFieldState as n } from "../hooks/use.js";
+import r, { asEditableClipboard as i } from "../events/onEvent.js";
+import { isEmptyTextLike as a } from "./visibility.js";
+import "react";
+import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
+//#region src/lib/fields/Textarea.tsx
+function l({ value: l, form: u, onValue: d, name: f = "", placeholder: p = "", label: m = "", hidden: h = !1, disabled: g = !1, onBlur: _, className: v = "", after: y = "", before: b = "", error: x = "", inputmode: S = "text", maxLength: C, spellCheck: w = !0 }) {
+	let { value: T, version: E } = n(u, f || "", l), D = !g, O = (e) => {
+		let t = {
+			value: e.currentTarget.innerText,
+			name: f || ""
+		};
+		u && f && u.onValue(t), d && d !== u?.onValue && d(t);
+	}, k = (e) => {
+		let t = (e.currentTarget.textContent ?? "").trim();
+		C && t.length >= C && e.key !== "Backspace" && e.preventDefault(), e.key === "Enter" && !e.shiftKey && e.preventDefault();
+	}, A = (e) => r.Paste(C || 0, i(e));
+	if (h && a(T)) return /* @__PURE__ */ s(o, {});
+	let j = {};
+	return p && (j.placeholder = p), D && (j.edit = ""), j.inputMode = S || "text", /* @__PURE__ */ c(t, {
+		type: "note",
+		label: m,
+		error: x,
+		element_blok: { className: [v || ""] },
+		element_input: { className: [e.n] },
+		children: [
+			b,
+			/* @__PURE__ */ s("div", {
+				onPaste: A,
+				onInput: O,
+				onBlur: (e) => {
+					r.Blur(e), _?.({
+						value: (e.currentTarget.textContent ?? "").trim(),
+						name: f || ""
+					});
+				},
+				onKeyDown: k,
+				spellCheck: w,
+				contentEditable: D ? "plaintext-only" : !1,
+				suppressContentEditableWarning: !0,
+				...j,
+				children: T
+			}, E),
+			y
+		]
+	});
+}
+l.displayName = "TextareaField";
+//#endregion
+export { l as default };

package/dist/fields/Time.d.ts

@@ -0,0 +1,26 @@
+import { TInput } from './type';
+/** Значение в форме: строка `HH:mm` или пустая строка */
+export type TTime = TInput & {
+    /** Шаг для минут в секундах (`60` — любая минута; `300` — кратно 5 мин) */
+    step?: number;
+    /** Минимальное время `HH:mm` */
+    min?: string;
+    /** Максимальное время `HH:mm` */
+    max?: string;
+    /**
+     * Выравнивание пары «часы : минуты» внутри поля:
+     * `start` — слева (как у даты), `center` — по центру капсулы.
+     * @default 'start'
+     */
+    align?: "start" | "center";
+};
+/**
+ * Время: два contentEditable по образцу Mask (каретка через queueMicrotask + setCursorPosition).
+ * Пока фокус в группе — в DOM только введённые цифры без ведущих нулей; в форму значение
+ * уходит при уходе фокуса с группы (snap минут, clamp, формат `HH:mm`).
+ */
+declare function TimeField({ value, form, onValue: _onValue, onBlur: onBlurField, name, placeholder, label, hidden, disabled, error, className, after, before, step, min, max, id, spellCheck, align, }: TTime): import("react/jsx-runtime").JSX.Element | null;
+declare namespace TimeField {
+    var displayName: string;
+}
+export default TimeField;

package/dist/fields/Time.js

@@ -0,0 +1,254 @@
+import e from "../styles/Field.module.js";
+import t from "../core/Field.js";
+import { useFormFieldState as n } from "../hooks/use.js";
+import r from "../events/onEvent.js";
+import i from "react";
+import { jsx as a, jsxs as o } from "react/jsx-runtime";
+//#region src/lib/fields/Time.tsx
+function s(e) {
+	let t = window.getSelection();
+	if (!t || t.rangeCount === 0) return 0;
+	let n = t.getRangeAt(0);
+	if (!e.contains(n.startContainer)) return 0;
+	let r = document.createRange();
+	return r.selectNodeContents(e), r.setEnd(n.startContainer, n.startOffset), r.toString().length;
+}
+function c(e, t) {
+	let n = t.firstChild;
+	if (!n || n.nodeType !== Node.TEXT_NODE) return;
+	let r = n.textContent?.length ?? 0, i = Math.max(0, Math.min(e, r)), a = document.createRange(), o = window.getSelection();
+	o && (a.setStart(n, i), a.collapse(!0), o.removeAllRanges(), o.addRange(a), t.focus());
+}
+function l(e) {
+	return String(e).padStart(2, "0");
+}
+function u(e) {
+	return (e || "").replace(/\D/g, "");
+}
+function d(e) {
+	if (e == null || e === "" || typeof e != "string") return "";
+	let t = e.trim(), n = /^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(t);
+	if (!n) return "";
+	let r = Math.min(23, Math.max(0, parseInt(n[1], 10))), i = Math.min(59, Math.max(0, parseInt(n[2], 10)));
+	return `${l(r)}:${l(i)}`;
+}
+function f(e) {
+	let t = d(e);
+	if (!t) return {
+		h: null,
+		m: null
+	};
+	let [n, r] = t.split(":").map((e) => parseInt(e, 10));
+	return {
+		h: n,
+		m: r
+	};
+}
+function p(e, t) {
+	if (e === null && t === null) return "";
+	let n = e ?? 0, r = t ?? 0;
+	return `${l(n)}:${l(r)}`;
+}
+function m(e, t) {
+	let n = u(e).slice(0, 2);
+	if (n === "") return null;
+	let r = parseInt(n, 10);
+	return Number.isNaN(r) ? null : Math.min(t, Math.max(0, r));
+}
+function h(e) {
+	let t = d(e);
+	if (!t) return null;
+	let [n, r] = t.split(":").map((e) => parseInt(e, 10));
+	return n * 60 + r;
+}
+function g(e, t) {
+	let n = Math.max(1, Math.round(t / 60));
+	if (n <= 1) return e;
+	let r = Math.round(e / n) * n;
+	return Math.min(59, Math.max(0, r));
+}
+function _(e, t, n) {
+	let r = d(e);
+	if (!r) return "";
+	let i = h(r);
+	if (i === null) return "";
+	if (t) {
+		let e = h(t);
+		e !== null && (i = Math.max(i, e));
+	}
+	if (n) {
+		let e = h(n);
+		e !== null && (i = Math.min(i, e));
+	}
+	return p(Math.floor(i / 60), i % 60);
+}
+function v({ value: h = "", form: v, onValue: ee, onBlur: y, name: b = "", placeholder: x = "", label: S = "", hidden: C = !1, disabled: w = !1, error: T = "", className: E = "", after: D = "", before: te = "", step: O = 60, min: k, max: A, id: j, spellCheck: M = !1, align: N = "start" }) {
+	let { value: P, version: F } = n(v, b, h), I = d(P), L = !w, R = i.useRef(null), z = i.useRef(null), B = i.useRef(null), [V, H] = i.useState(!1);
+	i.useLayoutEffect(() => {
+		if (!V || !L) return;
+		let { h: e, m: t } = f(I), n = (e, t) => {
+			e && (t === null ? e.innerHTML = "<br>" : e.textContent = String(t));
+		};
+		n(R.current, e), n(z.current, t);
+	}, [
+		V,
+		I,
+		F,
+		L
+	]);
+	let U = i.useCallback(() => {
+		let e = m(R.current?.textContent || "", 23), t = m(z.current?.textContent || "", 59);
+		if (e === null && t === null) return "";
+		let n = p(e, t);
+		if (!n) return "";
+		let { h: r, m: i } = f(n);
+		return i !== null && (n = p(r, g(i, O))), n &&= _(n, k, A), n || "";
+	}, [
+		k,
+		A,
+		O
+	]), W = (e) => (t) => {
+		if (t.preventDefault(), !L) return;
+		let n = u(t.clipboardData?.getData("text/plain") ?? ""), r = e === "hour" ? 23 : 59;
+		if (n.length >= 4) {
+			let e = Math.min(23, Math.max(0, parseInt(n.slice(0, 2), 10))), t = Math.min(59, Math.max(0, parseInt(n.slice(2, 4), 10))), r = R.current, i = z.current;
+			r && (r.textContent = String(e), queueMicrotask(() => c(String(e).length, r))), i && (i.textContent = String(t), queueMicrotask(() => c(String(t).length, i)));
+			return;
+		}
+		let i = n.slice(0, 2), a = t.currentTarget;
+		if (i === "") {
+			a.innerHTML = "<br>", queueMicrotask(() => c(0, a));
+			return;
+		}
+		let o = parseInt(i, 10);
+		if (Number.isNaN(o)) return;
+		let s = String(Math.min(r, Math.max(0, o)));
+		a.textContent = s, queueMicrotask(() => c(s.length, a));
+	}, G = (e) => {
+		let t = e.target, n = t.textContent || "", r = s(t), i = n.slice(0, r).replace(/\D/g, "").length, a = u(n).slice(0, 2);
+		if (a === "") {
+			t.innerHTML = "<br>", queueMicrotask(() => c(0, t));
+			return;
+		}
+		let o = parseInt(a, 10);
+		if (Number.isNaN(o)) return;
+		let l = String(Math.min(23, Math.max(0, o)));
+		t.textContent = l;
+		let d = Math.min(i, l.length);
+		queueMicrotask(() => c(d, t));
+	}, K = (e) => {
+		let t = e.target, n = t.textContent || "", r = s(t), i = n.slice(0, r).replace(/\D/g, "").length, a = u(n).slice(0, 2);
+		if (a === "") {
+			t.innerHTML = "<br>", queueMicrotask(() => c(0, t));
+			return;
+		}
+		let o = parseInt(a, 10);
+		if (Number.isNaN(o)) return;
+		let l = String(Math.min(59, Math.max(0, o)));
+		t.textContent = l;
+		let d = Math.min(i, l.length);
+		queueMicrotask(() => c(d, t));
+	}, q = (e) => {
+		(e.key === "Enter" || e.key === ":") && (e.preventDefault(), z.current?.focus());
+	}, J = (e) => {
+		e.key === "Enter" && e.preventDefault();
+	}, Y = (e) => {
+		let t = e.currentTarget;
+		(t.textContent || "").trim().length || (t.innerHTML = "<br>"), L && H(!0);
+	}, X = (e) => {
+		r.Blur(e);
+	};
+	i.useEffect(() => {
+		let e = B.current;
+		if (!e) return;
+		let t = (t) => {
+			let n = t.relatedTarget;
+			if (n && e.contains(n)) return;
+			let r = U();
+			v && b && v.setValue({
+				name: b,
+				value: r
+			}), y && b && y({
+				value: r,
+				name: b
+			}), H(!1);
+		};
+		return e.addEventListener("focusout", t), () => e.removeEventListener("focusout", t);
+	}, [
+		v,
+		b,
+		y,
+		k,
+		A,
+		O,
+		U
+	]);
+	let { h: Z, m: Q } = f(I), $ = {};
+	return x && ($.placeholder = x), L && ($.edit = ""), C && I === "" ? null : /* @__PURE__ */ o(t, {
+		type: "time",
+		label: S,
+		error: T,
+		element_blok: { className: [E || ""] },
+		element_input: {
+			className: [
+				e.w,
+				e.time,
+				N === "center" ? e.timeAlignCenter : ""
+			].filter(Boolean),
+			props: { "data-disabled": w || !L ? "true" : void 0 }
+		},
+		children: [
+			te,
+			/* @__PURE__ */ o("div", {
+				ref: B,
+				className: e.timeInner,
+				role: "group",
+				"aria-label": S || "Время",
+				children: [
+					/* @__PURE__ */ a("div", {
+						id: j,
+						ref: R,
+						className: e.timePart,
+						contentEditable: L ? "plaintext-only" : !1,
+						suppressContentEditableWarning: !0,
+						spellCheck: M,
+						inputMode: "numeric",
+						onPaste: W("hour"),
+						onInput: G,
+						onKeyDown: q,
+						onFocus: Y,
+						onBlur: X,
+						"aria-label": "Часы, 0–23",
+						...$,
+						children: !L || !V ? Z === null ? "" : l(Z) : null
+					}),
+					/* @__PURE__ */ a("span", {
+						className: e.timeSep,
+						"aria-hidden": "true",
+						children: ":"
+					}),
+					/* @__PURE__ */ a("div", {
+						ref: z,
+						className: e.timePart,
+						contentEditable: L ? "plaintext-only" : !1,
+						suppressContentEditableWarning: !0,
+						spellCheck: M,
+						inputMode: "numeric",
+						onPaste: W("minute"),
+						onInput: K,
+						onKeyDown: J,
+						onFocus: Y,
+						onBlur: X,
+						"aria-label": "Минуты, 0–59",
+						...$,
+						children: !L || !V ? Q === null ? "" : l(Q) : null
+					})
+				]
+			}, F),
+			D
+		]
+	});
+}
+v.displayName = "TimeField";
+//#endregion
+export { v as default };

package/dist/fields/type.d.ts

@@ -0,0 +1,77 @@
+import { ReactNode } from 'react';
+import { UseFormApi } from '../hooks/use';
+/** Связь с формой и колбэки значения */
+export type TFieldFormBindings = {
+    value?: unknown;
+    form?: UseFormApi;
+    onValue?: (data: TValue) => void | Promise<void>;
+    /** Колбэк при потере фокуса (коммит значения), не нативный `FocusEvent` */
+    onBlur?: (data: TValue) => void | Promise<void>;
+    name?: string;
+};
+/** Подпись, доступность, видимость */
+export type TFieldPresentation = {
+    /** Подпись поля (визуально в `<dt>`) */
+    label?: string;
+    placeholder?: string;
+    /** true — только просмотр, без ввода (аналог нативного disabled) */
+    disabled?: boolean;
+    /**
+     * true — если значение поля **пустое**, поле не рендерится;
+     * при непустом значении поле показывается.
+     */
+    hidden?: boolean;
+    error?: string;
+    after?: ReactNode;
+    before?: ReactNode;
+    view?: string;
+    id?: string;
+    className?: string;
+    isCopy?: boolean;
+    maxLength?: number;
+    /**
+     * Проверка орфографии для **текстового** ввода (`Input`, `Textarea`).
+     * Для полей только с цифрами в компонентах выставляется **`false`**.
+     */
+    spellCheck?: boolean;
+    /**
+     * Подсказка клавиатуры на мобильных (`inputMode`).
+     * Для **чисел** — `numeric`, для **денег** — `decimal`, **телефон** — `tel` (по умолчанию в полях).
+     */
+    inputmode?: "text" | "email" | "none" | "tel" | "url" | "search" | "numeric" | "decimal";
+    /**
+     * Нативный `<input>` вместо **contentEditable** (`StringField`).
+     * Нужен для **автозаполнения логина/почты** (менеджеры паролей работают с нативными полями).
+     * У **`PasswordField`** свой проп **`native`** (см. **`TPasswordField`**).
+     */
+    native?: boolean;
+    /**
+     * Атрибут **`autocomplete`** (например **`username`**, **`email`**, **`off`**).
+     * Осмысленно при **`native`**; у `contentEditable` браузеры почти не применяют автозаполнение.
+     */
+    autoComplete?: string;
+    /**
+     * Тип нативного поля при **`native`** (по умолчанию **`text`**).
+     * Для почты удобно **`email`** + **`autoComplete="email"`**.
+     */
+    inputType?: "text" | "email" | "search" | "tel" | "url";
+};
+/** Базовые пропы текстовых и составных полей */
+export type TInput = TFieldFormBindings & TFieldPresentation;
+export type TValue = {
+    value: unknown;
+    name: string;
+    id?: string;
+};
+/**
+ * Поле пароля: **`native`** из `TInput` убран — здесь свой **`native`** = «не рендерить поле».
+ */
+export type TPasswordField = Omit<TInput, "native"> & {
+    /** true — компонент не рендерится (пустая строка), пароль отдаётся нативному `<input>` снаружи */
+    native?: boolean;
+    /**
+     * Свои иконки переключателя **[показать пароль, скрыть пароль]** (когда ввод скрыт / виден).
+     * Если не задано — используются встроенные SVG.
+     */
+    eyes?: [React.ReactNode?, React.ReactNode?];
+};