@whetware/react-native-stroke-text 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @whetware/react-native-stroke-text
+
+## 0.0.2
+
+### Patch Changes
+
+- [`fcaa6ab`](https://github.com/whetware/react-native-stroke-text/commit/fcaa6ab84fb191665d7561a7774e3641fac81fcb) Thanks [@evelant](https://github.com/evelant)! - Initial release

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Patrick Kabwe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NitroStrokeText.podspec

@@ -0,0 +1,31 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "NitroStrokeText"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported, :visionos => 1.0 }
+  s.source       = { :git => "https://github.com/whetware/react-native-stroke-text.git", :tag => "v#{s.version}" }
+
+  s.source_files = [
+    # Implementation (Swift)
+    "ios/**/*.{swift}",
+    # Autolinking/Registration (Objective-C++)
+    "ios/**/*.{m,mm}",
+    # Implementation (C++ objects)
+    "cpp/**/*.{hpp,cpp}",
+  ]
+
+  load 'nitrogen/generated/ios/NitroStrokeText+autolinking.rb'
+  add_nitrogen_files(s)
+
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,45 @@
+# `@whetware/react-native-stroke-text`
+
+Stroke/outline text for React Native, implemented as a **Nitro Hybrid View** (Fabric / New Architecture only).
+
+## Support
+
+- iOS: ✅ (Swift)
+- Android: ✅ (Kotlin)
+- Web: ✅ (JS fallback)
+- Old architecture: ❌ (not supported)
+
+## Installation
+
+```sh
+pnpm add @whetware/react-native-stroke-text react-native-nitro-modules
+```
+
+### Expo (managed)
+
+This package requires the **New Architecture**. Ensure it’s enabled in your app before installing.
+
+## Usage
+
+```tsx
+import { StrokeText } from '@whetware/react-native-stroke-text'
+
+export function Example() {
+  return (
+    <StrokeText
+      strokeWidth={4}
+      strokeColor="#000"
+      numberOfLines={1}
+      ellipsizeMode="tail"
+      style={{ fontSize: 48, fontWeight: '800', color: '#fff' }}
+    >
+      Hello
+    </StrokeText>
+  )
+}
+```
+
+## Development
+
+- Generate Nitro bindings: `pnpm specs`
+- Typecheck: `pnpm typecheck`

package/android/CMakeLists.txt

@@ -0,0 +1,29 @@
+project(NitroStrokeText)
+cmake_minimum_required(VERSION 3.9.0)
+
+set (PACKAGE_NAME NitroStrokeText)
+set (CMAKE_VERBOSE_MAKEFILE ON)
+set (CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED
+        src/main/cpp/cpp-adapter.cpp
+)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroStrokeText+autolinking.cmake)
+
+# Set up local includes
+include_directories(
+        "src/main/cpp"
+        "../cpp"
+)
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android                                   # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,142 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:9.0.0"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: "com.android.library"
+apply plugin: 'org.jetbrains.kotlin.android'
+apply from: '../nitrogen/generated/android/NitroStrokeText+autolinking.gradle'
+apply from: "./fix-prefab.gradle"
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["NitroStrokeText_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["NitroStrokeText_" + name]).toInteger()
+}
+
+android {
+  namespace "com.margelo.nitro.stroketext"
+
+  ndkVersion getExtOrDefault("ndkVersion")
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -Wextra -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+            "META-INF",
+            "META-INF/**",
+            "**/libc++_shared.so",
+            "**/libNitroModules.so",
+            "**/libfbjni.so",
+            "**/libjsi.so",
+            "**/libfolly_json.so",
+            "**/libfolly_runtime.so",
+            "**/libglog.so",
+            "**/libhermes.so",
+            "**/libhermes-executor-debug.so",
+            "**/libhermes_executor.so",
+            "**/libreactnative.so",
+            "**/libreactnativejni.so",
+            "**/libturbomodulejsijni.so",
+            "**/libreact_nativemodule_core.so",
+            "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      if (isNewArchitectureEnabled()) {
+        java.srcDirs += [
+          // React Codegen files
+          "${project.buildDir}/generated/source/codegen/java"
+        ]
+      }
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+
+dependencies {
+  // For < 0.71, this will be from the local maven repo
+  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
+  //noinspection GradleDynamicVersion
+  implementation "com.facebook.react:react-native:+"
+
+  // Add a dependency on NitroModules
+  implementation project(":react-native-nitro-modules")
+}
+

package/android/fix-prefab.gradle

