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

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

@@ -0,0 +1,52 @@
+import { type FieldSpring } from '../fieldMotion.js';
+/**
+ * Motion of the TabView bottom accessory between its expanded row (above the tab bar) and its
+ * inline row (beside the minimized tab circle).
+ *
+ * Native reference: stock SwiftUI `.tabViewBottomAccessory` + `.tabBarMinimizeBehavior(.onScrollDown)`
+ * with three Music-style tabs, iPhone 17 Pro Max, iOS 27.0 Simulator, counter-retimed
+ * (RMS 2.6 pt collapse, 1.1 pt
+ * expand). Each edge follows an underdamped spring (damping ratio about 0.72), and the two axes
+ * do not start together: collapsing, the accessory slides toward the circle with the bar and drops
+ * into the bar's row 53 ms later; expanding, it rises first and widens back 52 ms after that.
+ * Delays count from the first frame the tab bar itself changes shape (native's tap first swells
+ * the circle for about 70 ms; Satin's bar track starts at the tap's release, as native's does).
+ */
+export type AccessoryDirection = 'collapse' | 'restore';
+export type AccessoryProfile = Readonly<{
+    spring: FieldSpring;
+    /** When the horizontal edges start, after the tab bar's own motion starts. */
+    horizontalDelayMs: number;
+    /** When the vertical position starts, after the tab bar's own motion starts. */
+    verticalDelayMs: number;
+}>;
+export declare const ACCESSORY_PROFILES: Readonly<Record<AccessoryDirection, AccessoryProfile>>;
+/** The accessory's edges, in points from the bottom chrome's left, right and bottom edges. */
+export type AccessoryBox = Readonly<{
+    left: number;
+    right: number;
+    bottom: number;
+}>;
+export declare const RESTING_ACCESSORY_VELOCITY: AccessoryBox;
+/** One accessory move: where it started, where it goes, and its velocity at the start. */
+export type AccessoryRun = Readonly<{
+    from: AccessoryBox;
+    to: AccessoryBox;
+    velocity: AccessoryBox;
+    profile: AccessoryProfile;
+}>;
+/** The accessory's presented edges and their velocities (points per second) `elapsedMs` into a run. */
+export declare function sampleAccessory(run: AccessoryRun, elapsedMs: number): {
+    value: {
+        left: number;
+        right: number;
+        bottom: number;
+    };
+    velocity: {
+        left: number;
+        right: number;
+        bottom: number;
+    };
+};
+/** The first frame time at which every edge has settled on its target. */
+export declare function accessoryRunDuration(run: AccessoryRun, frameMs?: number): number;

package/dist/glass/lens/tabAccessoryMotion.js

@@ -0,0 +1,52 @@
+import { sampleFieldAxis } from '../fieldMotion.js';
+export const ACCESSORY_PROFILES = {
+    collapse: {
+        spring: { stiffness: 202, damping: 20.5 },
+        horizontalDelayMs: 0,
+        verticalDelayMs: 53,
+    },
+    restore: {
+        spring: { stiffness: 404, damping: 29.3 },
+        horizontalDelayMs: 52,
+        verticalDelayMs: 0,
+    },
+};
+const EDGES = ['left', 'right', 'bottom'];
+export const RESTING_ACCESSORY_VELOCITY = { left: 0, right: 0, bottom: 0 };
+function edgeDelay(profile, edge) {
+    return edge === 'bottom' ? profile.verticalDelayMs : profile.horizontalDelayMs;
+}
+/** The accessory's presented edges and their velocities (points per second) `elapsedMs` into a run. */
+export function sampleAccessory(run, elapsedMs) {
+    const value = { ...run.to };
+    const velocity = { ...RESTING_ACCESSORY_VELOCITY };
+    for (const edge of EDGES) {
+        const delay = edgeDelay(run.profile, edge);
+        if (elapsedMs < delay) {
+            // A reversal keeps the edge's carried velocity through the delay rather than freezing it.
+            const sample = sampleFieldAxis(run.from[edge], run.from[edge], run.velocity[edge], elapsedMs, run.profile.spring);
+            value[edge] = sample.value;
+            velocity[edge] = sample.velocity;
+            continue;
+        }
+        const held = sampleFieldAxis(run.from[edge], run.from[edge], run.velocity[edge], delay, run.profile.spring);
+        const sample = sampleFieldAxis(held.value, run.to[edge], held.velocity, elapsedMs - delay, run.profile.spring);
+        value[edge] = sample.value;
+        velocity[edge] = sample.velocity;
+    }
+    return { value, velocity };
+}
+const SETTLED_DISTANCE = 0.05;
+const SETTLED_SPEED = 1;
+const LONGEST_RUN_MS = 1500;
+/** The first frame time at which every edge has settled on its target. */
+export function accessoryRunDuration(run, frameMs = 1000 / 120) {
+    for (let elapsed = 0; elapsed < LONGEST_RUN_MS; elapsed += frameMs) {
+        const { value, velocity } = sampleAccessory(run, elapsed);
+        const settled = EDGES.every(edge => Math.abs(value[edge] - run.to[edge]) < SETTLED_DISTANCE &&
+            Math.abs(velocity[edge]) < SETTLED_SPEED);
+        if (settled && elapsed >= Math.max(edgeDelay(run.profile, 'left'), run.profile.verticalDelayMs))
+            return elapsed;
+    }
+    return LONGEST_RUN_MS;
+}

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

