@almadar/std 16.182.0 → 16.184.0

package/behaviors/registry/ui/core/atoms/std-rich-editor.orb

@@ -1,5 +1,5 @@
 {
-  "description": "std-rich-editor — wiki/CMS Notion-style block editor. Browses documents in `browsing`; opens the rich-block-editor on a selected row; persists block edits + publish status.",
+  "description": "std-rich-editor — wiki/CMS Notion-style block editor. Browses documents in `browsing`; opens the rich-block-editor on a selected row; persists block edits + publish status. `BlockEdit` is a rebindable single-row overlay editor: an organism rebinds it to its own entity (WikiPage, Note, …), passes the row's id + blocksJson via OPEN, and routes the emitted BLOCKS_SAVED into its own persistor — this atom never fetches or persists.",
   "ledger": {
     "entries": {
       "ent_01KXG04HCHD37BD2KK5VJQ26G1": {
@@ -109,6 +109,60 @@
         "parent": "trt_01KXG04HCHMYN62SR31QKD05KF",
         "renames": []
       },
+      "evt_01M0RYEW8Q7JPMVH9BJQ274WXR": {
+        "bakedName": "OPEN",
+        "curName": "OPEN",
+        "id": "evt_01M0RYEW8Q7JPMVH9BJQ274WXR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+        "renames": []
+      },
+      "evt_01M0RYEW8QGS8CD8KJRJQC4CEV": {
+        "bakedName": "BLOCKS_CHANGE",
+        "curName": "BLOCKS_CHANGE",
+        "id": "evt_01M0RYEW8QGS8CD8KJRJQC4CEV",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+        "renames": []
+      },
+      "evt_01M0RYEW8QH8R91C7A42HE28ZY": {
+        "bakedName": "SAVE",
+        "curName": "SAVE",
+        "id": "evt_01M0RYEW8QH8R91C7A42HE28ZY",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+        "renames": []
+      },
+      "evt_01M0RYEW8QHNPNYEJB0CW9SVGB": {
+        "bakedName": "CLOSE",
+        "curName": "CLOSE",
+        "id": "evt_01M0RYEW8QHNPNYEJB0CW9SVGB",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+        "renames": []
+      },
+      "evt_01M0RYEW8QQG4WCT9ZCQR5B7ME": {
+        "bakedName": "BLOCKS_SAVED",
+        "curName": "BLOCKS_SAVED",
+        "id": "evt_01M0RYEW8QQG4WCT9ZCQR5B7ME",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+        "renames": []
+      },
+      "evt_01M0RYEW8QVYV5E4942Q3VFZZK": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M0RYEW8QVYV5E4942Q3VFZZK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+        "renames": []
+      },
       "orb_01KXG04HCH32475XE7N0KGX6RM": {
         "bakedName": "DocumentOrbital",
         "curName": "DocumentOrbital",
@@ -125,6 +179,14 @@
         "owner": "workspace",
         "renames": []
       },
+      "pag_01M0RYEW8QQ31MACEJYKACBXPQ": {
+        "bakedName": "BlockEditPage",
+        "curName": "BlockEditPage",
+        "id": "pag_01M0RYEW8QQ31MACEJYKACBXPQ",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
       "trt_01KXG04HCHMYN62SR31QKD05KF": {
         "bakedName": "DocumentEdit",
         "curName": "DocumentEdit",
@@ -132,6 +194,14 @@
         "kind": "trait",
         "owner": "workspace",
         "renames": []
+      },
+      "trt_01M0RYEW8QSSSVWKSKDCHC5JK9": {
+        "bakedName": "BlockEdit",
+        "curName": "BlockEdit",
+        "id": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
       }
     },
     "schemaVersion": 1
@@ -249,6 +319,17 @@
               "refId": "trt_01KXG04HCHMYN62SR31QKD05KF"
             }
           ]
+        },
+        {
+          "id": "pag_01M0RYEW8QQ31MACEJYKACBXPQ",
+          "name": "BlockEditPage",
+          "path": "/documents/block-edit",
+          "traits": [
+            {
+              "ref": "BlockEdit",
+              "refId": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9"
+            }
+          ]
         }
       ],
       "traits": [
@@ -1319,6 +1400,331 @@
               }
             ]
           }
