@neocompose/cli 0.69.0 → 0.69.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.69.1] - 2026-10-06
+
+- `neo export` shows a spinner while it works, labeled with the current step: reading the pulled project, building the export, generating Unity types, writing changed files, and checking local changes.
+- `neo push` no longer carries a replaced class member's stored value into a new member with the same name. The old member's value rows are deleted and the new member's value is seeded fresh. Before this fix, push could fail with errors such as "single-select lookup cannot store multiple targets".
+- `neo push --dry-run` can replay a stored construction that sets a `NeoAction` member, for example `OnApply = []` on a watcher stored inside an item stack. Before this fix, the dry run's round-trip check failed with "Cannot infer the entry type of an empty list".
+
 ## [0.69.0] - 2026-10-05
 
 - **Breaking:** `neo export` replaces `neo export unity --out <dir>`. It builds the Unity export from the last pull, offline, and writes it into the directories the Unity project's `NeoComposeConfig` asset names. It writes only files whose bytes changed, skips codegen when only values changed since the last export into that Unity project, and writes `Library/NeoCompose/export.json` last for Unity to ingest. Local edits aren't exported, and the output counts them. An error diagnostic, or a project file whose bytes differ from the pulled file, stops the export before anything is written.

package/dist/neo.mjs

@@ -17687,6 +17687,17 @@ var init_strict_resolver = __esm({
             targetType,
             schemaClass2
           );
+          if (memberType2.kind === "action") {
+            return {
+              schemaKey: member.schemaKey ?? member.name,
+              memberId: member.id,
+              valuePointer: this.resolveReplayedListenerSet(
+                entry.value,
+                memberType2,
+                scope
+              )
+            };
+          }
           const value = this.resolveExpression(entry.value, scope, memberType2);
           if (!isNeoScriptTypeAssignable(value.type, memberType2, this.project)) {
             throw new CompileError(
@@ -17701,6 +17712,43 @@ var init_strict_resolver = __esm({
           };
         });
       }
+      /**
+       * P62 §2. A stored action slot replays as the listener list it stores. Each
+       * entry resolves to the same static (member, row) identity the authored list
+       * lowers to. Executable script cannot reassign a listener set (§3.2).
+       */
+      resolveReplayedListenerSet(expression, actionType, scope) {
+        if (this.context.storedConstructionReplay !== true) {
+          throw new CompileError(
+            `Cannot assign to ${this.describe(actionType)}; a listener set is not reassignable from script. Use '+=' to add a listener or '-=' to remove one.`,
+            expression.pos
+          );
+        }
+        if (expression.kind !== "litList") {
+          throw new CompileError(
+            `A stored ${this.describe(actionType)} replays as a bracketed listener list.`,
+            expression.pos
+          );
+        }
+        const listeners = [];
+        for (const element of expression.elements) {
+          const listener = this.resolveActionListener(element, actionType, scope);
+          if (listener.type !== "value" /* Value */) {
+            throw new CompileError(
+              "A stored listener must name a stable (member, row) target.",
+              element.pos
+            );
+          }
+          listeners.push(listener.value.value);
+        }
+        return {
+          type: "value" /* Value */,
+          value: {
+            typeInfo: toWireType(actionType, this.project),
+            value: { listeners }
+          }
+        };
+      }
       resolveTileConversion(callee, args, typeArguments, scope, pos) {
         const receiver = this.resolveExpression(callee.receiver, scope);
         const owner = receiver.type.kind === "named" ? this.project.typeById.get(receiver.type.typeId) : void 0;
@@ -31763,7 +31811,7 @@ var init_registry = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.69.0",
+      cliVersion: "0.69.1",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -90621,7 +90669,6 @@ var project_document_read_exports = {};
 __export(project_document_read_exports, {
   DOCUMENT_MANIFEST_PAGE_SIZE: () => DOCUMENT_MANIFEST_PAGE_SIZE,
   assembleProjectDocumentRaw: () => assembleProjectDocumentRaw,
-  createDocumentPageReader: () => createDocumentPageReader,
   fetchProjectDocumentPartitionRecords: () => fetchProjectDocumentPartitionRecords,
   fetchProjectDocumentRawChunked: () => fetchProjectDocumentRawChunked,
   fetchProjectDocumentRawChunkedOnce: () => fetchProjectDocumentRawChunkedOnce,
@@ -130418,14 +130465,15 @@ function retainedStoredClassBody(context, storedClassId, baseBody) {
   const storedMemberIds = storedClassSchemaMemberIds(context, storedClassId);
   const body = {};
   for (const [key, childId] of Object.entries(baseBody)) {
-    const storedMemberId = storedMemberIds.get(key);
-    if (storedMemberId !== void 0 && !context.members.has(storedMemberId)) {
-      continue;
-    }
+    if (storedMemberRemoved(context, storedMemberIds, key)) continue;
     body[key] = childId;
   }
   return body;
 }
+function storedMemberRemoved(context, storedMemberIds, key) {
+  const storedMemberId = storedMemberIds.get(key);
+  return storedMemberId !== void 0 && !context.members.has(storedMemberId);
+}
 function storedClassSchemaMemberIds(context, classId) {
   const cached = context.storedClassSchemaMemberIds.get(classId);
   if (cached !== void 0) return cached;
@@ -131745,7 +131793,7 @@ function lowerClassValue(context, member, expression, base, source, outerEnviron
   }
   for (const assignment of expression.initializer ?? []) {
     const childMember = classMemberByName(context, classId, assignment.name);
-    const childId = baseBody[assignment.name];
+    const childId = body[assignment.name];
     if (typeof childId !== "string") {
       const symbolId2 = sourceValueSymbol(context, assignment.value);
       if (symbolId2 !== null) {
@@ -131817,6 +131865,7 @@ function lowerClassValue(context, member, expression, base, source, outerEnviron
     for (const [schemaKey, childId] of Object.entries(baseBody)) {
       if (typeof childId !== "string") continue;
       if (resetSchemaKeys.has(schemaKey)) continue;
+      if (storedMemberRemoved(context, storedMemberIds, schemaKey)) continue;
       if (materializedConstruction === "lower" && authoredKeys.has(schemaKey)) {
         continue;
       }
@@ -179970,14 +180019,28 @@ async function runExport(workspace, options) {
     workspace,
     options.unityProject
   );
-  const result = exportUnityProject({
-    workspace,
-    exportSettings,
-    convexUrl,
-    target
-  });
+  const progress = spinner("Reading pulled project\u2026");
+  let result;
+  let local;
+  try {
+    result = exportUnityProject({
+      workspace,
+      exportSettings,
+      convexUrl,
+      target,
+      onPhase: (label) => progress.update(label)
+    });
+    progress.update("Checking local changes\u2026");
+    local = localChanges(workspace);
+  } catch (error) {
+    progress.fail("Export failed.");
+    throw error;
+  }
   const { phases } = result;
   const elapsed = phases.read + phases.build + phases.codegen + phases.write;
+  progress.succeed(
+    `Exported ${color.bold(exportSettings.semver.label)} ${color.dim(`(${workspace.config.versionId})`)} into ${target.unityProjectRoot} in ${elapsed} ms ${color.dim(`(read ${phases.read}, build ${phases.build}, codegen ${phases.codegen}, write ${phases.write})`)}.`
+  );
   for (const diagnostic of result.diagnostics) {
     if (diagnostic.severity === "error") continue;
     warn(formatDiagnostic(diagnostic));
@@ -179987,16 +180050,12 @@ async function runExport(workspace, options) {
       `Unity's project.json was written at schema ${result.schemaSkew}; this export writes schema ${PROJECT_UNITY_EXPORT_SCHEMA_VERSION}. Update the Neo Compose SDK in Unity to a version that reads schema ${PROJECT_UNITY_EXPORT_SCHEMA_VERSION}.`
     );
   }
-  success(
-    `Exported ${color.bold(exportSettings.semver.label)} ${color.dim(`(${workspace.config.versionId})`)} into ${target.unityProjectRoot} in ${elapsed} ms ${color.dim(`(read ${phases.read}, build ${phases.build}, codegen ${phases.codegen}, write ${phases.write})`)}.`
-  );
   console.log(
     `  ${result.written.length} file(s) written, ${result.deleted.length} deleted, ${result.unchanged} unchanged; codegen ${result.codegenRan ? "ran" : "skipped"}.`
   );
   console.log(
     result.sidecarWritten ? "  Unity ingests the export on its next editor tick." : "  Unity is current."
   );
-  const local = localChanges(workspace);
   if (local.errors > 0) {
     note(
       `  Local sources have ${local.errors} error(s) and are not in the export, which holds the pulled head. Run \`neo status\` to see them.`
@@ -180008,7 +180067,7 @@ async function runExport(workspace, options) {
   }
 }
 function exportUnityProject(args) {
-  const { workspace, exportSettings, target } = args;
+  const { workspace, exportSettings, target, onPhase } = args;
   const { projectId, versionId } = workspace.config;
   let started = performance.now();
   const lap = () => {
@@ -180025,6 +180084,7 @@ function exportUnityProject(args) {
     })
   );
   const read = lap();
+  onPhase(`Building export from ${Object.keys(records2).length} records\u2026`);
   const unityExport = buildProjectUnityExport(document);
   const files = pulledExportFiles(workspace, Object.keys(unityExport.files));
   const recordHashes = {};
@@ -180039,6 +180099,7 @@ function exportUnityProject(args) {
   });
   const projectDiagnostics2 = buildUnityExportProjectDiagnostics(document);
   const build = lap();
+  if (!skipCodegen) onPhase("Generating Unity types\u2026");
   const generated = skipCodegen ? null : generateUnityTypes(unityExport, buildUnityCodegenDocs(document));
   const codegen = lap();
   const diagnostics = [
@@ -180090,6 +180151,7 @@ ${errors.map((error) => `  ${formatDiagnostic(error)}`).join("\n")}`
     projectJsonPath,
     dataFiles.get(projectJsonPath)
   );
+  onPhase(`Writing changed files into ${target.unityProjectRoot}\u2026`);
   const written = [];
   let unchanged = 0;
   for (const [path, content] of [...dataFiles, ...localizationFiles.writes]) {
@@ -180938,7 +181000,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.69.0");
+    console.log("0.69.1");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/dist/test-worker.mjs

@@ -37258,6 +37258,17 @@ var StrictNeoScriptResolver = class _StrictNeoScriptResolver {
         targetType,
         schemaClass
       );
+      if (memberType.kind === "action") {
+        return {
+          schemaKey: member.schemaKey ?? member.name,
+          memberId: member.id,
+          valuePointer: this.resolveReplayedListenerSet(
+            entry.value,
+            memberType,
+            scope
+          )
+        };
+      }
       const value = this.resolveExpression(entry.value, scope, memberType);
       if (!isNeoScriptTypeAssignable(value.type, memberType, this.project)) {
         throw new CompileError(
@@ -37272,6 +37283,43 @@ var StrictNeoScriptResolver = class _StrictNeoScriptResolver {
       };
     });
   }
+  /**
+   * P62 §2. A stored action slot replays as the listener list it stores. Each
+   * entry resolves to the same static (member, row) identity the authored list
+   * lowers to. Executable script cannot reassign a listener set (§3.2).
+   */
+  resolveReplayedListenerSet(expression, actionType, scope) {
+    if (this.context.storedConstructionReplay !== true) {
+      throw new CompileError(
+        `Cannot assign to ${this.describe(actionType)}; a listener set is not reassignable from script. Use '+=' to add a listener or '-=' to remove one.`,
+        expression.pos
+      );
+    }
+    if (expression.kind !== "litList") {
+      throw new CompileError(
+        `A stored ${this.describe(actionType)} replays as a bracketed listener list.`,
+        expression.pos
+      );
+    }
+    const listeners = [];
+    for (const element of expression.elements) {
+      const listener = this.resolveActionListener(element, actionType, scope);
+      if (listener.type !== "value" /* Value */) {
+        throw new CompileError(
+          "A stored listener must name a stable (member, row) target.",
+          element.pos
+        );
+      }
+      listeners.push(listener.value.value);
+    }
+    return {
+      type: "value" /* Value */,
+      value: {
+        typeInfo: toWireType(actionType, this.project),
+        value: { listeners }
+      }
+    };
+  }
   resolveTileConversion(callee, args, typeArguments, scope, pos) {
     const receiver = this.resolveExpression(callee.receiver, scope);
     const owner = receiver.type.kind === "named" ? this.project.typeById.get(receiver.type.typeId) : void 0;
@@ -43398,7 +43446,6 @@ var project_document_read_exports = {};
 __export(project_document_read_exports, {
   DOCUMENT_MANIFEST_PAGE_SIZE: () => DOCUMENT_MANIFEST_PAGE_SIZE,
   assembleProjectDocumentRaw: () => assembleProjectDocumentRaw,
-  createDocumentPageReader: () => createDocumentPageReader,
   fetchProjectDocumentPartitionRecords: () => fetchProjectDocumentPartitionRecords,
   fetchProjectDocumentRawChunked: () => fetchProjectDocumentRawChunked,
   fetchProjectDocumentRawChunkedOnce: () => fetchProjectDocumentRawChunkedOnce,

package/package.json

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

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

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