@almadar/std 14.25.0 → 14.27.0

package/dist/behaviors/registry/app/atoms/std-matter.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-matter",
   "version": "1.0.0",
-  "description": "std-matter — legal matter primitive: a single legal case (litigation, contract review, immigration filing) with client, status, lead attorney, and billing reference.",
+  "description": "std-matter — legal matter primitive: a single case (litigation, contract review, immigration filing) with client, status, lead attorney. Lists matters in `browsing`; opens matter detail in `viewing_single` with Close / Hold / Reopen actions.",
   "orbitals": [
     {
       "name": "MatterOrbital",
@@ -85,7 +85,7 @@
           "linkedEntity": "Matter",
           "emits": [
             {
-              "event": "CLOSE_MATTER",
+              "event": "OPEN_MATTER",
               "payloadSchema": [
                 {
                   "name": "id",
@@ -139,56 +139,25 @@
               ]
             },
             {
-              "event": "HOLD_MATTER",
+              "event": "CLOSE_VIEW"
+            },
+            {
+              "event": "CLOSE_MATTER",
               "payloadSchema": [
                 {
                   "name": "id",
                   "type": "string",
                   "required": true
-                },
-                {
-                  "name": "row.id",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "row.matterNumber",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "row.title",
-                  "type": "string",
-                  "required": true
-                },
+                }
+              ]
+            },
+            {
+              "event": "HOLD_MATTER",
+              "payloadSchema": [
                 {
-                  "name": "row.clientName",
+                  "name": "id",
                   "type": "string",
                   "required": true
-                },
-                {
-                  "name": "row.practiceArea",
-                  "type": "string"
-                },
-                {
-                  "name": "row.leadAttorney",
-                  "type": "string"
-                },
-                {
-                  "name": "row.status",
-                  "type": "string"
-                },
-                {
-                  "name": "row.openedAt",
-                  "type": "string"
-                },
-                {
-                  "name": "row.closedAt",
-                  "type": "string"
-                },
-                {
-                  "name": "row.notes",
-                  "type": "string"
                 }
               ]
             },
@@ -199,50 +168,6 @@
                   "name": "id",
                   "type": "string",
                   "required": true
-                },
-                {
-                  "name": "row.id",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "row.matterNumber",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "row.title",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "row.clientName",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "row.practiceArea",
-                  "type": "string"
-                },
-                {
-                  "name": "row.leadAttorney",
-                  "type": "string"
-                },
-                {
-                  "name": "row.status",
-                  "type": "string"
-                },
-                {
-                  "name": "row.openedAt",
-                  "type": "string"
-                },
-                {
-                  "name": "row.closedAt",
-                  "type": "string"
-                },
-                {
-                  "name": "row.notes",
-                  "type": "string"
                 }
               ]
             },
@@ -278,6 +203,9 @@
               {
                 "name": "browsing"
               },
+              {
+                "name": "viewing_single"
+              },
               {
                 "name": "error"
               }
@@ -311,6 +239,21 @@
                   }
                 ]
               },
+              {
+                "key": "OPEN_MATTER",
+                "name": "Open Matter",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "row",
+                    "type": "Matter"
+                  }
+                ]
+              },
               {
                 "key": "CLOSE_MATTER",
                 "name": "Close Matter",
@@ -322,6 +265,10 @@
                   }
                 ]
               },
+              {
+                "key": "CLOSE_VIEW",
+                "name": "Close View"
+              },
               {
                 "key": "HOLD_MATTER",
                 "name": "Hold Matter",
@@ -356,8 +303,8 @@
                     "Matter",
                     {
                       "emit": {
-                        "failure": "MatterLoadFailed",
-                        "success": "MatterLoaded"
+                        "success": "MatterLoaded",
+                        "failure": "MatterLoadFailed"
                       }
                     }
                   ],
@@ -365,10 +312,9 @@
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
-                      "gap": "md",
-                      "align": "center",
+                      "type": "stack",
                       "className": "py-12",
+                      "gap": "md",
                       "children": [
                         {
                           "type": "spinner"
@@ -380,7 +326,8 @@
                           "color": "muted"
                         }
                       ],
-                      "type": "stack"
+                      "direction": "vertical",
+                      "align": "center"
                     }
                   ]
                 ]
