Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

examples(ui-layout): rebuild as an interactive flexbox playground

yhha45d1200ef63
diff --git a/examples/ui-layout/assets/scenes/main.esscene b/examples/ui-layout/assets/scenes/main.esscene
index 6a5134605..ff7cb1d74 100644
--- a/examples/ui-layout/assets/scenes/main.esscene
+++ b/examples/ui-layout/assets/scenes/main.esscene
@@ -34,31 +34,7 @@
"id": 1,
"name": "Canvas",
"parent": null,
- "children": [
- 2,
- 3,
- 4,
- 5,
- 6,
- 7,
- 8,
- 9,
- 10,
- 11,
- 12,
- 13,
- 14,
- 15,
- 16,
- 17,
- 18,
- 19,
- 20,
- 21,
- 22,
- 23,
- 24
- ],
+ "children": [],
"components": [
{
"type": "Transform",
@@ -80,1281 +56,6 @@
}
],
"visible": true
- },
- {
- "id": 2,
- "name": "Title",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 400.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 50.0,
- "unit": 1
- },
- "marginLeft": {
- "value": -200.0,
- "unit": 0
- },
- "height": {
- "value": 40.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 40.0,
- "unit": 0
- }
- }
- },
- {
- "type": "Text",
- "data": {
- "content": "UIRect Anchor Layout",
- "fontSize": 28,
- "color": {
- "r": 1,
- "g": 1,
- "b": 1,
- "a": 1
- },
- "align": 1,
- "verticalAlign": 1
- }
- }
- ],
- "visible": true
- },
- {
- "id": 3,
- "name": "TopLeftPanel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 180.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 10.0,
- "unit": 0
- },
- "height": {
- "value": 120.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 10.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.325,
- "g": 0.588,
- "b": 0.775,
- "a": 0.88
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 4,
- "name": "TopLeftLabel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 180.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 10.0,
- "unit": 0
- },
- "height": {
- "value": 120.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 10.0,
- "unit": 0
- }
- }
- },
- {
- "type": "Text",
- "data": {
- "content": "Top-Left",
- "fontSize": 16,
- "color": {
- "r": 1,
- "g": 1,
- "b": 1,
- "a": 1
- },
- "align": 1,
- "verticalAlign": 1
- }
- }
- ],
- "visible": true
- },
- {
- "id": 5,
- "name": "TopRightPanel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 180.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 100.0,
- "unit": 1
- },
- "marginLeft": {
- "value": -190.0,
- "unit": 0
- },
- "height": {
- "value": 120.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 10.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.26,
- "g": 0.74,
- "b": 0.564,
- "a": 0.88
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 6,
- "name": "TopRightLabel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 180.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 100.0,
- "unit": 1
- },
- "marginLeft": {
- "value": -190.0,
- "unit": 0
- },
- "height": {
- "value": 120.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 10.0,
- "unit": 0
- }
- }
- },
- {
- "type": "Text",
- "data": {
- "content": "Top-Right",
- "fontSize": 16,
- "color": {
- "r": 1,
- "g": 1,
- "b": 1,
- "a": 1
- },
- "align": 1,
- "verticalAlign": 1
- }
- }
- ],
- "visible": true
- },
- {
- "id": 7,
- "name": "BottomStretchPanel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "insetRight": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 10.0,
- "unit": 0
- },
- "height": {
- "value": 80.0,
- "unit": 0
- },
- "insetTop": {
- "value": 100.0,
- "unit": 1
- },
- "marginTop": {
- "value": -90.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.8,
- "g": 0.4,
- "b": 0.6,
- "a": 0.88
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 8,
- "name": "BottomStretchLabel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "insetRight": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 10.0,
- "unit": 0
- },
- "height": {
- "value": 80.0,
- "unit": 0
- },
- "insetTop": {
- "value": 100.0,
- "unit": 1
- },
- "marginTop": {
- "value": -90.0,
- "unit": 0
- }
- }
- },
- {
- "type": "Text",
- "data": {
- "content": "Bottom Stretch",
- "fontSize": 16,
- "color": {
- "r": 1,
- "g": 1,
- "b": 1,
- "a": 1
- },
- "align": 1,
- "verticalAlign": 1
- }
- }
- ],
- "visible": true
- },
- {
- "id": 9,
- "name": "CenterPanel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 200.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 50.0,
- "unit": 1
- },
- "marginLeft": {
- "value": -100.0,
- "unit": 0
- },
- "height": {
- "value": 150.0,
- "unit": 0
- },
- "insetTop": {
- "value": 50.0,
- "unit": 1
- },
- "marginTop": {
- "value": -75.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.25,
- "g": 0.56,
- "b": 0.96,
- "a": 0.92
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 10,
- "name": "CenterLabel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 200.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 50.0,
- "unit": 1
- },
- "marginLeft": {
- "value": -100.0,
- "unit": 0
- },
- "height": {
- "value": 150.0,
- "unit": 0
- },
- "insetTop": {
- "value": 50.0,
- "unit": 1
- },
- "marginTop": {
- "value": -75.0,
- "unit": 0
- }
- }
- },
- {
- "type": "Text",
- "data": {
- "content": "Center",
- "fontSize": 16,
- "color": {
- "r": 1,
- "g": 1,
- "b": 1,
- "a": 1
- },
- "align": 1,
- "verticalAlign": 1
- }
- }
- ],
- "visible": true
- },
- {
- "id": 11,
- "name": "LeftStretchPanel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 120.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 200.0,
- "unit": 0
- },
- "insetBottom": {
- "value": 15.0,
- "unit": 1
- },
- "insetTop": {
- "value": 15.0,
- "unit": 1
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.609,
- "g": 0.449,
- "b": 0.791,
- "a": 0.88
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 12,
- "name": "LeftStretchLabel",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 120.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 200.0,
- "unit": 0
- },
- "insetBottom": {
- "value": 15.0,
- "unit": 1
- },
- "insetTop": {
- "value": 15.0,
- "unit": 1
- }
- }
- },
- {
- "type": "Text",
- "data": {
- "content": "Left Stretch",
- "fontSize": 16,
- "color": {
- "r": 1,
- "g": 1,
- "b": 1,
- "a": 1
- },
- "align": 1,
- "verticalAlign": 1
- }
- }
- ],
- "visible": true
- },
- {
- "id": 13,
- "name": "GridItem0",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 430.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 195.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.4,
- "g": 0.613,
- "b": 0.8,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 14,
- "name": "GridItem1",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 493.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 195.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.4,
- "g": 0.413,
- "b": 0.8,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 15,
- "name": "GridItem2",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 556.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 195.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.587,
- "g": 0.4,
- "b": 0.8,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 16,
- "name": "GridItem3",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 619.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 195.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.787,
- "g": 0.4,
- "b": 0.8,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 17,
- "name": "GridItem4",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 430.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 258.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.8,
- "g": 0.4,
- "b": 0.613,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 18,
- "name": "GridItem5",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 493.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 258.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.8,
- "g": 0.4,
- "b": 0.413,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 19,
- "name": "GridItem6",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 556.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 258.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.8,
- "g": 0.587,
- "b": 0.4,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 20,
- "name": "GridItem7",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 619.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 258.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.8,
- "g": 0.787,
- "b": 0.4,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 21,
- "name": "GridItem8",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 430.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 321.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.613,
- "g": 0.8,
- "b": 0.4,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 22,
- "name": "GridItem9",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 493.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 321.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.413,
- "g": 0.8,
- "b": 0.4,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 23,
- "name": "GridItem10",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 556.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 321.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.4,
- "g": 0.8,
- "b": 0.587,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
- },
- {
- "id": 24,
- "name": "GridItem11",
- "parent": 1,
- "children": [],
- "components": [
- {
- "type": "Transform",
- "data": {}
- },
- {
- "type": "UINode",
- "data": {
- "position": 1,
- "width": {
- "value": 55.0,
- "unit": 0
- },
- "insetLeft": {
- "value": 0.0,
- "unit": 1
- },
- "marginLeft": {
- "value": 619.0,
- "unit": 0
- },
- "height": {
- "value": 55.0,
- "unit": 0
- },
- "insetTop": {
- "value": 0.0,
- "unit": 1
- },
- "marginTop": {
- "value": 321.0,
- "unit": 0
- }
- }
- },
- {
- "type": "UIVisual",
- "data": {
- "visualType": 1,
- "color": {
- "r": 0.4,
- "g": 0.8,
- "b": 0.787,
- "a": 0.9
- }
- }
- }
- ],
- "visible": true
}
]
}
diff --git a/examples/ui-layout/src/config.ts b/examples/ui-layout/src/config.ts
new file mode 100644
index 000000000..831191675
--- /dev/null
+++ b/examples/ui-layout/src/config.ts
@@ -0,0 +1,70 @@
+import {
+ FlexDirection, JustifyContent, AlignItems, FlexWrap,
+} from 'esengine';
+import type { Color } from 'esengine';
+
+// Canvas + geometry (design resolution 800×600).
+export const CANVAS_W = 800;
+export const CTRL_W = 142;
+export const CTRL_H = 34;
+export const CTRL_GAP = 10;
+
+export const DEMO_W = 660;
+export const DEMO_H = 392;
+export const DEMO_TOP = 108;
+export const DEMO_PAD = 16;
+export const DEMO_GAP = 12;
+
+export const ITEM_W = 74;
+// Varied heights so align-items (the cross axis in row flow) is visible.
+export const ITEM_HEIGHTS = [58, 92, 66, 104, 74, 60, 96, 52];
+
+// Each control is one option list; the button shows the short label, the
+// readout line spells out the CSS-equivalent value.
+export interface Opt { short: string; css: string; value: number; }
+
+export const DIRECTIONS: Opt[] = [
+ { short: 'Row', css: 'row', value: FlexDirection.Row },
+ { short: 'Column', css: 'column', value: FlexDirection.Column },
+ { short: 'Row-rev', css: 'row-reverse', value: FlexDirection.RowReverse },
+ { short: 'Col-rev', css: 'column-reverse', value: FlexDirection.ColumnReverse },
+];
+
+export const JUSTIFY: Opt[] = [
+ { short: 'Start', css: 'flex-start', value: JustifyContent.Start },
+ { short: 'Center', css: 'center', value: JustifyContent.Center },
+ { short: 'End', css: 'flex-end', value: JustifyContent.End },
+ { short: 'Between', css: 'space-between', value: JustifyContent.SpaceBetween },
+ { short: 'Around', css: 'space-around', value: JustifyContent.SpaceAround },
+ { short: 'Evenly', css: 'space-evenly', value: JustifyContent.SpaceEvenly },
+];
+
+export const ALIGN: Opt[] = [
+ { short: 'Start', css: 'flex-start', value: AlignItems.Start },
+ { short: 'Center', css: 'center', value: AlignItems.Center },
+ { short: 'End', css: 'flex-end', value: AlignItems.End },
+ { short: 'Stretch', css: 'stretch', value: AlignItems.Stretch },
+];
+
+export const WRAP: Opt[] = [
+ { short: 'No-wrap', css: 'nowrap', value: FlexWrap.NoWrap },
+ { short: 'Wrap', css: 'wrap', value: FlexWrap.Wrap },
+];
+
+export const COUNTS = [4, 5, 6, 8];
+
+// Item fill: a smooth hue wheel (same family as the other UI examples).
+export function itemColor(i: number): Color {
+ const h = (208 + i * 42) % 360 / 360;
+ const s = 0.5, l = 0.6;
+ const q = l + s - l * s, p = 2 * l - q;
+ const f = (t: number): number => {
+ t = (t % 1 + 1) % 1;
+ if (t < 1 / 6) return p + (q - p) * 6 * t;
+ if (t < 1 / 2) return q;
+ if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
+ return p;
+ };
+ const r = (v: number): number => +v.toFixed(3);
+ return { r: r(f(h + 1 / 3)), g: r(f(h)), b: r(f(h - 1 / 3)), a: 1 };
+}
diff --git a/examples/ui-layout/src/main.ts b/examples/ui-layout/src/main.ts
index 1d46f09fa..0a4d70a83 100644
--- a/examples/ui-layout/src/main.ts
+++ b/examples/ui-layout/src/main.ts
@@ -1 +1,17 @@
-// UI Layout - all entities defined in scene
+// UI Layout — a live flexbox playground. The scene carries only a Camera +
+// Canvas; a startup system builds a real FlexContainer full of item boxes plus
+// a row of cycle-buttons that drive its properties:
+//
+// • Dir — flex-direction (row / column / *-reverse)
+// • Justify — justify-content (start / center / end / space-*)
+// • Align — align-items (start / center / end / stretch)
+// • Wrap — flex-wrap (nowrap / wrap)
+// • Items — how many boxes to lay out
+//
+// Click a button and the Yoga layout pass re-flows the boxes next frame. Built
+// imperatively from the widget factories + design tokens, matching ui-controls.
+import { addStartupSystem } from 'esengine';
+
+import { buildSystem } from './systems/build';
+
+addStartupSystem(buildSystem);
diff --git a/examples/ui-layout/src/state.ts b/examples/ui-layout/src/state.ts
new file mode 100644
index 000000000..acd1b045d
--- /dev/null
+++ b/examples/ui-layout/src/state.ts
@@ -0,0 +1,17 @@
+import type { Entity } from 'esengine';
+
+// The live playground state: the demo FlexContainer, its item boxes, the
+// readout label, and the current option index for each control. The control
+// buttons advance an index and re-apply; the Yoga layout pass re-flows the
+// items next frame.
+export const state = {
+ container: 0 as Entity,
+ readout: 0 as Entity,
+ items: [] as Entity[],
+
+ dir: 0, // DIRECTIONS index — Row
+ just: 0, // JUSTIFY index — flex-start
+ align: 0, // ALIGN index — flex-start
+ wrap: 0, // WRAP index — nowrap
+ count: 1, // COUNTS index — 5 items
+};
diff --git a/examples/ui-layout/src/systems/build.ts b/examples/ui-layout/src/systems/build.ts
new file mode 100644
index 000000000..59d2525c2
--- /dev/null
+++ b/examples/ui-layout/src/systems/build.ts
@@ -0,0 +1,164 @@
+import {
+ defineSystem, Query, Res, GetWorld,
+ Canvas, UIEvents,
+ Text, UIVisual, FlexContainer,
+ spawnUIEntity, createButton,
+ themeColors, px,
+ UIPositionType, FlexDirection, FlexWrap, JustifyContent, AlignItems, AlignContent,
+ TextAlign, TextVerticalAlign,
+} from 'esengine';
+import type { Entity, World, Color, ThemeColors, UIEventQueue, TextData } from 'esengine';
+
+import {
+ CTRL_W, CTRL_H, CTRL_GAP, DEMO_W, DEMO_H, DEMO_TOP, DEMO_PAD, DEMO_GAP,
+ ITEM_W, ITEM_HEIGHTS, DIRECTIONS, JUSTIFY, ALIGN, WRAP, COUNTS, itemColor,
+ type Opt,
+} from '../config';
+import { state } from '../state';
+
+// A live flexbox playground: control buttons cycle a real FlexContainer's
+// flex-direction / justify-content / align-items / flex-wrap / item-count, and
+// the Yoga layout pass re-flows the item boxes next frame. Built imperatively
+// from the widget factories + design tokens — the same modern path as
+// ui-controls.
+export const buildSystem = defineSystem(
+ [Query(Canvas), Res(UIEvents), GetWorld()],
+ (canvases: Iterable<[Entity, unknown]>, events: UIEventQueue, world: World) => {
+ if (state.container) return; // startup runs once
+
+ let canvas: Entity | null = null;
+ for (const [entity] of canvases) { canvas = entity; break; }
+ if (canvas === null) return;
+
+ const c = themeColors();
+
+ const fullWidthAt = (top: number, height: number, text: TextInit): Entity =>
+ spawnUIEntity({
+ world, parent: canvas!,
+ node: { position: UIPositionType.Absolute, insetLeft: px(0), insetRight: px(0),
+ insetTop: px(top), height: px(height) },
+ text,
+ });
+
+ fullWidthAt(18, 28, { content: 'Flexbox Layout — live', fontSize: 20, bold: true, color: c.onPrimary });
+
+ // Control bar: a flex row of cycle-buttons, centred across the canvas.
+ const bar = spawnUIEntity({
+ world, parent: canvas,
+ node: { position: UIPositionType.Absolute, insetLeft: px(0), insetRight: px(0),
+ insetTop: px(56), height: px(CTRL_H) },
+ });
+ world.insert(bar, FlexContainer, {
+ direction: FlexDirection.Row, wrap: 0,
+ justifyContent: JustifyContent.Center, alignItems: AlignItems.Center, alignContent: 0,
+ gap: { x: CTRL_GAP, y: 0 }, padding: { left: 0, top: 0, right: 0, bottom: 0 },
+ });
+
+ // The demo container whose FlexContainer the controls drive.
+ state.container = spawnUIEntity({
+ world, parent: canvas,
+ node: {
+ position: UIPositionType.Absolute,
+ width: px(DEMO_W), height: px(DEMO_H),
+ insetLeft: px((800 - DEMO_W) / 2), insetTop: px(DEMO_TOP),
+ },
+ visual: { color: c.surfaceElevated },
+ });
+
+ state.readout = spawnUIEntity({
+ world, parent: canvas,
+ node: { position: UIPositionType.Absolute, insetLeft: px(0), insetRight: px(0),
+ insetTop: px(DEMO_TOP + DEMO_H + 12), height: px(22) },
+ text: { content: '', fontSize: 13, color: { r: 0.55, g: 0.55, b: 0.58, a: 1 } },
+ });
+
+ // ── inner helpers (close over world / c / events / state) ─────────────
+
+ function spawnItem(i: number): Entity {
+ const box = spawnUIEntity({
+ world, parent: state.container,
+ node: { width: px(ITEM_W), height: px(ITEM_HEIGHTS[i % ITEM_HEIGHTS.length]!), flexShrink: 0 },
+ visual: { color: itemColor(i) },
+ });
+ spawnUIEntity({
+ world, parent: box, node: { fill: true },
+ text: { content: String(i + 1), fontSize: 18, bold: true, color: { r: 1, g: 1, b: 1, a: 1 } },
+ });
+ return box;
+ }
+
+ function ensureItems(n: number): void {
+ while (state.items.length > n) {
+ const e = state.items.pop();
+ if (e !== undefined && world.valid(e)) world.despawn(e);
+ }
+ while (state.items.length < n) state.items.push(spawnItem(state.items.length));
+ }
+
+ function apply(): void {
+ ensureItems(COUNTS[state.count]!);
+ world.insert(state.container, FlexContainer, {
+ direction: DIRECTIONS[state.dir]!.value as FlexDirection,
+ wrap: WRAP[state.wrap]!.value as FlexWrap,
+ justifyContent: JUSTIFY[state.just]!.value as JustifyContent,
+ alignItems: ALIGN[state.align]!.value as AlignItems,
+ alignContent: AlignContent.Start,
+ gap: { x: DEMO_GAP, y: DEMO_GAP },
+ padding: { left: DEMO_PAD, top: DEMO_PAD, right: DEMO_PAD, bottom: DEMO_PAD },
+ });
+ setText(world, state.readout,
+ 'flex-direction: ' + DIRECTIONS[state.dir]!.css +
+ ' · justify-content: ' + JUSTIFY[state.just]!.css +
+ ' · align-items: ' + ALIGN[state.align]!.css +
+ ' · flex-wrap: ' + WRAP[state.wrap]!.css);
+ }
+
+ function makeControl(caption: string, opts: Opt[], get: () => number, set: (v: number) => void): void {
+ let label: Entity = 0 as Entity;
+ const refresh = (): void => setText(world, label, caption + ': ' + opts[get()]!.short);
+ const btn = createButton({
+ world, events, parent: bar,
+ node: { width: px(CTRL_W), height: px(CTRL_H) },
+ states: controlStates(c),
+ onClick: () => { set((get() + 1) % opts.length); refresh(); apply(); },
+ });
+ label = spawnUIEntity({
+ world, parent: btn, node: { fill: true },
+ text: { content: '', fontSize: 13, color: c.onPrimary,
+ align: TextAlign.Center, verticalAlign: TextVerticalAlign.Middle },
+ });
+ refresh();
+ }
+
+ const countOpts: Opt[] = COUNTS.map((n) => ({ short: String(n), css: String(n), value: n }));
+
+ makeControl('Dir', DIRECTIONS, () => state.dir, (v) => { state.dir = v; });
+ makeControl('Justify', JUSTIFY, () => state.just, (v) => { state.just = v; });
+ makeControl('Align', ALIGN, () => state.align, (v) => { state.align = v; });
+ makeControl('Wrap', WRAP, () => state.wrap, (v) => { state.wrap = v; });
+ makeControl('Items', countOpts, () => state.count, (v) => { state.count = v; });
+
+ apply();
+ },
+ { name: 'BuildSystem' },
+);
+
+// ── shared helpers ─────────────────────────────────────────────────────────
+
+interface TextInit {
+ content: string;
+ fontSize?: number;
+ bold?: boolean;
+ color?: Color;
+}
+
+function controlStates(c: ThemeColors): Record<string, { color: Color }> {
+ return { normal: { color: c.control }, hover: { color: c.controlHover }, pressed: { color: c.controlActive } };
+}
+
+function setText(world: World, entity: Entity, content: string): void {
+ if (!world.valid(entity) || !world.has(entity, Text)) return;
+ const t = world.get(entity, Text) as TextData;
+ t.content = content;
+ world.insert(entity, Text, t);
+}