@ohos-ports/react-native-navigation 8.9.0-beta.4 → 8.9.0-beta.6

package/lib/cjs/processors/LayoutProcessorsStore.js

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var LayoutProcessorsStore_exports = {};
+__export(LayoutProcessorsStore_exports, {
+  LayoutProcessorsStore: () => LayoutProcessorsStore
+});
+module.exports = __toCommonJS(LayoutProcessorsStore_exports);
+class LayoutProcessorsStore {
+  layoutProcessors = [];
+  addProcessor(processor) {
+    this.layoutProcessors.push(processor);
+    return {
+      remove: () => this.removeProcessor(processor)
+    };
+  }
+  getProcessors() {
+    return this.layoutProcessors;
+  }
+  removeProcessor(processor) {
+    this.layoutProcessors.splice(this.layoutProcessors.indexOf(processor));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LayoutProcessorsStore
+});

package/lib/cjs/processors/OptionProcessorsStore.js

@@ -0,0 +1,43 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var OptionProcessorsStore_exports = {};
+__export(OptionProcessorsStore_exports, {
+  OptionProcessorsStore: () => OptionProcessorsStore
+});
+module.exports = __toCommonJS(OptionProcessorsStore_exports);
+class OptionProcessorsStore {
+  optionsProcessorsByObjectPath = {};
+  addProcessor(optionPath, processor) {
+    if (!this.optionsProcessorsByObjectPath[optionPath]) this.optionsProcessorsByObjectPath[optionPath] = [];
+    this.optionsProcessorsByObjectPath[optionPath].push(processor);
+    return {
+      remove: () => this.removeProcessor(optionPath, processor)
+    };
+  }
+  getProcessors(optionPath) {
+    return this.optionsProcessorsByObjectPath[optionPath];
+  }
+  removeProcessor(optionPath, processor) {
+    this.optionsProcessorsByObjectPath[optionPath].splice(this.optionsProcessorsByObjectPath[optionPath].indexOf(processor));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OptionProcessorsStore
+});

package/lib/cjs/types.js

@@ -0,0 +1 @@
+"use strict";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ohos-ports/react-native-navigation",
-  "version": "8.9.0-beta.4",
+  "version": "8.9.0-beta.6",
   "description": "React Native Navigation - truly native navigation for iOS and Android (HarmonyOS port)",
   "license": "MIT",
   "publishConfig": {
@@ -15,28 +15,24 @@
     "url": "https://github.com/ohos-ports/ohos-ports.git",
     "directory": "ports/react-native-navigation/8.9.0"
   },
-  "main": "./lib/module/index.js",
+  "main": "./lib/cjs/index.js",
   "types": "./lib/typescript/index.d.ts",
   "exports": {
     ".": {
       "types": "./lib/typescript/index.d.ts",
-      "default": "./lib/module/index.js"
+      "default": "./lib/cjs/index.js"
     },
     "./Mock": {
       "types": "./lib/typescript/Mock/index.d.ts",
-      "default": "./lib/module/Mock/index.js"
+      "default": "./lib/cjs/Mock/index.js"
     },
     "./package.json": "./package.json"
   },
   "files": [
     "lib",
-    "scripts",
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "postinstall": "node scripts/setup-esm-shim.js"
-  },
   "peerDependencies": {
     "react": "*",
     "@ohos-ports/react-native": "^0.87.1-beta.1"
@@ -51,6 +47,7 @@
     "lodash": "4.18.1",
     "prop-types": "15.x.x",
     "react-lifecycles-compat": "^3.0.4",
-    "tslib": "1.9.3"
+    "tslib": "1.9.3",
+    "react-native": "npm:@ohos-ports/react-native@^0.87.1-beta.1"
   }
 }

package/lib/android/app/src/main/java/com/reactnativenavigation/viewcontrollers/statusbar/StatusBarPresenter.kt

