@likecoin/epubcheck-ts 0.5.0 → 0.5.1

package/dist/index.js

@@ -1804,379 +1804,6 @@ var EPUB_SSV_ALL = /* @__PURE__ */ new Set([
   "volume"
 ]);
 
-// src/smil/clock.ts
-var FULL_CLOCK_RE = /^(\d+):([0-5]\d):([0-5]\d)(\.\d+)?$/;
-var PARTIAL_CLOCK_RE = /^([0-5]\d):([0-5]\d)(\.\d+)?$/;
-var TIMECOUNT_RE = /^(\d+(\.\d+)?)(h|min|s|ms)?$/;
-function parseSmilClock(value) {
-  const trimmed = value.trim();
-  const full = FULL_CLOCK_RE.exec(trimmed);
-  if (full) {
-    const hours = Number.parseInt(full[1] ?? "0", 10);
-    const minutes = Number.parseInt(full[2] ?? "0", 10);
-    const seconds = Number.parseInt(full[3] ?? "0", 10);
-    const frac = full[4] ? Number.parseFloat(full[4]) : 0;
-    return hours * 3600 + minutes * 60 + seconds + frac;
-  }
-  const partial = PARTIAL_CLOCK_RE.exec(trimmed);
-  if (partial) {
-    const minutes = Number.parseInt(partial[1] ?? "0", 10);
-    const seconds = Number.parseInt(partial[2] ?? "0", 10);
-    const frac = partial[3] ? Number.parseFloat(partial[3]) : 0;
-    return minutes * 60 + seconds + frac;
-  }
-  const timecount = TIMECOUNT_RE.exec(trimmed);
-  if (timecount) {
-    const num = Number.parseFloat(timecount[1] ?? "0");
-    const unit = timecount[3] ?? "s";
-    switch (unit) {
-      case "h":
-        return num * 3600;
-      case "min":
-        return num * 60;
-      case "s":
-        return num;
-      case "ms":
-        return num / 1e3;
-      default:
-        return NaN;
-    }
-  }
-  return NaN;
-}
-function isValidSmilClock(value) {
-  return !Number.isNaN(parseSmilClock(value));
-}
-
-// src/smil/validator.ts
-var SMIL_NS = { smil: "http://www.w3.org/ns/SMIL" };
-var BLESSED_AUDIO_TYPES = /* @__PURE__ */ new Set(["audio/mpeg", "audio/mp4"]);
-var BLESSED_AUDIO_PATTERN = /^audio\/ogg\s*;\s*codecs=opus$/i;
-function isBlessedAudioType(mimeType) {
-  return BLESSED_AUDIO_TYPES.has(mimeType) || BLESSED_AUDIO_PATTERN.test(mimeType);
-}
-var SMILValidator = class {
-  getAttribute(element, name) {
-    return element.attr(name)?.value ?? null;
-  }
-  getEpubAttribute(element, localName) {
-    return element.attr(localName, "epub")?.value ?? null;
-  }
-  validate(context, path, manifestByPath) {
-    const result = {
-      textReferences: [],
-      referencedDocuments: /* @__PURE__ */ new Set(),
-      hasRemoteResources: false
-    };
-    const data = context.files.get(path);
-    if (!data) return result;
-    const content = typeof data === "string" ? data : new TextDecoder().decode(data);
-    let doc = null;
-    try {
-      doc = XmlDocument.fromString(content);
-    } catch {
-      pushMessage(context.messages, {
-        id: MessageId.RSC_016,
-        message: "Media Overlay document is not well-formed XML",
-        location: { path }
-      });
-      return result;
-    }
-    try {
-      const root = doc.root;
-      this.validateStructure(context, path, root);
-      this.validateAudioElements(context, path, root, manifestByPath, result);
-      this.validateEpubTypes(context, path, root);
-      this.extractTextReferences(path, root, result);
-    } finally {
-      doc.dispose();
-    }
-    return result;
-  }
-  validateStructure(context, path, root) {
-    try {
-      for (const text of root.find(".//smil:seq/smil:text", SMIL_NS)) {
-        pushMessage(context.messages, {
-          id: MessageId.RSC_005,
-          message: "element 'text' not allowed here; expected 'seq' or 'par'",
-          location: { path, line: text.line }
-        });
-      }
-      for (const audio of root.find(".//smil:seq/smil:audio", SMIL_NS)) {
-        pushMessage(context.messages, {
-          id: MessageId.RSC_005,
-          message: "element 'audio' not allowed here; expected 'seq' or 'par'",
-          location: { path, line: audio.line }
-        });
-      }
-    } catch {
-    }
-    try {
-      for (const seq of root.find(".//smil:par/smil:seq", SMIL_NS)) {
-        pushMessage(context.messages, {
-          id: MessageId.RSC_005,
-          message: "element 'seq' not allowed here; expected 'text' or 'audio'",
-          location: { path, line: seq.line }
-        });
-      }
-      const parElements = root.find(".//smil:par", SMIL_NS);
-      for (const par of parElements) {
-        const textChildren = par.find("./smil:text", SMIL_NS);
-        for (let i = 1; i < textChildren.length; i++) {
-          const extra = textChildren[i];
-          if (!extra) continue;
-          pushMessage(context.messages, {
-            id: MessageId.RSC_005,
-            message: "element 'text' not allowed here; only one 'text' element is allowed in 'par'",
-            location: { path, line: extra.line }
-          });
-        }
-      }
-    } catch {
-    }
-    try {
-      const headMetaElements = root.find(".//smil:head/smil:meta", SMIL_NS);
-      for (const meta of headMetaElements) {
-        pushMessage(context.messages, {
-          id: MessageId.RSC_005,
-          message: "element 'meta' not allowed here; expected 'metadata'",
-          location: { path, line: meta.line }
-        });
-      }
-    } catch {
-    }
-  }
-  validateAudioElements(context, path, root, manifestByPath, result) {
-    try {
-      const audioElements = root.find(".//smil:audio", SMIL_NS);
-      for (const audio of audioElements) {
-        const elem = audio;
-        const src = this.getAttribute(elem, "src");
-        if (src) {
-          if (/^https?:\/\//i.test(src)) {
-            result.hasRemoteResources = true;
-          }
-          if (src.includes("#")) {
-            pushMessage(context.messages, {
-              id: MessageId.MED_014,
-              message: `Media overlay audio file URLs must not have a fragment: "${src}"`,
-              location: { path, line: audio.line }
-            });
-          }
-          if (manifestByPath) {
-            const audioPath = this.resolveRelativePath(path, src.split("#")[0] ?? src);
-            const audioItem = manifestByPath.get(audioPath);
-            if (audioItem && !isBlessedAudioType(audioItem.mediaType)) {
-              pushMessage(context.messages, {
-                id: MessageId.MED_005,
-                message: `Media Overlay audio reference "${src}" to non-standard audio type "${audioItem.mediaType}"`,
-                location: { path, line: audio.line }
-              });
-            }
-          }
-        }
-        const clipBegin = this.getAttribute(elem, "clipBegin");
-        const clipEnd = this.getAttribute(elem, "clipEnd");
-        this.checkClipTiming(context, path, audio.line, clipBegin, clipEnd);
-      }
-    } catch {
-    }
-  }
-  checkClipTiming(context, path, line, clipBegin, clipEnd) {
-    if (clipEnd === null) return;
-    const beginStr = clipBegin ?? "0";
-    const start = parseSmilClock(beginStr);
-    const end = parseSmilClock(clipEnd);
-    const location = line != null ? { path, line } : { path };
-    if (clipBegin !== null && Number.isNaN(start)) {
-      pushMessage(context.messages, {
-        id: MessageId.RSC_005,
-        message: `Invalid SMIL clock value "${clipBegin}" in clipBegin attribute`,
-        location
-      });
-    }
-    if (Number.isNaN(end)) {
-      pushMessage(context.messages, {
-        id: MessageId.RSC_005,
-        message: `Invalid SMIL clock value "${clipEnd}" in clipEnd attribute`,
-        location
-      });
-    }
-    if (Number.isNaN(start) || Number.isNaN(end)) return;
-    if (start > end) {
-      pushMessage(context.messages, {
-        id: MessageId.MED_008,
-        message: "The time specified in the clipBegin attribute must not be after clipEnd",
-        location
-      });
-    } else if (start === end) {
-      pushMessage(context.messages, {
-        id: MessageId.MED_009,
-        message: "The time specified in the clipBegin attribute must not be the same as clipEnd",
-        location
-      });
-    }
-  }
-  /**
-   * Validate epub:type attribute values against the EPUB SSV vocabulary.
-   * Only emits OPF-088 (usage) for unknown local names. Prefixed values
-   * from declared vocabularies are allowed.
-   */
-  validateEpubTypes(context, path, root) {
-    try {
-      const epubTypeElements = root.find(".//*[@epub:type]", {
-        epub: "http://www.idpf.org/2007/ops"
-      });
-      for (const elem of epubTypeElements) {
-        const elemTyped = elem;
-        const epubTypeAttr = elemTyped.attr("type", "epub");
-        if (!epubTypeAttr?.value) continue;
-        for (const part of epubTypeAttr.value.split(/\s+/)) {
-          if (!part || part.includes(":")) continue;
-          if (!EPUB_SSV_ALL.has(part)) {
-            pushMessage(context.messages, {
-              id: MessageId.OPF_088,
-              message: `Unrecognized epub:type value "${part}"`,
-              location: { path, line: elem.line }
-            });
-          }
-        }
-      }
-    } catch {
-    }
-  }
-  extractTextReferences(path, root, result) {
-    try {
-      const textElements = root.find(".//smil:text", SMIL_NS);
-      for (const text of textElements) {
-        const src = this.getAttribute(text, "src");
-        if (!src) continue;
-        const hashIndex = src.indexOf("#");
-        const docRef = hashIndex >= 0 ? src.substring(0, hashIndex) : src;
-        const fragment = hashIndex >= 0 ? src.substring(hashIndex + 1) : void 0;
-        const docPath = this.resolveRelativePath(path, docRef);
-        result.textReferences.push({ docPath, fragment, line: text.line });
-        result.referencedDocuments.add(docPath);
-      }
-      const bodyElements = root.find(".//smil:body", SMIL_NS);
-      const seqElements = root.find(".//smil:seq", SMIL_NS);
-      for (const elem of [...bodyElements, ...seqElements]) {
-        const textref = this.getEpubAttribute(elem, "textref");
-        if (!textref) continue;
-        const hashIndex = textref.indexOf("#");
-        const docRef = hashIndex >= 0 ? textref.substring(0, hashIndex) : textref;
-        const fragment = hashIndex >= 0 ? textref.substring(hashIndex + 1) : void 0;
-        const docPath = this.resolveRelativePath(path, docRef);
-        result.textReferences.push({ docPath, fragment, line: elem.line });
-        result.referencedDocuments.add(docPath);
-      }
-    } catch {
-    }
-  }
-  resolveRelativePath(basePath, relativePath) {
-    if (relativePath.startsWith("/") || /^[a-zA-Z]+:/.test(relativePath)) {
-      return relativePath;
-    }
-    const baseDir = basePath.includes("/") ? basePath.substring(0, basePath.lastIndexOf("/")) : "";
-    if (!baseDir) return relativePath;
-    const segments = `${baseDir}/${relativePath}`.split("/");
-    const resolved = [];
-    for (const seg of segments) {
-      if (seg === "..") {
-        resolved.pop();
-      } else if (seg !== ".") {
-        resolved.push(seg);
-      }
-    }
-    return resolved.join("/");
-  }
-};
-
-// src/opf/types.ts
-var CORE_MEDIA_TYPES = /* @__PURE__ */ new Set([
-  // Image types
-  "image/gif",
-  "image/jpeg",
-  "image/png",
-  "image/svg+xml",
-  "image/webp",
-  // Audio types
-  "audio/mpeg",
-  "audio/mp4",
-  "audio/ogg",
-  // CSS
-  "text/css",
-  // Fonts
-  "font/otf",
-  "font/ttf",
-  "font/woff",
-  "font/woff2",
-  "application/font-sfnt",
-  // deprecated alias for font/otf, font/ttf
-  "application/font-woff",
-  // deprecated alias for font/woff
-  "application/vnd.ms-opentype",
-  // deprecated alias
-  // Content documents
-  "application/xhtml+xml",
-  "application/x-dtbncx+xml",
-  // NCX
-  // JavaScript (EPUB 3)
-  "text/javascript",
-  "application/javascript",
-  // Media overlays
-  "application/smil+xml",
-  // PLS (Pronunciation Lexicon)
-  "application/pls+xml"
-]);
-function isCoreMediaType(mimeType) {
-  if (CORE_MEDIA_TYPES.has(mimeType)) return true;
-  if (mimeType.startsWith("video/")) return true;
-  if (/^audio\/ogg\s*;\s*codecs=opus$/i.test(mimeType)) return true;
-  const semicolonIndex = mimeType.indexOf(";");
-  if (semicolonIndex >= 0) {
-    const baseType = mimeType.substring(0, semicolonIndex).trim();
-    if (CORE_MEDIA_TYPES.has(baseType)) return true;
-    if (baseType.startsWith("video/")) return true;
-  }
-  return false;
-}
-var ITEM_PROPERTIES = /* @__PURE__ */ new Set([
-  "cover-image",
-  "data-nav",
-  "dictionary",
-  "glossary",
-  "index",
-  "mathml",
-  "nav",
-  "remote-resources",
-  "scripted",
-  "search-key-map",
-  "svg",
-  "switch"
-]);
-var LINK_PROPERTIES = /* @__PURE__ */ new Set(["onix", "marc21xml-record", "mods-record", "xmp-record"]);
-var SPINE_PROPERTIES = /* @__PURE__ */ new Set([
-  "page-spread-left",
-  "page-spread-right",
-  "rendition:spread-none",
-  "rendition:spread-landscape",
-  "rendition:spread-portrait",
-  "rendition:spread-both",
-  "rendition:spread-auto",
-  "rendition:page-spread-center",
-  "rendition:layout-reflowable",
-  "rendition:layout-pre-paginated",
-  "rendition:orientation-auto",
-  "rendition:orientation-landscape",
-  "rendition:orientation-portrait",
-  "rendition:flow-auto",
-  "rendition:flow-paginated",
-  "rendition:flow-scrolled-continuous",
-  "rendition:flow-scrolled-doc",
-  "rendition:align-x-center"
-]);
-
 // src/references/url.ts
 function parseURL(urlString) {
   const hashIndex = urlString.indexOf("#");
@@ -2248,6 +1875,50 @@ function resolveManifestHref(opfDir, href) {
   }
 }
 
