react-native-enriched-markdown-scaffold 1.0.2-scaffold.1 → 1.0.2-scaffold.3

package/src/types/MarkdownTextProps.ts

@@ -6,6 +6,7 @@ import type {
   LinkLongPressEvent,
   TaskListItemPressEvent,
   CopyPressEvent,
+  CopyEvent,
 } from './events';
 
 /**
@@ -57,22 +58,31 @@ export interface SelectionMenuPluralLabels {
  * Controls the built-in items added to the native text selection menu and
  * lets you localize their labels.
  *
- * Each item accepts an object: `{ enabled }` toggles visibility (the system
- * `copy` item can't be hidden — only relabeled) and `label` overrides the
- * English default. Wire `label` to your i18n library to match the rest of your
- * app's UI. Labels apply to the main text selection menu as well as the table
- * and math block copy menus.
+ * Each item accepts an object: `{ enabled }` toggles visibility and `label`
+ * overrides the English default. Wire `label` to your i18n library to match
+ * the rest of your app's UI. Items and labels apply to the main text selection
+ * menu as well as the table, math and code block copy menus.
+ *
+ * `copy.enabled`, `copy.format` and `systemItems` are ignored on macOS.
  *
  * @platform ios, android, macos
  */
 export interface SelectionMenuConfig {
   /**
-   * The system "Copy" item. It can't be hidden — only its label is configurable.
-   * @default { label: "Copy" }
+   * The "Copy" item.
+   * - `enabled`: `false` removes it from the text selection menu, the table /
+   *   math / code block menus and the code block VoiceOver copy action.
+   * - `format`: `'rich'` copies rich text (plain + HTML, plus RTF on iOS) from
+   *   text selections and the raw content from blocks; `'markdown'` copies
+   *   Markdown as plain text everywhere the item appears (inline math becomes
+   *   `$…$`, math blocks `$$…$$`, code blocks are fenced). The code block header
+   *   button and VoiceOver action always copy the raw code.
+   * @default { enabled: true, label: "Copy", format: "rich" }
    */
-  copy?: { label?: string };
+  copy?: { enabled?: boolean; label?: string; format?: 'rich' | 'markdown' };
   /**
-   * The built-in "Copy as Markdown" action for text selections.
+   * The built-in "Copy as Markdown" action, in the text selection menu and in
+   * the table / math / code block menus.
    * @default { enabled: true, label: "Copy as Markdown" }
    */
   copyAsMarkdown?: { enabled?: boolean; label?: string };
@@ -87,6 +97,23 @@ export interface SelectionMenuConfig {
     label?: string;
     pluralLabels?: SelectionMenuPluralLabels;
   };
+  /**
+   * Which system items the text selection menu keeps.
+   * - `'default'`: keep everything the OS adds (Select All, Look Up, Share,
+   *   Translate, app text actions…), with Copy replaced by the built-in one.
+   * - `'none'`: drop every system item; the menu only holds the built-in items
+   *   above and `contextMenuItems`.
+   * @default 'default'
+   * @platform ios, android
+   */
+  systemItems?: 'default' | 'none';
+  /**
+   * The copy button in the code block header. `false` hides the button; the
+   * header and language label stay.
+   * @default { enabled: true }
+   * @platform ios, android, macos
+   */
+  codeBlockCopyButton?: { enabled?: boolean };
 }
 
 export interface StreamingConfig {
@@ -179,13 +206,26 @@ export interface EnrichedMarkdownTextProps extends Omit<ViewProps, 'style'> {
    * Callback fired when code is copied from a fenced code block, via the header
    * copy button, the long-press context-menu "Copy" action, or the VoiceOver
    * copy action. Receives the copied code and its language. Does not fire for
-   * "Copy as Markdown".
+   * "Copy as Markdown", nor for the context-menu "Copy" when
+   * `selectionMenuConfig.copy.format` is `'markdown'`.
    *
    * Only fires when `flavor="github"` (the copy button is part of the GitHub
    * flavor's container-based code block renderer).
    * @platform ios, android, macos
    */
   onCopyPress?: (event: CopyPressEvent) => void;
+  /**
+   * Takes over the "Copy" item of the text selection menu and of the table /
+   * math / code block menus. When set, native does **not** write the
+   * clipboard: it calls this with the copied content and the handler writes
+   * whatever it wants (e.g. with `expo-clipboard`). Overrides
+   * `selectionMenuConfig.copy.format`; `copy.enabled: false` still hides the
+   * item. "Copy as Markdown", the code block header button and the VoiceOver
+   * copy action are unaffected, and `onCopyPress` does not fire for an
+   * intercepted Copy.
+   * @platform ios, android
+   */
+  onCopy?: (event: CopyEvent) => void;
   /**
    * Controls whether the system link preview is shown on long press (iOS only).
    *

package/src/types/events.ts

@@ -17,6 +17,29 @@ export interface CopyPressEvent {
   language: string;
 }
 
+/**
+ * Payload of `onCopy`: what the Copy item would have copied. With `onCopy`
+ * set, native writes nothing to the clipboard — the handler owns the write.
+ */
+export interface CopyEvent {
+  /** Which menu the Copy item belongs to. */
+  source: 'selection' | 'math' | 'table' | 'code';
+  /**
+   * Markdown of the copied content — what `copy.format: 'markdown'` writes.
+   * Text selections: the original source when `whole`, otherwise rebuilt from
+   * the rendered styles (falls back to `text`). Blocks: `$$…$$`, the table as
+   * Markdown, or the fenced code block.
+   */
+  markdown: string;
+  /** Rendered text of the selection, or the block's raw content. */
+  text: string;
+  /**
+   * `true` when the selection covers the whole component, so `markdown` is the
+   * original source. Always `true` for blocks.
+   */
+  whole: boolean;
+}
+
 /**
  * Native-level context menu item config sent to the native component.
  * Does not include the `onPress` callback — callbacks are managed on the JS side.