uvako-cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,58 @@
-# Temporary Holding Version
+# uvako-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Uvako tema geliştirme aracı. Node.js 22 ve üzeri gerekir; ek bağımlılığı yoktur.
+
+```bash
+node cli/bin/uvako-cli.js help
+```
+
+## Komutlar
+
+| Komut | Ne yapar |
+|---|---|
+| `uvako-cli theme init <anahtar>` | Yeni tema iskeleti oluşturur (`--name`, `--author`). |
+| `uvako-cli theme check [klasör]` | Temayı denetler: yapı, ayarlar, bölümler, görseller, güvenlik. |
+| `uvako-cli theme package [klasör]` | Denetimden geçen temayı zip paketine çevirir (`--out`). |
+| `uvako-cli version` | Sürümü yazar. |
+
+`check`, hem bağımsız tema klasörlerinde hem platform deposundaki temalarda (`themes/<anahtar>`) çalışır;
+depodayken stil ve görselleri `frontend/storefront` altındaki yerlerinden okur. Hata varsa çıkış kodu 1'dir.
+
+## Tema paketi
+
+Tema kod içermez. Paket şunlardan oluşur:
+
+```
+theme.json                     kimlik: key, name, version
+config/settings_schema.json    panelde görünen ayarlar
+config/settings_data.json      ayarların varsayılan değerleri
+config/sections.json           ana sayfa bölüm türleri
+templates/index.json           ana sayfadaki bölüm sırası
+styles/                        SCSS (renk / yazı tipi değişkenleri ve temaya özgü kurallar)
+assets/                        logo, slayt ve banner görselleri, yazı tipleri
+```
+
+## Güvenlik kuralları
+
+`check` şunları reddeder:
+
+- JSON, SCSS/CSS, görsel ve yazı tipi dışındaki her dosya türü (JavaScript, TypeScript, HTML, PHP, çalıştırılabilir dosyalar).
+- `<script>`, `javascript:` adresleri, `onclick` gibi olay öznitelikleri, `<iframe>` (SVG ve ayar metinleri dahil).
+- Kod çalıştıran CSS (`expression`, `behavior`, `-moz-binding`).
+- SCSS içinden yazı tipi sağlayıcıları dışındaki adreslere yapılan çağrılar.
+- Sembolik bağlar, gizli dosyalar, 5 MB'tan büyük dosyalar, 60 MB'tan büyük ya da 600 dosyadan fazla paketler.
+- Gizli anahtar ya da parola gibi görünen değerler.
+
+Araç platformun kaynak kodunu içermez ve ağa bağlanmaz.
+
+## Henüz olmayanlar
+
+Yerel önizleme (`theme dev`) ve mağazaya yükleme (`login`, `theme push`, `theme pull`) yoktur. Bunlar
+platformda tema yükleme uç noktası ve paket biçimindeki temaların vitrinde çizilmesini gerektirir;
+tasarım `docs/uvako-cli.md` dosyasındadır.
+
+## Test
+
+```bash
+node --test
+```

package/bin/uvako-cli.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { main } from "../src/main.js";
+
+main(process.argv.slice(2)).then(
+  (code) => process.exit(code),
+  (error) => {
+    console.error(`Hata: ${error?.message ?? error}`);
+    process.exit(1);
+  },
+);

package/package.json

@@ -1,6 +1,22 @@
 {
   "name": "uvako-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Uvako tema geliştirme aracı: tema başlat, denetle, paketle.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "bin": {
+    "uvako-cli": "bin/uvako-cli.js",
+    "uvako": "bin/uvako-cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "test": "node --test"
+  }
+}

package/src/check.js

