@satinhq/kit 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/glass/GlassMaterialRoot.d.ts

@@ -1,7 +1,9 @@
 import { type PropsWithChildren } from 'react';
 export type GlassDisplacementPolicy = 'auto' | 'disabled';
 /** The app paint layer remains untouched. Liquid regions own their retained image. */
-export declare function GlassMaterialRoot({ children, displacement, onLaunchReady, }: PropsWithChildren<{
+export declare function GlassMaterialRoot({ children, displacement, prepared, onLaunchReady, }: PropsWithChildren<{
     displacement: GlassDisplacementPolicy;
+    /** Lazy renderer modules wait for the verified offline bundle on first install. */
+    prepared?: boolean;
     onLaunchReady?: (ready: boolean) => void;
 }>): import("react").JSX.Element;

package/dist/glass/GlassMaterialRoot.js

@@ -12,7 +12,7 @@ function readAccessibilityPreferences() {
     };
 }
 /** The app paint layer remains untouched. Liquid regions own their retained image. */
-export function GlassMaterialRoot({ children, displacement, onLaunchReady, }) {
+export function GlassMaterialRoot({ children, displacement, prepared = true, onLaunchReady, }) {
     const scene = useRef(null);
     const [chromeLayer, setChromeLayer] = useState(null);
     const renderTest = 'passed';
@@ -35,5 +35,5 @@ export function GlassMaterialRoot({ children, displacement, onLaunchReady, }) {
     const registerRegion = useCallback((_registration) => () => { }, []);
     const diagnostics = useMemo(() => ({ accessibility, capability, renderTest, lensBoost: 1, mapRegenerationCount: 0 }), [accessibility, capability.reason, capability.state, renderTest]);
     const context = useMemo(() => ({ chromeLayer, diagnostics, registerRegion }), [chromeLayer, diagnostics, registerRegion]);
-    return (_jsxs(GlassMaterialContext, { value: context, children: [_jsx("div", { ref: scene, "data-satin-glass-capability": capability.state, "data-satin-scene-paint-layer": "true", "data-satin-diagnostic-glass-off": import.meta.env.SATIN_DIAGNOSTIC_GLASS_OFF || undefined, children: _jsx(MaterialEffectRoot, { scene: scene, chrome: chromeLayer, enabled: capability.state === 'displacement', capabilitySettled: true, onLaunchReady: onLaunchReady, children: children }) }), _jsx("div", { ref: setChromeLayer, "data-satin-glass-capability": capability.state, "data-satin-glass-chrome-layer": "true", "data-satin-glass-contrast": accessibility.increasedContrast ? 'more' : 'standard', "data-satin-glass-motion": accessibility.reducedMotion ? 'reduced' : 'full', "data-satin-glass-transparency": accessibility.reducedTransparency ? 'reduced' : 'full' })] }));
+    return (_jsxs(GlassMaterialContext, { value: context, children: [_jsx("div", { ref: scene, "data-satin-glass-capability": capability.state, "data-satin-scene-paint-layer": "true", "data-satin-diagnostic-glass-off": import.meta.env.SATIN_DIAGNOSTIC_GLASS_OFF || undefined, children: _jsx(MaterialEffectRoot, { scene: scene, chrome: chromeLayer, enabled: prepared && capability.state === 'displacement', capabilitySettled: prepared, onLaunchReady: onLaunchReady, children: children }) }), _jsx("div", { ref: setChromeLayer, "data-satin-glass-capability": capability.state, "data-satin-glass-chrome-layer": "true", "data-satin-glass-contrast": accessibility.increasedContrast ? 'more' : 'standard', "data-satin-glass-motion": accessibility.reducedMotion ? 'reduced' : 'full', "data-satin-glass-transparency": accessibility.reducedTransparency ? 'reduced' : 'full' })] }));
 }

package/dist/glass/MaterialEffectRoot.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { fallbackGlassRequested } from './fallback/selection.js';
-import { glassFallbackRequired, reportGlassError, subscribeGlassFallback } from './errors.js';
+import { glassFallbackRequired, reportGlassError, subscribeGlassFallback, watchGlassTransportRecovery, } from './errors.js';
 import { GlassRegionRegistry } from './regionRegistry.js';
 import { observeTabSources } from '../tabs/sourceRevision.js';
 import { useCallback, useEffect, useMemo, useState, useSyncExternalStore, } from 'react';
@@ -11,6 +11,10 @@ import { isSupportedTabCount } from './tabBarModel.js';
 /** One renderer per app. Registration is semantic; backdrop discovery is framework-owned. */
 export function MaterialEffectRoot({ children, scene, chrome, enabled, capabilitySettled, onLaunchReady, }) {
     const automaticFallback = useSyncExternalStore(subscribeGlassFallback, glassFallbackRequired, () => false);
+    useEffect(() => {
+        if (automaticFallback)
+            return watchGlassTransportRecovery();
+    }, [automaticFallback]);
     const [requestedFallback] = useState(fallbackGlassRequested);
     const backend = requestedFallback || automaticFallback ? 'fallback' : 'webgpu';
     const [regions] = useState(() => new GlassRegionRegistry());

package/dist/glass/errors.d.ts

@@ -12,7 +12,7 @@ export type GlassError = Readonly<{
     recovering?: true;
 }>;
 export declare function subscribeGlassFallback(listener: () => void): () => void;
-/** Successful resource reconstruction can retire only an adapter-outage fallback. */
+/** Retire a device outage only after resource reconstruction and presentation settle. */
 export declare function setGlassAdapterRecovery(pending: boolean): void;
 export declare function glassFallbackRequired(): boolean;
 export declare function reportGlassError(code: GlassErrorCode, cause: unknown, stage: string, reason?: string, recovery?: {
@@ -20,3 +20,5 @@ export declare function reportGlassError(code: GlassErrorCode, cause: unknown, s
 }): GlassError;
 export declare function subscribeGlassErrors(listener: (error: GlassError) => void): () => void;
 export declare function getGlassErrors(): readonly GlassError[];
+/** Retry a failed transport on a visible page; device reconstruction keeps its own owner. */
+export declare function watchGlassTransportRecovery(): () => void;

package/dist/glass/errors.js

@@ -1,10 +1,13 @@
 import { automaticGlassFallbackAllowed, strictGlassRequested } from './failurePolicy.js';
 import { recordGraphicsEvent } from '../graphicsProbe.js';
 const history = [];
-// Independent of diagnostic history. Only a reconstructed adapter outage can clear fallback.
+// Diagnostic history survives recovery; it is not the fallback state.
 let fallbackRequired = false;
 let permanentFallback = false;
 let adapterRecoveryPending = false;
+let transportRecoveryPending = false;
+let nextTransportRetry = 0;
+let transportFailures = 0;
 const fallbackListeners = new Set();
 export function subscribeGlassFallback(listener) {
     fallbackListeners.add(listener);
@@ -12,7 +15,7 @@ export function subscribeGlassFallback(listener) {
         fallbackListeners.delete(listener);
     };
 }
-/** Successful resource reconstruction can retire only an adapter-outage fallback. */
+/** Retire a device outage only after resource reconstruction and presentation settle. */
 export function setGlassAdapterRecovery(pending) {
     adapterRecoveryPending = pending;
     if (!pending && fallbackRequired && !permanentFallback) {
@@ -50,7 +53,17 @@ export function reportGlassError(code, cause, stage, reason, recovery) {
         history.shift();
     const release = automaticGlassFallbackAllowed();
     if (release && !error.recovering) {
-        if (!adapterRecoveryPending || (code !== 'adapter-unavailable' && code !== 'readiness-timeout'))
+        const transportFailure = code === 'worker-startup' ||
+            (!adapterRecoveryPending &&
+                ['adapter-unavailable', 'device-request', 'readiness-timeout'].includes(code)) ||
+            (code === 'presentation' &&
+                /import.*module|module.*script|loading.*chunk|load failed/i.test(message));
+        if (transportFailure) {
+            transportRecoveryPending = true;
+            nextTransportRetry = Date.now() + Math.min(3000 * 2 ** transportFailures++, 30_000);
+        }
+        else if (!adapterRecoveryPending ||
+            ['gpu-unavailable', 'unsupported-configuration', 'shader-compilation', 'validation'].includes(code))
             permanentFallback = true;
         fallbackRequired = true;
         for (const listener of fallbackListeners)
@@ -76,3 +89,36 @@ export function subscribeGlassErrors(listener) {
 export function getGlassErrors() {
     return history.slice();
 }
+/** Retry a failed transport on a visible page; device reconstruction keeps its own owner. */
+export function watchGlassTransportRecovery() {
+    let timer;
+    const retry = () => {
+        clearTimeout(timer);
+        if (!fallbackRequired ||
+            permanentFallback ||
+            !transportRecoveryPending ||
+            adapterRecoveryPending)
+            return;
+        if (document.visibilityState !== 'visible')
+            return;
+        const delay = nextTransportRetry - Date.now();
+        if (delay > 0) {
+            timer = setTimeout(retry, delay);
+            return;
+        }
+        transportRecoveryPending = false;
+        fallbackRequired = false;
+        for (const listener of fallbackListeners)
+            listener();
+    };
+    document.addEventListener('visibilitychange', retry);
+    window.addEventListener('pageshow', retry);
+    window.addEventListener('focus', retry);
+    retry();
+    return () => {
+        clearTimeout(timer);
+        document.removeEventListener('visibilitychange', retry);
+        window.removeEventListener('pageshow', retry);
+        window.removeEventListener('focus', retry);
+    };
+}

package/dist/glass/fallback/canvasOwnership.d.ts

@@ -0,0 +1,7 @@
+/** Parking WebGPU retains its last pixels. CSS ownership must hide those pixels,
+ * including lift/selection canvases, without destroying the renderer's reusable canvas. */
+export declare class FallbackCanvasOwnership {
+    private visibility;
+    update(canvases: Iterable<HTMLCanvasElement>): void;
+    dispose(): void;
+}

package/dist/glass/fallback/canvasOwnership.js

@@ -0,0 +1,23 @@
+/** Parking WebGPU retains its last pixels. CSS ownership must hide those pixels,
+ * including lift/selection canvases, without destroying the renderer's reusable canvas. */
+export class FallbackCanvasOwnership {
+    visibility = new Map();
+    update(canvases) {
+        const live = new Set(canvases);
+        for (const [canvas, visibility] of this.visibility) {
+            if (live.has(canvas))
+                continue;
+            canvas.style.visibility = visibility;
+            this.visibility.delete(canvas);
+        }
+        for (const canvas of live) {
+            if (this.visibility.has(canvas))
+                continue;
+            this.visibility.set(canvas, canvas.style.visibility);
+            canvas.style.visibility = 'hidden';
+        }
+    }
+    dispose() {
+        this.update([]);
+    }
+}

package/dist/glass/fallback/material.js

@@ -1,4 +1,4 @@
-import { animateElement } from '../../motion/animate.js';
+import { animateElement, timelineStart } from '../../motion/animate.js';
 /** CSS owns backdrop sampling, including video that cannot be read into a GPU texture. */
 export class FallbackMaterial {
     element = document.createElement('div');
@@ -61,6 +61,7 @@ export class FallbackMaterial {
         this.paint(specs[specs.length - 1], appearance);
         const count = Math.max(...specs.map(spec => this.shapes(spec).length));
         this.ensure(count, appearance, specs[specs.length - 1]);
+        const start = timelineStart(at);
         this.parts.forEach((part, index) => {
             const frames = specs.map((spec, sample) => {
                 const shape = this.shapes(spec)[index];
@@ -70,7 +71,7 @@ export class FallbackMaterial {
                 };
             });
             const animation = animateElement(part, frames, { duration, easing: 'linear', fill: 'both' });
-            animation.startTime = at;
+            animation.startTime = start;
             this.animations.push(animation);
         });
         return Promise.all(this.animations.map(animation => animation.finished)).then(() => { }, () => { });

package/dist/glass/fallback/regions.d.ts

@@ -1,6 +1,7 @@
 import type { GlassRegionRegistry } from '../regionRegistry.js';
 /** Registered DOM owners already follow scroll, sheets and navigation on the compositor. */
 export declare class FallbackRegions {
+    private canvases;
     private entries;
     private unsubscribe;
     private frame;

package/dist/glass/fallback/regions.js

@@ -4,11 +4,13 @@ import { sampleMenuCorner } from '../lens/menuCornerMotion.js';
 import { confirmHeldSources, heldPresentations } from '../presentationFrame.js';
 import { animateElement, timelineStart } from '../../motion/animate.js';
 import { FallbackMaterial } from './material.js';
+import { FallbackCanvasOwnership } from './canvasOwnership.js';
 import { GLASS_SHAPE_TRACK_EVENT, glassShapeTrack } from '../shapeTrackRegistry.js';
 import { trackedShapeSpec } from '../shapeTrack.js';
 import { glassRadius } from '../regions.js';
 /** Registered DOM owners already follow scroll, sheets and navigation on the compositor. */
 export class FallbackRegions {
+    canvases = new FallbackCanvasOwnership();
     entries = new Map();
     unsubscribe = [];
     frame = 0;
@@ -43,12 +45,15 @@ export class FallbackRegions {
     }
     refresh() {
         const registrations = this.registry?.values() ?? [];
+        this.canvases.update([
+            ...registrations.flatMap(entry => [entry.canvas, ...(entry.overlay ? [entry.overlay] : [])]),
+            ...[...(this.registry?.containers.values() ?? [])].map(entry => entry.canvas),
+        ]);
         const live = new Set(registrations.map(entry => entry.id));
         for (const [id, entry] of this.entries) {
             if (!live.has(id)) {
                 entry.ink?.cancel();
                 entry.material.dispose();
-                entry.restoreCanvas();
                 this.entries.delete(id);
             }
         }
@@ -90,18 +95,10 @@ export class FallbackRegions {
             const signature = JSON.stringify([region, this.appearance]);
             let entry = this.entries.get(id);
             if (!entry) {
-                // A live demotion can leave the last GPU frame on this canvas. Retain the
-                // canvas for presentation receipts, but let only the CSS material paint.
-                const canvas = registration.canvas;
-                const visibility = canvas.style.visibility;
-                canvas.style.visibility = 'hidden';
                 entry = {
                     material: new FallbackMaterial(element),
                     signature: '',
                     generation: 0,
-                    restoreCanvas: () => {
-                        canvas.style.visibility = visibility;
-                    },
                 };
                 this.entries.set(id, entry);
             }
@@ -129,7 +126,7 @@ export class FallbackRegions {
                 if (track.epoch === Number.MAX_VALUE || frames.length === 1)
                     entry.material.paint(frames[0], this.appearance);
                 else
-                    void entry.material.play(frames, track.duration, timelineStart(track.epoch - performance.timeOrigin), this.appearance);
+                    void entry.material.play(frames, track.duration, track.epoch - performance.timeOrigin, this.appearance);
                 continue;
             }
             if (!emerge || emerge.ready === false) {
@@ -204,7 +201,7 @@ export class FallbackRegions {
                     };
                 });
                 entry.ink = animateElement(ink, frames, { duration, easing: 'linear', fill: 'both' });
-                entry.ink.startTime = at;
+                entry.ink.startTime = timelineStart(at);
             }
             if (emerge.closing)
                 this.registry?.emergeInk({
@@ -242,8 +239,8 @@ export class FallbackRegions {
         this.entries.forEach(entry => {
             entry.ink?.cancel();
             entry.material.dispose();
-            entry.restoreCanvas();
         });
         this.entries.clear();
+        this.canvases.dispose();
     }
 }

package/dist/glass/fallback/runtime.d.ts

@@ -3,6 +3,7 @@ import type { RestorePath } from '../lens/tabRestoreMotion.js';
 import type { ScreenId } from '../lens/Scene.js';
 /** Material replacement only: semantic controls and measured motion keep their existing owners. */
 export declare class FallbackGlassRuntime {
+    private canvases;
     private regions;
     private dock;
     private thumb;
@@ -25,6 +26,7 @@ export declare class FallbackGlassRuntime {
     private scroll;
     private dockSpec;
     private minimizeTrack;
+    private playMinimizeTrack;
     restoreMinimizingTabBar(path?: RestorePath): boolean;
     private thumbSpec;
     private paintTabs;

package/dist/glass/fallback/runtime.js

@@ -6,8 +6,10 @@ import { tabHeldGeometry } from '../webgpu/interactionProfiles.js';
 import { WorkerMinimize } from '../webgpu/minimize.js';
 import { FallbackMaterial } from './material.js';
 import { FallbackRegions } from './regions.js';
+import { FallbackCanvasOwnership } from './canvasOwnership.js';
 /** Material replacement only: semantic controls and measured motion keep their existing owners. */
 export class FallbackGlassRuntime {
+    canvases = new FallbackCanvasOwnership();
     regions;
     dock;
     thumb;
@@ -25,18 +27,23 @@ export class FallbackGlassRuntime {
         Object.assign(globalThis, {
             __SATIN_GLASS_RENDERER__: { backend: 'fallback', errors: getGlassErrors },
         });
+        const band = options.elements.band;
+        const shell = band.canvas.closest('[data-satin-liquid]');
+        this.canvases.update([
+            band.canvas,
+            band.rimCanvas,
+            ...(shell?.querySelectorAll('canvas[data-satin-webgpu],canvas[data-satin-glass-lift]') ?? []),
+        ]);
         this.regions = new FallbackRegions(options.regions, options.appearance);
         this.dock = new FallbackMaterial(options.elements.chrome.dock);
         this.thumb = new FallbackMaterial(options.elements.chrome.dock);
         this.dock.element.style.zIndex = '-2';
         this.thumb.element.style.zIndex = '-1';
         this.minimizeDom = new WorkerMinimize(options, path => this.restoreMinimizingTabBar(path), {
-            begin: x => {
-                this.tabPointerDown(x, this.options.geometry.tabBarSelectedIndex ?? 0);
-            },
+            begin: x => this.tabPointerDown(x, this.options.geometry.tabBarSelectedIndex ?? 0),
             move: x => this.tabPointerMove(x),
             end: cancelled => this.tabPointerUp(cancelled),
-        });
+        }, track => this.playMinimizeTrack(track));
         this.bindScroll();
         this.unsubscribeAppearance = options.subscribeAppearance?.(() => this.commitAppearance(options.currentAppearance?.() ?? options.appearance));
         this.updateGeometry({});
@@ -90,6 +97,9 @@ export class FallbackGlassRuntime {
     }
     minimizeTrack(direction, path = 'tap') {
         const track = this.minimizeDom.start(direction, this.dockSpec(), path);
+        this.playMinimizeTrack(track);
+    }
+    playMinimizeTrack(track) {
         void this.dock.play(track.specs, track.duration, track.at, this.options.appearance);
         void this.thumb.play(track.specs.map(spec => this.thumbSpec(spec)), track.duration, track.at, this.options.appearance);
     }
@@ -272,6 +282,7 @@ export class FallbackGlassRuntime {
         this.unsubscribeAppearance?.();
         this.minimizeDom.dispose();
         this.regions.dispose();
+        this.canvases.dispose();
         this.dock.dispose();
         this.thumb.dispose();
     }

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

@@ -2,7 +2,7 @@ import type { InteractivePressProfile } from './interactivePress.js';
 import { type TabHeldGeometry } from './tabMotion.js';
 export { SCOPE_THUMB } from './scopeSegments.js';
 /**
- * The held glass lens of a Toggle or Slider thumb. Measured 2026-10-09 on stock SwiftUI controls
+ * The held glass lens of a Toggle or Slider thumb. Measured 2026-10-09 on native controls
  * (iPhone 17 Pro Max Simulator, iOS 27.0, dark; counter-retimed idb contacts; `pooled-response-models.json`): a stationary hold keeps the 37 × 24 pt
  * white thumb for about 333 ms, then the thumb becomes a clear lens that springs to its held size.
  * Release restores the size with a slower spring. Mass is 1; width and height share one response.

package/dist/glass/lens/controlLift.js

@@ -2,7 +2,7 @@ import { TAB_INTERACTIVE_MOTION } from './tabMotion.js';
 import { SCOPE_THUMB } from './scopeSegments.js';
 export { SCOPE_THUMB } from './scopeSegments.js';
 /**
- * The held glass lens of a Toggle or Slider thumb. Measured 2026-10-09 on stock SwiftUI controls
+ * The held glass lens of a Toggle or Slider thumb. Measured 2026-10-09 on native controls
  * (iPhone 17 Pro Max Simulator, iOS 27.0, dark; counter-retimed idb contacts; `pooled-response-models.json`): a stationary hold keeps the 37 × 24 pt
  * white thumb for about 333 ms, then the thumb becomes a clear lens that springs to its held size.
  * Release restores the size with a slower spring. Mass is 1; width and height share one response.

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

@@ -1,7 +1,7 @@
 import { type GlassContactKind } from '../contactPhysics.js';
 /**
- * The one press response of interactive Liquid Glass (buttons, bar and toolbar buttons, the
- * back button, Glass.interactive() surfaces). Fitted 2026-09-25 to stock SwiftUI on the iOS
+ * The one press response of interactive glass (buttons, bar and toolbar buttons, the
+ * back button, Glass.interactive() surfaces). Fitted 2026-09-25 to native controls on the iOS
  * 27.0 Simulator (ParityReference `--glass-press`, idb presses at human speed: 0.6 s holds and
  * 0.12 s taps, light and dark; glass edges measured on the centre row and column):
  *

package/dist/glass/lens/interactivePress.js

@@ -1,8 +1,8 @@
 import { MENU_MORPH_DURATION, sampleMenuMorph } from './menuMorphMotion.js';
 import { GLASS_CONTACT_PHYSICS } from '../contactPhysics.js';
 /**
- * The one press response of interactive Liquid Glass (buttons, bar and toolbar buttons, the
- * back button, Glass.interactive() surfaces). Fitted 2026-09-25 to stock SwiftUI on the iOS
+ * The one press response of interactive glass (buttons, bar and toolbar buttons, the
+ * back button, Glass.interactive() surfaces). Fitted 2026-09-25 to native controls on the iOS
  * 27.0 Simulator (ParityReference `--glass-press`, idb presses at human speed: 0.6 s holds and
  * 0.12 s taps, light and dark; glass edges measured on the centre row and column):
  *

package/dist/glass/lens/menu-opening-native-fits.json

@@ -5,7 +5,7 @@
         "centerX": 364,
         "centerY": 156,
         "diameter": 58,
-        "measurement": "Fresh native button versus glass-off control: 58 x 58.333 pt at 90-level threshold. The SwiftUI label frame is 44 pt."
+        "measurement": "Fresh native button versus glass-off control: 58 x 58.333 pt at 90-level threshold. The label frame is 44 pt."
     },
     "panel": {
         "centerX": 267.5,

package/dist/glass/lens/menuContextFit.json

@@ -3,7 +3,7 @@
         "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)."
+        "content": "openContent: native iPad Pro 11 (2nd gen) iOS 27.0.1 .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": {

package/dist/glass/lens/menuDropFit.json

@@ -1,6 +1,6 @@
 {
     "provenance": {
-        "scene": "Stock SwiftUI Menu(\"Menu selection\") in a List Section (native reference app), iPadOS 27.0, light",
+        "scene": "Native controls 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.",

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

@@ -10,7 +10,7 @@ import type { MenuSourceKind } from '../regions.js';
  * The trigger's glyph and the menu's rows are ink drawn inside that glass (the ink kernel), so
  * the growing rim lenses them and no page element is scaled, blurred or clipped.
  *
- * Phone reference: iOS 27.0 iPhone 17 Pro Max Simulator, stock SwiftUI toolbar Menu
+ * Phone reference: iOS 27.0 iPhone 17 Pro Max Simulator, native toolbar menu
  * (native recording menu measurements). Times are ms after the morph's time zero:
  * native release +43 ms on open (regionScene anchors it on the trigger's release), close tap
  * +41 ms on close. Measured (native release/tap times): the pressed 48 pt button holds, dips to
@@ -25,7 +25,7 @@ import type { MenuSourceKind } from '../regions.js';
  * shape passes its button. Rows fade from the first close frame (246 → 96 in about 15 ms of
  * motion, a faint blurred copy until about +140 ms).
  *
- * Triggers that are not a circle (same Simulator, stock SwiftUI Menu from a labelled capsule
+ * Triggers that are not a circle (same Simulator, native menu from a labelled capsule
  * 129 x 50, a full-width button 400 x 50 and a toolbar group 152 x 44; phase-morph-shapes-notes.md):
  * the drop does not start as the trigger. The whole trigger glass contracts in about three frames
  * (its width to 0.71 and 0.47 of rest while its height is at 0.90 and 0.74: it shortens faster

package/dist/glass/lens/menuField.js

@@ -11,7 +11,7 @@ import { menuSpring } from './menuSpring.js';
  * The trigger's glyph and the menu's rows are ink drawn inside that glass (the ink kernel), so
  * the growing rim lenses them and no page element is scaled, blurred or clipped.
  *
- * Phone reference: iOS 27.0 iPhone 17 Pro Max Simulator, stock SwiftUI toolbar Menu
+ * Phone reference: iOS 27.0 iPhone 17 Pro Max Simulator, native toolbar menu
  * (native recording menu measurements). Times are ms after the morph's time zero:
  * native release +43 ms on open (regionScene anchors it on the trigger's release), close tap
  * +41 ms on close. Measured (native release/tap times): the pressed 48 pt button holds, dips to
@@ -26,7 +26,7 @@ import { menuSpring } from './menuSpring.js';
  * shape passes its button. Rows fade from the first close frame (246 → 96 in about 15 ms of
  * motion, a faint blurred copy until about +140 ms).
  *
- * Triggers that are not a circle (same Simulator, stock SwiftUI Menu from a labelled capsule
+ * Triggers that are not a circle (same Simulator, native menu from a labelled capsule
  * 129 x 50, a full-width button 400 x 50 and a toolbar group 152 x 44; phase-morph-shapes-notes.md):
  * the drop does not start as the trigger. The whole trigger glass contracts in about three frames
  * (its width to 0.71 and 0.47 of rest while its height is at 0.90 and 0.74: it shortens faster
@@ -456,7 +456,7 @@ const MENU_LABEL_INK = {
         lens: [[0, 0]],
     },
 };
-/** A plain glyph's drop (a Menu labelled with a bare symbol, no glass at rest): stock SwiftUI
+/** A plain glyph's drop (a Menu labelled with a bare symbol, no glass at rest): the measured platform control
  * in the iOS 27.0 Simulator, counter-retimed (menuGlyphDropFit.json). Open: the glyph vanishes on
  * the tap; the body's first frame is already 94 x 82 pt with the rows inside it, small and
  * blurred; they reach full size by +120 ms and are sharp by +154 ms. Close: the rows blur and

package/dist/glass/lens/menuGlyphDropFit.json

@@ -1,6 +1,6 @@
 {
     "provenance": {
-        "source": "plain-menu-morph native/PlainMenuRef.swift: stock SwiftUI Menu { … } label: { Image(systemName: \"ellipsis\") } (no glass), iOS 27.0 Simulator, iPhone 17 Pro Max, light; raw/pmm-light-1.mp4",
+        "source": "plain-menu-morph native/PlainMenuRef.swift: native controls Menu { … } label: { Image(systemName: \"ellipsis\") } (no glass), iOS 27.0 Simulator, iPhone 17 Pro Max, light; raw/pmm-light-1.mp4",
         "cadence": "refresh counter 58.47 Hz, skips 0.23 %, max skip 1, 0 unreadable: valid for fitting (duplicates removed by counter, times = refresh index x 17.1 ms)",
         "openOnset": "counter 1512, the refresh where the glyph disappears (the tap)",
         "closeOnset": "counter 1562, the last refresh before the open menu moves",

package/dist/glass/lens/menuMorphFit.json

@@ -1,6 +1,6 @@
 {
     "provenance": {
-        "scene": "ParityReference --menu-morph, stock SwiftUI toolbar Menu, black fixture",
+        "scene": "ParityReference --menu-morph, native controls toolbar Menu, black fixture",
         "capture": "native menu native recording",
         "contoursSha256": "548f8629dda83afa8467ced2bb0533db024468359f35f602e54febb6ba918310",
         "units": "milliseconds and normalized centerX, centerY, width, height",

package/dist/glass/lens/menuMorphPhoneFit.json

@@ -1,6 +1,6 @@
 {
     "provenance": {
-        "scene": "ParityReference toolbar-ellipsis, stock SwiftUI toolbar Menu over black (iPhone 17 Pro Max Simulator, iOS 27.0)",
+        "scene": "ParityReference toolbar-ellipsis, native controls toolbar Menu over black (iPhone 17 Pro Max Simulator, iOS 27.0)",
         "capture": "morph2 native recording menu measurements.mp4",
         "model": "One damped spring per axis, each a displacement from 1 to 0: released after `delay` ms with initial velocity `velocity` (per second; negative moves toward the target), natural frequency `omega` (rad/s), damping ratio `zeta`. centerX, centerY, width and height are the travelling member, normalized between the trigger (0) and the panel (1).",
         "open": "ms after the trigger release +43 ms. Fitted to the native outline bounds (union of trigger and drop), RMS 0.018-0.041 per axis (native measurements).",

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

@@ -3,7 +3,7 @@ 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)`
+ * Measured bottom accessory motion during tab-bar minimization
  * 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

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

@@ -2,7 +2,7 @@ import type { CapsuleShape } from '../renderSpecs.js';
 /**
  * The trailing Search member of a minimizing tab bar (`Tab(role: .search)` on iPhone).
  *
- * Native reference: stock SwiftUI on iOS 27.0, iPhone 17 Pro Max (search-tab-split, Simulator
+ * Native reference: native controls on iOS 27.0, iPhone 17 Pro Max (search-tab-split, Simulator
  * tracks at 60 Hz) and the owner's Apple Music recording on a physical iPhone. On collapse the
  * bar's trailing end separates into its own capsule within one or two frames: at the split it
  * spans x = 339–413 of the 21–419 bar, full height. It then narrows from its leading edge into

package/dist/glass/lens/tabSearchMember.js

@@ -1,7 +1,7 @@
 /**
  * The trailing Search member of a minimizing tab bar (`Tab(role: .search)` on iPhone).
  *
- * Native reference: stock SwiftUI on iOS 27.0, iPhone 17 Pro Max (search-tab-split, Simulator
+ * Native reference: native controls on iOS 27.0, iPhone 17 Pro Max (search-tab-split, Simulator
  * tracks at 60 Hz) and the owner's Apple Music recording on a physical iPhone. On collapse the
  * bar's trailing end separates into its own capsule within one or two frames: at the split it
  * spans x = 339–413 of the 21–419 bar, full height. It then narrows from its leading edge into

package/dist/glass/menuPresenter.js

@@ -58,7 +58,7 @@ const MENU_GLYPH_RETURN_MS = 400;
 /** Safety margin past the close morph for the renderer's settle acknowledgement. */
 const MENU_SETTLE_TIMEOUT_MS = 700;
 /** The order of a menu that opens upward: the first action nearest the trigger, so the list and
- * each section in it read bottom to top (stock SwiftUI Menu, iPhone, a trigger near the bottom of
+ * each section in it read bottom to top (native menu, iPhone, a trigger near the bottom of
  * the screen). A submenu's own rows open separately and keep their order. */
 function nearestFirst(actions) {
     return [...actions]

package/dist/glass/regions.d.ts

@@ -225,7 +225,7 @@ export declare function glassPresenterBounds(frame: GlassRegion['frame'], inset:
  * The 12M guard permits that stack plus chrome; it is not a memory benchmark. */
 export declare const GLASS_REGION_LIMIT = 16;
 export declare const GLASS_REGION_PIXEL_LIMIT = 12000000;
-/** Immutable SwiftUI-style material values. RGBA channels use the range 0...1. */
+/** Immutable glass material values. RGBA channels use the range 0...1. */
 export declare class Glass {
     static readonly regular: Glass;
     static readonly clear: Glass;

package/dist/glass/regions.js

@@ -26,7 +26,7 @@ export function glassPresenterBounds(frame, inset, emerge) {
  * The 12M guard permits that stack plus chrome; it is not a memory benchmark. */
 export const GLASS_REGION_LIMIT = 16;
 export const GLASS_REGION_PIXEL_LIMIT = 12_000_000;
-/** Immutable SwiftUI-style material values. RGBA channels use the range 0...1. */
+/** Immutable glass material values. RGBA channels use the range 0...1. */
 export class Glass {
     static regular = new Glass('regular');
     static clear = new Glass('clear');

package/dist/glass/shapeTrack.d.ts

@@ -8,7 +8,7 @@ import type { SurfaceRenderSpec } from './renderSpecs.js';
  * seems to slide and smear while nothing behind it moves (owner, Oct 13: "it looks like content is
  * moving underneath as the menu grows").
  *
- * Native Liquid Glass keeps the content behind it in place: only the edge moves. A shape track
+ * Native glass keeps the content behind it in place: only the edge moves. A shape track
  * does the same. The element keeps one layout box for the whole run (the envelope of every frame
  * the glass passes through), so its canvas never resizes or moves and samples the page where it
  * really is. The worker draws the glass at the track's frame for each frame's presentation time,

package/dist/glass/submenuMotion.d.ts

@@ -1,6 +1,6 @@
 import { type SpringParameters } from '../motion/springTrack.js';
 /**
- * Nested menus, measured from stock SwiftUI on iOS 27.0 (submenus/SPEC.md).
+ * Nested menus, measured from native controls on iOS 27.0 (submenus/SPEC.md).
  *
  * iPhone stacks each submenu over its parent: the parent shrinks to 0.97 about its top edge and
  * its rows dim to half ink, and the child grows out of the row that opened it into a full-width

package/dist/glass/submenuMotion.js

@@ -4,7 +4,7 @@ import { setGlassShapeTrack } from './shapeTrackRegistry.js';
 import { shapeTrackClock, shapeTrackEnvelope, shapeTrackFrame, } from './shapeTrack.js';
 import { springMotion, springTrack, sampledKeyframes, } from '../motion/springTrack.js';
 /**
- * Nested menus, measured from stock SwiftUI on iOS 27.0 (submenus/SPEC.md).
+ * Nested menus, measured from native controls on iOS 27.0 (submenus/SPEC.md).
  *
  * iPhone stacks each submenu over its parent: the parent shrinks to 0.97 about its top edge and
  * its rows dim to half ink, and the child grows out of the row that opened it into a full-width

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

@@ -21,6 +21,7 @@ export declare class WebGPUClient {
     };
     private adapterDeadline?;
     private failed?;
+    private startingTransport;
     private frames;
     private webgpu;
     private currentAppearance;
@@ -45,5 +46,7 @@ export declare class WebGPUClient {
     private focus;
     private bindLifecycle;
     resume(): void;
+    /** Dispose a failed transport before constructing its replacement. */
+    close(): void;
     park(): Promise<unknown>;
 }