@pixpilot/string 1.0.2 → 2.0.0

package/README.md

@@ -11,15 +11,28 @@ pnpm add @pixpilot/string
 ## Usage
 
 ```typescript
-import { toCamelCase, toKebabCase } from '@pixpilot/string';
+import { isString, toCamelCase, toKebabCase, truncate } from '@pixpilot/string';
 
-// Example: Convert strings to different cases
+// Case conversion
 const camel = toCamelCase('hello world'); // 'helloWorld'
 const kebab = toKebabCase('hello world'); // 'hello-world'
+
+// String manipulation
+const maxLength = 10;
+const short = truncate('This is a long string', maxLength); // 'This is a ...'
+
+// Type guards and validation
+if (isString(value)) {
+  // value is typed as string
+}
 ```
 
 ## API
 
+### Type Guards
+
+- `isString(value: unknown): value is string` - Type guard to check if a value is a string
+
 ### Case Conversion Functions
 
 - `toCamelCase(str: string): string` - Convert a string to camel case (`fooBar`)
@@ -35,6 +48,27 @@ const kebab = toKebabCase('hello world'); // 'hello-world'
 - `toSnakeCase(str: string): string` - Convert a string to snake case (`snake_case`)
 - `toTrainCase(str: string): string` - Convert a string to train case (`Train-Case`)
 
