@knpkv/rly 0.13.0 → 0.15.0

package/dist/dts/foundations/Icon.d.ts

@@ -1,6 +1,6 @@
 import type { ReactElement } from "react";
 /** Stable, presentation-only glyph names supported by rly. */
-export declare const RLY_ICON_NAMES: readonly ["arrow-down", "arrow-left", "arrow-right", "arrow-up", "check", "chevron-down", "chevron-left", "chevron-right", "chevron-up", "alert", "clock", "external-link", "file", "link", "loader", "menu", "minus", "plus", "search", "user", "close"];
+export declare const RLY_ICON_NAMES: readonly ["arrow-down", "arrow-left", "arrow-right", "arrow-up", "check", "chevron-down", "chevron-left", "chevron-right", "chevron-up", "alert", "clock", "external-link", "file", "link", "loader", "menu", "minus", "plus", "search", "user", "close", "pin"];
 /** A stable glyph name owned by rly rather than its icon implementation. */
 export type RlyIconName = (typeof RLY_ICON_NAMES)[number];
 /** Machine-readable icon size variants. */

package/dist/dts/foundations/Icon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../../../src/foundations/Icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAY,MAAM,OAAO,CAAA;AA4BlE,8DAA8D;AAC9D,eAAO,MAAM,cAAc,2PAsBzB,CAAA;AAEF,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB;;QAE1B,KAAK;YAAI,MAAM;YAAM,OAAO;;QAC5B,OAAO;YAAI,MAAM;YAAM,OAAO;;QAC9B,KAAK;YAAI,MAAM;YAAM,OAAO;;;CAe/B,CAAA;AAED,kEAAkE;AAClE,eAAO,MAAM,yBAAyB;;CAE2D,CAAA;AAEjG,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,iBAAiB,CAAC,IAAI,CAAA;AA4B7D,UAAU,eAAe;IACvB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED,UAAU,mBAAmB;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB;AAED,UAAU,oBAAoB;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,CAAC,mBAAmB,GAAG,oBAAoB,CAAC,CAAA;AAKtF,yFAAyF;AACzF,eAAO,MAAM,IAAI,UAAW,SAAS,KAAG,YAuBvC,CAAA"}
+{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../../../src/foundations/Icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAY,MAAM,OAAO,CAAA;AA6BlE,8DAA8D;AAC9D,eAAO,MAAM,cAAc,kQAuBzB,CAAA;AAEF,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB;;QAE1B,KAAK;YAAI,MAAM;YAAM,OAAO;;QAC5B,OAAO;YAAI,MAAM;YAAM,OAAO;;QAC9B,KAAK;YAAI,MAAM;YAAM,OAAO;;;CAe/B,CAAA;AAED,kEAAkE;AAClE,eAAO,MAAM,yBAAyB;;CAE2D,CAAA;AAEjG,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,iBAAiB,CAAC,IAAI,CAAA;AA6B7D,UAAU,eAAe;IACvB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED,UAAU,mBAAmB;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB;AAED,UAAU,oBAAoB;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,CAAC,mBAAmB,GAAG,oBAAoB,CAAC,CAAA;AAKtF,yFAAyF;AACzF,eAAO,MAAM,IAAI,UAAW,SAAS,KAAG,YAuBvC,CAAA"}

package/dist/dts/internal/composedFocus.d.ts

@@ -0,0 +1,11 @@
+interface ShadowRootHost extends Node {
+    readonly host: Element;
+}
+export declare const hasShadowRootHost: (value: Node) => value is ShadowRootHost;
+export declare const activeElementFor: (panel: HTMLElement) => Element | null;
+export declare const composedParentFor: (node: Node, composedParents?: ReadonlyMap<Node, Node | null>) => Element | null;
+export declare const isWithinComposedElement: (ancestor: Element, descendant: Node | null, composedParents?: ReadonlyMap<Node, Node | null>) => boolean;
+export declare const isWithinPanel: (panel: HTMLElement, active: Element | null) => boolean;
+export declare const focusRestoreTarget: (ownerDocument: Document) => HTMLElement | null;
+export {};
+//# sourceMappingURL=composedFocus.d.ts.map

package/dist/dts/internal/composedFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composedFocus.d.ts","sourceRoot":"","sources":["../../../src/internal/composedFocus.ts"],"names":[],"mappings":"AAMA,UAAU,cAAe,SAAQ,IAAI;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAED,eAAO,MAAM,iBAAiB,UAAW,IAAI,KAAG,KAAK,IAAI,cACC,CAAA;AAS1D,eAAO,MAAM,gBAAgB,UAAW,WAAW,KAAG,OAAO,GAAG,IAG/D,CAAA;AAgBD,eAAO,MAAM,iBAAiB,SAAU,IAAI,oBAAoB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,KAAG,OAAO,GAAG,IAO1G,CAAA;AAED,eAAO,MAAM,uBAAuB,aACxB,OAAO,cACL,IAAI,GAAG,IAAI,oBACL,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,KAC/C,OAaF,CAAA;AAED,eAAO,MAAM,aAAa,UAAW,WAAW,UAAU,OAAO,GAAG,IAAI,KAAG,OACnC,CAAA;AAQxC,eAAO,MAAM,kBAAkB,kBAAmB,QAAQ,KAAG,WAAW,GAAG,IAG1E,CAAA"}

package/dist/dts/internal/relaySummon.d.ts

@@ -0,0 +1,50 @@
+/** A key the summon machine listens for: the bound chord (Ctrl/⌘+J) or Escape. */
+export type RelaySummonKey = "chord" | "escape";
+/** What the machine needs to know at the moment a key arrives. */
+export interface RelaySummonContext {
+    readonly open: boolean;
+    /** Focus is inside the Relay region. */
+    readonly focusInRelay: boolean;
+    /** Relay is a full-screen dialog (phone), where the chord and Escape both close it. */
+    readonly fullscreen: boolean;
+}
+/**
+ * What a key does (Relay UX decision): closed → Open (focus the composer); open with focus on the page →
+ * FocusComposer; open with focus in Relay → ReturnFocus (back to where you were, Relay stays open);
+ * full screen, the chord closes. Escape closes when focus is in Relay or Relay is full screen, and is
+ * left to the page otherwise. Ignore means the event is not handled and must not be prevented.
+ */
+export type RelaySummonEffect = "Open" | "FocusComposer" | "ReturnFocus" | "Close" | "Ignore";
+export declare const relaySummonTransition: (context: RelaySummonContext, key: RelaySummonKey) => RelaySummonEffect;
+/** The parts of a keyboard event the summon reads. */
+export interface RelaySummonKeyEvent {
+    readonly altKey: boolean;
+    readonly code: string;
+    readonly ctrlKey: boolean;
+    readonly isComposing: boolean;
+    readonly key: string;
+    /** Deprecated, but 229 is still how some browsers mark a key that belongs to an IME. */
+    readonly keyCode: number;
+    readonly metaKey: boolean;
+    readonly repeat: boolean;
+    readonly shiftKey: boolean;
+}
+/** A key that belongs to an IME composition; Escape there cancels the composition, never Relay. */
+export declare const isImeKey: (event: RelaySummonKeyEvent) => boolean;
+/**
+ * Whether an event is exactly the shortcut's ARIA keys ("Control+J", "Meta+J"): the named modifiers and
+ * no others, so Ctrl+Shift+J, Alt chords, an IME composition or a held key's repeats never match. A
+ * Latin layout matches the letter the user sees (Dvorak, AZERTY); a non-Latin one (Russian, Greek), where
+ * the key is no ASCII letter, matches the physical key instead.
+ */
+export declare const matchesShortcutKeys: (keys: string, event: RelaySummonKeyEvent) => boolean;
+/**
+ * Whether a key event belongs to a layer nested in or opened from Relay: a dialog, a listbox or menu
+ * while it is an open popup (Radix's data-state, or the target of an expanded aria-controls), or an
+ * expanded popup controller inside Relay that keeps focus while its popup is open (a combobox). It reads
+ * the event's composed path up to Relay's region, so layers inside shadow roots and layers portaled out
+ * of Relay (whose path never reaches the region) count. Relay's own surface, marked
+ * data-rly-relay-surface (the full-screen dialog), and always-rendered lists never count.
+ */
+export declare const hasNestedLayer: (region: HTMLElement | null, path: ReadonlyArray<EventTarget>) => boolean;
+//# sourceMappingURL=relaySummon.d.ts.map

package/dist/dts/internal/relaySummon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relaySummon.d.ts","sourceRoot":"","sources":["../../../src/internal/relaySummon.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE/C,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,wCAAwC;IACxC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,eAAe,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE7F,eAAO,MAAM,qBAAqB,YAAa,kBAAkB,OAAO,cAAc,KAAG,iBAKxF,CAAA;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED,mGAAmG;AACnG,eAAO,MAAM,QAAQ,UAAW,mBAAmB,KAAG,OAAqD,CAAA;AAI3G;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,SAAU,MAAM,SAAS,mBAAmB,KAAG,OAe9E,CAAA;AAKD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,WAAY,WAAW,GAAG,IAAI,QAAQ,aAAa,CAAC,WAAW,CAAC,KAAG,OAU7F,CAAA"}

package/dist/dts/patterns/Region.d.ts

@@ -9,8 +9,8 @@ export declare const RLY_REGION_VARIANTS: {
         };
         readonly tray: {
             readonly className: string;
-            readonly purpose: "A region holding individually actionable cards, one surface step down so the cards stand out";
-            readonly tokens: readonly ["color-surface-2", "color-border-1"];
+            readonly purpose: "A region holding individually actionable cards; its body sits one surface step down so the cards stand out, under the same header as every region";
+            readonly tokens: readonly ["color-surface-1", "color-surface-2", "color-border-1"];
         };
     };
 };

