@neocompose/cli 0.24.7 → 0.24.9

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.24.9] - 2026-08-08
+
+### Fixed
+
+- Build `neo test` execution documents from the server-prepared candidate and
+  compile every remaining authored initializer into evaluator-only IR. Tests
+  can now construct classes whose pending idless list rows capture lexical
+  selectors without requiring an earlier push.
+- Index constructor-initializer ownership by class and member instead of
+  repeatedly scanning the project document. This reduces Neowyn's
+  initializer-owner walk from 87.8 ms to 24.9 ms median.
+
+## [0.24.8] - 2026-08-08
+
+### Fixed
+
+- Preserve generated Generic-slot initializers while closing their concrete
+  type. `NeoAnimationSegmentFrame<int>(value: 60)` now materializes `Value` as
+  `60` instead of replacing the initializer with the Int binding's fallback
+  `0`, keeping local and server construction graphs identical.
+- Keep constructor-pane preview graphs stable while runtime values change, and
+  invalidate each animation segment lane only from the value rows that its
+  getter actually reads. Direction changes update the affected leaves without
+  reconstructing the ephemeral character graph.
+
 ## [0.24.7] - 2026-08-08
 
 ### Fixed

package/dist/neo.mjs

@@ -40044,6 +40044,9 @@ function substituteMember(member, env, members) {
       accessModifierKind: resolved.accessModifierKind,
       system: resolved.system ?? void 0
     };
