@h3ravel/support 0.12.0 → 0.13.0

package/dist/app.globals.d.ts

@@ -1,12 +1,12 @@
-import { Stringable } from './Helpers/Str'
+import { Stringable } from '..'
 
 export { }
 
 declare global {
     /**
-     * Dump something and kill the process for quick debugging. Based on Laravel's dd()
+     * Get a new Stringable object from the given string.
      * 
-     * @param args 
+     * @param string 
      */
     function str (string?: string): Stringable
 }

package/dist/index.cjs

@@ -37,22 +37,22 @@ let util = require("util");
 util = __toESM(util);
 let dayjs = require("dayjs");
 dayjs = __toESM(dayjs);
-let dayjs_plugin_advancedFormat = require("dayjs/plugin/advancedFormat");
-dayjs_plugin_advancedFormat = __toESM(dayjs_plugin_advancedFormat);
-let dayjs_plugin_customParseFormat = require("dayjs/plugin/customParseFormat");
-dayjs_plugin_customParseFormat = __toESM(dayjs_plugin_customParseFormat);
-let dayjs_plugin_dayOfYear = require("dayjs/plugin/dayOfYear");
-dayjs_plugin_dayOfYear = __toESM(dayjs_plugin_dayOfYear);
-let dayjs_plugin_isBetween = require("dayjs/plugin/isBetween");
-dayjs_plugin_isBetween = __toESM(dayjs_plugin_isBetween);
-let dayjs_plugin_isLeapYear = require("dayjs/plugin/isLeapYear");
-dayjs_plugin_isLeapYear = __toESM(dayjs_plugin_isLeapYear);
-let dayjs_plugin_relativeTime = require("dayjs/plugin/relativeTime");
-dayjs_plugin_relativeTime = __toESM(dayjs_plugin_relativeTime);
-let dayjs_plugin_timezone = require("dayjs/plugin/timezone");
-dayjs_plugin_timezone = __toESM(dayjs_plugin_timezone);
-let dayjs_plugin_utc = require("dayjs/plugin/utc");
-dayjs_plugin_utc = __toESM(dayjs_plugin_utc);
+let dayjs_plugin_advancedFormat_js = require("dayjs/plugin/advancedFormat.js");
+dayjs_plugin_advancedFormat_js = __toESM(dayjs_plugin_advancedFormat_js);
+let dayjs_plugin_customParseFormat_js = require("dayjs/plugin/customParseFormat.js");
+dayjs_plugin_customParseFormat_js = __toESM(dayjs_plugin_customParseFormat_js);
+let dayjs_plugin_dayOfYear_js = require("dayjs/plugin/dayOfYear.js");
+dayjs_plugin_dayOfYear_js = __toESM(dayjs_plugin_dayOfYear_js);
+let dayjs_plugin_isBetween_js = require("dayjs/plugin/isBetween.js");
+dayjs_plugin_isBetween_js = __toESM(dayjs_plugin_isBetween_js);
+let dayjs_plugin_isLeapYear_js = require("dayjs/plugin/isLeapYear.js");
+dayjs_plugin_isLeapYear_js = __toESM(dayjs_plugin_isLeapYear_js);
+let dayjs_plugin_relativeTime_js = require("dayjs/plugin/relativeTime.js");
+dayjs_plugin_relativeTime_js = __toESM(dayjs_plugin_relativeTime_js);
+let dayjs_plugin_timezone_js = require("dayjs/plugin/timezone.js");
+dayjs_plugin_timezone_js = __toESM(dayjs_plugin_timezone_js);
+let dayjs_plugin_utc_js = require("dayjs/plugin/utc.js");
+dayjs_plugin_utc_js = __toESM(dayjs_plugin_utc_js);
 
 //#region src/Helpers/Arr.ts
 var Arr_exports = /* @__PURE__ */ __export({
@@ -72,7 +72,8 @@ var Arr_exports = /* @__PURE__ */ __export({
 	range: () => range,
 	reverse: () => reverse,
 	shift: () => shift,
-	take: () => take
+	take: () => take,
+	wrap: () => wrap
 });
 /**
 * Splits an array into chunks of a specified size.
@@ -170,6 +171,16 @@ const flatten = (arr) => {
 	recurse(arr);
 	return result;
 };
+/**
+* If the given value is not an array and not null, wrap it in one.
+*
+* @param  {Array}  value
+* @return array
+*/
+const wrap = (value) => {
+	if (value === null) return [];
+	return Array.isArray(value) ? value : [value];
+};
 
 //#endregion
 //#region src/Helpers/Crypto.ts
@@ -709,6 +720,164 @@ const slugifyKeys = (obj, only = [], separator = "_") => {
 	return Object.fromEntries(entries.map(([key, value]) => [slugify(key), value]));
 };
 
+//#endregion
+//#region src/Helpers/Time.ts
+dayjs.default.extend(dayjs_plugin_utc_js.default);
+dayjs.default.extend(dayjs_plugin_timezone_js.default);
+dayjs.default.extend(dayjs_plugin_dayOfYear_js.default);
+dayjs.default.extend(dayjs_plugin_isBetween_js.default);
+dayjs.default.extend(dayjs_plugin_isLeapYear_js.default);
+dayjs.default.extend(dayjs_plugin_relativeTime_js.default);
+dayjs.default.extend(dayjs_plugin_advancedFormat_js.default);
+dayjs.default.extend(dayjs_plugin_customParseFormat_js.default);
+const phpToDayjsTokens = (format$1) => format$1.replace(/Y/g, "YYYY").replace(/m/g, "MM").replace(/d/g, "DD").replace(/H/g, "HH").replace(/i/g, "mm").replace(/s/g, "ss");
+function format(date, fmt) {
+	return (0, dayjs.default)(date).format(phpToDayjsTokens(fmt));
+}
+const TimeClass = class {};
+var DateTime = class DateTime extends TimeClass {
+	instance;
+	constructor(config) {
+		super(config);
+		this.instance = (0, dayjs.default)(config);
+		return new Proxy(this, { get: (target, prop, receiver) => {
+			if (prop in target) return Reflect.get(target, prop, receiver);
+			const value = Reflect.get(this.instance, prop, receiver);
+			if (typeof value === "function") return (...args) => {
+				const result = value.apply(this.instance, args);
+				return dayjs.default.isDayjs(result) ? new DateTime(result) : result;
+			};
+			return value;
+		} });
+	}
+	/**
+	* Start time of a specific unit.
+	* 
+	* @returns 
+	*/
+	start(unit = "days") {
+		return this.startOf(unit);
+	}
+	/**
+	* End time of a specific unit.
+	* 
+	* @returns 
+	*/
+	end(unit = "days") {
+		return this.endOf(unit);
+	}
+	/**
+	* Get the first day of the month of the given date
+	* 
+	* @returns 
+	*/
+	firstDayOfMonth() {
+		return new DateTime(new Date(Date.UTC(this.year(), this.month(), 1)));
+	}
+	carbonFormat(template) {
+		return template ? this.format(phpToDayjsTokens(template)) : this.format();
+	}
+	/**
+	* Get the last day of the month of the given date
+	* 
+	* @returns 
+	*/
+	lastDayOfMonth() {
+		return new DateTime(new Date(Date.UTC(this.year(), this.month() + 1, 0)));
+	}
+	/**
+	* Get a random time between the specified hour and minute.
+	* 
+	* @param startHour 
+	* @param startMinute 
+	* @param endHour 
+	* @param endMinute 
+	* @returns 
+	*/
+	randomTime(startHour = 9, startMinute = 0, endHour = 17, endMinute = 0) {
+		const today = /* @__PURE__ */ new Date();
+		const startMinutes = startHour * 60 + startMinute;
+		const endMinutes = endHour * 60 + endMinute;
+		const randomMinutes = Math.floor(Math.random() * (endMinutes - startMinutes)) + startMinutes;
+		const hour = Math.floor(randomMinutes / 60);
+		const minute = randomMinutes % 60;
+		const date = new Date(today);
+		date.setHours(hour, minute, 0, 0);
+		return new DateTime(date);
+	}
+	/**
+	* Create a date for a given timestamp.
+	*
+	* @param timestamp - Unix timestamp
+	* 
+	* @return {Date} object
+	*/
+	static fromTimestamp(timestamp) {
+		return /* @__PURE__ */ new Date(timestamp * 1e3);
+	}
+	/**
+	* Get current time instance.
+	*
+	* @returns Current time
+	*/
+	static now() {
+		return new DateTime();
+	}
+	/**
+	* Parse the time
+	* 
+	* @param date 
+	* @returns 
+	*/
+	static parse(date) {
+		return new DateTime(date);
+	}
+	/**
+	* Get the formatted date according to the string of tokens passed in.
+	* 
+	* To escape characters, wrap them in square brackets (e.g. [MM]).
+	*
+	* @param time - current time
+	* @param template - time format
+	*/
+	static format(time, template) {
+		return new DateTime(time).format(template);
+	}
+	/**
+	* Get the difference in days from today.
+	*
+	* @param time 
+	* @param startHour 
+	* @param startMinute 
+	* @param endHour 
+	* @param endMinute 
+	* @returns 
+	*/
+	static randomTime(time, startHour, startMinute, endHour, endMinute) {
+		return new DateTime(time).randomTime(startHour, startMinute, endHour, endMinute);
+	}
+	/**
+	* Get the first day of the month of the given date
+	* 
+	* @param time 
+	* 
+	* @returns 
+	*/
+	static firstDayOfMonth(time) {
+		return new DateTime(time).firstDayOfMonth();
+	}
+	/**
+	* Get the last day of the month of the given date
+	* 
+	* @param time 
+	* 
+	* @returns 
+	*/
+	static lastDayOfMonth(time) {
+		return new DateTime(time).lastDayOfMonth();
+	}
+};
+
 //#endregion
 //#region src/Helpers/Str.ts
 let Mode = /* @__PURE__ */ function(Mode$1) {
@@ -5048,164 +5217,6 @@ function matchCase(value, comparison) {
 	return value;
 }
 
-//#endregion
-//#region src/Helpers/Time.ts
-dayjs.default.extend(dayjs_plugin_utc.default);
-dayjs.default.extend(dayjs_plugin_timezone.default);
-dayjs.default.extend(dayjs_plugin_dayOfYear.default);
-dayjs.default.extend(dayjs_plugin_isBetween.default);
-dayjs.default.extend(dayjs_plugin_isLeapYear.default);
-dayjs.default.extend(dayjs_plugin_relativeTime.default);
-dayjs.default.extend(dayjs_plugin_advancedFormat.default);
-dayjs.default.extend(dayjs_plugin_customParseFormat.default);
-const phpToDayjsTokens = (format$1) => format$1.replace(/Y/g, "YYYY").replace(/m/g, "MM").replace(/d/g, "DD").replace(/H/g, "HH").replace(/i/g, "mm").replace(/s/g, "ss");
-function format(date, fmt) {
-	return (0, dayjs.default)(date).format(phpToDayjsTokens(fmt));
-}
-const TimeClass = class {};
-var Time = class Time extends TimeClass {
-	instance;
-	constructor(config) {
-		super(config);
-		this.instance = (0, dayjs.default)(config);
-		return new Proxy(this, { get: (target, prop, receiver) => {
-			if (prop in target) return Reflect.get(target, prop, receiver);
-			const value = Reflect.get(this.instance, prop, receiver);
-			if (typeof value === "function") return (...args) => {
-				const result = value.apply(this.instance, args);
-				return dayjs.default.isDayjs(result) ? new Time(result) : result;
-			};
-			return value;
-		} });
-	}
-	/**
-	* Start time of a specific unit.
-	* 
-	* @returns 
-	*/
-	start(unit = "days") {
-		return this.startOf(unit);
-	}
-	/**
-	* End time of a specific unit.
-	* 
-	* @returns 
-	*/
-	end(unit = "days") {
-		return this.endOf(unit);
-	}
-	/**
-	* Get the first day of the month of the given date
-	* 
-	* @returns 
-	*/
-	firstDayOfMonth() {
-		return new Time(new Date(Date.UTC(this.year(), this.month(), 1)));
-	}
-	carbonFormat(template) {
-		return template ? this.format(phpToDayjsTokens(template)) : this.format();
-	}
-	/**
-	* Get the last day of the month of the given date
-	* 
-	* @returns 
-	*/
-	lastDayOfMonth() {
-		return new Time(new Date(Date.UTC(this.year(), this.month() + 1, 0)));
-	}
-	/**
-	* Get a random time between the specified hour and minute.
-	* 
-	* @param startHour 
-	* @param startMinute 
-	* @param endHour 
-	* @param endMinute 
-	* @returns 
-	*/
-	randomTime(startHour = 9, startMinute = 0, endHour = 17, endMinute = 0) {
-		const today = /* @__PURE__ */ new Date();
-		const startMinutes = startHour * 60 + startMinute;
-		const endMinutes = endHour * 60 + endMinute;
-		const randomMinutes = Math.floor(Math.random() * (endMinutes - startMinutes)) + startMinutes;
-		const hour = Math.floor(randomMinutes / 60);
-		const minute = randomMinutes % 60;
-		const date = new Date(today);
-		date.setHours(hour, minute, 0, 0);
-		return new Time(date);
-	}
-	/**
-	* Create a date for a given timestamp.
-	*
-	* @param timestamp - Unix timestamp
-	* 
-	* @return {Date} object
-	*/
-	static fromTimestamp(timestamp) {
-		return /* @__PURE__ */ new Date(timestamp * 1e3);
-	}
-	/**
-	* Get current time instance.
-	*
-	* @returns Current time
-	*/
-	static now() {
-		return new Time();
-	}
-	/**
-	* Parse the time
-	* 
-	* @param date 
-	* @returns 
-	*/
-	static parse(date) {
-		return new Time(date);
-	}
-	/**
-	* Get the formatted date according to the string of tokens passed in.
-	* 
-	* To escape characters, wrap them in square brackets (e.g. [MM]).
-	*
-	* @param time - current time
-	* @param template - time format
-	*/
-	static format(time, template) {
-		return new Time(time).format(template);
-	}
-	/**
-	* Get the difference in days from today.
-	*
-	* @param time 
-	* @param startHour 
-	* @param startMinute 
-	* @param endHour 
-	* @param endMinute 
-	* @returns 
-	*/
-	static randomTime(time, startHour, startMinute, endHour, endMinute) {
-		return new Time(time).randomTime(startHour, startMinute, endHour, endMinute);
-	}
-	/**
-	* Get the first day of the month of the given date
-	* 
-	* @param time 
-	* 
-	* @returns 
-	*/
-	static firstDayOfMonth(time) {
-		return new Time(time).firstDayOfMonth();
-	}
-	/**
-	* Get the last day of the month of the given date
-	* 
-	* @param time 
-	* 
-	* @returns 
-	*/
-	static lastDayOfMonth(time) {
-		return new Time(time).lastDayOfMonth();
-	}
-};
-
 //#endregion
 //#region src/GlobalBootstrap.ts
 /**
@@ -5237,7 +5248,7 @@ function loadHelpers(target = globalThis) {
 		Number: Number_exports,
 		Obj: Obj_exports,
 		Str,
-		Time,
+		DateTime,
 		DumpDie: DumpDie_exports,
 		apa: Str.apa,
 		title: Str.title,
@@ -5283,13 +5294,13 @@ function loadHelpers(target = globalThis) {
 		checksum,
 		verifyChecksum,
 		caesarCipher,
-		now: Time.now,
-		format: Time.format,
-		fromTimestamp: Time.fromTimestamp,
-		parse: Time.parse,
-		randomTime: Time.randomTime,
-		firstDayOfMonth: Time.firstDayOfMonth,
-		lastDayOfMonth: Time.lastDayOfMonth,
+		now: DateTime.now,
+		format: DateTime.format,
+		fromTimestamp: DateTime.fromTimestamp,
+		parse: DateTime.parse,
+		randomTime: DateTime.randomTime,
+		firstDayOfMonth: DateTime.firstDayOfMonth,
+		lastDayOfMonth: DateTime.lastDayOfMonth,
 		abbreviate,
 		humanize,
 		toBytes,
@@ -5399,6 +5410,7 @@ Object.defineProperty(exports, 'Crypto', {
     return Crypto_exports;
   }
 });
+exports.DateTime = DateTime;
 Object.defineProperty(exports, 'DumpDie', {
   enumerable: true,
   get: function () {
@@ -5421,7 +5433,6 @@ Object.defineProperty(exports, 'Obj', {
 });
 exports.Str = Str;
 exports.Stringable = Stringable;
-exports.Time = Time;
 exports.abbreviate = abbreviate;
 exports.alternate = alternate;
 exports.base64Decode = base64Decode;
@@ -5469,5 +5480,6 @@ exports.toBytes = toBytes;
 exports.toHumanTime = toHumanTime;
 exports.uuid = uuid;
 exports.verifyChecksum = verifyChecksum;
+exports.wrap = wrap;
 exports.xor = xor;
 //# sourceMappingURL=index.cjs.map