@@ -0,0 +1,43 @@
+export declare const TAB_CHROMA_BLUE = 0.6895707507090543;
+export declare const TAB_CHROMA_RIM: {
+    readonly 'light-bar': {
+        readonly chroma: readonly [readonly [0, 0, 0, 0], readonly [0, 0, 0, 0], readonly [0, 0, 0, 0], readonly [0, 0, 0, 0], readonly [0, 0, 0, 0]];
+        readonly rim: {
+            readonly aa: 0.25;
+            readonly center: 0;
+            readonly width: 1.333;
+            readonly coefficients: readonly [readonly [0.08472404555849652, 0.1107881017330571], readonly [0.10795247840084216, 0.1125047776767224], readonly [0.1232204167017661, 0.2660105464666218], readonly [0.6242838397588887, 0.31678311678429083], readonly [0.999999952339197, 0.04228901891536957]];
+            readonly saturation: readonly [0, 0];
+        };
+    };
+    readonly 'light-pill': {
+        readonly chroma: readonly [readonly [0, -1.5404344466674047e-15, 2.7755575615628914e-17, 8.673617379884035e-19], readonly [-0.626292710046759, -0.08602932749929124, 0.2850160052775802, 0.053637920807071034], readonly [0, -0.25914963573065813, 0, -0.07029406583922589], readonly [-0.3151507409563598, 0.4208705483509367, -0.09014925046158052, -0.2577994842269317], readonly [-0.05804230137882249, 0.026652464002129013, -0.04631495104948765, 0.02443618349295086]];
+        readonly rim: {
+            readonly aa: 0.25;
+            readonly center: 0.167;
+            readonly width: 0.333;
+            readonly coefficients: readonly [readonly [0.0016640291675239127, 8.789536115937395e-11], readonly [5e-324, 2.350988701644575e-37], readonly [1.1754943508222875e-38, 1.1754943508222875e-37], readonly [3.672114089180547e-66, 0.03830583992545373], readonly [2.6176572337233465e-72, 0.0447384325753965]];
+            readonly saturation: readonly [0, 0];
+        };
+    };
+    readonly 'dark-bar': {
+        readonly chroma: readonly [readonly [0, 0, 0, 0], readonly [0, 0, 0, 0], readonly [0, 0, 0, 0], readonly [0, 0, 0, 0], readonly [0, 0, 0, 0]];
+        readonly rim: {
+            readonly aa: 0.75;
+            readonly center: -0.167;
+            readonly width: 1.333;
+            readonly coefficients: readonly [readonly [0.17717483071045118, 0.04726303563811133], readonly [0.1756070034130894, 0.014329127967483951], readonly [0.07621712130601026, 4.829269167170124e-11], readonly [0.16236911620200897, 9.811711736369374e-23], readonly [2.0212360935504153e-41, 5e-324]];
+            readonly saturation: readonly [0.5364049777096083, 0.3180508778406003];
+        };
+    };
+    readonly 'dark-pill': {
+        readonly chroma: readonly [readonly [0, 6.106226635438361e-16, -6.661338147750939e-16, 1.0842021724855044e-19], readonly [-0.1389750125477093, -0.1276036096936004, -0.010490058327432926, -0.036144897515295496], readonly [0, -0.0011561511230018696, 0, 0.027347292250858753], readonly [-0.05139556604743768, 0.01838739268718449, 0.019526245340822625, 0.11934266608942416], readonly [-0.4658271450532533, 0.2257528936043947, -0.9787792178616646, 0.47347007808519814]];
+        readonly rim: {
+            readonly aa: 0.25;
+            readonly center: 0.167;
+            readonly width: 1;
+            readonly coefficients: readonly [readonly [0.00010597074323124584, 8.667630003394461e-13], readonly [8.290053213359021e-61, 5e-324], readonly [5.982405747534859e-38, 6.786027019519845e-40], readonly [0.002981511469800305, 0.003039915805854761], readonly [1.0374721692238496e-69, 0.014923998185146855]];
+            readonly saturation: readonly [0, 0];
+        };
+    };
+};

