Crate lingxia_shell 

Platform-neutral semantic core for the LingXia host shell.

This crate owns app-declared sidebar actions, user-owned Pins, validation, Pin persistence, and deterministic state transitions. It deliberately has no dependency on lxapps, the surface graph, browser bookmarks, Logic, or platform UI. Host integration resolves metadata and executes activation; platform skins only render resolved snapshots and report stable ids.

Structs

PinCollection

ResolvedShellSidebarAction

ShellManager

ShellPin

ShellSidebarAction

ShellSidebarActionUpdate

ShellSnapshot

ShellStore

ShellWindowState

SidebarActionCollection

SidebarActionIntent

SidebarChrome

SurfaceMenuContext

SurfaceMenuIntent

SurfaceMenuItem

SurfaceMenuSection

SurfaceMenuSnapshot

WindowFrame

Enums

LxappSurfaceMenuAction

PinMutation

ShellError

ShellPinTarget

SidebarActionPlacement

SurfaceMenuAction

SurfaceMenuBuiltinAction

SurfaceMenuItemRole

SurfaceMenuSectionKind

Constants

DEFAULT_EXPANDED_SIDEBAR_WIDTH

MAX_HEADER_SIDEBAR_ACTIONS

The header strip is shared with the window controls, so it holds a few actions rather than an open-ended list. Exceeding it rejects the whole declaration instead of truncating: silently dropping one entry would leave an app believing it published something the user cannot see.

MAX_SHELL_PINS

PIN_STORE_FILE

SHELL_WINDOW_FILE

Traits

ShellHost

Functions

activate_sidebar_action

apply_current_pins

apply_current_sidebar_actions

compose_surface_menu

initialize

is_pinned

manager

pins

resolved_sidebar_actions

set_pinned

set_sidebar_chrome

Record the user’s own sidebar choice. Never call this for the adaptive projection: a narrow window forcing a rail is not a choice, and writing it down would make the next launch open as a rail on any window size.

set_window_frame

sidebar_chrome

The sidebar state the user last settled on, or the expanded default when the shell is not initialized.

window_frame

Type Aliases

ShellResult