refact: Migrate $helper.file to TypeScript (#7990)

Author: distantnative

panel/src/helpers/file.test.js panel/src/helpers/file.test.tspanel/src/helpers/file.test.js renamed to panel/src/helpers/file.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { extension, name } from "./file";
+import { extension, name, niceSize } from "./file";
 
 describe.concurrent("$helper.file.extension()", () => {
 	it("returns the extension of a filename", () => {
@@ -16,3 +16,11 @@ describe.concurrent("$helper.file.name()", () => {
 		expect(name("file")).toBe("");
 	});
 });
+
+describe.concurrent("$helper.file.niceSize()", () => {
+	it("formats bytes", () => {
+		expect(niceSize(0)).toBe("0B");
+		expect(niceSize(1024)).toBe("1KB");
+		expect(niceSize(1048576)).toBe("1MB");
+	});
+});

panel/src/helpers/file.js panel/src/helpers/file.tspanel/src/helpers/file.js renamed to panel/src/helpers/file.ts

@@ -1,30 +1,31 @@
 /**
  * Extracts the extension
  *
- * @param {String} filename
- * @returns {String}
+ * @example
+ * extension("image.jpg") // => "jpg"
  */
-export const extension = (filename) => {
+export function extension(filename: string): string {
 	return filename.split(".").slice(-1).join("");
-};
+}
 
 /**
  * Extracts the name without extension
  *
- * @param {String} filename
- * @returns {String}
+ * @example
+ * name("image.jpg") // => "image"
  */
-export const name = (filename) => {
+export function name(filename: string): string {
 	return filename.split(".").slice(0, -1).join(".");
-};
+}
 
 /**
  * Creates a nice human-readable file size string with size unit
  *
- * @param {Number} size
- * @returns {String}
+ * @example
+ * niceSize(1024) // => "1KB"
+ * niceSize(1048576) // => "1MB"
  */
-export const niceSize = (size) => {
+export function niceSize(size: number): string {
 	const formatter = Intl.NumberFormat("en", {
 		notation: "compact",
 		style: "unit",
@@ -33,7 +34,7 @@ export const niceSize = (size) => {
 	});
 
 	return formatter.format(size);
-};
+}
 
 export default {
 	extension,