Author:
    Creation:2026-06-25Last update:2026-06-25

    intlayerCompiler

    intlayerCompiler рдПрдХ Vite рдкреНрд▓рдЧрдЗрди рд╣реИ рдЬреЛ рдШрдЯрдХ рд╕реНрд░реЛрдд рдлрд╝рд╛рдЗрд▓реЛрдВ рдХреЛ рдЗрдирд▓рд╛рдЗрди Intlayer рд╕рд╛рдордЧреНрд░реА рдШреЛрд╖рдгрд╛рдУрдВ, рдПрдХ рдЕрд▓рдЧ .content.ts рдлрд╝рд╛рдЗрд▓ рдХреЗ рдмрдЬрд╛рдп рд╕реАрдзреЗ рдПрдХ рдШрдЯрдХ рдХреЗ рдЕрдВрджрд░ рдкрд░рд┐рднрд╛рд╖рд┐рдд рд╕рд╛рдордЧреНрд░реА, рдХреЗ рд▓рд┐рдП рд╕реНрдХреИрди рдХрд░рддрд╛ рд╣реИ рдФрд░ рдЙрдиреНрд╣реЗрдВ рдЯреНрд░рд╛рдВрд╕рдлрд╝реЙрд░реНрдо рдЪрд░рдг рдХреЗ рджреМрд░рд╛рди рд╢рдмреНрджрдХреЛрд╢ JSON рдлрд╝рд╛рдЗрд▓реЛрдВ рдореЗрдВ рд▓рд┐рдЦрддрд╛ рд╣реИред

    Intlayer v9 рд╕реЗ intlayerCompiler рд╕реНрд╡рдЪрд╛рд▓рд┐рдд рд░реВрдк рд╕реЗ рдореБрдЦреНрдп intlayer() рдкреНрд▓рдЧрдЗрди рдХреЗ рдЕрдВрджрд░ рд╢рд╛рдорд┐рд▓ рд╣реЛрддрд╛ рд╣реИ рдЬрдм рдЖрдкрдХреЗ Intlayer рдХреЙрдиреНрдлрд╝рд┐рдЧрд░реЗрд╢рди рдореЗрдВ compiler.enabled рджреЛрдиреЛрдВ true рдФрд░ compiler.output рд╕реЗрдЯ рд╣реЛрддреЗ рд╣реИрдВред рдЖрдкрдХреЛ рдЗрд╕реЗ рдЕрд▓рдЧ рд╕реЗ рдкрдВрдЬреАрдХреГрдд рдХрд░рдиреЗ рдХреА рдЖрд╡рд╢реНрдпрдХрддрд╛ рдХреЗрд╡рд▓ рддрдм рд╣реЛрддреА рд╣реИ рдЬрдм рдЖрдк рдХрдВрдкрд╛рдЗрд▓рд░-рд╡рд┐рд╢рд┐рд╖реНрдЯ рдХреЙрдиреНрдлрд╝рд┐рдЧрд░реЗрд╢рди рдкрд░ рдкреВрд░реНрдг рдирд┐рдпрдВрддреНрд░рдг рдЪрд╛рд╣рддреЗ рд╣реИрдВред

    рдЙрдкрдпреЛрдЧ

    intlayer() рдХреЗ рд╣рд┐рд╕реНрд╕реЗ рдХреЗ рд░реВрдк рдореЗрдВ (рдЕрдиреБрд╢рдВрд╕рд┐рдд, v9+)

    рдЕрдкрдиреЗ Intlayer рдХреЙрдиреНрдлрд╝рд┐рдЧрд░реЗрд╢рди рдХреЗ рдорд╛рдзреНрдпрдо рд╕реЗ рдХрдВрдкрд╛рдЗрд▓рд░ рдХреЛ рд╕рдХреНрд╖рдо рдХрд░реЗрдВ:

    ts
    // intlayer.config.ts
    import { defineConfig } from "intlayer";
    
    export default defineConfig({
      compiler: {
        enabled: true,
        output: "./src/dictionaries", // рдЬрд╣рд╛рдВ рдирд┐рдХрд╛рд▓реА рдЧрдИ рд╢рдмреНрджрдХреЛрд╢ рд▓рд┐рдЦреА рдЬрд╛рддреА рд╣реИрдВ
      },
    });
    

    рдлрд┐рд░ рдмрд┐рдирд╛ рдХрд┐рд╕реА рдЕрддрд┐рд░рд┐рдХреНрдд рдкрдВрдЬреАрдХрд░рдг рдХреЗ рдорд╛рдирдХ рдкреНрд▓рдЧрдЗрди рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░реЗрдВ:

    ts
    // vite.config.ts
    import { defineConfig } from "vite";
    import { intlayer } from "vite-intlayer";
    
    export default defineConfig({
      plugins: [intlayer()],
    });
    

    рд╕реНрдЯреИрдВрдбрдЕрд▓реЛрди (рдЬрдм рдЖрд╡рд╢реНрдпрдХрддрд╛ рд╣реЛ)

    ts
    // vite.config.ts
    import { defineConfig } from "vite";
    import { intlayerCompiler } from "vite-intlayer";
    
    export default defineConfig({
      plugins: [intlayerCompiler()],
    });
    

    рд╡рд┐рдХрд▓реНрдк

    ts
    import type { IntlayerCompilerOptions } from "vite-intlayer";
    
    рд╡рд┐рдХрд▓реНрдкрдкреНрд░рдХрд╛рд░рд╡рд┐рд╡рд░рдг
    configOptionsGetConfigurationOptionsIntlayer рдХреЙрдиреНрдлрд╝рд┐рдЧрд░реЗрд╢рди рдУрд╡рд░рд░рд╛рдЗрдбреНрд╕ рдЬреЛ getConfiguration() рдХреЛ рдЕрдЧреНрд░реЗрд╖рд┐рдд рдХрд┐рдП рдЬрд╛рддреЗ рд╣реИрдВред
    compilerConfigPartial<CompilerConfig>рдХрдВрдкрд╛рдЗрд▓рд░-рд╡рд┐рд╢рд┐рд╖реНрдЯ рдХреЙрдиреНрдлрд╝рд┐рдЧрд░реЗрд╢рди рдЕрдиреБрднрд╛рдЧ (рдЬреИрд╕реЗ enabled, output, filesList) рдХреЗ рд▓рд┐рдП рдУрд╡рд░рд░рд╛рдЗрдбреНрд╕ред

    рдЙрджрд╛рд╣рд░рдг

    ts
    intlayerCompiler({
      configOptions: { configFile: "./config/intlayer.config.ts" },
      compilerConfig: { enabled: true, output: "./src/dictionaries" },
    });
    

    рдпрд╣ рдХреИрд╕реЗ рдХрд╛рдо рдХрд░рддрд╛ рд╣реИ

    рдЯреНрд░рд╛рдВрд╕рдлрд╝реЙрд░реНрдо рдЪрд░рдг

    рдкреНрд░рддреНрдпреЗрдХ рд╕реНрд░реЛрдд рдлрд╝рд╛рдЗрд▓ рдХреЗ рд▓рд┐рдП рдЬреЛ compiler.filesList рд╕реЗ рдореЗрд▓ рдЦрд╛рддреА рд╣реИ, рдХрдВрдкрд╛рдЗрд▓рд░ рдкреНрд▓рдЧрдЗрди:

    1. рдлрд╝рд╛рдЗрд▓ рд╕рд╛рдордЧреНрд░реА рдХреЛ @intlayer/babel рд╕реЗ extractContent рдХреЗ рдорд╛рдзреНрдпрдо рд╕реЗ рдкрд╛рд╕ рдХрд░рддрд╛ рд╣реИред
    2. рдкрд╛рдИ рдЧрдИ рдкреНрд░рддреНрдпреЗрдХ рдШреЛрд╖рдгрд╛ рдХреЗ рд▓рд┐рдП onExtract рдХреЛ рдХреЙрд▓ рдХрд░рддрд╛ рд╣реИ, рдЬреЛ рдкрд░рд┐рдгрд╛рдореА рд╢рдмреНрджрдХреЛрд╢ JSON рдХреЛ compiler.output рдореЗрдВ рд▓рд┐рдЦрддрд╛ рд╣реИред
    3. рдорд╛рдирдХ useIntlayer('key') / getIntlayer('key') рдХреЙрд▓ рджреНрд╡рд╛рд░рд╛ рдкреНрд░рддрд┐рд╕реНрдерд╛рдкрд┐рдд рдЗрдирд▓рд╛рдЗрди рдШреЛрд╖рдгрд╛рдУрдВ рдХреЗ рд╕рд╛рде рдЯреНрд░рд╛рдВрд╕рдлрд╝реЙрд░реНрдо рдХрд┐рдП рдЧрдП рд╕реНрд░реЛрдд рдХреЛрдб рдХреЛ рд▓реМрдЯрд╛рддрд╛ рд╣реИред

    рд╕рдорд░реНрдерд┐рдд рдлрд╝рд╛рдЗрд▓ рдкреНрд░рдХрд╛рд░: .ts, .tsx, .js, .jsx, .vue, .svelte, .astroред

    HMR (рд╣реЙрдЯ рдореЙрдбреНрдпреВрд▓ рд░рд┐рдкреНрд▓реЗрд╕рдореЗрдВрдЯ)

    рдЬрдм рд╡рд┐рдХрд╛рд╕ рдореЛрдб рдореЗрдВ рдПрдХ рдШрдЯрдХ рдлрд╝рд╛рдЗрд▓ рд╕рд╣реЗрдЬреА рдЬрд╛рддреА рд╣реИ, рддреЛ рдХрдВрдкрд╛рдЗрд▓рд░:

    1. Vite рдХреЗ handleHotUpdate рд╣реБрдХ рдХреЗ рдорд╛рдзреНрдпрдо рд╕реЗ рдлрд╝рд╛рдЗрд▓ рдкрд░рд┐рд╡рд░реНрддрди рдХрд╛ рдкрддрд╛ рд▓рдЧрд╛рддрд╛ рд╣реИред
    2. рдЕрдкрдбреЗрдЯ рдХреА рдЧрдИ рдлрд╝рд╛рдЗрд▓ рд╕реЗ рд╕рд╛рдордЧреНрд░реА рдХреЛ рдлрд┐рд░ рд╕реЗ рдирд┐рдХрд╛рд▓рддрд╛ рд╣реИред
    3. рдЕрдкрдбреЗрдЯ рдХрд┐рдП рдЧрдП рд╢рдмреНрджрдХреЛрд╢ JSON рдХреЛ рд▓рд┐рдЦрддрд╛ рд╣реИред
    4. рдкреВрд░реНрдг рдкреГрд╖реНрда рдкреБрдирд░рд╛рд░рдВрдн (server.ws.send({ type: 'full-reload' })) рдХреЛ рдЯреНрд░рд┐рдЧрд░ рдХрд░рддрд╛ рд╣реИред

    500 ms рдХрд╛ рдбрд┐рдмрд╛рдЙрдВрд╕ рд╢рдмреНрджрдХреЛрд╢ рд▓рд┐рдЦрдиреЗ рдХреЛ рд╕реНрд╡рдпрдВ (рдЬреЛ рдПрдХ рдлрд╝рд╛рдЗрд▓-рдкрд░рд┐рд╡рд░реНрддрди рдИрд╡реЗрдВрдЯ рдХреЛ рднреА рдЯреНрд░рд┐рдЧрд░ рдХрд░рддрд╛ рд╣реИ) рдПрдХ рдЕрдирдВрдд рдкреБрдирдГ рдирд┐рд╖реНрдХрд░реНрд╖рдг рд▓реВрдк рдкреИрджрд╛ рдХрд░рдиреЗ рд╕реЗ рд░реЛрдХрддрд╛ рд╣реИред

    рдбрд┐рдбреБрдкреНрд▓реАрдХреЗрд╢рди

    intlayerCompiler рдЕрдиреНрдп рдмрдВрдбрд▓ рдкреНрд▓рдЧрдЗрдиреНрд╕ рдХреА рддрд░рд╣ рд╣реА createPrimaryInstanceGuard рдбрд┐рдбреБрдкреНрд▓реАрдХреЗрд╢рди рддрдВрддреНрд░ рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рддрд╛ рд╣реИред рдЬрдм intlayer() (рдЬреЛ рдХрдВрдкрд╛рдЗрд▓рд░ рдХреЛ рдмрдВрдбрд▓ рдХрд░рддрд╛ рд╣реИ) рдФрд░ рдПрдХ рдореИрдиреНрдпреБрдЕрд▓ intlayerCompiler() рдХреЙрд▓ рджреЛрдиреЛрдВ рдореМрдЬреВрдж рд╣реЛрддреЗ рд╣реИрдВ, рддреЛ рдХреЗрд╡рд▓ рдкрд╣рд▓рд╛ рдкрдВрдЬреАрдХреГрдд рдЙрджрд╛рд╣рд░рдг рдЪрд▓рддрд╛ рд╣реИ, рдХреЛрдИ рднреА рд╢рдмреНрджрдХреЛрд╢ рджреЛ рдмрд╛рд░ рдирд╣реАрдВ рд▓рд┐рдЦрд╛ рдЬрд╛рддрд╛ рд╣реИред