jskelet 0.6.3 → 0.6.5

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 (154) hide show
  1. package/AGENTS.md +136 -136
  2. package/CHANGELOG.md +633 -620
  3. package/LICENSE +21 -21
  4. package/README.md +2 -0
  5. package/bin/jskelet.mjs +130 -130
  6. package/docs/01-baslangic.md +291 -291
  7. package/docs/02-mimari.md +310 -310
  8. package/docs/03-routing.md +515 -515
  9. package/docs/04-render-ve-sablonlar.md +700 -661
  10. package/docs/05-islands.md +486 -486
  11. package/docs/06-cache.md +1467 -1443
  12. package/docs/07-yapilandirma.md +1208 -1197
  13. package/docs/08-build.md +429 -429
  14. package/docs/09-dev-araclari.md +364 -364
  15. package/docs/10-dagitim.md +351 -338
  16. package/docs/12-panel-ve-oturum.md +479 -478
  17. package/docs/README.md +83 -83
  18. package/docs/en/01-getting-started.md +298 -298
  19. package/docs/en/02-architecture.md +329 -329
  20. package/docs/en/03-routing.md +531 -531
  21. package/docs/en/04-rendering.md +708 -669
  22. package/docs/en/05-islands.md +497 -497
  23. package/docs/en/06-caching.md +1476 -1453
  24. package/docs/en/07-configuration.md +1229 -1219
  25. package/docs/en/08-build.md +447 -447
  26. package/docs/en/09-dev-tools.md +373 -373
  27. package/docs/en/10-deployment.md +355 -340
  28. package/docs/en/11-migration.md +398 -398
  29. package/docs/en/12-dashboards-and-sessions.md +489 -488
  30. package/docs/en/README.md +87 -87
  31. package/package.json +137 -137
  32. package/src/build/ensure-build.mjs +19 -19
  33. package/src/build/paths.mjs +153 -153
  34. package/src/build/resolve-peer.mjs +36 -36
  35. package/src/build/tasks/client.mjs +349 -349
  36. package/src/build/tasks/css.mjs +235 -235
  37. package/src/build/tasks/fonts.mjs +146 -146
  38. package/src/build/tasks/icons.mjs +357 -357
  39. package/src/build/tasks/images.mjs +244 -244
  40. package/src/build/tasks/precompress.mjs +78 -78
  41. package/src/build/tasks/templates.mjs +20 -20
  42. package/src/client/admin/i18n.js +764 -764
  43. package/src/client/admin/login.html +74 -74
  44. package/src/client/admin/panel.css +809 -809
  45. package/src/client/admin/panel.html +495 -495
  46. package/src/client/admin/panel.js +1251 -1251
  47. package/src/client/devtools/report.html +185 -185
  48. package/src/client/devtools/report.js +745 -745
  49. package/src/client/devtools/seo.js +628 -628
  50. package/src/client/dom.js +95 -95
  51. package/src/client/form.js +192 -192
  52. package/src/client/index.js +45 -45
  53. package/src/client/registry.js +305 -305
  54. package/src/client/safe-image.js +91 -91
  55. package/src/client/shared-cookie.js +225 -225
  56. package/src/client/store.js +36 -36
  57. package/src/client/swap.js +188 -188
  58. package/src/compile/codegen.js +336 -336
  59. package/src/compile/compile-all.js +149 -149
  60. package/src/compile/errors.js +66 -66
  61. package/src/compile/expr.js +409 -409
  62. package/src/compile/index.js +17 -17
  63. package/src/compile/parse.js +541 -541
  64. package/src/compile/resolve.js +211 -211
  65. package/src/compile/scan-exports.js +51 -51
  66. package/src/config/defaults.js +541 -534
  67. package/src/config/index.js +1500 -1469
  68. package/src/config/pattern.js +107 -107
  69. package/src/generate.mjs +163 -163
  70. package/src/http/control-flow.js +71 -71
  71. package/src/http/cookies-entry.js +21 -21
  72. package/src/http/cookies.js +277 -277
  73. package/src/http/request-cache.js +46 -46
  74. package/src/http/request-context.js +165 -165
  75. package/src/http/shared-cookie.js +178 -178
  76. package/src/index.js +101 -101
  77. package/src/init.mjs +232 -230
  78. package/src/migrate/apply.mjs +262 -262
  79. package/src/migrate/babel.mjs +79 -79
  80. package/src/migrate/classify.mjs +155 -155
  81. package/src/migrate/config.mjs +126 -126
  82. package/src/migrate/fs-walk.mjs +191 -191
  83. package/src/migrate/parse.mjs +26 -26
  84. package/src/migrate/scan.mjs +177 -177
  85. package/src/migrate/transform/expr-source.mjs +168 -168
  86. package/src/migrate/transform/island.mjs +67 -67
  87. package/src/migrate/transform/jsx-to-component.mjs +302 -302
  88. package/src/migrate/transform/jsx-to-jsk.mjs +330 -330
  89. package/src/migrate/transform/page-split.mjs +435 -435
  90. package/src/migrate/write.mjs +81 -81
  91. package/src/migrate.mjs +171 -171
  92. package/src/runtime/alias-hooks.mjs +119 -119
  93. package/src/runtime/register.mjs +4 -4
  94. package/src/server/admin/actions.js +229 -229
  95. package/src/server/admin/auth.js +125 -125
  96. package/src/server/admin/event-log.js +151 -151
  97. package/src/server/admin/gate.js +209 -209
  98. package/src/server/admin/inventory.js +188 -188
  99. package/src/server/admin/mount.js +56 -56
  100. package/src/server/admin/router.js +216 -216
  101. package/src/server/admin/snapshot.js +241 -241
  102. package/src/server/assets.js +147 -147
  103. package/src/server/auth/handoff.js +309 -309
  104. package/src/server/cache-blob.js +70 -70
  105. package/src/server/cache-control.js +45 -0
  106. package/src/server/cache-deps.js +42 -42
  107. package/src/server/cache-vary.js +113 -113
  108. package/src/server/cloudflare.js +607 -607
  109. package/src/server/create-app.js +366 -366
  110. package/src/server/data-cache.js +553 -553
  111. package/src/server/dev/report.js +485 -485
  112. package/src/server/dev/socket.js +170 -170
  113. package/src/server/dev/version-check.mjs +139 -139
  114. package/src/server/disk-cache.js +233 -233
  115. package/src/server/ejs-adapter.js +59 -59
  116. package/src/server/html-cache.js +1196 -1196
  117. package/src/server/image-optimizer.js +500 -500
  118. package/src/server/logs/access-middleware.js +66 -66
  119. package/src/server/logs/file-sink.js +193 -193
  120. package/src/server/logs/pipeline.js +165 -165
  121. package/src/server/logs/s3-put.js +214 -214
  122. package/src/server/logs/s3-sink.js +112 -112
  123. package/src/server/metadata.js +102 -102
  124. package/src/server/middleware/compression.js +205 -205
  125. package/src/server/middleware/csrf.js +134 -134
  126. package/src/server/middleware/dev-gate.js +75 -75
  127. package/src/server/middleware/headers.js +37 -37
  128. package/src/server/middleware/redirects.js +32 -32
  129. package/src/server/middleware/robots-txt.js +341 -341
  130. package/src/server/middleware/static-precompressed.js +121 -121
  131. package/src/server/middleware/trailing-slash.js +53 -53
  132. package/src/server/middleware/upstream-proxy.js +141 -141
  133. package/src/server/og-image.js +965 -356
  134. package/src/server/og-raster.mjs +21 -0
  135. package/src/server/port-guard.js +255 -255
  136. package/src/server/prewarm.js +1082 -1082
  137. package/src/server/redis.js +588 -588
  138. package/src/server/render.js +910 -910
  139. package/src/server/router.js +157 -157
  140. package/src/server/status-page.js +265 -265
  141. package/src/server/upstream-limiter.js +376 -376
  142. package/src/server/upstream-tracking.js +166 -166
  143. package/src/shared/cookie-domain.js +66 -66
  144. package/src/start.mjs +22 -22
  145. package/src/templates/layout.ejs +30 -30
  146. package/src/templates/layout.jsk +30 -30
  147. package/src/version.mjs +31 -31
  148. package/src/views/components/loader.js +101 -101
  149. package/src/views/helpers/html.js +102 -102
  150. package/src/views/helpers/tags.js +375 -375
  151. package/types/config/defaults.d.ts +6 -0
  152. package/types/config/index.d.ts +6 -0
  153. package/types/server/cache-control.d.ts +28 -0
  154. package/types/server/og-image.d.ts +51 -3
