Release/2.0.0 Обновление системы токенов

.agents/skills/ui-kit-figma/SKILL.md

@@ -0,0 +1,83 @@
+---
+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.
+---
+
+# 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.
+
+## Workflow
+
+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.
+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.
+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
+
+- 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.

.agents/skills/ui-kit-figma/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: 'UI Kit Figma'
+  short_description: 'Sync UI Kit components from Figma tokens'
+  default_prompt:
+    'Use $ui-kit-figma to implement or sync a UI Kit component from its Figma
+    specification.'

.agents/skills/ui-kit-testing/SKILL.md

@@ -2,9 +2,8 @@
 name: ui-kit-testing
 description: >
   Write or refactor React Native Prime UI Kit Jest and RNTL tests for
-  components, hooks, controlled behavior, timers, animations, snapshots,
-  accessibility, and public TypeScript contracts. Do not use for whole-suite
-  audits
+  components, hooks, controlled behavior, timers, animations, accessibility, and
+  public TypeScript contracts. Do not use for whole-suite audits
 ---
 
 # UI Kit Testing
@@ -18,8 +17,8 @@ inspect the implementation and nearest tests before choosing helpers or mocks.
 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, snapshots, types, or
-     naming: `references/test-authoring.md`
+   - test cases, render helpers, selectors, accessibility, types, or naming:
+     `references/test-authoring.md`
    - child, external, native, animated, or console mocks:
      `references/mocks-and-native-ui.md`
    - timers, debounce, animations, delayed updates, or manual promises:
