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

package/src/native/EnrichedMarkdownText.tsx

@@ -1,6 +1,9 @@
-import { useMemo, useCallback, useRef, useEffect } from 'react';
+import { useMemo, useCallback, useRef, useEffect, useState } from 'react';
 import EnrichedMarkdownTextNativeComponent from '../EnrichedMarkdownTextNativeComponent';
-import type { MarkdownStyleInternal } from '../EnrichedMarkdownTextNativeComponent';
+import type {
+  LinkLayoutEvent,
+  MarkdownStyleInternal,
+} from '../EnrichedMarkdownTextNativeComponent';
 import EnrichedMarkdownNativeComponent from '../EnrichedMarkdownNativeComponent';
 import { normalizeMarkdownStyle } from '../normalizeMarkdownStyle';
 import { resolveAccessibilityLabels } from '../accessibilityLabelDefaults';
@@ -8,7 +11,8 @@ import {
   normalizeMenuItem,
   normalizeLegacyBooleanMenuItem,
 } from '../normalizeMenuItem';
-import type { NativeSyntheticEvent } from 'react-native';
+import { StyleSheet, View } from 'react-native';
+import type { LayoutChangeEvent, NativeSyntheticEvent } from 'react-native';
 import type { MarkdownStyle, Md4cFlags } from '../types/MarkdownStyle';
 import type {
   EnrichedMarkdownTextProps,
@@ -16,6 +20,8 @@ import type {
   ContextMenuItem,
   SelectionMenuConfig,
   SelectionMenuPluralLabels,
+  LinkDecorationInfo,
+  LinkRect,
 } from '../types/MarkdownTextProps';
 import type {
   LinkPressEvent,
@@ -33,6 +39,8 @@ export type {
   ContextMenuItem,
   SelectionMenuConfig,
   SelectionMenuPluralLabels,
+  LinkDecorationInfo,
+  LinkRect,
 };
 export type {
   LinkPressEvent,
@@ -103,6 +111,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,
@@ -142,6 +178,8 @@ export const EnrichedMarkdownText = ({
   textBreakStrategy,
   lineBreakStrategyIOS,
   writingDirection = 'first-strong',
+  renderLinkDecoration,
+  onLayout,
   ...rest
 }: EnrichedMarkdownTextProps) => {
   const normalizedStyleRef = useRef<MarkdownStyleInternal | null>(null);
@@ -260,6 +298,23 @@ export const EnrichedMarkdownText = ({
   );
   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 }));
+  }, []);
+
   const tableMode = streamingConfig?.tableMode ?? 'progressive';
   const codeBlockMode = streamingConfig?.codeBlockMode ?? 'progressive';
   const normalizedStreamingConfig = useMemo(
@@ -365,11 +420,53 @@ export const EnrichedMarkdownText = ({
     ...rest,
   };
 
-  if (flavor === 'github') {
-    return <EnrichedMarkdownNativeComponent {...sharedProps} />;
+  const NativeComponent =
+    flavor === 'github'
+      ? 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 <EnrichedMarkdownTextNativeComponent {...sharedProps} />;
+  return (
+    <View style={containerStyle} onLayout={onLayout}>
+      <NativeComponent
+        {...sharedProps}
+        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 },
@@ -338,9 +343,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 },
@@ -289,7 +294,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 {
@@ -350,7 +372,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 {

package/src/types/MarkdownTextProps.ts

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 import type { ColorValue, ViewProps, ViewStyle, TextStyle } from 'react-native';
 import type { MarkdownStyle, Md4cFlags } from './MarkdownStyle';
 import type { AccessibilityLabels } from './AccessibilityLabels';
@@ -9,6 +10,33 @@ import type {
   CopyEvent,
 } from './events';
 
+/**
+ * A rect in dp, relative to the component's content box (inside any
+ * `containerStyle` padding).
+ */
+export interface LinkRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+/** Layout of one rendered link, passed to `renderLinkDecoration`. */
+export interface LinkDecorationInfo {
+  /** Position of the link in the document (0-based) — stable key for a link. */
+  index: number;
+  url: string;
+  /** The link's visible text. */
+  text: string;
+  /**
+   * Anchor rect. Native: the drawn chip (glyphs + padding) of the link's last
+   * line fragment. Web: the link's inline box.
+   */
+  rect: LinkRect;
+  /** Every line fragment of the link (several when it wraps). Web: `[rect]`. */
+  rects: LinkRect[];
+}
+
 /**
  * Public context menu item. Each item includes a JS-side `onPress` callback
  * that is called when the user taps the item in the selection context menu.
@@ -178,6 +206,21 @@ export interface EnrichedMarkdownTextProps extends Omit<ViewProps, 'style'> {
    * @platform ios, android, web
    */
   onLinkLongPress?: (event: LinkLongPressEvent) => void;
+  /**
+   * Renders a decoration (e.g. a badge or icon) over each link. The returned
+   * node is placed in an absolutely positioned box matching `info.rect` (the
+   * link's last line fragment, including chip padding) with
+   * `pointerEvents="box-none"`; position content relative to it (negative
+   * offsets overflow the box). Return `null` to leave a link undecorated.
+   *
+   * Native caveats: rects arrive from native after layout, so decorations
+   * appear one frame after the text; links inside tables (`flavor="github"`)
+   * are not reported; content overflowing the component bounds does not
+   * receive touches on Android. Toggling this prop between set and unset
+   * remounts the native view.
+   * @platform ios, android, web
+   */
+  renderLinkDecoration?: (info: LinkDecorationInfo) => ReactNode | null;
   /**
    * Callback fired when a task list checkbox is tapped.
    *

package/src/types/MarkdownTextProps.web.ts

@@ -1,4 +1,4 @@
-import type { CSSProperties, HTMLAttributes } from 'react';
+import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
 import type { MarkdownStyle, Md4cFlags } from './MarkdownStyle';
 import type {
   LinkPressEvent,
@@ -6,6 +6,33 @@ import type {
   TaskListItemPressEvent,
 } from './events';
 
+/**
+ * A rect in dp, relative to the component's content box (inside any
+ * `containerStyle` padding).
+ */
+export interface LinkRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+/** Layout of one rendered link, passed to `renderLinkDecoration`. */
+export interface LinkDecorationInfo {
+  /** Position of the link in the document (0-based) — stable key for a link. */
+  index: number;
+  url: string;
+  /** The link's visible text. */
+  text: string;
+  /**
+   * Anchor rect. Native: the drawn chip (glyphs + padding) of the link's last
+   * line fragment. Web: the link's inline box.
+   */
+  rect: LinkRect;
+  /** Every line fragment of the link (several when it wraps). Web: `[rect]`. */
+  rects: LinkRect[];
+}
+
 export interface EnrichedMarkdownTextProps extends Omit<
   HTMLAttributes<HTMLDivElement>,
   'style' | 'dir'
@@ -47,6 +74,21 @@ export interface EnrichedMarkdownTextProps extends Omit<
    * @platform ios, android, web
    */
   onLinkLongPress?: (event: LinkLongPressEvent) => void;
+  /**
+   * Renders a decoration (e.g. a badge or icon) over each link. The returned
+   * node is placed in an absolutely positioned box matching `info.rect` (the
+   * link's last line fragment, including chip padding) with
+   * `pointerEvents="box-none"`; position content relative to it (negative
+   * offsets overflow the box). Return `null` to leave a link undecorated.
+   *
+   * Native caveats: rects arrive from native after layout, so decorations
+   * appear one frame after the text; links inside tables (`flavor="github"`)
+   * are not reported; content overflowing the component bounds does not
+   * receive touches on Android. Toggling this prop between set and unset
+   * remounts the native view.
+   * @platform ios, android, web
+   */
+  renderLinkDecoration?: (info: LinkDecorationInfo) => ReactNode | null;
   /**
    * Callback fired when a task list checkbox is tapped.
    *

package/src/web/EnrichedMarkdownText.tsx

@@ -9,7 +9,7 @@ import {
 import { parseMarkdown } from './parseMarkdown';
 import { RenderNode } from './renderers';
 import type { ASTNode, RendererCallbacks, RenderCapabilities } from './types';
-import { indexTaskItems, markInlineImages } from './utils';
+import { indexLinks, indexTaskItems, markInlineImages } from './utils';
 import { loadKaTeX } from './katex';
 import type { KaTeXInstance } from './katex';
 import { ENRM_TEXT_CLASS, ENRM_SELECTION_BG_VAR } from './globalStyles';
@@ -27,6 +27,7 @@ export const EnrichedMarkdownText = ({
   selectable = true,
   dir,
   selectionColor,
+  renderLinkDecoration,
   ...rest
 }: EnrichedMarkdownTextProps) => {
   const normalizedStyle = useMemo(
@@ -66,6 +67,7 @@ export const EnrichedMarkdownText = ({
       .then(([result, katexInstance]) => {
         if (!cancelled) {
           indexTaskItems(result);
+          indexLinks(result);
           markInlineImages(result);
 
           setParseError(false);
@@ -99,8 +101,13 @@ export const EnrichedMarkdownText = ({
   ]);
 
   const callbacks = useMemo<RendererCallbacks>(
-    () => ({ onLinkPress, onLinkLongPress, onTaskListItemPress }),
-    [onLinkPress, onLinkLongPress, onTaskListItemPress]
+    () => ({
+      onLinkPress,
+      onLinkLongPress,
+      onTaskListItemPress,
+      renderLinkDecoration,
+    }),
+    [onLinkPress, onLinkLongPress, onTaskListItemPress, renderLinkDecoration]
   );
 
   const capabilities = useMemo<RenderCapabilities>(

package/src/web/renderers/InlineRenderers.tsx

@@ -1,8 +1,16 @@
-import type { MouseEvent } from 'react';
+import {
+  useLayoutEffect,
+  useRef,
+  useState,
+  type MouseEvent,
+  type ReactNode,
+} from 'react';
+import type { LinkRect } from '../../types/MarkdownTextProps.web';
 import type { RendererProps, RendererMap } from '../types';
 import { extractNodeText } from '../utils';
 import { KaTeXRenderer } from './KaTeXRenderer';
 import { linkStyleForUrl } from '../styles';
+import type { CSSProperties } from 'react';
 
 function TextRenderer({ node }: RendererProps) {
   return <>{node.content ?? ''}</>;
@@ -78,16 +86,116 @@ function LinkRenderer({
     }
   };
 
+  const linkStyle = linkStyleForUrl(style, url);
+  const children = renderChildren(node);
+
+  if (callbacks.renderLinkDecoration) {
+    return (
+      <DecoratedLink
+        url={url}
+        index={node.attributes?.linkIndex ?? 0}
+        text={extractNodeText(node)}
+        linkStyle={linkStyle}
+        renderLinkDecoration={callbacks.renderLinkDecoration}
+        onClick={handleClick}
+        onContextMenu={handleContextMenu}
+      >
+        {children}
+      </DecoratedLink>
+    );
+  }
+
   return (
     <a
       href={url}
-      style={linkStyleForUrl(style, url)}
+      style={linkStyle}
       target="_blank"
       rel="noopener noreferrer"
       onClick={handleClick}
       onContextMenu={handleContextMenu}
     >
-      {renderChildren(node)}
+      {children}
+    </a>
+  );
+}
+
+const EMPTY_RECT: LinkRect = { x: 0, y: 0, width: 0, height: 0 };
+
+const decorationLayerStyle: CSSProperties = {
+  position: 'absolute',
+  inset: 0,
+  pointerEvents: 'none',
+};
+
+const decorationContentStyle: CSSProperties = { pointerEvents: 'auto' };
+
+/**
+ * A link with a `renderLinkDecoration` overlay. Unlike native, the overlay
+ * anchors to the link's whole inline box (not the last line fragment of a
+ * wrapping link), and `rect` is that box relative to itself.
+ */
+function DecoratedLink({
+  url,
+  index,
+  text,
+  linkStyle,
+  renderLinkDecoration,
+  onClick,
+  onContextMenu,
+  children,
+}: {
+  url: string;
+  index: number;
+  text: string;
+  linkStyle: ReturnType<typeof linkStyleForUrl>;
+  renderLinkDecoration: NonNullable<
+    RendererProps['callbacks']['renderLinkDecoration']
+  >;
+  onClick: (event: MouseEvent) => void;
+  onContextMenu: (event: MouseEvent) => void;
+  children: ReactNode;
+}) {
+  const anchorRef = useRef<HTMLAnchorElement>(null);
+  const [rect, setRect] = useState<LinkRect>(EMPTY_RECT);
+
+  // The overlay itself is sized by CSS (inset: 0); `rect` is informational, so
+  // re-measuring when the content or chip style changes is enough.
+  useLayoutEffect(() => {
+    const anchor = anchorRef.current;
+    if (!anchor) return;
+    const { width, height } = anchor.getBoundingClientRect();
+    setRect((prev) =>
+      prev.width === width && prev.height === height
+        ? prev
+        : { x: 0, y: 0, width, height }
+    );
+  }, [text, linkStyle]);
+
+  const decoration = renderLinkDecoration({
+    index,
+    url,
+    text,
+    rect,
+    rects: [rect],
+  });
+
+  return (
+    <a
+      ref={anchorRef}
+      href={url}
+      style={{ ...linkStyle, position: 'relative' }} // eslint-disable-line react-native/no-inline-styles
+      target="_blank"
+      rel="noopener noreferrer"
+      onClick={onClick}
+      onContextMenu={onContextMenu}
+    >
+      {children}
+      {decoration != null && (
+        <span aria-hidden style={decorationLayerStyle}>
+          {/* Mirrors native pointerEvents="box-none": only the decoration itself is hit-testable. */}
+          <span style={decorationContentStyle}>{decoration}</span>
+        </span>
+      )}
     </a>
   );
 }

package/src/web/styles.ts

@@ -323,6 +323,12 @@ export function linkStyleForUrl(
     variantIndex !== -1 ? style.linkVariants[variantIndex]! : base;
 
   const backgroundColor = resolved.backgroundColor;
+  const hasBorder =
+    resolved.borderWidth > 0 &&
+    !!resolved.borderColor &&
+    resolved.borderColor !== 'transparent';
+  const hasPadding =
+    resolved.paddingHorizontal > 0 || resolved.paddingVertical > 0;
   return {
     color: resolved.color,
     fontFamily: normalizeFontFamily(base.fontFamily),
@@ -330,6 +336,25 @@ export function linkStyleForUrl(
     ...(backgroundColor && backgroundColor !== 'transparent'
       ? { backgroundColor }
       : undefined),
+    // Chip: inline padding reserves horizontal space like native; vertical
+    // padding only paints (inline boxes don't grow the line box). `clone`
+    // rounds and pads each fragment of a wrapping link.
+    ...(hasPadding
+      ? {
+          padding: `${resolved.paddingVertical}px ${resolved.paddingHorizontal}px`,
+        }
+      : undefined),
+    ...(resolved.borderRadius > 0
+      ? { borderRadius: resolved.borderRadius }
+      : undefined),
+    ...(hasBorder
+      ? {
+          border: `${resolved.borderWidth}px solid ${resolved.borderColor}`,
+        }
+      : undefined),
+    ...(hasPadding || hasBorder || resolved.borderRadius > 0
+      ? { boxDecorationBreak: 'clone', WebkitBoxDecorationBreak: 'clone' }
+      : undefined),
   };
 }
 

package/src/web/types.ts

@@ -6,6 +6,7 @@ import type {
   LinkLongPressEvent,
   TaskListItemPressEvent,
 } from '../types/events';
+import type { LinkDecorationInfo } from '../types/MarkdownTextProps.web';
 import type { KaTeXInstance } from './katex';
 
 export type NodeType =
@@ -52,6 +53,8 @@ export interface NodeAttributes {
   taskIndex?: number;
   /** Stamped by markInlineImages() — not present in the raw WASM output. */
   isInline?: boolean;
+  /** Stamped by indexLinks() — document-order link index, not in the raw WASM output. */
+  linkIndex?: number;
   colCount?: string;
   headRowCount?: string;
   bodyRowCount?: string;
@@ -72,6 +75,7 @@ export interface RendererCallbacks {
   onLinkPress?: (event: LinkPressEvent) => void;
   onLinkLongPress?: (event: LinkLongPressEvent) => void;
   onTaskListItemPress?: (event: TaskListItemPressEvent) => void;
+  renderLinkDecoration?: (info: LinkDecorationInfo) => ReactNode | null;
 }
 
 export interface RenderCapabilities {

package/src/web/utils.ts

@@ -30,6 +30,14 @@ export function indexTaskItems(node: ASTNode, counter = { value: 0 }): void {
   node.children?.forEach((child) => indexTaskItems(child, counter));
 }
 
+/** Stamps Link nodes with their document-order index (the `renderLinkDecoration` key). */
+export function indexLinks(node: ASTNode, counter = { value: 0 }): void {
+  if (node.type === 'Link') {
+    node.attributes = { ...node.attributes, linkIndex: counter.value++ };
+  }
+  node.children?.forEach((child) => indexLinks(child, counter));
+}
+
 /**
  * Stamps Image nodes with `isInline` when they appear inside a paragraph
  * that also contains other content (text, links, etc.).