@rafaelaugusto/jolt 0.1.0-beta.9 → 0.1.0-rc.10

package/dist/web/scroll.js

@@ -0,0 +1,247 @@
+import { DerivedValueNode, NumericValue } from './value.js';
+import { numericMap } from '../core/numeric-map.js';
+export function scrollAxis(options = {}) {
+    if (!options ||
+        typeof options !== 'object' ||
+        Array.isArray(options) ||
+        Object.keys(options).some((key) => key !== 'axis'))
+        throw new TypeError('Scroll value options support axis.');
+    const axis = options.axis ?? 'y';
+    if (axis !== 'x' && axis !== 'y')
+        throw new TypeError('Scroll axis must be x or y.');
+    return axis;
+}
+function flow(view, element, axis) {
+    const css = view.getComputedStyle(element);
+    if (css.writingMode !== 'horizontal-tb' ||
+        css.flexDirection === (axis === 'x' ? 'row-reverse' : 'column-reverse'))
+        throw new TypeError('Scroll motion supports ordinary horizontal/vertical flow, not reversed flex or vertical writing modes.');
+    return axis === 'x' && css.direction === 'rtl';
+}
+/** Normalized CSS pixels. A fixed source/axis; replacement uses a new handle. */
+export class ScrollValueNode extends NumericValue {
+    document;
+    source;
+    axis;
+    element;
+    view;
+    resize;
+    mutations;
+    flowChanges;
+    rtl = false;
+    observed = new Set();
+    listening = false;
+    maximum = 0;
+    geometryDirty = true;
+    next = 0;
+    lastChange = 0;
+    task = {
+        read: () => {
+            this.next = this.readOffset();
+        },
+        update: (at) => {
+            this.updateOffset(this.next, at);
+        },
+    };
+    enqueue = () => {
+        if (!this.ended)
+            this.scheduler.add(this.task);
+    };
+    invalidate = () => {
+        this.geometryDirty = true;
+        this.enqueue();
+    };
+    constructor(document, source, axis, scheduler, report, forget) {
+        const view = document.defaultView;
+        const element = source === document ? document.scrollingElement : source;
+        if (!(element instanceof view.HTMLElement) ||
+            !element.isConnected ||
+            element.ownerDocument !== document)
+            throw new TypeError('Scroll sources must be the runtime document or a mounted HTMLElement in it.');
+        flow(view, element, axis);
+        super(scheduler, 0, report, forget);
+        this.document = document;
+        this.source = source;
+        this.axis = axis;
+        this.view = view;
+        this.element = element;
+        this.position = this.next = this.readOffset();
+        this.resize = new view.ResizeObserver(this.invalidate);
+        this.mutations = new view.MutationObserver(() => {
+            this.observeContent();
+            this.invalidate();
+        });
+        this.mutations.observe(element, {
+            childList: true,
+            subtree: true,
+            characterData: true,
+        });
+        this.flowChanges = new view.MutationObserver(this.invalidate);
+        for (let ancestor = element; ancestor; ancestor = ancestor.parentElement)
+            this.flowChanges.observe(ancestor, {
+                attributes: true,
+                attributeFilter: ['dir', 'class', 'style'],
+            });
+        this.observeContent();
+        view.addEventListener('resize', this.invalidate);
+        document.fonts?.addEventListener('loadingdone', this.invalidate);
+    }
+    observeContent() {
+        const wanted = new Set([this.element, ...this.element.children]);
+        for (const node of this.observed)
+            if (!wanted.has(node)) {
+                this.resize.unobserve(node);
+                this.observed.delete(node);
+            }
+        for (const node of wanted)
+            if (!this.observed.has(node)) {
+                this.resize.observe(node);
+                this.observed.add(node);
+            }
+    }
+    readOffset() {
+        if (!this.element.isConnected || this.element.ownerDocument !== this.document) {
+            this.dispose();
+            return this.position;
+        }
+        if (this.geometryDirty) {
+            this.rtl = flow(this.view, this.element, this.axis);
+            this.maximum = Math.max(0, this.axis === 'x'
+                ? this.element.scrollWidth - this.element.clientWidth
+                : this.element.scrollHeight - this.element.clientHeight);
+            this.geometryDirty = false;
+        }
+        const offset = this.axis === 'x'
+            ? this.element.scrollLeft * (this.rtl ? -1 : 1)
+            : this.element.scrollTop;
+        return Math.min(this.maximum, Math.max(0, offset));
+    }
+    updateOffset(value, at) {
+        if (this.ended)
+            return;
+        const elapsed = at - this.time;
+        const speed = value === this.position || elapsed <= 0
+            ? 0
+            : ((value - this.position) * 1000) / elapsed;
+        this.time = at;
+        if (value !== this.position)
+            this.lastChange = at;
+        this.publish(value, speed);
+    }
+    get() {
+        return this.ended ? this.position : this.readOffset();
+    }
+    getVelocity() {
+        // Scroll velocity is sampled input, not an analytic browser trajectory.
+        return this.ended || this.scheduler.now() - this.lastChange > 100 ? 0 : this.speed;
+    }
+    demandChanged() {
+        const needed = this.demanded && !this.ended;
+        if (needed === this.listening)
+            return;
+        this.listening = needed;
+        if (needed)
+            this.source.addEventListener('scroll', this.enqueue, { passive: true });
+        else
+            this.source.removeEventListener('scroll', this.enqueue);
+    }
+    refresh() {
+        if (this.ended)
+            return;
+        this.geometryDirty = true;
+        this.observeContent();
+        this.updateOffset(this.readOffset(), this.scheduler.now());
+    }
+    dispose() {
+        if (this.ended)
+            return;
+        this.source.removeEventListener('scroll', this.enqueue);
+        this.resize?.disconnect();
+        this.mutations?.disconnect();
+        this.flowChanges?.disconnect();
+        this.observed.clear();
+        this.view?.removeEventListener('resize', this.invalidate);
+        this.document.fonts?.removeEventListener('loadingdone', this.invalidate);
+        this.scheduler.remove(this.task);
+        super.dispose();
+    }
+}
+export function scrollPlan(frames, options) {
+    if (!options ||
+        typeof options !== 'object' ||
+        Object.keys(options).some((k) => !['range', 'execution', 'times', 'axis'].includes(k)))
+        throw new TypeError('Scroll options support range, execution, times and axis.');
+    const axis = scrollAxis({ axis: options.axis });
+    const range = options.range;
+    if (!Array.isArray(range) ||
+        range.length !== 2 ||
+        range.some((n) => !Number.isFinite(n)) ||
+        range[0] < 0 ||
+        range[1] <= range[0] ||
+        range[1] > 1e9)
+        throw new RangeError('Scroll range must increase between 0 and 1e9 CSS pixels.');
+    if (options.execution !== undefined &&
+        !['auto', 'scheduler'].includes(options.execution))
+        throw new TypeError('Scroll execution must be auto or scheduler.');
+    if (!frames || typeof frames !== 'object' || !Object.keys(frames).length)
+        throw new TypeError('Scroll playback requires explicit numeric keyframes.');
+    const plans = new Map();
+    for (const [name, output] of Object.entries(frames)) {
+        if (!['x', 'y', 'rotate', 'scale', 'scaleX', 'scaleY', 'opacity'].includes(name))
+            throw new TypeError('Scroll playback supports 2D transforms and opacity.');
+        if (!Array.isArray(output))
+            throw new TypeError('Scroll frames must be explicit numeric arrays.');
+        const offsets = options.times ?? output.map((_, i) => i / (output.length - 1));
+        if (offsets[0] !== 0 || offsets.at(-1) !== 1)
+            throw new RangeError('Scroll times must start at 0 and end at 1.');
+        numericMap(offsets, output);
+        const input = offsets.map((t) => range[0] + (range[1] - range[0]) * t);
+        numericMap(input, output);
+        for (const property of name === 'scale'
+            ? ['scaleX', 'scaleY']
+            : [name]) {
+            if (name === 'scale' && frames[property])
+                continue;
+            plans.set(property, {
+                input,
+                output: [...output],
+                points: offsets.map((p, i) => ({ time: p * 1000, value: output[i] })),
+            });
+        }
+    }
+    return {
+        plans,
+        range: [range[0], range[1]],
+        native: options.execution !== 'scheduler',
+        axis,
+    };
+}
+export class ScrollLinkedNode extends DerivedValueNode {
+    scroll;
+    property;
+    range;
+    points;
+    native;
+    reduced;
+    constructor(scroll, property, range, points, native, input, output, reduced, report, forget) {
+        super(scroll, numericMap(input, output), report, forget);
+        this.scroll = scroll;
+        this.property = property;
+        this.range = range;
+        this.points = points;
+        this.native = native;
+        this.reduced = reduced;
+    }
+    get spatiallyReduced() {
+        return this.property !== 'opacity' && this.reduced();
+    }
+    get() {
+        return !this.disposed && this.spatiallyReduced
+            ? this.points.at(-1).value
+            : super.get();
+    }
+    getVelocity() {
+        return this.spatiallyReduced ? 0 : super.getVelocity();
+    }
+}
+//# sourceMappingURL=scroll.js.map

