uvako-cli 0.4.0 → 0.6.0

package/src/check.js

@@ -2,6 +2,9 @@ import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { walk } from "./files.js";
 import { t } from "./i18n.js";
+import { checkSVG } from "./svg.js";
+import { rules } from "./rules.generated.js";
+import { checkPageTemplate, checkSectionSchema, checkSources, platformSchemas, sectionFile, templateTexts } from "./sections.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.
@@ -11,7 +14,8 @@ import { t } from "./i18n.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, localeBytes: 256 * 1024, localeEntries: 2000 };
+// Sınırlar sunucuyla ortaktır (backend/internal/theme/rules/rules.json).
+export const limits = { fileBytes: rules.limits.fileBytes, totalBytes: rules.limits.totalBytes, files: rules.limits.files, styleBytes: rules.limits.styleBytes, archiveBytes: rules.limits.archiveBytes, localeBytes: rules.limits.localeBytes, localeEntries: rules.limits.localeEntries };
 
 // 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.
@@ -135,6 +139,10 @@ function scanText(rel, text, report) {
   for (const { pattern, text: what } of scriptPatterns) {
     if (pattern.test(text)) report.errors.push(t("{0}: {1} içeriyor. Tema içinde betik çalıştırılamaz.", rel, what));
   }
+  scanSecrets(rel, text, report);
+}
+
+function scanSecrets(rel, text, report) {
   for (const pattern of secretPatterns) {
     if (pattern.test(text)) report.errors.push(t("{0}: gizli anahtar ya da parola gibi görünen bir değer içeriyor.", rel));
   }
@@ -260,6 +268,42 @@ function checkImages(data, assets, report) {
   }
 }
 
+// ── bölüm motoru ("engine": "sections") ───────────────────────────────────────────────────────
+
+function checkSectionsEngine({ dir, pages, sectionSchemas, sources, index, legacy, locales, report }) {
+  for (const file of walk(path.join(dir, "styles")).files) {
+    const source = readFileSync(file.full, "utf8");
+    if (/fonts\.googleapis\.com|fonts\.gstatic\.com|fonts\.bunny\.net/.test(source)) report.errors.push(t("styles/{0}: yazı tipleri assets/ içinde pakete gömülmeli.", file.rel));
+  }
+  checkSources(sources, report);
+  const schemas = new Map(platformSchemas);
+  for (const [handle, schema] of Object.entries(sectionSchemas)) {
+    const rel = `sections/${handle}.schema.json`;
+    if (!/^[a-z][a-z0-9_-]{0,63}$/.test(handle)) {
+      report.errors.push(t("{0}: geçersiz bölüm adı.", rel));
+      continue;
+    }
+    checkSectionSchema(rel, schema, report);
+    const kind = platformSchemas.has(handle) ? handle : `pkg:${handle}`;
+    schemas.set(kind, schema);
+    if (kind.startsWith("pkg:") && !(`sections/${handle}.html.tmpl` in sources)) report.errors.push(t("sections/{0}.schema.json: bölümün şablonu (sections/{0}.html.tmpl) yok.", handle));
+    if (schema?.fallback && !platformSchemas.has(schema.fallback) && legacy && !legacy.has(schema.fallback)) report.errors.push(t("sections/{0}.schema.json: \"fallback\" platformda ya da temel temada olan bir bölüm türü olmalı.", handle));
+  }
+  for (const rel of Object.keys(sources)) {
+    const handle = rel.startsWith("sections/") ? rel.slice("sections/".length, -".html.tmpl".length) : "";
+    if (handle && !platformSchemas.has(handle) && !schemas.has(`pkg:${handle}`)) schemas.set(`pkg:${handle}`, { name: handle, settings: [] });
+  }
+  const all = { ...pages, ...(index ? { index } : {}) };
+  for (const [name, tpl] of Object.entries(all)) checkPageTemplate(`templates/${name}.json`, tpl, { schemas, legacy }, report);
+  // Şablonlardaki {{ t "…" }} metinleri: çevirisi olmayan metin yazıldığı gibi gösterilir.
+  const texts = templateTexts(sources);
+  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: şablonlardaki {1} metnin çevirisi yok (ör. \"{2}\").", locale, missing.length, missing[0].slice(0, 60)));
+  }
+}
+
 // ── paket ──────────────────────────────────────────────────────────────────────────────────────
 
 function checkPackage(dir, meta, report) {
@@ -276,6 +320,10 @@ function checkPackage(dir, meta, report) {
   let data = null;
   let index = null;
   const locales = {};
+  // "engine": "sections" dosyaları: sayfa şablonları, bölüm şemaları ve şablon kaynakları.
+  const pages = {};
+  const sectionSchemas = {};
+  const sources = {};
   for (const file of files) {
     const rel = file.rel;
     if (localOnly(rel)) continue;
@@ -314,9 +362,30 @@ function checkPackage(dir, meta, report) {
       }
       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);
+      if (ext === ".svg" && file.size <= limits.fileBytes) {
+        const body = readFileSync(file.full);
+        const problem = checkSVG(body);
+        if (problem) report.errors.push(`${rel}: ${problem}`);
+        scanSecrets(rel, body.toString("utf8"), report);
+      }
+    } else if (sectionFile(rel)) {
+      const kind = sectionFile(rel);
+      if (kind === "source") {
+        sources[rel] = text();
+        continue;
+      }
+      if (file.size > rules.limits.jsonBytes) {
+        report.errors.push(t("{0}: 1 MB sınırını aşıyor.", rel));
+        continue;
+      }
+      const body = text();
+      scanText(rel, body, report);
+      let parsed = null;
+      try { parsed = JSON.parse(body.replace(/^\uFEFF/, "")); } catch (error) { report.errors.push(t("{0} geçerli JSON değil: {1}", rel, error.message)); continue; }
+      if (kind === "template") pages[parts[1].slice(0, -5)] = parsed;
+      else sectionSchemas[parts[1].slice(0, -".schema.json".length)] = parsed;
     } else {
-      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));
+      report.errors.push(t("{0}: bu dosya pakette bulunamaz. İzin verilenler: {1}.", rel, rules.paths.join(", ")));
     }
   }
   if (totals.style > limits.styleBytes) report.errors.push(t("Stil dosyaları toplam {0} KB sınırını aşıyor.", limits.styleBytes / 1024));
