@documentation-robotics/cli 0.1.0

package/dist/schemas/bundled/09-ux-layer.schema.json

@@ -0,0 +1,1506 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://example.com/schemas/09-ux-layer.schema.json",
+  "title": "UX Layer Layer Schema",
+  "description": "Defines user experience specifications including state management, component composition, and multi-channel interaction patterns for visual, voice, and chat interfaces.",
+  "layerMetadata": {
+    "layerId": "09-ux-layer",
+    "layerName": "UX Layer",
+    "intraLayerRelationshipSupport": true,
+    "crossLayerRelationshipSupport": true,
+    "relationshipCatalogVersion": "2.1.0"
+  },
+  "intraLayerRelationships": {
+    "$comment": "Relationships between entities within this layer. References relationship-catalog.json by ID.",
+    "allowed": [
+      {
+        "relationshipTypeId": "specialization",
+        "sourceTypes": ["PremiumAccount", "Schema"],
+        "targetTypes": ["Account", "Schema"],
+        "examples": [
+          {
+            "source": "PremiumAccount",
+            "target": "Account",
+            "description": "Premium account specializes the general account concept"
+          },
+          {
+            "source": "Schema",
+            "target": "Schema",
+            "description": "API schema specializes another via allOf/oneOf/anyOf composition",
+            "layer": "06-api"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "flow",
+        "sourceTypes": ["BusinessProcess", "CoverageRequirement", "TestCoverageTarget"],
+        "targetTypes": ["BusinessProcess", "CoverageRequirement", "TestCaseSketch"],
+        "examples": [
+          {
+            "source": "BusinessProcess",
+            "target": "BusinessProcess",
+            "description": "One business process flows to the next in sequence"
+          },
+          {
+            "source": "TestCoverageTarget",
+            "target": "CoverageRequirement",
+            "description": "Target flows to requirements that specify its coverage",
+            "layer": "12-testing"
+          },
+          {
+            "source": "CoverageRequirement",
+            "target": "TestCaseSketch",
+            "description": "Requirement flows to sketches that implement it",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "uses",
+        "sourceTypes": ["ApplicationComponent"],
+        "targetTypes": ["TechnologyService"],
+        "examples": [
+          {
+            "source": "ApplicationComponent",
+            "target": "TechnologyService",
+            "description": "Application component uses technology service"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "reference",
+        "sourceTypes": ["CoverageRequirement", "DataObject", "TestCaseSketch"],
+        "targetTypes": ["CoverageRequirement", "Schema", "TestCoverageTarget"],
+        "examples": [
+          {
+            "source": "DataObject",
+            "target": "Schema",
+            "description": "Data object references JSON schema"
+          },
+          {
+            "source": "TestCaseSketch",
+            "target": "CoverageRequirement",
+            "description": "Test case sketch references coverage requirement it satisfies",
+            "layer": "12-testing"
+          },
+          {
+            "source": "CoverageRequirement",
+            "target": "TestCoverageTarget",
+            "description": "Coverage requirement references target it covers",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "depends-on",
+        "sourceTypes": ["ApplicationService", "TestCaseSketch"],
+        "targetTypes": ["ContextVariation", "DataObject", "OutcomeCategory"],
+        "examples": [
+          {
+            "source": "ApplicationService",
+            "target": "DataObject",
+            "description": "Application service depends on data object"
+          },
+          {
+            "source": "TestCaseSketch",
+            "target": "ContextVariation",
+            "description": "Test sketch depends on context for execution environment",
+            "layer": "12-testing"
+          },
+          {
+            "source": "TestCaseSketch",
+            "target": "OutcomeCategory",
+            "description": "Test sketch depends on expected outcome category",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "renders",
+        "sourceTypes": ["UIComponent"],
+        "targetTypes": ["UIView"],
+        "examples": [
+          {
+            "source": "UIComponent",
+            "target": "UIView",
+            "description": "Layout component renders view content"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "binds-to",
+        "sourceTypes": ["UIComponent"],
+        "targetTypes": ["DataObject"],
+        "examples": [
+          {
+            "source": "UIComponent",
+            "target": "DataObject",
+            "description": "Form component binds to user data object"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "navigates-to",
+        "sourceTypes": ["UIView"],
+        "targetTypes": ["UIView"],
+        "examples": [
+          {
+            "source": "UIView",
+            "target": "UIView",
+            "description": "Login view navigates to dashboard view"
+          }
+        ]
+      }
+    ]
+  },
+  "crossLayerRelationships": {
+    "$comment": "Relationships to/from entities in other layers",
+    "outgoing": [
+      {
+        "id": "motivation-governed-by-principles",
+        "predicate": "governed-by-principles",
+        "inversePredicate": "governs",
+        "targetLayer": "01-motivation",
+        "targetTypes": ["GovernedByPrinciple"],
+        "sourceTypes": ["BusinessService"],
+        "fieldPath": "motivation.governed-by-principles",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "high",
+        "required": false,
+        "description": "BusinessService governed by Principles",
+        "examples": [
+          {
+            "elementType": "BusinessService",
+            "elementId": "order-service",
+            "elementName": "Order Processing Service",
+            "fieldPath": "motivation.governed-by-principles",
+            "value": "principle-customer-first,principle-automation",
+            "layer": "02-business"
+          },
+          {
+            "elementType": "ApplicationService",
+            "elementId": "product-service",
+            "elementName": "product-service",
+            "fieldPath": "motivation.governed-by-principles",
+            "value": "principle-api-first,principle-cloud-native",
+            "layer": "04-application"
+          }
+        ]
+      },
+      {
+        "id": "motivation-supports-goals",
+        "predicate": "supports-goals",
+        "inversePredicate": "supported-by",
+        "targetLayer": "01-motivation",
+        "targetTypes": ["SupportsGoal"],
+        "sourceTypes": ["BusinessService"],
+        "fieldPath": "motivation.supports-goals",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "high",
+        "required": false,
+        "description": "BusinessService supports Goals",
+        "examples": [
+          {
+            "elementType": "BusinessService",
+            "elementId": "order-service",
+            "elementName": "Order Processing Service",
+            "fieldPath": "motivation.supports-goals",
+            "value": "goal-customer-satisfaction,goal-revenue-growth",
+            "layer": "02-business"
+          },
+          {
+            "elementType": "ApplicationService",
+            "elementId": "product-service",
+            "elementName": "product-service",
+            "fieldPath": "motivation.supports-goals",
+            "value": "goal-product-catalog-accuracy,goal-customer-satisfaction",
+            "layer": "04-application"
+          }
+        ]
+      },
+      {
+        "id": "security-classification",
+        "predicate": "classification",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "03-security",
+        "targetTypes": ["Classification"],
+        "sourceTypes": ["Artifact"],
+        "fieldPath": "security.classification",
+        "cardinality": "single",
+        "format": "string",
+        "strength": "low",
+        "required": false,
+        "description": "Links to Classification in target layer",
+        "examples": [
+          {
+            "elementType": "Artifact",
+            "elementId": "product-db",
+            "elementName": "product-db",
+            "fieldPath": "security.classification",
+            "value": "internal",
+            "layer": "05-technology"
+          },
+          {
+            "elementType": "Artifact",
+            "elementId": "customer-db",
+            "elementName": "customer-db",
+            "fieldPath": "security.classification",
+            "value": "restricted",
+            "layer": "05-technology"
+          }
+        ]
+      }
+    ],
+    "incoming": []
+  },
+  "type": "object",
+  "properties": {
+    "ux-libraries": {
+      "type": "array",
+      "description": "Collection of UXLibrary entities",
+      "items": {
+        "$ref": "#/definitions/UXLibrary"
+      }
+    },
+    "library-components": {
+      "type": "array",
+      "description": "Collection of LibraryComponent entities",
+      "items": {
+        "$ref": "#/definitions/LibraryComponent"
+      }
+    },
+    "library-sub-views": {
+      "type": "array",
+      "description": "Collection of LibrarySubView entities",
+      "items": {
+        "$ref": "#/definitions/LibrarySubView"
+      }
+    },
+    "state-patterns": {
+      "type": "array",
+      "description": "Collection of StatePattern entities",
+      "items": {
+        "$ref": "#/definitions/StatePattern"
+      }
+    },
+    "action-patterns": {
+      "type": "array",
+      "description": "Collection of ActionPattern entities",
+      "items": {
+        "$ref": "#/definitions/ActionPattern"
+      }
+    },
+    "ux-applications": {
+      "type": "array",
+      "description": "Collection of UXApplication entities",
+      "items": {
+        "$ref": "#/definitions/UXApplication"
+      }
+    },
+    "ux-specs": {
+      "type": "array",
+      "description": "Collection of UXSpec entities",
+      "items": {
+        "$ref": "#/definitions/UXSpec"
+      }
+    },
+    "experience-states": {
+      "type": "array",
+      "description": "Collection of ExperienceState entities",
+      "items": {
+        "$ref": "#/definitions/ExperienceState"
+      }
+    },
+    "state-actions": {
+      "type": "array",
+      "description": "Collection of StateAction entities",
+      "items": {
+        "$ref": "#/definitions/StateAction"
+      }
+    },
+    "state-transitions": {
+      "type": "array",
+      "description": "Collection of StateTransition entities",
+      "items": {
+        "$ref": "#/definitions/StateTransition"
+      }
+    },
+    "conditions": {
+      "type": "array",
+      "description": "Collection of Condition entities",
+      "items": {
+        "$ref": "#/definitions/Condition"
+      }
+    },
+    "views": {
+      "type": "array",
+      "description": "Collection of View entities",
+      "items": {
+        "$ref": "#/definitions/View"
+      }
+    },
+    "sub-views": {
+      "type": "array",
+      "description": "Collection of SubView entities",
+      "items": {
+        "$ref": "#/definitions/SubView"
+      }
+    },
+    "component-instances": {
+      "type": "array",
+      "description": "Collection of ComponentInstance entities",
+      "items": {
+        "$ref": "#/definitions/ComponentInstance"
+      }
+    },
+    "action-components": {
+      "type": "array",
+      "description": "Collection of ActionComponent entities",
+      "items": {
+        "$ref": "#/definitions/ActionComponent"
+      }
+    },
+    "validation-rules": {
+      "type": "array",
+      "description": "Collection of ValidationRule entities",
+      "items": {
+        "$ref": "#/definitions/ValidationRule"
+      }
+    },
+    "layout-configs": {
+      "type": "array",
+      "description": "Collection of LayoutConfig entities",
+      "items": {
+        "$ref": "#/definitions/LayoutConfig"
+      }
+    },
+    "error-configs": {
+      "type": "array",
+      "description": "Collection of ErrorConfig entities",
+      "items": {
+        "$ref": "#/definitions/ErrorConfig"
+      }
+    },
+    "api-configs": {
+      "type": "array",
+      "description": "Collection of ApiConfig entities",
+      "items": {
+        "$ref": "#/definitions/ApiConfig"
+      }
+    },
+    "data-configs": {
+      "type": "array",
+      "description": "Collection of DataConfig entities",
+      "items": {
+        "$ref": "#/definitions/DataConfig"
+      }
+    },
+    "performance-targetses": {
+      "type": "array",
+      "description": "Collection of PerformanceTargets entities",
+      "items": {
+        "$ref": "#/definitions/PerformanceTargets"
+      }
+    },
+    "component-references": {
+      "type": "array",
+      "description": "Collection of ComponentReference entities",
+      "items": {
+        "$ref": "#/definitions/ComponentReference"
+      }
+    },
+    "transition-templates": {
+      "type": "array",
+      "description": "Collection of TransitionTemplate entities",
+      "items": {
+        "$ref": "#/definitions/TransitionTemplate"
+      }
+    },
+    "state-action-templates": {
+      "type": "array",
+      "description": "Collection of StateActionTemplate entities",
+      "items": {
+        "$ref": "#/definitions/StateActionTemplate"
+      }
+    },
+    "table-columns": {
+      "type": "array",
+      "description": "Collection of TableColumn entities",
+      "items": {
+        "$ref": "#/definitions/TableColumn"
+      }
+    },
+    "chart-serieses": {
+      "type": "array",
+      "description": "Collection of ChartSeries entities",
+      "items": {
+        "$ref": "#/definitions/ChartSeries"
+      }
+    }
+  },
+  "definitions": {
+    "ComponentType": {
+      "type": "string",
+      "enum": [
+        "form-field",
+        "table",
+        "chart",
+        "card",
+        "list",
+        "text",
+        "image",
+        "video",
+        "audio",
+        "map",
+        "calendar",
+        "timeline",
+        "tree",
+        "custom"
+      ]
+    },
+    "LayoutStyle": {
+      "type": "string",
+      "enum": ["grid", "flex", "stack", "flow", "custom"]
+    },
+    "ActionType": {
+      "type": "string",
+      "enum": [
+        "fetchData",
+        "saveData",
+        "deleteData",
+        "validateForm",
+        "clearForm",
+        "showNotification",
+        "navigateTo",
+        "callAPI",
+        "updateState",
+        "computeValue"
+      ]
+    },
+    "ChannelType": {
+      "type": "string",
+      "enum": ["visual", "voice", "chat", "sms", "multimodal"]
+    },
+    "DataSource": {
+      "type": "string",
+      "enum": [
+        "api-response",
+        "form-data",
+        "route-params",
+        "query-params",
+        "local-storage",
+        "constant",
+        "computed"
+      ]
+    },
+    "TriggerType": {
+      "type": "string",
+      "enum": ["success", "failure", "submit", "cancel", "click", "timeout", "dataReady", "custom"]
+    },
+    "ViewType": {
+      "type": "string",
+      "enum": ["form", "list", "detail", "dashboard", "wizard", "split", "conversational", "custom"]
+    },
+    "ActionComponentType": {
+      "type": "string",
+      "enum": [
+        "button",
+        "menu-item",
+        "link",
+        "voice-command",
+        "chat-button",
+        "sms-keyword",
+        "custom"
+      ]
+    },
+    "ButtonStyle": {
+      "type": "string",
+      "enum": ["primary", "secondary", "danger", "success", "warning", "ghost", "icon"]
+    },
+    "ValidationType": {
+      "type": "string",
+      "enum": [
+        "required",
+        "minLength",
+        "maxLength",
+        "pattern",
+        "email",
+        "url",
+        "min",
+        "max",
+        "custom"
+      ]
+    },
+    "LayoutType": {
+      "type": "string",
+      "enum": ["grid", "flex", "stack", "flow", "fixed", "absolute", "custom"]
+    },
+    "JustifyContent": {
+      "type": "string",
+      "enum": ["start", "end", "center", "space-between", "space-around", "space-evenly"]
+    },
+    "AlignItems": {
+      "type": "string",
+      "enum": ["start", "end", "center", "stretch", "baseline"]
+    },
+    "JustifyItems": {
+      "type": "string",
+      "enum": ["start", "end", "center", "stretch"]
+    },
+    "AlignContent": {
+      "type": "string",
+      "enum": ["start", "end", "center", "stretch", "space-between", "space-around"]
+    },
+    "NotificationType": {
+      "type": "string",
+      "enum": ["toast", "alert", "inline", "banner", "none"]
+    },
+    "HttpMethod": {
+      "type": "string",
+      "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]
+    },
+    "CacheStrategy": {
+      "type": "string",
+      "enum": ["no-cache", "cache-first", "network-first", "stale-while-revalidate"]
+    },
+    "AnimationType": {
+      "type": "string",
+      "enum": ["fade", "slide", "scale", "none"]
+    },
+    "ColumnDisplayType": {
+      "type": "string",
+      "enum": [
+        "text",
+        "number",
+        "currency",
+        "date",
+        "datetime",
+        "boolean",
+        "badge",
+        "link",
+        "image",
+        "avatar",
+        "actions",
+        "custom"
+      ]
+    },
+    "TextAlign": {
+      "type": "string",
+      "enum": ["left", "center", "right"]
+    },
+    "SortDirection": {
+      "type": "string",
+      "enum": ["asc", "desc"]
+    },
+    "FilterType": {
+      "type": "string",
+      "enum": ["text", "select", "multiselect", "date", "daterange", "number", "boolean"]
+    },
+    "StickyPosition": {
+      "type": "string",
+      "enum": ["left", "right", "none"]
+    },
+    "SeriesType": {
+      "type": "string",
+      "enum": [
+        "line",
+        "area",
+        "bar",
+        "column",
+        "pie",
+        "donut",
+        "scatter",
+        "bubble",
+        "radar",
+        "heatmap"
+      ]
+    },
+    "LineStyle": {
+      "type": "string",
+      "enum": ["solid", "dashed", "dotted"]
+    },
+    "LabelPosition": {
+      "type": "string",
+      "enum": ["inside", "outside", "center", "top", "bottom"]
+    },
+    "UXLibrary": {
+      "type": "object",
+      "description": "Collection of reusable UI components and sub-views that can be shared across applications",
+      "required": ["id", "name", "version"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "author": {
+          "type": "string",
+          "minLength": 1
+        },
+        "license": {
+          "type": "string",
+          "minLength": 1
+        },
+        "components": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "subViews": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "statePatterns": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "actionPatterns": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "LibraryComponent": {
+      "type": "object",
+      "description": "Reusable UI component definition that can be instantiated in multiple UXSpecs",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/ComponentType"
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "category": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source": {
+          "type": "object",
+          "description": "Source code reference",
+          "properties": {
+            "reference": {
+              "$ref": "common/source-references.schema.json#/definitions/SourceReference"
+            }
+          }
+        }
+      }
+    },
+    "LibrarySubView": {
+      "type": "object",
+      "description": "Reusable grouping of components that can be composed into views",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "category": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "StatePattern": {
+      "type": "object",
+      "description": "Reusable state machine pattern for common UX flows",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "category": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "ActionPattern": {
+      "type": "object",
+      "description": "Reusable action configuration for common user interactions",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "category": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "UXApplication": {
+      "type": "object",
+      "description": "Application-level UX configuration that groups UXSpecs and defines shared settings",
+      "required": ["id", "name", "channel"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channel": {
+          "$ref": "#/definitions/ChannelType"
+        },
+        "experiences": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "UXSpec": {
+      "type": "object",
+      "description": "Complete UX specification for a single experience (visual, voice, chat, SMS)",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "experience": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source": {
+          "type": "object",
+          "description": "Source code reference",
+          "properties": {
+            "reference": {
+              "$ref": "common/source-references.schema.json#/definitions/SourceReference"
+            }
+          }
+        }
+      }
+    },
+    "ExperienceState": {
+      "type": "object",
+      "description": "Distinct state that the experience can be in (works across all channels)",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "initial": {
+          "type": "boolean"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channel": {
+          "type": "string",
+          "minLength": 1
+        },
+        "onEnter": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "onExit": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transitions": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "enabledComponents": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "disabledComponents": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "hiddenComponents": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "StateAction": {
+      "type": "object",
+      "description": "Action executed during state lifecycle",
+      "required": ["id", "name", "action"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "action": {
+          "$ref": "#/definitions/ActionType"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "StateTransition": {
+      "type": "object",
+      "description": "Transition from current state to another state",
+      "required": ["id", "name", "trigger"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "to": {
+          "type": "string",
+          "minLength": 1
+        },
+        "trigger": {
+          "$ref": "#/definitions/TriggerType"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "actions": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "Condition": {
+      "type": "object",
+      "description": "Boolean expression for guard conditions",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "expression": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "View": {
+      "type": "object",
+      "description": "Routable grouping of components (a complete user experience)",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/ViewType"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "routable": {
+          "type": "boolean"
+        },
+        "layout": {
+          "type": "string",
+          "minLength": 1
+        },
+        "subViews": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "components": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "actions": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "source": {
+          "type": "object",
+          "description": "Source code reference",
+          "properties": {
+            "reference": {
+              "$ref": "common/source-references.schema.json#/definitions/SourceReference"
+            }
+          }
+        }
+      }
+    },
+    "SubView": {
+      "type": "object",
+      "description": "Instance of a LibrarySubView or custom sub-view definition",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "order": {
+          "type": "integer"
+        }
+      }
+    },
+    "ComponentInstance": {
+      "type": "object",
+      "description": "Instance of a LibraryComponent with application-specific configuration",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "order": {
+          "type": "integer"
+        }
+      }
+    },
+    "ActionComponent": {
+      "type": "object",
+      "description": "Interactive element that triggers actions (button, menu, link, voice command)",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/ActionComponentType"
+        },
+        "icon": {
+          "type": "string",
+          "minLength": 1
+        },
+        "disabled": {
+          "type": "boolean"
+        },
+        "tooltip": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channel": {
+          "type": "string",
+          "minLength": 1
+        },
+        "children": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ValidationRule": {
+      "type": "object",
+      "description": "Client-side validation rule for a field",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/ValidationType"
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "LayoutConfig": {
+      "type": "object",
+      "description": "Configuration for UI layout structure, defining grid systems, responsive breakpoints, spacing rules, and component arrangement patterns. Controls visual organization of the interface.",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/LayoutType"
+        },
+        "columns": {
+          "type": "integer"
+        },
+        "rows": {
+          "type": "integer"
+        },
+        "gap": {
+          "type": "string",
+          "minLength": 1
+        },
+        "rowGap": {
+          "type": "string",
+          "minLength": 1
+        },
+        "columnGap": {
+          "type": "string",
+          "minLength": 1
+        },
+        "padding": {
+          "type": "string",
+          "minLength": 1
+        },
+        "margin": {
+          "type": "string",
+          "minLength": 1
+        },
+        "maxWidth": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "ErrorConfig": {
+      "type": "object",
+      "description": "Configuration for error handling and display within UI components, specifying error message formats, retry behavior, fallback content, and user guidance. Ensures consistent error UX.",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "showNotification": {
+          "type": "boolean"
+        },
+        "notificationType": {
+          "$ref": "#/definitions/NotificationType"
+        },
+        "errorMessage": {
+          "type": "string",
+          "minLength": 1
+        },
+        "defaultErrorMessage": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "ApiConfig": {
+      "type": "object",
+      "description": "Configuration for API integration within UI components, specifying endpoints, request/response mapping, authentication, and caching strategies. Connects UI to backend services.",
+      "required": ["id", "name", "operationId", "method", "endpoint", "baseUrl"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "operationId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "method": {
+          "$ref": "#/definitions/HttpMethod"
+        },
+        "endpoint": {
+          "type": "string",
+          "minLength": 1
+        },
+        "baseUrl": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "DataConfig": {
+      "type": "object",
+      "description": "Configuration for data binding and state management within UI components, defining data sources, transformation pipelines, and update triggers. Manages component data flow.",
+      "required": ["id", "name", "source", "target"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source": {
+          "$ref": "#/definitions/DataSource"
+        },
+        "target": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "PerformanceTargets": {
+      "type": "object",
+      "description": "Defines performance SLAs for UI components including load time, interaction responsiveness, and rendering thresholds. Enables performance monitoring and optimization.",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "ComponentReference": {
+      "type": "object",
+      "description": "A reference to another UI component that can be embedded or composed within a parent component. Enables component reuse and modular UI architecture.",
+      "required": ["id", "name", "ref"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "variant": {
+          "type": "string",
+          "minLength": 1
+        },
+        "slot": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "TransitionTemplate": {
+      "type": "object",
+      "description": "Defines reusable animation and transition patterns for state changes, page navigation, or component lifecycle events. Ensures consistent motion design across the application.",
+      "required": ["id", "name", "to", "trigger"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "to": {
+          "type": "string",
+          "minLength": 1
+        },
+        "trigger": {
+          "$ref": "#/definitions/TriggerType"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "StateActionTemplate": {
+      "type": "object",
+      "description": "A reusable template defining actions to execute during component state transitions. Enables standardized behavior patterns for common state changes.",
+      "required": ["id", "name", "action"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "action": {
+          "$ref": "#/definitions/ActionType"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "TableColumn": {
+      "type": "object",
+      "description": "Configuration for a single column within a data table component, specifying header, data binding, sorting, filtering, and rendering options. Defines table structure and behavior.",
+      "required": ["id", "name", "header", "field"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "header": {
+          "type": "string",
+          "minLength": 1
+        },
+        "field": {
+          "type": "string",
+          "minLength": 1
+        },
+        "width": {
+          "type": "string",
+          "minLength": 1
+        },
+        "minWidth": {
+          "type": "string",
+          "minLength": 1
+        },
+        "maxWidth": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "ChartSeries": {
+      "type": "object",
+      "description": "Configuration for a data series within a chart component, specifying data source, visualization type, colors, and legend properties. Defines how data is visualized in charts.",
+      "required": ["id", "name", "label", "dataField"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/SeriesType"
+        },
+        "dataField": {
+          "type": "string",
+          "minLength": 1
+        },
+        "categoryField": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}