@vgai/engine 0.3.0 → 0.4.0-canary.20260715.0

package/schemas/mat.schema.json

@@ -0,0 +1,286 @@
+{
+  "$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": {
+      "type": "number",
+      "description": "File format version"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable material name"
+    },
+    "material": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "standard",
+            "physical",
+            "basic",
+            "toon",
+            "custom"
+          ],
+          "description": "Material shading model. \"custom\" resolves `def` against the material registry"
+        },
+        "def": {
+          "description": "Registered custom-material name (required when type is \"custom\")",
+          "type": "string"
+        },
+        "uniforms": {
+          "description": "Authored uniform values for a custom material, keyed by uniform name",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              },
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "array",
+                "items": {
+                  "type": "number"
+                }
+              }
+            ]
+          }
+        },
+        "color": {
+          "description": "Base color as CSS hex string (e.g. \"#ff0000\")",
+          "type": "string"
+        },
+        "metalness": {
+          "description": "Metalness factor 0–1 (standard/physical only)",
+          "type": "number"
+        },
+        "roughness": {
+          "description": "Roughness factor 0–1 (standard/physical only)",
+          "type": "number"
+        },
+        "map": {
+          "description": "Path to albedo/diffuse texture image",
+          "type": "string"
+        },
+        "normalMap": {
+          "description": "Path to normal map texture image",
+          "type": "string"
+        },
+        "emissive": {
+          "description": "Emissive color as CSS hex string",
+          "type": "string"
+        },
+        "emissiveIntensity": {
+          "description": "Emissive light intensity multiplier",
+          "type": "number"
+        },
+        "emissiveMap": {
+          "description": "Path to emissive map texture image",
+          "type": "string"
+        },
+        "aoMap": {
+          "description": "Path to ambient occlusion map texture image",
+          "type": "string"
+        },
+        "lightMap": {
+          "description": "Path to a baked lightmap texture (uses the mesh's second UV set). Applies the pre-baked GI/shadow result on top of the material.",
+          "type": "string"
+        },
+        "lightMapIntensity": {
+          "description": "Lightmap intensity multiplier (default 1).",
+          "type": "number"
+        },
+        "roughnessMap": {
+          "description": "Path to roughness map texture image",
+          "type": "string"
+        },
+        "metalnessMap": {
+          "description": "Path to metalness map texture image",
+          "type": "string"
+        },
+        "opacity": {
+          "description": "Opacity 0–1. Set transparent: true to enable",
+          "type": "number"
+        },
+        "transparent": {
+          "description": "Enable alpha blending for this material",
+          "type": "boolean"
+        },
+        "side": {
+          "description": "Which face sides to render",
+          "type": "string",
+          "enum": [
+            "front",
+            "back",
+            "double"
+          ]
+        },
+        "flatShading": {
+          "description": "Use flat (faceted) shading instead of smooth",
+          "type": "boolean"
+        },
+        "clearcoat": {
+          "description": "Clearcoat layer (physical only)",
+          "type": "object",
+          "properties": {
+            "clearcoat": {
+              "type": "number",
+              "description": "Clearcoat layer intensity 0–1"
+            },
+            "clearcoatRoughness": {
+              "description": "Clearcoat roughness 0–1",
+              "type": "number"
+            },
+            "clearcoatMap": {
+              "description": "Path to clearcoat intensity map",
+              "type": "string"
+            },
+            "clearcoatRoughnessMap": {
+              "description": "Path to clearcoat roughness map",
+              "type": "string"
+            }
+          },
+          "required": [
+            "clearcoat"
+          ],
+          "additionalProperties": false
+        },
+        "transmission": {
+          "description": "Light transmission (physical only)",
+          "type": "object",
+          "properties": {
+            "transmission": {
+              "type": "number",
+              "description": "Transmission intensity 0–1 (glass, liquid)"
+            },
+            "ior": {
+              "description": "Index of refraction (default 1.5)",
+              "type": "number"
+            },
+            "thickness": {
+              "description": "Volume thickness for refraction",
+              "type": "number"
+            },
+            "attenuationColor": {
+              "description": "Color absorbed over distance",
+              "type": "string"
+            },
+            "attenuationDistance": {
+              "description": "Distance at which attenuation color takes full effect",
+              "type": "number"
+            },
+            "transmissionMap": {
+              "description": "Path to transmission map",
+              "type": "string"
+            }
+          },
+          "required": [
+            "transmission"
+          ],
+          "additionalProperties": false
+        },
+        "sheen": {
+          "description": "Sheen layer (physical only)",
+          "type": "object",
+          "properties": {
+            "sheen": {
+              "type": "number",
+              "description": "Sheen intensity 0–1 (fabric, velvet)"
+            },
+            "sheenColor": {
+              "description": "Sheen tint color",
+              "type": "string"
+            },
+            "sheenRoughness": {
+              "description": "Sheen roughness 0–1",
+              "type": "number"
+            },
+            "sheenColorMap": {
+              "description": "Path to sheen color map",
+              "type": "string"
+            },
+            "sheenRoughnessMap": {
+              "description": "Path to sheen roughness map",
+              "type": "string"
+            }
+          },
+          "required": [
+            "sheen"
+          ],
+          "additionalProperties": false
+        },
+        "iridescence": {
+          "description": "Iridescence thin-film (physical only)",
+          "type": "object",
+          "properties": {
+            "iridescence": {
+              "type": "number",
+              "description": "Iridescence intensity 0–1 (soap bubbles, oil slick)"
+            },
+            "iridescenceIOR": {
+              "description": "Thin-film IOR (default 1.3)",
+              "type": "number"
+            },
+            "iridescenceThicknessRange": {
+              "description": "Min/max thin-film thickness in nm",
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "iridescenceMap": {
+              "description": "Path to iridescence intensity map",
+              "type": "string"
+            },
+            "iridescenceThicknessMap": {
+              "description": "Path to iridescence thickness map",
+              "type": "string"
+            }
+          },
+          "required": [
+            "iridescence"
+          ],
+          "additionalProperties": false
+        },
+        "displacementMap": {
+          "description": "Path to displacement/height map",
+          "type": "string"
+        },
+        "displacementScale": {
+          "description": "Displacement height multiplier",
+          "type": "number"
+        },
+        "displacementBias": {
+          "description": "Displacement offset",
+          "type": "number"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false,
+      "description": "Material definition"
+    }
+  },
+  "required": [
+    "version",
+    "name",
+    "material"
+  ],
+  "additionalProperties": false,
+  "description": "Shared material asset file (.mat.json)"
+}