@deepblend/dsh-blender-contracts 0.2.17 → 0.2.19

package/lib/schemas/scene-spec.schema.json

@@ -497,6 +497,14 @@
           "$ref": "#/$defs/rigidBody",
           "description": "This entity takes part in physics (SPEC \u00a720 M6, complex simulation). WHAT THIS SLICE DOES: rigid bodies \u2014 active ones fall and collide, passive ones are what they collide with, and the compile BAKES the result into the checkpoint so a render shows it. WHAT IT DOES NOT DO YET: cloth, soft bodies and fluids, which are the next slices."
         },
+        "cloth": {
+          "$ref": "#/$defs/cloth",
+          "description": "This entity is simulated as FABRIC. A different field from `rigidBody` because it is a different mechanism rather than a different setting: a rigid body is a body type on the object, while cloth is a modifier that deforms the mesh. WHAT THIS SLICE DOES NOT DO YET: soft bodies and fluids, which are the next slices."
+        },
+        "softBody": {
+          "$ref": "#/$defs/softBody",
+          "description": "This entity is simulated as a SOFT BODY: it deforms and it remembers its shape, which is what separates it from cloth. A separate field because it is a separate modifier with separate settings; WHAT THIS DOES NOT DO YET: fluids, the last slice."
+        },
         "generator": {
           "$ref": "#/$defs/generator"
         },
@@ -910,6 +918,50 @@
           "description": "Blender's own default applies when absent."
         }
       }
+    },
+    "cloth": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "pinTop": {
+          "type": "boolean",
+          "default": true,
+          "description": "Hang the cloth from its top edge, which is what makes it drape rather than fall. The compiler builds the vertex group Blender needs from the geometry, because a group name in the file would be a reference to something no generator creates."
+        },
+        "mass": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "description": "Kilograms per square metre. Blender's own default applies when absent."
+        },
+        "stiffness": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "How much the fabric resists bending, 0 to 1. Blender's own default applies when absent."
+        }
+      }
+    },
+    "softBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "pinTop": {
+          "type": "boolean",
+          "default": false,
+          "description": "Hold the top edge in place, so the body deforms around it rather than falling freely."
+        },
+        "goal": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "How strongly the body remembers its shape, 0 to 1. Blender's own default applies when absent, and that default is high \u2014 which is why a soft body falls while keeping its shape rather than collapsing, and why both of those are asserted."
+        },
+        "mass": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "description": "Kilograms. Blender's own default applies when absent."
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepblend/dsh-blender-contracts",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "type": "module",
   "description": "DeepBlend Studio Service Definition, protocol contracts, and stable error codes.",
   "main": "lib/index.js",