Crate incular_platform 

Platform-owned window data and normalized native events.

Layout stays in logical pixels. This crate is the single conversion boundary between those coordinates and physical surface/window coordinates.

Structs

AdvancedInputCapabilities

Device-rich input and native cursor facilities beyond basic pointer input.

ApplicationServiceCapabilities

Application-level desktop services that live outside ordinary widgets.

ClipboardCapabilities

ClipboardWriteReport

DataTransfer

Ordered collection of clipboard or external drag items.

DataTransferCapabilities

Data exchange with the operating system and other applications.

DisplayId

Generational identity for one display discovered by the active backend.

DisplayPlacementCapabilities

Display discovery and top-level placement capabilities.

DisplaySnapshot

Immutable portable snapshot for one currently connected display.

DocumentActivation

Application-level open-document value intentionally shared with the future OS activation pipeline. It transports intent only; Incular does not create a document model, load bytes, or choose a persistence policy.

DocumentDescriptor

One file/document path selected by the operating system or delivered by an application activation. The path is preserved exactly; Incular does not canonicalize it or take ownership of document persistence.

ExternalDragEvent

Normalized incoming drag sample. transfer is the same shared transfer model used by the clipboard; backends never reinterpret a file as text or fabricate unsupported rich representations.

ExternalDragResponse

Target negotiation result returned to a native adapter when it can honor a requested drag operation.

FileContentType

Semantic content type accepted by a file filter. MIME types are normalized to ASCII lowercase because MIME type/subtype tokens are case-insensitive; UTI-like identifiers are preserved verbatim apart from surrounding space.

FileDialogCapabilities

Detailed native-dialog capabilities. Keeping options independent prevents a backend from claiming full semantic support merely because it can show a basic file picker.

FileDialogFilter

One semantic filter with optional native-facing presentation text.

FileDialogFilterId

Stable semantic identity for a file filter. Native display labels are presentation only and never determine filter identity.

FileDialogOptions

Shared options for native file-dialog operations.

FileDialogRequest

Fully validated, native-handle-free dialog request.

FileDialogRequestId

Stable runtime identity for one file-dialog request. It is unrelated to a native dialog object or operating-system handle.

FileExtension

Normalized file extension without a leading dot.

GlobalShortcutChord

Physical key chord registered with the operating system.

GlobalShortcutId

Stable application-owned identity for one native global shortcut.

LaunchActivation

Arguments and typed resources associated with process launch.

LogicalDisplayPosition

Logical point relative to one display, independent of desktop-global coordinate availability.

LogicalScreenPosition

Logical desktop-global point, only published by backends with a coherent logical global coordinate space.

LogicalScreenRect

Logical desktop-global rectangle. Mixed-DPI backends that cannot provide a coherent global logical coordinate space leave this absent rather than dividing a physical global origin by one monitor’s scale factor.

LogicalSizeLimits

Validated dynamic logical-size constraints for a native window.

LogicalWindowPosition

Finite logical cursor position relative to a window’s client area.

LogicalWindowPositionError

MediaType

Stable identifier for an application-defined transfer representation.

MemoryClipboard

MemoryContentSensitivityBackend

Deterministic backend for headless hosts and platform-boundary tests.

MemorySystemEnvironmentProvider

Thread-safe deterministic provider for headless hosts and tests.

MemoryTextInputAdapter

In-memory adapter useful for tests and headless hosts.

NativeMenuCapabilities

Operating-system application-menu integration.

NativeOperationCompletion

One native backend completion routed back to the runtime.

NativePointerSample

Native device details that enrich a Winit pointer sample without changing its logical contact identity or phase. This is used only when an OS adapter can supply semantics Winit intentionally omits (for example Win32 pen kind, tilt, and eraser state).

NativeRequestId

Stable identity for one result-bearing native request.

NoopContentSensitivityBackend

Explicit unsupported backend used by platforms without a capture policy primitive. Keeping this as a real backend makes unsupported behavior observable and testable rather than silently dropping a command.

NotificationAction

One optional native notification action.

NotificationActionId

Stable application-defined identity for a notification action.

NotificationId

NotificationPresentation

Complete desired presentation of one desktop notification.

PhysicalDisplayPosition

Physical point relative to the top-left of one known display.

PhysicalScreenPosition

Physical desktop-global point in native screen pixels.

PhysicalScreenRect

Physical desktop-global rectangle in native screen pixels.

PhysicalSize

PlatformCapabilities

Complete capability snapshot published by a platform backend.

PlatformOperationError

Backend-neutral native operation failure.

PointerMetadata

Portable metadata attached to one native pointer sample before its physical position is normalized into logical window coordinates.

SingleInstancePolicy

Opt-in policy selecting one primary process for an application identity.

SystemEnvironmentPreferences

Application-level system preferences observable by a native adapter.

TaskbarDockState

Desired application shell state. window_id is a native taskbar-button target on platforms that require one (notably Windows); application-scoped Dock implementations may ignore it.

