@rafaelaugusto/jolt 0.1.0-beta.8 → 0.1.0-rc.1

package/dist/gradient-binding.d.ts

@@ -0,0 +1,38 @@
+import { type ColorValue } from './color.js';
+import { valueSource, type DerivedValue, type DerivedColor } from './motion-value.js';
+import type { GradientFrame } from './gradient.js';
+export interface GradientBindings {
+    colors?: readonly (ColorValue | DerivedColor)[];
+    stops?: readonly (number | DerivedValue)[];
+    angle?: number | DerivedValue;
+    center?: {
+        readonly x?: number | DerivedValue;
+        readonly y?: number | DerivedValue;
+    };
+    radius?: number | DerivedValue;
+}
+export type GradientComponent = 'angle' | 'x' | 'y' | 'radius' | `color:${number}` | `stop:${number}`;
+export type GradientSource = ReturnType<typeof valueSource>;
+export type GradientComponentValue = number | GradientSource;
+export type GradientPatch = Map<GradientComponent, GradientComponentValue>;
+export declare function cloneFrame(frame: GradientFrame): GradientFrame;
+export declare function put(frame: GradientFrame, key: GradientComponent, value: number): void;
+export declare function take(frame: GradientFrame, key: GradientComponent): number;
+/** Validate structural/static inputs before touching any existing owner. */
+export declare function gradientPatch(values: GradientBindings, count: number): GradientPatch;
+export interface GradientBase {
+    at(delta: number): GradientFrame;
+    remaining: number;
+    elapsed(): number;
+}
+/** Native windows share a source clock. Only setup/commands/window boundaries enter JS. */
+export declare function gradientProgram(base: GradientBase, bindings: GradientPatch): {
+    current: GradientFrame;
+    frames: GradientFrame[];
+    times: number[];
+    duration: number;
+    remaining: number;
+    elapsed: () => number;
+    at: (delta: number) => GradientFrame;
+};
+//# sourceMappingURL=gradient-binding.d.ts.map

package/dist/gradient-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient-binding.d.ts","sourceRoot":"","sources":["../src/gradient-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAExD,OAAO,EAEL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,SAAS,CAAC,UAAU,GAAG,YAAY,CAAC,EAAE,CAAA;IAC/C,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAA;IAC7B,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;QAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAAA;KAAE,CAAA;IACnF,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAAA;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAC3B,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,QAAQ,GAAG,SAAS,MAAM,EAAE,GAAG,QAAQ,MAAM,EAAE,CAAA;AACvE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAC3D,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,cAAc,CAAA;AAC5D,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CAAA;AAE1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAE9D;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,QAI9E;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,UAIhE;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAyDpF;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,IAAI,MAAM,CAAA;CAClB;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa;;;;;;mBAJ9D,MAAM;gBAqBE,MAAM;EAiC1B"}

package/dist/gradient-binding.js