package/dist/glass/lens/tabChromaRimModel.js

@@ -0,0 +1,93 @@
+// Generated by measured-reference/write-model.py from native observations.
+// Neutral colours and the saturated-blue calibration retain zero correction.
+export const TAB_CHROMA_BLUE = 0.6895707507090543;
+export const TAB_CHROMA_RIM = {
+    'light-bar': {
+        chroma: [
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+        ],
+        rim: {
+            aa: 0.25,
+            center: 0,
+            width: 1.333,
+            coefficients: [
+                [0.08472404555849652, 0.1107881017330571],
+                [0.10795247840084216, 0.1125047776767224],
+                [0.1232204167017661, 0.2660105464666218],
+                [0.6242838397588887, 0.31678311678429083],
+                [0.999999952339197, 0.04228901891536957],
+            ],
+            saturation: [0.0, 0.0],
+        },
+    },
+    'light-pill': {
+        chroma: [
+            [0.0, -1.5404344466674047e-15, 2.7755575615628914e-17, 8.673617379884035e-19],
+            [-0.626292710046759, -0.08602932749929124, 0.2850160052775802, 0.053637920807071034],
+            [0, -0.25914963573065813, 0, -0.07029406583922589],
+            [-0.3151507409563598, 0.4208705483509367, -0.09014925046158052, -0.2577994842269317],
+            [-0.05804230137882249, 0.026652464002129013, -0.04631495104948765, 0.02443618349295086],
+        ],
+        rim: {
+            aa: 0.25,
+            center: 0.167,
+            width: 0.333,
+            coefficients: [
+                [0.0016640291675239127, 8.789536115937395e-11],
+                [5e-324, 2.350988701644575e-37],
+                [1.1754943508222875e-38, 1.1754943508222875e-37],
+                [3.672114089180547e-66, 0.03830583992545373],
+                [2.6176572337233465e-72, 0.0447384325753965],
+            ],
+            saturation: [0.0, 0.0],
+        },
+    },
+    'dark-bar': {
+        chroma: [
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+        ],
+        rim: {
+            aa: 0.75,
+            center: -0.167,
+            width: 1.333,
+            coefficients: [
+                [0.17717483071045118, 0.04726303563811133],
+                [0.1756070034130894, 0.014329127967483951],
+                [0.07621712130601026, 4.829269167170124e-11],
+                [0.16236911620200897, 9.811711736369374e-23],
+                [2.0212360935504153e-41, 5e-324],
+            ],
+            saturation: [0.5364049777096083, 0.3180508778406003],
+        },
+    },
+    'dark-pill': {
+        chroma: [
+            [0.0, 6.106226635438361e-16, -6.661338147750939e-16, 1.0842021724855044e-19],
+            [-0.1389750125477093, -0.1276036096936004, -0.010490058327432926, -0.036144897515295496],
+            [0, -0.0011561511230018696, 0, 0.027347292250858753],
+            [-0.05139556604743768, 0.01838739268718449, 0.019526245340822625, 0.11934266608942416],
+            [-0.4658271450532533, 0.2257528936043947, -0.9787792178616646, 0.47347007808519814],
+        ],
+        rim: {
+            aa: 0.25,
+            center: 0.167,
+            width: 1,
+            coefficients: [
+                [0.00010597074323124584, 8.667630003394461e-13],
+                [8.290053213359021e-61, 5e-324],
+                [5.982405747534859e-38, 6.786027019519845e-40],
+                [0.002981511469800305, 0.003039915805854761],
+                [1.0374721692238496e-69, 0.014923998185146855],
+            ],
+            saturation: [0.0, 0.0],
+        },
+    },
+};

