@satinhq/kit 0.0.0-stage → 0.1.0-beta.0

package/dist/glass/lens/tabMinimizeMotion.js

@@ -0,0 +1,107 @@
+import samples from './tabMinimizeSamples.json';
+/** First native change was bracketed by offsets 60 and 70 pt in slow drags.
+ * The midpoint is an estimate; native/PWA trigger residuals remain an explicit gate.
+ * Upward travel restores at the content boundary in the recorded fixture.
+ */
+export const TAB_MINIMIZE_DISTANCE = 65;
+export const TAB_MINIMIZE_DURATION = 850;
+export function measuredMinimizeProgress(direction, milliseconds, column = 1) {
+    const curve = samples[direction];
+    if (milliseconds <= 0)
+        return 0;
+    for (let i = 1; i < curve.length; i++) {
+        const a = curve[i - 1], b = curve[i];
+        if (milliseconds <= b[0])
+            return a[column] + ((b[column] - a[column]) * (milliseconds - a[0])) / (b[0] - a[0]);
+    }
+    return 1;
+}
+export function minimizePlacement(progress, width = 360, height = 62, offsetX = 7) {
+    return {
+        progress,
+        x: offsetX * progress,
+        y: 7 * progress,
+        width: width + (48 - width) * progress,
+        height: height + (48 - height) * progress,
+    };
+}
+/** Event-level state. Bounce does not accumulate into the next downward run. */
+export class TabMinimizeIntent {
+    compact = false;
+    anchor = 0;
+    previous = 0;
+    gesture = false;
+    scrolledDuringGesture = false;
+    restoredDuringGesture = false;
+    collapsedDuringGesture = false;
+    beginGesture(offset = this.previous) {
+        this.gesture = true;
+        this.scrolledDuringGesture = false;
+        this.previous = Math.max(0, offset);
+        this.restoredDuringGesture = false;
+        this.collapsedDuringGesture = false;
+        this.anchor = this.previous;
+    }
+    /** A tap cannot authorize a later restoration. WebKit cancels the pointer when it
+     * takes over a pan, so momentum remains authorized until the scroller's scrollend. */
+    endContact(offset = this.previous) {
+        // WebKit can update the live offset before delivering the matching scroll event.
+        if (offset !== this.previous)
+            this.scrolledDuringGesture = true;
+        if (!this.scrolledDuringGesture)
+            this.endGesture();
+    }
+    endGesture() {
+        this.gesture = false;
+    }
+    observe(raw, maximum, placement = 'bottom') {
+        // The native floating iPad tab bar keeps its labels while content scrolls.
+        if (placement === 'top') {
+            const direction = this.compact ? 'restore' : undefined;
+            this.compact = false;
+            this.rebase(raw);
+            return direction;
+        }
+        const offset = Math.max(0, Math.min(maximum, raw));
+        const delta = offset - this.previous;
+        this.previous = offset;
+        if (this.gesture && delta !== 0)
+            this.scrolledDuringGesture = true;
+        if (raw <= 0 || raw > maximum) {
+            this.anchor = offset;
+            if (this.compact && (raw <= 0 || !this.collapsedDuringGesture)) {
+                this.compact = false;
+                return 'restore';
+            }
+            return;
+        }
+        // Restoration, content reflow and tab activation can all emit trusted scroll events.
+        // Only movement owned by a scroll gesture may collapse the tab bar.
+        if (!this.gesture) {
+            this.anchor = offset;
+            return;
+        }
+        if (delta < 0)
+            this.anchor = offset;
+        if (!this.restoredDuringGesture &&
+            !this.compact &&
+            offset - this.anchor >= TAB_MINIMIZE_DISTANCE) {
+            this.compact = true;
+            this.collapsedDuringGesture = true;
+            return 'collapse';
+        }
+    }
+    restore(offset) {
+        this.restoredDuringGesture = true;
+        this.compact = false;
+        this.anchor = Math.max(0, offset);
+        this.previous = this.anchor;
+    }
+    /** A different scroller now drives the intent (navigation retargeted the content): keep the
+     * compact state, measure further scrolling from this scroller's offset. */
+    rebase(offset) {
+        this.endGesture();
+        this.anchor = Math.max(0, offset);
+        this.previous = this.anchor;
+    }
+}

package/dist/glass/lens/tabMinimizeSamples.json

