@hyperfixi/patterns-reference 2.0.0

package/dist/llm-DMR6tmkM.d.ts

@@ -0,0 +1,123 @@
+import { C as ConnectionOptions, e as Pattern, k as SearchOptions, m as PatternStats, T as Translation, V as VerificationResult, W as WordOrder, d as LLMExample } from './index-CBoczxz7.js';
+
+/**
+ * Pattern Queries API
+ *
+ * Provides functions to query patterns from the database.
+ */
+
+/**
+ * Get a pattern by ID.
+ */
+declare function getPatternById(id: string, options?: ConnectionOptions): Promise<Pattern | null>;
+/**
+ * Get patterns by category (feature in hyperscript-lsp schema).
+ */
+declare function getPatternsByCategory(category: string, options?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Get patterns by command (extracted from raw_code).
+ */
+declare function getPatternsByCommand(command: string, options?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Search patterns by text query.
+ */
+declare function searchPatterns(query: string, searchOptions?: SearchOptions, connOptions?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Get all patterns.
+ */
+declare function getAllPatterns(searchOptions?: SearchOptions, connOptions?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Get pattern statistics.
+ */
+declare function getPatternStats(connOptions?: ConnectionOptions): Promise<PatternStats>;
+
+/**
+ * Translation Operations API
+ *
+ * Provides functions to query and manage translations.
+ */
+
+/**
+ * Get a translation for a pattern in a specific language.
+ */
+declare function getTranslation(patternId: string, language: string, options?: ConnectionOptions): Promise<Translation | null>;
+/**
+ * Get all translations for a pattern.
+ */
+declare function getAllTranslations(patternId: string, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Get translations by language.
+ */
+declare function getTranslationsByLanguage(language: string, limit?: number, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Get verified translations (successfully parsed).
+ */
+declare function getVerifiedTranslations(language: string, limit?: number, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Get high-confidence translations.
+ */
+declare function getHighConfidenceTranslations(minConfidence?: number, limit?: number, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Verify a translation parses correctly.
+ * Note: This requires @lokascript/semantic to be available.
+ */
+declare function verifyTranslation(translation: Translation, options?: ConnectionOptions): Promise<VerificationResult>;
+/**
+ * Get translation statistics by language.
+ */
+declare function getTranslationStats(options?: ConnectionOptions): Promise<Record<string, {
+    total: number;
+    verified: number;
+    avgConfidence: number;
+}>>;
+/**
+ * Get word order for a language.
+ */
+declare function getWordOrder(language: string): WordOrder;
+
+/**
+ * LLM Examples API
+ *
+ * Provides functions to query and manage LLM examples for few-shot learning.
+ */
+
+/**
+ * Get LLM examples relevant to a prompt.
+ * Uses text similarity to find relevant patterns.
+ */
+declare function getLLMExamples(prompt: string, language?: string, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Get examples by command type.
+ */
+declare function getExamplesByCommand(command: string, language?: string, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Get high-quality examples (for few-shot prompts).
+ */
+declare function getHighQualityExamples(language?: string, minQuality?: number, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Get most used examples (popular).
+ */
+declare function getMostUsedExamples(language?: string, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Build few-shot context for LLM prompting.
+ */
+declare function buildFewShotContext(prompt: string, language?: string, numExamples?: number, options?: ConnectionOptions): Promise<string>;
+/**
+ * Add a new LLM example.
+ */
+declare function addLLMExample(example: Omit<LLMExample, 'id' | 'usageCount' | 'createdAt'>, options?: ConnectionOptions): Promise<number>;
+/**
+ * Update example quality score.
+ */
+declare function updateQualityScore(id: number, qualityScore: number, options?: ConnectionOptions): Promise<void>;
+/**
+ * Get LLM example statistics.
+ */
+declare function getLLMStats(options?: ConnectionOptions): Promise<{
+    total: number;
+    byLanguage: Record<string, number>;
+    avgQuality: number;
+    totalUsage: number;
+}>;
+
+export { getPatternsByCategory as a, getPatternsByCommand as b, getAllPatterns as c, getPatternStats as d, getTranslation as e, getAllTranslations as f, getPatternById as g, getTranslationsByLanguage as h, getVerifiedTranslations as i, getHighConfidenceTranslations as j, getTranslationStats as k, getWordOrder as l, getLLMExamples as m, getExamplesByCommand as n, getHighQualityExamples as o, getMostUsedExamples as p, buildFewShotContext as q, addLLMExample as r, searchPatterns as s, getLLMStats as t, updateQualityScore as u, verifyTranslation as v };

package/dist/llm-UOOBXwj3.d.mts

@@ -0,0 +1,123 @@
+import { C as ConnectionOptions, e as Pattern, k as SearchOptions, m as PatternStats, T as Translation, V as VerificationResult, W as WordOrder, d as LLMExample } from './index-CBoczxz7.mjs';
+
+/**
+ * Pattern Queries API
+ *
+ * Provides functions to query patterns from the database.
+ */
+
+/**
+ * Get a pattern by ID.
+ */
+declare function getPatternById(id: string, options?: ConnectionOptions): Promise<Pattern | null>;
+/**
+ * Get patterns by category (feature in hyperscript-lsp schema).
+ */
+declare function getPatternsByCategory(category: string, options?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Get patterns by command (extracted from raw_code).
+ */
+declare function getPatternsByCommand(command: string, options?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Search patterns by text query.
+ */
+declare function searchPatterns(query: string, searchOptions?: SearchOptions, connOptions?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Get all patterns.
+ */
+declare function getAllPatterns(searchOptions?: SearchOptions, connOptions?: ConnectionOptions): Promise<Pattern[]>;
+/**
+ * Get pattern statistics.
+ */
+declare function getPatternStats(connOptions?: ConnectionOptions): Promise<PatternStats>;
+
+/**
+ * Translation Operations API
+ *
+ * Provides functions to query and manage translations.
+ */
+
+/**
+ * Get a translation for a pattern in a specific language.
+ */
+declare function getTranslation(patternId: string, language: string, options?: ConnectionOptions): Promise<Translation | null>;
+/**
+ * Get all translations for a pattern.
+ */
+declare function getAllTranslations(patternId: string, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Get translations by language.
+ */
+declare function getTranslationsByLanguage(language: string, limit?: number, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Get verified translations (successfully parsed).
+ */
+declare function getVerifiedTranslations(language: string, limit?: number, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Get high-confidence translations.
+ */
+declare function getHighConfidenceTranslations(minConfidence?: number, limit?: number, options?: ConnectionOptions): Promise<Translation[]>;
+/**
+ * Verify a translation parses correctly.
+ * Note: This requires @lokascript/semantic to be available.
+ */
+declare function verifyTranslation(translation: Translation, options?: ConnectionOptions): Promise<VerificationResult>;
+/**
+ * Get translation statistics by language.
+ */
+declare function getTranslationStats(options?: ConnectionOptions): Promise<Record<string, {
+    total: number;
+    verified: number;
+    avgConfidence: number;
+}>>;
+/**
+ * Get word order for a language.
+ */
+declare function getWordOrder(language: string): WordOrder;
+
+/**
+ * LLM Examples API
+ *
+ * Provides functions to query and manage LLM examples for few-shot learning.
+ */
+
+/**
+ * Get LLM examples relevant to a prompt.
+ * Uses text similarity to find relevant patterns.
+ */
+declare function getLLMExamples(prompt: string, language?: string, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Get examples by command type.
+ */
+declare function getExamplesByCommand(command: string, language?: string, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Get high-quality examples (for few-shot prompts).
+ */
+declare function getHighQualityExamples(language?: string, minQuality?: number, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Get most used examples (popular).
+ */
+declare function getMostUsedExamples(language?: string, limit?: number, options?: ConnectionOptions): Promise<LLMExample[]>;
+/**
+ * Build few-shot context for LLM prompting.
+ */
+declare function buildFewShotContext(prompt: string, language?: string, numExamples?: number, options?: ConnectionOptions): Promise<string>;
+/**
+ * Add a new LLM example.
+ */
+declare function addLLMExample(example: Omit<LLMExample, 'id' | 'usageCount' | 'createdAt'>, options?: ConnectionOptions): Promise<number>;
+/**
+ * Update example quality score.
+ */
+declare function updateQualityScore(id: number, qualityScore: number, options?: ConnectionOptions): Promise<void>;
+/**
+ * Get LLM example statistics.
+ */
+declare function getLLMStats(options?: ConnectionOptions): Promise<{
+    total: number;
+    byLanguage: Record<string, number>;
+    avgQuality: number;
+    totalUsage: number;
+}>;
+
+export { getPatternsByCategory as a, getPatternsByCommand as b, getAllPatterns as c, getPatternStats as d, getTranslation as e, getAllTranslations as f, getPatternById as g, getTranslationsByLanguage as h, getVerifiedTranslations as i, getHighConfidenceTranslations as j, getTranslationStats as k, getWordOrder as l, getLLMExamples as m, getExamplesByCommand as n, getHighQualityExamples as o, getMostUsedExamples as p, buildFewShotContext as q, addLLMExample as r, searchPatterns as s, getLLMStats as t, updateQualityScore as u, verifyTranslation as v };

package/dist/sync/index.d.mts

@@ -0,0 +1,42 @@
+import { n as SyncOptions, o as SyncResult, p as ValidationOptions, q as ValidationResult, D as DiscoveryResult } from '../index-CBoczxz7.mjs';
+import '@lokascript/semantic';
+
+/**
+ * Sync Module
+ *
+ * Re-exports sync operations that were migrated from packages/semantic/scripts/.
+ * These are typically run via CLI scripts rather than imported directly.
+ */
+
+/**
+ * Sync translations from code_examples to pattern_translations.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/sync-lsp-translations.ts
+ */
+declare function syncTranslations(_options?: SyncOptions): Promise<SyncResult>;
+/**
+ * Validate all translations in the database.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/validate-translations.ts
+ */
+declare function validateAllTranslations(_options?: ValidationOptions): Promise<ValidationResult>;
+/**
+ * Discover and analyze patterns in the database.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/pattern-discovery.ts
+ */
+declare function discoverPatterns(_verbose?: boolean): Promise<DiscoveryResult>;
+/**
+ * Seed LLM examples from verified translations.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/seed-llm-examples.ts
+ */
+declare function seedLLMExamples(_dryRun?: boolean): Promise<{
+    count: number;
+}>;
+
+export { DiscoveryResult, SyncOptions, SyncResult, ValidationOptions, ValidationResult, discoverPatterns, seedLLMExamples, syncTranslations, validateAllTranslations };

package/dist/sync/index.d.ts

@@ -0,0 +1,42 @@
+import { n as SyncOptions, o as SyncResult, p as ValidationOptions, q as ValidationResult, D as DiscoveryResult } from '../index-CBoczxz7.js';
+import '@lokascript/semantic';
+
+/**
+ * Sync Module
+ *
+ * Re-exports sync operations that were migrated from packages/semantic/scripts/.
+ * These are typically run via CLI scripts rather than imported directly.
+ */
+
+/**
+ * Sync translations from code_examples to pattern_translations.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/sync-lsp-translations.ts
+ */
+declare function syncTranslations(_options?: SyncOptions): Promise<SyncResult>;
+/**
+ * Validate all translations in the database.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/validate-translations.ts
+ */
+declare function validateAllTranslations(_options?: ValidationOptions): Promise<ValidationResult>;
+/**
+ * Discover and analyze patterns in the database.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/pattern-discovery.ts
+ */
+declare function discoverPatterns(_verbose?: boolean): Promise<DiscoveryResult>;
+/**
+ * Seed LLM examples from verified translations.
+ *
+ * This is a placeholder - the actual implementation is in
+ * packages/semantic/scripts/seed-llm-examples.ts
+ */
+declare function seedLLMExamples(_dryRun?: boolean): Promise<{
+    count: number;
+}>;
+
+export { DiscoveryResult, SyncOptions, SyncResult, ValidationOptions, ValidationResult, discoverPatterns, seedLLMExamples, syncTranslations, validateAllTranslations };

package/dist/sync/index.js

@@ -0,0 +1,28 @@
+'use strict';
+
+// src/sync/index.ts
+async function syncTranslations(_options = {}) {
+  throw new Error(
+    "syncTranslations should be run via: bun run packages/semantic/scripts/sync-lsp-translations.ts"
+  );
+}
+async function validateAllTranslations(_options = {}) {
+  throw new Error(
+    "validateAllTranslations should be run via: bun run packages/semantic/scripts/validate-translations.ts"
+  );
+}
+async function discoverPatterns(_verbose = false) {
+  throw new Error(
+    "discoverPatterns should be run via: bun run packages/semantic/scripts/pattern-discovery.ts"
+  );
+}
+async function seedLLMExamples(_dryRun = false) {
+  throw new Error(
+    "seedLLMExamples should be run via: bun run packages/semantic/scripts/seed-llm-examples.ts"
+  );
+}
+
+exports.discoverPatterns = discoverPatterns;
+exports.seedLLMExamples = seedLLMExamples;
+exports.syncTranslations = syncTranslations;
+exports.validateAllTranslations = validateAllTranslations;

package/dist/sync/index.mjs

@@ -0,0 +1,23 @@
+// src/sync/index.ts
+async function syncTranslations(_options = {}) {
+  throw new Error(
+    "syncTranslations should be run via: bun run packages/semantic/scripts/sync-lsp-translations.ts"
+  );
+}
+async function validateAllTranslations(_options = {}) {
+  throw new Error(
+    "validateAllTranslations should be run via: bun run packages/semantic/scripts/validate-translations.ts"
+  );
+}
+async function discoverPatterns(_verbose = false) {
+  throw new Error(
+    "discoverPatterns should be run via: bun run packages/semantic/scripts/pattern-discovery.ts"
+  );
+}
+async function seedLLMExamples(_dryRun = false) {
+  throw new Error(
+    "seedLLMExamples should be run via: bun run packages/semantic/scripts/seed-llm-examples.ts"
+  );
+}
+
+export { discoverPatterns, seedLLMExamples, syncTranslations, validateAllTranslations };

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@hyperfixi/patterns-reference",
+  "version": "2.0.0",
+  "description": "Queryable patterns database for hyperscript with multilingual translations and LLM support",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.mjs",
+      "require": "./dist/api/index.js"
+    },
+    "./sync": {
+      "types": "./dist/sync/index.d.ts",
+      "import": "./dist/sync/index.mjs",
+      "require": "./dist/sync/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "db:init": "tsx scripts/init-db.ts",
+    "db:init:force": "tsx scripts/init-db.ts --force",
+    "sync:translations": "tsx scripts/sync-translations.ts",
+    "seed:llm": "tsx scripts/seed-llm-examples.ts",
+    "populate": "npm run db:init:force && npm run sync:translations && npm run seed:llm && npm run db:fix-translations",
+    "db:fix-translations": "tsx scripts/run-sql.ts scripts/fix-translations.sql",
+    "populate:dry-run": "npm run db:init:force && tsx scripts/sync-translations.ts --dry-run && tsx scripts/seed-llm-examples.ts --dry-run",
+    "validate": "tsx scripts/validate-all.ts",
+    "validate:fix": "tsx scripts/validate-all.ts --fix",
+    "verify": "tsx scripts/verify-translations.ts",
+    "verify:verbose": "tsx scripts/verify-translations.ts --verbose",
+    "verify:engine": "tsx scripts/verify-engine-compat.ts",
+    "verify:engine:verbose": "tsx scripts/verify-engine-compat.ts --verbose",
+    "verify:engine:dry-run": "tsx scripts/verify-engine-compat.ts --dry-run --verbose"
+  },
+  "keywords": [
+    "hyperscript",
+    "patterns",
+    "multilingual",
+    "i18n",
+    "reference",
+    "llm",
+    "database"
+  ],
+  "author": "LokaScript Contributors",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codetalcott/hyperfixi.git",
+    "directory": "packages/patterns-reference"
+  },
+  "bugs": {
+    "url": "https://github.com/codetalcott/hyperfixi/issues"
+  },
+  "homepage": "https://github.com/codetalcott/hyperfixi/tree/main/packages/patterns-reference#readme",
+  "dependencies": {
+    "@lokascript/semantic": "*",
+    "better-sqlite3": "^12.6.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.0"
+  },
+  "files": [
+    "dist",
+    "data",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.spec.ts"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/adapters/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Adapters for cross-package integration.
+ *
+ * @module @hyperfixi/patterns-reference/adapters
+ */
+
+export * from './llm-adapter';