package/dist/dts/patterns/Region.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Region.d.ts","sourceRoot":"","sources":["../../../src/patterns/Region.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAS,MAAM,OAAO,CAAA;AAM5F,qDAAqD;AACrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAa9B,CAAA;AAEF,8BAA8B;AAC9B,eAAO,MAAM,2BAA2B;;CAAsC,CAAA;AAE9E,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,CAAA;AAEzC,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG;IACvF,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAA;IAC7C;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAA;CAC9B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,4FAUhB,WAAW,KAAG,YA2BhB,CAAA"}
+{"version":3,"file":"Region.d.ts","sourceRoot":"","sources":["../../../src/patterns/Region.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAS,MAAM,OAAO,CAAA;AAM5F,qDAAqD;AACrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAc9B,CAAA;AAEF,8BAA8B;AAC9B,eAAO,MAAM,2BAA2B;;CAAsC,CAAA;AAE9E,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,CAAA;AAEzC,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG;IACvF,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAA;IAC7C;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAA;CAC9B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,4FAUhB,WAAW,KAAG,YA2BhB,CAAA"}

package/dist/dts/patterns/RelayComposer.d.ts

@@ -0,0 +1,65 @@
+import type { ReactElement, ReactNode, Ref } from "react";
+/** Something the message is about, shown as a removable chip ("patch-reader.ts lines 14 to 19"). */
+export interface RlyRelayContextRef {
+    readonly id: string;
+    readonly label: string;
+}
+/** One accepted-message request: the text and the client request id a retry must reuse. */
+export interface RlyRelaySubmission {
+    readonly requestId: string;
+    readonly text: string;
+}
+/** Inputs for the composer. */
+export interface RelayComposerProps {
+    /** Why Send is unavailable (a run in flight); shown, and announced with Send. */
+    readonly busyReason?: string | undefined;
+    readonly contextRefs?: ReadonlyArray<RlyRelayContextRef>;
+    /** The textarea's name, "Message Relay" unless the host names it. */
+    readonly label?: string;
+    readonly onRemoveContextRef?: (id: string) => void;
+    /** Called with Ctrl/⌘+Enter or Send when there is text and nothing blocks it. */
+    readonly onSend: () => void;
+    /** Stop the run; pass it only while a run is in flight and the session offers cancel. */
+    readonly onStop?: (() => void) | undefined;
+    readonly onValueChange: (value: string) => void;
+    readonly placeholder?: string;
+    /** One run preset control, usually a menu trigger ("Thorough review, Codex"). */
+    readonly preset?: ReactNode;
+    /** The textarea, for useRelaySummon's composerRef. */
+    readonly ref?: Ref<HTMLTextAreaElement>;
+    readonly value: string;
+}
+/**
+ * Relay's message box (Relay UX decision). It grows with its text up to min(12 lines, 40% of the
+ * viewport), then scrolls. Enter is a newline and Ctrl/⌘+Enter sends, said as visible text beside Send;
+ * an IME composition never sends. While `busyReason` is set, Send stays focusable (aria-disabled) so
+ * its reason is heard, and pressing it does nothing. Keep the value with `useRelayDraft`, keyed by the
+ * object Relay is about, so it survives closing, reopening and resizing.
+ */
+export declare const RelayComposer: ({ busyReason, contextRefs, label, onRemoveContextRef, onSend, onStop, onValueChange, placeholder, preset, ref, value }: RelayComposerProps) => ReactElement;
+/** A per-object draft: the value for the composer and the submission a send makes. */
+export interface RlyRelayDraft {
+    /** The request with this id was accepted: clear the draft, unless the user has typed since. */
+    readonly accepted: (requestId: string) => void;
+    readonly onValueChange: (value: string) => void;
+    /** The current text with a request id that stays the same until the text changes or is accepted. */
+    readonly submission: () => RlyRelaySubmission;
+    readonly value: string;
+}
+/** Storage a draft may survive a reload in; session storage, never local storage (drafts may be sensitive). */
+export type RlyRelayDraftStorage = Pick<Storage, "getItem" | "removeItem" | "setItem">;
+/** Inputs for {@link useRelayDraft}. */
+export interface UseRelayDraftOptions {
+    /** Mints a client request id (the host's own, e.g. a UUID from its runtime); rly owns no id source. */
+    readonly newRequestId: () => string;
+    /** Opt in to surviving a reload; read lazily, and any refusal keeps the draft in memory only. */
+    readonly storage?: () => RlyRelayDraftStorage;
+}
+/**
+ * The composer's draft for one object (the JSON ObjectRef, so PR A's draft can never send as PR B's).
+ * It lives in memory for the page, so closing, reopening or resizing Relay keeps it; with `storage`
+ * (session storage) it also survives a reload. A send reuses one request id until the text is edited,
+ * so a retry after an uncertain outcome is deduplicated and an edited message is a new one.
+ */
+export declare const useRelayDraft: (objectKey: string, options: UseRelayDraftOptions) => RlyRelayDraft;
+//# sourceMappingURL=RelayComposer.d.ts.map

package/dist/dts/patterns/RelayComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelayComposer.d.ts","sourceRoot":"","sources":["../../../src/patterns/RelayComposer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoD,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAY3G,oGAAoG;AACpG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IACxD,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAA;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,2HAYvB,kBAAkB,KAAG,YAuGvB,CAAA;AAOD,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9C,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,oGAAoG;IACpG,QAAQ,CAAC,UAAU,EAAE,MAAM,kBAAkB,CAAA;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,+GAA+G;AAC/G,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC,CAAA;AAEtF,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,uGAAuG;IACvG,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,CAAA;IACnC,iGAAiG;IACjG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,oBAAoB,CAAA;CAC9C;AAqDD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,cAAe,MAAM,WAAW,oBAAoB,KAAG,aAsDhF,CAAA"}

package/dist/dts/patterns/RelayDock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelayDock.d.ts","sourceRoot":"","sources":["../../../src/patterns/RelayDock.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"RelayDock.d.ts","sourceRoot":"","sources":["../../../src/patterns/RelayDock.tsx"],"names":[],"mappings":"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"}

