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

package/dist/glass/lens/menuContextFit.json

@@ -0,0 +1,88 @@
+{
+    "provenance": {
+        "scene": "reference iOS 27 Simulator Notes, light and dark touch-clocked recordings",
+        "source": "native opening measurements/curve fit and native-samples.json; recognition = touch +750ms",
+        "limits": "Translucent threshold contours are estimates; same-device optical acceptance remains pending.",
+        "content": "openContent: native iPad Pro 11 (2nd gen) iOS 27.0.1 SwiftUI .contextMenu on a chat bubble, warm-light-chat-tall (3 counter-qualified trials, native menu measurements curve fit, width RMS 0.028, height RMS 0.017) on the recognition clock (content settle start = this epoch + 55 ms). Centres follow their size axis (native's first resolved frame is already at 89% width). Dark uses the light fit (dark windows were rejected)."
+    },
+    "open": {
+        "dark": {
+            "width": {
+                "delay": 178.0213,
+                "omega": 23.2612,
+                "zeta": 0.7571,
+                "velocity": 8.5734
+            },
+            "height": {
+                "delay": 159.4281,
+                "omega": 24.4664,
+                "zeta": 0.7673,
+                "velocity": 15.0
+            },
+            "centerY": {
+                "delay": 197.2187,
+                "omega": 24.5702,
+                "zeta": 0.7695,
+                "velocity": 0.3521
+            },
+            "centerX": {
+                "delay": 178.0213,
+                "omega": 23.2612,
+                "zeta": 0.7571,
+                "velocity": 8.5734
+            }
+        },
+        "light": {
+            "width": {
+                "delay": 156.9709,
+                "omega": 25.6198,
+                "zeta": 0.8091,
+                "velocity": -0.8028
+            },
+            "height": {
+                "delay": 135.8007,
+                "omega": 20.2885,
+                "zeta": 0.7847,
+                "velocity": -7.2934
+            },
+            "centerY": {
+                "delay": 174.8335,
+                "omega": 24.4769,
+                "zeta": 0.7926,
+                "velocity": -11.1356
+            },
+            "centerX": {
+                "delay": 156.9709,
+                "omega": 25.6198,
+                "zeta": 0.8091,
+                "velocity": -0.8028
+            }
+        }
+    },
+    "openContent": {
+        "width": {
+            "delay": 55,
+            "omega": 19.5,
+            "zeta": 0.73,
+            "velocity": 0
+        },
+        "height": {
+            "delay": 55,
+            "omega": 29.5,
+            "zeta": 0.87,
+            "velocity": 0
+        },
+        "centerY": {
+            "delay": 55,
+            "omega": 29.5,
+            "zeta": 0.87,
+            "velocity": 0
+        },
+        "centerX": {
+            "delay": 55,
+            "omega": 19.5,
+            "zeta": 0.73,
+            "velocity": 0
+        }
+    }
+}

package/dist/glass/lens/menuContextOpacity.json

@@ -0,0 +1,98 @@
+{
+    "light": [
+        [
+            0,
+            0
+        ],
+        [
+            175.5,
+            0
+        ],
+        [
+            191.5,
+            0.125
+        ],
+        [
+            208.2,
+            0.667
+        ],
+        [
+            223.2,
+            0.75
+        ],
+        [
+            239.8,
+            0.75
+        ],
+        [
+            256.5,
+            0.875
+        ],
+        [
+            276.5,
+            0.875
+        ],
+        [
+            289.8,
+            1.0
+        ],
+        [
+            304.8,
+            1.0
+        ],
+        [
+            323.2,
+            1.0
+        ],
+        [
+            343.2,
+            1.0
+        ],
+        [
+            356.5,
+            1.0
+        ],
+        [
+            374.8,
+            1.0
+        ],
+        [
+            388.2,
+            1.0
+        ],
+        [
+            450,
+            1.0
+        ]
+    ],
+    "dark": [
+        [
+            0,
+            0
+        ],
+        [
+            195,
+            0
+        ],
+        [
+            211,
+            0.18
+        ],
+        [
+            228,
+            0.35
+        ],
+        [
+            244,
+            0.65
+        ],
+        [
+            276,
+            0.9
+        ],
+        [
+            294,
+            1
+        ]
+    ]
+}

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

