@bccampus/utils 0.1.1 → 0.2.1

package/dist/array/chunk.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function chunk(arr, size = 5) {
+  const chunks = [];
+  for (let i = 0; i < arr.length; i += size)
+    chunks.push(arr.slice(i, i + size));
+  return chunks;
+}
+exports.chunk = chunk;

package/dist/array/index.cjs

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

package/dist/date/index.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const date_isoDateTime = require("./iso-date-time.cjs");
+exports.DefaultDateFormat = date_isoDateTime.DefaultDateFormat;
+exports.DefaultTimeFormat = date_isoDateTime.DefaultTimeFormat;
+exports.DefaultTimezone = date_isoDateTime.DefaultTimezone;
+exports.ISODateTime = date_isoDateTime.ISODateTime;
+exports.InvalidDate = date_isoDateTime.InvalidDate;

package/dist/date/iso-date-time.cjs

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const isoDateTimeRegEx = new RegExp("^([0-9-]+)(T([0-9:.,]+)(Z|[+-]([0-9:]+))?)?$");
+const dateRegEx = new RegExp("^(\\d{4})-?(\\d{2})?-?(\\d{2})?$");
+const timeRegEx = new RegExp("^(\\d{2}):?(\\d{2})?:?(\\d{2})?(\\.(\\d{3}))?$");
+const timezoneRegEx = new RegExp("^Z|^[+-]((\\d{2}):?(\\d{2})?)$");
+const InvalidDate = /* @__PURE__ */ Symbol("Invalid Date");
+const DefaultDateFormat = {
+  year: "numeric",
+  month: "long",
+  day: "2-digit"
+};
+const DefaultTimeFormat = {
+  hour: "2-digit",
+  minute: "2-digit",
+  timeZoneName: "short"
+};
+const DefaultTimezone = "America/Vancouver";
+class ISODateTime {
+  #parsed;
+  #date;
+  #string;
+  constructor(isoDatetime) {
+    if (typeof isoDatetime === "string") {
+      this.#parsed = ISODateTime.parse(isoDatetime);
+      if (this.#parsed) {
+        this.#date = new Date(ISODateTime.toString(this));
+      } else {
+        this.#date = InvalidDate;
+        console.error(`Failed to parse date for value: ${isoDatetime}`);
+      }
+    } else if (typeof isoDatetime === "number" && Number.isFinite(isoDatetime)) {
+      this.#date = new Date(isoDatetime);
+      this.#parsed = ISODateTime.parse(this.#date.toISOString());
+    } else {
+      this.#date = /* @__PURE__ */ new Date();
+      this.#parsed = ISODateTime.parse(this.#date.toISOString());
+    }
+    if (this.#date !== InvalidDate) this.#string = this.#date.toISOString();
+    else this.#string = "Invalid Date";
+  }
+  /**
+   * Get date and time components
+   */
+  get parts() {
+    return this.#parsed;
+  }
+  /**
+   * Get timezone
+   */
+  get timezone() {
+    return this.parts?.timezone ?? "UTC";
+  }
+  /**
+   * Parse a string in ISO DateTime format.
+   * If the input is valid, returns date and time components;
+   * otherwise, returns `undefined`.
+   */
+  static parse(isoDatetime) {
+    const isoDatetimeParts = isoDatetime.match(isoDateTimeRegEx);
+    if (isoDatetimeParts) {
+      const dateParts = isoDatetimeParts[1] && isoDatetimeParts[1].match(dateRegEx);
+      if (!dateParts) return void 0;
+      const parsedDateTime = {
+        date: { year: dateParts[1], month: dateParts[2], day: dateParts[3] }
+      };
+      const timeParts = isoDatetimeParts[3] && isoDatetimeParts[3].match(timeRegEx);
+      if (timeParts) {
+        parsedDateTime.time = {
+          hours: timeParts[1],
+          minutes: timeParts[2],
+          seconds: timeParts[3],
+          milliseconds: timeParts[5]
+        };
+      }
+      const tzParts = isoDatetimeParts[4] && isoDatetimeParts[4].match(timezoneRegEx);
+      if (tzParts) {
+        parsedDateTime.timezone = tzParts[0];
+      }
+      return parsedDateTime;
+    }
+    return void 0;
+  }
+  static getISOString(parts) {
+    if (!parts) return "Invalid Date";
+    return `${parts.date.year}-${parts.date.month ?? "01"}-${parts.date.day ?? "01"}T${parts.time?.hours ?? "00"}:${parts.time?.minutes ?? "00"}:${parts.time?.seconds ?? "00"}.${parts.time?.milliseconds ?? "000"}${parts.timezone ?? "Z"}`;
+  }
+  static toString(dateTime) {
+    const _p = typeof dateTime === "string" ? ISODateTime.parse(dateTime) : dateTime.parts;
+    return ISODateTime.getISOString(_p);
+  }
+  /**
+   * Returns the stored time value in milliseconds since midnight, January 1, 1970 UTC.
+   */
+  valueOf() {
+    if (this.#date === InvalidDate) return Number.NaN;
+    return this.#date.valueOf();
+  }
+  /**
+   * Retruns ISO date and time string
+   */
+  toString() {
+    return this.#string;
+  }
+  /**
+   * Retruns Javascript date object
+   */
+  toDate() {
+    return this.#date;
+  }
+  get [Symbol.toStringTag]() {
+    return "ISODateTime";
+  }
+  [Symbol.toPrimitive](hint) {
+    if (hint === "string") return this.toString();
+    return this.valueOf();
+  }
+  toJSON() {
+    return this.toString();
+  }
+  static getFormatter(isoDatetime, config) {
+    let _format = {};
+    if (config?.customFormat?.dateStyle || config?.customFormat?.timeStyle) {
+      _format = {
+        dateStyle: config?.customFormat?.dateStyle,
+        timeStyle: config?.customFormat?.timeStyle
+      };
+    } else {
+      if (config?.noDate === true && config?.noTime === true) {
+        _format = { ...config.customFormat };
+      } else if (config?.noDate === true && !config?.noTime) {
+        _format = { ...DefaultTimeFormat, ...config.customFormat };
+      } else if (config?.noTime === true && !config.noDate) {
+        _format = { ...DefaultDateFormat, ...config.customFormat };
+      } else {
+        _format = { ...DefaultDateFormat, ...DefaultTimeFormat, ...config?.customFormat };
+      }
+    }
+    if (config?.customFormat?.timeZone) _format.timeZone = config.customFormat.timeZone;
+    else if (isoDatetime.parts?.time === void 0) _format.timeZone = "UTC";
+    else _format.timeZone = DefaultTimezone;
+    return new Intl.DateTimeFormat("en", _format);
+  }
+  static format(isoDatetime, config) {
+    const _isoDatetime = typeof isoDatetime === "string" ? new ISODateTime(isoDatetime) : isoDatetime;
+    const _date = _isoDatetime.toDate();
+    if (_date === InvalidDate) return _isoDatetime.toString();
+    const formatter = ISODateTime.getFormatter(_isoDatetime, config);
+    return formatter.format(_date);
+  }
+  static formatRange(startDate, endDate, config) {
+    const _startISODateTime = typeof startDate === "string" ? new ISODateTime(startDate) : startDate;
+    const _startDate = _startISODateTime.toDate();
+    if (_startDate === InvalidDate) return _startISODateTime.toString();
+    const _endISODateTime = typeof endDate === "string" ? new ISODateTime(endDate) : endDate;
+    const _endDate = _endISODateTime.toDate();
+    if (_endDate === InvalidDate) return _endISODateTime.toString();
+    if (_startISODateTime.timezone !== _endISODateTime.timezone) throw "Start and end dates in different time zones";
+    const formatter = ISODateTime.getFormatter(_startISODateTime, config);
+    const formatedRange = formatter.formatRange(_startDate, _endDate).replace(/\s/g, " ");
+    return formatedRange.replace(/\s/g, " ");
+  }
+  /**
+   * Returns formated date and time string
+   */
+  format(config) {
+    return ISODateTime.format(this, config);
+  }
+  /**
+   * Adds milliseconds to the date and returns it as a new ISODateTime object
+   */
+  addMillisecond(milliseconds) {
+    return new ISODateTime(this.valueOf() + milliseconds);
+  }
+  /**
+   * Adds seconds to the date and returns it as a new ISODateTime object
+   */
+  addSecond(seconds) {
+    return this.addMillisecond(seconds * 1e3);
+  }
+  /**
+   * Adds minutes to the date and returns it as a new ISODateTime object
+   */
+  addMinute(minutes) {
+    return this.addMillisecond(minutes * 6e4);
+  }
+  /**
+   * Adds hours to the date and returns it as a new ISODateTime object
+   */
+  addHour(hours) {
+    return this.addMillisecond(hours * 36e5);
+  }
+  /**
+   * Adds days to the date and returns it as a new ISODateTime object
+   */
+  addDay(days) {
+    return this.addMillisecond(days * 864e5);
+  }
+  /**
+   * Returns the start of the previous month as a new ISODateTime object
+   */
+  static getPrevMonthStart(date) {
+    if (date.parts) {
+      const month = date.parts.date.month ? Number(date.parts.date.month) : 1;
+      const prevMonth = month === 1 ? 12 : month - 1;
+      const year = month === 1 ? (Number(date.parts.date.year) - 1).toString() : date.parts.date.year;
+      const prevParts = {
+        date: {
+          year,
+          month: prevMonth.toString().padStart(2, "0"),
+          day: "01"
+        },
+        timezone: date.parts.timezone
+      };
+      return new ISODateTime(ISODateTime.getISOString(prevParts));
+    }
+    return date;
+  }
+  /**
+   * Returns the start of the previous month as a new ISODateTime object
+   */
+  getPrevMonthStart() {
+    return ISODateTime.getPrevMonthStart(this);
+  }
+  /**
+   * Returns the start of the next month as a new ISODateTime object
+   */
+  static getNextMonthStart(date) {
+    if (date.parts) {
+      const month = date.parts.date.month ? Number(date.parts.date.month) : 1;
+      const nextMonth = month % 12 + 1;
+      const year = month === 12 ? (Number(date.parts.date.year) + 1).toString() : date.parts.date.year;
+      const nextParts = {
+        date: {
+          year,
+          month: nextMonth.toString().padStart(2, "0"),
+          day: "01"
+        },
+        timezone: date.parts.timezone
+      };
+      return new ISODateTime(ISODateTime.getISOString(nextParts));
+    }
+    return date;
+  }
+  /**
+   * Returns the start of the next month as a new ISODateTime object
+   */
+  getNextMonthStart() {
+    return ISODateTime.getNextMonthStart(this);
+  }
+}
+exports.DefaultDateFormat = DefaultDateFormat;
+exports.DefaultTimeFormat = DefaultTimeFormat;
+exports.DefaultTimezone = DefaultTimezone;
+exports.ISODateTime = ISODateTime;
+exports.InvalidDate = InvalidDate;

package/dist/duration/add-durations.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./is-duration.cjs");
+const duration_toNumber = require("./to-number.cjs");
+function addDuration(left, right) {
+  const totalDurationInSeconds = duration_toNumber.toNumber(left, "second") + duration_toNumber.toNumber(right, "second");
+  const hours = Math.floor(totalDurationInSeconds / 3600).toString().padStart(2, "0");
+  const minutes = Math.floor(totalDurationInSeconds % 3600 / 60).toString().padStart(2, "0");
+  const seconds = (totalDurationInSeconds % 60).toString().padStart(2, "0");
+  return `${hours}:${minutes}:${seconds}`;
+}
+exports.addDuration = addDuration;

package/dist/duration/index.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const duration_isDuration = require("./is-duration.cjs");
+const duration_toNumber = require("./to-number.cjs");
+const duration_addDurations = require("./add-durations.cjs");
+exports.isDuration = duration_isDuration.isDuration;
+exports.toNumber = duration_toNumber.toNumber;
+exports.addDuration = duration_addDurations.addDuration;

package/dist/duration/is-duration.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const durationRegExp = /^\d{2}:\d{2}:\d{2}$/;
+function isDuration(duration) {
+  return durationRegExp.test(duration);
+}
+exports.isDuration = isDuration;

package/dist/duration/to-number.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const duration_isDuration = require("./is-duration.cjs");
+function toNumber(duration, unit = "hour") {
+  if (!duration_isDuration.isDuration(duration)) {
+    console.error(new Error(`Malformed duration value: ${duration}`));
+    return 0;
+  }
+  const parts = duration.split(":").map((p) => Number(p));
+  if (unit === "minute") return parts[0] * 60 + parts[1] + parts[2] / 60;
+  if (unit === "second") return parts[0] * 3600 + parts[1] * 60 + parts[2];
+  return parts[0] + parts[1] / 60 + parts[2] / 3600;
+}
+exports.toNumber = toNumber;

package/dist/format/formatter.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const dateFormatter = new Intl.DateTimeFormat("en", {
+  dateStyle: "full",
+  timeStyle: "short",
+  timeZone: "America/Vancouver"
+});
+const formatDate = (date) => {
+  if (date) return dateFormatter.format(date);
+  return "";
+};
+const listFormatter = new Intl.ListFormat("en", {
+  style: "long",
+  type: "conjunction"
+});
+const formatList = (list) => {
+  if (Array.isArray(list)) return listFormatter.format(list);
+  return "";
+};
+const numberFormatter = new Intl.NumberFormat("en", {
+  maximumFractionDigits: 2
+});
+const formatNumber = (num) => {
+  if (num) return numberFormatter.format(num);
+  return "";
+};
+const currencyFormatter = new Intl.NumberFormat("en", {
+  style: "currency",
+  currency: "CAD",
+  maximumFractionDigits: 2
+});
+const formatCurrency = (num) => {
+  if (num) return currencyFormatter.format(num);
+  return "";
+};
+exports.dateFormatter = dateFormatter;
+exports.formatCurrency = formatCurrency;
+exports.formatDate = formatDate;
+exports.formatList = formatList;
+exports.formatNumber = formatNumber;

package/dist/format/index.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const format_formatter = require("./formatter.cjs");
+const format_stringify = require("./stringify.cjs");
+const format_template = require("./template.cjs");
+exports.dateFormatter = format_formatter.dateFormatter;
+exports.formatCurrency = format_formatter.formatCurrency;
+exports.formatDate = format_formatter.formatDate;
+exports.formatList = format_formatter.formatList;
+exports.formatNumber = format_formatter.formatNumber;
+exports.stringify = format_stringify.stringify;
+exports.template = format_template.template;
+exports.templateObject = format_template.templateObject;

package/dist/format/stringify.cjs

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const format_formatter = require("./formatter.cjs");
+const date_isoDateTime = require("../date/iso-date-time.cjs");
+const stringify = (value, options) => {
+  const _options = {
+    invalidValueString: "\0",
+    // Unicode NUL
+    withTypeInfo: options?.verbose,
+    prettyObjects: options?.verbose,
+    ...options
+  };
+  if (value === void 0)
+    return _options.withTypeInfo ? "[undefined]" : _options.invalidValueString;
+  if (value === null)
+    return _options.withTypeInfo ? "[null]" : _options.invalidValueString;
+  if (typeof value === "string")
+    return `${_options.withTypeInfo ? "[string] " : ""}${value}`;
+  if (typeof value === "number")
+    return `${_options.withTypeInfo ? "[number] " : ""}${format_formatter.formatNumber(value)}`;
+  if (typeof value === "bigint")
+    return `${_options.withTypeInfo ? "[bigint] " : ""}${value}`;
+  if (typeof value === "boolean")
+    return `${_options.withTypeInfo ? "[boolean] " : ""}${value}`;
+  if (typeof value === "object") {
+    if (Array.isArray(value)) {
+      const stringfiedValue = value.map((el) => stringify(el, _options));
+      return `${_options.withTypeInfo ? "[array] " : ""}${_options.verbose ? stringfiedValue.join(", ") : format_formatter.formatList(stringfiedValue)}`;
+    }
+    if (value instanceof Date)
+      return `${_options.withTypeInfo ? "[date] " : ""}${format_formatter.dateFormatter.format(value)}`;
+    if (value instanceof date_isoDateTime.ISODateTime)
+      return `${_options.withTypeInfo ? "[date] " : ""}${value.format()}`;
+    return `${_options.withTypeInfo ? "[object] " : ""}${JSON.stringify(value, null, _options.prettyObjects ? 2 : void 0)}`;
+  }
+  if (typeof value === "function")
+    return `${_options.withTypeInfo ? "[function] " : ""}${_options.callFunctions && value.length === 0 ? stringify(value(), _options) : value.toString()}`;
+  if (typeof value === "symbol")
+    return `${_options.withTypeInfo ? "[symbol] " : ""}${value.toString()}`;
+  return _options.invalidValueString;
+};
+exports.stringify = stringify;

package/dist/format/template.cjs

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./formatter.cjs");
+const format_stringify = require("./stringify.cjs");
+const object_get = require("../object/get.cjs");
+const tagRegExp = new RegExp(/\${([a-zA-Z0-9_.]+)}/gm);
+const template = (text, templateVars) => {
+  return text.replace(tagRegExp, (match, key) => {
+    const templateVar = object_get.get(templateVars, key);
+    const value = typeof templateVar === "function" ? templateVar() : templateVar;
+    if (value === void 0) return match;
+    if (value === null) return "";
+    return format_stringify.stringify(value, { invalidValueString: "" });
+  });
+};
+const templateObject = (obj, templateVars) => {
+  const _objClone = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const _key = template(key, templateVars);
+    if (typeof value === "string") {
+      _objClone[_key] = template(value, templateVars);
+    } else if (value && typeof value === "object") {
+      if (Array.isArray(value))
+        _objClone[_key] = value.map(
+          (valueItem) => typeof valueItem === "string" ? template(valueItem, templateVars) : valueItem
+        );
+      else _objClone[_key] = templateObject(value, templateVars);
+    } else {
+      _objClone[_key] = value;
+    }
+  }
+  return _objClone;
+};
+exports.template = template;
+exports.templateObject = templateObject;

package/dist/object/get.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const get = (object, prop) => prop.split(".").reduce(
+  (reducedObject, key) => reducedObject && key in reducedObject ? reducedObject[key] : void 0,
+  object
+);
+exports.get = get;

package/dist/object/index.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const object_isObject = require("./is-object.cjs");
+const object_get = require("./get.cjs");
+const object_set = require("./set.cjs");
+const object_omit = require("./omit.cjs");
+const object_pick = require("./pick.cjs");
+exports.isObject = object_isObject.isObject;
+exports.get = object_get.get;
+exports.set = object_set.set;
+exports.omit = object_omit.omit;
+exports.pick = object_pick.pick;

package/dist/object/is-object.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const isObject = (object) => typeof object === "object" && !Array.isArray(object) && object !== null;
+exports.isObject = isObject;

package/dist/object/omit.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const omit = (object, props) => {
+  const result = { ...object };
+  props.forEach((prop) => {
+    const propChunks = prop.split(".");
+    const lastChunk = propChunks.pop();
+    if (lastChunk) {
+      const ref = propChunks.reduce(
+        (reducedObject, key) => reducedObject && key in reducedObject ? reducedObject[key] : void 0,
+        result
+      );
+      if (ref && lastChunk in ref) delete ref[lastChunk];
+    }
+  });
+  return result;
+};
+exports.omit = omit;

package/dist/object/pick.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const object_get = require("./get.cjs");
+const object_set = require("./set.cjs");
+const pick = (object, props) => {
+  return props.reduce((result, key) => {
+    object_set.set(result, key, object_get.get(object, key));
+    return result;
+  }, {});
+};
+exports.pick = pick;

package/dist/object/set.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const set = (object, prop, value) => {
+  const propChunks = prop.split(".");
+  const lastChunk = propChunks.pop();
+  if (!lastChunk) return object;
+  const ref = propChunks.reduce((reducedObject, key) => {
+    if (reducedObject[key] === void 0) reducedObject[key] = {};
+    return reducedObject[key];
+  }, object);
+  ref[lastChunk] = value;
+  return object;
+};
+exports.set = set;

package/dist/path/file-url-to-path.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const windowsDriveRegExp = /^\/[a-zA-Z1-9_-]+:\//;
+function fileURLToPath(fileUrl) {
+  const url = new URL(fileUrl);
+  let path = decodeURIComponent(url.pathname);
+  if (windowsDriveRegExp.test(path)) path = path.slice(1);
+  return path;
+}
+exports.fileURLToPath = fileURLToPath;

package/dist/path/file-url-to-path.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Browser compatible version of `node:url.fileURLToPath`
+ */
+export declare function fileURLToPath(fileUrl: string): string;

package/dist/path/file-url-to-path.js

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

package/dist/path/index.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const path_normalize = require("./normalize.cjs");
+const path_fileUrlToPath = require("./file-url-to-path.cjs");
+exports.normalize = path_normalize.normalize;
+exports.fileURLToPath = path_fileUrlToPath.fileURLToPath;

package/dist/path/index.d.ts

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

package/dist/path/index.js

@@ -0,0 +1,6 @@
+import { normalize } from "./normalize.js";
+import { fileURLToPath } from "./file-url-to-path.js";
+export {
+  fileURLToPath,
+  normalize
+};

package/dist/path/normalize.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const path_fileUrlToPath = require("./file-url-to-path.cjs");
+const defaultOptions = {
+  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;
+function normalize(path, options) {
+  const conf = { ...defaultOptions, ...options };
+  const sep = "\\";
+  let normalPath = path.trim();
+  if (fileProtocolRegExp.test(normalPath))
+    normalPath = path_fileUrlToPath.fileURLToPath(normalPath);
+  normalPath = normalPath.replace(windowsPathSepRegExp, sep).replace(unixPathSepRegExp, sep);
+  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;
+}
+exports.normalize = normalize;

package/dist/path/normalize.d.ts

@@ -0,0 +1,31 @@
+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";
+}
+/**
+ * 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 declare function normalize(path: string, options?: NormalizeOptions): string;