@@ -394,327 +341,457 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "children": [
                         {
-                          "entity": {
-                            "id": "matter-overview",
-                            "subtitle": "Litigation, contracts, and regulatory cases",
-                            "title": "Matter Overview"
-                          },
-                          "type": "feature-detail-page-template"
+                          "type": "stack",
+                          "align": "center",
+                          "gap": "sm",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "scale"
+                            },
+                            {
+                              "variant": "h3",
+                              "type": "typography",
+                              "content": "@config.title"
+                            }
+                          ],
+                          "direction": "horizontal"
                         },
                         {
-                          "type": "breadcrumb",
-                          "items": [
+                          "children": [
+                            {
+                              "value": "@payload.data.length",
+                              "label": "Total matters",
+                              "type": "stat-display",
+                              "icon": "scale"
+                            },
                             {
-                              "label": "Court"
+                              "label": "Active",
+                              "value": "34",
+                              "type": "stat-display",
+                              "icon": "play-circle"
                             },
                             {
-                              "label": "Cases"
+                              "value": "6",
+                              "icon": "pause-circle",
+                              "type": "stat-display",
+                              "label": "On hold"
                             },
                             {
-                              "label": "Matter"
+                              "type": "stat-display",
+                              "label": "Closed this month",
+                              "icon": "check-circle",
+                              "value": "12"
                             }
-                          ]
+                          ],
+                          "type": "simple-grid",
+                          "cols": 4.0
                         },
                         {
-                          "currentStep": 1.0,
-                          "steps": [
+                          "type": "divider"
+                        },
+                        {
+                          "cols": 1.0,
+                          "gap": "sm",
+                          "itemActions": [
                             {
-                              "id": "intake",
-                              "label": "Intake"
+                              "icon": "arrow-right",
+                              "variant": "primary",
+                              "label": "Open",
+                              "event": "OPEN_MATTER"
                             },
                             {
-                              "label": "Discovery",
-                              "id": "discovery"
+                              "label": "Close",
+                              "event": "CLOSE_MATTER",
+                              "variant": "danger"
+                            }
+                          ],
+                          "type": "data-grid",
+                          "entity": "@payload.data",
+                          "fields": [
+                            {
+                              "variant": "caption",
+                              "name": "matterNumber",
+                              "label": "Matter #"
                             },
                             {
-                              "label": "Pre-Trial",
-                              "id": "pretrial"
+                              "variant": "caption",
+                              "label": "Title",
+                              "name": "title"
                             },
                             {
-                              "id": "trial",
-                              "label": "Trial"
+                              "label": "Client",
+                              "name": "clientName",
+                              "variant": "caption"
                             },
                             {
-                              "id": "closed",
-                              "label": "Closed"
+                              "variant": "badge",
+                              "name": "practiceArea",
+                              "label": "Practice"
+                            },
+                            {
+                              "variant": "caption",
+                              "name": "leadAttorney",
+                              "label": "Lead"
+                            },
+                            {
+                              "variant": "badge",
+                              "name": "status",
+                              "label": "Status"
                             }
-                          ],
-                          "type": "wizard-progress"
-                        },
+                          ]
+                        }
+                      ],
+                      "direction": "vertical",
+                      "type": "stack",
+                      "gap": "md"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "error",
+                "event": "MatterLoadFailed",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "variant": "error",
+                      "message": "@payload.error",
+                      "type": "alert"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "browsing",
+                "to": "viewing_single",
+                "event": "OPEN_MATTER",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.id",
+                    "@payload.row.id"
+                  ],
+                  [
+                    "set",
+                    "@entity.matterNumber",
+                    "@payload.row.matterNumber"
+                  ],
+                  [
+                    "set",
+                    "@entity.title",
+                    "@payload.row.title"
+                  ],
+                  [
+                    "set",
+                    "@entity.clientName",
+                    "@payload.row.clientName"
+                  ],
+                  [
+                    "set",
+                    "@entity.practiceArea",
+                    "@payload.row.practiceArea"
+                  ],
+                  [
+                    "set",
+                    "@entity.leadAttorney",
+                    "@payload.row.leadAttorney"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "@payload.row.status"
+                  ],
+                  [
+                    "set",
+                    "@entity.openedAt",
+                    "@payload.row.openedAt"
+                  ],
+                  [
+                    "set",
+                    "@entity.closedAt",
+                    "@payload.row.closedAt"
+                  ],
+                  [
+                    "set",
+                    "@entity.notes",
+                    "@payload.row.notes"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "direction": "vertical",
+                      "children": [
                         {
-                          "gap": "sm",
-                          "type": "stack",
                           "children": [
+                            {
+                              "action": "CLOSE_VIEW",
+                              "type": "button",
+                              "variant": "ghost",
+                              "label": "Back"
+                            },
                             {
                               "type": "icon",
                               "name": "scale"
                             },
                             {
-                              "type": "typography",
+                              "content": "@entity.title",
                               "variant": "h3",
-                              "content": "@config.title"
+                              "type": "typography"
+                            },
+                            {
+                              "label": "@entity.practiceArea",
+                              "variant": "primary",
+                              "type": "badge"
+                            },
+                            {
+                              "label": "@entity.status",
+                              "variant": "default",
+                              "type": "badge"
                             }
                           ],
-                          "direction": "horizontal"
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "gap": "md",
-                          "direction": "horizontal",
                           "children": [
                             {
-                              "tree": [
+                              "gap": "md",
+                              "type": "stack",
+                              "direction": "horizontal",
+                              "children": [
                                 {
-                                  "name": "Pleadings",
-                                  "children": [
-                                    {
-                                      "name": "Complaint.pdf"
-                                    },
-                                    {
-                                      "name": "Answer.pdf"
-                                    }
-                                  ]
+                                  "color": "muted",
+                                  "content": "Matter #",
+                                  "variant": "caption",
+                                  "type": "typography"
                                 },
                                 {
-                                  "name": "Discovery",
-                                  "children": [
-                                    {
-                                      "name": "Interrogatories.pdf"
-                                    },
-                                    {
-                                      "name": "Depositions",
-                                      "children": [
-                                        {
-                                          "name": "Smith.pdf"
-                                        }
-                                      ]
-                                    }
-                                  ]
+                                  "type": "typography",
+                                  "variant": "body",
+                                  "content": "@entity.matterNumber"
+                                }
+                              ]
+                            },
+                            {
+                              "gap": "md",
+                              "direction": "horizontal",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Client",
+                                  "color": "muted",
+                                  "variant": "caption"
                                 },
                                 {
-                                  "children": [
-                                    {
-                                      "name": "Motion-to-Dismiss.pdf"
-                                    }
-                                  ],
-                                  "name": "Motions"
+                                  "type": "typography",
+                                  "variant": "body",
+                                  "content": "@entity.clientName"
                                 }
                               ],
-                              "type": "file-tree"
+                              "type": "stack"
                             },
                             {
-                              "direction": "vertical",
-                              "gap": "sm",
+                              "direction": "horizontal",
+                              "children": [
+                                {
+                                  "content": "Lead attorney",
+                                  "type": "typography",
+                                  "color": "muted",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "content": "@entity.leadAttorney",
+                                  "type": "typography",
+                                  "variant": "body"
+                                }
+                              ],
                               "type": "stack",
+                              "gap": "md"
+                            },
+                            {
                               "children": [
                                 {
-                                  "type": "accordion",
-                                  "items": [
-                                    {
-                                      "id": "facts",
-                                      "title": "Facts of the Case",
-                                      "content": "Plaintiff alleges breach of contract dated 2025-08-01."
-                                    },
-                                    {
-                                      "id": "issues",
-                                      "title": "Legal Issues",
-                                      "content": "Material breach, damages calculation, statute of limitations."
-                                    },
-                                    {
-                                      "title": "Strategy",
-                                      "content": "Motion practice followed by summary judgment.",
-                                      "id": "strategy"
-                                    }
-                                  ]
+                                  "type": "typography",
+                                  "content": "Notes",
+                                  "color": "muted",
+                                  "variant": "caption"
                                 },
                                 {
-                                  "position": "top",
-                                  "children": [
-                                    {
-                                      "content": "Rule 12(b)(6) motion pending",
-                                      "type": "typography"
-                                    }
-                                  ],
-                                  "type": "law-reference-tooltip",
-                                  "reference": {
-                                    "title": "Failure to State a Claim",
-                                    "citation": "Fed. R. Civ. P. 12(b)(6)"
-                                  }
+                                  "type": "typography",
+                                  "variant": "body",
+                                  "content": "@entity.notes"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "type": "stack",
+                              "direction": "horizontal"
                             }
                           ],
+                          "direction": "vertical",
+                          "gap": "sm",
                           "type": "stack"
                         },
                         {
-                          "type": "document-viewer",
-                          "src": "/docs/complaint.pdf",
-                          "documentType": "pdf",
-                          "title": "Complaint.pdf",
-                          "showToolbar": true,
-                          "totalPages": 24.0,
-                          "currentPage": 1.0
-                        },
-                        {
-                          "type": "doc-pagination",
-                          "prev": {
-                            "action": "DOC_PREV",
-                            "label": "Previous Page"
-                          },
-                          "next": {
-                            "action": "DOC_NEXT",
-                            "label": "Next Page"
-                          }
+                          "type": "divider"
                         },
                         {
-                          "quests": [
-                            {
-                              "status": "active",
-                              "title": "File Answer",
-                              "id": "answer-due",
-                              "deadline": "2026-06-15"
-                            },
+                          "cols": 2.0,
+                          "type": "simple-grid",
+                          "children": [
                             {
-                              "status": "pending",
-                              "id": "discovery-cutoff",
-                              "deadline": "2026-08-01",
-                              "title": "Discovery Cutoff"
+                              "value": "@entity.openedAt",
+                              "icon": "calendar",
+                              "type": "stat-display",
+                              "label": "Opened"
                             },
                             {
-                              "title": "Pretrial Brief",
-                              "status": "pending",
-                              "deadline": "2026-09-15",
-                              "id": "pretrial-brief"
+                              "icon": "calendar-check",
+                              "type": "stat-display",
+                              "value": "@entity.closedAt",
+                              "label": "Closed"
                             }
-                          ],
-                          "type": "quest-tracker",
-                          "activeQuestId": "answer-due"
-                        },
-                        {
-                          "data": {
-                            "current": "discovery",
-                            "initial": "intake",
-                            "states": [
-                              "intake",
-                              "discovery",
-                              "pretrial",
-                              "trial",
-                              "closed"
-                            ]
-                          },
-                          "type": "behavior-view"
+                          ]
                         },
                         {
-                          "features": [
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
                             {
-                              "type": "venue",
-                              "id": "courthouse",
-                              "label": "Superior Court"
+                              "action": "CLOSE_MATTER",
+                              "label": "Close Matter",
+                              "actionPayload": {
+                                "id": "@entity.id"
+                              },
+                              "type": "button",
+                              "variant": "danger"
                             },
                             {
-                              "type": "person",
-                              "id": "judge",
-                              "label": "Hon. J. Carter"
+                              "type": "button",
+                              "label": "Hold",
+                              "variant": "secondary",
+                              "action": "HOLD_MATTER",
+                              "actionPayload": {
+                                "id": "@entity.id"
+                              }
                             },
                             {
-                              "id": "opposing",
-                              "type": "party",
-                              "label": "Opposing Counsel"
+                              "label": "Reopen",
+                              "actionPayload": {
+                                "id": "@entity.id"
+                              },
+                              "type": "button",
+                              "variant": "primary",
+                              "action": "REOPEN_MATTER"
                             }
                           ],
-                          "type": "feature-renderer"
-                        },
+                          "type": "stack"
+                        }
+                      ],
+                      "type": "stack",
+                      "gap": "md"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "browsing",
+                "to": "loading",
+                "event": "CLOSE_MATTER",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.id",
+                    "@payload.id"
+                  ],
+                  [
+                    "fetch",
+                    "Matter",
+                    {
+                      "emit": {
+                        "success": "MatterLoaded",
+                        "failure": "MatterLoadFailed"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "py-12",
+                      "children": [
                         {
-                          "type": "content-renderer",
-                          "content": "Status conference scheduled. All parties to appear. Discovery is ongoing.",
-                          "direction": "ltr"
+                          "type": "spinner"
                         },
                         {
-                          "cols": 1.0,
-                          "gap": "sm",
-                          "entity": "@payload.data",
-                          "itemActions": [
-                            {
-                              "event": "CLOSE_MATTER",
-                              "label": "Close",
-                              "variant": "primary"
-                            },
-                            {
-                              "event": "HOLD_MATTER",
-                              "variant": "ghost",
-                              "label": "Hold"
-                            },
-                            {
-                              "label": "Reopen",
-                              "variant": "ghost",
-                              "event": "REOPEN_MATTER"
-                            }
-                          ],
-                          "fields": [
-                            {
-                              "name": "matterNumber",
-                              "label": "Matter #",
-                              "variant": "caption"
-                            },
-                            {
-                              "variant": "caption",
-                              "name": "title",
-                              "label": "Title"
-                            },
-                            {
-                              "variant": "caption",
-                              "name": "clientName",
-                              "label": "Client"
-                            },
-                            {
-                              "name": "practiceArea",
-                              "variant": "badge",
-                              "label": "Practice"
-                            },
-                            {
-                              "variant": "caption",
-                              "label": "Lead",
-                              "name": "leadAttorney"
-                            },
-                            {
-                              "variant": "badge",
-                              "name": "status",
-                              "label": "Status"
-                            }
-                          ],
-                          "type": "data-grid"
+                          "color": "muted",
+                          "variant": "caption",
+                          "type": "typography",
+                          "content": "Closing matter…"
                         }
                       ],
+                      "align": "center",
+                      "gap": "md",
                       "direction": "vertical",
-                      "gap": "md"
+                      "type": "stack"
                     }
                   ]
                 ]
               },
               {
-                "from": "loading",
-                "to": "error",
-                "event": "MatterLoadFailed",
+                "from": "viewing_single",
+                "to": "loading",
+                "event": "CLOSE_VIEW",
                 "effects": [
+                  [
+                    "fetch",
+                    "Matter",
+                    {
+                      "emit": {
+                        "success": "MatterLoaded",
+                        "failure": "MatterLoadFailed"
+                      }
+                    }
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "alert",
-                      "variant": "error",
-                      "message": "@payload.error"
+                      "align": "center",
+                      "type": "stack",
+                      "gap": "md",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Loading matters…",
+                          "variant": "caption",
+                          "type": "typography"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "className": "py-12"
                     }
                   ]
                 ]
               },
               {
-                "from": "browsing",
-                "to": "browsing",
+                "from": "viewing_single",
+                "to": "loading",
                 "event": "CLOSE_MATTER",
                 "effects": [
                   [
@@ -722,20 +799,43 @@
                     "@entity.id",
                     "@payload.id"
                   ],
+                  [
+                    "fetch",
+                    "Matter",
+                    {
+                      "emit": {
+                        "failure": "MatterLoadFailed",
+                        "success": "MatterLoaded"
+                      }
+                    }
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "alert",
-                      "variant": "success",
-                      "message": "Matter closed"
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "content": "Closing matter…",
+                          "type": "typography",
+                          "variant": "caption",
+                          "color": "muted"
+                        }
+                      ],
+                      "gap": "md",
+                      "direction": "vertical",
+                      "type": "stack",
+                      "className": "py-12",
+                      "align": "center"
                     }
                   ]
                 ]
               },
               {
-                "from": "browsing",
-                "to": "browsing",
+                "from": "viewing_single",
+                "to": "loading",
                 "event": "HOLD_MATTER",
                 "effects": [
                   [
@@ -743,20 +843,43 @@
                     "@entity.id",
                     "@payload.id"
                   ],
+                  [
+                    "fetch",
+                    "Matter",
+                    {
+                      "emit": {
+                        "success": "MatterLoaded",
+                        "failure": "MatterLoadFailed"
+                      }
+                    }
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "alert",
-                      "variant": "info",
-                      "message": "Matter on hold"
+                      "className": "py-12",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "content": "Putting matter on hold…",
+                          "variant": "caption",
+                          "color": "muted",
+                          "type": "typography"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "type": "stack",
+                      "align": "center",
+                      "gap": "md"
                     }
                   ]
                 ]
               },
               {
-                "from": "browsing",
-                "to": "browsing",
+                "from": "viewing_single",
+                "to": "loading",
                 "event": "REOPEN_MATTER",
                 "effects": [
                   [
@@ -764,13 +887,36 @@
                     "@entity.id",
                     "@payload.id"
                   ],
+                  [
+                    "fetch",
+                    "Matter",
+                    {
+                      "emit": {
+                        "failure": "MatterLoadFailed",
+                        "success": "MatterLoaded"
+                      }
+                    }
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "alert",
-                      "message": "Matter reopened",
-                      "variant": "info"
+                      "className": "py-12",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Reopening matter…",
+                          "variant": "caption",
+                          "color": "muted"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "type": "stack",
+                      "gap": "md",
+                      "align": "center"
                     }
                   ]
                 ]
@@ -794,8 +940,8 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner",
-                      "size": "sm"
+                      "size": "sm",
+                      "type": "spinner"
                     }
                   ]
                 ]
@@ -824,4 +970,4 @@
       ]
     }
   ]
-}
+}