@@ -0,0 +1,15 @@
+import type { MenuMorphDirection } from './menuMorphMotion.js';
+export declare const CONTEXT_DISMISSAL_MS: number;
+/** Remaining fraction (1 → 0) of an open context presentation `ms` after dismissal began. */
+export declare function contextDismissal(appearance: 'light' | 'dark', ms: number): number;
+/** Preserve every measured opacity knot, including the start of the fade.
+ * Uniform samples alone round off these corners between adjacent keyframes. */
+export declare function contextOpacityFrames(direction: MenuMorphDirection, duration: number, appearance: 'light' | 'dark'): Keyframe[];
+/** Native reference appearance-specific context contour contrast, relative to settled contrast, on the
+ * recognition clock. Early unresolved frames are transparent; the solid preview
+ * remains page content. Context has no glass trigger to restore on dismissal. */
+export declare function menuContextPresentation(direction: MenuMorphDirection, ms: number, settled: boolean, appearance?: 'light' | 'dark'): {
+    opacity: number;
+    rounding: number;
+    radiusProgress: number;
+};

package/dist/glass/lens/menuContextPresentation.js

@@ -0,0 +1,65 @@
+import opacity from './menuContextOpacity.json';
+import { keyed } from './menuField.js';
+/** Native context dismissal, menu-close/r3 counter-valid iPad fit of the dim's remaining
+ * contrast: (1 - phase) ** power after a delay. Shared by the dim, the lift and the menu body. */
+const dismissal = {
+    light: { delay: 24.3, duration: 250.3, power: 2.318 },
+    dark: { delay: 1.9, duration: 236.6, power: 2.128 },
+};
+export const CONTEXT_DISMISSAL_MS = Math.max(dismissal.light.delay + dismissal.light.duration, dismissal.dark.delay + dismissal.dark.duration);
+/** Remaining fraction (1 → 0) of an open context presentation `ms` after dismissal began. */
+export function contextDismissal(appearance, ms) {
+    const fit = dismissal[appearance];
+    const phase = Math.min(1, Math.max(0, (ms - fit.delay) / fit.duration));
+    return (1 - phase) ** fit.power;
+}
+/** Preserve every measured opacity knot, including the start of the fade.
+ * Uniform samples alone round off these corners between adjacent keyframes. */
+export function contextOpacityFrames(direction, duration, appearance) {
+    const fit = dismissal[appearance];
+    const knots = direction === 'open'
+        ? opacity[appearance].map(([time]) => time)
+        : [fit.delay, fit.delay + fit.duration];
+    const count = Math.max(1, Math.ceil(duration / (1000 / 240)));
+    const times = new Set([
+        ...Array.from({ length: count + 1 }, (_, index) => (duration * index) / count),
+        ...knots.filter(time => time >= 0 && time <= duration),
+        // The native contour contrast can change sharply within a 15 ms knot
+        // interval. Resolve that fitted cubic independently of display cadence.
+        ...knots.flatMap((time, index) => index === 0
+            ? []
+            : Array.from({ length: 32 }, (_, sample) => knots[index - 1] + ((time - knots[index - 1]) * sample) / 32).filter(time => time >= 0 && time <= duration)),
+    ]);
+    return [...times]
+        .sort((left, right) => left - right)
+        .map(ms => ({
+        offset: ms / duration,
+        opacity: menuContextPresentation(direction, ms, false, appearance).opacity,
+    }));
+}
+/** Native reference appearance-specific context contour contrast, relative to settled contrast, on the
+ * recognition clock. Early unresolved frames are transparent; the solid preview
+ * remains page content. Context has no glass trigger to restore on dismissal. */
+export function menuContextPresentation(direction, ms, settled, appearance = 'dark') {
+    // The body shrinks and fades with the dim (menu-close/r3): it never lingers as a blank pill.
+    if (direction === 'close')
+        return { opacity: contextDismissal(appearance, ms), rounding: 0, radiusProgress: 1 };
+    if (settled)
+        return { opacity: 1, rounding: 0, radiusProgress: 1 };
+    return {
+        opacity: keyed(opacity[appearance].map(([time, value]) => [time, value]), ms),
+        radiusProgress: keyed([
+            [0, 0],
+            [173, 0],
+            [202, 0.59],
+            [221, 0.71],
+            [236, 0.82],
+            [254, 0.82],
+            [266, 0.88],
+            [282, 1],
+            [316, 1.03],
+            [450, 1],
+        ], ms),
+        rounding: 0,
+    };
+}