package/dist/glass/lens/tabCollapseInkSamples.json

@@ -0,0 +1,49 @@
+{
+    "source": "measured-reference/native-white-layers.json: expanded morph presentation transform, 2026-09-16 iOS 26.5",
+    "fadeScale": [
+        [
+            0,
+            1
+        ],
+        [
+            0.2971076965332031,
+            0.9622552912948669
+        ],
+        [
+            0.45289868116378784,
+            0.9298062324425515
+        ],
+        [
+            0.5925851762294769,
+            0.8968612769064799
+        ],
+        [
+            0.710148811340332,
+            0.8666774758491613
+        ],
+        [
+            0.8041912913322449,
+            0.8408628771545194
+        ],
+        [
+            0.876086600124836,
+            0.8199335764277115
+        ],
+        [
+            0.9286675974726677,
+            0.8037333036366773
+        ],
+        [
+            0.9653399474918842,
+            0.7917355965960285
+        ],
+        [
+            0.9895222093909979,
+            0.7832508757270721
+        ],
+        [
+            1,
+            0.7741935483870968
+        ]
+    ]
+}

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

@@ -0,0 +1,15 @@
+export declare class TabCompactGesture {
+    private pointer?;
+    private actions;
+    constructor(actions: {
+        restore(dragging: boolean): void;
+        begin(x: number): void;
+        move(x: number): void;
+        end(cancelled: boolean): void;
+    });
+    get active(): boolean;
+    down(id: number, x: number): boolean;
+    move(id: number, x: number): void;
+    up(id: number, x: number, cancelled?: boolean): boolean;
+    cancel(): void;
+}

package/dist/glass/lens/tabCompactGesture.js

@@ -0,0 +1,50 @@
+/* A captured pointer survives restoration of the semantic tab row. The iOS
+ * 26.5 reference keeps a stationary hold compact; lateral movement restores and
+ * continues selection in the same contact. UP alone restores the selected tab.
+ */
+export class TabCompactGesture {
+    pointer;
+    actions;
+    constructor(actions) {
+        this.actions = actions;
+    }
+    get active() {
+        return Boolean(this.pointer);
+    }
+    down(id, x) {
+        if (this.pointer)
+            return false;
+        this.pointer = { id, startX: x, dragging: false };
+        return true;
+    }
+    move(id, x) {
+        const p = this.pointer;
+        if (!p || p.id !== id)
+            return;
+        // Existing 7n drag slop; the new native threshold bracket is retained in notes.
+        if (!p.dragging && Math.abs(x - p.startX) > 3) {
+            p.dragging = true;
+            this.actions.restore(true);
+            this.actions.begin(p.startX);
+        }
+        if (p.dragging)
+            this.actions.move(x);
+    }
+    up(id, x, cancelled = false) {
+        const p = this.pointer;
+        if (!p || p.id !== id)
+            return false;
+        if (!cancelled)
+            this.move(id, x);
+        this.pointer = undefined;
+        if (p.dragging)
+            this.actions.end(cancelled);
+        else if (!cancelled)
+            this.actions.restore(false);
+        return true;
+    }
+    cancel() {
+        if (this.pointer)
+            this.up(this.pointer.id, this.pointer.startX, true);
+    }
+}

package/dist/glass/lens/tabGeometryAttack.json

