@neocompose/cli 0.65.0 → 0.65.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.65.1] - 2026-10-03
+
+- Pull and push reconciliation emit a stored `new NeoAnimationSegmentFrame<NeoCollider?>(value: null)`. A null constructor argument typed by a class's generic parameter now checks nullability against the row's type argument. Previously, a pushed segment holding a null frame committed, but source reconciliation failed with "Required constructor argument stores null".
+- Pulled type arguments keep a nullable binding's `?`, in constructions, references, and declared member types. Previously `FrameBox<NeoCollider?> Box` pulled as `FrameBox<NeoCollider> Box`, and the next push made the binding required.
+- Code compiled from stored records keeps a nullable binding's `?`. A member declared `NeoAnimationSegmentFrame<NeoCollider?>` keeps that type, so passing it where that type is expected compiles, and reading its value as a required `NeoCollider` reports an error. Previously, every bound type argument was typed as required.
+
 ## [0.65.0] - 2026-10-03
 
 - Move `Collider` from `NeoObject` to `NeoObjectBase`, so sprite objects and layer groups can carry a box collider too. Unity codegen implements `INeoColliderSource` on `NeoObjectBase`.

package/dist/neo.mjs

@@ -29955,7 +29955,7 @@ var init_registry = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.65.0",
+      cliVersion: "0.65.1",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -52525,7 +52525,7 @@ function renderMemberType(context, member, enclosingClassId, elementSettings = f
             context,
             required(context.members, boundMemberId, "generic binding"),
             enclosingClassId
-          ).replace(/\?$/u, "");
+          );
         });
         value = `${schemaClass2.name}${args.length ? `<${args.join(", ")}>` : ""}`;
       }
@@ -65468,13 +65468,11 @@ function classArguments(member, context, seen, genericEnvironment) {
       if (environmentEntry?.kind === "member") {
         const argument3 = analyzerMemberById(context, environmentEntry.memberId);
         return argument3 ? [
-          requiredType(
-            memberRuntimeType(
-              argument3,
-              context,
-              new Set(seen),
-              genericEnvironment
-            )
+          memberRuntimeType(
+            argument3,
+            context,
+            new Set(seen),
+            genericEnvironment
           )
         ] : [];
       }
@@ -65489,13 +65487,11 @@ function classArguments(member, context, seen, genericEnvironment) {
     }
     const argument2 = analyzerMemberById(context, binding.memberId);
     return argument2 ? [
-      requiredType(
-        memberRuntimeType(
-          argument2,
-          context,
-          new Set(seen),
-          genericEnvironment
-        )
+      memberRuntimeType(
+        argument2,
+        context,
+        new Set(seen),
+        genericEnvironment
       )
     ] : [];
   });
@@ -65682,11 +65678,7 @@ function genericConstraintLanguageType(constraint, context, genericEnvironment,
       ];
     }
     const member = analyzerMemberById(context, binding.memberId);
