@almadar/std 16.189.0 → 16.191.0

package/behaviors/lolo/ui/core/atoms/std-modal.lolo

@@ -24,6 +24,7 @@ orbital ModalRecordOrbital {
     name : string @description "A user-facing identifier for the modal." @synonyms "title, label, identifier"
     description : string @description "A textual explanation of the modal's content or function." @synonyms "details, explanation, notes, summary"
     status : "active" | "inactive" | "pending" @description "Current operational state of the record." @synonyms "state, condition, flag" = active
+    seedRow : ModalRecord @intrinsic @description "The row an edit-mode OPEN pre-fills from when its payload carries no row. Stashed by SEED — hosts route the surface's loaded event here (e.g. a document look's RecordItemLoaded) so scalar-only action events ({ id }) can still open a fully seeded settings form." = {}
     createdAt : string
   }
 
@@ -35,12 +36,16 @@ orbital ModalRecordOrbital {
         (fetch ModalRecord {
           emit: { failure: ModalRecordLoadFailed, success: ModalRecordLoaded }
         })
+      ;; stash only — a SEED never opens anything; OPEN reads it on demand
+      SEED -> closed
+        (set @entity.seedRow (object/merge ?row {}))
       ;; Mode-aware guard: in create mode the modal opens unconditionally
-      ;; (no row exists yet); in edit mode @payload.row must be present
-      ;; or the OPEN is rejected (no silent first-row fallback). The
-      ;; @config.mode literal is substituted at molecule inline time —
-      ;; atoms validate this with @config allowed-but-unresolved.
-      OPEN -> open when (or ["=", @config.mode, create] ?row)
+      ;; (no row exists yet); in edit mode the row must be present — on the
+      ;; OPEN payload or already stashed by SEED — or the OPEN is rejected
+      ;; (no silent first-row fallback). The @config.mode literal is
+      ;; substituted at molecule inline time — atoms validate this with
+      ;; @config allowed-but-unresolved.
+      OPEN -> open when (or ["=", @config.mode, create] ?row ["!=", (str/default (object/get @entity.seedRow id) ""), ""])
         (set @entity.id ?id)
         (render-ui @config.detailSlot {
           children: [{
@@ -54,7 +59,7 @@ orbital ModalRecordOrbital {
             type: stack
           }, { type: divider }, {
             cancelEvent: CLOSE
-            entity: ?row
+            entity: (object/merge @entity.seedRow (object/merge ?row {}))
             fieldOverrides: @config.fieldOverrides
             fields: @config.fields
             mode: @config.mode
@@ -68,6 +73,9 @@ orbital ModalRecordOrbital {
     }
 
     state open {
+      ;; a refetch echo while the modal is open refreshes the stash in place
+      SEED -> open
+        (set @entity.seedRow (object/merge ?row {}))
       CLOSE -> closed
         (render-ui @config.detailSlot null)
         (notify Cancelled info)
@@ -104,6 +112,12 @@ orbital ModalRecordOrbital {
         @description "A request to display the modal window."
         @synonyms "show, display, present, reveal"
         @tier "domain"
+      SEED {
+        row : ModalRecord
+      }
+        @description "Stash the row an edit-mode OPEN will pre-fill from. Hosts route the owning surface's loaded event here (e.g. RecordItemLoaded from a document look) so an OPEN carrying only { id } still opens a fully seeded form."
+        @synonyms "preload row, stash record, seed form, prefill"
+        @tier "domain"
       SAVE {
         data : @entity!
       }

package/behaviors/lolo/ui/core/atoms/std-record-detail.lolo

@@ -20,7 +20,7 @@ orbital RecordItemOrbital {
     status : "active" | "inactive" | "pending" @description "The record's current state." @synonyms "state, condition, stage" = active
     slug : string @description "URL-friendly identifier, for records opened by address instead of id." @synonyms "permalink, url key, address" = ""
     content : string @description "The record's rich-text body as HTML, edited in place by the document look." @synonyms "body, text, document, article body" = ""
-    loadedRow : object @intrinsic @description "The full row exactly as last fetched (relations hydrated when config.include asks). The document look binds it as the panel's entity and hands it to header actions as ?row, so a settings modal seeds from the real record instead of the atom's four mapped columns." = {}
+    loadedRow : object @intrinsic @description "The full row exactly as last fetched (relations hydrated when config.include asks). The details drawer binds it, and hosts that need it (e.g. a settings modal) stash it from RecordItemLoaded — the document panel itself takes only scalar props and emits scalar payloads ({ id, title })." = {}
     openDraft : string @intrinsic @description "Set from the navigate payload when the surface was opened on a record that was JUST minted blank; read once the row loads to decide whether the document body opens authoring (draft) or read-only. Absent on a refresh or a normal open, so the draft entry never repeats." @synonyms "new document, just created, draft open" = ""
     createdAt : string
   }
@@ -589,7 +589,7 @@ orbital RecordItemOrbital {
         actions: @config.actions
         editEvent: EDIT_CONTENT
         editLabel: @config.editLabel
-        entity: @entity.loadedRow
+        id: @entity.id
         maxInlineActions: @config.maxInlineActions
         placeholder: @config.placeholder
         subtitle: @entity.description
@@ -609,7 +609,7 @@ orbital RecordItemOrbital {
         doneEvent: DONE_EDITING
         doneLabel: @config.doneLabel
         editing: true
-        entity: @entity.loadedRow
+        id: @entity.id
         maxInlineActions: @config.maxInlineActions
         placeholder: @config.placeholder
         subtitle: @entity.description

package/behaviors/lolo/ui/core/molecules/ui-document-panel.lolo

@@ -2,7 +2,6 @@ app ui-document-panel "1.0.0"
 "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)."
 ;; @capabilities "document page, note editor, wiki page, article editor, writing surface, rich text document, content editing canvas"
 orbital DocumentPanelOrbital {
-    type DocumentPanelLoaded = Event { data : [DocumentPanelItem] } "DocumentPanel rows finished loading; payload.data holds the collection"
   type DocumentPanelActionsItem = {
     label : string!
     event : string
@@ -21,31 +20,9 @@ orbital DocumentPanelOrbital {
 
     state idle {
       INIT -> idle
-        (fetch DocumentPanelItem { emit: { success: DocumentPanelLoaded } })
         (set @entity.title @config.title)
         (set @entity.value @config.value)
         (render-ui main {
-          entity: @entity
-          title: @entity.title
-          subtitle: @config.subtitle
-          value: @entity.value
-          actions: @config.actions
-          maxInlineActions: @config.maxInlineActions
-          editing: @config.editing
-          titleCommitEvent: @config.titleCommitEvent
-          contentChangeEvent: @config.contentChangeEvent
-          editEvent: @config.editEvent
-          doneEvent: @config.doneEvent
-          editLabel: @config.editLabel
-          doneLabel: @config.doneLabel
-          autosaveHint: @config.autosaveHint
-          placeholder: @config.placeholder
-          className: @config.className
-          type: document-panel
-        })
-      DocumentPanelLoaded -> idle
-        (render-ui main {
-          entity: @payload.data
           title: @entity.title
           subtitle: @config.subtitle
           value: @entity.value
@@ -66,7 +43,6 @@ orbital DocumentPanelOrbital {
       TITLE_COMMIT -> idle
         (set @entity.title ?title)
         (render-ui main {
-          entity: @entity
           title: @entity.title
           subtitle: @config.subtitle
           value: @entity.value
@@ -87,7 +63,6 @@ orbital DocumentPanelOrbital {
       CONTENT_CHANGE -> idle
         (set @entity.value ?value)
         (render-ui main {
-          entity: @entity
           title: @entity.title
           subtitle: @config.subtitle
           value: @entity.value
@@ -129,10 +104,6 @@ orbital DocumentPanelOrbital {
       }
         @description "Emitted by the Done button that ends the editing session: { id }"
         @tier "essential"
-      DocumentPanelLoaded
-        @description "DocumentPanel rows finished loading; payload.data holds the collection."
-        @synonyms "loaded, fetched, retrieved"
-        @tier "essential"
     }
 
     listens {

package/behaviors/lolo/ui/game/atoms/std-platformer-body.lolo

@@ -107,6 +107,7 @@ orbital PlatformerBodyOrbital {
         (let ((rightSamp (if @inRange (array/first (array/filter @config.skateCurve (fn s (> (object/get @s x) @cx)))) { x: 1, y: 0 })))
         (let ((slope (if @inRange (/ (- (object/get @rightSamp y) (object/get @leftSamp y)) (- (object/get @rightSamp x) (object/get @leftSamp x))) 0)))
         (let ((curveY (if @inRange (+ (object/get @leftSamp y) (* @slope (- @cx (object/get @leftSamp x)))) 0)))
+        (let ((gapBreak (and (> @config.skateMaxGap 0) (> (- (object/get @rightSamp x) (object/get @leftSamp x)) @config.skateMaxGap))))
         (let ((curveMod (if (and @config.curveModsEnabled @inRange) (array/find @entity.curveMods (fn m (and (>= @cx (object/get @m x0)) (<= @cx (object/get @m x1))))) null)))
         (let ((modX (if (== @curveMod null) @cx (- @cx (object/get @curveMod h)))))
         (let ((modInRange (and (!= @curveMod null) (and (>= @modX (object/get (array/first @config.skateCurve) x)) (< @modX (object/get (array/last @config.skateCurve) x))))))
@@ -117,7 +118,7 @@ orbital PlatformerBodyOrbital {
         (let ((slope (if (== @curveMod null) @slope (* (object/get @curveMod a) @modSlope))))
         (let ((curveY (if (== @curveMod null) @curveY (+ (* (object/get @curveMod a) @modCurveY) (object/get @curveMod k)))))
         (let ((movingUp (< (* @vy1 @gdir) -0.01)))
-        (let ((skateNow (and @inRange (and (<= (math/abs (- @ny2 @curveY)) @config.skateSnap) (and (or @landed @entity.skating) (or @entity.body.grounded (not @movingUp)))))))
+        (let ((skateNow (and @inRange (and (not @gapBreak) (and (<= (math/abs (- @ny2 @curveY)) @config.skateSnap) (and (or @landed @entity.skating) (or @entity.body.grounded (not @movingUp))))))))
         (let ((vx2 (if @skateNow (math/clamp (+ @entity.body.vx (* (/ (* @config.gravity @slope) (+ 1 (* @slope @slope))) 0.033)) (- 0 @config.maxFallSpeed) @config.maxFallSpeed) @entity.body.vx)))
         (let ((vx3 (if (== @drift null) @vx2 (math/clamp (+ @vx2 (* @dax 0.033)) (- 0 @config.maxFallSpeed) @config.maxFallSpeed))))
         (let ((fy (if @skateNow @curveY @ny2)) (fvy (if @skateNow (* (* @vx2 (math/cos (math/atan @slope))) (math/sin (math/atan @slope))) @vy2)) (fgrounded (or @landed @skateNow)))
@@ -155,7 +156,7 @@ orbital PlatformerBodyOrbital {
                 (set @entity.fell true)
                 (emit BODY_FELL { x: @nx, y: @fy }))
               null)
-            (emit BODY_MOVED { x: @nx, y: @fy, vx: @entity.body.vx, vy: @fvy, grounded: @fgrounded, skating: @skateNow, speed: (math/hypot @entity.body.vx @fvy) })))))))))))))))))))))))))))))))))))))
+            (emit BODY_MOVED { x: @nx, y: @fy, vx: @entity.body.vx, vy: @fvy, grounded: @fgrounded, skating: @skateNow, speed: (math/hypot @entity.body.vx @fvy) }))))))))))))))))))))))))))))))))))))))
     }
 
     emits {
@@ -279,6 +280,10 @@ orbital PlatformerBodyOrbital {
         @label "Skate Curve"
         @description "Surface samples (x strictly increasing) the body skates when skate is on; y is the surface height for the body's MIN corner, linearly interpolated between bracketing samples — mirror the render-side curve so what you see is what you ride"
         @tier "domain"
+      skateMaxGap : number = 0
+        @label "Skate Max Gap"
+        @description "Largest x-gap between consecutive skateCurve samples that still counts as surface. 0 = unlimited (sparse two-sample lines skate fine). Dense resampled curves with real gaps between segments (stitched worlds) MUST set this — otherwise the sampler invents a skatable chord across every gap (an invisible line above the bridge/terrain that the body snaps to and glides along)."
+        @tier "domain"
       skateSnap : number = 0.75
         @label "Skate Snap"
         @description "Max vertical gap (world units) between the body's min corner and the curve surface for skating to engage or stay engaged; larger values grab earlier on landing, smaller values release sooner on bumps"

package/behaviors/registry/ui/core/atoms/std-modal.orb

@@ -64,6 +64,15 @@
         "parent": "trt_01KXG04GVS1W2103BQKJT7KZRZ",
         "renames": []
       },
+      "evt_01M15CRJ6RE1E1ZFKT9Y1PXNZK": {
+        "bakedName": "SEED",
+        "curName": "SEED",
+        "id": "evt_01M15CRJ6RE1E1ZFKT9Y1PXNZK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04GVS1W2103BQKJT7KZRZ",
+        "renames": []
+      },
       "orb_01KXG04GVS05DXYNB5ZR3H2X72": {
         "bakedName": "ModalRecordOrbital",
         "curName": "ModalRecordOrbital",
@@ -124,6 +133,18 @@
               "pending"
             ]
           },
