@almadar/std 16.239.0 → 16.242.0

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

@@ -69,6 +69,13 @@ orbital AlgorithmCanvasOrbital {
     color : string
   }
   type AlgorithmCanvasShapesItem = {
+    tone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    fillTone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    stroke : "thin" | "normal" | "bold"
+    textSize : "xs" | "sm" | "base" | "lg" | "xl" | "2xl"
+    font : "body" | "display" | "mono"
+    textCase : "theme" | "verbatim"
+    fillStyle : "solid" | "tint" | "outline" | "hatch"
     type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
@@ -132,6 +139,9 @@ orbital AlgorithmCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @config.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           bars: @config.bars
           cells: @config.cells
           pointers: @config.pointers
@@ -175,6 +185,9 @@ orbital AlgorithmCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @payload.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           bars: @payload.bars
           cells: @payload.cells
           pointers: @payload.pointers
@@ -223,6 +236,7 @@ orbital AlgorithmCanvasOrbital {
 
     listens {
       UPDATE {
+        series : [string]
         bars : [AlgorithmCanvasBarsItem]
         cells : [AlgorithmCanvasCellsItem]
         pointers : [AlgorithmCanvasPointersItem]
@@ -261,6 +275,18 @@ orbital AlgorithmCanvasOrbital {
         @label "Background Color"
         @description "backgroundColor prop"
         @tier "presentation"
+      series : [string] = []
+        @label "Series"
+        @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply."
+        @tier "presentation"
+      keyMap : Map string string = { item: "INIT" }
+        @label "Key Map"
+        @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route."
+        @tier "presentation"
+      keyUpMap : Map string string = { item: "INIT" }
+        @label "Key Up Map"
+        @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`."
+        @tier "presentation"
       bars : [AlgorithmCanvasBarsItem] = []
         @label "Bars"
         @description "Sorting/histogram bars; laid out left-to-right, height proportional to value."

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

@@ -144,6 +144,13 @@ orbital BiologyCanvasOrbital {
     label : string
   }
   type BiologyCanvasShapesItem = {
+    tone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    fillTone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    stroke : "thin" | "normal" | "bold"
+    textSize : "xs" | "sm" | "base" | "lg" | "xl" | "2xl"
+    font : "body" | "display" | "mono"
+    textCase : "theme" | "verbatim"
+    fillStyle : "solid" | "tint" | "outline" | "hatch"
     type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
@@ -233,6 +240,9 @@ orbital BiologyCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @config.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           mode: @config.mode
           camera: @config.camera
           lighting: @config.lighting
@@ -281,6 +291,9 @@ orbital BiologyCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @payload.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           mode: @config.mode
           camera: @config.camera
           lighting: @config.lighting
@@ -334,6 +347,7 @@ orbital BiologyCanvasOrbital {
 
     listens {
       UPDATE {
+        series : [string]
         nodes : [BiologyCanvasNodesItem]
         edges : [BiologyCanvasEdgesItem]
         compartments : [BiologyCanvasCompartmentsItem]
@@ -369,6 +383,18 @@ orbital BiologyCanvasOrbital {
         @label "Background Color"
         @description "backgroundColor prop"
         @tier "presentation"
+      series : [string] = []
+        @label "Series"
+        @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply."
+        @tier "presentation"
+      keyMap : Map string string = { item: "INIT" }
+        @label "Key Map"
+        @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route."
+        @tier "presentation"
+      keyUpMap : Map string string = { item: "INIT" }
+        @label "Key Up Map"
+        @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`."
+        @tier "presentation"
       mode : "2d" | "3d" = "2d"
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."

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

@@ -141,6 +141,13 @@ orbital ChemistryCanvasOrbital {
     color : string
   }
   type ChemistryCanvasShapesItem = {
+    tone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    fillTone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    stroke : "thin" | "normal" | "bold"
+    textSize : "xs" | "sm" | "base" | "lg" | "xl" | "2xl"
+    font : "body" | "display" | "mono"
+    textCase : "theme" | "verbatim"
+    fillStyle : "solid" | "tint" | "outline" | "hatch"
     type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
@@ -230,6 +237,9 @@ orbital ChemistryCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @config.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           mode: @config.mode
           camera: @config.camera
           lighting: @config.lighting
@@ -278,6 +288,9 @@ orbital ChemistryCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @payload.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           mode: @config.mode
           camera: @config.camera
           lighting: @config.lighting
@@ -331,6 +344,7 @@ orbital ChemistryCanvasOrbital {
 
     listens {
       UPDATE {
+        series : [string]
         atoms : [ChemistryCanvasAtomsItem]
         bonds : [ChemistryCanvasBondsItem]
         arrows : [ChemistryCanvasArrowsItem]
@@ -365,6 +379,18 @@ orbital ChemistryCanvasOrbital {
         @label "Background Color"
         @description "backgroundColor prop"
         @tier "presentation"
+      series : [string] = []
+        @label "Series"
+        @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply."
+        @tier "presentation"
+      keyMap : Map string string = { item: "INIT" }
+        @label "Key Map"
+        @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route."
+        @tier "presentation"
+      keyUpMap : Map string string = { item: "INIT" }
+        @label "Key Up Map"
+        @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`."
+        @tier "presentation"
       mode : "2d" | "3d" = "2d"
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
@@ -409,7 +435,7 @@ orbital ChemistryCanvasOrbital {
         @tier "presentation"
       equationColor : string
         @label "Equation Color"
-        @description "Equation text color (default '#111827')."
+        @description "Equation text color: a tone name, token or literal (default the `ink` tone)."
         @tier "presentation"
       lattice3d : ChemistryCanvasLattice3d
         @label "Lattice3d"

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

@@ -3,6 +3,13 @@ app ui-learning-canvas "1.0.0"
 ;; @pattern "learning-canvas"
 orbital LearningCanvasOrbital {
   type LearningCanvasShapesItem = {
+    tone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    fillTone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    stroke : "thin" | "normal" | "bold"
+    textSize : "xs" | "sm" | "base" | "lg" | "xl" | "2xl"
+    font : "body" | "display" | "mono"
+    textCase : "theme" | "verbatim"
+    fillStyle : "solid" | "tint" | "outline" | "hatch"
     type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
@@ -103,12 +110,15 @@ orbital LearningCanvasOrbital {
           width: @config.width
           height: @config.height
           backgroundColor: @config.backgroundColor
+          series: @config.series
           fontFamily: @config.fontFamily
           shapes: @config.shapes
           drawables: @config.drawables
           projector: @config.projector
           readouts: @config.readouts
           traces: @config.traces
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -141,12 +151,15 @@ orbital LearningCanvasOrbital {
           width: @config.width
           height: @config.height
           backgroundColor: @config.backgroundColor
+          series: @payload.series
           fontFamily: @config.fontFamily
           shapes: @payload.shapes
           drawables: @payload.drawables
           projector: @config.projector
           readouts: @payload.readouts
           traces: @payload.traces
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -190,6 +203,7 @@ orbital LearningCanvasOrbital {
 
     listens {
       UPDATE {
+        series : [string]
         shapes : [LearningCanvasShapesItem]
         drawables : [node]
         readouts : [LearningCanvasReadoutsItem]
@@ -215,7 +229,11 @@ orbital LearningCanvasOrbital {
         @tier "presentation"
       backgroundColor : string
         @label "Background Color"
-        @description "Background color (default transparent)."
+        @description "Canvas ground: a tone name, `var()` token or literal (default the theme's `--surface-diagram`)."
+        @tier "presentation"
+      series : [string] = []
+        @label "Series"
+        @description "Overrides the theme's categorical palette for this canvas: `series-1…N` resolve to these colors instead. For real-world conventions (CPK atom colors, resistor bands); unset, the theme's `--color-series-*` apply."
         @tier "presentation"
       fontFamily : string
         @label "Font Family"
@@ -243,6 +261,14 @@ orbital LearningCanvasOrbital {
         @description "Inset sparkline panels stacked from the bottom-right corner."
         @synonyms "sparkline, time series, history plot"
         @tier "presentation"
+      keyMap : Map string string = { item: "INIT" }
+        @label "Key Map"
+        @description "Maps a keydown `e.code` — optionally prefixed `Mod+` (⌘/Ctrl), `Shift+`, `Alt+` — to a SEMANTIC event emitted as `UI:{event}` (e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`); keystrokes inside inputs never route."
+        @tier "presentation"
+      keyUpMap : Map string string = { item: "INIT" }
+        @label "Key Up Map"
+        @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`."
+        @tier "presentation"
       interactive : boolean = false
         @label "Interactive"
         @description "Enable pointer interaction (click/hover)."

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

@@ -75,6 +75,13 @@ orbital MathCanvasOrbital {
     label : string
   }
   type MathCanvasShapesItem = {
+    tone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    fillTone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    stroke : "thin" | "normal" | "bold"
+    textSize : "xs" | "sm" | "base" | "lg" | "xl" | "2xl"
+    font : "body" | "display" | "mono"
+    textCase : "theme" | "verbatim"
+    fillStyle : "solid" | "tint" | "outline" | "hatch"
     type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
@@ -171,8 +178,10 @@ orbital MathCanvasOrbital {
           showGrid: @config.showGrid
           gridStep: @config.gridStep
           backgroundColor: @config.backgroundColor
+          series: @config.series
           gridColor: @config.gridColor
           axisColor: @config.axisColor
+          aspect: @config.aspect
           showTickLabels: @config.showTickLabels
           tickLabelFontSize: @config.tickLabelFontSize
           labelFontSize: @config.labelFontSize
@@ -230,8 +239,10 @@ orbital MathCanvasOrbital {
           showGrid: @config.showGrid
           gridStep: @config.gridStep
           backgroundColor: @config.backgroundColor
+          series: @payload.series
           gridColor: @config.gridColor
           axisColor: @config.axisColor
+          aspect: @config.aspect
           showTickLabels: @config.showTickLabels
           tickLabelFontSize: @config.tickLabelFontSize
           labelFontSize: @config.labelFontSize
@@ -287,6 +298,7 @@ orbital MathCanvasOrbital {
 
     listens {
       UPDATE {
+        series : [string]
         curves : [MathCanvasCurvesItem]
         points : [MathCanvasPointsItem]
         vectors : [MathCanvasVectorsItem]
@@ -352,27 +364,35 @@ orbital MathCanvasOrbital {
         @tier "presentation"
       backgroundColor : string
         @label "Background Color"
-        @description "Canvas fill color; `var(--token, fallback)` strings resolve against the active theme. Default transparent."
+        @description "Canvas ground: a tone name, `var()` token or literal. Default the theme's `--surface-diagram`."
         @tier "presentation"
-      gridColor : string = "var(--color-border, #9ca3af)"
+      series : [string] = []
+        @label "Series"
+        @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply."
+        @tier "presentation"
+      gridColor : string = grid
         @label "Grid Color"
-        @description "Grid line color; resolves theme tokens (default `var(--color-border, #9ca3af)`)."
+        @description "Grid line color: a tone name, token or literal (default the `grid` tone)."
         @tier "presentation"
-      axisColor : string = "var(--color-muted-foreground, #374151)"
+      axisColor : string = axis
         @label "Axis Color"
-        @description "Axis line color; resolves theme tokens (default `var(--color-muted-foreground, #374151)`)."
+        @description "Axis line color: a tone name, token or literal (default the `axis` tone)."
+        @tier "presentation"
+      aspect : "fit" | "equal" = fit
+        @label "Aspect"
+        @description "How the x and y ranges map to the canvas. `fit` stretches each range to fill the plot (function plots); `equal` uses one scale for both axes so circles stay round (geometry). Default `fit`."
         @tier "presentation"
       showTickLabels : boolean = false
         @label "Show Tick Labels"
         @description "Draw numeric labels on grid lines (default false)."
         @tier "presentation"
-      tickLabelFontSize : number = 10
+      tickLabelFontSize : number
         @label "Tick Label Font Size"
-        @description "Font size in px for axis tick labels (default 10)."
+        @description "Font size in px for axis tick labels (default the theme's `xs` step)."
         @tier "presentation"
-      labelFontSize : number = 12
+      labelFontSize : number
         @label "Label Font Size"
-        @description "Base font size in px for all other canvas annotations (points, vectors, guides, curves, regions, angles, hops; default 12)."
+        @description "Font size in px for all other canvas annotations (default the theme's diagram label size)."
         @tier "presentation"
       fontFamily : string
         @label "Font Family"

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

@@ -178,6 +178,13 @@ orbital PhysicsCanvasOrbital {
     color : string
   }
   type PhysicsCanvasShapesItem = {
+    tone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    fillTone : "ink" | "label" | "guide" | "axis" | "grid" | "highlight" | "fill" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | "series-6" | "series-7" | "series-8" | "primary" | "accent" | "success" | "warning" | "error" | "info" | "muted"
+    stroke : "thin" | "normal" | "bold"
+    textSize : "xs" | "sm" | "base" | "lg" | "xl" | "2xl"
+    font : "body" | "display" | "mono"
+    textCase : "theme" | "verbatim"
+    fillStyle : "solid" | "tint" | "outline" | "hatch"
     type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
@@ -267,6 +274,9 @@ orbital PhysicsCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @config.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           mode: @config.mode
           camera: @config.camera
           lighting: @config.lighting
@@ -322,6 +332,9 @@ orbital PhysicsCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          series: @payload.series
+          keyMap: @config.keyMap
+          keyUpMap: @config.keyUpMap
           mode: @config.mode
           camera: @config.camera
           lighting: @config.lighting
@@ -382,6 +395,7 @@ orbital PhysicsCanvasOrbital {
 
     listens {
       UPDATE {
+        series : [string]
         bodies : [PhysicsCanvasBodiesItem]
         constraints : [PhysicsCanvasConstraintsItem]
         sceneObjects : [PhysicsCanvasSceneObjectsItem]
@@ -420,6 +434,18 @@ orbital PhysicsCanvasOrbital {
         @label "Background Color"
         @description "backgroundColor prop"
         @tier "presentation"
+      series : [string] = []
+        @label "Series"
+        @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply."
+        @tier "presentation"
+      keyMap : Map string string = { item: "INIT" }
+        @label "Key Map"
+        @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route."
+        @tier "presentation"
+      keyUpMap : Map string string = { item: "INIT" }
+        @label "Key Up Map"
+        @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`."
+        @tier "presentation"
       mode : "2d" | "3d" = "2d"
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."