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

package/dist/glass/index.js

@@ -0,0 +1,205 @@
+import { Color, GridLayout, View, isIOS } from '@nativescript/core';
+import { parseColor } from '../color.js';
+/** Runtime capability, including the NativeScript metadata built into the app. */
+export function supportsLiquidGlass() {
+    return (isIOS &&
+        parseInt(UIDevice.currentDevice.systemVersion, 10) >= 26 &&
+        typeof UIGlassEffect !== 'undefined' &&
+        typeof UIGlassContainerEffect !== 'undefined');
+}
+function bounded(value, name, maximum) {
+    const number = typeof value === 'string' && value.trim() ? Number(value) : value;
+    if (typeof number !== 'number' ||
+        !Number.isFinite(number) ||
+        number < 0 ||
+        number > maximum)
+        throw new RangeError(`${name} must be within 0..${maximum}.`);
+    return number;
+}
+/** Shared native child routing. UIKit effect content belongs inside contentView. */
+class GlassLayout extends GridLayout {
+    materialUnloaded = false;
+    get materialView() {
+        return isIOS && !this.materialUnloaded
+            ? this.nativeViewProtected
+            : undefined;
+    }
+    createNativeView() {
+        return isIOS
+            ? UIVisualEffectView.alloc().initWithEffect(null)
+            : super.createNativeView();
+    }
+    initNativeView() {
+        super.initNativeView();
+        this.configureMaterial();
+    }
+    onLoaded() {
+        this.materialUnloaded = false;
+        super.onLoaded();
+        this.configureMaterial();
+    }
+    onUnloaded() {
+        this.materialUnloaded = true;
+        if (isIOS && this.nativeViewProtected)
+            this.nativeViewProtected.effect = null;
+        super.onUnloaded();
+    }
+    disposeNativeView() {
+        this.materialUnloaded = true;
+        if (isIOS && this.nativeViewProtected)
+            this.nativeViewProtected.effect = null;
+        super.disposeNativeView();
+    }
+    _addViewToNativeVisualTree(child, atIndex) {
+        if (!isIOS)
+            return super._addViewToNativeVisualTree(child, atIndex);
+        View.prototype._addViewToNativeVisualTree.call(this, child, atIndex);
+        const parent = this.nativeViewProtected
+            ?.contentView;
+        const native = child.nativeViewProtected;
+        if (!parent || !native)
+            return false;
+        const index = Math.max(0, Math.min(atIndex ?? parent.subviews.count, parent.subviews.count));
+        parent.insertSubviewAtIndex(native, index);
+        const shadow = native
+            .outerShadowContainerLayer;
+        if (shadow && !shadow.superlayer)
+            parent.layer.insertSublayerBelow(shadow, native.layer);
+        return true;
+    }
+    _removeViewFromNativeVisualTree(child) {
+        if (!isIOS) {
+            super._removeViewFromNativeVisualTree(child);
+            return;
+        }
+        View.prototype._removeViewFromNativeVisualTree.call(this, child);
+        const native = child.nativeViewProtected;
+        native?.outerShadowContainerLayer?.removeFromSuperlayer();
+        native?.removeFromSuperview();
+    }
+}
+/** GridLayout whose direct GlassView children share the native iOS 26 glass renderer. */
+export class GlassContainer extends GlassLayout {
+    spacing = 16;
+    /** Distance in DIPs at which nearby native glass elements begin to blend. */
+    get glassSpacing() {
+        return this.spacing;
+    }
+    set glassSpacing(value) {
+        this.spacing = bounded(value, 'glassSpacing', 200);
+        this.configureMaterial();
+    }
+    get glassBackend() {
+        return supportsLiquidGlass() ? 'liquid-glass' : 'none';
+    }
+    configureMaterial() {
+        const view = this.materialView;
+        if (!view)
+            return;
+        if (supportsLiquidGlass()) {
+            const effect = UIGlassContainerEffect.new();
+            effect.spacing = this.spacing;
+            view.effect = effect;
+        }
+        else
+            view.effect = null;
+    }
+}
+/** A regular NativeScript GridLayout with native glass behind its content. */
+export class GlassView extends GlassLayout {
+    materialStyle = 'regular';
+    fallback = 'blur';
+    radius = 'capsule';
+    tint;
+    interactive = false;
+    get glassStyle() {
+        return this.materialStyle;
+    }
+    set glassStyle(value) {
+        if (!['regular', 'clear'].includes(value))
+            throw new TypeError('glassStyle must be regular or clear.');
+        this.materialStyle = value;
+        this.configureMaterial();
+    }
+    get glassFallback() {
+        return this.fallback;
+    }
+    set glassFallback(value) {
+        if (!['blur', 'none'].includes(value))
+            throw new TypeError('glassFallback must be blur or none.');
+        this.fallback = value;
+        this.configureMaterial();
+    }
+    get glassRadius() {
+        return this.radius;
+    }
+    set glassRadius(value) {
+        this.radius = value === 'capsule' ? value : bounded(value, 'glassRadius', 1000);
+        this.configureMaterial();
+    }
+    get glassTint() {
+        return this.tint;
+    }
+    set glassTint(value) {
+        this.tint = value == null ? undefined : parseColor(value);
+        this.configureMaterial();
+    }
+    get glassInteractive() {
+        return this.interactive;
+    }
+    set glassInteractive(value) {
+        if (![true, false, 'true', 'false'].includes(value))
+            throw new TypeError('glassInteractive must be boolean.');
+        this.interactive = value === true || value === 'true';
+        this.configureMaterial();
+    }
+    get glassBackend() {
+        return supportsLiquidGlass()
+            ? 'liquid-glass'
+            : isIOS && this.fallback === 'blur'
+                ? 'blur'
+                : 'none';
+    }
+    configureMaterial() {
+        const view = this.materialView;
+        if (!view)
+            return;
+        if (supportsLiquidGlass()) {
+            const effect = UIGlassEffect.effectWithStyle(this.materialStyle === 'clear' ? 1 /* clear */ : 0 /* regular */);
+            effect.interactive = this.interactive;
+            effect.tintColor = this.tint === undefined ? null : new Color(this.tint).ios;
+            view.effect = effect;
+            view.cornerConfiguration =
+                this.radius === 'capsule'
+                    ? UICornerConfiguration.capsuleConfiguration()
+                    : UICornerConfiguration.configurationWithUniformRadius(UICornerRadius.fixedRadius(this.radius));
+        }
+        else {
+            view.effect =
+                this.fallback === 'blur'
+                    ? UIBlurEffect.effectWithStyle(6 /* system material */)
+                    : null;
+            this.updateFallbackCorners();
+        }
+    }
+    updateFallbackCorners() {
+        if (!isIOS || supportsLiquidGlass() || !this.nativeViewProtected)
+            return;
+        const view = this.nativeViewProtected;
+        view.layer.cornerRadius =
+            this.radius === 'capsule'
+                ? Math.min(view.bounds.size.width, view.bounds.size.height) / 2
+                : this.radius;
+        view.clipsToBounds = true;
+    }
+    _redrawNativeBackground(value) {
+        super._redrawNativeBackground(value);
+        // Core redraws CSS corners after onLayout; restore the material's own shape.
+        this.updateFallbackCorners();
+    }
+    onLayout(left, top, right, bottom) {
+        super.onLayout(left, top, right, bottom);
+        this.updateFallbackCorners();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/glass/index.js.map

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

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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"}