jskelet 0.7.0 → 0.7.2

package/src/server/render.js

@@ -58,16 +58,22 @@ const isDev = process.env.NODE_ENV === "development";
  * taraması dosya sistemine dokunduğu için bir kez yapılır; config yüklenmeden
  * hesaplanamaz, bu yüzden ilk render'da kurulur.
  *
- * @type {{ helpers: Record<string, unknown>, options: Record<string, unknown>,
+ * Sayfa `.jsk` şablonları lazy yüklenir; layout + `components/*.jsk` eager.
+ *
+ * @typedef {{ helpers: Record<string, unknown>, options: Record<string, unknown>,
  *   viewsDir: string, viewRoots: string[], layout: string,
  *   compiled: Map<string, (data: object, helpers: object) => string>,
+ *   loading: Map<string, Promise<(data: object, helpers: object) => string | null>>,
+ *   manifest: Record<string, string>, templatesDir: string, bust: string,
  *   layoutRender: ((data: object, helpers: object) => string) | null
- * } | null}
+ * }} RenderEngine
  */
+
+/** @type {RenderEngine | null} */
 let engine = null;
 
 /**
- * @returns {Promise<NonNullable<typeof engine>>}
+ * @returns {Promise<RenderEngine>}
  */
 async function getEngine() {
   if (engine) return engine;
@@ -104,14 +110,11 @@ async function getEngine() {
     if (!(pascal in helpers)) helpers[pascal] = value;
   }
 
-  const { compiled, layoutRender: appLayoutRender } = await loadCompiledTemplates(
-    config,
-    helpers,
-  );
+  const loaded = await loadCompiledTemplates(config, helpers);
 
   // Yalnızca framework varsayılan layout'una düşüldüğünde hazır modülü kullan;
   // uygulamanın kendi layout.jsk'si derlenmemişse sessizce framework'e kayma.
-  let layoutRender = appLayoutRender;
+  let layoutRender = loaded.layoutRender;
   if (!layoutRender) {
     const fwLayout = path.join(FRAMEWORK_ROOT, "src", "templates", "layout.jsk");
     if (path.resolve(config.layout) === path.resolve(fwLayout)) {
@@ -125,7 +128,11 @@ async function getEngine() {
     viewRoots,
     layout: config.layout,
     helpers,
-    compiled,
+    compiled: loaded.compiled,
+    loading: new Map(),
+    manifest: loaded.manifest,
+    templatesDir: loaded.templatesDir,
+    bust: loaded.bust,
     layoutRender,
     options: {
       // `include('partials/header')` gibi çağrılar views kökünden çözülür.
@@ -141,11 +148,48 @@ async function getEngine() {
 }
 
 /**
- * Derlenmiş `.jsk` modüllerini yükler. İstek anında parse/compile yok.
+ * Manifest'ten tek bir derlenmiş view yükler. Include'lar modül grafiğinde
+ * statik import ile gelir.
+ *
+ * @param {RenderEngine} eng
+ * @param {string} viewId
+ * @returns {Promise<((data: object, helpers: object) => string) | null>}
+ */
+async function ensureCompiledView(eng, viewId) {
+  const hit = eng.compiled.get(viewId);
+  if (hit) return hit;
+
+  const rel = eng.manifest[viewId];
+  if (!rel) return null;
+
+  const pending = eng.loading.get(viewId);
+  if (pending) return pending;
+
+  const task = (async () => {
+    const file = path.join(eng.templatesDir, rel);
+    try {
+      const mod = await import(pathToFileURL(file).href + eng.bust);
+      if (typeof mod.render !== "function") return null;
+      eng.compiled.set(viewId, mod.render);
+      return mod.render;
+    } catch {
+      return null;
+    } finally {
+      eng.loading.delete(viewId);
+    }
+  })();
+
+  eng.loading.set(viewId, task);
+  return task;
+}
+
+/**
+ * Layout + `components/*.jsk` eager; sayfa şablonları ilk `renderView`'da.
  *
  * @param {import('../config/index.js').ResolvedConfig} config
  * @param {Record<string, unknown>} helpers
- * @returns {Promise<{ compiled: Map<string, Function>, layoutRender: Function | null }>}
+ * @returns {Promise<{ compiled: Map<string, Function>, layoutRender: Function | null,
+ *   manifest: Record<string, string>, templatesDir: string, bust: string }>}
  */
 async function loadCompiledTemplates(config, helpers) {
   /** @type {Map<string, (data: object, helpers: object) => string>} */
@@ -154,21 +198,40 @@ async function loadCompiledTemplates(config, helpers) {
   const manifestPath = path.join(templatesDir, "manifest.json");
 
   if (!fs.existsSync(manifestPath)) {
-    return { compiled, layoutRender: null };
+    return {
+      compiled,
+      layoutRender: null,
+      manifest: {},
+      templatesDir,
+      bust: "",
+    };
   }
 
   /** @type {Record<string, string>} */
   const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
   const bust = isDev ? `?t=${Date.now()}` : "";
 
-  for (const [viewId, rel] of Object.entries(manifest)) {
-    const file = path.join(templatesDir, rel);
-    if (!fs.existsSync(file)) continue;
-    const mod = await import(pathToFileURL(file).href + bust);
-    if (typeof mod.render !== "function") continue;
+  const eagerIds = Object.keys(manifest).filter(
+    (id) => id === "layout" || id.startsWith("components/"),
+  );
+
+  const entries = await Promise.all(
+    eagerIds.map(async (viewId) => {
+      const rel = manifest[viewId];
+      const file = path.join(templatesDir, rel);
+      try {
+        const mod = await import(pathToFileURL(file).href + bust);
+        return /** @type {const} */ ([viewId, mod]);
+      } catch {
+        return /** @type {const} */ ([viewId, null]);
+      }
+    }),
+  );
+
+  for (const [viewId, mod] of entries) {
+    if (!mod || typeof mod.render !== "function") continue;
     compiled.set(viewId, mod.render);
 
-    // `components/*.jsk` → helpers.PascalName
     if (viewId.startsWith("components/")) {
       const base = viewId.slice("components/".length).split("/").pop() ?? "";
       const pascal = base
@@ -183,7 +246,24 @@ async function loadCompiledTemplates(config, helpers) {
   }
 
   const layoutRender = compiled.get("layout") ?? null;
-  return { compiled, layoutRender };
+  return { compiled, layoutRender, manifest, templatesDir, bust };
+}
+
+/**
+ * Listen öncesi: motor + asset manifest ısınır (sayfa prewarm değil).
+ *
+ * @returns {Promise<void>}
+ */
+export async function warmRenderEngine() {
+  await getEngine();
+  hasAsset("app.css");
+  hasAsset("main.js");
+  try {
+    const { getBuildId } = await import("./assets.js");
+    getBuildId();
+  } catch {
+    /* yoksa sessiz */
+  }
 }
 
 /**
@@ -222,8 +302,13 @@ export function resetRenderEngine() {
  * @returns {Promise<string>}
  */
 export async function renderView(view, data = {}) {
-  const { helpers, options, compiled, viewRoots, viewsDir } = await getEngine();
-  const renderFn = compiled.get(view);
+  const eng = await getEngine();
+  const { helpers, options, viewRoots, viewsDir } = eng;
+
+  let renderFn = eng.compiled.get(view) ?? null;
+  if (!renderFn && eng.manifest[view]) {
+    renderFn = await ensureCompiledView(eng, view);
+  }
   if (renderFn) {
     return renderFn({ ...data }, helpers);
   }
@@ -246,21 +331,36 @@ export async function renderPage(page) {
   const { helpers, options, layout, layoutRender } = await getEngine();
   const config = getConfig();
 
-  const metadata = {
+  // Gövde `page.metadata` ile başlar (hook beklemez). Head/layout birleşik
+  // metadata'yı alır — siteName/titleTemplate gibi hook alanları layout'ta.
+  const pageMeta = page.metadata ?? {};
+  const metadataPromise = (async () => ({
     ...(await hook("metadata", {}, page)),
-    ...(page.metadata ?? {}),
-  };
+    ...pageMeta,
+  }))();
+
+  const bodyPromise = renderView(page.view, {
+    ...(page.data ?? {}),
+    metadata: pageMeta,
+  });
+
+  // metadata → layoutContext zinciri gövdeyle paralel.
+  const layoutPromise = metadataPromise.then(async (metadata) => {
+    const context = await hook("layoutContext", {}, {
+      pathname: page.pathname ?? "",
+      metadata,
+    });
+    return { metadata, context };
+  });
 
-  // Layout bağlamı ve gövde paralel üretilir: navigasyon çoğu projede
-  // upstream'den geliyor ve gövde render'ıyla sırayla beklemek her sayfaya
-  // gereksiz gecikme ekliyor.
-  const [body, context] = await Promise.all([
-    renderView(page.view, { ...(page.data ?? {}), metadata }),
-    hook("layoutContext", {}, { pathname: page.pathname ?? "", metadata }),
+  const [body, { metadata, context }] = await Promise.all([
+    bodyPromise,
+    layoutPromise,
   ]);
 
-  const locals = {
-    ...helpers,
+  // Layout local'leri. `.jsk` `(data, helpers)` aldığı için helpers'ı data'ya
+  // kopyalamak gereksiz allocation; EJS layout hâlâ bare helper adları bekler.
+  const pageLocals = {
     ...context,
     metadata,
     // Boş varsayılan bilinçli: "/" yazmak her sayfayı ana sayfa sanıp
@@ -286,7 +386,7 @@ export async function renderPage(page) {
   };
 
   if (layoutRender) {
-    return layoutRender(locals, helpers);
+    return layoutRender(pageLocals, helpers);
   }
 
   if (layout.endsWith(".jsk")) {
@@ -296,7 +396,7 @@ export async function renderPage(page) {
     );
   }
 
-  return renderEjsFile(layout, locals, options);
+  return renderEjsFile(layout, { ...helpers, ...pageLocals }, options);
 }
 
 /**
@@ -683,31 +783,28 @@ async function sendHtml(req, res, body, encoded, options = {}) {
   const encoding =
     req.method === "HEAD" ? null : negotiateEncoding(req.headers["accept-encoding"]);
 
-  if (!encoding || !encoded) {
+  if (!encoding) {
     if (options.etag === false) {
-      // Sıkıştırma middleware'i devreye girerse Content-Length'i kendisi
-      // kaldırır; girmezse doğru uzunlukla gider.
       res.setHeader("Content-Length", String(Buffer.byteLength(body)));
       res.end(req.method === "HEAD" ? undefined : body);
       return;
     }
-
     res.send(body);
     return;
   }
 
-  let buffer = encoded.get(encoding);
+  // Public cache haritası veya private/fragment: HTML'i burada sıkıştır —
+  // middleware'in ikinci kez buffer'lamasını ve private yolda q=5 maliyetini kes.
+  let buffer = encoded?.get(encoding);
   if (!buffer) {
     buffer = await encodeText(body, encoding);
-    // Ham HTML kalır; sıkıştırılmış kopya tek kodlamadır. Diğer istemci
-    // gelince eski buffer düşer, bayt bütçesi iki gövdeyi birden saymaz.
-    rememberHtmlEncoding(encoded, encoding, buffer);
+    if (encoded) rememberHtmlEncoding(encoded, encoding, buffer);
   }
 
   res.setHeader("Content-Encoding", encoding);
   res.setHeader("Vary", "Accept-Encoding");
   res.setHeader("Content-Length", String(buffer.length));
-  res.end(buffer);
+  res.end(req.method === "HEAD" ? undefined : buffer);
 }
 
 /**
@@ -759,12 +856,47 @@ async function produce(controller, ctx) {
   if (!first.transient.length) return { html: await renderNotFound(), status: 404 };
 
   // Buraya gelindiyse `notFound()` veri gelmediği için çağrılmış. **Var olan
-  // bir sayfayı** 404 olarak servis etmek en kötü sonuç: arama motoru geçici
-  // bir rate limit'i kalıcı bir kayıp sanar. Bu yüzden sayfa yeniden denenir —
-  // ısıtma günlükleri gösteriyor ki aynı yol saniyeler sonra 200 dönüyor.
-  const { attempts, delayMs } = transientRetry();
+  // bir sayfayı** 404 olarak servis etmek en kötü sonuç. Varsayılan: hemen
+  // 503 dön, retry'yi arka planda çalıştır (data cache ısınır). `background:
+  // false` eski senkron retry davranışını geri getirir.
+  const { attempts, delayMs, background } = transientRetry();
   let failures = first.transient;
 
+  if (background && attempts > 0) {
+    const retryDetail =
+      `returned notFound() while upstream is failing ` +
+      `(${summarizeFailures(failures)}), retrying in background (${attempts}×)`;
+    if (!suppressForPrewarm(retryDetail)) {
+      console.warn(`[render] ${ctx.pathname} ${retryDetail}`);
+    }
+
+    void (async () => {
+      for (let round = 1; round <= attempts; round += 1) {
+        await sleep(delayMs * round);
+        try {
+          const retried = await withUpstreamTracking(() =>
+            withRequestCache(() => attempt(controller, ctx)),
+          );
+          if ("page" in retried || !retried.transient.length) return;
+          failures = retried.transient;
+        } catch (error) {
+          console.warn(
+            `[render] ${ctx.pathname} background retry failed`,
+            error instanceof Error ? error.message : error,
+          );
+          return;
+        }
+      }
+    })();
+
+    return {
+      html: await renderStatusPage(503),
+      status: 503,
+      degraded: true,
+      retryAfter: RETRY_AFTER_SECONDS,
+    };
+  }
+
   for (let round = 1; round <= attempts; round += 1) {
     const retryDetail =
       `returned notFound() while upstream is failing ` +
@@ -773,29 +905,20 @@ async function produce(controller, ctx) {
       console.warn(`[render] ${ctx.pathname} ${retryDetail}`);
     }
 
-    // Beklemeden tekrar denemek rate limit'e girmiş bir API'de aynı 429'u
-    // getirir; kısa bekleme hem pencerenin dönmesine şans verir hem de
-    // fırtınayı büyütmez.
     await sleep(delayMs * round);
 
-    // Her deneme kendi upstream ve istek içi cache bağlamında çalışır: ilk
-    // turun hataları ikinci turun kararını kirletmesin ve memoize edilmiş
-    // boş cevaplar tekrar kullanılmasın.
     const retried = await withUpstreamTracking(() =>
       withRequestCache(() => attempt(controller, ctx)),
     );
 
     if ("page" in retried) return retried.page;
     if (!retried.transient.length) {
-      // Bu kez upstream sağlam cevap verdi ve "yok" dedi: gerçek 404.
       return { html: await renderNotFound(), status: 404 };
     }
 
     failures = retried.transient;
   }
 
-  // Denemeler tükendi. 404 yerine 503: önbelleğe girmez, `Retry-After` taşır
-  // ve bir sonraki istek gerçek içeriği üretebilir.
   const outageDetail =
     `could not be produced, upstream is still failing ` +
     `(${summarizeFailures(failures)}), serving an uncached 503 instead of a 404`;
@@ -819,11 +942,10 @@ async function produce(controller, ctx) {
 const RETRY_AFTER_SECONDS = 30;
 
 /**
- * Tekrar denemenin maliyeti upstream'e binen ikinci bir istek turu; bu yüzden
- * varsayılan tek deneme ve kısa bekleme. Rate limit fırtınasında toplam yük
- * iki katına çıkabilir, ama alternatifi var olan sayfaları 404'e düşürmek.
+ * Varsayılan: arka plan retry + hemen 503 (TTFB'yi sleep ile şişirmez).
+ * `background: false` → eski senkron döngü.
  *
- * @returns {{ attempts: number, delayMs: number }}
+ * @returns {{ attempts: number, delayMs: number, background: boolean }}
  */
 function transientRetry() {
   const raw = /** @type {any} */ (getConfig().transientRetry ?? {});
@@ -833,6 +955,7 @@ function transientRetry() {
   return {
     attempts: Number.isFinite(attempts) && attempts >= 0 ? Math.floor(attempts) : 1,
     delayMs: Number.isFinite(delayMs) && delayMs >= 0 ? delayMs : 300,
+    background: raw.background !== false,
   };
 }
 

package/src/templates/layout.jsk

@@ -5,10 +5,10 @@
   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.
+  Kullanılabilir data alanları: metadata, headMeta, extraHead, structuredData,
+  body, bodyClass, entries, styles, pathname, lang, devtools, devBasePath.
+  Yardımcılar ikinci `helpers` argümanında (PascalCase etiketler /
+  helpers.esc). `hooks.layoutContext()` alanları data'ya eklenir.
 
   Stylesheets / JsonLd / BodyScripts: `.jsk` ifade dilinde fonksiyon çağrısı
   olmadığı için asset döngüleri bu yerleşik etiketlere taşındı.

package/src/templates/layout.render.js

@@ -6,36 +6,17 @@
  */
 export function render(data, helpers) {
   let s = "";
-  s += "\r\n";
   s += "<!DOCTYPE html>";
-  s += "\r\n";
   s += "<html" + helpers.attrs({"lang": data.lang}) + ">";
-  s += "\r\n  ";
-  s += "<head>";
-  s += "\r\n    ";
-  s += "<meta charset=\"utf-8\">";
-  s += "\r\n    ";
-  s += "<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">";
-  s += "\r\n    ";
+  s += "<head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">";
   s += (data.extraHead ?? "");
-  s += "\r\n    ";
   s += (helpers.Stylesheets({ "styles": data.styles }) ?? "");
-  s += "\r\n    ";
   s += (data.headMeta ?? "");
-  s += "\r\n    ";
   s += (helpers.JsonLd({ "items": data.structuredData }) ?? "");
-  s += "\r\n  ";
   s += "</head>";
-  s += "\r\n  ";
   s += "<body" + helpers.attrs({"class": data.bodyClass}) + ">";
-  s += "\r\n    ";
   s += (data.body ?? "");
-  s += "\r\n    ";
   s += (helpers.BodyScripts({ "entries": data.entries, "devtools": data.devtools, "devBasePath": data.devBasePath }) ?? "");
-  s += "\r\n  ";
-  s += "</body>";
-  s += "\r\n";
-  s += "</html>";
-  s += "\r\n";
+  s += "</body></html>";
   return s;
 }

package/src/views/components/loader.js

@@ -43,7 +43,8 @@ function collect(dir, out = []) {
 }
 
 /**
- * Tek bir `components/` dizinini yükler.
+ * Modülleri paralel import eder; export uygulama sırası dosya listesiyle
+ * aynı kalır (barrel önce, sonra sıralı bileşenler).
  *
  * @param {string} dir
  * @param {Record<string, unknown>} components
@@ -59,12 +60,16 @@ async function loadDir(dir, components, origin) {
     ...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);
+  const loaded = await Promise.all(
+    files.map(async (file) => {
+      const isBarrel = path.basename(file) === BARREL;
+      const fileId = isBarrel ? BARREL : file.split(path.sep).join("/");
+      const module = await import(pathToFileURL(file).href);
+      return { fileId, module };
+    }),
+  );
 
+  for (const { fileId, module } of loaded) {
     for (const [name, value] of Object.entries(module)) {
       if (name === "default") continue;
 

package/src/views/helpers/html.js

@@ -9,6 +9,11 @@ const ESCAPE_MAP = {
   "'": "'",
 };
 
+/** Kaçış gerektiren karakter var mı — yoksa `replace` callback'ine girilmez. */
+const NEEDS_ESCAPE = /[&<>"']/;
+/** Tüm eşleşmeleri değiştirmek için ayrı global kopya (`test` lastIndex'i kirletmesin). */
+const ESCAPE_ALL = /[&<>"']/g;
+
 /**
  * Metin içeriği ve attribute değerleri için kaçış.
  * @param {unknown} value
@@ -16,7 +21,9 @@ const ESCAPE_MAP = {
  */
 export function esc(value) {
   if (value == null || value === false) return "";
-  return String(value).replace(/[&<>"']/g, (char) => ESCAPE_MAP[char]);
+  const str = typeof value === "string" ? value : String(value);
+  if (!NEEDS_ESCAPE.test(str)) return str;
+  return str.replace(ESCAPE_ALL, (char) => ESCAPE_MAP[char]);
 }
 
 /**
@@ -41,16 +48,17 @@ export function jsonScript(value) {
  * @returns {string}
  */
 export function attrs(attrs) {
-  const parts = [];
+  // Dizi + join yerine doğrudan birikim: tipik etiket 2–6 attribute.
+  let out = "";
   for (const [key, value] of Object.entries(attrs)) {
     if (value == null || value === false) continue;
     if (value === true) {
-      parts.push(key);
+      out += ` ${key}`;
       continue;
     }
-    parts.push(`${key}="${esc(value)}"`);
+    out += ` ${key}="${esc(value)}"`;
   }
-  return parts.length ? ` ${parts.join(" ")}` : "";
+  return out;
 }
 
 /**

package/src/views/helpers/tags.js

@@ -24,6 +24,12 @@ const isDev = process.env.NODE_ENV === "development";
 /** Aynı eksik ikon için tek uyarı. */
 const warnedIcons = new Set();
 
+/** `fill` Image varsayılan sınıfları — `cn`/`twMerge` olmadan sabit. */
+const IMAGE_FILL_CLASS = "absolute inset-0 h-full w-full object-cover";
+
+/** Sprite URL process ömründe bir kez çözülür (hash değişince process yenilenir). */
+let cachedSpritePath = /** @type {string | null} */ (null);
+
 /**
  * `SeoLink` karşılığı: title otomatik doldurulur.
  * @param {{ href: string, text?: string, html?: string, class?: string,
@@ -101,14 +107,19 @@ export function image(props) {
     (optimized && optimized.variants.length > 1) ||
     (remote && remote.srcset);
 
+  // `fill` + ek sınıf yoksa twMerge'e girme; ek sınıf varsa çakışma çözümü gerekir.
+  const fillClass = fill
+    ? className
+      ? cn(IMAGE_FILL_CLASS, className)
+      : IMAGE_FILL_CLASS
+    : className;
+
   const attributes = attrs({
     src: largest?.url ?? remote?.src ?? src,
     alt: alt ?? "",
     width: fill ? undefined : (width ?? optimized?.width),
     height: fill ? undefined : (height ?? optimized?.height),
-    class: fill
-      ? cn("absolute inset-0 h-full w-full object-cover", className)
-      : className,
+    class: fillClass,
     sizes: responsive
       ? (sizes ?? (optimized ? defaultSizes(optimized) : remote?.sizes))
       : sizes,
@@ -213,7 +224,13 @@ export function icon(props) {
     attrs: extra = {},
   } = props;
 
-  const spritePath = asset("sprite.svg", { origin: "document" });
+  // Prod'da hash deploy ile birlikte değişir (process yenilenir); dev'de
+  // watch rebuild sprite yolunu güncelleyebildiği için her seferinde çözülür.
+  let spritePath = cachedSpritePath;
+  if (spritePath == null || isDev) {
+    spritePath = asset("sprite.svg", { origin: "document" });
+    if (!isDev) cachedSpritePath = spritePath;
+  }
   const id = `${toKebab(name)}-${weight}`;
 
   if (isDev && !warnedIcons.has(id)) {

package/types/client/registry.d.ts

@@ -16,6 +16,8 @@
  * `data-island-idle` görünür olsa bile sayfa sakinleşene (load + boş zaman)
  * kadar bekletir. İlk ekranda görünen ama kritik olmayan ağır modüller
  * (ör. grafik kütüphanesi çeken mini grafik) LCP ile yarışmasın diye.
+ * Gizli (zero-box) host'larda da aynı yol kullanılır — `hydrate()` onları
+ * `mountWhenReady` ile bağlar, hemen `mountIsland` çağırmaz.
  *
  * `data-island-props` JSON ise parse edilip props olarak geçer.
  */

package/types/compile/codegen.d.ts

@@ -1,9 +1,5 @@
 export type AstNode = import('./parse.js').AstNode;
 export type AttrNode = import('./parse.js').AttrNode;
-/**
- * @typedef {import('./parse.js').AstNode} AstNode
- * @typedef {import('./parse.js').AttrNode} AttrNode
- */
 /**
  * @param {AstNode[]} ast
  * @param {{ viewId: string, file?: string, knownComponents?: Set<string> }} options
@@ -30,3 +26,12 @@ export declare function normalizeIncludeId(includePath: string): string;
  * @returns {string}
  */
 export declare function toPascalCase(name: string): string;
+/**
+ * Şablon girintisini düşür: satır sonu içeren salt-whitespace → boş;
+ * yalnızca boşluk/tab → tek boşluk (inline aralık). Koruma alanı dışında.
+ *
+ * @param {string} value
+ * @param {boolean} preserve
+ * @returns {string}
+ */
+export declare function collapseTemplateWhitespace(value: string, preserve: boolean): string;

package/types/compile/compile-all.d.ts

@@ -12,7 +12,9 @@ export declare function compileAll(config: {
     outDir: string;
 }>;
 /**
- * Manifest yoksa veya herhangi bir `.jsk` daha yeniyse yeniden derler.
+ * Manifest yoksa veya (dev'de) herhangi bir `.jsk` daha yeniyse yeniden derler.
+ * Production'da manifest varsa mtime taraması atlanır — `jskelet build` CI
+ * güvencesi; ilk istekte yüzlerce `statSync` cold start'ı şişirmesin.
  * Dev sunucu restart'ında build watch kaçırmış olsa bile şablonlar güncel kalır.
  *
  * @param {{ root: string, dirs: Record<string, string> }} config

package/types/compile/index.d.ts

@@ -4,7 +4,7 @@
 export { CompileError, indexToLocation } from "./errors.js";
 export { parseExpr, codegenExpr } from "./expr.js";
 export { parseTemplate, isComponentTag } from "./parse.js";
-export { codegen, toPascalCase, normalizeIncludeId } from "./codegen.js";
+export { codegen, toPascalCase, normalizeIncludeId, collapseTemplateWhitespace, } from "./codegen.js";
 export { getViewRoots, getComponentDirs, discoverJskFiles, componentNameFromViewId, collectKnownComponents, toComponentTag, } from "./resolve.js";
 export { scanNamedExports } from "./scan-exports.js";
 export { compileAll, compileSource, ensureTemplatesCompiled } from "./compile-all.js";