@arbidocs/blocks 0.4.5 → 0.4.6

package/dist/shell/InstallPrompt.d.ts

@@ -0,0 +1,28 @@
+import { type UseInstallPromptOptions } from './use-install-prompt';
+/** Fixed strings of the install prompt. */
+export interface InstallPromptLabels {
+    /** The pill's text. */
+    install: string;
+    /** The dismiss button's accessible name. */
+    dismiss: string;
+    /** Accessible name of the pill (`{app}` is replaced by `appName`). */
+    installAs: string;
+}
+export declare const DEFAULT_INSTALL_PROMPT_LABELS: InstallPromptLabels;
+export interface InstallPromptProps extends UseInstallPromptOptions {
+    /** Which bottom corner the pill sits in. Default `start` (clear of a bottom-right toaster). */
+    placement?: 'start' | 'end';
+    labels?: Partial<InstallPromptLabels>;
+    className?: string;
+    'data-testid'?: string;
+}
+/**
+ * A small floating "Install app" pill. Renders only while the app can be installed (the browser
+ * fired `beforeinstallprompt`, or on iOS where it shows the Add to Home Screen steps), is not
+ * already installed, and was not dismissed (the dismissal is remembered for `dismissDays`).
+ *
+ * It sits above whatever is pinned to the bottom of the screen: it reads `--shell-bottom-inset`
+ * (set by `MobileTabBar` and the chat composer, see `useShellBottomInset`) plus the device
+ * safe area, so it never covers the tab bar or the composer. Both controls are 44px tall on a phone.
+ */
+export declare function InstallPrompt({ placement, labels, className, 'data-testid': testId, ...options }: InstallPromptProps): import("react").JSX.Element | null;

package/dist/shell/MobileBars.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import type { NavItem } from './types';
 /** Fixed strings of the phone bars. */
 export interface MobileBarsLabels {

package/dist/shell/index.cjs

@@ -1,147 +1,179 @@
 "use client";
 'use strict';
 
-var chunkDN3NFNIA_cjs = require('../chunk-DN3NFNIA.cjs');
+var chunkQMDLPO3M_cjs = require('../chunk-QMDLPO3M.cjs');
 var chunk5B4PXAKI_cjs = require('../chunk-5B4PXAKI.cjs');
-require('../chunk-PPCATBOY.cjs');
 require('../chunk-OB5F4577.cjs');
 require('../chunk-C54XEN5T.cjs');
-var chunkKHX2BX3S_cjs = require('../chunk-KHX2BX3S.cjs');
+var chunkVGOFFCMT_cjs = require('../chunk-VGOFFCMT.cjs');
+require('../chunk-PPCATBOY.cjs');
 require('../chunk-MHVNT4J3.cjs');
 
 
 
 Object.defineProperty(exports, "ActionCluster", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.ActionCluster; }
+  get: function () { return chunkQMDLPO3M_cjs.ActionCluster; }
 });
 Object.defineProperty(exports, "AskField", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.AskField; }
+  get: function () { return chunkQMDLPO3M_cjs.AskField; }
 });
 Object.defineProperty(exports, "AskRow", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.AskRow; }
+  get: function () { return chunkQMDLPO3M_cjs.AskRow; }
 });
 Object.defineProperty(exports, "AskTrigger", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.AskTrigger; }
+  get: function () { return chunkQMDLPO3M_cjs.AskTrigger; }
 });
 Object.defineProperty(exports, "DEFAULT_ASK_FIELD_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_ASK_FIELD_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_ASK_FIELD_LABELS; }
+});
+Object.defineProperty(exports, "DEFAULT_INSTALL_PROMPT_LABELS", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_INSTALL_PROMPT_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_MOBILE_BARS_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_MOBILE_BARS_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_MOBILE_BARS_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_OFFLINE_PILL_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_OFFLINE_PILL_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_OFFLINE_PILL_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_REMOTE_CONTROL_PILL_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_REMOTE_CONTROL_PILL_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_REMOTE_CONTROL_PILL_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_SIDEBAR_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_SIDEBAR_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_SIDEBAR_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_TIP_CARD_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_TIP_CARD_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_TIP_CARD_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_WORKSPACE_KIND_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_WORKSPACE_KIND_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_WORKSPACE_KIND_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_WORKSPACE_SWITCHER_LABELS", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.DEFAULT_WORKSPACE_SWITCHER_LABELS; }
+  get: function () { return chunkQMDLPO3M_cjs.DEFAULT_WORKSPACE_SWITCHER_LABELS; }
+});
+Object.defineProperty(exports, "INSTALL_PROMPT_DISMISSED_KEY", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.INSTALL_PROMPT_DISMISSED_KEY; }
 });
 Object.defineProperty(exports, "InfoBar", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.InfoBar; }
