@almadar/std 16.173.0 → 16.175.0

package/behaviors/lolo/ui/learning/atoms/ui-chemistry-canvas.lolo

@@ -5,15 +5,19 @@ orbital ChemistryCanvasOrbital {
     id : string
     x : number!
     y : number!
+    z : number
     element : string
     radius : number
     color : string
+    charge : string
+    lonePairs : number
   }
   type ChemistryCanvasBondsItem = {
     from : string!
     to : string!
     type : "single" | "double" | "triple"
     color : string
+    state : "default" | "forming" | "breaking" | "highlight"
   }
   type ChemistryCanvasArrowsItem = {
     x : number!
@@ -23,8 +27,58 @@ orbital ChemistryCanvasOrbital {
     color : string
     label : string
   }
+  type ChemistryCanvasContainersItem = {
+    x : number!
+    y : number!
+    width : number!
+    height : number!
+    color : string
+    fill : string
+    lineWidth : number
+    divider : "none" | "solid" | "dashed" | "dotted"
+    dividerColor : string
+    leftLabel : string
+    rightLabel : string
+    label : string
+    level : number
+    levelColor : string
+  }
+  type ChemistryCanvasLattice3d = {
+    basis : [ChemistryCanvasLattice3dBasisItem]!
+    nx : number
+    ny : number
+    nz : number
+    latticeConstant : number
+    bonds : [ChemistryCanvasLattice3dBondsItem]
+    bondRadius : number
+    highlightCell : boolean
+    dimColor : string
+    showLabels : boolean
+    selectedId : string
+    selectedColor : string
+  }
+  type ChemistryCanvasLattice3dBasisItem = {
+    key : string!
+    dx : number!
+    dy : number!
+    dz : number!
+    element : string
+    color : string
+    radius : number
+    xEdge : boolean
+    yEdge : boolean
+    zEdge : boolean
+  }
+  type ChemistryCanvasLattice3dBondsItem = {
+    from : string!
+    to : string!
+    dx : number
+    dy : number
+    dz : number
+    color : string
+  }
   type ChemistryCanvasShapesItem = {
-    type : "line" | "arrow" | "circle" | "rect" | "polygon" | "path" | "text" | "axis" | "grid"!
+    type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
     y : number
@@ -49,11 +103,42 @@ orbital ChemistryCanvasOrbital {
     fill : string
     lineWidth : number
     opacity : number
+    startAngle : number
+    endAngle : number
+    dash : "dashed" | "dotted"
+    inside : [string]
+    outside : [string]
   }
   type ChemistryCanvasShapesItemPointsItem = {
     x : number!
     y : number!
   }
+  type ChemistryCanvasReadoutsItem = {
+    label : string!
+    value : string!
+    color : string
+  }
+  type ChemistryCanvasTracesItem = {
+    x : number
+    y : number
+    width : number
+    height : number
+    series : [ChemistryCanvasTracesItemSeriesItem]!
+    xLabel : string
+    yLabel : string
+    frameColor : string
+    backgroundColor : string
+    backgroundOpacity : number
+  }
+  type ChemistryCanvasTracesItemSeriesItem = {
+    samples : [ChemistryCanvasTracesItemSeriesItemSamplesItem]!
+    color : string
+    label : string
+  }
+  type ChemistryCanvasTracesItemSeriesItemSamplesItem = {
+    x : number!
+    y : number!
+  }
   type ChemistryCanvasError = {
     message : string!
     name : string
@@ -81,10 +166,23 @@ orbital ChemistryCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          mode: @config.mode
+          camera: @config.camera
+          lighting: @config.lighting
+          post: @config.post
           atoms: @config.atoms
           bonds: @config.bonds
           arrows: @config.arrows
+          bondStyle: @config.bondStyle
+          containers: @config.containers
+          equation: @config.equation
+          equationColor: @config.equationColor
+          lattice3d: @config.lattice3d
           shapes: @config.shapes
+          readouts: @config.readouts
+          traces: @config.traces
+          showGrid: @config.showGrid
+          shadows: @config.shadows
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -99,10 +197,23 @@ orbital ChemistryCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          mode: @config.mode
+          camera: @config.camera
+          lighting: @config.lighting
+          post: @config.post
           atoms: @payload.atoms
           bonds: @payload.bonds
           arrows: @payload.arrows
+          bondStyle: @config.bondStyle
+          containers: @payload.containers
+          equation: @config.equation
+          equationColor: @config.equationColor
+          lattice3d: @config.lattice3d
           shapes: @payload.shapes
+          readouts: @payload.readouts
+          traces: @payload.traces
+          showGrid: @config.showGrid
+          shadows: @config.shadows
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -125,7 +236,10 @@ orbital ChemistryCanvasOrbital {
         atoms : [ChemistryCanvasAtomsItem]
         bonds : [ChemistryCanvasBondsItem]
         arrows : [ChemistryCanvasArrowsItem]
+        containers : [ChemistryCanvasContainersItem]
         shapes : [ChemistryCanvasShapesItem]
+        readouts : [ChemistryCanvasReadoutsItem]
+        traces : [ChemistryCanvasTracesItem]
       }
         @description "Live scene update; payload carries the current drawable state."
         @synonyms "tick, redraw, animate, frame"
@@ -153,6 +267,22 @@ orbital ChemistryCanvasOrbital {
         @label "Background Color"
         @description "backgroundColor prop"
         @tier "presentation"
+      mode : "2d" | "3d" = "2d"
+        @label "Mode"
+        @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
+        @tier "presentation"
+      camera : json = {}
+        @label "Camera"
+        @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
+        @tier "presentation"
+      lighting : json = {}
+        @label "Lighting"
+        @description "3D only: scene light rig as data."
+        @tier "presentation"
+      post : json = {}
+        @label "Post"
+        @description "3D only: post-processing stack (bloom/vignette)."
+        @tier "presentation"
       atoms : [ChemistryCanvasAtomsItem] = []
         @label "Atoms"
         @description "atoms prop"
@@ -165,17 +295,55 @@ orbital ChemistryCanvasOrbital {
         @label "Arrows"
         @description "arrows prop"
         @tier "presentation"
+      bondStyle : "thick" | "parallel" = thick
+        @label "Bond Style"
+        @description "Bond line rendering: 'thick' varies stroke width by order (default), 'parallel' draws offset parallel strokes. 2D only."
+        @tier "presentation"
+      containers : [ChemistryCanvasContainersItem] = []
+        @label "Containers"
+        @description "Beaker/flask/container outlines (2D only)."
+        @synonyms "beaker, flask, box, membrane, burette"
+        @tier "presentation"
+      equation : string
+        @label "Equation"
+        @description "Reaction equation text centered at the top of the canvas. 2D only."
+        @synonyms "reaction equation, formula"
+        @tier "presentation"
+      equationColor : string
+        @label "Equation Color"
+        @description "Equation text color (default '#111827')."
+        @tier "presentation"
+      lattice3d : ChemistryCanvasLattice3d
+        @label "Lattice3d"
+        @description "A 3D crystal lattice block (simple cubic, BCC, FCC, rock salt, diamond, ...). 3D only."
+        @tier "presentation"
       shapes : [ChemistryCanvasShapesItem] = []
         @label "Shapes"
-        @description "Extra declarative shapes in canvas pixel coordinates."
+        @description "Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D)."
+        @tier "presentation"
+      readouts : [ChemistryCanvasReadoutsItem] = []
+        @label "Readouts"
+        @description "Top-right status chip row, forwarded to LearningCanvas verbatim."
+        @tier "presentation"
+      traces : [ChemistryCanvasTracesItem] = []
+        @label "Traces"
+        @description "Inset sparkline panels, forwarded to LearningCanvas verbatim."
+        @tier "presentation"
+      showGrid : boolean
+        @label "Show Grid"
+        @description "3D only: show the ground grid (default off)."
+        @tier "presentation"
+      shadows : boolean
+        @label "Shadows"
+        @description "3D only: enable shadows. Omitted → the host default."
         @tier "presentation"
-      interactive : boolean = false
+      interactive : boolean
         @label "Interactive"
-        @description "interactive prop"
+        @description "2D: pointer interaction (click/hover). 3D: orbit camera controls."
         @tier "presentation"
       animate : boolean = false
         @label "Animate"
-        @description "animate prop"
+        @description "2D only: continuous redraw loop. 3D motion is entity-state driven."
         @tier "presentation"
       onShapeClick : string = "SHAPE_CLICK"
         @label "On Shape Click"

package/behaviors/lolo/ui/learning/atoms/ui-learning-canvas.lolo

@@ -2,7 +2,7 @@ app ui-learning-canvas "1.0.0"
 "LearningCanvas — UI factory (1:1 with the @almadar/ui learning-canvas pattern)."
 orbital LearningCanvasOrbital {
   type LearningCanvasShapesItem = {
-    type : "line" | "arrow" | "circle" | "rect" | "polygon" | "path" | "text" | "axis" | "grid"!
+    type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
     y : number
@@ -27,11 +27,42 @@ orbital LearningCanvasOrbital {
     fill : string
     lineWidth : number
     opacity : number
+    startAngle : number
+    endAngle : number
+    dash : "dashed" | "dotted"
+    inside : [string]
+    outside : [string]
   }
   type LearningCanvasShapesItemPointsItem = {
     x : number!
     y : number!
   }
+  type LearningCanvasReadoutsItem = {
+    label : string!
+    value : string!
+    color : string
+  }
+  type LearningCanvasTracesItem = {
+    x : number
+    y : number
+    width : number
+    height : number
+    series : [LearningCanvasTracesItemSeriesItem]!
+    xLabel : string
+    yLabel : string
+    frameColor : string
+    backgroundColor : string
+    backgroundOpacity : number
+  }
+  type LearningCanvasTracesItemSeriesItem = {
+    samples : [LearningCanvasTracesItemSeriesItemSamplesItem]!
+    color : string
+    label : string
+  }
+  type LearningCanvasTracesItemSeriesItemSamplesItem = {
+    x : number!
+    y : number!
+  }
   type LearningCanvasError = {
     message : string!
     name : string
@@ -64,6 +95,8 @@ orbital LearningCanvasOrbital {
           height: @config.height
           backgroundColor: @config.backgroundColor
           shapes: @config.shapes
+          readouts: @config.readouts
+          traces: @config.traces
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -79,6 +112,8 @@ orbital LearningCanvasOrbital {
           height: @config.height
           backgroundColor: @config.backgroundColor
           shapes: @payload.shapes
+          readouts: @payload.readouts
+          traces: @payload.traces
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -105,6 +140,8 @@ orbital LearningCanvasOrbital {
     listens {
       UPDATE {
         shapes : [LearningCanvasShapesItem]
+        readouts : [LearningCanvasReadoutsItem]
+        traces : [LearningCanvasTracesItem]
       }
         @description "Live scene update; payload carries the current drawable state."
         @synonyms "tick, redraw, animate, frame"
@@ -132,6 +169,16 @@ orbital LearningCanvasOrbital {
         @label "Shapes"
         @description "Declarative shapes to draw."
         @tier "presentation"
+      readouts : [LearningCanvasReadoutsItem] = []
+        @label "Readouts"
+        @description "Top-right status chip row (live measurements, scores, counters)."
+        @synonyms "chips, stats, measurements"
+        @tier "presentation"
+      traces : [LearningCanvasTracesItem] = []
+        @label "Traces"
+        @description "Inset sparkline panels stacked from the bottom-right corner."
+        @synonyms "sparkline, time series, history plot"
+        @tier "presentation"
       interactive : boolean = false
         @label "Interactive"
         @description "Enable pointer interaction (click/hover)."

package/behaviors/lolo/ui/learning/atoms/ui-math-canvas.lolo

@@ -5,6 +5,7 @@ orbital MathCanvasOrbital {
     label : string
     color : string
     samples : [MathCanvasCurvesItemSamplesItem]!
+    dash : "dashed" | "dotted"
   }
   type MathCanvasCurvesItemSamplesItem = {
     x : number!
@@ -16,6 +17,7 @@ orbital MathCanvasOrbital {
     label : string
     color : string
     radius : number
+    style : "closed" | "open"
   }
   type MathCanvasVectorsItem = {
     x : number!
@@ -25,8 +27,54 @@ orbital MathCanvasOrbital {
     color : string
     label : string
   }
+  type MathCanvasRegionsItem = {
+    samples : [MathCanvasRegionsItemSamplesItem]!
+    samples2 : [MathCanvasRegionsItemSamples2Item]
+    baseline : number
+    color : string
+    opacity : number
+    label : string
+  }
+  type MathCanvasRegionsItemSamplesItem = {
+    x : number!
+    y : number!
+  }
+  type MathCanvasRegionsItemSamples2Item = {
+    x : number!
+    y : number!
+  }
+  type MathCanvasBarsItem = {
+    x : number!
+    width : number!
+    y0 : number
+    y1 : number!
+    color : string
+    opacity : number
+  }
+  type MathCanvasGuidesItem = {
+    kind : "vline" | "hline"!
+    at : number!
+    color : string
+    dash : "dashed" | "dotted"
+    label : string
+  }
+  type MathCanvasAnglesItem = {
+    x : number!
+    y : number!
+    from : number!
+    to : number!
+    radius : number
+    color : string
+    label : string
+  }
+  type MathCanvasHopsItem = {
+    from : number!
+    to : number!
+    color : string
+    label : string
+  }
   type MathCanvasShapesItem = {
-    type : "line" | "arrow" | "circle" | "rect" | "polygon" | "path" | "text" | "axis" | "grid"!
+    type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
     y : number
@@ -51,11 +99,42 @@ orbital MathCanvasOrbital {
     fill : string
     lineWidth : number
     opacity : number
+    startAngle : number
+    endAngle : number
+    dash : "dashed" | "dotted"
+    inside : [string]
+    outside : [string]
   }
   type MathCanvasShapesItemPointsItem = {
     x : number!
     y : number!
   }
+  type MathCanvasReadoutsItem = {
+    label : string!
+    value : string!
+    color : string
+  }
+  type MathCanvasTracesItem = {
+    x : number
+    y : number
+    width : number
+    height : number
+    series : [MathCanvasTracesItemSeriesItem]!
+    xLabel : string
+    yLabel : string
+    frameColor : string
+    backgroundColor : string
+    backgroundOpacity : number
+  }
+  type MathCanvasTracesItemSeriesItem = {
+    samples : [MathCanvasTracesItemSeriesItemSamplesItem]!
+    color : string
+    label : string
+  }
+  type MathCanvasTracesItemSeriesItemSamplesItem = {
+    x : number!
+    y : number!
+  }
   type MathCanvasError = {
     message : string!
     name : string
@@ -89,10 +168,19 @@ orbital MathCanvasOrbital {
           showAxes: @config.showAxes
           showGrid: @config.showGrid
           gridStep: @config.gridStep
+          showTickLabels: @config.showTickLabels
+          showCurveLabels: @config.showCurveLabels
           curves: @config.curves
           points: @config.points
           vectors: @config.vectors
+          regions: @config.regions
+          bars: @config.bars
+          guides: @config.guides
+          angles: @config.angles
+          hops: @config.hops
           shapes: @config.shapes
+          readouts: @config.readouts
+          traces: @config.traces
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -113,10 +201,19 @@ orbital MathCanvasOrbital {
           showAxes: @config.showAxes
           showGrid: @config.showGrid
           gridStep: @config.gridStep
+          showTickLabels: @config.showTickLabels
+          showCurveLabels: @config.showCurveLabels
           curves: @payload.curves
           points: @payload.points
           vectors: @payload.vectors
+          regions: @payload.regions
+          bars: @payload.bars
+          guides: @payload.guides
+          angles: @payload.angles
+          hops: @payload.hops
           shapes: @payload.shapes
+          readouts: @payload.readouts
+          traces: @payload.traces
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -139,7 +236,14 @@ orbital MathCanvasOrbital {
         curves : [MathCanvasCurvesItem]
         points : [MathCanvasPointsItem]
         vectors : [MathCanvasVectorsItem]
+        regions : [MathCanvasRegionsItem]
+        bars : [MathCanvasBarsItem]
+        guides : [MathCanvasGuidesItem]
+        angles : [MathCanvasAnglesItem]
+        hops : [MathCanvasHopsItem]
         shapes : [MathCanvasShapesItem]
+        readouts : [MathCanvasReadoutsItem]
+        traces : [MathCanvasTracesItem]
       }
         @description "Live scene update; payload carries the current drawable state."
         @synonyms "tick, redraw, animate, frame"
@@ -191,6 +295,14 @@ orbital MathCanvasOrbital {
         @label "Grid Step"
         @description "gridStep prop"
         @tier "presentation"
+      showTickLabels : boolean = false
+        @label "Show Tick Labels"
+        @description "Draw numeric labels on grid lines (default false)."
+        @tier "presentation"
+      showCurveLabels : boolean = false
+        @label "Show Curve Labels"
+        @description "Draw each curve's `label` at its last in-range sample (default false)."
+        @tier "presentation"
       curves : [MathCanvasCurvesItem] = []
         @label "Curves"
         @description "curves prop"
@@ -203,10 +315,38 @@ orbital MathCanvasOrbital {
         @label "Vectors"
         @description "vectors prop"
         @tier "presentation"
+      regions : [MathCanvasRegionsItem] = []
+        @label "Regions"
+        @description "Filled areas under curves or between curve pairs."
+        @tier "presentation"
+      bars : [MathCanvasBarsItem] = []
+        @label "Bars"
+        @description "Riemann/histogram bar strips."
+        @tier "presentation"
+      guides : [MathCanvasGuidesItem] = []
+        @label "Guides"
+        @description "Fixed reference lines (vline/hline)."
+        @tier "presentation"
+      angles : [MathCanvasAnglesItem] = []
+        @label "Angles"
+        @description "Angle-sweep arcs at a vertex."
+        @tier "presentation"
+      hops : [MathCanvasHopsItem] = []
+        @label "Hops"
+        @description "Number-line jump arcs."
+        @tier "presentation"
       shapes : [MathCanvasShapesItem] = []
         @label "Shapes"
         @description "Extra declarative shapes in canvas pixel coordinates."
         @tier "presentation"
+      readouts : [MathCanvasReadoutsItem] = []
+        @label "Readouts"
+        @description "Top-right status chips, forwarded verbatim to LearningCanvas."
+        @tier "presentation"
+      traces : [MathCanvasTracesItem] = []
+        @label "Traces"
+        @description "Inset sparkline panels, forwarded verbatim to LearningCanvas."
+        @tier "presentation"
       interactive : boolean = false
         @label "Interactive"
         @description "interactive prop"