@almadar/std 16.173.0 → 16.174.0

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

@@ -17,7 +17,7 @@ orbital FormSectionOrbital {
     min : number
     max : number
     pattern : string
-    validation : json
+    validation : FormSectionFieldsItemValidation
     readonly : boolean
     disabled : boolean
   }
@@ -30,6 +30,9 @@ orbital FormSectionOrbital {
     displayField : string
     cardinality : "one" | "many"
   }
+  type FormSectionFieldsItemValidation = {
+    enum : [string]
+  }
   type FormSectionError = {
     message : string!
     name : string
@@ -86,7 +89,7 @@ orbital FormSectionOrbital {
     min : number
     max : number
     pattern : string
-    validation : json
+    validation : FormSectionSectionsItemFieldsItemValidation
     readonly : boolean
     disabled : boolean
   }
@@ -99,6 +102,9 @@ orbital FormSectionOrbital {
     displayField : string
     cardinality : "one" | "many"
   }
+  type FormSectionSectionsItemFieldsItemValidation = {
+    enum : [string]
+  }
   type FormSectionFIELDCHANGEChange = {
     fieldId : string!
     value : json!
@@ -233,7 +239,7 @@ orbital FormSectionOrbital {
         @label "Mode"
         @description "Form mode — 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         @tier "presentation"
-      fields : [FormSectionFieldsItem] = [{ name: "Name", field: "Field", label: "Label", type: "Type", inputType: "Input Type", placeholder: "Placeholder", required: false, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity", displayField: "Display Field", cardinality: one }, min: 1, max: 1, pattern: "Pattern", readonly: false, disabled: false }, { name: "Name 2", field: "Field 2", label: "Label 2", type: "Type 2", inputType: "Input Type 2", placeholder: "Placeholder 2", required: true, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity 2", displayField: "Display Field 2", cardinality: many }, min: 2, max: 2, pattern: "Pattern 2", readonly: true, disabled: true }]
+      fields : [FormSectionFieldsItem] = [{ name: "Name", field: "Field", label: "Label", type: "Type", inputType: "Input Type", placeholder: "Placeholder", required: false, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity", displayField: "Display Field", cardinality: one }, min: 1, max: 1, pattern: "Pattern", validation: { enum: ["Item", "Item 2"] }, readonly: false, disabled: false }, { name: "Name 2", field: "Field 2", label: "Label 2", type: "Type 2", inputType: "Input Type 2", placeholder: "Placeholder 2", required: true, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity 2", displayField: "Display Field 2", cardinality: many }, min: 2, max: 2, pattern: "Pattern 2", validation: { enum: ["Item", "Item 2"] }, readonly: true, disabled: true }]
         @label "Fields"
         @description "Fields definition (schema format) - accepts readonly for generated const arrays"
         @tier "presentation"

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

@@ -17,7 +17,7 @@ orbital FormOrbital {
     min : number
     max : number
     pattern : string
-    validation : json
+    validation : FormFieldsItemValidation
     readonly : boolean
     disabled : boolean
   }
@@ -30,6 +30,9 @@ orbital FormOrbital {
     displayField : string
     cardinality : "one" | "many"
   }
+  type FormFieldsItemValidation = {
+    enum : [string]
+  }
   type FormError = {
     message : string!
     name : string
@@ -86,7 +89,7 @@ orbital FormOrbital {
     min : number
     max : number
     pattern : string
-    validation : json
+    validation : FormSectionsItemFieldsItemValidation
     readonly : boolean
     disabled : boolean
   }
@@ -99,6 +102,9 @@ orbital FormOrbital {
     displayField : string
     cardinality : "one" | "many"
   }
+  type FormSectionsItemFieldsItemValidation = {
+    enum : [string]
+  }
   type FormFIELDCHANGEChange = {
     fieldId : string!
     value : json!
@@ -233,7 +239,7 @@ orbital FormOrbital {
         @label "Mode"
         @description "Form mode — 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         @tier "presentation"
-      fields : [FormFieldsItem] = [{ name: "Name", field: "Field", label: "Label", type: "Type", inputType: "Input Type", placeholder: "Placeholder", required: false, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity", displayField: "Display Field", cardinality: one }, min: 1, max: 1, pattern: "Pattern", readonly: false, disabled: false }, { name: "Name 2", field: "Field 2", label: "Label 2", type: "Type 2", inputType: "Input Type 2", placeholder: "Placeholder 2", required: true, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity 2", displayField: "Display Field 2", cardinality: many }, min: 2, max: 2, pattern: "Pattern 2", readonly: true, disabled: true }]
+      fields : [FormFieldsItem] = [{ name: "Name", field: "Field", label: "Label", type: "Type", inputType: "Input Type", placeholder: "Placeholder", required: false, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity", displayField: "Display Field", cardinality: one }, min: 1, max: 1, pattern: "Pattern", validation: { enum: ["Item", "Item 2"] }, readonly: false, disabled: false }, { name: "Name 2", field: "Field 2", label: "Label 2", type: "Type 2", inputType: "Input Type 2", placeholder: "Placeholder 2", required: true, options: [{ value: "Value", label: "Label" }, { value: "Value 2", label: "Label 2" }], values: ["Item", "Item 2"], relation: { entity: "Entity 2", displayField: "Display Field 2", cardinality: many }, min: 2, max: 2, pattern: "Pattern 2", validation: { enum: ["Item", "Item 2"] }, readonly: true, disabled: true }]
         @label "Fields"
         @description "Fields definition (schema format) - accepts readonly for generated const arrays"
         @tier "presentation"

package/behaviors/lolo/ui/core/organisms/ui-master-detail.lolo

@@ -103,7 +103,7 @@ orbital MasterDetailOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

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

@@ -135,7 +135,7 @@ orbital MediaGalleryOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

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

@@ -1,6 +1,12 @@
 app ui-segment-renderer "1.0.0"
 "SegmentRenderer — UI factory (1:1 with the @almadar/ui segment-renderer pattern)."
 orbital SegmentRendererOrbital {
+  type SegmentRendererUserProgress = {
+    activationResponse : string
+    reflectionNotes : [string]
+    bloomAnswered : Map string boolean
+  }
+
   entity SegmentRendererItem [runtime] {
     id : string!
   }
@@ -32,7 +38,7 @@ orbital SegmentRendererOrbital {
         @label "Container Class Name"
         @description "CSS classes for the outer wrapping div"
         @tier "presentation"
-      userProgress : json = {}
+      userProgress : SegmentRendererUserProgress
         @label "User Progress"
         @description "User progress for restoring activation/reflection state"
         @tier "presentation"

package/behaviors/lolo/ui/core/organisms/ui-stat-card.lolo

@@ -141,7 +141,7 @@ orbital StatCardOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

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

@@ -108,7 +108,7 @@ orbital SubagentTracePanelOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

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

@@ -102,7 +102,7 @@ orbital ActionTileOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-draw-shape-layer.lolo

@@ -12,7 +12,7 @@ orbital DrawShapeLayerOrbital {
     radiusY : number
     offsetX : number
     offsetY : number
-    points : [json]
+    points : [DrawShapeLayerItemsItemPointsItem]
     d : string
     fill : string
     gradient : DrawShapeLayerItemsItemGradient
@@ -25,7 +25,7 @@ orbital DrawShapeLayerOrbital {
     blendMode : "source-over" | "lighter" | "multiply" | "screen" | "overlay" | "darken" | "lighten" | "color-dodge" | "color-burn" | "hard-light" | "soft-light" | "difference" | "exclusion" | "hue" | "saturation" | "color" | "luminosity" | "source-atop" | "destination-over" | "destination-out" | "xor"
     blur : number
     rotate : number
-    pivot : json
+    pivot : DrawShapeLayerItemsItemPivot
     shadow : DrawShapeLayerItemsItemShadow
     animation : DrawShapeLayerItemsItemAnimation
     opacity : number
@@ -35,15 +35,31 @@ orbital DrawShapeLayerOrbital {
     y : number!
     z : number
   }
+  type DrawShapeLayerItemsItemPointsItem = {
+    x : number!
+    y : number!
+  }
   type DrawShapeLayerItemsItemGradient = {
     kind : "linear" | "radial" | "conic"!
-    from : json
-    to : json
-    center : json
+    from : DrawShapeLayerItemsItemGradientFrom
+    to : DrawShapeLayerItemsItemGradientTo
+    center : DrawShapeLayerItemsItemGradientCenter
     radius : number
     angle : number
     stops : [json]!
   }
+  type DrawShapeLayerItemsItemGradientFrom = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeLayerItemsItemGradientTo = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeLayerItemsItemGradientCenter = {
+    x : number!
+    y : number!
+  }
   type DrawShapeLayerItemsItemFillPattern = {
     kind : "noise" | "image"!
     url : string
@@ -53,13 +69,29 @@ orbital DrawShapeLayerOrbital {
   }
   type DrawShapeLayerItemsItemStrokeGradient = {
     kind : "linear" | "radial" | "conic"!
-    from : json
-    to : json
-    center : json
+    from : DrawShapeLayerItemsItemStrokeGradientFrom
+    to : DrawShapeLayerItemsItemStrokeGradientTo
+    center : DrawShapeLayerItemsItemStrokeGradientCenter
     radius : number
     angle : number
     stops : [json]!
   }
+  type DrawShapeLayerItemsItemStrokeGradientFrom = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeLayerItemsItemStrokeGradientTo = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeLayerItemsItemStrokeGradientCenter = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeLayerItemsItemPivot = {
+    x : number!
+    y : number!
+  }
   type DrawShapeLayerItemsItemShadow = {
     color : string!
     blur : number!
@@ -107,7 +139,7 @@ orbital DrawShapeLayerOrbital {
     }
 
     config {
-      items : [DrawShapeLayerItemsItem] = [{ type: "Type", shape: cell, position: { x: 1, y: 1, z: 1 }, width: 1, height: 1, radiusX: 1, radiusY: 1, offsetX: 1, offsetY: 1, points: [], d: "D", fill: "Fill", gradient: { kind: linear, radius: 1, angle: 1, stops: [] }, fillPattern: { kind: noise, url: "Url", scale: 1, alpha: 1, color: "Color" }, stroke: "Stroke", strokeWidth: 1, strokeGradient: { kind: linear, radius: 1, angle: 1, stops: [] }, strokeDash: [1, 2], strokeDashOffset: 1, blendMode: "source-over", blur: 1, rotate: 1, shadow: { color: "Color", blur: 1 }, animation: { durationMs: 1, loop: false, keyframes: [{ at: 1, offsetX: 1, offsetY: 1, rotate: 1, opacity: 1, radiusX: 1, radiusY: 1, width: 1, height: 1, strokeWidth: 1, strokeDashOffset: 1, blur: 1, fill: "Fill", stroke: "Stroke", shadow: { color: "Color", blur: 1 } }, { at: 2, offsetX: 2, offsetY: 2, rotate: 2, opacity: 2, radiusX: 2, radiusY: 2, width: 2, height: 2, strokeWidth: 2, strokeDashOffset: 2, blur: 2, fill: "Fill 2", stroke: "Stroke 2", shadow: { color: "Color 2", blur: 2 } }] }, opacity: 1 }, { type: "Type 2", shape: rect, position: { x: 2, y: 2, z: 2 }, width: 2, height: 2, radiusX: 2, radiusY: 2, offsetX: 2, offsetY: 2, points: [], d: "D 2", fill: "Fill 2", gradient: { kind: radial, radius: 2, angle: 2, stops: [] }, fillPattern: { kind: image, url: "Url 2", scale: 2, alpha: 2, color: "Color 2" }, stroke: "Stroke 2", strokeWidth: 2, strokeGradient: { kind: radial, radius: 2, angle: 2, stops: [] }, strokeDash: [1, 2], strokeDashOffset: 2, blendMode: lighter, blur: 2, rotate: 2, shadow: { color: "Color 2", blur: 2 }, animation: { durationMs: 2, loop: true, keyframes: [{ at: 1, offsetX: 1, offsetY: 1, rotate: 1, opacity: 1, radiusX: 1, radiusY: 1, width: 1, height: 1, strokeWidth: 1, strokeDashOffset: 1, blur: 1, fill: "Fill", stroke: "Stroke", shadow: { color: "Color", blur: 1 } }, { at: 2, offsetX: 2, offsetY: 2, rotate: 2, opacity: 2, radiusX: 2, radiusY: 2, width: 2, height: 2, strokeWidth: 2, strokeDashOffset: 2, blur: 2, fill: "Fill 2", stroke: "Stroke 2", shadow: { color: "Color 2", blur: 2 } }] }, opacity: 2 }]
+      items : [DrawShapeLayerItemsItem] = [{ type: "Type", shape: cell, position: { x: 1, y: 1, z: 1 }, width: 1, height: 1, radiusX: 1, radiusY: 1, offsetX: 1, offsetY: 1, points: [{ x: 1, y: 1 }, { x: 2, y: 2 }], d: "D", fill: "Fill", gradient: { kind: linear, from: { x: 1, y: 1 }, to: { x: 1, y: 1 }, center: { x: 1, y: 1 }, radius: 1, angle: 1, stops: [] }, fillPattern: { kind: noise, url: "Url", scale: 1, alpha: 1, color: "Color" }, stroke: "Stroke", strokeWidth: 1, strokeGradient: { kind: linear, from: { x: 1, y: 1 }, to: { x: 1, y: 1 }, center: { x: 1, y: 1 }, radius: 1, angle: 1, stops: [] }, strokeDash: [1, 2], strokeDashOffset: 1, blendMode: "source-over", blur: 1, rotate: 1, pivot: { x: 1, y: 1 }, shadow: { color: "Color", blur: 1 }, animation: { durationMs: 1, loop: false, keyframes: [{ at: 1, offsetX: 1, offsetY: 1, rotate: 1, opacity: 1, radiusX: 1, radiusY: 1, width: 1, height: 1, strokeWidth: 1, strokeDashOffset: 1, blur: 1, fill: "Fill", stroke: "Stroke", shadow: { color: "Color", blur: 1 } }, { at: 2, offsetX: 2, offsetY: 2, rotate: 2, opacity: 2, radiusX: 2, radiusY: 2, width: 2, height: 2, strokeWidth: 2, strokeDashOffset: 2, blur: 2, fill: "Fill 2", stroke: "Stroke 2", shadow: { color: "Color 2", blur: 2 } }] }, opacity: 1 }, { type: "Type 2", shape: rect, position: { x: 2, y: 2, z: 2 }, width: 2, height: 2, radiusX: 2, radiusY: 2, offsetX: 2, offsetY: 2, points: [{ x: 1, y: 1 }, { x: 2, y: 2 }], d: "D 2", fill: "Fill 2", gradient: { kind: radial, from: { x: 2, y: 2 }, to: { x: 2, y: 2 }, center: { x: 2, y: 2 }, radius: 2, angle: 2, stops: [] }, fillPattern: { kind: image, url: "Url 2", scale: 2, alpha: 2, color: "Color 2" }, stroke: "Stroke 2", strokeWidth: 2, strokeGradient: { kind: radial, from: { x: 2, y: 2 }, to: { x: 2, y: 2 }, center: { x: 2, y: 2 }, radius: 2, angle: 2, stops: [] }, strokeDash: [1, 2], strokeDashOffset: 2, blendMode: lighter, blur: 2, rotate: 2, pivot: { x: 2, y: 2 }, shadow: { color: "Color 2", blur: 2 }, animation: { durationMs: 2, loop: true, keyframes: [{ at: 1, offsetX: 1, offsetY: 1, rotate: 1, opacity: 1, radiusX: 1, radiusY: 1, width: 1, height: 1, strokeWidth: 1, strokeDashOffset: 1, blur: 1, fill: "Fill", stroke: "Stroke", shadow: { color: "Color", blur: 1 } }, { at: 2, offsetX: 2, offsetY: 2, rotate: 2, opacity: 2, radiusX: 2, radiusY: 2, width: 2, height: 2, strokeWidth: 2, strokeDashOffset: 2, blur: 2, fill: "Fill 2", stroke: "Stroke 2", shadow: { color: "Color 2", blur: 2 } }] }, opacity: 2 }]
         @label "Items"
         @description "items prop"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-draw-shape.lolo

@@ -6,15 +6,31 @@ orbital DrawShapeOrbital {
     y : number!
     z : number
   }
+  type DrawShapePointsItem = {
+    x : number!
+    y : number!
+  }
   type DrawShapeGradient = {
     kind : "linear" | "radial" | "conic"!
-    from : json
-    to : json
-    center : json
+    from : DrawShapeGradientFrom
+    to : DrawShapeGradientTo
+    center : DrawShapeGradientCenter
     radius : number
     angle : number
     stops : [json]!
   }
+  type DrawShapeGradientFrom = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeGradientTo = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeGradientCenter = {
+    x : number!
+    y : number!
+  }
   type DrawShapeFillPattern = {
     kind : "noise" | "image"!
     url : string
@@ -24,13 +40,29 @@ orbital DrawShapeOrbital {
   }
   type DrawShapeStrokeGradient = {
     kind : "linear" | "radial" | "conic"!
-    from : json
-    to : json
-    center : json
+    from : DrawShapeStrokeGradientFrom
+    to : DrawShapeStrokeGradientTo
+    center : DrawShapeStrokeGradientCenter
     radius : number
     angle : number
     stops : [json]!
   }
+  type DrawShapeStrokeGradientFrom = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeStrokeGradientTo = {
+    x : number!
+    y : number!
+  }
+  type DrawShapeStrokeGradientCenter = {
+    x : number!
+    y : number!
+  }
+  type DrawShapePivot = {
+    x : number!
+    y : number!
+  }
   type DrawShapeShadow = {
     color : string!
     blur : number!
@@ -139,7 +171,7 @@ orbital DrawShapeOrbital {
         @label "Offset Y"
         @description "offsetY prop"
         @tier "presentation"
-      points : [json] = []
+      points : [DrawShapePointsItem] = []
         @label "Points"
         @description "Poly vertices as world-unit offsets relative to the cell's projected top-left."
         @tier "presentation"
@@ -191,7 +223,7 @@ orbital DrawShapeOrbital {
         @label "Rotate"
         @description "Rotation in radians (painter units, same as `draw-group`), about `pivot`."
         @tier "presentation"
-      pivot : json = {}
+      pivot : DrawShapePivot
         @label "Pivot"
         @description "Rotation pivot in world units relative to the cell's projected top-left; default `{x:0.5, y:0.5}` (cell center)."
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-draw-sprite-layer.lolo

@@ -8,13 +8,13 @@ orbital DrawSpriteLayerOrbital {
     anchor : json
     width : number
     height : number
-    frame : json
+    frame : DrawSpriteLayerItemsItemFrame
     animation : string
     loop : boolean
     flipX : boolean
     rotation : number
     opacity : number
-    shadow : json
+    shadow : DrawSpriteLayerItemsItemShadow
   }
   type DrawSpriteLayerItemsItemPosition = {
     x : number!
@@ -35,6 +35,16 @@ orbital DrawSpriteLayerOrbital {
     name : string
     thumbnailUrl : string
   }
+  type DrawSpriteLayerItemsItemFrame = {
+    x : number!
+    y : number!
+    w : number!
+    h : number!
+  }
+  type DrawSpriteLayerItemsItemShadow = {
+    color : string!
+    blur : number!
+  }
 
   entity DrawSpriteLayerItem [runtime] {
     id : string!
@@ -52,7 +62,7 @@ orbital DrawSpriteLayerOrbital {
     }
 
     config {
-      items : [DrawSpriteLayerItemsItem] = [{ type: "Type", position: { x: 1, y: 1, z: 1 }, asset: { url: "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png", role: "npc", category: "asset", animations: ["idle", "walk", "attack", "hit", "death"], style: "pixel", dimension: "2d", aspect: "1:1", name: "asset", thumbnailUrl: "" }, width: 1, height: 1, animation: "Animation", loop: false, flipX: false, rotation: 1, opacity: 1 }, { type: "Type 2", position: { x: 2, y: 2, z: 2 }, asset: { url: "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png", role: "npc", category: "asset", animations: ["idle", "walk", "attack", "hit", "death"], style: "pixel", dimension: "2d", aspect: "1:1", name: "asset", thumbnailUrl: "" }, width: 2, height: 2, animation: "Animation 2", loop: true, flipX: true, rotation: 2, opacity: 2 }]
+      items : [DrawSpriteLayerItemsItem] = [{ type: "Type", position: { x: 1, y: 1, z: 1 }, asset: { url: "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png", role: "npc", category: "asset", animations: ["idle", "walk", "attack", "hit", "death"], style: "pixel", dimension: "2d", aspect: "1:1", name: "asset", thumbnailUrl: "" }, width: 1, height: 1, frame: { x: 1, y: 1, w: 1, h: 1 }, animation: "Animation", loop: false, flipX: false, rotation: 1, opacity: 1, shadow: { color: "Color", blur: 1 } }, { type: "Type 2", position: { x: 2, y: 2, z: 2 }, asset: { url: "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png", role: "npc", category: "asset", animations: ["idle", "walk", "attack", "hit", "death"], style: "pixel", dimension: "2d", aspect: "1:1", name: "asset", thumbnailUrl: "" }, width: 2, height: 2, frame: { x: 2, y: 2, w: 2, h: 2 }, animation: "Animation 2", loop: true, flipX: true, rotation: 2, opacity: 2, shadow: { color: "Color 2", blur: 2 } }]
         @label "Items"
         @description "Sprites painted in array order; z-ordering is the caller's responsibility."
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-draw-sprite.lolo

@@ -20,6 +20,16 @@ orbital DrawSpriteOrbital {
     name : string
     thumbnailUrl : string
   }
+  type DrawSpriteFrame = {
+    x : number!
+    y : number!
+    w : number!
+    h : number!
+  }
+  type DrawSpriteShadow = {
+    color : string!
+    blur : number!
+  }
 
   entity DrawSpriteItem [runtime] {
     id : string!
@@ -68,7 +78,7 @@ orbital DrawSpriteOrbital {
         @label "Height"
         @description "Draw height in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`."
         @tier "presentation"
-      frame : json = {}
+      frame : DrawSpriteFrame
         @label "Frame"
         @description "Explicit atlas sub-rect override (px); omitted → resolved from `asset.atlas`/`asset.sprite`."
         @tier "presentation"
@@ -92,7 +102,7 @@ orbital DrawSpriteOrbital {
         @label "Opacity"
         @description "0..1 opacity."
         @tier "presentation"
-      shadow : json = {}
+      shadow : DrawSpriteShadow
         @label "Shadow"
         @description "Drop shadow (e.g. a team-colored glow)."
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-draw-text-layer.lolo

@@ -10,8 +10,8 @@ orbital DrawTextLayerOrbital {
     offsetY : number
     color : string!
     font : string
-    align : json
-    baseline : json
+    align : "center" | "end" | "left" | "right" | "start"
+    baseline : "alphabetic" | "bottom" | "hanging" | "ideographic" | "middle" | "top"
     opacity : number
   }
   type DrawTextLayerItemsItemPosition = {
@@ -36,7 +36,7 @@ orbital DrawTextLayerOrbital {
     }
 
     config {
-      items : [DrawTextLayerItemsItem] = [{ type: "Type", text: "Text", position: { x: 1, y: 1, z: 1 }, offsetX: 1, offsetY: 1, color: "Color", font: "Font", opacity: 1 }, { type: "Type 2", text: "Text 2", position: { x: 2, y: 2, z: 2 }, offsetX: 2, offsetY: 2, color: "Color 2", font: "Font 2", opacity: 2 }]
+      items : [DrawTextLayerItemsItem] = [{ type: "Type", text: "Text", position: { x: 1, y: 1, z: 1 }, offsetX: 1, offsetY: 1, color: "Color", font: "Font", align: center, baseline: alphabetic, opacity: 1 }, { type: "Type 2", text: "Text 2", position: { x: 2, y: 2, z: 2 }, offsetX: 2, offsetY: 2, color: "Color 2", font: "Font 2", align: end, baseline: bottom, opacity: 2 }]
         @label "Items"
         @description "items prop"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-draw-text.lolo

@@ -60,11 +60,11 @@ orbital DrawTextOrbital {
         @label "Font"
         @description "font prop"
         @tier "presentation"
-      align : json = {}
+      align : "center" | "end" | "left" | "right" | "start" = center
         @label "Align"
         @description "align prop"
         @tier "presentation"
-      baseline : json = {}
+      baseline : "alphabetic" | "bottom" | "hanging" | "ideographic" | "middle" | "top" = alphabetic
         @label "Baseline"
         @description "baseline prop"
         @tier "presentation"

package/behaviors/lolo/ui/game/organisms/std-tactics-board-3d.lolo

@@ -1,6 +1,36 @@
 app std-tactics-board-3d "1.0.0"
 "3D player-controlled grid-tactics board FRAME: composes grid-tactics (units authority) + fx-particles + round-flow + a player-intent/render trait onto one shared GameState. Games consume this molecule and supply only theme/assets/units via config."
 orbital TacticsBoard3DOrbital {
+  type SceneLight = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type SceneHemiLight = {
+    intensity : number
+    color : string
+    groundColor : string
+  }
+  type ScenePointLight = {
+    intensity : number
+    color : string
+    position : [number]!
+    distance : number
+    decay : number
+  }
+  type Lighting3D = {
+    ambient : SceneLight
+    directional : SceneLight
+    hemisphere : SceneHemiLight
+    points : [ScenePointLight]
+    environment : "room" | "none"
+    toneMapping : "aces" | "none"
+  }
+  type Post3D = {
+    bloom : { intensity : number  threshold : number  smoothing : number }
+    vignette : { offset : number  darkness : number }
+  }
+
   uses Tactics from "std/behaviors/std-grid-tactics"
   uses Particles from "std/behaviors/std-fx-particles"
   uses Round from "std/behaviors/std-round-flow"
@@ -305,11 +335,11 @@ orbital TacticsBoard3DOrbital {
         @label "Mesh Unit Scale"
         @description "Uniform scale applied to volumetric (meshAssetArt draw-group) units."
         @tier "presentation"
-      lighting : json = {}
+      lighting : Lighting3D = {}
         @label "Lighting"
         @description "3D scene light rig as data — ambient/directional/hemisphere/points + environment ('room' | 'none') for PBR reflections. Empty → the standard fixed rig."
         @tier "presentation"
-      post : json = {}
+      post : Post3D = {}
         @label "Post Effects"
         @description "3D post-processing stack — bloom and vignette. Empty → no post pass."
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/std-learn-classify.lolo

@@ -68,7 +68,7 @@ orbital LearnClassifyOrbital {
     roundComplete : boolean = false
     categoryStats : [LearnClassifyCategoryStat]
     backdropShapes : [LearnClassifyShape]
-    roundView : [json]
+    roundView : [node]
   }
 
   trait LearnClassifySim -> @rebindable LearnClassifyScene [interaction, instance] {