+          {
+            "default": {},
+            "description": "The row an edit-mode OPEN pre-fills from when its payload carries no row. Stashed by SEED — hosts route the surface's loaded event here (e.g. a document look's RecordItemLoaded) so scalar-only action events ({ id }) can still open a fully seeded settings form.",
+            "intrinsic": true,
+            "name": "seedRow",
+            "relation": {
+              "cardinality": "one",
+              "entity": "ModalRecord",
+              "entityId": "ent_01KXG04GVS68RDSK2NDK0G2TT5"
+            },
+            "type": "relation"
+          },
           {
             "name": "createdAt",
             "type": "string"
@@ -291,7 +312,9 @@
             }
           ],
           "entityContract": {
-            "provides": [],
+            "provides": [
+              "seedRow"
+            ],
             "requires": []
           },
           "entityRebindable": true,
@@ -310,6 +333,20 @@
                 "key": "INIT",
                 "name": "Initialize"
               },
+              {
+                "description": "Stash the row an edit-mode OPEN will pre-fill from. Hosts route the owning surface's loaded event here (e.g. RecordItemLoaded from a document look) so an OPEN carrying only { id } still opens a fully seeded form.",
+                "id": "evt_01M15CRJ6RE1E1ZFKT9Y1PXNZK",
+                "key": "SEED",
+                "name": "Seed",
+                "payloadSchema": [
+                  {
+                    "name": "row",
+                    "type": "ModalRecord"
+                  }
+                ],
+                "synonyms": "preload row, stash record, seed form, prefill",
+                "tier": "domain"
+              },
               {
                 "description": "A request to display the modal window.",
                 "id": "evt_01KXG04GVS6WNYYGFS0H53BHKC",
@@ -412,6 +449,23 @@
                 "from": "closed",
                 "to": "closed"
               },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.seedRow",
