@almadar/std 16.187.0 → 16.189.0

package/behaviors/registry/ui/core/molecules/ui-document-panel.orb

@@ -0,0 +1,655 @@
+{
+  "description": "DocumentPanel — a record rendered as one continuous document: editable title over the rich-text body, editing controls tucked into the header corner. — UI factory (1:1 with the @almadar/ui document-panel pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M13ZXC5NAPHRZWRBV03GQK46": {
+        "bakedName": "DocumentPanelItem",
+        "curName": "DocumentPanelItem",
+        "id": "ent_01M13ZXC5NAPHRZWRBV03GQK46",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M13ZXC5N0V3HVHF8B4GR9037": {
+        "bakedName": "@config.editEvent",
+        "curName": "@config.editEvent",
+        "id": "evt_01M13ZXC5N0V3HVHF8B4GR9037",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ": {
+        "bakedName": "DocumentPanelLoaded",
+        "curName": "DocumentPanelLoaded",
+        "id": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "evt_01M13ZXC5N2JWNJQNCQBM7ZV84": {
+        "bakedName": "TITLE_COMMIT",
+        "curName": "TITLE_COMMIT",
+        "id": "evt_01M13ZXC5N2JWNJQNCQBM7ZV84",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "evt_01M13ZXC5NFRPB6WH1N017BAQ8": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M13ZXC5NFRPB6WH1N017BAQ8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "evt_01M13ZXC5NGG4N5VG3W0DHZTJJ": {
+        "bakedName": "CONTENT_CHANGE",
+        "curName": "CONTENT_CHANGE",
+        "id": "evt_01M13ZXC5NGG4N5VG3W0DHZTJJ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "evt_01M13ZXC5NHMYWEH0Q87APMFPE": {
+        "bakedName": "@config.doneEvent",
+        "curName": "@config.doneEvent",
+        "id": "evt_01M13ZXC5NHMYWEH0Q87APMFPE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "evt_01M13ZXC5NM3Y5VQW65DAM1JW7": {
+        "bakedName": "@config.contentChangeEvent",
+        "curName": "@config.contentChangeEvent",
+        "id": "evt_01M13ZXC5NM3Y5VQW65DAM1JW7",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "evt_01M13ZXC5NZ2ZF7NK4XFSNNJ3T": {
+        "bakedName": "@config.titleCommitEvent",
+        "curName": "@config.titleCommitEvent",
+        "id": "evt_01M13ZXC5NZ2ZF7NK4XFSNNJ3T",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "renames": []
+      },
+      "orb_01M13ZXC5MCMHSA7W7WF77F9BX": {
+        "bakedName": "DocumentPanelOrbital",
+        "curName": "DocumentPanelOrbital",
+        "id": "orb_01M13ZXC5MCMHSA7W7WF77F9BX",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M13ZXC5NK5BB95GMHZ8ZEQTV": {
+        "bakedName": "DocumentPanelPage",
+        "curName": "DocumentPanelPage",
+        "id": "pag_01M13ZXC5NK5BB95GMHZ8ZEQTV",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M13ZXC5NZQG6MATNRKA9FPS0": {
+        "bakedName": "DocumentPanelRender",
+        "curName": "DocumentPanelRender",
+        "id": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-document-panel",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "value",
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M13ZXC5NAPHRZWRBV03GQK46",
+        "name": "DocumentPanelItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M13ZXC5MCMHSA7W7WF77F9BX",
+      "name": "DocumentPanelOrbital",
+      "pages": [
+        {
+          "id": "pag_01M13ZXC5NK5BB95GMHZ8ZEQTV",
+          "name": "DocumentPanelPage",
+          "path": "/document-panel",
+          "traits": [
+            {
+              "ref": "DocumentPanelRender",
+              "refId": "trt_01M13ZXC5NZQG6MATNRKA9FPS0"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "actions": {
+              "default": [],
+              "description": "Header actions (settings, history, …). At most one explicit primary stays inline; the rest live under a single '⋯' menu — the title owns its row.",
+              "items": {
+                "properties": {
+                  "event": {
+                    "name": "event",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "primary",
+                      "secondary",
+                      "ghost",
+                      "danger"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Actions",
+              "tier": "presentation",
+              "type": "[DocumentPanelActionsItem]"
+            },
+            "autosaveHint": {
+              "description": "Muted caption beside Done telling the author work persists on its own",
+              "label": "Autosave Hint",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "className": {
+              "description": "className prop",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "contentChangeEvent": {
+              "default": "CONTENT_CHANGE",
+              "description": "Forwarded to the embedded RichTextEditor's autosave stream: { value }",
+              "label": "Content Change Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "doneEvent": {
+              "default": "DONE",
+              "description": "Emitted by the Done button that ends the editing session: { id }",
+              "label": "Done Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "doneLabel": {
+              "description": "doneLabel prop",
+              "label": "Done Label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "editEvent": {
+              "default": "EDIT",
+              "description": "Emitted by the header Edit affordance and a click on the read body: { id }",
+              "label": "Edit Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "editLabel": {
+              "description": "editLabel prop",
+              "label": "Edit Label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "editing": {
+              "default": false,
+              "description": "false = read surface with click-to-edit body; true = live editor",
+              "label": "Editing",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "maxInlineActions": {
+              "description": "0 collapses even the primary action into the menu",
+              "label": "Max Inline Actions",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "placeholder": {
+              "description": "Placeholder for an empty body",
+              "label": "Placeholder",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "subtitle": {
+              "description": "Muted byline under the title; hidden when empty",
+              "label": "Subtitle",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "title": {
+              "description": "Document title (falls back to 'Untitled' for a blank draft)",
+              "label": "Title",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "titleCommitEvent": {
+              "default": "TITLE_COMMIT",
+              "description": "Emitted when the title commits: { title, id }",
+              "label": "Title Commit Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "value": {
+              "description": "The document body as rich-text HTML",
+              "label": "Value",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "description": "Emitted when the title commits: { title, id }",
+              "event": "@config.titleCommitEvent",
+              "eventId": "evt_01M13ZXC5NZ2ZF7NK4XFSNNJ3T",
+              "payloadSchema": [
+                {
+                  "name": "title",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "description": "Forwarded to the embedded RichTextEditor's autosave stream: { value }",
+              "event": "@config.contentChangeEvent",
+              "eventId": "evt_01M13ZXC5NM3Y5VQW65DAM1JW7",
+              "payloadSchema": [
+                {
+                  "name": "value",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "description": "Emitted by the header Edit affordance and a click on the read body: { id }",
+              "event": "@config.editEvent",
+              "eventId": "evt_01M13ZXC5N0V3HVHF8B4GR9037",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "description": "Emitted by the Done button that ends the editing session: { id }",
+              "event": "@config.doneEvent",
+              "eventId": "evt_01M13ZXC5NHMYWEH0Q87APMFPE",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "description": "DocumentPanel rows finished loading; payload.data holds the collection.",
+              "event": "DocumentPanelLoaded",
+              "eventId": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "type": "[DocumentPanelItem]"
+                }
+              ],
+              "scope": "internal",
+              "synonyms": "loaded, fetched, retrieved",
+              "tier": "essential"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "title",
+              "value"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "DocumentPanelItem": "ent_01M13ZXC5NAPHRZWRBV03GQK46"
+          },
+          "id": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
+          "linkedEntity": "DocumentPanelItem",
+          "linkedEntityId": "ent_01M13ZXC5NAPHRZWRBV03GQK46",
+          "name": "DocumentPanelRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M13ZXC5NFRPB6WH1N017BAQ8",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "DocumentPanel rows finished loading; payload.data holds the collection.",
+                "id": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
+                "key": "DocumentPanelLoaded",
+                "name": "Document panel loaded",
+                "payloadSchema": [
+                  {
+                    "name": "data",
+                    "type": "[DocumentPanelItem]"
+                  }
+                ],
+                "synonyms": "loaded, fetched, retrieved",
+                "tier": "essential"
+              },
+              {
+                "id": "evt_01M13ZXC5N2JWNJQNCQBM7ZV84",
+                "key": "TITLE_COMMIT",
+                "name": "Title Commit",
+                "payloadSchema": [
+                  {
+                    "name": "title",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M13ZXC5NGG4N5VG3W0DHZTJJ",
+                "key": "CONTENT_CHANGE",
+                "name": "Content Change",
+                "payloadSchema": [
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "Emitted when the title commits: { title, id }",
+                "id": "evt_01M13ZXC5NZ2ZF7NK4XFSNNJ3T",
+                "key": "@config.titleCommitEvent",
+                "name": "@config.title commit event",
+                "payloadSchema": [
+                  {
+                    "name": "title",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Forwarded to the embedded RichTextEditor's autosave stream: { value }",
+                "id": "evt_01M13ZXC5NM3Y5VQW65DAM1JW7",
+                "key": "@config.contentChangeEvent",
+                "name": "@config.content change event",
+                "payloadSchema": [
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Emitted by the header Edit affordance and a click on the read body: { id }",
+                "id": "evt_01M13ZXC5N0V3HVHF8B4GR9037",
+                "key": "@config.editEvent",
+                "name": "@config.edit event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Emitted by the Done button that ends the editing session: { id }",
+                "id": "evt_01M13ZXC5NHMYWEH0Q87APMFPE",
+                "key": "@config.doneEvent",
+                "name": "@config.done event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "DocumentPanelItem",
+                    {
+                      "emit": {
+                        "success": "DocumentPanelLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "set",
+                    "@entity.title",
+                    "@config.title"
+                  ],
+                  [
+                    "set",
+                    "@entity.value",
+                    "@config.value"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "actions": "@config.actions",
+                      "autosaveHint": "@config.autosaveHint",
+                      "className": "@config.className",
+                      "contentChangeEvent": "@config.contentChangeEvent",
+                      "doneEvent": "@config.doneEvent",
+                      "doneLabel": "@config.doneLabel",
+                      "editEvent": "@config.editEvent",
+                      "editLabel": "@config.editLabel",
+                      "editing": "@config.editing",
+                      "entity": "@entity",
+                      "maxInlineActions": "@config.maxInlineActions",
+                      "placeholder": "@config.placeholder",
+                      "subtitle": "@config.subtitle",
+                      "title": "@entity.title",
+                      "titleCommitEvent": "@config.titleCommitEvent",
+                      "type": "document-panel",
+                      "value": "@entity.value"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M13ZXC5NFRPB6WH1N017BAQ8",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "actions": "@config.actions",
+                      "autosaveHint": "@config.autosaveHint",
+                      "className": "@config.className",
+                      "contentChangeEvent": "@config.contentChangeEvent",
+                      "doneEvent": "@config.doneEvent",
+                      "doneLabel": "@config.doneLabel",
+                      "editEvent": "@config.editEvent",
+                      "editLabel": "@config.editLabel",
+                      "editing": "@config.editing",
+                      "entity": "@payload.data",
+                      "maxInlineActions": "@config.maxInlineActions",
+                      "placeholder": "@config.placeholder",
+                      "subtitle": "@config.subtitle",
+                      "title": "@entity.title",
+                      "titleCommitEvent": "@config.titleCommitEvent",
+                      "type": "document-panel",
+                      "value": "@entity.value"
+                    }
+                  ]
+                ],
+                "event": "DocumentPanelLoaded",
+                "eventId": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.title",
+                    "@payload.title"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "actions": "@config.actions",
+                      "autosaveHint": "@config.autosaveHint",
+                      "className": "@config.className",
+                      "contentChangeEvent": "@config.contentChangeEvent",
+                      "doneEvent": "@config.doneEvent",
+                      "doneLabel": "@config.doneLabel",
+                      "editEvent": "@config.editEvent",
+                      "editLabel": "@config.editLabel",
+                      "editing": "@config.editing",
+                      "entity": "@entity",
+                      "maxInlineActions": "@config.maxInlineActions",
+                      "placeholder": "@config.placeholder",
+                      "subtitle": "@config.subtitle",
+                      "title": "@entity.title",
+                      "titleCommitEvent": "@config.titleCommitEvent",
+                      "type": "document-panel",
+                      "value": "@entity.value"
+                    }
+                  ]
+                ],
+                "event": "TITLE_COMMIT",
+                "eventId": "evt_01M13ZXC5N2JWNJQNCQBM7ZV84",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.value",
+                    "@payload.value"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "actions": "@config.actions",
+                      "autosaveHint": "@config.autosaveHint",
+                      "className": "@config.className",
+                      "contentChangeEvent": "@config.contentChangeEvent",
+                      "doneEvent": "@config.doneEvent",
+                      "doneLabel": "@config.doneLabel",
+                      "editEvent": "@config.editEvent",
+                      "editLabel": "@config.editLabel",
+                      "editing": "@config.editing",
+                      "entity": "@entity",
+                      "maxInlineActions": "@config.maxInlineActions",
+                      "placeholder": "@config.placeholder",
+                      "subtitle": "@config.subtitle",
+                      "title": "@entity.title",
+                      "titleCommitEvent": "@config.titleCommitEvent",
+                      "type": "document-panel",
+                      "value": "@entity.value"
+                    }
+                  ]
+                ],
+                "event": "CONTENT_CHANGE",
+                "eventId": "evt_01M13ZXC5NGG4N5VG3W0DHZTJJ",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}