jskelet 0.6.2 → 0.6.3

package/src/server/upstream-tracking.js

@@ -1,166 +1,166 @@
-/**
- * Render başına upstream API hatalarını toplar.
- *
- * `render.js` her sayfayı bu bağlam içinde üretir. Böylece HTML önbelleği "bu
- * çıktı eksik veriyle üretildi" bilgisine sahip olur ve bozuk sayfayı saklamaz;
- * `notFound()` de geçici bir hataya denk geldiğinde 404 olmaktan çıkar.
- *
- * Bilgi iki yoldan gelir:
- *
- *   1. **Otomatik** — `trackUpstreamFetch()` `globalThis.fetch`i sarar ve
- *      geçici hataları (429, 5xx, ağ) kendiliğinden bildirir. `createApp()`
- *      bunu açılışta kurar, yani hiçbir uygulama kodu gerekmez.
- *   2. **Elle** — `fetch` kullanmayan bir istemci (veritabanı sürücüsü, gRPC,
- *      SDK) için:
- *
- *        import { reportUpstreamFailure } from "jskelet";
- *
- *        if (!response.ok) {
- *          reportUpstreamFailure({ status: response.status, path: url });
- *        }
- *
- * İki yol aynı hatayı bildirirse tekilleştirilir.
- *
- * Sarmalayıcı aynı zamanda hız freninin durduğu yerdir
- * (`upstream-limiter.js`): kotayı harcayan şey sayfa isteği değil, buradan
- * geçen çağrı. Fren varsayılan olarak kapalı.
- */
-import { AsyncLocalStorage } from "node:async_hooks";
-import { limitUpstream, noteUpstreamResponse } from "./upstream-limiter.js";
-
-/**
- * @typedef {{ status: number, path: string }} UpstreamFailure
- *   `status: 0` ağ hatası anlamına gelir (yanıt hiç gelmedi).
- */
-
-/** @type {AsyncLocalStorage<{ failures: UpstreamFailure[] }>} */
-const storage = new AsyncLocalStorage();
-
-/**
- * @param {UpstreamFailure} failure
- * @returns {void}
- */
-export function reportUpstreamFailure(failure) {
-  const store = storage.getStore();
-  if (!store) return;
-
-  // Aynı hatayı hem otomatik sarmalayıcı hem uygulamanın istemcisi
-  // bildirebilir; aynı satırı iki kez loglamanın faydası yok.
-  const duplicate = store.failures.some(
-    (existing) => existing.status === failure.status && existing.path === failure.path,
-  );
-  if (!duplicate) store.failures.push(failure);
-}
-
-/**
- * Geçici sayılan durumlar: tekrar denemekle düzelebilenler. Bu liste
- * `render.js` ile paylaşılır — hangi hatanın önbelleği engellediği ve hangi
- * hatanın `notFound()`u 404 olmaktan çıkardığı tek yerde tanımlı olsun.
- */
-const TRANSIENT_STATUSES = new Set([0, 408, 425, 429]);
-
-/**
- * @param {number} status
- * @returns {boolean}
- */
-export function isTransientStatus(status) {
-  return TRANSIENT_STATUSES.has(status) || status >= 500;
-}
-
-/**
- * `globalThis.fetch`i sarıp **geçici** upstream hatalarını kendiliğinden
- * bildirir.
- *
- * Gerekçesi pratik: `reportUpstreamFailure()` sözleşmesi uygulamanın HTTP
- * istemcisine bir satır eklemeyi gerektiriyor ve o satır yazılmadığında
- * framework rate limit'i hiç göremiyor — veri gelmediği için `notFound()`
- * çağıran sayfa 404 olarak servis ediliyordu. Otomatik izleme bu bilgiyi
- * varsayılan hâle getirir; elle çağrı hâlâ geçerli ve tekilleştirilir.
- *
- * Yalnızca geçici durumlar bildirilir. `404`/`403` gibi deterministik
- * cevaplar birçok API'de "böyle bir kayıt yok" anlamına geliyor ve onları
- * otomatik olarak "eksik veri" saymak her sayfada yanlış uyarı üretirdi.
- *
- * Kendi sunucumuza yapılan istekler atlanır: ısıtma turu ve sağlık kontrolü
- * upstream değil.
- *
- * @returns {void}
- */
-export function trackUpstreamFetch() {
-  const original = globalThis.fetch;
-  if (/** @type {any} */ (original).__jskeletUpstreamTracked) return;
-
-  /** @type {typeof fetch} */
-  const wrapped = async (input, init) => {
-    // İstek bir render bağlamı içinde değilse (script, zamanlayıcı) hiçbir
-    // şey yapılmaz: sarmalayıcının maliyeti bir `getStore()` çağrısı.
-    if (!storage.getStore()) return original(input, init);
-
-    const url = requestUrl(input);
-    if (isSelfRequest(url)) return original(input, init);
-
-    // Hız freni burada, çünkü kotayı harcayan şey sayfa değil bu çağrı.
-    // Kapalıysa (varsayılan) `null` döner ve tek maliyeti bir dal.
-    const permit = await limitUpstream(url);
-
-    if (permit?.blocked) {
-      // Devre kesici açık: 429 yiyeceğini bildiğimiz bir çağrıyı yapmıyoruz.
-      // Render tarafı bunu geçici hata olarak görür, yani sayfa önbelleğe
-      // yazılmaz ve bir sonraki istek yeniden dener.
-      reportUpstreamFailure({ status: 429, path: url });
-      return new Response(null, { status: 429, statusText: "Too Many Requests" });
-    }
-
-    try {
-      const response = await original(input, init);
-
-      if (permit) {
-        noteUpstreamResponse(permit.host, response.status, response.headers.get("retry-after"));
-      }
-
-      if (!response.ok && isTransientStatus(response.status)) {
-        reportUpstreamFailure({ status: response.status, path: url });
-      }
-      return response;
-    } catch (error) {
-      // Yanıt hiç gelmedi: ağ hatası her zaman geçicidir.
-      if (permit) noteUpstreamResponse(permit.host, 0, null);
-      reportUpstreamFailure({ status: 0, path: url });
-      throw error;
-    } finally {
-      permit?.release();
-    }
-  };
-
-  /** @type {any} */ (wrapped).__jskeletUpstreamTracked = true;
-  globalThis.fetch = wrapped;
-}
-
-/**
- * @param {RequestInfo | URL} input
- * @returns {string}
- */
-function requestUrl(input) {
-  if (typeof input === "string") return input;
-  if (input instanceof URL) return input.href;
-  return /** @type {Request} */ (input)?.url ?? String(input);
-}
-
-/** @param {string} url */
-function isSelfRequest(url) {
-  return /^https?:\/\/(127\.0\.0\.1|\[::1\]|localhost)(:|\/|$)/i.test(url);
-}
-
-/**
- * @param {() => T} run
- * @returns {T}
- * @template T
- */
-export function withUpstreamTracking(run) {
-  return storage.run({ failures: [] }, run);
-}
-
-/** @returns {UpstreamFailure[]} */
-export function getUpstreamFailures() {
-  return storage.getStore()?.failures ?? [];
-}
+/**
+ * Render başına upstream API hatalarını toplar.
+ *
+ * `render.js` her sayfayı bu bağlam içinde üretir. Böylece HTML önbelleği "bu
+ * çıktı eksik veriyle üretildi" bilgisine sahip olur ve bozuk sayfayı saklamaz;
+ * `notFound()` de geçici bir hataya denk geldiğinde 404 olmaktan çıkar.
+ *
+ * Bilgi iki yoldan gelir:
+ *
+ *   1. **Otomatik** — `trackUpstreamFetch()` `globalThis.fetch`i sarar ve
+ *      geçici hataları (429, 5xx, ağ) kendiliğinden bildirir. `createApp()`
+ *      bunu açılışta kurar, yani hiçbir uygulama kodu gerekmez.
+ *   2. **Elle** — `fetch` kullanmayan bir istemci (veritabanı sürücüsü, gRPC,
+ *      SDK) için:
+ *
+ *        import { reportUpstreamFailure } from "jskelet";
+ *
+ *        if (!response.ok) {
+ *          reportUpstreamFailure({ status: response.status, path: url });
+ *        }
+ *
+ * İki yol aynı hatayı bildirirse tekilleştirilir.
+ *
+ * Sarmalayıcı aynı zamanda hız freninin durduğu yerdir
+ * (`upstream-limiter.js`): kotayı harcayan şey sayfa isteği değil, buradan
+ * geçen çağrı. Fren varsayılan olarak kapalı.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { limitUpstream, noteUpstreamResponse } from "./upstream-limiter.js";
+
+/**
+ * @typedef {{ status: number, path: string }} UpstreamFailure
+ *   `status: 0` ağ hatası anlamına gelir (yanıt hiç gelmedi).
+ */
+
+/** @type {AsyncLocalStorage<{ failures: UpstreamFailure[] }>} */
+const storage = new AsyncLocalStorage();
+
+/**
+ * @param {UpstreamFailure} failure
+ * @returns {void}
+ */
+export function reportUpstreamFailure(failure) {
+  const store = storage.getStore();
+  if (!store) return;
+
+  // Aynı hatayı hem otomatik sarmalayıcı hem uygulamanın istemcisi
+  // bildirebilir; aynı satırı iki kez loglamanın faydası yok.
+  const duplicate = store.failures.some(
+    (existing) => existing.status === failure.status && existing.path === failure.path,
+  );
+  if (!duplicate) store.failures.push(failure);
+}
+
+/**
+ * Geçici sayılan durumlar: tekrar denemekle düzelebilenler. Bu liste
+ * `render.js` ile paylaşılır — hangi hatanın önbelleği engellediği ve hangi
+ * hatanın `notFound()`u 404 olmaktan çıkardığı tek yerde tanımlı olsun.
+ */
+const TRANSIENT_STATUSES = new Set([0, 408, 425, 429]);
+
+/**
+ * @param {number} status
+ * @returns {boolean}
+ */
+export function isTransientStatus(status) {
+  return TRANSIENT_STATUSES.has(status) || status >= 500;
+}
+
+/**
+ * `globalThis.fetch`i sarıp **geçici** upstream hatalarını kendiliğinden
+ * bildirir.
+ *
+ * Gerekçesi pratik: `reportUpstreamFailure()` sözleşmesi uygulamanın HTTP
+ * istemcisine bir satır eklemeyi gerektiriyor ve o satır yazılmadığında
+ * framework rate limit'i hiç göremiyor — veri gelmediği için `notFound()`
+ * çağıran sayfa 404 olarak servis ediliyordu. Otomatik izleme bu bilgiyi
+ * varsayılan hâle getirir; elle çağrı hâlâ geçerli ve tekilleştirilir.
+ *
+ * Yalnızca geçici durumlar bildirilir. `404`/`403` gibi deterministik
+ * cevaplar birçok API'de "böyle bir kayıt yok" anlamına geliyor ve onları
+ * otomatik olarak "eksik veri" saymak her sayfada yanlış uyarı üretirdi.
+ *
+ * Kendi sunucumuza yapılan istekler atlanır: ısıtma turu ve sağlık kontrolü
+ * upstream değil.
+ *
+ * @returns {void}
+ */
+export function trackUpstreamFetch() {
+  const original = globalThis.fetch;
+  if (/** @type {any} */ (original).__jskeletUpstreamTracked) return;
+
+  /** @type {typeof fetch} */
+  const wrapped = async (input, init) => {
+    // İstek bir render bağlamı içinde değilse (script, zamanlayıcı) hiçbir
+    // şey yapılmaz: sarmalayıcının maliyeti bir `getStore()` çağrısı.
+    if (!storage.getStore()) return original(input, init);
+
+    const url = requestUrl(input);
+    if (isSelfRequest(url)) return original(input, init);
+
+    // Hız freni burada, çünkü kotayı harcayan şey sayfa değil bu çağrı.
+    // Kapalıysa (varsayılan) `null` döner ve tek maliyeti bir dal.
+    const permit = await limitUpstream(url);
+
+    if (permit?.blocked) {
+      // Devre kesici açık: 429 yiyeceğini bildiğimiz bir çağrıyı yapmıyoruz.
+      // Render tarafı bunu geçici hata olarak görür, yani sayfa önbelleğe
+      // yazılmaz ve bir sonraki istek yeniden dener.
+      reportUpstreamFailure({ status: 429, path: url });
+      return new Response(null, { status: 429, statusText: "Too Many Requests" });
+    }
+
+    try {
+      const response = await original(input, init);
+
+      if (permit) {
+        noteUpstreamResponse(permit.host, response.status, response.headers.get("retry-after"));
+      }
+
+      if (!response.ok && isTransientStatus(response.status)) {
+        reportUpstreamFailure({ status: response.status, path: url });
+      }
+      return response;
+    } catch (error) {
+      // Yanıt hiç gelmedi: ağ hatası her zaman geçicidir.
+      if (permit) noteUpstreamResponse(permit.host, 0, null);
+      reportUpstreamFailure({ status: 0, path: url });
+      throw error;
+    } finally {
+      permit?.release();
+    }
+  };
+
+  /** @type {any} */ (wrapped).__jskeletUpstreamTracked = true;
+  globalThis.fetch = wrapped;
+}
+
+/**
+ * @param {RequestInfo | URL} input
+ * @returns {string}
+ */
+function requestUrl(input) {
+  if (typeof input === "string") return input;
+  if (input instanceof URL) return input.href;
+  return /** @type {Request} */ (input)?.url ?? String(input);
+}
+
+/** @param {string} url */
+function isSelfRequest(url) {
+  return /^https?:\/\/(127\.0\.0\.1|\[::1\]|localhost)(:|\/|$)/i.test(url);
+}
+
+/**
+ * @param {() => T} run
+ * @returns {T}
+ * @template T
+ */
+export function withUpstreamTracking(run) {
+  return storage.run({ failures: [] }, run);
+}
+
+/** @returns {UpstreamFailure[]} */
+export function getUpstreamFailures() {
+  return storage.getStore()?.failures ?? [];
+}

