react-native-enriched-markdown-scaffold 1.0.2-scaffold.4 → 1.0.2-scaffold.5

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

@@ -2,5 +2,5 @@ import type { EnrichedMarkdownTextInputProps } from '../EnrichedMarkdownTextInpu
 import type { EnrichedMarkdownTextProps } from '../native/EnrichedMarkdownText';
 export { DEFAULT_ACCESSIBILITY_LABELS, resolveAccessibilityLabels, } from '../accessibilityLabelDefaults';
 export declare const EnrichedMarkdownTextInput: ({ ref, defaultValue, onChangeText, onChangeMarkdown, onFocus, onBlur, editable, placeholder, placeholderTextColor, autoFocus, multiline, scrollEnabled, style, testID, accessible, accessibilityLabel, accessibilityHint, accessibilityRole, accessibilityState, nativeID, markdownStyle: _markdownStyle, cursorColor: _cursorColor, selectionColor: _selectionColor, autoCapitalize: _autoCapitalize, onChangeSelection: _onChangeSelection, onChangeState: _onChangeState, onKeyPress: _onKeyPress, onCaretRectChange: _onCaretRectChange, onLinkDetected: _onLinkDetected, mentionIndicators: _mentionIndicators, onStartMention: _onStartMention, onChangeMention: _onChangeMention, onEndMention: _onEndMention, contextMenuItems: _contextMenuItems, selectionMenuConfig: _selectionMenuConfig, formatMenuConfig: _formatMenuConfig, linkRegex: _linkRegex, writingDirection: _writingDirection, }: EnrichedMarkdownTextInputProps) => import("react/jsx-runtime").JSX.Element;