package/dist/dts/patterns/RelayLauncher.d.ts

@@ -0,0 +1,67 @@
+import type { ComponentPropsWithRef, ReactElement, RefCallback, RefObject } from "react";
+/** The keyboard shortcut a launcher advertises: the visible hint and its `aria-keyshortcuts` value. */
+export interface RlyRelayShortcut {
+    /** Shown beside the label on wider screens, for example "⌘J" or "Ctrl J". */
+    readonly hint: string;
+    /** The ARIA form, for example "Meta+J" or "Control+J". */
+    readonly keys: string;
+}
+/** Relay's summon shortcut (Ctrl/⌘+J) as a platform shows it. */
+export declare const relayShortcut: (apple: boolean) => RlyRelayShortcut;
+/**
+ * Ctrl/⌘+J for the browser's platform, for a host that binds it. The server renders the non-Apple
+ * form and an Apple browser switches to ⌘ after hydration without a mismatch. A host that binds the
+ * key must also prevent the browser's own Ctrl+J (Downloads in Chrome on Windows and Linux).
+ */
+export declare const useRelayShortcut: () => RlyRelayShortcut;
+/** Inputs for {@link useRelaySummon}. */
+export interface UseRelaySummonOptions {
+    readonly open: boolean;
+    readonly onOpenChange: (open: boolean) => void;
+    /** Relay is the full-screen dialog (phone): the shortcut closes it. */
+    readonly fullscreen: boolean;
+    /** The launcher: where focus returns when the element Relay was summoned from is gone. */
+    readonly launcher: RefObject<HTMLElement | null>;
+    /**
+     * The shortcut to listen for, the same value the launcher advertises; `null` while the host's own
+     * surface owns the key (a live terminal). Escape inside Relay keeps working either way.
+     */
+    readonly shortcut: RlyRelayShortcut | null;
+}
+/** Refs a host attaches so the summon knows Relay's region and composer. */
+export interface RlyRelaySummon {
+    /** Attach to the composer; a pending summon focuses it as soon as it mounts, however late. */
+    readonly composerRef: RefCallback<HTMLElement>;
+    /** Attach to Relay's region (RelayPanel's `ref`); focus inside it counts as being in Relay. */
+    readonly regionRef: RefCallback<HTMLElement>;
+}
+/**
+ * Relay's keyboard summon (Relay UX decision). The shortcut opens Relay and focuses the composer; open
+ * with focus on the page, it moves focus to the composer; open with focus in Relay, it returns focus to
+ * where it came from and Relay stays open; full screen, it closes. Escape closes when focus is in Relay
+ * or Relay is full screen, and focus returns once Relay has actually closed (after a modal has released
+ * the page). Only the exact chord is handled and prevented, so Ctrl+K, `?`, g-sequences and the browser's
+ * other keys pass through. It listens on the launcher's document and on Relay's, if Relay is portaled
+ * into another (an iframe).
+ */
+export declare const useRelaySummon: (options: UseRelaySummonOptions) => RlyRelaySummon;
+/** Inputs for the launcher. */
+export type RelayLauncherProps = Omit<ComponentPropsWithRef<"button">, "children" | "type"> & {
+    /** Whether Relay is open; announced as the button's expanded state. */
+    readonly expanded: boolean;
+    /** The visible name, "Relay" unless the host names its Relay more specifically. */
+    readonly label?: string;
+    /**
+     * The shortcut the host actually binds, usually `useRelayShortcut()`, or `null` when it binds none
+     * (a live terminal that keeps its own chords). Required, so a launcher never advertises a key that
+     * does nothing.
+     */
+    readonly shortcut: RlyRelayShortcut | null;
+};
+/**
+ * The header button that opens and closes Relay: its mark, a label and the shortcut hint. It sits in
+ * the host's header like any other control, never fixed over the page. The hint hides on narrow
+ * screens, and the button stays 32px tall (44px for a coarse pointer).
+ */
+export declare const RelayLauncher: ({ className, expanded, label, shortcut, ...props }: RelayLauncherProps) => ReactElement;
+//# sourceMappingURL=RelayLauncher.d.ts.map

