@specverse/engines 4.1.5 → 4.1.7

package/dist/libs/instance-factories/views/templates/shared/composite-patterns.js

@@ -0,0 +1,445 @@
+const FORM_VIEW_PATTERN = {
+  // Identity
+  id: "form-view",
+  name: "FormView",
+  version: "1.0.0",
+  description: "Data entry form for creating or updating entities with validation and field rendering",
+  // Metadata
+  category: "data-entry",
+  tags: ["form", "crud", "data-entry", "validation", "create", "update"],
+  // Composition
+  requiredAtomicComponents: [
+    "form",
+    "input",
+    "button"
+  ],
+  optionalAtomicComponents: [
+    "select",
+    "textarea",
+    "checkbox",
+    "radio",
+    "label",
+    "error-message",
+    "fieldset",
+    "legend"
+  ],
+  // Layout
+  layoutStrategy: {
+    type: "single-column",
+    responsive: true,
+    sections: [
+      {
+        id: "fields",
+        title: "Form Fields",
+        layout: {
+          type: "single-column",
+          gap: "medium"
+        }
+      },
+      {
+        id: "actions",
+        title: "Actions",
+        layout: {
+          type: "flex",
+          gap: "small"
+        }
+      }
+    ]
+  },
+  // Data Bindings
+  dataBindings: {
+    source: "controller",
+    operations: [
+      {
+        operation: "create",
+        returns: "entity",
+        optimistic: false,
+        cache: { enabled: false }
+      },
+      {
+        operation: "update",
+        params: ["id"],
+        returns: "entity",
+        optimistic: true,
+        cache: { enabled: false }
+      },
+      {
+        operation: "validate",
+        returns: "validation-result",
+        optimistic: false,
+        cache: { enabled: false }
+      }
+    ],
+    relationships: []
+  },
+  // Behavior
+  supportedOperations: ["create", "update", "validate"],
+  eventHandlers: [
+    {
+      event: "submit",
+      operation: "create",
+      validate: true
+    },
+    {
+      event: "submit",
+      operation: "update",
+      validate: true
+    },
+    {
+      event: "blur",
+      operation: "validate",
+      validate: false
+    }
+  ],
+  // State Management
+  state: {
+    fields: ["formData", "errors", "touched", "isSubmitting"],
+    persistence: "none"
+  }
+};
+const LIST_VIEW_PATTERN = {
+  // Identity
+  id: "list-view",
+  name: "ListView",
+  version: "1.0.0",
+  description: "Data display for collections with filtering, sorting, and pagination support",
+  // Metadata
+  category: "data-display",
+  tags: ["list", "table", "collection", "data-display", "pagination", "filtering"],
+  // Composition
+  requiredAtomicComponents: [
+    "table",
+    "list"
+  ],
+  optionalAtomicComponents: [
+    "card",
+    "badge",
+    "button",
+    "input",
+    "select",
+    "pagination",
+    "search",
+    "filter"
+  ],
+  // Layout
+  layoutStrategy: {
+    type: "flex",
+    responsive: true,
+    direction: "column",
+    sections: [
+      {
+        id: "toolbar",
+        title: "Toolbar",
+        fields: ["search", "filters", "actions"],
+        layout: {
+          type: "flex",
+          gap: "medium"
+        }
+      },
+      {
+        id: "content",
+        title: "Content",
+        layout: {
+          type: "single-column"
+        }
+      },
+      {
+        id: "pagination",
+        title: "Pagination",
+        layout: {
+          type: "flex",
+          gap: "small"
+        }
+      }
+    ]
+  },
+  // Data Bindings
+  dataBindings: {
+    source: "controller",
+    operations: [
+      {
+        operation: "retrieve_many",
+        returns: "entity-array",
+        optimistic: false,
+        cache: {
+          enabled: true,
+          ttl: 300,
+          key: "list-{modelName}-{filters}"
+        }
+      }
+    ],
+    relationships: []
+  },
+  // Behavior
+  supportedOperations: ["retrieve_many"],
+  eventHandlers: [
+    {
+      event: "search",
+      operation: "retrieve_many",
+      validate: false
+    },
+    {
+      event: "filter",
+      operation: "retrieve_many",
+      validate: false
+    },
+    {
+      event: "sort",
+      operation: "retrieve_many",
+      validate: false
+    },
+    {
+      event: "paginate",
+      operation: "retrieve_many",
+      validate: false
+    }
+  ],
+  // State Management
+  state: {
+    fields: ["entities", "filters", "sort", "pagination", "loading"],
+    persistence: "session"
+  }
+};
+const DETAIL_VIEW_PATTERN = {
+  // Identity
+  id: "detail-view",
+  name: "DetailView",
+  version: "1.0.0",
+  description: "Single entity detail display with edit and delete actions",
+  // Metadata
+  category: "data-display",
+  tags: ["detail", "view", "entity", "display", "read-only"],
+  // Composition
+  requiredAtomicComponents: [
+    "card",
+    "container"
+  ],
+  optionalAtomicComponents: [
+    "badge",
+    "button",
+    "tabs",
+    "card",
+    "list",
+    "table"
+  ],
+  // Layout
+  layoutStrategy: {
+    type: "single-column",
+    responsive: true,
+    sections: [
+      {
+        id: "header",
+        title: "Header",
+        fields: ["title", "status", "actions"],
+        layout: {
+          type: "flex",
+          gap: "medium"
+        }
+      },
+      {
+        id: "main",
+        title: "Main Content",
+        layout: {
+          type: "two-column",
+          columns: 2,
+          gap: "large"
+        }
+      },
+      {
+        id: "relationships",
+        title: "Related Data",
+        layout: {
+          type: "grid",
+          columns: 2,
+          gap: "medium"
+        }
+      }
+    ]
+  },
+  // Data Bindings
+  dataBindings: {
+    source: "controller",
+    operations: [
+      {
+        operation: "retrieve",
+        params: ["id"],
+        returns: "entity",
+        optimistic: false,
+        cache: {
+          enabled: true,
+          ttl: 300,
+          key: "detail-{modelName}-{id}"
+        }
+      },
+      {
+        operation: "update",
+        params: ["id"],
+        returns: "entity",
+        optimistic: true,
+        cache: { enabled: false }
+      },
+      {
+        operation: "delete",
+        params: ["id"],
+        returns: "void",
+        optimistic: false,
+        cache: { enabled: false }
+      }
+    ],
+    relationships: []
+  },
+  // Behavior
+  supportedOperations: ["retrieve", "update", "delete"],
+  eventHandlers: [
+    {
+      event: "edit",
+      operation: "update",
+      validate: true
+    },
+    {
+      event: "delete",
+      operation: "delete",
+      validate: false,
+      confirm: {
+        title: "Confirm Delete",
+        message: "Are you sure you want to delete this item?"
+      }
+    }
+  ],
+  // State Management
+  state: {
+    fields: ["entity", "loading", "error", "editMode"],
+    persistence: "none"
+  }
+};
+const DASHBOARD_VIEW_PATTERN = {
+  // Identity
+  id: "dashboard-view",
+  name: "DashboardView",
+  version: "1.0.0",
+  description: "Multi-section dashboard with metrics, charts, and data summaries",
+  // Metadata
+  category: "dashboard",
+  tags: ["dashboard", "overview", "metrics", "analytics", "summary"],
+  // Composition
+  requiredAtomicComponents: [
+    "grid",
+    "card"
+  ],
+  optionalAtomicComponents: [
+    "chart",
+    "metric",
+    "table",
+    "list",
+    "badge",
+    "progress",
+    "stat"
+  ],
+  // Layout
+  layoutStrategy: {
+    type: "grid",
+    responsive: true,
+    columns: 12,
+    sections: [
+      {
+        id: "metrics",
+        title: "Key Metrics",
+        layout: {
+          type: "grid",
+          columns: 4,
+          gap: "medium"
+        }
+      },
+      {
+        id: "charts",
+        title: "Charts",
+        layout: {
+          type: "grid",
+          columns: 2,
+          gap: "large"
+        }
+      },
+      {
+        id: "recent-activity",
+        title: "Recent Activity",
+        layout: {
+          type: "single-column",
+          gap: "small"
+        }
+      }
+    ]
+  },
+  // Data Bindings
+  dataBindings: {
+    source: "service",
+    operations: [
+      {
+        operation: "retrieve_many",
+        returns: "entity-array",
+        optimistic: false,
+        cache: {
+          enabled: true,
+          ttl: 600,
+          key: "dashboard-{component}"
+        }
+      }
+    ],
+    relationships: []
+  },
+  // Behavior
+  supportedOperations: ["retrieve_many"],
+  eventHandlers: [
+    {
+      event: "refresh",
+      operation: "retrieve_many",
+      validate: false
+    }
+  ],
+  // State Management
+  state: {
+    fields: ["metrics", "charts", "recentActivity", "loading", "lastUpdate"],
+    persistence: "session"
+  },
+  // Customization
+  customization: {
+    allowedOverrides: ["layoutStrategy", "sections", "metrics"],
+    requiredOverrides: []
+  }
+};
+const COMPOSITE_VIEW_PATTERNS = {
+  "form-view": FORM_VIEW_PATTERN,
+  "list-view": LIST_VIEW_PATTERN,
+  "detail-view": DETAIL_VIEW_PATTERN,
+  "dashboard-view": DASHBOARD_VIEW_PATTERN
+};
+function getPattern(id) {
+  return COMPOSITE_VIEW_PATTERNS[id];
+}
+function getPatternsByCategory(category) {
+  return Object.values(COMPOSITE_VIEW_PATTERNS).filter(
+    (pattern) => pattern.category === category
+  );
+}
+function getPatternsByTag(tag) {
+  return Object.values(COMPOSITE_VIEW_PATTERNS).filter(
+    (pattern) => pattern.tags.includes(tag)
+  );
+}
+function getPatternIds() {
+  return Object.keys(COMPOSITE_VIEW_PATTERNS);
+}
+function hasPattern(id) {
+  return id in COMPOSITE_VIEW_PATTERNS;
+}
+export {
+  COMPOSITE_VIEW_PATTERNS,
+  DASHBOARD_VIEW_PATTERN,
+  DETAIL_VIEW_PATTERN,
+  FORM_VIEW_PATTERN,
+  LIST_VIEW_PATTERN,
+  getPattern,
+  getPatternIds,
+  getPatternsByCategory,
+  getPatternsByTag,
+  hasPattern
+};

