Runic.Application

Runic.Application.Views

BridgeCollectionDescriptor<T> record

Generated, reflection-free metadata for a keyed collection.

BridgeCommandResultCardinality enum

Controls how an observable ReactiveUI command result is retained.

BridgeContractShape class

Build-time/Debug reconstruction of the generated Bridge wire shape.

BridgeDataSubscriptionMember class

Describes one observable member of a bridged data graph. Created by generated bridges.

BridgeDiagnostics class

Controls the local failure detail of Bridge error replies.

BridgeInteractionDescriptor<TModel> class

Neutral generated interaction descriptor. Optional adapters implement its attachment behavior.

BridgeInteractionRouter class

Window-owned request/reply broker for typed interaction adapters. Browser delivery is pull-based: a mounted endpoint receives input only as the reply to its own authenticated wait route.

BridgeJson class

JSON helpers called by generated bridges.

BridgeOperationDeliveryFailure record

Describes a result delivery failure.

BridgeOperationDeliveryFailureKind enum

Why a completed operation's result could not be retained or delivered.

BridgeOperationExecution class

The execution context of a streaming operation.

BridgeOperationResult record

The retained outcome of a bridge operation.

BridgeOperationResultKind enum

The shape of a BridgeOperationResult.

BridgeOperationStream class

A bounded, cursor-addressed sequence of encoded operation results.

BridgeOperationStreamItem record

One encoded stream value.

BridgeOperationStreamRead record

The result of BridgeOperationStream.ReadAfter.

BridgeProtocol class

The Views wire protocol described in specs/application/README.md.

BridgeSnapshotBatch class

Defers notification-driven bridge snapshots for one model until the outermost scope ends. Use this around a synchronous bulk mutation:

BridgeSnapshotWriter<T> delegate

Writes a ViewModel snapshot. Implemented by generated bridges.

BridgeValidation class

Writes the validation projection for generated bridge snapshots.

BridgeValidationChild record struct

One generated collection traversal entry. BridgeValidationChild.PathSegment must be a string dictionary key or an integer list index. Generated metadata supplies these entries without reflection so validation remains AOT-safe.

BridgeValidationMessage record

A structured validation error that a model may return from INotifyDataErrorInfo.GetErrors. Member paths are relative CLR property paths (for example Address.Postcode); the bridge resolves them through generated metadata before placing them on the wire. One message is emitted for each supplied member path.

BridgeValueCodec<T> class

A generated, typed JSON value codec for a Runic bridge contract.

BridgeWindowCloseResult record

The admission result of a graceful Window or content-session close.

BridgeWire class

Static, allocation-conscious JSON primitives used by generated bridge codecs. Values whose JavaScript number representation can lose precision are represented as invariant strings on the wire.

CheckedFieldValueKind enum

The wire value type of an acknowledged field write.

CheckedPropertyDescriptor<T> class

Describes one property that accepts acknowledged field writes. Created by generated bridges.

CommandDescriptor<T> record

Describes one bridged command. Created by generated bridges.

IAsyncBridgeTransport interface

A host that can acknowledge state delivery before the next dependent frame is sent.

IBridgeArguments interface

Positional arguments of one browser call, read in declaration order.

IBridgeTransport interface

The host adapter surface used by generated bridges to bind routes and publish state.

IBridgeWindow interface

The lifetime contract shared by every Window host adapter, such as CsWebUiBridgeWindow<TViewModel> and DesktopBridgeWindow<TViewModel>.

IRunicBridgeCodec<T> interface

Implement this interface with public static methods to define an explicit bridge representation for a type the generated standard codec does not cover. The generator verifies the closed generic type and emits direct static calls, so no codec discovery occurs at runtime.

IRunicView interface

A .NET presentation object associated with a web component.

IRunicViewLifetime interface

Optional hooks for the period during which a view is presented.

IRunicViewLocator interface

Resolves a fresh .NET view for a presented ViewModel.

IRunicWebMountLifetime interface

Optional visual mount acknowledgement from a web component.

IRunicWebPresentationLifetime interface

Optional ownership hooks for a logical View instance created for each web presentation. The presentation identifier is private transport bookkeeping; application code should not manufacture or retain it.

PageReference record

A window-local reference to a ViewModel presented as content.

PropertyDescriptor<T> class

Describes one bridged ViewModel property. Created by generated bridges.

RunicAliasAttribute class

Sets a stable JSON field or enum-case name without exposing CLR naming as protocol.

RunicBridgeCodecAttribute class

Associates a contract type or member with an explicit AOT-safe bridge codec.

RunicBridgeHotReload class

Refreshes active browser snapshots after an in-process .NET code update.

RunicCodecShapeAttribute class

Supplies the TypeScript representation and decoder expression for an explicit bridge codec. The expression must contain $value, which the generator replaces with the untrusted JSON value at the call site.

RunicCollectionAttribute class

Publishes indexed changes for a collection whose items have a stable, unique key.

RunicCommandInputAttribute class

Declares the browser argument shape for a plain ICommand. The command itself remains synchronous; the bridge only uses this metadata to decode the wire argument and to make the generated TypeScript surface typed.

RunicCommandResultAttribute class

Opts a generated command contract into a non-default result cardinality. ReactiveUI commands with RxVoid have no result and do not need this attribute.

RunicFailureAttribute class

Declares the expected failure type of a bridged command. Put it on the command property or on a CommunityToolkit [RelayCommand] method. The command signals the failure by throwing RunicFailureException with a value of this type; the generated client receives it as a typed failure instead of an error.

RunicFailureException class

Signals a declared failure from a command that has RunicFailureAttribute. The Bridge sends RunicFailureException.Failure to the client as a domain-failed reply. A value that is not the declared type is reported as an unexpected failure.

RunicIgnoreAttribute class

Leaves a public ViewModel member on .NET without exposing it to the web Bridge.

RunicIncludeAttribute class

Marks a public data member as deliberately included in a generated bridge contract.

RunicInteractionCancelledException class

Raised when a selected mounted interaction endpoint disappears.

RunicInteractionInvocation class

The trusted origin of work which may ask a browser to handle an interaction. Generated bridges establish this scope around a command or operation. It is deliberately absent for arbitrary background work, which must use a .NET handler or opt into an explicit scope.

RunicInteractionOutputException class

Raised when a browser answered an interaction with output its contract cannot decode.

RunicInteractionTimeoutException class

Raised when a browser interaction exceeded its configured lifetime.

RunicUnionAttribute class

Declares the complete derived-type set allowed at a polymorphic bridge boundary.

RunicUnionCaseAttribute class

Sets the stable discriminator used for one case of a Runic union.

RunicView<TViewModel> class

A typed logical view. It owns no DOM and does not inherit Avalonia's control tree; the frontend chooses and renders the corresponding component.

RunicViewContractAttribute class

Selects a named .NET and web View for a content property.

RunicViewsTelemetry class

Names of the Views runtime's ActivitySource, Meter and log category.

RunicWindow<TViewModel> class

The native window owner and root typed context for one Bridge session.

ServiceProviderViewLocator class

Resolves each presented View from the window's service provider. Generated AddRunicViews() registrations make this the default locator and register every non-Window View as transient. A View contract is already a distinct View type, so the contract needs no separate lookup.

ViewModelBridge<T> class

Base class of generated bridges that expose one ViewModel over an IBridgeTransport.

WindowContentSession class

Experimental instance routing for content ViewModels. The window owns this session and the application or DI scope continues to own the ViewModels.

WindowContentSessionOptions class

Configures a WindowContentSession.