gesso-framework 0.6.27 → 0.6.29

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # gesso-framework
 
+## 0.6.29
+
+### Patch Changes
+
+- 0e62c11: An app opened at a deep link now starts on the screen that link names. The runtime builds its tree as it is constructed, and the window's address used to reach it afterwards, so for a moment every app was at `/`: its root route's screen was built and its effects ran before the real address moved it on. An app whose home screen does something on mount, such as opening the last document used, did it for a tab opened at `/d/new`.
+
+  `GessoRuntimeOptions.url` is new: the address to start at, resolved before the routes so the first tree is the right one and no guard on `/` runs for a window that was never there. Both hosts pass it — the worker host in its `init` message, the single-thread host from its history — and `setUrl` is for every address after. A guard that redirects the starting address is still reported to the shell as a replace, held until the shell is listening as other early requests are.
+
+- gesso-core@0.6.29
+
+## 0.6.28
+
+### Patch Changes
+
+- gesso-core@0.6.28
+
 ## 0.6.27
 
 ### Patch Changes

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

@@ -3439,6 +3439,19 @@ interface GessoRuntimeOptions {
    * that moment.
    */
   routes?: RouterRoutes;
+  /**
+   * The window's address at start-up, resolved before the tree is
+   * built.
+   *
+   * Without it the router starts at `/`, and the tree built in this
+   * constructor is the root route's — its screen constructed, its
+   * effects run — before the shell's `setUrl` moves it somewhere else.
+   * An app opened at `/d/42` would mount its home screen first, and a
+   * home screen that does something on mount (opens the last document,
+   * say) does it, for a url nobody asked for. Both hosts pass the
+   * address here; `setUrl` is for every one after.
+   */
+  url?: string;
   /**
    * The channels this runtime's components may reach.
    *
@@ -3907,6 +3920,8 @@ declare class GessoRuntime {
    * clipboard writes and URLs to open. Without a listener they are
    * dropped.
    */
+  /** A request for the shell: sent, or held until `onShellRequest` gives it somewhere to go. */
+  private toShell;
   onShellRequest(listener: ((request: ShellRequest) => void) | null): void;
   /**
    * Receives what components ask of the shell's audio element through
@@ -4757,6 +4772,13 @@ type ShellToRuntimeMessage = {
    * is the only per-frame cost the mirror has in here.
    */
   accessibility?: boolean;
+  /**
+   * The window's address at start-up, so the first tree is built on
+   * the screen it names. Optional for a shell that predates it,
+   * which reports the address in a `url` message after this one
+   * and so starts on the root route for a frame, as it always did.
+   */
+  url?: string;
 } | {
   type: 'resize';
   width: number;
@@ -6200,11 +6222,15 @@ declare class WorkerApp {
   private readonly handleAppWorkerMessage;
   private readonly handleWorkerMessage;
   /**
-   * Reports the window's address to the worker, and keeps reporting it.
+   * Keeps the worker told of the window's address, and answers the one
+   * it starts at.
    *
-   * Sent once at start-up as well as on change, for the same reason
-   * `reducedMotion` is: an app opened directly at a url must start on
-   * the screen that url names, not on its root.
+   * That first one is not posted from here: `mount` puts it on `init`,
+   * because an app opened directly at a url must start on the screen
+   * that url names. Posted after `init`, as it used to be, it reached a
+   * render worker that had already built its tree on the root route
+   * and run that screen's effects — an app that opened its last
+   * document on `/` did so for a tab opened at `/d/new`.
    */
   private attachHistory;
   /**
@@ -6676,7 +6702,6 @@ declare class GessoApp {
   private readonly inputEnabled;
   private readonly accessibilityEnabled;
   private readonly adapter;
-  private readonly historyOptions;
   private readonly onOpenRoute;
   private running;
   private resizeObserver;
@@ -8838,4 +8863,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-NIdw2_S0.d.ts.map
+//# sourceMappingURL=index-DZbSb8IN.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-NIdw2_S0.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-DZbSb8IN.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

@@ -4803,6 +4803,7 @@ var WorkerApp = class {
 		worker.addEventListener("message", this.handleWorkerMessage);
 		worker.addEventListener("error", this.handleWorkerFailure);
 		const { width, height } = measure$1(canvas, element);
+		const url = this.attachHistory();
 		const transfer = [offscreen];
 		let appPort;
 		if (this.options.appLogicWorker !== void 0) {
@@ -4831,10 +4832,10 @@ var WorkerApp = class {
 			renderer: this.options.renderer,
 			textInput: "proxy",
 			accessibility: this.options.accessibility !== false,
-			appPort
+			appPort,
+			url
 		}, transfer);
 		this.observeResize(element);
-		this.attachHistory();
 		this.detachInput = this.attachInput(canvas);
 		this.audio = new AudioSink({
 			sample: (sample) => this.post({
@@ -5297,11 +5298,15 @@ var WorkerApp = class {
 		if (message.type === "history") this.applyHistory(message.action, message.url);
 	};
 	/**
-	* Reports the window's address to the worker, and keeps reporting it.
+	* Keeps the worker told of the window's address, and answers the one
+	* it starts at.
 	*
-	* Sent once at start-up as well as on change, for the same reason
-	* `reducedMotion` is: an app opened directly at a url must start on
-	* the screen that url names, not on its root.
+	* That first one is not posted from here: `mount` puts it on `init`,
+	* because an app opened directly at a url must start on the screen
+	* that url names. Posted after `init`, as it used to be, it reached a
+	* render worker that had already built its tree on the root route
+	* and run that screen's effects — an app that opened its last
+	* document on `/` did so for a tab opened at `/d/new`.
 	*/
 	attachHistory() {
 		const { history, owned } = resolveShellHistory(this.options.history);
@@ -5311,10 +5316,7 @@ var WorkerApp = class {
 			type: "url",
 			url
 		}));
-		this.post({
-			type: "url",
-			url: history.url
-		});
+		return history.url;
 	}
 	/**
 	* Opens a popup for the render worker and tells it what happened.
@@ -7962,10 +7964,7 @@ var GessoRuntime = class {
 		});
 		if (!this.services.has(OverlayService)) this.services.register(OverlayService);
 		if (!this.services.has(ShellService)) this.services.register(ShellService);
-		this.services.get(ShellService).setHandler((request) => {
-			if (this.shellListener !== null && this.shellListener !== void 0) this.shellListener(request);
-			else if (this.heldShellRequests.length < HELD_SHELL_REQUESTS) this.heldShellRequests.push(request);
-		});
+		this.services.get(ShellService).setHandler((request) => this.toShell(request));
 		if (!this.services.has(AudioService)) this.services.register(AudioService);
 		this.services.get(AudioService).setHandler((request) => this.audioListener?.(request));
 		if (!this.services.has(FindService)) this.services.register(FindService);
@@ -7993,25 +7992,26 @@ var GessoRuntime = class {
 		if (!this.services.has(RouterService)) this.services.register(RouterService);
 		const router = this.services.get(RouterService);
 		router.setHistory({
-			push: (url) => this.shellListener?.({
+			push: (url) => this.toShell({
 				type: "history",
 				action: "push",
 				url
 			}),
-			replace: (url) => this.shellListener?.({
+			replace: (url) => this.toShell({
 				type: "history",
 				action: "replace",
 				url
 			}),
-			back: () => this.shellListener?.({
+			back: () => this.toShell({
 				type: "history",
 				action: "back"
 			}),
-			forward: () => this.shellListener?.({
+			forward: () => this.toShell({
 				type: "history",
 				action: "forward"
 			})
 		});
+		if (options.url !== void 0) router.applyUrl(options.url);
 		if (options.routes !== void 0) router.setRoutes(options.routes);
 		if (options.media?.resolver !== void 0) this.services.get(MediaService).setResolver(options.media.resolver);
 		if (options.media?.rasterizer !== void 0) this.services.get(MediaService).setRasterizer(options.media.rasterizer);
@@ -8512,6 +8512,11 @@ var GessoRuntime = class {
 	* clipboard writes and URLs to open. Without a listener they are
 	* dropped.
 	*/
