@alextheman/utility 2.16.1 → 2.18.0

package/dist/index.cjs

@@ -51,11 +51,13 @@ __export(index_exports, {
   camelToKebab: () => camelToKebab_default,
   convertFileToBase64: () => convertFileToBase64_default,
   createFormData: () => createFormData_default,
+  createTemplateStringsArray: () => createTemplateStringsArray_default,
   fillArray: () => fillArray_default,
   formatDateAndTime: () => formatDateAndTime_default,
   getRandomNumber: () => getRandomNumber_default,
   getRecordKeys: () => getRecordKeys_default,
   httpErrorCodeLookup: () => httpErrorCodeLookup,
+  interpolate: () => interpolate_default,
   interpolateObjects: () => interpolateObjects_default,
   isLeapYear: () => isLeapYear_default,
   isMonthlyMultiple: () => isMonthlyMultiple_default,
@@ -73,6 +75,7 @@ __export(index_exports, {
   removeDuplicates: () => removeDuplicates_default,
   stringListToArray: () => stringListToArray_default,
   stringToBoolean: () => stringToBoolean_default,
+  stripIndents: () => stripIndents_default,
   truncate: () => truncate_default,
   wait: () => wait_default
 });
@@ -211,6 +214,12 @@ function createFormData(data, options = {
 }
 var createFormData_default = createFormData;
 
+// src/functions/createTemplateStringsArray.ts
+function createTemplateStringsArray(strings) {
+  return Object.assign([...strings], { raw: [...strings] });
+}
+var createTemplateStringsArray_default = createTemplateStringsArray;
+
 // src/functions/fillArray.ts
 function fillArray(callback, length = 1) {
   const outputArray = new Array(length).fill(null).map((_, index) => {
@@ -487,6 +496,16 @@ function wait(seconds) {
 }
 var wait_default = wait;
 
+// src/functions/taggedTemplate/interpolate.ts
+function interpolate(strings, ...interpolations) {
+  let result = "";
+  for (const [string, interpolation = ""] of paralleliseArrays_default(strings, interpolations)) {
+    result += string + interpolation;
+  }
+  return result;
+}
+var interpolate_default = interpolate;
+
 // src/functions/taggedTemplate/interpolateObjects.ts
 function interpolateObjects(strings, ...values) {
   let result = "";
@@ -500,6 +519,31 @@ function interpolateObjects(strings, ...values) {
 }
 var interpolateObjects_default = interpolateObjects;
 
+// src/functions/taggedTemplate/stripIndents.ts
+function calculateTabSize(line) {
+  const defaultWhitespaceLength = 12;
+  const potentialWhitespacePart = line.slice(0, defaultWhitespaceLength);
+  const trimmedString = line.trim();
+  if (potentialWhitespacePart.trim() !== "") {
+    return 0;
+  }
+  const tabSize = line.length - (trimmedString.length + defaultWhitespaceLength);
+  return tabSize < 0 ? 0 : tabSize;
+}
+function reduceLines(lines) {
+  return lines.map((line) => {
+    const tabSize = calculateTabSize(line);
+    return fillArray_default(() => {
+      return " ";
+    }, tabSize).join("") + line.trim();
+  }).join("\n");
+}
+function stripIndents(strings, ...interpolations) {
+  const fullString = interpolate_default(strings, ...interpolations);
+  return reduceLines(fullString.split("\n"));
+}
+var stripIndents_default = stripIndents;
+
 // src/types/APIError.ts
 var httpErrorCodeLookup = {
   400: "BAD_REQUEST",
@@ -563,11 +607,13 @@ var UUID_default = parseUUID;
   camelToKebab,
   convertFileToBase64,
   createFormData,
+  createTemplateStringsArray,
   fillArray,
   formatDateAndTime,
   getRandomNumber,
   getRecordKeys,
   httpErrorCodeLookup,
+  interpolate,
   interpolateObjects,
   isLeapYear,
   isMonthlyMultiple,
@@ -585,6 +631,7 @@ var UUID_default = parseUUID;
   removeDuplicates,
   stringListToArray,
   stringToBoolean,
+  stripIndents,
   truncate,
   wait
 });

package/dist/index.d.cts

@@ -62,6 +62,8 @@ interface CreateFormDataOptionsNullableResolution<K extends RecordKey> extends C
 type CreateFormDataOptions<K extends RecordKey> = CreateFormDataOptionsUndefinedOrNullResolution<K> | CreateFormDataOptionsNullableResolution<K>;
 declare function createFormData<T extends Record<RecordKey, unknown>>(data: T, options?: CreateFormDataOptions<keyof T>): FormData;
 
+declare function createTemplateStringsArray(strings: readonly string[]): TemplateStringsArray;
+
 declare function fillArray<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
 declare function fillArray<T>(callback: (index: number) => T, length?: number): T[];
 
@@ -109,6 +111,10 @@ declare function truncate(stringToTruncate: string, maxLength?: number): string;
 
 declare function wait(seconds: number): Promise<void>;
 
+declare function interpolate(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
+
 declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
 
-export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataNullableResolutionStrategy as FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type IgnoreCase, type KebabToCamelOptions, type NonUndefined, type OptionalOnCondition, type RecordKey, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, omitProperties, paralleliseArrays, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };
+declare function stripIndents(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
+
+export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataNullableResolutionStrategy as FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type IgnoreCase, type KebabToCamelOptions, type NonUndefined, type OptionalOnCondition, type RecordKey, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, httpErrorCodeLookup, interpolate, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, omitProperties, paralleliseArrays, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, stripIndents, truncate, wait };

package/dist/index.d.ts

@@ -62,6 +62,8 @@ interface CreateFormDataOptionsNullableResolution<K extends RecordKey> extends C
 type CreateFormDataOptions<K extends RecordKey> = CreateFormDataOptionsUndefinedOrNullResolution<K> | CreateFormDataOptionsNullableResolution<K>;
 declare function createFormData<T extends Record<RecordKey, unknown>>(data: T, options?: CreateFormDataOptions<keyof T>): FormData;
 
+declare function createTemplateStringsArray(strings: readonly string[]): TemplateStringsArray;
+
 declare function fillArray<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
 declare function fillArray<T>(callback: (index: number) => T, length?: number): T[];
 
@@ -109,6 +111,10 @@ declare function truncate(stringToTruncate: string, maxLength?: number): string;
 
 declare function wait(seconds: number): Promise<void>;
 
+declare function interpolate(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
+
 declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
 
-export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataNullableResolutionStrategy as FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type IgnoreCase, type KebabToCamelOptions, type NonUndefined, type OptionalOnCondition, type RecordKey, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, omitProperties, paralleliseArrays, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };
+declare function stripIndents(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
+
+export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataNullableResolutionStrategy as FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type IgnoreCase, type KebabToCamelOptions, type NonUndefined, type OptionalOnCondition, type RecordKey, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, httpErrorCodeLookup, interpolate, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, omitProperties, paralleliseArrays, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, stripIndents, truncate, wait };

package/dist/index.js

@@ -149,6 +149,12 @@ function createFormData(data, options = {
 }
 var createFormData_default = createFormData;
 
+// src/functions/createTemplateStringsArray.ts
+function createTemplateStringsArray(strings) {
+  return Object.assign([...strings], { raw: [...strings] });
+}
+var createTemplateStringsArray_default = createTemplateStringsArray;
+
 // src/functions/fillArray.ts
 function fillArray(callback, length = 1) {
   const outputArray = new Array(length).fill(null).map((_, index) => {
@@ -425,6 +431,16 @@ function wait(seconds) {
 }
 var wait_default = wait;
 
+// src/functions/taggedTemplate/interpolate.ts
+function interpolate(strings, ...interpolations) {
+  let result = "";
+  for (const [string, interpolation = ""] of paralleliseArrays_default(strings, interpolations)) {
+    result += string + interpolation;
+  }
+  return result;
+}
+var interpolate_default = interpolate;
+
 // src/functions/taggedTemplate/interpolateObjects.ts
 function interpolateObjects(strings, ...values) {
   let result = "";
@@ -438,6 +454,31 @@ function interpolateObjects(strings, ...values) {
 }
 var interpolateObjects_default = interpolateObjects;
 
+// src/functions/taggedTemplate/stripIndents.ts
+function calculateTabSize(line) {
+  const defaultWhitespaceLength = 12;
+  const potentialWhitespacePart = line.slice(0, defaultWhitespaceLength);
+  const trimmedString = line.trim();
+  if (potentialWhitespacePart.trim() !== "") {
+    return 0;
+  }
+  const tabSize = line.length - (trimmedString.length + defaultWhitespaceLength);
+  return tabSize < 0 ? 0 : tabSize;
+}
+function reduceLines(lines) {
+  return lines.map((line) => {
+    const tabSize = calculateTabSize(line);
+    return fillArray_default(() => {
+      return " ";
+    }, tabSize).join("") + line.trim();
+  }).join("\n");
+}
+function stripIndents(strings, ...interpolations) {
+  const fullString = interpolate_default(strings, ...interpolations);
+  return reduceLines(fullString.split("\n"));
+}
+var stripIndents_default = stripIndents;
+
 // src/types/APIError.ts
 var httpErrorCodeLookup = {
   400: "BAD_REQUEST",
@@ -500,11 +541,13 @@ export {
   camelToKebab_default as camelToKebab,
   convertFileToBase64_default as convertFileToBase64,
   createFormData_default as createFormData,
+  createTemplateStringsArray_default as createTemplateStringsArray,
   fillArray_default as fillArray,
   formatDateAndTime_default as formatDateAndTime,
   getRandomNumber_default as getRandomNumber,
   getRecordKeys_default as getRecordKeys,
   httpErrorCodeLookup,
+  interpolate_default as interpolate,
   interpolateObjects_default as interpolateObjects,
   isLeapYear_default as isLeapYear,
   isMonthlyMultiple_default as isMonthlyMultiple,
@@ -522,6 +565,7 @@ export {
   removeDuplicates_default as removeDuplicates,
   stringListToArray_default as stringListToArray,
   stringToBoolean_default as stringToBoolean,
+  stripIndents_default as stripIndents,
   truncate_default as truncate,
   wait_default as wait
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "2.16.1",
+  "version": "2.18.0",
   "description": "Helpful utility functions",
   "repository": {
     "type": "git",