package/dist/glass/lens/menuCornerFit.json

@@ -0,0 +1,252 @@
+{
+    "provenance": {
+        "capture": "native menu native recording",
+        "contoursSha256": "ff574086c8471596adc0981c900811463d9e937f4f462ab90b31034f38d13317",
+        "units": "milliseconds, extra corner radius divided by current minimum half extent",
+        "method": "Frozen fixed-exponent isotropic fits to every source contour. Add measured rounding to the endpoint radius interpolation; preserve exact declared endpoints. This improves the intermediate aperture but does not reproduce native asymmetric contours. Phone and arbitrary trigger transfer remain unqualified."
+    },
+    "open": [
+        [
+            0.0,
+            0
+        ],
+        [
+            16.666667,
+            -0.20439189189285717
+        ],
+        [
+            33.333333,
+            -0.27573317999999997
+        ],
+        [
+            50.0,
+            0.03206596427118639
+        ],
+        [
+            66.666667,
+            0.2786119452962963
+        ],
+        [
+            83.333333,
+            0.40054054057
+        ],
+        [
+            100.0,
+            0.4713420317241379
+        ],
+        [
+            116.666667,
+            0.5153991200232557
+        ],
+        [
+            133.333333,
+            0.5416138159638989
+        ],
+        [
+            150.0,
+            0.5580941766391753
+        ],
+        [
+            166.666667,
+            0.5709570957029703
+        ],
+        [
+            183.333333,
+            0.5773321708774194
+        ],
+        [
+            200.0,
+            0.5818103818095238
+        ],
+        [
+            216.666667,
+            0.5008952169842271
+        ],
+        [
+            233.333333,
+            0.4122680674420063
+        ],
+        [
+            250.0,
+            0.31689189189375
+        ],
+        [
+            266.666667,
+            0.23234797297499998
+        ],
+        [
+            283.333333,
+            0.17001689189375
+        ],
+        [
+            300.0,
+            0.10175379141065832
+        ],
+        [
+            316.666667,
+            0.07371007371159878
+        ],
+        [
+            333.333333,
+            0.05193594848902826
+        ],
+        [
+            350.0,
+            0.02099269080503144
+        ],
+        [
+            366.666667,
+            0.002464728880503169
+        ],
+        [
+            383.333333,
+            -0.0036661266940062687
+        ],
+        [
+            400.0,
+            -0.0161648990759494
+        ],
+        [
+            416.666667,
+            -0.012829284981012675
+        ],
+        [
+            433.333333,
+            -0.0033356140949367253
+        ],
+        [
+            450.0,
+            -0.006329113924050633
+        ],
+        [
+            466.666667,
+            0.0031645569620253164
+        ],
+        [
+            483.333333,
+            0.006329113924050633
+        ],
+        [
+            500.0,
+            0.00949367088607595
+        ],
+        [
+            516.666667,
+            0.00949367088607595
+        ],
+        [
+            533.333333,
+            0.00949367088607595
+        ],
+        [
+            550.0,
+            0
+        ]
+    ],
+    "close": [
+        [
+            0.0,
+            0
+        ],
+        [
+            16.666667,
+            0.00991181660952376
+        ],
+        [
+            33.333333,
+            0.17971326166451607
+        ],
+        [
+            50.0,
+            0.35629629628
+        ],
+        [
+            66.666667,
+            0.4398669796901408
+        ],
+        [
+            83.333333,
+            0.4941520468571429
+        ],
+        [
+            100.0,
+            0.5105668934040817
+        ],
+        [
+            116.666667,
+            0.4881415046457399
+        ],
+        [
+            133.333333,
+            0.46005555558000005
+        ],
+        [
+            150.0,
+            0.39689633778770955
+        ],
+        [
+            166.666667,
+            0.33569444447499996
+        ],
+        [
+            183.333333,
+            0.2996003198848921
+        ],
+        [
+            200.0,
+            0.22212806030508472
+        ],
+        [
+            216.666667,
+            0.13386752146153855
+        ],
+        [
+            233.333333,
+            0.04587813604301073
+        ],
+        [
+            250.0,
+            -0.032418300423529445
+        ],
+        [
+            266.666667,
+            -0.07736625496296294
+        ],
+        [
+            283.333333,
+            -0.06639892910843384
+        ],
+        [
+            300.0,
+            -0.032418300423529445
+        ],
+        [
+            316.666667,
+            -0.03346253218604653
+        ],
+        [
+            333.333333,
+            -0.022988505747126436
+        ],
+        [
+            350.0,
+            0
+        ],
+        [
+            366.666667,
+            0
+        ],
+        [
+            383.333333,
+            0
+        ],
+        [
+            400.0,
+            0
+        ],
+        [
+            700,
+            0
+        ]
+    ]
+}

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

