react-native-enriched-markdown-scaffold 0.6.0-scaffold.6 → 0.7.4-scaffold.1

package/plugin/build/withReactNativeEnrichedMarkdown.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const withIosMath_1 = require("./withIosMath");
+const withAndroidMath_1 = require("./withAndroidMath");
+const withEnrichedMarkdown = (config, props) => {
+    const enableMath = props?.enableMath !== false;
+    config = (0, withAndroidMath_1.withAndroidMath)(config, { enableMath });
+    config = (0, withIosMath_1.withIosMath)(config, { enableMath });
+    return config;
+};
+exports.default = withEnrichedMarkdown;

package/plugin/tsconfig.build.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "ignoreDeprecations": "6.0",
+    "target": "ES2020",
+    "outDir": "./build",
+    "rootDir": "./src",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": false,
+    "types": ["node"]
+  },
+  "include": ["./src/**/*.ts"]
+}

package/src/EnrichedMarkdownNativeComponent.ts

@@ -141,12 +141,10 @@ interface MathStyleInternal {
   marginTop: CodegenTypes.Float;
   marginBottom: CodegenTypes.Float;
   textAlign: string;
-  fontWeight: string;
 }
 
 interface InlineMathStyleInternal {
   color: ColorValue;
-  fontWeight: string;
 }
 
 interface SpoilerParticlesStyleInternal {
@@ -232,6 +230,13 @@ export interface ContextMenuItemConfig {
 export interface SelectionMenuConfig {
   copyAsMarkdown: boolean;
   copyImageUrl: boolean;
+  copyLabel: string;
+  copyAsMarkdownLabel: string;
+  copyImageUrlLabel: string;
+  copyImageUrlsLabel: string;
+  // Precomputed plural templates indexed by image count (0..100). Empty when no
+  // pluralLabels are set; native then uses copyImageUrlLabel/copyImageUrlsLabel.
+  copyImageUrlPluralTemplates: ReadonlyArray<string>;
 }
 
 export interface OnContextMenuItemPressEvent {
@@ -241,6 +246,35 @@ export interface OnContextMenuItemPressEvent {
   selectionEnd: CodegenTypes.Int32;
 }
 
+export interface AccessibilityLabelsListProps {
+  bulletPoint: string;
+  nestedBulletPoint: string;
+  orderedItem: string;
+  nestedOrderedItem: string;
+}
+export interface AccessibilityLabelsBlockquoteProps {
+  quote: string;
+  nestedQuote: string;
+}
+export interface AccessibilityLabelsTableProps {
+  row: string;
+}
+export interface AccessibilityLabelsMathProps {
+  equation: string;
+}
+export interface AccessibilityLabelsRotorProps {
+  headings: string;
+  links: string;
+  images: string;
+}
+export interface AccessibilityLabelsProps {
+  list: Readonly<AccessibilityLabelsListProps>;
+  blockquote: Readonly<AccessibilityLabelsBlockquoteProps>;
+  table: Readonly<AccessibilityLabelsTableProps>;
+  math: Readonly<AccessibilityLabelsMathProps>;
+  rotor: Readonly<AccessibilityLabelsRotorProps>;
+}
+
 /**
  * MD4C parser flags configuration.
  * Controls how the markdown parser interprets certain syntax.
@@ -396,6 +430,7 @@ export interface NativeProps extends ViewProps {
    * Built-in items to show in the text selection context menu.
    */
   selectionMenuConfig: Readonly<SelectionMenuConfig>;
+  accessibilityLabels: Readonly<AccessibilityLabelsProps>;
   /**
    * Fired when a custom context menu item is pressed.
    * Receives the item label, the currently selected text, and the selection range.

package/src/EnrichedMarkdownTextInput.tsx

@@ -38,6 +38,7 @@ import type {
   ColorValue,
 } from 'react-native';
 import { normalizeMarkdownTextInputStyle } from './normalizeMarkdownTextInputStyle';
+import { normalizeMenuItem } from './normalizeMenuItem';
 import { toNativeRegexConfig } from './utils/regexParser';
 import type { RefObject } from 'react';
 
@@ -60,18 +61,6 @@ export interface MathStyle {
   paddingVertical?: number;
   selectedBackgroundColor?: string;
   selectedBorderColor?: string;
-  /**
-   * Renders math glyphs with KaTeX's bold variant (KaTeX_Main-Bold /
-   * KaTeX_Math-BoldItalic). Wraps the LaTeX in `\mathbf{…}` at render time
-   * only — chip storage and serialized markdown stay untouched.
-   *
-   * Caveat: large operators (`\sum`, `\int`, `\prod`), AMS symbols, Script
-   * and Typewriter glyphs have no bold variant in KaTeX and stay at regular
-   * weight even when `fontWeight: 'bold'`.
-   *
-   * @default 'normal'
-   */
-  fontWeight?: 'normal' | 'bold';
 }
 
 export interface MathBlockStyle extends MathStyle {
@@ -161,10 +150,48 @@ export interface EnrichedMarkdownTextInputInstance {
     options?: InsertMathOptions
   ) => void;
   removeMath: (start: number) => void;
+  copyToClipboard: () => void;
   getMarkdown: () => Promise<string>;
   getCaretRect: () => Promise<CaretRect>;
 }
 
+/**
+ * Per-item shape: `{ enabled }` toggles visibility, `label` overrides the
+ * English default. Wire `label` to your i18n library to localize the menu.
+ */
+type MenuItem = { enabled?: boolean; label?: string };
+
+export interface InputSelectionMenuConfig {
+  /**
+   * The built-in "Format" submenu (Bold, Italic, Underline, etc.) in the
+   * text selection context menu. `label` overrides the submenu title.
+   * @default { enabled: true, label: "Format" }
+   */
+  format?: MenuItem;
+  /**
+   * The built-in "Copy as Markdown" action in the text selection context
+   * menu. `label` overrides the action title.
+   * @default { enabled: true, label: "Copy as Markdown" }
+   */
+  copyAsMarkdown?: MenuItem;
+}
+
+/** Controls the individual items inside the Format submenu. */
+export interface FormatMenuConfig {
+  /** @default { enabled: true, label: "Bold" } */
+  bold?: MenuItem;
+  /** @default { enabled: true, label: "Italic" } */
+  italic?: MenuItem;
+  /** @default { enabled: true, label: "Underline" } */
+  underline?: MenuItem;
+  /** @default { enabled: true, label: "Strikethrough" } */
+  strikethrough?: MenuItem;
+  /** @default { enabled: true, label: "Spoiler" } */
+  spoiler?: MenuItem;
+  /** @default { enabled: true, label: "Link" } */
+  link?: MenuItem;
+}
+
 export interface EnrichedMarkdownTextInputProps extends Omit<
   ViewProps,
   'style' | 'children'
@@ -196,6 +223,22 @@ export interface EnrichedMarkdownTextInputProps extends Omit<
   onFocus?: () => void;
   onBlur?: () => void;
   contextMenuItems?: ContextMenuItem[];
+  /**
+   * Controls built-in items in the text selection context menu.
+   * Omitting the prop or any field reproduces today's exact menu.
+   * Custom app-provided actions are controlled separately via `contextMenuItems`.
+   * @default { format: true, copyAsMarkdown: true }
+   * @platform ios, android, macos
+   */
+  selectionMenuConfig?: InputSelectionMenuConfig;
+  /**
+   * Controls which items appear inside the Format submenu.
+   * Only effective when `selectionMenuConfig.format` is `true` (the default).
+   * Omitting the prop or any field shows all items.
+   * @default { bold: true, italic: true, underline: true, strikethrough: true, spoiler: true, link: true }
+   * @platform ios, android, macos
+   */
+  formatMenuConfig?: FormatMenuConfig;
   linkRegex?: RegExp | null;
   /**
    * Paragraph writing direction.
@@ -258,11 +301,15 @@ export const EnrichedMarkdownTextInput = ({
   onFocus,
   onBlur,
   contextMenuItems,
+  selectionMenuConfig,
+  formatMenuConfig,
   linkRegex: _linkRegex,
   writingDirection = 'first-strong',
   ...rest
 }: EnrichedMarkdownTextInputProps) => {
   const nativeRef = useRef<NativeRef | null>(null);
+  // Freeze `defaultValue` at mount (RN TextInput semantics): post-mount changes are ignored.
+  const initialDefaultValue = useRef(defaultValue).current;
 
   const nextRequestId = useRef(1);
   const pendingRequests = useRef(new Map<number, PendingRequest<string>>());
@@ -306,6 +353,60 @@ export const EnrichedMarkdownTextInput = ({
 
   const normalizedStyle = normalizeMarkdownTextInputStyle(markdownStyle);
 
+  const normalizedSelectionMenuConfig = useMemo(() => {
+    const format = normalizeMenuItem(
+      selectionMenuConfig?.format,
+      true,
+      'Format'
+    );
+    const copyAsMarkdown = normalizeMenuItem(
+      selectionMenuConfig?.copyAsMarkdown,
+      true,
+      'Copy as Markdown'
+    );
+    return {
+      format: format.enabled,
+      formatLabel: format.label,
+      copyAsMarkdown: copyAsMarkdown.enabled,
+      copyAsMarkdownLabel: copyAsMarkdown.label,
+    };
+  }, [selectionMenuConfig]);
+
+  const normalizedFormatMenuConfig = useMemo(() => {
+    const bold = normalizeMenuItem(formatMenuConfig?.bold, true, 'Bold');
+    const italic = normalizeMenuItem(formatMenuConfig?.italic, true, 'Italic');
+    const underline = normalizeMenuItem(
+      formatMenuConfig?.underline,
+      true,
+      'Underline'
+    );
+    const strikethrough = normalizeMenuItem(
+      formatMenuConfig?.strikethrough,
+      true,
+      'Strikethrough'
+    );
+    const spoiler = normalizeMenuItem(
+      formatMenuConfig?.spoiler,
+      true,
+      'Spoiler'
+    );
+    const link = normalizeMenuItem(formatMenuConfig?.link, true, 'Link');
+    return {
+      bold: bold.enabled,
+      boldLabel: bold.label,
+      italic: italic.enabled,
+      italicLabel: italic.label,
+      underline: underline.enabled,
+      underlineLabel: underline.label,
+      strikethrough: strikethrough.enabled,
+      strikethroughLabel: strikethrough.label,
+      spoiler: spoiler.enabled,
+      spoilerLabel: spoiler.label,
+      link: link.enabled,
+      linkLabel: link.label,
+    };
+  }, [formatMenuConfig]);
+
   const linkRegex = useMemo(
     () => toNativeRegexConfig(_linkRegex),
     [_linkRegex]
@@ -488,6 +589,7 @@ export const EnrichedMarkdownTextInput = ({
           options?.display ?? false
         ),
       removeMath: (start) => Commands.removeMath(commandRef, start),
+      copyToClipboard: () => Commands.copyToClipboard(commandRef),
       getMarkdown: () =>
         new Promise<string>((resolve, reject) => {
           const requestId = nextRequestId.current++;
@@ -511,7 +613,7 @@ export const EnrichedMarkdownTextInput = ({
       ref={nativeRef}
       style={style}
       markdownStyle={normalizedStyle}
-      defaultValue={defaultValue}
+      defaultValue={initialDefaultValue}
       placeholder={placeholder}
       placeholderTextColor={placeholderTextColor}
       editable={editable}
@@ -542,6 +644,8 @@ export const EnrichedMarkdownTextInput = ({
         handleCaretRectChange as NativeProps['onCaretRectChange']
       }
       contextMenuItems={nativeContextMenuItems}
+      selectionMenuConfig={normalizedSelectionMenuConfig}
+      formatMenuConfig={normalizedFormatMenuConfig}
       mentionIndicators={mentionIndicators}
       onContextMenuItemPress={
         handleContextMenuItemPress as NativeProps['onContextMenuItemPress']

package/src/EnrichedMarkdownTextInputNativeComponent.ts

@@ -19,7 +19,6 @@ interface MathStyleInternal {
   paddingVertical: CodegenTypes.Float;
   selectedBackgroundColor: ColorValue;
   selectedBorderColor: ColorValue;
-  fontWeight: string;
 }
 
 interface MathBlockStyleInternal extends MathStyleInternal {
@@ -146,6 +145,28 @@ export interface ContextMenuItemConfig {
   icon?: string;
 }
 
+export interface InputSelectionMenuConfigInternal {
+  format: boolean;
+  formatLabel: string;
+  copyAsMarkdown: boolean;
+  copyAsMarkdownLabel: string;
+}
+
+export interface FormatMenuConfigInternal {
+  bold: boolean;
+  boldLabel: string;
+  italic: boolean;
+  italicLabel: string;
+  underline: boolean;
+  underlineLabel: string;
+  strikethrough: boolean;
+  strikethroughLabel: string;
+  spoiler: boolean;
+  spoilerLabel: string;
+  link: boolean;
+  linkLabel: string;
+}
+
 export interface OnContextMenuItemPressEvent {
   itemText: string;
   selectedText: string;
@@ -231,6 +252,17 @@ export interface NativeProps extends ViewProps {
    */
   contextMenuItems?: ReadonlyArray<Readonly<ContextMenuItemConfig>>;
 
+  /**
+   * Controls built-in items in the text selection context menu.
+   * `format` toggles the Format submenu; `copyAsMarkdown` toggles the Copy as Markdown action.
+   */
+  selectionMenuConfig: Readonly<InputSelectionMenuConfigInternal>;
+
+  /**
+   * Controls which items appear inside the Format submenu.
+   */
+  formatMenuConfig: Readonly<FormatMenuConfigInternal>;
+
   /**
    * Regex configuration for automatic link detection.
    * Omit or pass undefined to use platform defaults.
@@ -323,6 +355,7 @@ interface NativeCommands {
     viewRef: React.ElementRef<ComponentType>,
     start: CodegenTypes.Int32
   ) => void;
+  copyToClipboard: (viewRef: React.ElementRef<ComponentType>) => void;
   requestMarkdown: (
     viewRef: React.ElementRef<ComponentType>,
     requestId: CodegenTypes.Int32
@@ -352,6 +385,7 @@ export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
     'insertMath',
     'updateMath',
     'removeMath',
+    'copyToClipboard',
     'requestMarkdown',
     'requestCaretRect',
   ],

package/src/EnrichedMarkdownTextNativeComponent.ts

@@ -141,12 +141,10 @@ interface MathStyleInternal {
   marginTop: CodegenTypes.Float;
   marginBottom: CodegenTypes.Float;
   textAlign: string;
-  fontWeight: string;
 }
 
 interface InlineMathStyleInternal {
   color: ColorValue;
-  fontWeight: string;
 }
 
 interface SpoilerParticlesStyleInternal {
@@ -232,6 +230,13 @@ export interface ContextMenuItemConfig {
 export interface SelectionMenuConfig {
   copyAsMarkdown: boolean;
   copyImageUrl: boolean;
+  copyLabel: string;
+  copyAsMarkdownLabel: string;
+  copyImageUrlLabel: string;
+  copyImageUrlsLabel: string;
+  // Precomputed plural templates indexed by image count (0..100). Empty when no
+  // pluralLabels are set; native then uses copyImageUrlLabel/copyImageUrlsLabel.
+  copyImageUrlPluralTemplates: ReadonlyArray<string>;
 }
 
 export interface OnContextMenuItemPressEvent {
@@ -241,6 +246,35 @@ export interface OnContextMenuItemPressEvent {
   selectionEnd: CodegenTypes.Int32;
 }
 
+export interface AccessibilityLabelsListProps {
+  bulletPoint: string;
+  nestedBulletPoint: string;
+  orderedItem: string;
+  nestedOrderedItem: string;
+}
+export interface AccessibilityLabelsBlockquoteProps {
+  quote: string;
+  nestedQuote: string;
+}
+export interface AccessibilityLabelsTableProps {
+  row: string;
+}
+export interface AccessibilityLabelsMathProps {
+  equation: string;
+}
+export interface AccessibilityLabelsRotorProps {
+  headings: string;
+  links: string;
+  images: string;
+}
+export interface AccessibilityLabelsProps {
+  list: Readonly<AccessibilityLabelsListProps>;
+  blockquote: Readonly<AccessibilityLabelsBlockquoteProps>;
+  table: Readonly<AccessibilityLabelsTableProps>;
+  math: Readonly<AccessibilityLabelsMathProps>;
+  rotor: Readonly<AccessibilityLabelsRotorProps>;
+}
+
 /**
  * MD4C parser flags configuration.
  * Controls how the markdown parser interprets certain syntax.
@@ -395,6 +429,7 @@ export interface NativeProps extends ViewProps {
    * Built-in items to show in the text selection context menu.
    */
   selectionMenuConfig: Readonly<SelectionMenuConfig>;
+  accessibilityLabels: Readonly<AccessibilityLabelsProps>;
   /**
    * Fired when a custom context menu item is pressed.
    * Receives the item label, the currently selected text, and the selection range.

package/src/accessibilityLabelDefaults.ts

@@ -0,0 +1,83 @@
+import type {
+  AccessibilityLabels,
+  ResolvedAccessibilityLabels,
+} from './types/AccessibilityLabels';
+
+/**
+ * Default strings spoken by VoiceOver / TalkBack when the consumer does not
+ * provide an override. See `AccessibilityLabels` for the placeholder syntax
+ * and the rationale for the no-plural cardinal form.
+ */
+export const DEFAULT_ACCESSIBILITY_LABELS: ResolvedAccessibilityLabels = {
+  list: {
+    bulletPoint: 'Bullet point',
+    nestedBulletPoint: 'Nested bullet point',
+    orderedItem: 'List item {n}',
+    nestedOrderedItem: 'Nested list item {n}',
+  },
+  blockquote: {
+    quote: 'Blockquote',
+    nestedQuote: 'Nested blockquote',
+  },
+  table: {
+    row: 'Row {n}: {content}',
+  },
+  math: {
+    equation: 'Math: {latex}',
+  },
+  rotor: {
+    headings: 'Headings',
+    links: 'Links',
+    images: 'Images',
+  },
+};
+
+/**
+ * Resolves a partial `AccessibilityLabels` against `DEFAULT_ACCESSIBILITY_LABELS`,
+ * returning a fully-populated struct that native code can consume without any
+ * null checks. Override resolution is shallow per sub-group: if a consumer
+ * passes `{ list: { bulletPoint: 'Punkt' } }`, only that one field changes and
+ * the other list entries fall back to the defaults.
+ */
+export function resolveAccessibilityLabels(
+  labels: AccessibilityLabels | undefined
+): ResolvedAccessibilityLabels {
+  return {
+    list: {
+      bulletPoint:
+        labels?.list?.bulletPoint ??
+        DEFAULT_ACCESSIBILITY_LABELS.list.bulletPoint,
+      nestedBulletPoint:
+        labels?.list?.nestedBulletPoint ??
+        DEFAULT_ACCESSIBILITY_LABELS.list.nestedBulletPoint,
+      orderedItem:
+        labels?.list?.orderedItem ??
+        DEFAULT_ACCESSIBILITY_LABELS.list.orderedItem,
+      nestedOrderedItem:
+        labels?.list?.nestedOrderedItem ??
+        DEFAULT_ACCESSIBILITY_LABELS.list.nestedOrderedItem,
+    },
+    blockquote: {
+      quote:
+        labels?.blockquote?.quote ??
+        DEFAULT_ACCESSIBILITY_LABELS.blockquote.quote,
+      nestedQuote:
+        labels?.blockquote?.nestedQuote ??
+        DEFAULT_ACCESSIBILITY_LABELS.blockquote.nestedQuote,
+    },
+    table: {
+      row: labels?.table?.row ?? DEFAULT_ACCESSIBILITY_LABELS.table.row,
+    },
+    math: {
+      equation:
+        labels?.math?.equation ?? DEFAULT_ACCESSIBILITY_LABELS.math.equation,
+    },
+    rotor: {
+      headings:
+        labels?.rotor?.headings ?? DEFAULT_ACCESSIBILITY_LABELS.rotor.headings,
+      links: labels?.rotor?.links ?? DEFAULT_ACCESSIBILITY_LABELS.rotor.links,
+      images:
+        labels?.rotor?.images ?? DEFAULT_ACCESSIBILITY_LABELS.rotor.images,
+    },
+  };
+}

package/src/index.tsx

@@ -6,12 +6,21 @@ export type {
   Md4cFlags,
   ContextMenuItem as TextContextMenuItem,
   SelectionMenuConfig as TextSelectionMenuConfig,
+  SelectionMenuPluralLabels as TextSelectionMenuPluralLabels,
 } from './native/EnrichedMarkdownText';
 export type {
   LinkPressEvent,
   LinkLongPressEvent,
   TaskListItemPressEvent,
 } from './types/events';
+export type {
+  AccessibilityLabels,
+  ResolvedAccessibilityLabels,
+} from './types/AccessibilityLabels';
+export {
+  DEFAULT_ACCESSIBILITY_LABELS,
+  resolveAccessibilityLabels,
+} from './accessibilityLabelDefaults';
 
 export { EnrichedMarkdownTextInput } from './EnrichedMarkdownTextInput';
 export type {
@@ -20,6 +29,8 @@ export type {
   MarkdownTextInputStyle,
   StyleState,
   ContextMenuItem,
+  InputSelectionMenuConfig,
+  FormatMenuConfig,
   OnLinkDetected,
   OnStartMentionEvent,
   OnChangeMentionEvent,