feat(react-grab): add silent option to suppress intro log

.changeset/silent-intro-option.md

@@ -0,0 +1,7 @@
+---
+"react-grab": minor
+"grab": minor
+"@react-grab/cli": minor
+---
+
+Add `silent` option to suppress the React Grab intro banner and version-check log. Useful when console output is forwarded to error tracking services like Sentry.

packages/react-grab/src/core/index.tsx

@@ -197,10 +197,12 @@ export const init = (rawOptions?: Options): ReactGrabAPI => {
   }
   hasInited = true;
 
-  logIntro();
+  if (!initialOptions.silent) {
+    logIntro();
+  }
 
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars -- need to omit enabled from settableOptions to avoid circular dependency
-  const { enabled: _enabled, ...settableOptions } = initialOptions;
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars -- need to omit init-only options from settableOptions to avoid circular dependency
+  const { enabled: _enabled, silent: _silent, ...settableOptions } = initialOptions;
 
   return createRoot((dispose) => {
     let disposed = false;

packages/react-grab/src/types.ts

@@ -252,10 +252,18 @@ export interface Options {
    * @default true
    */
   freezeReactUpdates?: boolean;
+  /**
+   * Suppress the React Grab intro banner and version-check log.
+   * Useful when console output is forwarded to error tracking
+   * services like Sentry.
+   * @default false
+   */
+  silent?: boolean;
 }
 
 export interface SettableOptions extends Options {
   enabled?: never;
+  silent?: never;
 }
 
 export interface SourceInfo {

packages/react-grab/src/utils/get-script-options.ts

@@ -30,6 +30,9 @@ const parseOptionsFromJson = (rawValue: unknown): Partial<Options> | null => {
   if (typeof rawValue.freezeReactUpdates === "boolean") {
     parsedOptions.freezeReactUpdates = rawValue.freezeReactUpdates;
   }
+  if (typeof rawValue.silent === "boolean") {
+    parsedOptions.silent = rawValue.silent;
+  }
 
   if (Object.keys(parsedOptions).length === 0) return null;
   return parsedOptions;