gesso-core 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # gesso-core
 
+## 0.4.0
+
+### Minor Changes
+
+- **`DoubleClick`, dispatched after a second Click on the same node.** The pointer
+  controller pairs Clicks on the same node within 500 ms and 4 px — the window the
+  editing and selection controllers already use for a word — and dispatches
+  `DoubleClick` after the second, as the DOM's `dblclick` follows its `click`. A
+  press that became a drag or was cancelled spends the pair.
+
+  `onDoubleClick` on any element; `fireEvent` gains `doubleClick` and
+  `contextMenu`.
+
+- **A menu opened at a point stays on the screen.** A context menu's point was a
+  top and a left and nothing more, so a menu asked for near the bottom or right
+  edge opened off the screen.
+
+  The layout engine gains `anchorPoint`, a point placed beside as an anchor of no
+  size would be — the same flip and clamp — and overlays a `point` option that
+  uses it. `Menu`'s `at` opens below and to the right of the point, and above or
+  to the left when there is no room.
+
+  Found by a spreadsheet's status bar, whose menu opened below the window.
+
+### Patch Changes
+
+- **An absolute box past its containing block keeps its explicit size.** With no
+  room left on an axis, the loose constraint an absolute child was measured under
+  came out `(0, 0)`, which reads as tight, and a box with an explicit width or
+  height was laid out at zero on that axis — where one pixel of room would have
+  left it whole.
+
+  An explicit size is the box's own, as in CSS; the block no longer caps it.
+
+- **The browser shells post OS file drops.** The `fileDrop` message, its shape and
+  the session that turns it into an ordinary drag have existed since drop targets
+  did, and nothing posted one: a zone accepting `gesso/files` could be written and
+  never reached.
+
+  `attachFileDrop` is the shell half, shared by `createApp`'s worker shell and
+  `createSyncApp`'s single-thread one because it is the same four DOM events
+  either way. It answers drags that carry files and no others, prevents the
+  default on every `dragover` (which is what tells a browser the drop is wanted)
+  and on `drop` (or the tab is replaced by the file), and reads the bytes before
+  posting the drop. The worker shell transfers the buffers rather than copying
+  them; a drop whose files cannot be read is reported as a leave, so no zone stays
+  lit waiting. `GessoRuntime.applyFileDrop` hands the message to the tree's drag
+  session.
+
+  The core half was wrong in a way no spec could have caught: `applyFileDrop` began
+  a drag with the files of `enter` and, on `drop`, only moved it, so a zone
+  received the payload the drag started with. A browser lets a page see the _types_
+  of dragged files and nothing else until they are let go, so that payload has
+  empty names and no bytes — every file dropped from a desktop would have arrived
+  unopenable. The spec that covered it sent the same files on both phases, which is
+  the one shape a browser never produces. It now sends what one does.
+
 ## 0.3.0
 
 ### Minor Changes

package/dist/{CanvasSurface-ifHkg0-g.js → CanvasSurface-BR7hECHm.js}

@@ -188,6 +188,16 @@ let UiEventType = /* @__PURE__ */ function(UiEventType) {
 	*/
 	UiEventType["Paste"] = "paste";
 	UiEventType["Click"] = "click";
+	/**
+	* A second Click on the same node, soon enough after the first and
+	* close enough to it.
+	*
+	* Dispatched after that second Click rather than instead of it, as
+	* the DOM's `dblclick` is: a listener that answers a click has
+	* already answered both by the time this arrives, which is what lets
+	* a double click on a cell select it and then do more.
+	*/
+	UiEventType["DoubleClick"] = "doubleclick";
 	UiEventType["LongPress"] = "longpress";
 	UiEventType["DragStart"] = "dragstart";
 	UiEventType["DragMove"] = "dragmove";
@@ -3937,6 +3947,20 @@ const UiProperties = {
 		inherited: false,
 		affects: L
 	}),
