turkce-utils 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mehmet Fatih Doğan
+
+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/README.md

@@ -1,3 +1,251 @@
-# Temporary Holding Version
+# turkce-utils
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/fatihdogann/turkce-utils/actions/workflows/ci.yml/badge.svg)](https://github.com/fatihdogann/turkce-utils/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/turkce-utils.svg)](https://www.npmjs.com/package/turkce-utils)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Runtime dependencies: 0](https://img.shields.io/badge/runtime_dependencies-0-brightgreen.svg)](#development)
+
+Zero-dependency TypeScript helpers for Turkish text — and a `turkce` CLI.
+
+Turkish is not English with a few accents: `I` lowercases to `ı`, `i`
+uppercases to `İ`, the alphabet puts `ç`, `ğ`, `ı`, `ö`, `ş`, `ü` in their own
+places, and reading difficulty needs its own formula. `turkce-utils` packages
+those rules into small, tested, dependency-free functions.
+
+```ts
+import { slugify, upperTr, sortTr } from "turkce-utils";
+
+slugify("Çılgın Şöför İĞÜ");   // "cilgin-sofor-igu"
+upperTr("istanbul ışık");      // "İSTANBUL IŞIK"
+sortTr(["üzüm", "armut", "çilek"]); // ["armut", "çilek", "üzüm"]
+```
+
+## Install
+
+```bash
+npm install turkce-utils
+```
+
+Requires Node.js 20 or later. The published package is compiled ESM with type
+declarations and **zero runtime dependencies**.
+
+Working on the library itself? Node.js 22.18+ can run the TypeScript sources
+directly — see [Development](#development).
+
+## Modules
+
+| Module | What it does |
+| --- | --- |
+| `slug` | Turkish-aware slug generation |
+| `case` | Turkish letter casing (i/İ, ı/I) |
+| `sort` | Turkish alphabet collation |
+| `title` | Turkish title casing |
+| `normalize` | Normalise typographic punctuation and whitespace |
+| `numbers` | Spell out numbers in Turkish |
+| `ordinal` | Turkish ordinal numbers |
+| `syllables` | Count syllables |
+| `readability` | Ateşman readability score |
+| `truncate` | Truncate on a word boundary |
+| `initials` | Initials from a full name |
+| `cli` | `turkce` command line interface |
+
+## API
+
+### `slugify(input, options?)`
+
+Turkish-aware slug: `ç → c`, `ğ → g`, `ı → i`, `İ → i`, `ö → o`, `ş → s`, `ü → u`.
+Remaining diacritics are folded, punctuation is dropped.
+
+```ts
+import { slugify } from "turkce-utils";
+
+slugify("Çılgın Şöför İĞÜ");                    // "cilgin-sofor-igu"
+slugify("Türkçe Metin", { separator: "_" });    // "turkce_metin"
+slugify("kahve falı bakıyoruz", { maxLength: 10 }); // "kahve"
+```
+
+Options: `separator` (default `"-"`), `lowercase` (default `true`), `maxLength`.
+
+### `lowerTr(input)` / `upperTr(input)`
+
+Turkish letter casing. JavaScript maps `I → i` and `i → I`; Turkish pairs the
+dotless `ı` with `I` and the dotted `i` with `İ`.
+
+```ts
+import { lowerTr, upperTr } from "turkce-utils";
+
+lowerTr("İSTANBUL"); // "istanbul"
+lowerTr("IŞIK");     // "ışık"
+upperTr("istanbul ışık"); // "İSTANBUL IŞIK"
+```
+
+### `sortTr(items)` / `compareTr(a, b)`
+
+Sort by the Turkish alphabet — `ç` after `c`, `ğ` after `g`, `ı` before `i`,
+`ö`, `ş`, `ü` in place — backed by `Intl.Collator("tr")`.
+
+```ts
+import { sortTr } from "turkce-utils";
+
+sortTr(["zeytin", "armut", "üzüm", "çilek", "ıspanak", "incir"]);
+// ["armut", "çilek", "ıspanak", "incir", "üzüm", "zeytin"]
+```
+
+### `titleCaseTr(input)`
+
+Title-case with Turkish rules; the suffix after an apostrophe stays lowercase.
+
+```ts
+import { titleCaseTr } from "turkce-utils";
+
+titleCaseTr("çılgın şöför istanbul'da"); // "Çılgın Şöför İstanbul'da"
+titleCaseTr("TÜRKÇE METİN IŞIK");        // "Türkçe Metin Işık"
+```
+
+### `normalizeTr(input, options?)`
+
+NFC normalisation plus typographic fixes: smart quotes → `"`/`'`, en/em dashes →
+`-`, `…` → `...`, non-breaking and zero-width spaces handled, whitespace collapsed.
+
+```ts
+import { normalizeTr } from "turkce-utils";
+
+normalizeTr("“Merhaba” —dünya…"); // '"Merhaba" -dünya...'
+normalizeTr("  bir   iki  ");      // "bir iki"
+```
+
+### `numberToWordsTr(value)` / `integerToWordsTr(value)`
+
+Spell out numbers in Turkish, including negatives and decimals.
+
+```ts
+import { numberToWordsTr } from "turkce-utils";
+
+numberToWordsTr(1234);     // "bin iki yüz otuz dört"
+numberToWordsTr(1000000);  // "bir milyon"
+numberToWordsTr(-5);       // "eksi beş"
+numberToWordsTr(3.5);      // "üç virgül beş"
+```
+
+`1000` is spoken as `bin`, never `bir bin`.
+
+### `ordinalTr(value)` / `ordinalWordTr(value)`
+
+```ts
+import { ordinalTr, ordinalWordTr } from "turkce-utils";
+
+ordinalTr(3);       // "3."
+ordinalWordTr(3);   // "üçüncü"
+ordinalWordTr(4);   // "dördüncü"
+ordinalWordTr(121); // "yüz yirmi birinci"
+```
+
+Suffixes follow Turkish vowel harmony.
+
+### `syllablesTr(input)`
+
+Turkish is one vowel per syllable, so the count is the number of vowel groups.
+
+```ts
+import { syllablesTr } from "turkce-utils";
+
+syllablesTr("Türkçe");   // 2
+syllablesTr("yapıyoruz"); // 4
+```
+
+### `atestmanScore(text)` / `atestmanGrade(score)`
+
+Ateşman readability score for Turkish (Ateşman, 1997):
+
+```text
+score = 198.43 − 40.175 × (syllables / words) − 2.610 × (words / sentences)
+```
+
+```ts
+import { atestmanScore } from "turkce-utils";
+
+atestmanScore("Merhaba dünya. Nasılsın?");
+// { score: 87.38, grade: "kolay", syllables: 8, words: 3, sentences: 2 }
+```
+
+Grades: `çok kolay` (90+), `kolay` (70+), `orta` (50+), `zor` (30+), `çok zor`.
+
+### `truncateTr(text, maxLength, ellipsis?)`
+
+Shorten text on the last word boundary, never exceeding `maxLength`.
+
+```ts
+import { truncateTr } from "turkce-utils";
+
+truncateTr("kahve falı bakıyoruz", 12); // "kahve falı…"
+truncateTr("abcdef", 4, "...");         // "a..."
+```
+
+### `initialsTr(input, options?)`
+
+Initials from a full name, uppercased with Turkish rules.
+
+```ts
+import { initialsTr } from "turkce-utils";
+
+initialsTr("Mehmet Fatih Doğan");               // "MFD"
+initialsTr("ışık inci");                        // "Iİ"
+initialsTr("Mehmet Fatih Doğan", { separator: "." }); // "M.F.D"
+```
+
+### CLI
+
+The package ships a `turkce` command covering every helper:
+
+```console
+$ turkce slug "Çılgın Şöför"
+cilgin-sofor
+
+$ turkce words 1234
+bin iki yüz otuz dört
+
+$ printf 'üzüm\narmut\nçilek\n' | turkce sort
+armut
+çilek
+üzüm
+```
+
+Run `turkce --help` for the full command list.
+
+## Development
+
+Node.js 22.18+ runs the TypeScript sources directly (native type stripping),
+so no build step is needed for tests:
+
+```bash
+npm test          # node --test
+npm run typecheck # tsc --noEmit
+npm run build     # tsc -> dist/
+```
+
+Every module has a matching test in `test/`. The library has **zero runtime
+dependencies**.
+
+### Releasing
+
+Versions are published from GitHub Actions using npm **trusted publishing**
+(OIDC), so no long-lived npm token is stored anywhere. Bump the version and push
+a matching tag:
+
+```bash
+npm version patch   # or minor / major
+git push --follow-tags
+```
+
+[`.github/workflows/publish.yml`](.github/workflows/publish.yml) checks that the
+tag matches `package.json`, runs the typecheck and the tests, and publishes with
+a provenance attestation. It can also be started manually as a dry run.
+
+## Developer
+
+**Mehmet Fatih Doğan** — Software Developer.
+
+- 🌐 Portfolio & Contact: [mehmetfatihdogan.com.tr](https://mehmetfatihdogan.com.tr)
+- 💻 GitHub: [@fatihdogann](https://github.com/fatihdogann)
+
+For questions, bug reports, or feedback about this project, feel free to contact me through [my website](https://mehmetfatihdogan.com.tr).

package/dist/case.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Turkish-aware letter casing.
+ *
+ * JavaScript's `toLowerCase`/`toUpperCase` follow the Unicode default, which
+ * maps `I` to `i` and `i` to `I`. Turkish is different: the dotless `ı` pairs
+ * with `I`, and the dotted `i` pairs with `İ`.
+ */
+/** Lowercase a string using Turkish rules (`I` → `ı`, `İ` → `i`). */
+export declare function lowerTr(input: string): string;
+/** Uppercase a string using Turkish rules (`i` → `İ`, `ı` → `I`). */
+export declare function upperTr(input: string): string;
+//# sourceMappingURL=case.d.ts.map

package/dist/case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.d.ts","sourceRoot":"","sources":["../src/case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/case.js

@@ -0,0 +1,18 @@
+/**
+ * Turkish-aware letter casing.
+ *
+ * JavaScript's `toLowerCase`/`toUpperCase` follow the Unicode default, which
+ * maps `I` to `i` and `i` to `I`. Turkish is different: the dotless `ı` pairs
+ * with `I`, and the dotted `i` pairs with `İ`.
+ */
+const LOWER = { I: "ı", İ: "i" };
+const UPPER = { i: "İ", ı: "I" };
+/** Lowercase a string using Turkish rules (`I` → `ı`, `İ` → `i`). */
+export function lowerTr(input) {
+    return input.replace(/[Iİ]/g, (char) => LOWER[char] ?? char).toLowerCase();
+}
+/** Uppercase a string using Turkish rules (`i` → `İ`, `ı` → `I`). */
+export function upperTr(input) {
+    return input.replace(/[iı]/g, (char) => UPPER[char] ?? char).toUpperCase();
+}
+//# sourceMappingURL=case.js.map

package/dist/case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.js","sourceRoot":"","sources":["../src/case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,KAAK,GAAqC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;AACnE,MAAM,KAAK,GAAqC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;AAEnE,qEAAqE;AACrE,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7E,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7E,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * `turkce` — a small CLI over the turkce-utils helpers.
+ *
+ * Usage: `turkce <command> [text...]`, or pipe text on stdin.
+ */
+export declare const HELP = "turkce \u2014 Turkish text helpers\n\nUsage:\n  turkce <command> [text...]      text can also be piped on stdin\n\nCommands:\n  slug         URL-safe slug (\u00E7 -> c, \u011F -> g, ...)\n  upper        Turkish uppercase (i -> \u0130, \u0131 -> I)\n  lower        Turkish lowercase (I -> \u0131, \u0130 -> i)\n  title        Turkish title case\n  normalize    normalise quotes, dashes, whitespace\n  words        spell out a number (1234 -> \"bin iki y\u00FCz otuz d\u00F6rt\")\n  ordinal      spill out an ordinal (3 -> \"\u00FC\u00E7\u00FCnc\u00FC\")\n  syllables    count syllables\n  readability  Ate\u015Fman readability score\n  initials     initials from a full name\n  truncate     shorten text (max 80 chars)\n  sort         sort lines by the Turkish alphabet\n\nOptions:\n  -h, --help   show this help\n";
+/** Run a command against `input` and return the text to print. */
+export declare function runCommand(command: string, input: string): string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAgBH,eAAO,MAAM,IAAI,kzBAqBhB,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA+BjE"}

package/dist/cli.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+/**
+ * `turkce` — a small CLI over the turkce-utils helpers.
+ *
+ * Usage: `turkce <command> [text...]`, or pipe text on stdin.
+ */
+import { slugify } from "./slug.js";
+import { lowerTr, upperTr } from "./case.js";
+import { sortTr } from "./sort.js";
+import { titleCaseTr } from "./title.js";
+import { normalizeTr } from "./normalize.js";
+import { numberToWordsTr } from "./numbers.js";
+import { ordinalWordTr } from "./ordinal.js";
+import { syllablesTr } from "./syllables.js";
+import { atestmanScore } from "./readability.js";
+import { truncateTr } from "./truncate.js";
+import { initialsTr } from "./initials.js";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+export const HELP = `turkce — Turkish text helpers
+
+Usage:
+  turkce <command> [text...]      text can also be piped on stdin
+
+Commands:
+  slug         URL-safe slug (ç -> c, ğ -> g, ...)
+  upper        Turkish uppercase (i -> İ, ı -> I)
+  lower        Turkish lowercase (I -> ı, İ -> i)
+  title        Turkish title case
+  normalize    normalise quotes, dashes, whitespace
+  words        spell out a number (1234 -> "bin iki yüz otuz dört")
+  ordinal      spill out an ordinal (3 -> "üçüncü")
+  syllables    count syllables
+  readability  Ateşman readability score
+  initials     initials from a full name
+  truncate     shorten text (max 80 chars)
+  sort         sort lines by the Turkish alphabet
+
+Options:
+  -h, --help   show this help
+`;
+/** Run a command against `input` and return the text to print. */
+export function runCommand(command, input) {
+    switch (command) {
+        case "slug":
+            return slugify(input);
+        case "upper":
+            return upperTr(input);
+        case "lower":
+            return lowerTr(input);
+        case "title":
+            return titleCaseTr(input);
+        case "normalize":
+            return normalizeTr(input);
+        case "words":
+            return numberToWordsTr(Number(input.trim()));
+        case "ordinal":
+            return ordinalWordTr(Number(input.trim()));
+        case "syllables":
+            return String(syllablesTr(input));
+        case "initials":
+            return initialsTr(input);
+        case "truncate":
+            return truncateTr(input, 80);
+        case "sort":
+            return sortTr(input.split("\n").filter((line) => line.length > 0)).join("\n");
+        case "readability": {
+            const result = atestmanScore(input);
+            return `${result.score} (${result.grade}) — ${result.words} kelime, ${result.sentences} cümle`;
+        }
+        default:
+            throw new Error(`unknown command: ${command}`);
+    }
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8");
+}
+async function main(argv) {
+    const [command, ...rest] = argv;
+    if (!command || command === "-h" || command === "--help" || command === "help") {
+        process.stdout.write(HELP);
+        return command ? 0 : 1;
+    }
+    const input = rest.length > 0 ? rest.join(" ") : (await readStdin()).replace(/\n$/, "");
+    try {
+        process.stdout.write(runCommand(command, input) + "\n");
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(`turkce: ${error.message}\n`);
+        return 1;
+    }
+}
+/**
+ * True when this file is the process entry point.
+ *
+ * `process.argv[1]` can be a symlink — npm links `node_modules/.bin/turkce`
+ * to `dist/cli.js` — so both sides are resolved to their real path first.
+ */
+function isEntryPoint() {
+    const invoked = process.argv[1];
+    if (!invoked)
+        return false;
+    try {
+        return realpathSync(invoked) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntryPoint()) {
+    main(process.argv.slice(2)).then((code) => {
+        process.exitCode = code;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { slugify } from "./slug.ts";
+export type { SlugifyOptions } from "./slug.ts";
+export { lowerTr, upperTr } from "./case.ts";
+export { compareTr, sortTr } from "./sort.ts";
+export { titleCaseTr } from "./title.ts";
+export { normalizeTr } from "./normalize.ts";
+export type { NormalizeTrOptions } from "./normalize.ts";
+export { numberToWordsTr, integerToWordsTr } from "./numbers.ts";
+export { ordinalTr, ordinalWordTr } from "./ordinal.ts";
+export { syllablesTr } from "./syllables.ts";
+export { atestmanScore, atestmanGrade } from "./readability.ts";
+export type { ReadabilityResult, AtestmanGrade } from "./readability.ts";
+export { truncateTr } from "./truncate.ts";
+export { initialsTr } from "./initials.ts";
+export type { InitialsTrOptions } from "./initials.ts";
+export { runCommand, HELP } from "./cli.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { slugify } from "./slug.js";
+export { lowerTr, upperTr } from "./case.js";
+export { compareTr, sortTr } from "./sort.js";
+export { titleCaseTr } from "./title.js";
+export { normalizeTr } from "./normalize.js";
+export { numberToWordsTr, integerToWordsTr } from "./numbers.js";
+export { ordinalTr, ordinalWordTr } from "./ordinal.js";
+export { syllablesTr } from "./syllables.js";
+export { atestmanScore, atestmanGrade } from "./readability.js";
+export { truncateTr } from "./truncate.js";
+export { initialsTr } from "./initials.js";
+export { runCommand, HELP } from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}

package/dist/initials.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Initials from Turkish names.
+ */
+export interface InitialsTrOptions {
+    /** Keep only the first N initials. */
+    limit?: number;
+    /** String placed between initials. Defaults to `""`. */
+    separator?: string;
+}
+/** Build uppercase initials from a full name: "Mehmet Fatih Doğan" → "MFD". */
+export declare function initialsTr(input: string, options?: InitialsTrOptions): string;
+//# sourceMappingURL=initials.d.ts.map

package/dist/initials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../src/initials.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAWjF"}

package/dist/initials.js

@@ -0,0 +1,16 @@
+/**
+ * Initials from Turkish names.
+ */
+import { upperTr } from "./case.js";
+/** Build uppercase initials from a full name: "Mehmet Fatih Doğan" → "MFD". */
+export function initialsTr(input, options = {}) {
+    const separator = options.separator ?? "";
+    const initials = input
+        .trim()
+        .split(/\s+/)
+        .filter((word) => word.length > 0)
+        .map((word) => upperTr(word[0] ?? ""));
+    const limited = options.limit !== undefined && options.limit >= 0 ? initials.slice(0, options.limit) : initials;
+    return limited.join(separator);
+}
+//# sourceMappingURL=initials.js.map

package/dist/initials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initials.js","sourceRoot":"","sources":["../src/initials.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAA6B,EAAE;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK;SACnB,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEzC,MAAM,OAAO,GACX,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClG,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Normalise Turkish text for storage and comparison.
+ *
+ * Applies NFC, replaces typographic punctuation (smart quotes, en/em dashes,
+ * ellipsis, non-breaking spaces) with plain ASCII equivalents and collapses
+ * repeated whitespace.
+ */
+export interface NormalizeTrOptions {
+    /** Collapse runs of whitespace and trim the result. Defaults to `true`. */
+    collapseWhitespace?: boolean;
+}
+/** Return a normalised copy of `input`. */
+export declare function normalizeTr(input: string, options?: NormalizeTrOptions): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAWD,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CASnF"}

package/dist/normalize.js

@@ -0,0 +1,27 @@
+/**
+ * Normalise Turkish text for storage and comparison.
+ *
+ * Applies NFC, replaces typographic punctuation (smart quotes, en/em dashes,
+ * ellipsis, non-breaking spaces) with plain ASCII equivalents and collapses
+ * repeated whitespace.
+ */
+const REPLACEMENTS = [
+    [/[\u2018\u2019\u201A\u201B\u2032]/g, "'"],
+    [/[\u201C\u201D\u201E\u201F\u2033]/g, '"'],
+    [/[\u2013\u2014\u2015]/g, "-"],
+    [/\u2026/g, "..."],
+    [/\u00A0|\u2007|\u202F/g, " "],
+    [/\u200B|\u200C|\u200D|\uFEFF/g, ""],
+];
+/** Return a normalised copy of `input`. */
+export function normalizeTr(input, options = {}) {
+    let out = input.normalize("NFC");
+    for (const [pattern, replacement] of REPLACEMENTS) {
+        out = out.replace(pattern, replacement);
+    }
+    if (options.collapseWhitespace ?? true) {
+        out = out.replace(/\s+/g, " ").trim();
+    }
+    return out;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,YAAY,GAA6C;IAC7D,CAAC,mCAAmC,EAAE,GAAG,CAAC;IAC1C,CAAC,mCAAmC,EAAE,GAAG,CAAC;IAC1C,CAAC,uBAAuB,EAAE,GAAG,CAAC;IAC9B,CAAC,SAAS,EAAE,KAAK,CAAC;IAClB,CAAC,uBAAuB,EAAE,GAAG,CAAC;IAC9B,CAAC,8BAA8B,EAAE,EAAE,CAAC;CACrC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,UAA8B,EAAE;IACzE,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,YAAY,EAAE,CAAC;QAClD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;QACvC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/numbers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Spell out numbers in Turkish.
+ *
+ * Supports integers up to the trillions, negatives and simple decimals
+ * (separated with the Turkish decimal comma word, `virgül`).
+ */
+/** Spell out an integer in Turkish. */
+export declare function integerToWordsTr(value: number): string;
+/** Spell out a number in Turkish, including negatives and decimals. */
+export declare function numberToWordsTr(value: number): string;
+//# sourceMappingURL=numbers.d.ts.map

package/dist/numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../src/numbers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BtD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcrD"}

package/dist/numbers.js

@@ -0,0 +1,76 @@
+/**
+ * Spell out numbers in Turkish.
+ *
+ * Supports integers up to the trillions, negatives and simple decimals
+ * (separated with the Turkish decimal comma word, `virgül`).
+ */
+const UNITS = [
+    "sıfır", "bir", "iki", "üç", "dört", "beş", "altı", "yedi", "sekiz", "dokuz",
+];
+const TENS = [
+    "", "on", "yirmi", "otuz", "kırk", "elli", "altmış", "yetmiş", "seksen", "doksan",
+];
+const SCALES = ["", "bin", "milyon", "milyar", "trilyon"];
+function belowThousand(value) {
+    const words = [];
+    const hundreds = Math.floor(value / 100);
+    const tens = Math.floor((value % 100) / 10);
+    const units = value % 10;
+    if (hundreds > 0) {
+        if (hundreds > 1)
+            words.push(UNITS[hundreds]);
+        words.push("yüz");
+    }
+    if (tens > 0)
+        words.push(TENS[tens]);
+    if (units > 0)
+        words.push(UNITS[units]);
+    return words;
+}
+/** Spell out an integer in Turkish. */
+export function integerToWordsTr(value) {
+    if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new RangeError("integerToWordsTr: expected a finite integer");
+    }
+    if (value === 0)
+        return "sıfır";
+    const negative = value < 0;
+    let remaining = Math.abs(value);
+    const groups = [];
+    while (remaining > 0) {
+        groups.push(remaining % 1000);
+        remaining = Math.floor(remaining / 1000);
+    }
+    const words = [];
+    for (let i = groups.length - 1; i >= 0; i--) {
+        const group = groups[i];
+        if (group === 0)
+            continue;
+        // "1000" is spoken as "bin", never "bir bin".
+        if (i === 1 && group === 1) {
+            words.push("bin");
+            continue;
+        }
+        words.push(...belowThousand(group));
+        if (i > 0)
+            words.push(SCALES[i]);
+    }
+    return (negative ? "eksi " : "") + words.join(" ");
+}
+/** Spell out a number in Turkish, including negatives and decimals. */
+export function numberToWordsTr(value) {
+    const sign = value < 0 ? "eksi " : "";
+    const absolute = Math.abs(value);
+    const integerPart = Math.trunc(absolute);
+    const fraction = absolute - integerPart;
+    if (fraction === 0)
+        return integerToWordsTr(value);
+    const fractionDigits = fraction.toFixed(10).slice(2).replace(/0+$/, "");
+    const head = integerPart === 0 ? "sıfır" : integerToWordsTr(integerPart);
+    const tail = fractionDigits
+        .split("")
+        .map((digit) => UNITS[Number(digit)])
+        .join(" ");
+    return `${sign}${head} virgül ${tail}`;
+}
+//# sourceMappingURL=numbers.js.map

package/dist/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../src/numbers.ts"],"names":[],"mappings":"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"}

package/dist/ordinal.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Turkish ordinal numbers.
+ *
+ * `ordinalTr` returns the numeric form with a trailing dot ("3."), while
+ * `ordinalWordTr` spells the ordinal out ("üçüncü") using Turkish vowel harmony.
+ */
+/** Numeric ordinal: 3 → "3.". */
+export declare function ordinalTr(value: number): string;
+/** Spelled-out ordinal: 3 → "üçüncü", 21 → "yirmi birinci". */
+export declare function ordinalWordTr(value: number): string;
+//# sourceMappingURL=ordinal.d.ts.map

package/dist/ordinal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinal.d.ts","sourceRoot":"","sources":["../src/ordinal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,iCAAiC;AACjC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD"}

package/dist/ordinal.js

@@ -0,0 +1,43 @@
+/**
+ * Turkish ordinal numbers.
+ *
+ * `ordinalTr` returns the numeric form with a trailing dot ("3."), while
+ * `ordinalWordTr` spells the ordinal out ("üçüncü") using Turkish vowel harmony.
+ */
+import { integerToWordsTr } from "./numbers.js";
+const HARMONY = {
+    a: "ı", ı: "ı",
+    e: "i", i: "i",
+    o: "u", u: "u",
+    ö: "ü", ü: "ü",
+};
+const VOWELS = "aeıioöuüâîû";
+const IRREGULAR = { dört: "dörd" };
+function lastVowel(word) {
+    for (let i = word.length - 1; i >= 0; i--) {
+        const char = word[i];
+        if (VOWELS.includes(char))
+            return HARMONY[char] ?? "i";
+    }
+    return "i";
+}
+function ordinaliseWord(word) {
+    const base = IRREGULAR[word] ?? word;
+    const vowel = lastVowel(word);
+    const endsWithVowel = VOWELS.includes(word[word.length - 1]);
+    return endsWithVowel ? `${base}nc${vowel}` : `${base}${vowel}nc${vowel}`;
+}
+/** Numeric ordinal: 3 → "3.". */
+export function ordinalTr(value) {
+    if (!Number.isInteger(value))
+        throw new RangeError("ordinalTr: expected an integer");
+    return `${value}.`;
+}
+/** Spelled-out ordinal: 3 → "üçüncü", 21 → "yirmi birinci". */
+export function ordinalWordTr(value) {
+    const words = integerToWordsTr(value).split(" ");
+    const last = words.pop();
+    words.push(ordinaliseWord(last));
+    return words.join(" ");
+}
+//# sourceMappingURL=ordinal.js.map

package/dist/ordinal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinal.js","sourceRoot":"","sources":["../src/ordinal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,OAAO,GAAqC;IAChD,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;CACf,CAAC;AAEF,MAAM,MAAM,GAAG,aAAa,CAAC;AAC7B,MAAM,SAAS,GAAqC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAErE,SAAS,SAAS,CAAC,IAAY;IAC7B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACtB,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACrC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC;IAC9D,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC;AAC3E,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IACrF,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/readability.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Ateşman readability score for Turkish text (Ateşman, 1997).
+ *
+ * ```text
+ * score = 198.43 − 40.175 × (syllables / words) − 2.610 × (words / sentences)
+ * ```
+ *
+ * Higher scores mean easier text. The score is clamped to the 0–100 range.
+ */
+export interface ReadabilityResult {
+    /** Ateşman score, clamped to 0–100. */
+    score: number;
+    /** Qualitative band for the score. */
+    grade: AtestmanGrade;
+    syllables: number;
+    words: number;
+    sentences: number;
+}
+export type AtestmanGrade = "çok kolay" | "kolay" | "orta" | "zor" | "çok zor";
+/** Map an Ateşman score to its qualitative band. */
+export declare function atestmanGrade(score: number): AtestmanGrade;
+/** Compute the Ateşman readability score for Turkish text. */
+export declare function atestmanScore(text: string): ReadabilityResult;
+//# sourceMappingURL=readability.d.ts.map

package/dist/readability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readability.d.ts","sourceRoot":"","sources":["../src/readability.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAW/E,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAM1D;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAkB7D"}

package/dist/readability.js

@@ -0,0 +1,50 @@
+/**
+ * Ateşman readability score for Turkish text (Ateşman, 1997).
+ *
+ * ```text
+ * score = 198.43 − 40.175 × (syllables / words) − 2.610 × (words / sentences)
+ * ```
+ *
+ * Higher scores mean easier text. The score is clamped to the 0–100 range.
+ */
+import { syllablesTr } from "./syllables.js";
+const WORD = /[\p{L}\p{N}]+/gu;
+function tokenize(text) {
+    const words = text.match(WORD) ?? [];
+    const trimmed = text.trim();
+    if (trimmed === "")
+        return { words, sentences: 1 };
+    const ends = trimmed.match(/[.!?…]+/g)?.length ?? 0;
+    const trailing = /[.!?…]$/.test(trimmed) ? 0 : 1;
+    return { words, sentences: Math.max(1, ends + trailing) };
+}
+/** Map an Ateşman score to its qualitative band. */
+export function atestmanGrade(score) {
+    if (score >= 90)
+        return "çok kolay";
+    if (score >= 70)
+        return "kolay";
+    if (score >= 50)
+        return "orta";
+    if (score >= 30)
+        return "zor";
+    return "çok zor";
+}
+/** Compute the Ateşman readability score for Turkish text. */
+export function atestmanScore(text) {
+    const { words, sentences } = tokenize(text);
+    const wordCount = words.length;
+    const syllableCount = words.reduce((total, word) => total + syllablesTr(word), 0);
+    const score = wordCount === 0
+        ? 0
+        : 198.43 - 40.175 * (syllableCount / wordCount) - 2.61 * (wordCount / sentences);
+    const clamped = Math.max(0, Math.min(100, Math.round(score * 100) / 100));
+    return {
+        score: clamped,
+        grade: atestmanGrade(clamped),
+        syllables: syllableCount,
+        words: wordCount,
+        sentences,
+    };
+}
+//# sourceMappingURL=readability.js.map

package/dist/readability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readability.js","sourceRoot":"","sources":["../src/readability.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAc/B,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IAC/B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;IAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAElF,MAAM,KAAK,GACT,SAAS,KAAK,CAAC;QACb,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAE1E,OAAO;QACL,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC;QAC7B,SAAS,EAAE,aAAa;QACxB,KAAK,EAAE,SAAS;QAChB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/slug.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Turkish-aware slug generation.
+ *
+ * `slugify` transliterates Turkish letters to their ASCII counterparts
+ * (ç→c, ğ→g, ı→i, İ→i, ö→o, ş→s, ü→u), folds remaining diacritics,
+ * drops punctuation and produces a URL-safe, separator-joined string.
+ */
+export interface SlugifyOptions {
+    /** Separator between words. Defaults to `"-"`. */
+    separator?: string;
+    /** Lowercase the result. Defaults to `true`. */
+    lowercase?: boolean;
+    /** Hard limit for the returned slug length. Truncation happens on a word boundary. */
+    maxLength?: number;
+}
+/** Convert arbitrary text into a URL-safe slug, respecting Turkish letters. */
+export declare function slugify(input: string, options?: SlugifyOptions): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CA8B3E"}

package/dist/slug.js

@@ -0,0 +1,47 @@
+/**
+ * Turkish-aware slug generation.
+ *
+ * `slugify` transliterates Turkish letters to their ASCII counterparts
+ * (ç→c, ğ→g, ı→i, İ→i, ö→o, ş→s, ü→u), folds remaining diacritics,
+ * drops punctuation and produces a URL-safe, separator-joined string.
+ */
+const TURKISH = {
+    ç: "c", Ç: "c",
+    ğ: "g", Ğ: "g",
+    ı: "i", I: "i",
+    İ: "i", i: "i",
+    ö: "o", Ö: "o",
+    ş: "s", Ş: "s",
+    ü: "u", Ü: "u",
+    â: "a", Â: "a",
+    î: "i", Î: "i",
+    û: "u", Û: "u",
+};
+/** Convert arbitrary text into a URL-safe slug, respecting Turkish letters. */
+export function slugify(input, options = {}) {
+    const separator = options.separator ?? "-";
+    const lowercase = options.lowercase ?? true;
+    if (separator === "")
+        throw new RangeError("slugify: separator must not be empty");
+    let out = "";
+    for (const char of input.normalize("NFC")) {
+        const mapped = TURKISH[char];
+        if (mapped !== undefined) {
+            out += mapped;
+            continue;
+        }
+        out += char.normalize("NFKD").replace(/[\u0300-\u036f]/g, "");
+    }
+    out = out.replace(/[^a-zA-Z0-9]+/g, separator);
+    const escaped = separator.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    out = out.replace(new RegExp(`^(${escaped})+|(${escaped})+$`, "g"), "");
+    if (lowercase)
+        out = out.toLowerCase();
+    if (options.maxLength !== undefined && out.length > options.maxLength) {
+        const cut = out.slice(0, options.maxLength);
+        const lastSep = cut.lastIndexOf(separator);
+        out = (lastSep > 0 ? cut.slice(0, lastSep) : cut).replace(new RegExp(`(${escaped})+$`), "");
+    }
+    return out;
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,GAAqC;IAChD,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;CACf,CAAC;AAWF,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,UAA0B,EAAE;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,IAAI,SAAS,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,sCAAsC,CAAC,CAAC;IAEnF,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,GAAG,IAAI,MAAM,CAAC;YACd,SAAS;QACX,CAAC;QACD,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACjE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,OAAO,OAAO,OAAO,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,IAAI,SAAS;QAAE,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACtE,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC3C,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CACvD,IAAI,MAAM,CAAC,IAAI,OAAO,KAAK,CAAC,EAC5B,EAAE,CACH,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/sort.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Turkish-aware collation.
+ *
+ * Sorts using the Turkish alphabet, where ç follows c, ğ follows g, ı comes
+ * before i, ö follows o, ş follows s and ü follows u. Backed by `Intl.Collator`
+ * so no lookup tables are needed.
+ */
+/** Compare two strings by the Turkish alphabet. Returns a negative, zero or positive number. */
+export declare function compareTr(a: string, b: string): number;
+/** Return a new array sorted by the Turkish alphabet. */
+export declare function sortTr<T extends string>(items: readonly T[]): T[];
+//# sourceMappingURL=sort.d.ts.map

package/dist/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../src/sort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAEjE"}

package/dist/sort.js

@@ -0,0 +1,17 @@
+/**
+ * Turkish-aware collation.
+ *
+ * Sorts using the Turkish alphabet, where ç follows c, ğ follows g, ı comes
+ * before i, ö follows o, ş follows s and ü follows u. Backed by `Intl.Collator`
+ * so no lookup tables are needed.
+ */
+const collator = new Intl.Collator("tr", { sensitivity: "variant", numeric: false });
+/** Compare two strings by the Turkish alphabet. Returns a negative, zero or positive number. */
+export function compareTr(a, b) {
+    return collator.compare(a, b);
+}
+/** Return a new array sorted by the Turkish alphabet. */
+export function sortTr(items) {
+    return [...items].sort(compareTr);
+}
+//# sourceMappingURL=sort.js.map

package/dist/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../src/sort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AAErF,gGAAgG;AAChG,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,CAAS;IAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,MAAM,CAAmB,KAAmB;IAC1D,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC"}

package/dist/syllables.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Count syllables in Turkish words.
+ *
+ * Turkish is written as one vowel per syllable, so the syllable count is the
+ * number of vowel groups.
+ */
+/** Count the syllables in a word or sentence. */
+export declare function syllablesTr(input: string): number;
+//# sourceMappingURL=syllables.d.ts.map

package/dist/syllables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syllables.d.ts","sourceRoot":"","sources":["../src/syllables.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/syllables.js

@@ -0,0 +1,12 @@
+/**
+ * Count syllables in Turkish words.
+ *
+ * Turkish is written as one vowel per syllable, so the syllable count is the
+ * number of vowel groups.
+ */
+const VOWEL_GROUP = /[aeıioöuüâîû]+/g;
+/** Count the syllables in a word or sentence. */
+export function syllablesTr(input) {
+    return input.toLowerCase().match(VOWEL_GROUP)?.length ?? 0;
+}
+//# sourceMappingURL=syllables.js.map

package/dist/syllables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syllables.js","sourceRoot":"","sources":["../src/syllables.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/title.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Turkish-aware title casing.
+ */
+/** Title-case a string, capitalising the first letter of each word with Turkish rules. */
+export declare function titleCaseTr(input: string): string;
+//# sourceMappingURL=title.d.ts.map

package/dist/title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../src/title.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/title.js

@@ -0,0 +1,14 @@
+/**
+ * Turkish-aware title casing.
+ */
+import { lowerTr, upperTr } from "./case.js";
+// Word separators: whitespace and opening punctuation, but never an apostrophe
+// (so "istanbul'da" keeps its lowercase suffix).
+const WORD_START = /(^|[\s([{"«»""\-–—/|]+)(\p{L})/gu;
+/** Title-case a string, capitalising the first letter of each word with Turkish rules. */
+export function titleCaseTr(input) {
+    return lowerTr(input).replace(WORD_START, (_match, separator, letter) => {
+        return separator + upperTr(letter);
+    });
+}
+//# sourceMappingURL=title.js.map

package/dist/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../src/title.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,+EAA+E;AAC/E,iDAAiD;AACjD,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAEtD,0FAA0F;AAC1F,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,SAAiB,EAAE,MAAc,EAAE,EAAE;QACtF,OAAO,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/truncate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Truncate Turkish text on a word boundary.
+ */
+/** Shorten `text` to at most `maxLength` characters, appending an ellipsis. */
+export declare function truncateTr(text: string, maxLength: number, ellipsis?: string): string;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../src/truncate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAWlF"}

package/dist/truncate.js

@@ -0,0 +1,18 @@
+/**
+ * Truncate Turkish text on a word boundary.
+ */
+/** Shorten `text` to at most `maxLength` characters, appending an ellipsis. */
+export function truncateTr(text, maxLength, ellipsis = "…") {
+    if (maxLength <= 0)
+        return "";
+    if (text.length <= maxLength)
+        return text;
+    const budget = maxLength - ellipsis.length;
+    if (budget <= 0)
+        return ellipsis.slice(0, maxLength);
+    const slice = text.slice(0, budget + 1);
+    const lastSpace = slice.lastIndexOf(" ");
+    const cut = lastSpace > 0 ? slice.slice(0, lastSpace) : text.slice(0, budget);
+    return cut.replace(/\s+$/, "") + ellipsis;
+}
+//# sourceMappingURL=truncate.js.map

package/dist/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../src/truncate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,SAAiB,EAAE,QAAQ,GAAG,GAAG;IACxE,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC3C,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9E,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "turkce-utils",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Zero-dependency TypeScript helpers for Turkish text: slugify, Turkish-aware case & sort, title case, number-to-words, syllables and Ateşman readability — plus a CLI.",
+  "keywords": [
+    "turkish",
+    "türkçe",
+    "turkce",
+    "turkish-language",
+    "slugify",
+    "slug",
+    "text",
+    "text-utils",
+    "string",
+    "i18n",
+    "locale",
+    "collation",
+    "readability",
+    "atestman",
+    "okunabilirlik",
+    "number-to-words",
+    "syllables",
+    "cli"
+  ],
+  "license": "MIT",
+  "author": "Mehmet Fatih Doğan",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "turkce": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fatihdogann/turkce-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fatihdogann/turkce-utils/issues"
+  },
+  "homepage": "https://github.com/fatihdogann/turkce-utils#readme"
+}