@neocompose/cli 0.72.2 → 0.73.0

package/package.json

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

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

@@ -424,7 +424,7 @@ example `@storage(allowed: .Session) public override NeoCollider? Collider;`.
 Lookup dialogue groups use the same collection paths as lookup members:
 
 ```neo
-DialogueGroup FishingVictory = new(
+NeoDialogueGroup FishingVictory = new(
   kind: .Lookup,
   collection: Assets.FishEncounters,
   collectionValue: Reference(root.Assets.FishEncounters),
@@ -440,14 +440,14 @@ Node and option prose lowers to localized-text records with canonical node or
 choice backlinks. Existing translations and unrelated localization links are
 preserved when the source is pushed.
 
-Put exactly one top-level `sealed class Name : Dialogue` in each `.neoflow`
-file. Make it non-generic, derive directly from compiler-owned `Dialogue`, and
+Put exactly one top-level `sealed class Name : NeoDialogue` in each `.neoflow`
+file. Make it non-generic, derive directly from compiler-owned `NeoDialogue`, and
 override `Trigger Trigger` exactly once. Do not add any other type declaration.
 
 ```neoflow
 @id("capitol-dialogue-id")
 @settings(name: "Capitol: cold boot", saveOptionChoices: true)
-sealed class CapitolColdBoot : Dialogue {
+sealed class CapitolColdBoot : NeoDialogue {
   @primary Outpost capitol = Assets.Capitol;
   Player player = Player.Current;
 
@@ -500,7 +500,7 @@ and commit it with `neo push`.
 
 ### Dialogue group names and local symbols
 
-Use `DialogueGroup QuestUnlocks = new(kind: .Standard, parent: Quests, name: "Unlocks")`
+Use `NeoDialogueGroup QuestUnlocks = new(kind: .Standard, parent: Quests, name: "Unlocks")`
 when the local identifier should differ from the record's display name. Omitting
 `name` uses the identifier. Unity generates its dialogue API from the stored
 name (`Quests.Unlocks`), independently of the local identifier. Pull, force-pull,

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

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

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

@@ -14,6 +14,7 @@ runtime ownership, evaluation, and migrations.
 - Switch
 - Try/catch
 - Debug output
+- Triggering dialogues
 - Evaluation and migrations
 
 ## Inline bodies and snippets
@@ -178,7 +179,13 @@ or narrowing guard before the next access.
 Inside an instance body, `Member` and `this.Member` share null and type-check
 narrowing. A local or parameter named `Member` shadows the implicit member;
 `this.Member` still names the instance field. Reassigning a narrowed path to a
-nullable value clears its non-null fact.
+nullable value clears its non-null fact and facts about its descendants. Writes to
+unrelated members preserve existing guards, including inside loops. Earlier
+conditions being false also narrow receivers in later `else if` conditions.
+
+A nullable value coalesced with a non-null fallback produces a non-null result,
+including in constructor arguments: `new Sprite(item.Sprite ?? SpriteInfo.Empty)`.
+A nullable fallback keeps the result nullable when the left operand can be null.
 
 Treat lookup-return values with the same nullable narrowing rules.
 
@@ -472,6 +479,51 @@ severity; CLI logs go to stderr so JSON stdout stays machine-readable. Getter
 re-evaluation may emit the same log again. `Debug` is a builtin qualifier,
 not a type; an authored local or Class named `Debug` takes precedence.
 
+## Triggering dialogues
+
+`root.Dialogues` mirrors the generated C# `Dialogues`: the same folders and
+groups under their generated C# property names.
+
+```neo
+public bool TryTalk() {
+  return root.Dialogues.NPCs.Talk.TryTrigger(this, () => {
+    this.AfterTalk();
+  });
+}
+
+public bool HasSomethingToSay => root.Dialogues.NPCs.Talk.CanTrigger(this);
+```
+
+- `root.Dialogues` has `TryTrigger(string dialogueId, onFinish)`,
+  `CanTrigger(string dialogueId)`, `VisitCount(pointer)`, and
+  `HasVisited(pointer)`.
+- A standard group has `TryTrigger(onFinish)` and `CanTrigger()`. A lookup
+  group takes its collection's entry class: `TryTrigger(value, onFinish)` and
+  `CanTrigger(value)`. The value must be a stored row.
+- A `NeoDialogueReference` has `id`, `TryTrigger(onFinish)`, and
+  `CanTrigger()`. Elements of a `Set<NeoDialogueReference>` are bare ids, so
+  pass one to `root.Dialogues.TryTrigger`.
+- `onFinish` is an optional `NeoDelegate<void>`: a lambda or a function member.
+  It runs after the dialogue finishes, fails, or is disposed.
+
+`TryTrigger` compiles only in functions, including effects, lifecycle hooks,
+and listeners, and in dialogue actions. `CanTrigger`, `VisitCount`, and
+`HasVisited` are reads, allowed wherever the `VisitCount` global is. Folders
+and groups aren't values. User code can't trigger dialogues.
+
+The Unity SDK queues every accepted request and shows one dialogue at a time
+through `Dialogues.OnTrigger`. A request for the running or an already queued
+dialogue returns false, as does every request when the game has no `OnTrigger`
+handler. `neo test`, `neo script eval`, dialogue dry runs, and the web editor
+have no dialogue runtime: `TryTrigger` and `CanTrigger` return false there and
+`onFinish` never runs.
+
+Source type names match C#: `class X : NeoDialogue` in `.neoflow`,
+`NeoDialogueGroup` and `NeoPriorityGroup` declarations, and
+`NeoDialogueReference` for a reference member. The old names `Dialogue`,
+`DialogueGroup`, `PriorityGroup`, and `DialogueRef` are compile errors that
+name their replacement.
+
 ## Evaluation and migrations
 
 `neo script eval` uses authored values and the same evaluator as the web app.

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

@@ -57,7 +57,10 @@ keys as quoted IDs when their option has been deleted.
 
 ## Identity rules
 
-Preserve every existing ID through rename, reorder, and file moves. A copy
+Preserve every existing ID through rename, reorder, and file moves. Renaming a
+schema member while keeping its ID preserves its owned value graph. Update
+initializer keys to the new name and retain existing child IDs, including when
+editing those children in the same change. A copy
 must get a new ID. A stored nested class value may keep its UUID-v4 when moved
 to an empty, compatible class field on another existing parent. Remove its
 old owning declaration in the same push. Both fields must declare the same
@@ -127,7 +130,7 @@ Reference<Outpost>(id: "capitol-value-id")
 Reference<NeoSpriteObject>(id: "authored-child-id", withProvenance: true)
 Reference<PantsAsset>(key: "pants.long")
 Reference<PantsAsset>(key: "pants.long", index: Slug)
-Reference<Dialogue>(id: "capitol-dialogue-id")
+Reference<NeoDialogue>(id: "capitol-dialogue-id")
 ```
 
 - Use a symbol or root path when source can name the value directly.