@@ -1,212 +0,0 @@
-package com.reactnativenavigation.viewcontrollers.statusbar
-
-import android.animation.Animator
-import android.app.Activity
-import android.graphics.Color
-import android.view.View
-import android.view.Window
-import com.reactnativenavigation.RNNFeatureToggles.isEnabled
-import com.reactnativenavigation.RNNToggles
-import com.reactnativenavigation.options.Options
-import com.reactnativenavigation.options.StatusBarOptions
-import com.reactnativenavigation.options.StatusBarOptions.TextColorScheme
-import com.reactnativenavigation.options.params.Bool
-import com.reactnativenavigation.utils.ColorUtils.isColorLight
-import com.reactnativenavigation.utils.StubAnimationListener.Companion.onAnimatorEnd
-import com.reactnativenavigation.utils.SystemUiUtils.clearStatusBarTranslucency
-import com.reactnativenavigation.utils.SystemUiUtils.getStatusBarColor
-import com.reactnativenavigation.utils.SystemUiUtils.hideStatusBar
-import com.reactnativenavigation.utils.SystemUiUtils.isTranslucent
-import com.reactnativenavigation.utils.SystemUiUtils.setStatusBarColor
-import com.reactnativenavigation.utils.SystemUiUtils.setStatusBarColorScheme
-import com.reactnativenavigation.utils.SystemUiUtils.setStatusBarTranslucent
-import com.reactnativenavigation.utils.SystemUiUtils.showStatusBar
-import com.reactnativenavigation.viewcontrollers.viewcontroller.StatusBarColorAnimator
-import com.reactnativenavigation.viewcontrollers.viewcontroller.ViewController
-import java.lang.ref.WeakReference
-
-class StatusBarPresenter private constructor(
-        activity: Activity,
-        private val sbColorAnimator: StatusBarColorAnimator = StatusBarColorAnimator(activity)) {
-
-    private val window = WeakReference(activity.window)
-    private var hasPendingColorAnim = false
-
-    fun applyOptions(viewController: ViewController<*>, options: StatusBarOptions) {
-        if (!hasPendingColorAnim) {
-            setStatusBarBackgroundColor(options)
-            setTranslucent(options)
-        }
-        setTextColorScheme(options)
-        setStatusBarVisible(viewController, options.visible)
-    }
-
-    fun mergeOptions(view: View, statusBar: StatusBarOptions) {
-        mergeStatusBarBackgroundColor(statusBar)
-        mergeTextColorScheme(statusBar)
-        mergeTranslucent(statusBar)
-        mergeStatusBarVisible(view, statusBar.visible)
-    }
-
-    fun onConfigurationChanged(options: StatusBarOptions) {
-        setStatusBarBackgroundColor(options)
-        setTextColorScheme(options)
-    }
-
-    fun bindViewController(newOptions: StatusBarOptions) {
-        if (!isEnabled(RNNToggles.TOP_BAR_COLOR_ANIMATION__TABS)) {
-            return
-        }
-
-        if (newOptions.backgroundColor.canApplyValue()) {
-            val currentColor = getCurrentStatusBarBackgroundColor() ?: return
-            val newColor = getStatusBarBackgroundColor(newOptions)
-            createStatusBarColorAnimation(
-                from = currentColor,
-                to = newColor,
-                translucent = newOptions.translucent.isTrue,
-            ).start()
-        }
-    }
-
-    fun getStatusBarPushAnimation(appearingOptions: Options): Animator? =
-        if (isEnabled(RNNToggles.TOP_BAR_COLOR_ANIMATION__PUSH)) {
-            getStatusBarColorAnimation(appearingOptions.statusBar)
-        } else null
-
-    fun getStatusBarPopAnimation(appearingOptions: Options, disappearingOptions: Options): Animator? =
-        if (isEnabled(RNNToggles.TOP_BAR_COLOR_ANIMATION__PUSH)) {
-            getStatusBarColorAnimation(appearingOptions.statusBar)
-        } else null
-
-    private fun setStatusBarBackgroundColor(statusBar: StatusBarOptions) {
-        if (statusBar.backgroundColor.canApplyValue()) {
-            val statusBarBackgroundColor: Int = getStatusBarBackgroundColor(statusBar)
-            setStatusBarBackgroundColor(statusBarBackgroundColor, statusBar.translucent.isTrue)
-        }
-    }
-
-    private fun setStatusBarBackgroundColor(color: Int, translucent: Boolean) {
-        setStatusBarColor(window.get(), color, translucent)
-    }
-
-    private fun getStatusBarBackgroundColor(statusBar: StatusBarOptions): Int {
-        val defaultColor =
-            if (statusBar.visible.isTrueOrUndefined) Color.BLACK else Color.TRANSPARENT
-        return statusBar.backgroundColor.get(defaultColor)!!
-    }
-
-    private fun setTextColorScheme(statusBar: StatusBarOptions) {
-        val view = window.get()?.decorView
-        //View.post is a Workaround, added to solve internal Samsung
-        //Android 9 issues. For more info see https://github.com/wix/react-native-navigation/pull/7231
-        view?.post {
-            setStatusBarColorScheme(
-                window.get(),
-                view,
-                isDarkTextColorScheme(statusBar)
-            )
-        }
-    }
-
-    private fun setTranslucent(options: StatusBarOptions) {
-        val window = window.get()
-        if (options.translucent.isTrue) {
-            setStatusBarTranslucent(window)
-        } else if (isTranslucent(window)) {
-            clearStatusBarTranslucency(window)
-        }
-    }
-
-    private fun setStatusBarVisible(viewController: ViewController<*>, visible: Bool) {
-        val window = window.get() ?: return
-        val view = if (viewController.view != null) viewController.view else window.decorView
-        if (visible.isFalse) {
-            hideStatusBar(window, view)
-        } else {
-            showStatusBar(window, view)
-        }
-    }
-
-    private fun mergeStatusBarBackgroundColor(statusBar: StatusBarOptions) {
-        if (statusBar.backgroundColor.hasValue()) {
-            val statusBarBackgroundColor = getStatusBarBackgroundColor(statusBar)
-            setStatusBarColor(
-                window.get(), statusBarBackgroundColor,
-                statusBar.translucent.isTrue
-            )
-        }
-    }
-
-    private fun mergeTextColorScheme(statusBar: StatusBarOptions) {
-        if (!statusBar.textColorScheme.hasValue()) return
-        setTextColorScheme(statusBar)
-    }
-
-    private fun mergeTranslucent(options: StatusBarOptions) {
-        val window: Window = window.get() ?: return
-        if (options.translucent.isTrue) {
-            setStatusBarTranslucent(window)
-        } else if (options.translucent.isFalse && isTranslucent(window)) {
-            clearStatusBarTranslucency(window)
-        }
-    }
-
-    private fun mergeStatusBarVisible(view: View, visible: Bool) {
-        if (visible.hasValue()) {
-            if (visible.isTrue) {
-                showStatusBar(window.get(), view)
-            } else {
-                hideStatusBar(window.get(), view)
-            }
-        }
-    }
-
-    private fun isDarkTextColorScheme(statusBar: StatusBarOptions): Boolean {
-        if (statusBar.textColorScheme == TextColorScheme.Dark) {
-            return true
-        }
-
-        if (statusBar.textColorScheme == TextColorScheme.Light) {
-            return false
-        }
-        return isColorLight(getStatusBarBackgroundColor(statusBar))
-    }
-
-    private fun getStatusBarColorAnimation(statusBarOptions: StatusBarOptions): Animator? {
-        if (isEnabled(RNNToggles.TOP_BAR_COLOR_ANIMATION__TABS)) {
-            getCurrentStatusBarBackgroundColor()?.let { currentColor ->
-                val targetColor = statusBarOptions.backgroundColor
-
-                if (targetColor.hasValue()) {
-                    val translucent = statusBarOptions.translucent.isTrue
-                    return createStatusBarColorAnimation(
-                        from = currentColor,
-                        to = targetColor.get(),
-                        translucent = translucent,
-                    )
-                }
-            }
-        }
-        return null
-    }
-
-    private fun createStatusBarColorAnimation(from: Int, to: Int, translucent: Boolean): Animator =
-        sbColorAnimator.getAnimator(from, to, translucent).apply {
-            addListener(onAnimatorEnd {
-                hasPendingColorAnim = false
-            })
-            hasPendingColorAnim = true
-        }
-
-    private fun getCurrentStatusBarBackgroundColor() =
-        getStatusBarColor(window.get())
-
-    companion object {
-        lateinit var instance: StatusBarPresenter
-
-        fun init(activity: Activity) {
-            instance = StatusBarPresenter(activity)
-        }
-    }
-}

