Автономна збірка (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;