@ntnyq/utils 0.3.3 → 0.4.1

package/README.md

@@ -10,18 +10,22 @@
 
 ## Install
 
-```bash
+```shell
 npm install @ntnyq/utils
 ```
 
-```bash
+```shell
 yarn add @ntnyq/utils
 ```
 
-```bash
+```shell
 pnpm add @ntnyq/utils
 ```
 
+## Credits
+
+- [antfu/utils](https://github.com/antfu/utils)
+
 ## License
 
 [MIT](./LICENSE) License © 2024-PRESENT [ntnyq](https://github.com/ntnyq)

package/dist/index.cjs

@@ -15,7 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -24,6 +23,7 @@ __export(src_exports, {
   NOOP: () => NOOP,
   at: () => at,
   cAF: () => cAF,
+  camelCase: () => camelCase,
   capitalize: () => capitalize,
   chunk: () => chunk,
   clamp: () => clamp,
@@ -32,6 +32,8 @@ __export(src_exports, {
   debounce: () => debounce,
   ensurePrefix: () => ensurePrefix,
   ensureSuffix: () => ensureSuffix,
+  escapeHtml: () => escapeHtml,
+  flatCase: () => flatCase,
   flattenArrayable: () => flattenArrayable,
   getObjectType: () => getObjectType,
   hasOwn: () => hasOwn,
@@ -60,25 +62,34 @@ __export(src_exports, {
   isSet: () => isSet,
   isString: () => isString,
   isUndefined: () => isUndefined,
+  isUppercase: () => isUppercase,
   isWhitespaceString: () => isWhitespaceString,
   isZero: () => isZero,
   join: () => join,
+  kebabCase: () => kebabCase,
   last: () => last,
+  lowerFirst: () => lowerFirst,
   mergeArrayable: () => mergeArrayable,
   minutes: () => minutes,
   noop: () => noop,
   omit: () => omit,
   once: () => once,
+  pascalCase: () => pascalCase,
   pick: () => pick,
   rAF: () => rAF,
   seconds: () => seconds,
   slash: () => slash,
+  snakeCase: () => snakeCase,
   sortObject: () => sortObject,
+  splitByCase: () => splitByCase,
   throttle: () => throttle,
+  titleCase: () => titleCase,
   toArray: () => toArray,
+  trainCase: () => trainCase,
   unindent: () => unindent,
   unique: () => unique,
   uniqueBy: () => uniqueBy,
+  upperFirst: () => upperFirst,
   waitFor: () => waitFor,
   warnOnce: () => warnOnce,
   weeks: () => weeks
@@ -314,6 +325,11 @@ var warnOnce = (message) => {
   console.warn(message);
 };
 
+// src/html/escapeHtml.ts
+function escapeHtml(unsafe) {
+  return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+
 // src/array/at.ts
 function at(array, index) {
   const length = array.length;
@@ -390,10 +406,10 @@ function unindent(input) {
   const lines = (typeof input === "string" ? input : input[0]).split("\n");
   const whitespaceLines = lines.map((line) => _RE_FULL_WS.test(line));
   const commonIndent = lines.reduce((min, line, idx) => {
-    if (!whitespaceLines[idx]) {
+    if (whitespaceLines[idx]) {
       return min;
     }
-    const indent = line.match(/^\s/)?.[0].length;
+    const indent = line.match(/^\s*/)?.[0].length;
     return indent === void 0 ? min : Math.min(min, indent);
   }, Number.POSITIVE_INFINITY);
   let emptylinesHead = 0;
@@ -516,31 +532,94 @@ function sortObject(obj, options = {}) {
   return sortKeys(obj);
 }
 
-// src/vendor/index.ts
-var vendor_exports = {};
-__export(vendor_exports, {
-  capitalize: () => capitalize
-});
+// node_modules/.pnpm/scule@1.3.0/node_modules/scule/dist/index.mjs
+var NUMBER_CHAR_RE = /\d/;
+var STR_SPLITTERS = ["-", "_", "/", "."];
+function isUppercase(char = "") {
+  if (NUMBER_CHAR_RE.test(char)) {
+    return void 0;
+  }
+  return char !== char.toLowerCase();
+}
+function splitByCase(str, separators) {
+  const splitters = separators ?? STR_SPLITTERS;
+  const parts = [];
+  if (!str || typeof str !== "string") {
+    return parts;
+  }
+  let buff = "";
+  let previousUpper;
+  let previousSplitter;
+  for (const char of str) {
+    const isSplitter = splitters.includes(char);
+    if (isSplitter === true) {
+      parts.push(buff);
+      buff = "";
+      previousUpper = void 0;
+      continue;
+    }
+    const isUpper = isUppercase(char);
+    if (previousSplitter === false) {
+      if (previousUpper === false && isUpper === true) {
+        parts.push(buff);
+        buff = char;
+        previousUpper = isUpper;
+        continue;
+      }
+      if (previousUpper === true && isUpper === false && buff.length > 1) {
+        const lastChar = buff.at(-1);
+        parts.push(buff.slice(0, Math.max(0, buff.length - 1)));
+        buff = lastChar + char;
+        previousUpper = isUpper;
+        continue;
+      }
+    }
+    buff += char;
+    previousUpper = isUpper;
+    previousSplitter = isSplitter;
+  }
+  parts.push(buff);
+  return parts;
+}
+function upperFirst(str) {
+  return str ? str[0].toUpperCase() + str.slice(1) : "";
+}
+function lowerFirst(str) {
+  return str ? str[0].toLowerCase() + str.slice(1) : "";
+}
+function pascalCase(str, opts) {
+  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("") : "";
+}
+function camelCase(str, opts) {
+  return lowerFirst(pascalCase(str || "", opts));
+}
+function kebabCase(str, joiner) {
+  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => p.toLowerCase()).join(joiner ?? "-") : "";
+}
+function snakeCase(str) {
+  return kebabCase(str || "", "_");
+}
+function flatCase(str) {
+  return kebabCase(str || "", "");
+}
+function trainCase(str, opts) {
+  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("-");
+}
+var titleCaseExceptions = /^(a|an|and|as|at|but|by|for|if|in|is|nor|of|on|or|the|to|with)$/i;
+function titleCase(str, opts) {
+  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map(
+    (p) => titleCaseExceptions.test(p) ? p.toLowerCase() : upperFirst(opts?.normalize ? p.toLowerCase() : p)
+  ).join(" ");
+}
 
 // src/vendor/scule.ts
-var scule_exports = {};
-__export(scule_exports, {
-  capitalize: () => capitalize
-});
-var import_scule = require("scule");
-__reExport(scule_exports, require("scule"));
-var capitalize = import_scule.upperFirst;
-
-// src/vendor/index.ts
-__reExport(vendor_exports, scule_exports);
-
-// src/index.ts
-__reExport(src_exports, vendor_exports, module.exports);
+var capitalize = upperFirst;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   NOOP,
   at,
   cAF,
+  camelCase,
   capitalize,
   chunk,
   clamp,
@@ -549,6 +628,8 @@ __reExport(src_exports, vendor_exports, module.exports);
   debounce,
   ensurePrefix,
   ensureSuffix,
+  escapeHtml,
+  flatCase,
   flattenArrayable,
   getObjectType,
   hasOwn,
@@ -577,25 +658,34 @@ __reExport(src_exports, vendor_exports, module.exports);
   isSet,
   isString,
   isUndefined,
+  isUppercase,
   isWhitespaceString,
   isZero,
   join,
+  kebabCase,
   last,
+  lowerFirst,
   mergeArrayable,
   minutes,
   noop,
   omit,
   once,
+  pascalCase,
   pick,
   rAF,
   seconds,
   slash,
+  snakeCase,
   sortObject,
+  splitByCase,
   throttle,
+  titleCase,
   toArray,
+  trainCase,
   unindent,
   unique,
   uniqueBy,
+  upperFirst,
   waitFor,
   warnOnce,
   weeks

package/dist/index.d.cts

@@ -136,6 +136,8 @@ declare function debounce<T extends ((...args: any[]) => undefined | void) | und
 
 declare const warnOnce: (message: string) => void;
 
+declare function escapeHtml(unsafe: string): string;
+
 /**
  * Get array item by index, negative for backward
  * @param array - given array
@@ -244,7 +246,7 @@ declare function join(array: JoinableValue[], options?: JoinOptions): string;
 declare function slash(input: string): string;
 
 /**
- * Remove leading whitespace from a template string
+ * Remove common leading whitespace from a template string
  * Empty lines at the beginning and end of the template string are also removed.
  * @param input - template string
  *
@@ -360,4 +362,4 @@ declare function sortObject<T extends Record<string, any>>(obj: T, options?: Sor
  */
 declare const capitalize: typeof upperFirst;
 
-export { type AnyFn, type Arrayable, type Awaitable, type CleanObjectOptions, type InteropModuleDefault, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, cleanObject, days, debounce, ensurePrefix, ensureSuffix, flattenArrayable, getObjectType, hasOwn, hours, isArray, isArrayEqual, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyObject, isEmptyString, isEmptyStringOrWhitespace, isFunction, isInteger, isNaN, isNativePromise, isNil, isNonEmptyString, isNull, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+export { type AnyFn, type Arrayable, type Awaitable, type CleanObjectOptions, type InteropModuleDefault, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, cleanObject, days, debounce, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, isArray, isArrayEqual, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyObject, isEmptyString, isEmptyStringOrWhitespace, isFunction, isInteger, isNaN, isNativePromise, isNil, isNonEmptyString, isNull, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.d.ts

@@ -136,6 +136,8 @@ declare function debounce<T extends ((...args: any[]) => undefined | void) | und
 
 declare const warnOnce: (message: string) => void;
 
+declare function escapeHtml(unsafe: string): string;
+
 /**
  * Get array item by index, negative for backward
  * @param array - given array
@@ -244,7 +246,7 @@ declare function join(array: JoinableValue[], options?: JoinOptions): string;
 declare function slash(input: string): string;
 
 /**
- * Remove leading whitespace from a template string
+ * Remove common leading whitespace from a template string
  * Empty lines at the beginning and end of the template string are also removed.
  * @param input - template string
  *
@@ -360,4 +362,4 @@ declare function sortObject<T extends Record<string, any>>(obj: T, options?: Sor
  */
 declare const capitalize: typeof upperFirst;
 
-export { type AnyFn, type Arrayable, type Awaitable, type CleanObjectOptions, type InteropModuleDefault, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, cleanObject, days, debounce, ensurePrefix, ensureSuffix, flattenArrayable, getObjectType, hasOwn, hours, isArray, isArrayEqual, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyObject, isEmptyString, isEmptyStringOrWhitespace, isFunction, isInteger, isNaN, isNativePromise, isNil, isNonEmptyString, isNull, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+export { type AnyFn, type Arrayable, type Awaitable, type CleanObjectOptions, type InteropModuleDefault, type MayBe, NOOP, type NonEmptyString, type Nullable, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, type ResolvedOptions, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, capitalize, chunk, clamp, cleanObject, days, debounce, ensurePrefix, ensureSuffix, escapeHtml, flattenArrayable, getObjectType, hasOwn, hours, isArray, isArrayEqual, isBoolean, isBrowser, isDeepEqual, isEmptyArray, isEmptyObject, isEmptyString, isEmptyStringOrWhitespace, isFunction, isInteger, isNaN, isNativePromise, isNil, isNonEmptyString, isNull, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, pick, rAF, seconds, slash, sortObject, throttle, toArray, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.js

@@ -1,87 +1,3 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  NOOP: () => NOOP,
-  at: () => at,
-  cAF: () => cAF,
-  capitalize: () => capitalize,
-  chunk: () => chunk,
-  clamp: () => clamp,
-  cleanObject: () => cleanObject,
-  days: () => days,
-  debounce: () => debounce,
-  ensurePrefix: () => ensurePrefix,
-  ensureSuffix: () => ensureSuffix,
-  flattenArrayable: () => flattenArrayable,
-  getObjectType: () => getObjectType,
-  hasOwn: () => hasOwn,
-  hours: () => hours,
-  isArray: () => isArray,
-  isArrayEqual: () => isArrayEqual,
-  isBoolean: () => isBoolean,
-  isBrowser: () => isBrowser,
-  isDeepEqual: () => isDeepEqual,
-  isEmptyArray: () => isEmptyArray,
-  isEmptyObject: () => isEmptyObject,
-  isEmptyString: () => isEmptyString,
-  isEmptyStringOrWhitespace: () => isEmptyStringOrWhitespace,
-  isFunction: () => isFunction,
-  isInteger: () => isInteger,
-  isNaN: () => isNaN,
-  isNativePromise: () => isNativePromise,
-  isNil: () => isNil,
-  isNonEmptyString: () => isNonEmptyString,
-  isNull: () => isNull,
-  isNumber: () => isNumber,
-  isNumbericString: () => isNumbericString,
-  isObject: () => isObject,
-  isPromise: () => isPromise,
-  isRegExp: () => isRegExp,
-  isSet: () => isSet,
-  isString: () => isString,
-  isUndefined: () => isUndefined,
-  isWhitespaceString: () => isWhitespaceString,
-  isZero: () => isZero,
-  join: () => join,
-  last: () => last,
-  mergeArrayable: () => mergeArrayable,
-  minutes: () => minutes,
-  noop: () => noop,
-  omit: () => omit,
-  once: () => once,
-  pick: () => pick,
-  rAF: () => rAF,
-  seconds: () => seconds,
-  slash: () => slash,
-  sortObject: () => sortObject,
-  throttle: () => throttle,
-  toArray: () => toArray,
-  unindent: () => unindent,
-  unique: () => unique,
-  uniqueBy: () => uniqueBy,
-  waitFor: () => waitFor,
-  warnOnce: () => warnOnce,
-  weeks: () => weeks
-});
-
 // src/is/isDeepEqual.ts
 function isDeepEqual(value1, value2) {
   const type1 = getObjectType(value1);
@@ -311,6 +227,11 @@ var warnOnce = (message) => {
   console.warn(message);
 };
 
+// src/html/escapeHtml.ts
+function escapeHtml(unsafe) {
+  return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+
 // src/array/at.ts
 function at(array, index) {
   const length = array.length;
@@ -387,10 +308,10 @@ function unindent(input) {
   const lines = (typeof input === "string" ? input : input[0]).split("\n");
   const whitespaceLines = lines.map((line) => _RE_FULL_WS.test(line));
   const commonIndent = lines.reduce((min, line, idx) => {
-    if (!whitespaceLines[idx]) {
+    if (whitespaceLines[idx]) {
       return min;
     }
-    const indent = line.match(/^\s/)?.[0].length;
+    const indent = line.match(/^\s*/)?.[0].length;
     return indent === void 0 ? min : Math.min(min, indent);
   }, Number.POSITIVE_INFINITY);
   let emptylinesHead = 0;
@@ -513,31 +434,93 @@ function sortObject(obj, options = {}) {
   return sortKeys(obj);
 }
 
-// src/vendor/index.ts
-var vendor_exports = {};
-__export(vendor_exports, {
-  capitalize: () => capitalize
-});
+// node_modules/.pnpm/scule@1.3.0/node_modules/scule/dist/index.mjs
+var NUMBER_CHAR_RE = /\d/;
+var STR_SPLITTERS = ["-", "_", "/", "."];
+function isUppercase(char = "") {
+  if (NUMBER_CHAR_RE.test(char)) {
+    return void 0;
+  }
+  return char !== char.toLowerCase();
+}
+function splitByCase(str, separators) {
+  const splitters = separators ?? STR_SPLITTERS;
+  const parts = [];
+  if (!str || typeof str !== "string") {
+    return parts;
+  }
+  let buff = "";
+  let previousUpper;
+  let previousSplitter;
+  for (const char of str) {
+    const isSplitter = splitters.includes(char);
+    if (isSplitter === true) {
+      parts.push(buff);
+      buff = "";
+      previousUpper = void 0;
+      continue;
+    }
+    const isUpper = isUppercase(char);
+    if (previousSplitter === false) {
+      if (previousUpper === false && isUpper === true) {
+        parts.push(buff);
+        buff = char;
+        previousUpper = isUpper;
+        continue;
+      }
+      if (previousUpper === true && isUpper === false && buff.length > 1) {
+        const lastChar = buff.at(-1);
+        parts.push(buff.slice(0, Math.max(0, buff.length - 1)));
+        buff = lastChar + char;
+        previousUpper = isUpper;
+        continue;
+      }
+    }
+    buff += char;
+    previousUpper = isUpper;
+    previousSplitter = isSplitter;
+  }
+  parts.push(buff);
+  return parts;
+}
+function upperFirst(str) {
+  return str ? str[0].toUpperCase() + str.slice(1) : "";
+}
+function lowerFirst(str) {
+  return str ? str[0].toLowerCase() + str.slice(1) : "";
+}
+function pascalCase(str, opts) {
+  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("") : "";
+}
+function camelCase(str, opts) {
+  return lowerFirst(pascalCase(str || "", opts));
+}
+function kebabCase(str, joiner) {
+  return str ? (Array.isArray(str) ? str : splitByCase(str)).map((p) => p.toLowerCase()).join(joiner ?? "-") : "";
+}
+function snakeCase(str) {
+  return kebabCase(str || "", "_");
+}
+function flatCase(str) {
+  return kebabCase(str || "", "");
+}
+function trainCase(str, opts) {
+  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map((p) => upperFirst(opts?.normalize ? p.toLowerCase() : p)).join("-");
+}
+var titleCaseExceptions = /^(a|an|and|as|at|but|by|for|if|in|is|nor|of|on|or|the|to|with)$/i;
+function titleCase(str, opts) {
+  return (Array.isArray(str) ? str : splitByCase(str)).filter(Boolean).map(
+    (p) => titleCaseExceptions.test(p) ? p.toLowerCase() : upperFirst(opts?.normalize ? p.toLowerCase() : p)
+  ).join(" ");
+}
 
 // src/vendor/scule.ts
-var scule_exports = {};
-__export(scule_exports, {
-  capitalize: () => capitalize
-});
-__reExport(scule_exports, scule_star);
-import { upperFirst } from "scule";
-import * as scule_star from "scule";
 var capitalize = upperFirst;
-
-// src/vendor/index.ts
-__reExport(vendor_exports, scule_exports);
-
-// src/index.ts
-__reExport(src_exports, vendor_exports);
 export {
   NOOP,
   at,
   cAF,
+  camelCase,
   capitalize,
   chunk,
   clamp,
@@ -546,6 +529,8 @@ export {
   debounce,
   ensurePrefix,
   ensureSuffix,
+  escapeHtml,
+  flatCase,
   flattenArrayable,
   getObjectType,
   hasOwn,
@@ -574,25 +559,34 @@ export {
   isSet,
   isString,
   isUndefined,
+  isUppercase,
   isWhitespaceString,
   isZero,
   join,
+  kebabCase,
   last,
+  lowerFirst,
   mergeArrayable,
   minutes,
   noop,
   omit,
   once,
+  pascalCase,
   pick,
   rAF,
   seconds,
   slash,
+  snakeCase,
   sortObject,
+  splitByCase,
   throttle,
+  titleCase,
   toArray,
+  trainCase,
   unindent,
   unique,
   uniqueBy,
+  upperFirst,
   waitFor,
   warnOnce,
   weeks

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "Common used utils.",
   "keywords": [
     "utils"