slugen 0.1.1

package/LICENSE

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

@@ -0,0 +1,211 @@
+# slugen
+
+A modern, fast slug generator for JavaScript and TypeScript.
+
+Generate URL-friendly slugs, usernames, SEO-friendly links, or safely convert text into clean identifiers.
+
+
+## Features
+
+- **Multi-locale support** — de, fr, tr, es, and more
+- **Accurate normalization** of accented and language-specific characters
+- **Smart symbol handling** with semantic replacements instead of blind removal
+- **High performance**, suitable for batch and large-scale processing
+- **Customizable separators** (`-`, `_`, `.`)
+- **Deterministic output** with comprehensive test coverage
+
+
+## Installation
+
+```bash
+npm install slugen
+```
+or
+
+```bash
+pnpm add slugen
+```
+
+## Quick Start
+
+```ts
+import { slugen } from "slugen";
+
+slugen("Hello World");
+// → "hello-world"
+
+slugen("Istanbul's Best Coffee!");
+// → "istanbuls-best-coffee"
+```
+
+## With Options
+```ts
+import { slugen } from "slugen";
+
+slugen("Hello World", {
+  locale: "fr", // or ["fr", "de"]
+  separator: "-",
+  lowercase: true,
+  symbols: true,
+  customReplacements: {
+    "&": "and",
+  },
+});
+// hello-world
+```
+
+## Separator
+
+The default separator is -.
+You can also use `_` or `.`
+
+```ts
+slugen("Hello World", { separator: "-" });
+// hello-world
+slugen("Hello World", { separator: "_" });
+// hello_world
+slugen("Hello World", { separator: "." });
+// hello.world
+```
+The separator must be a single character.
+
+## Locale Support
+
+By default, slugen uses Unicode normalization and removes diacritics.
+You can optionally provide a locale for better language-specific handling.
+
+```ts
+import { slugen } from "slugen";
+
+slugen("Café français", { locale: "fr" });
+// → "cafe-francais"
+slugen("Español México", { locale: "es" });
+// → "espanol-mexico"
+slugen("İstanbul Boğazı", { locale: "tr" });
+// istanbul-bogazi
+slugen("Straße Größe", { locale: "de" });
+// strasse-grosse
+
+```
+### Multiple locales (merged)
+```ts
+slugen("İstanbul Straße Español", { locale: ["tr", "de", "es"]});
+// istanbul-strasse-espanol
+```
+Locales are applied in order and safely merged.
+
+## Symbol Handling
+
+slugen categorizes symbols into three groups:
+
+### Examples:
+```ts
+slugen("foo & bar"); 
+// foo-and-bar
+slugen("email@test.com");
+// email-at-test-com
+slugen("50€");
+// 50-euro
+slugen("foo & bar");
+// foo-and-bar
+slugen("100$ price");
+// 100-dollar-price
+slugen("50% off");
+// 50-percent-off
+```
+
+### Disable Symbols
+```ts
+slugen("foo & bar", { symbols: false });
+// foo-bar
+```
+
+## Custom Replacements
+
+```ts
+slugen("React & Vue", {
+  customReplacements: {
+    "&": "and",
+    "React": "react-js"
+  }
+});
+// react-js-and-vue
+
+slugen("C++ Programming", {
+  customReplacements: {
+    "++": "plus-plus"
+  }
+});
+// c-plus-plus-programming
+```
+
+
+## Real-World Examples
+```ts
+slugen("How to Learn JavaScript in 2025?");
+// how-to-learn-javascript-in-2025
+slugen("React vs Vue: Which is Better?");
+// react-vs-vue-which-is-better
+slugen("iPhone 15 Pro Max");
+// iphone-15-pro-max
+slugen("Samsung 55\" 4K Smart TV");
+// samsung-55-4k-smart-tv
+```
+
+### Usernames:
+
+```ts
+slugen("John Doe", { separator: "_" });
+// john_doe
+
+slugen("jane.smith@example", { separator: "_" });
+// jane_smith_at_example
+```
+
+### Filenames:
+
+```ts
+slugen("Project Report 2024.pdf", { separator: "_" });
+// project_report_2024_pdf
+```
+
+
+## API Reference
+
+### ``slugen(text, options?)``
+
+Generates a slug from the given text.
+
+**Parameters:**
+- `text` (string) - Text to convert into a slug
+- `options` (object, optional) - Configuration options
+
+**Options:**
+
+| Option               | Type                     | Default     | Description                                     |
+| -------------------- | ------------------------ | ----------- | ----------------------------------------------- |
+| `locale`             | `string \| string[]`     | `undefined` | Language support (e.g., `"tr"`, `"de"`, `"fr"`) |
+| `separator`          | `"-" \| "_" \| "."`      | `"-"`       | Character to separate words                     |
+| `lowercase`          | `boolean`                | `true`      | Convert to lowercase                            |
+| `symbols`            | `boolean`                | `true`      | Enable symbol normalization                     |
+| `customReplacements` | `Record<string, string>` | `{}`        | Custom character replacements                   |
+
+**Returns:** `string` - Generated slug
+
+
+## Design Notes
+
+- ``applySymbols`` only normalizes text; it does not decide slug structure
+- A single regex pass handles final slug normalization
+- Locale and separator behavior is deterministic
+- Minimal API surface, easy to extend
+
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request on GitHub.
+
+
+## License
+MIT
+

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+interface SlugenOptions {
+    locale?: string | string[];
+    separator?: string;
+    lowercase?: boolean;
+    symbols?: boolean;
+    customReplacements?: Record<string, string>;
+}
+
+declare function slugen(input: string, options?: SlugenOptions): string;
+
+type LocaleMap = Record<string, string>;
+/**
+ * Locale definitions
+ */
+declare const locales: Record<string, LocaleMap>;
+
+export { type SlugenOptions, locales, slugen };

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+interface SlugenOptions {
+    locale?: string | string[];
+    separator?: string;
+    lowercase?: boolean;
+    symbols?: boolean;
+    customReplacements?: Record<string, string>;
+}
+
+declare function slugen(input: string, options?: SlugenOptions): string;
+
+type LocaleMap = Record<string, string>;
+/**
+ * Locale definitions
+ */
+declare const locales: Record<string, LocaleMap>;
+
+export { type SlugenOptions, locales, slugen };