package/docs/README.md CHANGED
@@ -1,83 +1,83 @@
1
- # JSkelet belgeleri
2
-
3
- JSkelet, SEO ve hız odaklı siteler için "framework'süz hissettiren" bir
4
- framework: Express 5 + build-time `.jsk` ile sunucuda tam HTML üretir (EJS
5
- opsiyonel legacy peer), etkileşimi vanilla JS island'larla ekler, CSS'i
6
- Tailwind v4 ile tek bir stylesheet'e derler ve ISR yerine süreç belleğinde
7
- yaşayan, stale-while-revalidate'li bir HTML TTL cache kullanır. React yok;
8
- framework kaynağı düz JavaScript + JSDoc'tur. Uygulama tarafında client
9
- island/entry'ler TypeScript yazılabilir ve paket `.d.ts` yayınlar.
10
-
11
- Bu dizin framework'ün tam referansıdır. Sıralı okumak için baştan başlayın;
12
- belirli bir konuyu arıyorsanız doğrudan ilgili başlığa gidin.
13
-
14
- Aynı belgelerin İngilizcesi [`docs/en/`](./en/README.md) altında. İki sürüm elle
15
- eşlenik tutuluyor; birini değiştiriyorsan diğerini de değiştir.
16
-
17
- ## Sıralı okuma
18
-
19
- | Belge | Konu |
20
- | --- | --- |
21
- | [01-baslangic.md](./01-baslangic.md) | Kurulum, `jskelet init`, ilk route, ilk island, dizin yapısı, CLI komutları |
22
- | [02-mimari.md](./02-mimari.md) | Mimari kararlar ve gerekçeleri: island modeli, tam sunucu HTML'i, cache stratejisi, middleware sırası |
23
- | [03-routing.md](./03-routing.md) | Route modülü sözleşmesi, yükleme sırası, controller sözleşmesi, `ctx`, `notFound`/`redirect`, config redirects/rewrites |
24
- | [04-render-ve-sablonlar.md](./04-render-ve-sablonlar.md) | `.jsk` layout/sayfalar, otomatik bileşen kaydı, `html`/`tags`, metadata → `<head>`, hook'lar; EJS legacy |
25
- | [05-islands.md](./05-islands.md) | `data-island` sözleşmesi, hidrasyon stratejileri, `client/entries/*`, `createStore`, DOM yardımcıları, `startSafeImages` |
26
- | [06-cache.md](./06-cache.md) | `withHtmlCache`, `revalidate`, stale-while-revalidate, cache anahtarı, `X-JSkelet-Cache`, istek içi cache, degraded render, prewarm |
27
- | [07-yapilandirma.md](./07-yapilandirma.md) | `jskelet.config.mjs` tam referansı, `source` desen sözdizimi, ortam değişkenleri tablosu |
28
- | [08-build.md](./08-build.md) | Build hattı, manifest, hash'li varlıklar, CSS/Tailwind `@source`, fontlar, ikon sprite, görsel optimizasyonu, precompress |
29
- | [09-dev-araclari.md](./09-dev-araclari.md) | `jskelet dev` akışı, watch dizinleri, CSS hot-swap, devtools overlay (Alt+D, SEO highlight), rapor sayfası, dev gate |
30
- | [10-dagitim.md](./10-dagitim.md) | Prod build + start, ortam değişkenleri, Docker, ters proxy, sağlık kontrolü |
31
- | [11-tasima.md](./11-tasima.md) | Next.js'ten taşıma: karşılık tablosu ve adım adım plan |
32
- | [12-panel-ve-oturum.md](./12-panel-ve-oturum.md) | Kişiye özel sayfalar: `private: true`, imzalı cookie oturumu, CSRF, `fragment()`, parça takası ve form döngüsü |
33
-
34
- ## Konuya göre hızlı erişim
35
-
36
- - **Bir sayfa nasıl eklenir?** → [03-routing.md](./03-routing.md) ve
37
- [04-render-ve-sablonlar.md](./04-render-ve-sablonlar.md)
38
- - **Bir butona tıklandığında bir şey olsun istiyorum** →
39
- [05-islands.md](./05-islands.md)
40
- - **Sayfa neden `MISS` dönüyor / neden eski veri görüyorum?** →
41
- [06-cache.md](./06-cache.md)
42
- - **Oturuma bağlı bir sayfa nasıl yazılır?** →
43
- [12-panel-ve-oturum.md](./12-panel-ve-oturum.md)
44
- - **Hangi config alanı ne yapıyor?** → [07-yapilandirma.md](./07-yapilandirma.md)
45
- - **Stil çıkmıyor / ikon görünmüyor** → [08-build.md](./08-build.md)
46
- - **Yayına alma** → [10-dagitim.md](./10-dagitim.md)
47
-
48
- ## Çalışan örnekler
49
-
50
- Üçü de çalışır durumda; belgelerdeki örneklerin çoğu buralardan alınmıştır.
51
-
52
- **`examples/minimal/`** — iki route, bir bileşen, bir island, minimal config.
53
- Framework'ün en küçük çalışan hâli.
54
-
55
- ```bash
56
- npm --prefix examples/minimal install
57
- npm --prefix examples/minimal run dev
58
- ```
59
-
60
- **`examples/blog/`** — dinamik route (`/blog/:slug`), etiket sayfaları,
61
- `redirects`/`rewrites`/`headers`/`cache` yapılandırmasının tamamı, fragment ile
62
- gelen sekme panelleri, form gönderimi, prewarm, `robots.txt`/`sitemap.xml`/`rss.xml`,
63
- dinamik OG görselleri (`/og/blog/:slug.png`) ve dört island (tema, sekme, arama,
64
- form).
65
-
66
- ```bash
67
- npm --prefix examples/blog install
68
- npm --prefix examples/blog run dev
69
- ```
70
-
71
- **`examples/dashboard/`** — diğer ikisinin tersi eksen: kişiye özel sayfalar.
72
- İmzalı cookie ile giriş, `private: true` korumalı panel, sayfalı tablo
73
- fragment'i, CSRF'li mutasyon formu ve temizlik fonksiyonu döndüren bir island.
74
- Public bir tanıtım sayfası da var, böylece aynı uygulamada önbelleklenen ve
75
- `no-store` dönen iki yanıt yan yana görülüyor.
76
-
77
- ```bash
78
- npm --prefix examples/dashboard install
79
- npm --prefix examples/dashboard run dev
80
- ```
81
-
82
- Her üç örnekte `node smoke.mjs` sunucu ayaktayken uçların beklendiği gibi
83
- yanıt verdiğini doğrular.
1
+ # JSkelet belgeleri
2
+
3
+ JSkelet, SEO ve hız odaklı siteler için "framework'süz hissettiren" bir
4
+ framework: Express 5 + build-time `.jsk` ile sunucuda tam HTML üretir (EJS
5
+ opsiyonel legacy peer), etkileşimi vanilla JS island'larla ekler, CSS'i
6
+ Tailwind v4 ile tek bir stylesheet'e derler ve ISR yerine süreç belleğinde
7
+ yaşayan, stale-while-revalidate'li bir HTML TTL cache kullanır. React yok;
8
+ framework kaynağı düz JavaScript + JSDoc'tur. Uygulama tarafında client
9
+ island/entry'ler TypeScript yazılabilir ve paket `.d.ts` yayınlar.
10
+
11
+ Bu dizin framework'ün tam referansıdır. Sıralı okumak için baştan başlayın;
12
+ belirli bir konuyu arıyorsanız doğrudan ilgili başlığa gidin.
13
+
14
+ Aynı belgelerin İngilizcesi [`docs/en/`](./en/README.md) altında. İki sürüm elle
15
+ eşlenik tutuluyor; birini değiştiriyorsan diğerini de değiştir.
16
+
17
+ ## Sıralı okuma
18
+
19
+ | Belge | Konu |
20
+ | --- | --- |
21
+ | [01-baslangic.md](./01-baslangic.md) | Kurulum, `jskelet init`, ilk route, ilk island, dizin yapısı, CLI komutları |
22
+ | [02-mimari.md](./02-mimari.md) | Mimari kararlar ve gerekçeleri: island modeli, tam sunucu HTML'i, cache stratejisi, middleware sırası |
23
+ | [03-routing.md](./03-routing.md) | Route modülü sözleşmesi, yükleme sırası, controller sözleşmesi, `ctx`, `notFound`/`redirect`, config redirects/rewrites |
24
+ | [04-render-ve-sablonlar.md](./04-render-ve-sablonlar.md) | `.jsk` layout/sayfalar, otomatik bileşen kaydı, `html`/`tags`, metadata → `<head>`, hook'lar; EJS legacy |
25
+ | [05-islands.md](./05-islands.md) | `data-island` sözleşmesi, hidrasyon stratejileri, `client/entries/*`, `createStore`, DOM yardımcıları, `startSafeImages` |
26
+ | [06-cache.md](./06-cache.md) | `withHtmlCache`, `revalidate`, stale-while-revalidate, cache anahtarı, `X-JSkelet-Cache`, istek içi cache, degraded render, prewarm |
27
+ | [07-yapilandirma.md](./07-yapilandirma.md) | `jskelet.config.mjs` tam referansı, `source` desen sözdizimi, ortam değişkenleri tablosu |
28
+ | [08-build.md](./08-build.md) | Build hattı, manifest, hash'li varlıklar, CSS/Tailwind `@source`, fontlar, ikon sprite, görsel optimizasyonu, precompress |
29
+ | [09-dev-araclari.md](./09-dev-araclari.md) | `jskelet dev` akışı, watch dizinleri, CSS hot-swap, devtools overlay (Alt+D, SEO highlight), rapor sayfası, dev gate |
30
+ | [10-dagitim.md](./10-dagitim.md) | Prod build + start, ortam değişkenleri, Docker, ters proxy, sağlık kontrolü |
31
+ | [11-tasima.md](./11-tasima.md) | Next.js'ten taşıma: karşılık tablosu ve adım adım plan |
32
+ | [12-panel-ve-oturum.md](./12-panel-ve-oturum.md) | Kişiye özel sayfalar: `private: true`, imzalı cookie oturumu, CSRF, `fragment()`, parça takası ve form döngüsü |
33
+
34
+ ## Konuya göre hızlı erişim
35
+
36
+ - **Bir sayfa nasıl eklenir?** → [03-routing.md](./03-routing.md) ve
37
+ [04-render-ve-sablonlar.md](./04-render-ve-sablonlar.md)
38
+ - **Bir butona tıklandığında bir şey olsun istiyorum** →
39
+ [05-islands.md](./05-islands.md)
40
+ - **Sayfa neden `MISS` dönüyor / neden eski veri görüyorum?** →
41
+ [06-cache.md](./06-cache.md)
42
+ - **Oturuma bağlı bir sayfa nasıl yazılır?** →
43
+ [12-panel-ve-oturum.md](./12-panel-ve-oturum.md)
44
+ - **Hangi config alanı ne yapıyor?** → [07-yapilandirma.md](./07-yapilandirma.md)
45
+ - **Stil çıkmıyor / ikon görünmüyor** → [08-build.md](./08-build.md)
46
+ - **Yayına alma** → [10-dagitim.md](./10-dagitim.md)
47
+
48
+ ## Çalışan örnekler
49
+
50
+ Üçü de çalışır durumda; belgelerdeki örneklerin çoğu buralardan alınmıştır.
51
+
52
+ **`examples/minimal/`** — iki route, bir bileşen, bir island, minimal config.
53
+ Framework'ün en küçük çalışan hâli.
54
+
55
+ ```bash
56
+ npm --prefix examples/minimal install
57
+ npm --prefix examples/minimal run dev
58
+ ```
59
+
60
+ **`examples/blog/`** — dinamik route (`/blog/:slug`), etiket sayfaları,
61
+ `redirects`/`rewrites`/`headers`/`cache` yapılandırmasının tamamı, fragment ile
62
+ gelen sekme panelleri, form gönderimi, prewarm, `robots.txt`/`sitemap.xml`/`rss.xml`,
63
+ dinamik OG görselleri (`/og/blog/:slug.png`) ve dört island (tema, sekme, arama,
64
+ form).
65
+
66
+ ```bash
67
+ npm --prefix examples/blog install
68
+ npm --prefix examples/blog run dev
69
+ ```
70
+
71
+ **`examples/dashboard/`** — diğer ikisinin tersi eksen: kişiye özel sayfalar.
72
+ İmzalı cookie ile giriş, `private: true` korumalı panel, sayfalı tablo
73
+ fragment'i, CSRF'li mutasyon formu ve temizlik fonksiyonu döndüren bir island.
74
+ Public bir tanıtım sayfası da var, böylece aynı uygulamada önbelleklenen ve
75
+ `no-store` dönen iki yanıt yan yana görülüyor.
76
+
77
+ ```bash
78
+ npm --prefix examples/dashboard install
79
+ npm --prefix examples/dashboard run dev
80
+ ```
81
+
82
+ Her üç örnekte `node smoke.mjs` sunucu ayaktayken uçların beklendiği gibi
83
+ yanıt verdiğini doğrular.