altum 0.0.4 → 0.0.5

package/dist/styles/toggleBox.module.css.js

@@ -1 +1 @@
-"use client";import{injectCss as o}from"../utils/injectCss.js";var r='._9TRXw[data-align=start] .yMKDd{margin-top:var(--altum-toggle-align-nudge)}._9TRXw:active .sppC0:not(:disabled,[aria-readonly=true])~.yMKDd,._9TRXw:hover .sppC0:not(:checked):not(:disabled,[aria-readonly=true])~.yMKDd{border-color:var(--altum-color-border-hover)}._9TRXw:has(.sppC0[aria-readonly=true]) .yMKDd{background-color:var(--altum-color-control-bg-readonly);border-color:var(--altum-color-control-border-readonly);border-style:dashed}._9TRXw:has(.sppC0[aria-readonly=true]):hover .yMKDd{border-color:var(--altum-color-control-border-readonly)}._9TRXw .sppC0:checked~.yMKDd{background-color:var(--altum-color-control-bg-checked);border-color:var(--altum-color-control-border-checked)}:is(._9TRXw .sppC0:checked~.yMKDd):after{opacity:1}._9TRXw .sppC0:focus-visible~.yMKDd{outline:var(--altum-focus-ring-width) solid var(--altum-focus-ring-color);outline-offset:var(--altum-focus-ring-offset)}.sppC0{appearance:none}.yMKDd{background-color:var(--altum-color-control-bg);border:1px solid var(--altum-color-control-border);box-sizing:border-box;display:inline-block;height:var(--altum-toggle-box-size);position:relative;width:var(--altum-toggle-box-size)}.yMKDd,.yMKDd:after{transition:var(--altum-transition-smooth)}.yMKDd:after{content:"";left:50%;opacity:0;position:absolute;top:50%}@media (prefers-reduced-motion:reduce){.yMKDd,.yMKDd:after{transition:none}}';const a={root:"_9TRXw",box:"yMKDd",input:"sppC0"};o(r);export{a as default};
+"use client";import{injectCss as o}from"../utils/injectCss.js";var r='._9TRXw[data-align=start] .yMKDd{margin-top:var(--altum-toggle-align-nudge)}._9TRXw:active .sppC0:not(:disabled,[aria-readonly=true])~.yMKDd,._9TRXw:hover .sppC0:not(:checked):not(:disabled,[aria-readonly=true])~.yMKDd{border-color:var(--altum-color-border-hover)}._9TRXw:has(.sppC0[aria-readonly=true]) .yMKDd{background-color:var(--altum-color-control-bg-readonly);border-color:var(--altum-color-control-border-readonly);border-style:dashed}._9TRXw:has(.sppC0[aria-readonly=true]):hover .yMKDd{border-color:var(--altum-color-control-border-readonly)}._9TRXw .sppC0:checked~.yMKDd{background-color:var(--altum-color-control-bg-checked);border-color:var(--altum-color-control-border-checked)}:is(._9TRXw .sppC0:checked~.yMKDd):after{opacity:1}._9TRXw .sppC0:focus-visible~.yMKDd{outline:var(--altum-focus-ring-width) solid var(--altum-focus-ring-color);outline-offset:var(--altum-focus-ring-offset)}.sppC0{appearance:none}.yMKDd{background-color:var(--altum-color-control-bg);border:1px solid var(--altum-color-control-border);box-sizing:border-box;display:inline-block;flex-shrink:0;height:var(--altum-toggle-box-size);min-height:var(--altum-toggle-box-size);min-width:var(--altum-toggle-box-size);position:relative;width:var(--altum-toggle-box-size)}.yMKDd,.yMKDd:after{transition:var(--altum-transition-smooth)}.yMKDd:after{content:"";left:50%;opacity:0;position:absolute;top:50%}@media (prefers-reduced-motion:reduce){.yMKDd,.yMKDd:after{transition:none}}';const e={root:"_9TRXw",box:"yMKDd",input:"sppC0"};o(r);export{e as default};

package/dist/utils/autoHeight.js

@@ -1 +1 @@
-function n(e,a={}){const{minHeightPx:t=0,maxHeight:o}=a;e.style.maxHeight=o!==void 0?typeof o=="number"?`${o}px`:o:"",e.style.height="auto";const i=e.scrollHeight,r=parseFloat(getComputedStyle(e).maxHeight),l=Number.isFinite(r)?r:1/0,h=Math.min(Math.max(i,t),l);e.style.height=`${h}px`,e.style.overflowY=i>l?"auto":"hidden"}function p(e,a){const t=getComputedStyle(e),o=parseFloat(t.getPropertyValue("--altum-field-control-height"))||0,i=parseFloat(t.lineHeight)||parseFloat(t.fontSize)*1.25,r=parseFloat(t.paddingTop)+parseFloat(t.paddingBottom),l=parseFloat(t.borderTopWidth)+parseFloat(t.borderBottomWidth),h=r+l+i*a;return a<=1&&o>0?Math.max(h,o):h}export{n as adjustElementHeight,p as getTextareaMinHeightPx};
+function n(e,o={}){const{minHeightPx:t=0,maxHeight:a}=o;e.style.maxHeight=a!==void 0?typeof a=="number"?`${a}px`:a:"",e.style.height="auto";const i=e.scrollHeight,r=parseFloat(getComputedStyle(e).maxHeight),h=Number.isFinite(r)?r:1/0,l=Math.min(Math.max(i,t),h);e.style.height=`${l}px`,e.style.overflowY=i>h?"auto":"hidden"}function p(e,o){const t=getComputedStyle(e),a=parseFloat(t.getPropertyValue("--altum-field-size-height"))||0,i=parseFloat(t.lineHeight)||parseFloat(t.fontSize)*1.25,r=parseFloat(t.paddingTop)+parseFloat(t.paddingBottom),h=parseFloat(t.borderTopWidth)+parseFloat(t.borderBottomWidth),l=r+h+i*o;return o<=1&&a>0?Math.max(l,a):l}export{n as adjustElementHeight,p as getTextareaMinHeightPx};

package/dist/utils/date.js

