Expand description
Portable editor tools that produce source transactions. A host supplies measured geometry; layout, property and selection commands never mutate preview objects directly.
Structs§
- Affine
- Row-vector affine transform: x’=xm11+ym21+dx, y’=xm12+ym22+dy.
- Component
Catalog - Component
Entry - Component
Reference - Component
Resource Context - The runtime’s active theme and its inheritance chain, nearest inherited variant
first.
None(orDefault) looks only in Default dictionaries before merges. Keys are decoded string theme keys; custom expression keys remain uncertain. - Component
Resource Resolution - All declarations which might supply a resource in this context. With no theme context, this is a conservative union across theme variants and their fallbacks.
- Editor
Registry - Grid
Lines - Grid
Track Placement - Effective placement along one axis, supplied by a native host after resolving styles.
- Layout
Capabilities - Layout
Context - Bounds and resolved slots use one common coordinate space. Grid boundaries use panel-local units.
- Layout
Guide - Layout
Handle - Layout
Helper Request - Layout
Helper Scene - Layout
Placement - Layout
Registry - Move
Gesture - An immutable drag start snapshot. Preview is pure geometry; commit refuses to apply a stale gesture after source or collaboration edits have changed the authored revision.
- Point
- Property
Descriptor - Property
Registry - Property
State - Rect
- Resolved
Layout - Effective layout values supplied by the live host. A slot is the rectangle passed to the child’s arrange method, before its margins, alignment and render transform are applied.
- Selection
- Snap
Guide - Snap
Index - Immutable, sorted guide geometry for repeated pointer updates. Prepare once when a gesture begins; each query examines only the nearest two guides for each anchor, independent of the number of objects on the artboard.
- Snap
Result - Snap
Settings - Tool
Error
Enums§
- Alignment
- Axis
- Component
Action - Semantic commands suitable for UI controls, automation and alternative designer hosts.
- Component
Kind - Dock
Side - Expression
Policy - Grid
Length - Grid
Track Change - Indices refer to the current axis. Insertion is before
index, includinglen()to append. - Layout
Action - Layout
Guide Geometry - Layout
Guide Role - Layout
Handle Action - Property
Kind - Property
Value Shape - Relative
Relation - Selection
Mode
Traits§
- Layout
Adapter - Third-party panels register source planners, with the same transactional validation as built-ins.
- Value
Editor - Property validation is independent of native editor widgets. A host can register a custom value editor first and use its ID to choose an associated native control factory.
Functions§
- align
- component_
fragment - A self-contained source fragment retaining original trivia and all inherited namespaces. Explicit namespace declarations on the element are kept exactly as authored.
- component_
property_ attribute - Read the authored scalar/expression while preserving a qualified attribute’s prefix.
- component_
property_ elements - Resolve a property’s authored object container by its expanded owner/member identity. Different application namespaces and attached-property owners remain independent.
- component_
property_ object - Export a property’s object/collection content with independent namespace closure.
- component_
resource_ expression - Build a scope-qualified StaticResource/DynamicResource expression without treating punctuation, quotes or a leading brace in the key as markup syntax.
- component_
resource_ references - component_
resource_ resolution - Inspect resource lookup, including possible references which cannot safely be represented by a single NodeId. Authoring uses this conservative information to protect resources referenced only in some themes or behind external providers.
- distribute
- grid_
track_ values - Returns lexical lengths, including bindings on individual definitions. Inspectors can display such values without replacing an expression or discarding definition metadata.
- outermost
- Remove descendant selections and duplicates so moving a selected group does not move a child twice. Order remains the caller’s order; unknown IDs are rejected rather than silently ignored.
- plan_
component_ action - plan_
component_ action_ in_ context - Plan resource application against an explicit runtime theme. All other actions, especially rename and deletion, retain conservative cross-theme reference checks. A host must revalidate the targets’ actual theme context before committing this plan.
- plan_
grid_ track_ change - Plans one atomic definition/cell edit. Inserts expand a child spanning the new track; removals shrink spans and move children in a removed track to its surviving neighbour. Bound cell positions are rejected because their future effective index is not knowable.
- plan_
grid_ track_ change_ with_ placements - Native variant: every authored child must have a measured placement. Hosts must reject active bindings before supplying these values, as a new local value would detach them.
- plan_
layout_ attributes - Plan native layout attributes without changing attached-property namespace identity or overwriting bindings/property elements. Values must already be validated by the adapter. New native attached properties are qualified when the lexical default namespace is custom.
- plan_
property_ object - Replace/reset a single object or collection property across a selection atomically. Input fragments may use namespaces inherited from the target, or declare their own.
- resolve_
component_ resource - Resolve a resource without guessing an active theme. Local entries take precedence; then theme dictionaries and their Default fallback; then reverse-order merges and ancestors. Ambiguous theme variants and unindexed external providers return None.
- resolve_
component_ resource_ in_ context - Resolve using the actual runtime theme and complete inherited-variant chain.
- visible_
component_ resources - Visible string-key resources, with nearest scope and merge order already resolved.
- visible_
component_ resources_ in_ context - Visible string-key resources for one concrete runtime theme, using the same
resolution contract as
plan_component_action_in_contextresource application.