-    return member ? [
-      requiredType(
-        memberRuntimeType(member, context, /* @__PURE__ */ new Set(), genericEnvironment)
-      )
-    ] : [];
+    return member ? [memberRuntimeType(member, context, /* @__PURE__ */ new Set(), genericEnvironment)] : [];
   });
   return {
     kind: "named",
@@ -127740,7 +127732,7 @@ function recordedStoredConstructorId(value, schemaClass2) {
 }
 function storedConstructorArgumentSource(context, type, value, environment, visited, cloneAggregateArguments = false, partial = false, constructorOwnsGraph = false) {
   if (value === null) {
-    if (!type.nullable) {
+    if (!type.nullable && (type.kind !== "generic" || !storedGenericArgumentType(context, type, environment).nullable)) {
       throw new Error("Required constructor argument stores null.");
     }
     return "null";
@@ -127830,26 +127822,10 @@ function storedConstructorArgumentSource(context, type, value, environment, visi
         constructorOwnsGraph
       );
     }
-    case "generic": {
-      const bindingId = environment.get(type.genericParamId);
-      const inferredClassId = inferredGenericClassId(bindingId);
-      const resolvedType = inferredClassId === null ? bindingId === void 0 ? null : schemaTypeForBindingMember(context, bindingId, environment) : {
-        kind: "class",
-        nullable: type.nullable,
-        classId: inferredClassId,
-        classArguments: {}
-      };
-      if (resolvedType === null) {
-        throw new Error(
-          `Stored Generic constructor argument cannot resolve parameter ${type.genericParamId}.`
-        );
-      }
+    case "generic":
       return storedConstructorArgumentSource(
         context,
-        withSchemaTypeNullability(
-          resolvedType,
-          type.nullable || resolvedType.nullable
-        ),
+        storedGenericArgumentType(context, type, environment),
         value,
         environment,
         visited,
@@ -127857,7 +127833,6 @@ function storedConstructorArgumentSource(context, type, value, environment, visi
         partial,
         constructorOwnsGraph
       );
-    }
     case "interface":
     case "list":
     case "dictionary":
@@ -127908,6 +127883,25 @@ function storedConstructorArgumentSource(context, type, value, environment, visi
       );
   }
 }
+function storedGenericArgumentType(context, type, environment) {
+  const bindingId = environment.get(type.genericParamId);
+  const inferredClassId = inferredGenericClassId(bindingId);
+  const resolvedType = inferredClassId === null ? bindingId === void 0 ? null : schemaTypeForBindingMember(context, bindingId, environment) : {
+    kind: "class",
+    nullable: type.nullable,
+    classId: inferredClassId,
+    classArguments: {}
+  };
+  if (resolvedType === null) {
+    throw new Error(
+      `Stored Generic constructor argument cannot resolve parameter ${type.genericParamId}.`
+    );
+  }
+  return withSchemaTypeNullability(
+    resolvedType,
+    type.nullable || resolvedType.nullable
+  );
+}
 function schemaTypeForBindingMember(context, memberId, environment, visited = /* @__PURE__ */ new Set()) {
   if (visited.has(memberId)) {
     throw new Error(
@@ -128073,6 +128067,10 @@ function storedAggregateReplaySource(context, type, valueId, environment, constr
 function isSharedConstructorArgument(context, valueId, constructorOwnsGraph) {
   return !constructorOwnsGraph && context.readMaterializedGraph().independentlyOwnedValueIds.has(valueId);
 }
+function storedTypeArgumentName(context, type, environment) {
+  const settled = type.kind === "generic" ? storedGenericArgumentType(context, type, environment) : type;
+  return `${storedSchemaTypeName(context, settled, environment)}${settled.nullable ? "?" : ""}`;
+}
 function storedSchemaTypeName(context, type, environment, valueId) {
   switch (type.kind) {
     case "unknown":
@@ -128085,7 +128083,7 @@ function storedSchemaTypeName(context, type, environment, valueId) {
       const argumentsValue = schemaClass2.genericParameters.flatMap(
         (parameter4) => {
           const argument2 = type.classArguments[parameter4.id];
-          return argument2 === void 0 ? [] : [storedSchemaTypeName(context, argument2, environment)];
+          return argument2 === void 0 ? [] : [storedTypeArgumentName(context, argument2, environment)];
         }
       );
       return `${schemaClass2.name}${argumentsValue.length === 0 ? "" : `<${argumentsValue.join(", ")}>`}`;
@@ -128113,10 +128111,10 @@ function storedSchemaTypeName(context, type, environment, valueId) {
       return manifestMemberTypeName(context, member);
     }
     case "list":
-      return `List<${storedSchemaTypeName(context, type.entryType, environment)}>`;
+      return `List<${storedTypeArgumentName(context, type.entryType, environment)}>`;
     case "dictionary": {
       const keyType = type.keyEnumId === null ? "string" : stringField3(context.enums.get(type.keyEnumId) ?? {}, "name");
-      return `Dictionary<${keyType}, ${storedSchemaTypeName(context, type.entryType, environment)}>`;
+      return `Dictionary<${keyType}, ${storedTypeArgumentName(context, type.entryType, environment)}>`;
     }
     case "bool":
     case "int":
@@ -128333,10 +128331,13 @@ function classValueTypeName(context, classId, member, environment) {
         `Stored Class member ${String(member.name ?? member.id)} has no concrete ${parameter4.name} binding.`
       );
     }
-    return manifestMemberTypeName(context, bindingMember);
+    return typeArgumentName(context, bindingMember);
   });
   return `${name}<${argumentsValue.join(", ")}>`;
 }
+function typeArgumentName(context, member) {
+  return `${manifestMemberTypeName(context, member)}${member.required ? "" : "?"}`;
+}
 function manifestMemberTypeName(context, member) {
   if (member.kind === "class") {
     const schemaClass2 = context.manifestClasses.get(member.classId);
@@ -128357,7 +128358,7 @@ function manifestMemberTypeName(context, member) {
           `Stored generic binding ${binding.memberId} was not pulled.`
         );
       }
-      return manifestMemberTypeName(context, argument2);
+      return typeArgumentName(context, argument2);
     });
     return `${schemaClass2.name}<${argumentsValue.join(", ")}>`;
   }
@@ -156205,7 +156206,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.65.0");
+    console.log("0.65.1");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/dist/test-worker.mjs

@@ -40639,13 +40639,11 @@ function classArguments(member, context, seen, genericEnvironment) {
       if (environmentEntry?.kind === "member") {
         const argument3 = analyzerMemberById(context, environmentEntry.memberId);
         return argument3 ? [
-          requiredType(
-            memberRuntimeType(
-              argument3,
-              context,
-              new Set(seen),
-              genericEnvironment
-            )
+          memberRuntimeType(
+            argument3,
+            context,
+            new Set(seen),
+            genericEnvironment
           )
         ] : [];
       }
@@ -40660,13 +40658,11 @@ function classArguments(member, context, seen, genericEnvironment) {
     }
     const argument2 = analyzerMemberById(context, binding.memberId);
     return argument2 ? [
-      requiredType(
-        memberRuntimeType(
-          argument2,
-          context,
-          new Set(seen),
-          genericEnvironment
-        )
+      memberRuntimeType(
+        argument2,
+        context,
+        new Set(seen),
+        genericEnvironment
       )
     ] : [];
   });
@@ -40853,11 +40849,7 @@ function genericConstraintLanguageType(constraint, context, genericEnvironment,
       ];
     }
     const member = analyzerMemberById(context, binding.memberId);
-    return member ? [
-      requiredType(
-        memberRuntimeType(member, context, /* @__PURE__ */ new Set(), genericEnvironment)
-      )
-    ] : [];
+    return member ? [memberRuntimeType(member, context, /* @__PURE__ */ new Set(), genericEnvironment)] : [];
   });
   return {
     kind: "named",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.65.0",
+  "version": "0.65.1",
   "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.65.0 -->
+<!-- reviewed-through-cli: 0.65.1 -->
 
 # Neo Compose CLI
 

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

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