jskelet 0.7.2 → 0.7.4

package/src/views/helpers/tags.js

@@ -324,28 +324,57 @@ export function toKebab(name) {
  * build yokken 404 link'i istememek için. `.jsk` ifade dilinde `asset()` /
  * `hasAsset()` çağrılamadığı için layout bu etiketi kullanır.
  *
- * @param {{ styles?: string[] }} [props]
+ * `blocking` varsayılan `true`: `<link rel="stylesheet">` boyamayı bekletir.
+ * Ölçümde bu, sheet geç gelince oluşan CLS'ten daha ucuz. `false` yalnızca
+ * açık boolean'dır (`:blocking="false"`); atlamak veya `true` aynı çıktıyı
+ * verir.
+ *
+ * @param {{ styles?: string[], blocking?: boolean }} [props]
  * @returns {string}
  */
 export function stylesheets(props = {}) {
   const styles = Array.isArray(props.styles) ? props.styles : [];
+  const blocking = props.blocking !== false;
   /** @type {string[]} */
   const parts = [];
 
-  if (hasAsset("app.css")) {
-    parts.push(
-      `<link rel="stylesheet" href="${esc(asset("app.css"))}" data-jskelet-css="app.css">`,
-    );
-  }
+  pushStylesheet(parts, "app.css", blocking);
 
   for (const sheet of styles) {
-    if (!sheet || !hasAsset(sheet)) continue;
+    if (!sheet) continue;
+    pushStylesheet(parts, sheet, blocking);
+  }
+
+  return parts.join("\n    ");
+}
+
+/**
+ * Tek bir manifest anahtarı için stylesheet linki.
+ *
+ * `blocking: false` iken `media="print"`: eşleşmeyen media tarayıcıda
+ * render-blocking sayılmaz, indirme boyamayı bekletmez. `onload` sheet
+ * inince `media`'yı `all` yapar. JS kapalıyken `onload` çalışmaz ve link
+ * print'te kalır; `<noscript>` içindeki normal link o yolu kapatır.
+ *
+ * @param {string[]} parts
+ * @param {string} name Manifest anahtarı (`app.css`, `home.css`, …)
+ * @param {boolean} blocking
+ */
+function pushStylesheet(parts, name, blocking) {
+  if (!hasAsset(name)) return;
+
+  const href = esc(asset(name));
+  const id = esc(name);
+  if (blocking) {
     parts.push(
-      `<link rel="stylesheet" href="${esc(asset(sheet))}" data-jskelet-css="${esc(sheet)}">`,
+      `<link rel="stylesheet" href="${href}" data-jskelet-css="${id}">`,
     );
+    return;
   }
 
-  return parts.join("\n    ");
+  parts.push(
+    `<link rel="stylesheet" href="${href}" media="print" onload="this.media='all'" data-jskelet-css="${id}">\n    <noscript><link rel="stylesheet" href="${href}" data-jskelet-css="${id}"></noscript>`,
+  );
 }
 
 /**

package/types/config/defaults.d.ts

@@ -260,11 +260,19 @@ export declare const DEFAULT_REDIS: {
     /** pub/sub üzerinden invalidation yayını. */
     events: boolean;
     /**
-     * Tek bir komutun en fazla bekletebileceği süre. Önbellek okuması isteği
+     * Veri, yayın ve SCAN için tek komut tavanı. Önbellek okuması isteği
      * bloklayan bir adım: Redis takıldığında render'a düşmek, ağı beklemekten
-     * iyidir.
+     * iyidir. HTML gövdesi bu süreye sığmaz; o bağlantının tavanı
+     * `htmlCommandTimeoutMs`.
      */
     commandTimeoutMs: number;
+    /**
+     * Yalnızca HTML bağlantısı. ioredis `commandTimeout` istemci genelinde
+     * olduğu için gövde ayrı bağlantıda durur. Verilmezse 2000: uygulama
+     * config'i değiştirmek zorunda kalmasın. Parçalı yazma normalde bunun
+     * altında biter; tavan, gövde beklenmedik büyürse diye durur.
+     */
+    htmlCommandTimeoutMs: number;
 };
 /**
  * Kalıcı log sink'leri (dosya + S3).

package/types/config/index.d.ts

@@ -34,7 +34,14 @@ export type RedisConfig = {
      * pub/sub invalidation yayını.
      */
     events: boolean;
+    /**
+     * Veri, yayın ve SCAN tavanı.
+     */
     commandTimeoutMs: number;
