@specverse/engines 4.1.0

package/libs/instance-factories/views/templates/shared/__tests__/composite-patterns.test.ts

@@ -0,0 +1,242 @@
+/**
+ * Tests for Composite View Patterns
+ */
+
+import { describe, it, expect } from 'vitest';
+import {
+  COMPOSITE_VIEW_PATTERNS,
+  FORM_VIEW_PATTERN,
+  LIST_VIEW_PATTERN,
+  DETAIL_VIEW_PATTERN,
+  DASHBOARD_VIEW_PATTERN,
+  getPattern,
+  getPatternsByCategory,
+  getPatternsByTag,
+  getPatternIds,
+  hasPattern
+} from '../composite-patterns.js';
+import { validatePattern, validatePatternRegistry } from '../pattern-validator.js';
+
+describe('Composite View Patterns', () => {
+  describe('Pattern Registry', () => {
+    it('should export all 4 core patterns', () => {
+      expect(Object.keys(COMPOSITE_VIEW_PATTERNS)).toHaveLength(4);
+      expect(COMPOSITE_VIEW_PATTERNS['form-view']).toBeDefined();
+      expect(COMPOSITE_VIEW_PATTERNS['list-view']).toBeDefined();
+      expect(COMPOSITE_VIEW_PATTERNS['detail-view']).toBeDefined();
+      expect(COMPOSITE_VIEW_PATTERNS['dashboard-view']).toBeDefined();
+    });
+
+    it('should have correct pattern IDs', () => {
+      const ids = getPatternIds();
+      expect(ids).toContain('form-view');
+      expect(ids).toContain('list-view');
+      expect(ids).toContain('detail-view');
+      expect(ids).toContain('dashboard-view');
+    });
+  });
+
+  describe('FormView Pattern', () => {
+    it('should have correct identity', () => {
+      expect(FORM_VIEW_PATTERN.id).toBe('form-view');
+      expect(FORM_VIEW_PATTERN.name).toBe('FormView');
+      expect(FORM_VIEW_PATTERN.version).toBe('1.0.0');
+      expect(FORM_VIEW_PATTERN.category).toBe('data-entry');
+    });
+
+    it('should require form, input, and button components', () => {
+      expect(FORM_VIEW_PATTERN.requiredAtomicComponents).toContain('form');
+      expect(FORM_VIEW_PATTERN.requiredAtomicComponents).toContain('input');
+      expect(FORM_VIEW_PATTERN.requiredAtomicComponents).toContain('button');
+    });
+
+    it('should support create, update, and validate operations', () => {
+      expect(FORM_VIEW_PATTERN.supportedOperations).toContain('create');
+      expect(FORM_VIEW_PATTERN.supportedOperations).toContain('update');
+      expect(FORM_VIEW_PATTERN.supportedOperations).toContain('validate');
+    });
+
+    it('should validate successfully', () => {
+      const result = validatePattern(FORM_VIEW_PATTERN);
+      expect(result.valid).toBe(true);
+      expect(result.errors).toHaveLength(0);
+    });
+  });
+
+  describe('ListView Pattern', () => {
+    it('should have correct identity', () => {
+      expect(LIST_VIEW_PATTERN.id).toBe('list-view');
+      expect(LIST_VIEW_PATTERN.name).toBe('ListView');
+      expect(LIST_VIEW_PATTERN.category).toBe('data-display');
+    });
+
+    it('should require table and list components', () => {
+      expect(LIST_VIEW_PATTERN.requiredAtomicComponents).toContain('table');
+      expect(LIST_VIEW_PATTERN.requiredAtomicComponents).toContain('list');
+    });
+
+    it('should support retrieve_many operation', () => {
+      expect(LIST_VIEW_PATTERN.supportedOperations).toContain('retrieve_many');
+    });
+
+    it('should validate successfully', () => {
+      const result = validatePattern(LIST_VIEW_PATTERN);
+      expect(result.valid).toBe(true);
+      expect(result.errors).toHaveLength(0);
+    });
+  });
+
+  describe('DetailView Pattern', () => {
+    it('should have correct identity', () => {
+      expect(DETAIL_VIEW_PATTERN.id).toBe('detail-view');
+      expect(DETAIL_VIEW_PATTERN.name).toBe('DetailView');
+      expect(DETAIL_VIEW_PATTERN.category).toBe('data-display');
+    });
+
+    it('should require content and profile components', () => {
+      expect(DETAIL_VIEW_PATTERN.requiredAtomicComponents).toContain('content');
+      expect(DETAIL_VIEW_PATTERN.requiredAtomicComponents).toContain('profile');
+    });
+
+    it('should support retrieve, update, and delete operations', () => {
+      expect(DETAIL_VIEW_PATTERN.supportedOperations).toContain('retrieve');
+      expect(DETAIL_VIEW_PATTERN.supportedOperations).toContain('update');
+      expect(DETAIL_VIEW_PATTERN.supportedOperations).toContain('delete');
+    });
+
+    it('should validate successfully', () => {
+      const result = validatePattern(DETAIL_VIEW_PATTERN);
+      expect(result.valid).toBe(true);
+      expect(result.errors).toHaveLength(0);
+    });
+  });
+
+  describe('DashboardView Pattern', () => {
+    it('should have correct identity', () => {
+      expect(DASHBOARD_VIEW_PATTERN.id).toBe('dashboard-view');
+      expect(DASHBOARD_VIEW_PATTERN.name).toBe('DashboardView');
+      expect(DASHBOARD_VIEW_PATTERN.category).toBe('dashboard');
+    });
+
+    it('should require grid and card components', () => {
+      expect(DASHBOARD_VIEW_PATTERN.requiredAtomicComponents).toContain('grid');
+      expect(DASHBOARD_VIEW_PATTERN.requiredAtomicComponents).toContain('card');
+    });
+
+    it('should support retrieve_many operation', () => {
+      expect(DASHBOARD_VIEW_PATTERN.supportedOperations).toContain('retrieve_many');
+    });
+
+    it('should validate successfully', () => {
+      const result = validatePattern(DASHBOARD_VIEW_PATTERN);
+      expect(result.valid).toBe(true);
+      expect(result.errors).toHaveLength(0);
+    });
+  });
+
+  describe('Pattern Query Functions', () => {
+    it('should get pattern by ID', () => {
+      const pattern = getPattern('form-view');
+      expect(pattern).toBeDefined();
+      expect(pattern?.name).toBe('FormView');
+    });
+
+    it('should return undefined for non-existent pattern', () => {
+      const pattern = getPattern('non-existent');
+      expect(pattern).toBeUndefined();
+    });
+
+    it('should check if pattern exists', () => {
+      expect(hasPattern('form-view')).toBe(true);
+      expect(hasPattern('non-existent')).toBe(false);
+    });
+
+    it('should get patterns by category', () => {
+      const dataEntryPatterns = getPatternsByCategory('data-entry');
+      expect(dataEntryPatterns).toHaveLength(1);
+      expect(dataEntryPatterns[0].name).toBe('FormView');
+
+      const dataDisplayPatterns = getPatternsByCategory('data-display');
+      expect(dataDisplayPatterns).toHaveLength(2);
+    });
+
+    it('should get patterns by tag', () => {
+      const formPatterns = getPatternsByTag('form');
+      expect(formPatterns.length).toBeGreaterThan(0);
+      expect(formPatterns[0].tags).toContain('form');
+
+      const tablePatterns = getPatternsByTag('table');
+      expect(tablePatterns.length).toBeGreaterThan(0);
+    });
+  });
+
+  describe('Pattern Validation', () => {
+    it('should validate all patterns in registry', () => {
+      const results = validatePatternRegistry(COMPOSITE_VIEW_PATTERNS);
+      expect(Object.keys(results)).toHaveLength(4);
+
+      // All patterns should be valid
+      for (const [id, result] of Object.entries(results)) {
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+      }
+    });
+
+    it('should detect missing required fields', () => {
+      const invalidPattern: any = {
+        id: '',
+        name: '',
+        version: '1.0.0',
+        category: 'data-entry',
+        requiredAtomicComponents: [],
+        layoutStrategy: { type: 'single-column', responsive: true },
+        dataBindings: {
+          source: 'controller',
+          operations: []
+        },
+        supportedOperations: []
+      };
+
+      const result = validatePattern(invalidPattern);
+      expect(result.valid).toBe(false);
+      expect(result.errors.length).toBeGreaterThan(0);
+    });
+
+    it('should detect invalid category', () => {
+      const invalidPattern: any = {
+        ...FORM_VIEW_PATTERN,
+        category: 'invalid-category'
+      };
+
+      const result = validatePattern(invalidPattern);
+      expect(result.valid).toBe(false);
+      expect(result.errors.some(e => e.field === 'category')).toBe(true);
+    });
+
+    it('should detect invalid version format', () => {
+      const invalidPattern: any = {
+        ...FORM_VIEW_PATTERN,
+        version: 'not-a-version'
+      };
+
+      const result = validatePattern(invalidPattern);
+      expect(result.valid).toBe(false);
+      expect(result.errors.some(e => e.field === 'version')).toBe(true);
+    });
+  });
+
+  describe('Framework Independence', () => {
+    it('should have no React dependencies', () => {
+      // Patterns should be pure data structures
+      expect(typeof FORM_VIEW_PATTERN).toBe('object');
+      expect(FORM_VIEW_PATTERN.requiredAtomicComponents).toBeInstanceOf(Array);
+      expect(FORM_VIEW_PATTERN.frameworkHints).toBeDefined();
+    });
+
+    it('should support multiple frameworks in hints', () => {
+      expect(FORM_VIEW_PATTERN.frameworkHints?.react).toBeDefined();
+      expect(FORM_VIEW_PATTERN.frameworkHints?.vue).toBeDefined();
+      expect(FORM_VIEW_PATTERN.frameworkHints?.svelte).toBeDefined();
+    });
+  });
+});

