estidlore / litus Goto Github PK

Description

Add a math util that computes an operation between quantities (scalar or vector)

Motivation

Calculate a given operation for any quantity (scalar or vector) combination.

Proposed Solution

Function math.calc that receives an opFn with n-sized number input and output number, and n quantities. It returns a quantity as follows:

• If scalars only, return the calculation for the given scalars
• All vectors should have the same length
• If scalars and vectors, return a vector where each value is the calculation between the value v[i] of each input vector and each scalar

Additional Information

• Use conditional return type to keep strict-typing.

Description

Add function util that allows to a given function to receive arguments partially.

Motivation

Reuse specialized versions of functions and avoid duplication of params

Proposed Solution

Function func.curry that receives function fn and arity that is the params length. It returns a function that when receive all the params, it applies them to fn. Otherwise, curries a new function that applies the concatenation of the received params with the remaining ones.

Additional Information

Use infer to finely tune the resulting types

Description

Each util function should be in its own file

Motivation

Some utils depends on others. An util "1" in file "A" can depend on an util "2" in file "B" and an util "3" in "B" depend on an util "4" in "A". Then, it could lead to dependency cycles between files "A" and "B".

Proposed Solution

Each util have its own file such as arr.chunk under arr/chunk.ts and export them in their original file index.ts

Additional Information

The imports must change too, to import directly instead of from their original index.ts.

Description

Add an object util to deeply compare if the given variables are equal

Motivation

Compare if two different objects have the same values

Proposed Solution

Function obj.equal that receives two or more variables and return their deep equal comparison

Description

Add array util that sorts elements by custom mapping to a sortable (number or string).

Motivation

Sort almost any array given a custom mapping function.

Proposed Solution

Function arr.sort that receives an arr and a mapFn that receives a single element and returns either a number or a string.

Additional Information

• mapFn should return either number or string only (not number | string).
• Avoid localCompare for it depends on user's location.

Description

Add an array util to get the union set of given arrays

Motivation

Get all elements in given arrays without duplicates

Proposed Solution

Function arr.unique that receives some arrays and returns a Set of the concatenated elements of the arrays.

Description

Add function utils that converts a function from receiving args to arg tuple and viceversa.
Example: from (arg1: number, arg2: boolean, ..., argn: string) to ([number, boolean, ..., string])

Motivation

Use array as input for functions with several args and viceversa.

Proposed Solution

Functions func.apply for "spread to array" and func.unapply for "array to spread"