@neocompose/cli 0.24.7 → 0.24.8

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [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;
@@ -56638,7 +56641,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 +56912,7 @@ function evaluatorOwnershipDistances(rowId, indexes) {
 }
 function resolveRuntimeReferenceRow(sourceValueId, ctx) {
   const direct = evalValueById(
-    ctx.vm,
+    ctx,
     sourceValueId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -57347,7 +57351,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 +57361,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 +58214,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 +58251,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 +58301,7 @@ function applyOverlayStaticAssignment(memberId, value, ctx) {
   }
   if (!referenceAssignment && currentId !== null) {
     const row2 = evalValueById(
-      ctx.vm,
+      ctx,
       currentId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -58803,7 +58807,7 @@ function evalStaticMember(memberId, ctx) {
     return null;
   }
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     targetId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -58813,6 +58817,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 +59103,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 +59230,7 @@ function delegateClosureLexicalThis(closure, ctx) {
   )) {
     if (ancestorId === closureRow.id) continue;
     const ancestor = evalValueById(
-      ctx.vm,
+      ctx,
       ancestorId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -59371,7 +59376,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 +60047,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 +60061,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 +60079,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 +60128,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 +60453,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 +61038,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 +61149,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 +61181,7 @@ function bindConstructedDelegateTargets(rootId, ctx) {
       indexes
     )) {
       const ancestor = evalValueById(
-        ctx.vm,
+        ctx,
         ancestorId,
         ctx.__runtimeSessionValues,
         ctx.__valueOverlay
@@ -62318,7 +62328,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 +62374,7 @@ function currentOwnedValueAttachments(valueId, ctx) {
     found.set(attachment.identity, attachment);
   };
   const row = evalValueById(
-    ctx.vm,
+    ctx,
     valueId,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -62401,7 +62411,7 @@ function currentOwnedValueAttachments(valueId, ctx) {
   );
   for (const parentId of parentIds) {
     const parent = evalValueById(
-      ctx.vm,
+      ctx,
       parentId,
       ctx.__runtimeSessionValues,
       ctx.__valueOverlay
@@ -62469,7 +62479,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 +62501,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 +62611,7 @@ function cloneConstructorArgumentGraph(args) {
           args.ctx
         );
         const child = evalValueById(
-          args.ctx.vm,
+          args.ctx,
           childId,
           args.ctx.__runtimeSessionValues,
           args.ctx.__valueOverlay
@@ -62637,7 +62647,7 @@ function cloneConstructorArgumentGraph(args) {
           );
         }
         const child = evalValueById(
-          args.ctx.vm,
+          args.ctx,
           childId,
           args.ctx.__runtimeSessionValues,
           args.ctx.__valueOverlay
@@ -62684,7 +62694,7 @@ function cloneConstructorArgumentGraph(args) {
           );
         }
         const child = evalValueById(
-          args.ctx.vm,
+          args.ctx,
           childId,
           args.ctx.__runtimeSessionValues,
           args.ctx.__valueOverlay
@@ -62726,7 +62736,7 @@ function materializeConstructorArgumentValue(args) {
     }
     if (trackedValueId !== null) {
       const tracked = evalValueById(
-        args.ctx.vm,
+        args.ctx,
         trackedValueId,
         args.ctx.__runtimeSessionValues,
         args.ctx.__valueOverlay
@@ -62909,7 +62919,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 +62969,7 @@ function cloneClassValueGraph(receiver, expectedClassId, ctx) {
     );
   }
   const source = evalValueById(
-    ctx.vm,
+    ctx,
     sourceId3,
     ctx.__runtimeSessionValues,
     ctx.__valueOverlay
@@ -63024,7 +63034,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 +63055,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 +63085,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
@@ -101660,7 +101670,7 @@ var init_registry2 = __esm({
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
       formatVersion: 3,
       contractVersion: "3.9",
-      cliVersion: "0.24.7",
+      cliVersion: "0.24.8",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.24.7",
+  "version": "0.24.8",
   "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.8 -->
 
 # Neo Compose CLI
 

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.8 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale