@neocompose/cli 0.72.4 → 0.73.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.72.4",
+  "version": "0.73.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.72.4 -->
+<!-- reviewed-through-cli: 0.73.1 -->
 
 # 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.4 -->
+<!-- reviewed-through-cli: 0.73.1 -->
 ```
 
 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
@@ -478,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

@@ -130,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.