package/dist/index.js

@@ -0,0 +1,173 @@
+'use strict';
+
+// src/locales.ts
+var locales = {
+  de: {
+    \u00C4: "a",
+    \u00E4: "a",
+    \u00D6: "o",
+    \u00F6: "o",
+    \u00DC: "u",
+    \u00FC: "u",
+    \u00DF: "ss"
+  },
+  fr: {
+    \u00C0: "a",
+    \u00C1: "a",
+    \u00C2: "a",
+    \u00C3: "a",
+    \u00C4: "a",
+    \u00C5: "a",
+    \u00E0: "a",
+    \u00E1: "a",
+    \u00E2: "a",
+    \u00E3: "a",
+    \u00E4: "a",
+    \u00E5: "a",
+    \u00C7: "c",
+    \u00E7: "c",
+    \u00C8: "e",
+    \u00C9: "e",
+    \u00CA: "e",
+    \u00CB: "e",
+    \u00E8: "e",
+    \u00E9: "e",
+    \u00EA: "e",
+    \u00EB: "e",
+    \u0152: "oe",
+    \u0153: "oe"
+  },
+  es: {
+    \u00D1: "n",
+    \u00F1: "n"
+  },
+  tr: {
+    \u0130: "i",
+    I: "i",
+    \u0131: "i",
+    \u015E: "s",
+    \u015F: "s",
+    \u011E: "g",
+    \u011F: "g",
+    \u00D6: "o",
+    \u00F6: "o",
+    \u00DC: "u",
+    \u00FC: "u",
+    \u00C7: "c",
+    \u00E7: "c"
+  },
+  pl: {
+    \u0141: "l",
+    \u0142: "l",
+    \u015A: "s",
+    \u015B: "s",
+    \u017B: "z",
+    \u017C: "z"
+  },
+  en: {}
+};
+var localeCache = /* @__PURE__ */ new Map();
+function mergeLocales(localeKeys) {
+  const merged = {};
+  for (const key of localeKeys) {
+    const locale = locales[key];
+    if (!locale) continue;
+    Object.assign(merged, locale);
+  }
+  return merged;
+}
+function applyLocale(text, locale) {
+  if (!locale) return text;
+  const keys = Array.isArray(locale) ? locale : [locale];
+  const cacheKey = keys.sort().join("+");
+  let cached = localeCache.get(cacheKey);
+  if (!cached) {
+    const map = mergeLocales(keys);
+    if (Object.keys(map).length === 0) {
+      localeCache.set(cacheKey, { map, regex: /$^/ });
+      return text;
+    }
+    const pattern = new RegExp(`[${Object.keys(map).join("")}]`, "g");
+    cached = { map, regex: pattern };
+    localeCache.set(cacheKey, cached);
+  }
+  return text.replace(cached.regex, (char) => cached.map[char] ?? char);
+}
+
+// src/symbols.ts
+var symbols = {
+  // Logical / textual (semantic)
+  "&": " and ",
+  "|": " or ",
+  "@": " at ",
+  "%": " percent ",
+  "+": " plus ",
+  "=": " equals ",
+  // Currency (semantic)
+  $: " dollar ",
+  "\u20AC": " euro ",
+  "\xA3": " pound ",
+  "\u20BA": " lira ",
+  "\xA5": " yen ",
+  "\u20B9": " rupee ",
+  // Separators
+  ".": " ",
+  "/": " ",
+  "\\": " ",
+  _: " ",
+  // Noise (strip)
+  "<": "",
+  ">": "",
+  "~": "",
+  "^": "",
+  "?": "",
+  "!": "",
+  ",": "",
+  ":": "",
+  ";": "",
+  "'": "",
+  '"': "",
+  "`": "",
+  "*": "",
+  "#": "",
+  "(": "",
+  ")": "",
+  "[": "",
+  "]": "",
+  "{": "",
+  "}": ""
+};
+var escapeRegex = (char) => char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var BASE_SYMBOL_REGEX = new RegExp(`[${Object.keys(symbols).map(escapeRegex).join("")}]`, "g");
+function applySymbols(text, custom) {
+  const map = custom ? { ...symbols, ...custom } : symbols;
+  const regex = map === symbols ? BASE_SYMBOL_REGEX : new RegExp(`[${Object.keys(map).map(escapeRegex).join("")}]`, "g");
+  return text.replace(regex, (char) => map[char] ?? "");
+}
+
+// src/slugen.ts
+function escapeRegex2(char) {
+  return char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function slugen(input, options = {}) {
+  if (!input) return "";
+  const separator = options.separator ?? "-";
+  const safeSeparator = escapeRegex2(separator);
+  let text = input;
+  if (options.symbols !== false) {
+    text = applySymbols(text, options.customReplacements);
+  }
+  text = applyLocale(text, options.locale);
+  text = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+  text = text.replace(/[^a-zA-Z0-9]+/g, separator);
+  text = text.replace(new RegExp(`^${safeSeparator}+|${safeSeparator}+$`, "g"), "");
+  if (options.lowercase !== false) {
+    text = text.toLowerCase();
+  }
+  return text;
+}
+
+exports.locales = locales;
+exports.slugen = slugen;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locales.ts","../src/symbols.ts","../src/slugen.ts"],"names":["escapeRegex"],"mappings":"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","file":"index.js","sourcesContent":["type LocaleMap = Record<string, string>;\r\n\r\n/**\r\n * Locale definitions\r\n */\r\nexport const locales: Record<string, LocaleMap> = {\r\n  de: {\r\n    Ä: \"a\",\r\n    ä: \"a\",\r\n    Ö: \"o\",\r\n    ö: \"o\",\r\n    Ü: \"u\",\r\n    ü: \"u\",\r\n    ß: \"ss\",\r\n  },\r\n\r\n  fr: {\r\n    À: \"a\",\r\n    Á: \"a\",\r\n    Â: \"a\",\r\n    Ã: \"a\",\r\n    Ä: \"a\",\r\n    Å: \"a\",\r\n    à: \"a\",\r\n    á: \"a\",\r\n    â: \"a\",\r\n    ã: \"a\",\r\n    ä: \"a\",\r\n    å: \"a\",\r\n    Ç: \"c\",\r\n    ç: \"c\",\r\n    È: \"e\",\r\n    É: \"e\",\r\n    Ê: \"e\",\r\n    Ë: \"e\",\r\n    è: \"e\",\r\n    é: \"e\",\r\n    ê: \"e\",\r\n    ë: \"e\",\r\n    Œ: \"oe\",\r\n    œ: \"oe\",\r\n  },\r\n\r\n  es: {\r\n    Ñ: \"n\",\r\n    ñ: \"n\",\r\n  },\r\n\r\n  tr: {\r\n    İ: \"i\",\r\n    I: \"i\",\r\n    ı: \"i\",\r\n    Ş: \"s\",\r\n    ş: \"s\",\r\n    Ğ: \"g\",\r\n    ğ: \"g\",\r\n    Ö: \"o\",\r\n    ö: \"o\",\r\n    Ü: \"u\",\r\n    ü: \"u\",\r\n    Ç: \"c\",\r\n    ç: \"c\",\r\n  },\r\n\r\n  pl: {\r\n    Ł: \"l\",\r\n    ł: \"l\",\r\n    Ś: \"s\",\r\n    ś: \"s\",\r\n    Ż: \"z\",\r\n    ż: \"z\",\r\n  },\r\n\r\n  en: {},\r\n};\r\n\r\n/**\r\n * Cache: localeKey -> { map, regex }\r\n */\r\nconst localeCache = new Map<string, { map: LocaleMap; regex: RegExp }>();\r\n\r\n/**\r\n * Merge multiple locales into a single map\r\n */\r\nfunction mergeLocales(localeKeys: string[]): LocaleMap {\r\n  const merged: LocaleMap = {};\r\n\r\n  for (const key of localeKeys) {\r\n    const locale = locales[key];\r\n    if (!locale) continue;\r\n    Object.assign(merged, locale);\r\n  }\r\n\r\n  return merged;\r\n}\r\n\r\n/**\r\n * Apply locale replacements\r\n *\r\n * Supports:\r\n *  - 'fr'\r\n *  - ['fr', 'de']\r\n */\r\nexport function applyLocale(text: string, locale?: string | string[]): string {\r\n  if (!locale) return text;\r\n\r\n  const keys = Array.isArray(locale) ? locale : [locale];\r\n  const cacheKey = keys.sort().join(\"+\");\r\n\r\n  let cached = localeCache.get(cacheKey);\r\n\r\n  if (!cached) {\r\n    const map = mergeLocales(keys);\r\n\r\n    if (Object.keys(map).length === 0) {\r\n      localeCache.set(cacheKey, { map, regex: /$^/ });\r\n      return text;\r\n    }\r\n\r\n    const pattern = new RegExp(`[${Object.keys(map).join(\"\")}]`, \"g\");\r\n\r\n    cached = { map, regex: pattern };\r\n    localeCache.set(cacheKey, cached);\r\n  }\r\n\r\n  return text.replace(cached.regex, (char) => cached!.map[char] ?? char);\r\n}\r\n","/**\r\n * Common symbols and their slug-friendly replacements\r\n * Policy:\r\n * - semantic symbols => \" word \"\r\n * - separators => \" \"\r\n * - noise => \"\"\r\n */\r\n\r\nexport const symbols: Record<string, string> = {\r\n  // Logical / textual (semantic)\r\n  \"&\": \" and \",\r\n  \"|\": \" or \",\r\n  \"@\": \" at \",\r\n  \"%\": \" percent \",\r\n  \"+\": \" plus \",\r\n  \"=\": \" equals \",\r\n\r\n  // Currency (semantic)\r\n  $: \" dollar \",\r\n  \"€\": \" euro \",\r\n  \"£\": \" pound \",\r\n  \"₺\": \" lira \",\r\n  \"¥\": \" yen \",\r\n  \"₹\": \" rupee \",\r\n\r\n  // Separators\r\n  \".\": \" \",\r\n  \"/\": \" \",\r\n  \"\\\\\": \" \",\r\n  _: \" \",\r\n\r\n  // Noise (strip)\r\n  \"<\": \"\",\r\n  \">\": \"\",\r\n  \"~\": \"\",\r\n  \"^\": \"\",\r\n  \"?\": \"\",\r\n  \"!\": \"\",\r\n  \",\": \"\",\r\n  \":\": \"\",\r\n  \";\": \"\",\r\n  \"'\": \"\",\r\n  '\"': \"\",\r\n  \"`\": \"\",\r\n  \"*\": \"\",\r\n  \"#\": \"\",\r\n  \"(\": \"\",\r\n  \")\": \"\",\r\n  \"[\": \"\",\r\n  \"]\": \"\",\r\n  \"{\": \"\",\r\n  \"}\": \"\",\r\n};\r\n\r\n/** Escape regex special chars safely */\r\nconst escapeRegex = (char: string) => char.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n\r\nconst BASE_SYMBOL_REGEX = new RegExp(`[${Object.keys(symbols).map(escapeRegex).join(\"\")}]`, \"g\");\r\n\r\nexport function applySymbols(text: string, custom?: Record<string, string>) {\r\n  const map = custom ? { ...symbols, ...custom } : symbols;\r\n  const regex = map === symbols ? BASE_SYMBOL_REGEX : new RegExp(`[${Object.keys(map).map(escapeRegex).join(\"\")}]`, \"g\");\r\n\r\n  return text.replace(regex, (char) => map[char] ?? \"\");\r\n}\r\n","import { SlugenOptions } from \"./types\";\r\nimport { applyLocale } from \"./locales\";\r\nimport { applySymbols } from \"./symbols\";\r\n\r\nfunction escapeRegex(char: string) {\r\n  return char.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n\r\nexport function slugen(input: string, options: SlugenOptions = {}): string {\r\n  if (!input) return \"\";\r\n\r\n  const separator = options.separator ?? \"-\";\r\n  const safeSeparator = escapeRegex(separator);\r\n  let text = input;\r\n\r\n  // Symbols (default true)\r\n  if (options.symbols !== false) {\r\n    text = applySymbols(text, options.customReplacements);\r\n  }\r\n\r\n  // Locale\r\n  text = applyLocale(text, options.locale);\r\n\r\n  // Normalize & remove diacritics\r\n  text = text.normalize(\"NFD\").replace(/[\\u0300-\\u036f]/g, \"\");\r\n\r\n  // Replace non-alphanumeric with separator\r\n  text = text.replace(/[^a-zA-Z0-9]+/g, separator);\r\n\r\n  // Trim separator (SAFE)\r\n  text = text.replace(new RegExp(`^${safeSeparator}+|${safeSeparator}+$`, \"g\"), \"\");\r\n\r\n  // Lowercase (default true)\r\n  if (options.lowercase !== false) {\r\n    text = text.toLowerCase();\r\n  }\r\n\r\n  return text;\r\n}\r\n"]}

package/dist/index.mjs

@@ -0,0 +1,170 @@
+// src/locales.ts
+var locales = {
+  de: {
+    \u00C4: "a",
+    \u00E4: "a",
+    \u00D6: "o",
+    \u00F6: "o",
+    \u00DC: "u",
+    \u00FC: "u",
+    \u00DF: "ss"
+  },
+  fr: {
+    \u00C0: "a",
+    \u00C1: "a",
+    \u00C2: "a",
+    \u00C3: "a",
+    \u00C4: "a",
+    \u00C5: "a",
+    \u00E0: "a",
+    \u00E1: "a",
+    \u00E2: "a",
+    \u00E3: "a",
+    \u00E4: "a",
+    \u00E5: "a",
+    \u00C7: "c",
+    \u00E7: "c",
+    \u00C8: "e",
+    \u00C9: "e",
+    \u00CA: "e",
+    \u00CB: "e",
+    \u00E8: "e",
+    \u00E9: "e",
+    \u00EA: "e",
+    \u00EB: "e",
+    \u0152: "oe",
+    \u0153: "oe"
+  },
+  es: {
+    \u00D1: "n",
+    \u00F1: "n"
+  },
+  tr: {
+    \u0130: "i",
+    I: "i",
+    \u0131: "i",
+    \u015E: "s",
+    \u015F: "s",
+    \u011E: "g",
+    \u011F: "g",
+    \u00D6: "o",
+    \u00F6: "o",
+    \u00DC: "u",
+    \u00FC: "u",
+    \u00C7: "c",
+    \u00E7: "c"
+  },
+  pl: {
+    \u0141: "l",
+    \u0142: "l",
+    \u015A: "s",
+    \u015B: "s",
+    \u017B: "z",
+    \u017C: "z"
+  },
+  en: {}
+};
+var localeCache = /* @__PURE__ */ new Map();
+function mergeLocales(localeKeys) {
+  const merged = {};
+  for (const key of localeKeys) {
+    const locale = locales[key];
+    if (!locale) continue;
+    Object.assign(merged, locale);
+  }
+  return merged;
+}
+function applyLocale(text, locale) {
+  if (!locale) return text;
+  const keys = Array.isArray(locale) ? locale : [locale];
+  const cacheKey = keys.sort().join("+");
+  let cached = localeCache.get(cacheKey);
+  if (!cached) {
+    const map = mergeLocales(keys);
+    if (Object.keys(map).length === 0) {
+      localeCache.set(cacheKey, { map, regex: /$^/ });
+      return text;
+    }
+    const pattern = new RegExp(`[${Object.keys(map).join("")}]`, "g");
+    cached = { map, regex: pattern };
+    localeCache.set(cacheKey, cached);
+  }
+  return text.replace(cached.regex, (char) => cached.map[char] ?? char);
+}
+
+// src/symbols.ts
+var symbols = {
+  // Logical / textual (semantic)
+  "&": " and ",
+  "|": " or ",
+  "@": " at ",
+  "%": " percent ",
+  "+": " plus ",
+  "=": " equals ",
+  // Currency (semantic)
+  $: " dollar ",
+  "\u20AC": " euro ",
+  "\xA3": " pound ",
+  "\u20BA": " lira ",
+  "\xA5": " yen ",
+  "\u20B9": " rupee ",
+  // Separators
+  ".": " ",
+  "/": " ",
+  "\\": " ",
+  _: " ",
+  // Noise (strip)
+  "<": "",
+  ">": "",
+  "~": "",
+  "^": "",
+  "?": "",
+  "!": "",
+  ",": "",
+  ":": "",
+  ";": "",
+  "'": "",
+  '"': "",
+  "`": "",
+  "*": "",
+  "#": "",
+  "(": "",
+  ")": "",
+  "[": "",
+  "]": "",
+  "{": "",
+  "}": ""
+};
+var escapeRegex = (char) => char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var BASE_SYMBOL_REGEX = new RegExp(`[${Object.keys(symbols).map(escapeRegex).join("")}]`, "g");
+function applySymbols(text, custom) {
+  const map = custom ? { ...symbols, ...custom } : symbols;
+  const regex = map === symbols ? BASE_SYMBOL_REGEX : new RegExp(`[${Object.keys(map).map(escapeRegex).join("")}]`, "g");
+  return text.replace(regex, (char) => map[char] ?? "");
+}
+
+// src/slugen.ts
+function escapeRegex2(char) {
+  return char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function slugen(input, options = {}) {
+  if (!input) return "";
+  const separator = options.separator ?? "-";
+  const safeSeparator = escapeRegex2(separator);
+  let text = input;
+  if (options.symbols !== false) {
+    text = applySymbols(text, options.customReplacements);
+  }
+  text = applyLocale(text, options.locale);
+  text = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+  text = text.replace(/[^a-zA-Z0-9]+/g, separator);
+  text = text.replace(new RegExp(`^${safeSeparator}+|${safeSeparator}+$`, "g"), "");
+  if (options.lowercase !== false) {
+    text = text.toLowerCase();
+  }
+  return text;
+}
+
+export { locales, slugen };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locales.ts","../src/symbols.ts","../src/slugen.ts"],"names":["escapeRegex"],"mappings":"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","file":"index.mjs","sourcesContent":["type LocaleMap = Record<string, string>;\r\n\r\n/**\r\n * Locale definitions\r\n */\r\nexport const locales: Record<string, LocaleMap> = {\r\n  de: {\r\n    Ä: \"a\",\r\n    ä: \"a\",\r\n    Ö: \"o\",\r\n    ö: \"o\",\r\n    Ü: \"u\",\r\n    ü: \"u\",\r\n    ß: \"ss\",\r\n  },\r\n\r\n  fr: {\r\n    À: \"a\",\r\n    Á: \"a\",\r\n    Â: \"a\",\r\n    Ã: \"a\",\r\n    Ä: \"a\",\r\n    Å: \"a\",\r\n    à: \"a\",\r\n    á: \"a\",\r\n    â: \"a\",\r\n    ã: \"a\",\r\n    ä: \"a\",\r\n    å: \"a\",\r\n    Ç: \"c\",\r\n    ç: \"c\",\r\n    È: \"e\",\r\n    É: \"e\",\r\n    Ê: \"e\",\r\n    Ë: \"e\",\r\n    è: \"e\",\r\n    é: \"e\",\r\n    ê: \"e\",\r\n    ë: \"e\",\r\n    Œ: \"oe\",\r\n    œ: \"oe\",\r\n  },\r\n\r\n  es: {\r\n    Ñ: \"n\",\r\n    ñ: \"n\",\r\n  },\r\n\r\n  tr: {\r\n    İ: \"i\",\r\n    I: \"i\",\r\n    ı: \"i\",\r\n    Ş: \"s\",\r\n    ş: \"s\",\r\n    Ğ: \"g\",\r\n    ğ: \"g\",\r\n    Ö: \"o\",\r\n    ö: \"o\",\r\n    Ü: \"u\",\r\n    ü: \"u\",\r\n    Ç: \"c\",\r\n    ç: \"c\",\r\n  },\r\n\r\n  pl: {\r\n    Ł: \"l\",\r\n    ł: \"l\",\r\n    Ś: \"s\",\r\n    ś: \"s\",\r\n    Ż: \"z\",\r\n    ż: \"z\",\r\n  },\r\n\r\n  en: {},\r\n};\r\n\r\n/**\r\n * Cache: localeKey -> { map, regex }\r\n */\r\nconst localeCache = new Map<string, { map: LocaleMap; regex: RegExp }>();\r\n\r\n/**\r\n * Merge multiple locales into a single map\r\n */\r\nfunction mergeLocales(localeKeys: string[]): LocaleMap {\r\n  const merged: LocaleMap = {};\r\n\r\n  for (const key of localeKeys) {\r\n    const locale = locales[key];\r\n    if (!locale) continue;\r\n    Object.assign(merged, locale);\r\n  }\r\n\r\n  return merged;\r\n}\r\n\r\n/**\r\n * Apply locale replacements\r\n *\r\n * Supports:\r\n *  - 'fr'\r\n *  - ['fr', 'de']\r\n */\r\nexport function applyLocale(text: string, locale?: string | string[]): string {\r\n  if (!locale) return text;\r\n\r\n  const keys = Array.isArray(locale) ? locale : [locale];\r\n  const cacheKey = keys.sort().join(\"+\");\r\n\r\n  let cached = localeCache.get(cacheKey);\r\n\r\n  if (!cached) {\r\n    const map = mergeLocales(keys);\r\n\r\n    if (Object.keys(map).length === 0) {\r\n      localeCache.set(cacheKey, { map, regex: /$^/ });\r\n      return text;\r\n    }\r\n\r\n    const pattern = new RegExp(`[${Object.keys(map).join(\"\")}]`, \"g\");\r\n\r\n    cached = { map, regex: pattern };\r\n    localeCache.set(cacheKey, cached);\r\n  }\r\n\r\n  return text.replace(cached.regex, (char) => cached!.map[char] ?? char);\r\n}\r\n","/**\r\n * Common symbols and their slug-friendly replacements\r\n * Policy:\r\n * - semantic symbols => \" word \"\r\n * - separators => \" \"\r\n * - noise => \"\"\r\n */\r\n\r\nexport const symbols: Record<string, string> = {\r\n  // Logical / textual (semantic)\r\n  \"&\": \" and \",\r\n  \"|\": \" or \",\r\n  \"@\": \" at \",\r\n  \"%\": \" percent \",\r\n  \"+\": \" plus \",\r\n  \"=\": \" equals \",\r\n\r\n  // Currency (semantic)\r\n  $: \" dollar \",\r\n  \"€\": \" euro \",\r\n  \"£\": \" pound \",\r\n  \"₺\": \" lira \",\r\n  \"¥\": \" yen \",\r\n  \"₹\": \" rupee \",\r\n\r\n  // Separators\r\n  \".\": \" \",\r\n  \"/\": \" \",\r\n  \"\\\\\": \" \",\r\n  _: \" \",\r\n\r\n  // Noise (strip)\r\n  \"<\": \"\",\r\n  \">\": \"\",\r\n  \"~\": \"\",\r\n  \"^\": \"\",\r\n  \"?\": \"\",\r\n  \"!\": \"\",\r\n  \",\": \"\",\r\n  \":\": \"\",\r\n  \";\": \"\",\r\n  \"'\": \"\",\r\n  '\"': \"\",\r\n  \"`\": \"\",\r\n  \"*\": \"\",\r\n  \"#\": \"\",\r\n  \"(\": \"\",\r\n  \")\": \"\",\r\n  \"[\": \"\",\r\n  \"]\": \"\",\r\n  \"{\": \"\",\r\n  \"}\": \"\",\r\n};\r\n\r\n/** Escape regex special chars safely */\r\nconst escapeRegex = (char: string) => char.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n\r\nconst BASE_SYMBOL_REGEX = new RegExp(`[${Object.keys(symbols).map(escapeRegex).join(\"\")}]`, \"g\");\r\n\r\nexport function applySymbols(text: string, custom?: Record<string, string>) {\r\n  const map = custom ? { ...symbols, ...custom } : symbols;\r\n  const regex = map === symbols ? BASE_SYMBOL_REGEX : new RegExp(`[${Object.keys(map).map(escapeRegex).join(\"\")}]`, \"g\");\r\n\r\n  return text.replace(regex, (char) => map[char] ?? \"\");\r\n}\r\n","import { SlugenOptions } from \"./types\";\r\nimport { applyLocale } from \"./locales\";\r\nimport { applySymbols } from \"./symbols\";\r\n\r\nfunction escapeRegex(char: string) {\r\n  return char.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n\r\nexport function slugen(input: string, options: SlugenOptions = {}): string {\r\n  if (!input) return \"\";\r\n\r\n  const separator = options.separator ?? \"-\";\r\n  const safeSeparator = escapeRegex(separator);\r\n  let text = input;\r\n\r\n  // Symbols (default true)\r\n  if (options.symbols !== false) {\r\n    text = applySymbols(text, options.customReplacements);\r\n  }\r\n\r\n  // Locale\r\n  text = applyLocale(text, options.locale);\r\n\r\n  // Normalize & remove diacritics\r\n  text = text.normalize(\"NFD\").replace(/[\\u0300-\\u036f]/g, \"\");\r\n\r\n  // Replace non-alphanumeric with separator\r\n  text = text.replace(/[^a-zA-Z0-9]+/g, separator);\r\n\r\n  // Trim separator (SAFE)\r\n  text = text.replace(new RegExp(`^${safeSeparator}+|${safeSeparator}+$`, \"g\"), \"\");\r\n\r\n  // Lowercase (default true)\r\n  if (options.lowercase !== false) {\r\n    text = text.toLowerCase();\r\n  }\r\n\r\n  return text;\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "slugen",
+  "version": "0.1.1",
+  "description": "Modern and lightweight slug generator for URLs, permalinks, and identifiers with multi-language support",
+  "keywords": [
+    "slug",
+    "slug-generator",
+    "url-slug",
+    "permalink",
+    "seo",
+    "url",
+    "identifier",
+    "string-normalization",
+    "multilingual",
+    "i18n",
+    "typescript"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "homepage": "https://github.com/kabledev/slugen",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kabledev/slugen.git"
+  },
+  "author": "Kable",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest tests/slugen.spec.ts --run",
+    "bench": "vitest tests/bench.spec.ts --run"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}