jskelet 0.6.2 → 0.6.3

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 (155) hide show
  1. package/AGENTS.md +136 -136
  2. package/CHANGELOG.md +620 -596
  3. package/LICENSE +21 -21
  4. package/bin/jskelet.mjs +130 -130
  5. package/docs/01-baslangic.md +291 -291
  6. package/docs/02-mimari.md +310 -309
  7. package/docs/03-routing.md +515 -515
  8. package/docs/04-render-ve-sablonlar.md +661 -661
  9. package/docs/05-islands.md +486 -486
  10. package/docs/06-cache.md +1443 -1423
  11. package/docs/07-yapilandirma.md +12 -6
  12. package/docs/08-build.md +429 -428
  13. package/docs/09-dev-araclari.md +364 -364
  14. package/docs/10-dagitim.md +338 -338
  15. package/docs/12-panel-ve-oturum.md +478 -478
  16. package/docs/README.md +83 -83
  17. package/docs/en/01-getting-started.md +298 -298
  18. package/docs/en/02-architecture.md +329 -328
  19. package/docs/en/03-routing.md +531 -531
  20. package/docs/en/04-rendering.md +669 -669
  21. package/docs/en/05-islands.md +497 -497
  22. package/docs/en/06-caching.md +1453 -1431
  23. package/docs/en/07-configuration.md +1219 -1214
  24. package/docs/en/08-build.md +447 -446
  25. package/docs/en/09-dev-tools.md +373 -373
  26. package/docs/en/10-deployment.md +340 -340
  27. package/docs/en/11-migration.md +398 -398
  28. package/docs/en/12-dashboards-and-sessions.md +488 -488
  29. package/docs/en/README.md +87 -87
  30. package/package.json +137 -137
  31. package/src/build/ensure-build.mjs +19 -19
  32. package/src/build/paths.mjs +153 -153
  33. package/src/build/resolve-peer.mjs +36 -36
  34. package/src/build/tasks/client.mjs +349 -349
  35. package/src/build/tasks/css.mjs +235 -235
  36. package/src/build/tasks/fonts.mjs +146 -146
  37. package/src/build/tasks/icons.mjs +357 -357
  38. package/src/build/tasks/images.mjs +244 -244
  39. package/src/build/tasks/precompress.mjs +78 -78
  40. package/src/build/tasks/templates.mjs +20 -20
  41. package/src/client/admin/i18n.js +764 -764
  42. package/src/client/admin/login.html +74 -74
  43. package/src/client/admin/panel.css +809 -809
  44. package/src/client/admin/panel.html +495 -495
  45. package/src/client/admin/panel.js +1251 -1251
  46. package/src/client/devtools/report.html +185 -185
  47. package/src/client/devtools/report.js +745 -745
  48. package/src/client/devtools/seo.js +628 -628
  49. package/src/client/dom.js +95 -95
  50. package/src/client/form.js +192 -192
  51. package/src/client/index.js +45 -45
  52. package/src/client/registry.js +305 -305
  53. package/src/client/safe-image.js +91 -91
  54. package/src/client/shared-cookie.js +225 -225
  55. package/src/client/store.js +36 -36
  56. package/src/client/swap.js +188 -188
  57. package/src/compile/codegen.js +336 -336
  58. package/src/compile/compile-all.js +149 -149
  59. package/src/compile/errors.js +66 -66
  60. package/src/compile/expr.js +409 -409
  61. package/src/compile/index.js +17 -17
  62. package/src/compile/parse.js +541 -541
  63. package/src/compile/resolve.js +211 -211
  64. package/src/compile/scan-exports.js +51 -51
  65. package/src/config/defaults.js +17 -1
  66. package/src/config/index.js +13 -0
  67. package/src/config/pattern.js +107 -107
  68. package/src/generate.mjs +163 -163
  69. package/src/http/control-flow.js +71 -71
  70. package/src/http/cookies-entry.js +21 -21
  71. package/src/http/cookies.js +277 -277
  72. package/src/http/request-cache.js +46 -46
  73. package/src/http/request-context.js +165 -165
  74. package/src/http/shared-cookie.js +178 -178
  75. package/src/index.js +101 -101
  76. package/src/init.mjs +230 -230
  77. package/src/migrate/apply.mjs +262 -262
  78. package/src/migrate/babel.mjs +79 -79
  79. package/src/migrate/classify.mjs +155 -155
  80. package/src/migrate/config.mjs +126 -126
  81. package/src/migrate/fs-walk.mjs +191 -191
  82. package/src/migrate/parse.mjs +26 -26
  83. package/src/migrate/scan.mjs +177 -177
  84. package/src/migrate/transform/expr-source.mjs +168 -168
  85. package/src/migrate/transform/island.mjs +67 -67
  86. package/src/migrate/transform/jsx-to-component.mjs +302 -302
  87. package/src/migrate/transform/jsx-to-jsk.mjs +330 -330
  88. package/src/migrate/transform/page-split.mjs +435 -435
  89. package/src/migrate/write.mjs +81 -81
  90. package/src/migrate.mjs +171 -171
  91. package/src/runtime/alias-hooks.mjs +119 -119
  92. package/src/runtime/register.mjs +4 -4
  93. package/src/server/admin/actions.js +229 -229
  94. package/src/server/admin/auth.js +125 -125
  95. package/src/server/admin/event-log.js +151 -151
  96. package/src/server/admin/gate.js +209 -209
  97. package/src/server/admin/inventory.js +188 -188
  98. package/src/server/admin/mount.js +56 -56
  99. package/src/server/admin/router.js +216 -216
  100. package/src/server/admin/snapshot.js +241 -241
  101. package/src/server/assets.js +147 -147
  102. package/src/server/auth/handoff.js +309 -309
  103. package/src/server/cache-blob.js +70 -0
  104. package/src/server/cache-deps.js +42 -42
  105. package/src/server/cache-vary.js +113 -113
  106. package/src/server/cloudflare.js +607 -607
  107. package/src/server/create-app.js +366 -366
  108. package/src/server/data-cache.js +553 -462
  109. package/src/server/dev/report.js +485 -485
  110. package/src/server/dev/socket.js +170 -170
  111. package/src/server/dev/version-check.mjs +139 -139
  112. package/src/server/disk-cache.js +233 -0
  113. package/src/server/ejs-adapter.js +59 -59
  114. package/src/server/html-cache.js +1196 -1122
  115. package/src/server/image-optimizer.js +500 -407
  116. package/src/server/logs/access-middleware.js +66 -66
  117. package/src/server/logs/file-sink.js +193 -66
  118. package/src/server/logs/pipeline.js +165 -158
  119. package/src/server/logs/s3-put.js +214 -214
  120. package/src/server/logs/s3-sink.js +112 -112
  121. package/src/server/metadata.js +102 -102
  122. package/src/server/middleware/compression.js +205 -205
  123. package/src/server/middleware/csrf.js +134 -134
  124. package/src/server/middleware/dev-gate.js +75 -75
  125. package/src/server/middleware/headers.js +37 -37
  126. package/src/server/middleware/redirects.js +32 -32
  127. package/src/server/middleware/robots-txt.js +341 -341
  128. package/src/server/middleware/static-precompressed.js +121 -100
  129. package/src/server/middleware/trailing-slash.js +53 -53
  130. package/src/server/middleware/upstream-proxy.js +141 -141
  131. package/src/server/og-image.js +356 -356
  132. package/src/server/port-guard.js +255 -255
  133. package/src/server/prewarm.js +1082 -1058
  134. package/src/server/redis.js +588 -569
  135. package/src/server/render.js +4 -4
  136. package/src/server/router.js +157 -157
  137. package/src/server/status-page.js +265 -265
  138. package/src/server/upstream-limiter.js +376 -376
  139. package/src/server/upstream-tracking.js +166 -166
  140. package/src/shared/cookie-domain.js +66 -66
  141. package/src/start.mjs +22 -22
  142. package/src/templates/layout.ejs +30 -30
  143. package/src/templates/layout.jsk +30 -30
  144. package/src/version.mjs +31 -31
  145. package/src/views/components/loader.js +101 -101
  146. package/src/views/helpers/html.js +102 -102
  147. package/src/views/helpers/tags.js +375 -375
  148. package/types/config/defaults.d.ts +15 -1
  149. package/types/config/index.d.ts +8 -0
  150. package/types/server/cache-blob.d.ts +13 -0
  151. package/types/server/data-cache.d.ts +9 -0
  152. package/types/server/disk-cache.d.ts +36 -0
  153. package/types/server/html-cache.d.ts +26 -3
  154. package/types/server/logs/file-sink.d.ts +16 -5
  155. package/types/server/redis.d.ts +2 -1