package/dist/dts/patterns/RelayLauncher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelayLauncher.d.ts","sourceRoot":"","sources":["../../../src/patterns/RelayLauncher.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAUxF,uGAAuG;AACvG,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,gBACiC,CAAA;AAShF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAO,gBAC+C,CAAA;AAEnF,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAChD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC3C;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;IAC9C,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;CAC7C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,YAAa,qBAAqB,KAAG,cAmH/D,CAAA;AAWD,+BAA+B;AAC/B,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,GAAG;IAC5F,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC3C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,uDAMvB,kBAAkB,KAAG,YAoBvB,CAAA"}

package/dist/dts/patterns/RelayMark.d.ts

@@ -0,0 +1,35 @@
+import type { ComponentPropsWithRef, ReactElement } from "react";
+/** Sizes the bare mark is drawn and checked at, in CSS pixels; 16 stays legible in one colour. */
+export declare const RLY_RELAY_MARK_SIZES: readonly [16, 20, 24, 32];
+/** One supported bare mark size. */
+export type RlyRelayMarkSize = (typeof RLY_RELAY_MARK_SIZES)[number];
+/** Sizes the tile is drawn at; its glyph is half the tile. */
+export declare const RLY_RELAY_MARK_TILE_SIZES: readonly [20, 24, 32];
+/** One supported tile size. */
+export type RlyRelayMarkTileSize = (typeof RLY_RELAY_MARK_TILE_SIZES)[number];
+type MarkBaseProps = Omit<ComponentPropsWithRef<"svg">, "children" | "height" | "viewBox" | "width">;
+/** Inputs for the bare mark. */
+export type RelayMarkProps = MarkBaseProps & {
+    /** 20px unless given. */
+    readonly size?: RlyRelayMarkSize;
+    /** Names the mark for assistive technology; without it the mark is decorative and hidden. */
+    readonly label?: string;
+};
+/** Inputs for the mark on an agent-coloured tile. */
+export type RelayMarkTileProps = Omit<ComponentPropsWithRef<"span">, "children"> & {
+    /** 24px unless given. */
+    readonly size?: RlyRelayMarkTileSize;
+    /** Names the tile for assistive technology; without it the tile is decorative and hidden. */
+    readonly label?: string;
+};
+/** The mark on an agent-coloured tile; in forced colours the tile becomes an outline in its context's colour. */
+declare const RelayMarkTile: ({ className, label, size, ...props }: RelayMarkTileProps) => ReactElement;
+/**
+ * Relay's mark, drawn in the current colour, so it follows its host's text in every theme and in
+ * forced colours. `RelayMark.Tile` sets it on the agent colour for headers and avatars.
+ */
+export declare const RelayMark: (({ className, label, size, ...props }: RelayMarkProps) => ReactElement) & {
+    Tile: typeof RelayMarkTile;
+};
+export {};
+//# sourceMappingURL=RelayMark.d.ts.map

