docs(fork): record RedBox 2.0, Hermes v1 pin, and color follow-ups

Author: xesrevinu

fork.md

@@ -33,9 +33,9 @@ here.
 - Upstream remote branch: `upstream/0.87-merge`
 - Baseline commit: `d8c588e4a67cbe9d3cdebb27a8909a93448807cd`
 - Local branch: `aw/0.87`
-- Last functional tip: `f843e0d16764cf58ee2704857f20fac81dda7005`
-  (`285a66c810` and earlier in the table). Later `docs(fork)` commits sit
-  on top; `git rev-parse aw/0.87` is the branch HEAD.
+- Last functional tip: `22d8dea9e3` (`687571372d` RedBox 2.0, `decd178e6e`
+  Hermes v1 pin, `22d8dea9e3` color/types, and earlier in the table). Later
+  `docs(fork)` commits sit on top; `git rev-parse aw/0.87` is the branch HEAD.
 - Merge-base check: `git merge-base aw/0.87 upstream/0.87-merge` should print
   the baseline commit above.
 - Behind `upstream/0.87-merge`: 0 commits. Microsoft 0.87 has nothing further
@@ -50,6 +50,9 @@ here.
 
 | Commit        | Date       | Message                                                            |
 | ------------- | ---------- | ------------------------------------------------------------------ |
+| `22d8dea9e3`  | 2026-08-30 | `fix(js): tighten float color object parsing and VirtualizedList types` |
+| `decd178e6e`  | 2026-08-30 | `feat(hermes): pin Hermes v1 174344e and fix prebuild include paths` |
+| `687571372d`  | 2026-08-30 | `feat(macos): port RedBox 2.0 AppKit overlay via RCTUIKit primitives` |
 | `285a66c810`  | 2026-08-19 | `feat(js): fold float color objects in Animated string interpolation` |
 | `c5017f4233`  | 2026-08-19 | `feat(js): emit float color objects from oklch()/oklab() and parse color()` |
 | `e06759da6b`  | 2026-08-19 | `fix(macos): guard Meta tintColor copy and unmount UIView assert` |
@@ -105,6 +108,12 @@ the SHAs here to the new local commits.
    `RCTUIView` unmount-assert guards. Provenance is in
    `react-native-upstream.md`; these SHAs are local and must survive a
    Microsoft rebase.
+7. **RedBox 2.0 AppKit overlay** (FX-124 / FX-125): compile and fatal errors
+   use the structured RedBox 2.0 sheet on macOS (code frame, ANSI highlight,
+   native Metro `/hot` reload). Adapted from microsoft/react-native-macos#3054
+   (`c631f745`); do not take #3058. Drop when `0.87-merge` or `main` ships an
+   equivalent AppKit V2 controller. Fill the local SHA in the table above
+   when this patch is committed.
 
 Reduce Motion policy lives in the application motion layer, not this fork.
 Do not look for it here during rebase.
@@ -130,6 +139,7 @@ fix. Prefer re-applying the intent over preserving the exact hunk.
 | `b691d36eb5` | `RCTViewComponentView.mm` | `acceptsFirstResponder` honors interactive `role` / `accessibilityRole`. `needsPanelToBecomeKey` stays false. | iOS Full Keyboard Access / `canBecomeFocused` ports |
 | `be9f567c4a` | `RCTUIKitCompat.h` | `UIFontDescriptorAttributeName` aliases to `NSFontDescriptorAttributeName`. | Apple variable-font / `RCTFontUtils` |
 | `e06759da6b` | `RCTTextInputUtils.mm`, `RCTViewComponentView.mm` | `tintColor` copy stays iOS-only; unmount assert uses `RCTUIView`, not `UIView`. | TextInput backing-view swap; unmount index assert |
+| FX-124 | `RCTUITableView.{h,m}`, `RCTUIButton.{h,m}`, `RCTUILabel.m`, `RCTUIKit.h`, `RCTRedBox.mm`, `RCTRedBox2Controller.mm`, `RCTRedBox2AnsiParser*` | macOS RedBox uses V2 (`TARGET_OS_OSX` or `redBoxV2IOS()`). Keep table/button primitives and the AppKit controller. Restore iOS `autoRetryTick` background guard. Do not restore `!TARGET_OS_OSX` compile-outs on the V2 controller. | microsoft#3054 landing on `main`/`0.87-merge`; RCTUIKit table/button additions |
 
 Interrupted Core production can leave `packages/react-native/.build` mapped to
 the workspace cache. Remove that leftover before the next Core build. Do not
@@ -147,6 +157,102 @@ The committed fork versions stay `1000.0.0`. A dirty `0.87.0-rc.1` overlay is
 producer residue, not a patch. Restore with
 `git checkout --` those two paths before committing.
 
