jskelet 0.2.3 → 0.2.5

package/AGENTS.md

@@ -1,132 +1,132 @@
-# AGENTS.md
-
-Bu depo **JSkelet** framework'ünün kaynağıdır: Express 5 + EJS sunucu render,
-vanilla JS island'lar, Tailwind v4 ve süreç belleğinde yaşayan HTML TTL cache.
-React ve TypeScript yok; düz JavaScript + JSDoc.
-
-Bir JSkelet **uygulamasında** çalışıyorsan (framework'ün kendisinde değil), aynı
-kuralların uygulama tarafı karşılıkları için [docs/](./docs/README.md) yeterli;
-özellikle 03, 05 ve 07.
-
-## Değişiklik yapmadan önce
-
-Framework'ün davranışını değiştiren bir iş alıyorsan ilgili belgeyi oku. Bu
-dosyalar kararların **gerekçelerini** taşıyor ve çoğu "iyileştirme" fikri orada
-zaten tartışılmış:
-
-| Dokunacağın yer | Önce oku |
-| --- | --- |
-| `src/server/render.js`, şablonlar | [04-render-ve-sablonlar.md](./docs/04-render-ve-sablonlar.md) |
-| `src/server/html-cache.js`, `route()` | [06-cache.md](./docs/06-cache.md) |
-| `src/server/create-app.js`, middleware | [02-mimari.md](./docs/02-mimari.md) |
-| `src/client/**` | [05-islands.md](./docs/05-islands.md) |
-| `src/build/**` | [08-build.md](./docs/08-build.md) |
-| `src/config/**` | [07-yapilandirma.md](./docs/07-yapilandirma.md) |
-| `src/dev-server.mjs`, `src/server/dev/**` | [09-dev-araclari.md](./docs/09-dev-araclari.md) |
-
-Belgeler iki dilde: Türkçesi `docs/`, İngilizcesi `docs/en/` altında ve
-dosyalar birebir eşlenik. Bir belgeyi değiştirdiysen karşılığını da güncelle;
-pazarlama sitesi (`examples/marketing`) bu dosyaları doğrudan `/docs` altında
-servis ettiği için eksik kalan çeviri kullanıcıya görünür.
-
-## Doğrulama
-
-**Lint yeterli, tam build zorunlu değil.**
-
-```bash
-npm run lint
-npm test     # desen derleyicisi ve HTML cache için birim testler
-```
-
-Davranış değiştiren bir iş yaptıysan örneklerden biriyle uçtan uca dene:
-
-```bash
-npm --prefix examples/blog install     # ilk seferde
-npm --prefix examples/blog run build
-npm --prefix examples/blog run start   # ayrı terminalde
-node examples/blog/smoke.mjs
-```
-
-`examples/blog` bilinçli olarak framework'ün her yüzeyini kullanır (dinamik
-route, tüm config bölümleri, fragment, form, prewarm, RSS/sitemap, dört island).
-Bir şeyi bozduysan smoke testi genelde yakalar.
-
-## Mimari kurallar
-
-**Framework domain bilgisi taşımaz.** `src/` altında hiçbir yerde uygulamaya
-özel URL, marka adı, metin ya da veri şekli olmaz. Uygulamaya ait mantık
-`hooks` üzerinden gelir (`metadata`, `layoutContext`, `notFound`,
-`prewarmPaths`), görünen adlar `brand` üzerinden.
-
-**Yol hesabı tek yerde.** Hiçbir modül `../..` sayarak dizin bulmaz;
-`getConfig().dirs` kullanılır. Framework `node_modules/` içine girdiğinde
-göreli yol sayan her satır bozulur.
-
-**Yapılandırma hatası siteyi düşürmez.** Bozuk bir `jskelet.config.mjs`, hata
-veren bir `headers()` ya da fırlatan bir hook uyarı basar ve varsayılana döner.
-
-**Build çıktısı olmadan da ayağa kalkar.** `asset()` manifest yoksa hash'siz
-yola döner, `hasAsset()` false olur ve layout etiketi basmaz. `jskelet build`
-unutulduğunda hata değil, stilsiz ama çalışan bir sayfa görülür.
-
-**Opsiyonel bağımlılıklar sessizce atlanır.** `sharp`, `postcss`,
-`@phosphor-icons/core` yoksa ilgili build adımı çalışmaz. Peer bağımlılıklar
-**uygulamanın** `node_modules`'ünden çözülmeli: `src/build/resolve-peer.mjs`
-içindeki `importFromApp` / `tryImportFromApp` kullanılır, doğrudan `import
-"postcss"` yazılmaz.
-
-**Middleware sırası sözleşmedir.** `src/server/create-app.js` başındaki
-numaralı yorum sırayı ve her konumun gerekçesini anlatır. Sıra değiştirmek
-sessiz bozulmalara yol açar; değiştiriyorsan yorumu da güncelle.
-
-**Cache'lenen HTML herkese aynı gider.** Kişiye özel hiçbir şey `route()` ile
-render edilen sayfaya girmez. Tema gibi kararlar client'ta, kullanıcıya özel
-parçalar ayrı ve `no-store` işaretli fragment uçlarında.
-
-## Kod stili
-
-- **JSDoc zorunlu**: dışa açık her fonksiyonda parametre ve dönüş tipleri.
-- **Yorumlar Türkçe** ve *neden*i anlatır. Kodun ne yaptığını tekrar eden yorum
-  yazma; bir kararın gerekçesini, bir takası ya da bir tuzağı yaz.
-- Sunucu ve build tarafı `node:` önekli çekirdek modülleri kullanır.
-- `src/client/**` tarayıcıda çalışır: Node API'si, `process` (build sırasında
-  değiştirilen `clientEnv` dışında) ve senkron ağ yok.
-- Yeni bir dışa açık yüzey ekliyorsan `package.json` → `exports` ve
-  `src/index.js` / `src/client/index.js` barrel'larını güncelle; belgelerde
-  yalnızca `exports` haritasındaki belirteçler kullanılır (`jskelet`,
-  `jskelet/client`, `jskelet/html`, `jskelet/tags`).
-
-## EJS tuzakları
-
-- `include` **async**'tir: `await include('partials/x')` yalnızca şablonun kendi
-  gövdesinde çalışır. Bir `forEach` callback'i içinde derleme hatası verir —
-  `for` döngüsü kullan.
-- `views/components/**` altındaki her named export otomatik olarak şablon local'i
-  olur; import gerekmez. Bileşenler EJS değil, HTML string döndüren
-  fonksiyonlardır.
-- Şablona giden her kullanıcı verisi `<%= %>` ile ya da `esc()` üzerinden
-  geçmeli; `<%- %>` yalnızca güvenli bildiğin HTML için.
-
-## Tailwind
-
-Sınıf taraması `styles/globals.css` içindeki `@source` direktiflerine bağlıdır
-ve otomatik tespit `source(none)` ile kapatılmıştır. Sınıf kullanmaya başladığın
-yeni bir dizin varsa oraya bir `@source` satırı eklemek gerekir; yoksa sınıflar
-sessizce çıktıdan düşer.
-
-## Örnekleri güncel tut
-
-Framework'ün genel yüzeyini değiştirdiysen (`route()` imzası, hook adları,
-config alanları, client API'si) `examples/minimal`, `examples/blog` ve
-`examples/marketing`'i de güncelle. Örnekler belgelerdeki kod parçalarının kaynağı; kaymaları en hızlı
-fark edilen yer orası.
-
-## Windows notları
-
-Bu depo Windows üzerinde geliştiriliyor ve iki tuzak tekrar tekrar çıkıyor:
-
-- `--import` argümanı modül belirteci bekler. `H:\...` gibi mutlak bir yol `h:`
-  şemalı URL sanılıp reddedilir; `pathToFileURL(...).href` kullan.
-- `fs.watch` bir dosya yazıldığında komşuları için de olay üretebiliyor. Dev
-  sunucusu bu yüzden olayları `mtime` karşılaştırmasıyla eler; watcher mantığını
-  değiştirirken bu elemeyi kaldırma.
+# AGENTS.md
+
+Bu depo **JSkelet** framework'ünün kaynağıdır: Express 5 + EJS sunucu render,
+vanilla JS island'lar, Tailwind v4 ve süreç belleğinde yaşayan HTML TTL cache.
+React ve TypeScript yok; düz JavaScript + JSDoc.
+
+Bir JSkelet **uygulamasında** çalışıyorsan (framework'ün kendisinde değil), aynı
+kuralların uygulama tarafı karşılıkları için [docs/](./docs/README.md) yeterli;
+özellikle 03, 05 ve 07.
+
+## Değişiklik yapmadan önce
+
+Framework'ün davranışını değiştiren bir iş alıyorsan ilgili belgeyi oku. Bu
+dosyalar kararların **gerekçelerini** taşıyor ve çoğu "iyileştirme" fikri orada
+zaten tartışılmış:
+
+| Dokunacağın yer | Önce oku |
+| --- | --- |
+| `src/server/render.js`, şablonlar | [04-render-ve-sablonlar.md](./docs/04-render-ve-sablonlar.md) |
+| `src/server/html-cache.js`, `route()` | [06-cache.md](./docs/06-cache.md) |
+| `src/server/create-app.js`, middleware | [02-mimari.md](./docs/02-mimari.md) |
+| `src/client/**` | [05-islands.md](./docs/05-islands.md) |
+| `src/build/**` | [08-build.md](./docs/08-build.md) |
+| `src/config/**` | [07-yapilandirma.md](./docs/07-yapilandirma.md) |
+| `src/dev-server.mjs`, `src/server/dev/**` | [09-dev-araclari.md](./docs/09-dev-araclari.md) |
+
+Belgeler iki dilde: Türkçesi `docs/`, İngilizcesi `docs/en/` altında ve
+dosyalar birebir eşlenik. Bir belgeyi değiştirdiysen karşılığını da güncelle;
+pazarlama sitesi (`examples/marketing`) bu dosyaları doğrudan `/docs` altında
+servis ettiği için eksik kalan çeviri kullanıcıya görünür.
+
+## Doğrulama
+
+**Lint yeterli, tam build zorunlu değil.**
+
+```bash
+npm run lint
+npm test     # desen derleyicisi ve HTML cache için birim testler
+```
+
+Davranış değiştiren bir iş yaptıysan örneklerden biriyle uçtan uca dene:
+
+```bash
+npm --prefix examples/blog install     # ilk seferde
+npm --prefix examples/blog run build
+npm --prefix examples/blog run start   # ayrı terminalde
+node examples/blog/smoke.mjs
+```
+
+`examples/blog` bilinçli olarak framework'ün her yüzeyini kullanır (dinamik
+route, tüm config bölümleri, fragment, form, prewarm, RSS/sitemap, dört island).
+Bir şeyi bozduysan smoke testi genelde yakalar.
+
+## Mimari kurallar
+
+**Framework domain bilgisi taşımaz.** `src/` altında hiçbir yerde uygulamaya
+özel URL, marka adı, metin ya da veri şekli olmaz. Uygulamaya ait mantık
+`hooks` üzerinden gelir (`metadata`, `layoutContext`, `notFound`,
+`prewarmPaths`), görünen adlar `brand` üzerinden.
+
+**Yol hesabı tek yerde.** Hiçbir modül `../..` sayarak dizin bulmaz;
+`getConfig().dirs` kullanılır. Framework `node_modules/` içine girdiğinde
+göreli yol sayan her satır bozulur.
+
+**Yapılandırma hatası siteyi düşürmez.** Bozuk bir `jskelet.config.mjs`, hata
+veren bir `headers()` ya da fırlatan bir hook uyarı basar ve varsayılana döner.
+
+**Build çıktısı olmadan da ayağa kalkar.** `asset()` manifest yoksa hash'siz
+yola döner, `hasAsset()` false olur ve layout etiketi basmaz. `jskelet build`
+unutulduğunda hata değil, stilsiz ama çalışan bir sayfa görülür.
+
+**Opsiyonel bağımlılıklar sessizce atlanır.** `sharp`, `postcss`,
+`@phosphor-icons/core` yoksa ilgili build adımı çalışmaz. Peer bağımlılıklar
+**uygulamanın** `node_modules`'ünden çözülmeli: `src/build/resolve-peer.mjs`
+içindeki `importFromApp` / `tryImportFromApp` kullanılır, doğrudan `import
+"postcss"` yazılmaz.
+
+**Middleware sırası sözleşmedir.** `src/server/create-app.js` başındaki
+numaralı yorum sırayı ve her konumun gerekçesini anlatır. Sıra değiştirmek
+sessiz bozulmalara yol açar; değiştiriyorsan yorumu da güncelle.
+
+**Cache'lenen HTML herkese aynı gider.** Kişiye özel hiçbir şey `route()` ile
+render edilen sayfaya girmez. Tema gibi kararlar client'ta, kullanıcıya özel
+parçalar ayrı ve `no-store` işaretli fragment uçlarında.
+
+## Kod stili
+
+- **JSDoc zorunlu**: dışa açık her fonksiyonda parametre ve dönüş tipleri.
+- **Yorumlar Türkçe** ve *neden*i anlatır. Kodun ne yaptığını tekrar eden yorum
+  yazma; bir kararın gerekçesini, bir takası ya da bir tuzağı yaz.
+- Sunucu ve build tarafı `node:` önekli çekirdek modülleri kullanır.
+- `src/client/**` tarayıcıda çalışır: Node API'si, `process` (build sırasında
+  değiştirilen `clientEnv` dışında) ve senkron ağ yok.
+- Yeni bir dışa açık yüzey ekliyorsan `package.json` → `exports` ve
+  `src/index.js` / `src/client/index.js` barrel'larını güncelle; belgelerde
+  yalnızca `exports` haritasındaki belirteçler kullanılır (`jskelet`,
+  `jskelet/client`, `jskelet/html`, `jskelet/tags`).
+
+## EJS tuzakları
+
+- `include` **async**'tir: `await include('partials/x')` yalnızca şablonun kendi
+  gövdesinde çalışır. Bir `forEach` callback'i içinde derleme hatası verir —
+  `for` döngüsü kullan.
+- `views/components/**` altındaki her named export otomatik olarak şablon local'i
+  olur; import gerekmez. Bileşenler EJS değil, HTML string döndüren
+  fonksiyonlardır.
+- Şablona giden her kullanıcı verisi `<%= %>` ile ya da `esc()` üzerinden
+  geçmeli; `<%- %>` yalnızca güvenli bildiğin HTML için.
+
+## Tailwind
+
+Sınıf taraması `styles/globals.css` içindeki `@source` direktiflerine bağlıdır
+ve otomatik tespit `source(none)` ile kapatılmıştır. Sınıf kullanmaya başladığın
+yeni bir dizin varsa oraya bir `@source` satırı eklemek gerekir; yoksa sınıflar
+sessizce çıktıdan düşer.
+
+## Örnekleri güncel tut
+
+Framework'ün genel yüzeyini değiştirdiysen (`route()` imzası, hook adları,
+config alanları, client API'si) `examples/minimal`, `examples/blog` ve
+`examples/marketing`'i de güncelle. Örnekler belgelerdeki kod parçalarının kaynağı; kaymaları en hızlı
+fark edilen yer orası.
+
+## Windows notları
+
+Bu depo Windows üzerinde geliştiriliyor ve iki tuzak tekrar tekrar çıkıyor:
+
+- `--import` argümanı modül belirteci bekler. `H:\...` gibi mutlak bir yol `h:`
+  şemalı URL sanılıp reddedilir; `pathToFileURL(...).href` kullan.
+- `fs.watch` bir dosya yazıldığında komşuları için de olay üretebiliyor. Dev
+  sunucusu bu yüzden olayları `mtime` karşılaştırmasıyla eler; watcher mantığını
+  değiştirirken bu elemeyi kaldırma.

