@bytebury/toolkit 1.0.0

package/script/src/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/src/core.ts"],"names":[],"mappings":"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"}

package/script/src/core.js

@@ -0,0 +1,279 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clone = clone;
+exports.isEqual = isEqual;
+exports.first = first;
+exports.last = last;
+exports.isNotEqual = isNotEqual;
+exports.isEqualIgnoreCase = isEqualIgnoreCase;
+exports.isNotEqualIgnoreCase = isNotEqualIgnoreCase;
+exports.stringify = stringify;
+exports.reverse = reverse;
+exports.isEmpty = isEmpty;
+exports.isNotEmpty = isNotEmpty;
+exports.unique = unique;
+exports.distinct = distinct;
+exports.sample = sample;
+exports.rand = rand;
+exports.truthy = truthy;
+exports.falsy = falsy;
+exports.isSome = isSome;
+exports.isNone = isNone;
+exports.sum = sum;
+exports.average = average;
+const strings_js_1 = require("./strings.js");
+/**
+ * Clone an object using structuredClone.
+ */
+function clone(obj) {
+    return structuredClone(obj);
+}
+/**
+ * Compares two things by turning them into strings,
+ * and comparing them by their string value.
+ *
+ * @example
+ * ```ts
+ * isEqual("1", 1); // true
+ * isEqual({foo: "bar"}, {foo: "bar"}); // true
+ * isEqual([], []); // true
+ * isEqual([0], [1]); // false
+ * isEqual(false, " false "); // false
+ * isEqual(false, "FALSE"); // false
+ * ````
+ */
+function isEqual(thing1, thing2) {
+    return stringify(thing1) === stringify(thing2);
+}
+function first(value) {
+    return value[0];
+}
+function last(value) {
+    return value[value.length - 1];
+}
+/**
+ * Compares two things by turning them into strings,
+ * and comparing them by their string value.
+ *
+ * @remarks this is the inverse of `isEqual`.
+ *
+ * @example
+ * ```ts
+ * isNotEqual("1", 1); // true
+ * isNotEqual({foo: "bar"}, {foo: "bar"}); // true
+ * isNotEqual([], []); // true
+ * isNotEqual([0], [1]); // false
+ * isNotEqual(false, " false "); // true
+ * isNotEqual(false, "FALSE"); // false
+ * ```
+ */
+function isNotEqual(thing1, thing2) {
+    return !isEqual(thing1, thing2);
+}
+/**
+ * Compares two things by turning them into strings and lowercasing
+ * them, and comparing the string values. Works exactly like `isEqual` except
+ * will lowercase both things before comparing.
+ *
+ * @example
+ * ```ts
+ * isEqualIgnoreCase("1", 1); // true
+ * isEqualIgnoreCase({foo: "bar"}, {foo: "bar"}); // true
+ * isEqualIgnoreCase([], []); // true
+ * isEqualIgnoreCase([0], [1]); // false
+ * isEqualIgnoreCase(false, " false "); // false
+ * isEqualIgnoreCase(false, "FALSE"); // true
+ * ```
+ */
+function isEqualIgnoreCase(thing1, thing2) {
+    thing1 = (0, strings_js_1.lower)(stringify(thing1));
+    thing2 = (0, strings_js_1.lower)(stringify(thing2));
+    return thing1 === thing2;
+}
+/**
+ * Compares two things by turning them into strings, trimming and lowercasing
+ * them, and comparing the string values. Works exactly like `isEqual` except
+ * will lowercase both things before comparing.
+ *
+ * @example
+ * ```ts
+ * isNotEqualIgnoreCase("1", 1); // false
+ * isNotEqualIgnoreCase({foo: "bar"}, {foo: "bar"}); // false
+ * isNotEqualIgnoreCase([], []); // false
+ * isNotEqualIgnoreCase([0], [1]); // true
+ * isNotEqualIgnoreCase(false, " false "); // true
+ * isNotEqualIgnoreCase(false, "FALSE"); // false
+ * ```
+ */
+function isNotEqualIgnoreCase(thing1, thing2) {
+    return !isEqualIgnoreCase(thing1, thing2);
+}
+/**
+ * Converts the given parameter into the string equivalent.
+ *
+ * If the thing provided has the type of "object", then this function
+ * returns `JSON.stringify(thing)`. Otherwise, it will wrap the `thing`
+ * in a String and convert it to it's string representation.
+ *
+ * @example
+ * ```ts
+ * stringify({ foo: "bar" }); // "{ "foo": "bar" }"
+ * stringify([1, 2, 3]); // "[1, 2, 3]"
+ * stringify(1); // "1"
+ * ```
+ */
+function stringify(thing) {
+    return typeof thing === "object" ? JSON.stringify(thing) : String(thing);
+}
+function reverse(thing) {
+    if (typeof thing === "string")
+        return thing.split("").reverse().join("");
+    if (thing instanceof Set)
+        return new Set([...thing].reverse());
+    return thing.reverse();
+}
+function isEmpty(thing) {
+    if (isNone(thing))
+        return true;
+    if (typeof thing === "string")
+        return (0, strings_js_1.isWhitespace)(thing);
+    if (Array.isArray(thing))
+        return thing.length === 0;
+    if (thing instanceof Map || thing instanceof Set)
+        return thing.size === 0;
+    if (typeof thing === "object")
+        return Object.keys(thing).length === 0;
+    return false;
+}
+function isNotEmpty(thing) {
+    return !isEmpty(thing);
+}
+/**
+ * Returns the distinct values from a list.
+ *
+ * @remarks same as `distinct`.
+ *
+ * @example
+ * ```ts
+ * const myList = [1, 2, 3, 3];
+ * unique(myList); // [1, 2, 3];
+ * ```
+ */
+function unique(list) {
+    return [...new Set(list)];
+}
+/**
+ * Returns the distinct values from a list.
+ *
+ * @remarks alias for `unique`.
+ *
+ * @example
+ * ```ts
+ * const myList = [1, 2, 3, 3];
+ * distinct(myList); // [1, 2, 3];
+ * ```
+ */
+function distinct(list) {
+    return unique(list);
+}
+/**
+ * Pick a random item from an array.
+ *
+ * @remarks
+ * If you pass an empty list, then this function will return `undefined`.
+ *
+ * @example
+ * ```ts
+ * const myList = [1, 2, 3, 4];
+ * const randomItem = sample(myList);
+ *
+ * console.log(randomItem); // could be 1, 2, 3, or 4
+ * console.log(sample([])); // undefined
+ * ```
+ */
+function sample(list) {
+    return list[Math.floor(Math.random() * list.length)];
+}
+/**
+ * Gives a random number in the given range. The first parameter is inclusive
+ * and the second one is exclusive. Therefore, it will work with lists out of
+ * the box.
+ *
+ * @example
+ * ```ts
+ * rand(0, 10); // 0 -> 9
+ * rand(3, 7); // 3 -> 6
+ * ```
+ */
+function rand(start, end) {
+    return Math.floor(Math.random() * (end - start)) + start;
+}
+/**
+ * Determines if the given value is truthy.
+ *
+ * @example
+ * ```ts
+ * truthy(true); // true
+ * truthy(false); // false
+ * truthy(''); // false
+ * ```
+ */
+function truthy(thing) {
+    return Boolean(thing) === true;
+}
+/**
+ * Determines if the given value is falsy.
+ *
+ * @example
+ * ```ts
+ * falsy(true); // false
+ * falsy(false); // true
+ * falsy(''); // true
+ * ```
+ */
+function falsy(thing) {
+    return !truthy(thing);
+}
+/**
+ * Returns true if the given value is not null or undefined.
+ *
+ * @example
+ * ```ts
+ * isSome(null); // false
+ * isSome(undefined); // false
+ * isSome(0); // true
+ * isSome({}); // true
+ * ```
+ */
+function isSome(thing) {
+    return !isNone(thing);
+}
+/**
+ * Returns true if the given value is null or undefined.
+ *
+ * @example
+ * ```ts
+ * isNone(null); // true
+ * isNone(undefined); // true
+ * isNone(true); // false
+ * isNone(0); // false
+ * ```
+ */
+function isNone(thing) {
+    return thing === null || thing === undefined;
+}
+// deno-lint-ignore no-explicit-any
+function sum(list, key) {
+    if (list.length === 0)
+        return 0;
+    if (typeof list[0] === "number") {
+        return list.reduce((a, v) => a + v, 0);
+    }
+    return list.reduce(
+    // deno-lint-ignore no-explicit-any
+    (a, v) => a + v[key], 0);
+}
+// deno-lint-ignore no-explicit-any
+function average(list, key) {
+    return (sum(list, key) / list.length) || 0;
+}

