Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
SplitRouter
Leave guards
useBeforeLeave runs when a navigation leaves the registering route, closes its
pane, or changes an explicitly watched search namespace. Returning false keeps
the current destination. Solid cleanup only unregisters the guard. Routes that
share a mountKey count as one route: moving between them keeps the view
mounted and does not leave it.
Use context.onCommit(callback) to stage a synchronous side effect that must run
only after the navigation commits. Capture outgoing state while the guard runs;
the callback runs after the new panes and URL are applied, when the outgoing
component can already be disposed.
Callbacks belong to the navigation, not the guard phase or the mounted component. Refusal, cancellation, supersession, disposal, and failed application discard all staged callbacks. Unchanged navigation and activation of another content owner do not publish callbacks. Late registration after the guard phase ends is ignored. A throwing callback is logged without changing the successful navigation result or preventing later callbacks from running.
Preload and middleware errors that the router recovers from still allow commit
callbacks when navigation commits. Host-leave permission checks cannot confirm
that the host actually navigates, so their onCommit registration is a no-op.
Layout tree
panes.layout() is how the open panes tile: a tree of row (side by side)
and column (stacked) splits with each child's share. Its panes in
depth-first order are panes(), so positional sN.* search keys and history
state are unchanged. A new pane either splits an open pane (placement
{ split, side }) or becomes a column at insertAt. Removing a pane collapses
its split; moving panes keeps the tiles and refills them in the new order.
The URL records the tree only when some panes are stacked, in the layout
search key: p is a pane and r<n>/c<n> a split of the next n shapes, so a
pane beside two stacked panes is /a/~/b/~/c?layout=r2pc2pp. Without the key,
or when it doesn't fit the URL's panes, the panes sit in one row. Sizes stay
out of the URL; resizeLayout changes them, layoutSnapshot captures them,
and restoreLayout brings them back.
Parked layouts
layoutSnapshot and restoreLayout capture and bring back whole layouts.
To keep a layout's views mounted while another shows, park it instead:
openLayout shows a captured layout (or layoutFromHref) in new panes, and
showLayout shows retained panes again; both park the open panes, which leave
the URL but keep their histories in retainedPanes. Nothing leaves, so no
leave guard runs, unless closeOpen removes the open panes. discardPanes
forgets parked panes. URL navigation never reuses a parked pane id. Parked
panes keep their tiles: layoutOf says how a pane tiles, open or parked;
showLayout brings a group back in its tiles; and snapshots of parked panes
and layoutFromHref carry them.
Outlets
An outlet outside a pane renders the first available pane. While no pane exists,
it renders its supplied fallback without calling pane-scoped hooks. It starts
rendering the pane when one becomes available. An outlet already inside a pane
continues that pane's route branch, even when no explicit pane prop is given.
Route preloads resolve the destination leaf's toReference once and pass it to
ancestor data preload hooks. Canonical reference params preserve targets in both
scoped router search and external links. Hover preloads use the router lifetime
signal; disposing an account's router cancels deferred query admission.