npm - jskelet - Versions diffs - 0.5.5 → 0.6.1 - Mend

jskelet 0.5.5 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (156) hide show

package/AGENTS.md +19 -15
package/CHANGELOG.md +165 -15
package/README.md +16 -21
package/bin/jskelet.mjs +23 -9
package/docs/01-baslangic.md +4 -3
package/docs/02-mimari.md +10 -4
package/docs/03-routing.md +14 -7
package/docs/04-render-ve-sablonlar.md +60 -43
package/docs/05-islands.md +12 -8
package/docs/06-cache.md +18 -7
package/docs/07-yapilandirma.md +69 -27
package/docs/08-build.md +15 -9
package/docs/09-dev-araclari.md +22 -8
package/docs/10-dagitim.md +14 -13
package/docs/11-tasima.md +51 -17
package/docs/12-panel-ve-oturum.md +10 -4
package/docs/README.md +10 -33
package/docs/en/01-getting-started.md +4 -3
package/docs/en/02-architecture.md +12 -6
package/docs/en/03-routing.md +15 -8
package/docs/en/04-rendering.md +71 -59
package/docs/en/05-islands.md +13 -8
package/docs/en/06-caching.md +21 -7
package/docs/en/07-configuration.md +69 -29
package/docs/en/08-build.md +16 -10
package/docs/en/09-dev-tools.md +24 -8
package/docs/en/10-deployment.md +14 -14
package/docs/en/11-migration.md +51 -16
package/docs/en/12-dashboards-and-sessions.md +9 -4
package/docs/en/README.md +10 -35
package/package.json +48 -13
package/src/build/tasks/client.mjs +91 -10
package/src/build/tasks/icons.mjs +11 -1
package/src/client/index.js +2 -2
package/src/compile/codegen.js +4 -0
package/src/compile/compile-all.js +12 -21
package/src/compile/expr.js +5 -0
package/src/compile/parse.js +64 -8
package/src/compile/resolve.js +3 -0
package/src/config/defaults.js +48 -5
package/src/config/index.js +138 -27
package/src/dev-server.mjs +26 -3
package/src/http/cookies-entry.js +1 -0
package/src/http/cookies.js +18 -0
package/src/logo.png +0 -0
package/src/migrate/apply.mjs +262 -0
package/src/migrate/babel.mjs +79 -0
package/src/migrate/classify.mjs +155 -0
package/src/migrate/config.mjs +126 -0
package/src/migrate/fs-walk.mjs +191 -0
package/src/migrate/parse.mjs +26 -0
package/src/migrate/scan.mjs +177 -0
package/src/migrate/transform/expr-source.mjs +168 -0
package/src/migrate/transform/island.mjs +67 -0
package/src/migrate/transform/jsx-to-component.mjs +302 -0
package/src/migrate/transform/jsx-to-jsk.mjs +330 -0
package/src/migrate/transform/page-split.mjs +435 -0
package/src/migrate/write.mjs +81 -0
package/src/migrate.mjs +171 -0
package/src/server/auth/handoff.js +94 -11
package/src/server/create-app.js +37 -10
package/src/server/ejs-adapter.js +59 -0
package/src/server/html-cache.js +178 -32
package/src/server/image-optimizer.js +94 -26
package/src/server/middleware/dev-gate.js +21 -8
package/src/server/middleware/robots-txt.js +341 -0
package/src/server/port-guard.js +255 -0
package/src/server/prewarm.js +137 -51
package/src/server/render.js +30 -10
package/src/server/status-page.js +105 -4
package/src/start.mjs +18 -3
package/src/templates/layout.ejs +8 -28
package/src/templates/layout.jsk +30 -0
package/src/templates/layout.render.js +41 -0
package/src/views/helpers/tags.js +86 -3
package/types/build/resolve-peer.d.mts +13 -0
package/types/client/dom.d.ts +55 -0
package/types/client/form.d.ts +19 -0
package/types/client/index.d.ts +20 -0
package/types/client/registry.d.ts +53 -0
package/types/client/safe-image.d.ts +19 -0
package/types/client/shared-cookie.d.ts +82 -0
package/types/client/store.d.ts +18 -0
package/types/client/swap.d.ts +46 -0
package/types/compile/codegen.d.ts +32 -0
package/types/compile/compile-all.d.ts +42 -0
package/types/compile/errors.d.ts +30 -0
package/types/compile/expr.d.ts +67 -0
package/types/compile/index.d.ts +10 -0
package/types/compile/parse.d.ts +82 -0
package/types/compile/resolve.d.ts +46 -0
package/types/compile/scan-exports.d.ts +9 -0
package/types/config/defaults.d.ts +477 -0
package/types/config/index.d.ts +304 -0
package/types/config/pattern.d.ts +38 -0
package/types/http/control-flow.d.ts +45 -0
package/types/http/cookies-entry.d.ts +5 -0
package/types/http/cookies.d.ts +113 -0
package/types/http/request-cache.d.ts +13 -0
package/types/http/request-context.d.ts +67 -0
package/types/http/shared-cookie.d.ts +73 -0
package/types/index.d.ts +30 -0
package/types/log.d.mts +153 -0
package/types/server/admin/actions.d.ts +16 -0
package/types/server/admin/auth.d.ts +52 -0
package/types/server/admin/event-log.d.ts +38 -0
package/types/server/admin/gate.d.ts +43 -0
package/types/server/admin/inventory.d.ts +40 -0
package/types/server/admin/mount.d.ts +6 -0
package/types/server/admin/router.d.ts +6 -0
package/types/server/admin/snapshot.d.ts +6 -0
package/types/server/assets.d.ts +47 -0
package/types/server/auth/handoff.d.ts +12 -0
package/types/server/cache-deps.d.ts +16 -0
package/types/server/cache-vary.d.ts +30 -0
package/types/server/cloudflare.d.ts +163 -0
package/types/server/create-app.d.ts +25 -0
package/types/server/data-cache.d.ts +116 -0
package/types/server/dev/devtools.d.ts +44 -0
package/types/server/dev/report.d.ts +229 -0
package/types/server/dev/socket.d.ts +17 -0
package/types/server/dev/version-check.d.mts +15 -0
package/types/server/ejs-adapter.d.ts +11 -0
package/types/server/head-hints.d.ts +40 -0
package/types/server/html-cache.d.ts +207 -0
package/types/server/image-optimizer.d.ts +68 -0
package/types/server/logs/access-middleware.d.ts +7 -0
package/types/server/logs/file-sink.d.ts +17 -0
package/types/server/logs/pipeline.d.ts +37 -0
package/types/server/logs/s3-put.d.ts +85 -0
package/types/server/logs/s3-sink.d.ts +26 -0
package/types/server/metadata.d.ts +38 -0
package/types/server/middleware/compression.d.ts +17 -0
package/types/server/middleware/csrf.d.ts +4 -0
package/types/server/middleware/dev-gate.d.ts +2 -0
package/types/server/middleware/headers.d.ts +2 -0
package/types/server/middleware/redirects.d.ts +2 -0
package/types/server/middleware/robots-txt.d.ts +33 -0
package/types/server/middleware/static-precompressed.d.ts +5 -0
package/types/server/middleware/trailing-slash.d.ts +11 -0
package/types/server/middleware/upstream-proxy.d.ts +21 -0
package/types/server/og-image.d.ts +149 -0
package/types/server/port-guard.d.ts +50 -0
package/types/server/prewarm.d.ts +131 -0
package/types/server/redis.d.ts +163 -0
package/types/server/render.d.ts +101 -0
package/types/server/router.d.ts +5 -0
package/types/server/status-page.d.ts +24 -0
package/types/server/upstream-limiter.d.ts +123 -0
package/types/server/upstream-tracking.d.ts +42 -0
package/types/shared/cookie-domain.d.ts +29 -0
package/types/templates/layout.render.d.ts +7 -0
package/types/version.d.mts +10 -0
package/types/views/components/loader.d.ts +5 -0
package/types/views/helpers/html.d.ts +39 -0
package/types/views/helpers/tags.d.ts +127 -0