package/script/src/core_test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core_test.d.ts","sourceRoot":"","sources":["../../src/src/core_test.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

package/script/src/dates.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Right now. This is an alias for `new Date()`.
+ */
+export declare function now(): Date;
+/**
+ * Today's date at midnight.
+ */
+export declare function today(): Date;
+/**
+ * Tomorrow's date at midnight.
+ */
+export declare function tomorrow(): Date;
+/**
+ * Yesterday's date at midnight.
+ */
+export declare function yesterday(): Date;
+/**
+ * Adds the given amount of days to the specified date.
+ */
+export declare function addDays(date: Date, days: number): Date;
+/**
+ * Subtracts the given amount of days from the specified date.
+ */
+export declare function subtractDays(date: Date, days: number): Date;
+/**
+ * Adds the given amount of months to the specified date.
+ */
+export declare function addMonths(date: Date, months: number): Date;
+/**
+ * Subtracts the given amount of months from the specified date.
+ */
+export declare function subtractMonths(date: Date, months: number): Date;
+/**
+ * Adds the given amount of years to the specified date.
+ */
+export declare function addYears(date: Date, years: number): Date;
+/**
+ * Subtracts the given amount of yers from the specified date.
+ */
+export declare function subtractYears(date: Date, years: number): Date;
+/**
+ * Calculates the days between two dates.
+ */
+export declare function daysBetween(start: Date, end: Date): number;
+/**
+ * Calculates the months between two dates.
+ */
+export declare function monthsBetween(start: Date, end: Date): number;
+/**
+ * Calculates the years between two dates.
+ * The date must be equal or past for it to count as a full year.
+ *
+ * @example
+ * ```ts
+ * yearsBetween(new Date('2007-08-01', '2008-07-31')); // 0
+ * yearsBetween(new Date('2007-08-01', '2008-08-01')); // 1
+ * ```
+ */
+export declare function yearsBetween(start: Date, end: Date): number;
+/**
+ * Checks if a date is a Sunday.
+ */
+export declare function isSunday(date: Date): boolean;
+/**
+ * Checks if a date is a Monday.
+ */
+export declare function isMonday(date: Date): boolean;
+/**
+ * Checks if a date is a Tuesday.
+ */
+export declare function isTuesday(date: Date): boolean;
+/**
+ * Checks if a date is a Wednesday.
+ */
+export declare function isWednesday(date: Date): boolean;
+/**
+ * Checks if a date is a Thursday.
+ */
+export declare function isThursday(date: Date): boolean;
+/**
+ * Checks if a date is a Friday.
+ */
+export declare function isFriday(date: Date): boolean;
+/**
+ * Checks if a date is a Saturday.
+ */
+export declare function isSaturday(date: Date): boolean;
+/**
+ * Checks if a date is a weekend.
+ */
+export declare function isWeekend(date: Date): boolean;
+/**
+ * Checks if a date is a weekday.
+ */
+export declare function isWeekday(date: Date): boolean;
+/**
+ * Determines if the date is in the past.
+ */
+export declare function isInPast(date: Date): boolean;
+/**
+ * Determines if the date is in the future.
+ *
+ * @remarks
+ * this is date specific. So, if it is 1:00 PM and you pass
+ * a date that is today at 2:00 PM, it will return false, because
+ * the "date" is the same.
+ */
+export declare function isInFuture(date: Date): boolean;
+/**
+ * Determines if the date is today.
+ */
+export declare function isToday(date: Date): boolean;
+//# sourceMappingURL=dates.d.ts.map

