uvako-cli 0.5.0 → 0.6.0

package/README.md

@@ -75,6 +75,11 @@ uvako app dev --store <geliştirme mağazası>
 `http://localhost:3000` yapar, o mağazanın webhook'larını bilgisayarınızdaki alıcıya aktarır (imzasıyla) ve
 kurulum bağlantısını yazar. Tünel gerekmez.
 
+Örnek uygulama panele gömülü açılır (`"embedded": true`, `@uvako/app-bridge`, bir dakikalık oturum
+belirteci), `blocks/` klasöründe bir vitrin bloğu taşır ve ücretlendirme API'siyle aylık test ücreti
+oluşturur. `deploy` ve `dev` `blocks/<anahtar>/block.{json,html,css}` dosyalarını yapılandırmayla gönderir;
+blokta kod çalışmaz, sunucu tema paketleriyle aynı kurallarla denetler.
+
 | Komut | Ne yapar |
 |---|---|
 | `uvako login` | Partner hesabıyla cihaz girişi (`--no-browser`: tarayıcıyı açmaz). |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uvako-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Uvako tema ve uygulama geliştirme aracı. Tema başlatır, denetler ve canlı önizletir; herkese açık uygulama başlatır, yerelde çalıştırıp webhook aktarır ve dağıtır. https://uvako.com",
   "type": "module",
   "license": "UNLICENSED",
@@ -49,6 +49,11 @@
     "node": ">=22"
   },
   "scripts": {
+    "rules": "node scripts/generate-theme-rules.js",
+    "pretest": "node scripts/generate-theme-rules.js --check",
     "test": "node --test"
+  },
+  "dependencies": {
+    "sax": "1.6.1"
   }
 }

package/src/api.js

@@ -3,21 +3,22 @@ import { t } from "./i18n.js";
 // gönderilir: yönlendirmeler izlenmez, böylece anahtar başka bir adrese taşınmaz.
 
 export class ApiError extends Error {
-  constructor(message, { status = 0, code = "", problems = [] } = {}) {
+  constructor(message, { status = 0, code = "", problems = [], retryAfter = 0 } = {}) {
     super(message);
     this.status = status;
     this.code = code;
     this.problems = problems;
+    this.retryAfter = retryAfter;
   }
 }
 
-export async function call({ origin, token }, method, route, { body, raw = false, timeout = 120000 } = {}) {
+export async function call({ origin, token }, method, route, { body, raw = false, timeout = 120000, headers = {}, contentType = "application/zip" } = {}) {
   let response;
   try {
     response = await fetch(`${origin}/api/theme-cli${route}`, {
       method,
       redirect: "error",
-      headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "User-Agent": "uvako-cli", ...(body ? { "Content-Type": "application/zip" } : {}) },
+      headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "User-Agent": "uvako-cli", ...(body ? { "Content-Type": contentType } : {}), ...headers },
       body,
       signal: AbortSignal.timeout(timeout),
     });
@@ -33,7 +34,9 @@ export async function call({ origin, token }, method, route, { body, raw = false
   }
   const problem = payload?.error ?? {};
   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 : [] });
+  const retry = response.headers.get("Retry-After") ?? "";
+  const retryAfter = /^\d+$/.test(retry) ? Number(retry) : Math.max(0, Math.ceil((Date.parse(retry) - Date.now()) / 1000)) || 0;
+  throw new ApiError(problem.message || fallback, { status: response.status, code: problem.code || "", problems: Array.isArray(problem.problems) ? problem.problems : [], retryAfter });
 }
 
 /** Herkese açık uç nokta: temel temanın başlangıç ayarları (giriş gerektirmez). */

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/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