package/dist/dts/patterns/RelayMark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelayMark.d.ts","sourceRoot":"","sources":["../../../src/patterns/RelayMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAMhE,kGAAkG;AAClG,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAoB,CAAA;AAC/E,oCAAoC;AACpC,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAgB,CAAA;AAC5E,+BAA+B;AAC/B,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7E,KAAK,aAAa,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;AA6BpG,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IACjF,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAA;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAyBD,iHAAiH;AACjH,QAAA,MAAM,aAAa,yCAA0C,kBAAkB,KAAG,YAYjF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,0CACmB,cAAc,KAAG,YAAY;;CASrE,CAAA"}

package/dist/dts/patterns/RelayPanel.d.ts

@@ -0,0 +1,91 @@
+import type { ReactElement, ReactNode, Ref, RefObject } from "react";
+/** How Relay is laid out: over the page, pinned beside it, or full screen. */
+export declare const RLY_RELAY_PANEL_PRESENTATIONS: readonly ["overlay", "pinned", "fullscreen"];
+/** One Relay presentation. */
+export type RlyRelayPanelPresentation = (typeof RLY_RELAY_PANEL_PRESENTATIONS)[number];
+/** The overlay's width, and the column a pinned Relay takes, in CSS pixels. */
+export declare const RLY_RELAY_PANEL_WIDTH = 440;
+/** What Relay is looking at: a label and, when it has one, the exact revision (shown in mono). */
+export interface RlyRelayScope {
+    readonly label: string;
+    readonly revision?: string;
+}
+/** One of Relay's views; a count is part of its name ("Findings 3"), never announced on change. */
+export interface RlyRelayPanelTab {
+    readonly content: ReactNode;
+    readonly count?: number;
+    readonly label: string;
+    readonly value: string;
+}
+/** The pin toggle, passed only when the host can pin Relay beside its page at this width. */
+export interface RlyRelayPanelPin {
+    readonly onPinnedChange: (pinned: boolean) => void;
+    readonly pinned: boolean;
+}
+interface RelayPanelBaseProps {
+    /** Status line under the header (freshness of what Relay read); not a live region. */
+    readonly freshness?: ReactNode;
+    /** Kept on screen under the body: the composer. */
+    readonly footer?: ReactNode;
+    /** Where focus returns when the panel closes itself (close button, Escape, full-screen dismissal). */
+    readonly launcher: RefObject<HTMLElement | null>;
+    /**
+     * Called by the close button and Escape. Closing hides Relay in every presentation; whether it was
+     * pinned is the host's remembered preference, restored when Relay opens again.
+     */
+    readonly onClose: () => void;
+    /** Thread options, usually one menu trigger. */
+    readonly options?: ReactNode;
+    readonly pin?: RlyRelayPanelPin | undefined;
+    readonly presentation: RlyRelayPanelPresentation;
+    /** The panel's region, for useRelaySummon. */
+    readonly ref?: Ref<HTMLElement>;
+    readonly scope: RlyRelayScope;
+    /** The panel's name, "Relay" unless the host names it more specifically. */
+    readonly title?: string;
+}
+interface RelayPanelTabsProps extends RelayPanelBaseProps {
+    readonly children?: never;
+    readonly onTabChange: (value: string) => void;
+    readonly selectedTab: string;
+    readonly tabs: ReadonlyArray<RlyRelayPanelTab>;
+}
+interface RelayPanelBodyProps extends RelayPanelBaseProps {
+    /** A single view (setup, for example), shown without tabs. */
+    readonly children: ReactNode;
+    readonly onTabChange?: never;
+    readonly selectedTab?: never;
+    readonly tabs?: never;
+}
+/** Inputs for the panel: tabbed views, or one body. */
+export type RelayPanelProps = RelayPanelTabsProps | RelayPanelBodyProps;
+/**
+ * Relay's frame (Relay UX decision). `overlay` floats over the right of the page with no backdrop and no
+ * focus trap; render it right after the launcher so Tab order follows. `pinned` is a sticky column for
+ * the host's grid. `fullscreen` is a modal dialog with the page inert. Only the body scrolls, so the
+ * header and the footer's composer stay on screen. Escape and the close button call `onClose` and return
+ * focus to the launcher; Escape is left to an IME composition and to dialogs or open popups inside.
+ * Changing presentation remounts the views and footer, so state that must survive (a composer draft)
+ * lives with the host or the composer, keyed by the object Relay is about.
+ */
+export declare const RelayPanel: (props: RelayPanelProps) => ReactElement;
+/** Inputs for {@link useRelayPresentation}. */
+export interface UseRelayPresentationOptions {
+    /** The user's pin preference, remembered by the host per product and viewport class. */
+    readonly pinned: boolean;
+    /** The narrowest width the host's own page stays usable at, beside a pinned Relay. */
+    readonly minHostWidth: number;
+}
+/** The presentation to render, and whether to offer the pin toggle. */
+export interface RlyRelayPresentation {
+    readonly canPin: boolean;
+    readonly presentation: RlyRelayPanelPresentation;
+}
+/**
+ * The presentation for the viewport (Relay UX decision): full screen at phone width; pinned when the user
+ * pinned it and the viewport is wide enough (≥1440 and the host's minimum beside the column); otherwise
+ * the overlay. The server renders the overlay. A host may still choose its own presentation.
+ */
+export declare const useRelayPresentation: ({ minHostWidth, pinned }: UseRelayPresentationOptions) => RlyRelayPresentation;
+export {};
+//# sourceMappingURL=RelayPanel.d.ts.map

