react-native-text-measure 1.0.0

package/README.md

@@ -0,0 +1,92 @@
+# react-native-text-measure
+
+> Accurately measure text `width`, `height`, and `lineCount` using native layout engines — no view rendered.
+
+| Platform | Engine | Accuracy |
+|----------|--------|----------|
+| iOS | `NSLayoutManager` (TextKit) | ✅ Identical to `UILabel` |
+| Android | `StaticLayout` | ✅ Identical to `TextView` |
+
+---
+
+## Installation
+
+```sh
+npm install react-native-text-measure
+# or
+yarn add react-native-text-measure
+```
+
+### iOS
+```sh
+cd ios && pod install
+```
+
+### Android
+Auto-linking handles it on RN >= 0.60. For manual linking see [`android/README.md`](android/README.md).
+
+---
+
+## Usage
+
+```js
+import { measureText, measureTextSync } from 'react-native-text-measure';
+
+// ── Async (recommended) ───────────────────────────────────────────────────────
+const { width, height, lineCount } = await measureText('Hello world', {
+  fontSize: 20,
+  fontFamily: 'Helvetica',
+  fontWeight: 'normal',
+  maxWidth: 300,
+});
+
+// ── Sync (use sparingly — blocks JS thread) ───────────────────────────────────
+const result = measureTextSync('Hello', { fontSize: 16 });
+```
+
+---
+
+## API
+
+### `measureText(text, options)` → `Promise<Result>`
+### `measureTextSync(text, options)` → `Result`
+
+#### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `fontSize` | `number` | `14` | Font size in dp/pt |
+| `fontFamily` | `string` | system | Font family name |
+| `fontWeight` | `string` | `'normal'` | `'normal'`, `'bold'`, `'100'`–`'900'` |
+| `fontStyle` | `string` | `'normal'` | `'normal'` or `'italic'` |
+| `letterSpacing` | `number` | `0` | Extra letter spacing in dp/pt |
+| `lineHeight` | `number` | `0` | Explicit line height. `0` = natural |
+| `maxWidth` | `number` | `0` | Wrap width. `0` = no wrap (single line) |
+| `maxHeight` | `number` | `0` | Clamp returned height. `0` = unclamped |
+| `numberOfLines` | `number` | `0` | Max lines. `0` = unlimited |
+| `includeFontPadding` | `boolean` | `true` | **Android only.** Match your `<Text>` setting |
+
+#### Result
+
+```ts
+{
+  width: number;     // dp (Android) / pt (iOS)
+  height: number;    // dp (Android) / pt (iOS)
+  lineCount: number;
+}
+```
+
+---
+
+## Accuracy notes
+
+- Results are **not estimates** — both engines perform a full layout pass.
+- `letterSpacing` unit differs between platforms (see inline comments).
+- `includeFontPadding` must match your `<Text>` component on Android.
+- If `fontFamily` is not found, the system font is used silently — measurement will be accurate but for the wrong font.
+
+---
+
+## License
+
+MIT

package/android/README.md

