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

package/src/types/MarkdownTextProps.ts

@@ -1,5 +1,11 @@
-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 {
@@ -8,8 +14,22 @@ import type {
   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).
@@ -169,6 +189,11 @@ export interface StreamingConfig {
 }
 
 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
@@ -269,6 +294,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/src/types/events.ts

@@ -40,6 +40,44 @@ 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.