gesso-framework 0.6.26 → 0.6.27

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # gesso-framework
 
+## 0.6.27
+
+### Patch Changes
+
+- ff9dd85: A grid can say where its rows and cells sit in the whole of its data, not only among the ones that are mounted. Four new semantics properties carry it: `rowCount` and `columnCount` on the `grid`, `treegrid` or `table` (use -1 when the count is not known), `rowIndex` on each `row` and `columnIndex` on each cell, all counting from 1. They are carried into the semantics record under the same names, and the accessibility mirror writes them as `aria-rowcount`, `aria-colcount`, `aria-rowindex` and `aria-colindex`. A virtualized grid used to leave a screen reader counting the cells in view, so after scrolling sideways the first visible cell was announced as column 1 whatever column it was really in.
+- bdc4780: A key release the application claims cancels the browser's default, as a key press already did. A lone Alt opens a Windows browser's menu when it is released, so a `MenuBar` that takes focus on Alt also had the browser's own menu open over it. On the main thread the platform adapter now passes a claimed release on to the browser event; in a render worker, `interceptKey` is asked about releases as well as presses.
+- 66690b6: A `NumberInput` with a minimum can be typed into. Every keystroke used to be clamped, so with `min: 10` the "1" of "15" became "10" under the caret and the "5" made it "105". The field now keeps what is typed, reports a number only once it is one the field could hold, and bounds the text when it is left or Enter is pressed. A field left blank or holding text that is not a number goes back to the value it had, where it used to report 0, a number nobody typed and often not in range.
+
+  A `Slider` under `textDirection: 'rtl'` agrees with what it draws. The fill already grew from the right, but a press and the arrow keys still read left to right, so a press near the right edge set nearly the maximum and Right made the fill longer. A press now counts from where the track starts, Left is more and Right is less, Up and Down are unchanged, and the thumb sits centred on the end of the fill rather than six pixels short of it.
+
+  A `RadioGroup` marked `invalid` or given an `error` rings its circles in the danger colour, as a `Checkbox` rings its box; it used to say so only in the message under it. Its `direction` is documented as read once, when the group renders. A row of options under `textDirection: 'rtl'` takes Left as the next option and Right as the previous one, so the arrows move toward the option they point at; they used to move away from it.
+
+  `SegmentedControl` takes a `ref`, as every other control does, and hands it the track.
+
+  `onSubmit` on a `TextArea`, or on a multiline `TextInput`, is called on Command-Enter or Control-Enter. It was on the props and never called, since Enter alone is a new line there.
+
+  `bind(cell, 'checked')` spreads into JSX beside other props. The handler's name defaulted to `onChange` only in principle: it was inferred from the props around the spread, so `<Switch label="Sync" {...bind(on, 'checked')} />` failed to compile with "'label' is specified more than once" and needed `'onChange'` spelled out.
+
+- bdc4780: Overlays follow the reading direction. An overlay entry's `placement`
+  now names `start` and `end` as reading edges: along the top or the
+  bottom, `-start` lines the entry up with the anchor's start edge, which
+  is its right under `textDirection="rtl"`, and the new sides `start`,
+  `end`, `start-start`, `start-end`, `end-start` and `end-end` open beside
+  the anchor toward those edges. `left` and `right` stay physical. An
+  unanchored entry takes `start` and `end` edge offsets beside `left` and
+  `right`. The direction is read from the entry's `environment`, or its
+  anchor, the same node its theme comes from, and followed while the
+  entry is open.
+
+  So under right-to-left text a `Toast` at `bottom-start` is pinned to the
+  bottom right corner and `bottom-end` to the bottom left; a `Menu` lines
+  up with its button's right edge, opens a context menu leftward from the
+  pointer, opens submenus to the left of their items (flipping right at
+  the window edge), and swaps Left and Right for opening and closing them;
+  `Combobox`, `DatePicker`, `Select` and `MenuBar` line their lists up
+  with the trigger's right edge; and `Tooltip` takes `start` and `end`
+  sides. Code that passed `bottom-start` to mean the left edge in a
+  right-to-left tree now gets the right edge.
+
+- bdc4780: Scrolling a `DataTable`, `LazyList` or `Tree` to a row that was never mounted lands the row in view even when the rows are taller or shorter than the estimate. The jump goes by the estimate for every row on the way, and when that was short of the real height the row it was for ended up below the bottom edge, and stayed there: nothing ran another frame to measure it. A `UiVirtualWindow` can now hold an item in view (`holdInView`) until it has been measured, the runtime runs the frame that measures it, and the window folds the correction into the scroll adjustment it already returns.
+- 69e5d47: A scroll container that reads right to left can reach everything in it. Its content starts at the right edge and overflows to the left, but its horizontal offset was clamped to `[0, overflow]`, toward the right, so a wide right-to-left table, row or sheet showed its first columns and nothing a wheel, a swipe or a dragged thumb could do reached the rest. Such a container now follows CSS: `scrollX` runs from minus the overflow up to `0`, where `0` shows the start edge and is where an unscrolled container sits. Its content extent is measured from the right edge, the horizontal thumb starts at the right of its track, revealing a row scrolls left to it, a sticky column at `right: 0` holds there, and a `LazyRow` or `LazySheet` mounts what the offset shows. `scrollBounds` and `scrollsFromRight` answer the range and the direction for a record. Text fields are unchanged: a field scrolls its own text by the caret, from `0` up.
+- Updated dependencies [ff9dd85]
+- Updated dependencies [bdc4780]
+- Updated dependencies [baf8dec]
+- Updated dependencies [cbac578]
+- Updated dependencies [bdc4780]
+- Updated dependencies [ff9dd85]
+- Updated dependencies [69e5d47]
+- Updated dependencies [bdc4780]
+- Updated dependencies [3daa932]
+  - gesso-core@0.6.27
+
 ## 0.6.26
 
 ### Patch Changes

package/dist/{index-XlACZQyY.d.ts → index-NIdw2_S0.d.ts}