package/lib/module/ARCHITECTURE.md

@@ -1,331 +0,0 @@
-# JavaScript/TypeScript Architecture
-
-The JavaScript layer provides the public API and orchestrates communication between React components and native navigation implementations.
-
-## Entry Point
-
-`index.ts` exports the `Navigation` singleton (a `NavigationDelegate` instance) along with re-exports from `Modal`, `EventsRegistry`, `Constants`, and all interfaces. Applications use `Navigation.*` for commands and `Navigation.events().*` for event subscriptions.
-
-## Module Structure
-
-```
-src/
-├── index.ts                 # Main entry point, exports Navigation singleton
-├── Navigation.ts            # NavigationRoot - core orchestrator
-├── NavigationDelegate.ts    # Public API facade
-├── adapters/                # Native bridge layer
-├── commands/                # Command processing
-├── components/              # React component management
-├── events/                  # Event system
-├── interfaces/              # TypeScript type definitions
-├── linking/                 # Deep-linking framework (URL → command)
-└── processors/              # Extensibility hooks
-```
-
-## Core Classes
-
-### NavigationDelegate (Public API)
-**File**: `NavigationDelegate.ts`
-
-Facade providing the public `Navigation` API. All methods proxy to `NavigationRoot`.
-
-```typescript
-// Usage
-import { Navigation } from 'react-native-navigation';
-Navigation.setRoot({ root: { stack: { children: [...] } } });
-```
-
-### NavigationRoot (Core Orchestrator)
-**File**: `Navigation.ts`
-
-Coordinates all subsystems. Constructed with dependencies:
-- `NativeCommandsSender` - sends commands to native
-- `NativeEventsReceiver` - receives events from native
-- `AppRegistryService` - manages React Native component registry
-
-Initializes and coordinates:
-- `Store` - component instance & props storage
-- `ComponentRegistry` - component registration
-- `LayoutTreeParser` - converts layouts to internal nodes
-- `LayoutTreeCrawler` - processes layout trees
-- `Commands` - command execution
-- `EventsRegistry` - event subscriptions
-- `OptionsProcessor` - option processing
-- `LayoutProcessor` - layout transformations
-
-## Adapters Layer
-
-Bridge between JavaScript and native/React Native APIs.
-
-| Adapter | Purpose |
-|---------|---------|
-| `NativeCommandsSender` | Wraps TurboModule for command dispatch |
-| `NativeEventsReceiver` | Wraps NativeEventEmitter for events |
-| `NativeRNNTurboModule` | TurboModule spec interface |
-| `NativeRNNTurboEventEmitter` | TurboModule event emitter spec |
-| `UniqueIdProvider` | Generates unique component/command IDs |
-| `ColorService` | Converts colors to native format |
-| `AssetResolver` | Resolves require() image assets (class: AssetService) |
-| `AppRegistryService` | Registers components with React Native |
-| `Constants` | Platform dimension constants |
-| `TouchablePreview` | 3D Touch / Haptic preview handling |
-
-## Commands Layer
-
-### Commands Class
-**File**: `commands/Commands.ts`
-
-Central command dispatcher. Each navigation command:
-1. Validates input
-2. Processes layout through pipeline
-3. Sends to native via adapter
-4. Returns promise with result
-
-### Processing Pipeline
-
-The pipeline executes in this exact order:
-
-```
-Input Layout (from API)
-       ↓
-1. OptionsCrawler.crawl()         # Extract static options from component classes
-       ↓
-2. LayoutProcessor.process()      # Apply registered layout processors
-       ↓
-3. LayoutTreeParser.parse()       # Convert to internal LayoutNode tree
-       ↓
-4. LayoutTreeCrawler.crawl()      # Process options, save props to Store
-       ↓
-5. OptionsProcessor (during crawl) # Resolve colors, assets, custom processors
-       ↓
-6. NativeCommandsSender           # Send to native module
-```
-
-### LayoutNode (Internal Tree)
-```typescript
-interface LayoutNode {
-  id: string;           // Unique identifier
-  type: LayoutType;     // Component|Stack|BottomTabs|etc
-  data: {
-    name?: string;      // Component name
-    options?: any;      // Processed options
-    passProps?: any;    // Component props (cleared before native)
-  };
-  children: LayoutNode[];
-}
-```
-
-### LayoutType Enum
-```typescript
-enum LayoutType {
-  Component = 'Component',
-  Stack = 'Stack',
-  BottomTabs = 'BottomTabs',
-  SideMenuRoot = 'SideMenuRoot',
-  SideMenuCenter = 'SideMenuCenter',
-  SideMenuLeft = 'SideMenuLeft',
-  SideMenuRight = 'SideMenuRight',
-  TopTabs = 'TopTabs',
-  ExternalComponent = 'ExternalComponent',
-  SplitView = 'SplitView',
-}
-```
-
-## Components Layer
-
-### ComponentRegistry
-**File**: `components/ComponentRegistry.ts`
-
-Manages React component registration and wrapping.
-
-```typescript
-Navigation.registerComponent('ScreenName', () => MyComponent);
-```
-
-### ComponentWrapper
-**File**: `components/ComponentWrapper.tsx`
-
-Higher-order component that:
-- Wraps original component with lifecycle management
-- Stores instance in `Store` for event dispatch
-- Injects `componentId` and `componentName` props
-
-### Store
-**File**: `components/Store.ts`
-
-Centralized storage for:
-- `componentsByName` - registered component providers
-- `componentsInstancesById` - mounted component instances
-- `propsById` - static props by component ID
-- `pendingPropsById` - props awaiting component mount
-- `wrappedComponents` - cached wrapped components
-- `lazyRegistratorFn` - function for lazy component registration
-
-## Events Layer
-
-### EventsRegistry
-**File**: `events/EventsRegistry.ts`
-
-Public API for event subscriptions:
-
-```typescript
-Navigation.events().registerComponentDidAppearListener(({ componentId }) => {});
-Navigation.events().registerCommandCompletedListener(({ commandId }) => {});
-```
-
-### ComponentEventsObserver
-**File**: `events/ComponentEventsObserver.ts`
-
-Dispatches events to component instance methods:
-- `componentWillAppear()`
-- `componentDidAppear()`
-- `componentDidDisappear()`
-- `navigationButtonPressed()`
-- `screenPopped()`
-
-### CommandsObserver
-**File**: `events/CommandsObserver.ts`
-
-Notifies listeners of command lifecycle (start, complete).
-
-## Events (Native → JS)
-
-| Event | Description |
-|-------|-------------|
-| `RNN.AppLaunched` | App initialization complete |
-| `RNN.ComponentWillAppear` | Component about to appear |
-| `RNN.ComponentDidAppear` | Component now visible |
-| `RNN.ComponentDidDisappear` | Component hidden |
-| `RNN.NavigationButtonPressed` | TopBar button tapped |
-| `RNN.BottomTabPressed` | Tab pressed (even if selected) |
-| `RNN.BottomTabSelected` | Tab selection changed |
-| `RNN.BottomTabLongPressed` | Tab long-pressed |
-| `RNN.ModalDismissed` | Modal was dismissed |
-| `RNN.ModalAttemptedToDismiss` | Swipe-to-dismiss attempted |
-| `RNN.ScreenPopped` | Screen removed from stack |
-| `RNN.SearchBarUpdated` | Search text changed |
-| `RNN.SearchBarCancelPressed` | Search cancelled |
-| `RNN.PreviewCompleted` | 3D Touch preview completed |
-| `RNN.CommandCompleted` | Navigation command finished |
-
-## Linking Layer
-
-Implements URL-to-screen routing on top of the standard command pipeline. The whole feature is JS-only; it consumes URLs from RN's `Linking` module and dispatches `showModal` (or a user-supplied command) when a match is found.
-
-**Public surface** (proxied through `NavigationDelegate`):
-- `Navigation.setLinking(config)` — configure prefixes, screen map, and customization hooks
-- `Navigation.handleDeepLink(url)` — manually feed a URL (push notifications, branch.io, App Clips)
-- `Navigation.setLinkingReady(ready)` — user-controlled gate for deferred deep links
-
-**Internal modules** (`src/linking/`):
-
-| File | Purpose |
-|------|---------|
-| `LinkingHandler.ts` | Orchestrator. Subscribes to `Linking.url`/`getInitialURL`, drives the queue, dispatches matches. Instantiated by `NavigationRoot`. |
-| `URLParser.ts` | Strips prefix (longest match), removes fragment, decodes path segments + query params. |
-| `RouteMatcher.ts` | Compiles `ScreensConfig` into a `RouteNode` tree; matches paths to screen chains with parameter extraction. |
-| `DeferredLinkQueue.ts` | FIFO queue. Holds URLs until both gates open (root-ready + user-ready). |
-| `ModalLayoutBuilder.ts` | Default presentation: wraps the matched chain in a `stack`, merges params into `passProps`, filters React-reserved keys (`ref`, `key`). |
-| `types.ts` | Public types: `LinkingConfig`, `RouteMatch`, `ScreensConfig`, etc. (re-exported via `src/index.ts`). |
-
-**Readiness gates** — a URL is dispatched only when both are true:
-1. **Root-ready** (automatic): the first `Navigation.setRoot()` has resolved. `NavigationRoot.setRoot` calls `linkingHandler.setRootReady()` after the promise resolves.
-2. **User-ready** (optional): `config.isReady()` returns `true`, or `setLinkingReady(true)` was called.
-
-**Resolution priority** when a match is found:
-1. `config.onLink(match)` — full escape hatch, RNN does nothing else
-2. `config.getModal(match)` — custom modal layout
-3. Default `ModalLayoutBuilder` output
-
-## Processors Layer
-
-### OptionProcessorsStore
-**File**: `processors/OptionProcessorsStore.ts`
-
-Registers custom option processors:
-
-```typescript
-Navigation.addOptionProcessor('topBar.title.text', (value, commandName) => {
-  return value.toUpperCase(); // Transform all titles
-});
-```
-
-### LayoutProcessorsStore
-**File**: `processors/LayoutProcessorsStore.ts`
-
-Registers layout transformers:
-
-```typescript
-Navigation.addLayoutProcessor((layout, commandName) => {
-  // Add default options to all components
-  return layout;
-});
-```
-
-## Interfaces
-
-### Layout Types
-**File**: `interfaces/Layout.ts`
-
-```typescript
-interface LayoutRoot {
-  root: Layout;
-  modals?: any[];
-  overlays?: any[];
-}
-
-type Layout = {
-  component?: LayoutComponent;
-  stack?: LayoutStack;
-  bottomTabs?: LayoutBottomTabs;
-  sideMenu?: LayoutSideMenu;
-  splitView?: LayoutSplitView;
-  topTabs?: LayoutTopTabs;
-  externalComponent?: ExternalComponent;
-}
-```
-
-### Options Interface
-**File**: `interfaces/Options.ts` (comprehensive)
-
-Contains all configuration options for:
-- Status bar, navigation bars
-- Top bar (buttons, title, search)
-- Bottom tabs
-- Side menus
-- Modals, overlays
-- Animations
-- Layout parameters
-
-### NavigationComponent
-**File**: `interfaces/NavigationComponent.ts`
-
-Base class for navigation-aware components:
-
-```typescript
-class MyScreen extends NavigationComponent<Props> {
-  static options: Options = { ... };
-
-  componentDidAppear(event) { }
-  navigationButtonPressed(event) { }
-}
-```
-
-## Dependencies
-
-**Production**:
-- `lodash` - utility functions
-- `hoist-non-react-statics` - HOC support
-- `react-lifecycles-compat` - lifecycle polyfill
-- `tslib` - TypeScript helpers
-
-**Peer**:
-- `react`, `react-native` (required)
-- `remx` (optional state management)
-
-## Build Output
-
-Uses `react-native-builder-bob`:
-- **Source**: `src/`
-- **Output**: `lib/`
-- **Targets**: ESM modules + TypeScript declarations