@@ -34,6 +33,15 @@ inspect the implementation and nearest tests before choosing helpers or mocks.
 5. 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`.

.agents/skills/ui-kit-testing/references/test-authoring.md

@@ -1,7 +1,8 @@
 # Test Authoring
 
 Read this reference when creating or changing test cases, render helpers,
-selectors, accessibility assertions, snapshots, public types, or test names.
+selectors, accessibility assertions, public types, test names, or replacing
+snapshots with behavioral assertions.
 
 ## Placement And Helpers
 
@@ -37,7 +38,9 @@ normal build.
 
 ## Snapshots
 
-Snapshot only small, stable output whose complete structure is the behavior.
-Prefer explicit assertions for interaction, state, accessibility, layout, and
-animations. Update snapshots only for intentional UI changes. Do not snapshot
-mocked child trees, large style objects, or ordinary prop forwarding.
+Do not add or update snapshots for component appearance, structure, styles, or
+theme-token values. When a change invalidates a visual snapshot, replace it with
+explicit assertions for rendered data, presence or absence, interaction,
+controlled state, callbacks, or accessibility. Use a snapshot only when the user
+explicitly requests one and the contract cannot be stated more clearly with
+behavioral assertions.

.github/actions/typecheck/action.yml

@@ -1,5 +1,5 @@
-name: Run Typecheck
-description: Run typecheck
+name: Run Typechecks
+description: Typecheck the project and check generated tokens
 
 runs:
   using: composite
@@ -9,3 +9,11 @@ runs:
     - name: Run Typecheck
       shell: bash
       run: yarn tsc --noEmit
+
+    - name: Typecheck Token Generator
+      shell: bash
+      run: yarn tokens:typecheck
+
+    - name: Check Generated Tokens
+      shell: bash
+      run: yarn tokens:check

.prettierignore

@@ -6,3 +6,4 @@ android/app/.cxx
 android/app/build
 android/build
 CHANGELOG.md
+.storybook/storybook.requires.ts

.storybook/index.tsx

@@ -10,7 +10,7 @@ const StorybookUIRoot = view.getStorybookUI({
     typography: {
       size: {
         s1: 16,
-        s2: 20,
+        s2: 14,
         s3: 24,
         m1: 16,
         m2: 20,

.storybook/inputDocumentation.ts

@@ -0,0 +1,8 @@
+const documentationRoot =
+  'https://github.com/cdek-it/react-native-ui-kit/blob/main/src/components/Input'
+
+export const inputDocumentationNotes = {
+  InputGroup: `[Документация InputGroup](${documentationRoot}/InputGroup/InputGroup.md)`,
+  Password: `[Документация Password](${documentationRoot}/Password/Password.md)`,
+  InputCaption: `[Документация InputCaption](${documentationRoot}/InputCaption/InputCaption.md)`,
+}

.storybook/inputLabelControls.ts

@@ -0,0 +1,67 @@
+import type { Meta } from '@storybook/react'
+import { Alert } from 'react-native'
+
+import type {
+  InputLabelInfo,
+  InputLabelProps,
+} from '../src/components/Input/core/types'
+
+type InputLabelControls = {
+  labelMode: 'none' | 'label' | 'floatLabel'
+  labelText: string
+  labelInfo?: InputLabelInfo
+}
+
+export type InputLabelStoryArgs<Props> = Omit<
+  Props,
+  'label' | 'floatLabel' | 'labelInfo'
+> &
+  InputLabelControls
+
+export type InputStoryMeta<Props, Args> = Omit<Meta<Args>, 'component'> &
+  Pick<Meta<Props>, 'component'>
+
+export const inputLabelControls = {
+  labelMode: {
+    control: 'radio',
+    options: ['none', 'label', 'floatLabel'],
+    description:
+      'Режим примера: передать label, floatLabel или не передавать подпись. Не свойство компонента.',
+  },
+  labelText: {
+    control: 'text',
+    description: 'Текст для выбранного label или floatLabel в этом примере.',
+  },
+  labelInfo: {
+    control: 'select',
+    options: ['none', 'info'],
+    mapping: {
+      none: undefined,
+      info: {
+        onPress: () =>
+          Alert.alert(
+            'Подробнее',
+            'Пример справки, которую открывает приложение.'
+          ),
+      },
+    },
+    if: { arg: 'labelMode', eq: 'label' },
+    description:
+      'Кнопка ⓘ у обычного label. Обработчик примера открывает справку через Alert.',
+  },
+} as const
+
+export const getInputLabelProps = ({
+  labelMode,
+  labelText,
+  labelInfo,
+}: InputLabelControls): InputLabelProps => {
+  switch (labelMode) {
+    case 'label':
+      return { label: labelText, labelInfo }
+    case 'floatLabel':
+      return { floatLabel: labelText }
+    case 'none':
+      return {}
+  }
+}

.storybook/preview.tsx

@@ -31,6 +31,7 @@ const preview: Preview = {
     },
   ],
   parameters: {
+    options: { storySort: { method: 'alphabetical', includeNames: true } },
     actions: { argTypesRegex: '^on[A-Z].*' },
     controls: { matchers: { color: /(background|color)$/i, date: /Date$/ } },
   },

.storybook/storybook.requires.ts

@@ -1,56 +1,48 @@
 /* do not change this file, it is auto generated by storybook. */
 /// <reference types="@storybook/react-native/metro-env" />
-import { start, updateView, View, type Features } from '@storybook/react-native';
+import { start, updateView, View, type Features } from '@storybook/react-native'
 
-import "@storybook/addon-ondevice-notes/register";
-import "@storybook/addon-ondevice-controls/register";
-import "@storybook/addon-ondevice-actions/register";
+import '@storybook/addon-ondevice-notes/register'
+import '@storybook/addon-ondevice-controls/register'
+import '@storybook/addon-ondevice-actions/register'
 
 const normalizedStories = [
   {
-    titlePrefix: "",
-    directory: "./src",
-    files: "**/*.stories.?(ts|tsx|js|jsx)",
-    importPathMatcher: /^\.(?:(?:^|\/|(?:(?:(?!(?:^|\/)\.).)*?)\/)(?!\.)(?=.)[^/]*?\.stories\.(?:ts|tsx|js|jsx)?)$/,
+    titlePrefix: '',
+    directory: './src',
+    files: '**/*.stories.?(ts|tsx|js|jsx)',
+    importPathMatcher:
+      /^\.(?:(?:^|\/|(?:(?:(?!(?:^|\/)\.).)*?)\/)(?!\.)(?=.)[^/]*?\.stories\.(?:ts|tsx|js|jsx)?)$/,
     req: require.context(
       '../src',
       true,
       /^\.(?:(?:^|\/|(?:(?:(?!(?:^|\/)\.).)*?)\/)(?!\.)(?=.)[^/]*?\.stories\.(?:ts|tsx|js|jsx)?)$/
     ),
-  }
-];
-
+  },
+]
 
 declare global {
-  var view: View;
-  var STORIES: typeof normalizedStories;
+  var view: View
+  var STORIES: typeof normalizedStories
   var STORYBOOK_WEBSOCKET:
     | { host?: string; port?: number; secured?: boolean }
-    | undefined;
-  var FEATURES: Features;
+    | undefined
+  var FEATURES: Features
 }
 
-
 const annotations = [
   require('./preview'),
-  require("@storybook/react-native/preview")
-];
-
-globalThis.STORIES = normalizedStories;
-
-
-module?.hot?.accept?.();
+  require('@storybook/react-native/preview'),
+]
 
+globalThis.STORIES = normalizedStories
 
+module?.hot?.accept?.()
 
 if (!globalThis.view) {
-  globalThis.view = start({
-    annotations,
-    storyEntries: normalizedStories,
-
-  });
+  globalThis.view = start({ annotations, storyEntries: normalizedStories })
 } else {
-  updateView(globalThis.view, annotations, normalizedStories);
+  updateView(globalThis.view, annotations, normalizedStories)
 }
 
-export const view: View = globalThis.view;
+export const view: View = globalThis.view

AGENTS.md

@@ -15,8 +15,11 @@ Use only top-level skills under `.agents/skills/`; nested `vendor/` skills are
 source material, not runtime instructions.
 
 - Use `$ui-kit-testing` to write or refactor focused Jest/RNTL tests, including
-  controlled behavior, accessibility, mocks, timers, animations, snapshots, and
-  public TypeScript contracts.
+  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.
 - 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.
@@ -33,6 +36,9 @@ Do not load every skill preemptively; use the one matching the request.
   controlling prop changes.
 - 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
+  not use `createElement` to keep them as `.stories.ts`; reserve `.stories.ts`
+  for stories without JSX.
 - A new public component or material variant normally needs typed source, a
   barrel export, focused tests, and representative Storybook states.
 
@@ -49,7 +55,8 @@ Do not load every skill preemptively; use the one matching the request.
 ## Git
 
 Do not commit or push unless explicitly asked. Use Conventional Commits for
-requested commits.
+requested commits. Keep the conventional type and optional scope in English;
+write the commit subject in Russian.
 
 ## Safety