@neocompose/cli 0.84.2 → 0.84.4

package/package.json

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

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

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

package/skills/neocompose-cli/references/commands-and-sync.md

@@ -335,6 +335,9 @@ Generated animation clip targets and reference lookup factories retain construct
 generic arguments, including supported forwarded bindings. Clip getters use the
 declared target type when the owner is a derived class. Export reports an error
 when a clip target does not match the owner or one of its constructed base types.
+Inherited collection interface getters preserve supported detached temporaries.
+Constructed entries such as `Frame<T>` use the interface's generic argument
+family for both their collection type and value converters.
 New instances that reuse existing member-localized text retain its shared ID
 and translations in the export.
 

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

@@ -425,6 +425,10 @@ value-level target metadata.
 
 ## Computed initializers and declared constructors
 
+Inherited member initializers read parameters from the constructor that declared
+them, including when export materialization clones their bodies. A storage-only
+override keeps that original constructor scope.
+
 Use an expression initializer when a member default must be evaluated during
 construction rather than stored as a closed literal. It is replayed for omitted
 members in push, web, and SDK contexts. A stored override remains pinned until

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

@@ -224,7 +224,8 @@ unconstrained generic `T` compares by value.
 Calling `Equals(other)` on a non-null generic value dynamically uses the
 runtime Class's one-argument `Equals` Function or NSFunction when it returns
 `bool`, including the effective override. Values without that member fall back
-to value equality.
+to value equality. For local sets, that fallback compares their current entries
+in insertion order, regardless of prior reads or mutations.
 
 Object initializers are available in method bodies and `.spec.neo` tests:
 
@@ -387,6 +388,11 @@ may be null. The receiver stays unchanged.
 return "banana".Replace("a", "o"); // "bonono"
 ```
 
+Integer inputs assigned to `float` round to float32. This also applies to
+function arguments and returns, collection entries, and `List.Repeat` with a
+float entry type. `Contains` and `IndexOf` on float collections also convert
+integer search arguments. Nullable assignments preserve `null`.
+
 ## Collection builtins
 
 Lists expose their size as either `items.Count` or `items.Count()`. Use
@@ -399,8 +405,9 @@ Use `Any()` or `Any((item) => predicate)` to check for a match, and
 `All((item) => predicate)` to check every entry. Both short-circuit; an empty
 collection has `Any() == false` and `All(...) == true`.
 
-`Last`, `LastOrDefault`, `Single`, and `SingleOrDefault` accept zero arguments
-or one predicate. `Last` throws when no entry matches. `Single` throws unless
+`First`, `FirstOrDefault`, `Last`, `LastOrDefault`, `Single`, and `SingleOrDefault` accept zero arguments
+or one predicate. `First` and `Last` throw when no entry matches. Enum sets
+return enum values, including when a predicate selects the entry. `Single` throws unless
 exactly one matches; `SingleOrDefault` still throws for multiple matches.
 The `OrDefault` forms return nullable entries and use `null` for no match.
 
@@ -711,3 +718,7 @@ and may appear in any order. Use the existing nested positional override for a
 virtual owner; changing its listeners alone must not add a value override.
 Omitting a field inherits its listeners. An empty array suppresses inherited
 listeners and disappears when there is no inherited wiring to suppress.
+
+Decimal collection membership compares numeric values: `1.0` and `1.00` are
+equal for `ToSet`, `Contains`, `IndexOf`, `Add`, and `Remove`. Decimal scale
+is retained for display; string entries such as `"1.0"` and `"1.00"` stay distinct.

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

@@ -190,6 +190,13 @@ EligibleIngredients = root.Assets.Crafting.FurnaceRecipes
   .ToSet()
 ```
 
+`Box<Reference<Item>>` keeps its reference storage type through push and pull,
+including explicit `new Box<Reference<Item>>()` calls. Its `Item` targets stay
+shared; reading a class reference still produces the class value. A derived
+construction in a base-typed slot retains reference bindings forwarded through
+the inheritance chain, such as `Base<Reference<Item>>` holding
+`new Derived<Reference<Item>>()`.
+
 Writing `Reference(recipe.Ingredient)` inside the callback is also valid.
 `Reference(value)` preserves an evaluated class value and its identity; it does
 not clone it or turn it into a separate wrapper object. An optional generic
@@ -254,6 +261,17 @@ and declarations created in the same push. Preparation materializes the target
 collection and its required ancestor rows together, preserving the virtual
 identities. No preliminary push or manual value ID is needed.
 
+An object Root.neo writes is init-built when its class has an `init` block. A
+declaration binding may name a member inside it, and the push stores that
+member's row so the binding has a target. A reference an `init` block or
+constructor captures, such as `new Rule(Reference(this.Weather))`, stores its
+target's ID and keeps the target's row. Status refuses two forms, because their
+target has no row to check until the push stores it: a value row's reference to
+a member of an init-built object (bind it from a declaration instead), and a
+binding to a class or list an `init` block builds. A project an older CLI pushed
+with such a captured reference stored it without its target; push once to
+repair it.
+
 ## Defaults and localization
 
 A class member whose default constructs its declared type emits a contextual
@@ -265,6 +283,10 @@ that instance. Leaving the emitted construction unchanged creates no redundant
 value rows. A nullable member with no default remains bare; an explicit null
 default emits `= null`.
 
+Changing a construction to another overload or shared argument rebuilds the
+instance even when the argument values compare equal. Owned inline arguments
+still compare by contents; unchanged shared arguments keep their identities.
+
 Spelling an unchanged child default, such as `FPS = 8`, stays a no-op after
 push even when sibling fields own stored rows. Adding a different child default
 preserves those siblings' row identities; it does not transfer their ownership.
@@ -388,3 +410,8 @@ is an error; remove the declaration to request deletion.
 New schema getters referenced by NeoFlow interpolation need no `@id`. Export and
 `neo dev` assign the same identity to the declaration and its references, including
 inherited getters. Repeated exports and the next push reuse the export identity ledger.
+
+Dictionary string keys are data. An entry named `"Id"` reads its value through
+`dictionary["Id"]`; class `.Id` continues to return the class instance identity.
+
+You can remove a constructor and replace every call to it in the same edit. Push prepares the new calls together with the schema change and removes argument rows owned by the old constructions.