@neocompose/cli 0.80.0 → 0.81.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.81.0
+
+### Minor Changes
+
+- a130be0: `NeoSpriteObject` extends `NeoObject` (P111). A sprite class can be placed on an object layer, can have `Children`, and gets `OnObjectSpawned`/`OnObjectDespawned`. `PlacementTiles = []` keeps any object, sprite or not, out of the grid's occupied cells: it blocks no placement and `GetObjects`, `GetTile` and `GetTiles` never return it. A placed object with no tiles still has a `Cell`.
+
+  The system schema rollout gives existing sprite instances empty `PlacementTiles` and `Children`. Run `neo pull` and `neo export` after upgrading. Requires Neo Compose .NET SDK 0.71.0.
+
+### Patch Changes
+
+- 2c89443: Materialize authored defaults for omitted optional constructor fields so collection mutations persist on each instance. Match the .NET runtime while preserving omission for fields without defaults.
+
 ## 0.80.0
 
 ### Minor Changes

package/dist/neo.mjs

@@ -715,11 +715,11 @@ var init_world_system_kinds_generated = __esm({
       ObjectCollider: "objectCollider",
       SortingGroup: "sortingGroup",
       LayerGroupBase: "layerGroupBase",
-      SpriteObject: "spriteObject",
       PlacementTile: "placementTile",
       TileLayerLink: "tileLayerLink",
       ObjectLayerLink: "objectLayerLink",
       Object: "object",
+      SpriteObject: "spriteObject",
       SmartTile: "smartTile",
       SmartTileRule: "smartTileRule",
       SmartTileNeighbor: "smartTileNeighbor",
@@ -7675,64 +7675,6 @@ var init_world_system_classes_generated = __esm({
         modifier: 1 /* Abstract */,
         worldKind: "layerGroupBase"
       },
-      {
-        classId: "system_d48b66ab-4d59-47e7-a25a-591fe97062de",
-        name: "NeoSpriteObject",
-        extendsWorldKind: "objectBase",
-        schemaFields: [
-          {
-            memberId: "system_441cb790-a45f-4488-a5a9-6f375af6c369",
-            memberKind: "string",
-            defaultValue: "",
-            format: 1 /* Plain */,
-            distribution: 1 /* Packed */,
-            requirement: 1 /* Required */,
-            schemaKey: "Name"
-          },
-          {
-            memberId: "system_e9288ba9-f5a2-4485-8443-6afb155b31e0",
-            memberKind: "sprite",
-            defaultValue: { fileId: "", sliceIndex: 0 },
-            requirement: 1 /* Required */,
-            schemaKey: "Sprite"
-          },
-          {
-            memberId: "system_9fcab37a-9743-4e35-8eee-80cb560f1433",
-            memberKind: "bool",
-            defaultValue: false,
-            docsText: "Mirrors the sprite horizontally about its own centre. Maps to SpriteRenderer.flipX.",
-            requirement: 1 /* Required */,
-            schemaKey: "FlipX"
-          },
-          {
-            memberId: "system_ddd09f08-1656-4404-b36b-5570a4c01fcf",
-            memberKind: "bool",
-            defaultValue: false,
-            docsText: "Mirrors the sprite vertically about its own centre. Maps to SpriteRenderer.flipY.",
-            requirement: 1 /* Required */,
-            schemaKey: "FlipY"
-          },
-          {
-            memberId: "system_f2a8c86d-ace5-421b-9475-0f3f6f97b2a6",
-            memberKind: "enum",
-            defaultValue: ["system_9d607a4f-60c3-4347-94fc-f24b538bf468"],
-            docsText: "How this sprite reacts to sprite masks. Maps to SpriteRenderer.maskInteraction. The web canvas has no real sprite mask, so anything other than None previews as a distinguishable treatment rather than as the mask itself \u2014 only Unity renders the real thing.",
-            enumId: "system_4e6c4d6f-1d0b-402a-ad3a-be92242dceec",
-            requirement: 1 /* Required */,
-            schemaKey: "MaskInteraction"
-          },
-          {
-            memberId: "system_6f32f1f2-83ea-42fc-8647-34ed0946b7f1",
-            memberKind: "int",
-            defaultValue: null,
-            docsText: "Added to the object layer's sorting order; it does not replace it. The result competes with every renderer in the sorting layer, or in the enclosing sorting group, and among equal orders the renderer lower on screen draws in front. Leave unset to use the layer's order.",
-            minValue: -32768,
-            maxValue: 32767,
-            schemaKey: "SortingOrder"
-          }
-        ],
-        worldKind: "spriteObject"
-      },
       {
         classId: "system_ccc3330c-2db5-44dc-9c8e-5ebfe430dec9",
         name: "NeoPlacementTile",
@@ -7811,6 +7753,7 @@ var init_world_system_classes_generated = __esm({
             memberId: "system_5a9ca1f5-a21b-4d4e-8c55-00341af594b4",
             memberKind: "list",
             defaultValue: [],
+            docsText: "The cells this object occupies, as offsets from its placement cell. An empty list occupies nothing: the object blocks no placement and answers no cell query, but a placed object still has a Cell.",
             entryMemberId: "system_96c7650a-1805-5b27-ae99-d1e49d3cb207",
             requirement: 1 /* Required */,
             schemaKey: "PlacementTiles"
@@ -7995,6 +7938,64 @@ var init_world_system_classes_generated = __esm({
         ],
         worldKind: "object"
       },
+      {
+        classId: "system_d48b66ab-4d59-47e7-a25a-591fe97062de",
+        name: "NeoSpriteObject",
+        extendsWorldKind: "object",
+        schemaFields: [
+          {
+            memberId: "system_441cb790-a45f-4488-a5a9-6f375af6c369",
+            memberKind: "string",
+            defaultValue: "",
+            format: 1 /* Plain */,
+            distribution: 1 /* Packed */,
+            requirement: 1 /* Required */,
+            schemaKey: "Name"
+          },
+          {
+            memberId: "system_e9288ba9-f5a2-4485-8443-6afb155b31e0",
+            memberKind: "sprite",
+            defaultValue: { fileId: "", sliceIndex: 0 },
+            requirement: 1 /* Required */,
+            schemaKey: "Sprite"
+          },
+          {
+            memberId: "system_9fcab37a-9743-4e35-8eee-80cb560f1433",
+            memberKind: "bool",
+            defaultValue: false,
+            docsText: "Mirrors the sprite horizontally about its own centre. Maps to SpriteRenderer.flipX.",
+            requirement: 1 /* Required */,
+            schemaKey: "FlipX"
+          },
+          {
+            memberId: "system_ddd09f08-1656-4404-b36b-5570a4c01fcf",
+            memberKind: "bool",
+            defaultValue: false,
+            docsText: "Mirrors the sprite vertically about its own centre. Maps to SpriteRenderer.flipY.",
+            requirement: 1 /* Required */,
+            schemaKey: "FlipY"
+          },
+          {
+            memberId: "system_f2a8c86d-ace5-421b-9475-0f3f6f97b2a6",
+            memberKind: "enum",
+            defaultValue: ["system_9d607a4f-60c3-4347-94fc-f24b538bf468"],
+            docsText: "How this sprite reacts to sprite masks. Maps to SpriteRenderer.maskInteraction. The web canvas has no real sprite mask, so anything other than None previews as a distinguishable treatment rather than as the mask itself \u2014 only Unity renders the real thing.",
+            enumId: "system_4e6c4d6f-1d0b-402a-ad3a-be92242dceec",
+            requirement: 1 /* Required */,
+            schemaKey: "MaskInteraction"
+          },
+          {
+            memberId: "system_6f32f1f2-83ea-42fc-8647-34ed0946b7f1",
+            memberKind: "int",
+            defaultValue: null,
+            docsText: "Added to the object layer's sorting order; it does not replace it. The result competes with every renderer in the sorting layer, or in the enclosing sorting group, and among equal orders the renderer lower on screen draws in front. Leave unset to use the layer's order.",
+            minValue: -32768,
+            maxValue: 32767,
+            schemaKey: "SortingOrder"
+          }
+        ],
+        worldKind: "spriteObject"
+      },
       {
         classId: "system_9f34deed-2616-43c9-b614-d812da89ee51",
         name: "NeoSmartTile",
@@ -12545,11 +12546,7 @@ function completeDefaultClassRecord(args) {
     if (!shouldMaterializeChildDefaultForRoot(
       args.constructorRoot,
       resolvedChildMember,
-      defaultSettlesConstruction2,
-      documentHasInitValueContent(
-        args.document,
-        resolvedChildMember.defaultValue
-      )
+      defaultSettlesConstruction2
     )) {
       continue;
     }
@@ -12977,11 +12974,6 @@ function shouldMaterializeChildDefault(member) {
   }
   return member.defaultValue !== void 0;
 }
-function shouldMaterializeConstructorChildDefault(member, isInitializer = isInitValueContent(member.defaultValue)) {
-  if (isInitializer) return true;
-  if (!isRequiredMember(member)) return false;
-  return shouldMaterializeChildDefault(member);
-}
 function skipProvidedConstructorSchemaKey(constructorRoot, schemaKey, member, defaultSettlesConstruction2, isInitializer = isInitValueContent(member.defaultValue)) {
   if (constructorRoot === void 0) return false;
   if (!constructorRoot.providedSchemaKeys.has(schemaKey)) return false;
@@ -12990,16 +12982,11 @@ function skipProvidedConstructorSchemaKey(constructorRoot, schemaKey, member, de
   }
   return !isInitializer && !defaultSettlesConstruction2;
 }
-function shouldMaterializeChildDefaultForRoot(constructorRoot, member, defaultSettlesConstruction2, isInitializer = isInitValueContent(member.defaultValue)) {
-  if (constructorRoot === void 0)
-    return shouldMaterializeChildDefault(member);
-  if (constructorRoot.omitMissingRequired === true && !defaultSettlesConstruction2) {
+function shouldMaterializeChildDefaultForRoot(constructorRoot, member, defaultSettlesConstruction2) {
+  if (constructorRoot?.omitMissingRequired === true && !defaultSettlesConstruction2) {
     return false;
   }
-  if (constructorRoot.runsMemberInitializers === true) {
-    return shouldMaterializeChildDefault(member);
-  }
-  return shouldMaterializeConstructorChildDefault(member, isInitializer);
+  return shouldMaterializeChildDefault(member);
 }
 function primitiveFallbackValue(document, member) {
   if (isMemberBoolBase(member)) return { value: false };
@@ -23052,10 +23039,6 @@ function validateInternalRecordRelations(args) {
   const classesById = new Map(
     args.classes.map((schemaClass2) => [schemaClass2.id, schemaClass2])
   );
-  const worldKindsByClassId = indexWorldSystemClassKinds(
-    args.classes,
-    classesById
-  );
   const relationIds = /* @__PURE__ */ new Set();
   const edgeKeys = /* @__PURE__ */ new Set();
   const orderedKeys2 = /* @__PURE__ */ new Set();
@@ -23119,16 +23102,14 @@ function validateInternalRecordRelations(args) {
       contract,
       endpoint: "source",
       recordEndpoint: source,
-      classesById,
-      worldKindsByClassId
+      classesById
     });
     validateWorldEndpoint({
       relation,
       contract,
       endpoint: "target",
       recordEndpoint: target,
-      classesById,
-      worldKindsByClassId
+      classesById
     });
     const edgeKey = [
       relation.relationKind,
@@ -23439,8 +23420,7 @@ function validateWorldEndpoint(args) {
       `Internal record relation "${args.relation.id}" ${args.endpoint} ${classLabel} "${classId}" does not exist.`
     );
   }
-  const actualWorldKind = args.worldKindsByClassId.get(schemaClass2.id) ?? null;
-  if (actualWorldKind !== requiredWorldKind) {
+  if (!classInheritsWorldKind(schemaClass2.id, requiredWorldKind, args.classesById)) {
     throw new Error(
       `Internal record relation "${args.relation.id}" ${args.endpoint} ${classLabel} "${schemaClass2.id}" must extend world class kind "${requiredWorldKind}".`
     );
@@ -54544,7 +54524,7 @@ var init_registry = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.80.0",
+      cliVersion: "0.81.0",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -75128,7 +75108,11 @@ function buildIndex(source) {
         }
         const placement = {
           valueId,
-          isNeoObject: kinds.get(row.classId) === NeoWorldSystemClassKind.Object,
+          isNeoObject: classInheritsWorldKind(
+            row.classId,
+            NeoWorldSystemClassKind.Object,
+            relations.classesById
+          ),
           classId: row.classId,
           gridId: root.id,
           layerId,
@@ -114839,11 +114823,14 @@ function optionalNonEmptyString(value) {
   return typeof value === "string" && value.length > 0 ? value : null;
 }
 function consumeWorldPlacementSidecarKeys(args) {
-  const worldKind = args.worldKindsByClassId === void 0 ? resolveWorldSystemClassKind(args.classId, args.classes) : args.worldKindsByClassId.get(args.classId) ?? null;
-  if (worldKind === null) return /* @__PURE__ */ new Set();
-  const assetKind = WORLD_PLACEMENT_ASSET_KIND.get(worldKind);
-  if (assetKind === void 0) return /* @__PURE__ */ new Set();
   const classesById = args.classesById ?? new Map(args.classes.map((schemaClass2) => [schemaClass2.id, schemaClass2]));
+  if (!classInheritsWorldKind(
+    args.classId,
+    NeoWorldSystemClassKind.Object,
+    classesById
+  )) {
+    return /* @__PURE__ */ new Set();
+  }
   const present = /* @__PURE__ */ new Set();
   for (const key of WORLD_PLACEMENT_SIDECAR_KEYS) {
     if (!Object.hasOwn(args.body, key)) continue;
@@ -114860,13 +114847,13 @@ function consumeWorldPlacementSidecarKeys(args) {
       classId: assetClassId,
       worldKindsByClassId: args.worldKindsByClassId ?? indexWorldSystemClassKinds(args.classes, classesById),
       classesById,
-      expectedKind: assetKind,
+      expectedKind: NeoWorldSystemClassKind.Object,
       label: `${args.label} assetClassId`
     });
   }
   return present;
 }
-var WORLD_PLACEMENT_SIDECAR_KEYS, TILE_CLASS_LEVEL_KEYS, WORLD_PLACEMENT_ASSET_KIND;
+var WORLD_PLACEMENT_SIDECAR_KEYS, TILE_CLASS_LEVEL_KEYS;
 var init_world_content_sidecar_validation = __esm({
   "../src/models/project/world-content-sidecar-validation.ts"() {
     "use strict";
@@ -114891,7 +114878,6 @@ var init_world_content_sidecar_validation = __esm({
     ).flatMap(
       (field) => field.mutability === 1 /* ReadOnly */ ? [field.schemaKey] : []
     );
-    WORLD_PLACEMENT_ASSET_KIND = /* @__PURE__ */ new Map([[NeoWorldSystemClassKind.Object, NeoWorldSystemClassKind.Object]]);
   }
 });
 
@@ -128147,7 +128133,11 @@ function assertVariantMemberTargetValid(args) {
       `${label} targets class "${target.classId}", which is not in this project.`
     );
   }
-  if (resolveWorldKindFromClassMap(target.classId, classesById) !== NeoWorldSystemClassKind.Object) {
+  if (!classInheritsWorldKind(
+    target.classId,
+    NeoWorldSystemClassKind.Object,
+    classesById
+  )) {
     throw new Error(
       `${label} targets class "${targetClass.name}", which does not derive from NeoObject. Only NeoObject-derived classes declare variants (P67 \xA71).`
     );
@@ -171787,7 +171777,7 @@ function classExtendsClass(ctx, classId, ancestorClassId) {
 function generateClassBackedWorldMembers(ctx, classDef, className) {
   if (isAbstractClass(classDef)) return [];
   const worldKind = ctx.worldKinds.get(classDef.id) ?? null;
-  if (worldKind === NeoWorldSystemClassKind.Tile || worldKind === NeoWorldSystemClassKind.Object) {
+  if (worldKind === NeoWorldSystemClassKind.Tile || descendsFromWorldObject(ctx, classDef.id)) {
     return [
       `public static NeoClassRef<${className}> Definition { get; } = new NeoClassRef<${className}>("${escapeCSharpString(classDef.id)}");`
     ];
@@ -173537,9 +173527,10 @@ function objectSpawnHookClassMembers(classDef) {
     "",
     "/// <summary>",
     "/// Renderer spawn hook \u2014 override in a partial class to attach Unity",
-    "/// components (e.g. Rigidbody2D) to the instance's fully-built root",
-    `/// GameObject. See <see cref="${OBJECT_SPAWN_HOOKS_INTERFACE}"/> for timing and`,
-    "/// respawn semantics.",
+    "/// components (e.g. Rigidbody2D) to this object's GameObject. Runs on",
+    "/// the placed root and every object in its composition, parents first;",
+    "/// check behaviour.IsRoot for the placed instance. See",
+    `/// <see cref="${OBJECT_SPAWN_HOOKS_INTERFACE}"/> for timing and respawn semantics.`,
     "/// </summary>",
     "protected virtual void OnObjectSpawned(NeoObjectBehaviour behaviour)",
     "{",
@@ -173547,8 +173538,8 @@ function objectSpawnHookClassMembers(classDef) {
     "",
     "/// <summary>",
     "/// Renderer despawn hook \u2014 override in a partial class to release",
-    "/// per-GameObject state before the instance's root GameObject is",
-    "/// destroyed.",
+    "/// per-GameObject state before this object's GameObject is destroyed.",
+    "/// Children despawn before their parents.",
     "/// </summary>",
     "protected virtual void OnObjectDespawned(NeoObjectBehaviour behaviour)",
     "{",
@@ -181263,7 +181254,7 @@ var UNITY_CODEGEN_REVISION;
 var init_unity_codegen_revision = __esm({
   "../src/models/exports/unity-codegen-revision.ts"() {
     "use strict";
-    UNITY_CODEGEN_REVISION = "edfd4061dffcd1a747b234cd135b99beca6f4cf1958cb69715029c5935dd7f1b";
+    UNITY_CODEGEN_REVISION = "d4026a3848848c8507d45dd54b6d31c1a0588b17b64c35e3fe9b25c89eb2fc05";
   }
 });
 
@@ -201083,7 +201074,7 @@ There is no --keep-current: preserving current semantic state defines flatten.
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.command === "--version") {
-    console.log("0.80.0");
+    console.log("0.81.0");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/dist/test-worker.mjs

@@ -1013,11 +1013,11 @@ var NeoWorldSystemClassKind = {
   ObjectCollider: "objectCollider",
   SortingGroup: "sortingGroup",
   LayerGroupBase: "layerGroupBase",
-  SpriteObject: "spriteObject",
   PlacementTile: "placementTile",
   TileLayerLink: "tileLayerLink",
   ObjectLayerLink: "objectLayerLink",
   Object: "object",
+  SpriteObject: "spriteObject",
   SmartTile: "smartTile",
   SmartTileRule: "smartTileRule",
   SmartTileNeighbor: "smartTileNeighbor",
@@ -7343,64 +7343,6 @@ var WORLD_SYSTEM_CLASS_DEFINITIONS = [
     modifier: 1 /* Abstract */,
     worldKind: "layerGroupBase"
   },
-  {
-    classId: "system_d48b66ab-4d59-47e7-a25a-591fe97062de",
-    name: "NeoSpriteObject",
-    extendsWorldKind: "objectBase",
-    schemaFields: [
-      {
-        memberId: "system_441cb790-a45f-4488-a5a9-6f375af6c369",
-        memberKind: "string",
-        defaultValue: "",
-        format: 1 /* Plain */,
-        distribution: 1 /* Packed */,
-        requirement: 1 /* Required */,
-        schemaKey: "Name"
-      },
-      {
-        memberId: "system_e9288ba9-f5a2-4485-8443-6afb155b31e0",
-        memberKind: "sprite",
-        defaultValue: { fileId: "", sliceIndex: 0 },
-        requirement: 1 /* Required */,
-        schemaKey: "Sprite"
-      },
-      {
-        memberId: "system_9fcab37a-9743-4e35-8eee-80cb560f1433",
-        memberKind: "bool",
-        defaultValue: false,
-        docsText: "Mirrors the sprite horizontally about its own centre. Maps to SpriteRenderer.flipX.",
-        requirement: 1 /* Required */,
-        schemaKey: "FlipX"
-      },
-      {
-        memberId: "system_ddd09f08-1656-4404-b36b-5570a4c01fcf",
-        memberKind: "bool",
-        defaultValue: false,
-        docsText: "Mirrors the sprite vertically about its own centre. Maps to SpriteRenderer.flipY.",
-        requirement: 1 /* Required */,
-        schemaKey: "FlipY"
-      },
-      {
-        memberId: "system_f2a8c86d-ace5-421b-9475-0f3f6f97b2a6",
-        memberKind: "enum",
-        defaultValue: ["system_9d607a4f-60c3-4347-94fc-f24b538bf468"],
-        docsText: "How this sprite reacts to sprite masks. Maps to SpriteRenderer.maskInteraction. The web canvas has no real sprite mask, so anything other than None previews as a distinguishable treatment rather than as the mask itself \u2014 only Unity renders the real thing.",
-        enumId: "system_4e6c4d6f-1d0b-402a-ad3a-be92242dceec",
-        requirement: 1 /* Required */,
-        schemaKey: "MaskInteraction"
-      },
-      {
-        memberId: "system_6f32f1f2-83ea-42fc-8647-34ed0946b7f1",
-        memberKind: "int",
-        defaultValue: null,
-        docsText: "Added to the object layer's sorting order; it does not replace it. The result competes with every renderer in the sorting layer, or in the enclosing sorting group, and among equal orders the renderer lower on screen draws in front. Leave unset to use the layer's order.",
-        minValue: -32768,
-        maxValue: 32767,
-        schemaKey: "SortingOrder"
-      }
-    ],
-    worldKind: "spriteObject"
-  },
   {
     classId: "system_ccc3330c-2db5-44dc-9c8e-5ebfe430dec9",
     name: "NeoPlacementTile",
@@ -7479,6 +7421,7 @@ var WORLD_SYSTEM_CLASS_DEFINITIONS = [
         memberId: "system_5a9ca1f5-a21b-4d4e-8c55-00341af594b4",
         memberKind: "list",
         defaultValue: [],
+        docsText: "The cells this object occupies, as offsets from its placement cell. An empty list occupies nothing: the object blocks no placement and answers no cell query, but a placed object still has a Cell.",
         entryMemberId: "system_96c7650a-1805-5b27-ae99-d1e49d3cb207",
         requirement: 1 /* Required */,
         schemaKey: "PlacementTiles"
@@ -7663,6 +7606,64 @@ var WORLD_SYSTEM_CLASS_DEFINITIONS = [
     ],
     worldKind: "object"
   },
+  {
+    classId: "system_d48b66ab-4d59-47e7-a25a-591fe97062de",
+    name: "NeoSpriteObject",
+    extendsWorldKind: "object",
+    schemaFields: [
+      {
+        memberId: "system_441cb790-a45f-4488-a5a9-6f375af6c369",
+        memberKind: "string",
+        defaultValue: "",
+        format: 1 /* Plain */,
+        distribution: 1 /* Packed */,
+        requirement: 1 /* Required */,
+        schemaKey: "Name"
+      },
+      {
+        memberId: "system_e9288ba9-f5a2-4485-8443-6afb155b31e0",
+        memberKind: "sprite",
+        defaultValue: { fileId: "", sliceIndex: 0 },
+        requirement: 1 /* Required */,
+        schemaKey: "Sprite"
+      },
+      {
+        memberId: "system_9fcab37a-9743-4e35-8eee-80cb560f1433",
+        memberKind: "bool",
+        defaultValue: false,
+        docsText: "Mirrors the sprite horizontally about its own centre. Maps to SpriteRenderer.flipX.",
+        requirement: 1 /* Required */,
+        schemaKey: "FlipX"
+      },
+      {
+        memberId: "system_ddd09f08-1656-4404-b36b-5570a4c01fcf",
+        memberKind: "bool",
+        defaultValue: false,
+        docsText: "Mirrors the sprite vertically about its own centre. Maps to SpriteRenderer.flipY.",
+        requirement: 1 /* Required */,
+        schemaKey: "FlipY"
+      },
+      {
+        memberId: "system_f2a8c86d-ace5-421b-9475-0f3f6f97b2a6",
+        memberKind: "enum",
+        defaultValue: ["system_9d607a4f-60c3-4347-94fc-f24b538bf468"],
+        docsText: "How this sprite reacts to sprite masks. Maps to SpriteRenderer.maskInteraction. The web canvas has no real sprite mask, so anything other than None previews as a distinguishable treatment rather than as the mask itself \u2014 only Unity renders the real thing.",
+        enumId: "system_4e6c4d6f-1d0b-402a-ad3a-be92242dceec",
+        requirement: 1 /* Required */,
+        schemaKey: "MaskInteraction"
+      },
+      {
+        memberId: "system_6f32f1f2-83ea-42fc-8647-34ed0946b7f1",
+        memberKind: "int",
+        defaultValue: null,
+        docsText: "Added to the object layer's sorting order; it does not replace it. The result competes with every renderer in the sorting layer, or in the enclosing sorting group, and among equal orders the renderer lower on screen draws in front. Leave unset to use the layer's order.",
+        minValue: -32768,
+        maxValue: 32767,
+        schemaKey: "SortingOrder"
+      }
+    ],
+    worldKind: "spriteObject"
+  },
   {
     classId: "system_9f34deed-2616-43c9-b614-d812da89ee51",
     name: "NeoSmartTile",
@@ -11959,11 +11960,7 @@ function completeDefaultClassRecord(args) {
     if (!shouldMaterializeChildDefaultForRoot(
       args.constructorRoot,
       resolvedChildMember,
-      defaultSettlesConstruction2,
-      documentHasInitValueContent(
-        args.document,
-        resolvedChildMember.defaultValue
-      )
+      defaultSettlesConstruction2
     )) {
       continue;
     }
@@ -12391,11 +12388,6 @@ function shouldMaterializeChildDefault(member) {
   }
   return member.defaultValue !== void 0;
 }
-function shouldMaterializeConstructorChildDefault(member, isInitializer = isInitValueContent(member.defaultValue)) {
-  if (isInitializer) return true;
-  if (!isRequiredMember(member)) return false;
-  return shouldMaterializeChildDefault(member);
-}
 function skipProvidedConstructorSchemaKey(constructorRoot, schemaKey, member, defaultSettlesConstruction2, isInitializer = isInitValueContent(member.defaultValue)) {
   if (constructorRoot === void 0) return false;
   if (!constructorRoot.providedSchemaKeys.has(schemaKey)) return false;
@@ -12404,16 +12396,11 @@ function skipProvidedConstructorSchemaKey(constructorRoot, schemaKey, member, de
   }
   return !isInitializer && !defaultSettlesConstruction2;
 }
-function shouldMaterializeChildDefaultForRoot(constructorRoot, member, defaultSettlesConstruction2, isInitializer = isInitValueContent(member.defaultValue)) {
-  if (constructorRoot === void 0)
-    return shouldMaterializeChildDefault(member);
-  if (constructorRoot.omitMissingRequired === true && !defaultSettlesConstruction2) {
+function shouldMaterializeChildDefaultForRoot(constructorRoot, member, defaultSettlesConstruction2) {
+  if (constructorRoot?.omitMissingRequired === true && !defaultSettlesConstruction2) {
     return false;
   }
-  if (constructorRoot.runsMemberInitializers === true) {
-    return shouldMaterializeChildDefault(member);
-  }
-  return shouldMaterializeConstructorChildDefault(member, isInitializer);
+  return shouldMaterializeChildDefault(member);
 }
 function primitiveFallbackValue(document2, member) {
   if (isMemberBoolBase(member)) return { value: false };
@@ -16249,7 +16236,11 @@ function buildIndex(source) {
         }
         const placement = {
           valueId,
-          isNeoObject: kinds.get(row.classId) === NeoWorldSystemClassKind.Object,
+          isNeoObject: classInheritsWorldKind(
+            row.classId,
+            NeoWorldSystemClassKind.Object,
+            relations.classesById
+          ),
           classId: row.classId,
           gridId: root.id,
           layerId,
@@ -53768,7 +53759,6 @@ var TILE_CLASS_LEVEL_KEYS = worldSystemSchemaFieldsForKind(
 ).flatMap(
   (field) => field.mutability === 1 /* ReadOnly */ ? [field.schemaKey] : []
 );
-var WORLD_PLACEMENT_ASSET_KIND = /* @__PURE__ */ new Map([[NeoWorldSystemClassKind.Object, NeoWorldSystemClassKind.Object]]);
 
 // ../src/database/general-function-call-ir-source-recompile.ts
 var VOID_ACTION_TYPE_INFO = {
@@ -58806,7 +58796,7 @@ var INITIALIZER_KEY_PLACEHOLDER = new RegExp(
 
 // ../packages/manifest/schema-contract/registry.mjs
 var PROJECT_SCHEMA_CONTRACT = Object.freeze({
-  cliVersion: "0.80.0",
+  cliVersion: "0.81.0",
   projectFileUploadBatchSize: 32,
   documentRecords: {
     member: {
@@ -60647,7 +60637,7 @@ var SCRIPT_COLLECTION_READERS = {
 };
 
 // ../src/models/exports/unity-codegen-revision.ts
-var UNITY_CODEGEN_REVISION = "edfd4061dffcd1a747b234cd135b99beca6f4cf1958cb69715029c5935dd7f1b";
+var UNITY_CODEGEN_REVISION = "d4026a3848848c8507d45dd54b6d31c1a0588b17b64c35e3fe9b25c89eb2fc05";
 
 // src/export-cache.ts
 var CACHE_BUILD = JSON.stringify([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",

package/skills/neocompose-cli/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   `@neocompose/cli` or `node cli/bin/neo.mjs` in the neo-compose repository.
 ---
 
-<!-- reviewed-through-cli: 0.80.0 -->
+<!-- reviewed-through-cli: 0.81.0 -->
 
 # Neo Compose CLI
 

package/skills/neocompose-cli/references/animation-and-world-authoring.md

@@ -95,7 +95,12 @@ Object `PlacementTiles` is a `List<NeoPlacementTile>`. Each entry marks a
 footprint cell with its own `Cell` member. It is independent of `NeoTile`. Rendered
 tile classes do not belong in this list. An object with no placement tiles
 occupies no cells. It doesn't block other placements, and cell queries don't
-return it.
+return it. A placed object with no tiles still has a `Cell`.
+
+`NeoSpriteObject` extends `NeoObject`. Place a sprite class like any object,
+give it `Children`, and override `OnObjectSpawned`/`OnObjectDespawned` on it.
+Hooks fire on every object in a placed hierarchy, parent first; despawn runs
+children first. `NeoObjectBehaviour.IsRoot` is true only on the placed root.
 
 Convert a writable placement without changing its row identity or cell:
 

package/skills/neocompose-cli/references/cli-development.md

@@ -129,7 +129,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.80.0 -->
+<!-- reviewed-through-cli: 0.81.0 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

package/skills/neocompose-cli/references/neoscript.md

@@ -163,6 +163,10 @@ A static field that names another static copies a value, as in
 `public static int B = Holder.A;`. A class, List, Set, or Dictionary static
 already owns its value, so call `Clone()` or use `Reference`. A static delegate cannot copy another Class's delegate field,
 because its closure compiles in its own Class; wrap it as `() => Other.Call()`.
+Omitted constructor fields use their authored defaults, including optional fields.
+Writable collection defaults belong to each instance; mutations persist on later
+reads without changing another instance's default. Fields without defaults remain
+absent, and `null` arguments in generated member-wise constructors mean omission.
 Collection type arguments in constructions, such as `new Box<List<int>>([1, 2])`,
 work even when no field declares that collection type. Preparation includes the
 needed type descriptors; spec-only types remain in the test candidate.