feat: report unknown 'epub:type' values in overlays as USAGE only (#1171

)

Matches `epub:type` checking in Media Overlays documents to Content Documents (`USAGE` message for unknown values from structure vocab).

src/main/java/com/adobe/epubcheck/overlay/OverlayHandler.java

@@ -12,6 +12,8 @@
 import com.adobe.epubcheck.util.EpubConstants;
 import com.adobe.epubcheck.util.HandlerUtil;
 import com.adobe.epubcheck.util.PathUtil;
+import com.adobe.epubcheck.vocab.Property;
+import com.adobe.epubcheck.vocab.AggregateVocab;
 import com.adobe.epubcheck.vocab.StructureVocab;
 import com.adobe.epubcheck.vocab.Vocab;
 import com.adobe.epubcheck.vocab.VocabUtil;
@@ -25,10 +27,10 @@ public class OverlayHandler implements XMLHandler
 {
 
   private static Map<String, Vocab> RESERVED_VOCABS = ImmutableMap.<String, Vocab> of("",
-      StructureVocab.VOCAB);
+	      AggregateVocab.of(StructureVocab.VOCAB, StructureVocab.UNCHECKED_VOCAB));
   private static Map<String, Vocab> KNOWN_VOCAB_URIS = ImmutableMap.of();
   private static Set<String> DEFAULT_VOCAB_URIS = ImmutableSet.of(StructureVocab.URI);
-
+  
   private final ValidationContext context;
   private final String path;
   private final Report report;
@@ -85,8 +87,20 @@ else if (name.equals("body") || name.equals("par"))
 
   private void checkType(String type)
   {
-    VocabUtil.parsePropertyList(type, vocabs, context,
+    Set<Property> propList = VocabUtil.parsePropertyList(type, vocabs, context,
         EPUBLocation.create(path, parser.getLineNumber(), parser.getColumnNumber()));
+
+    // Check unrecognized properties from the structure vocab  
+    for (Property property : propList)
+    {
+      if (StructureVocab.URI.equals(property.getVocabURI())) try
+      {
+        property.toEnum();
+      } catch (UnsupportedOperationException ex)
+      {
+        report.message(MessageId.OPF_088, parser.getLocation(), property.getName());
+      }
+    }
   }
 
   private void processSrc(XMLElement e)

src/test/resources/epub3/mediaoverlays-smil-document.feature

@@ -93,8 +93,8 @@ Feature: EPUB 3 ▸ Media Overlays ▸ SMIL Document Checks
     And the message contains 'Undeclared prefix: "my"'
     And no other errors or warnings are reported
 
-  Scenario: Report an unknown epub:type property in the default vocabulary
-    When checking document 'epubtype-unknown-error.smil'
-    Then error OPF-027 is reported
+  Scenario: Allow unknown epub:type properties in the default vocabulary
+    Given the reporting level set to usage
+    When checking document 'epubtype-unknown-usage.smil'
+    Then usage OPF-088 is reported
     And no other errors or warnings are reported
-