+// src/smil/clock.ts
+var FULL_CLOCK_RE = /^(\d+):([0-5]\d):([0-5]\d)(\.\d+)?$/;
+var PARTIAL_CLOCK_RE = /^([0-5]\d):([0-5]\d)(\.\d+)?$/;
+var TIMECOUNT_RE = /^(\d+(\.\d+)?)(h|min|s|ms)?$/;
+function parseSmilClock(value) {
+  const trimmed = value.trim();
+  const full = FULL_CLOCK_RE.exec(trimmed);
+  if (full) {
+    const hours = Number.parseInt(full[1] ?? "0", 10);
+    const minutes = Number.parseInt(full[2] ?? "0", 10);
+    const seconds = Number.parseInt(full[3] ?? "0", 10);
+    const frac = full[4] ? Number.parseFloat(full[4]) : 0;
+    return hours * 3600 + minutes * 60 + seconds + frac;
+  }
+  const partial = PARTIAL_CLOCK_RE.exec(trimmed);
+  if (partial) {
+    const minutes = Number.parseInt(partial[1] ?? "0", 10);
+    const seconds = Number.parseInt(partial[2] ?? "0", 10);
+    const frac = partial[3] ? Number.parseFloat(partial[3]) : 0;
+    return minutes * 60 + seconds + frac;
+  }
+  const timecount = TIMECOUNT_RE.exec(trimmed);
+  if (timecount) {
+    const num = Number.parseFloat(timecount[1] ?? "0");
+    const unit = timecount[3] ?? "s";
+    switch (unit) {
+      case "h":
+        return num * 3600;
+      case "min":
+        return num * 60;
+      case "s":
+        return num;
+      case "ms":
+        return num / 1e3;
+      default:
+        return NaN;
+    }
+  }
+  return NaN;
+}
+function isValidSmilClock(value) {
+  return !Number.isNaN(parseSmilClock(value));
+}
+
 // src/types.ts
 var EPUB_VERSIONS = ["2.0", "3.0", "3.1", "3.2", "3.3"];
 