package/script/src/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/src/dates.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,GAAG,IAAI,IAAI,CAE1B;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAI5B;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAI/B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAW1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAO1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAM5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAkB3D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE5C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE3C"}

package/script/src/dates.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.now = now;
+exports.today = today;
+exports.tomorrow = tomorrow;
+exports.yesterday = yesterday;
+exports.addDays = addDays;
+exports.subtractDays = subtractDays;
+exports.addMonths = addMonths;
+exports.subtractMonths = subtractMonths;
+exports.addYears = addYears;
+exports.subtractYears = subtractYears;
+exports.daysBetween = daysBetween;
+exports.monthsBetween = monthsBetween;
+exports.yearsBetween = yearsBetween;
+exports.isSunday = isSunday;
+exports.isMonday = isMonday;
+exports.isTuesday = isTuesday;
+exports.isWednesday = isWednesday;
+exports.isThursday = isThursday;
+exports.isFriday = isFriday;
+exports.isSaturday = isSaturday;
+exports.isWeekend = isWeekend;
+exports.isWeekday = isWeekday;
+exports.isInPast = isInPast;
+exports.isInFuture = isInFuture;
+exports.isToday = isToday;
+const duration_js_1 = require("./duration.js");
+/**
+ * Right now. This is an alias for `new Date()`.
+ */
+function now() {
+    return new Date();
+}
+/**
+ * Today's date at midnight.
+ */
+function today() {
+    const d = new Date(now());
+    d.setHours(0, 0, 0, 0);
+    return d;
+}
+/**
+ * Tomorrow's date at midnight.
+ */
+function tomorrow() {
+    const d = new Date(now());
+    d.setHours(0, 0, 0, 0);
+    return addDays(d, 1);
+}
+/**
+ * Yesterday's date at midnight.
+ */
+function yesterday() {
+    return subtractDays(today(), 1);
+}
+/**
+ * Adds the given amount of days to the specified date.
+ */
+function addDays(date, days) {
+    const result = new Date(date);
+    result.setDate(result.getDate() + days);
+    return result;
+}
+/**
+ * Subtracts the given amount of days from the specified date.
+ */
+function subtractDays(date, days) {
+    return addDays(new Date(date), -days);
+}
+/**
+ * Adds the given amount of months to the specified date.
+ */
+function addMonths(date, months) {
+    const result = new Date(date);
+    const targetMonth = result.getMonth() + months;
+    result.setMonth(targetMonth);
+    // Fix for month overflow (e.g., Jan 31 → Feb)
+    while (result.getMonth() !== ((targetMonth % 12 + 12) % 12)) {
+        result.setDate(result.getDate() - 1);
+    }
+    return result;
+}
+/**
+ * Subtracts the given amount of months from the specified date.
+ */
+function subtractMonths(date, months) {
+    return addMonths(new Date(date), -months);
+}
+/**
+ * Adds the given amount of years to the specified date.
+ */
+function addYears(date, years) {
+    return addMonths(new Date(date), years * 12);
+}
+/**
+ * Subtracts the given amount of yers from the specified date.
+ */
+function subtractYears(date, years) {
+    return addYears(new Date(date), -years);
+}
+/**
+ * Calculates the days between two dates.
+ */
+function daysBetween(start, end) {
+    return Math.abs(Math.floor((new Date(end).getTime() - new Date(start).getTime()) /
+        duration_js_1.Duration.days(1).toMilliseconds()));
+}
+/**
+ * Calculates the months between two dates.
+ */
+function monthsBetween(start, end) {
+    const startDate = new Date(start);
+    const endDate = new Date(end);
+    const years = endDate.getFullYear() - startDate.getFullYear();
+    const months = endDate.getMonth() - startDate.getMonth();
+    return Math.abs(years * 12 + months);
+}
+/**
+ * Calculates the years between two dates.
+ * The date must be equal or past for it to count as a full year.
+ *
+ * @example
+ * ```ts
+ * yearsBetween(new Date('2007-08-01', '2008-07-31')); // 0
+ * yearsBetween(new Date('2007-08-01', '2008-08-01')); // 1
+ * ```
+ */
+function yearsBetween(start, end) {
+    const startDate = new Date(start);
+    const endDate = new Date(end);
+    const years = endDate.getFullYear() - startDate.getFullYear();
+    if (years === 0) {
+        return 0;
+    }
+    // Check if the end date is before the start date
+    const hasDayPassed = endDate.getMonth() > startDate.getMonth() ||
+        (endDate.getMonth() === startDate.getMonth() &&
+            endDate.getDate() >= startDate.getDate());
+    if (!hasDayPassed) {
+        if (years < 0) {
+            return Math.abs(years);
+        }
+        return Math.abs(years - 1);
+    }
+    return Math.abs(years);
+}
+/**
+ * Checks if a date is a Sunday.
+ */
+function isSunday(date) {
+    return new Date(date).getDay() === 0;
+}
+/**
+ * Checks if a date is a Monday.
+ */
+function isMonday(date) {
+    return new Date(date).getDay() === 1;
+}
+/**
+ * Checks if a date is a Tuesday.
+ */
+function isTuesday(date) {
+    return new Date(date).getDay() === 2;
+}
+/**
+ * Checks if a date is a Wednesday.
+ */
+function isWednesday(date) {
+    return new Date(date).getDay() === 3;
+}
+/**
+ * Checks if a date is a Thursday.
+ */
+function isThursday(date) {
+    return new Date(date).getDay() === 4;
+}
+/**
+ * Checks if a date is a Friday.
+ */
+function isFriday(date) {
+    return new Date(date).getDay() === 5;
+}
+/**
+ * Checks if a date is a Saturday.
+ */
+function isSaturday(date) {
+    return new Date(date).getDay() === 6;
+}
+/**
+ * Checks if a date is a weekend.
+ */
+function isWeekend(date) {
+    return isSaturday(date) || isSunday(date);
+}
+/**
+ * Checks if a date is a weekday.
+ */
+function isWeekday(date) {
+    return !isWeekend(date);
+}
+/**
+ * Determines if the date is in the past.
+ */
+function isInPast(date) {
+    return date < today();
+}
+/**
+ * Determines if the date is in the future.
+ *
+ * @remarks
+ * this is date specific. So, if it is 1:00 PM and you pass
+ * a date that is today at 2:00 PM, it will return false, because
+ * the "date" is the same.
+ */
+function isInFuture(date) {
+    return date >= tomorrow();
+}
+/**
+ * Determines if the date is today.
+ */
+function isToday(date) {
+    return !isInFuture(date) && !isInPast(date);
+}

package/script/src/dates_test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates_test.d.ts","sourceRoot":"","sources":["../../src/src/dates_test.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}