+                    [
+                      "object/merge",
+                      "@payload.row",
+                      {}
+                    ]
+                  ]
+                ],
+                "event": "SEED",
+                "eventId": "evt_01M15CRJ6RE1E1ZFKT9Y1PXNZK",
+                "from": "closed",
+                "to": "closed"
+              },
               {
                 "effects": [
                   [
@@ -445,7 +499,15 @@
                         },
                         {
                           "cancelEvent": "CLOSE",
-                          "entity": "@payload.row",
+                          "entity": [
+                            "object/merge",
+                            "@entity.seedRow",
+                            [
+                              "object/merge",
+                              "@payload.row",
+                              {}
+                            ]
+                          ],
                           "fieldOverrides": "@config.fieldOverrides",
                           "fields": "@config.fields",
                           "mode": "@config.mode",
@@ -469,8 +531,38 @@
                     "@config.mode",
                     "create"
                   ],
-                  "@payload.row"
+                  "@payload.row",
+                  [
+                    "!=",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        "@entity.seedRow",
+                        "id"
+                      ],
+                      ""
+                    ],
+                    ""
+                  ]
+                ],
+                "to": "open"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.seedRow",
+                    [
+                      "object/merge",
+                      "@payload.row",
+                      {}
+                    ]
+                  ]
                 ],
