react-native-enriched-markdown-scaffold 0.7.4-scaffold.9 → 1.0.2-scaffold.10

package/lib/typescript/src/web/types.d.ts

@@ -2,8 +2,9 @@ import type { ComponentType, ReactNode } from 'react';
 import type { MarkdownStyleInternal } from '../types/MarkdownStyleInternal';
 import type { Styles } from './styles';
 import type { LinkPressEvent, LinkLongPressEvent, TaskListItemPressEvent } from '../types/events';
+import type { LinkDecorationInfo } from '../types/MarkdownTextProps.web';
 import type { KaTeXInstance } from './katex';
-export type NodeType = 'Document' | 'Paragraph' | 'Text' | 'Link' | 'Heading' | 'LineBreak' | 'Strong' | 'Emphasis' | 'Strikethrough' | 'Underline' | 'Superscript' | 'Subscript' | 'Highlight' | 'Code' | 'Image' | 'Blockquote' | 'UnorderedList' | 'OrderedList' | 'ListItem' | 'CodeBlock' | 'ThematicBreak' | 'Table' | 'TableHead' | 'TableBody' | 'TableRow' | 'TableHeaderCell' | 'TableCell' | 'LatexMathInline' | 'LatexMathDisplay';
+export type NodeType = 'Document' | 'Paragraph' | 'Text' | 'Link' | 'Heading' | 'LineBreak' | 'SoftBreak' | 'Strong' | 'Emphasis' | 'Strikethrough' | 'Underline' | 'Superscript' | 'Subscript' | 'Highlight' | 'Code' | 'Image' | 'Blockquote' | 'UnorderedList' | 'OrderedList' | 'ListItem' | 'CodeBlock' | 'ThematicBreak' | 'Table' | 'TableHead' | 'TableBody' | 'TableRow' | 'TableHeaderCell' | 'TableCell' | 'LatexMathInline' | 'LatexMathDisplay';
 export interface NodeAttributes {
     level?: string;
     url?: string;
@@ -16,6 +17,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;
@@ -27,22 +30,27 @@ export interface ASTNode {
     content?: string;
     /** Present on nodes that carry structural metadata (Heading, Link, etc.). */
     attributes?: NodeAttributes;
-    /** Child nodes; absent on leaf nodes (Text, LineBreak, ThematicBreak). */
+    /** Child nodes; absent on leaf nodes (Text, LineBreak, SoftBreak, ThematicBreak). */
     children?: ASTNode[];
 }
 export interface RendererCallbacks {
     onLinkPress?: (event: LinkPressEvent) => void;
     onLinkLongPress?: (event: LinkLongPressEvent) => void;
     onTaskListItemPress?: (event: TaskListItemPressEvent) => void;
+    renderLinkDecoration?: (info: LinkDecorationInfo) => ReactNode | null;
 }
 export interface RenderCapabilities {
     katex: KaTeXInstance | null;
+    /** When false, task list checkboxes render read-only and ignore clicks. */
+    enableTaskListItemToggle: boolean;
 }
 export interface RendererProps {
     node: ASTNode;
     style: MarkdownStyleInternal;
     styles: Styles;
     parentType?: NodeType;
+    /** Position among the parent node's children. */
+    index?: number;
     callbacks: RendererCallbacks;
     capabilities: RenderCapabilities;
     renderChildren: (node: ASTNode) => ReactNode;

package/lib/typescript/src/web/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,WAAW,GACX,MAAM,GACN,MAAM,GACN,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,GACV,eAAe,GACf,WAAW,GACX,aAAa,GACb,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,GACP,YAAY,GACZ,eAAe,GACf,aAAa,GACb,UAAU,GACV,WAAW,GACX,eAAe,GACf,OAAO,GACP,WAAW,GACX,WAAW,GACX,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACtD,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,YAAY,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC;CAC9C;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAC/B,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAC/C,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/web/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/web/utils.d.ts

@@ -11,6 +11,10 @@ export declare function filenameFromUrl(url: string): string;
 export declare function indexTaskItems(node: ASTNode, counter?: {
     value: number;
 }): void;
+/** Stamps Link nodes with their document-order index (the `renderLinkDecoration` key). */
+export declare function indexLinks(node: ASTNode, counter?: {
+    value: number;
+}): void;
 /**
  * Stamps Image nodes with `isInline` when they appear inside a paragraph
  * that also contains other content (text, links, etc.).

package/lib/typescript/src/web/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/web/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGrD;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO;;CAAe,GAAG,IAAI,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAcpD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/web/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAIrD;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO;;CAAe,GAAG,IAAI,CAK1E;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO;;CAAe,GAAG,IAAI,CAKtE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAcpD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-enriched-markdown-scaffold",
-  "version": "0.7.4-scaffold.9",
-  "description": "Markdown Text component for React Native",
+  "version": "1.0.2-scaffold.10",
+  "description": "Markdown-based Rich Text solution for React Native",
   "main": "./lib/module/index",
   "module": "./lib/module/index",
   "source": "./src/index.tsx",
@@ -13,8 +13,15 @@
     "ios",
     "cpp",
     "*.podspec",
+    "jest.js",
+    "jest.d.ts",
     "react-native.config.js",
+    "postinstall.mjs",
+    "vendor-grammars.mjs",
+    "vendor-ratex.mjs",
+    "ratex-version.json",
     "!ios/build",
+    "!ios/vendor",
     "!android/build",
     "!android/gradle",
     "!android/gradlew",
@@ -24,10 +31,11 @@
     "!**/__fixtures__",
     "!**/__mocks__",
     "!**/.*",
-    "app.plugin.js",
-    "plugin",
     "docs"
   ],
+  "scripts": {
+    "postinstall": "node postinstall.mjs"
+  },
   "keywords": [
     "react-native",
     "expo",
@@ -45,29 +53,48 @@
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
-    "@expo/config-plugins": ">=50.0.0",
     "katex": ">=0.16.0",
     "react": "*",
     "react-native": "*"
   },
   "peerDependenciesMeta": {
-    "@expo/config-plugins": {
-      "optional": true
-    },
     "katex": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@expo/config-plugins": "^55.0.6",
+    "@babel/core": "^7.25.0",
     "@react-native/babel-preset": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@tree-sitter-grammars/tree-sitter-markdown": "0.3.2",
+    "@tree-sitter-grammars/tree-sitter-yaml": "0.7.1",
+    "@types/jest": "^29.5.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.0",
+    "babel-jest": "^29.7.0",
     "clang-format": "^1.8.0",
     "del-cli": "^7.0.0",
+    "jest": "^29.7.0",
     "react": "19.2.3",
     "react-native": "0.85.0",
     "react-native-builder-bob": "^0.41.0",
+    "test-renderer": "^1.0.0",
+    "tree-sitter-bash": "0.23.3",
+    "tree-sitter-c": "0.23.5",
+    "tree-sitter-c-sharp": "0.23.1",
+    "tree-sitter-cpp": "0.23.4",
+    "tree-sitter-css": "0.23.2",
+    "tree-sitter-go": "0.23.4",
+    "tree-sitter-html": "0.23.2",
+    "tree-sitter-java": "0.23.5",
+    "tree-sitter-javascript": "0.23.1",
+    "tree-sitter-json": "0.24.8",
+    "tree-sitter-php": "0.24.2",
+    "tree-sitter-python": "0.23.6",
+    "tree-sitter-ruby": "0.23.1",
+    "tree-sitter-rust": "0.23.2",
+    "tree-sitter-swift": "0.7.0",
+    "tree-sitter-typescript": "0.23.2",
     "typescript": "^6.0.2"
   },
   "react-native-builder-bob": {

package/postinstall.mjs

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+// Thin wrapper that invokes vendor-grammars.mjs and vendor-ratex.mjs in
+// consumer mode (--from-npm) to download vendored native assets after install.
+//
+// In the monorepo, grammar-versions.json is not present at the expected path
+// (it is only copied during prepack), so this script is a no-op -- the
+// `prepare` script handles vendoring via the same scripts with monorepo paths.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const PKG_ROOT = path.dirname(fileURLToPath(import.meta.url));
+const LOG = '[react-native-enriched-markdown-scaffold]';
+
+const grammarManifest = path.join(PKG_ROOT, 'cpp/highlight/grammar-versions.json');
+if (!fs.existsSync(grammarManifest)) {
+  console.log(`${LOG} grammar-versions.json not found; skipping postinstall.`);
+  console.log(`${LOG} This is expected in monorepo development (use \`yarn prepare\`).`);
+  process.exit(0);
+}
+
+// Consumer opt-out. npm/yarn/pnpm set INIT_CWD to the project root running the
+// install, so the consumer declares which heavy native assets to skip downloading
+// via an `enriched-markdown` block in their own package.json:
+//
+//   { "enriched-markdown": { "enableCodeHighlight": false, "enableMath": false } }
+//
+// Both features default to enabled (opt-out, not opt-in). Any resolution failure
+// (INIT_CWD unset, unreadable/malformed JSON, absent key) falls back to downloading
+// everything -- a skipped download is far cheaper to recover from than a silently
+// missing feature. In a monorepo INIT_CWD is the workspace root where the install
+// ran, so the download opt-out lives in the root package.json (one shared node_modules).
+//
+// The native build reads the *app* package.json directly (via the podspec's
+// installation root / gradle's build root -- see the podspecs and android/build.gradle),
+// which is a separate per-app decision. It reconciles that flag with asset presence on
+// disk: an explicit opt-in with the asset missing fails loud, a default-on with it
+// missing degrades to a clean build.
+function resolveConsumerConfig() {
+  const initCwd = process.env.INIT_CWD;
+  if (!initCwd) {
+    return {};
+  }
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(initCwd, 'package.json'), 'utf8'));
+    const config = pkg['enriched-markdown'];
+    return config && typeof config === 'object' ? config : {};
+  } catch {
+    return {};
+  }
+}
+
+const consumerConfig = resolveConsumerConfig();
+
+// This script only decides what to DOWNLOAD into node_modules. The native build
+// (podspec + build.gradle) reads the app package.json directly to decide what to
+// compile/link, so nothing is written here for it to consume. The `codeHighlightLanguages`
+// subset is a build-time concern (a language subset is selected from the full downloaded
+// grammar set), so it is intentionally not read here. ENV vars are a deprecated fallback,
+// honored only when package.json has no explicit value.
+let enableCodeHighlight = consumerConfig.enableCodeHighlight;
+let enableMath = consumerConfig.enableMath;
+
+if (enableCodeHighlight === undefined && process.env.ENRICHED_MARKDOWN_ENABLE_CODE_HIGHLIGHT) {
+  console.warn(`${LOG} DEPRECATED: ENRICHED_MARKDOWN_ENABLE_CODE_HIGHLIGHT env var will be removed in a future version. Configure via "enriched-markdown".enableCodeHighlight in your package.json instead.`);
+  enableCodeHighlight = process.env.ENRICHED_MARKDOWN_ENABLE_CODE_HIGHLIGHT !== '0';
+}
+if (enableMath === undefined && process.env.ENRICHED_MARKDOWN_ENABLE_MATH) {
+  console.warn(`${LOG} DEPRECATED: ENRICHED_MARKDOWN_ENABLE_MATH env var will be removed in a future version. Configure via "enriched-markdown".enableMath in your package.json instead.`);
+  enableMath = process.env.ENRICHED_MARKDOWN_ENABLE_MATH !== '0';
+}
+
+enableCodeHighlight = enableCodeHighlight !== false;
+enableMath = enableMath !== false;
+
+if (!enableCodeHighlight && !enableMath) {
+  console.log(`${LOG} both code highlighting and math are disabled via package.json ("enriched-markdown"); skipping postinstall.`);
+  process.exit(0);
+}
+
+console.log(`${LOG} restoring vendored native assets ...`);
+
+const vendorGrammars = path.join(PKG_ROOT, 'vendor-grammars.mjs');
+const vendorRatex = path.join(PKG_ROOT, 'vendor-ratex.mjs');
+const vendorDir = path.join(PKG_ROOT, 'cpp/highlight/vendor');
+const ratexManifest = path.join(PKG_ROOT, 'ratex-version.json');
+const iosVendor = path.join(PKG_ROOT, 'ios/vendor');
+
+let failed = false;
+
+// Tree-sitter runtime + grammar C sources
+if (enableCodeHighlight) {
+  const r1 = spawnSync(process.execPath, [
+    vendorGrammars,
+    '--from-npm',
+    '--vendor-dir', vendorDir,
+    '--manifest', grammarManifest,
+  ], { stdio: 'inherit' });
+  if (r1.status !== 0) {
+    console.warn(`${LOG} WARNING: vendor-grammars failed. Code highlighting may not work.`);
+    failed = true;
+  }
+} else {
+  console.log(`${LOG} code highlighting disabled via package.json ("enriched-markdown".enableCodeHighlight = false); skipping tree-sitter grammars.`);
+}
+
+// RaTeX XCFramework + Swift sources + fonts (iOS math)
+if (!enableMath) {
+  console.log(`${LOG} math disabled via package.json ("enriched-markdown".enableMath = false); skipping RaTeX.`);
+} else if (fs.existsSync(ratexManifest) && fs.existsSync(vendorRatex)) {
+  const r2 = spawnSync(process.execPath, [
+    vendorRatex,
+    '--manifest', ratexManifest,
+    '--output', iosVendor,
+  ], { stdio: 'inherit' });
+  if (r2.status !== 0) {
+    console.warn(`${LOG} WARNING: vendor-ratex failed. iOS math rendering may not work.`);
+    failed = true;
+  }
+}
+
+if (failed) {
+  console.warn(
+    `${LOG} Some downloads failed. Ensure network access to registry.npmjs.org and github.com, ` +
+    `then re-run: node node_modules/react-native-enriched-markdown-scaffold/postinstall.mjs`
+  );
+}
+
+console.log(`${LOG} postinstall complete.`);

