@onekeyfe/react-native-native-list 6.7.0-alpha.415 → 6.7.0-alpha.418

package/ios/NativeListIdentityRenderer.swift

@@ -109,7 +109,7 @@ final class NativeListIdentityCell: NativeListRendererCell {
   private let mainStack = UIStackView()
   private let titleRowStack = UIStackView()
   private let titleLabel = NativeListTextLabel()
-  private let titleIconView = UIImageView()
+  private let titleIconView = NativeListIconImageView()
   private var titleImageSlot: NativeListImageSlot?
   private var titleImageConstraints: [NSLayoutConstraint] = []
   // Absorbs the title row's slack so the title keeps its intrinsic width and the
@@ -120,7 +120,7 @@ final class NativeListIdentityCell: NativeListRendererCell {
   private let tertiaryLabel = NativeListTextLabel()
   private let badgeLabel = NativeListInsetLabel()
   private let trailingStack = NativeListAccessoryStack(frame: .zero)
-  private let leadingActionButton = UIButton(type: .system)
+  private let leadingActionButton = NativeListIconButton(type: .system)
   private var leadingWidth: NSLayoutConstraint!
   private var leadingHeight: NSLayoutConstraint!
   private var leftInset: CGFloat = 12
@@ -208,6 +208,9 @@ final class NativeListIdentityCell: NativeListRendererCell {
     _ item: NativeListItem, theme: [String: Any]?, layout: String,
     checkboxState: (NativeListItem, NativeSelectionTarget?, String) -> String
   ) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
+
     selectorTypographyRestorers.reversed().forEach { $0() }
     selectorTypographyRestorers = []
     currentItem = item
@@ -298,7 +301,7 @@ final class NativeListIdentityCell: NativeListRendererCell {
     bindIdentity(item, theme: theme, selected: item.data.bool("selected"), checkboxState)
     let style = item.data.dictionary("style") ?? [:]
     if let titleIcon = item.data.dictionary("titleIcon") {
-      titleIconView.image = nativeListIcon(named: titleIcon.string("name"))
+      titleIconView.bindIcon(titleIcon.string("name"))
       titleIconView.tintColor = UIColor(
         nativeListHex: titleIcon.string("tintColor",
           default: theme?["iconSubdued"] as? String ?? "#8D8D8D"),
@@ -407,6 +410,7 @@ final class NativeListIdentityCell: NativeListRendererCell {
     }
     settleTitleRowFillerSpacing()
     applySelectorTypography(item)
+
   }
 
   /// The filler is the title row's last arranged view; the stack's default
@@ -422,6 +426,9 @@ final class NativeListIdentityCell: NativeListRendererCell {
     _ item: NativeListItem,
     checkboxState: (NativeListItem, NativeSelectionTarget?, String) -> String
   ) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
+
     currentItem = item
     trailingStack.updateSelection(item, checkboxState: checkboxState)
     if item.data.string("presentation") == "walletSidebar" {
@@ -439,6 +446,7 @@ final class NativeListIdentityCell: NativeListRendererCell {
         NativeListTextStyles.applyStyledText(titleLabel, style, fonts: fonts)
       }
     }
+
   }
   override func layoutSubviews() {
     super.layoutSubviews()
@@ -610,13 +618,7 @@ final class NativeListIdentityCell: NativeListRendererCell {
         fallback: .darkGray
       )
       leadingActionButton.tintColor = tintColor
-      if let image = nativeListIcon(named: leadingAction.string("name")) {
-        leadingActionButton.setImage(image, for: .normal)
-        leadingActionButton.setImage(
-          image.withTintColor(tintColor, renderingMode: .alwaysOriginal),
-          for: .disabled
-        )
-      }
+      leadingActionButton.bindIcon(leadingAction.string("name"))
       leadingActionButton.isEnabled = !leadingAction.bool("disabled")
       leadingActionButton.alpha = leadingActionButton.isEnabled ? 1 : 0.4
       leadingActionKey = leadingAction.string("actionKey")

package/ios/NativeListLeadingVisual.swift

@@ -14,16 +14,16 @@ final class NativeListLeadingVisual: UIView {
   var overlayTextFontSize: CGFloat = 10
   var overlayTextLineHeight: CGFloat?
   var overlayTextHorizontalInset: CGFloat?
-  private let icon = UIImageView()
+  private let icon = NativeListIconImageView()
   private let unread = UIView()
   private let networkBackdrop = UIView()
   // Ring under the secondary token of an Activity pair (SPEC "Activity leading pair").
   private let pairBackdrop = UIView()
-  private let corner = UIImageView()
+  private let corner = NativeListIconImageView()
   private let cornerBackdrop = UIView()
   private var slots: [NativeListImageSlot] = []
   private var overlaySlots: [NativeListImageSlot] = []
-  private var overlayFallbackIcons: [UIImageView] = []
+  private var overlayFallbackIcons: [NativeListIconImageView] = []
   private var overlays: [(UIView, [String: Any])] = []
   private let dashedBorder = CAShapeLayer()
   private var visual: [String: Any] = [:]
@@ -54,6 +54,8 @@ final class NativeListLeadingVisual: UIView {
     isUnread: Bool, secondaryVisual: [String: Any]? = nil,
     fonts: NativeListFontFamilies
   ) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
     self.fonts = fonts
     fallback.font = nativeListFont(ofSize: 13, weight: .bold, fonts: fonts)
     self.visual = visual
@@ -111,7 +113,7 @@ final class NativeListLeadingVisual: UIView {
     fallback.text = String(visual.string("fallbackText").prefix(2))
     fallback.textColor = UIColor(
       nativeListHex: visual.string("fallbackTextColor", default: "#8D8D8D"), fallback: .gray)
-    icon.image = fallbackData.map { nativeListIcon(named: $0.string("name")) } ?? nil
+    icon.bindIcon(fallbackData?.string("name"))
     icon.tintColor = UIColor(
       nativeListHex: fallbackData?.string("tintColor", default: "#646464") ?? "#646464",
       fallback: .darkGray)
@@ -175,7 +177,7 @@ final class NativeListLeadingVisual: UIView {
     let badge = visual.dictionary("cornerIcon")
     corner.isHidden = badge == nil
     cornerBackdrop.isHidden = badge == nil
-    corner.image = badge.flatMap { nativeListIcon(named: $0.string("name")) }
+    corner.bindIcon(badge?.string("name"))
     corner.tintColor = UIColor(
       nativeListHex: badge?.string("tintColor", default: "#646464") ?? "#646464",
       fallback: .darkGray)
@@ -187,12 +189,12 @@ final class NativeListLeadingVisual: UIView {
     overlays.removeAll(keepingCapacity: true)
     let descriptors = Array(visual.dictionaries("overlays").prefix(2))
     while overlaySlots.count < descriptors.count { overlaySlots.append(NativeListImageSlot()) }
-    while overlayFallbackIcons.count < descriptors.count { overlayFallbackIcons.append(UIImageView()) }
+    while overlayFallbackIcons.count < descriptors.count { overlayFallbackIcons.append(NativeListIconImageView()) }
     for (index, data) in descriptors.enumerated() {
       let frame = index < previousOverlays.count ? previousOverlays[index].0 : UIView()
       let fallbackData = data.dictionary("fallbackIcon")
       let fallbackGlyph = overlayFallbackIcons[index]
-      fallbackGlyph.image = fallbackData.flatMap { nativeListIcon(named: $0.string("name")) }
+      fallbackGlyph.bindIcon(fallbackData?.string("name"))
       fallbackGlyph.tintColor = UIColor(
         nativeListHex: fallbackData?.string("tintColor", default: "#646464") ?? "#646464",
         fallback: .darkGray)
@@ -243,8 +245,8 @@ final class NativeListLeadingVisual: UIView {
         child = label
       } else {
         overlaySlots[index].recycle()
-        let glyph = frame.subviews.first as? UIImageView ?? UIImageView()
-        glyph.image = nativeListIcon(named: data.string("name"))
+        let glyph = frame.subviews.first as? NativeListIconImageView ?? NativeListIconImageView()
+        glyph.bindIcon(data.string("name"))
         glyph.contentMode = .scaleAspectFit
         glyph.tintColor = UIColor(
           nativeListHex: data.string("tintColor", default: "#646464"), fallback: .darkGray)

package/ios/NativeListMarketRenderer.swift

@@ -35,7 +35,7 @@ final class NativeListMarketCell: NativeListRendererCell {
   private let marketBadgeButtons = (0..<3).map { _ in NativeListAccessoryButton(type: .system) }
   private let badgeSlots = (0..<3).map { _ in NativeListImageSlot() }
   private var marketBadgeImages: [UIView] { badgeSlots.map { $0.view } }
-  private let leadingActionButton = UIButton(type: .system)
+  private let leadingActionButton = NativeListIconButton(type: .system)
   private var leadingWidth: NSLayoutConstraint!
   private var leadingHeight: NSLayoutConstraint!
   private var selectorConstraints: [NSLayoutConstraint] = []
@@ -99,6 +99,9 @@ final class NativeListMarketCell: NativeListRendererCell {
     _ item: NativeListItem, theme: [String: Any]?, layout: String,
     checkboxState: (NativeListItem, NativeSelectionTarget?, String) -> String
   ) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
+
     NSLayoutConstraint.deactivate(selectorConstraints + accessorySizeConstraints)
     selectorConstraints = []
     accessorySizeConstraints = []
@@ -166,6 +169,7 @@ final class NativeListMarketCell: NativeListRendererCell {
       ? .top
       : style?.dictionary("container")?.string("contentVerticalAlignment") == "bottom"
         ? .bottom : .center
+
   }
   private func resetButton(_ button: NativeListAccessoryButton) {
     button.setTitle(nil, for: .normal)
@@ -498,13 +502,7 @@ final class NativeListMarketCell: NativeListRendererCell {
         fallback: .darkGray
       )
       leadingActionButton.tintColor = tintColor
-      if let image = nativeListIcon(named: leadingAction.string("name")) {
-        leadingActionButton.setImage(image, for: .normal)
-        leadingActionButton.setImage(
-          image.withTintColor(tintColor, renderingMode: .alwaysOriginal),
-          for: .disabled
-        )
-      }
+      leadingActionButton.bindIcon(leadingAction.string("name"))
       leadingActionButton.isEnabled = !leadingAction.bool("disabled")
       leadingActionButton.alpha = leadingActionButton.isEnabled ? 1 : 0.4
       leadingActionButton.accessibilityIdentifier = leadingAction["testID"] as? String
@@ -627,11 +625,7 @@ final class NativeListMarketCell: NativeListRendererCell {
       button.titleEdgeInsets = .zero
       button.imageView?.contentMode = .scaleAspectFit
       if hasBuiltInIcon {
-        button.setImage(
-          nativeListIcon(
-            named: "BadgeVerifiedSolid", size: CGSize(width: iconSize, height: iconSize)),
-          for: .normal
-        )
+        button.bindIcon("BadgeVerifiedSolid", size: CGSize(width: iconSize, height: iconSize))
       }
       // OneKey patch: match source badge metrics at physical-pixel precision.
       // let height = button.heightAnchor.constraint(equalToConstant: 18)

package/ios/NativeListMediaTileRenderer.swift

@@ -11,7 +11,7 @@ final class NativeListMediaTileCell: NativeListRendererCell {
   private let picture = UIView()
   private let image = NativeListMediaPreviewSlot()
   private let network = NativeListImageSlot()
-  private let errorIcon = UIImageView()
+  private let errorIcon = NativeListIconImageView()
   private let title = NativeListTextLabel()
   private let subtitle = NativeListTextLabel()
   private let badge = NativeListTextLabel()
@@ -87,6 +87,9 @@ final class NativeListMediaTileCell: NativeListRendererCell {
     _ item: NativeListItem, theme: [String: Any]?, layout: String,
     checkboxState: (NativeListItem, NativeSelectionTarget?, String) -> String
   ) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
+
     let style = item.data.dictionary("style") ?? [:]
     imageStyle = style.dictionary("image") ?? [:]
     let hp = CGFloat(style.double("horizontalPadding", default: 10))
@@ -122,7 +125,7 @@ final class NativeListMediaTileCell: NativeListRendererCell {
     let state = item.data.string("imageState")
     let placeholder = theme?.string("strongBackground", default: "#0000000F") ?? "#0000000F"
     errorIcon.isHidden = state != "error"
-    errorIcon.image = nativeListIcon(named: "ImageSquareWavesOutline")
+    errorIcon.bindIcon("ImageSquareWavesOutline")
     errorIcon.tintColor = UIColor(nativeListHex: "#00000044", fallback: .lightGray)
     let media = item.data.dictionary("media")
     if state != "empty", state != "error", let source = media?.dictionary("source") ?? item.data.dictionary("image") {
@@ -164,6 +167,7 @@ final class NativeListMediaTileCell: NativeListRendererCell {
     close.setTitle("×", for: .normal)
     close.titleLabel?.font = nativeListFont(ofSize: 16, weight: .medium, fonts: fonts)
     close.setTitleColor(nativeListColor(theme, "primaryText", "#202020"), for: .normal)
+
   }
   override func layoutSubviews() {
     let width = CGFloat(

package/ios/NativeListMetricCardRenderer.swift

@@ -374,7 +374,7 @@ final class NativeListMetricCardCell: NativeListRendererCell {
 }
 
 private final class NativeListMetricVisual: UIView {
-  private let icon = UIImageView()
+  private let icon = NativeListIconImageView()
   private let image = NativeListImageSlot()
   init() {
     super.init(frame: .zero)
@@ -389,6 +389,8 @@ private final class NativeListMetricVisual: UIView {
   }
   required init?(coder: NSCoder) { fatalError("init(coder:) has not been implemented") }
   func bind(_ visual: [String: Any], key: String, placeholder: String) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
     backgroundColor = UIColor(
       nativeListHex: visual.string("backgroundColor", default: "#0000000F"), fallback: .lightGray)
     layer.cornerRadius = visual.string("shape") == "square" ? 0 : 8
@@ -397,7 +399,7 @@ private final class NativeListMetricVisual: UIView {
     image.view.isHidden = true
     if kind == "icon" {
       image.recycle()
-      icon.image = nativeListIcon(named: visual.string("name"))
+      icon.bindIcon(visual.string("name"))
       icon.tintColor = UIColor(
         nativeListHex: visual.string("tintColor", default: "#00000072"), fallback: .darkGray)
     } else if let source = kind == "stackedImages"

package/ios/NativeListSectionHeaderRenderer.swift

@@ -124,8 +124,8 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
   private let trailingStack = UIStackView()
   private let accessoryButtons = [NativeListAccessoryButton(type: .system)]
   private let checkboxControl = NativeListAccessoryStack(frame: .zero)
-  private let headerTitleIconImageView = UIImageView()
-  private let headerValueIconImageView = UIImageView()
+  private let headerTitleIconImageView = NativeListIconImageView()
+  private let headerValueIconImageView = NativeListIconImageView()
   private var accessoryActions: [(String, NativeSelectionTarget?)] = []
   private var currentItem: NativeListItem?
   private var currentTheme: [String: Any]?
@@ -187,6 +187,9 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
     _ item: NativeListItem, theme: [String: Any]?, layout: String,
     checkboxState: (NativeListItem, NativeSelectionTarget?, String) -> String
   ) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
+
     selectorTypographyRestorers.reversed().forEach { $0() }
     selectorTypographyRestorers = []
     currentItem = item
@@ -297,6 +300,7 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
       width.isActive = true
       selectorConstraints.append(width)
     }
+
   }
   private func bindPositionHeaderFields(_ item: NativeListItem, theme: [String: Any]?) {
     let style = item.data.dictionary("style") ?? [:]
@@ -371,6 +375,9 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
     _ item: NativeListItem,
     checkboxState: (NativeListItem, NativeSelectionTarget?, String) -> String
   ) {
+    let iconUpdate = NativeListIconUpdate(self)
+    defer { iconUpdate.finish() }
+
     currentItem = item
     checkboxControl.updateSelection(item, checkboxState: checkboxState)
     if item.data.string("variant") == "summary" {
@@ -382,6 +389,7 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
       applyTextStyle(item)
       applySelectorTypography(item)
     }
+
   }
   private func bindCheckbox(
     _ item: NativeListItem, _ descriptor: [String: Any],
@@ -523,7 +531,7 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
       topInset = 12
       bottomInset = -2
       if let icon = item.data.dictionary("titleIcon") {
-        headerTitleIconImageView.image = nativeListIcon(named: icon.string("name"))
+        headerTitleIconImageView.bindIcon(icon.string("name"))
         headerTitleIconImageView.tintColor = UIColor(
           nativeListHex: icon.string("tintColor", default: "#646464"),
           fallback: .darkGray
@@ -593,7 +601,7 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
           for: .normal
         )
         if let icon = item.data.dictionary("valueIcon") {
-          headerValueIconImageView.image = nativeListIcon(named: icon.string("name"))
+          headerValueIconImageView.bindIcon(icon.string("name"))
           headerValueIconImageView.tintColor = UIColor(
             nativeListHex: icon.string("tintColor", default: "#646464"),
             fallback: .darkGray

package/ios/tests/NativeListAccessoryStackTests.swift

@@ -42,6 +42,18 @@ final class NativeListAccessoryStackTests: XCTestCase {
     XCTAssertTrue(stack.hitTest(value.center, with: nil) === stack)
   }
 
+  func testSwapMenuUsesTheDotVerSolidImage() throws {
+    let metadata = try XCTUnwrap(nativeListIconMetadata(named: "DotVerSolid"))
+    XCTAssertGreaterThan(metadata.size.width, 0)
+    XCTAssertGreaterThan(metadata.size.height, 0)
+    let stack = try makeStack(trailing: [[
+      "kind": "icon", "name": "DotVerSolid", "buttonStyle": "tertiary",
+      "actionKey": "menu",
+    ]])
+    let button = try XCTUnwrap(try visibleControl(stack) as? UIButton)
+    XCTAssertNotNil(button.image(for: .normal))
+  }
+
   func testValuePairAccessoryLeavesTouchesToTheRow() throws {
     let stack = try makeStack(trailing: [
       ["kind": "valuePair", "primary": "$15.60", "secondary": "0.002 BTC"],

package/ios/tests/NativeListSharedIconTests.swift

@@ -0,0 +1,236 @@
+import UIKit
+import XCTest
+import OneKeyImage
+@testable import NativeListModule
+
+@MainActor
+final class NativeListSharedIconTests: XCTestCase {
+  private func field<T>(_ object: Any, _ name: String, as type: T.Type = T.self) throws -> T {
+    var mirror: Mirror? = Mirror(reflecting: object)
+    while let current = mirror {
+      if let child = current.children.first(where: { $0.label == name }) { return try XCTUnwrap(child.value as? T) }
+      mirror = current.superclassMirror
+    }
+    throw NSError(domain: "Missing field " + name, code: 1)
+  }
+  private func binding(_ button: UIButton) throws -> Any {
+    let mirror = try XCTUnwrap(Mirror(reflecting: button).superclassMirror)
+    let storage = try XCTUnwrap(mirror.children.first { $0.label?.contains("iconBinding") == true }?.value)
+    return try XCTUnwrap(Mirror(reflecting: storage).children.first?.value)
+  }
+  private func eventually(_ message: String, _ condition: () -> Bool) {
+    let end = Date().addingTimeInterval(5)
+    while !condition(), Date() < end { RunLoop.main.run(until: Date().addingTimeInterval(0.01)) }
+    XCTAssertTrue(condition(), message)
+  }
+  private func window() throws -> UIWindow {
+    guard UIApplication.perform(NSSelectorFromString("sharedApplication"))?.takeUnretainedValue() is UIApplication else {
+      throw XCTSkip("A UIApplication host is required for attached glyph acceptance")
+    }
+    let window = UIWindow(frame: UIScreen.main.bounds)
+    window.rootViewController = UIViewController()
+    window.makeKeyAndVisible()
+    return window
+  }
+  private func save(_ image: UIImage, _ name: String) throws {
+    guard let directory = ProcessInfo.processInfo.environment["ICON_EVIDENCE_DIR"] else { return }
+    try XCTUnwrap(image.pngData()).write(to: URL(fileURLWithPath: directory).appendingPathComponent(name + ".png"))
+  }
+  private func bind(_ stack: NativeListAccessoryStack, amount: String = "1", name: String = "DotVerSolid", kind: String = "icon", disabled: Bool = false) throws {
+    let descriptors: [[String: Any]] = [
+      ["kind": "valuePair", "primary": amount, "secondary": "$1"],
+      ["kind": kind, "name": name, "text": "Text", "buttonStyle": "tertiary", "actionKey": "menu", "disabled": disabled],
+    ]
+    let item = try NativeListItem(data: ["key": "swap", "type": "identity", "title": "USDC", "height": 60, "trailing": descriptors])
+    stack.axis = .horizontal
+    stack.bind(item, descriptors: descriptors, theme: nil,
+      style: ["horizontalPadding": 20, "verticalPadding": 8, "leadingGap": 12, "trailingGap": 8],
+      checkboxState: { _, _, fallback in fallback }, fonts: NativeListFontFamilies())
+    stack.setNeedsLayout(); stack.layoutIfNeeded()
+  }
+  func testDetachedMeasurementAndRealSwapRebindPreservePendingAndReadyImage() throws {
+    let service = OneKeyNamedSVG.shared
+    let metadataLock: NSLock = try field(service, "metadataLock")
+    let stateLock: NSLock = try field(service, "lock")
+    func state(_ owner: NSObject? = nil) throws -> (Int, Int) {
+      stateLock.lock(); defer { stateLock.unlock() }
+      let pending: Any = try field(service, "pending")
+      let keys = Mirror(reflecting: pending).children.compactMap { Mirror(reflecting: $0.value).children.first?.value as? ObjectIdentifier }
+      return (try field(service, "workers"), owner.map { owner in keys.filter { $0 == ObjectIdentifier(owner) }.count } ?? keys.count)
+    }
+    metadataLock.lock()
+    var locked = true
+    defer { if locked { metadataLock.unlock() } }
+    let baseline = try state()
+    let stack = NativeListAccessoryStack(frame: CGRect(x: 10, y: 80, width: 180, height: 44))
+    try bind(stack)
+    let button = try XCTUnwrap(stack.subviews.compactMap { $0 as? NativeListAccessoryButton }.first { !$0.isHidden && $0.image(for: .normal) != nil })
+    let slot = try binding(button)
+    let owner: NSObject = try field(slot, "owner")
+    XCTAssertEqual(try state(owner).0, baseline.0)
+    XCTAssertEqual(try state(owner).1, 0)
+    let beforeSize = try XCTUnwrap(button.image(for: .normal)).size
+    let detachedSize = stack.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize)
+    XCTAssertEqual(try state(owner).0, baseline.0)
+    XCTAssertEqual(try state(owner).1, 0)
+    let window = try window(); defer { window.isHidden = true }
+    do {
+      defer { metadataLock.unlock(); locked = false }
+      window.rootViewController!.view.addSubview(stack)
+      stack.layoutIfNeeded()
+      XCTAssertGreaterThan(try state(owner).0 + state(owner).1, baseline.0)
+      let bounds = button.bounds.size
+      let revision: UInt64 = try field(slot, "revision")
+      for index in 0..<100 { try bind(stack, amount: String(index)) }
+      XCTAssertEqual(try field(slot, "revision", as: UInt64.self), revision)
+      XCTAssertEqual(button.image(for: .normal)?.size, beforeSize)
+      XCTAssertEqual(button.bounds.size, bounds)
+      XCTAssertEqual(stack.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize).height, detachedSize.height)
+    }
+    eventually("Attached Swap glyph has an actual raster") { button.image(for: .normal)?.cgImage != nil && button.image(for: .normal)?.size == beforeSize && (try? self.field(slot, "currentImage", as: UIImage?.self)) != nil }
+    // A transparent measurement placeholder also has a CGImage: require painted pixels.
+    eventually("Decoded glyph is visible") { self.alphaCount(button.image(for: .normal)) > 0 }
+    let ready = try XCTUnwrap(button.image(for: .normal))
+    XCTAssertEqual(maximumAlpha(ready), 255)
+    try bind(stack, amount: "101")
+    XCTAssertTrue(button.image(for: .normal) === ready)
+    button.tintColor = .blue
+    XCTAssertTrue(button.image(for: .normal) === ready)
+    XCTAssertNotNil(button.image(for: .disabled))
+    try bind(stack, amount: "101")
+    func captureButton() -> UIImage {
+      let rect = button.convert(button.bounds, to: stack)
+      return UIGraphicsImageRenderer(size: button.bounds.size).image { context in
+        context.cgContext.translateBy(x: -rect.minX, y: -rect.minY)
+        stack.drawHierarchy(in: stack.bounds, afterScreenUpdates: true)
+      }
+    }
+    try save(captureButton(), "ios-swap-menu-normal")
+    var actions = 0
+    stack.onAction = { _, _, _, _ in actions += 1 }
+    try bind(stack, amount: "101", disabled: true)
+    XCTAssertFalse(button.isEnabled); XCTAssertEqual(button.alpha, 0.4, accuracy: 0.000001)
+    XCTAssertTrue(button.image(for: .normal) === ready)
+    button.sendActions(for: .touchUpInside); XCTAssertEqual(actions, 0)
+    button.layoutIfNeeded()
+    try save(captureButton(), "ios-swap-menu-disabled")
+    try bind(stack, amount: "101")
+    try bind(stack, name: "UnknownIcon")
+    XCTAssertNil(button.image(for: .normal))
+    try bind(stack, kind: "value")
+    XCTAssertNil(button.image(for: .normal))
+    stack.removeFromSuperview()
+    RunLoop.main.run(until: Date().addingTimeInterval(0.05))
+    XCTAssertNil(button.image(for: .normal))
+  }
+  private func alphaCount(_ image: UIImage?) -> Int {
+    guard let cg = image?.cgImage else { return 0 }
+    var bytes = [UInt8](repeating: 0, count: cg.width * cg.height * 4)
+    guard let context = CGContext(data: &bytes, width: cg.width, height: cg.height, bitsPerComponent: 8,
+      bytesPerRow: cg.width * 4, space: CGColorSpaceCreateDeviceRGB(), bitmapInfo: CGImageAlphaInfo.premultipliedLast.rawValue) else { return 0 }
+    context.draw(cg, in: CGRect(x: 0, y: 0, width: cg.width, height: cg.height))
+    return stride(from: 3, to: bytes.count, by: 4).filter { bytes[$0] > 0 }.count
+  }
+  func testMainLineGlyphsPaintInTheSharedNativeSlot() throws {
+    let window = try window(); defer { window.isHidden = true }
+    let view = NativeListIconImageView(frame: CGRect(x: 10, y: 80, width: 64, height: 64))
+    window.rootViewController!.view.addSubview(view)
+    for name in ["Document2Outline", "WalletOutline", "PlusLargeOutline", "TicketOutline"] {
+      let metadata = try XCTUnwrap(nativeListIconMetadata(named: name))
+      XCTAssertEqual(metadata.name, name)
+      XCTAssertEqual(metadata.size, CGSize(width: 24, height: 24))
+      view.bindIcon(name)
+      eventually("Shared main-line glyph paints: " + name) { self.alphaCount(view.image) > 0 }
+      let image = try XCTUnwrap(view.image)
+      XCTAssertEqual(image.renderingMode, .alwaysTemplate)
+      try save(image.withTintColor(.red, renderingMode: .alwaysOriginal), "ios-main-integration-" + name)
+    }
+  }
+  private func maximumAlpha(_ image: UIImage) -> UInt8 {
+    guard let cg = image.cgImage else { return 0 }
+    var bytes = [UInt8](repeating: 0, count: cg.width * cg.height * 4)
+    guard let context = CGContext(data: &bytes, width: cg.width, height: cg.height, bitsPerComponent: 8,
+      bytesPerRow: cg.width * 4, space: CGColorSpaceCreateDeviceRGB(), bitmapInfo: CGImageAlphaInfo.premultipliedLast.rawValue) else { return 0 }
+    context.draw(cg, in: CGRect(x: 0, y: 0, width: cg.width, height: cg.height))
+    return stride(from: 3, to: bytes.count, by: 4).map { bytes[$0] }.max() ?? 0
+  }
+  func testLifecycleLegacyModesAndSizeOverride() throws {
+    let window = try window(); defer { window.isHidden = true }
+    let view = NativeListIconImageView(frame: CGRect(x: 10, y: 80, width: 64, height: 64))
+    window.rootViewController!.view.addSubview(view)
+    for name in ["AppleBrand", "BotIllus", "GoogleIllus", "AccountErrorCustom", "StarOutline", "StarSolid", "BadgeVerifiedSolid", "CheckboxCheckedCustom", "CheckboxIndeterminateCustom"] {
+      view.bindIcon(name)
+      eventually(name) { self.alphaCount(view.image) > 0 }
+      let metadata = try XCTUnwrap(nativeListIconMetadata(named: name))
+      XCTAssertEqual(view.image?.size, metadata.size)
+      if !metadata.original { XCTAssertEqual(maximumAlpha(try XCTUnwrap(view.image)), 255) }
+      XCTAssertEqual(view.image?.renderingMode, metadata.original ? .alwaysOriginal : .alwaysTemplate)
+      let image = try XCTUnwrap(view.image)
+      try save(metadata.original ? image : image.withTintColor(.red, renderingMode: .alwaysOriginal), "ios-new-" + name)
+    }
+    view.bindIcon("AppleBrand", size: CGSize(width: 28, height: 20))
+    eventually("Non-square source stretches to legacy explicit size") { self.alphaCount(view.image) > 0 }
+    XCTAssertEqual(view.image?.size, CGSize(width: 28, height: 20))
+    XCTAssertEqual(view.image?.renderingMode, .alwaysTemplate)
+    try save(try XCTUnwrap(view.image).withTintColor(.red, renderingMode: .alwaysOriginal), "ios-new-AppleBrand-override")
+    view.bindIcon("DotVerSolid")
+    view.removeFromSuperview()
+    RunLoop.main.run(until: Date().addingTimeInterval(0.1))
+    XCTAssertEqual(alphaCount(view.image), 0)
+    window.rootViewController!.view.addSubview(view)
+    eventually("Same glyph redraws after detached completion") { self.alphaCount(view.image) > 0 }
+    view.bindIcon("UnknownIcon"); XCTAssertNil(view.image)
+    let ordinary = UIGraphicsImageRenderer(size: CGSize(width: 8, height: 8)).image { c in UIColor.green.setFill(); c.fill(CGRect(x: 0, y: 0, width: 8, height: 8)) }
+    view.image = ordinary
+    XCTAssertTrue(view.image === ordinary)
+  }
+  func testLegacyCompiledAssetRasterComparison() throws {
+    guard let directory = ProcessInfo.processInfo.environment["NATIVE_LIST_LEGACY_BUNDLE"], let bundle = Bundle(path: directory) else {
+      throw XCTSkip("An archived pre-migration resource bundle is required for raster comparison")
+    }
+    let window = try window(); defer { window.isHidden = true }
+    let view = NativeListIconImageView(frame: CGRect(x: 0, y: 80, width: 96, height: 96))
+    window.rootViewController!.view.addSubview(view)
+    let names = [
+      "AppleBrand": "onekey_selector_apple_brand", "BotIllus": "onekey_selector_bot_illus",
+      "GoogleIllus": "onekey_selector_google_illus", "AccountErrorCustom": "onekey_selector_account_error_custom",
+      "BadgeVerifiedSolid": "onekey_badge_verified_solid", "StarOutline": "onekey_star", "StarSolid": "onekey_star_solid",
+      "CheckboxCheckedCustom": "onekey_checkbox_checked", "CheckboxIndeterminateCustom": "onekey_checkbox_indeterminate",
+    ]
+    func raster(_ image: UIImage) -> UIImage {
+      let format = UIGraphicsImageRendererFormat(); format.scale = 1
+      return UIGraphicsImageRenderer(size: CGSize(width: 96, height: 96), format: format).image { _ in
+        image.draw(in: CGRect(x: 0, y: 0, width: 96, height: 96))
+      }
+    }
+    for name in names.keys.sorted() {
+      let metadata = try XCTUnwrap(nativeListIconMetadata(named: name))
+      let old = try XCTUnwrap(UIImage(named: names[name]!, in: bundle, compatibleWith: nil))
+      view.bindIcon(name)
+      eventually("Shared raster for legacy comparison " + name) { self.alphaCount(view.image) > 0 }
+      let next = try XCTUnwrap(view.image)
+      XCTAssertEqual(next.size, old.size)
+      let before = raster(metadata.original ? old : old.withTintColor(.red, renderingMode: .alwaysOriginal))
+      let after = raster(metadata.original ? next : next.withTintColor(.red, renderingMode: .alwaysOriginal))
+      XCTAssertGreaterThan(alphaCount(before), 0); XCTAssertGreaterThan(alphaCount(after), 0)
+      if name == "AccountErrorCustom" {
+        // The source eye center is inside its 0.447-opacity fill, away from raster edges.
+        for image in [before, after] {
+          let cg = try XCTUnwrap(image.cgImage)
+          var bytes = [UInt8](repeating: 0, count: 96 * 96 * 4)
+          let context = try XCTUnwrap(CGContext(data: &bytes, width: 96, height: 96, bitsPerComponent: 8,
+            bytesPerRow: 96 * 4, space: CGColorSpaceCreateDeviceRGB(), bitmapInfo: CGImageAlphaInfo.premultipliedLast.rawValue))
+          context.draw(cg, in: CGRect(x: 0, y: 0, width: 96, height: 96))
+          for (x,y) in [(6,48),(48,6),(48,91),(91,64),(67,61)] {
+            let index = (y * 96 + x) * 4
+            XCTAssertEqual(Array(bytes[index..<(index+3)]), [0,0,0])
+            XCTAssertEqual(bytes[index+3], 114)
+          }
+          for (x,y) in [(48,48),(15,48)] { XCTAssertEqual(bytes[(y * 96 + x) * 4 + 3], 0) }
+        }
+      } else { XCTAssertEqual(maximumAlpha(after), maximumAlpha(before)) }
+      try save(before, "ios-before-" + name); try save(after, "ios-after-" + name)
+    }
+  }
+
+}

package/lib/module/web/NativeListGeneratedIcons.js

@@ -0,0 +1,31 @@
+"use strict";
+
+// Generated by scripts/generate-icons.mjs. Coverage and legacy names only; hosts provide SVG resources.
+export const nativeListGeneratedIcons = {
+  AccountErrorCustom: 'AccountErrorCustom',
+  AllNetworksSolid: 'AllNetworksSolid',
+  AppleBrand: 'AppleBrand',
+  BadgeVerifiedSolid: 'BadgeRecognizedSolid',
+  BotIllus: 'BotIllus',
+  CheckboxCheckedCustom: 'CheckboxCheckedCustom',
+  CheckboxIndeterminateCustom: 'CheckboxIndeterminateCustom',
+  ChevronRightSmallOutline: 'ChevronRightSmallOutline',
+  Circle: 'Circle',
+  CrossedSmallSolid: 'CrossedSmallSolid',
+  CryptoCoinOutline: 'CryptoCoinOutline',
+  Document2Outline: 'Document2Outline',
+  DotHorOutline: 'DotHorOutline',
+  DotVerSolid: 'DotVerSolid',
+  DragOutline: 'DragOutline',
+  GasSolid: 'GasSolid',
+  GlobusOutline: 'GlobusOutline',
+  GoogleIllus: 'GoogleIllus',
+  LockSolid: 'LockSolid',
+  PencilOutline: 'PencilOutline',
+  PlusLargeOutline: 'PlusLargeOutline',
+  PlusSmallOutline: 'PlusSmallOutline',
+  RefreshCcwOutline: 'RefreshCcwOutline',
+  TicketOutline: 'TicketOutline',
+  WalletOutline: 'WalletOutline'
+};
+//# sourceMappingURL=NativeListGeneratedIcons.js.map