package/CHANGELOG.md

@@ -8,6 +8,14 @@ one is listed under a **Breaking** heading.
 
 ## [Unreleased]
 
+### Fixed
+
+- Cloudflare analytics in the cache panel no longer asks for an open-ended
+  window. Queries used only `datetime_geq`, so Cloudflare closed the range at
+  query time and a default 24h lookback became `1d` plus network delay — Free
+  zones reject anything wider than one day. Both ends are now pinned from the
+  same clock (`datetime_leq` included).
+
 ### Added
 
 - `cache().query`, a pattern → allowlist mapping that decides which query
@@ -33,6 +41,13 @@ one is listed under a **Breaking** heading.
   hours, and every banned or unauthorised response is a `404` rather than a 401
   that would confirm the panel exists. The panel is excluded from indexing,
   prewarming and navigation speculation.
+- A language picker in the cache panel header, Turkish and English. The first
+  visit follows the browser's language, the choice is kept in `localStorage` and
+  carries over to the login page, and switching costs no request. To keep this
+  from leaking UI concerns into the server, an `/action` response now returns
+  `{ ok, code, params }` instead of an English sentence and the panel builds the
+  text — the framework's log and API stay in one language while the panel
+  speaks two.
 - Cloudflare cache management, from the panel and from code. Set
   `JSKELET_CLOUDFLARE_KEY` and `JSKELET_CLOUDFLARE_ZONE_ID` (or
   `cache().cloudflare`) and the panel gains the CDN tier next to the origin one:

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Ayberk Enis and JSkelet contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Ayberk Enis and JSkelet contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/jskelet.mjs