@@ -0,0 +1,51 @@
+tasks.configureEach { task ->
+  // Make sure that we generate our prefab publication file only after having built the native library
+  // so that not a header publication file, but a full configuration publication will be generated, which
+  // will include the .so file
+
+  def prefabConfigurePattern = ~/^prefab(.+)ConfigurePackage$/
+  def matcher = task.name =~ prefabConfigurePattern
+  if (matcher.matches()) {
+    def variantName = matcher[0][1]
+    task.outputs.upToDateWhen { false }
+    task.dependsOn("externalNativeBuild${variantName}")
+  }
+}
+
+afterEvaluate {
+  def abis = reactNativeArchitectures()
+  rootProject.allprojects.each { proj ->
+    if (proj === rootProject) return
+
+    def dependsOnThisLib = proj.configurations.findAll { it.canBeResolved }.any { config ->
+      config.dependencies.any { dep ->
+        dep.group == project.group && dep.name == project.name
+      }
+    }
+    if (!dependsOnThisLib && proj != project) return
+
+    if (!proj.plugins.hasPlugin('com.android.application') && !proj.plugins.hasPlugin('com.android.library')) {
+      return
+    }
+
+    def variants = proj.android.hasProperty('applicationVariants') ? proj.android.applicationVariants : proj.android.libraryVariants
+    // Touch the prefab_config.json files to ensure that in ExternalNativeJsonGenerator.kt we will re-trigger the prefab CLI to
+    // generate a libnameConfig.cmake file that will contain our native library (.so).
+    // See this condition: https://cs.android.com/android-studio/platform/tools/base/+/mirror-goog-studio-main:build-system/gradle-core/src/main/java/com/android/build/gradle/tasks/ExternalNativeJsonGenerator.kt;l=207-219?q=createPrefabBuildSystemGlue
+    variants.all { variant ->
+      def variantName = variant.name
+      abis.each { abi ->
+        def searchDir = new File(proj.projectDir, ".cxx/${variantName}")
+        if (!searchDir.exists()) return
+        def matches = []
+        searchDir.eachDir { randomDir ->
+          def prefabFile = new File(randomDir, "${abi}/prefab_config.json")
+          if (prefabFile.exists()) matches << prefabFile
+        }
+        matches.each { prefabConfig ->
+          prefabConfig.setLastModified(System.currentTimeMillis())
+        }
+      }
+    }
+  }
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+NitroStrokeText_kotlinVersion=2.1.20
+NitroStrokeText_minSdkVersion=23
+NitroStrokeText_targetSdkVersion=36
+NitroStrokeText_compileSdkVersion=36
+NitroStrokeText_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "NitroStrokeTextOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::stroketext::initialize(vm);
+}

package/android/src/main/java/com/margelo/nitro/stroketext/HybridStrokeTextView.kt