package/src/server/status-page.js CHANGED Viewed

@@ -5,11 +5,12 @@
  * "Internal Server Error" çıktısını görmesi istenmiyor; bu yüzden framework
  * şablonsuz, tek dosyada duran minimal bir HTML üretir.
  *
- * Metin bilinçli olarak yalın: yalnızca bir şeyin ters gittiğini söyler.
- * Marka adı, ürün tanıtımı ya da hata ayrıntısı yok — hata sayfası
- * ziyaretçiye bir şey satmaz ve sunucunun içini dışa açmaz.
+ * Production metni bilinçli olarak yalın: yalnızca bir şeyin ters gittiğini
+ * söyler. Marka adı, ürün tanıtımı ya da hata ayrıntısı yok — hata sayfası
+ * ziyaretçiye bir şey satmaz ve sunucunun içini dışa açmaz. Development'ta
+ * 5xx için ayrıntılı teşhis sayfası üretilir (aşağıya bak).
  *
- * Ezme yolları (öncelik sırasıyla):
+ * Ezme yolları (öncelik sırasıyla; development 5xx hariç):
  *   1. `hooks.notFound()` — yalnızca 404 için, geriye dönük uyumluluk.
  *   2. `hooks.error({ status })` — tüm durumlar için; sayfa tanımı ya da
  *      doğrudan HTML string döner.