-export declare const EnrichedMarkdownText: ({ markdown, containerStyle, testID, accessible, accessibilityLabel, accessibilityHint, accessibilityRole, accessibilityState, nativeID, markdownStyle: _markdownStyle, onLinkPress: _onLinkPress, onLinkLongPress: _onLinkLongPress, onTaskListItemPress: _onTaskListItemPress, enableLinkPreview: _enableLinkPreview, selectable: _selectable, md4cFlags: _md4cFlags, allowFontScaling: _allowFontScaling, maxFontSizeMultiplier: _maxFontSizeMultiplier, allowTrailingMargin: _allowTrailingMargin, flavor: _flavor, streamingAnimation: _streamingAnimation, streamingConfig: _streamingConfig, spoilerOverlay: _spoilerOverlay, contextMenuItems: _contextMenuItems, imageRequestHeaders: _imageRequestHeaders, selectionMenuConfig: _selectionMenuConfig, accessibilityLabels: _accessibilityLabels, selectionColor: _selectionColor, selectionHandleColor: _selectionHandleColor, textBreakStrategy: _textBreakStrategy, lineBreakStrategyIOS: _lineBreakStrategyIOS, writingDirection: _writingDirection, }: EnrichedMarkdownTextProps) => import("react/jsx-runtime").JSX.Element;
+export declare const EnrichedMarkdownText: ({ ref, markdown, containerStyle, testID, accessible, accessibilityLabel, accessibilityHint, accessibilityRole, accessibilityState, nativeID, markdownStyle: _markdownStyle, onLinkPress: _onLinkPress, onLinkLongPress: _onLinkLongPress, onTaskListItemPress: _onTaskListItemPress, onSelectionChange: _onSelectionChange, enableLinkPreview: _enableLinkPreview, selectable: _selectable, md4cFlags: _md4cFlags, allowFontScaling: _allowFontScaling, maxFontSizeMultiplier: _maxFontSizeMultiplier, allowTrailingMargin: _allowTrailingMargin, flavor: _flavor, streamingAnimation: _streamingAnimation, streamingConfig: _streamingConfig, spoilerOverlay: _spoilerOverlay, contextMenuItems: _contextMenuItems, imageRequestHeaders: _imageRequestHeaders, selectionMenuConfig: _selectionMenuConfig, accessibilityLabels: _accessibilityLabels, selectionColor: _selectionColor, selectionHandleColor: _selectionHandleColor, textBreakStrategy: _textBreakStrategy, lineBreakStrategyIOS: _lineBreakStrategyIOS, writingDirection: _writingDirection, }: EnrichedMarkdownTextProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/jest/index.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAGV,8BAA8B,EAE/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AASvC,eAAO,MAAM,yBAAyB,GAAI,02BAuCvC,8BAA8B,4CAmFhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,o9BAiClC,yBAAyB,4CAe3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/jest/index.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAGV,8BAA8B,EAE/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AASvC,eAAO,MAAM,yBAAyB,GAAI,02BAuCvC,8BAA8B,4CAmFhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,ggCAmClC,yBAAyB,4CA8B3B,CAAC"}

package/lib/typescript/src/native/EnrichedMarkdownText.d.ts

@@ -1,9 +1,9 @@
 import type { MarkdownStyle, Md4cFlags } from '../types/MarkdownStyle';
-import type { EnrichedMarkdownTextProps, StreamingConfig, ContextMenuItem, SelectionMenuConfig, SelectionMenuPluralLabels, LinkDecorationInfo, LinkRect } from '../types/MarkdownTextProps';
-import type { LinkPressEvent, LinkLongPressEvent, TaskListItemPressEvent, CopyPressEvent, CopyEvent } from '../types/events';
+import type { EnrichedMarkdownTextProps, EnrichedMarkdownTextInstance, StreamingConfig, ContextMenuItem, SelectionMenuConfig, SelectionMenuPluralLabels, LinkDecorationInfo, LinkRect } from '../types/MarkdownTextProps';
+import type { LinkPressEvent, LinkLongPressEvent, TaskListItemPressEvent, CopyPressEvent, CopyEvent, SelectionChangeEvent, SelectionRect } from '../types/events';
 export type { MarkdownStyle, Md4cFlags };
-export type { EnrichedMarkdownTextProps, StreamingConfig, ContextMenuItem, SelectionMenuConfig, SelectionMenuPluralLabels, LinkDecorationInfo, LinkRect, };
-export type { LinkPressEvent, LinkLongPressEvent, TaskListItemPressEvent, CopyPressEvent, CopyEvent, };
-export declare const EnrichedMarkdownText: ({ markdown, markdownStyle, containerStyle, onLinkPress, onLinkLongPress, onTaskListItemPress, enableTaskListItemToggle, onCopyPress, onCopy, enableLinkPreview, selectable, md4cFlags, allowFontScaling, maxFontSizeMultiplier, allowTrailingMargin, flavor, streamingAnimation, streamingConfig, spoilerOverlay, contextMenuItems, imageRequestHeaders, contextMenuHidden, selectionMenuConfig, accessibilityLabels, selectionColor, selectionHandleColor, textBreakStrategy, lineBreakStrategyIOS, writingDirection, renderLinkDecoration, onLayout, ...rest }: EnrichedMarkdownTextProps) => import("react/jsx-runtime").JSX.Element;
+export type { EnrichedMarkdownTextProps, EnrichedMarkdownTextInstance, StreamingConfig, ContextMenuItem, SelectionMenuConfig, SelectionMenuPluralLabels, LinkDecorationInfo, LinkRect, };
+export type { LinkPressEvent, LinkLongPressEvent, TaskListItemPressEvent, CopyPressEvent, CopyEvent, SelectionChangeEvent, SelectionRect, };
+export declare const EnrichedMarkdownText: ({ ref, markdown, markdownStyle, containerStyle, onLinkPress, onLinkLongPress, onTaskListItemPress, enableTaskListItemToggle, onCopyPress, onCopy, onSelectionChange, enableLinkPreview, selectable, md4cFlags, allowFontScaling, maxFontSizeMultiplier, allowTrailingMargin, flavor, streamingAnimation, streamingConfig, spoilerOverlay, contextMenuItems, imageRequestHeaders, contextMenuHidden, selectionMenuConfig, accessibilityLabels, selectionColor, selectionHandleColor, textBreakStrategy, lineBreakStrategyIOS, writingDirection, renderLinkDecoration, onLayout, ...rest }: EnrichedMarkdownTextProps) => import("react/jsx-runtime").JSX.Element;
 export default EnrichedMarkdownText;
 //# sourceMappingURL=EnrichedMarkdownText.d.ts.map

package/lib/typescript/src/native/EnrichedMarkdownText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnrichedMarkdownText.d.ts","sourceRoot":"","sources":["../../../../src/native/EnrichedMarkdownText.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,QAAQ,EACT,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,SAAS,EAEV,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AACzC,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,QAAQ,GACT,CAAC;AACF,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,SAAS,GACV,CAAC;AAoGF,eAAO,MAAM,oBAAoB,GAAI,kiBAiClC,yBAAyB,4CA0R3B,CAAC;AAMF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"EnrichedMarkdownText.d.ts","sourceRoot":"","sources":["../../../../src/native/EnrichedMarkdownText.tsx"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EACV,yBAAyB,EACzB,4BAA4B,EAC5B,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,QAAQ,EACT,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,SAAS,EAET,oBAAoB,EACpB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AACzC,YAAY,EACV,yBAAyB,EACzB,4BAA4B,EAC5B,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,QAAQ,GACT,CAAC;AACF,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,aAAa,GACd,CAAC;AAoGF,eAAO,MAAM,oBAAoB,GAAI,0jBAmClC,yBAAyB,4CA8U3B,CAAC;AAMF,eAAe,oBAAoB,CAAC"}

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

@@ -1,8 +1,20 @@
-import type { ReactNode } from 'react';
-import type { ColorValue, ViewProps, ViewStyle, TextStyle } from 'react-native';
+import type { ReactNode, RefObject } from 'react';
+import type { ColorValue, HostInstance, ViewProps, ViewStyle, TextStyle } from 'react-native';
 import type { MarkdownStyle, Md4cFlags } from './MarkdownStyle';
 import type { AccessibilityLabels } from './AccessibilityLabels';
-import type { LinkPressEvent, LinkLongPressEvent, TaskListItemPressEvent, CopyPressEvent, CopyEvent } from './events';
+import type { LinkPressEvent, LinkLongPressEvent, TaskListItemPressEvent, CopyPressEvent, CopyEvent, SelectionChangeEvent } from './events';
+/** Imperative handle of `EnrichedMarkdownText`, reached through its `ref`. */
+export interface EnrichedMarkdownTextInstance {
+    /**
+     * Clears the text selection (and any long-pressed block) and fires
+     * `onSelectionChange` with `active: false`.
+     * @platform ios, android
+     */
+    clearSelection: () => void;
+    measure: HostInstance['measure'];
+    measureInWindow: HostInstance['measureInWindow'];
+    measureLayout: HostInstance['measureLayout'];
+}
 /**
  * A rect in dp, relative to the component's content box (inside any
  * `containerStyle` padding).
@@ -168,6 +180,11 @@ export interface StreamingConfig {
     codeBlockMode?: 'hidden' | 'progressive';
 }
 export interface EnrichedMarkdownTextProps extends Omit<ViewProps, 'style'> {
+    /**
+     * Imperative handle: `clearSelection()` plus the host `measure*` methods.
+     * @platform ios, android
+     */
+    ref?: RefObject<EnrichedMarkdownTextInstance | null>;
     /**
      * Markdown content to render.
      * @platform ios, android, web
@@ -268,6 +285,22 @@ export interface EnrichedMarkdownTextProps extends Omit<ViewProps, 'style'> {
      * @platform ios, android
      */
     onCopy?: (event: CopyEvent) => void;
+    /**
+     * Reports the text selection so the app can draw its own menu (pair it with
+     * `contextMenuHidden`). Fires at most once per frame while the selection
+     * changes, and with `active: false` once it is gone. With
+     * `contextMenuHidden`, a long press on a table / math / code block fires it
+     * too (`source` is the block kind, `whole: true`), since those blocks have no
+     * text selection of their own. Only one part of a component holds a
+     * selection at a time; clearing the selection of *other* components is up to
+     * the app (`ref.current.clearSelection()`).
+     *
+     * Rects are relative to the view that `ref.current.measureInWindow`
+     * measures — add that origin to position UI on screen. There is no
+     * "dragging" flag: debounce before showing a menu.
+     * @platform ios, android
+     */
+    onSelectionChange?: (event: SelectionChangeEvent) => void;
     /**
      * Controls whether the system link preview is shown on long press (iOS only).
      *

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

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

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

@@ -35,6 +35,42 @@ export interface CopyEvent {
      */
     whole: boolean;
 }
+/**
+ * A rect in dp, relative to the component's native view: add the origin from
+ * the component ref's `measureInWindow` to get window coordinates.
+ */
+export interface SelectionRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Payload of `onSelectionChange`: the current text selection, or a table /
+ * math / code block long-pressed while `contextMenuHidden` is on. Content
+ * fields carry what `onCopy` would receive for the same selection.
+ */
+export interface SelectionChangeEvent {
+    /** `false` once the selection is gone; every other field is then empty / zero. */
+    active: boolean;
+    /** `'selection'` for text; the block kind for a long-pressed block. */
+    source: CopyEvent['source'];
+    /** Rendered text of the selection, or the block's raw content. */
+    text: string;
+    /** Same as `CopyEvent.markdown` for this selection. */
+    markdown: string;
+    /** Same as `CopyEvent.whole`. Always `true` for blocks. */
+    whole: boolean;
+    /**
+     * Bounding box of the selection (full content width when it spans several
+     * lines); the block's frame for blocks.
+     */
+    rect: SelectionRect;
+    /** Selected part of the first line (block: same as `rect`). */
+    startRect: SelectionRect;
+    /** Selected part of the last line (block: same as `rect`). */
+    endRect: SelectionRect;
+}
 /**
  * Native-level context menu item config sent to the native component.
  * Does not include the `onPress` callback — callbacks are managed on the JS side.

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/types/events.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/types/events.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,MAAM,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,aAAa,CAAC;IACpB,+DAA+D;IAC/D,SAAS,EAAE,aAAa,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-enriched-markdown-scaffold",
-  "version": "1.0.2-scaffold.4",
+  "version": "1.0.2-scaffold.5",
   "description": "Markdown-based Rich Text solution for React Native",
   "main": "./lib/module/index",
   "module": "./lib/module/index",

package/src/EnrichedMarkdownNativeComponent.ts

@@ -1,9 +1,12 @@
 import {
   codegenNativeComponent,
+  codegenNativeCommands,
   type ViewProps,
   type CodegenTypes,
   type ColorValue,
+  type HostComponent,
 } from 'react-native';
+import type React from 'react';
 
 // All block styles extend this interface
 interface BaseBlockStyleInternal {
@@ -274,6 +277,39 @@ export interface LinkLayoutEvent {
   }[];
 }
 
+/**
+ * Current text selection, or a long-pressed table / math / code block while
+ * `contextMenuHidden` is on. `active: false` means the selection was cleared
+ * (every other field is then empty / zero). Rects are in dp / pt, relative to
+ * the native view's origin; rect objects are written inline because codegen
+ * only accepts inline object literals in event payloads.
+ */
+export interface SelectionChangeEvent {
+  active: boolean;
+  source: string;
+  text: string;
+  markdown: string;
+  whole: boolean;
+  rect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+  startRect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+  endRect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+}
+
 export interface TaskListItemPressEvent {
   index: CodegenTypes.Int32;
   checked: boolean;
@@ -441,6 +477,18 @@ export interface NativeProps extends ViewProps {
    * Deduplicated: not re-fired when the payload is unchanged.
    */
   onLinkLayout?: CodegenTypes.DirectEventHandler<LinkLayoutEvent>;
+  /**
+   * When true, the view reports selection changes (and, with
+   * `contextMenuHidden`, block long-presses) through `onSelectionChange`.
+   * Set by the JS wrapper only when `onSelectionChange` is provided.
+   * @default false
+   */
+  emitSelectionChange?: CodegenTypes.WithDefault<boolean, false>;
+  /**
+   * Fired while `emitSelectionChange` is on: coalesced to one event per frame,
+   * deduplicated, and `active: false` once the selection is gone.
+   */
+  onSelectionChange?: CodegenTypes.DirectEventHandler<SelectionChangeEvent>;
   /**
    * Callback fired when a task list checkbox is tapped.
    * Receives the 0-based task index, current checked state, and the item's plain text.
@@ -594,6 +642,17 @@ export interface NativeProps extends ViewProps {
   writingDirection?: CodegenTypes.WithDefault<string, 'first-strong'>;
 }
 
+type ComponentType = HostComponent<NativeProps>;
+
+interface NativeCommands {
+  /** Clears the text selection (and any active block) and fires `onSelectionChange` with `active: false`. */
+  clearSelection: (viewRef: React.ElementRef<ComponentType>) => void;
+}
+
+export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['clearSelection'],
+});
+
 export default codegenNativeComponent<NativeProps>('EnrichedMarkdown', {
   interfaceOnly: true,
-});
+}) as HostComponent<NativeProps>;

