@almadar/std 16.197.0 → 16.198.0

package/behaviors/lolo/ui/core/molecules/ui-wizard-container.lolo

@@ -24,13 +24,13 @@ orbital WizardContainerOrbital {
     title : string
     description : string
     fields : [WizardContainerStepsItemSectionsItemFieldsItem]
-    subsections : [json]
-    condition : [json]
+    subsections : [opaque]
+    condition : [opaque]
     repeatable : boolean
     minItems : number
     addButtonLabel : string
     hiddenCalculations : [WizardContainerStepsItemSectionsItemHiddenCalculationsItem]
-    dataSource : json
+    dataSource : opaque
     readOnly : boolean
   }
   type WizardContainerStepsItemSectionsItemFieldsItem = {
@@ -40,23 +40,23 @@ orbital WizardContainerOrbital {
     required : boolean
     repeatable : boolean
     options : [WizardContainerStepsItemSectionsItemFieldsItemOptionsItem]
-    defaultValue : json
-    condition : [json]
+    defaultValue : opaque
+    condition : [opaque]
     placeholder : string
     entityField : string
     minLength : number
     maxLength : number
-    dataSource : json
+    dataSource : opaque
     displayFields : [string]
-    searchConfig : json
+    searchConfig : opaque
     hiddenCalculations : [WizardContainerStepsItemSectionsItemFieldsItemHiddenCalculationsItem]
-    signatureConfig : json
-    displayTemplate : json
-    lawReference : json
+    signatureConfig : opaque
+    displayTemplate : opaque
+    lawReference : opaque
     contextMenu : [string]
-    calculated : json
+    calculated : opaque
     readOnly : boolean
-    minDate : json
+    minDate : opaque
     stats : [WizardContainerStepsItemSectionsItemFieldsItemStatsItem]
     items : [WizardContainerStepsItemSectionsItemFieldsItemItemsItem]
   }
@@ -72,13 +72,13 @@ orbital WizardContainerOrbital {
   }
   type WizardContainerStepsItemSectionsItemFieldsItemStatsItem = {
     label : string!
-    value : json!
+    value : opaque!
     icon : string
   }
   type WizardContainerStepsItemSectionsItemFieldsItemItemsItem = {
     id : string!
     label : string!
-    autoCheck : json
+    autoCheck : opaque
   }
   type WizardContainerStepsItemSectionsItemHiddenCalculationsItem = {
     variable : string!
@@ -92,7 +92,7 @@ orbital WizardContainerOrbital {
     idField : string
   }
   type WizardContainerStepsItemValidationRulesItem = {
-    condition : [json]!
+    condition : [opaque]!
     message : string!
   }
   type WizardContainerStepsItemLawReferencesItem = {
@@ -140,18 +140,16 @@ orbital WizardContainerOrbital {
       }
         @description "Callback when step changes"
         @tier "essential"
-      @config.onComplete -> external {
-        id : string
-      }
+      @config.onComplete -> external { }
         @description "Callback when wizard is completed"
         @tier "essential"
       @config.nextEvent -> external {
-        id : string
+        step : number!
       }
         @description "Emits UI:{nextEvent} when advancing to next step"
         @tier "essential"
       @config.backEvent -> external {
-        id : string
+        step : number!
       }
         @description "Emits UI:{backEvent} when going to previous step"
         @tier "essential"

package/behaviors/lolo/ui/core/molecules/ui-wizard-navigation.lolo

@@ -124,19 +124,13 @@ orbital WizardNavigationOrbital {
       }
         @description "Event to emit on Complete click — emits UI:{onComplete} with { currentStep, totalSteps }"
         @tier "essential"
-      @config.onBackClick -> external {
-        id : string
-      }
+      @config.onBackClick -> external { }
         @description "Direct callback for Back (alternative to event)"
         @tier "essential"
-      @config.onNextClick -> external {
-        id : string
-      }
+      @config.onNextClick -> external { }
         @description "Direct callback for Next (alternative to event)"
         @tier "essential"
-      @config.onCompleteClick -> external {
-        id : string
-      }
+      @config.onCompleteClick -> external { }
         @description "Direct callback for Complete (alternative to event)"
         @tier "essential"
     }

package/behaviors/lolo/ui/core/organisms/ui-entity-cards.lolo

@@ -128,7 +128,8 @@ orbital EntityCardsOrbital {
 
     emits {
       VIEW -> external {
-        id : string
+        id : string!
+        row : @entity!
       }
         @description "User opened a record from the list."
         @tier "essential"

package/behaviors/lolo/ui/core/organisms/ui-entity-list.lolo

@@ -14,6 +14,13 @@ orbital EntityListOrbital {
     name : string
     label : string
   }
+  type EntityListItemActionsItem = {
+    label : string!
+    event : event
+    navigatesTo : string
+    placement : "row" | "bulk" | "card" | "footer"
+    variant : "primary" | "secondary" | "ghost" | "danger" | "default"
+  }
 
   entity EntityListItem [runtime] {
     id : string!
@@ -102,13 +109,12 @@ orbital EntityListOrbital {
     }
 
     emits {
-      ITEM_ACTIONS -> external {
-        id : string
-      }
+      ITEM_ACTIONS -> external { }
         @description "Item actions - schema-driven or function-based"
         @tier "essential"
       VIEW -> external {
-        id : string
+        id : string!
+        row : @entity!
       }
         @description "User opened a record from the list."
         @tier "essential"
@@ -172,7 +178,7 @@ orbital EntityListOrbital {
         @label "Selectable"
         @description "selectable prop"
         @tier "presentation"
-      itemActions : json = [{ event: VIEW, label: View, variant: ghost }]
+      itemActions : [EntityListItemActionsItem] = [{ event: VIEW, label: View, variant: ghost }]
         @label "Item Actions"
         @description "Item actions - schema-driven or function-based"
         @tier "presentation"

package/behaviors/lolo/ui/core/organisms/ui-entity-table.lolo

@@ -155,7 +155,8 @@ orbital EntityTableOrbital {
 
     emits {
       VIEW -> external {
-        id : string
+        id : string!
+        row : @entity!
       }
         @description "User opened a record from the list."
         @tier "essential"

package/behaviors/lolo/ui/core/organisms/ui-form-section.lolo

@@ -10,7 +10,7 @@ orbital FormSectionOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : json
+    defaultValue : opaque
     options : [FormSectionFieldsItemOptionsItem]
     values : [string]
     relation : FormSectionFieldsItemRelation
@@ -69,10 +69,10 @@ orbital FormSectionOrbital {
     message : string!
   }
   type FormSectionEvaluationContext = {
-    formValues : Map string object!
-    globalVariables : Map string json!
-    localVariables : Map string json
-    entity : Map string object
+    formValues : Map string opaque!
+    globalVariables : Map string opaque!
+    localVariables : Map string opaque
+    entity : Map string opaque
   }
   type FormSectionSectionsItem = {
     id : string!
@@ -89,7 +89,7 @@ orbital FormSectionOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : json
+    defaultValue : opaque
     options : [FormSectionSectionsItemFieldsItemOptionsItem]
     values : [string]
     relation : FormSectionSectionsItemFieldsItemRelation
@@ -115,8 +115,14 @@ orbital FormSectionOrbital {
   }
   type FormSectionFIELDCHANGEChange = {
     fieldId : string!
-    value : object!
-    formValues : Map string object!
+    value : string | number | boolean | [string] | FormSectionFIELDCHANGEChangeValue!
+    formValues : Map string opaque!
+  }
+  type FormSectionFIELDCHANGEChangeValue = {
+    name : string!
+    url : string!
+    mimeType : string!
+    sizeBytes : number!
   }
 
   entity FormSectionItem [runtime] {
@@ -234,13 +240,11 @@ orbital FormSectionOrbital {
 
     emits {
       @config.submitEvent -> external {
-        id : string
+        data : @entity!
       }
         @description "Event dispatch props (for trait state machine integration)"
         @tier "essential"
-      @config.cancelEvent -> external {
-        id : string
-      }
+      @config.cancelEvent -> external { }
         @description "Event to dispatch on cancel (defaults to 'CANCEL')"
         @tier "essential"
       @config.onFieldChange -> external {

package/behaviors/lolo/ui/core/organisms/ui-form.lolo

@@ -10,7 +10,7 @@ orbital FormOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : json
+    defaultValue : opaque
     options : [FormFieldsItemOptionsItem]
     values : [string]
     relation : FormFieldsItemRelation
@@ -69,10 +69,10 @@ orbital FormOrbital {
     message : string!
   }
   type FormEvaluationContext = {
-    formValues : Map string object!
-    globalVariables : Map string json!
-    localVariables : Map string json
-    entity : Map string object
+    formValues : Map string opaque!
+    globalVariables : Map string opaque!
+    localVariables : Map string opaque
+    entity : Map string opaque
   }
   type FormSectionsItem = {
     id : string!
@@ -89,7 +89,7 @@ orbital FormOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : json
+    defaultValue : opaque
     options : [FormSectionsItemFieldsItemOptionsItem]
     values : [string]
     relation : FormSectionsItemFieldsItemRelation
@@ -115,8 +115,14 @@ orbital FormOrbital {
   }
   type FormFIELDCHANGEChange = {
     fieldId : string!
-    value : object!
-    formValues : Map string object!
+    value : string | number | boolean | [string] | FormFIELDCHANGEChangeValue!
+    formValues : Map string opaque!
+  }
+  type FormFIELDCHANGEChangeValue = {
+    name : string!
+    url : string!
+    mimeType : string!
+    sizeBytes : number!
   }
 
   entity FormItem [runtime] {
@@ -234,13 +240,11 @@ orbital FormOrbital {
 
     emits {
       @config.submitEvent -> external {
-        id : string
+        data : @entity!
       }
         @description "Event dispatch props (for trait state machine integration)"
         @tier "essential"
-      @config.cancelEvent -> external {
-        id : string
-      }
+      @config.cancelEvent -> external { }
         @description "Event to dispatch on cancel (defaults to 'CANCEL')"
         @tier "essential"
       @config.onFieldChange -> external {

package/behaviors/lolo/ui/core/organisms/ui-media-gallery.lolo

@@ -112,7 +112,7 @@ orbital MediaGalleryOrbital {
 
     emits {
       @config.selectionEvent -> external {
-        selection : [object]!
+        selection : [string]!
       }
         @description "Event name emitted when selection changes (emitted as UI:{selectionEvent})"
         @tier "essential"

package/behaviors/lolo/ui/core/organisms/ui-segment-renderer.lolo

@@ -1,6 +1,10 @@
 app ui-segment-renderer "1.0.0"
 "SegmentRenderer — UI factory (1:1 with the @almadar/ui segment-renderer pattern)."
 orbital SegmentRendererOrbital {
+  type SegmentRendererSegmentsItem = {
+    type : "markdown"!
+    content : string!
+  }
   type SegmentRendererUserProgress = {
     activationResponse : string
     reflectionNotes : [string]
@@ -26,7 +30,7 @@ orbital SegmentRendererOrbital {
     }
 
     config {
-      segments : [object] = []
+      segments : [SegmentRendererSegmentsItem] = [{ type: markdown, content: "Content" }, { type: markdown, content: "Content 2" }]
         @label "Segments"
         @description "Parsed lesson segments (see `parseLessonSegments`)"
         @tier "presentation"

package/behaviors/lolo/ui/core/organisms/ui-subagent-trace-panel.lolo

@@ -58,9 +58,7 @@ orbital SubagentTracePanelOrbital {
     }
 
     emits {
-      @config.onClose -> external {
-        id : string
-      }
+      @config.onClose -> external { }
         @description "Optional dismiss handler."
         @tier "essential"
       OPEN -> external {
@@ -116,7 +114,7 @@ orbital SubagentTracePanelOrbital {
         @label "Selected Ids"
         @description "Currently selected item IDs"
         @tier "presentation"
-      subagents : [json] = []
+      subagents : [opaque] = []
         @label "Subagents"
         @description "All known subagents from the runner."
         @tier "presentation"
@@ -136,11 +134,11 @@ orbital SubagentTracePanelOrbital {
         @label "On Close"
         @description "Optional dismiss handler."
         @tier "presentation"
-      coordinatorActivities : [json] = []
+      coordinatorActivities : [opaque] = []
         @label "Coordinator Activities"
         @description "Full coordinator activities (tool calls, results, messages, errors)."
         @tier "presentation"
-      coordinatorMessages : [json] = []
+      coordinatorMessages : [opaque] = []
         @label "Coordinator Messages"
         @description "Canonical Coordinator conversation — same shape live and on reload. When present, takes precedence over `coordinatorActivities` for the Coordinator section."
         @tier "presentation"

package/behaviors/lolo/ui/core/organisms/ui-timeline.lolo

@@ -76,7 +76,8 @@ orbital TimelineOrbital {
 
     emits {
       VIEW -> external {
-        id : string
+        id : string!
+        row : @entity!
       }
         @description "User opened a record from the list."
         @tier "essential"

package/behaviors/lolo/ui/core/templates/ui-counter-template.lolo

@@ -69,19 +69,13 @@ orbital CounterTemplateOrbital {
     }
 
     emits {
-      @config.onIncrement -> external {
-        id : string
-      }
+      @config.onIncrement -> external { }
         @description "Called when increment is clicked"
         @tier "essential"
-      @config.onDecrement -> external {
-        id : string
-      }
+      @config.onDecrement -> external { }
         @description "Called when decrement is clicked"
         @tier "essential"
-      @config.onReset -> external {
-        id : string
-      }
+      @config.onReset -> external { }
         @description "Called when reset is clicked"
         @tier "essential"
       CounterTemplateLoaded

package/behaviors/lolo/ui/core/templates/ui-dashboard-layout.lolo

@@ -6,7 +6,7 @@ orbital DashboardLayoutOrbital {
     href : string!
     icon : icon
     badge : string
-    children : [json]
+    children : [opaque]
   }
   type DashboardLayoutUser = {
     name : string!
@@ -16,7 +16,8 @@ orbital DashboardLayoutOrbital {
   type DashboardLayoutTopBarActionsItem = {
     icon : icon!
     label : string
-    event : event!
+    event : event
+    navigatesTo : string
     badge : string
     variant : "default" | "primary" | "danger"
   }
@@ -72,14 +73,10 @@ orbital DashboardLayoutOrbital {
       }
         @description "React-side search submit callback. Used when the host wires the layout directly (not via render-ui pattern resolution)."
         @tier "essential"
-      @config.notificationClickEvent -> external {
-        id : string
-      }
+      @config.notificationClickEvent -> external { }
         @description "Declarative bell click event — fires `UI:{notificationClickEvent}` on the bus with an empty payload when the user clicks the bell."
         @tier "essential"
-      @config.onSignOut -> external {
-        id : string
-      }
+      @config.onSignOut -> external { }
         @description "Callback when user clicks sign out (optional - uses auth context signOut if not provided)"
         @tier "essential"
     }

package/behaviors/lolo/ui/game/.hand-authored.json

@@ -1,6 +1,6 @@
 {
   "game-shell": {
-    "signature": "008546c47daeac39",
+    "signature": "aba270d4ed2ee09a",
     "board": "packages/almadar-std/behaviors/lolo/ui/game/templates/ui-game-shell.lolo"
   },
   "timer-display": {

package/behaviors/lolo/ui/game/atoms/std-fx-particles.lolo

@@ -19,6 +19,7 @@ orbital FxParticlesOrbital {
     vy : number
     vz : number
     particleCount : number
+    animation : string
   }
 
   entity FxState [runtime, shared] {

package/behaviors/lolo/ui/game/atoms/std-mesh-asset-art.lolo

@@ -3,7 +3,7 @@ app std-mesh-asset-art "1.0.0"
 orbital StdMeshAssetArtOrbital {
   entity StdMeshAssetArt [runtime, shared] {
     id : string!
-    meshAssetArt : json = {}
+    meshAssetArt : Map string Map string [node] = {}
   }
 
   trait MeshAssetArtCollector -> @rebindable StdMeshAssetArt [lifecycle] {
@@ -29,11 +29,11 @@ orbital StdMeshAssetArtOrbital {
 
     listens {
       MESH_ASSET_SYNC { }
-      MESH_ASSET_PUBLISH { kind : string, states : json }
+      MESH_ASSET_PUBLISH { kind : string, states : Map string opaque }
     }
 
     config {
-      seedArt : json = {}
+      seedArt : Map string opaque = {}
         @label "Seed Art"
         @description "Initial kind → (state → draw-group items of draw-mesh descriptors) catalog merged under bus-published entries (published entries win). Lets a 3D board ship volumetric art with zero asset imports."
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/std-svg-asset-art.lolo

@@ -3,7 +3,7 @@ app std-svg-asset-art "1.0.0"
 orbital StdSvgAssetArtOrbital {
   entity StdSvgAssetArt [runtime, shared] {
     id : string!
-    svgAssetArt : json = {}
+    svgAssetArt : Map string Map string [node] = {}
   }
 
   trait SvgAssetArtCollector -> @rebindable StdSvgAssetArt [lifecycle] {
@@ -29,11 +29,11 @@ orbital StdSvgAssetArtOrbital {
 
     listens {
       SVG_ASSET_SYNC { }
-      SVG_ASSET_PUBLISH { kind : string, states : json }
+      SVG_ASSET_PUBLISH { kind : string, states : Map string opaque }
     }
 
     config {
-      seedArt : json = {}
+      seedArt : Map string opaque = {}
         @label "Seed Art"
         @description "Initial kind → (state → draw-group items) catalog merged under bus-published entries (published entries win). Lets a board ship vector art with zero asset imports."
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-action-palette.lolo

@@ -8,7 +8,7 @@ orbital ActionPaletteOrbital {
     description : string
     iconEmoji : string
     iconUrl : ActionPaletteActionsItemIconUrl
-    stateMachine : object
+    stateMachine : ActionPaletteActionsItemStateMachine
   }
   type ActionPaletteActionsItemIconUrl = {
     url : asset!
@@ -24,6 +24,19 @@ orbital ActionPaletteOrbital {
     name : string
     thumbnailUrl : string
   }
+  type ActionPaletteActionsItemStateMachine = {
+    name : string!
+    states : [string]!
+    currentState : string!
+    transitions : [ActionPaletteActionsItemStateMachineTransitionsItem]!
+    description : string
+  }
+  type ActionPaletteActionsItemStateMachineTransitionsItem = {
+    from : string!
+    to : string!
+    event : string!
+    guardHint : string
+  }
   type ActionPaletteCategoryColorsValue = {
     bg : string!
     border : string!
@@ -51,7 +64,7 @@ orbital ActionPaletteOrbital {
     }
 
     config {
-      actions : [ActionPaletteActionsItem] = [{ id: "Id", name: "Name", category: "Category", description: "Description", iconEmoji: "Icon Emoji", iconUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png", role: "ui", category: "iconUrl", animations: ["static"], style: "pixel", dimension: "2d", aspect: "1:1", name: "iconUrl", thumbnailUrl: "" } }, { id: "Id 2", name: "Name 2", category: "Category 2", description: "Description 2", iconEmoji: "Icon Emoji 2", iconUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png", role: "ui", category: "iconUrl", animations: ["static"], style: "pixel", dimension: "2d", aspect: "1:1", name: "iconUrl", thumbnailUrl: "" } }]
+      actions : [ActionPaletteActionsItem] = [{ id: "Id", name: "Name", category: "Category", description: "Description", iconEmoji: "Icon Emoji", iconUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png", role: "ui", category: "iconUrl", animations: ["static"], style: "pixel", dimension: "2d", aspect: "1:1", name: "iconUrl", thumbnailUrl: "" }, stateMachine: { name: "Name", states: ["Item", "Item 2"], currentState: "Current State", transitions: [{ from: "From", to: "To", event: "Event", guardHint: "Guard Hint" }, { from: "From 2", to: "To 2", event: "Event 2", guardHint: "Guard Hint 2" }], description: "Description" } }, { id: "Id 2", name: "Name 2", category: "Category 2", description: "Description 2", iconEmoji: "Icon Emoji 2", iconUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png", role: "ui", category: "iconUrl", animations: ["static"], style: "pixel", dimension: "2d", aspect: "1:1", name: "iconUrl", thumbnailUrl: "" }, stateMachine: { name: "Name 2", states: ["Item", "Item 2"], currentState: "Current State 2", transitions: [{ from: "From", to: "To", event: "Event", guardHint: "Guard Hint" }, { from: "From 2", to: "To 2", event: "Event 2", guardHint: "Guard Hint 2" }], description: "Description 2" } }]
         @label "Actions"
         @description "Available actions"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-action-tile.lolo

@@ -14,7 +14,7 @@ orbital ActionTileOrbital {
     description : string
     iconEmoji : string
     iconUrl : ActionTileActionIconUrl
-    stateMachine : object
+    stateMachine : ActionTileActionStateMachine
   }
   type ActionTileActionIconUrl = {
     url : asset!
@@ -30,6 +30,19 @@ orbital ActionTileOrbital {
     name : string
     thumbnailUrl : string
   }
+  type ActionTileActionStateMachine = {
+    name : string!
+    states : [string]!
+    currentState : string!
+    transitions : [ActionTileActionStateMachineTransitionsItem]!
+    description : string
+  }
+  type ActionTileActionStateMachineTransitionsItem = {
+    from : string!
+    to : string!
+    event : string!
+    guardHint : string
+  }
   type ActionTileCategoryColorsValue = {
     bg : string!
     border : string!
@@ -110,7 +123,7 @@ orbital ActionTileOrbital {
         @label "Selected Ids"
         @description "Currently selected item IDs"
         @tier "presentation"
-      action : ActionTileAction = { id: "Id", name: "Name", category: "Category", description: "Description", iconEmoji: "Icon Emoji", iconUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png", role: "ui", category: "iconUrl", animations: ["static"], style: "pixel", dimension: "2d", aspect: "1:1", name: "iconUrl", thumbnailUrl: "" } }
+      action : ActionTileAction = { id: "Id", name: "Name", category: "Category", description: "Description", iconEmoji: "Icon Emoji", iconUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png", role: "ui", category: "iconUrl", animations: ["static"], style: "pixel", dimension: "2d", aspect: "1:1", name: "iconUrl", thumbnailUrl: "" }, stateMachine: { name: "Name", states: ["Item", "Item 2"], currentState: "Current State", transitions: [{ from: "From", to: "To", event: "Event", guardHint: "Guard Hint" }, { from: "From 2", to: "To 2", event: "Event 2", guardHint: "Guard Hint 2" }], description: "Description" } }
         @label "Action"
         @description "The action data"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-canvas-2d.lolo

@@ -71,9 +71,7 @@ orbital Canvas2dOrbital {
       }
         @description "Emits UI:{tileHoverEvent} with the unprojected scene { x, y } on hover."
         @tier "essential"
-      @config.tileLeaveEvent -> external {
-        id : string
-      }
+      @config.tileLeaveEvent -> external { }
         @description "Emits UI:{tileLeaveEvent} with {} on pointer leave."
         @tier "essential"
     }
@@ -95,7 +93,7 @@ orbital Canvas2dOrbital {
         @label "Projection"
         @description "--- Projection ---"
         @tier "presentation"
-      drawables : [object] = []
+      drawables : [node] = []
         @label "Drawables"
         @description "--- Scene ---"
         @tier "presentation"