🤖 Merge PR DefinitelyTyped#73240 Add Web Install API by @LiaHiscock

Author: LiaHiscock

types/web-install-api/.npmignore

@@ -0,0 +1,5 @@
+*
+!**/*.d.ts
+!**/*.d.cts
+!**/*.d.mts
+!**/*.d.*.ts

types/web-install-api/index.d.ts

@@ -0,0 +1,9 @@
+interface InstallFunction {
+    (): Promise<string>;
+    (installUrl: string): Promise<string>;
+    (installUrl: string, manifestId: string): Promise<string>;
+}
+
+interface Navigator {
+    install?: InstallFunction;
+}

types/web-install-api/package.json

@@ -0,0 +1,23 @@
+{
+    "private": true,
+    "name": "@types/web-install-api",
+    "nonNpm": true,
+    "nonNpmDescription": "Web Install API",
+    "version": "2025.1.9999",
+    "projects": [
+        "https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/WebInstall/explainer.md"
+    ],
+    "devDependencies": {
+        "@types/web-install-api": "workspace:."
+    },
+    "owners": [
+        {
+            "name": "Lia Hiscock",
+            "githubUsername": "LiaHiscock"
+        },
+        {
+            "name": "Kristin Lee",
+            "githubUsername": "Kbhlee2121"
+        }
+    ]
+}

types/web-install-api/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "compilerOptions": {
+        "module": "node16",
+        "lib": [
+            "es6",
+            "dom"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictFunctionTypes": true,
+        "strictNullChecks": true,
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "web-install-api-tests.ts"
+    ]
+}

types/web-install-api/web-install-api-tests.ts

@@ -0,0 +1,13 @@
+if (navigator.install) {
+    // $ExpectType Promise<string>
+    navigator.install();
+
+    // $ExpectType Promise<string>
+    navigator.install("https://foo.com");
+
+    // $ExpectType Promise<string>
+    navigator.install("https://foo.com", "manifest-id");
+
+    // @ts-expect-error
+    navigator.install(45);
+}