Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

feat(mobile): 优化内置浏览器与原生遮挡区域适配 (#4717)

Dash2234ef74c93d
diff --git a/apps/mobile/app/files/preview/[sessionId].tsx b/apps/mobile/app/files/preview/[sessionId].tsx
index 38c24b31b0..5b55a94cee 100644
--- a/apps/mobile/app/files/preview/[sessionId].tsx
+++ b/apps/mobile/app/files/preview/[sessionId].tsx
@@ -9,7 +9,8 @@
* 切换文件通过 Done 返回列表完成。
* 文本 = readFile(acceptGzip,pako 解码)+ 行号列表;图片 = 缩略图立即显示,
* OSS 导出原图就绪后无缝换源(不出 loading 态,规则 7);其它 = 占位 + 下载。
- * markdown 与 HTML 额外有「渲染 / 源码」双态,默认渲染。markdown 复用已读文本;
+ * markdown 与 HTML 额外有「渲染 / 源码」双态,默认渲染。HTML 使用浮动浏览器控件,
+ * 源码和文件操作收进更多菜单;markdown 保留原来的切换栏并复用已读文本。
* HTML 渲染完整目录快照,源码仍走文本通道与原有大小限制。
*
* absPath 单文件模式(route 参 absPath,与 relPath 互斥):聊天 chip 指向
@@ -25,6 +26,7 @@ import { useTranslation } from 'react-i18next';
import { ArrowDownToLine, Copy, Database, File as FileIcon, Info, MessageSquarePlus, Share as ShareIcon } from 'lucide-react-native';
import {
ActivityIndicator,
+ Alert,
FlatList,
Image,
Pressable,
@@ -32,8 +34,9 @@ import {
View,
useWindowDimensions,
} from 'react-native';
-import { SafeAreaView } from 'react-native-safe-area-context';
+import { SafeAreaView, useSafeAreaInsets } from 'react-native-safe-area-context';
import { WebView } from 'react-native-webview';
+import type { WebViewNavigation } from 'react-native-webview/lib/WebViewTypes';
import { Text } from '@/components/AppText';
import { goBackGuarded } from '@/utils/backGuard';
import { useAuth } from '@/auth/AuthContext';
@@ -54,6 +57,11 @@ import { getCachedPreviewText, storeCachedPreviewText } from '@/session/fileBrow
import { exportRemoteFileToUrl } from '@/session/fileBrowserExport';
import type { RemoteMediaSshContext } from '@/session/fileBrowserGallery';
import { HtmlSnapshotReader } from '@/session/HtmlFileReader';
+import { HtmlBrowserChrome } from '@/session/HtmlBrowserChrome';
+import { HtmlWebsiteBrowser, type WebsiteVisit } from '@/session/HtmlWebsiteBrowser';
+import { normalizeBrowserAddress } from '@/session/browserAddress';
+import { HTML_BROWSER_CONTROL_SIZE, type HtmlBrowserChromeProps } from '@/session/HtmlBrowserChrome.types';
+import type { MobileHtmlPreview } from '@/session/mobileHtmlPreview';
import { prepareMobileHtmlPreview, type PrepareMobileHtmlPreview } from '@/session/mobileHtmlPreview';
import { useHtmlSnapshot } from '@/session/useHtmlSnapshot';
import { MainWindowActionButton } from '@/components/MobilePrimitives';
@@ -93,6 +101,9 @@ type TextPreviewState =
*/
type RichTextKind = 'markdown' | 'html';
+type HtmlBrowserActions = Pick<HtmlBrowserChromeProps,
+ 'busy' | 'notice' | 'onClose' | 'onShare' | 'onCopyPath' | 'onAddToTask'>;
+
interface SiblingListing {
key: string;
entries: FileBrowserRemoteOpEntry[];
@@ -494,8 +505,10 @@ export default function RemoteFilePreviewScreen() {
);
}
+ const htmlBrowser = richTextKindOf(current.relPath) === 'html';
return (
- <SafeAreaView style={styles.safeArea} testID="filePreview.screen">
+ <SafeAreaView edges={htmlBrowser ? [] : undefined} style={styles.safeArea} testID="filePreview.screen">
+ {!htmlBrowser ? <>
<PreviewNav
meta={[
`${pageIndex + 1} / ${siblings.length}`,
@@ -507,6 +520,7 @@ export default function RemoteFilePreviewScreen() {
title={current.name}
/>
<View style={styles.navHairline} />
+ </> : null}
<FlatList
data={siblings}
@@ -542,6 +556,14 @@ export default function RemoteFilePreviewScreen() {
item={item}
maker={maker}
onDownload={() => void downloadAndShare(item)}
+ htmlBrowserActions={{
+ busy: !!busyLabel,
+ notice: busyLabel ?? notice,
+ onClose: () => goBackGuarded(router),
+ onShare: () => void downloadAndShare(item),
+ onCopyPath: () => void copyPath(item),
+ onAddToTask: () => sendToSession(item),
+ }}
// chat-text-quote:markdown 渲染态选中文字 → 引用进会话草稿
// (携带当前文件路径,— source: 行),随即切回对话界面——与
// 「发送到会话」(sendToSession)的图片/路径处理一致(产品决策);
@@ -578,6 +600,7 @@ export default function RemoteFilePreviewScreen() {
windowSize={3}
/>
+ {!htmlBrowser ? <>
<View style={styles.toolbarHairline} />
<View style={styles.toolbar}>
<ToolbarButton
@@ -598,6 +621,7 @@ export default function RemoteFilePreviewScreen() {
{busyLabel || notice ? (
<Text style={styles.noticeText} testID="filePreview.notice">{busyLabel ?? notice}</Text>
) : null}
+ </> : null}
{lightboxImages.length > 0 ? (
<ImageLightbox
@@ -652,6 +676,7 @@ function FilePreviewPage({
exportToUrl,
prepareHtmlPreview,
item,
+ htmlBrowserActions,
maker,
onDownload,
onHtmlPanChange,
@@ -668,6 +693,7 @@ function FilePreviewPage({
exportToUrl(relPath: string, mtimeMs: number): Promise<string>;
prepareHtmlPreview: PrepareMobileHtmlPreview;
item: FileBrowserGridItem;
+ htmlBrowserActions: HtmlBrowserActions;
maker: Pick<MobileMakerTransport, 'fileBrowser'>;
onDownload(): void;
/** 上报本页是否处在 HTML 渲染态(外层 pager 据此让出横滑,仅文本页产出)。 */
@@ -711,6 +737,7 @@ function FilePreviewPage({
active={active}
prepareHtmlPreview={prepareHtmlPreview}
item={item}
+ htmlBrowserActions={htmlBrowserActions}
onDownload={onDownload}
onHtmlPanChange={onHtmlPanChange}
onQuoteSelection={onQuoteSelection}
@@ -874,6 +901,7 @@ function TextPreviewPage({
active,
prepareHtmlPreview,
item,
+ htmlBrowserActions,
onDownload,
onHtmlPanChange,
onQuoteSelection,
@@ -889,6 +917,7 @@ function TextPreviewPage({
/** 下载完整目录并返回受控网页预览,签名地址不进入页面。 */
prepareHtmlPreview: PrepareMobileHtmlPreview;
item: FileBrowserGridItem;
+ htmlBrowserActions: HtmlBrowserActions;
onDownload(): void;
/** 上报本页是否处在 HTML 渲染态(外层 pager 据此让出横滑,见调用处说明)。 */
onHtmlPanChange?: (key: string, wants: boolean) => void;
@@ -905,6 +934,16 @@ function TextPreviewPage({
const { colors } = useTheme();
const { t } = useTranslation();
const richKind = richTextKindOf(item.relPath);
+ const insets = useSafeAreaInsets();
+ // Sit directly against the safe-area edges; only a small gap separates page content.
+ const browserTop = insets.top;
+ const browserBottom = insets.bottom;
+ const browserContentInset = { top: browserTop + HTML_BROWSER_CONTROL_SIZE + spacing.xs, bottom: browserBottom + HTML_BROWSER_CONTROL_SIZE + spacing.xs };
+ const browserRef = useRef<WebView>(null);
+ const [website, setWebsite] = useState<WebsiteVisit | null>(null);
+ const [browserNavigation, setBrowserNavigation] = useState<{
+ preview: MobileHtmlPreview; state: WebViewNavigation;
+ } | null>(null);
// absPath 单文件模式(item.relPath 为绝对路径)没有可靠 mtime(恒 0),
// 缓存键无法随文件覆写失效,读写一律跳过缓存。
const cacheable = !!workdir && !isAbsolutePathShape(item.relPath);
@@ -926,6 +965,7 @@ function TextPreviewPage({
// 可切源码;其余文本恒为源码态。
const [richView, setRichView] = useState<'rendered' | 'source'>(richKind ? 'rendered' : 'source');
const loadedRef = useRef(state.status === 'ready');
+ const [textReloadEpoch, setTextReloadEpoch] = useState(0);
const codeListRef = useRef<FlatList<string>>(null);
const scrolledToTargetRef = useRef(false);
@@ -974,11 +1014,11 @@ function TextPreviewPage({
return () => {
cancelled = true;
};
- }, [active, cacheable, cacheScope, item.relPath, richKind, readTextFile, t, workdir]);
+ }, [active, cacheable, cacheScope, item.relPath, richKind, readTextFile, t, workdir, textReloadEpoch]);
const htmlSnapshot = useHtmlSnapshot(
absolutePathOf(item.relPath),
- visible && richKind === 'html' && richView === 'rendered',
+ visible && richKind === 'html' && richView === 'rendered' && !website,
prepareHtmlPreview,
);
const [htmlLoadError, setHtmlLoadError] = useState(false);
@@ -993,12 +1033,19 @@ function TextPreviewPage({
? t('files.preview.htmlSnapshotTooLarge')
: t('files.preview.htmlSnapshotFailed');
const htmlPanWanted = visible && richKind === 'html' && richView === 'rendered'
- && htmlSnapshot.foreground && !!htmlSnapshot.preview && !htmlError;
+ && htmlSnapshot.foreground && (!!website || (!!htmlSnapshot.preview && !htmlError));
useEffect(() => {
onHtmlPanChange?.(item.key, htmlPanWanted);
return () => onHtmlPanChange?.(item.key, false);
}, [htmlPanWanted, item.key, onHtmlPanChange]);
+ if (website) return visible ? <HtmlWebsiteBrowser
+ visit={website}
+ insets={{ ...browserContentInset, left: insets.left, right: insets.right }}
+ chrome={{ top: browserTop, bottom: browserBottom, left: insets.left + spacing.md, right: insets.right + spacing.md, onClose: htmlBrowserActions.onClose }}
+ onReturn={() => { setBrowserNavigation(null); setWebsite(null); }}
+ /> : <View style={styles.textPage} />;
+
if (state.status === 'loading' && richKind !== 'html') {
return (
<View style={styles.centerFill}>
@@ -1016,8 +1063,14 @@ function TextPreviewPage({
const clipped = ready && (ready.truncated || ready.totalLines > ready.lines.length) && !(richKind === 'html' && richView === 'rendered');
const canRenderRich = richKind === 'html' || (richKind !== null && typeof ready?.content === 'string');
const showRendered = canRenderRich && richView === 'rendered';
+ // State belongs to the mounted snapshot, never to a previous file/source/foreground lifetime.
+ const navigation = htmlPanWanted && browserNavigation && browserNavigation.preview === htmlSnapshot.preview ? browserNavigation.state : null;
return (
<View style={styles.textPage}>
+ <View style={[styles.textPage, richKind === 'html' && richView === 'source' && {
+ paddingTop: browserContentInset.top, paddingBottom: browserContentInset.bottom,
+ paddingLeft: insets.left, paddingRight: insets.right,
+ }]}>
{clipped ? (
<View style={styles.truncBar} testID="filePreview.truncBanner">
<Info color={colors.textSecondary} size={iconSize.sm} strokeWidth={iconStroke.regular} />
@@ -1026,9 +1079,8 @@ function TextPreviewPage({
</Text>
</View>
) : null}
- {/* 切换胶囊的 `md*` 样式与 i18n key 是 markdown 独占时期留下的命名,现在两类
- 渲染态共用;文案本身("渲染 / 源码")与载体无关,不为改名动四份 locale。 */}
- {canRenderRich ? (
+ {/* HTML 的模式切换在浮动浏览器菜单中;Markdown 保留原有胶囊。 */}
+ {canRenderRich && richKind !== 'html' ? (
<View style={styles.mdToggleRow}>
{([['rendered', t('files.preview.mdRendered')], ['source', t('files.preview.mdSource')]] as const).map(([value, label]) => (
<Pressable
@@ -1066,7 +1118,11 @@ function TextPreviewPage({
</View>
) : (
// 只有完整下载并加固过的目录快照才能进入 WebView。
- <HtmlSnapshotReader preview={htmlSnapshot.preview} onError={() => setHtmlLoadError(true)} />
+ <HtmlSnapshotReader preview={htmlSnapshot.preview} onError={() => setHtmlLoadError(true)}
+ webViewRef={browserRef}
+ viewportInsets={{ ...browserContentInset, left: insets.left, right: insets.right }}
+ onNavigationStateChange={(preview, state) => setBrowserNavigation({ preview, state })}
+ />
)
) : (
<MarkdownFileReader markdown={ready?.content ?? ''} onQuoteSelection={onQuoteSelection} targetLine={targetLine} testID="filePreview.markdownRendered" />
@@ -1107,6 +1163,43 @@ function TextPreviewPage({
style={styles.codeList}
/>
)}
+ </View>
+ {richKind === 'html' && visible ? (
+ <HtmlBrowserChrome
+ {...htmlBrowserActions}
+ title={item.name}
+ path={absolutePathOf(item.relPath)}
+ address={absolutePathOf(item.relPath)}
+ onNavigate={(input) => {
+ if (input.trim() === absolutePathOf(item.relPath)) return true;
+ const url = normalizeBrowserAddress(input);
+ if (!url) { Alert.alert(t('files.preview.browserInvalidAddress')); return false; }
+ // Start closing before disabling the snapshot hook; wait for this exact promise.
+ const snapshotClosed = htmlSnapshot.preview?.close() ?? Promise.resolve();
+ setRichView('rendered');
+ setWebsite({ url, snapshotClosed });
+ return true;
+ }}
+ top={browserTop}
+ bottom={browserBottom}
+ left={insets.left + spacing.md}
+ right={insets.right + spacing.md}
+ source={richView === 'source'}
+ loading={richView === 'rendered' && !htmlError && (!htmlSnapshot.preview || navigation?.loading === true)}
+ canGoBack={richView === 'source' || navigation?.canGoBack === true}
+ canGoForward={navigation?.canGoForward === true}
+ onBack={() => { if (richView === 'source') setRichView('rendered'); else if (navigation?.canGoBack) browserRef.current?.goBack(); }}
+ onForward={() => { if (navigation?.canGoForward) browserRef.current?.goForward(); }}
+ onReload={() => {
+ // Reload means fresh remote bytes in both views, not a reload of the cached local URL.
+ loadedRef.current = false;
+ setState({ status: 'loading' });
+ setTextReloadEpoch((value) => value + 1);
+ htmlSnapshot.retry();
+ }}
+ onToggleSource={() => setRichView((value) => value === 'rendered' ? 'source' : 'rendered')}
+ />
+ ) : null}
</View>
);
}
diff --git a/apps/mobile/docs/html-browser-viewport.md b/apps/mobile/docs/html-browser-viewport.md
new file mode 100644
index 0000000000..64170f8071
--- /dev/null
+++ b/apps/mobile/docs/html-browser-viewport.md
@@ -0,0 +1,94 @@
+# HTML browser viewport
+
+On iOS 26+, local HTML and websites keep a full-size WebView under floating
+browser controls. The host sets WebKit's public `obscuredContentInsets`, which
+adjusts the layout viewport and fixed/sticky positioning without shrinking the
+native view. Matching scroll-view `contentInset` values let ordinary document
+content scroll clear of both toolbars at the start and end. The obscured prop
+alone does not supply this scroll range. No page styles or browser APIs are overridden. The keyboard is
+handled by WebKit; it is not added to the browser-chrome prop a second time.
+
+Android and older iOS retain a bounded WebView fallback. Optional advisory
+geometry remains available without a page-to-native message handler.
+
+## CSS and JavaScript
+
+All lengths are **CSS pixels**, including when the page is zoomed or has no viewport meta tag.
+
+| CSS custom property | Meaning |
+| --- | --- |
+| `--cindy-viewport-width`, `--cindy-viewport-height` | Measured WebView frame |
+| `--cindy-controls-top/right/bottom/left` | Conservative strips occupied by browser controls and device safe areas within that frame |
+| `--cindy-inset-top/right/bottom/left` | Same strips, with keyboard obstruction included |
+| `--cindy-available-width`, `--cindy-available-height` | Frame minus the obstruction strips, clamped to zero |
+| `--cindy-available-top`, `--cindy-available-left` | Available rectangle origin in **document** coordinates, including native scrolling |
+
+`window.cindyViewport` is a read-only, frozen snapshot:
+
+```js
+// Every field except version is a CSS length.
+{ version: 1, width, height, controls: { top, right, bottom, left },
+ insets: { top, right, bottom, left }, availableTop, availableLeft,
+ availableWidth, availableHeight }
+```
+
+Read it if present, then listen for `window`'s `cindyviewportchange` event;
+`event.detail` contains the next snapshot. Geometry can arrive after page scripts
+start. Updates follow native layout, scrolling, rotation, keyboard frame/show/hide and page
+zoom changes. Each navigated document receives its own installation. Event handlers
+must be idempotent; delivery can repeat the same geometry after navigation/load.
+
+## Full-height application example
+
+```html
+<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
+<style>
+ html, body { margin: 0; height: 100%; overflow: hidden; }
+ .app { position: absolute;
+ top: var(--cindy-available-top, 0px);
+ left: var(--cindy-available-left, 0px);
+ height: var(--cindy-available-height, 100dvh);
+ width: var(--cindy-available-width, 100%);
+ display: flex; flex-direction: column; }
+ .app > main { flex: 1; min-height: 0; overflow: auto; }
+ .app > header, .app > footer { flex: none; }
+</style>
+<div class="app"><header>Title</header><main>Content</main><footer>Actions</footer></div>
+```
+
+On iOS 26+, the published width/height describe the full native WebView frame.
+Controls describe the toolbar/safe-area strips, and insets describe their union
+with keyboard occlusion. Available dimensions exclude those strips. These custom
+values are advisory; ordinary fixed footers rely on WebKit's native layout.
+`obscuredContentInsets` and CSS `env(safe-area-inset-*)` are distinct APIs; do not
+assume the latter equals the toolbar height or add toolbar padding twice.
+
+In the older-platform fallback, strips are excluded by native layout, so published
+controls/insets are zero and available dimensions equal the smaller WebView frame.
+The full-height example uses document coordinates, not fixed-position offsets.
+An overlapping floating keyboard conservatively reserves the strip below its top
+edge in the advisory geometry. Transient menus and share sheets are not included.
+Page-local properties are not a security boundary.
+
+## Native build requirement
+
+The WebView dependency patch adds the prop to Fabric, Paper and TypeScript with
+an iOS 26 SDK/runtime guard and zero default. Existing selection-menu changes are
+preserved. This changes the native fingerprint: ship a new binary; an OTA update
+cannot add this native capability to an old binary. Release/merge still requires
+the repository's explicit cold-update review.
+
+## Address editing
+
+Tapping the address capsule edits the address in place. Submitting a bare domain
+uses HTTPS; explicit HTTP and HTTPS addresses are supported. Invalid input keeps
+the editor open. The file preview displays its local path, never its private
+snapshot bootstrap URL; leaving that path unchanged dismisses editing. The field
+does not navigate to other local filesystem paths.
+
+Opening a website waits for the file snapshot server to close, then mounts a
+separate incognito WebView without file access or a page-to-native message handler.
+The website receives the same advisory viewport geometry. Native website history
+stays available while the app is inactive. The menu offers Return to file and Copy
+address; returning to the file starts a fresh snapshot. Copy and share use the
+website's current URL, including redirects.
diff --git a/apps/mobile/src/__tests__/browserAddress.test.ts b/apps/mobile/src/__tests__/browserAddress.test.ts
new file mode 100644
index 0000000000..822bebaa3c
--- /dev/null
+++ b/apps/mobile/src/__tests__/browserAddress.test.ts
@@ -0,0 +1,22 @@
+import { expect, it } from 'vitest';
+import { allowWebsiteNavigation, normalizeBrowserAddress } from '@/session/browserAddress';
+import { interceptSnapshotNavigation } from '@/session/htmlNavigationPolicy';
+
+it.each([
+ [' example.com/path?q=1#part ', 'https://example.com/path?q=1#part'],
+ ['http://localhost:8080/', 'http://localhost:8080/'],
+ ['example.com:8443/test', 'https://example.com:8443/test'],
+ ['https://example.com/中文', 'https://example.com/%E4%B8%AD%E6%96%87'],
+])('normalizes native address submission %s', (input, expected) => {
+ expect(normalizeBrowserAddress(input)).toBe(expected);
+});
+it.each(['javascript:alert(1)', 'data:text/html,hello', 'file:///tmp/a', 'tel:123', 'about:blank', 'https://user:[email protected]', 'hello world', '', '/Users/dash/file.html', 'https:\\example.com'])('rejects non-web or ambiguous input %s', input => {
+ expect(normalizeBrowserAddress(input)).toBeNull();
+ expect(allowWebsiteNavigation(input)).toBe(false);
+});
+it('does not relax the file snapshot navigation gate when native address entry accepts a site', () => {
+ const url = normalizeBrowserAddress('example.com')!;
+ expect(allowWebsiteNavigation(url)).toBe(true);
+ expect(interceptSnapshotNavigation(url, 'http://127.0.0.1:9000/__cindy/private', ['/index.html'], true)).toBe(false);
+ expect(allowWebsiteNavigation('example.com')).toBe(false);
+});
diff --git a/apps/mobile/src/__tests__/filePreviewPagerWiring.test.ts b/apps/mobile/src/__tests__/filePreviewPagerWiring.test.ts
index 6fb1588c04..7a7dcbf3b6 100644
--- a/apps/mobile/src/__tests__/filePreviewPagerWiring.test.ts
+++ b/apps/mobile/src/__tests__/filePreviewPagerWiring.test.ts
@@ -43,7 +43,8 @@ describe('remote file preview pager wiring', () => {
// 只有真的挂着 WebView 的那种组合才要横滑(资源还在取 → 页面是 spinner → 不禁滑);
// cleanup 必须无条件归还。
expect(source).toContain("visible && richKind === 'html' && richView === 'rendered'");
- expect(source).toContain("htmlSnapshot.foreground && !!htmlSnapshot.preview && !htmlError");
+ expect(source).toContain("htmlSnapshot.foreground && (!!website || (!!htmlSnapshot.preview && !htmlError))");
+ expect(source).toContain("visible && richKind === 'html' && richView === 'rendered' && !website");
expect(source).toContain('return () => onHtmlPanChange?.(item.key, false)');
});
diff --git a/apps/mobile/src/__tests__/fileWebViewTermination.test.tsx b/apps/mobile/src/__tests__/fileWebViewTermination.test.tsx
index e18db10762..cbeacbd37d 100644
--- a/apps/mobile/src/__tests__/fileWebViewTermination.test.tsx
+++ b/apps/mobile/src/__tests__/fileWebViewTermination.test.tsx
@@ -1,5 +1,6 @@
// @vitest-environment jsdom
-import { act, createElement } from 'react';
+import { act, createElement, createRef } from 'react';
+import type { WebView } from 'react-native-webview';
import { createRoot, type Root } from 'react-dom/client';
import { afterEach, expect, it, vi } from 'vitest';
import { PeerFileTransport } from '@/device-link/peerFileTransport';
@@ -11,17 +12,22 @@ const state = vi.hoisted(() => ({
mounts: 0,
unregister: vi.fn(),
install: vi.fn(),
+ goBack: vi.fn(),
+ goForward: vi.fn(),
+ inject: vi.fn(),
}));
vi.mock('react-native', () => ({
+ Platform: { OS: 'ios' },
View: ({ children }: { children: unknown }) => children,
StyleSheet: { create: (value: unknown) => value },
AppState: { currentState: 'active', addEventListener: () => ({ remove() {} }) },
}));
+vi.mock('@/session/useHtmlBrowserViewport', () => ({ useHtmlBrowserViewport: (insets: unknown) => ({ viewRef: { current: null }, measure() {}, script: '/* geometry only */ true;', obscuredContentInsets: insets }) }));
vi.mock('react-native-webview', async () => {
const { forwardRef, useEffect, useImperativeHandle } = await import('react');
return { WebView: forwardRef((props: Record<string, (...args: any[]) => void>, ref) => {
state.props = props;
- useImperativeHandle(ref, () => ({ injectJavaScript() {} }));
+ useImperativeHandle(ref, () => ({ injectJavaScript: state.inject, goBack: state.goBack, goForward: state.goForward }));
useEffect(() => { state.mounts++; }, []);
return null;
}) };
@@ -40,6 +46,28 @@ let root: Root | undefined;
afterEach(() => {
act(() => root?.unmount()); root = undefined;
state.mounts = 0; state.install.mockClear(); state.unregister.mockClear();
+ state.goBack.mockClear(); state.goForward.mockClear();
+ state.inject.mockClear();
+});
+
+it('installs geometry on each document and ignores scroll/load events from a disposed reader', () => {
+ root = createRoot(document.createElement('div'));
+ const preview: MobileHtmlPreview = { url: 'http://127.0.0.1:1234/token/', documents: ['/index.html'], close: async () => {} };
+ act(() => root!.render(createElement(HtmlSnapshotReader, { preview, onError() {} })));
+ expect(state.props.onMessage).toBeUndefined();
+ const old = state.props;
+ state.inject.mockClear();
+ act(() => old.onLoadEnd());
+ expect(state.inject).toHaveBeenLastCalledWith('/* geometry only */ true;');
+ act(() => old.onScroll({ nativeEvent: { contentOffset: { x: 0, y: -122 } } }));
+ expect(state.inject.mock.lastCall?.[0]).toContain('"y":-122');
+ act(() => root!.unmount()); root = undefined;
+ state.inject.mockClear();
+ act(() => {
+ old.onLoadEnd();
+ old.onScroll({ nativeEvent: { contentOffset: { x: 0, y: 250 } } });
+ });
+ expect(state.inject).not.toHaveBeenCalled();
});
it.each(['onContentProcessDidTerminate', 'onRenderProcessGone'])('recreates peer transport after %s and ignores the old renderer', (event) => {
@@ -83,3 +111,46 @@ it.each([false, true])('routes entry HTTP errors to retry without failing on sib
act(() => state.props.onHttpError({ nativeEvent: { url: 'http://127.0.0.1:1234/report%20one.html', statusCode: 502 } }));
expect(onError).toHaveBeenCalledOnce();
});
+
+it('exposes only the current WebView history and detaches controls when the reader leaves', () => {
+ root = createRoot(document.createElement('div'));
+ const webViewRef = createRef<WebView>();
+ const onNavigationStateChange = vi.fn();
+ const preview: MobileHtmlPreview = { url: 'http://127.0.0.1:1234/token/', documents: ['/index.html'], close: async () => {} };
+ act(() => root!.render(createElement(HtmlSnapshotReader, { preview, onError() {}, webViewRef, onNavigationStateChange })));
+ const old = state.props;
+ const navigation = { url: 'http://127.0.0.1:1234/index.html#details', canGoBack: true, canGoForward: false, loading: false };
+ act(() => state.props.onNavigationStateChange(navigation));
+ expect(onNavigationStateChange).toHaveBeenLastCalledWith(preview, navigation);
+ webViewRef.current?.goBack();
+ webViewRef.current?.goForward();
+ expect(state.goBack).toHaveBeenCalledOnce();
+ expect(state.goForward).toHaveBeenCalledOnce();
+ act(() => root!.unmount()); root = undefined;
+ expect(webViewRef.current).toBeNull();
+ act(() => old.onNavigationStateChange(navigation));
+ expect(onNavigationStateChange).toHaveBeenCalledOnce();
+});
+
+it('starts a new native history for a refreshed snapshot and ignores navigation from the old snapshot', () => {
+ root = createRoot(document.createElement('div'));
+ const webViewRef = createRef<WebView>();
+ const onNavigationStateChange = vi.fn();
+ const initial: MobileHtmlPreview = { url: 'http://127.0.0.1:1234/first/', documents: ['/index.html'], close: async () => {} };
+ const refreshed = { ...initial, url: 'http://127.0.0.1:4567/second/' };
+ const props = { onError() {}, webViewRef, onNavigationStateChange, viewportInsets: { top: 80, bottom: 64 } };
+ act(() => root!.render(createElement(HtmlSnapshotReader, { ...props, preview: initial })));
+ const old = state.props;
+ const firstView = webViewRef.current;
+ act(() => root!.render(createElement(HtmlSnapshotReader, { ...props, preview: refreshed })));
+ expect(state.mounts).toBe(2);
+ expect(webViewRef.current).not.toBe(firstView);
+ act(() => old.onNavigationStateChange({ canGoBack: true }));
+ expect(onNavigationStateChange).not.toHaveBeenCalled();
+ const navigation = { canGoBack: false, canGoForward: false, loading: false };
+ act(() => state.props.onNavigationStateChange(navigation));
+ expect(onNavigationStateChange).toHaveBeenLastCalledWith(refreshed, navigation);
+ expect(state.props.contentInset).toEqual({ top: 80, bottom: 64, left: 0, right: 0 });
+ expect(state.props.contentInset).toEqual(state.props.obscuredContentInsets);
+ expect(state.props.automaticallyAdjustContentInsets).toBe(false);
+});
diff --git a/apps/mobile/src/__tests__/htmlBrowserViewport.test.ts b/apps/mobile/src/__tests__/htmlBrowserViewport.test.ts
new file mode 100644
index 0000000000..17e7ee075e
--- /dev/null
+++ b/apps/mobile/src/__tests__/htmlBrowserViewport.test.ts
@@ -0,0 +1,101 @@
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { browserViewport, browserViewportScript, browserViewportScrollScript } from '@/session/htmlBrowserViewport';
+
+const portrait = { x: 0, y: 0, width: 402, height: 874 };
+const controls = { top: 122, right: 0, bottom: 94, left: 0 };
+const geometry = () => browserViewport(portrait, controls, null);
+const run = (value = geometry()) => new Function(browserViewportScript(value))();
+afterEach(() => {
+ (window as any)[Symbol.for('cindy.browserViewport.cleanup')]?.();
+ delete (window as any).cindyViewport;
+ delete (window as any)[Symbol.for('cindy.browserViewport.offset')];
+ vi.unstubAllGlobals();
+});
+
+describe('WebView geometry', () => {
+ it('reserves controls and safe area without changing CSS viewport units', () => {
+ expect(geometry()).toEqual({ width: 402, height: 874, controls, insets: controls, availableWidth: 402, availableHeight: 658 });
+ });
+ it('takes the union of keyboard and controls, rather than adding both heights', () => {
+ const result = browserViewport(portrait, controls, { x: 0, y: 505, width: 402, height: 369 });
+ expect(result.availableHeight).toBe(383);
+ expect(result.insets.bottom).toBe(369);
+ expect(result.controls.bottom).toBe(94);
+ });
+ it('updates landscape and horizontal safe areas', () => {
+ expect(browserViewport({ x: 0, y: 0, width: 874, height: 402 }, { top: 60, bottom: 80, left: 62, right: 62 }, null))
+ .toMatchObject({ availableWidth: 750, availableHeight: 262 });
+ });
+ it('measures a smaller reader in window coordinates without deducting Android resize twice', () => {
+ expect(browserViewport({ x: 20, y: 122, width: 360, height: 383 }, { top: 0, bottom: 0, left: 0, right: 0 },
+ { x: 0, y: 505, width: 402, height: 369 }).availableHeight).toBe(383);
+ });
+ it('ignores keyboards outside the reader and conservatively handles overlapping floating keyboards', () => {
+ expect(browserViewport(portrait, controls, { x: 500, y: 300, width: 200, height: 200 }).availableHeight).toBe(658);
+ expect(browserViewport(portrait, controls, { x: 200, y: 300, width: 200, height: 200 }).availableHeight).toBe(178);
+ });
+ it('clamps fully occluded and transient tiny frames to zero', () => {
+ expect(browserViewport({ ...portrait, height: 70 }, controls, null).availableHeight).toBe(0);
+ });
+});
+
+describe('page-local viewport contract', () => {
+ it('starts a directly loaded landscape document at its existing native left inset', () => {
+ run(browserViewport({ x: 0, y: 0, width: 874, height: 402 }, { top: 60, bottom: 80, left: 62, right: 62 }, null));
+ expect((window as any).cindyViewport).toMatchObject({ availableTop: 0, availableLeft: 0, availableWidth: 750 });
+ });
+ it('converts native scroll offsets to a document origin without doubling the initial inset', () => {
+ run();
+ expect((window as any).cindyViewport.availableTop).toBe(0);
+ new Function(browserViewportScrollScript(0, -60))();
+ // Rotation back to portrait can retain the old landscape offset of -60.
+ run();
+ expect((window as any).cindyViewport.availableTop).toBe(62);
+ new Function(browserViewportScrollScript(10, 250))();
+ run();
+ expect((window as any).cindyViewport).toMatchObject({ availableTop: 372, availableLeft: 10 });
+ expect(browserViewportScrollScript(NaN, Infinity)).toBe('true;');
+ });
+ it('publishes frozen geometry and CSS lengths without creating an inbound bridge', () => {
+ const listener = vi.fn();
+ window.addEventListener('cindyviewportchange', listener, { once: true });
+ run();
+ expect(document.documentElement.style.getPropertyValue('--cindy-available-height')).toBe('658px');
+ const value = (window as any).cindyViewport;
+ expect(Object.isFrozen(value)).toBe(true);
+ expect(Object.isFrozen(value.insets)).toBe(true);
+ expect(Object.getOwnPropertyDescriptor(window, 'cindyViewport')?.set).toBeUndefined();
+ expect(listener).toHaveBeenCalledOnce();
+ expect(browserViewportScript(geometry())).not.toMatch(/postMessage|ReactNativeWebView/);
+ });
+ it('converts native points to CSS px for zoomed or viewport-less pages', () => {
+ vi.stubGlobal('visualViewport', Object.assign(new EventTarget(), { scale: 0.5 }));
+ run();
+ expect((window as any).cindyViewport.availableHeight).toBe(1316);
+ expect(document.documentElement.style.getPropertyValue('--cindy-inset-top')).toBe('244px');
+ });
+ it('replaces listeners on native updates and reads current zoom when the page resizes', () => {
+ const viewport = Object.assign(new EventTarget(), { scale: 1 });
+ vi.stubGlobal('visualViewport', viewport);
+ let callback: FrameRequestCallback | undefined;
+ vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => { callback = cb; return 1; });
+ run();
+ run(browserViewport(portrait, controls, { x: 0, y: 505, width: 402, height: 369 }));
+ const changed = vi.fn();
+ window.addEventListener('cindyviewportchange', changed);
+ viewport.scale = 2;
+ viewport.dispatchEvent(new Event('resize'));
+ callback!(0);
+ expect((window as any).cindyViewport.availableHeight).toBe(191.5);
+ expect(changed).toHaveBeenCalledOnce();
+ window.removeEventListener('cindyviewportchange', changed);
+ });
+ it('works on the next document and never forces body padding or height', () => {
+ run();
+ expect(document.body.style.cssText).toBe('');
+ delete (window as any).cindyViewport;
+ run();
+ expect((window as any).cindyViewport.version).toBe(1);
+ });
+});
diff --git a/apps/mobile/src/__tests__/htmlWebsiteBrowser.test.tsx b/apps/mobile/src/__tests__/htmlWebsiteBrowser.test.tsx
new file mode 100644
index 0000000000..b1161e20e7
--- /dev/null
+++ b/apps/mobile/src/__tests__/htmlWebsiteBrowser.test.tsx
@@ -0,0 +1,88 @@
+// @vitest-environment jsdom
+import { act, createElement } from 'react';
+import { createRoot, type Root } from 'react-dom/client';
+import { afterEach, expect, it, vi } from 'vitest';
+import { HtmlWebsiteBrowser } from '@/session/HtmlWebsiteBrowser';
+
+const state = vi.hoisted(() => ({ chrome: {} as any, web: null as any, inject: vi.fn(), back: vi.fn(), reload: vi.fn(), alert: vi.fn() }));
+vi.mock('react-native', () => ({
+ View: ({ children }: any) => children, ActivityIndicator: () => null,
+ Platform: { OS: 'ios' }, Alert: { alert: state.alert }, Share: { share: vi.fn(async () => {}) },
+ StyleSheet: { create: (value: unknown) => value, absoluteFill: {} },
+}));
+vi.mock('react-native-webview', async () => {
+ const { forwardRef, useImperativeHandle } = await import('react');
+ return { WebView: forwardRef((props: any, ref) => {
+ state.web = props;
+ useImperativeHandle(ref, () => ({ injectJavaScript: state.inject, goBack: state.back, reload: state.reload }));
+ return null;
+ }) };
+});
+vi.mock('expo-clipboard', () => ({ setStringAsync: vi.fn(async () => {}) }));
+vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (s: string) => s }) }));
+vi.mock('@/theme', () => ({ useTheme: () => ({ colors: {} }) }));
+vi.mock('@/components/AppText', () => ({ Text: () => null }));
+vi.mock('@/session/HtmlBrowserChrome', () => ({ HtmlBrowserChrome: (props: any) => { state.chrome = props; return null; } }));
+vi.mock('@/session/useHtmlBrowserViewport', () => ({ useHtmlBrowserViewport: (insets: unknown) => ({ viewRef: { current: null }, measure() {}, script: 'true;', obscuredContentInsets: insets }) }));
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
+let root: Root | undefined;
+const onReturn = vi.fn();
+function mount(snapshotClosed: Promise<void>) {
+ root = createRoot(document.createElement('div'));
+ act(() => root!.render(createElement(HtmlWebsiteBrowser, {
+ visit: { url: 'https://example.com/', snapshotClosed }, insets: { top: 110, bottom: 82, left: 0, right: 0 },
+ chrome: { top: 62, bottom: 34, left: 12, right: 12, onClose() {} }, onReturn,
+ })));
+}
+afterEach(() => { act(() => root?.unmount()); root = undefined; state.web = null; vi.clearAllMocks(); });
+it('waits for the file server to close before mounting a separate capability-free WebView', async () => {
+ let close: () => void = () => {};
+ mount(new Promise<void>(resolve => { close = resolve; }));
+ expect(state.web).toBeNull();
+ await act(async () => close());
+ expect(state.web.source).toEqual({ uri: 'https://example.com/' });
+ expect(state.web).toMatchObject({ incognito: true, allowFileAccess: false, setSupportMultipleWindows: false, mediaCapturePermissionGrantType: 'deny' });
+ expect(state.web.onMessage).toBeUndefined();
+ expect(state.web.contentInset).toEqual({ top: 110, bottom: 82, left: 0, right: 0 });
+ expect(state.web.contentInset).toEqual(state.web.obscuredContentInsets);
+ expect(state.web.onShouldStartLoadWithRequest({ url: 'tel:123' })).toBe(false);
+});
+it('edits the current website and preserves native back/reload semantics', async () => {
+ mount(Promise.resolve()); await act(async () => {});
+ act(() => state.web.onNavigationStateChange({ url: 'https://example.com/next', canGoBack: true, loading: false }));
+ expect(state.chrome.address).toBe('https://example.com/next');
+ expect(state.chrome.website).toBe(true);
+ state.chrome.onBack(); expect(state.back).toHaveBeenCalledOnce();
+ state.chrome.onReload(); expect(state.reload).toHaveBeenCalledOnce();
+ expect(state.chrome.onNavigate('javascript:alert(1)')).toBe(false);
+ state.inject.mockClear();
+ act(() => { expect(state.chrome.onNavigate('example.org')).toBe(true); });
+ expect(state.web.source).toEqual({ uri: 'https://example.org/' });
+ expect(state.inject).not.toHaveBeenCalled();
+ act(() => state.web.onNavigationStateChange({ url: 'https://example.com/next', loading: false }));
+ expect(state.chrome.address).toBe('https://example.org/');
+ state.chrome.onToggleSource(); expect(onReturn).toHaveBeenCalledOnce();
+});
+it('does not open a website after file closure fails', async () => {
+ mount(Promise.reject(new Error('stop failed'))); await act(async () => {});
+ expect(state.web).toBeNull();
+ expect(state.chrome.loading).toBe(false);
+ state.chrome.onBack(); expect(onReturn).toHaveBeenCalledOnce();
+});
+
+it('keeps an address entered while the file server is closing', async () => {
+ let close!: () => void;
+ mount(new Promise<void>(resolve => { close = resolve; }));
+ act(() => state.chrome.onNavigate('example.org/new'));
+ expect(state.web).toBeNull();
+ await act(async () => close());
+ expect(state.web.source.uri).toBe('https://example.org/new');
+});
+it('can navigate after the renderer terminates', async () => {
+ mount(Promise.resolve()); await act(async () => {});
+ act(() => state.web.onContentProcessDidTerminate());
+ expect(state.chrome.loading).toBe(false);
+ act(() => state.chrome.onNavigate('example.org/recover'));
+ expect(state.web.source.uri).toBe('https://example.org/recover');
+ expect(state.chrome.loading).toBe(true);
+});
diff --git a/apps/mobile/src/__tests__/i18nCatalogParity.test.ts b/apps/mobile/src/__tests__/i18nCatalogParity.test.ts
index e53250a17e..1b75d75f9b 100644
--- a/apps/mobile/src/__tests__/i18nCatalogParity.test.ts
+++ b/apps/mobile/src/__tests__/i18nCatalogParity.test.ts
@@ -6,6 +6,7 @@
*/
import { describe, expect, it } from "vitest";
+import { createInstance } from "i18next";
import enCommon from "@/i18n/locales/en";
import zhCNCommon from "@/i18n/locales/zh-CN";
@@ -53,6 +54,31 @@ describe("mobile i18n catalog parity", () => {
const flat = new Map(locales.map((locale) => [locale, flatCatalog(locale)]));
const enKeys = [...flat.get("en")!.keys()].sort();
+ it.each(locales)(
+ "%s resolves browser action labels at their UI paths",
+ async (locale) => {
+ const instance = createInstance();
+ await instance.init({
+ lng: locale,
+ fallbackLng: false,
+ resources: { [locale]: { translation: CATALOGS[locale] as object } },
+ });
+ for (const action of [
+ "browserBack",
+ "browserForward",
+ "browserMore",
+ "browserShowSource",
+ "browserShowPage",
+ "browserAddToTask",
+ "browserFileInfo",
+ ]) {
+ const key = `files.preview.${action}`;
+ expect(instance.exists(key), `${locale}:${key}`).toBe(true);
+ expect(instance.t(key)).not.toBe(key);
+ }
+ },
+ );
+
it.each(locales)("%s 与 en 的 key 全集一致", (locale) => {
expect([...flat.get(locale)!.keys()].sort()).toEqual(enKeys);
});
diff --git a/apps/mobile/src/__tests__/useHtmlBrowserViewport.test.tsx b/apps/mobile/src/__tests__/useHtmlBrowserViewport.test.tsx
new file mode 100644
index 0000000000..2b94fa0792
--- /dev/null
+++ b/apps/mobile/src/__tests__/useHtmlBrowserViewport.test.tsx
@@ -0,0 +1,119 @@
+// @vitest-environment jsdom
+import { act, createElement } from 'react';
+import { createRoot, type Root } from 'react-dom/client';
+import { afterEach, expect, it, vi } from 'vitest';
+import { useHtmlBrowserViewport } from '@/session/useHtmlBrowserViewport';
+
+const native = vi.hoisted(() => ({
+ platform: { OS: 'ios', Version: '25.0' },
+ frame: { x: 0, y: 0, width: 402, height: 874 },
+ listeners: new Map<string, (event: unknown) => void>(),
+ metrics: undefined as undefined | { screenX: number; screenY: number; width: number; height: number },
+ crossFade: vi.fn(async () => false),
+}));
+vi.mock('react-native', () => ({
+ View: {}, Platform: native.platform,
+ useWindowDimensions: () => native.frame,
+ AccessibilityInfo: { prefersCrossFadeTransitions: native.crossFade },
+ Keyboard: {
+ metrics: () => native.metrics,
+ addListener: (name: string, callback: (event: unknown) => void) => {
+ native.listeners.set(name, callback);
+ return { remove: () => native.listeners.delete(name) };
+ },
+ },
+}));
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
+let root: Root | undefined;
+let latest: ReturnType<typeof useHtmlBrowserViewport>;
+function Probe() {
+ latest = useHtmlBrowserViewport(native.frame.width === 402
+ ? { top: 122, bottom: 94, left: 0, right: 0 } : { top: 60, bottom: 80, left: 62, right: 62 });
+ latest.viewRef.current = { measureInWindow: (callback: (...values: number[]) => void) => {
+ const { x, y, width, height } = native.frame;
+ callback(x, y, width, height);
+ } } as any;
+ return null;
+}
+function mount() {
+ root = createRoot(document.createElement('div'));
+ act(() => root!.render(createElement(Probe)));
+}
+function value() {
+ new Function(latest.script!)();
+ return (window as any).cindyViewport;
+}
+function keyboard(name: string, top = 505) {
+ act(() => native.listeners.get(name)?.({ endCoordinates: { screenX: 0, screenY: top, width: 402, height: 874 - top } }));
+}
+afterEach(() => {
+ act(() => root?.unmount());
+ (window as any)[Symbol.for('cindy.browserViewport.cleanup')]?.();
+ root = undefined; native.metrics = undefined; native.platform.Version = '25.0';
+ native.frame = { x: 0, y: 0, width: 402, height: 874 };
+});
+it('remeasures rotation and updates on keyboard frame/show/hide without remounting', () => {
+ mount();
+ expect(value()).toMatchObject({ height: 658, availableHeight: 658,
+ controls: { top: 0, bottom: 0, left: 0, right: 0 }, insets: { top: 0, bottom: 0, left: 0, right: 0 } });
+ expect(latest.viewportStyle).toEqual({ paddingTop: 122, paddingBottom: 94, paddingLeft: 0, paddingRight: 0 });
+ keyboard('keyboardWillShow');
+ expect(value()).toMatchObject({ height: 383, availableHeight: 383 });
+ expect(latest.viewportStyle!.paddingBottom).toBe(369);
+ keyboard('keyboardWillChangeFrame', 450);
+ expect(value().availableHeight).toBe(328);
+ keyboard('keyboardDidHide');
+ expect(value().availableHeight).toBe(658);
+ native.frame = { x: 0, y: 0, width: 874, height: 402 };
+ act(() => root!.render(createElement(Probe)));
+ expect(value()).toMatchObject({ availableHeight: 262, availableWidth: 750 });
+});
+it('starts from an already open keyboard and removes every listener on unmount', () => {
+ native.metrics = { screenX: 0, screenY: 505, width: 402, height: 369 };
+ mount();
+ expect(value().availableHeight).toBe(383);
+ act(() => root!.unmount()); root = undefined;
+ expect(native.listeners.size).toBe(0);
+});
+it('ignores a late cross-fade result after keyboard hide', async () => {
+ let resolve: (value: boolean) => void = () => {};
+ native.crossFade.mockImplementationOnce(() => new Promise<boolean>(done => { resolve = done; }));
+ mount();
+ keyboard('keyboardWillShow', 0);
+ keyboard('keyboardWillHide');
+ await act(async () => resolve(false));
+ expect(value().availableHeight).toBe(658);
+});
+
+it('does not subtract keyboard overlap again after the host window resizes above it', () => {
+ native.frame = { x: 0, y: 0, width: 402, height: 505 };
+ native.metrics = { screenX: 0, screenY: 505, width: 402, height: 369 };
+ mount();
+ expect(latest.viewportStyle!.paddingBottom).toBe(94);
+ expect(value()).toMatchObject({ height: 289, availableHeight: 289 });
+});
+
+it('caps padding to the outer frame when a floating keyboard reaches above the toolbar', () => {
+ native.frame = { x: 0, y: 0, width: 874, height: 402 };
+ native.metrics = { screenX: 0, screenY: 30, width: 402, height: 300 };
+ mount();
+ expect(latest.viewportStyle!.paddingTop + latest.viewportStyle!.paddingBottom).toBe(402);
+ expect(value()).toMatchObject({ height: 0, availableHeight: 0 });
+});
+
+it('keeps iOS 26+ full-bleed and sends chrome separately from keyboard occlusion', () => {
+ native.platform.Version = '27.0';
+ mount();
+ expect(latest.viewportStyle).toBeUndefined();
+ expect(latest.obscuredContentInsets).toEqual({ top: 122, bottom: 94, left: 0, right: 0 });
+ expect(value()).toMatchObject({ height: 874, availableHeight: 658 });
+ keyboard('keyboardWillShow');
+ expect(latest.viewportStyle).toBeUndefined();
+ expect(latest.obscuredContentInsets?.bottom).toBe(94);
+ expect(value()).toMatchObject({ height: 874, availableHeight: 383 });
+ native.frame = { x: 0, y: 0, width: 874, height: 402 };
+ keyboard('keyboardDidHide');
+ act(() => root!.render(createElement(Probe)));
+ expect(latest.obscuredContentInsets).toEqual({ top: 60, bottom: 80, left: 62, right: 62 });
+ expect(value()).toMatchObject({ height: 402, availableHeight: 262 });
+});
diff --git a/apps/mobile/src/i18n/locales/en/files.json b/apps/mobile/src/i18n/locales/en/files.json
index 2169a78b2e..326e5eb56c 100644
--- a/apps/mobile/src/i18n/locales/en/files.json
+++ b/apps/mobile/src/i18n/locales/en/files.json
@@ -80,6 +80,13 @@
}
},
"preview": {
+ "browserBack": "Back",
+ "browserForward": "Forward",
+ "browserMore": "More actions",
+ "browserShowSource": "View source",
+ "browserShowPage": "Back to webpage",
+ "browserAddToTask": "Add to current task",
+ "browserFileInfo": "File information",
"done": "Done",
"a11yShare": "Export and share",
"copyPath": "Copy Path",
@@ -119,7 +126,13 @@
"originalFailedThumb": "Couldn't fetch the original; showing the thumbnail",
"fetchingOriginalHint": "Thumbnail · fetching the original…",
"a11yExportShareFile": "Export and share the original file",
- "exportShare": "Export / Share"
+ "exportShare": "Export / Share",
+ "browserAddress": "Address",
+ "browserCancelAddress": "Cancel editing",
+ "browserReturnToFile": "Return to file",
+ "browserCopyAddress": "Copy address",
+ "browserInvalidAddress": "Enter a valid http or https address.",
+ "browserWebsiteFailed": "Unable to open this webpage. Try reloading."
},
"export": {
"exportFailed": "Export failed",
diff --git a/apps/mobile/src/i18n/locales/ja/files.json b/apps/mobile/src/i18n/locales/ja/files.json
index 36a7d4f107..c7946e6beb 100644
--- a/apps/mobile/src/i18n/locales/ja/files.json
+++ b/apps/mobile/src/i18n/locales/ja/files.json
@@ -80,6 +80,13 @@
}
},
"preview": {
+ "browserBack": "戻る",
+ "browserForward": "進む",
+ "browserMore": "その他の操作",
+ "browserShowSource": "ソースを表示",
+ "browserShowPage": "ウェブページに戻る",
+ "browserAddToTask": "現在のタスクに追加",
+ "browserFileInfo": "ファイル情報",
"done": "完了",
"a11yShare": "書き出して共有",
"copyPath": "パスをコピー",
@@ -119,7 +126,13 @@
"originalFailedThumb": "オリジナルの取得に失敗しました。現在はサムネイルです",
"fetchingOriginalHint": "サムネイル · オリジナルを取得中…",
"a11yExportShareFile": "オリジナルファイルを書き出して共有",
- "exportShare": "書き出し / 共有"
+ "exportShare": "書き出し / 共有",
+ "browserAddress": "アドレス",
+ "browserCancelAddress": "編集をキャンセル",
+ "browserReturnToFile": "ファイルに戻る",
+ "browserCopyAddress": "アドレスをコピー",
+ "browserInvalidAddress": "有効な http または https アドレスを入力してください。",
+ "browserWebsiteFailed": "ウェブページを開けません。再読み込みしてください。"
},
"export": {
"exportFailed": "書き出しに失敗しました",
diff --git a/apps/mobile/src/i18n/locales/ko/files.json b/apps/mobile/src/i18n/locales/ko/files.json
index f304e38da5..3891cf9c76 100644
--- a/apps/mobile/src/i18n/locales/ko/files.json
+++ b/apps/mobile/src/i18n/locales/ko/files.json
@@ -80,6 +80,13 @@
}
},
"preview": {
+ "browserBack": "뒤로",
+ "browserForward": "앞으로",
+ "browserMore": "추가 작업",
+ "browserShowSource": "소스 보기",
+ "browserShowPage": "웹페이지로 돌아가기",
+ "browserAddToTask": "현재 작업에 추가",
+ "browserFileInfo": "파일 정보",
"done": "완료",
"a11yShare": "내보내 공유",
"copyPath": "경로 복사",
@@ -119,7 +126,13 @@
"originalFailedThumb": "원본 가져오기에 실패했습니다. 현재는 썸네일입니다",
"fetchingOriginalHint": "썸네일 · 원본 가져오는 중…",
"a11yExportShareFile": "원본 파일 내보내 공유",
- "exportShare": "내보내기 / 공유"
+ "exportShare": "내보내기 / 공유",
+ "browserAddress": "주소",
+ "browserCancelAddress": "편집 취소",
+ "browserReturnToFile": "파일로 돌아가기",
+ "browserCopyAddress": "주소 복사",
+ "browserInvalidAddress": "올바른 http 또는 https 주소를 입력하세요.",
+ "browserWebsiteFailed": "웹페이지를 열 수 없습니다. 다시 로드해 주세요."
},
"export": {
"exportFailed": "내보내기에 실패했습니다",
diff --git a/apps/mobile/src/i18n/locales/zh-CN/files.json b/apps/mobile/src/i18n/locales/zh-CN/files.json
index 0eee13e960..769db7b518 100644
--- a/apps/mobile/src/i18n/locales/zh-CN/files.json
+++ b/apps/mobile/src/i18n/locales/zh-CN/files.json
@@ -80,6 +80,13 @@
}
},
"preview": {
+ "browserBack": "后退",
+ "browserForward": "前进",
+ "browserMore": "更多操作",
+ "browserShowSource": "查看源码",
+ "browserShowPage": "返回网页",
+ "browserAddToTask": "添加到当前任务",
+ "browserFileInfo": "文件信息",
"done": "完成",
"a11yShare": "导出分享",
"copyPath": "复制路径",
@@ -119,7 +126,13 @@
"originalFailedThumb": "原图取回失败,当前为缩略图",
"fetchingOriginalHint": "缩略图 · 正在取回原图…",
"a11yExportShareFile": "导出分享原文件",
- "exportShare": "导出 / 分享"
+ "exportShare": "导出 / 分享",
+ "browserAddress": "网址",
+ "browserCancelAddress": "取消编辑",
+ "browserReturnToFile": "返回文件",
+ "browserCopyAddress": "复制网址",
+ "browserInvalidAddress": "请输入有效的 http 或 https 网址。",
+ "browserWebsiteFailed": "无法打开网页,请尝试重新加载。"
},
"export": {
"exportFailed": "导出失败",
diff --git a/apps/mobile/src/i18n/locales/zh-TW/files.json b/apps/mobile/src/i18n/locales/zh-TW/files.json
index 86980df0e6..799b5ccdb6 100644
--- a/apps/mobile/src/i18n/locales/zh-TW/files.json
+++ b/apps/mobile/src/i18n/locales/zh-TW/files.json
@@ -80,6 +80,13 @@
}
},
"preview": {
+ "browserBack": "上一頁",
+ "browserForward": "下一頁",
+ "browserMore": "更多操作",
+ "browserShowSource": "檢視原始碼",
+ "browserShowPage": "返回網頁",
+ "browserAddToTask": "加入目前任務",
+ "browserFileInfo": "檔案資訊",
"done": "完成",
"a11yShare": "匯出分享",
"copyPath": "複製路徑",
@@ -119,7 +126,13 @@
"originalFailedThumb": "原圖取回失敗,當前為縮圖",
"fetchingOriginalHint": "縮圖 · 正在取回原圖…",
"a11yExportShareFile": "匯出分享原檔案",
- "exportShare": "匯出 / 分享"
+ "exportShare": "匯出 / 分享",
+ "browserAddress": "網址",
+ "browserCancelAddress": "取消編輯",
+ "browserReturnToFile": "返回檔案",
+ "browserCopyAddress": "複製網址",
+ "browserInvalidAddress": "請輸入有效的 http 或 https 網址。",
+ "browserWebsiteFailed": "無法開啟網頁,請嘗試重新載入。"
},
"export": {
"exportFailed": "匯出失敗",
diff --git a/apps/mobile/src/session/HtmlBrowserChrome.ios.tsx b/apps/mobile/src/session/HtmlBrowserChrome.ios.tsx
new file mode 100644
index 0000000000..1df165af2f
--- /dev/null
+++ b/apps/mobile/src/session/HtmlBrowserChrome.ios.tsx
@@ -0,0 +1,320 @@
+import { Host } from "@expo/ui";
+import {
+ Button,
+ Divider,
+ HStack,
+ Image,
+ Menu,
+ ProgressView,
+ Section,
+ Text as NativeText,
+ TextField,
+ useNativeState,
+ type TextFieldRef,
+} from "@expo/ui/swift-ui";
+import {
+ accessibilityLabel,
+ autocorrectionDisabled,
+ background,
+ buttonStyle,
+ controlSize,
+ disabled,
+ font,
+ frame,
+ glassEffect,
+ labelStyle,
+ lineLimit,
+ menuOrder,
+ keyboardType,
+ onSubmit,
+ submitLabel,
+ textInputAutocapitalization,
+ padding,
+ shapes,
+} from "@expo/ui/swift-ui/modifiers";
+import { Alert, StyleSheet, View } from "react-native";
+import { useRef, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { Text } from "@/components/AppText";
+import { iconSize, radius, spacing, typeScale, useTheme } from "@/theme";
+import { useLiquidGlassAvailable } from "./useLiquidGlassAvailable";
+import {
+ HTML_BROWSER_CONTROL_SIZE as size,
+ type HtmlBrowserChromeProps,
+} from "./HtmlBrowserChrome.types";
+
+/** Native SwiftUI controls float above the WebView; the empty space passes touches through. */
+export function HtmlBrowserChrome(p: HtmlBrowserChromeProps) {
+ const { colors, mode } = useTheme();
+ const { t } = useTranslation();
+ const glass = useLiquidGlassAvailable();
+ const [editing, setEditing] = useState(false);
+ const addressText = useNativeState(p.address);
+ const addressRef = useRef<TextFieldRef>(null);
+ const beginEditing = () => { addressText.set(p.address); setEditing(true); };
+ const submitAddress = () => { if (p.onNavigate(addressText.get())) setEditing(false); };
+ const showFileInfo = () => Alert.alert(p.title, p.path);
+ // Size the visible glass itself, not an outer frame around a system-sized label.
+ // Menu and Button have different intrinsic sizes (especially ellipsis vs share).
+ const circle = [
+ buttonStyle("plain"),
+ frame({ width: size, height: size }),
+ glass
+ ? glassEffect({
+ glass: { variant: "regular", interactive: true },
+ shape: "circle",
+ })
+ : background(colors.surfaceElevated, shapes.circle()),
+ ];
+ const icon = [
+ labelStyle("iconOnly"),
+ buttonStyle("borderless"),
+ controlSize("large"),
+ frame({ width: size, height: size }),
+ ];
+ const capsule = glass
+ ? glassEffect({ glass: { variant: "regular" }, shape: "capsule" })
+ : background(colors.surfaceElevated, shapes.capsule());
+ const host = {
+ colorScheme: mode,
+ seedColor: colors.textPrimary,
+ ignoreSafeArea: "all" as const,
+ };
+ return (
+ <View pointerEvents="box-none" style={StyleSheet.absoluteFill}>
+ <View
+ pointerEvents="box-none"
+ style={{
+ position: "absolute",
+ top: p.top,
+ left: p.left,
+ right: p.right,
+ flexDirection: "row",
+ gap: spacing.sm,
+ }}
+ >
+ <Host {...host} style={{ width: size, height: size }}>
+ <Button
+ onPress={p.onClose}
+ testID="filePreview.done"
+ modifiers={[...circle, accessibilityLabel(t("files.preview.done"))]}
+ >
+ <Image
+ systemName="xmark"
+ size={iconSize.lg}
+ modifiers={[frame({ width: size, height: size })]}
+ />
+ </Button>
+ </Host>
+ <Host {...host} style={{ flex: 1, minWidth: 0, height: size }}>
+ <HStack
+ spacing={0}
+ modifiers={[frame({ maxWidth: Infinity, height: size }), capsule]}
+ >
+ {editing ? <TextField
+ ref={addressRef}
+ text={addressText}
+ autoFocus
+ onFocusChange={(focused) => {
+ if (focused) void addressRef.current?.setSelection(0, addressText.get().length);
+ }}
+ testID="filePreview.browser.addressInput"
+ modifiers={[
+ keyboardType("url"), autocorrectionDisabled(), textInputAutocapitalization("never"),
+ submitLabel("go"), onSubmit(submitAddress),
+ accessibilityLabel(t("files.preview.browserAddress")),
+ font({ size: typeScale.body }), padding({ leading: spacing.lg }),
+ frame({ maxWidth: Infinity, height: size }),
+ ]}
+ /> : <Button
+ onPress={beginEditing}
+ testID="filePreview.browser.editAddress"
+ modifiers={[
+ buttonStyle("plain"),
+ frame({ maxWidth: Infinity, height: size }),
+ accessibilityLabel(
+ `${t("files.preview.browserAddress")}: ${p.address}`,
+ ),
+ ]}
+ >
+ <HStack
+ spacing={spacing.sm}
+ modifiers={[
+ padding({ leading: spacing.lg }),
+ frame({
+ maxWidth: Infinity,
+ height: size,
+ alignment: "leading",
+ }),
+ ]}
+ >
+ <Image
+ systemName={
+ p.website ? "globe" : p.source ? "chevron.left.forwardslash.chevron.right" : "doc"
+ }
+ size={iconSize.md}
+ />
+ <NativeText
+ testID="filePreview.title"
+ modifiers={[
+ font({ size: typeScale.footnote }),
+ lineLimit(1),
+ frame({ maxWidth: Infinity, alignment: "leading" }),
+ ]}
+ >
+ {p.title}
+ </NativeText>
+ </HStack>
+ </Button>}
+ {editing ? <Button
+ label={t("files.preview.browserCancelAddress")}
+ systemImage="xmark"
+ onPress={() => setEditing(false)}
+ modifiers={icon}
+ testID="filePreview.browser.cancelAddress"
+ /> : p.loading ? (
+ <ProgressView
+ modifiers={[
+ frame({ width: size, height: size }),
+ accessibilityLabel(t("files.preview.fetchingHtmlResources")),
+ ]}
+ />
+ ) : (
+ <Button
+ label={t("files.preview.htmlReload")}
+ systemImage="arrow.clockwise"
+ onPress={p.onReload}
+ testID="filePreview.browser.reload"
+ modifiers={[...icon, disabled(p.source || p.loading)]}
+ />
+ )}
+ </HStack>
+ </Host>
+ </View>
+ {p.notice ? (
+ <View
+ pointerEvents="none"
+ style={{
+ position: "absolute",
+ bottom: p.bottom + size + spacing.sm,
+ left: p.left,
+ right: p.right,
+ alignItems: "center",
+ }}
+ >
+ <Text
+ accessibilityLiveRegion="polite"
+ testID="filePreview.notice"
+ style={{
+ color: colors.textPrimary,
+ backgroundColor: colors.surfaceElevated,
+ padding: spacing.sm,
+ borderRadius: radius.pill,
+ fontSize: typeScale.caption,
+ }}
+ >
+ {p.notice}
+ </Text>
+ </View>
+ ) : null}
+ <View
+ pointerEvents="box-none"
+ style={{
+ position: "absolute",
+ bottom: p.bottom,
+ left: p.left,
+ right: p.right,
+ flexDirection: "row",
+ gap: spacing.md,
+ }}
+ >
+ <Host {...host} style={{ width: size * 2, height: size }}>
+ <HStack spacing={0} modifiers={[capsule]}>
+ <Button
+ label={t("files.preview.browserBack")}
+ systemImage="chevron.backward"
+ onPress={p.onBack}
+ testID="filePreview.browser.back"
+ modifiers={[...icon, disabled(!p.canGoBack)]}
+ />
+ <Button
+ label={t("files.preview.browserForward")}
+ systemImage="chevron.forward"
+ onPress={p.onForward}
+ testID="filePreview.browser.forward"
+ modifiers={[...icon, disabled(!p.canGoForward)]}
+ />
+ </HStack>
+ </Host>
+ <View pointerEvents="none" style={{ flex: 1 }} />
+ <Host {...host} style={{ width: size, height: size }}>
+ <Button
+ onPress={p.onShare}
+ testID="filePreview.share"
+ modifiers={[
+ ...circle,
+ disabled(p.busy),
+ accessibilityLabel(t("files.preview.a11yShare")),
+ ]}
+ >
+ <Image
+ systemName="square.and.arrow.up"
+ size={iconSize.lg}
+ modifiers={[frame({ width: size, height: size })]}
+ />
+ </Button>
+ </Host>
+ <Host {...host} style={{ width: size, height: size }}>
+ <Menu
+ label={
+ <Image
+ systemName="ellipsis"
+ size={iconSize.lg}
+ modifiers={[frame({ width: size, height: size })]}
+ />
+ }
+ testID="filePreview.browser.more"
+ modifiers={[
+ ...circle,
+ menuOrder("fixed"),
+ accessibilityLabel(t("files.preview.browserMore")),
+ ]}
+ >
+ {!p.website && <Section title={p.title}>
+ <Button
+ label={t("files.preview.browserFileInfo")}
+ systemImage="doc"
+ onPress={showFileInfo}
+ />
+ </Section>}
+ <Button
+ label={t(
+ p.website ? "files.preview.browserReturnToFile" : p.source
+ ? "files.preview.browserShowPage"
+ : "files.preview.browserShowSource",
+ )}
+ systemImage="chevron.left.forwardslash.chevron.right"
+ onPress={p.onToggleSource}
+ testID="filePreview.browser.source"
+ />
+ <Divider />
+ <Button
+ label={t(p.website ? "files.preview.browserCopyAddress" : "files.preview.copyPath")}
+ systemImage="doc.on.doc"
+ onPress={p.onCopyPath}
+ testID="filePreview.copyPath"
+ modifiers={[disabled(p.busy)]}
+ />
+ {!p.website && <Button
+ label={t("files.preview.browserAddToTask")}
+ systemImage="text.bubble"
+ onPress={p.onAddToTask}
+ testID="filePreview.sendToSession"
+ modifiers={[disabled(p.busy)]}
+ />}
+ </Menu>
+ </Host>
+ </View>
+ </View>
+ );
+}
diff --git a/apps/mobile/src/session/HtmlBrowserChrome.tsx b/apps/mobile/src/session/HtmlBrowserChrome.tsx
new file mode 100644
index 0000000000..3c14168b5e
--- /dev/null
+++ b/apps/mobile/src/session/HtmlBrowserChrome.tsx
@@ -0,0 +1,348 @@
+import { useRef, useState } from "react";
+import {
+ ActivityIndicator,
+ Pressable,
+ ScrollView,
+ StyleSheet,
+ View,
+} from "react-native";
+import { useTranslation } from "react-i18next";
+import {
+ ChevronLeft,
+ ChevronRight,
+ CodeXml,
+ Copy,
+ Ellipsis,
+ File,
+ MessageSquarePlus,
+ RotateCw,
+ Share,
+ X,
+ type LucideIcon,
+} from "lucide-react-native";
+import { Text, TextInput } from "@/components/AppText";
+import { SheetModal } from "./SheetModal";
+import {
+ iconSize,
+ iconStroke,
+ radius,
+ spacing,
+ typeScale,
+ useTheme,
+ useThemedStyles,
+ type ThemeColors,
+} from "@/theme";
+import {
+ HTML_BROWSER_CONTROL_SIZE as size,
+ type HtmlBrowserChromeProps,
+} from "./HtmlBrowserChrome.types";
+
+/** Android/web use opaque themed surfaces so arbitrary webpage colors cannot erase the controls. */
+export function HtmlBrowserChrome(p: HtmlBrowserChromeProps) {
+ const { t } = useTranslation();
+ const { colors } = useTheme();
+ const styles = useThemedStyles(makeStyles);
+ const [menuOpen, setMenuOpen] = useState(false);
+ const [editing, setEditing] = useState(false);
+ const [address, setAddress] = useState(p.address);
+ const afterClose = useRef<(() => void) | null>(null);
+ const close = () => setMenuOpen(false);
+ const choose = (action: () => void) => {
+ afterClose.current = action;
+ close();
+ };
+ const button = (
+ Icon: LucideIcon,
+ label: string,
+ action: () => void,
+ id: string,
+ disabled = false,
+ ) => (
+ <Pressable
+ accessibilityLabel={label}
+ accessibilityRole="button"
+ accessibilityState={{ disabled }}
+ disabled={disabled}
+ onPress={action}
+ testID={id}
+ style={({ pressed }) => [
+ styles.button,
+ (pressed || disabled) && styles.dimmed,
+ ]}
+ >
+ <Icon
+ color={colors.textPrimary}
+ size={iconSize.xl}
+ strokeWidth={iconStroke.regular}
+ />
+ </Pressable>
+ );
+ return (
+ <View pointerEvents="box-none" style={StyleSheet.absoluteFill}>
+ <View
+ pointerEvents="box-none"
+ style={[styles.row, { top: p.top, left: p.left, right: p.right }]}
+ >
+ {button(X, t("files.preview.done"), p.onClose, "filePreview.done")}
+ <View style={styles.address}>
+ {editing ? <TextInput
+ value={address}
+ onChangeText={setAddress}
+ autoFocus
+ selectTextOnFocus
+ autoCapitalize="none"
+ autoCorrect={false}
+ keyboardType="url"
+ returnKeyType="go"
+ submitBehavior="submit"
+ onSubmitEditing={(event) => { if (p.onNavigate(event.nativeEvent.text)) setEditing(false); }}
+ accessibilityLabel={t("files.preview.browserAddress")}
+ testID="filePreview.browser.addressInput"
+ style={[styles.title, { flex: 1, height: size, paddingHorizontal: spacing.md }]}
+ /> : <Pressable
+ accessibilityRole="button"
+ accessibilityLabel={`${t("files.preview.browserAddress")}: ${p.address}`}
+ onPress={() => { setAddress(p.address); setEditing(true); }}
+ testID="filePreview.browser.editAddress"
+ style={styles.addressTitle}
+ >
+ <File
+ color={colors.textSecondary}
+ size={iconSize.md}
+ strokeWidth={iconStroke.regular}
+ />
+ <Text
+ numberOfLines={1}
+ accessibilityLabel={p.path}
+ style={styles.title}
+ testID="filePreview.title"
+ >
+ {p.title}
+ </Text>
+ </Pressable>}
+ {editing ? button(X, t("files.preview.browserCancelAddress"), () => setEditing(false), "filePreview.browser.cancelAddress") : p.loading ? (
+ <View style={styles.button}>
+ <ActivityIndicator color={colors.textSecondary} />
+ </View>
+ ) : (
+ button(
+ RotateCw,
+ t("files.preview.htmlReload"),
+ p.onReload,
+ "filePreview.browser.reload",
+ p.source || p.loading,
+ )
+ )}
+ </View>
+ </View>
+ {p.notice ? (
+ <View
+ pointerEvents="none"
+ style={[styles.notice, { bottom: p.bottom + size + spacing.sm }]}
+ >
+ {p.notice ? (
+ <Text
+ accessibilityLiveRegion="polite"
+ testID="filePreview.notice"
+ style={styles.noticeText}
+ >
+ {p.notice}
+ </Text>
+ ) : (
+ <ActivityIndicator color={colors.textSecondary} />
+ )}
+ </View>
+ ) : null}
+ <View
+ pointerEvents="box-none"
+ style={[styles.row, { bottom: p.bottom, left: p.left, right: p.right }]}
+ >
+ <View style={styles.navigation}>
+ {button(
+ ChevronLeft,
+ t("files.preview.browserBack"),
+ p.onBack,
+ "filePreview.browser.back",
+ !p.canGoBack,
+ )}
+ {button(
+ ChevronRight,
+ t("files.preview.browserForward"),
+ p.onForward,
+ "filePreview.browser.forward",
+ !p.canGoForward,
+ )}
+ </View>
+ <View pointerEvents="none" style={styles.spacer} />
+ {button(
+ Share,
+ t("files.preview.a11yShare"),
+ p.onShare,
+ "filePreview.share",
+ p.busy,
+ )}
+ {button(
+ Ellipsis,
+ t("files.preview.browserMore"),
+ () => setMenuOpen(true),
+ "filePreview.browser.more",
+ )}
+ </View>
+ <SheetModal
+ visible={menuOpen}
+ onBackdropPress={close}
+ onRequestClose={close}
+ onClosed={() => {
+ const action = afterClose.current;
+ afterClose.current = null;
+ action?.();
+ }}
+ >
+ <View style={[styles.menu, { paddingBottom: p.bottom }]}>
+ <View style={styles.menuHeader}>
+ <Text numberOfLines={1} style={styles.menuTitle}>
+ {p.title}
+ </Text>
+ {button(
+ X,
+ t("shared.closePanel"),
+ close,
+ "filePreview.browser.menuClose",
+ )}
+ </View>
+ <ScrollView>
+ <Text selectable style={styles.path}>
+ {p.path}
+ </Text>
+ {[
+ {
+ id: "filePreview.browser.source",
+ Icon: CodeXml,
+ label: t(
+ p.website ? "files.preview.browserReturnToFile" : p.source
+ ? "files.preview.browserShowPage"
+ : "files.preview.browserShowSource",
+ ),
+ action: p.onToggleSource,
+ disabled: false,
+ },
+ {
+ id: "filePreview.copyPath",
+ Icon: Copy,
+ label: t(p.website ? "files.preview.browserCopyAddress" : "files.preview.copyPath"),
+ action: p.onCopyPath,
+ disabled: p.busy,
+ },
+ {
+ id: "filePreview.sendToSession",
+ Icon: MessageSquarePlus,
+ label: t("files.preview.browserAddToTask"),
+ action: p.onAddToTask,
+ disabled: p.busy,
+ },
+ ].filter(item => !p.website || item.id !== "filePreview.sendToSession").map(({ id, Icon, label, action, disabled }) => (
+ <Pressable
+ key={id}
+ accessibilityRole="button"
+ accessibilityState={{ disabled }}
+ disabled={disabled}
+ testID={id}
+ onPress={() => choose(action)}
+ style={({ pressed }) => [
+ styles.menuItem,
+ (pressed || disabled) && styles.dimmed,
+ ]}
+ >
+ <Icon
+ size={iconSize.lg}
+ color={colors.textPrimary}
+ strokeWidth={iconStroke.regular}
+ />
+ <Text style={styles.menuLabel}>{label}</Text>
+ </Pressable>
+ ))}
+ </ScrollView>
+ </View>
+ </SheetModal>
+ </View>
+ );
+}
+
+const makeStyles = (c: ThemeColors) =>
+ StyleSheet.create({
+ row: {
+ position: "absolute",
+ flexDirection: "row",
+ alignItems: "center",
+ gap: spacing.sm,
+ },
+ button: {
+ width: size,
+ height: size,
+ alignItems: "center",
+ justifyContent: "center",
+ borderRadius: radius.pill,
+ backgroundColor: c.surfaceElevated,
+ },
+ dimmed: { opacity: 0.4 },
+ address: {
+ flex: 1,
+ minWidth: 0,
+ flexDirection: "row",
+ alignItems: "center",
+ borderRadius: radius.pill,
+ backgroundColor: c.surfaceElevated,
+ paddingLeft: spacing.lg,
+ },
+ title: { flex: 1, color: c.textPrimary, fontSize: typeScale.footnote },
+ addressTitle: {
+ flex: 1,
+ minWidth: 0,
+ minHeight: size,
+ flexDirection: "row",
+ alignItems: "center",
+ gap: spacing.sm,
+ },
+ navigation: {
+ flexDirection: "row",
+ borderRadius: radius.pill,
+ backgroundColor: c.surfaceElevated,
+ },
+ spacer: { flex: 1 },
+ notice: {
+ position: "absolute",
+ left: spacing.lg,
+ right: spacing.lg,
+ alignItems: "center",
+ },
+ noticeText: {
+ color: c.textPrimary,
+ backgroundColor: c.surfaceElevated,
+ padding: spacing.sm,
+ borderRadius: radius.container,
+ fontSize: typeScale.caption,
+ },
+ menu: {
+ maxHeight: "80%",
+ backgroundColor: c.surfaceElevated,
+ borderTopLeftRadius: radius.container,
+ borderTopRightRadius: radius.container,
+ padding: spacing.lg,
+ },
+ menuHeader: { flexDirection: "row", alignItems: "center" },
+ menuTitle: { flex: 1, color: c.textPrimary, fontSize: typeScale.body },
+ path: {
+ color: c.textSecondary,
+ fontSize: typeScale.caption,
+ marginVertical: spacing.sm,
+ },
+ menuItem: {
+ minHeight: size,
+ flexDirection: "row",
+ alignItems: "center",
+ gap: spacing.md,
+ padding: spacing.sm,
+ borderRadius: radius.control,
+ },
+ menuLabel: { color: c.textPrimary, fontSize: typeScale.body },
+ });
diff --git a/apps/mobile/src/session/HtmlBrowserChrome.types.ts b/apps/mobile/src/session/HtmlBrowserChrome.types.ts
new file mode 100644
index 0000000000..9a85d6404f
--- /dev/null
+++ b/apps/mobile/src/session/HtmlBrowserChrome.types.ts
@@ -0,0 +1,30 @@
+/** File actions always refer to the entry file; WebView history stays inside its preview. */
+export interface HtmlBrowserChromeProps {
+ title: string;
+ path: string;
+ address: string;
+ website?: boolean;
+ /** False keeps the editor open; validation feedback is owned by the caller. */
+ onNavigate(address: string): boolean;
+ top: number;
+ bottom: number;
+ left: number;
+ right: number;
+ canGoBack: boolean;
+ canGoForward: boolean;
+ source: boolean;
+ busy: boolean;
+ loading: boolean;
+ notice?: string | null;
+ onClose(): void;
+ onBack(): void;
+ onForward(): void;
+ onReload(): void;
+ onShare(): void;
+ onCopyPath(): void;
+ onAddToTask(): void;
+ onToggleSource(): void;
+}
+
+// Native controls keep a 44pt hit target; the scroll insets also clear the outer spacing.
+export const HTML_BROWSER_CONTROL_SIZE = 44;
diff --git a/apps/mobile/src/session/HtmlFileReader.tsx b/apps/mobile/src/session/HtmlFileReader.tsx
index 48efa2c20a..1e3b31c25f 100644
--- a/apps/mobile/src/session/HtmlFileReader.tsx
+++ b/apps/mobile/src/session/HtmlFileReader.tsx
@@ -33,21 +33,57 @@
* 会被 RNW 交给 RN `Linking` 试着让系统处理 —— 于是 `tel:` / `mailto:` / 自定义 scheme
* 会拉起外部应用,把下面这段策略整个绕过去。放到 `['*']` 之后,回调是唯一决策点。
*/
-import { useCallback, useMemo, useRef } from 'react';
+import { useCallback, useEffect, useMemo, useRef, type RefObject } from 'react';
import { StyleSheet, View } from 'react-native';
-import { WebView } from 'react-native-webview';
-import type { ShouldStartLoadRequest } from 'react-native-webview/lib/WebViewTypes';
+import { WebView, type WebViewProps } from 'react-native-webview';
+import type { ShouldStartLoadRequest, WebViewNavigation } from 'react-native-webview/lib/WebViewTypes';
import { interceptHtmlNavigation, interceptSnapshotNavigation } from '@/session/htmlNavigationPolicy';
import { withHtmlPreviewCsp } from '@/session/htmlPreviewCsp';
import type { MobileHtmlPreview } from '@/session/mobileHtmlPreview';
+import { useHtmlBrowserViewport } from '@/session/useHtmlBrowserViewport';
+import { browserViewportScrollScript } from '@/session/htmlBrowserViewport';
/** The server serves only the downloaded manifest; every HTML has the same CSP and device guard. */
-export function HtmlSnapshotReader({ preview, onError }: { preview: MobileHtmlPreview; onError(): void }) {
+export function HtmlSnapshotReader({ preview, onError, webViewRef, viewportInsets, onNavigationStateChange }: {
+ preview: MobileHtmlPreview;
+ onError(): void;
+ webViewRef?: RefObject<WebView | null>;
+ viewportInsets?: WebViewProps['contentInset'];
+ onNavigationStateChange?(preview: MobileHtmlPreview, state: WebViewNavigation): void;
+}) {
const source = useMemo(() => ({ uri: preview.url }), [preview.url]);
- return <WebView
+ const localRef = useRef<WebView>(null);
+ const readerRef = webViewRef ?? localRef;
+ const { viewRef, measure, script, viewportStyle, obscuredContentInsets } = useHtmlBrowserViewport({
+ top: viewportInsets?.top ?? 0, bottom: viewportInsets?.bottom ?? 0,
+ left: viewportInsets?.left ?? 0, right: viewportInsets?.right ?? 0,
+ });
+ useEffect(() => { if (script) readerRef.current?.injectJavaScript(script); }, [script, readerRef, preview]);
+ const currentPreview = useRef<MobileHtmlPreview | null>(preview);
+ useEffect(() => {
+ currentPreview.current = preview;
+ return () => { currentPreview.current = null; };
+ }, [preview]);
+ return <View ref={viewRef} onLayout={measure} collapsable={false} style={[styles.fill, viewportStyle]}><View style={styles.viewport}><WebView
+ key={preview.url}
+ ref={readerRef}
testID="filePreview.htmlRendered"
source={source}
+ // Pair WebKit layout occlusion with the scroll range needed to reveal both ends.
+ automaticallyAdjustContentInsets={false}
+ contentInsetAdjustmentBehavior="never"
+ obscuredContentInsets={obscuredContentInsets}
+ contentInset={obscuredContentInsets}
+ injectedJavaScriptBeforeContentLoaded={script}
+ injectedJavaScript={script}
+ onLoadEnd={() => { if (currentPreview.current === preview && script) readerRef.current?.injectJavaScript(script); }}
+ onScroll={({ nativeEvent: { contentOffset } }) => {
+ if (currentPreview.current === preview) readerRef.current?.injectJavaScript(browserViewportScrollScript(contentOffset.x, contentOffset.y));
+ }}
+ onNavigationStateChange={(state) => {
+ if (currentPreview.current === preview) onNavigationStateChange?.(preview, state);
+ }}
originWhitelist={['*']}
onShouldStartLoadWithRequest={(request) => interceptSnapshotNavigation(request.url, preview.url, preview.documents, preview.onDemand)}
setSupportMultipleWindows={false}
@@ -62,7 +98,7 @@ export function HtmlSnapshotReader({ preview, onError }: { preview: MobileHtmlPr
}}
incognito
style={styles.fill}
- />;
+ /></View></View>;
}
export function HtmlFileReader({ html, testID }: { html: string; testID?: string }) {
@@ -124,4 +160,5 @@ export function HtmlFileReader({ html, testID }: { html: string; testID?: string
const styles = StyleSheet.create({
fill: { flex: 1 },
+ viewport: { flex: 1, minHeight: 0, overflow: 'hidden' },
});
diff --git a/apps/mobile/src/session/HtmlWebsiteBrowser.tsx b/apps/mobile/src/session/HtmlWebsiteBrowser.tsx
new file mode 100644
index 0000000000..2afdb71864
--- /dev/null
+++ b/apps/mobile/src/session/HtmlWebsiteBrowser.tsx
@@ -0,0 +1,125 @@
+import { useEffect, useRef, useState } from 'react';
+import { ActivityIndicator, Alert, Platform, Share, StyleSheet, View } from 'react-native';
+import { WebView, type WebViewNavigation } from 'react-native-webview';
+import * as Clipboard from 'expo-clipboard';
+import { useTranslation } from 'react-i18next';
+import { Text } from '@/components/AppText';
+import { useTheme } from '@/theme';
+import { HtmlBrowserChrome } from './HtmlBrowserChrome';
+import type { HtmlBrowserChromeProps } from './HtmlBrowserChrome.types';
+import { normalizeBrowserAddress, allowWebsiteNavigation } from './browserAddress';
+import { useHtmlBrowserViewport } from './useHtmlBrowserViewport';
+import { browserViewportScrollScript, type BrowserInsets } from './htmlBrowserViewport';
+
+export interface WebsiteVisit { url: string; snapshotClosed: Promise<void> }
+
+/** Separate native lifetime and ephemeral cookie store from the file preview. */
+export function HtmlWebsiteBrowser({ visit, insets, chrome, onReturn }: {
+ visit: WebsiteVisit;
+ insets: BrowserInsets;
+ chrome: Pick<HtmlBrowserChromeProps, 'top' | 'bottom' | 'left' | 'right' | 'onClose'>;
+ onReturn(): void;
+}) {
+ const { t } = useTranslation();
+ const { colors } = useTheme();
+ const webView = useRef<WebView>(null);
+ const [ready, setReady] = useState(false);
+ const [failed, setFailed] = useState(false);
+ const [navigation, setNavigation] = useState<WebViewNavigation | null>(null);
+ const [source, setSource] = useState({ uri: visit.url });
+ const [rendererEpoch, setRendererEpoch] = useState(0);
+ const rendererGone = useRef(false);
+ const pendingAddress = useRef<{ url: string; previous: string[] } | null>(null);
+ const address = navigation?.url ?? source.uri;
+ const live = useRef(true);
+ const { viewRef, measure, script, viewportStyle, obscuredContentInsets } = useHtmlBrowserViewport(insets);
+ useEffect(() => {
+ live.current = true;
+ void visit.snapshotClosed.then(() => { if (live.current) setReady(true); }, () => { if (live.current) setFailed(true); });
+ return () => { live.current = false; };
+ }, [visit.snapshotClosed]);
+ useEffect(() => { if (script && ready) webView.current?.injectJavaScript(script); }, [script, ready]);
+ const navigate = (input: string) => {
+ const url = normalizeBrowserAddress(input);
+ if (!url) { Alert.alert(t('files.preview.browserInvalidAddress')); return false; }
+ pendingAddress.current = { url, previous: [address, source.uri] };
+ setNavigation(null);
+ setFailed(false);
+ setSource({ uri: url });
+ if (rendererGone.current) { rendererGone.current = false; setRendererEpoch(value => value + 1); }
+ else if (url === address && ready) webView.current?.reload();
+ return true;
+ };
+ return <View style={[styles.fill, { backgroundColor: colors.surface }]}>
+ <View ref={viewRef} onLayout={measure} collapsable={false} style={[styles.fill, viewportStyle]}>
+ <View style={styles.viewport}>
+ {ready && <WebView
+ key={rendererEpoch}
+ ref={webView}
+ testID="filePreview.website"
+ source={source}
+ incognito
+ originWhitelist={['*']}
+ onShouldStartLoadWithRequest={request => allowWebsiteNavigation(request.url)}
+ setSupportMultipleWindows={false}
+ allowFileAccess={false}
+ mediaCapturePermissionGrantType="deny"
+ automaticallyAdjustContentInsets={false}
+ contentInsetAdjustmentBehavior="never"
+ obscuredContentInsets={obscuredContentInsets}
+ contentInset={obscuredContentInsets}
+ injectedJavaScriptBeforeContentLoaded={script}
+ injectedJavaScript={script}
+ onLoadStart={event => {
+ if (!live.current) return;
+ if (event.nativeEvent.url === pendingAddress.current?.url) pendingAddress.current = null;
+ setFailed(false);
+ }}
+ onLoadEnd={() => { if (live.current && script) webView.current?.injectJavaScript(script); }}
+ onScroll={({ nativeEvent: { contentOffset } }) => {
+ if (live.current) webView.current?.injectJavaScript(browserViewportScrollScript(contentOffset.x, contentOffset.y));
+ }}
+ onNavigationStateChange={state => {
+ if (!live.current || !allowWebsiteNavigation(state.url)) return;
+ const pending = pendingAddress.current;
+ if (pending && state.url !== pending.url && pending.previous.includes(state.url)) return;
+ pendingAddress.current = null;
+ setNavigation(state);
+ // Both native platforms skip loading when this is already the WebView's URL.
+ setSource(old => old.uri === state.url ? old : { uri: state.url });
+ }}
+ onError={() => { if (live.current) setFailed(true); }}
+ onContentProcessDidTerminate={() => { if (live.current) { rendererGone.current = true; setFailed(true); } }}
+ onRenderProcessGone={() => { if (live.current) { rendererGone.current = true; setFailed(true); } }}
+ style={styles.fill}
+ />}
+ {!ready && !failed && <View style={styles.center}><ActivityIndicator color={colors.textSecondary} /></View>}
+ {failed && <View pointerEvents="none" style={[styles.center, { backgroundColor: colors.surface }]}>
+ <Text style={{ color: colors.textPrimary }}>{t('files.preview.browserWebsiteFailed')}</Text>
+ </View>}
+ </View>
+ </View>
+ <HtmlBrowserChrome {...chrome}
+ title={address} path={address} address={address} website
+ source={false} busy={false} loading={!failed && (!ready || !navigation || navigation.loading)}
+ canGoBack canGoForward={navigation?.canGoForward === true}
+ onNavigate={navigate}
+ onBack={() => navigation?.canGoBack ? webView.current?.goBack() : onReturn()}
+ onForward={() => webView.current?.goForward()}
+ onReload={() => {
+ if (rendererGone.current) { rendererGone.current = false; setFailed(false); setRendererEpoch(value => value + 1); }
+ else webView.current?.reload();
+ }}
+ onToggleSource={onReturn}
+ onCopyPath={() => { void Clipboard.setStringAsync(address); }}
+ onShare={() => { void Share.share(Platform.OS === 'ios' ? { url: address } : { message: address }).catch(() => {}); }}
+ onAddToTask={() => {}}
+ />
+ </View>;
+}
+
+const styles = StyleSheet.create({
+ fill: { flex: 1 },
+ viewport: { flex: 1, overflow: 'hidden' },
+ center: { ...StyleSheet.absoluteFill, alignItems: 'center', justifyContent: 'center' },
+});
diff --git a/apps/mobile/src/session/browserAddress.ts b/apps/mobile/src/session/browserAddress.ts
new file mode 100644
index 0000000000..aab004b159
--- /dev/null
+++ b/apps/mobile/src/session/browserAddress.ts
@@ -0,0 +1,17 @@
+/** Only a native address-field submission may opt into browsing an external site. */
+export function normalizeBrowserAddress(input: string): string | null {
+ const value = input.trim();
+ if (!value || /[\s\\]/.test(value)) return null;
+ const hostWithPort = /^(?:localhost|[^/?#:@]+\.[^/?#:@]+|\[[\da-f:]+\]):\d+(?:[/?#]|$)/i.test(value);
+ const explicitScheme = !hostWithPort && /^[a-z][a-z\d+.-]*:/i.test(value);
+ try {
+ const url = new URL(explicitScheme ? value : `https://${value}`);
+ if (!['https:', 'http:'].includes(url.protocol) || url.username || url.password) return null;
+ if (!explicitScheme && !url.hostname.includes('.') && url.hostname !== 'localhost') return null;
+ return url.href;
+ } catch { return null; }
+}
+
+export function allowWebsiteNavigation(value: string): boolean {
+ return /^https?:\/\//i.test(value) && normalizeBrowserAddress(value) !== null;
+}
diff --git a/apps/mobile/src/session/htmlBrowserViewport.ts b/apps/mobile/src/session/htmlBrowserViewport.ts
new file mode 100644
index 0000000000..76ce82e021
--- /dev/null
+++ b/apps/mobile/src/session/htmlBrowserViewport.ts
@@ -0,0 +1,92 @@
+/** Geometry only: the page receives no native callback, path, token or capability. */
+export interface BrowserInsets { top: number; right: number; bottom: number; left: number }
+export interface BrowserFrame { x: number; y: number; width: number; height: number }
+export interface BrowserViewport {
+ width: number;
+ height: number;
+ controls: BrowserInsets;
+ insets: BrowserInsets;
+ availableWidth: number;
+ availableHeight: number;
+}
+
+/** All inputs are native window points; insets are relative to the measured WebView. */
+export function browserViewport(frame: BrowserFrame, controls: BrowserInsets, keyboard: BrowserFrame | null): BrowserViewport {
+ const clamp = (value: number, max: number) => Math.max(0, Math.min(max, value));
+ const bounded = {
+ top: clamp(controls.top, frame.height), bottom: clamp(controls.bottom, frame.height),
+ left: clamp(controls.left, frame.width), right: clamp(controls.right, frame.width),
+ };
+ const overlaps = keyboard && keyboard.width > 0 && keyboard.height > 0
+ && keyboard.x < frame.x + frame.width && keyboard.x + keyboard.width > frame.x
+ && keyboard.y < frame.y + frame.height && keyboard.y + keyboard.height > frame.y;
+ // A floating keyboard conservatively reserves everything below its top edge.
+ // If Android already resized this view above the keyboard, overlap is zero.
+ const bottom = Math.max(bounded.bottom, overlaps ? clamp(frame.y + frame.height - keyboard.y, frame.height) : 0);
+ const insets = { ...bounded, bottom };
+ return {
+ width: frame.width, height: frame.height, controls: bounded, insets,
+ availableWidth: Math.max(0, frame.width - insets.left - insets.right),
+ availableHeight: Math.max(0, frame.height - insets.top - insets.bottom),
+ };
+}
+
+/** Reinstalled for each document and native update; old page listeners are removed. */
+export function browserViewportScript(viewport: BrowserViewport): string {
+ return `(() => {
+ const native = ${JSON.stringify(viewport)};
+ const key = Symbol.for('cindy.browserViewport.cleanup');
+ if (typeof window[key] === 'function') window[key]();
+ let pending = 0;
+ let last = '';
+ const publish = () => {
+ pending = 0;
+ if (!document.documentElement) return;
+ const scale = window.visualViewport?.scale || 1;
+ const px = n => Math.round(n / scale * 1000) / 1000;
+ const edges = value => Object.freeze(Object.fromEntries(Object.entries(value).map(([k,v]) => [k, px(v)])));
+ const offset = window[Symbol.for('cindy.browserViewport.offset')] || { x: -native.controls.left, y: -native.controls.top };
+ const value = Object.freeze({ version: 1, width: px(native.width), height: px(native.height),
+ controls: edges(native.controls), insets: edges(native.insets),
+ availableTop: px(offset.y + native.insets.top), availableLeft: px(offset.x + native.insets.left),
+ availableWidth: px(native.availableWidth), availableHeight: px(native.availableHeight) });
+ const signature = JSON.stringify(value);
+ if (signature === last) return;
+ last = signature;
+ const style = document.documentElement.style;
+ const set = (name, n) => style.setProperty('--cindy-' + name, n + 'px');
+ set('viewport-width', value.width); set('viewport-height', value.height);
+ set('available-width', value.availableWidth); set('available-height', value.availableHeight);
+ set('available-top', value.availableTop); set('available-left', value.availableLeft);
+ for (const side of ['top', 'right', 'bottom', 'left']) {
+ set('controls-' + side, value.controls[side]);
+ set('inset-' + side, value.insets[side]);
+ }
+ // Advisory page-local data, not a security boundary. A page may override its own globals.
+ try { Object.defineProperty(window, 'cindyViewport', { configurable: true, get: () => value }); } catch {}
+ window.dispatchEvent(new CustomEvent('cindyviewportchange', { detail: value }));
+ };
+ const schedule = () => { if (!pending) pending = requestAnimationFrame(publish); };
+ window.addEventListener('resize', schedule);
+ window.addEventListener('pageshow', schedule);
+ window.addEventListener('cindy:viewport-scroll', schedule);
+ document.addEventListener('DOMContentLoaded', schedule);
+ window.visualViewport?.addEventListener('resize', schedule);
+ window[key] = () => {
+ cancelAnimationFrame(pending);
+ window.removeEventListener('resize', schedule);
+ window.removeEventListener('pageshow', schedule);
+ window.removeEventListener('cindy:viewport-scroll', schedule);
+ document.removeEventListener('DOMContentLoaded', schedule);
+ window.visualViewport?.removeEventListener('resize', schedule);
+ };
+ publish();
+ })(); true;`;
+}
+
+/** UIKit offset includes the negative initial contentInset; window.scrollY does not. */
+export function browserViewportScrollScript(x: number, y: number): string {
+ if (!Number.isFinite(x) || !Number.isFinite(y)) return 'true;';
+ return `window[Symbol.for('cindy.browserViewport.offset')] = ${JSON.stringify({ x, y })};
+ window.dispatchEvent(new Event('cindy:viewport-scroll')); true;`;
+}
diff --git a/apps/mobile/src/session/useHtmlBrowserViewport.ts b/apps/mobile/src/session/useHtmlBrowserViewport.ts
new file mode 100644
index 0000000000..bb990f7f1e
--- /dev/null
+++ b/apps/mobile/src/session/useHtmlBrowserViewport.ts
@@ -0,0 +1,62 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { AccessibilityInfo, Keyboard, Platform, View, useWindowDimensions, type KeyboardEvent } from 'react-native';
+import { browserViewport, browserViewportScript, type BrowserFrame, type BrowserInsets } from './htmlBrowserViewport';
+
+/** iOS 26 keeps full-bleed rendering; older platforms reserve actual layout space. */
+export function useHtmlBrowserViewport(controls: BrowserInsets) {
+ const viewRef = useRef<View>(null);
+ const windowSize = useWindowDimensions();
+ const [frame, setFrame] = useState<BrowserFrame | null>(null);
+ const [keyboard, setKeyboard] = useState<BrowserFrame | null>(() => {
+ const value = Keyboard.metrics();
+ return value && value.screenY !== 0 ? { x: value.screenX, y: value.screenY, width: value.width, height: value.height } : null;
+ });
+ const measure = useCallback(() => {
+ viewRef.current?.measureInWindow((x, y, width, height) => {
+ if (width > 0 && height > 0) setFrame(old => old?.x === x && old.y === y && old.width === width && old.height === height ? old : { x, y, width, height });
+ });
+ }, []);
+ useEffect(measure, [measure, windowSize.width, windowSize.height]);
+ useEffect(() => {
+ let generation = 0;
+ const update = (event: KeyboardEvent) => {
+ const current = ++generation;
+ const end = event.endCoordinates;
+ const rect = { x: end.screenX, y: end.screenY, width: end.width, height: end.height };
+ if (Platform.OS === 'ios' && end.screenY === 0) {
+ // Same OS cross-fade special case as RN KeyboardAvoidingView.
+ void AccessibilityInfo.prefersCrossFadeTransitions().then(crossFade => {
+ if (current === generation) setKeyboard(crossFade ? null : rect);
+ }).catch(() => {
+ if (current === generation) setKeyboard(rect);
+ });
+ } else setKeyboard(rect);
+ measure();
+ };
+ const hide = () => { generation++; setKeyboard(null); measure(); };
+ const subscriptions = [Keyboard.addListener('keyboardDidShow', update), Keyboard.addListener('keyboardDidHide', hide)];
+ if (Platform.OS === 'ios') subscriptions.push(
+ Keyboard.addListener('keyboardWillShow', update), Keyboard.addListener('keyboardWillHide', hide),
+ Keyboard.addListener('keyboardWillChangeFrame', update), Keyboard.addListener('keyboardDidChangeFrame', update),
+ );
+ return () => { generation++; subscriptions.forEach(subscription => subscription.remove()); };
+ }, [measure]);
+ const outer = frame ? browserViewport(frame, controls, keyboard) : null;
+ const edges = outer?.insets ?? controls;
+ const nativeObscured = Platform.OS === 'ios' && Number.parseInt(String(Platform.Version), 10) >= 26;
+ const viewportStyle = nativeObscured ? undefined : {
+ paddingTop: edges.top,
+ paddingBottom: frame ? Math.min(edges.bottom, Math.max(0, frame.height - edges.top)) : edges.bottom,
+ paddingLeft: edges.left,
+ paddingRight: frame ? Math.min(edges.right, Math.max(0, frame.width - edges.left)) : edges.right,
+ };
+ // Only the fallback excludes strips from the actual frame; do not deduct them twice.
+ const clear = { top: 0, bottom: 0, left: 0, right: 0 };
+ const script = outer ? browserViewportScript(nativeObscured ? outer : browserViewport({
+ x: 0, y: 0, width: outer.availableWidth, height: outer.availableHeight,
+ }, clear, null)) : undefined;
+ return { viewRef, measure, viewportStyle, script,
+ // WebKit combines keyboard occlusion itself; only browser chrome belongs in this prop.
+ obscuredContentInsets: nativeObscured ? controls : undefined,
+ };
+}
diff --git a/dependency-patches/[email protected] b/dependency-patches/[email protected]
index bb2d6ee41b..e986697c02 100644
--- a/dependency-patches/[email protected]
+++ b/dependency-patches/[email protected]
@@ -1,5 +1,53 @@
+diff --git a/android/src/newarch/com/reactnativecommunity/webview/RNCWebViewManager.java b/android/src/newarch/com/reactnativecommunity/webview/RNCWebViewManager.java
+index 4709e2822499067cef3a4ce571991b96f844e085..11bc92ed798f5830e0abfa3f65a4bc2098248df2 100644
+--- a/android/src/newarch/com/reactnativecommunity/webview/RNCWebViewManager.java
++++ b/android/src/newarch/com/reactnativecommunity/webview/RNCWebViewManager.java
+@@ -369,6 +369,10 @@ public class RNCWebViewManager extends ViewGroupManager<RNCWebViewWrapper>
+ @Override
+ public void setContentInset(RNCWebViewWrapper view, @Nullable ReadableMap value) {}
+
++ // iOS 26-only WebKit layout API; Android retains its existing layout.
++ @Override
++ public void setObscuredContentInsets(RNCWebViewWrapper view, @Nullable ReadableMap value) {}
++
+ @Override
+ public void setContentInsetAdjustmentBehavior(RNCWebViewWrapper view, @Nullable String value) {}
+
+diff --git a/apple/RNCWebView.mm b/apple/RNCWebView.mm
+index c0816b6320820a8586f3735b7971790cac8704fa..544752a537fd57e3bb76d44d13ce8bbf6706ee74 100644
+--- a/apple/RNCWebView.mm
++++ b/apple/RNCWebView.mm
+@@ -379,6 +379,16 @@ - (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &
+ [_view setContentInset: edgesInsets];
+ }
+
++ if (oldViewProps.obscuredContentInsets.top != newViewProps.obscuredContentInsets.top || oldViewProps.obscuredContentInsets.left != newViewProps.obscuredContentInsets.left || oldViewProps.obscuredContentInsets.right != newViewProps.obscuredContentInsets.right || oldViewProps.obscuredContentInsets.bottom != newViewProps.obscuredContentInsets.bottom) {
++ UIEdgeInsets edgesInsets = {
++ .top = newViewProps.obscuredContentInsets.top,
++ .left = newViewProps.obscuredContentInsets.left,
++ .right = newViewProps.obscuredContentInsets.right,
++ .bottom = newViewProps.obscuredContentInsets.bottom
++ };
++ [_view setObscuredContentInsets: edgesInsets];
++ }
++
+ if (oldViewProps.basicAuthCredential.username != newViewProps.basicAuthCredential.username || oldViewProps.basicAuthCredential.password != newViewProps.basicAuthCredential.password) {
+ [_view setBasicAuthCredential: @{
+ @"username": RCTNSStringFromString(newViewProps.basicAuthCredential.username),
+diff --git a/apple/RNCWebViewImpl.h b/apple/RNCWebViewImpl.h
+index 1f6bbfd697a4e0b0aef2db344386b786839a1969..c1f8ccbdef2fd47aca016fcd2ddc35a0a75dccb4 100644
+--- a/apple/RNCWebViewImpl.h
++++ b/apple/RNCWebViewImpl.h
+@@ -86,6 +86,7 @@ shouldStartLoadForRequest:(NSMutableDictionary<NSString *, id> *)request
+ @property (nonatomic, assign) BOOL bounces;
+ @property (nonatomic, assign) BOOL mediaPlaybackRequiresUserAction;
+ @property (nonatomic, assign) UIEdgeInsets contentInset;
++@property (nonatomic, assign) UIEdgeInsets obscuredContentInsets;
+ @property (nonatomic, assign) BOOL automaticallyAdjustContentInsets;
+ @property (nonatomic, assign) BOOL keyboardDisplayRequiresUserAction;
+ @property (nonatomic, assign) BOOL hideKeyboardAccessoryView;
diff --git a/apple/RNCWebViewImpl.m b/apple/RNCWebViewImpl.m
-index 7f5c24d6e2cfb26eddbc513bf17a81c24a7273e2..dedcaf5488cbf04796adad2606a698c8307d3493 100644
+index 7f5c24d6e2cfb26eddbc513bf17a81c24a7273e2..654619d783eeaccc6f581f8f8e1ccb46f179e0ca 100644
--- a/apple/RNCWebViewImpl.m
+++ b/apple/RNCWebViewImpl.m
@@ -52,6 +52,9 @@ @interface RNCWKWebView : WKWebView
@@ -96,3 +144,114 @@ index 7f5c24d6e2cfb26eddbc513bf17a81c24a7273e2..dedcaf5488cbf04796adad2606a698c8
_webView.scrollView.delegate = self;
#endif // !TARGET_OS_OSX
_webView.UIDelegate = self;
+@@ -546,6 +591,7 @@ - (void)didMoveToWindow
+
+ _webView.scrollView.directionalLockEnabled = _directionalLockEnabled;
+ #endif // !TARGET_OS_OSX
++ [self setObscuredContentInsets:_obscuredContentInsets];
+ _webView.allowsLinkPreview = _allowsLinkPreview;
+ [_webView addObserver:self forKeyPath:@"estimatedProgress" options:NSKeyValueObservingOptionOld | NSKeyValueObservingOptionNew context:nil];
+ _webView.allowsBackForwardNavigationGestures = _allowsBackForwardNavigationGestures;
+@@ -813,6 +859,21 @@ - (void)setAllowingReadAccessToURL:(NSString *)allowingReadAccessToURL
+ }
+ }
+
++// Browser chrome may overlap the WebView while WebKit positions fixed/sticky content safely.
++- (void)setObscuredContentInsets:(UIEdgeInsets)insets
++{
++ insets.top = MAX(0, insets.top);
++ insets.left = MAX(0, insets.left);
++ insets.bottom = MAX(0, insets.bottom);
++ insets.right = MAX(0, insets.right);
++ _obscuredContentInsets = insets;
++#if !TARGET_OS_OSX && defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && __IPHONE_OS_VERSION_MAX_ALLOWED >= 260000
++ if (@available(iOS 26.0, *)) {
++ _webView.obscuredContentInsets = insets;
++ }
++#endif
++}
++
+ - (void)setContentInset:(UIEdgeInsets)contentInset
+ {
+ #if !TARGET_OS_OSX
+diff --git a/apple/RNCWebViewManager.mm b/apple/RNCWebViewManager.mm
+index f8f375f23b12039b64b7900034c8978e0235a8e7..d4e55ea72f13de8565c3a1eca34d10fa8ef836f3 100644
+--- a/apple/RNCWebViewManager.mm
++++ b/apple/RNCWebViewManager.mm
+@@ -68,6 +68,7 @@ - (RNCView *)view
+ RCT_EXPORT_VIEW_PROPERTY(mediaPlaybackRequiresUserAction, BOOL)
+ RCT_EXPORT_VIEW_PROPERTY(dataDetectorTypes, WKDataDetectorTypes)
+ RCT_EXPORT_VIEW_PROPERTY(contentInset, UIEdgeInsets)
++RCT_EXPORT_VIEW_PROPERTY(obscuredContentInsets, UIEdgeInsets)
+ RCT_EXPORT_VIEW_PROPERTY(automaticallyAdjustContentInsets, BOOL)
+ RCT_EXPORT_VIEW_PROPERTY(autoManageStatusBarEnabled, BOOL)
+ RCT_EXPORT_VIEW_PROPERTY(hideKeyboardAccessoryView, BOOL)
+diff --git a/lib/RNCWebViewNativeComponent.d.ts b/lib/RNCWebViewNativeComponent.d.ts
+index 8dd6cef93c86f32c0358b5762a20d2f5f65a8cee..272e5d18e6e87ddac2b72e74de0b2548cb2b8d65 100644
+--- a/lib/RNCWebViewNativeComponent.d.ts
++++ b/lib/RNCWebViewNativeComponent.d.ts
+@@ -153,6 +153,12 @@ export interface NativeProps extends ViewProps {
+ bottom?: Double;
+ right?: Double;
+ }>;
++ obscuredContentInsets?: Readonly<{
++ top?: Double;
++ left?: Double;
++ bottom?: Double;
++ right?: Double;
++ }>;
+ contentInsetAdjustmentBehavior?: WithDefault<'never' | 'automatic' | 'scrollableAxes' | 'always', 'never'>;
+ contentMode?: WithDefault<'recommended' | 'mobile' | 'desktop', 'recommended'>;
+ dataDetectorTypes?: WithDefault<ReadonlyArray<'address' | 'link' | 'calendarEvent' | 'trackingNumber' | 'flightNumber' | 'lookupSuggestion' | 'phoneNumber' | 'all' | 'none'>, 'phoneNumber'>;
+diff --git a/lib/RNCWebViewNativeComponent.js b/lib/RNCWebViewNativeComponent.js
+index 25d09e9e702ce752832c2a3a64b34150e3f579cc..6407494e98276c144830204abc2affd79c52623a 100644
+--- a/lib/RNCWebViewNativeComponent.js
++++ b/lib/RNCWebViewNativeComponent.js
+@@ -1 +1 @@
+-var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.default=exports.__INTERNAL_VIEW_CONFIG=exports.Commands=void 0;var _codegenNativeComponent=_interopRequireDefault(require("react-native/Libraries/Utilities/codegenNativeComponent"));var _codegenNativeCommands=_interopRequireDefault(require("react-native/Libraries/Utilities/codegenNativeCommands"));var NativeComponentRegistry=require('react-native/Libraries/NativeComponent/NativeComponentRegistry');var _require=require('react-native/Libraries/NativeComponent/ViewConfigIgnore'),ConditionallyIgnoredEventHandlers=_require.ConditionallyIgnoredEventHandlers;var _require2=require("react-native/Libraries/ReactNative/RendererProxy"),dispatchCommand=_require2.dispatchCommand;var nativeComponentName='RNCWebView';var __INTERNAL_VIEW_CONFIG=exports.__INTERNAL_VIEW_CONFIG={uiViewClassName:'RNCWebView',directEventTypes:{topContentSizeChange:{registrationName:'onContentSizeChange'},topRenderProcessGone:{registrationName:'onRenderProcessGone'},topContentProcessDidTerminate:{registrationName:'onContentProcessDidTerminate'},topCustomMenuSelection:{registrationName:'onCustomMenuSelection'},topFileDownload:{registrationName:'onFileDownload'},topLoadingError:{registrationName:'onLoadingError'},topLoadingSubResourceError:{registrationName:'onLoadingSubResourceError'},topLoadingFinish:{registrationName:'onLoadingFinish'},topLoadingProgress:{registrationName:'onLoadingProgress'},topLoadingStart:{registrationName:'onLoadingStart'},topHttpError:{registrationName:'onHttpError'},topMessage:{registrationName:'onMessage'},topOpenWindow:{registrationName:'onOpenWindow'},topScroll:{registrationName:'onScroll'},topShouldStartLoadWithRequest:{registrationName:'onShouldStartLoadWithRequest'}},validAttributes:Object.assign({allowFileAccess:true,allowsProtectedMedia:true,allowsFullscreenVideo:true,androidLayerType:true,cacheMode:true,domStorageEnabled:true,downloadingMessage:true,forceDarkOn:true,geolocationEnabled:true,lackPermissionToDownloadMessage:true,messagingModuleName:true,minimumFontSize:true,mixedContentMode:true,nestedScrollEnabled:true,overScrollMode:true,saveFormDataDisabled:true,scalesPageToFit:true,setBuiltInZoomControls:true,setDisplayZoomControls:true,setSupportMultipleWindows:true,textZoom:true,thirdPartyCookiesEnabled:true,hasOnScroll:true,allowingReadAccessToURL:true,allowsBackForwardNavigationGestures:true,allowsInlineMediaPlayback:true,allowsPictureInPictureMediaPlayback:true,allowsAirPlayForMediaPlayback:true,allowsLinkPreview:true,automaticallyAdjustContentInsets:true,autoManageStatusBarEnabled:true,bounces:true,contentInset:true,contentInsetAdjustmentBehavior:true,contentMode:true,dataDetectorTypes:true,decelerationRate:true,directionalLockEnabled:true,enableApplePay:true,hideKeyboardAccessoryView:true,keyboardDisplayRequiresUserAction:true,limitsNavigationsToAppBoundDomains:true,mediaCapturePermissionGrantType:true,pagingEnabled:true,pullToRefreshEnabled:true,refreshControlLightMode:true,scrollEnabled:true,sharedCookiesEnabled:true,textInteractionEnabled:true,useSharedProcessPool:true,menuItems:true,suppressMenuItems:true,hasOnFileDownload:true,fraudulentWebsiteWarningEnabled:true,allowFileAccessFromFileURLs:true,allowUniversalAccessFromFileURLs:true,applicationNameForUserAgent:true,basicAuthCredential:true,cacheEnabled:true,incognito:true,injectedJavaScript:true,injectedJavaScriptBeforeContentLoaded:true,injectedJavaScriptForMainFrameOnly:true,injectedJavaScriptBeforeContentLoadedForMainFrameOnly:true,javaScriptCanOpenWindowsAutomatically:true,javaScriptEnabled:true,webviewDebuggingEnabled:true,mediaPlaybackRequiresUserAction:true,messagingEnabled:true,hasOnOpenWindowEvent:true,showsHorizontalScrollIndicator:true,showsVerticalScrollIndicator:true,indicatorStyle:true,newSource:true,userAgent:true,injectedJavaScriptObject:true,paymentRequestEnabled:true},ConditionallyIgnoredEventHandlers({onContentSizeChange:true,onRenderProcessGone:true,onContentProcessDidTerminate:true,onCustomMenuSelection:true,onFileDownload:true,onLoadingError:true,onLoadingSubResourceError:true,onLoadingFinish:true,onLoadingProgress:true,onLoadingStart:true,onHttpError:true,onMessage:true,onOpenWindow:true,onScroll:true,onShouldStartLoadWithRequest:true}))};var _default=exports.default=NativeComponentRegistry.get(nativeComponentName,function(){return __INTERNAL_VIEW_CONFIG;});var Commands=exports.Commands={goBack:function goBack(ref){dispatchCommand(ref,"goBack",[]);},goForward:function goForward(ref){dispatchCommand(ref,"goForward",[]);},reload:function reload(ref){dispatchCommand(ref,"reload",[]);},stopLoading:function stopLoading(ref){dispatchCommand(ref,"stopLoading",[]);},injectJavaScript:function injectJavaScript(ref,javascript){dispatchCommand(ref,"injectJavaScript",[javascript]);},requestFocus:function requestFocus(ref){dispatchCommand(ref,"requestFocus",[]);},postMessage:function postMessage(ref,data){dispatchCommand(ref,"postMessage",[data]);},loadUrl:function loadUrl(ref,url){dispatchCommand(ref,"loadUrl",[url]);},clearFormData:function clearFormData(ref){dispatchCommand(ref,"clearFormData",[]);},clearCache:function clearCache(ref,includeDiskFiles){dispatchCommand(ref,"clearCache",[includeDiskFiles]);},clearHistory:function clearHistory(ref){dispatchCommand(ref,"clearHistory",[]);}};
+\ No newline at end of file
++var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.default=exports.__INTERNAL_VIEW_CONFIG=exports.Commands=void 0;var _codegenNativeComponent=_interopRequireDefault(require("react-native/Libraries/Utilities/codegenNativeComponent"));var _codegenNativeCommands=_interopRequireDefault(require("react-native/Libraries/Utilities/codegenNativeCommands"));var NativeComponentRegistry=require('react-native/Libraries/NativeComponent/NativeComponentRegistry');var _require=require('react-native/Libraries/NativeComponent/ViewConfigIgnore'),ConditionallyIgnoredEventHandlers=_require.ConditionallyIgnoredEventHandlers;var _require2=require("react-native/Libraries/ReactNative/RendererProxy"),dispatchCommand=_require2.dispatchCommand;var nativeComponentName='RNCWebView';var __INTERNAL_VIEW_CONFIG=exports.__INTERNAL_VIEW_CONFIG={uiViewClassName:'RNCWebView',directEventTypes:{topContentSizeChange:{registrationName:'onContentSizeChange'},topRenderProcessGone:{registrationName:'onRenderProcessGone'},topContentProcessDidTerminate:{registrationName:'onContentProcessDidTerminate'},topCustomMenuSelection:{registrationName:'onCustomMenuSelection'},topFileDownload:{registrationName:'onFileDownload'},topLoadingError:{registrationName:'onLoadingError'},topLoadingSubResourceError:{registrationName:'onLoadingSubResourceError'},topLoadingFinish:{registrationName:'onLoadingFinish'},topLoadingProgress:{registrationName:'onLoadingProgress'},topLoadingStart:{registrationName:'onLoadingStart'},topHttpError:{registrationName:'onHttpError'},topMessage:{registrationName:'onMessage'},topOpenWindow:{registrationName:'onOpenWindow'},topScroll:{registrationName:'onScroll'},topShouldStartLoadWithRequest:{registrationName:'onShouldStartLoadWithRequest'}},validAttributes:Object.assign({allowFileAccess:true,allowsProtectedMedia:true,allowsFullscreenVideo:true,androidLayerType:true,cacheMode:true,domStorageEnabled:true,downloadingMessage:true,forceDarkOn:true,geolocationEnabled:true,lackPermissionToDownloadMessage:true,messagingModuleName:true,minimumFontSize:true,mixedContentMode:true,nestedScrollEnabled:true,overScrollMode:true,saveFormDataDisabled:true,scalesPageToFit:true,setBuiltInZoomControls:true,setDisplayZoomControls:true,setSupportMultipleWindows:true,textZoom:true,thirdPartyCookiesEnabled:true,hasOnScroll:true,allowingReadAccessToURL:true,allowsBackForwardNavigationGestures:true,allowsInlineMediaPlayback:true,allowsPictureInPictureMediaPlayback:true,allowsAirPlayForMediaPlayback:true,allowsLinkPreview:true,automaticallyAdjustContentInsets:true,autoManageStatusBarEnabled:true,bounces:true,contentInset:true,obscuredContentInsets:true,contentInsetAdjustmentBehavior:true,contentMode:true,dataDetectorTypes:true,decelerationRate:true,directionalLockEnabled:true,enableApplePay:true,hideKeyboardAccessoryView:true,keyboardDisplayRequiresUserAction:true,limitsNavigationsToAppBoundDomains:true,mediaCapturePermissionGrantType:true,pagingEnabled:true,pullToRefreshEnabled:true,refreshControlLightMode:true,scrollEnabled:true,sharedCookiesEnabled:true,textInteractionEnabled:true,useSharedProcessPool:true,menuItems:true,suppressMenuItems:true,hasOnFileDownload:true,fraudulentWebsiteWarningEnabled:true,allowFileAccessFromFileURLs:true,allowUniversalAccessFromFileURLs:true,applicationNameForUserAgent:true,basicAuthCredential:true,cacheEnabled:true,incognito:true,injectedJavaScript:true,injectedJavaScriptBeforeContentLoaded:true,injectedJavaScriptForMainFrameOnly:true,injectedJavaScriptBeforeContentLoadedForMainFrameOnly:true,javaScriptCanOpenWindowsAutomatically:true,javaScriptEnabled:true,webviewDebuggingEnabled:true,mediaPlaybackRequiresUserAction:true,messagingEnabled:true,hasOnOpenWindowEvent:true,showsHorizontalScrollIndicator:true,showsVerticalScrollIndicator:true,indicatorStyle:true,newSource:true,userAgent:true,injectedJavaScriptObject:true,paymentRequestEnabled:true},ConditionallyIgnoredEventHandlers({onContentSizeChange:true,onRenderProcessGone:true,onContentProcessDidTerminate:true,onCustomMenuSelection:true,onFileDownload:true,onLoadingError:true,onLoadingSubResourceError:true,onLoadingFinish:true,onLoadingProgress:true,onLoadingStart:true,onHttpError:true,onMessage:true,onOpenWindow:true,onScroll:true,onShouldStartLoadWithRequest:true}))};var _default=exports.default=NativeComponentRegistry.get(nativeComponentName,function(){return __INTERNAL_VIEW_CONFIG;});var Commands=exports.Commands={goBack:function goBack(ref){dispatchCommand(ref,"goBack",[]);},goForward:function goForward(ref){dispatchCommand(ref,"goForward",[]);},reload:function reload(ref){dispatchCommand(ref,"reload",[]);},stopLoading:function stopLoading(ref){dispatchCommand(ref,"stopLoading",[]);},injectJavaScript:function injectJavaScript(ref,javascript){dispatchCommand(ref,"injectJavaScript",[javascript]);},requestFocus:function requestFocus(ref){dispatchCommand(ref,"requestFocus",[]);},postMessage:function postMessage(ref,data){dispatchCommand(ref,"postMessage",[data]);},loadUrl:function loadUrl(ref,url){dispatchCommand(ref,"loadUrl",[url]);},clearFormData:function clearFormData(ref){dispatchCommand(ref,"clearFormData",[]);},clearCache:function clearCache(ref,includeDiskFiles){dispatchCommand(ref,"clearCache",[includeDiskFiles]);},clearHistory:function clearHistory(ref){dispatchCommand(ref,"clearHistory",[]);}};
+\ No newline at end of file
+diff --git a/lib/WebViewTypes.d.ts b/lib/WebViewTypes.d.ts
+index 998cc88f03f3fbcd0a47f227c01f738dbf4c58bf..d5f2ad0462d35b4ff20d707fb309284f3113ea5c 100644
+--- a/lib/WebViewTypes.d.ts
++++ b/lib/WebViewTypes.d.ts
+@@ -322,6 +322,8 @@ export interface IOSWebViewProps extends WebViewSharedProps {
+ * "never". Available on iOS 11 and later.
+ */
+ contentInsetAdjustmentBehavior?: ContentInsetAdjustmentBehavior;
++ /** iOS 26+: overlapping browser chrome; WebKit adjusts fixed/sticky layout. Defaults to zero. */
++ obscuredContentInsets?: ContentInsetProp;
+ /**
+ * The amount by which the web view content is inset from the edges of
+ * the scroll view. Defaults to {top: 0, left: 0, bottom: 0, right: 0}.
+diff --git a/src/RNCWebViewNativeComponent.ts b/src/RNCWebViewNativeComponent.ts
+index 7f4e6c4f73506efa9517314a3ff89f91b097763e..a6f8afd006c7334dd9792263c6f208af033461e2 100644
+--- a/src/RNCWebViewNativeComponent.ts
++++ b/src/RNCWebViewNativeComponent.ts
+@@ -194,6 +194,12 @@ export interface NativeProps extends ViewProps {
+ bottom?: Double;
+ right?: Double;
+ }>;
++ obscuredContentInsets?: Readonly<{
++ top?: Double;
++ left?: Double;
++ bottom?: Double;
++ right?: Double;
++ }>;
+ contentInsetAdjustmentBehavior?: WithDefault<
+ 'never' | 'automatic' | 'scrollableAxes' | 'always',
+ 'never'
+diff --git a/src/WebViewTypes.ts b/src/WebViewTypes.ts
+index eca81415ab48676da18fc2be13b84e60fe5cb3f5..e01e4c6cd9a2a79f5654e98b0a7d56c0e830f298 100644
+--- a/src/WebViewTypes.ts
++++ b/src/WebViewTypes.ts
+@@ -455,6 +455,8 @@ export interface IOSWebViewProps extends WebViewSharedProps {
+ * "never". Available on iOS 11 and later.
+ */
+ contentInsetAdjustmentBehavior?: ContentInsetAdjustmentBehavior;
++ /** iOS 26+: overlapping browser chrome; WebKit adjusts fixed/sticky layout. Defaults to zero. */
++ obscuredContentInsets?: ContentInsetProp;
+
+ /**
+ * The amount by which the web view content is inset from the edges of
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index a3b6f1db4f..66e24fd29f 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -9,7 +9,7 @@
本区块由 `scripts/design-inventory.mjs` 生成,请勿手改。
重新生成:`pnpm design:inventory`;校验:`pnpm check:design-inventory`。
-计数快照日期:2026-09-19。生成命令:`pnpm design:inventory`。裸颜色匹配与 `scripts/hardcoded-color-audit.mjs` 共用 `scripts/shared/hardcoded-color-match.mjs`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(`rounded*` class、`border-radius:` 与 React style 对象的 `borderRadius:`)。Token 计数为样式源里 `var(--token)` / `hsl(var(--token)` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。
+计数快照日期:2026-09-20。生成命令:`pnpm design:inventory`。裸颜色匹配与 `scripts/hardcoded-color-audit.mjs` 共用 `scripts/shared/hardcoded-color-match.mjs`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(`rounded*` class、`border-radius:` 与 React style 对象的 `borderRadius:`)。Token 计数为样式源里 `var(--token)` / `hsl(var(--token)` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。
登记 surface 数:50。平台包含 Desktop 与 Mobile;静态入口发现不表示已迁移或已实机验证。
@@ -59,7 +59,7 @@
| `mobile.companions.direct` | mobile | 伙伴私聊回看 | app/companions/direct/[threadId].tsx | AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, HomeEntryProvider, HomeNativeStackHeader, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, [threadId], _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/companions/direct/[threadId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 170 | 50 |
| `mobile.device-management` | mobile | 设备管理 | app/devices/manage.tsx / app/devices/manage/[deviceId].tsx | AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceInformationFields, DeviceInformationFields.ios, DeviceLinkContext, DeviceManagementDialogs, DeviceManagementList, DeviceManagementList.ios, HomeEntryProvider, HomeNativeStackHeader, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RenameDeviceModal, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, [deviceId], _layout, gestureHandler, manage, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/devices/manage.tsx, apps/mobile/app/devices/manage/[deviceId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceInformationFields.ios.tsx, apps/mobile/src/device-link/DeviceInformationFields.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/DeviceManagementDialogs.tsx, apps/mobile/src/device-link/DeviceManagementList.ios.tsx, apps/mobile/src/device-link/DeviceManagementList.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/RenameDeviceModal.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 170 | 53 |
| `mobile.devices` | mobile | 主机详情 | app/devices/[deviceId].tsx | AccountSwitcherSheet, AndroidUpdateSheet, AppText, AuthContext, AutomationTimerIcon, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, ConversationSearchFilterSheet, DeviceLinkContext, HomeChromeDrawer, HomeChromeFrost, HomeEntryProvider, HomeGlassMenuPanel, HomeHeaderGlassButton, HomeNativeStackHeader, HomeProjectMachineLabel, HomeSearchBar, IncomingShareBridge, MobileAgentMark, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, MobileVendorIcon, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteAccessGuide, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteTaskSuggestions, RenameSessionModal, SessionActionSheet, SessionHeaderNativeControls, SessionHeaderNativeControls.ios, SessionOptionsExpoSheet, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, SwipeableSessionRow, SwipeableSessionRow.ios, ThemeProvider, [deviceId], _layout, gestureHandler, index, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/devices/[deviceId].tsx, apps/mobile/app/devices/index.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileAgentMark.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/MobileVendorIcon.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/RemoteAccessGuide.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/AccountSwitcherSheet.tsx, apps/mobile/src/session/AutomationTimerIcon.tsx, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/ConversationSearchFilterSheet.tsx, apps/mobile/src/session/HomeChromeDrawer.tsx, apps/mobile/src/session/HomeChromeFrost.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeGlassMenuPanel.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/HomeProjectMachineLabel.tsx, apps/mobile/src/session/HomeSearchBar.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/RemoteTaskSuggestions.tsx, apps/mobile/src/session/RenameSessionModal.tsx, apps/mobile/src/session/SessionActionSheet.tsx, apps/mobile/src/session/SessionHeaderNativeControls.ios.tsx, apps/mobile/src/session/SessionHeaderNativeControls.tsx, apps/mobile/src/session/SessionOptionsExpoSheet.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/SwipeableSessionRow.ios.tsx, apps/mobile/src/session/SwipeableSessionRow.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 170 | 96 |
-| `mobile.files` | mobile | 任务文件与预览 | app/files/[sessionId].tsx / app/files/preview/[sessionId].tsx | AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, HomeEntryProvider, HtmlFileReader, ImageLightbox, IncomingShareBridge, MarkdownFileReader, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, SheetModal, SheetSurface, StartupSplashOverlay, ThemeProvider, [sessionId], _layout, gestureHandler, mediaPlayerWebView, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/files/[sessionId].tsx, apps/mobile/app/files/preview/[sessionId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HtmlFileReader.tsx, apps/mobile/src/session/ImageLightbox.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MarkdownFileReader.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/mathWebViewHtml.ts, apps/mobile/src/session/mediaPlayerWebView.tsx, apps/mobile/src/session/mediaPlayerWebViewHtml.ts, apps/mobile/src/session/selectableMarkdownHtml.ts, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 202 | 71 |
+| `mobile.files` | mobile | 任务文件与预览 | app/files/[sessionId].tsx / app/files/preview/[sessionId].tsx | AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, HomeEntryProvider, HtmlBrowserChrome, HtmlBrowserChrome.ios, HtmlFileReader, HtmlWebsiteBrowser, ImageLightbox, IncomingShareBridge, MarkdownFileReader, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, SheetModal, SheetSurface, StartupSplashOverlay, ThemeProvider, [sessionId], _layout, gestureHandler, mediaPlayerWebView, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/files/[sessionId].tsx, apps/mobile/app/files/preview/[sessionId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HtmlBrowserChrome.ios.tsx, apps/mobile/src/session/HtmlBrowserChrome.tsx, apps/mobile/src/session/HtmlFileReader.tsx, apps/mobile/src/session/HtmlWebsiteBrowser.tsx, apps/mobile/src/session/ImageLightbox.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MarkdownFileReader.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/mathWebViewHtml.ts, apps/mobile/src/session/mediaPlayerWebView.tsx, apps/mobile/src/session/mediaPlayerWebViewHtml.ts, apps/mobile/src/session/selectableMarkdownHtml.ts, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 202 | 77 |
| `mobile.home` | mobile | 主机与资源首页 | app/index.tsx / app/devices/index.tsx | AccountSwitcherSheet, AndroidUpdateSheet, AppText, AuthContext, AutomationTimerIcon, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, ConversationSearchFilterSheet, DeviceLinkContext, HomeChromeDrawer, HomeChromeFrost, HomeEntryProvider, HomeGlassMenuPanel, HomeHeaderGlassButton, HomeNativeStackHeader, HomeProjectMachineLabel, HomeSearchBar, IncomingShareBridge, MobileAgentMark, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, MobileVendorIcon, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteAccessGuide, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteTaskSuggestions, RenameSessionModal, SessionActionSheet, SessionHeaderNativeControls, SessionHeaderNativeControls.ios, SessionOptionsExpoSheet, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, SwipeableSessionRow, SwipeableSessionRow.ios, ThemeProvider, _layout, gestureHandler, index, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/devices/index.tsx, apps/mobile/app/index.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileAgentMark.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/MobileVendorIcon.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/RemoteAccessGuide.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/AccountSwitcherSheet.tsx, apps/mobile/src/session/AutomationTimerIcon.tsx, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/ConversationSearchFilterSheet.tsx, apps/mobile/src/session/HomeChromeDrawer.tsx, apps/mobile/src/session/HomeChromeFrost.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeGlassMenuPanel.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/HomeProjectMachineLabel.tsx, apps/mobile/src/session/HomeSearchBar.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/RemoteTaskSuggestions.tsx, apps/mobile/src/session/RenameSessionModal.tsx, apps/mobile/src/session/SessionActionSheet.tsx, apps/mobile/src/session/SessionHeaderNativeControls.ios.tsx, apps/mobile/src/session/SessionHeaderNativeControls.tsx, apps/mobile/src/session/SessionOptionsExpoSheet.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/SwipeableSessionRow.ios.tsx, apps/mobile/src/session/SwipeableSessionRow.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 170 | 92 |
| `mobile.overlay.connection-startup` | mobile | 根布局挂载的启动与连接反馈 | app/_layout.tsx → StartupSplashOverlay / ConnectionNoticeProvider;各页面 ConnectionBanner | AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ConnectionNoticeProvider, ContextSheet, ContextSheet.ios, DeviceLinkContext, HomeEntryProvider, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, SheetModal, SheetSurface, StartupSplashOverlay, ThemeProvider, _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 170 | 48 |
| `mobile.remote-desktop` | mobile | 远程桌面 | app/devices/desktop/[deviceId].tsx | AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, HomeEntryProvider, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobilePrimitives, NativePullDownMenu, NativeRemoteDesktopView, NativeSwitch, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, SheetModal, SheetSurface, StartupSplashOverlay, ThemeProvider, [deviceId], _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/devices/desktop/[deviceId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 170 | 48 |
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 38bc0eb4b5..dd2aa7cdb9 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -35,7 +35,7 @@ patchedDependencies:
hash: d6eb1ea155bf2245746f79c5d2cc7c5abe165c34e55c464e04d641a78888cda0
path: dependency-patches/[email protected]
- hash: 4f76ca2497d14d136ef6ff35060f4c35b57319a3edf53fa334b82771a9405c16
+ hash: c4e335ad426e4028c24ae12915857a01c4eeb7e6e2ea00efdc07dbb7bffa56f0
path: dependency-patches/[email protected]
hash: 9442031604caa9cd185e0b2be6867055459fc3a6d2781296027989db098f972d
@@ -640,7 +640,7 @@ importers:
version: 2.0.4
expo:
specifier: ~57.0.23
expo-apple-authentication:
specifier: ~57.0.1
@@ -769,7 +769,7 @@ importers:
react-native-webview:
specifier: 13.16.1
- version: 13.16.1(patch_hash=4f76ca2497d14d136ef6ff35060f4c35b57319a3edf53fa334b82771a9405c16)([email protected](@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected]))([email protected])
+ version: 13.16.1(patch_hash=c4e335ad426e4028c24ae12915857a01c4eeb7e6e2ea00efdc07dbb7bffa56f0)([email protected](@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected]))([email protected])
react-native-worklets:
specifier: 0.10.1
@@ -13049,7 +13049,7 @@ snapshots:
connect: 3.7.0
debug: 4.4.3
dnssd-advertise: 1.1.6
expo-server: 57.0.3
fetch-nodeshim: 0.4.10
getenv: 2.0.0
@@ -13148,7 +13148,7 @@ snapshots:
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -13223,7 +13223,7 @@ snapshots:
dependencies:
anser: 1.4.10
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
stacktrace-parser: 0.1.11
@@ -13254,7 +13254,7 @@ snapshots:
postcss: 8.5.28
resolve-from: 5.0.0
optionalDependencies:
transitivePeerDependencies:
- bufferutil
- supports-color
@@ -13276,7 +13276,7 @@ snapshots:
dependencies:
anser: 1.4.10
pretty-format: 29.7.0
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -13354,7 +13354,7 @@ snapshots:
dependencies:
debug: 4.4.3
expo-server: 57.0.3
@@ -13378,7 +13378,7 @@ snapshots:
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
sf-symbols-typescript: 2.2.0
@@ -14765,7 +14765,7 @@ snapshots:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
optionalDependencies:
dependencies:
@@ -16315,7 +16315,7 @@ snapshots:
react-refresh: 0.14.2
optionalDependencies:
'@babel/runtime': 7.29.7
transitivePeerDependencies:
- '@babel/core'
- supports-color
@@ -17785,18 +17785,18 @@ snapshots:
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
dependencies:
'@expo/image-utils': 0.11.5([email protected])
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -17806,7 +17806,7 @@ snapshots:
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -17827,27 +17827,27 @@ snapshots:
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
'@expo/schema-utils': 57.0.2
resolve-from: 5.0.0
semver: 7.8.5
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
'@expo/env': 2.4.2
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
transitivePeerDependencies:
- supports-color
@@ -17855,68 +17855,68 @@ snapshots:
dependencies:
'@expo/env': 2.4.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
transitivePeerDependencies:
- supports-color
dependencies:
dependencies:
dependencies:
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
fontfaceobserver: 2.3.0
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
fontfaceobserver: 2.3.0
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
[email protected](patch_hash=78594ca2235bdbbee2665f37b86d4e1e892733c4f9bd38fa7085338b90486e2b)([email protected]):
dependencies:
expo-image-loader: 57.0.1([email protected])
dependencies:
expo-image-loader: 57.0.1([email protected])
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
sf-symbols-typescript: 2.2.0
@@ -17927,7 +17927,7 @@ snapshots:
dependencies:
react: 19.2.3
@@ -17942,18 +17942,18 @@ snapshots:
dependencies:
react: 19.2.3
rtl-detect: 1.1.2
dependencies:
expo-json-utils: 57.0.1
dependencies:
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -17982,7 +17982,7 @@ snapshots:
dependencies:
react: 19.2.3
@@ -17990,7 +17990,7 @@ snapshots:
'@expo/image-utils': 0.11.5([email protected])
abort-controller: 3.0.0
badgin: 1.2.3
expo-application: 57.0.2([email protected])
react: 19.2.3
@@ -18001,7 +18001,7 @@ snapshots:
[email protected](patch_hash=53be555646735a171c1624f074ef30e5ca897a7b8893724bc2d0d51682f769d8)([email protected])([email protected](@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected]))([email protected]):
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -18018,7 +18018,7 @@ snapshots:
color: 4.2.3
debug: 4.4.3
escape-string-regexp: 4.0.0
@@ -18055,7 +18055,7 @@ snapshots:
dependencies:
@@ -18064,7 +18064,7 @@ snapshots:
'@expo/config-plugins': 57.0.9([email protected])
'@expo/config-types': 57.0.2
'@expo/plist': 0.8.1
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
transitivePeerDependencies:
@@ -18075,7 +18075,7 @@ snapshots:
dependencies:
'@expo/config-plugins': 57.0.9([email protected])
'@expo/image-utils': 0.11.5([email protected])
xml2js: 0.6.0
transitivePeerDependencies:
- supports-color
@@ -18083,7 +18083,7 @@ snapshots:
dependencies:
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -18092,7 +18092,7 @@ snapshots:
dependencies:
'@expo-google-fonts/material-symbols': 0.4.40
react: 19.2.3
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
@@ -18100,7 +18100,7 @@ snapshots:
dependencies:
dependencies:
@@ -18110,7 +18110,7 @@ snapshots:
arg: 4.1.3
chalk: 4.1.2
debug: 4.4.3
expo-eas-client: 57.0.2
expo-manifests: 57.0.1([email protected])
expo-structured-headers: 57.0.0
@@ -18127,10 +18127,10 @@ snapshots:
dependencies:
react-native: 0.86.3(@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected])
dependencies:
'@babel/runtime': 7.29.7
@@ -18161,7 +18161,7 @@ snapshots:
react-dom: 19.2.3([email protected])
- react-native-webview: 13.16.1(patch_hash=4f76ca2497d14d136ef6ff35060f4c35b57319a3edf53fa334b82771a9405c16)([email protected](@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected]))([email protected])
+ react-native-webview: 13.16.1(patch_hash=c4e335ad426e4028c24ae12915857a01c4eeb7e6e2ea00efdc07dbb7bffa56f0)([email protected](@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected]))([email protected])
transitivePeerDependencies:
- '@babel/core'
- bufferutil
@@ -21255,7 +21255,7 @@ snapshots:
transitivePeerDependencies:
- encoding
- [email protected](patch_hash=4f76ca2497d14d136ef6ff35060f4c35b57319a3edf53fa334b82771a9405c16)([email protected](@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected]))([email protected]):
+ [email protected](patch_hash=c4e335ad426e4028c24ae12915857a01c4eeb7e6e2ea00efdc07dbb7bffa56f0)([email protected](@babel/[email protected])(@react-native/[email protected](@babel/[email protected]))(@types/[email protected])([email protected]))([email protected]):
dependencies:
escape-string-regexp: 4.0.0
invariant: 2.2.4
@@ -22954,7 +22954,7 @@ snapshots:
dependencies:
xdt-mobile-realtime-audio@file:apps/mobile/modules/xdt-mobile-realtime-audio: {}
@@ -22963,12 +22963,12 @@ snapshots:
dependencies:
dependencies: