qsu 1.16.0 → 1.17.0

package/dist/_types/global.d.ts

@@ -20,6 +20,10 @@ export type RetryOptions = {
     delay?: number;
     backoff?: number;
 };
+export type PadOptions = {
+    position?: 'start' | 'end' | 'both';
+    char?: string;
+};
 export type ThrottleOptions = {
     leading?: boolean;
     trailing?: boolean;

package/dist/math/_decimalShift.d.ts

@@ -0,0 +1,10 @@
+/**
+ * (Private, not exported from the package) Multiplies a number by a power of ten by moving
+ * the exponent of its shortest string representation, instead of multiplying by `10 ** n`.
+ *
+ * `1.005 * 100` is `100.49999999999999`, so the naive form answers `1` for `round(1.005, 2)`
+ * and `1.1 * 10` is `11.000000000000002`, so `ceil(1.1, 1)` answers `1.2`. Parsing
+ * `'1.005e2'` yields exactly `100.5` instead, because the shortest representation is the
+ * decimal the caller wrote and the parser rounds it to the nearest double exactly once.
+ */
+export declare function decimalShift(value: number, exponent: number): number;

package/dist/math/_decimalShift.js

@@ -0,0 +1 @@
+export function decimalShift(e,t){const[r,i]=String(e).split("e");return Number(`${r}e${(i?Number(i):0)+t}`)}

package/dist/math/ceil.d.ts

@@ -0,0 +1 @@
+export declare function ceil(value: number, precision?: number): number;

package/dist/math/ceil.js

@@ -0,0 +1 @@
+import{decimalShift as i}from"./_decimalShift.js";export function ceil(e,t=0){return Number.isFinite(e)?i(Math.ceil(i(e,t)),-t):e}

package/dist/math/clamp.d.ts

@@ -0,0 +1 @@
+export declare function clamp(value: number, min: number, max: number): number;

package/dist/math/clamp.js

@@ -0,0 +1 @@
+export function clamp(t,a,n){return Math.max(Math.min(t,n),a)}

package/dist/math/floor.d.ts

@@ -0,0 +1 @@
+export declare function floor(value: number, precision?: number): number;

package/dist/math/floor.js

@@ -0,0 +1 @@
+import{decimalShift as o}from"./_decimalShift.js";export function floor(r,i=0){return Number.isFinite(r)?o(Math.floor(o(r,i)),-i):r}

package/dist/math/index.d.ts

@@ -1,6 +1,12 @@
+export { ceil } from './ceil.js';
+export { clamp } from './clamp.js';
 export { div } from './div.js';
+export { floor } from './floor.js';
+export { max } from './max.js';
+export { min } from './min.js';
 export { mul } from './mul.js';
 export { numPick } from './numPick.js';
 export { numUnique } from './numUnique.js';
+export { round } from './round.js';
 export { sub } from './sub.js';
 export { sum } from './sum.js';

package/dist/math/index.js

@@ -1 +1 @@
-export{div}from"./div.js";export{mul}from"./mul.js";export{numPick}from"./numPick.js";export{numUnique}from"./numUnique.js";export{sub}from"./sub.js";export{sum}from"./sum.js";
+export{ceil}from"./ceil.js";export{clamp}from"./clamp.js";export{div}from"./div.js";export{floor}from"./floor.js";export{max}from"./max.js";export{min}from"./min.js";export{mul}from"./mul.js";export{numPick}from"./numPick.js";export{numUnique}from"./numUnique.js";export{round}from"./round.js";export{sub}from"./sub.js";export{sum}from"./sum.js";

package/dist/math/max.d.ts

@@ -0,0 +1,2 @@
+export declare function max(...args: any[]): number | null;
+export declare function max(...args: Array<number>): number | null;

package/dist/math/max.js

@@ -0,0 +1 @@
+export function max(...n){const r=n.length>0&&Array.isArray(n[0])?n[0]:n;let t=null;for(let n=0,e=r.length;n<e;n+=1){const e=r[n];"number"==typeof e&&!Number.isNaN(e)&&(null===t||e>t)&&(t=e)}return t}

package/dist/math/min.d.ts

@@ -0,0 +1,2 @@
+export declare function min(...args: any[]): number | null;
+export declare function min(...args: Array<number>): number | null;

package/dist/math/min.js

@@ -0,0 +1 @@
+export function min(...n){const r=n.length>0&&Array.isArray(n[0])?n[0]:n;let t=null;for(let n=0,e=r.length;n<e;n+=1){const e=r[n];"number"==typeof e&&!Number.isNaN(e)&&(null===t||e<t)&&(t=e)}return t}

package/dist/math/round.d.ts

@@ -0,0 +1 @@
+export declare function round(value: number, precision?: number): number;

package/dist/math/round.js

@@ -0,0 +1 @@
+import{decimalShift as r}from"./_decimalShift.js";export function round(t,n=0){if(!Number.isFinite(t))return t;const i=r(t,n),o=i<0?-Math.round(-i):Math.round(i);return r(o,-n)}

package/dist/object/index.d.ts

@@ -1,8 +1,12 @@
+export { objClone } from './objClone.js';
 export { objDeleteKeyByValue } from './objDeleteKeyByValue.js';
 export { objFindItemRecursiveByKey } from './objFindItemRecursiveByKey.js';
+export { objGet } from './objGet.js';
 export { objInvert } from './objInvert.js';
 export { objMapKeys } from './objMapKeys.js';
+export { objMerge } from './objMerge.js';
 export { objMergeNewKey } from './objMergeNewKey.js';
+export { objPick } from './objPick.js';
 export { objPickBy } from './objPickBy.js';
 export { objTo1d } from './objTo1d.js';
 export { objToArray } from './objToArray.js';

package/dist/object/index.js

@@ -1 +1 @@
-export{objDeleteKeyByValue}from"./objDeleteKeyByValue.js";export{objFindItemRecursiveByKey}from"./objFindItemRecursiveByKey.js";export{objInvert}from"./objInvert.js";export{objMapKeys}from"./objMapKeys.js";export{objMergeNewKey}from"./objMergeNewKey.js";export{objPickBy}from"./objPickBy.js";export{objTo1d}from"./objTo1d.js";export{objToArray}from"./objToArray.js";export{objToPrettyStr}from"./objToPrettyStr.js";export{objToQueryString}from"./objToQueryString.js";export{objUpdate}from"./objUpdate.js";
+export{objClone}from"./objClone.js";export{objDeleteKeyByValue}from"./objDeleteKeyByValue.js";export{objFindItemRecursiveByKey}from"./objFindItemRecursiveByKey.js";export{objGet}from"./objGet.js";export{objInvert}from"./objInvert.js";export{objMapKeys}from"./objMapKeys.js";export{objMerge}from"./objMerge.js";export{objMergeNewKey}from"./objMergeNewKey.js";export{objPick}from"./objPick.js";export{objPickBy}from"./objPickBy.js";export{objTo1d}from"./objTo1d.js";export{objToArray}from"./objToArray.js";export{objToPrettyStr}from"./objToPrettyStr.js";export{objToQueryString}from"./objToQueryString.js";export{objUpdate}from"./objUpdate.js";

package/dist/object/objClone.d.ts

@@ -0,0 +1,3 @@
+export declare function objClone(obj: any, options?: {
+    deep?: boolean;
+}): any;

package/dist/object/objClone.js

@@ -0,0 +1 @@
+import{isObject as e}from"../verify/isObject.js";function t(n,r){if(null===n||"object"!=typeof n)return n;if(r.has(n))return r.get(n);if(n instanceof Date)return new Date(n.getTime());if(n instanceof RegExp)return new RegExp(n.source,n.flags);if(Array.isArray(n)){const e=[];r.set(n,e);for(let a=0,o=n.length;a<o;a+=1)e[a]=t(n[a],r);return e}if(n instanceof Map){const e=new Map;return r.set(n,e),n.forEach((n,a)=>{e.set(t(a,r),t(n,r))}),e}if(n instanceof Set){const e=new Set;return r.set(n,e),n.forEach(n=>{e.add(t(n,r))}),e}if(e(n)){const e={};return r.set(n,e),Object.keys(n).forEach(a=>{e[a]=t(n[a],r)}),e}return n}export function objClone(n,r){return null===n||"object"!=typeof n?n:!1===r?.deep?Array.isArray(n)?[...n]:n instanceof Date?new Date(n.getTime()):n instanceof RegExp?new RegExp(n.source,n.flags):n instanceof Map?new Map(n):n instanceof Set?new Set(n):e(n)?{...n}:n:t(n,new WeakMap)}

package/dist/object/objGet.d.ts

@@ -0,0 +1,4 @@
+import type { AnyValueObject } from '../_types/global';
+export declare function objGet(obj: AnyValueObject, path: string, options?: {
+    fallback?: any;
+}): any;

package/dist/object/objGet.js

@@ -0,0 +1 @@
+export function objGet(t,n,e){const o=e?.fallback??null;if(!t||"object"!=typeof t||"string"!=typeof n)return o;const c=function(t){const n=[],e=t.length;let o="",c=0;for(;c<e;){const e=t[c];if("["===e){const l=t.indexOf("]",c);if(-1===l){o+=e,c+=1;continue}""!==o&&(n.push(o),o="");let s=t.slice(c+1,l);const u=s[0];s.length>=2&&("'"===u||'"'===u)&&s.endsWith(u)&&(s=s.slice(1,-1)),n.push(s),c=l+1,"."===t[c]&&(c+=1);continue}"."!==e?(o+=e,c+=1):(n.push(o),o="",c+=1)}return""===o&&0!==n.length||n.push(o),n}(n);let l=t;for(let t=0,n=c.length;t<n;t+=1){if(null===l||"object"!=typeof l||!Object.hasOwn(l,c[t]))return o;l=l[c[t]]}return l}

package/dist/object/objMerge.d.ts

@@ -0,0 +1,2 @@
+import type { AnyValueObject } from '../_types/global';
+export declare function objMerge(...objects: AnyValueObject[]): AnyValueObject | null;

package/dist/object/objMerge.js

@@ -0,0 +1 @@
+import{isObject as e}from"../verify/isObject.js";export function objMerge(...t){if(0===t.length)return null;const n={};for(let r=0,o=t.length;r<o;r+=1){const o=t[r];if(!e(o))return null;const l=Object.keys(o);for(let t=0,r=l.length;t<r;t+=1){const r=l[t],c=o[r];n[r]=e(n[r])&&e(c)?objMerge(n[r],c):c}}return n}

package/dist/object/objPick.d.ts

@@ -0,0 +1,2 @@
+import type { AnyValueObject } from '../_types/global';
+export declare function objPick(obj: AnyValueObject, keys: string | string[]): AnyValueObject | null;

package/dist/object/objPick.js

@@ -0,0 +1 @@
+export function objPick(t,r){if(!t||"object"!=typeof t)return null;const n=Array.isArray(r)?r:[r],e={};for(let r=0,o=n.length;r<o;r+=1){const o=n[r];Object.hasOwn(t,o)&&(e[o]=t[o])}return e}

package/dist/string/_capitalizeWord.d.ts

@@ -0,0 +1,10 @@
+/**
+ * (Private, not exported from the package) Uppercases the first character of a word and
+ * lowercases the rest, so `XML` becomes `Xml`.
+ *
+ * The word is split by code point rather than indexed, because indexing a JavaScript string
+ * walks UTF-16 units and would cut a surrogate pair in half, disagreeing with the Dart and
+ * Python implementations. This is what the case-conversion family needs, and it is not the
+ * same as the public `capitalizeFirst`, which leaves the rest of the string alone.
+ */
+export declare function capitalizeWord(word: string): string;

package/dist/string/_capitalizeWord.js

@@ -0,0 +1 @@
+export function capitalizeWord(r){if(!r)return"";const e=Array.from(r);return e[0].toUpperCase()+e.slice(1).join("").toLowerCase()}

package/dist/string/index.d.ts

@@ -5,6 +5,7 @@ export { deburr } from './deburr.js';
 export { escapeRegExp } from './escapeRegExp.js';
 export { getGroupKeys } from './getGroupKeys.js';
 export { getStrBytes } from './getStrBytes.js';
+export { pad } from './pad.js';
 export { removeNewLine } from './removeNewLine.js';
 export { removeSpecialChar } from './removeSpecialChar.js';
 export { replaceBetween } from './replaceBetween.js';
@@ -14,6 +15,11 @@ export { strCount } from './strCount.js';
 export { strRandom } from './strRandom.js';
 export { strShuffle } from './strShuffle.js';
 export { strToAscii } from './strToAscii.js';
+export { strToCamelCase } from './strToCamelCase.js';
+export { strToConstantCase } from './strToConstantCase.js';
+export { strToKebabCase } from './strToKebabCase.js';
+export { strToPascalCase } from './strToPascalCase.js';
+export { strToSnakeCase } from './strToSnakeCase.js';
 export { strUnique } from './strUnique.js';
 export { trim } from './trim.js';
 export { truncate } from './truncate.js';

package/dist/string/index.js

@@ -1 +1 @@
-export{capitalizeEachWords}from"./capitalizeEachWords.js";export{capitalizeEverySentence}from"./capitalizeEverySentence.js";export{capitalizeFirst}from"./capitalizeFirst.js";export{deburr}from"./deburr.js";export{escapeRegExp}from"./escapeRegExp.js";export{getGroupKeys}from"./getGroupKeys.js";export{getStrBytes}from"./getStrBytes.js";export{removeNewLine}from"./removeNewLine.js";export{removeSpecialChar}from"./removeSpecialChar.js";export{replaceBetween}from"./replaceBetween.js";export{split}from"./split.js";export{strBlindRandom}from"./strBlindRandom.js";export{strCount}from"./strCount.js";export{strRandom}from"./strRandom.js";export{strShuffle}from"./strShuffle.js";export{strToAscii}from"./strToAscii.js";export{strUnique}from"./strUnique.js";export{trim}from"./trim.js";export{truncate}from"./truncate.js";export{truncateExpect}from"./truncateExpect.js";export{uncapitalizeFirst}from"./uncapitalizeFirst.js";export{urlJoin}from"./urlJoin.js";export{words}from"./words.js";
+export{capitalizeEachWords}from"./capitalizeEachWords.js";export{capitalizeEverySentence}from"./capitalizeEverySentence.js";export{capitalizeFirst}from"./capitalizeFirst.js";export{deburr}from"./deburr.js";export{escapeRegExp}from"./escapeRegExp.js";export{getGroupKeys}from"./getGroupKeys.js";export{getStrBytes}from"./getStrBytes.js";export{pad}from"./pad.js";export{removeNewLine}from"./removeNewLine.js";export{removeSpecialChar}from"./removeSpecialChar.js";export{replaceBetween}from"./replaceBetween.js";export{split}from"./split.js";export{strBlindRandom}from"./strBlindRandom.js";export{strCount}from"./strCount.js";export{strRandom}from"./strRandom.js";export{strShuffle}from"./strShuffle.js";export{strToAscii}from"./strToAscii.js";export{strToCamelCase}from"./strToCamelCase.js";export{strToConstantCase}from"./strToConstantCase.js";export{strToKebabCase}from"./strToKebabCase.js";export{strToPascalCase}from"./strToPascalCase.js";export{strToSnakeCase}from"./strToSnakeCase.js";export{strUnique}from"./strUnique.js";export{trim}from"./trim.js";export{truncate}from"./truncate.js";export{truncateExpect}from"./truncateExpect.js";export{uncapitalizeFirst}from"./uncapitalizeFirst.js";export{urlJoin}from"./urlJoin.js";export{words}from"./words.js";

package/dist/string/pad.d.ts

@@ -0,0 +1,2 @@
+import type { PadOptions } from '../_types/global';
+export declare function pad(str: string, length: number, options?: PadOptions): string;

package/dist/string/pad.js

@@ -0,0 +1 @@
+function t(t,r){if(r<=0)return"";const n=Array.from(t);let o="";for(let t=0;t<r;t+=1)o+=n[t%n.length];return o}export function pad(r,n,o){const e=r||"",f=o?.char??" ",a=Array.from(e).length;if(a>=n||!f)return e;const c=n-a,i=o?.position??"both";let l=Math.floor(c/2);return"start"===i?l=c:"end"===i&&(l=0),t(f,l)+e+t(f,c-l)}

package/dist/string/strToCamelCase.d.ts

@@ -0,0 +1 @@
+export declare function strToCamelCase(str: string): string;

package/dist/string/strToCamelCase.js

@@ -0,0 +1 @@
+import{capitalizeWord as o}from"./_capitalizeWord.js";import{words as r}from"./words.js";export function strToCamelCase(t){return t?r(t).map((r,t)=>0===t?r.toLowerCase():o(r)).join(""):""}

package/dist/string/strToConstantCase.d.ts

@@ -0,0 +1 @@
+export declare function strToConstantCase(str: string): string;

package/dist/string/strToConstantCase.js

@@ -0,0 +1 @@
+import{words as o}from"./words.js";export function strToConstantCase(r){return r?o(r).map(o=>o.toUpperCase()).join("_"):""}

package/dist/string/strToKebabCase.d.ts

@@ -0,0 +1 @@
+export declare function strToKebabCase(str: string): string;

package/dist/string/strToKebabCase.js

@@ -0,0 +1 @@
+import{words as o}from"./words.js";export function strToKebabCase(r){return r?o(r).map(o=>o.toLowerCase()).join("-"):""}

package/dist/string/strToPascalCase.d.ts

@@ -0,0 +1 @@
+export declare function strToPascalCase(str: string): string;

package/dist/string/strToPascalCase.js

@@ -0,0 +1 @@
+import{capitalizeWord as o}from"./_capitalizeWord.js";import{words as r}from"./words.js";export function strToPascalCase(t){return t?r(t).map(o).join(""):""}

package/dist/string/strToSnakeCase.d.ts

@@ -0,0 +1 @@
+export declare function strToSnakeCase(str: string): string;

package/dist/string/strToSnakeCase.js

@@ -0,0 +1 @@
+import{words as o}from"./words.js";export function strToSnakeCase(r){return r?o(r).map(o=>o.toLowerCase()).join("_"):""}

package/dist/web/escapeHtml.d.ts

@@ -0,0 +1 @@
+export declare function escapeHtml(str: string): string;

package/dist/web/escapeHtml.js

@@ -0,0 +1 @@
+const t=/[&<>"']/g,e={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"};export function escapeHtml(c){return c?c.replace(t,t=>e[t]):""}

package/dist/web/index.d.ts

@@ -1,3 +1,4 @@
+export { escapeHtml } from './escapeHtml.js';
 export { generateLicense } from './generateLicense.js';
 export { getParsedInfoFromAddress } from './getParsedInfoFromAddress.js';
 export { getSlug } from './getSlug.js';
@@ -5,3 +6,4 @@ export { isBotAgent } from './isBotAgent.js';
 export { isMatchPathname } from './isMatchPathname.js';
 export { isMobile } from './isMobile.js';
 export { removeLocalePrefix } from './removeLocalePrefix.js';
+export { unescapeHtml } from './unescapeHtml.js';

package/dist/web/index.js

@@ -1 +1 @@
-export{generateLicense}from"./generateLicense.js";export{getParsedInfoFromAddress}from"./getParsedInfoFromAddress.js";export{getSlug}from"./getSlug.js";export{isBotAgent}from"./isBotAgent.js";export{isMatchPathname}from"./isMatchPathname.js";export{isMobile}from"./isMobile.js";export{removeLocalePrefix}from"./removeLocalePrefix.js";
+export{escapeHtml}from"./escapeHtml.js";export{generateLicense}from"./generateLicense.js";export{getParsedInfoFromAddress}from"./getParsedInfoFromAddress.js";export{getSlug}from"./getSlug.js";export{isBotAgent}from"./isBotAgent.js";export{isMatchPathname}from"./isMatchPathname.js";export{isMobile}from"./isMobile.js";export{removeLocalePrefix}from"./removeLocalePrefix.js";export{unescapeHtml}from"./unescapeHtml.js";

package/dist/web/unescapeHtml.d.ts

@@ -0,0 +1 @@
+export declare function unescapeHtml(str: string): string;

package/dist/web/unescapeHtml.js

@@ -0,0 +1 @@
+const t=/&(?:amp|lt|gt|quot|#39);/g,e={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'"};export function unescapeHtml(n){return n?n.replace(t,t=>e[t]):""}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "qsu",
-	"version": "1.16.0",
+	"version": "1.17.0",
 	"description": "qsu is a utility library that contains useful and frequently used functions. Start with your preferred language and the modern development environment.",
 	"author": "CDGet <jooy2.contact@gmail.com>",
 	"license": "MIT",
@@ -83,7 +83,7 @@
 		"jiti": "^2.7.0",
 		"prettier": "^3.9.6",
 		"terser-glob": "^1.2.1",
-		"tsx": "^4.23.5",
+		"tsx": "^4.23.9",
 		"typescript": "6.0.3",
 		"typescript-eslint": "^8.66.0"
 	}