В чём разница для команды-потребителя между подключением компонента как библиотеки и использованием готовой статики после деплоя?

Когда команда-потребитель подключает компонент как библиотеку, она добавляет его в свои зависимости и импортирует в исходном коде. Компонент становится частью сборки приложения: бандлер обрабатывает его вместе с остальным кодом, применяет tree-shaking, минификацию и типизацию. Это даёт сильную связанность на этапе компиляции, но требует согласования версий и пересборки при каждом обновлении.

Подключение как библиотеки

Потребитель устанавливает пакет и импортирует компонент напрямую. Все зависимости и версии фиксируются в lock-файле, что обеспечивает воспроизводимость сборки.

// package.json потребителя
// "@company/ui-button": "^2.3.0"

import { Button } from '@company/ui-button';

export function App() {
  return <Button onClick={() => alert('ok')}>Click</Button>;
}

Использование готовой статики

Компонент собирается отдельно и публикуется как статические файлы (JS, CSS) на CDN или отдельном домене. Потребитель подключает их через script-тег или динамический импорт по URL. Обновление компонента не требует пересборки потребителя, но версия не проверяется компилятором.

<script src="https://cdn.example.com/button/v2.3.0/button.js"></script>
<script>
  window.UIButton.mount('#root', { text: 'Click' });
</script>

Ключевые различия

• Сборка: библиотека собирается вместе с приложением, статика — отдельно.
• Версионирование: библиотека фиксируется в lock-файле, статика — по URL или конфигу.
• Обновление: библиотека требует пересборки и деплоя потребителя, статика обновляется независимо.
• Типизация: библиотека даёт типы и автодополнение, статика — нет.
• Изоляция: статика может конфликтовать по глобальным стилям и зависимостям, библиотека изолирована бандлером.

На практике библиотеку выбирают, когда важны типы, tree-shaking и контроль версий. Статику — когда нужна независимая доставка и обновление без участия потребителя, например в микрофронтендах.

Итог: библиотека подходит для тесной интеграции и строгого контроля версий, готовая статика — для независимого деплоя и динамического подключения компонентов.