react-native-enriched-markdown-scaffold 0.7.4-scaffold.8 → 1.0.2-scaffold.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-enriched-markdown-scaffold",
-  "version": "0.7.4-scaffold.8",
-  "description": "Markdown Text component for React Native",
+  "version": "1.0.2-scaffold.1",
+  "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

@@ -29,6 +29,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 +41,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 +67,7 @@ interface CodeBlockStyleInternal extends BaseBlockStyleInternal {
   borderRadius: CodegenTypes.Float;
   borderWidth: CodegenTypes.Float;
   padding: CodegenTypes.Float;
+  syntaxColors: CodeBlockSyntaxColorsInternal;
 }
 
 interface LinkStyleInternal {
@@ -94,6 +115,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 +145,8 @@ interface TableStyleInternal extends BaseBlockStyleInternal {
   borderRadius: CodegenTypes.Float;
   cellPaddingHorizontal: CodegenTypes.Float;
   cellPaddingVertical: CodegenTypes.Float;
+  horizontalOverflow: CodegenTypes.Float;
+  align: string;
 }
 
 interface TaskListStyleInternal {
@@ -225,11 +251,21 @@ export interface TaskListItemPressEvent {
   text: string;
 }
 
+export interface CopyPressEvent {
+  code: string;
+  language: string;
+}
+
 export interface ContextMenuItemConfig {
   text: string;
   icon?: string;
 }
 
+export interface ImageRequestHeaderInternal {
+  name: string;
+  value: string;
+}
+
 export interface SelectionMenuConfig {
   copyAsMarkdown: boolean;
   copyImageUrl: boolean;
@@ -311,10 +347,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 {
@@ -345,6 +387,21 @@ export interface NativeProps extends ViewProps {
    * 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>;
   /**
    * Controls whether the system link preview is shown on long press (iOS only).
    *
@@ -425,10 +482,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.
    */