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

package/dist/glass/lens/menuMorphFit.json

@@ -0,0 +1,564 @@
+{
+    "provenance": {
+        "scene": "ParityReference --menu-morph, stock SwiftUI toolbar Menu, black fixture",
+        "capture": "native menu native recording",
+        "contoursSha256": "548f8629dda83afa8467ced2bb0533db024468359f35f602e54febb6ba918310",
+        "units": "milliseconds and normalized centerX, centerY, width, height",
+        "contourThreshold": 10,
+        "segmentation": "Absolute luminance, largest external connected contour, no morphological closing. Original frame pixels reviewed; abs-difference ghost excluded.",
+        "openFrames": [
+            104,
+            137
+        ],
+        "closeFrames": [
+            285,
+            327
+        ],
+        "closeEndpoint": "Observed resting44pt trigger at (1334,54), full return tail retained through700ms.",
+        "cadence": "Encoded approximately60Hz; no120Hz display claim.",
+        "validation": "Corrected frozen table, all early/return-tail frames included, no source reconstruction or outlier exclusions. Held-out open width RMS0.31-0.43pt / height0.23-0.34pt; close width<=0.24pt / height0.21-0.34pt, width-only phase registration and measured endpoints per recording. Held-out recordings validate these error bounds. Radius, optics, phone and installed renderer qualification remain separate."
+    },
+    "open": [
+        [
+            0.0,
+            -0.0,
+            0.0,
+            0.0,
+            0.0
+        ],
+        [
+            16.666667,
+            0.005698006,
+            0.004385965,
+            -0.006006006,
+            -0.015
+        ],
+        [
+            33.333333,
+            0.034188034,
+            0.039473684,
+            -0.06006006,
+            -0.105
+        ],
+        [
+            50.0,
+            0.188034188,
+            0.276315789,
+            0.012012012,
+            0.015
+        ],
+        [
+            66.666667,
+            0.356125356,
+            0.548245614,
+            0.159159159,
+            0.235
+        ],
+        [
+            83.333333,
+            0.492877493,
+            0.776315789,
+            0.327327327,
+            0.425
+        ],
+        [
+            100.0,
+            0.615384615,
+            0.951754386,
+            0.48048048,
+            0.585
+        ],
+        [
+            116.666667,
+            0.717948718,
+            1.065789474,
+            0.612612613,
+            0.715
+        ],
+        [
+            133.333333,
+            0.803418803,
+            1.131578947,
+            0.720720721,
+            0.81
+        ],
+        [
+            150.0,
+            0.871794872,
+            1.166666667,
+            0.810810811,
+            0.88
+        ],
+        [
+            166.666667,
+            0.928774929,
+            1.166666667,
+            0.888888889,
+            0.94
+        ],
+        [
+            183.333333,
+            0.965811966,
+            1.153508772,
+            0.945945946,
+            0.975
+        ],
+        [
+            200.0,
+            0.991452991,
+            1.131578947,
+            0.984984985,
+            1.0
+        ],
+        [
+            216.666667,
+            1.011396011,
+            1.105263158,
+            1.012012012,
+            1.01
+        ],
+        [
+            233.333333,
+            1.01994302,
+            1.078947368,
+            1.027027027,
+            1.02
+        ],
+        [
+            250.0,
+            1.025641026,
+            1.057017544,
+            1.033033033,
+            1.025
+        ],
+        [
+            266.666667,
+            1.028490028,
+            1.039473684,
+            1.036036036,
+            1.025
+        ],
+        [
+            283.333333,
+            1.025641026,
+            1.030701754,
+            1.033033033,
+            1.025
+        ],
+        [
+            300.0,
+            1.022792023,
+            1.01754386,
+            1.03003003,
+            1.02
+        ],
+        [
+            316.666667,
+            1.01994302,
+            1.00877193,
+            1.027027027,
+            1.02
+        ],
+        [
+            333.333333,
+            1.017094017,
+            1.0,
+            1.024024024,
+            1.02
+        ],
+        [
+            350.0,
+            1.011396011,
+            0.995614035,
+            1.018018018,
+            1.015
+        ],
+        [
+            366.666667,
+            1.011396011,
+            0.995614035,
+            1.012012012,
+            1.015
+        ],
+        [
+            383.333333,
+            1.008547009,
+            0.99122807,
+            1.009009009,
+            1.01
+        ],
+        [
+            400.0,
+            1.005698006,
+            0.995614035,
+            1.006006006,
+            1.005
+        ],
+        [
+            416.666667,
+            1.002849003,
+            0.995614035,
+            1.003003003,
+            1.005
+        ],
+        [
+            433.333333,
+            1.002849003,
+            0.995614035,
+            1.003003003,
+            1.005
+        ],
+        [
+            450.0,
+            1.0,
+            0.995614035,
+            1.0,
+            1.005
+        ],
+        [
+            466.666667,
+            1.0,
+            0.995614035,
+            1.0,
+            1.005
+        ],
+        [
+            483.333333,
+            1.0,
+            0.995614035,
+            1.0,
+            1.005
+        ],
+        [
+            500.0,
+            1.0,
+            0.995614035,
+            1.0,
+            1.005
+        ],
+        [
+            516.666667,
+            1.0,
+            0.995614035,
+            1.0,
+            1.005
+        ],
+        [
+            533.333333,
+            1.0,
+            0.995614035,
+            1.0,
+            1.005
+        ],
+        [
+            550.0,
+            1.0,
+            1.0,
+            1.0,
+            1.0
+        ]
+    ],
+    "close": [
+        [
+            0.0,
+            1.0,
+            1.0,
+            1.0,
+            1.0
+        ],
+        [
+            16.666667,
+            0.997159091,
+            1.01754386,
+            0.997222222,
+            1.0
+        ],
+        [
+            33.333333,
+            0.965909091,
+            1.144736842,
+            0.961111111,
+            0.978070175
+        ],
+        [
+            50.0,
+            0.903409091,
+            1.24122807,
+            0.888888889,
+            0.934210526
+        ],
+        [
+            66.666667,
+            0.826704545,
+            1.25,
+            0.797222222,
+            0.864035088
+        ],
+        [
+            83.333333,
+            0.738636364,
+            1.188596491,
+            0.694444444,
+            0.785087719
+        ],
+        [
+            100.0,
+            0.647727273,
+            1.070175439,
+            0.588888889,
+            0.692982456
+        ],
+        [
+            116.666667,
+            0.559659091,
+            0.929824561,
+            0.480555556,
+            0.596491228
+        ],
+        [
+            133.333333,
+            0.474431818,
+            0.776315789,
+            0.386111111,
+            0.495614035
+        ],
+        [
+            150.0,
+            0.397727273,
+            0.622807018,
+            0.294444444,
+            0.403508772
+        ],
+        [
+            166.666667,
+            0.323863636,
+            0.478070175,
+            0.211111111,
+            0.320175439
+        ],
+        [
+            183.333333,
+            0.261363636,
+            0.342105263,
+            0.144444444,
+            0.254385965
+        ],
+        [
+            200.0,
+            0.201704545,
+            0.23245614,
+            0.086111111,
+            0.188596491
+        ],
+        [
+            216.666667,
+            0.139204545,
+            0.140350877,
+            0.047222222,
+            0.131578947
+        ],
+        [
+            233.333333,
+            0.085227273,
+            0.061403509,
+            0.016666667,
+            0.078947368
+        ],
+        [
+            250.0,
+            0.039772727,
+            0.00877193,
+            -0.005555556,
+            0.035087719
+        ],
+        [
+            266.666667,
+            0.017045455,
+            -0.039473684,
+            -0.016666667,
+            -0.004385965
+        ],
+        [
+            283.333333,
+            0.011363636,
+            -0.057017544,
+            -0.011111111,
+            -0.013157895
+        ],
+        [
+            300.0,
+            0.005681818,
+            -0.048245614,
+            -0.005555556,
+            -0.004385965
+        ],
+        [
+            316.666667,
+            0.002840909,
+            -0.039473684,
+            -0.002777778,
+            -0.004385965
+        ],
+        [
+            333.333333,
+            -0.0,
+            -0.035087719,
+            0.0,
+            0.0
+        ],
+        [
+            350.0,
+            -0.0,
+            -0.030701754,
+            0.0,
+            0.004385965
+        ],
+        [
+            366.666667,
+            -0.002840909,
+            -0.021929825,
+            0.002777778,
+            0.004385965
+        ],
+        [
+            383.333333,
+            -0.002840909,
+            -0.01754386,
+            0.002777778,
+            0.00877193
+        ],
+        [
+            400.0,
+            -0.002840909,
+            -0.013157895,
+            0.002777778,
+            0.004385965
+        ],
+        [
+            416.666667,
+            -0.002840909,
+            -0.00877193,
+            0.002777778,
+            0.00877193
+        ],
+        [
+            433.333333,
+            -0.002840909,
+            -0.00877193,
+            0.002777778,
+            0.00877193
+        ],
+        [
+            450.0,
+            -0.002840909,
+            -0.004385965,
+            0.002777778,
+            0.004385965
+        ],
+        [
+            466.666667,
+            -0.002840909,
+            -0.004385965,
+            0.002777778,
+            0.004385965
+        ],
+        [
+            483.333333,
+            -0.002840909,
+            0.0,
+            0.002777778,
+            0.00877193
+        ],
+        [
+            500.0,
+            -0.002840909,
+            0.0,
+            0.002777778,
+            0.00877193
+        ],
+        [
+            516.666667,
+            -0.002840909,
+            0.0,
+            0.002777778,
+            0.00877193
+        ],
+        [
+            533.333333,
+            -0.002840909,
+            0.0,
+            0.002777778,
+            0.00877193
+        ],
+        [
+            550.0,
+            -0.002840909,
+            0.004385965,
+            0.002777778,
+            0.004385965
+        ],
+        [
+            566.666667,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            583.333333,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            600.0,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            616.666667,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            633.333333,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            650.0,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            666.666667,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            683.333333,
+            -0.0,
+            0.004385965,
+            0.0,
+            0.004385965
+        ],
+        [
+            700.0,
+            -0.0,
+            0.0,
+            0.0,
+            0.0
+        ]
+    ]
+}

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