package/dist/dts/patterns/RelayPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelayPanel.d.ts","sourceRoot":"","sources":["../../../src/patterns/RelayPanel.tsx"],"names":[],"mappings":"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"}

package/dist/dts/patterns/index.d.ts

@@ -34,8 +34,16 @@ export { RelationshipChain, RLY_RELATIONSHIP_DIRECTION_PRESENTATION, RLY_RELATIO
 export type { RelationshipChainProps, RlyMissingRelationshipEndpoint, RlyPresentRelationshipEndpoint, RlyRelationship, RlyRelationshipDirection, RlyRelationshipEndpoint, RlyRelationshipLifecycle } from "./RelationshipChain.js";
 export { RelationshipTable } from "./RelationshipTable.js";
 export type { RelationshipTableProps } from "./RelationshipTable.js";
+export { RelayComposer, useRelayDraft } from "./RelayComposer.js";
+export type { RelayComposerProps, RlyRelayContextRef, RlyRelayDraft, RlyRelayDraftStorage, RlyRelaySubmission, UseRelayDraftOptions } from "./RelayComposer.js";
 export { RelayDock } from "./RelayDock.js";
 export type { RelayDockProps, RlyRelayDockContextChip, RlyRelayDockDesktopPresentation, RlyRelayDockSelection, RlyRelayDockSelectionControl, RlyRelayDockState } from "./RelayDock.js";
+export { RelayLauncher, relayShortcut, useRelayShortcut, useRelaySummon } from "./RelayLauncher.js";
+export type { RelayLauncherProps, RlyRelayShortcut, RlyRelaySummon, UseRelaySummonOptions } from "./RelayLauncher.js";
+export { RelayMark, RLY_RELAY_MARK_SIZES, RLY_RELAY_MARK_TILE_SIZES } from "./RelayMark.js";
+export type { RelayMarkProps, RelayMarkTileProps, RlyRelayMarkSize, RlyRelayMarkTileSize } from "./RelayMark.js";
+export { RelayPanel, RLY_RELAY_PANEL_PRESENTATIONS, RLY_RELAY_PANEL_WIDTH, useRelayPresentation } from "./RelayPanel.js";
+export type { RelayPanelProps, RlyRelayPanelPin, RlyRelayPanelPresentation, RlyRelayPanelTab, RlyRelayPresentation, RlyRelayScope, UseRelayPresentationOptions } from "./RelayPanel.js";
 export { ReleasePreview } from "./ReleasePreview.js";
 export type { ReleasePreviewProps, RlyReleasePreviewPresentation } from "./ReleasePreview.js";
 export { ReleaseRelay, RLY_RELEASE_RELAY_DEFAULT_VARIANTS, RLY_RELEASE_RELAY_SYMBOLS, RLY_RELEASE_RELAY_VARIANTS } from "./ReleaseRelay.js";

package/dist/dts/patterns/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,iBAAiB,EACjB,uCAAuC,EACvC,+BAA+B,EAChC,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACvH,OAAO,EAAE,WAAW,EAAE,iCAAiC,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC5G,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,iCAAiC,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC5G,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,oCAAoC,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAA;AACxH,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,YAAY,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAClG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAChH,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AACvF,OAAO,EAAE,WAAW,EAAE,iCAAiC,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC5G,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAE,MAAM,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtF,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,EAAE,MAAM,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtF,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACpF,OAAO,EACL,iBAAiB,EACjB,uCAAuC,EACvC,uCAAuC,EACxC,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,8BAA8B,EAC9B,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,+BAA+B,EAC/B,qBAAqB,EACrB,4BAA4B,EAC5B,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAA;AAC7F,OAAO,EACL,YAAY,EACZ,kCAAkC,EAClC,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,yBAAyB,EAC1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,iCAAiC,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC5G,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAC5G,OAAO,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACpG,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAChF,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACrE,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC5D,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"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"}

