@neocompose/cli 0.36.0 → 0.36.2

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.36.2] - 2026-08-19
+
+### Fixed
+
+- Report invalid ordinary member initializers at their authored file and token
+  in the CLI and editor. C# numeric suffixes such as `0f` now explain that the
+  suffix should be removed instead of surfacing as `<project>:1:1` with an EOF
+  parser error.
+- Accept `null` as the literal default of a nullable `NeoDelegate`, preventing
+  valid pending delegate members from failing prospective project,
+  initializer-materialization, and animation validation.
+
+## [0.36.1] - 2026-08-19
+
+### Fixed
+
+- Preserve authored function parameter defaults in live project-source symbols,
+  so calls may omit a defaulted trailing argument and hover/signature help show
+  the declared `= value`.
+- Store direct field and property reads, including static getters such as
+  `FeatureFlags.StartInventorySize`, as executable member initializers instead
+  of rejecting them as unresolved persisted literals.
+
 ## [0.36.0] - 2026-08-19
 
 ### Added

package/dist/neo.mjs

@@ -22973,7 +22973,15 @@ function validateDeclaration(uri, declaration, documentKind, environment, diagno
     scope.set(member.name, semanticType(member.type));
   }
   for (const member of declaration.members) {
-    validateMember(uri, member, documentKind, scope, environment, diagnostics);
+    validateMember(
+      uri,
+      member,
+      declaration.name,
+      documentKind,
+      scope,
+      environment,
+      diagnostics
+    );
   }
   if (declaration.kind === "class") {
     validateRetiredParameterReads(uri, declaration, scope, diagnostics);
@@ -23243,7 +23251,7 @@ function slotPosition(start, pos) {
   }
   return { line: start.line + pos.line - 1, character: pos.column - 1 };
 }
