@likecoin/epubcheck-ts 0.3.9 → 0.4.0

package/dist/index.js

@@ -5,6 +5,13 @@ import { unzipSync, strFromU8, gunzipSync } from 'fflate';
 // src/content/validator.ts
 
 // src/messages/messages.ts
+var severityOverrides = /* @__PURE__ */ new Map();
+function setSeverityOverrides(overrides) {
+  severityOverrides = overrides;
+}
+function clearSeverityOverrides() {
+  severityOverrides = /* @__PURE__ */ new Map();
+}
 var MessageDefs = {
   // Package/Container errors (PKG-*)
   PKG_001: {
@@ -1175,10 +1182,15 @@ function formatMessageList() {
 function createMessage(options) {
   const { id, message, location, suggestion, severityOverride } = options;
   const registeredSeverity = getDefaultSeverity(id);
-  if (registeredSeverity === "suppressed" && !severityOverride) {
+  const globalOverride = severityOverrides.get(id);
+  const effectiveOverride = severityOverride ?? globalOverride;
+  if (effectiveOverride === "suppressed") {
     return null;
   }
-  const severity = severityOverride ?? registeredSeverity;
+  if (registeredSeverity === "suppressed" && !effectiveOverride) {
+    return null;
+  }
+  const severity = effectiveOverride ? effectiveOverride : registeredSeverity;
   const result = {
     id,
     severity,
@@ -1198,6 +1210,30 @@ function pushMessage(messages, options) {
     messages.push(msg);
   }
 }
+function parseCustomMessages(content) {
+  const overrides = /* @__PURE__ */ new Map();
+  const validSeverities = /* @__PURE__ */ new Set([
+    "fatal",
+    "error",
+    "warning",
+    "info",
+    "usage",
+    "suppressed"
+  ]);
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    if (trimmed.toLowerCase().startsWith("id	") || trimmed.toLowerCase() === "id") continue;
+    const parts = trimmed.split("	");
+    const id = parts[0]?.trim();
+    const severity = parts[1]?.trim().toLowerCase();
+    if (!id || !severity) continue;
+    if (validSeverities.has(severity)) {
+      overrides.set(id, severity);
+    }
+  }
+  return overrides;
+}
 
 // src/css/validator.ts
 var BLESSED_FONT_TYPES = /* @__PURE__ */ new Set([
@@ -2134,6 +2170,7 @@ var SPECIAL_URL_SCHEMES = /* @__PURE__ */ new Set(["http", "https", "ftp", "ws",
 var CSS_CHARSET_RE = /^@charset\s+"([^"]+)"\s*;/;
 var EPUB_XMLNS_RE = /xmlns:epub\s*=\s*"([^"]*)"/;
 var XHTML_NS = { html: "http://www.w3.org/1999/xhtml" };
+var EPUB_OPS_NS = { epub: "http://www.idpf.org/2007/ops" };
 var EPUB_TYPE_FORBIDDEN_ELEMENTS = /* @__PURE__ */ new Set([
   "head",
   "meta",
@@ -2436,6 +2473,122 @@ var HTML_ENTITIES = /* @__PURE__ */ new Set([
   "thorn",
   "yuml"
 ]);
+var HTML5_ELEMENTS = /* @__PURE__ */ new Set([
+  "a",
+  "abbr",
+  "address",
+  "area",
+  "article",
+  "aside",
+  "audio",
+  "b",
+  "base",
+  "bdi",
+  "bdo",
+  "blockquote",
+  "body",
+  "br",
+  "button",
+  "canvas",
+  "caption",
+  "cite",
+  "code",
+  "col",
+  "colgroup",
+  "data",
+  "datalist",
+  "dd",
+  "del",
+  "details",
+  "dfn",
+  "dialog",
+  "div",
+  "dl",
+  "dt",
+  "em",
+  "embed",
+  "fieldset",
+  "figcaption",
+  "figure",
+  "footer",
+  "form",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "head",
+  "header",
+  "hgroup",
+  "hr",
+  "html",
+  "i",
+  "iframe",
+  "img",
+  "input",
+  "ins",
+  "kbd",
+  "label",
+  "legend",
+  "li",
+  "link",
+  "main",
+  "map",
+  "mark",
+  "math",
+  "menu",
+  "meta",
+  "meter",
+  "nav",
+  "noscript",
+  "object",
+  "ol",
+  "optgroup",
+  "option",
+  "output",
+  "p",
+  "picture",
+  "pre",
+  "progress",
+  "q",
+  "rp",
+  "rt",
+  "ruby",
+  "s",
+  "samp",
+  "script",
+  "search",
+  "section",
+  "select",
+  "slot",
+  "small",
+  "source",
+  "span",
+  "strong",
+  "style",
+  "sub",
+  "summary",
+  "sup",
+  "svg",
+  "table",
+  "tbody",
+  "td",
+  "template",
+  "textarea",
+  "tfoot",
+  "th",
+  "thead",
+  "time",
+  "title",
+  "tr",
+  "track",
+  "u",
+  "ul",
+  "var",
+  "video",
+  "wbr"
+]);
 function isItemFixedLayout(packageDoc, itemId) {
   const spineItem = packageDoc.spine.find((s) => s.idref === itemId);
   if (!spineItem) return false;
@@ -2463,6 +2616,7 @@ var ContentValidator = class {
         }
       }
     }
+    context.contentFeatures = {};
     const overlayDocMap = /* @__PURE__ */ new Map();
     const manifestByPath = /* @__PURE__ */ new Map();
     for (const item of packageDoc.manifest) {
@@ -2659,6 +2813,8 @@ var ContentValidator = class {
       this.validateSvgEpubType(context, path, root);
       this.checkUnknownEpubAttributes(context, path, root);
       this.checkSVGLinkAccessibility(context, path, root);
+      this.checkForeignObjectContent(context, path, root, true);
+      this.checkSVGTitleContent(context, path, root);
       const packageDoc = context.packageDocument;
       if (packageDoc && isItemFixedLayout(packageDoc, manifestItem.id)) {
         const viewBox = this.getAttribute(root, "viewBox");
@@ -2881,21 +3037,24 @@ var ContentValidator = class {
     const hasRemoteResources = result.references.some(
       (ref) => ref.url.startsWith("http://") || ref.url.startsWith("https://")
     );
+    const cssManifestItem = context.packageDocument?.manifest.find(
+      (item) => path.endsWith(`/${item.href}`) || path === item.href
+    );
     if (hasRemoteResources) {
       this.cssWithRemoteResources.add(path);
-      const packageDoc = context.packageDocument;
-      if (packageDoc) {
-        const manifestItem = packageDoc.manifest.find(
-          (item) => path.endsWith(`/${item.href}`) || path === item.href
-        );
-        if (manifestItem && !manifestItem.properties?.includes("remote-resources")) {
-          pushMessage(context.messages, {
-            id: MessageId.OPF_014,
-            message: 'CSS document references remote resources but manifest item is missing "remote-resources" property',
-            location: { path }
-          });
-        }
+      if (cssManifestItem && !cssManifestItem.properties?.includes("remote-resources")) {
+        pushMessage(context.messages, {
+          id: MessageId.OPF_014,
+          message: 'CSS document references remote resources but manifest item is missing "remote-resources" property',
+          location: { path }
+        });
       }
+    } else if (cssManifestItem?.properties?.includes("remote-resources")) {
+      pushMessage(context.messages, {
+        id: MessageId.OPF_018,
+        message: 'The "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found',
+        location: { path }
+      });
     }
     const cssDir = path.includes("/") ? path.substring(0, path.lastIndexOf("/")) : "";
     for (const ref of result.references) {
@@ -3204,9 +3363,19 @@ var ContentValidator = class {
       this.checkAccessibility(context, path, root);
       this.validateImages(context, path, root);
       this.checkUsemapAttribute(context, path, root);
+      if (context.version.startsWith("3")) {
+        this.checkDisallowedDescendants(context, path, root);
+        this.checkMicrodataCoOccurrence(context, path, root);
+        this.checkUnknownElements(context, path, root);
+        this.checkForeignObjectContent(context, path, root, false);
+        this.checkSVGTitleContent(context, path, root);
+      }
       if (context.version.startsWith("3")) {
         this.validateEpubTypes(context, path, root);
       }
+      if (context.version.startsWith("3")) {
+        this.collectFeatures(context, root);
+      }
       this.validateEpubSwitch(context, path, root);
       this.validateEpubTrigger(context, path, root);
       this.validateStyleAttributes(context, path, root);
@@ -3364,8 +3533,15 @@ var ContentValidator = class {
       if (types.includes("toc") && !tocNav) {
         tocNav = nav;
       }
-      if (types.includes("page-list")) pageListCount++;
+      if (types.includes("page-list")) {
+        pageListCount++;
+        if (context.contentFeatures) context.contentFeatures.hasPageList = true;
+      }
       if (types.includes("landmarks")) landmarksCount++;
+      if (types.includes("loi") && context.contentFeatures) context.contentFeatures.hasLOI = true;
+      if (types.includes("lot") && context.contentFeatures) context.contentFeatures.hasLOT = true;
+      if (types.includes("loa") && context.contentFeatures) context.contentFeatures.hasLOA = true;
+      if (types.includes("lov") && context.contentFeatures) context.contentFeatures.hasLOV = true;
     }
     if (!tocNav) {
       pushMessage(context.messages, {
@@ -3405,6 +3581,14 @@ var ContentValidator = class {
       if (!isStandard) {
         this.checkNavFirstChildHeading(context, path, navElem);
       }
+      const flatNavType = types.includes("page-list") ? "page-list" : types.includes("landmarks") ? "landmarks" : null;
+      if (flatNavType && navElem.find(".//html:ol", XHTML_NS).length > 1) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_017,
+          message: `A "${flatNavType}" nav element should contain only a single ol descendant (no nested sublists)`,
+          location: { path }
+        });
+      }
       if (types.includes("landmarks")) {
         this.checkNavLandmarks(context, path, navElem);
       }
@@ -4571,7 +4755,7 @@ var ContentValidator = class {
       const altAttr = this.getAttribute(img, "alt");
       if (altAttr === null) {
         pushMessage(context.messages, {
-          id: MessageId.ACC_005,
+          id: MessageId.ACC_001,
           message: "Image is missing alt attribute",
           location: { path }
         });
@@ -4594,6 +4778,53 @@ var ContentValidator = class {
         });
       }
     }
+    const tables = root.find(".//html:table", XHTML_NS);
+    for (const table of tables) {
+      const tableElem = table;
+      const thCells = tableElem.find(".//html:th", XHTML_NS);
+      if (thCells.length === 0) {
+        pushMessage(context.messages, {
+          id: MessageId.ACC_005,
+          message: 'Table heading cells should be identified by "th" elements for accessibility',
+          location: { path }
+        });
+      }
+      for (const th of thCells) {
+        if (!th.content.trim()) {
+          pushMessage(context.messages, {
+            id: MessageId.ACC_014,
+            message: "Table header cell is empty",
+            location: { path }
+          });
+        }
+      }
+      if (!tableElem.get(".//html:thead", XHTML_NS)) {
+        pushMessage(context.messages, {
+          id: MessageId.ACC_006,
+          message: 'Tables should include a "thead" element for accessibility',
+          location: { path }
+        });
+      }
+      if (!tableElem.get("./html:caption", XHTML_NS)) {
+        pushMessage(context.messages, {
+          id: MessageId.ACC_012,
+          message: 'Table elements should include a "caption" element',
+          location: { path }
+        });
+      }
+    }
+    if (context.packageDocument?.version.startsWith("3.")) {
+      const epubTypeElements = root.find(".//*[@epub:type]", {
+        epub: "http://www.idpf.org/2007/ops"
+      });
+      if (epubTypeElements.length === 0) {
+        pushMessage(context.messages, {
+          id: MessageId.ACC_007,
+          message: 'Content Documents do not use "epub:type" attributes for semantic inflection',
+          location: { path }
+        });
+      }
+    }
   }
   hasSVGLinkAccessibleName(svgElem) {
     const ns = { svg: "http://www.w3.org/2000/svg" };
@@ -4618,6 +4849,46 @@ var ContentValidator = class {
       }
     }
   }
+  collectFeatures(context, root) {
+    const features = context.contentFeatures;
+    if (!features) return;
+    if (!features.hasTable && root.get(".//html:table", XHTML_NS)) {
+      features.hasTable = true;
+    }
+    if (!features.hasFigure && root.get(".//html:figure", XHTML_NS)) {
+      features.hasFigure = true;
+    }
+    if (!features.hasAudio && root.get(".//html:audio", XHTML_NS)) {
+      features.hasAudio = true;
+    }
+    if (!features.hasVideo && root.get(".//html:video", XHTML_NS)) {
+      features.hasVideo = true;
+    }
+    if (!features.hasPageBreak || !features.hasDictionary || !features.hasIndex) {
+      const epubTypeElements = root.find(".//*[@epub:type]", EPUB_OPS_NS);
+      for (const el of epubTypeElements) {
+        const attr = el.attr("type", "epub");
+        if (!attr?.value) continue;
+        const tokens = attr.value.trim().split(/\s+/);
+        if (!features.hasPageBreak && tokens.includes("pagebreak")) {
+          features.hasPageBreak = true;
+        }
+        if (!features.hasDictionary && tokens.includes("dictionary")) {
+          features.hasDictionary = true;
+        }
+        if (!features.hasIndex && tokens.includes("index")) {
+          features.hasIndex = true;
+        }
+        if (features.hasPageBreak && features.hasDictionary && features.hasIndex) break;
+      }
+    }
+    if (!features.hasMicrodata && root.get(".//*[@itemscope]")) {
+      features.hasMicrodata = true;
+    }
+    if (!features.hasRDFa && root.get(".//*[@property]")) {
+      features.hasRDFa = true;
+    }
+  }
   validateImages(context, path, root) {
     const packageDoc = context.packageDocument;
     if (!packageDoc) return;
@@ -4716,41 +4987,30 @@ var ContentValidator = class {
   }
   validateStylesheetLinks(context, path, root) {
     const linkElements = root.find(".//html:link[@rel]", { html: "http://www.w3.org/1999/xhtml" });
-    const stylesheetTitles = /* @__PURE__ */ new Map();
     for (const linkElem of linkElements) {
       const elem = linkElem;
       const relAttr = this.getAttribute(elem, "rel");
-      const titleAttr = this.getAttribute(elem, "title");
-      const hrefAttr = this.getAttribute(elem, "href");
-      if (!relAttr || !hrefAttr) continue;
-      const rel = relAttr.toLowerCase();
-      const rels = rel.split(/\s+/);
-      if (rels.includes("stylesheet")) {
-        const isAlternate = rels.includes("alternate");
-        if (isAlternate && !titleAttr) {
+      if (!relAttr) continue;
+      const rels = relAttr.toLowerCase().split(/\s+/);
+      const classAttr = this.getAttribute(elem, "class");
+      if (classAttr) {
+        const classSet = new Set(classAttr.toLowerCase().split(/\s+/));
+        if (classSet.has("vertical") && classSet.has("horizontal") || classSet.has("day") && classSet.has("night")) {
+          pushMessage(context.messages, {
+            id: MessageId.CSS_005,
+            message: `Conflicting Alt Style Tags found in class attribute: "${classAttr}"`,
+            location: { path }
+          });
+        }
+      }
+      if (rels.includes("stylesheet") && rels.includes("alternate")) {
+        if (!this.getAttribute(elem, "title")) {
           pushMessage(context.messages, {
             id: MessageId.CSS_015,
             message: "Alternate stylesheet must have a title attribute",
             location: { path }
           });
         }
-        if (titleAttr) {
-          const key = `${titleAttr}:${isAlternate ? "alt" : "persistent"}`;
-          const expectedRel = isAlternate ? "alternate" : "persistent";
-          const existing = stylesheetTitles.get(key);
-          if (existing) {
-            if (!existing.has(expectedRel)) {
-              pushMessage(context.messages, {
-                id: MessageId.CSS_005,
-                message: `Stylesheet with title "${titleAttr}" conflicts with another stylesheet with same title`,
-                location: { path }
-              });
-            }
-            existing.add(expectedRel);
-          } else {
-            stylesheetTitles.set(key, /* @__PURE__ */ new Set([expectedRel]));
-          }
-        }
       }
     }
   }
@@ -5744,6 +6004,259 @@ var ContentValidator = class {
     const result = parts.join("/").normalize("NFC");
     return fragment ? `${result}#${fragment}` : result;
   }
+  // ── Schematron-equivalent checks ──────────────────────────────────────────
+  checkDisallowedDescendants(context, path, root) {
+    const pairsByAncestor = /* @__PURE__ */ new Map([
+      ["dfn", ["dfn"]],
+      ["form", ["form"]],
+      ["progress", ["progress"]],
+      ["meter", ["meter"]],
+      ["header", ["header", "footer"]],
+      ["footer", ["footer", "header"]],
+      ["label", ["label"]],
+      ["address", ["address", "header", "footer"]],
+      ["caption", ["table"]],
+      ["audio", ["audio", "video"]],
+      ["video", ["video", "audio"]]
+    ]);
+    for (const [ancestor, descendants] of pairsByAncestor) {
+      try {
+        if (root.find(`.//html:${ancestor}`, XHTML_NS).length === 0) continue;
+      } catch {
+        continue;
+      }
+      for (const descendant of descendants) {
+        try {
+          const matches = root.find(`.//html:${ancestor}//html:${descendant}`, XHTML_NS);
+          for (const el of matches) {
+            pushMessage(context.messages, {
+              id: MessageId.RSC_005,
+              message: `The ${descendant} element must not appear inside ${ancestor} elements`,
+              location: { path, line: el.line }
+            });
+          }
+        } catch {
+        }
+      }
+    }
+    const interactiveExprs = [
+      "html:a",
+      "html:audio[@controls]",
+      "html:button",
+      "html:details",
+      "html:embed",
+      "html:iframe",
+      "html:img[@usemap]",
+      "html:input[not(@type='hidden')]",
+      "html:label",
+      "html:select",
+      "html:textarea",
+      "html:video[@controls]"
+    ];
+    for (const ancestor of ["a", "button"]) {
+      try {
+        if (root.find(`.//html:${ancestor}`, XHTML_NS).length === 0) continue;
+      } catch {
+        continue;
+      }
+      for (const expr of interactiveExprs) {
+        try {
+          const matches = root.find(`.//html:${ancestor}//${expr}`, XHTML_NS);
+          for (const el of matches) {
+            const xmlEl = el;
+            const localName = xmlEl.name.includes(":") ? xmlEl.name.substring(xmlEl.name.indexOf(":") + 1) : xmlEl.name;
+            pushMessage(context.messages, {
+              id: MessageId.RSC_005,
+              message: `The ${localName} element must not appear inside ${ancestor} elements`,
+              location: { path, line: el.line }
+            });
+          }
+        } catch {
+        }
+      }
+    }
+    try {
+      const bdos = root.find(".//html:bdo[not(@dir)]", XHTML_NS);
+      for (const el of bdos) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "The bdo element must have a dir attribute",
+          location: { path, line: el.line }
+        });
+      }
+    } catch {
+    }
+    try {
+      const maps = root.find(".//html:map[@id and @name]", XHTML_NS);
+      for (const el of maps) {
+        const id = this.getAttribute(el, "id");
+        const name = this.getAttribute(el, "name");
+        if (id && name && id !== name) {
+          pushMessage(context.messages, {
+            id: MessageId.RSC_005,
+            message: "The id attribute on the map element must have the same value as the name attribute",
+            location: { path, line: el.line }
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  checkMicrodataCoOccurrence(context, path, root) {
+    try {
+      const els = root.find(
+        ".//html:a[@itemprop and not(@href)] | .//html:area[@itemprop and not(@href)]",
+        XHTML_NS
+      );
+      for (const el of els) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "If the itemprop is specified on an a element, then the href attribute must also be specified",
+          location: { path, line: el.line }
+        });
+      }
+    } catch {
+    }
+    try {
+      const els = root.find(
+        ".//html:iframe[@itemprop and not(@data)] | .//html:embed[@itemprop and not(@data)] | .//html:object[@itemprop and not(@data)]",
+        XHTML_NS
+      );
+      for (const el of els) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "If the itemprop is specified on an iframe, embed or object element, then the data attribute must also be specified",
+          location: { path, line: el.line }
+        });
+      }
+    } catch {
+    }
+    try {
+      const els = root.find(
+        ".//html:audio[@itemprop and not(@src)] | .//html:video[@itemprop and not(@src)]",
+        XHTML_NS
+      );
+      for (const el of els) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "If the itemprop is specified on an video or audio element, then the src attribute must also be specified",
+          location: { path, line: el.line }
+        });
+      }
+    } catch {
+    }
+  }
+  checkUnknownElements(context, path, root) {
+    const XHTML_NS2 = "http://www.w3.org/1999/xhtml";
+    try {
+      const allElements = root.find(".//*");
+      for (const el of allElements) {
+        const xmlEl = el;
+        const ns = xmlEl.namespaceUri;
+        if (ns !== XHTML_NS2) continue;
+        const localName = xmlEl.name.includes(":") ? xmlEl.name.substring(xmlEl.name.indexOf(":") + 1) : xmlEl.name;
+        if (localName.includes("-")) continue;
+        if (!HTML5_ELEMENTS.has(localName)) {
+          pushMessage(context.messages, {
+            id: MessageId.RSC_005,
+            message: `element "${localName}" not allowed here`,
+            location: { path, line: el.line }
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  checkForeignObjectContent(context, path, root, isSVGDoc) {
+    const SVG_NS = { svg: "http://www.w3.org/2000/svg" };
+    const XHTML_URI = "http://www.w3.org/1999/xhtml";
+    const DISALLOWED_FO_CHILDREN = /* @__PURE__ */ new Set(["body", "head", "html", "title"]);
+    let foreignObjects;
+    try {
+      foreignObjects = root.find(".//svg:foreignObject", SVG_NS);
+    } catch {
+      return;
+    }
+    for (const fo of foreignObjects) {
+      const foEl = fo;
+      let children;
+      try {
+        children = foEl.find("./*");
+      } catch {
+        continue;
+      }
+      let bodyCount = 0;
+      for (const child of children) {
+        const childEl = child;
+        const childNs = childEl.namespaceUri;
+        const childLocal = childEl.name.includes(":") ? childEl.name.substring(childEl.name.indexOf(":") + 1) : childEl.name;
+        if (isSVGDoc) {
+          if (childNs !== XHTML_URI) {
+            pushMessage(context.messages, {
+              id: MessageId.RSC_005,
+              message: `element "${childLocal}" not allowed here`,
+              location: { path, line: child.line }
+            });
+            continue;
+          }
+          if (childLocal === "body") {
+            bodyCount++;
+            if (bodyCount > 1) {
+              pushMessage(context.messages, {
+                id: MessageId.RSC_005,
+                message: 'element "body" not allowed here',
+                location: { path, line: child.line }
+              });
+            }
+          } else if (childLocal === "title" || childLocal === "head" || childLocal === "html") {
+            pushMessage(context.messages, {
+              id: MessageId.RSC_005,
+              message: `element "${childLocal}" not allowed here`,
+              location: { path, line: child.line }
+            });
+          }
+        } else if (childNs === XHTML_URI && DISALLOWED_FO_CHILDREN.has(childLocal)) {
+          pushMessage(context.messages, {
+            id: MessageId.RSC_005,
+            message: `element "${childLocal}" not allowed here`,
+            location: { path, line: child.line }
+          });
+        }
+      }
+    }
+  }
+  checkSVGTitleContent(context, path, root) {
+    const SVG_NS = { svg: "http://www.w3.org/2000/svg" };
+    const XHTML_URI = "http://www.w3.org/1999/xhtml";
+    let svgTitles;
+    try {
+      svgTitles = root.find(".//svg:title", SVG_NS);
+    } catch {
+      return;
+    }
+    for (const titleNode of svgTitles) {
+      const titleEl = titleNode;
+      let descendants;
+      try {
+        descendants = titleEl.find(".//*");
+      } catch {
+        continue;
+      }
+      const reportedNamespaces = /* @__PURE__ */ new Set();
+      for (const desc of descendants) {
+        const descEl = desc;
+        const descNs = descEl.namespaceUri;
+        if (descNs && descNs !== XHTML_URI && !reportedNamespaces.has(descNs)) {
+          reportedNamespaces.add(descNs);
+          pushMessage(context.messages, {
+            id: MessageId.RSC_005,
+            message: `elements from namespace "${descNs}" are not allowed`,
+            location: { path, line: desc.line }
+          });
+        }
+      }
+    }
+  }
 };
 
 // src/core/report.ts
@@ -7540,6 +8053,9 @@ var OPFValidator = class {
         }
       }
     }
+    if (this.packageDoc.version.startsWith("3.")) {
+      this.validateAccessibilityMetadata(context, opfPath);
+    }
   }
   /**
    * Build lookup maps for manifest items
@@ -7589,6 +8105,41 @@ var OPFValidator = class {
       }
     }
   }
+  /**
+   * Validate accessibility metadata (ACC-002, ACC-003, ACC-010)
+   */
+  validateAccessibilityMetadata(context, opfPath) {
+    if (!this.packageDoc) return;
+    const metaElements = this.packageDoc.metaElements;
+    const a11yProperties = [
+      "schema:accessMode",
+      "schema:accessibilityFeature",
+      "schema:accessibilityHazard",
+      "schema:accessibilitySummary"
+    ];
+    const hasAnyA11y = metaElements.some((m) => a11yProperties.includes(m.property));
+    if (!hasAnyA11y) {
+      pushMessage(context.messages, {
+        id: MessageId.ACC_003,
+        message: "Publication does not include any accessibility metadata",
+        location: { path: opfPath }
+      });
+    }
+    if (!metaElements.some((m) => m.property === "schema:accessibilityFeature")) {
+      pushMessage(context.messages, {
+        id: MessageId.ACC_002,
+        message: 'Missing "schema:accessibilityFeature" metadata',
+        location: { path: opfPath }
+      });
+    }
+    if (!metaElements.some((m) => m.property === "schema:accessMode")) {
+      pushMessage(context.messages, {
+        id: MessageId.ACC_010,
+        message: 'Missing "schema:accessMode" metadata',
+        location: { path: opfPath }
+      });
+    }
+  }
   /**
    * Validate metadata section
    */
@@ -9955,7 +10506,8 @@ var DEFAULT_OPTIONS = {
   includeUsage: false,
   includeInfo: true,
   maxErrors: 0,
-  locale: "en"
+  locale: "en",
+  customMessages: /* @__PURE__ */ new Map()
 };
 var EpubCheck = class _EpubCheck {
   options;
@@ -9981,6 +10533,9 @@ var EpubCheck = class _EpubCheck {
       files: /* @__PURE__ */ new Map(),
       rootfiles: []
     };
+    if (this.options.customMessages.size > 0) {
+      setSeverityOverrides(this.options.customMessages);
+    }
     try {
       const ocfValidator = new OCFValidator();
       ocfValidator.validate(context);
@@ -9998,6 +10553,7 @@ var EpubCheck = class _EpubCheck {
       }
       const contentValidator = new ContentValidator();
       contentValidator.validate(context, registry, refValidator);
+      this.validateCrossDocumentFeatures(context);
       if (context.packageDocument) {
         this.validateNCX(context, registry);
       }
@@ -10009,6 +10565,8 @@ var EpubCheck = class _EpubCheck {
         id: MessageId.PKG_025,
         message: error instanceof Error ? error.message : "Unknown validation error"
       });
+    } finally {
+      clearSeverityOverrides();
     }
     const elapsedMs = performance.now() - startTime;
     const filteredMessages = context.messages.filter((msg) => {
@@ -10039,6 +10597,76 @@ var EpubCheck = class _EpubCheck {
   get version() {
     return this.options.version;
   }
+  /**
+   * Cross-document feature validation (Pattern B from Java EPUBCheck)
+   */
+  validateCrossDocumentFeatures(context) {
+    const features = context.contentFeatures;
+    if (!features || !context.version.startsWith("3")) return;
+    const profile = context.options.profile;
+    const opfPath = context.opfPath ?? "";
+    if (profile === "edupub") {
+      if (features.hasPageBreak && !features.hasPageList) {
+        pushMessage(context.messages, {
+          id: MessageId.NAV_003,
+          message: 'The Navigation Document must have a page list when content contains page breaks (epub:type="pagebreak")',
+          location: { path: opfPath }
+        });
+      }
+      if (features.hasAudio && !features.hasLOA) {
+        pushMessage(context.messages, {
+          id: MessageId.NAV_005,
+          message: 'Content documents contain "audio" elements but the Navigation Document does not have a listing of audio clips (epub:type="loa")',
+          location: { path: opfPath }
+        });
+      }
+      if (features.hasFigure && !features.hasLOI) {
+        pushMessage(context.messages, {
+          id: MessageId.NAV_006,
+          message: 'Content documents contain "figure" elements but the Navigation Document does not have a listing of figures (epub:type="loi")',
+          location: { path: opfPath }
+        });
+      }
+      if (features.hasTable && !features.hasLOT) {
+        pushMessage(context.messages, {
+          id: MessageId.NAV_007,
+          message: 'Content documents contain "table" elements but the Navigation Document does not have a listing of tables (epub:type="lot")',
+          location: { path: opfPath }
+        });
+      }
+      if (features.hasVideo && !features.hasLOV) {
+        pushMessage(context.messages, {
+          id: MessageId.NAV_008,
+          message: 'Content documents contain "video" elements but the Navigation Document does not have a listing of video clips (epub:type="lov")',
+          location: { path: opfPath }
+        });
+      }
+      if (features.hasMicrodata && !features.hasRDFa) {
+        pushMessage(context.messages, {
+          id: MessageId.HTM_051,
+          message: "Found Microdata but no RDFa; EDUPUB recommends the use of RDFa Lite",
+          location: { path: opfPath }
+        });
+      }
+    }
+    const hasDictType = context.packageDocument?.dcElements.some(
+      (dc) => dc.name === "type" && dc.value === "dictionary"
+    ) ?? false;
+    if (features.hasDictionary && !hasDictType) {
+      pushMessage(context.messages, {
+        id: MessageId.OPF_079,
+        message: 'Dictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary"',
+        location: { path: opfPath }
+      });
+    }
+    if (profile === "dict" && hasDictType && !features.hasDictionary) {
+      pushMessage(context.messages, {
+        id: MessageId.OPF_078,
+        message: 'An EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary")',
+        location: { path: opfPath }
+      });
+    }
+  }
   /**
    * Validate NCX navigation document (EPUB 2 always, EPUB 3 when NCX present)
    */
@@ -10169,6 +10797,6 @@ var EpubCheck = class _EpubCheck {
   }
 };
 
-export { EpubCheck, MessageId, buildReport, countBySeverity, createMessage, filterByPath, filterBySeverity, formatMessageList, formatMessages, getAllMessages, getDefaultSeverity, getMessageInfo, pushMessage, toJSONReport };
+export { EpubCheck, MessageId, buildReport, countBySeverity, createMessage, filterByPath, filterBySeverity, formatMessageList, formatMessages, getAllMessages, getDefaultSeverity, getMessageInfo, parseCustomMessages, pushMessage, toJSONReport };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map