+### Validation Functions
+
+- `isEmpty(str: string, trimWhitespace?: boolean): boolean` - Check if a string is empty
+- `isAlphanumeric(str: string): boolean` - Check if a string contains only alphanumeric characters
+- `isEmail(str: string): boolean` - Check if a string is a valid email address
+- `isUrl(str: string): boolean` - Check if a string is a valid URL
+
+### Manipulation Functions
+
+- `truncate(str: string, maxLength: number, ellipsis?: string): string` - Truncate a string
+- `capitalize(str: string): string` - Capitalize the first letter
+- `capitalizeFirst(str: string): string` - Capitalize first letter and lowercase rest
+- `reverse(str: string): string` - Reverse a string
+- `removeWhitespace(str: string): string` - Remove all whitespace
+- `normalizeSpaces(str: string): string` - Replace multiple spaces with single space
+- `padStart(str: string, targetLength: number, padString?: string): string` - Pad from the start
+- `padEnd(str: string, targetLength: number, padString?: string): string` - Pad from the end
+- `repeat(str: string, count: number): string` - Repeat a string
+- `countOccurrences(str: string, searchValue: string, caseSensitive?: boolean): number` - Count occurrences
+- `words(str: string): string[]` - Extract words from a string
+
 ## Contributing
 
 We welcome contributions! Please see the [main contributing guide](../../CONTRIBUTING.md) for details.

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";const e=/([\p{Ll}\d])(\p{Lu})/gu,t=/(\p{Lu})([\p{Lu}][\p{Ll}])/gu,n=/(\d)\p{Ll}|(\p{L})\d/u,r=/[^\p{L}\d]+/giu,o="$1\0$2";function c(n){let c=n.trim();c=c.replace(e,o).replace(t,o),c=c.replace(r,"\0");let i=0,a=c.length;for(;"\0"===c.charAt(i);)i++;if(i===a)return[];for(;"\0"===c.charAt(a-1);)a--;return c.slice(i,a).split(/\0/g)}function i(e){const t=c(e);for(let e=0;e<t.length;e++){const r=t[e],o=n.exec(r);if(o){const n=o.index+(o[1]??o[2]).length;t.splice(e,1,r.slice(0,n),r.slice(n))}}return t}function a(e,t){const[n,r,o]=C(e,t);return n+r.map(u(t?.locale)).join(t?.delimiter??" ")+o}function s(e,t){const[n,r,o]=C(e,t),c=u(t?.locale),i=l(t?.locale);return n+r.map(p(c,i)).join(t?.delimiter??" ")+o}function u(e){return!1===e?e=>e.toLowerCase():t=>t.toLocaleLowerCase(e)}function l(e){return!1===e?e=>e.toUpperCase():t=>t.toLocaleUpperCase(e)}function p(e,t){return n=>`${t(n[0])}${e(n.slice(1))}`}function f(e,t){return(n,r)=>{const o=n[0];return(r>0&&o>="0"&&o<="9"?"_"+o:t(o))+e(n.slice(1))}}function C(e,t={}){const n=t.split??(t.separateNumbers?i:c),r=t.prefixCharacters??"",o=t.suffixCharacters??"";let a=0,s=e.length;for(;a<e.length;){const t=e.charAt(a);if(!r.includes(t))break;a++}for(;s>a;){const t=s-1,n=e.charAt(t);if(!o.includes(n))break;s=t}return[e.slice(0,a),n(e.slice(a,s)),e.slice(s)]}exports.toCamelCase=function(e){return function(e,t){const[n,r,o]=C(e,t),c=u(t?.locale),i=l(t?.locale),a=f(c,i);return n+r.map((e,t)=>0===t?c(e):a(e,t)).join("")+o}(e)},exports.toCapitalCase=function(e){return s(e)},exports.toConstantCase=function(e){return function(e,t){const[n,r,o]=C(e,t);return n+r.map(l(t?.locale)).join("_")+o}(e)},exports.toDotCase=function(e){return a(e,{delimiter:".",...t});var t},exports.toKebabCase=function(e){return a(e,{delimiter:"-",...t});var t},exports.toNoCase=function(e){return a(e)},exports.toPascalCase=function(e){return function(e,t){const[n,r,o]=C(e,t),c=f(u(t?.locale),l(t?.locale));return n+r.map(c).join("")+o}(e)},exports.toPascalSnakeCase=function(e){return s(e,{delimiter:"_",...t});var t},exports.toPathCase=function(e){return a(e,{delimiter:"/",...t});var t},exports.toSentenceCase=function(e){return function(e,t){const[n,r,o]=C(e,t),c=u(t?.locale),i=l(t?.locale),a=p(c,i);return n+r.map((e,t)=>0===t?a(e):c(e)).join(" ")+o}(e)},exports.toSnakeCase=function(e){return a(e,{delimiter:"_",...t});var t},exports.toTrainCase=function(e){return s(e,{delimiter:"-",...t});var t};
+"use strict";const t=/([\p{Ll}\d])(\p{Lu})/gu,e=/(\p{Lu})([\p{Lu}][\p{Ll}])/gu,r=/(\d)\p{Ll}|(\p{L})\d/u,n=/[^\p{L}\d]+/giu,o="$1\0$2";function c(r){let c=r.trim();c=c.replace(t,o).replace(e,o),c=c.replace(n,"\0");let i=0,s=c.length;for(;"\0"===c.charAt(i);)i++;if(i===s)return[];for(;"\0"===c.charAt(s-1);)s--;return c.slice(i,s).split(/\0/g)}function i(t){const e=c(t);for(let t=0;t<e.length;t++){const n=e[t],o=r.exec(n);if(o){const r=o.index+(o[1]??o[2]).length;e.splice(t,1,n.slice(0,r),n.slice(r))}}return e}function s(t,e){const[r,n,o]=x(t,e);return r+n.map(a(e?.locale)).join(e?.delimiter??" ")+o}function u(t,e){const[r,n,o]=x(t,e),c=a(e?.locale),i=l(e?.locale);return r+n.map(p(c,i)).join(e?.delimiter??" ")+o}function a(t){return!1===t?t=>t.toLowerCase():e=>e.toLocaleLowerCase(t)}function l(t){return!1===t?t=>t.toUpperCase():e=>e.toLocaleUpperCase(t)}function p(t,e){return r=>`${e(r[0])}${t(r.slice(1))}`}function f(t,e){return(r,n)=>{const o=r[0];return(n>0&&o>="0"&&o<="9"?"_"+o:e(o))+t(r.slice(1))}}function x(t,e={}){const r=e.split??(e.separateNumbers?i:c),n=e.prefixCharacters??"",o=e.suffixCharacters??"";let s=0,u=t.length;for(;s<t.length;){const e=t.charAt(s);if(!n.includes(e))break;s++}for(;u>s;){const e=u-1,r=t.charAt(e);if(!o.includes(r))break;u=e}return[t.slice(0,s),r(t.slice(s,u)),t.slice(u)]}exports.capitalize=function(t){return 0===t.length?t:t.charAt(0).toUpperCase()+t.slice(1)},exports.capitalizeFirst=function(t){return 0===t.length?t:t.charAt(0).toUpperCase()+t.slice(1).toLowerCase()},exports.countOccurrences=function(t,e,r=!0){if(0===e.length)return 0;const n=r?t:t.toLowerCase(),o=r?e:e.toLowerCase();let c=0,i=0;for(;;){const t=n.indexOf(o,i);if(-1===t)break;c++,i=t+1}return c},exports.isAlphanumeric=function(t){return/^[\da-z]+$/iu.test(t)},exports.isEmail=function(t){return/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/u.test(t)},exports.isEmpty=function(t,e=!0){return e?0===t.trim().length:0===t.length},exports.isString=function(t){return"string"==typeof t},exports.isUrl=function(t){try{const e=new URL(t);return Boolean(e)}catch{return!1}},exports.normalizeSpaces=function(t){return t.replace(/\s+/gu," ").trim()},exports.padEnd=function(t,e,r=" "){return t.padEnd(e,r)},exports.padStart=function(t,e,r=" "){return t.padStart(e,r)},exports.removeWhitespace=function(t){return t.replace(/\s+/gu,"")},exports.repeat=function(t,e){return t.repeat(e)},exports.reverse=function(t){return t.split("").reverse().join("")},exports.toCamelCase=function(t){return function(t,e){const[r,n,o]=x(t,e),c=a(e?.locale),i=l(e?.locale),s=f(c,i);return r+n.map((t,e)=>0===e?c(t):s(t,e)).join("")+o}(t)},exports.toCapitalCase=function(t){return u(t)},exports.toConstantCase=function(t){return function(t,e){const[r,n,o]=x(t,e);return r+n.map(l(e?.locale)).join("_")+o}(t)},exports.toDotCase=function(t){return s(t,{delimiter:".",...e});var e},exports.toKebabCase=function(t){return s(t,{delimiter:"-",...e});var e},exports.toNoCase=function(t){return s(t)},exports.toPascalCase=function(t){return function(t,e){const[r,n,o]=x(t,e),c=f(a(e?.locale),l(e?.locale));return r+n.map(c).join("")+o}(t)},exports.toPascalSnakeCase=function(t){return u(t,{delimiter:"_",...e});var e},exports.toPathCase=function(t){return s(t,{delimiter:"/",...e});var e},exports.toSentenceCase=function(t){return function(t,e){const[r,n,o]=x(t,e),c=a(e?.locale),i=l(e?.locale),s=p(c,i);return r+n.map((t,e)=>0===e?s(t):c(t)).join(" ")+o}(t)},exports.toSnakeCase=function(t){return s(t,{delimiter:"_",...e});var e},exports.toTrainCase=function(t){return u(t,{delimiter:"-",...e});var e},exports.truncate=function(t,e,r="..."){return t.length<=e?t:t.slice(0,e)+r},exports.words=function(t){return t.match(/[A-Z]?[a-z]+|[A-Z]+(?![a-z])|\d+/gu)||[]};

