intlayerCompiler

intlayerCompiler, bileşen kaynak dosyalarını satır içi Intlayer içerik bildirimleri (ayrı bir .content.ts dosyası yerine doğrudan bir bileşen içinde tanımlanan içerikler) için tarayan ve bunları dönüştürme aşamasında sözlük JSON dosyalarına yazan bir Vite eklentisidir.

Intlayer v9'dan beri intlayerCompiler, Intlayer yapılandırmanızda hem compiler.enabled değeri true hem de compiler.output ayarlandığında ana intlayer() eklentisine otomatik olarak dahil edilir. Yalnızca derleyiciye özel yapılandırma üzerinde tam kontrol sahibi olmak istediğinizde bunu ayrıca kaydetmeniz gerekir.

Kullanım

intlayer() Eklentisinin Parçası Olarak (Önerilen, v9+)

Derleyiciyi Intlayer yapılandırmanız aracılığıyla etkinleştirin:

// intlayer.config.ts
import { defineConfig } from "intlayer";

export default defineConfig({
  compiler: {
    enabled: true,
    output: "./src/dictionaries", // ayıklanan sözlüklerin yazılacağı yer
  },
});

Ardından, ek bir kayıt yapmadan standart eklentiyi kullanın:

// vite.config.ts
import { defineConfig } from "vite";
import { intlayer } from "vite-intlayer";

export default defineConfig({
  plugins: [intlayer()],
});

Bağımsız (Standalone - gerektiğinde)

// vite.config.ts
import { defineConfig } from "vite";
import { intlayerCompiler } from "vite-intlayer";

export default defineConfig({
  plugins: [intlayerCompiler()],
});

Seçenekler

import type { IntlayerCompilerOptions } from "vite-intlayer";

Örnek

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

Nasıl çalışır?

Dönüştürme Aşaması (Transform)

compiler.filesList ile eşleşen her kaynak dosya için derleyici eklentisi:

1. Dosya içeriğini @intlayer/babel paketindeki extractContent işlevine iletir.
2. Bulunan her bildirim için onExtract işlevini çağırır ve bu işlev, ortaya çıkan sözlük JSON dosyasını compiler.output yoluna yazar.
3. Satır içi bildirimlerin standart useIntlayer('key') / getIntlayer('key') çağrılarıyla değiştirildiği dönüştürülmüş kaynak kodu döndürür.

Desteklenen dosya türleri: .ts, .tsx, .js, .jsx, .vue, .svelte, .astro.

HMR (Hot Module Replacement - Sıcak Modül Değişimi)

Geliştirme modunda bir bileşen dosyası kaydedildiğinde derleyici:

1. Vite'in handleHotUpdate kancası (hook) aracılığıyla dosya değişikliğini algılar.
2. Güncellenen dosyadan içeriği yeniden ayıklar.
3. Güncellenen sözlük JSON dosyasını yazar.
4. Tam sayfa yenilemesini tetikler (server.ws.send({ type: 'full-reload' })).

500 ms'lik bir debounce (gecikme), sözlük yazma işleminin kendisinin (bu da bir dosya değişikliği olayını tetikler) sonsuz bir yeniden ayıklama döngüsüne neden olmasını önler.

Tekilleştirme (Deduplication)

intlayerCompiler, diğer paketlenmiş eklentilerle aynı createPrimaryInstanceGuard tekilleştirme mekanizmasını kullanır. Hem intlayer() (derleyiciyi içeren) hem de manuel bir intlayerCompiler() çağrısı mevcut olduğunda, yalnızca ilk kaydedilen örnek çalışır — hiçbir sözlük iki kez yazılmaz.