Module pane 

Canonical pane split-tree schema and validation.

This module defines a host-agnostic pane tree model intended to be shared by terminal and web adapters. It focuses on:

• Deterministic node identifiers suitable for replay/diff.
• Explicit parent/child relationships for split trees.
• Canonical serialization snapshots with forward-compatible extension bags.
• Strict validation that rejects malformed trees.

Structs

PaneConstraints

Per-node size bounds.

PaneCoordinateNormalizer

Coordinate normalization configuration and transform pipeline.

PaneDockPreview

One magnetic docking preview candidate.

PaneDragBehaviorTuning

Combined drag behavior tuning constants.

PaneDragResizeMachine

Runtime lifecycle machine for pane drag/resize interactions.

PaneDragResizeTransition

One state-machine transition with deterministic telemetry fields.

PaneEdgeResizePlan

Result of planning a side/corner resize from one pointer sample.

PaneGroupTransformPlan

Planned group transform preserving the internal cluster.

PaneId

Stable identifier for pane nodes.

PaneIdAllocator

Deterministic allocator for pane IDs.

PaneInertialThrow

Inertial throw profile used after drag release.

PaneInteractionTimeline

Persistent interaction timeline with undo/redo cursor.

PaneInteractionTimelineEntry

One persistent timeline event for deterministic undo/redo/replay.

PaneInvariantIssue

One actionable invariant finding.

PaneInvariantReport

Structured invariant report over a pane tree snapshot.

PaneLayout

Concrete layout result for a solved pane tree.

PaneLeaf

Leaf payload for pane content identity.

PaneModifierSnapshot

Snapshot of active modifiers captured with one semantic event.

PaneMotionVector

Pointer motion summary used by pressure-sensitive policies.

PaneNodeRecord

Serializable node record in the canonical schema.

PaneNormalizedCoordinate

Deterministic normalized coordinate payload used by pane interaction layers.

PaneOperationError

Failure payload for transactional operation APIs.

PaneOperationJournalEntry

One deterministic operation journal row emitted by a transaction.

PaneOperationOutcome

Successful transactional operation result.

PanePointerPosition

Normalized interaction position in pane-local coordinates.

PanePrecisionPolicy

Modifier-derived precision/axis-lock policy for drag updates.

PanePressureSnapProfile

Dynamic snap aggressiveness derived from drag pressure cues.

PaneReflowMovePlan

Planned pane move with organic reflow semantics.

PaneRepairError

Error payload for repair attempts.

PaneRepairOutcome

Outcome from successful safe repair pass.

PaneResizeTarget

Canonical resize target for semantic pane input events.

PaneScaleFactor

Rational scale factor used for deterministic coordinate transforms.

PaneSelectionState

Multi-pane selection state for group interactions.

PaneSemanticInputEvent

Versioned semantic pane interaction event consumed by pane-core and emitted by host adapters.

PaneSemanticInputTrace

Canonical replay trace for semantic pane input streams.

PaneSemanticInputTraceMetadata

Metadata carried alongside semantic replay traces.

PaneSemanticReplayConformanceArtifact

Conformance comparison output for replay fixtures.

PaneSemanticReplayDiffArtifact

One structured replay conformance difference artifact.

PaneSemanticReplayFixture

Golden fixture shape for replay conformance runs.

PaneSemanticReplayOutcome

Replay output from running one trace through a pane interaction machine.

PaneSnapDecision

Output of snap-decision evaluation.

PaneSnapTuning

Deterministic snapping policy for pane split ratios.

PaneSplit

Split payload with child references.

PaneSplitRatio

Ratio between split children, stored in reduced form.

PaneTransaction

Transaction boundary wrapper for pane mutations.

PaneTransactionOutcome

Finalized transaction payload emitted by commit/rollback.

PaneTree

Validated pane tree model for runtime usage.

PaneTreeSnapshot

Canonical serialized pane tree shape.

Enums

PaneCancelReason

Canonical cancel reasons for pane interaction state machines.

PaneCoordinateNormalizationError

Coordinate normalization failures.

PaneCoordinateRoundingPolicy

Deterministic rounding policy for coordinate normalization.

PaneDockZone

Docking zones for magnetic insertion previews.

PaneDragResizeEffect

Transition effect emitted by one lifecycle step.

PaneDragResizeMachineError

Lifecycle machine configuration/runtime errors.

PaneDragResizeNoopReason

Explicit no-op diagnostics for lifecycle events that are safely ignored.

PaneDragResizeState

Deterministic pane drag/resize lifecycle state.

PaneEdgeResizePlanError

Errors while deriving edge/corner resize plans.

PaneInputCoordinate

Input coordinate source variants accepted by pane normalization.

PaneInteractionPolicyError

Tuning/policy validation errors for pane interaction behavior controls.

PaneInteractionTimelineError

Timeline replay/undo/redo failures.

PaneInvariantCode

Stable code for invariant findings.

PaneInvariantSeverity

Severity for one invariant finding.

PaneLayoutIntelligenceMode

High-level adaptive layout topology modes.

PaneModelError

Validation errors for pane schema construction.

PaneNodeKind

Node payload variant.

PaneOperation

Supported structural pane operations.

PaneOperationFailure

Structured reasons for pane operation failure.

PaneOperationJournalResult

Journal result state for one attempted operation.

PaneOperationKind

Stable operation discriminator used in logs and telemetry.

PanePlacement

Placement of an incoming node relative to an existing node inside a split.

PanePointerButton

Pointer button for pane interaction events.

PanePrecisionMode

Precision mode derived from modifier snapshots.

PaneReflowPlanError

Errors while planning reflow moves and docking previews.

PaneRepairAction

One deterministic repair action.

PaneRepairFailure

Failure reason for safe repair.

PaneResizeDirection

Direction for semantic resize commands.

PaneResizeGrip

Resize grip classification for any-edge / any-corner interaction.

PaneSemanticInputEventError

Validation failures for semantic pane input events.

PaneSemanticInputEventKind

Versioned semantic pane interaction event kind.

PaneSemanticInputTraceError

Validation failures for semantic replay trace payloads.

PaneSemanticReplayDiffKind

Classification for replay conformance differences.

PaneSemanticReplayError

Replay runner failures.

PaneSnapReason

Deterministic snap decision categories.

SplitAxis

Orientation of a split node.

Constants

PANE_DEFAULT_MARGIN_CELLS

Default pane margin in cell units.

PANE_DEFAULT_PADDING_CELLS

Default pane padding in cell units.

PANE_DRAG_RESIZE_DEFAULT_HYSTERESIS

Default minimum move distance (in coordinate units) required to emit a DragUpdated transition while dragging.

PANE_DRAG_RESIZE_DEFAULT_THRESHOLD

Default move threshold (in coordinate units) for transitioning from Armed to Dragging.

PANE_EDGE_GRIP_INSET_CELLS

Default inset from pane edges used to classify edge/corner grips.

PANE_MAGNETIC_FIELD_CELLS

Default radius for magnetic docking attraction in cell units.

PANE_SEMANTIC_INPUT_EVENT_SCHEMA_VERSION

Current schema version for semantic pane interaction events.

PANE_SEMANTIC_INPUT_TRACE_SCHEMA_VERSION

Current schema version for semantic pane replay traces.

PANE_SNAP_DEFAULT_HYSTERESIS_BPS

Default snap stickiness window in basis points.

PANE_SNAP_DEFAULT_STEP_BPS

Default snapping interval expressed in basis points (0..=10_000).

PANE_TREE_SCHEMA_VERSION

Current pane tree schema version.