@@ -0,0 +1 @@
+import{localeToBcp47 as D}from"./locale.js";function u(t,e=1){const r=new Date(t),n=r.getDay(),a=e===1?n===0?6:n-1:n;return r.setDate(r.getDate()-a),r.setHours(0,0,0,0),r}function l(t,e=1){const r=u(t,e);return Array.from({length:7},(n,a)=>{const o=new Date(r);return o.setDate(r.getDate()+a),o})}function c(t,e,r){const n=new Date(t.getTime());switch(r){case"minute":n.setMinutes(n.getMinutes()+e);break;case"hour":n.setHours(n.getHours()+e);break;case"day":n.setDate(n.getDate()+e);break;case"week":n.setDate(n.getDate()+e*7);break;case"month":n.setMonth(n.getMonth()+e);break;case"year":n.setFullYear(n.getFullYear()+e);break;default:return r}return n}function s(t){return new Date(t.getFullYear(),t.getMonth(),t.getDate())}function f(t,e){return c(s(t),e,"day")}function m(t,e){return g(t,e)===0}function g(t,e){const r=t.getFullYear()-e.getFullYear();if(r)return r<0?-1:1;const n=t.getMonth()-e.getMonth();if(n)return n<0?-1:1;const a=t.getDate()-e.getDate();return a<0?-1:a>0?1:0}function d(t){const e=/^(\d{4})-(\d{2})-(\d{2})$/.exec(t);if(!e)return null;const r=Number(e[1]),n=Number(e[2]),a=Number(e[3]),o=new Date(r,n-1,a);return o.getFullYear()!==r||o.getMonth()!==n-1||o.getDate()!==a?null:o}function h(t){const e=String(t.getMonth()+1).padStart(2,"0"),r=String(t.getDate()).padStart(2,"0");return`${t.getFullYear()}-${e}-${r}`}function i(t){return(Math.trunc(t)%24+24)%24}function b(t,e){const r=new Date(Date.UTC(2020,0,15,i(t),0,0));return new Intl.DateTimeFormat(D(e),{timeZone:"UTC",hour:"numeric",minute:"2-digit"}).format(r)}function y(t){return`${String(i(t)).padStart(2,"0")}:00`}export{f as addDays,c as addToDate,g as compareDay,b as formatHourLabel,y as formatHourTime,h as formatLocalDate,l as getWeekDays,u as getWeekStart,m as isSameDay,d as parseLocalDate,s as startOfDay};

package/dist/utils/duration.js

@@ -0,0 +1 @@
+const i=60,o=3600,t=86400,r=604800,e={minute:60,hour:3600,day:86400,week:604800};function S(n,u){return n/e[u]}function a(n,u){return n*e[u]}function c(n){return n!==0&&n%604800===0?{unit:"week",value:n/604800}:n!==0&&n%86400===0?{unit:"day",value:n/86400}:n!==0&&n%3600===0?{unit:"hour",value:n/3600}:{unit:"minute",value:n/60}}export{t as DAY_SECONDS,o as HOUR_SECONDS,i as MINUTE_SECONDS,r as WEEK_SECONDS,c as getDurationUnitAndValue,S as secondsToUnit,a as unitToSeconds};

package/dist/utils/eventTarget.js

@@ -0,0 +1 @@
+const i=["input","textarea","select","a",'[contenteditable="true"]'].join(", "),r=['[role="dialog"]','[role="listbox"]','[role="menu"]','[role="tree"]',"[data-side]"].join(",");function a(e){return`[class*="${e.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"]`}function s(e){if(typeof HTMLElement>"u"||!(e instanceof HTMLElement))return!1;const{tagName:t}=e;return t==="INPUT"||t==="TEXTAREA"||t==="SELECT"||e.isContentEditable}function l(e,t){return typeof Element>"u"||!(e instanceof Element)||!t?!1:!!e.closest(t)}function c(e,t,n,o){return typeof Node>"u"||!(e instanceof Node)?!0:!(t?.contains(e)||e instanceof Element&&(n&&e.closest(n)||o&&e.closest(a(o))))}export{i as DEFAULT_DRAG_BLOCKED_SELECTOR,r as DEFAULT_PORTAL_SELECTOR,l as isDragBlockedTarget,s as isEditableTarget,c as isOutsideFormInteraction};

package/dist/utils/injectCss.js

@@ -1 +1 @@
-function n(t){if(typeof document>"u")return;const e=document.createElement("style");e.textContent=t,document.head.appendChild(e)}export{n as injectCss};
+function n(t){if(typeof document>"u")return;const e=document.createElement("style");e.textContent=`@layer altum{${t}}`,document.head.appendChild(e)}export{n as injectCss};

package/dist/utils/locale.js

@@ -0,0 +1 @@
+function n(e){return e==="en"?"en-US":"ru-RU"}export{n as localeToBcp47};

package/dist/utils/plural.js

@@ -0,0 +1 @@
+function o(u,t,n,l){const e=Math.abs(Math.trunc(u)),a=e%10,r=e%100;return a===1&&r!==11?t:a>=2&&a<=4&&(r<12||r>14)?n:l}function c(u,t,n){return Math.abs(Math.trunc(u))===1?t:n}function f(u,t,n){return u==="en"?c(t,n.one,n.many):o(t,n.one,n.few,n.many)}export{f as plural,c as pluralEn,o as pluralRu};

package/dist/utils/timezone.js

