Skip to content

Release 1.0.0 - #24

Merged
CoderGamester merged 20 commits into
masterfrom
develop
Nov 16, 2026
Merged

CoderGamester merged 20 commits into
masterfrom
develop

Conversation

@CoderGamester

Copy link
Copy Markdown
Owner

New:

  • Statechart Debugger: Tools > GameLovers > Statechart Debugger shows any running chart live, with Run, Pause and Reset controls and two views that can each be turned on or off: a live chart of nested boxes with parallel regions as lanes, and a state tree with the latest 256 trace steps. The Copy menu exports a Mermaid diagram, the active state paths or the trace.
  • Chart view: IStatechart.RootRegion exposes the chart's structure through IRegionNode, IStateNode and ITransitionEdge, and GetActiveStates and the allocation-free IsActive report which states are active. The view is the live chart itself, so it costs nothing to build.
  • Trace: IStatechart.Traced publishes every event, exit, transition, enter, fault and lifecycle step in execution order as a StatechartTrace; nothing is allocated while no one listens.
  • Lifecycle: a Statechart(string name, Action<IStateFactory> setup) constructor, Name and IsRunning, and IDisposable support. Dispose() stops the chart for good, cancels token-aware tasks and removes it from the debugger; Run() after it throws ObjectDisposedException.
  • Cancellable task waits: ITaskWaitState.WaitingFor overloads receive a CancellationToken that Reset() and Dispose() cancel.
  • Game Flow sample: one statechart drives a small game loop that uses every state kind, with on-screen controls, meant to be watched in the Statechart Debugger.

Changed:

  • The minimum Unity version is now 6000.0 (was 2022.3); 6000.0.x, 6000.3.x and 6000.6.x are the supported streams.
  • Requires UniTask 2.5.11 (was 2.5.10), the first version whose Editor code compiles on Unity 6000.6, and the built-in UIElements module used by the debugger and the sample.
  • Events triggered while another event is being processed, for example from an enter callback, are now queued and processed right after it (run to completion) instead of running against the previous state.
  • Reset() now drops queued events and abandons pending waits and tasks, so their late completion no longer moves the chart.
  • LogsEnabled now writes one trace line per step, such as [Statechart 'Player'] Idle -> Jumping on 'Jump'.
  • Null arguments now throw ArgumentNullException, and a setup without an initial state throws InvalidOperationException instead of MissingMemberException.

Removed:

  • The Editor-only Statechart.CurrentState.

Migration:

  • Replace CurrentState with GetActiveStates, IsActive or the Statechart Debugger.
  • Custom IStatechart implementations must add the new members: Name, IsRunning, RootRegion, Traced, GetActiveStates, IsActive and Dispose.
  • Catch InvalidOperationException instead of MissingMemberException for a setup without an initial state.

Fixed:

  • A TaskWait state whose task throws no longer blocks the chart and its parent splits forever; the fault is logged and the state completes.
  • TaskWait states now resume the chart on the main thread, and a Task completing on the main thread resumes it in the same frame.
  • Pausing or resetting the chart from a callback now stops a chain of automatic transitions.
  • An action-only event on a nest or split state no longer force-completes the waits inside it.
  • Creation stack traces in error logs now start at the code that declared the failing state, and enter-callback errors no longer report themselves as exit errors.

Docs:

  • Rewrote the README with state kinds, runtime semantics, the observe API, the debugger and the sample.

CoderGamester and others added 20 commits August 5, 2026 01:27
`GameLovers.StateChart.Editor.Tests.asmdef.meta` and
`StateChartChoiceTest.cs.meta` carried a capital C while the asmdef and test
file they describe are lowercase `Statechart`. macOS's case-insensitive
filesystem hides this, but on a case-sensitive one Unity sees each .meta as
orphaned and reassigns the asset a fresh GUID, breaking references.

Rename only -- both GUIDs are unchanged (b0400479..., 51310419...). Surfaced
while re-attesting the 0.9.4 release: the repack would have shipped .meta names
that do not match their assets, because the published tarball happens to carry
the correctly-paired lowercase names.
A whole-file rename prefixed this fixture's activity field with an underscore and carried the prefix into two RCR anchors and a lambda parameter. The anchors named `if (!_activity.IsCompleted)`, which occurs nowhere in production: Runtime/Internal/WaitActivity.cs AreInnerCompleted reads `if (!activity.IsCompleted)` over its inner activities. A lambda parameter is its own scope, and its siblings in this file already use waitActivity. The shared block now says the harness already prints the fixture count, that the post-fix observation is one re-run of the same probe, and that correcting an existing ADMIT or RCR line is itself a claim about production which must be read and re-checked. Edited identically in all six packages; Tools/lint-agent-guides.py fails if they diverge.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…mple

- Run-to-completion event queue; Pause stops mid-chain; Reset and Dispose
  abandon queued events, pending waits and tasks, and cancel token-aware tasks.
- TaskWait faults complete the state; task completions resume on the main thread.
- Split action-only events keep inner waits running.
- New read-only topology (RootRegion), GetActiveStates, Traced trace stream,
  Name, Dispose, and Mermaid/active-path export. CurrentState is removed.
- Statechart Debugger window with three side-by-side views: live nested chart,
  Graph Toolkit graph (6000.6+), and state tree with trace history.
- Game Flow sample covering every state kind.
- Deterministic tests without frame yields, plus lifecycle and observability suites.
- UniTask 2.5.11 and the UIElements module are declared dependencies.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…er code in the Editor

- IStateNode, IRegionNode and ITransitionEdge are implemented by the live
  states, StateFactory and Transition objects; the parallel node graph,
  StatechartTopologyBuilder, TransitionInfo and CollectTransitions are gone.
- StatechartRegistry and StatechartExport move to the Editor assembly; the
  runtime keeps one Editor-only Statechart.Created discovery event.
- Statechart drops five fields: a lifecycle enum replaces the running and
  disposed flags, the cancellation token replaces the generation counter,
  IsActive walks the active states without a buffer, and the name counter goes.
- New test: Reset from an enter callback stops the automatic chain.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Graph Toolkit 6000.6 has no read-only mode, so the generated graph pins a
warning to its first node saying edits never reach the game.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ontent

The flat Graph Toolkit graph hid nest and split hierarchy and could not be made
read-only, so the debugger keeps the live chart and the tree with trace. The
toolbar toggles are named after each view and turn it on or off.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sets the package version to 1.0.0, promotes the pending notes to the dated
1.0.0 entry with migration guidance, points the README install URL at the
1.0.0 tag, and restores the changelog's CRLF line endings.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The debugger rules now live in a Statechart Debugger section of the package
AGENTS.md, matching the root-plus-Tests layout of the other packages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…-and-1.0-runtime

Statechart Debugger, observability API and Game Flow sample
Gives the imported sample folder a stable GUID, as the other packages' samples
have, and satisfies the release docs gate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…meta

Add the Game Flow sample folder meta
The release gate requires the changelog date to match the publication day.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@CoderGamester CoderGamester self-assigned this Nov 16, 2026
@coderabbitai

coderabbitai Bot commented Nov 16, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 097dd4d5-b603-4efd-8348-ab8a64e4729a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@CoderGamester
CoderGamester merged commit eb333e1 into master Nov 16, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant