react-native-typerich 1.0.0 → 2.2.0

package/lib/typescript/src/TypeRichTextInputNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TypeRichTextInputNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/TypeRichTextInputNativeComponent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TypeRichTextInputNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/TypeRichTextInputNativeComponent.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/index.d.ts

@@ -1,5 +1,5 @@
 export { default as TypeRichTextInput } from './TypeRichTextInput';
 export * from './TypeRichTextInputNativeComponent';
 export * from './TypeRichTextInput';
-export type { OnChangeTextEvent, OnChangeSelectionEvent, onPasteImageEventData, } from './TypeRichTextInputNativeComponent';
+export * from './types/TypeRichTextInput';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/lib/typescript/src/types/TypeRichTextInput.d.ts

@@ -0,0 +1,95 @@
+import type { TypeRichTextInputNativeProps } from '../TypeRichTextInputNativeComponent';
+import type { onPasteImageEventData } from '../TypeRichTextInputNativeComponent';
+/**
+ * JavaScript-level props for `TypeRichTextInput`.
+ *
+ * These props normalize native events into ergonomic,
+ * idiomatic JavaScript callbacks.
+ */
+export interface TypeRichTextInputProps extends Omit<TypeRichTextInputNativeProps, 'onChangeText' | 'onChangeSelection' | 'onInputFocus' | 'onInputBlur' | 'onPasteImage'> {
+    /**
+     * Called when the input receives focus.
+     */
+    onFocus?: () => void;
+    /**
+     * Called when the input loses focus.
+     */
+    onBlur?: () => void;
+    /**
+     * Called whenever the text content changes.
+     *
+     * This callback is **informational only** and should not
+     * be used to drive controlled input behavior.
+     *
+     * Use imperative commands (`setText`, `insertTextAt`)
+     * to update the text.
+     */
+    onChangeText?: (value: string) => void;
+    /**
+     * Called when the text selection or cursor position changes.
+     */
+    onChangeSelection?: (event: {
+        /**
+         * Start index of the selection (inclusive).
+         */
+        start: number;
+        /**
+         * End index of the selection (exclusive).
+         */
+        end: number;
+        /**
+         * Full text content at the time of the selection change.
+         */
+        text: string;
+    }) => void;
+    /**
+     * Called when an image is pasted into the input.
+     *
+     * The payload conforms to {@link onPasteImageEventData}.
+     */
+    onPasteImageData?: (data: onPasteImageEventData) => void;
+}
+/**
+ * Imperative handle exposed via `ref`.
+ *
+ * This component is **imperative-first**.
+ * Text mutations must be performed using these methods.
+ */
+export interface TypeRichTextInputRef {
+    /**
+     * Focuses the input programmatically.
+     */
+    focus: () => void;
+    /**
+     * Removes focus from the input.
+     */
+    blur: () => void;
+    /**
+     * Replaces the entire text content of the input.
+     *
+     * This is the primary and recommended way to update text.
+     * does not updates selection
+     */
+    setText: (text: string) => void;
+    /**
+     * Inserts text at the specified range.
+     *
+     * Replaces the text between `start` and `end` with `text`.
+     *
+     * it updates selection automatically
+     */
+    insertTextAt: (start: number, end: number, text: string) => void;
+    /**
+     * Updates the current text selection.
+     *
+     * must be called after setText()
+     */
+    setSelection: (start: number, end: number) => void;
+    /**
+     * Returns the underlying native view reference, if available.
+     *
+     * Intended for advanced or debugging use cases only.
+     */
+    getNativeRef: () => any | null;
+}
+//# sourceMappingURL=TypeRichTextInput.d.ts.map

