@specverse/engine-realize 3.5.3

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"}