jskelet 0.6.1 → 0.6.3

package/src/version.mjs

@@ -1,31 +1,31 @@
-/**
- * Framework sürümü. `package.json`'dan okunur; paket bir kez yayınlandıktan
- * sonra sürümü iki yerde tutmak kaçınılmaz olarak birbirinden ayrılıyor.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { FRAMEWORK_ROOT } from "./config/index.js";
-
-const manifest = (() => {
-  try {
-    const file = path.join(FRAMEWORK_ROOT, "package.json");
-    return JSON.parse(fs.readFileSync(file, "utf8"));
-  } catch {
-    return {};
-  }
-})();
-
-/** @type {string} */
-export const FRAMEWORK_VERSION = manifest.version ?? "0.0.0";
-
-/** Paket adı: sürüm kontrolü hangi kayıt defteri girdisine bakacağını buradan bilir. */
-export const FRAMEWORK_PACKAGE = manifest.name ?? "jskelet";
-
-/** Künye alanları: yönetim panelinin footer'ı bunları basıyor. */
-export const FRAMEWORK_LICENSE = manifest.license ?? "MIT";
-
-/** @type {string} */
-export const FRAMEWORK_NODE_RANGE = manifest.engines?.node ?? "";
-
-/** @type {string} */
-export const FRAMEWORK_HOMEPAGE = manifest.homepage ?? "";
+/**
+ * Framework sürümü. `package.json`'dan okunur; paket bir kez yayınlandıktan
+ * sonra sürümü iki yerde tutmak kaçınılmaz olarak birbirinden ayrılıyor.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { FRAMEWORK_ROOT } from "./config/index.js";
+
+const manifest = (() => {
+  try {
+    const file = path.join(FRAMEWORK_ROOT, "package.json");
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+  } catch {
+    return {};
+  }
+})();
+
+/** @type {string} */
+export const FRAMEWORK_VERSION = manifest.version ?? "0.0.0";
+
+/** Paket adı: sürüm kontrolü hangi kayıt defteri girdisine bakacağını buradan bilir. */
+export const FRAMEWORK_PACKAGE = manifest.name ?? "jskelet";
+
+/** Künye alanları: yönetim panelinin footer'ı bunları basıyor. */
+export const FRAMEWORK_LICENSE = manifest.license ?? "MIT";
+
+/** @type {string} */
+export const FRAMEWORK_NODE_RANGE = manifest.engines?.node ?? "";
+
+/** @type {string} */
+export const FRAMEWORK_HOMEPAGE = manifest.homepage ?? "";

package/src/views/components/loader.js