@@ -0,0 +1,128 @@
+import { parseColor } from './color.js';
+import { reducedMotion } from './config.js';
+import { isDerived, valueSource, } from './motion-value.js';
+export function cloneFrame(frame) {
+    return { ...frame, colors: [...frame.colors], stops: [...frame.stops] };
+}
+export function put(frame, key, value) {
+    if (key.startsWith('color:'))
+        frame.colors[Number(key.slice(6))] = value;
+    else if (key.startsWith('stop:'))
+        frame.stops[Number(key.slice(5))] = value;
+    else
+        frame[key] = value;
+}
+export function take(frame, key) {
+    if (key.startsWith('color:'))
+        return frame.colors[Number(key.slice(6))];
+    if (key.startsWith('stop:'))
+        return frame.stops[Number(key.slice(5))];
+    return frame[key];
+}
+/** Validate structural/static inputs before touching any existing owner. */
+export function gradientPatch(values, count) {
+    if (!values || typeof values !== 'object' || Array.isArray(values))
+        throw new TypeError('Gradient values must be an object.');
+    const patch = new Map();
+    const add = (key, value, color = false) => {
+        if (value === undefined)
+            return;
+        if (isDerived(value))
+            patch.set(key, valueSource(value, color));
+        else if (color)
+            patch.set(key, parseColor(value));
+        else {
+            if (typeof value !== 'number' || !Number.isFinite(value))
+                throw new RangeError(`Invalid gradient ${key}: ${String(value)}.`);
+            if (key === 'radius' && value < 0)
+                throw new RangeError('Gradient radius must not be negative.');
+            if (key.startsWith('stop:') && (value < 0 || value > 1))
+                throw new RangeError('Gradient stops must be from 0 to 1.');
+            patch.set(key, value);
+        }
+    };
+    if (values.colors !== undefined) {
+        if (!Array.isArray(values.colors) ||
+            values.colors.length < 2 ||
+            values.colors.length > 8)
+            throw new RangeError('A gradient needs between two and eight colors.');
+        count = values.colors.length;
+        Array.from(values.colors).forEach((value, i) => {
+            if (value === undefined)
+                throw new TypeError('Gradient colors cannot be empty.');
+            add(`color:${i}`, value, true);
+        });
+    }
+    if (values.stops !== undefined) {
+        if (!Array.isArray(values.stops) || values.stops.length !== count)
+            throw new RangeError('Gradient stops need one value per color.');
+        Array.from(values.stops).forEach((value, i) => {
+            if (value === undefined)
+                throw new TypeError('Gradient stops cannot be empty.');
+            add(`stop:${i}`, value);
+        });
+        if (values.stops.every((value) => typeof value === 'number') &&
+            values.stops.some((value, i) => i > 0 && value < values.stops[i - 1]))
+            throw new RangeError('Gradient stops must be ordered without going back.');
+    }
+    else if (values.colors !== undefined) {
+        // Preserve the concrete API's rule: replacing colors resets unspecified stops.
+        values.colors.forEach((_, i) => patch.set(`stop:${i}`, i / (count - 1)));
+    }
+    add('angle', values.angle);
+    if (values.center !== undefined &&
+        (!values.center || typeof values.center !== 'object'))
+        throw new TypeError('Gradient center needs x/y components.');
+    add('x', values.center?.x);
+    add('y', values.center?.y);
+    add('radius', values.radius);
+    return patch;
+}
+/** Native windows share a source clock. Only setup/commands/window boundaries enter JS. */
+export function gradientProgram(base, bindings) {
+    const roots = new Map();
+    for (const value of bindings.values())
+        if (typeof value !== 'number' && !roots.has(value.identity))
+            roots.set(value.identity, value.snapshot());
+    const moving = [...roots.values()].filter((state) => state.running);
+    const remaining = Math.max(base.remaining, ...moving.map((state) => state.track.end - state.elapsed), 0);
+    const duration = Math.min(4000, remaining);
+    const anchor = moving[0];
+    const elapsed = anchor
+        ? () => Math.max(0, anchor.time() - anchor.elapsed)
+        : base.elapsed;
+    const reduced = reducedMotion();
+    const at = (delta) => {
+        const frame = cloneFrame(base.at(delta));
+        for (const [key, source] of bindings) {
+            if (typeof source === 'number') {
+                put(frame, key, source);
+                continue;
+            }
+            const state = roots.get(source.identity);
+            const geometry = key === 'angle' || key === 'x' || key === 'y' || key === 'radius';
+            const input = reduced && geometry && state.running
+                ? state.track.to
+                : state.running
+                    ? state.track.valueAt(state.elapsed + delta)
+                    : state.value;
+            const value = source.read(input);
+            if (!Number.isFinite(value))
+                throw new RangeError(`Nonfinite gradient binding: ${key}.`);
+            put(frame, key, value);
+        }
+        // Project the complete vector without sorting colors. Spring overshoot may
+        // merge adjacent stops; their identity and order are retained.
+        frame.radius = Math.max(0, frame.radius);
+        frame.stops = frame.stops.map((stop) => Math.min(1, Math.max(0, stop)));
+        for (let i = 1; i < frame.stops.length; i++)
+            frame.stops[i] = Math.max(frame.stops[i - 1], frame.stops[i]);
+        return frame;
+    };
+    const current = at(0);
+    const steps = Math.max(1, Math.ceil((duration * 60) / 1000));
+    const times = Array.from({ length: steps + 1 }, (_, i) => i / steps);
+    const frames = times.map((time) => at(time * duration));
+    return { current, frames, times, duration, remaining, elapsed, at };
+}
+//# sourceMappingURL=gradient-binding.js.map

package/dist/gradient-binding.js.map

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

package/dist/gradient.d.ts

