import {Meta} from '@storybook/addon-docs/blocks'

<Meta title='@dxtmisha/ru/scripts/bin/dxt-figma-layout - Интеграция макетов Figma'/>

# dxt-figma-layout

Команда `dxt-figma-layout` предоставляет интерфейс командной строки (CLI) для получения структуры макетов и изображений компонентов напрямую из Figma. Под капотом она использует оркестратор `DesignFigma` и клиент `FigmaApi` для извлечения векторных SVG-ресурсов на основе переданных ключей файлов и идентификаторов узлов (Node ID).

> **Внимание**: Для выполнения этой команды и извлечения макетов строго требуется наличие корпоративной подписки Figma (Figma Enterprise или Organization).

## Ключевые возможности

- **Автоматическое получение изображений**: Извлекает векторные макеты из файлов Figma в чистом формате SVG.
- **Конфигурационная аутентификация**: Автоматически извлекает токен доступа Figma API из системных конфигураций.
- **Гибкая поддержка аргументов**: Позволяет динамически нацеливаться на конкретные файлы и узлы через параметры командной строки.

## Как это работает?

Процесс интеграции макетов автоматизирует извлечение ресурсов:

1. Скрипт считывает ключ файла Figma и необязательный идентификатор узла, переданные непосредственно в качестве аргументов командной строки.
2. Он инициализирует контроллер `DesignFigma`, передавая целевые параметры вместе с автоматически определенным системным токеном Figma.
3. Внутренний клиент `FigmaApi` отправляет безопасный HTTP-запрос к эндпоинту `fileImages` Figma, запрашивая узлы в формате SVG с сохранением исходных идентификаторов.
4. Он получает карту сопоставления изображений с URL-адресами сгенерированных ресурсов и выводит итоговый JSON-объект прямо в консоль.

## Настройка и запуск

Для работы интегратора макетов не требуется сложная предварительная настройка. Перед запуском убедитесь, что ваш API-токен Figma настроен в системной среде или файле конфигурации.

Чтобы получить изображения макетов, выполните команду, передав ключ файла Figma и идентификатор узла:
```bash
npx dxt-figma-layout [fileKey] [nodeId]
```

Пример:
```bash
npx dxt-figma-layout abc123xyz456 1-24
```

## Аргументы CLI

Команда принимает два позиционных параметра:

- `fileKey`: Уникальный идентификатор файла Figma (обычно находится в URL-адресе файла Figma).
- `nodeId`: Конкретный идентификатор узла внутри файла (например, `1-24` или `1:24`) для извлечения.
