From af4fa8b1c76fbec097f98e453dd2cc38ce7f74f2 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 13:42:52 +0300
Subject: [PATCH 01/19] =?UTF-8?q?docs(input):=20=D0=B2=D0=BE=D1=81=D1=81?=
 =?UTF-8?q?=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BB=D0=B5=D0=BD=D1=8B=20=D1=81?=
 =?UTF-8?q?=D1=82=D0=BE=D1=80=D0=B8=20=D0=B3=D1=80=D1=83=D0=BF=D0=BF=D1=8B?=
 =?UTF-8?q?=20Input?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Input/stories/InputGroup.stories.tsx      |  56 ++++++++
 .../Input/stories/InputMask.stories.tsx       | 123 ++++++++++++++++++
 .../Input/stories/InputText.stories.tsx       |  57 ++++++++
 3 files changed, 236 insertions(+)
 create mode 100644 src/components/Input/stories/InputGroup.stories.tsx
 create mode 100644 src/components/Input/stories/InputMask.stories.tsx
 create mode 100644 src/components/Input/stories/InputText.stories.tsx

diff --git a/src/components/Input/stories/InputGroup.stories.tsx b/src/components/Input/stories/InputGroup.stories.tsx
new file mode 100644
index 00000000..75403c3b
--- /dev/null
+++ b/src/components/Input/stories/InputGroup.stories.tsx
@@ -0,0 +1,56 @@
+import { useArgs } from '@storybook/preview-api'
+import type { Meta, StoryObj } from '@storybook/react'
+import { IconLock, IconUser } from '@tabler/icons-react-native'
+import { useCallback } from 'react'
+
+import { LegacyInputGroup as InputGroup } from '../deprecated/LegacyInputGroup'
+
+const meta: Meta<typeof InputGroup> = {
+  title: 'Legacy/InputGroup',
+  args: {
+    clearable: true,
+    disabled: false,
+    state: 'default',
+    floatLabel: false,
+    placeholder: 'Placeholder',
+    value: '',
+    size: 'base',
+  },
+  argTypes: {
+    state: { control: 'radio', options: ['default', 'danger'] },
+    size: { control: 'radio', options: ['base', 'medium', 'large', 'xlarge'] },
+  },
+  render: (args) => {
+    const [, updateArgs] = useArgs()
+
+    const onChangeText = useCallback(
+      (nextValue: string) => updateArgs({ value: nextValue }),
+      [updateArgs]
+    )
+
+    return <InputGroup {...args} onChangeText={onChangeText} />
+  },
+}
+
+export default meta
+
+type Story = StoryObj<typeof InputGroup>
+
+const InputGroupStory: Story = {
+  args: { left: 'left text', right: 'right text' },
+  argTypes: {
+    left: {
+      options: ['text', 'IconUser', 'IconLock'],
+      control: { type: 'radio' },
+      mapping: { text: 'left text', IconUser, IconLock },
+      defaultValue: 'text',
+    },
+    right: {
+      options: ['text', 'IconUser', 'IconLock'],
+      control: { type: 'radio' },
+      mapping: { text: 'right text', IconUser, IconLock },
+    },
+  },
+}
+
+export { InputGroupStory as InputGroup }
diff --git a/src/components/Input/stories/InputMask.stories.tsx b/src/components/Input/stories/InputMask.stories.tsx
new file mode 100644
index 00000000..4a6e0da7
--- /dev/null
+++ b/src/components/Input/stories/InputMask.stories.tsx
@@ -0,0 +1,123 @@
+import type { Meta, StoryObj } from '@storybook/react'
+import {
+  type ComponentProps,
+  type ComponentType,
+  type RefObject,
+  useCallback,
+  useState,
+} from 'react'
+import { View } from 'react-native'
+import {
+  MaskedTextInput,
+  type MaskedTextInputProps,
+  type MaskedTextInputRef,
+} from 'react-native-advanced-input-mask'
+
+import { Body } from '../../Typography'
+import { LegacyInputText as InputText } from '../deprecated/LegacyInputText'
+
+type InputTextProps = ComponentProps<typeof InputText>
+
+type MaskedInputProps<T extends InputTextProps> = Omit<T, 'onChangeText'> &
+  Pick<MaskedTextInputProps, 'onChangeText' | 'mask'> & {
+    readonly Control: ComponentType<T>
+  }
+
+/**
+ * Пример реализации компонента для ввода текста с маской.
+ * Основана на пакете react-native-advanced-input-mask
+ */
+const MaskedInput = <T extends InputTextProps>({
+  mask,
+  onChangeText: onChangeTextProp,
+  Control,
+  ...other
+}: MaskedInputProps<T>) => {
+  const [value, setValue] = useState('')
+
+  // Коллбэк, адаптированный для использования как с MaskedTextInput, так и с дефолтным TextInput
+  const onChangeText = useCallback(
+    (
+      formatted: string,
+      extracted: string,
+      tailPlacehilder: string,
+      complete: boolean
+    ) => {
+      setValue(formatted)
+      onChangeTextProp?.(
+        formatted,
+        extracted ?? formatted,
+        tailPlacehilder,
+        complete
+      )
+    },
+    [onChangeTextProp]
+  )
+
+  return (
+    <InputText
+      {...(other as unknown as T)}
+      renderTextInput={({ inputRef, value, ...otherRenderTextInputProps }) => (
+        <MaskedTextInput
+          {...otherRenderTextInputProps}
+          mask={mask}
+          ref={inputRef as unknown as RefObject<MaskedTextInputRef>}
+          onChangeText={onChangeText}
+        />
+      )}
+      value={value}
+      // Передаем коллбэк для поддержания дополнительной логики в разных видах контролов. Например, для очистки поля
+      onChangeText={onChangeText}
+    />
+  )
+}
+
+const meta: Meta<typeof MaskedInput> = {
+  title: 'Legacy/InputMask',
+  args: {
+    clearable: true,
+    disabled: false,
+    state: 'default',
+    placeholder: 'Placeholder',
+    floatLabel: false,
+    mask: '+7 ([000]) [000]-[00]-[00]',
+    size: 'base',
+  },
+  argTypes: {
+    state: { control: 'radio', options: ['default', 'danger'] },
+    size: { control: 'radio', options: ['base', 'large', 'xlarge'] },
+    mask: {
+      control: 'radio',
+      options: [
+        '+7 ([000]) [000]-[00]-[00]',
+        '[00]/[00]/[0000]',
+        '[000]-[000]',
+      ],
+    },
+  },
+  render: (args) => {
+    const [formatted, setFormatted] = useState('')
+    const [extracted, setExtracted] = useState('')
+
+    const onChangeText = useCallback((formatted: string, extracted: string) => {
+      setFormatted(formatted)
+      setExtracted(extracted)
+    }, [])
+
+    return (
+      <View style={{ gap: 10 }}>
+        <Body>Formatted Text: "{formatted}"</Body>
+        <Body>Extracted Text: "{extracted}"</Body>
+        <MaskedInput {...args} onChangeText={onChangeText} />
+      </View>
+    )
+  },
+}
+
+export default meta
+
+type Story = StoryObj<typeof MaskedInput>
+
+const MaskedInputStory: Story = {}
+
+export { MaskedInputStory as InputMask }
diff --git a/src/components/Input/stories/InputText.stories.tsx b/src/components/Input/stories/InputText.stories.tsx
new file mode 100644
index 00000000..a9abdc40
--- /dev/null
+++ b/src/components/Input/stories/InputText.stories.tsx
@@ -0,0 +1,57 @@
+import { useArgs } from '@storybook/preview-api'
+import type { Meta, StoryObj } from '@storybook/react'
+import { useCallback, useEffect, useState } from 'react'
+
+import type { InputTextBase } from '../deprecated/InputTextBase/InputTextBase'
+import { LegacyInputText as InputText } from '../deprecated/LegacyInputText'
+
+const meta: Meta<typeof InputText & typeof InputTextBase> = {
+  title: 'Legacy/InputText',
+  args: {
+    clearable: true,
+    disabled: false,
+    state: 'default',
+    placeholder: 'Placeholder',
+    value: '',
+    floatLabel: false,
+    secureTextEntry: false,
+    loading: false,
+    editable: true,
+    size: 'base',
+  },
+  argTypes: {
+    state: { control: 'radio', options: ['default', 'danger'] },
+    secureTextEntry: {
+      control: 'radio',
+      options: ['true', 'false', 'toggleable'],
+      mapping: { true: true, false: false, toggleable: 'toggleable' },
+    },
+    size: { control: 'radio', options: ['base', 'medium', 'large', 'xlarge'] },
+  },
+  render: (args) => {
+    const [, updateArgs] = useArgs()
+    const [value, setValue] = useState(args.value)
+
+    const onChangeText = useCallback(
+      (nextValue: string) => {
+        setValue(nextValue)
+        updateArgs({ value: nextValue })
+      },
+      [updateArgs]
+    )
+
+    useEffect(() => {
+      setValue(args.value)
+    }, [args.value])
+
+    return <InputText {...args} value={value} onChangeText={onChangeText} />
+  },
+}
+
+export default meta
+
+type Story = StoryObj<typeof InputText>
+
+const InputTextStory: Story = {}
+
+export { InputTextStory as InputText }

From 861aef46747ce07280ffb25a24dbafe2e8aa9505 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 13:43:00 +0300
Subject: [PATCH 02/19] =?UTF-8?q?docs(input-switch):=20=D0=B2=D0=BE=D1=81?=
 =?UTF-8?q?=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BB=D0=B5=D0=BD=D0=B0=20?=
 =?UTF-8?q?=D1=81=D1=82=D0=BE=D1=80=D0=B8=20InputSwitch?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../InputSwitch/InputSwitch.stories.tsx       | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 src/components/InputSwitch/InputSwitch.stories.tsx

diff --git a/src/components/InputSwitch/InputSwitch.stories.tsx b/src/components/InputSwitch/InputSwitch.stories.tsx
new file mode 100644
index 00000000..75b7c3eb
--- /dev/null
+++ b/src/components/InputSwitch/InputSwitch.stories.tsx
@@ -0,0 +1,39 @@
+import { useArgs } from '@storybook/preview-api'
+import type { Meta, StoryObj } from '@storybook/react'
+import { useCallback } from 'react'
+
+import { InputSwitch } from './InputSwitch'
+
+const meta: Meta<typeof InputSwitch> = {
+  title: 'Legacy/InputSwitch',
+  component: InputSwitch,
+  args: { disabled: false, danger: false, checked: false },
+  argTypes: {
+    disabled: { control: 'boolean' },
+    danger: { control: 'boolean' },
+    checked: { control: 'boolean' },
+    onCheckedChange: { action: 'onCheckedChange', control: false },
+  },
+  render: (args) => {
+    const { onCheckedChange: onCheckedChangeAction } = args
+    const [, updateArgs] = useArgs()
+
+    const onCheckedChange = useCallback(
+      (nextValue: boolean) => {
+        updateArgs({ checked: nextValue })
+        onCheckedChangeAction?.(nextValue)
+      },
+      [onCheckedChangeAction, updateArgs]
+    )
+
+    return <InputSwitch {...args} onCheckedChange={onCheckedChange} />
+  },
+}
+
+export default meta
+
+type Story = StoryObj<typeof InputSwitch>
+
+const InputSwitchStory: Story = { name: 'InputSwitch' }
+
+export { InputSwitchStory as InputSwitch }

From bddbc93bd9a2221718d102bb7c276726f21d68f3 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 13:43:10 +0300
Subject: [PATCH 03/19] =?UTF-8?q?docs(typography):=20=D0=B4=D0=BE=D0=B1?=
 =?UTF-8?q?=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B0=20=D1=81=D1=82=D0=BE=D1=80?=
 =?UTF-8?q?=D0=B8=20Overview=20=D0=B4=D0=BB=D1=8F=20=D1=82=D0=B8=D0=BF?=
 =?UTF-8?q?=D0=BE=D0=B3=D1=80=D0=B0=D1=84=D0=B8=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Typography/Typography.stories.tsx         | 295 ++++++++++++++++++
 1 file changed, 295 insertions(+)
 create mode 100644 src/components/Typography/Typography.stories.tsx

diff --git a/src/components/Typography/Typography.stories.tsx b/src/components/Typography/Typography.stories.tsx
new file mode 100644
index 00000000..33472b97
--- /dev/null
+++ b/src/components/Typography/Typography.stories.tsx
@@ -0,0 +1,295 @@
+import type { Meta, StoryObj } from '@storybook/react'
+import { IconArrowUpRight, IconInfoCircle } from '@tabler/icons-react-native'
+import type { ReactNode } from 'react'
+import { ScrollView, View } from 'react-native'
+import { StyleSheet, useUnistyles } from 'react-native-unistyles'
+
+import { Anchor, Body, Caption, Service, Subtitle, Title } from './index'
+
+interface OverviewArgs {
+  readonly sampleText: string
+  readonly showDetails: boolean
+  readonly onLinkPress: () => void
+}
+
+const titleLevels = [
+  'd1',
+  'd2',
+  'd3',
+  'h1',
+  'h2',
+  'h3',
+  'h4',
+  'h5',
+  'h6',
+] as const
+const bodySizes = ['xl', 'lg', 'base'] as const
+const textColors = ['default', 'secondary', 'primary'] as const
+const statuses = [
+  { variant: 'success', text: 'Посылка доставлена' },
+  { variant: 'info', text: 'Курьер уже в пути' },
+  { variant: 'warning', text: 'Проверьте адрес доставки' },
+  { variant: 'danger', text: 'Не удалось сохранить изменения' },
+  { variant: 'help', text: 'Поможем разобраться' },
+] as const
+
+const Section = ({
+  number,
+  title,
+  description,
+  children,
+}: {
+  readonly number: string
+  readonly title: string
+  readonly description: string
+  readonly children: ReactNode
+}) => (
+  <View style={styles.section}>
+    <View style={styles.sectionHeading}>
+      <Subtitle color='primary'>{number}</Subtitle>
+      <Title level='h3'>{title}</Title>
+      <Caption color='secondary'>{description}</Caption>
+    </View>
+    {children}
+  </View>
+)
+
+const Specimen = ({
+  label,
+  showDetails,
+  children,
+}: {
+  readonly label: string
+  readonly showDetails: boolean
+  readonly children: ReactNode
+}) => (
+  <View style={styles.specimen}>
+    {showDetails ? <Caption color='secondary'>{label}</Caption> : null}
+    {children}
+  </View>
+)
+
+const TypographyOverview = ({
+  sampleText,
+  showDetails,
+  onLinkPress,
+}: OverviewArgs) => {
+  const { theme } = useUnistyles()
+
+  return (
+    <ScrollView
+      contentContainerStyle={styles.content}
+      testID='TypographyOverview'
+    >
+      <View style={styles.intro}>
+        <Subtitle color='primary'>Основы дизайн-системы</Subtitle>
+        <Title level='d2'>Типографика</Title>
+        <Body paragraph color='secondary'>
+          От первого заголовка до последней подписи. Одна шкала — разные роли.
+        </Body>
+        <View style={styles.families}>
+          <View style={styles.family}>
+            <Caption color='secondary'>Заголовки</Caption>
+            <Title level='h3'>{theme.fonts.fontFamily.heading}</Title>
+            <Caption color='secondary'>Аа Бб Вв · Aa Bb Cc · 0123</Caption>
+          </View>
+          <View style={styles.family}>
+            <Caption color='secondary'>Текст и интерфейс</Caption>
+            <Body weight='bold'>{theme.fonts.fontFamily.base}</Body>
+            <Caption color='secondary'>Аа Бб Вв · Aa Bb Cc · 0123</Caption>
+          </View>
+        </View>
+      </View>
+
+      <Section
+        description='Title · от выразительного акцента до компактного заголовка'
+        number='01'
+        title='Заголовки'
+      >
+        {titleLevels.map((level) => (
+          <Specimen
+            key={level}
+            label={level.toUpperCase()}
+            showDetails={showDetails}
+          >
+            <Title level={level}>{sampleText}</Title>
+          </Specimen>
+        ))}
+      </Section>
+
+      <Section
+        description='Subtitle · навигация, рубрики и названия разделов'
+        number='02'
+        title='Подзаголовки'
+      >
+        {[true, false].map((base) => (
+          <Specimen
+            key={String(base)}
+            label={base ? 'Базовый' : 'Компактный'}
+            showDetails={showDetails}
+          >
+            <Subtitle base={base}>{sampleText}</Subtitle>
+          </Specimen>
+        ))}
+      </Section>
+
+      <Section
+        description='Body · три размера и два начертания'
+        number='03'
+        title='Основной текст'
+      >
+        {bodySizes.map((size) => (
+          <View key={size} style={styles.specimen}>
+            {showDetails ? (
+              <Caption color='secondary'>{size.toUpperCase()}</Caption>
+            ) : null}
+            <Body size={size}>{sampleText}</Body>
+            <Body size={size} weight='bold'>
+              {sampleText}
+            </Body>
+          </View>
+        ))}
+        <View style={styles.readingSample}>
+          <Subtitle color='primary'>Текст в контексте</Subtitle>
+          <Title level='h2'>Ближе, чем кажется</Title>
+          <Body paragraph>
+            За каждой посылкой — чья-то история. Книга для друга, подарок к
+            празднику или вещь, которую давно ждали. Мы помогаем важному
+            оказаться рядом.
+          </Body>
+          <Anchor RightIcon={IconArrowUpRight} onPress={onLinkPress}>
+            Узнать больше
+          </Anchor>
+        </View>
+        <Specimen label='Цвет и акценты' showDetails={showDetails}>
+          {textColors.map((color) => (
+            <Body color={color} key={color}>
+              {sampleText}
+            </Body>
+          ))}
+          <Body strikethrough>Прежнее значение</Body>
+          <Body disabled>Недоступное действие</Body>
+        </Specimen>
+      </Section>
+
+      <Section
+        description='Caption · пояснения и дополнительная информация'
+        number='04'
+        title='Подписи'
+      >
+        {textColors.map((color) => (
+          <Specimen key={color} label={color} showDetails={showDetails}>
+            <Caption color={color}>{sampleText}</Caption>
+          </Specimen>
+        ))}
+        <Specimen label='С иконкой' showDetails={showDetails}>
+          <Caption Icon={IconInfoCircle}>Срок хранения — 7 дней</Caption>
+        </Specimen>
+        <Specimen label='Недоступное состояние' showDetails={showDetails}>
+          <Caption disabled>Информация появится позже</Caption>
+        </Specimen>
+      </Section>
+
+      <Section
+        description='Service · обратная связь и состояния'
+        number='05'
+        title='Служебный текст'
+      >
+        {statuses.map(({ variant, text }) => (
+          <Specimen key={variant} label={variant} showDetails={showDetails}>
+            <Service showIcon variant={variant}>
+              {text}
+            </Service>
+            <Service base={false} showIcon={false} variant={variant}>
+              {text}
+            </Service>
+          </Specimen>
+        ))}
+      </Section>
+
+      <Section
+        description='Anchor · самостоятельные и внутри текста'
+        number='06'
+        title='Ссылки'
+      >
+        <Specimen
+          label='Обычная · с иконкой · посещённая'
+          showDetails={showDetails}
+        >
+          <Anchor onPress={onLinkPress}>Отследить посылку</Anchor>
+          <Anchor base RightIcon={IconArrowUpRight} onPress={onLinkPress}>
+            Найти ближайший пункт
+          </Anchor>
+          <Anchor visited onPress={onLinkPress}>
+            Условия доставки
+          </Anchor>
+        </Specimen>
+        <Body paragraph>
+          Продолжая, вы принимаете{' '}
+          <Anchor noWrapper onPress={onLinkPress}>
+            условия сервиса
+          </Anchor>{' '}
+          и соглашаетесь с правилами доставки.
+        </Body>
+      </Section>
+    </ScrollView>
+  )
+}
+
+const meta = {
+  title: 'Typography/Overview',
+  component: TypographyOverview,
+  args: { sampleText: 'Доставка без границ', showDetails: true },
+  argTypes: {
+    sampleText: { control: 'text' },
+    showDetails: { control: 'boolean' },
+    onLinkPress: { action: 'onLinkPress' },
+  },
+  parameters: { controls: { exclude: ['onLinkPress'] } },
+} satisfies Meta<typeof TypographyOverview>
+
+export default meta
+
+type Story = StoryObj<typeof TypographyOverview>
+
+export const Overview: Story = {}
+
+const styles = StyleSheet.create(({ semantic }) => ({
+  content: {
+    width: '100%',
+    maxWidth: 720,
+    alignSelf: 'center',
+    gap: semantic.dimension.space[800],
+    paddingBottom: semantic.dimension.space[800],
+  },
+  intro: { gap: semantic.dimension.space[350] },
+  families: {
+    flexDirection: 'row',
+    flexWrap: 'wrap',
+    gap: semantic.dimension.space[200],
+    marginTop: semantic.dimension.space[200],
+  },
+  family: {
+    flexGrow: 1,
+    flexBasis: 150,
+    gap: semantic.dimension.space[200],
+    padding: semantic.dimension.space[350],
+    borderRadius: semantic.dimension.borderRadius[300],
+    backgroundColor: semantic.colorScheme.color.bg.neutral.weak.default,
+  },
+  section: { gap: semantic.dimension.space[350] },
+  sectionHeading: { gap: semantic.dimension.space[100] },
+  specimen: {
+    gap: semantic.dimension.space[200],
+    paddingVertical: semantic.dimension.space[350],
+    borderTopWidth: StyleSheet.hairlineWidth,
+    borderColor: semantic.colorScheme.color.border.neutral.default,
+  },
+  readingSample: {
+    gap: semantic.dimension.space[350],
+    padding: semantic.dimension.space[600],
+    marginVertical: semantic.dimension.space[200],
+    borderRadius: semantic.dimension.borderRadius[400],
+    backgroundColor: semantic.colorScheme.color.bg.neutral.weak.default,
+  },
+}))

