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

jskelet 0.5.5 → 0.6.0

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 (149) hide show

package/AGENTS.md +18 -13
package/CHANGELOG.md +95 -0
package/README.md +9 -7
package/bin/jskelet.mjs +24 -10
package/docs/01-baslangic.md +4 -3
package/docs/02-mimari.md +4 -3
package/docs/03-routing.md +11 -6
package/docs/04-render-ve-sablonlar.md +35 -43
package/docs/05-islands.md +12 -8
package/docs/07-yapilandirma.md +40 -18
package/docs/08-build.md +15 -9
package/docs/09-dev-araclari.md +5 -1
package/docs/10-dagitim.md +6 -1
package/docs/11-tasima.md +51 -17
package/docs/12-panel-ve-oturum.md +10 -4
package/docs/README.md +7 -5
package/docs/en/01-getting-started.md +4 -3
package/docs/en/02-architecture.md +5 -5
package/docs/en/03-routing.md +12 -7
package/docs/en/04-rendering.md +47 -59
package/docs/en/05-islands.md +13 -8
package/docs/en/07-configuration.md +40 -20
package/docs/en/08-build.md +16 -10
package/docs/en/09-dev-tools.md +6 -1
package/docs/en/10-deployment.md +6 -1
package/docs/en/11-migration.md +51 -16
package/docs/en/12-dashboards-and-sessions.md +9 -4
package/docs/en/README.md +7 -5
package/package.json +49 -14
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 +12 -2
package/src/config/index.js +1 -1
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 +28 -10
package/src/server/ejs-adapter.js +59 -0
package/src/server/image-optimizer.js +94 -26
package/src/server/port-guard.js +255 -0
package/src/server/render.js +27 -9
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 +449 -0
package/types/config/index.d.ts +299 -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 +173 -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/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 +128 -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/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;
+};

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

@@ -0,0 +1,46 @@
+export type SwapOptions = {
+    /**
+     * Varsayılan `GET`.
+     */
+    method?: string;
+    body?: BodyInit | null;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    /**
+     * `true` → adres çubuğu `url` ile güncellenir.
+     */
+    history?: boolean;
+    /**
+     * Varsayılan `replace`.
+     */
+    mode?: "replace" | "append";
+};
+/**
+ * @typedef {object} SwapOptions
+ * @property {string} [method] Varsayılan `GET`.
+ * @property {BodyInit | null} [body]
+ * @property {Record<string, string>} [headers]
+ * @property {AbortSignal} [signal]
+ * @property {boolean} [history] `true` → adres çubuğu `url` ile güncellenir.
+ * @property {"replace" | "append"} [mode] Varsayılan `replace`.
+ */
+/**
+ * @param {Element | string} target Takas edilecek bölge.
+ * @param {string} url Parçayı döndüren uç.
+ * @param {SwapOptions} [options]
+ * @returns {Promise<boolean>} Başarılıysa `true`; hata durumunda mevcut
+ *   içerik korunur ve `false` döner.
+ */
+export declare function swap(target: Element | string, url: string, options?: SwapOptions): Promise<boolean>;
+/**
+ * `data-swap` taşıyan bağlantı ve butonları otomatik bağlar.
+ *
+ *   <a href="/_fragment/rows?page=2" data-swap="#rows" data-swap-history>…</a>
+ *
+ * Tek bir delege dinleyici: sonradan DOM'a giren bağlantılar da çalışır ve
+ * her takastan sonra yeniden bağlama gerekmez.
+ *
+ * @param {ParentNode} [root]
+ * @returns {() => void} Dinleyiciyi söken fonksiyon.
+ */
+export declare function startSwapLinks(root?: ParentNode): () => void;

package/types/compile/codegen.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+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
+ * @returns {{ code: string, includes: string[], components: string[] }}
+ */
+export declare function codegen(ast: AstNode[], options: {
+    viewId: string;
+    file?: string;
+    knownComponents?: Set<string>;
+}): {
+    code: string;
+    includes: string[];
+    components: string[];
+};
+/**
+ * Include yolunu view id'ye çevir (uzantısız, `/` ayırıcılı).
+ * @param {string} includePath
+ * @returns {string}
+ */
+export declare function normalizeIncludeId(includePath: string): string;
+/**
+ * `market-hero` / `MarketHero` → `MarketHero`
+ * @param {string} name
+ * @returns {string}
+ */
+export declare function toPascalCase(name: string): string;

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

