uvako-cli 0.3.0 → 0.4.0

package/README.md

@@ -44,7 +44,7 @@ paneline giriş yapmış olmanız gerekir. Tema, panelden yayınlanana kadar vit
 | `uvako login --store <mağaza>` | Mağazaya tema erişim anahtarıyla bağlanır. |
 | `uvako logout` · `uvako whoami` | Kayıtlı girişi siler · bağlı mağazayı gösterir. |
 | `uvako theme init <anahtar>` | Yeni tema iskeleti (`--base`, `--name`, `--author`). |
-| `uvako theme check [klasör]` | Temayı denetler: yapı, ayarlar, bölümler, görseller, güvenlik. |
+| `uvako theme check [klasör]` | Temayı denetler: yapı, ayarlar, bölümler, görseller, çeviriler, güvenlik. |
 | `uvako theme dev [klasör]` | Canlı geliştirme: kaydettikçe yükler, önizleme yenilenir. Durdurunca mağaza eski hâline döner (`--keep` ile kütüphanede kalır). |
 | `uvako theme push [klasör]` | Temayı mağazanın tema kütüphanesine yükler. |
 | `uvako theme pull <anahtar>` | Yüklediğiniz temayı indirir (`--dir`, `--force`). |
@@ -66,6 +66,7 @@ theme.json                     kimlik: key, name, version, base; mağaza vitrini
 config/settings_data.json      temel temadan farklı olan ayar değerleri
 config/settings_schema.json    (isteğe bağlı) panelde görünen ayarlar
 templates/index.json           (isteğe bağlı) ana sayfadaki bölüm sırası
+locales/en.json, de.json, tr.json  (isteğe bağlı) temanın kendi metinlerinin çevirisi
 styles/_tokens.scss            renk, yazı tipi, köşe değişkenleri (temanın tamamına yayılır)
 styles/theme.scss              temaya özgü SCSS
 assets/                        logo, slayt ve banner görselleri, yazı tipleri
