reffy 18.2.0 → 18.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reffy",
-  "version": "18.2.0",
+  "version": "18.3.0",
   "description": "W3C/WHATWG spec dependencies exploration companion. Features a short set of tools to study spec references as well as WebIDL term definitions and references found in W3C specifications.",
   "repository": {
     "type": "git",
@@ -35,18 +35,18 @@
   "dependencies": {
     "ajv": "8.17.1",
     "ajv-formats": "3.0.1",
-    "commander": "13.0.0",
+    "commander": "13.1.0",
     "fetch-filecache-for-crawling": "5.1.1",
     "puppeteer": "24.1.0",
     "semver": "^7.3.5",
-    "web-specs": "3.34.0",
+    "web-specs": "3.35.0",
     "webidl2": "24.4.1"
   },
   "devDependencies": {
     "mocha": "11.0.1",
     "respec": "35.2.2",
     "respec-hljs": "2.1.1",
-    "rollup": "4.30.1",
+    "rollup": "4.31.0",
     "undici": "^7.0.0"
   },
   "overrides": {

package/schemas/browserlib/extract-cssdfn.json

@@ -18,6 +18,7 @@
           "value": { "$ref": "../common.json#/$defs/cssValue" },
           "newValues": { "$ref": "../common.json#/$defs/cssValue" },
           "values": { "$ref": "../common.json#/$defs/cssValues" },
+          "legacyAliasOf": { "$ref": "../common.json#/$defs/cssPropertyName" },
           "styleDeclaration": {
             "type": "array",
             "items": { "type": "string" },

package/schemas/browserlib/extract-dfns.json

@@ -33,6 +33,8 @@
 
           "element", "element-state", "element-attr", "attr-value",
 
+          "cddl-module", "cddl-type", "cddl-parameter", "cddl-key", "cddl-value",
+
           "scheme", "http-header",
 
           "grammar", "abstract-op", "dfn"

package/src/browserlib/extract-cssdfn.mjs

@@ -18,13 +18,17 @@ export default function () {
   const warnings = [];
 
   const res = {
-    // Properties are always defined in dedicated tables in modern CSS specs
-    properties: extractDfns({
-      selector: 'table.propdef:not(.attrdef)',
-      extractor: extractTableDfns,
-      duplicates: 'merge',
-      warnings
-    }),
+    // Properties are always defined in dedicated tables in modern CSS specs,
+    // Legacy properties are always defined in prose in a dfn with a nearby
+    // reference to "legacy name alias"
+    properties: []
+      .concat(extractDfns({
+        selector: 'table.propdef:not(.attrdef)',
+        extractor: extractTableDfns,
+        duplicates: 'merge',
+        warnings
+      }))
+      .concat(extractLegacyProperties(document)),
 
     // At-rules, selectors, functions and types are defined through dfns with
     // the right "data-dfn-type" attribute
@@ -826,3 +830,56 @@ const extractProductionRules = root => {
 
   return rules;
 }
+
+
+/**
+ * Extract legacy alias relationships, looking for occurrences of the term
+ * "legacy name alias".
+ *
+ * Next to it, there should be:
+ * 1. a dfn for a property followed by a reference to the aliased property; or
+ * 2. a table with two columns: dfns in the first column, references to the
+ * aliased properties in the second column.
+ */
+const extractLegacyProperties = doc =>
+  [...doc.querySelectorAll('a[href$="#legacy-name-alias"]')]
+    .map(el => el.parentElement)
+    .map(el => {
+      const dfn = el.querySelector('dfn[data-dfn-type="property"]');
+      const alias = el.querySelector('a[data-link-type="property"]');
+      if (dfn && alias) {
+        // Aliasing is defined in prose
+        return {
+          name: normalize(dfn.textContent),
+          href: getAbsoluteUrl(dfn),
+          legacyAliasOf: normalize(alias.textContent)
+        };
+      }
+      else {
+        // Look for a compat table right after the paragraph
+        const table = el.nextElementSibling;
+        if (table?.nodeName !== 'TABLE') {
+          return null;
+        }
+        if ([...table.querySelectorAll('thead > tr > th')].length !== 2) {
+          return null;
+        }
+        return [...table.querySelectorAll('tbody > tr')]
+          .map(row => {
+            const dfn = row.querySelector('dfn[data-dfn-type="property"]');
+            const alias = row.querySelector('a[data-link-type="property"]');
+            if (dfn && alias) {
+              return {
+                name: normalize(dfn.textContent),
+                href: getAbsoluteUrl(dfn),
+                legacyAliasOf: normalize(alias.textContent)
+              };
+            }
+            else {
+              return null;
+            }
+          });
+      }
+    })
+    .flat()
+    .filter(prop => !!prop);