@vgai/engine 0.3.0 → 0.4.0-canary.20260715.0

package/schemas/scn2d.schema.json

@@ -0,0 +1,475 @@
+{
+  "$comment": "AUTO-GENERATED by scripts/generate-schema.ts — do not edit manually",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "version": {
+      "description": "Scene format version",
+      "type": "number"
+    },
+    "name": {
+      "description": "Scene name. REJECTED at parse (T4.1): declared but has no runtime reader — authoring this field throws. Do not author.",
+      "type": "string"
+    },
+    "surface": {
+      "description": "Render surface. Always 'world2d'",
+      "type": "string",
+      "const": "world2d"
+    },
+    "gravity": {
+      "description": "World gravity [x, y] in px/s^2. Default [0, 980]",
+      "type": "array",
+      "prefixItems": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "number"
+        }
+      ]
+    },
+    "background": {
+      "description": "Background color hex string. Default '#10101a'",
+      "type": "string"
+    },
+    "entities": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema0"
+      },
+      "description": "Root entities of the world2d scene"
+    }
+  },
+  "required": [
+    "entities"
+  ],
+  "additionalProperties": false,
+  "description": "A world2d scene (PixiJS render surface)",
+  "$defs": {
+    "__schema0": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "description": "Unique entity ID. Auto-generated if omitted",
+          "type": "string"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable entity name (shown in hierarchy panel)"
+        },
+        "surface": {
+          "description": "Render surface that instantiates this entity. Default 'world2d' in a Scene2D file. The 'world3d' value is REJECTED at parse (T4.1): declared but has no runtime reader — authoring surface: 'world3d' throws. Do not author it ('world2d', the default, is fine).",
+          "type": "string",
+          "enum": [
+            "world2d",
+            "world3d"
+          ]
+        },
+        "visible": {
+          "description": "Whether the entity and its children are rendered",
+          "type": "boolean"
+        },
+        "locked": {
+          "description": "Prevent selection and editing in the scene editor. REJECTED at parse (T4.1): declared but has no runtime reader — authoring this field throws. Do not author.",
+          "type": "boolean"
+        },
+        "tags": {
+          "description": "Arbitrary string tags for runtime queries. REJECTED at parse (T4.1): declared but has no runtime reader — authoring this field throws. Do not author.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transform2d": {
+          "description": "Local 2D transform relative to parent",
+          "type": "object",
+          "properties": {
+            "position": {
+              "description": "Local position [x, y] in world2d pixels",
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "rotation": {
+              "description": "Rotation in radians about the Z axis. Default 0",
+              "type": "number"
+            },
+            "scale": {
+              "description": "Scale per axis [x, y]. Default [1, 1]",
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "pivot": {
+              "description": "Local pivot point [x, y] (center of rotation/scale)",
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "additionalProperties": false
+        },
+        "pivot": {
+          "description": "Local-space pivot point [x, y]",
+          "type": "array",
+          "prefixItems": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
+        "sprite": {
+          "description": "2D sprite appearance",
+          "type": "object",
+          "properties": {
+            "texture": {
+              "description": "Texture asset URL (loaded via PIXI.Assets). Omit for a tintable 1x1 white texture",
+              "type": "string"
+            },
+            "frame": {
+              "description": "Spritesheet frame/sub-texture name when `texture` is a spritesheet atlas",
+              "type": "string"
+            },
+            "anchor": {
+              "description": "Normalized anchor [x, y] (0..1). Default [0.5, 0.5]",
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "tint": {
+              "description": "Tint color as hex string (e.g. '#ff8800'). Default white",
+              "type": "string"
+            },
+            "alpha": {
+              "description": "Opacity 0..1. Default 1",
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "width": {
+              "description": "Explicit display width in pixels (overrides texture size)",
+              "type": "number"
+            },
+            "height": {
+              "description": "Explicit display height in pixels (overrides texture size)",
+              "type": "number"
+            },
+            "blendMode": {
+              "description": "PixiJS blend mode. Default normal",
+              "type": "string",
+              "enum": [
+                "normal",
+                "add",
+                "multiply",
+                "screen"
+              ]
+            },
+            "interactive": {
+              "description": "Enable federated pointer events (eventMode=static) so this sprite can be picked",
+              "type": "boolean"
+            },
+            "filter": {
+              "description": "Apply a PixiJS filter (BlurFilter / ColorMatrix desaturate). Default none",
+              "type": "string",
+              "enum": [
+                "none",
+                "blur",
+                "desaturate"
+              ]
+            },
+            "animationFrames": {
+              "description": "If set, build an AnimatedSprite cycling N generated tinted frames",
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "fps": {
+              "description": "AnimatedSprite playback speed in frames/sec. Default 8",
+              "type": "number"
+            }
+          },
+          "additionalProperties": false
+        },
+        "text": {
+          "description": "World-space text label",
+          "type": "object",
+          "properties": {
+            "text": {
+              "type": "string",
+              "description": "The string to display"
+            },
+            "fontSize": {
+              "description": "Font size in pixels. Default 24",
+              "type": "number"
+            },
+            "fill": {
+              "description": "Text color as hex string. Default '#ffffff'",
+              "type": "string"
+            },
+            "anchor": {
+              "description": "Normalized anchor [x, y] (0..1). Default [0.5, 0.5]",
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "required": [
+            "text"
+          ],
+          "additionalProperties": false
+        },
+        "tilemap": {
+          "description": "2D tilemap (CompositeTilemap)",
+          "type": "object",
+          "properties": {
+            "tileSize": {
+              "type": "number",
+              "description": "Tile width/height in pixels"
+            },
+            "palette": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Hex colors; one generated tile texture per entry (index → color)"
+            },
+            "tiles": {
+              "type": "array",
+              "items": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                }
+              },
+              "description": "Row-major grid of palette indices (each row is an array of tile indices)"
+            }
+          },
+          "required": [
+            "tileSize",
+            "palette",
+            "tiles"
+          ],
+          "additionalProperties": false
+        },
+        "physics2d": {
+          "description": "2D physics rigid body + collider",
+          "type": "object",
+          "properties": {
+            "bodyType": {
+              "type": "string",
+              "enum": [
+                "dynamic",
+                "fixed",
+                "kinematicVelocity",
+                "kinematicPosition"
+              ],
+              "description": "Rapier 2D rigid-body type"
+            },
+            "collider": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "shape": {
+                      "type": "string",
+                      "const": "cuboid",
+                      "description": "Axis-aligned box collider"
+                    },
+                    "halfExtents": {
+                      "type": "array",
+                      "prefixItems": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "number"
+                        }
+                      ],
+                      "description": "Half-width and half-height [hx, hy] in pixels"
+                    }
+                  },
+                  "required": [
+                    "shape",
+                    "halfExtents"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "shape": {
+                      "type": "string",
+                      "const": "ball",
+                      "description": "Circle collider"
+                    },
+                    "radius": {
+                      "type": "number",
+                      "description": "Radius in pixels"
+                    }
+                  },
+                  "required": [
+                    "shape",
+                    "radius"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "shape": {
+                      "type": "string",
+                      "const": "capsule",
+                      "description": "Capsule collider (vertical)"
+                    },
+                    "halfHeight": {
+                      "type": "number",
+                      "description": "Half the straight segment length"
+                    },
+                    "radius": {
+                      "type": "number",
+                      "description": "Cap radius"
+                    }
+                  },
+                  "required": [
+                    "shape",
+                    "halfHeight",
+                    "radius"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Collider shape attached to the body"
+            },
+            "sensor": {
+              "description": "If true, a sensor (trigger) collider — overlaps fire onTriggerEnter/Exit, no solid response",
+              "type": "boolean"
+            },
+            "density": {
+              "description": "Collider density (drives mass). Default 1",
+              "type": "number"
+            },
+            "friction": {
+              "description": "Coefficient of friction. Default 0.5",
+              "type": "number"
+            },
+            "restitution": {
+              "description": "Bounciness 0..1. Default 0",
+              "type": "number"
+            },
+            "linearDamping": {
+              "description": "Linear velocity damping. Default 0",
+              "type": "number"
+            },
+            "gravityScale": {
+              "description": "Per-body gravity multiplier. Default 1",
+              "type": "number"
+            },
+            "lockRotations": {
+              "description": "Lock the body so it cannot rotate. Default false",
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "bodyType",
+            "collider"
+          ],
+          "additionalProperties": false
+        },
+        "components": {
+          "description": "User-defined components (validated against the world2d component registry)",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "boolean"
+                    }
+                  ]
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  }
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "boolean"
+                  }
+                }
+              ]
+            }
+          }
+        },
+        "children": {
+          "description": "Child entities",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema0"
+          }
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false
+    }
+  }
+}