+    /**
+     * Yalnızca HTML bağlantısının tavanı.
+     */
+    htmlCommandTimeoutMs: number;
 };
 export type LogKind = "http" | "event" | "error";
 export type LogsConfig = {

package/types/server/dev/report.d.ts

@@ -210,6 +210,8 @@ export declare function buildReport(devtools: {
             buildId: string;
             errors: number;
             bypassed: boolean;
+            htmlErrors: number;
+            htmlBypassed: boolean;
         };
     };
     upstream: {

package/types/server/redis.d.ts

@@ -48,6 +48,40 @@ export declare function redisSharesEncoded(): boolean;
  * @returns {string}
  */
 export declare function cacheKey(kind: "html" | "data", key: string): string;
+/**
+ * HTML kaydını parçalı yazar. Meta küçük JSON'dur; gövde ham brotli baytıdır
+ * (base64 yok, JSON içinde ikinci brotli yok). `encoded` varsa her kodlama
+ * `:enc:` anahtarına olduğu gibi gider.
+ *
+ * Ateşle-unut ve tek sayaç adımı: üç SET'ten biri düşerse bu bir hatadır,
+ * veri devre kesicisine yazılmaz.
+ *
+ * @param {string} key Önbellek anahtarı (`yol?query`), öneksiz.
+ * @param {Record<string, unknown>} meta
+ * @param {Buffer} body
+ * @param {Map<string, Buffer> | null} encoded
+ * @param {number} ttlMs
+ */
+export declare function redisShareHtml(key: string, meta: Record<string, unknown>, body: Buffer, encoded: Map<string, Buffer> | null, ttlMs: number): void;
+/**
+ * Meta + gövde (+ açıksa kodlamalar) tek pipeline. Parça eksikse kayıt yok
+ * sayılır; bu bir hata değildir. Bağlantı hatası HTML sayacına yazılır.
+ *
+ * @param {string} key Önbellek anahtarı (`yol?query`), öneksiz.
+ * @returns {Promise<{ html: string, status: unknown, storedAt: unknown,
+ *   expiresAt: unknown, staleUntil: unknown, produceMs: unknown, deps: unknown,
+ *   encoded: Map<string, Buffer> } | null>}
+ */
+export declare function redisGetHtml(key: string): Promise<{
+    html: string;
+    status: unknown;
+    storedAt: unknown;
+    expiresAt: unknown;
+    staleUntil: unknown;
+    produceMs: unknown;
+    deps: unknown;
+    encoded: Map<string, Buffer>;
+} | null>;
 /**
  * @param {string} key
  * @returns {Promise<any | null>} Girdi yoksa, ayrıştırılamıyorsa ya da Redis
@@ -85,7 +119,8 @@ export declare function redisDropMatching(kind: "html" | "data", match?: (key: s
  * Dev raporu için durum özeti. Bağlantı yoksa da güvenle çağrılabilir.
  *
  * @returns {{ enabled: boolean, connected: boolean, keyPrefix: string,
- *   buildId: string, errors: number, bypassed: boolean }}
+ *   buildId: string, errors: number, bypassed: boolean, htmlErrors: number,
+ *   htmlBypassed: boolean }}
  */
 export declare function getRedisStatus(): {
     enabled: boolean;
@@ -94,6 +129,8 @@ export declare function getRedisStatus(): {
     buildId: string;
     errors: number;
     bypassed: boolean;
+    htmlErrors: number;
+    htmlBypassed: boolean;
 };
 /**
  * Bağlantının **nereye** kurulduğu ve hangi ayarlarla çalıştığı.
@@ -106,7 +143,7 @@ export declare function getRedisStatus(): {
  * @returns {{ address: string, secure: boolean, db: string | null,
  *   namespace: string, keyPrefix: string, html: boolean, data: boolean,
  *   storeEncoded: boolean, events: boolean, commandTimeoutMs: number,
- *   subscribed: boolean }}
+ *   htmlCommandTimeoutMs: number, subscribed: boolean }}
  */
 export declare function getRedisDetails(): {
     address: string;
@@ -119,6 +156,7 @@ export declare function getRedisDetails(): {
     storeEncoded: boolean;
     events: boolean;
     commandTimeoutMs: number;
+    htmlCommandTimeoutMs: number;
     subscribed: boolean;
 };
 /**
@@ -152,8 +190,10 @@ export declare function disconnectRedis(): Promise<void>;
  *
  * @param {any} fake `null` → katman kapatılır.
  * @param {Partial<RedisConfig>} [overrides]
+ * @param {any} [htmlFake] Verilmezse `fake` hem veri hem HTML istemcisidir.
+ *   HTML zaman aşımını veri sayacından ayırmak için ayrı bir sahte verilir.
  */
-export declare function setRedisClientForTests(fake: any, overrides?: Partial<RedisConfig>): void;
+export declare function setRedisClientForTests(fake: any, overrides?: Partial<RedisConfig>, htmlFake?: any): void;
 /**
  * Testler için: abone kanalından gelmiş gibi olay besler. `originId`
  * verilmezse uzak bir node varsayılır; kendi kimliğini taşıyan bir yayını

package/types/views/helpers/tags.d.ts

@@ -102,11 +102,17 @@ export declare function toKebab(name: string): string;
  * build yokken 404 link'i istememek için. `.jsk` ifade dilinde `asset()` /
  * `hasAsset()` çağrılamadığı için layout bu etiketi kullanır.
  *
- * @param {{ styles?: string[] }} [props]
+ * `blocking` varsayılan `true`: `<link rel="stylesheet">` boyamayı bekletir.
+ * Ölçümde bu, sheet geç gelince oluşan CLS'ten daha ucuz. `false` yalnızca
+ * açık boolean'dır (`:blocking="false"`); atlamak veya `true` aynı çıktıyı
+ * verir.
+ *
+ * @param {{ styles?: string[], blocking?: boolean }} [props]
  * @returns {string}
  */
 export declare function stylesheets(props?: {
     styles?: string[];
+    blocking?: boolean;
 }): string;
 /**
  * Layout gövde sonu script'leri: `main.js`, controller `entries`, isteğe