@@ -0,0 +1,107 @@
+package com.margelo.nitro.stroketext
+
+import android.view.View
+import com.facebook.react.uimanager.ThemedReactContext
+
+class HybridStrokeTextView(context: ThemedReactContext) : HybridStrokeTextViewSpec() {
+  private val strokeTextView = StrokeTextView(context)
+  override val view: View = strokeTextView
+
+  override var text: String = ""
+  override var color: String? = null
+  override var strokeColor: String? = null
+  override var strokeWidth: Double? = null
+  override var fontSize: Double? = null
+  override var fontWeight: String? = null
+  override var fontFamily: String? = null
+  override var fontStyle: StrokeTextFontStyle? = null
+  override var lineHeight: Double? = null
+  override var letterSpacing: Double? = null
+  override var textAlign: StrokeTextAlign? = null
+  override var textDecorationLine: StrokeTextDecorationLine? = null
+  override var textTransform: StrokeTextTransform? = null
+  override var opacity: Double? = null
+  override var allowFontScaling: Boolean? = null
+  override var maxFontSizeMultiplier: Double? = null
+  override var includeFontPadding: Boolean? = null
+  override var numberOfLines: Double? = null
+  override var ellipsizeMode: StrokeTextEllipsizeMode? = null
+  override var padding: Double? = null
+  override var paddingVertical: Double? = null
+  override var paddingHorizontal: Double? = null
+  override var paddingTop: Double? = null
+  override var paddingRight: Double? = null
+  override var paddingBottom: Double? = null
+  override var paddingLeft: Double? = null
+
+  override fun afterUpdate() {
+    val displayMetrics = strokeTextView.resources.displayMetrics
+    val resolvedAllowFontScaling = allowFontScaling ?: true
+    val resolvedMaxFontSizeMultiplier =
+        maxFontSizeMultiplier
+            ?.toFloat()
+            ?.takeIf { it.isFinite() && it >= 1f }
+
+    strokeTextView.rawText = text
+
+    strokeTextView.color =
+        StrokeTextView.parseColor(color) ?: strokeTextView.resolvedDefaultTextColor()
+    strokeTextView.strokeColor = StrokeTextView.parseColor(strokeColor) ?: android.graphics.Color.TRANSPARENT
+    val resolvedStrokeWidth = (strokeWidth ?: 0.0).coerceAtLeast(0.0)
+    strokeTextView.strokeWidthDp = resolvedStrokeWidth
+    strokeTextView.strokeWidthPx =
+        StrokeTextView.dpToPx(
+            resolvedStrokeWidth.toFloat(),
+            displayMetrics,
+        )
+
+    strokeTextView.fontSizePx =
+        StrokeTextView.textToPx(
+            fontSize ?: 14.0,
+            resolvedAllowFontScaling,
+            resolvedMaxFontSizeMultiplier,
+            displayMetrics,
+        )
+    strokeTextView.fontWeight = fontWeight
+    strokeTextView.fontFamily = fontFamily
+    strokeTextView.fontStyle = fontStyle ?: StrokeTextFontStyle.NORMAL
+    strokeTextView.lineHeightPx =
+        lineHeight?.let {
+          StrokeTextView.textToPx(
+              it,
+              resolvedAllowFontScaling,
+              resolvedMaxFontSizeMultiplier,
+              displayMetrics,
+          )
+        }
+    strokeTextView.letterSpacingPx =
+        letterSpacing?.let {
+          StrokeTextView.textToPx(
+              it,
+              resolvedAllowFontScaling,
+              resolvedMaxFontSizeMultiplier,
+              displayMetrics,
+          )
+        }
+
+    strokeTextView.textAlign = textAlign ?: StrokeTextAlign.AUTO
+    strokeTextView.textDecorationLine = textDecorationLine ?: StrokeTextDecorationLine.NONE
+    strokeTextView.textTransform = textTransform ?: StrokeTextTransform.NONE
+
+    strokeTextView.includeFontPadding = includeFontPadding ?: false
+    strokeTextView.numberOfLines = (numberOfLines ?: 0.0).toInt()
+    strokeTextView.ellipsizeMode = ellipsizeMode
+
+    strokeTextView.paddingAllPx = padding?.let { StrokeTextView.dpToPx(it.toFloat(), displayMetrics) }
+    strokeTextView.paddingVerticalPx = paddingVertical?.let { StrokeTextView.dpToPx(it.toFloat(), displayMetrics) }
+    strokeTextView.paddingHorizontalPx = paddingHorizontal?.let { StrokeTextView.dpToPx(it.toFloat(), displayMetrics) }
+    strokeTextView.paddingTopPx = paddingTop?.let { StrokeTextView.dpToPx(it.toFloat(), displayMetrics) }
+    strokeTextView.paddingRightPx = paddingRight?.let { StrokeTextView.dpToPx(it.toFloat(), displayMetrics) }
+    strokeTextView.paddingBottomPx = paddingBottom?.let { StrokeTextView.dpToPx(it.toFloat(), displayMetrics) }
+    strokeTextView.paddingLeftPx = paddingLeft?.let { StrokeTextView.dpToPx(it.toFloat(), displayMetrics) }
+
+    strokeTextView.alpha = (opacity ?: 1.0).toFloat()
+
+    strokeTextView.invalidateTextLayout()
+  }
+}

package/android/src/main/java/com/margelo/nitro/stroketext/NitroStrokeTextPackage.kt

@@ -0,0 +1,39 @@
+package com.margelo.nitro.stroketext
+
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.ViewManagerOnDemandReactPackage
+import com.facebook.react.bridge.ModuleSpec
+import com.facebook.react.uimanager.ViewManager
+import com.margelo.nitro.stroketext.views.HybridStrokeTextViewManager
+
+class NitroStrokeTextPackage : BaseReactPackage(), ViewManagerOnDemandReactPackage {
+    private val viewManagers: Map<String, ModuleSpec> by lazy {
+        mapOf(
+            "StrokeTextView" to ModuleSpec.viewManagerSpec { HybridStrokeTextViewManager() }
+        )
+    }
+
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? = null
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider = ReactModuleInfoProvider { HashMap() }
+
+    override fun getViewManagers(reactContext: ReactApplicationContext): List<ModuleSpec> {
+        return viewManagers.values.toList()
+    }
+
+    override fun getViewManagerNames(reactContext: ReactApplicationContext): Collection<String> {
+        return viewManagers.keys
+    }
+
+    override fun createViewManager(reactContext: ReactApplicationContext, viewManagerName: String) =
+        viewManagers[viewManagerName]?.provider?.get() as? ViewManager<*, *>
+
+    companion object {
+        init {
+            NitroStrokeTextOnLoad.initializeNative()
+        }
+    }
+}