gesso-core 0.6.19 → 0.6.20

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as isImeKey, $a as MOUSE_POINTER, $i as spacingEqual, $n as ELLIPSIS, $r as transformsEqual, $t as registerFontStack, A as withOverrideSource, Aa as colorToHex, Ai as observeViewportInsets, An as clearLinkHover, Ar as inheritedPropertyNames, At as adjacentField, B as FlexDirection, Ba as UiEnvironment, Bi as defineThemeExtension, Bn as editorFor, Br as normalizeStates, Bt as createCanvasTextStyle, C as SCROLLBAR_LINGER_MS, Ca as textContentOf, Ci as uniformBorderRadius, Cn as isNodeInert, Cr as resolveProperty, Ct as hasDrawnText, D as formatExplanation, Da as darkColors, Di as UiInsetRegistry, Dn as isSubtreeInert, Dr as findPropertyDefinition, Dt as selectionRectsIn, E as formatConstraints, Ea as colorsEqualPalette, Ei as UiEnvironmentKeys, En as isPressable, Er as closestPropertyName, Et as paragraphGeometryFrom, F as clampSize, Fa as parseColor, Fi as darkTheme, Fn as setLinkHover, Fr as UiProperties, Ft as detectEditingPlatform, G as CrossAxisAlignment, Ga as resetOverrideWarnings, Gi as withThemeExtension, Gn as nextCaretToggle, Gr as validateSubgrid, Gt as runFontString, H as placeGridItems, Ha as DirtyNodeSet, Hi as noThemeExtensions, Hn as isEditableNode, Hr as validateRole, Ht as fillTextRects, I as constraintsEqual, Ia as rgb8, Ii as lightTheme, In as CARET_BLINK_MS, Ir as UI_ROLES, It as isPrintable, J as parseCrossAxisAlignment, Ja as UiVisualState, Ji as raiseContrast, Jn as isVideoSurface, Jr as pathValuesEqual, Jt as textRunBackgrounds, K as MainAxisAlignment, Ka as writeDeclaredProperty, Ki as contrastRatio, Kn as syncEditorValue, Kr as inputsEqual, Kt as spanOf, L as tightenConstraints, La as rgba, Li as themesEqual, Ln as CARET_WIDTH, Lr as UI_SEMANTIC_STATES, Lt as EditableLayout, M as contentOffset, Ma as colorValuesEqual, Mi as bandOf, Mn as linkHoverOf, Mr as propertyIsInherited, Mt as edgeField, N as LayoutRecord, Na as colorsEqual, Ni as containerBands, Nn as linkOf, Nr as propertyNarrowers, Nt as editingGroupOf, O as formatNumber, Oa as lightColors, Oi as insetsEqual, On as pointerEventsOf, Or as getPropertyNames, Ot as wordRangeIn, P as Constraints, Pa as normalizeColor, Pi as unknownContainerSize, Pn as linkRunAtPointIn, Pr as propertyValuesEqualByName, Pt as commandForKey, Q as capturePointer, Qa as visualStatesEqual, Qi as scaleSpacing, Qn as spannedRunsFor, Qr as transformIsIdentity, Qt as fontStackFor, R as MAX_MEASURES_PER_CHILD, Ra as createEnvironmentKey, Ri as withContrast, Rn as EDITOR_PROP, Rr as isUiRole, Rt as applyCanvasTextStyle, S as SCROLLBAR_FADE_MS, Sa as spansDifferOnlyInPaint, Si as normalizeBorderRadius, Sn as isNodeHitTestable, Sr as resolveNumber, St as UiInputDispatcher, T as describeOverrides, Ta as textStylesEqual, Ti as propertyValuesEqual, Tn as isNodeTabStop, Tr as resolveString, Tt as paragraphGeometry, U as sizeGridTracks, Ua as clearOverrideProperty, Ui as themeExtension, Un as isMultiline, Ur as validateStates, Ut as layoutTextLines, V as parseFlexDirection, Va as UiNode, Vi as hasThemeExtension, Vn as editorOf, Vr as statesEqual, Vt as drawText, W as AlignContent, Wa as overrideSources, Wi as themeExtensionsEqual, Wn as isReadOnly, Wr as UI_SUBGRID_AXES, Wt as runCanvasStyleInto, X as CanvasPlatformSurface, Xa as hasVisualState, Xi as densityFactors, Xn as CharacterCountTextMeasurer, Xr as parseTransform, Xt as bumpFontStack, Y as parseMainAxisAlignment, Ya as defaultVisualState, Yi as relativeLuminance, Yn as videoFrameSize, Yr as UiTransforms, Yt as textRunDecorations, Z as UiPlatformAdapter, Za as visualState, Zi as defaultSpacing, Zn as ParagraphTextMeasurer, Zr as transform, Zt as clearFontStacks, _ as LABEL_PADDING_X, _a as flattenTextSpans, _i as borderRadius, _n as selectableTextNodes, _o as DirtyFlags, _r as previousWordStart, _t as scrollLeaderOf, a as PaintPictureCache, aa as boxShadowArraysEqual, ai as validateGradient, an as computeObjectFitRect, ao as UiInputEvent, ar as lineLimit, at as UiGestureRecognizer, b as snapScroll, ba as spanAtOffset, bi as borderRadiusIsZero, bn as setSelectionRange, br as DEFAULT_LINE_HEIGHT_FACTOR, bt as scrollbarThumbs, c as EMPTY_RECORDING, ca as boxShadowsEqual, ci as isAutoLength, cn as normalizeTextAlign, co as UiPinchEvent, cr as offsetForVerticalMove, ct as isScrollContainer, d as tracePathData, da as shapesEqual, di as isPercentLength, dn as TEXT_MATCHES_PROP, do as UiTextChangeEvent, dr as graphemeBoundaries, dt as UiFocusManager, ea as spacingSteps, ei as MAX_GRADIENT_STOPS, en as DEFAULT_FONT_FAMILY, eo as UiBeforeInputEvent, er as layoutParagraph, et as pointerDeviceOf, f as ScaledImageCache, fa as defaultTypography, fi as minmax, fn as clearMatchRanges, fo as UiWheelDeltaMode, fr as lineEndAt, ft as UiHitTester, g as paintsAfterChildren, ga as editableSpansOf, gi as UiBorderRadiuses, gn as clearSelectionRange, go as UiNodeType, gr as previousGraphemeStart, gt as SCROLLBAR_THICKNESS, h as hasDecorationPhase, ha as defaultTextStyle, hi as resolveLength, hn as TEXT_SELECTION_PROP, ho as wheelDeltaYOf, hr as nextWordEnd, ht as SCROLLBAR_MIN_THUMB, i as traceRoundedRect, ia as boxShadow, ii as radialGradient, in as colorToCss, io as UiGestureEvent, ir as lineIndexForOffset, it as UiTouchScroller, j as accumulatedOffsetTo, ja as colorToRgba, ji as UiContainerSizeSource, jn as hasTextLinks, jr as propertyEffects, jt as comparePositions, k as labelNode, ka as UiBasicColors, ki as noInsets, kn as resolveCursor, kr as inheritedPropertyFlags, kt as textInputOf, l as PaintRecorder, la as defaultShapes, li as isFrLength, ln as normalizeVerticalAlign, lo as UiPointerEvent, lr as selectionRects, lt as UiKeyboardController, m as decorationRect, ma as typographyEqual, mi as repeat, mn as setMatchRanges, mo as noKeyModifiers, mr as nextGraphemeEnd, mt as SCROLLBAR_INSET, n as createCanvasSurface, na as shadowsEqual, ni as gradientsEqual, nn as DEFAULT_FONT_WEIGHT, no as UiEventType, nr as caretRectFor, nt as touchActionFor, o as paintPictures, oa as boxShadowRadius, oi as auto, on as createPaintState, oo as UiKeyboardEvent, or as offsetAtPoint, ot as UiPinchRecognizer, p as decorationColor, pa as isTypographyRole, pi as percent, pn as matchRangesOf, po as UiWheelEvent, pr as lineStartAt, pt as SCROLLBAR_HOVER_ZONE, q as parseAlignContent, qa as writeOverrideProperty, qi as highContrastColors, qn as resolveColorValue, qr as paintValuesEqual, qt as textMeasureRequest, r as Canvas2DRenderer, ra as BOX_SHADOW_BLUR_REACH, ri as linearGradient, rn as DEFAULT_TEXT_COLOR, ro as UiFocusEvent, rr as lineIndexAtY, rt as UiEditingController, s as PaintTarget, sa as boxShadowReach, si as fr, sn as isPaintVisible, so as UiPasteEvent, sr as offsetAtX, st as UiWheelController, t as CanvasSurface, ta as defaultShadows, ti as gradientPaint, tn as DEFAULT_FONT_SIZE, to as UiCompositionEvent, tr as proportionalFontMetrics, tt as prepareInputSurface, u as replayPaint, ua as isShapeName, ui as isMinMaxTrack, un as resolvePaintState, uo as UiSelectionChangeEvent, ur as EditableTextModel, ut as UiPointerController, v as drawOverlayShapes, va as hiddenRangesOf, vi as borderRadiusCorners, vn as selectableTextOf, vo as UiBinding, vr as wordRangeAt, vt as scrollRange, w as describeLength, wa as textSpansEqual, wi as defineProperty, wn as isNodeSelectable, wr as resolvePropertyByName, wt as offsetAtPointIn, x as LayoutEngine, xa as spannedTextOf, xi as borderRadiusValuesEqual, xn as isNodeFocusable, xr as resolveBoolean, xt as scrollbarZoneAt, y as labelOrigin, ya as resolvedSpansOf, yi as borderRadiusEqual, yn as selectionRangeOf, yr as UiGraph, yt as scrollbarThumb, z as isLayoutProtocol, za as findEnvironmentKey, zi as withDensity, zn as caretVisibleAt, zr as isUiSemanticState, zt as buildFontString } from "./CanvasSurface-tAao5BLh.js";
+import { $ as isImeKey, $a as MOUSE_POINTER, $i as spacingEqual, $n as ELLIPSIS, $r as transformsEqual, $t as registerFontStack, A as withOverrideSource, Aa as colorToHex, Ai as observeViewportInsets, An as clearLinkHover, Ar as inheritedPropertyNames, At as adjacentField, B as FlexDirection, Ba as UiEnvironment, Bi as defineThemeExtension, Bn as editorFor, Br as normalizeStates, Bt as createCanvasTextStyle, C as SCROLLBAR_LINGER_MS, Ca as textContentOf, Ci as uniformBorderRadius, Cn as isNodeInert, Cr as resolveProperty, Ct as hasDrawnText, D as formatExplanation, Da as darkColors, Di as UiInsetRegistry, Dn as isSubtreeInert, Dr as findPropertyDefinition, Dt as selectionRectsIn, E as formatConstraints, Ea as colorsEqualPalette, Ei as UiEnvironmentKeys, En as isPressable, Er as closestPropertyName, Et as paragraphGeometryFrom, F as clampSize, Fa as parseColor, Fi as darkTheme, Fn as setLinkHover, Fr as UiProperties, Ft as detectEditingPlatform, G as CrossAxisAlignment, Ga as resetOverrideWarnings, Gi as withThemeExtension, Gn as nextCaretToggle, Gr as validateSubgrid, Gt as runFontString, H as placeGridItems, Ha as DirtyNodeSet, Hi as noThemeExtensions, Hn as isEditableNode, Hr as validateRole, Ht as fillTextRects, I as constraintsEqual, Ia as rgb8, Ii as lightTheme, In as CARET_BLINK_MS, Ir as UI_ROLES, It as isPrintable, J as parseCrossAxisAlignment, Ja as UiVisualState, Ji as raiseContrast, Jn as isVideoSurface, Jr as pathValuesEqual, Jt as textRunBackgrounds, K as MainAxisAlignment, Ka as writeDeclaredProperty, Ki as contrastRatio, Kn as syncEditorValue, Kr as inputsEqual, Kt as spanOf, L as tightenConstraints, La as rgba, Li as themesEqual, Ln as CARET_WIDTH, Lr as UI_SEMANTIC_STATES, Lt as EditableLayout, M as contentOffset, Ma as colorValuesEqual, Mi as bandOf, Mn as linkHoverOf, Mr as propertyIsInherited, Mt as edgeField, N as LayoutRecord, Na as colorsEqual, Ni as containerBands, Nn as linkOf, Nr as propertyNarrowers, Nt as editingGroupOf, O as formatNumber, Oa as lightColors, Oi as insetsEqual, On as pointerEventsOf, Or as getPropertyNames, Ot as wordRangeIn, P as Constraints, Pa as normalizeColor, Pi as unknownContainerSize, Pn as linkRunAtPointIn, Pr as propertyValuesEqualByName, Pt as commandForKey, Q as capturePointer, Qa as visualStatesEqual, Qi as scaleSpacing, Qn as spannedRunsFor, Qr as transformIsIdentity, Qt as fontStackFor, R as MAX_MEASURES_PER_CHILD, Ra as createEnvironmentKey, Ri as withContrast, Rn as EDITOR_PROP, Rr as isUiRole, Rt as applyCanvasTextStyle, S as SCROLLBAR_FADE_MS, Sa as spansDifferOnlyInPaint, Si as normalizeBorderRadius, Sn as isNodeHitTestable, Sr as resolveNumber, St as UiInputDispatcher, T as describeOverrides, Ta as textStylesEqual, Ti as propertyValuesEqual, Tn as isNodeTabStop, Tr as resolveString, Tt as paragraphGeometry, U as sizeGridTracks, Ua as clearOverrideProperty, Ui as themeExtension, Un as isMultiline, Ur as validateStates, Ut as layoutTextLines, V as parseFlexDirection, Va as UiNode, Vi as hasThemeExtension, Vn as editorOf, Vr as statesEqual, Vt as drawText, W as AlignContent, Wa as overrideSources, Wi as themeExtensionsEqual, Wn as isReadOnly, Wr as UI_SUBGRID_AXES, Wt as runCanvasStyleInto, X as CanvasPlatformSurface, Xa as hasVisualState, Xi as densityFactors, Xn as CharacterCountTextMeasurer, Xr as parseTransform, Xt as bumpFontStack, Y as parseMainAxisAlignment, Ya as defaultVisualState, Yi as relativeLuminance, Yn as videoFrameSize, Yr as UiTransforms, Yt as textRunDecorations, Z as UiPlatformAdapter, Za as visualState, Zi as defaultSpacing, Zn as ParagraphTextMeasurer, Zr as transform, Zt as clearFontStacks, _ as LABEL_PADDING_X, _a as flattenTextSpans, _i as borderRadius, _n as selectableTextNodes, _o as DirtyFlags, _r as previousWordStart, _t as scrollLeaderOf, a as PaintPictureCache, aa as boxShadowArraysEqual, ai as validateGradient, an as computeObjectFitRect, ao as UiInputEvent, ar as lineLimit, at as UiGestureRecognizer, b as snapScroll, ba as spanAtOffset, bi as borderRadiusIsZero, bn as setSelectionRange, br as DEFAULT_LINE_HEIGHT_FACTOR, bt as scrollbarThumbs, c as EMPTY_RECORDING, ca as boxShadowsEqual, ci as isAutoLength, cn as normalizeTextAlign, co as UiPinchEvent, cr as offsetForVerticalMove, ct as isScrollContainer, d as tracePathData, da as shapesEqual, di as isPercentLength, dn as TEXT_MATCHES_PROP, do as UiTextChangeEvent, dr as graphemeBoundaries, dt as UiFocusManager, ea as spacingSteps, ei as MAX_GRADIENT_STOPS, en as DEFAULT_FONT_FAMILY, eo as UiBeforeInputEvent, er as layoutParagraph, et as pointerDeviceOf, f as ScaledImageCache, fa as defaultTypography, fi as minmax, fn as clearMatchRanges, fo as UiWheelDeltaMode, fr as lineEndAt, ft as UiHitTester, g as paintsAfterChildren, ga as editableSpansOf, gi as UiBorderRadiuses, gn as clearSelectionRange, go as UiNodeType, gr as previousGraphemeStart, gt as SCROLLBAR_THICKNESS, h as hasDecorationPhase, ha as defaultTextStyle, hi as resolveLength, hn as TEXT_SELECTION_PROP, ho as wheelDeltaYOf, hr as nextWordEnd, ht as SCROLLBAR_MIN_THUMB, i as traceRoundedRect, ia as boxShadow, ii as radialGradient, in as colorToCss, io as UiGestureEvent, ir as lineIndexForOffset, it as UiTouchScroller, j as accumulatedOffsetTo, ja as colorToRgba, ji as UiContainerSizeSource, jn as hasTextLinks, jr as propertyEffects, jt as comparePositions, k as labelNode, ka as UiBasicColors, ki as noInsets, kn as resolveCursor, kr as inheritedPropertyFlags, kt as textInputOf, l as PaintRecorder, la as defaultShapes, li as isFrLength, ln as normalizeVerticalAlign, lo as UiPointerEvent, lr as selectionRects, lt as UiKeyboardController, m as decorationRect, ma as typographyEqual, mi as repeat, mn as setMatchRanges, mo as noKeyModifiers, mr as nextGraphemeEnd, mt as SCROLLBAR_INSET, n as createCanvasSurface, na as shadowsEqual, ni as gradientsEqual, nn as DEFAULT_FONT_WEIGHT, no as UiEventType, nr as caretRectFor, nt as touchActionFor, o as paintPictures, oa as boxShadowRadius, oi as auto, on as createPaintState, oo as UiKeyboardEvent, or as offsetAtPoint, ot as UiPinchRecognizer, p as decorationColor, pa as isTypographyRole, pi as percent, pn as matchRangesOf, po as UiWheelEvent, pr as lineStartAt, pt as SCROLLBAR_HOVER_ZONE, q as parseAlignContent, qa as writeOverrideProperty, qi as highContrastColors, qn as resolveColorValue, qr as paintValuesEqual, qt as textMeasureRequest, r as Canvas2DRenderer, ra as BOX_SHADOW_BLUR_REACH, ri as linearGradient, rn as DEFAULT_TEXT_COLOR, ro as UiFocusEvent, rr as lineIndexAtY, rt as UiEditingController, s as PaintTarget, sa as boxShadowReach, si as fr, sn as isPaintVisible, so as UiPasteEvent, sr as offsetAtX, st as UiWheelController, t as CanvasSurface, ta as defaultShadows, ti as gradientPaint, tn as DEFAULT_FONT_SIZE, to as UiCompositionEvent, tr as proportionalFontMetrics, tt as prepareInputSurface, u as replayPaint, ua as isShapeName, ui as isMinMaxTrack, un as resolvePaintState, uo as UiSelectionChangeEvent, ur as EditableTextModel, ut as UiPointerController, v as drawOverlayShapes, va as hiddenRangesOf, vi as borderRadiusCorners, vn as selectableTextOf, vo as UiBinding, vr as wordRangeAt, vt as scrollRange, w as describeLength, wa as textSpansEqual, wi as defineProperty, wn as isNodeSelectable, wr as resolvePropertyByName, wt as offsetAtPointIn, x as LayoutEngine, xa as spannedTextOf, xi as borderRadiusValuesEqual, xn as isNodeFocusable, xr as resolveBoolean, xt as scrollbarZoneAt, y as labelOrigin, ya as resolvedSpansOf, yi as borderRadiusEqual, yn as selectionRangeOf, yr as UiGraph, yt as scrollbarThumb, z as isLayoutProtocol, za as findEnvironmentKey, zi as withDensity, zn as caretVisibleAt, zr as isUiSemanticState, zt as buildFontString } from "./CanvasSurface-VUJRrcXl.js";
 import { BehaviorSubject, EMPTY, Subject, combineLatest, distinctUntilChanged, isObservable as isObservable$1, map, of } from "rxjs";
 //#region src/animation/UiEasing.ts
 /** Progress equals time. What a spinner and a sweep want. */
