@hyperfixi/patterns-reference 3.1.1 → 3.3.0

package/dist/index.js

@@ -1,5 +1,6 @@
 'use strict';
 
+var semantic = require('@lokascript/semantic');
 var Database = require('better-sqlite3');
 var fs = require('fs');
 var url = require('url');
@@ -10,9 +11,84 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var Database__default = /*#__PURE__*/_interopDefault(Database);
 
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
 // ../../node_modules/tsup/assets/cjs_shims.js
-var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
-var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+var getImportMetaUrl, importMetaUrl;
+var init_cjs_shims = __esm({
+  "../../node_modules/tsup/assets/cjs_shims.js"() {
+    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+    importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+  }
+});
+
+// src/sync/markup-attributes.ts
+function findHyperscriptAttributes(markup) {
+  const spans = [];
+  ATTRIBUTE.lastIndex = 0;
+  let match;
+  while ((match = ATTRIBUTE.exec(markup)) !== null) {
+    const body = match[2] ?? match[3];
+    const start = match.index + match[0].length - body.length - 1;
+    spans.push({ start, end: start + body.length, body });
+  }
+  return spans;
+}
+function isMarkupRow(code) {
+  return /^\s*<[a-zA-Z!]/.test(code);
+}
+function hyperscriptBodies(code) {
+  if (!isMarkupRow(code)) return [code];
+  const bodies = findHyperscriptAttributes(code).map((span) => span.body);
+  for (const match of code.matchAll(HX_LIVE_ATTRIBUTE)) bodies.push(match[2] ?? match[3] ?? "");
+  return bodies.filter((body) => body.trim().length > 0);
+}
+var ATTRIBUTE, HX_LIVE_ATTRIBUTE;
+var init_markup_attributes = __esm({
+  "src/sync/markup-attributes.ts"() {
+    init_cjs_shims();
+    ATTRIBUTE = /(^|[\s"'])_\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+    HX_LIVE_ATTRIBUTE = /(^|[\s"'])hx-live\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+  }
+});
+
+// src/sync/verify-parses.ts
+var verify_parses_exports = {};
+__export(verify_parses_exports, {
+  verifyParses: () => verifyParses
+});
+function verifyParses(code, language, translatable = true) {
+  const bodies = hyperscriptBodies(code);
+  if (bodies.length === 0) return false;
+  const parseLanguage = translatable ? language : "en";
+  return bodies.every((body) => {
+    try {
+      return semantic.canParse(body, parseLanguage);
+    } catch {
+      return false;
+    }
+  });
+}
+var init_verify_parses = __esm({
+  "src/sync/verify-parses.ts"() {
+    init_cjs_shims();
+    init_markup_attributes();
+  }
+});
+
+// src/index.ts
+init_cjs_shims();
+
+// src/database/connection.ts
+init_cjs_shims();
 var __filename2 = url.fileURLToPath(importMetaUrl);
 var __dirname$1 = path.dirname(__filename2);
 var DEFAULT_DB_PATH = process.env.LSP_DB_PATH || process.env.HYPERSCRIPT_LSP_DB || path.join(__dirname$1, "../data/patterns.db");
@@ -20,6 +96,7 @@ var dbInstance = null;
 var currentDbPath = null;
 var openFileId = null;
 var lastIdentityCheckAt = 0;
+var openReadonly = false;
 var IDENTITY_TTL_MS = 1e3;
 function fileIdentity(path) {
   try {
@@ -34,7 +111,9 @@ function getDefaultDbPath() {
 }
 function getDatabase(options = {}) {
   const dbPath = options.dbPath ?? DEFAULT_DB_PATH;
-  if (dbInstance !== null && currentDbPath === dbPath) {
+  const readonly = options.readonly ?? false;
+  const canServe = !openReadonly || readonly;
+  if (dbInstance !== null && currentDbPath === dbPath && canServe) {
     const now = Date.now();
     if (now - lastIdentityCheckAt < IDENTITY_TTL_MS) {
       return dbInstance;
@@ -50,9 +129,8 @@ function getDatabase(options = {}) {
   if (dbInstance !== null) {
     dbInstance.close();
   }
-  dbInstance = new Database__default.default(dbPath, {
-    readonly: options.readonly ?? false
-  });
+  dbInstance = new Database__default.default(dbPath, { readonly });
+  openReadonly = readonly;
   dbInstance.pragma("foreign_keys = ON");
   currentDbPath = dbPath;
   openFileId = fileIdentity(dbPath);
@@ -66,6 +144,7 @@ function closeDatabase() {
     currentDbPath = null;
     openFileId = null;
     lastIdentityCheckAt = 0;
+    openReadonly = false;
   }
 }
 function resetConnection() {
@@ -73,6 +152,7 @@ function resetConnection() {
   currentDbPath = null;
   openFileId = null;
   lastIdentityCheckAt = 0;
+  openReadonly = false;
 }
 function isConnected() {
   return dbInstance !== null;
@@ -81,12 +161,27 @@ function getCurrentDbPath() {
   return currentDbPath;
 }
 
+// src/api/patterns.ts
+init_cjs_shims();
+init_markup_attributes();
+
+// src/api/engine-filter.ts
+init_cjs_shims();
+function runsOn(column, engine) {
+  if (engine === null) return { sql: `${column} IS NULL`, params: [] };
+  if (engine === "both") return { sql: `${column} = 'both'`, params: [] };
+  return { sql: `${column} IN ('both', ?)`, params: [engine] };
+}
+function exampleCondition(column, engine) {
+  return engine === void 0 ? { sql: `${column} IS NOT NULL`, params: [] } : runsOn(column, engine);
+}
+
 // src/api/patterns.ts
 async function getPatternById(id, options) {
   const db = getDatabase({ ...options, readonly: true });
   const row = db.prepare(
     `
-    SELECT id, title, raw_code, description, feature, engine, created_at
+    SELECT id, title, raw_code, description, feature, engine, translatable, created_at
     FROM code_examples
     WHERE id = ?
   `
@@ -97,7 +192,7 @@ async function getPatternsByCategory(category, options) {
   const db = getDatabase({ ...options, readonly: true });
   const rows = db.prepare(
     `
-    SELECT id, title, raw_code, description, feature, engine, created_at
+    SELECT id, title, raw_code, description, feature, engine, translatable, created_at
     FROM code_examples
     WHERE feature = ?
     ORDER BY title
@@ -109,7 +204,7 @@ async function getPatternsByCommand(command, options) {
   const db = getDatabase({ ...options, readonly: true });
   const rows = db.prepare(
     `
-    SELECT id, title, raw_code, description, feature, engine, created_at
+    SELECT id, title, raw_code, description, feature, engine, translatable, created_at
     FROM code_examples
     WHERE raw_code LIKE ?
     ORDER BY title
@@ -117,32 +212,45 @@ async function getPatternsByCommand(command, options) {
   ).all(`%${command}%`);
   return rows.filter((row) => new RegExp(`\\b${command}\\b`, "i").test(row.raw_code)).map(mapRowToPattern);
 }
-async function searchPatterns(query, searchOptions = {}, connOptions) {
-  const db = getDatabase({ ...connOptions, readonly: true });
-  const { limit = 50, offset = 0 } = searchOptions;
+function engineFilter(searchOptions) {
+  return searchOptions.engine === void 0 ? { sql: "1 = 1", params: [] } : runsOn("engine", searchOptions.engine);
+}
+function usableIn(db, language) {
   const rows = db.prepare(
-    `
-    SELECT id, title, raw_code, description, feature, engine, created_at
-    FROM code_examples
-    WHERE title LIKE ? OR raw_code LIKE ? OR description LIKE ?
-    ORDER BY title
-    LIMIT ? OFFSET ?
-  `
-  ).all(`%${query}%`, `%${query}%`, `%${query}%`, limit, offset);
-  return rows.map(mapRowToPattern);
+    "SELECT code_example_id AS id FROM pattern_translations WHERE language = ? AND verified_parses = 1"
+  ).all(language);
+  const verified = new Set(rows.map((row) => row.id));
+  return (pattern) => verified.has(pattern.id) || hyperscriptBodies(pattern.rawCode).length === 0;
 }
-async function getAllPatterns(searchOptions = {}, connOptions) {
+function queryPatterns(searchOptions, defaultLimit, connOptions, match = { sql: "1 = 1", params: [] }) {
   const db = getDatabase({ ...connOptions, readonly: true });
-  const { limit = 1e3, offset = 0 } = searchOptions;
+  const { limit = defaultLimit, offset = 0, category, difficulty, language } = searchOptions;
+  const runs = engineFilter(searchOptions);
+  const inCategory = category === void 0 ? { sql: "1 = 1", params: [] } : { sql: "feature = ?", params: [category] };
   const rows = db.prepare(
     `
-    SELECT id, title, raw_code, description, feature, engine, created_at
+    SELECT id, title, raw_code, description, feature, engine, translatable, created_at
     FROM code_examples
+    WHERE (${match.sql}) AND ${runs.sql} AND ${inCategory.sql}
     ORDER BY title
-    LIMIT ? OFFSET ?
   `
-  ).all(limit, offset);
-  return rows.map(mapRowToPattern);
+  ).all(...match.params, ...runs.params, ...inCategory.params);
+  const inLanguage = language === void 0 ? null : usableIn(db, language);
+  return rows.map(mapRowToPattern).filter((pattern) => difficulty === void 0 || pattern.difficulty === difficulty).filter((pattern) => inLanguage === null || inLanguage(pattern)).slice(offset, offset + limit);
+}
+async function searchPatterns(query, searchOptions = {}, connOptions) {
+  const like = `%${query}%`;
+  const inTranslation = searchOptions.language === void 0 ? { sql: "", params: [] } : {
+    sql: " OR id IN (SELECT code_example_id FROM pattern_translations WHERE language = ? AND hyperscript LIKE ?)",
+    params: [searchOptions.language, like]
+  };
+  return queryPatterns(searchOptions, 50, connOptions, {
+    sql: `title LIKE ? OR raw_code LIKE ? OR description LIKE ?${inTranslation.sql}`,
+    params: [like, like, like, ...inTranslation.params]
+  });
+}
+async function getAllPatterns(searchOptions = {}, connOptions) {
+  return queryPatterns(searchOptions, 1e3, connOptions);
 }
 async function getPatternStats(connOptions) {
   const db = getDatabase({ ...connOptions, readonly: true });
@@ -201,6 +309,7 @@ function mapRowToPattern(row) {
     tags: extractTags(row.raw_code),
     difficulty: inferDifficulty(row.raw_code),
     engine: row.engine || null,
+    translatable: row.translatable !== 0,
     createdAt: new Date(row.created_at)
   };
 }
@@ -225,6 +334,7 @@ function inferDifficulty(code) {
 }
 
 // src/api/behavior-loader.ts
+init_cjs_shims();
 async function loadBehaviors(runtime, options) {
   const patterns = await getBehaviorPatterns(options?.connectionOptions);
   const filtered = options?.names ? patterns.filter((p) => options.names.some((name) => p.rawCode.includes(`behavior ${name}(`))) : patterns;
@@ -253,6 +363,7 @@ async function loadBehaviors(runtime, options) {
 }
 
 // src/api/translations.ts
+init_cjs_shims();
 async function getTranslation(patternId, language, options) {
   const db = getDatabase({ ...options, readonly: true });
   const row = db.prepare(
@@ -314,32 +425,35 @@ async function verifyTranslation(translation, options) {
   let parseSuccess = false;
   let errorMessage = null;
   let confidence = translation.confidence;
+  const db = getDatabase(options);
+  const example = db.prepare("SELECT translatable FROM code_examples WHERE id = ?").get(translation.codeExampleId);
   try {
-    const { canParse, parse } = await import('@lokascript/semantic');
-    if (canParse(translation.hyperscript, translation.language)) {
-      parse(translation.hyperscript, translation.language);
-      parseSuccess = true;
-    } else {
-      errorMessage = "canParse returned false";
-    }
+    const { verifyParses: verifyParses2 } = await Promise.resolve().then(() => (init_verify_parses(), verify_parses_exports));
+    parseSuccess = verifyParses2(
+      translation.hyperscript,
+      translation.language,
+      example?.translatable !== 0
+    );
+    if (!parseSuccess) errorMessage = "the semantic parser rejected it (or it has no hyperscript)";
   } catch (e) {
     errorMessage = e.message;
   }
-  const db = getDatabase(options);
-  db.prepare(
+  db.transaction(() => {
+    db.prepare(
+      `
+      UPDATE pattern_translations
+      SET verified_parses = ?, updated_at = datetime('now')
+      WHERE id = ?
     `
-    UPDATE pattern_translations
-    SET verified_parses = ?, updated_at = datetime('now')
-    WHERE id = ?
-  `
-  ).run(parseSuccess ? 1 : 0, translation.id);
-  db.prepare(
+    ).run(parseSuccess ? 1 : 0, translation.id);
+    db.prepare(
+      `
+      INSERT INTO pattern_tests
+        (code_example_id, language, test_type, success, error_message, test_date)
+      VALUES (?, ?, 'parse', ?, ?, datetime('now'))
     `
-    INSERT INTO pattern_tests
-      (code_example_id, language, test_date, parse_success, error_message)
-    VALUES (?, ?, datetime('now'), ?, ?)
-  `
-  ).run(translation.codeExampleId, translation.language, parseSuccess ? 1 : 0, errorMessage);
+    ).run(translation.codeExampleId, translation.language, parseSuccess ? 1 : 0, errorMessage);
+  })();
   return {
     translation,
     parseSuccess,
@@ -409,74 +523,70 @@ function getWordOrder(language) {
 }
 
 // src/api/llm.ts
+init_cjs_shims();
+var EXAMPLES_FROM = `
+  SELECT le.*, ce.engine AS engine
+  FROM llm_examples le
+  JOIN code_examples ce ON ce.id = le.code_example_id`;
 async function getLLMExamples(prompt, language = "en", limit = 5, options) {
   const db = getDatabase({ ...options, readonly: true });
+  const runs = exampleCondition("ce.engine", options?.engine);
   const keywords = extractKeywords(prompt);
   if (keywords.length === 0) {
     const rows2 = db.prepare(
-      `
-      SELECT * FROM llm_examples
-      WHERE language = ?
-      ORDER BY quality_score DESC, usage_count DESC
+      `${EXAMPLES_FROM}
+      WHERE le.language = ? AND ${runs.sql}
+      ORDER BY le.quality_score DESC, le.usage_count DESC
       LIMIT ?
     `
-    ).all(language, limit);
-    trackUsage(
-      db,
-      rows2.map((r) => r.id)
-    );
+    ).all(language, ...runs.params, limit);
     return rows2.map(mapRowToLLMExample);
   }
-  const likeClauses = keywords.map(() => "(prompt LIKE ? OR completion LIKE ?)").join(" OR ");
+  const likeClauses = keywords.map(() => "(le.prompt LIKE ? OR le.completion LIKE ?)").join(" OR ");
   const params = keywords.flatMap((k) => [`%${k}%`, `%${k}%`]);
   const rows = db.prepare(
-    `
-    SELECT * FROM llm_examples
-    WHERE language = ? AND (${likeClauses})
-    ORDER BY quality_score DESC
+    `${EXAMPLES_FROM}
+    WHERE le.language = ? AND ${runs.sql} AND (${likeClauses})
+    ORDER BY le.quality_score DESC
     LIMIT ?
   `
-  ).all(language, ...params, limit);
-  trackUsage(
-    db,
-    rows.map((r) => r.id)
-  );
+  ).all(language, ...runs.params, ...params, limit);
   return rows.map(mapRowToLLMExample);
 }
 async function getExamplesByCommand(command, language = "en", limit = 5, options) {
   const db = getDatabase({ ...options, readonly: true });
+  const runs = exampleCondition("ce.engine", options?.engine);
   const rows = db.prepare(
-    `
-    SELECT * FROM llm_examples
-    WHERE language = ? AND completion LIKE ?
-    ORDER BY quality_score DESC
+    `${EXAMPLES_FROM}
+    WHERE le.language = ? AND ${runs.sql} AND le.completion LIKE ?
+    ORDER BY le.quality_score DESC
     LIMIT ?
   `
-  ).all(language, `%${command}%`, limit);
+  ).all(language, ...runs.params, `%${command}%`, limit);
   return rows.map(mapRowToLLMExample);
 }
 async function getHighQualityExamples(language = "en", minQuality = 0.8, limit = 10, options) {
   const db = getDatabase({ ...options, readonly: true });
+  const runs = exampleCondition("ce.engine", options?.engine);
   const rows = db.prepare(
-    `
-    SELECT * FROM llm_examples
-    WHERE language = ? AND quality_score >= ?
-    ORDER BY quality_score DESC, usage_count DESC
+    `${EXAMPLES_FROM}
+    WHERE le.language = ? AND ${runs.sql} AND le.quality_score >= ?
+    ORDER BY le.quality_score DESC, le.usage_count DESC
     LIMIT ?
   `
-  ).all(language, minQuality, limit);
+  ).all(language, ...runs.params, minQuality, limit);
   return rows.map(mapRowToLLMExample);
 }
 async function getMostUsedExamples(language = "en", limit = 10, options) {
   const db = getDatabase({ ...options, readonly: true });
+  const runs = exampleCondition("ce.engine", options?.engine);
   const rows = db.prepare(
-    `
-    SELECT * FROM llm_examples
-    WHERE language = ?
-    ORDER BY usage_count DESC, quality_score DESC
+    `${EXAMPLES_FROM}
+    WHERE le.language = ? AND ${runs.sql}
+    ORDER BY le.usage_count DESC, le.quality_score DESC
     LIMIT ?
   `
-  ).all(language, limit);
+  ).all(language, ...runs.params, limit);
   return rows.map(mapRowToLLMExample);
 }
 async function buildFewShotContext(prompt, language = "en", numExamples = 3, options) {
@@ -574,18 +684,6 @@ function extractKeywords(prompt) {
   ]);
   return prompt.toLowerCase().split(/\W+/).filter((word) => word.length > 2 && !stopWords.has(word));
 }
-function trackUsage(db, ids) {
-  if (ids.length === 0) return;
-  try {
-    const stmt = db.prepare(`
-      UPDATE llm_examples SET usage_count = usage_count + 1 WHERE id = ?
-    `);
-    for (const id of ids) {
-      stmt.run(id);
-    }
-  } catch {
-  }
-}
 function mapRowToLLMExample(row) {
   return {
     id: row.id,
@@ -595,11 +693,13 @@ function mapRowToLLMExample(row) {
     completion: row.completion,
     qualityScore: row.quality_score,
     usageCount: row.usage_count,
-    createdAt: new Date(row.created_at)
+    createdAt: new Date(row.created_at),
+    engine: row.engine ?? null
   };
 }
 
 // src/api/language-docs.ts
+init_cjs_shims();
 function mapCommand(row) {
   return {
     id: row.id,
@@ -845,6 +945,12 @@ async function getLanguageDocsStats(options) {
     expressionOperators: getCount("expression_operators")
   };
 }
+
+// src/sync/index.ts
+init_cjs_shims();
+
+// src/sync/db-stamp.ts
+init_cjs_shims();
 function repoRootFromDbPath(dbPath) {
   return path.resolve(path.dirname(dbPath), "..", "..", "..");
 }
@@ -870,7 +976,10 @@ function dbInputFiles(dbPath) {
   for (const f of [
     path.join(pr, "scripts", "init-db.ts"),
     path.join(pr, "scripts", "sync-translations.ts"),
-    path.join(pr, "src", "sync", "span-mask.ts"),
+    // Decides which markup `_` bodies are translated (and which stay English).
+    path.join(pr, "src", "sync", "markup-attributes.ts"),
+    // Writes every row's `verified_parses`.
+    path.join(pr, "src", "sync", "verify-parses.ts"),
     // Committed engine-verification results are seeded into the engine
     // column by init-db.ts, so they are DB input too.
     path.join(pr, "data", "engine-verification.json")
@@ -930,6 +1039,12 @@ async function seedLLMExamples(_dryRun = false) {
 }
 
 // src/adapters/llm-adapter.ts
+init_cjs_shims();
+var RECORDS_FROM = `
+  SELECT le.id, le.prompt, le.completion, le.language, le.quality_score as qualityScore,
+         ce.engine AS engine
+  FROM llm_examples le
+  JOIN code_examples ce ON ce.id = le.code_example_id`;
 var syncDatabaseAvailable = true;
 function isDatabaseAvailable() {
   try {
@@ -940,42 +1055,31 @@ function isDatabaseAvailable() {
     return false;
   }
 }
-function findRelevantExamples(prompt, language = "en", limit = 5) {
+function findRelevantExamples(prompt, language = "en", limit = 5, engine) {
   if (!syncDatabaseAvailable) return [];
   try {
     const db = getDatabase({ readonly: true });
+    const runs = exampleCondition("ce.engine", engine);
     const keywords = extractKeywords2(prompt);
     if (keywords.length === 0) {
       const rows2 = db.prepare(
-        `
-        SELECT id, prompt, completion, language, quality_score as qualityScore
-        FROM llm_examples
-        WHERE language = ?
-        ORDER BY quality_score DESC, usage_count DESC
+        `${RECORDS_FROM}
+        WHERE le.language = ? AND ${runs.sql}
+        ORDER BY le.quality_score DESC, le.usage_count DESC
         LIMIT ?
       `
-      ).all(language, limit);
-      trackUsageSync(
-        db,
-        rows2.map((r) => r.id)
-      );
+      ).all(language, ...runs.params, limit);
       return rows2;
     }
-    const likeClauses = keywords.map(() => "(prompt LIKE ? OR completion LIKE ?)").join(" OR ");
+    const likeClauses = keywords.map(() => "(le.prompt LIKE ? OR le.completion LIKE ?)").join(" OR ");
     const params = keywords.flatMap((k) => [`%${k}%`, `%${k}%`]);
     const rows = db.prepare(
-      `
-      SELECT id, prompt, completion, language, quality_score as qualityScore
-      FROM llm_examples
-      WHERE language = ? AND (${likeClauses})
-      ORDER BY quality_score DESC
+      `${RECORDS_FROM}
+      WHERE le.language = ? AND ${runs.sql} AND (${likeClauses})
+      ORDER BY le.quality_score DESC
       LIMIT ?
     `
-    ).all(language, ...params, limit);
-    trackUsageSync(
-      db,
-      rows.map((r) => r.id)
-    );
+    ).all(language, ...runs.params, ...params, limit);
     return rows;
   } catch (error) {
     console.warn(
@@ -986,19 +1090,18 @@ function findRelevantExamples(prompt, language = "en", limit = 5) {
     return [];
   }
 }
-function findExamplesByCommand(command, language = "en", limit = 5) {
+function findExamplesByCommand(command, language = "en", limit = 5, engine) {
   if (!syncDatabaseAvailable) return [];
   try {
     const db = getDatabase({ readonly: true });
+    const runs = exampleCondition("ce.engine", engine);
     const rows = db.prepare(
-      `
-      SELECT id, prompt, completion, language, quality_score as qualityScore
-      FROM llm_examples
-      WHERE language = ? AND completion LIKE ?
-      ORDER BY quality_score DESC
+      `${RECORDS_FROM}
+      WHERE le.language = ? AND ${runs.sql} AND le.completion LIKE ?
+      ORDER BY le.quality_score DESC
       LIMIT ?
     `
-    ).all(language, `%${command}%`, limit);
+    ).all(language, ...runs.params, `%${command}%`, limit);
     return rows;
   } catch (error) {
     console.warn(
@@ -1008,8 +1111,8 @@ function findExamplesByCommand(command, language = "en", limit = 5) {
     return [];
   }
 }
-function buildFewShotContextSync(prompt, language = "en", numExamples = 3) {
-  const examples = findRelevantExamples(prompt, language, numExamples);
+function buildFewShotContextSync(prompt, language = "en", numExamples = 3, engine) {
+  const examples = findRelevantExamples(prompt, language, numExamples, engine);
   if (examples.length === 0) {
     return "";
   }
@@ -1112,11 +1215,12 @@ function createLLMAdapter(options) {
     getLLMExampleStats,
     isDatabaseAvailable,
     // Async methods (preferred for new code)
-    getLLMExamples: (prompt, language, limit) => getLLMExamples(prompt, language, limit, options),
-    getExamplesByCommand: (command, language, limit) => getExamplesByCommand(command, language, limit, options),
-    getHighQualityExamples: (language, minQuality, limit) => getHighQualityExamples(language, minQuality, limit, options),
-    getMostUsedExamples: (language, limit) => getMostUsedExamples(language, limit, options),
-    buildFewShotContext: (prompt, language, numExamples) => buildFewShotContext(prompt, language, numExamples, options),
+    getLLMExamples: (prompt, language, limit, engine) => getLLMExamples(prompt, language, limit, { ...options, engine }),
+    getExamplesByCommand: (command, language, limit, engine) => getExamplesByCommand(command, language, limit, { ...options, engine }),
+    getHighQualityExamples: (language, minQuality, limit, engine) => getHighQualityExamples(language, minQuality, limit, { ...options, engine }),
+    /** @deprecated See getMostUsedExamples. */
+    getMostUsedExamples: (language, limit, engine) => getMostUsedExamples(language, limit, { ...options, engine }),
+    buildFewShotContext: (prompt, language, numExamples, engine) => buildFewShotContext(prompt, language, numExamples, { ...options, engine }),
     getLLMStats: () => getLLMStats(options),
     // Cleanup
     close: closeDatabase
@@ -1124,6 +1228,7 @@ function createLLMAdapter(options) {
 }
 
 // src/registry/patterns-provider.ts
+init_cjs_shims();
 var DatabasePatternsProvider = class {
   id = "patterns-reference-db";
   name = "Patterns Reference Database";
@@ -1173,7 +1278,9 @@ var DatabasePatternsProvider = class {
         command: p.primaryCommand,
         language: language || "en",
         confidence: 1,
-        verified: true,
+        // The English source pattern: "verified" = some engine runs it
+        // (code_examples.engine, mechanically checked) — not a constant.
+        verified: p.engine !== null,
         title: p.title,
         category: p.category || void 0
       }));
@@ -1275,6 +1382,7 @@ function resetDefaultProvider() {
 }
 
 // src/semantic-bridge.ts
+init_cjs_shims();
 var bridgeInitialized = false;
 var bridgeProvider = null;
 async function initializeSemanticIntegration(options) {
@@ -1334,7 +1442,7 @@ async function uninitializeSemanticIntegration() {
   bridgeProvider = null;
   bridgeInitialized = false;
 }
-async function queryPatterns(language) {
+async function queryPatterns2(language) {
   const provider = bridgeProvider || createPatternsProvider();
   return provider.getPatternsForLanguage(language);
 }
@@ -1348,15 +1456,17 @@ async function getSupportedLanguages() {
 }
 
 // src/html-snippets.ts
+init_cjs_shims();
 var HYPERFIXI_ONLY_ATTR_PREFIXES = ["hx-live", "sse-", "ws-"];
 function extractHyperscriptFromMarkup(doc, markup) {
   const container = doc.createElement("div");
   try {
     container.innerHTML = markup;
   } catch {
-    return { snippets: [], hyperfixiOnly: false };
+    return { snippets: [], hyperfixiOnly: false, componentTags: [] };
   }
   const snippets = [];
+  const componentTags = [];
   let hyperfixiOnly = false;
   for (const el of Array.from(container.querySelectorAll("*"))) {
     for (const attr of Array.from(el.attributes)) {
@@ -1370,19 +1480,24 @@ function extractHyperscriptFromMarkup(doc, markup) {
         hyperfixiOnly = true;
       }
     }
-    if (el.tagName === "SCRIPT") {
-      const type = el.getAttribute("type");
-      if (type === "text/hyperscript-template") {
-        hyperfixiOnly = true;
-      } else if (type === "text/hyperscript" && el.textContent?.trim()) {
-        snippets.push(el.textContent);
-      }
+    const tag = el.getAttribute("component");
+    const isScriptTemplate = el.tagName === "SCRIPT" && el.getAttribute("type") === "text/hyperscript-template";
+    if (tag && (isScriptTemplate || el.tagName === "TEMPLATE")) {
+      componentTags.push(tag);
+      const body = isScriptTemplate ? el.textContent ?? "" : el.innerHTML ?? "";
+      const inner = extractHyperscriptFromMarkup(doc, body);
+      snippets.push(...inner.snippets);
+      componentTags.push(...inner.componentTags);
+      hyperfixiOnly ||= inner.hyperfixiOnly;
+    } else if (el.tagName === "SCRIPT" && el.getAttribute("type") === "text/hyperscript" && el.textContent?.trim()) {
+      snippets.push(el.textContent);
     }
   }
-  return { snippets, hyperfixiOnly };
+  return { snippets, hyperfixiOnly, componentTags };
 }
 
 // src/index.ts
+init_markup_attributes();
 function createPatternsReference(options) {
   getDatabase(options);
   return {
@@ -1396,7 +1511,7 @@ function createPatternsReference(options) {
     getAllTranslations: (patternId) => getAllTranslations(patternId, options),
     verifyTranslation: (translation) => verifyTranslation(translation, options),
     // LLM
-    getLLMExamples: (prompt, language, limit) => getLLMExamples(prompt, language, limit, options),
+    getLLMExamples: (prompt, language, limit, engine) => getLLMExamples(prompt, language, limit, { ...options, engine }),
     // Stats
     getStats: () => getPatternStats(options),
     // Connection
@@ -1420,6 +1535,7 @@ exports.dbStampPath = dbStampPath;
 exports.discoverPatterns = discoverPatterns;
 exports.extractHyperscriptFromMarkup = extractHyperscriptFromMarkup;
 exports.findExamplesByCommand = findExamplesByCommand;
+exports.findHyperscriptAttributes = findHyperscriptAttributes;
 exports.findRelevantExamples = findRelevantExamples;
 exports.getAllCommands = getAllCommands;
 exports.getAllExpressions = getAllExpressions;
@@ -1461,9 +1577,10 @@ exports.getWordOrder = getWordOrder;
 exports.initializeSemanticIntegration = initializeSemanticIntegration;
 exports.isConnected = isConnected;
 exports.isDatabaseAvailable = isDatabaseAvailable;
+exports.isMarkupRow = isMarkupRow;
 exports.isSemanticIntegrationInitialized = isSemanticIntegrationInitialized;
 exports.loadBehaviors = loadBehaviors;
-exports.queryPatterns = queryPatterns;
+exports.queryPatterns = queryPatterns2;
 exports.queryPatternsForCommand = queryPatternsForCommand;
 exports.resetConnection = resetConnection;
 exports.resetDefaultProvider = resetDefaultProvider;