+	/**
+	* A point to be placed beside, as though it were an anchor of no
+	* size: where a context menu was asked for. Relative to the
+	* containing block, like `top` and `left`, and with `placement` the
+	* same flip and clamp an anchored node gets — so a menu opened near
+	* the bottom edge opens upward instead of off the screen. Ignored
+	* when `anchor` is set.
+	*/
+	anchorPoint: defineProperty({
+		name: "anchorPoint",
+		defaultValue: void 0,
+		inherited: false,
+		affects: L
+	}),
 	/** Gap between an anchored node and its anchor. */
 	anchorOffset: defineProperty({
 		name: "anchorOffset",
@@ -9435,6 +9459,15 @@ var UiPointerController = class {
 	onHoverChange;
 	editing;
 	selection;
+	now;
+	/**
+	* The last Click, for telling whether the next one makes a pair.
+	*
+	* Only a Click counts, not a press: a press that became a drag, or
+	* was cancelled, is not half of a double click, and a release that
+	* followed one would otherwise be read as the second half of it.
+	*/
+	lastClick = null;
 	hoverNode = null;
 	downTarget = null;
 	downX = 0;
@@ -9461,6 +9494,7 @@ var UiPointerController = class {
 		this.onHoverChange = options.onHoverChange ?? null;
 		this.editing = options.editing;
 		this.selection = options.selection;
+		this.now = options.now ?? defaultClock$2;
 	}
 	/** The node currently under the pointer, or null over empty space. */
 	/** Where the pointer was last seen, in canvas space; null before it has been. */
@@ -9597,12 +9631,39 @@ var UiPointerController = class {
 			if (dx <= slop && dy <= slop) {
 				const click = new UiPointerEvent("click", x, y, buttons, modifiers, pointer);
 				this.dispatcher.dispatch(click, target);
-			}
-		}
+				this.countClick(target, x, y, buttons, modifiers, pointer);
+			} else this.lastClick = null;
+		} else this.lastClick = null;
 		this.releaseHover(x, y, modifiers, pointer);
 		return event;
 	}
 	/**
+	* Pairs this Click with the one before it, and dispatches a
+	* DoubleClick when they make a pair.
+	*
+	* A pair is two Clicks on the same node within `MULTI_CLICK_MS` and
+	* `MULTI_CLICK_SLOP` of each other — the window the editing and
+	* selection controllers already use for a word, so a double click
+	* means the same thing on a label as it does in a field. The pair is
+	* spent once it has fired: a third Click starts the next pair rather
+	* than making a second DoubleClick out of the second and third.
+	*/
+	countClick(target, x, y, buttons, modifiers, pointer) {
+		const now = this.now();
+		const last = this.lastClick;
+		if (!(last !== null && last.node === target && now - last.at <= MULTI_CLICK_MS$1 && Math.abs(last.x - x) <= MULTI_CLICK_SLOP$1 && Math.abs(last.y - y) <= MULTI_CLICK_SLOP$1)) {
+			this.lastClick = {
+				node: target,
+				x,
+				y,
+				at: now
+			};
+			return;
+		}
+		this.lastClick = null;
+		this.dispatcher.dispatch(new UiPointerEvent("doubleclick", x, y, buttons, modifiers, pointer), target);
+	}
+	/**
 	* Aborts the active press: dispatches PointerCancel to the pressed
 	* node and clears press state so no Click is synthesized.
 	*/
