@neocompose/cli 0.74.0 → 0.75.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.75.0
+
+### Minor Changes
+
+- 0a7ec0e: `member.OnChanged.Clear()` removes every handler from a member's or getter's listener set. On a stored member it clears `@listeners` defaults and Save and Session wiring. On a getter it ends the subscription. Any other use of `OnChanged` as a value now reports "OnChanged supports only '+=', '-=', and Clear()." instead of "Cannot read member 'OnChanged'". Exports move to schema 41, so Unity needs SDK 0.65.0.
+
 ## 0.74.0
 
 ### Minor Changes

package/dist/neo.mjs

@@ -3150,24 +3150,30 @@ function isNSInstructionTry(value) {
   }
   return true;
 }
-function isNSInstructionChangeListener(value) {
-  const instruction = value;
-  if (instruction?.type !== "addChangeListener" /* addChangeListener */ && instruction?.type !== "removeChangeListener" /* removeChangeListener */)
-    return false;
-  const target = instruction.target;
+function isNSChangeListenerTarget(value) {
+  const target = value;
   if (!target || typeof target.memberId !== "string" || target.memberId.length === 0)
     return false;
   if (!isNSPointer(target.owner) || !isNSTypeInfo(target.typeInfo))
     return false;
-  if (!Object.values(NSWritability).includes(target.writability)) return false;
-  return isNSPointer(instruction.listener);
+  return target.writability !== void 0 && Object.values(NSWritability).includes(target.writability);
+}
+function isNSInstructionChangeListener(value) {
+  const instruction = value;
+  if (instruction?.type !== "addChangeListener" /* addChangeListener */ && instruction?.type !== "removeChangeListener" /* removeChangeListener */)
+    return false;
+  return isNSChangeListenerTarget(instruction.target) && isNSPointer(instruction.listener);
+}
+function isNSInstructionClearChangeListeners(value) {
+  const instruction = value;
+  return instruction?.type === "clearChangeListeners" /* clearChangeListeners */ && isNSChangeListenerTarget(instruction.target);
 }
 function isNSInstructionDebug(value) {
   const v = value;
   return v?.type === "debug" /* debug */ && ["log", "warning", "error", "assert"].includes(v.severity ?? "") && isNSPointer(v.message) && isNSTypeInfo(v.messageType) && (v.severity === "assert" ? isNSPointer(v.condition) : v.condition === void 0);
 }
 function isNSInstruction(value) {
-  return isNSInstructionDebug(value) || isNSInstructionVariable(value) || isNSInstructionIfBranch(value) || isNSInstructionReturn(value) || isNSInstructionThrow(value) || isNSInstructionAssign(value) || isNSInstructionCollectionCall(value) || isNSInstructionFunctionCall(value) || isNSInstructionConditionLoop(value) || isNSInstructionFor(value) || isNSInstructionForEach(value) || isNSInstructionBreak(value) || isNSInstructionContinue(value) || isNSInstructionSwitch(value) || isNSInstructionTry(value) || isNSInstructionChangeListener(value) || isNSInstructionAddActionListener(value) || isNSInstructionRemoveActionListener(value);
+  return isNSInstructionDebug(value) || isNSInstructionVariable(value) || isNSInstructionIfBranch(value) || isNSInstructionReturn(value) || isNSInstructionThrow(value) || isNSInstructionAssign(value) || isNSInstructionCollectionCall(value) || isNSInstructionFunctionCall(value) || isNSInstructionConditionLoop(value) || isNSInstructionFor(value) || isNSInstructionForEach(value) || isNSInstructionBreak(value) || isNSInstructionContinue(value) || isNSInstructionSwitch(value) || isNSInstructionTry(value) || isNSInstructionChangeListener(value) || isNSInstructionClearChangeListeners(value) || isNSInstructionAddActionListener(value) || isNSInstructionRemoveActionListener(value);
 }
 function isNSInstructions(value) {
   return Array.isArray(value) && value.every(isNSInstruction);
@@ -30812,7 +30818,7 @@ function intersectCollectionWritability(left, right) {
   const writable = (value) => value === "local" /* Local */ || value === "save" /* Save */ || value === "session" /* Session */ || value === "runtime" /* Runtime */;
   return writable(left) && writable(right) ? "runtime" /* Runtime */ : "readOnly" /* ReadOnly */;
 }
-var CONSTRUCTING_FUNCTION_KINDS, VARIANT_INITIALIZE_NAME, VARIANT_APPLY_NAME, MATH_NAMESPACE_NAME, MATH_FUNCTIONS, MATH_CONSTANTS, LIST_STATIC_FUNCTIONS, WRITE_TARGET_DESCRIPTIONS, FALLTHROUGH_LABELS, Scope, UnresolvedPersistedListenerReference, StrictNeoScriptResolver, SPRITE_DERIVED_MEMBERS;
+var CONSTRUCTING_FUNCTION_KINDS, VARIANT_INITIALIZE_NAME, VARIANT_APPLY_NAME, MATH_NAMESPACE_NAME, MATH_FUNCTIONS, MATH_CONSTANTS, LIST_STATIC_FUNCTIONS, WRITE_TARGET_DESCRIPTIONS, ON_CHANGED_OPERATIONS_ERROR, FALLTHROUGH_LABELS, Scope, UnresolvedPersistedListenerReference, StrictNeoScriptResolver, SPRITE_DERIVED_MEMBERS;
 var init_strict_resolver = __esm({
   "../packages/neoscript-language/src/strict-resolver.ts"() {
     "use strict";
@@ -30873,6 +30879,7 @@ var init_strict_resolver = __esm({
       projectValue: "a stored project value",
       unknown: "something other than `this` or a local"
     };
+    ON_CHANGED_OPERATIONS_ERROR = "OnChanged supports only '+=', '-=', and Clear().";
     FALLTHROUGH_LABELS = {
       function: "NSFunction",
       getter: "getter",
@@ -32215,6 +32222,12 @@ var init_strict_resolver = __esm({
               this.resolveExpression(statement.expr, scope);
             const debug = this.resolveDebugStatement(statement.expr, scope);
             if (debug) return debug;
+            const listenerClear = this.resolveChangeListenerClear(
+              statement.expr,
+              scope,
+              statement.pos
+            );
+            if (listenerClear) return listenerClear;
             const actionClear = this.resolveActionClear(
               statement.expr,
               scope,
@@ -32575,8 +32588,20 @@ var init_strict_resolver = __esm({
           const observed = this.resolveExpression(statement.target.receiver, scope);
           const observedType = neoScriptMemberLookupType(observed.type);
           const declared = observedType.kind === "named" && this.project.typeById.get(observedType.typeId)?.members.some((member) => member.name === "OnChanged");
-          if (!declared)
-            return this.resolveChangeSubscription(statement, observed, scope);
+          if (!declared) {
+            if (statement.op !== "+=" && statement.op !== "-=")
+              throw new CompileError(ON_CHANGED_OPERATIONS_ERROR, statement.pos);
+            return this.resolveChangeListener(
+              statement.target,
+              observed,
+              scope,
+              statement.pos,
+              {
+                kind: statement.op === "+=" ? "addChangeListener" /* AddChangeListener */ : "removeChangeListener" /* RemoveChangeListener */,
+                handler: statement.value
+              }
+            );
+          }
         }
         const local = statement.target.kind === "ident" ? scope.lookup(statement.target.name) : null;
         if (local?.readonlyBinding) {
@@ -32760,158 +32785,142 @@ var init_strict_resolver = __esm({
           pos
         );
       }
-      resolveChangeSubscription(statement, observed, scope) {
-        if (statement.op !== "+=" && statement.op !== "-=") {
-          throw new CompileError(
-            "OnChanged supports only '+=' and '-=' subscriptions.",
-            statement.pos
-          );
-        }
-        if (statement.target.kind !== "member") {
+      /** `X.M.OnChanged.Clear()` empties M's listener set on X (P70, P106). */
+      resolveChangeListenerClear(expression, scope, pos) {
+        if (expression.kind !== "call" || expression.callee.kind !== "member" || expression.callee.name !== "Clear" || expression.callee.receiver.kind !== "member" || expression.callee.receiver.name !== "OnChanged")
+          return null;
+        const onChanged = expression.callee.receiver;
+        const observed = this.resolveExpression(onChanged.receiver, scope);
+        const observedType = neoScriptMemberLookupType(observed.type);
+        if (observedType.kind === "named" && this.project.typeById.get(observedType.typeId)?.members.some((member) => member.name === "OnChanged"))
+          return null;
+        if (expression.callee.optional)
           throw new CompileError(
-            "OnChanged requires a declared member slot.",
-            statement.pos
+            "OnChanged is never null, so optional-chained Clear is not supported.",
+            pos
           );
-        }
-        if (statement.target.optional) {
+        requireArgCount("Clear", expression.args, 0, pos);
+        return this.resolveChangeListener(onChanged, observed, scope, pos, {
+          kind: "clearChangeListeners" /* ClearChangeListeners */
+        });
+      }
+      resolveChangeListener(onChanged, observed, scope, pos, edit) {
+        if (onChanged.optional) {
           throw new CompileError(
             "OnChanged cannot use an optional subscription target.",
-            statement.pos
+            pos
           );
         }
         if (observed.optionalChainType !== void 0) {
           throw new CompileError(
             "OnChanged cannot subscribe through optional chaining; narrow the receiver first.",
-            statement.pos
+            pos
           );
         }
         const member = observed.symbol;
         if (!member)
           throw new CompileError(
             "OnChanged requires a declared member, not a local variable.",
-            statement.pos
+            pos
           );
         if (observed.pointer.type === "staticMember" /* StaticMember */ || observed.pointer.type === "callGetter" /* CallGetter */ && observed.pointer.receiver.kind === "static") {
-          const access = statement.target.receiver;
+          const access = onChanged.receiver;
           const name = access.kind === "member" && access.receiver.kind === "ident" ? `${access.receiver.name}.${member.name}` : member.name;
           throw new CompileError(
             `OnChanged requires an instance member. '${name}' is static.`,
-            statement.pos
+            pos
           );
         }
         if (observed.pointer.type === "callGetter" /* CallGetter */)
-          return this.resolveGetterSubscription(
-            statement,
-            statement.target.receiver,
+          return this.resolveGetterChangeListener(
+            onChanged.receiver,
             observed,
             observed.pointer,
             member,
-            scope
+            scope,
+            pos,
+            edit
           );
         if (observed.pointer.type !== "keyOf" /* KeyOf */)
-          throw new CompileError(
-            "OnChanged requires a declared member slot.",
-            statement.pos
-          );
+          throw new CompileError("OnChanged requires a declared member slot.", pos);
         if (!observed.pointer.memberId)
           throw new CompileError(
             "OnChanged cannot observe a collection entry.",
-            statement.pos
+            pos
           );
         if (member.computed) {
           throw new CompileError(
             "OnChanged cannot observe a computed member.",
-            statement.pos
+            pos
           );
         }
         if (member.readonlyDeclaration) {
           throw new CompileError(
             "OnChanged cannot observe a readonly declaration.",
-            statement.pos
+            pos
           );
         }
         if (observed.type.kind === "delegate" || observed.type.kind === "action") {
           throw new CompileError(
             "OnChanged cannot observe a callable member.",
-            statement.pos
+            pos
           );
         }
         const writability = observed.userData ? "runtime" /* Runtime */ : observed.writability;
         if (writability !== "save" /* Save */ && writability !== "session" /* Session */ && writability !== "runtime" /* Runtime */ && writability !== "local" /* Local */) {
           throw new CompileError(
             "OnChanged requires a member whose storage is writable at gameplay runtime.",
-            statement.pos
+            pos
           );
         }
         this.validateConstructorWriteTarget(
           observed.pointer,
-          "subscribe to",
-          statement.pos,
+          edit.kind === "clearChangeListeners" /* ClearChangeListeners */ ? "clear listeners on" : "subscribe to",
+          pos,
           scope,
           false
         );
-        if (!statement.value) {
-          throw new CompileError(
-            "OnChanged subscription requires a handler member.",
-            statement.pos
-          );
-        }
         const storageType = this.assignmentStorageType(
-          statement.target.receiver,
+          onChanged.receiver,
           observed,
           null,
           scope
         );
-        const expected = {
-          kind: "action",
-          parameterTypes: [storageType]
-        };
-        const listener = this.resolveActionListener(
-          statement.value,
-          expected,
-          scope,
-          true,
-          true
-        );
-        return {
-          type: statement.op === "+=" ? "addChangeListener" /* AddChangeListener */ : "removeChangeListener" /* RemoveChangeListener */,
-          target: {
+        return this.changeListenerInstruction(
+          edit,
+          {
             owner: observed.pointer.keyOf.pointer,
             memberId: member.canonicalMemberId ?? observed.pointer.memberId,
             typeInfo: toWireType(storageType, this.project),
             writability
           },
-          listener
-        };
+          storageType,
+          scope,
+          pos
+        );
       }
       /**
        * P106. A getter subscription lives only in the running client's memory:
        * nothing persists it, so construction replay would silently drop one.
        */
-      resolveGetterSubscription(statement, getterRead, observed, pointer, member, scope) {
+      resolveGetterChangeListener(getterRead, observed, pointer, member, scope, pos, edit) {
         if (pointer.dispatch === "base") {
           throw new CompileError(
             `OnChanged can't observe a base getter. Subscribe to '${member.name}' on the instance.`,
-            statement.pos
+            pos
           );
         }
         if (pointer.receiver.kind !== "instance") {
           throw new CompileError(
             `OnChanged requires an instance receiver for getter '${member.name}'.`,
-            statement.pos
+            pos
           );
         }
         const kind = this.context.kind;
         if (isNeoScriptConstructionDocumentKind(kind) || kind === "migration") {
           throw new CompileError(
-            `A getter subscription lives only for the play session, so ${dialogueBodyKindLabel(kind)} can't make one. Subscribe from a function.`,
-            statement.pos
-          );
-        }
-        if (!statement.value) {
-          throw new CompileError(
-            "OnChanged subscription requires a handler member.",
-            statement.pos
+            edit.kind === "clearChangeListeners" /* ClearChangeListeners */ ? `A getter subscription lives only for the play session, so ${dialogueBodyKindLabel(kind)} can't clear one. Clear from a function.` : `A getter subscription lives only for the play session, so ${dialogueBodyKindLabel(kind)} can't make one. Subscribe from a function.`,
+            pos
           );
         }
         const getterType = this.assignmentStorageType(
@@ -32920,23 +32929,36 @@ var init_strict_resolver = __esm({
           null,
           scope
         );
-        const listener = this.resolveActionListener(
-          statement.value,
-          { kind: "action", parameterTypes: [getterType] },
-          scope,
-          true,
-          true
-        );
-        return {
-          type: statement.op === "+=" ? "addChangeListener" /* AddChangeListener */ : "removeChangeListener" /* RemoveChangeListener */,
-          target: {
+        return this.changeListenerInstruction(
+          edit,
+          {
             owner: pointer.receiver.pointer,
             memberId: member.canonicalMemberId ?? pointer.memberId,
             typeInfo: toWireType(getterType, this.project),
             writability: "session" /* Session */
           },
-          listener
-        };
+          getterType,
+          scope,
+          pos
+        );
+      }
+      changeListenerInstruction(edit, target, observedType, scope, pos) {
+        if (edit.kind === "clearChangeListeners" /* ClearChangeListeners */)
+          return { type: edit.kind, target };
+        if (!edit.handler) {
+          throw new CompileError(
+            "OnChanged subscription requires a handler member.",
+            pos
+          );
+        }
+        const listener = this.resolveActionListener(
+          edit.handler,
+          { kind: "action", parameterTypes: [observedType] },
+          scope,
+          true,
+          true
+        );
+        return { type: edit.kind, target, listener };
       }
       /**
        * P62 §3.2. `+=` / `-=` on an NSAction member are subscription operators,
@@ -35054,6 +35076,8 @@ var init_strict_resolver = __esm({
             entryUserData
           };
         }
+        if (name === "OnChanged")
+          throw new CompileError(ON_CHANGED_OPERATIONS_ERROR, pos);
         throw new CompileError(
           `Cannot read member '${name}' on ${this.describe(receiver.type)}`,
           pos
@@ -51773,7 +51797,7 @@ var init_registry = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.74.0",
+      cliVersion: "0.75.0",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -78978,6 +79002,9 @@ function listenerWritesByOwner(state) {
   }
   return index.owners;
 }
+function changeListenerWriteEdit(write) {
+  return write.operation === "clear" ? { kind: "replace", targets: [] } : { kind: write.operation, target: write.listener };
+}
 var indexes, empty;
 var init_listener_write_index = __esm({
   "../src/runtime/listener-write-index.ts"() {
@@ -81888,33 +81915,41 @@ function finalizeConstructorAllocations(ctx, returnValue, ownsInvocationState, r
   const listenerEdges = /* @__PURE__ */ new Map();
   for (const write of state.writes) {
     if (!retainListenerReceivers || write.kind !== "changeListener") continue;
+    const slotKey = JSON.stringify([write.ownerId, write.memberId]);
+    if (write.operation === "clear") {
+      listenerEdges.delete(slotKey);
+      continue;
+    }
     const key = JSON.stringify([
-      write.ownerId,
-      write.memberId,
       write.listener.memberId,
       write.listener.valueId
     ]);
-    if (write.operation === "remove") listenerEdges.delete(key);
-    else listenerEdges.set(key, write);
+    let edges = listenerEdges.get(slotKey);
+    if (write.operation === "remove") edges?.delete(key);
+    else {
+      if (edges === void 0) listenerEdges.set(slotKey, edges = /* @__PURE__ */ new Map());
+      edges.set(key, write);
+    }
   }
   const externalListenerReceivers = /* @__PURE__ */ new Set();
-  for (const write of listenerEdges.values()) {
-    if (write.listener.valueId === null) continue;
-    const receiverGroup = groupByRowId.get(write.listener.valueId);
-    if (receiverGroup === void 0) continue;
-    const ownerGroup = groupByRowId.get(write.ownerId);
-    if (ownerGroup === void 0) {
-      if (rowForCleanup(write.ownerId) !== null)
-        externalListenerReceivers.add(receiverGroup);
-    } else {
-      let dependencies = state.constructorGroupDependencies.get(ownerGroup);
-      if (dependencies === void 0) {
-        dependencies = /* @__PURE__ */ new Set();
-        state.constructorGroupDependencies.set(ownerGroup, dependencies);
+  for (const edges of listenerEdges.values())
+    for (const write of edges.values()) {
+      if (write.listener.valueId === null) continue;
+      const receiverGroup = groupByRowId.get(write.listener.valueId);
+      if (receiverGroup === void 0) continue;
+      const ownerGroup = groupByRowId.get(write.ownerId);
+      if (ownerGroup === void 0) {
+        if (rowForCleanup(write.ownerId) !== null)
+          externalListenerReceivers.add(receiverGroup);
+      } else {
+        let dependencies = state.constructorGroupDependencies.get(ownerGroup);
+        if (dependencies === void 0) {
+          dependencies = /* @__PURE__ */ new Set();
+          state.constructorGroupDependencies.set(ownerGroup, dependencies);
+        }
+        dependencies.add(receiverGroup);
       }
-      dependencies.add(receiverGroup);
     }
-  }
   const markConstructorGroupEscaped = (rootId) => {
     if (escapedRoots.has(rootId)) return;
     escapedRoots.add(rootId);
@@ -82111,7 +82146,7 @@ function finalizeConstructorAllocations(ctx, returnValue, ownsInvocationState, r
     const survivingWrites = state.writes.filter((write) => {
       if (write.kind === "changeListener") {
         if (collectedIds.has(write.ownerId)) return false;
-        return write.listener.valueId === null || !collectedIds.has(write.listener.valueId);
+        return write.operation === "clear" || write.listener.valueId === null || !collectedIds.has(write.listener.valueId);
       }
       const destination = write.resolvedDestination;
       const destinationId = destination !== void 0 && "containerValueId" in destination ? destination.containerValueId : void 0;
@@ -82752,7 +82787,8 @@ function evalInstructions(instructions, scope, ctx, options) {
           break;
         }
         case "addChangeListener" /* addChangeListener */:
-        case "removeChangeListener" /* removeChangeListener */: {
+        case "removeChangeListener" /* removeChangeListener */:
+        case "clearChangeListeners" /* clearChangeListeners */: {
           evalChangeListenerInstruction(ins, scope, ctx, options);
           break;
         }
@@ -83182,6 +83218,18 @@ function evalChangeListenerInstruction(ins, scope, ctx, options) {
     throw new NSGetterRuntimeError(
       `OnChanged member '${ins.target.memberId}' is not an observable member or getter of owner '${owner.id}'.`
     );
+  if (ins.type === "clearChangeListeners" /* clearChangeListeners */) {
+    if (getter !== null) clearGetterSubscription(getter, ctx);
+    else
+      options.writes.push({
+        kind: "changeListener",
+        target: ins.target,
+        ownerId: owner.id,
+        memberId: slot.memberId,
+        operation: "clear"
+      });
+    return;
+  }
   const listener = evalPointer(ins.listener, scope, ctx);
   if (!isMemberDelegateTarget(listener))
     throw new NSGetterRuntimeError(
@@ -83238,6 +83286,17 @@ function editGetterSubscription(slot, target, add, ctx) {
   }
   subscription.targets.push(target);
 }
+function clearGetterSubscription(slot, ctx) {
+  if ((ctx.__executionState?.constructionStack.length ?? 0) > 0)
+    throw new NSGetterRuntimeError(
+      "A getter subscription lives only for the play session, so a constructor can't clear one. Clear from a function."
+    );
+  const subscriptions = ctx.__getterSubscriptions;
+  const subscription = subscriptions?.get(slot.owner.id, slot.memberId);
+  if (subscriptions === void 0 || subscription === void 0) return;
+  subscription.targets.length = 0;
+  subscriptions.drop(subscription);
+}
 function dispatchGetterSubscriptions(ctx) {
   const subscriptions = ctx.__getterSubscriptions;
   if (subscriptions === void 0) return;
@@ -91540,7 +91599,7 @@ function cloneClassValueGraph(receiver, expectedClassId, ctx) {
         const edit = editChangeListenerSet(
           entry?.[write.memberId],
           [],
-          { kind: write.operation, target: write.listener },
+          changeListenerWriteEdit(write),
           { inheritedComplete: false }
         );
         if (!edit.changed) continue;
@@ -109013,10 +109072,11 @@ function migrationMemberListenerRows(document, writes, copied) {
     const map = root.changeListeners;
     const entry = map[write.ownerId] ?? {};
     const inherited = reader.listenerDefaultsForOwner(write.ownerId)?.[write.memberId] ?? [];
-    const edit = editChangeListenerSet(entry[write.memberId], inherited, {
-      kind: write.operation,
-      target: write.listener
-    });
+    const edit = editChangeListenerSet(
+      entry[write.memberId],
+      inherited,
+      changeListenerWriteEdit(write)
+    );
     if (!edit.changed) continue;
     if (edit.targets === void 0) delete entry[write.memberId];
     else entry[write.memberId] = edit.targets;
@@ -109049,6 +109109,7 @@ var init_project_migration_member_listeners = __esm({
     init_members();
     init_project_root_members();
     init_member_change_listeners();
+    init_listener_write_index();
     init_authored_listener_endpoints();
   }
 });
@@ -172172,7 +172233,7 @@ var init_project_unity_export_types = __esm({
   "../src/models/exports/project-unity-export-types.ts"() {
     "use strict";
     init_unity_codegen_revision();
-    PROJECT_UNITY_EXPORT_SCHEMA_VERSION = 40;
+    PROJECT_UNITY_EXPORT_SCHEMA_VERSION = 41;
   }
 });
 
@@ -189159,7 +189220,7 @@ var init_member_change_listener_runtime = __esm({
         for (const ownerId of owners)
           for (const write of writes.get(ownerId) ?? []) {
             const slot = this.slot(write.ownerId, write.memberId);
-            if (slot === null || this.targetTier(slot, write.listener)?.tier !== "save")
+            if (slot === null || write.operation !== "clear" && this.targetTier(slot, write.listener)?.tier !== "save")
               continue;
             const entry = map[write.ownerId] ?? {};
             const inherited = this.baseline(slot, "save");
@@ -189173,7 +189234,7 @@ var init_member_change_listener_runtime = __esm({
             const edited = editChangeListenerSet(
               durable,
               inherited.targets,
-              { kind: write.operation, target: write.listener },
+              changeListenerWriteEdit(write),
               { inheritedComplete: inherited.complete }
             );
             if (!edited.changed) continue;
@@ -189265,41 +189326,48 @@ var init_member_change_listener_runtime = __esm({
             throw new Error(
               `OnChanged slot '${write.ownerId}/${write.memberId}' is not writable in this runtime.`
             );
-          let target;
+          const targets = [];
           if (write.operation === "reset")
-            target = { tier: write.tier, edit: { kind: "reset" } };
-          else {
+            targets.push({ tier: write.tier, edit: { kind: "reset" } });
+          else if (write.operation === "clear") {
+            const edit = changeListenerWriteEdit(write);
+            if (slot.storage !== 3 /* Session */)
+              targets.push({ tier: "save", edit });
+            targets.push({ tier: "session", edit });
+          } else {
             const resolved = this.targetTier(slot, write.listener);
             if (resolved === null)
               throw new Error(
                 `OnChanged handler '${write.listener.memberId}' is incompatible with '${write.ownerId}/${write.memberId}'.`
               );
             const inSession = current("session", slot.rootId, slot.owner.id)?.[slot.memberId]?.some(
-              (existing2) => nsActionListenerIdentity(existing2) === nsActionListenerIdentity(resolved.target)
+              (existing) => nsActionListenerIdentity(existing) === nsActionListenerIdentity(resolved.target)
             );
-            target = {
+            targets.push({
               tier: inSession ? "session" : resolved.tier,
               edit: { kind: write.operation, target: resolved.target }
-            };
+            });
+          }
+          for (const target of targets) {
+            this.host.assertWritable(slot, target.tier);
+            const existing = current(target.tier, slot.rootId, slot.owner.id);
+            const explicit = existing !== void 0 && Object.hasOwn(existing, slot.memberId) ? existing[slot.memberId] : void 0;
+            const baseline = this.baseline(
+              slot,
+              target.tier,
+              target.tier !== "save" || !adopting.has(slot.owner.id)
+            );
+            const result = editChangeListenerSet(
+              explicit,
+              baseline.targets,
+              target.edit,
+              { inheritedComplete: baseline.complete }
+            );
+            if (!result.changed) continue;
+            const entry = editOwner(target.tier, slot.rootId, slot.owner.id);
+            if (result.targets === void 0) delete entry[slot.memberId];
+            else setOwnField(entry, slot.memberId, result.targets);
           }
-          this.host.assertWritable(slot, target.tier);
-          const existing = current(target.tier, slot.rootId, slot.owner.id);
-          const explicit = existing !== void 0 && Object.hasOwn(existing, slot.memberId) ? existing[slot.memberId] : void 0;
-          const baseline = this.baseline(
-            slot,
-            target.tier,
-            target.tier !== "save" || !adopting.has(slot.owner.id)
-          );
-          const result = editChangeListenerSet(
-            explicit,
-            baseline.targets,
-            target.edit,
-            { inheritedComplete: baseline.complete }
-          );
-          if (!result.changed) continue;
-          const entry = editOwner(target.tier, slot.rootId, slot.owner.id);
-          if (result.targets === void 0) delete entry[slot.memberId];
-          else setOwnField(entry, slot.memberId, result.targets);
         }
         for (const tier of ["save", "session"]) {
           for (const [rootId, changed] of pending[tier]) {
@@ -190173,7 +190241,7 @@ var init_dialogue_dryrun_listeners = __esm({
         this.copied = context.__copiedChangeListeners ?? this.copied;
         this.runtime.retireOwners(context.__removedValueIds ?? []);
         const listenerWrites = evaluatedWrites(result).filter(
-          (write) => write.kind === "changeListener" && !context.__removedValueIds?.has(write.ownerId) && (write.listener.valueId === null || !context.__removedValueIds?.has(write.listener.valueId))
+          (write) => write.kind === "changeListener" && !context.__removedValueIds?.has(write.ownerId) && (write.operation === "clear" || write.listener.valueId === null || !context.__removedValueIds?.has(write.listener.valueId))
         );
         const adopted = new Set(
           (result.createdSessionValues ?? []).map((row) => row.id)
@@ -191907,7 +191975,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.74.0");
+    console.log("0.75.0");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/dist/test-worker.mjs

@@ -3629,24 +3629,30 @@ function isNSInstructionTry(value) {
   }
   return true;
 }
-function isNSInstructionChangeListener(value) {
-  const instruction = value;
-  if (instruction?.type !== "addChangeListener" /* addChangeListener */ && instruction?.type !== "removeChangeListener" /* removeChangeListener */)
-    return false;
-  const target = instruction.target;
+function isNSChangeListenerTarget(value) {
+  const target = value;
   if (!target || typeof target.memberId !== "string" || target.memberId.length === 0)
     return false;
   if (!isNSPointer(target.owner) || !isNSTypeInfo(target.typeInfo))
     return false;
-  if (!Object.values(NSWritability).includes(target.writability)) return false;
-  return isNSPointer(instruction.listener);
+  return target.writability !== void 0 && Object.values(NSWritability).includes(target.writability);
+}
+function isNSInstructionChangeListener(value) {
+  const instruction = value;
+  if (instruction?.type !== "addChangeListener" /* addChangeListener */ && instruction?.type !== "removeChangeListener" /* removeChangeListener */)
+    return false;
+  return isNSChangeListenerTarget(instruction.target) && isNSPointer(instruction.listener);
+}
+function isNSInstructionClearChangeListeners(value) {
+  const instruction = value;
+  return instruction?.type === "clearChangeListeners" /* clearChangeListeners */ && isNSChangeListenerTarget(instruction.target);
 }
 function isNSInstructionDebug(value) {
   const v = value;
   return v?.type === "debug" /* debug */ && ["log", "warning", "error", "assert"].includes(v.severity ?? "") && isNSPointer(v.message) && isNSTypeInfo(v.messageType) && (v.severity === "assert" ? isNSPointer(v.condition) : v.condition === void 0);
 }
 function isNSInstruction(value) {
-  return isNSInstructionDebug(value) || isNSInstructionVariable(value) || isNSInstructionIfBranch(value) || isNSInstructionReturn(value) || isNSInstructionThrow(value) || isNSInstructionAssign(value) || isNSInstructionCollectionCall(value) || isNSInstructionFunctionCall(value) || isNSInstructionConditionLoop(value) || isNSInstructionFor(value) || isNSInstructionForEach(value) || isNSInstructionBreak(value) || isNSInstructionContinue(value) || isNSInstructionSwitch(value) || isNSInstructionTry(value) || isNSInstructionChangeListener(value) || isNSInstructionAddActionListener(value) || isNSInstructionRemoveActionListener(value);
+  return isNSInstructionDebug(value) || isNSInstructionVariable(value) || isNSInstructionIfBranch(value) || isNSInstructionReturn(value) || isNSInstructionThrow(value) || isNSInstructionAssign(value) || isNSInstructionCollectionCall(value) || isNSInstructionFunctionCall(value) || isNSInstructionConditionLoop(value) || isNSInstructionFor(value) || isNSInstructionForEach(value) || isNSInstructionBreak(value) || isNSInstructionContinue(value) || isNSInstructionSwitch(value) || isNSInstructionTry(value) || isNSInstructionChangeListener(value) || isNSInstructionClearChangeListeners(value) || isNSInstructionAddActionListener(value) || isNSInstructionRemoveActionListener(value);
 }
 function isNSInstructions(value) {
   return Array.isArray(value) && value.every(isNSInstruction);
@@ -13204,6 +13210,9 @@ function listenerWritesByOwner(state) {
   }
   return index.owners;
 }
+function changeListenerWriteEdit(write) {
+  return write.operation === "clear" ? { kind: "replace", targets: [] } : { kind: write.operation, target: write.listener };
+}
 
 // ../src/runtime/neoscript/typed-aggregate-row-references.ts
 function visitTypedAggregateRowReferences(value, rawType, visitor) {
@@ -17032,33 +17041,41 @@ function finalizeConstructorAllocations(ctx, returnValue, ownsInvocationState, r
   const listenerEdges = /* @__PURE__ */ new Map();
   for (const write of state.writes) {
     if (!retainListenerReceivers || write.kind !== "changeListener") continue;
+    const slotKey = JSON.stringify([write.ownerId, write.memberId]);
+    if (write.operation === "clear") {
+      listenerEdges.delete(slotKey);
+      continue;
+    }
     const key = JSON.stringify([
-      write.ownerId,
-      write.memberId,
       write.listener.memberId,
       write.listener.valueId
     ]);
-    if (write.operation === "remove") listenerEdges.delete(key);
-    else listenerEdges.set(key, write);
+    let edges = listenerEdges.get(slotKey);
+    if (write.operation === "remove") edges?.delete(key);
+    else {
+      if (edges === void 0) listenerEdges.set(slotKey, edges = /* @__PURE__ */ new Map());
+      edges.set(key, write);
+    }
   }
   const externalListenerReceivers = /* @__PURE__ */ new Set();
-  for (const write of listenerEdges.values()) {
-    if (write.listener.valueId === null) continue;
-    const receiverGroup = groupByRowId.get(write.listener.valueId);
-    if (receiverGroup === void 0) continue;
-    const ownerGroup = groupByRowId.get(write.ownerId);
-    if (ownerGroup === void 0) {
-      if (rowForCleanup(write.ownerId) !== null)
-        externalListenerReceivers.add(receiverGroup);
-    } else {
-      let dependencies = state.constructorGroupDependencies.get(ownerGroup);
-      if (dependencies === void 0) {
-        dependencies = /* @__PURE__ */ new Set();
-        state.constructorGroupDependencies.set(ownerGroup, dependencies);
+  for (const edges of listenerEdges.values())
+    for (const write of edges.values()) {
+      if (write.listener.valueId === null) continue;
+      const receiverGroup = groupByRowId.get(write.listener.valueId);
+      if (receiverGroup === void 0) continue;
+      const ownerGroup = groupByRowId.get(write.ownerId);
+      if (ownerGroup === void 0) {
+        if (rowForCleanup(write.ownerId) !== null)
+          externalListenerReceivers.add(receiverGroup);
+      } else {
+        let dependencies = state.constructorGroupDependencies.get(ownerGroup);
+        if (dependencies === void 0) {
+          dependencies = /* @__PURE__ */ new Set();
+          state.constructorGroupDependencies.set(ownerGroup, dependencies);
+        }
+        dependencies.add(receiverGroup);
       }
-      dependencies.add(receiverGroup);
     }
-  }
   const markConstructorGroupEscaped = (rootId) => {
     if (escapedRoots.has(rootId)) return;
     escapedRoots.add(rootId);
@@ -17255,7 +17272,7 @@ function finalizeConstructorAllocations(ctx, returnValue, ownsInvocationState, r
     const survivingWrites = state.writes.filter((write) => {
       if (write.kind === "changeListener") {
         if (collectedIds.has(write.ownerId)) return false;
-        return write.listener.valueId === null || !collectedIds.has(write.listener.valueId);
+        return write.operation === "clear" || write.listener.valueId === null || !collectedIds.has(write.listener.valueId);
       }
       const destination = write.resolvedDestination;
       const destinationId = destination !== void 0 && "containerValueId" in destination ? destination.containerValueId : void 0;
@@ -18009,7 +18026,8 @@ function evalInstructions(instructions, scope, ctx, options) {
           break;
         }
         case "addChangeListener" /* addChangeListener */:
-        case "removeChangeListener" /* removeChangeListener */: {
+        case "removeChangeListener" /* removeChangeListener */:
+        case "clearChangeListeners" /* clearChangeListeners */: {
           evalChangeListenerInstruction(ins, scope, ctx, options);
           break;
         }
@@ -18430,6 +18448,18 @@ function evalChangeListenerInstruction(ins, scope, ctx, options) {
     throw new NSGetterRuntimeError(
       `OnChanged member '${ins.target.memberId}' is not an observable member or getter of owner '${owner.id}'.`
     );
+  if (ins.type === "clearChangeListeners" /* clearChangeListeners */) {
+    if (getter !== null) clearGetterSubscription(getter, ctx);
+    else
+      options.writes.push({
+        kind: "changeListener",
+        target: ins.target,
+        ownerId: owner.id,
+        memberId: slot.memberId,
+        operation: "clear"
+      });
+    return;
+  }
   const listener = evalPointer(ins.listener, scope, ctx);
   if (!isMemberDelegateTarget(listener))
     throw new NSGetterRuntimeError(
@@ -18486,6 +18516,17 @@ function editGetterSubscription(slot, target, add, ctx) {
   }
   subscription.targets.push(target);
 }
+function clearGetterSubscription(slot, ctx) {
+  if ((ctx.__executionState?.constructionStack.length ?? 0) > 0)
+    throw new NSGetterRuntimeError(
+      "A getter subscription lives only for the play session, so a constructor can't clear one. Clear from a function."
+    );
+  const subscriptions = ctx.__getterSubscriptions;
+  const subscription = subscriptions?.get(slot.owner.id, slot.memberId);
+  if (subscriptions === void 0 || subscription === void 0) return;
+  subscription.targets.length = 0;
+  subscriptions.drop(subscription);
+}
 function dispatchGetterSubscriptions(ctx) {
   const subscriptions = ctx.__getterSubscriptions;
   if (subscriptions === void 0) return;
@@ -26802,7 +26843,7 @@ function cloneClassValueGraph(receiver, expectedClassId, ctx) {
         const edit = editChangeListenerSet(
           entry?.[write.memberId],
           [],
-          { kind: write.operation, target: write.listener },
+          changeListenerWriteEdit(write),
           { inheritedComplete: false }
         );
         if (!edit.changed) continue;
@@ -34329,6 +34370,7 @@ var WRITE_TARGET_DESCRIPTIONS = {
   projectValue: "a stored project value",
   unknown: "something other than `this` or a local"
 };
+var ON_CHANGED_OPERATIONS_ERROR = "OnChanged supports only '+=', '-=', and Clear().";
 var FALLTHROUGH_LABELS = {
   function: "NSFunction",
   getter: "getter",
@@ -35671,6 +35713,12 @@ var StrictNeoScriptResolver = class _StrictNeoScriptResolver {
           this.resolveExpression(statement.expr, scope);
         const debug = this.resolveDebugStatement(statement.expr, scope);
         if (debug) return debug;
+        const listenerClear = this.resolveChangeListenerClear(
+          statement.expr,
+          scope,
+          statement.pos
+        );
+        if (listenerClear) return listenerClear;
         const actionClear = this.resolveActionClear(
           statement.expr,
           scope,
@@ -36031,8 +36079,20 @@ var StrictNeoScriptResolver = class _StrictNeoScriptResolver {
       const observed = this.resolveExpression(statement.target.receiver, scope);
       const observedType = neoScriptMemberLookupType(observed.type);
       const declared = observedType.kind === "named" && this.project.typeById.get(observedType.typeId)?.members.some((member) => member.name === "OnChanged");
-      if (!declared)
-        return this.resolveChangeSubscription(statement, observed, scope);
+      if (!declared) {
+        if (statement.op !== "+=" && statement.op !== "-=")
+          throw new CompileError(ON_CHANGED_OPERATIONS_ERROR, statement.pos);
+        return this.resolveChangeListener(
+          statement.target,
+          observed,
+          scope,
+          statement.pos,
+          {
+            kind: statement.op === "+=" ? "addChangeListener" /* AddChangeListener */ : "removeChangeListener" /* RemoveChangeListener */,
+            handler: statement.value
+          }
+        );
+      }
     }
     const local = statement.target.kind === "ident" ? scope.lookup(statement.target.name) : null;
     if (local?.readonlyBinding) {
@@ -36216,158 +36276,142 @@ var StrictNeoScriptResolver = class _StrictNeoScriptResolver {
       pos
     );
   }
-  resolveChangeSubscription(statement, observed, scope) {
-    if (statement.op !== "+=" && statement.op !== "-=") {
-      throw new CompileError(
-        "OnChanged supports only '+=' and '-=' subscriptions.",
-        statement.pos
-      );
-    }
-    if (statement.target.kind !== "member") {
+  /** `X.M.OnChanged.Clear()` empties M's listener set on X (P70, P106). */
+  resolveChangeListenerClear(expression, scope, pos) {
+    if (expression.kind !== "call" || expression.callee.kind !== "member" || expression.callee.name !== "Clear" || expression.callee.receiver.kind !== "member" || expression.callee.receiver.name !== "OnChanged")
+      return null;
+    const onChanged = expression.callee.receiver;
+    const observed = this.resolveExpression(onChanged.receiver, scope);
+    const observedType = neoScriptMemberLookupType(observed.type);
+    if (observedType.kind === "named" && this.project.typeById.get(observedType.typeId)?.members.some((member) => member.name === "OnChanged"))
+      return null;
+    if (expression.callee.optional)
       throw new CompileError(
-        "OnChanged requires a declared member slot.",
-        statement.pos
+        "OnChanged is never null, so optional-chained Clear is not supported.",
+        pos
       );
-    }
-    if (statement.target.optional) {
+    requireArgCount("Clear", expression.args, 0, pos);
+    return this.resolveChangeListener(onChanged, observed, scope, pos, {
+      kind: "clearChangeListeners" /* ClearChangeListeners */
+    });
+  }
+  resolveChangeListener(onChanged, observed, scope, pos, edit) {
+    if (onChanged.optional) {
       throw new CompileError(
         "OnChanged cannot use an optional subscription target.",
-        statement.pos
+        pos
       );
     }
     if (observed.optionalChainType !== void 0) {
       throw new CompileError(
         "OnChanged cannot subscribe through optional chaining; narrow the receiver first.",
-        statement.pos
+        pos
       );
     }
     const member = observed.symbol;
     if (!member)
       throw new CompileError(
         "OnChanged requires a declared member, not a local variable.",
-        statement.pos
+        pos
       );
     if (observed.pointer.type === "staticMember" /* StaticMember */ || observed.pointer.type === "callGetter" /* CallGetter */ && observed.pointer.receiver.kind === "static") {
-      const access = statement.target.receiver;
+      const access = onChanged.receiver;
       const name = access.kind === "member" && access.receiver.kind === "ident" ? `${access.receiver.name}.${member.name}` : member.name;
       throw new CompileError(
         `OnChanged requires an instance member. '${name}' is static.`,
-        statement.pos
+        pos
       );
     }
     if (observed.pointer.type === "callGetter" /* CallGetter */)
-      return this.resolveGetterSubscription(
-        statement,
-        statement.target.receiver,
+      return this.resolveGetterChangeListener(
+        onChanged.receiver,
         observed,
         observed.pointer,
         member,
-        scope
+        scope,
+        pos,
+        edit
       );
     if (observed.pointer.type !== "keyOf" /* KeyOf */)
-      throw new CompileError(
-        "OnChanged requires a declared member slot.",
-        statement.pos
-      );
+      throw new CompileError("OnChanged requires a declared member slot.", pos);
     if (!observed.pointer.memberId)
       throw new CompileError(
         "OnChanged cannot observe a collection entry.",
-        statement.pos
+        pos
       );
     if (member.computed) {
       throw new CompileError(
         "OnChanged cannot observe a computed member.",
-        statement.pos
+        pos
       );
     }
     if (member.readonlyDeclaration) {
       throw new CompileError(
         "OnChanged cannot observe a readonly declaration.",
-        statement.pos
+        pos
       );
     }
     if (observed.type.kind === "delegate" || observed.type.kind === "action") {
       throw new CompileError(
         "OnChanged cannot observe a callable member.",
-        statement.pos
+        pos
       );
     }
     const writability = observed.userData ? "runtime" /* Runtime */ : observed.writability;
     if (writability !== "save" /* Save */ && writability !== "session" /* Session */ && writability !== "runtime" /* Runtime */ && writability !== "local" /* Local */) {
       throw new CompileError(
         "OnChanged requires a member whose storage is writable at gameplay runtime.",
-        statement.pos
+        pos
       );
     }
     this.validateConstructorWriteTarget(
       observed.pointer,
-      "subscribe to",
-      statement.pos,
+      edit.kind === "clearChangeListeners" /* ClearChangeListeners */ ? "clear listeners on" : "subscribe to",
+      pos,
       scope,
       false
     );
-    if (!statement.value) {
-      throw new CompileError(
-        "OnChanged subscription requires a handler member.",
-        statement.pos
-      );
-    }
     const storageType = this.assignmentStorageType(
-      statement.target.receiver,
+      onChanged.receiver,
       observed,
       null,
       scope
     );
-    const expected = {
-      kind: "action",
-      parameterTypes: [storageType]
-    };
-    const listener = this.resolveActionListener(
-      statement.value,
-      expected,
-      scope,
-      true,
-      true
-    );
-    return {
-      type: statement.op === "+=" ? "addChangeListener" /* AddChangeListener */ : "removeChangeListener" /* RemoveChangeListener */,
-      target: {
+    return this.changeListenerInstruction(
+      edit,
+      {
         owner: observed.pointer.keyOf.pointer,
         memberId: member.canonicalMemberId ?? observed.pointer.memberId,
         typeInfo: toWireType(storageType, this.project),
         writability
       },
-      listener
-    };
+      storageType,
+      scope,
+      pos
+    );
   }
   /**
    * P106. A getter subscription lives only in the running client's memory:
    * nothing persists it, so construction replay would silently drop one.
    */
-  resolveGetterSubscription(statement, getterRead, observed, pointer, member, scope) {
+  resolveGetterChangeListener(getterRead, observed, pointer, member, scope, pos, edit) {
     if (pointer.dispatch === "base") {
       throw new CompileError(
         `OnChanged can't observe a base getter. Subscribe to '${member.name}' on the instance.`,
-        statement.pos
+        pos
       );
     }
     if (pointer.receiver.kind !== "instance") {
       throw new CompileError(
         `OnChanged requires an instance receiver for getter '${member.name}'.`,
-        statement.pos
+        pos
       );
     }
     const kind = this.context.kind;
     if (isNeoScriptConstructionDocumentKind(kind) || kind === "migration") {
       throw new CompileError(
-        `A getter subscription lives only for the play session, so ${dialogueBodyKindLabel(kind)} can't make one. Subscribe from a function.`,
-        statement.pos
-      );
-    }
-    if (!statement.value) {
-      throw new CompileError(
-        "OnChanged subscription requires a handler member.",
-        statement.pos
+        edit.kind === "clearChangeListeners" /* ClearChangeListeners */ ? `A getter subscription lives only for the play session, so ${dialogueBodyKindLabel(kind)} can't clear one. Clear from a function.` : `A getter subscription lives only for the play session, so ${dialogueBodyKindLabel(kind)} can't make one. Subscribe from a function.`,
+        pos
       );
     }
     const getterType = this.assignmentStorageType(
@@ -36376,23 +36420,36 @@ var StrictNeoScriptResolver = class _StrictNeoScriptResolver {
       null,
       scope
     );
-    const listener = this.resolveActionListener(
-      statement.value,
-      { kind: "action", parameterTypes: [getterType] },
-      scope,
-      true,
-      true
-    );
-    return {
-      type: statement.op === "+=" ? "addChangeListener" /* AddChangeListener */ : "removeChangeListener" /* RemoveChangeListener */,
-      target: {
+    return this.changeListenerInstruction(
+      edit,
+      {
         owner: pointer.receiver.pointer,
         memberId: member.canonicalMemberId ?? pointer.memberId,
         typeInfo: toWireType(getterType, this.project),
         writability: "session" /* Session */
       },
-      listener
-    };
+      getterType,
+      scope,
+      pos
+    );
+  }
+  changeListenerInstruction(edit, target, observedType, scope, pos) {
+    if (edit.kind === "clearChangeListeners" /* ClearChangeListeners */)
+      return { type: edit.kind, target };
+    if (!edit.handler) {
+      throw new CompileError(
+        "OnChanged subscription requires a handler member.",
+        pos
+      );
+    }
+    const listener = this.resolveActionListener(
+      edit.handler,
+      { kind: "action", parameterTypes: [observedType] },
+      scope,
+      true,
+      true
+    );
+    return { type: edit.kind, target, listener };
   }
   /**
    * P62 §3.2. `+=` / `-=` on an NSAction member are subscription operators,
@@ -38510,6 +38567,8 @@ var StrictNeoScriptResolver = class _StrictNeoScriptResolver {
         entryUserData
       };
     }
+    if (name === "OnChanged")
+      throw new CompileError(ON_CHANGED_OPERATIONS_ERROR, pos);
     throw new CompileError(
       `Cannot read member '${name}' on ${this.describe(receiver.type)}`,
       pos
@@ -55688,7 +55747,7 @@ var SPECIALIZED_RELATION_KINDS = /* @__PURE__ */ new Set([
 
 // ../packages/manifest/schema-contract/registry.mjs
 var PROJECT_SCHEMA_CONTRACT = Object.freeze({
-  cliVersion: "0.74.0",
+  cliVersion: "0.75.0",
   projectFileUploadBatchSize: 32,
   documentRecords: {
     member: {

package/package.json

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

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

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

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

@@ -557,7 +557,8 @@ receiver.Handler`; use `-=` to remove the same receiver/handler pair. Handlers
 are noncapturing, return void, and accept the field's type. Bindings to Session
 receivers stay Session-only. Gameplay hosts dispatch after the write batch.
 Authoring, replay, migration, and dialogue dry-run hosts retain wiring without
-invoking callbacks.
+invoking callbacks. `owner.Field.OnChanged.Clear()` removes every handler,
+including `@listeners` defaults, in both Save and Session wiring.
 
 Instance getters take the same syntax, for example
 `this._quantity.Value.OnChanged += this.QuantityChanged`. A getter
@@ -566,7 +567,8 @@ function, effect, lifecycle hook, or dialogue action, never a constructor,
 initializer, or migration. Subscribing reads the getter once. The SDK calls the
 handler with a fresh result whenever something that read depended on changes,
 even if the result is equal, and several changes before the next read call it
-once. Static getters, `base.Value`, and `@listeners` can't observe a getter.
+once. `Clear()` ends the subscription, and a constructor can't call it on a
+getter. Static getters, `base.Value`, and `@listeners` can't observe a getter.
 `neo test` dispatches getter subscriptions the same way, treating the test body
 as the host: handlers run after each of its statements, so the next statement
 sees their effects. A getter that reads through `Clone()` or a grid query can