react-native-web-serial-api 0.0.3 → 0.1.0

package/example/src/util/TextUtil.ts

@@ -1,129 +0,0 @@
-// Ported from SimpleUsbTerminal TextUtil.java
-
-export const NEWLINE_CRLF = '\r\n';
-export const NEWLINE_LF = '\n';
-
-/** A run of text; `caret` runs (^X control-char notation) get a gray background. */
-export type Run = {text: string; caret: boolean};
-
-/** Parse a hex string ("AA BB CC" / "aabbcc") into bytes, ignoring non-hex chars. */
-export function fromHexString(s: string): Uint8Array {
-  const out: number[] = [];
-  let b = 0;
-  let nibble = 0;
-  for (let i = 0; i < s.length; i++) {
-    if (nibble === 2) {
-      out.push(b & 0xff);
-      nibble = 0;
-      b = 0;
-    }
-    const c = s.charCodeAt(i);
-    if (c >= 0x30 && c <= 0x39) {
-      nibble++;
-      b = b * 16 + (c - 0x30);
-    } else if (c >= 0x41 && c <= 0x46) {
-      nibble++;
-      b = b * 16 + (c - 0x41 + 10);
-    } else if (c >= 0x61 && c <= 0x66) {
-      nibble++;
-      b = b * 16 + (c - 0x61 + 10);
-    }
-  }
-  if (nibble > 0) {
-    out.push(b & 0xff);
-  }
-  return Uint8Array.from(out);
-}
-
-/** Format bytes as space-separated uppercase hex: "AA BB CC". */
-export function toHexString(buf: Uint8Array | number[]): string {
-  let sb = '';
-  for (let i = 0; i < buf.length; i++) {
-    if (sb.length > 0) {
-      sb += ' ';
-    }
-    sb += (buf[i] & 0xff).toString(16).toUpperCase().padStart(2, '0');
-  }
-  return sb;
-}
-
-/** HexWatcher formatting: keep only hex chars, uppercase, group into pairs. */
-export function formatHexInput(s: string): string {
-  let hex = '';
-  for (let i = 0; i < s.length; i++) {
-    const c = s[i];
-    if ((c >= '0' && c <= '9') || (c >= 'A' && c <= 'F')) {
-      hex += c;
-    } else if (c >= 'a' && c <= 'f') {
-      hex += c.toUpperCase();
-    }
-  }
-  let grouped = '';
-  for (let i = 0; i < hex.length; i++) {
-    if (i > 0 && i % 2 === 0) {
-      grouped += ' ';
-    }
-    grouped += hex[i];
-  }
-  return grouped;
-}
-
-/**
- * Caret notation (https://en.wikipedia.org/wiki/Caret_notation) so invisible
- * control characters are shown as ^X with a highlighted background.
- */
-export function toCaretRuns(s: string, keepNewline: boolean): Run[] {
-  const runs: Run[] = [];
-  let plain = '';
-  const flush = () => {
-    if (plain) {
-      runs.push({text: plain, caret: false});
-      plain = '';
-    }
-  };
-  for (let i = 0; i < s.length; i++) {
-    const ch = s.charCodeAt(i);
-    if (ch < 32 && !(keepNewline && ch === 10)) {
-      flush();
-      runs.push({text: `^${String.fromCharCode(ch + 64)}`, caret: true});
-    } else {
-      plain += s[i];
-    }
-  }
-  flush();
-  return runs;
-}
-
-const decoder = typeof TextDecoder !== 'undefined' ? new TextDecoder() : null;
-const encoder = typeof TextEncoder !== 'undefined' ? new TextEncoder() : null;
-
-/** Decode received bytes to a string (UTF-8 when available, else Latin-1). */
-export function bytesToString(data: Uint8Array): string {
-  if (decoder) {
-    return decoder.decode(data);
-  }
-  let s = '';
-  for (let i = 0; i < data.length; i++) {
-    s += String.fromCharCode(data[i]);
-  }
-  return s;
-}
-
-/** Encode a string to UTF-8 bytes for sending. */
-export function stringToBytes(str: string): Uint8Array {
-  if (encoder) {
-    return encoder.encode(str);
-  }
-  const out: number[] = [];
-  for (let i = 0; i < str.length; i++) {
-    const c = str.charCodeAt(i);
-    if (c < 0x80) {
-      out.push(c);
-    } else if (c < 0x800) {
-      out.push(0xc0 | (c >> 6), 0x80 | (c & 0x3f));
-    } else {
-      out.push(0xe0 | (c >> 12), 0x80 | ((c >> 6) & 0x3f), 0x80 | (c & 0x3f));
-    }
-  }
-  return Uint8Array.from(out);
-}

