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.

PaneDragBehaviorTuning

Combined drag behavior tuning constants.

PaneDragResizeMachine

Runtime lifecycle machine for pane drag/resize interactions.

PaneDragResizeTransition

One state-machine transition with deterministic telemetry fields.

PaneId

Stable identifier for pane nodes.

PaneIdAllocator

Deterministic allocator for pane IDs.

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.

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.

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.

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.

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.

PaneInputCoordinate

Input coordinate source variants accepted by pane normalization.

PaneInteractionPolicyError

Tuning/policy validation errors for pane interaction behavior controls.

PaneInvariantCode

Stable code for invariant findings.

PaneInvariantSeverity

Severity for one invariant finding.

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.

PaneRepairAction

One deterministic repair action.

PaneRepairFailure

Failure reason for safe repair.

PaneResizeDirection

Direction for semantic resize commands.

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_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_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.