@@ -2200,6 +2200,15 @@ function describeValueType(value) {
 var UiGraphBuilder = class {
 	graph;
 	refs = /* @__PURE__ */ new Map();
+	/**
+	* The definition each node was last reconciled from. A definition is
+	* a description that is never changed once made, so the same object
+	* again has nothing new to say: a lazy list hands back the row it made
+	* for an index on every scroll, and reconciling seventy unchanged rows
+	* (their props, then every node of each row's component) to mount the
+	* four that scrolled in cost a 165 Hz frame its budget.
+	*/
+	reconciledFrom = /* @__PURE__ */ new WeakMap();
 	modifiers = /* @__PURE__ */ new Map();
 	nextChildrenBindingId = 0;
 	/**
@@ -2340,9 +2349,12 @@ var UiGraphBuilder = class {
 				changed = true;
 			} else {
 				matched.add(node);
-				this.reconcileProps(node, definition.props);
-				if (this.reconcileChildren(node, definition.children).changed) changed = true;
+				if (this.reconciledFrom.get(node) !== definition) {
+					this.reconcileProps(node, definition.props);
+					if (this.reconcileChildren(node, definition.children).changed) changed = true;
+				}
 			}
+			this.reconciledFrom.set(node, definition);
 			if (this.moveBefore(parent, node, cursor)) changed = true;
 			cursor = node.nextSibling;
 			result.push(node);
@@ -2412,8 +2424,12 @@ var UiGraphBuilder = class {
 		if (anchor === void 0) {
 			anchor = this.graph.createNode(anchorId, "fragment");
 			this.graph.insertBefore(parent, anchor, cursor);
-		} else matched.add(anchor);
+		} else {
+			matched.add(anchor);
+			if (this.reconciledFrom.get(anchor) === element) return anchor;
+		}
 		this.reconcileChildren(anchor, [resolver.resolve(element, anchorId)]);
+		this.reconciledFrom.set(anchor, element);
 		return anchor;
 	}
 	/**
@@ -2519,8 +2535,7 @@ var UiGraphBuilder = class {
 			return true;
 		}
 		if (node === reference || node.nextSibling === reference) return false;
-		this.graph.detachNode(node);
-		this.graph.insertBefore(parent, node, reference);
+		this.graph.moveWithin(node, reference);
 		return true;
 	}
 	/**
@@ -2810,6 +2825,15 @@ var UiVirtualWindow = class {
 	count;
 	estimate;
 	overscan;
+	recycle;
+	/**
+	* The slot each mounted item is keyed by, when recycling: an item keeps
+	* its slot while it stays, and one leaving gives its slot to the next
+	* one to come, whose element then matches the node it leaves behind.
+	*/
+	slotOf = /* @__PURE__ */ new Map();
+	freeSlots = [];
+	nextSlot = 0;
 	keyOf;
 	renderItem;
 	grid;
@@ -2841,6 +2865,7 @@ var UiVirtualWindow = class {
 		this.count = count;
 		this.estimate = options.estimatedExtent;
 		this.overscan = options.overscan ?? 3;
+		this.recycle = options.recycle === true;
 		this.keyOf = options.key ?? ((index) => index);
 		this.renderItem = renderItem;
 		this.grid = options.grid;
@@ -3027,6 +3052,13 @@ var UiVirtualWindow = class {
 		});
 	}
 	buildChildren() {
+		if (this.recycle) {
+			for (const [index, slot] of this.slotOf) if (index < this.first || index > this.last) {
+				this.slotOf.delete(index);
+				this.freeSlots.push(slot);
+			}
+			for (let index = this.first; index <= this.last; index++) if (!this.slotOf.has(index)) this.slotOf.set(index, this.freeSlots.pop() ?? this.nextSlot++);
+		}
 		const children = [];
 		if (this.grid?.header !== void 0) children.push(markRow(this.grid.header, {
 			key: "lazy:header",
@@ -3080,7 +3112,7 @@ var UiVirtualWindow = class {
 	*/
 	wrap(index, item) {
 		const props = {
-			key: `lazy:${String(this.keyOf(index))}`,
+			key: this.recycle ? `lazy:slot:${this.slotOf.get(index)}` : `lazy:${String(this.keyOf(index))}`,
 			[VIRTUAL_INDEX_PROP]: index
 		};
 		if (this.grid !== void 0) return markRow(item, props, `Row ${index} of`);
@@ -3200,11 +3232,12 @@ function LazyGrid(props, renderRow) {
 	});
 }
 function lazyList(axis, props, renderItem, grid) {
-	const { count, estimatedExtent, overscan, itemKey, initialViewportExtent, revision, modifiers, windowRef, ...rest } = props;
+	const { count, estimatedExtent, overscan, recycle, itemKey, initialViewportExtent, revision, modifiers, windowRef, ...rest } = props;
 	const window = new UiVirtualWindow(axis, {
 		count,
 		estimatedExtent,
 		overscan,
+		recycle,
 		key: itemKey,
 		initialViewportExtent,
 		revision,
@@ -14375,6 +14408,26 @@ var UiTimerFrameClock = class {
 * has had one for years, and a *nested* worker on Chromium has not.
 * The feature test is the whole guard; there is no version to compare.
 */
+/** This thread's refreshes seen before they are compared with the display's. */
+const LOCAL_SAMPLES = 8;
+/** The host's refreshes the beat's phase is read from: about a sixth of a second at 120 Hz. */
+const BEAT_SAMPLES = 20;
+/** Frames whose cost decides the stride. */
+const COST_SAMPLES = 30;
+/** Frames seen before the stride is lengthened. */
+const SLOW_SAMPLES = 12;
+/** A frame costing more than this share of its refreshes is too slow for them. */
+const SLOW_FRAME = .75;
+/** And less than this share of one fewer is cheap enough to take one fewer. */
+const FAST_FRAME = .6;
+/** How far off the measured interval the refreshes must come to be another display's, as a fraction. */
+const NEW_DISPLAY = .15;
+/** Times the interval is read again on its own result. */
+const BEAT_PASSES = 3;
+/** Refreshes apart the two an interval is read between must be, at least. */
+const MIN_BEAT_SPAN = 6;
+/** The most refreshes a frame is given: two, sixty at 120 Hz; slower than that is no smoother. */
+const MAX_STRIDE = 2;
 function localAnimationFrame() {
 	const host = globalThis;
 	return typeof host.requestAnimationFrame === "function" ? host.requestAnimationFrame.bind(host) : null;
@@ -14420,6 +14473,28 @@ var UiHostFrameClock = class {
 	/** This thread's own `requestAnimationFrame`, or null where there is none. */
 	local;
 	localHandle = null;
+	timeOrigin;
+	/** Gaps between this thread's own refreshes while frames ran back to back. */
+	localIntervals = [];
+	lastLocalTime = null;
+	/** The display's interval and the host's time origin, once the host has said. */
+	display = null;
+	/**
+	* Set once this thread's refreshes have shown they keep no display's
+	* time: frames are then timed here, on the beat the host's refreshes
+	* show (see \`displayInterval\`).
+	*/
+	locked = false;
+	/** The host's recent refresh times, which give the beat its phase. */
+	refreshes = [];
+	/** Host refreshes since the last frame drawn on the beat. */
+	refreshesSinceFrame = 0;
+	/** The refresh the last frame here was drawn for: a frame is never drawn for one twice. */
+	lastLocked = -Infinity;
+	/** How long recent frames took here, which decides how many refreshes each one gets. */
+	costs = [];
+	/** Refreshes per frame on the beat: 1, or more when frames cost more than a refresh can hold. */
+	stride = 1;
 	constructor(onFrame, onActive, options = {}) {
 		this.onFrame = onFrame;
 		this.onActive = onActive;
@@ -14428,6 +14503,7 @@ var UiHostFrameClock = class {
 		this.minStallMs = options.minStallMs ?? 12;
 		this.now = options.now ?? (() => performance.now());
 		this.local = options.requestAnimationFrame === void 0 ? localAnimationFrame() : options.requestAnimationFrame;
+		this.timeOrigin = options.timeOrigin ?? (typeof performance !== "undefined" ? performance.timeOrigin : 0);
 	}
 	/** Whether this clock is driving itself from the compositor. */
 	get isLocal() {
@@ -14438,6 +14514,7 @@ var UiHostFrameClock = class {
 		if (this.local !== null) {
 			if (this.localHandle === null) this.localHandle = this.local((time) => {
 				this.localHandle = null;
+				this.recordLocal(time);
 				if (this.pending) this.deliver(time);
 			});
 			return;
@@ -14446,6 +14523,157 @@ var UiHostFrameClock = class {
 		this.armTimer();
 	}
 	/**
+	* Tells the clock the display's interval, measured on the host's own
+	* refreshes, and the host's \`timeOrigin\`, which puts the host's frame
+	* times on this thread's clock.
+	*
+	* A worker's own refreshes are not always the display's. WebKit's come
+	* from a timer near 65 Hz that keeps no display's time: on a 120 Hz
+	* MacBook its frames fell 15 to 16.4 ms apart, so each was shown after
+	* one refresh, two or three, and a scroll juddered at a steady sixty.
+	* Driving frames from the host's ticks instead put the host's thread in
+	* every frame, and WebKit's is uneven while scrolling: at 120 a seventh
+	* of the frames missed their refresh. So once this thread's refreshes
+	* have shown they keep no display's time, frames follow the host's
+	* refreshes, which are the only ones a worker's canvas is shown on in
+	* WebKit anyway, with two differences from a plain hosted clock: each
+	* frame is stamped with its refresh on the display's beat and on this
+	* thread's clock, which is the clock a wheel step's time is on; and
+	* frames too costly for one refresh are given an even two (see
+	* \`recordCost\`).
+	*/
+	displayInterval(ms, origin) {
+		if (ms > 0 && ms < MAX_CADENCE_MS) {
+			this.display = {
+				interval: ms,
+				origin
+			};
+			this.compareLocal();
+		}
+	}
+	/** Whether frames are timed here on the display's beat; see \`displayInterval\`. */
+	get isDisplayLocked() {
+		return this.locked;
+	}
+	recordLocal(time) {
+		const previous = this.lastLocalTime;
+		this.lastLocalTime = time;
+		if (previous !== null && this.pending) {
+			const interval = time - previous;
+			if (interval > 0 && interval < MAX_CADENCE_MS) {
+				this.localIntervals.push(interval);
+				if (this.localIntervals.length > LOCAL_SAMPLES) this.localIntervals.shift();
+			}
+		}
+		this.compareLocal();
+	}
+	/**
+	* Gives this thread's refreshes up when they come well slower than the
+	* display's: they cost frames, and in WebKit keep no display's beat
+	* either. Faster than the display is left alone, because that is the
+	* display the measurement was taken on going stale (a window dragged to
+	* a faster screen), not a worker failing to keep up with it.
+	*/
+	compareLocal() {
+		if (this.local === null || this.display === null || this.localIntervals.length < LOCAL_SAMPLES) return;
+		const sorted = [...this.localIntervals].sort((a, b) => a - b);
+		if (sorted[Math.floor(sorted.length / 2)] / this.display.interval <= 1.06) return;
+		this.local = null;
+		this.locked = true;
+	}
+	/** A time on the host's clock, on this thread's. */
+	toLocal(host) {
+		return this.display === null ? host : host - this.timeOrigin + this.display.origin;
+	}
+	/**
+	* When the display's refreshes start, on the host's clock: the earliest
+	* in phase of the host's recent refresh times, since a host's callback
+	* can only run late, never early.
+	*/
+	beat() {
+		if (this.display === null || this.refreshes.length === 0) return null;
+		const cadence = this.cadenceMs();
+		let interval = cadence !== null && Math.abs(cadence - this.display.interval) > this.display.interval * NEW_DISPLAY ? cadence : this.display.interval;
+		for (let pass = 0; pass < BEAT_PASSES; pass++) interval = this.refineInterval(interval);
+		const latest = this.refreshes[this.refreshes.length - 1];
+		let earliest = Infinity;
+		for (const time of this.refreshes) {
+			let residual = ((time - latest) % interval + interval) % interval;
+			if (residual > interval / 2) residual -= interval;
+			earliest = Math.min(earliest, residual);
+		}
+		return {
+			start: latest + earliest,
+			interval
+		};
+	}
+	/** The interval between the most punctual early and late refreshes, judged by `rough`. */
+	refineInterval(rough) {
+		const half = Math.floor(this.refreshes.length / 2);
+		const first = this.refreshes[0];
+		let early = null;
+		let late = null;
+		let index = 0;
+		for (let i = 0; i < this.refreshes.length; i++) {
+			const time = this.refreshes[i];
+			if (i > 0) index += Math.max(1, Math.round((time - this.refreshes[i - 1]) / rough));
+			const residual = time - first - index * rough;
+			if (i < half) {
+				if (early === null || residual < early.residual) early = {
+					index,
+					residual,
+					time
+				};
+			} else if (late === null || residual < late.residual) late = {
+				index,
+				residual,
+				time
+			};
+		}
+		return early !== null && late !== null && late.index - early.index >= MIN_BEAT_SPAN ? (late.time - early.time) / (late.index - early.index) : rough;
+	}
+	/**
+	* Draws the frame a host refresh asked for, stamped with that refresh on
+	* the display's beat rather than with when its callback happened to run,
+	* and on this thread's clock.
+	*/
+	deliverOnBeat(time) {
+		const beat = this.beat();
+		let refresh = time - ((time - beat.start) % beat.interval + beat.interval) % beat.interval;
+		while (refresh < this.lastLocked + (this.stride - .5) * beat.interval) refresh += beat.interval;
+		this.lastLocked = refresh;
+		this.refreshesSinceFrame = 0;
+		const started = this.now();
+		this.deliver(this.toLocal(refresh));
+		this.recordCost(this.now() - started, beat.interval);
+	}
+	/**
+	* Keeps the stride to what frames cost: every refresh while the typical
+	* frame fits in most of one, two once it no longer does. Decided by the
+	* typical frame, not the slow ones: a slow frame (a few rows mounted at
+	* once) shown a refresh late is a moment's hitch, where two refreshes a
+	* frame for a whole scroll halves the rate. Ruled by the slow quarter,
+	* a 165 Hz display drew at 82 with its typical frame in half a refresh.
+	*/
+	recordCost(cost, interval) {
+		this.costs.push(cost);
+		if (this.costs.length > COST_SAMPLES) this.costs.shift();
+		if (this.costs.length < SLOW_SAMPLES) return;
+		const sorted = [...this.costs].sort((a, b) => a - b);
+		const typical = sorted[Math.floor(sorted.length / 2)];
+		if (typical > interval * this.stride * SLOW_FRAME && this.stride < MAX_STRIDE) {
+			this.stride++;
+			this.costs.length = 0;
+		} else if (this.stride > 1 && this.costs.length >= COST_SAMPLES && typical < interval * (this.stride - 1) * FAST_FRAME) {
+			this.stride--;
+			this.costs.length = 0;
+		}
+	}
+	/** Refreshes per frame while timed on the display's beat; see \`recordCost\`. */
+	get displayStride() {
+		return this.stride;
+	}
+	/**
 	* Arms the timer that draws a frame the host did not ask for.
 	*
 	* It plays two roles with one mechanism. Before any tick has arrived
@@ -14471,7 +14699,7 @@ var UiHostFrameClock = class {
 			this.handle = null;
 			if (!this.pending) return;
 			this.stalled = this.hosted;
-			this.deliver(this.hostTime());
+			this.deliver(this.locked ? this.now() : this.hostTime());
 		}, watching ? this.watchMs() : this.selfPaceMs());
 	}
 	/**
@@ -14572,6 +14800,17 @@ var UiHostFrameClock = class {
 		this.stalled = false;
 		this.hostOffset = time - this.now();
 		this.recordCadence(time);
+		if (this.locked && this.display !== null) {
+			this.refreshes.push(time);
+			if (this.refreshes.length > BEAT_SAMPLES) this.refreshes.shift();
+			this.refreshesSinceFrame++;
+			if (this.pending) {
+				this.clearFallback();
+				this.idleTicks = 0;
+				if (this.refreshesSinceFrame >= this.stride) this.deliverOnBeat(time);
+				return;
+			}
+		}
 		this.clearFallback();
 		if (!this.pending) {
 			this.idleTicks++;