@sberbusiness/triplex-next-mcp-server 1.46.0-beta → 1.48.0-beta

package/bundle/components/FormField.md

@@ -62,7 +62,7 @@ version: "1.0"
 - Горизонтальные внутренние отступы корневого `div` задаются инлайн-стилем из ширин префикса и постфикса (`paddingLeft: prefixWidth`, `paddingRight: postfixWidth`). Значение по умолчанию — `TARGET_PADDING_X_DEFAULT` (12px); `FormFieldPrefix` / `FormFieldPostfix` измеряют себя через `ResizeObserver` и обновляют его. Пользовательский `style` мерджится последним и может переопределить отступы.
 - Класс `filled` выставляется, когда вложенный элемент ввода сообщил о наличии значения. Для `FormFieldInput` / `FormFieldTextarea` это включает браузерное автозаполнение (ловится через CSS-анимационные хуки `autofill-applied-hook` / `autofill-cancelled-hook`), для `FormFieldTarget` — наличие `children`.
 - Кнопка `FormFieldClear` показывается стилями только при `filled` и hover/активном состоянии непустого и не заблокированного поля, а также при собственном фокусе (`:focus`) — чтобы кнопка оставалась видимой при клавиатурной навигации.
-- Идентификаторы генерируются субкомпонентами (`uniqueId` из `lodash-es`, не `React.useId` — код должен оставаться совместимым с React 17) и попадают в контекст как `targetId` / `labelId`; на них опирается связка `label[htmlFor]` ↔ элемент ввода.
+- Идентификаторы генерируются субкомпонентами (`uniqueId` из `lodash-es`, не `React.useId` — код должен оставаться совместимым с React 17) и попадают в контекст как `targetId` / `labelId`; на них опирается связка лейбла и поля. `targetId` публикуют только labelable-элементы (`FormFieldInput`, `FormFieldTextarea`, а также `FormFieldMaskedInput` — он рендерит `FormFieldInput` внутри себя через `render`); `FormFieldTarget` его не публикует — см. Accessibility.
 - Вне `FormField` субкомпоненты используют `initialFormFieldContext`, где `filled: true` — это осознанный временный фикс для `DropdownMobileHeader`, а сеттеры являются no-op.
 
 ---
@@ -104,9 +104,10 @@ FormField.Target_PlaceholderColor_Default
 - Barrel `src/components/FormField/index.ts` реэкспортирует `enums`, `types`, `components` и сам `FormField` — состав экспортов не сокращать. Маппинг статуса на класс (`STATUS_TO_CLASS_NAME_MAP`) — внутренняя константа модуля и в barrel не входит.
 - `FormFieldContext` и `FormFieldDescriptionContext` в barrel не входят: это внутренний механизм семейства, но на нём завязаны все субкомпоненты — менять форму значения контекста без правки субкомпонентов нельзя.
 - Классы `formField`, `filled`, `active`, `error`, `warning`, `disabled`, а также `sm` / `md` / `lg` проверяются unit-тестами и используются в вложенных селекторах стилей семейства.
+- `disabled` исключён из props элементов ввода (`IFormFieldInputProps`, `IFormFieldTextareaProps`, `IFormFieldMaskedInputProps` — через `Omit`): блокировка задаётся только `status={EFormFieldStatus.DISABLED}`, иначе переданное значение молча перетиралось бы внутренним.
 - Генерация id — через `uniqueId` (`lodash-es`), без `React.useId`: ветка `release-0` собирается на React 17.
 - `FormFieldDescription` и `FormFieldCounter` объявлены как `React.FC` без `forwardRef` — осознанное историческое отличие от остальных субкомпонентов. Добавление ref расширяет публичный API; решение владельца — оставить как есть.
-- Внутренние утилиты семейства (`components/utils.ts` — `isFilled`, `setForwardedRef`; `components/useFormFieldAffixWidth.ts`) намеренно не попадают в barrel `components/index.ts`.
+- Внутренние утилиты семейства (`components/utils.ts` — `isFilled`; `components/useFormFieldAffixWidth.ts`) намеренно не попадают в barrel `components/index.ts`. Общий `setForwardedRef` вынесен в `src/helpers/setForwardedRef.ts` и импортируется относительным путём.
 - Компонент не рендерит собственных подписей и текстов — библиотека мультиязычная.
 
 ---