@@ -0,0 +1,42 @@
+/**
+ * @param {{ root: string, dirs: Record<string, string> }} config
+ * @param {{ quiet?: boolean }} [options]
+ * @returns {Promise<{ count: number, manifest: Record<string, string>, outDir: string }>}
+ */
+export declare function compileAll(config: {
+    root: string;
+    dirs: Record<string, string>;
+}, _options?: {}): Promise<{
+    count: number;
+    manifest: Record<string, string>;
+    outDir: string;
+}>;
+/**
+ * Manifest yoksa veya herhangi bir `.jsk` daha yeniyse yeniden derler.
+ * Dev sunucu restart'ında build watch kaçırmış olsa bile şablonlar güncel kalır.
+ *
+ * @param {{ root: string, dirs: Record<string, string> }} config
+ * @returns {Promise<{ count: number, rebuilt: boolean }>}
+ */
+export declare function ensureTemplatesCompiled(config: {
+    root: string;
+    dirs: Record<string, string>;
+}): Promise<{
+    count: number;
+    rebuilt: boolean;
+}>;
+/**
+ * Tek kaynak dizgisini derler (birim testleri).
+ * @param {string} source
+ * @param {{ viewId?: string, file?: string, knownComponents?: Set<string> }} [options]
+ * @returns {{ code: string, includes: string[], components: string[] }}
+ */
+export declare function compileSource(source: string, options?: {
+    viewId?: string;
+    file?: string;
+    knownComponents?: Set<string>;
+}): {
+    code: string;
+    includes: string[];
+    components: string[];
+};

package/types/compile/errors.d.ts ADDED Viewed

@@ -0,0 +1,30 @@
+/**
+ * Şablon derleme hataları. Satır/sütun korunur ki DX overlay ve CLI
+ * çıktısı kaynağa işaret edebilsin.
+ */
+/**
+ * @param {string} source
+ * @param {number} index
+ * @returns {{ line: number, column: number }}
+ */
+export declare function indexToLocation(source: string, index: number): {
+    line: number;
+    column: number;
+};
+export declare class CompileError extends Error {
+    file: string | undefined;
+    line: number | undefined;
+    column: number | undefined;
+    /**
+     * @param {string} message
+     * @param {{ file?: string, source?: string, index?: number,
+     *   line?: number, column?: number }} [opts]
+     */
+    constructor(message: string, opts?: {
+        file?: string;
+        source?: string;
+        index?: number;
+        line?: number;
+        column?: number;
+    });
+}

package/types/compile/expr.d.ts ADDED Viewed

@@ -0,0 +1,67 @@
+export type LiteralNode = {
+    type: 'Literal';
+    value: string | number | boolean | null;
+    raw: string;
+};
+export type IdentNode = {
+    type: 'Ident';
+    name: string;
+};
+export type MemberNode = {
+    type: 'Member';
+    object: ExprNode;
+    property: string;
+    optional: boolean;
+};
+export type IndexNode = {
+    type: 'Index';
+    object: ExprNode;
+    index: ExprNode;
+    optional: boolean;
+};
+export type UnaryNode = {
+    type: 'Unary';
+    op: '!' | '-';
+    argument: ExprNode;
+};
+export type BinaryNode = {
+    type: 'Binary';
+    op: string;
+    left: ExprNode;
+    right: ExprNode;
+};
+export type CondNode = {
+    type: 'Cond';
+    test: ExprNode;
+    consequent: ExprNode;
+    alternate: ExprNode;
+};
+export type ExprNode = LiteralNode | IdentNode | MemberNode | IndexNode | UnaryNode | BinaryNode | CondNode;
+/**
+ * @param {string} source
+ * @param {number} start
+ * @param {number} end
+ * @param {{ file?: string, templateSource?: string, templateIndex?: number }} [meta]
+ * @returns {ExprNode}
+ */
+export declare function parseExpr(source: string, start?: number, end?: number, meta?: {
+    file?: string;
+    templateSource?: string;
+    templateIndex?: number;
+}): ExprNode;
+/**
+ * İfadeyi JS kaynak metnine çevirir. `locals` içindeki isimler çıplak kalır;
+ * diğerleri `data.` öneki alır.
+ *
+ * @param {ExprNode} node
+ * @param {Set<string>} [locals]
+ * @returns {string}
+ */
+export declare function codegenExpr(node: ExprNode, locals?: Set<string>): string;
+/**
+ * İfadede geçen kök tanımlayıcılar (data alanları / local adayları).
+ * @param {ExprNode} node
+ * @param {Set<string>} [out]
+ * @returns {Set<string>}
+ */
+export declare function collectIdents(node: ExprNode, out?: Set<string>): Set<string>;

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

@@ -0,0 +1,10 @@
+/**
+ * Build-time `.jsk` derleyici yüzeyi.
+ */
+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 { getViewRoots, getComponentDirs, discoverJskFiles, componentNameFromViewId, collectKnownComponents, toComponentTag, } from "./resolve.js";
+export { scanNamedExports } from "./scan-exports.js";
+export { compileAll, compileSource, ensureTemplatesCompiled } from "./compile-all.js";