@peers-app/peers-ui 0.25.2 → 0.25.4

package/dist/screens/tools/tool-access-ipc.js

@@ -2,64 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getToolAccessControlConsumer = getToolAccessControlConsumer;
 const peers_sdk_1 = require("@peers-app/peers-sdk");
-const HOST_TRANSPORT_TIMEOUT_MS = 10_000;
-const cachedByContext = new Map();
-const pendingByContext = new Map();
-function disposeCachedConsumers() {
-    for (const cached of cachedByContext.values()) {
-        cached.consumer.dispose();
-    }
-    cachedByContext.clear();
-}
-(0, peers_sdk_1.subscribeHostContractTransport)((transport) => {
-    if ([...cachedByContext.values()].some((cached) => cached.transport !== transport)) {
-        disposeCachedConsumers();
-        pendingByContext.clear();
-    }
-}, { emitCurrent: false });
-async function loadConsumer(transport, dataContextId) {
-    cachedByContext.get(dataContextId)?.consumer.dispose();
-    cachedByContext.delete(dataContextId);
-    const consumer = (0, peers_sdk_1.createContractConsumer)((0, peers_sdk_1.getToolAccessControlContractDefinition)(), transport, {
-        dataContextId,
-    });
-    try {
-        await consumer.loadingPromise;
-        if ((0, peers_sdk_1.getHostContractTransport)() !== transport) {
-            consumer.dispose();
-            pendingByContext.delete(dataContextId);
-            return getToolAccessControlConsumer(dataContextId);
-        }
-        cachedByContext.set(dataContextId, { transport, consumer });
-        return consumer;
-    }
-    catch (error) {
-        consumer.dispose();
-        throw error;
-    }
-}
+const consumers = new Map();
 /**
  * Return a typed local-host consumer for Tool Access Control in `dataContextId`.
+ *
+ * One consumer is cached per data context and rebuilt when the host transport changes.
  */
 async function getToolAccessControlConsumer(dataContextId) {
-    const transport = (0, peers_sdk_1.getHostContractTransport)() ??
-        (await (0, peers_sdk_1.waitForHostContractTransport)({ timeoutMs: HOST_TRANSPORT_TIMEOUT_MS }));
-    const cached = cachedByContext.get(dataContextId);
-    if (cached?.transport === transport) {
-        return cached.consumer;
-    }
-    const pending = pendingByContext.get(dataContextId);
-    if (pending) {
-        return pending;
-    }
-    const loadPromise = loadConsumer(transport, dataContextId);
-    pendingByContext.set(dataContextId, loadPromise);
-    try {
-        return await loadPromise;
-    }
-    finally {
-        if (pendingByContext.get(dataContextId) === loadPromise) {
-            pendingByContext.delete(dataContextId);
-        }
+    let handle = consumers.get(dataContextId);
+    if (!handle) {
+        handle = (0, peers_sdk_1.hostContractConsumer)((0, peers_sdk_1.getToolAccessControlContractDefinition)(), { dataContextId: async () => dataContextId });
+        consumers.set(dataContextId, handle);
     }
+    return handle.get();
 }

package/dist/screens/welcome-modal.js

@@ -6,10 +6,11 @@ const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = require("react");
 const hooks_1 = require("../hooks");
 const peers_services_registration_1 = require("../peers-services-registration");
+const identity_ipc_1 = require("./device-pairing/identity-ipc");
 async function tryRegisterPeersServicesAfterWelcome() {
     try {
-        const token = await peers_sdk_1.rpcServerCalls.registerWithPeersServices();
-        (0, peers_services_registration_1.persistPeersServicesRegistration)(token);
+        const { token } = await (await (0, identity_ipc_1.identityTools)()).registerWithPeersServices();
+        await (0, peers_services_registration_1.persistPeersServicesRegistration)(token);
     }
     catch (err) {
         console.warn("Peers services registration after welcome modal:", err);

package/dist/system-apps/identity.app.d.ts

@@ -0,0 +1,3 @@
+import type { IAppNav } from "@peers-app/peers-sdk";
+/** Identity system app: activity, people, groups, devices, and account. */
+export declare const identityApp: IAppNav;

package/dist/system-apps/identity.app.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identityApp = void 0;
+/** Identity system app: activity, people, groups, devices, and account. */
+exports.identityApp = {
+    name: "Identity",
+    displayName: "Identity",
+    iconClassName: "bi-person-badge",
+    navigationPath: "identity",
+};

package/dist/system-apps/index.d.ts

@@ -1,12 +1,9 @@
 import type { IAppNav } from "@peers-app/peers-sdk";
 import type { IPackageWithNavs } from "../ui-router/routes-loader";
-export { accountApp } from "./account.app";
 export { assistantsApp } from "./assistants.app";
 export { consoleLogsApp } from "./console-logs.app";
-export { contactsApp } from "./contacts.app";
 export { dataExplorerApp } from "./data-explorer.app";
-export { groupsApp } from "./groups.app";
-export { invitesApp } from "./invites.app";
+export { identityApp } from "./identity.app";
 export { mobileSettingsApp } from "./mobile-settings.app";
 export { networkViewerApp } from "./network-viewer.app";
 export { packagesApp } from "./packages.app";

package/dist/system-apps/index.js

@@ -1,20 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.systemPackage = exports.systemApps = exports.workflowsApp = exports.variablesApp = exports.typesApp = exports.toolsApp = exports.threadsApp = exports.settingsApp = exports.searchApp = exports.packagesApp = exports.networkViewerApp = exports.mobileSettingsApp = exports.invitesApp = exports.groupsApp = exports.dataExplorerApp = exports.contactsApp = exports.consoleLogsApp = exports.assistantsApp = exports.accountApp = void 0;
-var account_app_1 = require("./account.app");
-Object.defineProperty(exports, "accountApp", { enumerable: true, get: function () { return account_app_1.accountApp; } });
+exports.systemPackage = exports.systemApps = exports.workflowsApp = exports.variablesApp = exports.typesApp = exports.toolsApp = exports.threadsApp = exports.settingsApp = exports.searchApp = exports.packagesApp = exports.networkViewerApp = exports.mobileSettingsApp = exports.identityApp = exports.dataExplorerApp = exports.consoleLogsApp = exports.assistantsApp = void 0;
 var assistants_app_1 = require("./assistants.app");
 Object.defineProperty(exports, "assistantsApp", { enumerable: true, get: function () { return assistants_app_1.assistantsApp; } });
 var console_logs_app_1 = require("./console-logs.app");
 Object.defineProperty(exports, "consoleLogsApp", { enumerable: true, get: function () { return console_logs_app_1.consoleLogsApp; } });
-var contacts_app_1 = require("./contacts.app");
-Object.defineProperty(exports, "contactsApp", { enumerable: true, get: function () { return contacts_app_1.contactsApp; } });
 var data_explorer_app_1 = require("./data-explorer.app");
 Object.defineProperty(exports, "dataExplorerApp", { enumerable: true, get: function () { return data_explorer_app_1.dataExplorerApp; } });
-var groups_app_1 = require("./groups.app");
-Object.defineProperty(exports, "groupsApp", { enumerable: true, get: function () { return groups_app_1.groupsApp; } });
-var invites_app_1 = require("./invites.app");
-Object.defineProperty(exports, "invitesApp", { enumerable: true, get: function () { return invites_app_1.invitesApp; } });
+var identity_app_1 = require("./identity.app");
+Object.defineProperty(exports, "identityApp", { enumerable: true, get: function () { return identity_app_1.identityApp; } });
 var mobile_settings_app_1 = require("./mobile-settings.app");
 Object.defineProperty(exports, "mobileSettingsApp", { enumerable: true, get: function () { return mobile_settings_app_1.mobileSettingsApp; } });
 var network_viewer_app_1 = require("./network-viewer.app");
@@ -36,13 +30,10 @@ var variables_app_1 = require("./variables.app");
 Object.defineProperty(exports, "variablesApp", { enumerable: true, get: function () { return variables_app_1.variablesApp; } });
 var workflows_app_1 = require("./workflows.app");
 Object.defineProperty(exports, "workflowsApp", { enumerable: true, get: function () { return workflows_app_1.workflowsApp; } });
-const account_app_2 = require("./account.app");
 const assistants_app_2 = require("./assistants.app");
 const console_logs_app_2 = require("./console-logs.app");
-const contacts_app_2 = require("./contacts.app");
 const data_explorer_app_2 = require("./data-explorer.app");
-const groups_app_2 = require("./groups.app");
-const invites_app_2 = require("./invites.app");
+const identity_app_2 = require("./identity.app");
 const mobile_settings_app_2 = require("./mobile-settings.app");
 const network_viewer_app_2 = require("./network-viewer.app");
 const packages_app_2 = require("./packages.app");
@@ -74,11 +65,8 @@ exports.systemApps = [
     workflows_app_2.workflowsApp,
     assistants_app_2.assistantsApp,
     packages_app_2.packagesApp,
-    contacts_app_2.contactsApp,
-    groups_app_2.groupsApp,
-    invites_app_2.invitesApp,
+    identity_app_2.identityApp,
     // User & Settings Apps
-    account_app_2.accountApp,
     settings_app_2.settingsApp,
     // Mobile Settings (only in React Native)
     ...(isReactNative() ? [mobile_settings_app_2.mobileSettingsApp] : []),

package/dist/tabs-layout/network-status-indicator.js

@@ -12,6 +12,7 @@ exports.TabsStripIndicators = TabsStripIndicators;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const moment_1 = __importDefault(require("moment"));
 const react_1 = require("react");
+const identity_routes_1 = require("../screens/identity/identity-routes");
 const network_viewer_ipc_1 = require("../screens/network-viewer/network-viewer-ipc");
 const tabs_state_1 = require("./tabs-state");
 const use_network_status_1 = require("./use-network-status");
@@ -189,8 +190,8 @@ function ConnectedDevicesList({ loadState }) {
     }
     return ((0, jsx_runtime_1.jsx)("ul", { className: "small mb-0 ps-0", style: { maxHeight: "180px", overflowY: "auto" }, children: loadState.connections.map((connection) => ((0, jsx_runtime_1.jsx)(ConnectedDeviceRow, { connection: connection }, connection.deviceId))) }));
 }
-function NetworkStatusDetails({ detailsId, status, unavailable, connectionsLoadState, onOpenViewer, }) {
-    return ((0, jsx_runtime_1.jsx)("div", { id: detailsId, role: "dialog", "aria-label": "Network status details", className: "card shadow position-absolute end-0 mt-1", style: { top: "100%", width: "320px", zIndex: 1100 }, children: (0, jsx_runtime_1.jsxs)("div", { className: "card-body p-3", children: [(0, jsx_runtime_1.jsx)("h6", { className: "card-title mb-2", children: "Network status" }), unavailable || !status ? ((0, jsx_runtime_1.jsx)("p", { className: "small text-muted mb-3", children: "Network diagnostics are temporarily unavailable. The local host may still be starting or reconnecting." })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("dl", { className: "row small mb-2", children: [(0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Connections" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.connectionCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Syncing contexts" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.syncingContextCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Sync errors" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.errorCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Groups connected" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.connectedContextCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Groups offline" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.disconnectedContextCount }), status.lastSuccessfulSyncAt != null && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Last sync" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end text-truncate", title: new Date(status.lastSuccessfulSyncAt).toLocaleString(), children: formatRelativeSyncTime(status.lastSuccessfulSyncAt) })] }))] }), status.errors.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "alert alert-danger py-2 px-2 small mb-2", children: [status.errors[0].message, status.errors.length > 1 && ` (+${status.errors.length - 1} more)`] })), (0, jsx_runtime_1.jsxs)("div", { className: "border-top pt-2 mt-1 mb-2", children: [(0, jsx_runtime_1.jsx)("div", { className: "small text-muted mb-1", children: "Devices" }), (0, jsx_runtime_1.jsx)(ConnectedDevicesList, { loadState: connectionsLoadState })] })] })), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-outline-primary w-100", onClick: onOpenViewer, children: "Open Network Viewer" })] }) }));
+function NetworkStatusDetails({ detailsId, status, unavailable, connectionsLoadState, onUseInvite, onOpenIdentity, onOpenViewer, }) {
+    return ((0, jsx_runtime_1.jsx)("div", { id: detailsId, role: "dialog", "aria-label": "Network status details", className: "card shadow position-absolute end-0 mt-1", style: { top: "100%", width: "320px", zIndex: 1100 }, children: (0, jsx_runtime_1.jsxs)("div", { className: "card-body p-3", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex gap-2 mb-3", children: [(0, jsx_runtime_1.jsxs)("button", { type: "button", className: "btn btn-sm btn-outline-primary flex-fill", onClick: onUseInvite, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-qr-code me-1", "aria-hidden": "true" }), "Use Invite"] }), (0, jsx_runtime_1.jsxs)("button", { type: "button", className: "btn btn-sm btn-outline-primary flex-fill", onClick: onOpenIdentity, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-person-badge me-1", "aria-hidden": "true" }), "Identity"] })] }), (0, jsx_runtime_1.jsx)("h6", { className: "card-title mb-2", children: "Network status" }), unavailable || !status ? ((0, jsx_runtime_1.jsx)("p", { className: "small text-muted mb-3", children: "Network diagnostics are temporarily unavailable. The local host may still be starting or reconnecting." })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("dl", { className: "row small mb-2", children: [(0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Connections" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.connectionCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Syncing contexts" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.syncingContextCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Sync errors" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.errorCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Groups connected" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.connectedContextCount }), (0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Groups offline" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end", children: status.disconnectedContextCount }), status.lastSuccessfulSyncAt != null && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Last sync" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end text-truncate", title: new Date(status.lastSuccessfulSyncAt).toLocaleString(), children: formatRelativeSyncTime(status.lastSuccessfulSyncAt) })] }))] }), status.errors.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "alert alert-danger py-2 px-2 small mb-2", children: [status.errors[0].message, status.errors.length > 1 && ` (+${status.errors.length - 1} more)`] })), (0, jsx_runtime_1.jsxs)("div", { className: "border-top pt-2 mt-1 mb-2", children: [(0, jsx_runtime_1.jsx)("div", { className: "small text-muted mb-1", children: "Devices" }), (0, jsx_runtime_1.jsx)(ConnectedDevicesList, { loadState: connectionsLoadState })] })] })), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-outline-primary w-100", onClick: onOpenViewer, children: "Open Network Viewer" })] }) }));
 }
 /** Accessible reactive network status button and details popover. */
 function NetworkStatusIndicator({ compact = false }) {
@@ -305,7 +306,13 @@ function NetworkStatusIndicator({ compact = false }) {
                                     fontWeight: 700,
                                     right: "-0.28rem",
                                     bottom: "-0.32rem",
-                                }, "aria-hidden": "true", children: presentation.disconnectedGroupsOverlay.count }))] }), !compact && ((0, jsx_runtime_1.jsxs)("span", { className: "small", children: [viewState.status?.connectionCount ?? 0, (0, jsx_runtime_1.jsx)("span", { className: "visually-hidden", children: " connections" })] }))] }), open && ((0, jsx_runtime_1.jsx)(NetworkStatusDetails, { detailsId: detailsId, status: viewState.status, unavailable: viewState.availability !== "ready", connectionsLoadState: connectionsLoadState, onOpenViewer: () => {
+                                }, "aria-hidden": "true", children: presentation.disconnectedGroupsOverlay.count }))] }), !compact && ((0, jsx_runtime_1.jsxs)("span", { className: "small", children: [viewState.status?.connectionCount ?? 0, (0, jsx_runtime_1.jsx)("span", { className: "visually-hidden", children: " connections" })] }))] }), open && ((0, jsx_runtime_1.jsx)(NetworkStatusDetails, { detailsId: detailsId, status: viewState.status, unavailable: viewState.availability !== "ready", connectionsLoadState: connectionsLoadState, onUseInvite: () => {
+                    setOpen(false);
+                    (0, tabs_state_1.goToTabPath)(identity_routes_1.IDENTITY_ACCEPT_PATH);
+                }, onOpenIdentity: () => {
+                    setOpen(false);
+                    (0, tabs_state_1.goToTabPath)(identity_routes_1.IDENTITY_ACCOUNT_PATH);
+                }, onOpenViewer: () => {
                     setOpen(false);
                     (0, tabs_state_1.goToTabPath)("network-viewer");
                 } }))] }));