package/dist/libs/instance-factories/views/templates/shared/index.js

@@ -0,0 +1,80 @@
+import {
+  ATOMIC_COMPONENTS_REGISTRY,
+  AtomicComponentDefinition
+} from "./atomic-components-registry.js";
+export * from "./component-metadata.js";
+import {
+  ComponentAdapter,
+  ComponentLibraryAdapter,
+  ComponentMapping,
+  RenderContext,
+  renderProps,
+  indent,
+  wrapWithChildren
+} from "./adapter-types.js";
+export * from "./property-mapper.js";
+export * from "./syntax-mapper.js";
+import {
+  BaseComponentGenerator,
+  ViewSpec,
+  StateDefinition,
+  EventDefinition,
+  UIComponent,
+  RenderContext as RenderContext2,
+  GeneratorConfig,
+  extractComponentTypes,
+  countComponents,
+  validateNestingDepth
+} from "./base-generator.js";
+export * from "./composite-pattern-types.js";
+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,
+  getValidationSummary
+} from "./pattern-validator.js";
+export {
+  ATOMIC_COMPONENTS_REGISTRY,
+  AtomicComponentDefinition,
+  BaseComponentGenerator,
+  COMPOSITE_VIEW_PATTERNS,
+  ComponentAdapter,
+  ComponentLibraryAdapter,
+  ComponentMapping,
+  DASHBOARD_VIEW_PATTERN,
+  DETAIL_VIEW_PATTERN,
+  EventDefinition,
+  FORM_VIEW_PATTERN,
+  GeneratorConfig,
+  RenderContext2 as GeneratorRenderContext,
+  LIST_VIEW_PATTERN,
+  RenderContext,
+  StateDefinition,
+  UIComponent,
+  ViewSpec,
+  countComponents,
+  extractComponentTypes,
+  getPattern,
+  getPatternIds,
+  getPatternsByCategory,
+  getPatternsByTag,
+  getValidationSummary,
+  hasPattern,
+  indent,
+  renderProps,
+  validateNestingDepth,
+  validatePattern,
+  validatePatternRegistry,
+  wrapWithChildren
+};