@vgai/engine 0.5.2 → 0.5.3

package/schemas/scn2d.schema.json

@@ -1,494 +0,0 @@
-{
-  "$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 shown in the native 2D document hierarchy and inspector",
-      "type": "string"
-    },
-    "surface": {
-      "description": "Render surface. Always 'world2d'",
-      "type": "string",
-      "const": "world2d"
-    },
-    "gravity": {
-      "description": "World gravity [x, y] in px/s^2. Default [0, 9.8 * pixelsPerMeter] ([0, 980] at the default scale)",
-      "type": "array",
-      "prefixItems": [
-        {
-          "type": "number"
-        },
-        {
-          "type": "number"
-        }
-      ]
-    },
-    "pixelsPerMeter": {
-      "description": "Authored pixels per physics meter. Configures native Rapier World.lengthUnit and scales default gravity. Default 100",
-      "type": "number",
-      "exclusiveMinimum": 0
-    },
-    "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 native 2D scene editor",
-          "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",
-              "minLength": 1
-            },
-            "animation": {
-              "description": "Named spritesheet animation from `texture` (PIXI.Spritesheet.animations); mutually exclusive with `frame`",
-              "type": "string",
-              "minLength": 1
-            },
-            "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"
-              ]
-            },
-            "fps": {
-              "description": "AnimatedSprite playback speed in frames/sec. Default 8",
-              "type": "number",
-              "exclusiveMinimum": 0
-            },
-            "loop": {
-              "description": "Whether the named spritesheet animation loops. Default true",
-              "type": "boolean"
-            }
-          },
-          "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": {
-            "frames": {
-              "minItems": 1,
-              "type": "array",
-              "items": {
-                "type": "string",
-                "minLength": 1
-              },
-              "description": "Ordered Pixi spritesheet frame names used as tile indices"
-            },
-            "texture": {
-              "type": "string",
-              "minLength": 1,
-              "description": "URL or project path to a Pixi spritesheet JSON asset"
-            },
-            "tileSize": {
-              "type": "number",
-              "exclusiveMinimum": 0,
-              "description": "Positive square tile width/height in pixels"
-            },
-            "tiles": {
-              "type": "array",
-              "items": {
-                "type": "array",
-                "items": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
-                }
-              },
-              "description": "Row-major grid of frame indices; -1 is an empty cell (each row is an array of tile indices)"
-            }
-          },
-          "required": [
-            "frames",
-            "texture",
-            "tileSize",
-            "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. A body of any type nested below a dynamic or kinematic body is rejected: Rapier has no parent/child body relationship. Nesting below a fixed or physics-less transformed parent is supported for fixed bodies. Dynamic and kinematic bodies additionally require a conformal parent chain (uniform scale plus rotation/reflection), because later body rotation cannot round-trip through non-uniform parent scale without shearing the Pixi visual."
-            },
-            "collider": {
-              "oneOf": [
-                {
-                  "type": "object",
-                  "properties": {
-                    "shape": {
-                      "type": "string",
-                      "const": "cuboid",
-                      "description": "Box collider aligned to the rigid-body rotation"
-                    },
-                    "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. Its pose and dimensions use the composed parent transform at spawn. Cuboids support non-uniform scale; ball/capsule colliders reject non-uniform scale because Rapier cannot represent an ellipse."
-            },
-            "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
-    }
-  }
-}