+  get: function () { return chunkQMDLPO3M_cjs.InfoBar; }
+});
+Object.defineProperty(exports, "InstallPrompt", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.InstallPrompt; }
 });
 Object.defineProperty(exports, "MobileAppBar", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.MobileAppBar; }
+  get: function () { return chunkQMDLPO3M_cjs.MobileAppBar; }
 });
 Object.defineProperty(exports, "MobileTabBar", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.MobileTabBar; }
+  get: function () { return chunkQMDLPO3M_cjs.MobileTabBar; }
 });
 Object.defineProperty(exports, "NotificationBell", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.NotificationBell; }
+  get: function () { return chunkQMDLPO3M_cjs.NotificationBell; }
 });
 Object.defineProperty(exports, "OfflinePill", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.OfflinePill; }
+  get: function () { return chunkQMDLPO3M_cjs.OfflinePill; }
 });
 Object.defineProperty(exports, "RemoteControlPill", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.RemoteControlPill; }
+  get: function () { return chunkQMDLPO3M_cjs.RemoteControlPill; }
 });
 Object.defineProperty(exports, "Sidebar", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.Sidebar; }
+  get: function () { return chunkQMDLPO3M_cjs.Sidebar; }
 });
 Object.defineProperty(exports, "SidebarBadgeRow", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.SidebarBadgeRow; }
+  get: function () { return chunkQMDLPO3M_cjs.SidebarBadgeRow; }
 });
 Object.defineProperty(exports, "SidebarRowAction", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.SidebarRowAction; }
+  get: function () { return chunkQMDLPO3M_cjs.SidebarRowAction; }
 });
 Object.defineProperty(exports, "SidebarRowHoverContext", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.SidebarRowHoverContext; }
+  get: function () { return chunkQMDLPO3M_cjs.SidebarRowHoverContext; }
 });
 Object.defineProperty(exports, "SplitLayout", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.SplitLayout; }
+  get: function () { return chunkQMDLPO3M_cjs.SplitLayout; }
 });
 Object.defineProperty(exports, "StatusRow", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.StatusRow; }
+  get: function () { return chunkQMDLPO3M_cjs.StatusRow; }
 });
 Object.defineProperty(exports, "TipCard", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.TipCard; }
+  get: function () { return chunkQMDLPO3M_cjs.TipCard; }
 });
 Object.defineProperty(exports, "UserMenu", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.UserMenu; }
+  get: function () { return chunkQMDLPO3M_cjs.UserMenu; }
 });
 Object.defineProperty(exports, "WorkspaceIdentity", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.WorkspaceIdentity; }
+  get: function () { return chunkQMDLPO3M_cjs.WorkspaceIdentity; }
 });
 Object.defineProperty(exports, "WorkspaceSwitcher", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.WorkspaceSwitcher; }
+  get: function () { return chunkQMDLPO3M_cjs.WorkspaceSwitcher; }
+});
+Object.defineProperty(exports, "getInstallInstructions", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.getInstallInstructions; }
+});
+Object.defineProperty(exports, "initInstallPrompt", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.initInstallPrompt; }
+});
+Object.defineProperty(exports, "isIosDevice", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.isIosDevice; }
+});
+Object.defineProperty(exports, "promptAppInstall", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.promptAppInstall; }
 });
 Object.defineProperty(exports, "resolveSidebarLayout", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.resolveSidebarLayout; }
+  get: function () { return chunkQMDLPO3M_cjs.resolveSidebarLayout; }
+});
+Object.defineProperty(exports, "useInstallPrompt", {
+  enumerable: true,
+  get: function () { return chunkQMDLPO3M_cjs.useInstallPrompt; }
 });
 Object.defineProperty(exports, "useSidebarContext", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.useSidebarContext; }
