npm - jskelet - Versions diffs - 0.6.2 → 0.6.3 - Mend

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

package/AGENTS.md +136 -136
package/CHANGELOG.md +620 -596
package/LICENSE +21 -21
package/bin/jskelet.mjs +130 -130
package/docs/01-baslangic.md +291 -291
package/docs/02-mimari.md +310 -309
package/docs/03-routing.md +515 -515
package/docs/04-render-ve-sablonlar.md +661 -661
package/docs/05-islands.md +486 -486
package/docs/06-cache.md +1443 -1423
package/docs/07-yapilandirma.md +12 -6
package/docs/08-build.md +429 -428
package/docs/09-dev-araclari.md +364 -364
package/docs/10-dagitim.md +338 -338
package/docs/12-panel-ve-oturum.md +478 -478
package/docs/README.md +83 -83
package/docs/en/01-getting-started.md +298 -298
package/docs/en/02-architecture.md +329 -328
package/docs/en/03-routing.md +531 -531
package/docs/en/04-rendering.md +669 -669
package/docs/en/05-islands.md +497 -497
package/docs/en/06-caching.md +1453 -1431
package/docs/en/07-configuration.md +1219 -1214
package/docs/en/08-build.md +447 -446
package/docs/en/09-dev-tools.md +373 -373
package/docs/en/10-deployment.md +340 -340
package/docs/en/11-migration.md +398 -398
package/docs/en/12-dashboards-and-sessions.md +488 -488
package/docs/en/README.md +87 -87
package/package.json +137 -137
package/src/build/ensure-build.mjs +19 -19
package/src/build/paths.mjs +153 -153
package/src/build/resolve-peer.mjs +36 -36
package/src/build/tasks/client.mjs +349 -349
package/src/build/tasks/css.mjs +235 -235
package/src/build/tasks/fonts.mjs +146 -146
package/src/build/tasks/icons.mjs +357 -357
package/src/build/tasks/images.mjs +244 -244
package/src/build/tasks/precompress.mjs +78 -78
package/src/build/tasks/templates.mjs +20 -20
package/src/client/admin/i18n.js +764 -764
package/src/client/admin/login.html +74 -74
package/src/client/admin/panel.css +809 -809
package/src/client/admin/panel.html +495 -495
package/src/client/admin/panel.js +1251 -1251
package/src/client/devtools/report.html +185 -185
package/src/client/devtools/report.js +745 -745
package/src/client/devtools/seo.js +628 -628
package/src/client/dom.js +95 -95
package/src/client/form.js +192 -192
package/src/client/index.js +45 -45
package/src/client/registry.js +305 -305
package/src/client/safe-image.js +91 -91
package/src/client/shared-cookie.js +225 -225
package/src/client/store.js +36 -36
package/src/client/swap.js +188 -188
package/src/compile/codegen.js +336 -336
package/src/compile/compile-all.js +149 -149
package/src/compile/errors.js +66 -66
package/src/compile/expr.js +409 -409
package/src/compile/index.js +17 -17
package/src/compile/parse.js +541 -541
package/src/compile/resolve.js +211 -211
package/src/compile/scan-exports.js +51 -51
package/src/config/defaults.js +17 -1
package/src/config/index.js +13 -0
package/src/config/pattern.js +107 -107
package/src/generate.mjs +163 -163
package/src/http/control-flow.js +71 -71
package/src/http/cookies-entry.js +21 -21
package/src/http/cookies.js +277 -277
package/src/http/request-cache.js +46 -46
package/src/http/request-context.js +165 -165
package/src/http/shared-cookie.js +178 -178
package/src/index.js +101 -101
package/src/init.mjs +230 -230
package/src/migrate/apply.mjs +262 -262
package/src/migrate/babel.mjs +79 -79
package/src/migrate/classify.mjs +155 -155
package/src/migrate/config.mjs +126 -126
package/src/migrate/fs-walk.mjs +191 -191
package/src/migrate/parse.mjs +26 -26
package/src/migrate/scan.mjs +177 -177
package/src/migrate/transform/expr-source.mjs +168 -168
package/src/migrate/transform/island.mjs +67 -67
package/src/migrate/transform/jsx-to-component.mjs +302 -302
package/src/migrate/transform/jsx-to-jsk.mjs +330 -330
package/src/migrate/transform/page-split.mjs +435 -435
package/src/migrate/write.mjs +81 -81
package/src/migrate.mjs +171 -171
package/src/runtime/alias-hooks.mjs +119 -119
package/src/runtime/register.mjs +4 -4
package/src/server/admin/actions.js +229 -229
package/src/server/admin/auth.js +125 -125
package/src/server/admin/event-log.js +151 -151
package/src/server/admin/gate.js +209 -209
package/src/server/admin/inventory.js +188 -188
package/src/server/admin/mount.js +56 -56
package/src/server/admin/router.js +216 -216
package/src/server/admin/snapshot.js +241 -241
package/src/server/assets.js +147 -147
package/src/server/auth/handoff.js +309 -309
package/src/server/cache-blob.js +70 -0
package/src/server/cache-deps.js +42 -42
package/src/server/cache-vary.js +113 -113
package/src/server/cloudflare.js +607 -607
package/src/server/create-app.js +366 -366
package/src/server/data-cache.js +553 -462
package/src/server/dev/report.js +485 -485
package/src/server/dev/socket.js +170 -170
package/src/server/dev/version-check.mjs +139 -139
package/src/server/disk-cache.js +233 -0
package/src/server/ejs-adapter.js +59 -59
package/src/server/html-cache.js +1196 -1122
package/src/server/image-optimizer.js +500 -407
package/src/server/logs/access-middleware.js +66 -66
package/src/server/logs/file-sink.js +193 -66
package/src/server/logs/pipeline.js +165 -158
package/src/server/logs/s3-put.js +214 -214
package/src/server/logs/s3-sink.js +112 -112
package/src/server/metadata.js +102 -102
package/src/server/middleware/compression.js +205 -205
package/src/server/middleware/csrf.js +134 -134
package/src/server/middleware/dev-gate.js +75 -75
package/src/server/middleware/headers.js +37 -37
package/src/server/middleware/redirects.js +32 -32
package/src/server/middleware/robots-txt.js +341 -341
package/src/server/middleware/static-precompressed.js +121 -100
package/src/server/middleware/trailing-slash.js +53 -53
package/src/server/middleware/upstream-proxy.js +141 -141
package/src/server/og-image.js +356 -356
package/src/server/port-guard.js +255 -255
package/src/server/prewarm.js +1082 -1058
package/src/server/redis.js +588 -569
package/src/server/render.js +4 -4
package/src/server/router.js +157 -157
package/src/server/status-page.js +265 -265
package/src/server/upstream-limiter.js +376 -376
package/src/server/upstream-tracking.js +166 -166
package/src/shared/cookie-domain.js +66 -66
package/src/start.mjs +22 -22
package/src/templates/layout.ejs +30 -30
package/src/templates/layout.jsk +30 -30
package/src/version.mjs +31 -31
package/src/views/components/loader.js +101 -101
package/src/views/helpers/html.js +102 -102
package/src/views/helpers/tags.js +375 -375
package/types/config/defaults.d.ts +15 -1
package/types/config/index.d.ts +8 -0
package/types/server/cache-blob.d.ts +13 -0
package/types/server/data-cache.d.ts +9 -0
package/types/server/disk-cache.d.ts +36 -0
package/types/server/html-cache.d.ts +26 -3
package/types/server/logs/file-sink.d.ts +16 -5
package/types/server/redis.d.ts +2 -1

