Swap

#Что делает Swap

Swap перепривязывает переменные и стили с одного источника на другой без пересборки компонентов.

Типовые сценарии:

• миграция library -> local;
• миграция между локальными коллекциями/стилями;
• очистка после copy/paste из внешних файлов.

Swap не меняет main component инстанса. Для этого используйте Rebind.

#Два режима Swap

В Inspect есть два swap-потока.

#Режим A: Swap (инстансный)

1. Выберите инстанс, компонент или component set.
2. Откройте Inspect и нажмите Swap.
3. Проверьте найденные привязки в группах Variables и Styles.
4. Выберите target collection (для variables) и target styles.
5. При необходимости используйте Auto-match styles.
6. Выберите scope:
   • Single: только текущий инстанс;
   • All: все инстансы этого component key на странице.
7. Нажмите Apply Swap.

Поведение сохранения

Инстансный Swap сохраняет mapping в diff-id (saveSwapOverride) и регистрирует watcher. Это делает перепривязку устойчивой для следующих совпадающих изменений.

#Режим B: Swap libs & variables (двухколоночный)

1. В левом дереве Inspect нажмите Swap libs & variables.
2. Выберите тип данных: Variables или Styles.
3. Выберите scope: Page или Document.
4. Слева отметьте source bindings (локальные + внешние ссылки).
5. Справа выберите target library/current file candidates.
6. Проверьте auto-match и unmatched строки.
7. Нажмите Apply Swap.

Статусы в левой колонке

• ok: источник валиден и резолвится.
• ghost: источник принадлежит orphan local collection.
• error: source id не резолвится (применение блокируется до исправления).

Важное отличие от инстансного режима

Swap libs & variables применяет изменения сразу в выбранном scope, но не сохраняет persistent per-component swap override mapping.

#Что перепривязывается

• Variables, привязанные к свойствам узлов (fill, stroke, radius, spacing, typography и т.д.).
• Figma styles: paint, text, effect, grid.

#Рекомендуемый порядок с Ghost Heal

Если в файле есть ghost collections/modes или unresolved bindings:

1. Сначала запустите Ghost Heal.
2. Затем откройте Swap и примените mapping.

Это уменьшает количество красных/ghost строк и снижает риск работы со stale источниками.

#Ограничения

• Swap требует фичу TOKEN_SWAP.
• Качество auto-match зависит от стабильности имен и доступности target collections/styles.
• Видимость внешних библиотек зависит от прав в Figma и публикации assets.

#Связанные разделы

• Обзор Inspect
• Ghost Heal
• Rebind
• Export Variables и Styles