package/libs/instance-factories/views/templates/shared/adapter-types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Component Library Adapter Types
+ *
+ * Defines the interface for UI library adapters (shadcn/ui, Material-UI, Ant Design, etc.)
+ * Each adapter implements these types to map SpecVerse atomic components to their framework.
+ */
+/**
+ * Context passed to component render functions
+ */
+export interface RenderContext {
+    /** Component properties from SpecVerse spec */
+    properties: Record<string, any>;
+    /** Model definition if component is model-bound */
+    model?: any;
+    /** Component name in the spec */
+    name: string;
+    /** Child components (for containers) */
+    children?: string;
+    /** Indentation level for formatting */
+    indent?: number;
+}
+/**
+ * Mapping for a single atomic component type
+ */
+export interface ComponentMapping {
+    /** Import statement(s) needed for this component */
+    imports: string[];
+    /** Function to render the component as JSX string */
+    render: (context: RenderContext) => string;
+    /** Dependencies required for this component */
+    dependencies?: {
+        name: string;
+        version: string;
+    }[];
+    /** Optional component-specific configuration */
+    config?: Record<string, any>;
+}
+/**
+ * Complete UI library adapter
+ */
+export interface ComponentLibraryAdapter {
+    /** Library name */
+    name: string;
+    /** Library version */
+    version: string;
+    /** Description */
+    description: string;
+    /** Base dependencies for the library */
+    baseDependencies: {
+        name: string;
+        version: string;
+    }[];
+    /** Mapping for all 49 atomic component types */
+    components: Record<string, ComponentMapping>;
+    /** Optional global configuration */
+    config?: {
+        /** Import path prefix (e.g., '@/components/ui', '@mui/material') */
+        importPrefix?: string;
+        /** Whether to use default or named imports */
+        importStyle?: 'default' | 'named';
+        /** Theme configuration */
+        theme?: Record<string, any>;
+    };
+}
+/**
+ * Helper to render properties as JSX attributes
+ */
+export declare function renderProps(props: Record<string, any>): string;
+/**
+ * Helper to indent code
+ */
+export declare function indent(code: string, level?: number): string;
+/**
+ * Helper to wrap component with children
+ */
+export declare function wrapWithChildren(openTag: string, children: string, closeTag: string, indentLevel?: number): string;
+//# sourceMappingURL=adapter-types.d.ts.map

