@onekeyfe/react-native-native-list 3.0.105 → 3.0.106

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_bot_illus.imageset/icon.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor">
+    <path
+      fill="#8897A5"
+      d="M11 2a1 1 0 1 1 2 0v1.8l1.6 1.6a1 1 0 1 1-1.4 1.4L12 5.6l-1.2 1.2a1 1 0 0 1-1.4-1.4L11 3.8z"
+    />
+    <rect width="18" height="14" x="3" y="6" fill="#3FA9F5" rx="5" />
+    <rect width="3" height="6" x="1.5" y="10" fill="#8897A5" rx="1.5" />
+    <rect width="3" height="6" x="19.5" y="10" fill="#8897A5" rx="1.5" />
+    <circle cx="9" cy="12" r="1.5" fill="#10243E" />
+    <circle cx="15" cy="12" r="1.5" fill="#10243E" />
+    <path
+      fill="#10243E"
+      d="M8.5 15.4c.9.8 2.08 1.2 3.5 1.2s2.6-.4 3.5-1.2c.24-.2.6-.18.8.06.2.23.17.6-.06.8-1.14.98-2.58 1.46-4.24 1.46s-3.1-.48-4.24-1.46a.58.58 0 0 1-.06-.8c.2-.24.56-.26.8-.06"
+    />
+  </svg>

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_crossed_small_solid.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images": [
+    {
+      "filename": "icon.svg",
+      "idiom": "universal"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_crossed_small_solid.imageset/icon.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor">
+    <path d="M17.87 8.25 14.12 12l3.75 3.75-2.12 2.121-3.75-3.75-3.75 3.75-2.121-2.121L9.879 12l-3.75-3.75 2.12-2.121L12 9.879l3.75-3.75 2.122 2.121Z" />
+  </svg>

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_globus_outline.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images": [
+    {
+      "filename": "icon.svg",
+      "idiom": "universal"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_globus_outline.imageset/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor">
+    <path
+      fill-rule="evenodd"
+      d="M12 2c5.185 0 9.448 3.947 9.95 9H22v2h-.05c-.502 5.053-4.765 9-9.95 9s-9.448-3.947-9.95-9H2v-2h.05C2.552 5.947 6.815 2 12 2M9.523 13c.09 1.982.438 3.726.934 5.002.29.746.612 1.282.917 1.614.304.331.517.384.626.384s.322-.053.626-.384c.305-.332.627-.868.917-1.614.496-1.276.845-3.02.934-5.002zm-5.459 0a8 8 0 0 0 4.8 6.36 10 10 0 0 1-.271-.633C7.994 17.187 7.61 15.189 7.52 13zm12.416 0c-.09 2.189-.474 4.187-1.073 5.727a10 10 0 0 1-.271.633 8 8 0 0 0 4.8-6.36zM8.863 4.639A8 8 0 0 0 4.064 11h3.457c.09-2.189.473-4.187 1.072-5.727q.127-.327.27-.634M12 4c-.109 0-.322.053-.626.384-.305.332-.627.868-.917 1.614-.496 1.276-.844 3.02-.934 5.002h4.954c-.09-1.982-.438-3.726-.934-5.002-.29-.746-.612-1.282-.917-1.614C12.322 4.053 12.109 4 12 4m3.136.639q.144.307.271.634c.599 1.54.982 3.538 1.073 5.727h3.456a8 8 0 0 0-4.8-6.361"
+      clip-rule="evenodd"
+    />
+  </svg>

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_google_illus.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images": [
+    {
+      "filename": "icon.svg",
+      "idiom": "universal"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_google_illus.imageset/icon.svg

@@ -0,0 +1,18 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor">
+    <path
+      fill="#4285F4"
+      d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09"
+    />
+    <path
+      fill="#34A853"
+      d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23"
+    />
+    <path
+      fill="#FBBC05"
+      d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22z"
+    />
+    <path
+      fill="#EA4335"
+      d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53"
+    />
+  </svg>

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_lock_solid.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images": [
+    {
+      "filename": "icon.svg",
+      "idiom": "universal"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}

package/ios/Resources/NativeListIcons.xcassets/onekey_selector_lock_solid.imageset/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor">
+    <path
+      fill-rule="evenodd"
+      d="M12 2a5 5 0 0 1 5 5v2h3v13H4V9h3V7a5 5 0 0 1 5-5m-1 11v5h2v-5zm1-9a3 3 0 0 0-3 3v2h6V7a3 3 0 0 0-3-3"
+      clip-rule="evenodd"
+    />
+  </svg>

package/lib/module/NativeList.js

@@ -1,9 +1,12 @@
 "use strict";
 
-import React, { forwardRef, useImperativeHandle, useMemo, useRef } from 'react';
+import React, { forwardRef, useEffect, useImperativeHandle, useMemo, useRef } from 'react';
+import { OneKeyImageCache, OneKeyImageCachePolicy } from '@onekeyfe/react-native-image';
+import { NativeAvatarPrefetchModel, NativeAvatarPrefetchQueue } from "./avatarPrefetch.js";
 import { callback, getHostComponent } from 'react-native-nitro-modules';
+import { isSelectableRow } from "./selection.js";
 import { normalizeIndexScroll, normalizeKeyScroll, normalizePositionScroll, resolveLocationIndex, scrollFailure, validateOffset } from "./scrolling.js";
-import { serializePatches, serializeSnapshot } from "./validation.js";
+import { applyRowPatches, serializePatches, serializeSnapshot } from "./validation.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const NativeListConfig = require('../nitrogen/generated/shared/json/NativeListConfig.json');
 const NativeListHost = getHostComponent('NativeList', () => NativeListConfig);
@@ -48,8 +51,52 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
     onRefresh,
     onScrollToIndexFailed
   };
+  const snapshotJson = useMemo(() => serializeSnapshot(snapshot), [snapshot]);
   const snapshotRef = useRef(snapshot);
-  snapshotRef.current = snapshot;
+  const previousSnapshotJsonRef = useRef(snapshotJson);
+  const snapshotChanged = previousSnapshotJsonRef.current !== snapshotJson;
+  if (snapshotChanged) {
+    snapshotRef.current = snapshot;
+    previousSnapshotJsonRef.current = snapshotJson;
+  }
+  // OneKey patch: range events already cross the bridge only when row indices
+  // change. Prefetch is optional work; scrolling and visible loads stay native.
+  const avatarQueueRef = useRef(null);
+  const avatarRangeRef = useRef(undefined);
+  // OneKey patch: a changed prop is a complete snapshot; unrelated renders must
+  // not erase image patches already dispatched through the imperative handle.
+  // const avatarPrefetchPaused = useRef(false);
+  const avatarModelRef = useRef(null);
+  const avatarLifecycle = useRef('pending');
+  if (!avatarModelRef.current) avatarModelRef.current = new NativeAvatarPrefetchModel(snapshot.rows);else if (snapshotChanged) avatarModelRef.current.replaceSnapshot(snapshot.rows);
+  const updateAvatarPrefetch = () => {
+    const range = avatarRangeRef.current;
+    if (!range) return;
+    avatarQueueRef.current?.update(avatarModelRef.current?.window(range.first, range.last, range.direction) ?? []);
+  };
+  const updateAvatarPrefetchRef = useRef(updateAvatarPrefetch);
+  updateAvatarPrefetchRef.current = updateAvatarPrefetch;
+  useEffect(() => {
+    avatarLifecycle.current = 'mounted';
+    const queue = new NativeAvatarPrefetchQueue(source => OneKeyImageCache.preload([{
+      uri: source.uri,
+      headers: source.headers,
+      resizeWidth: source.width,
+      resizeHeight: source.height,
+      optimizeTos: false,
+      cachePolicy: source.cachePolicy === 'memory' ? OneKeyImageCachePolicy.MEMORY : source.cachePolicy === 'disk' ? OneKeyImageCachePolicy.DISK : OneKeyImageCachePolicy.MEMORY_DISK
+    }]));
+    avatarQueueRef.current = queue;
+    updateAvatarPrefetchRef.current();
+    return () => {
+      queue.dispose();
+      avatarQueueRef.current = null;
+      avatarLifecycle.current = 'unmounted';
+    };
+  }, []);
+  useEffect(() => {
+    updateAvatarPrefetchRef.current();
+  }, [snapshot]);
   const initialScrollRef = useRef(initialScrollIndex === undefined && initialScrollKey === undefined ? undefined : initialScrollIndex !== undefined ? normalizeIndexScroll({
     index: initialScrollIndex,
     animated: false,
@@ -64,7 +111,6 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
     }, 'start')
   });
   const didApplyInitialScroll = useRef(false);
-  const snapshotJson = useMemo(() => serializeSnapshot(snapshot), [snapshot]);
   const emitIndexFailure = (index, reason) => {
     callbacksRef.current.onScrollToIndexFailed?.(scrollFailure(snapshotRef.current.rows, index, reason));
   };
@@ -89,14 +135,40 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
   applyInitialScrollCallbackRef.current = applyInitialScroll;
   useImperativeHandle(forwardedRef, () => ({
     applySnapshot(nextSnapshot) {
+      const nextSnapshotJson = serializeSnapshot(nextSnapshot);
+      nativeRef.current?.applySnapshot(nextSnapshotJson);
       snapshotRef.current = nextSnapshot;
-      nativeRef.current?.applySnapshot(serializeSnapshot(nextSnapshot));
+      if (nativeRef.current && avatarLifecycle.current !== 'unmounted') {
+        avatarModelRef.current?.replaceSnapshot(nextSnapshot.rows);
+        updateAvatarPrefetchRef.current();
+      }
     },
     applyPatches(patches) {
-      if (patches.length > 0) nativeRef.current?.applyPatches(serializePatches(patches));
+      if (patches.length === 0) return;
+      const nextSnapshot = applyRowPatches(snapshotRef.current, patches);
+      const native = nativeRef.current;
+      const dispatch = native ? () => {
+        native.applyPatches(serializePatches(patches));
+        snapshotRef.current = nextSnapshot;
+      } : undefined;
+      if (avatarLifecycle.current === 'unmounted') {
+        dispatch?.();
+        return;
+      }
+      if (avatarModelRef.current?.applyPatches(patches, dispatch)) updateAvatarPrefetchRef.current();
     },
     reconcileSelection(selectedKeys) {
       nativeRef.current?.reconcileSelection(JSON.stringify(selectedKeys));
+      const current = snapshotRef.current;
+      if (current.selection && (current.selection.mode !== 'single' || selectedKeys.length <= 1) && selectedKeys.every(key => current.rows.some(row => row.key === key && isSelectableRow(row)))) {
+        snapshotRef.current = {
+          ...current,
+          selection: {
+            ...current.selection,
+            selectedKeys
+          }
+        };
+      }
     },
     scrollToKey(paramsOrKey, animated, alignment) {
       const {
@@ -162,7 +234,21 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
       callbacksRef.current.onActionAnchorInvalidated?.(parsePayload(payloadJson));
     }),
     onSelectionDelta: callback(payloadJson => {
-      callbacksRef.current.onSelectionDelta?.(parsePayload(payloadJson));
+      const payload = parsePayload(payloadJson);
+      const current = snapshotRef.current;
+      if (current.selection) {
+        const selectedKeys = new Set(current.selection.selectedKeys);
+        payload.removedKeys.forEach(key => selectedKeys.delete(key));
+        payload.addedKeys.forEach(key => selectedKeys.add(key));
+        snapshotRef.current = {
+          ...current,
+          selection: {
+            ...current.selection,
+            selectedKeys: [...selectedKeys]
+          }
+        };
+      }
+      callbacksRef.current.onSelectionDelta?.(payload);
     }),
     onReorder: callback(payloadJson => {
       callbacksRef.current.onReorder?.(parsePayload(payloadJson));
@@ -171,7 +257,15 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
       callbacksRef.current.onEndReached?.(parsePayload(payloadJson));
     }),
     onVisibleRangeChanged: callback(payloadJson => {
-      callbacksRef.current.onVisibleRangeChanged?.(parsePayload(payloadJson));
+      const payload = parsePayload(payloadJson);
+      const previous = avatarRangeRef.current;
+      avatarRangeRef.current = {
+        first: payload.firstIndex,
+        last: payload.lastIndex,
+        direction: previous && payload.firstIndex !== previous.first ? Math.sign(payload.firstIndex - previous.first) : previous?.direction ?? 1
+      };
+      updateAvatarPrefetchRef.current();
+      callbacksRef.current.onVisibleRangeChanged?.(payload);
     })
   }), []);
   return /*#__PURE__*/_jsx(NativeListHost, {

package/lib/module/NativeList.web.js

@@ -29,7 +29,14 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
   webVirtualizationEnabledRef.current = webVirtualizationEnabled;
   const validatedSnapshot = useMemo(() => validateSnapshot(snapshot), [snapshot]);
   const snapshotRef = useRef(validatedSnapshot);
-  snapshotRef.current = validatedSnapshot;
+  const snapshotPropRef = useRef(validatedSnapshot);
+  // An imperative snapshot survives host mounting until the snapshot prop changes.
+  if (snapshotPropRef.current !== validatedSnapshot) {
+    snapshotPropRef.current = validatedSnapshot;
+    snapshotRef.current = validatedSnapshot;
+  }
+  // OneKey patch: React refs can be ready before the DOM engine is mounted.
+  const pendingPatchesRef = useRef(undefined);
   const appliedSnapshotRef = useRef(undefined);
   const callbacksRef = useRef({});
   callbacksRef.current = {
@@ -61,6 +68,9 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
     const engine = new NativeListWebEngine(host, snapshotRef.current, callbacksRef.current, webVirtualizationEnabledRef.current);
     engineRef.current = engine;
     appliedSnapshotRef.current = snapshotRef.current;
+    const pending = pendingPatchesRef.current;
+    pendingPatchesRef.current = undefined;
+    if (pending?.snapshot === snapshotRef.current) pending.batches.forEach(patches => engine.applyPatches(patches));
     const initial = initialScrollRef.current;
     if (initial && !didApplyInitialScroll.current) {
       didApplyInitialScroll.current = true;
@@ -89,6 +99,7 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
   useImperativeHandle(forwardedRef, () => ({
     applySnapshot(nextSnapshot) {
       const next = validateSnapshot(nextSnapshot);
+      pendingPatchesRef.current = undefined;
       snapshotRef.current = next;
       appliedSnapshotRef.current = next;
       engineRef.current?.applySnapshot(next);
@@ -96,7 +107,14 @@ export const NativeList = /*#__PURE__*/forwardRef(function NativeList({
     applyPatches(patches) {
       if (patches.length > 0) {
         serializePatches(patches);
-        engineRef.current?.applyPatches(patches);
+        // engineRef.current?.applyPatches(patches);
+        if (engineRef.current) engineRef.current.applyPatches(patches);else {
+          if (pendingPatchesRef.current?.snapshot !== snapshotRef.current) pendingPatchesRef.current = {
+            snapshot: snapshotRef.current,
+            batches: []
+          };
+          pendingPatchesRef.current.batches.push(patches);
+        }
       }
     },
     reconcileSelection(selectedKeys) {

package/lib/module/avatarPrefetch.js

@@ -0,0 +1,174 @@
+"use strict";
+
+// OneKey patch: share a bounded URI-only window across renderers. No bitmap or
+// account-specific data enters list snapshots or the UI runtime.
+
+const PREFIX = 'onekey-avatar://blockie/v1/';
+const MAX_CANDIDATES = 64;
+const IMAGE_PATCH_FIELDS = ['leading', 'secondaryLeading', 'image', 'networkImage', 'thumbnail', 'visual'];
+export function avatarPrefetchWindow(rows, first, last, direction, resolveRow) {
+  if (first < 0 || last < first || first >= rows.length) return [];
+  last = Math.min(last, rows.length - 1);
+  const result = [];
+  const seen = new Set();
+  let limit = MAX_CANDIDATES;
+  const add = (source, priority) => {
+    if (!source?.uri.startsWith(PREFIX) || source.cachePolicy === 'none' || seen.has(source.uri) || result.length >= limit) return;
+    seen.add(source.uri);
+    result.push({
+      source,
+      priority
+    });
+  };
+  const visual = (value, priority) => {
+    if (!value) return;
+    if ('image' in value) add(value.image, priority);
+    if ('networkImage' in value) add(value.networkImage, priority);
+    if ('images' in value) value.images.forEach(image => add(image, priority));
+    if ('overlays' in value) value.overlays?.forEach(overlay => add(overlay.image, priority));
+  };
+  const row = (value, priority) => {
+    value = resolveRow?.(value) ?? value;
+    if ('leading' in value) visual(value.leading, priority);
+    if ('secondaryLeading' in value) visual(value.secondaryLeading, priority);
+    if ('image' in value) add(value.image, priority);
+    if ('networkImage' in value) add(value.networkImage, priority);
+    if ('thumbnail' in value) add(value.thumbnail, priority);
+    if (value.type === 'walletGroup') {
+      visual(value.parent.leading, priority);
+      for (const child of value.children.slice(0, MAX_CANDIDATES)) {
+        if (result.length >= limit) break;
+        visual(child.leading, priority);
+      }
+    }
+  };
+  // Bound row examination too: a giant non-avatar group must not scan all data.
+  for (let index = first; index <= last && index < first + 64; index += 1) row(rows[index], 0);
+  const span = Math.min(24, (last - first + 1) * 2);
+  const step = direction < 0 ? -1 : 1;
+  const aheadStart = step > 0 ? last + 1 : first - 1;
+  const aheadLimit = Math.min(MAX_CANDIDATES, result.length + 24);
+  limit = aheadLimit;
+  for (let distance = 0; distance < span && result.length < aheadLimit; distance += 1) {
+    const index = aheadStart + distance * step;
+    if (index < 0 || index >= rows.length) break;
+    row(rows[index], 1);
+  }
+  const behindStart = step > 0 ? first - 1 : last + 1;
+  const behindLimit = Math.min(MAX_CANDIDATES, result.length + 8);
+  limit = behindLimit;
+  for (let distance = 0; distance < Math.min(8, span) && result.length < behindLimit; distance += 1) {
+    const index = behindStart - distance * step;
+    if (index < 0 || index >= rows.length) break;
+    row(rows[index], 2);
+  }
+  return result;
+}
+
+// OneKey patch: imperative image patches update a sparse prefetch overlay, not
+// the readonly prop or a full cloned snapshot. The key index is rebuilt only for
+// a complete snapshot; ordinary balance patches retain no extra row copies.
+export class NativeAvatarPrefetchModel {
+  imageRows = new Map();
+  constructor(rows) {
+    this.rows = rows;
+    this.rowByKey = new Map(rows.map(row => [row.key, row]));
+  }
+  replaceSnapshot(rows) {
+    this.rows = rows;
+    this.rowByKey = new Map(rows.map(row => [row.key, row]));
+    this.imageRows.clear();
+  }
+  applyPatches(patches, dispatch) {
+    // Native methods have no acknowledgement. Mirror only dispatched batches;
+    // a missing host or a synchronous serialization/dispatch failure changes nothing.
+    if (!dispatch) return false;
+    dispatch();
+    const seen = new Set();
+    for (const patch of patches) {
+      const row = this.rowByKey.get(patch.key);
+      // Both native renderers reject the whole batch for an unknown key/type.
+      if (!row || row.type !== patch.type || seen.has(patch.key)) return false;
+      seen.add(patch.key);
+    }
+    let changed = false;
+    for (const patch of patches) {
+      const changes = patch.changes;
+      let imageChanges;
+      for (const key of IMAGE_PATCH_FIELDS) {
+        if (changes[key] !== undefined) {
+          imageChanges ??= {};
+          imageChanges[key] = changes[key];
+        }
+      }
+      // JSON.stringify omits undefined top-level fields. Native therefore keeps
+      // them unchanged; an explicit replacement visual without image clears it.
+      if (!imageChanges) continue;
+      const row = this.imageRows.get(patch.key) ?? this.rowByKey.get(patch.key);
+      // Preserve the validated row discriminant, matching applyRowPatches' shallow merge.
+      this.imageRows.set(patch.key, {
+        ...row,
+        ...imageChanges,
+        key: row.key,
+        type: row.type
+      });
+      changed = true;
+    }
+    return changed;
+  }
+  window(first, last, direction) {
+    return avatarPrefetchWindow(this.rows, first, last, direction, row => this.imageRows.get(row.key) ?? row);
+  }
+}
+
+// Native preload has no cancellation token. One in-flight source is the bound;
+// direction changes replace all not-yet-started work rather than appending it.
+export class NativeAvatarPrefetchQueue {
+  pending = [];
+  disposed = false;
+  recent = new Map();
+  constructor(preload) {
+    this.preload = preload;
+  }
+  update(candidates) {
+    if (this.disposed) return;
+    const now = Date.now();
+    this.pending = candidates.filter(({
+      source,
+      priority
+    }) => priority !== 0 && source.uri !== this.activeUri && now - (this.recent.get(source.uri) ?? 0) > 30_000).map(({
+      source
+    }) => source);
+    this.schedule();
+  }
+  dispose() {
+    this.disposed = true;
+    this.pending = [];
+    this.recent.clear();
+    if (this.timer !== undefined) clearTimeout(this.timer);
+    this.timer = undefined;
+  }
+  schedule() {
+    if (this.disposed || this.activeUri || this.timer !== undefined || !this.pending.length) return;
+    // Yield between short batches without imposing a frame-per-image throughput cap.
+    this.timer = setTimeout(() => {
+      this.timer = undefined;
+      const source = this.pending.shift();
+      if (!source || this.disposed) return;
+      this.activeUri = source.uri;
+      Promise.resolve().then(() => this.preload(source)).then(success => {
+        if (success && !this.disposed) {
+          this.recent.delete(source.uri);
+          this.recent.set(source.uri, Date.now());
+          if (this.recent.size > 128) this.recent.delete(this.recent.keys().next().value);
+        }
+      }).catch(() => {
+        /* Visible loading retains its own failure/retry behavior. */
+      }).finally(() => {
+        this.activeUri = undefined;
+        this.schedule();
+      });
+    }, 0);
+  }
+}
+//# sourceMappingURL=avatarPrefetch.js.map

package/lib/module/validation.js

@@ -124,6 +124,26 @@ function assertLeadingVisual(visual, path) {
     assertImage(visual.image, `${path}.image`);
     assertVisualShape(visual.shape, `${path}.shape`);
     assertText(visual.cornerIcon?.name, `${path}.cornerIcon.name`);
+    // OneKey patch: validate optional selector overlays at the JSON boundary.
+    assertText(visual.fallbackIcon?.name, `${path}.fallbackIcon.name`);
+    if ((visual.overlays?.length ?? 0) > 2) fail(`${path}.overlays`, 'supports at most two overlays');
+    visual.overlays?.forEach((overlay, index) => {
+      if (!['topLeft', 'bottomRight'].includes(overlay.position)) fail(`${path}.overlays[${index}].position`, 'must be topLeft or bottomRight');
+      if (overlay.size !== undefined && (overlay.size <= 0 || overlay.size > 40)) fail(`${path}.overlays[${index}].size`, 'must be within 1...40');
+      if (overlay.padding !== undefined && (!Number.isFinite(overlay.padding) || overlay.padding < 0 || overlay.padding * 2 >= (overlay.size ?? 20))) fail(`${path}.overlays[${index}].padding`, 'must fit inside the overlay');
+      if (overlay.offset !== undefined && (!Number.isFinite(overlay.offset) || overlay.offset < 0 || overlay.offset > 20)) fail(`${path}.overlays[${index}].offset`, 'must be within 0...20');
+      for (const field of ['width', 'height']) {
+        const value = overlay[field];
+        if (value !== undefined && (!Number.isFinite(value) || value <= 0 || value > 40)) fail(`${path}.overlays[${index}].${field}`, 'must be within 1...40');
+      }
+      for (const field of ['offsetX', 'offsetY']) {
+        const value = overlay[field];
+        if (value !== undefined && (!Number.isFinite(value) || value < 0 || value > 20)) fail(`${path}.overlays[${index}].${field}`, 'must be within 0...20');
+      }
+      if (overlay.padding !== undefined && overlay.padding * 2 >= Math.min(overlay.width ?? overlay.size ?? 20, overlay.height ?? overlay.size ?? 20)) fail(`${path}.overlays[${index}].padding`, 'must fit inside the overlay');
+      assertImage(overlay.image, `${path}.overlays[${index}].image`);
+      assertText(overlay.text, `${path}.overlays[${index}].text`);
+    });
     if (visual.kind === 'token') {
       assertImage(visual.networkImage, `${path}.networkImage`);
     }
@@ -169,6 +189,10 @@ function assertWalletGroup(row, path) {
 }
 function assertRow(row, index, path = `rows[${index}]`) {
   assertKey(row.key, `${path}.key`);
+  // OneKey patch: explicit dimensions and opacity cannot corrupt list layout.
+  if (row.height !== undefined && (row.height < 0 || row.height > 4096)) fail(`${path}.height`, 'must be within 0...4096');
+  if (row.heightRounding !== undefined && (row.height === undefined || !['floor', 'nearest'].includes(row.heightRounding))) fail(`${path}.heightRounding`, 'requires an explicit height and must be floor or nearest');
+  if (row.opacity !== undefined && (row.opacity < 0 || row.opacity > 1)) fail(`${path}.opacity`, 'must be within 0...1');
   if (row.groupId && !row.groupPosition) {
     fail(`${path}.groupPosition`, 'is required when groupId is present');
   }
@@ -186,6 +210,16 @@ function assertRow(row, index, path = `rows[${index}]`) {
       }
       assertText(row.title, `${path}.title`);
       assertText(row.subtitle, `${path}.subtitle`);
+      // OneKey patch: selector text segments truncate independently.
+      row.subtitleSegments?.forEach((segment, segmentIndex) => {
+        assertText(segment.text, `${path}.subtitleSegments[${segmentIndex}].text`);
+        if (segment.tone !== undefined && !['primary', 'secondary', 'disabled', 'caution', 'positive', 'negative'].includes(segment.tone)) fail(`${path}.subtitleSegments[${segmentIndex}].tone`, 'invalid selector text tone');
+      });
+      let previousMatchEnd = 0;
+      row.titleMatch?.forEach(match => {
+        if (!Number.isInteger(match.start) || !Number.isInteger(match.end) || match.start < previousMatchEnd || match.end <= match.start || match.end > row.title.length) fail(`${path}.titleMatch`, 'must contain ordered, non-overlapping UTF-16 ranges inside title');
+        previousMatchEnd = match.end;
+      });
       assertText(row.tertiary, `${path}.tertiary`);
       if (row.tertiaryTone !== undefined && !['secondary', 'info'].includes(row.tertiaryTone)) {
         fail(`${path}.tertiaryTone`, 'must be secondary or info');
@@ -293,9 +327,12 @@ function assertRow(row, index, path = `rows[${index}]`) {
       assertTrailingAccessories(row.trailing, `${path}.trailing`);
       break;
     case 'system':
-      if (!['loading', 'retry', 'noMatch', 'end', 'spacer'].includes(row.variant)) {
-        fail(`${path}.variant`, 'must be loading, retry, noMatch, end, or spacer');
+      if (
+      // OneKey patch: deprecated-wallet warnings retain the original scrolling semantics.
+      !['loading', 'retry', 'noMatch', 'end', 'spacer', 'warning'].includes(row.variant)) {
+        fail(`${path}.variant`, 'must be loading, retry, noMatch, end, spacer, or warning');
       }
+      if (row.variant === 'warning') assertText(row.title, `${path}.title`);
       if (row.variant !== 'spacer') {
         assertText(row.message, `${path}.message`);
       }
@@ -397,6 +434,12 @@ export function validateSnapshot(snapshot) {
 }
 function assertPatchChanges(patch, index) {
   const path = `patches[${index}].changes`;
+  // OneKey patch: partial balance updates retain a valid, current accessibility label.
+  if ('accessibilityLabel' in patch.changes) {
+    assertText(patch.changes.accessibilityLabel, `${path}.accessibilityLabel`);
+  }
+  // OneKey patch: partial updates may refer to an existing height but still require a valid policy.
+  if ('heightRounding' in patch.changes && patch.changes.heightRounding !== undefined && !['floor', 'nearest'].includes(patch.changes.heightRounding)) fail(`${path}.heightRounding`, 'must be floor or nearest');
   if (patch.changes.revision !== undefined && (!Number.isSafeInteger(patch.changes.revision) || patch.changes.revision < 0)) {
     fail(`${path}.revision`, 'must be a non-negative safe integer');
   }