package/src/EnrichedMarkdownTextNativeComponent.ts

@@ -1,9 +1,12 @@
 import {
   codegenNativeComponent,
+  codegenNativeCommands,
   type ViewProps,
   type CodegenTypes,
   type ColorValue,
+  type HostComponent,
 } from 'react-native';
+import type React from 'react';
 
 // All block styles extend this interface
 interface BaseBlockStyleInternal {
@@ -275,6 +278,39 @@ export interface LinkLayoutEvent {
   }[];
 }
 
+/**
+ * Current text selection, or a long-pressed table / math / code block while
+ * `contextMenuHidden` is on. `active: false` means the selection was cleared
+ * (every other field is then empty / zero). Rects are in dp / pt, relative to
+ * the native view's origin; rect objects are written inline because codegen
+ * only accepts inline object literals in event payloads.
+ */
+export interface SelectionChangeEvent {
+  active: boolean;
+  source: string;
+  text: string;
+  markdown: string;
+  whole: boolean;
+  rect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+  startRect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+  endRect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+}
+
 export interface TaskListItemPressEvent {
   index: CodegenTypes.Int32;
   checked: boolean;
@@ -442,6 +478,18 @@ export interface NativeProps extends ViewProps {
    * Deduplicated: not re-fired when the payload is unchanged.
    */
   onLinkLayout?: CodegenTypes.DirectEventHandler<LinkLayoutEvent>;
+  /**
+   * When true, the view reports selection changes (and, with
+   * `contextMenuHidden`, block long-presses) through `onSelectionChange`.
+   * Set by the JS wrapper only when `onSelectionChange` is provided.
+   * @default false
+   */
+  emitSelectionChange?: CodegenTypes.WithDefault<boolean, false>;
+  /**
+   * Fired while `emitSelectionChange` is on: coalesced to one event per frame,
+   * deduplicated, and `active: false` once the selection is gone.
+   */
+  onSelectionChange?: CodegenTypes.DirectEventHandler<SelectionChangeEvent>;
   /**
    * Callback fired when a task list checkbox is tapped.
    * Receives the 0-based task index, current checked state, and the item's plain text.
@@ -594,6 +642,17 @@ export interface NativeProps extends ViewProps {
   writingDirection?: CodegenTypes.WithDefault<string, 'first-strong'>;
 }
 
+type ComponentType = HostComponent<NativeProps>;
+
+interface NativeCommands {
+  /** Clears the text selection (and any active block) and fires `onSelectionChange` with `active: false`. */
+  clearSelection: (viewRef: React.ElementRef<ComponentType>) => void;
+}
+
+export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['clearSelection'],
+});
+
 export default codegenNativeComponent<NativeProps>('EnrichedMarkdownText', {
   interfaceOnly: true,
-});
+}) as HostComponent<NativeProps>;

