@jefuriiij/synthra 0.1.20 → 0.1.21

package/CHANGELOG.md

@@ -7,6 +7,29 @@ For older versions, see [GitHub Releases](https://github.com/jefuriiij/synthra/r
 
 ---
 
+## [0.1.21] — 2026-06-06
+
+### Added
+
+- **HubL (HubSpot CMS) symbol extraction for `.html` and `.hubl` files.**
+  Previously `.html` files were content-indexed only — keyword search and
+  whole-file reads, no symbol-level granularity. On HubSpot projects this
+  meant the graph contributed nothing: zero `graph_continue`/`graph_read`
+  calls resolved to symbol slices all session. Now `.html` and `.hubl` files
+  run through a new **regex-based** parser (`parsers/hubl.ts`; there is no
+  tree-sitter grammar for HubL):
+  - `{% macro name(args) %}` → extracted as a `function` symbol
+  - `{% block name %}` → extracted as a `component` symbol
+  - `{% include / extends / import / from "path" %}` → import edges (relative
+    paths resolve to local templates; `.html`/`.hubl` added to the resolver's
+    extension list)
+
+  Plain HTML with no HubL tags is unaffected — the parser yields zero symbols
+  and zero imports, identical to before. No API, protocol, or policy-block
+  change. Roadmap item #12.
+
+---
+
 ## [0.1.20] — 2026-06-06
 
 ### Fixed

package/dist/cli/index.js

@@ -18,7 +18,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@jefuriiij/synthra",
-      version: "0.1.20",
+      version: "0.1.21",
       publishConfig: {
         access: "public"
       },
@@ -2170,7 +2170,7 @@ function extractKeywords(content, _ext) {
 }
 
 // src/scanner/extract.ts
-var RESOLVE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".svelte", ".vue", ".dart"];
+var RESOLVE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".svelte", ".vue", ".dart", ".html", ".hubl"];
 var INDEX_FILES = ["index.ts", "index.tsx", "index.js", "index.jsx", "__init__.py"];
 function fileId(relPath) {
   return `file:${relPath}`;
@@ -2574,6 +2574,57 @@ async function parseGo(f, source) {
   );
 }
 
+// src/scanner/parsers/hubl.ts
+var MACRO_RE = /\{%-?\s*macro\s+([A-Za-z_]\w*)\s*\(([^)]*)\)/g;
+var ENDMACRO_RE = /\{%-?\s*endmacro\b/g;
+var BLOCK_RE = /\{%-?\s*block\s+([A-Za-z_]\w*)/g;
+var ENDBLOCK_RE = /\{%-?\s*endblock\b/g;
+var IMPORT_RE = /\{%-?\s*(?:include|extends|import|from)\s+["']([^"']+)["']/g;
+function lineAt(source, index) {
+  return source.slice(0, index).split(/\r?\n/).length;
+}
+function endLineAfter(source, fromIndex, endRe, startLine) {
+  endRe.lastIndex = fromIndex;
+  const m = endRe.exec(source);
+  return m ? lineAt(source, m.index) : startLine;
+}
+function parseHubL(f, source) {
+  const symbols = [];
+  const imports = [];
+  for (const m of source.matchAll(MACRO_RE)) {
+    const name = m[1];
+    if (!name) continue;
+    const args = (m[2] ?? "").trim();
+    const start = m.index ?? 0;
+    const startLine = lineAt(source, start);
+    symbols.push({
+      name,
+      kind: "function",
+      startLine,
+      endLine: endLineAfter(source, start + m[0].length, ENDMACRO_RE, startLine),
+      signature: `macro ${name}(${args})`
+    });
+  }
+  for (const m of source.matchAll(BLOCK_RE)) {
+    const name = m[1];
+    if (!name) continue;
+    const start = m.index ?? 0;
+    const startLine = lineAt(source, start);
+    symbols.push({
+      name,
+      kind: "component",
+      startLine,
+      endLine: endLineAfter(source, start + m[0].length, ENDBLOCK_RE, startLine),
+      signature: `block ${name}`
+    });
+  }
+  for (const m of source.matchAll(IMPORT_RE)) {
+    const spec = m[1];
+    if (spec) imports.push(spec);
+  }
+  return { file: f, source, symbols, imports: Array.from(new Set(imports)), calls: [] };
+}
+
 // src/scanner/parsers/java.ts
 var QUERY6 = `
 (class_declaration name: (identifier) @class.name) @class
@@ -3012,6 +3063,9 @@ async function parseFile(f) {
       return parseSvelte(f, source);
     case ".vue":
       return parseVue(f, source);
+    case ".html":
+    case ".hubl":
+      return parseHubL(f, source);
     case ".go":
       return parseGo(f, source);
     case ".rs":