@@ -1,101 +1,101 @@
-/**
- * `views/components/**` (ve feature/shared köklerindeki eşleri) altındaki
- * tüm modülleri yükler ve named export'larını tek bir nesnede birleştirir.
- *
- * Elle bakılan bir barrel dosyası yok: yeni bir bileşen eklemek için dosyayı
- * oluşturmak yeterli.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-
-/** Bileşen olmayan altyapı dosyaları. */
-const SKIP_FILES = new Set(["loader.js", "index.js"]);
-
-/**
- * Barrel önce, en düşük öncelikle yüklenir: tek amacı `lib/` yeniden
- * ihraçlarını şablon local'i yapmak. Bileşenlerin kendi dosyaları sonradan
- * gelip sessizce üzerine yazar.
- */
-const BARREL = "index.js";
-
-/**
- * @param {string} dir
- * @param {string[]} [out]
- * @returns {string[]}
- */
-function collect(dir, out = []) {
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-
-    if (entry.isDirectory()) {
-      collect(full, out);
-      continue;
-    }
-
-    if (!entry.name.endsWith(".js")) continue;
-    if (SKIP_FILES.has(entry.name)) continue;
-
-    out.push(full);
-  }
-
-  return out;
-}
-
-/**
- * Tek bir `components/` dizinini yükler.
- *
- * @param {string} dir
- * @param {Record<string, unknown>} components
- * @param {Map<string, string>} origin
- * @returns {Promise<void>}
- */
-async function loadDir(dir, components, origin) {
-  if (!dir || !fs.existsSync(dir)) return;
-
-  const barrel = path.join(dir, BARREL);
-  const files = [
-    ...(fs.existsSync(barrel) ? [barrel] : []),
-    ...collect(dir).sort(),
-  ];
-
-  for (const file of files) {
-    const isBarrel = path.basename(file) === BARREL;
-    // Kimlik mutlak yol — çoklu components kökünde göreli ad çakışmasın.
-    const fileId = isBarrel ? BARREL : file.split(path.sep).join("/");
-    const module = await import(pathToFileURL(file).href);
-
-    for (const [name, value] of Object.entries(module)) {
-      if (name === "default") continue;
-
-      const previous = origin.get(name);
-      // Barrel üzerine yazmak bilinçli; iki gerçek bileşen dosyası çakışması hata.
-      if (previous && previous !== BARREL && previous !== fileId) {
-        throw new Error(
-          `[components] '${name}' is defined twice: ${previous} and ${fileId}`,
-        );
-      }
-
-      components[name] = value;
-      origin.set(name, fileId);
-    }
-  }
-}
-
-/**
- * @param {string | string[]} dirs Tek dizin veya çoklu kök (feature/shared).
- * @returns {Promise<Record<string, unknown>>}
- */
-export async function loadComponents(dirs) {
-  /** @type {Record<string, unknown>} */
-  const components = {};
-  /** @type {Map<string, string>} */
-  const origin = new Map();
-
-  const list = Array.isArray(dirs) ? dirs : [dirs];
-  for (const dir of list) {
-    await loadDir(dir, components, origin);
-  }
-
-  return components;
-}
+/**
+ * `views/components/**` (ve feature/shared köklerindeki eşleri) altındaki
+ * tüm modülleri yükler ve named export'larını tek bir nesnede birleştirir.
+ *
+ * Elle bakılan bir barrel dosyası yok: yeni bir bileşen eklemek için dosyayı
+ * oluşturmak yeterli.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+/** Bileşen olmayan altyapı dosyaları. */
+const SKIP_FILES = new Set(["loader.js", "index.js"]);
+
+/**
+ * Barrel önce, en düşük öncelikle yüklenir: tek amacı `lib/` yeniden
+ * ihraçlarını şablon local'i yapmak. Bileşenlerin kendi dosyaları sonradan
+ * gelip sessizce üzerine yazar.
+ */
+const BARREL = "index.js";
+
+/**
+ * @param {string} dir
+ * @param {string[]} [out]
+ * @returns {string[]}
+ */
+function collect(dir, out = []) {
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+
+    if (entry.isDirectory()) {
+      collect(full, out);
+      continue;
+    }
+
+    if (!entry.name.endsWith(".js")) continue;
+    if (SKIP_FILES.has(entry.name)) continue;
+
+    out.push(full);
+  }
+
+  return out;
+}
+
+/**
+ * Tek bir `components/` dizinini yükler.
+ *
+ * @param {string} dir
+ * @param {Record<string, unknown>} components
+ * @param {Map<string, string>} origin
+ * @returns {Promise<void>}
+ */
+async function loadDir(dir, components, origin) {
+  if (!dir || !fs.existsSync(dir)) return;
+
+  const barrel = path.join(dir, BARREL);
+  const files = [
+    ...(fs.existsSync(barrel) ? [barrel] : []),
+    ...collect(dir).sort(),
+  ];
+
+  for (const file of files) {
+    const isBarrel = path.basename(file) === BARREL;
+    // Kimlik mutlak yol — çoklu components kökünde göreli ad çakışmasın.
+    const fileId = isBarrel ? BARREL : file.split(path.sep).join("/");
+    const module = await import(pathToFileURL(file).href);
+
+    for (const [name, value] of Object.entries(module)) {
+      if (name === "default") continue;
+
+      const previous = origin.get(name);
+      // Barrel üzerine yazmak bilinçli; iki gerçek bileşen dosyası çakışması hata.
+      if (previous && previous !== BARREL && previous !== fileId) {
+        throw new Error(
+          `[components] '${name}' is defined twice: ${previous} and ${fileId}`,
+        );
+      }
+
+      components[name] = value;
+      origin.set(name, fileId);
+    }
+  }
+}
+
+/**
+ * @param {string | string[]} dirs Tek dizin veya çoklu kök (feature/shared).
+ * @returns {Promise<Record<string, unknown>>}
+ */
+export async function loadComponents(dirs) {
+  /** @type {Record<string, unknown>} */
+  const components = {};
+  /** @type {Map<string, string>} */
+  const origin = new Map();
+
+  const list = Array.isArray(dirs) ? dirs : [dirs];
+  for (const dir of list) {
+    await loadDir(dir, components, origin);
+  }
+
+  return components;
+}