-function validateMember(uri, member, documentKind, ownerScope, environment, diagnostics) {
+function validateMember(uri, member, ownerName, documentKind, ownerScope, environment, diagnostics) {
   const memberType2 = semanticType(member.type);
   validateAnnotations(
     uri,
@@ -23285,7 +23293,11 @@ function validateMember(uri, member, documentKind, ownerScope, environment, diag
       environment,
       member.initializer.range,
       diagnostics,
-      anchorOf(member.initializer)
+      anchorOf(member.initializer),
+      {
+        code: "invalid-project-member-initializer",
+        label: `Member '${ownerName}.${member.name}' initializer`
+      }
     );
   }
   if (documentKind === "flow" && member.flowInitializer?.body?.kind === "block") {
@@ -23789,7 +23801,7 @@ function settingsClassFields(name) {
 function anchorOf(source) {
   return { text: source.text, start: source.range.start };
 }
-function validateExpressionText(uri, text, expected, scope, environment, range2, diagnostics, anchor) {
+function validateExpressionText(uri, text, expected, scope, environment, range2, diagnostics, anchor, syntaxDiagnostic) {
   try {
     validateExpression(
       parseExpression(text),
@@ -23803,8 +23815,38 @@ function validateExpressionText(uri, text, expected, scope, environment, range2,
     );
   } catch (error) {
     if (!(error instanceof CompileError)) throw error;
+    if (syntaxDiagnostic !== void 0) {
+      const errorRange = anchor === void 0 ? range2 : anchorSpan(
+        anchor,
+        { line: error.line, column: error.column },
+        anchorOffset(anchor, error) < text.length ? 1 : 0
+      );
+      pushDiagnostic(
+        diagnostics,
+        uri,
+        errorRange,
+        syntaxDiagnostic.code,
+        memberInitializerSyntaxMessage(syntaxDiagnostic.label, text, error)
+      );
+      return;
+    }
   }
 }
+function memberInitializerSyntaxMessage(label, text, error) {
+  const anchor = {
+    text,
+    start: { line: 0, character: 0 }
+  };
+  const offset = anchorOffset(anchor, error);
+  const suffix = text[offset];
+  const previous = text[offset - 1];
+  const next = text[offset + 1];
+  if (suffix !== void 0 && previous !== void 0 && /[fFdDmM]/u.test(suffix) && /[0-9]/u.test(previous) && (next === void 0 || !/[A-Za-z0-9_]/u.test(next))) {
+    return `${label} uses unsupported C# numeric suffix '${suffix}'. NeoScript numeric literals do not use suffixes; remove '${suffix}'.`;
+  }
+  const detail = error.message.replace(/^\d+:\d+:\s*/u, "");
+  return `${label} could not be parsed: ${detail}`;
+}
 function validateFunctionBody(uri, text, returnType, scope, environment, range2, diagnostics) {
   try {
     const source = stripOuterBraces2(text);
@@ -25290,13 +25332,14 @@ function compileProjectSourceBodies(documents) {
             implicitMemberAccess: true,
             staticMember: false,
             kind: "constructor",
-            parameters: constructor2.parameters.map((parameter4, index) => ({
-              id: `${declaredConstructorId(owner, declaration, constructor2)}:argument:${index}`,
-              name: parameter4.name,
-              type: sourceTypeRef(parameter4.type, owner, graph.typeIdsByName),
-              location: location(uri, parameter4.range),
-              selectionLocation: location(uri, parameter4.nameRange)
-            })),
+            parameters: constructor2.parameters.map(
+              (parameter4, index) => sourceParameter(
+                parameter4,
+                owner,
+                graph.typeIdsByName,
+                `${declaredConstructorId(owner, declaration, constructor2)}:argument:${index}`
+              )
+            ),
             functionName: constructor2.name
           },
           projectIndex,
@@ -25325,13 +25368,12 @@ function compileProjectSourceBodies(documents) {
             staticMember: false,
             kind: "constructor",
             parameters: (declaration.headerParameters ?? []).map(
-              (parameter4, index) => ({
-                id: `${initId}:argument:${index}`,
-                name: parameter4.name,
-                type: sourceTypeRef(parameter4.type, owner, graph.typeIdsByName),
-                location: location(uri, parameter4.range),
-                selectionLocation: location(uri, parameter4.nameRange)
-              })
+              (parameter4, index) => sourceParameter(
+                parameter4,
+                owner,
+                graph.typeIdsByName,
+                `${initId}:argument:${index}`
+              )
             ),
             functionName: "init"
           },
@@ -25368,13 +25410,14 @@ function compileProjectSourceBodies(documents) {
             context: {
               ...baseContext2,
               kind: "function",
-              parameters: member.parameters.map((parameter4, index) => ({
-                id: `${info.symbol.id}:argument:${index}`,
-                name: parameter4.name,
-                type: sourceTypeRef(parameter4.type, owner, graph.typeIdsByName),
-                location: location(uri, parameter4.range),
-                selectionLocation: location(uri, parameter4.nameRange)
-              })),
+              parameters: member.parameters.map(
+                (parameter4, index) => sourceParameter(
+                  parameter4,
+                  owner,
+                  graph.typeIdsByName,
+                  `${info.symbol.id}:argument:${index}`
+                )
+              ),
               deferred: member.modifiers.includes("async"),
               functionName: member.name
             },
@@ -25741,13 +25784,9 @@ function sourceMemberSymbol(member, owner, typeIds, source) {
       ...common,
       kind: "function",
       returnType: type,
-      parameters: member.parameters.map((parameter4, index) => ({
-        id: `${id2}:argument:${index}`,
-        name: parameter4.name,
-        type: sourceTypeRef(parameter4.type, owner, typeIds),
-        location: location(owner.uri, parameter4.range),
-        selectionLocation: location(owner.uri, parameter4.nameRange)
-      })),
+      parameters: member.parameters.map(
+        (parameter4, index) => sourceParameter(parameter4, owner, typeIds, `${id2}:argument:${index}`)
+      ),
       deferred: member.modifiers.includes("async"),
       ...member.modifiers.includes("native") ? { native: true } : {}
     };
@@ -25819,8 +25858,7 @@ function requiredConstructorSymbol(owner, declaration, typeIds) {
   return {
     id: requiredConstructorBodyId(owner),
     parameters: headerParameters.map((parameter4) => ({
-      name: parameter4.name,
-      type: sourceTypeRef(parameter4.type, owner, typeIds),
+      ...sourceParameter(parameter4, owner, typeIds),
       required: !parameter4.type.nullable
     })),
     required: true,
@@ -25831,14 +25869,23 @@ function declaredConstructorSymbol(owner, declaration, constructor2, typeIds) {
   return {
     id: declaredConstructorId(owner, declaration, constructor2),
     parameters: constructor2.parameters.map((parameter4) => ({
-      name: parameter4.name,
-      type: sourceTypeRef(parameter4.type, owner, typeIds),
+      ...sourceParameter(parameter4, owner, typeIds),
       required: !parameter4.type.nullable
     })),
     ...constructor2.docsText ? { documentation: constructor2.docsText } : {},
     location: location(owner.uri, constructor2.range)
   };
 }
+function sourceParameter(parameter4, owner, typeIds, id2) {
+  return {
+    ...id2 === void 0 ? {} : { id: id2 },
+    name: parameter4.name,
+    type: sourceTypeRef(parameter4.type, owner, typeIds),
+    ...parameter4.defaultValue === void 0 ? {} : { defaultValue: { displayText: parameter4.defaultValue.text } },
+    location: location(owner.uri, parameter4.range),
+    selectionLocation: location(owner.uri, parameter4.nameRange)
+  };
+}
 function substituteInheritedSourceMember(member, baseInfo, resolvedBaseType) {
   if (baseInfo.declaration.kind !== "class" || resolvedBaseType.kind !== "named") {
     return {
@@ -44533,6 +44580,7 @@ function isMemberDelegateBase(value) {
   if (defaultValue === void 0 || defaultValue === null) return true;
   if (!isMemberValueBase(defaultValue)) return false;
   if (isInitValueContent(defaultValue)) return true;
+  if (defaultValue.value === null) return v.required === false;
   return isNSDelegateValue(defaultValue.value);
 }
 function nsActionListenerIdentity(listener) {
@@ -59730,6 +59778,7 @@ function lowerExpressionValue(context, expression, declaredExpected, ownerClass,
 function positionRequiresEvaluation(context, expression, expected, ownerClass) {
   if (isStoredDelegateLiteral(expected, expression)) return false;
   if (isStoredActionLiteral(expected, expression)) return false;
+  if (isSourceMemberValueRead(context, expression, ownerClass)) return true;
   return initializerRequiresEvaluation(
     context.declaredConstructors,
     expression,
@@ -59740,6 +59789,36 @@ function positionRequiresEvaluation(context, expression, expected, ownerClass) {
     )
   );
 }
+function isSourceMemberValueRead(context, expression, ownerClass) {
+  let current = expression;
+  while (current.kind === "annotated") current = current.expression;
+  const path = expressionMemberPath(current);
+  if (path === null) return false;
+  const parts = path.split(".");
+  let classId;
+  let memberName;
+  let requiresStatic = false;
+  if (parts.length === 1 || parts.length === 2 && parts[0] === "this") {
+    classId = materializedId(ownerClass, "class", ownerClass.name);
+    memberName = parts.at(-1);
+  } else if (parts.length === 2) {
+    classId = context.classIdsByName.get(parts[0]);
+    memberName = parts[1];
+    requiresStatic = true;
+  } else {
+    const receiverPath = parts.slice(0, -1).join(".");
+    classId = context.rootValueTargetsByPath.get(receiverPath)?.classId;
+    memberName = parts.at(-1);
+  }
+  if (classId === void 0 || memberName === void 0) return false;
+  const memberId = effectiveMemberIdByName(context, classId, memberName);
+  if (memberId === null) return false;
+  const source = context.sourceMembersById.get(memberId)?.member;
+  if (source?.kind === "function") return false;
+  const schema = context.loweredMembers.get(memberId) ?? context.baseMembers.get(memberId);
+  const isStatic = source?.modifiers.includes("static") ?? schema?.isStatic ?? false;
+  return !requiresStatic || isStatic;
+}
 function isStoredDelegateLiteral(type, expression) {
   if (type.name !== "NeoDelegate") return false;
   let current = expression;
@@ -113795,7 +113874,7 @@ var init_registry2 = __esm({
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
       formatVersion: 3,
       contractVersion: "3.14",
-      cliVersion: "0.36.0",
+      cliVersion: "0.36.2",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -120397,7 +120476,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.36.0");
+    console.log("0.36.2");
     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.36.0",
+  "version": "0.36.2",
   "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.36.0 -->
+<!-- reviewed-through-cli: 0.36.2 -->
 
 # Neo Compose CLI
 

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.36.0 -->
+<!-- reviewed-through-cli: 0.36.2 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

package/skills/neocompose-cli/references/declarations-and-construction.md

@@ -154,6 +154,16 @@ components must be numeric literals. When a computed list or dictionary entry
 carries an authored `@id`, parenthesize the expression — `@id("row")
 (A.B / A.C)` — so the annotation names the row rather than its left operand.
 
+Numeric literals do not use C# suffixes: write `0` or `0.5`, not `0f` or
+`0.5f`. The declared/contextual type determines whether a literal is stored as
+an int, float, or decimal.
+
+A direct field or property read is computed too, whether it is local,
+qualified static, or reached through a stable root path. For example,
+`protected int Slots = FeatureFlags.StartInventorySize;` evaluates the current
+static field or getter whenever a new instance is constructed; it is not baked
+into a persisted literal during push.
+
 Declare overloadable constructors as members when each constructor body owns
 its parameter scope: