@almadar/std 14.24.0 → 14.26.0

package/behaviors/registry/app/organisms/std-property-mgmt.orb

@@ -108,38 +108,38 @@
           "ref": "AppShell.traits.AppLayout",
           "name": "PropertyAppLayout",
           "config": {
-            "searchEvent": "PROPERTY_SEARCH",
-            "notifications": [],
-            "appName": "Property Manager",
-            "notificationClickEvent": "PROPERTY_NOTIFICATIONS_OPEN",
-            "contentTrait": "@trait.PropertyCatalog",
             "navItems": [
               {
-                "href": "/properties",
+                "label": "Properties",
                 "icon": "home",
-                "label": "Properties"
+                "href": "/properties"
               },
               {
-                "href": "/tenants",
-                "label": "Tenants",
-                "icon": "users"
+                "label": "Leases",
+                "icon": "file-text",
+                "href": "/leases"
               },
               {
-                "href": "/leases",
-                "icon": "file-text",
-                "label": "Leases"
+                "label": "Tenants",
+                "href": "/tenants",
+                "icon": "users"
               },
               {
-                "icon": "dollar-sign",
-                "label": "Rent",
-                "href": "/rent-charges"
+                "label": "Rent Charges",
+                "href": "/rent-charges",
+                "icon": "credit-card"
               },
               {
-                "icon": "wrench",
+                "label": "Maintenance",
                 "href": "/maintenance",
-                "label": "Maintenance"
+                "icon": "wrench"
               }
-            ]
+            ],
+            "searchEvent": "PROPERTY_SEARCH",
+            "appName": "Property Management",
+            "notifications": [],
+            "notificationClickEvent": "PROPERTY_NOTIFICATIONS_OPEN",
+            "contentTrait": "@trait.PropertyCatalog"
           },
           "events": {
             "SEARCH": "PROPERTY_SEARCH",
@@ -226,33 +226,32 @@
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
+                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
+                          "gap": "md",
                           "align": "center",
+                          "justify": "between",
                           "children": [
                             {
+                              "type": "stack",
+                              "align": "center",
+                              "gap": "sm",
+                              "direction": "horizontal",
                               "children": [
                                 {
                                   "type": "icon",
                                   "name": "home"
                                 },
                                 {
+                                  "type": "typography",
                                   "content": "Properties",
-                                  "variant": "h2",
-                                  "type": "typography"
+                                  "variant": "h2"
                                 }
-                              ],
-                              "type": "stack",
-                              "align": "center",
-                              "direction": "horizontal",
-                              "gap": "sm"
+                              ]
                             },
                             {
                               "direction": "horizontal",
-                              "gap": "sm",
-                              "type": "stack",
                               "children": [
                                 {
                                   "type": "button",
@@ -261,25 +260,26 @@
                                   "action": "CREATE",
                                   "icon": "plus"
                                 }
-                              ]
+                              ],
+                              "type": "stack",
+                              "gap": "sm"
                             }
                           ],
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "between"
+                          "type": "stack",
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "type": "stack",
+                          "align": "center",
+                          "gap": "md",
                           "children": [
                             "@trait.PropertySearch",
                             "@trait.PropertyFilter"
                           ],
-                          "gap": "md",
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "align": "center"
+                          "direction": "horizontal"
                         },
                         "@trait.PropertyStats",
                         "@trait.PropertyGraphs",
@@ -288,7 +288,7 @@
                         },
                         "@trait.PropertyBrowseList"
                       ],
-                      "gap": "lg",
+                      "direction": "vertical",
                       "type": "stack"
                     }
                   ]
@@ -308,7 +308,6 @@
                     "render-ui",
                     "main",
                     {
-                      "gap": "md",
                       "children": [
                         {
                           "type": "icon",
@@ -322,19 +321,20 @@
                         {
                           "type": "typography",
                           "color": "muted",
-                          "variant": "caption",
-                          "content": "You're all caught up."
+                          "content": "You're all caught up.",
+                          "variant": "caption"
                         },
                         {
+                          "type": "button",
                           "label": "Back to properties",
-                          "action": "INIT",
                           "variant": "ghost",
-                          "type": "button"
+                          "action": "INIT"
                         }
                       ],
-                      "direction": "vertical",
                       "type": "stack",
                       "align": "center",
+                      "direction": "vertical",
+                      "gap": "md",
                       "className": "py-8"
                     }
                   ]
@@ -348,8 +348,8 @@
           "ref": "Search.traits.SearchResultSearch",
           "name": "PropertySearch",
           "config": {
-            "event": "PROPERTY_SEARCH",
-            "placeholder": "Search properties…"
+            "placeholder": "Search properties…",
+            "event": "PROPERTY_SEARCH"
           }
         },
         {
@@ -359,24 +359,24 @@
             "filters": [
               {
                 "field": "propertyType",
-                "label": "Type",
                 "filterType": "select",
                 "options": [
                   "single-family",
                   "multi-family",
                   "commercial",
                   "mixed-use"
-                ]
+                ],
+                "label": "Type"
               },
               {
+                "field": "status",
                 "filterType": "select",
                 "options": [
                   "active",
                   "vacant",
                   "under-renovation"
                 ],
-                "label": "Status",
-                "field": "status"
+                "label": "Status"
               }
             ],
             "event": "PROPERTY_FILTER"
@@ -386,19 +386,18 @@
           "ref": "Stats.traits.StatsItemStats",
           "name": "PropertyStats",
           "config": {
+            "title": "Properties",
             "metrics": [
               {
-                "icon": "home",
-                "label": "Total",
-                "aggregation": "count",
                 "variant": "primary",
-                "format": "number"
+                "label": "Total",
+                "icon": "home",
+                "format": "number",
+                "aggregation": "count"
               },
               {
-                "aggregation": "count",
                 "label": "Active",
-                "icon": "check-circle",
-                "format": "number",
+                "variant": "success",
                 "filter": [
                   "fn",
                   "row",
@@ -408,11 +407,16 @@
                     "active"
                   ]
                 ],
-                "variant": "success"
+                "aggregation": "count",
+                "format": "number",
+                "icon": "check-circle"
               },
               {
+                "icon": "circle",
+                "label": "Vacant",
                 "aggregation": "count",
                 "variant": "warning",
+                "format": "number",
                 "filter": [
                   "fn",
                   "row",
@@ -421,21 +425,17 @@
                     "@row.status",
                     "vacant"
                   ]
-                ],
-                "label": "Vacant",
-                "format": "number",
-                "icon": "circle"
+                ]
               },
               {
-                "label": "Total Units",
                 "icon": "layers",
-                "variant": "info",
-                "field": "unitCount",
+                "label": "Total Units",
                 "aggregation": "sum",
-                "format": "number"
+                "format": "number",
+                "variant": "info",
+                "field": "unitCount"
               }