@@ -0,0 +1 @@
+import{localeToBcp47 as m}from"./locale.js";const c=["UTC","Africa/Cairo","Africa/Johannesburg","America/Anchorage","America/Argentina/Buenos_Aires","America/Chicago","America/Denver","America/Los_Angeles","America/Mexico_City","America/New_York","America/Sao_Paulo","Asia/Dubai","Asia/Hong_Kong","Asia/Kolkata","Asia/Shanghai","Asia/Singapore","Asia/Tokyo","Australia/Sydney","Europe/Berlin","Europe/London","Europe/Moscow","Europe/Paris","Pacific/Auckland","Pacific/Honolulu"];function s(){try{return Intl.DateTimeFormat().resolvedOptions().timeZone||"UTC"}catch{return"UTC"}}function f(){const e=Intl,t=typeof e.supportedValuesOf=="function"?[...e.supportedValuesOf("timeZone")]:[...c];return t.includes("UTC")||t.unshift("UTC"),t}function l(e){if(!e)return!1;try{return!0}catch{return!1}}function a(e,t){try{const n=new Intl.DateTimeFormat("en-US",{timeZone:t,hourCycle:"h23",year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit"}).formatToParts(e),r={};for(const i of n)i.type!=="literal"&&(r[i.type]=i.value);const o=Number(r.hour);return{year:Number(r.year),month:Number(r.month),day:Number(r.day),hour:o===24?0:o,minute:Number(r.minute),second:Number(r.second)}}catch{return null}}function d(e,t=new Date){const n=a(t,e);if(!n)return null;const r=Date.UTC(n.year,n.month-1,n.day,n.hour,n.minute,n.second);return Math.round((r-t.getTime())/6e4)}function y(e,t,n){const r=a(e,n),o=a(t,n);return!r||!o?!1:r.year===o.year&&r.month===o.month&&r.day===o.day}function h(e,t,n,r={}){try{return new Intl.DateTimeFormat(m(n),{...r,timeZone:t}).format(e)}catch{return""}}function u(e,t=new Date){try{return new Intl.DateTimeFormat("en-US",{timeZone:e,timeZoneName:"shortOffset"}).formatToParts(t).find(n=>n.type==="timeZoneName")?.value??""}catch{return""}}function A(e){const t=u(e);return t?`${e} (${t})`:e}export{h as formatInTimeZone,A as formatTimezoneLabel,u as formatTimezoneOffset,s as getBrowserTimezone,f as getSupportedTimezones,d as getTimezoneOffsetMinutes,a as getZonedParts,y as isSameZonedDay,l as isValidTimeZone};

package/docs/COMPONENTS.md

@@ -12,8 +12,8 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **Button** | Кнопка: `variant` (`primary` / `tinted` / `secondary` / `ghost` / `link`) × `status` (`default` / `danger`), иконки, `loading`, `fullWidth`, `shortcut`. |
-| **ButtonIcon** | Иконка-кнопка; `circle` / `square`; по умолчанию `variant="ghost"`. |
+| **Button** | Кнопка: `variant` (`primary` / `tinted` / `secondary` / `danger` / `danger_tinted` / `ghost` / `link`), `prefix` / `postfix`, `loading`, `fullWidth`. |
+| **ButtonIcon** | Иконка-кнопка на базе **Button**; `circle` / `square`; по умолчанию `variant="ghost"`. |
 | **ButtonGroup** | Составная группа (`ButtonGroup` + `ButtonGroup.Item`): `mode` `button` (независимые, выбранность через `active` на Item) / `toggle` (один выбранный, слайдер) / `multi_toggle` (несколько); `itemFit` `equal` \| `content`; `width` `auto` \| `full`; `variant` / `status` / `size` / `borderless` на Root. |
 | **SegmentedControl** | Обёртка над `ButtonGroup` (`mode="toggle"`, `width="full"`): `options` + `value` / `onChange`; `itemFit` `equal` \| `content`; варианты `primary` / `tinted` / `secondary` (по умолчанию) / `ghost` / `plain`. |
 | **Overflow** | Лишние пункты за ⋯ в `Dropdown`. `Overflow.Item` — панель действий; прочие дети — измерение ширины. `longPress` открывает меню долгим нажатием (хост — **`ActionSheetTrigger`**). |
@@ -26,13 +26,13 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **TextField** | Однострочное поле. `keepPlaceholder` — не скрывать placeholder при фокусе пустого поля. |
+| **TextField** | Примитив поля: chrome + `as` (`input` / `textarea` / `button` / `div`). `label` — floating-лейбл; без `label` — поле без подписи (`aria-label` / `placeholder`). `description` — подсказка или слот под chrome. `keepPlaceholder` — не скрывать placeholder при фокусе пустого поля. |
 | **PasswordField** | Пароль на базе TextField: показать/скрыть, опциональный индикатор сложности. |
-| **SearchField** | Обёртка над `TextField` с `labelPlacement="none"` по умолчанию и иконкой поиска (`onClear` от TextField). |
-| **TextareaField** | Многострочное поле на **FieldBase**; авто-рост высоты. |
+| **SearchField** | Обёртка над `TextField` с иконкой поиска (`onClear` от TextField). Без `label` — тулбарный вид. |
+| **TextareaField** | Многострочное поле на **TextField** `as="textarea"`; авто-рост высоты. |
 | **NumberField** | Числовой ввод на базе `TextField` с кнопками +/-. |
 | **MaskedField** | Поле с маской ввода (телефон, дата и т.п.) на базе `TextField`; опционально `maskAsPlaceholder`. Не переопределяйте `padding` / `font-size` на inner `input`. |
-| **PinInput** | PIN / OTP (2FA, код из SMS). |
+| **PinInput** | PIN / OTP: группа ячеек на **TextField**. `label` — **FieldLabel**; `description` / `error` — **FormMessage**. |
 | **Rating** | Оценка звёздами. |
 | **FormMessage** | Подсказка / ошибка / успех под полем; `variant` `hint` / `error` / `success`. |
 | **Select** | Поле выбора: `options`, `value` / `onChange`, `label`, `filterable`; `selectionMode="multiple"` рисует chips. |
@@ -92,7 +92,7 @@
 | **Accordion** | `Accordion.Item` с `title` и содержимым в `children`; `flush` (по умолчанию) / `bordered`; `multiple`, отключённый пункт. |
 | **Badge** | `size` sm/md, `position` overlay/standalone, `variant` включая `error`; overlay — `--altum-badge-overhang`. Числовой `label` ограничивается через `max`; `children` — якорь overlay. |
 | **Avatar** / **AvatarGroup** | Размеры `xs`…`xl`, кольцо статуса, запасная иконка; группа с наложением. |
-| **Chip** | Тег / фильтр: `mode` `chip` \| `tag` \| `toggle` (`as` — deprecated-алиас), `size`, `onRemove` / `onClick`. **`ChipGroup`**: `mode` `chip` \| `tag`, `layout` `wrap` \| `scrollX`. |
+| **Chip** | Тег / фильтр: `mode` `chip` \| `tag` \| `toggle` (`as` — deprecated-алиас), `size`, `onRemove` / `onClick`. **`ChipGroup`**: `mode` `chip` \| `tag`, `gap`. |
 | **StatBadge** | Компактный блок статистики: число + подпись; `variant` `default` / `success` / `warning` / `error`; `size` `md` / `sm`. |
 | **EmptyState** | Пустое состояние: иконка (`--altum-color-empty-icon`), заголовок, описание, действие; `size` для вложенных панелей. |
 | **DescriptionList** | Список «ключ — значение» (`stacked` / `inline`, колонки). |

package/docs/LAYOUT.md

@@ -19,7 +19,7 @@ import {
 } from 'altum';
 ```
 
-Связанные: **FieldBase** — см. [COMPONENTS.md](./COMPONENTS.md).
+Связанные: **TextField** — см. [COMPONENTS.md](./COMPONENTS.md).
 
 ---
 
@@ -34,7 +34,7 @@ import {
 | Поля + Chip + Button в одной строке фильтров | **ControlRow** |
 | Одному ребёнку — `flex: 1` или «не сжимать» | **LayoutItem** (`ControlRow.Item` / `Layout.Item`) |
 | Колонки сетки | **Grid** |
-| Оболочка input (label / prefix / clear) | **FieldBase** |
+| Оболочка input (label / prefix / clear) | **TextField** |
 
 ---
 
@@ -279,4 +279,4 @@ Flex-ячейка внутри Stack / Inline / Split / ControlRow.
 | `Stack` для чипов в ряд | **Inline** |
 | `div` + `display:flex` + px `gap` | **Stack** / **Inline** с токенами |
 | Оборачивать всё в `LayoutItem` | Только где нужны `grow` / `shrink` |
-| Путать `Layout` и `FieldBase` | `Layout` — панель UI; `FieldBase` — оболочка поля ввода |
+| Путать `Layout` и `TextField` | `Layout` — панель UI; `TextField` — оболочка поля ввода |

package/docs/THEMING.md

@@ -4,7 +4,7 @@ altum использует **CSS custom properties** для всех дизай
 
 ## Быстрый старт
 
-Оберните приложение в `ThemeProvider` (установка — [README](../README.md)). Стили инжектятся из JS — отдельный `styles.css` не нужен. По умолчанию `applyTo="wrapper"`. Для порталов (`Modal`, `Sheet`, выпадающие панели, `Notification`) используйте **`applyTo="document"`**, чтобы классы и `data-theme` попали на `html` / `body`. Синхронизация идёт в **`useLayoutEffect`**, чтобы первый кадр совпадал с `initialTheme` / контролируемой `theme`.
+Оберните приложение в `ThemeProvider` (установка — [README](../README.md)). Стили инжектятся из JS — отдельный `styles.css` не нужен. По умолчанию `applyTo="wrapper"`. Для порталов (`Modal`, `Sheet`, выпадающие панели, `Notification`) используйте **`applyTo="document"`**, чтобы классы и `data-theme` попали на `html` / `body` и не дублировались на обёртке. Тогда переопределение токенов на `body` доходит до детей. Синхронизация идёт в **`useLayoutEffect`**, чтобы первый кадр совпадал с `initialTheme` / контролируемой `theme`.
 
 ### Контролируемая тема и хранилище
 
@@ -240,13 +240,13 @@ return (
 
 ### Опасность / деструктив (`--altum-color-danger-*`)
 
-Действия удаления, состояния ошибки. API кнопки: `status="danger"` вместе с `variant` (`primary` — заливка, `secondary` — контур по поверхности, `tinted` — мягкая смывка).
+Действия удаления, состояния ошибки. API кнопки: `variant="danger"` (заливка) и `variant="danger_tinted"` (мягкая смывка).
 
 | Переменная | Назначение |
 |------------|------------|
 | `--altum-color-danger-bg-solid` | Залитая деструктивная кнопка |
-| `--altum-color-danger-text-secondary` | Текст контурной деструктивной (`variant="secondary"`) |
-| `--altum-color-danger-tint-bg` / `--altum-color-danger-tint-text` | Мягкий tint опасности (`variant="tinted"`) |
+| `--altum-color-danger-text-secondary` | Текст контурной деструктивной |
+| `--altum-color-danger-tint-bg` / `--altum-color-danger-tint-text` | Мягкий tint опасности (`variant="danger_tinted"`) |
 
 ### Контролы формы (`--altum-color-input-*`, `--altum-color-control-*`)
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "altum",
-	"version": "0.0.4",
+	"version": "0.0.5",
 	"description": "Библиотека React + TypeScript UI-компонентов: CSS Modules, токены ThemeProvider, адаптация overlay/sheet.",
 	"license": "MIT",
 	"author": "Alexander <azeeson@gmail.com>",
@@ -40,6 +40,11 @@
 			"import": "./dist/entries/icons.js",
 			"default": "./dist/entries/icons.js"
 		},
+		"./locales": {
+			"types": "./types/entries/locales.d.ts",
+			"import": "./dist/entries/locales.js",
+			"default": "./dist/entries/locales.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"files": [

package/types/entries/hooks.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { RefObject, PointerEvent, MouseEvent as MouseEvent$1 } from 'react';
+import { RefObject, PointerEvent, MouseEvent as MouseEvent$1, Dispatch, SetStateAction, ReactNode } from 'react';
 
 interface UseOutsideClickOptions {
     enabled?: boolean;
@@ -84,6 +84,62 @@ declare function usePresence(open: boolean, durationMs: number): {
     presented: boolean;
 };
 
+type FormErrors<T extends Record<string, unknown>> = Partial<Record<keyof T, string>>;
+type FieldValidate<T extends Record<string, unknown>, K extends keyof T> = (value: T[K], values: T) => string | undefined;
+interface RegisterOptions<T extends Record<string, unknown>, K extends keyof T> {
+    getValue?: (payload: unknown) => T[K];
+    validate?: FieldValidate<T, K>;
+}
+declare function useForm<T extends Record<string, unknown>>(initialValues: T): {
+    values: T;
+    errors: Partial<Record<keyof T, string>>;
+    isDirty: boolean;
+    register: <K extends keyof T>(name: K, options?: RegisterOptions<T, K>) => {
+        value: T[K];
+        onChange: (payload: unknown) => void;
+    };
+    hasErrors: boolean;
+    setValues: Dispatch<SetStateAction<T>>;
+    setValue: <K extends keyof T>(name: K, value: T[K]) => void;
+    setError: (name: keyof T, message: string) => void;
+    clearErrors: (name?: keyof T) => void;
+    reset: (next?: T) => void;
+    handleSubmit: (onValid: (values: T) => void) => (event?: {
+        preventDefault?: () => void;
+    }) => void;
+};
+type UseFormReturn<T extends Record<string, unknown>> = ReturnType<typeof useForm<T>>;
+
+declare function useFormContext<T extends Record<string, unknown>>(): UseFormReturn<T>;
+declare function useFormProvider<T extends Record<string, unknown>>(initialValues: T): {
+    FormProvider: {
+        ({ children }: {
+            children?: ReactNode;
+        }): react.FunctionComponentElement<react.ProviderProps<UseFormReturn<Record<string, unknown>> | null>>;
+        displayName: string;
+    };
+    values: T;
+    errors: Partial<Record<keyof T, string>>;
+    isDirty: boolean;
+    register: <K extends keyof T>(name: K, options?: RegisterOptions<T, K> | undefined) => {
+        value: T[K];
+        onChange: (payload: unknown) => void;
+    };
+    hasErrors: boolean;
+    setValues: react.Dispatch<react.SetStateAction<T>>;
+    setValue: <K extends keyof T>(name: K, value: T[K]) => void;
+    setError: (name: keyof T, message: string) => void;
+    clearErrors: (name?: keyof T | undefined) => void;
+    reset: (next?: T | undefined) => void;
+    handleSubmit: (onValid: (values: T) => void) => (event?: {
+        preventDefault?: (() => void) | undefined;
+    }) => void;
+};
+
+type FormRule<T extends Record<string, unknown> = Record<string, unknown>> = (value: unknown, values: T) => string | undefined;
+declare function required(message: string): FormRule;
+declare function pattern(regex: RegExp, message: string): FormRule;
+declare function compose<T extends Record<string, unknown> = Record<string, unknown>>(...rules: FormRule<T>[]): FormRule<T>;
 interface ValidationRules {
     required?: string;
     pattern?: {
@@ -92,16 +148,8 @@ interface ValidationRules {
     };
     validate?: (val: unknown) => string | boolean;
 }
-declare function useForm<T extends Record<string, unknown>>(initialValues: T): {
-    values: T;
-    errors: Record<string, string>;
-    register: (name: keyof T, rules?: ValidationRules) => {
-        value: T[keyof T];
-        onChange: (val: unknown) => void;
-    };
-    hasErrors: boolean;
-    setValues: react.Dispatch<react.SetStateAction<T>>;
-};
+declare function fieldRules(rules: ValidationRules): FormRule;
+declare function checkedValue(payload: unknown): boolean;
 
-export { MOBILE_MEDIA_QUERY, REDUCED_MOTION_QUERY, useBodyScrollLock, useControlledState, useControlledStateWithCallback, useDocumentKeyDown, useEscapeKey, useFocusRestore, useFocusTrap, useForm, useInertSiblings, useLongPress, useMediaQuery, useNow, useOutsideClick, useOverlay, useOverlayPanel, usePrefersReducedMotion, usePresence };
-export type { DocumentKeyDownTarget, UseDocumentKeyDownOptions, UseEscapeKeyOptions, UseFocusTrapOptions, UseLongPressHandlers, UseLongPressOptions, UseOutsideClickOptions, UseOverlayOptions, UseOverlayPanelOptions, ValidationRules };
+export { MOBILE_MEDIA_QUERY, REDUCED_MOTION_QUERY, checkedValue, compose, fieldRules, pattern, required, useBodyScrollLock, useControlledState, useControlledStateWithCallback, useDocumentKeyDown, useEscapeKey, useFocusRestore, useFocusTrap, useForm, useFormContext, useFormProvider, useInertSiblings, useLongPress, useMediaQuery, useNow, useOutsideClick, useOverlay, useOverlayPanel, usePrefersReducedMotion, usePresence };
+export type { DocumentKeyDownTarget, FieldValidate, FormErrors, FormRule, RegisterOptions, UseDocumentKeyDownOptions, UseEscapeKeyOptions, UseFocusTrapOptions, UseFormReturn, UseLongPressHandlers, UseLongPressOptions, UseOutsideClickOptions, UseOverlayOptions, UseOverlayPanelOptions, ValidationRules };

package/types/entries/locales.d.ts

@@ -0,0 +1,280 @@
+declare const ru: {
+    readonly common: {
+        readonly close: "Закрыть";
+        readonly clear: "Очистить";
+        readonly collapse: "Свернуть";
+    };
+    readonly calendar: {
+        readonly months: readonly ["Январь", "Февраль", "Март", "Апрель", "Май", "Июнь", "Июль", "Август", "Сентябрь", "Октябрь", "Ноябрь", "Декабрь"];
+        readonly monthsShort: readonly ["Янв", "Фев", "Мар", "Апр", "Май", "Июн", "Июл", "Авг", "Сен", "Окт", "Ноя", "Дек"];
+        readonly weekdaysShort: readonly ["Пн", "Вт", "Ср", "Чт", "Пт", "Сб", "Вс"];
+        readonly prevMonth: "Предыдущий месяц";
+        readonly nextMonth: "Следующий месяц";
+        readonly prevYear: "Предыдущий год";
+        readonly nextYear: "Следующий год";
+        readonly prevYears: "Предыдущие годы";
+        readonly nextYears: "Следующие годы";
+        readonly selectYear: "Выбрать год, сейчас {year}";
+        readonly selectMonth: "Выбрать месяц, сейчас {month}";
+        readonly monthsOfYear: "Месяцы {year}";
+        readonly yearsRange: "Годы {start}–{end}";
+    };
+    readonly calendarBoard: {
+        readonly ariaLabel: "Календарная доска";
+        readonly prevPeriod: "Предыдущий период";
+        readonly nextPeriod: "Следующий период";
+        readonly viewSwitchAria: "Представление календаря";
+        readonly views: {
+            readonly month: "Месяц";
+            readonly week: "Неделя";
+            readonly day: "День";
+            readonly year: "Год";
+        };
+        readonly scheduleAria: "Расписание";
+        readonly allDay: "События на весь день";
+        readonly allDayShort: "весь день";
+        readonly dayWithTasks: {
+            readonly one: "{day} {month}, {count} задача";
+            readonly few: "{day} {month}, {count} задачи";
+            readonly many: "{day} {month}, {count} задач";
+        };
+        readonly dayWithoutTasks: "{day} {month}";
+        readonly moreTasks: {
+            readonly one: "ещё {count} задача";
+            readonly few: "ещё {count} задачи";
+            readonly many: "ещё {count} задач";
+        };
+    };
+    readonly dayStrip: {
+        readonly ariaLabel: "Навигация по дням";
+        readonly prev: "Предыдущий день";
+        readonly next: "Следующий день";
+        readonly days: "Дни";
+    };
+    readonly timeField: {
+        readonly hours: "Часы";
+        readonly minutes: "Минуты";
+    };
+    readonly dateRangeField: {
+        readonly label: "Период";
+        readonly start: "С";
+        readonly end: "По";
+    };
+    readonly select: {
+        readonly removeItem: "Удалить {label}";
+    };
+    readonly customSelect: {
+        readonly filterPlaceholder: "Поиск...";
+        readonly noOptions: "Ничего не найдено";
+    };
+    readonly listbox: {
+        readonly noOptions: "Ничего не найдено";
+    };
+    readonly suggestField: {
+        readonly noOptions: "Ничего не найдено";
+    };
+    readonly sheet: {
+        readonly ariaLabel: "Панель";
+    };
+    readonly modal: {
+        readonly ariaLabel: "Диалог";
+    };
+    readonly confirmDialog: {
+        readonly confirm: "Подтвердить";
+        readonly cancel: "Отмена";
+    };
+    readonly table: {
+        readonly expandColumn: "Развернуть";
+        readonly selectAll: "Выбрать все строки";
+        readonly selectRow: "Выбрать строку {id}";
+        readonly resizeColumn: "Изменить ширину: {header}";
+        readonly emptyTitle: "Нет данных";
+        readonly rowActions: "Действия строки";
+    };
+    readonly pagination: {
+        readonly ariaLabel: "Пагинация";
+        readonly prev: "Предыдущая страница";
+        readonly next: "Следующая страница";
+        readonly page: "Страница {page}";
+        readonly summary: "{start}–{end} из {total}";
+        readonly pageSizeLabel: "На странице";
+        readonly pageSizeAria: "Размер страницы";
+    };
+    readonly sortable: {
+        readonly moveUp: "Переместить вверх";
+        readonly moveDown: "Переместить вниз";
+        readonly moved: "Позиция {position} из {total}: элемент перемещён";
+        readonly dragItem: "Перетащить элемент";
+    };
+    readonly upload: {
+        readonly dropHint: "Перетащите файлы сюда или";
+        readonly choose: "выберите";
+        readonly selectedCount: {
+            readonly one: "Выбран {count} файл";
+            readonly few: "Выбрано {count} файла";
+            readonly many: "Выбрано {count} файлов";
+        };
+        readonly release: "Отпустите файл для загрузки";
+    };
+    readonly imageCrop: {
+        readonly title: "Обрезка изображения";
+        readonly confirm: "Применить";
+        readonly cancel: "Отмена";
+        readonly choose: "Выберите изображение";
+        readonly hint: "Перетащите изображение или измените масштаб за углы";
+        readonly loadError: "Не удалось загрузить изображение";
+        readonly cropError: "Не удалось обрезать изображение";
+        readonly exportError: "Не удалось экспортировать изображение";
+        readonly scaleHandle: "Масштаб {corner}";
+    };
+    readonly imageGallery: {
+        readonly empty: "Нет изображений";
+        readonly prev: "Предыдущее изображение";
+        readonly next: "Следующее изображение";
+        readonly imageN: "Изображение {index}";
+    };
+    readonly imageLightbox: {
+        readonly close: "Закрыть галерею";
+        readonly ariaLabel: "Галерея изображений";
+    };
+    readonly sidebar: {
+        readonly ariaLabel: "Навигация сайдбара";
+        readonly openMenu: "Открыть меню";
+        readonly expand: "Развернуть";
+        readonly collapse: "Свернуть";
+        readonly expandSidebar: "Развернуть сайдбар";
+        readonly collapseSidebar: "Свернуть сайдбар";
+    };
+    readonly password: {
+        readonly reveal: "Показать пароль";
+        readonly hide: "Скрыть пароль";
+        readonly strength: {
+            readonly weak: "Слабый";
+            readonly fair: "Средний";
+            readonly good: "Хороший";
+            readonly strong: "Надёжный";
+        };
+    };
+    readonly numberField: {
+        readonly group: "Изменить значение";
+        readonly decrement: "Уменьшить";
+        readonly increment: "Увеличить";
+    };
+    readonly pinInput: {
+        readonly ariaLabel: "Код подтверждения";
+        readonly digit: "Цифра {index}";
+    };
+    readonly searchField: {
+        readonly label: "Поиск";
+    };
+    readonly slider: {
+        readonly ariaLabel: "Ползунок";
+        readonly from: "От";
+        readonly to: "До";
+    };
+    readonly rating: {
+        readonly ariaLabel: "Рейтинг";
+    };
+    readonly actionList: {
+        readonly filterPlaceholder: "Фильтр…";
+        readonly empty: "Ничего не найдено";
+        readonly ariaLabel: "Список действий";
+    };
+    readonly commandPalette: {
+        readonly placeholder: "Поиск команд…";
+        readonly title: "Командная палитра";
+    };
+    readonly pullToRefresh: {
+        readonly pull: "Потяните для обновления";
+        readonly release: "Отпустите";
+        readonly refreshing: "Обновление…";
+    };
+    readonly spinner: {
+        readonly typing: "Печатает";
+        readonly loading: "Загрузка";
+    };
+    readonly steps: {
+        readonly ariaLabel: "Шаги";
+    };
+    readonly segmentedControl: {
+        readonly ariaLabel: "Сегментированный контроль";
+    };
+    readonly bubble: {
+        readonly expand: "Ещё";
+        readonly collapse: "Свернуть";
+        readonly reactions: "Реакции";
+    };
+    readonly chip: {
+        readonly remove: "Удалить";
+        readonly groupChips: "Чипы";
+        readonly groupTags: "Теги";
+    };
+    readonly fileList: {
+        readonly remove: "Удалить";
+        readonly retry: "Повторить";
+    };
+    readonly virtualList: {
+        readonly ariaLabel: "Список";
+    };
+    readonly skipLink: {
+        readonly label: "Перейти к содержимому";
+    };
+    readonly overflow: {
+        readonly title: "Действия";
+        readonly ariaLabel: "Действия";
+        readonly more: "Ещё действия";
+        readonly groupTitle: "Ещё";
+        readonly groupAriaLabel: "Группа";
+        readonly groupMore: "Показать ещё";
+    };
+    readonly buttonGroup: {
+        readonly ariaLabel: "Группа кнопок";
+    };
+    readonly menu: {
+        readonly mobileTitle: "Меню";
+        readonly ariaLabel: "Меню";
+        readonly contextAriaLabel: "Контекстное меню";
+    };
+};
+
+type DeepStringify<T> = T extends string ? string : T extends readonly (infer U)[] ? DeepStringify<U>[] : T extends object ? {
+    [K in keyof T]: DeepStringify<T[K]>;
+} : T;
+type Messages = DeepStringify<typeof ru>;
+type DeepPartialMessages = {
+    [K in keyof Messages]?: Messages[K] extends (infer U)[] ? U[] : Messages[K] extends object ? {
+        [P in keyof Messages[K]]?: DeepPartialMessagesValue<Messages[K][P]>;
+    } : Messages[K];
+};
+type DeepPartialMessagesValue<T> = T extends (infer U)[] ? U[] : T extends object ? {
+    [P in keyof T]?: DeepPartialMessagesValue<T[P]>;
+} : T;
+type LocaleCode = 'ru' | 'en';
+interface PluralMessage {
+    one: string;
+    few: string;
+    many: string;
+}
+interface MessageTree {
+    [key: string]: string | PluralMessage | readonly string[] | MessageTree;
+}
+type TranslationParams = Record<string, string | number>;
+
+declare const en: Messages;
+
+declare const builtInMessages: Record<LocaleCode, Messages>;
+
+declare function deepMergeMessages(base: Messages, override?: DeepPartialMessages): Messages;
+declare function translate(messages: MessageTree, key: string, params?: TranslationParams, locale?: LocaleCode): string;
+type TranslateFn = (key: string, params?: TranslationParams) => string;
+
+interface LocaleContextValue {
+    locale: LocaleCode;
+    messages: Messages;
+    t: TranslateFn;
+}
+declare function useLocale(): LocaleContextValue;
+declare function useT(): TranslateFn;
+
+export { builtInMessages, deepMergeMessages, en, ru, translate, useLocale, useT };
+export type { DeepPartialMessages, LocaleCode, LocaleContextValue, MessageTree, Messages, PluralMessage, TranslateFn, TranslationParams };

package/types/entries/utils.d.ts

@@ -82,6 +82,74 @@ declare function getFormControlState(options: {
     isInteractive: boolean;
 };
 
+type PropertyPath = string | readonly (string | number)[];
+declare function toPath(path: PropertyPath): string[];
+declare function set<T>(source: T, path: PropertyPath, value: unknown): T;
+
+declare const DEFAULT_DRAG_BLOCKED_SELECTOR: string;
+declare const DEFAULT_PORTAL_SELECTOR: string;
+declare function isEditableTarget(target: EventTarget | null): boolean;
+declare function isDragBlockedTarget(target: EventTarget | null, selector: string): boolean;
+declare function isOutsideFormInteraction(target: EventTarget | null, container: HTMLElement | null, portalSelector: string, classNamePart?: string): boolean;
+
+type LocaleCode = 'ru' | 'en';
+
+interface ZonedDateParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+}
+declare function getBrowserTimezone(): string;
+declare function getSupportedTimezones(): string[];
+declare function isValidTimeZone(timeZone: string): boolean;
+declare function getZonedParts(date: Date, timeZone: string): ZonedDateParts | null;
+declare function getTimezoneOffsetMinutes(timeZone: string, date?: Date): number | null;
+declare function isSameZonedDay(a: Date, b: Date, timeZone: string): boolean;
+declare function formatInTimeZone(date: Date, timeZone: string, locale: LocaleCode, options?: Intl.DateTimeFormatOptions): string;
+declare function formatTimezoneOffset(timeZone: string, date?: Date): string;
+declare function formatTimezoneLabel(timeZone: string): string;
+
+type WeekStartsOn = 0 | 1;
+type DateAddUnit = 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+declare function getWeekStart(date: Date, weekStartsOn?: WeekStartsOn): Date;
+declare function getWeekDays(anchor: Date, weekStartsOn?: WeekStartsOn): Date[];
+declare function addToDate(date: Date, amount: number, unit: DateAddUnit): Date;
+declare function startOfDay(date: Date): Date;
+declare function addDays(date: Date, days: number): Date;
+declare function isSameDay(a: Date, b: Date): boolean;
+declare function compareDay(a: Date, b: Date): number;
+declare function parseLocalDate(value: string): Date | null;
+declare function formatLocalDate(date: Date): string;
+declare function formatHourLabel(hour: number, locale: LocaleCode): string;
+declare function formatHourTime(hour: number): string;
+
+declare const MINUTE_SECONDS = 60;
+declare const HOUR_SECONDS: number;
+declare const DAY_SECONDS: number;
+declare const WEEK_SECONDS: number;
+type DurationUnit = 'minute' | 'hour' | 'day' | 'week';
+interface DurationUnitValue {
+    unit: DurationUnit;
+    value: number;
+}
+declare function secondsToUnit(seconds: number, unit: DurationUnit): number;
+declare function unitToSeconds(value: number, unit: DurationUnit): number;
+declare function getDurationUnitAndValue(seconds: number): DurationUnitValue;
+
+declare function localeToBcp47(locale: LocaleCode): string;
+
+interface PluralForms {
+    one: string;
+    few: string;
+    many: string;
+}
+declare function pluralRu(count: number, one: string, few: string, many: string): string;
+declare function pluralEn(count: number, one: string, other: string): string;
+declare function plural(locale: LocaleCode, count: number, forms: PluralForms): string;
+
 type KeyboardShortcutParts = {
     key: string;
     mod: boolean;
@@ -118,12 +186,6 @@ declare function liveStatus(hidden: AriaHidden, label?: string): {
     'aria-label'?: string;
 };
 
-type ControlTrackVariant = 'primary' | 'tinted' | 'secondary' | 'ghost' | 'plain' | 'link';
-
-declare function controlTrackClassName(variant: ControlTrackVariant, options?: {
-    readOnly?: boolean;
-}): string;
-
 declare function mergeStyles(internal?: CSSProperties | null, external?: CSSProperties | null): CSSProperties | undefined;
 
 type AnyProps = Record<string, unknown>;
@@ -171,5 +233,5 @@ type Density = 'default' | 'compact';
 
 type SurfaceVariant = 'primary' | 'tinted' | 'secondary' | 'ghost' | 'plain';
 
-export { OVERLAY_Z_INDEX_DEFAULT, OverlayStackProvider, SPACING_TOKEN_CSS, Slot, adjustElementHeight, clamp, clampToViewport, cn, composeEventHandlers, composeRefs, computeAnchorPosition, controlTrackClassName, defaultListboxFilterFn, elevateAboveOverlayStack, filterListboxOptions, findEnabledListboxIndex, findListboxOption, flattenResolvedListboxGroups, formatAriaKeyShortcuts, formatBytes, formatKeyboardShortcut, getAnchorSideSpace, getFormControlState, getListboxDisplayValue, getListboxOptionDomId, getListboxOptionText, getListboxPath, getTextareaMinHeightPx, getTranslateXFromTransform, liveStatus, matchListboxOption, matchesKeyboardShortcut, mergeSlotProps, mergeStyles, moveArrayItem, moveListboxHighlight, parseKeyboardShortcut, renderChildren, resolveListboxGroups, resolveOverlayZIndex, resolvePreferredSide, resolveSpacingCss, resolveStackedOverlayZIndex, toCssSize, toggleSet, useOverlayStackZIndex };
-export type { AnchorAlign, AnchorPositionResult, AnchorPositionStyle, AnchorSide, ControlTrackVariant, Density, EnrichedThroughChild, EnrichedThroughFn, GroupGap, KeyboardShortcutParts, ListboxFilterFn, ListboxGroup, ListboxOption, OverlayZIndexTier, PossibleRef, RenderChildrenFn, RenderChildrenOptions, ResolvedListboxGroup, SlotProps, SpacingToken, SpacingValue, SurfaceVariant, WithEnrichedChildren };
+export { DAY_SECONDS, DEFAULT_DRAG_BLOCKED_SELECTOR, DEFAULT_PORTAL_SELECTOR, HOUR_SECONDS, MINUTE_SECONDS, OVERLAY_Z_INDEX_DEFAULT, OverlayStackProvider, SPACING_TOKEN_CSS, Slot, WEEK_SECONDS, addDays, addToDate, adjustElementHeight, clamp, clampToViewport, cn, compareDay, composeEventHandlers, composeRefs, computeAnchorPosition, defaultListboxFilterFn, elevateAboveOverlayStack, filterListboxOptions, findEnabledListboxIndex, findListboxOption, flattenResolvedListboxGroups, formatAriaKeyShortcuts, formatBytes, formatHourLabel, formatHourTime, formatInTimeZone, formatKeyboardShortcut, formatLocalDate, formatTimezoneLabel, formatTimezoneOffset, getAnchorSideSpace, getBrowserTimezone, getDurationUnitAndValue, getFormControlState, getListboxDisplayValue, getListboxOptionDomId, getListboxOptionText, getListboxPath, getSupportedTimezones, getTextareaMinHeightPx, getTimezoneOffsetMinutes, getTranslateXFromTransform, getWeekDays, getWeekStart, getZonedParts, isDragBlockedTarget, isEditableTarget, isOutsideFormInteraction, isSameDay, isSameZonedDay, isValidTimeZone, liveStatus, localeToBcp47, matchListboxOption, matchesKeyboardShortcut, mergeSlotProps, mergeStyles, moveArrayItem, moveListboxHighlight, parseKeyboardShortcut, parseLocalDate, plural, pluralEn, pluralRu, renderChildren, resolveListboxGroups, resolveOverlayZIndex, resolvePreferredSide, resolveSpacingCss, resolveStackedOverlayZIndex, secondsToUnit, set, startOfDay, toCssSize, toPath, toggleSet, unitToSeconds, useOverlayStackZIndex };
+export type { AnchorAlign, AnchorPositionResult, AnchorPositionStyle, AnchorSide, DateAddUnit, Density, DurationUnit, DurationUnitValue, EnrichedThroughChild, EnrichedThroughFn, GroupGap, KeyboardShortcutParts, ListboxFilterFn, ListboxGroup, ListboxOption, OverlayZIndexTier, PluralForms, PossibleRef, PropertyPath, RenderChildrenFn, RenderChildrenOptions, ResolvedListboxGroup, SlotProps, SpacingToken, SpacingValue, SurfaceVariant, WeekStartsOn, WithEnrichedChildren, ZonedDateParts };