@@ -0,0 +1,411 @@
+{
+    "collapse": [
+        [
+            0,
+            0,
+            0
+        ],
+        [
+            22.5503,
+            0.1406619,
+            0.2650386
+        ],
+        [
+            39.217,
+            0.281342,
+            0.4227533
+        ],
+        [
+            55.8837,
+            0.4282398,
+            0.5663265
+        ],
+        [
+            72.5503,
+            0.5651178,
+            0.6885404
+        ],
+        [
+            89.217,
+            0.6836134,
+            0.7872402
+        ],
+        [
+            105.8837,
+            0.7806415,
+            0.8633665
+        ],
+        [
+            122.5503,
+            0.8564213,
+            0.9195435
+        ],
+        [
+            139.217,
+            0.913042,
+            0.9591162
+        ],
+        [
+            155.8837,
+            0.9534694,
+            0.9855329
+        ],
+        [
+            172.5503,
+            0.9808969,
+            1.001982
+        ],
+        [
+            189.217,
+            0.9983528,
+            1.0112088
+        ],
+        [
+            205.8837,
+            1.0084908,
+            1.0154511
+        ],
+        [
+            222.5503,
+            1.0135057,
+            1.01645
+        ],
+        [
+            239.217,
+            1.0151263,
+            1.0155011
+        ],
+        [
+            255.8837,
+            1.0146554,
+            1.0135256
+        ],
+        [
+            289.217,
+            1.0130315,
+            1.0111454
+        ],
+        [
+            305.8837,
+            1.0086705,
+            1.0065765
+        ],
+        [
+            322.5503,
+            1.0065948,
+            1.0047232
+        ],
+        [
+            339.217,
+            1.0047979,
+            1.0032264
+        ],
+        [
+            355.8837,
+            1.0033265,
+            1.002072
+        ],
+        [
+            372.5503,
+            1.0021773,
+            1.0012201
+        ],
+        [
+            389.217,
+            1.0013187,
+            1.00062
+        ],
+        [
+            405.8837,
+            1.0007056,
+            1.0002194
+        ],
+        [
+            422.5503,
+            1.0002897,
+            1
+        ],
+        [
+            439.217,
+            1.000025,
+            1
+        ],
+        [
+            455.8837,
+            0.9998712,
+            1
+        ],
+        [
+            472.5503,
+            0.9997952,
+            1
+        ],
+        [
+            489.217,
+            0.9997706,
+            1
+        ],
+        [
+            505.8837,
+            0.9997778,
+            1
+        ],
+        [
+            522.5503,
+            0.9998024,
+            1
+        ],
+        [
+            539.217,
+            0.9998347,
+            1
+        ],
+        [
+            555.8837,
+            0.9998685,
+            1
+        ],
+        [
+            572.5503,
+            0.9999,
+            1
+        ],
+        [
+            589.217,
+            0.9999272,
+            1
+        ],
+        [
+            605.8837,
+            0.9999496,
+            1
+        ],
+        [
+            622.5503,
+            0.999967,
+            1
+        ],
+        [
+            753.2541,
+            1.0000035,
+            1
+        ],
+        [
+            772.5503,
+            1.000003,
+            1
+        ],
+        [
+            789.217,
+            1.0000025,
+            1
+        ],
+        [
+            850,
+            1,
+            1
+        ]
+    ],
+    "restore": [
+        [
+            0,
+            0,
+            0
+        ],
+        [
+            17.119,
+            0.0505076,
+            0.1383347
+        ],
+        [
+            33.0,
+            0.1671551,
+            0.2971077
+        ],
+        [
+            49.6667,
+            0.3108581,
+            0.4528987
+        ],
+        [
+            66.3333,
+            0.4567572,
+            0.5925852
+        ],
+        [
+            83.0,
+            0.5904283,
+            0.7101488
+        ],
+        [
+            99.6667,
+            0.7047501,
+            0.8041913
+        ],
+        [
+            116.3333,
+            0.797437,
+            0.8760866
+        ],
+        [
+            133.0,
+            0.8691811,
+            0.9286676
+        ],
+        [
+            149.6667,
+            0.9223138,
+            0.9653399
+        ],
+        [
+            166.3333,
+            0.959889,
+            0.9895222
+        ],
+        [
+            183.0,
+            0.9850915,
+            1.0043244
+        ],
+        [
+            199.6667,
+            1.0008868,
+            1.0123925
+        ],
+        [
+            377.05,
+            1.0030718,
+            1.0018791
+        ],
+        [
+            399.6667,
+            1.0011781,
+            1.0005256
+        ],
+        [
+            416.3333,
+            1.0006083,
+            1.0001589
+        ],
+        [
+            433.0,
+            1.0002261,
+            1
+        ],
+        [
+            449.6667,
+            0.9999866,
+            1
+        ],
+        [
+            466.3333,
+            0.9998508,
+            1
+        ],
+        [
+            483.0,
+            0.9997869,
+            1
+        ],
+        [
+            499.6667,
+            0.99977,
+            1
+        ],
+        [
+            516.3333,
+            0.9997816,
+            1
+        ],
+        [
+            533.0,
+            0.9998085,
+            1
+        ],
+        [
+            549.6667,
+            0.9998415,
+            1
+        ],
+        [
+            566.3333,
+            0.9998751,
+            1
+        ],
+        [
+            583.0,
+            0.9999058,
+            1
+        ],
+        [
+            599.6667,
+            0.9999321,
+            1
+        ],
+        [
+            616.3333,
+            0.9999534,
+            1
+        ],
+        [
+            633.0,
+            0.9999699,
+            1
+        ],
+        [
+            649.6667,
+            0.9999821,
+            1
+        ],
+        [
+            666.3333,
+            0.9999908,
+            1
+        ],
+        [
+            683.0,
+            0.9999966,
+            1
+        ],
+        [
+            699.6667,
+            1.0000002,
+            1
+        ],
+        [
+            716.3333,
+            1.0000023,
+            1
+        ],
+        [
+            733.0,
+            1.0000032,
+            1
+        ],
+        [
+            749.6667,
+            1.0000035,
+            1
+        ],
+        [
+            766.3333,
+            1.0000033,
+            1
+        ],
+        [
+            783.0,
+            1.0000029,
+            1
+        ],
+        [
+            799.6667,
+            1.0000024,
+            1
+        ],
+        [
+            850,
+            1,
+            1
+        ]
+    ]
+}

