@handijit/tr 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this package are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-11-10
+
+First public release.
+
+### Added
+
+- **Text:** `toUpperCase`, `toLowerCase`, `capitalize` and `toTitleCase` with
+  the Turkish rule for "i" and "ı", independent of the locale data of the
+  runtime; `compareTurkish`, a comparator for `Array.prototype.sort` in Turkish
+  alphabetical order; `foldText`, a key for case-insensitive and
+  accent-insensitive search; `slugify`.
+- **Identity and bank numbers:** `isValidTckn` (T.C. identity number),
+  `isValidVkn` (tax identification number) and `isValidIban` (Turkish IBAN,
+  ISO 13616 checksum); `normalizeIban` for storage and `formatIban` for
+  reading.
+- **Phone numbers:** `isValidPhone`, `getPhoneType` (`"mobile"`, `"landline"`
+  or `"nonGeographic"`), `normalizePhone` (E.164) and `formatPhone` with a
+  national and an international style.
+- **Money:** `formatMoney` (whole kuruş to `3.490,50 TL` or `₺3.490,50`,
+  without `Intl`), `parseMoney` (Turkish notation to whole kuruş) and
+  `moneyToWords` (the amount written out in Turkish). No function does
+  floating-point arithmetic on an amount.
+- **Dates:** `formatDate` (`dd.MM.yyyy`) and `formatDateTime`
+  (`dd.MM.yyyy HH:mm`) with a `timeZone` option that defaults to
+  `Europe/Istanbul`; `parseDate`, which reads `dd.MM.yyyy` into an ISO
+  `yyyy-MM-dd` string and rejects dates that do not exist; `getMonthName`,
+  `getDayName`, `MONTH_NAMES` and `DAY_NAMES`.
+- **Geography:** `PROVINCES` (the 81 provinces with their plate codes),
+  `getProvinceByCode`, `getProvinceByName` and `isValidLicensePlate` (the six
+  civil plate layouts).
+- **Types:** `FormatMoneyOptions`, `FormatPhoneOptions`, `PhoneType`,
+  `Province` and `TimeZoneOptions`.
+- ESM, CommonJS and minified UMD builds with source maps and TypeScript
+  declarations; zero runtime dependencies; `"sideEffects": false`.
+
+[Unreleased]: https://github.com/handijit/tr/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/handijit/tr/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Han Dijit
+
+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.