Files
craft-libs/docs/glossary.md
T
aiongg a70609d944 Press routing: exactly one root starts a press, the one whose shape is on top under it
The shape record keeps each shape's place in the pass's paint order and the clip it shows through, and which
root a transformed body layer belongs to. pointer::press_winner resolves every root recorded on the topmost layer
at the press (a body layer's root beneath its body) and gives the press to the root whose winning shape was
recorded last; egui's targets stay only to tell a raw egui widget on top. The sensing core starts a press on that
root alone, so a control under a later body-sized widget takes its press and a frame handle over a nested editor
wins over the editor. Member widgets over nested roots, which only steered egui's target, are gone.
Trials: a control under a later body widget; one root of three overlapping ones starts each press.
2026-11-17 05:31:53 +00:00

309 lines
36 KiB
Markdown

# Glossary
One row per name in the author table (Overview) and per `pub` item a component author touches (`contract`, `style`, `primitives`, the `Cx` traits and their re-exports). "Lives in" is the defining module by its path under the `craft_ui` facade, which re-exports each library crate's modules under the same name ([craft-framework.md 3.2](craft-framework.md#32-the-ui-library-crates)); a re-exported item has one row, under its defining module. "Defined in" names the section of the framework specification that defines the term; the specification is not part of this repository.
| Term | What it is | Lives in | Defined in |
|---|---|---|---|
| `Access` | The builder a component's `access` hook fills | `craft_ui::runtime::access` | 12.1 |
| `Accessible` | The `Cx` trait for `announce` and `field_label` | `craft_ui::contract` | 1.5, 12 |
| `AccessRequest` | An AccessKit action that arrives as `Intent::Access` | craft-behavior | 9.2 |
| Active part | The part of a focused component that has focus, held by the runtime focus service | `craft_ui::runtime::focus` | 1.7 |
| `Animate` | The motion trait on every context | `craft_ui::runtime::motion` | 13.1 |
| App layer | Layer 8, in app repos only | each app repo | Overview |
| App-modal | The rule for `Rank::Modal` layers | `craft_ui::runtime` (layer stack) | 15.5 |
| `AppSizes`, `sizes.json` | An app's overrides of library base sizes | craft-theme | 4.6 |
| `AppValues` | The private set of app values a root, a scope or a component's `content_env` sets with `set::<T>(v)` | `craft_ui::runtime::env` | 2.2 |
| Arena | The set of shapes one press is resolved among | `craft_ui::primitives` (the registration store and the sensing core; the resolve rule is a craft-behavior pure function; `ArenaId` in `craft_ui::runtime::env`) | 8.3 |
| Arena member | A component that joins the innermost `Env.arena` because it is neither an arena root nor a text or editor leaf | `craft_ui::contract` | 8.3 |
| Arena root | A container with `ContainerProps.arena`, or any collection | `craft_ui::contract` | 8.3 |
| `ArenaId` | The id of an arena, carried in `Env.arena` | `craft_ui::runtime::env` | 8.3 |
| `Backdrop` | A modal's scrim (`None`, `Scrim`), carried by `Rank::Modal` | `craft_ui::runtime` (layer stack) | 15.2 |
| `Bind<T>` | The one value binding | `craft_ui::contract` | 10.2 |
| `BindMut<T>` | A reborrowed `Bind<T>` that `bind()`, `open()`, `scroll()` and `selection()` return | `craft_ui::contract` | 10.2 |
| Body | The caller's closure that a container shows, its one caller region | — | 16.3 |
| `BarItems`, `BarItem` | A leaf inside a `Bar`'s body that shows command items in a strip and overflows them by `fit` into a menu of command rows | the bar family | 20.3 |
| `BodyCx` | The non-generic context a body closure, header, footer or empty hook and popup content receive, as `&mut` | `craft_ui::contract` | 1.5 |
| `BodyLayout`, `RowAlign` | How the body step lays out a body (`ContainerProps.layout`) | `craft_ui::layout` | 6.3, 16.2 |
| `CancelReason` | Why a gesture or press was cancelled (`Refused`, `Dismissed`, `HostChanged`, `UndoDuringGesture`, ...) | craft-behavior | 10.2 |
| `cancel_all` | `runtime::edit::cancel_all(ctx, reason)`: cancels every running gesture; the app's undo and redo call it first | `craft_ui::runtime::edit` | 10.3 |
| `propose_with`, `gesture_note` | `cx.propose_with(value, note)` proposes like `propose` and, when the component takes the proposal, sets a typed note on the running gesture; `runtime::edit::gesture_note::<V, N>(ctx, id)` reads that note from outside the component's pass (`None` while no gesture runs) and the note goes when the gesture ends | `craft_ui::contract`, `craft_ui::runtime::edit` | 10.3 |
| Canvas control | A leaf a `Canvas` body shows, declared with `#[component(canvas_control)]` | the component's family | 8.3, 20.6 |
| Command form | A canvas tool's keyboard path | the tool's crate | 8.3 |
| `CanvasTransform` | The transform a canvas body is shown through, from `ContainerProps.transform` | craft-behavior | 8.3 |
| `CellSelection` | The sheet's selection model | craft-behavior | 17.7 |
| `Chord` | A key with modifiers, the one shortcut type, shown with `ChordText` | craft-keymap | 11.1 |
| `ClipboardHandle`, `ClipItem` | The handle `cx.clipboard()` returns over `craft_platform::clipboard` | `craft_ui::runtime::commands` | 11.3 |
| `Codec` library codecs | `PlainText` and `NumberCodec` beside `Codec` and `quantity::Reader` (craft-behavior); `HexCodec`, `DateCodec` and the text fields' other codecs in craft-ui | craft-behavior, craft-ui | 18.3 |
| Collection | A component that also implements `Collection` | `craft_ui::contract` | 1.3, 17 |
| `CollectionEvent`, `ColumnEvent` | The events a collection reports, and its column events | `craft_ui::contract` | 17.1, 17.6 |
| `CollectionProps` | A collection's plain data | `craft_ui::contract` | 17.1 |
| `CollectionResponse` | A collection's output | `craft_ui::contract` | 17.6 |
| Column, `ColumnSpec` | A `ColumnSpec` in `CollectionProps.columns` | `craft_ui::contract` | 17.1 |
| `ColumnGroup` | Rows that are not one `Grid` (`Field` rows) sharing the widest label per column key, by the same function as a `Grid` `Content` column. A field's control keeps its own labels and shares the group's other columns: content-sized number fields line up their values and units across the group | `craft_ui::layout` | 6.3 |
| `ColumnWidth`, `ColumnKey` | A column's width rule | craft-behavior | 17.1, 6.3 |
| Command scope | A `CommandScope`, live while a container declaring it is live | craft-keymap | 11.3 |
| `CommandRef`, `CommandKind`, `ModalRule` | A command's id, its kind (`Command`, `Toggle`, `Radio`, `Tool`, `Momentary`) and whether it fires while a dialog is open | craft-keymap | 11.2 |
| `Board::bound_around` | The command of a set that a chord runs on a canvas inside a command chain, through the keymap and the scopes the window's keys match in; the tool host uses it so a key that automation holds starts the momentary tool the real key starts | `craft_ui::runtime::commands` | 11.2 |
| `ToolInput::hold`, `ToolInput::let_go` | Injected tool inputs for a key going down and coming up again with no key event: the window host holds the key from the pass of the hold to the pass of the release, so a held Space pans a press the way the real key does | `craft_ui_canvas::canvas::tool_host` | 8.3 |
| `Frames::over` | A frame driver over a given `egui::Context` (`Frames::new` makes its own), for tests that run the app's own context | `craft_ui::testing` | 22.4 |
| `CommandGate` | The one gate that can disable commands (dialog open, workspace, recorder, pending operation) | `craft_ui::runtime::commands` | 11.3 |
| `Commands` | The context trait on `Cx`, `BodyCx` and `ItemCx` for commands and the clipboard | `craft_ui::runtime::commands` | 11.3 |
| `CommandSet` | A typed set of commands with one scope, written by `#[derive(CommandSet)]` and read with `take_command::<S>()` | craft-keymap (trait), `craft_ui::runtime::commands` (board) | 11.2, 11.3 |
| `CommandState`, `CommandInput` | A command's state this frame, and the app-scope states in `FrameInput.commands` | `craft_ui::runtime::commands` | 11.3 |
| `Common` | The props every component has, with no public fields | `craft_ui::contract` | 3.1 |
| Component | Any type implementing the core trait | `craft_ui::contract` | 1.2 |
| `ComponentStyle` | The trait every `type Style` implements, usually with `#[derive(ComponentStyle)]` | `craft_ui::style` | 4.3 |
| `ContainerProps` | The plain-data props of containers and collections | `craft_ui::contract` | 16.2 |
| Content painter | A `ContentPainter` type that paints document content with a raw painter | `craft_ui::contract` (trait) | 5.4 |
| Container | A component that also implements `Container` | — | 1.3, 16 |
| `ContentPainterCx` | What `PaintUi::content_painter(cx)` returns | `craft_ui::primitives` | 5.3, 5.4 |
| Content step | Step 14 | `craft_ui::contract` | 1.6 |
| `content_env` | The `Component` hook, run once at step 13, that sets app values for content the component does not build, its body or items | `Component` method | 2.2 |
| `ControlMetrics` | Height, icon, horizontal padding and gap per `ControlSize`, read from a craft-theme `BySize` table to build `Metrics` | craft-behavior | 4.3 |
| `ControlSize` | The control size scale `BySize` tables are read by | craft-theme | Overview, 2.1 |
| `Corners` | Which corners of a surface are rounded | `craft_ui::style` | 4.3 |
| `runtime::cursor` | The cursor service: it picks the winning cursor request in the end hook and records it as data | `craft_ui::runtime` | 8.5 |
| `Cursor`, `PaintedCursor`, `CursorBadge`, `CursorPriority` | A cursor request (system or painted), a painted cursor's shape, its badge, and the request's priority | craft-behavior | 8.5 |
| `CustomVariant` | A `const` variant built for one component's `StyleKey` with a crate-prefixed id and a look function over semantic tokens | craft-theme | 4.4 |
| `CxCore`, `Cx` | The per-show interaction context | `craft_ui::contract` | 1.5 |
| `DataColor` | A colour from data (a swatch, a label dot), the one colour `Draw` accepts besides `StyleColor` | `craft_ui::style` | 4.3 |
| Decision record | The record each step writes about why it decided what it did, read by `runtime::inspect` | `craft_ui::runtime::inspect` | 1.7 |
| Decorator | A container whose body shows the decorated component (a badge, an attention dot) | component families | 16.1 |
| Dense item | An ordinary item with many parts (a sheet row, a timeline track) | — | 17.2 |
| `Dismiss` | An egui layer's dismissal rules, in `Overlay.dismiss` | `craft_ui::contract` | 15.4 |
| `DocKey` | A stable, crate-prefixed semantic key for presence, automation, undo names and programmatic focus | craft-behavior (re-exported by craft-ui) | 3.1 |
| `Direction`, `Scale` | The layout direction (left-to-right or right-to-left) and the interface scale, inherited through `Env` | craft-i18n, `craft_ui::runtime::env` | 2.1 |
| `DocText`, `DocRun`, `FontRef` | Document text a content painter lays out with `ContentPainterCx::layout` | `craft_ui::primitives`, `craft_ui::fonts` | 5.4 |
| `DragPreview` | What the overlay host paints under a drag | `craft_ui::runtime` (drag session) | 8.4 |
| `Draw` | The content-paint API `PaintUi::draw` gives | `craft_ui::primitives` | 5.3 |
| `DropOperation` | A drop's operation | craft-behavior | 8.4 |
| `DropTarget<P>`, `DropMark` | A drop target registered with `cx.drop_target(&target)` | `craft_ui::runtime` (drag session) | 8.4 |
| `Edit` | The value trait on `Cx` | `craft_ui::contract` | 10.2 |
| `EditHistory<T>` | A local undo history for dialogs, tool sessions and the keymap editor, fed by `EditEvent`s | craft-behavior | 10.5 |
| `EditEvent`, `EditResponse` | The value events a value component emits, and the output that carries one per pass | craft-behavior (`EditEvent`), `craft_ui::contract` (`EditResponse`) | 10.2 |
| `EditCommand` | An edit command delivered as `Intent::Edit` or `EditorInput::Edit` | craft-behavior | 9.2, 11.3 |
| `EditKind` | The kind of an edit event a story recorded | `craft_ui::testing` | 22.4 |
| `EditorInput`, `EditorState` | The input stream an own-caret editor reads, and the state it reports (with `can_undo` and `can_redo`) | craft-behavior (`EditorInput`), `craft_ui::primitives` (`EditorState`) | 18.4 |
| `EditorLine`, `EditorPurpose` | One visible line an editor reports, and the editor part's purpose | `craft_ui::primitives` | 18.4 |
| `EditorRun`, `LayoutRun` | One bidi run of a line | `craft_ui::primitives` | 18.4 |
| `EditPolicy` | When a write-through source is written | craft-behavior | 10.2 |
| egui layer | An egui `LayerId` | egui | 15.2 |
| egui options the runtime owns | The table of egui options and calls only the runtime sets | `craft_ui::runtime::egui` | 1.8 |
| `Emphasis` | The emphasis axis of a variant | craft-theme | 4.4 |
| `Env` | The inherited context of a `Ui` | `craft_ui::runtime::env` | 2.1 |
| Env scope | A stretch of code with changed inherited values, from `with_env(ui, set, body)` and `Overrides` | `craft_ui::runtime::env` | 2.3 |
| `EnvKey` | The key of everything a style depends on besides its own key | `craft_ui::style` | 4.5 |
| `EnvValue`, `StyleValue` | An app-defined value inherited down the tree like the library's own | `craft_ui::runtime::env` | 2.2 |
| `EnvView` | The view of `Env` that component code reads | `craft_ui::runtime::env` | 2.1 |
| Face | An instance of a component painted by another component's `paint` as the look of one of its parts, with `PaintUi::face` | — | 5.3, 20.1 |
| Field container | `Field` | `craft_ui` form family | 20.1, 20.3 |
| `Help`, `LabelKind`, `FieldLayout` | A field's help text, its label's kind and its layout | `craft_ui` form family | 20.3 |
| `Fired`, `FireSource`, `FirePhase` | One fired command in the queue | `craft_ui::runtime::commands` | 11.3 |
| `Flags` | Value-driven and interaction flags, merged at step 12 | craft-theme | 4.1 |
| `Flow` | Start and end geometry resolved once for the layout direction | craft-behavior | 6.2 |
| `Focus` | The `Cx` trait for `intents`, `claim`, `take_claimed`, `active_part`, `is_focused`, `focus_visible` and `reveal` | `craft_ui::contract` | 1.5, 9 |
| Focus on press | Which presses move key focus | `craft_ui::runtime::focus` | 8.3 |
| Commit now | The mark the focus service sets at H7 on a focused text part with a draft when a press lands elsewhere, so the draft commits in the press pass | `craft_ui::runtime::focus` | 8.3 |
| Focus scope | A part of the UI with a `FocusPolicy` | `craft_ui::runtime::focus` | 9.4 |
| `FocusLook`, `IconLook`, `SurfaceLook`, `TextLook` | The style parts a `*Style` struct holds for the focus ring, icons, the surface and text | `craft_ui::style` | 4.3 |
| `FocusPolicy` | A focus scope's rules | `craft_ui::runtime::focus` | 9.4 |
| `FocusTarget` | What `runtime::focus::request` focuses | `craft_ui::runtime::focus` | 9.4 |
| `FrameInput`, `FrameOutput` | What an app sets before each pass and drains after it | `craft_ui::runtime::frame` | 1.8 |
| `InstallSpec` | What `install` takes: shell info, the window system, style replacements and the ghost-layer painter (`frame_layers`) | `craft_ui::runtime` | 1.8 |
| `install` | The install entry apps and the fixture call: fills `InstallSpec.frame_layers` and calls `runtime::install` | `craft_ui` | 1.8 |
| `paint_frame_layers` | Paints the ghost egui layer (drag preview, drop mark, painted cursor) once per pass from the end hook | `craft_ui::contract::overlay` | 15.1 |
| `Gap` | A body's item spacing token, `ContainerProps.body_gap` | `craft_ui::contract` | 16.2 |
| Gate | A container's `bool` view of its shown value that enables or disables its body, edited through `BodyCx::gate()` | — | 10.4 |
| `Facts<T>` | Cross-widget facts registered in one pass and read in the next | `craft_ui::runtime::memory` | 7.2 |
| `Gesture`, `GesturePhase`, `GestureId` | The pipeline-owned edit in progress, its phase this frame, and its id | craft-behavior | 8.2, 10 |
| `GridView`, `GridSection` | A sheet layout's column sections (one per frozen area, rects relative to the viewport) given to each row through `ItemCx::grid()` | craft-behavior | 17.7 |
| Group form | A container and arena root whose members, placed anywhere in its body, join its arena and register with its `GroupHandle` | `craft_ui::contract` (handle), component families | 20.3 |
| Group's pick | The member a group form selects at step 9, from `cx.activated_member()` | — | 20.3 |
| `GroupHandle<G>` | A group form's handle, put into its body's env with `content_env` | `craft_ui::contract` | 20.3 |
| `GroupKind` | The kind of a group form (radio, chip), naming its member value type | `craft_ui::contract` | 20.3 |
| Header and footer regions | Areas the body step lays out from `ContainerProps.header` and `footer`, filled by `Container::header` and `footer` | `craft_ui::contract` | 16.3 |
| `HeaderRegion`, `FooterRegion` | The header and footer regions in `ContainerProps` | `craft_ui::contract` | 16.2 |
| `HitShape`, `HitLevel`, `HitPriority` | A part's hit and paint shape, its level, and its level with a sub-level | craft-behavior | 8.3 |
| Hook steps H0 to H8 | The numbered input-hook and begin-hook steps of the frame loop, beside the end hook | `craft_ui::runtime` | 1.8 |
| Host `Ui` | The `Ui` a mount gives a container (the parent's, an egui Area's, a viewport's child root) | — | 1.6 |
| `IconId` | An SVG-set or tool icon's egui-free key, its name | craft-behavior | 5.2 |
| `IconSpec` | An icon to paint | `craft_ui::primitives` | 5.2 |
| `IdSource` | Where an id comes from | `craft_ui::contract` | 7.1 |
| `ImeSurface` | The public editor contract for components that draw their own caret | `craft_ui::primitives` | 18.4 |
| Inherited and layer-local env | The two groups of `Scoped` | `craft_ui::runtime::env` | 2.1, 2.3 |
| `Ink` | The text and icon colour that reads on a surface, resolved at step 12 | `craft_ui::style` | 5.1 |
| `Inner` | A container's show output | `craft_ui::contract` | 1.1 |
| `Input` | How input reaches a component | craft-behavior | 1.1 |
| `Insets` | Start, end, top and bottom distances, mirrored by `Flow` | craft-behavior | 6.2 |
| `Intent` | A key, AccessKit action or typed text turned into meaning | craft-behavior | 9.2 |
| `Intent::MoveItem` | A stacking key (Cmd+] or Cmd+[, Shift to the ends) on a reorderable collection: moves its selected items | craft-behavior | 9.2, 17.3 |
| `Intent::Open` | Opens a `Trigger::Hold` or dropdown opener | craft-behavior | 9.2, 15.5 |
| `Intents` | The owned copy of the intents routed to one id this pass, read with `cx.intents()` and its `take_*` calls | `craft_ui::runtime::keys` | 9.2 |
| `Internal` | A token only craft-ui can build, taken by the derive-written accessors | `craft_ui::contract` | 1.1 |
| `Interpolate`, `Tween`, `Presence`, `MotionSpec` | An animatable value, a running tween, an open-close presence, and a motion constant | `craft_ui::runtime` (motion service) | 13.1 |
| Item step | The collection's content step | `craft_ui::contract` | 17.3 |
| `item_layout` | The `Collection` hook that builds this frame's `ItemLayout` from the source, width and `StyleCx` | `Collection` method | 1.3, 17.3 |
| `ItemCx` | The context of the item closure, `ItemCx<'a, 'r, K>` | `craft_ui::contract` | 1.5, 17.2 |
| `ItemLayout` | A collection's geometry, logical (x from the start edge), relative to the viewport and computed in f64 inside; the item step mirrors it unless `mirrors()` is false | craft-behavior | 17.4 |
| `ItemOutput` | The trait an item's `Output` implements, converting it into `Option<ItemEvent>` | `craft_ui::contract` | 17.1 |
| `DisplayOrder` | The source trait: keys, depth, open state and text in display order | craft-behavior | 17.2 |
| `ItemSource` | The source a collection shows | craft-behavior | 17.2 |
| `SizeHint` | An item's size hint from its source | craft-behavior | 17.2 |
| `Key`, `Mods`, `KeyInput` | Craft-keymap's key types | craft-keymap | 9.2, 11.1 |
| `KeyUse` | A component's declared keys | `craft_ui::runtime::focus` | 9.3 |
| Key table, `KeyRole` | The one table per OS that maps keys and modifiers to intents and `MoveMods`, as the pure function `keys::intent(os, key, mods, role)` | craft-behavior | 9.2 |
| `craft_keymap::layout` | The keyboard-layout rule for shortcut matching and key labels, used by the dispatcher, the key table and `ChordText` | craft-keymap | 11.1 |
| `Label` | Given or library text | `craft_ui::runtime::env` | 19.2 |
| Label scope | The scope a container with a side label opens for the controls inside; a control reads the label's `FieldLabel` (id, rect, press state, text) with `cx.field_label()` | `craft_ui::runtime::access` | 12.4 |
| Label step | Body sub-step B2, run for every container with a side label and by `PaintUi::labelled` | `craft_ui::contract` | 16.3 |
| Layer | One of the architecture layers 0 to 8 | — | Overview |
| Layer stack | The runtime's per-viewport record of shown egui layers and their order | `craft_ui::runtime` | 15.2 |
| `Arrangement`, `arrange` | A logical custom placement for a body's keyed children, and the function that measures, mirrors (unless `mirrors()` is false) and shows them once | craft-behavior (`Arrangement`), `craft_ui::layout` (`arrange`) | 6.3 |
| `runtime::layout_memory` | Values measured in one pass and read in the next, with size tweens and the tolerance rule for discard passes | `craft_ui::runtime` | 6.3 |
| Leaf | A component with neither body nor items | — | 1.1 |
| Lifetime | How long a memory slot lives | `craft_ui::runtime::memory` | 7.2 |
| Lock rule | No app-supplied code runs while a runtime or context lock is held | `craft_ui::runtime` | 7.2 |
| `Looks` | The app's style replacements (`Looks::style`), passed to `install` and frozen | `craft_ui::contract` | 4.4 |
| `MAX_EXTENT` | The largest side a component may allocate, 32,768 points | `craft_ui::contract` | 1.3 |
| `MeasureCx` | What `measure` gets | `craft_ui::contract` | 6.2 |
| Memory stage | The pipeline-owned set of a component's memory slots, moved in at step 3 and back after `finish` | `craft_ui::runtime::memory` | 7.2 |
| `Message` | The text of a `Validity` verdict | `craft_ui::runtime::env` | 10.2 |
| `Meta`, `HasProps` | Traits the derive writes | `craft_ui::contract` | 1.1 |
| `Metrics` | A style's padding, minimum size, wrap width, gap and least text width | craft-behavior | 6.2 |
| `Mixed<T>` | A value that is the same across a multi-selection, or mixed | craft-behavior | 10.2 |
| `MotionMode`, `MotionKind` | The motion level (`Full`, `Reduced`, `Off`) and an animation's kind (`Fade`, `Travel`, `Loop`, `Blink`), inputs of the motion table | craft-behavior | 13 |
| `MotionPolicy` | The motion mode in effect with the motion tokens, carried in `Env.motion` | `craft_ui::runtime::env` | 13.1 |
| `MoveMods`, `Granularity` | A move's modifiers (extend the selection, move the lead only) and its unit (`Unit`, `Word`, `Line`, `Paragraph`, `Document`) | craft-behavior | 9.2 |
| `Mount` | Where a container lives | `craft_ui::contract` | 16.2 |
| `Move` and `Size` commands | The `window` command set's keyboard path for moving and resizing the focused floating container (Alt+F7 and Alt+F8 on Windows and Linux, menu only on macOS) | `WindowCommand` variants | 16.3 |
| `NavMove` | A logical navigation move (`Back`, `Forward`, `Up`, ...) | craft-behavior | 9.2 |
| `Name` | How a node is named | `craft_ui::runtime::access` | 12.1 |
| `NavOutline`, `NavShape` | The key-free outline the navigation core steps through, and the navigation shape | craft-behavior | 9.5 |
| `NodeGraph`, `Node`, `NodeKind` | The node-editor collection, its item component and the app trait for node kinds, each generic over the graph's edit type `E: 'static = ()` | `craft_ui::graph` | 20.6 |
| `NodeEvent` | A node graph's event: `Wired`, `WireEnded`, or `Edit(E)` from a kind's inline controls | `craft_ui::graph` | 20.6 |
| `Numeric` | A node's numeric value, range, step and value text, set with `a.numeric(..)` | `craft_ui::runtime::access` | 12.1 |
| One press per pass | The input hook's rule (H0) | `craft_ui::runtime::egui` (input) | 1.8, 8.3 |
| `Opener` | The component that opens a free-standing popup | `craft_ui::contract` | 15.4 |
| `Outcome` | The trait every `Output` implements | `craft_ui::contract` | 10.2 |
| `OpenEntry` | One shown egui layer in the layer stack | `craft_ui::runtime` (layer stack) | 15.2 |
| `Overlay` | Data describing an egui layer | `craft_ui::contract` | 15.4 |
| `Overrides` | The values an env scope changes | `craft_ui::runtime::env` | 2.3 |
| `OverlayFit` | How an egui layer sizes | `craft_ui::contract` | 15.4 |
| `Overlays` | The `Cx` trait with `popup(name)` | `craft_ui::contract` | 1.5, 15 |
| `OverlayUi` | What the `overlay` hook gets | `craft_ui::contract` | 15.4 |
| Owner (memory) | The component id registered at step 3 whose pipeline opened the stage a runtime entry was written through | `craft_ui::runtime::memory` | 7.2 |
| `OwnerClass` | A key class, the input of key ownership | craft-behavior | 9.3 |
| Paint record | The one interior-mutable cell in `Cx`, written during `paint` | `craft_ui::primitives` | 1.5 |
| Painters | `Surface`, `StateLayer`, `FocusRing`, `Rule`, `TextRun`, `ChordText`, `IconSpec`, `Handle`, `ScrollBar` and `ResetMark` | `craft_ui::primitives` | 5.2 |
| `PaintShape` | The shape `Draw::fill` and `Draw::stroke` paint: a rect with corners, a circle, a polygon or a path | `craft_ui::primitives` | 5.3 |
| `PaintUi` | What `paint` receives | `craft_ui::contract` | 5.3 |
| Pane | An F6 stop | `craft_ui::runtime::focus` | 9.4 |
| Part | A named sub-rect of a component's own surface with its own hit shape, state, tooltip and sub-node, keyed by a `PartKey` | — | 8.3 |
| `PartBuilder` | What `PartsCx::part` returns | `craft_ui::contract` | 1.5, 9.4 |
| `PartKey`, `PartKey::CELL` | The one key type of parts, declared as consts | craft-behavior | 1.5, 17.2 |
| `PartRef` | A part's name | craft-behavior | 1.5 |
| `PartResult` | A part's results this pass | `craft_ui::primitives` | 1.5, 8.3 |
| `PartsCx` | What `parts` gets, with last pass's `hovered` and `focus_visible` | `craft_ui::contract` | 1.5 |
| Pattern | A type that only assembles components | `craft_ui::contract` | 24.4 |
| `Place`, `Resize` | Where an egui layer sits (`Anchored { anchor, side, align }` or `Float`) and how the user may resize it, in `Overlay` | `craft_ui::contract` | 15.4 |
| `Pending<T, E>` | A memory slot holding a background result | `craft_ui::runtime::pending` | 14 |
| `Placed` | A keyed child given to `arrange` for a custom `Arrangement` | `craft_ui::layout` | 6.3 |
| Placement rule | A type lives in the lowest layer that names it | — | Overview |
| `Pointer` | The `Cx` trait for part results, presses, activation, wheel, cursors and drag and drop | `craft_ui::contract` | 1.5, 8 |
| `PointerFrame` | The pass's pointer snapshot, per viewport | `craft_ui::runtime::pointer` | 8.1 |
| `PointerSample` | A pen or touch sample | craft-behavior | 8.1 |
| `MultiTouch` | A two-finger gesture summary | craft-behavior | 8.1 |
| `PointerButton`, `Buttons` | Pointer buttons, egui-free | craft-behavior | 8.1 |
| `Politeness` | An announcement's or live region's urgency | `craft_ui::runtime::access` | 12.1 |
| `PopupHandle` | A `Copy` id and name for one of a component's own popups, from `cx.popup(name)`, with `trigger`, `open`, `close` and `is_open` | `craft_ui::contract` | 15.5 |
| Prelude | The stable surface of a crate | each crate | 1.11 |
| Press-target rule | Exactly one root starts each press: on the topmost layer under it, the root whose press-taking shape is painted on top there; none when egui's hit test names a raw egui widget | `craft_ui::primitives` (sensing core) | 8.3 |
| `PressPhase`, `PressState` | A press lifecycle's phase, and its state with mods, sample and capture | craft-behavior | 8.2 |
| `PressStart` | A press's start: origin, button, time and click count | craft-behavior | 8.1 |
| Probe | The derive-written test entry for a registered type, with its required states | `craft_ui::testing` | 22.4 |
| `Proposal` | The question a measure call answers | craft-behavior | 6.2 |
| `Props` | The blanket setter trait over `Common` | `craft_ui::contract` | 3.2 |
| `Rank` | An overlay's place in the order (window, toast, popup, modal with its backdrop, modal chrome, tooltip) | `craft_ui::runtime` (layer stack) | 15.2 |
| Read-only | A component or scope whose values cannot change | — | 3.1, 12.4 |
| Region | A sub-rect a container lays out | — | 16.3 |
| Registration macro | The one craft-ui macro the `Component` and `CommandSet` derives call to register | `craft_ui` (macros) | 1.11 |
| Read-only output | A struct craft-ui builds and apps only read (`CxCore`, `MeasureCx`, `PartsCx`, `TextLayout`) | — | 1.11 |
| `Remember` | The memory trait on every context, over four lifetimes | `craft_ui::runtime::memory` | 7.2 |
| `ReorderMove<K>` | The value of a reorder edit in a collection | `craft_ui::contract` | 17.6 |
| `Resolved` | `Common` merged with the env and the command, assembled at step 3 | `craft_ui::contract` | 3.3 |
| `ResolvedCommand` | A command resolved for this frame and instance | `craft_ui::runtime::commands` | 11.3 |
| `Role` | A component's or sub-node's AccessKit role | `craft_ui::runtime::access` | 12.1 |
| `RootEnv` | The app's root values each frame | `craft_ui::runtime::env` | 2.3 |
| `Roving` | A roving group | craft-behavior | 9.5 |
| `RowState` | An item's row facts from the collection; the row's id scope is its key | `craft_ui::contract` | 17.2, 17.5 |
| `ListRowStyle` | `ListRow`'s style struct | `craft_ui::list` | 17.7 |
| `runtime::toast::post` | Posts a toast to a window's queue from any code with a `Context`; the window's shell shows it at its body's end-bottom corner | `craft_ui::runtime::toast` | 15.5 |
| `SaveKey` | A crate-prefixed key for the saved lifetime, never derived from an id | `craft_ui::runtime::memory` | 7.2 |
| `ScopeKind`, `CancelRule`, `Initial`, `EnterRule` | A focus scope's kind, Escape rule, initial focus and Enter rule | craft-behavior (`ScopeKind`, `CancelRule`), `craft_ui::runtime::focus` (`Initial`, `EnterRule`) | 9.4 |
| `Scroll`, `ScrollAnchor`, `Notch` | `ContainerProps.scroll`, its anchor and its wheel notch distance | `craft_ui::contract` | 16.2 |
| Scroll part | The track and thumb of one axis, registered with `PartsCx::scroll(key, rect, axis, span)`, run by the pipeline and painted by `ScrollBar` | `craft_ui::contract` | 8.6 |
| Shape record | The per-viewport, egui-free record of last pass's registered shapes that H7 classifies presses from | `craft_ui::runtime::pointer` | 8.3 |
| `ScrollSpan` | What a scroll part shows on one axis | craft-behavior | 8.6 |
| `ScrollPos` | A scroll offset or extent in content units, as `f64` | craft-behavior | 8.6 |
| `SelectionModel` | A collection's selection type | craft-behavior | 17.4 |
| `SelectMode` | A collection's selection mode | `craft_ui::contract` | 17.1 |
| `Sense` | The library's sense set for a root or part | craft-behavior | 1.1 |
| `Sense::TAKE_FOCUS` | A sense bit: a press this shape wins moves key focus to its component | craft-behavior | 1.1, 8.3 |
| `Sense::WHEEL_X` | A sense bit: takes the horizontal wheel share without focus or arming | craft-behavior | 1.1, 8.6 |
| `SetPosition` | An item's index, set size and level for AccessKit | `craft_ui::runtime::access` | 12.1 |
| Settle | Step 15 | `craft_ui::contract` | 1.6 |
| `ShellInfo` | OS, runtime, backend, capabilities, menu placement and window info | craft-host (`target`) | 21.1 |
| `ShellPane` | One of `AppShell`'s panes, named by `Mount::Pane` | `craft_ui::contract` | 16.2 |
| `Show`, `ShowContainer`, `ShowCollection` | The sealed show traits the library writes for each shape | `craft_ui::contract` | 1.3 |
| `ShowAt` | Where the pipeline places a component | `craft_ui::contract` | 1.6 |
| `ShowShape` | The shape a type has (`Leaf`, `Body`, `Items`), which picks its show trait and default sense | `craft_ui::contract` | 1.1 |
| `SideLabel` | `ContainerProps.label` | `craft_ui::contract` | 16.2 |
| `FieldLabelRole` | Whether a field label names or describes its control, in `SideLabel` | `craft_ui::runtime::access` | 16.2 |
| `Sizing` | `ContainerProps.sizing` | `craft_ui::contract` | 16.2 |
| `Slot`, `Savable` | The bounds of a memory slot type, and of one the saved lifetime can store | `craft_ui::runtime::memory` | 7.2 |
| Stack position | An arena's first ordering key | — | 8.3 |
| `Stateful<T>` | The only per-state type a style field holds, resolved by one rule | craft-theme | 4.2 |
| `StateSet` | A component's or part's state, flags and animated mix for one frame | `craft_ui::style` | 4.1 |
| `Story`, `StoryOutput` | A named way to show one registered type, and its type-erased output | `craft_ui::testing` | 22.4 |
| `StoryData` | A story's own values, `value<T: Value>(name, init)`, snapshotted by the runner before and after a drive | `craft_ui::testing` | 22.4 |
| `*Style` structs | A component's `type Style` | the component's family | 1.11 |
| `StyleColor` | A colour a style builder picked from tokens | `craft_ui::style` | 4.3 |
| `StyleCx` | What `style` and the app colour hooks get | `craft_ui::style` | 1.5, 4 |
| `Styled` | The `Cx` trait with `resolve`, `resolve_part`, `state()` and `ink()`, all reading step 12's output | `craft_ui::contract` | 1.5, 4.2 |
| `StyleKey` | The derive-written `'static` key of the instance inputs a style depends on, generic over a generic component's type parameters (one per instantiation) | `craft_ui::style` | 1.1 |
| `StyleReplacements` | The type-erased, frozen form of `Looks` that `InstallSpec.looks` holds | `craft_ui::style` | 1.8, 4.4 |
| Sub-node, `SubNode` | An AccessKit node below a component's node, built with `Access::node(part, role)` for parts, cells and content, keyed by `PartRef` | `craft_ui::runtime::access` | 12.1 |
| Runtime sub-id | An id the runtime derives from a component id through `sub(base, tag)` | `craft_ui::runtime::memory` | 7.1 |
| `SurfaceKind` | The surface a container or part sits on (`Panel`, `Raised`, `Well`, `Popup`, ...), which picks fill, edge, shadow and ink | `craft_ui::style` | 5.2 |
| `TextKey`, `Codec` | The key of a text part and the conversion between its text and value | `craft_ui::primitives` (`TextKey`), craft-behavior (`Codec`) | 18.2 |
| `TextPos` | A position in an editor's visible lines | craft-behavior | 18.4 |
| `TextOptions`, `Completer`, `Completion` | A text part's options, and the trait and candidate type of its completion list | `craft_ui::primitives` (text adapter) | 18.2 |
| `TextOutcome` | A text part's result this pass, with its `TextLayout`, from `cx.text(&key)` | `craft_ui::primitives` | 18.2 |
| Text parts | `layout`, text outcomes and the editor stream and state, methods of `MeasureCx` and `PartsCx` | `craft_ui::contract` | 1.5, 18 |
| `TextRun`, `TextLayout` | The one description of UI text, and its laid-out form | `craft_ui::primitives` | 5.2 |
| `TextureCache` | The one texture path | `craft_ui::primitives::textures` | 5.5 |
| `ThemeScope` | Token-changing values (mode, contrast, a named theme, density, text size) for a container's body | `craft_ui::runtime::env` | 2.3 |
| `TitleRow`, `FooterBar` | The layer-5 components library containers show in their header and footer regions | `craft_ui` title-row and bar families | 16.4 |
| `Tokens` | craft-theme's resolved semantic token set | craft-theme | 4.4, 4.5 |
| Token group | A crate-prefixed group of semantic colour and shape tokens for a crate's own concepts | craft-theme (trait), `craft_ui::style` (cache) | 4.5 |
| `TokenGroup` | The trait a token group implements | craft-theme | 4.5 |
| `Tone` | The tone axis of a variant | craft-theme | 4.4 |
| `Tooltip`, `TooltipSpec` | The one tooltip type, for components (`Common.tooltip`) and parts (`PartBuilder::tooltip`), and its boxed data | `craft_ui::contract` | 3.4 |
| Trial | One test in an integration binary, registered through the one registration macro | `craft_ui::testing` | 22.2 |
| `Trigger` | How a popup opens (`Manual`: only through `PopupHandle::open` and the binding) | `craft_ui::contract` | 15.5 |
| `UiTokens` | The runtime's egui-ready view of one resolved token set | `craft_ui::style` | 4.5 |
| `Validity<T>` | A binding check's verdict | craft-behavior | 10.2 |
| `Value` | The bound every value type meets | craft-behavior | 10.2 |
| `ValueOf<C>` | The value type of component `C`, `<C::Output as Outcome>::Value` | `craft_ui::contract` | 10.2 |
| Variant | A component's look within its style | craft-theme | 4.4 |
| Viewport mount | `Mount::Viewport` | `craft_ui::contract` | 16.2 |
| `ViewportShare` | A fraction of the viewport per axis, the cap of `OverlayFit::ContentCapped` | `craft_ui::contract` | 15.4 |
| `Wheel` | A component's share of wheel and pinch input after the split rule | craft-behavior | 8.6 |
| `WheelUnit`, `WheelPhase` | A wheel event's unit and phase, craft-behavior copies of egui's | craft-behavior | 8.6 |
| `WindowChrome` | How a window's frame is drawn (OS, custom, none), part of `WindowInfo` | craft-host (`target`) | 21.1 |
| `WindowInfo` | A window's kind, chrome, state, insets and `active` (OS focus), refreshed in `set_input` | craft-host (`target`) | 21.1 |
| `WordSet` | The trait a `words!` block writes | the word core (open question 13) | 19.2 |
| `WordSetCx` | The trait on every context with `label()` and `words::<L>()` | `craft_ui::contract` | 19.2 |
| `words::<L>()` | The `WordSetCx` method that returns the word set `L` | `WordSetCx` method | 19.2 |