jskelet 0.2.5 → 0.3.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 (106) hide show
  1. package/AGENTS.md +132 -132
  2. package/CHANGELOG.md +403 -383
  3. package/LICENSE +21 -21
  4. package/bin/jskelet.mjs +103 -103
  5. package/docs/01-baslangic.md +285 -285
  6. package/docs/02-mimari.md +293 -287
  7. package/docs/03-routing.md +486 -480
  8. package/docs/04-render-ve-sablonlar.md +490 -490
  9. package/docs/05-islands.md +482 -482
  10. package/docs/06-cache.md +1231 -1209
  11. package/docs/07-yapilandirma.md +44 -21
  12. package/docs/08-build.md +366 -366
  13. package/docs/09-dev-araclari.md +335 -335
  14. package/docs/10-dagitim.md +329 -329
  15. package/docs/11-tasima.md +1 -0
  16. package/docs/12-panel-ve-oturum.md +384 -384
  17. package/docs/README.md +105 -105
  18. package/docs/en/01-getting-started.md +292 -292
  19. package/docs/en/02-architecture.md +311 -305
  20. package/docs/en/03-routing.md +503 -497
  21. package/docs/en/04-rendering.md +504 -504
  22. package/docs/en/05-islands.md +492 -492
  23. package/docs/en/06-caching.md +1197 -1198
  24. package/docs/en/07-configuration.md +1009 -986
  25. package/docs/en/08-build.md +383 -383
  26. package/docs/en/09-dev-tools.md +342 -342
  27. package/docs/en/10-deployment.md +332 -332
  28. package/docs/en/11-migration.md +360 -359
  29. package/docs/en/12-dashboards-and-sessions.md +392 -392
  30. package/docs/en/README.md +112 -112
  31. package/package.json +102 -102
  32. package/src/build/ensure-build.mjs +15 -15
  33. package/src/build/paths.mjs +143 -143
  34. package/src/build/resolve-peer.mjs +36 -36
  35. package/src/build/tasks/client.mjs +268 -268
  36. package/src/build/tasks/css.mjs +124 -124
  37. package/src/build/tasks/fonts.mjs +146 -146
  38. package/src/build/tasks/icons.mjs +224 -224
  39. package/src/build/tasks/images.mjs +244 -244
  40. package/src/build/tasks/precompress.mjs +78 -78
  41. package/src/client/{cache-panel → admin}/i18n.js +756 -670
  42. package/src/client/{cache-panel → admin}/login.html +74 -74
  43. package/src/client/{cache-panel → admin}/panel.css +804 -756
  44. package/src/client/admin/panel.html +486 -0
  45. package/src/client/{cache-panel → admin}/panel.js +1242 -915
  46. package/src/client/devtools/report.html +185 -185
  47. package/src/client/devtools/report.js +725 -725
  48. package/src/client/dom.js +95 -95
  49. package/src/client/form.js +192 -192
  50. package/src/client/index.js +35 -35
  51. package/src/client/registry.js +297 -297
  52. package/src/client/safe-image.js +91 -91
  53. package/src/client/store.js +36 -36
  54. package/src/client/swap.js +188 -188
  55. package/src/config/defaults.js +16 -7
  56. package/src/config/index.js +38 -22
  57. package/src/config/pattern.js +107 -107
  58. package/src/http/control-flow.js +71 -71
  59. package/src/http/cookies.js +257 -257
  60. package/src/http/request-cache.js +46 -46
  61. package/src/http/request-context.js +162 -162
  62. package/src/index.js +83 -83
  63. package/src/init.mjs +221 -221
  64. package/src/log.mjs +58 -0
  65. package/src/runtime/alias-hooks.mjs +119 -119
  66. package/src/runtime/register.mjs +4 -4
  67. package/src/server/admin/actions.js +229 -0
  68. package/src/server/admin/auth.js +125 -0
  69. package/src/server/admin/event-log.js +151 -0
  70. package/src/server/admin/gate.js +209 -0
  71. package/src/server/admin/inventory.js +188 -0
  72. package/src/server/admin/mount.js +56 -0
  73. package/src/server/admin/router.js +216 -0
  74. package/src/server/admin/snapshot.js +126 -0
  75. package/src/server/assets.js +147 -147
  76. package/src/server/cache-deps.js +42 -42
  77. package/src/server/cloudflare.js +607 -607
  78. package/src/server/create-app.js +295 -291
  79. package/src/server/data-cache.js +462 -462
  80. package/src/server/dev/report.js +369 -369
  81. package/src/server/dev/socket.js +170 -170
  82. package/src/server/dev/version-check.mjs +139 -139
  83. package/src/server/html-cache.js +817 -817
  84. package/src/server/metadata.js +102 -102
  85. package/src/server/middleware/compression.js +205 -205
  86. package/src/server/middleware/csrf.js +134 -134
  87. package/src/server/middleware/dev-gate.js +62 -62
  88. package/src/server/middleware/headers.js +37 -37
  89. package/src/server/middleware/redirects.js +32 -32
  90. package/src/server/middleware/static-precompressed.js +100 -100
  91. package/src/server/middleware/trailing-slash.js +53 -0
  92. package/src/server/middleware/upstream-proxy.js +141 -141
  93. package/src/server/prewarm.js +601 -601
  94. package/src/server/redis.js +569 -569
  95. package/src/server/router.js +128 -128
  96. package/src/server/status-page.js +164 -164
  97. package/src/server/upstream-limiter.js +376 -376
  98. package/src/server/upstream-tracking.js +166 -166
  99. package/src/start.mjs +7 -7
  100. package/src/templates/layout.ejs +44 -44
  101. package/src/version.mjs +31 -31
  102. package/src/views/components/loader.js +85 -85
  103. package/src/views/helpers/html.js +102 -102
  104. package/src/views/helpers/tags.js +245 -245
  105. package/src/client/cache-panel/panel.html +0 -308
  106. package/src/server/cache-panel.js +0 -759
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Ayberk Enis and JSkelet contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ayberk Enis and JSkelet contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/bin/jskelet.mjs CHANGED
@@ -1,104 +1,104 @@
1
1
  #!/usr/bin/env node
