refactor: convert fns package to TS

Author: diegomura

package.json

@@ -74,6 +74,8 @@
     "rimraf": "^2.6.3",
     "rollup": "^4.34.6",
     "rollup-plugin-copy": "^3.5.0",
+    "rollup-plugin-delete": "^2.1.0",
+    "rollup-plugin-dts": "^6.1.1",
     "rollup-plugin-ignore": "^1.0.10",
     "rollup-plugin-local-resolve": "^1.0.7",
     "rollup-plugin-polyfill-node": "^0.13.0",

packages/fns/babel.config.js

@@ -7,18 +7,16 @@
   "homepage": "https://github.com/diegomura/react-pdf#readme",
   "type": "module",
   "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
   "repository": {
     "type": "git",
     "url": "https://github.com/diegomura/react-pdf.git",
     "directory": "packages/fns"
   },
   "scripts": {
     "test": "vitest",
-    "build": "rimraf ./lib && rollup -c",
-    "watch": "rimraf ./lib && rollup -c -w"
-  },
-  "dependencies": {
-    "@babel/runtime": "^7.20.13"
+    "build": "rollup -c",
+    "watch": "rollup -c -w"
   },
   "files": [
     "lib"

packages/fns/package.json

@@ -1,24 +1,18 @@
-import babel from '@rollup/plugin-babel';
+import typescript from '@rollup/plugin-typescript';
+import { dts } from 'rollup-plugin-dts';
+import del from 'rollup-plugin-delete';
 
-const input = 'src/index.js';
-
-const output = { format: 'es', file: 'lib/index.js' };
-
-const getExternal = () => [/@babel\/runtime/];
-
-const getPlugins = () => [
-  babel({
-    babelrc: true,
-    babelHelpers: 'runtime',
-    exclude: 'node_modules/**',
-  }),
+const config = [
+  {
+    input: 'src/index.ts',
+    output: { format: 'es', dir: 'lib' },
+    plugins: [typescript(), del({ targets: 'lib' })],
+  },
+  {
+    input: './lib/types/index.d.ts',
+    output: [{ file: 'lib/index.d.ts', format: 'es' }],
+    plugins: [dts(), del({ targets: 'lib/types', hook: 'buildEnd' })],
+  },
 ];
 
-const config = {
-  input,
-  output,
-  external: getExternal(),
-  plugins: getPlugins(),
-};
-
 export default config;

packages/fns/rollup.config.js

@@ -1,12 +1,12 @@
 /**
  * Applies a function to the value at the given index of an array
-
- * @param {number} index
- * @param {function} fn
- * @param {array} collection
- * @returns copy of the array with the element at the given index replaced with the result of the function application.
+ *
+ * @param index
+ * @param fn
+ * @param collection
+ * @returns Copy of the array with the element at the given index replaced with the result of the function application.
  */
-const adjust = (index, fn, collection) => {
+const adjust = (index: number, fn: (value: any) => any, collection: any[]) => {
   if (index >= 0 && index >= collection.length) return collection;
   if (index < 0 && Math.abs(index) > collection.length) return collection;
 

packages/fns/src/adjust.js packages/fns/src/adjust.tspackages/fns/src/adjust.js renamed to packages/fns/src/adjust.ts

@@ -2,22 +2,15 @@
 
 import reverse from './reverse';
 
-/**
- * @typedef {Function} AsyncCompose
- * @param {any} value
- * @param {...any} args
- * @returns {any} result
- */
-
 /**
  * Performs right-to-left function composition with async functions support
  *
- * @param {...Function} fns functions
- * @returns {AsyncCompose} composed function
+ * @param fns - Functions
+ * @returns Composed function
  */
 const asyncCompose =
-  (...fns) =>
-  async (value, ...args) => {
+  (...fns: any[]) =>
+  async (value: any, ...args: any[]) => {
     let result = value;
     const reversedFns = reverse(fns);
 

packages/fns/src/asyncCompose.js packages/fns/src/asyncCompose.tspackages/fns/src/asyncCompose.js renamed to packages/fns/src/asyncCompose.ts

@@ -1,10 +1,10 @@
 /**
  * Capitalize first letter of each word
  *
- * @param {string} value string
- * @returns {string} capitalized string
+ * @param value = Any string
+ * @returns Capitalized string
  */
-const capitalize = (value) => {
+const capitalize = (value?: string | null) => {
   if (!value) return value;
   return value.replace(/(^|\s)\S/g, (l) => l.toUpperCase());
 };

packages/fns/src/capitalize.js packages/fns/src/capitalize.tspackages/fns/src/capitalize.js renamed to packages/fns/src/capitalize.ts

@@ -0,0 +1,12 @@
+/**
+ * Casts value to array
+ *
+ * @template T - The type of the value.
+ * @param value - The value to cast into an array.
+ * @returns An array containing the given value.
+ */
+const castArray = <T = any>(value: T | T[]): T[] => {
+  return Array.isArray(value) ? value : [value];
+};
+
+export default castArray;

packages/fns/src/castArray.js

@@ -1,21 +1,14 @@
 import reverse from './reverse';
 
-/**
- * @typedef {Function} Compose
- * @param {any} value
- * @param {...any} args
- * @returns {any} result
- */
-
 /**
  * Performs right-to-left function composition
  *
- * @param {...Function} fns functions
- * @returns {Compose} composed function
+ * @param fns - Functions
+ * @returns Composed function
  */
 const compose =
-  (...fns) =>
-  (value, ...args) => {
+  (...fns: any[]) =>
+  (value: any, ...args: any[]) => {
     let result = value;
     const reversedFns = reverse(fns);