@neocompose/cli 0.21.3 → 0.21.5

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.21.5] - 2026-08-03
+
+### Fixed
+
+- Non-empty `neo push` rehearsals compile only the code-only member defaults
+  actually reached by canonical constructor replay, so stored animation graphs
+  no longer fail on dependencies such as `Down` that correctly omit derived IR
+  from the trusted source bundle.
+
+## [0.21.4] - 2026-08-03
+
+### Fixed
+
+- `neo pull --reset` emits the canonical `SpriteInfo.Empty` spelling for the
+  required empty-sprite sentinel and does not mistake its empty file id for a
+  missing project file.
+- Parameterized declaration templates compile with their class-header scope
+  without being evaluated before a concrete invocation supplies arguments.
+- Canonical lowering reuses persisted generic argument identities, so a fresh
+  reset remains a semantic no-op instead of creating replacement binding rows.
+
 ## [0.21.3] - 2026-08-03
 
 ### Fixed

package/dist/neo.mjs

@@ -9045,7 +9045,8 @@ var init_strict_resolver = __esm({
             );
           case "call":
             if (expression.callee.kind === "ident" && expression.callee.name === "Reference" && Array.isArray(expression.typeArguments)) {
-              if (expression.typeArguments.length !== 1) {
+              const [referenceTypeArgument] = expression.typeArguments;
+              if (expression.typeArguments.length !== 1 || referenceTypeArgument === void 0) {
                 throw new CompileError(
                   "Reference requires exactly one generic target type.",
                   expression.pos
@@ -9057,7 +9058,7 @@ var init_strict_resolver = __esm({
                   expression.pos
                 );
               }
-              const referencedType = this.resolveType(expression.typeArguments[0]);
+              const referencedType = this.resolveType(referenceTypeArgument);
               if (expected !== void 0 && !isNeoScriptTypeAssignable(referencedType, expected, this.project)) {
                 throw new CompileError(
                   `Reference target ${this.describe(referencedType)} is not assignable to ${this.describe(expected)}.`,
@@ -9111,7 +9112,7 @@ var init_strict_resolver = __esm({
             if (requiredConstructor === null && !callMatchesDeclaredOverloadNames(declared, expression)) {
               this.rejectConstructorProjectionInConstructionBody(expression);
             }
-            const projectionCall = requiredConstructor === null && expression.argumentNames === void 0 && callHasPositionalArguments(expression) && declaredTarget?.constructorSignature !== void 0;
+            const projectionCall = requiredConstructor === null && declaredTarget?.constructorSignature !== void 0 && (expression.argumentNames === void 0 && callHasPositionalArguments(expression) || expression.argumentNames !== void 0 && declaredTarget.constructorSignature.namedProjections !== void 0);
             if (declared.length > 0 && !projectionCall) {
               return this.resolveDeclaredConstructor(
                 className,
@@ -9120,13 +9121,13 @@ var init_strict_resolver = __esm({
                 expression.pos
               );
             }
-            if (expression.argumentNames) {
+            if (expression.argumentNames && !projectionCall) {
               throw new CompileError(
                 "Named constructor arguments require a declaration-aware project source context.",
                 expression.pos
               );
             }
-            if (expression.initializer && expression.initializer.length > 0) {
+            if (expression.initializer && expression.initializer.length > 0 && !projectionCall) {
               throw new CompileError(
                 "Object initializers are available to project source construction and are not executable NeoScript constructors.",
                 expression.pos
@@ -9134,9 +9135,10 @@ var init_strict_resolver = __esm({
             }
             return this.resolveClassConstructor(
               className,
-              expression.args,
+              expression,
               scope,
-              expression.pos
+              expression.pos,
+              expected
             );
           }
           case "annotated":
@@ -10544,7 +10546,7 @@ var init_strict_resolver = __esm({
           type: optional ? { ...delegateType.returnType, nullable: true } : delegateType.returnType
         };
       }
-      resolveClassConstructor(className, argumentsList2, scope, pos) {
+      resolveClassConstructor(className, expression, scope, pos, expected) {
         const schemaClass2 = this.project.typeByName.get(className);
         if (!schemaClass2 || schemaClass2.kind !== "class") {
           throw new CompileError(
@@ -10566,26 +10568,86 @@ var init_strict_resolver = __esm({
             pos
           );
         }
+        const targetType = this.constructorTargetType(
+          schemaClass2,
+          expression,
+          expected
+        );
+        const parameters = signature.parameters.map((parameter3) => ({
+          ...parameter3,
+          valueType: substituteTypeParameters(
+            parameter3.valueType,
+            targetType,
+            schemaClass2
+          ),
+          parameterType: substituteTypeParameters(
+            parameter3.parameterType,
+            targetType,
+            schemaClass2
+          )
+        }));
+        const argumentsList2 = expression.args;
+        const namedProjections = signature.namedProjections;
+        if (expression.argumentNames !== void 0) {
+          if (namedProjections === void 0) {
+            throw new CompileError(
+              `Class '${className}' exposes no named constructor projection.`,
+              pos
+            );
+          }
+          if (argumentsList2.length !== namedProjections.length) {
+            throw new CompileError(
+              `${className} constructor requires ${namedProjections.length} named argument${namedProjections.length === 1 ? "" : "s"} but got ${argumentsList2.length}.`,
+              pos
+            );
+          }
+          if (expression.argumentNames.length !== argumentsList2.length) {
+            throw new CompileError(
+              `${className} constructor projection requires every argument to be named.`,
+              pos
+            );
+          }
+        }
         const requiredCount = signature.parameters.filter(
           (parameter3) => parameter3.required
         ).length;
-        if (argumentsList2.length < requiredCount) {
+        if (expression.argumentNames === void 0 && argumentsList2.length < requiredCount) {
           throw new CompileError(
             `${className} constructor requires ${requiredCount} argument${requiredCount === 1 ? "" : "s"} but got ${argumentsList2.length}.`,
             pos
           );
         }
-        if (argumentsList2.length > signature.parameters.length) {
+        if (expression.argumentNames === void 0 && argumentsList2.length > parameters.length) {
           throw new CompileError(
-            `${className} constructor accepts at most ${signature.parameters.length} argument${signature.parameters.length === 1 ? "" : "s"} but got ${argumentsList2.length}.`,
+            `${className} constructor accepts at most ${parameters.length} argument${parameters.length === 1 ? "" : "s"} but got ${argumentsList2.length}.`,
             pos
           );
         }
         const fields = argumentsList2.map((argument2, index) => {
-          const parameter3 = signature.parameters[index];
+          const projectionName = expression.argumentNames?.[index];
+          const projection = projectionName === void 0 ? void 0 : namedProjections?.find(
+            (candidate) => candidate.name === projectionName
+          );
+          if (projectionName !== void 0 && projection === void 0) {
+            throw new CompileError(
+              `Class '${className}' has no constructor projection named '${projectionName}'.`,
+              argument2.pos
+            );
+          }
+          if (projection !== void 0 && expression.argumentNames?.findIndex(
+            (candidate) => candidate === projection.name
+          ) !== index) {
+            throw new CompileError(
+              `Constructor argument '${projection.name}' is supplied more than once.`,
+              argument2.pos
+            );
+          }
+          const parameter3 = projection === void 0 ? parameters[index] : parameters.find(
+            (candidate) => candidate.memberId === projection.memberId
+          );
           if (!parameter3) {
             throw new Error(
-              `NeoScript constructor ${className} lost parameter ${index + 1} after argument-count validation.`
+              projection === void 0 ? `NeoScript constructor ${className} lost parameter ${index + 1} after argument-count validation.` : `NeoScript constructor ${className} projection '${projection.name}' names missing member '${projection.memberId}'.`
             );
           }
           const value = this.resolveExpression(
@@ -10605,7 +10667,20 @@ var init_strict_resolver = __esm({
             valuePointer: value.pointer
           };
         });
-        const schemaClassInfo = toWireType(signature.returnType, this.project);
+        if (namedProjections !== void 0 && expression.argumentNames !== void 0) {
+          for (const projection of namedProjections) {
+            if (!expression.argumentNames.includes(projection.name)) {
+              throw new CompileError(
+                `${className} constructor is missing named argument '${projection.name}'.`,
+                pos
+              );
+            }
+          }
+        }
+        fields.push(
+          ...this.resolveCallSiteInitializerFields(schemaClass2, expression, scope)
+        );
+        const schemaClassInfo = toWireType(targetType, this.project);
         if (schemaClassInfo.type !== 7 /* Class */) {
           throw new Error(
             `NeoScript constructor ${className} has non-Class return type ${this.describe(signature.returnType)}.`
@@ -10619,10 +10694,35 @@ var init_strict_resolver = __esm({
               info: { schemaClassInfo, fields }
             }
           },
-          type: { ...signature.returnType, nullable: false },
+          type: { ...targetType, nullable: false },
           writability: "session" /* Session */
         };
       }
+      constructorTargetType(schemaClass2, expression, expected) {
+        const typeArguments = expression.typeArguments?.map(
+          (argument2) => this.resolveType(argument2)
+        );
+        if (typeArguments !== void 0 && typeArguments.length !== (schemaClass2.typeParameters?.length ?? 0)) {
+          throw new CompileError(
+            `Class '${schemaClass2.name}' expects ${schemaClass2.typeParameters?.length ?? 0} type argument${schemaClass2.typeParameters?.length === 1 ? "" : "s"} but got ${typeArguments.length}.`,
+            expression.pos
+          );
+        }
+        if (typeArguments !== void 0) {
+          return {
+            kind: "named",
+            typeId: schemaClass2.id,
+            typeArguments
+          };
+        }
+        if (expected?.kind === "named" && expected.typeId === schemaClass2.id) {
+          return { ...expected, nullable: false };
+        }
+        return {
+          kind: "named",
+          typeId: schemaClass2.id
+        };
+      }
       /**
        * P43 §7.1. P29's `new T(id: "…")` projection names a class-default row,
        * which is exactly the wrong identity inside a construction body: member
@@ -44500,7 +44600,13 @@ function lowerFieldMember(context, ownerClass, declaration, id2, commonInput, ba
       classId,
       ...partial ? { partial: true } : {},
       schemaKeyOrder: base?.kind === "class" ? base.schemaKeyOrder : null,
-      classArguments: lowerClassArguments(context, ownerClass, id2, fieldType)
+      classArguments: lowerClassArguments(
+        context,
+        ownerClass,
+        id2,
+        fieldType,
+        base?.kind === "class" ? base.classArguments : void 0
+      )
     };
   }
   throw new Error(
@@ -45575,7 +45681,7 @@ function genericParameterName(context, genericParamId) {
   }
   return "object";
 }
-function lowerClassArguments(context, ownerClass, ownerMemberId, type) {
+function lowerClassArguments(context, ownerClass, ownerMemberId, type, baseArguments) {
   const classId = context.classIdsByName.get(type.name);
   if (!classId) return {};
   const parameters = [
@@ -45591,7 +45697,8 @@ function lowerClassArguments(context, ownerClass, ownerMemberId, type) {
       result[parameterId] = { kind: "generic", genericParamId: ownerParameter };
       continue;
     }
-    const memberId = derivedGenericArgumentMemberId(ownerMemberId, parameterId);
+    const baseBinding = baseArguments?.[parameterId];
+    const memberId = baseBinding?.kind === "member" ? baseBinding.memberId : derivedGenericArgumentMemberId(ownerMemberId, parameterId);
     result[parameterId] = { kind: "member", memberId };
     lowerGenericArgument(
       context,
@@ -45611,6 +45718,7 @@ function lowerExtendsBindings(context, declaration, baseClassId, argumentsValue)
   ];
   const result = {};
   const declarationId = materializedId(declaration, "class", declaration.name);
+  const baseBindings = context.baseClasses.get(declarationId)?.extendsGenericBindings ?? {};
   for (const [[parameterName, parameterId], argumentType] of zip(
     parameters,
     argumentsValue
@@ -45620,7 +45728,8 @@ function lowerExtendsBindings(context, declaration, baseClassId, argumentsValue)
       result[parameterId] = { kind: "generic", genericParamId: local };
       continue;
     }
-    const memberId = derivedGenericArgumentMemberId(declarationId, parameterId);
+    const baseBinding = baseBindings[parameterId];
+    const memberId = baseBinding?.kind === "member" ? baseBinding.memberId : derivedGenericArgumentMemberId(declarationId, parameterId);
     result[parameterId] = { kind: "member", memberId };
     lowerGenericArgument(
       context,
@@ -47646,6 +47755,15 @@ function renderDefaultValue(context, member, wrapper) {
         `${member.kind === "sprite" ? "Sprite" : "Audio"} member ${JSON.stringify(member.name)} default stores a file value with no fileId. Emitting it as null would delete the default on the next push.`
       );
     }
+    if (value.fileId.length === 0) {
+      const sliceIndex = typeof value.sliceIndex === "number" ? value.sliceIndex : 0;
+      if (member.kind === "sprite" && sliceIndex === 0) {
+        return "SpriteInfo.Empty";
+      }
+      throw new Error(
+        `${member.kind === "sprite" ? "Sprite" : "Audio"} member ${JSON.stringify(member.name)} default stores an invalid empty file value.`
+      );
+    }
     const symbol = context.fileSymbols.get(value.fileId);
     const target = symbol ?? (member.kind === "sprite" ? `Reference<NeoImage>(id: ${quote(value.fileId)})` : `Reference<NeoAudioClip>(id: ${quote(value.fileId)})`);
     return member.kind === "sprite" ? `${target}.Slice(${typeof value.sliceIndex === "number" ? value.sliceIndex : 0})` : target;
@@ -48582,6 +48700,7 @@ function validateFinalizedFileAssignmentsV4(records2, options = {}) {
       return;
     }
     if (!isObjectRecord2(value)) return;
+    if (isEmptySpriteValue(value)) return;
     if (isStructuredLeafPartialValue(value)) {
       visitSpriteFileField(
         value[STRUCTURED_LEAF_PARTIAL_KEY].fileId,
@@ -52582,7 +52701,10 @@ function classToLanguageType(schemaClass2, context) {
 }
 function constructorSignature(schemaClass2, members, context, genericEnvironment) {
   if (schemaClass2.isAbstract) return {};
-  if (!isClosedClass(schemaClass2.id, context.vm.classes)) return {};
+  const projections = inheritedConstructorProjections(schemaClass2, context);
+  if (projections.length === 0 && !isClosedClass(schemaClass2.id, context.vm.classes)) {
+    return {};
+  }
   if (resolveAllowedStorage(schemaClass2.id, context.vm.classes) === "immutable" /* Immutable */) {
     return { constructorUnavailableReason: "immutableOnly" };
   }
@@ -52603,11 +52725,43 @@ function constructorSignature(schemaClass2, members, context, genericEnvironment
           defaultValue: "defaultValue" in resolved ? resolved.defaultValue : void 0
         };
       } catch {
+        if (projections.some((projection) => projection.memberId === memberId)) {
+          return { required: true };
+        }
         return null;
       }
     }
   );
-  return { constructorSignature: signature };
+  return {
+    constructorSignature: {
+      ...signature,
+      ...projections.length === 0 ? {} : {
+        namedProjections: projections.map((projection) => ({
+          name: projection.parameterName,
+          memberId: projection.memberId
+        }))
+      }
+    }
+  };
+}
+function inheritedConstructorProjections(schemaClass2, context) {
+  const classesById = new Map(
+    context.vm.classes.map((candidate) => [candidate.id, candidate])
+  );
+  const projections = [];
+  const claimed = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  let current = schemaClass2;
+  while (current !== void 0 && !visited.has(current.id)) {
+    visited.add(current.id);
+    for (const projection of current.constructorProjections ?? []) {
+      if (claimed.has(projection.parameterName)) continue;
+      claimed.add(projection.parameterName);
+      projections.push(projection);
+    }
+    current = current.extendsClassId ? classesById.get(current.extendsClassId) : void 0;
+  }
+  return projections;
 }
 function declaredConstructors(schemaClass2, context) {
   const requiredConstructorId2 = schemaClass2.requiredConstructorId;
@@ -54316,13 +54470,37 @@ function throwNamedBodyCompileFailure(args) {
   });
 }
 function resolveMemberDeclaredTypeInfo(member, members) {
+  return resolveMemberDeclaredTypeInfoInternal(member, members, /* @__PURE__ */ new Set());
+}
+function resolveMemberDeclaredTypeInfoInternal(member, members, seen) {
   const resolved = resolveMember2(member, members);
+  const memberId = getField(resolved, "id");
+  if (typeof memberId === "string" && seen.has(memberId)) return null;
+  const nextSeen = typeof memberId === "string" ? /* @__PURE__ */ new Set([...seen, memberId]) : new Set(seen);
   if (isMemberNSPropertyBase(resolved)) return resolved.returnTypeInfo;
   if (isMemberClassBase(resolved)) {
+    const typeArguments = Object.fromEntries(
+      Object.entries(resolved.classArguments ?? {}).flatMap(
+        ([genericParamId, binding]) => {
+          if (binding.kind !== "member") return [];
+          const argumentMember = members.find(
+            (candidate) => candidate.id === binding.memberId
+          );
+          if (argumentMember === void 0) return [];
+          const argumentType = resolveMemberDeclaredTypeInfoInternal(
+            argumentMember,
+            members,
+            nextSeen
+          );
+          return argumentType === null ? [] : [[genericParamId, { ...argumentType, required: true }]];
+        }
+      )
+    );
     return {
       type: 7 /* Class */,
       required: resolved.required,
-      classId: resolved.classId
+      classId: resolved.classId,
+      ...Object.keys(typeArguments).length === 0 ? {} : { typeArguments }
     };
   }
   if (isMemberEnumBase(resolved)) {
@@ -54349,7 +54527,11 @@ function resolveMemberDeclaredTypeInfo(member, members) {
       (candidate) => candidate.id === resolved.entryMemberId
     );
     if (entry === void 0) return null;
-    const entryTypeInfo = resolveMemberDeclaredTypeInfo(entry, members);
+    const entryTypeInfo = resolveMemberDeclaredTypeInfoInternal(
+      entry,
+      members,
+      nextSeen
+    );
     if (entryTypeInfo === null) return null;
     return {
       type: resolved.kind,
@@ -54365,7 +54547,7 @@ function resolveMemberDeclaredTypeInfo(member, members) {
     if (collection === void 0) return null;
     return lookupDeclaredTypeInfo(
       resolved,
-      resolveMemberDeclaredTypeInfo(collection, members)
+      resolveMemberDeclaredTypeInfoInternal(collection, members, nextSeen)
     );
   }
   if (!memberKindSupportsStorage(resolved.kind)) return null;
@@ -55230,7 +55412,7 @@ var init_constructor_argument_ownership = __esm({
 });
 
 // ../src/view-models/neoscript-evaluator/NSGetterRuntimeError.ts
-var NSGetterRuntimeError;
+var NSGetterRuntimeError, UncompiledInitializerRuntimeError;
 var init_NSGetterRuntimeError = __esm({
   "../src/view-models/neoscript-evaluator/NSGetterRuntimeError.ts"() {
     "use strict";
@@ -55240,6 +55422,16 @@ var init_NSGetterRuntimeError = __esm({
         this.name = "NSGetterRuntimeError";
       }
     };
+    UncompiledInitializerRuntimeError = class extends NSGetterRuntimeError {
+      constructor(memberId, memberName) {
+        super(
+          `Initializer for '${memberName}' has no compiled body; push the project so the server compiles it.`
+        );
+        this.memberId = memberId;
+        this.name = "UncompiledInitializerRuntimeError";
+      }
+      memberId;
+    };
   }
 });
 
@@ -56162,7 +56354,7 @@ var init_project2 = __esm({
 
 // ../src/view-models/neoscript-evaluator/evaluateNSGetter.ts
 function isCatchableNSRuntimeError(error) {
-  return error instanceof NSGetterRuntimeError && !(error instanceof NonCatchableNSGetterRuntimeError);
+  return error instanceof NSGetterRuntimeError && !(error instanceof UncompiledInitializerRuntimeError) && !(error instanceof NonCatchableNSGetterRuntimeError);
 }
 function makeEvaluatorLookups(members, values, options = {}) {
   const attrMap = /* @__PURE__ */ new Map();
@@ -60912,8 +61104,10 @@ function evaluateInitializerInContext(init, member, ctx, createdValues, argument
   ctx.__constructedArgumentsByValue ??= /* @__PURE__ */ new WeakMap();
   const compiled = init.compiled;
   if (compiled === void 0) {
-    throw new NSGetterRuntimeError(
-      `Initializer for '${member.name}' has no compiled body; push the project so the server compiles it.`
+    const memberId = Reflect.get(member, "id");
+    throw new UncompiledInitializerRuntimeError(
+      typeof memberId === "string" ? memberId : null,
+      member.name
     );
   }
   const closeFrame = pushConstructionFrame(ctx, `${member.name} initializer`);
@@ -62343,8 +62537,9 @@ function buildInitializerRootValue(document) {
 function evaluateMemberInitializer(args) {
   const compiled = args.init.compiled;
   if (compiled === void 0) {
-    throw new NSGetterRuntimeError(
-      `Initializer for '${args.member.name}' has no compiled body; push the project so the server compiles it.`
+    throw new UncompiledInitializerRuntimeError(
+      typeof Reflect.get(args.member, "id") === "string" ? Reflect.get(args.member, "id") : null,
+      args.member.name
     );
   }
   const ctx = {
@@ -75250,24 +75445,7 @@ var init_server_preparation_preflight = __esm({
 function replayStoredConstructionV4(args) {
   const document = args.document ?? readPulledProjectDocumentV4(args.records);
   if (args.compileDocumentBodies === true) {
-    const compileArgs = {
-      project: document.project,
-      projectFiles: document.projectFiles,
-      members: document.members,
-      classes: document.classes,
-      enums: document.enums,
-      interfaces: document.interfaces,
-      constructors: document.constructors ?? []
-    };
-    for (const constructor2 of compileArgs.constructors) {
-      compileConstructorRecord({ ...compileArgs, constructor: constructor2 });
-    }
-    for (const member of compileArgs.members) {
-      const thisClass = compileArgs.classes.find(
-        (schemaClass2) => Object.values(schemaClass2.schema).includes(member.id)
-      ) ?? null;
-      compileAuthoredMemberBodies({ ...compileArgs, member, thisClass });
-    }
+    compilePulledProjectDocumentBodiesV4(document);
   }
   const root = document.values.find((value) => value.id === args.valueId);
   if (root === void 0) {
@@ -75316,22 +75494,36 @@ function replayStoredConstructionV4(args) {
     member: compileMember,
     valueRow: candidate,
     valueId: args.valueId,
-    // P61 instance calls are self-contained and never inherit a declaration's
-    // required-constructor parameter envelope.
-    initializerOwnerClass: null
+    // Instance calls are self-contained. Declaration calls inherit the class
+    // header parameters that are in lexical scope at their source site.
+    initializerOwnerClass: args.initializerOwnerClass ?? null
   });
   if (!isMemberValue(candidate) || !isInitValueContent(candidate)) {
     throw new Error(
       `Construction replay for value "${args.valueId}" did not compile an initializer row.`
     );
   }
-  const materialized = materializeInitializerValue({
-    document,
-    // Constructor-only rows have no structural member owner. Use the same
-    // explicit typed descriptor for evaluation that compiled the replay.
-    member: compileMember,
-    row: candidate
-  });
+  if (args.evaluate === false) return /* @__PURE__ */ new Map();
+  const compiledDependencies = /* @__PURE__ */ new Set();
+  let materialized;
+  for (; ; ) {
+    try {
+      materialized = materializeInitializerValue({
+        document,
+        // Constructor-only rows have no structural member owner. Use the same
+        // explicit typed descriptor for evaluation that compiled the replay.
+        member: compileMember,
+        row: candidate
+      });
+      break;
+    } catch (error) {
+      if (!(error instanceof UncompiledInitializerRuntimeError) || error.memberId === null || compiledDependencies.has(error.memberId)) {
+        throw error;
+      }
+      compilePulledMemberInitializerBodyV4(document, error.memberId);
+      compiledDependencies.add(error.memberId);
+    }
+  }
   return new Map(
     [materialized.root, ...materialized.createdValues].map((row) => [
       row.id,
@@ -75339,6 +75531,59 @@ function replayStoredConstructionV4(args) {
     ])
   );
 }
+function compilePulledProjectDocumentBodiesV4(document) {
+  const compileArgs = {
+    project: document.project,
+    projectFiles: document.projectFiles,
+    members: document.members,
+    classes: document.classes,
+    enums: document.enums,
+    interfaces: document.interfaces,
+    constructors: document.constructors ?? []
+  };
+  for (const constructor2 of compileArgs.constructors) {
+    compileConstructorRecord({ ...compileArgs, constructor: constructor2 });
+  }
+  const ownerClassByMemberId = new Map(
+    compileArgs.classes.flatMap(
+      (schemaClass2) => Object.values(schemaClass2.schema).map(
+        (memberId) => [memberId, schemaClass2]
+      )
+    )
+  );
+  for (const member of compileArgs.members) {
+    compileAuthoredMemberBodies({
+      ...compileArgs,
+      member,
+      thisClass: ownerClassByMemberId.get(member.id) ?? null
+    });
+  }
+}
+function compilePulledMemberInitializerBodyV4(document, memberId) {
+  const compileArgs = {
+    project: document.project,
+    projectFiles: document.projectFiles,
+    members: document.members,
+    classes: document.classes,
+    enums: document.enums,
+    interfaces: document.interfaces,
+    constructors: document.constructors ?? []
+  };
+  const member = compileArgs.members.find((entry) => entry.id === memberId);
+  if (member === void 0) {
+    throw new Error(
+      `Cannot compile initializer dependency for missing member "${memberId}".`
+    );
+  }
+  const thisClass = compileArgs.classes.find(
+    (schemaClass2) => Object.values(schemaClass2.schema).includes(memberId)
+  ) ?? null;
+  compileMemberInitializerBody({
+    ...compileArgs,
+    member,
+    thisClass
+  });
+}
 function readPulledProjectDocumentV4(records2) {
   return readProjectDocument(
     pulledProjectDocumentRaw(replayWorkspace(records2))
@@ -75381,6 +75626,7 @@ var init_initializer_replay = __esm({
     init_project_document_read();
     init_server_preparation_preflight();
     init_projection();
+    init_neoscript_evaluator();
   }
 });
 
@@ -76434,7 +76680,7 @@ function lowerRowBackedDefault(context, member, backed, baseData3, binding) {
     const assignmentSlices = objectInitializerSlices(binding.initializer);
     for (const assignment of expression.initializer ?? []) {
       const childMember = classMemberByName(context, classId, assignment.name);
-      if (inheritedConstructorProjections(context.classes, schemaClass2.id).some(
+      if (inheritedConstructorProjections2(context.classes, schemaClass2.id).some(
         (projection) => projection.memberId === childMember.id
       )) {
         throw new Error(
@@ -76847,7 +77093,7 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
         effectiveClass.id,
         assignment.name
       );
-      if (inheritedConstructorProjections(
+      if (inheritedConstructorProjections2(
         context.classes,
         effectiveClass.id
       ).some((projection) => projection.memberId === childMember.id)) {
@@ -77145,15 +77391,17 @@ function lowerValueRow(context, member, sourceExpression, expectedValueId, sourc
           `Value ${expectedValueId} stores constructor arguments but its declared member ${resolvedMember.name} is not a Class.`
         );
       }
-      context.initializerReconciliations.set(expectedValueId, {
-        valueId: expectedValueId,
-        code,
-        storedConstructorArgs: storedConstructorArgs === null ? null : structuredClone(storedConstructorArgs),
-        settleFields: expression.kind === "new" ? (expression.initializer ?? []).map(
-          (assignment) => assignment.name
-        ) : [],
-        site: referenceSite(source, expression)
-      });
+      if (source.purpose === "stored") {
+        context.initializerReconciliations.set(expectedValueId, {
+          valueId: expectedValueId,
+          code,
+          storedConstructorArgs: storedConstructorArgs === null ? null : structuredClone(storedConstructorArgs),
+          settleFields: expression.kind === "new" ? (expression.initializer ?? []).map(
+            (assignment) => assignment.name
+          ) : [],
+          site: referenceSite(source, expression)
+        });
+      }
       const value2 = lowerClassValue(
         context,
         resolvedMember,
@@ -77348,7 +77596,7 @@ function lowerClassValue(context, member, expression, base, source, outerEnviron
   }
   for (const assignment of expression.initializer ?? []) {
     const childMember = classMemberByName(context, classId, assignment.name);
-    if (inheritedConstructorProjections(context.classes, schemaClass2.id).some(
+    if (inheritedConstructorProjections2(context.classes, schemaClass2.id).some(
       (projection) => projection.memberId === childMember.id
     )) {
       throw new Error(
@@ -77530,7 +77778,7 @@ function classInheritanceChain(classes, classId) {
   }
   return chain;
 }
-function inheritedConstructorProjections(classes, classId) {
+function inheritedConstructorProjections2(classes, classId) {
   const resolved = [];
   const claimed = /* @__PURE__ */ new Set();
   for (const schemaClass2 of classInheritanceChain(classes, classId)) {
@@ -77551,7 +77799,7 @@ function inheritedProjectionSchemaKey(classes, classId, memberId) {
   return null;
 }
 function resolveConstructorProjectionArguments(context, schemaClass2, expression, ownerValueId, environment, source) {
-  const projections = inheritedConstructorProjections(
+  const projections = inheritedConstructorProjections2(
     context.classes,
     schemaClass2.id
   );
@@ -79856,7 +80104,7 @@ function manifestMemberTypeName(context, member) {
   return fixedSourceTypeNameForKind(member.kind) ?? member.kind;
 }
 function constructorProjectionSource(context, classId, body, visited, environment) {
-  const projections = inheritedConstructorProjections(
+  const projections = inheritedConstructorProjections2(
     context.manifestClasses,
     classId
   );
@@ -84019,11 +84267,12 @@ function replayAnimationDeclarationInitializersV4(records2, document) {
   });
   if (initializers.length === 0) return document;
   const rootKinds = /* @__PURE__ */ new Map();
+  const rootOwners = /* @__PURE__ */ new Map();
   const owners = resolveOwnerMembersForValues(
     document,
     new Set(initializers.map(({ row }) => row.id)),
     void 0,
-    void 0,
+    rootOwners,
     rootKinds
   );
   const pulled = /* @__PURE__ */ new Map();
@@ -84048,12 +84297,20 @@ function replayAnimationDeclarationInitializersV4(records2, document) {
     if (!classBelongsToAnimationFamily(document.classes, declaredClassId)) {
       continue;
     }
+    const rootOwner = rootOwners.get(row.id);
+    const rootOwnerId = Reflect.get(rootOwner ?? {}, "id");
+    const initializerOwnerClass = typeof rootOwnerId !== "string" ? null : findSchemaPlacement(rootOwnerId, document.classes)?.ownerClass ?? null;
     const replay = replayStoredConstructionV4({
       records: pulled,
       valueId: row.id,
       code,
       member: owner,
-      compileDocumentBodies: true
+      compileDocumentBodies: true,
+      initializerOwnerClass,
+      // A parameterized declaration is a template. Its arguments exist only
+      // at concrete construction sites, so validate the authored body here
+      // without fabricating values for the class header parameters.
+      evaluate: initializerOwnerClass?.requiredConstructorId === void 0 || initializerOwnerClass.requiredConstructorId === null
     });
     for (const [id2, value] of replay) {
       if (!isMemberValue(value)) {
@@ -84437,6 +84694,7 @@ var init_workspace_status = __esm({
     init_project_documents();
     init_animation_clips();
     init_classes();
+    init_inheritance();
     init_members();
     init_value_row_owner_members();
     init_project2();

package/package.json

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

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

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