@@ -332,7 +401,12 @@ function checkPackage(dir, meta, report) {
   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, t("{0} temasında", base));
+  const legacy = reference?.sections ? new Set(Object.keys(reference.sections)) : null;
+  const engine = String(meta?.engine ?? "").trim();
+  if (meta && !rules.engines.includes(engine)) report.errors.push(t("theme.json: bilinmeyen \"engine\" değeri."));
+  if (engine !== "sections" && (Object.keys(pages).length || Object.keys(sectionSchemas).length || Object.keys(sources).length)) report.errors.push(t("Yeni sayfa ve bölüm dosyaları için theme.json içinde \"engine\":\"sections\" gerekli."));
+  if (engine === "sections") checkSectionsEngine({ dir, pages, sectionSchemas, sources, index, legacy, locales, report });
+  else checkTemplate(index, legacy, report, t("{0} temasında", base));
   checkImages(data, path.join(dir, "assets"), report);
   checkProductTabs(data, report);
   checkTranslations(locales, meta, data, report);

package/src/config.js

@@ -8,6 +8,13 @@ import { t } from "./i18n.js";
 
 export const defaultStoreApex = "uvoo.store";
 export const siteOrigin = () => process.env.UVAKO_SITE_URL || "https://uvako.com";
+/** Partner paneli: `uvako login` (cihaz girişi) ve `uvako app` komutları buraya bağlanır. */
+export const partnerOrigin = () => {
+  const raw = (process.env.UVAKO_PARTNER_URL || "https://partner.uvako.com").replace(/\/+$/, "");
+  const url = new URL(raw);
+  if (url.protocol !== "https:" && !local(url.hostname)) throw new Error(t("Partner paneline yalnızca https ile bağlanılır."));
+  return url.origin;
+};
 
 export function configDir() {
   if (process.env.UVAKO_CONFIG_DIR) return process.env.UVAKO_CONFIG_DIR;
@@ -20,9 +27,13 @@ const file = () => path.join(configDir(), "credentials.json");
 function read() {
   try {
     const data = JSON.parse(readFileSync(file(), "utf8"));
-    return { current: typeof data.current === "string" ? data.current : "", stores: data.stores && typeof data.stores === "object" ? data.stores : {} };
+    return {
+      current: typeof data.current === "string" ? data.current : "",
+      stores: data.stores && typeof data.stores === "object" ? data.stores : {},
+      partner: data.partner && typeof data.partner === "object" ? data.partner : null,
+    };
   } catch {
-    return { current: "", stores: {} };
+    return { current: "", stores: {}, partner: null };
   }
 }
 
@@ -99,3 +110,34 @@ export function sessions() {
 }
 
 export const credentialsPath = () => (existsSync(file()) ? file() : "");
+
+/**
+ * Partner oturumu (uvako app komutları): önce UVAKO_PARTNER_TOKEN (CI), sonra `uvako login` ile
+ * kaydedilen giriş. Anahtar yalnızca girişin yapıldığı partner adresine gönderilir.
+ */
+export function partnerSession() {
+  const origin = partnerOrigin();
+  if (process.env.UVAKO_PARTNER_TOKEN) return { origin, token: process.env.UVAKO_PARTNER_TOKEN.trim(), name: "" };
+  const entry = read().partner;
+  if (!entry?.token || entry.origin !== origin) throw new Error(t("Partner girişi yapılmamış. Önce: uvako login"));
+  return { origin, token: entry.token, name: entry.name ?? "", email: entry.email ?? "" };
+}
+
+export function savePartner(origin, token, name, email) {
+  const data = read();
+  data.partner = { origin, token, name, email, savedAt: new Date().toISOString() };
+  write(data);
+}
+
+export function dropPartner() {
+  const data = read();
+  const had = Boolean(data.partner);
+  data.partner = null;
+  write(data);
+  return had;
+}
+
+export function partnerSaved() {
+  const entry = read().partner;
+  return entry?.token ? { origin: entry.origin, name: entry.name ?? "", email: entry.email ?? "" } : null;
+}

package/src/files.js

@@ -2,7 +2,8 @@ import { lstatSync, readdirSync } from "node:fs";
 import path from "node:path";
 
 // Pakete hiç girmeyen adlar (sürüm kontrolü, bağımlılıklar, işletim sistemi dosyaları).
-const skipped = new Set([".git", "node_modules", ".DS_Store", "Thumbs.db", ".idea", ".vscode"]);
+// .uvako: CLI'ın yerel durumu (son push/pull revizyonu); pakete girmez.
+const skipped = new Set([".git", "node_modules", ".DS_Store", "Thumbs.db", ".idea", ".vscode", ".uvako"]);
 
 /** Klasördeki dosyaları (alt klasörlerle) "a/b.c" biçiminde, sıralı döndürür. Sembolik bağlar ayrıca bildirilir. */
 export function walk(root) {

package/src/init.js

@@ -19,7 +19,8 @@ function logo(name) {
  * `starter` temel temanın ayarlarıdır (platformdan okunur: şema, varsayılanlar, bölüm türleri, ana
  * sayfa şablonu). Verilmezse iskelet şablonsuz kurulur; tema temel temanın bölüm sırasını kullanır.
  */
-export function initTheme(key, { name, author, cwd, base = "linea", starter = null }) {
+export function initTheme(key, { name, author, cwd, base = "linea", starter = null, engine = "" }) {
+  if (engine && engine !== "sections") throw new Error(t("Bilinmeyen tema motoru: {0} (kullanılabilir: sections)", engine));
   if (!keyPattern.test(key) || key.length > 40) throw new Error(t("Tema anahtarı küçük harf, rakam ve tireden oluşmalı (ör. \"atolye\"): {0}", key));
   if (!keyPattern.test(base)) throw new Error(t("Temel tema adı geçersiz: {0}", base));
   const dir = path.join(cwd, key);
@@ -32,12 +33,13 @@ export function initTheme(key, { name, author, cwd, base = "linea", starter = nu
   };
 
   const description = t("{0} teması.", title);
-  write("theme.json", json({ key, name: title, version: "0.1.0", base, author: String(author || ""), description, screenshot: "", industries: [], features: [], price: 0 }));
+  write("theme.json", json({ key, name: title, version: "0.1.0", base, ...(engine ? { engine } : {}), author: String(author || ""), description, screenshot: "", industries: [], features: [], price: 0 }));
 
   // Yalnızca temel temadan farklı olan değerler yazılır; gerisi temel temadan gelir.
   write("config/settings_data.json", json({ logo: "uploads/logo.svg" }));
 
-  if (starter?.template) write("templates/index.json", json(starter.template));
+  if (engine === "sections") writeSections(write, getLocale() === "en");
+  else if (starter?.template) write("templates/index.json", json(starter.template));
   if (starter) {
     // Başvuru dosyaları: pakete girmez. Hangi ayarların ve bölüm türlerinin olduğunu gösterir.
     write("reference/settings_schema.json", json(starter.schema ?? {}));
@@ -49,10 +51,20 @@ export function initTheme(key, { name, author, cwd, base = "linea", starter = nu
 
   // Temanın kendi metinlerinin çevirisi: anahtar temadaki metin, değer o dildeki karşılığıdır.
   // İskelet tek bir örnekle gelir; settings_data.json'a yazdığınız başlık ve buton metinlerini ekleyin.
-  if (en) write("locales/tr.json", json({ [description]: `${title} teması.` }));
-  else write("locales/en.json", json({ [description]: `${title} theme.` }));
+  const extra = engine === "sections" ? sectionTexts(en) : {};
+  if (en) write("locales/tr.json", json({ [description]: `${title} teması.`, ...extra }));
+  else write("locales/en.json", json({ [description]: `${title} theme.`, ...extra }));
 
-  write("styles/_tokens.scss", en ? `// Overrides the base theme's variables: the values you set here spread across the whole theme.
+  if (engine === "sections") write("styles/_tokens.scss", en ? `// Overrides the base theme's variables. Section themes embed their fonts in assets/fonts
+// (KVKK: no font services are called); declare them with @font-face in styles/theme.scss.
+// $font-family: 'Inter', sans-serif;
+// $color-text: #111111;
+` : `// Temel temanın değişkenlerinin üstüne yazılır. Bölüm temaları yazı tiplerini assets/fonts içine
+// gömer (KVKK: yazı tipi servisi çağrılmaz); styles/theme.scss içinde @font-face ile tanımlayın.
+// $font-family: 'Inter', sans-serif;
+// $color-text: #111111;
+`);
+  else write("styles/_tokens.scss", en ? `// Overrides the base theme's variables: the values you set here spread across the whole theme.
 // This file may contain only variable assignments and font @imports.
 //
 // @import url('https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700&display=swap');
@@ -150,3 +162,82 @@ metinleri listeler.
 ${commands}`);
   return dir;
 }
+
+/**
+ * "engine": "sections" iskeleti: ana sayfa ve ürün sayfası şablonları, iki örnek paket bölümü ve
+ * bir ürün kartı snippet'i. Şablonlar sunucuda sandbox içinde çizilir; betik içeremez. Etkileşim
+ * (sepete ekle, yan sepet) platformun data-uvako-* öznitelikleriyle gelir.
+ */
+function writeSections(write, en) {
+  const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
+  write("templates/index.json", json({
+    order: ["hero", "rack"],
+    sections: {
+      hero: { type: "pkg:hero", settings: { title: en ? "Pages that fill up" : "Sayfası dolacak defterler", text: en ? "Pick by paper, binding and size." : "Kâğıdını, cildini ve boyutunu görerek seç.", link: "/search" } },
+      rack: { type: "plate-rack", settings: { title: en ? "Best sellers" : "Bu hafta çok satanlar", source: "popular", limit: 8 } },
+    },
+  }));
+  write("templates/product.json", json({
+    order: ["gallery", "info", "usp", "details", "related"],
+    sections: {
+      gallery: { type: "product-gallery", settings: { layout: "slider", show_thumbnails: true } },
+      info: { type: "product-info", settings: { show_sku: true, show_stock: true, show_unit_price: true } },
+      usp: { type: "pkg:usp", settings: {} },
+      details: { type: "product-details", settings: { show_specs: true } },
+      related: { type: "product-related", settings: { limit: 4 } },
+    },
+  }));
+  write("sections/hero.schema.json", json({
+    name: en ? "Hero" : "Karşılama",
+    fallback: "plate-rack",
+    settings: [
+      { id: "title", type: "text", label: en ? "Title" : "Başlık", default: "" },
+      { id: "text", type: "textarea", label: en ? "Text" : "Metin", default: "" },
+      { id: "link", type: "url", label: en ? "Button link" : "Düğme bağlantısı", default: "/search" },
+      { id: "image", type: "image", label: en ? "Image" : "Görsel", default: "" },
+    ],
+  }));
+  write("sections/hero.html.tmpl", `<section class="hero">
+  <div class="hero-copy">
+    <h1>{{ .section.settings.title }}</h1>
+    {{ with .section.settings.text }}<p>{{ . }}</p>{{ end }}
+    <a class="btn btn-primary" href="{{ default "/search" .section.settings.link }}">{{ t "Ürünlere göz at" }}</a>
+  </div>
+  {{ with .section.settings.image }}<img class="hero-image" src="{{ image_url . }}" alt="">{{ end }}
+  <div class="hero-cards">
+    {{ range .shop.featured }}{{ template "snippets/product-card" . }}{{ end }}
+  </div>
+</section>
+`);
+  write("sections/usp.schema.json", json({
+    name: en ? "Shipping and returns" : "Kargo ve iade",
+    fallback: "product-details",
+    settings: [
+      { id: "shipping", type: "text", label: en ? "Shipping" : "Kargo", default: en ? "Ships today on weekdays before 15:00" : "Hafta içi 15.00'e kadar aynı gün kargoda" },
+      { id: "returns", type: "text", label: en ? "Returns" : "İade", default: en ? "14-day returns" : "14 gün iade" },
+      { id: "show_cart_button", type: "checkbox", label: en ? "Open cart button" : "Sepeti aç düğmesi", default: true },
+    ],
+  }));
+  write("sections/usp.html.tmpl", `<section class="usp">
+  <ul>
+    <li>{{ .section.settings.shipping }}</li>
+    <li>{{ .section.settings.returns }}</li>
+  </ul>
+  {{ if .section.settings.show_cart_button }}<button type="button" class="btn" data-uvako-cart-open>{{ t "Sepeti aç" }}</button>{{ end }}
+</section>
+`);
+  write("snippets/product-card.html.tmpl", `<article class="card">
+  <a href="{{ url_for "product" .handle }}">
+    {{ with .image }}<img src="{{ image_url . }}" alt="" loading="lazy">{{ end }}
+    <h3>{{ .title }}</h3>
+  </a>
+  <p class="price"><strong>{{ money .price }}</strong>{{ with .compare_at_price }} <del>{{ money . }}</del>{{ end }}</p>
+  <button type="button" class="btn" data-uvako-add-to-cart="{{ .handle }}" data-name="{{ .title }}" data-price="{{ .price }}" data-image="{{ .image }}" data-url="{{ url_for "product" .handle }}" data-stock="{{ .stock }}">{{ t "Sepete ekle" }}</button>
+</article>
+`);
+}
+
+/** Örnek bölümlerin {{ t "…" }} metinleri ve karşılıkları (locales/ dosyasına eklenir). */
+export const sectionTexts = (en) => (en
+  ? { "Ürünlere göz at": "Ürünlere göz at", "Sepeti aç": "Sepeti aç", "Sepete ekle": "Sepete ekle" }
+  : { "Ürünlere göz at": "Browse products", "Sepeti aç": "Open cart", "Sepete ekle": "Add to cart" });

package/src/locales/en.js

@@ -191,35 +191,188 @@ export const en = {
   "theme.json: \"name\" gerekli (en çok 60 karakter).": "theme.json: \"name\" is required (60 characters at most).",
   "theme.json: \"base\" katalogdaki bir tema olmalı ({0}).": "theme.json: \"base\" must be a theme in the catalog ({0}).",
   "tema paketi gecersiz: {0}": "the theme package is invalid: {0}",
+  // uvako app ve partner girişi
+  "{0} bir uygulama klasörü değil: {1} bulunamadı. Yeni uygulama için: uvako app init <ad>": "{0} is not an app folder: {1} was not found. For a new app: uvako app init <name>",
+  "yapılandırma bir nesne olmalı.": "the configuration must be an object.",
+  "\"name\" gerekli (en çok 60 karakter).": "\"name\" is required (60 characters at most).",
+  "\"client_id\" 32 karakterlik bir kimlik olmalı (ya da boş).": "\"client_id\" must be a 32-character id (or empty).",
+  "\"application_url\" https:// ile başlayan bir adres olmalı.": "\"application_url\" must be an address starting with https://.",
+  "\"redirect_urls\" https adreslerinden oluşan bir liste olmalı.": "\"redirect_urls\" must be a list of https addresses.",
+  "\"scopes\" kapsam listesi olmalı (ör. [\"read_products\"]).": "\"scopes\" must be a list of scopes (e.g. [\"read_products\"]).",
+  "\"webhooks\" [{\"topics\": [...], \"uri\": \"/webhooks\"}] biçiminde olmalı.": "\"webhooks\" must look like [{\"topics\": [...], \"uri\": \"/webhooks\"}].",
+  "\"privacy_webhooks.{0}\" zorunlu: /webhooks/... yolu ya da https adresi (KVKK/GDPR).": "\"privacy_webhooks.{0}\" is required: a /webhooks/... path or an https address (GDPR).",
+  "\"webhooks\" içinde zorunlu app/uninstalled konusu yok.": "\"webhooks\" lacks the mandatory app/uninstalled topic.",
+  "\"dev.port\" geçerli bir port olmalı.": "\"dev.port\" must be a valid port.",
+  "Uygulama adı gerekli: uvako app init <ad>": "An app name is required: uvako app init <name>",
+  "Uygulama adı harf ya da rakam içermeli.": "The app name must contain letters or numbers.",
+  "Klasörde zaten bir uygulama var: {0}": "There is already an app in the folder: {0}",
+  "askıda": "suspended",
+  "taslak": "draft",
+  "incelemede": "in review",
+  "yayında": "live",
+  "reddedildi": "rejected",
+  "Uygulama kaydedildi: {0} (client_id {1})": "App registered: {0} (client_id {1})",
+  "Dağıtıldı: {0} sürüm {1}": "Deployed: {0} version {1}",
+  "Değişiklik yok: {0} sürüm {1}": "No changes: {0} version {1}",
+  "Durum: {0}{1}": "Status: {0}{1}",
+  " · mağazalardaki sürüm {0}": " · version in stores {0}",
+  "Bu sürüm yalnızca kendi geliştirme mağazalarınızda geçerli. Herkese açmak için: uvako app submit": "This version applies only to your own development stores. To make it public: uvako app submit",
+  "Uygulama henüz kayıtlı değil. Önce: uvako app deploy": "The app is not registered yet. First: uvako app deploy",
+  "İncelemeye gönderildi: {0} sürüm {1}. Uvako onayladığında tüm mağazalar bu sürümü kurabilir.": "Submitted for review: {0} version {1}. Once Uvako approves it, every store can install this version.",
+  "Kayıtlı uygulamanız yok. Başlamak için: uvako app init <ad>": "You have no registered apps. To start: uvako app init <name>",
+  "sürüm {0}": "version {0}",
+  "{0} kurulum": "{0} installs",
+  "ulaşılamadı ({0})": "unreachable ({0})",
+  "[{0}] {1} → {2} {3} ({4} ms)": "[{0}] {1} → {2} {3} ({4} ms)",
+  "Geçersiz port: {0}": "Invalid port: {0}",
+  "Yapılandırma dağıtıldı: sürüm {0} (yalnızca kendi mağazalarınızda)": "Configuration deployed: version {0} (only on your own stores)",
+  "Uygulama henüz kayıtlı değil. --no-update olmadan çalıştırın ya da: uvako app deploy": "The app is not registered yet. Run without --no-update or: uvako app deploy",
+  "Hangi mağazada geliştireceğinizi seçin: --store <mağaza>": "Choose the store to develop on: --store <store>",
+  "Partner hesabınızda geliştirme mağazası yok. partner.uvako.com → Mağazalar → Geliştirme mağazası aç.": "Your partner account has no development store. partner.uvako.com → Stores → Open a development store.",
+  "! Yerel uygulama {0} koduyla kapandı.": "! The local app exited with code {0}.",
+  "\nGeliştirme: {0} → {1} ({2})": "\nDevelopment: {0} → {1} ({2})",
+  "Yerel uygulama: {0}": "Local app: {0}",
+  "Kur / aç:       {0}": "Install / open: {0}",
+  "Bu mağazada uygulamanın adresi yerel adres oldu ve webhook'ları buraya aktarılıyor. Durdurmak için Ctrl+C.\n": "In this store the app now points to the local address and its webhooks are relayed here. Press Ctrl+C to stop.\n",
+  "\nGeliştirme durdu. Mağaza dağıtılan adresleri kullanıyor; webhook'lar yeniden internetten gidiyor.": "\nDevelopment stopped. The store uses the deployed addresses again; webhooks go over the internet again.",
+  "[{0}] ! Partner paneline ulaşılamadı: {1}": "[{0}] ! Could not reach the partner panel: {1}",
+  "Uygulama oluşturuldu: {0}": "App created: {0}",
+  "Uvako'ya kaydedildi: client_id {0}": "Registered with Uvako: client_id {0}",
+  "Henüz kayıtlı değil (giriş yok ya da --offline). Kayıt için: uvako login, sonra uvako app deploy {0}": "Not registered yet (not signed in or --offline). To register: uvako login, then uvako app deploy {0}",
+  "Sıradaki adım: cd {0} && uvako app dev --store <geliştirme mağazası>": "Next step: cd {0} && uvako app dev --store <development store>",
+  "Partner paneline bağlanılamadı ({0}): {1}": "Could not connect to the partner panel ({0}): {1}",
+  "Bu adreste Uvako partner uç noktası yok (UVAKO_PARTNER_URL?).": "There is no Uvako partner endpoint at this address (UVAKO_PARTNER_URL?).",
+  "  Yeniden giriş yapın: uvako login": "  Sign in again: uvako login",
+  "Sunucu beklenmeyen bir doğrulama adresi verdi: {0}": "The server gave an unexpected verification address: {0}",
+  "Partner paneline giriş: tarayıcıda açılan sayfada kodu onaylayın.": "Partner sign-in: approve the code on the page that opens in your browser.",
+  "  Adres: {0}": "  Address: {0}",
+  "  Kod:   {0}\n": "  Code:    {0}\n",
+  "Giriş yapıldı: {0} ({1}) — {2}": "Signed in: {0} ({1}) — {2}",
+  "! Partner başvurunuz henüz onaylanmadı; uygulama kaydı onaydan sonra açılır.": "! Your partner application is not approved yet; app registration opens after approval.",
+  "✖ Giriş kodunun süresi doldu. `uvako login` komutunu yeniden çalıştırın.": "✖ The sign-in code expired. Run `uvako login` again.",
+  "Kayıtlı partner girişi yok.": "No saved partner sign-in.",
+  "Partner girişinden çıkıldı: {0}": "Signed out of the partner account: {0}",
+  "Partner: {0} — {1} ({2})": "Partner: {0} — {1} ({2})",
+  "Partner: {0}": "Partner: {0}",
+  "Partner paneline yalnızca https ile bağlanılır.": "The partner panel is reached over https only.",
+  "Partner girişi yapılmamış. Önce: uvako login": "Not signed in to a partner account. First: uvako login",
+  "Bilinmeyen uygulama komutu: {0}\n\n{1}": "Unknown app command: {0}\n\n{1}",
+  // Vitrin blokları (uvako app)
+  "{0}: bilinmeyen dosya {1}. Blokta yalnızca block.json, block.html ve block.css olabilir.": "{0}: unknown file {1}. A block may only contain block.json, block.html and block.css.",
+  "{0}: klasör adı küçük harf, rakam ve tire olmalı.": "{0}: the folder name must be lower-case letters, digits and hyphens.",
+  "{0}: block.html boş.": "{0}: block.html is empty.",
+  "{0}: blokta betik çalıştırılamaz (<script>, onclick=, javascript:).": "{0}: a block cannot run scripts (<script>, onclick=, javascript:).",
+  "{0}: şablonda yalnızca {{ .settings.ad }} ve if/else kullanılabilir.": "{0}: the template may only use {{ .settings.name }} and if/else.",
+  "{0}: block.css içinde url() ve @import kullanılamaz.": "{0}: block.css cannot use url() or @import.",
+  "{0}: block.json \"settings\" bir liste olmalı.": "{0}: block.json \"settings\" must be a list.",
+  // Bölüm motoru ("engine": "sections"), sunucu denetimi, push revizyonu.
+  "styles/{0}: yazı tipleri assets/ içinde pakete gömülmeli.": "styles/{0}: fonts must be embedded in the package under assets/.",
+  "{0}: geçersiz bölüm adı.": "{0}: invalid section name.",
+  "sections/{0}.schema.json: bölümün şablonu (sections/{0}.html.tmpl) yok.": "sections/{0}.schema.json: the section has no template (sections/{0}.html.tmpl).",
+  "sections/{0}.schema.json: \"fallback\" platformda ya da temel temada olan bir bölüm türü olmalı.": "sections/{0}.schema.json: \"fallback\" must be a section type of the platform or the base theme.",
+  "locales/{0}.json: şablonlardaki {1} metnin çevirisi yok (ör. \"{2}\").": "locales/{0}.json: {1} texts in the templates have no translation (e.g. \"{2}\").",
+  "{0}: bu dosya pakette bulunamaz. İzin verilenler: {1}.": "{0}: this file cannot be in a package. Allowed: {1}.",
+  "theme.json: bilinmeyen \"engine\" değeri.": "theme.json: unknown \"engine\" value.",
+  "Yeni sayfa ve bölüm dosyaları için theme.json içinde \"engine\":\"sections\" gerekli.": "Page and section files need \"engine\":\"sections\" in theme.json.",
+  "Bilinmeyen tema motoru: {0} (kullanılabilir: sections)": "Unknown theme engine: {0} (available: sections)",
+  "Sunucu denetimi için giriş yapın (uvako login --store <mağaza>) ya da --offline ekleyin.": "Log in to check on the server too (uvako login --store <store>), or add --offline.",
+  "✖ Sunucu denetimi ({0}): {1}": "✖ Server check ({0}): {1}",
+  "Sunucu denetimi ({0}): geçti.": "Server check ({0}): passed.",
+  "  Yükleme sınırı aşıldı. {0} saniye sonra tekrar deneyin.": "  Upload limit reached. Try again in {0} seconds.",
+  "  Sunucudaki sürümü almak için: uvako theme pull <anahtar> --force. Üzerine yazmak için: uvako theme push --force": "  To get the server's version: uvako theme pull <key> --force. To overwrite it: uvako theme push --force",
+  "Sunucu denetimi yapılamadı: {0}": "The server check could not run: {0}",
+  "kapanmamış şablon aksiyonu": "unterminated template action",
+  "izin verilmeyen öznitelik: {0}": "attribute not allowed: {0}",
+  "{0} içinde izin verilmeyen adres şeması": "URL scheme not allowed in {0}",
+  "srcset içinde izin verilmeyen adres şeması": "URL scheme not allowed in srcset",
+  "style özniteliğinde izin verilmeyen ifade: {0}": "expression not allowed in the style attribute: {0}",
+  "kapanmamış HTML yorumu": "unterminated HTML comment",
+  "işaretleme bildirimi kullanılamaz": "markup declarations are not allowed",
+  "şablon aksiyonu etiket adı oluşturamaz": "a template action cannot form a tag name",
+  "izin verilmeyen etiket: {0}": "element not allowed: {0}",
+  "kapanmamış etiket: {0}": "unterminated tag: {0}",
+  "şablon aksiyonu öznitelik adı oluşturamaz": "a template action cannot form an attribute name",
+  "{0} etiketinde kapanmamış öznitelik değeri": "unterminated attribute value on {0}",
+  "izin verilmeyen aksiyon: {0}": "action not allowed: {0}",
+  "bilinmeyen fonksiyon: {0}": "unknown function: {0}",
+  "{0} yalnızca paketin snippets/ şablonlarını adlandırabilir: {1}": "{0} may only name the package's snippets/ templates: {1}",
+  "snippet bulunamadı: {0}": "snippet not found: {0}",
+  "Pakette en çok 128 bölüm şablonu olabilir.": "A package may contain at most 128 section templates.",
+  "{0}: şablon adında yalnızca küçük harf, rakam, tire ve alt çizgi olabilir.": "{0}: a template name may contain only lowercase letters, digits, hyphens and underscores.",
+  "{0}: platform bölümünün adı kullanılamaz; başka bir ad verin.": "{0}: the name of a platform section cannot be used; choose another name.",
+  "{0}: bölüm ayar şeması geçersiz ({1}).": "{0}: invalid section setting schema ({1}).",
+  "nesne olmalı": "must be an object",
+  "\"name\" gerekli, en çok 100 karakter": "\"name\" is required, at most 100 characters",
+  "\"settings\" en çok {0} ayarlık bir liste olmalı": "\"settings\" must be a list of at most {0} settings",
+  "\"fallback\" bir bölüm türü olmalı": "\"fallback\" must be a section type",
+  "\"{0}\" ayar adı geçersiz ya da tekrarlı": "setting name \"{0}\" is invalid or repeated",
+  "\"{0}\" ayarının \"label\" alanı gerekli": "setting \"{0}\" needs a \"label\"",
+  "\"{0}\" ayarının türü ({1}) bilinmiyor; kullanılabilir: {2}": "setting \"{0}\" has an unknown type ({1}); available: {2}",
+  "\"{0}\" ayarının min/max değerleri geçersiz": "setting \"{0}\" has invalid min/max values",
+  "\"{0}\" ayarının step değeri geçersiz": "setting \"{0}\" has an invalid step",
+  "\"{0}\" (range) için min ve max gerekli": "\"{0}\" (range) needs min and max",
+  "\"{0}\" (select) için 1-50 seçenek gerekli": "\"{0}\" (select) needs 1-50 options",
+  "\"{0}\" ayarının seçenekleri geçersiz": "setting \"{0}\" has invalid options",
+  "\"{0}\" ayarının varsayılan değeri türüne uymuyor": "the default of setting \"{0}\" does not match its type",
+  "geçerli bir şablon değil ({\"order\": […], \"sections\": {…}}).": "not a valid template ({\"order\": […], \"sections\": {…}}).",
+  "en çok 100 bölüm olabilir.": "may contain at most 100 sections.",
+  "\"{0}\" bölüm kimliği geçersiz ya da tekrarlı.": "section id \"{0}\" is invalid or repeated.",
+  "\"order\" içindeki \"{0}\" bölümü \"sections\" altında yok.": "section \"{0}\" in \"order\" is not under \"sections\".",
+  "\"{0}\" bölüm kimliği geçersiz.": "section id \"{0}\" is invalid.",
+  "\"{0}\" bölümünün türü ({1}) ne platformda ne pakette ne de temel temada var.": "the type of section \"{0}\" ({1}) is neither a platform, package nor base theme section.",
+  "\"{0}\" bölümünün türü ({1}) pakette yok: sections/{2}.html.tmpl ekleyin.": "the type of section \"{0}\" ({1}) is not in the package: add sections/{2}.html.tmpl.",
+  "\"{0}\" bölümünün \"{1}\" ayarı betik ya da izin verilmeyen bir değer içeriyor.": "setting \"{1}\" of section \"{0}\" contains a script or a value that is not allowed.",
+  "\"{0}\" bölümünün \"{1}\" ayarı şemada yok ya da türüne uymuyor.": "setting \"{1}\" of section \"{0}\" is not in the schema or does not match its type.",
+  "Bu mağazada bölüm motoru etkin değil.": "The section engine is not enabled for this store.",
+  "Paket sunucuda sizin kopyanızdan sonra değişti. `uvako theme pull` ile güncelleyin ya da --force ile üzerine yazın.": "The package changed on the server after your copy. Update with `uvako theme pull` or overwrite with --force.",
+  "Paket yolda bozuldu (SHA-256 uyuşmuyor). Tekrar deneyin.": "The package was damaged in transit (SHA-256 mismatch). Try again.",
+  "Tema yükleme sınırı aşıldı. Belirtilen süre sonra tekrar deneyin.": "Theme upload limit reached. Try again after the given time.",
+  "Dosya boyut sınırını aşıyor.": "The file exceeds the size limit.",
+  "Bölüm şablonları derlenemedi: {0}": "Section templates could not be compiled: {0}",
 };
 
-export const help = (version) => `uvako-cli ${version} — Uvako theme development tool
+export const help = (version) => `uvako-cli ${version} — Uvako theme and app development tool
 https://uvako.com
 
 Sign-in:
+  uvako login                                  Signs in with your partner account (approved in the browser; app commands)
   uvako login --store <store>                  Connects to the store with a theme access key (you are asked for the key)
-  uvako logout [--store <store>]               Deletes the saved sign-in
-  uvako whoami                                 Shows the connected store
+  uvako logout [--store <store>] [--partner]   Deletes the saved sign-in
+  uvako whoami                                 Shows the connected store and the partner sign-in
+
+App (public apps, with the partner sign-in):
+  uvako app init <name> [--dir folder] [--offline]
+                                               A sample app (OAuth install, signed webhooks) and uvako.app.json
+  uvako app dev [folder] --store <store> [--port 3000] [--no-serve] [--no-update]
+                                               Runs the app locally; the development store points to the local address
+                                               and its webhooks are relayed to the receiver on your computer
+  uvako app deploy [folder] [--submit]         Deploys uvako.app.json as a new version (first only on your own stores)
+  uvako app submit [folder]                    Submits the app for Uvako review so every store can install it
+  uvako app list [--json]                      Lists your registered apps
 
 Theme:
-  uvako theme init <key> [--base linea] [--name "Name"] [--author "Author"]
+  uvako theme init <key> [--base linea] [--name "Name"] [--author "Author"] [--engine sections]
                                                A new theme scaffold built on a catalog theme
-  uvako theme check [folder]                   Checks the theme (structure, settings, translations, security)
-  uvako theme dev [folder]                     Live development: uploads to the store as you save, the preview refreshes
+                                               --engine sections: a theme that brings its own sections (with examples)
+  uvako theme check [folder] [--offline]       Checks the theme (structure, settings, translations, security, section templates);
+                                               when you are logged in the server checks it with the same rules too
+  uvako theme dev [folder]                     Live development: uploads only the file you changed, the preview refreshes
                                                The store returns to its previous state when you stop (--keep: leave in library)
-  uvako theme push [folder]                    Uploads the theme to the store's theme library
-  uvako theme pull <key> [--dir folder]        Downloads a theme you uploaded
+  uvako theme push [folder] [--force]          Uploads the theme to the store's theme library (with SHA-256 and revision;
+                                               refused if the package changed after your copy, --force overwrites)
+  uvako theme pull <key> [--dir folder]        Downloads a theme you uploaded (including sections/, snippets/, templates/)
   uvako theme list                             Lists the themes in the store and the packages you uploaded
   uvako theme submit <key>                     Submits the theme for review for themes.uvako.com
   uvako theme delete <key> --yes               Deletes a package you uploaded
   uvako theme package [folder] [--out x.zip]   Checks the theme and builds a zip package
   uvako version                                Prints the version
 
-A theme is a package that runs no code: settings, section order, SCSS and images.
-Packages containing JavaScript, templates or server code are rejected. An uploaded theme is
-visible only in your own store; publishing it in the theme store depends on Uvako's review.
+A theme is a package that runs no code: settings, page templates, SCSS and images. "engine": "sections"
+themes may bring their own sections (sections/*.html.tmpl); they are drawn only on the server, in a
+restricted template language. Packages containing JavaScript or server code are rejected. An uploaded
+theme is visible only in your own store; publishing it in the theme store depends on Uvako's review.
 
-For CI: the UVAKO_STORE and UVAKO_TOKEN environment variables take the place of signing in.
+For CI: the UVAKO_STORE and UVAKO_TOKEN (theme) and UVAKO_PARTNER_TOKEN (app) environment variables take the place of signing in.
 Language: --lang tr or UVAKO_LANG=tr prints the output in Turkish.
 
 Uvako — https://uvako.com