@neocompose/cli 0.35.0 → 0.35.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.35.1] - 2026-08-19
+
+### Fixed
+
+- Treat `Partial<T>` values as sparse deltas throughout lowering and emission,
+  without invoking or reconstructing `T`'s required constructor.
+- Materialize complete Unity defaults for template-less image and audio
+  registry entries instead of writing an invalid template override shape.
+- Keep declarations inside variant delegate closures out of the global-child
+  registry, so separate `initialize` and `apply` closures may reuse local names.
+
 ## [0.35.0] - 2026-08-19
 
 ### Added

package/dist/neo.mjs

@@ -18907,6 +18907,14 @@ function collectGlobalChildEntries(sourceText, declaration) {
   let pendingAnnotations = [];
   for (let index = 0; index < tokens.length; index++) {
     const token = tokens[index];
+    if (token.text === "(" || token.text === "[") {
+      groupDepth++;
+      continue;
+    }
+    if (token.text === ")" || token.text === "]") {
+      groupDepth--;
+      continue;
+    }
     if (token.text === "{") {
       braceDepth++;
       continue;
@@ -18916,14 +18924,6 @@ function collectGlobalChildEntries(sourceText, declaration) {
       continue;
     }
     if (braceDepth !== 1) continue;
-    if (token.text === "(" || token.text === "[") {
-      groupDepth++;
-      continue;
-    }
-    if (token.text === ")" || token.text === "]") {
-      groupDepth--;
-      continue;
-    }
     if (groupDepth !== 0) continue;
     if (token.text === ";") {
       pendingAnnotations = [];
@@ -48137,6 +48137,20 @@ function buildDefaultUnityTexture2DImportSettings() {
     }
   };
 }
+function buildDefaultUnityAudioClipImportSettings() {
+  return {
+    forceToMono: false,
+    normalize: true,
+    loadInBackground: false,
+    ambisonic: false,
+    loadType: "decompress-on-load" /* DecompressOnLoad */,
+    compressionFormat: "vorbis" /* Vorbis */,
+    quality: 1,
+    sampleRateSetting: "preserve-sample-rate" /* PreserveSampleRate */,
+    overrideSampleRate: null,
+    preloadAudioData: true
+  };
+}
 function isUnityVector2(value) {
   const v = value;
   if (!isObject(value)) return false;
@@ -53024,6 +53038,20 @@ var init_project_file_registry = __esm({
 });
 
 // src/project-source/project-file-source.ts
+function projectFileUnityImportSettingsV4(kind, templateId) {
+  if (templateId === null) {
+    return {
+      ...kind === "image" ? buildDefaultUnityTexture2DImportSettings() : buildDefaultUnityAudioClipImportSettings(),
+      templateId: null
+    };
+  }
+  return {
+    ...kind === "image" ? { type: "texture-2d" } : {},
+    templateId,
+    overridePaths: [],
+    values: {}
+  };
+}
 function emitProjectFileRegistrySourcesV4(records2) {
   const liveFiles = [...records2.values()].filter((record3) => record3.recordKind === "project-file" && !record3.deleted).map((record3) => ({ record: record3, data: requireFileData(record3) }));
   assertUniqueProjectBinaryPaths(liveFiles);
@@ -53142,12 +53170,10 @@ function lowerTrustedProjectFileRegistrySourcesV4(state, analysis, trustedPendin
       });
     }
     if (importSettingsChanged) {
-      next[settingsField] = {
-        ...declaration.kind === "image" ? { type: "texture-2d" } : {},
-        templateId: declaration.templateId,
-        overridePaths: [],
-        values: {}
-      };
+      next[settingsField] = projectFileUnityImportSettingsV4(
+        declaration.kind,
+        declaration.templateId
+      );
     }
     return {
       recordKind: "project-file",
@@ -53445,6 +53471,7 @@ var init_project_file_source = __esm({
     init_source_format();
     init_project_file_registry();
     init_members();
+    init_unity_import_settings();
     REGISTRY_ENTRY = /(?:@id\(\s*("(?:[^"\\]|\\.)*")\s*\)\s*)?(?:@settings\(([\s\S]*?)\)\s*)?(NeoImage|NeoAudioClip)\s+([A-Za-z_][A-Za-z0-9_]*)\s*=\s*new\(\s*("(?:[^"\\]|\\.)*")\s*\)\s*;/gy;
     assignDeterministicFileSymbols = assignDeterministicProjectFileSymbols;
   }
@@ -98181,11 +98208,11 @@ function lowerMemberDefaultSourcesV4(state, analysis, manifest, options = {}) {
         context.parsedInitializers,
         declaration.initializer
       );
-      const requiresEvaluation = initializerRequiresEvaluation(
-        context.declaredConstructors,
+      const requiresEvaluation = memberInitializerRequiresEvaluation(
+        context,
+        member,
         annotatedValue(expression).expression,
-        memberClassName(context, member),
-        bindingRuntimeIdentifiers(context, binding)
+        binding
       );
       const baseData3 = stateData(context, "member", memberId);
       const annotatedExpression = annotatedValue(expression).expression;
@@ -98676,12 +98703,7 @@ function declaredCollectionMemberIds(context, collectionMemberId) {
 }
 function defaultRequiresOwnedRows(context, member, sourceExpression, source) {
   const expression = annotatedValue(sourceExpression).expression;
-  if (initializerRequiresEvaluation(
-    context.declaredConstructors,
-    expression,
-    memberClassName(context, member),
-    bindingRuntimeIdentifiers(context, source)
-  )) {
+  if (memberInitializerRequiresEvaluation(context, member, expression, source)) {
     return false;
   }
   if (member.kind === "class") return expression.kind === "new";
@@ -98693,6 +98715,15 @@ function defaultRequiresOwnedRows(context, member, sourceExpression, source) {
   }
   return false;
 }
+function memberInitializerRequiresEvaluation(context, member, expression, source) {
+  if (member.kind === "class" && member.partial === true) return false;
+  return initializerRequiresEvaluation(
+    context.declaredConstructors,
+    expression,
+    memberClassName(context, member),
+    bindingRuntimeIdentifiers(context, source)
+  );
+}
 function indexInitAuthoredRowIds(context, initSource, owner) {
   indexAuthoredRowIds(context.initAuthoredRowIds, initSource, owner);
 }
@@ -99240,7 +99271,7 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
     member,
     inheritedEnvironment
   );
-  if (context.structuralConstruction && resolvedMember.kind === "class" && expression.kind === "new" && structurallyConstructedClassId(context, resolvedMember, expression) !== null) {
+  if (context.structuralConstruction && resolvedMember.kind === "class" && resolvedMember.partial !== true && expression.kind === "new" && structurallyConstructedClassId(context, resolvedMember, expression) !== null) {
     return lowerStructuralConstructionRow(
       context,
       resolvedMember,
@@ -99255,11 +99286,11 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
       authoredSlice
     );
   }
-  if (!isStoredCallableLiteral(resolvedMember.kind, expression) && initializerRequiresEvaluation(
-    context.declaredConstructors,
+  if (!isStoredCallableLiteral(resolvedMember.kind, expression) && memberInitializerRequiresEvaluation(
+    context,
+    resolvedMember,
     expression,
-    memberClassName(context, resolvedMember),
-    bindingRuntimeIdentifiers(context, source)
+    source
   )) {
     const unattachedId = annotated.id === null ? unattachedAuthoredRowId(authoredSlice) : null;
     if (unattachedId !== null) {
@@ -99321,7 +99352,8 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
     if (effectiveClass === void 0) {
       throw new Error(`Unknown value class ${resolvedMember.classId}.`);
     }
-    if (effectiveClass.declarationModifier === "abstract") {
+    const partial = resolvedMember.partial === true;
+    if (!partial && effectiveClass.declarationModifier === "abstract") {
       throw new Error(
         `Cannot instantiate abstract class ${effectiveClass.name} for ${path}. Use a concrete descendant instead.`
       );
@@ -99339,13 +99371,15 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
       expression,
       declaredEnvironment
     );
-    validateConstructedGenericArguments(
-      context,
-      effectiveClass,
-      expression,
-      environment,
-      path
-    );
+    if (!partial) {
+      validateConstructedGenericArguments(
+        context,
+        effectiveClass,
+        expression,
+        environment,
+        path
+      );
+    }
     genericBindings = animationChildOverrideSeedBindings(
       context,
       effectiveClass,
@@ -99355,19 +99389,20 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
     );
     const body = {};
     const argumentSlices = constructorArgumentValueSlices(authoredSlice);
-    for (const {
-      projectedMember,
-      schemaKey,
-      argument: argument2,
-      argumentIndex
-    } of resolveConstructorProjectionArguments(
+    const projectedArguments = partial ? [] : resolveConstructorProjectionArguments(
       context,
       effectiveClass,
       expression,
       valueId,
       environment,
       source
-    )) {
+    );
+    for (const {
+      projectedMember,
+      schemaKey,
+      argument: argument2,
+      argumentIndex
+    } of projectedArguments) {
       const childPath = `${path}.${schemaKey}`;
       const childValueId = pendingNestedValueId(source, childPath);
       if (rows.has(childValueId)) {
@@ -99413,7 +99448,7 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
         effectiveClass.id,
         assignment.name
       );
-      if (inheritedLegacyConstructorProjections(
+      if (!partial && inheritedLegacyConstructorProjections(
         context.classes,
         effectiveClass.id
       ).some((projection) => projection.memberId === childMember.id)) {
@@ -99853,11 +99888,11 @@ function lowerValueRow(context, member, sourceExpression, expectedValueId, sourc
     member,
     environment
   );
-  if (!isStoredCallableLiteral(resolvedMember.kind, expression) && initializerRequiresEvaluation(
-    context.declaredConstructors,
+  if (!isStoredCallableLiteral(resolvedMember.kind, expression) && memberInitializerRequiresEvaluation(
+    context,
+    resolvedMember,
     expression,
-    memberClassName(context, resolvedMember),
-    bindingRuntimeIdentifiers(context, source)
+    source
   )) {
     const code = initializerExpressionSlice(authoredSlice);
     if (code === void 0) {
@@ -100075,7 +100110,8 @@ function lowerClassValue(context, member, expression, base, source, outerEnviron
   const schemaClass2 = context.classes.get(classId);
   if (schemaClass2 === void 0)
     throw new Error(`Unknown value class ${classId}.`);
-  if (schemaClass2.declarationModifier === "abstract") {
+  const partial = member.partial === true;
+  if (!partial && schemaClass2.declarationModifier === "abstract") {
     throw new Error(
       `Cannot instantiate abstract class ${schemaClass2.name} for value ${String(base.id)}. Use a concrete descendant instead.`
     );
@@ -100090,13 +100126,15 @@ function lowerClassValue(context, member, expression, base, source, outerEnviron
     expression,
     declaredEnvironment
   );
-  validateConstructedGenericArguments(
-    context,
-    schemaClass2,
-    expression,
-    environment,
-    String(base.id ?? member.name)
-  );
+  if (!partial) {
+    validateConstructedGenericArguments(
+      context,
+      schemaClass2,
+      expression,
+      environment,
+      String(base.id ?? member.name)
+    );
+  }
   const baseBody = isObjectRecord2(base.value) ? base.value : {};
   const body = retainedStoredClassBody(
     context,
@@ -100104,7 +100142,7 @@ function lowerClassValue(context, member, expression, base, source, outerEnviron
     baseBody
   );
   const assignmentSlices = objectInitializerSlices(authoredSlice);
-  if (materializedConstruction !== "preserve") {
+  if (!partial && materializedConstruction !== "preserve") {
     lowerConstructorProjections(
       context,
       schemaClass2,
@@ -100119,7 +100157,7 @@ function lowerClassValue(context, member, expression, base, source, outerEnviron
   }
   for (const assignment of expression.initializer ?? []) {
     const childMember = classMemberByName(context, classId, assignment.name);
-    if (inheritedLegacyConstructorProjections(
+    if (!partial && inheritedLegacyConstructorProjections(
       context.classes,
       schemaClass2.id
     ).some((projection) => projection.memberId === childMember.id)) {
@@ -102173,7 +102211,7 @@ function classValue(context, member, value, visited, targetTyped, outerEnvironme
   const hasStoredConstruction = isObjectRecord2(value.constructorArgs);
   let projection;
   try {
-    projection = hasStoredConstruction ? {
+    projection = partial ? { arguments: [], memberIds: /* @__PURE__ */ new Set(), targetValueIds: [] } : hasStoredConstruction ? {
       arguments: [],
       memberIds: new Set(
         effectiveConstructorProjections(
@@ -102210,7 +102248,7 @@ function classValue(context, member, value, visited, targetTyped, outerEnvironme
   const name = classValueTypeName(context, classId, member, environment);
   let storedConstruction;
   try {
-    storedConstruction = storedConstructorCallSource(
+    storedConstruction = partial ? null : storedConstructorCallSource(
       context,
       schemaClass2,
       value,
@@ -104166,12 +104204,10 @@ function lowerProjectFileRegistrySourcesV4(root, state, analysis, options = {})
       });
     }
     if (importSettingsChanged) {
-      next[settingsField] = {
-        ...declaration.kind === "image" ? { type: "texture-2d" } : {},
-        templateId: declaration.templateId,
-        overridePaths: [],
-        values: {}
-      };
+      next[settingsField] = projectFileUnityImportSettingsV4(
+        declaration.kind,
+        declaration.templateId
+      );
     }
     return {
       recordKind: "project-file",
@@ -104203,12 +104239,7 @@ function lowerDiscoveredProjectBinariesV4(root, state, analysis) {
     const templateId = binary.kind === "image" ? optionalString3(projectData.defaultTextureTemplateId) : optionalString3(projectData.defaultAudioClipTemplateId);
     const settingsField = binary.kind === "image" ? "unityTextureSettings" : "unityAudioClipSettings";
     const otherSettingsField = binary.kind === "image" ? "unityAudioClipSettings" : "unityTextureSettings";
-    const settings = {
-      ...binary.kind === "image" ? { type: "texture-2d" } : {},
-      templateId,
-      overridePaths: [],
-      values: {}
-    };
+    const settings = projectFileUnityImportSettingsV4(binary.kind, templateId);
     const now = Date.now();
     return {
       recordKind: "project-file",
@@ -104581,6 +104612,7 @@ var init_project_files = __esm({
     init_source_format();
     init_members();
     init_project_file_registry();
+    init_project_file_source();
     SUPPORTED_BINARY_TYPES = /* @__PURE__ */ new Map([
       [".png", { kind: "image", mimeType: "image/png" }],
       [".jpg", { kind: "image", mimeType: "image/jpeg" }],
@@ -113595,7 +113627,7 @@ var init_registry2 = __esm({
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
       formatVersion: 3,
       contractVersion: "3.14",
-      cliVersion: "0.35.0",
+      cliVersion: "0.35.1",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -120197,7 +120229,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.35.0");
+    console.log("0.35.1");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.35.0",
+  "version": "0.35.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.35.0 -->
+<!-- reviewed-through-cli: 0.35.1 -->
 
 # Neo Compose CLI
 
@@ -197,6 +197,8 @@ AudioClipRegistry AudioClips = new() {
 Use `Images.Sword.Slice(0)` for a sprite and `AudioClips.SwordHit` for audio.
 Renaming the registry symbol, moving the local presentation, or replacing bytes
 retains the file ID.
+Omitting `@settings(template: ...)` uses the complete built-in Unity import
+defaults for that file kind.
 
 ## Resolve conflicts by identity
 

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

@@ -50,7 +50,12 @@ NeoVariant<ExampleObject> Down = new(
   `() => new ExampleObject(.Down)` works; `apply` is void, so its expression
   body must be a call or an assignment, as in
   `(source) => source.FacingDir = .Down`. The server compiles them, so authored
-  source carries only the code.
+  source carries only the code. Each closure has its own lexical scope, so
+  local names may be reused between `initialize` and `apply`.
+- `overrides` and each child override's `overrides` value are `Partial<T>`
+  deltas over existing instances. They may use inferred `new { ... }` or
+  explicit `new Partial<T> { ... }`, and never pass arguments to or invoke
+  `T`'s constructor—even when `T` has a required constructor.
 
 Folders are records too, declared as their own globals and assigned per
 variant. Nesting is spelled in the path with `/`; intermediate segments are

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

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

package/skills/neocompose-cli/references/values-identities-and-references.md

@@ -170,7 +170,8 @@ diff, and dry-run do not rewrite its registry. A successful push creates the
 record, uploads verified bytes, and materializes its declaration and ID.
 
 Edit the typed registry declaration directly when an explicit symbol or
-non-default template is needed before push.
+non-default template is needed before push. With no template annotation, the
+CLI persists the complete built-in Unity defaults for the file kind.
 
 Pull/push compare server-verified SHA-256, not storage ETags. A divergent
 binary keeps local bytes and writes the verified remote side under