+  get: function () { return chunkQMDLPO3M_cjs.useSidebarContext; }
 });
 Object.defineProperty(exports, "useSidebarSettle", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.useSidebarSettle; }
+  get: function () { return chunkQMDLPO3M_cjs.useSidebarSettle; }
 });
 Object.defineProperty(exports, "workspaceKindColor", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.workspaceKindColor; }
+  get: function () { return chunkQMDLPO3M_cjs.workspaceKindColor; }
 });
 Object.defineProperty(exports, "workspaceKindMeta", {
   enumerable: true,
-  get: function () { return chunkDN3NFNIA_cjs.workspaceKindMeta; }
+  get: function () { return chunkQMDLPO3M_cjs.workspaceKindMeta; }
 });
 Object.defineProperty(exports, "DEFAULT_TAB_HEADER_LABELS", {
   enumerable: true,
@@ -153,39 +185,47 @@ Object.defineProperty(exports, "TabHeader", {
 });
 Object.defineProperty(exports, "DEFAULT_OVERLAY_ZONE_ID", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.DEFAULT_OVERLAY_ZONE_ID; }
+  get: function () { return chunkVGOFFCMT_cjs.DEFAULT_OVERLAY_ZONE_ID; }
 });
 Object.defineProperty(exports, "DEFAULT_PAGE_CONTAINER_PADDING", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.DEFAULT_PAGE_CONTAINER_PADDING; }
+  get: function () { return chunkVGOFFCMT_cjs.DEFAULT_PAGE_CONTAINER_PADDING; }
 });
 Object.defineProperty(exports, "DEFAULT_SIDEBAR_TOGGLE_BUTTON_LABELS", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.DEFAULT_SIDEBAR_TOGGLE_BUTTON_LABELS; }
+  get: function () { return chunkVGOFFCMT_cjs.DEFAULT_SIDEBAR_TOGGLE_BUTTON_LABELS; }
 });
 Object.defineProperty(exports, "PageContainer", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.PageContainer; }
+  get: function () { return chunkVGOFFCMT_cjs.PageContainer; }
+});
+Object.defineProperty(exports, "SHELL_BOTTOM_INSET_VAR", {
+  enumerable: true,
+  get: function () { return chunkVGOFFCMT_cjs.SHELL_BOTTOM_INSET_VAR; }
 });
 Object.defineProperty(exports, "Shell", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.Shell; }
+  get: function () { return chunkVGOFFCMT_cjs.Shell; }
 });
 Object.defineProperty(exports, "SidebarToggleButton", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.SidebarToggleButton; }
+  get: function () { return chunkVGOFFCMT_cjs.SidebarToggleButton; }
 });
 Object.defineProperty(exports, "ToolButton", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.ToolButton; }
+  get: function () { return chunkVGOFFCMT_cjs.ToolButton; }
 });
 Object.defineProperty(exports, "useDrawerBehavior", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.useDrawerBehavior; }
