@almadar/std 14.24.0 → 14.26.0

package/dist/behaviors/registry/app/organisms/std-time-tracking.orb

@@ -117,16 +117,20 @@
           "ref": "AppShell.traits.AppLayout",
           "name": "EmployeeAppLayout",
           "config": {
+            "notificationClickEvent": "EMPLOYEE_NOTIFICATIONS_OPEN",
+            "contentTrait": "@trait.EmployeeCatalog",
+            "notifications": [],
+            "appName": "Time Tracking",
             "navItems": [
               {
-                "icon": "users",
                 "href": "/employees",
-                "label": "Employees"
+                "label": "Employees",
+                "icon": "users"
               },
               {
-                "icon": "calendar",
+                "href": "/timesheets",
                 "label": "Timesheets",
-                "href": "/timesheets"
+                "icon": "clipboard"
               },
               {
                 "label": "Time Entries",
@@ -134,25 +138,21 @@
                 "href": "/time-entries"
               },
               {
-                "icon": "dollar-sign",
-                "href": "/billable-hours",
-                "label": "Billable Hours"
+                "label": "Billable Hours",
+                "href": "/billable",
+                "icon": "dollar-sign"
               },
               {
+                "label": "Approvals",
                 "href": "/approvals",
-                "icon": "check-circle",
-                "label": "Approvals"
+                "icon": "check-circle"
               }
             ],
-            "appName": "Time Tracking",
-            "searchEvent": "EMPLOYEE_SEARCH",
-            "notifications": [],
-            "notificationClickEvent": "EMPLOYEE_NOTIFICATIONS_OPEN",
-            "contentTrait": "@trait.EmployeeCatalog"
+            "searchEvent": "EMPLOYEE_SEARCH"
           },
           "events": {
-            "NOTIFY_CLICK": "EMPLOYEE_NOTIFICATIONS_OPEN",
-            "SEARCH": "EMPLOYEE_SEARCH"
+            "SEARCH": "EMPLOYEE_SEARCH",
+            "NOTIFY_CLICK": "EMPLOYEE_NOTIFICATIONS_OPEN"
           }
         },
         {
@@ -236,15 +236,18 @@
                     "main",
                     {
                       "type": "stack",
+                      "direction": "vertical",
                       "children": [
                         {
-                          "justify": "between",
-                          "direction": "horizontal",
                           "gap": "md",
                           "align": "center",
+                          "direction": "horizontal",
+                          "type": "stack",
                           "children": [
                             {
+                              "direction": "horizontal",
                               "align": "center",
+                              "type": "stack",
                               "gap": "sm",
                               "children": [
                                 {
@@ -252,43 +255,41 @@
                                   "name": "users"
                                 },
                                 {
+                                  "content": "Employees",
                                   "variant": "h2",
-                                  "type": "typography",
-                                  "content": "Employees"
+                                  "type": "typography"
                                 }
-                              ],
-                              "direction": "horizontal",
-                              "type": "stack"
+                              ]
                             },
                             {
                               "direction": "horizontal",
+                              "type": "stack",
+                              "gap": "sm",
                               "children": [
                                 {
+                                  "icon": "plus",
                                   "type": "button",
-                                  "variant": "primary",
+                                  "action": "CREATE",
                                   "label": "New Employee",
-                                  "icon": "plus",
-                                  "action": "CREATE"
+                                  "variant": "primary"
                                 }
-                              ],
-                              "type": "stack",
-                              "gap": "sm"
+                              ]
                             }
                           ],
-                          "type": "stack"
+                          "justify": "between"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "type": "stack",
                           "gap": "md",
-                          "direction": "horizontal",
                           "align": "center",
                           "children": [
                             "@trait.EmployeeSearch",
                             "@trait.EmployeeFilter"
                           ],
-                          "type": "stack"
+                          "direction": "horizontal"
                         },
                         "@trait.EmployeeStats",
                         "@trait.EmployeeGraphs",
@@ -297,8 +298,7 @@
                         },
                         "@trait.EmployeeBrowseList"
                       ],
-                      "gap": "lg",
-                      "direction": "vertical"
+                      "gap": "lg"
                     }
                   ]
                 ]
@@ -317,14 +317,14 @@
                     "render-ui",
                     "main",
                     {
-                      "gap": "md",
-                      "type": "stack",
                       "className": "py-8",
+                      "direction": "vertical",
+                      "gap": "md",
                       "align": "center",
                       "children": [
                         {
-                          "name": "bell",
-                          "type": "icon"
+                          "type": "icon",
+                          "name": "bell"
                         },
                         {
                           "variant": "h3",
@@ -332,19 +332,19 @@
                           "type": "typography"
                         },
                         {
+                          "variant": "caption",
                           "type": "typography",
-                          "color": "muted",
                           "content": "You're all caught up.",
-                          "variant": "caption"
+                          "color": "muted"
                         },
                         {
-                          "type": "button",
                           "variant": "ghost",
+                          "label": "Back to employees",
                           "action": "INIT",
-                          "label": "Back to employees"
+                          "type": "button"
                         }
                       ],
-                      "direction": "vertical"
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -357,8 +357,8 @@
           "ref": "Search.traits.SearchResultSearch",
           "name": "EmployeeSearch",
           "config": {
-            "event": "EMPLOYEE_SEARCH",
-            "placeholder": "Search employees…"
+            "placeholder": "Search employees…",
+            "event": "EMPLOYEE_SEARCH"
           }
         },
         {
@@ -369,8 +369,8 @@
             "filters": [
               {
                 "label": "Department",
-                "filterType": "select",
                 "field": "department",
+                "filterType": "select",
                 "options": [
                   "engineering",
                   "sales",
@@ -380,8 +380,8 @@
                 ]
               },
               {
-                "field": "status",
                 "label": "Status",
+                "field": "status",
                 "options": [
                   "active",
                   "on-leave",
@@ -398,13 +398,16 @@
           "config": {
             "metrics": [
               {
-                "label": "Total",
-                "format": "number",
                 "variant": "primary",
+                "format": "number",
+                "aggregation": "count",
                 "icon": "users",
-                "aggregation": "count"
+                "label": "Total"
               },
               {
+                "aggregation": "count",
+                "variant": "success",
+                "format": "number",
                 "filter": [
                   "fn",
                   "row",
@@ -414,17 +417,13 @@
                     "active"
                   ]
                 ],
-                "variant": "success",
-                "aggregation": "count",
-                "icon": "check-circle",
                 "label": "Active",
-                "format": "number"
+                "icon": "check-circle"
               },
               {
-                "variant": "warning",
-                "aggregation": "count",
                 "label": "On Leave",
-                "format": "number",
+                "icon": "pause-circle",
+                "variant": "warning",
                 "filter": [
                   "fn",
                   "row",
@@ -434,15 +433,16 @@
                     "on-leave"
                   ]
                 ],
-                "icon": "pause-circle"
+                "aggregation": "count",
+                "format": "number"
               },
               {
-                "label": "Avg Rate",
                 "icon": "dollar-sign",
-                "field": "defaultHourlyRate",
                 "variant": "info",
-                "format": "currency",
-                "aggregation": "avg"
+                "field": "defaultHourlyRate",
+                "label": "Avg Rate",
+                "aggregation": "avg",
+                "format": "currency"
               }
             ],
             "title": "Employees"
@@ -462,13 +462,13 @@
           "ref": "Graphs.traits.GraphItemGraph",
           "name": "EmployeeGraphs",
           "config": {
-            "showLegend": false,
             "chartType": "bar",
             "categoryField": "department",
-            "title": "Employees by Department",
+            "height": 240.0,
             "aggregation": "count",
-            "subtitle": "Workforce distribution across departments",
-            "height": 240.0
+            "showLegend": false,
+            "title": "Employees by Department",
+            "subtitle": "Workforce distribution across departments"
           },
           "listens": [
             {
@@ -486,20 +486,19 @@
           "name": "EmployeeBrowseList",
           "linkedEntity": "Employee",
           "config": {
-            "gap": "sm",
             "fields": [
               {
-                "name": "name",
                 "variant": "h3",
+                "name": "name",
                 "icon": "user"
               },
               {
-                "name": "role",
-                "variant": "caption"
+                "variant": "caption",
+                "name": "role"
               },
               {
-                "name": "department",
-                "variant": "badge"
+                "variant": "badge",
+                "name": "department"
               },
               {
                 "name": "status",
@@ -512,21 +511,22 @@
             ],
             "itemActions": [
               {
-                "variant": "ghost",
                 "label": "View",
-                "event": "VIEW"
+                "event": "VIEW",
+                "variant": "ghost"
               },
               {
-                "label": "Edit",
                 "variant": "ghost",
+                "label": "Edit",
                 "event": "EDIT"
               },
               {
-                "event": "DELETE",
+                "variant": "danger",
                 "label": "Delete",
-                "variant": "danger"
+                "event": "DELETE"
               }
             ],
+            "gap": "sm",
             "cols": 1.0
           },
           "listens": [
@@ -577,8 +577,6 @@
           "name": "EmployeeCreate",
           "linkedEntity": "Employee",
           "config": {
-            "title": "New Employee",
-            "mode": "create",
             "fields": [
               "name",
               "email",
@@ -588,7 +586,9 @@
               "hireDate",
               "defaultHourlyRate"
             ],
-            "icon": "plus-circle"
+            "icon": "plus-circle",
+            "title": "New Employee",
+            "mode": "create"
           },
           "events": {
             "OPEN": "CREATE"
@@ -610,7 +610,7 @@
           "linkedEntity": "Employee",
           "config": {
             "icon": "edit",
-            "title": "Edit Employee",
+            "mode": "edit",
             "fields": [
               "name",
               "email",
@@ -620,7 +620,7 @@
               "hireDate",
               "defaultHourlyRate"
             ],
-            "mode": "edit"
+            "title": "Edit Employee"
           },
           "events": {
             "OPEN": "EDIT"
@@ -642,6 +642,7 @@
           "linkedEntity": "Employee",
           "config": {
             "mode": "edit",
+            "title": "View Employee",
             "fields": [
               "name",
               "email",
@@ -651,7 +652,6 @@
               "hireDate",
               "defaultHourlyRate"
             ],
-            "title": "View Employee",
             "icon": "eye"
           },
           "events": {
@@ -673,9 +673,9 @@
           "name": "EmployeeDelete",
           "linkedEntity": "Employee",
           "config": {
-            "confirmLabel": "Delete",
             "alertMessage": "This action cannot be undone.",
             "icon": "alert-triangle",
+            "confirmLabel": "Delete",
             "title": "Delete Employee"
           },
           "events": {
@@ -921,6 +921,882 @@
           ]
         }
       ]
+    },
+    {
+      "name": "TimesheetPanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-timesheet",
+          "as": "Timesheet"
+        }
+      ],
+      "entity": {
+        "name": "Timesheet",
+        "collection": "timesheets",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "employeeId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "employeeName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "periodStart",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "periodEnd",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "totalHours",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "billableHours",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "draft",
+            "values": [
+              "draft",
+              "submitted",
+              "approved",
+              "rejected",
+              "needs-revision"
+            ]
+          },
+          {
+            "name": "submittedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "approvedBy",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "approvedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "notes",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "pendingId",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "TimesheetAppLayout",
+          "config": {
+            "appName": "Time Tracking",
+            "navItems": [
+              {
+                "label": "Employees",
+                "href": "/employees",
+                "icon": "users"
+              },
+              {
+                "icon": "clipboard",
+                "label": "Timesheets",
+                "href": "/timesheets"
+              },
+              {
+                "href": "/time-entries",
+                "icon": "clock",
+                "label": "Time Entries"
+              },
+              {
+                "href": "/billable",
+                "icon": "dollar-sign",
+                "label": "Billable Hours"
+              },
+              {
+                "label": "Approvals",
+                "icon": "check-circle",
+                "href": "/approvals"
+              }
+            ],
+            "searchEvent": "TIMESHEET_SEARCH",
+            "contentTrait": "@trait.TimesheetPanel",
+            "notifications": [],
+            "notificationClickEvent": "TIMESHEET_NOTIFICATIONS_OPEN"
+          },
+          "events": {
+            "NOTIFY_CLICK": "TIMESHEET_NOTIFICATIONS_OPEN",
+            "SEARCH": "TIMESHEET_SEARCH"
+          }
+        },
+        {
+          "name": "TimesheetPanel",
+          "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": [
+                        {
+                          "direction": "horizontal",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "clipboard"
+                            },
+                            {
+                              "content": "Timesheets",
+                              "variant": "h2",
+                              "type": "typography"
+                            }
+                          ],
+                          "align": "center",
+                          "type": "stack",
+                          "gap": "sm"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.TimesheetLedgerView"
+                      ],
+                      "gap": "lg"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "Timesheet.traits.TimesheetLedger",
+          "name": "TimesheetLedgerView",
+          "config": {
+            "title": "Timesheets"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "TimesheetsPage",
+          "path": "/timesheets",
+          "traits": [
+            {
+              "ref": "TimesheetAppLayout"
+            },
+            {
+              "ref": "TimesheetPanel"
+            },
+            {
+              "ref": "TimesheetLedgerView"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "TimeEntryPanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-time-entry",
+          "as": "TimeEntry"
+        }
+      ],
+      "entity": {
+        "name": "TimeEntry",
+        "collection": "timeentries",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "timesheetId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "projectId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "projectName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "taskDescription",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "workDate",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "hours",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "billable",
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "hourlyRate",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "draft",
+            "values": [
+              "draft",
+              "submitted",
+              "approved",
+              "rejected"
+            ]
+          },
+          {
+            "name": "notes",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "pendingId",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "TimeEntryAppLayout",
+          "config": {
+            "searchEvent": "TIME_ENTRY_SEARCH",
+            "contentTrait": "@trait.TimeEntryPanel",
+            "navItems": [
+              {
+                "href": "/employees",
+                "icon": "users",
+                "label": "Employees"
+              },
+              {
+                "href": "/timesheets",
+                "icon": "clipboard",
+                "label": "Timesheets"
+              },
+              {
+                "href": "/time-entries",
+                "label": "Time Entries",
+                "icon": "clock"
+              },
+              {
+                "icon": "dollar-sign",
+                "label": "Billable Hours",
+                "href": "/billable"
+              },
+              {
+                "label": "Approvals",
+                "href": "/approvals",
+                "icon": "check-circle"
+              }
+            ],
+            "appName": "Time Tracking",
+            "notifications": [],
+            "notificationClickEvent": "TIME_ENTRY_NOTIFICATIONS_OPEN"
+          },
+          "events": {
+            "SEARCH": "TIME_ENTRY_SEARCH",
+            "NOTIFY_CLICK": "TIME_ENTRY_NOTIFICATIONS_OPEN"
+          }
+        },
+        {
+          "name": "TimeEntryPanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "type": "stack",
+                      "gap": "lg",
+                      "children": [
+                        {
+                          "direction": "horizontal",
+                          "align": "center",
+                          "gap": "sm",
+                          "type": "stack",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "clock"
+                            },
+                            {
+                              "variant": "h2",
+                              "content": "Time Entries",
+                              "type": "typography"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.TimeEntryLogView"
+                      ],
+                      "direction": "vertical"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "TimeEntry.traits.TimeEntryLog",
+          "name": "TimeEntryLogView",
+          "config": {
+            "title": "Time Entries"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "TimeEntriesPage",
+          "path": "/time-entries",
+          "traits": [
+            {
+              "ref": "TimeEntryAppLayout"
+            },
+            {
+              "ref": "TimeEntryPanel"
+            },
+            {
+              "ref": "TimeEntryLogView"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "BillableHourTimeTrackingOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-billable-hour",
+          "as": "BillableHour"
+        }
+      ],
+      "entity": {
+        "name": "BillableHour",
+        "collection": "billablehours",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "workerId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "workerName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "matterId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "projectId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "workDate",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "hours",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "rate",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "description",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "isBillable",
+            "type": "boolean",
+            "default": true
+          },
+          {
+            "name": "invoiceStatus",
+            "type": "string",
+            "default": "unbilled",
+            "values": [
+              "unbilled",
+              "invoiced",
+              "paid",
+              "written_off"
+            ]
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "BillableHourAppLayout",
+          "config": {
+            "notificationClickEvent": "BILLABLE_HOUR_NOTIFICATIONS_OPEN",
+            "appName": "Time Tracking",
+            "searchEvent": "BILLABLE_HOUR_SEARCH",
+            "contentTrait": "@trait.BillableHourPanel",
+            "navItems": [
+              {
+                "label": "Employees",
+                "href": "/employees",
+                "icon": "users"
+              },
+              {
+                "label": "Timesheets",
+                "href": "/timesheets",
+                "icon": "clipboard"
+              },
+              {
+                "icon": "clock",
+                "href": "/time-entries",
+                "label": "Time Entries"
+              },
+              {
+                "label": "Billable Hours",
+                "icon": "dollar-sign",
+                "href": "/billable"
+              },
+              {
+                "href": "/approvals",
+                "label": "Approvals",
+                "icon": "check-circle"
+              }
+            ],
+            "notifications": []
+          },
+          "events": {
+            "NOTIFY_CLICK": "BILLABLE_HOUR_NOTIFICATIONS_OPEN",
+            "SEARCH": "BILLABLE_HOUR_SEARCH"
+          }
+        },
+        {
+          "name": "BillableHourPanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "gap": "lg",
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "children": [
+                        {
+                          "gap": "sm",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "dollar-sign"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Billable Hours",
+                              "variant": "h2"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "align": "center"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.BillableHourTimesheetView"
+                      ],
+                      "type": "stack",
+                      "direction": "vertical"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "BillableHour.traits.BillableHourTimesheet",
+          "name": "BillableHourTimesheetView",
+          "config": {
+            "title": "Billable Hours"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "BillablePage",
+          "path": "/billable",
+          "traits": [
+            {
+              "ref": "BillableHourAppLayout"
+            },
+            {
+              "ref": "BillableHourPanel"
+            },
+            {
+              "ref": "BillableHourTimesheetView"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "ApprovalRequestPanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-approval-request",
+          "as": "ApprovalRequest"
+        }
+      ],
+      "entity": {
+        "name": "ApprovalRequest",
+        "collection": "approvalrequests",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "title",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "targetType",
+            "type": "string",
+            "default": "timesheet",
+            "values": [
+              "timesheet",
+              "expense-report",
+              "pto-request",
+              "purchase-order",
+              "change-order",
+              "other"
+            ]
+          },
+          {
+            "name": "targetId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "requestedBy",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "requestedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "assignedApprover",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "approverDecision",
+            "type": "string",
+            "default": "pending",
+            "values": [
+              "pending",
+              "approved",
+              "rejected",
+              "needs-info"
+            ]
+          },
+          {
+            "name": "decidedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "comment",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "draft",
+            "values": [
+              "draft",
+              "submitted",
+              "approved",
+              "rejected",
+              "withdrawn"
+            ]
+          },
+          {
+            "name": "pendingId",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "ApprovalRequestAppLayout",
+          "config": {
+            "notificationClickEvent": "APPROVAL_REQUEST_NOTIFICATIONS_OPEN",
+            "contentTrait": "@trait.ApprovalRequestPanel",
+            "appName": "Time Tracking",
+            "navItems": [
+              {
+                "icon": "users",
+                "href": "/employees",
+                "label": "Employees"
+              },
+              {
+                "label": "Timesheets",
+                "href": "/timesheets",
+                "icon": "clipboard"
+              },
+              {
+                "href": "/time-entries",
+                "icon": "clock",
+                "label": "Time Entries"
+              },
+              {
+                "icon": "dollar-sign",
+                "label": "Billable Hours",
+                "href": "/billable"
+              },
+              {
+                "icon": "check-circle",
+                "label": "Approvals",
+                "href": "/approvals"
+              }
+            ],
+            "searchEvent": "APPROVAL_REQUEST_SEARCH",
+            "notifications": []
+          },
+          "events": {
+            "SEARCH": "APPROVAL_REQUEST_SEARCH",
+            "NOTIFY_CLICK": "APPROVAL_REQUEST_NOTIFICATIONS_OPEN"
+          }
+        },
+        {
+          "name": "ApprovalRequestPanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "gap": "lg",
+                      "type": "stack",
+                      "direction": "vertical",
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "children": [
+                        {
+                          "gap": "sm",
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "check-circle"
+                            },
+                            {
+                              "variant": "h2",
+                              "type": "typography",
+                              "content": "Approvals"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.ApprovalRequestPipelineView"
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "ApprovalRequest.traits.ApprovalRequestPipeline",
+          "name": "ApprovalRequestPipelineView",
+          "config": {
+            "title": "Approval Requests"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "ApprovalsPage",
+          "path": "/approvals",
+          "traits": [
+            {
+              "ref": "ApprovalRequestAppLayout"
+            },
+            {
+              "ref": "ApprovalRequestPanel"
+            },
+            {
+              "ref": "ApprovalRequestPipelineView"
+            }
+          ]
+        }
+      ]
     }
   ]
 }