react-native-fast-html-parser 0.1.0

package/package.json

@@ -0,0 +1,153 @@
+{
+  "name": "react-native-fast-html-parser",
+  "version": "0.1.0",
+  "description": "A lightning-fast HTML parser library for React Native that converts raw HTML fragments into a structured JSON AST tree. Built on a high-performance Rust core and integrated via direct C++ JSI HostObjects, it achieves pure zero-copy shared-memory access on-device. This avoids standard string/JSON serialization overhead and Hermes garbage collection pauses during render loops.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native-fast-html-parser-source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*",
+    "scripts"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-fast-html-parser-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "test": "jest",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abhishekce17/react-native-fast-html-parser.git"
+  },
+  "author": "abhishekce17 <abhisheklprajapati18@gmail.com> (https://github.com/abhishekce17)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/abhishekce17/react-native-fast-html-parser/issues"
+  },
+  "homepage": "https://github.com/abhishekce17/react-native-fast-html-parser#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@jest/globals": "^29.7.0",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@types/react": "^19.2.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.6",
+    "jest": "^29.7.0",
+    "nitrogen": "^0.37.1",
+    "prettier": "^3.8.3",
+    "react": "19.2.3",
+    "react-native": "0.85.0",
+    "react-native-builder-bob": "^0.43.0",
+    "react-native-nitro-modules": "^0.37.1",
+    "turbo": "^2.9.16",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.37.1"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "testEnvironmentOptions": {
+      "customExportConditions": [
+        "require",
+        "react-native",
+        "<%- project.sourceCondition -%>"
+      ]
+    },
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin-swift",
+    "tools": [
+      "jest",
+      "eslint"
+    ],
+    "version": "0.63.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,234 @@
+#!/usr/bin/env node
+/**
+ * Postinstall script for react-native-fast-html-parser
+ *
+ * Downloads precompiled Rust native binaries from GitHub Releases
+ * so developers do not need Rust installed on their machines.
+ */
+
+'use strict';
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const pkg = require('../package.json');
+const VERSION = pkg.version;
+const REPO = 'abhishekce17/react-native-fast-html-parser';
+const BASE_URL =
+  'https://github.com/' + REPO + '/releases/download/v' + VERSION;
+const PKG_ROOT = path.resolve(__dirname, '..');
+
+const BINARIES = [
+  {
+    name: 'libhtml_2_json-ios-device.a',
+    dest: path.join(PKG_ROOT, 'ios', 'libs', 'device', 'libhtml_2_json.a'),
+  },
+  {
+    name: 'libhtml_2_json-ios-sim.a',
+    dest: path.join(PKG_ROOT, 'ios', 'libs', 'sim', 'libhtml_2_json.a'),
+  },
+  {
+    name: 'libhtml_2_json-android-arm64-v8a.so',
+    dest: path.join(
+      PKG_ROOT,
+      'android',
+      'src',
+      'main',
+      'jniLibs',
+      'arm64-v8a',
+      'libhtml_2_json.so'
+    ),
+  },
+  {
+    name: 'libhtml_2_json-android-armeabi-v7a.so',
+    dest: path.join(
+      PKG_ROOT,
+      'android',
+      'src',
+      'main',
+      'jniLibs',
+      'armeabi-v7a',
+      'libhtml_2_json.so'
+    ),
+  },
+  {
+    name: 'libhtml_2_json-android-x86.so',
+    dest: path.join(
+      PKG_ROOT,
+      'android',
+      'src',
+      'main',
+      'jniLibs',
+      'x86',
+      'libhtml_2_json.so'
+    ),
+  },
+  {
+    name: 'libhtml_2_json-android-x86_64.so',
+    dest: path.join(
+      PKG_ROOT,
+      'android',
+      'src',
+      'main',
+      'jniLibs',
+      'x86_64',
+      'libhtml_2_json.so'
+    ),
+  },
+];
+
+function download(url, destPath) {
+  return new Promise(function (resolve, reject) {
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    const file = fs.createWriteStream(destPath);
+
+    function get(currentUrl) {
+      https
+        .get(
+          currentUrl,
+          {
+            headers: {
+              'User-Agent': 'react-native-fast-html-parser-postinstall',
+            },
+          },
+          function (res) {
+            if (res.statusCode === 301 || res.statusCode === 302) {
+              file.close();
+              return get(res.headers.location);
+            }
+            if (res.statusCode !== 200) {
+              file.close();
+              try {
+                fs.unlinkSync(destPath);
+              } catch {}
+              return reject(
+                new Error(
+                  'Failed to download ' +
+                    currentUrl +
+                    ': HTTP ' +
+                    res.statusCode
+                )
+              );
+            }
+            res.pipe(file);
+            file.on('finish', function () {
+              file.close(resolve);
+            });
+          }
+        )
+        .on('error', function (err) {
+          file.close();
+          try {
+            fs.unlinkSync(destPath);
+          } catch {}
+          reject(err);
+        });
+    }
+
+    get(url);
+  });
+}
+
+async function main() {
+  console.log(
+    '\n[react-native-fast-html-parser] Downloading native binaries v' +
+      VERSION +
+      '...'
+  );
+  console.log('[react-native-fast-html-parser] Source: ' + BASE_URL + '\n');
+
+  let failed = false;
+
+  for (const binary of BINARIES) {
+    if (fs.existsSync(binary.dest)) {
+      console.log('  \u2713 Already exists: ' + binary.name);
+      continue;
+    }
+
+    const url = BASE_URL + '/' + binary.name;
+    process.stdout.write('  \u2193 Downloading ' + binary.name + '...');
+
+    try {
+      await download(url, binary.dest);
+      console.log(' \u2713');
+    } catch (err) {
+      console.log(' \u2717');
+      console.error('    Error: ' + err.message);
+      failed = true;
+    }
+  }
+
+  // Assemble iOS XCFramework on macOS machines
+  if (process.platform === 'darwin') {
+    const xcframeworkPath = path.join(
+      PKG_ROOT,
+      'ios',
+      'libs',
+      'libhtml_2_json.xcframework'
+    );
+    if (!fs.existsSync(xcframeworkPath)) {
+      console.log('  ⚙ Assembling iOS XCFramework...');
+      const devicePath = path.join(
+        PKG_ROOT,
+        'ios',
+        'libs',
+        'device',
+        'libhtml_2_json.a'
+      );
+      const simPath = path.join(
+        PKG_ROOT,
+        'ios',
+        'libs',
+        'sim',
+        'libhtml_2_json.a'
+      );
+
+      try {
+        const { execSync } = require('child_process');
+        execSync(
+          'xcodebuild -create-xcframework -library "' +
+            devicePath +
+            '" -library "' +
+            simPath +
+            '" -output "' +
+            xcframeworkPath +
+            '"',
+          { stdio: 'ignore' }
+        );
+        console.log('  ✓ XCFramework assembled successfully.');
+      } catch (err) {
+        console.error('  ✗ Failed to assemble XCFramework: ' + err.message);
+        failed = true;
+      }
+    } else {
+      console.log('  ✓ XCFramework already exists.');
+    }
+  }
+
+  if (failed) {
+    console.error(
+      [
+        '',
+        '[react-native-fast-html-parser] Some binaries failed to download.',
+        '  This may happen if:',
+        '    - You are offline',
+        '    - Release v' + VERSION + ' has not been published yet on GitHub',
+        '',
+        '  Manually download them from:',
+        '    https://github.com/' + REPO + '/releases/tag/v' + VERSION,
+        '',
+        '  Place them in:',
+        '    ios/libs/device/libhtml_2_json.a',
+        '    ios/libs/sim/libhtml_2_json.a',
+        '    android/src/main/jniLibs/<ABI>/libhtml_2_json.so',
+        '',
+      ].join('\n')
+    );
+    process.exit(0);
+  }
+
+  console.log('\n[react-native-fast-html-parser] All binaries ready.\n');
+}
+
+main();

