(new) renameKeys and 0.31.0 bump

.github/workflows/build.yml

@@ -7,7 +7,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node: ['20', '18', '16']
+        node: ['24', '22', '20']
     name: Node ${{ matrix.node }}
     steps:
       - name: Checkout repository

package.json

@@ -1,6 +1,6 @@
 {
   "name": "types-ramda",
-  "version": "0.30.1",
+  "version": "0.31.0",
   "description": "Dedicated types library for ramda",
   "author": "Harris Miller <harrismillerconsulting@gmail.com>",
   "contributors": [
@@ -67,7 +67,7 @@
     "dox": "^1.0.0",
     "eslint": "^8.50.0",
     "eslint-plugin-import": "^2.28.1",
-    "ramda": "^0.30.1",
+    "ramda": "^0.31.3",
     "rimraf": "^5.0.5",
     "tsd": "^0.31.0",
     "typescript": "^5.2.2",

test/renameKeys.test.ts

@@ -0,0 +1,19 @@
+import { expectAssignable, expectType } from 'tsd';
+
+import { __, renameKeys } from '../es';
+
+expectType<{ bar: number; other: string }>(renameKeys({ foo: 'bar' })({ foo: 123, other: 'abc' }));
+expectType<{ foo: number; blah: string }>(renameKeys({ other: 'blah' })({ foo: 123, other: 'abc' }));
+
+expectType<{ bar: number; other: string }>(renameKeys(__, { foo: 123, other: 'abc' })({ foo: 'bar' }));
+expectType<{ foo: number; blah: string }>(renameKeys(__, { foo: 123, other: 'abc' })({ other: 'blah' }));
+
+expectType<{ bar: number; other: string }>(renameKeys({ foo: 'bar' }, { foo: 123, other: 'abc' }));
+expectType<{ foo: number; blah: string }>(renameKeys({ other: 'blah' }, { foo: 123, other: 'abc' }));
+
+const nonConstObj = { foo: 'bar' };
+
+const what = renameKeys(nonConstObj, { foo: 123, other: 'abc' });
+//    ^?
+// @ts-expect-error - I have no idea why declaring the type throws an error, but it can be calculated above
+expectAssignable<{ [x: string]: number; other: string; }>(what);

types/renameKeys.d.ts

@@ -0,0 +1,8 @@
+import { Placeholder, Prettify, Remap } from './util/tools';
+
+// renameKeys(mapping)(obj)
+export function renameKeys<const U extends Record<PropertyKey, string>>(mapping: U): <T extends Record<keyof U, unknown>>(obj: T) => Prettify<Omit<T, keyof U> & Remap<T, U>>;
+// renameKeys(__, obj)(mapping)
+export function renameKeys<T>(__: Placeholder, obj: T): <const U extends Partial<Record<keyof T, string>>>(mapping: U) => Prettify<Omit<T, keyof U> & Remap<T, U>>;
+// renameKeys(mapping, obj)
+export function renameKeys<T, const U extends Partial<Record<keyof T, string>>>(mapping: U, obj: T): Prettify<Omit<T, keyof U> & Remap<T, U>>;

types/util/tools.d.ts

@@ -520,3 +520,28 @@ export type NonEmptyArray<T> = [T, ...T[]];
  * <created by @harris-miller>
  */
 export type ReadonlyNonEmptyArray<T> = readonly [T, ...T[]];
+
+/**
+ * Prettify type into an object literal
+ * <created by @harris-miller>
+ */
+export type Prettify<T> = {[KeyType in keyof T]: T[KeyType]} & {};
+
+type TuplesFromObject<T> = {
+  [P in keyof T]: [P, T[P]];
+}[keyof T];
+
+type GetKeyByValue<T, V> =
+  TuplesFromObject<T> extends infer TT
+    ? TT extends [infer P, V]
+      ? P
+      : never
+    : never;
+
+/**
+ * Remap keys of one object to the values of mapping object
+ * <created by @RobinTail>
+ */
+export type Remap<T, U extends { [P in keyof T]?: string }> = {
+  [P in NonNullable<U[keyof U]>]: T[GetKeyByValue<U, P>];
+};