+## FX-69 source Hermes (Xcode 27 linker)
+
+Source-Hermes Apple framework scripts passed `LINKER:-ld_classic` for every
+Xcode ≥ 15. Xcode 27 removed the classic linker, so that flag fails the
+source-Hermes lane. Gate it to Xcode 15–16:
+
+- `packages/react-native/sdks/hermes-engine/utils/build-hermes-xcode.sh`
+- `packages/react-native/sdks/hermes-engine/utils/build-apple-framework.sh`
+
+Prebuilt Maven Hermes is unchanged. This is only for the source-Hermes
+compatibility lane (FX-69: rebuild V1 at `static_h` `174344e`).
+
+FX-69 V1 pin: `sdks/.hermes-source-sha` is the 40-hex facebook/hermes
+revision (currently `174344e637705bf9bfd036689e3b89ab5f67fd10`).
+`sdks/.hermesv1version` stays `hermes-v174344e.0.1` for RN version strings.
+
+`rn-macos native ensure` builds the pinned SHA tarball when it is missing.
+The VM is always MinSizeRel + `HERMESVM_ALLOW_JIT=1`, dual-arch macosx, with
+`HERMES_ENABLE_DEBUGGER` compiled in (RN still gates the inspector on Debug).
+`native ensure` / `pack native` refuse Maven and overlay destroot into consumer
+`Pods/hermes-engine` after `pod install`. Advance by changing
+`sdks/.hermes-source-sha` and running `native ensure`; roll back the same way.
+HBC remains 99.
+
+`static_h` 174344e versioned `_HERMES_CTORCONFIG_STRUCT` (`HERMES_GCCONFIG_VERSION` /
+`HERMES_RUNTIME_CONFIG_VERSION`, plus `RuntimeConfig.FinalizerThreadRunner`).
+`HermesInstance.cpp` / `HermesExecutorFactory.cpp` must compile against
+`destroot/include` from that tarball, not the 260318099 Public headers:
+`React-RuntimeHermes` HEADER_SEARCH_PATHS and Package.swift `searchPaths` put
+that include first, and both TUs `#error` if the version macros are missing.
+Local tarball `HERMES_CLI_PATH` is `destroot/bin/hermesc` (not hermes-compiler npm).
+
+## FX-124 RedBox 2.0 AppKit (microsoft#3054)
+
+macOS Debug compile/fatal overlay. Tracking: FX-124 (parent), FX-125 (this
+adaptation).
+
+Provenance is microsoft/react-native-macos#3054 head `c631f745` (tree
+`be278997`). Taken:
+
+- RCTUIKit primitives: `RCTUITableView`, `RCTUIButton`, `RCTUILabel`
+  getter/setter completions, umbrella imports
+- RedBox 2.0 AppKit controller + ANSI parser un-gating
+- `RCTRedBox.mm` reachability so macOS can instantiate V2
+
+Not taken: #3058 (0.85 RN merge; already an ancestor of `aw/0.87`), #3056 V1
+table consumer, native tests, RNTester project wiring.
+
+Local deltas on top of #3054:
+
+- macOS always selects RedBox 2.0 (`TARGET_OS_OSX || redBoxV2IOS()`). The
+  `redBoxV2IOS` default stays `false` so iOS is unchanged.
+- `autoRetryTick` keeps the iOS `UIApplicationStateActive` guard that #3054
+  dropped for AppKit.
+- Parser accepts Metro 0.87 oxc `path: message` syntax errors and
+  `Unable to resolve module … from …:` frames (not only Babel
+  `TransformError` / `UnableToResolveError in /path: msg (line:col)`).
+  Resolve errors expose specifier, importer, and tried paths. Code-frame
+  `> N |` fills row when Metro omits `(line:col)`.
+- macOS overlay is an inspector (kind, location, specifier/tried, source),
+  not a LogBox red banner. Copy emits that structured report. Clicking the
+  summary or source opens the file via `/open-stack-frame`.
+- AppKit sheet tracks `_sheetPresented` plus the host captured at present
+  time. Dismiss pairs `presentViewControllerAsSheet:` with
+  `dismissViewController:` on that host (not `RCTKeyWindow()`, which is
+  the sheet). `endSheet` alone leaves the VC presented and the next
+  present asserts. Auto-retry timer is added to `NSModalPanelRunLoopMode`.
+- `RCTUILabel` wrapping + `RCTUITableView` automatic row measurement.
+  Custom RedBox cells call `prepareForCustomContent` so the empty default
+  `textLabel` does not pin the row to ~2px.
+- Single presenter on macOS: DEV JS errors (fatals, component errors,
+  `console.error`, Metro compile) and native `RCTLog` / bundle-load
+  failures go to `RCTRedBox2Controller`. Warnings (`Warning:` / `type:
+  warn`) stay out of the overlay. LogBox's `RCTLogBoxView` sheet is not
+  shown. Overlay chrome follows Expo LogBox (kind chip, source card,
+  collapsed ignore-listed frames).
+
+RedBox overlay iteration must not go through APP1 `native ensure` (Core
+fingerprint invalidates every selected Pod). Use RNTester-macOS against
+this worktree (fork source + pinned Hermes destroot tarball, not Maven):
+
+- Parser: compile `ReactCommon/react/debug/redbox/RedBoxErrorParser.cpp`
+  with a tiny driver (seconds).
+- Overlay GUI: `packages/rn-tester/scripts/run-macos-redbox.sh`. `pods`
+  sets `HERMES_ENGINE_TARBALL_PATH` from `sdks/.hermes-source-sha`,
+  `RCT_NEW_ARCH_ENABLED=1`, `RN_PLATFORMS=macOS`, overlays destroot
+  (`HERMES_GCCONFIG_VERSION`), then Debug-builds. APIs → **RedBox 2.0
+  overlay**. Canned fatal messages do not rebuild native. Break
+  `js/RedBoxCompileProbe.js` and save for a real Metro overlay.
+- APP1 pack + `native ensure --configuration Debug` only when a batch is
+  ready to land on the packed consumer.
+
+This invalidates React Core (RCTUIKit + CoreModules). After the fork commit:
+pack the npm closure and rebuild native dependency artifacts before a session
+can show the new sheet.
+
 ## The Hermes 0.87 patch set (`3184529fff`)
 
 24 files, consolidating the fork's runtime changes for the Hermes 0.87 /