package/src/shared/cookie-domain.js

@@ -1,66 +1,66 @@
-/**
- * Paylaşımlı cookie Domain seçimi — sunucu ve istemci aynı kuralları kullanır.
- *
- * `brand.sharedCookieRoots` örn. `[".investvio.com", ".localhost"]`.
- * Host bu köklerden birine uyuyorsa Domain olarak o kök yazılır.
- */
-
-/**
- * @param {string} host Host veya Host:port.
- * @returns {string} Lowercase, portsuz.
- */
-export function stripHostPort(host) {
-  const raw = String(host ?? "")
-    .split(",")[0]
-    .trim()
-    .toLowerCase();
-  if (!raw) return "";
-  if (raw.startsWith("[")) {
-    const end = raw.indexOf("]");
-    return end === -1 ? raw : raw.slice(0, end + 1);
-  }
-  const colon = raw.lastIndexOf(":");
-  if (colon === -1) return raw;
-  if (raw.indexOf(":") !== colon) return raw;
-  return raw.slice(0, colon);
-}
-
-/**
- * Kökü `Domain=` biçimine getirir (başında nokta).
- *
- * @param {unknown} root
- * @returns {string | null}
- */
-export function normalizeCookieRoot(root) {
-  if (typeof root !== "string") return null;
-  const trimmed = root.trim().toLowerCase();
-  if (!trimmed || trimmed === ".") return null;
-  const bare = trimmed.replace(/^\./, "");
-  if (!bare || bare.includes("/") || bare.includes(":")) return null;
-  return `.${bare}`;
-}
-
-/**
- * @param {string} hostname Portsuz hostname.
- * @param {Iterable<string>} roots `brand.sharedCookieRoots`.
- * @returns {string | null} `Domain` değeri (başında nokta) ya da eşleşme yoksa null.
- */
-export function resolveSharedCookieDomain(hostname, roots) {
-  const host = stripHostPort(hostname);
-  if (!host) return null;
-
-  for (const entry of roots ?? []) {
-    const root = normalizeCookieRoot(entry);
-    if (!root) continue;
-    const bare = root.slice(1);
-    if (host === bare || host.endsWith(`.${bare}`)) return root;
-  }
-
-  return null;
-}
-
-/**
- * Paylaşımlı cookie için önerilen üst sınır. JWT / büyük token buraya
- * sığmaz — kısa session id koyun; aksi halde handoff veya host-only cookie.
- */
-export const SHARED_COOKIE_WARN_BYTES = 512;
+/**
+ * Paylaşımlı cookie Domain seçimi — sunucu ve istemci aynı kuralları kullanır.
+ *
+ * `brand.sharedCookieRoots` örn. `[".investvio.com", ".localhost"]`.
+ * Host bu köklerden birine uyuyorsa Domain olarak o kök yazılır.
+ */
+
+/**
+ * @param {string} host Host veya Host:port.
+ * @returns {string} Lowercase, portsuz.
+ */
+export function stripHostPort(host) {
+  const raw = String(host ?? "")
+    .split(",")[0]
+    .trim()
+    .toLowerCase();
+  if (!raw) return "";
+  if (raw.startsWith("[")) {
+    const end = raw.indexOf("]");
+    return end === -1 ? raw : raw.slice(0, end + 1);
+  }
+  const colon = raw.lastIndexOf(":");
+  if (colon === -1) return raw;
+  if (raw.indexOf(":") !== colon) return raw;
+  return raw.slice(0, colon);
+}
+
+/**
+ * Kökü `Domain=` biçimine getirir (başında nokta).
+ *
+ * @param {unknown} root
+ * @returns {string | null}
+ */
+export function normalizeCookieRoot(root) {
+  if (typeof root !== "string") return null;
+  const trimmed = root.trim().toLowerCase();
+  if (!trimmed || trimmed === ".") return null;
+  const bare = trimmed.replace(/^\./, "");
+  if (!bare || bare.includes("/") || bare.includes(":")) return null;
+  return `.${bare}`;
+}
+
+/**
+ * @param {string} hostname Portsuz hostname.
+ * @param {Iterable<string>} roots `brand.sharedCookieRoots`.
+ * @returns {string | null} `Domain` değeri (başında nokta) ya da eşleşme yoksa null.
+ */
+export function resolveSharedCookieDomain(hostname, roots) {
+  const host = stripHostPort(hostname);
+  if (!host) return null;
+
+  for (const entry of roots ?? []) {
+    const root = normalizeCookieRoot(entry);
+    if (!root) continue;
+    const bare = root.slice(1);
+    if (host === bare || host.endsWith(`.${bare}`)) return root;
+  }
+
+  return null;
+}
+
+/**
+ * Paylaşımlı cookie için önerilen üst sınır. JWT / büyük token buraya
+ * sığmaz — kısa session id koyun; aksi halde handoff veya host-only cookie.
+ */
+export const SHARED_COOKIE_WARN_BYTES = 512;