+  get: function () { return chunkVGOFFCMT_cjs.useDrawerBehavior; }
 });
 Object.defineProperty(exports, "useOverlayZoneId", {
   enumerable: true,
-  get: function () { return chunkKHX2BX3S_cjs.useOverlayZoneId; }
+  get: function () { return chunkVGOFFCMT_cjs.useOverlayZoneId; }
+});
+Object.defineProperty(exports, "useShellBottomInset", {
+  enumerable: true,
+  get: function () { return chunkVGOFFCMT_cjs.useShellBottomInset; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/shell/index.d.ts

@@ -5,6 +5,10 @@ export { SidebarRowAction, type SidebarRowActionProps, type SidebarRowActionPuls
 export { WorkspaceSwitcher, WorkspaceIdentity, workspaceKindMeta, workspaceKindColor, DEFAULT_WORKSPACE_KIND_LABELS, DEFAULT_WORKSPACE_SWITCHER_LABELS, type WorkspaceSwitcherProps, type WorkspaceIdentityProps, type WorkspaceKindLabels, type WorkspaceSwitcherLabels, } from './Workspace';
 export { AskField, AskTrigger, AskRow, DEFAULT_ASK_FIELD_LABELS, type AskFieldLabels, type AskFieldProps, type AskTriggerProps, type AskRowProps, } from './AskField';
 export { MobileAppBar, MobileTabBar, DEFAULT_MOBILE_BARS_LABELS, type MobileBarsLabels, type MobileAppBarProps, type MobileTabBarProps, } from './MobileBars';
+export { InstallPrompt, DEFAULT_INSTALL_PROMPT_LABELS, type InstallPromptLabels, type InstallPromptProps, } from './InstallPrompt';
+export { useInstallPrompt, initInstallPrompt, promptAppInstall, INSTALL_PROMPT_DISMISSED_KEY, type UseInstallPromptOptions, type UseInstallPromptResult, } from './use-install-prompt';
+export { getInstallInstructions, isIosDevice, type InstallGuide, type InstallInstructionsOptions, } from './install-instructions';
+export { useShellBottomInset, SHELL_BOTTOM_INSET_VAR } from '../lib/bottom-inset';
 export { ActionCluster, type ActionClusterProps } from './ActionCluster';
 export { ToolButton, type ToolButtonProps } from './ToolButton';
 export { StatusRow, type StatusRowProps, type StatusRowTone } from './StatusRow';

package/dist/shell/index.js

@@ -1,10 +1,10 @@
 "use client";
-export { ActionCluster, AskField, AskRow, AskTrigger, DEFAULT_ASK_FIELD_LABELS, DEFAULT_MOBILE_BARS_LABELS, DEFAULT_OFFLINE_PILL_LABELS, DEFAULT_REMOTE_CONTROL_PILL_LABELS, DEFAULT_SIDEBAR_LABELS, DEFAULT_TIP_CARD_LABELS, DEFAULT_WORKSPACE_KIND_LABELS, DEFAULT_WORKSPACE_SWITCHER_LABELS, InfoBar, MobileAppBar, MobileTabBar, NotificationBell, OfflinePill, RemoteControlPill, Sidebar, SidebarBadgeRow, SidebarRowAction, SidebarRowHoverContext, SplitLayout, StatusRow, TipCard, UserMenu, WorkspaceIdentity, WorkspaceSwitcher, resolveSidebarLayout, useSidebarContext, useSidebarSettle, workspaceKindColor, workspaceKindMeta } from '../chunk-TI4UTYRL.js';
+export { ActionCluster, AskField, AskRow, AskTrigger, DEFAULT_ASK_FIELD_LABELS, DEFAULT_INSTALL_PROMPT_LABELS, DEFAULT_MOBILE_BARS_LABELS, DEFAULT_OFFLINE_PILL_LABELS, DEFAULT_REMOTE_CONTROL_PILL_LABELS, DEFAULT_SIDEBAR_LABELS, DEFAULT_TIP_CARD_LABELS, DEFAULT_WORKSPACE_KIND_LABELS, DEFAULT_WORKSPACE_SWITCHER_LABELS, INSTALL_PROMPT_DISMISSED_KEY, InfoBar, InstallPrompt, MobileAppBar, MobileTabBar, NotificationBell, OfflinePill, RemoteControlPill, Sidebar, SidebarBadgeRow, SidebarRowAction, SidebarRowHoverContext, SplitLayout, StatusRow, TipCard, UserMenu, WorkspaceIdentity, WorkspaceSwitcher, getInstallInstructions, initInstallPrompt, isIosDevice, promptAppInstall, resolveSidebarLayout, useInstallPrompt, useSidebarContext, useSidebarSettle, workspaceKindColor, workspaceKindMeta } from '../chunk-EY2RJW27.js';
 export { DEFAULT_TAB_HEADER_LABELS, TabHeader } from '../chunk-UBNVIIBT.js';
-import '../chunk-NPLYHR2E.js';
 import '../chunk-S7PSMMRG.js';
 import '../chunk-76JDDMSP.js';
-export { DEFAULT_OVERLAY_ZONE_ID, DEFAULT_PAGE_CONTAINER_PADDING, DEFAULT_SIDEBAR_TOGGLE_BUTTON_LABELS, PageContainer, Shell, SidebarToggleButton, ToolButton, useDrawerBehavior, useOverlayZoneId } from '../chunk-2VBJ763Y.js';
+export { DEFAULT_OVERLAY_ZONE_ID, DEFAULT_PAGE_CONTAINER_PADDING, DEFAULT_SIDEBAR_TOGGLE_BUTTON_LABELS, PageContainer, SHELL_BOTTOM_INSET_VAR, Shell, SidebarToggleButton, ToolButton, useDrawerBehavior, useOverlayZoneId, useShellBottomInset } from '../chunk-KZJAG7T3.js';
+import '../chunk-NPLYHR2E.js';
 import '../chunk-7F6CBP3Z.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/shell/install-instructions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Per-browser PWA install instructions, for when the browser cannot open the install dialog
+ * directly (iOS Safari, Safari on macOS, Firefox, or a Chromium browser that never fired
+ * `beforeinstallprompt`). Only Chromium exposes a JS trigger, so off that path we tell the user
+ * the right gesture for their browser.
+ */
+export interface InstallGuide {
+    heading: string;
+    steps: string[];
+    note?: string;
+}
+export interface InstallInstructionsOptions {
+    /** Name shown in the steps. Default `this app`. */
+    appName?: string;
+}
+/** True on iPhone/iPad/iPod, including iPadOS reporting as a Mac. */
+export declare function isIosDevice(): boolean;
+/** Pick install steps for the current browser/platform. */
+export declare function getInstallInstructions({ appName, }?: InstallInstructionsOptions): InstallGuide;

package/dist/shell/types.d.ts

@@ -7,6 +7,12 @@ export interface NavItem {
     /** Stable key; also the suffix of the mobile tab test id (`mobile-tab-{id}`). */
     id: string;
     label: string;
+    /**
+     * Shorter text for a narrow phone tab (`Assistant` for `AI Assistant`). The tab bar shows it
+     * when the tab is under 5.5rem wide and the full label otherwise; the full label stays the
+     * accessible name. Words are never cut mid-word either way.
+     */
+    shortLabel?: string;
     /** Glyph (compose any status dot into it). */
     icon: ReactNode;
     active?: boolean;

package/dist/shell/use-install-prompt.d.ts

@@ -0,0 +1,49 @@
+import { type InstallGuide } from './install-instructions';
+/**
+ * Begin capturing install events. Idempotent. Chromium fires `beforeinstallprompt` once, early,
+ * usually before a lazy route has mounted, so call this at app startup (before the first render);
+ * `useInstallPrompt` also calls it, which is enough when the hook mounts at the root.
+ *
+ * `options.autoPromptParam`: a share link `/?{param}=true` opens the native dialog as soon as the
+ * browser is ready (Chromium).
+ */
+export declare function initInstallPrompt(options?: {
+    autoPromptParam?: string;
+}): void;
+/**
+ * Open the browser's install dialog if one was captured. Returns false when there is none (the
+ * caller then shows {@link getInstallInstructions}). A captured prompt works once.
+ */
+export declare function promptAppInstall(): Promise<boolean>;
+/** Default storage key of the remembered dismissal. */
+export declare const INSTALL_PROMPT_DISMISSED_KEY = "arbi-blocks:install-prompt-dismissed";
+export interface UseInstallPromptOptions {
+    /** localStorage key remembering a dismissal. */
+    storageKey?: string;
+    /** Days a dismissal is remembered. Default 30. */
+    dismissDays?: number;
+    /** Query param that turns a share link into a one-click install (`install` for `?install=true`). */
+    autoPromptParam?: string;
+    /** App name used in the manual instructions. */
+    appName?: string;
+}
+export interface UseInstallPromptResult {
+    /** A native install dialog can be opened right now (Chromium, once the event fired). */
+    canPrompt: boolean;
+    /** Running as an installed app, or `appinstalled` fired. */
+    isInstalled: boolean;
+    /** iOS has no install API: offer manual instructions instead. */
+    isIos: boolean;
+    /** The user dismissed the offer (remembered across visits). */
+    isDismissed: boolean;
+    /** Open the native dialog; false when none is available. */
+    promptInstall: () => Promise<boolean>;
+    /** Hide the offer and remember it. */
+    dismiss: () => void;
+    /** Manual steps for this browser. */
+    instructions: InstallGuide;
+}
+/** The install state of the app, framework-neutral logic behind `InstallPrompt`. */
+export declare function useInstallPrompt({ storageKey, dismissDays, autoPromptParam: autoParam, appName, }?: UseInstallPromptOptions): UseInstallPromptResult;
+/** Test seam: forget captured state (the singleton lives for the page). */
+export declare function resetInstallPromptForTests(): void;