package/libs/instance-factories/views/templates/shared/adapter-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-types.d.ts","sourceRoot":"","sources":["adapter-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,mDAAmD;IACnD,KAAK,CAAC,EAAE,GAAG,CAAC;IAEZ,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,qDAAqD;IACrD,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC;IAE3C,+CAA+C;IAC/C,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IAEJ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IAEJ,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE7C,oCAAoC;IACpC,MAAM,CAAC,EAAE;QACP,oEAAoE;QACpE,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,8CAA8C;QAC9C,WAAW,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;QAElC,0BAA0B;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC7B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAuB9D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAU,GACtB,MAAM,CAER"}

package/libs/instance-factories/views/templates/shared/adapter-types.js

@@ -0,0 +1,47 @@
+/**
+ * Component Library Adapter Types
+ *
+ * Defines the interface for UI library adapters (shadcn/ui, Material-UI, Ant Design, etc.)
+ * Each adapter implements these types to map SpecVerse atomic components to their framework.
+ */
+/**
+ * Helper to render properties as JSX attributes
+ */
+export function renderProps(props) {
+    return Object.entries(props)
+        .filter(([_, value]) => value !== undefined && value !== null)
+        .map(([key, value]) => {
+        if (typeof value === 'boolean') {
+            return value ? key : '';
+        }
+        if (typeof value === 'string') {
+            return `${key}="${value}"`;
+        }
+        if (typeof value === 'number') {
+            return `${key}={${value}}`;
+        }
+        if (Array.isArray(value)) {
+            return `${key}={${JSON.stringify(value)}}`;
+        }
+        if (typeof value === 'object') {
+            return `${key}={${JSON.stringify(value)}}`;
+        }
+        return `${key}={${value}}`;
+    })
+        .filter(Boolean)
+        .join(' ');
+}
+/**
+ * Helper to indent code
+ */
+export function indent(code, level = 0) {
+    const spaces = '  '.repeat(level);
+    return code.split('\n').map(line => line ? spaces + line : line).join('\n');
+}
+/**
+ * Helper to wrap component with children
+ */
+export function wrapWithChildren(openTag, children, closeTag, indentLevel = 0) {
+    return `${openTag}\n${indent(children, indentLevel + 1)}\n${indent(closeTag, indentLevel)}`;
+}
+//# sourceMappingURL=adapter-types.js.map

