@hyperfixi/patterns-reference 2.9.1 → 2.9.3

package/data/engine-verification.json

@@ -1,11 +1,11 @@
 {
   "meta": {
     "bar": {
-      "lokascript": "compileSync(code).ok via @hyperfixi/core (same call as the browser _= path), with @hyperfixi/reactivity and @hyperfixi/realtime installed (both ship pre-installed in hyperfixi.js), plus a jsdom top-level install smoke (no error within 500ms settle window)",
+      "lokascript": "compileSync(code).ok with zero recovered errors via @hyperfixi/core (same call as the browser _= path), with @hyperfixi/reactivity and @hyperfixi/realtime installed (both ship pre-installed in hyperfixi.js), plus a jsdom top-level install smoke (no error within 500ms settle window)",
       "hyperscript": "upstream _hyperscript parse with zero recovered errors (extensions loaded: socket, worker, eventsource); parse-level only",
       "html": "HTML-markup patterns: each _= / script-tag snippet verified individually; hx-live/sse-*/ws-* attributes are hyperfixi-only and block the upstream claim"
     },
-    "lokascriptVersion": "2.6.0",
+    "lokascriptVersion": "2.9.1",
     "hyperscriptVersion": "0.9.93"
   },
   "engines": {
@@ -129,7 +129,7 @@
     "send-event-to-form": "both",
     "send-with-detail": "both",
     "set-attribute": "both",
-    "set-color-variable": "lokascript",
+    "set-color-variable": "both",
     "set-inner-html-possessive-dot": "both",
     "set-opacity": "both",
     "set-style": "both",
@@ -677,8 +677,7 @@
     },
     "set-color-variable": {
       "lokascript": true,
-      "hyperscript": false,
-      "hyperscriptError": "Unexpected value: *"
+      "hyperscript": true
     },
     "set-inner-html-possessive-dot": {
       "lokascript": true,

package/dist/index.d.mts

@@ -419,6 +419,77 @@ declare function queryPatternsForCommand(command: string, language?: string): Pr
  */
 declare function getSupportedLanguages(): Promise<string[]>;
 
+/**
+ * Extract hyperscript sources out of HTML markup, via the DOM.
+ *
+ * Shared by the two harnesses that need it: `scripts/verify-engines.ts` (which
+ * classifies each corpus pattern's `engine` column) and the testing-framework's
+ * shipped-sources validity gate.
+ *
+ * **Why the DOM and not a regex.** A raw-text regex over `.html` cannot tell a
+ * live attribute from a code sample: a `<pre>`/`<code>`/`.code` block showing
+ * escaped source (`&lt;button _="…"&gt;`) matches just as well as the real
+ * thing. That is not hypothetical — it is how an earlier sweep "found" two
+ * malformed sources in `examples/events-and-dom/send-events.html` that were
+ * only ever display text. Parsing the markup makes the distinction structural:
+ * escaped text decodes into a text node, never into an attribute, so it cannot
+ * be reached by an attribute walk.
+ *
+ * Do not reuse `@hyperfixi/vite-plugin`'s scanner for this purpose — it is
+ * deliberately a regex (it scans partial source files that need not be
+ * well-formed HTML) and has exactly that blind spot.
+ */
+/**
+ * The DOM surface this module needs, declared structurally.
+ *
+ * This package compiles with `lib: ["ES2022"]` (it is Node-oriented — a SQLite
+ * pattern database), so the ambient `Document`/`Element` types are not in
+ * scope. Declaring the three members used here keeps the extractor usable from
+ * a jsdom window, a browser document, or a happy-dom one without dragging the
+ * whole DOM lib into the package's build.
+ */
+interface MinimalAttr {
+    name: string;
+    value: string;
+}
+interface MinimalElement {
+    tagName: string;
+    attributes: ArrayLike<MinimalAttr>;
+    textContent: string | null;
+    getAttribute(name: string): string | null;
+}
+interface MinimalContainer extends MinimalElement {
+    innerHTML: string;
+    querySelectorAll(selectors: string): ArrayLike<MinimalElement>;
+}
+interface MinimalDocument {
+    createElement(tagName: string): MinimalContainer;
+}
+interface MarkupSnippets {
+    /** Every hyperscript source found, in document order. */
+    snippets: string[];
+    /**
+     * The markup uses at least one attribute upstream `_hyperscript` has no
+     * concept of, so it cannot be claimed as upstream-compatible regardless of
+     * how its snippets parse.
+     */
+    hyperfixiOnly: boolean;
+}
+/**
+ * Pull every hyperscript source out of `markup`.
+ *
+ * Collects `_="…"` attributes, `hx-live="…"` values (which ARE hyperscript —
+ * the htmx-compat layer compiles them), and `<script type="text/hyperscript">`
+ * bodies. The other hyperfixi-only attribute values (`sse-connect` URLs,
+ * `sse-swap` event names, `ws-connect` URLs) are not hyperscript and carry no
+ * snippet to verify, but they do set `hyperfixiOnly`.
+ *
+ * `doc` is any DOM `Document` — a jsdom window's, or the ambient one in a
+ * browser/jsdom test environment. Markup that fails to parse yields no
+ * snippets rather than throwing.
+ */
+declare function extractHyperscriptFromMarkup(doc: MinimalDocument, markup: string): MarkupSnippets;
+
 /**
  * @hyperfixi/patterns-reference
  *
@@ -456,9 +527,10 @@ declare function getSupportedLanguages(): Promise<string[]>;
  * @returns PatternsReference instance
  */
 declare function createPatternsReference(options?: ConnectionOptions): PatternsReference;
+
 /**
  * Version of the package.
  */
 declare const VERSION = "0.1.0";
 
-export { type BehaviorRuntime, Command, ConnectionOptions, DatabasePatternsProvider, Expression, Feature, type IntegrationResult, Keyword, LLMExample, type LLMExampleRecord, LanguageDocsStats, LanguageElement, LanguageElementType, type LoadBehaviorsOptions, type LoadBehaviorsResult, type PatternEntry, PatternsReference, type PatternsSource, type SemanticIntegrationOptions, SpecialSymbol, VERSION, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllSpecialSymbols, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, getDefaultDbPath, getDefaultProvider, getExpressionByName, getExpressionsByCategory, getFeatureByName, getKeywordByName, getLLMExampleStats, getLanguageDocsStats, getSpecialSymbolByName, getSupportedLanguages, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, loadBehaviors, queryPatterns, queryPatternsForCommand, resetConnection, resetDefaultProvider, searchCommands, searchLanguageElements, trackExampleUsage, uninitializeSemanticIntegration };
+export { type BehaviorRuntime, Command, ConnectionOptions, DatabasePatternsProvider, Expression, Feature, type IntegrationResult, Keyword, LLMExample, type LLMExampleRecord, LanguageDocsStats, LanguageElement, LanguageElementType, type LoadBehaviorsOptions, type LoadBehaviorsResult, type MarkupSnippets, type PatternEntry, PatternsReference, type PatternsSource, type SemanticIntegrationOptions, SpecialSymbol, VERSION, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, extractHyperscriptFromMarkup, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllSpecialSymbols, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, getDefaultDbPath, getDefaultProvider, getExpressionByName, getExpressionsByCategory, getFeatureByName, getKeywordByName, getLLMExampleStats, getLanguageDocsStats, getSpecialSymbolByName, getSupportedLanguages, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, loadBehaviors, queryPatterns, queryPatternsForCommand, resetConnection, resetDefaultProvider, searchCommands, searchLanguageElements, trackExampleUsage, uninitializeSemanticIntegration };

package/dist/index.d.ts

@@ -419,6 +419,77 @@ declare function queryPatternsForCommand(command: string, language?: string): Pr
  */
 declare function getSupportedLanguages(): Promise<string[]>;
 
+/**
+ * Extract hyperscript sources out of HTML markup, via the DOM.
+ *
+ * Shared by the two harnesses that need it: `scripts/verify-engines.ts` (which
+ * classifies each corpus pattern's `engine` column) and the testing-framework's
+ * shipped-sources validity gate.
+ *
+ * **Why the DOM and not a regex.** A raw-text regex over `.html` cannot tell a
+ * live attribute from a code sample: a `<pre>`/`<code>`/`.code` block showing
+ * escaped source (`&lt;button _="…"&gt;`) matches just as well as the real
+ * thing. That is not hypothetical — it is how an earlier sweep "found" two
+ * malformed sources in `examples/events-and-dom/send-events.html` that were
+ * only ever display text. Parsing the markup makes the distinction structural:
+ * escaped text decodes into a text node, never into an attribute, so it cannot
+ * be reached by an attribute walk.
+ *
+ * Do not reuse `@hyperfixi/vite-plugin`'s scanner for this purpose — it is
+ * deliberately a regex (it scans partial source files that need not be
+ * well-formed HTML) and has exactly that blind spot.
+ */
+/**
+ * The DOM surface this module needs, declared structurally.
+ *
+ * This package compiles with `lib: ["ES2022"]` (it is Node-oriented — a SQLite
+ * pattern database), so the ambient `Document`/`Element` types are not in
+ * scope. Declaring the three members used here keeps the extractor usable from
+ * a jsdom window, a browser document, or a happy-dom one without dragging the
+ * whole DOM lib into the package's build.
+ */
+interface MinimalAttr {
+    name: string;
+    value: string;
+}
+interface MinimalElement {
+    tagName: string;
+    attributes: ArrayLike<MinimalAttr>;
+    textContent: string | null;
+    getAttribute(name: string): string | null;
+}
+interface MinimalContainer extends MinimalElement {
+    innerHTML: string;
+    querySelectorAll(selectors: string): ArrayLike<MinimalElement>;
+}
+interface MinimalDocument {
+    createElement(tagName: string): MinimalContainer;
+}
+interface MarkupSnippets {
+    /** Every hyperscript source found, in document order. */
+    snippets: string[];
+    /**
+     * The markup uses at least one attribute upstream `_hyperscript` has no
+     * concept of, so it cannot be claimed as upstream-compatible regardless of
+     * how its snippets parse.
+     */
+    hyperfixiOnly: boolean;
+}
+/**
+ * Pull every hyperscript source out of `markup`.
+ *
+ * Collects `_="…"` attributes, `hx-live="…"` values (which ARE hyperscript —
+ * the htmx-compat layer compiles them), and `<script type="text/hyperscript">`
+ * bodies. The other hyperfixi-only attribute values (`sse-connect` URLs,
+ * `sse-swap` event names, `ws-connect` URLs) are not hyperscript and carry no
+ * snippet to verify, but they do set `hyperfixiOnly`.
+ *
+ * `doc` is any DOM `Document` — a jsdom window's, or the ambient one in a
+ * browser/jsdom test environment. Markup that fails to parse yields no
+ * snippets rather than throwing.
+ */
+declare function extractHyperscriptFromMarkup(doc: MinimalDocument, markup: string): MarkupSnippets;
+
 /**
  * @hyperfixi/patterns-reference
  *
@@ -456,9 +527,10 @@ declare function getSupportedLanguages(): Promise<string[]>;
  * @returns PatternsReference instance
  */
 declare function createPatternsReference(options?: ConnectionOptions): PatternsReference;
+
 /**
  * Version of the package.
  */
 declare const VERSION = "0.1.0";
 
-export { type BehaviorRuntime, Command, ConnectionOptions, DatabasePatternsProvider, Expression, Feature, type IntegrationResult, Keyword, LLMExample, type LLMExampleRecord, LanguageDocsStats, LanguageElement, LanguageElementType, type LoadBehaviorsOptions, type LoadBehaviorsResult, type PatternEntry, PatternsReference, type PatternsSource, type SemanticIntegrationOptions, SpecialSymbol, VERSION, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllSpecialSymbols, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, getDefaultDbPath, getDefaultProvider, getExpressionByName, getExpressionsByCategory, getFeatureByName, getKeywordByName, getLLMExampleStats, getLanguageDocsStats, getSpecialSymbolByName, getSupportedLanguages, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, loadBehaviors, queryPatterns, queryPatternsForCommand, resetConnection, resetDefaultProvider, searchCommands, searchLanguageElements, trackExampleUsage, uninitializeSemanticIntegration };
+export { type BehaviorRuntime, Command, ConnectionOptions, DatabasePatternsProvider, Expression, Feature, type IntegrationResult, Keyword, LLMExample, type LLMExampleRecord, LanguageDocsStats, LanguageElement, LanguageElementType, type LoadBehaviorsOptions, type LoadBehaviorsResult, type MarkupSnippets, type PatternEntry, PatternsReference, type PatternsSource, type SemanticIntegrationOptions, SpecialSymbol, VERSION, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, extractHyperscriptFromMarkup, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllSpecialSymbols, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, getDefaultDbPath, getDefaultProvider, getExpressionByName, getExpressionsByCategory, getFeatureByName, getKeywordByName, getLLMExampleStats, getLanguageDocsStats, getSpecialSymbolByName, getSupportedLanguages, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, loadBehaviors, queryPatterns, queryPatternsForCommand, resetConnection, resetDefaultProvider, searchCommands, searchLanguageElements, trackExampleUsage, uninitializeSemanticIntegration };

package/dist/index.js

@@ -1347,6 +1347,41 @@ async function getSupportedLanguages() {
   return provider.getSupportedLanguages();
 }
 
+// src/html-snippets.ts
+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 };
+  }
+  const snippets = [];
+  let hyperfixiOnly = false;
+  for (const el of Array.from(container.querySelectorAll("*"))) {
+    for (const attr of Array.from(el.attributes)) {
+      if (attr.name === "_" && attr.value.trim()) {
+        snippets.push(attr.value);
+      }
+      if (attr.name === "hx-live" && attr.value.trim()) {
+        snippets.push(attr.value);
+      }
+      if (HYPERFIXI_ONLY_ATTR_PREFIXES.some((p) => attr.name.startsWith(p))) {
+        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);
+      }
+    }
+  }
+  return { snippets, hyperfixiOnly };
+}
+
 // src/index.ts
 function createPatternsReference(options) {
   getDatabase(options);
@@ -1383,6 +1418,7 @@ exports.createPatternsProvider = createPatternsProvider;
 exports.createPatternsReference = createPatternsReference;
 exports.dbStampPath = dbStampPath;
 exports.discoverPatterns = discoverPatterns;
+exports.extractHyperscriptFromMarkup = extractHyperscriptFromMarkup;
 exports.findExamplesByCommand = findExamplesByCommand;
 exports.findRelevantExamples = findRelevantExamples;
 exports.getAllCommands = getAllCommands;

package/dist/index.mjs

@@ -1339,6 +1339,41 @@ async function getSupportedLanguages() {
   return provider.getSupportedLanguages();
 }
 
+// src/html-snippets.ts
+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 };
+  }
+  const snippets = [];
+  let hyperfixiOnly = false;
+  for (const el of Array.from(container.querySelectorAll("*"))) {
+    for (const attr of Array.from(el.attributes)) {
+      if (attr.name === "_" && attr.value.trim()) {
+        snippets.push(attr.value);
+      }
+      if (attr.name === "hx-live" && attr.value.trim()) {
+        snippets.push(attr.value);
+      }
+      if (HYPERFIXI_ONLY_ATTR_PREFIXES.some((p) => attr.name.startsWith(p))) {
+        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);
+      }
+    }
+  }
+  return { snippets, hyperfixiOnly };
+}
+
 // src/index.ts
 function createPatternsReference(options) {
   getDatabase(options);
@@ -1362,4 +1397,4 @@ function createPatternsReference(options) {
 }
 var VERSION = "0.1.0";
 
-export { DatabasePatternsProvider, VERSION, addLLMExample, buildFewShotContext, buildFewShotContextSync, checkDbStamp, closeDatabase, computeDbInputHash, createLLMAdapter, createPatternsProvider, createPatternsReference, dbStampPath, discoverPatterns, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllPatterns, getAllSpecialSymbols, getAllTranslations, getBehaviorPatterns, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, getDefaultDbPath, getDefaultProvider, getExamplesByCommand, getExpressionByName, getExpressionsByCategory, getFeatureByName, getHighConfidenceTranslations, getHighQualityExamples, getKeywordByName, getLLMExampleStats, getLLMExamples, getLLMStats, getLanguageDocsStats, getMostUsedExamples, getPatternById, getPatternStats, getPatternsByCategory, getPatternsByCommand, getSpecialSymbolByName, getSupportedLanguages, getTranslation, getTranslationStats, getTranslationsByLanguage, getVerifiedTranslations, getWordOrder, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, loadBehaviors, queryPatterns, queryPatternsForCommand, resetConnection, resetDefaultProvider, searchCommands, searchLanguageElements, searchPatterns, seedLLMExamples, syncTranslations, trackExampleUsage, uninitializeSemanticIntegration, updateQualityScore, validateAllTranslations, verifyTranslation, writeDbStamp };
+export { DatabasePatternsProvider, VERSION, addLLMExample, buildFewShotContext, buildFewShotContextSync, checkDbStamp, closeDatabase, computeDbInputHash, createLLMAdapter, createPatternsProvider, createPatternsReference, dbStampPath, discoverPatterns, extractHyperscriptFromMarkup, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllPatterns, getAllSpecialSymbols, getAllTranslations, getBehaviorPatterns, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, getDefaultDbPath, getDefaultProvider, getExamplesByCommand, getExpressionByName, getExpressionsByCategory, getFeatureByName, getHighConfidenceTranslations, getHighQualityExamples, getKeywordByName, getLLMExampleStats, getLLMExamples, getLLMStats, getLanguageDocsStats, getMostUsedExamples, getPatternById, getPatternStats, getPatternsByCategory, getPatternsByCommand, getSpecialSymbolByName, getSupportedLanguages, getTranslation, getTranslationStats, getTranslationsByLanguage, getVerifiedTranslations, getWordOrder, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, loadBehaviors, queryPatterns, queryPatternsForCommand, resetConnection, resetDefaultProvider, searchCommands, searchLanguageElements, searchPatterns, seedLLMExamples, syncTranslations, trackExampleUsage, uninitializeSemanticIntegration, updateQualityScore, validateAllTranslations, verifyTranslation, writeDbStamp };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/patterns-reference",
-  "version": "2.9.1",
+  "version": "2.9.3",
   "description": "Queryable patterns database for hyperscript with multilingual translations and LLM support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -66,13 +66,13 @@
   },
   "homepage": "https://github.com/codetalcott/hyperfixi/tree/main/packages/patterns-reference#readme",
   "dependencies": {
-    "@lokascript/semantic": "^2.9.1",
+    "@lokascript/semantic": "^2.9.3",
     "better-sqlite3": "^12.11.1"
   },
   "devDependencies": {
-    "@hyperfixi/core": "^2.9.1",
-    "@hyperfixi/reactivity": "^2.9.1",
-    "@hyperfixi/realtime": "^2.9.1",
+    "@hyperfixi/core": "^2.9.3",
+    "@hyperfixi/reactivity": "^2.9.3",
+    "@hyperfixi/realtime": "^2.9.3",
     "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^20.0.0",
     "hyperscript.org": "0.9.93",

package/src/html-snippets.ts

@@ -0,0 +1,114 @@
+/**
+ * Extract hyperscript sources out of HTML markup, via the DOM.
+ *
+ * Shared by the two harnesses that need it: `scripts/verify-engines.ts` (which
+ * classifies each corpus pattern's `engine` column) and the testing-framework's
+ * shipped-sources validity gate.
+ *
+ * **Why the DOM and not a regex.** A raw-text regex over `.html` cannot tell a
+ * live attribute from a code sample: a `<pre>`/`<code>`/`.code` block showing
+ * escaped source (`&lt;button _="…"&gt;`) matches just as well as the real
+ * thing. That is not hypothetical — it is how an earlier sweep "found" two
+ * malformed sources in `examples/events-and-dom/send-events.html` that were
+ * only ever display text. Parsing the markup makes the distinction structural:
+ * escaped text decodes into a text node, never into an attribute, so it cannot
+ * be reached by an attribute walk.
+ *
+ * Do not reuse `@hyperfixi/vite-plugin`'s scanner for this purpose — it is
+ * deliberately a regex (it scans partial source files that need not be
+ * well-formed HTML) and has exactly that blind spot.
+ */
+
+/** Attribute prefixes that only the hyperfixi htmx-compat layer implements. */
+const HYPERFIXI_ONLY_ATTR_PREFIXES = ['hx-live', 'sse-', 'ws-'];
+
+/**
+ * The DOM surface this module needs, declared structurally.
+ *
+ * This package compiles with `lib: ["ES2022"]` (it is Node-oriented — a SQLite
+ * pattern database), so the ambient `Document`/`Element` types are not in
+ * scope. Declaring the three members used here keeps the extractor usable from
+ * a jsdom window, a browser document, or a happy-dom one without dragging the
+ * whole DOM lib into the package's build.
+ */
+export interface MinimalAttr {
+  name: string;
+  value: string;
+}
+
+export interface MinimalElement {
+  tagName: string;
+  attributes: ArrayLike<MinimalAttr>;
+  textContent: string | null;
+  getAttribute(name: string): string | null;
+}
+
+export interface MinimalContainer extends MinimalElement {
+  innerHTML: string;
+  querySelectorAll(selectors: string): ArrayLike<MinimalElement>;
+}
+
+export interface MinimalDocument {
+  createElement(tagName: string): MinimalContainer;
+}
+
+export interface MarkupSnippets {
+  /** Every hyperscript source found, in document order. */
+  snippets: string[];
+  /**
+   * The markup uses at least one attribute upstream `_hyperscript` has no
+   * concept of, so it cannot be claimed as upstream-compatible regardless of
+   * how its snippets parse.
+   */
+  hyperfixiOnly: boolean;
+}
+
+/**
+ * Pull every hyperscript source out of `markup`.
+ *
+ * Collects `_="…"` attributes, `hx-live="…"` values (which ARE hyperscript —
+ * the htmx-compat layer compiles them), and `<script type="text/hyperscript">`
+ * bodies. The other hyperfixi-only attribute values (`sse-connect` URLs,
+ * `sse-swap` event names, `ws-connect` URLs) are not hyperscript and carry no
+ * snippet to verify, but they do set `hyperfixiOnly`.
+ *
+ * `doc` is any DOM `Document` — a jsdom window's, or the ambient one in a
+ * browser/jsdom test environment. Markup that fails to parse yields no
+ * snippets rather than throwing.
+ */
+export function extractHyperscriptFromMarkup(doc: MinimalDocument, markup: string): MarkupSnippets {
+  const container = doc.createElement('div');
+  try {
+    container.innerHTML = markup;
+  } catch {
+    return { snippets: [], hyperfixiOnly: false };
+  }
+
+  const snippets: string[] = [];
+  let hyperfixiOnly = false;
+
+  for (const el of Array.from(container.querySelectorAll('*'))) {
+    for (const attr of Array.from(el.attributes)) {
+      if (attr.name === '_' && attr.value.trim()) {
+        snippets.push(attr.value);
+      }
+      if (attr.name === 'hx-live' && attr.value.trim()) {
+        snippets.push(attr.value);
+      }
+      if (HYPERFIXI_ONLY_ATTR_PREFIXES.some(p => attr.name.startsWith(p))) {
+        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);
+      }
+    }
+  }
+
+  return { snippets, hyperfixiOnly };
+}

package/src/index.ts

@@ -275,6 +275,14 @@ export function createPatternsReference(options?: ConnectionOptions): PatternsRe
   };
 }
 
+/**
+ * DOM-based extraction of hyperscript out of HTML markup. Shared with the
+ * testing-framework's shipped-sources validity gate so both harnesses agree on
+ * what counts as a live source (and neither regresses to a regex).
+ */
+export { extractHyperscriptFromMarkup } from './html-snippets';
+export type { MarkupSnippets } from './html-snippets';
+
 /**
  * Version of the package.
  */