package/src/views/helpers/html.js

@@ -1,102 +1,102 @@
-/** HTML üretimi için ortak yardımcılar (React'in kaçış davranışının karşılığı). */
-import { twMerge } from "tailwind-merge";
-
-const ESCAPE_MAP = {
-  "&": "&",
-  "<": "&lt;",
-  ">": "&gt;",
-  '"': "&quot;",
-  "'": "&#39;",
-};
-
-/**
- * Metin içeriği ve attribute değerleri için kaçış.
- * @param {unknown} value
- * @returns {string}
- */
-export function esc(value) {
-  if (value == null || value === false) return "";
-  return String(value).replace(/[&<>"']/g, (char) => ESCAPE_MAP[char]);
-}
-
-/**
- * `<script type="application/ld+json">` gövdesi için güvenli JSON.
- * `</script`, `<!--` ve U+2028/2029 kaçırılır.
- * @param {unknown} value
- * @returns {string}
- */
-export function jsonScript(value) {
-  return JSON.stringify(value)
-    .replace(/</g, "\\u003c")
-    .replace(/>/g, "\\u003e")
-    .replace(/&/g, "\\u0026")
-    .replace(/\u2028/g, "\\u2028")
-    .replace(/\u2029/g, "\\u2029");
-}
-
-/**
- * Attribute nesnesini string'e çevirir. `false`/`null`/`undefined` atlanır,
- * `true` boolean attribute olarak yazılır.
- * @param {Record<string, unknown>} attrs
- * @returns {string}
- */
-export function attrs(attrs) {
-  const parts = [];
-  for (const [key, value] of Object.entries(attrs)) {
-    if (value == null || value === false) continue;
-    if (value === true) {
-      parts.push(key);
-      continue;
-    }
-    parts.push(`${key}="${esc(value)}"`);
-  }
-  return parts.length ? ` ${parts.join(" ")}` : "";
-}
-
-/**
- * `clsx` karşılığı — koşullu sınıf birleştirme, çakışma çözümü yok.
- * @param {...unknown} inputs
- * @returns {string}
- */
-export function cx(...inputs) {
-  const out = [];
-
-  for (const input of inputs) {
-    if (!input) continue;
-
-    if (typeof input === "string" || typeof input === "number") {
-      out.push(String(input));
-      continue;
-    }
-
-    if (Array.isArray(input)) {
-      const nested = cx(...input);
-      if (nested) out.push(nested);
-      continue;
-    }
-
-    if (typeof input === "object") {
-      for (const [key, active] of Object.entries(input)) {
-        if (active) out.push(key);
-      }
-    }
-  }
-
-  return out.join(" ");
-}
-
-/**
- * `lib/ui/cn.js` ile aynı davranış: birleştir, sonra Tailwind çakışmalarını çöz.
- *
- * `tailwind-merge` çalışma zamanı bağımlılığı olarak korunur çünkü sınıf
- * hesabı **yalnızca sunucuda** yapılır — client bundle'a hiç girmez, dolayısıyla
- * sayfa ağırlığına etkisi yoktur. Elle yazılmış bir grup tablosu ise
- * `border-2` + `border-transparent` gibi genişlik/renk çiftlerini birbirine
- * karıştırıp sınıf düşürdüğü için görsel regresyon üretiyordu.
- *
- * @param {...unknown} inputs
- * @returns {string}
- */
-export function cn(...inputs) {
-  return twMerge(cx(...inputs));
-}
+/** HTML üretimi için ortak yardımcılar (React'in kaçış davranışının karşılığı). */
+import { twMerge } from "tailwind-merge";
+
+const ESCAPE_MAP = {
+  "&": "&amp;",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;",
+};
+
+/**
+ * Metin içeriği ve attribute değerleri için kaçış.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function esc(value) {
+  if (value == null || value === false) return "";
+  return String(value).replace(/[&<>"']/g, (char) => ESCAPE_MAP[char]);
+}
+
+/**
+ * `<script type="application/ld+json">` gövdesi için güvenli JSON.
+ * `</script`, `<!--` ve U+2028/2029 kaçırılır.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function jsonScript(value) {
+  return JSON.stringify(value)
+    .replace(/</g, "\\u003c")
+    .replace(/>/g, "\\u003e")
+    .replace(/&/g, "\\u0026")
+    .replace(/\u2028/g, "\\u2028")
+    .replace(/\u2029/g, "\\u2029");
+}
+
+/**
+ * Attribute nesnesini string'e çevirir. `false`/`null`/`undefined` atlanır,
+ * `true` boolean attribute olarak yazılır.
+ * @param {Record<string, unknown>} attrs
+ * @returns {string}
+ */
+export function attrs(attrs) {
+  const parts = [];
+  for (const [key, value] of Object.entries(attrs)) {
+    if (value == null || value === false) continue;
+    if (value === true) {
+      parts.push(key);
+      continue;
+    }
+    parts.push(`${key}="${esc(value)}"`);
+  }
+  return parts.length ? ` ${parts.join(" ")}` : "";
+}
+
+/**
+ * `clsx` karşılığı — koşullu sınıf birleştirme, çakışma çözümü yok.
+ * @param {...unknown} inputs
+ * @returns {string}
+ */
+export function cx(...inputs) {
+  const out = [];
+
+  for (const input of inputs) {
+    if (!input) continue;
+
+    if (typeof input === "string" || typeof input === "number") {
+      out.push(String(input));
+      continue;
+    }
+
+    if (Array.isArray(input)) {
+      const nested = cx(...input);
+      if (nested) out.push(nested);
+      continue;
+    }
+
+    if (typeof input === "object") {
+      for (const [key, active] of Object.entries(input)) {
+        if (active) out.push(key);
+      }
+    }
+  }
+
+  return out.join(" ");
+}
+
+/**
+ * `lib/ui/cn.js` ile aynı davranış: birleştir, sonra Tailwind çakışmalarını çöz.
+ *
+ * `tailwind-merge` çalışma zamanı bağımlılığı olarak korunur çünkü sınıf
+ * hesabı **yalnızca sunucuda** yapılır — client bundle'a hiç girmez, dolayısıyla
+ * sayfa ağırlığına etkisi yoktur. Elle yazılmış bir grup tablosu ise
+ * `border-2` + `border-transparent` gibi genişlik/renk çiftlerini birbirine
+ * karıştırıp sınıf düşürdüğü için görsel regresyon üretiyordu.
+ *
+ * @param {...unknown} inputs
+ * @returns {string}
+ */
+export function cn(...inputs) {
+  return twMerge(cx(...inputs));
+}