@momo-kits/reserved-regions 0.0.0-stage → 0.167.1-duo.4

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 dung.pham2
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ReservedRegions.podspec

@@ -0,0 +1,20 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "ReservedRegions"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://www.npmjs.com/.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}"
+  s.private_header_files = "ios/**/*.h"
+
+  install_modules_dependencies(s)
+end

package/ios/RNReservedRegionsView.h

@@ -0,0 +1,10 @@
+#import <React/RCTViewComponentView.h>
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RNReservedRegionsView : RCTViewComponentView
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/RNReservedRegionsView.mm

@@ -0,0 +1,95 @@
+#import "RNReservedRegionsView.h"
+
+#import <react/renderer/components/ReservedRegionsSpec/ComponentDescriptors.h>
+#import <react/renderer/components/ReservedRegionsSpec/EventEmitters.h>
+#import <react/renderer/components/ReservedRegionsSpec/Props.h>
+#import <react/renderer/components/ReservedRegionsSpec/RCTComponentViewHelpers.h>
+
+#import "RCTFabricComponentsPlugins.h"
+
+using namespace facebook::react;
+
+@interface RNReservedRegionsView () <RCTRNReservedRegionsViewViewProtocol>
+@end
+
+@implementation RNReservedRegionsView {
+  std::vector<double> _lastOcclusion;
+  BOOL _hasReported;
+}
+
++ (ComponentDescriptorProvider)componentDescriptorProvider {
+  return concreteComponentDescriptorProvider<RNReservedRegionsViewComponentDescriptor>();
+}
+
+- (instancetype)initWithFrame:(CGRect)frame {
+  if (self = [super initWithFrame:frame]) {
+    static const auto defaultProps = std::make_shared<const RNReservedRegionsViewProps>();
+    _props = defaultProps;
+    self.userInteractionEnabled = NO;
+  }
+  return self;
+}
+
+// reading reserved regions inside layoutSubviews / updateProperties lets UIKit call them
+// again when the regions change, e.g. the status bar cluster growing for a call
+- (void)layoutSubviews {
+  [super layoutSubviews];
+  [self reportRegions];
+}
+
+- (void)updateProperties {
+  if (@available(iOS 26.0, *)) {
+    [super updateProperties];
+  }
+  [self reportRegions];
+}
+
+- (void)didMoveToWindow {
+  [super didMoveToWindow];
+  [self setNeedsLayout];
+}
+
+- (void)updateEventEmitter:(EventEmitter::Shared const &)eventEmitter {
+  [super updateEventEmitter:eventEmitter];
+  _hasReported = NO;
+  [self reportRegions];
+}
+
+- (std::vector<double>)currentOcclusion {
+  std::vector<double> occlusion;
+  if (@available(iOS 27.1, *)) {
+    if (self.window == nil) {
+      return occlusion;
+    }
+    NSArray<UIViewReservedRegion *> *regions =
+        [self reservedRegionsOfKind:[UIViewReservedRegionKind occlusionRegionKind]];
+    for (UIViewReservedRegion *region in regions) {
+      CGRect frame = [self convertRect:region.frame toView:nil];
+      occlusion.push_back(frame.origin.x);
+      occlusion.push_back(frame.origin.y);
+      occlusion.push_back(frame.size.width);
+      occlusion.push_back(frame.size.height);
+    }
+  }
+  return occlusion;
+}
+
+- (void)reportRegions {
+  if (!_eventEmitter) {
+    return;
+  }
+  std::vector<double> occlusion = [self currentOcclusion];
+  if (_hasReported && occlusion == _lastOcclusion) {
+    return;
+  }
+  _hasReported = YES;
+  _lastOcclusion = occlusion;
+  std::static_pointer_cast<const RNReservedRegionsViewEventEmitter>(_eventEmitter)
+      ->onRegionsChange(RNReservedRegionsViewEventEmitter::OnRegionsChange{occlusion});
+}
+
+@end
+
+Class<RCTComponentViewProtocol> RNReservedRegionsViewCls(void) {
+  return RNReservedRegionsView.class;
+}

package/package.json

@@ -1,6 +1,43 @@
 {
-  "name": "@momo-kits/reserved-regions",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+    "name": "@momo-kits/reserved-regions",
+    "version": "0.167.1-duo.4",
+    "description": "Reports screen regions reserved by the system (UIView reserved regions, iOS 27.1+), e.g. the iPhone Duo status bar cluster growing for calls or Live Activities.",
+    "main": "./src/index.tsx",
+    "files": [
+        "src",
+        "ios",
+        "*.podspec",
+        "!ios/build",
+        "!**/.*"
+    ],
+    "keywords": [
+        "react-native",
+        "ios",
+        "safe-area",
+        "reserved-regions"
+    ],
+    "author": "MoMo Team",
+    "license": "MIT",
+    "homepage": "https://www.npmjs.com/package/@momo-kits/reserved-regions",
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/"
+    },
+    "peerDependencies": {
+        "react": "*",
+        "react-native": "*"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "codegenConfig": {
+        "name": "ReservedRegionsSpec",
+        "type": "components",
+        "jsSrcsDir": "src",
+        "ios": {
+            "componentProvider": {
+                "RNReservedRegionsView": "RNReservedRegionsView"
+            }
+        }
+    },
+    "dependencies": {}
 }

package/src/RNReservedRegionsViewNativeComponent.ts

@@ -0,0 +1,17 @@
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import type { ViewProps } from 'react-native';
+import type {
+  DirectEventHandler,
+  Double,
+} from 'react-native/Libraries/Types/CodegenTypes';
+
+export type RegionsChangeEvent = Readonly<{
+  // active occlusion regions in window coordinates, flattened as x, y, width, height
+  occlusion: Double[];
+}>;
+
+export interface NativeProps extends ViewProps {
+  onRegionsChange?: DirectEventHandler<RegionsChangeEvent>;
+}
+
+export default codegenNativeComponent<NativeProps>('RNReservedRegionsView');

package/src/index.tsx

@@ -0,0 +1,57 @@
+import React from 'react';
+import { Platform, type ViewProps } from 'react-native';
+import RNReservedRegionsViewNativeComponent from './RNReservedRegionsViewNativeComponent';
+
+export type ReservedRegion = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+
+const REGION_STRIDE = 4;
+
+const toRegions = (flat: ReadonlyArray<number>): ReservedRegion[] => {
+  const regions: ReservedRegion[] = [];
+  for (let i = 0; i + REGION_STRIDE <= flat.length; i += REGION_STRIDE) {
+    regions.push({
+      x: flat[i],
+      y: flat[i + 1],
+      width: flat[i + 2],
+      height: flat[i + 3],
+    });
+  }
+  return regions;
+};
+
+export interface ReservedRegionsViewProps extends ViewProps {
+  /**
+   * active occlusion regions in window coordinates, sent on mount and whenever they
+   * change (e.g. the status bar cluster growing for a call); empty before iOS 27.1
+   */
+  onRegionsChange?: (regions: ReservedRegion[]) => void;
+}
+
+/**
+ * invisible probe reporting the system reserved regions; render it once, full window
+ */
+const ReservedRegionsView: React.FC<ReservedRegionsViewProps> = ({
+  onRegionsChange,
+  ...props
+}) => {
+  if (Platform.OS !== 'ios') {
+    return null;
+  }
+  return (
+    <RNReservedRegionsViewNativeComponent
+      {...props}
+      pointerEvents={'none'}
+      onRegionsChange={e =>
+        onRegionsChange?.(toRegions(e.nativeEvent.occlusion))
+      }
+    />
+  );
+};
+
+export { ReservedRegionsView };
+export default ReservedRegionsView;

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.