@neocompose/cli 0.79.1 → 0.81.0

package/package.json

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

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

@@ -57,7 +57,9 @@ On a placed `NeoObject`, `this.Cell` returns its grid cell.
 same grid, filtered to `Plant` and subclasses. `this.GetTile(neighbors)`
 returns the first tile found in pattern order, or null.
 `this.GetTiles(neighbors)` returns the tile at each occupied cell in pattern
-order and skips empty cells. Each query takes an optional `offset` that shifts
+order and skips empty cells. A type argument filters each cell's top tile:
+`this.GetTiles<DirtDryTile>(neighbors)` returns `List<DirtDryTile>` and skips
+a cell whose top tile is something else, even when a dry tile sits under it. Each query takes an optional `offset` that shifts
 the whole pattern, so `this.GetTiles(neighbors, new(0, 2))` queries around the
 cell two rows up without building a translated pattern. These queries track
 empty cells as well as hits, so a getter updates when a new neighbor appears.
@@ -93,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:
 

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

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

@@ -102,6 +102,23 @@ A generic receiver may call methods from its class or interface constraint,
 including void calls used as statements. Generic arguments substitute through
 the constraint; nullable receivers still require narrowing or null handling.
 
+Functions, natives and interface functions can declare their own type
+parameters after the name, each with an optional constraint and default:
+
+```neo
+public static T? FirstOf<T extends Item = Item>(List<Item> items) {
+    foreach (Item item in items) {
+        if (item is T match) return match;
+    }
+    return null;
+}
+```
+
+A call writes every type argument or omits the defaulted tail
+(`FirstOf<Seed>(items)`, `FirstOf(items)`); nothing is inferred. Function type
+parameters take no `@id`, and an override declares the same count, constraints
+and defaults, though it may rename them.
+
 Prefer `--json` for automation.
 
 `neo script check --all` reconstructs the prospective project entirely from
@@ -146,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.
@@ -157,6 +178,12 @@ Explicit lambda parameter annotations accept the same type grammar as
 declarations, including `decimal`, generic parameters, collections, arrays, and
 nullable types.
 
+Instance reads in collection-entry initializers must be deferred. A default such
+as `List<int> Values = [this.Number + 1]` (or `[Number + 1]`) is a compile error:
+the instance does not exist while the entry initializer runs. Delegate lambdas
+such as `() => this.Number` and method groups such as `Read` or `this.Read`
+remain valid, including inside `new Callback { Read = Read }` entries.
+
 A lambda may use an expression body too: `(x) => x * 2` is the block body
 `(x) => { return x * 2; }`. In a void delegate the expression is a statement,
 so it must call or assign. A dictionary-literal body needs parentheses,
@@ -330,6 +357,8 @@ return this.Beds
 Use `items.IndexOf(value)` to return the zero-based index of the first equal
 list entry, or `-1` when the value is absent. `IndexOf` is list-only and uses
 the same equality as `Contains`.
+`Remove(value)` removes the first equal entry using that same equality, including
+scalar entries supplied by instance field defaults. Removing a missing value is a no-op.
 
 Use `items.Insert(index, value)` to insert an entry into a writable ordered
 list. The index may range from zero through `items.Count`; the count appends

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

@@ -300,6 +300,11 @@ linked source record.
 
 ## Managed files
 
+Managed images support PNG, JPEG, GIF, and SVG. SVG files use `image/svg+xml`
+and retain their original bytes through pull, push, and Unity export; the CLI
+does not rasterize them. The same byte-length, MIME-type, and SHA-256 checks
+apply to SVG transfers as to other managed files.
+
 Declare files in typed registries:
 
 ```neo