package/ratex-version.json

@@ -0,0 +1,21 @@
+{
+  "$comment": "Pins the RaTeX Apple integration for vendor-ratex.mjs. Instead of React Native's spm_dependency (which builds/signs RaTeX's Swift wrapper from SPM source at build time and caused #491/#527), we vendor the prebuilt static XCFramework plus RaTeX's four core Swift sources and KaTeX fonts into packages/react-native-enriched-markdown/ios/vendor/ (gitignored, reproduced on demand, shipped in the npm tarball via prepack). Same mechanism as the tree-sitter runtime pin in grammar-versions.json. To re-pin: bump tag, download the two assets, run `node vendor/vendor-ratex.mjs --force`, and paste the sha256 it prints on mismatch. The swiftSources list mirrors erweixin/RaTeX's RaTeXCore.podspec; PlatformCompat.swift and RaTeXView.swift are intentionally omitted (the four files typecheck standalone and pull in no React Native/UI surface).",
+  "tag": "v0.1.14",
+  "xcframework": {
+    "url": "https://github.com/erweixin/RaTeX/releases/download/v0.1.14/RaTeX.xcframework.zip",
+    "sha256": "16b84a5e9b9f80ed4910c490f96dda047662e9bdd0934817ecf4464cf02581f2"
+  },
+  "source": {
+    "url": "https://github.com/erweixin/RaTeX/archive/refs/tags/v0.1.14.tar.gz",
+    "sha256": "2da907eb5dfcb464c7eef3b4c657fbdee144e3c6633e81efb1e56dcf1c76e01b",
+    "prefix": "RaTeX-0.1.14",
+    "swiftSources": [
+      "platforms/ios/Sources/Ratex/DisplayList.swift",
+      "platforms/ios/Sources/Ratex/RaTeXEngine.swift",
+      "platforms/ios/Sources/Ratex/RaTeXFontLoader.swift",
+      "platforms/ios/Sources/Ratex/RaTeXRenderer.swift"
+    ],
+    "fontsDir": "platforms/ios/Sources/Ratex/Fonts",
+    "license": "LICENSE"
+  }
+}