+    if (resolved.defaultValue !== void 0) {
+      substituted.defaultValue = resolved.defaultValue;
+    }
     const slotId = getOptionalString(member, "id");
     if (slotId !== void 0) {
       substituted.id = slotId;
@@ -54907,6 +54910,14 @@ function resolveOwnerMembersForValues(document, targetValueIds, additionalRoots,
   const resolved = /* @__PURE__ */ new Map();
   if (targetValueIds.size === 0) return resolved;
   const valuesById = new Map(document.values.map((value) => [value.id, value]));
+  const membersById = new Map(
+    document.members.map((member) => [member.id, member])
+  );
+  const classesById = new Map(
+    document.classes.map((schemaClass2) => [schemaClass2.id, schemaClass2])
+  );
+  const storedSchemaByClassId = /* @__PURE__ */ new Map();
+  const defaultInstanceEnvByClassId = /* @__PURE__ */ new Map();
   const rowsByContainerId = /* @__PURE__ */ new Map();
   for (const value of document.values) {
     if (typeof value.containerId !== "string") continue;
@@ -54930,7 +54941,25 @@ function resolveOwnerMembersForValues(document, targetValueIds, additionalRoots,
     if (typeof memberId !== "string") return /* @__PURE__ */ new Map();
     const classId = declaringClassIdByMemberId.get(memberId);
     if (classId === void 0) return /* @__PURE__ */ new Map();
-    return resolveInstanceEnv(classId, void 0, document.classes);
+    return defaultInstanceEnv(classId);
+  }
+  function defaultInstanceEnv(classId) {
+    const cached = defaultInstanceEnvByClassId.get(classId);
+    if (cached !== void 0) return cached;
+    const created = resolveInstanceEnv(classId, void 0, document.classes);
+    defaultInstanceEnvByClassId.set(classId, created);
+    return created;
+  }
+  function storedSchema(classId) {
+    const cached = storedSchemaByClassId.get(classId);
+    if (cached !== void 0) return cached;
+    const created = mergeStoredInstanceSchema(
+      classId,
+      document.classes,
+      document.members
+    );
+    storedSchemaByClassId.set(classId, created);
+    return created;
   }
   function searchRow(member, valueId, rootOwner, env, rootKind) {
     if (targetValueIds.has(valueId) && !resolved.has(valueId)) {
@@ -54969,16 +54998,10 @@ function resolveOwnerMembersForValues(document, targetValueIds, additionalRoots,
     if (isMemberClassBase(member)) {
       if (!isRecordValue(body.value)) return;
       const effectiveClassId = body.classId ?? member.classId;
-      const schemaClass2 = document.classes.find(
-        (candidate) => candidate.id === effectiveClassId
-      );
+      const schemaClass2 = classesById.get(effectiveClassId);
       if (schemaClass2 === void 0) return;
-      const merged = mergeStoredInstanceSchema(
-        effectiveClassId,
-        document.classes,
-        document.members
-      );
-      const env = resolveInstanceEnv(
+      const merged = storedSchema(effectiveClassId);
+      const env = member.classArguments === void 0 || member.classArguments === null ? defaultInstanceEnv(effectiveClassId) : resolveInstanceEnv(
         effectiveClassId,
         member.classArguments,
         document.classes
@@ -54987,9 +55010,7 @@ function resolveOwnerMembersForValues(document, targetValueIds, additionalRoots,
         if (entry.memberId === null) continue;
         const childValueId = body.value[entry.schemaKey];
         if (childValueId === void 0) continue;
-        const childMember = document.members.find(
-          (candidate) => candidate.id === entry.memberId
-        );
+        const childMember = membersById.get(entry.memberId);
         if (childMember === void 0) continue;
         const substituted = trySubstituteMember(childMember, env);
         if (substituted === null) continue;
@@ -54999,9 +55020,7 @@ function resolveOwnerMembersForValues(document, targetValueIds, additionalRoots,
     }
     if (isMemberDictionaryBase(member)) {
       if (!isRecordValue(body.value)) return;
-      const entryMemberRecord = document.members.find(
-        (candidate) => candidate.id === member.entryMemberId
-      );
+      const entryMemberRecord = membersById.get(member.entryMemberId);
       if (entryMemberRecord === void 0) return;
       const entryEnv = overlayStamp(ambientEnv, body.genericBindings);
       const entryMember = trySubstituteMember(entryMemberRecord, entryEnv);
@@ -55012,9 +55031,7 @@ function resolveOwnerMembersForValues(document, targetValueIds, additionalRoots,
       return;
     }
     if (isMemberListBase(member)) {
-      const entryMemberRecord = document.members.find(
-        (candidate) => candidate.id === member.entryMemberId
-      );
+      const entryMemberRecord = membersById.get(member.entryMemberId);
       if (entryMemberRecord === void 0) return;
       const entryEnv = overlayStamp(ambientEnv, body.genericBindings);
       const entryMember = trySubstituteMember(entryMemberRecord, entryEnv);
@@ -56638,7 +56655,8 @@ function evalMemberById(vm, id2) {
   if (vm.databaseVM?.memberById) return vm.databaseVM.memberById(id2);
   return vm.members.find((a) => a.id === id2) ?? null;
 }
-function evalValueById(vm, id2, runtimeValues, overlayValues) {
+function evalValueById(ctx, id2, runtimeValues, overlayValues) {
+  const vm = ctx.vm;
   const runtime = runtimeValues?.get(id2);
   if (runtime !== void 0) return runtime;
   const overlay = overlayValues?.get(id2);
@@ -56908,7 +56926,7 @@ function evaluatorOwnershipDistances(rowId, indexes) {
 }
 function resolveRuntimeReferenceRow(sourceValueId, ctx) {
   const direct = evalValueById(
-    ctx.vm,
+    ctx,
     sourceValueId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -57347,7 +57365,7 @@ function finalizeConstructorAllocations(ctx, returnValue, ownsInvocationState, r
     if (scannedRows.has(valueId)) return;
     scannedRows.add(valueId);
     const row = evalValueById(
-      ctx.vm,
+      ctx,
       valueId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -57357,7 +57375,7 @@ function finalizeConstructorAllocations(ctx, returnValue, ownsInvocationState, r
       const { id: argumentId, typeInfo } = argument2;
       if (groupByRowId.has(argumentId)) scanOwnedRow(argumentId);
       const argumentRow = evalValueById(
-        ctx.vm,
+        ctx,
         argumentId,
         ctx.__runtimeSessionValues,
         ctx.__valueOverlay
@@ -58210,7 +58228,7 @@ function applyOverlayAssignment(target, targetTypeInfo, value, scope, ctx) {
     const existing2 = receiver[index];
     if (typeof existing2 === "string") {
       const row = evalValueById(
-        ctx.vm,
+        ctx,
         existing2,
         ctx.__runtimeSessionValues,
         ctx.__valueOverlay
@@ -58247,7 +58265,7 @@ function applyOverlayAssignment(target, targetTypeInfo, value, scope, ctx) {
   const existing = object2[stringKey];
   if (typeof existing === "string") {
     const row = evalValueById(
-      ctx.vm,
+      ctx,
       existing,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -58297,7 +58315,7 @@ function applyOverlayStaticAssignment(memberId, value, ctx) {
   }
   if (!referenceAssignment && currentId !== null) {
     const row2 = evalValueById(
-      ctx.vm,
+      ctx,
       currentId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -58803,7 +58821,7 @@ function evalStaticMember(memberId, ctx) {
     return null;
   }
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     targetId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -58813,6 +58831,7 @@ function evalStaticMember(memberId, ctx) {
       `Static member '${member.name}' is bound to missing value '${targetId}'.`
     );
   }
+  ctx.valueDependencies?.add(row.id);
   return row.value;
 }
 function evalPointer(pointer, scope, ctx) {
@@ -59098,7 +59117,7 @@ function invokeDelegateValue(value, args, ctx, callSiteId) {
   let receiver = null;
   if (value.valueId !== null) {
     const row = evalValueById(
-      ctx.vm,
+      ctx,
       value.valueId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -59225,7 +59244,7 @@ function delegateClosureLexicalThis(closure, ctx) {
   )) {
     if (ancestorId === closureRow.id) continue;
     const ancestor = evalValueById(
-      ctx.vm,
+      ctx,
       ancestorId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -59371,7 +59390,7 @@ function runtimeParentGenericEnv(row, ctx, visited) {
   const result = /* @__PURE__ */ new Map();
   for (const link of evaluatorParentLinks(evaluatorIndexes(ctx), row.id)) {
     const parent = evalValueById(
-      ctx.vm,
+      ctx,
       link.parentId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -60042,12 +60061,13 @@ function resolveAssetRuntimeMember(receiver, memberName, ctx) {
 function resolveValueIfId(at, ctx) {
   if (typeof at !== "string") return at;
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     at,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
   );
   if (!row) return at;
+  ctx.valueDependencies?.add(row.id);
   const member = memberForValueRow(row, ctx);
   const value = member === null ? resolveLocalizedRowValue(row, ctx) : resolveLocalizedRowValueForMember(row, member, ctx);
   return shouldUnwrapSingleLookupValue(member) ? unwrapSingleLookupValue(value, ctx) : value;
@@ -60055,12 +60075,13 @@ function resolveValueIfId(at, ctx) {
 function resolveValueIfIdForMember(at, member, ctx) {
   if (typeof at !== "string") return at;
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     at,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
   );
   if (!row) return at;
+  ctx.valueDependencies?.add(row.id);
   const value = resolveLocalizedRowValueForMember(row, member, ctx);
   return shouldUnwrapSingleLookupValue(member) ? unwrapSingleLookupValue(value, ctx) : value;
 }
@@ -60072,12 +60093,15 @@ function shouldUnwrapSingleLookupValue(member) {
 function unwrapSingleLookupValue(value, ctx) {
   if (Array.isArray(value) && value.length === 1 && typeof value[0] === "string") {
     const next = evalValueById(
-      ctx.vm,
+      ctx,
       value[0],
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
     );
-    if (next) return next.value;
+    if (next) {
+      ctx.valueDependencies?.add(next.id);
+      return next.value;
+    }
   }
   return value;
 }
@@ -60118,7 +60142,7 @@ function resolveMemberForValueRow(row, ctx, visited) {
   }
   for (const link of evaluatorParentLinks(indexes, row.id)) {
     const parent = evalValueById(
-      ctx.vm,
+      ctx,
       link.parentId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -60443,7 +60467,7 @@ function evalDeclaredListIndex(info, scope, ctx) {
     for (const valueId of collection) {
       if (typeof valueId !== "string") continue;
       const row = evalValueById(
-        ctx.vm,
+        ctx,
         valueId,
         ctx.__runtimeSessionValues,
         ctx.__valueOverlay
@@ -61028,7 +61052,7 @@ function applyConstructorFields(args) {
     const trackedValueId = findKnownRowIdByValueReference(value, ctx);
     if (trackedValueId !== null && isMemberClassBase(member)) {
       const source = evalValueById(
-        ctx.vm,
+        ctx,
         trackedValueId,
         ctx.__runtimeSessionValues,
         ctx.__valueOverlay
@@ -61139,7 +61163,7 @@ function bindConstructedDelegateTargets(rootId, ctx) {
     if (rowId === void 0 || visited.has(rowId)) continue;
     visited.add(rowId);
     const row = evalValueById(
-      ctx.vm,
+      ctx,
       rowId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -61171,7 +61195,7 @@ function bindConstructedDelegateTargets(rootId, ctx) {
       indexes
     )) {
       const ancestor = evalValueById(
-        ctx.vm,
+        ctx,
         ancestorId,
         ctx.__runtimeSessionValues,
         ctx.__valueOverlay
@@ -62318,7 +62342,7 @@ function constructDeclaredClassValueWithinFrame(descriptor, record3, info, scope
 }
 function assertOwnedValueAttachable(valueId, destination, destinationName2, ctx, reserveUntilPublished = false) {
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     valueId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -62364,7 +62388,7 @@ function currentOwnedValueAttachments(valueId, ctx) {
     found.set(attachment.identity, attachment);
   };
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     valueId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -62401,7 +62425,7 @@ function currentOwnedValueAttachments(valueId, ctx) {
   );
   for (const parentId of parentIds) {
     const parent = evalValueById(
-      ctx.vm,
+      ctx,
       parentId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -62469,7 +62493,7 @@ function constructorArgumentStorage(valueId, ctx, visiting = /* @__PURE__ */ new
   if (visiting.has(valueId)) return null;
   visiting.add(valueId);
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     valueId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -62491,7 +62515,7 @@ function constructorArgumentStorage(valueId, ctx, visiting = /* @__PURE__ */ new
   const parentIds = /* @__PURE__ */ new Set();
   for (const owner of currentOwnedValueAttachments(valueId, ctx)) {
     if (evalValueById(
-      ctx.vm,
+      ctx,
       owner.label,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -62601,7 +62625,7 @@ function cloneConstructorArgumentGraph(args) {
           args.ctx
         );
         const child = evalValueById(
-          args.ctx.vm,
+          args.ctx,
           childId,
           args.ctx.__runtimeSessionValues,
           args.ctx.__valueOverlay
@@ -62637,7 +62661,7 @@ function cloneConstructorArgumentGraph(args) {
           );
         }
         const child = evalValueById(
-          args.ctx.vm,
+          args.ctx,
           childId,
           args.ctx.__runtimeSessionValues,
           args.ctx.__valueOverlay
@@ -62684,7 +62708,7 @@ function cloneConstructorArgumentGraph(args) {
           );
         }
         const child = evalValueById(
-          args.ctx.vm,
+          args.ctx,
           childId,
           args.ctx.__runtimeSessionValues,
           args.ctx.__valueOverlay
@@ -62726,7 +62750,7 @@ function materializeConstructorArgumentValue(args) {
     }
     if (trackedValueId !== null) {
       const tracked = evalValueById(
-        args.ctx.vm,
+        args.ctx,
         trackedValueId,
         args.ctx.__runtimeSessionValues,
         args.ctx.__valueOverlay
@@ -62909,7 +62933,7 @@ function assertConstructorClassValueAdmitted(args) {
 function constructorCollectionEntryValue(value, ctx, resolveStoredId) {
   if (!resolveStoredId || typeof value !== "string") return value;
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     value,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -62959,7 +62983,7 @@ function cloneClassValueGraph(receiver, expectedClassId, ctx) {
     );
   }
   const source = evalValueById(
-    ctx.vm,
+    ctx,
     sourceId3,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -63024,7 +63048,7 @@ function cloneClassValueGraph(receiver, expectedClassId, ctx) {
         const childTypeInfo = sourceTypeInfo?.type === 5 /* Dictionary */ ? sourceTypeInfo.entryTypeInfo : void 0;
         if (childMember === null && childTypeInfo === void 0) continue;
         const child = evalValueById(
-          ctx.vm,
+          ctx,
           childId,
           ctx.__runtimeSessionValues,
           ctx.__valueOverlay
@@ -63045,7 +63069,7 @@ function cloneClassValueGraph(receiver, expectedClassId, ctx) {
         clone.value = sourceRow.value.map((childId) => {
           if (typeof childId !== "string") return childId;
           const child = evalValueById(
-            ctx.vm,
+            ctx,
             childId,
             ctx.__runtimeSessionValues,
             ctx.__valueOverlay
@@ -63075,7 +63099,7 @@ function cloneClassValueGraph(receiver, expectedClassId, ctx) {
         }
         if (constructorArgumentReferenceCounts.get(argument2.id) !== 1) continue;
         const argumentRow = evalValueById(
-          ctx.vm,
+          ctx,
           argument2.id,
           ctx.__runtimeSessionValues,
           ctx.__valueOverlay
@@ -63452,21 +63476,17 @@ function initializerEvaluatorLookups(document) {
   });
   return lookups;
 }
-function buildInitializerRootValue(document) {
+function buildInitializerRootValue(document, lookups) {
   const rootValue = {};
-  const memberById = new Map(
-    document.members.map((member) => [member.id, member])
-  );
-  const valueById = new Map(document.values.map((row) => [row.id, row]));
   for (const { root, memberId } of projectRootMembersInDisplayOrder(
     document.project
   )) {
-    const member = memberById.get(memberId);
-    if (member === void 0 || typeof member.valueId !== "string") {
+    const member = lookups.memberById(memberId);
+    if (member === null || typeof member.valueId !== "string") {
       rootValue[root.key] = null;
       continue;
     }
-    rootValue[root.key] = valueById.get(member.valueId)?.value ?? null;
+    rootValue[root.key] = lookups.valueById(member.valueId)?.value ?? null;
   }
   return rootValue;
 }
@@ -63479,6 +63499,7 @@ function evaluateMemberInitializer(args) {
       args.init
     );
   }
+  const databaseVM = initializerEvaluatorLookups(args.document);
   const ctx = {
     vm: {
       project: args.document.project,
@@ -63492,10 +63513,10 @@ function evaluateMemberInitializer(args) {
       interfaces: args.document.interfaces,
       localizedTexts: args.document.localizedTexts,
       localizationConfig: args.document.localizationConfig,
-      databaseVM: initializerEvaluatorLookups(args.document)
+      databaseVM
     },
     thisValue: null,
-    rootValue: buildInitializerRootValue(args.document),
+    rootValue: buildInitializerRootValue(args.document, databaseVM),
     saveStaticBindings: args.saveStaticBindings,
     sessionStaticBindings: args.sessionStaticBindings,
     ...args.storedConstructionReplay === true ? {
@@ -84127,6 +84148,7 @@ function assertServerPreparationSucceeds(args) {
         prepared
       );
     }
+    return prepared;
   } catch (error) {
     throw locateBodyCompileFailure(error, args.sourceByRecord);
   }
@@ -84344,7 +84366,7 @@ function replayStoredConstructionV4(args) {
         "Construction replay cannot compile document bodies without a compiler project."
       );
     }
-    compilePulledProjectDocumentBodiesV4(document, compilationProject);
+    compilePulledProjectDocumentForEvaluationV4(document, compilationProject);
   }
   const root = document.values.find((value) => value.id === args.valueId);
   if (root === void 0) {
@@ -84540,7 +84562,16 @@ function compilePulledValueInitializerBodyV4(document, valueId, compilationProje
     ...compilationProject === void 0 ? {} : { compilationProject }
   });
 }
-function compilePulledProjectDocumentBodiesV4(document, compilationProject) {
+function compilePulledProjectDocumentForEvaluationV4(document, compilationProject) {
+  const sharedCompilationProject = compilationProject ?? createNeoScriptCompilationProject({
+    project: document.project,
+    projectFiles: document.projectFiles,
+    members: document.members,
+    classes: document.classes,
+    enums: document.enums,
+    interfaces: document.interfaces,
+    constructors: document.constructors ?? []
+  });
   const compileArgs = {
     project: document.project,
     projectFiles: document.projectFiles,
@@ -84549,7 +84580,7 @@ function compilePulledProjectDocumentBodiesV4(document, compilationProject) {
     enums: document.enums,
     interfaces: document.interfaces,
     constructors: document.constructors ?? [],
-    compilationProject
+    compilationProject: sharedCompilationProject
   };
   for (const constructor2 of compileArgs.constructors) {
     compileConstructorRecord({ ...compileArgs, constructor: constructor2 });
@@ -84569,6 +84600,20 @@ function compilePulledProjectDocumentBodiesV4(document, compilationProject) {
       thisClass: ownerClassByMemberId.get(member.id) ?? null
     });
   }
+  for (const site of valueInitializerCompilationSites(document).values()) {
+    if (isInitValueContent(site.row) && site.row.init.compiled !== void 0) {
+      continue;
+    }
+    compileValueRowInitializerBody({
+      ...compileArgs,
+      member: site.member,
+      valueRow: site.row,
+      valueId: String(Reflect.get(site.row, "id")),
+      initializerOwnerClass: site.ownerClass,
+      lexicalThisClass: site.lexicalThisClass,
+      storedConstructionReplay: true
+    });
+  }
 }
 function assertPulledConstructorsCompiled(document) {
   const uncompiled = (document.constructors ?? []).find(
@@ -100088,6 +100133,7 @@ async function prepareLocalPushArtifactsV4(workspace, status, onPhase = () => vo
     status.changes,
     localizedTextCreateEnvelopeConfig2(workspace, status.changes)
   );
+  let preparedChanges = null;
   if (options.fullValidation) {
     onPhase("Verifying the complete source round trip\u2026");
     verifyProjectSourceCommitAgainstStateV4({
@@ -100104,7 +100150,7 @@ async function prepareLocalPushArtifactsV4(workspace, status, onPhase = () => vo
     onPhase(
       `Rehearsing server validation for ${transportChanges.length.toLocaleString("en-US")} change(s)\u2026`
     );
-    assertServerPreparationSucceeds({
+    preparedChanges = assertServerPreparationSucceeds({
       workspace,
       changes: transportChanges,
       authoredValueSeeds: transportSeeds,
@@ -100119,7 +100165,8 @@ async function prepareLocalPushArtifactsV4(workspace, status, onPhase = () => vo
     transactionOperation,
     transportChanges,
     transportSeeds,
-    preparedFiles
+    preparedFiles,
+    preparedChanges
   };
 }
 async function prepareLocalCandidateV4(workspace, options = {}) {
@@ -100193,8 +100240,23 @@ async function prepareLocalCandidateV4(workspace, options = {}) {
     if (typeof baseId === "string") {
       records2.delete(`${change.recordKind}:${baseId}`);
     }
+  }
+  const candidateChanges = preparedLocal?.preparedChanges ?? documentStatus.changes.map((change) => ({
+    recordKind: change.recordKind,
+    recordId: change.recordId,
+    operation: change.kind,
+    nextData: change.nextData
+  }));
+  for (const change of candidateChanges) {
     records2.delete(`${change.recordKind}:${change.recordId}`);
-    if (change.nextData === void 0) continue;
+    if (change.operation === "delete" || change.nextData === void 0) {
+      continue;
+    }
+    if (!isObjectRecord2(change.nextData)) {
+      throw new Error(
+        `Prepared ${change.recordKind} record ${JSON.stringify(change.recordId)} has invalid data.`
+      );
+    }
     const nextId = typeof change.nextData.id === "string" ? change.nextData.id : change.recordId;
     records2.set(`${change.recordKind}:${nextId}`, {
       recordKind: change.recordKind,
@@ -100204,9 +100266,11 @@ async function prepareLocalCandidateV4(workspace, options = {}) {
       data: change.nextData
     });
   }
+  const document = readPulledProjectDocumentV4(records2);
+  compilePulledProjectDocumentForEvaluationV4(document);
   return {
     status,
-    document: readPulledProjectDocumentV4(records2),
+    document,
     sourceHash,
     preparedLocal
   };
@@ -101660,7 +101724,7 @@ var init_registry2 = __esm({
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
       formatVersion: 3,
       contractVersion: "3.9",
-      cliVersion: "0.24.7",
+      cliVersion: "0.24.9",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.24.7",
+  "version": "0.24.9",
   "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.24.7 -->
+<!-- reviewed-through-cli: 0.24.9 -->
 
 # Neo Compose CLI
 
@@ -30,6 +30,9 @@ Those are not part of format 4.
    existed before the task began.
 4. Run `neo test` after NeoScript changes and `neo dialogue dryrun <ref>` after
    dialogue changes.
+   `neo test` compiles the complete pending candidate, including idless nested
+   construction rows, so tests must work before the first push; do not add IDs
+   or push merely to obtain compiled initializer bodies.
 5. Run `neo push --dry-run` before every real push. It performs the full local
    source emission, ID-assignment, transport-shape, hash, and repeat-verification path,
    then rehearses the server's preparation phase — schema-commit

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

@@ -127,6 +127,10 @@ Use `NeoAnimationSegment<T>` for a frame-indexed value lane. The shipped
 sprite specialization is `NeoSpriteAnimationSegment`, whose
 `NeoAnimationSegmentFrame<SpriteInfo>` rows each provide `Index` and
 `Value`. Sparse frame values hold until the next row or `Duration`.
+Pass `Value` through the frame constructor (for example,
+`new NeoAnimationSegmentFrame<int>(value: 60)`). The constructor argument is
+the frame's authored value; it must not collapse to the concrete generic
+binding's fallback while the segment is materialized.
 
 Use one polymorphic `NeoAnimationClip.Tracks` list:
 

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

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