@specverse/engine-realize 3.5.3

package/libs/instance-factories/views/templates/shared/base-generator.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Base Generator - Abstract Class for Framework Generators
+ *
+ * Provides shared functionality for React, Vue, Svelte, Angular, and Runtime generators.
+ * Enforces architectural constraints (nesting depth, state management) while allowing
+ * framework-specific implementation details.
+ *
+ * Architecture:
+ * - Shared: Component tree rendering, property mapping, nesting enforcement
+ * - Abstract: Syntax generation, file structure, imports (framework-specific)
+ * - Constraints: MAX_DEPTH = 3, basic state only, common properties only
+ */
+import { PropertyTarget } from './property-mapper.js';
+import { FrameworkTarget } from './syntax-mapper.js';
+import { AtomicComponentDefinition } from './atomic-components-registry.js';
+import type { ComponentAdapter } from './adapter-types.js';
+/**
+ * UI Component specification from SpecVerse view definition
+ */
+export interface UIComponent {
+    type: string;
+    properties?: Record<string, any>;
+    children?: UIComponent[];
+    dataSource?: string;
+    condition?: string;
+}
+/**
+ * View specification from SpecVerse
+ */
+export interface ViewSpec {
+    name: string;
+    description?: string;
+    components: Record<string, UIComponent>;
+    state?: Record<string, StateDefinition>;
+    events?: Record<string, EventDefinition>;
+}
+/**
+ * State variable definition
+ */
+export interface StateDefinition {
+    type: string;
+    initial: any;
+    description?: string;
+}
+/**
+ * Event handler definition
+ */
+export interface EventDefinition {
+    params?: string;
+    body: string;
+    description?: string;
+}
+/**
+ * Component rendering context
+ */
+export interface RenderContext {
+    depth: number;
+    path: string[];
+    parentComponent?: string;
+    dataContext?: string;
+}
+/**
+ * Generation result
+ */
+export interface GenerationResult {
+    code: string;
+    imports: string[];
+    warnings: string[];
+}
+/**
+ * Generator configuration
+ */
+export interface GeneratorConfig {
+    target: PropertyTarget;
+    framework: FrameworkTarget;
+    maxDepth?: number;
+    enableWarnings?: boolean;
+}
+/**
+ * Base generator for all framework implementations
+ *
+ * Provides shared logic for:
+ * - Component tree rendering with depth enforcement
+ * - Property mapping via property-mapper
+ * - Nesting validation and flattening
+ * - State and event management
+ *
+ * Framework-specific subclasses must implement:
+ * - generateImports(): Framework-specific import statements
+ * - generateComponent(): Framework-specific component structure
+ * - generateState(): Framework-specific state declarations
+ * - generateEvents(): Framework-specific event handlers
+ */
+export declare abstract class BaseComponentGenerator {
+    protected readonly config: GeneratorConfig;
+    protected readonly adapter: ComponentAdapter;
+    protected readonly MAX_DEPTH: number;
+    protected readonly ENABLE_WARNINGS: boolean;
+    protected warnings: string[];
+    protected imports: Set<string>;
+    constructor(adapter: ComponentAdapter, config: GeneratorConfig);
+    /**
+     * Generate code for a complete view specification
+     *
+     * @param viewSpec - View specification from SpecVerse
+     * @returns Generation result with code, imports, and warnings
+     */
+    generate(viewSpec: ViewSpec): GenerationResult;
+    /**
+     * Render all components in the view
+     */
+    protected generateComponentTree(components: Record<string, UIComponent>): string;
+    /**
+     * Render a single component with depth tracking and nesting enforcement
+     *
+     * This is the core shared logic - applies to ALL frameworks
+     */
+    protected renderComponent(component: UIComponent, context: RenderContext): string;
+    /**
+     * Map component properties using property-mapper
+     */
+    protected mapComponentProperties(component: UIComponent, componentDef: AtomicComponentDefinition): Record<string, any>;
+    /**
+     * Render child components with incremented depth
+     */
+    protected renderChildren(children: UIComponent[], parentContext: RenderContext): string;
+    /**
+     * Render conditional component using syntax-mapper
+     */
+    protected renderConditional(component: UIComponent, mappedProps: Record<string, any>, context: RenderContext): string;
+    /**
+     * Render list (loop) component using syntax-mapper
+     */
+    protected renderList(component: UIComponent, mappedProps: Record<string, any>, context: RenderContext): string;
+    /**
+     * Flatten component when depth exceeded
+     *
+     * Extracts nested children into sibling components to reduce nesting
+     */
+    protected renderFlattened(component: UIComponent, context: RenderContext): string;
+    /**
+     * Delegate to adapter for actual component rendering
+     */
+    protected renderAdapterComponent(type: string, properties: Record<string, any>, children: string | undefined, context: RenderContext): string;
+    /**
+     * Get component name for import/usage
+     */
+    protected getComponentName(type: string): string;
+    /**
+     * Get item variable name for loop rendering
+     */
+    protected getItemName(dataSource: string): string;
+    /**
+     * Get key property for list items
+     */
+    protected getKeyProperty(component: UIComponent): string;
+    /**
+     * Format properties for inline rendering
+     */
+    protected formatProps(properties: Record<string, any>): string;
+    /**
+     * Add warning message
+     */
+    protected addWarning(message: string): void;
+    /**
+     * Reset generator state for new generation
+     */
+    protected reset(): void;
+    /**
+     * Add import statement
+     */
+    protected addImport(importStatement: string): void;
+    /**
+     * Generate import statements for the framework
+     *
+     * @param viewSpec - View specification
+     * @returns Import statements code
+     */
+    protected abstract generateImports(viewSpec: ViewSpec): string;
+    /**
+     * Generate complete component code with framework-specific structure
+     *
+     * @param parts - Component parts (imports, state, events, components)
+     * @returns Complete component code
+     */
+    protected abstract generateComponent(parts: {
+        name: string;
+        imports: string;
+        state: string;
+        events: string;
+        components: string;
+    }): string;
+    /**
+     * Generate state declarations using framework-specific syntax
+     *
+     * @param state - State definitions
+     * @returns State declaration code
+     */
+    protected abstract generateState(state: Record<string, StateDefinition>): string;
+    /**
+     * Generate event handlers using framework-specific syntax
+     *
+     * @param events - Event definitions
+     * @returns Event handler code
+     */
+    protected abstract generateEvents(events: Record<string, EventDefinition>): string;
+    /**
+     * Get file extension for the framework
+     *
+     * @returns File extension (e.g., '.tsx', '.vue', '.svelte')
+     */
+    abstract getFileExtension(): string;
+    /**
+     * Get additional files that need to be generated (e.g., CSS, types)
+     *
+     * @param viewSpec - View specification
+     * @returns Map of filename to content
+     */
+    abstract getAdditionalFiles(viewSpec: ViewSpec): Record<string, string>;
+}
+/**
+ * Validate component nesting depth
+ *
+ * @param component - Component to validate
+ * @param maxDepth - Maximum allowed depth
+ * @returns Validation result with depth and issues
+ */
+export declare function validateNestingDepth(component: UIComponent, maxDepth?: number): {
+    valid: boolean;
+    actualDepth: number;
+    issues: string[];
+};
+/**
+ * Extract all component types used in a view
+ *
+ * @param components - Component tree
+ * @returns Set of component types
+ */
+export declare function extractComponentTypes(components: Record<string, UIComponent>): Set<string>;
+/**
+ * Count total components in a view
+ *
+ * @param components - Component tree
+ * @returns Component count
+ */
+export declare function countComponents(components: Record<string, UIComponent>): number;
+//# sourceMappingURL=base-generator.d.ts.map