@@ -0,0 +1,213 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { walk } from "./files.js";
+
+// Tema paketinin denetimi. Kurallar platformun tema yükleyicisiyle (backend/internal/theme) aynı
+// yapıyı arar; üstüne güvenlik kuralları eklenir: tema kod çalıştıramaz, dışarıdan betik çağıramaz.
+
+export const limits = { fileBytes: 5 * 1024 * 1024, totalBytes: 60 * 1024 * 1024, files: 600 };
+
+const keyPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const versionPattern = /^\d+\.\d+\.\d+$/;
+
+// Pakette bulunabilecek dosya türleri. Betik, şablon ve çalıştırılabilir dosyalar yoktur.
+const allowedExtensions = new Set([
+  ".json", ".scss", ".css", ".md", ".txt",
+  ".png", ".jpg", ".jpeg", ".webp", ".avif", ".gif", ".svg", ".ico",
+  ".woff", ".woff2", ".ttf", ".otf", ".eot",
+]);
+
+// SCSS içinden çağrılabilecek dış adresler (yazı tipleri).
+const allowedStyleHosts = new Set(["fonts.googleapis.com", "fonts.gstatic.com", "fonts.bunny.net"]);
+
+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/i, text: "gömülü içerik etiketi" },
+];
+
+const secretPatterns = [
+  /-----BEGIN [A-Z ]*PRIVATE KEY-----/,
+  /\b(sk|pk)_(live|test)_[A-Za-z0-9]{16,}\b/,
+  /\bAKIA[0-9A-Z]{16}\b/,
+  // JSON içinde tırnaklar ters eğik çizgiyle kaçışlı olabilir.
+  /\b(api[_-]?key|secret|password|token)\\?["']?\s*[:=]\s*\\?["'][^"'\\]{12,}/i,
+];
+
+function readJson(file, report, label) {
+  if (!existsSync(file)) {
+    report.errors.push(`${label} yok.`);
+    return null;
+  }
+  try {
+    return JSON.parse(readFileSync(file, "utf8").replace(/^/, ""));
+  } catch (error) {
+    report.errors.push(`${label} geçerli JSON değil: ${error.message}`);
+    return null;
+  }
+}
+
+// Şemadaki ayar adlarını toplar ({"type":"tab","values":[{name, settings, group}]}).
+function schemaKeys(node, into, report, trail = "") {
+  if (!node || typeof node !== "object") return;
+  for (const tab of Array.isArray(node.values) ? node.values : []) {
+    if (!tab || typeof tab !== "object") continue;
+    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}).`);
+    }
+    schemaKeys(tab.group, into, report, where);
+  }
+}
+
+/** Platform deposundaki tema mı (themes/<anahtar> + frontend/storefront/...), bağımsız paket mi? */
+function locate(dir) {
+  const key = path.basename(dir);
+  const repo = path.resolve(dir, "..", "..");
+  const storefront = path.join(repo, "frontend", "storefront");
+  if (path.basename(path.dirname(dir)) === "themes" && existsSync(storefront)) {
+    return { layout: "repo", styles: path.join(storefront, "themes", key, "styles"), assets: path.join(storefront, "public", "themes", key, "assets") };
+  }
+  return { layout: "package", styles: path.join(dir, "styles"), assets: path.join(dir, "assets") };
+}
+
+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.`);
+  }
+  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.`);
+  }
+}
+
+function scanStyle(rel, text, report) {
+  if (/expression\s*\(|behavior\s*:|-moz-binding/i.test(text)) report.errors.push(`${rel}: tarayıcıda kod çalıştıran CSS (expression, behavior, -moz-binding) içeriyor.`);
+  if (/javascript:/i.test(text)) report.errors.push(`${rel}: javascript: adresi içeriyor.`);
+  for (const match of text.matchAll(/(?:@import\s+(?:url\()?\s*|url\(\s*)["']?((?:https?:)?\/\/[^"')\s]+)/gi)) {
+    let host = "";
+    try {
+      host = new URL(match[1].startsWith("//") ? `https:${match[1]}` : match[1]).hostname;
+    } catch {
+      host = "?";
+    }
+    if (!allowedStyleHosts.has(host)) report.errors.push(`${rel}: izin verilmeyen dış adres (${host}). Görsel ve yazı tiplerini assets/ altına koyun; yalnızca şu adresler çağrılabilir: ${[...allowedStyleHosts].join(", ")}.`);
+  }
+}
+
+function scanFiles(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 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 (!allowedExtensions.has(ext)) {
+      report.errors.push(`${rel}: bu dosya türü (${ext || "uzantısız"}) temada bulunamaz.`);
+      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 ([".json", ".scss", ".css", ".svg", ".md", ".txt"].includes(ext) && file.size <= limits.fileBytes) {
+      const text = readFileSync(file.full, "utf8");
+      // Ayar verisindeki HTML alanları (alt bilgi menüsü gibi) platformda temizlenir; betik yine de reddedilir.
+      scanText(rel, text, report);
+      if (ext === ".scss" || ext === ".css") scanStyle(rel, text, report);
+    }
+  }
+  return files;
+}
+
+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ı.`);
+    return report;
+  }
+  const where = locate(dir);
+  report.layout = where.layout;
+
+  // ── kimlik ───────────────────────────────────────────────────────────
+  const meta = readJson(path.join(dir, "theme.json"), report, "theme.json");
+  const key = typeof meta?.key === "string" ? meta.key.trim() : "";
+  report.key = key;
+  if (meta) {
+    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 (!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.`);
+  }
+
+  // ── ayar şeması ve değerler ──────────────────────────────────────────
+  const schema = readJson(path.join(dir, "config", "settings_schema.json"), report, "config/settings_schema.json");
+  const known = new Set();
+  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":[…]}).`);
+    schemaKeys(schema.group, known, 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ı.");
+
+  // ── bölümler ve ana sayfa şablonu ────────────────────────────────────
+  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ı.`);
+  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.`);
+    // "keys" isteğe bağlıdır (ayarı olmayan ya da ayarları başka biçimde bağlanan bölümler vardı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ı.`);
+  }
+  const index = readJson(path.join(dir, "templates", "index.json"), report, "templates/index.json (ana sayfa şablonu)");
+  if (index) {
+    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.`);
+    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 (sections && !types.has(section.type)) report.errors.push(`templates/index.json: "${id}" bölümünün türü (${section.type}) config/sections.json içinde yok.`);
+    }
+  }
+
+  // ── dosyalar: tür, boyut, güvenlik ───────────────────────────────────
+  const totals = { files: 0, bytes: 0 };
+  if (where.layout === "package") {
+    const { files } = { files: scanFiles(dir, ".", report, totals) };
+    if (!files.some((file) => file.rel === "styles/theme.scss")) report.warnings.push("styles/theme.scss yok; tema platformun temel stilleriyle görünür.");
+  } else {
+    for (const sub of ["config", "templates"]) scanFiles(path.join(dir, sub), sub, report, totals);
+    scanFiles(where.styles, "styles", report, totals);
+    scanFiles(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")}`);
+  }
+  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}.`);
+
+  // ── ayarlardaki görseller yerinde mi ─────────────────────────────────
+  if (data && typeof data === "object") {
+    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(where.assets, value))) report.errors.push(`config/settings_data.json: "${name}" ayarındaki görsel bulunamadı (assets/${value}).`);
+    }
+  }
+  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}).`);
+  }
+  return report;
+}
+
+export function printReport(report) {
+  const title = report.key ? `${report.key} (${report.layout === "repo" ? "platform deposu" : "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}`);
+}

package/src/files.js

@@ -0,0 +1,24 @@
+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"]);
+
+/** 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) {
+  const files = [];
+  const links = [];
+  const visit = (dir, prefix) => {
+    for (const name of readdirSync(dir).sort()) {
+      if (skipped.has(name)) continue;
+      const full = path.join(dir, name);
+      const rel = prefix ? `${prefix}/${name}` : name;
+      const stat = lstatSync(full);
+      if (stat.isSymbolicLink()) links.push(rel);
+      else if (stat.isDirectory()) visit(full, rel);
+      else if (stat.isFile()) files.push({ rel, full, size: stat.size });
+    }
+  };
+  visit(root, "");
+  return { files, links };
+}

package/src/init.js

@@ -0,0 +1,129 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+
+// Yeni tema iskeleti. Tema kod içermez: ayar şeması, bölüm sırası, SCSS ve görsellerden oluşur.
+const keyPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+
+const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
+
+function logo(name) {
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 240 48" width="240" height="48">
+  <text x="0" y="34" font-family="Georgia, 'Times New Roman', serif" font-size="30" letter-spacing="4" fill="#111111">${name.toUpperCase().replace(/[<>&"']/g, "")}</text>
+</svg>
+`;
+}
+
+export function initTheme(key, { name, author, cwd }) {
+  if (!keyPattern.test(key) || key.length > 40) throw new Error(`Tema anahtarı küçük harf, rakam ve tireden oluşmalı (ör. "atolye"): ${key}`);
+  const dir = path.join(cwd, key);
+  if (existsSync(dir)) throw new Error(`Klasör zaten var: ${dir}`);
+  const title = String(name || key.replace(/(^|-)([a-z])/g, (_, dash, letter) => (dash ? " " : "") + letter.toUpperCase()));
+  const write = (rel, content) => {
+    const file = path.join(dir, rel);
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, content, "utf8");
+  };
+
+  write("theme.json", json({ key, name: title, version: "0.1.0", author: String(author || ""), description: `${title} teması.`, base: "editorial", screenshot: "" }));
+
+  write("config/settings_schema.json", json({
+    theme_version: 2,
+    group: {
+      type: "tab",
+      values: [
+        {
+          name: "Genel Ayarlar",
+          settings: {
+            logo: { type: "image", default_value: "uploads/logo.svg", filename: "logo", label: "Logo", info: "" },
+            color_primary: { type: "color", default_value: "#111111", label: "Ana renk", info: "Düğme ve vurgu rengi." },
+            header_top_bar_text: { type: "text", default_value: "", label: "Üst şerit yazısı", info: "" },
+          },
+        },
+        {
+          name: "Ana Sayfa",
+          settings: {
+            slide_status: { type: "checkbox", default_value: 1, label: "Slaytı göster", info: "" },
+            slider_status_1: { type: "checkbox", default_value: 1, label: "1. slayt açık", info: "" },
+            slider_picture_1: { type: "image", default_value: "", filename: "slider_1", label: "1. slayt görseli", info: "Önerilen: 1920×1080" },
+            slider_title_1: { type: "text", default_value: "", label: "1. slayt başlığı", info: "" },
+            slider_button_1: { type: "text", default_value: "", label: "1. slayt düğme yazısı", info: "" },
+            slider_link_1: { type: "text", default_value: "/search", label: "1. slayt bağlantısı", info: "" },
+            home_products_title: { type: "text", default_value: "Yeni gelenler", label: "Ürün vitrini başlığı", info: "" },
+          },
+        },
+      ],
+    },
+  }));
+
+  write("config/settings_data.json", json({
+    logo: "uploads/logo.svg",
+    color_primary: "#111111",
+    header_top_bar_text: "",
+    slide_status: 1,
+    slider_status_1: 1,
+    slider_title_1: "Yeni koleksiyon",
+    slider_button_1: "Keşfet",
+    slider_link_1: "/search",
+    home_products_title: "Yeni gelenler",
+  }));
+
+  write("config/sections.json", json({
+    sections: {
+      [`${key}-slider`]: { name: "Slayt", icon: "image", keys: ["slide_status", "slider_status_1", "slider_picture_1", "slider_title_1", "slider_button_1", "slider_link_1"] },
+      [`${key}-home-products`]: { name: "Ürün vitrini", icon: "grid", keys: ["home_products_title"] },
+    },
+  }));
+
+  write("templates/index.json", json({
+    order: ["slider", "home_products"],
+    sections: {
+      slider: { type: `${key}-slider`, disabled: false, settings: {} },
+      home_products: { type: `${key}-home-products`, disabled: false, settings: {} },
+    },
+  }));
+
+  write("styles/_tokens.scss", `// Temanın renk ve yazı tipi değişkenleri. Platformun temel stilleri bu değerlerle derlenir.
+$font-family: 'Manrope', sans-serif;
+$font-family-sub: 'Bodoni Moda', 'Times New Roman', serif;
+
+$color-text: #111111;
+$color-sub-text: #6b6b6b;
+$color-border: #e5e5e5;
+$color-background: #ffffff;
+$border-radius: 0;
+`);
+
+  write("styles/theme.scss", `// Temaya özgü kurallar. Bütün seçiciler .theme-${key} altında yazılır.
+@import 'tokens';
+
+.theme-${key} {
+    .products-header span {
+        font-family: $font-family-sub;
+    }
+}
+`);
+
+  write("assets/uploads/logo.svg", logo(title));
+
+  write("README.md", `# ${title}
+
+Uvako teması. Bu klasör kod içermez: ayar şeması, ana sayfa bölüm sırası, SCSS ve görseller.
+
+- \`theme.json\` — kimlik (anahtar, ad, sürüm).
+- \`config/settings_schema.json\` — mağaza sahibinin panelde göreceği ayarlar.
+- \`config/settings_data.json\` — ayarların varsayılan değerleri.
+- \`config/sections.json\` — ana sayfa bölüm türleri ve bağlı ayarları.
+- \`templates/index.json\` — ana sayfadaki bölümlerin sırası.
+- \`styles/\` — renk / yazı tipi değişkenleri ve temaya özgü SCSS.
+- \`assets/\` — logo, slayt ve banner görselleri.
+
+\`\`\`bash
+uvako-cli theme check .
+\`\`\`
+
+\`\`\`bash
+uvako-cli theme package .
+\`\`\`
+`);
+  return dir;
+}

package/src/main.js

@@ -0,0 +1,80 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { checkTheme, printReport } from "./check.js";
+import { initTheme } from "./init.js";
+import { packageTheme } from "./package.js";
+
+const version = JSON.parse(readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8")).version;
+
+const help = `uvako-cli ${version} — Uvako tema geliştirme aracı
+
+Kullanım:
+  uvako-cli theme init <anahtar> [--name "Ad"] [--author "Yazar"]   Yeni tema iskeleti oluşturur
+  uvako-cli theme check [klasör]                                    Temayı denetler (yapı, ayarlar, güvenlik)
+  uvako-cli theme package [klasör] [--out dosya.zip]                Denetleyip yüklenebilir zip paketi üretir
+  uvako-cli version                                                 Sürümü yazar
+
+Tema, kod çalıştırmayan bir pakettir: ayar şeması, bölüm sırası, SCSS ve görseller.
+JavaScript, TypeScript ya da sunucu kodu içeren paketler reddedilir.`;
+
+// "--ad değer" ve "--ad=değer" biçimli seçenekleri ayırır; kalanlar konumsal argümandır.
+export function parseArgs(args) {
+  const options = {};
+  const rest = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (!arg.startsWith("--")) {
+      rest.push(arg);
+      continue;
+    }
+    const [name, inline] = arg.slice(2).split(/=(.*)/s);
+    if (inline !== undefined) options[name] = inline;
+    else if (i + 1 < args.length && !args[i + 1].startsWith("--")) options[name] = args[++i];
+    else options[name] = true;
+  }
+  return { options, rest };
+}
+
+export async function main(argv) {
+  const { options, rest } = parseArgs(argv);
+  const [group, command, target] = rest;
+  if (!group || group === "help" || options.help) {
+    console.log(help);
+    return 0;
+  }
+  if (group === "version" || options.version) {
+    console.log(version);
+    return 0;
+  }
+  if (group !== "theme") {
+    console.error(`Bilinmeyen komut: ${group}\n\n${help}`);
+    return 1;
+  }
+  if (command === "init") {
+    if (!target) throw new Error("Tema anahtarı gerekli: uvako-cli theme init <anahtar>");
+    const dir = initTheme(target, { name: options.name, author: options.author, cwd: process.cwd() });
+    console.log(`Tema oluşturuldu: ${path.relative(process.cwd(), dir) || "."}`);
+    console.log(`Sıradaki adım: uvako-cli theme check ${path.relative(process.cwd(), dir)}`);
+    return 0;
+  }
+  if (command === "check") {
+    const report = checkTheme(path.resolve(target ?? "."));
+    printReport(report);
+    return report.errors.length ? 1 : 0;
+  }
+  if (command === "package") {
+    const result = packageTheme(path.resolve(target ?? "."), { out: typeof options.out === "string" ? options.out : undefined });
+    if (!result.ok) {
+      printReport(result.report);
+      console.error("Paket oluşturulmadı: önce hataları düzeltin.");
+      return 1;
+    }
+    printReport(result.report);
+    console.log(`Paket: ${result.file} (${result.files} dosya, ${(result.bytes / 1024).toFixed(0)} KB)`);
+    console.log(`SHA-256: ${result.sha256}`);
+    return 0;
+  }
+  console.error(`Bilinmeyen tema komutu: ${command ?? "(yok)"}\n\n${help}`);
+  return 1;
+}

package/src/package.js

@@ -0,0 +1,75 @@
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import zlib from "node:zlib";
+import { checkTheme } from "./check.js";
+import { walk } from "./files.js";
+
+// Denetimden geçen temayı zip paketine çevirir. Zip burada yazılır (ek bağımlılık yok); dosya
+// tarihleri sabit tutulur, böylece aynı içerik her zaman aynı SHA-256 özetini verir.
+const DOS_DATE = ((2026 - 1980) << 9) | (1 << 5) | 1;
+
+function zip(entries) {
+  const parts = [];
+  const central = [];
+  let offset = 0;
+  for (const { name, data } of entries) {
+    const nameBytes = Buffer.from(name, "utf8");
+    const compressed = zlib.deflateRawSync(data, { level: 9 });
+    const crc = zlib.crc32(data);
+    const local = Buffer.alloc(30);
+    local.writeUInt32LE(0x04034b50, 0);
+    local.writeUInt16LE(20, 4);
+    local.writeUInt16LE(0x0800, 6); // UTF-8 dosya adları
+    local.writeUInt16LE(8, 8);
+    local.writeUInt16LE(0, 10);
+    local.writeUInt16LE(DOS_DATE, 12);
+    local.writeUInt32LE(crc, 14);
+    local.writeUInt32LE(compressed.length, 18);
+    local.writeUInt32LE(data.length, 22);
+    local.writeUInt16LE(nameBytes.length, 26);
+    parts.push(local, nameBytes, compressed);
+
+    const header = Buffer.alloc(46);
+    header.writeUInt32LE(0x02014b50, 0);
+    header.writeUInt16LE(20, 4);
+    header.writeUInt16LE(20, 6);
+    header.writeUInt16LE(0x0800, 8);
+    header.writeUInt16LE(8, 10);
+    header.writeUInt16LE(0, 12);
+    header.writeUInt16LE(DOS_DATE, 14);
+    header.writeUInt32LE(crc, 16);
+    header.writeUInt32LE(compressed.length, 20);
+    header.writeUInt32LE(data.length, 24);
+    header.writeUInt16LE(nameBytes.length, 28);
+    header.writeUInt32LE(offset, 42);
+    central.push(header, nameBytes);
+    offset += local.length + nameBytes.length + compressed.length;
+  }
+  const centralSize = central.reduce((sum, part) => sum + part.length, 0);
+  const end = Buffer.alloc(22);
+  end.writeUInt32LE(0x06054b50, 0);
+  end.writeUInt16LE(entries.length, 8);
+  end.writeUInt16LE(entries.length, 10);
+  end.writeUInt32LE(centralSize, 12);
+  end.writeUInt32LE(offset, 16);
+  return Buffer.concat([...parts, ...central, end]);
+}
+
+export function packageTheme(dir, { out } = {}) {
+  const report = checkTheme(dir);
+  if (report.errors.length) return { ok: false, report };
+  if (report.layout !== "package") {
+    report.errors.push("Bu klasör platform deposundaki bir tema; paketleme yalnızca bağımsız tema klasörlerinde yapılır.");
+    return { ok: false, report };
+  }
+  const meta = JSON.parse(readFileSync(path.join(dir, "theme.json"), "utf8"));
+  const { files } = walk(dir);
+  const entries = files
+    .filter((file) => !file.rel.endsWith(".zip"))
+    .map((file) => ({ name: `${meta.key}/${file.rel}`, data: readFileSync(file.full) }));
+  const buffer = zip(entries);
+  const file = path.resolve(out ?? path.join(path.dirname(dir), `${meta.key}-${meta.version}.zip`));
+  writeFileSync(file, buffer);
+  return { ok: true, report, file, files: entries.length, bytes: buffer.length, sha256: createHash("sha256").update(buffer).digest("hex") };
+}