From 20389bae33a32a0294088dd216ad946147ffa2cf Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:05:01 +0300
Subject: [PATCH 04/19] =?UTF-8?q?feat(storybook):=20=D0=B4=D0=BE=D0=B1?=
 =?UTF-8?q?=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D1=8B=20=D0=BC=D0=B5=D1=82=D0=BA?=
 =?UTF-8?q?=D0=B8=20=D1=81=D0=BE=D1=81=D1=82=D0=BE=D1=8F=D0=BD=D0=B8=D1=8F?=
 =?UTF-8?q?=20=D0=BA=D0=BE=D0=BC=D0=BF=D0=BE=D0=BD=D0=B5=D0=BD=D1=82=D0=BE?=
 =?UTF-8?q?=D0=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .storybook/StorybookStatusUI.tsx              | 40 +++++++++++++++
 .storybook/StorybookTags.tsx                  | 51 +++++++++++++++++++
 .storybook/index.tsx                          |  4 ++
 package.json                                  |  1 +
 src/components/Badge/Badge.stories.tsx        |  1 +
 .../Button/stories/Button.stories.tsx         |  1 +
 .../Button/stories/ButtonSeverity.stories.tsx |  1 +
 .../InputCaption/InputCaption.stories.tsx     |  1 +
 .../Input/InputGroup/InputGroup.stories.tsx   |  1 +
 .../Input/InputText/InputText.stories.tsx     |  1 +
 .../InputText/InputTextMasked.stories.tsx     |  1 +
 .../Input/Password/Password.stories.tsx       |  1 +
 .../Input/stories/InputGroup.stories.tsx      |  1 +
 .../Input/stories/InputMask.stories.tsx       |  1 +
 .../Input/stories/InputText.stories.tsx       |  1 +
 .../InputSwitch/InputSwitch.stories.tsx       |  1 +
 src/components/Skeleton/Skeleton.stories.tsx  |  1 +
 src/components/Tag/Tag.stories.ts             |  1 +
 .../ToggleSwitch/ToggleSwitch.stories.tsx     |  1 +
 yarn.lock                                     |  3 +-
 20 files changed, 113 insertions(+), 1 deletion(-)
 create mode 100644 .storybook/StorybookStatusUI.tsx
 create mode 100644 .storybook/StorybookTags.tsx

diff --git a/.storybook/StorybookStatusUI.tsx b/.storybook/StorybookStatusUI.tsx
new file mode 100644
index 00000000..16e678b8
--- /dev/null
+++ b/.storybook/StorybookStatusUI.tsx
@@ -0,0 +1,40 @@
+import { FullUI } from '@storybook/react-native-ui'
+import { type ComponentProps, useMemo } from 'react'
+import { Text } from 'react-native'
+
+import { StorybookTags } from './StorybookTags'
+import { view } from './storybook.requires'
+
+export const StorybookStatusUI = ({
+  storyHash,
+  ...props
+}: ComponentProps<typeof FullUI>) => {
+  const taggedStoryHash = useMemo(
+    () =>
+      Object.fromEntries(
+        Object.entries(storyHash).map(([id, entry]) => {
+          if (entry.type !== 'story') return [id, entry]
+
+          // eslint-disable-next-line no-underscore-dangle -- RN 10.3 хранит CSF-теги только в подготовленных сторис.
+          const tags = view._idToPrepared[id].tags
+
+          return [
+            id,
+            {
+              ...entry,
+              tags,
+              renderLabel: (item: { name: string }) => (
+                <Text>
+                  {item.name}
+                  <StorybookTags tags={tags} />
+                </Text>
+              ),
+            },
+          ]
+        })
+      ),
+    [storyHash]
+  )
+
+  return <FullUI {...props} storyHash={taggedStoryHash} />
+}
diff --git a/.storybook/StorybookTags.tsx b/.storybook/StorybookTags.tsx
new file mode 100644
index 00000000..eb424b28
--- /dev/null
+++ b/.storybook/StorybookTags.tsx
@@ -0,0 +1,51 @@
+import { Text } from 'react-native'
+import { StyleSheet } from 'react-native-unistyles'
+
+import type { ThemeType } from '../src/theme'
+
+type TagTone = keyof ThemeType['components']['tag']['colorScheme']
+
+const tagDefinitions: Record<
+  string,
+  { label: string; tone: TagTone } | undefined
+> = {
+  deprecated: { label: 'deprecated', tone: 'warn' },
+  'version:2.0': { label: '2.0', tone: 'info' },
+  'design:pending': { label: 'Design pending', tone: 'secondary' },
+}
+
+const StorybookTag = ({ tag }: { readonly tag: string }) => {
+  const definition = tagDefinitions[tag]
+
+  if (!definition) return null
+
+  return (
+    <Text>
+      {' '}
+      <Text style={styles.badge(definition.tone)}>
+        {` ${definition.label} `}
+      </Text>
+    </Text>
+  )
+}
+
+export const StorybookTags = ({
+  tags,
+}: {
+  readonly tags: readonly string[]
+}) => (
+  <>
+    {tags.map((tag) => (
+      <StorybookTag key={tag} tag={tag} />
+    ))}
+  </>
+)
+
+const styles = StyleSheet.create(({ components, fonts, semantic }) => ({
+  badge: (tone: TagTone) => ({
+    fontSize: components.tag.root.fontSize - 1,
+    fontWeight: fonts.fontWeight.demibold,
+    color: semantic.colorScheme.color.fg.default,
+    backgroundColor: components.tag.colorScheme[tone].background,
+  }),
+}))
diff --git a/.storybook/index.tsx b/.storybook/index.tsx
index 3867df20..65accd9d 100644
--- a/.storybook/index.tsx
+++ b/.storybook/index.tsx
@@ -1,10 +1,14 @@
+import '../src/theme/ThemeContext'
+
 import { createAsyncStorage } from '@react-native-async-storage/async-storage'
 
+import { StorybookStatusUI } from './StorybookStatusUI'
 import { view } from './storybook.requires'
 
 const storage = createAsyncStorage('storybook')
 
 const StorybookUIRoot = view.getStorybookUI({
+  CustomUIComponent: StorybookStatusUI,
   storage,
   theme: {
     typography: {
diff --git a/package.json b/package.json
index 43ed6de6..6e41480f 100644
--- a/package.json
+++ b/package.json
@@ -78,6 +78,7 @@
     "@storybook/core": "8.6.14",
     "@storybook/preview-api": "8.6.14",
     "@storybook/react-native": "10.3.2",
+    "@storybook/react-native-ui": "10.3.2",
     "@stylistic/eslint-plugin": "5.6.1",
     "@testing-library/react-native": "13.3.3",
     "@types/jest": "29.5.14",
diff --git a/src/components/Badge/Badge.stories.tsx b/src/components/Badge/Badge.stories.tsx
index c359c814..4d196016 100644
--- a/src/components/Badge/Badge.stories.tsx
+++ b/src/components/Badge/Badge.stories.tsx
@@ -12,6 +12,7 @@ const styles = StyleSheet.create({
 
 const meta: Meta<typeof Badge> = {
   title: 'Misc/Badge',
+  tags: ['version:2.0'],
   component: Badge,
   args: { children: 'Badge', severity: 'primary', size: 'base' },
   argTypes: {
diff --git a/src/components/Button/stories/Button.stories.tsx b/src/components/Button/stories/Button.stories.tsx
index 80a9b47a..f18226fa 100644
--- a/src/components/Button/stories/Button.stories.tsx
+++ b/src/components/Button/stories/Button.stories.tsx
@@ -27,6 +27,7 @@ const styles = StyleSheet.create({
 
 const meta: Meta<StoryArgs> = {
   title: 'Button/Button',
+  tags: ['version:2.0'],
   component: Button,
   args: {
     size: 'base',
diff --git a/src/components/Button/stories/ButtonSeverity.stories.tsx b/src/components/Button/stories/ButtonSeverity.stories.tsx
index 11ebd207..724cc10e 100644
--- a/src/components/Button/stories/ButtonSeverity.stories.tsx
+++ b/src/components/Button/stories/ButtonSeverity.stories.tsx
@@ -33,6 +33,7 @@ const styles = StyleSheet.create({
 
 const meta: Meta<StoryArgs> = {
   title: 'Button/ButtonSeverity',
+  tags: ['version:2.0'],
   component: ButtonSeverity,
   args: {
     size: 'base',
diff --git a/src/components/Input/InputCaption/InputCaption.stories.tsx b/src/components/Input/InputCaption/InputCaption.stories.tsx
index b0ba46f5..413d79b2 100644
--- a/src/components/Input/InputCaption/InputCaption.stories.tsx
+++ b/src/components/Input/InputCaption/InputCaption.stories.tsx
@@ -6,6 +6,7 @@ import { InputCaption } from './InputCaption'
 
 const meta: Meta<typeof InputCaption> = {
   title: 'Input/InputCaption',
+  tags: ['version:2.0', 'design:pending'],
   component: InputCaption,
   args: { children: 'Подсказка к полю', variant: 'base', showIcon: false },
   argTypes: {
diff --git a/src/components/Input/InputGroup/InputGroup.stories.tsx b/src/components/Input/InputGroup/InputGroup.stories.tsx
index f3702d62..1e6c57a1 100644
--- a/src/components/Input/InputGroup/InputGroup.stories.tsx
+++ b/src/components/Input/InputGroup/InputGroup.stories.tsx
@@ -54,6 +54,7 @@ type StoryArgs = Omit<InputLabelStoryArgs<InputGroupProps>, 'rightAddon'> & {
 
 const meta = {
   title: 'Input/InputGroup',
+  tags: ['version:2.0', 'design:pending'],
   component: InputGroup,
   args: {
     labelMode: 'none',
diff --git a/src/components/Input/InputText/InputText.stories.tsx b/src/components/Input/InputText/InputText.stories.tsx
index 3163bdf2..fef957ab 100644
--- a/src/components/Input/InputText/InputText.stories.tsx
+++ b/src/components/Input/InputText/InputText.stories.tsx
@@ -15,6 +15,7 @@ type StoryArgs = InputLabelStoryArgs<InputTextProps>
 
 const meta = {
   title: 'Input/InputText',
+  tags: ['version:2.0', 'design:pending'],
   component: InputText,
   args: {
     labelMode: 'label',
diff --git a/src/components/Input/InputText/InputTextMasked.stories.tsx b/src/components/Input/InputText/InputTextMasked.stories.tsx
index 2bd053ca..939368a4 100644
--- a/src/components/Input/InputText/InputTextMasked.stories.tsx
+++ b/src/components/Input/InputText/InputTextMasked.stories.tsx
@@ -75,6 +75,7 @@ const MaskedControl = ({
 const meta = {
   ...inputTextMeta,
   title: 'Input/Input Text With Mask',
+  tags: ['version:2.0', 'design:pending'],
   args: {
     ...inputTextMeta.args,
     labelText: 'Значение',
diff --git a/src/components/Input/Password/Password.stories.tsx b/src/components/Input/Password/Password.stories.tsx
index 2a999d2b..9aa5c32f 100644
--- a/src/components/Input/Password/Password.stories.tsx
+++ b/src/components/Input/Password/Password.stories.tsx
@@ -24,6 +24,7 @@ type StoryArgs = InputLabelStoryArgs<PasswordProps> & {
 
 const meta: InputStoryMeta<PasswordProps, StoryArgs> = {
   title: 'Input/Password',
+  tags: ['version:2.0', 'design:pending'],
   component: Password,
   args: {
     labelMode: 'label',
diff --git a/src/components/Input/stories/InputGroup.stories.tsx b/src/components/Input/stories/InputGroup.stories.tsx
index 75403c3b..a05e66a7 100644
--- a/src/components/Input/stories/InputGroup.stories.tsx
+++ b/src/components/Input/stories/InputGroup.stories.tsx
@@ -7,6 +7,7 @@ import { LegacyInputGroup as InputGroup } from '../deprecated/LegacyInputGroup'
 
 const meta: Meta<typeof InputGroup> = {
   title: 'Legacy/InputGroup',
+  tags: ['deprecated'],
   args: {
     clearable: true,
     disabled: false,
diff --git a/src/components/Input/stories/InputMask.stories.tsx b/src/components/Input/stories/InputMask.stories.tsx
index 4a6e0da7..b87a14cf 100644
--- a/src/components/Input/stories/InputMask.stories.tsx
+++ b/src/components/Input/stories/InputMask.stories.tsx
@@ -74,6 +74,7 @@ const MaskedInput = <T extends InputTextProps>({
 
 const meta: Meta<typeof MaskedInput> = {
   title: 'Legacy/InputMask',
+  tags: ['deprecated'],
   args: {
     clearable: true,
     disabled: false,
diff --git a/src/components/Input/stories/InputText.stories.tsx b/src/components/Input/stories/InputText.stories.tsx
index a9abdc40..998e9b6b 100644
--- a/src/components/Input/stories/InputText.stories.tsx
+++ b/src/components/Input/stories/InputText.stories.tsx
@@ -7,6 +7,7 @@ import { LegacyInputText as InputText } from '../deprecated/LegacyInputText'
 
 const meta: Meta<typeof InputText & typeof InputTextBase> = {
   title: 'Legacy/InputText',
+  tags: ['deprecated'],
   args: {
     clearable: true,
     disabled: false,
diff --git a/src/components/InputSwitch/InputSwitch.stories.tsx b/src/components/InputSwitch/InputSwitch.stories.tsx
index 75b7c3eb..8f8d0f3a 100644
--- a/src/components/InputSwitch/InputSwitch.stories.tsx
+++ b/src/components/InputSwitch/InputSwitch.stories.tsx
@@ -6,6 +6,7 @@ import { InputSwitch } from './InputSwitch'
 
 const meta: Meta<typeof InputSwitch> = {
   title: 'Legacy/InputSwitch',
+  tags: ['deprecated'],
   component: InputSwitch,
   args: { disabled: false, danger: false, checked: false },
   argTypes: {
diff --git a/src/components/Skeleton/Skeleton.stories.tsx b/src/components/Skeleton/Skeleton.stories.tsx
index accee6bc..9d286d5d 100644
--- a/src/components/Skeleton/Skeleton.stories.tsx
+++ b/src/components/Skeleton/Skeleton.stories.tsx
@@ -11,6 +11,7 @@ const styles = StyleSheet.create({
 
 const meta: Meta<typeof Skeleton> = {
   title: 'Misc/Skeleton',
+  tags: ['version:2.0'],
   component: Skeleton,
   render: () => (
     <View
diff --git a/src/components/Tag/Tag.stories.ts b/src/components/Tag/Tag.stories.ts
index 313d9b54..e2708040 100644
--- a/src/components/Tag/Tag.stories.ts
+++ b/src/components/Tag/Tag.stories.ts
@@ -20,6 +20,7 @@ const icons = {
 
 const meta: Meta<typeof Tag> = {
   title: 'Misc/Tag',
+  tags: ['design:pending'],
   component: Tag,
   args: { text: 'Tag', rounded: false, severity: 'primary', showIcon: true },
   argTypes: {
diff --git a/src/components/ToggleSwitch/ToggleSwitch.stories.tsx b/src/components/ToggleSwitch/ToggleSwitch.stories.tsx
index ecc9b3ba..e3092802 100644
--- a/src/components/ToggleSwitch/ToggleSwitch.stories.tsx
+++ b/src/components/ToggleSwitch/ToggleSwitch.stories.tsx
@@ -6,6 +6,7 @@ import type { ToggleSwitchProps } from './types'
 
 const meta: Meta<ToggleSwitchProps> = {
   title: 'Form/ToggleSwitch',
+  tags: ['version:2.0', 'design:pending'],
   component: ToggleSwitch,
   args: {
     checked: false,
diff --git a/yarn.lock b/yarn.lock
index d17ddfa0..f4758a53 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2836,6 +2836,7 @@ __metadata:
     "@storybook/core": "npm:8.6.14"
     "@storybook/preview-api": "npm:8.6.14"
     "@storybook/react-native": "npm:10.3.2"
+    "@storybook/react-native-ui": "npm:10.3.2"
     "@stylistic/eslint-plugin": "npm:5.6.1"
     "@tabler/icons-react-native": "npm:^3.36.0"
     "@testing-library/react-native": "npm:13.3.3"
@@ -5643,7 +5644,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@storybook/react-native-ui@npm:^10.3.2":
+"@storybook/react-native-ui@npm:10.3.2, @storybook/react-native-ui@npm:^10.3.2":
   version: 10.3.2
   resolution: "@storybook/react-native-ui@npm:10.3.2"
   dependencies:

From 284ff687378c443447b2038eee6393d14697726f Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:05:02 +0300
Subject: [PATCH 05/19] =?UTF-8?q?chore(storybook):=20=D0=BD=D0=B0=D1=81?=
 =?UTF-8?q?=D1=82=D1=80=D0=BE=D0=B5=D0=BD=20=D0=BF=D0=BE=D1=80=D1=8F=D0=B4?=
 =?UTF-8?q?=D0=BE=D0=BA=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=D0=BE=D0=B2?=
 =?UTF-8?q?=20=D0=B8=20=D1=81=D1=82=D0=BE=D1=80=D0=B8=D1=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .storybook/preview.tsx | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.storybook/preview.tsx b/.storybook/preview.tsx
index aad256fd..2a697340 100644
--- a/.storybook/preview.tsx
+++ b/.storybook/preview.tsx
@@ -31,7 +31,13 @@ const preview: Preview = {
     },
   ],
   parameters: {
-    options: { storySort: { method: 'alphabetical', includeNames: true } },
+    options: {
+      storySort: {
+        method: 'alphabetical',
+        includeNames: true,
+        order: ['*', 'Typography', ['Overview', '*'], 'Legacy'],
+      },
+    },
     actions: { argTypesRegex: '^on[A-Z].*' },
     controls: { matchers: { color: /(background|color)$/i, date: /Date$/ } },
   },

From 1400dee72634187b6666e642278c78a701e1b91d Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:05:03 +0300
Subject: [PATCH 06/19] =?UTF-8?q?docs(storybook):=20=D0=BE=D0=B1=D1=8A?=
 =?UTF-8?q?=D0=B5=D0=B4=D0=B8=D0=BD=D0=B5=D0=BD=D1=8B=20=D1=81=D1=82=D0=BE?=
 =?UTF-8?q?=D1=80=D0=B8=D1=81=20=D0=BA=D0=BE=D0=BC=D0=BF=D0=BE=D0=BD=D0=B5?=
 =?UTF-8?q?=D0=BD=D1=82=D0=BE=D0=B2=20=D1=84=D0=BE=D1=80=D0=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/Checkbox/Checkbox.stories.ts          | 2 +-
 src/components/InputOtp/InputOtp.stories.tsx         | 2 +-
 src/components/RadioButton/RadioButton.stories.ts    | 2 +-
 src/components/SelectButton/SelectButton.stories.tsx | 2 +-
 src/components/Slider/Slider.stories.tsx             | 2 +-
 src/components/ToggleButton/ToggleButton.stories.ts  | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/components/Checkbox/Checkbox.stories.ts b/src/components/Checkbox/Checkbox.stories.ts
index 81f77364..56d13b3d 100644
--- a/src/components/Checkbox/Checkbox.stories.ts
+++ b/src/components/Checkbox/Checkbox.stories.ts
@@ -3,7 +3,7 @@ import type { Meta, StoryObj } from '@storybook/react'
 import { Checkbox } from './Checkbox'
 
 const meta: Meta<typeof Checkbox> = {
-  title: 'Other Form/Checkbox',
+  title: 'Form/Checkbox',
   component: Checkbox,
   args: {
     checked: false,
diff --git a/src/components/InputOtp/InputOtp.stories.tsx b/src/components/InputOtp/InputOtp.stories.tsx
index b6f50856..b0600197 100644
--- a/src/components/InputOtp/InputOtp.stories.tsx
+++ b/src/components/InputOtp/InputOtp.stories.tsx
@@ -14,7 +14,7 @@ const validateOtp = () =>
   })
 
 const meta: Meta<typeof InputOtp> = {
-  title: 'Other Form/InputOtp',
+  title: 'Form/InputOtp',
   component: InputOtp,
   args: { disabled: false, error: false, length: 4, value: '' },
   render: (args) => {
diff --git a/src/components/RadioButton/RadioButton.stories.ts b/src/components/RadioButton/RadioButton.stories.ts
index 56efc0a2..d47ce90c 100644
--- a/src/components/RadioButton/RadioButton.stories.ts
+++ b/src/components/RadioButton/RadioButton.stories.ts
@@ -3,7 +3,7 @@ import type { Meta, StoryObj } from '@storybook/react'
 import { RadioButton } from './RadioButton'
 
 const meta: Meta<typeof RadioButton> = {
-  title: 'Other Form/RadioButton',
+  title: 'Form/RadioButton',
   component: RadioButton,
   args: { checked: false, disabled: false, state: 'default' },
   argTypes: { state: { control: 'radio', options: ['default', 'danger'] } },
diff --git a/src/components/SelectButton/SelectButton.stories.tsx b/src/components/SelectButton/SelectButton.stories.tsx
index cb7f230c..5d736c08 100644
--- a/src/components/SelectButton/SelectButton.stories.tsx
+++ b/src/components/SelectButton/SelectButton.stories.tsx
@@ -39,7 +39,7 @@ const AnimatedExample = ({ buttons, ...props }: CommonProps) => {
 }
 
 const meta: Meta<typeof SelectButton> = {
-  title: 'Other Form/SelectButton',
+  title: 'Form/SelectButton',
   component: SelectButton,
   args: { buttons, size: 'base', disabled: false },
   argTypes: {
diff --git a/src/components/Slider/Slider.stories.tsx b/src/components/Slider/Slider.stories.tsx
index 11733182..acabcb08 100644
--- a/src/components/Slider/Slider.stories.tsx
+++ b/src/components/Slider/Slider.stories.tsx
@@ -7,7 +7,7 @@ import { StyleSheet } from 'react-native-unistyles'
 import { Slider, type SliderProps } from './Slider'
 
 const meta: Meta<typeof Slider> = {
-  title: 'Other Form/Slider',
+  title: 'Form/Slider',
   component: Slider,
   args: { disabled: false },
   render: (args) => Template(args),
diff --git a/src/components/ToggleButton/ToggleButton.stories.ts b/src/components/ToggleButton/ToggleButton.stories.ts
index 119572b1..d7598359 100644
--- a/src/components/ToggleButton/ToggleButton.stories.ts
+++ b/src/components/ToggleButton/ToggleButton.stories.ts
@@ -8,7 +8,7 @@ const svgIcons = { IconArrowDownRight, IconUser, none: undefined }
 const imageIcons = { hotels: require('./hotels.png'), none: undefined }
 
 const meta: Meta<typeof ToggleButton> = {
-  title: 'Other Form/ToggleButton',
+  title: 'Form/ToggleButton',
   component: ToggleButton,
   args: {
     checked: false,

From b4a5eb54db53c9a8c36695ed84e5d20fb16303b7 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:05:04 +0300
Subject: [PATCH 07/19] =?UTF-8?q?docs(storybook):=20=D1=81=D0=B3=D1=80?=
 =?UTF-8?q?=D1=83=D0=BF=D0=BF=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D1=8B=20?=
 =?UTF-8?q?=D0=BC=D0=B5=D0=BD=D1=8E=20=D0=B8=20=D0=B2=D0=BA=D0=BB=D0=B0?=
 =?UTF-8?q?=D0=B4=D0=BA=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/List/Base/ListBase.stories.tsx               | 2 +-
 .../MenuItem/Template/MenuItemTemplate.stories.tsx          | 2 +-
 src/components/Tabs/Tabs.stories.tsx                        | 6 +++---
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/components/List/Base/ListBase.stories.tsx b/src/components/List/Base/ListBase.stories.tsx
index 920a812b..d05d3702 100644
--- a/src/components/List/Base/ListBase.stories.tsx
+++ b/src/components/List/Base/ListBase.stories.tsx
@@ -17,7 +17,7 @@ const Extras = {
 }
 
 const meta: Meta<typeof ListBase> = {
-  title: 'Templates/List',
+  title: 'Menu/List',
   component: ListBase,
   args: {
     iconAlignment: 'top',
diff --git a/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx b/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx
index ceb4145e..b0411704 100644
--- a/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx
+++ b/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx
@@ -18,7 +18,7 @@ const Extras = {
 }
 
 const meta: Meta<typeof MenuItemTemplate> = {
-  title: 'Mixins/MenuItemTemplate',
+  title: 'Menu/MenuItemTemplate',
   component: MenuItemTemplate,
   args: {
     title: 'Menu Item',
diff --git a/src/components/Tabs/Tabs.stories.tsx b/src/components/Tabs/Tabs.stories.tsx
index 3da12fa2..a6497354 100644
--- a/src/components/Tabs/Tabs.stories.tsx
+++ b/src/components/Tabs/Tabs.stories.tsx
@@ -7,7 +7,7 @@ import { Badge } from '../Badge'
 
 import { Tabs, TabPanel } from '.'
 
-const meta: Meta<typeof Tabs> = { title: 'Menu/Tab', component: Tabs }
+const meta: Meta<typeof Tabs> = { title: 'Panel/Tabs', component: Tabs }
 export default meta
 
 type Story = StoryObj<typeof Tabs>
@@ -42,9 +42,9 @@ const TabsExample = ({ disabled }: { readonly disabled?: boolean }) => {
   )
 }
 
-const TabStory: Story = {
+const TabsStory: Story = {
   args: { disabled: false },
   render: (args) => <TabsExample {...args} />,
 }
 
-export { TabStory as Tab }
+export { TabsStory as Tabs }

From 9e654bc2f00c9eaf79159af9dfa03fc102a3a141 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:05:05 +0300
Subject: [PATCH 08/19] =?UTF-8?q?docs(dialog):=20=D0=BE=D0=B1=D1=8A=D0=B5?=
 =?UTF-8?q?=D0=B4=D0=B8=D0=BD=D0=B5=D0=BD=D1=8B=20=D0=B2=D0=B0=D1=80=D0=B8?=
 =?UTF-8?q?=D0=B0=D0=BD=D1=82=D1=8B=20=D0=B4=D0=B8=D0=B0=D0=BB=D0=BE=D0=B3?=
 =?UTF-8?q?=D0=B0=20=D0=B2=20=D0=BE=D0=B4=D0=BD=D0=BE=D0=B9=20=D1=81=D1=82?=
 =?UTF-8?q?=D0=BE=D1=80=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/Dialog/Dialog.stories.tsx      | 117 ++++++++++--------
 .../Dialog/DialogComponent.stories.tsx        |  66 ----------
 2 files changed, 66 insertions(+), 117 deletions(-)
 delete mode 100644 src/components/Dialog/DialogComponent.stories.tsx

diff --git a/src/components/Dialog/Dialog.stories.tsx b/src/components/Dialog/Dialog.stories.tsx
index 539536d0..7aa57952 100644
--- a/src/components/Dialog/Dialog.stories.tsx
+++ b/src/components/Dialog/Dialog.stories.tsx
@@ -1,10 +1,24 @@
+import { useArgs } from '@storybook/preview-api'
 import type { Meta, StoryObj } from '@storybook/react'
-import { useCallback, useState } from 'react'
-import { Text, TouchableOpacity, View } from 'react-native'
+import { useCallback } from 'react'
+import { View } from 'react-native'
+import { StyleSheet } from 'react-native-unistyles'
+
+import { Button } from '../Button'
+import { Body } from '../Typography'
 
 import { Dialog, type DialogProps } from './Dialog'
+import { DialogComponent } from './DialogComponent'
 import { DialogHeader, type DialogHeaderProps } from './DialogHeader'
 
+type DialogStoryArgs = DialogProps & Pick<DialogHeaderProps, 'severity'>
+
+const DialogBody = () => (
+  <Body>Войдите в приложение, чтобы заказ сохранился в списке заказов</Body>
+)
+
+const InlineFooter = () => <Button label='Войти' />
+
 const severityMap = {
   info: 'info',
   success: 'success',
@@ -14,70 +28,43 @@ const severityMap = {
   none: undefined,
 }
 
-const meta: Meta<DialogProps & DialogHeaderProps> = {
-  title: 'Overlay/Dialog Modal=true',
-  component: Dialog,
-  render: (props) => Template(props),
-  args: { severity: 'info' },
-  argTypes: {
-    severity: {
-      control: 'radio',
-      options: Object.keys(severityMap),
-      mapping: severityMap,
-    },
-    onClose: { action: 'onClose' },
-    onHideComplete: { action: 'onHideComplete' },
-  },
-}
-
-const Template = ({
+const DialogExample = ({
+  isVisible,
   severity,
   onHideComplete,
   onClose,
-}: DialogProps & DialogHeaderProps) => {
-  const [isVisible, setIsVisible] = useState(false)
+}: DialogStoryArgs) => {
+  const [, updateArgs] = useArgs<DialogStoryArgs>()
 
   const showDialog = () => {
-    setIsVisible(true)
+    updateArgs({ isVisible: true })
   }
 
   const hideDialog = useCallback(() => {
-    setIsVisible(false)
+    updateArgs({ isVisible: false })
     onClose?.()
-  }, [onClose])
-
-  const Body = useCallback(() => {
-    return (
-      <Text>Войдите в приложение, чтобы заказ сохранился в списке заказов</Text>
-    )
-  }, [])
+  }, [onClose, updateArgs])
 
   const Footer = useCallback(() => {
-    return (
-      <TouchableOpacity onPress={hideDialog}>
-        <Text>Войти</Text>
-      </TouchableOpacity>
-    )
+    return <Button label='Войти' onPress={hideDialog} />
   }, [hideDialog])
 
+  const headerProps = { severity, title: 'Найденный заказ не сохранится' }
+
   return (
-    <View>
-      <View>
-        <TouchableOpacity onPress={showDialog}>
-          <Text>Показать Dialog</Text>
-        </TouchableOpacity>
+    <View style={styles.container}>
+      <View style={styles.preview}>
+        <DialogComponent
+          body={DialogBody}
+          footer={InlineFooter}
+          header={<DialogHeader {...headerProps} />}
+        />
       </View>
-
+      <Button label='Показать модальный Dialog' onPress={showDialog} />
       <Dialog
-        body={Body}
+        body={DialogBody}
         footer={Footer}
-        header={
-          <DialogHeader
-            severity={severity}
-            title='Найденный заказ не сохранится'
-            onClose={hideDialog}
-          />
-        }
+        header={<DialogHeader {...headerProps} onClose={hideDialog} />}
         isVisible={isVisible}
         onClose={hideDialog}
         onHideComplete={onHideComplete}
@@ -86,8 +73,36 @@ const Template = ({
   )
 }
 
+const meta: Meta<DialogStoryArgs> = {
+  title: 'Overlay/Dialog',
+  component: Dialog,
+  render: DialogExample,
+  args: { severity: 'info', isVisible: false },
+  argTypes: {
+    severity: {
+      control: 'radio',
+      options: Object.keys(severityMap),
+      mapping: severityMap,
+    },
+    onClose: { action: 'onClose' },
+    onHideComplete: { action: 'onHideComplete' },
+  },
+  parameters: { controls: { include: ['severity'] } },
+}
+
 export default meta
 
-type Story = StoryObj<typeof Dialog>
+type Story = StoryObj<DialogStoryArgs>
+
+const DialogStory: Story = {}
 
-export const Modal: Story = { name: 'Dialog modal=true', args: {} }
+export { DialogStory as Dialog }
+
+const styles = StyleSheet.create(({ components, semantic }) => ({
+  container: { gap: 16 },
+  preview: {
+    borderWidth: 1,
+    borderColor: semantic.colorScheme.color.border.neutral.default,
+    borderRadius: components.dialog.root.borderRadius,
+  },
+}))
diff --git a/src/components/Dialog/DialogComponent.stories.tsx b/src/components/Dialog/DialogComponent.stories.tsx
deleted file mode 100644
index f44ae225..00000000
--- a/src/components/Dialog/DialogComponent.stories.tsx
+++ /dev/null
@@ -1,66 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react'
-import { useCallback } from 'react'
-import { Text, TouchableOpacity, View } from 'react-native'
-
-import { DialogComponent, type DialogComponentProps } from './DialogComponent'
-import { DialogHeader, type DialogHeaderProps } from './DialogHeader'
-
-const severityMap = {
-  info: 'info',
-  success: 'success',
-  warning: 'warning',
-  danger: 'danger',
-  help: 'help',
-  none: undefined,
-}
-
-const meta: Meta<DialogComponentProps & DialogHeaderProps> = {
-  title: 'Overlay/Dialog Modal=false',
-  component: DialogComponent,
-  render: (props) => Template(props),
-  args: { severity: 'info' },
-  argTypes: {
-    severity: {
-      control: 'radio',
-      options: Object.keys(severityMap),
-      mapping: severityMap,
-    },
-  },
-}
-
-const Template = ({ severity }: DialogComponentProps & DialogHeaderProps) => {
-  const Body = useCallback(() => {
-    return (
-      <Text>Войдите в приложение, чтобы заказ сохранился в списке заказов</Text>
-    )
-  }, [])
-
-  const Footer = useCallback(() => {
-    return (
-      <TouchableOpacity>
-        <Text>Войти</Text>
-      </TouchableOpacity>
-    )
-  }, [])
-
-  return (
-    <View>
-      <DialogComponent
-        body={Body}
-        footer={Footer}
-        header={
-          <DialogHeader
-            severity={severity}
-            title='Найденный заказ не сохранится'
-          />
-        }
-      />
-    </View>
-  )
-}
-
-export default meta
-
-type Story = StoryObj<typeof DialogComponent>
-
-export const NonModal: Story = { name: 'Dialog modal=false', args: {} }

From 0fec30e7ffd8f94104ae563898fd77917a2fe6e4 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:05:06 +0300
Subject: [PATCH 09/19] =?UTF-8?q?docs(accordion):=20=D1=83=D0=BF=D1=80?=
 =?UTF-8?q?=D0=BE=D1=89=D0=B5=D0=BD=D0=B0=20=D0=B8=D0=BD=D1=82=D0=B5=D1=80?=
 =?UTF-8?q?=D0=B0=D0=BA=D1=82=D0=B8=D0=B2=D0=BD=D0=B0=D1=8F=20=D1=81=D1=82?=
 =?UTF-8?q?=D0=BE=D1=80=D0=B8=20=D0=B0=D0=BA=D0=BA=D0=BE=D1=80=D0=B4=D0=B5?=
 =?UTF-8?q?=D0=BE=D0=BD=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Accordion/Accordion.stories.tsx           | 67 +++++--------------
 1 file changed, 18 insertions(+), 49 deletions(-)

diff --git a/src/components/Accordion/Accordion.stories.tsx b/src/components/Accordion/Accordion.stories.tsx
index dbceea57..773f2b6c 100644
--- a/src/components/Accordion/Accordion.stories.tsx
+++ b/src/components/Accordion/Accordion.stories.tsx
@@ -6,12 +6,12 @@ import {
   IconUser,
 } from '@tabler/icons-react-native'
 
-import { memo } from 'react'
 import { View } from 'react-native'
+import { StyleSheet } from 'react-native-unistyles'
 
 import { Body } from '../Typography'
 
-import { Accordion, type AccordionProps } from './Accordion'
+import { Accordion } from './Accordion'
 
 const Icons = { undefined, IconUser, IconList, IconSquare }
 const Extras = {
@@ -19,24 +19,16 @@ const Extras = {
   IconDiamond: <IconDiamond height={21} width={21} />,
 }
 
-const TestAccordion = memo<Omit<AccordionProps, 'childern'>>((props) => {
-  return (
-    <Accordion {...props}>
-      <View style={{ padding: 24, backgroundColor: 'blanchedalmond' }}>
-        <Body>Это контент аккордеона</Body>
-      </View>
-    </Accordion>
-  )
-})
-
 const meta: Meta<typeof Accordion> = {
   title: 'Panel/Accordion',
-  component: TestAccordion,
+  component: Accordion,
   args: {
     title: 'Accordion',
     Icon: undefined,
     titleExtra: undefined,
     withSeparator: false,
+    disabled: false,
+    isInitiallyExpanded: false,
   },
   argTypes: {
     Icon: { control: 'select', options: Object.keys(Icons), mapping: Icons },
@@ -48,30 +40,20 @@ const meta: Meta<typeof Accordion> = {
     },
     withSeparator: { control: 'boolean' },
     disabled: { control: 'boolean' },
+    isInitiallyExpanded: { control: 'boolean' },
   },
-  parameters: {
-    notes: `
-      #### Акордеон - полный набор свойств
-
-      <Accordion
-        title="Menu item title"
-        Icon=IconUser,
-        extra=IconDiamond,
-        isExpanded
-      >
-        // Content
-      </Accordion>
-  `,
-  },
-  decorators: [
-    (Story) => (
-      <View
-        style={{ padding: 16, alignContent: 'center', alignItems: 'center' }}
-      >
-        <Story />
+  parameters: { controls: { exclude: ['children', 'style', 'testID'] } },
+  render: (args) => (
+    // Начальное состояние Accordion применяется только при монтировании.
+    <Accordion
+      key={args.isInitiallyExpanded ? 'expanded' : 'collapsed'}
+      {...args}
+    >
+      <View style={styles.content}>
+        <Body>Это контент аккордеона</Body>
       </View>
-    ),
-  ],
+    </Accordion>
+  ),
 }
 
 export default meta
@@ -82,17 +64,4 @@ const AccordionStory: Story = {}
 
 export { AccordionStory as Accordion }
 
-export const Expanded: Story = { args: { isInitiallyExpanded: true } }
-
-export const LongTitle: Story = {
-  args: {
-    title:
-      'Длинный заголовок аккордеона, который занимает несколько строк и остаётся читаемым при раскрытии содержимого',
-    Icon: IconUser,
-    titleExtra: Extras.IconDiamond,
-  },
-}
-
-export const LongTitleExpanded: Story = {
-  args: { ...LongTitle.args, isInitiallyExpanded: true },
-}
+const styles = StyleSheet.create({ content: { padding: 24 } })

From ca5241a40ef17feecb2c2acb2762d633316ce616 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:15:57 +0300
Subject: [PATCH 10/19] =?UTF-8?q?docs(storybook):=20=D0=BF=D0=B5=D1=80?=
 =?UTF-8?q?=D0=B5=D0=B8=D0=BC=D0=B5=D0=BD=D0=BE=D0=B2=D0=B0=D0=BD=D1=8B=20?=
 =?UTF-8?q?=D0=B3=D1=80=D1=83=D0=BF=D0=BF=D1=8B=20=D0=BF=D0=BE=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=B9=20=D0=B2=D0=B2=D0=BE=D0=B4=D0=B0=20=D0=B8=20=D1=80=D0=B5?=
 =?UTF-8?q?=D0=B9=D1=82=D0=B8=D0=BD=D0=B3=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/Input/InputCaption/InputCaption.stories.tsx | 2 +-
 src/components/Input/InputGroup/InputGroup.stories.tsx     | 2 +-
 src/components/Input/InputText/InputText.stories.tsx       | 2 +-
 src/components/Input/InputText/InputTextMasked.stories.tsx | 2 +-
 src/components/Input/Password/Password.stories.tsx         | 2 +-
 src/components/InputOtp/InputOtp.stories.tsx               | 2 +-
 src/components/Rating/stories/Rating.stories.tsx           | 2 +-
 src/components/Rating/stories/RatingClear.stories.ts       | 2 +-
 src/components/Rating/stories/RatingItem.stories.ts        | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/components/Input/InputCaption/InputCaption.stories.tsx b/src/components/Input/InputCaption/InputCaption.stories.tsx
index 413d79b2..445f676f 100644
--- a/src/components/Input/InputCaption/InputCaption.stories.tsx
+++ b/src/components/Input/InputCaption/InputCaption.stories.tsx
@@ -5,7 +5,7 @@ import { inputDocumentationNotes } from '../../../../.storybook/inputDocumentati
 import { InputCaption } from './InputCaption'
 
 const meta: Meta<typeof InputCaption> = {
-  title: 'Input/InputCaption',
+  title: 'Form Input/InputCaption',
   tags: ['version:2.0', 'design:pending'],
   component: InputCaption,
   args: { children: 'Подсказка к полю', variant: 'base', showIcon: false },
diff --git a/src/components/Input/InputGroup/InputGroup.stories.tsx b/src/components/Input/InputGroup/InputGroup.stories.tsx
index 1e6c57a1..de7e670c 100644
--- a/src/components/Input/InputGroup/InputGroup.stories.tsx
+++ b/src/components/Input/InputGroup/InputGroup.stories.tsx
@@ -53,7 +53,7 @@ type StoryArgs = Omit<InputLabelStoryArgs<InputGroupProps>, 'rightAddon'> & {
 }
 
 const meta = {
-  title: 'Input/InputGroup',
+  title: 'Form Input/InputGroup',
   tags: ['version:2.0', 'design:pending'],
   component: InputGroup,
   args: {
diff --git a/src/components/Input/InputText/InputText.stories.tsx b/src/components/Input/InputText/InputText.stories.tsx
index fef957ab..1254c30e 100644
--- a/src/components/Input/InputText/InputText.stories.tsx
+++ b/src/components/Input/InputText/InputText.stories.tsx
@@ -14,7 +14,7 @@ import { InputText, type InputTextProps } from './InputText'
 type StoryArgs = InputLabelStoryArgs<InputTextProps>
 
 const meta = {
-  title: 'Input/InputText',
+  title: 'Form Input/InputText',
   tags: ['version:2.0', 'design:pending'],
   component: InputText,
   args: {
diff --git a/src/components/Input/InputText/InputTextMasked.stories.tsx b/src/components/Input/InputText/InputTextMasked.stories.tsx
index 939368a4..09b31436 100644
--- a/src/components/Input/InputText/InputTextMasked.stories.tsx
+++ b/src/components/Input/InputText/InputTextMasked.stories.tsx
@@ -74,7 +74,7 @@ const MaskedControl = ({
 
 const meta = {
   ...inputTextMeta,
-  title: 'Input/Input Text With Mask',
+  title: 'Form Input/Input Text With Mask',
   tags: ['version:2.0', 'design:pending'],
   args: {
     ...inputTextMeta.args,
diff --git a/src/components/Input/Password/Password.stories.tsx b/src/components/Input/Password/Password.stories.tsx
index 9aa5c32f..7b2eb248 100644
--- a/src/components/Input/Password/Password.stories.tsx
+++ b/src/components/Input/Password/Password.stories.tsx
@@ -23,7 +23,7 @@ type StoryArgs = InputLabelStoryArgs<PasswordProps> & {
 }
 
 const meta: InputStoryMeta<PasswordProps, StoryArgs> = {
-  title: 'Input/Password',
+  title: 'Form Input/Password',
   tags: ['version:2.0', 'design:pending'],
   component: Password,
   args: {
diff --git a/src/components/InputOtp/InputOtp.stories.tsx b/src/components/InputOtp/InputOtp.stories.tsx
index b0600197..df6362e2 100644
--- a/src/components/InputOtp/InputOtp.stories.tsx
+++ b/src/components/InputOtp/InputOtp.stories.tsx
@@ -14,7 +14,7 @@ const validateOtp = () =>
   })
 
 const meta: Meta<typeof InputOtp> = {
-  title: 'Form/InputOtp',
+  title: 'Form Input/InputOtp',
   component: InputOtp,
   args: { disabled: false, error: false, length: 4, value: '' },
   render: (args) => {
diff --git a/src/components/Rating/stories/Rating.stories.tsx b/src/components/Rating/stories/Rating.stories.tsx
index b4e626ba..f97fdd9d 100644
--- a/src/components/Rating/stories/Rating.stories.tsx
+++ b/src/components/Rating/stories/Rating.stories.tsx
@@ -5,7 +5,7 @@ import { useCallback } from 'react'
 import { Rating } from '../Rating'
 
 const meta: Meta<typeof Rating> = {
-  title: 'Rating/Rating',
+  title: 'Form Rating/Rating',
   args: { disabled: false, paddings: false, maxRating: 5 },
   argTypes: { rating: { control: 'number' } },
   parameters: {
diff --git a/src/components/Rating/stories/RatingClear.stories.ts b/src/components/Rating/stories/RatingClear.stories.ts
index 38ad86de..d98c1bbb 100644
--- a/src/components/Rating/stories/RatingClear.stories.ts
+++ b/src/components/Rating/stories/RatingClear.stories.ts
@@ -3,7 +3,7 @@ import type { Meta, StoryObj } from '@storybook/react'
 import { RatingClear } from '../RatingClear'
 
 const meta: Meta<typeof RatingClear> = {
-  title: 'Rating/RatingClear',
+  title: 'Form Rating/RatingClear',
   component: RatingClear,
   args: { disabled: false, paddings: false },
   argTypes: { onPress: { action: 'onPress' } },
diff --git a/src/components/Rating/stories/RatingItem.stories.ts b/src/components/Rating/stories/RatingItem.stories.ts
index 19e19bd7..8f20ebae 100644
--- a/src/components/Rating/stories/RatingItem.stories.ts
+++ b/src/components/Rating/stories/RatingItem.stories.ts
@@ -3,7 +3,7 @@ import type { Meta, StoryObj } from '@storybook/react'
 import { RatingItem } from '../RatingItem'
 
 const meta: Meta<typeof RatingItem> = {
-  title: 'Rating/RatingItem',
+  title: 'Form Rating/RatingItem',
   component: RatingItem,
   args: { checked: false, disabled: false, paddings: false },
   argTypes: { onPress: { action: 'onPress' } },

From ff2ed8145c994013a9069a9079589dc2f216b431 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:15:58 +0300
Subject: [PATCH 11/19] =?UTF-8?q?docs(storybook):=20=D0=BF=D0=B5=D1=80?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=B5=D1=81=D0=B5=D0=BD=D1=8B=20=D1=81=D1=82=D0=BE?=
 =?UTF-8?q?=D1=80=D0=B8=20=D1=83=D1=81=D1=82=D0=B0=D1=80=D0=B5=D0=B2=D1=88?=
 =?UTF-8?q?=D0=B8=D1=85=20=D0=BA=D0=BE=D0=BC=D0=BF=D0=BE=D0=BD=D0=B5=D0=BD?=
 =?UTF-8?q?=D1=82=D0=BE=D0=B2=20=D0=B2=20=D0=BE=D0=B1=D1=89=D0=B8=D0=B5=20?=
 =?UTF-8?q?=D0=B3=D1=80=D1=83=D0=BF=D0=BF=D1=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .storybook/preview.tsx                              | 2 +-
 src/components/Input/stories/InputGroup.stories.tsx | 4 ++--
 src/components/Input/stories/InputMask.stories.tsx  | 4 ++--
 src/components/Input/stories/InputText.stories.tsx  | 4 ++--
 src/components/InputSwitch/InputSwitch.stories.tsx  | 6 +++---
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/.storybook/preview.tsx b/.storybook/preview.tsx
index 2a697340..5443cfe4 100644
--- a/.storybook/preview.tsx
+++ b/.storybook/preview.tsx
@@ -35,7 +35,7 @@ const preview: Preview = {
       storySort: {
         method: 'alphabetical',
         includeNames: true,
-        order: ['*', 'Typography', ['Overview', '*'], 'Legacy'],
+        order: ['*', 'Typography', ['Overview', '*']],
       },
     },
     actions: { argTypesRegex: '^on[A-Z].*' },
diff --git a/src/components/Input/stories/InputGroup.stories.tsx b/src/components/Input/stories/InputGroup.stories.tsx
index a05e66a7..d8338096 100644
--- a/src/components/Input/stories/InputGroup.stories.tsx
+++ b/src/components/Input/stories/InputGroup.stories.tsx
@@ -6,7 +6,7 @@ import { useCallback } from 'react'
 import { LegacyInputGroup as InputGroup } from '../deprecated/LegacyInputGroup'
 
 const meta: Meta<typeof InputGroup> = {
-  title: 'Legacy/InputGroup',
+  title: 'Form Input/LegacyInputGroup',
   tags: ['deprecated'],
   args: {
     clearable: true,
@@ -54,4 +54,4 @@ const InputGroupStory: Story = {
   },
 }
 
-export { InputGroupStory as InputGroup }
+export { InputGroupStory as LegacyInputGroup }
diff --git a/src/components/Input/stories/InputMask.stories.tsx b/src/components/Input/stories/InputMask.stories.tsx
index b87a14cf..cf772b3f 100644
--- a/src/components/Input/stories/InputMask.stories.tsx
+++ b/src/components/Input/stories/InputMask.stories.tsx
@@ -73,7 +73,7 @@ const MaskedInput = <T extends InputTextProps>({
 }
 
 const meta: Meta<typeof MaskedInput> = {
-  title: 'Legacy/InputMask',
+  title: 'Form Input/LegacyInputMask',
   tags: ['deprecated'],
   args: {
     clearable: true,
@@ -121,4 +121,4 @@ type Story = StoryObj<typeof MaskedInput>
 
 const MaskedInputStory: Story = {}
 
-export { MaskedInputStory as InputMask }
+export { MaskedInputStory as LegacyInputMask }
diff --git a/src/components/Input/stories/InputText.stories.tsx b/src/components/Input/stories/InputText.stories.tsx
index 998e9b6b..c8b722d8 100644
--- a/src/components/Input/stories/InputText.stories.tsx
+++ b/src/components/Input/stories/InputText.stories.tsx
@@ -6,7 +6,7 @@ import type { InputTextBase } from '../deprecated/InputTextBase/InputTextBase'
 import { LegacyInputText as InputText } from '../deprecated/LegacyInputText'
 
 const meta: Meta<typeof InputText & typeof InputTextBase> = {
-  title: 'Legacy/InputText',
+  title: 'Form Input/LegacyInputText',
   tags: ['deprecated'],
   args: {
     clearable: true,
@@ -55,4 +55,4 @@ type Story = StoryObj<typeof InputText>
 
 const InputTextStory: Story = {}
 
-export { InputTextStory as InputText }
+export { InputTextStory as LegacyInputText }
diff --git a/src/components/InputSwitch/InputSwitch.stories.tsx b/src/components/InputSwitch/InputSwitch.stories.tsx
index 8f8d0f3a..3f9e7ac8 100644
--- a/src/components/InputSwitch/InputSwitch.stories.tsx
+++ b/src/components/InputSwitch/InputSwitch.stories.tsx
@@ -5,7 +5,7 @@ import { useCallback } from 'react'
 import { InputSwitch } from './InputSwitch'
 
 const meta: Meta<typeof InputSwitch> = {
-  title: 'Legacy/InputSwitch',
+  title: 'Form/LegacyInputSwitch',
   tags: ['deprecated'],
   component: InputSwitch,
   args: { disabled: false, danger: false, checked: false },
@@ -35,6 +35,6 @@ export default meta
 
 type Story = StoryObj<typeof InputSwitch>
 
-const InputSwitchStory: Story = { name: 'InputSwitch' }
+const InputSwitchStory: Story = { name: 'LegacyInputSwitch' }
 
-export { InputSwitchStory as InputSwitch }
+export { InputSwitchStory as LegacyInputSwitch }

From ab24c51d0325eebf0d0b6efdf85e72158148b357 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:27:21 +0300
Subject: [PATCH 12/19] =?UTF-8?q?fix(storybook):=20=D0=B8=D1=81=D0=BF?=
 =?UTF-8?q?=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=20=D1=80=D0=B5=D0=B3=D0=B8?=
 =?UTF-8?q?=D1=81=D1=82=D1=80=20=D0=BC=D0=B5=D1=82=D0=BA=D0=B8=20design=20?=
 =?UTF-8?q?pending?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .storybook/StorybookTags.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.storybook/StorybookTags.tsx b/.storybook/StorybookTags.tsx
index eb424b28..681ea1af 100644
--- a/.storybook/StorybookTags.tsx
+++ b/.storybook/StorybookTags.tsx
@@ -11,7 +11,7 @@ const tagDefinitions: Record<
 > = {
   deprecated: { label: 'deprecated', tone: 'warn' },
   'version:2.0': { label: '2.0', tone: 'info' },
-  'design:pending': { label: 'Design pending', tone: 'secondary' },
+  'design:pending': { label: 'design pending', tone: 'secondary' },
 }
 
 const StorybookTag = ({ tag }: { readonly tag: string }) => {

From 15ac6b115938ff1fe002a4076ac3af1b1026135f Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 16:54:34 +0300
Subject: [PATCH 13/19] =?UTF-8?q?fix(storybook):=20=D0=B8=D1=81=D0=BF?=
 =?UTF-8?q?=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B0=20=D0=BE=D1=87=D0=B8?=
 =?UTF-8?q?=D1=81=D1=82=D0=BA=D0=B0=20=D0=BF=D0=BE=D0=BB=D1=8F=20LegacyInp?=
 =?UTF-8?q?utMask?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/Input/stories/InputMask.stories.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/components/Input/stories/InputMask.stories.tsx b/src/components/Input/stories/InputMask.stories.tsx
index cf772b3f..8a976073 100644
--- a/src/components/Input/stories/InputMask.stories.tsx
+++ b/src/components/Input/stories/InputMask.stories.tsx
@@ -62,6 +62,7 @@ const MaskedInput = <T extends InputTextProps>({
           {...otherRenderTextInputProps}
           mask={mask}
           ref={inputRef as unknown as RefObject<MaskedTextInputRef>}
+          value={value}
           onChangeText={onChangeText}
         />
       )}

From 435b2fa9329c98c4d8c8f3203f46020bccd17667 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 17:37:14 +0300
Subject: [PATCH 14/19] =?UTF-8?q?feat(storybook):=20=D0=B4=D0=BE=D0=B1?=
 =?UTF-8?q?=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B0=20=D0=BC=D0=B5=D1=82=D0=BA?=
 =?UTF-8?q?=D0=B0=20=D0=B8=D1=81=D0=BA=D0=BB=D1=8E=D1=87=D0=B5=D0=BD=D0=B8?=
 =?UTF-8?q?=D1=8F=20=D0=B8=D0=B7=20=D0=B2=D0=B5=D1=80=D1=81=D0=B8=D0=B8=20?=
 =?UTF-8?q?2.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .storybook/StorybookTags.tsx                         | 1 +
 src/components/Accordion/Accordion.stories.tsx       | 1 +
 src/components/Chip/Chip.stories.ts                  | 1 +
 src/components/Divider/Divider.stories.tsx           | 1 +
 src/components/ProgressBar/ProgressBar.stories.ts    | 1 +
 src/components/Rating/stories/Rating.stories.tsx     | 1 +
 src/components/Rating/stories/RatingClear.stories.ts | 1 +
 src/components/Rating/stories/RatingItem.stories.ts  | 1 +
 src/components/Slider/Slider.stories.tsx             | 1 +
 src/components/Tabs/Tabs.stories.tsx                 | 6 +++++-
 10 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/.storybook/StorybookTags.tsx b/.storybook/StorybookTags.tsx
index 681ea1af..fdee9098 100644
--- a/.storybook/StorybookTags.tsx
+++ b/.storybook/StorybookTags.tsx
@@ -12,6 +12,7 @@ const tagDefinitions: Record<
   deprecated: { label: 'deprecated', tone: 'warn' },
   'version:2.0': { label: '2.0', tone: 'info' },
   'design:pending': { label: 'design pending', tone: 'secondary' },
+  'migration:excluded': { label: '× no migration', tone: 'danger' },
 }
 
 const StorybookTag = ({ tag }: { readonly tag: string }) => {
diff --git a/src/components/Accordion/Accordion.stories.tsx b/src/components/Accordion/Accordion.stories.tsx
index 773f2b6c..6b1f4b43 100644
--- a/src/components/Accordion/Accordion.stories.tsx
+++ b/src/components/Accordion/Accordion.stories.tsx
@@ -21,6 +21,7 @@ const Extras = {
 
 const meta: Meta<typeof Accordion> = {
   title: 'Panel/Accordion',
+  tags: ['migration:excluded'],
   component: Accordion,
   args: {
     title: 'Accordion',
diff --git a/src/components/Chip/Chip.stories.ts b/src/components/Chip/Chip.stories.ts
index bdd08b38..5c6d4e95 100644
--- a/src/components/Chip/Chip.stories.ts
+++ b/src/components/Chip/Chip.stories.ts
@@ -7,6 +7,7 @@ const icons = { IconCheck, IconUser, none: undefined }
 
 const meta: Meta<typeof Chip> = {
   title: 'Misc/Chip',
+  tags: ['migration:excluded'],
   component: Chip,
   args: {
     Icon: IconCheck,
diff --git a/src/components/Divider/Divider.stories.tsx b/src/components/Divider/Divider.stories.tsx
index 140d2217..de0fa824 100644
--- a/src/components/Divider/Divider.stories.tsx
+++ b/src/components/Divider/Divider.stories.tsx
@@ -9,6 +9,7 @@ const icons = { IconInfoCircle, IconCircleCheck, none: undefined }
 
 const meta: Meta<typeof Divider> = {
   title: 'Panel/Divider',
+  tags: ['migration:excluded'],
   component: Divider,
   decorators: (Story) => (
     <View style={{ height: 300 }}>
diff --git a/src/components/ProgressBar/ProgressBar.stories.ts b/src/components/ProgressBar/ProgressBar.stories.ts
index 0b8dd00f..ce5afe86 100644
--- a/src/components/ProgressBar/ProgressBar.stories.ts
+++ b/src/components/ProgressBar/ProgressBar.stories.ts
@@ -4,6 +4,7 @@ import { ProgressBar } from './ProgressBar'
 
 const meta: Meta<typeof ProgressBar> = {
   title: 'Misc/ProgressBar',
+  tags: ['migration:excluded'],
   component: ProgressBar,
   args: { showValue: false, value: 20, style: { height: 7 } },
   parameters: {
diff --git a/src/components/Rating/stories/Rating.stories.tsx b/src/components/Rating/stories/Rating.stories.tsx
index f97fdd9d..f7513578 100644
--- a/src/components/Rating/stories/Rating.stories.tsx
+++ b/src/components/Rating/stories/Rating.stories.tsx
@@ -6,6 +6,7 @@ import { Rating } from '../Rating'
 
 const meta: Meta<typeof Rating> = {
   title: 'Form Rating/Rating',
+  tags: ['migration:excluded'],
   args: { disabled: false, paddings: false, maxRating: 5 },
   argTypes: { rating: { control: 'number' } },
   parameters: {
diff --git a/src/components/Rating/stories/RatingClear.stories.ts b/src/components/Rating/stories/RatingClear.stories.ts
index d98c1bbb..9f0346c6 100644
--- a/src/components/Rating/stories/RatingClear.stories.ts
+++ b/src/components/Rating/stories/RatingClear.stories.ts
@@ -4,6 +4,7 @@ import { RatingClear } from '../RatingClear'
 
 const meta: Meta<typeof RatingClear> = {
   title: 'Form Rating/RatingClear',
+  tags: ['migration:excluded'],
   component: RatingClear,
   args: { disabled: false, paddings: false },
   argTypes: { onPress: { action: 'onPress' } },
diff --git a/src/components/Rating/stories/RatingItem.stories.ts b/src/components/Rating/stories/RatingItem.stories.ts
index 8f20ebae..15e52f98 100644
--- a/src/components/Rating/stories/RatingItem.stories.ts
+++ b/src/components/Rating/stories/RatingItem.stories.ts
@@ -4,6 +4,7 @@ import { RatingItem } from '../RatingItem'
 
 const meta: Meta<typeof RatingItem> = {
   title: 'Form Rating/RatingItem',
+  tags: ['migration:excluded'],
   component: RatingItem,
   args: { checked: false, disabled: false, paddings: false },
   argTypes: { onPress: { action: 'onPress' } },
diff --git a/src/components/Slider/Slider.stories.tsx b/src/components/Slider/Slider.stories.tsx
index acabcb08..38ed163e 100644
--- a/src/components/Slider/Slider.stories.tsx
+++ b/src/components/Slider/Slider.stories.tsx
@@ -8,6 +8,7 @@ import { Slider, type SliderProps } from './Slider'
 
 const meta: Meta<typeof Slider> = {
   title: 'Form/Slider',
+  tags: ['migration:excluded'],
   component: Slider,
   args: { disabled: false },
   render: (args) => Template(args),
diff --git a/src/components/Tabs/Tabs.stories.tsx b/src/components/Tabs/Tabs.stories.tsx
index a6497354..b156fab2 100644
--- a/src/components/Tabs/Tabs.stories.tsx
+++ b/src/components/Tabs/Tabs.stories.tsx
@@ -7,7 +7,11 @@ import { Badge } from '../Badge'
 
 import { Tabs, TabPanel } from '.'
 
-const meta: Meta<typeof Tabs> = { title: 'Panel/Tabs', component: Tabs }
+const meta: Meta<typeof Tabs> = {
+  title: 'Panel/Tabs',
+  tags: ['migration:excluded'],
+  component: Tabs,
+}
 export default meta
 
 type Story = StoryObj<typeof Tabs>

From 163b96dcb02183f0287b039e34fdd7abac0deceb Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 17:37:15 +0300
Subject: [PATCH 15/19] =?UTF-8?q?docs(storybook):=20=D0=BE=D1=82=D0=BC?=
 =?UTF-8?q?=D0=B5=D1=87=D0=B5=D0=BD=D1=8B=20=D1=83=D1=81=D1=82=D0=B0=D1=80?=
 =?UTF-8?q?=D0=B5=D0=B2=D1=88=D0=B8=D0=B5=20=D0=BA=D0=BE=D0=BC=D0=BF=D0=BE?=
 =?UTF-8?q?=D0=BD=D0=B5=D0=BD=D1=82=D1=8B=20=D0=BC=D0=B5=D0=BD=D1=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/List/Base/ListBase.stories.tsx                 | 1 +
 src/components/MenuItem/Template/MenuItemTemplate.stories.tsx | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/components/List/Base/ListBase.stories.tsx b/src/components/List/Base/ListBase.stories.tsx
index d05d3702..f20f832f 100644
--- a/src/components/List/Base/ListBase.stories.tsx
+++ b/src/components/List/Base/ListBase.stories.tsx
@@ -18,6 +18,7 @@ const Extras = {
 
 const meta: Meta<typeof ListBase> = {
   title: 'Menu/List',
+  tags: ['deprecated'],
   component: ListBase,
   args: {
     iconAlignment: 'top',
diff --git a/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx b/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx
index b0411704..02ed8b2b 100644
--- a/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx
+++ b/src/components/MenuItem/Template/MenuItemTemplate.stories.tsx
@@ -19,6 +19,7 @@ const Extras = {
 
 const meta: Meta<typeof MenuItemTemplate> = {
   title: 'Menu/MenuItemTemplate',
+  tags: ['deprecated'],
   component: MenuItemTemplate,
   args: {
     title: 'Menu Item',

From 1854e61707190622b4bdb8a6f1393b9e822031bf Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Tue, 27 Oct 2026 17:37:16 +0300
Subject: [PATCH 16/19] =?UTF-8?q?docs(storybook):=20=D0=BE=D1=82=D0=BC?=
 =?UTF-8?q?=D0=B5=D1=87=D0=B5=D0=BD=D1=8B=20=D0=BA=D0=BE=D0=BC=D0=BF=D0=BE?=
 =?UTF-8?q?=D0=BD=D0=B5=D0=BD=D1=82=D1=8B=20=D0=B4=D0=BB=D1=8F=20=D0=BF?=
 =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=BA=D0=B8=20=D0=B4=D0=B8=D0=B7?=
 =?UTF-8?q?=D0=B0=D0=B9=D0=BD=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/InputOtp/InputOtp.stories.tsx         | 1 +
 src/components/SelectButton/SelectButton.stories.tsx | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/components/InputOtp/InputOtp.stories.tsx b/src/components/InputOtp/InputOtp.stories.tsx
index df6362e2..e22c02ec 100644
--- a/src/components/InputOtp/InputOtp.stories.tsx
+++ b/src/components/InputOtp/InputOtp.stories.tsx
@@ -15,6 +15,7 @@ const validateOtp = () =>
 
 const meta: Meta<typeof InputOtp> = {
   title: 'Form Input/InputOtp',
+  tags: ['design:pending'],
   component: InputOtp,
   args: { disabled: false, error: false, length: 4, value: '' },
   render: (args) => {
diff --git a/src/components/SelectButton/SelectButton.stories.tsx b/src/components/SelectButton/SelectButton.stories.tsx
index 5d736c08..e33f129b 100644
--- a/src/components/SelectButton/SelectButton.stories.tsx
+++ b/src/components/SelectButton/SelectButton.stories.tsx
@@ -40,6 +40,7 @@ const AnimatedExample = ({ buttons, ...props }: CommonProps) => {
 
 const meta: Meta<typeof SelectButton> = {
   title: 'Form/SelectButton',
+  tags: ['design:pending'],
   component: SelectButton,
   args: { buttons, size: 'base', disabled: false },
   argTypes: {

From 7494c346947d4a4c68fb0e0b6f18fb4efe883df7 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Wed, 28 Oct 2026 11:52:33 +0300
Subject: [PATCH 17/19] =?UTF-8?q?refactor(storybook):=20=D1=83=D0=BF=D1=80?=
 =?UTF-8?q?=D0=BE=D1=89=D1=91=D0=BD=20=D1=8D=D0=BA=D1=81=D0=BF=D0=BE=D1=80?=
 =?UTF-8?q?=D1=82=20=D1=81=D1=82=D0=BE=D1=80=D0=B8=20Dialog?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/Dialog/Dialog.stories.tsx | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/components/Dialog/Dialog.stories.tsx b/src/components/Dialog/Dialog.stories.tsx
index 7aa57952..3350abaf 100644
--- a/src/components/Dialog/Dialog.stories.tsx
+++ b/src/components/Dialog/Dialog.stories.tsx
@@ -7,7 +7,7 @@ import { StyleSheet } from 'react-native-unistyles'
 import { Button } from '../Button'
 import { Body } from '../Typography'
 
-import { Dialog, type DialogProps } from './Dialog'
+import { Dialog as DialogView, type DialogProps } from './Dialog'
 import { DialogComponent } from './DialogComponent'
 import { DialogHeader, type DialogHeaderProps } from './DialogHeader'
 
@@ -61,7 +61,7 @@ const DialogExample = ({
         />
       </View>
       <Button label='Показать модальный Dialog' onPress={showDialog} />
-      <Dialog
+      <DialogView
         body={DialogBody}
         footer={Footer}
         header={<DialogHeader {...headerProps} onClose={hideDialog} />}
@@ -75,7 +75,7 @@ const DialogExample = ({
 
 const meta: Meta<DialogStoryArgs> = {
   title: 'Overlay/Dialog',
-  component: Dialog,
+  component: DialogView,
   render: DialogExample,
   args: { severity: 'info', isVisible: false },
   argTypes: {
@@ -94,9 +94,7 @@ export default meta
 
 type Story = StoryObj<DialogStoryArgs>
 
-const DialogStory: Story = {}
-
-export { DialogStory as Dialog }
+export const Dialog: Story = {}
 
 const styles = StyleSheet.create(({ components, semantic }) => ({
   container: { gap: 16 },

From 27127ce6d05ed911918575a3e39c42a768371f9f Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Wed, 28 Oct 2026 13:01:10 +0300
Subject: [PATCH 18/19] =?UTF-8?q?chore(skills):=20=D0=BE=D0=B1=D0=BD=D0=BE?=
 =?UTF-8?q?=D0=B2=D0=BB=D0=B5=D0=BD=D1=8B=20=D0=BF=D1=80=D0=BE=D0=B5=D0=BA?=
 =?UTF-8?q?=D1=82=D0=BD=D1=8B=D0=B5=20=D0=BD=D0=B0=D0=B2=D1=8B=D0=BA=D0=B8?=
 =?UTF-8?q?=20=D0=B8=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=BA=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/scripts/check-skills.mjs              | 159 ++++++++++++++++++
 .agents/scripts/test-check-skills.mjs         |  88 ++++++++++
 .agents/skills/ui-kit-component-docs/SKILL.md |  56 ++++++
 .../ui-kit-component-docs/agents/openai.yaml  |   3 +
 .agents/skills/ui-kit-figma/SKILL.md          |  81 +++------
 .../ui-kit-figma/references/token-mapping.md  |  18 ++
 .agents/skills/ui-kit-review/SKILL.md         |  43 ++---
 .../references/mode-diff-review.md            |  22 +--
 .../references/review-checklist.md            |  27 +--
 .../references/ui-kit-project-rules.md        |  33 +---
 .../references/ui-kit-review-format.md        |   4 +-
 .../scripts/resolve-review-scope.sh           |  15 +-
 .../scripts/test-resolve-review-scope.sh      |  25 +++
 .agents/skills/ui-kit-storybook/SKILL.md      |  57 +++++++
 .../ui-kit-storybook/agents/openai.yaml       |   3 +
 .../references/device-verification.md         |  50 ++++++
 .agents/skills/ui-kit-testing/SKILL.md        |  34 +---
 .../references/mocks-and-native-ui.md         |   4 +-
 .../references/test-authoring.md              |  22 ++-
 AGENTS.md                                     |  23 ++-
 eslint.config.ts                              |   7 +-
 package.json                                  |   5 +-
 yarn.lock                                     |   3 +-
 23 files changed, 590 insertions(+), 192 deletions(-)
 create mode 100644 .agents/scripts/check-skills.mjs
 create mode 100644 .agents/scripts/test-check-skills.mjs
 create mode 100644 .agents/skills/ui-kit-component-docs/SKILL.md
 create mode 100644 .agents/skills/ui-kit-component-docs/agents/openai.yaml
 create mode 100644 .agents/skills/ui-kit-figma/references/token-mapping.md
 create mode 100644 .agents/skills/ui-kit-storybook/SKILL.md
 create mode 100644 .agents/skills/ui-kit-storybook/agents/openai.yaml
 create mode 100644 .agents/skills/ui-kit-storybook/references/device-verification.md

diff --git a/.agents/scripts/check-skills.mjs b/.agents/scripts/check-skills.mjs
new file mode 100644
index 00000000..3b4d476c
--- /dev/null
+++ b/.agents/scripts/check-skills.mjs
@@ -0,0 +1,159 @@
+import assert from 'node:assert/strict'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { dirname, join, relative, resolve, sep } from 'node:path'
+import process from 'node:process'
+import { pathToFileURL } from 'node:url'
+
+import { parse } from 'yaml'
+
+const read = (file) => readFileSync(file, 'utf8')
+
+const readMapping = (text) => {
+  const value = parse(text)
+  assert(
+    value && typeof value === 'object' && !Array.isArray(value),
+    'expected YAML mapping'
+  )
+
+  return value
+}
+
+const checkFrontmatter = (file, name) => {
+  const match = read(file).match(
+    /^---\r?\n(?<metadata>[\s\S]*?)\r?\n---(?:\r?\n|$)/u
+  )
+  assert(match, 'missing YAML frontmatter')
+  const metadata = readMapping(match.groups.metadata)
+  assert(
+    /^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(name) && name.length <= 64,
+    'invalid skill name'
+  )
+  assert.equal(metadata.name, name, 'name must match the skill directory')
+  assert(
+    typeof metadata.description === 'string' && metadata.description.trim(),
+    'missing description'
+  )
+}
+
+const checkManifest = (file, name) => {
+  const metadata = readMapping(read(file))
+
+  if (metadata.interface === undefined) return
+
+  const ui = metadata.interface
+  assert(
+    ui && typeof ui === 'object' && !Array.isArray(ui),
+    'invalid interface mapping'
+  )
+
+  for (const [key, value] of Object.entries(ui)) {
+    assert(
+      typeof value === 'string' && value.trim(),
+      `invalid interface.${key}`
+    )
+  }
+
+  if (ui.short_description !== undefined) {
+    assert(
+      ui.short_description.length >= 25 && ui.short_description.length <= 64,
+      'short_description must be 25–64 characters'
+    )
+  }
+
+  if (ui.default_prompt !== undefined) {
+    assert(
+      ui.default_prompt.includes(`$${name}`),
+      'default_prompt must mention its skill'
+    )
+  }
+}
+
+const checkLinks = (file, skillRoot) => {
+  const text = read(file).replace(
+    /^(?<fence>`{3,}|~{3,})[^\n]*\n[\s\S]*?^\k<fence>[ \t]*$/gmu,
+    ''
+  )
+
+  for (const {
+    groups: { target },
+  } of text.matchAll(/\[[^\]]*\]\((?<target>[^)]+)\)/gu)) {
+    const path = target.trim().replace(/^<|>$/gu, '')
+
+    if (!/^[a-z][a-z0-9+.-]*:/iu.test(path) && !path.startsWith('#')) {
+      assert(
+        existsSync(
+          resolve(dirname(file), decodeURIComponent(path.split('#')[0]))
+        ),
+        `missing link target: ${target}`
+      )
+    }
+  }
+
+  for (const {
+    groups: { target },
+  } of text.matchAll(/`(?<target>(?:references|scripts|assets)\/[^`\s]+)`/gu)) {
+    assert(existsSync(join(skillRoot, target)), `missing resource: ${target}`)
+  }
+}
+
+export const checkSkills = (repoRoot) => {
+  const errors = []
+  const check = (file, action) => {
+    try {
+      action()
+    } catch (error) {
+      errors.push(`${relative(repoRoot, file)}: ${error.message}`)
+    }
+  }
+  const skillsRoot = join(repoRoot, '.agents/skills')
+  const names = readdirSync(skillsRoot, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
+    .map((entry) => entry.name)
+
+  for (const name of names) {
+    const root = join(skillsRoot, name)
+    const entry = join(root, 'SKILL.md')
+    check(entry, () => checkFrontmatter(entry, name))
+    const manifest = join(root, 'agents/openai.yaml')
+
+    if (existsSync(manifest))
+      check(manifest, () => checkManifest(manifest, name))
+
+    const references = join(root, 'references')
+    const documents = existsSync(references)
+      ? readdirSync(references, { recursive: true })
+          .filter(
+            (path) =>
+              path.endsWith('.md') && !path.split(sep).includes('vendor')
+          )
+          .map((path) => join(references, path))
+      : []
+
+    for (const file of [entry, ...documents])
+      check(file, () => checkLinks(file, root))
+  }
+
+  const agents = join(repoRoot, 'AGENTS.md')
+  check(agents, () => {
+    for (const {
+      groups: { name },
+    } of read(agents).matchAll(/\$(?<name>[a-z][a-z0-9-]*)/gu)) {
+      assert(names.includes(name), `unknown project skill: ${name}`)
+    }
+  })
+
+  return errors
+}
+
+if (import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
+  const errors = checkSkills(resolve(import.meta.dirname, '../..'))
+
+  if (errors.length) {
+    console.error(errors.join('\n'))
+    process.exitCode = 1
+  } else {
+    console.log(
+      'Project skill metadata, links, and AGENTS.md routing are valid.'
+    )
+  }
+}
diff --git a/.agents/scripts/test-check-skills.mjs b/.agents/scripts/test-check-skills.mjs
new file mode 100644
index 00000000..6d9b75f7
--- /dev/null
+++ b/.agents/scripts/test-check-skills.mjs
@@ -0,0 +1,88 @@
+import assert from 'node:assert/strict'
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { test } from 'node:test'
+
+import { checkSkills } from './check-skills.mjs'
+
+const fixture = (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'ui-kit-skills-'))
+  context.after(() => rmSync(root, { recursive: true, force: true }))
+  const write = (path, text) => {
+    const file = join(root, path)
+    mkdirSync(dirname(file), { recursive: true })
+    writeFileSync(file, text)
+  }
+  write('AGENTS.md', 'Use $sample.\n')
+  write(
+    '.agents/skills/sample/SKILL.md',
+    '---\nname: sample\ndescription: Example skill\n---\n[Guide](references/guide.md)\n'
+  )
+  write('.agents/skills/sample/references/guide.md', '# Guide\n')
+  write(
+    '.agents/skills/sample/agents/openai.yaml',
+    'interface:\n  short_description: "Describe a valid example skill"\n  default_prompt: "Use $sample for this task."\n'
+  )
+
+  return { root, write }
+}
+
+test('accepts valid metadata, linked references, and project routing', (context) => {
+  const { root, write } = fixture(context)
+  write('.agents/skills/sample/vendor/copied/SKILL.md', 'not active metadata')
+  assert.deepEqual(checkSkills(root), [])
+})
+
+test('reports malformed YAML in entrypoints and manifests', (context) => {
+  const { root, write } = fixture(context)
+  write(
+    '.agents/skills/sample/SKILL.md',
+    '---\nname: sample\nname: duplicate\n---\n'
+  )
+  write('.agents/skills/sample/agents/openai.yaml', 'interface: [\n')
+  const errors = checkSkills(root)
+  assert.equal(errors.length, 2)
+  assert(
+    errors.some((error) => error.startsWith('.agents/skills/sample/SKILL.md:'))
+  )
+  assert(
+    errors.some((error) =>
+      error.startsWith('.agents/skills/sample/agents/openai.yaml:')
+    )
+  )
+})
+
+test('reports missing links and literal resources while ignoring examples and remote URLs', (context) => {
+  const { root, write } = fixture(context)
+  write(
+    '.agents/skills/sample/references/guide.md',
+    '[Remote](https://example.com)\n[Section](#section)\n```md\n[Example](placeholder.md)\n```\n[Missing](missing.md)\n'
+  )
+  let errors = checkSkills(root)
+  assert.equal(errors.length, 1)
+  assert.match(errors[0], /missing\.md/u)
+  write(
+    '.agents/skills/sample/references/guide.md',
+    'Run `scripts/missing.mjs`.\n'
+  )
+  errors = checkSkills(root)
+  assert.equal(errors.length, 1)
+  assert.match(errors[0], /scripts\/missing\.mjs/u)
+})
+
+test('reports a mismatched skill name, invalid prompt, and unresolved AGENTS routing', (context) => {
+  const { root, write } = fixture(context)
+  write(
+    '.agents/skills/sample/SKILL.md',
+    '---\nname: another\ndescription: Example skill\n---\n'
+  )
+  write(
+    '.agents/skills/sample/agents/openai.yaml',
+    'interface:\n  default_prompt: "Use $another."\n'
+  )
+  write('AGENTS.md', 'Use $missing.\n')
+  const errors = checkSkills(root)
+  assert.equal(errors.length, 3)
+  assert(errors.some((error) => error.startsWith('AGENTS.md:')))
+})
diff --git a/.agents/skills/ui-kit-component-docs/SKILL.md b/.agents/skills/ui-kit-component-docs/SKILL.md
new file mode 100644
index 00000000..3aea7052
--- /dev/null
+++ b/.agents/skills/ui-kit-component-docs/SKILL.md
@@ -0,0 +1,56 @@
+---
+name: ui-kit-component-docs
+description: >
+  Write or shorten Russian UI Kit component Markdown and public API JSDoc,
+  excluding task descriptions, migration reports, and release notes.
+---
+
+# Документация компонентов Prime UI Kit
+
+Сверь публичные props, экспорты, defaults, примеры и поведение с исходниками,
+тестами и Storybook. За образец бери актуальные Tag, Badge, Button или Input.
+Пример другой ветки читай через `git show`, не переключая рабочую область.
+
+## Markdown
+
+Создавай `<Component>.md` рядом с компонентом. Используй только нужные разделы:
+
+1. Название и одно предложение о назначении.
+2. `Использование` — минимальный пример с публичным импортом пакета.
+3. `Props` — сначала назначение собственного prop, затем существенные варианты,
+   defaults (включая встроенные иконки) и ограничения сочетаний. Добавь
+   относительную ссылку на публичный тип, для вложенного компонента — на его
+   тип.
+4. `Доступность` — как получается доступное имя, роли и ответственность
+   потребителя. Если разработчику нужно задать имя или учесть другой нюанс,
+   добавь короткую рекомендацию с условием её применения. При необходимости
+   поясни интерактивного родителя и масштаб шрифта.
+5. `Макет` — точная известная ссылка на компонент в Figma.
+
+Стандартные RN props не перечисляй, особое поведение объясняй по месту. Сначала
+опиши назначение prop, затем особенности a11y. `accessibilityLabel` описывай в
+доступности: различай автоматическое озвучивание компонента и добавление его
+смысла потребителем в доступное имя родителя.
+
+## JSDoc И Краткость
+
+Для изменяемого публичного компонента и его собственных props опиши назначение,
+смысл callback, controlled-поведение, defaults и существенные ограничения.
+Рекомендацию для потребителя повтори в JSDoc соответствующего prop или
+компонента, чтобы она была видна при использовании API в редакторе. Добавляй
+точную известную Figma-ссылку через `@see`. Для deprecated API укажи замену без
+неподтверждённого срока удаления.
+
+Пиши кратко по-русски, без повторов, внутренних функций, токенов, тестов и
+хронологии. Сохраняй подтверждённые ограничения: сокращение текста, условия
+label/caption, обязательную иконку и доступное имя для iconOnly. Не обещай
+непроверенные платформенные возможности.
+
+Совместимость и миграцию не включай в документацию компонента. Если запрошены,
+выдай отдельно в чате. README и ссылки из Storybook меняй только по запросу,
+сохраняя существующий формат.
+
+## Проверка
+
+Проверь относительные ссылки и точный Figma-узел. Запусти целевой Prettier и
+`git diff --check`; остальные проверки и отчёт — по `AGENTS.md`.
diff --git a/.agents/skills/ui-kit-component-docs/agents/openai.yaml b/.agents/skills/ui-kit-component-docs/agents/openai.yaml
new file mode 100644
index 00000000..64edf504
--- /dev/null
+++ b/.agents/skills/ui-kit-component-docs/agents/openai.yaml
@@ -0,0 +1,3 @@
+interface:
+  display_name: 'UI Kit Component Docs'
+  short_description: 'Write Russian component Markdown and API JSDoc'
diff --git a/.agents/skills/ui-kit-figma/SKILL.md b/.agents/skills/ui-kit-figma/SKILL.md
index 56709c71..a69528cf 100644
--- a/.agents/skills/ui-kit-figma/SKILL.md
+++ b/.agents/skills/ui-kit-figma/SKILL.md
@@ -1,83 +1,44 @@
 ---
 name: ui-kit-figma
 description: >
-  Implement or sync React Native Prime UI Kit components from Figma
-  specifications. Use when a Figma node is provided, or when component variants,
-  local theme-token bindings, documentation links, or Storybook states must be
-  aligned with Figma. This is read-only toward Figma.
+  Implement or sync UI Kit components with Figma, map theme tokens, or update
+  exact design links. Read-only toward Figma.
 ---
 
 # UI Kit Figma
 
-Translate Figma component specifications into this repository's public API,
-Unistyles implementation, local tokens, tests, and Storybook conventions. Use
-the Figma design-to-code skill for tool workflow and `ui-kit-testing` when tests
-change.
+Choose component synchronization or links-only work. Use the Figma
+design-to-code skill before design-context calls. Both workflows use existing
+tokens; proposed token changes or regeneration require confirmation under
+`AGENTS.md`.
 
-## Workflow
+## Component Synchronization
 
 1. Inspect the component source, public types and barrels, nearest tests and
    stories, and relevant files under `src/theme/tokens`.
-2. Call Figma design context on the exact component or variant frame. If a page
-   or section returns sparse context, use metadata only to locate the inner
-   frame, then call design context on that frame.
+2. Read [token-mapping.md](references/token-mapping.md). Call Figma design
+   context on the exact component or variant frame. If a page or section returns
+   sparse context, use metadata only to locate the inner frame, then call design
+   context on that frame.
 3. Read variable definitions for the target frame and map each relevant Figma
    variable to the existing runtime theme path.
 4. Implement the smallest compatible source change, following the nearest
    component pattern and root `AGENTS.md`.
-5. Update focused behavioral tests and representative Storybook scenarios when
-   the public contract or material variants change.
+5. Use `ui-kit-testing` for changed behavior and `ui-kit-storybook` for affected
+   public scenarios, controls, and device verification. Compare rendered states
+   with the exact frame when visual alignment is in scope. Do not use static
+   style assertions to prove a Figma mapping.
 6. Update the component documentation link when its exact Figma frame is known.
 7. Run the verification required by root `AGENTS.md`.
 
-## Token Mapping
-
-- Treat Figma variable bindings as the source of token intent. Treat resolved
-  pixel and color values as inspection data, not values to copy into source.
-- Treat `design-tokens/input/tokens.json` as the latest immutable export from
-  the designer. Never edit it during component or Figma synchronization work.
-- Treat `src/theme/tokens/**` as immutable generated output. Never edit or
-  regenerate these files during component or Figma synchronization work.
-- Reuse tokens from `src/theme/tokens`; do not hardcode a resolved value when a
-  matching local token exists.
-- Prefer a component token when Figma explicitly binds the property to that
-  component variable. Use a semantic token only when the design intent is
-  semantic or no component binding exists.
-- If an exact Figma value has no matching existing token, do not hardcode it,
-  change token files, or silently substitute an approximate token. Report the
-  gap and explain which part cannot be matched exactly with the current tokens.
-- Apply severity, size, state, and theme bindings to every affected layer, not
-  only the outer container. Check text, background, border, icon, and shape
-  tokens independently.
-
-## Documentation Links
+## Links Only
 
 - Link a component to its exact Figma component or variant frame, not merely the
   file, page, or broad section containing it.
 - In a bulk link update, inventory the component documentation first. Update
   only confidently matched frames and keep unresolved components explicit.
-- Before a requested commit, report updated links first and unresolved links
-  second. Commit only when the user explicitly asks.
-
-## Storybook
-
-- Model independently meaningful usage scenarios and interactions. Use controls
-  for simple variant axes that do not need dedicated documentation.
-- Create separate stories or a composed comparison only when the scenario or
-  comparison itself adds documentation value. Do not impose a fixed number or
-  layout of stories per component.
-- Keep every story's props valid for discriminated unions. Do not expose a
-  control that can create an invalid prop combination.
-- Hide non-editable or internally composed props with
-  `parameters.controls.exclude`. Do not use `control: false` with React Native
-  on-device controls because it renders as `Invalid type`.
-- Prefer `.tsx` when a story needs JSX composition. If an existing `.ts` file
-  must remain `.ts`, use `createElement` and construct typed discriminated props
-  before passing them to the component.
-
-## Tests
-
-Use `ui-kit-testing`. Assert rendered data, interaction logic, callbacks,
-controlled behavior, accessibility, and public contracts. Do not assert exact
-theme-token values, dimensions, colors, or style objects to prove a Figma
-mapping.
+- Use supplied exact links directly; inspect Figma metadata to resolve missing
+  frames. Fetch design context only if metadata cannot establish the match.
+- Skip token mapping, implementation, tests, and story changes unless requested.
+  Validate links and document formatting; report updated and unresolved links
+  separately, including before a requested commit.
diff --git a/.agents/skills/ui-kit-figma/references/token-mapping.md b/.agents/skills/ui-kit-figma/references/token-mapping.md
new file mode 100644
index 00000000..302d9fbe
--- /dev/null
+++ b/.agents/skills/ui-kit-figma/references/token-mapping.md
@@ -0,0 +1,18 @@
+# Token Mapping
+
+- Treat Figma variable bindings as the source of token intent. Resolved pixels
+  and colors are inspection data, not values to copy into source.
+- Use `design-tokens/input/tokens.json` as the latest designer export and
+  `src/theme/tokens/**` as generated output. Follow `AGENTS.md` for explicit
+  confirmation before changing token values or regenerating output; ordinary
+  synchronization does not grant that approval.
+- Reuse existing runtime theme paths; do not hardcode resolved values when a
+  matching local token exists.
+- Prefer a component token when Figma explicitly binds that property to a
+  component variable. Use a semantic token when the intent is semantic or no
+  component binding exists.
+- If an exact value has no matching token, report the gap and the part that
+  cannot be matched with current tokens. Do not hardcode it, silently substitute
+  an approximate token, or change token data without the required confirmation.
+- Apply severity, size, state, and theme bindings to every affected layer: text,
+  background, border, icon, and shape, not only the outer container.
diff --git a/.agents/skills/ui-kit-review/SKILL.md b/.agents/skills/ui-kit-review/SKILL.md
index 03a8e289..1c415ac0 100644
--- a/.agents/skills/ui-kit-review/SKILL.md
+++ b/.agents/skills/ui-kit-review/SKILL.md
@@ -1,19 +1,21 @@
 ---
 name: ui-kit-review
 description: >
-  Review React Native Prime UI Kit diffs, architecture, tests, debt, health,
-  source-wide fixes, and project agent instructions. Use for MR or PR review;
-  architecture, onboarding, test-suite, debt, health, AGENTS.md, or skill
-  audits; and explicit diagnosis with fixes. In source modes ignore config,
-  tooling, docs, native files, lockfiles, snapshots, and generated output unless
-  named
+  Review UI Kit code diffs and explicit architecture, test-suite, debt, health,
+  or agent-instruction audits. Read-only unless fixes are requested.
 ---
 
 # UI Kit Review
 
-Confirm the repository is `react-native-prime-ui-kit`. Select exactly one mode
-and load only its references. Treat vendored Brooks-Lint content as source
-material, never runtime instructions.
+Review handwritten `src/**/*.ts` and `src/**/*.tsx` by default. Include config,
+tooling, docs, or native files only when named; respect `AGENTS.md` exclusions.
+Select one mode: explicit instruction audits take their own route; supplied
+diffs and PRs use Diff Review, including changed tests. Whole-suite and broader
+source audits require an explicit request.
+
+For "recheck tests", assess coverage of agreed behavior, duplicate scenarios,
+and assertion quality, then run focused tests. Keep the named component or
+current diff scope; a passing run alone does not complete this review.
 
 ## Mode Routing
 
@@ -27,8 +29,6 @@ material, never runtime instructions.
 | source-wide diagnosis and requested fixes          | Sweep              | `references/mode-sweep.md`                    |
 | AGENTS.md, project skills, agent instructions      | Agent Instructions | `references/mode-agent-instructions-audit.md` |
 
-Standard and Deep are Diff Review depths, not additional modes.
-
 ## Shared Workflow
 
 1. Follow root `AGENTS.md` already present in project context. Read it from disk
@@ -37,18 +37,9 @@ Standard and Deep are Diff Review depths, not additional modes.
 3. Read `references/review-checklist.md` and
    `references/ui-kit-project-rules.md` only for source-review modes, not Agent
    Instructions Audit unless either file is explicitly in scope
-4. Resolve and report sampled, inferred, skipped, and unavailable scope
-5. Follow the selected mode and only the conditional sources it selects
-6. Verify findings against consumers, types, tests, history, or project
-   boundaries; drop threshold- or preference-only concerns
-
-## Guardrails
-
-- Do not edit, format, commit, push, or create patches unless the user requests
-  fixes or selects Sweep mode
-- Follow forbidden paths from `AGENTS.md`
-- Never compute a health score outside Health mode or write
-  `.brooks-lint-history.json`
-- Treat snapshots as generated; verify intent and focused tests without
-  line-reviewing snapshot content
-- Never load vendored skills or severity scales during normal execution
+4. Load only the selected mode's conditional references; report sampled,
+   inferred, skipped, and unavailable scope
+
+Review is read-only unless the user requests fixes. Assess snapshot intent
+through tests without line-reviewing generated snapshots. Health scores belong
+only to Health mode; do not write review history files.
diff --git a/.agents/skills/ui-kit-review/references/mode-diff-review.md b/.agents/skills/ui-kit-review/references/mode-diff-review.md
index cac358c2..5d066265 100644
--- a/.agents/skills/ui-kit-review/references/mode-diff-review.md
+++ b/.agents/skills/ui-kit-review/references/mode-diff-review.md
@@ -1,14 +1,13 @@
 # Diff Review Mode
 
 Use a supplied diff or file list. Otherwise run
-`scripts/resolve-review-scope.sh`; pass `--base <ref>` for another base,
-`--working-tree` for local-only review, or `--include-vendor` only when vendored
-sources are explicitly in scope. Ask for a diff or base when it reports
-`scope=none`.
-
-The default scope combines `origin/develop...HEAD` with tracked and untracked
-working-tree changes. Review handwritten `src/**/*.ts` and `src/**/*.tsx`; the
-script marks unsupported, generated, and vendored paths as skipped.
+`scripts/resolve-review-scope.sh --base <ref>` for branch changes plus the
+working tree, or `--working-tree` for explicitly local-only review. Establish
+the branch base from the request or PR metadata; do not guess from an upstream
+tracking branch. Ask one question if the base remains unknown. The resolver
+rejects a missing or unrelated base rather than silently narrowing the scope.
+When `scope=none`, report that no changes were found in the selected scope. Use
+`--include-vendor` only to review explicitly named vendored source as data.
 
 ## Depth
 
@@ -51,5 +50,8 @@ State the selected depth and signals in the review summary.
    - test duplication or mocks: `references/risk-test-duplication-mocks.md`
    - coverage or test architecture:
      `references/risk-test-coverage-architecture.md`
-3. Read `references/ui-kit-review-format.md` immediately before composing one
-   GitLab-ready comment
+3. Return concise findings with scope, depth, checks, and remaining verification
+   gaps. Preserve the shared Finding Contract without requiring four labelled
+   blocks per finding. When no findings exist, say so; do not claim merge
+   readiness without required checks. Read `references/ui-kit-review-format.md`
+   only when the user requests the expanded GitLab comment template.
diff --git a/.agents/skills/ui-kit-review/references/review-checklist.md b/.agents/skills/ui-kit-review/references/review-checklist.md
index ffb63a86..d141896d 100644
--- a/.agents/skills/ui-kit-review/references/review-checklist.md
+++ b/.agents/skills/ui-kit-review/references/review-checklist.md
@@ -1,26 +1,15 @@
 # UI Kit Review Checklist
 
-Use this checklist for changed source in diff review and for the explicitly
-named scope in specialized modes. Report a concern only when the reviewed scope
-contains evidence and the consequence is credible. Keep diff-review findings
-anchored to changed lines.
-
-## Review Pass
-
 1. Verify public props, exports, rendered states, callbacks, refs,
-   accessibility, cleanup, and integration with existing consumers
-2. Check change propagation: unrelated components should not require coordinated
-   edits and dependencies should follow library boundaries
-3. Check cognitive load: names, branching, state transitions, and module APIs
-   should remain understandable in local context
+   accessibility, cleanup, and consumers; flag unplanned API removals or changes
+2. Check change propagation, import direction, cycles, internal cross-component
+   imports, ownership, and public API leakage
+3. Check understandable local responsibilities, names, branches, and state
+   transitions; reject speculative abstractions and unused configurability
 4. Flag duplicated public rules or theme contracts, not harmless syntax
-5. Reject speculative abstractions, unused configurability, and wrappers that
-   add no useful boundary
-6. Check cycles, internal cross-component imports, misplaced ownership, and
-   public API distortion
-7. Check TypeScript boundaries for avoidable `any`, invalid representable
+5. Check TypeScript boundaries for avoidable `any`, invalid representable
    states, lost inference, and accidental contract narrowing
-8. Check tests only for changed behavior in diff review. Do not require tests
+6. Check tests only for changed behavior in diff review. Do not require tests
    for formatting, generated code, documentation, or story-only changes
-9. For changed tests, check avoidable mocks, implementation coupling, and
+7. For changed tests, check avoidable mocks, implementation coupling, and
    production APIs introduced only for tests
diff --git a/.agents/skills/ui-kit-review/references/ui-kit-project-rules.md b/.agents/skills/ui-kit-review/references/ui-kit-project-rules.md
index 19e45e29..9132f036 100644
--- a/.agents/skills/ui-kit-review/references/ui-kit-project-rules.md
+++ b/.agents/skills/ui-kit-review/references/ui-kit-project-rules.md
@@ -1,49 +1,28 @@
 # UI Kit Review Rules
 
-Use only for `react-native-prime-ui-kit`.
-
-## Source Precedence
-
 Resolve conflicts in this order: root `AGENTS.md`; current source and executable
 config; `package.json` and build declarations; `CONTRIBUTING.md`; migration or
 historical docs. Verify `MIGRATION.md` claims against current exports and
 config.
 
-## Public Contract
-
-- Flag unplanned removal, rename, or narrowing of public exports and props.
-- Preserve TypeScript inference and declarations; model mutually exclusive props
-  so invalid states cannot compile.
-
-## Themes And Unistyles
-
 - Do not recommend re-exporting Unistyles APIs unless intentionally changing the
   public contract; current production exports do not expose them.
 - Extract required primitives before worklets instead of capturing whole style
   objects, as enforced by `unistyles/no-unistyles-in-worklet`.
 - Check both themes when changed styles or tokens differ by theme.
-
-## React Native Behavior
-
-- Review press, disabled, loading, focus, accessibility, refs, and native prop
-  forwarding as public behavior.
 - Preserve consumer callbacks when internal handlers add state or animation.
-- Verify cleanup for timers, subscriptions, listeners, and animations.
 - Flag performance only for credible cost; never require memoization
   mechanically.
-
-## Tests And Stories
-
-Use the sibling `ui-kit-testing` skill for test details. Keep snapshots small
-and intentional. Require Storybook coverage for new public components and
-material visual variants, not internal refactors.
-
-## Dependencies And Build
-
 - Flag moves from peers to runtime dependencies that can duplicate frameworks or
   break host resolution.
 - Review runtime dependencies for bundle size, native linking, platforms, and
   peer-version impact.
 
+For test-policy questions, read only the relevant testing reference:
+[test-authoring.md](../../ui-kit-testing/references/test-authoring.md) for
+snapshots and static styles, or
+[timers-and-async.md](../../ui-kit-testing/references/timers-and-async.md) for
+animation checks. Existing snapshots alone are not a finding.
+
 Do not apply SuperApp-specific FSD, API, navigation, localization, image, or
 blanket memoization rules.
diff --git a/.agents/skills/ui-kit-review/references/ui-kit-review-format.md b/.agents/skills/ui-kit-review/references/ui-kit-review-format.md
index 2dd260d7..58390f77 100644
--- a/.agents/skills/ui-kit-review/references/ui-kit-review-format.md
+++ b/.agents/skills/ui-kit-review/references/ui-kit-review-format.md
@@ -1,7 +1,7 @@
 # UI Kit Review Format
 
-Return a diff review as one GitLab Markdown comment. Match the user's language;
-Russian is the default for a Russian request.
+Use this expanded diff-review template only when requested. Return one GitLab
+Markdown comment in the user's language.
 
 ## Rules
 
diff --git a/.agents/skills/ui-kit-review/scripts/resolve-review-scope.sh b/.agents/skills/ui-kit-review/scripts/resolve-review-scope.sh
index 76c80879..8546d0bd 100755
--- a/.agents/skills/ui-kit-review/scripts/resolve-review-scope.sh
+++ b/.agents/skills/ui-kit-review/scripts/resolve-review-scope.sh
@@ -3,7 +3,7 @@
 set -euo pipefail
 
 usage() {
-  echo "Usage: $0 [--base <git-ref> | --working-tree] [--include-vendor]" >&2
+  echo "Usage: $0 (--base <git-ref> | --working-tree) [--include-vendor]" >&2
   exit 2
 }
 
@@ -37,6 +37,11 @@ while [ "$#" -gt 0 ]; do
   esac
 done
 
+if [ -z "$base_ref" ] && [ "$working_tree_only" -eq 0 ]; then
+  echo 'error=scope-required use=--base-or--working-tree' >&2
+  exit 1
+fi
+
 repo_root="$(git rev-parse --show-toplevel)"
 cd "$repo_root"
 
@@ -68,14 +73,6 @@ if [ -n "$base_ref" ]; then
   branch_files="$(git -c core.quotepath=false diff --find-renames --name-only "$base_ref"...HEAD)"
   files="$(combine_files "$branch_files" "$local_files")"
   scope="base:$base_ref+working-tree"
-elif [ "$working_tree_only" -eq 1 ]; then
-  files="$local_files"
-  scope="working-tree"
-elif git rev-parse --verify origin/develop >/dev/null 2>&1 &&
-  git merge-base origin/develop HEAD >/dev/null 2>&1; then
-  branch_files="$(git -c core.quotepath=false diff --find-renames --name-only origin/develop...HEAD)"
-  files="$(combine_files "$branch_files" "$local_files")"
-  scope="base:origin/develop+working-tree"
 else
   files="$local_files"
   scope="working-tree"
diff --git a/.agents/skills/ui-kit-review/scripts/test-resolve-review-scope.sh b/.agents/skills/ui-kit-review/scripts/test-resolve-review-scope.sh
index de25e65a..5c28fca3 100755
--- a/.agents/skills/ui-kit-review/scripts/test-resolve-review-scope.sh
+++ b/.agents/skills/ui-kit-review/scripts/test-resolve-review-scope.sh
@@ -35,6 +35,7 @@ printf 'export const changed = 1\n' >"$fixture_root/src/Changed.ts"
 printf 'export const deleted = true\n' >"$fixture_root/src/Deleted.ts"
 git -C "$fixture_root" add src/Changed.ts src/Deleted.ts
 git -C "$fixture_root" commit --quiet -m 'test: initial fixture'
+base_ref="$(git -C "$fixture_root" rev-parse HEAD)"
 
 printf 'export const changed = 2\n' >"$fixture_root/src/Changed.ts"
 git -C "$fixture_root" add src/Changed.ts
@@ -58,4 +59,28 @@ if missing_base_output="$(cd "$fixture_root" && "$resolver" --base missing-base
 fi
 assert_line "$missing_base_output" 'error=missing-base-ref value=missing-base'
 
+empty_tree="$(git -C "$fixture_root" mktree </dev/null)"
+unrelated_base="$(printf 'unrelated fixture\n' | git -C "$fixture_root" commit-tree "$empty_tree")"
+git -C "$fixture_root" update-ref refs/remotes/origin/develop "$unrelated_base"
+
+if implicit_scope_output="$(cd "$fixture_root" && "$resolver" 2>&1)"; then
+  printf 'implicit scope unexpectedly succeeded\n' >&2
+  exit 1
+fi
+assert_line "$implicit_scope_output" 'error=scope-required use=--base-or--working-tree'
+
+if unrelated_base_output="$(cd "$fixture_root" && "$resolver" --base origin/develop 2>&1)"; then
+  printf 'unrelated base unexpectedly succeeded\n' >&2
+  exit 1
+fi
+assert_line "$unrelated_base_output" 'error=unrelated-base-ref value=origin/develop'
+
+git -C "$fixture_root" add -u
+git -C "$fixture_root" commit --quiet -m 'test: committed changes'
+branch_scope_output="$(cd "$fixture_root" && "$resolver" --base "$base_ref")"
+assert_line "$branch_scope_output" "scope=base:$base_ref+working-tree"
+assert_line "$branch_scope_output" $'file=changed\tsrc/Changed.ts'
+assert_line "$branch_scope_output" $'file=deleted\tsrc/Deleted.ts'
+assert_line "$branch_scope_output" $'file=untracked\tsrc/Untracked.ts'
+
 printf 'resolve-review-scope fixtures=ok\n'
diff --git a/.agents/skills/ui-kit-storybook/SKILL.md b/.agents/skills/ui-kit-storybook/SKILL.md
new file mode 100644
index 00000000..47706de8
--- /dev/null
+++ b/.agents/skills/ui-kit-storybook/SKILL.md
@@ -0,0 +1,57 @@
+---
+name: ui-kit-storybook
+description: >
+  Maintain UI Kit Storybook stories, controls, grouping, and status tags, or run
+  requested device checks.
+---
+
+# UI Kit Storybook
+
+Inspect the component's public types and nearby stories. Ordinary Storybook work
+does not require Figma access.
+
+## Scenarios And Controls
+
+- Default to one interactive story per public component unless the user asks for
+  additional stories. Expose variants, states, and optional content through
+  controls rather than separate named stories.
+- Keep props valid for discriminated unions throughout control changes,
+  including dependent required props.
+- For nodes, callbacks, and styles, use typed story-only controls and adapt them
+  in `render`. Keep these controls out of the public component API.
+- Model controlled interactions in consumer state or args, preserving callback
+  logging and useful actions such as restarting a timer.
+- Show dependent controls conditionally, following existing `argTypes.if` usage.
+  Group nested options with short prefixes such as `badge.text`; do not assume
+  web-only control grouping works in on-device Storybook.
+- Exclude non-editable or internally composed props through
+  `parameters.controls.exclude`; `control: false` renders as `Invalid type` in
+  this project's on-device controls.
+- Follow `AGENTS.md` for JSX and story extensions. Keep wrappers needed to
+  demonstrate real usage, without unrelated interactions.
+
+## Status And Cleanup
+
+- Remove obsolete duplicate stories and temporary QA matrices unless their
+  retention was requested.
+- Automatically include `deprecated` in story metadata when the component is
+  explicitly deprecated in its public API (`@deprecated`) or consumer docs.
+- For status-tag changes, inspect `.storybook/StorybookTags.tsx` and existing
+  metadata. Preserve confirmed tags. When creating story metadata without a
+  confirmed status, include `tags: []` as a place for the decision and remind
+  the developer in the task result to choose the status tag. Do not invent a
+  placeholder tag or infer design, release, or migration status from code,
+  neighbouring stories, or absence of usages.
+- Add README or documentation links when requested, preserving existing format.
+
+## Verification
+
+After adding, moving, or removing story files, run `yarn storybook-generate` and
+check registration for duplicates. Run the applicable checks from `AGENTS.md`;
+use `yarn tsc --noEmit` to check stories because `yarn build` excludes them.
+
+Smoke-test changed controls and interactions in the running Storybook when
+available. For requested device checks or visual changes, read
+[device-verification.md](references/device-verification.md) and choose its
+targeted or extended scope. Report unverified rendering separately from source
+and type checks.
diff --git a/.agents/skills/ui-kit-storybook/agents/openai.yaml b/.agents/skills/ui-kit-storybook/agents/openai.yaml
new file mode 100644
index 00000000..ac026944
--- /dev/null
+++ b/.agents/skills/ui-kit-storybook/agents/openai.yaml
@@ -0,0 +1,3 @@
+interface:
+  display_name: 'UI Kit Storybook'
+  short_description: 'Maintain stories, controls, and device checks'
diff --git a/.agents/skills/ui-kit-storybook/references/device-verification.md b/.agents/skills/ui-kit-storybook/references/device-verification.md
new file mode 100644
index 00000000..44595811
--- /dev/null
+++ b/.agents/skills/ui-kit-storybook/references/device-verification.md
@@ -0,0 +1,50 @@
+# Device Verification
+
+Use the available `agent-device` tools to inspect the running UI Kit Storybook.
+Record the platform, app/build, and story so results identify the implementation
+actually exercised.
+
+## Targeted Check
+
+For ordinary story, layout, typography, or theme changes, inspect affected
+states and interactions at the current system text size. Check the themes
+affected by the change. Do not run the extended matrix for metadata-only edits.
+
+For a new component or a visual change affecting text, state in the task result
+whether enlarged system text was checked. If it was not, flag this as remaining
+verification for the developer; do not block ordinary story work on it.
+
+## Extended Visual And Text-Scaling Check
+
+Use this scope for a requested full visual or accessibility review, an explicit
+text-scaling check, or a fix for font scaling or text clipping. Generic device
+checks and focused checks of accessible names, focus, or announcements keep
+their requested scope; mentioning accessibility alone does not trigger this
+matrix.
+
+- Check affected states in light and dark themes at 100% and 200% system text
+  size where supported. Keep the component's actual font-scaling props and
+  record the effective scale or native text-size category. If 200% cannot be
+  established, report the actual setting and leave that target unverified.
+- For inputs, check empty and populated values both blurred and focused,
+  including floating-label transitions. For text components, check
+  representative and long content under constrained width. Apply states
+  supported by the public API rather than all possible prop combinations.
+- Inspect text clipping, overlap with labels or icons, and readability. Check
+  wrapping or ellipsis against the public behavior. Compare normal scale with
+  the exact Figma frame when design alignment was requested and the frame is
+  available.
+
+## Reporting And Cleanup
+
+Inspect the rendered result after each transition. Restore system text size and
+theme settings afterward. Remove temporary stories unless they add a reusable
+scenario requested by the task.
+
+Report the cases actually viewed: platform/build, story and state, theme,
+scale/category, and observed result. Attach screenshots for failures when
+possible. Mark unavailable tools, builds, platforms, or states as unverified.
+These visual checks cover text scaling and layout; they do not establish that
+screen-reader names, focus, or announcements work. Report those only when
+separately exercised, and keep source or Jest evidence distinct from device
+results.
diff --git a/.agents/skills/ui-kit-testing/SKILL.md b/.agents/skills/ui-kit-testing/SKILL.md
index 31ef73ae..7ec93abd 100644
--- a/.agents/skills/ui-kit-testing/SKILL.md
+++ b/.agents/skills/ui-kit-testing/SKILL.md
@@ -1,47 +1,31 @@
 ---
 name: ui-kit-testing
 description: >
-  Write or refactor React Native Prime UI Kit Jest and RNTL tests for
-  components, hooks, controlled behavior, timers, animations, accessibility, and
-  public TypeScript contracts. Do not use for whole-suite audits
+  Write or refactor focused UI Kit Jest/RNTL tests and public type checks. Use
+  ui-kit-review for whole-suite audits.
 ---
 
 # UI Kit Testing
 
-Test observable behavior with the smallest environment that exercises the real
-public contract. Confirm the repository is `react-native-prime-ui-kit`, then
-inspect the implementation and nearest tests before choosing helpers or mocks.
+Choose cases from the public contract and inspect the implementation, nearest
+tests, and existing Jest setup before adding helpers, providers, or mocks.
 
 ## Workflow
 
-1. Search existing tests and Jest setup before adding a helper, mock, provider,
-   timer utility, or console suppression
-2. Load only the references required by the test:
-   - test cases, render helpers, selectors, accessibility, types, or naming:
-     `references/test-authoring.md`
+1. Read `references/test-authoring.md` for test-writing tasks; it owns assertion
+   boundaries, selectors, controlled props, public types, and naming
+2. Load additional references only as needed:
    - child, external, native, animated, or console mocks:
      `references/mocks-and-native-ui.md`
    - timers, debounce, animations, delayed updates, or manual promises:
      `references/timers-and-async.md`
-3. Add only providers and mocks required by the behavior under test. Prefer
-   public UI, props, callbacks, refs, and hook results over implementation
-   details
-4. If the user requests tests without cases, derive a concise behavioral set
+3. If the user requests tests without cases, derive a concise behavioral set
    from the public contract, state the cases and assumptions, and implement them
    directly. Ask one question only when an unresolved choice would change the
    public contract
-5. Before finishing, remove avoidable mocks, oversized helpers, redundant waits,
+4. Before finishing, remove avoidable mocks, oversized helpers, redundant waits,
    and assertions that do not prove the public contract
 
-## Assertion Boundaries
-
-- Assert rendered data, presence or absence, callbacks, controlled behavior,
-  accessibility, and public contracts
-- Do not assert exact colors, dimensions, theme-token values, or style objects
-- Do not add or update snapshots to verify component appearance or structure.
-  Replace affected visual snapshots with explicit behavioral assertions
-- Use the normal build to validate public TypeScript contracts and token access
-
 ## Verification
 
 Run focused Jest and the applicable build or lint checks from `AGENTS.md`.
diff --git a/.agents/skills/ui-kit-testing/references/mocks-and-native-ui.md b/.agents/skills/ui-kit-testing/references/mocks-and-native-ui.md
index 778aefda..821c759a 100644
--- a/.agents/skills/ui-kit-testing/references/mocks-and-native-ui.md
+++ b/.agents/skills/ui-kit-testing/references/mocks-and-native-ui.md
@@ -13,8 +13,8 @@ through it. For external UI components, rely on visible output, accessibility,
 internal props.
 
 Mock native or animated infrastructure only when Jest cannot execute the real
-implementation reliably. For Reanimated behavior, prefer the project Jest mock
-and assert public animated styles with `toHaveAnimatedStyle`.
+implementation reliably. For Reanimated behavior, prefer the project Jest mock;
+follow `references/timers-and-async.md` for observing animated progress.
 
 Suppress only identified third-party or test-environment noise with a narrow
 matcher. Never suppress application errors, unknown `act(...)` warnings, timer
diff --git a/.agents/skills/ui-kit-testing/references/test-authoring.md b/.agents/skills/ui-kit-testing/references/test-authoring.md
index 726bb857..40540807 100644
--- a/.agents/skills/ui-kit-testing/references/test-authoring.md
+++ b/.agents/skills/ui-kit-testing/references/test-authoring.md
@@ -1,8 +1,9 @@
 # Test Authoring
 
-Read this reference when creating or changing test cases, render helpers,
-selectors, accessibility assertions, public types, test names, or replacing
-snapshots with behavioral assertions.
+Assert public rendered data, presence or absence, callbacks, refs, hook results,
+controlled behavior, accessibility, and type contracts. Do not assert static
+colors, dimensions, theme-token values, or style objects to prove appearance.
+Time-dependent animated-style checks follow `references/timers-and-async.md`.
 
 ## Placement And Helpers
 
@@ -10,6 +11,18 @@ Place component tests in `src/components/<Component>/__tests__/`. Keep helpers
 local until more than one suite shares the setup. Create the smallest useful
 render helper and add only providers required by the subject or behavior.
 
+When extending a component, run its existing focused tests first. Choose new
+cases from agreed requirements and consumer documentation; use implementation to
+exercise that contract without inventing additional guarantees. Remove obsolete
+cases for intentionally removed behavior, while preserving coverage for
+still-public legacy contracts in scope.
+
+When both are tested, put ordinary behavior in `<Component>.test.tsx` and
+accessibility in `<Component>.accessibility.test.tsx`. Repeat an interaction in
+the accessibility suite only to prove a distinct accessibility contract, without
+duplicating ordinary assertions. Use a separate `.timers.test.tsx` or
+`.animation.test.tsx` when that behavior needs its own setup.
+
 Put default callbacks as `jest.fn()` inside the helper. Create named mocks only
 inside tests that assert them.
 
@@ -34,7 +47,8 @@ changing the UI. Rerender with the new prop before asserting the updated state.
 
 Keep compile-time assertions out of Jest. Use `@ts-expect-error` only in a
 dedicated CI type-test setup; otherwise validate public declarations through the
-normal build.
+normal build. Use that build for declaration and token-access checks; it does
+not execute compile-time examples placed in excluded Jest files.
 
 ## Snapshots
 
diff --git a/AGENTS.md b/AGENTS.md
index 2f3d317c..4a1562fe 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -18,8 +18,10 @@ source material, not runtime instructions.
   controlled behavior, accessibility, mocks, timers, animations, and public
   TypeScript contracts.
 - Use `$ui-kit-figma` to implement or sync components from Figma, map design
-  variables to local theme tokens, and align material variants and Storybook
-  scenarios.
+  variables to local theme tokens, and align material variants.
+- Use `$ui-kit-storybook` to create or update stories, controls, status tags,
+  and verify rendered component states on a device.
+- Use `$ui-kit-component-docs` for component Markdown and public API JSDoc.
 - Use `$ui-kit-review` for diffs and local changes or explicit architecture,
   onboarding, test-suite, debt, health, agent-instruction, and diagnostic
   audits. It is read-only unless the user requests fixes.
@@ -32,8 +34,19 @@ Do not load every skill preemptively; use the one matching the request.
   the proper barrels.
 - Use `StyleSheet.create` from `react-native-unistyles` and existing theme
   tokens. Do not spread or destructure generated Unistyles style objects.
+- Before changing token values in `design-tokens/**` or `src/theme/tokens/**`,
+  or running token generation, explain the proposed changes and get explicit
+  user confirmation unless that operation is already authorized. Component or
+  Figma synchronization alone does not authorize it. Do not hand-edit generated
+  output; read-only token checks may run normally.
 - Controlled interactions emit callbacks; rendered state changes only after the
   controlling prop changes.
+- Keep built-in accessibility labels and hints in the component or family's
+  internal `strings.ts`, reusing its existing dictionary and named constants.
+  Preserve supported consumer overrides and state-dependent action names.
+- Keep accessibility guidance advisory unless it is an agreed API requirement.
+  Put consumer reminders in component Markdown and relevant public JSDoc; do not
+  make optional props required merely to enforce a recommendation.
 - In new source and test files, use `UpperPascalCase` `testID` values. Existing
   IDs are compatibility-sensitive; do not flag or rename them only for format.
 - Story files containing JSX must use the `.stories.tsx` extension and JSX. Do
@@ -47,9 +60,9 @@ Do not load every skill preemptively; use the one matching the request.
 - Runtime TypeScript: `yarn build` and `yarn lint:check`.
 - Changed behavior or tests: also run focused Jest with
   `--runInBand --coverage=false`.
-- Documentation or agent instructions only: validate affected metadata and
-  references, run matching agent-script tests, then run targeted Prettier
-  checks; runtime checks are unnecessary.
+- Agent instructions: run `yarn skills:check`, `yarn skills:test`, and targeted
+  Prettier checks. Component documentation only: validate affected links and
+  examples, then run targeted Prettier. Runtime checks are unnecessary for both.
 - Report successful and unavailable checks before claiming completion.
 
 ## Git
diff --git a/eslint.config.ts b/eslint.config.ts
index 29583883..a52097ce 100644
--- a/eslint.config.ts
+++ b/eslint.config.ts
@@ -1,4 +1,5 @@
 import { defineConfig } from 'eslint/config'
+import { createNodeResolver } from 'eslint-plugin-import-x'
 
 import { MobileConfig } from './configs/eslint'
 
@@ -6,9 +7,13 @@ export default defineConfig([
   ...MobileConfig,
   { files: ['configs/eslint/**/*'], rules: { 'max-lines': 'off' } },
   {
-    files: ['scripts/**/*.ts'],
+    files: ['scripts/**/*.ts', '.agents/scripts/*.mjs'],
     rules: { 'import-x/no-nodejs-modules': 'off' },
   },
+  {
+    files: ['.agents/scripts/*.mjs'],
+    settings: { 'import-x/resolver-next': [createNodeResolver()] },
+  },
   {
     ignores: [
       'node_modules/**/*',
diff --git a/package.json b/package.json
index 6e41480f..9211b8e8 100644
--- a/package.json
+++ b/package.json
@@ -35,6 +35,8 @@
     }
   },
   "scripts": {
+    "skills:check": "node .agents/scripts/check-skills.mjs",
+    "skills:test": "node --test .agents/scripts/test-check-skills.mjs && bash .agents/skills/ui-kit-review/scripts/test-resolve-review-scope.sh",
     "build": "yarn tokens:typecheck && yarn tokens:check && rm -rf dist && tsc -p tsconfig.build.json",
     "test": "jest",
     "start": "expo start --dev-client --clear",
@@ -136,7 +138,8 @@
     "ts-node": "10.9.2",
     "typescript": "5.9.3",
     "typescript-eslint": "8.50.0",
-    "word-wrap": "1.2.5"
+    "word-wrap": "1.2.5",
+    "yaml": "2.8.2"
   },
   "peerDependencies": {
     "expo": ">=55.x.x",
diff --git a/yarn.lock b/yarn.lock
index f4758a53..26134574 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2896,6 +2896,7 @@ __metadata:
     typescript: "npm:5.9.3"
     typescript-eslint: "npm:8.50.0"
     word-wrap: "npm:1.2.5"
+    yaml: "npm:2.8.2"
   peerDependencies:
     expo: ">=55.x.x"
     react: ">=19.2"
@@ -19807,7 +19808,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"yaml@npm:^2.6.1":
+"yaml@npm:2.8.2, yaml@npm:^2.6.1":
   version: 2.8.2
   resolution: "yaml@npm:2.8.2"
   bin:

From 0cd982fd3a8003f704a81b3db36de60fa8583844 Mon Sep 17 00:00:00 2001
From: Alesya Volosach <alesya.volosach@gmail.com>
Date: Wed, 28 Oct 2026 14:08:45 +0300
Subject: [PATCH 19/19] =?UTF-8?q?chore(skills):=20=D1=80=D0=B0=D1=81=D1=88?=
 =?UTF-8?q?=D0=B8=D1=80=D0=B5=D0=BD=D1=8B=20=D0=BD=D0=B0=D0=B2=D1=8B=D0=BA?=
 =?UTF-8?q?=D0=B8=20API,=20Figma=20=D0=B8=20Storybook?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/skills/ui-kit-figma/SKILL.md          | 24 +++++--
 .../skills/ui-kit-figma/agents/openai.yaml    |  6 +-
 .agents/skills/ui-kit-public-api/SKILL.md     | 33 ++++++++++
 .../ui-kit-public-api/agents/openai.yaml      |  3 +
 .../references/contract-checklist.md          | 66 +++++++++++++++++++
 .agents/skills/ui-kit-storybook/SKILL.md      |  3 +
 .../references/controls-and-render.md         | 33 ++++++++++
 AGENTS.md                                     |  9 +++
 8 files changed, 167 insertions(+), 10 deletions(-)
 create mode 100644 .agents/skills/ui-kit-public-api/SKILL.md
 create mode 100644 .agents/skills/ui-kit-public-api/agents/openai.yaml
 create mode 100644 .agents/skills/ui-kit-public-api/references/contract-checklist.md
 create mode 100644 .agents/skills/ui-kit-storybook/references/controls-and-render.md

diff --git a/.agents/skills/ui-kit-figma/SKILL.md b/.agents/skills/ui-kit-figma/SKILL.md
index a69528cf..1e0f4184 100644
--- a/.agents/skills/ui-kit-figma/SKILL.md
+++ b/.agents/skills/ui-kit-figma/SKILL.md
@@ -1,16 +1,25 @@
 ---
 name: ui-kit-figma
 description: >
-  Implement or sync UI Kit components with Figma, map theme tokens, or update
-  exact design links. Read-only toward Figma.
+  Inspect Figma components, sync UI Kit implementations and theme-token
+  bindings, or update exact design links. Read-only toward Figma.
 ---
 
 # UI Kit Figma
 
-Choose component synchronization or links-only work. Use the Figma
-design-to-code skill before design-context calls. Both workflows use existing
-tokens; proposed token changes or regeneration require confirmation under
-`AGENTS.md`.
+Use the node and file/branch identity from the supplied link; do not substitute
+the current selection. Use the Figma design-to-code skill before design-context
+calls. Implementation uses existing tokens; token changes or regeneration
+require confirmation under `AGENTS.md`.
+
+## Inspect A Design
+
+For identification, description, or a screenshot, inspect the explicit node and
+use structural metadata as needed. Return the actual image when a screenshot is
+requested. Distinguish visible facts, metadata-backed properties, and behavioral
+inference; a static frame does not prove interaction behavior. Skip token
+mapping, implementation, tests, and story edits for inspection-only requests.
+Report unavailable evidence without inventing results.
 
 ## Component Synchronization
 
@@ -23,7 +32,8 @@ tokens; proposed token changes or regeneration require confirmation under
 3. Read variable definitions for the target frame and map each relevant Figma
    variable to the existing runtime theme path.
 4. Implement the smallest compatible source change, following the nearest
-   component pattern and root `AGENTS.md`.
+   component pattern and root `AGENTS.md`. Use `ui-kit-public-api` when the
+   public contract changes.
 5. Use `ui-kit-testing` for changed behavior and `ui-kit-storybook` for affected
    public scenarios, controls, and device verification. Compare rendered states
    with the exact frame when visual alignment is in scope. Do not use static
diff --git a/.agents/skills/ui-kit-figma/agents/openai.yaml b/.agents/skills/ui-kit-figma/agents/openai.yaml
index d5c000d2..c1d84eba 100644
--- a/.agents/skills/ui-kit-figma/agents/openai.yaml
+++ b/.agents/skills/ui-kit-figma/agents/openai.yaml
@@ -1,6 +1,6 @@
 interface:
   display_name: 'UI Kit Figma'
-  short_description: 'Sync UI Kit components from Figma tokens'
+  short_description: 'Inspect Figma designs and sync UI Kit components'
   default_prompt:
-    'Use $ui-kit-figma to implement or sync a UI Kit component from its Figma
-    specification.'
+    'Use $ui-kit-figma to inspect a design or sync a UI Kit component from its
+    Figma specification.'
diff --git a/.agents/skills/ui-kit-public-api/SKILL.md b/.agents/skills/ui-kit-public-api/SKILL.md
new file mode 100644
index 00000000..977eac2b
--- /dev/null
+++ b/.agents/skills/ui-kit-public-api/SKILL.md
@@ -0,0 +1,33 @@
+---
+name: ui-kit-public-api
+description: >
+  Define, change, or check a UI Kit component's public contract and migration.
+  Use ui-kit-review for general diffs and ui-kit-component-docs for prose-only
+  edits.
+---
+
+# UI Kit Public API
+
+Scope work to the requested component and affected consumers. Identify the
+repository through `package.json.name`, not a worktree directory name.
+Inspection and review requests are read-only; implementation follows the
+user-authorized scope and `AGENTS.md`.
+
+## Workflow
+
+1. Read [contract-checklist.md](references/contract-checklist.md). Inspect the
+   actual public boundary and record only affected aspects as **current → target
+   contract → consumers/verification**. Reuse a contract already settled in the
+   conversation rather than reopening it.
+2. Resolve the target from the request and current source. Ask one question only
+   if a remaining choice changes the contract. Migration follows the agreed
+   task; do not default to removing compatibility or editing other repositories.
+3. For implementation, use `ui-kit-testing` for changed behavior,
+   `ui-kit-storybook` for affected demonstrations, and `ui-kit-component-docs`
+   for public Markdown/JSDoc. Load only the skills matching the actual changes.
+4. Verify according to `AGENTS.md` and report the contract changes and remaining
+   gaps. For read-only review, report evidence, consequence, and scoped remedy;
+   missing documentation is a finding, not authorization to create it.
+
+General PR/diff review stays in `ui-kit-review`; add this focused workflow only
+when API alignment is specifically in scope.
diff --git a/.agents/skills/ui-kit-public-api/agents/openai.yaml b/.agents/skills/ui-kit-public-api/agents/openai.yaml
new file mode 100644
index 00000000..36da91de
--- /dev/null
+++ b/.agents/skills/ui-kit-public-api/agents/openai.yaml
@@ -0,0 +1,3 @@
+interface:
+  display_name: 'UI Kit Public API'
+  short_description: 'Define and review component API contracts'
diff --git a/.agents/skills/ui-kit-public-api/references/contract-checklist.md b/.agents/skills/ui-kit-public-api/references/contract-checklist.md
new file mode 100644
index 00000000..27049d4b
--- /dev/null
+++ b/.agents/skills/ui-kit-public-api/references/contract-checklist.md
@@ -0,0 +1,66 @@
+# Component Contract
+
+## Actual Public Boundary
+
+- Trace implementation, props/unions, component barrels, root exports, and
+  package subpaths. An internal export is not automatically public.
+- Inspect relevant callers, native props/events, refs, docs, stories, and tests.
+  Keep the inventory local to affected aspects rather than auditing the kit.
+- Use neighboring components as analogues, not authority to copy unrelated
+  props, defaults, icons, or accessibility policies.
+
+## Target And Migration
+
+Record changed names/types/defaults, valid prop combinations, value ownership,
+callback payloads, native boundaries, ref target/binding, and accessibility. For
+each affected aspect, identify its current and target contract, consumers, and
+how the change will be verified; unchanged aspects need no repeated table.
+
+- Preserve existing compatibility unless its removal is part of the agreed
+  scope. For an approved transition, name retained props/exports and precedence
+  at the public boundary; do not invent a removal version.
+- Preserve explicit `false`, `0`, and empty strings where supported; resolve
+  fallback precedence through definedness rather than truthiness.
+- Change consumers only within authorized repositories and paths. Disclose
+  unavailable consumers rather than claiming their migration is complete.
+- Reuse the closest wrapper/core/controller/style pattern. Separate `types.ts`,
+  `deprecated/`, `memo`, new primitives, and generic resolvers are not
+  mandatory.
+
+## State, Events, And Refs
+
+- Controlled interactions emit callbacks and wait for new props. Preserve an
+  existing uncontrolled path without making uncontrolled support mandatory.
+- Keep domain callbacks distinct from native events. Preserve accepted native
+  payloads; do not promise forwarding of excluded component-owned props.
+- Verify ref target, methods, and supported object/callback binding. Renaming a
+  public prop to `ref` does not itself rename a renderer's `inputRef` argument.
+- Respect actual ownership of native/accessibility state. Preserve unrelated
+  fields without letting native props contradict component-owned state.
+
+## Accessibility And Composition
+
+Identify the accessible node, name, role, state, hint, and decorative children.
+Check duplicate announcements and distinguish a standalone element from one
+inside an interactive parent. Visible labels, captions, badge values, and icons
+do not automatically establish accessible names or hints.
+
+Follow the agreed component policy for grouping and caption/hint behavior. Keep
+recommendations advisory and document consumer reminders according to
+`AGENTS.md`; do not strengthen optional props without an agreed requirement.
+
+## Evidence And Delivery
+
+- Select meaningful tests of changed contracts: transitions, state ownership,
+  callbacks, disabled/loading, composition, refs, and native boundaries as
+  applicable. Reuse `ui-kit-testing`; test-count growth is not a requirement.
+- Demonstrations must actually update controlled props and adapt story-only
+  controls or external adapters outside the runtime API.
+- Update affected component Markdown and public JSDoc in the same implementation
+  task. Update an existing family document when it already owns the component
+  rather than creating a duplicate. Use `ui-kit-component-docs` for format.
+- Token-value changes and regeneration require the confirmation in `AGENTS.md`.
+  Token JSON and Jest alone do not establish observed device geometry.
+- In read-only review, propose remedies without edits, formatting, generation,
+  or a mutating build. Report only checks actually exercised and state sampling
+  and unavailable evidence.
diff --git a/.agents/skills/ui-kit-storybook/SKILL.md b/.agents/skills/ui-kit-storybook/SKILL.md
index 47706de8..1fcf5ea0 100644
--- a/.agents/skills/ui-kit-storybook/SKILL.md
+++ b/.agents/skills/ui-kit-storybook/SKILL.md
@@ -12,6 +12,9 @@ does not require Figma access.
 
 ## Scenarios And Controls
 
+For controls replacing public prop types, composed nodes, or custom controlled
+handlers, read [controls-and-render.md](references/controls-and-render.md).
+
 - Default to one interactive story per public component unless the user asks for
   additional stories. Expose variants, states, and optional content through
   controls rather than separate named stories.
diff --git a/.agents/skills/ui-kit-storybook/references/controls-and-render.md b/.agents/skills/ui-kit-storybook/references/controls-and-render.md
new file mode 100644
index 00000000..9a0de907
--- /dev/null
+++ b/.agents/skills/ui-kit-storybook/references/controls-and-render.md
@@ -0,0 +1,33 @@
+# Typed Controls And Render
+
+## Types And Adapters
+
+- Use public prop types plus local `StoryArgs` for demo fields. When replacing a
+  prop type, remove it with `Omit` before adding the control type; do not create
+  an incompatible intersection or bypass errors with `any` or double casts.
+- Keep the real `component` in typed CSF metadata. Reuse a matching family's
+  existing typed helper when needed rather than adding a universal abstraction.
+- Map serializable preset keys to actual nodes, functions, or objects through
+  `mapping` or a typed lookup. Consume demo fields before spreading public props
+  into the component.
+- For independently editable nested-node properties, use flat typed fields and
+  construct the node in render. Dotted keys such as `badge.text` label panel
+  controls; they do not introduce nested runtime props.
+- Distinguish hiding an element from resetting its override to an internal
+  default. Use the API's actual absence or visibility mechanism; do not assume
+  `undefined` always hides the element or substitute an empty fake wrapper.
+
+## State, Actions, And Controls
+
+- Put initial values in `args`, not `argTypes.defaultValue`.
+- An args-controlled playground updates its controlling argument through
+  `useArgs`/`updateArgs`. Custom handlers must also call the original callback
+  with its full payload so Actions keep working; do not impose one callback
+  ordering across unrelated contracts.
+- Local consumer state is valid for a real integration setup. Synchronize it
+  with Controls where they govern the same value; hide inherited controls that
+  the render does not consume. Static comparisons need no artificial state.
+- When restricting `controls.include`, retain environment controls actually
+  provided by the checkout, such as its global `theme` control.
+- Keep callback Actions separate from editable Controls. Reuse existing labels
+  and the global actions regex; do not rename them only for uniformity.
diff --git a/AGENTS.md b/AGENTS.md
index 4a1562fe..e7391ab2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -17,6 +17,9 @@ source material, not runtime instructions.
 - Use `$ui-kit-testing` to write or refactor focused Jest/RNTL tests, including
   controlled behavior, accessibility, mocks, timers, animations, and public
   TypeScript contracts.
+- Use `$ui-kit-public-api` when defining, changing, or explicitly reviewing a
+  component's public contract and migration; use documentation skills for
+  prose-only edits.
 - Use `$ui-kit-figma` to implement or sync components from Figma, map design
   variables to local theme tokens, and align material variants.
 - Use `$ui-kit-storybook` to create or update stories, controls, status tags,
@@ -57,6 +60,12 @@ Do not load every skill preemptively; use the one matching the request.
 
 ## Verification
 
+- Before committing a new component or changes to its public contract, behavior,
+  accessibility, or material visual states, check affected docs, tests, and
+  stories against the planned commit. Existing accurate artifacts need no edits.
+  Reuse a completed check while the relevant diff is unchanged; otherwise
+  recheck only affected parts. Skip this dedicated check for formatting,
+  internal refactors, and metadata-only edits.
 - Runtime TypeScript: `yarn build` and `yarn lint:check`.
 - Changed behavior or tests: also run focused Jest with
   `--runInBand --coverage=false`.