package/libs/instance-factories/views/templates/shared/base-generator.d.ts.map

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

package/libs/instance-factories/views/templates/shared/base-generator.js

@@ -0,0 +1,363 @@
+/**
+ * Base Generator - Abstract Class for Framework Generators
+ *
+ * Provides shared functionality for React, Vue, Svelte, Angular, and Runtime generators.
+ * Enforces architectural constraints (nesting depth, state management) while allowing
+ * framework-specific implementation details.
+ *
+ * Architecture:
+ * - Shared: Component tree rendering, property mapping, nesting enforcement
+ * - Abstract: Syntax generation, file structure, imports (framework-specific)
+ * - Constraints: MAX_DEPTH = 3, basic state only, common properties only
+ */
+import { mapProperties } from './property-mapper.js';
+import { getSyntaxPattern } from './syntax-mapper.js';
+import { ATOMIC_COMPONENTS_REGISTRY } from './atomic-components-registry.js';
+// ============================================================================
+// Base Generator Abstract Class
+// ============================================================================
+/**
+ * Base generator for all framework implementations
+ *
+ * Provides shared logic for:
+ * - Component tree rendering with depth enforcement
+ * - Property mapping via property-mapper
+ * - Nesting validation and flattening
+ * - State and event management
+ *
+ * Framework-specific subclasses must implement:
+ * - generateImports(): Framework-specific import statements
+ * - generateComponent(): Framework-specific component structure
+ * - generateState(): Framework-specific state declarations
+ * - generateEvents(): Framework-specific event handlers
+ */
+export class BaseComponentGenerator {
+    // Configuration
+    config;
+    adapter;
+    // Architectural constraints
+    MAX_DEPTH;
+    ENABLE_WARNINGS;
+    // Tracking
+    warnings = [];
+    imports = new Set();
+    constructor(adapter, config) {
+        this.adapter = adapter;
+        this.config = config;
+        this.MAX_DEPTH = config.maxDepth ?? 3;
+        this.ENABLE_WARNINGS = config.enableWarnings ?? true;
+    }
+    // ============================================================================
+    // Public API
+    // ============================================================================
+    /**
+     * Generate code for a complete view specification
+     *
+     * @param viewSpec - View specification from SpecVerse
+     * @returns Generation result with code, imports, and warnings
+     */
+    generate(viewSpec) {
+        this.reset();
+        // Generate imports
+        const importStatements = this.generateImports(viewSpec);
+        // Generate state declarations
+        const stateCode = viewSpec.state
+            ? this.generateState(viewSpec.state)
+            : '';
+        // Generate event handlers
+        const eventsCode = viewSpec.events
+            ? this.generateEvents(viewSpec.events)
+            : '';
+        // Generate component tree
+        const componentsCode = this.generateComponentTree(viewSpec.components);
+        // Generate complete component
+        const code = this.generateComponent({
+            name: viewSpec.name,
+            imports: importStatements,
+            state: stateCode,
+            events: eventsCode,
+            components: componentsCode
+        });
+        return {
+            code,
+            imports: Array.from(this.imports),
+            warnings: this.warnings
+        };
+    }
+    // ============================================================================
+    // Shared Component Rendering (Framework-Agnostic)
+    // ============================================================================
+    /**
+     * Render all components in the view
+     */
+    generateComponentTree(components) {
+        const rendered = Object.entries(components).map(([name, component]) => {
+            return this.renderComponent(component, {
+                depth: 0,
+                path: [name],
+                dataContext: undefined
+            });
+        });
+        return rendered.join('\n\n');
+    }
+    /**
+     * Render a single component with depth tracking and nesting enforcement
+     *
+     * This is the core shared logic - applies to ALL frameworks
+     */
+    renderComponent(component, context) {
+        // Depth enforcement
+        if (context.depth > this.MAX_DEPTH) {
+            this.addWarning(`Component at path ${context.path.join('.')} exceeds max depth (${this.MAX_DEPTH}). ` +
+                `Flattening to maintain readability.`);
+            return this.renderFlattened(component, context);
+        }
+        // Get component definition from registry
+        const componentDef = ATOMIC_COMPONENTS_REGISTRY[component.type];
+        if (!componentDef) {
+            this.addWarning(`Unknown component type: ${component.type}`);
+            return `<!-- Unknown component: ${component.type} -->`;
+        }
+        // Map properties to target framework
+        const mappedProps = this.mapComponentProperties(component, componentDef);
+        // Handle conditional rendering
+        if (component.condition) {
+            return this.renderConditional(component, mappedProps, context);
+        }
+        // Handle list rendering (dataSource)
+        if (component.dataSource) {
+            return this.renderList(component, mappedProps, context);
+        }
+        // Handle children
+        const children = component.children
+            ? this.renderChildren(component.children, context)
+            : undefined;
+        // Delegate to adapter for framework-specific rendering
+        return this.renderAdapterComponent(component.type, mappedProps, children, context);
+    }
+    /**
+     * Map component properties using property-mapper
+     */
+    mapComponentProperties(component, componentDef) {
+        if (!component.properties) {
+            return {};
+        }
+        return mapProperties(component.type, component.properties, this.config.target);
+    }
+    /**
+     * Render child components with incremented depth
+     */
+    renderChildren(children, parentContext) {
+        const childContext = {
+            ...parentContext,
+            depth: parentContext.depth + 1
+        };
+        return children
+            .map((child, index) => {
+            const childPath = [...parentContext.path, `child_${index}`];
+            return this.renderComponent(child, {
+                ...childContext,
+                path: childPath
+            });
+        })
+            .join('\n');
+    }
+    /**
+     * Render conditional component using syntax-mapper
+     */
+    renderConditional(component, mappedProps, context) {
+        const innerComponent = this.renderAdapterComponent(component.type, mappedProps, component.children
+            ? this.renderChildren(component.children, context)
+            : undefined, context);
+        // Use syntax-mapper for framework-specific conditional syntax
+        return getSyntaxPattern('conditionalRender', this.config.framework, {
+            condition: component.condition,
+            Component: this.getComponentName(component.type),
+            props: this.formatProps(mappedProps)
+        });
+    }
+    /**
+     * Render list (loop) component using syntax-mapper
+     */
+    renderList(component, mappedProps, context) {
+        const itemName = this.getItemName(component.dataSource);
+        const keyProperty = this.getKeyProperty(component);
+        // Create child context with data variable
+        const childContext = {
+            ...context,
+            depth: context.depth + 1,
+            dataContext: itemName
+        };
+        // Use syntax-mapper for framework-specific loop syntax
+        return getSyntaxPattern('loopRender', this.config.framework, {
+            array: component.dataSource,
+            item: itemName,
+            key: keyProperty,
+            Component: this.getComponentName(component.type)
+        });
+    }
+    /**
+     * Flatten component when depth exceeded
+     *
+     * Extracts nested children into sibling components to reduce nesting
+     */
+    renderFlattened(component, context) {
+        // Render component without children
+        const componentDef = ATOMIC_COMPONENTS_REGISTRY[component.type];
+        const mappedProps = this.mapComponentProperties(component, componentDef);
+        const flatComponent = this.renderAdapterComponent(component.type, mappedProps, undefined, // No children
+        context);
+        // Render children as siblings (extracted)
+        const flattenedChildren = component.children
+            ? component.children.map((child, index) => {
+                return this.renderComponent(child, {
+                    depth: context.depth, // Same depth (sibling)
+                    path: [...context.path, `flattened_${index}`]
+                });
+            }).join('\n')
+            : '';
+        return flatComponent + '\n' + flattenedChildren;
+    }
+    /**
+     * Delegate to adapter for actual component rendering
+     */
+    renderAdapterComponent(type, properties, children, context) {
+        const adapterComponent = this.adapter.components[type];
+        if (!adapterComponent) {
+            this.addWarning(`Adapter missing component: ${type}`);
+            return `<!-- Missing adapter for: ${type} -->`;
+        }
+        return adapterComponent.render({
+            properties,
+            children,
+            context: {
+                depth: context.depth,
+                dataContext: context.dataContext
+            }
+        });
+    }
+    // ============================================================================
+    // Helper Methods
+    // ============================================================================
+    /**
+     * Get component name for import/usage
+     */
+    getComponentName(type) {
+        const componentDef = ATOMIC_COMPONENTS_REGISTRY[type];
+        return componentDef?.name || type.charAt(0).toUpperCase() + type.slice(1);
+    }
+    /**
+     * Get item variable name for loop rendering
+     */
+    getItemName(dataSource) {
+        // Convert "users" -> "user", "items" -> "item"
+        if (dataSource.endsWith('s')) {
+            return dataSource.slice(0, -1);
+        }
+        return dataSource + 'Item';
+    }
+    /**
+     * Get key property for list items
+     */
+    getKeyProperty(component) {
+        return component.properties?.keyProperty || 'id';
+    }
+    /**
+     * Format properties for inline rendering
+     */
+    formatProps(properties) {
+        return Object.entries(properties)
+            .map(([key, value]) => {
+            if (typeof value === 'string') {
+                return `${key}="${value}"`;
+            }
+            return `${key}={${JSON.stringify(value)}}`;
+        })
+            .join(' ');
+    }
+    /**
+     * Add warning message
+     */
+    addWarning(message) {
+        if (this.ENABLE_WARNINGS) {
+            this.warnings.push(message);
+        }
+    }
+    /**
+     * Reset generator state for new generation
+     */
+    reset() {
+        this.warnings = [];
+        this.imports = new Set();
+    }
+    /**
+     * Add import statement
+     */
+    addImport(importStatement) {
+        this.imports.add(importStatement);
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Validate component nesting depth
+ *
+ * @param component - Component to validate
+ * @param maxDepth - Maximum allowed depth
+ * @returns Validation result with depth and issues
+ */
+export function validateNestingDepth(component, maxDepth = 3) {
+    const issues = [];
+    function calculateDepth(comp, currentDepth) {
+        if (!comp.children || comp.children.length === 0) {
+            return currentDepth;
+        }
+        const childDepths = comp.children.map(child => calculateDepth(child, currentDepth + 1));
+        return Math.max(...childDepths);
+    }
+    const actualDepth = calculateDepth(component, 0);
+    if (actualDepth > maxDepth) {
+        issues.push(`Component nesting depth (${actualDepth}) exceeds maximum (${maxDepth})`);
+    }
+    return {
+        valid: actualDepth <= maxDepth,
+        actualDepth,
+        issues
+    };
+}
+/**
+ * Extract all component types used in a view
+ *
+ * @param components - Component tree
+ * @returns Set of component types
+ */
+export function extractComponentTypes(components) {
+    const types = new Set();
+    function walk(component) {
+        types.add(component.type);
+        if (component.children) {
+            component.children.forEach(walk);
+        }
+    }
+    Object.values(components).forEach(walk);
+    return types;
+}
+/**
+ * Count total components in a view
+ *
+ * @param components - Component tree
+ * @returns Component count
+ */
+export function countComponents(components) {
+    let count = 0;
+    function walk(component) {
+        count++;
+        if (component.children) {
+            component.children.forEach(walk);
+        }
+    }
+    Object.values(components).forEach(walk);
+    return count;
+}
+//# sourceMappingURL=base-generator.js.map

package/libs/instance-factories/views/templates/shared/base-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-generator.js","sourceRoot":"","sources":["base-generator.ts"],"names":[],"mappings":"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"}