package/dist/web/scroll.js.map

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

package/dist/web/sensors.d.ts

@@ -0,0 +1,61 @@
+import type { PlatformHost } from './platform-host.js';
+import { NumericValue, type WebReadableValue } from './value.js';
+import type { WebInteraction } from './interaction.js';
+export type WebSensorKind = 'rotation' | 'gravity';
+export type WebSensorStatus = 'idle' | 'permission-required' | 'starting' | 'active' | 'paused' | 'unavailable' | 'denied' | 'disposed';
+export interface WebSensorOptions {
+    interval?: number | 'auto';
+    coordinates?: 'device' | 'interface';
+    reducedMotion?: 'pause' | 'continue';
+    onStatus?: (status: WebSensorStatus) => void;
+}
+export interface WebSensor extends WebInteraction {
+    readonly kind: WebSensorKind;
+    readonly status: WebSensorStatus;
+    /** True only after a valid reading, never inferred from the presence of an API. */
+    readonly available: boolean;
+    readonly x: WebReadableValue;
+    readonly y: WebReadableValue;
+    readonly z: WebReadableValue;
+    /** Call directly from a user gesture. Never prompts during construction/resume. */
+    requestPermission(): Promise<'granted' | 'denied' | 'unavailable'>;
+    snapshot(): {
+        status: WebSensorStatus;
+        available: boolean;
+        timestamp: number | null;
+        samples: number;
+        values: number[];
+        reason?: string;
+        backend: 'device-orientation' | 'device-motion' | 'none';
+    };
+}
+export interface WebRotationSensor extends WebSensor {
+    readonly kind: 'rotation';
+    /** Relative XYZ radians and normalized Hamilton quaternion xyzw. */
+    readonly quaternion: Readonly<{
+        x: WebReadableValue;
+        y: WebReadableValue;
+        z: WebReadableValue;
+        w: WebReadableValue;
+    }>;
+    recenter(): void;
+}
+export interface WebGravitySensor extends WebSensor {
+    readonly kind: 'gravity';
+}
+export declare class SensorValueNode extends NumericValue {
+    demand?: (active: boolean) => void;
+    protected demandChanged(): void;
+    dispose(): void;
+}
+type Q = [number, number, number, number];
+export declare const multiply: (a: Q, b: Q) => Q;
+export declare function orientationQuaternion(alpha: number, beta: number, gamma: number): Q;
+export declare function interfaceVector(v: readonly number[], degrees: number): number[];
+export declare function rotationValues(q: Q, degrees: number, previous: readonly number[]): number[];
+export declare function createSensor(kind: WebSensorKind, options: WebSensorOptions, host: PlatformHost, makeValue: (initial: number) => {
+    node: SensorValueNode;
+    value: WebReadableValue;
+}): WebRotationSensor | WebGravitySensor;
+export {};
+//# sourceMappingURL=sensors.d.ts.map

package/dist/web/sensors.d.ts.map

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