package/src/start.mjs

@@ -1,22 +1,22 @@
-/**
- * Prod sunucu girişi. Build çıktısı yoksa önce üretir, sonra dinlemeye başlar.
- *
- * `jskelet start --murder` → dolu porttaki dinleyiciyi öldürüp başlar.
- * Port kontrolü build'den önce: doluysa pahalı üretimi hiç başlatma.
- */
-import process from "node:process";
-import { ensurePortFree } from "./server/port-guard.js";
-
-const port = Number(process.env.PORT ?? 3000);
-const murder = process.argv.includes("--murder");
-
-try {
-  await ensurePortFree(port, { murder });
-  await import("./build/ensure-build.mjs");
-  const { startServer } = await import("./server/create-app.js");
-  await startServer({ murder, port });
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`${message}\n`);
-  process.exit(1);
-}
+/**
+ * Prod sunucu girişi. Build çıktısı yoksa önce üretir, sonra dinlemeye başlar.
+ *
+ * `jskelet start --murder` → dolu porttaki dinleyiciyi öldürüp başlar.
+ * Port kontrolü build'den önce: doluysa pahalı üretimi hiç başlatma.
+ */
+import process from "node:process";
+import { ensurePortFree } from "./server/port-guard.js";
+
+const port = Number(process.env.PORT ?? 3000);
+const murder = process.argv.includes("--murder");
+
+try {
+  await ensurePortFree(port, { murder });
+  await import("./build/ensure-build.mjs");
+  const { startServer } = await import("./server/create-app.js");
+  await startServer({ murder, port });
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`${message}\n`);
+  process.exit(1);
+}