@@ -0,0 +1,70 @@
+[
+    [
+        0.0,
+        0.0
+    ],
+    [
+        14.074041857384145,
+        0.0
+    ],
+    [
+        30.74070846196264,
+        0.06162646913945266
+    ],
+    [
+        47.40737518295646,
+        0.1931069186714374
+    ],
+    [
+        64.07404178753495,
+        0.3439014936249118
+    ],
+    [
+        80.74070850852877,
+        0.48848477795861794
+    ],
+    [
+        97.40737511310726,
+        0.6152067622791302
+    ],
+    [
+        114.07404183410108,
+        0.7200620492133144
+    ],
+    [
+        130.74070843867958,
+        0.8031358778698529
+    ],
+    [
+        147.4073751596734,
+        0.8665518953958367
+    ],
+    [
+        164.07404182245955,
+        0.9132871429916771
+    ],
+    [
+        180.7407084852457,
+        0.9464999804322464
+    ],
+    [
+        197.40737520623952,
+        0.9691659865104633
+    ],
+    [
+        214.07404181081802,
+        0.98389956108448
+    ],
+    [
+        230.74070853181183,
+        0.9928865769367881
+    ],
+    [
+        247.40737513639033,
+        0.9978818245103234
+    ],
+    [
+        280.0,
+        1.0
+    ]
+]

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

@@ -0,0 +1,17 @@
+import type { Appearance } from './theme.js';
+/** iOS 27 flat-control ink calibration. Source context is retained alongside the
+ * glass mirror; scrolling needs no new GPU readback and no fixture-name lookup.
+ * The chroma correction is a first-order fit, pending textured ink acceptance.
+ */
+export declare function tabGlyphContextStyle(appearance: Appearance, rgb: readonly number[]): {
+    '--tab-selected-icon': string;
+    '--tab-selected-label': string;
+    '--tab-unselected-icon': string;
+    '--tab-unselected-label': string;
+};
+export declare function tabGlyphStyle(appearance: Appearance, _background: string, _index: number): {
+    '--tab-selected-icon': string;
+    '--tab-selected-label': string;
+    '--tab-unselected-icon': string;
+    '--tab-unselected-label': string;
+};

package/dist/glass/lens/tabGlyphColours.js

@@ -0,0 +1,37 @@
+import fit from './ios27GlyphFit.json';
+const stops = [0, 32 / 255, 216 / 255, 1];
+const indices = [0, 1, 3, 4];
+const blue = [10 / 255, 132 / 255, 1];
+const luma = (rgb) => rgb[0] * 0.2126 + rgb[1] * 0.7152 + rgb[2] * 0.0722;
+const blueLuma = luma(blue);
+const axis = blue.map(v => v - blueLuma);
+const norm = axis.reduce((sum, v) => sum + v * v, 0);
+function neutral(appearance, k, kind) {
+    const i = Math.min(2, Math.max(0, stops.findIndex((v, index) => index > 0 && k <= v) - 1));
+    const t = Math.max(0, Math.min(1, (k - stops[i]) / (stops[i + 1] - stops[i])));
+    return fit[appearance][indices[i]][kind].map((v, c) => v + (fit[appearance][indices[i + 1]][kind][c] - v) * t);
+}
+/** iOS 27 flat-control ink calibration. Source context is retained alongside the
+ * glass mirror; scrolling needs no new GPU readback and no fixture-name lookup.
+ * The chroma correction is a first-order fit, pending textured ink acceptance.
+ */
+export function tabGlyphContextStyle(appearance, rgb) {
+    const k = luma(rgb);
+    const chroma = rgb.reduce((sum, v, i) => sum + (v - k) * axis[i], 0) / norm;
+    const colour = (kind) => {
+        const blueNeutral = neutral(appearance, blueLuma, kind);
+        return `rgb(${neutral(appearance, k, kind)
+            .map((v, i) => Math.max(0, Math.min(255, v + chroma * (fit[appearance][2][kind][i] - blueNeutral[i]))).toFixed(3))
+            .join(' ')})`;
+    };
+    const selected = colour('selected'), unselected = colour('unselected');
+    return {
+        '--tab-selected-icon': selected,
+        '--tab-selected-label': selected,
+        '--tab-unselected-icon': unselected,
+        '--tab-unselected-label': unselected,
+    };
+}
+export function tabGlyphStyle(appearance, _background, _index) {
+    return tabGlyphContextStyle(appearance, appearance === 'light' ? [1, 1, 1] : [0, 0, 0]);
+}