package/dist/tabs-layout/network-status-indicator.test.js

@@ -7,6 +7,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = require("@testing-library/react");
 const moment_1 = __importDefault(require("moment"));
+const identity_routes_1 = require("../screens/identity/identity-routes");
 const network_status_indicator_1 = require("./network-status-indicator");
 const goToTabPath = jest.fn();
 const getConnections = jest.fn();
@@ -424,6 +425,20 @@ describe("NetworkStatusIndicator", () => {
             expect(view.getByRole("dialog")).toHaveTextContent("Couldn't load devices");
         });
     });
+    it("offers shortcuts to use an invite and open the Identity account", () => {
+        mockViewState = { availability: "ready", status: status({ state: "synced" }) };
+        const view = (0, react_1.render)((0, jsx_runtime_1.jsx)(network_status_indicator_1.NetworkStatusIndicator, {}));
+        react_1.fireEvent.click(view.getByRole("button", { name: /Network synced/ }));
+        expect(view.getByRole("button", { name: "Use Invite" }).querySelector(".bi-qr-code")).toBeTruthy();
+        expect(view.getByRole("button", { name: "Identity" }).querySelector(".bi-person-badge")).toBeTruthy();
+        react_1.fireEvent.click(view.getByRole("button", { name: "Use Invite" }));
+        expect(goToTabPath).toHaveBeenCalledWith(identity_routes_1.IDENTITY_ACCEPT_PATH);
+        expect(view.queryByRole("dialog", { name: "Network status details" })).toBeNull();
+        react_1.fireEvent.click(view.getByRole("button", { name: /Network synced/ }));
+        react_1.fireEvent.click(view.getByRole("button", { name: "Identity" }));
+        expect(goToTabPath).toHaveBeenCalledWith(identity_routes_1.IDENTITY_ACCOUNT_PATH);
+        expect(view.queryByRole("dialog", { name: "Network status details" })).toBeNull();
+    });
     it("updates on rerender and opens details before navigating to Network Viewer", async () => {
         const view = (0, react_1.render)((0, jsx_runtime_1.jsx)(network_status_indicator_1.NetworkStatusIndicator, {}));
         expect(view.getByRole("button", { name: /loading/ })).toBeTruthy();

package/dist/tabs-layout/tabs-layout.js

@@ -44,6 +44,7 @@ const group_switcher_1 = require("../components/group-switcher");
 const router_1 = require("../components/router");
 const globals_1 = require("../globals");
 const hooks_1 = require("../hooks");
+const identity_routes_1 = require("../screens/identity/identity-routes");
 const color_mode_dropdown_1 = require("../screens/settings/color-mode-dropdown");
 const system_apps_1 = require("../system-apps");
 const routes_loader_1 = require("../ui-router/routes-loader");
@@ -281,7 +282,8 @@ const TabContentRenderer = react_1.default.memo(({ tab, isMobile }) => {
     // System apps use the main Router (which reads from mainContentPath)
     // Package apps use UIRouter with explicit path
     const isSystemApp = tab.packageId === "system-apps";
-    return ((0, jsx_runtime_1.jsx)("div", { className: `h-100 overflow-auto ${isMobile ? "p-2" : "p-3"}`, children: isSystemApp ? ((0, jsx_runtime_1.jsx)(router_1.Router, { path: tab.path })) : ((0, jsx_runtime_1.jsx)(ui_loader_1.UIRouter, { path: tab.path, uiCategory: "screen", props: {} })) }));
+    const identityApp = isSystemApp && (0, identity_routes_1.isIdentityPath)(tab.path);
+    return ((0, jsx_runtime_1.jsx)("div", { className: `h-100 ${identityApp ? "overflow-hidden" : "overflow-auto"} ${identityApp ? "" : isMobile ? "p-2" : "p-3"}`, children: isSystemApp ? ((0, jsx_runtime_1.jsx)(router_1.Router, { path: tab.path })) : ((0, jsx_runtime_1.jsx)(ui_loader_1.UIRouter, { path: tab.path, uiCategory: "screen", props: {} })) }));
 }, (prevProps, nextProps) => {
     // Only re-render if the tab or isMobile changed
     return (prevProps.tab.tabId === nextProps.tab.tabId &&

package/dist/tabs-layout/tabs-state.d.ts

@@ -1,5 +1,6 @@
 import { type IAppNav, type Observable } from "@peers-app/peers-sdk";
 import { type IPackageWithNavs } from "../ui-router/routes-loader";
+/** One top-level app tab. */
 export interface TabState {
     tabId: string;
     packageId?: string;
@@ -7,24 +8,92 @@ export interface TabState {
     title: string;
     iconClassName?: string;
 }
+/** The app launcher tab. It is always present and cannot be closed. */
 export declare const launcherApp: TabState;
+/** Open tabs. Writes through to device storage after the initial restore. */
 export declare const activeTabs: Observable<TabState[]> & {
     loadingPromise: Promise<void>;
 };
+/** Id of the tab whose path is showing. */
 export declare const activeTabId: Observable<string> & {
     loadingPromise: Promise<void>;
 };
+/** App roots recently opened from the launcher, newest first. */
 export declare const recentlyUsedApps: Observable<string[]> & {
     loadingPromise: Promise<void>;
 };
+/** Tab ids whose bodies have been mounted at least once. */
 export declare const initializedTabs: Set<string>;
+/** Options for {@link navigateTo}. */
+export interface NavigateOptions {
+    /**
+     * When the requested path is an app's root and that app is already open,
+     * activate the existing tab without resetting its section.
+     */
+    preserveSectionOnAppRoot?: boolean;
+}
+/**
+ * Open a path in the tab that owns its app.
+ *
+ * Legacy identity aliases are rewritten first. A route owned by the current
+ * app replaces that tab's path. A route owned by another open app activates
+ * that app's tab. Otherwise a new tab is opened.
+ *
+ * @param rawPath - Requested route, with or without a query string.
+ * @param options - App-root behavior. Launcher opens preserve the current section.
+ */
+export declare function navigateTo(rawPath: string, options?: NavigateOptions): void;
+/**
+ * Open an app or path from the launcher.
+ *
+ * Choosing an app that is already open keeps the section the user was on.
+ *
+ * @param path - App root or deep link.
+ */
 export declare function goToTabPath(path: string): void;
-export declare const handleMainPathChanged: (oldPath: string, newPath: string, setNewMainPath: (path: string) => void) => void;
+/**
+ * Apply a {@link mainContentPath} write to the open tabs.
+ *
+ * @param _oldPath - Previous route. Retained for existing call sites.
+ * @param newPath - Requested route.
+ * @param _setNewMainPath - Direct path setter. Navigation updates the path itself.
+ */
+export declare const handleMainPathChanged: (_oldPath: string, newPath: string, _setNewMainPath: (path: string) => void) => void;
+/**
+ * Rewrite stored tabs onto canonical routes.
+ *
+ * Contacts, Groups, and Devices tabs from before the Identity app become one
+ * Identity tab. The active tab is kept when it is one of those duplicates.
+ *
+ * @param tabs - Persisted tabs.
+ * @param activeId - Persisted active tab id.
+ */
+export declare function restoreNavigationState(tabs: TabState[], activeId: string): {
+    tabs: TabState[];
+    activeId: string;
+};
+/**
+ * Map a stored recent-app path onto the current app root.
+ *
+ * @param path - Persisted recent path, possibly a legacy alias.
+ */
+export declare function migrateRecentPath(path: string): string;
 type AppInfo = {
     navItem: IAppNav;
     package: IPackageWithNavs;
 };
+/**
+ * Resolve the app that owns a route.
+ *
+ * @param path - Route, with or without a query string.
+ * @returns The matching app, the launcher for an empty path, or `undefined`.
+ */
 export declare function determineAppFromPath(path: string): AppInfo | undefined;
+/**
+ * Set the active tab's title.
+ *
+ * @param newTitle - Title shown on the tab strip.
+ */
 export declare const updateActiveTabTitle: (newTitle: string) => void;
 /**
  * Enable or disable single-tab mode.
@@ -36,8 +105,17 @@ export declare const updateActiveTabTitle: (newTitle: string) => void;
  * and disable it on unmount.
  */
 export declare const setSingleTabMode: (enabled: boolean) => void;
+/**
+ * Open a tab, or activate an existing tab with the same package and path.
+ *
+ * @param tab - Tab contents. `tabId` is assigned here.
+ * @param forceNew - When true, always append a tab instead of reusing one.
+ */
 export declare const openNewTab: (tab: Omit<TabState, "tabId">, forceNew?: boolean) => void;
+/** Close the active tab. The launcher tab stays open. */
 export declare const closeCurrentTab: () => void;
+/** Activate the next open tab, wrapping around. */
 export declare const switchToNextTab: () => void;
+/** Activate the previous open tab, wrapping around. */
 export declare const switchToPreviousTab: () => void;
 export {};