package/src/compile/parse.js CHANGED Viewed

@@ -1,541 +1,541 @@
-/**
- * `.jsk` şablon ayrıştırıcı. HTML'e yakın sözdizimi + blok direktifleri.
- * İstek anında çalışmaz; yalnızca build-time.
- */
-import { CompileError } from "./errors.js";
-import { parseExpr } from "./expr.js";
-/** Self-closing HTML void elements. */
-const VOID = new Set([
-  "area",
-  "base",
-  "br",
-  "col",
-  "embed",
-  "hr",
-  "img",
-  "input",
-  "link",
-  "meta",
-  "param",
-  "source",
-  "track",
-  "wbr",
-]);
-/**
- * @typedef {import('./expr.js').ExprNode} ExprNode
- * @typedef {{ type: 'Text', value: string }} TextNode
- * @typedef {{ type: 'Interp', expr: ExprNode, raw: boolean, index: number }} InterpNode
- * @typedef {{ name: string, value: string | null, expr: ExprNode | null, bound: boolean, boolean: boolean, index: number }} AttrNode
- * @typedef {{ type: 'Element', name: string, attrs: AttrNode[], children: AstNode[], selfClosing: boolean, index: number }} ElementNode
- * @typedef {{ type: 'Component', name: string, attrs: AttrNode[], children: AstNode[], selfClosing: boolean, index: number }} ComponentNode
- * @typedef {{ type: 'If', test: ExprNode, consequent: AstNode[], alternate: AstNode[], index: number }} IfNode
- * @typedef {{ type: 'Each', list: ExprNode, item: string, indexName: string | null, children: AstNode[], index: number }} EachNode
- * @typedef {{ type: 'Include', path: string, index: number }} IncludeNode
- * @typedef {TextNode | InterpNode | ElementNode | ComponentNode | IfNode | EachNode | IncludeNode} AstNode
- */
-/**
- * @param {string} source
- * @param {{ file?: string }} [options]
- * @returns {AstNode[]}
- */
-export function parseTemplate(source, options = {}) {
-  const parser = new TemplateParser(source, options.file);
-  return parser.parseNodes();
-}
-/**
- * PascalCase bileşen mi?
- * @param {string} name
- * @returns {boolean}
- */
-export function isComponentTag(name) {
-  return /^[A-Z]/.test(name);
-}
-class TemplateParser {
-  /**
-   * @param {string} source
-   * @param {string} [file]
-   */
-  constructor(source, file) {
-    this.source = source;
-    this.file = file;
-    this.i = 0;
-    /** @type {string[]} Açık {#if}/{#each} kapanışları — EOF'ta öncelikli hata. */
-    this.blockStack = [];
-  }
-  /**
-   * @param {string} message
-   * @param {number} [index]
-   * @returns {CompileError}
-   */
-  error(message, index = this.i) {
-    return new CompileError(message, {
-      file: this.file,
-      source: this.source,
-      index,
-    });
-  }
-  eof() {
-    return this.i >= this.source.length;
-  }
-  peek(n = 0) {
-    return this.source[this.i + n] ?? "";
-  }
-  startsWith(value) {
-    return this.source.startsWith(value, this.i);
-  }
-  /**
-   * @param {string} [until]
-   * @returns {AstNode[]}
-   */
-  parseNodes(until) {
-    /** @type {AstNode[]} */
-    const nodes = [];
-    while (!this.eof()) {
-      if (until && this.startsWith(until)) break;
-      if (this.startsWith("<!--")) {
-        this.skipComment();
-        continue;
-      }
-      if (this.startsWith("{#")) {
-        nodes.push(this.parseDirective());
-        continue;
-      }
-      if (this.startsWith("{{")) {
-        nodes.push(this.parseInterp());
-        continue;
-      }
-      if (this.startsWith("</")) {
-        // Parent closes — leave for caller.
-        break;
-      }
-      // `<!DOCTYPE …>` / `<![CDATA[…]]>` — etiket değil; metin olarak bas.
-      // İlerletmezsek `<` + `!` dalı parseText'te de takılıp sonsuz döngü olur.
-      if (this.startsWith("<!")) {
-        nodes.push(this.parseDeclaration());
-        continue;
-      }
-      if (this.peek() === "<" && /[A-Za-z]/.test(this.peek(1))) {
-        nodes.push(this.parseTag());
-        continue;
-      }
-      nodes.push(this.parseText(until));
-    }
-    return nodes;
-  }
-  /**
-   * `<!DOCTYPE html>` gibi bildirimler. Kapanış `>` ilk tırnak dışı geçiş.
-   * @returns {TextNode}
-   */
-  parseDeclaration() {
-    const start = this.i;
-    this.i += 2; // <!
-    let quote = null;
-    while (!this.eof()) {
-      const ch = this.peek();
-      if (quote) {
-        if (ch === quote) quote = null;
-        this.i += 1;
-        continue;
-      }
-      if (ch === '"' || ch === "'") {
-        quote = ch;
-        this.i += 1;
-        continue;
-      }
-      if (ch === ">") {
-        this.i += 1;
-        break;
-      }
-      this.i += 1;
-    }
-    return { type: "Text", value: this.source.slice(start, this.i) };
-  }
-  skipComment() {
-    const end = this.source.indexOf("-->", this.i + 4);
-    if (end === -1) throw this.error("Unterminated HTML comment");
-    this.i = end + 3;
-  }
-  /**
-   * @param {string} [until]
-   * @returns {TextNode}
-   */
-  parseText(until) {
-    const start = this.i;
-    while (!this.eof()) {
-      if (this.startsWith("{{") || this.startsWith("{#") || this.startsWith("<!--")) break;
-      if (this.peek() === "<") break;
-      if (until && this.startsWith(until)) break;
-      this.i += 1;
-    }
-    return { type: "Text", value: this.source.slice(start, this.i) };
-  }
-  /** @returns {InterpNode} */
-  parseInterp() {
-    const index = this.i;
-    let raw = false;
-    if (this.startsWith("{{{")) {
-      raw = true;
-      this.i += 3;
-    } else {
-      this.i += 2;
-    }
-    const close = raw ? "}}}" : "}}";
-    const end = this.source.indexOf(close, this.i);
-    if (end === -1) throw this.error("Unterminated interpolation", index);
-    const exprSrc = this.source.slice(this.i, end).trim();
-    if (!exprSrc) throw this.error("Empty interpolation", index);
-    const expr = parseExpr(exprSrc, 0, exprSrc.length, {
-      file: this.file,
-      templateSource: this.source,
-      templateIndex: this.i,
-    });
-    this.i = end + close.length;
-    return { type: "Interp", expr, raw, index };
-  }
-  /** @returns {IfNode | EachNode | IncludeNode} */
-  parseDirective() {
-    const index = this.i;
-    if (this.startsWith("{#if")) {
-      return this.parseIf(index);
-    }
-    if (this.startsWith("{#each")) {
-      return this.parseEach(index);
-    }
-    if (this.startsWith("{#include")) {
-      return this.parseInclude(index);
-    }
-    // `{# comment #}` — kapanış `#}` zorunlu; yoksa bilinmeyen direktif.
-    if (this.startsWith("{#")) {
-      const end = this.source.indexOf("#}", this.i + 2);
-      if (end === -1) {
-        throw this.error("Unknown directive", index);
-      }
-      this.i = end + 2;
-      return { type: "Text", value: "" };
-    }
-    throw this.error("Unknown directive", index);
-  }
-  /**
-   * @param {number} index
-   * @returns {IfNode}
-   */
-  parseIf(index) {
-    this.i += 4; // {#if
-    const closeBrace = this.source.indexOf("}", this.i);
-    if (closeBrace === -1) throw this.error("Unterminated {#if}", index);
-    const testSrc = this.source.slice(this.i, closeBrace).trim();
-    if (!testSrc) throw this.error("Empty {#if} condition", index);
-    const test = parseExpr(testSrc, 0, testSrc.length, {
-      file: this.file,
-      templateSource: this.source,
-      templateIndex: this.i,
-    });
-    this.i = closeBrace + 1;
-    this.blockStack.push("{/if}");
-    /** @type {AstNode[]} */
-    let consequent;
-    /** @type {AstNode[]} */
-    let alternate = [];
-    try {
-      consequent = this.parseNodesUntil(["{#else}", "{/if}"]);
-      if (this.startsWith("{#else}")) {
-        this.i += "{#else}".length;
-        alternate = this.parseNodesUntil(["{/if}"]);
-      }
-    } finally {
-      this.blockStack.pop();
-    }
-    if (!this.startsWith("{/if}")) {
-      throw this.error("Expected {/if}", this.i);
-    }
-    this.i += "{/if}".length;
-    return { type: "If", test, consequent, alternate, index };
-  }
-  /**
-   * @param {string[]} markers
-   * @returns {AstNode[]}
-   */
-  parseNodesUntil(markers) {
-    /** @type {AstNode[]} */
-    const nodes = [];
-    while (!this.eof()) {
-      if (markers.some((m) => this.startsWith(m))) break;
-      if (this.startsWith("<!--")) {
-        this.skipComment();
-        continue;
-      }
-      if (this.startsWith("{#if") || this.startsWith("{#each") || this.startsWith("{#include")) {
-        nodes.push(this.parseDirective());
-        continue;
-      }
-      if (this.startsWith("{#")) {
-        // comment or unknown — parseDirective handles
-        const node = this.parseDirective();
-        if (node.type !== "Text" || node.value) nodes.push(node);
-        continue;
-      }
-      if (this.startsWith("{{")) {
-        nodes.push(this.parseInterp());
-        continue;
-      }
-      if (this.startsWith("</")) break;
-      if (this.startsWith("<!")) {
-        nodes.push(this.parseDeclaration());
-        continue;
-      }
-      if (this.peek() === "<" && /[A-Za-z]/.test(this.peek(1))) {
-        nodes.push(this.parseTag());
-        continue;
-      }
-      // Text until next special or marker
-      const start = this.i;
-      while (!this.eof()) {
-        if (markers.some((m) => this.startsWith(m))) break;
-        if (this.startsWith("{{") || this.startsWith("{#") || this.startsWith("<!--")) break;
-        if (this.peek() === "<") break;
-        this.i += 1;
-      }
-      if (this.i > start) {
-        nodes.push({ type: "Text", value: this.source.slice(start, this.i) });
-      } else if (!this.eof() && !markers.some((m) => this.startsWith(m))) {
-        // Stuck on unexpected char
-        throw this.error(`Unexpected character '${this.peek()}'`);
-      }
-    }
-    return nodes;
-  }
-  /**
-   * @param {number} index
-   * @returns {EachNode}
-   */
-  parseEach(index) {
-    this.i += 6; // {#each
-    const closeBrace = this.source.indexOf("}", this.i);
-    if (closeBrace === -1) throw this.error("Unterminated {#each}", index);
-    const head = this.source.slice(this.i, closeBrace).trim();
-    // `items as item` or `items as item, i`
-    const asMatch = head.match(/^(.+?)\s+as\s+([A-Za-z_$][\w$]*)\s*(?:,\s*([A-Za-z_$][\w$]*))?\s*$/);
-    if (!asMatch) {
-      throw this.error(
-        'Invalid {#each}: expected `{#each items as item}` or `{#each items as item, i}`',
-        index,
-      );
-    }
-    const list = parseExpr(asMatch[1].trim(), 0, asMatch[1].trim().length, {
-      file: this.file,
-      templateSource: this.source,
-      templateIndex: this.i,
-    });
-    this.i = closeBrace + 1;
-    this.blockStack.push("{/each}");
-    /** @type {AstNode[]} */
-    let children;
-    try {
-      children = this.parseNodesUntil(["{/each}"]);
-    } finally {
-      this.blockStack.pop();
-    }
-    if (!this.startsWith("{/each}")) {
-      throw this.error("Expected {/each}", this.i);
-    }
-    this.i += "{/each}".length;
-    return {
-      type: "Each",
-      list,
-      item: asMatch[2],
-      indexName: asMatch[3] ?? null,
-      children,
-      index,
-    };
-  }
-  /**
-   * @param {number} index
-   * @returns {IncludeNode}
-   */
-  parseInclude(index) {
-    this.i += 9; // {#include
-    const closeBrace = this.source.indexOf("}", this.i);
-    if (closeBrace === -1) throw this.error("Unterminated {#include}", index);
-    const raw = this.source.slice(this.i, closeBrace).trim();
-    const strMatch = raw.match(/^["']([^"']+)["']$/);
-    if (!strMatch) {
-      throw this.error('{#include} path must be a string literal', index);
-    }
-    this.i = closeBrace + 1;
-    return { type: "Include", path: strMatch[1], index };
-  }
-  /** @returns {ElementNode | ComponentNode} */
-  parseTag() {
-    const index = this.i;
-    this.i += 1; // <
-    const nameStart = this.i;
-    while (!this.eof() && /[A-Za-z0-9_-]/.test(this.peek())) this.i += 1;
-    const name = this.source.slice(nameStart, this.i);
-    if (!name) throw this.error("Expected tag name", index);
-    const attrs = this.parseAttrs();
-    this.skipWs();
-    let selfClosing = false;
-    if (this.startsWith("/>")) {
-      selfClosing = true;
-      this.i += 2;
-    } else if (this.peek() === ">") {
-      this.i += 1;
-    } else {
-      throw this.error("Expected '>' or '/>'", this.i);
-    }
-    const component = isComponentTag(name);
-    const voidEl = !component && VOID.has(name.toLowerCase());
-    /** @type {AstNode[]} */
-    let children = [];
-    if (!selfClosing && !voidEl) {
-      children = this.parseNodesUntil([`</${name}>`]);
-      if (!this.startsWith(`</${name}>`)) {
-        if (this.eof() && this.blockStack.length) {
-          throw this.error(`Expected ${this.blockStack.at(-1)}`, this.i);
-        }
-        throw this.error(`Expected </${name}>`, this.i);
-      }
-      this.i += `</${name}>`.length;
-    }
-    if (component) {
-      return { type: "Component", name, attrs, children, selfClosing, index };
-    }
-    return {
-      type: "Element",
-      name,
-      attrs,
-      children,
-      selfClosing: selfClosing || voidEl,
-      index,
-    };
-  }
-  skipWs() {
-    while (!this.eof() && /\s/.test(this.peek())) this.i += 1;
-  }
-  /** @returns {AttrNode[]} */
-  parseAttrs() {
-    /** @type {AttrNode[]} */
-    const attrs = [];
-    for (;;) {
-      this.skipWs();
-      if (this.peek() === ">" || this.startsWith("/>") || this.eof()) break;
-      const index = this.i;
-      let bound = false;
-      if (this.peek() === ":") {
-        bound = true;
-        this.i += 1;
-      }
-      if (!/[A-Za-z_]/.test(this.peek())) {
-        throw this.error("Expected attribute name", this.i);
-      }
-      const nameStart = this.i;
-      while (!this.eof() && /[A-Za-z0-9_:-]/.test(this.peek())) this.i += 1;
-      let name = this.source.slice(nameStart, this.i);
-      // Strip leading colon already handled; name may include data-*
-      if (bound && name.startsWith(":")) name = name.slice(1);
-      this.skipWs();
-      if (this.peek() !== "=") {
-        attrs.push({
-          name,
-          value: null,
-          expr: null,
-          bound: false,
-          boolean: true,
-          index,
-        });
-        continue;
-      }
-      this.i += 1;
-      this.skipWs();
-      if (bound) {
-        // :name="expr" or :name='expr'
-        const quote = this.peek();
-        if (quote !== '"' && quote !== "'") {
-          throw this.error("Bound attribute value must be quoted", this.i);
-        }
-        this.i += 1;
-        const end = this.source.indexOf(quote, this.i);
-        if (end === -1) throw this.error("Unterminated attribute value", index);
-        const exprSrc = this.source.slice(this.i, end).trim();
-        const expr = parseExpr(exprSrc, 0, exprSrc.length, {
-          file: this.file,
-          templateSource: this.source,
-          templateIndex: this.i,
-        });
-        this.i = end + 1;
-        attrs.push({ name, value: null, expr, bound: true, boolean: false, index });
-        continue;
-      }
-      // Literal attribute
-      const quote = this.peek();
-      if (quote === '"' || quote === "'") {
-        this.i += 1;
-        const end = this.source.indexOf(quote, this.i);
-        if (end === -1) throw this.error("Unterminated attribute value", index);
-        const value = this.source.slice(this.i, end);
-        this.i = end + 1;
-        // Allow {{ }} inside attribute values? Skip for v1 — use :bind
-        if (value.includes("{{")) {
-          throw this.error(
-            `Interpolation inside attribute "${name}" is not supported; use :${name}="..."`,
-            index,
-          );
-        }
-        attrs.push({ name, value, expr: null, bound: false, boolean: false, index });
-        continue;
-      }
-      // Unquoted
-      const vStart = this.i;
-      while (!this.eof() && !/[\s>]/.test(this.peek()) && !this.startsWith("/>")) {
-        this.i += 1;
-      }
-      const value = this.source.slice(vStart, this.i);
-      attrs.push({ name, value, expr: null, bound: false, boolean: false, index });
-    }
-    return attrs;
-  }
-}
+/**
+ * `.jsk` şablon ayrıştırıcı. HTML'e yakın sözdizimi + blok direktifleri.
+ * İstek anında çalışmaz; yalnızca build-time.
+ */
+import { CompileError } from "./errors.js";
+import { parseExpr } from "./expr.js";
+/** Self-closing HTML void elements. */
+const VOID = new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr",
+]);
+/**
+ * @typedef {import('./expr.js').ExprNode} ExprNode
+ * @typedef {{ type: 'Text', value: string }} TextNode
+ * @typedef {{ type: 'Interp', expr: ExprNode, raw: boolean, index: number }} InterpNode
+ * @typedef {{ name: string, value: string | null, expr: ExprNode | null, bound: boolean, boolean: boolean, index: number }} AttrNode
+ * @typedef {{ type: 'Element', name: string, attrs: AttrNode[], children: AstNode[], selfClosing: boolean, index: number }} ElementNode
+ * @typedef {{ type: 'Component', name: string, attrs: AttrNode[], children: AstNode[], selfClosing: boolean, index: number }} ComponentNode
+ * @typedef {{ type: 'If', test: ExprNode, consequent: AstNode[], alternate: AstNode[], index: number }} IfNode
+ * @typedef {{ type: 'Each', list: ExprNode, item: string, indexName: string | null, children: AstNode[], index: number }} EachNode
+ * @typedef {{ type: 'Include', path: string, index: number }} IncludeNode
+ * @typedef {TextNode | InterpNode | ElementNode | ComponentNode | IfNode | EachNode | IncludeNode} AstNode
+ */
+/**
+ * @param {string} source
+ * @param {{ file?: string }} [options]
+ * @returns {AstNode[]}
+ */
+export function parseTemplate(source, options = {}) {
+  const parser = new TemplateParser(source, options.file);
+  return parser.parseNodes();
+}
+/**
+ * PascalCase bileşen mi?
+ * @param {string} name
+ * @returns {boolean}
+ */
+export function isComponentTag(name) {
+  return /^[A-Z]/.test(name);
+}
+class TemplateParser {
+  /**
+   * @param {string} source
+   * @param {string} [file]
+   */
+  constructor(source, file) {
+    this.source = source;
+    this.file = file;
+    this.i = 0;
+    /** @type {string[]} Açık {#if}/{#each} kapanışları — EOF'ta öncelikli hata. */
+    this.blockStack = [];
+  }
+  /**
+   * @param {string} message
+   * @param {number} [index]
+   * @returns {CompileError}
+   */
+  error(message, index = this.i) {
+    return new CompileError(message, {
+      file: this.file,
+      source: this.source,
+      index,
+    });
+  }
+  eof() {
+    return this.i >= this.source.length;
+  }
+  peek(n = 0) {
+    return this.source[this.i + n] ?? "";
+  }
+  startsWith(value) {
+    return this.source.startsWith(value, this.i);
+  }
+  /**
+   * @param {string} [until]
+   * @returns {AstNode[]}
+   */
+  parseNodes(until) {
+    /** @type {AstNode[]} */
+    const nodes = [];
+    while (!this.eof()) {
+      if (until && this.startsWith(until)) break;
+      if (this.startsWith("<!--")) {
+        this.skipComment();
+        continue;
+      }
+      if (this.startsWith("{#")) {
+        nodes.push(this.parseDirective());
+        continue;
+      }
+      if (this.startsWith("{{")) {
+        nodes.push(this.parseInterp());
+        continue;
+      }
+      if (this.startsWith("</")) {
+        // Parent closes — leave for caller.
+        break;
+      }
+      // `<!DOCTYPE …>` / `<![CDATA[…]]>` — etiket değil; metin olarak bas.
+      // İlerletmezsek `<` + `!` dalı parseText'te de takılıp sonsuz döngü olur.
+      if (this.startsWith("<!")) {
+        nodes.push(this.parseDeclaration());
+        continue;
+      }
+      if (this.peek() === "<" && /[A-Za-z]/.test(this.peek(1))) {
+        nodes.push(this.parseTag());
+        continue;
+      }
+      nodes.push(this.parseText(until));
+    }
+    return nodes;
+  }
+  /**
+   * `<!DOCTYPE html>` gibi bildirimler. Kapanış `>` ilk tırnak dışı geçiş.
+   * @returns {TextNode}
+   */
+  parseDeclaration() {
+    const start = this.i;
+    this.i += 2; // <!
+    let quote = null;
+    while (!this.eof()) {
+      const ch = this.peek();
+      if (quote) {
+        if (ch === quote) quote = null;
+        this.i += 1;
+        continue;
+      }
+      if (ch === '"' || ch === "'") {
+        quote = ch;
+        this.i += 1;
+        continue;
+      }
+      if (ch === ">") {
+        this.i += 1;
+        break;
+      }
+      this.i += 1;
+    }
+    return { type: "Text", value: this.source.slice(start, this.i) };
+  }
+  skipComment() {
+    const end = this.source.indexOf("-->", this.i + 4);
+    if (end === -1) throw this.error("Unterminated HTML comment");
+    this.i = end + 3;
+  }
+  /**
+   * @param {string} [until]
+   * @returns {TextNode}
+   */
+  parseText(until) {
+    const start = this.i;
+    while (!this.eof()) {
+      if (this.startsWith("{{") || this.startsWith("{#") || this.startsWith("<!--")) break;
+      if (this.peek() === "<") break;
+      if (until && this.startsWith(until)) break;
+      this.i += 1;
+    }
+    return { type: "Text", value: this.source.slice(start, this.i) };
+  }
+  /** @returns {InterpNode} */
+  parseInterp() {
+    const index = this.i;
+    let raw = false;
+    if (this.startsWith("{{{")) {
+      raw = true;
+      this.i += 3;
+    } else {
+      this.i += 2;
+    }
+    const close = raw ? "}}}" : "}}";
+    const end = this.source.indexOf(close, this.i);
+    if (end === -1) throw this.error("Unterminated interpolation", index);
+    const exprSrc = this.source.slice(this.i, end).trim();
+    if (!exprSrc) throw this.error("Empty interpolation", index);
+    const expr = parseExpr(exprSrc, 0, exprSrc.length, {
+      file: this.file,
+      templateSource: this.source,
+      templateIndex: this.i,
+    });
+    this.i = end + close.length;
+    return { type: "Interp", expr, raw, index };
+  }
+  /** @returns {IfNode | EachNode | IncludeNode} */
+  parseDirective() {
+    const index = this.i;
+    if (this.startsWith("{#if")) {
+      return this.parseIf(index);
+    }
+    if (this.startsWith("{#each")) {
+      return this.parseEach(index);
+    }
+    if (this.startsWith("{#include")) {
+      return this.parseInclude(index);
+    }
+    // `{# comment #}` — kapanış `#}` zorunlu; yoksa bilinmeyen direktif.
+    if (this.startsWith("{#")) {
+      const end = this.source.indexOf("#}", this.i + 2);
+      if (end === -1) {
+        throw this.error("Unknown directive", index);
+      }
+      this.i = end + 2;
+      return { type: "Text", value: "" };
+    }
+    throw this.error("Unknown directive", index);
+  }
+  /**
+   * @param {number} index
+   * @returns {IfNode}
+   */
+  parseIf(index) {
+    this.i += 4; // {#if
+    const closeBrace = this.source.indexOf("}", this.i);
+    if (closeBrace === -1) throw this.error("Unterminated {#if}", index);
+    const testSrc = this.source.slice(this.i, closeBrace).trim();
+    if (!testSrc) throw this.error("Empty {#if} condition", index);
+    const test = parseExpr(testSrc, 0, testSrc.length, {
+      file: this.file,
+      templateSource: this.source,
+      templateIndex: this.i,
+    });
+    this.i = closeBrace + 1;
+    this.blockStack.push("{/if}");
+    /** @type {AstNode[]} */
+    let consequent;
+    /** @type {AstNode[]} */
+    let alternate = [];
+    try {
+      consequent = this.parseNodesUntil(["{#else}", "{/if}"]);
+      if (this.startsWith("{#else}")) {
+        this.i += "{#else}".length;
+        alternate = this.parseNodesUntil(["{/if}"]);
+      }
+    } finally {
+      this.blockStack.pop();
+    }
+    if (!this.startsWith("{/if}")) {
+      throw this.error("Expected {/if}", this.i);
+    }
+    this.i += "{/if}".length;
+    return { type: "If", test, consequent, alternate, index };
+  }
+  /**
+   * @param {string[]} markers
+   * @returns {AstNode[]}
+   */
+  parseNodesUntil(markers) {
+    /** @type {AstNode[]} */
+    const nodes = [];
+    while (!this.eof()) {
+      if (markers.some((m) => this.startsWith(m))) break;
+      if (this.startsWith("<!--")) {
+        this.skipComment();
+        continue;
+      }
+      if (this.startsWith("{#if") || this.startsWith("{#each") || this.startsWith("{#include")) {
+        nodes.push(this.parseDirective());
+        continue;
+      }
+      if (this.startsWith("{#")) {
+        // comment or unknown — parseDirective handles
+        const node = this.parseDirective();
+        if (node.type !== "Text" || node.value) nodes.push(node);
+        continue;
+      }
+      if (this.startsWith("{{")) {
+        nodes.push(this.parseInterp());
+        continue;
+      }
+      if (this.startsWith("</")) break;
+      if (this.startsWith("<!")) {
+        nodes.push(this.parseDeclaration());
+        continue;
+      }
+      if (this.peek() === "<" && /[A-Za-z]/.test(this.peek(1))) {
+        nodes.push(this.parseTag());
+        continue;
+      }
+      // Text until next special or marker
+      const start = this.i;
+      while (!this.eof()) {
+        if (markers.some((m) => this.startsWith(m))) break;
+        if (this.startsWith("{{") || this.startsWith("{#") || this.startsWith("<!--")) break;
+        if (this.peek() === "<") break;
+        this.i += 1;
+      }
+      if (this.i > start) {
+        nodes.push({ type: "Text", value: this.source.slice(start, this.i) });
+      } else if (!this.eof() && !markers.some((m) => this.startsWith(m))) {
+        // Stuck on unexpected char
+        throw this.error(`Unexpected character '${this.peek()}'`);
+      }
+    }
+    return nodes;
+  }
+  /**
+   * @param {number} index
+   * @returns {EachNode}
+   */
+  parseEach(index) {
+    this.i += 6; // {#each
+    const closeBrace = this.source.indexOf("}", this.i);
+    if (closeBrace === -1) throw this.error("Unterminated {#each}", index);
+    const head = this.source.slice(this.i, closeBrace).trim();
+    // `items as item` or `items as item, i`
+    const asMatch = head.match(/^(.+?)\s+as\s+([A-Za-z_$][\w$]*)\s*(?:,\s*([A-Za-z_$][\w$]*))?\s*$/);
+    if (!asMatch) {
+      throw this.error(
+        'Invalid {#each}: expected `{#each items as item}` or `{#each items as item, i}`',
+        index,
+      );
+    }
+    const list = parseExpr(asMatch[1].trim(), 0, asMatch[1].trim().length, {
+      file: this.file,
+      templateSource: this.source,
+      templateIndex: this.i,
+    });
+    this.i = closeBrace + 1;
+    this.blockStack.push("{/each}");
+    /** @type {AstNode[]} */
+    let children;
+    try {
+      children = this.parseNodesUntil(["{/each}"]);
+    } finally {
+      this.blockStack.pop();
+    }
+    if (!this.startsWith("{/each}")) {
+      throw this.error("Expected {/each}", this.i);
+    }
+    this.i += "{/each}".length;
+    return {
+      type: "Each",
+      list,
+      item: asMatch[2],
+      indexName: asMatch[3] ?? null,
+      children,
+      index,
+    };
+  }
+  /**
+   * @param {number} index
+   * @returns {IncludeNode}
+   */
+  parseInclude(index) {
+    this.i += 9; // {#include
+    const closeBrace = this.source.indexOf("}", this.i);
+    if (closeBrace === -1) throw this.error("Unterminated {#include}", index);
+    const raw = this.source.slice(this.i, closeBrace).trim();
+    const strMatch = raw.match(/^["']([^"']+)["']$/);
+    if (!strMatch) {
+      throw this.error('{#include} path must be a string literal', index);
+    }
+    this.i = closeBrace + 1;
+    return { type: "Include", path: strMatch[1], index };
+  }
+  /** @returns {ElementNode | ComponentNode} */
+  parseTag() {
+    const index = this.i;
+    this.i += 1; // <
+    const nameStart = this.i;
+    while (!this.eof() && /[A-Za-z0-9_-]/.test(this.peek())) this.i += 1;
+    const name = this.source.slice(nameStart, this.i);
+    if (!name) throw this.error("Expected tag name", index);
+    const attrs = this.parseAttrs();
+    this.skipWs();
+    let selfClosing = false;
+    if (this.startsWith("/>")) {
+      selfClosing = true;
+      this.i += 2;
+    } else if (this.peek() === ">") {
+      this.i += 1;
+    } else {
+      throw this.error("Expected '>' or '/>'", this.i);
+    }
+    const component = isComponentTag(name);
+    const voidEl = !component && VOID.has(name.toLowerCase());
+    /** @type {AstNode[]} */
+    let children = [];
+    if (!selfClosing && !voidEl) {
+      children = this.parseNodesUntil([`</${name}>`]);
+      if (!this.startsWith(`</${name}>`)) {
+        if (this.eof() && this.blockStack.length) {
+          throw this.error(`Expected ${this.blockStack.at(-1)}`, this.i);
+        }
+        throw this.error(`Expected </${name}>`, this.i);
+      }
+      this.i += `</${name}>`.length;
+    }
+    if (component) {
+      return { type: "Component", name, attrs, children, selfClosing, index };
+    }
+    return {
+      type: "Element",
+      name,
+      attrs,
+      children,
+      selfClosing: selfClosing || voidEl,
+      index,
+    };
+  }
+  skipWs() {
+    while (!this.eof() && /\s/.test(this.peek())) this.i += 1;
+  }
+  /** @returns {AttrNode[]} */
+  parseAttrs() {
+    /** @type {AttrNode[]} */
+    const attrs = [];
+    for (;;) {
+      this.skipWs();
+      if (this.peek() === ">" || this.startsWith("/>") || this.eof()) break;
+      const index = this.i;
+      let bound = false;
+      if (this.peek() === ":") {
+        bound = true;
+        this.i += 1;
+      }
+      if (!/[A-Za-z_]/.test(this.peek())) {
+        throw this.error("Expected attribute name", this.i);
+      }
+      const nameStart = this.i;
+      while (!this.eof() && /[A-Za-z0-9_:-]/.test(this.peek())) this.i += 1;
+      let name = this.source.slice(nameStart, this.i);
+      // Strip leading colon already handled; name may include data-*
+      if (bound && name.startsWith(":")) name = name.slice(1);
+      this.skipWs();
+      if (this.peek() !== "=") {
+        attrs.push({
+          name,
+          value: null,
+          expr: null,
+          bound: false,
+          boolean: true,
+          index,
+        });
+        continue;
+      }
+      this.i += 1;
+      this.skipWs();
+      if (bound) {
+        // :name="expr" or :name='expr'
+        const quote = this.peek();
+        if (quote !== '"' && quote !== "'") {
+          throw this.error("Bound attribute value must be quoted", this.i);
+        }
+        this.i += 1;
+        const end = this.source.indexOf(quote, this.i);
+        if (end === -1) throw this.error("Unterminated attribute value", index);
+        const exprSrc = this.source.slice(this.i, end).trim();
+        const expr = parseExpr(exprSrc, 0, exprSrc.length, {
+          file: this.file,
+          templateSource: this.source,
+          templateIndex: this.i,
+        });
+        this.i = end + 1;
+        attrs.push({ name, value: null, expr, bound: true, boolean: false, index });
+        continue;
+      }
+      // Literal attribute
+      const quote = this.peek();
+      if (quote === '"' || quote === "'") {
+        this.i += 1;
+        const end = this.source.indexOf(quote, this.i);
+        if (end === -1) throw this.error("Unterminated attribute value", index);
+        const value = this.source.slice(this.i, end);
+        this.i = end + 1;
+        // Allow {{ }} inside attribute values? Skip for v1 — use :bind
+        if (value.includes("{{")) {
+          throw this.error(
+            `Interpolation inside attribute "${name}" is not supported; use :${name}="..."`,
+            index,
+          );
+        }
+        attrs.push({ name, value, expr: null, bound: false, boolean: false, index });
+        continue;
+      }
+      // Unquoted
+      const vStart = this.i;
+      while (!this.eof() && !/[\s>]/.test(this.peek()) && !this.startsWith("/>")) {
+        this.i += 1;
+      }
+      const value = this.source.slice(vStart, this.i);
+      attrs.push({ name, value, expr: null, bound: false, boolean: false, index });
+    }
+    return attrs;
+  }
+}