package/src/templates/layout.ejs

@@ -1,30 +1,30 @@
-<%#
-  JSkelet varsayılan layout'unun legacy EJS kopyası.
-
-  Yeni uygulamalar `jskelet/layout` (.jsk) kullanır. Bu dosya yalnızca EJS
-  peer'i kurulu eski şablonlar için `jskelet/layout/ejs` üzerinden erişilir.
-  Uygulama `views/layout.jsk` veya `views/layout.ejs` oluşturduğu anda
-  framework layout'u devre dışı kalır.
-
-  Kullanılabilir local'ler: metadata, headMeta, extraHead, structuredData,
-  body, bodyClass, entries, styles, pathname, lang, devtools, devBasePath,
-  asset, hasAsset + tüm html/tag helper'ları ve views/components/** export'ları.
-  `hooks.layoutContext()` döndürdüğü her alan da buraya eklenir.
--%>
-<!DOCTYPE html>
-<html lang="<%= lang %>">
-  <head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <%# Kaynak ipuçları en başta: preconnect ve LCP preload'ını geciktirmek
-        doğrudan LCP'ye yazılır. Sayfaya özel head buradan gelir. %>
-    <%- extraHead %>
-    <%- stylesheets({ styles }) %>
-    <%- headMeta %>
-    <%- jsonLd({ items: structuredData }) %>
-  </head>
-  <body class="<%= bodyClass %>">
-    <%- body %>
-    <%- bodyScripts({ entries, devtools, devBasePath }) %>
-  </body>
-</html>
+<%#
+  JSkelet varsayılan layout'unun legacy EJS kopyası.
+
+  Yeni uygulamalar `jskelet/layout` (.jsk) kullanır. Bu dosya yalnızca EJS
+  peer'i kurulu eski şablonlar için `jskelet/layout/ejs` üzerinden erişilir.
+  Uygulama `views/layout.jsk` veya `views/layout.ejs` oluşturduğu anda
+  framework layout'u devre dışı kalır.
+
+  Kullanılabilir local'ler: metadata, headMeta, extraHead, structuredData,
+  body, bodyClass, entries, styles, pathname, lang, devtools, devBasePath,
+  asset, hasAsset + tüm html/tag helper'ları ve views/components/** export'ları.
+  `hooks.layoutContext()` döndürdüğü her alan da buraya eklenir.
+-%>
+<!DOCTYPE html>
+<html lang="<%= lang %>">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <%# Kaynak ipuçları en başta: preconnect ve LCP preload'ını geciktirmek
+        doğrudan LCP'ye yazılır. Sayfaya özel head buradan gelir. %>
+    <%- extraHead %>
+    <%- stylesheets({ styles }) %>
+    <%- headMeta %>
+    <%- jsonLd({ items: structuredData }) %>
+  </head>
+  <body class="<%= bodyClass %>">
+    <%- body %>
+    <%- bodyScripts({ entries, devtools, devBasePath }) %>
+  </body>
+</html>

