fix(a11y): ChipsSelect and ChipsInput (#6367)

h2. Описание

> [!NOTE]
> см. #4143 (comment)
>
> Добавил логику работы `ChipsInput`/`ChipsSelect` в описание задачи #4143 (comment).

Проверил `ChipsSelect` и `ChipsInput` в **NVDA** и нашёл причину почему он не видит компоненты – причиной был скрытый текст для визуальной доступности, который располагался прямо перед полем ввода. Оно осталось со старой реализации, думал так и надо. Я удалил этот скрытый текст, т.к. его содержание должно быть в атрибуте `placeholder`, который есть у текстовых полей. Удалили параметр `inputLabel`.

По ходу дела изменил некоторое поведение (ориентировался на пример из https://material.angular.io/components/chips/overview#chips-autocomplete):

- Смена фокуса при удалении чипа.
  - Если чип один, то удаление этого чип перенесет фокус на текстовое поле.
  - Если чипов несколько, то после удаление одного из них фокус перенесется на ближайший чип. Если удалили с конца, то на последний чип, если удалили в начале, то на следующий чип.
- Нажатии на **Backpace** будучи в пустом текстовом поле – перенесёт фокус на последний чип.
- Иконка с шевроном верх/вниз теперь чисто декоративная. Удалил параметр `getIconLabel`.

h2. Изменения

- В `src/testing/utils` добавил функцию `withRexExp` – если передать в параметр `name` в селектора типа `getByRole('option', { name: '<string>' });`, то DOM-элемент не находится. Исправляет оборачивание в регулярку `getByRole('option', { name: new RegExp('<string>') });`

packages/vkui/src/components/ChipsInput/ChipsInput.stories.tsx

@@ -1,6 +1,8 @@
+import * as React from 'react';
 import { Meta, StoryObj } from '@storybook/react';
 import { CanvasFullLayout, DisableCartesianParam } from '../../storybook/constants';
 import type { ChipOption } from '../ChipsInputBase/types';
+import { FormItem } from '../FormItem/FormItem';
 import { ChipsInput, ChipsInputProps } from './ChipsInput';
 
 const story: Meta<ChipsInputProps<ChipOption>> = {
@@ -13,4 +15,10 @@ export default story;
 
 type Story = StoryObj<ChipsInputProps<ChipOption>>;
 
-export const Playground: Story = {};
+export const Playground: Story = {
+  render: (args) => (
+    <FormItem top="Добавьте любимые теги" htmlFor="chips-input" style={{ width: 320 }}>
+      <ChipsInput {...args} id="chips-input" />
+    </FormItem>
+  ),
+};

packages/vkui/src/components/ChipsInput/useChipsInput.ts

@@ -8,6 +8,7 @@ import {
   getOptionLabelDefault,
   getOptionValueDefault,
 } from '../ChipsInputBase/constants';
+import { isValueLikeChipOptionObject } from '../ChipsInputBase/helpers';
 import type {
   ChipOption,
   ChipOptionValue,
@@ -17,9 +18,6 @@ import type {
   UseChipsInputBaseProps,
 } from '../ChipsInputBase/types';
 
-const isValueLikeOption = <O extends ChipOption>(value: O | ChipOptionValue): value is O =>
-  typeof value === 'object' && 'value' in value;
-
 export const transformValue = <O extends ChipOption>(
   value: O[],
   getOptionValue: GetOptionValue<O>,
@@ -87,14 +85,16 @@ export const useChipsInput = <O extends ChipOption>({
   const toggleOption: ToggleOption<O> = React.useCallback(
     (nextValueProp: O | ChipOptionValue, isNewValue: boolean) => {
       setValue((prevValue) => {
-        const isLikeOption = isValueLikeOption(nextValueProp);
-        const resolvedOption = isLikeOption
+        const isLikeObjectOption = isValueLikeChipOptionObject(nextValueProp);
+        const resolvedOption = isLikeObjectOption
           ? getNewOptionData(nextValueProp.value, nextValueProp.label)
           : getNewOptionData(nextValueProp, typeof nextValueProp === 'string' ? nextValueProp : '');
         const nextValue = prevValue.filter((option: O) => resolvedOption.value !== option.value);
 
         if (isNewValue === true) {
-          nextValue.push(isLikeOption ? { ...nextValueProp, ...resolvedOption } : resolvedOption);
+          nextValue.push(
+            isLikeObjectOption ? { ...nextValueProp, ...resolvedOption } : resolvedOption,
+          );
         }
 
         return nextValue;

packages/vkui/src/components/ChipsInputBase/Chip/Chip.tsx

@@ -68,7 +68,6 @@ export const Chip = ({
         focusVisibleClassName,
         className,
       )}
-      tabIndex={-1} // [reason]: чтобы можно было выставлять состояние фокуса только программно через `*.focus()`
       aria-disabled={disabled}
       onFocus={disabled ? undefined : handleFocus}
       onBlur={disabled ? undefined : handleBlur}

packages/vkui/src/components/ChipsInputBase/ChipsInputBase.module.css

@@ -19,19 +19,12 @@
   margin: 2px;
 }
 
-.ChipsInputBase__label {
-  display: flex;
-  justify-content: center;
-  flex-direction: column;
-  flex: 1;
-  margin-block: 2px 2px;
-  margin-inline: 10px 2px;
-}
-
 .ChipsInputBase__el {
+  flex: 1;
   position: relative;
   inline-size: 100%;
-  margin-block-end: 2px;
+  margin-block: 2px 4px;
+  margin-inline: 10px 2px;
   padding: 0;
   color: var(--vkui--color_text_primary);
   background: transparent;
@@ -66,13 +59,10 @@
   cursor: default;
 }
 
-.ChipsInputBase--hasPlaceholder .ChipsInputBase__label {
-  margin-inline: calc(12px - var(--vkui_internal--chips_input_base_container_gap)) 0;
-}
-
 .ChipsInputBase--hasPlaceholder .ChipsInputBase__el {
   white-space: nowrap;
   text-overflow: ellipsis;
+  margin-inline: calc(12px - var(--vkui_internal--chips_input_base_container_gap)) 0;
 }
 
 /**

packages/vkui/src/components/ChipsInputBase/ChipsInputBase.test.tsx

@@ -1,18 +1,32 @@
 import * as React from 'react';
 import { render } from '@testing-library/react';
-import { baselineComponent, userEvent } from '../../testing/utils';
+import { baselineComponent, userEvent, withRegExp } from '../../testing/utils';
 import { ChipsInputBase } from './ChipsInputBase';
 import type { ChipOption, ChipsInputBasePrivateProps } from './types';
 
-const ChipsInputBaseTest = (props: ChipsInputBasePrivateProps) => (
-  <ChipsInputBase data-testid="chips-input" {...props} />
-);
+const ChipsInputBaseTest = ({
+  inputValue: inputValueProp,
+  ...restProps
+}: ChipsInputBasePrivateProps) => {
+  const [inputValue, setInputValue] = React.useState(inputValueProp);
+  const handleInputChange = (event: React.ChangeEvent<HTMLInputElement>) => {
+    setInputValue(event.target.value);
+  };
+  return (
+    <ChipsInputBase
+      data-testid="chips-input"
+      {...restProps}
+      inputValue={inputValue}
+      onInputChange={handleInputChange}
+    />
+  );
+};
 
-const testOption = { value: 'red', label: 'Красный' };
-const chipsInputValue: ChipOption[] = [testOption];
+const TEST_OPTION = { value: 'red', label: 'Красный' };
+const chipsInputValue: ChipOption[] = [TEST_OPTION];
 
 describe('ChipsInputBase', () => {
-  baselineComponent(ChipsInputBase, {
+  baselineComponent(ChipsInputBaseTest, {
     // доступность должна быть реализована в обёртках над ChipsInputBase
     a11y: false,
   });
@@ -55,30 +69,39 @@ describe('ChipsInputBase', () => {
     expect(onAddChipOption).toHaveBeenCalledWith('Красный');
   });
 
-  it('removes chip on hitting backspace', async () => {
+  it('focuses to chip on hitting backspace', async () => {
     const result = render(
       <ChipsInputBaseTest
         value={chipsInputValue}
+        inputValue="0"
         onAddChipOption={onAddChipOption}
         onRemoveChipOption={onRemoveChipOption}
       />,
     );
-    await userEvent.type(result.getByTestId('chips-input'), '{backspace}');
-    expect(onRemoveChipOption).toHaveBeenCalledWith(testOption);
+    const chipsInputLocator = result.getByTestId('chips-input');
+    await userEvent.type(chipsInputLocator, '{backspace}');
+    expect(chipsInputLocator).toHaveFocus();
+    await userEvent.type(chipsInputLocator, '{backspace}');
+    expect(chipsInputLocator.previousSibling).toHaveFocus();
   });
 
-  it('does not delete chips on hitting backspace in readonly mode', async () => {
-    const result = render(
-      <ChipsInputBaseTest
-        readOnly
-        value={chipsInputValue}
-        onAddChipOption={onAddChipOption}
-        onRemoveChipOption={onRemoveChipOption}
-      />,
-    );
-    await userEvent.type(result.getByTestId('chips-input'), '{backspace}');
-    expect(onRemoveChipOption).not.toHaveBeenCalled();
-  });
+  it.each(['delete', 'backspace'])(
+    'does not delete chips on hitting "%s" key in readonly mode',
+    async (type) => {
+      const result = render(
+        <ChipsInputBaseTest
+          readOnly
+          value={chipsInputValue}
+          onAddChipOption={onAddChipOption}
+          onRemoveChipOption={onRemoveChipOption}
+        />,
+      );
+      const chipEl = result.getByRole('option', { name: withRegExp(TEST_OPTION.label) });
+      await userEvent.click(chipEl);
+      await userEvent.type(chipEl, `{${type}}`);
+      expect(onRemoveChipOption).not.toHaveBeenCalled();
+    },
+  );
 
   it('focuses ChipsInputBase on surrounding container click', async () => {
     const result = render(
@@ -92,18 +115,31 @@ describe('ChipsInputBase', () => {
     expect(result.getByTestId('chips-input')).toHaveFocus();
   });
 
-  it('focuses ChipsInputBase on chip click', async () => {
+  it('focuses on chip after click', async () => {
     const result = render(
       <ChipsInputBaseTest
         value={chipsInputValue}
         onAddChipOption={onAddChipOption}
         onRemoveChipOption={onRemoveChipOption}
       />,
     );
-    await userEvent.click(result.queryByText('Красный')!);
-    expect(result.getByTestId('chips-input')).toHaveFocus();
+    const chipEl = result.getByRole('option', { name: withRegExp(TEST_OPTION.label) });
+    await userEvent.click(chipEl);
+    expect(chipEl).toHaveFocus();
   });
 
+  it.todo('focuses on input field after removing only one chip');
+
+  it.todo('focuses on nearest chip after removing one of chip');
+
+  it.todo('focuses on last focused chip after focus to component');
+
+  it.todo('focuses on last focused chip after enter to component with hitting "tab" key');
+
+  it.todo('focuses on last focused chip after hitting "shift + tab" key');
+
+  it.todo('navigates between chip with arrow buttons');
+
   it('add value on blur event if addOnBlur=true', async () => {
     const result = render(
       <ChipsInputBaseTest