Penulis:
    Dibuat:2026-06-25Terakhir diperbarui:2026-06-25

    intlayerCompiler

    intlayerCompiler adalah plugin Vite yang memindai file sumber komponen untuk deklarasi konten Intlayer inline — konten yang ditentukan secara langsung di dalam komponen alih-alih di file .content.ts terpisah — dan menulisnya ke file JSON kamus selama fase transform.

    Sejak Intlayer v9 intlayerCompiler secara otomatis disertakan di dalam plugin utama intlayer() ketika compiler.enabled bernilai true dan compiler.output diatur dalam konfigurasi Intlayer Anda. Anda hanya perlu mendaftarkannya secara terpisah ketika Anda ingin kontrol penuh atas konfigurasi khusus kompilator.

    Penggunaan

    Sebagai bagian dari intlayer() (direkomendasikan, v9+)

    Aktifkan kompilator melalui konfigurasi Intlayer Anda:

    ts
    // intlayer.config.tsimport { defineConfig } from "intlayer";export default defineConfig({  compiler: {    enabled: true,    output: "./src/dictionaries", // tempat kamus yang diekstrak ditulis  },});

    Kemudian gunakan plugin standar tanpa registrasi tambahan:

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

    Mandiri (bila diperlukan)

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

    Opsi

    ts
    import type { IntlayerCompilerOptions } from "vite-intlayer";
    Opsi Tipe Deskripsi
    configOptions GetConfigurationOptions Override konfigurasi Intlayer yang diteruskan ke getConfiguration().
    compilerConfig Partial<CompilerConfig> Override untuk bagian konfigurasi khusus kompilator (misalnya enabled, output, filesList).

    Contoh

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

    Cara kerjanya

    Fase Transform

    Untuk setiap file sumber yang cocok dengan compiler.filesList, plugin kompilator:

    1. Meneruskan konten file melalui extractContent dari @intlayer/babel.
    2. Memanggil onExtract untuk setiap deklarasi yang ditemukan, yang menulis JSON kamus yang dihasilkan ke compiler.output.
    3. Mengembalikan kode sumber yang ditransformasikan dengan deklarasi inline yang digantikan oleh panggilan standar useIntlayer('key') / getIntlayer('key').

    Jenis file yang didukung: .ts, .tsx, .js, .jsx, .vue, .svelte, .astro.

    HMR (Hot Module Replacement)

    Ketika file komponen disimpan dalam mode pengembangan, kompilator:

    1. Mendeteksi perubahan file melalui hook handleHotUpdate Vite.
    2. Mengekstrak kembali konten dari file yang diperbarui.
    3. Menulis JSON kamus yang diperbarui.
    4. Memicu pemuatan ulang halaman penuh (server.ws.send({ type: 'full-reload' })).

    Debounce 500 ms mencegah penulisan kamus itu sendiri (yang juga memicu event perubahan file) menyebabkan lingkaran ekstraksi ulang yang tak terbatas.

    Deduplikasi

    intlayerCompiler menggunakan mekanisme deduplikasi createPrimaryInstanceGuard yang sama dengan plugin bawaan lainnya. Ketika panggilan intlayer() (yang membundel kompilator) dan panggilan manual intlayerCompiler() ada, hanya instans terdaftar pertama yang berjalan — tidak ada kamus yang ditulis dua kali.

    Mengapa Intlayer?