refactor(webref): drop browser-specs

Author: saschanaz

README.md

@@ -7,7 +7,6 @@ Get types for the latest web APIs as soon as they become widely available!
 [The default types generator](https://github.com/microsoft/TypeScript-DOM-lib-generator/) for TypeScript requires manual review for every update, and thus does not provide types for every latest API in a timely manner. `types-web` solves this issue by deploying automation by following tools:
 
   * [`@mdn/browser-compat-data`](https://www.npmjs.com/package/@mdn/browser-compat-data) provides which features are supported by which browsers, so that undersupported features can be disabled automatically.
-  * [`browser-specs`](https://www.npmjs.com/package/browser-specs) provides a full list of web specs, so that every latest feature can be covered.
   * [`webref`](https://github.com/w3c/webref) provides IDL code from the specs, so that the features can be properly typed.
 
 See how many types have been added in the [changelog](CHANGELOG.md).

package-lock.json

@@ -42,7 +42,6 @@
     "@webref/css": "1.1.0",
     "@webref/elements": "1.0.0",
     "@webref/idl": "2.2.1",
-    "browser-specs": "^1.38.1",
     "cpx2": "^3.0.0",
     "eslint": "^7.28.0",
     "eslint-config-prettier": "^8.3.0",

package.json

@@ -8,9 +8,8 @@ import { convert } from "./build/widlprocess.js";
 import { getExposedTypes } from "./build/expose.js";
 import { getDeprecationData, getRemovalData } from "./build/bcd.js";
 import { createTryRequire } from "./build/utils/require.js";
-import { getIdl } from "./build/webref.js";
-import { getLatestSpecNames } from "./build/browser-specs.js";
 import { getInterfaceElementMergeData } from "./build/webref/elements.js";
+import { getWebidls } from "./build/webref/idl.js";
 
 const require = createRequire(import.meta.url);
 const tryRequire = createTryRequire(import.meta.url);
@@ -112,15 +111,10 @@ async function emitDom() {
     new URL("removedTypes.json", inputFolder)
   ));
   const widlStandardTypes = (
-    await Promise.all(getLatestSpecNames().map(convertWidl))
+    await Promise.all([...(await getWebidls()).entries()].map(convertWidl))
   ).filter((i) => i) as ReturnType<typeof convert>[];
 
-  async function convertWidl(shortName: string) {
-    // Specs that need to fix their syntax, etc.
-    const idl = await getIdl(shortName);
-    if (!idl.trim().length) {
-      return;
-    }
+  async function convertWidl([shortName, idl]: string[]) {
     const commentsMapFilePath = new URL(
       `idl/${shortName}.commentmap.json`,
       inputFolder

src/build.ts

@@ -7,3 +7,12 @@ export function addToArrayMap<T>(
   array.push(value);
   map.set(name, array);
 }
+
+export function addToStringMap(
+  map: Map<string, string>,
+  name: string,
+  value: string
+): void {
+  const old = map.get(name) || "";
+  map.set(name, `${old}\n${value}\n`);
+}

src/build/utils/map.ts

@@ -0,0 +1,17 @@
+function hyphenToCamelCase(name: string) {
+  const camel = name
+    .replace(/^-(\w)/, (_, c) => c)
+    .replace(/-(\w)/g, (_, c) => c.toUpperCase());
+  return camel === "float" ? "_float" : camel;
+}
+
+export function generateWebIdlFromCssProperties(properties: string[]): string {
+  return `partial interface CSSStyleDeclaration {${properties
+    .map(
+      (property) =>
+        `\n  [CEReactions] attribute [LegacyNullToEmptyString] CSSOMString ${hyphenToCamelCase(
+          property
+        )};`
+    )
+    .join("")}\n};`;
+}

src/build/webref.ts

@@ -0,0 +1,22 @@
+import { listAll as listAllIdl } from "@webref/idl";
+import { listAll as listAllCss } from "@webref/css";
+import { generateWebIdlFromCssProperties } from "./css.js";
+import { addToStringMap } from "../utils/map.js";
+
+export async function getWebidls(): Promise<Map<string, string>> {
+  const idl = await listAllIdl();
+  const css = await listAllCss();
+
+  const map = new Map<string, string>();
+  for (const [key, file] of Object.entries(idl)) {
+    const text = await file.text();
+    map.set(key, text);
+  }
+  for (const [key, data] of Object.entries(css)) {
+    const properties = Object.keys(data.properties);
+    if (properties.length) {
+      addToStringMap(map, key, generateWebIdlFromCssProperties(properties));
+    }
+  }
+  return map;
+}

src/build/webref/css.ts

@@ -0,0 +1,6 @@
+declare module "@webref/css" {
+  interface Data {
+    properties: Record<string, unknown>;
+  }
+  function listAll(): Promise<Record<string, Data>>;
+}

src/build/webref/idl.ts

@@ -0,0 +1,6 @@
+declare module "@webref/idl" {
+  interface IDLFile {
+    text(): Promise<string>;
+  }
+  function listAll(): Promise<Record<string, IDLFile>>;
+}