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

package/dist/glass/webgpu/lensLightingFit.json

@@ -0,0 +1,222 @@
+{
+    "tab": {
+        "light": {
+            "faceGain": 0.9535753149344098,
+            "faceBias": 0.07428450972865408,
+            "diffuseGain": 6.82138349482023e-12,
+            "crestGain": 1.617457943002003e-14,
+            "crestTopGain": 0.27749786995686015,
+            "crestBottomGain": 0.29657532926751246,
+            "crestCenterPt": 0.8871902989680073,
+            "crestSigmaPt": 0.4003320481309149,
+            "bandScale": 2.000000000000001,
+            "diffusionSigmaPt": 0.0,
+            "shadowOpacity": 0.0,
+            "shadowOffsetPt": 0.0,
+            "shadowSigmaPt": 3.0,
+            "capBandScale": 0.801236917890798,
+            "bottomBandScale": 1.5000000082072864,
+            "straightFringeGain": 6.4529390271208075e-12,
+            "capFringeGain": 0.7999999999999995,
+            "straightFringeWidthPt": 0.5000000000000001,
+            "capFringeWidthPt": 11.790241521255702,
+            "faceSaturation": 1,
+            "faceRadialMix": 1,
+            "depthShade": [
+                0.026601933490694313,
+                0.11427453868374764,
+                -0.14227354002391535,
+                -0.12169719067775288
+            ]
+        },
+        "dark": {
+            "faceGain": 0.8769088561703318,
+            "faceBias": 0.10451779134671482,
+            "diffuseGain": 6.29555926919939e-18,
+            "crestGain": 8.1638921709594835e-22,
+            "crestTopGain": 0.19988128936249752,
+            "crestBottomGain": 0.14484030251989458,
+            "crestCenterPt": 0.9225987263495657,
+            "crestSigmaPt": 0.31144024104418044,
+            "bandScale": 2.000000000000001,
+            "diffusionSigmaPt": 0.0,
+            "shadowOpacity": 0.0,
+            "shadowOffsetPt": 0.0,
+            "shadowSigmaPt": 3.0,
+            "capBandScale": 0.7932357318725383,
+            "bottomBandScale": 1.4441801715833327,
+            "straightFringeGain": 0.11986531053768512,
+            "capFringeGain": 0.5001864094915092,
+            "straightFringeWidthPt": 2.9999202527769886,
+            "capFringeWidthPt": 7.999990998603149,
+            "faceSaturation": 1,
+            "faceRadialMix": 1,
+            "depthShade": [
+                0.04068140747451645,
+                0.14554422943794712,
+                -0.1687211725535042,
+                -0.1715273247987743
+            ]
+        }
+    },
+    "button": {
+        "light": {
+            "faceGain": 0.6562781364338706,
+            "faceBias": 0.3253454120700193,
+            "diffuseGain": 0,
+            "crestGain": 0.05999999998988953,
+            "crestCenterPt": 0.9999999911852108,
+            "crestSigmaPt": 0.7999999998658809,
+            "bandScale": 1.0,
+            "diffusionSigmaPt": 14.0,
+            "shadowOpacity": 0.016870209182626314,
+            "shadowOffsetPt": 4.016283730708484,
+            "shadowSigmaPt": 14.999999999999998,
+            "crestTopGain": 0.05999999998988953,
+            "crestBottomGain": 0.05999999998988953,
+            "faceSaturation": 1.536366412243485,
+            "faceRadialMix": 0,
+            "capBandScale": 1,
+            "bottomBandScale": 1,
+            "straightFringeGain": 1,
+            "capFringeGain": 1,
+            "straightFringeWidthPt": 11.2,
+            "capFringeWidthPt": 11.2,
+            "depthShade": [
+                -0.06195068884047315,
+                -0.04701307999523258,
+                0.21999999999999886,
+                0.0
+            ]
+        },
+        "dark": {
+            "faceGain": 0.4405010842812847,
+            "faceBias": 0.21672959250677928,
+            "diffuseGain": 0,
+            "crestGain": 0.05999999998402269,
+            "crestCenterPt": 0.3824719040981131,
+            "crestSigmaPt": 0.5035083005673687,
+            "bandScale": 1.0,
+            "diffusionSigmaPt": 14.0,
+            "shadowOpacity": 0.026170717477807463,
+            "shadowOffsetPt": 3.9598395520713012,
+            "shadowSigmaPt": 14.999999999999993,
+            "crestTopGain": 0.05999999998402269,
+            "crestBottomGain": 0.05999999998402269,
+            "faceSaturation": 2.0840555218220658,
+            "faceRadialMix": 0,
+            "capBandScale": 1,
+            "bottomBandScale": 1,
+            "straightFringeGain": 1,
+            "capFringeGain": 1,
+            "straightFringeWidthPt": 11.2,
+            "capFringeWidthPt": 11.2,
+            "depthShade": [
+                0.0074782972887765635,
+                0.06990765835330968,
+                -0.044144922802949696,
+                0.0
+            ]
+        }
+    },
+    "control": {
+        "light": {
+            "faceGain": 1.0,
+            "faceBias": 0.018,
+            "diffuseGain": 0,
+            "crestGain": 0,
+            "crestTopGain": 0.3,
+            "crestBottomGain": 0.3,
+            "crestCenterPt": 1.15,
+            "crestSigmaPt": 0.25,
+            "rimLineGain": 0.15,
+            "rimLineWidthPt": 0.7,
+            "bandScale": 1.0,
+            "diffusionSigmaPt": 0.0,
+            "shadowOpacity": 0.12,
+            "shadowOffsetPt": 5,
+            "shadowSigmaPt": 4,
+            "capBandScale": 1.0,
+            "bottomBandScale": 1.0,
+            "straightFringeGain": 0,
+            "capFringeGain": 0,
+            "straightFringeWidthPt": 0.5,
+            "capFringeWidthPt": 0.5,
+            "faceSaturation": 1,
+            "faceRadialMix": 0,
+            "depthShade": [
+                0,
+                0,
+                0,
+                0
+            ],
+            "lensMap": [
+                -4.25,
+                36,
+                0,
+                8
+            ],
+            "fieldGain": [
+                0,
+                1,
+                1,
+                0
+            ],
+            "topShade": [
+                -0.085,
+                9,
+                6,
+                4.5
+            ]
+        },
+        "dark": {
+            "faceGain": 0.84,
+            "faceBias": 0.114,
+            "diffuseGain": 0,
+            "crestGain": 0,
+            "crestTopGain": 0.3,
+            "crestBottomGain": 0.36,
+            "crestCenterPt": 1.15,
+            "crestSigmaPt": 0.25,
+            "rimLineGain": 0.85,
+            "rimLineWidthPt": 0.6,
+            "bandScale": 1.0,
+            "diffusionSigmaPt": 0.0,
+            "shadowOpacity": 0.28,
+            "shadowOffsetPt": 5,
+            "shadowSigmaPt": 4,
+            "capBandScale": 1.0,
+            "bottomBandScale": 1.0,
+            "straightFringeGain": 0,
+            "capFringeGain": 0,
+            "straightFringeWidthPt": 0.5,
+            "capFringeWidthPt": 0.5,
+            "faceSaturation": 1,
+            "faceRadialMix": 0,
+            "depthShade": [
+                0,
+                0.04,
+                0,
+                0
+            ],
+            "lensMap": [
+                -4.25,
+                36,
+                0,
+                8
+            ],
+            "fieldGain": [
+                0,
+                1,
+                1,
+                0
+            ],
+            "topShade": [
+                -0.047,
+                9,
+                4,
+                4.5
+            ]
+        }
+    }
+}

