@powerhousedao/design-system 6.2.3-dev.8 → 6.2.3-dev.81

package/dist/connect/index.d.ts

@@ -1,93 +1,129 @@
-import { D as Size, F as SidebarHeader, P as SidebarFooter, S as SelectOption, T as DivProps, X as Icon, Y as Modal, _t as SUCCESS, et as IconName, ft as AppOptions, gt as MISSING, ht as INITIAL_SYNC, mt as ERROR, pt as CONFLICT, ut as SyncStatus$1, vt as SYNCING, yt as syncStatuses } from "../index--hDSfvJT.js";
-import * as react from "react";
-import React$1, { CSSProperties, ComponentProps, ComponentPropsWithRef, ComponentPropsWithoutRef, FC, HTMLAttributes, ReactNode, RefAttributes } from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
-import * as _radix_ui_react_tooltip0 from "@radix-ui/react-tooltip";
+import { $ as PowerhouseButton, A as SidebarFooter, G as Modal, K as Icon, S as SelectOption, T as useWindowSize, at as AppOptions, ct as INITIAL_SYNC, dt as SYNCING, ft as syncStatuses, j as SidebarHeader, lt as MISSING, ot as CONFLICT, rt as SyncStatus$1, st as ERROR, ut as SUCCESS } from "../index-5FEr1tXH.js";
+import { i as Size, n as DivProps, o as IconName } from "../types-TZijOYrE.js";
+import { t as Checkbox } from "../checkbox-BIAGwP7d.js";
+import "../ui/index.js";
+import React$1, { CSSProperties, ComponentProps, ComponentPropsWithRef, ComponentPropsWithoutRef, FC, HTMLAttributes, PropsWithChildren, ReactNode, RefAttributes } from "react";
 import { TooltipProps } from "@radix-ui/react-tooltip";
 import { SubmitHandler } from "react-hook-form";
-import { ConflictResolution, DocumentTypeIcon, DriveSystemInfoState, FileUploadProgress, IChannel, Job, RebuildResult, Remote, ValidationResult } from "@powerhousedao/reactor-browser";
-import Select from "react-select";
+import { ConflictResolution, DocumentTypeIcon, DriveSystemInfoState, FileUploadProgress, IChannel, IPeerAgreement, Job, PHNavigationTarget, RebuildResult, Remote, RemotePeer, SyncHold, ValidationResult } from "@powerhousedao/reactor-browser";
 import { Operation, PHDocument } from "@powerhousedao/shared/document-model";
-import { JsonViewProps } from "@uiw/react-json-view";
 import { DocumentDriveDocument, FileNode, FolderNode, Node, SharingType } from "@powerhousedao/shared/document-drive";
+import Select from "react-select";
+import { JsonViewProps } from "@uiw/react-json-view";
 import { ArrayElement, Simplify } from "type-fest";
+import { PHBackground } from "@powerhousedao/shared/clis";
 import { RegistryPackage, RegistryPackageList } from "@powerhousedao/shared/registry";
-
 //#region src/connect/components/account-popover/account-popover.d.ts
-interface AccountPopoverProps {
+export interface AccountPopoverProps {
   children: ReactNode;
   content: ReactNode;
   open?: boolean;
   onOpenChange?: (open: boolean) => void;
 }
-declare const AccountPopover: ({
-  children,
-  content,
-  open,
-  onOpenChange
-}: AccountPopoverProps) => react_jsx_runtime0.JSX.Element;
+export declare const AccountPopover: ({ children, content, open, onOpenChange }: AccountPopoverProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/account-popover/account-popover-login.d.ts
-interface AccountPopoverLoginProps {
+export interface AccountPopoverLoginProps {
   onLogin: (() => void) | undefined;
 }
-declare const AccountPopoverLogin: FC<AccountPopoverLoginProps>;
+export declare const AccountPopoverLogin: FC<AccountPopoverLoginProps>;
 //#endregion
 //#region src/connect/components/renown-login/renown-login-methods.d.ts
-interface RenownLoginOption {
+export interface RenownLoginOption {
   id: string;
   label: string;
   onSelect: () => void;
   lastUsed?: boolean;
 }
-interface RenownLoginMethodsProps {
+export interface RenownLoginMethodsProps {
   methods: RenownLoginOption[];
   loading?: boolean;
   error?: string | null;
   className?: string;
 }
-declare const RenownLoginMethods: FC<RenownLoginMethodsProps>;
+export declare const RenownLoginMethods: FC<RenownLoginMethodsProps>;
 //#endregion
 //#region src/connect/components/animated-loader/animated-loader.d.ts
-type Props$11 = ComponentPropsWithoutRef<"video"> & {
+type Props$10 = ComponentPropsWithoutRef<"video"> & {
   readonly size?: Size;
 };
-declare function AnimatedLoader(props: Props$11): react_jsx_runtime0.JSX.Element;
+export declare function AnimatedLoader(props: Props$10): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/breadcrumbs/breadcrumbs.d.ts
-declare function Breadcrumbs(): react_jsx_runtime0.JSX.Element;
-type BreadcrumbProps = {
+export declare function Breadcrumbs(): import("react/jsx-runtime").JSX.Element;
+export type BreadcrumbProps = {
   name: string;
   id: string | undefined;
   parentId: string | null | undefined;
+  /** Renders a real link; plain clicks still call `onClick`. */
+  href?: string;
+  /** What the crumb opens; gives it the navigation's href and current mark. */
+  target?: PHNavigationTarget;
   onClick: () => void;
 };
-declare function Breadcrumb(props: BreadcrumbProps): react_jsx_runtime0.JSX.Element;
-//#endregion
-//#region src/connect/components/combobox/combobox.d.ts
+export declare function Breadcrumb(props: BreadcrumbProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/catch-up-inspector/catch-up-inspector.d.ts
+export type WatermarkStatus = {
+  head: number;
+  settledThrough: number;
+  waitingOn: string[];
+  stalledSinceUtcMs?: number;
+};
+export type SweepBlockedAt = {
+  ordinal: number;
+  documentId: string;
+  scope: string;
+  branch: string;
+  type: string;
+  error: string;
+};
+export type CatchUpConsumerStatus = {
+  consumerId: string;
+  thread: "host" | "projection";
+  appliedThrough: number;
+  trackedAbove: number;
+  blockedAt?: SweepBlockedAt;
+  lastAdvanceUtcMs: number;
+};
+export type CatchUpStatus = {
+  watermark: WatermarkStatus;
+  consumers: CatchUpConsumerStatus[];
+};
+export type CatchUpInspectorProps = {
+  readonly status: CatchUpStatus | undefined;
+  readonly onRefresh: () => Promise<void>;
+  readonly onSweepNow: () => Promise<void>;
+};
+export declare function CatchUpInspector({ status, onRefresh, onSweepNow }: CatchUpInspectorProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/combobox/combobox.impl.d.ts
 type SelectProps = ComponentPropsWithoutRef<typeof Select>;
-type Props$10 = Omit<SelectProps, "components" | "styles" | "theme"> & {
+type Props$9 = Omit<SelectProps, "components" | "styles" | "theme"> & {
   readonly addItemButtonProps?: {
     label?: ReactNode;
     onClick?: () => void;
   };
 };
-declare function Combobox(props: Props$10): react_jsx_runtime0.JSX.Element;
+declare function Combobox$1(props: Props$9): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/combobox/combobox.d.ts
+export declare const Combobox: typeof Combobox$1;
 //#endregion
 //#region src/connect/components/consent-banner/consent-banner.d.ts
-type CookieInput = {
+export type CookieInput = {
   id: string;
   label: string;
   value: boolean;
 };
-interface CookieBannerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSubmit"> {
+export interface CookieBannerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSubmit"> {
   cookies: CookieInput[];
   submitLabel?: string;
   rejectLabel?: string;
   onSubmit?: (cookies: CookieInput[]) => void;
   onReject?: () => void;
 }
-declare const CookieBanner: React.FC<CookieBannerProps>;
+export declare const CookieBanner: React.FC<CookieBannerProps>;
 //#endregion
 //#region src/connect/components/db-explorer/components/table-view.d.ts
 type ColumnInfo = {
@@ -119,31 +155,31 @@ type TableInfo = {
 };
 //#endregion
 //#region src/connect/components/db-explorer/db-explorer.d.ts
-type GetTableRowsOptions = {
+export type GetTableRowsOptions = {
   readonly schema?: string;
   readonly limit: number;
   readonly offset: number;
   readonly sort?: SortOptions;
   readonly filters?: FilterGroup;
 };
-type TablePage = {
+export type TablePage = {
   readonly columns: string[];
   readonly rows: Record<string, unknown>[];
   readonly total: number | null;
 };
-interface DbClient {
+export interface DbClient {
   readonly kind: string;
   listTables(schema?: string): Promise<string[]>;
   getTableSchema(table: string, schema?: string): Promise<ColumnInfo[]>;
   getTableRows(table: string, options: GetTableRowsOptions): Promise<TablePage>;
 }
-type PgVersionControl = {
+export type PgVersionControl = {
   readonly currentPgVersion: number | null;
   readonly supportedPgVersions: readonly number[];
   readonly onResetToPgVersion: (major: number) => void | Promise<void>;
 };
 /** Props for the main DBExplorer component */
-type DBExplorerProps = {
+export type DBExplorerProps = {
   readonly schema: string;
   readonly getTables: () => Promise<TableInfo[]>;
   readonly getTableRows: (table: string, options: GetTableRowsOptions) => Promise<TablePage>;
@@ -153,34 +189,21 @@ type DBExplorerProps = {
   readonly onExportDb?: () => void | Promise<void>;
   readonly pgVersionControl?: PgVersionControl;
 };
-declare function DBExplorer({
-  schema,
-  getTables,
-  getTableRows,
-  getDefaultSort,
-  pageSize,
-  onImportDb,
-  onExportDb,
-  pgVersionControl
-}: DBExplorerProps): react_jsx_runtime0.JSX.Element;
+export declare function DBExplorer({ schema, getTables, getTableRows, getDefaultSort, pageSize, onImportDb, onExportDb, pgVersionControl }: DBExplorerProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/debug-inspector/debug-inspector.d.ts
-type DebugInspectorProps = {
+export type DebugInspectorProps = {
   readonly supportedPgVersions: readonly number[];
   readonly currentPgVersion: number | null;
   readonly onResetToPgVersion: (major: number) => Promise<void>;
 };
-declare function DebugInspector({
-  supportedPgVersions,
-  currentPgVersion,
-  onResetToPgVersion
-}: DebugInspectorProps): react_jsx_runtime0.JSX.Element;
+export declare function DebugInspector({ supportedPgVersions, currentPgVersion, onResetToPgVersion }: DebugInspectorProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/default-editor-loader/default-editor-loader.d.ts
 type DefaultEditorLoaderProps = DivProps & {
   readonly message?: string;
 };
-declare function DefaultEditorLoader(props: DefaultEditorLoaderProps): react_jsx_runtime0.JSX.Element;
+export declare function DefaultEditorLoader(props: DefaultEditorLoaderProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/disclosure/disclosure.d.ts
 type DisclosureProps = {
@@ -192,10 +215,10 @@ type DisclosureProps = {
   toggleClassName?: string;
   contentClassName?: string;
 };
-declare function Disclosure(props: DisclosureProps): react_jsx_runtime0.JSX.Element;
+export declare function Disclosure(props: DisclosureProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/divider/divider.d.ts
-declare function Divider(props: DivProps): react_jsx_runtime0.JSX.Element;
+export declare function Divider(props: DivProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/document-state-viewer/document-state-viewer.d.ts
 interface DocumentStateViewerProps {
@@ -204,14 +227,9 @@ interface DocumentStateViewerProps {
   defaultScope?: string;
   className?: string;
 }
-declare function DocumentStateViewer({
-  state,
-  ignoredScopes,
-  defaultScope,
-  className
-}: DocumentStateViewerProps): react_jsx_runtime0.JSX.Element;
+export declare function DocumentStateViewer({ state, ignoredScopes, defaultScope, className }: DocumentStateViewerProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
-//#region src/connect/components/document-timeline/document-timeline.d.ts
+//#region src/connect/components/document-timeline/document-timeline.impl.d.ts
 type TimelineBarItem = {
   id: string;
   type: "bar";
@@ -239,7 +257,10 @@ interface DocumentTimelineProps {
   onItemClick?: (item: TimelineItem | null) => void;
   timeline?: Array<TimelineItem>;
 }
-declare const DocumentTimeline: (props: DocumentTimelineProps) => react_jsx_runtime0.JSX.Element;
+declare const DocumentTimeline$1: (props: DocumentTimelineProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/document-timeline/document-timeline.d.ts
+export declare const DocumentTimeline: typeof DocumentTimeline$1;
 //#endregion
 //#region src/connect/components/document-toolbar/containers.d.ts
 /**
@@ -249,7 +270,7 @@ declare const DocumentTimeline: (props: DocumentTimelineProps) => react_jsx_runt
  * still accepting standard `div` props. Pass a custom container to
  * `DocumentToolbar` when you need to replace this wrapper.
  */
-declare function ToolbarContainer(props: ComponentProps<"div">): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarContainer(props: ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
 /**
  * Default container for a group of toolbar controls.
  *
@@ -257,7 +278,7 @@ declare function ToolbarContainer(props: ComponentProps<"div">): react_jsx_runti
  * component provides the default horizontal layout for the controls in that
  * slot while still accepting standard `div` props.
  */
-declare function ToolbarControlsContainer(props: ComponentProps<"div">): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarControlsContainer(props: ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/document-toolbar/constants.d.ts
 /**
@@ -310,7 +331,6 @@ type ToolbarButtonProps = {
   onClick?: ToolbarButtonClickHandler;
 };
 /**
-
  * A map of built-in toolbar control names to replacement control components.
  * Provide this when you want to override one or more built-in
  * controls while keeping the rest of the default toolbar layout.
@@ -508,7 +528,7 @@ type DocumentToolbarProps = DocumentToolbarWithChildrenProps | DocumentToolbarWi
  *
  * To take over the toolbar contents completely, pass `children`.
  */
-declare function DocumentToolbar(props: DocumentToolbarProps): react_jsx_runtime0.JSX.Element;
+export declare function DocumentToolbar(props: DocumentToolbarProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/document-toolbar/toolbar-button.d.ts
 /**
@@ -517,7 +537,7 @@ declare function DocumentToolbar(props: DocumentToolbarProps): react_jsx_runtime
  * This component provides the default toolbar button styling and disabled-state
  * behavior while accepting standard `button` props.
  */
-declare function ToolbarButton(props: ComponentProps<"button">): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarButton(props: ComponentProps<"button">): import("react/jsx-runtime").JSX.Element;
 /**
  * Toolbar control for undoing the latest document revision.
  *
@@ -525,7 +545,7 @@ declare function ToolbarButton(props: ComponentProps<"button">): react_jsx_runti
  * Provide `children` to replace the default icon, or `onClick` to override the
  * default undo behavior.
  */
-declare function ToolbarUndoButton(props: ToolbarButtonProps): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarUndoButton(props: ToolbarButtonProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Toolbar control for redoing the latest undone document revision.
  *
@@ -533,36 +553,37 @@ declare function ToolbarUndoButton(props: ToolbarButtonProps): react_jsx_runtime
  * Provide `children` to replace the default icon, or `onClick` to override the
  * default redo behavior.
  */
-declare function ToolbarRedoButton(props: ToolbarButtonProps): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarRedoButton(props: ToolbarButtonProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Toolbar control for downloading the current document.
  *
  * Provide `children` to replace the default label, or `onClick` to override the
  * default download behavior.
  */
-declare function ToolbarDownloadButton(props: ToolbarButtonProps): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarDownloadButton(props: ToolbarButtonProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Toolbar control for opening the current document in Switchboard.
  *
  * Provide `children` to replace the default icon, or `onClick` to override the
  * default behavior.
  */
-declare function ToolbarSwitchboardButton(props: ToolbarButtonProps): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarSwitchboardButton(props: ToolbarButtonProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Toolbar control for showing the current document's revision history.
  *
  * Provide `children` to replace the default icon, or `onClick` to override the
  * default revision-history behavior.
  */
-declare function ToolbarHistoryButton(props: ToolbarButtonProps): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarHistoryButton(props: ToolbarButtonProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Toolbar control for closing the current document view.
  *
- * By default, this selects the current document's parent folder. Provide
+ * By default, this goes back when the app's history allows, else it selects the
+ * current document's parent folder. Provide
  * `children` to replace the default icon, or `onClick` to override the default
  * close behavior.
  */
-declare function ToolbarCloseButton(props: ToolbarButtonProps): react_jsx_runtime0.JSX.Element;
+export declare function ToolbarCloseButton(props: ToolbarButtonProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/document-toolbar/toolbar-input.d.ts
 /**
@@ -571,7 +592,7 @@ declare function ToolbarCloseButton(props: ToolbarButtonProps): react_jsx_runtim
  * This wraps `NodeInput` with toolbar-specific text styling. Use it for inline
  * toolbar editing flows where the user can submit a value or cancel editing.
  */
-declare function ToolbarInput(props: {
+export declare function ToolbarInput(props: {
   /**
    * Initial value to show in the input.
    */
@@ -592,7 +613,7 @@ declare function ToolbarInput(props: {
    * Called when the user cancels editing.
    */
   onCancel: () => void;
-}): react_jsx_runtime0.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/document-toolbar/toolbar-name.d.ts
 /**
@@ -602,14 +623,14 @@ declare function ToolbarInput(props: {
  * When clicked, it switches to an inline input. Submitting the input renames
  * both the node and the corresponding drive node entry.
  */
-declare function ToolbarName(props: {
+export declare function ToolbarName(props: {
   document?: PHDocument | undefined;
   inputClassName?: string;
   titleClassName?: string;
-}): react_jsx_runtime0.JSX.Element | null;
+}): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
 //#region src/connect/components/drive-auth-gate/drive-auth-gate.d.ts
-interface DriveAuthGateProps {
+export interface DriveAuthGateProps {
   /** Visual state — `"login"` (anonymous) or `"unauthorized"` (already signed in, not the owner). Defaults to `"login"`. */
   readonly mode?: "login" | "unauthorized";
   /** Opens the login flow (e.g. `showPHModal({ type: "login" })`); the login methods live in that modal, not here. */
@@ -620,19 +641,16 @@ interface DriveAuthGateProps {
   readonly onClose?: () => void;
   readonly className?: string;
 }
-declare function DriveAuthGate(props: DriveAuthGateProps): react_jsx_runtime0.JSX.Element;
+export declare function DriveAuthGate(props: DriveAuthGateProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/drop-zone/drop-zone-wrapper.d.ts
-declare function DropZoneWrapper({
-  children,
-  ...props
-}: {
+export declare function DropZoneWrapper({ children, ...props }: {
   children: React.ReactNode;
-} & ComponentPropsWithoutRef<"div">): react_jsx_runtime0.JSX.Element;
+} & ComponentPropsWithoutRef<"div">): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/upload-file-item/upload-file-item.d.ts
-type UploadFileItemStatus = "success" | "failed" | "pending" | "uploading" | "conflict" | "unsupported-document-type";
-type UploadFileItemProps = ComponentPropsWithoutRef<"div"> & {
+export type UploadFileItemStatus = "success" | "failed" | "pending" | "uploading" | "conflict" | "unsupported-document-type";
+export type UploadFileItemProps = ComponentPropsWithoutRef<"div"> & {
   readonly fileName: string;
   readonly fileSize: string;
   readonly status: UploadFileItemStatus;
@@ -643,7 +661,7 @@ type UploadFileItemProps = ComponentPropsWithoutRef<"div"> & {
   readonly onOpenDocument?: () => void;
   readonly onFindResolution?: () => void;
 };
-declare const UploadFileItem: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+export declare const UploadFileItem: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
   readonly fileName: string;
   readonly fileSize: string;
   readonly status: UploadFileItemStatus;
@@ -653,10 +671,10 @@ declare const UploadFileItem: react.ForwardRefExoticComponent<Omit<react.Detaile
   readonly onClose?: () => void;
   readonly onOpenDocument?: () => void;
   readonly onFindResolution?: () => void;
-} & react.RefAttributes<HTMLDivElement>>;
+} & import("react").RefAttributes<HTMLDivElement>>;
 //#endregion
 //#region src/connect/components/drop-zone/utils.d.ts
-type UploadTracker = {
+export type UploadTracker = {
   id: string;
   fileName: string;
   fileSize: string;
@@ -669,14 +687,14 @@ type UploadTracker = {
   parentNode?: Node;
   duplicateType?: "id" | "name";
 };
-type OnAddFileWithProgress = (file: File, parent: Node | undefined, onProgress?: (progress: FileUploadProgress) => void, resolveConflict?: ConflictResolution) => Promise<Node | undefined> | Node | undefined;
-declare function generateId(): string;
-declare function formatFileSize(bytes: number): string;
-declare function mapProgressStageToStatus(stage: FileUploadProgress["stage"]): UploadTracker["status"];
-declare function mapUploadsToFileItems(uploadsArray: (UploadTracker | undefined)[], removeUpload: (uploadId: string) => void, setSelectedNodeFn?: (nodeOrNodeSlug: Node | string | undefined) => void, onConflictResolution?: (uploadId: string) => void): UploadFileItemProps[];
+export type OnAddFileWithProgress = (file: File, parent: Node | undefined, onProgress?: (progress: FileUploadProgress) => void, resolveConflict?: ConflictResolution) => Promise<Node | undefined> | Node | undefined;
+export declare function generateId(): string;
+export declare function formatFileSize(bytes: number): string;
+export declare function mapProgressStageToStatus(stage: FileUploadProgress["stage"]): UploadTracker["status"];
+export declare function mapUploadsToFileItems(uploadsArray: (UploadTracker | undefined)[], removeUpload: (uploadId: string) => void, setSelectedNodeFn?: (nodeOrNodeSlug: Node | string | undefined) => void, onConflictResolution?: (uploadId: string) => void): UploadFileItemProps[];
 //#endregion
 //#region src/connect/components/drop-zone/drop-zone.d.ts
-type DropZoneProps = ComponentPropsWithoutRef<"div"> & {
+export type DropZoneProps = ComponentPropsWithoutRef<"div"> & {
   readonly title?: string;
   readonly subtitle?: string;
   readonly node?: Node;
@@ -687,10 +705,10 @@ type DropZoneProps = ComponentPropsWithoutRef<"div"> & {
   readonly driveId?: string;
   readonly acceptedFileExtensions?: string[];
 };
-declare function DropZone(props: DropZoneProps): react_jsx_runtime0.JSX.Element;
+export declare function DropZone(props: DropZoneProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/drop-zone/upload-file-list-container.d.ts
-type UploadFileListContainerProps = ComponentPropsWithoutRef<"div"> & {
+export type UploadFileListContainerProps = ComponentPropsWithoutRef<"div"> & {
   readonly uploadsArray: (UploadTracker | undefined)[];
   readonly uploadsCount: number;
   readonly removeUpload: (uploadId: string) => void;
@@ -699,16 +717,16 @@ type UploadFileListContainerProps = ComponentPropsWithoutRef<"div"> & {
   readonly onClose?: () => void;
   readonly onConflictResolution?: (uploadId: string) => void;
 };
-declare function UploadFileListContainer(props: UploadFileListContainerProps): react_jsx_runtime0.JSX.Element | null;
+export declare function UploadFileListContainer(props: UploadFileListContainerProps): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
 //#region src/connect/components/dropdown-menu/dropdown-menu.d.ts
-type ConnectDropdownMenuItem<TItemId extends string> = {
+export type ConnectDropdownMenuItem<TItemId extends string> = {
   id: TItemId;
   label: ReactNode;
   icon?: React.JSX.Element;
   className?: string;
 };
-interface ConnectDropdownMenuProps<TItemId extends string> {
+export interface ConnectDropdownMenuProps<TItemId extends string> {
   readonly children: ReactNode;
   readonly items: ConnectDropdownMenuItem<TItemId>[];
   readonly open?: boolean;
@@ -716,58 +734,62 @@ interface ConnectDropdownMenuProps<TItemId extends string> {
   readonly onOpenChange?: (open: boolean) => void;
   readonly menuClassName?: string;
 }
-declare function ConnectDropdownMenu<TItemId extends string>(props: ConnectDropdownMenuProps<TItemId>): react_jsx_runtime0.JSX.Element;
+export declare function ConnectDropdownMenu<TItemId extends string>(props: ConnectDropdownMenuProps<TItemId>): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/editor-action-buttons/editor-action-buttons.d.ts
-type EditorActionButtonsProps = {
+export type EditorActionButtonsProps = {
   readonly onSwitchboardLinkClick?: (() => void) | undefined;
   readonly onDownloadDocument?: (() => void) | undefined;
   readonly onClose: () => void;
   readonly onShowRevisionHistory?: (() => void) | undefined;
   readonly onShowTimeline?: (() => void) | undefined;
 };
-declare function EditorActionButtons(props: EditorActionButtonsProps): react_jsx_runtime0.JSX.Element;
+export declare function EditorActionButtons(props: EditorActionButtonsProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/editor-undo-redo-buttons/editor-undo-redo-buttons.d.ts
-type EditorUndoRedoButtonsProps = {
+export type EditorUndoRedoButtonsProps = {
   readonly canUndo: boolean;
   readonly canRedo: boolean;
   readonly undo: () => void;
   readonly redo: () => void;
 };
-declare function EditorUndoRedoButtons(props: EditorUndoRedoButtonsProps): react_jsx_runtime0.JSX.Element;
+export declare function EditorUndoRedoButtons(props: EditorUndoRedoButtonsProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/ens-avatar/ens-avatar.d.ts
-type Props$9 = {
+type Props$8 = {
   readonly address: `0x${string}`;
   readonly chainId?: number;
   readonly avatarUrl?: string;
   readonly size?: CSSProperties["width"];
 };
-declare function ENSAvatar(props: Props$9): react_jsx_runtime0.JSX.Element;
+export declare function ENSAvatar(props: Props$8): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/file-item/file-item.d.ts
-type Props$8 = {
+type Props$7 = {
   fileNode: FileNode;
   className?: string;
   customDocumentIconSrc?: string;
+  /** The document's link; the navigation's href for it by default. */
+  href?: string;
 };
-declare function FileItem(props: Props$8): react_jsx_runtime0.JSX.Element;
+export declare function FileItem(props: Props$7): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/folder-item/folder-item.d.ts
-declare function FolderItem(props: {
+export declare function FolderItem(props: {
   folderNode: FolderNode;
   className?: string;
-}): react_jsx_runtime0.JSX.Element;
+  /** The folder's link; the navigation's href for it by default. */
+  href?: string;
+}): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/footer/footer-link.d.ts
 type FooterLinkProps<E extends React.ElementType> = {
   readonly as?: E;
 } & React.ComponentPropsWithRef<E>;
-declare function FooterLink<E extends React.ElementType = "a">(props: FooterLinkProps<E>): react_jsx_runtime0.JSX.Element;
+export declare function FooterLink<E extends React.ElementType = "a">(props: FooterLinkProps<E>): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/footer/footer.d.ts
-declare const Footer: React.FC<React.HTMLAttributes<HTMLElement>>;
+export declare const Footer: React.FC<React.HTMLAttributes<HTMLElement>>;
 //#endregion
 //#region src/connect/components/form-input/form-input.d.ts
 type InputProps = ComponentPropsWithRef<"input">;
@@ -782,18 +804,21 @@ type FormInputProps = Omit<InputProps, "className"> & {
   readonly errorMessageClassName?: string;
   readonly hideErrors?: boolean;
 };
-declare const FormInput: react.ForwardRefExoticComponent<Omit<FormInputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
+export declare const FormInput: import("react").ForwardRefExoticComponent<Omit<FormInputProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
 //#endregion
-//#region src/connect/components/form/add-local-drive-form.d.ts
+//#region src/connect/components/form/add-local-drive-form.impl.d.ts
 type AddLocalDriveFormProps = {
   readonly onSubmit: CreateDriveFormSubmitHandler;
   readonly onCancel: () => void;
   readonly appOptions: AppOptions[];
 };
 type CreateDriveFormSubmitHandler = SubmitHandler<AppOptions>;
-declare function AddLocalDriveForm(props: AddLocalDriveFormProps): react_jsx_runtime0.JSX.Element;
+declare function AddLocalDriveForm$1(props: AddLocalDriveFormProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
-//#region src/connect/components/form/add-remote-drive-form.d.ts
+//#region src/connect/components/form/add-local-drive-form.d.ts
+export declare const AddLocalDriveForm: typeof AddLocalDriveForm$1;
+//#endregion
+//#region src/connect/components/form/add-remote-drive-form.impl.d.ts
 type RemoteDriveDetails = {
   id: string;
   name: string;
@@ -813,24 +838,84 @@ type AddPublicDriveFormProps = {
     name: string;
   }>;
 };
-declare function AddRemoteDriveForm(props: AddPublicDriveFormProps): react_jsx_runtime0.JSX.Element;
+declare function AddRemoteDriveForm$1(props: AddPublicDriveFormProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/form/add-remote-drive-form.d.ts
+export declare const AddRemoteDriveForm: typeof AddRemoteDriveForm$1;
+//#endregion
+//#region src/connect/components/formatted-json-viewer.impl.d.ts
+declare function FormattedJsonViewer$1(props: JsonViewProps<object>): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/formatted-json-viewer.d.ts
-declare function FormattedJsonViewer(props: JsonViewProps<object>): react_jsx_runtime0.JSX.Element;
+export declare const FormattedJsonViewer: typeof FormattedJsonViewer$1;
+//#endregion
+//#region src/connect/components/branding/background-layers.d.ts
+/**
+ * A decorated pane: the configured page colour with the background's layers
+ * painted over it, in order, and the children above them all. Each layer is
+ * placed by the shared `layerStyle`, the same declarations the desktop
+ * loading page emits as static CSS, so a background configured once looks
+ * the same in both hosts. Images come resolved (data URIs or URLs); a
+ * light/dark pair follows the `.dark` theme class, not the OS scheme.
+ * Without a background the pane is the theme's page colour and nothing more.
+ */
+export declare function BackgroundLayers(props: PropsWithChildren<{
+  background: PHBackground | null | undefined;
+  className?: string;
+}>): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/branding/connect-branding.d.ts
+/**
+ * Connect's branding as the components see it: the host app provides it once
+ * at its root (images already resolved to data URIs) and the components read
+ * it from here instead of reaching into configuration. `icons` are the drive
+ * explorer's, which the generic plugin owns; `appName`, `icon` and
+ * `homeBackground` are Connect's identity (`connect.branding`). Without a
+ * provider every built-in icon renders.
+ */
+export type ConnectExplorerIcons = {
+  /** Local drives without an icon of their own. */
+  localDrive?: string | null;
+  /** Remote drives without an icon of their own. */
+  remoteDrive?: string | null;
+  folder?: string | null;
+  /** Documents whose type has no icon in `documents`. */
+  document?: string | null;
+  /** Per document type, e.g. "acme/invoice". */
+  documents?: Record<string, string> | null;
+};
+export type ConnectBranding = {
+  appName?: string | null;
+  /** The in-app logo (the 64 px app icon). */
+  icon?: string | null;
+  /** The home screen's background (images resolved). */
+  homeBackground?: PHBackground | null;
+  icons?: ConnectExplorerIcons | null;
+};
+export declare function ConnectBrandingProvider(props: PropsWithChildren<{
+  branding: ConnectBranding | null | undefined;
+}>): import("react/jsx-runtime").JSX.Element;
+/** The provided branding; `{}` (built-in look) without a provider. */
+export declare function useConnectBranding(): ConnectBranding;
+/** The icon for a document of `documentType`: the explorer's icon for that
+ * type, else its default document icon, else undefined (the icon the package
+ * ships, or the built-in one). */
+export declare function brandedDocumentIcon(branding: ConnectBranding, documentType: string): string | undefined;
 //#endregion
 //#region src/connect/components/home-screen/home-background-image.d.ts
 type HomeBackgroundImageProps = {
   src?: string;
 };
-declare const HomeBackgroundImage: ({
-  src
-}?: HomeBackgroundImageProps) => react_jsx_runtime0.JSX.Element;
+/** The default home-screen gradient. A custom `src` is kept for callers that
+ * still pass one, sized to its box; HomeScreen itself renders custom images
+ * as a hero below the drive tiles instead. */
+export declare const HomeBackgroundImage: ({ src }?: HomeBackgroundImageProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/home-screen/home-screen-add-drive-item.d.ts
 type HomeScreenAddDriveItemProps = {
   readonly containerClassName?: string;
 };
-declare const HomeScreenAddDriveItem: (props: HomeScreenAddDriveItemProps) => react_jsx_runtime0.JSX.Element;
+export declare const HomeScreenAddDriveItem: (props: HomeScreenAddDriveItemProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/home-screen/home-screen-item.d.ts
 type HomeScreenItemProps = {
@@ -839,51 +924,70 @@ type HomeScreenItemProps = {
   readonly description?: string;
   readonly containerClassName?: string;
   readonly shareable?: boolean;
-  readonly onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
+  /** Renders a real link; `onClick` can still take plain clicks in-app. */
+  readonly href?: string;
+  /** Marks the link to what shows now. */
+  readonly "aria-current"?: "page";
+  onClick?(this: void, event: React.MouseEvent<HTMLElement>): void;
+  /** Called on hover or touch, before a likely click. */
+  readonly onPreload?: () => void;
 };
-declare const HomeScreenItem: (props: HomeScreenItemProps) => react_jsx_runtime0.JSX.Element;
+export declare const HomeScreenItem: (props: HomeScreenItemProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/home-screen/home-screen.d.ts
 type HomeScreenProps = {
   readonly children: React.ReactNode;
   readonly containerClassName?: string;
-  readonly homeBackground?: string | null;
+  /** The project's background (`connect.branding.homeBackground`, images
+   * resolved); null or undefined keeps the bundled gradient. */
+  readonly homeBackground?: PHBackground | null;
 };
-declare const HomeScreen: (props: HomeScreenProps) => react_jsx_runtime0.JSX.Element;
+export declare const HomeScreen: (props: HomeScreenProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/integrity-inspector/integrity-inspector.d.ts
-type IntegrityInspectorProps = {
+export type IntegrityInspectorProps = {
   readonly onValidate: (documentId: string, branch?: string) => Promise<ValidationResult>;
   readonly onRebuildKeyframes: (documentId: string, branch?: string) => Promise<RebuildResult>;
   readonly onRebuildSnapshots: (documentId: string, branch?: string) => Promise<RebuildResult>;
 };
-declare function IntegrityInspector({
-  onValidate,
-  onRebuildKeyframes,
-  onRebuildSnapshots
-}: IntegrityInspectorProps): react_jsx_runtime0.JSX.Element;
+export declare function IntegrityInspector({ onValidate, onRebuildKeyframes, onRebuildSnapshots }: IntegrityInspectorProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/loading-screen/loading-screen.d.ts
-interface LoadingScreenProps {
+export interface LoadingScreenProps {
   showLoadingScreen: boolean;
   loadingComponent?: React.ReactNode;
   size?: number;
   className?: string;
 }
-declare const LoadingScreen: React.FC<LoadingScreenProps>;
+export declare const LoadingScreen: React.FC<LoadingScreenProps>;
 //#endregion
 //#region src/connect/components/logo-animation.d.ts
-declare function LogoAnimation({
-  size,
-  className
-}: {
-  size?: number | undefined;
+/** A project's loading image, declared by the build as
+ * `<meta name="ph-loader" content="<file>" data-animation data-size>`
+ * (powerhouse.config.json `icons.loader`). */
+export type ProjectLoader = {
+  src: string;
+  animation: "pulse" | "spin" | "none";
+  size: number;
+};
+/** The page's project loader, or null when Connect's logo stays. Read once:
+ * the meta tag is static in index.html. */
+export declare function getProjectLoader(): ProjectLoader | null;
+/** The project's loading image with its motion. */
+export declare function ProjectLoaderImage({ loader, className }: {
+  loader: ProjectLoader;
+  className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/** Connect's loading animation: the project's loader when one is
+ * configured, else the animated Powerhouse logo. */
+export declare function LogoAnimation({ size, className }: {
   className?: string | undefined;
-}): react_jsx_runtime0.JSX.Element;
+  size?: number | undefined;
+}): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/add-drive-modal/add-drive-modal.d.ts
 type ModalProps$5 = ComponentPropsWithoutRef<typeof Modal>;
-type AddDriveModalProps = {
+export type AddDriveModalProps = {
   readonly open: boolean;
   readonly onOpenChange: (open: boolean) => void;
   readonly onAddRemoteDrive: (data: AddRemoteDriveInput) => void;
@@ -896,11 +1000,11 @@ type AddDriveModalProps = {
   }>;
   readonly appOptions: AppOptions[];
 };
-declare function AddDriveModal(props: AddDriveModalProps): react_jsx_runtime0.JSX.Element;
+export declare function AddDriveModal(props: AddDriveModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/confirmation-modal.d.ts
 type ModalProps$4 = ComponentPropsWithoutRef<typeof Modal>;
-type ConfirmationModalProps = {
+export type ConfirmationModalProps = {
   readonly open?: boolean;
   readonly onOpenChange?: (open: boolean) => void;
   readonly header: ReactNode;
@@ -913,22 +1017,30 @@ type ConfirmationModalProps = {
   readonly overlayProps?: ModalProps$4["overlayProps"];
   readonly contentProps?: ModalProps$4["contentProps"];
 };
-declare function ConnectConfirmationModal(props: ConfirmationModalProps): react_jsx_runtime0.JSX.Element;
+export declare function ConnectConfirmationModal(props: ConfirmationModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/create-document-modal.d.ts
-type CreateDocumentModalProps = ComponentPropsWithoutRef<typeof Modal> & {
+export type CreateDocumentModalProps = ComponentPropsWithoutRef<typeof Modal> & {
   readonly onContinue: (nodeName: string) => void;
+  /** The drives to pick from when none is given; an empty list asks for one. */
+  readonly drives?: readonly {
+    id: string;
+    name: string;
+  }[];
+  readonly driveId?: string;
+  readonly onDriveChange?: (driveId: string) => void;
+  readonly onAddDrive?: () => void;
 };
-declare function CreateDocumentModal(props: CreateDocumentModalProps): react_jsx_runtime0.JSX.Element;
+export declare function CreateDocumentModal(props: CreateDocumentModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/create-document-with-type-modal.d.ts
-type DocumentTypeOption = {
+export type DocumentTypeOption = {
   readonly documentType: string;
   readonly name: string;
   readonly version?: number;
   readonly description?: string;
 };
-type CreateDocumentWithTypeModalProps = ComponentPropsWithoutRef<typeof Modal> & {
+export type CreateDocumentWithTypeModalProps = ComponentPropsWithoutRef<typeof Modal> & {
   readonly documentTypes: readonly DocumentTypeOption[];
   readonly onCreate: (input: {
     name: string;
@@ -937,25 +1049,25 @@ type CreateDocumentWithTypeModalProps = ComponentPropsWithoutRef<typeof Modal> &
   }) => void;
   readonly onTypeSelected?: (documentType: string) => void;
 };
-declare function CreateDocumentWithTypeModal(props: CreateDocumentWithTypeModalProps): react_jsx_runtime0.JSX.Element;
+export declare function CreateDocumentWithTypeModal(props: CreateDocumentWithTypeModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/delete-drive-modal.d.ts
-interface ConnectDeleteDriveModalProps extends ConfirmationModalProps {
+export interface ConnectDeleteDriveModalProps extends ConfirmationModalProps {
   readonly inputPlaceholder: string;
   readonly driveName: string;
 }
-declare const ConnectDeleteDriveModal: React.FC<ConnectDeleteDriveModalProps>;
+export declare const ConnectDeleteDriveModal: React.FC<ConnectDeleteDriveModalProps>;
 //#endregion
 //#region src/connect/components/modal/delete-item-modal.d.ts
-interface ConnectDeleteItemModalProps extends Omit<ConfirmationModalProps, "onContinue" | "continueLabel"> {
+export interface ConnectDeleteItemModalProps extends Omit<ConfirmationModalProps, "onContinue" | "continueLabel"> {
   readonly onDelete: () => void;
   readonly deleteLabel: string;
 }
-declare function ConnectDeleteItemModal(props: ConnectDeleteItemModalProps): react_jsx_runtime0.JSX.Element;
+export declare function ConnectDeleteItemModal(props: ConnectDeleteItemModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/drive-settings-modal.d.ts
 type ModalProps$3 = ComponentPropsWithoutRef<typeof Modal>;
-type DriveSettingsModalProps = {
+export type DriveSettingsModalProps = {
   drive: DocumentDriveDocument;
   sharingType: SharingType;
   availableOffline: boolean;
@@ -969,10 +1081,10 @@ type DriveSettingsModalProps = {
   modalProps?: ModalProps$3;
   containerProps?: DivProps;
 };
-declare function DriveSettingsModal(props: DriveSettingsModalProps): react_jsx_runtime0.JSX.Element;
+export declare function DriveSettingsModal(props: DriveSettingsModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/processors-inspector/processors-inspector.d.ts
-type ProcessorInfo = {
+export type ProcessorInfo = {
   processorId: string;
   factoryId: string;
   driveId: string;
@@ -982,36 +1094,29 @@ type ProcessorInfo = {
   lastError: string | undefined;
   lastErrorTimestamp: Date | undefined;
 };
-type ProcessorsInspectorProps = {
+export type ProcessorsInspectorProps = {
   readonly getProcessors: () => Promise<ProcessorInfo[]>;
   readonly onRetry?: (processorId: string) => Promise<void>;
 };
-declare function ProcessorsInspector({
-  getProcessors,
-  onRetry
-}: ProcessorsInspectorProps): react_jsx_runtime0.JSX.Element;
+export declare function ProcessorsInspector({ getProcessors, onRetry }: ProcessorsInspectorProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/queue-inspector/queue-inspector.d.ts
-type QueueState = {
+export type QueueState = {
   readonly isPaused: boolean;
   readonly pendingJobs: Job[];
   readonly executingJobs: Job[];
   readonly totalPending: number;
   readonly totalExecuting: number;
 };
-type QueueInspectorProps = {
+export type QueueInspectorProps = {
   readonly getQueueState: () => Promise<QueueState>;
   readonly onPause: () => Promise<void>;
   readonly onResume: () => Promise<void>;
 };
-declare function QueueInspector({
-  getQueueState,
-  onPause,
-  onResume
-}: QueueInspectorProps): react_jsx_runtime0.JSX.Element;
+export declare function QueueInspector({ getQueueState, onPause, onResume }: QueueInspectorProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/remotes-inspector/remotes-inspector.d.ts
-type ConnectionStateSummary = {
+export type ConnectionStateSummary = {
   state: string;
   failureCount: number;
   lastSuccessUtcMs: number;
@@ -1019,71 +1124,69 @@ type ConnectionStateSummary = {
   pushBlocked: boolean;
   pushFailureCount: number;
 };
-type RemotesInspectorProps = {
+export type RemotesInspectorProps = {
   readonly getRemotes: () => Promise<Remote[]>;
   readonly removeRemote?: (name: string) => Promise<void>;
   readonly addRemoteManual?: (url: string) => Promise<void>;
   readonly triggerPull?: (name: string) => void;
   readonly connectionStates?: ReadonlyMap<string, ConnectionStateSummary>;
+  /** Shows each remote's manifest, what it limits and what is held from it. */
+  readonly getAgreement?: () => IPeerAgreement;
+  readonly getHolds?: (remoteName: string) => Promise<SyncHold[]>;
 };
-declare function RemotesInspector({
-  getRemotes,
-  removeRemote,
-  addRemoteManual,
-  triggerPull,
-  connectionStates
-}: RemotesInspectorProps): react_jsx_runtime0.JSX.Element;
+export declare function RemotesInspector({ getRemotes, removeRemote, addRemoteManual, triggerPull, connectionStates, getAgreement, getHolds }: RemotesInspectorProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/remotes-inspector/components/channel-inspector.d.ts
-type ChannelInspectorProps = {
+export type ChannelInspectorProps = {
   readonly remoteName: string;
   readonly channel: IChannel;
   readonly onBack: () => void;
   readonly onRefresh?: () => void;
   readonly connectionState?: ConnectionStateSummary;
 };
-declare function ChannelInspector({
-  remoteName,
-  channel,
-  onBack,
-  onRefresh,
-  connectionState
-}: ChannelInspectorProps): react_jsx_runtime0.JSX.Element;
+export declare function ChannelInspector({ remoteName, channel, onBack, onRefresh, connectionState }: ChannelInspectorProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/remotes-inspector/components/connection-state-badge.d.ts
-type ConnectionStateBadgeProps = {
+export type ConnectionStateBadgeProps = {
   readonly state: string;
   readonly failureCount: number;
 };
-declare function ConnectionStateBadge({
-  state,
-  failureCount
-}: ConnectionStateBadgeProps): react_jsx_runtime0.JSX.Element;
+export declare function ConnectionStateBadge({ state, failureCount }: ConnectionStateBadgeProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/remotes-inspector/components/peer-agreement-panel.d.ts
+export type PeerAgreementPanelProps = {
+  readonly remoteName: string;
+  readonly collectionId: string;
+  readonly peer: RemotePeer | undefined;
+  readonly agreement: IPeerAgreement;
+  readonly holds: readonly SyncHold[];
+};
+/** How a remote's peer announced itself. */
+export declare function peerManifestLabel(peer: RemotePeer | undefined): string;
+export declare function PeerAgreementPanel({ remoteName, collectionId, peer, agreement, holds }: PeerAgreementPanelProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/worker-inspector/worker-inspector.d.ts
-type WorkerInfo = {
+export type WorkerInfo = {
   readonly namespace: string;
   readonly ownerId: string;
   readonly bootedAtMs: number;
   readonly connectedClients: number;
   readonly appBuildId: string;
-  readonly rpcProtocolVersion: number; /** Enforcement flags the running worker booted with; empty means none. */
+  readonly rpcProtocolVersion: number;
+  /** Enforcement flags the running worker booted with; empty means none. */
   readonly featureFlags?: string;
 };
-type WorkerInspectorProps = {
+export type WorkerInspectorProps = {
   readonly getInfo: () => Promise<WorkerInfo>;
   readonly onRestart: () => Promise<void>;
 };
-declare function WorkerInspector({
-  getInfo,
-  onRestart
-}: WorkerInspectorProps): react_jsx_runtime0.JSX.Element;
+export declare function WorkerInspector({ getInfo, onRestart }: WorkerInspectorProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/inspector-modal/inspector-modal.d.ts
 type ModalProps$2 = ComponentPropsWithoutRef<typeof Modal>;
-type InspectorTab = "Database" | "Remotes" | "Queue" | "Processors" | "Integrity" | "Worker";
-type InspectorUnavailableTabs = { readonly [K in InspectorTab]?: string };
-type InspectorModalProps = {
+export type InspectorTab = "Database" | "Remotes" | "Queue" | "Processors" | "Integrity" | "CatchUp" | "Worker";
+export type InspectorUnavailableTabs = { readonly [K in InspectorTab]?: string; };
+export type InspectorModalProps = {
   readonly open: boolean;
   readonly onOpenChange: (open: boolean) => void;
   readonly modalProps?: ModalProps$2;
@@ -1093,45 +1196,33 @@ type InspectorModalProps = {
   readonly queueInspectorProps?: QueueInspectorProps;
   readonly processorsInspectorProps?: ProcessorsInspectorProps;
   readonly integrityInspectorProps?: IntegrityInspectorProps;
+  readonly catchUpInspectorProps?: CatchUpInspectorProps;
   readonly workerInspectorProps?: WorkerInspectorProps;
   readonly unavailableTabs?: InspectorUnavailableTabs;
   readonly defaultTab?: InspectorTab;
 };
-declare function InspectorModal({
-  open,
-  onOpenChange,
-  modalProps,
-  containerProps,
-  dbExplorerProps,
-  remotesInspectorProps,
-  queueInspectorProps,
-  processorsInspectorProps,
-  integrityInspectorProps,
-  workerInspectorProps,
-  unavailableTabs,
-  defaultTab
-}: InspectorModalProps): react_jsx_runtime0.JSX.Element;
+export declare function InspectorModal({ open, onOpenChange, modalProps, containerProps, dbExplorerProps, remotesInspectorProps, queueInspectorProps, processorsInspectorProps, integrityInspectorProps, catchUpInspectorProps, workerInspectorProps, unavailableTabs, defaultTab }: InspectorModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/missing-package-modal.d.ts
-interface PendingPackageInstallation {
+export interface PendingPackageInstallation {
   documentType: string;
   packageName: string;
 }
-type PackageInstallModalProps = ComponentPropsWithoutRef<typeof Modal> & {
+export type PackageInstallModalProps = ComponentPropsWithoutRef<typeof Modal> & {
   readonly pendingInstallations: PendingPackageInstallation[];
   readonly onInstall: (packageName: string) => Promise<void>;
   readonly onDismiss: (packageName: string) => void;
 };
-declare function PackageInstallModal(props: PackageInstallModalProps): react_jsx_runtime0.JSX.Element | null;
+export declare function PackageInstallModal(props: PackageInstallModalProps): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
 //#region src/connect/components/modal/modal-button.d.ts
-declare function ModalButton(props: ComponentProps<"button"> & {
+export declare function ModalButton(props: ComponentProps<"button"> & {
   variant: "confirm" | "cancel";
-}): react_jsx_runtime0.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/read-required-modal.d.ts
 type ModalProps$1 = ComponentPropsWithoutRef<typeof Modal>;
-type ReadRequiredModalProps = {
+export type ReadRequiredModalProps = {
   readonly open?: boolean;
   readonly onOpenChange?: (open: boolean) => void;
   readonly header: ReactNode;
@@ -1142,11 +1233,11 @@ type ReadRequiredModalProps = {
   readonly overlayProps?: ModalProps$1["overlayProps"];
   readonly contentProps?: ModalProps$1["contentProps"];
 };
-declare function ReadRequiredModal(props: ReadRequiredModalProps): react_jsx_runtime0.JSX.Element;
+export declare function ReadRequiredModal(props: ReadRequiredModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/replace-duplicate-modal.d.ts
 type ModalProps = ComponentPropsWithoutRef<typeof Modal>;
-type ConnectReplaceDuplicateModalProps = {
+export type ConnectReplaceDuplicateModalProps = {
   readonly open?: boolean;
   readonly onOpenChange?: (open: boolean) => void;
   readonly title?: string;
@@ -1157,14 +1248,14 @@ type ConnectReplaceDuplicateModalProps = {
   readonly overlayProps?: ModalProps["overlayProps"];
   readonly contentProps?: ModalProps["contentProps"];
 };
-declare function ConnectReplaceDuplicateModal(props: ConnectReplaceDuplicateModalProps): react_jsx_runtime0.JSX.Element;
+export declare function ConnectReplaceDuplicateModal(props: ConnectReplaceDuplicateModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/about.d.ts
-type Props$7 = {
+type Props$6 = {
   packageJson: unknown;
   phCliVersion?: string;
 };
-declare function About(props: Props$7): react_jsx_runtime0.JSX.Element;
+export declare function About(props: Props$6): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/danger-zone.d.ts
 type ModifyDrivesProps = {
@@ -1176,21 +1267,25 @@ type LocalStorageProps = {
   onClearStorage: () => void | Promise<void>;
   className?: string;
 };
-type Props$6 = ModifyDrivesProps & LocalStorageProps;
-declare function DangerZone(props: Props$6): react_jsx_runtime0.JSX.Element;
+type Props$5 = ModifyDrivesProps & LocalStorageProps;
+export declare function DangerZone(props: Props$5): import("react/jsx-runtime").JSX.Element;
 //#endregion
-//#region src/connect/components/modal/settings-modal-v2/default-editor.d.ts
-type Props$5 = {
+//#region src/connect/components/modal/settings-modal-v2/default-editor.impl.d.ts
+type Props$4 = {
   documentModelEditor: string;
   setDocumentModelEditor: (value: string) => void;
   documentModelEditorOptions: SelectOption[];
   className?: string;
 };
-declare function DefaultEditor(props: Props$5): react_jsx_runtime0.JSX.Element;
-declare function DefaultEditorSelect(props: Props$5): react_jsx_runtime0.JSX.Element;
+declare function DefaultEditor$1(props: Props$4): import("react/jsx-runtime").JSX.Element;
+declare function DefaultEditorSelect$1(props: Props$4): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/modal/settings-modal-v2/default-editor.d.ts
+export declare const DefaultEditor: typeof DefaultEditor$1;
+export declare const DefaultEditorSelect: typeof DefaultEditorSelect$1;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/package-manager/available-packages-panel.d.ts
-type AvailablePackagesPanelProps = {
+export type AvailablePackagesPanelProps = {
   /**
    * status: available | dismissed. In server-search mode these are already
    * filtered by the registry; otherwise they're filtered client-side here.
@@ -1208,37 +1303,43 @@ type AvailablePackagesPanelProps = {
    * client-side `filterPackages`. Set by the connect layer once the paginated
    * search endpoint is wired.
    */
-  serverSearch?: boolean; /** true while the first page / a new search is loading. */
-  isLoading?: boolean; /** true while an additional page is being appended (infinite scroll). */
-  isLoadingMore?: boolean; /** more pages exist on the server. */
-  hasMore?: boolean; /** request the next page (infinite scroll). */
+  serverSearch?: boolean;
+  /** true while the first page / a new search is loading. */
+  isLoading?: boolean;
+  /** true while an additional page is being appended (infinite scroll). */
+  isLoadingMore?: boolean;
+  /** more pages exist on the server. */
+  hasMore?: boolean;
+  /** request the next page (infinite scroll). */
   onLoadMore?: () => void;
   /**
    * Registry fetch failed. Presence-only — the panel never surfaces raw API
    * messages; see `PackageRegistryError` for the user-facing copy.
    */
-  error?: boolean; /** retry the current fetch after an error. */
+  error?: boolean;
+  /** retry the current fetch after an error. */
   onRetry?: () => void;
   mutable: boolean;
   onInstall: (packageSpec: string) => Promise<void>;
   onUninstall: (packageName: string) => void;
   disabled?: boolean;
 };
-declare const AvailablePackagesPanel: React.FC<AvailablePackagesPanelProps>;
+export declare const AvailablePackagesPanel: React.FC<AvailablePackagesPanelProps>;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/package-manager/installed-packages-panel.d.ts
-type InstalledPackagesPanelProps = {
-  /** status: local-install | registry-install */packages: RegistryPackageList;
+export type InstalledPackagesPanelProps = {
+  /** status: local-install | registry-install */
+  packages: RegistryPackageList;
   query: string;
   onQueryChange: (query: string) => void;
   onInstall: (packageSpec: string) => Promise<void>;
   onUninstall: (packageName: string) => void;
   disabled?: boolean;
 };
-declare const InstalledPackagesPanel: React.FC<InstalledPackagesPanelProps>;
+export declare const InstalledPackagesPanel: React.FC<InstalledPackagesPanelProps>;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/package-manager/package-manager-list.d.ts
-declare const PackageManagerListItem: (props: {
+export declare const PackageManagerListItem: (props: {
   registryPackage: RegistryPackage;
   onInstall: (packageSpec: string) => Promise<void>;
   onUninstall: (packageName: string) => void;
@@ -1248,7 +1349,7 @@ declare const PackageManagerListItem: (props: {
    */
   preferredTag?: string;
   className?: string;
-}) => react_jsx_runtime0.JSX.Element;
+}) => import("react/jsx-runtime").JSX.Element;
 /**
  * Scroll region shared by both Package Manager tab panels. Fills the space
  * the panel gives it and scrolls its overflow. This works because the tab
@@ -1257,7 +1358,7 @@ declare const PackageManagerListItem: (props: {
  * unbroken (`min-h-0` + `flex-1`/`h-full` at every level), so no
  * viewport-measuring hack is needed.
  */
-declare const PackagePanelScrollArea: React.FC<{
+export declare const PackagePanelScrollArea: React.FC<{
   children: ReactNode;
   className?: string;
   /**
@@ -1266,12 +1367,12 @@ declare const PackagePanelScrollArea: React.FC<{
    */
   onReachEnd?: () => void;
 }>;
-declare const PackageSubSection: React.FC<{
+export declare const PackageSubSection: React.FC<{
   title: string;
   count: number;
   children: ReactNode;
 }>;
-declare const PackageList: React.FC<{
+export declare const PackageList: React.FC<{
   packages: RegistryPackageList;
   onInstall: (packageSpec: string) => Promise<void>;
   onUninstall: (packageName: string) => void;
@@ -1279,18 +1380,25 @@ declare const PackageList: React.FC<{
 }>;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/package-manager/package-manager.d.ts
-type PackageManagerProps = {
-  /** status: local-install | registry-install */installedPackages: RegistryPackageList; /** status: available | dismissed (dismissed grouped at the bottom) */
-  availablePackages: RegistryPackageList; /** true while the first page / a new search is loading. */
-  isAvailableLoading?: boolean; /** true while an additional page is being appended (infinite scroll). */
-  isLoadingMoreAvailable?: boolean; /** more Available pages exist on the server. */
-  hasMoreAvailable?: boolean; /** request the next Available page (infinite scroll). */
+export type PackageManagerProps = {
+  /** status: local-install | registry-install */
+  installedPackages: RegistryPackageList;
+  /** status: available | dismissed (dismissed grouped at the bottom) */
+  availablePackages: RegistryPackageList;
+  /** true while the first page / a new search is loading. */
+  isAvailableLoading?: boolean;
+  /** true while an additional page is being appended (infinite scroll). */
+  isLoadingMoreAvailable?: boolean;
+  /** more Available pages exist on the server. */
+  hasMoreAvailable?: boolean;
+  /** request the next Available page (infinite scroll). */
   onLoadMoreAvailable?: () => void;
   /**
    * Registry Available fetch failed. Presence-only — never pass raw API
    * messages; the panel renders friendly copy via `PackageRegistryError`.
    */
-  availableError?: boolean; /** retry the Available fetch after an error. */
+  availableError?: boolean;
+  /** retry the Available fetch after an error. */
   onAvailableRetry?: () => void;
   /**
    * When provided, Available search is delegated to the server (the panel
@@ -1316,15 +1424,16 @@ type PackageManagerProps = {
    * `initialTab="installed"` mount). The caller dedupes — this is what
    * makes the installed-rows version-metadata fetch lazy.
    */
-  onInstalledTabOpen?: () => void; /** default "installed"; used by stories/tests */
+  onInstalledTabOpen?: () => void;
+  /** default "installed"; used by stories/tests */
   initialTab?: "installed" | "available";
   disabled?: boolean;
   className?: string;
 };
-declare const PackageManager: React.FC<PackageManagerProps>;
+export declare const PackageManager: React.FC<PackageManagerProps>;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/package-manager/package-registry-error.d.ts
-type PackageRegistryErrorProps = {
+export type PackageRegistryErrorProps = {
   /**
    * `empty` — first load / search failed with nothing to show.
    * `refresh` — a later fetch failed but previously loaded packages remain.
@@ -1336,56 +1445,56 @@ type PackageRegistryErrorProps = {
  * Friendly registry-error banner. Never surfaces raw API / network messages —
  * those stay in the console for debugging.
  */
-declare const PackageRegistryError: React.FC<PackageRegistryErrorProps>;
+export declare const PackageRegistryError: React.FC<PackageRegistryErrorProps>;
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/package-manager/types.d.ts
-interface RegistryOption {
+export interface RegistryOption {
   id: string;
   label: string;
   url: string;
   editable?: boolean;
 }
-type RegistryStatus = "idle" | "connecting" | "connected" | "error";
+export type RegistryStatus = "idle" | "connecting" | "connected" | "error";
 //#endregion
 //#region src/connect/components/modal/settings-modal-v2/settings-modal.d.ts
-type SettingsTab = {
+export type SettingsTab = {
   id: string;
   icon?: React.ReactNode;
   label: React.ReactNode;
   content: React.ReactNode | React.ComponentType<any>;
 };
-type Props$4 = {
+type Props$3 = {
   readonly title: React.ReactNode;
   readonly tabs: SettingsTab[];
   defaultTab?: string;
   navFooter?: React.ReactNode;
 } & ComponentProps<typeof Modal>;
-declare function SettingsModal(props: Props$4): react_jsx_runtime0.JSX.Element;
+export declare function SettingsModal(props: Props$3): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/modal/settings-modal/dependency-versions/dependency-versions.d.ts
 type ValidatedPackageJson = {
   version: string;
   dependencies: Record<string, string>;
 };
-declare function verifyPackageJsonFields(packageJson: unknown): ValidatedPackageJson | false;
-type Props$3 = {
+export declare function verifyPackageJsonFields(packageJson: unknown): ValidatedPackageJson | false;
+type Props$2 = {
   readonly packageJson: unknown;
   readonly phCliVersion?: string;
 };
-declare function DependencyVersions(props: Props$3): react_jsx_runtime0.JSX.Element | null;
+export declare function DependencyVersions(props: Props$2): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
 //#region src/connect/components/modal/upgrade-drive-modal.d.ts
-type ConnectUpgradeDriveModalProps = ComponentPropsWithoutRef<typeof Modal> & {
+export type ConnectUpgradeDriveModalProps = ComponentPropsWithoutRef<typeof Modal> & {
   readonly header: React.ReactNode;
   readonly body: React.ReactNode;
   readonly onContinue: () => void;
   readonly cancelLabel: string;
   readonly continueLabel: string;
 };
-declare function ConnectUpgradeDriveModal(props: ConnectUpgradeDriveModalProps): react_jsx_runtime0.JSX.Element;
+export declare function ConnectUpgradeDriveModal(props: ConnectUpgradeDriveModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/node-input/node-input.d.ts
-type Props$2 = {
+type Props$1 = {
   readonly name?: string;
   readonly defaultValue?: string;
   readonly placeholder?: string;
@@ -1395,35 +1504,78 @@ type Props$2 = {
   readonly onSubmit: (value: string) => void;
   readonly onCancel: () => void;
 };
-declare function NodeInput(props: Props$2): react_jsx_runtime0.JSX.Element;
+export declare function NodeInput(props: Props$1): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/object-inspector-modal/object-inspector-modal.d.ts
-type ObjectInspectorModalProps = {
+export type ObjectInspectorModalProps = {
   readonly open: boolean;
   readonly onOpenChange: (open: boolean) => void;
   readonly title: string;
   readonly object: unknown;
 };
-declare function ObjectInspectorModal({
-  open,
-  onOpenChange,
-  title,
-  object
-}: ObjectInspectorModalProps): react_jsx_runtime0.JSX.Element;
+export declare function ObjectInspectorModal({ open, onOpenChange, title, object }: ObjectInspectorModalProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
-//#region src/connect/components/revision-history/revision-history.d.ts
-type Props$1 = {
+//#region src/connect/components/revision-history/revision-history.impl.d.ts
+type CommonProps = {
   readonly documentTitle: string;
   readonly documentId: string;
-  readonly globalOperations: Operation[];
-  readonly localOperations: Operation[];
   readonly onClose: () => void;
   readonly itemsPerPage?: number;
   readonly documentState?: object;
   readonly onCopyState?: () => void;
   readonly onCopyDocId?: () => void;
+  /** Controlled: the page shown, from 1; pair with `onPageChange`. */
+  readonly page?: number;
+  readonly onPageChange?: (page: number) => void;
+};
+/** The current, scoped props. */
+type RevisionHistoryScopedProps = CommonProps & {
+  /** The operations of the selected scope loaded so far, in any order. */
+  readonly operations: readonly Operation[];
+  /** A page of operations is being fetched. */
+  readonly isLoading: boolean;
+  /** More operations exist beyond the loaded ones. */
+  readonly hasNextPage: boolean;
+  /**
+   * Called by the component whenever it can take the next page.
+   * Must be referentially stable (for example the hook's `fetchNextPage`);
+   * an inline arrow re-fires the effect every render.
+   */
+  readonly onLoadNextPage: () => void;
+  /** The scopes offered in the selector, for example the keys of `document.header.revision`. */
+  readonly scopes: readonly string[];
+  /** The selected scope. */
+  readonly scope: string;
+  readonly onScopeChange: (scope: string) => void;
+  /**
+   * The last page failed. Operations loaded so far are still shown, and the
+   * walk stops asking for more; there is no retry from inside the component.
+   */
+  readonly error?: Error;
+};
+/**
+ * Legacy props: the whole global and local history, toggled inside the
+ * component.
+ * @deprecated Pass one scope's `operations` with `scopes`/`scope`/`onScopeChange` and the loading props. Removed in the next major.
+ */
+type RevisionHistoryLegacyProps = CommonProps & {
+  readonly globalOperations: readonly Operation[];
+  readonly localOperations: readonly Operation[];
 };
-declare function RevisionHistory(props: Props$1): react_jsx_runtime0.JSX.Element;
+type RevisionHistoryProps = RevisionHistoryScopedProps | RevisionHistoryLegacyProps;
+/**
+ * The revision history panel. Pages arrive oldest first while the timeline
+ * renders newest first, so it waits for the whole history to load before
+ * rendering the timeline, showing "Loading operations…" and a running count
+ * in the meantime.
+ *
+ * Also accepts the deprecated `globalOperations`/`localOperations` pair
+ * (see `RevisionHistoryLegacyProps`), toggling between them internally.
+ */
+declare function RevisionHistory$1(props: RevisionHistoryProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/connect/components/revision-history/revision-history.d.ts
+export declare const RevisionHistory: typeof RevisionHistory$1;
 //#endregion
 //#region src/connect/components/search-bar/filter-item.d.ts
 type FilterItemType = {
@@ -1433,7 +1585,7 @@ type FilterItemType = {
 };
 //#endregion
 //#region src/connect/components/search-bar/search-bar.d.ts
-interface ConnectSearchBarProps {
+export interface ConnectSearchBarProps {
   value?: string;
   onChange?: (value: string) => void;
   placeholder?: string;
@@ -1443,17 +1595,17 @@ interface ConnectSearchBarProps {
   onFilterSelect?: (filterId: string) => void;
   className?: string;
 }
-declare const ConnectSearchBar: React.FC<ConnectSearchBarProps>;
+export declare const ConnectSearchBar: React.FC<ConnectSearchBarProps>;
 //#endregion
 //#region src/connect/components/select/select.d.ts
-type ConnectSelectItem<TValue extends string> = {
+export type ConnectSelectItem<TValue extends string> = {
   readonly value: TValue;
   readonly displayValue?: React.ReactNode;
   readonly description?: React.ReactNode;
   readonly icon?: React.JSX.Element;
   readonly disabled?: boolean;
 };
-type ConnectSelectProps<TValue extends string> = {
+export type ConnectSelectProps<TValue extends string> = {
   items: readonly ConnectSelectItem<TValue>[];
   value: TValue;
   id: string;
@@ -1462,24 +1614,29 @@ type ConnectSelectProps<TValue extends string> = {
   menuClassName?: string;
   itemClassName?: string;
   borderRadius?: CSSProperties["borderRadius"];
-  absolutePositionMenu?: boolean; /** Applied to the expanded options list, e.g. to cap its height and make it scrollable. */
+  absolutePositionMenu?: boolean;
+  /** Applied to the expanded options list, e.g. to cap its height and make it scrollable. */
   listClassName?: string;
 };
-declare const ConnectSelect: <TValue extends string>(props: ConnectSelectProps<TValue> & RefAttributes<HTMLDivElement>) => ReactNode;
+export declare const ConnectSelect: <TValue extends string>(props: ConnectSelectProps<TValue> & RefAttributes<HTMLDivElement>) => ReactNode;
 //#endregion
 //#region src/connect/components/sidebar/sidebar-add-drive-item.d.ts
 type SidebarAddDriveItemProps = {
   readonly containerClassName?: string;
   readonly onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
 };
-declare const SidebarAddDriveItem: (props: SidebarAddDriveItemProps) => react_jsx_runtime0.JSX.Element;
+export declare const SidebarAddDriveItem: (props: SidebarAddDriveItemProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/sidebar/sidebar-footer.d.ts
-interface ConnectSidebarFooterProps extends ComponentProps<typeof SidebarFooter> {
+export interface ConnectSidebarFooterProps extends ComponentProps<typeof SidebarFooter> {
   address: `0x${string}` | undefined;
   ensName?: string;
   avatarUrl?: string;
-  onClickSettings: (() => void) | undefined;
+  onClickSettings: ((event: React.MouseEvent<HTMLElement>) => void) | undefined;
+  /** Renders settings as a real link; `onClickSettings` can still take plain clicks. */
+  settingsHref?: string;
+  /** Marks the settings link while settings show. */
+  settingsCurrent?: "page";
   onLogin: (() => void) | undefined;
   etherscanUrl?: string;
   onDisconnect: (() => void) | undefined;
@@ -1487,11 +1644,11 @@ interface ConnectSidebarFooterProps extends ComponentProps<typeof SidebarFooter>
   showDebug?: boolean;
   onDebugClick?: () => void;
 }
-declare const ConnectSidebarFooter: React.FC<ConnectSidebarFooterProps>;
+export declare const ConnectSidebarFooter: React.FC<ConnectSidebarFooterProps>;
 //#endregion
 //#region src/connect/components/sidebar/sidebar-header.d.ts
-interface ConnectSidebarHeaderProps extends ComponentProps<typeof SidebarHeader> {}
-declare const ConnectSidebarHeader: React.FC<ConnectSidebarHeaderProps>;
+export interface ConnectSidebarHeaderProps extends ComponentProps<typeof SidebarHeader> {}
+export declare const ConnectSidebarHeader: React.FC<ConnectSidebarHeaderProps>;
 //#endregion
 //#region src/connect/components/sidebar/sidebar-item.d.ts
 type SidebarItemProps = {
@@ -1500,28 +1657,34 @@ type SidebarItemProps = {
   readonly description?: string;
   readonly containerClassName?: string;
   readonly active?: boolean;
-  readonly onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
+  /** Renders a real link; `onClick` can still take plain clicks in-app. */
+  readonly href?: string;
+  /** Marks the link to what shows now; styles it as `active` does. */
+  readonly "aria-current"?: "page";
+  onClick?(this: void, event: React.MouseEvent<HTMLElement>): void;
+  /** Called on hover or touch, before a likely click. */
+  readonly onPreload?: () => void;
 };
-declare const SidebarItem: (props: SidebarItemProps) => react_jsx_runtime0.JSX.Element;
+export declare const SidebarItem: (props: SidebarItemProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/sidebar/sidebar-login.d.ts
-interface SidebarLoginProps {
+export interface SidebarLoginProps {
   onLogin: (() => void) | undefined;
 }
-declare const SidebarLogin: React.FC<SidebarLoginProps>;
+export declare const SidebarLogin: React.FC<SidebarLoginProps>;
 //#endregion
 //#region src/connect/components/sidebar/sidebar-user.d.ts
-interface SidebarUserProps {
+export interface SidebarUserProps {
   address: `0x${string}`;
   ensName?: string;
   avatarUrl?: string;
   etherscanUrl: string;
   onDisconnect: (() => void) | undefined;
 }
-declare const SidebarUser: React.FC<SidebarUserProps>;
+export declare const SidebarUser: React.FC<SidebarUserProps>;
 //#endregion
 //#region src/connect/components/sidebar/sidebar.d.ts
-interface ConnectSidebarProps extends HTMLAttributes<HTMLElement>, ConnectSidebarHeaderProps, ConnectSidebarFooterProps {
+export interface ConnectSidebarProps extends HTMLAttributes<HTMLElement>, ConnectSidebarHeaderProps, ConnectSidebarFooterProps {
   maxWidth?: string;
   minWidth?: string;
   headerContent?: React.ReactNode;
@@ -1531,17 +1694,17 @@ interface ConnectSidebarProps extends HTMLAttributes<HTMLElement>, ConnectSideba
   etherscanUrl?: string;
   onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
 }
-declare const ConnectSidebar: React.FC<ConnectSidebarProps>;
+export declare const ConnectSidebar: React.FC<ConnectSidebarProps>;
 //#endregion
 //#region src/connect/components/status-icon/sync-status-icon.d.ts
-type SyncStatusIconProps = Omit<ComponentPropsWithoutRef<typeof Icon>, "name"> & {
+export type SyncStatusIconProps = Omit<ComponentPropsWithoutRef<typeof Icon>, "name"> & {
   syncStatus: SyncStatus$1;
   overrideSyncIcons?: Partial<Record<SyncStatus$1, IconName>>;
 };
-declare function SyncStatusIcon(props: SyncStatusIconProps): react_jsx_runtime0.JSX.Element;
+export declare function SyncStatusIcon(props: SyncStatusIconProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/tabs/tab-content.d.ts
-type TabContentProps = {
+export type TabContentProps = {
   readonly label: ReactNode;
   /**
    * Stable tab value. Required when `label` is not a plain string (e.g. it
@@ -1553,31 +1716,25 @@ type TabContentProps = {
   readonly children: ReactNode;
   readonly disabled?: boolean;
 };
-declare function TabContent(props: TabContentProps): react_jsx_runtime0.JSX.Element;
+export declare function TabContent(props: TabContentProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/tabs/tabs.d.ts
-declare function Tabs({
-  children,
-  defaultValue,
-  onValueChange,
-  listClassName
-}: {
+export declare function Tabs({ children, defaultValue, onValueChange, listClassName }: {
   children: React$1.ReactNode;
   defaultValue: string;
-  onValueChange?: (value: string) => void; /** Applied to the tab list row (not the panel content). */
+  onValueChange?: (value: string) => void;
+  /** Applied to the tab list row (not the panel content). */
   listClassName?: string;
-}): react_jsx_runtime0.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/theme-switch.d.ts
-declare function ThemeSwitch({
-  horizontal
-}: {
+export declare function ThemeSwitch({ horizontal }: {
   horizontal?: boolean;
-}): react_jsx_runtime0.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/components/toggle/toggle.d.ts
 type ToggleProps = Omit<ComponentPropsWithRef<"input">, "type">;
-declare const Toggle: react.ForwardRefExoticComponent<Omit<ToggleProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
+export declare const Toggle: import("react").ForwardRefExoticComponent<Omit<ToggleProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/connect/components/tooltip/tooltip.d.ts
 type Props = TooltipProps & {
@@ -1586,106 +1743,106 @@ type Props = TooltipProps & {
   readonly side?: "top" | "right" | "bottom" | "left";
   readonly sideOffset?: number;
 };
-declare function ConnectTooltip(props: Props): react_jsx_runtime0.JSX.Element;
-declare const ConnectTooltipProvider: react.FC<_radix_ui_react_tooltip0.TooltipProviderProps>;
+export declare function ConnectTooltip(props: Props): import("react/jsx-runtime").JSX.Element;
+export declare const ConnectTooltipProvider: import("react").FC<import("@radix-ui/react-tooltip").TooltipProviderProps>;
 //#endregion
 //#region src/connect/components/upload-file-list/upload-file-list.d.ts
-type UploadFileListProps = ComponentPropsWithoutRef<"div"> & {
+export type UploadFileListProps = ComponentPropsWithoutRef<"div"> & {
   readonly items: ReadonlyArray<UploadFileItemProps>;
   readonly title?: string;
   readonly defaultCollapsed?: boolean;
   readonly onClose?: () => void;
 };
-declare function UploadFileList(props: UploadFileListProps): react_jsx_runtime0.JSX.Element;
+export declare function UploadFileList(props: UploadFileListProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/connect/constants/options.d.ts
-declare const defaultDriveOptions: readonly ["DOWNLOAD", "NEW_FOLDER", "RENAME", "SETTINGS"];
-declare const defaultNodeOptions: readonly ["RENAME", "DELETE", "DUPLICATE"];
-declare const normalNodeOptions: readonly ["DUPLICATE", "RENAME", "DELETE", "SETTINGS"];
-declare const debugNodeOptions: readonly ["ADD_TRIGGER", "REMOVE_TRIGGER", "ADD_INVALID_TRIGGER"];
-declare const nodeOptions: readonly ["DUPLICATE", "RENAME", "DELETE", "SETTINGS", "ADD_TRIGGER", "REMOVE_TRIGGER", "ADD_INVALID_TRIGGER"];
-declare const sharingTypeOptions: readonly [{
+export declare const defaultDriveOptions: readonly ["DOWNLOAD", "NEW_FOLDER", "RENAME", "SETTINGS"];
+export declare const defaultNodeOptions: readonly ["RENAME", "DELETE", "DUPLICATE"];
+export declare const normalNodeOptions: readonly ["DUPLICATE", "RENAME", "DELETE", "SETTINGS"];
+export declare const debugNodeOptions: readonly ["ADD_TRIGGER", "REMOVE_TRIGGER", "ADD_INVALID_TRIGGER"];
+export declare const nodeOptions: readonly ["DUPLICATE", "RENAME", "DELETE", "SETTINGS", "ADD_TRIGGER", "REMOVE_TRIGGER", "ADD_INVALID_TRIGGER"];
+export declare const sharingTypeOptions: readonly [{
   readonly value: "LOCAL";
-  readonly icon: react_jsx_runtime0.JSX.Element;
+  readonly icon: import("react/jsx-runtime").JSX.Element;
   readonly description: "Only available to you";
 }, {
   readonly value: "CLOUD";
-  readonly icon: react_jsx_runtime0.JSX.Element;
+  readonly icon: import("react/jsx-runtime").JSX.Element;
   readonly description: "Only available to people in this drive";
 }, {
   readonly value: "PUBLIC";
-  readonly icon: react_jsx_runtime0.JSX.Element;
+  readonly icon: import("react/jsx-runtime").JSX.Element;
   readonly description: "Available to everyone";
   readonly disabled: true;
 }];
-declare const locationInfoByLocation: {
+export declare const locationInfoByLocation: {
   readonly CLOUD: {
     readonly title: "Secure cloud";
     readonly description: "End to end encryption between members.";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   readonly LOCAL: {
     readonly title: "Local";
     readonly description: "Private and only available to you.";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   readonly SWITCHBOARD: {
     readonly title: "Switchboard";
     readonly description: "Public and available to everyone.";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
 };
-declare const debugNodeOptionsMap: {
+export declare const debugNodeOptionsMap: {
   readonly ADD_TRIGGER: {
     readonly label: "Add Trigger";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   readonly REMOVE_TRIGGER: {
     readonly label: "Remove Trigger";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   readonly ADD_INVALID_TRIGGER: {
     readonly label: "Add Trigger";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
 };
-declare const folderNodeDropdownOptions: {
+export declare const folderNodeDropdownOptions: {
   readonly DOWNLOAD: {
     readonly label: "Download as zip";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   readonly DUPLICATE: {
     readonly label: "Duplicate";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   readonly RENAME: {
     readonly label: "Rename";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   readonly DELETE: {
     readonly label: "Delete";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
     readonly className: "text-destructive";
   };
 };
-declare const fileNodeDropdownOptions: {
-  DOWNLOAD: {
-    label: string;
-    icon: react_jsx_runtime0.JSX.Element;
-  };
+export declare const fileNodeDropdownOptions: {
   DUPLICATE: {
     readonly label: "Duplicate";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   RENAME: {
     readonly label: "Rename";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
   };
   DELETE: {
     readonly label: "Delete";
-    readonly icon: react_jsx_runtime0.JSX.Element;
+    readonly icon: import("react/jsx-runtime").JSX.Element;
     readonly className: "text-destructive";
   };
+  DOWNLOAD: {
+    label: string;
+    icon: import("react/jsx-runtime").JSX.Element;
+  };
 };
 //#endregion
 //#region src/connect/hooks/use-ens.d.ts
@@ -1715,14 +1872,14 @@ type UseEnsResult = {
   isLoading: boolean;
   error: Error | undefined;
 };
-declare function useEns(address: `0x${string}` | undefined): UseEnsResult;
+export declare function useEns(address: `0x${string}` | undefined): UseEnsResult;
 //#endregion
 //#region src/connect/utils/address.d.ts
-declare function formatEthAddress(address: string): string;
+export declare function formatEthAddress(address: string): string;
 //#endregion
 //#region src/connect/utils/get-folder-status.d.ts
 type SyncStatus = "INITIAL_SYNC" | "SYNCING" | "SUCCESS" | "CONFLICT" | "MISSING" | "ERROR";
-type FileStatus = {
+export type FileStatus = {
   path: string;
   status?: SyncStatus;
 };
@@ -1733,7 +1890,7 @@ type FileStatus = {
  * @param sortedFiles - The sorted list of files.
  * @returns The sync status of the folder.
  */
-declare const getFolderStatus: (folderPath: string, sortedFiles: FileStatus[]) => SyncStatus;
+export declare const getFolderStatus: (folderPath: string, sortedFiles: FileStatus[]) => SyncStatus;
 /**
  * Sorts an array of files by their status.
  * The order priority is:
@@ -1746,13 +1903,14 @@ declare const getFolderStatus: (folderPath: string, sortedFiles: FileStatus[]) =
  * @param files - The array of files to be sorted.
  * @returns The sorted array of files.
  */
-declare const sortFilesByStatus: (files: FileStatus[]) => FileStatus[];
+export declare const sortFilesByStatus: (files: FileStatus[]) => FileStatus[];
 /**
  * Removes files with a status of 'SUCCESS' from the given array of FileStatus objects.
  * @param files - An array of FileStatus objects.
  * @returns A new array containing only the FileStatus objects with a status other than 'SUCCESS'.
  */
-declare const removeSuccessFiles: (files: FileStatus[]) => FileStatus[];
+export declare const removeSuccessFiles: (files: FileStatus[]) => FileStatus[];
 //#endregion
-export { About, AccountPopover, AccountPopoverLogin, AccountPopoverLoginProps, AccountPopoverProps, AddDriveModal, AddDriveModalProps, AddLocalDriveForm, AddPublicDriveFormProps, AddRemoteDriveForm, AddRemoteDriveInput, AnimatedLoader, AppOptions, AvailablePackagesPanel, AvailablePackagesPanelProps, Breadcrumb, BreadcrumbProps, Breadcrumbs, CONFLICT, ChannelInspector, ChannelInspectorProps, type ColumnInfo, Combobox, ConfirmationModalProps, ConnectConfirmationModal, ConnectDeleteDriveModal, ConnectDeleteDriveModalProps, ConnectDeleteItemModal, ConnectDeleteItemModalProps, ConnectDropdownMenu, ConnectDropdownMenuItem, ConnectDropdownMenuProps, ConnectReplaceDuplicateModal, ConnectReplaceDuplicateModalProps, ConnectSearchBar, ConnectSearchBarProps, ConnectSelect, ConnectSelectItem, ConnectSelectProps, ConnectSidebar, ConnectSidebarFooter, ConnectSidebarFooterProps, ConnectSidebarHeader, ConnectSidebarHeaderProps, ConnectSidebarProps, ConnectTooltip, ConnectTooltipProvider, ConnectUpgradeDriveModal, ConnectUpgradeDriveModalProps, ConnectionStateBadge, ConnectionStateBadgeProps, ConnectionStateSummary, type ContainerComponent, type ControlPosition, type ControlSlot, CookieBanner, CookieBannerProps, CookieInput, CreateDocumentModal, CreateDocumentModalProps, CreateDocumentWithTypeModal, CreateDocumentWithTypeModalProps, type CustomToolbarControl, type CustomToolbarControlList, type CustomToolbarControls, DBExplorer, DBExplorerProps, DangerZone, DbClient, DebugInspector, DebugInspectorProps, DefaultEditor, DefaultEditorLoader, DefaultEditorSelect, DependencyVersions, Disclosure, Divider, DocumentStateViewer, DocumentTimeline, DocumentTimelineProps, DocumentToolbar, type DocumentToolbarControlName, type DocumentToolbarProps, type DocumentToolbarWithChildrenProps, type DocumentToolbarWithCustomControlsProps, DocumentTypeOption, DriveAuthGate, DriveAuthGateProps, DriveSettingsModal, DriveSettingsModalProps, DropZone, DropZoneProps, DropZoneWrapper, ENSAvatar, ERROR, EditorActionButtons, EditorActionButtonsProps, EditorUndoRedoButtons, EditorUndoRedoButtonsProps, FileItem, FileStatus, type FilterClause, type FilterGroup, type FilterOperator, FolderItem, Footer, FooterLink, FormInput, FormattedJsonViewer, GetTableRowsOptions, HomeBackgroundImage, HomeScreen, HomeScreenAddDriveItem, HomeScreenItem, INITIAL_SYNC, InspectorModal, InspectorModalProps, InspectorTab, InspectorUnavailableTabs, InstalledPackagesPanel, InstalledPackagesPanelProps, IntegrityInspector, IntegrityInspectorProps, LoadingScreen, LoadingScreenProps, LogoAnimation, MISSING, ModalButton, NodeInput, ObjectInspectorModal, ObjectInspectorModalProps, OnAddFileWithProgress, PackageInstallModal, PackageInstallModalProps, PackageList, PackageManager, PackageManagerListItem, PackageManagerProps, PackagePanelScrollArea, PackageRegistryError, PackageRegistryErrorProps, PackageSubSection, PendingPackageInstallation, PgVersionControl, ProcessorInfo, ProcessorsInspector, ProcessorsInspectorProps, QueueInspector, QueueInspectorProps, QueueState, ReadRequiredModal, ReadRequiredModalProps, RegistryOption, RegistryStatus, RemotesInspector, RemotesInspectorProps, RenownLoginMethods, RenownLoginMethodsProps, RenownLoginOption, RevisionHistory, SUCCESS, SYNCING, SettingsModal, SettingsTab, SidebarAddDriveItem, SidebarItem, SidebarLogin, SidebarLoginProps, SidebarUser, SidebarUserProps, type SortOptions, SyncStatusIcon, SyncStatusIconProps, TabContent, TabContentProps, type TableInfo, TablePage, Tabs, ThemeSwitch, TimelineBarItem, TimelineDividerItem, TimelineItem, Toggle, ToolbarButton, type ToolbarButtonClickHandler, type ToolbarButtonProps, ToolbarCloseButton, ToolbarContainer, type ToolbarControlComponent, type ToolbarControlComponents, ToolbarControlsContainer, ToolbarDownloadButton, ToolbarHistoryButton, ToolbarInput, ToolbarName, ToolbarRedoButton, ToolbarSwitchboardButton, ToolbarUndoButton, UploadFileItem, UploadFileItemProps, UploadFileItemStatus, UploadFileList, UploadFileListContainer, UploadFileListContainerProps, UploadFileListProps, UploadTracker, WorkerInfo, WorkerInspector, WorkerInspectorProps, debugNodeOptions, debugNodeOptionsMap, defaultDriveOptions, defaultNodeOptions, fileNodeDropdownOptions, folderNodeDropdownOptions, formatEthAddress, formatFileSize, generateId, getFolderStatus, locationInfoByLocation, mapProgressStageToStatus, mapUploadsToFileItems, nodeOptions, normalNodeOptions, removeSuccessFiles, sharingTypeOptions, sortFilesByStatus, syncStatuses, useEns, verifyPackageJsonFields };
+export { type AddPublicDriveFormProps, type AddRemoteDriveInput, type AppOptions, CONFLICT, Checkbox, type ColumnInfo, type ContainerComponent, type ControlPosition, type ControlSlot, type CustomToolbarControl, type CustomToolbarControlList, type CustomToolbarControls, type DocumentTimelineProps, type DocumentToolbarControlName, type DocumentToolbarProps, type DocumentToolbarWithChildrenProps, type DocumentToolbarWithCustomControlsProps, ERROR, type FilterClause, type FilterGroup, type FilterOperator, INITIAL_SYNC, Icon, MISSING, Modal, PowerhouseButton, type RevisionHistoryLegacyProps, type RevisionHistoryProps, type RevisionHistoryScopedProps, SUCCESS, SYNCING, type SortOptions, type TableInfo, type TimelineBarItem, type TimelineDividerItem, type TimelineItem, type ToolbarButtonClickHandler, type ToolbarButtonProps, type ToolbarControlComponent, type ToolbarControlComponents, syncStatuses, useWindowSize };
+export {};
 //# sourceMappingURL=index.d.ts.map