@hyperfixi/patterns-reference 2.2.0 → 2.3.0

package/dist/api/index.d.mts

@@ -1,4 +1,4 @@
-export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, d as getExamplesByCommand, e as getHighConfidenceTranslations, f as getHighQualityExamples, h as getLLMExamples, i as getLLMStats, j as getMostUsedExamples, k as getPatternById, l as getPatternStats, m as getPatternsByCategory, n as getPatternsByCommand, o as getTranslation, p as getTranslationStats, q as getTranslationsByLanguage, r as getVerifiedTranslations, s as getWordOrder, t as searchPatterns, u as updateQualityScore, v as verifyTranslation } from '../llm-DqcdT_IC.mjs';
+export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, e as getExamplesByCommand, f as getHighConfidenceTranslations, h as getHighQualityExamples, i as getLLMExamples, j as getLLMStats, k as getMostUsedExamples, l as getPatternById, m as getPatternStats, n as getPatternsByCategory, o as getPatternsByCommand, p as getTranslation, q as getTranslationStats, r as getTranslationsByLanguage, s as getVerifiedTranslations, t as getWordOrder, u as searchPatterns, v as updateQualityScore, w as verifyTranslation } from '../llm-D_Mc5Uop.mjs';
 import { C as ConnectionOptions, r as PatternRole, i as Pattern, R as RoleType } from '../index-BqjfelDP.mjs';
 import { SemanticRole } from '@lokascript/semantic';
 

package/dist/api/index.d.ts

@@ -1,4 +1,4 @@
-export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, d as getExamplesByCommand, e as getHighConfidenceTranslations, f as getHighQualityExamples, h as getLLMExamples, i as getLLMStats, j as getMostUsedExamples, k as getPatternById, l as getPatternStats, m as getPatternsByCategory, n as getPatternsByCommand, o as getTranslation, p as getTranslationStats, q as getTranslationsByLanguage, r as getVerifiedTranslations, s as getWordOrder, t as searchPatterns, u as updateQualityScore, v as verifyTranslation } from '../llm-CFegbB6t.js';
+export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, e as getExamplesByCommand, f as getHighConfidenceTranslations, h as getHighQualityExamples, i as getLLMExamples, j as getLLMStats, k as getMostUsedExamples, l as getPatternById, m as getPatternStats, n as getPatternsByCategory, o as getPatternsByCommand, p as getTranslation, q as getTranslationStats, r as getTranslationsByLanguage, s as getVerifiedTranslations, t as getWordOrder, u as searchPatterns, v as updateQualityScore, w as verifyTranslation } from '../llm-Cd3oNyVz.js';
 import { C as ConnectionOptions, r as PatternRole, i as Pattern, R as RoleType } from '../index-BqjfelDP.js';
 import { SemanticRole } from '@lokascript/semantic';
 

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { C as ConnectionOptions, a as Command, E as Expression, F as Feature, K as Keyword, S as SpecialSymbol, L as LanguageDocsStats, b as LanguageElementType, c as LanguageElement, d as LLMExample, P as PatternsReference } from './index-BqjfelDP.mjs';
 export { e as ClassifiedPattern, f as ComplexityLevel, D as DiscoveryResult, g as EngineCompat, h as ExpressionOperator, i as Pattern, j as PatternStats, k as SearchOptions, l as SyncOptions, m as SyncResult, T as TestOptions, n as Translation, o as TranslationMethod, V as ValidationOptions, p as ValidationResult, q as VerificationResult, W as WordOrder } from './index-BqjfelDP.mjs';
 import Database from 'better-sqlite3';
-export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, d as getExamplesByCommand, e as getHighConfidenceTranslations, f as getHighQualityExamples, h as getLLMExamples, i as getLLMStats, j as getMostUsedExamples, k as getPatternById, l as getPatternStats, m as getPatternsByCategory, n as getPatternsByCommand, o as getTranslation, p as getTranslationStats, q as getTranslationsByLanguage, r as getVerifiedTranslations, s as getWordOrder, t as searchPatterns, u as updateQualityScore, v as verifyTranslation } from './llm-DqcdT_IC.mjs';
+export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, d as getBehaviorPatterns, e as getExamplesByCommand, f as getHighConfidenceTranslations, h as getHighQualityExamples, i as getLLMExamples, j as getLLMStats, k as getMostUsedExamples, l as getPatternById, m as getPatternStats, n as getPatternsByCategory, o as getPatternsByCommand, p as getTranslation, q as getTranslationStats, r as getTranslationsByLanguage, s as getVerifiedTranslations, t as getWordOrder, u as searchPatterns, v as updateQualityScore, w as verifyTranslation } from './llm-D_Mc5Uop.mjs';
 export { discoverPatterns, seedLLMExamples, syncTranslations, validateAllTranslations } from './sync/index.mjs';
 import '@lokascript/semantic';
 
