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

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

@@ -186,7 +186,8 @@ export declare class RegionScene {
     private owner;
     /** Worker-to-page events (a close morph that ended, so its panel can be torn down). */
     private notify;
-    constructor(owner: LayerDevice, notify?: (event: GlassRegionEvent) => void, submissionAllowed?: () => boolean);
+    private readonly chrome?;
+    constructor(owner: LayerDevice, notify?: (event: GlassRegionEvent) => void, submissionAllowed?: () => boolean, chrome?: WebGPURaster);
     request(request: GlassRendererRequest): Promise<unknown>;
     /** New source images (uploads) since the last install: only those need a completion fence. */
     private presentationReceipt;
@@ -200,6 +201,8 @@ export declare class RegionScene {
         height: number;
         pixels: Uint8Array<ArrayBuffer>;
     }>;
+    /** Geometry sampled for the frame trace, in viewport points. No DOM measurements. */
+    accessoryGeometry(): string;
     diagnostics(): {
         navigation: {
             key: string;

package/dist/glass/webgpu/regionScene.js

@@ -1132,7 +1132,9 @@ export class RegionScene {
     owner;
     /** Worker-to-page events (a close morph that ended, so its panel can be torn down). */
     notify;
-    constructor(owner, notify = () => { }, submissionAllowed = () => true) {
+    chrome;
+    constructor(owner, notify = () => { }, submissionAllowed = () => true, chrome) {
+        this.chrome = chrome;
         this.submissionAllowed = () => !this.sourcePending && submissionAllowed();
         this.owner = owner;
         this.notify = notify;
@@ -1683,6 +1685,12 @@ export class RegionScene {
                     width: bounds.width,
                     height: bounds.height,
                 };
+            if (this.chrome) {
+                if (region.accessoryTrack?.held && p.descriptor.role === 'material')
+                    p.raster?.joinPresentation(this.chrome, p.descriptor.origin);
+                else
+                    p.raster?.leavePresentation();
+            }
             const viewportTrack = region.presentationViewportTrack ?? region.accessoryViewportTrack ?? region.accessoryTrack;
             const accessoryTranslation = viewportTrack && !held ? accessoryOffset(viewportTrack, this.trackClock()) : undefined;
             const viewport = held
@@ -1902,6 +1910,8 @@ export class RegionScene {
                     p.raster.setViewport(viewport);
                 p.raster.setSubmissionGate(this.submissionAllowed);
                 await p.raster.init(p.canvas, this.owner, region.layer, p.descriptor);
+                if (this.chrome && region.accessoryTrack?.held && p.descriptor.role === 'material')
+                    p.raster.joinPresentation(this.chrome, p.descriptor.origin);
                 p.raster.setVisible(this.visible);
                 fence = true;
             }
@@ -2070,6 +2080,25 @@ export class RegionScene {
             throw Error('Unknown glass presenter snapshot ' + id);
         return raster.snapshot();
     }
+    /** Geometry sampled for the frame trace, in viewport points. No DOM measurements. */
+    accessoryGeometry() {
+        return JSON.stringify([...this.presenters.values()].flatMap(p => {
+            const region = this.scene.regions.find(r => r.id === p.descriptor.regionIds[0]);
+            const spec = p.raster?.spec;
+            if (!region?.accessoryTrack || !spec || p.descriptor.role !== 'material')
+                return [];
+            const shape = spec.shape.first;
+            return [
+                {
+                    region: region.id,
+                    left: p.descriptor.origin.x + spec.frameX + shape.centerX - shape.halfWidth,
+                    right: p.descriptor.origin.x + spec.frameX + shape.centerX + shape.halfWidth,
+                    top: p.descriptor.origin.y + spec.frameY + shape.centerY - shape.halfHeight,
+                    inkLayers: spec.ink?.layers.length ?? 0,
+                },
+            ];
+        }));
+    }
     diagnostics() {
         return {
             navigation: this.navigation

package/dist/glass/webgpu/renderer.js

@@ -65,7 +65,7 @@ export function createWebGPURenderer(emit, clock = documentFrameClock) {
     const raster = new WebGPURaster();
     raster.setSubmissionGate(submissionAllowed);
     const layers = new Map([['chrome', raster]]);
-    const appRegions = new RegionScene(owner, event => emit({ glassEvent: event }), submissionAllowed);
+    const appRegions = new RegionScene(owner, event => emit({ glassEvent: event }), submissionAllowed, clock.kind === 'worker-raf' ? raster : undefined);
     let tab = new TabMotion(), sharedTabLift = false, reducedMotion = false;
     const menuLift = new TabMotion(TAB_INTERACTIVE_MOTION);
     let tabTiming;
@@ -435,8 +435,15 @@ export function createWebGPURenderer(emit, clock = documentFrameClock) {
                 restart: restarted,
             };
             loopSample = undefined;
-            appRegions.sample(at, sampleAt);
-            render(x, [], sampleAt);
+            if (clock.kind === 'worker-raf')
+                raster.withSharedPresentation(() => {
+                    appRegions.sample(at, sampleAt);
+                    render(x, [], sampleAt);
+                });
+            else {
+                appRegions.sample(at, sampleAt);
+                render(x, [], sampleAt);
+            }
         }
         catch (error) {
             frameContext = undefined;
@@ -481,7 +488,16 @@ export function createWebGPURenderer(emit, clock = documentFrameClock) {
                     late: 0,
                     interval: previous === undefined ? null : at - previous,
                     restart: restarted,
-                    clock: 'page-raf',
+                    clock: clock.kind ?? 'page-raf',
+                    homeLeft: raster.spec &&
+                        raster.spec.frameX +
+                            raster.spec.shape.first.centerX -
+                            raster.spec.shape.first.halfWidth,
+                    homeRight: raster.spec &&
+                        raster.spec.frameX +
+                            raster.spec.shape.first.centerX +
+                            raster.spec.shape.first.halfWidth,
+                    accessoryGeometry: clock.kind === 'worker-raf' ? appRegions.accessoryGeometry() : undefined,
                     callbackDelayMs,
                     presented: takePresentedCanvases(),
                     tabCentre: tab.frame.centre,
@@ -509,7 +525,7 @@ export function createWebGPURenderer(emit, clock = documentFrameClock) {
         }
     };
     owner.subscribe(device => {
-        frameProbe.useDevice(device);
+        frameProbe.useDevice(device, clock.kind !== 'worker-raf');
         lost = !device;
         if (!device) {
             cancel();
@@ -934,7 +950,7 @@ export function createWebGPURenderer(emit, clock = documentFrameClock) {
                     }
                     break;
                 case 'capability':
-                    frameProbe.useDevice(await owner.ready());
+                    frameProbe.useDevice(await owner.ready(), clock.kind !== 'worker-raf');
                     value = { backend: 'webgpu', timestampQuery: frameProbe.timestampQuery };
                     break;
                 case 'init':
@@ -1291,7 +1307,7 @@ export function createWebGPURenderer(emit, clock = documentFrameClock) {
                         callbacks,
                         framePending: !!handle,
                         rate: 60,
-                        clock: 'page-raf',
+                        clock: clock.kind ?? 'page-raf',
                         visible,
                         presentationGate: {
                             allowed: submissionAllowed(),

package/dist/keyboard/adapter.js

@@ -150,7 +150,7 @@ export function dismissKeyboard() {
 }
 /** One adapter per SatinRoot. Owns viewport listeners, never cancels editing gestures. */
 /**
- * Tapping a control keeps the editor's keyboard, as a UIKit or SwiftUI button tap keeps the first
+ * Tapping a control keeps the editor's keyboard, so button presses preserve the first
  * responder: a hand-rolled composer's Send must not close the keyboard (iPad, October 12, 0/5 kept).
  * Controls that leave the editor end editing themselves: navigation and tab switches dismiss
  * explicitly, and a presented modal takes focus through showModal().
@@ -517,7 +517,7 @@ export function installKeyboardAdapter(root) {
         releaseSurface();
         revealedFor = '';
         revealedEditor = null;
-        // Navigation ends editing, as a pushed or popped SwiftUI screen dismisses its keyboard.
+        // Navigation ends editing, when a screen is pushed or popped.
         if (editable(document.activeElement) && root.contains(document.activeElement))
             document.activeElement.blur();
     };

package/dist/keyboard/avoidance.d.ts

@@ -7,7 +7,7 @@ export type KeyboardClearance = Readonly<{
     bottom: number;
 }>;
 /**
- * Keyboard avoidance for the focused editor, as SwiftUI's keyboard safe area does it: every
+ * Keyboard avoidance for the focused editor, through the keyboard safe area: every
  * scroll surface around the editor gets room below its content for the keyboard and scrolls the
  * editor (a tall editor: its caret line) above the keyboard, innermost first. An editor on a page
  * whose surfaces cannot bring it up (a screen without a scroll surface, or a nested scroller pinned

package/dist/keyboard/avoidance.js

@@ -29,7 +29,7 @@ function keepEditorInBox(delta, editor, box, offsetTop, room) {
     return Math.min(high, Math.max(low, delta));
 }
 /**
- * Keyboard avoidance for the focused editor, as SwiftUI's keyboard safe area does it: every
+ * Keyboard avoidance for the focused editor, through the keyboard safe area: every
  * scroll surface around the editor gets room below its content for the keyboard and scrolls the
  * editor (a tall editor: its caret line) above the keyboard, innermost first. An editor on a page
  * whose surfaces cannot bring it up (a screen without a scroll surface, or a nested scroller pinned

package/dist/keyboard/motion.d.ts

@@ -1,6 +1,6 @@
 /**
  * The software keyboard's show and hide motion. Measured per frame from the native composer's
- * presentation layer (SwiftUI `ScrollView` + `.safeAreaInset(edge: .bottom)` chat, iOS 27.0
+ * presentation layer (`ScrollView` + `.safeAreaInset(edge: .bottom)` chat, iOS 27.0
  * Simulator, 4 shows and 4 hides; UIKit reports duration 0.3833 s, curve 7): a spring with mass 1,
  * stiffness 535 and damping 45.5, released at rest, fits every frame of both directions within
  * 0.84 pt of a 313 pt travel. UIKit ends the animation at 383 ms (0.4 pt short of rest).

package/dist/keyboard/motion.js

@@ -1,7 +1,7 @@
 import { menuSpring } from '../glass/lens/menuSpring.js';
 /**
  * The software keyboard's show and hide motion. Measured per frame from the native composer's
- * presentation layer (SwiftUI `ScrollView` + `.safeAreaInset(edge: .bottom)` chat, iOS 27.0
+ * presentation layer (`ScrollView` + `.safeAreaInset(edge: .bottom)` chat, iOS 27.0
  * Simulator, 4 shows and 4 hides; UIKit reports duration 0.3833 s, curve 7): a spring with mass 1,
  * stiffness 535 and damping 45.5, released at rest, fits every frame of both directions within
  * 0.84 pt of a 313 pt travel. UIKit ends the animation at 383 ms (0.4 pt short of rest).

package/dist/list-form/ListForm.d.ts

@@ -11,13 +11,13 @@ export type ListEngineProps = Omit<ScrollSurfaceProps, 'axis'> & {
     variant?: 'insetGrouped' | 'plain' | 'grouped' | 'sidebar';
     navigationTitle?: string;
     navigationTitleDisplay?: 'large' | 'inline';
-    /** SwiftUI `searchable`: a search field in the navigation bar drawer above this List. */
+    /** A search field in the navigation bar drawer above this List. */
     searchable?: Searchable;
     /** Default keeps measured header/footer gaps. Numbers are section gaps in points. */
     listSectionSpacing?: 'default' | 'compact' | number;
     /** Controls the scroll surface background, leaving row backgrounds intact. */
     scrollContentBackground?: 'hidden' | 'visible';
-    /** SwiftUI `List(selection:)`, resolved by the public List. */
+    /** Selection state resolved by the public List. */
     selectionBinding?: ListSelectionBinding;
 };
 /** A controlled List selection: one optional row, or a set of rows. */

package/dist/list-form/ListForm.js

@@ -410,7 +410,7 @@ export function StepperControl({ value, onChange, min = -Infinity, max = Infinit
     return (_jsxs("span", { "data-satin-row-intrinsic": "true", "data-satin-stepper": "true", "data-satin-stepper-disabled": disabled ? 'true' : undefined, role: "group", "aria-label": `${label}, ${value}`, children: [_jsx(StepperButton, { onEditingChange: onEditingChange, label: `Decrease ${label}, ${value}`, disabled: disabled || value <= min, onStep: () => onChange(clampStepper(value, min, max, -step)), children: _jsx(SymbolImage, { name: "minus", weight: "medium" }) }), _jsx(StepperButton, { onEditingChange: onEditingChange, label: `Increase ${label}, ${value}`, disabled: disabled || value >= max, onStep: () => onChange(clampStepper(value, min, max, step)), children: _jsx(SymbolImage, { name: "plus", weight: "semibold" }) })] }));
 }
 export function StepperRow(props) {
-    return _jsx(Row, { label: props.label, trailing: _jsx(StepperControl, { ...props }) });
+    return (_jsx(Row, { className: "satin-stepper-row", label: props.label, trailing: _jsx(StepperControl, { ...props }) }));
 }
 export function SegmentedControl({ value, onChange, options, disabled = false, label = 'Options', style: cssStyle, }) {
     const choose = useChooseOption({ options, disabled, onChange });

package/dist/list-form/ListItem.js

@@ -208,7 +208,7 @@ function playEditShift(item, before, after) {
 }
 /**
  * The reorder handle's pointer-down: lifts this row and hands it to the drag. The move is
- * reported through `onMove` with SwiftUI's offsets once the row settles; the new order must then
+ * reported through `onMove` with source-sequence offsets once the row settles; the new order must then
  * come back through `data`, and until it does the rows stay where they were dropped.
  */
 function useReorder(element, item, editing) {

package/dist/list-form/RowLabel.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
 /**
- * A row title with a secondary line under it: SwiftUI's two-Text label (a title, then a
+ * A row title with a secondary line under it: a two-line label (a title, then a
  * `.subheadline` `.secondary` line). `RowLabel`, a Toggle subtitle and any other two-line row
  * label share this one body, so their type and spacing cannot drift apart.
  *

package/dist/list-form/RowLabel.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * A row title with a secondary line under it: SwiftUI's two-Text label (a title, then a
+ * A row title with a secondary line under it: a two-line label (a title, then a
  * `.subheadline` `.secondary` line). `RowLabel`, a Toggle subtitle and any other two-line row
  * label share this one body, so their type and spacing cannot drift apart.
  *

package/dist/list-form/Slider.js

@@ -5,7 +5,7 @@ import { requestGlassSourceDamage } from '../glass/sourceDamage.js';
 import { CONTROL_LIFT, controlLensSize } from '../glass/lens/controlLift.js';
 import { SliderContact } from './sliderContact.js';
 /**
- * Native geometry (stock SwiftUI Slider in a Form, iPhone 17 Pro Max Simulator, iOS 27.0, 3×
+ * Native geometry (a slider in a form, iPhone 17 Pro Max Simulator, iOS 27.0, 3×
  * stills, native control measurements `continuous.mov`): a 6 pt capsule track spans the row's content
  * width, the 37 × 24 pt white thumb stays inside it (its centre travels from 18.5 pt to width −
  * 18.5 pt), and the accent fill runs from the track start to the thumb centre with a round end.

package/dist/list-form/editMotion.js

@@ -1,5 +1,5 @@
 /*
- * Edit mode's row motion, measured from a stock SwiftUI `List` with `onDelete` and `onMove`
+ * Edit mode's row motion, measured from a native list with `onDelete` and `onMove`
  * (iOS 27.0 Simulator, native reference `native list editing fixture native editing fixture`, five Edit/Done toggles, frame counter
  * retimed: 0 skipped refreshes of 922; fits in native measurements).
  *

package/dist/list-form/editing.d.ts

@@ -5,7 +5,7 @@ export type EditMode = 'inactive' | 'active';
 /** A row's identity in `List` selection: the `ForEach` id. */
 export type ListItemID = string | number;
 /**
- * Every navigation destination owns one edit mode, as a SwiftUI `NavigationStack` destination does:
+ * Every navigation destination owns one edit mode, for its retained entry:
  * its `EditButton` and its lists read and write the same value, and another screen keeps its own.
  */
 export declare function EditModeScope({ children }: {
@@ -25,14 +25,14 @@ export type ListSelectionModel = Readonly<{
     /** `single` selects one row (an optional binding); `multiple` collects a set. */
     mode: 'single' | 'multiple';
     isSelected(id: ListItemID): boolean;
-    /** A row tap: replaces a single selection; toggles a set only while editing, as SwiftUI does. */
+    /** A row tap: replaces a single selection; toggles a set only while editing. */
     activate(id: ListItemID, editing: boolean): void;
 }>;
 export declare const ListSelectionContext: import("react").Context<Readonly<{
     /** `single` selects one row (an optional binding); `multiple` collects a set. */
     mode: 'single' | 'multiple';
     isSelected(id: ListItemID): boolean;
-    /** A row tap: replaces a single selection; toggles a set only while editing, as SwiftUI does. */
+    /** A row tap: replaces a single selection; toggles a set only while editing. */
     activate(id: ListItemID, editing: boolean): void;
 }> | null>;
 /**
@@ -82,7 +82,7 @@ export declare function forEachRows<T>(props: ForEachProps<T>): ForEachRow[];
 /** What an editable row needs from its list item: edit state, selection and the item's actions. */
 export type ListItemState = Readonly<{
     editing: boolean;
-    /** While editing with a selection, a row's own press selects it, as a SwiftUI list row does. */
+    /** While editing with a selection, a row's own press selects it, as a list row does. */
     pressSelects: boolean;
     select(): void;
     /** Rows that also declare actions hand them to the item, which owns the row's one gesture host. */
@@ -94,7 +94,7 @@ export type RowActionsDelegation = RowActionsProps & Readonly<{
 }>;
 export declare const ListItemContext: import("react").Context<Readonly<{
     editing: boolean;
-    /** While editing with a selection, a row's own press selects it, as a SwiftUI list row does. */
+    /** While editing with a selection, a row's own press selects it, as a list row does. */
     pressSelects: boolean;
     select(): void;
     /** Rows that also declare actions hand them to the item, which owns the row's one gesture host. */

package/dist/list-form/editing.js

@@ -3,7 +3,7 @@ import { createContext, Fragment, useContext, useMemo, useState } from 'react';
 const inactiveEverywhere = ['inactive', () => { }];
 const EditModeContext = createContext(inactiveEverywhere);
 /**
- * Every navigation destination owns one edit mode, as a SwiftUI `NavigationStack` destination does:
+ * Every navigation destination owns one edit mode, for its retained entry:
  * its `EditButton` and its lists read and write the same value, and another screen keeps its own.
  */
 export function EditModeScope({ children }) {

package/dist/motion/animationValue.d.ts

@@ -4,14 +4,14 @@ declare const brand: unique symbol;
 export type Animation = Readonly<{
     [brand]: true;
 }>;
-/** Duration and bounce options for `Animation.spring`. */
+/** Options for a spring defined by duration and bounce. */
 export type SpringOptions = Readonly<{
     /** The perceptual duration in milliseconds. Defaults to 500. */
     durationMs?: number;
     /** 0 settles without overshoot. Values are clamped to 0 through 0.99. Defaults to 0. */
     bounce?: number;
 }>;
-/** SwiftUI's named springs. `default` is the curve `withAnimation` uses with no argument. */
+/** Named spring timing values. `default` is the curve `withAnimation` uses with no argument. */
 export declare const Animation: Readonly<{
     spring: (options?: SpringOptions) => Animation;
     smooth: Animation;

package/dist/motion/animationValue.js

@@ -1,8 +1,8 @@
 const brand = Symbol('satin.animation');
 /**
- * SwiftUI's `spring(duration:bounce:)` mapping, as Apple documents it: the duration is the
+ * Duration is the
  * period of the undamped spring (omega = 2π / duration), and bounce is 1 − damping ratio for
- * bounce ≥ 0. SwiftUI's negative (over-damped) bounces are not offered: the shared spring
+ * bounce ≥ 0. Negative, over-damped bounces are not offered: the shared spring
  * solver (glass/lens/menuSpring.ts) models damping ratios up to 1.
  */
 function spring({ durationMs = 500, bounce = 0 } = {}) {
@@ -15,24 +15,23 @@ function spring({ durationMs = 500, bounce = 0 } = {}) {
     const animation = Object.freeze({ [brand]: true, omega, zeta });
     return animation;
 }
-/** SwiftUI's named springs. `default` is the curve `withAnimation` uses with no argument. */
+/** Named spring timing values. `default` is the curve `withAnimation` uses with no argument. */
 export const Animation = Object.freeze({
     spring,
-    /** SwiftUI `.smooth`: duration 0.5 s, bounce 0. */
+    /** Smooth spring: duration 0.5 s, bounce 0. */
     smooth: spring({ durationMs: 500, bounce: 0 }),
-    /** SwiftUI `.snappy`: duration 0.5 s, bounce 0.15. */
+    /** Snappy spring: duration 0.5 s, bounce 0.15. */
     snappy: spring({ durationMs: 500, bounce: 0.15 }),
-    /** SwiftUI `.bouncy`: duration 0.5 s, bounce 0.3. */
+    /** Bouncy spring: duration 0.5 s, bounce 0.3. */
     bouncy: spring({ durationMs: 500, bounce: 0.3 }),
-    /** SwiftUI `.default`. The value is the measured fit recorded in the measured reference
+    /** Default spring. The value is the measured fit recorded in the measured reference
      * (matchedGeometryEffect, October 11); see DEFAULT_ANIMATION_DURATION_MS. */
     get default() {
         return defaultAnimation;
     },
 });
-/* The perceptual duration of SwiftUI's `.default` animation on iOS 27, which is a critically
- * damped spring. Source: the stock SwiftUI matchedGeometryEffect fixture recorded by the
- * matched-geometry implementation (the measured reference, October 11). */
+/* Default perceptual duration for the critically damped animation spring. The measured
+ * fit and recording provenance live in the measured reference. */
 export const DEFAULT_ANIMATION_DURATION_MS = 500;
 const defaultAnimation = spring({ durationMs: DEFAULT_ANIMATION_DURATION_MS, bounce: 0 });
 /** The spring with a unit displacement and the given initial velocity (units per second). */

package/dist/motion/matchedGeometry.d.ts

@@ -27,22 +27,22 @@ export type MatchedGeometryEffectProps = Readonly<{
     children: ReactNode;
 }>;
 /**
- * SwiftUI `matchedGeometryEffect(id:in:isSource:)`: when a `withAnimation` change removes this
+ * When a `withAnimation` change removes this
  * view and inserts another with the same id, the new one moves from the old one's frame to its
  * own while the two cross-fade. A view that only moves or resizes
  * animates from where it was. A matched view with no partner fades in or out.
  *
  * Wrap one element that has no transform of its own. Changes made outside `withAnimation`
- * apply at once, as in SwiftUI.
+ * apply at once.
  * @example
  * const art = useNamespace()
  * <MatchedGeometryEffect id="artwork" in={art}><Image src={cover} alt="" /></MatchedGeometryEffect>
- * @experimental Frame matching only (SwiftUI's default `properties: .frame`, `anchor: .center`).
+ * @experimental Matches the frame around its center only.
  * A non-source view does not follow its source outside an animation.
  */
 export declare function MatchedGeometryEffect({ id, in: namespace, isSource, children, }: MatchedGeometryEffectProps): import("react").JSX.Element;
 /**
- * `withAnimation` applies the state changes in `update`, then animates the
+ * Applies the state changes in `update`, then animates the
  * `MatchedGeometryEffect` views they move, insert or remove. Call it from an event handler.
  * Keyed List rows also move to their new positions. Other views take their new layout at once.
  * Returns the callback result and propagates errors. Only synchronous updates participate.

package/dist/motion/matchedGeometry.js

@@ -17,9 +17,8 @@ import { fadeSettleMs, runFrameTimes, sampleChannel, sampleProgress, } from './s
  *
  * A view whose id leaves and enters in the same change keeps its identity: the new view starts
  * from the old one's frame and fades in, and the old view stays on screen as a "ghost" (its own
- * detached DOM node, already decoded) that travels with it and fades out. That cross-fade is
- * SwiftUI's: a stock iOS 27 fixture shows both views on one frame, with opacities that sum to 1
- * on the animation's own spring (the measured reference, October 11).
+ * detached DOM node, already decoded) that travels with it and fades out. Their opacities sum to 1
+ * throughout the spring-driven cross-fade. Measurement provenance lives in the measured reference.
  */
 const namespaceBrand = Symbol('satin.namespace');
 const entries = new Set();
@@ -40,17 +39,17 @@ export function defineNamespace() {
     return Object.freeze({ [namespaceBrand]: true });
 }
 /**
- * SwiftUI `matchedGeometryEffect(id:in:isSource:)`: when a `withAnimation` change removes this
+ * When a `withAnimation` change removes this
  * view and inserts another with the same id, the new one moves from the old one's frame to its
  * own while the two cross-fade. A view that only moves or resizes
  * animates from where it was. A matched view with no partner fades in or out.
  *
  * Wrap one element that has no transform of its own. Changes made outside `withAnimation`
- * apply at once, as in SwiftUI.
+ * apply at once.
  * @example
  * const art = useNamespace()
  * <MatchedGeometryEffect id="artwork" in={art}><Image src={cover} alt="" /></MatchedGeometryEffect>
- * @experimental Frame matching only (SwiftUI's default `properties: .frame`, `anchor: .center`).
+ * @experimental Matches the frame around its center only.
  * A non-source view does not follow its source outside an animation.
  */
 export function MatchedGeometryEffect({ id, in: namespace, isSource = true, children, }) {
@@ -226,13 +225,13 @@ function moveView(element, key, from, box, animation) {
         target: box,
         velocity: from.velocity,
         animation,
-        // A new partner fades in (SwiftUI's default .opacity insertion); a view that stays carries
+        // A new partner fades in through the default opacity transition; a view that stays carries
         // on from the opacity it is showing.
         opacity: { from: stayed ? from.opacity : 0, to: 1 },
         ghost: false,
     });
 }
-/** SwiftUI's default `.opacity` transition for a matched view with no partner. */
+/** An opacity transition for a matched view with no partner. */
 function fadeView(element, key, box, animation, opacity) {
     startRun({
         element,

package/dist/motion/springTrack.d.ts

@@ -1,6 +1,5 @@
 import { type MenuSpring } from '../glass/lens/menuSpring.js';
-/** A measured spring: SwiftUI's `.interpolatingSpring(stiffness:damping:)` with unit mass, released
- * `delay` ms after the animation starts. */
+/** A unit-mass spring defined by stiffness and damping, released after an optional delay in ms. */
 export type SpringParameters = Readonly<{
     stiffness: number;
     damping: number;

package/dist/motion/springTrack.js

@@ -28,19 +28,22 @@ export function sampledKeyframes(track, frame) {
     return track.progress.map((progress, index) => ({ ...frame(progress), offset: index / last }));
 }
 export function sampledMotionTrack(duration, sample, tolerance = 0.2) {
-    if (!(duration > 0) || !Number.isFinite(duration) || !(tolerance > 0) || !Number.isFinite(tolerance))
+    if (!(duration > 0) ||
+        !Number.isFinite(duration) ||
+        !(tolerance > 0) ||
+        !Number.isFinite(tolerance))
         throw Error('Motion tracks require a finite positive duration and tolerance');
     let count = Math.max(1, Math.ceil(duration / (1000 / 120)));
     // GPU and compositor consumers require even offsets. Refine the whole grid,
     // rather than giving them independent adaptive sample positions.
     while (count <= 4096) {
-        const values = Array.from({ length: count + 1 }, (_, index) => sample(duration * index / count));
+        const values = Array.from({ length: count + 1 }, (_, index) => sample((duration * index) / count));
         if (!values.every(Number.isFinite))
             throw Error('Motion track contains a non-finite value');
         let accurate = true;
         for (let index = 0; accurate && index < count; index++) {
             for (const fraction of [0.25, 0.5, 0.75]) {
-                const exact = sample(duration * (index + fraction) / count);
+                const exact = sample((duration * (index + fraction)) / count);
                 const linear = values[index] + (values[index + 1] - values[index]) * fraction;
                 if (!Number.isFinite(exact))
                     throw Error('Motion track contains a non-finite value');
@@ -59,11 +62,13 @@ export function sampledMotionTrack(duration, sample, tolerance = 0.2) {
 /** Read the submitted segment, including its velocity, when a run is interrupted. */
 export function sampledMotionState(track, milliseconds) {
     const last = track.values.length - 1;
-    const position = Math.max(0, Math.min(last, milliseconds / track.duration * last));
+    const position = Math.max(0, Math.min(last, (milliseconds / track.duration) * last));
     const index = Math.min(last - 1, Math.floor(position));
     const from = track.values[index], to = track.values[index + 1];
     return {
         value: from + (to - from) * (position - index),
-        velocity: milliseconds < 0 || milliseconds >= track.duration ? 0 : (to - from) * last / track.duration * 1000,
+        velocity: milliseconds < 0 || milliseconds >= track.duration
+            ? 0
+            : (((to - from) * last) / track.duration) * 1000,
     };
 }

package/dist/navigation/ScreenContainer.js

@@ -130,7 +130,7 @@ export function ScreenContainer({ children, entry, interactionBlocked = false, c
     }), [entry.key, entry.params, entry.transition.phase, isCovered, scrollRegistry, tabActive]);
     useLayoutEffect(() => navigator[navigatorScrollRuntime].bind(entry.key, scrollRegistry), [entry.key, navigator, scrollRegistry]);
     // Without a primary scroll view, content is laid out in the safe area below the bar, as a
-    // SwiftUI VStack is (styles.css). The attribute follows the registry in the same frame.
+    // VStack is (styles.css). The attribute follows the registry in the same frame.
     // The primary's vertical scroll indicator is drawn in the screen frame (scroll/scrollIndicator.ts).
     const motionLayer = useRef(null);
     const indicatorTrack = useRef(null);

package/dist/navigation/chromeCurves.js

@@ -1,7 +1,7 @@
 // Measured iOS 27 navigation bar chrome curves (what bar items do while a page moves) and the
 // keyframe builders that turn them into Web Animations keyframes. Pure data and math: no DOM.
 /** Incoming bar chrome, measured on the iOS 27.0 Simulator from the presentation layers of stock
- * SwiftUI (every display frame,
+ * Measured at every display frame,
  * light and dark agree within 0.04): milliseconds since the page starts moving. A push brings the
  * destination's glass items in faster than a pop brings the revealed screen's back: a push shows
  * 0.56 at 100 ms (Reminders-style list → list, back circle and trailing "…" together), a pop 0.30

package/dist/navigation/types.d.ts

@@ -16,7 +16,7 @@ export type NavigationBarDefinition<Params = unknown> = Readonly<{
     display?: TitleDisplayMode;
     visibility?: Visibility;
     title: string | ((params: Params) => string);
-    /** SwiftUI `navigationSubtitle`: a line under the title, inline or large. */
+    /** A line under the title, inline or large. */
     subtitle?: string;
 }>;
 export type TransitionControllerContext = Readonly<{

package/dist/navigation/zoomGeometry.js

@@ -1,5 +1,5 @@
 /*
- * The geometry of SwiftUI's zoom navigation transition, as pure functions of a rectangle.
+ * Zoom navigation geometry, as pure functions of a rectangle.
  *
  * At every moment the pushed screen is shown inside a rounded "window" rectangle that moves between
  * the source view's frame and the full screen. As natively, the screen's content is scaled so its

package/dist/navigation/zoomMotion.d.ts

@@ -9,7 +9,7 @@ export type ZoomSprings = Readonly<{
     size: ZoomSpring;
 }>;
 /**
- * Push: the centre and the width move together, critically damped (half way at 88 ms; SwiftUI's
+ * Push: the centre and the width move together, critically damped (half way at 88 ms; the measured
  * duration 0.33 s); the height lags slightly. Native moves the width with the centre, so the
  * width shares the centre's spring here and the height takes the size spring (rms 0.002, 51 ticks).
  */

package/dist/navigation/zoomMotion.js

@@ -1,5 +1,5 @@
 /*
- * Measured values of SwiftUI's `.navigationTransition(.zoom(sourceID:in:))` on iOS 27.
+ * Measured spring values for the zoom navigation transition on iOS 27.
  *
  * native reference: a stock native fixture (a 180 pt tile with a 10 pt corner in a
  * NavigationStack grid, pushed to a full-screen page), iPhone 17 Pro Max Simulator, iOS 27.0.
@@ -10,7 +10,7 @@
  * (the measured reference, October 11).
  */
 /**
- * Push: the centre and the width move together, critically damped (half way at 88 ms; SwiftUI's
+ * Push: the centre and the width move together, critically damped (half way at 88 ms; the measured
  * duration 0.33 s); the height lags slightly. Native moves the width with the centre, so the
  * width shares the centre's spring here and the height takes the size spring (rms 0.002, 51 ticks).
  */

package/dist/navigation/zoomTransition.js

@@ -1,6 +1,5 @@
 /*
- * SwiftUI's zoom navigation transition: `matchedTransitionSource(id:in:)` on the view a push starts
- * from, and `.navigationTransition(.zoom(sourceID:in:))` on the pushed screen.
+ * Zoom navigation connects a MatchedTransitionSource to a screen configured with a zoom transition.
  *
  * A push whose screen asks for a zoom, and whose source is on screen in the screen it covers, grows
  * out of the source instead of sliding in. Its pop (the back button) and a downward drag on the
@@ -116,7 +115,7 @@ export function visibleZoomSource(entryKey, rear, excluded) {
     }
     return chosen?.view;
 }
-/** SwiftUI zooms only from a source the user can see: at least part of it in the viewport. */
+/** Zoom transitions require a visible source: at least part of it in the viewport. */
 function isOnScreen(view) {
     const bounds = view.getBoundingClientRect();
     if (!(bounds.width > 0 && bounds.height > 0))
@@ -950,7 +949,7 @@ export function windowKeyframes(from, to, springs, velocity) {
     frames.push({ ms: frames.at(-1).ms + FRAME_MS, rect: to });
     return frames;
 }
-/** A measured Core Animation spring as Satin's `Animation` (SwiftUI's duration/bounce mapping is
+/** A measured Core Animation spring as Satin's `Animation` (the duration/bounce representation is
  * exact: omega = 2π / duration, damping ratio = 1 − bounce). */
 function animationOf(spring) {
     return SpringAnimation.spring({