@neocompose/cli 0.38.5 → 0.39.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.39.0] - 2026-08-29
+
+### Changed
+
+- Adopt project source format 4 and schema contract 4.0. Project records now
+  use compact numeric setting ordinals, a single class/member modality axis,
+  and absent keys for default enum arms.
+- Replace `@hidden` with `@visibility(.Hidden)`, replace boolean annotation
+  settings with contextual enum cases, and remove the unused `@locked`
+  annotation.
+- Canonicalize absent lookup collection values and variant-folder bindings
+  without writing equivalent `null` spellings.
+
+### Compatibility
+
+- This CLI requires runtime export schema 29 and the matching Neo Compose SDK.
+  Older SDKs would silently lose class/member modality, interpret the new
+  ordinal settings as their old defaults, and retain protection behavior for
+  the removed `locked` field.
+
+## [0.38.6] - 2026-08-29
+
+### Fixed
+
+- Preserve locally edited nested records when the server deletes their owning
+  graph, restore kept records as explicit absent-CAS creates, and accept a
+  later server recreation cleanly after local deletion wins.
+- Warn during pull when a conflicted record's retained local base strands
+  newly downloaded descendant value rows, before a later push reaches the
+  stale-base safety refusal.
+
 ## [0.38.5] - 2026-08-29
 
 ### Fixed

package/README.md

@@ -124,7 +124,7 @@ abstract class InventoryItem<
   TContext extends SomeClass
 > {
   @id("item-name-id")
-  @settings(localizable: true, searchKey: true)
+  @settings(searchBy: .MemberKey)
   virtual string Name = "";
 
   @id("item-rarity-id")
@@ -149,10 +149,10 @@ abstract class InventoryItem<
 The source identifier is the persisted name. `@settings` and `@storage` are
 typed by their declaration context; invalid fields and enum cases are
 diagnostics. Swift-like `.EnumCase` syntax works whenever the expected enum
-type is known. Focused annotations such as `@id`, `@locked`, `@hidden`,
-and `@relations` carry cross-cutting behavior. Never author `@system`; it is
-reserved for platform-owned system records. `@hidden` marks a class the member
-selector and classes tree leave out; absent means visible.
+type is known. Focused annotations such as `@id`, `@visibility`, and
+`@relations` carry cross-cutting behavior. Never author `@system`; it is
+reserved for platform-owned system records. `@visibility(.Hidden)` marks a
+class the member selector and classes tree leave out; absent means visible.
 
 Lists take repeatable `@index` and `@column` annotations naming a field on the
 entry class. An index requires a non-localizable `string` or a single-select
@@ -162,9 +162,9 @@ default layout for every field a subclass adds.
 ```neo
 @id("outpost-list-id")
 @settings(kind: .Unordered)
-@index(member: Slug, unique: true)
-@column(member: Slug, width: 158, frozen: true)
-@column(member: Notes, hidden: true)
+@index(member: Slug, kind: .Unique)
+@column(member: Slug, width: 158, pin: .Leading)
+@column(member: Notes, visibility: .Hidden)
 public List<Outpost> Outposts = [];
 ```