package/src/index.tsx

@@ -1,6 +1,7 @@
 export { default as EnrichedMarkdownText } from './native/EnrichedMarkdownText';
 export type {
   EnrichedMarkdownTextProps,
+  EnrichedMarkdownTextInstance,
   StreamingConfig,
   MarkdownStyle,
   Md4cFlags,
@@ -17,6 +18,8 @@ export type {
   CopyPressEvent,
   CopyEvent,
   OnPasteEvent,
+  SelectionChangeEvent,
+  SelectionRect,
 } from './types/events';
 export type {
   AccessibilityLabels,

package/src/jest/index.tsx

@@ -26,7 +26,10 @@ import type {
   EnrichedMarkdownTextInputProps,
   InsertMathOptions,
 } from '../EnrichedMarkdownTextInput';
-import type { EnrichedMarkdownTextProps } from '../native/EnrichedMarkdownText';
+import type {
+  EnrichedMarkdownTextInstance,
+  EnrichedMarkdownTextProps,
+} from '../native/EnrichedMarkdownText';
 
 export {
   DEFAULT_ACCESSIBILITY_LABELS,
@@ -165,6 +168,7 @@ export const EnrichedMarkdownTextInput = ({
 };
 
 export const EnrichedMarkdownText = ({
+  ref,
   markdown,
   containerStyle,
   testID,
@@ -178,6 +182,7 @@ export const EnrichedMarkdownText = ({
   onLinkPress: _onLinkPress,
   onLinkLongPress: _onLinkLongPress,
   onTaskListItemPress: _onTaskListItemPress,
+  onSelectionChange: _onSelectionChange,
   enableLinkPreview: _enableLinkPreview,
   selectable: _selectable,
   md4cFlags: _md4cFlags,
@@ -198,6 +203,21 @@ export const EnrichedMarkdownText = ({
   lineBreakStrategyIOS: _lineBreakStrategyIOS,
   writingDirection: _writingDirection,
 }: EnrichedMarkdownTextProps) => {
+  const instanceRef = useRef<EnrichedMarkdownTextInstance | null>(null);
+  if (instanceRef.current === null) {
+    instanceRef.current = {
+      // No native selection under Jest; the mock records the call.
+      clearSelection: spy(() => {}),
+      measure: spy((callback) => callback(0, 0, 0, 0, 0, 0)),
+      measureInWindow: spy((callback) => callback(0, 0, 0, 0)),
+      measureLayout: spy((_relativeToNativeNode, onSuccess) =>
+        onSuccess(0, 0, 0, 0)
+      ),
+    };
+  }
+
+  useImperativeHandle(ref, () => instanceRef.current!);
+
   return (
     <Text
       style={containerStyle}

package/src/native/EnrichedMarkdownText.tsx

@@ -1,10 +1,22 @@
-import { useMemo, useCallback, useRef, useEffect, useState } from 'react';
-import EnrichedMarkdownTextNativeComponent from '../EnrichedMarkdownTextNativeComponent';
+import {
+  useMemo,
+  useCallback,
+  useRef,
+  useEffect,
+  useState,
+  useImperativeHandle,
+} from 'react';
+import EnrichedMarkdownTextNativeComponent, {
+  Commands as TextCommands,
+} from '../EnrichedMarkdownTextNativeComponent';
 import type {
   LinkLayoutEvent,
   MarkdownStyleInternal,
+  SelectionChangeEvent as NativeSelectionChangeEvent,
 } from '../EnrichedMarkdownTextNativeComponent';
-import EnrichedMarkdownNativeComponent from '../EnrichedMarkdownNativeComponent';
+import EnrichedMarkdownNativeComponent, {
+  Commands as MarkdownCommands,
+} from '../EnrichedMarkdownNativeComponent';
 import { normalizeMarkdownStyle } from '../normalizeMarkdownStyle';
 import { resolveAccessibilityLabels } from '../accessibilityLabelDefaults';
 import {
@@ -12,10 +24,15 @@ import {
   normalizeLegacyBooleanMenuItem,
 } from '../normalizeMenuItem';
 import { StyleSheet, View } from 'react-native';
-import type { LayoutChangeEvent, NativeSyntheticEvent } from 'react-native';
+import type {
+  HostInstance,
+  LayoutChangeEvent,
+  NativeSyntheticEvent,
+} from 'react-native';
 import type { MarkdownStyle, Md4cFlags } from '../types/MarkdownStyle';
 import type {
   EnrichedMarkdownTextProps,
+  EnrichedMarkdownTextInstance,
   StreamingConfig,
   ContextMenuItem,
   SelectionMenuConfig,
@@ -30,11 +47,14 @@ import type {
   CopyPressEvent,
   CopyEvent,
   OnContextMenuItemPressEvent,
+  SelectionChangeEvent,
+  SelectionRect,
 } from '../types/events';
 
 export type { MarkdownStyle, Md4cFlags };
 export type {
   EnrichedMarkdownTextProps,
+  EnrichedMarkdownTextInstance,
   StreamingConfig,
   ContextMenuItem,
   SelectionMenuConfig,
@@ -48,6 +68,8 @@ export type {
   TaskListItemPressEvent,
   CopyPressEvent,
   CopyEvent,
+  SelectionChangeEvent,
+  SelectionRect,
 };
 
 // Default English labels for the built-in selection menu actions. Defaults are
@@ -149,6 +171,7 @@ const defaultMd4cFlags: Md4cFlags = {
 };
 
 export const EnrichedMarkdownText = ({
+  ref,
   markdown,
   markdownStyle = {},
   containerStyle,
@@ -158,6 +181,7 @@ export const EnrichedMarkdownText = ({
   enableTaskListItemToggle = true,
   onCopyPress,
   onCopy,
+  onSelectionChange,
   enableLinkPreview,
   selectable = true,
   md4cFlags = defaultMd4cFlags,
@@ -315,6 +339,54 @@ export const EnrichedMarkdownText = ({
     setNativeOffset((prev) => (prev.x === x && prev.y === y ? prev : { x, y }));
   }, []);
 
+  // Rects stay relative to the native view — the view the ref's
+  // `measureInWindow` measures — even when decorations wrap it.
+  const handleSelectionChange = useCallback(
+    // Codegen types `source` as a plain string; native only sends the four
+    // values of SelectionChangeEvent['source'].
+    (e: NativeSyntheticEvent<NativeSelectionChangeEvent>) => {
+      const { source, ...payload } = e.nativeEvent;
+      onSelectionChange?.({
+        ...payload,
+        source: source as SelectionChangeEvent['source'],
+      });
+    },
+    [onSelectionChange]
+  );
+
+  const nativeRef = useRef<HostInstance | null>(null);
+  const isGithubFlavor = flavor === 'github';
+  useImperativeHandle(
+    ref,
+    () => ({
+      clearSelection: () => {
+        const node = nativeRef.current;
+        if (node == null) return;
+        // Codegen's ViewRef resolves to `never` with RN 0.84's function-based
+        // HostComponent type — the cast is safe at runtime.
+        if (isGithubFlavor) {
+          MarkdownCommands.clearSelection(
+            node as Parameters<(typeof MarkdownCommands)['clearSelection']>[0]
+          );
+        } else {
+          TextCommands.clearSelection(
+            node as Parameters<(typeof TextCommands)['clearSelection']>[0]
+          );
+        }
+      },
+      measure: (callback) => nativeRef.current?.measure(callback),
+      measureInWindow: (callback) =>
+        nativeRef.current?.measureInWindow(callback),
+      measureLayout: (relativeToNativeNode, onSuccess, onFail) =>
+        nativeRef.current?.measureLayout(
+          relativeToNativeNode,
+          onSuccess,
+          onFail
+        ),
+    }),
+    [isGithubFlavor]
+  );
+
   const tableMode = streamingConfig?.tableMode ?? 'progressive';
   const codeBlockMode = streamingConfig?.codeBlockMode ?? 'progressive';
   const normalizedStreamingConfig = useMemo(
@@ -396,6 +468,8 @@ export const EnrichedMarkdownText = ({
     enableTaskListItemToggle,
     onCopyPress: handleCopyPress,
     onCopyRequest: handleCopyRequest,
+    emitSelectionChange: onSelectionChange != null,
+    onSelectionChange: handleSelectionChange,
     enableLinkPreview: onLinkLongPress == null && (enableLinkPreview ?? true),
     selectable,
     md4cFlags: normalizedMd4cFlags,
@@ -420,21 +494,23 @@ export const EnrichedMarkdownText = ({
     ...rest,
   };
 
-  const NativeComponent =
-    flavor === 'github'
-      ? EnrichedMarkdownNativeComponent
-      : EnrichedMarkdownTextNativeComponent;
+  const NativeComponent = isGithubFlavor
+    ? EnrichedMarkdownNativeComponent
+    : EnrichedMarkdownTextNativeComponent;
 
   // Without decorations the native view is returned as-is (no wrapper, no
   // layout events) so existing layouts are untouched.
   if (!decorated) {
-    return <NativeComponent {...sharedProps} onLayout={onLayout} />;
+    return (
+      <NativeComponent {...sharedProps} ref={nativeRef} onLayout={onLayout} />
+    );
   }
 
   return (
     <View style={containerStyle} onLayout={onLayout}>
       <NativeComponent
         {...sharedProps}
+        ref={nativeRef}
         style={undefined}
         emitLinkLayout
         onLinkLayout={handleLinkLayout}