react-native-boost 0.7.0 → 1.1.0

package/dist/runtime/index.d.ts

@@ -1,7 +1,16 @@
-import { TextStyle, TextProps } from 'react-native';
+import { TextProps, ViewProps, TextStyle } from 'react-native';
+import { ComponentType } from 'react';
 
+/**
+ * Recursive style prop shape accepted by runtime style helpers.
+ *
+ * @template T - Style object type.
+ */
 type GenericStyleProp<T> = null | void | T | false | '' | ReadonlyArray<GenericStyleProp<T>>;
 
+/**
+ * Maps CSS-like `userSelect` values to React Native's `selectable` prop.
+ */
 declare const userSelectToSelectableMap: {
     auto: boolean;
     text: boolean;
@@ -9,6 +18,9 @@ declare const userSelectToSelectableMap: {
     contain: boolean;
     all: boolean;
 };
+/**
+ * Maps CSS-like `verticalAlign` values to React Native's `textAlignVertical`.
+ */
 declare const verticalAlignToTextAlignVerticalMap: {
     auto: string;
     top: string;
@@ -16,11 +28,45 @@ declare const verticalAlignToTextAlignVerticalMap: {
     middle: string;
 };
 
-declare const NativeText: any;
+/**
+ * Native Text component with graceful fallback.
+ *
+ * @remarks
+ * Uses `unstable_NativeText` on supported native runtimes and falls back to `Text`
+ * on web or when the unstable export is unavailable.
+ */
+declare const NativeText: ComponentType<TextProps>;
 
-declare const NativeView: any;
+/**
+ * Native View component with graceful fallback.
+ *
+ * @remarks
+ * Uses `unstable_NativeView` on supported native runtimes and falls back to `View`
+ * on web or when the unstable export is unavailable.
+ */
+declare const NativeView: ComponentType<ViewProps>;
 
+/**
+ * Normalizes `Text` style values for `NativeText`.
+ *
+ * @param style - Style prop passed to a text-like component.
+ * @returns Native-friendly text props. Returns an empty object when `style` is falsy or cannot be normalized.
+ * @remarks
+ * - Flattens style arrays via `StyleSheet.flatten`
+ * - Converts numeric `fontWeight` values to string values
+ * - Maps `userSelect` and `verticalAlign` to native-compatible props
+ */
 declare function processTextStyle(style: GenericStyleProp<TextStyle>): Partial<TextProps>;
+/**
+ * Normalizes accessibility and ARIA props for runtime native components.
+ *
+ * @param props - Accessibility and ARIA props.
+ * @returns Props with normalized accessibility fields.
+ * @remarks
+ * - Merges `aria-label` with `accessibilityLabel`
+ * - Merges ARIA state fields into `accessibilityState`
+ * - Defaults `accessible` to `true` when omitted
+ */
 declare function processAccessibilityProps(props: Record<string, any>): Record<string, any>;
 
 export { NativeText, NativeView, processAccessibilityProps, processTextStyle, userSelectToSelectableMap, verticalAlignToTextAlignVerticalMap };

package/dist/runtime/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var reactNative = require('react-native');
+var reactNative$2 = require('react-native');
 
 const userSelectToSelectableMap = {
   auto: true,
@@ -16,9 +16,21 @@ const verticalAlignToTextAlignVerticalMap = {
   middle: "center"
 };
 
-const NativeText = reactNative.Platform.OS === "web" ? require("react-native").Text : require("react-native/Libraries/Text/TextNativeComponent").NativeText;
+const reactNative$1 = require("react-native");
+const isWeb$1 = reactNative$1.Platform.OS === "web";
+let nativeText = reactNative$1.unstable_NativeText;
+if (isWeb$1 || nativeText == null) {
+  nativeText = reactNative$1.Text;
+}
+const NativeText = nativeText;
 
-const NativeView = reactNative.Platform.OS === "web" ? require("react-native").View : require("react-native/Libraries/Components/View/ViewNativeComponent").default;
+const reactNative = require("react-native");
+const isWeb = reactNative.Platform.OS === "web";
+let nativeView = reactNative.unstable_NativeView;
+if (isWeb || nativeView == null) {
+  nativeView = reactNative.View;
+}
+const NativeView = nativeView;
 
 const propsCache = /* @__PURE__ */ new WeakMap();
 function processTextStyle(style) {
@@ -27,7 +39,7 @@ function processTextStyle(style) {
   if (props) return props;
   props = {};
   propsCache.set(style, props);
-  style = reactNative.StyleSheet.flatten(style);
+  style = reactNative$2.StyleSheet.flatten(style);
   if (!style) return {};
   if (typeof (style == null ? void 0 : style.fontWeight) === "number") {
     style.fontWeight = style.fontWeight.toString();

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/runtime/utils/constants.ts","../../src/runtime/components/native-text.tsx","../../src/runtime/components/native-view.tsx","../../src/runtime/index.ts"],"sourcesContent":["// Maps the `userSelect` prop to the native `selectable` prop\nexport const userSelectToSelectableMap = {\n  auto: true,\n  text: true,\n  none: false,\n  contain: true,\n  all: true,\n};\n\n// Maps the `verticalAlign` prop to the native `textAlignVertical` prop\nexport const verticalAlignToTextAlignVerticalMap = {\n  auto: 'auto',\n  top: 'top',\n  bottom: 'bottom',\n  middle: 'center',\n};\n","/* eslint-disable @typescript-eslint/no-require-imports,unicorn/prefer-module */\nimport { Platform } from 'react-native';\n\nexport const NativeText =\n  Platform.OS === 'web'\n    ? require('react-native').Text\n    : require('react-native/Libraries/Text/TextNativeComponent').NativeText;\n","/* eslint-disable @typescript-eslint/no-require-imports,unicorn/prefer-module */\nimport { Platform } from 'react-native';\n\nexport const NativeView =\n  Platform.OS === 'web'\n    ? require('react-native').View\n    : require('react-native/Libraries/Components/View/ViewNativeComponent').default;\n","import { TextProps, TextStyle, StyleSheet } from 'react-native';\nimport { GenericStyleProp } from './types';\nimport { userSelectToSelectableMap, verticalAlignToTextAlignVerticalMap } from './utils/constants';\n\nconst propsCache = new WeakMap();\n\nexport function processTextStyle(style: GenericStyleProp<TextStyle>): Partial<TextProps> {\n  if (!style) return {};\n\n  // Cache the computed props\n  let props = propsCache.get(style);\n  if (props) return props;\n\n  props = {};\n  propsCache.set(style, props);\n\n  style = StyleSheet.flatten(style) as TextStyle;\n\n  if (!style) return {};\n\n  if (typeof style?.fontWeight === 'number') {\n    style.fontWeight = style.fontWeight.toString() as TextStyle['fontWeight'];\n  }\n\n  if (style?.userSelect != null) {\n    props.selectable = userSelectToSelectableMap[style.userSelect];\n    delete style.userSelect;\n  }\n\n  if (style?.verticalAlign != null) {\n    style.textAlignVertical = verticalAlignToTextAlignVerticalMap[\n      style.verticalAlign\n    ] as TextStyle['textAlignVertical'];\n    delete style.verticalAlign;\n  }\n\n  props.style = style;\n  return props;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function processAccessibilityProps(props: Record<string, any>): Record<string, any> {\n  const {\n    accessibilityLabel,\n    ['aria-label']: ariaLabel,\n    accessibilityState,\n    ['aria-busy']: ariaBusy,\n    ['aria-checked']: ariaChecked,\n    ['aria-disabled']: ariaDisabled,\n    ['aria-expanded']: ariaExpanded,\n    ['aria-selected']: ariaSelected,\n    accessible,\n    ...restProperties\n  } = props;\n\n  // Merge label props: prefer the aria-label if defined.\n  const normalizedLabel = ariaLabel ?? accessibilityLabel;\n\n  // Merge the accessibilityState with any provided ARIA properties.\n  let normalizedState = accessibilityState;\n  if (ariaBusy != null || ariaChecked != null || ariaDisabled != null || ariaExpanded != null || ariaSelected != null) {\n    normalizedState =\n      normalizedState == null\n        ? {\n            busy: ariaBusy,\n            checked: ariaChecked,\n            disabled: ariaDisabled,\n            expanded: ariaExpanded,\n            selected: ariaSelected,\n          }\n        : {\n            busy: ariaBusy ?? normalizedState.busy,\n            checked: ariaChecked ?? normalizedState.checked,\n            disabled: ariaDisabled ?? normalizedState.disabled,\n            expanded: ariaExpanded ?? normalizedState.expanded,\n            selected: ariaSelected ?? normalizedState.selected,\n          };\n  }\n\n  // For the accessible prop, if not provided, default to `true`\n  const normalizedAccessible = accessible == null ? true : accessible;\n\n  return {\n    ...restProperties,\n    accessibilityLabel: normalizedLabel,\n    accessibilityState: normalizedState,\n    accessible: normalizedAccessible,\n  };\n}\n\nexport * from './types';\nexport * from './utils/constants';\nexport * from './components/native-text';\nexport * from './components/native-view';\n"],"names":["Platform","StyleSheet"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/runtime/utils/constants.ts","../../src/runtime/components/native-text.tsx","../../src/runtime/components/native-view.tsx","../../src/runtime/index.ts"],"sourcesContent":["/**\n * Maps CSS-like `userSelect` values to React Native's `selectable` prop.\n */\nexport const userSelectToSelectableMap = {\n  auto: true,\n  text: true,\n  none: false,\n  contain: true,\n  all: true,\n};\n\n/**\n * Maps CSS-like `verticalAlign` values to React Native's `textAlignVertical`.\n */\nexport const verticalAlignToTextAlignVerticalMap = {\n  auto: 'auto',\n  top: 'top',\n  bottom: 'bottom',\n  middle: 'center',\n};\n","/* eslint-disable @typescript-eslint/no-require-imports,unicorn/prefer-module */\n\nimport type { ComponentType } from 'react';\nimport type { TextProps } from 'react-native';\n\nconst reactNative = require('react-native');\nconst isWeb = reactNative.Platform.OS === 'web';\n\nlet nativeText = reactNative.unstable_NativeText;\n\nif (isWeb || nativeText == null) {\n  // Fallback to regular Text component if unstable_NativeText is not available or we're on Web\n  nativeText = reactNative.Text;\n}\n\n/**\n * Native Text component with graceful fallback.\n *\n * @remarks\n * Uses `unstable_NativeText` on supported native runtimes and falls back to `Text`\n * on web or when the unstable export is unavailable.\n */\nexport const NativeText: ComponentType<TextProps> = nativeText;\n","/* eslint-disable @typescript-eslint/no-require-imports,unicorn/prefer-module */\n\nimport type { ComponentType } from 'react';\nimport type { ViewProps } from 'react-native';\n\nconst reactNative = require('react-native');\nconst isWeb = reactNative.Platform.OS === 'web';\n\nlet nativeView = reactNative.unstable_NativeView;\n\nif (isWeb || nativeView == null) {\n  // Fallback to regular View component if unstable_NativeView is not available or we're on Web\n  nativeView = reactNative.View;\n}\n\n/**\n * Native View component with graceful fallback.\n *\n * @remarks\n * Uses `unstable_NativeView` on supported native runtimes and falls back to `View`\n * on web or when the unstable export is unavailable.\n */\nexport const NativeView: ComponentType<ViewProps> = nativeView;\n","import { TextProps, TextStyle, StyleSheet } from 'react-native';\nimport { GenericStyleProp } from './types';\nimport { userSelectToSelectableMap, verticalAlignToTextAlignVerticalMap } from './utils/constants';\n\nconst propsCache = new WeakMap();\n\n/**\n * Normalizes `Text` style values for `NativeText`.\n *\n * @param style - Style prop passed to a text-like component.\n * @returns Native-friendly text props. Returns an empty object when `style` is falsy or cannot be normalized.\n * @remarks\n * - Flattens style arrays via `StyleSheet.flatten`\n * - Converts numeric `fontWeight` values to string values\n * - Maps `userSelect` and `verticalAlign` to native-compatible props\n */\nexport function processTextStyle(style: GenericStyleProp<TextStyle>): Partial<TextProps> {\n  if (!style) return {};\n\n  // Cache the computed props\n  let props = propsCache.get(style);\n  if (props) return props;\n\n  props = {};\n  propsCache.set(style, props);\n\n  style = StyleSheet.flatten(style) as TextStyle;\n\n  if (!style) return {};\n\n  if (typeof style?.fontWeight === 'number') {\n    style.fontWeight = style.fontWeight.toString() as TextStyle['fontWeight'];\n  }\n\n  if (style?.userSelect != null) {\n    props.selectable = userSelectToSelectableMap[style.userSelect];\n    delete style.userSelect;\n  }\n\n  if (style?.verticalAlign != null) {\n    style.textAlignVertical = verticalAlignToTextAlignVerticalMap[\n      style.verticalAlign\n    ] as TextStyle['textAlignVertical'];\n    delete style.verticalAlign;\n  }\n\n  props.style = style;\n  return props;\n}\n\n/**\n * Normalizes accessibility and ARIA props for runtime native components.\n *\n * @param props - Accessibility and ARIA props.\n * @returns Props with normalized accessibility fields.\n * @remarks\n * - Merges `aria-label` with `accessibilityLabel`\n * - Merges ARIA state fields into `accessibilityState`\n * - Defaults `accessible` to `true` when omitted\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function processAccessibilityProps(props: Record<string, any>): Record<string, any> {\n  const {\n    accessibilityLabel,\n    ['aria-label']: ariaLabel,\n    accessibilityState,\n    ['aria-busy']: ariaBusy,\n    ['aria-checked']: ariaChecked,\n    ['aria-disabled']: ariaDisabled,\n    ['aria-expanded']: ariaExpanded,\n    ['aria-selected']: ariaSelected,\n    accessible,\n    ...restProperties\n  } = props;\n\n  // Merge label props: prefer the aria-label if defined.\n  const normalizedLabel = ariaLabel ?? accessibilityLabel;\n\n  // Merge the accessibilityState with any provided ARIA properties.\n  let normalizedState = accessibilityState;\n  if (ariaBusy != null || ariaChecked != null || ariaDisabled != null || ariaExpanded != null || ariaSelected != null) {\n    normalizedState =\n      normalizedState == null\n        ? {\n            busy: ariaBusy,\n            checked: ariaChecked,\n            disabled: ariaDisabled,\n            expanded: ariaExpanded,\n            selected: ariaSelected,\n          }\n        : {\n            busy: ariaBusy ?? normalizedState.busy,\n            checked: ariaChecked ?? normalizedState.checked,\n            disabled: ariaDisabled ?? normalizedState.disabled,\n            expanded: ariaExpanded ?? normalizedState.expanded,\n            selected: ariaSelected ?? normalizedState.selected,\n          };\n  }\n\n  // For the accessible prop, if not provided, default to `true`\n  const normalizedAccessible = accessible == null ? true : accessible;\n\n  return {\n    ...restProperties,\n    accessibilityLabel: normalizedLabel,\n    accessibilityState: normalizedState,\n    accessible: normalizedAccessible,\n  };\n}\n\nexport * from './types';\nexport * from './utils/constants';\nexport * from './components/native-text';\nexport * from './components/native-view';\n"],"names":["reactNative","isWeb","StyleSheet"],"mappings":"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"}

package/dist/runtime/index.web.d.ts

@@ -1,7 +1,15 @@
 import { TextStyle, TextProps } from 'react-native';
 
+/**
+ * Recursive style prop shape accepted by runtime style helpers.
+ *
+ * @template T - Style object type.
+ */
 type GenericStyleProp<T> = null | void | T | false | '' | ReadonlyArray<GenericStyleProp<T>>;
 
+/**
+ * Maps CSS-like `userSelect` values to React Native's `selectable` prop.
+ */
 declare const userSelectToSelectableMap: {
     auto: boolean;
     text: boolean;
@@ -9,6 +17,9 @@ declare const userSelectToSelectableMap: {
     contain: boolean;
     all: boolean;
 };
+/**
+ * Maps CSS-like `verticalAlign` values to React Native's `textAlignVertical`.
+ */
 declare const verticalAlignToTextAlignVerticalMap: {
     auto: string;
     top: string;

package/dist/runtime/index.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.js","sources":["../../src/runtime/utils/constants.ts","../../src/runtime/index.web.ts"],"sourcesContent":["// Maps the `userSelect` prop to the native `selectable` prop\nexport const userSelectToSelectableMap = {\n  auto: true,\n  text: true,\n  none: false,\n  contain: true,\n  all: true,\n};\n\n// Maps the `verticalAlign` prop to the native `textAlignVertical` prop\nexport const verticalAlignToTextAlignVerticalMap = {\n  auto: 'auto',\n  top: 'top',\n  bottom: 'bottom',\n  middle: 'center',\n};\n","// This is a dummy file to ensure that nothing breaks when using the runtime in a web environment.\n\nimport { TextProps, TextStyle } from 'react-native';\nimport { GenericStyleProp } from './types';\n\nexport const processTextStyle = (style: GenericStyleProp<TextStyle>) => ({ style }) as Partial<TextProps>;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function processAccessibilityProps(props: Record<string, any>): Record<string, any> {\n  return props;\n}\n\nexport * from './types';\nexport * from './utils/constants';\n\n// On Web, the native components are not available, so we use the standard components that'll be replaced by their DOM\n// equivalents by react-native-web.\n/* eslint-disable @typescript-eslint/no-require-imports,unicorn/prefer-module */\nexport const NativeText = require('react-native').Text;\nexport const NativeView = require('react-native').View;\n/* eslint-enable @typescript-eslint/no-require-imports,unicorn/prefer-module */\n"],"names":[],"mappings":";;AACO,MAAM,yBAAA,GAA4B;AAAA,EACvC,IAAA,EAAM,IAAA;AAAA,EACN,IAAA,EAAM,IAAA;AAAA,EACN,IAAA,EAAM,KAAA;AAAA,EACN,OAAA,EAAS,IAAA;AAAA,EACT,GAAA,EAAK;AACP;AAGO,MAAM,mCAAA,GAAsC;AAAA,EACjD,IAAA,EAAM,MAAA;AAAA,EACN,GAAA,EAAK,KAAA;AAAA,EACL,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ;AACV;;ACVO,MAAM,gBAAA,GAAmB,CAAC,KAAA,MAAwC,EAAE,KAAA,EAAM;AAG1E,SAAS,0BAA0B,KAAA,EAAiD;AACzF,EAAA,OAAO,KAAA;AACT;AAQO,MAAM,UAAA,GAAa,OAAA,CAAQ,cAAc,CAAA,CAAE;AAC3C,MAAM,UAAA,GAAa,OAAA,CAAQ,cAAc,CAAA,CAAE;;;;;;;;;"}
+{"version":3,"file":"index.web.js","sources":["../../src/runtime/utils/constants.ts","../../src/runtime/index.web.ts"],"sourcesContent":["/**\n * Maps CSS-like `userSelect` values to React Native's `selectable` prop.\n */\nexport const userSelectToSelectableMap = {\n  auto: true,\n  text: true,\n  none: false,\n  contain: true,\n  all: true,\n};\n\n/**\n * Maps CSS-like `verticalAlign` values to React Native's `textAlignVertical`.\n */\nexport const verticalAlignToTextAlignVerticalMap = {\n  auto: 'auto',\n  top: 'top',\n  bottom: 'bottom',\n  middle: 'center',\n};\n","// This is a dummy file to ensure that nothing breaks when using the runtime in a web environment.\n\nimport { TextProps, TextStyle } from 'react-native';\nimport { GenericStyleProp } from './types';\n\nexport const processTextStyle = (style: GenericStyleProp<TextStyle>) => ({ style }) as Partial<TextProps>;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function processAccessibilityProps(props: Record<string, any>): Record<string, any> {\n  return props;\n}\n\nexport * from './types';\nexport * from './utils/constants';\n\n// On Web, the native components are not available, so we use the standard components that'll be replaced by their DOM\n// equivalents by react-native-web.\n/* eslint-disable @typescript-eslint/no-require-imports,unicorn/prefer-module */\nexport const NativeText = require('react-native').Text;\nexport const NativeView = require('react-native').View;\n/* eslint-enable @typescript-eslint/no-require-imports,unicorn/prefer-module */\n"],"names":[],"mappings":";;AAGO,MAAM,yBAAA,GAA4B;AAAA,EACvC,IAAA,EAAM,IAAA;AAAA,EACN,IAAA,EAAM,IAAA;AAAA,EACN,IAAA,EAAM,KAAA;AAAA,EACN,OAAA,EAAS,IAAA;AAAA,EACT,GAAA,EAAK;AACP;AAKO,MAAM,mCAAA,GAAsC;AAAA,EACjD,IAAA,EAAM,MAAA;AAAA,EACN,GAAA,EAAK,KAAA;AAAA,EACL,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ;AACV;;ACdO,MAAM,gBAAA,GAAmB,CAAC,KAAA,MAAwC,EAAE,KAAA,EAAM;AAG1E,SAAS,0BAA0B,KAAA,EAAiD;AACzF,EAAA,OAAO,KAAA;AACT;AAQO,MAAM,UAAA,GAAa,OAAA,CAAQ,cAAc,CAAA,CAAE;AAC3C,MAAM,UAAA,GAAa,OAAA,CAAQ,cAAc,CAAA,CAAE;;;;;;;;;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-boost",
   "description": "🚀 Boost your React Native app's performance with a single line of code",
-  "version": "0.7.0",
+  "version": "1.1.0",
   "main": "dist/index.js",
   "module": "dist/esm/index.mjs",
   "types": "dist/index.d.ts",
@@ -109,7 +109,7 @@
   },
   "peerDependencies": {
     "react": "*",
-    "react-native": "*"
+    "react-native": ">=0.83.0"
   },
   "release-it": {
     "git": {
@@ -118,6 +118,7 @@
     },
     "npm": {
       "publish": true,
+      "skipChecks": true,
       "versionArgs": [
         "--workspaces-update=false"
       ]

package/src/plugin/index.ts

@@ -1,10 +1,17 @@
 import { declare } from '@babel/helper-plugin-utils';
 import { textOptimizer } from './optimizers/text';
-import { PluginOptions } from './types';
-import { log } from './utils/logger';
+import { PluginLogger, PluginOptions } from './types';
+import { createLogger } from './utils/logger';
 import { viewOptimizer } from './optimizers/view';
 import { isIgnoredFile } from './utils/common';
 
+export type { PluginOptimizationOptions, PluginOptions } from './types';
+
+type PluginState = {
+  opts?: PluginOptions;
+  __reactNativeBoostLogger?: PluginLogger;
+};
+
 export default declare((api) => {
   api.assertVersion(7);
 
@@ -12,8 +19,10 @@ export default declare((api) => {
     name: 'react-native-boost',
     visitor: {
       JSXOpeningElement(path, state) {
-        const options = (state.opts ?? {}) as PluginOptions;
-        const logger = options.verbose ? log : () => {};
+        const pluginState = state as PluginState;
+        const options = (pluginState.opts ?? {}) as PluginOptions;
+        const logger = getOrCreateLogger(pluginState, options);
+
         if (isIgnoredFile(path, options.ignores ?? [])) return;
         if (options.optimizations?.text !== false) textOptimizer(path, logger);
         if (options.optimizations?.view !== false) viewOptimizer(path, logger, options);
@@ -21,3 +30,16 @@ export default declare((api) => {
     },
   };
 });
+
+function getOrCreateLogger(state: PluginState, options: PluginOptions): PluginLogger {
+  if (state.__reactNativeBoostLogger) {
+    return state.__reactNativeBoostLogger;
+  }
+
+  state.__reactNativeBoostLogger = createLogger({
+    verbose: options.verbose === true,
+    silent: options.silent === true,
+  });
+
+  return state.__reactNativeBoostLogger;
+}

package/src/plugin/optimizers/text/index.ts

@@ -1,12 +1,14 @@
 import { NodePath, types as t } from '@babel/core';
-import { HubFile, Optimizer } from '../../types';
+import { HubFile, Optimizer, PluginLogger } from '../../types';
 import PluginError from '../../utils/plugin-error';
+import { BailoutCheck, getFirstBailoutReason } from '../../utils/helpers';
 import {
   addDefaultProperty,
   addFileImportHint,
   buildPropertiesFromAttributes,
   hasAccessibilityProperty,
   hasBlacklistedProperty,
+  isForcedLine,
   isIgnoredLine,
   isValidJSXComponent,
   isReactNativeImport,
@@ -36,16 +38,48 @@ export const textBlacklistedProperties = new Set([
   'selectionColor', // TODO: we can use react-native's internal `processColor` to process this at runtime
 ]);
 
-export const textOptimizer: Optimizer = (path, log = () => {}) => {
-  if (isIgnoredLine(path)) return;
+export const textOptimizer: Optimizer = (path, logger) => {
   if (!isValidJSXComponent(path, 'Text')) return;
   if (!isReactNativeImport(path, 'Text')) return;
-  if (hasBlacklistedProperty(path, textBlacklistedProperties)) return;
-  if (hasExpoRouterLinkParentWithAsChild(path)) return;
 
-  // Verify that the Text only has string children
   const parent = path.parent as t.JSXElement;
-  if (hasInvalidChildren(path, parent)) return;
+  const forced = isForcedLine(path);
+
+  const overridableChecks: BailoutCheck[] = [
+    {
+      reason: 'contains blacklisted props',
+      shouldBail: () => hasBlacklistedProperty(path, textBlacklistedProperties),
+    },
+    {
+      reason: 'is a direct child of expo-router Link with asChild',
+      shouldBail: () => hasExpoRouterLinkParentWithAsChild(path),
+    },
+    {
+      reason: 'contains non-string children',
+      shouldBail: () => hasInvalidChildren(path, parent),
+    },
+  ];
+
+  if (forced) {
+    const overriddenReason = getFirstBailoutReason(overridableChecks);
+
+    if (overriddenReason) {
+      logger.forced({ component: 'Text', path, reason: overriddenReason });
+    }
+  } else {
+    const skipReason = getFirstBailoutReason([
+      {
+        reason: 'line is marked with @boost-ignore',
+        shouldBail: () => isIgnoredLine(path),
+      },
+      ...overridableChecks,
+    ]);
+
+    if (skipReason) {
+      logger.skipped({ component: 'Text', path, reason: skipReason });
+      return;
+    }
+  }
 
   const hub = path.hub as unknown;
   const file = typeof hub === 'object' && hub !== null && 'file' in hub ? (hub.file as HubFile) : undefined;
@@ -54,12 +88,13 @@ export const textOptimizer: Optimizer = (path, log = () => {}) => {
     throw new PluginError('No file found in Babel hub');
   }
 
-  const filename = file.opts?.filename || 'unknown file';
-  const lineNumber = path.node.loc?.start.line ?? 'unknown line';
-  log(`Optimizing Text component in ${filename}:${lineNumber}`);
+  logger.optimized({
+    component: 'Text',
+    path,
+  });
 
   // Process props
-  fixNegativeNumberOfLines({ path, log });
+  fixNegativeNumberOfLines({ path, logger });
   addDefaultProperty(path, 'allowFontScaling', t.booleanLiteral(true));
   addDefaultProperty(path, 'ellipsizeMode', t.stringLiteral('tail'));
   processProps(path, file);
@@ -98,13 +133,7 @@ function hasInvalidChildren(path: NodePath<t.JSXOpeningElement>, parent: t.JSXEl
 /**
  * Fixes negative numberOfLines values by setting them to 0.
  */
-function fixNegativeNumberOfLines({
-  path,
-  log,
-}: {
-  path: NodePath<t.JSXOpeningElement>;
-  log: (message: string) => void;
-}) {
+function fixNegativeNumberOfLines({ path, logger }: { path: NodePath<t.JSXOpeningElement>; logger: PluginLogger }) {
   for (const attribute of path.node.attributes) {
     if (
       t.isJSXAttribute(attribute) &&
@@ -123,9 +152,11 @@ function fixNegativeNumberOfLines({
         originalValue = -attribute.value.expression.argument.value;
       }
       if (originalValue !== undefined && originalValue < 0) {
-        log(
-          `Warning: 'numberOfLines' in <Text> must be a non-negative number, received: ${originalValue}. The value will be set to 0.`
-        );
+        logger.warning({
+          component: 'Text',
+          path,
+          message: `'numberOfLines' must be a non-negative number, received: ${originalValue}. The value will be set to 0.`,
+        });
         attribute.value.expression = t.numericLiteral(0);
       }
     }

package/src/plugin/optimizers/view/index.ts

@@ -1,13 +1,16 @@
 import { types as t } from '@babel/core';
 import { HubFile, Optimizer } from '../../types';
 import PluginError from '../../utils/plugin-error';
+import { BailoutCheck, getFirstBailoutReason } from '../../utils/helpers';
 import {
   hasBlacklistedProperty,
+  isForcedLine,
   isIgnoredLine,
   isValidJSXComponent,
   isReactNativeImport,
   replaceWithNativeComponent,
-  hasUnsafeViewAncestor,
+  getViewAncestorClassification,
+  ViewAncestorClassification,
 } from '../../utils/common';
 
 export const viewBlacklistedProperties = new Set([
@@ -26,14 +29,58 @@ export const viewBlacklistedProperties = new Set([
   'style', // TODO: process style at runtime
 ]);
 
-export const viewOptimizer: Optimizer = (path, log = () => {}, options) => {
-  if (isIgnoredLine(path)) return;
+export const viewOptimizer: Optimizer = (path, logger, options) => {
   if (!isValidJSXComponent(path, 'View')) return;
   if (!isReactNativeImport(path, 'View')) return;
-  if (hasBlacklistedProperty(path, viewBlacklistedProperties)) return;
-  if (hasUnsafeViewAncestor(path, options?.dangerouslyOptimizeViewWithUnknownAncestors === true)) return;
 
-  // Extract the file from the Babel hub
+  let ancestorClassification: ViewAncestorClassification | undefined;
+  const getAncestorClassification = () => {
+    if (!ancestorClassification) {
+      ancestorClassification = getViewAncestorClassification(path);
+    }
+
+    return ancestorClassification;
+  };
+
+  const forced = isForcedLine(path);
+
+  const overridableChecks: BailoutCheck[] = [
+    {
+      reason: 'contains blacklisted props',
+      shouldBail: () => hasBlacklistedProperty(path, viewBlacklistedProperties),
+    },
+    {
+      reason: 'has Text ancestor',
+      shouldBail: () => getAncestorClassification() === 'text',
+    },
+    {
+      reason: 'has unresolved ancestor and dangerous optimization is disabled',
+      shouldBail: () =>
+        getAncestorClassification() === 'unknown' && options?.dangerouslyOptimizeViewWithUnknownAncestors !== true,
+    },
+  ];
+
+  if (forced) {
+    const overriddenReason = getFirstBailoutReason(overridableChecks);
+
+    if (overriddenReason) {
+      logger.forced({ component: 'View', path, reason: overriddenReason });
+    }
+  } else {
+    const skipReason = getFirstBailoutReason([
+      {
+        reason: 'line is marked with @boost-ignore',
+        shouldBail: () => isIgnoredLine(path),
+      },
+      ...overridableChecks,
+    ]);
+
+    if (skipReason) {
+      logger.skipped({ component: 'View', path, reason: skipReason });
+      return;
+    }
+  }
+
   const hub = path.hub as unknown;
   const file = typeof hub === 'object' && hub !== null && 'file' in hub ? (hub.file as HubFile) : undefined;
 
@@ -41,12 +88,12 @@ export const viewOptimizer: Optimizer = (path, log = () => {}, options) => {
     throw new PluginError('No file found in Babel hub');
   }
 
-  const filename = file.opts?.filename || 'unknown file';
-  const lineNumber = path.node.loc?.start.line ?? 'unknown line';
-  log(`Optimizing View component in ${filename}:${lineNumber}`);
+  logger.optimized({
+    component: 'View',
+    path,
+  });
 
   const parent = path.parent as t.JSXElement;
 
-  // Replace the View component with NativeView
   replaceWithNativeComponent(path, parent, file, 'NativeView');
 };

package/src/plugin/types/index.ts

@@ -1,44 +1,84 @@
 import { NodePath, types as t } from '@babel/core';
 
+export interface PluginOptimizationOptions {
+  /**
+   * Whether to optimize the `Text` component.
+   * @default true
+   */
+  text?: boolean;
+  /**
+   * Whether to optimize the `View` component.
+   * @default true
+   */
+  view?: boolean;
+}
+
 export interface PluginOptions {
   /**
-   * Paths to ignore from optimization. Relative to the Babel configuration file.
+   * Paths to ignore from optimization.
+   *
+   * Patterns are resolved from Babel's current working directory.
+   * In nested monorepo apps, parent segments may be needed, for example `../../node_modules/**`.
+   * @default []
    */
   ignores?: string[];
   /**
-   * Whether or not to log optimized files to the console.
+   * Enables verbose logging.
+   *
+   * With `silent: false`, optimized components are logged by default.
+   * When enabled, skipped components and their skip reasons are also logged.
    * @default false
    */
   verbose?: boolean;
   /**
-   * The optimizations to apply to the plugin.
+   * Disables all plugin logs.
+   *
+   * When set to `true`, this overrides `verbose`.
+   * @default false
    */
-  optimizations?: {
-    /**
-     * Whether or not to optimize the Text component.
-     * @default true
-     */
-    text?: boolean;
-    /**
-     * Whether or not to optimize the View component.
-     * @default true
-     */
-    view?: boolean;
-  };
+  silent?: boolean;
+  /**
+   * Toggle individual optimizers.
+   *
+   * If omitted, all available optimizers are enabled.
+   */
+  optimizations?: PluginOptimizationOptions;
   /**
    * Opt-in flag that allows View optimization when ancestor components cannot be statically resolved.
    *
-   * This may introduce behavioral changes when unresolved ancestors render react-native Text wrappers.
+   * This increases optimization coverage, but may introduce behavioral differences
+   * when unresolved ancestors render React Native `Text` wrappers.
+   * Prefer targeted ignores first, and enable this only after verifying affected screens.
    * @default false
    */
   dangerouslyOptimizeViewWithUnknownAncestors?: boolean;
 }
 
-export type Optimizer = (
-  path: NodePath<t.JSXOpeningElement>,
-  log?: (message: string) => void,
-  options?: PluginOptions
-) => void;
+export type OptimizableComponent = 'Text' | 'View';
+
+export interface OptimizationLogPayload {
+  component: OptimizableComponent;
+  path: NodePath<t.JSXOpeningElement>;
+}
+
+export interface SkippedOptimizationLogPayload extends OptimizationLogPayload {
+  reason: string;
+}
+
+export interface WarningLogPayload {
+  message: string;
+  component?: OptimizableComponent;
+  path?: NodePath<t.JSXOpeningElement>;
+}
+
+export interface PluginLogger {
+  optimized: (payload: OptimizationLogPayload) => void;
+  skipped: (payload: SkippedOptimizationLogPayload) => void;
+  forced: (payload: SkippedOptimizationLogPayload) => void;
+  warning: (payload: WarningLogPayload) => void;
+}
+
+export type Optimizer = (path: NodePath<t.JSXOpeningElement>, logger: PluginLogger, options?: PluginOptions) => void;
 
 export type HubFile = t.File & {
   opts: {