+        },
+        {
+          "category": "interaction",
+          "config": {
+            "placeholder": {
+              "default": "Start writing…",
+              "description": "Placeholder shown in the block editor when it is empty.",
+              "label": "Placeholder text",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "title": {
+              "default": "Edit content",
+              "description": "Heading shown at the top of the block editor overlay.",
+              "label": "Editor heading",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "description": "Signals a row's block content is ready to persist. This atom never persists — the composing organism routes BLOCKS_SAVED into its own persistor's update event.",
+              "event": "BLOCKS_SAVED",
+              "eventId": "evt_01M0RYEW8QQG4WCT9ZCQR5B7ME",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "blocksJson",
+                  "type": "[BlockSpec]"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "saved, persist, update, commit",
+              "tier": "domain"
+            },
+            {
+              "description": "Indicates the block editor overlay is being dismissed.",
+              "event": "CLOSE",
+              "eventId": "evt_01M0RYEW8QHNPNYEJB0CW9SVGB",
+              "synonyms": "dismiss, hide, cancel, close",
+              "tier": "domain"
+            },
+            {
+              "description": "Signals that the content of a block has been modified while editing.",
+              "event": "BLOCKS_CHANGE",
+              "eventId": "evt_01M0RYEW8QGS8CD8KJRJQC4CEV",
+              "payloadSchema": [
+                {
+                  "name": "blocks",
+                  "type": "[BlockSpec]"
+                }
+              ],
+              "synonyms": "update, modify, changed, edit",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "blocksJson"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "Document": "ent_01KXG04HCHD37BD2KK5VJQ26G1"
+          },
+          "id": "trt_01M0RYEW8QSSSVWKSKDCHC5JK9",
+          "linkedEntity": "Document",
+          "linkedEntityId": "ent_01KXG04HCHD37BD2KK5VJQ26G1",
+          "name": "BlockEdit",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0RYEW8QVYV5E4942Q3VFZZK",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Requests the block editor overlay open for the given row. The caller supplies the row's id and current blocks — this trait never fetches them itself.",
+                "id": "evt_01M0RYEW8Q7JPMVH9BJQ274WXR",
+                "key": "OPEN",
+                "name": "Open",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "blocksJson",
+                    "properties": [
+                      {
+                        "name": "type",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "content",
+                        "type": "string"
+                      },
+                      {
+                        "name": "id",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  }
+                ],
+                "synonyms": "show, launch, reveal, edit",
+                "tier": "domain"
+              },
+              {
+                "description": "Signals a row's block content is ready to persist. This atom never persists — the composing organism routes BLOCKS_SAVED into its own persistor's update event.",
+                "id": "evt_01M0RYEW8QQG4WCT9ZCQR5B7ME",
+                "key": "BLOCKS_SAVED",
+                "name": "Blocks Saved",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "blocksJson",
+                    "type": "[BlockSpec]"
+                  }
+                ],
+                "synonyms": "saved, persist, update, commit",
+                "tier": "domain"
+              },
+              {
+                "description": "Signals that the content of a block has been modified while editing.",
+                "id": "evt_01M0RYEW8QGS8CD8KJRJQC4CEV",
+                "key": "BLOCKS_CHANGE",
+                "name": "Blocks Change",
+                "payloadSchema": [
+                  {
+                    "name": "blocks",
+                    "properties": [
+                      {
+                        "name": "type",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "content",
+                        "type": "string"
+                      },
+                      {
+                        "name": "id",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  }
+                ],
+                "synonyms": "update, modify, changed, edit",
+                "tier": "domain"
+              },
+              {
+                "id": "evt_01M0RYEW8QH8R91C7A42HE28ZY",
+                "key": "SAVE",
+                "name": "Save"
+              },
+              {
+                "description": "Indicates the block editor overlay is being dismissed.",
+                "id": "evt_01M0RYEW8QHNPNYEJB0CW9SVGB",
+                "key": "CLOSE",
+                "name": "Close",
+                "synonyms": "dismiss, hide, cancel, close",
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "editing"
+              }
+            ],
+            "transitions": [
+              {
+                "event": "INIT",
+                "eventId": "evt_01M0RYEW8QVYV5E4942Q3VFZZK",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.id",
+                    "@payload.id"
+                  ],
+                  [
+                    "set",
+                    "@entity.blocksJson",
+                    "@payload.blocksJson"
+                  ],
+                  [
+                    "render-ui",
+                    "modal",
+                    {
+                      "children": [
+                        {
+                          "align": "center",
+                          "children": [
+                            {
+                              "name": "file-text",
+                              "type": "icon"
+                            },
+                            {
+                              "content": "@config.title",
+                              "type": "typography",
+                              "variant": "h3"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "changeEvent": "BLOCKS_CHANGE",
+                          "initialBlocks": "@entity.blocksJson",
+                          "placeholder": "@config.placeholder",
+                          "showToolbar": true,
+                          "type": "rich-block-editor"
+                        },
+                        {
+                          "align": "center",
+                          "children": [
+                            {
+                              "action": "SAVE",
+                              "label": "Save",
+                              "type": "button",
+                              "variant": "primary"
+                            },
+                            {
+                              "action": "CLOSE",
+                              "label": "Cancel",
+                              "type": "button",
+                              "variant": "ghost"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "OPEN",
+                "eventId": "evt_01M0RYEW8Q7JPMVH9BJQ274WXR",
+                "from": "idle",
+                "to": "editing"
+              },
+              {
+                "event": "BLOCKS_SAVED",
+                "eventId": "evt_01M0RYEW8QQG4WCT9ZCQR5B7ME",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.blocksJson",
+                    "@payload.blocks"
+                  ]
+                ],
+                "event": "BLOCKS_CHANGE",
+                "eventId": "evt_01M0RYEW8QGS8CD8KJRJQC4CEV",
+                "from": "editing",
+                "to": "editing"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "emit",
+                    "BLOCKS_SAVED",
+                    {
+                      "blocksJson": "@entity.blocksJson",
+                      "id": "@entity.id"
+                    }
+                  ]
+                ],
+                "event": "SAVE",
+                "eventId": "evt_01M0RYEW8QH8R91C7A42HE28ZY",
+                "from": "editing",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ]
+                ],
+                "event": "CLOSE",
+                "eventId": "evt_01M0RYEW8QHNPNYEJB0CW9SVGB",
+                "from": "editing",
+                "to": "idle"
+              }
+            ]
+          }
         }
       ]
     }