@hypercli/core 0.1.1

package/dist/parsers/template-parser.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Template.yml Parser
+ *
+ * Parses and validates template.yml files to extract action definitions
+ * and variable configurations for code generation
+ */
+import type { TemplateConfig, TemplateVariable } from "../types/template.js";
+export interface RecipeConfig {
+    name: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    category?: string;
+    tags?: string[];
+    variables: Record<string, TemplateVariable>;
+    steps: any[];
+    examples?: any[];
+    dependencies?: any[];
+    outputs?: string[];
+    engines?: Record<string, string>;
+    hooks?: any;
+    settings?: any;
+    composition?: any;
+}
+export type ToolType = "template" | "action" | "codemod" | "recipe" | "shell" | "prompt" | "sequence" | "parallel";
+export type RecipeStepUnion = any;
+/**
+ * Extended template config used internally by the parser.
+ * Adds Recipe Step System fields that go beyond a plain template config.
+ */
+export interface ParsedTemplateConfig extends TemplateConfig {
+    steps?: RecipeStepUnion[];
+    settings?: {
+        timeout?: number;
+        retries?: number;
+        continueOnError?: boolean;
+        maxParallelSteps?: number;
+        workingDir?: string;
+    };
+}
+export interface ParsedTemplate {
+    config: ParsedTemplateConfig;
+    filePath: string;
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare class TemplateParser {
+    private static readonly SUPPORTED_VERSIONS;
+    private static readonly VALID_VARIABLE_TYPES;
+    private static readonly VALID_TOOL_TYPES;
+    /**
+     * Parse a template.yml file and return validated configuration
+     */
+    static parseTemplateFile(filePath: string): Promise<ParsedTemplate>;
+    /**
+     * Parse all template.yml files in a directory
+     */
+    static parseTemplateDirectory(dirPath: string): Promise<ParsedTemplate[]>;
+    /**
+     * Validate template configuration and build normalized config object
+     */
+    private static validateAndBuildConfig;
+    /**
+     * Validate variables section of template configuration
+     */
+    private static validateVariables;
+    /**
+     * Validate individual variable configuration
+     */
+    private static validateVariable;
+    /**
+     * Validate examples section
+     */
+    private static validateExamples;
+    /**
+     * Validate variable value against template variable definition
+     */
+    static validateVariableValue(varName: string, value: any, variable: TemplateVariable): {
+        isValid: boolean;
+        error?: string;
+    };
+    /**
+     * Get resolved variable value (with default if not provided)
+     */
+    static getResolvedValue(value: any, variable: TemplateVariable): any;
+    /**
+     * Validate recipe steps array (Recipe Step System)
+     */
+    private static validateSteps;
+    /**
+     * Validate individual recipe step
+     */
+    private static validateStep;
+    /**
+     * Validate template step configuration
+     */
+    private static validateTemplateStep;
+    /**
+     * Validate action step configuration
+     */
+    private static validateActionStep;
+    /**
+     * Validate codemod step configuration
+     */
+    private static validateCodeModStep;
+    /**
+     * Validate recipe step configuration
+     */
+    private static validateRecipeStep;
+    /**
+     * Validate step dependencies for circular references
+     */
+    private static validateStepDependencies;
+    /**
+     * Validate that step dependencies reference existing steps
+     */
+    private static validateStepDependencyReferences;
+    /**
+     * Basic validation of condition expressions
+     */
+    private static validateConditionExpression;
+    /**
+     * Validate recipe execution settings
+     */
+    private static validateSettings;
+    /**
+     * Check if this configuration uses the Recipe Step System
+     */
+    static isRecipeConfig(config: ParsedTemplateConfig): config is ParsedTemplateConfig & {
+        steps: RecipeStepUnion[];
+    };
+    /**
+     * Convert a TemplateConfig to RecipeConfig (Recipe Step System)
+     */
+    static toRecipeConfig(templateConfig: ParsedTemplateConfig): RecipeConfig | null;
+    /**
+     * Validate that step configuration matches expected tool schema
+     */
+    static validateStepToolConfiguration(step: RecipeStepUnion, errors: string[], warnings: string[]): void;
+}
+//# sourceMappingURL=template-parser.d.ts.map

package/dist/parsers/template-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/template-parser.ts"],"names":[],"mappings":"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"}