package/src/EnrichedMarkdownNativeComponent.ts

@@ -1,9 +1,12 @@
 import {
   codegenNativeComponent,
+  codegenNativeCommands,
   type ViewProps,
   type CodegenTypes,
   type ColorValue,
+  type HostComponent,
 } from 'react-native';
+import type React from 'react';
 
 // All block styles extend this interface
 interface BaseBlockStyleInternal {
@@ -29,6 +32,8 @@ interface BlockquoteStyleInternal extends BaseBlockStyleInternal {
   borderWidth: CodegenTypes.Float;
   gapWidth: CodegenTypes.Float;
   backgroundColor: ColorValue;
+  borderRadius: CodegenTypes.Float;
+  padding: CodegenTypes.Float;
 }
 
 interface ListStyleInternal extends BaseBlockStyleInternal {
@@ -39,6 +44,24 @@ interface ListStyleInternal extends BaseBlockStyleInternal {
   markerFontWeight: string;
   gapWidth: CodegenTypes.Float;
   marginLeft: CodegenTypes.Float;
+  itemSpacing: CodegenTypes.Float;
+}
+
+interface CodeBlockSyntaxColorsInternal {
+  keyword: ColorValue;
+  operatorColor: ColorValue;
+  punctuation: ColorValue;
+  string: ColorValue;
+  number: ColorValue;
+  constant: ColorValue;
+  comment: ColorValue;
+  function: ColorValue;
+  type: ColorValue;
+  variable: ColorValue;
+  property: ColorValue;
+  tag: ColorValue;
+  attribute: ColorValue;
+  embedded: ColorValue;
 }
 
 interface CodeBlockStyleInternal extends BaseBlockStyleInternal {
@@ -47,6 +70,7 @@ interface CodeBlockStyleInternal extends BaseBlockStyleInternal {
   borderRadius: CodegenTypes.Float;
   borderWidth: CodegenTypes.Float;
   padding: CodegenTypes.Float;
+  syntaxColors: CodeBlockSyntaxColorsInternal;
 }
 
 interface LinkStyleInternal {
@@ -54,6 +78,11 @@ interface LinkStyleInternal {
   color: ColorValue;
   underline: boolean;
   backgroundColor: ColorValue;
+  borderRadius: CodegenTypes.Float;
+  paddingHorizontal: CodegenTypes.Float;
+  paddingVertical: CodegenTypes.Float;
+  borderColor: ColorValue;
+  borderWidth: CodegenTypes.Float;
 }
 
 // Mirrors EnrichedMarkdownTextNativeComponent.ts — kept in sync manually (codegen spec files must be self-contained).
@@ -62,6 +91,11 @@ interface LinkVariantEntryInternal {
   color: ColorValue;
   underline: boolean;
   backgroundColor: ColorValue;
+  borderRadius: CodegenTypes.Float;
+  paddingHorizontal: CodegenTypes.Float;
+  paddingVertical: CodegenTypes.Float;
+  borderColor: ColorValue;
+  borderWidth: CodegenTypes.Float;
 }
 
 interface StrongStyleInternal {
@@ -94,6 +128,9 @@ interface CodeStyleInternal {
 
 interface ImageStyleInternal {
   height: CodegenTypes.Float;
+  maxHeight: CodegenTypes.Float;
+  aspectRatio: CodegenTypes.Float;
+  resizeMode: string;
   borderRadius: CodegenTypes.Float;
   marginTop: CodegenTypes.Float;
   marginBottom: CodegenTypes.Float;
@@ -121,6 +158,8 @@ interface TableStyleInternal extends BaseBlockStyleInternal {
   borderRadius: CodegenTypes.Float;
   cellPaddingHorizontal: CodegenTypes.Float;
   cellPaddingVertical: CodegenTypes.Float;
+  horizontalOverflow: CodegenTypes.Float;
+  align: string;
 }
 
 interface TaskListStyleInternal {
@@ -142,12 +181,14 @@ interface MathStyleInternal {
   marginBottom: CodegenTypes.Float;
   textAlign: string;
   fontWeight: string;
+  glyphOverflow: CodegenTypes.Float;
 }
 
 interface InlineMathStyleInternal {
   color: ColorValue;
   paddingVertical: CodegenTypes.Float;
   fontWeight: string;
+  glyphOverflow: CodegenTypes.Float;
 }
 
 interface SpoilerParticlesStyleInternal {
@@ -219,17 +260,88 @@ export interface LinkLongPressEvent {
   url: string;
 }
 
+/**
+ * `fragments` holds one entry per laid-out line of a link (a wrapping link
+ * yields several). Rects are in dp, relative to the native view's origin, and
+ * cover the drawn chip (glyphs + padding). Flattened rather than nested per
+ * link, and written inline, because codegen only accepts inline object
+ * literals as event array elements.
+ */
+export interface LinkLayoutEvent {
+  fragments: {
+    linkIndex: CodegenTypes.Int32;
+    url: string;
+    text: string;
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  }[];
+}
+
+/**
+ * Current text selection, or a long-pressed table / math / code block while
+ * `contextMenuHidden` is on. `active: false` means the selection was cleared
+ * (every other field is then empty / zero). Rects are in dp / pt, relative to
+ * the native view's origin; rect objects are written inline because codegen
+ * only accepts inline object literals in event payloads.
+ */
+export interface SelectionChangeEvent {
+  active: boolean;
+  source: string;
+  text: string;
+  markdown: string;
+  whole: boolean;
+  rect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+  startRect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+  endRect: {
+    x: CodegenTypes.Double;
+    y: CodegenTypes.Double;
+    width: CodegenTypes.Double;
+    height: CodegenTypes.Double;
+  };
+  adjusting: boolean;
+}
+
 export interface TaskListItemPressEvent {
   index: CodegenTypes.Int32;
   checked: boolean;
   text: string;
 }
 
+export interface CopyPressEvent {
+  code: string;
+  language: string;
+}
+
+export interface CopyRequestEvent {
+  // 'selection' | 'math' | 'table' | 'code'
+  source: string;
+  markdown: string;
+  text: string;
+  whole: boolean;
+}
+
 export interface ContextMenuItemConfig {
   text: string;
   icon?: string;
 }
 
+export interface ImageRequestHeaderInternal {
+  name: string;
+  value: string;
+}
+
 export interface SelectionMenuConfig {
   copyAsMarkdown: boolean;
   copyImageUrl: boolean;
@@ -240,6 +352,16 @@ export interface SelectionMenuConfig {
   // Precomputed plural templates indexed by image count (0..100). Empty when no
   // pluralLabels are set; native then uses copyImageUrlLabel/copyImageUrlsLabel.
   copyImageUrlPluralTemplates: ReadonlyArray<string>;
+  // false removes the Copy item from the text and block menus.
+  copyEnabled: boolean;
+  // true: Copy writes Markdown (plain text) instead of rich text / raw block content.
+  copyFormatMarkdown: boolean;
+  // true: the text selection menu drops every system-provided item.
+  systemItemsNone: boolean;
+  // false hides the copy button in the code block header.
+  codeBlockCopyButton: boolean;
+  // true: the Copy item emits onCopyRequest instead of writing the clipboard.
+  interceptCopy: boolean;
 }
 
 export interface OnContextMenuItemPressEvent {
@@ -311,10 +433,16 @@ export interface Md4cFlagsInternal {
    * @default false
    */
   highlight: boolean;
+  /**
+   * Treat soft breaks (single newlines) as hard breaks (visible line breaks).
+   * @default false
+   */
+  hardSoftBreaks: boolean;
 }
 
 interface StreamingConfigInternal {
   tableMode: string;
+  codeBlockMode: string;
 }
 
 export interface NativeProps extends ViewProps {
@@ -340,11 +468,56 @@ export interface NativeProps extends ViewProps {
    * - Android: Handles long press gestures on links.
    */
   onLinkLongPress?: CodegenTypes.BubblingEventHandler<LinkLongPressEvent>;
+  /**
+   * When true, the view reports the laid-out rects of every link through
+   * `onLinkLayout` (after each render and whenever its size changes).
+   * Set by the JS wrapper only when `renderLinkDecoration` is provided.
+   * @default false
+   */
+  emitLinkLayout?: CodegenTypes.WithDefault<boolean, false>;
+  /**
+   * Fired with the rects of every link fragment while `emitLinkLayout` is on.
+   * Deduplicated: not re-fired when the payload is unchanged.
+   */
+  onLinkLayout?: CodegenTypes.DirectEventHandler<LinkLayoutEvent>;
+  /**
+   * When true, the view reports selection changes (and, with
+   * `contextMenuHidden`, block long-presses) through `onSelectionChange`.
+   * Set by the JS wrapper only when `onSelectionChange` is provided.
+   * @default false
+   */
+  emitSelectionChange?: CodegenTypes.WithDefault<boolean, false>;
+  /**
+   * Fired while `emitSelectionChange` is on: coalesced to one event per frame,
+   * deduplicated, and `active: false` once the selection is gone.
+   */
+  onSelectionChange?: CodegenTypes.DirectEventHandler<SelectionChangeEvent>;
   /**
    * Callback fired when a task list checkbox is tapped.
    * Receives the 0-based task index, current checked state, and the item's plain text.
    */
   onTaskListItemPress?: CodegenTypes.BubblingEventHandler<TaskListItemPressEvent>;
+  /**
+   * Controls whether tapping a task list checkbox toggles its checked state.
+   *
+   * When `false`, the tap is fully inert: no visual toggle and no
+   * `onTaskListItemPress` emission. Text selection and links are unaffected.
+   *
+   * @default true
+   */
+  enableTaskListItemToggle?: CodegenTypes.WithDefault<boolean, true>;
+  /**
+   * Callback fired when code is copied from a fenced code block's header copy
+   * button, its long-press context-menu "Copy" action, or the VoiceOver copy
+   * action. Receives the copied code and its language.
+   */
+  onCopyPress?: CodegenTypes.BubblingEventHandler<CopyPressEvent>;
+  /**
+   * Fired instead of writing the clipboard when the Copy item of the text
+   * selection menu or a table / math / code block menu is pressed while
+   * `selectionMenuConfig.interceptCopy` is set.
+   */
+  onCopyRequest?: CodegenTypes.BubblingEventHandler<CopyRequestEvent>;
   /**
    * Controls whether the system link preview is shown on long press (iOS only).
    *
@@ -358,6 +531,16 @@ export interface NativeProps extends ViewProps {
    * @default true
    */
   enableLinkPreview?: CodegenTypes.WithDefault<boolean, true>;
+  /**
+   * When `true`, long-pressing a link selects its label and shows the
+   * selection edit menu instead of the system link preview (iOS only).
+   * Takes precedence over `enableLinkPreview` and `onLinkLongPress`.
+   *
+   * Android: No-op.
+   *
+   * @default false
+   */
+  linkLongPressSelects?: CodegenTypes.WithDefault<boolean, false>;
   /**
    * - iOS: Controls text selection and link previews on long press.
    * - Android: Controls text selection.
@@ -425,10 +608,18 @@ export interface NativeProps extends ViewProps {
    */
   spoilerOverlay?: CodegenTypes.WithDefault<string, 'particles'>;
 
+  /**
+   * Hides the text selection context menu while keeping text selectable.
+   */
+  contextMenuHidden?: CodegenTypes.WithDefault<boolean, false>;
   /**
    * Custom items to show in the text selection context menu.
    */
   contextMenuItems?: ReadonlyArray<Readonly<ContextMenuItemConfig>>;
+  /**
+   * HTTP headers attached to remote image requests, as name/value pairs.
+   */
+  imageRequestHeaders?: ReadonlyArray<Readonly<ImageRequestHeaderInternal>>;
   /**
    * Built-in items to show in the text selection context menu.
    */
@@ -464,6 +655,17 @@ export interface NativeProps extends ViewProps {
   writingDirection?: CodegenTypes.WithDefault<string, 'first-strong'>;
 }
 
+type ComponentType = HostComponent<NativeProps>;
+
+interface NativeCommands {
+  /** Clears the text selection (and any active block) and fires `onSelectionChange` with `active: false`. */
+  clearSelection: (viewRef: React.ElementRef<ComponentType>) => void;
+}
+
+export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['clearSelection'],
+});
+
 export default codegenNativeComponent<NativeProps>('EnrichedMarkdown', {
   interfaceOnly: true,
-});
+}) as HostComponent<NativeProps>;