@neocompose/cli 0.80.0 → 0.81.1

package/package.json

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

package/skills/neocompose-cli/references/animation-and-world-authoring.md

@@ -95,7 +95,12 @@ Object `PlacementTiles` is a `List<NeoPlacementTile>`. Each entry marks a
 footprint cell with its own `Cell` member. It is independent of `NeoTile`. Rendered
 tile classes do not belong in this list. An object with no placement tiles
 occupies no cells. It doesn't block other placements, and cell queries don't
-return it.
+return it. A placed object with no tiles still has a `Cell`.
+
+`NeoSpriteObject` extends `NeoObject`. Place a sprite class like any object,
+give it `Children`, and override `OnObjectSpawned`/`OnObjectDespawned` on it.
+Hooks fire on every object in a placed hierarchy, parent first; despawn runs
+children first. `NeoObjectBehaviour.IsRoot` is true only on the placed root.
 
 Convert a writable placement without changing its row identity or cell:
 
@@ -152,6 +157,14 @@ NeoVariant<ExampleObject> Down = new(
   deltas over existing instances. They may use inferred `new { ... }` or
   explicit `new Partial<T> { ... }`, and never pass arguments to or invoke
   `T`'s constructor—even when `T` has a required constructor.
+- `Variants.X.Initialize()` runs `initialize`, then `overrides` and child
+  overrides. `ToVariant` runs `apply`, then `overrides` and child overrides; it
+  never reruns `initialize`. An instance remembers both: the variant that built
+  it and the variant last applied. The applied variant's overrides win where
+  they answer, `apply` writes stay as instance overrides, and
+  `ToVariant(Base)` removes the applied layer. On an object nested inside
+  another instance's construction, `ToVariant` applies the layers in place and
+  records nothing.
 
 Folders are records too, declared as their own globals and assigned per
 variant. Nesting is spelled in the path with `/`; intermediate segments are

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

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

@@ -35,8 +35,9 @@ names with readable ones. It keeps chosen names and rewrites references. Use
 declaration file grouping already recorded by the workspace, while
 declarations with no prior placement use the canonical per-declaration layout. Use `--force` only to discard local edits for the server
 version. Normal pulls persist a transaction cursor and fetch only changed
-records. Dictionary string keys, including Unicode, round-trip through full and
-incremental reads. If the remote head is unchanged, pull preserves the local source
+records. Dictionary string keys, including Unicode, `_id`, `$name`, and `__proto__`,
+round-trip through full and incremental reads. String keys may be empty or contain
+whitespace; enum keys must name a live enum option. If the remote head is unchanged, pull preserves the local source
 without compiling it; use `neo status` to inspect local edits and diagnostics.
 Pull ignores records whose hashes already match the saved server baseline,
 including echoes of this checkout's last push, and advances its cursor without

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

@@ -163,6 +163,10 @@ A static field that names another static copies a value, as in
 `public static int B = Holder.A;`. A class, List, Set, or Dictionary static
 already owns its value, so call `Clone()` or use `Reference`. A static delegate cannot copy another Class's delegate field,
 because its closure compiles in its own Class; wrap it as `() => Other.Call()`.
+Omitted constructor fields use their authored defaults, including optional fields.
+Writable collection defaults belong to each instance; mutations persist on later
+reads without changing another instance's default. Fields without defaults remain
+absent, and `null` arguments in generated member-wise constructors mean omission.
 Collection type arguments in constructions, such as `new Box<List<int>>([1, 2])`,
 work even when no field declares that collection type. Preparation includes the
 needed type descriptors; spec-only types remain in the test candidate.

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

@@ -278,11 +278,14 @@ rows stay reachable through the creation data that already named them.
 
 Defaulted members may be added without recreating existing instances, including
 instances whose sparse arguments are retained only as constructor data.
-A construction whose durable constructor arguments changed, whose
-class changed, or which predates a required constructor parameter fails with
-`construction-arguments-conflict` instead of silently replaying a different
-recipe. Edit members supported by the recorded construction, or delete and
-recreate the value.
+Source is authoritative for a construction: editing its constructor arguments,
+including a static's, rebuilds the instance in place on push. The value keeps
+its ID, rows at unchanged positions keep theirs, added entries create rows,
+removed entries delete them, and the stored creation data records the new
+arguments. Overrides the rebuilt construction no longer produces are deleted,
+so keep them in the construction's `{ ... }` block. A construction whose class
+changed fails with `construction-arguments-conflict`; delete and recreate the
+value to change its class.
 
 Write main-locale text directly in localizable string initializers. Pull/lower
 retargets only the edited assignment. Equal primary-locale text on the same