+	/** A request for the shell: sent, or held until `onShellRequest` gives it somewhere to go. */
+	toShell(request) {
+		if (this.shellListener !== null && this.shellListener !== void 0) this.shellListener(request);
+		else if (this.heldShellRequests.length < HELD_SHELL_REQUESTS) this.heldShellRequests.push(request);
+	}
 	onShellRequest(listener) {
 		this.shellListener = listener;
 		if (listener !== null) {
@@ -10539,7 +10544,6 @@ var GessoApp = class {
 	inputEnabled;
 	accessibilityEnabled;
 	adapter;
-	historyOptions;
 	onOpenRoute;
 	running = false;
 	resizeObserver = null;
@@ -10573,9 +10577,11 @@ var GessoApp = class {
 		this.canvas = options.canvas ?? createCanvasElement();
 		this.inputEnabled = options.input ?? true;
 		this.accessibilityEnabled = options.accessibility ?? true;
-		this.historyOptions = options.history;
 		this.onOpenRoute = options.onOpenRoute;
 		this.colorSchemePreference = options.colorScheme ?? "auto";
+		const { history, owned } = resolveShellHistory(options.history);
+		this.history = history;
+		this.ownsHistory = owned;
 		this.runtime = new GessoRuntime({
 			root: options.root,
 			canvas: this.canvas,
@@ -10583,6 +10589,7 @@ var GessoApp = class {
 			services: options.services,
 			channels: options.channels,
 			routes: options.routes,
+			url: history.url,
 			media: options.media,
 			fonts: options.fonts,
 			clock: (callback) => {
@@ -10868,12 +10875,11 @@ var GessoApp = class {
 	* be a difference between the two hosts that nothing declared.
 	*/
 	attachHistory() {
-		const { history, owned } = resolveShellHistory(this.historyOptions);
-		this.history = history;
-		this.ownsHistory = owned;
+		const history = this.history;
+		if (history === null) return;
 		this.runtime.onShellRequest((request) => this.handleShellRequest(request, history));
 		history.onChange((url) => this.runtime.setUrl(url));
-		this.runtime.setUrl(history.url);
+		if (history.url !== this.runtime.services.get(RouterService).url.value) this.runtime.setUrl(history.url);
 	}
 	/**
 	* Reports the platform's safe area and soft keyboard to the runtime.
@@ -12045,7 +12051,7 @@ var RenderWorkerApp = class {
 	dispatch(message) {
 		if (message.type === "init") {
 			this.appLogicWorker = message.appPort === void 0 ? void 0 : portHandle(message.appPort);
-			this.initialize(message.canvas, message.width, message.height, message.dpr, message.renderer, message.accessibility !== false);
+			this.initialize(message.canvas, message.width, message.height, message.dpr, message.renderer, message.accessibility !== false, message.url);
 			this.runtime.setTextInputSource(message.textInput ?? "keys");
 			return;
 		}
@@ -12195,7 +12201,7 @@ var RenderWorkerApp = class {
 			worker: this.appLogicWorker
 		};
 	}
-	initialize(canvas, width, height, dpr, renderer, accessibility) {
+	initialize(canvas, width, height, dpr, renderer, accessibility, url) {
 		this.runtime?.dispose();
 		this.channels?.dispose();
 		this.channels = createChannelRegistry(this.channelRegistrations.map((registration) => registration.worker === void 0 && registration.source === void 0 ? {
@@ -12215,6 +12221,7 @@ var RenderWorkerApp = class {
 			root: this.root,
 			services,
 			routes: this.routes,
+			url,
 			media: this.media,
 			fonts: this.fonts,
 			canvas,