reffy 11.1.0 → 11.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reffy",
-  "version": "11.1.0",
+  "version": "11.2.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",
@@ -46,7 +46,7 @@
     "chai": "4.3.7",
     "mocha": "10.2.0",
     "nock": "13.2.9",
-    "respec": "32.5.0",
+    "respec": "32.5.1",
     "respec-hljs": "2.1.1",
     "rollup": "3.7.4"
   },

package/schemas/browserlib/extract-cssdfn.json

@@ -15,6 +15,7 @@
         "properties": {
           "name": { "$ref": "../common.json#/$defs/cssPropertyName" },
           "value": { "$ref": "../common.json#/$defs/cssValue" },
+          "newValues": { "$ref": "../common.json#/$defs/cssValue" },
           "values": { "$ref": "../common.json#/$defs/cssValues" },
           "styleDeclaration": {
             "type": "array",

package/src/browserlib/extract-dfns.mjs

@@ -260,6 +260,8 @@ export default function (spec, idToHeading = {}) {
       return node;
     })
     .filter(hasValidType)
+    // Exclude IDL terms defined in a block that is flagged as to be excluded
+    .filter(node => !node.closest('.exclude'))
     // When the whole term links to an external spec, the definition is an
     // imported definition. Such definitions are not "real" definitions, let's
     // skip them.

package/src/browserlib/extract-elements.mjs

@@ -216,7 +216,14 @@ export default function (spec) {
       // All elements defined in MathML Core
       // use the MathMLElement interface
       if (shortname === "mathml-core") {
-       elInfo.interface = "MathMLElement" ;
+        elInfo.interface = "MathMLElement" ;
+      }
+      else {
+        const interfaces = [...document.querySelectorAll('dfn[data-dfn-type=interface]')]
+          .filter(el => el.textContent.trim().toLowerCase() === `html${elInfo.name}element`);
+        if (interfaces.length === 1) {
+          elInfo.interface = interfaces[0].textContent.trim();
+        }
       }
       return elInfo;
       });

package/src/lib/post-processor.js

@@ -60,7 +60,8 @@ const modules = {
   events: require('../postprocessing/events'),
   idlnames: require('../postprocessing/idlnames'),
   idlparsed: require('../postprocessing/idlparsed'),
-  annotatelinks: require('../postprocessing/annotate-links')
+  annotatelinks: require('../postprocessing/annotate-links'),
+  patchdfns: require('../postprocessing/patch-dfns')
 };
 
 

package/src/postprocessing/patch-dfns.js

@@ -0,0 +1,40 @@
+/**
+ * Post-processing module that can be used to patch definition extracts,
+ * typically to drop problematic duplicate definitions they may contain.
+ * 
+ * This post-processing module should only be considered as last resort because
+ * it requires manual maintenance over time. Goal is to hardcode things here
+ * only when duplicate terms create actual referencing issues, not to resolve
+ * all duplicate definitions conflicts.
+ *
+ * The module runs at the spec level.
+ */
+
+module.exports = {
+  dependsOn: ['dfns'],
+  input: 'spec',
+  property: 'dfns',
+
+  run: async function (spec, options) {
+    // Note the spec object passed to post-processing modules does not contain
+    // any specific detail on the spec other than the crawled URL, so no direct
+    // way to match spec on its shortname
+    if (spec.crawled && spec.dfns) {
+      // https://github.com/w3c/webref/blob/main/ed/idlpatches/orientation-event.idl.patch
+      if (spec.crawled.includes('/deviceorientation/') ||
+          spec.crawled.includes('/TR/orientation-event/')) {
+        spec.dfns = spec.dfns.filter(dfn =>
+          !dfn.linkingText.includes('PermissionState') &&
+          !dfn.for.includes('PermissionState'));
+      }
+
+      // https://github.com/w3c/webref/blob/main/ed/idlpatches/portals.idl.patch
+      else if (spec.crawled.includes('/portals/')) {
+        spec.dfns = spec.dfns.filter(dfn =>
+          dfn.linkingText[0] !== 'MessageEventSource');
+      }
+    }
+
+    return spec;
+  }
+};