@@ -75,6 +76,37 @@ reference/                     temel temanın ayarları ve bölüm türleri (pak
 Bölümlerin kendisi (slayt, banner, ürün vitrini…) temel temadan gelir; paket hangilerinin hangi sırayla
 ve hangi görünümle kullanılacağını söyler. Katalog temaları: [themes.uvako.com](https://themes.uvako.com).
 
+### Diller
+
+Mağazalar vitrinini Türkçe, İngilizce ve Almanca yayınlayabilir. Temanın kendi metinlerini
+(`config/settings_data.json` içindeki başlık ve buton yazıları, `theme.json` içindeki açıklama, sektör ve
+özellikler) çevirmek için pakete sözlük dosyası koyun:
+
+```json
+{
+  "Yeni sezon geldi": "The new season is here",
+  "Alışverişe başla": "Start shopping"
+}
+```
+
+- Dosyalar: `locales/en.json`, `locales/de.json`, `locales/tr.json`. Anahtar temadaki metnin kendisi,
+  değer o dildeki karşılığıdır. Düz bir sözlüktür; iç içe nesne olamaz.
+- Temayı Türkçe yazdıysanız `en.json` ve `de.json` yeterlidir. Başka bir dilde yazdıysanız Türkçe
+  karşılıkları `tr.json` dosyasına koyun.
+- Çevirisi olmayan metin yazıldığı gibi gösterilir. `uvako theme check` her dosyada eksik kalan
+  metinleri uyarı olarak listeler.
+- Mağaza sahibinin panelden değiştirdiği metin sözlükte yoksa olduğu gibi kalır.
+- Sınırlar: dosya başına 256 KB ve 2.000 metin; metin 500, çevirisi 2.000 karakter.
+
+Temel temadan gelen metinler (sepet, ödeme, üyelik, menü) platform tarafından çevrilir; onları
+sözlüğe yazmanız gerekmez.
+
+### CLI dili
+
+Çıktı Türkçe ya da İngilizcedir. Dil sırasıyla `--lang` seçeneğinden, `UVAKO_LANG` ortam değişkeninden
+ve sistemin dilinden okunur: `uvako theme check --lang en`. İngilizce çalışırken `theme init` iskeleti
+(README, SCSS açıklamaları) İngilizce yazar ve Türkçe karşılığı `locales/tr.json` dosyasına koyar.
+
 ### Ürün sayfası sekmeleri
 
 Ürün detay sayfasındaki sekmeler `config/settings_data.json` içindeki `product_detail_page_tabs` ile açılır

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uvako-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Uvako tema geliştirme aracı. Tema başlatır, denetler, mağazaya yükler ve canlı önizletir. https://uvako.com",
   "type": "module",
   "license": "UNLICENSED",

package/src/api.js

@@ -1,3 +1,4 @@
+import { t } from "./i18n.js";
 // Mağazanın tema uç noktası (/api/theme-cli). Erişim anahtarı yalnızca girişte seçilen mağazaya
 // gönderilir: yönlendirmeler izlenmez, böylece anahtar başka bir adrese taşınmaz.
 
@@ -21,7 +22,7 @@ export async function call({ origin, token }, method, route, { body, raw = false
       signal: AbortSignal.timeout(timeout),
     });
   } catch (error) {
-    throw new ApiError(`Mağazaya bağlanılamadı (${origin}): ${error.cause?.code ?? error.message}`);
+    throw new ApiError(t("Mağazaya bağlanılamadı ({0}): {1}", origin, error.cause?.code ?? error.message));
   }
   if (response.ok) return raw ? Buffer.from(await response.arrayBuffer()) : response.json();
   let payload = null;
@@ -31,7 +32,7 @@ export async function call({ origin, token }, method, route, { body, raw = false
     // JSON olmayan yanıt (ör. ağ geçidi hatası).
   }
   const problem = payload?.error ?? {};
-  const fallback = response.status === 404 ? "Bu adreste Uvako tema uç noktası yok. Mağaza adresini kontrol edin." : `Sunucu ${response.status} yanıtı verdi.`;
+  const fallback = response.status === 404 ? t("Bu adreste Uvako tema uç noktası yok. Mağaza adresini kontrol edin.") : t("Sunucu {0} yanıtı verdi.", response.status);
   throw new ApiError(problem.message || fallback, { status: response.status, code: problem.code || "", problems: Array.isArray(problem.problems) ? problem.problems : [] });
 }
 
@@ -41,9 +42,9 @@ export async function starter(site, base) {
   try {
     response = await fetch(`${site}/api/site/themes/${encodeURIComponent(base)}/starter`, { headers: { Accept: "application/json", "User-Agent": "uvako-cli" }, signal: AbortSignal.timeout(30000) });
   } catch (error) {
-    throw new ApiError(`uvako.com'a bağlanılamadı: ${error.cause?.code ?? error.message}`);
+    throw new ApiError(t("uvako.com'a bağlanılamadı: {0}", error.cause?.code ?? error.message));
   }
-  if (response.status === 404) throw new ApiError(`"${base}" adında bir temel tema yok. Temalar: https://themes.uvako.com`, { status: 404 });
-  if (!response.ok) throw new ApiError(`Temel tema okunamadı (${response.status}).`, { status: response.status });
+  if (response.status === 404) throw new ApiError(t("\"{0}\" adında bir temel tema yok. Temalar: https://themes.uvako.com", base), { status: 404 });
+  if (!response.ok) throw new ApiError(t("Temel tema okunamadı ({0}).", response.status), { status: response.status });
   return response.json();
 }

package/src/check.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { walk } from "./files.js";
+import { t } from "./i18n.js";
 
 // Tema denetimi. Mağazaya yüklenen paketi platform aynı kurallarla yeniden denetler; buradaki
 // denetim geliştiriciye hatayı yüklemeden önce göstermek içindir, güvenlik kararı sunucudadır.
@@ -10,7 +11,11 @@ import { walk } from "./files.js";
 //            üstüne ayar, bölüm sırası, SCSS ve görsel getirir.
 //   depo   — platform deposundaki katalog teması (themes/<anahtar>).
 
-export const limits = { fileBytes: 5 * 1024 * 1024, totalBytes: 60 * 1024 * 1024, files: 600, styleBytes: 512 * 1024, archiveBytes: 40 * 1024 * 1024 };
+export const limits = { fileBytes: 5 * 1024 * 1024, totalBytes: 60 * 1024 * 1024, files: 600, styleBytes: 512 * 1024, archiveBytes: 40 * 1024 * 1024, localeBytes: 256 * 1024, localeEntries: 2000 };
+
+// Temanın kendi metinlerinin çevirisi: locales/<dil>.json, {"temadaki metin": "çevirisi"}.
+// Vitrin ve panel bu sözlükle temanın varsayılan metinlerini ziyaretçinin diline çevirir.
+export const textLocales = ["tr", "en", "de"];
 
 const keyPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const versionPattern = /^\d+\.\d+\.\d+$/;
@@ -30,8 +35,8 @@ const allowedStyleHosts = new Set(["fonts.googleapis.com", "fonts.gstatic.com",
 const scriptPatterns = [
   { pattern: /<script\b/i, text: "<script> etiketi" },
   { pattern: /javascript:/i, text: "javascript: adresi" },
-  { pattern: /\son[a-z]+\s*=/i, text: "olay özniteliği (onclick, onload…)" },
-  { pattern: /<iframe\b|<object\b|<embed\b|<foreignObject\b/i, text: "gömülü içerik etiketi" },
+  { pattern: /\son[a-z]+\s*=/i, text: t("olay özniteliği (onclick, onload…)") },
+  { pattern: /<iframe\b|<object\b|<embed\b|<foreignObject\b/i, text: t("gömülü içerik etiketi") },
 ];
 
 const secretPatterns = [
@@ -51,9 +56,54 @@ function readJson(file, report, label, required = true) {
   try {
     return JSON.parse(readFileSync(file, "utf8").replace(/^\uFEFF/, ""));
   } catch (error) {
-    report.errors.push(`${label} geçerli JSON değil: ${error.message}`);
+    report.errors.push(t("{0} geçerli JSON değil: {1}", label, error.message));
+    return null;
+  }
+}
+
+// locales/<dil>.json: düz bir metin sözlüğü olmalı. Geçerliyse sözlüğü, değilse null döndürür.
+function checkLocale(rel, file, report) {
+  let texts;
+  try {
+    texts = JSON.parse(readFileSync(file, "utf8").replace(/^\uFEFF/, ""));
+  } catch (error) {
+    report.errors.push(t("{0} geçerli JSON değil: {1}", rel, error.message));
+    return null;
+  }
+  if (!texts || typeof texts !== "object" || Array.isArray(texts) || Object.values(texts).some((value) => typeof value !== "string")) {
+    report.errors.push(t("{0}: düz bir metin sözlüğü olmalı ({\"temadaki metin\": \"çevirisi\"}).", rel));
     return null;
   }
+  const entries = Object.entries(texts);
+  if (entries.length > limits.localeEntries) report.errors.push(t("{0}: en çok {1} metin içerebilir.", rel, limits.localeEntries));
+  if (entries.some(([source, text]) => !source.trim() || source.length > 500 || text.length > 2000)) report.errors.push(t("{0}: metin en çok 500, çevirisi en çok 2000 karakter olabilir; boş metin olamaz.", rel));
+  return texts;
+}
+
+// Çevrilebilecek metinler: theme.json'daki tanıtım alanları ve settings_data.json'daki yazılar.
+// Renk, adres, dosya yolu ve sayılar metin sayılmaz.
+function translatable(meta, data) {
+  const out = new Set();
+  const add = (value) => {
+    const text = typeof value === "string" ? value.trim() : "";
+    if (!text || !/\p{L}{2}/u.test(text)) return;
+    if (/^(#|https?:|\/|uploads\/|assets\/|rgba?\(|[\w.-]+\.(png|jpe?g|webp|avif|gif|svg|ico|woff2?|ttf|otf)$)/i.test(text)) return;
+    if (/^[a-z0-9_.,:-]+$/.test(text)) return;
+    out.add(text);
+  };
+  add(meta?.description);
+  for (const item of [...(Array.isArray(meta?.industries) ? meta.industries : []), ...(Array.isArray(meta?.features) ? meta.features : [])]) add(item);
+  if (data && typeof data === "object" && !Array.isArray(data)) for (const value of Object.values(data)) add(value);
+  return out;
+}
+
+function checkTranslations(locales, meta, data, report) {
+  const texts = translatable(meta, data);
+  for (const [locale, dict] of Object.entries(locales)) {
+    if (!dict) continue;
+    const missing = [...texts].filter((text) => !(text in dict));
+    if (missing.length) report.warnings.push(t("locales/{0}.json: {1} metnin çevirisi yok (ör. \"{2}\"). Çevirisi olmayan metin yazıldığı gibi gösterilir.", locale, missing.length, missing[0].slice(0, 60)));
+  }
 }
 
 // Şemadaki ayar adlarını toplar ({"type":"tab","values":[{name, settings, group}]}).
@@ -64,7 +114,7 @@ function schemaKeys(node, into, report, trail = "") {
     const where = trail ? `${trail} › ${tab.name ?? "?"}` : String(tab.name ?? "?");
     for (const [key, setting] of Object.entries(tab.settings ?? {})) {
       into.add(key);
-      if (!setting || typeof setting !== "object" || !setting.type) report.errors.push(`Ayar şeması: "${key}" ayarının türü yok (${where}).`);
+      if (!setting || typeof setting !== "object" || !setting.type) report.errors.push(t("Ayar şeması: \"{0}\" ayarının türü yok ({1}).", key, where));
     }
     schemaKeys(tab.group, into, report, where);
   }
@@ -83,10 +133,10 @@ function locate(dir) {
 
 function scanText(rel, text, report) {
   for (const { pattern, text: what } of scriptPatterns) {
-    if (pattern.test(text)) report.errors.push(`${rel}: ${what} içeriyor. Tema içinde betik çalıştırılamaz.`);
+    if (pattern.test(text)) report.errors.push(t("{0}: {1} içeriyor. Tema içinde betik çalıştırılamaz.", rel, what));
   }
   for (const pattern of secretPatterns) {
-    if (pattern.test(text)) report.errors.push(`${rel}: gizli anahtar ya da parola gibi görünen bir değer içeriyor.`);
+    if (pattern.test(text)) report.errors.push(t("{0}: gizli anahtar ya da parola gibi görünen bir değer içeriyor.", rel));
   }
 }
 
@@ -113,19 +163,19 @@ function scanStyle(rel, source, report, { strict = false, styles = new Set(), to
     return (match ? held[Number(match[1])] ?? "" : value).trim();
   };
   const all = `${text} ${held.join(" ")}`;
-  if (/expression\s*\(|behavior\s*:|-moz-binding|<\/style/i.test(all)) report.errors.push(`${rel}: tarayıcıda kod çalıştıran CSS (expression, behavior, -moz-binding) içeriyor.`);
-  if (/javascript:/i.test(all)) report.errors.push(`${rel}: javascript: adresi içeriyor.`);
+  if (/expression\s*\(|behavior\s*:|-moz-binding|<\/style/i.test(all)) report.errors.push(t("{0}: tarayıcıda kod çalıştıran CSS (expression, behavior, -moz-binding) içeriyor.", rel));
+  if (/javascript:/i.test(all)) report.errors.push(t("{0}: javascript: adresi içeriyor.", rel));
   if (strict) {
     const rule = /@(while|for|each|function|mixin|use|forward|debug|warn|error|charset)\b/i.exec(text);
-    if (rule) report.errors.push(`${rel}: @${rule[1].toLowerCase()} kullanılamaz. Tema stilleri döngü, fonksiyon ve mixin tanımı içeremez; temel temanın mixin'leri @include ile kullanılabilir.`);
-    if (text.includes("\\")) report.errors.push(`${rel}: tırnak dışında ters eğik çizgi kullanılamaz.`);
+    if (rule) report.errors.push(t("{0}: @{1} kullanılamaz. Tema stilleri döngü, fonksiyon ve mixin tanımı içeremez; temel temanın mixin'leri @include ile kullanılabilir.", rel, rule[1].toLowerCase()));
+    if (text.includes("\\")) report.errors.push(t("{0}: tırnak dışında ters eğik çizgi kullanılamaz.", rel));
   }
   text = text.replace(/url\(([^)]*)\)/gi, (_, inner) => {
     const target = resolve(inner);
     if (/^data:/i.test(target)) {
-      if (strict && !/^data:(image\/(png|jpe?g|gif|webp)|font\/woff2?|application\/font-woff2?);base64,/i.test(target)) report.errors.push(`${rel}: yalnızca görsel ve yazı tipi data: adresleri kullanılabilir.`);
+      if (strict && !/^data:(image\/(png|jpe?g|gif|webp)|font\/woff2?|application\/font-woff2?);base64,/i.test(target)) report.errors.push(t("{0}: yalnızca görsel ve yazı tipi data: adresleri kullanılabilir.", rel));
     } else if ((target.includes("//") || (strict && target.includes(":"))) && !allowedUrl(target)) {
-      report.errors.push(`${rel}: izin verilmeyen dış adres (${hostOf(target)}). Görsel ve yazı tiplerini assets/ altına koyun; yalnızca şu adresler çağrılabilir: ${[...allowedStyleHosts].join(", ")}.`);
+      report.errors.push(t("{0}: izin verilmeyen dış adres ({1}). Görsel ve yazı tiplerini assets/ altına koyun; yalnızca şu adresler çağrılabilir: {2}.", rel, hostOf(target), [...allowedStyleHosts].join(", ")));
     }
     return "url()";
   });
@@ -134,9 +184,9 @@ function scanStyle(rel, source, report, { strict = false, styles = new Set(), to
       if (/^\s*url\(\)/i.test(part)) continue;
       const target = resolve(part);
       if (target.includes("//") || target.includes(":")) {
-        if (!allowedUrl(target)) report.errors.push(`${rel}: izin verilmeyen dış adres (${hostOf(target)}).`);
+        if (!allowedUrl(target)) report.errors.push(t("{0}: izin verilmeyen dış adres ({1}).", rel, hostOf(target)));
       } else if (strict && !(/^[a-z0-9]+(?:[-_][a-z0-9]+)*$/.test(target) && (styles.has(`${target}.scss`) || styles.has(`_${target}.scss`)))) {
-        report.errors.push(`${rel}: @import "${target}" pakette yok. Yalnızca paketin kendi styles/ dosyaları içe aktarılabilir.`);
+        report.errors.push(t("{0}: @import \"{1}\" pakette yok. Yalnızca paketin kendi styles/ dosyaları içe aktarılabilir.", rel, target));
       }
     }
   }
@@ -144,7 +194,7 @@ function scanStyle(rel, source, report, { strict = false, styles = new Set(), to
     for (const raw of text.split(";")) {
       const statement = raw.trim();
       if (statement === "" || /^\$[A-Za-z0-9_-]+\s*:\s*[^{}@]+$/.test(statement) || /^@import/i.test(statement)) continue;
-      report.errors.push(`${rel}: yalnızca değişken ataması ($ad: değer;) ve yazı tipi @import'u içerebilir.`);
+      report.errors.push(t("{0}: yalnızca değişken ataması ($ad: değer;) ve yazı tipi @import'u içerebilir.", rel));
       break;
     }
   }
@@ -154,21 +204,21 @@ function checkIdentity(dir, meta, report) {
   const key = typeof meta?.key === "string" ? meta.key.trim() : "";
   report.key = key;
   if (!meta) return key;
-  if (!keyPattern.test(key) || key.length > 40) report.errors.push(`theme.json: "key" küçük harf, rakam ve tireden oluşmalı (ör. "linea").`);
-  else if (key !== path.basename(dir)) report.errors.push(`theme.json: "key" (${key}) klasör adıyla (${path.basename(dir)}) aynı olmalı.`);
+  if (!keyPattern.test(key) || key.length > 40) report.errors.push(t("theme.json: \"key\" küçük harf, rakam ve tireden oluşmalı (ör. \"linea\")."));
+  else if (key !== path.basename(dir)) report.errors.push(t("theme.json: \"key\" ({0}) klasör adıyla ({1}) aynı olmalı.", key, path.basename(dir)));
   if (!String(meta.name ?? "").trim()) report.errors.push(`theme.json: "name" gerekli.`);
-  if (!versionPattern.test(String(meta.version ?? ""))) report.errors.push(`theme.json: "version" 1.0.0 biçiminde olmalı.`);
-  if (!String(meta.description ?? "").trim()) report.warnings.push(`theme.json: "description" boş; tema listesinde açıklama görünmez.`);
+  if (!versionPattern.test(String(meta.version ?? ""))) report.errors.push(t("theme.json: \"version\" 1.0.0 biçiminde olmalı."));
+  if (!String(meta.description ?? "").trim()) report.warnings.push(t("theme.json: \"description\" boş; tema listesinde açıklama görünmez."));
   return key;
 }
 
 function checkTemplate(index, types, report, source) {
   if (!index) return;
-  if (!Array.isArray(index.order) || index.order.length === 0) report.errors.push(`templates/index.json: "order" boş; ana sayfada bölüm görünmez.`);
+  if (!Array.isArray(index.order) || index.order.length === 0) report.errors.push(t("templates/index.json: \"order\" boş; ana sayfada bölüm görünmez."));
   for (const id of index.order ?? []) {
     const section = index.sections?.[id];
-    if (!section) report.errors.push(`templates/index.json: "order" içindeki "${id}" bölümü "sections" altında tanımlı değil.`);
-    else if (types && !types.has(section.type)) report.errors.push(`templates/index.json: "${id}" bölümünün türü (${section.type}) ${source} yok.`);
+    if (!section) report.errors.push(t("templates/index.json: \"order\" içindeki \"{0}\" bölümü \"sections\" altında tanımlı değil.", id));
+    else if (types && !types.has(section.type)) report.errors.push(t("templates/index.json: \"{0}\" bölümünün türü ({1}) {2} yok.", id, section.type, source));
   }
 }
 
@@ -188,17 +238,17 @@ function checkProductTabs(data, report) {
   if ([0, 1, "0", "1", true, false].includes(value)) return;
   const where = 'config/settings_data.json: "product_detail_page_tabs"';
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    report.errors.push(`${where} 1 (hepsi açık) ya da {"display_product_comments": 1, …} nesnesi olmalı.`);
+    report.errors.push(t("{0} 1 (hepsi açık) ya da {\"display_product_comments\": 1, …} nesnesi olmalı.", where));
     return;
   }
   for (const [key, flag] of Object.entries(value)) {
     if (!(key in productTabKeys)) {
-      report.warnings.push(`${where}: "${key}" bilinen bir sekme değil (${Object.keys(productTabKeys).join(", ")}).`);
+      report.warnings.push(t("{0}: \"{1}\" bilinen bir sekme değil ({2}).", where, key, Object.keys(productTabKeys).join(", ")));
       continue;
     }
-    if (![0, 1, "0", "1", true, false].includes(flag)) report.errors.push(`${where}: "${key}" değeri 1 ya da 0 olmalı.`);
+    if (![0, 1, "0", "1", true, false].includes(flag)) report.errors.push(t("{0}: \"{1}\" değeri 1 ya da 0 olmalı.", where, key));
     const label = productTabKeys[key];
-    if (label && label in data && typeof data[label] !== "string") report.errors.push(`config/settings_data.json: "${label}" sekme başlığı metin olmalı.`);
+    if (label && label in data && typeof data[label] !== "string") report.errors.push(t("config/settings_data.json: \"{0}\" sekme başlığı metin olmalı.", label));
   }
 }
 
@@ -206,7 +256,7 @@ function checkImages(data, assets, report) {
   if (!data || typeof data !== "object") return;
   for (const [name, value] of Object.entries(data)) {
     if (typeof value !== "string" || !/^uploads\/[^\s]+\.(png|jpe?g|webp|avif|gif|svg|ico)$/i.test(value)) continue;
-    if (!existsSync(path.join(assets, value))) report.errors.push(`config/settings_data.json: "${name}" ayarındaki görsel bulunamadı (assets/${value}).`);
+    if (!existsSync(path.join(assets, value))) report.errors.push(t("config/settings_data.json: \"{0}\" ayarındaki görsel bulunamadı (assets/{1}).", name, value));
   }
 }
 
@@ -214,17 +264,18 @@ function checkImages(data, assets, report) {
 
 function checkPackage(dir, meta, report) {
   const base = String(meta?.base ?? "").trim();
-  if (meta && !keyPattern.test(base)) report.errors.push(`theme.json: "base" gerekli: paketin temel aldığı katalog teması (ör. "linea"). Temalar: https://themes.uvako.com`);
-  if (meta && (Number(meta.price ?? 0) < 0 || Number(meta.price ?? 0) > 100000 || Number.isNaN(Number(meta.price ?? 0)))) report.errors.push(`theme.json: "price" 0 ile 100.000 arasında olmalı.`);
-  if (meta?.demo_url && !/^https:\/\/[^\s]+$/.test(String(meta.demo_url))) report.errors.push(`theme.json: "demo_url" https:// ile başlayan bir adres olmalı.`);
+  if (meta && !keyPattern.test(base)) report.errors.push(t("theme.json: \"base\" gerekli: paketin temel aldığı katalog teması (ör. \"linea\"). Temalar: https://themes.uvako.com"));
+  if (meta && (Number(meta.price ?? 0) < 0 || Number(meta.price ?? 0) > 100000 || Number.isNaN(Number(meta.price ?? 0)))) report.errors.push(t("theme.json: \"price\" 0 ile 100.000 arasında olmalı."));
+  if (meta?.demo_url && !/^https:\/\/[^\s]+$/.test(String(meta.demo_url))) report.errors.push(t("theme.json: \"demo_url\" https:// ile başlayan bir adres olmalı."));
 
   const { files, links } = walk(dir);
-  for (const link of links) report.errors.push(`${link}: sembolik bağ pakete alınamaz.`);
+  for (const link of links) report.errors.push(t("{0}: sembolik bağ pakete alınamaz.", link));
   const styles = new Set(files.filter((file) => file.rel.startsWith("styles/")).map((file) => file.rel.slice("styles/".length)));
   const totals = { files: 0, bytes: 0, style: 0 };
   let schema = null;
   let data = null;
   let index = null;
+  const locales = {};
   for (const file of files) {
     const rel = file.rel;
     if (localOnly(rel)) continue;
@@ -232,15 +283,23 @@ function checkPackage(dir, meta, report) {
     totals.bytes += file.size;
     const parts = rel.split("/");
     if (parts.some((part) => !segmentPattern.test(part))) {
-      report.errors.push(`${rel}: dosya adında yalnızca harf, rakam, nokta, tire ve alt çizgi olabilir; gizli dosya olamaz.`);
+      report.errors.push(t("{0}: dosya adında yalnızca harf, rakam, nokta, tire ve alt çizgi olabilir; gizli dosya olamaz.", rel));
       continue;
     }
     const ext = path.extname(rel).toLowerCase();
     const text = () => readFileSync(file.full, "utf8");
     if (rel === "theme.json") scanText(rel, text(), report);
     else if (rel === "config/settings_schema.json" || rel === "config/settings_data.json" || rel === "templates/index.json") {
-      if (file.size > 1024 * 1024) report.errors.push(`${rel}: 1 MB sınırını aşıyor.`);
+      if (file.size > 1024 * 1024) report.errors.push(t("{0}: 1 MB sınırını aşıyor.", rel));
       else scanText(rel, text(), report);
+    } else if (parts[0] === "locales" && parts.length === 2 && rel.endsWith(".json")) {
+      const locale = parts[1].slice(0, -5);
+      if (!textLocales.includes(locale)) report.errors.push(t("{0}: desteklenmeyen dil. Kullanılabilir dosyalar: {1}.", rel, textLocales.map((item) => `locales/${item}.json`).join(", ")));
+      else if (file.size > limits.localeBytes) report.errors.push(t("{0}: {1} KB sınırını aşıyor.", rel, limits.localeBytes / 1024));
+      else {
+        scanText(rel, text(), report);
+        locales[locale] = checkLocale(rel, file.full, report);
+      }
     } else if (parts[0] === "styles" && parts.length === 2 && stylePattern.test(parts[1])) {
       totals.style += file.size;
       if (file.size <= limits.styleBytes) {
@@ -250,40 +309,41 @@ function checkPackage(dir, meta, report) {
       }
     } else if (parts[0] === "assets" && parts.length >= 2) {
       if (!assetExtensions.has(ext)) {
-        report.errors.push(`${rel}: bu dosya türü (${ext || "uzantısız"}) temada bulunamaz.`);
+        report.errors.push(t("{0}: bu dosya türü ({1}) temada bulunamaz.", rel, ext || "uzantısız"));
         continue;
       }
-      if (file.size > limits.fileBytes) report.errors.push(`${rel}: ${(file.size / 1024 / 1024).toFixed(1)} MB; tek dosya sınırı ${limits.fileBytes / 1024 / 1024} MB.`);
-      else if (file.size > 1024 * 1024 && /\.(png|jpe?g|gif)$/i.test(ext)) report.warnings.push(`${rel}: ${(file.size / 1024 / 1024).toFixed(1)} MB. WebP ya da sıkıştırılmış JPEG sayfayı hızlandırır.`);
+      if (file.size > limits.fileBytes) report.errors.push(t("{0}: {1} MB; tek dosya sınırı {2} MB.", rel, (file.size / 1024 / 1024).toFixed(1), limits.fileBytes / 1024 / 1024));
+      else if (file.size > 1024 * 1024 && /\.(png|jpe?g|gif)$/i.test(ext)) report.warnings.push(t("{0}: {1} MB. WebP ya da sıkıştırılmış JPEG sayfayı hızlandırır.", rel, (file.size / 1024 / 1024).toFixed(1)));
       if (ext === ".svg" && file.size <= limits.fileBytes) scanText(rel, text(), report);
     } else {
-      report.errors.push(`${rel}: bu dosya pakette bulunamaz. İzin verilenler: theme.json, config/settings_schema.json, config/settings_data.json, templates/index.json, styles/*.scss, assets/**.`);
+      report.errors.push(t("{0}: bu dosya pakette bulunamaz. İzin verilenler: theme.json, config/settings_schema.json, config/settings_data.json, templates/index.json, locales/tr.json, locales/en.json, locales/de.json, styles/*.scss, assets/**.", rel));
     }
   }
-  if (totals.style > limits.styleBytes) report.errors.push(`Stil dosyaları toplam ${limits.styleBytes / 1024} KB sınırını aşıyor.`);
-  if (styles.size > 0 && !styles.has("theme.scss") && !(styles.size === 1 && styles.has("_tokens.scss"))) report.errors.push("styles/theme.scss yok: stil dosyaları oradan içe aktarılır.");
+  if (totals.style > limits.styleBytes) report.errors.push(t("Stil dosyaları toplam {0} KB sınırını aşıyor.", limits.styleBytes / 1024));
+  if (styles.size > 0 && !styles.has("theme.scss") && !(styles.size === 1 && styles.has("_tokens.scss"))) report.errors.push(t("styles/theme.scss yok: stil dosyaları oradan içe aktarılır."));
 
   schema = readJson(path.join(dir, "config", "settings_schema.json"), report, "config/settings_schema.json", false);
   if (schema) {
-    if (schema.group?.type !== "tab" || !Array.isArray(schema.group?.values) || schema.group.values.length === 0) report.errors.push(`config/settings_schema.json: "group" sekmeli olmalı ({"type":"tab","values":[…]}).`);
+    if (schema.group?.type !== "tab" || !Array.isArray(schema.group?.values) || schema.group.values.length === 0) report.errors.push(t("config/settings_schema.json: \"group\" sekmeli olmalı ({\"type\":\"tab\",\"values\":[…]})."));
     schemaKeys(schema.group, new Set(), report);
   }
   data = readJson(path.join(dir, "config", "settings_data.json"), report, "config/settings_data.json", false);
-  if (data && (typeof data !== "object" || Array.isArray(data))) report.errors.push("config/settings_data.json: anahtar-değer nesnesi olmalı.");
+  if (data && (typeof data !== "object" || Array.isArray(data))) report.errors.push(t("config/settings_data.json: anahtar-değer nesnesi olmalı."));
   index = readJson(path.join(dir, "templates", "index.json"), report, "templates/index.json", false);
   // Bölüm türleri temel temadan gelir; `theme init` bunları reference/sections.json dosyasına yazar.
   const reference = existsSync(path.join(dir, "reference", "sections.json")) ? readJson(path.join(dir, "reference", "sections.json"), { errors: [] }, "") : null;
-  checkTemplate(index, reference?.sections ? new Set(Object.keys(reference.sections)) : null, report, `${base} temasında`);
+  checkTemplate(index, reference?.sections ? new Set(Object.keys(reference.sections)) : null, report, t("{0} temasında", base));
   checkImages(data, path.join(dir, "assets"), report);
   checkProductTabs(data, report);
+  checkTranslations(locales, meta, data, report);
   for (const shot of [meta?.screenshot, ...(Array.isArray(meta?.screenshots) ? meta.screenshots : [])]) {
     const rel = String(shot ?? "").trim().replace(/^\//, "").replace(/^assets\//, "");
-    if (rel && !existsSync(path.join(dir, "assets", rel))) report.errors.push(`theme.json: ekran görüntüsü pakette yok (assets/${rel}).`);
+    if (rel && !existsSync(path.join(dir, "assets", rel))) report.errors.push(t("theme.json: ekran görüntüsü pakette yok (assets/{0}).", rel));
   }
   report.files = totals.files;
   report.bytes = totals.bytes;
-  if (totals.bytes > limits.totalBytes) report.errors.push(`Tema ${(totals.bytes / 1024 / 1024).toFixed(0)} MB; sınır ${limits.totalBytes / 1024 / 1024} MB.`);
-  if (totals.files > limits.files) report.errors.push(`Tema ${totals.files} dosya içeriyor; sınır ${limits.files}.`);
+  if (totals.bytes > limits.totalBytes) report.errors.push(t("Tema {0} MB; sınır {1} MB.", (totals.bytes / 1024 / 1024).toFixed(0), limits.totalBytes / 1024 / 1024));
+  if (totals.files > limits.files) report.errors.push(t("Tema {0} dosya içeriyor; sınır {1}.", totals.files, limits.files));
 }
 
 // ── platform deposundaki katalog teması ────────────────────────────────────────────────────────
@@ -291,19 +351,19 @@ function checkPackage(dir, meta, report) {
 function scanRepoFiles(root, label, report, totals) {
   if (!existsSync(root)) return;
   const { files, links } = walk(root);
-  for (const link of links) report.errors.push(`${label}/${link}: sembolik bağ pakete alınamaz.`);
+  for (const link of links) report.errors.push(t("{0}: sembolik bağ pakete alınamaz.", `${label}/${link}`));
   for (const file of files) {
     const rel = `${label}/${file.rel}`;
     const ext = path.extname(file.rel).toLowerCase();
     totals.files += 1;
     totals.bytes += file.size;
-    if (file.rel.split("/").some((part) => part === ".." || part.startsWith("."))) report.errors.push(`${rel}: gizli dosya ya da üst klasöre çıkan yol.`);
+    if (file.rel.split("/").some((part) => part === ".." || part.startsWith("."))) report.errors.push(t("{0}: gizli dosya ya da üst klasöre çıkan yol.", rel));
     if (!repoExtensions.has(ext)) {
-      report.errors.push(`${rel}: bu dosya türü (${ext || "uzantısız"}) temada bulunamaz.`);
+      report.errors.push(t("{0}: bu dosya türü ({1}) temada bulunamaz.", rel, ext || "uzantısız"));
       continue;
     }
-    if (file.size > limits.fileBytes) report.errors.push(`${rel}: ${(file.size / 1024 / 1024).toFixed(1)} MB; tek dosya sınırı ${limits.fileBytes / 1024 / 1024} MB.`);
-    else if (file.size > 1024 * 1024 && /\.(png|jpe?g|gif)$/i.test(ext)) report.warnings.push(`${rel}: ${(file.size / 1024 / 1024).toFixed(1)} MB. WebP ya da sıkıştırılmış JPEG sayfayı hızlandırır.`);
+    if (file.size > limits.fileBytes) report.errors.push(t("{0}: {1} MB; tek dosya sınırı {2} MB.", rel, (file.size / 1024 / 1024).toFixed(1), limits.fileBytes / 1024 / 1024));
+    else if (file.size > 1024 * 1024 && /\.(png|jpe?g|gif)$/i.test(ext)) report.warnings.push(t("{0}: {1} MB. WebP ya da sıkıştırılmış JPEG sayfayı hızlandırır.", rel, (file.size / 1024 / 1024).toFixed(1)));
     if ([".json", ".scss", ".css", ".svg", ".md", ".txt"].includes(ext) && file.size <= limits.fileBytes) {
       const text = readFileSync(file.full, "utf8");
       scanText(rel, text, report);
@@ -315,44 +375,44 @@ function scanRepoFiles(root, label, report, totals) {
 function checkRepo(dir, meta, key, where, report) {
   const schema = readJson(path.join(dir, "config", "settings_schema.json"), report, "config/settings_schema.json");
   if (schema) {
-    if (schema.group?.type !== "tab" || !Array.isArray(schema.group?.values)) report.errors.push(`config/settings_schema.json: "group" sekmeli olmalı ({"type":"tab","values":[…]}).`);
+    if (schema.group?.type !== "tab" || !Array.isArray(schema.group?.values)) report.errors.push(t("config/settings_schema.json: \"group\" sekmeli olmalı ({\"type\":\"tab\",\"values\":[…]})."));
     schemaKeys(schema.group, new Set(), report);
   }
   const data = readJson(path.join(dir, "config", "settings_data.json"), report, "config/settings_data.json");
-  if (data && (typeof data !== "object" || Array.isArray(data))) report.errors.push("config/settings_data.json: anahtar-değer nesnesi olmalı.");
+  if (data && (typeof data !== "object" || Array.isArray(data))) report.errors.push(t("config/settings_data.json: anahtar-değer nesnesi olmalı."));
   else checkProductTabs(data, report);
 
   const sections = readJson(path.join(dir, "config", "sections.json"), report, "config/sections.json");
   const types = new Set(Object.keys(sections?.sections ?? {}));
-  if (sections && types.size === 0) report.errors.push(`config/sections.json: "sections" altında en az bir bölüm türü olmalı.`);
+  if (sections && types.size === 0) report.errors.push(t("config/sections.json: \"sections\" altında en az bir bölüm türü olmalı."));
   for (const [type, section] of Object.entries(sections?.sections ?? {})) {
-    if (key && !type.startsWith(`${key}-`)) report.warnings.push(`config/sections.json: "${type}" bölüm türü tema anahtarıyla ("${key}-") başlamıyor.`);
-    if (!String(section?.name ?? "").trim()) report.errors.push(`config/sections.json: "${type}" bölümünün adı yok.`);
+    if (key && !type.startsWith(`${key}-`)) report.warnings.push(t("config/sections.json: \"{0}\" bölüm türü tema anahtarıyla (\"{1}-\") başlamıyor.", type, key));
+    if (!String(section?.name ?? "").trim()) report.errors.push(t("config/sections.json: \"{0}\" bölümünün adı yok.", type));
     // "keys" isteğe bağlıdır; verilmişse liste olmalı.
-    if (section?.keys !== undefined && !Array.isArray(section.keys)) report.errors.push(`config/sections.json: "${type}" bölümünün "keys" alanı liste olmalı.`);
+    if (section?.keys !== undefined && !Array.isArray(section.keys)) report.errors.push(t("config/sections.json: \"{0}\" bölümünün \"keys\" alanı liste olmalı.", type));
   }
-  checkTemplate(readJson(path.join(dir, "templates", "index.json"), report, "templates/index.json (ana sayfa şablonu)"), sections ? types : null, report, "config/sections.json içinde");
+  checkTemplate(readJson(path.join(dir, "templates", "index.json"), report, t("templates/index.json (ana sayfa şablonu)")), sections ? types : null, report, t("config/sections.json içinde"));
 
   const totals = { files: 0, bytes: 0 };
   for (const sub of ["config", "templates"]) scanRepoFiles(path.join(dir, sub), sub, report, totals);
   scanRepoFiles(where.styles, "styles", report, totals);
   scanRepoFiles(where.assets, "assets", report, totals);
-  if (!existsSync(path.join(where.styles, "theme.scss"))) report.errors.push(`Stil dosyası yok: ${path.join(where.styles, "theme.scss")}`);
+  if (!existsSync(path.join(where.styles, "theme.scss"))) report.errors.push(t("Stil dosyası yok: {0}", path.join(where.styles, "theme.scss")));
   report.files = totals.files;
   report.bytes = totals.bytes;
-  if (totals.bytes > limits.totalBytes) report.errors.push(`Tema ${(totals.bytes / 1024 / 1024).toFixed(0)} MB; sınır ${limits.totalBytes / 1024 / 1024} MB.`);
-  if (totals.files > limits.files) report.errors.push(`Tema ${totals.files} dosya içeriyor; sınır ${limits.files}.`);
+  if (totals.bytes > limits.totalBytes) report.errors.push(t("Tema {0} MB; sınır {1} MB.", (totals.bytes / 1024 / 1024).toFixed(0), limits.totalBytes / 1024 / 1024));
+  if (totals.files > limits.files) report.errors.push(t("Tema {0} dosya içeriyor; sınır {1}.", totals.files, limits.files));
   checkImages(data, where.assets, report);
   if (meta?.screenshot) {
     const shot = String(meta.screenshot).replace(new RegExp(`^/themes/${key}/assets/`), "");
-    if (!existsSync(path.join(where.assets, shot))) report.warnings.push(`theme.json: ekran görüntüsü bulunamadı (assets/${shot}).`);
+    if (!existsSync(path.join(where.assets, shot))) report.warnings.push(t("theme.json: ekran görüntüsü bulunamadı (assets/{0}).", shot));
   }
 }
 
 export function checkTheme(dir) {
   const report = { dir, key: "", layout: "", errors: [], warnings: [], files: 0, bytes: 0 };
   if (!existsSync(path.join(dir, "theme.json"))) {
-    report.errors.push(`${dir} bir tema klasörü değil: theme.json bulunamadı.`);
+    report.errors.push(t("{0} bir tema klasörü değil: theme.json bulunamadı.", dir));
     return report;
   }
   const where = locate(dir);
@@ -365,10 +425,10 @@ export function checkTheme(dir) {
 }
 
 export function printReport(report) {
-  const title = report.key ? `${report.key} (${report.layout === "repo" ? "platform deposu" : "paket"})` : report.dir;
+  const title = report.key ? `${report.key} (${report.layout === "repo" ? t("platform deposu") : t("paket")})` : report.dir;
   for (const error of report.errors) console.error(`  ✖ ${error}`);
   for (const warning of report.warnings) console.warn(`  ! ${warning}`);
-  const size = report.files ? ` · ${report.files} dosya, ${(report.bytes / 1024 / 1024).toFixed(1)} MB` : "";
-  if (report.errors.length) console.error(`${title}: ${report.errors.length} hata, ${report.warnings.length} uyarı${size}`);
-  else console.log(`${title}: denetim geçti${report.warnings.length ? `, ${report.warnings.length} uyarı` : ""}${size}`);
+  const size = report.files ? t(" · {0} dosya, {1} MB", report.files, (report.bytes / 1024 / 1024).toFixed(1)) : "";
+  if (report.errors.length) console.error(t("{0}: {1} hata, {2} uyarı{3}", title, report.errors.length, report.warnings.length, size));
+  else console.log(t("{0}: denetim geçti{1}{2}", title, report.warnings.length ? t(", {0} uyarı", report.warnings.length) : "", size));
 }

package/src/config.js

@@ -1,6 +1,7 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { t } from "./i18n.js";
 
 // Giriş bilgileri kullanıcının ev klasöründe, yalnızca kullanıcının okuyabildiği bir dosyada durur.
 // Tema klasörüne hiçbir zaman yazılmaz; böylece pakete ya da sürüm kontrolüne karışmaz.
@@ -45,7 +46,7 @@ const local = (hostname) => hostname === "localhost" || hostname === "127.0.0.1"
  */
 export function storeOrigin(input) {
   let value = String(input ?? "").trim().replace(/\/+$/, "");
-  if (!value) throw new Error("Mağaza adresi gerekli (ör. magazam ya da magazam.uvoo.store).");
+  if (!value) throw new Error(t("Mağaza adresi gerekli (ör. magazam ya da magazam.uvoo.store)."));
   if (!/^https?:\/\//i.test(value)) {
     if (!value.includes(".") && !value.includes(":")) value = `${value}.${defaultStoreApex}`;
     value = `${local(value.split(":")[0]) ? "http" : "https"}://${value}`;
@@ -54,10 +55,10 @@ export function storeOrigin(input) {
   try {
     url = new URL(value);
   } catch {
-    throw new Error(`Mağaza adresi okunamadı: ${input}`);
+    throw new Error(t("Mağaza adresi okunamadı: {0}", input));
   }
-  if (url.protocol !== "https:" && !local(url.hostname)) throw new Error("Mağazaya yalnızca https ile bağlanılır.");
-  if (url.username || url.password) throw new Error("Mağaza adresinde kullanıcı adı ya da parola olamaz.");
+  if (url.protocol !== "https:" && !local(url.hostname)) throw new Error(t("Mağazaya yalnızca https ile bağlanılır."));
+  if (url.username || url.password) throw new Error(t("Mağaza adresinde kullanıcı adı ya da parola olamaz."));
   return url.origin;
 }
 
@@ -70,7 +71,7 @@ export function session(storeOption) {
   const origin = storeOption ? storeOrigin(storeOption) : data.current;
   const entry = origin ? data.stores[origin] : null;
   if (!origin || !entry?.token) {
-    throw new Error(storeOption ? `Bu mağaza için giriş yapılmamış: ${origin}\nÖnce: uvako login --store ${storeOption}` : "Giriş yapılmamış. Önce: uvako login --store <mağaza>");
+    throw new Error(storeOption ? t("Bu mağaza için giriş yapılmamış: {0}\nÖnce: uvako login --store {1}", origin, storeOption) : "Giriş yapılmamış. Önce: uvako login --store <mağaza>");
   }
   return { origin, token: entry.token, name: entry.name };
 }