@fluixi/utils 1.0.0-alpha.53

package/dist/lib/primitive/string/string.mjs

@@ -0,0 +1,5 @@
+function T(e,t={}){let{allowComments:r=!0,allowUnquotedKeys:n=!0,allowSingleQuotes:a=!0,allowTrailingCommas:u=!0,allowUndefined:h=!1}=t,i=e.trim();if(r&&(i=i.replace(/\/\*[\s\S]*?\*\//g,""),i=i.split(`
+`).map(f=>{let b=!1,l="",g=!1;for(let m=0;m<f.length;m++){let y=f[m];if(g){g=!1;continue}if(y==="\\"){g=!0;continue}if(!b&&(y==='"'||y==="'"))b=!0,l=y;else if(b&&y===l)b=!1,l="";else if(!b&&y==="/"&&f[m+1]==="/")return f.substring(0,m)}return f}).join(`
+`)),n&&(i=i.replace(/([{,]\s*)([a-zA-Z_$][a-zA-Z0-9_$]*)(\s*:)/g,'$1"$2"$3')),a){let c="",s=!1,f=!1,b=!1,l=0;for(;l<i.length;){let g=i[l];if(b){c+=g,b=!1,l++;continue}if(g==="\\"){b=!0,c+=g,l++;continue}g==="'"&&!f?s?(c+='"',s=!1):(c+='"',s=!0):(g==='"'&&!s&&(f?f=!1:f=!0),c+=g),l++}i=c}if(u){let c="",s=!1,f="",b=!1,l=0;for(;l<i.length;){let g=i[l];if(b){c+=g,b=!1,l++;continue}if(g==="\\"){b=!0,c+=g,l++;continue}if((g==='"'||g==="'")&&!s)s=!0,f=g,c+=g;else if(s&&g===f)s=!1,f="",c+=g;else if(!s&&g===","){let m=l+1;for(;m<i.length&&/\s/.test(i[m]);)m++;if(m<i.length&&(i[m]==="]"||i[m]==="}")){l++;continue}else c+=g}else c+=g;l++}i=c}if(h){let c="",s=!1,f="",b=!1,l=0;for(;l<i.length;){if(b){c+=i[l],b=!1,l++;continue}if(i[l]==="\\"){b=!0,c+=i[l],l++;continue}if((i[l]==='"'||i[l]==="'")&&!s)s=!0,f=i[l],c+=i[l];else if(s&&i[l]===f)s=!1,f="",c+=i[l];else if(!s&&i.substr(l,9)==="undefined"){let g=l>0?i[l-1]:"",m=l+8<i.length?i[l+9]:"";if(/[a-zA-Z0-9_$]/.test(g)||/[a-zA-Z0-9_$]/.test(m))c+=i[l];else{c+="null",l+=9;continue}}else c+=i[l];l++}i=c}try{return JSON.parse(i)}catch{return}}var S=e=>e.trim(),j=e=>e.trimStart(),L=e=>e.trimEnd(),N=e=>e.replace(/[^a-zA-Z0-9]+(.)/g,(t,r)=>r.toUpperCase()).replace(/^[A-Z]/,t=>t.toLowerCase()),W=e=>e.replace(/[^a-zA-Z0-9]+(.)/g,(t,r)=>r.toUpperCase()).replace(/^[a-z]/,t=>t.toUpperCase()),z=e=>e.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase(),E=e=>e.replace(/([a-z])([A-Z])/g,"$1_$2").replace(/[-\s]+/g,"_").toLowerCase(),Z=e=>e&&e.charAt(0).toUpperCase()+e.slice(1),_=e=>e.replace(/\b\w+/g,t=>t.charAt(0).toUpperCase()+t.slice(1).toLowerCase()),J=(e,t,r=0)=>e.startsWith(t,r),U=(e,t,r)=>e.endsWith(t,r),K=(e,t)=>e.includes(t),F=(e,t)=>e.toLowerCase().includes(t.toLowerCase()),q=(e,t,r)=>typeof e.replaceAll=="function"?e.replaceAll(t,r):e.replace(new RegExp($(t),"g"),r),I=(e,t,r)=>e.replace(new RegExp($(t),"gi"),r),$=e=>e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),Q=e=>{let t={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;","/":"&#x2F;"};return e.replace(/[&<>"'/]/g,r=>t[r]||r)},M=e=>{let t={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'","&#x2F;":"/"};return e.replace(/&(?:amp|lt|gt|quot|#39|#x2F);/g,r=>t[r]||r)},V=(e,t,r="...")=>e.length<=t?e:e.slice(0,t-r.length)+r,D=(e,t,r=" ",n="start")=>{let a=t-e.length;if(a<=0)return e;let u=r.repeat(a);switch(n){case"start":return u+e;case"end":return e+u;case"both":let h=Math.floor(a/2),i=a-h;return r.repeat(h)+e+r.repeat(i)}},H=e=>e.trim().length===0,B=e=>/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/.test(e.trim()),G=e=>{try{return new URL(e),!0}catch{return!1}},X=e=>{try{return new URL(e).hostname.replace(/^www\./,"")}catch{return""}},Y=(e=10,t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789")=>{let r="",n=t.length;for(let a=0;a<e;a++)r+=t.charAt(Math.floor(Math.random()*n));return r},v=(e,t,r=!0)=>{if(!t)return 0;let n=r?e:e.toLowerCase(),a=r?t:t.toLowerCase(),u=0,h=0;for(;(h=n.indexOf(a,h))!==-1;)u++,h+=a.length;return u},k=e=>e.replace(/\s+/g,""),C=e=>e.split("").reverse().join(""),ee=(e,t=!1)=>{let n=(t?e:e.toLowerCase()).replace(/[^a-z0-9]/gi,"");return n===C(n)},te=e=>e.toLowerCase().trim().replace(/[^\w\s-]/g,"").replace(/[\s_-]+/g,"-").replace(/^-+|-+$/g,""),re=(e,t=0,r=0,n="*")=>{if(t+r>=e.length)return e;let a=e.slice(0,t),u=r>0?e.slice(-r):"",h=n.repeat(e.length-t-r);return a+h+u},ne=(e,t=2)=>e.split(/\s+/).slice(0,t).map(r=>r.charAt(0).toUpperCase()).join(""),se=e=>e.replace(/\r\n/g,`
+`).replace(/\r/g,`
+`),ie=(e,t=80)=>{let r=e.split(" "),n=[],a="";for(let u of r){let h=a.length+u.length+1;a.length+u.length<=t?a+=(a?" ":"")+u:(a&&n.push(a),a=u)}return a&&n.push(a),n},ae=e=>typeof e=="string",oe=(e,t)=>{if(e==null)return t!==void 0?t:"";let r=e;if(Array.isArray(r)){if(r.length===0)return t!==void 0?t:""}else if(typeof r=="object"&&Object.keys(r).length===0)return t!==void 0?t:"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return String(e);try{return String(e)}catch{return t!==void 0?t:""}},le=(e,t=!0)=>{if(!t||new Set(["&nbsp;"," ","  ","_space_"]).has(e))return e;let n=/[.*+?^${}()|[\]\\]/g;return e.replace(n,"\\$&")};function A(e,t,r,n){if(t<0||t>e.length)throw new Error("Start index out of bounds");if(r<t||r>e.length)throw new Error("End index out of bounds");let a=e.substring(0,t),u=e.substring(r);return a+n+u}var ue=(e,t,r="start",n="")=>{if(!e||!t||t.length===0||e.length<t.length)return e;if(r==="both"){let u=e;return u.startsWith(t)&&(u=A(u,0,t.length,n)),u.endsWith(t)&&(u=A(u,u.length-t.length,u.length,n)),u}return r==="start"&&e.startsWith(t)||r==="end"&&e.endsWith(t)?r==="start"?n+e.substring(t.length):e.substring(0,e.length-t.length)+n:e},ce=(e,t)=>{let{pattern:r,position:n,newValue:a,useRegex:u=!1,flags:h}={...t};if(!e)return e;a||(a="");let i,c=typeof n>"u"||n==="start";if(u&&r instanceof RegExp){i=r;let s=i.source;n&&(n==="start"?r=`^${s}`:n==="end"?r=`${s}$`:r=`^${s}|${s}$`,r=new RegExp(r,h))}else if(u)n&&(n==="start"?r=`^${r}`:n==="end"?r=`${r}$`:n==="both"&&(r=`^${r}|${r}$`)),i=new RegExp(r,h);else{let s=r;i=new RegExp(c?`^${s}`:n==="end"?`${s}$`:n==="both"?`^${s}|${s}$`:`${s}`,h||"g")}return e.replace(i,a)},w=e=>{if(!e.startsWith("[")||!e.endsWith("]"))return e;let t=e.slice(1,-1).trim();if(t==="")return[];try{let c=`[${t}]`,s=JSON.parse(c);if(Array.isArray(s))return s}catch{}let r=[],n="",a=!1,u="",h=!1,i=0;for(let c=0;c<t.length;c++){let s=t[c];if(h){n+=s,h=!1;continue}if(s==="\\"&&a){h=!0;continue}(s==='"'||s==="'")&&!a?(a=!0,u=s):s===u&&a?(a=!1,u=""):s==="["&&!a?(i++,n+=s):s==="]"&&!a?(i--,n+=s):s===","&&!a&&i===0?(r.push(n.trim()),n=""):n+=s}return n.trim()&&r.push(n.trim()),r.map(c=>{let s=c.trim();return s.startsWith('"')&&s.endsWith('"')||s.startsWith("'")&&s.endsWith("'")?s.slice(1,-1):s})},fe=e=>{let t=e.trim();if(t.startsWith("[")&&t.endsWith("]")){let r=w(t);return Array.isArray(r)?r:t}if(t.startsWith("{")&&t.endsWith("}"))try{return JSON.parse(t)}catch{let r=T(t);if(r!==void 0)return r;let n=t.replace(/([{,]\s*)(\w+)(\s*:)/g,'$1"$2"$3').replace(/:\s*'([^']*)'/g,':"$1"');try{return JSON.parse(n)}catch{return t}}try{return JSON.parse(t)}catch{return t}},ge=e=>Array.isArray(e)&&e.every(t=>typeof t=="string"),R=(e,t={})=>{let{delimiters:r=["|"],valueKey:n,labelKey:a,defaultObject:u,trimItems:h=!0,filterEmpty:i=!0,returnObjects:c,parsePrimitives:s=!1,preserveNullUndefined:f=!1}=t,b=c??(n!==void 0||a!==void 0||u!==void 0),l=o=>{let p=u?{...u}:{},d=h?o.trim():o;if(n!==void 0&&(p[n]=s?g(d):d),n!==a||n===void 0&&a===void 0){let x;n===void 0&&a===void 0?x=c?"label":n:x=a,x!==void 0&&(p[x]=d)}return p},g=o=>{let p=o.trim();if(p==="")return f?null:"";if(p.toLowerCase()==="null")return f?null:"null";if(p.toLowerCase()==="undefined")return f?null:"undefined";if(p.toLowerCase()==="true")return!0;if(p.toLowerCase()==="false")return!1;if(/^-?\d+$/.test(p)){let d=parseInt(p,10);return isNaN(d)?h?p:o:d}if(/^-?\d+\.\d+$/.test(p)){let d=parseFloat(p);return isNaN(d)?h?p:o:d}return h?p:o},m=o=>{if(o==null)return f?o:null;if(typeof o=="string"){let d=h?o.trim():o;return o==="null"?null:o==="undefined"?f?void 0:"undefined":o===""?f?null:"":i&&d===""?f?d:null:b?l(d):s?g(d):d}if(typeof o=="number"||typeof o=="boolean")if(b){let d=u?{...u}:{};return n!==void 0&&(d[n]=o),a!==void 0&&a!==n&&(d[a]=String(o)),d}else return o;if(typeof o=="object"&&!Array.isArray(o))return b?u?{...u,...o}:o:n&&o[n]!==void 0?o[n]:o;if(Array.isArray(o)){let d=JSON.stringify(o);return b?l(d):d}let p=String(o);return b?l(p):p};if(Array.isArray(e)){let o=e.map(m);return f?o:o.filter(p=>p!==null)}if(typeof e!="string")return e==null?[]:m(String(e))?[m(String(e))]:[];let y=e.trim();if(y==="")return[];if(y.startsWith("[")&&y.endsWith("]")||y.startsWith("{")&&y.endsWith("}"))try{let o=JSON.parse(y);if(Array.isArray(o)){let d=o.map(m);return f?d:d.filter(x=>x!==null)}let p=m(o);return p?[p]:[]}catch{}let P=w(y);if(Array.isArray(P)){let o=P.map(p=>m(p));return f?o:o.filter(p=>p!==null)}for(let o of r)if(y.includes(o)){let d=(h?y:e).split(o).map(x=>m(x));return f?d:d.filter(x=>x!==null&&(!i||x!==""))}let O=m(y);return O?[O]:[]},pe=(e,t={})=>R(e,{...t,returnObjects:!1}),de=(e,t={})=>R(e,{...t,returnObjects:!0}),he=e=>e.every(t=>t==null||typeof t=="string"||typeof t=="number"||typeof t=="boolean"),be=e=>{let t=e.trim();if(t===""||t.toLowerCase()==="null")return null;if(t.toLowerCase()!=="undefined"){if(t.toLowerCase()==="true")return!0;if(t.toLowerCase()==="false")return!1;if(/^-?\d+$/.test(t)){let r=parseInt(t,10);return isNaN(r)?t:r}if(/^-?\d+\.\d+$/.test(t)){let r=parseFloat(t);return isNaN(r)?t:r}if(/^-?\d+(?:\.\d+)?[eE][+-]?\d+$/.test(t)){let r=parseFloat(t);return isNaN(r)?t:r}return t}},xe={trim:S,trimStart:j,trimEnd:L,toCamelCase:N,toPascalCase:W,toKebabCase:z,toSnakeCase:E,capitalize:Z,toTitleCase:_,startsWith:J,endsWith:U,includes:K,includesIgnoreCase:F,replaceStringByIndex:A,replaceAll:q,replaceAllIgnoreCase:I,escapeRegExp:$,escapeHtml:Q,unescapeHtml:M,truncate:V,pad:D,isEmpty:H,isValidEmail:B,isValidUrl:G,extractDomain:X,randomString:Y,countOccurrences:v,removeWhitespace:k,reverse:C,isPalindrome:ee,slugify:te,mask:re,getInitials:ne,normalizeLineEndings:se,wordWrap:ie,isString:ae,toString:oe,escapeString:le,replaceString:ue,replaceStringPattern:ce,stringToObjectArray:R,parseArrayLiteral:w,parseLiteral:fe,isStringArray:ge,stringToPrimitiveArray:pe,stringToObjectArrayOnly:de,isPrimitiveArray:he,parsePrimitiveValue:be};export{Z as capitalize,v as countOccurrences,xe as default,U as endsWith,Q as escapeHtml,$ as escapeRegExp,le as escapeString,X as extractDomain,ne as getInitials,K as includes,F as includesIgnoreCase,H as isEmpty,ee as isPalindrome,he as isPrimitiveArray,ae as isString,ge as isStringArray,B as isValidEmail,G as isValidUrl,re as mask,se as normalizeLineEndings,D as pad,w as parseArrayLiteral,fe as parseLiteral,be as parsePrimitiveValue,Y as randomString,k as removeWhitespace,q as replaceAll,I as replaceAllIgnoreCase,ue as replaceString,ce as replaceStringPattern,C as reverse,te as slugify,J as startsWith,R as stringToObjectArray,de as stringToObjectArrayOnly,pe as stringToPrimitiveArray,N as toCamelCase,z as toKebabCase,W as toPascalCase,E as toSnakeCase,oe as toString,_ as toTitleCase,S as trim,L as trimEnd,j as trimStart,V as truncate,M as unescapeHtml,ie as wordWrap};

package/dist/lib/primitive/string/types.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var T=(t,e,x,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of d(e))!g.call(t,n)&&n!==x&&s(t,n,{get:()=>e[n],enumerable:!(r=i(e,n))||r.enumerable});return t};var p=t=>T(s({},"__esModule",{value:!0}),t);var u={};module.exports=p(u);

package/dist/lib/primitive/string/types.d.ts

@@ -0,0 +1,318 @@
+/**
+ * Types for filtering and manipulating union string types.
+ * @module FilterStringTypes
+ */
+/**
+ * Filters a union of strings to only those that match a literal string.
+ *
+ * @template T - Union of string types
+ * @template Match - String literal to match
+ *
+ * @example
+* type T = FilterExact<'apple' | 'banana' | 'orange', 'apple'>; // 'apple'
+*/
+export type FilterExact<T extends string, Match extends string> = T extends Match ? T : never;
+/**
+* Filters a union of strings to only those that DO NOT match a literal string.
+*
+* @template T - Union of string types
+* @template ExcludeMatch - String literal to exclude
+*
+* @example
+* type T = FilterExclude<'apple' | 'banana' | 'orange', 'apple'>; // 'banana' | 'orange'
+*/
+export type FilterExclude<T extends string, ExcludeMatch extends string> = T extends ExcludeMatch ? never : T;
+/**
+* Filters a union of strings to only those that start with a prefix.
+*
+* @template T - Union of string types
+* @template Prefix - Prefix to match
+*
+* @example
+* type T = FilterStartsWith<'apple' | 'application' | 'banana' | 'app', 'app'>;
+* // 'apple' | 'application' | 'app'
+*/
+export type FilterStartsWith<T extends string, Prefix extends string> = T extends `${Prefix}${string}` ? T : never;
+export type ReplaceStartsWith<T extends string, Prefix extends string> = T extends `${Prefix}${infer Rest}` ? Rest : never;
+/**
+* Filters a union of strings to only those that end with a suffix.
+*
+* @template T - Union of string types
+* @template Suffix - Suffix to match
+*
+* @example
+* type T = FilterEndsWith<'apple' | 'pineapple' | 'banana', 'apple'>;
+* // 'apple' | 'pineapple'
+*/
+export type FilterEndsWith<T extends string, Suffix extends string> = T extends `${string}${Suffix}` ? T : never;
+/**
+* Filters a union of strings to only those that contain a substring.
+*
+* @template T - Union of string types
+* @template Substring - Substring to match
+*
+* @example
+* type T = FilterContains<'apple' | 'pineapple' | 'banana', 'apple'>;
+* // 'apple' | 'pineapple'
+*/
+export type FilterContains<T extends string, Substring extends string> = T extends `${string}${Substring}${string}` ? T : never;
+/**
+* Filters a union of strings to only those that match a pattern using template literals.
+*
+* @template T - Union of string types
+* @template Pattern - Template literal pattern
+*
+* @example
+* type T = FilterPattern<'user_1' | 'user_2' | 'admin_1', `user_${number}`>;
+* // 'user_1' | 'user_2'
+*/
+export type FilterPattern<T extends string, Pattern extends string> = T extends Pattern ? T : never;
+/**
+* Filters a union of strings to only those that match a regular expression pattern.
+* Note: TypeScript can't fully validate regex at type level, but we can approximate.
+*
+* @template T - Union of string types
+* @template Pattern - String representation of regex pattern
+*
+* @example
+* type T = FilterRegex<'abc123' | 'def456' | 'xyz', `^[a-z]{3}\\d{3}$`>;
+* // 'abc123' | 'def456'
+*/
+export type FilterRegex<T extends string, Pattern extends string> = T extends string ? Pattern extends `^${infer Start}${infer Rest}$` ? FilterRegexDetailed<T, Start, Rest> : never : never;
+type FilterRegexDetailed<T extends string, Start extends string, Rest extends string> = T extends `${infer TStart}${infer TRest}` ? TStart extends Start ? TRest extends Rest ? T : never : never : never;
+/**
+* Filters a union of strings by minimum length.
+*
+* @template T - Union of string types
+* @template MinLength - Minimum length required
+*
+* @example
+* type T = FilterMinLength<'a' | 'ab' | 'abc' | 'abcd', 3>;
+* // 'abc' | 'abcd'
+*/
+export type FilterMinLength<T extends string, MinLength extends number> = T extends string ? Length<T> extends infer L ? L extends number ? L extends MinLength ? T : L extends number ? GreaterThanOrEqual<L, MinLength> extends true ? T : never : never : never : never : never;
+/**
+* Filters a union of strings by maximum length.
+*
+* @template T - Union of string types
+* @template MaxLength - Maximum length allowed
+*
+* @example
+* type T = FilterMaxLength<'a' | 'ab' | 'abc' | 'abcd', 3>;
+* // 'a' | 'ab' | 'abc'
+*/
+export type FilterMaxLength<T extends string, MaxLength extends number> = T extends string ? Length<T> extends infer L ? L extends number ? L extends MaxLength ? T : L extends number ? LessThanOrEqual<L, MaxLength> extends true ? T : never : never : never : never : never;
+/**
+* Filters a union of strings to only those with a specific length.
+*
+* @template T - Union of string types
+* @template Len - Exact length required
+*
+* @example
+* type T = FilterLength<'a' | 'ab' | 'abc', 2>;
+* // 'ab'
+*/
+export type FilterLength<T extends string, Len extends number> = T extends string ? Length<T> extends Len ? T : never : never;
+/**
+* Filters a union of strings to only those that DO NOT start with a prefix.
+*
+* @template T - Union of string types
+* @template Prefix - Prefix to avoid
+*
+* @example
+* type T = FilterNotStartsWith<'apple' | 'banana' | 'apricot', 'ap'>;
+* // 'banana'
+*/
+export type FilterNotStartsWith<T extends string, Prefix extends string> = T extends `${Prefix}${string}` ? never : T;
+/**
+* Filters a union of strings to only those that DO NOT end with a suffix.
+*
+* @template T - Union of string types
+* @template Suffix - Suffix to avoid
+*
+* @example
+* type T = FilterNotEndsWith<'apple' | 'banana' | 'pineapple', 'apple'>;
+* // 'banana'
+*/
+export type FilterNotEndsWith<T extends string, Suffix extends string> = T extends `${string}${Suffix}` ? never : T;
+/**
+* Filters a union of strings to only those that DO NOT contain a substring.
+*
+* @template T - Union of string types
+* @template Substring - Substring to avoid
+*
+* @example
+* type T = FilterNotContains<'apple' | 'banana' | 'pineapple', 'apple'>;
+* // 'banana'
+*/
+export type FilterNotContains<T extends string, Substring extends string> = T extends `${string}${Substring}${string}` ? never : T;
+/**
+* Filters a union of strings case-insensitively.
+*
+* @template T - Union of string types
+* @template Match - String to match (case-insensitive)
+*
+* @example
+* type T = FilterCaseInsensitive<'Apple' | 'banana' | 'APPLE', 'apple'>;
+* // 'Apple' | 'APPLE'
+*/
+export type FilterCaseInsensitive<T extends string, Match extends string> = T extends string ? Uppercase<T> extends Uppercase<Match> ? T : never : never;
+/**
+* Filters a union of strings to only lowercase strings.
+*
+* @template T - Union of string types
+*
+* @example
+* type T = FilterLowercase<'apple' | 'BANANA' | 'Apple'>;
+* // 'apple'
+*/
+export type FilterLowercase<T extends string> = T extends Lowercase<T> ? T : never;
+/**
+* Filters a union of strings to only uppercase strings.
+*
+* @template T - Union of string types
+*
+* @example
+* type T = FilterUppercase<'APPLE' | 'banana' | 'Apple'>;
+* // 'APPLE'
+*/
+export type FilterUppercase<T extends string> = T extends Uppercase<T> ? T : never;
+/**
+* Extracts the prefix from strings that match a pattern.
+*
+* @template T - Union of string types
+* @template Prefix - Prefix to extract
+*
+* @example
+* type T = ExtractPrefix<'apple_pie' | 'banana_split' | 'apple_juice', 'apple_'>;
+* // 'apple_pie' | 'apple_juice'
+*/
+export type ExtractPrefix<T extends string, Prefix extends string> = FilterStartsWith<T, Prefix>;
+/**
+* Extracts the suffix from strings that match a pattern.
+*
+* @template T - Union of string types
+* @template Suffix - Suffix to extract
+*
+* @example
+* type T = ExtractSuffix<'apple_pie' | 'banana_split' | 'cherry_pie', '_pie'>;
+* // 'apple_pie' | 'cherry_pie'
+*/
+export type ExtractSuffix<T extends string, Suffix extends string> = FilterEndsWith<T, Suffix>;
+/**
+* Removes a prefix from matching strings and returns the rest.
+*
+* @template T - Union of string types
+* @template Prefix - Prefix to remove
+*
+* @example
+* type T = RemovePrefix<'apple_pie' | 'banana_split' | 'apple_juice', 'apple_'>;
+* // 'pie' | 'juice'
+*/
+export type RemovePrefix<T extends string, Prefix extends string> = T extends `${Prefix}${infer Rest}` ? Rest : never;
+/**
+* Removes a suffix from matching strings and returns the rest.
+*
+* @template T - Union of string types
+* @template Suffix - Suffix to remove
+*
+* @example
+* type T = RemoveSuffix<'apple_pie' | 'banana_split' | 'cherry_pie', '_pie'>;
+* // 'apple' | 'cherry'
+*/
+export type RemoveSuffix<T extends string, Suffix extends string> = T extends `${infer Rest}${Suffix}` ? Rest : never;
+/**
+* Intersection of two string unions.
+*
+* @template A - First union of strings
+* @template B - Second union of strings
+*
+* @example
+* type T = StringIntersection<'a' | 'b' | 'c', 'b' | 'c' | 'd'>;
+* // 'b' | 'c'
+*/
+export type StringIntersection<A extends string, B extends string> = A extends B ? A : never;
+/**
+* Difference between two string unions (A - B).
+*
+* @template A - First union of strings
+* @template B - Second union of strings to subtract
+*
+* @example
+* type T = StringDifference<'a' | 'b' | 'c', 'b' | 'c' | 'd'>;
+* // 'a'
+*/
+export type StringDifference<A extends string, B extends string> = A extends B ? never : A;
+/**
+* Union of two string unions (deduplicated).
+*
+* @template A - First union of strings
+* @template B - Second union of strings
+*
+* @example
+* type T = StringUnion<'a' | 'b', 'b' | 'c'>;
+* // 'a' | 'b' | 'c'
+*/
+export type StringUnion<A extends string, B extends string> = A | B;
+/**
+* Symmetric difference between two string unions (elements in A or B but not both).
+*
+* @template A - First union of strings
+* @template B - Second union of strings
+*
+* @example
+* type T = StringSymmetricDifference<'a' | 'b' | 'c', 'b' | 'c' | 'd'>;
+* // 'a' | 'd'
+*/
+export type StringSymmetricDifference<A extends string, B extends string> = StringUnion<StringDifference<A, B>, StringDifference<B, A>>;
+type Tuple<N extends number, T = unknown, Acc extends T[] = []> = Acc['length'] extends N ? Acc : Tuple<N, T, [...Acc, T]>;
+type TupleToNumber<T extends unknown[]> = T['length'];
+type Add<A extends number, B extends number> = TupleToNumber<[...Tuple<A>, ...Tuple<B>]> & number;
+type Length<S extends string, Depth extends number = 0> = Depth extends 0 ? never : S extends `${string}${string}${string}${string}${string}${string}${string}${string}${string}${string}${infer Rest}` ? Add<10, Length<Rest, Decrement<Depth>>> : S extends `${string}${string}${string}${string}${string}` ? Add<5, Length<DropFirstN<S, 5>, Decrement<Depth>>> : S extends `${string}${string}` ? Add<2, Length<DropFirstN<S, 2>, Decrement<Depth>>> : S extends `${string}` ? 1 : 0;
+type DropFirstN<S extends string, N extends number, Acc extends string = ''> = N extends 0 ? `${Acc}${S}` : S extends `${infer First}${infer Rest}` ? DropFirstN<Rest, Decrement<N>, `${Acc}`> : Acc;
+type LessThanOrEqual<A extends number, B extends number> = A extends B ? true : A extends number ? B extends number ? `${A}` extends `-${infer NA}` ? `${B}` extends `-${infer NB}` ? NA extends NB ? true : never : true : `${B}` extends `-${string}` ? false : never : never : never;
+type GreaterThanOrEqual<A extends number, B extends number> = A extends B ? true : LessThanOrEqual<B, A>;
+type Decrement<N extends number> = N extends 0 ? 0 : N extends 1 ? 0 : N extends 2 ? 1 : N extends 3 ? 2 : N extends 4 ? 3 : N extends 5 ? 4 : N extends 6 ? 5 : N extends 7 ? 6 : N extends 8 ? 7 : N extends 9 ? 8 : N extends 10 ? 9 : number;
+/**
+* Checks if a string union is empty (never).
+*
+* @template T - Union of strings to check
+*
+* @example
+* type T = IsEmptyUnion<'a' | 'b'>; // false
+* type U = IsEmptyUnion<never>; // true
+*/
+export type IsEmptyUnion<T> = [
+    T
+] extends [never] ? true : false;
+/**
+* Converts a string union to a tuple type (preserves order as much as possible).
+*
+* @template T - Union of strings
+*
+* @example
+* type T = UnionToTuple<'a' | 'b' | 'c'>;
+* // ['a', 'b', 'c'] or some permutation
+*/
+export type UnionToTuple<T extends string> = UnionToTupleRec<T, []>;
+type UnionToTupleRec<T extends string, Acc extends string[]> = IsEmptyUnion<T> extends true ? Acc : T extends infer U extends string ? UnionToTupleRec<Exclude<T, U>, [...Acc, U]> : never;
+/**
+* Gets the first string in a union.
+*
+* @template T - Union of strings
+*
+* @example
+* type T = FirstInUnion<'a' | 'b' | 'c'>; // 'a'
+*/
+export type FirstInUnion<T extends string> = UnionToTuple<T>[0] extends infer First extends string ? First : never;
+/**
+* Gets the last string in a union.
+*
+* @template T - Union of strings
+*
+* @example
+* type T = LastInUnion<'a' | 'b' | 'c'>; // 'c'
+*/
+export type LastInUnion<T extends string> = UnionToTuple<T> extends [...any[], infer Last extends string] ? Last : never;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/primitive/string/types.d.ts.map

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

package/dist/lib/primitive/string/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for filtering and manipulating union string types.
+ * @module FilterStringTypes
+ */
+export {};

package/dist/lib/primitive/types.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var y=(n,e,d,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of l(e))!p.call(n,t)&&t!==d&&s(n,t,{get:()=>e[t],enumerable:!(r=i(e,t))||r.enumerable});return n};var u=n=>y(s({},"__esModule",{value:!0}),n);var a={};module.exports=u(a);

package/dist/lib/primitive/types.d.ts

@@ -0,0 +1,27 @@
+export type Null = null;
+export type IsUndefined<T> = T extends undefined ? true : false;
+export type IsNull<T> = T extends Null ? true : false;
+export type IsNullOrUndefined<T> = IsUndefined<T> extends true ? true : IsNull<T>;
+export type UndefinedType = undefined;
+export type UndefinedOrNullType = UndefinedType | Null;
+export type ClassType = new (...args: any[]) => any;
+export type FnType = (...args: any[]) => any;
+export type IsDefined<T> = IsUndefined<T> extends true ? false : IsNull<T> extends true ? false : true;
+export type StringOrNumber = string | number;
+export type CheckType<T extends any> = {
+    is_undefined: T extends typeof undefined ? true : false;
+    is_null: T extends typeof undefined ? true : false;
+    is_array: T extends Array<any> ? true : false;
+    is_object: T extends StringOrNumber ? false : T extends Array<any> ? false : T extends Object ? true : false;
+    is_string: T extends String ? true : false;
+    is_number: T extends Number ? true : false;
+    typeOf: T extends undefined ? 'undefined' : T extends String ? 'string' : T extends Number ? 'number' : T extends Object ? 'object' : 'undefined';
+    keys: Array<any>;
+};
+export type CompareFunction = (a: any, b: any) => boolean;
+export type IBool = true | false | null;
+export type NonNullablePrimitiveType = string | number | boolean | symbol | bigint | Date;
+export type PrimitiveType = NonNullablePrimitiveType | null | undefined;
+export type ObjectKind = 'class' | 'instance' | 'function' | 'array' | 'object' | 'primitive' | 'null' | 'date' | 'undefined';
+export type ObjectType = ClassType | FnType | any[] | object | PrimitiveType | UndefinedType | Null;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/primitive/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/primitive/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,IAAI,CAAC;AACxB,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC;AAChE,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AACtD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,SAAS,IAAI,GAC1D,IAAI,GACJ,MAAM,CAAC,CAAC,CAAC,CAAC;AACd,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC;AACtC,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,IAAI,CAAC;AACvD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAC7C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,SAAS,IAAI,GAClD,KAAK,GACL,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,GACtB,KAAK,GACL,IAAI,CAAC;AACT,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,GAAG,IAAI;IACrC,YAAY,EAAE,CAAC,SAAS,OAAO,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC;IACxD,OAAO,EAAE,CAAC,SAAS,OAAO,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC;IACnD,QAAQ,EAAE,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;IAC9C,SAAS,EAAE,CAAC,SAAS,cAAc,GAC/B,KAAK,GACL,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GACpB,KAAK,GACL,CAAC,SAAS,MAAM,GAChB,IAAI,GACJ,KAAK,CAAC;IACV,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC3C,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC3C,MAAM,EAAE,CAAC,SAAS,SAAS,GACvB,WAAW,GACX,CAAC,SAAS,MAAM,GAChB,QAAQ,GACR,CAAC,SAAS,MAAM,GAChB,QAAQ,GACR,CAAC,SAAS,MAAM,GAChB,QAAQ,GACR,WAAW,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AACxC,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,CAAC;AACT,MAAM,MAAM,aAAa,GAAG,wBAAwB,GAAG,IAAI,GAAG,SAAS,CAAC;AAExE,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,UAAU,GACV,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,GACN,WAAW,CAAC;AAEhB,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,MAAM,GACN,GAAG,EAAE,GACL,MAAM,GACN,aAAa,GACb,aAAa,GACb,IAAI,CAAC"}

package/dist/lib/primitive/types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/url/index.cjs

@@ -0,0 +1 @@
+"use strict";var l=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var R=(t,r)=>{for(var n in r)l(t,n,{get:r[n],enumerable:!0})},b=(t,r,n,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of m(r))!f.call(t,e)&&e!==n&&l(t,e,{get:()=>r[e],enumerable:!(s=p(r,e))||s.enumerable});return t};var d=t=>b(l({},"__esModule",{value:!0}),t);var I={};R(I,{addQueryParams:()=>j,buildUrl:()=>A,extractUrls:()=>B,getDomain:()=>Q,getQueryParam:()=>L,getQueryParams:()=>O,getUrlExtension:()=>q,isAbsoluteUrl:()=>g,isRelativeUrl:()=>x,isSameOrigin:()=>D,isValidUrl:()=>P,joinUrl:()=>$,matchesUrlPattern:()=>C,normalizeUrl:()=>E,parseQueryString:()=>y,parseQueryStringAdvanced:()=>S,parseUrl:()=>U,removeQueryParams:()=>w,sanitizeUrl:()=>_,toAbsoluteUrl:()=>W,toQueryString:()=>h,url_parser:()=>u});module.exports=d(I);var u=t=>{try{let r=new URL(t);return{hash:r.hash,host:r.host,hostname:r.hostname,href:r.href,origin:r.origin,pathname:r.pathname,port:r.port,search:r.search,searchParams:r.searchParams.toString(),protocol:r.protocol}}catch{return null}};function U(t){return u(t)}function P(t){try{return new URL(t),!0}catch{return!1}}function g(t){try{return new URL(t),!0}catch{return!1}}function x(t){return!g(t)}function y(t){let r={};return new URLSearchParams(t).forEach((s,e)=>{r[e]=s}),r}function S(t){let r={};return new URLSearchParams(t).forEach((s,e)=>{r[e]?Array.isArray(r[e])?r[e].push(s):r[e]=[r[e],s]:r[e]=s}),r}function h(t,r={}){let{encode:n=!0,arrayFormat:s="repeat"}=r,e=new URLSearchParams;Object.entries(t).forEach(([i,o])=>{o!=null&&(Array.isArray(o)?o.forEach(c=>{s==="brackets"?e.append(`${i}[]`,String(c)):e.append(i,String(c))}):e.append(i,String(o)))});let a=e.toString();return n||(a=decodeURIComponent(a)),a}function j(t,r){try{let n=new URL(t);return Object.entries(r).forEach(([s,e])=>{e==null?n.searchParams.delete(s):Array.isArray(e)?(n.searchParams.delete(s),e.forEach(a=>n.searchParams.append(s,String(a)))):n.searchParams.set(s,String(e))}),n.toString()}catch{return t}}function w(t,...r){try{let n=new URL(t);return r.forEach(s=>n.searchParams.delete(s)),n.toString()}catch{return t}}function L(t,r){try{return new URL(t).searchParams.get(r)}catch{return null}}function O(t,r){try{return new URL(t).searchParams.getAll(r)}catch{return[]}}function A(t){let{protocol:r="https",hostname:n,port:s,pathname:e="",query:a,hash:i}=t,o=`${r}://${n}`;return s&&(o+=`:${s}`),e&&(o+=e.startsWith("/")?e:`/${e}`),a&&Object.keys(a).length>0&&(o+=`?${h(a)}`),i&&(o+=i.startsWith("#")?i:`#${i}`),o}function $(t,...r){try{let n=new URL(t),e=[n.pathname==="/"?"":n.pathname,...r].filter(Boolean).map(a=>a.replace(/^\/+|\/+$/g,""));return n.pathname="/"+e.filter(Boolean).join("/"),n.toString()}catch{return"/"+[t,...r].filter(Boolean).map(s=>s.replace(/^\/+|\/+$/g,"")).join("/")}}function E(t,r={}){let{removeTrailingSlash:n=!0,removeDefaultPort:s=!0,sortQuery:e=!1}=r;try{let a=new URL(t);if(s&&(a.protocol==="http:"&&a.port==="80"||a.protocol==="https:"&&a.port==="443")&&(a.port=""),n&&a.pathname.endsWith("/")&&a.pathname!=="/"&&(a.pathname=a.pathname.slice(0,-1)),e){let i=Array.from(a.searchParams.entries());i.sort((o,c)=>o[0].localeCompare(c[0])),a.search=new URLSearchParams(i).toString()}return a.toString()}catch{return t}}function Q(t,r={}){let{includeSubdomain:n=!1}=r;try{let e=new URL(t).hostname;if(n)return e;let a=e.split(".");return a.length>=2?a.slice(-2).join("."):e}catch{return null}}function q(t){try{let n=new URL(t).pathname,s=n.lastIndexOf("."),e=n.lastIndexOf("/");return s>e&&s<n.length-1?n.slice(s+1):null}catch{return null}}function D(t,r){try{let n=new URL(t),s=new URL(r);return n.origin===s.origin}catch{return!1}}function W(t,r){try{return new URL(t,r).toString()}catch{return t}}function _(t){let r=["javascript:","data:","vbscript:"];try{let n=new URL(t);return r.some(s=>n.protocol===s)?null:t}catch{let n=t.toLowerCase().trim();return r.some(s=>n.startsWith(s))?null:t}}function B(t,r={}){let{unique:n=!0}=r,s=/https?:\/\/[^\s<>"{}|\\^`\]]+/gi,e=t.match(s)||[];return n?Array.from(new Set(e)):e}function C(t,r){try{let n=new URL(t),s=new URL(r);if(s.protocol!=="*:"&&n.protocol!==s.protocol||s.hostname!=="*"&&n.hostname!==s.hostname)return!1;let e=s.pathname.replace(/\*\*/g,".*").replace(/\*/g,"[^/]*").replace(/[.+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`^${e}$`).test(n.pathname)}catch{return!1}}

package/dist/lib/url/index.d.ts

@@ -0,0 +1,3 @@
+export * from './parser.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/url/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/url/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/lib/url/index.js

@@ -0,0 +1,2 @@
+export * from './parser.js';
+export * from './types.js';

package/dist/lib/url/index.mjs

@@ -0,0 +1 @@
+var l=t=>{try{let r=new URL(t);return{hash:r.hash,host:r.host,hostname:r.hostname,href:r.href,origin:r.origin,pathname:r.pathname,port:r.port,search:r.search,searchParams:r.searchParams.toString(),protocol:r.protocol}}catch{return null}};function h(t){return l(t)}function p(t){try{return new URL(t),!0}catch{return!1}}function u(t){try{return new URL(t),!0}catch{return!1}}function m(t){return!u(t)}function f(t){let r={};return new URLSearchParams(t).forEach((e,s)=>{r[s]=e}),r}function R(t){let r={};return new URLSearchParams(t).forEach((e,s)=>{r[s]?Array.isArray(r[s])?r[s].push(e):r[s]=[r[s],e]:r[s]=e}),r}function g(t,r={}){let{encode:n=!0,arrayFormat:e="repeat"}=r,s=new URLSearchParams;Object.entries(t).forEach(([i,o])=>{o!=null&&(Array.isArray(o)?o.forEach(c=>{e==="brackets"?s.append(`${i}[]`,String(c)):s.append(i,String(c))}):s.append(i,String(o)))});let a=s.toString();return n||(a=decodeURIComponent(a)),a}function b(t,r){try{let n=new URL(t);return Object.entries(r).forEach(([e,s])=>{s==null?n.searchParams.delete(e):Array.isArray(s)?(n.searchParams.delete(e),s.forEach(a=>n.searchParams.append(e,String(a)))):n.searchParams.set(e,String(s))}),n.toString()}catch{return t}}function d(t,...r){try{let n=new URL(t);return r.forEach(e=>n.searchParams.delete(e)),n.toString()}catch{return t}}function U(t,r){try{return new URL(t).searchParams.get(r)}catch{return null}}function P(t,r){try{return new URL(t).searchParams.getAll(r)}catch{return[]}}function x(t){let{protocol:r="https",hostname:n,port:e,pathname:s="",query:a,hash:i}=t,o=`${r}://${n}`;return e&&(o+=`:${e}`),s&&(o+=s.startsWith("/")?s:`/${s}`),a&&Object.keys(a).length>0&&(o+=`?${g(a)}`),i&&(o+=i.startsWith("#")?i:`#${i}`),o}function y(t,...r){try{let n=new URL(t),s=[n.pathname==="/"?"":n.pathname,...r].filter(Boolean).map(a=>a.replace(/^\/+|\/+$/g,""));return n.pathname="/"+s.filter(Boolean).join("/"),n.toString()}catch{return"/"+[t,...r].filter(Boolean).map(e=>e.replace(/^\/+|\/+$/g,"")).join("/")}}function S(t,r={}){let{removeTrailingSlash:n=!0,removeDefaultPort:e=!0,sortQuery:s=!1}=r;try{let a=new URL(t);if(e&&(a.protocol==="http:"&&a.port==="80"||a.protocol==="https:"&&a.port==="443")&&(a.port=""),n&&a.pathname.endsWith("/")&&a.pathname!=="/"&&(a.pathname=a.pathname.slice(0,-1)),s){let i=Array.from(a.searchParams.entries());i.sort((o,c)=>o[0].localeCompare(c[0])),a.search=new URLSearchParams(i).toString()}return a.toString()}catch{return t}}function j(t,r={}){let{includeSubdomain:n=!1}=r;try{let s=new URL(t).hostname;if(n)return s;let a=s.split(".");return a.length>=2?a.slice(-2).join("."):s}catch{return null}}function w(t){try{let n=new URL(t).pathname,e=n.lastIndexOf("."),s=n.lastIndexOf("/");return e>s&&e<n.length-1?n.slice(e+1):null}catch{return null}}function L(t,r){try{let n=new URL(t),e=new URL(r);return n.origin===e.origin}catch{return!1}}function O(t,r){try{return new URL(t,r).toString()}catch{return t}}function A(t){let r=["javascript:","data:","vbscript:"];try{let n=new URL(t);return r.some(e=>n.protocol===e)?null:t}catch{let n=t.toLowerCase().trim();return r.some(e=>n.startsWith(e))?null:t}}function $(t,r={}){let{unique:n=!0}=r,e=/https?:\/\/[^\s<>"{}|\\^`\]]+/gi,s=t.match(e)||[];return n?Array.from(new Set(s)):s}function E(t,r){try{let n=new URL(t),e=new URL(r);if(e.protocol!=="*:"&&n.protocol!==e.protocol||e.hostname!=="*"&&n.hostname!==e.hostname)return!1;let s=e.pathname.replace(/\*\*/g,".*").replace(/\*/g,"[^/]*").replace(/[.+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`^${s}$`).test(n.pathname)}catch{return!1}}export{b as addQueryParams,x as buildUrl,$ as extractUrls,j as getDomain,U as getQueryParam,P as getQueryParams,w as getUrlExtension,u as isAbsoluteUrl,m as isRelativeUrl,L as isSameOrigin,p as isValidUrl,y as joinUrl,E as matchesUrlPattern,S as normalizeUrl,f as parseQueryString,R as parseQueryStringAdvanced,h as parseUrl,d as removeQueryParams,A as sanitizeUrl,O as toAbsoluteUrl,g as toQueryString,l as url_parser};

package/dist/lib/url/parser.cjs

@@ -0,0 +1 @@
+"use strict";var l=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var R=(t,r)=>{for(var n in r)l(t,n,{get:r[n],enumerable:!0})},b=(t,r,n,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of m(r))!f.call(t,e)&&e!==n&&l(t,e,{get:()=>r[e],enumerable:!(s=p(r,e))||s.enumerable});return t};var d=t=>b(l({},"__esModule",{value:!0}),t);var I={};R(I,{addQueryParams:()=>j,buildUrl:()=>A,extractUrls:()=>B,getDomain:()=>Q,getQueryParam:()=>L,getQueryParams:()=>O,getUrlExtension:()=>q,isAbsoluteUrl:()=>g,isRelativeUrl:()=>y,isSameOrigin:()=>D,isValidUrl:()=>P,joinUrl:()=>$,matchesUrlPattern:()=>C,normalizeUrl:()=>E,parseQueryString:()=>x,parseQueryStringAdvanced:()=>S,parseUrl:()=>U,removeQueryParams:()=>w,sanitizeUrl:()=>_,toAbsoluteUrl:()=>W,toQueryString:()=>h,url_parser:()=>u});module.exports=d(I);var u=t=>{try{let r=new URL(t);return{hash:r.hash,host:r.host,hostname:r.hostname,href:r.href,origin:r.origin,pathname:r.pathname,port:r.port,search:r.search,searchParams:r.searchParams.toString(),protocol:r.protocol}}catch{return null}};function U(t){return u(t)}function P(t){try{return new URL(t),!0}catch{return!1}}function g(t){try{return new URL(t),!0}catch{return!1}}function y(t){return!g(t)}function x(t){let r={};return new URLSearchParams(t).forEach((s,e)=>{r[e]=s}),r}function S(t){let r={};return new URLSearchParams(t).forEach((s,e)=>{r[e]?Array.isArray(r[e])?r[e].push(s):r[e]=[r[e],s]:r[e]=s}),r}function h(t,r={}){let{encode:n=!0,arrayFormat:s="repeat"}=r,e=new URLSearchParams;Object.entries(t).forEach(([i,o])=>{o!=null&&(Array.isArray(o)?o.forEach(c=>{s==="brackets"?e.append(`${i}[]`,String(c)):e.append(i,String(c))}):e.append(i,String(o)))});let a=e.toString();return n||(a=decodeURIComponent(a)),a}function j(t,r){try{let n=new URL(t);return Object.entries(r).forEach(([s,e])=>{e==null?n.searchParams.delete(s):Array.isArray(e)?(n.searchParams.delete(s),e.forEach(a=>n.searchParams.append(s,String(a)))):n.searchParams.set(s,String(e))}),n.toString()}catch{return t}}function w(t,...r){try{let n=new URL(t);return r.forEach(s=>n.searchParams.delete(s)),n.toString()}catch{return t}}function L(t,r){try{return new URL(t).searchParams.get(r)}catch{return null}}function O(t,r){try{return new URL(t).searchParams.getAll(r)}catch{return[]}}function A(t){let{protocol:r="https",hostname:n,port:s,pathname:e="",query:a,hash:i}=t,o=`${r}://${n}`;return s&&(o+=`:${s}`),e&&(o+=e.startsWith("/")?e:`/${e}`),a&&Object.keys(a).length>0&&(o+=`?${h(a)}`),i&&(o+=i.startsWith("#")?i:`#${i}`),o}function $(t,...r){try{let n=new URL(t),e=[n.pathname==="/"?"":n.pathname,...r].filter(Boolean).map(a=>a.replace(/^\/+|\/+$/g,""));return n.pathname="/"+e.filter(Boolean).join("/"),n.toString()}catch{return"/"+[t,...r].filter(Boolean).map(s=>s.replace(/^\/+|\/+$/g,"")).join("/")}}function E(t,r={}){let{removeTrailingSlash:n=!0,removeDefaultPort:s=!0,sortQuery:e=!1}=r;try{let a=new URL(t);if(s&&(a.protocol==="http:"&&a.port==="80"||a.protocol==="https:"&&a.port==="443")&&(a.port=""),n&&a.pathname.endsWith("/")&&a.pathname!=="/"&&(a.pathname=a.pathname.slice(0,-1)),e){let i=Array.from(a.searchParams.entries());i.sort((o,c)=>o[0].localeCompare(c[0])),a.search=new URLSearchParams(i).toString()}return a.toString()}catch{return t}}function Q(t,r={}){let{includeSubdomain:n=!1}=r;try{let e=new URL(t).hostname;if(n)return e;let a=e.split(".");return a.length>=2?a.slice(-2).join("."):e}catch{return null}}function q(t){try{let n=new URL(t).pathname,s=n.lastIndexOf("."),e=n.lastIndexOf("/");return s>e&&s<n.length-1?n.slice(s+1):null}catch{return null}}function D(t,r){try{let n=new URL(t),s=new URL(r);return n.origin===s.origin}catch{return!1}}function W(t,r){try{return new URL(t,r).toString()}catch{return t}}function _(t){let r=["javascript:","data:","vbscript:"];try{let n=new URL(t);return r.some(s=>n.protocol===s)?null:t}catch{let n=t.toLowerCase().trim();return r.some(s=>n.startsWith(s))?null:t}}function B(t,r={}){let{unique:n=!0}=r,s=/https?:\/\/[^\s<>"{}|\\^`\]]+/gi,e=t.match(s)||[];return n?Array.from(new Set(e)):e}function C(t,r){try{let n=new URL(t),s=new URL(r);if(s.protocol!=="*:"&&n.protocol!==s.protocol||s.hostname!=="*"&&n.hostname!==s.hostname)return!1;let e=s.pathname.replace(/\*\*/g,".*").replace(/\*/g,"[^/]*").replace(/[.+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`^${e}$`).test(n.pathname)}catch{return!1}}