@@ -32,6 +32,61 @@ declare function isConnected(): boolean;
  */
 declare function getCurrentDbPath(): string | null;
 
+/**
+ * Behavior Loader — Load and register hyperscript behaviors from patterns-reference
+ *
+ * Queries the patterns database for behavior definitions, compiles them,
+ * and registers them with a LokaScript runtime instance.
+ *
+ * @example
+ * ```typescript
+ * import { loadBehaviors } from '@hyperfixi/patterns-reference';
+ *
+ * // Load all behaviors
+ * const result = await loadBehaviors(window.hyperfixi);
+ * console.log('Loaded:', result.loaded);
+ *
+ * // Load specific behaviors
+ * const result = await loadBehaviors(runtime, { names: ['Toggleable', 'Draggable'] });
+ * ```
+ */
+
+/**
+ * Minimal runtime interface required for behavior loading.
+ * Compatible with both HyperscriptAPI and the window.hyperfixi global.
+ */
+interface BehaviorRuntime {
+    compileSync(code: string, options?: {
+        traditional?: boolean;
+    }): {
+        ok: boolean;
+        ast?: unknown;
+        errors?: unknown[];
+    };
+    execute(ast: unknown, ctx: unknown): Promise<void>;
+    createContext?(): {
+        locals: Map<string, unknown>;
+        globals: Map<string, unknown>;
+    };
+}
+interface LoadBehaviorsOptions {
+    /** Only load behaviors matching these names (e.g., ['Toggleable', 'Draggable']) */
+    names?: string[];
+    /** Database connection options */
+    connectionOptions?: ConnectionOptions;
+}
+interface LoadBehaviorsResult {
+    /** IDs of successfully loaded behavior patterns */
+    loaded: string[];
+    /** Error messages for behaviors that failed to compile */
+    errors: string[];
+}
+/**
+ * Load behavior definitions from patterns-reference and register them
+ * with a LokaScript runtime instance.
+ */
+declare function loadBehaviors(runtime: BehaviorRuntime, options?: LoadBehaviorsOptions): Promise<LoadBehaviorsResult>;
+
 /**
  * Language Documentation API
  *
@@ -400,4 +455,4 @@ declare function createPatternsReference(options?: ConnectionOptions): PatternsR
  */
 declare const VERSION = "0.1.0";
 
-export { Command, ConnectionOptions, DatabasePatternsProvider, Expression, Feature, type IntegrationResult, Keyword, LLMExample, type LLMExampleRecord, LanguageDocsStats, LanguageElement, LanguageElementType, 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, getDefaultProvider, getExpressionByName, getExpressionsByCategory, getFeatureByName, getKeywordByName, getLLMExampleStats, getLanguageDocsStats, getSpecialSymbolByName, getSupportedLanguages, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, 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 PatternEntry, PatternsReference, type PatternsSource, type SemanticIntegrationOptions, SpecialSymbol, VERSION, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllSpecialSymbols, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, 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

@@ -1,7 +1,7 @@
 import { C as ConnectionOptions, a as Command, E as Expression, F as Feature, K as Keyword, S as SpecialSymbol, L as LanguageDocsStats, b as LanguageElementType, c as LanguageElement, d as LLMExample, P as PatternsReference } from './index-BqjfelDP.js';
 export { e as ClassifiedPattern, f as ComplexityLevel, D as DiscoveryResult, g as EngineCompat, h as ExpressionOperator, i as Pattern, j as PatternStats, k as SearchOptions, l as SyncOptions, m as SyncResult, T as TestOptions, n as Translation, o as TranslationMethod, V as ValidationOptions, p as ValidationResult, q as VerificationResult, W as WordOrder } from './index-BqjfelDP.js';
 import Database from 'better-sqlite3';
-export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, d as getExamplesByCommand, e as getHighConfidenceTranslations, f as getHighQualityExamples, h as getLLMExamples, i as getLLMStats, j as getMostUsedExamples, k as getPatternById, l as getPatternStats, m as getPatternsByCategory, n as getPatternsByCommand, o as getTranslation, p as getTranslationStats, q as getTranslationsByLanguage, r as getVerifiedTranslations, s as getWordOrder, t as searchPatterns, u as updateQualityScore, v as verifyTranslation } from './llm-CFegbB6t.js';
+export { a as addLLMExample, b as buildFewShotContext, g as getAllPatterns, c as getAllTranslations, d as getBehaviorPatterns, e as getExamplesByCommand, f as getHighConfidenceTranslations, h as getHighQualityExamples, i as getLLMExamples, j as getLLMStats, k as getMostUsedExamples, l as getPatternById, m as getPatternStats, n as getPatternsByCategory, o as getPatternsByCommand, p as getTranslation, q as getTranslationStats, r as getTranslationsByLanguage, s as getVerifiedTranslations, t as getWordOrder, u as searchPatterns, v as updateQualityScore, w as verifyTranslation } from './llm-Cd3oNyVz.js';
 export { discoverPatterns, seedLLMExamples, syncTranslations, validateAllTranslations } from './sync/index.js';
 import '@lokascript/semantic';
 
@@ -32,6 +32,61 @@ declare function isConnected(): boolean;
  */
 declare function getCurrentDbPath(): string | null;
 
+/**
+ * Behavior Loader — Load and register hyperscript behaviors from patterns-reference
+ *
+ * Queries the patterns database for behavior definitions, compiles them,
+ * and registers them with a LokaScript runtime instance.
+ *
+ * @example
+ * ```typescript
+ * import { loadBehaviors } from '@hyperfixi/patterns-reference';
+ *
+ * // Load all behaviors
+ * const result = await loadBehaviors(window.hyperfixi);
+ * console.log('Loaded:', result.loaded);
+ *
+ * // Load specific behaviors
+ * const result = await loadBehaviors(runtime, { names: ['Toggleable', 'Draggable'] });
+ * ```
+ */
+
+/**
+ * Minimal runtime interface required for behavior loading.
+ * Compatible with both HyperscriptAPI and the window.hyperfixi global.
+ */
+interface BehaviorRuntime {
+    compileSync(code: string, options?: {
+        traditional?: boolean;
+    }): {
+        ok: boolean;
+        ast?: unknown;
+        errors?: unknown[];
+    };
+    execute(ast: unknown, ctx: unknown): Promise<void>;
+    createContext?(): {
+        locals: Map<string, unknown>;
+        globals: Map<string, unknown>;
+    };
+}
+interface LoadBehaviorsOptions {
+    /** Only load behaviors matching these names (e.g., ['Toggleable', 'Draggable']) */
+    names?: string[];
+    /** Database connection options */
+    connectionOptions?: ConnectionOptions;
+}
+interface LoadBehaviorsResult {
+    /** IDs of successfully loaded behavior patterns */
+    loaded: string[];
+    /** Error messages for behaviors that failed to compile */
+    errors: string[];
+}
+/**
+ * Load behavior definitions from patterns-reference and register them
+ * with a LokaScript runtime instance.
+ */
+declare function loadBehaviors(runtime: BehaviorRuntime, options?: LoadBehaviorsOptions): Promise<LoadBehaviorsResult>;
+
 /**
  * Language Documentation API
  *
@@ -400,4 +455,4 @@ declare function createPatternsReference(options?: ConnectionOptions): PatternsR
  */
 declare const VERSION = "0.1.0";
 
-export { Command, ConnectionOptions, DatabasePatternsProvider, Expression, Feature, type IntegrationResult, Keyword, LLMExample, type LLMExampleRecord, LanguageDocsStats, LanguageElement, LanguageElementType, 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, getDefaultProvider, getExpressionByName, getExpressionsByCategory, getFeatureByName, getKeywordByName, getLLMExampleStats, getLanguageDocsStats, getSpecialSymbolByName, getSupportedLanguages, initializeSemanticIntegration, isConnected, isDatabaseAvailable, isSemanticIntegrationInitialized, 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 PatternEntry, PatternsReference, type PatternsSource, type SemanticIntegrationOptions, SpecialSymbol, VERSION, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllSpecialSymbols, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, 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

@@ -154,6 +154,9 @@ async function getPatternStats(connOptions) {
     avgConfidence: avgConfResult.avg || 0
   };
 }
+async function getBehaviorPatterns(options) {
+  return getPatternsByCategory("behavior", options);
+}
 function mapRowToPattern(row) {
   return {
     id: row.id,
@@ -188,6 +191,34 @@ function inferDifficulty(code) {
   return "advanced";
 }
 
+// src/api/behavior-loader.ts
+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;
+  const loaded = [];
+  const errors = [];
+  for (const pattern of filtered) {
+    const result = runtime.compileSync(pattern.rawCode, { traditional: true });
+    if (result.ok && result.ast) {
+      try {
+        const ctx = runtime.createContext?.() ?? {
+          locals: /* @__PURE__ */ new Map(),
+          globals: /* @__PURE__ */ new Map()
+        };
+        await runtime.execute(result.ast, ctx);
+        loaded.push(pattern.id);
+      } catch (err) {
+        errors.push(
+          `${pattern.id}: execute failed \u2014 ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    } else {
+      errors.push(`${pattern.id}: compile failed \u2014 ${JSON.stringify(result.errors)}`);
+    }
+  }
+  return { loaded, errors };
+}
+
 // src/api/translations.ts
 async function getTranslation(patternId, language, options) {
   const db = getDatabase({ ...options, readonly: true });
@@ -1264,6 +1295,7 @@ exports.getAllKeywords = getAllKeywords;
 exports.getAllPatterns = getAllPatterns;
 exports.getAllSpecialSymbols = getAllSpecialSymbols;
 exports.getAllTranslations = getAllTranslations;
+exports.getBehaviorPatterns = getBehaviorPatterns;
 exports.getBridgeProvider = getBridgeProvider;
 exports.getCommandByName = getCommandByName;
 exports.getCurrentDbPath = getCurrentDbPath;
@@ -1296,6 +1328,7 @@ exports.initializeSemanticIntegration = initializeSemanticIntegration;
 exports.isConnected = isConnected;
 exports.isDatabaseAvailable = isDatabaseAvailable;
 exports.isSemanticIntegrationInitialized = isSemanticIntegrationInitialized;
+exports.loadBehaviors = loadBehaviors;
 exports.queryPatterns = queryPatterns;
 exports.queryPatternsForCommand = queryPatternsForCommand;
 exports.resetConnection = resetConnection;

package/dist/index.mjs

@@ -146,6 +146,9 @@ async function getPatternStats(connOptions) {
     avgConfidence: avgConfResult.avg || 0
   };
 }
+async function getBehaviorPatterns(options) {
+  return getPatternsByCategory("behavior", options);
+}
 function mapRowToPattern(row) {
   return {
     id: row.id,
@@ -180,6 +183,34 @@ function inferDifficulty(code) {
   return "advanced";
 }
 
+// src/api/behavior-loader.ts
+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;
+  const loaded = [];
+  const errors = [];
+  for (const pattern of filtered) {
+    const result = runtime.compileSync(pattern.rawCode, { traditional: true });
+    if (result.ok && result.ast) {
+      try {
+        const ctx = runtime.createContext?.() ?? {
+          locals: /* @__PURE__ */ new Map(),
+          globals: /* @__PURE__ */ new Map()
+        };
+        await runtime.execute(result.ast, ctx);
+        loaded.push(pattern.id);
+      } catch (err) {
+        errors.push(
+          `${pattern.id}: execute failed \u2014 ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    } else {
+      errors.push(`${pattern.id}: compile failed \u2014 ${JSON.stringify(result.errors)}`);
+    }
+  }
+  return { loaded, errors };
+}
+
 // src/api/translations.ts
 async function getTranslation(patternId, language, options) {
   const db = getDatabase({ ...options, readonly: true });
@@ -1237,4 +1268,4 @@ function createPatternsReference(options) {
 }
 var VERSION = "0.1.0";
 
-export { DatabasePatternsProvider, VERSION, addLLMExample, buildFewShotContext, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, discoverPatterns, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllPatterns, getAllSpecialSymbols, getAllTranslations, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, 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, queryPatterns, queryPatternsForCommand, resetConnection, resetDefaultProvider, searchCommands, searchLanguageElements, searchPatterns, seedLLMExamples, syncTranslations, trackExampleUsage, uninitializeSemanticIntegration, updateQualityScore, validateAllTranslations, verifyTranslation };
+export { DatabasePatternsProvider, VERSION, addLLMExample, buildFewShotContext, buildFewShotContextSync, closeDatabase, createLLMAdapter, createPatternsProvider, createPatternsReference, discoverPatterns, findExamplesByCommand, findRelevantExamples, getAllCommands, getAllExpressions, getAllFeatures, getAllKeywords, getAllPatterns, getAllSpecialSymbols, getAllTranslations, getBehaviorPatterns, getBridgeProvider, getCommandByName, getCurrentDbPath, getDatabase, 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 };

package/dist/{llm-CFegbB6t.d.ts → llm-Cd3oNyVz.d.ts}

@@ -30,6 +30,14 @@ declare function getAllPatterns(searchOptions?: SearchOptions, connOptions?: Con
  * Get pattern statistics.
  */
 declare function getPatternStats(connOptions?: ConnectionOptions): Promise<PatternStats>;
+/**
+ * Get behavior definition patterns.
+ *
+ * Returns patterns with feature='behavior' — these are installable
+ * behavior definitions (behavior Name(params) ... end) that can be
+ * compiled and registered with a LokaScript runtime.
+ */
+declare function getBehaviorPatterns(options?: ConnectionOptions): Promise<Pattern[]>;
 
 /**
  * Translation Operations API
@@ -120,4 +128,4 @@ declare function getLLMStats(options?: ConnectionOptions): Promise<{
     totalUsage: number;
 }>;
 
-export { addLLMExample as a, buildFewShotContext as b, getAllTranslations as c, getExamplesByCommand as d, getHighConfidenceTranslations as e, getHighQualityExamples as f, getAllPatterns as g, getLLMExamples as h, getLLMStats as i, getMostUsedExamples as j, getPatternById as k, getPatternStats as l, getPatternsByCategory as m, getPatternsByCommand as n, getTranslation as o, getTranslationStats as p, getTranslationsByLanguage as q, getVerifiedTranslations as r, getWordOrder as s, searchPatterns as t, updateQualityScore as u, verifyTranslation as v };
+export { addLLMExample as a, buildFewShotContext as b, getAllTranslations as c, getBehaviorPatterns as d, getExamplesByCommand as e, getHighConfidenceTranslations as f, getAllPatterns as g, getHighQualityExamples as h, getLLMExamples as i, getLLMStats as j, getMostUsedExamples as k, getPatternById as l, getPatternStats as m, getPatternsByCategory as n, getPatternsByCommand as o, getTranslation as p, getTranslationStats as q, getTranslationsByLanguage as r, getVerifiedTranslations as s, getWordOrder as t, searchPatterns as u, updateQualityScore as v, verifyTranslation as w };

package/dist/{llm-DqcdT_IC.d.mts → llm-D_Mc5Uop.d.mts}

@@ -30,6 +30,14 @@ declare function getAllPatterns(searchOptions?: SearchOptions, connOptions?: Con
  * Get pattern statistics.
  */
 declare function getPatternStats(connOptions?: ConnectionOptions): Promise<PatternStats>;
+/**
+ * Get behavior definition patterns.
+ *
+ * Returns patterns with feature='behavior' — these are installable
+ * behavior definitions (behavior Name(params) ... end) that can be
+ * compiled and registered with a LokaScript runtime.
+ */
+declare function getBehaviorPatterns(options?: ConnectionOptions): Promise<Pattern[]>;
 
 /**
  * Translation Operations API
@@ -120,4 +128,4 @@ declare function getLLMStats(options?: ConnectionOptions): Promise<{
     totalUsage: number;
 }>;
 
-export { addLLMExample as a, buildFewShotContext as b, getAllTranslations as c, getExamplesByCommand as d, getHighConfidenceTranslations as e, getHighQualityExamples as f, getAllPatterns as g, getLLMExamples as h, getLLMStats as i, getMostUsedExamples as j, getPatternById as k, getPatternStats as l, getPatternsByCategory as m, getPatternsByCommand as n, getTranslation as o, getTranslationStats as p, getTranslationsByLanguage as q, getVerifiedTranslations as r, getWordOrder as s, searchPatterns as t, updateQualityScore as u, verifyTranslation as v };
+export { addLLMExample as a, buildFewShotContext as b, getAllTranslations as c, getBehaviorPatterns as d, getExamplesByCommand as e, getHighConfidenceTranslations as f, getAllPatterns as g, getHighQualityExamples as h, getLLMExamples as i, getLLMStats as j, getMostUsedExamples as k, getPatternById as l, getPatternStats as m, getPatternsByCategory as n, getPatternsByCommand as o, getTranslation as p, getTranslationStats as q, getTranslationsByLanguage as r, getVerifiedTranslations as s, getWordOrder as t, searchPatterns as u, updateQualityScore as v, verifyTranslation as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/patterns-reference",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Queryable patterns database for hyperscript with multilingual translations and LLM support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/api/behavior-loader.ts

@@ -0,0 +1,88 @@
+/**
+ * Behavior Loader — Load and register hyperscript behaviors from patterns-reference
+ *
+ * Queries the patterns database for behavior definitions, compiles them,
+ * and registers them with a LokaScript runtime instance.
+ *
+ * @example
+ * ```typescript
+ * import { loadBehaviors } from '@hyperfixi/patterns-reference';
+ *
+ * // Load all behaviors
+ * const result = await loadBehaviors(window.hyperfixi);
+ * console.log('Loaded:', result.loaded);
+ *
+ * // Load specific behaviors
+ * const result = await loadBehaviors(runtime, { names: ['Toggleable', 'Draggable'] });
+ * ```
+ */
+
+import { getBehaviorPatterns } from './patterns';
+import type { ConnectionOptions } from '../types';
+
+/**
+ * Minimal runtime interface required for behavior loading.
+ * Compatible with both HyperscriptAPI and the window.hyperfixi global.
+ */
+export interface BehaviorRuntime {
+  compileSync(
+    code: string,
+    options?: { traditional?: boolean }
+  ): { ok: boolean; ast?: unknown; errors?: unknown[] };
+  execute(ast: unknown, ctx: unknown): Promise<void>;
+  createContext?(): { locals: Map<string, unknown>; globals: Map<string, unknown> };
+}
+
+export interface LoadBehaviorsOptions {
+  /** Only load behaviors matching these names (e.g., ['Toggleable', 'Draggable']) */
+  names?: string[];
+  /** Database connection options */
+  connectionOptions?: ConnectionOptions;
+}
+
+export interface LoadBehaviorsResult {
+  /** IDs of successfully loaded behavior patterns */
+  loaded: string[];
+  /** Error messages for behaviors that failed to compile */
+  errors: string[];
+}
+
+/**
+ * Load behavior definitions from patterns-reference and register them
+ * with a LokaScript runtime instance.
+ */
+export async function loadBehaviors(
+  runtime: BehaviorRuntime,
+  options?: LoadBehaviorsOptions
+): Promise<LoadBehaviorsResult> {
+  const patterns = await getBehaviorPatterns(options?.connectionOptions);
+
+  const filtered = options?.names
+    ? patterns.filter(p => options.names!.some(name => p.rawCode.includes(`behavior ${name}(`)))
+    : patterns;
+
+  const loaded: string[] = [];
+  const errors: string[] = [];
+
+  for (const pattern of filtered) {
+    const result = runtime.compileSync(pattern.rawCode, { traditional: true });
+    if (result.ok && result.ast) {
+      try {
+        const ctx = runtime.createContext?.() ?? {
+          locals: new Map(),
+          globals: new Map(),
+        };
+        await runtime.execute(result.ast, ctx);
+        loaded.push(pattern.id);
+      } catch (err) {
+        errors.push(
+          `${pattern.id}: execute failed — ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    } else {
+      errors.push(`${pattern.id}: compile failed — ${JSON.stringify(result.errors)}`);
+    }
+  }
+
+  return { loaded, errors };
+}

package/src/api/patterns.ts

@@ -222,6 +222,17 @@ export async function getPatternStats(connOptions?: ConnectionOptions): Promise<
   };
 }
 
+/**
+ * Get behavior definition patterns.
+ *
+ * Returns patterns with feature='behavior' — these are installable
+ * behavior definitions (behavior Name(params) ... end) that can be
+ * compiled and registered with a LokaScript runtime.
+ */
+export async function getBehaviorPatterns(options?: ConnectionOptions): Promise<Pattern[]> {
+  return getPatternsByCategory('behavior', options);
+}
+
 // =============================================================================
 // Helper Functions
 // =============================================================================

package/src/index.ts

@@ -97,8 +97,17 @@ export {
   searchPatterns,
   getAllPatterns,
   getPatternStats,
+  getBehaviorPatterns,
 } from './api/patterns';
 
+// Behavior Loader
+export { loadBehaviors } from './api/behavior-loader';
+export type {
+  BehaviorRuntime,
+  LoadBehaviorsOptions,
+  LoadBehaviorsResult,
+} from './api/behavior-loader';
+
 // Translations
 export {
   getTranslation,