package/dist/index.d.ts

@@ -1 +1,4 @@
 export * from './case';
+export * from './manipulation';
+export * from './type-guards';
+export * from './validation';

package/dist/index.js

@@ -1 +1 @@
-const n=/([\p{Ll}\d])(\p{Lu})/gu,e=/(\p{Lu})([\p{Lu}][\p{Ll}])/gu,t=/(\d)\p{Ll}|(\p{L})\d/u,r=/[^\p{L}\d]+/giu,c="$1\0$2";function i(t){let i=t.trim();i=i.replace(n,c).replace(e,c),i=i.replace(r,"\0");let o=0,u=i.length;for(;"\0"===i.charAt(o);)o++;if(o===u)return[];for(;"\0"===i.charAt(u-1);)u--;return i.slice(o,u).split(/\0/g)}function o(n){const e=i(n);for(let n=0;n<e.length;n++){const r=e[n],c=t.exec(r);if(c){const t=c.index+(c[1]??c[2]).length;e.splice(n,1,r.slice(0,t),r.slice(t))}}return e}function u(n,e){const[t,r,c]=m(n,e);return t+r.map(a(e?.locale)).join(e?.delimiter??" ")+c}function l(n,e){const[t,r,c]=m(n,e),i=a(e?.locale),o=f(e?.locale);return t+r.map(s(i,o)).join(e?.delimiter??" ")+c}function a(n){return!1===n?n=>n.toLowerCase():e=>e.toLocaleLowerCase(n)}function f(n){return!1===n?n=>n.toUpperCase():e=>e.toLocaleUpperCase(n)}function s(n,e){return t=>`${e(t[0])}${n(t.slice(1))}`}function p(n,e){return(t,r)=>{const c=t[0];return(r>0&&c>="0"&&c<="9"?"_"+c:e(c))+n(t.slice(1))}}function m(n,e={}){const t=e.split??(e.separateNumbers?o:i),r=e.prefixCharacters??"",c=e.suffixCharacters??"";let u=0,l=n.length;for(;u<n.length;){const e=n.charAt(u);if(!r.includes(e))break;u++}for(;l>u;){const e=l-1,t=n.charAt(e);if(!c.includes(t))break;l=e}return[n.slice(0,u),t(n.slice(u,l)),n.slice(l)]}function d(n){return function(n,e){const[t,r,c]=m(n,e),i=a(e?.locale),o=f(e?.locale),u=p(i,o);return t+r.map((n,e)=>0===e?i(n):u(n,e)).join("")+c}(n)}function L(n){return l(n)}function h(n){return function(n,e){const[t,r,c]=m(n,e);return t+r.map(f(e?.locale)).join("_")+c}(n)}function g(n){return u(n,{delimiter:".",...e});var e}function j(n){return u(n,{delimiter:"-",...e});var e}function v(n){return u(n)}function C(n){return function(n,e){const[t,r,c]=m(n,e),i=p(a(e?.locale),f(e?.locale));return t+r.map(i).join("")+c}(n)}function x(n){return l(n,{delimiter:"_",...e});var e}function A(n){return u(n,{delimiter:"/",...e});var e}function $(n){return function(n,e){const[t,r,c]=m(n,e),i=a(e?.locale),o=f(e?.locale),u=s(i,o);return t+r.map((n,e)=>0===e?u(n):i(n)).join(" ")+c}(n)}function _(n){return u(n,{delimiter:"_",...e});var e}function b(n){return l(n,{delimiter:"-",...e});var e}export{d as toCamelCase,L as toCapitalCase,h as toConstantCase,g as toDotCase,j as toKebabCase,v as toNoCase,C as toPascalCase,x as toPascalSnakeCase,A as toPathCase,$ as toSentenceCase,_ as toSnakeCase,b as toTrainCase};
+const n=/([\p{Ll}\d])(\p{Lu})/gu,t=/(\p{Lu})([\p{Lu}][\p{Ll}])/gu,e=/(\d)\p{Ll}|(\p{L})\d/u,r=/[^\p{L}\d]+/giu,u="$1\0$2";function c(e){let c=e.trim();c=c.replace(n,u).replace(t,u),c=c.replace(r,"\0");let o=0,i=c.length;for(;"\0"===c.charAt(o);)o++;if(o===i)return[];for(;"\0"===c.charAt(i-1);)i--;return c.slice(o,i).split(/\0/g)}function o(n){const t=c(n);for(let n=0;n<t.length;n++){const r=t[n],u=e.exec(r);if(u){const e=u.index+(u[1]??u[2]).length;t.splice(n,1,r.slice(0,e),r.slice(e))}}return t}function i(n,t){const[e,r,u]=d(n,t);return e+r.map(a(t?.locale)).join(t?.delimiter??" ")+u}function l(n,t){const[e,r,u]=d(n,t),c=a(t?.locale),o=f(t?.locale);return e+r.map(s(c,o)).join(t?.delimiter??" ")+u}function a(n){return!1===n?n=>n.toLowerCase():t=>t.toLocaleLowerCase(n)}function f(n){return!1===n?n=>n.toUpperCase():t=>t.toLocaleUpperCase(n)}function s(n,t){return e=>`${t(e[0])}${n(e.slice(1))}`}function p(n,t){return(e,r)=>{const u=e[0];return(r>0&&u>="0"&&u<="9"?"_"+u:t(u))+n(e.slice(1))}}function d(n,t={}){const e=t.split??(t.separateNumbers?o:c),r=t.prefixCharacters??"",u=t.suffixCharacters??"";let i=0,l=n.length;for(;i<n.length;){const t=n.charAt(i);if(!r.includes(t))break;i++}for(;l>i;){const t=l-1,e=n.charAt(t);if(!u.includes(e))break;l=t}return[n.slice(0,i),e(n.slice(i,l)),n.slice(l)]}function h(n){return function(n,t){const[e,r,u]=d(n,t),c=a(t?.locale),o=f(t?.locale),i=p(c,o);return e+r.map((n,t)=>0===t?c(n):i(n,t)).join("")+u}(n)}function g(n){return l(n)}function m(n){return function(n,t){const[e,r,u]=d(n,t);return e+r.map(f(t?.locale)).join("_")+u}(n)}function L(n){return i(n,{delimiter:".",...t});var t}function C(n){return i(n,{delimiter:"-",...t});var t}function A(n){return i(n)}function j(n){return function(n,t){const[e,r,u]=d(n,t),c=p(a(t?.locale),f(t?.locale));return e+r.map(c).join("")+u}(n)}function v(n){return l(n,{delimiter:"_",...t});var t}function w(n){return i(n,{delimiter:"/",...t});var t}function x(n){return function(n,t){const[e,r,u]=d(n,t),c=a(t?.locale),o=f(t?.locale),i=s(c,o);return e+r.map((n,t)=>0===t?i(n):c(n)).join(" ")+u}(n)}function $(n){return i(n,{delimiter:"_",...t});var t}function U(n){return l(n,{delimiter:"-",...t});var t}function b(n,t,e="..."){return n.length<=t?n:n.slice(0,t)+e}function _(n){return 0===n.length?n:n.charAt(0).toUpperCase()+n.slice(1)}function k(n){return 0===n.length?n:n.charAt(0).toUpperCase()+n.slice(1).toLowerCase()}function z(n){return n.split("").reverse().join("")}function y(n){return n.replace(/\s+/gu,"")}function Z(n){return n.replace(/\s+/gu," ").trim()}function B(n,t,e=" "){return n.padStart(t,e)}function E(n,t,e=" "){return n.padEnd(t,e)}function N(n,t){return n.repeat(t)}function O(n,t,e=!0){if(0===t.length)return 0;const r=e?n:n.toLowerCase(),u=e?t:t.toLowerCase();let c=0,o=0;for(;;){const n=r.indexOf(u,o);if(-1===n)break;c++,o=n+1}return c}function R(n){return n.match(/[A-Z]?[a-z]+|[A-Z]+(?![a-z])|\d+/gu)||[]}function S(n){return"string"==typeof n}function q(n,t=!0){return t?0===n.trim().length:0===n.length}function D(n){return/^[\da-z]+$/iu.test(n)}function F(n){return/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/u.test(n)}function G(n){try{const t=new URL(n);return Boolean(t)}catch{return!1}}export{_ as capitalize,k as capitalizeFirst,O as countOccurrences,D as isAlphanumeric,F as isEmail,q as isEmpty,S as isString,G as isUrl,Z as normalizeSpaces,E as padEnd,B as padStart,y as removeWhitespace,N as repeat,z as reverse,h as toCamelCase,g as toCapitalCase,m as toConstantCase,L as toDotCase,C as toKebabCase,A as toNoCase,j as toPascalCase,v as toPascalSnakeCase,w as toPathCase,x as toSentenceCase,$ as toSnakeCase,U as toTrainCase,b as truncate,R as words};