@@ -2696,6 +2367,91 @@ function parseCollections(xml) {
   return roots;
 }
 
+// src/opf/types.ts
+var CORE_MEDIA_TYPES = /* @__PURE__ */ new Set([
+  // Image types
+  "image/gif",
+  "image/jpeg",
+  "image/png",
+  "image/svg+xml",
+  "image/webp",
+  // Audio types
+  "audio/mpeg",
+  "audio/mp4",
+  "audio/ogg",
+  // CSS
+  "text/css",
+  // Fonts
+  "font/otf",
+  "font/ttf",
+  "font/woff",
+  "font/woff2",
+  "application/font-sfnt",
+  // deprecated alias for font/otf, font/ttf
+  "application/font-woff",
+  // deprecated alias for font/woff
+  "application/vnd.ms-opentype",
+  // deprecated alias
+  // Content documents
+  "application/xhtml+xml",
+  "application/x-dtbncx+xml",
+  // NCX
+  // JavaScript (EPUB 3)
+  "text/javascript",
+  "application/javascript",
+  // Media overlays
+  "application/smil+xml",
+  // PLS (Pronunciation Lexicon)
+  "application/pls+xml"
+]);
+function isCoreMediaType(mimeType) {
+  if (CORE_MEDIA_TYPES.has(mimeType)) return true;
+  if (mimeType.startsWith("video/")) return true;
+  if (/^audio\/ogg\s*;\s*codecs=opus$/i.test(mimeType)) return true;
+  const semicolonIndex = mimeType.indexOf(";");
+  if (semicolonIndex >= 0) {
+    const baseType = mimeType.substring(0, semicolonIndex).trim();
+    if (CORE_MEDIA_TYPES.has(baseType)) return true;
+    if (baseType.startsWith("video/")) return true;
+  }
+  return false;
+}
+var ITEM_PROPERTIES = /* @__PURE__ */ new Set([
+  "cover-image",
+  "data-nav",
+  "dictionary",
+  "glossary",
+  "index",
+  "mathml",
+  "nav",
+  "remote-resources",
+  "scripted",
+  "search-key-map",
+  "svg",
+  "switch"
+]);
+var LINK_PROPERTIES = /* @__PURE__ */ new Set(["onix", "marc21xml-record", "mods-record", "xmp-record"]);
+var SPINE_PROPERTIES = /* @__PURE__ */ new Set([
+  "page-spread-left",
+  "page-spread-right",
+  "rendition:spread-none",
+  "rendition:spread-landscape",
+  "rendition:spread-portrait",
+  "rendition:spread-both",
+  "rendition:spread-auto",
+  "rendition:page-spread-center",
+  "rendition:layout-reflowable",
+  "rendition:layout-pre-paginated",
+  "rendition:orientation-auto",
+  "rendition:orientation-landscape",
+  "rendition:orientation-portrait",
+  "rendition:flow-auto",
+  "rendition:flow-paginated",
+  "rendition:flow-scrolled-continuous",
+  "rendition:flow-scrolled-doc",
+  "rendition:align-x-center"
+]);
+
 // src/opf/validator.ts
 var DEPRECATED_MEDIA_TYPES = /* @__PURE__ */ new Set([
   "text/x-oeb1-document",
@@ -5257,6 +5013,251 @@ function isValidW3CDateFormat(dateStr) {
   return false;
 }
 
+// src/smil/validator.ts
+var SMIL_NS = { smil: "http://www.w3.org/ns/SMIL" };
+var BLESSED_AUDIO_TYPES = /* @__PURE__ */ new Set(["audio/mpeg", "audio/mp4"]);
+var BLESSED_AUDIO_PATTERN = /^audio\/ogg\s*;\s*codecs=opus$/i;
+function isBlessedAudioType(mimeType) {
+  return BLESSED_AUDIO_TYPES.has(mimeType) || BLESSED_AUDIO_PATTERN.test(mimeType);
+}
+var SMILValidator = class {
+  getAttribute(element, name) {
+    return element.attr(name)?.value ?? null;
+  }
+  getEpubAttribute(element, localName) {
+    return element.attr(localName, "epub")?.value ?? null;
+  }
+  validate(context, path, manifestByPath) {
+    const result = {
+      textReferences: [],
+      referencedDocuments: /* @__PURE__ */ new Set(),
+      hasRemoteResources: false
+    };
+    const data = context.files.get(path);
+    if (!data) return result;
+    const content = typeof data === "string" ? data : new TextDecoder().decode(data);
+    let doc = null;
+    try {
+      doc = XmlDocument.fromString(content);
+    } catch {
+      pushMessage(context.messages, {
+        id: MessageId.RSC_016,
+        message: "Media Overlay document is not well-formed XML",
+        location: { path }
+      });
+      return result;
+    }
+    try {
+      const root = doc.root;
+      this.validateStructure(context, path, root);
+      this.validateAudioElements(context, path, root, manifestByPath, result);
+      this.validateEpubTypes(context, path, root);
+      this.extractTextReferences(path, root, result);
+    } finally {
+      doc.dispose();
+    }
+    return result;
+  }
+  validateStructure(context, path, root) {
+    try {
+      for (const text of root.find(".//smil:seq/smil:text", SMIL_NS)) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "element 'text' not allowed here; expected 'seq' or 'par'",
+          location: { path, line: text.line }
+        });
+      }
+      for (const audio of root.find(".//smil:seq/smil:audio", SMIL_NS)) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "element 'audio' not allowed here; expected 'seq' or 'par'",
+          location: { path, line: audio.line }
+        });
+      }
+    } catch {
+    }
+    try {
+      for (const seq of root.find(".//smil:par/smil:seq", SMIL_NS)) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "element 'seq' not allowed here; expected 'text' or 'audio'",
+          location: { path, line: seq.line }
+        });
+      }
+      const parElements = root.find(".//smil:par", SMIL_NS);
+      for (const par of parElements) {
+        const textChildren = par.find("./smil:text", SMIL_NS);
+        for (let i = 1; i < textChildren.length; i++) {
+          const extra = textChildren[i];
+          if (!extra) continue;
+          pushMessage(context.messages, {
+            id: MessageId.RSC_005,
+            message: "element 'text' not allowed here; only one 'text' element is allowed in 'par'",
+            location: { path, line: extra.line }
+          });
+        }
+      }
+    } catch {
+    }
+    try {
+      const headMetaElements = root.find(".//smil:head/smil:meta", SMIL_NS);
+      for (const meta of headMetaElements) {
+        pushMessage(context.messages, {
+          id: MessageId.RSC_005,
+          message: "element 'meta' not allowed here; expected 'metadata'",
+          location: { path, line: meta.line }
+        });
+      }
+    } catch {
+    }
+  }
+  validateAudioElements(context, path, root, manifestByPath, result) {
+    try {
+      const audioElements = root.find(".//smil:audio", SMIL_NS);
+      for (const audio of audioElements) {
+        const elem = audio;
+        const src = this.getAttribute(elem, "src");
+        if (src) {
+          if (isRemoteURL(src)) {
+            result.hasRemoteResources = true;
+          }
+          if (src.includes("#")) {
+            pushMessage(context.messages, {
+              id: MessageId.MED_014,
+              message: `Media overlay audio file URLs must not have a fragment: "${src}"`,
+              location: { path, line: audio.line }
+            });
+          }
+          if (manifestByPath) {
+            const audioPath = this.resolveRelativePath(path, src.split("#")[0] ?? src);
+            const audioItem = manifestByPath.get(audioPath);
+            if (audioItem && !isBlessedAudioType(audioItem.mediaType)) {
+              pushMessage(context.messages, {
+                id: MessageId.MED_005,
+                message: `Media Overlay audio reference "${src}" to non-standard audio type "${audioItem.mediaType}"`,
+                location: { path, line: audio.line }
+              });
+            }
+          }
+        }
+        const clipBegin = this.getAttribute(elem, "clipBegin");
+        const clipEnd = this.getAttribute(elem, "clipEnd");
+        this.checkClipTiming(context, path, audio.line, clipBegin, clipEnd);
+      }
+    } catch {
+    }
+  }
+  checkClipTiming(context, path, line, clipBegin, clipEnd) {
+    if (clipEnd === null) return;
+    const beginStr = clipBegin ?? "0";
+    const start = parseSmilClock(beginStr);
+    const end = parseSmilClock(clipEnd);
+    const location = line != null ? { path, line } : { path };
+    if (clipBegin !== null && Number.isNaN(start)) {
+      pushMessage(context.messages, {
+        id: MessageId.RSC_005,
+        message: `Invalid SMIL clock value "${clipBegin}" in clipBegin attribute`,
+        location
+      });
+    }
+    if (Number.isNaN(end)) {
+      pushMessage(context.messages, {
+        id: MessageId.RSC_005,
+        message: `Invalid SMIL clock value "${clipEnd}" in clipEnd attribute`,
+        location
+      });
+    }
+    if (Number.isNaN(start) || Number.isNaN(end)) return;
+    if (start > end) {
+      pushMessage(context.messages, {
+        id: MessageId.MED_008,
+        message: "The time specified in the clipBegin attribute must not be after clipEnd",
+        location
+      });
+    } else if (start === end) {
+      pushMessage(context.messages, {
+        id: MessageId.MED_009,
+        message: "The time specified in the clipBegin attribute must not be the same as clipEnd",
+        location
+      });
+    }
+  }
+  /**
+   * Validate epub:type attribute values against the EPUB SSV vocabulary.
+   * Only emits OPF-088 (usage) for unknown local names. Prefixed values
+   * from declared vocabularies are allowed.
+   */
+  validateEpubTypes(context, path, root) {
+    try {
+      const epubTypeElements = root.find(".//*[@epub:type]", {
+        epub: "http://www.idpf.org/2007/ops"
+      });
+      for (const elem of epubTypeElements) {
+        const elemTyped = elem;
+        const epubTypeAttr = elemTyped.attr("type", "epub");
+        if (!epubTypeAttr?.value) continue;
+        for (const part of epubTypeAttr.value.split(/\s+/)) {
+          if (!part || part.includes(":")) continue;
+          if (!EPUB_SSV_ALL.has(part)) {
+            pushMessage(context.messages, {
+              id: MessageId.OPF_088,
+              message: `Unrecognized epub:type value "${part}"`,
+              location: { path, line: elem.line }
+            });
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  extractTextReferences(path, root, result) {
+    try {
+      const textElements = root.find(".//smil:text", SMIL_NS);
+      for (const text of textElements) {
+        const src = this.getAttribute(text, "src");
+        if (!src) continue;
+        const hashIndex = src.indexOf("#");
+        const docRef = hashIndex >= 0 ? src.substring(0, hashIndex) : src;
+        const fragment = hashIndex >= 0 ? src.substring(hashIndex + 1) : void 0;
+        const docPath = this.resolveRelativePath(path, docRef);
+        result.textReferences.push({ docPath, fragment, line: text.line });
+        result.referencedDocuments.add(docPath);
+      }
+      const bodyElements = root.find(".//smil:body", SMIL_NS);
+      const seqElements = root.find(".//smil:seq", SMIL_NS);
+      for (const elem of [...bodyElements, ...seqElements]) {
+        const textref = this.getEpubAttribute(elem, "textref");
+        if (!textref) continue;
+        const hashIndex = textref.indexOf("#");
+        const docRef = hashIndex >= 0 ? textref.substring(0, hashIndex) : textref;
+        const fragment = hashIndex >= 0 ? textref.substring(hashIndex + 1) : void 0;
+        const docPath = this.resolveRelativePath(path, docRef);
+        result.textReferences.push({ docPath, fragment, line: elem.line });
+        result.referencedDocuments.add(docPath);
+      }
+    } catch {
+    }
+  }
+  resolveRelativePath(basePath, relativePath) {
+    const decoded = tryDecodeUriComponent(relativePath);
+    if (decoded.startsWith("/") || /^[a-zA-Z]+:/.test(decoded)) {
+      return decoded.normalize("NFC");
+    }
+    const baseDir = basePath.includes("/") ? basePath.substring(0, basePath.lastIndexOf("/")) : "";
+    if (!baseDir) return decoded.normalize("NFC");
+    const segments = `${baseDir}/${decoded}`.split("/");
+    const resolved = [];
+    for (const seg of segments) {
+      if (seg === "..") {
+        resolved.pop();
+      } else if (seg !== ".") {
+        resolved.push(seg);
+      }
+    }
+    return resolved.join("/").normalize("NFC");
+  }
+};
+
 // src/references/types.ts
 var PUBLICATION_RESOURCE_TYPES = /* @__PURE__ */ new Set([
   "generic" /* GENERIC */,
@@ -7724,6 +7725,7 @@ var ContentValidator = class {
     }
   }
   checkUsemapAttribute(context, path, root) {
+    if (context.version === "2.0") return;
     try {
       const elements = root.find(".//html:*[@usemap]", XHTML_NS);
       for (const elem of elements) {
@@ -9838,8 +9840,8 @@ var NCXValidator = class {
       const hashIdx = src.indexOf("#");
       const srcBase = hashIdx >= 0 ? src.substring(0, hashIdx) : src;
       const fragment = hashIdx >= 0 ? src.substring(hashIdx + 1) : "";
-      const isRemote = srcBase.startsWith("http://") || srcBase.startsWith("https://");
-      const fullPath = isRemote ? srcBase : resolvePath(ncxPath, srcBase);
+      const isRemote = isRemoteURL(srcBase);
+      const fullPath = isRemote ? srcBase : resolvePath(ncxPath, tryDecodeUriComponent(srcBase)).normalize("NFC");
       if (!context.files.has(fullPath) && !isRemote) {
         const line = contentElem.line;
         pushMessage(context.messages, {