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

package/src/native/EnrichedMarkdownText.tsx

@@ -1,43 +1,75 @@
-import { useMemo, useCallback, useRef, useEffect } from 'react';
-import EnrichedMarkdownTextNativeComponent from '../EnrichedMarkdownTextNativeComponent';
-import type { MarkdownStyleInternal } from '../EnrichedMarkdownTextNativeComponent';
-import EnrichedMarkdownNativeComponent from '../EnrichedMarkdownNativeComponent';
+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, {
+  Commands as MarkdownCommands,
+} from '../EnrichedMarkdownNativeComponent';
 import { normalizeMarkdownStyle } from '../normalizeMarkdownStyle';
 import { resolveAccessibilityLabels } from '../accessibilityLabelDefaults';
 import {
   normalizeMenuItem,
   normalizeLegacyBooleanMenuItem,
 } from '../normalizeMenuItem';
-import type { NativeSyntheticEvent } from 'react-native';
+import { StyleSheet, View } 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,
   SelectionMenuPluralLabels,
+  LinkDecorationInfo,
+  LinkRect,
 } from '../types/MarkdownTextProps';
 import type {
   LinkPressEvent,
   LinkLongPressEvent,
   TaskListItemPressEvent,
   CopyPressEvent,
+  CopyEvent,
   OnContextMenuItemPressEvent,
+  SelectionChangeEvent,
+  SelectionRect,
 } from '../types/events';
 
 export type { MarkdownStyle, Md4cFlags };
 export type {
   EnrichedMarkdownTextProps,
+  EnrichedMarkdownTextInstance,
   StreamingConfig,
   ContextMenuItem,
   SelectionMenuConfig,
   SelectionMenuPluralLabels,
+  LinkDecorationInfo,
+  LinkRect,
 };
 export type {
   LinkPressEvent,
   LinkLongPressEvent,
   TaskListItemPressEvent,
   CopyPressEvent,
+  CopyEvent,
+  SelectionChangeEvent,
+  SelectionRect,
 };
 
 // Default English labels for the built-in selection menu actions. Defaults are
@@ -101,6 +133,34 @@ const buildPluralTemplates = (
   return templates;
 };
 
+type LinkLayoutFragment = LinkLayoutEvent['fragments'][number];
+
+/** Groups the flat per-line fragments native reports into one entry per link. */
+const groupLinkFragments = (
+  fragments: ReadonlyArray<LinkLayoutFragment>
+): LinkDecorationInfo[] => {
+  const byIndex = new Map<number, LinkDecorationInfo>();
+  for (const { linkIndex, url, text, x, y, width, height } of fragments) {
+    const rect: LinkRect = { x, y, width, height };
+    const info = byIndex.get(linkIndex);
+    if (info) {
+      info.rects.push(rect);
+      info.rect = rect;
+    } else {
+      byIndex.set(linkIndex, {
+        index: linkIndex,
+        url,
+        text,
+        rect,
+        rects: [rect],
+      });
+    }
+  }
+  return [...byIndex.values()];
+};
+
+const ZERO_OFFSET = { x: 0, y: 0 };
+
 const defaultMd4cFlags: Md4cFlags = {
   underline: false,
   superscript: false,
@@ -111,6 +171,7 @@ const defaultMd4cFlags: Md4cFlags = {
 };
 
 export const EnrichedMarkdownText = ({
+  ref,
   markdown,
   markdownStyle = {},
   containerStyle,
@@ -119,7 +180,10 @@ export const EnrichedMarkdownText = ({
   onTaskListItemPress,
   enableTaskListItemToggle = true,
   onCopyPress,
+  onCopy,
+  onSelectionChange,
   enableLinkPreview,
+  linkLongPressSelects = false,
   selectable = true,
   md4cFlags = defaultMd4cFlags,
   allowFontScaling = true,
@@ -139,6 +203,8 @@ export const EnrichedMarkdownText = ({
   textBreakStrategy,
   lineBreakStrategyIOS,
   writingDirection = 'first-strong',
+  renderLinkDecoration,
+  onLayout,
   ...rest
 }: EnrichedMarkdownTextProps) => {
   const normalizedStyleRef = useRef<MarkdownStyleInternal | null>(null);
@@ -239,6 +305,89 @@ export const EnrichedMarkdownText = ({
     [onCopyPress]
   );
 
+  const handleCopyRequest = useCallback(
+    // Codegen types `source` as a plain string; native only sends the four
+    // values of CopyEvent['source'].
+    (
+      e: NativeSyntheticEvent<Omit<CopyEvent, 'source'> & { source: string }>
+    ) => {
+      const { source, markdown: copied, text, whole } = e.nativeEvent;
+      onCopy?.({
+        source: source as CopyEvent['source'],
+        markdown: copied,
+        text,
+        whole,
+      });
+    },
+    [onCopy]
+  );
+  const interceptCopy = onCopy != null;
+
+  const decorated = renderLinkDecoration != null;
+  const [linkLayout, setLinkLayout] = useState<LinkDecorationInfo[]>([]);
+  // Where the native view sits inside the wrapper (the wrapper's padding).
+  const [nativeOffset, setNativeOffset] = useState(ZERO_OFFSET);
+
+  const handleLinkLayout = useCallback(
+    (e: NativeSyntheticEvent<LinkLayoutEvent>) => {
+      setLinkLayout(groupLinkFragments(e.nativeEvent.fragments));
+    },
+    []
+  );
+
+  const handleNativeLayout = useCallback((e: LayoutChangeEvent) => {
+    const { x, y } = e.nativeEvent.layout;
+    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(
@@ -253,10 +402,19 @@ export const EnrichedMarkdownText = ({
           copy?: unknown;
           copyAsMarkdown?: unknown;
           copyImageUrl?: unknown;
+          systemItems?: unknown;
+          codeBlockCopyButton?: unknown;
         }
       | undefined;
 
     const copy = normalizeMenuItem(config?.copy, true, DEFAULT_COPY_LABEL);
+    const copyFormat = (config?.copy as { format?: unknown } | undefined)
+      ?.format;
+    const codeBlockCopyButton = normalizeMenuItem(
+      config?.codeBlockCopyButton,
+      true,
+      ''
+    );
     const copyAsMarkdown = normalizeLegacyBooleanMenuItem(
       config?.copyAsMarkdown,
       'selectionMenuConfig',
@@ -289,8 +447,13 @@ export const EnrichedMarkdownText = ({
         pluralLabels,
         copyImageUrl.label
       ),
+      copyEnabled: copy.enabled,
+      copyFormatMarkdown: copyFormat === 'markdown',
+      systemItemsNone: config?.systemItems === 'none',
+      codeBlockCopyButton: codeBlockCopyButton.enabled,
+      interceptCopy,
     };
-  }, [selectionMenuConfig]);
+  }, [selectionMenuConfig, interceptCopy]);
 
   const resolvedAccessibilityLabels = useMemo(
     () => resolveAccessibilityLabels(accessibilityLabels),
@@ -305,7 +468,11 @@ export const EnrichedMarkdownText = ({
     onTaskListItemPress: handleTaskListItemPress,
     enableTaskListItemToggle,
     onCopyPress: handleCopyPress,
+    onCopyRequest: handleCopyRequest,
+    emitSelectionChange: onSelectionChange != null,
+    onSelectionChange: handleSelectionChange,
     enableLinkPreview: onLinkLongPress == null && (enableLinkPreview ?? true),
+    linkLongPressSelects,
     selectable,
     md4cFlags: normalizedMd4cFlags,
     allowFontScaling,
@@ -329,11 +496,55 @@ export const EnrichedMarkdownText = ({
     ...rest,
   };
 
-  if (flavor === 'github') {
-    return <EnrichedMarkdownNativeComponent {...sharedProps} />;
+  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} ref={nativeRef} onLayout={onLayout} />
+    );
   }
 
-  return <EnrichedMarkdownTextNativeComponent {...sharedProps} />;
+  return (
+    <View style={containerStyle} onLayout={onLayout}>
+      <NativeComponent
+        {...sharedProps}
+        ref={nativeRef}
+        style={undefined}
+        emitLinkLayout
+        onLinkLayout={handleLinkLayout}
+        onLayout={handleNativeLayout}
+      />
+      {linkLayout.map((info) => {
+        const decoration = renderLinkDecoration(info);
+        if (decoration == null) return null;
+        return (
+          <View
+            key={info.index}
+            pointerEvents="box-none"
+            style={[
+              styles.decoration,
+              {
+                left: nativeOffset.x + info.rect.x,
+                top: nativeOffset.y + info.rect.y,
+                width: info.rect.width,
+                height: info.rect.height,
+              },
+            ]}
+          >
+            {decoration}
+          </View>
+        );
+      })}
+    </View>
+  );
 };
 
+const styles = StyleSheet.create({
+  decoration: { position: 'absolute' },
+});
+
 export default EnrichedMarkdownText;

package/src/normalizeMarkdownStyle.ts

@@ -183,6 +183,11 @@ const DEFAULT_NORMALIZED_STYLE = Object.freeze({
     color: normalizeColor('#2563EB')!,
     underline: true,
     backgroundColor: normalizeColor('transparent')!,
+    borderRadius: 0,
+    paddingHorizontal: 0,
+    paddingVertical: 0,
+    borderColor: normalizeColor('transparent')!,
+    borderWidth: 0,
   },
   linkVariants: [],
   strong: { fontFamily: '', fontWeight: 'bold', color: undefined },
@@ -248,11 +253,13 @@ const DEFAULT_NORMALIZED_STYLE = Object.freeze({
     marginBottom: 16,
     textAlign: 'center' as BlockTextAlign,
     fontWeight: 'normal',
+    glyphOverflow: 0,
   },
   inlineMath: {
     color: defaultTextColor,
     paddingVertical: 4,
     fontWeight: 'normal',
+    glyphOverflow: 0,
   },
   taskList: {
     checkedColor: Platform.select({
@@ -338,9 +345,17 @@ export const normalizeMarkdownStyle = (
         color: ((override.color ? normalizeColor(override.color) : null) ??
           linkBase.color) as string,
         underline: override.underline ?? linkBase.underline,
+        // Chip ("box") properties never inherit from the base link style.
         backgroundColor: (override.backgroundColor
           ? (normalizeColor(override.backgroundColor) ?? transparent)
           : transparent) as string,
+        borderRadius: override.borderRadius ?? 0,
+        paddingHorizontal: override.paddingHorizontal ?? 0,
+        paddingVertical: override.paddingVertical ?? 0,
+        borderColor: (override.borderColor
+          ? (normalizeColor(override.borderColor) ?? transparent)
+          : transparent) as string,
+        borderWidth: override.borderWidth ?? 0,
       };
     }
   );

package/src/normalizeMarkdownStyle.web.ts

@@ -147,6 +147,11 @@ const DEFAULT_NORMALIZED_STYLE: MarkdownStyleInternal = Object.freeze({
     color: '#2563EB',
     underline: true,
     backgroundColor: 'transparent',
+    borderRadius: 0,
+    paddingHorizontal: 0,
+    paddingVertical: 0,
+    borderColor: 'transparent',
+    borderWidth: 0,
   },
   linkVariants: [],
   strong: { fontFamily: '', fontWeight: 'bold', color: undefined },
@@ -210,11 +215,13 @@ const DEFAULT_NORMALIZED_STYLE: MarkdownStyleInternal = Object.freeze({
     marginBottom: 16,
     textAlign: 'center' as BlockTextAlign,
     fontWeight: 'normal',
+    glyphOverflow: 0,
   },
   inlineMath: {
     color: defaultTextColor,
     paddingVertical: 4,
     fontWeight: 'normal',
+    glyphOverflow: 0,
   },
   taskList: {
     checkedColor: '#007AFF',
@@ -289,7 +296,13 @@ export const normalizeMarkdownStyle = (
         pattern,
         color: override.color ?? linkBase.color,
         underline: override.underline ?? linkBase.underline,
+        // Chip ("box") properties never inherit from the base link style.
         backgroundColor: override.backgroundColor ?? 'transparent',
+        borderRadius: override.borderRadius ?? 0,
+        paddingHorizontal: override.paddingHorizontal ?? 0,
+        paddingVertical: override.paddingVertical ?? 0,
+        borderColor: override.borderColor ?? 'transparent',
+        borderWidth: override.borderWidth ?? 0,
       };
     }
   );

package/src/types/MarkdownStyle.ts

@@ -84,17 +84,39 @@ interface CodeBlockStyle extends BaseBlockStyle {
   syntaxColors?: CodeBlockSyntaxColors;
 }
 
-export interface LinkStyle {
+/**
+ * Chip ("box") properties shared by `link` and `linkVariants`. Unlike `color`
+ * and `underline`, these never inherit from the base `link` style: a variant
+ * that omits them renders without a chip (`0` / `transparent`).
+ */
+interface LinkChipStyle {
+  backgroundColor?: string;
+  /** Corner radius of the chip, in dp. */
+  borderRadius?: number;
+  /**
+   * Horizontal padding, in dp. Reserves real space in the line on both outer
+   * edges of the link (affects measurement and wrapping).
+   */
+  paddingHorizontal?: number;
+  /**
+   * Vertical padding, in dp. Only affects the drawn chip (it bleeds into the
+   * surrounding line spacing); the line box is unchanged.
+   */
+  paddingVertical?: number;
+  borderColor?: string;
+  /** Border width, in dp. Drawn inset, within the chip bounds. */
+  borderWidth?: number;
+}
+
+export interface LinkStyle extends LinkChipStyle {
   fontFamily?: string;
   color?: string;
   underline?: boolean;
-  backgroundColor?: string;
 }
 
-export interface LinkVariantStyle {
+export interface LinkVariantStyle extends LinkChipStyle {
   color?: string;
   underline?: boolean;
-  backgroundColor?: string;
 }
 
 interface StrongStyle {
@@ -234,6 +256,17 @@ interface MathStyle {
    * @default 'normal'
    */
   fontWeight?: 'bold' | 'normal';
+  /**
+   * Headroom kept above and below the rendered formula, in points (dp on
+   * Android), inside the box the formula reports. The math engine sizes a
+   * formula by its TeX metric box, and digit and capital outlines — plus the
+   * synthetic-bold stroke — rise a little past it; without this headroom that
+   * ink is clipped at the top of the box. About `0.06 × fontSize` covers the
+   * KaTeX faces; add `0.02 × fontSize` when `fontWeight` is `'bold'`.
+   * Android rounds it up to whole pixels.
+   * @default 0
+   */
+  glyphOverflow?: number;
 }
 
 interface InlineMathStyle {
@@ -258,6 +291,17 @@ interface InlineMathStyle {
    * @default 'normal'
    */
   fontWeight?: 'bold' | 'normal';
+  /**
+   * Headroom kept above and below the rendered formula, in points (dp on
+   * Android), inside the box the formula reports. The math engine sizes a
+   * formula by its TeX metric box, and digit and capital outlines — plus the
+   * synthetic-bold stroke — rise a little past it; without this headroom that
+   * ink is clipped at the top of the box. About `0.06 × fontSize` covers the
+   * KaTeX faces; add `0.02 × fontSize` when `fontWeight` is `'bold'`.
+   * Android rounds it up to whole pixels.
+   * @default 0
+   */
+  glyphOverflow?: number;
 }
 
 interface SpoilerParticlesStyle {
@@ -350,7 +394,9 @@ export interface MarkdownStyle {
    * specific patterns take precedence.
    *
    * `color` and `underline` inherit from the base `link` style when omitted.
-   * `backgroundColor` defaults to `transparent`.
+   * Chip properties (`backgroundColor`, `borderRadius`, `paddingHorizontal`,
+   * `paddingVertical`, `borderColor`, `borderWidth`) do not inherit: when
+   * omitted they default to `0` / `transparent`.
    * `fontFamily` always follows the base `link` style and cannot be overridden per-variant.
    *
    * @example

package/src/types/MarkdownStyleInternal.ts

@@ -88,6 +88,11 @@ interface LinkStyleInternal {
   color: string;
   underline: boolean;
   backgroundColor: string;
+  borderRadius: number;
+  paddingHorizontal: number;
+  paddingVertical: number;
+  borderColor: string;
+  borderWidth: number;
 }
 
 export interface LinkVariantEntryInternal {
@@ -95,6 +100,11 @@ export interface LinkVariantEntryInternal {
   color: string;
   underline: boolean;
   backgroundColor: string;
+  borderRadius: number;
+  paddingHorizontal: number;
+  paddingVertical: number;
+  borderColor: string;
+  borderWidth: number;
 }
 
 interface StrongStyleInternal {
@@ -180,12 +190,14 @@ interface MathStyleInternal {
   marginBottom: number;
   textAlign: BlockTextAlign;
   fontWeight: string;
+  glyphOverflow: number;
 }
 
 interface InlineMathStyleInternal {
   color: string;
   paddingVertical: number;
   fontWeight: string;
+  glyphOverflow: number;
 }
 
 interface SpoilerParticlesStyleInternal {