package/example/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "@react-native/typescript-config",
-  "compilerOptions": {
-    "lib": ["ESNext", "DOM"],
-    "paths": {
-      "react-native-web-serial-api": ["../src/index"]
-    }
-  },
-  "include": ["App.tsx", "index.js", "index.web.js", "src", "__tests__"]
-}

package/example/vite.config.mjs

@@ -1,55 +0,0 @@
-import {createRequire} from 'node:module';
-import path from 'node:path';
-import react from '@vitejs/plugin-react';
-import {defineConfig} from 'vite';
-
-const require = createRequire(import.meta.url);
-const rootPkg = require('../package.json');
-
-// Absolute path to react-native-web so the alias resolves correctly even from
-// the library source outside this folder (avoids duplicate-module resolution).
-const reactNativeWeb = path.dirname(
-  require.resolve('react-native-web/package.json'),
-);
-
-// Resolve platform-specific files (.web.ts wins on web) the way Metro does.
-const extensions = [
-  '.web.tsx',
-  '.web.ts',
-  '.web.jsx',
-  '.web.js',
-  '.tsx',
-  '.ts',
-  '.jsx',
-  '.js',
-  '.json',
-];
-
-export default defineConfig({
-  root: import.meta.dirname,
-  plugins: [react()],
-  define: {
-    // React Native / RNW globals expected at runtime
-    global: 'globalThis',
-    __DEV__: JSON.stringify(process.env.NODE_ENV !== 'production'),
-    'process.env.NODE_ENV': JSON.stringify(
-      process.env.NODE_ENV || 'development',
-    ),
-  },
-  resolve: {
-    extensions,
-    alias: [
-      // Consume the library straight from its TypeScript source (live reload)
-      {
-        find: new RegExp(`^${rootPkg.name}$`),
-        replacement: path.resolve(import.meta.dirname, '..', rootPkg.source),
-      },
-      // react-native -> react-native-web (exact match only, so it doesn't
-      // rewrite react-native-web or react-native-web-serial-api)
-      {find: /^react-native$/, replacement: reactNativeWeb},
-    ],
-  },
-  optimizeDeps: {
-    include: ['react-native-web', 'web-streams-polyfill'],
-  },
-});

package/scripts/deploy-release.sh

