Stateflows.Extensions.PlantUml
0.23.3-beta
Prefix Reserved
dotnet add package Stateflows.Extensions.PlantUml --version 0.23.3-beta
NuGet\Install-Package Stateflows.Extensions.PlantUml -Version 0.23.3-beta
<PackageReference Include="Stateflows.Extensions.PlantUml" Version="0.23.3-beta" />
<PackageVersion Include="Stateflows.Extensions.PlantUml" Version="0.23.3-beta" />
<PackageReference Include="Stateflows.Extensions.PlantUml" />
paket add Stateflows.Extensions.PlantUml --version 0.23.3-beta
#r "nuget: Stateflows.Extensions.PlantUml, 0.23.3-beta"
#:package Stateflows.Extensions.PlantUml@0.23.3-beta
#addin nuget:?package=Stateflows.Extensions.PlantUml&version=0.23.3-beta&prerelease
#tool nuget:?package=Stateflows.Extensions.PlantUml&version=0.23.3-beta&prerelease
Introduction
Stateflows is a .NET framework for building stateful applications with executable state machines, data-flow activities, actions, and entities. Model business lifecycles, coordinate concurrent work, and process live streams through typed, testable C# APIs. Run locally or scale with Orleans, with persistence, messaging, and observability integrated into your behaviors.
Getting Started
Go to Stateflows homepage to learn more.
Startup serialization validation
Stateflows transports application events and activity tokens using Newtonsoft.Json, including inside Orleans envelopes. Orleans serializer attributes on an application event do not repair an incompatible JSON constructor.
Enable verification explicitly, optionally declaring payloads that visitors cannot discover (for example notifications published inside application code):
services.AddStateflows(builder =>
{
builder.AddStateMachines(/* behavior registrations */);
builder.AddStartupSerializationValidation(validation => validation
.AddEvent<OrderCompleted>()
.AddToken<ProcessingResult>()
.AddSample(() => new Failure(new List<string> { "example" })));
});
Verification uses existing behavior visitors without changing routing registration.
Definite defects fail startup with SER001-SER003 diagnostics naming the
type/member and its behavior usage. Sample round-trip failures report SER004.
Unverifiable contracts warn: custom converters, runtime polymorphism, computed
members, recursive references and specialized collections need representative
samples, optionally with semantic assertions. Samples exercise envelope cloning
and, when registered, the Orleans transport envelope. They execute only when
verification is enabled. Enabled hosts also check newly sent concrete event/token
types before serialization; this is not exhaustive inspection of arbitrary object graphs.
A single parameterized constructor is supported when its parameters bind to
serialized members by name and type. For example, Failure(List<string> messages)
can populate Messages; an unrelated parameter name such as errorMessages
cannot. With multiple constructors, select the intended one using
Newtonsoft.Json.JsonConstructorAttribute, preserving matching bindings (or
explicit JsonProperty names). Selecting a constructor alone does not fix a mismatch.
Use semantic sample assertions for values a constructor computes or transforms.
Omit AddStartupSerializationValidation() to disable discovery, samples and
additional runtime contract checks. Mandatory delivery error reporting remains
enabled. See the implementation plan
for visitor coverage limits and manual registration guidance.
Dispatch without waiting for processing
SendResult admission = await behavior.DispatchAsync(new Work());
IBehavior.DispatchAsync() copies the supplied headers, adds DispatchAndReturn
and calls SendAsync(). Adding that header yourself, or applying the inherited
DispatchAndReturnAttribute to an event type, also enables admission-only delivery.
EventStatus.Dispatched confirms admission to a volatile receiver inbox,
not processing, persistence or a guaranteed response. Dispatch-only RequestAsync()
returns without a response. Ordinary sends and requests retain their existing
processing-awaiting semantics. Combining dispatch-only delivery with Stream
or JoinTransaction throws rather than weakening their guarantees.
Orleans and the legacy hosted runtime support admission-only delivery.
Standalone execution explicitly rejects it. Context Send() remains void and
nonblocking, with supervised dispatch; context DispatchAsync() lets an effect
await admission safely, including a self-send with execution concurrency one.
Behavior-originated dispatch passes through IBehaviorInterceptor.EventDispatchAsync:
await next() inside try/catch to observe dispatch errors. The framework reports
dispatch and post-admission processing failures through ILogger.LogError and
Trace.WriteLine (⦗→s⦘), independently of startup validation.
Configure inbox limits separately from execution resource limits:
builder.ConfigureInbox(options => options.DefaultCapacity = 128);
// On an action, activity, state-machine or entity builder:
behaviorBuilder.SetInboxCapacity(32);
Limits must be positive and count pending messages per behavior instance, excluding
the executing message. A full inbox immediately returns Overloaded; admission
does not wait for a resource permit. Admitted dispatches are drained in inbox order,
but ordinary calls can overtake queued dispatches. Graceful shutdown drains admitted
work within the shutdown timeout; process/silo loss can lose volatile work.
Post-admission failures are receiver-side reports, not a later fault on the
already-completed dispatch task.
Deploy matching framework/runtime packages to every hosting silo. Dispatch uses a
new inbox grain contract: Orleans must find a host for that grain and behavior;
an unsupported deployment fails rather than falling back to a normal processing RPC
or returning a fabricated Dispatched. No rolling-version interoperability is promised.
Generated HTTP event/request endpoints return 202 for Dispatched, without a
follow-up target status query or notification wait.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Stateflows (>= 0.23.3-beta)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.23.3-beta | 0 | 11/19/2026 |
| 0.23.2-beta | 40 | 11/17/2026 |
| 0.23.1-beta | 56 | 11/12/2026 |
| 0.23.0-beta | 54 | 11/11/2026 |
| 0.22.0-beta | 66 | 10/28/2026 |
| 0.21.1-beta | 73 | 10/20/2026 |
| 0.21.0-beta | 65 | 10/19/2026 |
| 0.20.13-beta | 77 | 9/25/2026 |
| 0.20.12-beta | 88 | 9/8/2026 |
| 0.20.11-beta | 83 | 9/7/2026 |
| 0.20.10-beta | 80 | 9/2/2026 |
| 0.20.9-beta | 84 | 9/1/2026 |
| 0.20.8-beta | 96 | 8/17/2026 |
| 0.20.7-beta | 92 | 8/6/2026 |
| 0.20.6-beta | 94 | 8/5/2026 |
| 0.20.5-beta | 98 | 7/23/2026 |
| 0.20.4-beta | 99 | 6/24/2026 |
| 0.20.3-beta | 91 | 6/24/2026 |
| 0.20.2-beta | 101 | 6/23/2026 |
| 0.19.7-beta | 57 | 11/2/2026 |