[@wordpress/blob] add new definitions (#36223)

types/wordpress__blob/index.d.ts

@@ -0,0 +1,41 @@
+// Type definitions for @wordpress/blob 2.4
+// Project: https://github.com/WordPress/gutenberg/tree/master/packages/blob/README.md
+// Definitions by: Derek Sifford <https://github.com/dsifford>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 3.5
+
+/**
+ * Create a blob URL from a file.
+ *
+ * @param file - The file to create a blob URL for.
+ *
+ * @returns The blob URL.
+ */
+export function createBlobURL(file: File): string;
+
+/**
+ * Retrieve a file based on a blob URL. The file must have been created by
+ * `createBlobURL` and not removed by `revokeBlobURL`, otherwise it will return
+ * `undefined`.
+ *
+ * @param url - The blob URL.
+ *
+ * @returns The file for the blob URL.
+ */
+export function getBlobByURL(url: string): File | undefined;
+
+/**
+ * Check whether a url is a blob url.
+ *
+ * @param url - The URL.
+ *
+ * @returns Is the url a blob url?
+ */
+export function isBlobURL(url: string): boolean;
+
+/**
+ * Remove the resource and file cache from memory.
+ *
+ * @param url - The blob URL.
+ */
+export function revokeBlobURL(url: string): void;

types/wordpress__blob/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": ["dom", "es6"],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../",
+        "typeRoots": ["../"],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true,
+        "paths": {
+            "@wordpress/blob": ["wordpress__blob"]
+        }
+    },
+    "files": ["index.d.ts", "wordpress__blob-tests.ts"]
+}

types/wordpress__blob/tslint.json

@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }

types/wordpress__blob/wordpress__blob-tests.ts

@@ -0,0 +1,13 @@
+import * as B from '@wordpress/blob';
+
+B.createBlobURL(
+    new File(['foo'], 'foo.txt', {
+        type: 'text/plain',
+    })
+);
+
+B.getBlobByURL('blob:thisbitdoesnotmatter');
+
+B.isBlobURL('blob:thisbitdoesnotmatter'); // true
+
+B.revokeBlobURL('blob:thisbitdoesnotmatter');