Runic.Platform

Runic.Platform

CapabilitySnapshot record

An immutable capability view; availability may change after capture.

CapabilityStatus record

One capability's current availability.

CapabilityStatus.Available record

The capability is currently available.

CapabilityStatus.Unavailable record

The capability is currently unavailable.

DesktopAccentColor record

An sRGB colour with components in [0,1].

DesktopActivationContext class

Opaque, short-lived focus authorization supplied by the desktop.

DesktopAppearance record

Unknown optional preferences remain null rather than becoming false.

DesktopColorScheme enum

The desktop's preference; an application override takes precedence.

DesktopFileOperation enum

Local-file handoff operations; asking for an application is distinct from opening the default.

DesktopInhibitionEffects enum

Idle power transitions an explicit operation may ask the desktop to inhibit.

DesktopNotification record

Reusing Id replaces a notification. Submission does not guarantee display.

DesktopNotificationAction record

A notification button. IDs are application-owned routing keys, never commands.

DesktopNotificationActivation record

A user action on a notification. Treat activation as untrusted input at the application boundary.

FileCommitResult record

The observed outcome after an atomic replacement attempt. An uncertain commit must not be retried automatically.

FileCommitResult.Committed record

The replacement completed.

FileCommitResult.CommitUnknown record

The replacement may have occurred; inspect the destination before deciding what to do.

FileCommitResult.NotCommitted record

The replacement did not occur.

FileWritePolicy enum

Required durability behavior for a save transaction.

IDesktopFileLauncher interface

Native file handoff. Paths are supplied by trusted C# application code, never directly by a web client.

IDesktopInhibition interface

Requests temporary idle-power inhibition; never enabled implicitly by application startup.

IDesktopInhibitionLease interface

An operation-owned native inhibition request. Dispose as soon as the operation ends.

IDesktopNotifications interface

Application-scoped native notifications with explicit authorization.

IDesktopSettings interface

Application-scoped desktop preferences. Dispose to stop observation.

IFileDialogs interface

Presentation-scoped selection of file access. Leases, streams and native access remain in C#.

IFileWriteTransaction interface

A single-consumption staged write. Disposal removes uncommitted staging data.

ILaunchableFileLease interface

An acquired file that can be handed to a native application without exposing its path.

IPlatformCapabilities interface

Reports capabilities without exposing native resources.

IReadFileLease interface

Owns acquired read access until disposed or its presentation closes.

ISaveFileLease interface

Owns an acquired save destination and its access grant.

ITextClipboard interface

Presentation-scoped Unicode text clipboard operations.

IUiDispatcher interface

Dispatches synchronous actions on the presentation's UI thread.

OpenFileOptions record

Options for selecting one existing file.

OwnerPolicy enum

Ownership requirements for native dialogs. This preview supports owned dialogs only.

PickerResult<T> record

A dialog outcome. User dismissal is distinct from cancellation, unavailability and failure.

PickerResult<T>.Dismissed record

The user dismissed the dialog without selecting a resource.

PickerResult<T>.Failed record

The dialog or acquisition failed.

PickerResult<T>.Selected record

The user selected a resource whose access must be disposed.

PickerResult<T>.Unavailable record

The dialog could not be shown.

PlatformDiagnostic record

Native error detail attached to a failure for logs and support. It is not intended for display and may be localized by the operating system. Messages come only from operating-system error tables or fixed provider text; free-form text from native services (GError and D-Bus messages, NSError descriptions) is omitted, so a diagnostic contains no paths, file contents or native handles.

PlatformFailureCode enum

A classified operational failure, without exposing paths or native handles.

PlatformResult<T> record

A service outcome. Cancellation is represented by an OperationCanceledException.

PlatformResult<T>.Failed record

The operation failed.

PlatformResult<T>.Success record

The operation succeeded.

PlatformResult<T>.Unavailable record

The service was unavailable.

PlatformUnavailableReason enum

Why a capability cannot currently be used.

PlatformUnit record struct

The successful result of an operation without a return value.

SaveFileOptions record

Options for selecting one save destination.