@neocompose/cli 0.51.1 → 0.52.0

package/package.json

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

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

@@ -58,26 +58,43 @@ or `.Center`. To retain Line's old default, pass
 
 ## Tile placements
 
-Use `@tile(VoidTile)` on a `NeoTileInstance` construction to select its tile
-class. The named spelling `@tile(asset: VoidTile)` is equivalent; the asset is
-required and only the argument label is optional.
+A placement is an ordinary concrete `NeoTile` value with a `Cell`:
 
 ```neo
-@tile(VoidTile)
-new NeoTileInstance() {
-  Cell = new(9, -4)
-}
+new GlassFloorTile { Cell = new(9, -4) }
 ```
 
-Pull emits the positional spelling. The annotation writes the placement's
-`assetClassId` metadata and does not construct a tile value or add a generic
-argument. The asset must be a concrete, non-generic descendant of `NeoTile`.
-Use the annotation on persisted literal constructions; executable NeoScript
-and evaluated placement constructors reject it.
-The grid's imports and the tile's compatible-layer relations still constrain
-where the placement can be used. Existing placement overrides remain attached
-when the selected asset is unchanged; recreate a placement to change its asset
-when it has overrides or a variant.
+Layer-link `Tiles` lists contain these values directly. `NeoTileInstance` and
+`@tile(...)` are removed. A tile's `Name`, `Sprite`, and `SmartTile` are
+`readonly` declaration members. Override them on a subclass; a placement
+initializer cannot assign them. `Cell` is the placement's writable field.
+
+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.
+
+Convert a writable placement without changing its row identity or cell:
+
+```neo
+tile.TryConvert<GlassFloorTile>();
+tile.TryConvert(nextTile);
+```
+
+The second form uses the target value's runtime class. It does not copy the
+target's fields. Both forms return `false` when placement validation rejects
+the new class. The grid's imports and compatible-layer relations still apply.
+
+`Tiles.Add` and `Tiles.Remove` change placement data directly. The SDK validates
+placement writes and updates live rendering from the resulting data changes,
+including script writes and remote batches. For flattened SDK layers,
+`TrySetTile<T>(cell)` remains available. Spawn objects with
+`TrySpawn(cell, constructedObject)`; successful adoption preserves the object's
+identity. Clone an existing owned object explicitly before placing another copy.
+
+Use an object's real `ToVariant` API to apply a variant of its class. The
+object inspector lists variants and their folders. Painting a different object
+class replaces the placement with a new row; it does not change the old object's
+class in place. The old `TrySwapVariant` class-swap APIs are removed.
 
 ## Object variants
 
@@ -275,10 +292,10 @@ opt-in and defaults to `false`; without it the ID is matched exactly. Missing
 optional child slots are skipped with diagnostics when the authored slot is
 absent, while stale pre-provenance placements may still fail closed.
 
-A placement row carries its `assetClassId` binding and optional `assetValueId`
-override beside its schema keys. They are row provenance, not declared schema:
-never declare them as members on a project class, and never strip them from a
-row you rewrite.
+Authored object placements can carry variant and source metadata beside their
+schema keys. Preserve that metadata when editing the row; do not declare it as
+project schema fields. Raw tile placements use their row class and `Cell`, with
+no `assetClassId` or `assetValueId` sidecars.
 
 ## Segments and tracks
 

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

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