@@ -9754,6 +9815,12 @@ var UiPointerController = class {
 function isSecondaryButton(buttons) {
 	return buttons === 2;
 }
+/** How long, and how far, a second Click may be from the first and still pair with it. */
+const MULTI_CLICK_MS$1 = 500;
+const MULTI_CLICK_SLOP$1 = 4;
+function defaultClock$2() {
+	return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
 //#endregion
 //#region src/input/UiKeyboardController.ts
 /**
@@ -9808,13 +9875,19 @@ var UiKeyboardController = class {
 		this.find = options.find;
 		this.activation = options.activation;
 	}
-	keyDown(key, modifiers = noKeyModifiers()) {
+	/**
+	* `textFollows` says whether the shell will send the key's text on its
+	* own, as a `beforeinput`. False — a key that reached the canvas while
+	* an editable held the focus — has the key inserted here, whatever the
+	* text source; absent leaves it to the editing controller's setting.
+	*/
+	keyDown(key, modifiers = noKeyModifiers(), textFollows) {
 		if (!MODIFIER_KEYS.has(key)) this.focusManager.noteInput("keyboard");
 		const event = new UiKeyboardEvent("keydown", key, modifiers);
 		const focused = this.focusManager.focusedNode;
 		const target = focused ?? this.root();
 		this.dispatcher.dispatch(event, target);
-		if (!event.defaultPrevented && focused !== null && this.editing !== void 0 && this.editing.handleKey(focused, key, modifiers)) {
+		if (!event.defaultPrevented && focused !== null && this.editing !== void 0 && this.editing.handleKey(focused, key, modifiers, textFollows === false ? true : void 0)) {
 			event.preventDefault();
 			return event;
 		}
@@ -10808,9 +10881,10 @@ var UiEditingController = class {
 	* when the key was an editing command, so the caller can mark the
 	* event handled.
 	*/
-	handleKey(node, key, modifiers) {
+	/** `textFromKeys` overrides the controller's own setting for this one key; see `UiKeyboardController.keyDown`. */
+	handleKey(node, key, modifiers, textFromKeys = this.textFromKeys) {
 		if (!isEditableNode(node)) return false;
-		const command = commandForKey(key, modifiers, this.platform, this.textFromKeys);
+		const command = commandForKey(key, modifiers, this.platform, textFromKeys);
 		if (command === null) return false;
 		return this.execute(node, command);
 	}
@@ -15183,6 +15257,7 @@ var LayoutEngine = class {
 			};
 			this.resolveLayoutProps(child, cRec);
 			const anchor = child.properties.get("anchor");
+			const point = child.properties.get("anchorPoint");
 			if (anchor !== void 0 && anchor !== null) {
 				this.anchoredNodes.add(child);
 				this.trackAnchor(child, anchor);
@@ -15191,6 +15266,12 @@ var LayoutEngine = class {
 					this.placeAnchored(child, cRec, anchorRec, anchor, block);
 					return;
 				}
+			} else if (point !== void 0 && point !== null) {
+				this.anchoredNodes.delete(child);
+				this.trackAnchor(child, null);
+				this.measure(child, new Constraints(0, Math.max(0, block.width), 0, Math.max(0, block.height)));
+				this.placeBeside(child, cRec, block.x + point.x, block.y + point.y, 0, 0, block);
+				return;
 			} else {
 				this.anchoredNodes.delete(child);
 				this.trackAnchor(child, null);
@@ -15199,9 +15280,11 @@ var LayoutEngine = class {
 			const marginV = cRec.marginTop + cRec.marginBottom;
 			const availableWidth = Math.max(0, block.width - (cRec.left ?? 0) - (cRec.right ?? 0) - marginH);
 			const availableHeight = Math.max(0, block.height - (cRec.top ?? 0) - (cRec.bottom ?? 0) - marginV);
-			const tightWidth = cRec.left !== void 0 && cRec.right !== void 0 && this.lengthProp(child, "width", block.width) === void 0;
-			const tightHeight = cRec.top !== void 0 && cRec.bottom !== void 0 && this.lengthProp(child, "height", block.height) === void 0;
-			this.measure(child, new Constraints(tightWidth ? availableWidth : 0, availableWidth, tightHeight ? availableHeight : 0, availableHeight));
+			const explicitWidth = this.lengthProp(child, "width", block.width) !== void 0;
+			const explicitHeight = this.lengthProp(child, "height", block.height) !== void 0;
+			const tightWidth = cRec.left !== void 0 && cRec.right !== void 0 && !explicitWidth;
+			const tightHeight = cRec.top !== void 0 && cRec.bottom !== void 0 && !explicitHeight;
+			this.measure(child, new Constraints(tightWidth ? availableWidth : 0, explicitWidth ? Infinity : availableWidth, tightHeight ? availableHeight : 0, explicitHeight ? Infinity : availableHeight));
 			const width = cRec.measuredWidth;
 			const height = cRec.measuredHeight;
 			let x;
@@ -15229,18 +15312,25 @@ var LayoutEngine = class {
 	*/
 	placeAnchored(child, cRec, anchorRec, anchor, block) {
 		this.measure(child, new Constraints(0, Math.max(0, block.width), 0, Math.max(0, block.height)));
-		const width = cRec.measuredWidth;
-		const height = cRec.measuredHeight;
-		const gap = this.numberProp(child, "anchorOffset") ?? 0;
-		const { side, align } = this.parsePlacement(child.properties.get("placement"));
 		const scrollAnchor = this.scrollOffsetOf(anchor);
 		const scrollChild = this.scrollOffsetOf(child);
 		const stickyAnchor = this.stickyOffsetOf(anchor);
 		const stickyChild = this.stickyOffsetOf(child);
 		const ax = anchorRec.x + stickyAnchor.x - scrollAnchor.x + scrollChild.x - stickyChild.x;
 		const ay = anchorRec.y + stickyAnchor.y - scrollAnchor.y + scrollChild.y - stickyChild.y;
-		const aw = anchorRec.width;
-		const ah = anchorRec.height;
+		this.placeBeside(child, cRec, ax, ay, anchorRec.width, anchorRec.height, block);
+	}
+	/**
+	* Places a measured node beside a box — an anchor's, or a point's of
+	* no size — flipping to the opposite side when the named one would
+	* overflow the block and the other has more room, and clamping along
+	* the side to stay inside it.
+	*/
+	placeBeside(child, cRec, ax, ay, aw, ah, block) {
+		const width = cRec.measuredWidth;
+		const height = cRec.measuredHeight;
+		const gap = this.numberProp(child, "anchorOffset") ?? 0;
+		const { side, align } = this.parsePlacement(child.properties.get("placement"));
 		const vertical = side === "top" || side === "bottom";
 		let resolvedSide = side;
 		if (vertical) {
@@ -18212,4 +18302,4 @@ function createCanvasSurface(host) {
 //#endregion
 export { prepareInputSurface as $, UiBinding as $a, defaultTextStyle as $i, EditableTextModel as $n, minmax as $r, DEFAULT_FONT_WEIGHT as $t, accumulatedOffsetTo as A, UiVisualState as Aa, themeExtension as Ai, setLinkHover as An, validateStates as Ar, proportionalFontMetrics as At, parseFlexDirection as B, UiInputEvent as Ba, spacingEqual as Bi, nextCaretToggle as Bn, transformsEqual as Br, layoutTextLines as Bt, describeLength as C, UiNode as Ca, lightTheme as Ci, isNodeTabStop as Cn, UI_ROLES as Cr, selectionRectsIn as Ct, formatNumber as D, resetOverrideWarnings as Da, defineThemeExtension as Di, linkHoverOf as Dn, normalizeStates as Dr, spannedRunsFor as Dt, formatExplanation as E, overrideSources as Ea, withDensity as Ei, hasTextLinks as En, isUiSemanticState as Er, ParagraphTextMeasurer as Et, constraintsEqual as F, MOUSE_POINTER as Fa, raiseContrast as Fi, editorFor as Fn, pathValuesEqual as Fr, applyCanvasTextStyle as Ft, MainAxisAlignment as G, UiSelectionChangeEvent as Ga, boxShadowArraysEqual as Gi, caretRectFor as Gn, radialGradient as Gr, textRunBackgrounds as Gt, sizeGridTracks as H, UiPasteEvent as Ha, defaultShadows as Hi, resolveColorValue as Hn, gradientPaint as Hr, runFontString as Ht, tightenConstraints as I, UiBeforeInputEvent as Ia, relativeLuminance as Ii, editorOf as In, UiTransforms as Ir, buildFontString as It, parseMainAxisAlignment as J, UiWheelEvent as Ja, isShapeName as Ji, lineLimit as Jn, fr as Jr, clearFontStacks as Jt, parseAlignContent as K, UiTextChangeEvent as Ka, boxShadowsEqual as Ki, lineIndexAtY as Kn, validateGradient as Kr, textRunDecorations as Kt, MAX_MEASURES_PER_CHILD as L, UiEventType as La, densityFactors as Li, isEditableNode as Ln, parseTransform as Lr, createCanvasTextStyle as Lt, LayoutRecord as M, hasVisualState as Ma, withThemeExtension as Mi, CARET_WIDTH as Mn, validateSubgrid as Mr, detectEditingPlatform as Mt, Constraints as N, visualState as Na, contrastRatio as Ni, EDITOR_PROP as Nn, inputsEqual as Nr, isPrintable as Nt, labelNode as O, writeDeclaredProperty as Oa, hasThemeExtension as Oi, linkOf as On, statesEqual as Or, ELLIPSIS as Ot, clampSize as P, visualStatesEqual as Pa, highContrastColors as Pi, caretVisibleAt as Pn, paintValuesEqual as Pr, EditableLayout as Pt, pointerDeviceOf as Q, DirtyFlags as Qa, typographyEqual as Qi, selectionRects as Qn, isPercentLength as Qr, DEFAULT_FONT_SIZE as Qt, isLayoutProtocol as R, UiFocusEvent as Ra, defaultSpacing as Ri, isMultiline as Rn, transform as Rr, drawText as Rt, SCROLLBAR_LINGER_MS as S, UiEnvironment as Sa, darkTheme as Si, isNodeSelectable as Sn, UiProperties as Sr, paragraphGeometryFrom as St, formatConstraints as T, clearOverrideProperty as Ta, withContrast as Ti, clearLinkHover as Tn, isUiRole as Tr, CharacterCountTextMeasurer as Tt, AlignContent as U, UiPinchEvent as Ua, shadowsEqual as Ui, isVideoSurface as Un, gradientsEqual as Ur, spanOf as Ut, placeGridItems as V, UiKeyboardEvent as Va, spacingSteps as Vi, syncEditorValue as Vn, MAX_GRADIENT_STOPS as Vr, runCanvasStyleInto as Vt, CrossAxisAlignment as W, UiPointerEvent as Wa, boxShadow as Wi, videoFrameSize as Wn, linearGradient as Wr, textMeasureRequest as Wt, UiPlatformAdapter as X, wheelDeltaYOf as Xa, defaultTypography as Xi, offsetAtX as Xn, isFrLength as Xr, registerFontStack as Xt, CanvasPlatformSurface as Y, noKeyModifiers as Ya, shapesEqual as Yi, offsetAtPoint as Yn, isAutoLength as Yr, fontStackFor as Yt, capturePointer as Z, UiNodeType as Za, isTypographyRole as Zi, offsetForVerticalMove as Zn, isMinMaxTrack as Zr, DEFAULT_FONT_FAMILY as Zt, LABEL_PADDING_X as _, parseColor as _a, observeViewportInsets as _i, selectionRangeOf as _n, inheritedPropertyFlags as _r, scrollbarZoneAt as _t, PaintPictureCache as a, textContentOf as aa, borderRadiusCorners as ai, normalizeTextAlign as an, previousGraphemeStart as ar, UiWheelController as at, LayoutEngine as b, createEnvironmentKey as ba, containerBands as bi, isNodeHitTestable as bn, propertyIsInherited as br, offsetAtPointIn as bt, EMPTY_RECORDING as c, colorsEqualPalette as ca, borderRadiusValuesEqual as ci, DEFAULT_LINE_HEIGHT_FACTOR as cn, resolveBoolean as cr, UiPointerController as ct, tracePathData as d, UiBasicColors as da, defineProperty as di, matchRangesOf as dn, resolvePropertyByName as dr, SCROLLBAR_HOVER_ZONE as dt, editableSpansOf as ea, percent as ei, DEFAULT_TEXT_COLOR as en, graphemeBoundaries as er, touchActionFor as et, ScaledImageCache as f, colorToHex as fa, propertyValuesEqual as fi, setMatchRanges as fn, resolveString as fr, SCROLLBAR_INSET as ft, paintsAfterChildren as g, normalizeColor as ga, noInsets as gi, selectableTextOf as gn, getPropertyNames as gr, scrollbarThumbs as gt, hasDecorationPhase as h, colorsEqual as ha, insetsEqual as hi, selectableTextNodes as hn, findPropertyDefinition as hr, scrollbarThumb as ht, traceRoundedRect as i, spannedTextOf as ia, borderRadius as ii, isPaintVisible as in, nextWordEnd as ir, UiPinchRecognizer as it, contentOffset as j, defaultVisualState as ja, themeExtensionsEqual as ji, CARET_BLINK_MS as jn, UI_SUBGRID_AXES as jr, commandForKey as jt, withOverrideSource as k, writeOverrideProperty as ka, noThemeExtensions as ki, linkRunAtPointIn as kn, validateRole as kr, layoutParagraph as kt, PaintRecorder as l, darkColors as la, normalizeBorderRadius as li, TEXT_MATCHES_PROP as ln, resolveNumber as lr, UiFocusManager as lt, decorationRect as m, colorValuesEqual as ma, UiInsetRegistry as mi, clearSelectionRange as mn, closestPropertyName as mr, SCROLLBAR_THICKNESS as mt, createCanvasSurface as n, resolvedSpansOf as na, resolveLength as ni, computeObjectFitRect as nn, lineStartAt as nr, UiTouchScroller as nt, paintPictures as o, textSpansEqual as oa, borderRadiusEqual as oi, normalizeVerticalAlign as on, previousWordStart as or, isScrollContainer as ot, decorationColor as p, colorToRgba as pa, UiEnvironmentKeys as pi, TEXT_SELECTION_PROP as pn, UiGraph as pr, SCROLLBAR_MIN_THUMB as pt, parseCrossAxisAlignment as q, UiWheelDeltaMode as qa, defaultShapes as qi, lineIndexForOffset as qn, auto as qr, bumpFontStack as qt, Canvas2DRenderer as r, spanAtOffset as ra, UiBorderRadiuses as ri, createPaintState as rn, nextGraphemeEnd as rr, UiGestureRecognizer as rt, PaintTarget as s, textStylesEqual as sa, borderRadiusIsZero as si, resolvePaintState as sn, wordRangeAt as sr, UiKeyboardController as st, CanvasSurface as t, flattenTextSpans as ta, repeat as ti, colorToCss as tn, lineEndAt as tr, UiEditingController as tt, replayPaint as u, lightColors as ua, uniformBorderRadius as ui, clearMatchRanges as un, resolveProperty as ur, UiHitTester as ut, drawOverlayShapes as v, rgb8 as va, UiContainerSizeSource as vi, setSelectionRange as vn, inheritedPropertyNames as vr, UiInputDispatcher as vt, describeOverrides as w, DirtyNodeSet as wa, themesEqual as wi, resolveCursor as wn, UI_SEMANTIC_STATES as wr, wordRangeIn as wt, SCROLLBAR_FADE_MS as x, findEnvironmentKey as xa, unknownContainerSize as xi, isNodeInert as xn, propertyValuesEqualByName as xr, paragraphGeometry as xt, labelOrigin as y, rgba as ya, bandOf as yi, isNodeFocusable as yn, propertyEffects as yr, hasDrawnText as yt, FlexDirection as z, UiGestureEvent as za, scaleSpacing as zi, isReadOnly as zn, transformIsIdentity as zr, fillTextRects as zt };
 
-//# sourceMappingURL=CanvasSurface-ifHkg0-g.js.map
+//# sourceMappingURL=CanvasSurface-BR7hECHm.js.map