package/dist/manipulation.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Truncate a string to a specified length, adding an ellipsis if truncated.
+ *
+ * @param str - The string to truncate
+ * @param maxLength - The maximum length of the string
+ * @param ellipsis - The ellipsis to append (default: '...')
+ * @returns The truncated string
+ *
+ * @example
+ * ```typescript
+ * truncate('Hello World', 5); // 'Hello...'
+ * truncate('Hello', 10); // 'Hello'
+ * truncate('Hello World', 5, '…'); // 'Hello…'
+ * ```
+ */
+export declare function truncate(str: string, maxLength: number, ellipsis?: string): string;
+/**
+ * Capitalize the first letter of a string.
+ *
+ * @param str - The string to capitalize
+ * @returns The capitalized string
+ *
+ * @example
+ * ```typescript
+ * capitalize('hello'); // 'Hello'
+ * capitalize('WORLD'); // 'WORLD'
+ * capitalize(''); // ''
+ * ```
+ */
+export declare function capitalize(str: string): string;
+/**
+ * Capitalize the first letter of a string and lowercase the rest.
+ *
+ * @param str - The string to capitalize
+ * @returns The capitalized string
+ *
+ * @example
+ * ```typescript
+ * capitalizeFirst('hello'); // 'Hello'
+ * capitalizeFirst('WORLD'); // 'World'
+ * capitalizeFirst('hELLO wORLD'); // 'Hello world'
+ * ```
+ */
+export declare function capitalizeFirst(str: string): string;
+/**
+ * Reverse a string.
+ *
+ * @param str - The string to reverse
+ * @returns The reversed string
+ *
+ * @example
+ * ```typescript
+ * reverse('hello'); // 'olleh'
+ * reverse('abc123'); // '321cba'
+ * ```
+ */
+export declare function reverse(str: string): string;
+/**
+ * Remove all whitespace from a string.
+ *
+ * @param str - The string to process
+ * @returns The string without whitespace
+ *
+ * @example
+ * ```typescript
+ * removeWhitespace('hello world'); // 'helloworld'
+ * removeWhitespace('  a  b  c  '); // 'abc'
+ * ```
+ */
+export declare function removeWhitespace(str: string): string;
+/**
+ * Replace multiple consecutive spaces with a single space.
+ *
+ * @param str - The string to process
+ * @returns The string with normalized spaces
+ *
+ * @example
+ * ```typescript
+ * normalizeSpaces('hello    world'); // 'hello world'
+ * normalizeSpaces('a  b  c'); // 'a b c'
+ * ```
+ */
+export declare function normalizeSpaces(str: string): string;
+/**
+ * Pad a string to a specified length from the start.
+ *
+ * @param str - The string to pad
+ * @param targetLength - The target length
+ * @param padString - The string to pad with (default: ' ')
+ * @returns The padded string
+ *
+ * @example
+ * ```typescript
+ * padStart('5', 3, '0'); // '005'
+ * padStart('hello', 10); // '     hello'
+ * ```
+ */
+export declare function padStart(str: string, targetLength: number, padString?: string): string;
+/**
+ * Pad a string to a specified length from the end.
+ *
+ * @param str - The string to pad
+ * @param targetLength - The target length
+ * @param padString - The string to pad with (default: ' ')
+ * @returns The padded string
+ *
+ * @example
+ * ```typescript
+ * padEnd('5', 3, '0'); // '500'
+ * padEnd('hello', 10); // 'hello     '
+ * ```
+ */
+export declare function padEnd(str: string, targetLength: number, padString?: string): string;
+/**
+ * Repeat a string a specified number of times.
+ *
+ * @param str - The string to repeat
+ * @param count - The number of times to repeat
+ * @returns The repeated string
+ *
+ * @example
+ * ```typescript
+ * repeat('ha', 3); // 'hahaha'
+ * repeat('*', 5); // '*****'
+ * ```
+ */
+export declare function repeat(str: string, count: number): string;
+/**
+ * Count the occurrences of a substring in a string.
+ *
+ * @param str - The string to search in
+ * @param searchValue - The substring to count
+ * @param caseSensitive - Whether the search is case-sensitive (default: true)
+ * @returns The number of occurrences
+ *
+ * @example
+ * ```typescript
+ * countOccurrences('hello world hello', 'hello'); // 2
+ * countOccurrences('Hello HELLO hello', 'hello', false); // 3
+ * ```
+ */
+export declare function countOccurrences(str: string, searchValue: string, caseSensitive?: boolean): number;
+/**
+ * Extract words from a string.
+ *
+ * @param str - The string to extract words from
+ * @returns An array of words
+ *
+ * @example
+ * ```typescript
+ * words('hello world'); // ['hello', 'world']
+ * words('one-two_three'); // ['one', 'two', 'three']
+ * ```
+ */
+export declare function words(str: string): string[];