@@ -23,11 +24,19 @@ import { esc } from "../views/helpers/html.js";
  * hata sayfasının kendisi patlarsa ziyaretçi boş yanıt görür, bu yüzden her
  * başarısızlık gömülü HTML'e düşer.
  *
+ * Development'ta 5xx yanıtları `hooks.error` ve gömülü 500 sayfasını atlar;
+ * yığın izini içeren bir teşhis sayfası döner. Production'da ayrıntı
+ * gösterilmez — sunucu içi ziyaretçiye açılmaz.
+ *
  * @param {number} status
  * @param {{ error?: unknown }} [options]
  * @returns {Promise<string>}
  */
 export async function renderStatusPage(status, options = {}) {
+  if (process.env.NODE_ENV === "development" && status >= 500) {
+    return developmentErrorPage(status, options.error);
+  }
   const page =
     (status === 404 ? await hook("notFound", null) : null) ??
     (await hook("error", null, { status, error: options.error }));
@@ -162,3 +171,95 @@ p { margin: 0.375rem 0 0; color: var(--muted); }
 </body>
 </html>`;
 }
+/**
+ * Development teşhis sayfası: mesaj + yığın izi. Yalnızca
+ * `NODE_ENV=development` iken `renderStatusPage` üzerinden çağrılır;
+ * production yolu buraya hiç girmez.
+ *
+ * @param {number} status
+ * @param {unknown} [error]
+ * @returns {string}
+ */
+function developmentErrorPage(status, error) {
+  const name =
+    error instanceof Error && error.name ? error.name : "Error";
+  const message =
+    error instanceof Error
+      ? error.message || "(no message)"
+      : error == null
+        ? "(no error object)"
+        : String(error);
+  const body = serializeError(error);
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="robots" content="noindex, nofollow">
+<title>${status} — ${esc(name)}: ${esc(message)}</title>
+<style>
+:root { color-scheme: light dark; --fg: #18181b; --muted: #71717a; --bg: #fafafa; --panel: #fff; --border: #e4e4e7; }
+@media (prefers-color-scheme: dark) {
+  :root { --fg: #f4f4f5; --muted: #a1a1aa; --bg: #09090b; --panel: #18181b; --border: #27272a; }
+}
+html, body { margin: 0; background: var(--bg); color: var(--fg); }
+body {
+  padding: 1.5rem; max-width: 56rem; margin: 0 auto;
+  font: 1rem/1.5 system-ui, -apple-system, "Segoe UI", sans-serif;
+}
+.banner {
+  display: inline-block; margin: 0 0 1rem; padding: 0.2rem 0.5rem;
+  font-size: 0.75rem; font-weight: 600; letter-spacing: 0.04em;
+  text-transform: uppercase; color: var(--muted); border: 1px solid var(--border);
+}
+.code { font-size: 2.5rem; font-weight: 600; letter-spacing: -0.02em; margin: 0; }
+h1 { font-size: 1.25rem; font-weight: 600; margin: 0.5rem 0 0; word-break: break-word; }
+pre {
+  margin: 1.25rem 0 0; padding: 1rem; overflow: auto;
+  background: var(--panel); border: 1px solid var(--border);
+  font: 0.8125rem/1.55 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  white-space: pre-wrap; word-break: break-word;
+}
+</style>
+</head>
+<body>
+<p class="banner">Development only — not shown in production</p>
+<p class="code">${status}</p>
+<h1>${esc(name)}: ${esc(message)}</h1>
+<pre>${esc(body)}</pre>
+</body>
+</html>`;
+}
+/**
+ * Hata nesnesini yığın izi + `cause` zinciriyle metne çevirir.
+ *
+ * @param {unknown} error
+ * @returns {string}
+ */
+function serializeError(error) {
+  if (error == null) return "(no error object)";
+  /** @type {string[]} */
+  const parts = [];
+  /** @type {unknown} */
+  let current = error;
+  let depth = 0;
+  while (current != null && depth < 6) {
+    if (depth > 0) parts.push("\nCaused by:");
+    if (current instanceof Error) {
+      parts.push(current.stack || `${current.name}: ${current.message}`);
+      current = "cause" in current ? current.cause : undefined;
+    } else {
+      parts.push(String(current));
+      break;
+    }
+    depth += 1;
+  }
+  return parts.join("\n");
+}