-            ],
-            "title": "Properties"
+            ]
           },
           "listens": [
             {
@@ -453,12 +453,12 @@
           "name": "PropertyGraphs",
           "config": {
             "title": "Properties by Type",
-            "aggregation": "count",
-            "categoryField": "propertyType",
-            "height": 240.0,
             "subtitle": "Portfolio composition across property types",
+            "height": 240.0,
+            "showLegend": false,
             "chartType": "bar",
-            "showLegend": false
+            "categoryField": "propertyType",
+            "aggregation": "count"
           },
           "listens": [
             {
@@ -476,7 +476,6 @@
           "name": "PropertyBrowseList",
           "linkedEntity": "Property",
           "config": {
-            "gap": "sm",
             "fields": [
               {
                 "icon": "home",
@@ -492,28 +491,29 @@
                 "name": "status"
               },
               {
-                "variant": "caption",
-                "name": "unitCount"
+                "name": "unitCount",
+                "variant": "caption"
               }
             ],
+            "cols": 1.0,
             "itemActions": [
               {
-                "label": "View",
+                "variant": "ghost",
                 "event": "VIEW",
-                "variant": "ghost"
+                "label": "View"
               },
               {
+                "label": "Edit",
                 "variant": "ghost",
-                "event": "EDIT",
-                "label": "Edit"
+                "event": "EDIT"
               },
               {
+                "event": "DELETE",
                 "label": "Delete",
-                "variant": "danger",
-                "event": "DELETE"
+                "variant": "danger"
               }
             ],
-            "cols": 1.0
+            "gap": "sm"
           },
           "listens": [
             {
@@ -563,15 +563,15 @@
           "name": "PropertyCreate",
           "linkedEntity": "Property",
           "config": {
+            "title": "New Property",
             "fields": [
               "address",
               "unitCount",
               "propertyType",
               "status"
             ],
-            "mode": "create",
             "icon": "plus-circle",
-            "title": "New Property"
+            "mode": "create"
           },
           "events": {
             "OPEN": "CREATE"
@@ -592,15 +592,15 @@
           "name": "PropertyEdit",
           "linkedEntity": "Property",
           "config": {
-            "title": "Edit Property",
-            "mode": "edit",
             "fields": [
               "address",
               "unitCount",
               "propertyType",
               "status"
             ],
-            "icon": "edit"
+            "icon": "edit",
+            "title": "Edit Property",
+            "mode": "edit"
           },
           "events": {
             "OPEN": "EDIT"
@@ -621,15 +621,15 @@
           "name": "PropertyView",
           "linkedEntity": "Property",
           "config": {
-            "icon": "eye",
-            "title": "View Property",
-            "mode": "edit",
             "fields": [
               "address",
               "unitCount",
               "propertyType",
               "status"
-            ]
+            ],
+            "icon": "eye",
+            "title": "View Property",
+            "mode": "edit"
           },
           "events": {
             "OPEN": "VIEW"
@@ -651,9 +651,9 @@
           "linkedEntity": "Property",
           "config": {
             "title": "Delete Property",
+            "icon": "alert-triangle",
             "confirmLabel": "Delete",
-            "alertMessage": "This action cannot be undone.",
-            "icon": "alert-triangle"
+            "alertMessage": "This action cannot be undone."
           },
           "events": {
             "REQUEST": "DELETE",
@@ -898,6 +898,832 @@
           ]
         }
       ]
+    },
+    {
+      "name": "LeasePanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-lease",
+          "as": "Lease"
+        }
+      ],
+      "entity": {
+        "name": "Lease",
+        "collection": "leases",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "tenantId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "tenantName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "unitId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "unitLabel",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "startDate",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "endDate",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "monthlyRent",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "pending",
+            "values": [
+              "active",
+              "expired",
+              "terminated",
+              "pending"
+            ]
+          },
+          {
+            "name": "notes",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "LeaseAppLayout",
+          "config": {
+            "contentTrait": "@trait.LeasePanel",
+            "notificationClickEvent": "LEASE_NOTIFICATIONS_OPEN",
+            "searchEvent": "LEASE_SEARCH",
+            "notifications": [],
+            "appName": "Property Management",
+            "navItems": [
+              {
+                "label": "Properties",
+                "href": "/properties",
+                "icon": "home"
+              },
+              {
+                "icon": "file-text",
+                "href": "/leases",
+                "label": "Leases"
+              },
+              {
+                "icon": "users",
+                "label": "Tenants",
+                "href": "/tenants"
+              },
+              {
+                "href": "/rent-charges",
+                "label": "Rent Charges",
+                "icon": "credit-card"
+              },
+              {
+                "href": "/maintenance",
+                "icon": "wrench",
+                "label": "Maintenance"
+              }
+            ]
+          },
+          "events": {
+            "SEARCH": "LEASE_SEARCH",
+            "NOTIFY_CLICK": "LEASE_NOTIFICATIONS_OPEN"
+          }
+        },
+        {
+          "name": "LeasePanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "children": [
+                        {
+                          "align": "center",
+                          "type": "stack",
+                          "children": [
+                            {
+                              "name": "file-text",
+                              "type": "icon"
+                            },
+                            {
+                              "content": "Leases",
+                              "variant": "h2",
+                              "type": "typography"
+                            }
+                          ],
+                          "gap": "sm",
+                          "direction": "horizontal"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.LeaseView"
+                      ],
+                      "gap": "lg"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "Lease.traits.LeaseManager",
+          "name": "LeaseView",
+          "config": {
+            "title": "Leases"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "LeasesPage",
+          "path": "/leases",
+          "traits": [
+            {
+              "ref": "LeaseAppLayout"
+            },
+            {
+              "ref": "LeasePanel"
+            },
+            {
+              "ref": "LeaseView"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "TenantPanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-tenant",
+          "as": "Tenant"
+        }
+      ],
+      "entity": {
+        "name": "Tenant",
+        "collection": "tenants",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "email",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "phone",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "leaseId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "moveInDate",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "moveOutDate",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "prospective",
+            "values": [
+              "current",
+              "former",
+              "prospective"
+            ]
+          },
+          {
+            "name": "notes",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "TenantAppLayout",
+          "config": {
+            "contentTrait": "@trait.TenantPanel",
+            "notifications": [],
+            "navItems": [
+              {
+                "href": "/properties",
+                "label": "Properties",
+                "icon": "home"
+              },
+              {
+                "icon": "file-text",
+                "label": "Leases",
+                "href": "/leases"
+              },
+              {
+                "label": "Tenants",
+                "href": "/tenants",
+                "icon": "users"
+              },
+              {
+                "icon": "credit-card",
+                "label": "Rent Charges",
+                "href": "/rent-charges"
+              },
+              {
+                "href": "/maintenance",
+                "icon": "wrench",
+                "label": "Maintenance"
+              }
+            ],
+            "notificationClickEvent": "TENANT_NOTIFICATIONS_OPEN",
+            "appName": "Property Management",
+            "searchEvent": "TENANT_SEARCH"
+          },
+          "events": {
+            "SEARCH": "TENANT_SEARCH",
+            "NOTIFY_CLICK": "TENANT_NOTIFICATIONS_OPEN"
+          }
+        },
+        {
+          "name": "TenantPanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "gap": "lg",
+                      "direction": "vertical",
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "children": [
+                        {
+                          "direction": "horizontal",
+                          "align": "center",
+                          "children": [
+                            {
+                              "name": "users",
+                              "type": "icon"
+                            },
+                            {
+                              "content": "Tenants",
+                              "type": "typography",
+                              "variant": "h2"
+                            }
+                          ],
+                          "type": "stack",
+                          "gap": "sm"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.TenantView"
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "Tenant.traits.TenantDirectory",
+          "name": "TenantView",
+          "config": {
+            "title": "Tenants"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "TenantsPage",
+          "path": "/tenants",
+          "traits": [
+            {
+              "ref": "TenantAppLayout"
+            },
+            {
+              "ref": "TenantPanel"
+            },
+            {
+              "ref": "TenantView"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "RentChargePanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-rent-charge",
+          "as": "RentCharge"
+        }
+      ],
+      "entity": {
+        "name": "RentCharge",
+        "collection": "rentcharges",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "tenantId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "leaseId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "amount",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "dueDate",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "paidAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "unpaid",
+            "values": [
+              "unpaid",
+              "paid",
+              "overdue",
+              "waived"
+            ]
+          },
+          {
+            "name": "lateFee",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "notes",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "RentChargeAppLayout",
+          "config": {
+            "navItems": [
+              {
+                "href": "/properties",
+                "icon": "home",
+                "label": "Properties"
+              },
+              {
+                "href": "/leases",
+                "icon": "file-text",
+                "label": "Leases"
+              },
+              {
+                "icon": "users",
+                "label": "Tenants",
+                "href": "/tenants"
+              },
+              {
+                "icon": "credit-card",
+                "href": "/rent-charges",
+                "label": "Rent Charges"
+              },
+              {
+                "label": "Maintenance",
+                "href": "/maintenance",
+                "icon": "wrench"
+              }
+            ],
+            "searchEvent": "RENT_CHARGE_SEARCH",
+            "appName": "Property Management",
+            "notifications": [],
+            "notificationClickEvent": "RENT_CHARGE_NOTIFICATIONS_OPEN",
+            "contentTrait": "@trait.RentChargePanel"
+          },
+          "events": {
+            "NOTIFY_CLICK": "RENT_CHARGE_NOTIFICATIONS_OPEN",
+            "SEARCH": "RENT_CHARGE_SEARCH"
+          }
+        },
+        {
+          "name": "RentChargePanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "direction": "vertical",
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "type": "stack",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "credit-card"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "h2",
+                              "content": "Rent Charges"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.RentChargeView"
+                      ],
+                      "gap": "lg"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "RentCharge.traits.RentChargeLedger",
+          "name": "RentChargeView",
+          "config": {
+            "title": "Rent Charges"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "RentChargesPage",
+          "path": "/rent-charges",
+          "traits": [
+            {
+              "ref": "RentChargeAppLayout"
+            },
+            {
+              "ref": "RentChargePanel"
+            },
+            {
+              "ref": "RentChargeView"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "MaintenanceRequestPanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-maintenance-request",
+          "as": "MaintenanceRequest"
+        }
+      ],
+      "entity": {
+        "name": "MaintenanceRequest",
+        "collection": "maintenancerequests",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "unitId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "tenantId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "requesterName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "description",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "priority",
+            "type": "string",
+            "default": "medium",
+            "values": [
+              "low",
+              "medium",
+              "high",
+              "urgent"
+            ]
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "open",
+            "values": [
+              "open",
+              "scheduled",
+              "in_progress",
+              "completed",
+              "cancelled"
+            ]
+          },
+          {
+            "name": "assignedTo",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "requestedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "scheduledAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "completedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "notes",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "MaintenanceRequestAppLayout",
+          "config": {
+            "navItems": [
+              {
+                "icon": "home",
+                "label": "Properties",
+                "href": "/properties"
+              },
+              {
+                "icon": "file-text",
+                "href": "/leases",
+                "label": "Leases"
+              },
+              {
+                "icon": "users",
+                "label": "Tenants",
+                "href": "/tenants"
+              },
+              {
+                "href": "/rent-charges",
+                "label": "Rent Charges",
+                "icon": "credit-card"
+              },
+              {
+                "label": "Maintenance",
+                "icon": "wrench",
+                "href": "/maintenance"
+              }
+            ],
+            "searchEvent": "MAINTENANCE_REQUEST_SEARCH",
+            "contentTrait": "@trait.MaintenanceRequestPanel",
+            "notificationClickEvent": "MAINTENANCE_REQUEST_NOTIFICATIONS_OPEN",
+            "notifications": [],
+            "appName": "Property Management"
+          },
+          "events": {
+            "SEARCH": "MAINTENANCE_REQUEST_SEARCH",
+            "NOTIFY_CLICK": "MAINTENANCE_REQUEST_NOTIFICATIONS_OPEN"
+          }
+        },
+        {
+          "name": "MaintenanceRequestPanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "gap": "lg",
+                      "children": [
+                        {
+                          "gap": "sm",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "tool"
+                            },
+                            {
+                              "content": "Maintenance Requests",
+                              "type": "typography",
+                              "variant": "h2"
+                            }
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "align": "center"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.MaintenanceRequestView"
+                      ],
+                      "direction": "vertical",
+                      "className": "max-w-6xl mx-auto w-full p-4"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "MaintenanceRequest.traits.MaintenanceRequestQueue",
+          "name": "MaintenanceRequestView",
+          "config": {
+            "title": "Maintenance Requests"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "MaintenancePage",
+          "path": "/maintenance",
+          "traits": [
+            {
+              "ref": "MaintenanceRequestAppLayout"
+            },
+            {
+              "ref": "MaintenanceRequestPanel"
+            },
+            {
+              "ref": "MaintenanceRequestView"
+            }
+          ]
+        }
+      ]
     }
   ]
 }