@@ -1,104 +1,104 @@
 #!/usr/bin/env node
-/**
- * JSkelet CLI.
- *
- *   jskelet dev      build watch + sunucu, canlı yenileme, dev overlay
- *   jskelet build    tek seferlik prod build (fontlar, sprite, CSS, JS, görseller)
- *   jskelet start    prod sunucu (build eksikse önce üretir)
- *   jskelet init     bulunduğun dizine minimal iskelet kurar
- *
- * Alt komutlar ayrı süreçlerde çalışır. Sebep: `dev` iki uzun ömürlü süreci
- * (build watch + sunucu) yönetiyor ve sunucunun ESM resolve hook'larına
- * (`--import`) ihtiyacı var; bunlar süreç başlarken kurulmak zorunda.
- */
-import { spawn } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-const SRC = path.resolve(fileURLToPath(import.meta.url), "..", "..", "src");
-
-/**
- * `--import` bir modül **belirteci** bekler, dosya yolu değil. Windows'ta
- * `H:\...` mutlak yolu `h:` şemalı bir URL sanılıp reddediliyor; file:// URL'e
- * çevirmek her platformda doğru.
- */
-const REGISTER = pathToFileURL(path.join(SRC, "runtime", "register.mjs")).href;
-
-const [command, ...rest] = process.argv.slice(2);
-
-/**
- * `.env` yalnızca varsa geçilir: `--env-file-if-exists` dosya yokken de bir
- * bildirim satırı basıyor ve bu satır dev çıktısında hata gibi görünüyor.
- * `--import` alias hook'larını kurar; uygulama kodu `@/…` yazabilsin diye.
- *
- * @param {string} file
- * @param {{ env?: Record<string, string>, args?: string[], hooks?: boolean }} [options]
- * @returns {import('node:child_process').ChildProcess}
- */
-function run(file, options = {}) {
-  const args = [
-    ...(fs.existsSync(path.join(process.cwd(), ".env"))
-      ? ["--env-file=.env"]
-      : []),
-    ...(options.hooks === false ? [] : ["--import", REGISTER]),
-    file,
-    ...(options.args ?? []),
-  ];
-
-  return spawn(process.execPath, args, {
-    stdio: "inherit",
-    env: { ...process.env, ...(options.env ?? {}) },
-  });
-}
-
-/** @param {import('node:child_process').ChildProcess} child */
-function exitWith(child) {
-  child.on("exit", (code) => process.exit(code ?? 0));
-}
-
-switch (command) {
-  case "dev": {
-    exitWith(run(path.join(SRC, "dev-server.mjs"), { hooks: false, args: rest }));
-    break;
-  }
-
-  case "build": {
-    exitWith(
-      run(path.join(SRC, "build", "build.mjs"), {
-        env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
-        args: rest,
-      }),
-    );
-    break;
-  }
-
-  case "start": {
-    exitWith(
-      run(path.join(SRC, "start.mjs"), {
-        env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
-        args: rest,
-      }),
-    );
-    break;
-  }
-
-  case "init": {
-    const { init } = await import("../src/init.mjs");
-    await init(process.cwd());
-    break;
-  }
-
-  default: {
-    const known = command ? `unknown command: ${command}\n\n` : "";
-    process.stderr.write(
-      `${known}usage: jskelet <dev|build|start|init>\n\n` +
-        "  dev     build watch + server (live reload, dev overlay)\n" +
-        "  build   production build\n" +
-        "  start   production server\n" +
-        "  init    scaffold a minimal skeleton in the current directory\n",
-    );
-    process.exit(command ? 1 : 0);
-  }
-}
+/**
+ * JSkelet CLI.
+ *
+ *   jskelet dev      build watch + sunucu, canlı yenileme, dev overlay
+ *   jskelet build    tek seferlik prod build (fontlar, sprite, CSS, JS, görseller)
+ *   jskelet start    prod sunucu (build eksikse önce üretir)
+ *   jskelet init     bulunduğun dizine minimal iskelet kurar
+ *
+ * Alt komutlar ayrı süreçlerde çalışır. Sebep: `dev` iki uzun ömürlü süreci
+ * (build watch + sunucu) yönetiyor ve sunucunun ESM resolve hook'larına
+ * (`--import`) ihtiyacı var; bunlar süreç başlarken kurulmak zorunda.
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const SRC = path.resolve(fileURLToPath(import.meta.url), "..", "..", "src");
+
+/**
+ * `--import` bir modül **belirteci** bekler, dosya yolu değil. Windows'ta
+ * `H:\...` mutlak yolu `h:` şemalı bir URL sanılıp reddediliyor; file:// URL'e
+ * çevirmek her platformda doğru.
+ */
+const REGISTER = pathToFileURL(path.join(SRC, "runtime", "register.mjs")).href;
+
+const [command, ...rest] = process.argv.slice(2);
+
+/**
+ * `.env` yalnızca varsa geçilir: `--env-file-if-exists` dosya yokken de bir
+ * bildirim satırı basıyor ve bu satır dev çıktısında hata gibi görünüyor.
+ * `--import` alias hook'larını kurar; uygulama kodu `@/…` yazabilsin diye.
+ *
+ * @param {string} file
+ * @param {{ env?: Record<string, string>, args?: string[], hooks?: boolean }} [options]
+ * @returns {import('node:child_process').ChildProcess}
+ */
+function run(file, options = {}) {
+  const args = [
+    ...(fs.existsSync(path.join(process.cwd(), ".env"))
+      ? ["--env-file=.env"]
+      : []),
+    ...(options.hooks === false ? [] : ["--import", REGISTER]),
+    file,
+    ...(options.args ?? []),
+  ];
+
+  return spawn(process.execPath, args, {
+    stdio: "inherit",
+    env: { ...process.env, ...(options.env ?? {}) },
+  });
+}
+
+/** @param {import('node:child_process').ChildProcess} child */
+function exitWith(child) {
+  child.on("exit", (code) => process.exit(code ?? 0));
+}
+
+switch (command) {
+  case "dev": {
+    exitWith(run(path.join(SRC, "dev-server.mjs"), { hooks: false, args: rest }));
+    break;
+  }
+
+  case "build": {
+    exitWith(
+      run(path.join(SRC, "build", "build.mjs"), {
+        env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
+        args: rest,
+      }),
+    );
+    break;
+  }
+
+  case "start": {
+    exitWith(
+      run(path.join(SRC, "start.mjs"), {
+        env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
+        args: rest,
+      }),
+    );
+    break;
+  }
+
+  case "init": {
+    const { init } = await import("../src/init.mjs");
+    await init(process.cwd());
+    break;
+  }
+
+  default: {
+    const known = command ? `unknown command: ${command}\n\n` : "";
+    process.stderr.write(
+      `${known}usage: jskelet <dev|build|start|init>\n\n` +
+        "  dev     build watch + server (live reload, dev overlay)\n" +
+        "  build   production build\n" +
+        "  start   production server\n" +
+        "  init    scaffold a minimal skeleton in the current directory\n",
+    );
+    process.exit(command ? 1 : 0);
+  }
+}