package/lib/typescript/src/types/TypeRichTextInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeRichTextInput.d.ts","sourceRoot":"","sources":["../../../../src/types/TypeRichTextInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAGjF;;;;;GAKG;AACH,MAAM,WAAW,sBACf,SAAQ,IAAI,CACV,4BAA4B,EAC1B,cAAc,GACd,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,cAAc,CACjB;IACD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEvC;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC1B;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,GAAG,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IAEX;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjE;;;;OAIG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnD;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,GAAG,IAAI,CAAC;CAChC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-typerich",
-  "version": "1.0.0",
+  "version": "2.2.0",
   "description": "Textinput replacement",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/TypeRichTextInput.tsx

@@ -1,25 +1,21 @@
 import { forwardRef, useImperativeHandle, useRef, type Ref } from 'react';
 
 import type { NativeSyntheticEvent } from 'react-native';
-import { Platform, View } from 'react-native';
 
-import {
+import NativeTypeRichTextInput, {
   Commands,
-  type OnChangeSelectionEvent,
-  type OnChangeTextEvent,
-  type onPasteImageEventData,
-  type TypeRichTextInputNativeProps,
 } from './TypeRichTextInputNativeComponent';
 
-let NativeTypeRichTextInput: any;
+import type {
+  OnChangeSelectionEvent,
+  OnChangeTextEvent,
+  onPasteImageEventData,
+} from './TypeRichTextInputNativeComponent';
+import type {
+  TypeRichTextInputProps,
+  TypeRichTextInputRef,
+} from './types/TypeRichTextInput';
 
-if (Platform.OS === 'android') {
-  NativeTypeRichTextInput =
-    require('./TypeRichTextInputNativeComponent').default;
-} else {
-  // iOS fallback (temporary)
-  NativeTypeRichTextInput = View;
-}
 type MaybeNativeEvent<T> = T | { nativeEvent: T };
 
 export function normalizeEvent<T>(event: MaybeNativeEvent<T>): T {
@@ -29,39 +25,6 @@ export function normalizeEvent<T>(event: MaybeNativeEvent<T>): T {
   return event as T;
 }
 
-// Public facing props (same as NativeProps but events normalized)
-export interface TypeRichTextInputProps
-  extends Omit<
-    TypeRichTextInputNativeProps,
-    | 'onChangeText'
-    | 'onChangeSelection'
-    | 'onInputFocus'
-    | 'onInputBlur'
-    | 'onPasteImage'
-  > {
-  // JS-friendly callbacks
-  onFocus?: () => void;
-  onBlur?: () => void;
-  onChangeText?: (value: string) => void;
-  onChangeSelection?: (event: {
-    start: number;
-    end: number;
-    text: string;
-  }) => void;
-  onPasteImageData?: (data: onPasteImageEventData) => void;
-}
-
-export interface TypeRichTextInputRef {
-  focus: () => void;
-  blur: () => void;
-  setText: (text: string) => void;
-  insertTextAt: (start: number, end: number, text: string) => void;
-  setSelection: (start: number, end: number) => void;
-  getNativeRef: () => any | null;
-}
-
-const isAndroid = Platform.OS === 'android';
-
 /**
  * TypeRichTextInput
  *
@@ -70,36 +33,37 @@ const isAndroid = Platform.OS === 'android';
  * - Fabric-based rendering
  * - custom ShadowNode on Android
  *
- * iOS support is currently unavailable and renders a `View` comp as fallback
- * we are planning to add support for ios too soon
+ * iOS support is currently in Beta Stage
  */
 const TypeRichTextInput = forwardRef(
   (props: TypeRichTextInputProps, ref: Ref<TypeRichTextInputRef>) => {
     const nativeRef = useRef(null);
 
+    const { scrollEnabled = true, ...restProps } = props;
+
     useImperativeHandle(ref, () => ({
       focus: () => {
-        if (isAndroid && nativeRef.current) {
+        if (nativeRef.current) {
           Commands.focus(nativeRef.current);
         }
       },
       blur: () => {
-        if (isAndroid && nativeRef.current) {
+        if (nativeRef.current) {
           Commands.blur(nativeRef.current);
         }
       },
       setText: (text: string) => {
-        if (isAndroid && nativeRef.current) {
+        if (nativeRef.current) {
           Commands.setText(nativeRef.current, text);
         }
       },
       setSelection(start, end) {
-        if (isAndroid && nativeRef.current) {
+        if (nativeRef.current) {
           Commands.setSelection(nativeRef.current, start, end);
         }
       },
       insertTextAt: (start: number, end: number, text: string) => {
-        if (isAndroid && nativeRef.current) {
+        if (nativeRef.current) {
           Commands.insertTextAt(nativeRef.current, start, end, text);
         }
       },
@@ -145,25 +109,11 @@ const TypeRichTextInput = forwardRef(
       });
     }
 
-    /* eslint-disable @typescript-eslint/no-unused-vars */
-    const {
-      // native-only / android-only props we never want on <View />
-      androidExperimentalSynchronousEvents,
-      onChangeSelection,
-      onChangeText,
-      onPasteImageData,
-      onFocus,
-      onBlur,
-
-      // everything else
-      ...restProps
-    } = props;
-    /* eslint-enable @typescript-eslint/no-unused-vars */
-
     return (
       <NativeTypeRichTextInput
         ref={nativeRef}
-        {...(isAndroid ? props : restProps)}
+        {...restProps}
+        scrollEnabled={scrollEnabled}
         onInputFocus={() => props.onFocus?.()}
         onInputBlur={() => props.onBlur?.()}
         onChangeText={handleOnChangeTextEvent}

package/src/TypeRichTextInputNativeComponent.ts

@@ -1,111 +1,325 @@
-import type { ColorValue } from 'react-native';
-import {
-  codegenNativeComponent,
-  codegenNativeCommands,
-  type ViewProps,
-} from 'react-native';
+import { codegenNativeComponent, codegenNativeCommands } from 'react-native';
 import type { HostComponent } from 'react-native';
+import type { ColorValue, ViewProps } from 'react-native';
 import type {
   BubblingEventHandler,
-  Double,
   WithDefault,
   DirectEventHandler,
   Float,
+  Double,
   Int32,
 } from 'react-native/Libraries/Types/CodegenTypes';
 
+type ComponentType = HostComponent<TypeRichTextInputNativeProps>;
+
+interface NativeCommands {
+  // General commands
+  focus: (viewRef: React.ElementRef<ComponentType>) => void;
+  blur: (viewRef: React.ElementRef<ComponentType>) => void;
+  setText: (viewRef: React.ElementRef<ComponentType>, text: string) => void;
+  insertTextAt: (
+    viewRef: React.ElementRef<ComponentType>,
+    start: Int32,
+    end: Int32,
+    text: string
+  ) => void;
+  setSelection: (
+    viewRef: React.ElementRef<ComponentType>,
+    start: Int32,
+    end: Int32
+  ) => void;
+}
+
+export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: [
+    // General commands
+    'focus',
+    'blur',
+    'setText',
+    'setSelection',
+    'insertTextAt',
+  ],
+});
+
+export default codegenNativeComponent<TypeRichTextInputNativeProps>(
+  'TypeRichTextInputView',
+  {
+    interfaceOnly: true,
+  }
+) as HostComponent<TypeRichTextInputNativeProps>;
+
+// types ---------------------------------------------------
+/**
+ * Payload for the `onChangeText` event.
+ *
+ * Emitted whenever the text content of the input changes.
+ */
 export interface OnChangeTextEvent {
+  /**
+   * The current text value of the input.
+   */
   value: string;
 }
 
+/**
+ * Payload for the `onChangeSelection` event.
+ *
+ * Emitted when the text selection or cursor position changes.
+ */
 export interface OnChangeSelectionEvent {
+  /**
+   * Start index of the selection (inclusive).
+   */
   start: Int32;
+
+  /**
+   * End index of the selection (exclusive).
+   */
   end: Int32;
+
+  /**
+   * Full text content at the time of the selection change.
+   */
   text: string;
 }
+
+/**
+ * Payload for the `onPasteImage` event.
+ *
+ * Emitted when an image is pasted into the input from the clipboard,
+ * keyboard, or context menu.
+ */
 export interface onPasteImageEventData {
+  /**
+   * Local URI of the pasted image.
+   */
   uri: string;
+
+  /**
+   * MIME type of the image (e.g. `image/png`, `image/jpeg`).
+   */
   type: string;
+
+  /**
+   * Original file name of the image, if available.
+   */
   fileName: string;
+
+  /**
+   * File size of the image in bytes.
+   */
   fileSize: Double;
+
+  /**
+   * Source from which the image was pasted.
+   *
+   * - `keyboard` — Inserted via keyboard image/GIF picker
+   * - `clipboard` — Pasted directly from the system clipboard and context menu
+   * - `context_menu` — Pasted via long-press context menu
+   *
+   * ⚠️ **Deprecation notice**
+   * The `context_menu` source is **temporary** and will be
+   * removed in a future release due to platform limitations
+   */
   source: 'keyboard' | 'clipboard' | 'context_menu';
-  error?: { message: string };
+
+  /**
+   * Optional error information if the image could not be processed.
+   */
+  error?: {
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+  };
 }
 
 export interface TypeRichTextInputNativeProps extends ViewProps {
-  // base props
+  // base props ---------------------------------------------------------------
+  /**
+   * @deprecated
+   * ⚠️ Do NOT use this for controlled input.
+   *
+   * This prop is **not reactive** after mount.
+   * Use the `setText()` command instead.
+   */
   value?: string;
+
+  /**
+   * Automatically focuses the input when it mounts.
+   */
   autoFocus?: boolean;
+
+  /**
+   * Controls whether the input is editable.
+   *
+   * When set to `false`, the input becomes read-only and cannot be focused.
+   */
   editable?: boolean;
+
+  /**
+   * Initial text value applied on mount.
+   *
+   * Unlike `value`, this is safe to use and does not imply controlled behavior.
+   */
   defaultValue?: string;
+
+  /**
+   * Placeholder text displayed when the input is empty.
+   */
   placeholder?: string;
+
+  /**
+   * Color of the placeholder text.
+   */
   placeholderTextColor?: ColorValue;
+
+  /**
+   * Color of the text cursor (caret).
+   * on iOS cursor color will be same as selection color
+   */
   cursorColor?: ColorValue;
+
+  /**
+   * Color of the text selection highlight.
+   */
   selectionColor?: ColorValue;
+
+  /**
+   * Controls automatic capitalization behavior.
+   *
+   * values: `"none"`, `"sentences"`, `"words"`, `"characters"`.
+   */
   autoCapitalize?: string;
+
+  /**
+   * Enables or disables vertical scrolling.
+   *
+   * When disabled, the input will expand to fit its content.
+   */
   scrollEnabled?: boolean;
+
+  /**
+   * Enables multiline text input.
+   *
+   * When `true`, the input can span multiple lines.
+   */
   multiline?: boolean;
+
+  /**
+   * ⚠️ **Use with caution**
+   *
+   * Limits the number of visible text lines.
+   *
+   * In complex or rich-text scenarios, `numberOfLines` may cause
+   * unexpected layout or scrolling issues—especially on iOS.
+   *
+   * **Recommended approach:**
+   * - Set `multiline={true}`
+   * - Control height using `maxHeight` instead
+   */
   numberOfLines?: Int32;
-  secureTextEntry?: boolean;
+
+  /**
+   * **Android only**
+   *
+   * Enables secure text entry (password mode).
+   * Characters are obscured as the user types.
+   */
+  secureTextEntry?: boolean; // Android only
+
+  /**
+   * **iOS only**
+   *
+   * Controls the keyboard appearance.
+   *
+   * - `default` — System default appearance
+   * - `light` — Light keyboard
+   * - `dark` — Dark keyboard
+   */
   keyboardAppearance?: WithDefault<'default' | 'light' | 'dark', 'default'>; // ios only
 
-  // Todo
-  // disableImagePasting?: boolean
+  /**
+   * Disables pasting images from the clipboard.
+   *
+   * - **iOS:** The “Paste” option is removed from the context menu
+   *   when the clipboard contains only images.
+   * - **Android:** Stickers and GIF inputs are disabled, but the
+   *   paste option may still appear due to platform limitations.
+   */
+  disableImagePasting?: boolean;
 
-  // event callbacks
+  // event callbacks ---------------------------------------------------------------
+  /**
+   * Called when the input receives focus.
+   */
   onInputFocus?: DirectEventHandler<null>;
+
+  /**
+   * Called when the input loses focus.
+   */
   onInputBlur?: DirectEventHandler<null>;
+
+  /**
+   * Called whenever the text content changes.
+   */
   onChangeText?: DirectEventHandler<OnChangeTextEvent>;
+
+  /**
+   * Called when the text selection changes.
+   */
   onChangeSelection?: DirectEventHandler<OnChangeSelectionEvent>;
+
+  /**
+   * Called when an image is pasted from the clipboard.
+   * Emits {@link onPasteImageEventData}.
+   */
   onPasteImage?: BubblingEventHandler<onPasteImageEventData>;
 
   // Style related props - used for generating proper setters in component's manager
   // These should not be passed as regular props
+
+  /**
+   * Text color.
+   */
   color?: ColorValue;
+
+  /**
+   * Font size of the text.
+   */
   fontSize?: Float;
+
+  /**
+   * Font family name.
+   */
   fontFamily?: string;
+
+  /**
+   * Font weight.
+   *
+   * Example values: `"normal"`, `"bold"`, `"100"`–`"900"`.
+   */
   fontWeight?: string;
+
+  /**
+   * Font style.
+   *
+   * Example values: `"normal"`, `"italic"`.
+   */
   fontStyle?: string;
+
+  /**
+   * Line height of the text.
+   */
   lineHeight?: Float;
 
-  // other
+  /**
+   * ⚠️ **Use with caution**
+   * Enabling this prop fixes input flickering while auto growing.
+   * However, it's still experimental and not tested well.
+   * it's causing some strange issues.
+   * See: https://github.com/software-mansion/react-native-enriched/issues/229
+   * const ANDROID_EXPERIMENTAL_SYNCHRONOUS_EVENTS = false;
+   */
   androidExperimentalSynchronousEvents?: boolean;
 }
-
-type ComponentType = HostComponent<TypeRichTextInputNativeProps>;
-
-interface NativeCommands {
-  // General commands
-  focus: (viewRef: React.ElementRef<ComponentType>) => void;
-  blur: (viewRef: React.ElementRef<ComponentType>) => void;
-  setText: (viewRef: React.ElementRef<ComponentType>, text: string) => void;
-  insertTextAt: (
-    viewRef: React.ElementRef<ComponentType>,
-    start: Int32,
-    end: Int32,
-    text: string
-  ) => void;
-  setSelection: (
-    viewRef: React.ElementRef<ComponentType>,
-    start: Int32,
-    end: Int32
-  ) => void;
-}
-
-export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
-  supportedCommands: [
-    // General commands
-    'focus',
-    'blur',
-    'setText',
-    'setSelection',
-    'insertTextAt',
-  ],
-});
-
-export default codegenNativeComponent<TypeRichTextInputNativeProps>(
-  'TypeRichTextInputView',
-  {
-    interfaceOnly: true,
-  }
-) as HostComponent<TypeRichTextInputNativeProps>;

package/src/index.tsx

@@ -1,8 +1,4 @@
 export { default as TypeRichTextInput } from './TypeRichTextInput';
 export * from './TypeRichTextInputNativeComponent';
 export * from './TypeRichTextInput';
-export type {
-  OnChangeTextEvent,
-  OnChangeSelectionEvent,
-  onPasteImageEventData,
-} from './TypeRichTextInputNativeComponent';
+export * from './types/TypeRichTextInput';