@@ -114,9 +115,11 @@ FormField.Target_PlaceholderColor_Default
 ## Accessibility
 
 - Корневой элемент — обычный `div` без роли: семантику даёт вложенный нативный `input` / `textarea`.
-- Связка лейбла и поля: `FormFieldLabel` получает `htmlFor={targetId}` из контекста, элемент ввода — сгенерированный `id`. Поэтому `screen.getByLabelText(...)` находит поле, а клик по лейблу фокусирует ввод.
+- Связка лейбла и поля: когда в поле есть labelable-элемент, `FormFieldLabel` рендерит `<label htmlFor={targetId}>`, а элемент ввода — сгенерированный `id`. Поэтому `screen.getByLabelText(...)` находит поле.
 - `FormFieldTarget` (нередактируемое значение, например для select-подобных полей) получает `tabIndex={0}`, `aria-labelledby={labelId}` и `aria-disabled`; при `status = DISABLED` — `tabIndex={-1}`.
-- При `status = DISABLED` вложенные `input` / `textarea` получают нативный `disabled`, то есть выпадают из таб-порядка.
+- `FormFieldTarget` намеренно **не** публикует свой `id` как `targetId`: это `<div>`, а не labelable-элемент, и `label[htmlFor]` на него ссылаться не может. В таких полях `FormFieldLabel` рендерит `<span>`, а не `<label>` — несвязанный `<label>` браузер тоже считает ошибкой разметки. Имя полю даёт `aria-labelledby` на `FormFieldTarget`, поэтому `screen.getByLabelText(...)` продолжает находить поле.
+- Следствие выбора тега по контексту: `targetId` публикуется в `useLayoutEffect`, поэтому в полях с labelable-элементом лейбл на первом рендере — `<span>`, а после layout-эффекта DOM-узел заменяется на `<label>`. Замена происходит до отрисовки и визуально незаметна, но ref на `FormFieldLabel` вызывается для обоих узлов.
+- При `status = DISABLED` вложенные `input` / `textarea` получают нативный `disabled`, то есть выпадают из таб-порядка. Передать `disabled` мимо статуса нельзя — атрибут исключён из props элементов ввода.
 - Плейсхолдер маски в `FormFieldMaskedInput` рендерится с `aria-hidden="true"` — скринридер читает только реальное значение input.
 - Текст описания (`FormFieldDescription`) визуально связан с полем, но не связывается автоматически через `aria-describedby` — при необходимости потребитель передаёт `aria-describedby` элементу ввода сам.
 
@@ -168,6 +171,10 @@ FormField.Target_PlaceholderColor_Default
 | 2026-08-03 | Ломающее изменение: `statusToClassNameMap` убран из публичного barrel и переименован во внутреннюю константу `STATUS_TO_CLASS_NAME_MAP`. Зафиксировано в release notes 1.41.0. |
 | 2026-09-04 | Исправлено: у `FormFieldTextarea` фиксированная `height` для размеров `sm` / `md` / `lg` заменена на `min-height`. |
 | 2026-09-09 | Исправлено: значение с кодом страны раскладывалось по маске телефона со сдвигом и теряло последнюю цифру. Нормализация номера вынесена в `normalizePhoneText` и применяется и к внешнему `value`, и к слою с маской |
+| 2026-09-16 | Исправлено: `FormFieldTarget` больше не публикует свой `id` как `targetId`, а `FormFieldLabel` рендерит `<span>` вместо `<label>`, когда в поле нет labelable-элемента. Ref `FormFieldLabel` типизирован как `HTMLElement`, props — как `React.HTMLAttributes<HTMLElement>`. Доступное имя по-прежнему даёт `aria-labelledby`. |
+| 2026-09-16 | Исправлено: `FormFieldInput` и `FormFieldTextarea` очищают `targetId` при размонтировании — иначе после замены элемента ввода на `FormFieldTarget` лейбл сохранял `htmlFor` с `id` удалённого элемента. |
+| 2026-09-17 | Ломающее изменение: `disabled` убран из `IFormFieldTextareaProps` через `Omit` — так же, как он уже был убран у `FormFieldInput` и `FormFieldMaskedInput`. Поведение не менялось (статус перетирал переданное значение и раньше), но передача `disabled` в props теперь ошибка компиляции. Правка по ревью PR #629, зафиксирована в release notes 1.47.0 |
+| 2026-09-23 | Исправлено: при смене `status` на `EFormFieldStatus.DISABLED`, пока вложенный элемент ввода в фокусе, `FormField` теперь явно сбрасывает состояние `focused` в `useLayoutEffect`. |
 
 ---
 