@@ -0,0 +1,105 @@
+import { type View } from '@nativescript/core';
+import { type ColorValue } from './color.js';
+import type { Animation } from './engine.js';
+import { type SpringName, type Transition } from './transition.js';
+import type { Target } from './types.js';
+import { type GradientBindings, type GradientPatch } from './gradient-binding.js';
+export type { GradientBindings } from './gradient-binding.js';
+export type GradientType = 'linear' | 'radial' | 'conic';
+export interface GradientValues {
+    /** Two to eight colors. Animating keeps the count. */
+    colors?: readonly ColorValue[];
+    /** Where each color sits, from 0 to 1. Evenly spaced by default. */
+    stops?: readonly number[];
+    /** Degrees, like CSS: `linear` points this way (180 runs top to bottom), `conic` starts here (0 is up). */
+    angle?: number;
+    /** `radial` and `conic`: the center, in fractions of the view's width and height. */
+    center?: {
+        readonly x: number;
+        readonly y: number;
+    };
+    /** `radial`: the radius, in fractions of the view's shorter side. */
+    radius?: number;
+}
+export interface GradientOptions extends GradientBindings {
+    type: GradientType;
+    colors: NonNullable<GradientBindings['colors']>;
+}
+export interface Gradient {
+    readonly type: GradientType;
+    /** Animates to new values from the ones on screen. Colors and stops keep their count. */
+    animate(values: GradientValues, transition?: Transition | SpringName): Animation;
+    /** Applies values at once, stopping the animation in progress. */
+    set(values: GradientValues): void;
+    /** Holds the current frame and detaches all gradient bindings; sources keep running. */
+    stop(): void;
+    /** Attach mixed static/value components. Cleanup holds their current values; newer owners survive. */
+    bind(values: GradientBindings): () => void;
+    /** Whether this gradient is explicitly suspended (independent of app/view lifecycle). */
+    readonly suspended: boolean;
+    /** Hold and detach source subscriptions until resume; source playback is not paused. */
+    suspend(): void;
+    /** Catch up to current source positions and reattach once. */
+    resume(): void;
+    /** Takes the gradient off the view. */
+    remove(): void;
+}
+/** Everything the platform needs to paint one frame. */
+export interface GradientFrame {
+    colors: number[];
+    stops: number[];
+    angle: number;
+    x: number;
+    y: number;
+    radius: number;
+}
+export interface GradientTiming {
+    duration: number;
+    delay: number;
+    repeat: number;
+    reverse: boolean;
+}
+export interface GradientPainter {
+    paint(frame: GradientFrame): void;
+    /** Plays sampled frames natively; `onEnd(false)` when cancelled. */
+    play(frames: readonly GradientFrame[], times: readonly number[], timing: GradientTiming, onEnd: (finished: boolean) => void): {
+        cancel(): void;
+        control?(elapsed: number, paused: boolean): void;
+    };
+    remove(): void;
+}
+type PainterFactory = (view: View, type: GradientType) => GradientPainter | undefined;
+/** Test seam, like `setDriver`. */
+export declare function setGradientPainter(next: PainterFactory | undefined): void;
+/**
+ * Paints a native gradient behind a layout's children and animates it.
+ *
+ * ```ts
+ * const glow = gradient(halo, { type: 'radial', colors: ['#FF0080', '#7928CA00'], radius: 0.8 })
+ * glow.animate({ center: { x: 0.8, y: 0.2 }, radius: 1.2 }, { duration: 2000 })
+ * ```
+ */
+export declare function gradient(target: Target, options: GradientOptions): Gradient;
+/** Validate declarative replacements before removing their current native layer. */
+export declare function prepareGradient(options: GradientOptions): {
+    frame: GradientFrame;
+    patch: GradientPatch;
+};
+/** One frame between two states. Geometry follows the curve, overshoot included; colors and stops stay between their ends. */
+export declare function mix(from: GradientFrame, to: GradientFrame, progress: number, reduced?: boolean): GradientFrame;
+/**
+ * The points a platform gradient needs, in unit coordinates of a `width` × `height` box.
+ * Linear follows CSS: the line runs through the center at `angle` and is long enough
+ * for the corners to get the first and last colors.
+ */
+export declare function gradientPoints(type: GradientType, frame: GradientFrame, width: number, height: number): {
+    start: {
+        x: number;
+        y: number;
+    };
+    end: {
+        x: number;
+        y: number;
+    };
+};
+//# sourceMappingURL=gradient.d.ts.map

package/dist/gradient.d.ts.map

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