string-filters 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tarkhov
+
+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,209 @@
+# Javascript String Filters
+
+Fast native javascript string filters library.
+
+### Contents
+
+1. [Compatibility](#compatibility)
+2. [Installation](#installation)
+   1. [NPM](#npm)
+   2. [Manually](#manually)
+3. [Usage](#usage)
+   1. [Camel case](#camel-case)
+   2. [Capitalize](#capitalize)
+   3. [Flat case](#flat-case)
+   4. [Kebab case](#kebab-case)
+   5. [Pad](#pad)
+   6. [Pascal case](#pascal-case)
+   7. [Snake case](#snake-case)
+   8. [Train case](#train-case)
+   9. [Truncate](#truncate)
+4. [Author](#author)
+5. [License](#license)
+
+## Compatibility
+
+Browser | Version
+------- | -------
+Chrome | >= 107
+Edge | >= 107
+Firefox | >= 104
+Safari | >= 16
+
+## Installation
+
+### NPM
+
+```bash
+npm install string-filters
+```
+
+### Manually
+
+[Download](https://github.com/tarkhov/js-string-filters/releases/download/v0.1.0/js-string-filters.zip) package and unpack it or use following commands:
+
+```bash
+wget https://github.com/tarkhov/js-string-filters/releases/download/v0.1.0/js-string-filters.zip
+unzip js-string-filters.zip
+```
+
+## Usage
+
+### Camel case
+
+```js
+import { camelCase } from 'string-filters'
+
+let result = ''
+result = camelCase('camel 123 casE')
+// Output: camelCasE
+console.log(result)
+
+result = camelCase('camel 123 casE', { numbers: true })
+// Output: camel123CasE
+console.log(result)
+
+result = camelCase('cameL 123 casE', { lower: true })
+// Output: camelCase
+console.log(result)
+
+result = camelCase('cameL 123 casE', { numbers: true, lower: true })
+// Output: camel123Case
+console.log(result)
+```
+
+### Capitalize
+
+```js
+import { capitalize } from 'string-filters'
+
+let result = ''
+result = capitalize('capitalizE')
+// Output: CapitalizE
+console.log(result)
+
+result = capitalize('cApitalizE', true)
+// Output: Capitalize
+console.log(result)
+```
+
+### Flat case
+
+```js
+import { flatCase } from 'string-filters'
+
+let result = ''
+result = flatCase('Flat 123 Case')
+// Output: flatcase
+console.log(result)
+
+result = flatCase('Flat 123 Case', true)
+// Output: flat123case
+console.log(result)
+```
+
+### Kebab case
+
+```js
+import { kebabCase } from 'string-filters'
+
+let result = ''
+result = kebabCase('Kebab 123 Case')
+// Output: kebab-case
+console.log(result)
+
+result = kebabCase('Kebab 123 Case', true)
+// Output: kebab-123-case
+console.log(result)
+```
+
+### Pad
+
+```js
+import { pad } from 'string-filters'
+
+let result = ''
+result = pad('pad', 10, '_')
+// Output: ___pad____
+console.log(result)
+```
+
+### Pascal case
+
+```js
+import { pascalCase } from 'string-filters'
+
+let result = ''
+result = pascalCase('pascal 123 casE')
+// Output: PascalCasE
+console.log(result)
+
+result = pascalCase('pascal 123 casE', { numbers: true })
+// Output: Pascal123CasE
+console.log(result)
+
+result = pascalCase('pascaL 123 casE', { lower: true })
+// Output: PascalCase
+console.log(result)
+
+result = pascalCase('pascaL 123 casE', { numbers: true, lower: true })
+// Output: Pascal123Case
+console.log(result)
+```
+
+### Snake case
+
+```js
+import { snakeCase } from 'string-filters'
+
+let result = ''
+result = snakeCase('Snake 123 Case')
+// Output: snake_case
+console.log(result)
+
+result = snakeCase('Snake 123 Case', true)
+// Output: snake_123_case
+console.log(result)
+```
+
+### Train case
+
+```js
+import { trainCase } from 'string-filters'
+
+let result = ''
+result = trainCase('train 123 casE')
+// Output: Train-CasE
+console.log(result)
+
+result = trainCase('train 123 casE', { numbers: true })
+// Output: Train-123-CasE
+console.log(result)
+
+result = trainCase('traiN 123 casE', { lower: true })
+// Output: Train-Case
+console.log(result)
+
+result = trainCase('traiN 123 casE', { numbers: true, lower: true })
+// Output: Train-123-Case
+console.log(result)
+```
+
+### Truncate
+
+```js
+import { truncate } from 'string-filters'
+
+let result = truncate('etcetera', 3, '...')
+// Output: etc...
+console.log(result)
+```
+
+## Author
+
+* [Twitter](https://x.com/tarkhovich)
+* [Medium](https://medium.com/@tarkhov)
+
+## License
+
+This project is licensed under the **MIT License** - see the `LICENSE` file for details.

package/dist/string-filters.js

@@ -0,0 +1,49 @@
+function a(r, t = !1) {
+  let n = r.charAt(0).toUpperCase(), e = r.slice(1);
+  return t && (e = e.toLowerCase()), `${n}${e}`;
+}
+function s(r, t = { numbers: !1, lower: !1 }) {
+  let n = t.numbers ? /[\p{L}\p{N}]+/gu : /[\p{L}]+/gu, e = r.match(n);
+  if (e.length <= 1)
+    return null;
+  let l = e.shift();
+  return t.lower && (l = l.toLowerCase()), e = e.map((u) => a(u, t.lower)), e.unshift(l), e.join("");
+}
+function o(r, t = !1) {
+  let n = t ? /[\p{L}\p{N}]+/gu : /[\p{L}]+/gu, e = r.match(n);
+  return e.length <= 1 ? null : e.map((l) => l.toLowerCase()).join("");
+}
+function p(r, t = !1) {
+  let n = t ? /[\p{L}\p{N}-]+/gu : /[\p{L}-]+/gu, e = r.match(n);
+  return e.length <= 1 ? null : e.map((l) => l.toLowerCase()).join("-");
+}
+function f(r, t, n = " ") {
+  const e = Math.floor((t - r.length) / 2) + r.length;
+  return r.padStart(e, n).padEnd(t, n);
+}
+function i(r, t = { numbers: !1, lower: !1 }) {
+  let n = t.numbers ? /[\p{L}\p{N}]+/gu : /[\p{L}]+/gu, e = r.match(n);
+  return e.length <= 1 ? null : e.map((l) => a(l, t.lower)).join("");
+}
+function c(r, t = !1) {
+  let n = t ? /[\p{L}\p{N}_]+/gu : /[\p{L}_]+/gu, e = r.match(n);
+  return e.length <= 1 ? null : e.map((l) => l.toLowerCase()).join("_");
+}
+function m(r, t = { numbers: !1, lower: !1 }) {
+  let n = t.numbers ? /[\p{L}\p{N}-]+/gu : /[\p{L}-]+/gu, e = r.match(n);
+  return e.length <= 1 ? null : e.map((l) => a(l, t.lower)).join("-");
+}
+function g(r, t = 32, n = "...") {
+  return r.substring(0, t) + n;
+}
+export {
+  s as camelCase,
+  a as capitalize,
+  o as flatCase,
+  p as kebabCase,
+  f as pad,
+  i as pascalCase,
+  c as snakeCase,
+  m as trainCase,
+  g as truncate
+};

package/dist/string-filters.umd.cjs

@@ -0,0 +1 @@
+(function(l,u){typeof exports=="object"&&typeof module<"u"?u(exports):typeof define=="function"&&define.amd?define(["exports"],u):(l=typeof globalThis<"u"?globalThis:l||self,u(l.StringFilters={}))})(this,(function(l){"use strict";function u(n,t=!1){let a=n.charAt(0).toUpperCase(),e=n.slice(1);return t&&(e=e.toLowerCase()),`${a}${e}`}function f(n,t={numbers:!1,lower:!1}){let a=t.numbers?/[\p{L}\p{N}]+/gu:/[\p{L}]+/gu,e=n.match(a);if(e.length<=1)return null;let r=e.shift();return t.lower&&(r=r.toLowerCase()),e=e.map(g=>u(g,t.lower)),e.unshift(r),e.join("")}function s(n,t=!1){let a=t?/[\p{L}\p{N}]+/gu:/[\p{L}]+/gu,e=n.match(a);return e.length<=1?null:e.map(r=>r.toLowerCase()).join("")}function i(n,t=!1){let a=t?/[\p{L}\p{N}-]+/gu:/[\p{L}-]+/gu,e=n.match(a);return e.length<=1?null:e.map(r=>r.toLowerCase()).join("-")}function o(n,t,a=" "){const e=Math.floor((t-n.length)/2)+n.length;return n.padStart(e,a).padEnd(t,a)}function p(n,t={numbers:!1,lower:!1}){let a=t.numbers?/[\p{L}\p{N}]+/gu:/[\p{L}]+/gu,e=n.match(a);return e.length<=1?null:e.map(r=>u(r,t.lower)).join("")}function c(n,t=!1){let a=t?/[\p{L}\p{N}_]+/gu:/[\p{L}_]+/gu,e=n.match(a);return e.length<=1?null:e.map(r=>r.toLowerCase()).join("_")}function m(n,t={numbers:!1,lower:!1}){let a=t.numbers?/[\p{L}\p{N}-]+/gu:/[\p{L}-]+/gu,e=n.match(a);return e.length<=1?null:e.map(r=>u(r,t.lower)).join("-")}function d(n,t=32,a="..."){return n.substring(0,t)+a}l.camelCase=f,l.capitalize=u,l.flatCase=s,l.kebabCase=i,l.pad=o,l.pascalCase=p,l.snakeCase=c,l.trainCase=m,l.truncate=d,Object.defineProperty(l,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "string-filters",
+  "version": "0.1.0",
+  "description": "Fast native javascript string filters library.",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/string-filters.umd.cjs",
+  "module": "./dist/string-filters.js",
+  "exports": {
+    ".": {
+      "import": "./dist/string-filters.js",
+      "require": "./dist/string-filters.umd.cjs"
+    }
+  },
+  "keywords": [
+    "string",
+    "filter",
+    "filters",
+    "formatter",
+    "string-manipulation",
+    "text-processing",
+    "utility",
+    "validation",
+    "transformation",
+    "sanitize",
+    "input-mask",
+    "javascript",
+    "js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tarkhov/js-string-filters.git"
+  },
+  "author": "Tarkhov",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/tarkhov/js-string-filters/issues"
+  },
+  "homepage": "https://github.com/tarkhov/js-string-filters",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "vite": "^7.3.1"
+  }
+}