package/src/templates/layout.jsk

@@ -1,30 +1,30 @@
-{#
-  JSkelet varsayılan layout'u.
-
-  Uygulama `views/layout.jsk` (veya legacy `views/layout.ejs`) oluşturduğu
-  anda bu dosya devre dışı kalır; amacı yeni bir projenin tek route ile
-  çalışabilmesi. Kopyalayıp başlangıç noktası olarak kullanın.
-
-  Kullanılabilir local'ler: metadata, headMeta, extraHead, structuredData,
-  body, bodyClass, entries, styles, pathname, lang, devtools, devBasePath,
-  asset, hasAsset + tüm html/tag helper'ları ve views/components/** export'ları.
-  `hooks.layoutContext()` döndürdüğü her alan da buraya eklenir.
-
-  Stylesheets / JsonLd / BodyScripts: `.jsk` ifade dilinde fonksiyon çağrısı
-  olmadığı için asset döngüleri bu yerleşik etiketlere taşındı.
-#}
-<!DOCTYPE html>
-<html :lang="lang">
-  <head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    {{{ extraHead }}}
-    <Stylesheets :styles="styles" />
-    {{{ headMeta }}}
-    <JsonLd :items="structuredData" />
-  </head>
-  <body :class="bodyClass">
-    {{{ body }}}
-    <BodyScripts :entries="entries" :devtools="devtools" :devBasePath="devBasePath" />
-  </body>
-</html>
+{#
+  JSkelet varsayılan layout'u.
+
+  Uygulama `views/layout.jsk` (veya legacy `views/layout.ejs`) oluşturduğu
+  anda bu dosya devre dışı kalır; amacı yeni bir projenin tek route ile
+  çalışabilmesi. Kopyalayıp başlangıç noktası olarak kullanın.
+
+  Kullanılabilir local'ler: metadata, headMeta, extraHead, structuredData,
+  body, bodyClass, entries, styles, pathname, lang, devtools, devBasePath,
+  asset, hasAsset + tüm html/tag helper'ları ve views/components/** export'ları.
+  `hooks.layoutContext()` döndürdüğü her alan da buraya eklenir.
+
+  Stylesheets / JsonLd / BodyScripts: `.jsk` ifade dilinde fonksiyon çağrısı
+  olmadığı için asset döngüleri bu yerleşik etiketlere taşındı.
+#}
+<!DOCTYPE html>
+<html :lang="lang">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    {{{ extraHead }}}
+    <Stylesheets :styles="styles" />
+    {{{ headMeta }}}
+    <JsonLd :items="structuredData" />
+  </head>
+  <body :class="bodyClass">
+    {{{ body }}}
+    <BodyScripts :entries="entries" :devtools="devtools" :devBasePath="devBasePath" />
+  </body>
+</html>