@searsuite/sear-render-scroll

Constructs a scroller adapter.

DI token for resolving HeadlessScroller.

Returns the publisher.

Creates a SearError instance.

Stable machine-readable identifier for this error category.

Creates one controller and publishes every visual displacement change.

Applies validated host overrides and resets immediately when disabled.

Consumes one wheel or touch sample and returns a clamped logical position. Reversing direction first consumes existing excess before logical scrolling resumes.

Returns a copy of the current transient visual displacement.

Starts the boundary return after the configured input-settle delay.

Cancels pending work and restores the exact zero-displacement state.

Applies validated host overrides and resets an in-progress gesture.

Filters one two-dimensional input sample through the active direction lock.

Returns the currently selected axis, or null before activation.

Returns the configured wheel gesture-end delay.

Ends the current gesture and clears uncommitted sub-threshold input.

Creates a SearError instance.

Stable machine-readable identifier for this error category.

Constructs a scroller adapter.

Configuration engine available to concrete scroller adapters.

DI token used by hosts that provide a scroller container.

DI token for resolving the active scroller adapter.

Creates a scroller for a registered type.

ReturnsNew scroller adapter.

Registers a scroller creator.

Creates a scroll manager for a viewport of the given dimensions.

DI token for resolving the scroll manager.

Connects a scroll-event source and returns an idempotent disposer.

Applies platform scroll data within the owning editor's command.

Disconnects publishers and subscribers owned by this manager.

Closes direct viewport writes after the owning editor finishes restoration.

Reserves publisher cleanup for the owning editor.

Returns the maximum logical scroll positions for platform adapters.

Returns the viewport rectangle as (0, 0, width, height).

The scroll position is NOT included in the returned rect. Consumers that need the world-coordinate viewport should construct their own rect using scrollState.x/y (available via getState()).

Historically this method returned (state.x, state.y, width, height), but since ScrollManager.update() now clamps state.x/y in-place, including them caused double-offset bugs in render strategies that already add scrollState.x/y to compute world-coordinate query rects.

Returns the previous committed scroll state.

Returns the scroll state that render strategies should use for viewport copy planning.

deltaX and deltaY are computed from the last position marked as rendered to the current committed position. This keeps wheel scrolling and programmatic scrollTo() jumps on the same delta convention expected by RasterCopyPlan: previous minus current.

Returns the viewport dimensions as [width, height].

Returns the current committed scroll state.

Returns whether the current scroll position has not yet been rendered.

Marks the current committed scroll position as consumed by a render frame.

Requests an absolute scroll position through the owning editor.

Updates viewport dimensions and clamps the current position without emitting a scroll render.

Programmatically scroll to an absolute position, clamped to the content boundary, and notify all subscribers so the render pipeline re-draws.

Set the content boundary for scroll clamping.

Routes platform-originated viewport input through the host's action boundary.

Directly set the scroll position (x, y) in the manager's state.

Useful for programmatic scroll jumps (e.g. "scroll to cell A1"). For normal scroll events, use addPublisher + update() instead, which clamps the position to the content boundary.

Binds programmatic scroll requests to the owning editor's command bus.

Subscribes to scroll-state changes and returns an idempotent disposer. prepend is reserved for updates that must run before render strategies.

Creates a WebScroller instance.

DI token for resolving WebScroller.

Enables or tunes Safari-style dominant-axis locking for wheel and touch gestures.

Enables or tunes the Safari-style overscroll effect. Logical editor coordinates remain clamped; only the visible surface moves.

Returns the publisher.

Smooth asymptotic maximum visual displacement in viewport pixels.

Initial slope of the rubber-band curve. Lower values reduce sensitivity.

Default delay used when release is called without an explicit delay.

Viscous damping used by the damped harmonic return motion.

Spring mass used by the damped harmonic return motion.

Spring stiffness used by the damped harmonic return motion.

Keeps an already scheduled return alive for same-direction wheel inertia.

Content displacement: positive values move the visible surface right/down.

Accumulated pixels required before selecting the dominant axis.

Wheel silence in milliseconds that separates two gestures.

Horizontal input delta that produced the update.

Vertical input delta that produced the update.

Current horizontal scroll offset in world coordinates.

Current vertical scroll offset in world coordinates.