react-native-windows 0.81.36 → 0.81.38

package/Microsoft.ReactNative/Fabric/Composition/TextInput/WindowsTextInputProps.h

@@ -85,7 +85,7 @@ static inline void fromRawValue(
   }
 }
 
-class WindowsTextInputProps final : public ViewProps, public BaseTextProps {
+class WindowsTextInputProps : public ViewProps, public BaseTextProps {
  public:
   WindowsTextInputProps() = default;
   WindowsTextInputProps(

package/Microsoft.ReactNative/Fabric/Composition/TextInput/WindowsTextInputShadowNode.cpp

@@ -1,213 +1,8 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 
-#include "WindowsTextInputShadowNode.h"
-
-#include <react/featureflags/ReactNativeFeatureFlags.h>
-#include <react/renderer/attributedstring/AttributedStringBox.h>
-#include <react/renderer/attributedstring/PlaceholderAttributedString.h>
-#include <react/renderer/attributedstring/TextAttributes.h>
-#include <react/renderer/components/text/BaseTextShadowNode.h>
-#include <react/renderer/core/LayoutConstraints.h>
-#include <react/renderer/core/LayoutContext.h>
-#include <react/renderer/core/conversions.h>
-#include <react/renderer/textlayoutmanager/TextLayoutContext.h>
-
 namespace facebook::react {
 
 extern const char WindowsTextInputComponentName[] = "WindowsTextInput";
 
-void WindowsTextInputShadowNode::setTextLayoutManager(std::shared_ptr<const TextLayoutManager> textLayoutManager) {
-  ensureUnsealed();
-  textLayoutManager_ = std::move(textLayoutManager);
-}
-
-Size WindowsTextInputShadowNode::measureContent(
-    const LayoutContext &layoutContext,
-    const LayoutConstraints &layoutConstraints) const {
-  // Layout is called right after measure.
-  // Measure is marked as `const`, and `layout` is not; so State can be
-  // updated during layout, but not during `measure`. If State is out-of-date
-  // in layout, it's too late: measure will have already operated on old
-  // State. Thus, we use the same value here that we *will* use in layout to
-  // update the state.
-  AttributedString attributedString = getMostRecentAttributedString(layoutContext);
-
-  if (attributedString.isEmpty()) {
-    attributedString = getPlaceholderAttributedString(layoutContext);
-  }
-
-  // BaseTextShadowNode only gets children. We must detect and prepend text
-  // value attributes manually.
-  if (!getConcreteProps().text.empty()) {
-    auto textAttributes = TextAttributes::defaultTextAttributes();
-    textAttributes.apply(getConcreteProps().textAttributes);
-    auto fragment = AttributedString::Fragment{};
-    fragment.string = getConcreteProps().text;
-    fragment.textAttributes = textAttributes;
-    // If the TextInput opacity is 0 < n < 1, the opacity of the TextInput and
-    // text value's background will stack. This is a hack/workaround to prevent
-    // that effect.
-    fragment.textAttributes.backgroundColor = clearColor();
-    fragment.parentShadowView = ShadowView(*this);
-    attributedString.prependFragment(std::move(fragment));
-  }
-
-  TextLayoutContext textLayoutContext;
-  textLayoutContext.pointScaleFactor = layoutContext.pointScaleFactor;
-
-  facebook::react::ParagraphAttributes paragraphAttributes{};
-  paragraphAttributes.maximumNumberOfLines = getConcreteProps().multiline ? 0 : 1;
-  return textLayoutManager_
-      ->measure(AttributedStringBox{attributedString}, paragraphAttributes, textLayoutContext, layoutConstraints)
-      .size;
-}
-
-void WindowsTextInputShadowNode::layout(LayoutContext layoutContext) {
-  updateStateIfNeeded(layoutContext);
-  ConcreteViewShadowNode::layout(layoutContext);
-}
-
-LayoutConstraints WindowsTextInputShadowNode::getTextConstraints(const LayoutConstraints &layoutConstraints) const {
-  if (getConcreteProps().multiline) {
-    return layoutConstraints;
-  } else {
-    // A single line TextInput acts as a horizontal scroller of infinitely
-    // expandable text, so we want to measure the text as if it is allowed to
-    // infinitely expand horizontally, and later clamp to the constraints of the
-    // input.
-    return LayoutConstraints{
-        .minimumSize = layoutConstraints.minimumSize,
-        .maximumSize =
-            Size{
-                .width = std::numeric_limits<Float>::infinity(),
-                .height = layoutConstraints.maximumSize.height,
-            },
-        .layoutDirection = layoutConstraints.layoutDirection,
-    };
-  }
-}
-
-void WindowsTextInputShadowNode::updateStateIfNeeded(const LayoutContext &layoutContext) {
-  ensureUnsealed();
-  const auto &stateData = getStateData();
-  auto reactTreeAttributedString = getAttributedString(layoutContext);
-
-  // Tree is often out of sync with the value of the TextInput.
-  // This is by design - don't change the value of the TextInput in the State,
-  // and therefore in Java, unless the tree itself changes.
-  if (stateData.reactTreeAttributedString == reactTreeAttributedString) {
-    return;
-  }
-
-  // If props event counter is less than what we already have in state, skip it
-  const auto &props = BaseShadowNode::getConcreteProps();
-  if (props.mostRecentEventCount < stateData.mostRecentEventCount) {
-    return;
-  }
-
-  // Store default TextAttributes in state.
-  // In the case where the TextInput is completely empty (no value, no
-  // defaultValue, no placeholder, no children) there are therefore no fragments
-  // in the AttributedString, and when State is updated, it needs some way to
-  // reconstruct a Fragment with default TextAttributes.
-  auto defaultTextAttributes = TextAttributes::defaultTextAttributes();
-  defaultTextAttributes.fontSizeMultiplier = layoutContext.fontSizeMultiplier;
-  defaultTextAttributes.apply(getConcreteProps().textAttributes);
-
-  auto newEventCount = stateData.reactTreeAttributedString.isContentEqual(reactTreeAttributedString)
-      ? 0
-      : getConcreteProps().mostRecentEventCount;
-  auto newAttributedString = getMostRecentAttributedString(layoutContext);
-
-  // Even if we're here and updating state, it may be only to update the layout
-  // manager If that is the case, make sure we don't update text: pass in the
-  // current attributedString unchanged, and pass in zero for the "event count"
-  // so no changes are applied There's no way to prevent a state update from
-  // flowing to Java, so we just ensure it's a noop in those cases.
-
-  setStateData(
-      WindowsTextInputState{AttributedStringBox(newAttributedString), reactTreeAttributedString, {}, newEventCount});
-}
-
-AttributedString WindowsTextInputShadowNode::getAttributedString(const LayoutContext &layoutContext) const {
-  // Use BaseTextShadowNode to get attributed string from children
-
-  auto childTextAttributes = TextAttributes::defaultTextAttributes();
-  childTextAttributes.fontSizeMultiplier = layoutContext.fontSizeMultiplier;
-  childTextAttributes.apply(getConcreteProps().textAttributes);
-  // Don't propagate the background color of the TextInput onto the attributed
-  // string. Android tries to render shadow of the background alongside the
-  // shadow of the text which results in weird artifacts.
-  childTextAttributes.backgroundColor = HostPlatformColor::UndefinedColor;
-
-  auto attributedString = AttributedString{};
-  auto attachments = BaseTextShadowNode::Attachments{};
-  BaseTextShadowNode::buildAttributedString(childTextAttributes, *this, attributedString, attachments);
-  attributedString.setBaseTextAttributes(childTextAttributes);
-
-  // BaseTextShadowNode only gets children. We must detect and prepend text
-  // value attributes manually.
-  if (!getConcreteProps().text.empty()) {
-    auto textAttributes = TextAttributes::defaultTextAttributes();
-    textAttributes.fontSizeMultiplier = layoutContext.fontSizeMultiplier;
-    textAttributes.apply(getConcreteProps().textAttributes);
-    textAttributes.fontSizeMultiplier = layoutContext.fontSizeMultiplier;
-    auto fragment = AttributedString::Fragment{};
-    fragment.string = getConcreteProps().text;
-    fragment.textAttributes = textAttributes;
-    // If the TextInput opacity is 0 < n < 1, the opacity of the TextInput and
-    // text value's background will stack. This is a hack/workaround to prevent
-    // that effect.
-    fragment.textAttributes.backgroundColor = clearColor();
-    fragment.parentShadowView = ShadowView(*this);
-    attributedString.prependFragment(std::move(fragment));
-  }
-
-  return attributedString;
-}
-
-AttributedString WindowsTextInputShadowNode::getMostRecentAttributedString(const LayoutContext &layoutContext) const {
-  const auto &state = getStateData();
-
-  auto reactTreeAttributedString = getAttributedString(layoutContext);
-
-  // Sometimes the treeAttributedString will only differ from the state
-  // not by inherent properties (string or prop attributes), but by the frame of
-  // the parent which has changed Thus, we can't directly compare the entire
-  // AttributedString
-  bool treeAttributedStringChanged =
-      !state.reactTreeAttributedString.compareTextAttributesWithoutFrame(reactTreeAttributedString);
-
-  return (!treeAttributedStringChanged ? state.attributedStringBox.getValue() : reactTreeAttributedString);
-}
-
-AttributedString WindowsTextInputShadowNode::getPlaceholderAttributedString(const LayoutContext &layoutContext) const {
-  const auto &props = getConcreteProps();
-
-  AttributedString attributedString;
-  attributedString.setBaseTextAttributes(props.textAttributes);
-  //[windows
-  if (!props.placeholder.empty()) {
-    auto textAttributes = TextAttributes::defaultTextAttributes();
-    textAttributes.fontSizeMultiplier = layoutContext.fontSizeMultiplier;
-    textAttributes.apply(props.textAttributes);
-
-    /*
-     * These props are applied to `View`, therefore they must not be a part of
-     * base text attributes.
-     */
-    textAttributes.backgroundColor = clearColor();
-    textAttributes.opacity = 1;
-
-    attributedString.appendFragment(
-        {.string = props.placeholder, .textAttributes = textAttributes, .parentShadowView = ShadowView(*this)});
-  }
-  // windows]
-
-  return ensurePlaceholderIfEmpty_DO_NOT_USE(attributedString);
-}
-
-#pragma mark - LayoutableShadowNode
-
 } // namespace facebook::react

package/Microsoft.ReactNative/Fabric/Composition/TextInput/WindowsTextInputShadowNode.h

@@ -3,84 +3,41 @@
 
 #pragma once
 
-#include <react/renderer/textlayoutmanager/WindowsTextLayoutManager.h>
+#include "ConcreteTextInputShadowNode.h"
 #include "WindowsTextInputEventEmitter.h"
 #include "WindowsTextInputProps.h"
 #include "WindowsTextInputState.h"
 
-#include <react/components/rnwcore/EventEmitters.h>
-#include <unordered_map>
-
+#include <react/featureflags/ReactNativeFeatureFlags.h>
 #include <react/renderer/attributedstring/AttributedString.h>
-#include <react/renderer/components/view/ConcreteViewShadowNode.h>
-#include <react/utils/ContextContainer.h>
+#include <react/renderer/attributedstring/AttributedStringBox.h>
+#include <react/renderer/core/conversions.h>
 
 namespace facebook::react {
 
 extern const char WindowsTextInputComponentName[];
 
-/*
- * `ShadowNode` for <WindowsTextInput> component.
- */
-class WindowsTextInputShadowNode final : public ConcreteViewShadowNode<
+class WindowsTextInputShadowNode final : public ConcreteTextInputShadowNode<
                                              WindowsTextInputComponentName,
-                                             WindowsTextInputProps,
-                                             WindowsTextInputEventEmitter,
-                                             WindowsTextInputState> {
+                                             facebook::react::WindowsTextInputProps,
+                                             facebook::react::WindowsTextInputEventEmitter,
+                                             facebook::react::WindowsTextInputState> {
  public:
-  using ConcreteViewShadowNode::ConcreteViewShadowNode;
-
-  static ShadowNodeTraits BaseTraits() {
-    auto traits = ConcreteViewShadowNode::BaseTraits();
-    traits.set(ShadowNodeTraits::Trait::LeafYogaNode);
-    traits.set(ShadowNodeTraits::Trait::MeasurableYogaNode);
-    traits.set(ShadowNodeTraits::Trait::BaselineYogaNode);
-    return traits;
-  }
-
-  /*
-   * Associates a shared TextLayoutManager with the node.
-   * `TextInputShadowNode` uses the manager to measure text content
-   * and construct `TextInputState` objects.
-   */
-  void setTextLayoutManager(std::shared_ptr<const TextLayoutManager> textLayoutManager);
-
-#pragma mark - LayoutableShadowNode
- protected:
-  Size measureContent(const LayoutContext &layoutContext, const LayoutConstraints &layoutConstraints) const override;
-
-  void layout(LayoutContext layoutContext) override;
-
-  Float baseline(const LayoutContext &layoutContext, Size size) const override {
-    // Calculate baseline as 80% of the text height
-    return size.height * 0.8f;
+  using Super = ConcreteTextInputShadowNode<
+      WindowsTextInputComponentName,
+      facebook::react::WindowsTextInputProps,
+      facebook::react::WindowsTextInputEventEmitter,
+      facebook::react::WindowsTextInputState>;
+  using Super::Super;
+
+  void updateTextInputState(
+      facebook::react::AttributedStringBox attributedStringBox,
+      facebook::react::AttributedString &reactTreeAttributedString,
+      facebook::react::ParagraphAttributes paragraphAttributes,
+      int64_t mostRecentEventCount) override {
+    Super::setStateData(facebook::react::WindowsTextInputState{
+        attributedStringBox, reactTreeAttributedString, paragraphAttributes, mostRecentEventCount});
   }
-
-  std::shared_ptr<const TextLayoutManager> textLayoutManager_;
-
-  /*
-   * Determines the constraints to use while measure the underlying text
-   */
-  LayoutConstraints getTextConstraints(const LayoutConstraints &layoutConstraints) const;
-
- private:
-  /*
-   * Creates a `State` object (with `AttributedText` and
-   * `TextLayoutManager`) if needed.
-   */
-  void updateStateIfNeeded(const LayoutContext &layoutContext);
-
-  /*
-   * Returns a `AttributedString` which represents text content of the node.
-   */
-  AttributedString getAttributedString(const LayoutContext &layoutContext) const;
-
-  /**
-   * Get the most up-to-date attributed string for measurement and State.
-   */
-  AttributedString getMostRecentAttributedString(const LayoutContext &layoutContext) const;
-
-  AttributedString getPlaceholderAttributedString(const LayoutContext &layoutContext) const;
 };
 
 } // namespace facebook::react

package/Microsoft.ReactNative/Fabric/Composition/TextInput/WindowsTextInputState.h

@@ -11,6 +11,7 @@
 #include <react/renderer/attributedstring/ParagraphAttributes.h>
 #include <react/renderer/textlayoutmanager/TextLayoutManager.h>
 
+#include <Fabric/AbiState.h>
 #include <folly/dynamic.h>
 #include <react/renderer/mapbuffer/MapBuffer.h>
 #include <react/renderer/mapbuffer/MapBufferBuilder.h> // [windows]
@@ -20,7 +21,7 @@ namespace facebook::react {
 /*
  * State for <TextInput> component.
  */
-class WindowsTextInputState final {
+class WindowsTextInputState {
  public:
   WindowsTextInputState() = default;
 

package/Microsoft.ReactNative/Fabric/WindowsComponentDescriptorRegistry.cpp

@@ -5,7 +5,6 @@
 #include "WindowsComponentDescriptorRegistry.h"
 
 #include <Fabric/AbiComponentDescriptor.h>
-#include <Fabric/AbiViewComponentDescriptor.h>
 #include <Fabric/Composition/TextInput/WindowsTextInputComponentDescriptor.h>
 #include <react/components/rnwcore/ComponentDescriptors.h>
 #include <react/renderer/components/image/ImageComponentDescriptor.h>

package/Microsoft.ReactNative/IReactCompositionViewComponentBuilder.idl

@@ -25,6 +25,10 @@ namespace Microsoft.ReactNative.Composition
   [experimental]
   delegate void PortalComponentViewInitializer(PortalComponentView view);
 
+  [webhosthidden]
+  [experimental]
+  delegate void TextInputComponentViewInitializer(WindowsTextInputComponentView view);
+
   [experimental]
   [webhosthidden]
   delegate Microsoft.UI.Composition.Visual CreateVisualDelegate(Microsoft.ReactNative.ComponentView view);
@@ -69,6 +73,7 @@ namespace Microsoft.ReactNative.Composition
     void SetViewComponentViewInitializer(ViewComponentViewInitializer initializer);
     void SetContentIslandComponentViewInitializer(ComponentIslandComponentViewInitializer initializer);
     void SetPortalComponentViewInitializer(PortalComponentViewInitializer initializer);
+    void SetTextInputComponentViewInitializer(TextInputComponentViewInitializer initializer);
     void SetCreateVisualHandler(CreateVisualDelegate impl);
     void SetViewFeatures(ComponentViewFeatures viewFeatures);
     void SetUpdateLayoutMetricsHandler(UpdateLayoutMetricsDelegate impl);

package/Microsoft.ReactNative/TurboModulesProvider.cpp

@@ -36,7 +36,8 @@ struct TurboModuleMethodInfo {
 };
 
 struct TurboModuleBuilder : winrt::implements<TurboModuleBuilder, IReactModuleBuilder> {
-  TurboModuleBuilder(const IReactContext &reactContext) noexcept : m_reactContext(reactContext) {}
+  TurboModuleBuilder(const IReactContext &reactContext, IInspectable runtimeHandle) noexcept
+      : m_reactContext(reactContext), m_runtimeHandle(std::move(runtimeHandle)) {}
 
  public: // IReactModuleBuilder
   void AddInitializer(InitializerDelegate const &initializer) noexcept {
@@ -44,11 +45,7 @@ struct TurboModuleBuilder : winrt::implements<TurboModuleBuilder, IReactModuleBu
   }
 
   void AddJsiInitializer(JsiInitializerDelegate const &initializer) noexcept {
-    initializer(
-        m_reactContext,
-        winrt::get_self<winrt::Microsoft::ReactNative::implementation::ReactContext>(m_reactContext)
-            ->GetInner()
-            .JsiRuntime());
+    initializer(m_reactContext, m_runtimeHandle);
   }
 
   void AddConstantProvider(ConstantProviderDelegate const &constantProvider) noexcept {
@@ -91,6 +88,10 @@ struct TurboModuleBuilder : winrt::implements<TurboModuleBuilder, IReactModuleBu
     return m_eventEmitters;
   }
 
+  void CompleteRegistration() noexcept {
+    m_runtimeHandle = nullptr;
+  }
+
  private:
   void EnsureMemberNotSet(const std::string &key, bool checkingMethod) noexcept {
     VerifyElseCrash(m_methods.find(key) == m_methods.end());
@@ -103,6 +104,7 @@ struct TurboModuleBuilder : winrt::implements<TurboModuleBuilder, IReactModuleBu
 
  private:
   IReactContext m_reactContext;
+  IInspectable m_runtimeHandle;
   std::unordered_map<std::string, EventEmitterInitializerDelegate> m_eventEmitters;
   std::unordered_map<std::string, TurboModuleMethodInfo> m_methods;
   std::unordered_map<std::string, SyncMethodDelegate> m_syncMethods;
@@ -121,17 +123,16 @@ class TurboModuleImpl : public facebook::react::TurboModule {
       const std::string &name,
       const std::shared_ptr<facebook::react::CallInvoker> &jsInvoker,
       std::weak_ptr<facebook::react::LongLivedObjectCollection> longLivedObjectCollection,
+      IInspectable runtimeHandle,
       const ReactModuleProvider &reactModuleProvider)
       : facebook::react::TurboModule(name, jsInvoker),
         m_reactContext(reactContext),
         m_longLivedObjectCollection(std::move(longLivedObjectCollection)),
-        m_moduleBuilder(winrt::make_self<TurboModuleBuilder>(reactContext)),
-        m_providedModule(reactModuleProvider(m_moduleBuilder.as<IReactModuleBuilder>())) {
+        m_moduleBuilder(winrt::make_self<TurboModuleBuilder>(reactContext, std::move(runtimeHandle))) {
+    m_providedModule = reactModuleProvider(m_moduleBuilder.as<IReactModuleBuilder>());
+    m_moduleBuilder->CompleteRegistration();
+
     if (auto hostObject = m_providedModule.try_as<IJsiHostObject>()) {
-      // Force ABI runtime creation if it hasn't already been created
-      winrt::get_self<winrt::Microsoft::ReactNative::implementation::ReactContext>(m_reactContext)
-          ->GetInner()
-          .JsiRuntime();
       m_hostObjectWrapper = std::make_shared<implementation::HostObjectWrapper>(hostObject);
     }
   }
@@ -488,8 +489,24 @@ std::shared_ptr<facebook::react::TurboModule> TurboModulesProvider::getModule(
     return nullptr;
   }
 
+  if (!m_reactContext) {
+    return nullptr;
+  }
+
+  auto runtimeHandle = winrt::get_self<winrt::Microsoft::ReactNative::implementation::ReactContext>(m_reactContext)
+                           ->GetInner()
+                           .JsiRuntime();
+  if (!runtimeHandle) {
+    return nullptr;
+  }
+
   auto tm = std::make_shared<TurboModuleImpl>(
-      m_reactContext, moduleName, callInvoker, m_longLivedObjectCollection, /*reactModuleProvider*/ it->second);
+      m_reactContext,
+      moduleName,
+      callInvoker,
+      m_longLivedObjectCollection,
+      std::move(runtimeHandle),
+      /*reactModuleProvider*/ it->second);
   return tm;
 }
 

package/Microsoft.ReactNative/ViewProps.idl

@@ -98,5 +98,16 @@ namespace Microsoft.ReactNative {
     // TODO add accessors to all the properties on ImageProps
   }
   
+  [default_interface]
+  [webhosthidden]
+  [experimental]
+  runtimeclass TextInputProps : ViewProps
+  {
+    String Placeholder { get; };
+    Boolean SecureTextEntry { get; };
+    // TODO add accessors to all the properties on TextInputProps
+  }
+  
+  
 
 } // namespace Microsoft. ReactNative

package/Microsoft.ReactNative.Cxx/ComponentView.Experimental.interop.h

@@ -3,6 +3,12 @@
 
 #pragma once
 
+// #include <tom.h>
+// #include <textserv.h>
+struct ITextDocument2;
+class ITextServices2;
+class ITextHost;
+
 namespace Microsoft::ReactNative::Composition::Experimental {
 
 // This interface will be removed once we complete internal transitions to ContentIsland, and new APIs for hosting
@@ -11,4 +17,10 @@ struct __declspec(uuid("2A60D68A-57B8-43CA-B1BA-2FAF0FCB344B")) IComponentViewIn
   virtual HWND GetHwndForParenting() noexcept = 0;
 };
 
+struct __declspec(uuid("ABA4F071-1C26-4D56-A608-75361ED21545")) ITextInputComponentInterop : IUnknown {
+  virtual HRESULT GetTextDocument(ITextDocument2 **textDocument) noexcept = 0;
+  virtual HRESULT GetTextServices(ITextServices2 **textServices) noexcept = 0;
+  virtual HRESULT GetTextHost(ITextHost **textHost) noexcept = 0;
+};
+
 } // namespace Microsoft::ReactNative::Composition::Experimental

package/PropertySheets/Generated/PackageVersion.g.props

@@ -10,11 +10,11 @@
 -->
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
-    <ReactNativeWindowsVersion>0.81.36</ReactNativeWindowsVersion>
+    <ReactNativeWindowsVersion>0.81.38</ReactNativeWindowsVersion>
     <ReactNativeWindowsMajor>0</ReactNativeWindowsMajor>
     <ReactNativeWindowsMinor>81</ReactNativeWindowsMinor>
-    <ReactNativeWindowsPatch>36</ReactNativeWindowsPatch>
+    <ReactNativeWindowsPatch>38</ReactNativeWindowsPatch>
     <ReactNativeWindowsCanary>false</ReactNativeWindowsCanary>
-    <ReactNativeWindowsCommitId>87ecc02fbc3641eb70d8179f61fdb98ba5dd8f04</ReactNativeWindowsCommitId>
+    <ReactNativeWindowsCommitId>ccb36ddd863f089338b00f6735c742d2bdf4e88f</ReactNativeWindowsCommitId>
   </PropertyGroup>
 </Project>

package/PropertySheets/WinUI.props

@@ -4,7 +4,8 @@
 
     <!--
       Internal versions are typically only located at: https://microsoft.visualstudio.com/DefaultCollection/ProjectReunion/_artifacts/feed/Project.Reunion.nuget.internal/NuGet/Microsoft.WindowsAppSDK/versions
-      For local testing of internal versions, modify WinUI3ExperimentalVersion, and comment out the additional nuget source in NuGet.Config
+      For local testing of internal versions, set WinUI3ExperimentalVersion and run
+      vnext\Scripts\EnableInternalWinAppSDKFeed.ps1 to add the internal source and its package mapping.
       When this version is updated, be sure to update the default for the enableInternalFeed parameter of /.ado/templates/enable-experimental-winui3.yml
     -->
     <WinUI3ExperimentalVersion Condition="'$(WinUI3ExperimentalVersion)'==''">1.8.251106002</WinUI3ExperimentalVersion>