feat: add globalPropsMode option to PluginReactLynxOptions

.changeset/funny-weeks-stand.md

@@ -0,0 +1,12 @@
+---
+'@lynx-js/react': minor
+---
+
+feat: export `GlobalPropsProvider`, `GlobalPropsConsumer`, `useGlobalProps` and `useGlobalPropsChanged` for `__globalProps`
+
+- `GlobalPropsProvider`: A Provider component that accepts `children`. It is used to provide the `lynx.__globalProps` context.
+- `GlobalPropsConsumer`: A Consumer component that accepts a function as a child. It is used to consume the `lynx.__globalProps` context.
+- `useGlobalProps`: A hook that returns the `lynx.__globalProps` object. It triggers a re-render when `lynx.__globalProps` changes.
+- `useGlobalPropsChanged`: A hook that accepts a callback function. The callback is invoked when `lynx.__globalProps` changes.
+
+Note: When `globalPropsMode` is not set to `'event'` (default is `'reactive'`), these APIs will be ineffective (pass-through) and will log a warning in development mode, as updates are triggered automatically by full re-render.

.changeset/thirty-cycles-find.md

@@ -0,0 +1,10 @@
+---
+'@lynx-js/react-rsbuild-plugin': minor
+"@lynx-js/react-webpack-plugin": minor
+'@lynx-js/react': minor
+---
+
+feat: add `globalPropsMode` option to `PluginReactLynxOptions`
+
+- When configured to `"event"`, `updateGlobalProps` will only trigger a global event and skip the `runWithForce` flow.
+- Defaults to `"reactive"`, which means `updateGlobalProps` will trigger re-render automatically.

packages/react/etc/react.api.md

@@ -66,6 +66,22 @@ export { forwardRef }
 
 export { Fragment }
 
+// @public
+export interface GlobalProps {
+}
+
+// Warning: (tsdoc-undefined-tag) The TSDoc tag "@group" is not defined in this configuration
+//
+// @public
+export const GlobalPropsConsumer: Consumer<GlobalProps>;
+
+// Warning: (tsdoc-undefined-tag) The TSDoc tag "@group" is not defined in this configuration
+//
+// @public
+export const GlobalPropsProvider: FC<{
+    children?: ReactNode | undefined;
+}>;
+
 // @public
 export interface InitData {
 }
@@ -136,6 +152,12 @@ export const useEffect: (effect: EffectCallback, deps?: DependencyList) => void;
 
 export { useErrorBoundary }
 
+// @public
+export const useGlobalProps: () => GlobalProps;
+
+// @public
+export const useGlobalPropsChanged: (callback: (data: GlobalProps) => void) => void;
+
 export { useImperativeHandle }
 
 // @public