@almadar/skills 1.2.0 → 1.2.1

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { OrbitalSchema } from '@almadar/core';
+
 /**
  * Skill Generator Types
  *
@@ -298,23 +300,38 @@ declare function getPortableOrbitalOutputSection(): string;
 declare function getOrbitalConnectivitySection(): string;
 
 /**
- * Atomic Composition Design Guide
+ * Atomic Composition Design Guide (v5.0)
  *
- * Teaches the LLM to compose atoms, molecules, and organisms within
- * VStack/HStack/Box layout primitives to produce rich, unique views.
+ * Teaches the LLM to compose sophisticated views using atomic design principles.
+ * Every render-ui effect must satisfy the Five Rules of Sophisticated Composition.
  *
- * Replaces the old pattern-selection-by-intent approach with atomic
- * design composition — the same approach used by template authors in
- * packages/almadar-ui/components/templates/.
+ * v5.0: Added mandatory composition rules, validation checklist, and theme enforcement.
  *
  * @packageDocumentation
  */
 /**
- * Get the render-ui atomic composition guide.
- * Covers syntax, slot strategy, atomic hierarchy, composition rules, and domain recipes.
+ * Get the render-ui atomic composition guide with mandatory rules.
  */
 declare function getRenderUIDesignGuide(): string;
 
+/**
+ * Theme Variable System Guide
+ *
+ * Teaches the LLM to use CSS theme variables for all visual properties.
+ * Enforces consistent theming across all generated schemas.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Get the theme variable system guide.
+ * Covers colors, spacing, radius, and shadows with mandatory enforcement rules.
+ */
+declare function getThemeGuide(): string;
+/**
+ * Get banned properties that should never be used.
+ */
+declare function getBannedProps(): string;
+
 /**
  * Custom Trait Guidance Section
  *
@@ -471,6 +488,28 @@ declare function getUsesImportSection(): string;
  */
 declare function getUsesImportCompact(): string;
 
+/**
+ * Bindings Guide
+ *
+ * Generates binding documentation from the source of truth in @almadar/core.
+ * This ensures the skill guidance matches the actual compiler validation.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Generate binding documentation for skill prompts.
+ * Derived from BINDING_DOCS in @almadar/core - single source of truth.
+ */
+declare function getBindingsGuide(): string;
+/**
+ * Get compact binding reference (one-liner for tables).
+ */
+declare function getBindingsCompact(): string;
+/**
+ * Get binding validation rules for specific contexts.
+ */
+declare function getBindingContextRules(): string;
+
 /**
  * Generation Prompts
  *
@@ -543,4 +582,82 @@ declare function getFieldTypesCompact(): string;
  */
 declare function getKeyBehaviorsReference(): string;
 
-export { type GeneratedSkill, type SkillFrontmatter, formatFrontmatter, generateAllBuilderSkills, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
+/**
+ * Composition Quality Evaluation Framework
+ *
+ * Evaluates LLM providers' ability to generate sophisticated render-ui effects
+ * that meet the Five Rules of Sophisticated Composition.
+ *
+ * @packageDocumentation
+ */
+
+interface EvalCase {
+    name: string;
+    description: string;
+    prompt: string;
+    expectedPatterns: string[];
+    minScore: number;
+    domain: 'general' | 'healthcare' | 'ecommerce' | 'project-management';
+    rubric?: {
+        structure: Record<string, number>;
+        composition: Record<string, number>;
+        theme: Record<string, number>;
+        quality: Record<string, number>;
+    };
+}
+interface EvalResult {
+    caseName: string;
+    provider: string;
+    score: number;
+    passed: boolean;
+    breakdown: ScoreBreakdown;
+    validationErrors: string[];
+    validationWarnings: string[];
+    schema?: OrbitalSchema;
+}
+interface ScoreBreakdown {
+    structure: number;
+    composition: number;
+    theme: number;
+    quality: number;
+}
+interface CompositionMetrics {
+    renderUICount: number;
+    atomTypes: string[];
+    moleculeTypes: string[];
+    organismTypes: string[];
+    layoutRoot: string | null;
+    nestingDepth: number;
+    sectionCount: number;
+    themeVariableUsage: number;
+    hardcodedValues: string[];
+}
+declare const EVAL_CASES: EvalCase[];
+/**
+ * Analyze the composition metrics of a schema.
+ */
+declare function analyzeComposition(schema: OrbitalSchema): CompositionMetrics;
+/**
+ * Calculate total score (0-100)
+ */
+declare function calculateTotalScore(schema: OrbitalSchema, testCase: EvalCase, validationErrors: string[]): {
+    score: number;
+    breakdown: ScoreBreakdown;
+};
+interface ProviderComparison {
+    provider: string;
+    averageScore: number;
+    cases: {
+        caseName: string;
+        score: number;
+        passed: boolean;
+    }[];
+    strengths: string[];
+    weaknesses: string[];
+}
+/**
+ * Generate comparison matrix for all providers.
+ */
+declare function generateComparisonMatrix(comparisons: ProviderComparison[]): string;
+
+export { type CompositionMetrics, EVAL_CASES, type EvalCase, type EvalResult, type GeneratedSkill, type ProviderComparison, type ScoreBreakdown, type SkillFrontmatter, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };