@forgespace/siza-gen 0.2.0 → 0.4.0

package/README.md

@@ -1,24 +1,22 @@
 # @forgespace/siza-gen
 
-Siza AI generation engine — multi-framework code generation,
-component registry, and ML-powered quality scoring.
+Siza AI generation engine — multi-framework code generation, component registry,
+and ML-powered quality scoring.
 
 ## Overview
 
 `@forgespace/siza-gen` is the AI brain extracted from
-[siza-mcp](https://github.com/Forge-Space/ui-mcp). It
-provides:
-
-- **Framework generators** — React, Vue, Angular, Svelte,
-  HTML
-- **Component registry** — 502 curated snippets (357
-  component + 85 animation + 60 backend)
-- **ML quality scoring** — Embeddings, quality validation,
-  anti-generic rules
-- **Feedback system** — Self-learning, pattern promotion,
-  feedback-boosted search
-- **Template compositions** — Pre-built page templates with
-  quality gating
+[siza-mcp](https://github.com/Forge-Space/ui-mcp). It provides:
+
+- **Framework generators** — React, Vue, Angular, Svelte, HTML
+- **Component registry** — 502 curated snippets (357 component + 85 animation +
+  60 backend)
+- **ML quality scoring** — Embeddings, quality validation, anti-generic rules
+- **Feedback system** — Self-learning, pattern promotion, feedback-boosted
+  search
+- **Template compositions** — Pre-built page templates with quality gating
+- **Brand integration** — Transform branding-mcp tokens into design context
+- **LLM providers** — Ollama, OpenAI, Anthropic, Gemini with auto-fallback
 
 ## Installation
 

package/dist/index.d.ts

@@ -3,6 +3,89 @@ import * as pino from 'pino';
 import pino__default, { Logger } from 'pino';
 import { z } from 'zod';
 
+type LLMProviderType = 'ollama' | 'openai' | 'anthropic' | 'gemini';
+interface ILLMConfig {
+    provider: LLMProviderType;
+    model: string;
+    baseUrl?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    maxTokens?: number;
+    temperature?: number;
+}
+interface ILLMGenerateOptions {
+    maxTokens?: number;
+    temperature?: number;
+    systemPrompt?: string;
+    timeoutMs?: number;
+}
+interface ILLMResponse {
+    text: string;
+    model: string;
+    provider: LLMProviderType;
+    tokensUsed?: number;
+    latencyMs: number;
+}
+interface ILLMProvider {
+    readonly type: LLMProviderType;
+    readonly model: string;
+    generate(prompt: string, options?: ILLMGenerateOptions): Promise<ILLMResponse>;
+    isAvailable(): Promise<boolean>;
+}
+declare const DEFAULT_TIMEOUT_MS = 30000;
+declare const DEFAULT_MAX_TOKENS = 1024;
+declare const DEFAULT_TEMPERATURE = 0.3;
+
+declare class OllamaProvider implements ILLMProvider {
+    readonly type: "ollama";
+    readonly model: string;
+    private readonly baseUrl;
+    private readonly defaultTimeout;
+    constructor(opts?: {
+        model?: string;
+        baseUrl?: string;
+        timeoutMs?: number;
+    });
+    generate(prompt: string, options?: ILLMGenerateOptions): Promise<ILLMResponse>;
+    isAvailable(): Promise<boolean>;
+}
+
+declare class OpenAIProvider implements ILLMProvider {
+    readonly type: "openai";
+    readonly model: string;
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly defaultTimeout;
+    constructor(opts: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+        timeoutMs?: number;
+    });
+    generate(prompt: string, options?: ILLMGenerateOptions): Promise<ILLMResponse>;
+    isAvailable(): Promise<boolean>;
+}
+
+declare class AnthropicProvider implements ILLMProvider {
+    readonly type: "anthropic";
+    readonly model: string;
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly defaultTimeout;
+    constructor(opts: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+        timeoutMs?: number;
+    });
+    generate(prompt: string, options?: ILLMGenerateOptions): Promise<ILLMResponse>;
+    isAvailable(): Promise<boolean>;
+}
+
+declare function createProvider(config: ILLMConfig): ILLMProvider;
+declare function detectOllama(baseUrl?: string): Promise<boolean>;
+declare function createProviderWithFallback(config?: ILLMConfig): Promise<ILLMProvider | null>;
+
 /**
  * Type definitions for the ML subsystem.
  */