package/dist/glass/lens/tabMotion.d.ts

@@ -0,0 +1,91 @@
+import { type TabMotionOptics } from './tabMotionFit.js';
+export declare const TAB_MOTION: Readonly<{
+    stiffness: 411.90968753;
+    damping: 39.42175016;
+    settleSeconds: 0.65;
+    pressSeconds: 0.2;
+    releaseSeconds: 0.3;
+    followSeconds: 0.025;
+}>;
+export declare const TAB_INTERACTIVE_MOTION: Readonly<{
+    settleSeconds: 0.65;
+    pressSeconds: 0.2;
+    releaseSeconds: 0.3;
+    stiffness: 186.57;
+    damping: 25.13;
+    followSeconds: 0.08956192678895082;
+}>;
+export type TabHeldGeometry = Readonly<{
+    widthDelta: number;
+    height: number;
+    edgeShift: number;
+    edgeOverflow?: number;
+    /** Smallest presented pill height. The phone bars keep 44 pt; the iPad top bar rests at 36 pt. */
+    minHeight?: number;
+}>;
+export type TabFrame = {
+    centre: number;
+    width: number;
+    height: number;
+};
+export declare function nearestTab(x: number, centres?: readonly number[]): number;
+export declare class TabMotion {
+    private parameters;
+    private heldGeometry?;
+    constructor(parameters?: Readonly<Record<keyof typeof TAB_MOTION, number>>, heldGeometry?: TabHeldGeometry);
+    private centres;
+    private restWidth;
+    private restHeight;
+    private centerY;
+    private dockWidth;
+    /** Per-tab resting pill widths when items are sized by their labels (the iPad top bar). */
+    private widths?;
+    private configured;
+    private retarget?;
+    configure(centres?: readonly number[], width?: number, height?: number, dockWidth?: number, options?: {
+        selected: number;
+        centerY?: number;
+        parameters?: Readonly<Record<keyof typeof TAB_MOTION, number>>;
+        heldGeometry?: TabHeldGeometry;
+        widths?: readonly number[];
+    }): void;
+    private rest;
+    private widthAt;
+    /** Resting width under a point of the bar, interpolated between neighbouring tabs so a
+     * dragged lens changes width continuously between unequal items. */
+    private widthAtX;
+    nearest(x: number): number;
+    lensMix: number;
+    private lensRelease;
+    selected: number;
+    frame: TabFrame;
+    active: boolean;
+    private heldSettled;
+    get needsFrame(): boolean;
+    private pointer?;
+    private transition?;
+    private release?;
+    private velocity;
+    private lastAt;
+    private lensPress;
+    private shape;
+    private strain;
+    private unshaped;
+    private baseFrame;
+    reset(index: number): void;
+    down(x: number, target: number, now: number): boolean;
+    move(x: number): void;
+    releaseTarget(): number | undefined;
+    up(now: number, cancelled?: boolean, committed?: number): number | undefined;
+    private beginRelease;
+    select(target: number, now: number, releaseOnly?: boolean): void;
+    sample(now: number, reduced: boolean): number | undefined;
+    capsule(): {
+        centerX: number;
+        centerY: number;
+        halfWidth: number;
+        halfHeight: number;
+        radius: number;
+    };
+    optics(): TabMotionOptics;
+}