jskelet 0.2.5 → 0.3.1

package/src/server/assets.js

@@ -1,147 +1,147 @@
-/**
- * Build çıktısı manifest'ine erişim: mantıksal isim → hash'li public URL.
- *
- * Build çalışmadıysa uygulama yine ayağa kalkar. `asset()` `/assets/<isim>`
- * döner ve `hasAsset()` false olur; layout stylesheet/script etiketlerini hiç
- * basmaz. Böylece `jskelet build` unutulduğunda hata yerine stilsiz ama
- * çalışan bir sayfa görürsünüz.
- */
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-import { getConfig } from "../config/index.js";
-
-const isDev = process.env.NODE_ENV === "development";
-
-/** @type {{ manifest: Record<string, string> } | null} */
-let cached = null;
-let warned = false;
-
-function load() {
-  const { generated } = getConfig().dirs;
-
-  /** @type {Record<string, string>} */
-  let manifest = {};
-
-  try {
-    manifest = JSON.parse(
-      fs.readFileSync(path.join(generated, "manifest.json"), "utf8"),
-    );
-  } catch {
-    if (!warned) {
-      warned = true;
-      console.warn("[assets] no manifest — run `jskelet build`.");
-    }
-  }
-
-  return { manifest };
-}
-
-function state() {
-  // Dev'de her istekte yeniden okunur (watch build hash'leri değiştirir);
-  // prod'da bir kez.
-  if (isDev || !cached) cached = load();
-  return cached;
-}
-
-/**
- * @param {string} name Örn. "app.css", "main.js", "sprite.svg"
- * @returns {string}
- */
-export function asset(name) {
-  return state().manifest[name] ?? `/assets/${name}`;
-}
-
-/**
- * @param {string} name
- * @returns {boolean}
- */
-export function hasAsset(name) {
-  return Boolean(state().manifest[name]);
-}
-
-/** @type {string | null} */
-let buildId = null;
-
-/**
- * Bu build'i tanımlayan kısa kimlik (`build.json` → `id`).
- *
- * Paylaşımlı önbellek anahtarlarının isim alanı bu: saklanan HTML hash'li
- * varlık yollarını gömdüğü için bir deploy'dan sonra eski HTML **geçersizdir**.
- *
- * Build çalışmadıysa `"dev"` döner — build çıktısı olmadan da ayağa kalkma
- * kuralı burada da geçerli.
- *
- * @returns {string}
- */
-export function getBuildId() {
-  if (!isDev && buildId) return buildId;
-
-  try {
-    const file = path.join(getConfig().dirs.generated, "build.json");
-    const id = JSON.parse(fs.readFileSync(file, "utf8")).id;
-    buildId = typeof id === "string" && id ? id : "dev";
-  } catch {
-    buildId = "dev";
-  }
-
-  return buildId;
-}
-
-/**
- * @typedef {{ width: number, height: number,
- *   variants: { width: number, url: string }[] }} OptimizedImage
- */
-
-/** @type {Record<string, OptimizedImage> | null} */
-let images = null;
-
-/**
- * `build/tasks/images.mjs` çıktısı: kaynak yolundan webp varyantlarına.
- * Build çalışmadıysa boş kalır ve görseller orijinalleriyle servis edilir.
- *
- * @param {string} [src] Örn. "/hero.png"
- * @returns {OptimizedImage | undefined}
- */
-export function optimizedImage(src) {
-  if (isDev || !images) {
-    try {
-      const file = path.join(getConfig().dirs.generated, "images.json");
-      images = JSON.parse(fs.readFileSync(file, "utf8")).images ?? {};
-    } catch {
-      images = {};
-    }
-  }
-
-  return src ? images[src] : undefined;
-}
-
-/** @type {{ url: string, ids: Set<string> } | null} */
-let spriteIds = null;
-
-/**
- * Sprite'taki sembol kimlikleri. Sprite yalnızca kaynakta **statik olarak**
- * görülen ikon adlarını içerir; adı çalışma anında hesaplanan bir `icon()`
- * çağrısı eksik sembole işaret ederse ekranda sessizce boşluk kalır. Dev'de
- * `icon()` bu kümeye bakıp uyarır.
- *
- * @returns {Set<string>}
- */
-export function getSpriteIds() {
-  const url = asset("sprite.svg");
-  if (spriteIds?.url === url) return spriteIds.ids;
-
-  /** @type {Set<string>} */
-  const ids = new Set();
-
-  try {
-    const file = path.join(getConfig().dirs.public, url.replace(/^\//, ""));
-    const svg = fs.readFileSync(file, "utf8");
-    for (const match of svg.matchAll(/<symbol id="([^"]+)"/g)) ids.add(match[1]);
-  } catch {
-    // Sprite okunamazsa uyarı üretilmez; asıl akış etkilenmez.
-  }
-
-  spriteIds = { url, ids };
-  return ids;
-}
+/**
+ * Build çıktısı manifest'ine erişim: mantıksal isim → hash'li public URL.
+ *
+ * Build çalışmadıysa uygulama yine ayağa kalkar. `asset()` `/assets/<isim>`
+ * döner ve `hasAsset()` false olur; layout stylesheet/script etiketlerini hiç
+ * basmaz. Böylece `jskelet build` unutulduğunda hata yerine stilsiz ama
+ * çalışan bir sayfa görürsünüz.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { getConfig } from "../config/index.js";
+
+const isDev = process.env.NODE_ENV === "development";
+
+/** @type {{ manifest: Record<string, string> } | null} */
+let cached = null;
+let warned = false;
+
+function load() {
+  const { generated } = getConfig().dirs;
+
+  /** @type {Record<string, string>} */
+  let manifest = {};
+
+  try {
+    manifest = JSON.parse(
+      fs.readFileSync(path.join(generated, "manifest.json"), "utf8"),
+    );
+  } catch {
+    if (!warned) {
+      warned = true;
+      console.warn("[assets] no manifest — run `jskelet build`.");
+    }
+  }
+
+  return { manifest };
+}
+
+function state() {
+  // Dev'de her istekte yeniden okunur (watch build hash'leri değiştirir);
+  // prod'da bir kez.
+  if (isDev || !cached) cached = load();
+  return cached;
+}
+
+/**
+ * @param {string} name Örn. "app.css", "main.js", "sprite.svg"
+ * @returns {string}
+ */
+export function asset(name) {
+  return state().manifest[name] ?? `/assets/${name}`;
+}
+
+/**
+ * @param {string} name
+ * @returns {boolean}
+ */
+export function hasAsset(name) {
+  return Boolean(state().manifest[name]);
+}
+
+/** @type {string | null} */
+let buildId = null;
+
+/**
+ * Bu build'i tanımlayan kısa kimlik (`build.json` → `id`).
+ *
+ * Paylaşımlı önbellek anahtarlarının isim alanı bu: saklanan HTML hash'li
+ * varlık yollarını gömdüğü için bir deploy'dan sonra eski HTML **geçersizdir**.
+ *
+ * Build çalışmadıysa `"dev"` döner — build çıktısı olmadan da ayağa kalkma
+ * kuralı burada da geçerli.
+ *
+ * @returns {string}
+ */
+export function getBuildId() {
+  if (!isDev && buildId) return buildId;
+
+  try {
+    const file = path.join(getConfig().dirs.generated, "build.json");
+    const id = JSON.parse(fs.readFileSync(file, "utf8")).id;
+    buildId = typeof id === "string" && id ? id : "dev";
+  } catch {
+    buildId = "dev";
+  }
+
+  return buildId;
+}
+
+/**
+ * @typedef {{ width: number, height: number,
+ *   variants: { width: number, url: string }[] }} OptimizedImage
+ */
+
+/** @type {Record<string, OptimizedImage> | null} */
+let images = null;
+
+/**
+ * `build/tasks/images.mjs` çıktısı: kaynak yolundan webp varyantlarına.
+ * Build çalışmadıysa boş kalır ve görseller orijinalleriyle servis edilir.
+ *
+ * @param {string} [src] Örn. "/hero.png"
+ * @returns {OptimizedImage | undefined}
+ */
+export function optimizedImage(src) {
+  if (isDev || !images) {
+    try {
+      const file = path.join(getConfig().dirs.generated, "images.json");
+      images = JSON.parse(fs.readFileSync(file, "utf8")).images ?? {};
+    } catch {
+      images = {};
+    }
+  }
+
+  return src ? images[src] : undefined;
+}
+
+/** @type {{ url: string, ids: Set<string> } | null} */
+let spriteIds = null;
+
+/**
+ * Sprite'taki sembol kimlikleri. Sprite yalnızca kaynakta **statik olarak**
+ * görülen ikon adlarını içerir; adı çalışma anında hesaplanan bir `icon()`
+ * çağrısı eksik sembole işaret ederse ekranda sessizce boşluk kalır. Dev'de
+ * `icon()` bu kümeye bakıp uyarır.
+ *
+ * @returns {Set<string>}
+ */
+export function getSpriteIds() {
+  const url = asset("sprite.svg");
+  if (spriteIds?.url === url) return spriteIds.ids;
+
+  /** @type {Set<string>} */
+  const ids = new Set();
+
+  try {
+    const file = path.join(getConfig().dirs.public, url.replace(/^\//, ""));
+    const svg = fs.readFileSync(file, "utf8");
+    for (const match of svg.matchAll(/<symbol id="([^"]+)"/g)) ids.add(match[1]);
+  } catch {
+    // Sprite okunamazsa uyarı üretilmez; asıl akış etkilenmez.
+  }
+
+  spriteIds = { url, ids };
+  return ids;
+}

package/src/server/cache-deps.js

@@ -1,42 +1,42 @@
-/**
- * Bir render'ın hangi veri anahtarlarını okuduğunu kaydeder.
- *
- * `request-cache.js` ile aynı desen: `AsyncLocalStorage`, bağlam yoksa her şey
- * sessizce devre dışı. Script'ten, cron'dan ya da istek dışı bir yerden yapılan
- * `withDataCache` çağrıları hiçbir şeye yazılmaz.
- *
- * Neden gerekli: HTML önbelleğinin elinde "bu sayfa şu içerikten etkilenir"
- * bilgisi yoktu, dolayısıyla bir içerik güncellendiğinde tek seçenek TTL'i
- * beklemek ya da tüm önbelleği boşaltmaktı. Bağımlılığı uygulamanın elle
- * bildirmesi (tag'lemek) ise en sık yapılan hatayı davet ediyor: detay
- * sayfasını işaretleyip aynı içeriği listeleyen ana sayfayı unutmak.
- *
- * Burada bildirim yok, **gözlem** var: render sırasında fiilen okunan anahtarlar
- * kaydedilir. Ana sayfa o veriyi okuduysa listede olur, okumadıysa olmaz.
- */
-import { AsyncLocalStorage } from "node:async_hooks";
-
-/** @type {AsyncLocalStorage<Set<string>>} */
-const storage = new AsyncLocalStorage();
-
-/**
- * `run`'ı, içindeki `recordDependency()` çağrılarının `deps`'e yazacağı bir
- * bağlamda çalıştırır.
- *
- * @template T
- * @param {Set<string>} deps
- * @param {() => T} run
- * @returns {T}
- */
-export function collectDependencies(deps, run) {
-  return storage.run(deps, run);
-}
-
-/**
- * Bu render'ın bir veri anahtarını okuduğunu bildirir. Bağlam yoksa no-op.
- *
- * @param {string} key
- */
-export function recordDependency(key) {
-  storage.getStore()?.add(key);
-}
+/**
+ * Bir render'ın hangi veri anahtarlarını okuduğunu kaydeder.
+ *
+ * `request-cache.js` ile aynı desen: `AsyncLocalStorage`, bağlam yoksa her şey
+ * sessizce devre dışı. Script'ten, cron'dan ya da istek dışı bir yerden yapılan
+ * `withDataCache` çağrıları hiçbir şeye yazılmaz.
+ *
+ * Neden gerekli: HTML önbelleğinin elinde "bu sayfa şu içerikten etkilenir"
+ * bilgisi yoktu, dolayısıyla bir içerik güncellendiğinde tek seçenek TTL'i
+ * beklemek ya da tüm önbelleği boşaltmaktı. Bağımlılığı uygulamanın elle
+ * bildirmesi (tag'lemek) ise en sık yapılan hatayı davet ediyor: detay
+ * sayfasını işaretleyip aynı içeriği listeleyen ana sayfayı unutmak.
+ *
+ * Burada bildirim yok, **gözlem** var: render sırasında fiilen okunan anahtarlar
+ * kaydedilir. Ana sayfa o veriyi okuduysa listede olur, okumadıysa olmaz.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+
+/** @type {AsyncLocalStorage<Set<string>>} */
+const storage = new AsyncLocalStorage();
+
+/**
+ * `run`'ı, içindeki `recordDependency()` çağrılarının `deps`'e yazacağı bir
+ * bağlamda çalıştırır.
+ *
+ * @template T
+ * @param {Set<string>} deps
+ * @param {() => T} run
+ * @returns {T}
+ */
+export function collectDependencies(deps, run) {
+  return storage.run(deps, run);
+}
+
+/**
+ * Bu render'ın bir veri anahtarını okuduğunu bildirir. Bağlam yoksa no-op.
+ *
+ * @param {string} key
+ */
+export function recordDependency(key) {
+  storage.getStore()?.add(key);
+}