package/bundle/components/FormGroup.md

@@ -76,8 +76,9 @@ version: "1.0"
 Семантику задаёт потребитель через проброшенные атрибуты — например `role="group"` вместе с
 `aria-labelledby`, если группа должна объявляться скринридером как единое целое.
 
-Лейбл связывается с полем внутри `FormField`: `FormFieldLabel` берёт `htmlFor` из `targetId`
-в `FormFieldContext`. Описание автоматически не связывается — `aria-describedby` на элементе
+Лейбл связывается с полем внутри `FormField`: в полях с элементом ввода `FormFieldLabel` берёт
+`htmlFor` из `targetId` в `FormFieldContext`, в select-подобных — связь даёт `aria-labelledby`
+на `FormFieldTarget` (см. `FormField-ai.md`). Описание автоматически не связывается — `aria-describedby` на элементе
 ввода (как и `aria-invalid` для ошибки) задаёт потребитель, см. `FormField-ai.md`. `FormGroup`
 не участвует ни в том, ни в другом.
 

package/bundle/components/LightBox.md

@@ -101,6 +101,13 @@ LightBox.SideOverlay_Background
 css-переменную `--lightBox-scroll-width`, которую вычитают из ширины оверлеев. Ширины размеров
 (`664/864/1064/1264`) заданы LESS-константами `@lightBox-content-max-width-*`.
 
+Боковые отступы контента лайтбокса (`@lightBoxContentPaddingX`, 80px — место под кнопки
+вперёд/назад, на экранах до 1024px включительно 0) публикуются css-переменной
+`--lightBox-content-padding-x` на `.lightBoxContent`. По ней потомки выравниваются с колонкой
+страницы — так это делает обёртка `TopOverlay`. Переменная объявлена именно на `.lightBoxContent`,
+поэтому вне его поддерева (например в `LightBox.SideOverlay` — он сиблинг `LightBox.Content`,
+а не его потомок) она не видна, и читающие её стили получают фолбэк 0.
+
 ---
 
 ## Инварианты
@@ -202,6 +209,7 @@ css-переменную `--lightBox-scroll-width`, которую вычита
 
 | Дата | Изменение |
 |---|---|
+| 2026-09-21 | Боковые отступы `.lightBoxContent` вынесены в css-переменную `--lightBox-content-padding-x` (константа `@lightBoxContentPaddingX`). Нужна, чтобы `TopOverlay` выравнивался по колонке контента |
 | 2026-07-22 | Создан документ (Phase 1 AI-Ready). В том же изменении — AI-рефакторинг: JSDoc на props, общий `LightBoxArrow` для Prev/Next, хук `useLightBoxSidebarVisibility` для сайдбаров, устранение eslint-подавлений; публичный API не менялся |
 | 2026-07-22 | Добавлен `export` к props-интерфейсам `ILightBoxControlsProps`, `ILightBoxCloseProps`, `ILightBoxPrevProps`, `ILightBoxNextProps`, `ILightBoxSideOverlayLoaderProps` (аддитивно, для консистентности с остальными интерфейсами компонента) |
 | 2026-07-22 | Багфиксы по ревью PR #474: клавиатурные триггеры контролов целятся в видимую кнопку (стрелки не работали на desktop, Esc — на mobile); таймер-хак блокировки скролла заменён счётчиком смонтированных лайтбоксов; `LightBoxViewManager` снимает классы mount-ноды при размонтировании последнего менеджера |

package/bundle/components/ListMaster.md

@@ -628,13 +628,13 @@ export const Default = () => {
                                     controlButtons={
                                         <>
                                             <ListItemControlsButton
-                                                icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}
+                                                icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}
                                             >
                                                 Скачать
                                             </ListItemControlsButton>
 
                                             <ListItemControlsButtonDropdown