package/dist/dts/tokens/fonts.d.ts

@@ -0,0 +1,13 @@
+/** One web font rly's styles.css loads: its CSS family and the woff2 file a shell preloads. */
+export interface RlyFontFace {
+    readonly family: string;
+    readonly file: string;
+}
+/**
+ * Every web font rly's styles.css loads, as Fontsource names the files. The faces use
+ * `font-display: optional`, so a shell must preload each of these files (from its own origin, with
+ * `crossorigin`) for Geist to render on first load; otherwise the metric-matched fallback stays for
+ * that page view and nothing swaps. Shells read this list instead of hardcoding file names.
+ */
+export declare const RLY_FONT_FACES: readonly [RlyFontFace, RlyFontFace];
+//# sourceMappingURL=fonts.d.ts.map

package/dist/dts/tokens/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../../src/tokens/fonts.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,WAAW,EAAE,WAAW,CAG9D,CAAA"}

package/dist/dts/tokens/index.d.ts

@@ -1,3 +1,5 @@
+export { RLY_FONT_FACES } from "./fonts.js";
+export type { RlyFontFace } from "./fonts.js";
 export { RLY_COLOR_TOKEN_NAMES, RLY_CONTROL_HEIGHT_TOKEN_NAMES, RLY_MOTION_TOKEN_NAMES, RLY_RADIUS_TOKEN_NAMES, RLY_SPACE_TOKEN_NAMES, RLY_TYPE_TOKEN_NAMES } from "./semantic-tokens.js";
 export type { RlyColorToken, RlyControlHeightToken, RlyMotionToken, RlyRadiusToken, RlySpaceToken, RlyTypeToken } from "./semantic-tokens.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/tokens/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tokens/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tokens/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,sBAAsB,CAAA"}

package/dist/fonts.css

@@ -1,5 +1,10 @@
+/*
+ * optional: a preloaded face (served from the shell's origin) is ready within the short block period and
+ * renders from first paint; a face that is late stays on the metric-matched fallback for this page
+ * view, so text never swaps and never shifts. Shells preload every face in RLY_FONT_FACES.
+ */
 @font-face {
-  font-display: swap;
+  font-display: optional;
   font-family: "Geist Variable";
   font-style: normal;
   font-weight: 100 900;
@@ -7,9 +12,85 @@
 }
 
 @font-face {
-  font-display: swap;
+  font-display: optional;
   font-family: "Geist Mono Variable";
   font-style: normal;
   font-weight: 100 900;
   src: url("./fonts/geist-mono-latin-wght-normal.woff2") format("woff2-variations");
 }