2
- /**
3
- * JSkelet CLI.
4
- *
5
- * jskelet dev build watch + sunucu, canlı yenileme, dev overlay
6
- * jskelet build tek seferlik prod build (fontlar, sprite, CSS, JS, görseller)
7
- * jskelet start prod sunucu (build eksikse önce üretir)
8
- * jskelet init bulunduğun dizine minimal iskelet kurar
9
- *
10
- * Alt komutlar ayrı süreçlerde çalışır. Sebep: `dev` iki uzun ömürlü süreci
11
- * (build watch + sunucu) yönetiyor ve sunucunun ESM resolve hook'larına
12
- * (`--import`) ihtiyacı var; bunlar süreç başlarken kurulmak zorunda.
13
- */
14
- import { spawn } from "node:child_process";
15
- import fs from "node:fs";
16
- import path from "node:path";
17
- import process from "node:process";
18
- import { fileURLToPath, pathToFileURL } from "node:url";
19
-
20
- const SRC = path.resolve(fileURLToPath(import.meta.url), "..", "..", "src");
21
-
22
- /**
23
- * `--import` bir modül **belirteci** bekler, dosya yolu değil. Windows'ta
24
- * `H:\...` mutlak yolu `h:` şemalı bir URL sanılıp reddediliyor; file:// URL'e
25
- * çevirmek her platformda doğru.
26
- */
27
- const REGISTER = pathToFileURL(path.join(SRC, "runtime", "register.mjs")).href;
28
-
29
- const [command, ...rest] = process.argv.slice(2);
30
-
31
- /**
32
- * `.env` yalnızca varsa geçilir: `--env-file-if-exists` dosya yokken de bir
33
- * bildirim satırı basıyor ve bu satır dev çıktısında hata gibi görünüyor.
34
- * `--import` alias hook'larını kurar; uygulama kodu `@/…` yazabilsin diye.
35
- *
36
- * @param {string} file
37
- * @param {{ env?: Record<string, string>, args?: string[], hooks?: boolean }} [options]
38
- * @returns {import('node:child_process').ChildProcess}
39
- */
40
- function run(file, options = {}) {
41
- const args = [
42
- ...(fs.existsSync(path.join(process.cwd(), ".env"))
43
- ? ["--env-file=.env"]
44
- : []),
45
- ...(options.hooks === false ? [] : ["--import", REGISTER]),
46
- file,
47
- ...(options.args ?? []),
48
- ];
49
-
50
- return spawn(process.execPath, args, {
51
- stdio: "inherit",
52
- env: { ...process.env, ...(options.env ?? {}) },
53
- });
54
- }
55
-
56
- /** @param {import('node:child_process').ChildProcess} child */
57
- function exitWith(child) {
58
- child.on("exit", (code) => process.exit(code ?? 0));
59
- }
60
-
61
- switch (command) {
62
- case "dev": {
63
- exitWith(run(path.join(SRC, "dev-server.mjs"), { hooks: false, args: rest }));
64
- break;
65
- }
66
-
67
- case "build": {
68
- exitWith(
69
- run(path.join(SRC, "build", "build.mjs"), {
70
- env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
71
- args: rest,
72
- }),
73
- );
74
- break;
75
- }
76
-
77
- case "start": {
78
- exitWith(
79
- run(path.join(SRC, "start.mjs"), {
80
- env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
81
- args: rest,
82
- }),
83
- );
84
- break;
85
- }
86
-
87
- case "init": {
88
- const { init } = await import("../src/init.mjs");
89
- await init(process.cwd());
90
- break;
91
- }
92
-
93
- default: {
94
- const known = command ? `unknown command: ${command}\n\n` : "";
95
- process.stderr.write(
96
- `${known}usage: jskelet <dev|build|start|init>\n\n` +
97
- " dev build watch + server (live reload, dev overlay)\n" +
98
- " build production build\n" +
99
- " start production server\n" +
100
- " init scaffold a minimal skeleton in the current directory\n",
101
- );
102
- process.exit(command ? 1 : 0);
103
- }
104
- }
2
+ /**
3
+ * JSkelet CLI.
4
+ *
5
+ * jskelet dev build watch + sunucu, canlı yenileme, dev overlay
6
+ * jskelet build tek seferlik prod build (fontlar, sprite, CSS, JS, görseller)
7
+ * jskelet start prod sunucu (build eksikse önce üretir)
8
+ * jskelet init bulunduğun dizine minimal iskelet kurar
9
+ *
10
+ * Alt komutlar ayrı süreçlerde çalışır. Sebep: `dev` iki uzun ömürlü süreci
11
+ * (build watch + sunucu) yönetiyor ve sunucunun ESM resolve hook'larına
12
+ * (`--import`) ihtiyacı var; bunlar süreç başlarken kurulmak zorunda.
13
+ */
14
+ import { spawn } from "node:child_process";
15
+ import fs from "node:fs";
16
+ import path from "node:path";
17
+ import process from "node:process";
18
+ import { fileURLToPath, pathToFileURL } from "node:url";
19
+
20
+ const SRC = path.resolve(fileURLToPath(import.meta.url), "..", "..", "src");
21
+
22
+ /**
23
+ * `--import` bir modül **belirteci** bekler, dosya yolu değil. Windows'ta
24
+ * `H:\...` mutlak yolu `h:` şemalı bir URL sanılıp reddediliyor; file:// URL'e
25
+ * çevirmek her platformda doğru.
26
+ */
27
+ const REGISTER = pathToFileURL(path.join(SRC, "runtime", "register.mjs")).href;
28
+
29
+ const [command, ...rest] = process.argv.slice(2);
30
+
31
+ /**
32
+ * `.env` yalnızca varsa geçilir: `--env-file-if-exists` dosya yokken de bir
33
+ * bildirim satırı basıyor ve bu satır dev çıktısında hata gibi görünüyor.
34
+ * `--import` alias hook'larını kurar; uygulama kodu `@/…` yazabilsin diye.
35
+ *
36
+ * @param {string} file
37
+ * @param {{ env?: Record<string, string>, args?: string[], hooks?: boolean }} [options]
38
+ * @returns {import('node:child_process').ChildProcess}
39
+ */
40
+ function run(file, options = {}) {
41
+ const args = [
42
+ ...(fs.existsSync(path.join(process.cwd(), ".env"))
43
+ ? ["--env-file=.env"]
44
+ : []),
45
+ ...(options.hooks === false ? [] : ["--import", REGISTER]),
46
+ file,
47
+ ...(options.args ?? []),
48
+ ];
49
+
50
+ return spawn(process.execPath, args, {
51
+ stdio: "inherit",
52
+ env: { ...process.env, ...(options.env ?? {}) },
53
+ });
54
+ }
55
+
56
+ /** @param {import('node:child_process').ChildProcess} child */
57
+ function exitWith(child) {
58
+ child.on("exit", (code) => process.exit(code ?? 0));
59
+ }
60
+
61
+ switch (command) {
62
+ case "dev": {
63
+ exitWith(run(path.join(SRC, "dev-server.mjs"), { hooks: false, args: rest }));
64
+ break;
65
+ }
66
+
67
+ case "build": {
68
+ exitWith(
69
+ run(path.join(SRC, "build", "build.mjs"), {
70
+ env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
71
+ args: rest,
72
+ }),
73
+ );
74
+ break;
75
+ }
76
+
77
+ case "start": {
78
+ exitWith(
79
+ run(path.join(SRC, "start.mjs"), {
80
+ env: { NODE_ENV: process.env.NODE_ENV ?? "production" },
81
+ args: rest,
82
+ }),
83
+ );
84
+ break;
85
+ }
86
+
87
+ case "init": {
88
+ const { init } = await import("../src/init.mjs");
89
+ await init(process.cwd());
90
+ break;
91
+ }
92
+
93
+ default: {
94
+ const known = command ? `unknown command: ${command}\n\n` : "";
95
+ process.stderr.write(
96
+ `${known}usage: jskelet <dev|build|start|init>\n\n` +
97
+ " dev build watch + server (live reload, dev overlay)\n" +
98
+ " build production build\n" +
99
+ " start production server\n" +
100
+ " init scaffold a minimal skeleton in the current directory\n",
101
+ );
102
+ process.exit(command ? 1 : 0);
103
+ }
104
+ }