@@ -839,17 +839,31 @@ declare function show(when: Observable<unknown> | unknown, children: () => UiChi
  * site rather than hidden by a helper pretending the key is writable.
  *
  * Sugar over the controlled contract, not a replacement for it.
+ *
+ * A renamed value with the handler left as `onChange` is an overload of
+ * its own rather than a default on the event name's type parameter. A
+ * parameter with no argument to infer from is inferred from where the
+ * result goes, and a spread into JSX goes into the props around it, so
+ * the default never applied: the name became every prop beside the
+ * spread, and `<Switch label="Sync" {...bind(on, 'checked')} />` said
+ * `label` was given twice.
  */
 declare function bind<T>(cell: InternalState<T>): {
   value: InternalState<T>;
   onChange: (next: T) => void;
 };
-declare function bind<T, V extends string, E extends string = 'onChange'>(cell: InternalState<T>, value: V, onChange?: E): { [K in V]: InternalState<T>; } & { [K in E]: (next: T) => void; };
+declare function bind<T, V extends string>(cell: InternalState<T>, value: V): { [K in V]: InternalState<T>; } & {
+  onChange: (next: T) => void;
+};
+declare function bind<T, V extends string, E extends string>(cell: InternalState<T>, value: V, onChange: E): { [K in V]: InternalState<T>; } & { [K in E]: (next: T) => void; };
 declare function bind<T>(cell: ReadableCell<T>, write: (next: T) => void): {
   value: ReadableCell<T>;
   onChange: (next: T) => void;
 };
-declare function bind<T, V extends string, E extends string = 'onChange'>(cell: ReadableCell<T>, write: (next: T) => void, value: V, onChange?: E): { [K in V]: ReadableCell<T>; } & { [K in E]: (next: T) => void; };
+declare function bind<T, V extends string>(cell: ReadableCell<T>, write: (next: T) => void, value: V): { [K in V]: ReadableCell<T>; } & {
+  onChange: (next: T) => void;
+};
+declare function bind<T, V extends string, E extends string>(cell: ReadableCell<T>, write: (next: T) => void, value: V, onChange: E): { [K in V]: ReadableCell<T>; } & { [K in E]: (next: T) => void; };
 //#endregion
 //#region src/themeTokenCell.d.ts
 /**
@@ -1151,7 +1165,28 @@ type FrameworkChild = UiChild | ComponentElement;
 declare function createComponent<C extends ComponentType>(component: C, ...args: ComponentArgs<C>): ComponentElement<ComponentProps<C>>;
 //#endregion
 //#region src/overlay/OverlayService.d.ts
-type OverlayPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+/**
+ * The side of the anchor an entry opens on and, after a dash, the edge
+ * of the anchor it lines up with along that side; the bare side
+ * centres.
+ *
+ * **`start` and `end` are the reading edges.** Along the top or the
+ * bottom, `-start` lines the entry up with the anchor's start edge,
+ * which is its left in left-to-right text and its right in
+ * right-to-left text: a list under a field begins where the field's
+ * text does. As a side, `start` and `end` open beside the anchor
+ * toward those edges, so a submenu given `end-start` opens past the
+ * end of its row whichever way the row reads. Along the left or right
+ * side the alignment is up and down, which no reading direction turns.
+ *
+ * `left` and `right` stay physical, for a side that is genuinely one
+ * edge of the screen whatever the language: an arrow drawn on a
+ * diagram, a tooltip on a panel that is always on the left.
+ *
+ * The direction is the entry's: the one its content reads in, which is
+ * where its theme comes from too. See `OverlayEntry.environment`.
+ */
+type OverlayPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end' | 'start' | 'start-start' | 'start-end' | 'end' | 'end-start' | 'end-end';
 /** A rectangle inside an anchor, from its border box's top left. */
 interface OverlayRect {
   readonly x: number;
@@ -1183,7 +1218,7 @@ interface OverlayEntry {
    * when it wraps to the next line, without being opened again.
    */
   readonly anchorRect?: Reactive<OverlayRect | undefined>;
-  /** Default 'bottom'. */
+  /** Default 'bottom'. `start` and `end` follow the reading direction; see `OverlayPlacement`. */
   readonly placement?: OverlayPlacement;
   /** Gap between content and anchor. */
   readonly offset?: number;
@@ -1191,6 +1226,16 @@ interface OverlayEntry {
   readonly right?: number;
   readonly bottom?: number;
   readonly left?: number;
+  /**
+   * The offset from the viewport's start edge: its left in
+   * left-to-right text and its right in right-to-left text, in the
+   * entry's direction. For something pinned to a corner a reader looks
+   * for in a particular place, as a toast is. It wins over the physical
+   * offset on the same edge.
+   */
+  readonly start?: number;
+  /** The offset from the viewport's end edge, as `start` is from its start. */
+  readonly end?: number;
   /**
    * A point to open beside, relative to the viewport: where a context
    * menu was asked for. Placed as an anchor of no size would be, with
@@ -1295,6 +1340,12 @@ declare class OverlayService {
  *
  * Entries render in store order; a later entry is on top unless it
  * sets zIndex.
+ *
+ * `start` and `end`, in a placement or as edge offsets, are resolved to
+ * physical edges here, in the reading direction of the node the entry
+ * takes its environment from, and resolved again if that direction
+ * changes while the entry is open. See `OverlayEntry.environment` for
+ * why that node and not always the anchor.
  */
 declare class OverlayLayer extends Component {
   overlays: OverlayService;
@@ -5890,8 +5941,11 @@ interface WorkerAppOptions {
    * predicate rather than a list so it can say "Ctrl or Cmd" in one
    * line.
    *
-   * Called for every keydown that reaches the shell, so it should be a
-   * comparison and nothing more.
+   * Called for every keydown and keyup that reaches the shell, so it
+   * should be a comparison and nothing more. The keyup matters for a key
+   * whose default comes on release: a lone Alt opens a Windows browser's
+   * menu when it comes up, so a `MenuBar` that answers to Alt claims
+   * both.
    */
   interceptKey?: (event: KeyboardEvent) => boolean;
   /**
@@ -8784,4 +8838,4 @@ declare class RenderWorkerApp {
 }
 //#endregion
 export { StorageAdapter as $, UiNodeReport as $n, mutate as $r, UiFramePhase as $t, Presence as A, AudioService as An, ChannelRegistry as Ar, createShellHistory as At, PersistedOptions as B, ShellFileResult as Bn, themeTokenCell as Br, UiTreeNode as Bt, FocusService as C, buildPath as Cn, pick as Cr, createApp as Ct, FindService as D, AudioMetadata as Dn, createChannelRegistry as Dr, ShellHistory as Dt, TextService as E, AudioAction as En, ChannelRegistryHandle as Er, WorkerAppOptions as Et, AudioSinkOptions as F, SpringOptions as Fn, Output as Fr, ConsoleEntry as Ft, IndexedDbStorage as G, ShellStorageOp as Gn, Each as Gr, ShellToRuntimeMessage as Gt, persisted as H, ShellRecentFile as Hn, Show as Hr, treeText as Ht, AudioSinkOutput as I, UiDuration as In, ControlledOptions as Ir, DevtoolsEvent as It, OpfsFileHandle as J, ColorSchemePreference as Jn, each as Jr, GessoRuntime as Jt, IndexedDbStorageOptions as K, ShellStorageResult as Kn, EachKey as Kr, FrameMetrics as Kt, MediaSessionLike as L, UiEasingChoice as Ln, ControlledValue as Lr, DevtoolsRequest as Lt, RouterOutlet as M, AudioStatus as Mn, Define as Mr, ActionEntry as Mt, AudioElementLike as N, AnimateOptions as Nn, Inject as Nr, ChannelErrorEntry as Nt, observeMediaQuery as O, AudioRequest as On, findUnplainPath as Or, ShellHistoryMode as Ot, AudioSink as P, AnimationService as Pn, Input as Pr, CommandEntry as Pt, MemoryStorage as Q, UiEnvironmentReport as Qn, Mutation as Qr, UI_FRAME_PHASES as Qt, audioClock as R, ShellFile as Rn, controlled as Rr, FrameEntry as Rt, writeClipboard as S, RouteParams as Sn, structurallyEqual as Sr, CreateAppOptions as St, EditingService as T, parseUrl as Tn, ChannelRegistration as Tr, WorkerApp as Tt, ShellStorage as U, ShellRequest as Un, ShowProps as Ur, RuntimeErrorSource as Ut, PersistedState as V, ShellFileType as Vn, bind as Vr, UiTreeSnapshot as Vt, ShellStorageOptions as W, ShellService as Wn, show as Wr, RuntimeToShellMessage as Wt, OpfsStorageOptions as X, BoundStream as Xn, throttled as Xr, RendererChoice as Xt, OpfsStorage as Y, observeColorScheme as Yn, debounced as Yr, GessoRuntimeOptions as Yt, OpfsWritable as Z, NodePathTarget as Zn, MutateOptions as Zr, RuntimeInput as Zt, EditingMirrorTarget as _, Equality as _i, RouteGuard as _n, OverlayService as _r, GessoApp as _t, UiRole as a, SelectOptions as ai, FontService as an, describeStream as ar, storageReadValue as at, EditingProxy as b, route as bn, FrameworkChild as br, GessoAppBuilder as bt, UiSemanticsPatch as c, FanKey as ci, RouteAnswer as cn, formatNodeReport as cr, UndoableOptions as ct, markNow as d, fanOut as di, RouterRoutes as dn, ComponentHostResolver as dr, UndoStackOptions as dt, Resource as ei, FontFaceDeclaration as en, UiOwnerReport as er, StorageOutcome as et, measureSpan as f, ComputedCell as fi, RouterService as fn, ComponentHost as fr, UndoTransaction as ft, renderRoot as g, DeriveOptions as gi, RouteDefinition as gn, OverlayRect as gr, shellStorageDenied as gt, RenderWorkerApp as h, computed as hi, RouteContext as hn, OverlayPlacement as hr, performShellStorage as ht, UI_SEMANTIC_STATES as i, resource as ii, FontHost as in, UiStreamReport as ir, storageReadFailure as it, PresenceProps as j, AudioState as jn, Channel as jr, ActionCause as jt, observeReducedMotion as k, AudioSample as kn, requirePlainData as kr, ShellHistoryOptions as kt, UiSemanticsRecord$1 as l, FanOut as li, RouteMatch as ln, formatStream as lr, undoable as lt, setPerformanceMarks$1 as m, ReadSource as mi, OutletProps as mn, OverlayEntry as mr, ShellLocalStore as mt, MARK_PREFIX as n, ResourceState as ni, FontFamilyDeclaration as nn, UiPropReport as nr, classifyStorageError as nt, UiSemanticState as o, select as oi, MediaOptions as on, formatAge as or, UndoShortcutOptions as ot, performanceMarksEnabled as p, ComputedOptions as pi, RouteState as pn, OverlayLayer as pr, rememberedDirectory as pt, OpfsDirectory as q, ColorScheme as qn, EachProps as qr, FramePhaseTimings as qt, UI_ROLES as r, ResourceStatus as ri, FontFamilyStatus as rn, UiSemanticsReport as rr, storageErrorMessage as rt, UiSemanticsMap$1 as s, FanCell as si, MediaService as sn, formatNodePath as sr, registerUndoShortcuts as st, EditingState$1 as t, ResourceOptions as ti, FontFaceLike as tn, UiPropOrigin as tr, StorageRead as tt, markInstant as u, FanOutOptions as ui, RouterHistorySink as un, printPropValue as ur, UndoStack as ut, SemanticsMirror as v, derive as vi, RouteOptions as vn, createComponent as vr, GessoAppOptions as vt, ScrollService as w, formatUrl as wn, pickKeys as wr, AppLogicEndpoint as wt, EditingProxySink as x, to as xn, isComponentElement as xr, WebMcpChoice as xt, SemanticsMirrorSink as y, ServiceRegistry as yi, RouteTarget as yn, ComponentElement as yr, createSyncApp as yt, FrameService as z, ShellFileRequest as zn, ThemeTokenCell as zr, PatchEntry as zt };
-//# sourceMappingURL=index-XlACZQyY.d.ts.map
+//# sourceMappingURL=index-NIdw2_S0.d.ts.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { _ as channel, a as isChannelHostMessage, c as applyPatch, d as ChannelSpec, f as ChannelToken, g as ViewOf, h as CommandsOf, i as isChannelClientMessage, l as applyPatches, m as CommandMap, n as ChannelHostMessage, o as Patch, p as Command, r as ChannelPort, s as PatchPath, t as ChannelClientMessage, u as diffProjection, v as defineChannel, y as viewKeys } from "./ChannelProtocol-ByNoHujM.js";
 import { A as portHandle, C as MessageEndpoint, D as isHubMessage, E as WorkerHandle, F as JsonSchema, I as channelSchema, L as describeChannel, M as workerHandle, N as ChannelSchema, O as isPortErrorMessage, P as CommandSchema, S as APPLICATION_WORKER, T as PortHost, _ as serve, b as ProvidedChannel, g as ServedChannel, j as servePorts, k as isPortHandshake, v as serveChannels, w as PortHandshake, x as provide, y as ChannelSource } from "./ui-CHtNccR8.js";
 import { C as InternalState, S as output, T as Component, _ as OutputTarget, a as ComponentType, b as into, c as Inputs, d as BoundsCell, f as bounds, g as OutputCell, h as InputCell, i as ComponentProps, l as isClassComponent, m as EmitValue, o as FunctionComponent, p as EmitArgs, r as ComponentContext, s as InputValue, t as ClassComponent, u as ChannelReplica, v as ReadableCell, w as internalState, x as isOutputTarget, y as input } from "./FunctionComponent-CHtojpp7.js";
-import { $ as StorageAdapter, $n as UiNodeReport, $r as mutate, $t as UiFramePhase, A as Presence, An as AudioService, Ar as ChannelRegistry, At as createShellHistory, B as PersistedOptions, Bn as ShellFileResult, Br as themeTokenCell, Bt as UiTreeNode, C as FocusService, Cn as buildPath, Cr as pick, Ct as createApp, D as FindService, Dn as AudioMetadata, Dr as createChannelRegistry, Dt as ShellHistory, E as TextService, En as AudioAction, Er as ChannelRegistryHandle, Et as WorkerAppOptions, F as AudioSinkOptions, Fn as SpringOptions, Fr as Output, Ft as ConsoleEntry, G as IndexedDbStorage, Gn as ShellStorageOp, Gr as Each, Gt as ShellToRuntimeMessage, H as persisted, Hn as ShellRecentFile, Hr as Show, Ht as treeText, I as AudioSinkOutput, In as UiDuration, Ir as ControlledOptions, It as DevtoolsEvent, J as OpfsFileHandle, Jn as ColorSchemePreference, Jr as each, Jt as GessoRuntime, K as IndexedDbStorageOptions, Kn as ShellStorageResult, Kr as EachKey, Kt as FrameMetrics, L as MediaSessionLike, Ln as UiEasingChoice, Lr as ControlledValue, Lt as DevtoolsRequest, M as RouterOutlet, Mn as AudioStatus, Mr as Define, Mt as ActionEntry, N as AudioElementLike, Nn as AnimateOptions, Nr as Inject, Nt as ChannelErrorEntry, O as observeMediaQuery, On as AudioRequest, Or as findUnplainPath, Ot as ShellHistoryMode, P as AudioSink, Pn as AnimationService, Pr as Input, Pt as CommandEntry, Q as MemoryStorage, Qn as UiEnvironmentReport, Qr as Mutation, Qt as UI_FRAME_PHASES, R as audioClock, Rn as ShellFile, Rr as controlled, Rt as FrameEntry, S as writeClipboard, Sn as RouteParams, Sr as structurallyEqual, St as CreateAppOptions, T as EditingService, Tn as parseUrl, Tr as ChannelRegistration, Tt as WorkerApp, U as ShellStorage, Un as ShellRequest, Ur as ShowProps, Ut as RuntimeErrorSource, V as PersistedState, Vn as ShellFileType, Vr as bind, Vt as UiTreeSnapshot, W as ShellStorageOptions, Wn as ShellService, Wr as show, Wt as RuntimeToShellMessage, X as OpfsStorageOptions, Xn as BoundStream, Xr as throttled, Xt as RendererChoice, Y as OpfsStorage, Yn as observeColorScheme, Yr as debounced, Yt as GessoRuntimeOptions, Z as OpfsWritable, Zn as NodePathTarget, Zr as MutateOptions, Zt as RuntimeInput, _ as EditingMirrorTarget, _i as Equality, _n as RouteGuard, _r as OverlayService, _t as GessoApp, a as UiRole, ai as SelectOptions, an as FontService, ar as describeStream, at as storageReadValue, b as EditingProxy, bn as route, br as FrameworkChild, bt as GessoAppBuilder, c as UiSemanticsPatch, ci as FanKey, cn as RouteAnswer, cr as formatNodeReport, ct as UndoableOptions, d as markNow, di as fanOut, dn as RouterRoutes, dr as ComponentHostResolver, dt as UndoStackOptions, ei as Resource, en as FontFaceDeclaration, er as UiOwnerReport, et as StorageOutcome, f as measureSpan, fi as ComputedCell, fn as RouterService, fr as ComponentHost, ft as UndoTransaction, g as renderRoot, gi as DeriveOptions, gn as RouteDefinition, gr as OverlayRect, gt as shellStorageDenied, h as RenderWorkerApp, hi as computed, hn as RouteContext, hr as OverlayPlacement, ht as performShellStorage, i as UI_SEMANTIC_STATES, ii as resource, in as FontHost, ir as UiStreamReport, it as storageReadFailure, j as PresenceProps, jn as AudioState, jr as Channel, jt as ActionCause, k as observeReducedMotion, kn as AudioSample, kr as requirePlainData, kt as ShellHistoryOptions, l as UiSemanticsRecord, li as FanOut, ln as RouteMatch, lr as formatStream, lt as undoable, m as setPerformanceMarks, mi as ReadSource, mn as OutletProps, mr as OverlayEntry, mt as ShellLocalStore, n as MARK_PREFIX, ni as ResourceState, nn as FontFamilyDeclaration, nr as UiPropReport, nt as classifyStorageError, o as UiSemanticState, oi as select, on as MediaOptions, or as formatAge, ot as UndoShortcutOptions, p as performanceMarksEnabled, pi as ComputedOptions, pn as RouteState, pr as OverlayLayer, pt as rememberedDirectory, q as OpfsDirectory, qn as ColorScheme, qr as EachProps, qt as FramePhaseTimings, r as UI_ROLES, ri as ResourceStatus, rn as FontFamilyStatus, rr as UiSemanticsReport, rt as storageErrorMessage, s as UiSemanticsMap, si as FanCell, sn as MediaService, sr as formatNodePath, st as registerUndoShortcuts, t as EditingState, ti as ResourceOptions, tn as FontFaceLike, tr as UiPropOrigin, tt as StorageRead, u as markInstant, ui as FanOutOptions, un as RouterHistorySink, ur as printPropValue, ut as UndoStack, v as SemanticsMirror, vi as derive, vn as RouteOptions, vr as createComponent, vt as GessoAppOptions, w as ScrollService, wn as formatUrl, wr as pickKeys, wt as AppLogicEndpoint, x as EditingProxySink, xn as to, xr as isComponentElement, xt as WebMcpChoice, y as SemanticsMirrorSink, yi as ServiceRegistry, yn as RouteTarget, yr as ComponentElement, yt as createSyncApp, z as FrameService, zn as ShellFileRequest, zr as ThemeTokenCell, zt as PatchEntry } from "./index-XlACZQyY.js";
+import { $ as StorageAdapter, $n as UiNodeReport, $r as mutate, $t as UiFramePhase, A as Presence, An as AudioService, Ar as ChannelRegistry, At as createShellHistory, B as PersistedOptions, Bn as ShellFileResult, Br as themeTokenCell, Bt as UiTreeNode, C as FocusService, Cn as buildPath, Cr as pick, Ct as createApp, D as FindService, Dn as AudioMetadata, Dr as createChannelRegistry, Dt as ShellHistory, E as TextService, En as AudioAction, Er as ChannelRegistryHandle, Et as WorkerAppOptions, F as AudioSinkOptions, Fn as SpringOptions, Fr as Output, Ft as ConsoleEntry, G as IndexedDbStorage, Gn as ShellStorageOp, Gr as Each, Gt as ShellToRuntimeMessage, H as persisted, Hn as ShellRecentFile, Hr as Show, Ht as treeText, I as AudioSinkOutput, In as UiDuration, Ir as ControlledOptions, It as DevtoolsEvent, J as OpfsFileHandle, Jn as ColorSchemePreference, Jr as each, Jt as GessoRuntime, K as IndexedDbStorageOptions, Kn as ShellStorageResult, Kr as EachKey, Kt as FrameMetrics, L as MediaSessionLike, Ln as UiEasingChoice, Lr as ControlledValue, Lt as DevtoolsRequest, M as RouterOutlet, Mn as AudioStatus, Mr as Define, Mt as ActionEntry, N as AudioElementLike, Nn as AnimateOptions, Nr as Inject, Nt as ChannelErrorEntry, O as observeMediaQuery, On as AudioRequest, Or as findUnplainPath, Ot as ShellHistoryMode, P as AudioSink, Pn as AnimationService, Pr as Input, Pt as CommandEntry, Q as MemoryStorage, Qn as UiEnvironmentReport, Qr as Mutation, Qt as UI_FRAME_PHASES, R as audioClock, Rn as ShellFile, Rr as controlled, Rt as FrameEntry, S as writeClipboard, Sn as RouteParams, Sr as structurallyEqual, St as CreateAppOptions, T as EditingService, Tn as parseUrl, Tr as ChannelRegistration, Tt as WorkerApp, U as ShellStorage, Un as ShellRequest, Ur as ShowProps, Ut as RuntimeErrorSource, V as PersistedState, Vn as ShellFileType, Vr as bind, Vt as UiTreeSnapshot, W as ShellStorageOptions, Wn as ShellService, Wr as show, Wt as RuntimeToShellMessage, X as OpfsStorageOptions, Xn as BoundStream, Xr as throttled, Xt as RendererChoice, Y as OpfsStorage, Yn as observeColorScheme, Yr as debounced, Yt as GessoRuntimeOptions, Z as OpfsWritable, Zn as NodePathTarget, Zr as MutateOptions, Zt as RuntimeInput, _ as EditingMirrorTarget, _i as Equality, _n as RouteGuard, _r as OverlayService, _t as GessoApp, a as UiRole, ai as SelectOptions, an as FontService, ar as describeStream, at as storageReadValue, b as EditingProxy, bn as route, br as FrameworkChild, bt as GessoAppBuilder, c as UiSemanticsPatch, ci as FanKey, cn as RouteAnswer, cr as formatNodeReport, ct as UndoableOptions, d as markNow, di as fanOut, dn as RouterRoutes, dr as ComponentHostResolver, dt as UndoStackOptions, ei as Resource, en as FontFaceDeclaration, er as UiOwnerReport, et as StorageOutcome, f as measureSpan, fi as ComputedCell, fn as RouterService, fr as ComponentHost, ft as UndoTransaction, g as renderRoot, gi as DeriveOptions, gn as RouteDefinition, gr as OverlayRect, gt as shellStorageDenied, h as RenderWorkerApp, hi as computed, hn as RouteContext, hr as OverlayPlacement, ht as performShellStorage, i as UI_SEMANTIC_STATES, ii as resource, in as FontHost, ir as UiStreamReport, it as storageReadFailure, j as PresenceProps, jn as AudioState, jr as Channel, jt as ActionCause, k as observeReducedMotion, kn as AudioSample, kr as requirePlainData, kt as ShellHistoryOptions, l as UiSemanticsRecord, li as FanOut, ln as RouteMatch, lr as formatStream, lt as undoable, m as setPerformanceMarks, mi as ReadSource, mn as OutletProps, mr as OverlayEntry, mt as ShellLocalStore, n as MARK_PREFIX, ni as ResourceState, nn as FontFamilyDeclaration, nr as UiPropReport, nt as classifyStorageError, o as UiSemanticState, oi as select, on as MediaOptions, or as formatAge, ot as UndoShortcutOptions, p as performanceMarksEnabled, pi as ComputedOptions, pn as RouteState, pr as OverlayLayer, pt as rememberedDirectory, q as OpfsDirectory, qn as ColorScheme, qr as EachProps, qt as FramePhaseTimings, r as UI_ROLES, ri as ResourceStatus, rn as FontFamilyStatus, rr as UiSemanticsReport, rt as storageErrorMessage, s as UiSemanticsMap, si as FanCell, sn as MediaService, sr as formatNodePath, st as registerUndoShortcuts, t as EditingState, ti as ResourceOptions, tn as FontFaceLike, tr as UiPropOrigin, tt as StorageRead, u as markInstant, ui as FanOutOptions, un as RouterHistorySink, ur as printPropValue, ut as UndoStack, v as SemanticsMirror, vi as derive, vn as RouteOptions, vr as createComponent, vt as GessoAppOptions, w as ScrollService, wn as formatUrl, wr as pickKeys, wt as AppLogicEndpoint, x as EditingProxySink, xn as to, xr as isComponentElement, xt as WebMcpChoice, y as SemanticsMirrorSink, yi as ServiceRegistry, yn as RouteTarget, yr as ComponentElement, yt as createSyncApp, z as FrameService, zn as ShellFileRequest, zr as ThemeTokenCell, zt as PatchEntry } from "./index-NIdw2_S0.js";
 export { APPLICATION_WORKER, type ActionCause, type ActionEntry, type AnimateOptions, AnimationService, type AppLogicEndpoint, type AudioAction, type AudioElementLike, type AudioMetadata, type AudioRequest, type AudioSample, AudioService, AudioSink, type AudioSinkOptions, type AudioSinkOutput, type AudioState, type AudioStatus, type BoundStream, BoundsCell, Channel, type ChannelClientMessage, type ChannelErrorEntry, type ChannelHostMessage, type ChannelPort, type ChannelRegistration, ChannelRegistry, type ChannelRegistryHandle, ChannelReplica, type ChannelSchema, type ChannelSource, type ChannelSpec, type ChannelToken, type ClassComponent, type ColorScheme, type ColorSchemePreference, type Command, type CommandEntry, type CommandMap, type CommandSchema, type CommandsOf, Component, type ComponentContext, type ComponentElement, ComponentHost, ComponentHostResolver, type ComponentProps, type ComponentType, ComputedCell, type ComputedOptions, type ConsoleEntry, type ControlledOptions, type ControlledValue, type CreateAppOptions, Define, type DeriveOptions, type DevtoolsEvent, type DevtoolsRequest, Each, type EachKey, type EachProps, type EditingMirrorTarget, EditingProxy, type EditingProxySink, EditingService, type EditingState, type EmitArgs, type EmitValue, type Equality, FanCell, type FanKey, FanOut, type FanOutOptions, FindService, FocusService, type FontFaceDeclaration, type FontFaceLike, type FontFamilyDeclaration, type FontFamilyStatus, type FontHost, FontService, type FrameEntry, type FrameMetrics, type FramePhaseTimings, FrameService, type FrameworkChild, type FunctionComponent, GessoApp, GessoAppBuilder, type GessoAppOptions, GessoRuntime, type GessoRuntimeOptions, IndexedDbStorage, type IndexedDbStorageOptions, Inject, Input, InputCell, type InputValue, type Inputs, InternalState, type JsonSchema, MARK_PREFIX, type MediaOptions, MediaService, type MediaSessionLike, MemoryStorage, type MessageEndpoint, type MutateOptions, type Mutation, type NodePathTarget, type OpfsDirectory, type OpfsFileHandle, OpfsStorage, type OpfsStorageOptions, type OpfsWritable, type OutletProps, Output, type OutputCell, type OutputTarget, type OverlayEntry, OverlayLayer, type OverlayPlacement, type OverlayRect, OverlayService, type Patch, type PatchEntry, type PatchPath, type PersistedOptions, PersistedState, type PortHandshake, type PortHost, Presence, type PresenceProps, ProvidedChannel, type ReadSource, type ReadableCell, RenderWorkerApp, type RendererChoice, Resource, type ResourceOptions, type ResourceState, type ResourceStatus, type RouteAnswer, type RouteContext, type RouteDefinition, type RouteGuard, type RouteMatch, type RouteOptions, type RouteParams, RouteState, type RouteTarget, type RouterHistorySink, RouterOutlet, type RouterRoutes, RouterService, type RuntimeErrorSource, type RuntimeInput, type RuntimeToShellMessage, ScrollService, type SelectOptions, SemanticsMirror, type SemanticsMirrorSink, type ServedChannel, ServiceRegistry, type ShellFile, type ShellFileRequest, type ShellFileResult, type ShellFileType, type ShellHistory, type ShellHistoryMode, type ShellHistoryOptions, type ShellLocalStore, type ShellRecentFile, type ShellRequest, ShellService, ShellStorage, type ShellStorageOp, type ShellStorageOptions, type ShellStorageResult, type ShellToRuntimeMessage, Show, type ShowProps, type SpringOptions, type StorageAdapter, type StorageOutcome, type StorageRead, TextService, ThemeTokenCell, UI_FRAME_PHASES, UI_ROLES, UI_SEMANTIC_STATES, type UiDuration, type UiEasingChoice, type UiEnvironmentReport, type UiFramePhase, type UiNodeReport, type UiOwnerReport, type UiPropOrigin, type UiPropReport, type UiRole, type UiSemanticState, type UiSemanticsMap, type UiSemanticsPatch, type UiSemanticsRecord, type UiSemanticsReport, type UiStreamReport, type UiTreeNode, type UiTreeSnapshot, type UndoShortcutOptions, UndoStack, type UndoStackOptions, type UndoTransaction, type UndoableOptions, type ViewOf, type WebMcpChoice, WorkerApp, type WorkerAppOptions, type WorkerHandle, applyPatch, applyPatches, audioClock, bind, bounds, buildPath, channel, channelSchema, classifyStorageError, computed, controlled, createApp, createChannelRegistry, createComponent, createShellHistory, createSyncApp, debounced, defineChannel, derive, describeChannel, describeStream, diffProjection, each, fanOut, findUnplainPath, formatAge, formatNodePath, formatNodeReport, formatStream, formatUrl, input, internalState, into, isChannelClientMessage, isChannelHostMessage, isClassComponent, isComponentElement, isHubMessage, isOutputTarget, isPortErrorMessage, isPortHandshake, markInstant, markNow, measureSpan, mutate, observeColorScheme, observeMediaQuery, observeReducedMotion, output, parseUrl, performShellStorage, performanceMarksEnabled, persisted, pick, pickKeys, portHandle, printPropValue, provide, registerUndoShortcuts, rememberedDirectory, renderRoot, requirePlainData, resource, route, select, serve, serveChannels, servePorts, setPerformanceMarks, shellStorageDenied, show, storageErrorMessage, storageReadFailure, storageReadValue, structurallyEqual, themeTokenCell, throttled, to, treeText, undoable, viewKeys, workerHandle, writeClipboard };

package/dist/index.js

@@ -4,7 +4,7 @@ import { a as Each, i as show, n as getComponentMetadata, o as each, r as Show,
 import { c as findUnplainPath, d as describeChannel, l as requirePlainData, t as AGENT_PORT, u as channelSchema } from "./remote-BoB8zh7z.js";
 import { n as serveApplicationAgent } from "./app-Yig59Ygf.js";
 import { BehaviorSubject, EMPTY, Observable, Subject, Subscription, distinctUntilChanged, map } from "rxjs";
-import { AnimationDriver, Box, Canvas2DRenderer, CanvasPlatformSurface, CanvasTextMeasurer, Constraints, DefaultImageResolver, DefaultVideoResolver, DirtyFlags, EnvironmentNotifier, FocusNotifier, IconRasterizer, LayoutEngine, LayoutInspector, LayoutNotifier, MARK_PREFIX, Stack, TEXT_RUN_ID_SEPARATOR, UI_ROLES, UI_SEMANTIC_STATES, UiAnimationFrameClock, UiEditingController, UiEnvironmentKeys, UiEventType, UiFindController, UiFocusManager, UiFrame, UiGestureRecognizer, UiGraph, UiGraphBuilder, UiHitTester, UiHostFrameClock, UiInputDispatcher, UiInsetRegistry, UiKeyboardController, UiNodeType, UiPlatformAdapter, UiPointerController, UiPointerEvent, UiScheduler, UiSelectionController, UiSharedElements, UiSpring, UiTimerFrameClock, UiTouchScroller, UiVirtualSheet, UiVirtualWindow, UiWheelController, VIRTUAL_INDEX_PROP, VIRTUAL_LEAD_PROP, VIRTUAL_SHEET_PROP, VIRTUAL_WINDOW_PROP, WebGPURenderer, buildSemanticsSubtree, buildSemanticsTree, bumpFontStack, capturePointer, createCanvasSurface, createTween, createWebGPUSurface, defaultMotion, defineModifier, describeOverrides, diffSemantics, dragSessionFor, dropIndexShifts, easings, fade, formatExplanation, insetsEqual, isComponentLikeElement, isImeKey, isObservable, isWebGPUAvailable, linear, linkOf, markInstant, markNow, measure, measureSpan, motion, noInsets, observeViewportInsets, percent, performanceMarksEnabled, pointerDeviceOf, prepareInputSurface, propertyEffects, recordsEqual, registerFontStack, resolveCursor, rewalkSemantics, scrollRange, scrollbarThumb, semanticsInertAbove, semanticsMemory, setPerformanceMarks, setPerformanceMarks as setPerformanceMarks$1, textRunOfRecordId, themeTokens, touchActionFor, wheelDeltaYOf } from "gesso-core";
+import { AnimationDriver, Box, Canvas2DRenderer, CanvasPlatformSurface, CanvasTextMeasurer, Constraints, DefaultImageResolver, DefaultVideoResolver, DirtyFlags, EnvironmentNotifier, FocusNotifier, IconRasterizer, LayoutEngine, LayoutInspector, LayoutNotifier, MARK_PREFIX, Stack, TEXT_RUN_ID_SEPARATOR, UI_ROLES, UI_SEMANTIC_STATES, UiAnimationFrameClock, UiEditingController, UiEnvironmentKeys, UiEventType, UiFindController, UiFocusManager, UiFrame, UiGestureRecognizer, UiGraph, UiGraphBuilder, UiHitTester, UiHostFrameClock, UiInputDispatcher, UiInsetRegistry, UiKeyboardController, UiNodeType, UiPlatformAdapter, UiPointerController, UiPointerEvent, UiScheduler, UiSelectionController, UiSharedElements, UiSpring, UiTimerFrameClock, UiTouchScroller, UiVirtualSheet, UiVirtualWindow, UiWheelController, VIRTUAL_INDEX_PROP, VIRTUAL_LEAD_PROP, VIRTUAL_SHEET_PROP, VIRTUAL_WINDOW_PROP, WebGPURenderer, buildSemanticsSubtree, buildSemanticsTree, bumpFontStack, capturePointer, createCanvasSurface, createTween, createWebGPUSurface, defaultMotion, defineModifier, describeOverrides, diffSemantics, dragSessionFor, dropIndexShifts, easings, fade, formatExplanation, insetsEqual, isComponentLikeElement, isImeKey, isObservable, isWebGPUAvailable, linear, linkOf, markInstant, markNow, measure, measureSpan, motion, noInsets, observeViewportInsets, percent, performanceMarksEnabled, pointerDeviceOf, prepareInputSurface, propertyEffects, recordsEqual, registerFontStack, resolveCursor, rewalkSemantics, scrollBounds, scrollRange, scrollbarThumb, scrollsFromRight, semanticsInertAbove, semanticsMemory, setPerformanceMarks, setPerformanceMarks as setPerformanceMarks$1, textRunOfRecordId, themeTokens, touchActionFor, wheelDeltaYOf } from "gesso-core";
 //#region src/Component.ts
 /**
 * Base class for all Gesso framework components.
@@ -832,6 +832,27 @@ function isClassComponent(component) {
 //#endregion
 //#region src/overlay/OverlayService.ts
 /**
+* A placement turned into the physical one the layout engine places by,
+* in a reading direction.
+*
+* The engine knows only screen edges: `bottom-start` to it is the
+* anchor's left edge. Resolving here, rather than teaching the engine
+* directions, keeps the engine's `placement` the plain property it is
+* for any absolutely positioned node, and puts the decision where the
+* direction is known: the overlay layer reads it from the tree that
+* declared the entry.
+*/
+function physicalPlacement(placement, rtl) {
+	const [side, align] = placement.split("-");
+	if (side === "top" || side === "bottom") {
+		if (align === void 0 || !rtl) return placement;
+		return `${side}-${align === "start" ? "end" : "start"}`;
+	}
+	if (side === "left" || side === "right") return placement;
+	const physical = side === "start" !== rtl ? "left" : "right";
+	return align === void 0 ? physical : `${physical}-${align}`;
+}
+/**
 * The open overlays, as a local store.
 *
 * Every runtime registers one. Components inject it and open or close
@@ -888,16 +909,16 @@ let OverlayLayer = class OverlayLayer extends Component {
 	renderEntries(entries) {
 		const elements = [];
 		for (const entry of entries) {
+			const environment = entry.environment ?? entry.anchor ?? null;
 			if (entry.dismissOnOutsidePress === true || entry.modal === true) {
 				const dismiss = entry.dismissOnOutsidePress === true;
-				const environment = entry.environment ?? entry.anchor ?? null;
 				elements.push(Box({
 					key: `${entry.id}\0backdrop`,
 					position: "absolute",
 					inset: 0,
 					zIndex: entry.zIndex,
 					...inheritedFrom(environment),
-					modifiers: followEnvironment(environment),
+					modifiers: followEnvironment(environment, null),
 					...dismiss ? {
 						onPointerDown: () => this.overlays.close(entry.id),
 						onWheel: () => this.overlays.close(entry.id)
@@ -910,16 +931,14 @@ let OverlayLayer = class OverlayLayer extends Component {
 				anchor: entry.anchor ?? void 0,
 				anchorPoint: entry.anchor == null ? entry.point : void 0,
 				anchorRect: entry.anchor == null ? void 0 : entry.anchorRect,
-				placement: entry.placement,
 				anchorOffset: entry.offset,
 				top: entry.top,
-				right: entry.right,
 				bottom: entry.bottom,
-				left: entry.left,
 				zIndex: entry.zIndex,
 				...centering(entry),
-				...inheritedFrom(entry.environment ?? entry.anchor ?? null),
-				modifiers: followEnvironment(entry.environment ?? entry.anchor ?? null)
+				...physicalEdges(entry, readsRightToLeft(environment)),
+				...inheritedFrom(environment),
+				modifiers: followEnvironment(environment, entry)
 			}, entry.content));
 		}
 		return elements;
@@ -956,7 +975,8 @@ function scrim() {
 * across the viewport, and a Box is a Stack — so `x`/`y` centre the
 * content inside that span. The edges default to 0 but an entry that
 * gave one keeps it, which is what centres a toast horizontally
-* without lifting it off the bottom.
+* without lifting it off the bottom. The horizontal edges are
+* `physicalEdges`', since an entry may give them as `start` and `end`.
 *
 * The stretched box is `hitTestable: false`, since it is now much
 * bigger than what it holds: a press in the space beside a centred
@@ -970,11 +990,7 @@ function centering(entry) {
 	const y = entry.center === "y" || entry.center === "both";
 	return {
 		hitTestable: false,
-		...x ? {
-			left: entry.left ?? 0,
-			right: entry.right ?? 0,
-			x: "center"
-		} : {},
+		...x ? { x: "center" } : {},
 		...y ? {
 			top: entry.top ?? 0,
 			bottom: entry.bottom ?? 0,
@@ -982,6 +998,31 @@ function centering(entry) {
 		} : {}
 	};
 }
+/** Whether the scoped text style at a node reads right to left, as the entry's content will. */
+function readsRightToLeft(node) {
+	return node?.environment?.get(UiEnvironmentKeys.textStyle).textDirection === "rtl";
+}
+/**
+* The entry's placement and horizontal edges, with `start` and `end`
+* turned into the physical ones the layout engine takes.
+*
+* A logical edge wins over the physical one it lands on, so an entry
+* that gives both says which it meant. A centred entry's edges are the
+* span it centres in, and default to the viewport's.
+*/
+function physicalEdges(entry, rtl) {
+	let left = (rtl ? entry.end : entry.start) ?? entry.left;
+	let right = (rtl ? entry.start : entry.end) ?? entry.right;
+	if ((entry.center === "x" || entry.center === "both") && (entry.anchor ?? null) === null) {
+		left ??= 0;
+		right ??= 0;
+	}
+	return {
+		placement: entry.placement === void 0 ? void 0 : physicalPlacement(entry.placement, rtl),
+		left,
+		right
+	};
+}
 /**
 * The scoped values an entry's content should keep, re-provided on the
 * box that holds it, as they are when the entry opens.
@@ -1003,21 +1044,32 @@ function inheritedFrom(node) {
 * Reading them once let a dialog open while the page went dark (the
 * system's setting changed, or the theme a person chose arrived from
 * another worker a moment after they opened it) stay light over a dark
-* page until it was closed.
+* page until it was closed. The reading direction is one of them, and
+* the edges it decides are placed again with it.
 */
 const followEnvironmentKind = defineModifier({
 	name: "overlayEnvironment",
-	attach(host, from) {
+	attach(host, { from, entry }) {
 		host.onEnvironment(() => {
 			host.set("theme", host.environment(UiEnvironmentKeys.theme, from));
-			host.set("textStyle", host.environment(UiEnvironmentKeys.textStyle, from));
+			const textStyle = host.environment(UiEnvironmentKeys.textStyle, from);
+			host.set("textStyle", textStyle);
 			host.set("color", host.environment(UiEnvironmentKeys.color, from));
 			host.set("contentColor", host.environment(UiEnvironmentKeys.contentColor, from));
+			if (entry !== null) {
+				const edges = physicalEdges(entry, textStyle.textDirection === "rtl");
+				host.set("placement", edges.placement);
+				host.set("left", edges.left);
+				host.set("right", edges.right);
+			}
 		}, from);
 	}
 });
-function followEnvironment(node) {
-	return node === null ? [] : [followEnvironmentKind(node)];
+function followEnvironment(node, entry) {
+	return node === null ? [] : [followEnvironmentKind({
+		from: node,
+		entry
+	})];
 }
 //#endregion
 //#region src/ComponentElement.ts
@@ -3483,6 +3535,10 @@ const RECORD_ATTRIBUTES = [
 	"aria-posinset",
 	"aria-setsize",
 	"aria-level",
+	"aria-rowindex",
+	"aria-colindex",
+	"aria-rowcount",
+	"aria-colcount",
 	"aria-checked",
 	"aria-expanded",
 	"aria-selected",
@@ -3709,6 +3765,10 @@ var SemanticsMirror = class {
 		setNumber(element, "aria-posinset", record.posInSet);
 		setNumber(element, "aria-setsize", record.setSize);
 		setNumber(element, "aria-level", record.level);
+		setNumber(element, "aria-rowindex", record.rowIndex);
+		setNumber(element, "aria-colindex", record.columnIndex);
+		setNumber(element, "aria-rowcount", record.rowCount);
+		setNumber(element, "aria-colcount", record.columnCount);
 		if (record.valueText !== void 0) element.setAttribute("aria-valuetext", record.valueText);
 		if (record.activeDescendant !== void 0) element.setAttribute("aria-activedescendant", this.idPrefix + record.activeDescendant);
 		if (record.controls !== void 0) element.setAttribute("aria-controls", this.idPrefix + record.controls);
@@ -4911,6 +4971,7 @@ var WorkerApp = class {
 	forwardKeyUp(event) {
 		if (isImeKey(event)) return;
 		this.flushPendingMove();
+		if (this.options.interceptKey?.(event) === true) event.preventDefault();
 		this.post({
 			type: "keyUp",
 			key: event.key,
@@ -7394,13 +7455,13 @@ const SCROLL_SPRING = {
 var SmoothScroller = class {
 	graph;
 	animations;
-	limitOf;
+	boundsOf;
 	/** One cell per (node, axis), kept for the node's life. */
 	cells = /* @__PURE__ */ new Map();
-	constructor(graph, animations, limitOf) {
+	constructor(graph, animations, boundsOf) {
 		this.graph = graph;
 		this.animations = animations;
-		this.limitOf = limitOf;
+		this.boundsOf = boundsOf;
 	}
 	/**
 	* Moves the container by a delta, animating to the sum.
@@ -7416,8 +7477,8 @@ var SmoothScroller = class {
 	scrollBy(node, axis, delta, from) {
 		const cell = this.cellFor(node, axis).cell;
 		const pending = this.destinationOf(cell);
-		const limit = this.limitOf(node, axis);
-		const target = clamp((pending ?? from) + delta, 0, limit);
+		const { min, max } = this.boundsOf(node, axis);
+		const target = clamp((pending ?? from) + delta, min, max);
 		if (pending !== void 0 && target === pending) return;
 		this.animations.spring(cell, target, { spring: SCROLL_SPRING });
 	}
@@ -7923,8 +7984,11 @@ var GessoRuntime = class {
 		this.services.get(AudioService).setAnimations(this.services.get(AnimationService));
 		this.smoothScroller = new SmoothScroller(this.graph, this.services.get(AnimationService), (node, axis) => {
 			const record = this.engine.recordFor(node);
-			if (record === void 0) return 0;
-			return scrollRange(record, axis === "scrollY" ? "y" : "x");
+			if (record === void 0) return {
+				min: 0,
+				max: 0
+			};
+			return scrollBounds(record, axis === "scrollY" ? "y" : "x");
 		});
 		if (!this.services.has(RouterService)) this.services.register(RouterService);
 		const router = this.services.get(RouterService);
@@ -9750,15 +9814,17 @@ var GessoRuntime = class {
 		const going = (node, record, axis) => {
 			const written = node.getProperty(axis === "x" ? "scrollX" : "scrollY");
 			const offset = typeof written === "number" ? written : axis === "x" ? record.scrollX : record.scrollY;
-			return Math.min(Math.max(offset, 0), scrollRange(record, axis));
+			const { min, max } = scrollBounds(record, axis);
+			return Math.min(Math.max(offset, min), max);
 		};
+		const fromLow = (node, record, axis) => going(node, record, axis) - scrollBounds(record, axis).min;
 		return {
 			containerState: (node) => {
 				const record = this.engine.recordFor(node);
 				if (record === void 0) return;
 				return {
-					scrollX: going(node, record, "x"),
-					scrollY: going(node, record, "y"),
+					scrollX: fromLow(node, record, "x"),
+					scrollY: fromLow(node, record, "y"),
 					maxScrollX: scrollRange(record, "x"),
 					maxScrollY: scrollRange(record, "y"),
 					horizontal: node.getProperty("direction") === "row" || node.type === UiNodeType.Row,
@@ -9852,7 +9918,9 @@ var GessoRuntime = class {
 			if (rec === void 0) continue;
 			const column = window.axis === "column";
 			const scrollProp = node.properties.get(column ? "scrollY" : "scrollX");
-			const scroll = typeof scrollProp === "number" ? scrollProp : column ? rec.scrollY : rec.scrollX;
+			const offset = typeof scrollProp === "number" ? scrollProp : column ? rec.scrollY : rec.scrollX;
+			const sign = !column && scrollsFromRight(rec) ? -1 : 1;
+			const scroll = sign * offset;
 			const measures = [];
 			const lead = this.collectVirtualMeasures(node, column, measures);
 			const result = window.update({
@@ -9862,10 +9930,12 @@ var GessoRuntime = class {
 			}, measures);
 			if (result.scrollAdjust !== 0) {
 				const axis = column ? "scrollY" : "scrollX";
-				node.setProperty(axis, scroll + result.scrollAdjust);
+				const adjust = sign * result.scrollAdjust;
+				node.setProperty(axis, offset + adjust);
 				this.graph.markDirty(node, DirtyFlags.Transform);
-				this.smoothScroller.adjust(node, axis, result.scrollAdjust);
+				this.smoothScroller.adjust(node, axis, adjust);
 			}
+			if (window.holding) this.scheduler.wake();
 		}
 	}
 	/**
@@ -9885,11 +9955,13 @@ var GessoRuntime = class {
 		if (rec === void 0) return;
 		const x = node.properties.get("scrollX");
 		const y = node.properties.get("scrollY");
+		const sign = scrollsFromRight(rec) ? -1 : 1;
 		sheet.update({
-			scrollX: typeof x === "number" ? x : rec.scrollX,
+			scrollX: sign * (typeof x === "number" ? x : rec.scrollX),
 			scrollY: typeof y === "number" ? y : rec.scrollY,
 			width: rec.width,
-			height: rec.height
+			height: rec.height,
+			fromRight: sign < 0
 		});
 	}
 	/**