jskelet 0.6.2 → 0.6.3

package/src/views/helpers/tags.js

@@ -1,375 +1,375 @@
-/**
- * `next/link`, `next/image` ve `@phosphor-icons/react` karşılıkları.
- * Hepsi HTML string döndürür; şablonlarda PascalCase etiket veya
- * (legacy EJS) `<%- %>` ile basılır.
- */
-import { attrs, esc, cn, jsonScript } from "./html.js";
-import {
-  asset,
-  hasAsset,
-  getSpriteIds,
-  optimizedImage,
-} from "../../server/assets.js";
-import {
-  parseAllowedRemoteUrl,
-  remoteImageUrl,
-  srcsetWidths,
-} from "../../server/image-optimizer.js";
-import { getRequestContext, markTainted } from "../../http/request-context.js";
-import { getSignedCookie, randomToken, setSignedCookie } from "../../http/cookies.js";
-import { getConfig } from "../../config/index.js";
-
-const isDev = process.env.NODE_ENV === "development";
-
-/** Aynı eksik ikon için tek uyarı. */
-const warnedIcons = new Set();
-
-/**
- * `SeoLink` karşılığı: title otomatik doldurulur.
- * @param {{ href: string, text?: string, html?: string, class?: string,
- *   title?: string, ariaLabel?: string, target?: string, rel?: string,
- *   attrs?: Record<string, unknown> }} props
- * @returns {string}
- */
-export function link(props) {
-  const {
-    href,
-    text,
-    html,
-    class: className,
-    title,
-    ariaLabel,
-    target,
-    rel,
-    attrs: extra = {},
-  } = props;
-
-  const resolvedTitle = title ?? ariaLabel ?? text ?? href;
-  const isExternal = /^https?:\/\//.test(String(href ?? ""));
-
-  const attributes = attrs({
-    href,
-    class: className,
-    title: resolvedTitle,
-    "aria-label": ariaLabel,
-    target: target ?? (isExternal ? "_blank" : undefined),
-    rel: rel ?? (isExternal ? "noopener noreferrer" : undefined),
-    ...extra,
-  });
-
-  return `<a${attributes}>${html ?? esc(text ?? "")}</a>`;
-}
-
-/**
- * `next/image` karşılığı. `public/` altındaki yerel görseller için build'de
- * üretilen webp varyantları (`build/tasks/images.mjs`) otomatik olarak
- * `srcset` + intrinsic `width`/`height` olarak eklenir; manifest'te olmayan
- * yerel yollar olduğu gibi basılır.
- *
- * `images.remote.allowHosts` açıksa uzak http(s) URL'leri `/_jskelet/image`
- * proxy'sine çevrilir (webp + `w`). `unoptimized` veya elle `srcset` bunu
- * atlar.
- *
- * `priority` LCP görselleri için `fetchpriority=high` + eager yükleme yapar.
- * @param {{ src: string, alt: string, width?: number, height?: number,
- *   class?: string, sizes?: string, srcset?: string, priority?: boolean,
- *   fill?: boolean, loading?: 'lazy' | 'eager', unoptimized?: boolean,
- *   attrs?: Record<string, unknown> }} props
- * @returns {string}
- */
-export function image(props) {
-  const {
-    src,
-    alt,
-    width,
-    height,
-    class: className,
-    sizes,
-    srcset,
-    priority = false,
-    fill = false,
-    loading,
-    unoptimized = false,
-    attrs: extra = {},
-  } = props;
-
-  const optimized = unoptimized || srcset ? undefined : optimizedImage(src);
-  const remote = unoptimized || srcset ? null : remoteResponsive(src, width);
-  const largest = optimized?.variants.at(-1);
-  // Tek varyant üretilmişse (kaynak zaten küçükse) srcset/sizes gürültüden ibaret.
-  const responsive =
-    (optimized && optimized.variants.length > 1) ||
-    (remote && remote.srcset);
-
-  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,
-    sizes: responsive
-      ? (sizes ?? (optimized ? defaultSizes(optimized) : remote?.sizes))
-      : sizes,
-    srcset: responsive
-      ? (optimized ? toSrcSet(optimized) : remote?.srcset)
-      : srcset,
-    loading: loading ?? (priority ? "eager" : "lazy"),
-    decoding: priority ? "sync" : "async",
-    fetchpriority: priority ? "high" : undefined,
-    ...extra,
-  });
-
-  return `<img${attributes}>`;
-}
-
-/**
- * Uzak URL → optimizer `src` / `srcset`. Allowlist dışıysa null.
- * @param {string} src
- * @param {number | undefined} width
- * @returns {{ src: string, srcset?: string, sizes?: string } | null}
- */
-function remoteResponsive(src, width) {
-  if (!parseAllowedRemoteUrl(src)) return null;
-
-  const images = getConfig().images;
-  if (!images || images === false || !images.remote) return null;
-
-  const display = width && width > 0 ? width : 640;
-  const widths = srcsetWidths(display, images.widths, images.remote.maxWidth);
-  const urls = widths
-    .map((w) => {
-      const href = remoteImageUrl(src, { width: w });
-      return href ? `${href} ${w}w` : null;
-    })
-    .filter(Boolean);
-
-  const primary = remoteImageUrl(src, { width: display });
-  if (!primary) return null;
-
-  return {
-    src: primary,
-    srcset: urls.length > 1 ? urls.join(", ") : undefined,
-    sizes: `(max-width: ${display}px) 100vw, ${display}px`,
-  };
-}
-
-/**
- * @param {import("../../server/assets.js").OptimizedImage} optimized
- * @returns {string}
- */
-function toSrcSet(optimized) {
-  return optimized.variants
-    .map((variant) => `${variant.url} ${variant.width}w`)
-    .join(", ");
-}
-
-/**
- * Çağıran `sizes` vermediyse makul bir varsayılan: görsel kendi intrinsic
- * genişliğinden büyütülmez, dar ekranlarda viewport'u kaplar.
- * @param {import("../../server/assets.js").OptimizedImage} optimized
- * @returns {string}
- */
-function defaultSizes(optimized) {
-  const max = optimized.variants.at(-1)?.width ?? optimized.width;
-  return `(max-width: ${max}px) 100vw, ${max}px`;
-}
-
-/**
- * LCP görselleri için `<head>` preload etiketi.
- * @param {{ href: string, imagesrcset?: string, imagesizes?: string }} props
- * @returns {string}
- */
-export function preloadImage({ href, imagesrcset, imagesizes }) {
-  return `<link${attrs({
-    rel: "preload",
-    as: "image",
-    href,
-    imagesrcset,
-    imagesizes,
-    fetchpriority: "high",
-  })}>`;
-}
-
-/**
- * Phosphor ikonları — build zamanı üretilen SVG sprite'tan `<use>`.
- * `weight` sprite id'sine dahildir (regular/bold/fill).
- * @param {{ name: string, size?: number | string, weight?: string,
- *   class?: string, attrs?: Record<string, unknown> }} props
- * @returns {string}
- */
-export function icon(props) {
-  const {
-    name,
-    size = 24,
-    weight = "regular",
-    class: className,
-    attrs: extra = {},
-  } = props;
-
-  const spritePath = asset("sprite.svg");
-  const id = `${toKebab(name)}-${weight}`;
-
-  if (isDev && !warnedIcons.has(id)) {
-    const ids = getSpriteIds();
-    if (ids.size && !ids.has(id)) {
-      warnedIcons.add(id);
-      console.warn(
-        `[icon] missing from sprite: ${id} — write the name as a literal or add it to the build/tasks/icons.mjs scan.`,
-      );
-    }
-  }
-
-  const attributes = attrs({
-    width: size,
-    height: size,
-    class: className,
-    "aria-hidden": "true",
-    focusable: "false",
-    fill: "currentColor",
-    viewBox: "0 0 256 256",
-    ...extra,
-  });
-
-  return `<svg${attributes}><use href="${esc(spritePath)}#${esc(id)}"></use></svg>`;
-}
-
-/**
- * Formun içine CSRF token'ını gizli alan olarak basar.
- *
- * Token **burada** üretilir ve imzalı cookie olarak yazılır: bir sayfada
- * token gerçekten gerekiyorsa o sayfa zaten kişiye özeldir. Bu yüzden çağrı
- * render'ı işaretler (`tainted`) ve sayfa public HTML cache'ine giremez —
- * aksi hâlde tüm ziyaretçiler cache'ten aynı token'ı alırdı ve çift gönderim
- * kontrolü hiçbir şey doğrulamazdı.
- *
- * `security.csrf.token` kapalıysa boş string döner; şablon her koşulda
- * render edilebilmeli, korumanın açık olması config'in kararı.
- *
- * @returns {string}
- */
-export function csrfField() {
-  const context = getRequestContext();
-  if (!context?.res) return "";
-
-  const { csrf } = getConfig().security;
-  if (!csrf.token) return "";
-
-  if (!context.csrfToken) {
-    const existing = getSignedCookie(context.res.req, csrf.cookieName);
-    const token = existing ?? randomToken(24);
-
-    if (!existing) {
-      try {
-        setSignedCookie(context.res, csrf.cookieName, token, {
-          // Token'ı istemci cookie'den değil, basılan gizli alandan okur;
-          // HttpOnly kalması XSS durumunda bir katman daha demek.
-          httpOnly: true,
-        });
-      } catch (error) {
-        console.warn(
-          "[csrf] could not emit the token: no secret for signed cookies",
-          error instanceof Error ? error.message : error,
-        );
-        return "";
-      }
-    }
-
-    context.csrfToken = token;
-  }
-
-  markTainted("csrfField()");
-
-  return `<input type="hidden" name="${esc(csrf.fieldName)}" value="${esc(context.csrfToken)}">`;
-}
-
-/**
- * `ArrowRightIcon` / `ArrowRight` → `arrow-right`
- * @param {string} name
- * @returns {string}
- */
-export function toKebab(name) {
-  return String(name)
-    .replace(/Icon$/, "")
-    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
-    .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
-    .toLowerCase();
-}
-
-/**
- * Layout `<head>` stylesheet'leri. `hasAsset` false olanları basmaz —
- * 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]
- * @returns {string}
- */
-export function stylesheets(props = {}) {
-  const styles = Array.isArray(props.styles) ? props.styles : [];
-  /** @type {string[]} */
-  const parts = [];
-
-  if (hasAsset("app.css")) {
-    parts.push(
-      `<link rel="stylesheet" href="${esc(asset("app.css"))}" data-jskelet-css="app.css">`,
-    );
-  }
-
-  for (const sheet of styles) {
-    if (!sheet || !hasAsset(sheet)) continue;
-    parts.push(
-      `<link rel="stylesheet" href="${esc(asset(sheet))}" data-jskelet-css="${esc(sheet)}">`,
-    );
-  }
-
-  return parts.join("\n    ");
-}
-
-/**
- * Layout gövde sonu script'leri: `main.js`, controller `entries`, isteğe
- * bağlı dev overlay.
- *
- * @param {{ entries?: string[], devtools?: boolean, devBasePath?: string }} [props]
- * @returns {string}
- */
-export function bodyScripts(props = {}) {
-  const entries = Array.isArray(props.entries) ? props.entries : [];
-  const devBasePath = props.devBasePath ?? "/__jskelet/dev";
-  /** @type {string[]} */
-  const parts = [];
-
-  if (hasAsset("main.js")) {
-    parts.push(`<script type="module" src="${esc(asset("main.js"))}"></script>`);
-  }
-
-  for (const entry of entries) {
-    if (!entry) continue;
-    parts.push(`<script type="module" src="${esc(asset(entry))}"></script>`);
-  }
-
-  if (props.devtools) {
-    parts.push(
-      `<script type="module" src="${esc(devBasePath)}/overlay.js"></script>`,
-    );
-  }
-
-  return parts.join("\n    ");
-}
-
-/**
- * JSON-LD script etiketleri. `structuredData` dizisindeki her öğe için bir
- * `<script type="application/ld+json">`.
- *
- * @param {{ items?: unknown[] }} [props]
- * @returns {string}
- */
-export function jsonLd(props = {}) {
-  const items = Array.isArray(props.items) ? props.items : [];
-  return items
-    .map(
-      (item) =>
-        `<script type="application/ld+json">${jsonScript(item)}</script>`,
-    )
-    .join("\n    ");
-}
+/**
+ * `next/link`, `next/image` ve `@phosphor-icons/react` karşılıkları.
+ * Hepsi HTML string döndürür; şablonlarda PascalCase etiket veya
+ * (legacy EJS) `<%- %>` ile basılır.
+ */
+import { attrs, esc, cn, jsonScript } from "./html.js";
+import {
+  asset,
+  hasAsset,
+  getSpriteIds,
+  optimizedImage,
+} from "../../server/assets.js";
+import {
+  parseAllowedRemoteUrl,
+  remoteImageUrl,
+  srcsetWidths,
+} from "../../server/image-optimizer.js";
+import { getRequestContext, markTainted } from "../../http/request-context.js";
+import { getSignedCookie, randomToken, setSignedCookie } from "../../http/cookies.js";
+import { getConfig } from "../../config/index.js";
+
+const isDev = process.env.NODE_ENV === "development";
+
+/** Aynı eksik ikon için tek uyarı. */
+const warnedIcons = new Set();
+
+/**
+ * `SeoLink` karşılığı: title otomatik doldurulur.
+ * @param {{ href: string, text?: string, html?: string, class?: string,
+ *   title?: string, ariaLabel?: string, target?: string, rel?: string,
+ *   attrs?: Record<string, unknown> }} props
+ * @returns {string}
+ */
+export function link(props) {
+  const {
+    href,
+    text,
+    html,
+    class: className,
+    title,
+    ariaLabel,
+    target,
+    rel,
+    attrs: extra = {},
+  } = props;
+
+  const resolvedTitle = title ?? ariaLabel ?? text ?? href;
+  const isExternal = /^https?:\/\//.test(String(href ?? ""));
+
+  const attributes = attrs({
+    href,
+    class: className,
+    title: resolvedTitle,
+    "aria-label": ariaLabel,
+    target: target ?? (isExternal ? "_blank" : undefined),
+    rel: rel ?? (isExternal ? "noopener noreferrer" : undefined),
+    ...extra,
+  });
+
+  return `<a${attributes}>${html ?? esc(text ?? "")}</a>`;
+}
+
+/**
+ * `next/image` karşılığı. `public/` altındaki yerel görseller için build'de
+ * üretilen webp varyantları (`build/tasks/images.mjs`) otomatik olarak
+ * `srcset` + intrinsic `width`/`height` olarak eklenir; manifest'te olmayan
+ * yerel yollar olduğu gibi basılır.
+ *
+ * `images.remote.allowHosts` açıksa uzak http(s) URL'leri `/_jskelet/image`
+ * proxy'sine çevrilir (webp + `w`). `unoptimized` veya elle `srcset` bunu
+ * atlar.
+ *
+ * `priority` LCP görselleri için `fetchpriority=high` + eager yükleme yapar.
+ * @param {{ src: string, alt: string, width?: number, height?: number,
+ *   class?: string, sizes?: string, srcset?: string, priority?: boolean,
+ *   fill?: boolean, loading?: 'lazy' | 'eager', unoptimized?: boolean,
+ *   attrs?: Record<string, unknown> }} props
+ * @returns {string}
+ */
+export function image(props) {
+  const {
+    src,
+    alt,
+    width,
+    height,
+    class: className,
+    sizes,
+    srcset,
+    priority = false,
+    fill = false,
+    loading,
+    unoptimized = false,
+    attrs: extra = {},
+  } = props;
+
+  const optimized = unoptimized || srcset ? undefined : optimizedImage(src);
+  const remote = unoptimized || srcset ? null : remoteResponsive(src, width);
+  const largest = optimized?.variants.at(-1);
+  // Tek varyant üretilmişse (kaynak zaten küçükse) srcset/sizes gürültüden ibaret.
+  const responsive =
+    (optimized && optimized.variants.length > 1) ||
+    (remote && remote.srcset);
+
+  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,
+    sizes: responsive
+      ? (sizes ?? (optimized ? defaultSizes(optimized) : remote?.sizes))
+      : sizes,
+    srcset: responsive
+      ? (optimized ? toSrcSet(optimized) : remote?.srcset)
+      : srcset,
+    loading: loading ?? (priority ? "eager" : "lazy"),
+    decoding: priority ? "sync" : "async",
+    fetchpriority: priority ? "high" : undefined,
+    ...extra,
+  });
+
+  return `<img${attributes}>`;
+}
+
+/**
+ * Uzak URL → optimizer `src` / `srcset`. Allowlist dışıysa null.
+ * @param {string} src
+ * @param {number | undefined} width
+ * @returns {{ src: string, srcset?: string, sizes?: string } | null}
+ */
+function remoteResponsive(src, width) {
+  if (!parseAllowedRemoteUrl(src)) return null;
+
+  const images = getConfig().images;
+  if (!images || images === false || !images.remote) return null;
+
+  const display = width && width > 0 ? width : 640;
+  const widths = srcsetWidths(display, images.widths, images.remote.maxWidth);
+  const urls = widths
+    .map((w) => {
+      const href = remoteImageUrl(src, { width: w });
+      return href ? `${href} ${w}w` : null;
+    })
+    .filter(Boolean);
+
+  const primary = remoteImageUrl(src, { width: display });
+  if (!primary) return null;
+
+  return {
+    src: primary,
+    srcset: urls.length > 1 ? urls.join(", ") : undefined,
+    sizes: `(max-width: ${display}px) 100vw, ${display}px`,
+  };
+}
+
+/**
+ * @param {import("../../server/assets.js").OptimizedImage} optimized
+ * @returns {string}
+ */
+function toSrcSet(optimized) {
+  return optimized.variants
+    .map((variant) => `${variant.url} ${variant.width}w`)
+    .join(", ");
+}
+
+/**
+ * Çağıran `sizes` vermediyse makul bir varsayılan: görsel kendi intrinsic
+ * genişliğinden büyütülmez, dar ekranlarda viewport'u kaplar.
+ * @param {import("../../server/assets.js").OptimizedImage} optimized
+ * @returns {string}
+ */
+function defaultSizes(optimized) {
+  const max = optimized.variants.at(-1)?.width ?? optimized.width;
+  return `(max-width: ${max}px) 100vw, ${max}px`;
+}
+
+/**
+ * LCP görselleri için `<head>` preload etiketi.
+ * @param {{ href: string, imagesrcset?: string, imagesizes?: string }} props
+ * @returns {string}
+ */
+export function preloadImage({ href, imagesrcset, imagesizes }) {
+  return `<link${attrs({
+    rel: "preload",
+    as: "image",
+    href,
+    imagesrcset,
+    imagesizes,
+    fetchpriority: "high",
+  })}>`;
+}
+
+/**
+ * Phosphor ikonları — build zamanı üretilen SVG sprite'tan `<use>`.
+ * `weight` sprite id'sine dahildir (regular/bold/fill).
+ * @param {{ name: string, size?: number | string, weight?: string,
+ *   class?: string, attrs?: Record<string, unknown> }} props
+ * @returns {string}
+ */
+export function icon(props) {
+  const {
+    name,
+    size = 24,
+    weight = "regular",
+    class: className,
+    attrs: extra = {},
+  } = props;
+
+  const spritePath = asset("sprite.svg");
+  const id = `${toKebab(name)}-${weight}`;
+
+  if (isDev && !warnedIcons.has(id)) {
+    const ids = getSpriteIds();
+    if (ids.size && !ids.has(id)) {
+      warnedIcons.add(id);
+      console.warn(
+        `[icon] missing from sprite: ${id} — write the name as a literal or add it to the build/tasks/icons.mjs scan.`,
+      );
+    }
+  }
+
+  const attributes = attrs({
+    width: size,
+    height: size,
+    class: className,
+    "aria-hidden": "true",
+    focusable: "false",
+    fill: "currentColor",
+    viewBox: "0 0 256 256",
+    ...extra,
+  });
+
+  return `<svg${attributes}><use href="${esc(spritePath)}#${esc(id)}"></use></svg>`;
+}
+
+/**
+ * Formun içine CSRF token'ını gizli alan olarak basar.
+ *
+ * Token **burada** üretilir ve imzalı cookie olarak yazılır: bir sayfada
+ * token gerçekten gerekiyorsa o sayfa zaten kişiye özeldir. Bu yüzden çağrı
+ * render'ı işaretler (`tainted`) ve sayfa public HTML cache'ine giremez —
+ * aksi hâlde tüm ziyaretçiler cache'ten aynı token'ı alırdı ve çift gönderim
+ * kontrolü hiçbir şey doğrulamazdı.
+ *
+ * `security.csrf.token` kapalıysa boş string döner; şablon her koşulda
+ * render edilebilmeli, korumanın açık olması config'in kararı.
+ *
+ * @returns {string}
+ */
+export function csrfField() {
+  const context = getRequestContext();
+  if (!context?.res) return "";
+
+  const { csrf } = getConfig().security;
+  if (!csrf.token) return "";
+
+  if (!context.csrfToken) {
+    const existing = getSignedCookie(context.res.req, csrf.cookieName);
+    const token = existing ?? randomToken(24);
+
+    if (!existing) {
+      try {
+        setSignedCookie(context.res, csrf.cookieName, token, {
+          // Token'ı istemci cookie'den değil, basılan gizli alandan okur;
+          // HttpOnly kalması XSS durumunda bir katman daha demek.
+          httpOnly: true,
+        });
+      } catch (error) {
+        console.warn(
+          "[csrf] could not emit the token: no secret for signed cookies",
+          error instanceof Error ? error.message : error,
+        );
+        return "";
+      }
+    }
+
+    context.csrfToken = token;
+  }
+
+  markTainted("csrfField()");
+
+  return `<input type="hidden" name="${esc(csrf.fieldName)}" value="${esc(context.csrfToken)}">`;
+}
+
+/**
+ * `ArrowRightIcon` / `ArrowRight` → `arrow-right`
+ * @param {string} name
+ * @returns {string}
+ */
+export function toKebab(name) {
+  return String(name)
+    .replace(/Icon$/, "")
+    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+    .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
+    .toLowerCase();
+}
+
+/**
+ * Layout `<head>` stylesheet'leri. `hasAsset` false olanları basmaz —
+ * 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]
+ * @returns {string}
+ */
+export function stylesheets(props = {}) {
+  const styles = Array.isArray(props.styles) ? props.styles : [];
+  /** @type {string[]} */
+  const parts = [];
+
+  if (hasAsset("app.css")) {
+    parts.push(
+      `<link rel="stylesheet" href="${esc(asset("app.css"))}" data-jskelet-css="app.css">`,
+    );
+  }
+
+  for (const sheet of styles) {
+    if (!sheet || !hasAsset(sheet)) continue;
+    parts.push(
+      `<link rel="stylesheet" href="${esc(asset(sheet))}" data-jskelet-css="${esc(sheet)}">`,
+    );
+  }
+
+  return parts.join("\n    ");
+}
+
+/**
+ * Layout gövde sonu script'leri: `main.js`, controller `entries`, isteğe
+ * bağlı dev overlay.
+ *
+ * @param {{ entries?: string[], devtools?: boolean, devBasePath?: string }} [props]
+ * @returns {string}
+ */
+export function bodyScripts(props = {}) {
+  const entries = Array.isArray(props.entries) ? props.entries : [];
+  const devBasePath = props.devBasePath ?? "/__jskelet/dev";
+  /** @type {string[]} */
+  const parts = [];
+
+  if (hasAsset("main.js")) {
+    parts.push(`<script type="module" src="${esc(asset("main.js"))}"></script>`);
+  }
+
+  for (const entry of entries) {
+    if (!entry) continue;
+    parts.push(`<script type="module" src="${esc(asset(entry))}"></script>`);
+  }
+
+  if (props.devtools) {
+    parts.push(
+      `<script type="module" src="${esc(devBasePath)}/overlay.js"></script>`,
+    );
+  }
+
+  return parts.join("\n    ");
+}
+
+/**
+ * JSON-LD script etiketleri. `structuredData` dizisindeki her öğe için bir
+ * `<script type="application/ld+json">`.
+ *
+ * @param {{ items?: unknown[] }} [props]
+ * @returns {string}
+ */
+export function jsonLd(props = {}) {
+  const items = Array.isArray(props.items) ? props.items : [];
+  return items
+    .map(
+      (item) =>
+        `<script type="application/ld+json">${jsonScript(item)}</script>`,
+    )
+    .join("\n    ");
+}