+
+/*
+ * Metric-matched fallbacks, so text keeps its line breaks and row heights when Geist swaps in.
+ * Arial, Liberation Sans and Arimo share advance widths, so one override set covers macOS, Windows
+ * and Linux; Courier New, Liberation Mono and Cousine likewise. Geist's ascent 1005 and descent 295
+ * (per 1000; hhea and typo agree, USE_TYPO_METRICS is set) are divided by each face's size-adjust.
+ * Widths were measured in Chromium on product copy: Geist at 430 (body) runs 103.3% of Liberation
+ * Sans and at 520 (meta) 105.2%, so each gets its own face. At 600 to 650 it runs 99.8% to 101.1%
+ * of Liberation Sans Bold; a real bold face covers 550 and up, because a synthetic bold of the
+ * regular face matches neither.
+ */
+@font-face {
+  font-family: "Geist Fallback";
+  font-style: normal;
+  font-weight: 100 479;
+  src:
+    local("Arial"), local("ArialMT"), local("Liberation Sans"), local("LiberationSans"), local("Arimo"),
+    local("Arimo-Regular");
+  size-adjust: 103.3%;
+  ascent-override: 97.3%;
+  descent-override: 28.6%;
+  line-gap-override: 0%;
+}
+
+/* Meta text (520) runs wider against the same regular face. */
+@font-face {
+  font-family: "Geist Fallback";
+  font-style: normal;
+  font-weight: 480 549;
+  src:
+    local("Arial"), local("ArialMT"), local("Liberation Sans"), local("LiberationSans"), local("Arimo"),
+    local("Arimo-Regular");
+  size-adjust: 105.2%;
+  ascent-override: 95.5%;
+  descent-override: 28%;
+  line-gap-override: 0%;
+}
+
+@font-face {
+  font-family: "Geist Fallback";
+  font-style: normal;
+  font-weight: 550 900;
+  src:
+    local("Arial Bold"), local("Arial-BoldMT"), local("Liberation Sans Bold"), local("LiberationSans-Bold"),
+    local("Arimo Bold"), local("Arimo-Bold");
+  size-adjust: 100.3%;
+  ascent-override: 100.2%;
+  descent-override: 29.4%;
+  line-gap-override: 0%;
+}
+
+@font-face {
+  font-family: "Geist Mono Fallback";
+  font-style: normal;
+  font-weight: 100 549;
+  src:
+    local("Courier New"), local("CourierNewPSMT"), local("Liberation Mono"), local("LiberationMono"), local("Cousine"),
+    local("Cousine-Regular");
+  size-adjust: 100%;
+  ascent-override: 100.5%;
+  descent-override: 29.5%;
+  line-gap-override: 0%;
+}
+
+@font-face {
+  font-family: "Geist Mono Fallback";
+  font-style: normal;
+  font-weight: 550 900;
+  src:
+    local("Courier New Bold"), local("CourierNewPS-BoldMT"), local("Liberation Mono Bold"),
+    local("LiberationMono-Bold"), local("Cousine Bold"), local("Cousine-Bold");
+  size-adjust: 100%;
+  ascent-override: 100.5%;
+  descent-override: 29.5%;
+  line-gap-override: 0%;
+}

package/dist/foundations/index.js

@@ -1,6 +1,6 @@
 "use client";
 import { a as e, i as t, n, o as r, r as i, t as a } from "../ThemeProvider-BFeldMeE.js";
-import { a as o, i as s, n as c, o as l, s as u } from "../PortalProvider-CN_81Fy3.js";
+import { a as o, i as s, n as c, o as l, s as u } from "../PortalProvider-op07u8na.js";
 import { t as d } from "../LinkProvider-DMkhwZ3P.js";
 export { r as GlobalStyles, s as Icon, d as LinkProvider, c as PortalProvider, o as RLY_ICON_DEFAULT_VARIANTS, l as RLY_ICON_NAMES, u as RLY_ICON_VARIANTS, a as RLY_THEME_NAMES, n as ThemeProvider, i as decodeRlyTheme, t as useDocumentTheme, e as useStoredTheme };
 

package/dist/generated-tokens.css

@@ -2,8 +2,8 @@
 @layer rly.tokens {
   :root {
     color-scheme: light dark;
-    --rly-font-ui: "Geist Variable", "Geist", system-ui, sans-serif;
-    --rly-font-mono: "Geist Mono Variable", "Geist Mono", ui-monospace, monospace;
+    --rly-font-ui: "Geist Variable", "Geist", "Geist Fallback", system-ui, sans-serif;
+    --rly-font-mono: "Geist Mono Variable", "Geist Mono", "Geist Mono Fallback", ui-monospace, monospace;
     --rly-focus-ring-width: 2px;
     --rly-focus-ring-offset: 2px;
     --rly-color-canvas: light-dark(#F6F6F8, #101114);