@neocompose/cli 0.89.9 → 0.89.11

package/package.json

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

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

@@ -143,7 +143,7 @@ The marker near the top of `SKILL.md` must exactly match the package version,
 and this quoted copy is checked too:
 
 ```html
-<!-- reviewed-through-cli: 0.89.9 -->
+<!-- reviewed-through-cli: 0.89.11 -->
 ```
 
 Keep this skill on current behavior. Upgrade steps, rollout prerequisites,

package/skills/neocompose-cli/references/declarations/constructors.md

@@ -31,6 +31,13 @@ Foo value = new(bar: "BAR", isFun: true) { IsFun = false };
 - A header constructor disables implicit parameterless `new` and forbids
   other constructor overloads. Its derived identity takes no `@id`.
 
+## Editor support
+
+Constructor completion, hover, and signature help use the concrete type arguments:
+`Box<string>` offers a `string` argument for a parameter declared as `T`.
+Target-typed constructions inside callbacks use the callback's return type for
+parameter hints. Duplicate named arguments are diagnosed in local initializers.
+
 ## Variant parameters
 
 Constructors accept `NeoVariant<T>` and `NeoLookupVariant<T, TValue>` selections,
@@ -188,3 +195,14 @@ AudioSettings AUDIO_SETTINGS = new() {
   Main = new AudioMixerGroupSettingsFolder("Main", "Master", "MasterVolume", []),
 };
 ```
+
+## Reconciliation during push and export
+
+Constructor comparisons wait for newly authored values they read, including
+unordered collection entries and variant factories. Equal constructor arguments
+retain the existing instance, its stored random values, and authored field edits.
+Changed arguments rebuild the instance after its dependencies settle. A pending
+dependency alone does not trigger reconstruction.
+
+A concrete generic instance keeps its type arguments when stored through a base
+class slot, for example `Rule value = new TypedRule<int>(1);`.

package/skills/neocompose-cli/references/neoscript/types-and-narrowing.md

@@ -86,6 +86,11 @@ public static T? FirstOf<T extends Item = Item>(List<T> items) => items.FirstOrD
   types. Nullable elements matched against `T?` contribute their non-null
   type. Null literals, target-typed `new()`, and empty collections supply no
   evidence, but do not discard evidence from sibling tuple elements.
+- Generic functions can construct `Box<T>` using their own type parameters,
+  including static functions without a class receiver. Explicit and inferred
+  call arguments close the construction in both the CLI and SDK.
+- Go to Definition on a type parameter in a local type annotation opens its
+  class or function declaration.
 - Function type parameters take no `@id`. Overrides declare the same count,
   constraints, and defaults but may rename them.
 

package/skills/neocompose-cli/references/sync/conflicts-and-recovery.md

@@ -20,6 +20,11 @@ compilation on purpose.
   display text. Empty and comment-only files stay files.
 - Against a server-side deletion, keeping the record restores it as a create
   guarded by an absent-record check; removing it accepts the deletion.
+- If a server deletion leaves an edited declaration without an owner, pull
+  uses its authored file for the local conflict side. This preserves its values
+  and IDs, including after a local file move. Shared members retain every
+  authored class declaration, including several classes in one file. Review
+  the marked hunks before choosing a whole side.
 - Pull warns when a conflicted record's local base strands newly downloaded
   descendant rows. Resolve it with `--mine` or `--theirs` before pushing.
 - Compiled initializer IR and other server-derived metadata never cause a

package/skills/neocompose-cli/references/world/variants.md

@@ -25,6 +25,29 @@ NeoVariant<ExampleObject> Down = new(
   written `new { ... }` or `new Partial<T> { ... }`. They never pass
   constructor arguments, even when `T` has a required constructor.
 
+A child override's explicit `NeoAnimationChildOverride<TChild>` argument
+selects the child type and its `Partial<TChild>` payload. The child type may
+extend `NeoObjectBase`; it does not have to equal the list's base type.
+Returning a local variable from the selector preserves that explicit type.
+The selector takes no parameters. Its `this` is the variant target instance,
+so `() => this.SelectFirstSprite()` and `this.SelectFirstSprite` both work
+when that method takes no arguments and returns `TChild`. A search through
+`Children` returns an optional `NeoObjectBase`; narrow it to `TChild` and
+handle the missing-child case before returning it.
+
+```neo
+new NeoAnimationChildOverride<AnimationSpriteObject>(() => {
+  if (this.Children.FirstOrDefault((child) => child.Name == "Sprite")
+      is not AnimationSpriteObject sprite) {
+    throw new NeoError("Expected a sprite child");
+  }
+  return sprite;
+}, new Partial<AnimationSpriteObject> { Sprite = Images.OreVeins.Slice(1) })
+```
+
+VSCode and `neo status` validate selector bodies and constructor delegate
+arguments, including names, parameter counts, return paths, and return types.
+
 A nested class partial changes only named members. A list override replaces
 the whole list; it does not patch entries by index. In particular, overriding
 a clip's `Frames` requires the complete desired list, not just the changed