jskelet 0.6.3 → 0.6.4

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 (153) hide show
  1. package/AGENTS.md +136 -136
  2. package/CHANGELOG.md +628 -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 +667 -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 +348 -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 +675 -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 +351 -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 +369 -356
  134. package/src/server/port-guard.js +255 -255
  135. package/src/server/prewarm.js +1082 -1082
  136. package/src/server/redis.js +588 -588
  137. package/src/server/render.js +910 -910
  138. package/src/server/router.js +157 -157
  139. package/src/server/status-page.js +265 -265
  140. package/src/server/upstream-limiter.js +376 -376
  141. package/src/server/upstream-tracking.js +166 -166
  142. package/src/shared/cookie-domain.js +66 -66
  143. package/src/start.mjs +22 -22
  144. package/src/templates/layout.ejs +30 -30
  145. package/src/templates/layout.jsk +30 -30
  146. package/src/version.mjs +31 -31
  147. package/src/views/components/loader.js +101 -101
  148. package/src/views/helpers/html.js +102 -102
  149. package/src/views/helpers/tags.js +375 -375
  150. package/types/config/defaults.d.ts +6 -0
  151. package/types/config/index.d.ts +6 -0
  152. package/types/server/cache-control.d.ts +28 -0
  153. package/types/server/og-image.d.ts +5 -0
@@ -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
+ }