jskelet 0.2.5 → 0.3.0

package/src/views/components/loader.js

@@ -1,85 +1,85 @@
-/**
- * `views/components/**` altındaki tüm modülleri yükler ve named export'larını
- * tek bir nesnede birleştirir. Bu nesne EJS şablonlarına local olarak geçer,
- * böylece `<%- card({ … }) %>` gibi çağrılar import gerektirmeden çalışır.
- *
- * 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;
-}
-
-/**
- * @param {string} dir `views/components` dizininin mutlak yolu. Dizin yoksa
- *   boş nesne döner: bileşen kullanmayan bir proje de çalışmalı.
- * @returns {Promise<Record<string, unknown>>}
- */
-export async function loadComponents(dir) {
-  if (!dir || !fs.existsSync(dir)) return {};
-
-  /** @type {Record<string, unknown>} */
-  const components = {};
-  /** @type {Map<string, string>} */
-  const origin = new Map();
-
-  const barrel = path.join(dir, BARREL);
-  const files = [
-    ...(fs.existsSync(barrel) ? [barrel] : []),
-    ...collect(dir).sort(),
-  ];
-
-  for (const file of files) {
-    const relative = path.relative(dir, 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);
-      if (previous && previous !== BARREL && previous !== relative) {
-        console.warn(
-          `[components] '${name}' is defined twice: ${previous} and ${relative} — the second one wins.`,
-        );
-      }
-
-      components[name] = value;
-      origin.set(name, relative);
-    }
-  }
-
-  return components;
-}
+/**
+ * `views/components/**` altındaki tüm modülleri yükler ve named export'larını
+ * tek bir nesnede birleştirir. Bu nesne EJS şablonlarına local olarak geçer,
+ * böylece `<%- card({ … }) %>` gibi çağrılar import gerektirmeden çalışır.
+ *
+ * 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;
+}
+
+/**
+ * @param {string} dir `views/components` dizininin mutlak yolu. Dizin yoksa
+ *   boş nesne döner: bileşen kullanmayan bir proje de çalışmalı.
+ * @returns {Promise<Record<string, unknown>>}
+ */
+export async function loadComponents(dir) {
+  if (!dir || !fs.existsSync(dir)) return {};
+
+  /** @type {Record<string, unknown>} */
+  const components = {};
+  /** @type {Map<string, string>} */
+  const origin = new Map();
+
+  const barrel = path.join(dir, BARREL);
+  const files = [
+    ...(fs.existsSync(barrel) ? [barrel] : []),
+    ...collect(dir).sort(),
+  ];
+
+  for (const file of files) {
+    const relative = path.relative(dir, 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);
+      if (previous && previous !== BARREL && previous !== relative) {
+        console.warn(
+          `[components] '${name}' is defined twice: ${previous} and ${relative} — the second one wins.`,
+        );
+      }
+
+      components[name] = value;
+      origin.set(name, relative);
+    }
+  }
+
+  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));
+}