@bccampus/utils 0.1.1 → 0.2.1

package/dist/string/strip-html-tags.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const htmlTagRegExp = /(<([^>]+)>)/g;
+function stripHtmlTags(text) {
+  return text.replace(htmlTagRegExp, "");
+}
+exports.stripHtmlTags = stripHtmlTags;

package/dist/string/to-int.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function stringToInt(value, fallback = 0) {
+  let returnValue = value;
+  if (typeof returnValue === "string")
+    returnValue = Number.parseInt(returnValue);
+  if (Number.isNaN(returnValue)) returnValue = fallback;
+  return returnValue;
+}
+exports.stringToInt = stringToInt;

package/dist/string/to-sentence-case.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const specialCharRegExp = /[\s-_.+]+/g;
+const toSentenceCase = (s) => (s[0].toUpperCase() + s.slice(1).toLowerCase()).replace(
+  specialCharRegExp,
+  " "
+);
+exports.toSentenceCase = toSentenceCase;

package/dist/string/trim.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function trim(text, chars = " ") {
+  let start = 0;
+  let end = text.length;
+  if (!Array.isArray(chars)) chars = [chars];
+  while (start < end && chars.includes(text[start])) start += 1;
+  while (end > start && chars.includes(text[end - 1])) end -= 1;
+  return start > 0 || end < text.length ? text.substring(start, end) : text;
+}
+exports.trim = trim;

package/dist/string/truncate.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const defaultOptions = {
+  ending: "...",
+  maxlength: 100,
+  noWordBreak: false
+};
+function truncate(text, options) {
+  const conf = { ...defaultOptions, ...options };
+  text = text.trim();
+  if (conf.noWordBreak) {
+    const lastSpaceIndex = text.indexOf(" ", conf.maxlength);
+    if (lastSpaceIndex >= conf.maxlength)
+      return text.substring(0, lastSpaceIndex) + conf.ending;
+  } else if (text.length > conf.maxlength + conf.ending.length) {
+    return text.substring(0, conf.maxlength) + conf.ending;
+  }
+  return text;
+}
+exports.truncate = truncate;

package/dist/string/truncate.d.ts

@@ -1 +1,22 @@
-export declare function truncate(text: string, maxlength?: number, ending?: string): string;
+export interface TruncateOptions {
+    /**
+     * The maximum number of character allowed in the text before truncating it
+     *
+     * @default 100
+     */
+    maxlength?: number;
+    /**
+     * The string to use at the end of the truncated text
+     *
+     * @default "..."
+     */
+    ending?: string;
+    /**
+     * If true, truncates the text at the next space char,
+     * so the returned string can exceed the specified `maxLength`
+     *
+     * @default false
+     */
+    noWordBreak?: boolean;
+}
+export declare function truncate(text: string, options?: TruncateOptions): string;

package/dist/string/truncate.js