package/dist/type-guards.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Type guard to check if a value is a string.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a string, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isString('hello'); // true
+ * isString(123); // false
+ * isString(null); // false
+ * ```
+ */
+export declare function isString(value: unknown): value is string;

package/dist/validation.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Check if a string is empty (zero length or only whitespace).
+ *
+ * @param str - The string to check
+ * @param trimWhitespace - If true, treats whitespace-only strings as empty (default: true)
+ * @returns True if the string is empty, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isEmpty(''); // true
+ * isEmpty('   '); // true
+ * isEmpty('   ', false); // false
+ * isEmpty('hello'); // false
+ * ```
+ */
+export declare function isEmpty(str: string, trimWhitespace?: boolean): boolean;
+/**
+ * Check if a string contains only alphanumeric characters.
+ *
+ * @param str - The string to check
+ * @returns True if the string contains only alphanumeric characters, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isAlphanumeric('abc123'); // true
+ * isAlphanumeric('abc-123'); // false
+ * isAlphanumeric(''); // false
+ * ```
+ */
+export declare function isAlphanumeric(str: string): boolean;
+/**
+ * Check if a string is a valid email address.
+ *
+ * @param str - The string to check
+ * @returns True if the string is a valid email address, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isEmail('test@example.com'); // true
+ * isEmail('invalid-email'); // false
+ * ```
+ */
+export declare function isEmail(str: string): boolean;
+/**
+ * Check if a string is a valid URL.
+ *
+ * @param str - The string to check
+ * @returns True if the string is a valid URL, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isUrl('https://example.com'); // true
+ * isUrl('not a url'); // false
+ * ```
+ */
+export declare function isUrl(str: string): boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pixpilot/string",
   "type": "module",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "author": "Pixpilot <m.doaie@hotmail.com>",
   "license": "MIT",
   "repository": {
@@ -31,8 +31,8 @@
     "eslint": "^9.37.0",
     "rollup": "^4.52.4",
     "typescript": "^5.9.3",
-    "@internal/eslint-config": "0.3.0",
     "@internal/prettier-config": "0.0.1",
+    "@internal/eslint-config": "0.3.0",
     "@internal/rollup-config": "0.1.0",
     "@internal/tsconfig": "0.1.0",
     "@internal/vitest-config": "0.1.0"