dce-reactkit 4.3.4 → 5.0.0-beta-progress-size-3

package/src/helpers/compareArraysByProp.test.ts

@@ -1,147 +0,0 @@
-/**
- * Test file for the compareArraysByProp helper
- * @author Gabe Abrams
- */
-
-// Import main helper
-import compareArraysByProp from './compareArraysByProp';
-
-describe('compareArraysByProp', () => {
-  it('should return true for two empty arrays', () => {
-    const result = compareArraysByProp([], [], 'id');
-    expect(result).toEqual(true);
-  });
-
-  it('should return true for two arrays with the same objects in the same order', () => {
-    const a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
-    const b = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(true);
-  });
-
-  it('should return true for two arrays with the same objects in a different order', () => {
-    const a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
-    const b = [{ id: 3, name: 'Charlie' }, { id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(true);
-  });
-
-  it('should return false for two arrays with different objects', () => {
-    const a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
-    const b = [{ id: 4, name: 'Dave' }, { id: 5, name: 'Eve' }, { id: 6, name: 'Frank' }];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(false);
-  });
-
-  it('should return false for two arrays with different objects and some shared objects', () => {
-    const a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
-    const b = [{ id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }, { id: 4, name: 'Dave' }];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(false);
-  });
-
-  it('should return true for two arrays with the same objects with multiple properties', () => {
-    const a = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const b = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(true);
-  });
-
-  it('should return true for two arrays with the same objects with multiple properties in a different order', () => {
-    const a = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const b = [
-      { id: 3, name: 'Charlie', age: 35 },
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-    ];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(true);
-  });
-
-  it('should return false for two arrays with different objects with multiple properties', () => {
-    const a = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const b = [
-      { id: 4, name: 'Dave', age: 40 },
-      { id: 5, name: 'Eve', age: 45 },
-      { id: 6, name: 'Frank', age: 50 },
-    ];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(false);
-  });
-
-  it('should return false for two arrays with different objects with multiple properties and some shared objects', () => {
-    const a = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const b = [
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-      { id: 4, name: 'Dave', age: 40 },
-    ];
-    const result = compareArraysByProp(a, b, 'id');
-    expect(result).toEqual(false);
-  });
-
-  it('should return true for two arrays with the same objects with multiple properties and multiple props', () => {
-    const a = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const b = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const result = compareArraysByProp(a, b, ['id', 'name']);
-    expect(result).toEqual(true);
-  });
-
-  it('should return true for two arrays with the same objects with multiple properties and multiple props in a different order', () => {
-    const a = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const b = [
-      { id: 3, name: 'Charlie', age: 35 },
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-    ];
-    const result = compareArraysByProp(a, b, ['id', 'name']);
-    expect(result).toEqual(true);
-  });
-
-  it('should return false for two arrays with different objects with multiple properties and multiple props', () => {
-    const a = [
-      { id: 1, name: 'Alice', age: 25 },
-      { id: 2, name: 'Bob', age: 30 },
-      { id: 3, name: 'Charlie', age: 35 },
-    ];
-    const b = [
-      { id: 1, name: 'Bob', age: 40 },
-      { id: 2, name: 'Alice', age: 45 },
-      { id: 3, name: 'Charlie', age: 50 },
-    ];
-    const result = compareArraysByProp(a, b, ['id', 'name']);
-    expect(result).toEqual(false);
-  });
-});

package/src/helpers/compareArraysByProp.ts

@@ -1,56 +0,0 @@
-/**
- * Compare two arrays of objects by only comparing the values in a specific
- *  property (e.g. compare user arrays by comparing their user.id values)
- * @author Gabe Abrams
- * @param a the first array
- * @param b the second array
- * @param prop the property to compare with, or an array of props to compare
- *   with (if array, all values associated with those props must match)
- * @returns true if the arrays contain the same objects as determined by
- *   the values associated with each object's prop
- */
-const compareArraysByProp = (
-  a: any[],
-  b: any[],
-  prop: string | string[],
-): boolean => {
-  // Immediately return if size of arrays is different
-  if (a.length !== b.length) {
-    return false;
-  }
-
-  // Get all props
-  const props = (Array.isArray(prop) ? prop : [prop]);
-
-  // Clone second array so we can work on it
-  const bCloned = [...b];
-
-  // Remove elements from b as we find them in a
-  for (let i = 0; i < a.length; i++) {
-    // Find matching element in b
-    const matchingIndex = bCloned.findIndex((bItem) => {
-      // Compare based on all props
-      return props.every((propToCompareBy) => {
-        const aVal = (a[i] ?? {})[propToCompareBy];
-        const bVal = (bItem ?? {})[propToCompareBy];
-        return aVal === bVal;
-      });
-    });
-
-    // Check if no match
-    const noMatch = (matchingIndex < 0);
-
-    // If no match, there's no corresponding element in b
-    if (noMatch) {
-      return false;
-    }
-
-    // Remove the matching element
-    bCloned.splice(matchingIndex, 1);
-  }
-
-  // If we made it here, all elements in a have a corresponding element in b
-  return true;
-};
-
-export default compareArraysByProp;

package/src/helpers/extractProp.test.ts

@@ -1,34 +0,0 @@
-/**
- * Test file for the extractProp helper
- * @author Gabe Abrams
- */
-
-// Import main helper
-import extractProp from './extractProp';
-
-describe('extractProp', () => {
-  it('should return an empty array if the input array is empty', () => {
-    const result = extractProp([], 'age');
-    expect(result).toEqual([]);
-  });
-
-  it('should extract the correct property from each object in the array', () => {
-    const users = [
-      { name: 'Alice', age: 25 },
-      { name: 'Bob', age: 30 },
-      { name: 'Charlie', age: 35 },
-    ];
-    const result = extractProp(users, 'age');
-    expect(result).toEqual([25, 30, 35]);
-  });
-
-  it('should return undefined for objects that do not have the specified property', () => {
-    const users = [
-      { name: 'Alice', age: 25 },
-      { name: 'Bob' },
-      { name: 'Charlie', age: 35 },
-    ];
-    const result = extractProp(users, 'age');
-    expect(result).toEqual([25, undefined, 35]);
-  });
-});

package/src/helpers/extractProp.ts

@@ -1,17 +0,0 @@
-/**
- * For every element in an array, extract the value of a prop
- *   (e.g. for all user objects, extract their ages and put that into a new
- *   ages array)
- * @author Gabe Abrams
- * @param arr the array of objects to operate on
- * @param prop the property to extract from each object
- * @returns new array containing the corresponding values, in order, of each
- *   object in the original array
- */
-const extractProp = (arr: any[], prop: string) => {
-  return arr.map((item) => {
-    return item[prop];
-  });
-};
-
-export default extractProp;

package/src/helpers/floorToNumDecimals.test.ts

@@ -1,39 +0,0 @@
-/**
- * Test file for the floorToNumDecimals helper
- * @author Gabe Abrams
- */
-
-// Import main function
-import floorToNumDecimals from './floorToNumDecimals';
-
-describe('floorToNumDecimals', () => {
-  it('should return 0 for 0 with 0 decimals', () => {
-    const result = floorToNumDecimals(0, 0);
-    expect(result).toEqual(0);
-  });
-
-  it('should return 1 for 1 with 0 decimals', () => {
-    const result = floorToNumDecimals(1, 0);
-    expect(result).toEqual(1);
-  });
-
-  it('should return 1.23 for 1.234 with 2 decimals', () => {
-    const result = floorToNumDecimals(1.234, 2);
-    expect(result).toEqual(1.23);
-  });
-
-  it('should return -1.24 for -1.234 with 2 decimals', () => {
-    const result = floorToNumDecimals(-1.234, 2);
-    expect(result).toEqual(-1.24);
-  });
-
-  it('should return 1234 for 1234 with 0 decimals', () => {
-    const result = floorToNumDecimals(1234, 0);
-    expect(result).toEqual(1234);
-  });
-
-  it('should return 0.001 for 0.00123 with 3 decimals', () => {
-    const result = floorToNumDecimals(0.00123, 3);
-    expect(result).toEqual(0.001);
-  });
-});

package/src/helpers/floorToNumDecimals.ts

@@ -1,13 +0,0 @@
-/**
- * Round a number (floor) to a certain number of decimals
- * @author Gabe Abrams
- * @param num the number to round
- * @param numDecimals the number of decimals to round to
- * @returns rounded number
- */
-const floorToNumDecimals = (num: number, numDecimals: number): number => {
-  const rounder = 10 ** numDecimals;
-  return (Math.floor(num * rounder) / rounder);
-};
-
-export default floorToNumDecimals;

package/src/helpers/forceNumIntoBounds.test.ts

@@ -1,34 +0,0 @@
-/**
- * Test file for the forceNumIntoBounds helper
- * @author Gabe Abrams
- */
-
-// Import main helper
-import forceNumIntoBounds from './forceNumIntoBounds';
-
-describe('forceNumIntoBounds', () => {
-  it('should return the number if it is within the bounds', () => {
-    const result = forceNumIntoBounds(5, 0, 10);
-    expect(result).toEqual(5);
-  });
-
-  it('should return the minimum bound if the number is less than the minimum', () => {
-    const result = forceNumIntoBounds(-5, 0, 10);
-    expect(result).toEqual(0);
-  });
-
-  it('should return the maximum bound if the number is greater than the maximum', () => {
-    const result = forceNumIntoBounds(15, 0, 10);
-    expect(result).toEqual(10);
-  });
-
-  it('should return the minimum bound if the number is equal to the minimum', () => {
-    const result = forceNumIntoBounds(0, 0, 10);
-    expect(result).toEqual(0);
-  });
-
-  it('should return the maximum bound if the number is equal to the maximum', () => {
-    const result = forceNumIntoBounds(10, 0, 10);
-    expect(result).toEqual(10);
-  });
-});

package/src/helpers/forceNumIntoBounds.ts

@@ -1,19 +0,0 @@
-/**
- * Force a number to stay within specific bounds
- * @author Gabe Abrams
- * @param num the number to move into the bounds
- * @param min the minimum number in the bound
- * @param max the maximum number in the bound
- * @returns bounded number
- */
-const forceNumIntoBounds = (num: number, min: number, max: number): number => {
-  return Math.max(
-    min,
-    Math.min(
-      max,
-      num,
-    ),
-  );
-};
-
-export default forceNumIntoBounds;

package/src/helpers/genCSV.test.ts

@@ -1,75 +0,0 @@
-/**
- * Test file for the genCSV helper
- * @author Gabe Abrams
- */
-
-// Import main helper
-import genCSV from './genCSV';
-
-describe('genCSV', () => {
-  it('should return an empty string for empty data', () => {
-    const result = genCSV([], []);
-    expect(result).toEqual('');
-  });
-
-  it('should generate a CSV with the correct headers and data', () => {
-    const columns = [
-      { title: 'Name', param: 'name' },
-      { title: 'Age', param: 'age' },
-      { title: 'Email', param: 'email' },
-    ];
-    const data = [
-      { name: 'Alice', age: 25, email: 'alice@example.com' },
-      { name: 'Bob', age: 30, email: 'bob@example.com' },
-      { name: 'Charlie', age: 35, email: 'charlie@example.com' },
-    ];
-    const expected = 'Name,Age,Email\nAlice,25,alice@example.com\nBob,30,bob@example.com\nCharlie,35,charlie@example.com';
-    const result = genCSV(data, columns);
-    expect(result).toEqual(expected);
-  });
-
-  it('should handle undefined and null values correctly', () => {
-    const columns = [
-      { title: 'Name', param: 'name' },
-      { title: 'Age', param: 'age' },
-      { title: 'Email', param: 'email' },
-    ];
-    const data = [
-      { name: 'Alice', age: undefined, email: null },
-      { name: 'Bob', age: null, email: 'bob@example.com' },
-      { name: 'Charlie', age: 35, email: undefined },
-    ];
-    const expected = 'Name,Age,Email\nAlice,,\nBob,,bob@example.com\nCharlie,35,';
-    const result = genCSV(data, columns);
-    expect(result).toEqual(expected);
-  });
-
-  it('should handle objects in cells correctly', () => {
-    const columns = [
-      { title: 'Name', param: 'name' },
-      { title: 'Data', param: 'data' },
-    ];
-    const data = [
-      { name: 'Alice', data: { foo: 'bar' } },
-      { name: 'Bob', data: [1, 2, 3] },
-      { name: 'Charlie', data: null },
-    ];
-    const expected = 'Name,Data\nAlice,"{""foo"":""bar""}"\nBob,"[1,2,3]"\nCharlie,';
-    const result = genCSV(data, columns);
-    expect(result).toEqual(expected);
-  });
-
-  it('should use textIfUndefined for undefined values', () => {
-    const columns = [
-      { title: 'Name', param: 'name' },
-      { title: 'Age', param: 'age', textIfUndefined: 'N/A' },
-    ];
-    const data = [
-      { name: 'Alice', age: undefined },
-      { name: 'Bob', age: 30 },
-    ];
-    const expected = 'Name,Age\nAlice,N/A\nBob,30';
-    const result = genCSV(data, columns);
-    expect(result).toEqual(expected);
-  });
-});

package/src/helpers/genCSV.ts

@@ -1,87 +0,0 @@
-/**
- * Escape a CSV cell if needed
- * @author Gabe Abrams
- * @param text the cell contents
- * @returns escaped cell text
- */
-const escapeCellText = (text: string): string => {
-  if (
-    !String(text).includes(',')
-    && !String(text).includes('"')
-  ) {
-    // No need to escape
-    return String(text);
-  }
-
-  // Perform escape
-  return `"${String(text).replace(/"/g, '""')}"`;
-};
-
-/**
- * Generate a CSV file
- * @author Gabe Abrams
- * @param data list of row data in the form of json objects
- * @param columns list of columns to include in the csv where each column is an object with:
- * - title: the column title
- * - param: the key in the data object to use for this column
- * - textIfUndefined: optional text to use if the value is undefined (defaults to empty string)
- * @returns multiline csv string
- */
-const genCSV = (
-  data: {
-    [k: string]: any
-  }[],
-  columns: {
-    title: string,
-    param: string,
-    textIfUndefined?: string,
-  }[],
-): string => {
-  let csv = '';
-
-  // Add header
-  csv += (
-    columns
-      .map((column) => {
-        return escapeCellText(column.title);
-      })
-      .join(',')
-  );
-
-  // Add each row
-  data.forEach((datum) => {
-    csv += '\n';
-    csv += (
-      columns
-        .map((column) => {
-          let contents: string;
-          const cell = datum[column.param];
-          if (
-            typeof cell === 'string'
-            || typeof cell === 'number'
-            || typeof cell === 'boolean'
-          ) {
-            contents = String(cell);
-          } else if (cell === null) {
-            contents = '';
-          } else if (typeof cell === 'undefined') {
-            contents = (
-              column.textIfUndefined
-              ?? ''
-            );
-          } else if (typeof cell === 'object') {
-            contents = JSON.stringify(cell);
-          } else {
-            contents = '';
-          }
-          return escapeCellText(contents);
-        })
-        .join(',')
-    );
-  });
-
-  // Return
-  return csv;
-};
-
-export default genCSV;

package/src/helpers/genCommaList.test.ts

@@ -1,57 +0,0 @@
-// Import function
-import genCommaList from './genCommaList';
-
-test(
-  'Empty list.',
-  async () => {
-    const emptyList: string[] = [];
-    const emptyListResponse: string = '';
-
-    const result = genCommaList(emptyList);
-    expect(result).toStrictEqual(emptyListResponse);
-  },
-);
-
-test(
-  'One word list.',
-  async () => {
-    const oneList: string[] = ['apples'];
-    const oneListResponse: string = 'apples';
-
-    const result = genCommaList(oneList);
-    expect(result).toStrictEqual(oneListResponse);
-  },
-);
-
-test(
-  'Two word list.',
-  async () => {
-    const twoList: string[] = ['apples', 'oranges'];
-    const twoListResponse: string = 'apples and oranges';
-
-    const result = genCommaList(twoList);
-    expect(result).toStrictEqual(twoListResponse);
-  },
-);
-
-test(
-  'Three word list.',
-  async () => {
-    const threeList: string[] = ['apples', 'oranges', 'bananas'];
-    const threeListResponse: string = 'apples, oranges, and bananas';
-
-    const result = genCommaList(threeList);
-    expect(result).toStrictEqual(threeListResponse);
-  },
-);
-
-test(
-  'Four word list.',
-  async () => {
-    const fourList: string[] = ['apples', 'oranges', 'bananas', 'grapes'];
-    const fourListResponse: string = 'apples, oranges, bananas, and grapes';
-
-    const result = genCommaList(fourList);
-    expect(result).toStrictEqual(fourListResponse);
-  },
-);

package/src/helpers/genCommaList.ts

@@ -1,21 +0,0 @@
-/**
- * Given an array of strings, create a single comma-separated string that includes
- * 'and' as well as an oxford comma.
- *   Ex: ['apples'] => 'apples'
- *   Ex: ['apples', 'bananas'] => 'apples and bananas'
- *   Ex: ['apples', 'bananas', 'grapes'] => 'apples, bananas, and grapes'
- * @author Austen Money
- * @param list an array of elements to be made into a single comma-separated string.
- * @returns a comma-separated string.
- */
-const genCommaList = (list: string[]): string => {
-  const { length } = list;
-
-  return (
-    length < 2
-      ? list.join('')
-      : `${list.slice(0, length - 1).join(', ')}${length < 3 ? ' and ' : ', and '}${list[length - 1]}`
-  );
-};
-
-export default genCommaList;

package/src/helpers/getHumanReadableDate.test.ts

@@ -1,29 +0,0 @@
-/**
- * Test file for the getHumanReadableDate helper
- * @author Gabe Abrams
- */
-
-// Import helpers
-import getHumanReadableDate from './getHumanReadableDate';
-import getOrdinal from './getOrdinal';
-
-describe('getHumanReadableDate', () => {
-  it('should return the current date if no argument is passed', () => {
-    const result = getHumanReadableDate();
-    const now = new Date();
-    const expected = `${now.toLocaleString('default', { month: 'short' })} ${now.getDate()}${getOrdinal(now.getDate())}`;
-    expect(result).toEqual(expected);
-  });
-
-  it('should return the correct date for a given timestamp', () => {
-    const timestamp = 1629822000000; // 2021-08-24T12:20:00.000Z
-    const result = getHumanReadableDate(timestamp);
-    expect(result).toEqual('Aug 24th 2021');
-  });
-
-  it('should return the correct date for a given Date object', () => {
-    const date = new Date('2021-08-24T12:20:00.000Z');
-    const result = getHumanReadableDate(date);
-    expect(result).toEqual('Aug 24th 2021');
-  });
-});

package/src/helpers/getHumanReadableDate.ts

@@ -1,36 +0,0 @@
-// Import shared helpers
-import getTimeInfoInET from './getTimeInfoInET';
-import getOrdinal from './getOrdinal';
-import getMonthName from './getMonthName';
-
-/**
- * Get a human-readable description of a date (all in ET)
- * @author Gabe Abrams
- * @param [dateOrTimestamp=today] the date or timestamp for the date to describe
- * @returns human-readable description of the date
- */
-const getHumanReadableDate = (dateOrTimestamp?: Date | number) => {
-  // Get the date info
-  const {
-    month,
-    day,
-    year,
-  } = getTimeInfoInET(dateOrTimestamp);
-  const currYear = getTimeInfoInET().year;
-
-  // Get the short month description
-  const monthName = getMonthName(month).short;
-
-  // Create start of description
-  let description = `${monthName} ${day}${getOrdinal(day)}`;
-
-  // Add on year if it's different
-  if (year !== currYear) {
-    description += ` ${year}`;
-  }
-
-  // Return description
-  return description;
-};
-
-export default getHumanReadableDate;