@@ -1,6 +1,17 @@
-function truncate(text, maxlength = 100, ending = "...") {
-  if (text.length > maxlength) {
-    return text.substring(0, maxlength - ending.length) + ending;
+const defaultOptions = {
+  ending: "...",
+  maxlength: 100,
+  noWordBreak: false
+};
+function truncate(text, options) {
+  const conf = { ...defaultOptions, ...options };
+  text = text.trim();
+  if (conf.noWordBreak) {
+    const lastSpaceIndex = text.indexOf(" ", conf.maxlength);
+    if (lastSpaceIndex >= conf.maxlength)
+      return text.substring(0, lastSpaceIndex) + conf.ending;
+  } else if (text.length > conf.maxlength + conf.ending.length) {
+    return text.substring(0, conf.maxlength) + conf.ending;
   }
   return text;
 }

package/dist/value/index.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const value_isEmpty = require("./is-empty.cjs");
+exports.isEmpty = value_isEmpty.isEmpty;

package/dist/value/index.d.ts

@@ -0,0 +1 @@
+export * from './is-empty';

package/dist/value/index.js

@@ -0,0 +1,4 @@
+import { isEmpty } from "./is-empty.js";
+export {
+  isEmpty
+};

package/dist/value/is-empty.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const isEmpty = (value) => {
+  if (value === void 0) return true;
+  if (value === null) return true;
+  if (typeof value === "string") return value.trim() === "";
+  if (typeof value === "object") {
+    if (Array.isArray(value) && value.length === 0) return true;
+    if (value instanceof Map || value instanceof Set) return value.size === 0;
+    return Object.keys(value).length === 0;
+  }
+  return false;
+};
+exports.isEmpty = isEmpty;

package/dist/value/is-empty.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Checks if the value is `empty`
+ *
+ * returns `true`, if the value
+ *
+ * - `undefined`
+ * - `null`
+ * - `string` and there is no character in the string or all white space
+ * - `array` and there is no item in the array
+ * - `map` and there is no item in the map
+ * - `set` and there is no item in the set
+ * - `object` and there is no property in the object
+ *
+ * otherwise, false
+ *
+ */
+export declare const isEmpty: (value: unknown) => boolean;

package/dist/value/is-empty.js

@@ -0,0 +1,14 @@
+const isEmpty = (value) => {
+  if (value === void 0) return true;
+  if (value === null) return true;
+  if (typeof value === "string") return value.trim() === "";
+  if (typeof value === "object") {
+    if (Array.isArray(value) && value.length === 0) return true;
+    if (value instanceof Map || value instanceof Set) return value.size === 0;
+    return Object.keys(value).length === 0;
+  }
+  return false;
+};
+export {
+  isEmpty
+};

package/package.json

@@ -1,45 +1,64 @@
 {
   "name": "@bccampus/utils",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "BCcampus' utility box",
   "type": "module",
   "license": "UNLICENSED",
   "exports": {
     "./array": {
       "types": "./dist/array/index.d.ts",
-      "import": "./dist/array/index.js"
+      "import": "./dist/array/index.js",
+      "require": "./dist/array/index.cjs"
     },
     "./date": {
       "types": "./dist/date/index.d.ts",
-      "import": "./dist/date/index.js"
+      "import": "./dist/date/index.js",
+      "require": "./dist/date/index.cjs"
     },
     "./duration": {
       "types": "./dist/duration/index.d.ts",
-      "import": "./dist/duration/index.js"
+      "import": "./dist/duration/index.js",
+      "require": "./dist/duration/index.cjs"
     },
     "./format": {
       "types": "./dist/format/index.d.ts",
-      "import": "./dist/format/index.js"
+      "import": "./dist/format/index.js",
+      "require": "./dist/format/index.cjs"
     },
     "./object": {
       "types": "./dist/object/index.d.ts",
-      "import": "./dist/object/index.js"
+      "import": "./dist/object/index.js",
+      "require": "./dist/object/index.cjs"
+    },
+    "./path": {
+      "types": "./dist/path/index.d.ts",
+      "import": "./dist/path/index.js",
+      "require": "./dist/path/index.cjs"
     },
     "./set": {
       "types": "./dist/set/index.d.ts",
-      "import": "./dist/set/index.js"
+      "import": "./dist/set/index.js",
+      "require": "./dist/set/index.cjs"
     },
     "./string": {
       "types": "./dist/string/index.d.ts",
-      "import": "./dist/string/index.js"
+      "import": "./dist/string/index.js",
+      "require": "./dist/string/index.cjs"
     },
     "./string/pluralize": {
       "types": "./dist/string/pluralize/index.d.ts",
-      "import": "./dist/string/pluralize/index.js"
+      "import": "./dist/string/pluralize/index.js",
+      "require": "./dist/string/pluralize/index.cjs"
     },
     "./string/slugify": {
       "types": "./dist/string/slugify/index.d.ts",
-      "import": "./dist/string/slugify/index.js"
+      "import": "./dist/string/slugify/index.js",
+      "require": "./dist/string/slugify/index.cjs"
+    },
+    "./value": {
+      "types": "./dist/value/index.d.ts",
+      "import": "./dist/value/index.js",
+      "require": "./dist/value/index.cjs"
     }
   },
   "packageManager": "yarn@4.15.0",

package/src/format/index.ts

@@ -1,3 +1,3 @@
-export * from "./formatter";
-export * from "./stringify";
-export * from "./template";
+export * from "./formatter";
+export * from "./stringify";
+export * from "./template";

package/src/path/file-url-to-path.ts

@@ -0,0 +1,12 @@
+const windowsDriveRegExp = /^\/[a-zA-Z1-9_-]+:\//;
+
+/**
+ * Browser compatible version of `node:url.fileURLToPath`
+ */
+export function fileURLToPath(fileUrl: string) {
+  const url = new URL(fileUrl);
+  let path = decodeURIComponent(url.pathname);
+  if (windowsDriveRegExp.test(path)) path = path.slice(1);
+
+  return path;
+}

package/src/path/index.ts

@@ -0,0 +1,2 @@
+export * from "./normalize";
+export * from "./file-url-to-path";

package/src/path/normalize.ts

@@ -0,0 +1,72 @@
+import { fileURLToPath } from "./file-url-to-path";
+
+export interface NormalizeOptions {
+  /**
+   * - `always`: ensure leading slash exists
+   * - `never`: ensure leading slash does not exist
+   * - `as-is`: do not modify the leading char
+   *
+   * @default "always"
+   */
+  leadingSlash?: "always" | "never" | "as-is";
+
+  /**
+   * - `always`: ensure trailing slash exists
+   * - `never`: ensure trailing slash does not exist
+   * - `as-is`: do not modify the trailing char
+   *
+   * @default "never"
+   */
+  trailingSlash?: "always" | "never" | "as-is";
+}
+
+const defaultOptions: Required<NormalizeOptions> = {
+  leadingSlash: "always",
+  trailingSlash: "never",
+};
+
+const windowsPathSepRegExp = /[\\]+/g;
+const unixPathSepRegExp = /[/]+/g;
+const windowsDriveRegExp = /^[a-zA-Z1-9_-]+:\//;
+const fileProtocolRegExp = /^file:\/\//;
+const leadingSlashRegExp = /^\//g;
+const trailingSlashRegExp = /\/$/g;
+
+/**
+ * Clears and converts the provided path to a Posix filepath
+ *
+ * By default, adds a leading slash and removes the trailing
+ *
+ * @example
+ * ```
+ *  normalize("src/test/"); //returns: /src/test
+ *  normalize("C:\\Users\\test\\folder\\"); //returns: C:/Users/test/folder
+ *  normalize("file:///C:/Users/test/folder/file.ts"); //returns: C:/Users/test/folder/file.ts
+ * ```
+ */
+export function normalize(path: string, options?: NormalizeOptions) {
+  const conf = { ...defaultOptions, ...options };
+  const sep = "\\";
+  let normalPath = path.trim();
+
+  if (fileProtocolRegExp.test(normalPath))
+    normalPath = fileURLToPath(normalPath);
+
+  normalPath = normalPath
+    .replace(windowsPathSepRegExp, sep) // windows -> linux
+    .replace(unixPathSepRegExp, sep); // multiple -> single
+
+  if (conf.leadingSlash !== "as-is") {
+    normalPath = normalPath.replace(leadingSlashRegExp, "");
+
+    if (conf.leadingSlash === "always" && !windowsDriveRegExp.test(normalPath))
+      normalPath = `${sep}${normalPath}`;
+  }
+
+  if (conf.trailingSlash !== "as-is") {
+    normalPath = normalPath.replace(trailingSlashRegExp, "");
+    if (conf.trailingSlash === "always") normalPath = `${normalPath}${sep}`;
+  }
+
+  return normalPath;
+}

package/src/string/normalize.ts

@@ -0,0 +1,7 @@
+/**
+ * Trims white spaces and
+ * replaces multiple white space characters with a single space
+ */
+export function normalize(text: string) {
+  return text.trim().replace(/\s+/g, " ");
+}

package/src/string/truncate.ts

@@ -1,11 +1,44 @@
-export function truncate(
-  text: string,
-  maxlength: number = 100,
-  ending: string = "...",
-) {
-  if (text.length > maxlength) {
-    return text.substring(0, maxlength - ending.length) + ending;
-  }
-
-  return text;
-}
+export interface TruncateOptions {
+  /**
+   * The maximum number of character allowed in the text before truncating it
+   *
+   * @default 100
+   */
+  maxlength?: number;
+
+  /**
+   * The string to use at the end of the truncated text
+   *
+   * @default "..."
+   */
+  ending?: string;
+
+  /**
+   * If true, truncates the text at the next space char,
+   * so the returned string can exceed the specified `maxLength`
+   *
+   * @default false
+   */
+  noWordBreak?: boolean;
+}
+
+const defaultOptions: Required<TruncateOptions> = {
+  ending: "...",
+  maxlength: 100,
+  noWordBreak: false,
+};
+
+export function truncate(text: string, options?: TruncateOptions) {
+  const conf = { ...defaultOptions, ...options };
+  text = text.trim();
+  if (conf.noWordBreak) {
+    const lastSpaceIndex = text.indexOf(" ", conf.maxlength);
+
+    if (lastSpaceIndex >= conf.maxlength)
+      return text.substring(0, lastSpaceIndex) + conf.ending;
+  } else if (text.length > conf.maxlength + conf.ending.length) {
+    return text.substring(0, conf.maxlength) + conf.ending;
+  }
+
+  return text;
+}

package/src/value/index.ts

@@ -0,0 +1 @@
+export * from "./is-empty";

package/src/value/is-empty.ts

@@ -0,0 +1,31 @@
+/**
+ * Checks if the value is `empty`
+ *
+ * returns `true`, if the value
+ *
+ * - `undefined`
+ * - `null`
+ * - `string` and there is no character in the string or all white space
+ * - `array` and there is no item in the array
+ * - `map` and there is no item in the map
+ * - `set` and there is no item in the set
+ * - `object` and there is no property in the object
+ *
+ * otherwise, false
+ *
+ */
+export const isEmpty = (value: unknown) => {
+  if (value === undefined) return true;
+  if (value === null) return true;
+
+  if (typeof value === "string") return value.trim() === "";
+  if (typeof value === "object") {
+    if (Array.isArray(value) && value.length === 0) return true;
+
+    if (value instanceof Map || value instanceof Set) return value.size === 0;
+
+    return Object.keys(value).length === 0;
+  }
+
+  return false;
+};

package/tsconfig.lib.json

@@ -1,36 +1,37 @@
-{
-  "compilerOptions": {
-    "module": "ESNext",
-    "target": "ESNext",
-    "lib": [
-      "DOM",
-      "ESNext"
-    ],
-    "strict": true,
-    "esModuleInterop": true,
-    "jsx": "preserve",
-    "skipLibCheck": true,
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "noUnusedLocals": true,
-    "strictNullChecks": true,
-    "allowJs": true,
-    "forceConsistentCasingInFileNames": true,
-    "noEmit": true,
-    "types": [
-      "node",
-    ],
-    "paths": {
-      "@/*": [
-        "./src/*"
-      ],
-    }
-  },
-  "include": [
-    "src/**/*",
-  ],
-  "exclude": [
-    "dist",
-    "node_modules"
-  ]
+{
+  "compilerOptions": {
+    "outDir": "./dist",
+    "module": "ESNext",
+    "target": "ESNext",
+    "lib": [
+      "DOM",
+      "ESNext"
+    ],
+    "strict": true,
+    "esModuleInterop": true,
+    "jsx": "preserve",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "noUnusedLocals": true,
+    "strictNullChecks": true,
+    "allowJs": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "types": [
+      "node",
+    ],
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ],
+    }
+  },
+  "include": [
+    "src/**/*",
+  ],
+  "exclude": [
+    "dist",
+    "node_modules"
+  ]
 }