package/libs/instance-factories/views/templates/shared/adapter-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-types.js","sourceRoot":"","sources":["adapter-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6EH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAA0B;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;SAC7D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpB,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,GAAG,GAAG,KAAK,KAAK,GAAG,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,GAAG,GAAG,KAAK,KAAK,GAAG,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7C,CAAC;QACD,OAAO,GAAG,GAAG,KAAK,KAAK,GAAG,CAAC;IAC7B,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,QAAgB,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,QAAgB,EAChB,QAAgB,EAChB,cAAsB,CAAC;IAEvB,OAAO,GAAG,OAAO,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;AAC9F,CAAC"}

package/libs/instance-factories/views/templates/shared/adapter-types.ts

@@ -0,0 +1,142 @@
+/**
+ * Component Library Adapter Types
+ *
+ * Defines the interface for UI library adapters (shadcn/ui, Material-UI, Ant Design, etc.)
+ * Each adapter implements these types to map SpecVerse atomic components to their framework.
+ */
+
+/**
+ * Context passed to component render functions
+ */
+export interface RenderContext {
+  /** Component properties from SpecVerse spec */
+  properties: Record<string, any>;
+
+  /** Model definition if component is model-bound */
+  model?: any;
+
+  /** Component name in the spec */
+  name: string;
+
+  /** Child components (for containers) */
+  children?: string;
+
+  /** Indentation level for formatting */
+  indent?: number;
+}
+
+/**
+ * Mapping for a single atomic component type
+ */
+export interface ComponentMapping {
+  /** Import statement(s) needed for this component */
+  imports: string[];
+
+  /** Function to render the component as JSX string */
+  render: (context: RenderContext) => string;
+
+  /** Dependencies required for this component */
+  dependencies?: {
+    name: string;
+    version: string;
+  }[];
+
+  /** Optional component-specific configuration */
+  config?: Record<string, any>;
+}
+
+/**
+ * Complete UI library adapter
+ */
+export interface ComponentLibraryAdapter {
+  /** Library name */
+  name: string;
+
+  /** Library version */
+  version: string;
+
+  /** Description */
+  description: string;
+
+  /** Base dependencies for the library */
+  baseDependencies: {
+    name: string;
+    version: string;
+  }[];
+
+  /** Mapping for all 49 atomic component types */
+  components: Record<string, ComponentMapping>;
+
+  /** Optional global configuration */
+  config?: {
+    /** Import path prefix (e.g., '@/components/ui', '@mui/material') */
+    importPrefix?: string;
+
+    /** Whether to use default or named imports */
+    importStyle?: 'default' | 'named';
+
+    /** Theme configuration */
+    theme?: Record<string, any>;
+  };
+}
+
+/**
+ * Simplified adapter interface (used by tests and runtime renderer)
+ */
+export interface ComponentAdapter {
+  name: string;
+  version: string;
+  description: string;
+  components: Record<string, {
+    import?: string;
+    render: (params: { properties?: Record<string, any>; children?: string }) => string;
+  }>;
+}
+
+/**
+ * Helper to render properties as JSX attributes
+ */
+export function renderProps(props: Record<string, any>): string {
+  return Object.entries(props)
+    .filter(([_, value]) => value !== undefined && value !== null)
+    .map(([key, value]) => {
+      if (typeof value === 'boolean') {
+        return value ? key : '';
+      }
+      if (typeof value === 'string') {
+        return `${key}="${value}"`;
+      }
+      if (typeof value === 'number') {
+        return `${key}={${value}}`;
+      }
+      if (Array.isArray(value)) {
+        return `${key}={${JSON.stringify(value)}}`;
+      }
+      if (typeof value === 'object') {
+        return `${key}={${JSON.stringify(value)}}`;
+      }
+      return `${key}={${value}}`;
+    })
+    .filter(Boolean)
+    .join(' ');
+}
+
+/**
+ * Helper to indent code
+ */
+export function indent(code: string, level: number = 0): string {
+  const spaces = '  '.repeat(level);
+  return code.split('\n').map(line => line ? spaces + line : line).join('\n');
+}
+
+/**
+ * Helper to wrap component with children
+ */
+export function wrapWithChildren(
+  openTag: string,
+  children: string,
+  closeTag: string,
+  indentLevel: number = 0
+): string {
+  return `${openTag}\n${indent(children, indentLevel + 1)}\n${indent(closeTag, indentLevel)}`;
+}