@@ -265,6 +265,70 @@ export const en = {
   "{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 and app development tool
@@ -287,22 +351,26 @@ App (public apps, with the partner sign-in):
   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 (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.

package/src/main.js

@@ -6,10 +6,10 @@ import { checkTheme, printReport } from "./check.js";
 import { session, siteOrigin } from "./config.js";
 import { initTheme } from "./init.js";
 import { packageTheme } from "./package.js";
-import { dev, list, login, logout, pull, push, remove, submit, whoami } from "./remote.js";
+import { dev, list, login, logout, pull, push, remoteCheck, remove, submit, whoami } from "./remote.js";
 import { appCommand } from "./app.js";
 import { partnerLogin, partnerLogout, partnerWhoami } from "./partner.js";
-import { getLocale, t } from "./i18n.js";
+import { getLocale, t, tm } from "./i18n.js";
 import { help as helpEn } from "./locales/en.js";
 
 const version = JSON.parse(readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8")).version;
@@ -34,22 +34,26 @@ Uygulama (herkese açık uygulamalar, partner girişiyle):
   uvako app list [--json]                      Kayıtlı uygulamalarınızı listeler
 
 Tema:
-  uvako theme init <anahtar> [--base linea] [--name "Ad"] [--author "Yazar"]
+  uvako theme init <anahtar> [--base linea] [--name "Ad"] [--author "Yazar"] [--engine sections]
                                                Bir katalog temasını temel alan yeni tema iskeleti
-  uvako theme check [klasör]                   Temayı denetler (yapı, ayarlar, güvenlik)
-  uvako theme dev [klasör]                     Canlı geliştirme: kaydettikçe mağazaya yükler, önizleme yenilenir
+                                               --engine sections: kendi bölümlerini getiren tema (örnek bölümlerle)
+  uvako theme check [klasör] [--offline]       Temayı denetler (yapı, ayarlar, güvenlik, bölüm şablonları);
+                                               giriş yapılmışsa sunucu da aynı kurallarla denetler
+  uvako theme dev [klasör]                     Canlı geliştirme: yalnızca değişen dosyayı yükler, önizleme yenilenir
                                                Durdurunca mağaza eski hâline döner (--keep: kütüphanede bırak)
-  uvako theme push [klasör]                    Temayı mağazanın tema kütüphanesine yükler
-  uvako theme pull <anahtar> [--dir klasör]    Yüklediğiniz temayı indirir
+  uvako theme push [klasör] [--force]          Temayı mağazanın tema kütüphanesine yükler (SHA-256 ve revizyonla;
+                                               paket sizden sonra değiştiyse reddedilir, --force üzerine yazar)
+  uvako theme pull <anahtar> [--dir klasör]    Yüklediğiniz temayı indirir (sections/, snippets/, templates/ dahil)
   uvako theme list                             Mağazadaki temaları ve yüklediğiniz paketleri listeler
   uvako theme submit <anahtar>                 Temayı themes.uvako.com için incelemeye gönderir
   uvako theme delete <anahtar> --yes           Yüklediğiniz paketi siler
   uvako theme package [klasör] [--out x.zip]   Denetleyip zip paketi üretir
   uvako version                                Sürümü yazar
 
-Tema, kod çalıştırmayan bir pakettir: ayarlar, bölüm sırası, SCSS ve görseller.
-JavaScript, şablon ya da sunucu kodu içeren paketler reddedilir. Yüklenen tema yalnızca kendi
-mağazanızda görünür; tema mağazasında yayınlanması Uvako incelemesine bağlıdır.
+Tema, kod çalıştırmayan bir pakettir: ayarlar, sayfa şablonları, SCSS ve görseller. "engine": "sections"
+temaları kendi bölümlerini (sections/*.html.tmpl) getirebilir; bunlar yalnızca sunucuda, kısıtlı bir
+şablon dilinde çizilir. JavaScript ya da sunucu kodu içeren paketler reddedilir. Yüklenen tema yalnızca
+kendi mağazanızda görünür; tema mağazasında yayınlanması Uvako incelemesine bağlıdır.
 
 CI için: UVAKO_STORE ve UVAKO_TOKEN (tema), UVAKO_PARTNER_TOKEN (uygulama) ortam değişkenleri girişin yerini tutar.
 Dil: --lang en ya da UVAKO_LANG=en çıktıyı İngilizce verir.
@@ -138,16 +142,33 @@ export async function main(argv) {
   if (command === "init") {
     if (!target) throw new Error(t("Tema anahtarı gerekli: uvako theme init <anahtar>"));
     const base = typeof options.base === "string" ? options.base : "linea";
-    const dir = initTheme(target, { name: options.name, author: options.author, cwd: process.cwd(), base, starter: await fetchStarter(base, options) });
+    const engine = typeof options.engine === "string" ? options.engine : "";
+    const dir = initTheme(target, { name: options.name, author: options.author, cwd: process.cwd(), base, engine, starter: await fetchStarter(base, options) });
     const rel = path.relative(process.cwd(), dir) || ".";
     console.log(t("Tema oluşturuldu: {0} (temel: {1})", rel, base));
     console.log(t("Sıradaki adım: uvako login --store <mağaza>, sonra: uvako theme dev {0}", rel));
     return 0;
   }
   if (command === "check") {
-    const report = checkTheme(path.resolve(target ?? "."));
+    const dir = path.resolve(target ?? ".");
+    const report = checkTheme(dir);
     printReport(report);
-    return report.errors.length ? 1 : 0;
+    if (report.errors.length) return 1;
+    // Giriş yapılmışsa sunucu da aynı paketi kuru olarak denetler: yerelde geçen sunucuda da geçer.
+    if (options.offline || report.layout !== "package") return 0;
+    const remote = await remoteCheck(dir, options);
+    if (!remote) {
+      console.log(t("Sunucu denetimi için giriş yapın (uvako login --store <mağaza>) ya da --offline ekleyin."));
+      return 0;
+    }
+    if (!remote.ok) {
+      console.error(t("✖ Sunucu denetimi ({0}): {1}", remote.origin, tm(remote.message)));
+      for (const problem of remote.problems) console.error(`  ✖ ${tm(problem)}`);
+      return 1;
+    }
+    for (const warning of remote.warnings) console.warn(`  ! ${tm(warning)}`);
+    console.log(t("Sunucu denetimi ({0}): geçti.", remote.origin));
+    return 0;
   }
   if (command === "package") {
     const result = packageTheme(path.resolve(target ?? "."), { out: typeof options.out === "string" ? options.out : undefined });