From 8225c94050c6d57bdb044c58694c3876fd426e8d Mon Sep 17 00:00:00 2001
From: Dogan Fennibay <Dogan.Fennibay.Tr+github@ieee.org>
Date: Sun, 18 Nov 2018 20:43:25 +0100
Subject: [PATCH] add types for compare-func (#30630)

---
 types/compare-func/compare-func-tests.ts | 30 ++++++++++++++++++++++++
 types/compare-func/index.d.ts            | 12 ++++++++++
 types/compare-func/tsconfig.json         | 23 ++++++++++++++++++
 types/compare-func/tslint.json           |  1 +
 4 files changed, 66 insertions(+)
 create mode 100644 types/compare-func/compare-func-tests.ts
 create mode 100644 types/compare-func/index.d.ts
 create mode 100644 types/compare-func/tsconfig.json
 create mode 100644 types/compare-func/tslint.json

diff --git a/types/compare-func/compare-func-tests.ts b/types/compare-func/compare-func-tests.ts
new file mode 100644
index 0000000000..47b2842724
--- /dev/null
+++ b/types/compare-func/compare-func-tests.ts
@@ -0,0 +1,30 @@
+import compareFunc = require("compare-func");
+
+// This is taken from https://github.com/stevemao/compare-func/blob/master/README.md#usage and extended
+
+// sort by an object property
+[{ x: "b" }, { x: "a" }, { x: "c" }].sort(compareFunc("x"));
+// => [{x: "a"}, {x: "b"}, {x: "c"}]
+
+// sort by a nested object property
+[{ x: { y: "b" } }, { x: { y: "a" } }].sort(compareFunc("x.y"));
+// => [{x: {y: "a"}}, {x: {y: "b"}}]
+
+// sort by the `x` property, then `y`
+[{ x: "c", y: "c" }, { x: "b", y: "a" }, { x: "b", y: "b" }].sort(compareFunc(["x", "y"]));
+// => [{x: "b", y: "a"}, {x: "b", y: "b"}, {x: "c", y: "c"}]
+
+// sort by the returned value
+[{ x: "b" }, { x: "a" }, { x: "c" }].sort(compareFunc((el) => el.x));
+// => [{x: "a"}, {x: "b"}, {x: "c"}]
+
+// sort by an array of functions
+[{ x: "c", y: "c" }, { x: "b", y: "a" }, { x: "b", y: "b" }].sort(compareFunc([
+    (el) => el.x,
+    (el) => el.y,
+]));
+// => [{x: "a"}, {x: "b"}, {x: "c"}]
+
+// sort by itself
+[1, 3, 2].sort(compareFunc());
+// => [1, 2, 3]
diff --git a/types/compare-func/index.d.ts b/types/compare-func/index.d.ts
new file mode 100644
index 0000000000..357de04fb0
--- /dev/null
+++ b/types/compare-func/index.d.ts
@@ -0,0 +1,12 @@
+// Type definitions for compare-func 1.3
+// Project: https://github.com/stevemao/compare-func
+// Definitions by: Dogan Fennibay <https://github.com/fennibay>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.4
+
+type extractFunc<T> = (e: T) => number | string;
+
+declare function compare_func<T>(prop?: ReadonlyArray<string | extractFunc<T>> | string | extractFunc<T>):
+    (e1: T, e2: T) => number;
+
+export = compare_func;
diff --git a/types/compare-func/tsconfig.json b/types/compare-func/tsconfig.json
new file mode 100644
index 0000000000..9aa5f60c9d
--- /dev/null
+++ b/types/compare-func/tsconfig.json
@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "compare-func-tests.ts"
+    ]
+}
diff --git a/types/compare-func/tslint.json b/types/compare-func/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/compare-func/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }