@dongsuo/react-native-uitextview 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2024-25 Bluesky PBC
+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/README.md

@@ -0,0 +1,225 @@
+# React Native UITextView with Custom Context Menu
+
+[![npm version](https://img.shields.io/npm/v/@dongsuo/react-native-uitextview?style=flat-square)](https://www.npmjs.com/package/@dongsuo/react-native-uitextview)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+
+An enhanced fork of `react-native-uitextview` with custom context menu support for React Native iOS applications.
+
+## Features
+
+- Full support for UITextView on iOS
+- Customizable context menu with your own actions
+- Hide system default menu items
+- Easy to integrate and use
+- Maintains all original functionality
+
+## Installation
+
+```bash
+yarn add @dongsuo/react-native-uitextview
+# or
+npm install @dongsuo/react-native-uitextview
+```
+
+### iOS
+
+Run the following command to install the native dependencies:
+
+```bash
+cd ios && pod install && cd ..
+```
+
+## Usage
+
+### Basic Usage
+
+```jsx
+import {UITextView} from '@dongsuo/react-native-uitextview'
+
+// In your component
+;<UITextView
+  style={{height: 100, borderWidth: 1, padding: 10}}
+  placeholder="Type something..."
+  selectable={true}
+  uiTextView={true}
+/>
+```
+
+### Custom Context Menu
+
+```jsx
+import {UITextView} from '@dongsuo/react-native-uitextview'
+
+const MyComponent = () => {
+  const handleCustomMenuAction = event => {
+    const {actionId, selectedText} = event.nativeEvent
+    console.log(`Action: ${actionId}`, `Selected text: ${selectedText}`)
+
+    // Handle different actions
+    switch (actionId) {
+      case 'translate':
+        // Handle translate action
+        break
+      case 'share':
+        // Handle share action
+        break
+      case 'search':
+        // Handle search action
+        break
+    }
+  }
+
+  return (
+    <UITextView
+      style={{height: 100, borderWidth: 1, padding: 10}}
+      placeholder="Select text to see custom menu"
+      selectable={true}
+      uiTextView={true}
+      customMenuItems={[
+        {title: 'Translate', actionId: 'translate'},
+        {title: 'Share', actionId: 'share'},
+        {title: 'Search', actionId: 'search'},
+      ]}
+      onCustomMenuAction={handleCustomMenuAction}
+    />
+  )
+}
+```
+
+## Props
+
+| Prop                 | Type                                                                       | Description                                                        | Default |
+| -------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------- |
+| `customMenuItems`    | `Array<{title: string, actionId: string}>`                                 | Array of custom menu items to show when text is selected           | `[]`    |
+| `onCustomMenuAction` | `(event: {nativeEvent: {actionId: string, selectedText: string}}) => void` | Callback when a custom menu item is pressed                        | -       |
+| ...                  | ...                                                                        | All other props from React Native's `Text` component are supported | -       |
+
+## License
+
+MIT
+
+## Credits
+
+Forked from [react-native-uitextview](https://github.com/bluesky-social/react-native-uitextview) by [Hailey](https://github.com/haileyok)
+
+# React Native UITextView
+
+The `Text` implementation in React Native much more closely resembles `UILabel` on iOS. Unfortunately, this prevents
+the user from being able to highlight text for selection. The only copy behavior that is possible is to copy the
+entire block of text.
+
+`UITextView` however allows a user to highlight portions of the text block for copying,
+translation, or other native capabilities.
+
+React Native UITextView takes advantage of `UITextView` to allow for both types of copying
+on iOS: highlight and copy or the current, `UILabel` behavior to just copy the entire
+block of text.
+
+## Installation
+
+> [!WARNING]
+> The final version of this package that supports the old React Native architecture is `1.4.0`. All versions `2.x` and
+> higher support only the new architecture. Unfortunately I do not have time to maintain support for both architectures.
+> Version `1.4.0` however is stable and - aside from the still missing features from the base `<Text>` component, should
+> work the same as `2.x` and higher.
+
+> [!NOTE]
+> Version 2.0.0 of `react-native-uitextview` is tested against and used in production with React Nave 0.79. No other versions
+> are officially supported. As there have been a number of changes to the text layout engine in the new architecture, things
+> may be broken if you are not using this version of React Native with this package. Generally, these problems are inside of
+> `RNUITextViewShadowNode.cpp`.
+
+```sh
+yarn add react-native-uitextview
+cd ios
+pod install
+```
+
+## Limitations
+
+React Native UITextView can - for the most part - be used as a drop-in replacement
+for existing blocks of `Text`. However, there are a few limitations:
+
+- Children of `UITextView` may only be other UITextView children (base `Text` children
+  will be converted to `UITextView` children, so you only need to adjust the wrapper).
+  This means that things like in-line images are not supported as they are in the base
+  React Native `Text` component.
+- A few styles have not yet been implemented, but all should be possible.
+
+## Usage
+
+Usage of this component is the same as the base React Native `Text` component. It
+can be imported as `Text` from `react-native-uitextview`, so in most cases you only
+need to replace your current `Text` import with this one.
+
+Aside from the few limitations above, all of the existing styles and props that you
+are using for `Text` should work. On non-iOS platforms, the base React Native `Text`
+will always be used. On iOS, the base React Native `Text` component will be used
+unless the `selectable` and the `uiTextView` props are both `true`.
+
+```tsx
+import {UITextView as Text} from 'react-native-uitextview'
+
+function SomeView() {
+  return (
+    <View style={{flex: 1}}>
+      <Text
+        style={{color: 'green', lineHeight: 20, fontSize: 14}}
+        selectable
+        uiTextView>
+        This is some highlightable text! It uses UITextView
+      </Text>
+      <Text
+        style={{color: 'blue', lineHeight: 20, fontSize: 14}}
+        selectable // Note we do not add the uiTextView prop
+      >
+        This text still uses the base Text component. It can only be copied.
+      </Text>
+      <Text
+        style={{color: 'red', lineHeight: 20, fontSize: 14}}
+        uiTextView // Note we do not add the selectable prop
+      >
+        This text still uses the base Text component. It can't be highlighted or
+        copied at all.
+      </Text>
+    </View>
+  )
+}
+```
+
+Nesting of `UITextView` components is supported. For example, if you have styles
+that should be applied only to a portion of the text, or an `onPress` callback to
+add to a link.
+
+```tsx
+<Text style={{fontSize: 14}} selectable uiTextView>
+  This is some text that's highlightable with{' '}
+  <Text
+    style={{color: 'blue', textDecorationLine: 'underline'}}
+    onPress={() => Linking.openURL('https://google.com')}>
+    a link
+  </Text>
+  .
+</Text>
+```
+
+## Contributing
+
+Contributions are always welcome - and encouraged. Please note however that it might take
+time for PRs to be reviewed and merged, and they might not be merged at all. This library
+was created to support text selection in the
+[Bluesky Social App](https://github.com/bluesky-social/social-app). Contributions that may
+affect the proper functioning of the component in Bluesky will not be merged.
+
+Some ideas for great contributions that we do not have time to properly implement:
+
+- Full support for all RN styles
+- Accessibility improvements
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/generated/jni/CMakeLists.txt

@@ -0,0 +1,36 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+cmake_minimum_required(VERSION 3.13)
+set(CMAKE_VERBOSE_MAKEFILE on)
+
+file(GLOB react_codegen_SRCS CONFIGURE_DEPENDS *.cpp react/renderer/components/RNUITextViewSpec/*.cpp)
+
+add_library(
+  react_codegen_RNUITextViewSpec
+  OBJECT
+  ${react_codegen_SRCS}
+)
+
+target_include_directories(react_codegen_RNUITextViewSpec PUBLIC . react/renderer/components/RNUITextViewSpec)
+
+target_link_libraries(
+  react_codegen_RNUITextViewSpec
+  fbjni
+  jsi
+  # We need to link different libraries based on whether we are building rncore or not, that's necessary
+  # because we want to break a circular dependency between react_codegen_rncore and reactnative
+  reactnative
+)
+
+target_compile_options(
+  react_codegen_RNUITextViewSpec
+  PRIVATE
+  -DLOG_TAG=\"ReactNative\"
+  -fexceptions
+  -frtti
+  -std=c++20
+  -Wall
+)

package/android/generated/jni/RNUITextViewSpec-generated.cpp

@@ -0,0 +1,22 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleJniCpp.js
+ */
+
+#include "RNUITextViewSpec.h"
+
+namespace facebook::react {
+
+
+
+std::shared_ptr<TurboModule> RNUITextViewSpec_ModuleProvider(const std::string &moduleName, const JavaTurboModule::InitParams &params) {
+
+  return nullptr;
+}
+
+} // namespace facebook::react

package/android/generated/jni/RNUITextViewSpec.h

@@ -0,0 +1,24 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleJniH.js
+ */
+
+#pragma once
+
+#include <ReactCommon/JavaTurboModule.h>
+#include <ReactCommon/TurboModule.h>
+#include <jsi/jsi.h>
+
+namespace facebook::react {
+
+
+
+JSI_EXPORT
+std::shared_ptr<TurboModule> RNUITextViewSpec_ModuleProvider(const std::string &moduleName, const JavaTurboModule::InitParams &params);
+
+} // namespace facebook::react

package/android/generated/jni/react/renderer/components/RNUITextViewSpec/ComponentDescriptors.cpp

@@ -0,0 +1,23 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateComponentDescriptorCpp.js
+ */
+
+#include "ComponentDescriptors.h"
+#include <react/renderer/core/ConcreteComponentDescriptor.h>
+#include <react/renderer/componentregistry/ComponentDescriptorProviderRegistry.h>
+
+namespace facebook::react {
+
+void RNUITextViewSpec_registerComponentDescriptorsFromCodegen(
+  std::shared_ptr<const ComponentDescriptorProviderRegistry> registry) {
+registry->add(concreteComponentDescriptorProvider<RNUITextViewChildComponentDescriptor>());
+registry->add(concreteComponentDescriptorProvider<RNUITextViewComponentDescriptor>());
+}
+
+} // namespace facebook::react

package/android/generated/jni/react/renderer/components/RNUITextViewSpec/ComponentDescriptors.h

@@ -0,0 +1,25 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateComponentDescriptorH.js
+ */
+
+#pragma once
+
+#include "ShadowNodes.h"
+#include <react/renderer/core/ConcreteComponentDescriptor.h>
+#include <react/renderer/componentregistry/ComponentDescriptorProviderRegistry.h>
+
+namespace facebook::react {
+
+using RNUITextViewChildComponentDescriptor = ConcreteComponentDescriptor<RNUITextViewChildShadowNode>;
+using RNUITextViewComponentDescriptor = ConcreteComponentDescriptor<RNUITextViewShadowNode>;
+
+void RNUITextViewSpec_registerComponentDescriptorsFromCodegen(
+  std::shared_ptr<const ComponentDescriptorProviderRegistry> registry);
+
+} // namespace facebook::react

package/android/generated/jni/react/renderer/components/RNUITextViewSpec/EventEmitters.cpp

@@ -0,0 +1,61 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateEventEmitterCpp.js
+ */
+
+#include "EventEmitters.h"
+
+
+namespace facebook::react {
+
+void RNUITextViewChildEventEmitter::onPress(OnPress $event) const {
+  dispatchEvent("press", [$event=std::move($event)](jsi::Runtime &runtime) {
+    auto $payload = jsi::Object(runtime);
+    $payload.setProperty(runtime, "target", $event.target);
+    return $payload;
+  });
+}
+
+
+void RNUITextViewChildEventEmitter::onLongPress(OnLongPress $event) const {
+  dispatchEvent("longPress", [$event=std::move($event)](jsi::Runtime &runtime) {
+    auto $payload = jsi::Object(runtime);
+    $payload.setProperty(runtime, "target", $event.target);
+    return $payload;
+  });
+}
+
+
+void RNUITextViewEventEmitter::onTextLayout(OnTextLayout $event) const {
+  dispatchEvent("textLayout", [$event=std::move($event)](jsi::Runtime &runtime) {
+    auto $payload = jsi::Object(runtime);
+    $payload.setProperty(runtime, "target", $event.target);
+
+    auto lines = jsi::Array(runtime, $event.lines.size());
+    size_t linesIndex = 0;
+    for (auto linesValue : $event.lines) {
+      lines.setValueAtIndex(runtime, linesIndex++, linesValue);
+    }
+    $payload.setProperty(runtime, "lines", lines);
+  
+    return $payload;
+  });
+}
+
+
+void RNUITextViewEventEmitter::onCustomMenuAction(OnCustomMenuAction $event) const {
+  dispatchEvent("customMenuAction", [$event=std::move($event)](jsi::Runtime &runtime) {
+    auto $payload = jsi::Object(runtime);
+    $payload.setProperty(runtime, "target", $event.target);
+$payload.setProperty(runtime, "actionId", $event.actionId);
+$payload.setProperty(runtime, "selectedText", $event.selectedText);
+    return $payload;
+  });
+}
+
+} // namespace facebook::react

package/android/generated/jni/react/renderer/components/RNUITextViewSpec/EventEmitters.h

@@ -0,0 +1,49 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateEventEmitterH.js
+ */
+#pragma once
+
+#include <react/renderer/components/view/ViewEventEmitter.h>
+
+
+namespace facebook::react {
+class RNUITextViewChildEventEmitter : public ViewEventEmitter {
+ public:
+  using ViewEventEmitter::ViewEventEmitter;
+
+  struct OnPress {
+      int target;
+    };
+
+  struct OnLongPress {
+      int target;
+    };
+  void onPress(OnPress value) const;
+
+  void onLongPress(OnLongPress value) const;
+};
+class RNUITextViewEventEmitter : public ViewEventEmitter {
+ public:
+  using ViewEventEmitter::ViewEventEmitter;
+
+  struct OnTextLayout {
+      int target;
+    std::vector<std::string> lines;
+    };
+
+  struct OnCustomMenuAction {
+      int target;
+    std::string actionId;
+    std::string selectedText;
+    };
+  void onTextLayout(OnTextLayout value) const;
+
+  void onCustomMenuAction(OnCustomMenuAction value) const;
+};
+} // namespace facebook::react

package/android/generated/jni/react/renderer/components/RNUITextViewSpec/Props.cpp

@@ -0,0 +1,47 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GeneratePropsCpp.js
+ */
+
+#include "Props.h"
+#include <react/renderer/core/PropsParserContext.h>
+#include <react/renderer/core/propsConversions.h>
+
+namespace facebook::react {
+
+RNUITextViewChildProps::RNUITextViewChildProps(
+    const PropsParserContext &context,
+    const RNUITextViewChildProps &sourceProps,
+    const RawProps &rawProps): ViewProps(context, sourceProps, rawProps),
+
+    text(convertRawProp(context, rawProps, "text", sourceProps.text, {})),
+    color(convertRawProp(context, rawProps, "color", sourceProps.color, {})),
+    fontSize(convertRawProp(context, rawProps, "fontSize", sourceProps.fontSize, {0.0})),
+    fontStyle(convertRawProp(context, rawProps, "fontStyle", sourceProps.fontStyle, {RNUITextViewChildFontStyle::Normal})),
+    fontWeight(convertRawProp(context, rawProps, "fontWeight", sourceProps.fontWeight, {RNUITextViewChildFontWeight::Normal})),
+    fontFamily(convertRawProp(context, rawProps, "fontFamily", sourceProps.fontFamily, {})),
+    letterSpacing(convertRawProp(context, rawProps, "letterSpacing", sourceProps.letterSpacing, {0.0})),
+    lineHeight(convertRawProp(context, rawProps, "lineHeight", sourceProps.lineHeight, {0.0})),
+    textDecorationLine(convertRawProp(context, rawProps, "textDecorationLine", sourceProps.textDecorationLine, {RNUITextViewChildTextDecorationLine::None})),
+    textDecorationStyle(convertRawProp(context, rawProps, "textDecorationStyle", sourceProps.textDecorationStyle, {RNUITextViewChildTextDecorationStyle::Solid})),
+    textDecorationColor(convertRawProp(context, rawProps, "textDecorationColor", sourceProps.textDecorationColor, {})),
+    shadowRadius(convertRawProp(context, rawProps, "shadowRadius", sourceProps.shadowRadius, {0.0}))
+      {}
+RNUITextViewProps::RNUITextViewProps(
+    const PropsParserContext &context,
+    const RNUITextViewProps &sourceProps,
+    const RawProps &rawProps): ViewProps(context, sourceProps, rawProps),
+
+    numberOfLines(convertRawProp(context, rawProps, "numberOfLines", sourceProps.numberOfLines, {0})),
+    allowsFontScaling(convertRawProp(context, rawProps, "allowsFontScaling", sourceProps.allowsFontScaling, {false})),
+    ellipsizeMode(convertRawProp(context, rawProps, "ellipsizeMode", sourceProps.ellipsizeMode, {RNUITextViewEllipsizeMode::Tail})),
+    selectable(convertRawProp(context, rawProps, "selectable", sourceProps.selectable, {false})),
+    customMenuItems(convertRawProp(context, rawProps, "customMenuItems", sourceProps.customMenuItems, {}))
+      {}
+
+} // namespace facebook::react