@insanca-tr/core

Rule-based Turkish plain-language helpers for simplifying formal, bureaucratic, and hard-to-read text.

Install

pnpm add @insanca-tr/core

npm install @insanca-tr/core

Usage

import {
  analyzeText,
  humanizeText,
  simplifyText,
  suggestRewrites
} from "@insanca-tr/core";

const text = "Mezkûr başvuru hususunda gereğini arz ederim.";

console.log(analyzeText(text));
console.log(suggestRewrites(text));
console.log(simplifyText(text));
console.log(humanizeText(" Tarafınıza ,  ivedilikle bilgi verilir."));

Example:

simplifyText("Mezkûr başvuru hususunda gereğini arz ederim.");
// "Söz konusu başvuru konusunda gereğinin yapılmasını rica ederim."

Low-severity shortening rules are opt-in:

simplifyText("Söz konusu işlemi gerçekleştirmek isteriz.", {
  includeLowSeverity: true
});
// "Bu işlemi yapmak isteriz."

API

• analyzeText(text): returns character, word, and sentence statistics, a 0-100 formality score, and rewrite suggestions.
• simplifyText(text, options?): applies safe phrase replacements. Low-severity replacements are disabled by default.
• suggestRewrites(text): returns matched rules with reasons, severity, and source positions.
• humanizeText(text, options?): runs simplification and then lightly cleans spacing and punctuation.

Disclaimer

This package is not intended for deception, plagiarism, impersonation, or bypassing AI detection systems. It is intended to improve clarity, accessibility, and plain-language communication in Turkish. Review suggestions before using them in important contexts.

License

MIT