All notable changes to this project are documented here.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.3.0 - 2026-06-06
useDetectedEntities(text, options?)hook — reactive, debounced detection of a changing string (as-you-type). Returns{ entities, isDetecting, status, error }, is cancellation-safe (latest text wins), and manages model readiness internally.useDataDetectorhook — tracks model readiness (status/isReady/error), exposesdetect, and auto-downloads the model on Android (opt out withautoPrepare: false).getModelStatus()andisModelReady()to query whether a language model is downloaded. On iOS both always report ready.- Multi-language support on Android:
detect,prepareModel,getModelStatus,isModelReady, anduseDataDetectorall accept alanguageoption (ISO 639-1 code) selecting one of 15 ML Kit models. Defaults to'en'. Ignored on iOS.
- Renamed
downloadModel()toprepareModel()— clearer intent and now accepts a{ language }option.downloadModel()remains as a deprecated alias (targets the default'en'model) and will be removed in a future major version. - Ship an explicit
filesallowlist inpackage.jsonand drop the stale.npmignore; development config (ESLint, Prettier, EditorConfig, CONTRIBUTING) is no longer included in the published tarball. - README hero image now uses an absolute URL so it renders on npmjs.com.
- Corrected the minimum Android SDK to API 26. ML Kit Entity Extraction
(
entity-extraction:16.0.0-beta6) declaresminSdk 26, so apps atminSdk 24failed to build (manifest merge). The library's declaredminSdkVersionand the README requirement are now26. - iOS: return UTF-16 offsets from
NSDataDetectorinstead of grapheme-cluster distances, sostart/endalign with JavaScript string indices and Android's ML Kit char offsets. Previously mismatched on text containing emoji, accented, or non-BMP characters. - Android: read the library version from
package.jsoninstead of a hardcoded value, sobuild.gradlecan no longer drift from the published version.
- Initial public release: cross-platform text data detection using
NSDataDetectoron iOS and ML Kit Entity Extraction on Android.