@almadar/std 16.184.0 → 16.185.0

package/dist/index.js

@@ -71506,6 +71506,34 @@ function stdRichEditorDocumentOrbital(params = {}) {
       {
         "category": "interaction",
         "config": {
+          "editLabel": {
+            "default": "Edit content",
+            "description": "Label of the button above the read-only body that opens the editor.",
+            "label": "Edit button label",
+            "tier": "presentation",
+            "type": "string"
+          },
+          "emptyActionLabel": {
+            "default": "Start writing",
+            "description": "Label of the button that opens the editor from the empty body state.",
+            "label": "Empty action label",
+            "tier": "presentation",
+            "type": "string"
+          },
+          "emptyDescription": {
+            "default": "This page has no content yet. Start writing to fill it in.",
+            "description": "Supporting line shown with the empty body state.",
+            "label": "Empty description",
+            "tier": "presentation",
+            "type": "string"
+          },
+          "emptyTitle": {
+            "default": "Nothing written yet",
+            "description": "Heading shown in place of the body when the row has no blocks yet.",
+            "label": "Empty heading",
+            "tier": "presentation",
+            "type": "string"
+          },
           "placeholder": {
             "default": "Start writing\u2026",
             "description": "Placeholder shown in the block editor when it is empty.",
@@ -71515,7 +71543,7 @@ function stdRichEditorDocumentOrbital(params = {}) {
           },
           "title": {
             "default": "Edit content",
-            "description": "Heading shown at the top of the block editor overlay.",
+            "description": "Heading shown above the editor while the body is being edited.",
             "label": "Editor heading",
             "tier": "presentation",
             "type": "string"
@@ -71541,7 +71569,7 @@ function stdRichEditorDocumentOrbital(params = {}) {
             "tier": "domain"
           },
           {
-            "description": "Indicates the block editor overlay is being dismissed.",
+            "description": "Leaves the editor without saving; the body returns to its read-only render.",
             "event": "CLOSE",
             "synonyms": "dismiss, hide, cancel, close",
             "tier": "domain"
@@ -71576,7 +71604,7 @@ function stdRichEditorDocumentOrbital(params = {}) {
               "name": "Initialize"
             },
             {
-              "description": "Requests the block editor overlay open for the given row. The caller supplies the row's id and current blocks \u2014 this trait never fetches them itself.",
+              "description": "Hands the editor the row whose body it renders \u2014 the caller supplies the row's id and current blocks, since this trait never fetches them itself. Re-firing it repaints the body (e.g. after the host refetches a saved row).",
               "key": "OPEN",
               "name": "Open",
               "payloadSchema": [
@@ -71608,6 +71636,39 @@ function stdRichEditorDocumentOrbital(params = {}) {
               "synonyms": "show, launch, reveal, edit",
               "tier": "domain"
             },
+            {
+              "description": "Hands the editor a row that was just created as a blank draft: same payload as OPEN, but the body opens straight in the authoring editor instead of the read-only render, so a document-first 'New page' lands the author on a cursor rather than an empty state.",
+              "key": "OPEN_DRAFT",
+              "name": "Open Draft",
+              "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": "new document, start writing, blank draft, compose",
+              "tier": "domain"
+            },
             {
               "description": "Signals a row's block content is ready to persist. This atom never persists \u2014 the composing organism routes BLOCKS_SAVED into its own persistor's update event.",
               "key": "BLOCKS_SAVED",
@@ -71626,6 +71687,10 @@ function stdRichEditorDocumentOrbital(params = {}) {
               "synonyms": "saved, persist, update, commit",
               "tier": "domain"
             },
+            {
+              "key": "EDIT_BLOCKS",
+              "name": "Edit Blocks"
+            },
             {
               "description": "Signals that the content of a block has been modified while editing.",
               "key": "BLOCKS_CHANGE",
@@ -71655,11 +71720,11 @@ function stdRichEditorDocumentOrbital(params = {}) {
               "tier": "domain"
             },
             {
-              "key": "SAVE",
-              "name": "Save"
+              "key": "SAVE_BLOCKS",
+              "name": "Save Blocks"
             },
             {
-              "description": "Indicates the block editor overlay is being dismissed.",
+              "description": "Leaves the editor without saving; the body returns to its read-only render.",
               "key": "CLOSE",
               "name": "Close",
               "synonyms": "dismiss, hide, cancel, close",
@@ -71671,6 +71736,9 @@ function stdRichEditorDocumentOrbital(params = {}) {
               "isInitial": true,
               "name": "idle"
             },
+            {
+              "name": "viewing"
+            },
             {
               "name": "editing"
             }
@@ -71695,7 +71763,107 @@ function stdRichEditorDocumentOrbital(params = {}) {
                 ],
                 [
                   "render-ui",
-                  "modal",
+                  "main",
+                  {
+                    "children": [
+                      {
+                        "children": [
+                          {
+                            "action": "EDIT_BLOCKS",
+                            "icon": "edit",
+                            "label": "@config.editLabel",
+                            "type": "button",
+                            "variant": "secondary"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "justify": "end",
+                        "type": "stack"
+                      },
+                      {
+                        "action": "EDIT_BLOCKS",
+                        "children": [
+                          {
+                            "initialBlocks": "@entity.blocksJson",
+                            "readOnly": true,
+                            "type": "rich-block-editor"
+                          }
+                        ],
+                        "className": "cursor-text rounded-md transition-colors hover:bg-muted/40",
+                        "type": "box"
+                      }
+                    ],
+                    "direction": "vertical",
+                    "gap": "sm",
+                    "type": "stack"
+                  }
+                ]
+              ],
+              "event": "OPEN",
+              "from": "idle",
+              "guard": [
+                ">",
+                [
+                  "array/len",
+                  "@payload.blocksJson"
+                ],
+                0
+              ],
+              "to": "viewing"
+            },
+            {
+              "effects": [
+                [
+                  "set",
+                  "@entity.id",
+                  "@payload.id"
+                ],
+                [
+                  "set",
+                  "@entity.blocksJson",
+                  "@payload.blocksJson"
+                ],
+                [
+                  "render-ui",
+                  "main",
+                  {
+                    "actionEvent": "EDIT_BLOCKS",
+                    "actionLabel": "@config.emptyActionLabel",
+                    "description": "@config.emptyDescription",
+                    "icon": "file-text",
+                    "title": "@config.emptyTitle",
+                    "type": "empty-state"
+                  }
+                ]
+              ],
+              "event": "OPEN",
+              "from": "idle",
+              "guard": [
+                "=",
+                [
+                  "array/len",
+                  "@payload.blocksJson"
+                ],
+                0
+              ],
+              "to": "viewing"
+            },
+            {
+              "effects": [
+                [
+                  "set",
+                  "@entity.id",
+                  "@payload.id"
+                ],
+                [
+                  "set",
+                  "@entity.blocksJson",
+                  "@payload.blocksJson"
+                ],
+                [
+                  "render-ui",
+                  "main",
                   {
                     "children": [
                       {
@@ -71708,16 +71876,13 @@ function stdRichEditorDocumentOrbital(params = {}) {
                           {
                             "content": "@config.title",
                             "type": "typography",
-                            "variant": "h3"
+                            "variant": "h4"
                           }
                         ],
                         "direction": "horizontal",
                         "gap": "sm",
                         "type": "stack"
                       },
-                      {
-                        "type": "divider"
-                      },
                       {
                         "changeEvent": "BLOCKS_CHANGE",
                         "initialBlocks": "@entity.blocksJson",
@@ -71726,10 +71891,9 @@ function stdRichEditorDocumentOrbital(params = {}) {
                         "type": "rich-block-editor"
                       },
                       {
-                        "align": "center",
                         "children": [
                           {
-                            "action": "SAVE",
+                            "action": "SAVE_BLOCKS",
                             "label": "Save",
                             "type": "button",
                             "variant": "primary"
@@ -71743,6 +71907,7 @@ function stdRichEditorDocumentOrbital(params = {}) {
                         ],
                         "direction": "horizontal",
                         "gap": "sm",
+                        "justify": "end",
                         "type": "stack"
                       }
                     ],
@@ -71752,7 +71917,7 @@ function stdRichEditorDocumentOrbital(params = {}) {
                   }
                 ]
               ],
-              "event": "OPEN",
+              "event": "OPEN_DRAFT",
               "from": "idle",
               "to": "editing"
             },
@@ -71763,23 +71928,252 @@ function stdRichEditorDocumentOrbital(params = {}) {
             },
             {
               "effects": [
+                [
+                  "set",
+                  "@entity.id",
+                  "@payload.id"
+                ],
                 [
                   "set",
                   "@entity.blocksJson",
-                  "@payload.blocks"
+                  "@payload.blocksJson"
+                ],
+                [
+                  "render-ui",
+                  "main",
+                  {
+                    "children": [
+                      {
+                        "align": "center",
+                        "children": [
+                          {
+                            "name": "file-text",
+                            "type": "icon"
+                          },
+                          {
+                            "content": "@config.title",
+                            "type": "typography",
+                            "variant": "h4"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "type": "stack"
+                      },
+                      {
+                        "changeEvent": "BLOCKS_CHANGE",
+                        "initialBlocks": "@entity.blocksJson",
+                        "placeholder": "@config.placeholder",
+                        "showToolbar": true,
+                        "type": "rich-block-editor"
+                      },
+                      {
+                        "children": [
+                          {
+                            "action": "SAVE_BLOCKS",
+                            "label": "Save",
+                            "type": "button",
+                            "variant": "primary"
+                          },
+                          {
+                            "action": "CLOSE",
+                            "label": "Cancel",
+                            "type": "button",
+                            "variant": "ghost"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "justify": "end",
+                        "type": "stack"
+                      }
+                    ],
+                    "direction": "vertical",
+                    "gap": "md",
+                    "type": "stack"
+                  }
                 ]
               ],
-              "event": "BLOCKS_CHANGE",
-              "from": "editing",
+              "event": "OPEN_DRAFT",
+              "from": "viewing",
               "to": "editing"
             },
             {
               "effects": [
+                [
+                  "set",
+                  "@entity.id",
+                  "@payload.id"
+                ],
+                [
+                  "set",
+                  "@entity.blocksJson",
+                  "@payload.blocksJson"
+                ],
+                [
+                  "render-ui",
+                  "main",
+                  {
+                    "children": [
+                      {
+                        "children": [
+                          {
+                            "action": "EDIT_BLOCKS",
+                            "icon": "edit",
+                            "label": "@config.editLabel",
+                            "type": "button",
+                            "variant": "secondary"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "justify": "end",
+                        "type": "stack"
+                      },
+                      {
+                        "action": "EDIT_BLOCKS",
+                        "children": [
+                          {
+                            "initialBlocks": "@entity.blocksJson",
+                            "readOnly": true,
+                            "type": "rich-block-editor"
+                          }
+                        ],
+                        "className": "cursor-text rounded-md transition-colors hover:bg-muted/40",
+                        "type": "box"
+                      }
+                    ],
+                    "direction": "vertical",
+                    "gap": "sm",
+                    "type": "stack"
+                  }
+                ]
+              ],
+              "event": "OPEN",
+              "from": "viewing",
+              "guard": [
+                ">",
+                [
+                  "array/len",
+                  "@payload.blocksJson"
+                ],
+                0
+              ],
+              "to": "viewing"
+            },
+            {
+              "effects": [
+                [
+                  "set",
+                  "@entity.id",
+                  "@payload.id"
+                ],
+                [
+                  "set",
+                  "@entity.blocksJson",
+                  "@payload.blocksJson"
+                ],
                 [
                   "render-ui",
-                  "modal",
-                  null
+                  "main",
+                  {
+                    "actionEvent": "EDIT_BLOCKS",
+                    "actionLabel": "@config.emptyActionLabel",
+                    "description": "@config.emptyDescription",
+                    "icon": "file-text",
+                    "title": "@config.emptyTitle",
+                    "type": "empty-state"
+                  }
+                ]
+              ],
+              "event": "OPEN",
+              "from": "viewing",
+              "guard": [
+                "=",
+                [
+                  "array/len",
+                  "@payload.blocksJson"
                 ],
+                0
+              ],
+              "to": "viewing"
+            },
+            {
+              "effects": [
+                [
+                  "render-ui",
+                  "main",
+                  {
+                    "children": [
+                      {
+                        "align": "center",
+                        "children": [
+                          {
+                            "name": "file-text",
+                            "type": "icon"
+                          },
+                          {
+                            "content": "@config.title",
+                            "type": "typography",
+                            "variant": "h4"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "type": "stack"
+                      },
+                      {
+                        "changeEvent": "BLOCKS_CHANGE",
+                        "initialBlocks": "@entity.blocksJson",
+                        "placeholder": "@config.placeholder",
+                        "showToolbar": true,
+                        "type": "rich-block-editor"
+                      },
+                      {
+                        "children": [
+                          {
+                            "action": "SAVE_BLOCKS",
+                            "label": "Save",
+                            "type": "button",
+                            "variant": "primary"
+                          },
+                          {
+                            "action": "CLOSE",
+                            "label": "Cancel",
+                            "type": "button",
+                            "variant": "ghost"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "justify": "end",
+                        "type": "stack"
+                      }
+                    ],
+                    "direction": "vertical",
+                    "gap": "md",
+                    "type": "stack"
+                  }
+                ]
+              ],
+              "event": "EDIT_BLOCKS",
+              "from": "viewing",
+              "to": "editing"
+            },
+            {
+              "effects": [
+                [
+                  "set",
+                  "@entity.blocksJson",
+                  "@payload.blocks"
+                ]
+              ],
+              "event": "BLOCKS_CHANGE",
+              "from": "editing",
+              "to": "editing"
+            },
+            {
+              "effects": [
                 [
                   "emit",
                   "BLOCKS_SAVED",
@@ -71787,23 +72181,94 @@ function stdRichEditorDocumentOrbital(params = {}) {
                     "blocksJson": "@entity.blocksJson",
                     "id": "@entity.id"
                   }
+                ],
+                [
+                  "render-ui",
+                  "main",
+                  {
+                    "children": [
+                      {
+                        "children": [
+                          {
+                            "action": "EDIT_BLOCKS",
+                            "icon": "edit",
+                            "label": "@config.editLabel",
+                            "type": "button",
+                            "variant": "secondary"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "justify": "end",
+                        "type": "stack"
+                      },
+                      {
+                        "action": "EDIT_BLOCKS",
+                        "children": [
+                          {
+                            "initialBlocks": "@entity.blocksJson",
+                            "readOnly": true,
+                            "type": "rich-block-editor"
+                          }
+                        ],
+                        "className": "cursor-text rounded-md transition-colors hover:bg-muted/40",
+                        "type": "box"
+                      }
+                    ],
+                    "direction": "vertical",
+                    "gap": "sm",
+                    "type": "stack"
+                  }
                 ]
               ],
-              "event": "SAVE",
+              "event": "SAVE_BLOCKS",
               "from": "editing",
-              "to": "idle"
+              "to": "viewing"
             },
             {
               "effects": [
                 [
                   "render-ui",
-                  "modal",
-                  null
+                  "main",
+                  {
+                    "children": [
+                      {
+                        "children": [
+                          {
+                            "action": "EDIT_BLOCKS",
+                            "icon": "edit",
+                            "label": "@config.editLabel",
+                            "type": "button",
+                            "variant": "secondary"
+                          }
+                        ],
+                        "direction": "horizontal",
+                        "gap": "sm",
+                        "justify": "end",
+                        "type": "stack"
+                      },
+                      {
+                        "action": "EDIT_BLOCKS",
+                        "children": [
+                          {
+                            "initialBlocks": "@entity.blocksJson",
+                            "readOnly": true,
+                            "type": "rich-block-editor"
+                          }
+                        ],
+                        "className": "cursor-text rounded-md transition-colors hover:bg-muted/40",
+                        "type": "box"
+                      }
+                    ],
+                    "direction": "vertical",
+                    "gap": "sm",
+                    "type": "stack"
+                  }
                 ]
               ],
               "event": "CLOSE",
               "from": "editing",
-              "to": "idle"
+              "to": "viewing"
             }
           ]
         }
@@ -144690,6 +145155,13 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
             "tier": "presentation",
             "type": "string"
           },
+          "onTitleCommit": {
+            "default": "",
+            "description": "When bound, the title becomes editable in place: clicking it swaps the heading for an input, Enter or blur commits, Escape reverts. Receives the committed title and the record's id so the host can persist a partial update. Unbound, the title stays a plain heading.",
+            "label": "On Title Commit",
+            "tier": "presentation",
+            "type": "string"
+          },
           "pageProp": {
             "description": "Current page number",
             "label": "Page",
@@ -144973,6 +145445,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
                     "isLoading": "@config.isLoading",
                     "maxInlineActions": "@config.maxInlineActions",
                     "mode": "@config.mode",
+                    "onTitleCommit": "@config.onTitleCommit",
                     "page": "@config.pageProp",
                     "pageSize": "@config.pageSize",
                     "position": "@config.position",
@@ -145018,6 +145491,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
                     "isLoading": "@config.isLoading",
                     "maxInlineActions": "@config.maxInlineActions",
                     "mode": "@config.mode",
+                    "onTitleCommit": "@config.onTitleCommit",
                     "page": "@config.pageProp",
                     "pageSize": "@config.pageSize",
                     "position": "@config.position",