@input-kit/phone 0.2.1 → 0.3.0

package/README.md

@@ -2,19 +2,15 @@
 
 Headless React phone input with a complete world country-code dataset, searchable country selection, and `libphonenumber-js` powered formatting and validation.
 
-## Latest update
+Source, issues, and contributions: **[github.com/harshit-d3v/input-kit-phone](https://github.com/harshit-d3v/input-kit-phone)**
 
-**0.2.0** highlights:
+## Latest update
 
-- Structured validation: `ValidationReason`, unified `validatePhoneNumber` (`reason`, `message`, `error`), and `onValidationChange` on the hook
-- `parsePhoneValue(phone, country?)` for `{ country, nationalNumber, e164, isValid }`
-- `getCountryOptions()` for sorted, filterable country lists (locale and allow/exclude lists)
-- `PhoneInput` click-outside close, improved listbox ARIA (`aria-activedescendant`), and RTL coverage in tests
-- Integration guide ([docs/integrations.md](./docs/integrations.md)), CI on Bun, and refreshed 0.1.x migration notes in this README
+**0.3.0** — auto-detect respects manual country selection, metadata-based length validation (no more false `too_long` in variable-length countries), input capped at the country's maximum length, `isPhoneTooLong()`, SSR-safe caret handling, dropdown `Home`/`End` + search→list keyboard navigation, unminified published output.
 
-Full release history: [CHANGELOG.md on GitHub](https://github.com/input-kit/input-kit-phone/blob/main/CHANGELOG.md) (not included in the npm package).
+**0.2.2** — npm README cleanup: release notes stay inline; removed pointers to repo-only markdown files.
 
-**0.2.1** — documentation only: README changelog link fix for npm readers.
+**0.2.0** — structured validation (`ValidationReason`, `validatePhoneNumber`, `onValidationChange`), `parsePhoneValue`, `getCountryOptions()`, improved `PhoneInput` a11y (click-outside, listbox ARIA) and RTL tests.
 
 ## Features
 
@@ -108,7 +104,7 @@ Formatting, length checks, and validity follow **[libphonenumber-js](https://www
 
 ## Form integrations
 
-See **[docs/integrations.md](./docs/integrations.md)** for React Hook Form, Formik, Zod, and controlled-input patterns.
+Controlled `value` / `onChange` with `usePhoneInput` or `PhoneInput`. React Hook Form: wrap with `Controller` and pass `field.value`, `field.onChange`, and `field.onBlur`. Use `onValidationChange` to sync `isValid` / `message` with form errors. Submit-time checks: `parsePhoneValue(phone, country)` or `validatePhoneNumber`.
 
 ## Styled example
 
@@ -145,6 +141,10 @@ bun run lint
 
 Manual browser check: `test-demo/` (static HTML).
 
+## Contributing
+
+Bug reports, feature requests, and pull requests are welcome — see [CONTRIBUTING.md](https://github.com/harshit-d3v/input-kit-phone/blob/main/CONTRIBUTING.md). In short: open an issue with a minimal reproduction (include the exact phone number and country for formatting/validation bugs), and for PRs run `bun run test`, `bun run typecheck`, and `bun run lint` before submitting.
+
 ## Exports
 
 ### Components and hooks