package/dist/glass/webgpu/menuLiftInput.d.ts

@@ -0,0 +1,30 @@
+import { type SurfaceInput } from './pendingSurfaceInput.js';
+/** The worker's menu-lift input path ('surface-input' requests for the … trigger's press lift). */
+export type MenuLiftRequest = SurfaceInput & Readonly<{
+    id: string;
+}>;
+export type MenuLiftSurface = Readonly<{
+    first: Readonly<{
+        halfWidth: number;
+        halfHeight: number;
+    }>;
+}>;
+export type MenuLiftTarget = Readonly<{
+    /** The installed menu-lift surface, or undefined before its source is installed. */
+    surface: () => MenuLiftSurface | undefined;
+    apply: (input: SurfaceInput, surface: MenuLiftSurface) => void;
+    fail: (error: Error) => void;
+}>;
+/** Orders input by time, applies it to the installed surface, and holds a contact that arrives
+ * before the source (see PendingSurfaceInput). The worker calls `sourceInstalled` after every
+ * layer install and `clear` when it is hidden or its layers detach. */
+export declare class MenuLiftInput {
+    private at;
+    private readonly pending;
+    private readonly target;
+    constructor(target: MenuLiftTarget, waitMs?: number);
+    get held(): number;
+    input(request: MenuLiftRequest): void;
+    sourceInstalled(): void;
+    clear(): void;
+}