package/src/FastHtmlParser.nitro.ts

@@ -0,0 +1,86 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export interface InlineNode extends HybridObject<{
+  ios: 'c++';
+  android: 'c++';
+}> {
+  readonly type: string;
+  readonly text: string;
+  readonly url: string;
+  readonly childCount: number;
+  getChild(index: number): InlineNode | null;
+}
+
+export interface ListItem extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
+  readonly childCount: number;
+  getChild(index: number): InlineNode | null;
+  readonly nestedCount: number;
+  getNested(index: number): ContentBlock | null;
+}
+
+export interface TableCell extends HybridObject<{
+  ios: 'c++';
+  android: 'c++';
+}> {
+  readonly childCount: number;
+  getChild(index: number): InlineNode | null;
+}
+
+export interface TableRow extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
+  readonly cellCount: number;
+  getCell(index: number): TableCell | null;
+}
+
+export interface DefinitionItem extends HybridObject<{
+  ios: 'c++';
+  android: 'c++';
+}> {
+  readonly termCount: number;
+  getTerm(index: number): InlineNode | null;
+  readonly defCount: number;
+  getDef(index: number): InlineNode | null;
+}
+
+export interface ContentBlock extends HybridObject<{
+  ios: 'c++';
+  android: 'c++';
+}> {
+  readonly type: string;
+  readonly level: number;
+  readonly url: string;
+  readonly alt: string;
+  readonly caption: string;
+  readonly code: string;
+  readonly language: string;
+  readonly src: string;
+  readonly poster: string;
+  readonly title: string;
+
+  readonly childCount: number;
+  getChild(index: number): InlineNode | null;
+  getQuoteChild(index: number): ContentBlock | null;
+
+  readonly ordered: boolean;
+  readonly itemCount: number;
+  getItem(index: number): ListItem | null;
+
+  readonly rowCount: number;
+  getRow(index: number): TableRow | null;
+
+  getDefItem(index: number): DefinitionItem | null;
+}
+
+export interface ParsedArticle extends HybridObject<{
+  ios: 'c++';
+  android: 'c++';
+}> {
+  readonly length: number;
+  getBlock(index: number): ContentBlock | null;
+}
+
+export interface FastHtmlParser extends HybridObject<{
+  ios: 'c++';
+  android: 'c++';
+}> {
+  parse(html: string): ParsedArticle | null;
+}

package/src/index.tsx

@@ -0,0 +1,12 @@
+export { parseHTML } from './parser';
+
+export type {
+  InlineNode,
+  ListItem,
+  TableCell,
+  TableRow,
+  DefinitionItem,
+  ContentBlock,
+  ParsedArticle,
+  FastHtmlParser,
+} from './FastHtmlParser.nitro';

package/src/parser.native.tsx

@@ -0,0 +1,9 @@
+import { NitroModules } from 'react-native-nitro-modules';
+import type { FastHtmlParser, ParsedArticle } from './FastHtmlParser.nitro';
+
+const FastHtmlParserHybridObject =
+  NitroModules.createHybridObject<FastHtmlParser>('FastHtmlParser');
+
+export function parseHTML(html: string): ParsedArticle | null {
+  return FastHtmlParserHybridObject.parse(html);
+}

package/src/parser.tsx

@@ -0,0 +1,7 @@
+import type { ParsedArticle } from './FastHtmlParser.nitro';
+
+export function parseHTML(_html: string): ParsedArticle | null {
+  throw new Error(
+    "'react-native-fast-html-parser' is only supported on native platforms."
+  );
+}