@@ -1,409 +1,409 @@
1
- /**
2
- * Şablon ifadeleri — kısıtlı alt küme. İstek anında yorumlanmaz; build'de
3
- * JS kaynak metnine çevrilir. Çağrı, atama ve `new` yok.
4
- */
5
- import { CompileError } from "./errors.js";
6
-
7
- /**
8
- * @typedef {{ type: 'Literal', value: string | number | boolean | null, raw: string }} LiteralNode
9
- * @typedef {{ type: 'Ident', name: string }} IdentNode
10
- * @typedef {{ type: 'Member', object: ExprNode, property: string, optional: boolean }} MemberNode
11
- * @typedef {{ type: 'Index', object: ExprNode, index: ExprNode, optional: boolean }} IndexNode
12
- * @typedef {{ type: 'Unary', op: '!' | '-', argument: ExprNode }} UnaryNode
13
- * @typedef {{ type: 'Binary', op: string, left: ExprNode, right: ExprNode }} BinaryNode
14
- * @typedef {{ type: 'Cond', test: ExprNode, consequent: ExprNode, alternate: ExprNode }} CondNode
15
- * @typedef {LiteralNode | IdentNode | MemberNode | IndexNode | UnaryNode | BinaryNode | CondNode} ExprNode
16
- */
17
-
18
- const IDENT_START = /[A-Za-z_$]/
19
- const IDENT_CONT = /[A-Za-z0-9_$]/
20
-
21
- /**
22
- * @param {string} source
23
- * @param {number} start
24
- * @param {number} end
25
- * @param {{ file?: string, templateSource?: string, templateIndex?: number }} [meta]
26
- * @returns {ExprNode}
27
- */
28
- export function parseExpr(source, start = 0, end = source.length, meta = {}) {
29
- const parser = new ExprParser(source, start, end, meta);
30
- const node = parser.parseCond();
31
- parser.skipWs();
32
- if (parser.i < parser.end) {
33
- throw parser.error(`Unexpected token in expression`);
34
- }
35
- return node;
36
- }
37
-
38
- /**
39
- * İfadeyi JS kaynak metnine çevirir. `locals` içindeki isimler çıplak kalır;
40
- * diğerleri `data.` öneki alır.
41
- *
42
- * @param {ExprNode} node
43
- * @param {Set<string>} [locals]
44
- * @returns {string}
45
- */
46
- export function codegenExpr(node, locals = new Set()) {
47
- switch (node.type) {
48
- case "Literal":
49
- return node.raw;
50
- case "Ident":
51
- if (locals.has(node.name)) return node.name;
52
- return `data.${node.name}`;
53
- case "Member": {
54
- const obj = codegenExpr(node.object, locals);
55
- const op = node.optional ? "?." : ".";
56
- return `${obj}${op}${node.property}`;
57
- }
58
- case "Index": {
59
- const obj = codegenExpr(node.object, locals);
60
- const idx = codegenExpr(node.index, locals);
61
- const op = node.optional ? "?.[" : "[";
62
- return `${obj}${op}${idx}]`;
63
- }
64
- case "Unary":
65
- return `(${node.op}${codegenExpr(node.argument, locals)})`;
66
- case "Binary":
67
- return `(${codegenExpr(node.left, locals)} ${node.op} ${codegenExpr(node.right, locals)})`;
68
- case "Cond":
69
- return `(${codegenExpr(node.test, locals)} ? ${codegenExpr(node.consequent, locals)} : ${codegenExpr(node.alternate, locals)})`;
70
- default:
71
- throw new Error(`Unknown expr node: ${/** @type {{ type: string }} */ (node).type}`);
72
- }
73
- }
74
-
75
- /**
76
- * İfadede geçen kök tanımlayıcılar (data alanları / local adayları).
77
- * @param {ExprNode} node
78
- * @param {Set<string>} [out]
79
- * @returns {Set<string>}
80
- */
81
- export function collectIdents(node, out = new Set()) {
82
- switch (node.type) {
83
- case "Literal":
84
- break;
85
- case "Ident":
86
- out.add(node.name);
87
- break;
88
- case "Member":
89
- collectIdents(node.object, out);
90
- break;
91
- case "Index":
92
- collectIdents(node.object, out);
93
- collectIdents(node.index, out);
94
- break;
95
- case "Unary":
96
- collectIdents(node.argument, out);
97
- break;
98
- case "Binary":
99
- collectIdents(node.left, out);
100
- collectIdents(node.right, out);
101
- break;
102
- case "Cond":
103
- collectIdents(node.test, out);
104
- collectIdents(node.consequent, out);
105
- collectIdents(node.alternate, out);
106
- break;
107
- default:
108
- break;
109
- }
110
- return out;
111
- }
112
-
113
- class ExprParser {
114
- /**
115
- * @param {string} source
116
- * @param {number} start
117
- * @param {number} end
118
- * @param {{ file?: string, templateSource?: string, templateIndex?: number }} meta
119
- */
120
- constructor(source, start, end, meta) {
121
- this.source = source;
122
- this.i = start;
123
- this.end = end;
124
- this.meta = meta;
125
- this.base = start;
126
- }
127
-
128
- /**
129
- * @param {string} message
130
- * @returns {CompileError}
131
- */
132
- error(message) {
133
- const offset = this.meta.templateIndex != null ? this.meta.templateIndex + (this.i - this.base) : this.i;
134
- return new CompileError(message, {
135
- file: this.meta.file,
136
- source: this.meta.templateSource ?? this.source,
137
- index: this.meta.templateSource ? offset : this.i,
138
- });
139
- }
140
-
141
- skipWs() {
142
- while (this.i < this.end && /\s/.test(this.source[this.i])) this.i += 1;
143
- }
144
-
145
- peek() {
146
- return this.i < this.end ? this.source[this.i] : "";
147
- }
148
-
149
- /**
150
- * @param {string} expected
151
- */
152
- eat(expected) {
153
- this.skipWs();
154
- if (!this.source.startsWith(expected, this.i)) {
155
- throw this.error(`Expected '${expected}'`);
156
- }
157
- this.i += expected.length;
158
- }
159
-
160
- /**
161
- * @param {string} expected
162
- * @returns {boolean}
163
- */
164
- match(expected) {
165
- this.skipWs();
166
- if (!this.source.startsWith(expected, this.i)) return false;
167
- this.i += expected.length;
168
- return true;
169
- }
170
-
171
- /** @returns {ExprNode} */
172
- parseCond() {
173
- const test = this.parseOr();
174
- this.skipWs();
175
- if (!this.match("?")) return test;
176
- const consequent = this.parseCond();
177
- this.eat(":");
178
- const alternate = this.parseCond();
179
- return { type: "Cond", test, consequent, alternate };
180
- }
181
-
182
- /** @returns {ExprNode} */
183
- parseOr() {
184
- let left = this.parseAnd();
185
- for (;;) {
186
- this.skipWs();
187
- if (!this.match("||")) break;
188
- left = { type: "Binary", op: "||", left, right: this.parseAnd() };
189
- }
190
- return left;
191
- }
192
-
193
- /** @returns {ExprNode} */
194
- parseAnd() {
195
- let left = this.parseEquality();
196
- for (;;) {
197
- this.skipWs();
198
- if (!this.match("&&")) break;
199
- left = { type: "Binary", op: "&&", left, right: this.parseEquality() };
200
- }
201
- return left;
202
- }
203
-
204
- /** @returns {ExprNode} */
205
- parseEquality() {
206
- let left = this.parseCompare();
207
- for (;;) {
208
- this.skipWs();
209
- let op = null;
210
- if (this.match("===")) op = "===";
211
- else if (this.match("!==")) op = "!==";
212
- else if (this.match("==")) op = "==";
213
- else if (this.match("!=")) op = "!=";
214
- if (!op) break;
215
- left = { type: "Binary", op, left, right: this.parseCompare() };
216
- }
217
- return left;
218
- }
219
-
220
- /** @returns {ExprNode} */
221
- parseCompare() {
222
- let left = this.parseAdd();
223
- for (;;) {
224
- this.skipWs();
225
- let op = null;
226
- if (this.match("<=")) op = "<=";
227
- else if (this.match(">=")) op = ">=";
228
- else if (this.match("<")) op = "<";
229
- else if (this.match(">")) op = ">";
230
- if (!op) break;
231
- left = { type: "Binary", op, left, right: this.parseAdd() };
232
- }
233
- return left;
234
- }
235
-
236
- /** @returns {ExprNode} */
237
- parseAdd() {
238
- let left = this.parseMul();
239
- for (;;) {
240
- this.skipWs();
241
- const ch = this.peek();
242
- if (ch !== "+" && ch !== "-") break;
243
- // `?.` / sayılar ile karışmasın diye yalnızca tek karakter op.
244
- this.i += 1;
245
- left = { type: "Binary", op: ch, left, right: this.parseMul() };
246
- }
247
- return left;
248
- }
249
-
250
- /** @returns {ExprNode} */
251
- parseMul() {
252
- let left = this.parseUnary();
253
- for (;;) {
254
- this.skipWs();
255
- const ch = this.peek();
256
- if (ch !== "*" && ch !== "/" && ch !== "%") break;
257
- this.i += 1;
258
- left = { type: "Binary", op: ch, left, right: this.parseUnary() };
259
- }
260
- return left;
261
- }
262
-
263
- /** @returns {ExprNode} */
264
- parseUnary() {
265
- this.skipWs();
266
- if (this.match("!")) {
267
- return { type: "Unary", op: "!", argument: this.parseUnary() };
268
- }
269
- if (this.peek() === "-" && !/[0-9.]/.test(this.source[this.i + 1] ?? "")) {
270
- this.i += 1;
271
- return { type: "Unary", op: "-", argument: this.parseUnary() };
272
- }
273
- return this.parsePostfix();
274
- }
275
-
276
- /** @returns {ExprNode} */
277
- parsePostfix() {
278
- let node = this.parsePrimary();
279
- for (;;) {
280
- this.skipWs();
281
- if (this.peek() === "(") {
282
- throw this.error(
283
- "Function calls are not allowed in .jsk; move logic to a JS component or controller",
284
- );
285
- }
286
- if (this.match("?.")) {
287
- this.skipWs();
288
- if (this.peek() === "[") {
289
- this.i += 1;
290
- const index = this.parseCond();
291
- this.eat("]");
292
- node = { type: "Index", object: node, index, optional: true };
293
- continue;
294
- }
295
- const property = this.readIdent();
296
- node = { type: "Member", object: node, property, optional: true };
297
- continue;
298
- }
299
- if (this.peek() === ".") {
300
- this.i += 1;
301
- const property = this.readIdent();
302
- node = { type: "Member", object: node, property, optional: false };
303
- continue;
304
- }
305
- if (this.peek() === "[") {
306
- this.i += 1;
307
- const index = this.parseCond();
308
- this.eat("]");
309
- node = { type: "Index", object: node, index, optional: false };
310
- continue;
311
- }
312
- break;
313
- }
314
- return node;
315
- }
316
-
317
- /** @returns {ExprNode} */
318
- parsePrimary() {
319
- this.skipWs();
320
- const ch = this.peek();
321
-
322
- if (ch === "(") {
323
- this.i += 1;
324
- const node = this.parseCond();
325
- this.eat(")");
326
- return node;
327
- }
328
-
329
- if (ch === '"' || ch === "'") {
330
- return this.readString();
331
- }
332
-
333
- if (ch === "`") {
334
- throw this.error("Template literals are not allowed in expressions");
335
- }
336
-
337
- if (/[0-9]/.test(ch) || (ch === "." && /[0-9]/.test(this.source[this.i + 1] ?? ""))) {
338
- return this.readNumber();
339
- }
340
-
341
- if (IDENT_START.test(ch)) {
342
- const name = this.readIdent();
343
- if (name === "true") return { type: "Literal", value: true, raw: "true" };
344
- if (name === "false") return { type: "Literal", value: false, raw: "false" };
345
- if (name === "null") return { type: "Literal", value: null, raw: "null" };
346
- return { type: "Ident", name };
347
- }
348
-
349
- throw this.error("Expected expression");
350
- }
351
-
352
- /** @returns {string} */
353
- readIdent() {
354
- this.skipWs();
355
- if (!IDENT_START.test(this.peek())) {
356
- throw this.error("Expected identifier");
357
- }
358
- const start = this.i;
359
- this.i += 1;
360
- while (this.i < this.end && IDENT_CONT.test(this.source[this.i])) this.i += 1;
361
- return this.source.slice(start, this.i);
362
- }
363
-
364
- /** @returns {LiteralNode} */
365
- readString() {
366
- const quote = this.source[this.i];
367
- this.i += 1;
368
- let raw = quote;
369
- let value = "";
370
- while (this.i < this.end) {
371
- const ch = this.source[this.i];
372
- if (ch === "\\") {
373
- raw += ch + (this.source[this.i + 1] ?? "");
374
- value += this.source[this.i + 1] ?? "";
375
- this.i += 2;
376
- continue;
377
- }
378
- if (ch === quote) {
379
- raw += quote;
380
- this.i += 1;
381
- return { type: "Literal", value, raw };
382
- }
383
- if (ch === "\n") {
384
- throw this.error("Unterminated string");
385
- }
386
- raw += ch;
387
- value += ch;
388
- this.i += 1;
389
- }
390
- throw this.error("Unterminated string");
391
- }
392
-
393
- /** @returns {LiteralNode} */
394
- readNumber() {
395
- const start = this.i;
396
- while (this.i < this.end && /[0-9_]/.test(this.source[this.i])) this.i += 1;
397
- if (this.source[this.i] === ".") {
398
- this.i += 1;
399
- while (this.i < this.end && /[0-9_]/.test(this.source[this.i])) this.i += 1;
400
- }
401
- if (this.source[this.i] === "e" || this.source[this.i] === "E") {
402
- this.i += 1;
403
- if (this.source[this.i] === "+" || this.source[this.i] === "-") this.i += 1;
404
- while (this.i < this.end && /[0-9]/.test(this.source[this.i])) this.i += 1;
405
- }
406
- const raw = this.source.slice(start, this.i).replace(/_/g, "");
407
- return { type: "Literal", value: Number(raw), raw };
408
- }
409
- }
1
+ /**
2
+ * Şablon ifadeleri — kısıtlı alt küme. İstek anında yorumlanmaz; build'de
3
+ * JS kaynak metnine çevrilir. Çağrı, atama ve `new` yok.
4
+ */
5
+ import { CompileError } from "./errors.js";
6
+
7
+ /**
8
+ * @typedef {{ type: 'Literal', value: string | number | boolean | null, raw: string }} LiteralNode
9
+ * @typedef {{ type: 'Ident', name: string }} IdentNode
10
+ * @typedef {{ type: 'Member', object: ExprNode, property: string, optional: boolean }} MemberNode
11
+ * @typedef {{ type: 'Index', object: ExprNode, index: ExprNode, optional: boolean }} IndexNode
12
+ * @typedef {{ type: 'Unary', op: '!' | '-', argument: ExprNode }} UnaryNode
13
+ * @typedef {{ type: 'Binary', op: string, left: ExprNode, right: ExprNode }} BinaryNode
14
+ * @typedef {{ type: 'Cond', test: ExprNode, consequent: ExprNode, alternate: ExprNode }} CondNode
15
+ * @typedef {LiteralNode | IdentNode | MemberNode | IndexNode | UnaryNode | BinaryNode | CondNode} ExprNode
16
+ */
17
+
18
+ const IDENT_START = /[A-Za-z_$]/
19
+ const IDENT_CONT = /[A-Za-z0-9_$]/
20
+
21
+ /**
22
+ * @param {string} source
23
+ * @param {number} start
24
+ * @param {number} end
25
+ * @param {{ file?: string, templateSource?: string, templateIndex?: number }} [meta]
26
+ * @returns {ExprNode}
27
+ */
28
+ export function parseExpr(source, start = 0, end = source.length, meta = {}) {
29
+ const parser = new ExprParser(source, start, end, meta);
30
+ const node = parser.parseCond();
31
+ parser.skipWs();
32
+ if (parser.i < parser.end) {
33
+ throw parser.error(`Unexpected token in expression`);
34
+ }
35
+ return node;
36
+ }
37
+
38
+ /**
39
+ * İfadeyi JS kaynak metnine çevirir. `locals` içindeki isimler çıplak kalır;
40
+ * diğerleri `data.` öneki alır.
41
+ *
42
+ * @param {ExprNode} node
43
+ * @param {Set<string>} [locals]
44
+ * @returns {string}
45
+ */
46
+ export function codegenExpr(node, locals = new Set()) {
47
+ switch (node.type) {
48
+ case "Literal":
49
+ return node.raw;
50
+ case "Ident":
51
+ if (locals.has(node.name)) return node.name;
52
+ return `data.${node.name}`;
53
+ case "Member": {
54
+ const obj = codegenExpr(node.object, locals);
55
+ const op = node.optional ? "?." : ".";
56
+ return `${obj}${op}${node.property}`;
57
+ }
58
+ case "Index": {
59
+ const obj = codegenExpr(node.object, locals);
60
+ const idx = codegenExpr(node.index, locals);
61
+ const op = node.optional ? "?.[" : "[";
62
+ return `${obj}${op}${idx}]`;
63
+ }
64
+ case "Unary":
65
+ return `(${node.op}${codegenExpr(node.argument, locals)})`;
66
+ case "Binary":
67
+ return `(${codegenExpr(node.left, locals)} ${node.op} ${codegenExpr(node.right, locals)})`;
68
+ case "Cond":
69
+ return `(${codegenExpr(node.test, locals)} ? ${codegenExpr(node.consequent, locals)} : ${codegenExpr(node.alternate, locals)})`;
70
+ default:
71
+ throw new Error(`Unknown expr node: ${/** @type {{ type: string }} */ (node).type}`);
72
+ }
73
+ }
74
+
75
+ /**
76
+ * İfadede geçen kök tanımlayıcılar (data alanları / local adayları).
77
+ * @param {ExprNode} node
78
+ * @param {Set<string>} [out]
79
+ * @returns {Set<string>}
80
+ */
81
+ export function collectIdents(node, out = new Set()) {
82
+ switch (node.type) {
83
+ case "Literal":
84
+ break;
85
+ case "Ident":
86
+ out.add(node.name);
87
+ break;
88
+ case "Member":
89
+ collectIdents(node.object, out);
90
+ break;
91
+ case "Index":
92
+ collectIdents(node.object, out);
93
+ collectIdents(node.index, out);
94
+ break;
95
+ case "Unary":
96
+ collectIdents(node.argument, out);
97
+ break;
98
+ case "Binary":
99
+ collectIdents(node.left, out);
100
+ collectIdents(node.right, out);
101
+ break;
102
+ case "Cond":
103
+ collectIdents(node.test, out);
104
+ collectIdents(node.consequent, out);
105
+ collectIdents(node.alternate, out);
106
+ break;
107
+ default:
108
+ break;
109
+ }
110
+ return out;
111
+ }
112
+
113
+ class ExprParser {
114
+ /**
115
+ * @param {string} source
116
+ * @param {number} start
117
+ * @param {number} end
118
+ * @param {{ file?: string, templateSource?: string, templateIndex?: number }} meta
119
+ */
120
+ constructor(source, start, end, meta) {
121
+ this.source = source;
122
+ this.i = start;
123
+ this.end = end;
124
+ this.meta = meta;
125
+ this.base = start;
126
+ }
127
+
128
+ /**
129
+ * @param {string} message
130
+ * @returns {CompileError}
131
+ */
132
+ error(message) {
133
+ const offset = this.meta.templateIndex != null ? this.meta.templateIndex + (this.i - this.base) : this.i;
134
+ return new CompileError(message, {
135
+ file: this.meta.file,
136
+ source: this.meta.templateSource ?? this.source,
137
+ index: this.meta.templateSource ? offset : this.i,
138
+ });
139
+ }
140
+
141
+ skipWs() {
142
+ while (this.i < this.end && /\s/.test(this.source[this.i])) this.i += 1;
143
+ }
144
+
145
+ peek() {
146
+ return this.i < this.end ? this.source[this.i] : "";
147
+ }
148
+
149
+ /**
150
+ * @param {string} expected
151
+ */
152
+ eat(expected) {
153
+ this.skipWs();
154
+ if (!this.source.startsWith(expected, this.i)) {
155
+ throw this.error(`Expected '${expected}'`);
156
+ }
157
+ this.i += expected.length;
158
+ }
159
+
160
+ /**
161
+ * @param {string} expected
162
+ * @returns {boolean}
163
+ */
164
+ match(expected) {
165
+ this.skipWs();
166
+ if (!this.source.startsWith(expected, this.i)) return false;
167
+ this.i += expected.length;
168
+ return true;
169
+ }
170
+
171
+ /** @returns {ExprNode} */
172
+ parseCond() {
173
+ const test = this.parseOr();
174
+ this.skipWs();
175
+ if (!this.match("?")) return test;
176
+ const consequent = this.parseCond();
177
+ this.eat(":");
178
+ const alternate = this.parseCond();
179
+ return { type: "Cond", test, consequent, alternate };
180
+ }
181
+
182
+ /** @returns {ExprNode} */
183
+ parseOr() {
184
+ let left = this.parseAnd();
185
+ for (;;) {
186
+ this.skipWs();
187
+ if (!this.match("||")) break;
188
+ left = { type: "Binary", op: "||", left, right: this.parseAnd() };
189
+ }
190
+ return left;
191
+ }
192
+
193
+ /** @returns {ExprNode} */
194
+ parseAnd() {
195
+ let left = this.parseEquality();
196
+ for (;;) {
197
+ this.skipWs();
198
+ if (!this.match("&&")) break;
199
+ left = { type: "Binary", op: "&&", left, right: this.parseEquality() };
200
+ }
201
+ return left;
202
+ }
203
+
204
+ /** @returns {ExprNode} */
205
+ parseEquality() {
206
+ let left = this.parseCompare();
207
+ for (;;) {
208
+ this.skipWs();
209
+ let op = null;
210
+ if (this.match("===")) op = "===";
211
+ else if (this.match("!==")) op = "!==";
212
+ else if (this.match("==")) op = "==";
213
+ else if (this.match("!=")) op = "!=";
214
+ if (!op) break;
215
+ left = { type: "Binary", op, left, right: this.parseCompare() };
216
+ }
217
+ return left;
218
+ }
219
+
220
+ /** @returns {ExprNode} */
221
+ parseCompare() {
222
+ let left = this.parseAdd();
223
+ for (;;) {
224
+ this.skipWs();
225
+ let op = null;
226
+ if (this.match("<=")) op = "<=";
227
+ else if (this.match(">=")) op = ">=";
228
+ else if (this.match("<")) op = "<";
229
+ else if (this.match(">")) op = ">";
230
+ if (!op) break;
231
+ left = { type: "Binary", op, left, right: this.parseAdd() };
232
+ }
233
+ return left;
234
+ }
235
+
236
+ /** @returns {ExprNode} */
237
+ parseAdd() {
238
+ let left = this.parseMul();
239
+ for (;;) {
240
+ this.skipWs();
241
+ const ch = this.peek();
242
+ if (ch !== "+" && ch !== "-") break;
243
+ // `?.` / sayılar ile karışmasın diye yalnızca tek karakter op.
244
+ this.i += 1;
245
+ left = { type: "Binary", op: ch, left, right: this.parseMul() };
246
+ }
247
+ return left;
248
+ }
249
+
250
+ /** @returns {ExprNode} */
251
+ parseMul() {
252
+ let left = this.parseUnary();
253
+ for (;;) {
254
+ this.skipWs();
255
+ const ch = this.peek();
256
+ if (ch !== "*" && ch !== "/" && ch !== "%") break;
257
+ this.i += 1;
258
+ left = { type: "Binary", op: ch, left, right: this.parseUnary() };
259
+ }
260
+ return left;
261
+ }
262
+
263
+ /** @returns {ExprNode} */
264
+ parseUnary() {
265
+ this.skipWs();
266
+ if (this.match("!")) {
267
+ return { type: "Unary", op: "!", argument: this.parseUnary() };
268
+ }
269
+ if (this.peek() === "-" && !/[0-9.]/.test(this.source[this.i + 1] ?? "")) {
270
+ this.i += 1;
271
+ return { type: "Unary", op: "-", argument: this.parseUnary() };
272
+ }
273
+ return this.parsePostfix();
274
+ }
275
+
276
+ /** @returns {ExprNode} */
277
+ parsePostfix() {
278
+ let node = this.parsePrimary();
279
+ for (;;) {
280
+ this.skipWs();
281
+ if (this.peek() === "(") {
282
+ throw this.error(
283
+ "Function calls are not allowed in .jsk; move logic to a JS component or controller",
284
+ );
285
+ }
286
+ if (this.match("?.")) {
287
+ this.skipWs();
288
+ if (this.peek() === "[") {
289
+ this.i += 1;
290
+ const index = this.parseCond();
291
+ this.eat("]");
292
+ node = { type: "Index", object: node, index, optional: true };
293
+ continue;
294
+ }
295
+ const property = this.readIdent();
296
+ node = { type: "Member", object: node, property, optional: true };
297
+ continue;
298
+ }
299
+ if (this.peek() === ".") {
300
+ this.i += 1;
301
+ const property = this.readIdent();
302
+ node = { type: "Member", object: node, property, optional: false };
303
+ continue;
304
+ }
305
+ if (this.peek() === "[") {
306
+ this.i += 1;
307
+ const index = this.parseCond();
308
+ this.eat("]");
309
+ node = { type: "Index", object: node, index, optional: false };
310
+ continue;
311
+ }
312
+ break;
313
+ }
314
+ return node;
315
+ }
316
+
317
+ /** @returns {ExprNode} */
318
+ parsePrimary() {
319
+ this.skipWs();
320
+ const ch = this.peek();
321
+
322
+ if (ch === "(") {
323
+ this.i += 1;
324
+ const node = this.parseCond();
325
+ this.eat(")");
326
+ return node;
327
+ }
328
+
329
+ if (ch === '"' || ch === "'") {
330
+ return this.readString();
331
+ }
332
+
333
+ if (ch === "`") {
334
+ throw this.error("Template literals are not allowed in expressions");
335
+ }
336
+
337
+ if (/[0-9]/.test(ch) || (ch === "." && /[0-9]/.test(this.source[this.i + 1] ?? ""))) {
338
+ return this.readNumber();
339
+ }
340
+
341
+ if (IDENT_START.test(ch)) {
342
+ const name = this.readIdent();
343
+ if (name === "true") return { type: "Literal", value: true, raw: "true" };
344
+ if (name === "false") return { type: "Literal", value: false, raw: "false" };
345
+ if (name === "null") return { type: "Literal", value: null, raw: "null" };
346
+ return { type: "Ident", name };
347
+ }
348
+
349
+ throw this.error("Expected expression");
350
+ }
351
+
352
+ /** @returns {string} */
353
+ readIdent() {
354
+ this.skipWs();
355
+ if (!IDENT_START.test(this.peek())) {
356
+ throw this.error("Expected identifier");
357
+ }
358
+ const start = this.i;
359
+ this.i += 1;
360
+ while (this.i < this.end && IDENT_CONT.test(this.source[this.i])) this.i += 1;
361
+ return this.source.slice(start, this.i);
362
+ }
363
+
364
+ /** @returns {LiteralNode} */
365
+ readString() {
366
+ const quote = this.source[this.i];
367
+ this.i += 1;
368
+ let raw = quote;
369
+ let value = "";
370
+ while (this.i < this.end) {
371
+ const ch = this.source[this.i];
372
+ if (ch === "\\") {
373
+ raw += ch + (this.source[this.i + 1] ?? "");
374
+ value += this.source[this.i + 1] ?? "";
375
+ this.i += 2;
376
+ continue;
377
+ }
378
+ if (ch === quote) {
379
+ raw += quote;
380
+ this.i += 1;
381
+ return { type: "Literal", value, raw };
382
+ }
383
+ if (ch === "\n") {
384
+ throw this.error("Unterminated string");
385
+ }
386
+ raw += ch;
387
+ value += ch;
388
+ this.i += 1;
389
+ }
390
+ throw this.error("Unterminated string");
391
+ }
392
+
393
+ /** @returns {LiteralNode} */
394
+ readNumber() {
395
+ const start = this.i;
396
+ while (this.i < this.end && /[0-9_]/.test(this.source[this.i])) this.i += 1;
397
+ if (this.source[this.i] === ".") {
398
+ this.i += 1;
399
+ while (this.i < this.end && /[0-9_]/.test(this.source[this.i])) this.i += 1;
400
+ }
401
+ if (this.source[this.i] === "e" || this.source[this.i] === "E") {
402
+ this.i += 1;
403
+ if (this.source[this.i] === "+" || this.source[this.i] === "-") this.i += 1;
404
+ while (this.i < this.end && /[0-9]/.test(this.source[this.i])) this.i += 1;
405
+ }
406
+ const raw = this.source.slice(start, this.i).replace(/_/g, "");
407
+ return { type: "Literal", value: Number(raw), raw };
408
+ }
409
+ }