@@ -0,0 +1,14 @@
+README
+======
+
+If you want to publish the lib as a maven dependency, follow these steps before publishing a new version to npm:
+
+1. Be sure to have the Android [SDK](https://developer.android.com/studio/index.html) and [NDK](https://developer.android.com/ndk/guides/index.html) installed
+2. Be sure to have a `local.properties` file in this folder that points to the Android SDK and NDK
+```
+ndk.dir=/Users/{username}/Library/Android/sdk/ndk-bundle
+sdk.dir=/Users/{username}/Library/Android/sdk
+```
+3. Delete the `maven` folder
+4. Run `./gradlew installArchives`
+5. Verify that latest set of generated files is in the maven folder with the correct version number

package/android/build.gradle

@@ -0,0 +1,148 @@
+// android/build.gradle
+
+// based on:
+//
+// * https://github.com/facebook/react-native/blob/0.60-stable/template/android/build.gradle
+//   previous location:
+//   - https://github.com/facebook/react-native/blob/0.58-stable/local-cli/templates/HelloWorld/android/build.gradle
+//
+// * https://github.com/facebook/react-native/blob/0.60-stable/template/android/app/build.gradle
+//   previous location:
+//   - https://github.com/facebook/react-native/blob/0.58-stable/local-cli/templates/HelloWorld/android/app/build.gradle
+
+// These defaults should reflect the SDK versions used by
+// the minimum React Native version supported.
+def DEFAULT_COMPILE_SDK_VERSION = 28
+def DEFAULT_BUILD_TOOLS_VERSION = '28.0.3'
+def DEFAULT_MIN_SDK_VERSION = 16
+def DEFAULT_TARGET_SDK_VERSION = 28
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'maven'
+
+buildscript {
+    // The Android Gradle plugin is only required when opening the android folder stand-alone.
+    // This avoids unnecessary downloads and potential conflicts when the library is included as a
+    // module dependency in an application project.
+    // ref: https://docs.gradle.org/current/userguide/tutorial_using_tasks.html#sec:build_script_external_dependencies
+    if (project == rootProject) {
+        repositories {
+            google()
+        }
+        dependencies {
+            // This should reflect the Gradle plugin version used by
+            // the minimum React Native version supported.
+            classpath 'com.android.tools.build:gradle:3.4.1'
+        }
+    }
+}
+
+android {
+    compileSdkVersion safeExtGet('compileSdkVersion', DEFAULT_COMPILE_SDK_VERSION)
+    buildToolsVersion safeExtGet('buildToolsVersion', DEFAULT_BUILD_TOOLS_VERSION)
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', DEFAULT_MIN_SDK_VERSION)
+        targetSdkVersion safeExtGet('targetSdkVersion', DEFAULT_TARGET_SDK_VERSION)
+        versionCode 1
+        versionName "1.0"
+    }
+    lintOptions {
+        abortOnError false
+    }
+}
+
+repositories {
+    // ref: https://www.baeldung.com/maven-local-repository
+    mavenLocal()
+    maven {
+        // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
+        url "$rootDir/../node_modules/react-native/android"
+    }
+    maven {
+        // Android JSC is installed from npm
+        url "$rootDir/../node_modules/jsc-android/dist"
+    }
+    google()
+}
+
+dependencies {
+    //noinspection GradleDynamicVersion
+    implementation 'com.facebook.react:react-native:+'  // From node_modules
+}
+
+def configureReactNativePom(def pom) {
+    def packageJson = new groovy.json.JsonSlurper().parseText(file('../package.json').text)
+
+    pom.project {
+        name packageJson.title
+        artifactId packageJson.name
+        version = packageJson.version
+        group = "com.reactlibrary"
+        description packageJson.description
+        url packageJson.repository.baseUrl
+
+        licenses {
+            license {
+                name packageJson.license
+                url packageJson.repository.baseUrl + '/blob/master/' + packageJson.licenseFilename
+                distribution 'repo'
+            }
+        }
+
+        developers {
+            developer {
+                id packageJson.author.username
+                name packageJson.author.name
+            }
+        }
+    }
+}
+
+afterEvaluate { project ->
+    // some Gradle build hooks ref:
+    // https://www.oreilly.com/library/view/gradle-beyond-the/9781449373801/ch03.html
+    task androidJavadoc(type: Javadoc) {
+        source = android.sourceSets.main.java.srcDirs
+        classpath += files(android.bootClasspath)
+        classpath += files(project.getConfigurations().getByName('compile').asList())
+        include '**/*.java'
+    }
+
+    task androidJavadocJar(type: Jar, dependsOn: androidJavadoc) {
+        classifier = 'javadoc'
+        from androidJavadoc.destinationDir
+    }
+
+    task androidSourcesJar(type: Jar) {
+        classifier = 'sources'
+        from android.sourceSets.main.java.srcDirs
+        include '**/*.java'
+    }
+
+    android.libraryVariants.all { variant ->
+        def name = variant.name.capitalize()
+        def javaCompileTask = variant.javaCompileProvider.get()
+
+        task "jar${name}"(type: Jar, dependsOn: javaCompileTask) {
+            from javaCompileTask.destinationDir
+        }
+    }
+
+    artifacts {
+        archives androidSourcesJar
+        archives androidJavadocJar
+    }
+
+    task installArchives(type: Upload) {
+        configuration = configurations.archives
+        repositories.mavenDeployer {
+            // Deploy to react-native-event-bridge/maven, ready to publish to npm
+            repository url: "file://${projectDir}/../android/maven"
+            configureReactNativePom pom
+        }
+    }
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,6 @@
+<!-- AndroidManifest.xml -->
+
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.reactlibrary">
+
+</manifest>

package/android/src/main/java/com/reactlibrary/ReactNativeTextMeasureModule.java

@@ -0,0 +1,292 @@
+package com.reactlibrary;
+
+import android.graphics.Paint;
+import android.graphics.Typeface;
+import android.os.Build;
+import android.text.Layout;
+import android.text.StaticLayout;
+import android.text.TextPaint;
+import android.text.TextUtils;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.WritableMap;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+/**
+ * ReactNativeTextMeasureModule
+ *
+ * Measures text bounding dimensions (width, height, lineCount) using Android's
+ * StaticLayout — the same engine that TextView uses. No View is created or rendered.
+ *
+ * All input values are in density-independent pixels (dp).
+ * All output values are also in dp, matching React Native's coordinate system.
+ *
+ * JS API:
+ *   measureText(text, options)      → Promise<{ width, height, lineCount }>
+ *   measureTextSync(text, options)  → { width, height, lineCount }
+ */
+public class ReactNativeTextMeasureModule extends ReactContextBaseJavaModule {
+
+    private final ReactApplicationContext reactContext;
+
+    public ReactNativeTextMeasureModule(ReactApplicationContext context) {
+        super(context);
+        this.reactContext = context;
+    }
+
+    @NonNull
+    @Override
+    public String getName() {
+        // Must match NativeModules.ReactNativeTextMeasure on the JS side
+        return "ReactNativeTextMeasure";
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // JS-callable: async (recommended)
+    // ─────────────────────────────────────────────────────────────────────────
+
+    /**
+     * Async measurement. Resolves with { width, height, lineCount }.
+     * Runs on the React Native background thread pool — does not block JS.
+     */
+    @ReactMethod
+    public void measureText(String text, ReadableMap options, Promise promise) {
+        try {
+            promise.resolve(performMeasure(text, options));
+        } catch (Exception e) {
+            promise.reject("MEASURE_ERROR", e.getMessage(), e);
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // JS-callable: synchronous
+    // ─────────────────────────────────────────────────────────────────────────
+
+    /**
+     * Synchronous measurement. Returns { width, height, lineCount } directly.
+     *
+     * ⚠️  Runs on the JS thread. Use only when async is not an option.
+     *     For old architecture: isBlockingSynchronousMethod = true is required.
+     *     For new architecture (TurboModules): implement NativeReactNativeTextMeasureSpec.
+     */
+    @ReactMethod(isBlockingSynchronousMethod = true)
+    public WritableMap measureTextSync(String text, ReadableMap options) {
+        try {
+            return performMeasure(text, options);
+        } catch (Exception e) {
+            WritableMap error = Arguments.createMap();
+            error.putString("error", e.getMessage());
+            return error;
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Core measurement — called by both async and sync entry points
+    // ─────────────────────────────────────────────────────────────────────────
+
+    private WritableMap performMeasure(@Nullable String text, @Nullable ReadableMap options) {
+        if (text == null) text = "";
+        if (options == null) options = Arguments.createMap();
+
+        // ── 1. Parse options ─────────────────────────────────────────────────
+        float   fontSize         = getFloat(options, "fontSize",         14f);
+        String  fontFamily       = getString(options, "fontFamily",       null);
+        String  fontWeight       = getString(options, "fontWeight",       "normal");
+        String  fontStyle        = getString(options, "fontStyle",        "normal");
+        float   letterSpacing    = getFloat(options, "letterSpacing",     0f);
+        float   lineHeight       = getFloat(options, "lineHeight",        0f);
+        float   maxWidth         = getFloat(options, "maxWidth",          0f);
+        float   maxHeight        = getFloat(options, "maxHeight",         0f);
+        int     numberOfLines    = getInt(options,   "numberOfLines",     0);
+        boolean includeFontPad   = getBool(options,  "includeFontPadding", true);
+
+        // ── 2. dp → px conversion ─────────────────────────────────────────────
+        // React Native uses dp everywhere; Android Paint/StaticLayout needs px.
+        float density      = reactContext.getResources().getDisplayMetrics().density;
+        float fontSizePx   = fontSize   * density;
+        float lineHeightPx = lineHeight * density;
+        int   maxWidthPx   = (maxWidth  > 0) ? Math.round(maxWidth  * density) : Integer.MAX_VALUE;
+        int   maxHeightPx  = (maxHeight > 0) ? Math.round(maxHeight * density) : Integer.MAX_VALUE;
+
+        // ── 3. Resolve Typeface ───────────────────────────────────────────────
+        boolean isBold   = "bold".equalsIgnoreCase(fontWeight) || numericWeightIsBold(fontWeight);
+        boolean isItalic = "italic".equalsIgnoreCase(fontStyle);
+
+        int typefaceStyle;
+        if (isBold && isItalic) typefaceStyle = Typeface.BOLD_ITALIC;
+        else if (isBold)        typefaceStyle = Typeface.BOLD;
+        else if (isItalic)      typefaceStyle = Typeface.ITALIC;
+        else                    typefaceStyle = Typeface.NORMAL;
+
+        Typeface typeface = resolveTypeface(fontFamily, typefaceStyle);
+
+        // ── 4. Build TextPaint ────────────────────────────────────────────────
+        TextPaint paint = new TextPaint(Paint.ANTI_ALIAS_FLAG);
+        paint.setTextSize(fontSizePx);
+        paint.setTypeface(typeface);
+
+        // letterSpacing: Android uses EM fractions; convert from dp.
+        // letterSpacing_em = letterSpacing_px / fontSizePx
+        // We treat the user's value as dp, so first dp→px, then →em.
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP && letterSpacing != 0f) {
+            float letterSpacingPx = letterSpacing * density;
+            paint.setLetterSpacing(letterSpacingPx / fontSizePx);
+        }
+
+        // ── 5. Build StaticLayout ─────────────────────────────────────────────
+        //
+        //  StaticLayout is the exact engine TextView uses for static (non-editable) text.
+        //  It performs full Unicode line-breaking, glyph shaping, and produces the real
+        //  pixel-accurate dimensions — not an estimate.
+        //
+        StaticLayout layout = buildStaticLayout(
+                text, paint, maxWidthPx,
+                lineHeightPx, numberOfLines, includeFontPad
+        );
+
+        // ── 6. Extract dimensions ─────────────────────────────────────────────
+        int    lineCount      = layout.getLineCount();
+        float  measuredHeight = layout.getHeight();
+        float  measuredWidth  = 0f;
+
+        for (int i = 0; i < lineCount; i++) {
+            float lineWidth = layout.getLineWidth(i);
+            if (lineWidth > measuredWidth) measuredWidth = lineWidth;
+        }
+
+        // Clamp height if maxHeight was provided
+        if (maxHeightPx != Integer.MAX_VALUE && measuredHeight > maxHeightPx) {
+            measuredHeight = maxHeightPx;
+        }
+
+        // ── 7. px → dp for output ─────────────────────────────────────────────
+        WritableMap result = Arguments.createMap();
+        result.putDouble("width",     measuredWidth  / density);
+        result.putDouble("height",    measuredHeight / density);
+        result.putInt(   "lineCount", lineCount);
+        return result;
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // StaticLayout builder — handles API version differences
+    // ─────────────────────────────────────────────────────────────────────────
+
+    @SuppressWarnings("deprecation")
+    private StaticLayout buildStaticLayout(
+            String text,
+            TextPaint paint,
+            int maxWidthPx,
+            float lineHeightPx,
+            int numberOfLines,
+            boolean includeFontPad
+    ) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+            // API 23+ — use the Builder (clean, full-featured)
+            StaticLayout.Builder builder = StaticLayout.Builder
+                    .obtain(text, 0, text.length(), paint, maxWidthPx)
+                    .setAlignment(Layout.Alignment.ALIGN_NORMAL)
+                    .setIncludePad(includeFontPad)
+                    .setMaxLines(numberOfLines > 0 ? numberOfLines : Integer.MAX_VALUE)
+                    .setEllipsize(numberOfLines > 0 ? TextUtils.TruncateAt.END : null);
+
+            if (lineHeightPx > 0) {
+                // Android line spacing: total_line_height = naturalLineHeight * mult + add
+                // We want total = lineHeightPx, so: add = lineHeightPx - natural, mult = 1
+                float naturalLineHeight = -paint.ascent() + paint.descent();
+                builder.setLineSpacing(lineHeightPx - naturalLineHeight, 1f);
+            } else {
+                builder.setLineSpacing(0f, 1f);
+            }
+
+            return builder.build();
+
+        } else {
+            // API 21–22 fallback — deprecated constructor but still accurate
+            float spacingAdd  = 0f;
+            float spacingMult = 1f;
+
+            if (lineHeightPx > 0) {
+                float naturalLineHeight = -paint.ascent() + paint.descent();
+                spacingAdd = lineHeightPx - naturalLineHeight;
+            }
+
+            return new StaticLayout(
+                    text, 0, text.length(),
+                    paint, maxWidthPx,
+                    Layout.Alignment.ALIGN_NORMAL,
+                    spacingMult, spacingAdd,
+                    includeFontPad,
+                    numberOfLines > 0 ? TextUtils.TruncateAt.END : null,
+                    maxWidthPx
+            );
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Typeface resolution
+    // ─────────────────────────────────────────────────────────────────────────
+
+    private Typeface resolveTypeface(@Nullable String fontFamily, int style) {
+        if (fontFamily != null && !fontFamily.isEmpty()) {
+            // 1. Try assets/fonts/<fontFamily>.ttf  (common RN convention)
+            try {
+                Typeface fromAssets = Typeface.createFromAsset(
+                        reactContext.getAssets(),
+                        "fonts/" + fontFamily + ".ttf"
+                );
+                if (fromAssets != null) {
+                    return Typeface.create(fromAssets, style);
+                }
+            } catch (Exception ignored) { /* not in assets */ }
+
+            // 2. Try as a system font name (e.g. "sans-serif", "monospace", "Roboto")
+            try {
+                Typeface systemFont = Typeface.create(fontFamily, style);
+                if (systemFont != null) return systemFont;
+            } catch (Exception ignored) { /* unknown family */ }
+        }
+
+        // 3. Default system font with the requested style
+        return Typeface.create((String) null, style);
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // ReadableMap helpers (null-safe)
+    // ─────────────────────────────────────────────────────────────────────────
+
+    private float getFloat(ReadableMap map, String key, float def) {
+        if (map.hasKey(key) && !map.isNull(key)) return (float) map.getDouble(key);
+        return def;
+    }
+
+    private int getInt(ReadableMap map, String key, int def) {
+        if (map.hasKey(key) && !map.isNull(key)) return map.getInt(key);
+        return def;
+    }
+
+    private boolean getBool(ReadableMap map, String key, boolean def) {
+        if (map.hasKey(key) && !map.isNull(key)) return map.getBoolean(key);
+        return def;
+    }
+
+    @Nullable
+    private String getString(ReadableMap map, String key, @Nullable String def) {
+        if (map.hasKey(key) && !map.isNull(key)) return map.getString(key);
+        return def;
+    }
+
+    private boolean numericWeightIsBold(String weight) {
+        try {
+            return Integer.parseInt(weight.trim()) >= 600;
+        } catch (NumberFormatException e) {
+            return false;
+        }
+    }
+}

package/android/src/main/java/com/reactlibrary/ReactNativeTextMeasurePackage.java

@@ -0,0 +1,44 @@
+package com.reactlibrary;
+
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * ReactNativeTextMeasurePackage
+ *
+ * Registers ReactNativeTextMeasureModule with the React Native bridge.
+ *
+ * Add to your MainApplication.java:
+ *
+ *   @Override
+ *   protected List<ReactPackage> getPackages() {
+ *     return Arrays.<ReactPackage>asList(
+ *       new MainReactPackage(),
+ *       new ReactNativeTextMeasurePackage()   // ← add this line
+ *     );
+ *   }
+ *
+ * If you are on RN >= 0.60 with auto-linking enabled, you do NOT need to
+ * manually add the package — it will be registered automatically via
+ * react-native.config.js.
+ */
+public class ReactNativeTextMeasurePackage implements ReactPackage {
+
+    @Override
+    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
+        return Arrays.<NativeModule>asList(
+            new ReactNativeTextMeasureModule(reactContext)
+        );
+    }
+
+    @Override
+    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
+        return Collections.emptyList();
+    }
+}

package/index.js

@@ -0,0 +1,115 @@
+/**
+ * react-native-text-measure
+ *
+ * Accurately measures text dimensions using native layout engines.
+ * iOS  → NSLayoutManager (TextKit)   — identical to UILabel
+ * Android → StaticLayout             — identical to TextView
+ *
+ * No view is rendered. Measurement is pure native computation.
+ */
+
+import { NativeModules } from "react-native";
+
+const LINKING_ERROR =
+  `react-native-text-measure: Native module not found.\n\n` +
+  `iOS:     Make sure you ran \`pod install\` and the .m file is in your Xcode project.\n` +
+  `Android: Make sure ReactNativeTextMeasurePackage is registered in MainApplication.\n\n` +
+  `If you are using React Native >= 0.60, auto-linking should handle this.\n` +
+  `Try rebuilding the app.`;
+
+const NativeTextMeasure = NativeModules.ReactNativeTextMeasure
+  ? NativeModules.ReactNativeTextMeasure
+  : new Proxy(
+      {},
+      {
+        get() {
+          throw new Error(LINKING_ERROR);
+        },
+      },
+    );
+
+// ─────────────────────────────────────────────────────────────────────────────
+// JSDoc typedef (works in plain JS + IDEs; see index.d.ts for TypeScript)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * @typedef {Object} TextMeasureOptions
+ * @property {number}  [fontSize=14]        - Font size in dp (Android) / pt (iOS).
+ * @property {string}  [fontFamily]         - Font family name. Falls back to system font.
+ * @property {string}  [fontWeight='normal']- 'normal' | 'bold' | '100'–'900'.
+ * @property {string}  [fontStyle='normal'] - 'normal' | 'italic'.
+ * @property {number}  [letterSpacing=0]    - Extra letter spacing in dp/pt.
+ * @property {number}  [lineHeight=0]       - Explicit line height. 0 = natural.
+ * @property {number}  [maxWidth=0]         - Wrap width. 0 = no wrapping.
+ * @property {number}  [maxHeight=0]        - Clamp height. 0 = unclamped.
+ * @property {number}  [numberOfLines=0]    - Max lines. 0 = unlimited.
+ * @property {boolean} [includeFontPadding=true] - Android only: match RN Text default.
+ */
+
+/**
+ * @typedef {Object} TextMeasureResult
+ * @property {number} width     - Measured width in dp (Android) / pt (iOS).
+ * @property {number} height    - Measured height in dp (Android) / pt (iOS).
+ * @property {number} lineCount - Number of lines the text was laid out into.
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Asynchronously measures the bounding box of `text` with the given style options.
+ * Runs off the JS thread — safe to call frequently.
+ *
+ * @param {string} text
+ * @param {TextMeasureOptions} [options={}]
+ * @returns {Promise<TextMeasureResult>}
+ *
+ * @example
+ * const { width, height, lineCount } = await measureText('Hello world', {
+ *   fontSize: 20,
+ *   fontFamily: 'Helvetica',
+ *   fontWeight: 'normal',
+ *   maxWidth: 200,
+ * });
+ */
+export function measureText(text, options = {}) {
+  return NativeTextMeasure.measureText(String(text), sanitize(options));
+}
+
+/**
+ * Synchronously measures text. Runs on the JS thread.
+ * ⚠️  Prefer `measureText` (async). Use this only when you cannot await
+ *     (e.g., inside a synchronous layout calculation).
+ *
+ * @param {string} text
+ * @param {TextMeasureOptions} [options={}]
+ * @returns {TextMeasureResult}
+ *
+ * @example
+ * const { height } = measureTextSync('Hello', { fontSize: 16 });
+ */
+export function measureTextSync(text, options = {}) {
+  return NativeTextMeasure.measureTextSync(String(text), sanitize(options));
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Remove undefined keys so the native side receives a clean map.
+ * @param {TextMeasureOptions} options
+ * @returns {Object}
+ */
+function sanitize(options) {
+  const out = {};
+  for (const [key, value] of Object.entries(options)) {
+    if (value !== undefined && value !== null) {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+
+export default { measureText, measureTextSync };

package/ios/ReactNativeTextMeasure.h

@@ -0,0 +1,19 @@
+#import <React/RCTBridgeModule.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * ReactNativeTextMeasure
+ *
+ * Native module that measures text bounding dimensions (width, height, lineCount)
+ * using Apple's TextKit layout engine — identical to UILabel / UITextView rendering.
+ * No view is created or rendered.
+ *
+ * Exposes two JS methods:
+ *   measureText(text, options)     → Promise  (async, background thread)
+ *   measureTextSync(text, options) → Object   (sync,  JS thread)
+ */
+@interface ReactNativeTextMeasure : NSObject <RCTBridgeModule>
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/ReactNativeTextMeasure.m

@@ -0,0 +1,204 @@
+#import "ReactNativeTextMeasure.h"
+#import <UIKit/UIKit.h>
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Private helper — builds the measurement result dict from a string + options.
+// Extracted so both the async and sync entry-points share identical logic.
+// ─────────────────────────────────────────────────────────────────────────────
+static NSDictionary *RNTMPerformMeasure(NSString *text, NSDictionary *options) {
+
+  // ── 1. Parse options ───────────────────────────────────────────────────────
+  CGFloat   fontSize      = options[@"fontSize"]      ? [options[@"fontSize"]      doubleValue] : 14.0;
+  NSString *fontFamily    = options[@"fontFamily"];
+  NSString *fontWeight    = options[@"fontWeight"]    ?: @"normal";
+  NSString *fontStyle     = options[@"fontStyle"]     ?: @"normal";
+  CGFloat   letterSpacing = options[@"letterSpacing"] ? [options[@"letterSpacing"] doubleValue] : 0.0;
+  CGFloat   lineHeight    = options[@"lineHeight"]    ? [options[@"lineHeight"]    doubleValue] : 0.0;
+  CGFloat   maxWidth      = options[@"maxWidth"]      ? [options[@"maxWidth"]      doubleValue] : 0.0;
+  CGFloat   maxHeight     = options[@"maxHeight"]     ? [options[@"maxHeight"]     doubleValue] : 0.0;
+  NSInteger maxLines      = options[@"numberOfLines"] ? [options[@"numberOfLines"] integerValue]: 0;
+
+  if (maxWidth  <= 0) maxWidth  = CGFLOAT_MAX;
+  if (maxHeight <= 0) maxHeight = CGFLOAT_MAX;
+
+  // ── 2. Resolve UIFontWeight ────────────────────────────────────────────────
+  UIFontWeight uiFontWeight = UIFontWeightRegular;
+  NSDictionary *weightMap = @{
+    @"100": @(UIFontWeightUltraLight),
+    @"200": @(UIFontWeightThin),
+    @"300": @(UIFontWeightLight),
+    @"400": @(UIFontWeightRegular),
+    @"500": @(UIFontWeightMedium),
+    @"600": @(UIFontWeightSemibold),
+    @"700": @(UIFontWeightBold),
+    @"800": @(UIFontWeightHeavy),
+    @"900": @(UIFontWeightBlack),
+    @"bold": @(UIFontWeightBold),
+    @"normal": @(UIFontWeightRegular),
+  };
+  if (weightMap[fontWeight]) {
+    uiFontWeight = [weightMap[fontWeight] doubleValue];
+  }
+
+  BOOL isItalic = [fontStyle isEqualToString:@"italic"];
+
+  // ── 3. Build UIFont ────────────────────────────────────────────────────────
+  UIFont *font = nil;
+
+  if (fontFamily.length > 0) {
+    // Build a descriptor for the requested family so we can apply traits
+    UIFontDescriptor *descriptor = [UIFontDescriptor fontDescriptorWithName:fontFamily size:fontSize];
+
+    UIFontDescriptorSymbolicTraits traits = 0;
+    if (uiFontWeight >= UIFontWeightBold) traits |= UIFontDescriptorTraitBold;
+    if (isItalic)                         traits |= UIFontDescriptorTraitItalic;
+
+    if (traits != 0) {
+      UIFontDescriptor *traitDescriptor = [descriptor fontDescriptorWithSymbolicTraits:traits];
+      // fontDescriptorWithSymbolicTraits returns nil if the traits can't be satisfied
+      if (traitDescriptor) descriptor = traitDescriptor;
+    }
+
+    font = [UIFont fontWithDescriptor:descriptor size:fontSize];
+  }
+
+  // Fallback: system font (always available)
+  if (!font) {
+    if (isItalic) {
+      UIFontDescriptor *sysDesc = [[UIFont systemFontOfSize:fontSize weight:uiFontWeight] fontDescriptor];
+      UIFontDescriptor *italicDesc = [sysDesc fontDescriptorWithSymbolicTraits:UIFontDescriptorTraitItalic];
+      font = italicDesc ? [UIFont fontWithDescriptor:italicDesc size:fontSize]
+                        : [UIFont systemFontOfSize:fontSize weight:uiFontWeight];
+    } else {
+      font = [UIFont systemFontOfSize:fontSize weight:uiFontWeight];
+    }
+  }
+
+  // Ultimate fallback
+  if (!font) font = [UIFont systemFontOfSize:fontSize];
+
+  // ── 4. Build paragraph style ───────────────────────────────────────────────
+  NSMutableParagraphStyle *paraStyle = [[NSMutableParagraphStyle alloc] init];
+  paraStyle.lineBreakMode = NSLineBreakByWordWrapping;
+
+  if (lineHeight > 0.0) {
+    // Setting both min and max to the same value gives an exact line height,
+    // which matches React Native's lineHeight prop behaviour.
+    paraStyle.minimumLineHeight = lineHeight;
+    paraStyle.maximumLineHeight = lineHeight;
+  }
+
+  // ── 5. Build attributed string ─────────────────────────────────────────────
+  NSMutableDictionary *attrs = [@{
+    NSFontAttributeName:            font,
+    NSParagraphStyleAttributeName:  paraStyle,
+  } mutableCopy];
+
+  if (letterSpacing != 0.0) {
+    // NSKernAttributeName is in points — same unit as fontSize on iOS.
+    attrs[NSKernAttributeName] = @(letterSpacing);
+  }
+
+  NSString *safeText = (text.length > 0) ? text : @"";
+  NSAttributedString *attrString = [[NSAttributedString alloc] initWithString:safeText
+                                                                   attributes:attrs];
+
+  // ── 6. TextKit layout ──────────────────────────────────────────────────────
+  //
+  //  We use the full TextKit stack (NSTextStorage → NSLayoutManager → NSTextContainer)
+  //  rather than boundingRectWithSize:options:context: because:
+  //    • It correctly handles numberOfLines (via maximumNumberOfLines).
+  //    • It gives us a real lineCount via enumerateLineFragments.
+  //    • It is the same engine UILabel uses internally.
+  //
+  NSTextStorage   *storage   = [[NSTextStorage alloc] initWithAttributedString:attrString];
+  NSLayoutManager *manager   = [[NSLayoutManager alloc] init];
+  NSTextContainer *container = [[NSTextContainer alloc] initWithSize:CGSizeMake(maxWidth, maxHeight)];
+
+  container.lineFragmentPadding  = 0.0;   // no extra horizontal padding
+  container.lineBreakMode        = NSLineBreakByWordWrapping;
+  if (maxLines > 0) container.maximumNumberOfLines = (NSUInteger)maxLines;
+
+  [manager addTextContainer:container];
+  [storage addLayoutManager:manager];
+
+  // Force complete layout pass
+  [manager ensureLayoutForTextContainer:container];
+
+  CGRect usedRect = [manager usedRectForTextContainer:container];
+
+  // Count lines by enumerating actual line fragments
+  __block NSInteger lineCount = 0;
+  NSRange glyphRange = [manager glyphRangeForTextContainer:container];
+  [manager enumerateLineFragmentsForGlyphRange:glyphRange
+                                    usingBlock:^(CGRect rect,
+                                                 CGRect usedLineRect,
+                                                 NSTextContainer *tc,
+                                                 NSRange glyphRng,
+                                                 BOOL *stop) {
+    lineCount++;
+  }];
+
+  // ceil to avoid sub-pixel gaps when the caller uses these values for layout
+  CGFloat measuredWidth  = ceil(usedRect.size.width);
+  CGFloat measuredHeight = ceil(usedRect.size.height);
+
+  return @{
+    @"width":     @(measuredWidth),
+    @"height":    @(measuredHeight),
+    @"lineCount": @(lineCount),
+  };
+}
+
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Module
+// ─────────────────────────────────────────────────────────────────────────────
+
+@implementation ReactNativeTextMeasure
+
+RCT_EXPORT_MODULE()
+
+// ── Async (recommended) ───────────────────────────────────────────────────────
+/**
+ * measureText(text, options) → Promise<{ width, height, lineCount }>
+ *
+ * Runs on a background serial queue — does NOT block the JS thread.
+ */
+RCT_EXPORT_METHOD(measureText:(NSString *)text
+                     options:(NSDictionary *)options
+                    resolver:(RCTPromiseResolveBlock)resolve
+                    rejecter:(RCTPromiseRejectBlock)reject)
+{
+  // Capture to avoid potential mutation
+  NSString     *capturedText    = [text copy];
+  NSDictionary *capturedOptions = [options copy];
+
+  dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
+    @try {
+      NSDictionary *result = RNTMPerformMeasure(capturedText, capturedOptions ?: @{});
+      resolve(result);
+    } @catch (NSException *exception) {
+      reject(@"MEASURE_ERROR", exception.reason, nil);
+    }
+  });
+}
+
+// ── Synchronous (use sparingly) ───────────────────────────────────────────────
+/**
+ * measureTextSync(text, options) → { width, height, lineCount }
+ *
+ * Runs on the JS thread. Safe for use in synchronous layout code but
+ * will block JS execution for the duration of the measurement.
+ */
+RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(measureTextSync:(NSString *)text
+                                              options:(NSDictionary *)options)
+{
+  @try {
+    return RNTMPerformMeasure(text ?: @"", options ?: @{});
+  } @catch (NSException *exception) {
+    return @{ @"error": exception.reason ?: @"Unknown error" };
+  }
+}
+
+@end

package/ios/ReactNativeTextMeasure.xcodeproj/project.pbxproj

@@ -0,0 +1,281 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 46;
+	objects = {
+
+/* Begin PBXCopyFilesBuildPhase section */
+		58B511D91A9E6C8500147676 /* CopyFiles */ = {
+			isa = PBXCopyFilesBuildPhase;
+			buildActionMask = 2147483647;
+			dstPath = "include/$(PRODUCT_NAME)";
+			dstSubfolderSpec = 16;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXCopyFilesBuildPhase section */
+
+/* Begin PBXFileReference section */
+		134814201AA4EA6300B7C361 /* libReactNativeTextMeasure.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libReactNativeTextMeasure.a; sourceTree = BUILT_PRODUCTS_DIR; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		58B511D81A9E6C8500147676 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		134814211AA4EA7D00B7C361 /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				134814201AA4EA6300B7C361 /* libReactNativeTextMeasure.a */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		58B511D21A9E6C8500147676 = {
+			isa = PBXGroup;
+			children = (
+				134814211AA4EA7D00B7C361 /* Products */,
+			);
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		58B511DA1A9E6C8500147676 /* ReactNativeTextMeasure */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 58B511EF1A9E6C8500147676 /* Build configuration list for PBXNativeTarget "ReactNativeTextMeasure" */;
+			buildPhases = (
+				58B511D71A9E6C8500147676 /* Sources */,
+				58B511D81A9E6C8500147676 /* Frameworks */,
+				58B511D91A9E6C8500147676 /* CopyFiles */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = ReactNativeTextMeasure;
+			productName = RCTDataManager;
+			productReference = 134814201AA4EA6300B7C361 /* libReactNativeTextMeasure.a */;
+			productType = "com.apple.product-type.library.static";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		58B511D31A9E6C8500147676 /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				LastUpgradeCheck = 0920;
+				ORGANIZATIONNAME = Facebook;
+				TargetAttributes = {
+					58B511DA1A9E6C8500147676 = {
+						CreatedOnToolsVersion = 6.1.1;
+					};
+				};
+			};
+			buildConfigurationList = 58B511D61A9E6C8500147676 /* Build configuration list for PBXProject "ReactNativeTextMeasure" */;
+			compatibilityVersion = "Xcode 3.2";
+			developmentRegion = en;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+				Base,
+			);
+			mainGroup = 58B511D21A9E6C8500147676;
+			productRefGroup = 58B511D21A9E6C8500147676;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				58B511DA1A9E6C8500147676 /* ReactNativeTextMeasure */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXSourcesBuildPhase section */
+		58B511D71A9E6C8500147676 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin XCBuildConfiguration section */
+		58B511ED1A9E6C8500147676 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_SYMBOLS_PRIVATE_EXTERN = NO;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 9.0;
+				LD_RUNPATH_SEARCH_PATHS = "/usr/lib/swift $(inherited)";
+				LIBRARY_SEARCH_PATHS = (
+					"\"$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)\"",
+					"\"$(TOOLCHAIN_DIR)/usr/lib/swift-5.0/$(PLATFORM_NAME)\"",
+					"\"$(inherited)\"",
+				);
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+			};
+			name = Debug;
+		};
+		58B511EE1A9E6C8500147676 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = YES;
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 9.0;
+				LD_RUNPATH_SEARCH_PATHS = "/usr/lib/swift $(inherited)";
+				LIBRARY_SEARCH_PATHS = (
+					"\"$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)\"",
+					"\"$(TOOLCHAIN_DIR)/usr/lib/swift-5.0/$(PLATFORM_NAME)\"",
+					"\"$(inherited)\"",
+				);
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				VALIDATE_PRODUCT = YES;
+			};
+			name = Release;
+		};
+		58B511F01A9E6C8500147676 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				HEADER_SEARCH_PATHS = (
+					"$(inherited)",
+					/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include,
+					"$(SRCROOT)/../../../React/**",
+					"$(SRCROOT)/../../react-native/React/**",
+				);
+				LIBRARY_SEARCH_PATHS = "$(inherited)";
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = ReactNativeTextMeasure;
+				SKIP_INSTALL = YES;
+			};
+			name = Debug;
+		};
+		58B511F11A9E6C8500147676 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				HEADER_SEARCH_PATHS = (
+					"$(inherited)",
+					/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include,
+					"$(SRCROOT)/../../../React/**",
+					"$(SRCROOT)/../../react-native/React/**",
+				);
+				LIBRARY_SEARCH_PATHS = "$(inherited)";
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = ReactNativeTextMeasure;
+				SKIP_INSTALL = YES;
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		58B511D61A9E6C8500147676 /* Build configuration list for PBXProject "ReactNativeTextMeasure" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				58B511ED1A9E6C8500147676 /* Debug */,
+				58B511EE1A9E6C8500147676 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		58B511EF1A9E6C8500147676 /* Build configuration list for PBXNativeTarget "ReactNativeTextMeasure" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				58B511F01A9E6C8500147676 /* Debug */,
+				58B511F11A9E6C8500147676 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = 58B511D31A9E6C8500147676 /* Project object */;
+}

package/ios/ReactNativeTextMeasure.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "group:ReactNativeTextMeasure.xcodeproj">
+   </FileRef>
+</Workspace>

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "react-native-text-measure",
+  "version": "1.0.0",
+  "description": "Accurately measure text dimensions (width, height, lineCount) using native text layout engines — no view rendered.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AminAllahham/react-native-text-measure.git"
+  },
+  "keywords": [
+    "react-native",
+    "text",
+    "measure",
+    "height",
+    "width",
+    "layout",
+    "native-module"
+  ],
+  "author": "Amin Allahham <amin.allahham9@gmail.com>",
+  "license": "MIT",
+  "peerDependencies": {
+    "react-native": ">=0.60.0"
+  },
+  "devDependencies": {
+    "react-native": "^0.73.0"
+  }
+}

package/react-native-text-measure.podspec

@@ -0,0 +1,30 @@
+# react-native-text-measure.podspec
+
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-text-measure"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.description  = <<-DESC
+                  react-native-text-measure
+                   DESC
+  s.homepage     = "https://github.com/github_account/react-native-text-measure"
+  # brief license entry:
+  s.license      = "MIT"
+  # optional - use expanded license entry instead:
+  # s.license    = { :type => "MIT", :file => "LICENSE" }
+  s.authors      = { "Your Name" => "yourname@email.com" }
+  s.platforms    = { :ios => "9.0" }
+  s.source       = { :git => "https://github.com/github_account/react-native-text-measure.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,c,cc,cpp,m,mm,swift}"
+  s.requires_arc = true
+
+  s.dependency "React"
+  # ...
+  # s.dependency "..."
+end
+