Автор:
    БозданиС:2026-01-21ПослСднСС обновлСниС:2026-01-21

    ДокумСнтация ΠΏΠ»Π°Π³ΠΈΠ½Π° intlayerPrune для Vite

    Плагин Vite intlayerPrune ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠ΅Ρ‚ΡΡ для tree-shake ΠΈ удалСния Π½Π΅ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠ΅ΠΌΡ‹Ρ… словарСй ΠΈΠ· Π±Π°Π½Π΄Π»Π° вашСго прилоТСния. Π­Ρ‚ΠΎ ΠΏΠΎΠΌΠΎΠ³Π°Π΅Ρ‚ ΡƒΠΌΠ΅Π½ΡŒΡˆΠΈΡ‚ΡŒ ΠΈΡ‚ΠΎΠ³ΠΎΠ²Ρ‹ΠΉ Ρ€Π°Π·ΠΌΠ΅Ρ€ Π±Π°Π½Π΄Π»Π°, Π²ΠΊΠ»ΡŽΡ‡Π°Ρ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ Π½Π΅ΠΎΠ±Ρ…ΠΎΠ΄ΠΈΠΌΠΎΠ΅ ΠΌΡƒΠ»ΡŒΡ‚ΠΈΡΠ·Ρ‹Ρ‡Π½ΠΎΠ΅ содСрТимоС.

    Плагин ΡƒΠΆΠ΅ Π²ΠΊΠ»ΡŽΡ‡Π΅Π½ ΠΈ автоматичСски настроСн ΠΏΡ€ΠΈ использовании intlayer(). Π’Π°ΠΌ Π½ΡƒΠΆΠ½ΠΎ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ Π·Π°Ρ€Π΅Π³ΠΈΡΡ‚Ρ€ΠΈΡ€ΠΎΠ²Π°Ρ‚ΡŒ Π΅Π³ΠΎ Π²Ρ€ΡƒΡ‡Π½ΡƒΡŽ, Ссли Π²Ρ‹ ΡΠ°ΠΌΠΎΡΡ‚ΠΎΡΡ‚Π΅Π»ΡŒΠ½ΠΎ составляСтС стСк ΠΏΠ»Π°Π³ΠΈΠ½ΠΎΠ².

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

    Enable pruning through your Intlayer config and the main plugin handles everything:

    ts
    // intlayer.config.ts
    import { defineConfig } from "intlayer";
    
    export default defineConfig({
      build: {
        optimize: true, // Π²ΠΊΠ»ΡŽΡ‡Π°Π΅Ρ‚ ΠΊΠ°ΠΊ ΠΏΡ€ΡƒΠ½ΠΈΠ½Π³, Ρ‚Π°ΠΊ ΠΈ ΠΌΠΈΠ½ΠΈΡ„ΠΈΠΊΠ°Ρ†ΠΈΡŽ
      },
    });
    
    ts
    // vite.config.ts
    import { defineConfig } from "vite";
    import { intlayer } from "vite-intlayer";
    
    export default defineConfig({
      plugins: [intlayer()],
    });
    

    Standalone

    Если Π²Ρ‹ составляСтС стСк ΠΏΠ»Π°Π³ΠΈΠ½ΠΎΠ² Π²Ρ€ΡƒΡ‡Π½ΡƒΡŽ, intlayerPrune ΠΈ intlayerMinify ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΡƒΡŽΡ‚ ΠΎΠ±ΡŠΠ΅ΠΊΡ‚ PruneContext, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π΄ΠΎΠ»ΠΆΠ΅Π½ Π±Ρ‹Ρ‚ΡŒ создан ΠΎΠ΄ΠΈΠ½ Ρ€Π°Π· ΠΈ ΠΏΠ΅Ρ€Π΅Π΄Π°Π½ ΠΎΠ±ΠΎΠΈΠΌ:

    ts
    // vite.config.ts
    import { defineConfig } from "vite";
    import { intlayerPrune, intlayerMinify } from "vite-intlayer";
    import { createPruneContext } from "@intlayer/babel";
    import { getConfiguration } from "@intlayer/config/node";
    
    const intlayerConfig = getConfiguration();
    const pruneContext = createPruneContext();
    
    export default defineConfig({
      plugins: [
        intlayerPrune(intlayerConfig, pruneContext),
        intlayerMinify(intlayerConfig, pruneContext), // ΠΎΠΏΡ†ΠΈΠΎΠ½Π°Π»ΡŒΠ½ΠΎ, Ρ‡ΠΈΡ‚Π°Π΅Ρ‚ ΠΈΠ· Ρ‚ΠΎΠ³ΠΎ ΠΆΠ΅ контСкста
      ],
    });
    

    Как это Ρ€Π°Π±ΠΎΡ‚Π°Π΅Ρ‚

    1. Анализ использования (buildStart)

    Π’ΠΎ врСмя buildStart ΠΏΠ»Π°Π³ΠΈΠ½ intlayerOptimize (Ρ‚Π°ΠΊΠΆΠ΅ Ρ‡Π°ΡΡ‚ΡŒ intlayer()) сканируСт ΠΊΠ°ΠΆΠ΄Ρ‹ΠΉ Ρ„Π°ΠΉΠ» исходного ΠΊΠΎΠ΄Π° ΠΊΠΎΠΌΠΏΠΎΠ½Π΅Π½Ρ‚Π°, ΡƒΠΊΠ°Π·Π°Π½Π½Ρ‹ΠΉ Π² build.filesList. Для ΠΊΠ°ΠΆΠ΄ΠΎΠ³ΠΎ Π²Ρ‹Π·ΠΎΠ²Π° useIntlayer('key') ΠΈΠ»ΠΈ getIntlayer('key') ΠΎΠ½ записываСт Ρ‚ΠΎΡ‡Π½ΠΎ, ΠΊΠ°ΠΊΠΈΠ΅ поля доступны, Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€:

    ts
    const { title, description } = useIntlayer("myDict");
    // записываСт: myDict β†’ { title, description }
    

    Π­Ρ‚ΠΎ создаСт pruneContext.fieldUsageMap ΠΏΠ΅Ρ€Π΅Π΄ Π²Ρ‹ΠΏΠΎΠ»Π½Π΅Π½ΠΈΠ΅ΠΌ Π»ΡŽΠ±Ρ‹Ρ… Π²Ρ‹Π·ΠΎΠ²ΠΎΠ² transform.

    2. JSON pruning (transform, enforce: 'pre')

    Когда Vite ΠΎΠ±Ρ€Π°Π±Π°Ρ‚Ρ‹Π²Π°Π΅Ρ‚ скомпилированный Ρ„Π°ΠΉΠ» JSON словаря, intlayerPrune ΠΏΠ΅Ρ€Π΅Ρ…Π²Π°Ρ‚Ρ‹Π²Π°Π΅Ρ‚ Π΅Π³ΠΎ ΠΏΠ΅Ρ€Π΅Π΄ встроСнным ΠΏΡ€Π΅ΠΎΠ±Ρ€Π°Π·ΠΎΠ²Π°Π½ΠΈΠ΅ΠΌ JSON β†’ ESM Π² Vite. Он Ρ‡ΠΈΡ‚Π°Π΅Ρ‚ ΠΊΠ°Ρ€Ρ‚Ρƒ использования ΠΏΠΎΠ»Π΅ΠΉ ΠΈΠ· pruneContext ΠΈ удаляСт любоС ΠΏΠΎΠ»Π΅ содСрТимого, ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠ΅ Π½Π΅ находится Π² записанном Π½Π°Π±ΠΎΡ€Π΅ использования.

    ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΈΠ²Π°ΡŽΡ‚ΡΡ Π΄Π²Π΅ Ρ„ΠΎΡ€ΠΌΡ‹ содСрТимого:

    • Static dictionaries: { nodeType: "translation", translation: { en: {...}, fr: {...} } }. Поля ΠΎΠ±Ρ€Π΅Π·Π°ΡŽΡ‚ΡΡ ΠΏΠΎ Π»ΠΎΠΊΠ°Π»ΠΈ Π²Π½ΡƒΡ‚Ρ€ΠΈ translation.
    • Dynamic (per-locale) dictionaries: плоская структура { fieldA: ..., fieldB: ... }. Поля ΠΎΠ±Ρ€Π΅Π·Π°ΡŽΡ‚ΡΡ Π½Π° Π²Π΅Ρ€Ρ…Π½Π΅ΠΌ ΡƒΡ€ΠΎΠ²Π½Π΅.

    3. Π“Ρ€Π°Π½ΠΈΡ‡Π½Ρ‹Π΅ случаи

    Если структура ΠΊΠΎΠ½Ρ‚Π΅Π½Ρ‚Π° словаря Π½Π΅ ΠΌΠΎΠΆΠ΅Ρ‚ Π±Ρ‹Ρ‚ΡŒ распознана (Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, нСобычная влоТСнная Ρ„ΠΎΡ€ΠΌΠ°), ΠΎΠ½Π° добавляСтся Π² pruneContext.dictionariesWithEdgeCases ΠΈ остаСтся Π±Π΅Π· ΠΈΠ·ΠΌΠ΅Π½Π΅Π½ΠΈΠΉ. ЗаписываСтся ΠΏΡ€Π΅Π΄ΡƒΠΏΡ€Π΅ΠΆΠ΄Π΅Π½ΠΈΠ΅. intlayerMinify Ρ‚Π°ΠΊΠΆΠ΅ пропускаСт эти словари.

    4. Field-rename map

    ΠŸΡ€ΠΈ ΡƒΡΠΏΠ΅ΡˆΠ½ΠΎΠΌ Π·Π°Π²Π΅Ρ€ΡˆΠ΅Π½ΠΈΠΈ pruning intlayerPrune Ρ‚Π°ΠΊΠΆΠ΅ записываСт pruneContext.dictionaryKeyToFieldRenameMap, ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ΅Π½ΠΈΠ΅ исходных ΠΈΠΌΠ΅Π½ ΠΏΠΎΠ»Π΅ΠΉ Π½Π° ΠΊΠΎΡ€ΠΎΡ‚ΠΊΠΈΠ΅ псСвдонимы. intlayerMinify Ρ‡ΠΈΡ‚Π°Π΅Ρ‚ эту ΠΊΠ°Ρ€Ρ‚Ρƒ для пСрСимСнования ΠΏΠΎΠ»Π΅ΠΉ Π² Π²Ρ‹Ρ…ΠΎΠ΄Π½ΠΎΠΌ JSON, Π° Babel rename pass intlayerOptimize обновляСт доступы ΠΊ свойствам Π² исходных Ρ„Π°ΠΉΠ»Π°Ρ… соотвСтствСнно.

    Условия Π°ΠΊΡ‚ΠΈΠ²Π°Ρ†ΠΈΠΈ

    intlayerPrune Π°ΠΊΡ‚ΠΈΠ²Π΅Π½ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ ΠΊΠΎΠ³Π΄Π° всС ΠΈΠ· ΡΠ»Π΅Π΄ΡƒΡŽΡ‰ΠΈΡ… условий Π²Π΅Ρ€Π½Ρ‹:

    1. Команда Vite, build.
    2. build.optimize ΠΈΠΌΠ΅Π΅Ρ‚ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ true (ΠΈΠ»ΠΈ undefined, Ρ‡Ρ‚ΠΎ ΠΏΠΎ ΡƒΠΌΠΎΠ»Ρ‡Π°Π½ΠΈΡŽ Ρ€Π°Π²Π½ΠΎ true для сборок).
    3. build.purge ΠΈΠΌΠ΅Π΅Ρ‚ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ true Π² вашСй ΠΊΠΎΠ½Ρ„ΠΈΠ³ΡƒΡ€Π°Ρ†ΠΈΠΈ Intlayer.

    Он остаётся Π°ΠΊΡ‚ΠΈΠ²Π½Ρ‹ΠΌ, ΠΊΠΎΠ³Π΄Π° editor.enabled ΠΈΠΌΠ΅Π΅Ρ‚ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ true: Π²ΠΈΠ·ΡƒΠ°Π»ΡŒΠ½Ρ‹ΠΉ Ρ€Π΅Π΄Π°ΠΊΡ‚ΠΎΡ€ Ρ€Π°Π·Ρ€Π΅ΡˆΠ°Π΅Ρ‚ ΠΊΠ°ΠΆΠ΄ΡƒΡŽ ΠΏΡ€Π°Π²ΠΊΡƒ Ρ‡Π΅Ρ€Π΅Π· dictionaryKey + keyPath ΠΎΡ‚Π½ΠΎΡΠΈΡ‚Π΅Π»ΡŒΠ½ΠΎ Π½Π΅ ΠΎΠ±ΡŠΠ΅Π΄ΠΈΠ½Ρ‘Π½Π½Ρ‹Ρ… словарСй, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹Ρ… этот ΠΏΠ»Π°Π³ΠΈΠ½ Π½ΠΈΠΊΠΎΠ³Π΄Π° Π½Π΅ касаСтся, Π° ΠΎΡ‡ΠΈΡ‰Π΅Π½Π½ΠΎΠ΅ ΠΏΠΎΠ»Π΅ это ΠΏΠΎΠ»Π΅, ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠ΅ Π½Π΅ Ρ‡ΠΈΡ‚Π°Π΅Ρ‚ Π½ΠΈ ΠΎΠ΄ΠΈΠ½ ΠΊΠΎΠΌΠΏΠΎΠ½Π΅Π½Ρ‚, поэтому ΠΎΠ½ΠΎ Π½ΠΈΠΊΠΎΠ³Π΄Π° Π½Π΅ отобраТаСтся ΠΈ Π½Π΅ ΠΌΠΎΠΆΠ΅Ρ‚ Π±Ρ‹Ρ‚ΡŒ Π²Ρ‹Π±Ρ€Π°Π½ΠΎ Π½Π° страницС.