@@ -0,0 +1,70 @@
+import type { GlassRegion } from '../regions.js';
+export type MenuMorphDirection = 'open' | 'close';
+export type MenuMorphPose = {
+    centerX: number;
+    centerY: number;
+    width: number;
+    height: number;
+    returnX: number;
+    returnY: number;
+    returnWidth: number;
+    returnHeight: number;
+};
+/** iPad: the recorded contour table (menuMorphFit.json, a centered menu). iPhone: one fitted
+ * spring per axis (menuMorphPhoneFit.json, a toolbar menu that drops below its trigger and rises
+ * into place), so the motion is continuous in position and velocity. */
+export type MenuIdiom = 'pad' | 'phone';
+/** `label` is a plain text trigger's drop (a Menu or menu-style Picker in a List row): one
+ * spring per axis measured on an iPad (menuDropFit.json), so it eases into the panel and settles
+ * like native rather than stopping dead. `glyph` is a plain icon's (a Menu labelled with a bare
+ * symbol), a recorded contour table. `context` is a row's
+ * context menu (native Notes); `context-content` is one on content such as a chat bubble or a
+ * tile, which opens on its own native iPad spring and closes like a row's. */
+export type MenuMotionProfile = MenuIdiom | 'label' | 'glyph' | 'context' | 'context-content';
+/** The renderer and its presentation watchdog must use the same measured motion. */
+export declare function menuMotionProfile(emerge: Pick<NonNullable<GlassRegion['emerge']>, 'sourceKind' | 'content' | 'idiom'>): MenuMotionProfile;
+export declare function menuMorphDuration(direction: MenuMorphDirection, idiom?: MenuMotionProfile): number;
+export declare const MENU_MORPH_DURATION: {
+    readonly open: number;
+    readonly close: number;
+};
+export declare function menuMorphEndpoint(direction: MenuMorphDirection): MenuMorphPose;
+export declare const MENU_MORPH_ZERO: MenuMorphPose;
+export declare function sampleMenuMorph(direction: MenuMorphDirection, ms: number, idiom?: MenuMotionProfile, appearance?: 'light' | 'dark'): {
+    pose: {
+        centerX: number;
+        centerY: number;
+        width: number;
+        height: number;
+        returnX: number;
+        returnY: number;
+        returnWidth: number;
+        returnHeight: number;
+    };
+    velocity: {
+        centerX: number;
+        centerY: number;
+        width: number;
+        height: number;
+        returnX: number;
+        returnY: number;
+        returnWidth: number;
+        returnHeight: number;
+    };
+};
+/** A retarget retains the presented position and its derivative. The inherited
+ * velocity decays with a Hermite basis whose value and slope are zero at settle;
+ * the measured curve still supplies the independent native axis responses. */
+export declare function transitionMenuMorph(direction: MenuMorphDirection, ms: number, from: MenuMorphPose, initialVelocity?: MenuMorphPose, idiom?: MenuMotionProfile, appearance?: 'light' | 'dark'): {
+    pose: MenuMorphPose;
+    velocity: {
+        centerX: number;
+        centerY: number;
+        width: number;
+        height: number;
+        returnX: number;
+        returnY: number;
+        returnWidth: number;
+        returnHeight: number;
+    };
+};