package/src/start.mjs CHANGED Viewed

@@ -1,7 +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 "./build/ensure-build.mjs";
-import { startServer } from "./server/create-app.js";
+import process from "node:process";
+import { ensurePortFree } from "./server/port-guard.js";
-await startServer();
+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 CHANGED Viewed

@@ -1,9 +1,10 @@
 <%#
-  JSkelet varsayılan layout'u.
+  JSkelet varsayılan layout'unun legacy EJS kopyası.
-  Uygulama `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.
+  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,
@@ -18,33 +19,12 @@
     <%# 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 %>
-    <%# Global sheet + controller `styles: [...]` sayfa sheet'leri.
-        data-jskelet-css: dev hot-swap doğru link'i bulsun diye. %>
-    <% if (hasAsset('app.css')) { %>
-    <link rel="stylesheet" href="<%= asset('app.css') %>" data-jskelet-css="app.css">
-    <% } %>
-    <% styles.forEach(function (sheet) { %>
-      <% if (hasAsset(sheet)) { %>
-    <link rel="stylesheet" href="<%= asset(sheet) %>" data-jskelet-css="<%= sheet %>">
-      <% } %>
-    <% }); %>
+    <%- stylesheets({ styles }) %>
     <%- headMeta %>
-    <% structuredData.forEach(function (item) { %>
-    <script type="application/ld+json"><%- jsonScript(item) %></script>
-    <% }); %>
+    <%- jsonLd({ items: structuredData }) %>
   </head>
   <body class="<%= bodyClass %>">
     <%- body %>
-    <%# Island runtime; entry yoksa sayfa yine tam çalışır (sadece JS'siz). %>
-    <% if (hasAsset('main.js')) { %>
-    <script type="module" src="<%= asset('main.js') %>"></script>
-    <% } %>
-    <% entries.forEach(function (entry) { %>
-    <script type="module" src="<%= asset(entry) %>"></script>
-    <% }); %>
-    <%# Dev overlay: prod build'de yok, yalnızca `jskelet dev` sunucusundan. %>
-    <% if (devtools) { %>
-    <script type="module" src="<%= devBasePath %>/overlay.js"></script>
-    <% } %>
+    <%- bodyScripts({ entries, devtools, devBasePath }) %>
   </body>
 </html>

package/src/templates/layout.jsk ADDED Viewed

@@ -0,0 +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>

package/src/templates/layout.render.js ADDED Viewed

@@ -0,0 +1,41 @@
+/** @generated by scripts/compile-framework-layout.mjs — do not edit */
+/**
+ * @param {Record<string, unknown>} data
+ * @param {Record<string, any>} helpers
+ * @returns {string}
+ */
+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 += (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";
+  return s;
+}

package/src/views/helpers/tags.js CHANGED Viewed

@@ -1,9 +1,15 @@
 /**
  * `next/link`, `next/image` ve `@phosphor-icons/react` karşılıkları.
- * Hepsi HTML string döndürür; EJS içinden `<%- %>` ile basılır.
+ * Hepsi HTML string döndürür; şablonlarda PascalCase etiket veya
+ * (legacy EJS) `<%- %>` ile basılır.
  */
-import { attrs, esc, cn } from "./html.js";
-import { asset, getSpriteIds, optimizedImage } from "../../server/assets.js";
+import { attrs, esc, cn, jsonScript } from "./html.js";
+import {
+  asset,
+  hasAsset,
+  getSpriteIds,
+  optimizedImage,
+} from "../../server/assets.js";
 import {
   parseAllowedRemoteUrl,
   remoteImageUrl,
@@ -290,3 +296,80 @@ export function toKebab(name) {
     .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    ");
+}

package/types/build/resolve-peer.d.mts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * @param {string} root Uygulama kökü.
+ * @param {string} specifier
+ * @returns {Promise<any>}
+ * @throws Paket bulunamazsa; zorunlu bağımlılıklar için.
+ */
+export declare function importFromApp(root: string, specifier: string): Promise<any>;
+/**
+ * @param {string} root
+ * @param {string} specifier
+ * @returns {Promise<any | null>} Paket yoksa `null`; adım atlanabilsin diye.
+ */
+export declare function tryImportFromApp(root: string, specifier: string): Promise<any | null>;

package/types/client/dom.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+/** Island'ların paylaştığı küçük DOM yardımcıları. */
+/**
+ * @param {ParentNode} root
+ * @param {string} selector
+ * @returns {HTMLElement | null}
+ */
+export declare function qs(root: ParentNode, selector: string): HTMLElement | null;
+/**
+ * @param {ParentNode} root
+ * @param {string} selector
+ * @returns {HTMLElement[]}
+ */
+export declare function qsa(root: ParentNode, selector: string): HTMLElement[];
+/**
+ * Otomatik temizlenebilir listener.
+ * @param {EventTarget} target
+ * @param {string} type
+ * @param {EventListenerOrEventListenerObject} handler
+ * @param {AddEventListenerOptions | boolean} [options]
+ * @returns {() => void}
+ */
+export declare function on(target: EventTarget, type: string, handler: EventListenerOrEventListenerObject, options?: AddEventListenerOptions | boolean): () => void;
+/**
+ * `data-*` üzerinden delege edilmiş click.
+ * @param {HTMLElement} root
+ * @param {string} selector
+ * @param {(event: MouseEvent, target: HTMLElement) => void} handler
+ * @returns {() => void}
+ */
+export declare function onClick(root: HTMLElement, selector: string, handler: (event: MouseEvent, target: HTMLElement) => void): () => void;
+/**
+ * @param {number} ms
+ * @param {(...args: any[]) => void} fn
+ * @returns {(...args: any[]) => void}
+ */
+export declare function debounce(ms: number, fn: (...args: any[]) => void): (...args: any[]) => void;
+/**
+ * requestAnimationFrame ile birleştirilmiş çağrı.
+ * @param {() => void} fn
+ * @returns {() => void}
+ */
+export declare function raf(fn: () => void): () => void;
+/**
+ * @param {HTMLElement} element
+ * @param {string} name
+ * @param {boolean} active
+ */
+export declare function toggleClass(element: HTMLElement, name: string, active: boolean): void;
+/**
+ * Overlay portal hedefi: layout'ta `<div id="jskelet-overlays">` varsa
+ * modal/drawer içeriği oraya taşınır, yoksa `body`ye. Portal, `overflow`
+ * ya da `transform` taşıyan bir ata elementin `position: fixed` overlay'i
+ * kırpmasını engeller.
+ */
+export declare function getOverlayRoot(): HTMLElement;

package/types/client/form.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+/**
+ * Tek bir formu bağlar.
+ *
+ * `data-target` verilirse başarılı yanıtın gövdesi o bölgeye takılır; yoksa
+ * yanıt formun kendisini değiştirir (doğrulama hatalarının geldiği yol).
+ *
+ * @param {HTMLFormElement} form
+ * @returns {() => void} Dinleyiciyi söken fonksiyon.
+ */
+export declare function enhanceForm(form: HTMLFormElement): () => void;
+/**
+ * `data-enhance` taşıyan formları tek bir delege dinleyiciyle bağlar.
+ * `submit` olayı köpürdüğü için sonradan DOM'a giren (fragment ile gelen)
+ * formlar da kapsanır ve her takastan sonra yeniden bağlama gerekmez.
+ *
+ * @param {ParentNode} [root]
+ * @returns {() => void}
+ */
+export declare function startForms(root?: ParentNode): () => void;

package/types/client/index.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+/**
+ * JSkelet island runtime'ının tarayıcı tarafı API'si.
+ *
+ * `client/entries/main.js` (veya `main.ts`) içinde:
+ *
+ *   import { registerAll, start } from "jskelet/client";
+ *
+ *   registerAll({
+ *     counter: () => import("../islands/counter.ts"),
+ *   });
+ *
+ *   start();
+ */
+export { register, registerAll, hydrate, unmount, observeDocument, start, } from "./registry.js";
+export { swap, startSwapLinks } from "./swap.js";
+export { enhanceForm, startForms } from "./form.js";
+export { createStore } from "./store.js";
+export { debounce, on, onClick, qs, qsa, raf, toggleClass, getOverlayRoot, } from "./dom.js";
+export { startSafeImages } from "./safe-image.js";
+export { clearSharedCookie, consumeWindowNameHandoff, createHandoffUrl, handoffViaWindowName, readCookie, resolveSharedCookieDomain, SHARED_COOKIE_WARN_BYTES, writeSharedCookie, } from "./shared-cookie.js";

package/types/client/registry.d.ts ADDED Viewed

@@ -0,0 +1,53 @@
+/**
+ * Island registry.
+ *
+ * Sunucu HTML'i tamdır; JS yalnızca davranış ekler. Bir element
+ * `data-island="ad"` taşıdığında ilgili modül dinamik import edilir ve
+ * `mount(element, props)` çağrılır.
+ *
+ * Hidrasyon **varsayılan olarak görünürlüğe bağlıdır**: her island bir
+ * IntersectionObserver'a verilir, ekranda olanlar zaten ilk gözlemde tetiklenir,
+ * ekran dışındakiler kaydırılana kadar hiç indirilmez. Ana sayfadaki grafik
+ * kütüphanesi gibi ağır modüller böylece ilk yükten tamamen çıkar.
+ *
+ * `data-island-eager` görünürlükten bağımsız, hemen bağlanmayı zorlar
+ * (header, çerez bandı gibi global davranışlar için).
+ *
+ * `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.
+ *
+ * `data-island-props` JSON ise parse edilip props olarak geçer.
+ */
+export type MountFn = (element: HTMLElement, props: object) => void | (() => void);
+/**
+ * @param {string} name
+ * @param {() => Promise<{ mount: MountFn }>} loader
+ */
+export declare function register(name: string, loader: () => Promise<{
+    mount: MountFn;
+}>): void;
+/** @param {Record<string, () => Promise<{ mount: MountFn }>>} entries */
+export declare function registerAll(entries: Record<string, () => Promise<{
+    mount: MountFn;
+}>>): void;
+/**
+ * Bir alt ağaçtaki island'ları söker.
+ *
+ * Fragment takasında çağrılması zorunlu: `innerHTML` ile değiştirilen bir
+ * bölgenin island'ları DOM'dan çıkar ama `document`/`window` üzerine
+ * kurdukları dinleyiciler ve `setInterval`'ları yaşamaya devam eder. Birkaç
+ * takastan sonra aynı olay birden fazla kez işlenmeye başlar.
+ *
+ * Sökülen element yeniden bağlanabilir hâle gelir: `mounted` kaydı da
+ * temizlenir, böylece aynı düğüm tekrar DOM'a girerse `hydrate()` onu
+ * yeniden görür.
+ *
+ * @param {ParentNode} [root] Kökün kendisi de island olabilir.
+ */
+export declare function unmount(root?: ParentNode): void;
+/** @param {ParentNode} [root] */
+export declare function hydrate(root?: ParentNode): void;
+/** Sonradan DOM'a eklenen island'ları da yakalar (infinite scroll, portal). */
+export declare function observeDocument(): MutationObserver;
+export declare function start(): void;

