@astryxdesign/core 0.7.6 → 0.7.7-canary.0d1ddcd

package/dist/Slider/sliderTouchController.d.ts

@@ -0,0 +1,189 @@
+import { type MotionCurve } from '../motion/animator.js';
+import { type SpringDescription } from '../motion/spring.js';
+/** The parts the controller moves. */
+export interface SliderTouchParts {
+    readonly control: HTMLElement;
+    readonly thumbs: ReadonlyArray<HTMLElement>;
+    /** The fill's mover (a range's start) and the fill itself. */
+    readonly fillMover: HTMLElement | null;
+    readonly fill: HTMLElement | null;
+}
+/** What the controller needs from Slider. Read fresh on every use. */
+export interface SliderTouchModel {
+    readonly min: number;
+    readonly max: number;
+    readonly isRange: boolean;
+    readonly isHorizontal: boolean;
+    readonly isDisabled: boolean;
+    /** The thumb's size along the travel, px: the travel is inset by half of it. */
+    readonly thumbSize: number;
+    /** The values the owner rendered. */
+    values(): ReadonlyArray<number>;
+    /** What thumb `index` becomes for `raw`: snapped, clamped, kept apart. */
+    constrain(index: number, raw: number): number;
+    /** The range thumb `index` may cover, unsnapped (its ends and the gap). */
+    bounds(index: number): readonly [number, number];
+    /**
+     * `onChange` for thumb `index`. `from` holds the start values when one
+     * move changes both range thumbs, as a drag passed between coincident
+     * thumbs does.
+     */
+    change(index: number, value: number, from?: ReadonlyArray<number>): void;
+    /** Thumb `index` is under a finger (pressed paint, focus, tooltip), or none. */
+    press(index: number | null): void;
+    /**
+     * The interaction ended. Report thumb `index`'s last `value` through
+     * `onChange`, or null when the interaction ends on no value of its own.
+     * Report it even when a frame's report already carried it: these handlers
+     * run outside React's events, so that report's render can be pending.
+     * Release the pressed paint. Then have the owner render it all now, so the
+     * parts can return to the stylesheet and `onChangeEnd` carries what the
+     * owner rendered.
+     */
+    commit(index: number, value: number | null): void;
+    /** `onChangeEnd`, with the values the owner rendered. */
+    reportEnd(): void;
+    /**
+     * The value a press at client point (`x`, `y`) on the track means: a
+     * mark's value on a mark, else the point along the travel.
+     */
+    valueAt(x: number, y: number): number;
+    /** The thumb a track press at `value` moves. */
+    thumbFor(value: number): number;
+}
+/**
+ * The release coast as a curve in the thumb's own px, clamped to the
+ * thumb's range. It is a spring from `from` to `to` with `velocity` (px/s).
+ * Its value stops at an end instead of passing it, as UISlider clamps its
+ * value and the thumb follows it.
+ */
+export declare function sliderCoastCurve({ from, to, velocity, lower, upper, spring: description, }: {
+    from: number;
+    to: number;
+    velocity: number;
+    lower: number;
+    upper: number;
+    /** The release spring, as the thumb's theme resolves it. */
+    spring?: SpringDescription;
+}): MotionCurve;
+/** UISlider's touch tracking for one Slider (both thumbs of a range). */
+export declare class SliderTouchController {
+    private model;
+    private readonly getParts;
+    private readonly interactions;
+    private readonly animators;
+    /** The owner unmounted the slider: a cancel reports nothing then. */
+    private disposed;
+    /** Thumbs whose current touch is a mouse: Slider's own handlers take it. */
+    private readonly mouseOwners;
+    /** The track's tap (see handleTrackTap). Null while detached. */
+    private trackTap;
+    constructor(model: SliderTouchModel, getParts: () => SliderTouchParts | null);
+    setModel(model: SliderTouchModel): void;
+    /**
+     * Attaches the recognizers to the thumbs for every pointer. Under a
+     * coarse primary pointer each thumb's `::before` is its touch target.
+     */
+    attach(): () => void;
+    /** Stops every interaction and animation without reporting (unmount). */
+    dispose(): void;
+    /**
+     * Ends every live interaction without a word to the owner, and returns
+     * them. It runs from an Effect cleanup, where `onChange`, `onChangeEnd` and
+     * a synchronous render have no place. A coast stops where it is drawn, and
+     * the parts return to the stylesheet at the value the owner last rendered.
+     */
+    private endSilently;
+    /**
+     * Ends the interactions a detach cancelled while the slider stays mounted,
+     * as when it is disabled mid-drag. Each releases its pressed paint. If any
+     * changed the value, `onChangeEnd` reports once. This waits until the
+     * cleanup's task ends, and an unmount in the same commit drops it.
+     */
+    private cancelLater;
+    /**
+     * After the owner rendered an ended interaction's final value, the thumb
+     * and the fill go back to the positions Slider's CSS gives them. Parts that
+     * a coast of another thumb still drives stay with it.
+     */
+    private handBack;
+    private handleControlEvent;
+    private handleHighlight;
+    private handlePan;
+    /** UISlider's veto: an ancestor's pan or swipe along the travel. */
+    private vetoes;
+    private begin;
+    private track;
+    /**
+     * Writes the moving thumb's and the fill's positions for the
+     * interaction's value straight to their translates: one visual update per
+     * move, with no component render. The parts go back to
+     * the stylesheet when the interaction ends (`handBack`).
+     */
+    private place;
+    /**
+     * Records a new value and plays the end haptic on entering an end.
+     * Reports it through `onChange` unless the interaction's end commits it.
+     * Returns whether the value changed.
+     */
+    private record;
+    private report;
+    private release;
+    /**
+     * A tap on the track: the thumb the tap's value picks springs there, on
+     * the release spring from rest. It reports as a coast does, and
+     * `onChangeEnd` follows. A tap on the thumb's own value changes nothing.
+     */
+    private handleTrackTap;
+    /**
+     * Springs the interaction's thumb from its value to `target`, on the
+     * compositor and clamped, starting at `velocityPx` (px/s along the
+     * travel). `onChange` follows from the coast's fourth frame, and the
+     * interaction ends (`onChangeEnd`) on its last. `touchRelease` means a
+     * finger's release started it. Then the coast continues the throw and
+     * keeps moving under Reduce Motion. A tap's spring never runs there
+     * (`handleTrackTap` sets the value at once).
+     */
+    private coastTo;
+    /** Ends the coast when its thumb's motion finishes, not when it stops. */
+    private endCoastWithThumb;
+    /**
+     * After the track's length changed: every live interaction measures it
+     * again. A drag writes its parts for the new length, and a coast plays
+     * on from where its curve is now, scaled to the new travel.
+     */
+    private followTrackLength;
+    /**
+     * Plays the coast on the thumb and the fill parts, on one clock that
+     * started at `at`. A re-mapped coast plays on from where its curve is.
+     */
+    private playCoast;
+    /**
+     * The parts that move with the interaction's thumb. Each has its translate
+     * as a function of the thumb's px along the travel (`p`), and that
+     * function's slope. The formulas are the same as Slider's CSS.
+     */
+    private partMaps;
+    /**
+     * Stops a coast where the browser draws the thumb in this frame. Returns
+     * the value there for `finish` to end on, or null when the travel has no
+     * length. The animator's own reading can run a frame ahead of or behind
+     * what is drawn, and a finger stops what it sees.
+     */
+    private stopCoast;
+    /**
+     * Ends an interaction from the handler that ends it: the lift, the cancel
+     * or the coast's last frame. The owner renders the last value at once, and
+     * the parts return to the stylesheet. `onChangeEnd` then reports what the
+     * owner rendered, unless the browser took the touch before any drag
+     * (`report` false).
+     */
+    private finish;
+    private lift;
+    private drop;
+    private measure;
+    private endOf;
+    private animatorFor;
+    private partsOf;
+}
+//# sourceMappingURL=sliderTouchController.d.ts.map

package/dist/Slider/sliderTouchController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliderTouchController.d.ts","sourceRoot":"","sources":["../../src/Slider/sliderTouchController.ts"],"names":[],"mappings":"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"}