package/dist/glass/webgpu/menuLiftInput.js

@@ -0,0 +1,39 @@
+import { PendingSurfaceInput } from './pendingSurfaceInput.js';
+/** Orders input by time, applies it to the installed surface, and holds a contact that arrives
+ * before the source (see PendingSurfaceInput). The worker calls `sourceInstalled` after every
+ * layer install and `clear` when it is hidden or its layers detach. */
+export class MenuLiftInput {
+    at = -Infinity;
+    pending;
+    target;
+    constructor(target, waitMs = 3000) {
+        this.target = target;
+        this.pending = new PendingSurfaceInput(waitMs, queued => target.fail(Error(`Menu lift source was not installed within ${waitMs} ms of a held press (${queued.length} input(s))`)));
+    }
+    get held() {
+        return this.pending.size;
+    }
+    input(request) {
+        if (request.id !== 'menu-lift')
+            throw Error('Unknown interactive glass surface ' + request.id);
+        if (request.at < this.at)
+            return;
+        this.at = request.at;
+        const surface = this.target.surface();
+        if (surface)
+            this.target.apply(request, surface);
+        else
+            this.pending.hold(request);
+    }
+    sourceInstalled() {
+        if (!this.pending.size)
+            return;
+        const surface = this.target.surface();
+        if (surface)
+            for (const input of this.pending.release())
+                this.target.apply(input, surface);
+    }
+    clear() {
+        this.pending.clear();
+    }
+}

package/dist/glass/webgpu/menuSurfaceGuard.d.ts

@@ -0,0 +1,17 @@
+/** Where a pending menu surface is: waiting for a preparation, in its capture and raster, or
+ * installed and waiting for the worker's acknowledgement. Diagnostic only. */
+export type MenuSurfaceStage = 'prepare' | 'raster' | 'install-ack';
+/** A menu surface that is not installed never draws, so a menu run must never be dropped silently.
+ * A run while the menu surface is disabled is a glass error at once. Otherwise one watchdog per
+ * pending menu runs from its first held run until its surface is installed and acknowledged by the
+ * worker, with a fixed budget of visible time (time while the document is hidden does not count;
+ * nothing else pauses it). When the budget is spent it is a loud glass error naming the stage. */
+export declare class MenuSurfaceGuard {
+    private readonly deadline;
+    private fail;
+    constructor(budgetMs: number, stage: () => MenuSurfaceStage, fail: (error: Error) => void);
+    disabled(): void;
+    start(): void;
+    cancel(): void;
+    get pending(): boolean;
+}

package/dist/glass/webgpu/menuSurfaceGuard.js

@@ -0,0 +1,26 @@
+import { VisibleDeadline } from '../visibleDeadline.js';
+/** A menu surface that is not installed never draws, so a menu run must never be dropped silently.
+ * A run while the menu surface is disabled is a glass error at once. Otherwise one watchdog per
+ * pending menu runs from its first held run until its surface is installed and acknowledged by the
+ * worker, with a fixed budget of visible time (time while the document is hidden does not count;
+ * nothing else pauses it). When the budget is spent it is a loud glass error naming the stage. */
+export class MenuSurfaceGuard {
+    deadline;
+    fail;
+    constructor(budgetMs, stage, fail) {
+        this.fail = fail;
+        this.deadline = new VisibleDeadline(budgetMs, () => this.fail(Error(`Menu glass surface was not presented within ${budgetMs / 1000} s of visible time (pending: ${stage()})`)));
+    }
+    disabled() {
+        this.fail(Error('Menu glass surface is not enabled: the menu ran with no glass surface'));
+    }
+    start() {
+        this.deadline.start();
+    }
+    cancel() {
+        this.deadline.cancel();
+    }
+    get pending() {
+        return this.deadline.pending;
+    }
+}

package/dist/glass/webgpu/minimize.d.ts

@@ -0,0 +1,184 @@
+import { type RestorePath } from '../lens/tabRestoreMotion.js';
+import type { CapsuleShape, RuntimeOptions, SurfaceRenderSpec } from '../renderSpecs.js';
+/** The same measured curves as the incumbent composite, transferred once to the worker. */
+export declare class WorkerMinimize {
+    private animations;
+    private refreshInkGeometry?;
+    private stopProbe?;
+    private button;
+    private sample;
+    private run?;
+    get active(): boolean;
+    get inkTransformed(): boolean;
+    private gesture;
+    private retargetTrack?;
+    private options;
+    /** The bottom accessory moves between its rows on this transaction's clock. */
+    private accessory;
+    private unregisterCompactBar?;
+    constructor(options: RuntimeOptions, restore: (path: RestorePath) => void, drag: {
+        begin(x: number): void;
+        move(x: number): void;
+        end(cancelled: boolean): void;
+    }, retargetTrack?: (track: {
+        at: number;
+        duration: number;
+        specs: SurfaceRenderSpec[];
+    }) => void);
+    start(direction: 'collapse' | 'restore', spec: SurfaceRenderSpec, path?: RestorePath): {
+        at: number;
+        duration: number;
+        finished: Promise<void>;
+        specs: Readonly<{
+            touchLight?: import("../renderSpecs.js").GlassTouchLight;
+            excludeRegionIds?: readonly string[];
+            restHidden?: boolean;
+            opacity?: number;
+            occluder?: CapsuleShape;
+            prewarmTransparent?: boolean;
+            recipeMix?: number;
+            sheetOpaqueMix?: number;
+            popoverArrow?: import("../regions.js").PopoverArrow;
+            variant?: import("../lens/referenceProfiles.js").ReferenceVariant;
+            treatment?: 'sheet' | 'expandedSheet' | 'alert' | 'confirmation' | 'contextBackdrop' | 'contextPreview' | 'contextMenu';
+            tint?: import("../regions.js").GlassTint;
+            memberHighlight?: Readonly<{
+                member: number;
+                amount: number;
+                light?: import("../renderSpecs.js").GlassTouchLight;
+            }>;
+            backdropExclusions?: readonly string[];
+            backdropMenuOverlay?: boolean;
+            blurSigmaCssPx?: number;
+            frameHeight: number;
+            frameWidth: number;
+            frameX: number;
+            frameY: number;
+            id: import("../renderSpecs.js").SurfaceId;
+            materialMix: number;
+            materialProfile: 'chrome' | 'searchField' | 'menu';
+            menuTintMix?: number;
+            returningTrigger?: import("../renderSpecs.js").ReturningMenuTrigger;
+            radius: number;
+            sampleHeight: number;
+            sampleInsetX: number;
+            sampleInsetY: number;
+            sampleWidth: number;
+            shaderAperture: boolean;
+            shape: import("../renderSpecs.js").SurfaceShape;
+            tabSelection?: import("../renderSpecs.js").TabSelectionShape;
+            ink?: Readonly<{
+                atlas: Readonly<{
+                    width: number;
+                    height: number;
+                }>;
+                layers: readonly import("../lens/menuField.js").MenuInkLayer[];
+            }>;
+        }>[];
+    };
+    /**
+     * Commit the compact or expanded chrome layout. The restore control's visibility keys that
+     * layout in CSS, so this is its only writer after construction; the bottom accessory moves
+     * across the change from its presented position. `motionStart` is when the tab bar's own
+     * motion starts (the accessory's measured delays count from there).
+     */
+    private showCompactLayout;
+    update(options: RuntimeOptions): void;
+    current(spec: SurfaceRenderSpec): Readonly<{
+        touchLight?: import("../renderSpecs.js").GlassTouchLight;
+        excludeRegionIds?: readonly string[];
+        restHidden?: boolean;
+        opacity?: number;
+        occluder?: CapsuleShape;
+        prewarmTransparent?: boolean;
+        recipeMix?: number;
+        sheetOpaqueMix?: number;
+        popoverArrow?: import("../regions.js").PopoverArrow;
+        variant?: import("../lens/referenceProfiles.js").ReferenceVariant;
+        treatment?: 'sheet' | 'expandedSheet' | 'alert' | 'confirmation' | 'contextBackdrop' | 'contextPreview' | 'contextMenu';
+        tint?: import("../regions.js").GlassTint;
+        memberHighlight?: Readonly<{
+            member: number;
+            amount: number;
+            light?: import("../renderSpecs.js").GlassTouchLight;
+        }>;
+        backdropExclusions?: readonly string[];
+        backdropMenuOverlay?: boolean;
+        blurSigmaCssPx?: number;
+        frameHeight: number;
+        frameWidth: number;
+        frameX: number;
+        frameY: number;
+        id: import("../renderSpecs.js").SurfaceId;
+        materialMix: number;
+        materialProfile: 'chrome' | 'searchField' | 'menu';
+        menuTintMix?: number;
+        returningTrigger?: import("../renderSpecs.js").ReturningMenuTrigger;
+        radius: number;
+        sampleHeight: number;
+        sampleInsetX: number;
+        sampleInsetY: number;
+        sampleWidth: number;
+        shaderAperture: boolean;
+        shape: import("../renderSpecs.js").SurfaceShape;
+        tabSelection?: import("../renderSpecs.js").TabSelectionShape;
+        ink?: Readonly<{
+            atlas: Readonly<{
+                width: number;
+                height: number;
+            }>;
+            layers: readonly import("../lens/menuField.js").MenuInkLayer[];
+        }>;
+    }>;
+    /** Each sample with the bottom accessory's capsule at its time (`accessoryOccluder`). */
+    private withOccluder;
+    /**
+     * The bottom accessory's capsule at `time` in the bar's frame points (`dock` is the bar's
+     * frame in the viewport), while it moves. Native draws the accessory over the bar where they
+     * overlap (both directions: the accessory rises through the growing bar, and drops beside the
+     * shrinking one). The accessory's glass is in the page, below the bar's layer, so the bar
+     * leaves this capsule empty instead.
+     */
+    private accessoryOccluder;
+    /**
+     * The Search member's geometry when the bar has a Search-role tab, else undefined. Both
+     * compact members settle at the full dock's edges. A centred intrinsic platter therefore
+     * has a negative inset, matching the leading shortcut's offset from that platter.
+     */
+    private searchMemberGeometry;
+    /**
+     * The Search tab's glyph travels with its member, from its slot in the bar to the centre of
+     * the circle, at full opacity and size (native: the magnifier stays visible throughout and
+     * settles centred in the circle; the label fades with the other labels).
+     */
+    private searchGlyphFrames;
+    private apply;
+    /**
+     * The page is being hidden: end a running transaction at its committed layout, with the bottom
+     * accessory's run, so nothing is mid-motion across a suspension. The renderer settles its copy
+     * of the track at the same end when it hides (`renderer.ts`, 'visible'), so on return the page
+     * and the renderer start from one pose: the compact or expanded layout this transaction
+     * committed. A transaction resumed on the far side of a suspension had no single owner: the
+     * renderer had dropped its track while the page still held its run.
+     */
+    settle(): void;
+    /** Debug readout (resume diagnostics). */
+    readout(): {
+        active: boolean;
+        direction: string | null;
+        compactLayout: boolean;
+        inert: boolean;
+        accessoryRun: boolean;
+        timelineOffset: number;
+        accessory: {
+            run: boolean;
+            motion: boolean;
+            ink: string | null;
+            width: string | null;
+            readyInk: number | null;
+            reach: string | null;
+            animations: number;
+        } | null;
+    };
+    dispose(): void;
+}