+                "event": "SEED",
+                "eventId": "evt_01M15CRJ6RE1E1ZFKT9Y1PXNZK",
+                "from": "open",
                 "to": "open"
               },
               {

package/behaviors/registry/ui/core/atoms/std-record-detail.orb

@@ -285,7 +285,7 @@
           },
           {
             "default": {},
-            "description": "The full row exactly as last fetched (relations hydrated when config.include asks). The document look binds it as the panel's entity and hands it to header actions as ?row, so a settings modal seeds from the real record instead of the atom's four mapped columns.",
+            "description": "The full row exactly as last fetched (relations hydrated when config.include asks). The details drawer binds it, and hosts that need it (e.g. a settings modal) stash it from RecordItemLoaded — the document panel itself takes only scalar props and emits scalar payloads ({ id, title }).",
             "intrinsic": true,
             "name": "loadedRow",
             "type": "object"
@@ -440,7 +440,7 @@
                 "className": "w-full",
                 "editEvent": "EDIT_CONTENT",
                 "editLabel": "@config.editLabel",
-                "entity": "@entity.loadedRow",
+                "id": "@entity.id",
                 "maxInlineActions": "@config.maxInlineActions",
                 "placeholder": "@config.placeholder",
                 "subtitle": "@entity.description",
@@ -463,7 +463,7 @@
                 "doneEvent": "DONE_EDITING",
                 "doneLabel": "@config.doneLabel",
                 "editing": true,
-                "entity": "@entity.loadedRow",
+                "id": "@entity.id",
                 "maxInlineActions": "@config.maxInlineActions",
                 "placeholder": "@config.placeholder",
                 "subtitle": "@entity.description",

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

@@ -19,15 +19,6 @@
         "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",
@@ -340,20 +331,6 @@
               ],
               "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": {
@@ -379,20 +356,6 @@
                 "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",
@@ -493,15 +456,6 @@
             "transitions": [
               {
                 "effects": [
-                  [
-                    "fetch",
-                    "DocumentPanelItem",
-                    {
-                      "emit": {
-                        "success": "DocumentPanelLoaded"
-                      }
-                    }
-                  ],
                   [
                     "set",
                     "@entity.title",
@@ -525,7 +479,6 @@
                       "editEvent": "@config.editEvent",
                       "editLabel": "@config.editLabel",
                       "editing": "@config.editing",
-                      "entity": "@entity",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",
@@ -541,37 +494,6 @@
                 "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": [
                   [
@@ -592,7 +514,6 @@
                       "editEvent": "@config.editEvent",
                       "editLabel": "@config.editLabel",
                       "editing": "@config.editing",
-                      "entity": "@entity",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",
@@ -628,7 +549,6 @@
                       "editEvent": "@config.editEvent",
                       "editLabel": "@config.editLabel",
                       "editing": "@config.editing",
-                      "entity": "@entity",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",