@@ -405,6 +488,9 @@ declare function getTrainingSummary(db: Database.Database): {
  *
  * Score range: 0-10 (0 = likely rejected, 10 = likely accepted).
  */
+
+declare function setQualityScorerLLM(provider: ILLMProvider | null): void;
+declare function getQualityScorerLLM(): ILLMProvider | null;
 /** Quality score result. */
 interface IQualityScore {
     /** Score from 0-10. */
@@ -452,6 +538,9 @@ declare function isLikelyAccepted(prompt: string, generatedCode: string, params?
  * 2. Expand vague terms into specific design tokens
  * 3. Inject best-practice hints based on component type
  */
+
+declare function setPromptEnhancerLLM(provider: ILLMProvider | null): void;
+declare function getPromptEnhancerLLM(): ILLMProvider | null;
 /** Enhancement result. */
 interface IEnhancedPrompt {
     /** The enhanced prompt text. */
@@ -2110,6 +2199,61 @@ declare class DesignContextStore {
 }
 declare const designContextStore: DesignContextStore;
 
+interface BrandIdentityInput {
+    colors: {
+        primary: {
+            hex: string;
+        };
+        secondary: {
+            hex: string;
+        };
+        accent: {
+            hex: string;
+        };
+        neutral: Array<{
+            hex: string;
+        }>;
+        semantic: {
+            success: {
+                hex: string;
+            };
+            warning: {
+                hex: string;
+            };
+            error: {
+                hex: string;
+            };
+            info: {
+                hex: string;
+            };
+        };
+    };
+    typography: {
+        headingFont: string;
+        bodyFont: string;
+        baseSize: number;
+        steps: Array<{
+            name: string;
+            size: string;
+            lineHeight: string;
+            weight: number;
+        }>;
+    };
+    spacing: {
+        unit: number;
+        values: Record<string, string>;
+    };
+    shadows?: {
+        levels: Record<string, {
+            cssValue: string;
+        }>;
+    };
+    borders?: {
+        radii: Record<string, string>;
+    };
+}
+declare function brandToDesignContext(brand: BrandIdentityInput): Partial<IDesignContext>;
+
 /**
  * Component Libraries Integration
  *
@@ -2366,4 +2510,4 @@ declare function isNetworkError(error: unknown): boolean;
  */
 declare function retry<T>(fn: () => Promise<T>, maxAttempts?: number, delay?: number): Promise<T>;
 
-export { ANIMATION_PRESETS, type AdapterType, AngularGenerator, type AppType, type Architecture, type ArtifactType, type BackendCategory, type BackendFramework, BaseGenerator, COLOR_SYSTEMS, COMPONENT_LIBRARIES, type ComponentCategory, type ComponentLibrary, type ComponentLibraryId, type ComponentLibraryIntegration, type ComponentLibrarySetupOptions, type Config, DEFAULT_COLOR_SYSTEM, DEFAULT_CONTEXT, DEFAULT_DESIGN_CONTEXT, DEFAULT_FONT_PAIRING, DEFAULT_LORA_CONFIG, DEFAULT_PRESET, type DeployTarget, FONT_PAIRINGS, type Framework, GeneratorFactory, HtmlGenerator, type IAccessibilityIssue, type IAccessibilityReport, type IArtifactQuery, type IBackendSnippet, ICON_LIBRARIES, type ICodePattern, type IComponentLibrary, type IComponentQuery, type IComponentSnippet, type IComponentStructure, type IConfigFile, type IDesignAnalysisResult, type IDesignContext, type IDirectoryStructure, type IEmbedding, type IEmbeddingConfig, type IEnhancedPrompt, type IEnhancementContext, type IExplicitFeedbackInput, type IFeedback, type IFigmaDesignToken, type IFigmaVariable, type IGeneratedArtifact, type IGeneratedFile, type IGeneration, type IImageAnalysis, type IImplicitSignal, type ILearningStats, type ILoRAConfig, type IModelPaths, INSPIRATION_SOURCES, type IPatternMatch, type IPresetConfig, type IProjectTemplate, type IPromptClassification, type IQualityScore, type IScaffoldOptions, type IScrapedPage, type IScreenElement, type ISearchResult, type ISimilarityResult, type IStyleContext, type IStyleRecommendation, type ITailwindMapping, type ITemplateSelectionCriteria, type ITrainingExample, type ITrainingStatus, type ITransition, type IValidationResult, type ImageType, type IndustryTag, LAYOUT_PATTERNS, type ModelId, type MoodTag, PRESETS, type PageTemplateType, type ProjectType, ReactGenerator, SPACING_SYSTEM, type Scale, type StateManagement$1 as StateManagement, SvelteGenerator, TYPE_SCALE, type VisualStyleId, VueGenerator, applyVisualStyle, buildPromptEnhancerData, buildQualityScorerData, buildStyleRecommenderData, cancelTrainingJob, capitalize, checkTrainingReadiness, classifyPromptPair, classifyPromptText, cleanJsxSyntax, clearAllMicroInteractions, clearCompositions, clearHistory as clearDiversityHistory, clearRegistry, clearSessionCache, closeDatabase, composePageFromTemplate, composeSection, configureEmbeddings, configureModelDir, convertPathForFramework, convertStyleObjectToString, cosineSimilarity, createEmbedding, createError, createLogger, createTrainingJob, customizeTemplate, deleteArtifact, deleteEmbeddings, designContextStore, embed, embedBatch, enhancePrompt, enhancePromptWithRAG, enhanceWithRules, ensureDirectories, ensurePatternsTable, escapeHtml, exportForAdapter, exportRawExamples, exportTrainingData, expressApiTemplate, extractDesignPatterns, extractSkeleton, feedbackBoostedSearch, findBestComposition, findSimilar, fingerprint, fullstackMonoTemplate, generateArtifactId, generateComponent, generateComponentFromLibrary, generateRandomId, getAdapterPath, getAggregateScore, getAllCompositions, getAllInteractions, getAllJobStatuses, getAllPacks, getAllSnippets, getAllTemplates, getAnimationsByCategory, getArtifact, getArtifactCount, getAvailableComponentLibraries, getAvailableComponentsForLibrary, getAvailablePatternsForLibrary, getAvailableTypes, getBaseDir, getBestMatch, getBestMatchWithFeedback, getByCategory, getByIndustry, getByMood, getColorSystem, getColorSystemsByMood, getComponentLibrariesForFramework, getComponentLibrary, getComposition, getConfig, getDatabase, getDefaultIconLibrary, getDiskUsage, getEmbedding, getEmbeddingConfig, getEmbeddingCount, getFallbackDesignReference, getFeedbackBoost, getFeedbackCount, getFeedbackStats, getFileExtension, getFileName, getFontPairing, getFontPairingsByMood, getInspirationByCategory, getInspirationByPriority, getInteractionsByCategory, getLatestJobStatus, getLayoutPattern, getLayoutPatternsByUseCase, getLearningStats, getMicroInteraction, getModelDownloadUrl, getModelPath, getModelPaths, getPack, getPatternStats, getPreset, getPrimaryDesignReference, getPromotablePatternsFromDb, getPromotionCandidates, getRecentArtifacts, getRecommendations, getRecommendedLibrary, getRegistrySize, getSimilarArtifacts, getSnippetById, getTemplate, getTopArtifacts, getTrainingDataPath, getTrainingSummary, getVariants, groupBy, hasEnoughData, hashSkeleton, htmlToJsxAttributes, includesCaseInsensitive, initializeBackendRegistry, initializeInteractions, initializeRegistry, injectAnimations, isAdapterAvailable, isArray, isDuplicateConsecutive, isFunction, isLikelyAccepted, isModelAvailable, isModelLoaded, isNetworkError, isNumber, isObject, isPromotable, isString, isTraining, isValidComponentName, isValidEmail, isValidHexColor, isValidProjectName, isValidUrl, jsxToHtml, jsxToHtmlAttributes, jsxToSvelte, listAdapters, listModels, listPresets, loadConfig, loadEmbeddings, logger, mergeStyles, needsEnhancement, nextAppTemplate, nextSaasTemplate, parseStyleString, pluralize, promotePattern, queryArtifacts, reactEventsToHtml, reactEventsToSvelte, reactSpaTemplate, recommendStyle, recordGeneration as recordDiversityGeneration, recordExplicitFeedback, recordGeneratedArtifact, recordGeneration$1 as recordGeneration, recordPattern, reduxToolkitPattern as reduxToolkitPatterns, registerComposition, registerInteraction, registerInteractions, registerPack, registerSnippet, registerSnippets, resetSchemaInit, retry, runPromotionCycle, safeJSONParse, sanitizeClassName, scoreQuality, scoreQualityWithRAG, searchBackendSnippets, searchComponents, searchPacks, selectTemplate, semanticSearch, setupComponentLibraryProject, sortBy, startTrainingJob, stateManagementPatterns, storeArtifact, storeDesignLearning, storeEmbedding, storeEmbeddings, suggestDiverseVariant, tanstackQueryPattern as tanstackQueryPatterns, templateList, templates, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, triggerPatternPromotion, truncate, unique, unloadModel, updateFeedbackScore, updateJobStatus, updateQualityScore, validateSnippet, validateSnippetStrict, writeJsonl, zustandPatterns };
+export { ANIMATION_PRESETS, type AdapterType, AngularGenerator, AnthropicProvider, type AppType, type Architecture, type ArtifactType, type BackendCategory, type BackendFramework, BaseGenerator, type BrandIdentityInput, COLOR_SYSTEMS, COMPONENT_LIBRARIES, type ComponentCategory, type ComponentLibrary, type ComponentLibraryId, type ComponentLibraryIntegration, type ComponentLibrarySetupOptions, type Config, DEFAULT_COLOR_SYSTEM, DEFAULT_CONTEXT, DEFAULT_DESIGN_CONTEXT, DEFAULT_FONT_PAIRING, DEFAULT_LORA_CONFIG, DEFAULT_MAX_TOKENS, DEFAULT_PRESET, DEFAULT_TEMPERATURE, DEFAULT_TIMEOUT_MS, type DeployTarget, FONT_PAIRINGS, type Framework, GeneratorFactory, HtmlGenerator, type IAccessibilityIssue, type IAccessibilityReport, type IArtifactQuery, type IBackendSnippet, ICON_LIBRARIES, type ICodePattern, type IComponentLibrary, type IComponentQuery, type IComponentSnippet, type IComponentStructure, type IConfigFile, type IDesignAnalysisResult, type IDesignContext, type IDirectoryStructure, type IEmbedding, type IEmbeddingConfig, type IEnhancedPrompt, type IEnhancementContext, type IExplicitFeedbackInput, type IFeedback, type IFigmaDesignToken, type IFigmaVariable, type IGeneratedArtifact, type IGeneratedFile, type IGeneration, type IImageAnalysis, type IImplicitSignal, type ILLMConfig, type ILLMGenerateOptions, type ILLMProvider, type ILLMResponse, type ILearningStats, type ILoRAConfig, type IModelPaths, INSPIRATION_SOURCES, type IPatternMatch, type IPresetConfig, type IProjectTemplate, type IPromptClassification, type IQualityScore, type IScaffoldOptions, type IScrapedPage, type IScreenElement, type ISearchResult, type ISimilarityResult, type IStyleContext, type IStyleRecommendation, type ITailwindMapping, type ITemplateSelectionCriteria, type ITrainingExample, type ITrainingStatus, type ITransition, type IValidationResult, type ImageType, type IndustryTag, LAYOUT_PATTERNS, type LLMProviderType, type ModelId, type MoodTag, OllamaProvider, OpenAIProvider, PRESETS, type PageTemplateType, type ProjectType, ReactGenerator, SPACING_SYSTEM, type Scale, type StateManagement$1 as StateManagement, SvelteGenerator, TYPE_SCALE, type VisualStyleId, VueGenerator, applyVisualStyle, brandToDesignContext, buildPromptEnhancerData, buildQualityScorerData, buildStyleRecommenderData, cancelTrainingJob, capitalize, checkTrainingReadiness, classifyPromptPair, classifyPromptText, cleanJsxSyntax, clearAllMicroInteractions, clearCompositions, clearHistory as clearDiversityHistory, clearRegistry, clearSessionCache, closeDatabase, composePageFromTemplate, composeSection, configureEmbeddings, configureModelDir, convertPathForFramework, convertStyleObjectToString, cosineSimilarity, createEmbedding, createError, createLogger, createProvider, createProviderWithFallback, createTrainingJob, customizeTemplate, deleteArtifact, deleteEmbeddings, designContextStore, detectOllama, embed, embedBatch, enhancePrompt, enhancePromptWithRAG, enhanceWithRules, ensureDirectories, ensurePatternsTable, escapeHtml, exportForAdapter, exportRawExamples, exportTrainingData, expressApiTemplate, extractDesignPatterns, extractSkeleton, feedbackBoostedSearch, findBestComposition, findSimilar, fingerprint, fullstackMonoTemplate, generateArtifactId, generateComponent, generateComponentFromLibrary, generateRandomId, getAdapterPath, getAggregateScore, getAllCompositions, getAllInteractions, getAllJobStatuses, getAllPacks, getAllSnippets, getAllTemplates, getAnimationsByCategory, getArtifact, getArtifactCount, getAvailableComponentLibraries, getAvailableComponentsForLibrary, getAvailablePatternsForLibrary, getAvailableTypes, getBaseDir, getBestMatch, getBestMatchWithFeedback, getByCategory, getByIndustry, getByMood, getColorSystem, getColorSystemsByMood, getComponentLibrariesForFramework, getComponentLibrary, getComposition, getConfig, getDatabase, getDefaultIconLibrary, getDiskUsage, getEmbedding, getEmbeddingConfig, getEmbeddingCount, getFallbackDesignReference, getFeedbackBoost, getFeedbackCount, getFeedbackStats, getFileExtension, getFileName, getFontPairing, getFontPairingsByMood, getInspirationByCategory, getInspirationByPriority, getInteractionsByCategory, getLatestJobStatus, getLayoutPattern, getLayoutPatternsByUseCase, getLearningStats, getMicroInteraction, getModelDownloadUrl, getModelPath, getModelPaths, getPack, getPatternStats, getPreset, getPrimaryDesignReference, getPromotablePatternsFromDb, getPromotionCandidates, getPromptEnhancerLLM, getQualityScorerLLM, getRecentArtifacts, getRecommendations, getRecommendedLibrary, getRegistrySize, getSimilarArtifacts, getSnippetById, getTemplate, getTopArtifacts, getTrainingDataPath, getTrainingSummary, getVariants, groupBy, hasEnoughData, hashSkeleton, htmlToJsxAttributes, includesCaseInsensitive, initializeBackendRegistry, initializeInteractions, initializeRegistry, injectAnimations, isAdapterAvailable, isArray, isDuplicateConsecutive, isFunction, isLikelyAccepted, isModelAvailable, isModelLoaded, isNetworkError, isNumber, isObject, isPromotable, isString, isTraining, isValidComponentName, isValidEmail, isValidHexColor, isValidProjectName, isValidUrl, jsxToHtml, jsxToHtmlAttributes, jsxToSvelte, listAdapters, listModels, listPresets, loadConfig, loadEmbeddings, logger, mergeStyles, needsEnhancement, nextAppTemplate, nextSaasTemplate, parseStyleString, pluralize, promotePattern, queryArtifacts, reactEventsToHtml, reactEventsToSvelte, reactSpaTemplate, recommendStyle, recordGeneration as recordDiversityGeneration, recordExplicitFeedback, recordGeneratedArtifact, recordGeneration$1 as recordGeneration, recordPattern, reduxToolkitPattern as reduxToolkitPatterns, registerComposition, registerInteraction, registerInteractions, registerPack, registerSnippet, registerSnippets, resetSchemaInit, retry, runPromotionCycle, safeJSONParse, sanitizeClassName, scoreQuality, scoreQualityWithRAG, searchBackendSnippets, searchComponents, searchPacks, selectTemplate, semanticSearch, setPromptEnhancerLLM, setQualityScorerLLM, setupComponentLibraryProject, sortBy, startTrainingJob, stateManagementPatterns, storeArtifact, storeDesignLearning, storeEmbedding, storeEmbeddings, suggestDiverseVariant, tanstackQueryPattern as tanstackQueryPatterns, templateList, templates, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, triggerPatternPromotion, truncate, unique, unloadModel, updateFeedbackScore, updateJobStatus, updateQualityScore, validateSnippet, validateSnippetStrict, writeJsonl, zustandPatterns };