package/types/client/safe-image.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+/**
+ * Yüklenemeyen görseller için tek bir belge dinleyicisi.
+ *
+ * Bu iş bilinçli olarak **island değil**. Görsel ağırlıklı bir sayfada 80+
+ * `<img>` olabiliyor ve her birine ayrı island bağlamak (gözlemci + dinamik
+ * import + mount) sırf hata ihtimali için ciddi bir hidrasyon yükü. `error`
+ * olayı kabarmaz ama yakalama fazında görülebilir, bu yüzden tek dinleyici
+ * hepsini karşılar ve sonradan DOM'a eklenen görseller de kendiliğinden
+ * kapsanır.
+ *
+ * Kullanım: görsele `data-safe-image` ekleyin. Kendi hata görünümünüzü
+ * vermek için görseli `data-safe-image-host` taşıyan bir sarmalayıcıya alın
+ * ve içine `<template data-safe-image-fallback>` koyun — framework hiçbir
+ * stil dayatmaz, yalnızca değiştirme işini yapar.
+ */
+/**
+ * @returns {void}
+ */
+export declare function startSafeImages(): void;

package/types/client/shared-cookie.d.ts ADDED Viewed

@@ -0,0 +1,82 @@
+export { SHARED_COOKIE_WARN_BYTES, resolveSharedCookieDomain, stripHostPort, } from "../shared/cookie-domain.js";
+/**
+ * @param {string} name
+ * @returns {string | null}
+ */
+export declare function readCookie(name: string): string | null;
+export type ClientSharedCookieResult = {
+    ok: boolean;
+    domain: string | null;
+    handoff: boolean;
+    reason?: string;
+};
+/**
+ * @typedef {object} ClientSharedCookieResult
+ * @property {boolean} ok
+ * @property {string | null} domain
+ * @property {boolean} handoff
+ * @property {string} [reason]
+ */
+/**
+ * @param {string} name
+ * @param {string} value
+ * @param {{ roots?: string[], maxAge?: number, path?: string, sameSite?: string,
+ *   secure?: boolean }} [options]
+ * @returns {ClientSharedCookieResult}
+ */
+export declare function writeSharedCookie(name: string, value: string, options?: {
+    roots?: string[];
+    maxAge?: number;
+    path?: string;
+    sameSite?: string;
+    secure?: boolean;
+}): ClientSharedCookieResult;
+/**
+ * @param {string} name
+ * @param {{ roots?: string[], path?: string, secure?: boolean, sameSite?: string }} [options]
+ * @returns {ClientSharedCookieResult}
+ */
+export declare function clearSharedCookie(name: string, options?: {
+    roots?: string[];
+    path?: string;
+    secure?: boolean;
+    sameSite?: string;
+}): ClientSharedCookieResult;
+/**
+ * Handoff bileti ister; dönen URL'ye gidilir (`?handoff=` taşır).
+ *
+ * @param {{ name: string, value: string, next: string }} body
+ * @param {{ path?: string }} [options]
+ * @returns {Promise<string | null>}
+ */
+export declare function createHandoffUrl(body: {
+    name: string;
+    value: string;
+    next: string;
+}, options?: {
+    path?: string;
+}): Promise<string | null>;
+/**
+ * first-party `window.name` köprüsü — cookie Domain reddedilince yedek.
+ * Kaynak sayfada hedefe gitmeden önce çağırın; hedefte
+ * `consumeWindowNameHandoff` okur.
+ *
+ * @param {string} targetUrl
+ * @param {{ name: string, value: string, maxAge?: number }} cookie
+ * @returns {void}
+ */
+export declare function handoffViaWindowName(targetUrl: string, cookie: {
+    name: string;
+    value: string;
+    maxAge?: number;
+}): void;
+/**
+ * Hedef host'ta `window.name` içindeki handoff'u host-only cookie olarak yazar.
+ *
+ * @param {{ write?: typeof writeSharedCookie }} [options]
+ *   Varsayılan: Domain denemeden host-only `document.cookie`.
+ * @returns {boolean} Bir şey yazıldı mı.
+ */
+export declare function consumeWindowNameHandoff(options?: {
+    write?: typeof writeSharedCookie;
+}): boolean;

package/types/client/store.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+/**
+ * React Context yerine kullanılan minimal pub/sub store.
+ * `useSyncExternalStore` köprüsünün yerini alır: doğrudan `subscribe`.
+ */
+/**
+ * @param {T} initial
+ * @returns {{
+ *   get: () => T,
+ *   set: (next: T | ((prev: T) => T)) => void,
+ *   subscribe: (listener: (value: T) => void) => () => void,
+ * }}
+ * @template T
+ */
+export declare function createStore<T>(initial: T): {
+    get: () => T;
+    set: (next: T | ((prev: T) => T)) => void;
+    subscribe: (listener: (value: T) => void) => () => void;
+};