@@ -1,127 +0,0 @@
-#!/usr/bin/env bash
-#
-# Build and install a standalone RELEASE build of the example app.
-#
-# A release build embeds the JS bundle (assets/index.android.bundle) into the
-# APK, so the app runs WITHOUT Metro / a dev server. The JS bundler runs once
-# at build time; after install the app is fully self-contained.
-#
-# Usage:
-#   ./scripts/deploy-release.sh           # build, install on the connected device, launch
-#   ./scripts/deploy-release.sh --build   # build the APK only (no install)
-#   ./scripts/deploy-release.sh --no-launch
-#   DEVICE=192.168.1.50:5555 ./scripts/deploy-release.sh   # target a specific adb device
-#
-# Environment overrides (auto-detected if unset):
-#   JAVA_HOME      - JDK 17 (RN 0.85 / Gradle 8.13 require JDK 17-21)
-#   ANDROID_HOME   - Android SDK location
-#   NODE_BIN       - directory containing a Node >= 20 binary (RN 0.85 metro needs it)
-#
-set -euo pipefail
-
-APP_ID="dev.react_native_web_serial_api.example"
-MAIN_ACTIVITY="${APP_ID}/.MainActivity"
-
-# Resolve paths relative to this script so it works from any CWD.
-# This script lives in <repo>/scripts; the buildable app is in <repo>/example
-# (the repo-root android/ is the library module and has no gradlew).
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(dirname "$SCRIPT_DIR")"
-EXAMPLE_DIR="$REPO_ROOT/example"
-ANDROID_DIR="$EXAMPLE_DIR/android"
-APK="$ANDROID_DIR/app/build/outputs/apk/release/app-release.apk"
-
-# --- arg parsing ---------------------------------------------------------
-DO_INSTALL=1
-DO_LAUNCH=1
-for arg in "$@"; do
-  case "$arg" in
-    --build)     DO_INSTALL=0; DO_LAUNCH=0 ;;
-    --no-launch) DO_LAUNCH=0 ;;
-    -h|--help)   grep '^#' "$0" | grep -v '^#!' | sed 's/^# \{0,1\}//'; exit 0 ;;
-    *) echo "Unknown option: $arg" >&2; exit 1 ;;
-  esac
-done
-
-# --- toolchain auto-detection -------------------------------------------
-# JDK 17 (only override if the current java isn't already 17-21).
-if [ -z "${JAVA_HOME:-}" ]; then
-  for d in /usr/lib/jvm/java-17-openjdk-amd64 /usr/lib/jvm/java-21-openjdk-amd64 \
-           /usr/lib/jvm/temurin-17-jdk-amd64; do
-    [ -d "$d" ] && export JAVA_HOME="$d" && break
-  done
-fi
-[ -n "${JAVA_HOME:-}" ] && echo "JAVA_HOME=$JAVA_HOME"
-
-# Android SDK.
-if [ -z "${ANDROID_HOME:-}" ]; then
-  for d in "$HOME/Android/Sdk" "$HOME/Library/Android/sdk" "${ANDROID_SDK_ROOT:-}"; do
-    [ -n "$d" ] && [ -d "$d" ] && export ANDROID_HOME="$d" && break
-  done
-fi
-if [ -z "${ANDROID_HOME:-}" ]; then
-  echo "ERROR: Android SDK not found. Set ANDROID_HOME." >&2
-  exit 1
-fi
-echo "ANDROID_HOME=$ANDROID_HOME"
-export PATH="$ANDROID_HOME/platform-tools:$PATH"
-
-# Node >= 20 (RN 0.85 metro-config uses Array.prototype.toReversed()).
-need_node() { node -e 'process.exit(typeof [].toReversed==="function"?0:1)' 2>/dev/null; }
-if [ -n "${NODE_BIN:-}" ]; then
-  export PATH="$NODE_BIN:$PATH"
-fi
-if ! command -v node >/dev/null 2>&1 || ! need_node; then
-  # Try the newest nvm-managed Node >= 20.
-  if [ -d "$HOME/.nvm/versions/node" ]; then
-    for v in $(ls -1 "$HOME/.nvm/versions/node" | sort -Vr); do
-      if "$HOME/.nvm/versions/node/$v/bin/node" -e 'process.exit(typeof [].toReversed==="function"?0:1)' 2>/dev/null; then
-        export PATH="$HOME/.nvm/versions/node/$v/bin:$PATH"
-        break
-      fi
-    done
-  fi
-fi
-if ! need_node; then
-  echo "ERROR: need Node >= 20 (found $(node -v 2>/dev/null || echo none)). Set NODE_BIN." >&2
-  exit 1
-fi
-echo "node=$(node -v)"
-
-# --- pick adb device -----------------------------------------------------
-adb_target=()
-if [ -n "${DEVICE:-}" ]; then
-  adb connect "$DEVICE" >/dev/null 2>&1 || true
-  adb_target=(-s "$DEVICE")
-fi
-
-# --- build ---------------------------------------------------------------
-echo "==> Building release APK (embeds JS bundle)…"
-( cd "$ANDROID_DIR" && ./gradlew :app:assembleRelease )
-
-if [ ! -f "$APK" ]; then
-  echo "ERROR: APK not found at $APK" >&2
-  exit 1
-fi
-echo "==> Built: $APK ($(du -h "$APK" | cut -f1))"
-
-[ "$DO_INSTALL" -eq 1 ] || { echo "Build-only mode; done."; exit 0; }
-
-# --- install -------------------------------------------------------------
-echo "==> Installing on device…"
-# Capture output instead of piping into `grep -q`: under `set -o pipefail`,
-# grep closing the pipe early can make a successful install report failure.
-install_out="$(adb "${adb_target[@]}" install -r "$APK" 2>&1)" || true
-echo "$install_out"
-if ! grep -q "Success" <<<"$install_out"; then
-  echo "==> Reinstall failed (likely signature mismatch); uninstalling and retrying…"
-  adb "${adb_target[@]}" uninstall "$APP_ID" >/dev/null 2>&1 || true
-  adb "${adb_target[@]}" install "$APK"
-fi
-
-[ "$DO_LAUNCH" -eq 1 ] || { echo "Installed (not launched)."; exit 0; }
-
-# --- launch --------------------------------------------------------------
-echo "==> Launching $MAIN_ACTIVITY…"
-adb "${adb_target[@]}" shell am start -n "$MAIN_ACTIVITY" >/dev/null
-echo "==> Done. The app runs standalone (no Metro needed)."

package/tsconfig.build.json

@@ -1,7 +0,0 @@
-{
-  "extends": "./tsconfig",
-  "compilerOptions": {
-    "noEmit": false
-  },
-  "exclude": ["example", "lib", "node_modules"]
-}

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "rootDir": ".",
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "jsx": "react-jsx",
-    "lib": ["ESNext", "DOM"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "noFallthroughCasesInSwitch": true,
-    "noImplicitReturns": true,
-    "resolveJsonModule": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "target": "ESNext",
-    "noEmit": true
-  },
-  "include": ["src"],
-  "exclude": ["example", "lib", "node_modules"]
-}