@remix-run/ui 0.0.0 → 0.1.1

package/dist/animation/animate-mixins.js

@@ -0,0 +1,235 @@
+import { createMixin } from "../runtime/mixins/mixin.js";
+import { invariant } from "../runtime/invariant.js";
+const DEFAULT_ENTER = {
+    opacity: 0,
+    duration: 150,
+    easing: 'ease-out',
+};
+const DEFAULT_EXIT = {
+    opacity: 0,
+    duration: 150,
+    easing: 'ease-in',
+};
+const animatingNodes = new WeakMap();
+const initialEntranceSeenByParent = new WeakMap();
+function extractStyleProps(config) {
+    let result = {};
+    for (let key in config) {
+        if (key === 'duration' ||
+            key === 'easing' ||
+            key === 'delay' ||
+            key === 'composite' ||
+            key === 'initial') {
+            continue;
+        }
+        let value = config[key];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string' && typeof value !== 'number')
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+function buildEnterKeyframes(config) {
+    let keyframe = extractStyleProps(config);
+    return [keyframe, {}];
+}
+function buildExitKeyframes(config) {
+    let keyframe = extractStyleProps(config);
+    return [{}, keyframe];
+}
+function resolveEnterConfig(config) {
+    if (!config)
+        return null;
+    if (config === true)
+        return DEFAULT_ENTER;
+    return config;
+}
+function resolveExitConfig(config) {
+    if (!config)
+        return null;
+    if (config === true)
+        return DEFAULT_EXIT;
+    return config;
+}
+function createAnimationOptions(config, fill) {
+    return {
+        duration: config.duration,
+        delay: config.delay,
+        easing: config.easing,
+        composite: config.composite,
+        fill,
+    };
+}
+function collectAnimatedProperties(keyframes) {
+    let properties = new Set();
+    for (let keyframe of keyframes) {
+        for (let key in keyframe) {
+            if (key === 'offset' || key === 'easing' || key === 'composite')
+                continue;
+            properties.add(key);
+        }
+    }
+    return [...properties];
+}
+function toCssPropertyName(property) {
+    return property.includes('-')
+        ? property
+        : property.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`);
+}
+function readInlineStyle(style, property) {
+    return style.getPropertyValue(toCssPropertyName(property));
+}
+function writeInlineStyle(style, property, value) {
+    let cssProperty = toCssPropertyName(property);
+    if (value === '') {
+        style.removeProperty(cssProperty);
+        return;
+    }
+    style.setProperty(cssProperty, value);
+}
+function trackAnimation(node, animation, keyframes) {
+    let properties = collectAnimatedProperties(keyframes);
+    animatingNodes.set(node, { animation, properties });
+    animation.finished
+        .catch(() => { })
+        .finally(() => {
+        let current = animatingNodes.get(node);
+        if (current?.animation !== animation)
+            return;
+        animatingNodes.delete(node);
+    });
+}
+function waitForAnimationOrAbort(animation, signal) {
+    if (signal.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        let settled = false;
+        let settle = () => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', settle);
+            resolve();
+        };
+        signal.addEventListener('abort', settle, { once: true });
+        void animation.finished.catch(() => { }).finally(settle);
+    });
+}
+function shouldSkipInitialEntrance(event, config) {
+    if (config.initial !== false)
+        return false;
+    if (event.key == null)
+        return false;
+    let seenForParent = initialEntranceSeenByParent.get(event.parent);
+    if (!seenForParent) {
+        seenForParent = new Set();
+        initialEntranceSeenByParent.set(event.parent, seenForParent);
+    }
+    if (seenForParent.has(event.key))
+        return false;
+    seenForParent.add(event.key);
+    return true;
+}
+const animateEntranceMixin = createMixin((handle) => {
+    let currentConfig = true;
+    handle.addEventListener('insert', (event) => {
+        let node = event.node;
+        let current = animatingNodes.get(node);
+        if (current && current.animation.playState === 'running') {
+            return;
+        }
+        let config = resolveEnterConfig(currentConfig);
+        if (!config)
+            return;
+        if (shouldSkipInitialEntrance(event, config))
+            return;
+        let keyframes = buildEnterKeyframes(config);
+        let options = createAnimationOptions(config, 'backwards');
+        let animation = node.animate(keyframes, options);
+        trackAnimation(node, animation, keyframes);
+    });
+    return (config) => {
+        currentConfig = config;
+        return handle.element;
+    };
+});
+const animateExitMixin = createMixin((handle) => {
+    let currentConfig = true;
+    let node = null;
+    handle.addEventListener('insert', (event) => {
+        node = event.node;
+    });
+    handle.addEventListener('reclaimed', (event) => {
+        node = event.node;
+        let current = animatingNodes.get(event.node);
+        if (current && current.animation.playState === 'running') {
+            // WAAPI can throw InvalidStateError here if the target is transiently non-rendered
+            // during reclaim; we still have computed-style fallback below for retargeting.
+            try {
+                current.animation.commitStyles();
+            }
+            catch { }
+            current.animation.cancel();
+            let style = event.node.style;
+            let computed = getComputedStyle(event.node);
+            let from = {};
+            for (let property of current.properties) {
+                let cssProperty = toCssPropertyName(property);
+                let value = readInlineStyle(style, property) || computed.getPropertyValue(cssProperty);
+                if (value !== '') {
+                    from[property] = value;
+                }
+                writeInlineStyle(style, property, '');
+            }
+            let enterConfig = resolveEnterConfig(currentConfig) ?? DEFAULT_ENTER;
+            let keyframes = [from, {}];
+            let options = createAnimationOptions(enterConfig, 'none');
+            let animation = event.node.animate(keyframes, options);
+            trackAnimation(event.node, animation, keyframes);
+        }
+    });
+    handle.addEventListener('beforeRemove', (event) => {
+        let config = resolveExitConfig(currentConfig);
+        if (!config)
+            return;
+        event.persistNode(async (signal) => {
+            invariant(node);
+            let current = animatingNodes.get(node);
+            if (current && current.animation.playState === 'running') {
+                current.animation.reverse();
+                await waitForAnimationOrAbort(current.animation, signal);
+                return;
+            }
+            let keyframes = buildExitKeyframes(config);
+            let options = createAnimationOptions(config, 'forwards');
+            let animation = node.animate(keyframes, options);
+            trackAnimation(node, animation, keyframes);
+            await waitForAnimationOrAbort(animation, signal);
+        });
+    });
+    return (config) => {
+        currentConfig = config;
+        return handle.element;
+    };
+});
+/**
+ * Animates an element when it is inserted into the DOM.
+ *
+ * @param config Entrance animation configuration.
+ * @returns A mixin descriptor for the target element.
+ */
+export function animateEntrance(config = true) {
+    return animateEntranceMixin(config);
+}
+/**
+ * Animates an element when it is removed from the DOM.
+ *
+ * @param config Exit animation configuration.
+ * @returns A mixin descriptor for the target element.
+ */
+export function animateExit(config = true) {
+    return animateExitMixin(config);
+}
+//# sourceMappingURL=animate-mixins.js.map

package/dist/animation/animate-mixins.js.map

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

package/dist/animation/index.d.ts

@@ -0,0 +1,6 @@
+export { animateEntrance, animateExit } from './animate-mixins.ts';
+export { animateLayout } from './animate-layout-mixin.ts';
+export { spring } from './spring.ts';
+export type { SpringIterator, SpringPreset, SpringOptions } from './spring.ts';
+export { tween, easings } from './tween.ts';
+export type { TweenOptions, BezierCurve } from './tween.ts';

package/dist/animation/index.js

@@ -0,0 +1,5 @@
+export { animateEntrance, animateExit } from "./animate-mixins.js";
+export { animateLayout } from "./animate-layout-mixin.js";
+export { spring } from "./spring.js";
+export { tween, easings } from "./tween.js";
+//# sourceMappingURL=index.js.map

package/dist/animation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/animation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/dist/animation/spring.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Spring physics based on SwiftUI's spring math.
+ *
+ * Returns a decorated iterator that can be:
+ * - Iterated to get position values (0→1)
+ * - Spread for WAAPI: { ...spring() }
+ * - Stringified for CSS: `transform ${spring()}`
+ *
+ * Spring Parameter Conversion (SwiftUI formulas, mass = 1):
+ *   stiffness = (2π ÷ duration)²
+ *   damping = 1 - 4π × bounce ÷ duration  (bounce ≥ 0)
+ *   damping = 4π ÷ (duration + 4π × bounce)  (bounce < 0)
+ */
+export type SpringPreset = 'smooth' | 'snappy' | 'bouncy';
+/**
+ * Options for generating a spring easing iterator.
+ */
+export interface SpringOptions {
+    /** Perceptual duration in milliseconds used to derive spring stiffness. */
+    duration?: number;
+    /** Spring bounce amount from overdamped (`< 0`) to bouncy (`> 0`). */
+    bounce?: number;
+    /** Initial velocity in units per second. */
+    velocity?: number;
+}
+/**
+ * Iterator returned by {@link spring}, decorated for CSS and WAAPI use.
+ */
+export interface SpringIterator extends IterableIterator<number> {
+    /** Time when spring settles to rest (milliseconds) */
+    duration: number;
+    /** CSS linear() easing function */
+    easing: string;
+    /** Returns "duration ms linear(...)" for CSS transitions */
+    toString(): string;
+}
+/**
+ * Create a spring iterator for animations.
+ *
+ * @example
+ * let s = spring('bouncy')
+ *
+ * // As CSS transition
+ * element.style.transition = `transform ${s}`
+ *
+ * // Spread for WAAPI
+ * element.animate(keyframes, { ...spring() })
+ *
+ * // Iterate for JS animation
+ * for (let position of spring()) {
+ *   element.style.transform = `translateX(${position * 100}px)`
+ * }
+ */
+/**
+ * Creates a spring iterator from a named preset.
+ *
+ * @param preset Preset spring profile to start from.
+ * @param overrides Optional preset overrides.
+ * @returns A spring iterator.
+ */
+export declare function spring(preset: SpringPreset, overrides?: Omit<SpringOptions, 'bounce'>): SpringIterator;
+/**
+ * Creates a spring iterator from explicit spring options.
+ *
+ * @param options Spring parameters.
+ * @returns A spring iterator.
+ */
+export declare function spring(options?: SpringOptions): SpringIterator;
+export declare namespace spring {
+    var transition: (property: string | string[], presetOrOptions?: SpringPreset | SpringOptions, overrides?: Omit<SpringOptions, "bounce">) => string;
+    var presets: Record<SpringPreset, {
+        duration: number;
+        bounce: number;
+    }>;
+}

package/dist/animation/spring.js

@@ -0,0 +1,183 @@
+/**
+ * Spring physics based on SwiftUI's spring math.
+ *
+ * Returns a decorated iterator that can be:
+ * - Iterated to get position values (0→1)
+ * - Spread for WAAPI: { ...spring() }
+ * - Stringified for CSS: `transform ${spring()}`
+ *
+ * Spring Parameter Conversion (SwiftUI formulas, mass = 1):
+ *   stiffness = (2π ÷ duration)²
+ *   damping = 1 - 4π × bounce ÷ duration  (bounce ≥ 0)
+ *   damping = 4π ÷ (duration + 4π × bounce)  (bounce < 0)
+ */
+const presets = {
+    smooth: { duration: 400, bounce: -0.3 },
+    snappy: { duration: 200, bounce: 0 },
+    bouncy: { duration: 400, bounce: 0.3 },
+};
+// Rest thresholds for determining when spring has settled
+const restSpeed = 0.01;
+const restDelta = 0.005;
+const maxSettlingTime = 20_000;
+const frameMs = 1000 / 60; // ~16.67ms per frame
+export function spring(presetOrOptions, overrides) {
+    let options = resolveOptions(presetOrOptions, overrides);
+    let { position, settlingTime, easing } = computeSpring(options);
+    let duration = Math.round(settlingTime);
+    function* generator() {
+        let t = 0;
+        while (t < settlingTime) {
+            yield position(t);
+            t += frameMs;
+        }
+        yield 1;
+    }
+    let iter = generator();
+    // Decorate iterator with spring properties (enumerable for spread)
+    Object.defineProperties(iter, {
+        duration: { value: duration, enumerable: true },
+        easing: { value: easing, enumerable: true },
+        toString: {
+            value() {
+                return `${duration}ms ${easing}`;
+            },
+        },
+    });
+    return iter;
+}
+// Transition helper for CSS transition property
+spring.transition = function transition(property, presetOrOptions, overrides) {
+    let s = typeof presetOrOptions === 'string'
+        ? spring(presetOrOptions, overrides)
+        : spring(presetOrOptions);
+    let properties = Array.isArray(property) ? property : [property];
+    return properties.map((p) => `${p} ${s}`).join(', ');
+};
+// Access preset defaults
+spring.presets = presets;
+function resolveOptions(presetOrOptions, overrides) {
+    if (typeof presetOrOptions === 'string') {
+        let preset = presets[presetOrOptions];
+        return {
+            duration: overrides?.duration ?? preset.duration,
+            bounce: preset.bounce,
+            velocity: overrides?.velocity,
+        };
+    }
+    if (presetOrOptions) {
+        return presetOrOptions;
+    }
+    // Default to 'snappy' preset
+    return presets.snappy;
+}
+// Core spring computation
+function computeSpring(options) {
+    let { duration: durationMs = 300, bounce = 0, velocity = 0 } = options;
+    // Convert duration to seconds for physics calculations
+    let durationSec = durationMs / 1000;
+    // Natural frequency: ω₀ = √(stiffness) = 2π / duration
+    let omega0 = (2 * Math.PI) / durationSec;
+    // Clamp bounce to valid range
+    bounce = Math.max(-1, Math.min(0.95, bounce));
+    // Damping ratio (ζ):
+    // bounce >= 0: ζ = 1 - bounce (linear, 0→1 maps to critical→underdamped)
+    // bounce < 0: ζ = 1 / (1 + bounce) (stronger overdamping as bounce→-1)
+    let zeta = bounce >= 0 ? 1 - bounce : 1 / (1 + bounce);
+    // Convert to per-millisecond for time calculations
+    let omega0Ms = omega0 / 1000;
+    let velocityMs = -velocity / 1000; // negated for spring equation convention
+    // Position function based on damping regime
+    let position;
+    if (zeta < 1) {
+        // Underdamped (bouncy) - oscillates around target
+        let omegaD = omega0Ms * Math.sqrt(1 - zeta * zeta);
+        position = (t) => {
+            let envelope = Math.exp(-zeta * omega0Ms * t);
+            return (1 -
+                envelope *
+                    (((velocityMs + zeta * omega0Ms) / omegaD) * Math.sin(omegaD * t) + Math.cos(omegaD * t)));
+        };
+    }
+    else if (zeta > 1) {
+        // Overdamped (smooth) - no oscillation, two decay rates
+        let sqrtTerm = Math.sqrt(zeta * zeta - 1);
+        let s1 = omega0Ms * (-zeta + sqrtTerm); // slower decay
+        let s2 = omega0Ms * (-zeta - sqrtTerm); // faster decay
+        let A = (s2 + velocityMs) / (s2 - s1);
+        let B = 1 - A;
+        position = (t) => 1 - A * Math.exp(s1 * t) - B * Math.exp(s2 * t);
+    }
+    else {
+        // Critically damped - fastest approach without oscillation
+        position = (t) => 1 - Math.exp(-omega0Ms * t) * (1 + (velocityMs + omega0Ms) * t);
+    }
+    // Velocity via numerical differentiation (units per second)
+    let velocitySampleMs = 0.5;
+    function velocityAt(t) {
+        if (t < velocitySampleMs) {
+            return ((position(velocitySampleMs) - position(0)) / velocitySampleMs) * 1000;
+        }
+        return ((position(t) - position(t - velocitySampleMs)) / velocitySampleMs) * 1000;
+    }
+    // Find settling time
+    let settlingTime = maxSettlingTime;
+    let step = 50;
+    for (let t = 0; t < maxSettlingTime; t += step) {
+        let pos = position(t);
+        let vel = Math.abs(velocityAt(t));
+        let displacement = Math.abs(1 - pos);
+        if (vel <= restSpeed && displacement <= restDelta) {
+            settlingTime = t;
+            break;
+        }
+    }
+    // Generate CSS easing
+    let easing = generateEasing(position, settlingTime);
+    return { position, settlingTime, easing };
+}
+// Generate CSS linear() easing with adaptive sampling
+function generateEasing(position, settlingTime) {
+    let points = adaptiveSample(position, settlingTime);
+    return `linear(${points
+        .map((p, i) => {
+        let isLast = i === points.length - 1;
+        let value = isLast ? 1 : Math.round(p.value * 10000) / 10000;
+        if (i === 0 || isLast) {
+            return value === 1 ? '1' : value.toString();
+        }
+        let percent = Math.round((p.t / settlingTime) * 1000) / 10;
+        return `${value} ${percent}%`;
+    })
+        .join(', ')})`;
+}
+// Adaptive sampling - more points where curvature is high, fewer where linear
+function adaptiveSample(resolve, duration, tolerance = 0.002, minSegment = 8) {
+    let points = [];
+    function addPoint(t, value) {
+        if (points.length === 0 || points[points.length - 1].t < t) {
+            points.push({ t, value });
+        }
+    }
+    function subdivide(t0, v0, t1, v1, depth = 0) {
+        if (depth > 12) {
+            addPoint(t0, v0);
+            return;
+        }
+        let tMid = (t0 + t1) / 2;
+        let vMid = resolve(tMid);
+        let vLinear = (v0 + v1) / 2;
+        let error = Math.abs(vMid - vLinear);
+        if (error > tolerance && t1 - t0 > minSegment) {
+            subdivide(t0, v0, tMid, vMid, depth + 1);
+            subdivide(tMid, vMid, t1, v1, depth + 1);
+        }
+        else {
+            addPoint(t0, v0);
+        }
+    }
+    subdivide(0, resolve(0), duration, resolve(duration));
+    addPoint(duration, resolve(duration));
+    return points;
+}
+//# sourceMappingURL=spring.js.map

package/dist/animation/spring.js.map

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

package/dist/animation/tween.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Cubic-bezier control points used by {@link tween}.
+ */
+export interface BezierCurve {
+    /** First control point x coordinate. */
+    x1: number;
+    /** First control point y coordinate. */
+    y1: number;
+    /** Second control point x coordinate. */
+    x2: number;
+    /** Second control point y coordinate. */
+    y2: number;
+}
+/**
+ * Common cubic-bezier presets for {@link tween}.
+ */
+export declare const easings: {
+    readonly linear: {
+        readonly x1: 0;
+        readonly y1: 0;
+        readonly x2: 1;
+        readonly y2: 1;
+    };
+    readonly ease: {
+        readonly x1: 0.25;
+        readonly y1: 0.1;
+        readonly x2: 0.25;
+        readonly y2: 1;
+    };
+    readonly easeIn: {
+        readonly x1: 0.42;
+        readonly y1: 0;
+        readonly x2: 1;
+        readonly y2: 1;
+    };
+    readonly easeOut: {
+        readonly x1: 0;
+        readonly y1: 0;
+        readonly x2: 0.58;
+        readonly y2: 1;
+    };
+    readonly easeInOut: {
+        readonly x1: 0.42;
+        readonly y1: 0;
+        readonly x2: 0.58;
+        readonly y2: 1;
+    };
+};
+/**
+ * Options for generating tweened values over time.
+ */
+export interface TweenOptions {
+    /** Starting value for the tween. */
+    from: number;
+    /** Ending value for the tween. */
+    to: number;
+    /** Total tween duration in milliseconds. */
+    duration: number;
+    /** Cubic-bezier curve used to shape the interpolation. */
+    curve: BezierCurve;
+}
+/**
+ * Generator that tweens a value over time using a cubic bezier curve.
+ * Yields the current value on each frame. Use the iterator's `done` property
+ * to check if the animation is complete.
+ * @param options The tween configuration
+ * @yields The current tweened value
+ * @returns The final value
+ */
+export declare function tween(options: TweenOptions): Generator<number, number, number>;