@almadar/skills 1.1.3 → 1.2.1

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { OrbitalSchema } from '@almadar/core';
+
 /**
  * Skill Generator Types
  *
@@ -105,35 +107,6 @@ declare function generateKflowOrbitalFixingSkill(): GeneratedSkill;
  */
 declare function generateDomainLanguageSkill(): GeneratedSkill;
 
-/**
- * KFlow Design Skill Generator
- *
- * Generates the kflow-design skill for render-ui authoring.
- * This is a focused ~10K skill that operates at the transition level,
- * producing rich render-ui effects using the full pattern catalog.
- *
- * Unlike kflow-orbitals (which focuses on structure), this skill
- * focuses entirely on UI design decisions: pattern selection,
- * slot composition, layout nesting, and domain-aware styling.
- *
- * @packageDocumentation
- */
-
-/**
- * Generate the kflow-design skill.
- *
- * Produces a focused ~10K skill for render-ui authoring.
- * Used by the design_transition tool to produce rich UI effects.
- */
-declare function generateKflowDesignSkill(): GeneratedSkill;
-/**
- * Get design skill stats for comparison.
- */
-declare function getDesignSkillStats(): {
-    lines: number;
-    chars: number;
-};
-
 /**
  * Lean Orbital Skill Generator
  *
@@ -238,20 +211,19 @@ declare function generateLeanFixingSkill(options?: LeanFixingSkillOptions): stri
 /**
  * Skill Generators for Builder Client
  *
- * Re-exports the 6 core skills used by the builder client:
- * 1. kflow-orbitals (standard JSON generation)
+ * Re-exports the 5 core skills used by the builder client:
+ * 1. kflow-orbitals (standard JSON generation with atomic composition)
  * 2. kflow-orbital-fixing (standard fixing)
  * 3. kflow-lean-orbitals (lean domain language generation)
  * 4. kflow-lean-fixing (lean fixing)
  * 5. domain-language (ODL understanding/summarization)
- * 6. kflow-design (render-ui design for transitions)
  *
  * @packageDocumentation
  */
 
 /**
  * Generate all builder client skills.
- * These are the 6 skills actually used by the builder UI.
+ * These are the 5 skills actually used by the builder UI.
  */
 declare function generateAllBuilderSkills(): GeneratedSkill[];
 
@@ -328,22 +300,38 @@ declare function getPortableOrbitalOutputSection(): string;
 declare function getOrbitalConnectivitySection(): string;
 
 /**
- * Pattern Design Guide Section
+ * Atomic Composition Design Guide (v5.0)
  *
- * Replaces the 380-char getRenderUIQuickRef() with actionable guidance
- * on pattern selection, composition recipes, and slot strategy.
+ * Teaches the LLM to compose sophisticated views using atomic design principles.
+ * Every render-ui effect must satisfy the Five Rules of Sophisticated Composition.
  *
- * Target: ~2,500 chars — focused entirely on helping the LLM produce
- * rich, varied render-ui effects instead of defaulting to entity-table.
+ * v5.0: Added mandatory composition rules, validation checklist, and theme enforcement.
  *
  * @packageDocumentation
  */
 /**
- * Get the render-ui design guide.
- * Covers syntax, slot strategy, pattern-by-intent, and composition 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
  *
@@ -500,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
  *
@@ -572,4 +582,82 @@ declare function getFieldTypesCompact(): string;
  */
 declare function getKeyBehaviorsReference(): string;
 
-export { type GeneratedSkill, type SkillFrontmatter, formatFrontmatter, generateAllBuilderSkills, generateDomainLanguageSkill, generateKflowDesignSkill, 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, getDesignSkillStats, 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 };