Standalone Bundle

Команда standalone позволяет создать автономную JavaScript-сборку, содержащую Intlayer и любые другие указанные пакеты. Это особенно полезно для использования Intlayer в средах без менеджера пакетов или сборщика, например, в простом приложении на HTML/JS.

Сборка использует esbuild для объединения запрошенных пакетов и их зависимостей в один файл, который можно легко импортировать в любой веб-проект.

Использование

npx intlayer standalone --packages [пакеты...] [опции]

Опции

• -o, --outfile [outfile] - Необязательно. Имя выходного файла. По умолчанию: intlayer-bundle.js.
• --packages [пакеты...] - Обязательно. Список пакетов для включения в сборку (например, intlayer, vanilla-intlayer).
• --version [version] - Необязательно. Версия пакетов для сборки. Если не указана, по умолчанию используется версия Intlayer CLI.
• --minify - Необязательно. Нужно ли минифицировать результат. По умолчанию: true.
• --platform [platform] - Необязательно. Целевая платформа для сборки (например, browser, node). По умолчанию: browser.
• --format [format] - Необязательно. Выходной формат для сборки (например, esm, cjs, iife). По умолчанию: esm.

Общие опции

• --env-file [envFile] - Файл окружения.
• -e, --env [env] - Окружение.
• --base-dir [baseDir] - Базовая директория.
• --no-cache - Отключить кэш.
• --verbose - Подробный вывод.

Примеры:

Создание сборки для Vanilla JS:

npx intlayer standalone --packages intlayer vanilla-intlayer --outfile intlayer.js

Это создаст файл intlayer.js, содержащий пакеты intlayer и vanilla-intlayer, минифицированный и в формате ESM, готовый к использованию в браузере через тег <script>.

Сборка конкретной версии:

npx intlayer standalone --packages intlayer --version 8.6.4

Сборка в другом формате:

npx intlayer standalone --packages intlayer --format iife

Что она делает:

1. Создает временную среду - Настраивает временную директорию для управления зависимостями.
2. Устанавливает пакеты - Использует npm или bun (если доступен) для установки запрошенных пакетов и их зависимостей.
3. Генерирует точку входа - Создает временный файл точки входа, который экспортирует все запрошенные пакеты и делает их доступными в виде глобальных переменных при запуске в браузере.
4. Собирает с помощью esbuild - Использует esbuild для объединения всего в один файл с применением минификации и форматирования в соответствии с запросом.
5. Генерирует файл - Записывает итоговую сборку по указанному пути вывода.

Глобальные переменные

Когда сборка загружается в браузере, она предоставляет запрошенные пакеты в виде глобальных переменных объекта window. Имена переменных производны от имен пакетов (например, intlayer становится Intlayer, vanilla-intlayer становится VanillaIntlayer).

// Доступ к Intlayer из сборкиconst { getLocaleName } = window.Intlayer;const { installIntlayer, useIntlayer } = window.VanillaIntlayer;