-                                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                                 options={itemActions}
                                             >
                                                 Действия

package/bundle/components/ListTableItem.md

@@ -156,11 +156,11 @@ export const Default = () => {
                     onClickItem={() => {}}
                     controlButtons={
                         <>
-                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}>
+                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}>
                                 Скачать
                             </ListItemControlsButton>
                             <ListItemControlsButtonDropdown
-                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                 options={options}
                             >
                                 Действия
@@ -245,11 +245,11 @@ export const Selectable = () => {
                     onClickItem={() => console.log("Клик по карточке.")}
                     controlButtons={
                         <>
-                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}>
+                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}>
                                 Скачать
                             </ListItemControlsButton>
                             <ListItemControlsButtonDropdown
-                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                 options={options}
                             >
                                 Действия
@@ -354,11 +354,11 @@ export const WithSwipeEmulation = () => {
                     onClickItem={() => console.log("Клик по карточке.")}
                     controlButtons={
                         <>
-                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}>
+                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}>
                                 Скачать
                             </ListItemControlsButton>
                             <ListItemControlsButtonDropdown
-                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                 options={options}
                             >
                                 Действия

package/bundle/components/MonthYearField.md

@@ -61,7 +61,6 @@ version: "1.0"
 - `forwardRef` на компоненте — не убирать. Ref пробрасывается в `DatePickerExtended` (корневой DOM-элемент — элемент `DatePickerExtended`).
 - Публичный API (`IMonthYearFieldProps`: `value`, `onChange`, `onClear`, `targetProps`, `placeholder` + унаследованные `size`/`status`/`label` и props `DatePickerExtended`) — изменение имён/типов/значений — breaking change.
 - Поле read-only по контракту — не делать его редактируемым без обсуждения (компонент не имеет логики валидации клавиатурного ввода).
-- Отображаемый формат `"MMM YYYY"` зафиксирован в `inputMonthYearFormat`; менять его — визуальный breaking change для потребителей.
 - Sync-эффект в `MonthYearField.tsx` (`useEffect` по `[value, format, limitRange]` с `eslint-disable react-hooks/exhaustive-deps`) — намеренная синхронизация derived-стейта `pickerValues` с внешним `value`. Не переписывать без анализа поведения: сравнение идёт по `inputString`, чтобы не сбрасывать стейт при эквивалентных значениях.
 - Внутренние символы `MonthYearPickerUtils` (`utils.ts`), `MonthYearFieldContext`, `MonthYearFieldTarget` не экспортируются через barrel — это приватные детали реализации.
 
@@ -130,7 +129,7 @@ export const DefaultExample = () => {
 
     return (
         <div style={{ maxWidth: 300 }}>
-            <MonthYearField value={value} placeholder="мм.гггг" label="Label" onChange={setValue} />
+            <MonthYearField value={value} placeholder="Select to proceed" label="Label" onChange={setValue} />
         </div>
     );
 };
@@ -154,7 +153,13 @@ const SizeItem = ({ size }: ISizeItemProps) => {
     return (
         <div style={{ maxWidth: 300 }}>
             <div style={{ marginBottom: 8, fontSize: 16, fontWeight: 700 }}>{size.toUpperCase()}</div>
-            <MonthYearField size={size} value={value} label="Label" placeholder="мм.гггг" onChange={setValue} />
+            <MonthYearField
+                size={size}
+                value={value}
+                label="Label"
+                placeholder="Select to proceed"
+                onChange={setValue}
+            />
         </div>
     );
 };
@@ -188,7 +193,13 @@ const StatusItem = ({ status }: IStatusItemProps) => {
     return (
         <div style={{ maxWidth: 300 }}>
             <div style={{ marginBottom: 8, fontSize: 16, fontWeight: 700 }}>{status.toUpperCase()}</div>
-            <MonthYearField status={status} value={value} label="Label" placeholder="мм.гггг" onChange={setValue} />
+            <MonthYearField
+                status={status}
+                value={value}
+                label="Label"
+                placeholder="Select to proceed"
+                onChange={setValue}
+            />
         </div>
     );
 };