@hyperfixi/patterns-reference 2.0.0

package/dist/index-CBoczxz7.d.mts

@@ -0,0 +1,296 @@
+import { SemanticRole } from '@lokascript/semantic';
+
+/**
+ * Patterns Reference Type Definitions
+ */
+/**
+ * Engine compatibility for a pattern.
+ * - 'hyperscript': only verified for official _hyperscript
+ * - 'lokascript': only verified for lokascript (not backward compatible)
+ * - 'both': verified for both engines
+ * - null: unverified
+ */
+type EngineCompat = 'hyperscript' | 'lokascript' | 'both';
+/**
+ * A pattern from the database (code_examples table).
+ */
+interface Pattern {
+    id: string;
+    title: string;
+    description: string | null;
+    rawCode: string;
+    category: string | null;
+    primaryCommand: string | null;
+    tags: string[];
+    difficulty: 'beginner' | 'intermediate' | 'advanced';
+    engine: EngineCompat | null;
+    createdAt: Date;
+}
+/**
+ * Pattern with computed complexity classification.
+ */
+interface ClassifiedPattern extends Pattern {
+    complexity: ComplexityLevel;
+    lineCount: number;
+    commands: string[];
+}
+type ComplexityLevel = 'simple-command' | 'simple-event' | 'chained-command' | 'multi-line-event' | 'behavior-install' | 'behavior-def' | 'def-function' | 'complex';
+type WordOrder = 'SVO' | 'SOV' | 'VSO' | 'V2';
+type TranslationMethod = 'auto-generated' | 'hand-crafted' | 'verified';
+/**
+ * A translation of a pattern to a specific language.
+ */
+interface Translation {
+    id: number;
+    codeExampleId: string;
+    language: string;
+    hyperscript: string;
+    wordOrder: WordOrder;
+    translationMethod: TranslationMethod;
+    confidence: number;
+    verifiedParses: boolean;
+    verifiedExecutes: boolean;
+    roleAlignmentScore: number | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Result of translation verification.
+ */
+interface VerificationResult {
+    translation: Translation;
+    parseSuccess: boolean;
+    executeSuccess: boolean;
+    errorMessage: string | null;
+    confidence: number;
+    testedAt: Date;
+}
+/**
+ * An LLM example (prompt/completion pair).
+ */
+interface LLMExample {
+    id: number;
+    patternId: string;
+    language: string;
+    prompt: string;
+    completion: string;
+    qualityScore: number;
+    usageCount: number;
+    createdAt: Date;
+}
+
+/**
+ * Role type classification.
+ */
+type RoleType = 'selector' | 'literal' | 'reference' | 'expression' | 'keyword';
+/**
+ * A semantic role extracted from a pattern.
+ */
+interface PatternRole {
+    id: number;
+    codeExampleId: string;
+    commandIndex: number;
+    role: SemanticRole;
+    roleValue: string | null;
+    roleType: RoleType | null;
+    required: boolean;
+}
+interface SearchOptions {
+    language?: string;
+    category?: string;
+    difficulty?: 'beginner' | 'intermediate' | 'advanced';
+    engine?: EngineCompat | null;
+    limit?: number;
+    offset?: number;
+}
+interface TestOptions {
+    language?: string;
+    browsers?: string[];
+    runtimeVersion?: string;
+}
+interface PatternStats {
+    totalPatterns: number;
+    totalTranslations: number;
+    byLanguage: Record<string, {
+        count: number;
+        verifiedCount: number;
+    }>;
+    byCategory: Record<string, number>;
+    avgConfidence: number;
+}
+interface SyncOptions {
+    dryRun?: boolean;
+    verbose?: boolean;
+    limit?: number;
+    languages?: string[];
+}
+interface SyncResult {
+    totalExamples: number;
+    successfulExamples: number;
+    skippedExamples: number;
+    totalTranslations: number;
+    byLanguage: Record<string, number>;
+}
+interface ValidationOptions {
+    verbose?: boolean;
+    languages?: string[];
+}
+interface ValidationResult {
+    total: number;
+    passed: number;
+    failed: number;
+    byLanguage: Record<string, {
+        passed: number;
+        failed: number;
+    }>;
+    failures: Array<{
+        language: string;
+        hyperscript: string;
+        error: string;
+    }>;
+}
+interface DiscoveryResult {
+    totalExamples: number;
+    byComplexity: Record<ComplexityLevel, number>;
+    parseable: number;
+    notParseable: number;
+    commandCoverage: Record<string, {
+        total: number;
+        parseable: number;
+    }>;
+    gaps: string[];
+}
+/**
+ * A hyperscript command definition.
+ */
+interface Command {
+    id: string;
+    name: string;
+    description: string | null;
+    syntax: string | null;
+    purpose: string | null;
+    implicitTarget: string | null;
+    implicitResultTarget: string | null;
+    isBlocking: boolean;
+    hasBody: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * A hyperscript expression definition.
+ */
+interface Expression {
+    id: string;
+    name: string;
+    description: string | null;
+    category: string;
+    evaluatesToType: string | null;
+    precedence: number | null;
+    associativity: string | null;
+    operators: string[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * An operator for an expression.
+ */
+interface ExpressionOperator {
+    id: string;
+    expressionId: string;
+    operator: string;
+}
+/**
+ * A hyperscript keyword definition.
+ */
+interface Keyword {
+    id: string;
+    name: string;
+    description: string | null;
+    contextOfUse: string | null;
+    isOptional: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * A hyperscript feature (top-level construct like on, init, behavior).
+ */
+interface Feature {
+    id: string;
+    name: string;
+    description: string | null;
+    syntax: string | null;
+    trigger: string | null;
+    structureDescription: string | null;
+    scopeImpact: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * A special symbol (me, it, my, you, your).
+ */
+interface SpecialSymbol {
+    id: string;
+    name: string;
+    symbol: string;
+    symbolType: string;
+    description: string | null;
+    typicalValue: string | null;
+    scopeImplications: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Element type for searching across language elements.
+ */
+type LanguageElementType = 'command' | 'expression' | 'keyword' | 'feature' | 'special_symbol';
+/**
+ * A language element (union of all documentation types).
+ */
+type LanguageElement = {
+    type: 'command';
+    element: Command;
+} | {
+    type: 'expression';
+    element: Expression;
+} | {
+    type: 'keyword';
+    element: Keyword;
+} | {
+    type: 'feature';
+    element: Feature;
+} | {
+    type: 'special_symbol';
+    element: SpecialSymbol;
+};
+/**
+ * Statistics for language documentation.
+ */
+interface LanguageDocsStats {
+    commands: number;
+    expressions: number;
+    keywords: number;
+    features: number;
+    specialSymbols: number;
+    expressionOperators: number;
+}
+interface ConnectionOptions {
+    dbPath?: string;
+    readonly?: boolean;
+}
+/**
+ * Main API interface for the Patterns Reference system.
+ */
+interface PatternsReference {
+    getPatternById(id: string): Promise<Pattern | null>;
+    getPatternsByCategory(category: string): Promise<Pattern[]>;
+    getPatternsByCommand(command: string): Promise<Pattern[]>;
+    searchPatterns(query: string, options?: SearchOptions): Promise<Pattern[]>;
+    getTranslation(patternId: string, language: string): Promise<Translation | null>;
+    getAllTranslations(patternId: string): Promise<Translation[]>;
+    verifyTranslation(translation: Translation): Promise<VerificationResult>;
+    getLLMExamples(prompt: string, language?: string, limit?: number): Promise<LLMExample[]>;
+    getStats(): Promise<PatternStats>;
+    close(): void;
+}
+
+export type { ConnectionOptions as C, DiscoveryResult as D, Expression as E, Feature as F, Keyword as K, LanguageElementType as L, PatternsReference as P, RoleType as R, SpecialSymbol as S, Translation as T, VerificationResult as V, WordOrder as W, Command as a, LanguageElement as b, LanguageDocsStats as c, LLMExample as d, Pattern as e, ClassifiedPattern as f, ComplexityLevel as g, EngineCompat as h, TranslationMethod as i, ExpressionOperator as j, SearchOptions as k, TestOptions as l, PatternStats as m, SyncOptions as n, SyncResult as o, ValidationOptions as p, ValidationResult as q, PatternRole as r };

package/dist/index-CBoczxz7.d.ts

@@ -0,0 +1,296 @@
+import { SemanticRole } from '@lokascript/semantic';
+
+/**
+ * Patterns Reference Type Definitions
+ */
+/**
+ * Engine compatibility for a pattern.
+ * - 'hyperscript': only verified for official _hyperscript
+ * - 'lokascript': only verified for lokascript (not backward compatible)
+ * - 'both': verified for both engines
+ * - null: unverified
+ */
+type EngineCompat = 'hyperscript' | 'lokascript' | 'both';
+/**
+ * A pattern from the database (code_examples table).
+ */
+interface Pattern {
+    id: string;
+    title: string;
+    description: string | null;
+    rawCode: string;
+    category: string | null;
+    primaryCommand: string | null;
+    tags: string[];
+    difficulty: 'beginner' | 'intermediate' | 'advanced';
+    engine: EngineCompat | null;
+    createdAt: Date;
+}
+/**
+ * Pattern with computed complexity classification.
+ */
+interface ClassifiedPattern extends Pattern {
+    complexity: ComplexityLevel;
+    lineCount: number;
+    commands: string[];
+}
+type ComplexityLevel = 'simple-command' | 'simple-event' | 'chained-command' | 'multi-line-event' | 'behavior-install' | 'behavior-def' | 'def-function' | 'complex';
+type WordOrder = 'SVO' | 'SOV' | 'VSO' | 'V2';
+type TranslationMethod = 'auto-generated' | 'hand-crafted' | 'verified';
+/**
+ * A translation of a pattern to a specific language.
+ */
+interface Translation {
+    id: number;
+    codeExampleId: string;
+    language: string;
+    hyperscript: string;
+    wordOrder: WordOrder;
+    translationMethod: TranslationMethod;
+    confidence: number;
+    verifiedParses: boolean;
+    verifiedExecutes: boolean;
+    roleAlignmentScore: number | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Result of translation verification.
+ */
+interface VerificationResult {
+    translation: Translation;
+    parseSuccess: boolean;
+    executeSuccess: boolean;
+    errorMessage: string | null;
+    confidence: number;
+    testedAt: Date;
+}
+/**
+ * An LLM example (prompt/completion pair).
+ */
+interface LLMExample {
+    id: number;
+    patternId: string;
+    language: string;
+    prompt: string;
+    completion: string;
+    qualityScore: number;
+    usageCount: number;
+    createdAt: Date;
+}
+
+/**
+ * Role type classification.
+ */
+type RoleType = 'selector' | 'literal' | 'reference' | 'expression' | 'keyword';
+/**
+ * A semantic role extracted from a pattern.
+ */
+interface PatternRole {
+    id: number;
+    codeExampleId: string;
+    commandIndex: number;
+    role: SemanticRole;
+    roleValue: string | null;
+    roleType: RoleType | null;
+    required: boolean;
+}
+interface SearchOptions {
+    language?: string;
+    category?: string;
+    difficulty?: 'beginner' | 'intermediate' | 'advanced';
+    engine?: EngineCompat | null;
+    limit?: number;
+    offset?: number;
+}
+interface TestOptions {
+    language?: string;
+    browsers?: string[];
+    runtimeVersion?: string;
+}
+interface PatternStats {
+    totalPatterns: number;
+    totalTranslations: number;
+    byLanguage: Record<string, {
+        count: number;
+        verifiedCount: number;
+    }>;
+    byCategory: Record<string, number>;
+    avgConfidence: number;
+}
+interface SyncOptions {
+    dryRun?: boolean;
+    verbose?: boolean;
+    limit?: number;
+    languages?: string[];
+}
+interface SyncResult {
+    totalExamples: number;
+    successfulExamples: number;
+    skippedExamples: number;
+    totalTranslations: number;
+    byLanguage: Record<string, number>;
+}
+interface ValidationOptions {
+    verbose?: boolean;
+    languages?: string[];
+}
+interface ValidationResult {
+    total: number;
+    passed: number;
+    failed: number;
+    byLanguage: Record<string, {
+        passed: number;
+        failed: number;
+    }>;
+    failures: Array<{
+        language: string;
+        hyperscript: string;
+        error: string;
+    }>;
+}
+interface DiscoveryResult {
+    totalExamples: number;
+    byComplexity: Record<ComplexityLevel, number>;
+    parseable: number;
+    notParseable: number;
+    commandCoverage: Record<string, {
+        total: number;
+        parseable: number;
+    }>;
+    gaps: string[];
+}
+/**
+ * A hyperscript command definition.
+ */
+interface Command {
+    id: string;
+    name: string;
+    description: string | null;
+    syntax: string | null;
+    purpose: string | null;
+    implicitTarget: string | null;
+    implicitResultTarget: string | null;
+    isBlocking: boolean;
+    hasBody: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * A hyperscript expression definition.
+ */
+interface Expression {
+    id: string;
+    name: string;
+    description: string | null;
+    category: string;
+    evaluatesToType: string | null;
+    precedence: number | null;
+    associativity: string | null;
+    operators: string[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * An operator for an expression.
+ */
+interface ExpressionOperator {
+    id: string;
+    expressionId: string;
+    operator: string;
+}
+/**
+ * A hyperscript keyword definition.
+ */
+interface Keyword {
+    id: string;
+    name: string;
+    description: string | null;
+    contextOfUse: string | null;
+    isOptional: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * A hyperscript feature (top-level construct like on, init, behavior).
+ */
+interface Feature {
+    id: string;
+    name: string;
+    description: string | null;
+    syntax: string | null;
+    trigger: string | null;
+    structureDescription: string | null;
+    scopeImpact: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * A special symbol (me, it, my, you, your).
+ */
+interface SpecialSymbol {
+    id: string;
+    name: string;
+    symbol: string;
+    symbolType: string;
+    description: string | null;
+    typicalValue: string | null;
+    scopeImplications: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Element type for searching across language elements.
+ */
+type LanguageElementType = 'command' | 'expression' | 'keyword' | 'feature' | 'special_symbol';
+/**
+ * A language element (union of all documentation types).
+ */
+type LanguageElement = {
+    type: 'command';
+    element: Command;
+} | {
+    type: 'expression';
+    element: Expression;
+} | {
+    type: 'keyword';
+    element: Keyword;
+} | {
+    type: 'feature';
+    element: Feature;
+} | {
+    type: 'special_symbol';
+    element: SpecialSymbol;
+};
+/**
+ * Statistics for language documentation.
+ */
+interface LanguageDocsStats {
+    commands: number;
+    expressions: number;
+    keywords: number;
+    features: number;
+    specialSymbols: number;
+    expressionOperators: number;
+}
+interface ConnectionOptions {
+    dbPath?: string;
+    readonly?: boolean;
+}
+/**
+ * Main API interface for the Patterns Reference system.
+ */
+interface PatternsReference {
+    getPatternById(id: string): Promise<Pattern | null>;
+    getPatternsByCategory(category: string): Promise<Pattern[]>;
+    getPatternsByCommand(command: string): Promise<Pattern[]>;
+    searchPatterns(query: string, options?: SearchOptions): Promise<Pattern[]>;
+    getTranslation(patternId: string, language: string): Promise<Translation | null>;
+    getAllTranslations(patternId: string): Promise<Translation[]>;
+    verifyTranslation(translation: Translation): Promise<VerificationResult>;
+    getLLMExamples(prompt: string, language?: string, limit?: number): Promise<LLMExample[]>;
+    getStats(): Promise<PatternStats>;
+    close(): void;
+}
+
+export type { ConnectionOptions as C, DiscoveryResult as D, Expression as E, Feature as F, Keyword as K, LanguageElementType as L, PatternsReference as P, RoleType as R, SpecialSymbol as S, Translation as T, VerificationResult as V, WordOrder as W, Command as a, LanguageElement as b, LanguageDocsStats as c, LLMExample as d, Pattern as e, ClassifiedPattern as f, ComplexityLevel as g, EngineCompat as h, TranslationMethod as i, ExpressionOperator as j, SearchOptions as k, TestOptions as l, PatternStats as m, SyncOptions as n, SyncResult as o, ValidationOptions as p, ValidationResult as q, PatternRole as r };