TaskbarProgressError

TextInputClientId

Stable identity for the text-input client currently attached to a window. It is generated by the retained tree and is independent of native handles.

TextInputConfiguration

TextInputState

TransferFormatCapabilities

Per-format support for one direction of clipboard access.

TransferImage

Owned, unpremultiplied RGBA8 image transfer.

TransferItem

Multiple representations of one logical clipboard/drag item.

TransferOperations

Compact operation set used for drag/drop negotiation.

TransferReadRequest

Requested clipboard representations. Empty means every representation the backend can enumerate without inventing conversions.

TransferRepresentation

One advertised representation of a logical transfer item.

TransientSurfaceCapabilities

Native surface hosting for transient UI such as menus and popovers.

TrayItemId

TrayItemPresentation

Native presentation for one application-owned tray/status item.

UrlActivation

Ordered URLs delivered by the operating system or a secondary instance.

WindowCommand

A UI-thread operation requested for one Incular window.

WindowControlCapabilities

Portable operations performed on an already-created native window.

WindowEvent

A native event routed to one normalized Incular window.

WindowIcon

Validated RGBA8 window-icon pixels.

WindowId

Stable identity for an Incular window.

WindowMetrics

WindowObservedState

Native state that can be queried reliably by the active backend.

WindowOptions

Configuration used when creating an Incular desktop window.

WindowRequestedState

Application-requested mutable top-level state.

Enums

ApplicationActivation

Native/application events which are not owned by a particular window’s input stream.

ApplicationBadge

Badge rendered by a taskbar/Dock integration when the active platform has native badge support.

ApplicationShellError

Typed failure from a native application-shell operation.

ApplicationShellFeature

Shell facility requested by an application-scoped operation.

CapabilitySupport

Whether a portable platform capability is known to be available.

ClipboardError

ContentSensitivityCapability

Whether a native backend can enforce content sensitivity for a window.

ContentSensitivityNoOpReason

Why a content-sensitivity request was intentionally not applied.

ContentSensitivityOutcome

Result of applying a normalized content-sensitivity request.

CursorGrabMode

Native cursor grab policy for one window.

DisplayPlacementArea

ExternalDragPhase

FileContentTypeKind

Semantic family of a file content-type identifier.

FileDialogError

FileDialogKind

Native file-dialog operation requested by application code.

FileDialogOption

Semantically important optional behavior a backend may support or reject.

FileDialogOutcome

User-visible completion of a native file dialog. User cancellation is a normal outcome rather than a backend error.

FileDialogSelection

Portable result payload from a native file dialog.

FileDialogValidationError

Fullscreen

The portable subset of fullscreen behaviour supported by Incular.

GlobalShortcutChordError

GlobalShortcutError

Typed failure from application-level global shortcut registration.

LogicalSizeLimitsError

NativeWindowSystem

Native desktop window-system family for capability refinement.

PlatformEvent

PlatformLifecycle

Lifecycle states native adapters can report without depending on the runtime crate. Adapters may emit only the states their OS exposes.

PlatformOperationErrorKind

Stable category for a failure at the native platform boundary.

SingleInstancePolicyError

TaskbarProgress

Progress state rendered by a taskbar button or application Dock tile.

TextInputAction

TextInputCommand

Commands emitted by the runtime and consumed by a native text-input adapter. They contain no window handles and can be queued safely at the runtime boundary.

TextInputType

Hints supplied to a native IME or soft-keyboard adapter.

TransferData

Materialized transfer data. Large payload variants retain shared storage.

TransferDataError

TransferFormat

Portable representation kinds shared by clipboard and external drag/drop.

TransferOperation

One operation an external drag source permits a target to request.

TransparencyMode

Whether a native application window participates in desktop compositing with framebuffer alpha.

UserAttentionType

Strength of a desktop user-attention request.

WindowEventKind

Window event data that is not part of the legacy PlatformEvent stream.

WindowIconError

WindowLevel

Portable z-level hints for a desktop top-level window.

WindowLifecycle

Native lifecycle state for one window, independent of application lifecycle.

WindowOperation

Operations available through an Incular WindowHandle.

WindowOptionsError

A contradiction in portable window-creation constraints.

WindowSizePolicy

Which side of the content/window relationship owns the logical size.

Traits

Clipboard

Clipboard boundary shared by memory, desktop, and custom hosts.

ContentSensitivityBackend

Native capability seam for applying window content sensitivity.

SystemEnvironmentProvider

Snapshot source used by platform adapters and deterministic tests.

TextInputAdapter

Minimal adapter seam for embedders that own their own text-input bridge.

Functions

application_data_local_directory

Resolves the persistent, local application-data directory through the operating system’s standard project-directory conventions.

canonicalize_system_locales

Parses OS-provided BCP-47 locale strings through ICU4X, preserving order while dropping malformed and duplicate canonical locales.

Type Aliases

PlatformOperationResult