package/libs/instance-factories/views/templates/shared/atomic-components-registry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Atomic Components Registry
+ *
+ * Defines all 49 atomic component types.
+ * Each type has metadata about its purpose, properties, and usage patterns.
+ *
+ * This registry is framework-agnostic. UI library adapters (shadcn, MUI, etc.)
+ * implement these types using their specific components.
+ */
+export interface AtomicComponentDefinition {
+    /** Component type identifier (matches schema enum) */
+    type: string;
+    /** Human-readable name */
+    name: string;
+    /** Category from v3.4 schema */
+    category: 'data-display' | 'forms-inputs' | 'actions' | 'overlays-feedback' | 'navigation' | 'layout' | 'progress' | 'specialized';
+    /** Description of component purpose */
+    description: string;
+    /** Common SpecVerse properties this component accepts */
+    properties: string[];
+    /** Whether this component can contain child components */
+    canHaveChildren: boolean;
+    /** Example usage in SpecVerse spec */
+    example: string;
+}
+/**
+ * Complete registry of all 49 atomic component types
+ */
+export declare const ATOMIC_COMPONENTS_REGISTRY: Record<string, AtomicComponentDefinition>;
+/**
+ * Get component definition by type
+ */
+export declare function getComponentDefinition(type: string): AtomicComponentDefinition | undefined;
+/**
+ * Get all components in a category
+ */
+export declare function getComponentsByCategory(category: string): AtomicComponentDefinition[];
+/**
+ * Validate if a component type exists
+ */
+export declare function isValidComponentType(type: string): boolean;
+/**
+ * Get all component types as array
+ */
+export declare function getAllComponentTypes(): string[];
+/**
+ * Component categories summary
+ */
+export declare const COMPONENT_CATEGORIES: {
+    readonly 'data-display': 9;
+    readonly 'forms-inputs': 11;
+    readonly actions: 5;
+    readonly 'overlays-feedback': 9;
+    readonly navigation: 5;
+    readonly layout: 6;
+    readonly progress: 2;
+    readonly specialized: 2;
+};
+/**
+ * Total count: 49 atomic components
+ */
+export declare const TOTAL_COMPONENT_COUNT = 49;
+//# sourceMappingURL=atomic-components-registry.d.ts.map

package/libs/instance-factories/views/templates/shared/atomic-components-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-components-registry.d.ts","sourceRoot":"","sources":["atomic-components-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,QAAQ,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,GAAG,mBAAmB,GACjE,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;IAE/D,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;IAEzB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAuzBhF,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAE1F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,EAAE,CAErF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;CASvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC"}