@@ -0,0 +1,9 @@
+/** Native keeps a round aperture through the middle of the morph. Its extra
+ * rounding is measured independently of the width and height response. */
+export declare const sampleMenuCorner: (direction: import("./menuMorphMotion.js").MenuMorphDirection, ms: number, from?: Record<"rounding", number>, velocity?: Record<"rounding", number>) => {
+    pose: Record<"rounding", number>;
+    velocity: Record<"rounding", number>;
+};
+export type MenuCornerPose = {
+    rounding: number;
+};

package/dist/glass/lens/menuCornerMotion.js

@@ -0,0 +1,5 @@
+import fit from './menuCornerFit.json';
+import { recordedMotion } from './recordedMotion.js';
+/** Native keeps a round aperture through the middle of the morph. Its extra
+ * rounding is measured independently of the width and height response. */
+export const sampleMenuCorner = recordedMotion(['rounding'], fit);

package/dist/glass/lens/menuDropFit.json

@@ -0,0 +1,64 @@
+{
+    "provenance": {
+        "scene": "Stock SwiftUI Menu(\"Menu selection\") in a List Section (native reference app), iPadOS 27.0, light",
+        "device": "iPad Pro 12.9 (6th gen), real HID taps via WDA",
+        "capture": "Native ReplayKit recording in a native reference app with a 60 Hz refresh counter (3.31% skipped refreshes, max skip 1: fit-valid, not playback-valid)",
+        "method": "Platter box per refresh (blurred frame difference against the closed frame, the label's text masked), timed by the counter. Open: two cycles, normalised from a point at the drop's first centre (Satin's plain drop grows from a point) to the settled panel; frames with at least 60% of the settled mask area, the 230-450 ms settle weighted 3x. Close: platter edges read per refresh from 60 Hz tiles (+-8 px), normalised from the panel to the drop that pours back into the label.",
+        "result": "Open width reaches the panel at about 260 ms, overshoots about 0.9% near 290 ms and settles by about 420 ms (the previous contour, picker-glass-sheet at VFR, reached it at 200 ms with no settle). Close starts at once and eases out: 0.73 at 33 ms, 0.32 at 100 ms, 0.03 at 167 ms (the previous contour eased in).",
+        "centerY": "The drop's vertical travel was 6 pt, below what a normalised fit resolves; centerY uses the width spring (one UIKit spring times the whole frame).",
+        "model": "menuSpring.ts: displacement 1 -> 0, released after `delay` ms with `velocity` per second (negative moves toward the target), natural frequency `omega` (rad/s), damping ratio `zeta`.",
+        "units": "ms; centerX, centerY, width, height normalised between the drop's seed (0) and the panel (1)"
+    },
+    "open": {
+        "centerX": {
+            "delay": 0,
+            "omega": 15.879,
+            "zeta": 0.748,
+            "velocity": -10.787
+        },
+        "centerY": {
+            "delay": 0,
+            "omega": 12.274,
+            "zeta": 0.963,
+            "velocity": -14.528
+        },
+        "width": {
+            "delay": 0,
+            "omega": 12.274,
+            "zeta": 0.963,
+            "velocity": -14.528
+        },
+        "height": {
+            "delay": 0,
+            "omega": 19.114,
+            "zeta": 1.017,
+            "velocity": -19.114
+        }
+    },
+    "close": {
+        "centerX": {
+            "delay": 0,
+            "omega": 21.62,
+            "zeta": 0.8,
+            "velocity": 0
+        },
+        "centerY": {
+            "delay": 0,
+            "omega": 21.62,
+            "zeta": 0.8,
+            "velocity": 0
+        },
+        "width": {
+            "delay": 0,
+            "omega": 21.62,
+            "zeta": 0.8,
+            "velocity": 0
+        },
+        "height": {
+            "delay": 0,
+            "omega": 21.62,
+            "zeta": 0.8,
+            "velocity": 0
+        }
+    }
+}