@nulib/clover 4.0.0-beta.0 → 4.0.0

package/dist/core/image-layers.mjs

@@ -0,0 +1,96 @@
+"use client";
+import { readPage } from "./annotation-sets.mjs";
+import { parseAnnotationTarget } from "./annotations.mjs";
+import { choiceKey } from "./choice-key.mjs";
+import { isPainting } from "./painting.mjs";
+import { selectSequence } from "./selectors.mjs";
+import { asArray } from "../lib/asArray.mjs";
+function imageLayers(manifest) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const canvas of selectSequence(manifest).canvases)
+    readLayers(canvas, byId);
+  return [...byId.values()];
+}
+function readLayers(canvas, byId) {
+  asArray(canvas.items).forEach(
+    (page, p) => asArray(page == null ? void 0 : page.items).forEach((painting, a) => {
+      if (!isPainting(painting)) return;
+      const at = parseAnnotationTarget(asArray(painting.target)[0]).rect ?? {
+        x: 0,
+        y: 0,
+        w: Number(canvas.width) || 0,
+        h: Number(canvas.height) || 0
+      };
+      asArray(painting.body).forEach((body, b) => {
+        const choice = (body == null ? void 0 : body.type) === "Choice";
+        const items = choice ? asArray(body.items) : [body];
+        items.forEach((image, i) => {
+          for (const own of asArray(image == null ? void 0 : image.annotations)) {
+            if (!Array.isArray(own == null ? void 0 : own.items) || typeof (image == null ? void 0 : image.id) !== "string")
+              continue;
+            const id = own.id ?? `${image.id}#annotations`;
+            const layer = choice ? {
+              key: choiceKey(canvas.id, painting.id, p, a, b),
+              item: i,
+              image: image.id
+            } : void 0;
+            const entries = readPage(own, id, canvas.id).map((entry) => {
+              const region = imageRegion(entry.annotation, image);
+              const x = Math.round(at.x + region.x * (at.w / region.width));
+              const y = Math.round(at.y + region.y * (at.h / region.height));
+              const w = Math.round(region.w * (at.w / region.width));
+              const h = Math.round(region.h * (at.h / region.height));
+              const target = `${canvas.id}#xywh=${x},${y},${w},${h}`;
+              return {
+                ...entry,
+                canvasId: canvas.id,
+                target: parseAnnotationTarget(target),
+                annotation: { ...entry.annotation, target },
+                ...layer ? { layer } : {}
+              };
+            });
+            if (!entries.length) continue;
+            let set = byId.get(id);
+            if (!set) {
+              set = {
+                id,
+                label: own.label ?? image.label,
+                source: "manifest",
+                entries: []
+              };
+              byId.set(id, set);
+            }
+            set.entries.push(...entries);
+          }
+        });
+      });
+    })
+  );
+}
+function imageRegion(annotation, image) {
+  const width = Number(image.width) || 1;
+  const height = Number(image.height) || 1;
+  const all = { x: 0, y: 0, w: width, h: height, width, height };
+  const target = asArray(annotation == null ? void 0 : annotation.target)[0];
+  const selectors = typeof target === "object" ? asArray(target == null ? void 0 : target.selector) : [];
+  const api = selectors.find((each) => (each == null ? void 0 : each.type) === "ImageApiSelector");
+  const value = typeof (api == null ? void 0 : api.region) === "string" ? api.region : void 0;
+  if (value) {
+    const match = /^(pct:)?([\d.]+),([\d.]+),([\d.]+),([\d.]+)$/.exec(value);
+    if (!match) return all;
+    const [x, y, w, h] = match.slice(2).map(Number);
+    return match[1] ? {
+      x: x / 100 * width,
+      y: y / 100 * height,
+      w: w / 100 * width,
+      h: h / 100 * height,
+      width,
+      height
+    } : { x, y, w, h, width, height };
+  }
+  const rect = parseAnnotationTarget(target).rect;
+  return rect ? { ...rect, width, height } : all;
+}
+export {
+  imageLayers
+};

package/dist/core/items.mjs

@@ -1,6 +1,6 @@
 "use client";
 import { selectSequence } from "./selectors.mjs";
-import { localize } from "./value.mjs";
+import { hrefLangOf, localize } from "./value.mjs";
 import { paintedBodies } from "./painted-bodies.mjs";
 import { asArray } from "../lib/asArray.mjs";
 function paintedType(container) {
@@ -53,7 +53,9 @@ function itemsOfCollection(collection) {
         parts: [part(member)],
         label: member.label,
         summary: member.summary,
-        href: ((_a = asArray(member.homepage)[0]) == null ? void 0 : _a.id) ?? member.id
+        ...typeof member.navDate === "string" ? { navDate: member.navDate } : {},
+        href: ((_a = asArray(member.homepage)[0]) == null ? void 0 : _a.id) ?? member.id,
+        ...hrefLangOf(asArray(member.homepage)[0]) ? { hrefLang: hrefLangOf(asArray(member.homepage)[0]) } : {}
       };
     });
     memberItems.set(collection, items);
@@ -63,7 +65,9 @@ function itemsOfCollection(collection) {
 function itemsOf(resource) {
   if (!resource) return [];
   if (Array.isArray(resource)) {
-    return itemsOfCollection({ items: resource });
+    return itemsOfCollection({
+      items: resource
+    });
   }
   return resource.type === "Collection" ? itemsOfCollection(resource) : itemsOfManifest(resource);
 }

package/dist/core/language-choice.mjs

@@ -0,0 +1,30 @@
+"use client";
+import { languageToRead } from "../i18n/languages.mjs";
+import { localize } from "./value.mjs";
+function startingLanguage(languages, language, picked) {
+  if (picked && languages.includes(picked)) return picked;
+  if (!languages.length) return void 0;
+  const tag = languageToRead(languages, language);
+  return tag === "none" ? languages[0] : tag;
+}
+const keysOf = (value) => value && typeof value === "object" && !Array.isArray(value) ? Object.keys(value).filter(
+  (tag) => tag !== "none" && tag !== "@none" && localize({ [tag]: value[tag] }).text
+) : [];
+function descriptionLanguages(manifest) {
+  if (!manifest) return [];
+  const pairs = [
+    ...Array.isArray(manifest.metadata) ? manifest.metadata : [],
+    manifest.requiredStatement
+  ].filter(Boolean);
+  const maps = [
+    manifest.label,
+    manifest.summary,
+    ...pairs.flatMap((pair) => [pair == null ? void 0 : pair.label, pair == null ? void 0 : pair.value])
+  ];
+  const tags = maps.map(keysOf).filter((each) => each.length > 1);
+  return [...new Set(tags.flat())];
+}
+export {
+  descriptionLanguages,
+  startingLanguage
+};

package/dist/core/link.mjs

@@ -23,6 +23,20 @@ function readLink(annotation) {
   }
   return void 0;
 }
+function readTagSource(annotation) {
+  const motivation = asArray(annotation == null ? void 0 : annotation.motivation);
+  if (!motivation.includes("tagging") && !motivation.includes("identifying"))
+    return void 0;
+  for (const body of bodiesOf(annotation)) {
+    if ((body == null ? void 0 : body.type) === "TextualBody" || typeof (body == null ? void 0 : body.value) === "string")
+      continue;
+    const source = (body == null ? void 0 : body.type) === "SpecificResource" ? body.source : body;
+    const id = typeof source === "string" ? source : source == null ? void 0 : source.id;
+    if (typeof id === "string" && /^https?:\/\//i.test(id)) return { id };
+  }
+  return void 0;
+}
 export {
-  readLink
+  readLink,
+  readTagSource
 };

package/dist/core/load.mjs

@@ -84,7 +84,9 @@ async function firstManifest(collection, options, depth = 0) {
     }
     if (item.type === "Collection" && depth < 8) {
       const nested = await withMembers(
-        await toPresentation4(await dereference(item, options)),
+        await toPresentation4(
+          await dereference(item, options)
+        ),
         options
       );
       const found = await firstManifest(nested, options, depth + 1);
@@ -96,7 +98,9 @@ async function firstManifest(collection, options, depth = 0) {
 async function fetchResource(input, { request, signal } = {}) {
   void preloadUpgrader();
   const json = typeof input === "string" ? await fetchJson(request, input.trim(), signal) : input;
-  const resource = await toPresentation4(json);
+  const resource = await toPresentation4(
+    json
+  );
   return resource.type === "Collection" ? withMembers(resource, { request, signal }) : resource;
 }
 async function loadContent(input, options = {}) {
@@ -106,6 +110,7 @@ async function loadContent(input, options = {}) {
   let target;
   let member;
   let annotation;
+  let targets;
   let json;
   const followContentState = async (state) => {
     const { resolveContentState } = await readContentState();
@@ -114,6 +119,7 @@ async function loadContent(input, options = {}) {
     target = resolved.target ?? target;
     member = resolved.manifestId ?? member;
     annotation = resolved.annotation ?? annotation;
+    targets = resolved.targets ?? targets;
     return fetchJson(request, resolved.id, signal);
   };
   if (typeof input === "string") {
@@ -139,9 +145,12 @@ async function loadContent(input, options = {}) {
   (_a = signal == null ? void 0 : signal.throwIfAborted) == null ? void 0 : _a.call(signal);
   switch (resource.type) {
     case "Manifest":
-      return { manifest: resource, target, annotation };
+      return { manifest: resource, target, annotation, targets };
     case "Collection": {
-      const collection = await withMembers(resource, options);
+      const collection = await withMembers(
+        resource,
+        options
+      );
       const pick = options.manifestId ?? member;
       const chosen = pick ? (collection.items ?? []).find(
         (item) => item.id === pick && item.type === "Manifest"
@@ -150,7 +159,7 @@ async function loadContent(input, options = {}) {
       if (!manifest) {
         throw new CloverContentError("The Collection holds no Manifest");
       }
-      return { manifest, collection, target, annotation };
+      return { manifest, collection, target, annotation, targets };
     }
     case "Canvas":
     case "Timeline":

package/dist/core/pages.mjs

@@ -28,6 +28,25 @@ async function upgradePage(json, canvasId = "urn:clover:annotation-page") {
   });
   return ((_a = canvas.items) == null ? void 0 : _a[0]) ?? page;
 }
+function withReference(page, reference) {
+  const own = page;
+  const given = reference;
+  const listed = (value) => Array.isArray(value) ? value : value ? [value] : [];
+  const parts = listed(own.partOf);
+  const told = listed(given.partOf);
+  const partOf = [
+    ...parts.map((part) => ({
+      ...told.find((each) => each.id && each.id === part.id),
+      ...part
+    })),
+    ...told.filter((each) => !parts.some((part) => part.id === each.id))
+  ];
+  return {
+    ...page,
+    ...own.label === void 0 && given.label !== void 0 && { label: given.label },
+    ...partOf.length && { partOf }
+  };
+}
 function embedPage(manifest, canvasId, list, page) {
   let changed = false;
   const items = (manifest.items ?? []).map(
@@ -36,7 +55,7 @@ function embedPage(manifest, canvasId, list, page) {
       const pages = canvas[list].map((existing) => {
         if (existing.id !== page.id || !isReference(existing)) return existing;
         changed = true;
-        return page;
+        return withReference(page, existing);
       });
       return changed ? { ...canvas, [list]: pages } : canvas;
     }

package/dist/core/presentation.mjs

@@ -9,16 +9,18 @@ function isPresentation4(resource) {
 }
 let upgrader = null;
 function preloadUpgrader() {
-  upgrader ?? (upgrader = import("@iiif/parser/presentation-4/upgrader"));
+  upgrader ?? (upgrader = import("@iiif/parser/presentation-4/upgrader").then(
+    ({ upgradePresentation3To4 }) => upgradePresentation3To4
+  ));
   return upgrader;
 }
 async function toPresentation4(resource) {
   if (isPresentation4(resource)) return resource;
-  const [{ upgradeToPresentation4 }, { keepFragments }] = await Promise.all([
+  const [toFour, { upgrade }] = await Promise.all([
     preloadUpgrader(),
-    import("./keep-fragments.mjs")
+    import("./upgrade.mjs")
   ]);
-  return upgradeToPresentation4(keepFragments(resource));
+  return await upgrade(resource, toFour);
 }
 export {
   isPresentation4,

package/dist/core/range-regions.mjs

@@ -0,0 +1,70 @@
+"use client";
+import { CONTENTS_SET_ID, regionEntryId } from "./annotation-sets.mjs";
+import { parseAnnotationTarget } from "./annotations.mjs";
+import { rangeItemTarget } from "./ranges.mjs";
+import { asArray } from "../lib/asArray.mjs";
+const bodiesOf = (label) => label && typeof label === "object" ? Object.entries(label).flatMap(
+  ([language, values]) => asArray(values).filter((value) => typeof value === "string").map((value) => ({
+    value,
+    ...language !== "none" ? { language } : {}
+  }))
+) : typeof label === "string" ? [{ value: label }] : [];
+const regionSets = /* @__PURE__ */ new WeakMap();
+function contentsSet(manifest) {
+  if (!manifest) return null;
+  if (regionSets.has(manifest)) return regionSets.get(manifest);
+  const entries = [];
+  const visited = /* @__PURE__ */ new Set();
+  const walk = (range) => {
+    if (!range || visited.has(range.id ?? range)) return;
+    visited.add(range.id ?? range);
+    const drawn = typeof range.id === "string" && !asArray(range.behavior).includes("no-nav");
+    const bodies = bodiesOf(range.label);
+    const total = asArray(range.items).filter(
+      (item) => (item == null ? void 0 : item.type) !== "Range" && parseAnnotationTarget(rangeItemTarget(item)).id
+    ).length;
+    let index = 0;
+    for (const item of asArray(range.items)) {
+      if ((item == null ? void 0 : item.type) === "Range") {
+        walk(item);
+        continue;
+      }
+      const parsed = parseAnnotationTarget(rangeItemTarget(item));
+      if (!parsed.id) continue;
+      const at = index++;
+      if (!drawn || !parsed.rect) continue;
+      const { x, y, w, h } = parsed.rect;
+      const id = regionEntryId(range.id, at);
+      entries.push({
+        id,
+        setId: CONTENTS_SET_ID,
+        canvasId: parsed.id,
+        target: { id: parsed.id, rect: parsed.rect },
+        motivation: ["highlighting"],
+        bodies,
+        ...total > 1 ? { place: { index: at + 1, total } } : {},
+        annotation: {
+          id,
+          type: "Annotation",
+          motivation: ["highlighting"],
+          // Its text in each language its Range names it in, as the hotspot reads one.
+          ...bodies.length && {
+            body: bodies.map(({ value, language }) => ({
+              type: "TextualBody",
+              value,
+              ...language ? { language } : {}
+            }))
+          },
+          target: `${parsed.id}#xywh=${x},${y},${w},${h}`
+        }
+      });
+    }
+  };
+  asArray(manifest.structures).forEach(walk);
+  const set = entries.length ? { id: CONTENTS_SET_ID, source: "contents", entries } : null;
+  regionSets.set(manifest, set);
+  return set;
+}
+export {
+  contentsSet
+};

package/dist/core/ranges.mjs

@@ -1,15 +1,7 @@
 "use client";
 import { parseAnnotationTarget } from "./annotations.mjs";
 import { asArray } from "../lib/asArray.mjs";
-function parseTime(t) {
-  if (!t) return void 0;
-  const [rawStart, rawEnd] = t.split(",");
-  const start = Number(rawStart);
-  if (rawStart === "" || Number.isNaN(start)) return void 0;
-  if (rawEnd === void 0 || rawEnd === "") return { start };
-  const end = Number(rawEnd);
-  return Number.isNaN(end) ? { start } : { start, end };
-}
+import { parseTime } from "../lib/time.mjs";
 function rangeItemTarget(item) {
   if (typeof item === "string") return restoreFragment(item);
   const json = item;
@@ -17,6 +9,10 @@ function rangeItemTarget(item) {
   return typeof (json == null ? void 0 : json.id) === "string" ? restoreFragment(json.id) : json;
 }
 const restoreFragment = (id) => id.replace(/\/((?:t|xywh)=[^/#]*)$/, "#$1");
+function rangeThumbnail(range) {
+  const first = asArray(range.thumbnail)[0];
+  return first && typeof first === "object" ? { thumbnail: first } : {};
+}
 const memo = /* @__PURE__ */ new WeakMap();
 const NONE = [];
 function chaptersOf(manifest, canvasId, duration) {
@@ -31,11 +27,13 @@ function chaptersOf(manifest, canvasId, duration) {
   const walk = (range) => {
     if (!range || visited.has(range.id ?? range)) return;
     visited.add(range.id ?? range);
+    const listed = !asArray(range.behavior).includes("no-nav");
     for (const item of asArray(range.items)) {
       if ((item == null ? void 0 : item.type) === "Range") {
         walk(item);
         continue;
       }
+      if (!listed) continue;
       const parsed = parseAnnotationTarget(rangeItemTarget(item));
       if (parsed.id.split("#")[0] !== canvasId) continue;
       const time = parseTime(parsed.t);
@@ -43,7 +41,8 @@ function chaptersOf(manifest, canvasId, duration) {
         found.push({
           ...range.id ? { id: range.id } : {},
           label: range.label,
-          ...time
+          ...time,
+          ...rangeThumbnail(range)
         });
     }
   };
@@ -67,6 +66,12 @@ function tableOfContents(manifest) {
   if (!manifest) return NO_TOC;
   const cached = tocs.get(manifest);
   if (cached) return cached;
+  const order = new Map(
+    asArray(manifest.items).map((canvas, index) => [
+      canvas == null ? void 0 : canvas.id,
+      index
+    ])
+  );
   const visited = /* @__PURE__ */ new Set();
   const build = (range) => {
     var _a, _b;
@@ -74,6 +79,7 @@ function tableOfContents(manifest) {
     visited.add(range.id ?? range);
     const children = [];
     const canvasIds = [];
+    const parts = [];
     let first;
     for (const item of asArray(range.items)) {
       if ((item == null ? void 0 : item.type) === "Range") {
@@ -85,6 +91,7 @@ function tableOfContents(manifest) {
         if (!parsed.id) continue;
         first ?? (first = parsed);
         canvasIds.push(parsed.id);
+        parts.push(parsed);
       }
     }
     const behavior = asArray(range.behavior);
@@ -95,12 +102,20 @@ function tableOfContents(manifest) {
       label: range.label,
       canvasId: (start == null ? void 0 : start.id) ?? ((_a = children[0]) == null ? void 0 : _a.canvasId),
       canvasIds: [...new Set(canvasIds)],
+      ...behavior.includes("sequence") ? { sequence: true } : {},
+      ...rangeThumbnail(range),
       children
     };
     const time = parseTime(start == null ? void 0 : start.t);
     if (time) node.time = time;
     else if (!start && ((_b = children[0]) == null ? void 0 : _b.time)) node.time = children[0].time;
     if (start == null ? void 0 : start.rect) node.region = start.rect;
+    const ordered = behavior.includes("sequence") && parts.length > 1 && !parts.some((part) => part.t);
+    if (ordered || worthStepping(parts, order))
+      node.parts = parts.map((part) => ({
+        canvasId: part.id,
+        ...part.rect ? { region: part.rect } : {}
+      }));
     return [node];
   };
   const roots = asArray(manifest.structures).flatMap(
@@ -111,18 +126,37 @@ function tableOfContents(manifest) {
   tocs.set(manifest, result);
   return result;
 }
-function currentContents(nodes, canvasId, time) {
+function worthStepping(parts, order) {
+  if (!parts.length || parts.some((part) => part.t)) return false;
+  if (parts.some((part) => part.rect)) return true;
+  return parts.some(
+    (part, index) => index > 0 && order.get(part.id) !== (order.get(parts[index - 1].id) ?? NaN) + 1
+  );
+}
+function currentContents(nodes, canvasId, time, chosen) {
   let best = null;
-  const walk = (node, depth) => {
+  let inChosen = null;
+  const deeper = (than, node, depth) => !than || depth > than.depth || // The later of two alike; of two sequences, the first, the default.
+  depth === than.depth && !(than.sequence && node.sequence);
+  const walk = (node, depth, within) => {
+    const under = within || node.id === chosen;
     if (canvasId && node.canvasIds.includes(canvasId)) {
-      const within = !node.time || time !== void 0 && time >= node.time.start && (node.time.end === void 0 || time < node.time.end);
-      if (within && (!best || depth >= best.depth))
-        best = { id: node.id, depth };
+      const covers = !node.time || time !== void 0 && time >= node.time.start && (node.time.end === void 0 || time < node.time.end);
+      if (covers) {
+        const found = {
+          id: node.id,
+          depth,
+          ...node.sequence ? { sequence: true } : {}
+        };
+        if (deeper(best, node, depth)) best = found;
+        if (under && deeper(inChosen, node, depth)) inChosen = found;
+      }
     }
-    node.children.forEach((child) => walk(child, depth + 1));
+    node.children.forEach((child) => walk(child, depth + 1, under));
   };
-  nodes.forEach((node) => walk(node, 0));
-  return best ? best.id : null;
+  nodes.forEach((node) => walk(node, 0, false));
+  const result = inChosen ?? best;
+  return result ? result.id : null;
 }
 export {
   chaptersOf,

package/dist/core/region.mjs

@@ -3,11 +3,16 @@ import { parseAnnotationTarget } from "./annotations.mjs";
 import { findImageServiceId } from "../lib/renderer/sources/imageService.mjs";
 import { isPainting } from "./painting.mjs";
 import { asArray } from "../lib/asArray.mjs";
-function regionSource(canvas, rect) {
+function regionSource(canvas, rect, image) {
   for (const page of asArray(canvas == null ? void 0 : canvas.items)) {
     for (const annotation of asArray(page == null ? void 0 : page.items)) {
       if (!isPainting(annotation)) continue;
-      for (const body of asArray(annotation == null ? void 0 : annotation.body)) {
+      const bodies = asArray(annotation == null ? void 0 : annotation.body).flatMap(
+        (body) => (body == null ? void 0 : body.type) === "Choice" ? asArray(body.items).filter(
+          (item, index) => image ? (item == null ? void 0 : item.id) === image : index === 0
+        ) : image && (body == null ? void 0 : body.id) !== image ? [] : [body]
+      );
+      for (const body of bodies) {
         if ((body == null ? void 0 : body.type) !== "Image" || !body.width || !body.height) continue;
         const service = findImageServiceId(body.service);
         if (!service) continue;

package/dist/core/sanitize.mjs

@@ -43,12 +43,97 @@ const MARKDOWN_VALUES = {
   id: [["P", GROUP_ID]],
   "aria-labelledby": [["DIV", GROUP_ID]]
 };
+const BLOCKS = /* @__PURE__ */ new Set([
+  "address",
+  "article",
+  "aside",
+  "blockquote",
+  "dd",
+  "details",
+  "div",
+  "dl",
+  "dt",
+  "fieldset",
+  "figcaption",
+  "figure",
+  "footer",
+  "form",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "header",
+  "hr",
+  "li",
+  "main",
+  "nav",
+  "ol",
+  "p",
+  "pre",
+  "section",
+  "summary",
+  "table",
+  "tbody",
+  "td",
+  "tfoot",
+  "th",
+  "thead",
+  "tr",
+  "ul"
+]);
+function tidy(html) {
+  var _a;
+  if (!html) return html;
+  const box = document.createElement("template");
+  box.innerHTML = html;
+  for (const image of box.content.querySelectorAll("img:not([src])"))
+    image.remove();
+  for (const paragraph of box.content.querySelectorAll("p"))
+    if (!((_a = paragraph.textContent) == null ? void 0 : _a.trim()) && !paragraph.querySelector("img, br"))
+      paragraph.remove();
+  const walker = document.createTreeWalker(box.content, NodeFilter.SHOW_TEXT);
+  for (let node = walker.nextNode(); node; node = walker.nextNode())
+    node.nodeValue = node.nodeValue.replace(/[ \t\n\r\f]{2,}/g, " ");
+  return box.innerHTML.replace(/^[ \t\n\r\f]+|[ \t\n\r\f]+$/g, "");
+}
 let purify = null;
+const titles = /* @__PURE__ */ new WeakMap();
+function nameOfLink(image) {
+  var _a;
+  const link = image.closest("a");
+  if (!(link == null ? void 0 : link.getAttribute("href"))) return void 0;
+  const named = ((_a = link.textContent) == null ? void 0 : _a.trim()) || [...link.querySelectorAll("img")].some(
+    (other) => other.getAttribute("alt")
+  );
+  if (named) return void 0;
+  const title = titles.get(link);
+  if (title) return title;
+  try {
+    const url = new URL(link.getAttribute("href"));
+    return (url.protocol === "mailto:" ? url.pathname : url.host) || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function purifier() {
   if (purify) return purify;
   purify = DOMPurify(window);
+  purify.addHook("uponSanitizeAttribute", (node, data) => {
+    if (node.nodeName === "A" && data.attrName === "title" && data.attrValue.trim())
+      titles.set(node, data.attrValue.trim());
+  });
+  purify.addHook("uponSanitizeElement", (node, data) => {
+    if (data.allowedTags[data.tagName] || !BLOCKS.has(data.tagName)) return;
+    if (node.nodeType !== 1) return;
+    node.prepend(" ");
+    node.append(" ");
+  });
   purify.addHook("afterSanitizeAttributes", (node) => {
     var _a, _b;
+    if (node.nodeName === "IMG" && !node.hasAttribute("alt"))
+      node.setAttribute("alt", nameOfLink(node) ?? "");
     for (const name of ["src", "href"]) {
       const value = (_a = node.getAttribute) == null ? void 0 : _a.call(node, name);
       if (value && !URI.test(value.trim())) node.removeAttribute(name);
@@ -65,7 +150,7 @@ function purifier() {
 }
 function sanitizeHTML(html, { markdown = false } = {}) {
   if (typeof window === "undefined") return html;
-  return purifier().sanitize(html, markdown ? MARKDOWN_CONFIG : CONFIG);
+  return tidy(purifier().sanitize(html, markdown ? MARKDOWN_CONFIG : CONFIG));
 }
 export {
   sanitizeHTML

package/dist/core/save-file.mjs

@@ -0,0 +1,33 @@
+"use client";
+import { cloverFetch } from "./request.mjs";
+function fileName(url) {
+  try {
+    const last = new URL(url).pathname.split("/").filter(Boolean).pop();
+    return last ? decodeURIComponent(last) : "download";
+  } catch {
+    return "download";
+  }
+}
+async function saveFile(url, request) {
+  try {
+    const response = await cloverFetch(request, url, {
+      referrerPolicy: "no-referrer"
+    });
+    if (!response.ok) return false;
+    const href = URL.createObjectURL(await response.blob());
+    const link = document.createElement("a");
+    link.href = href;
+    link.download = fileName(url);
+    document.body.append(link);
+    link.click();
+    link.remove();
+    setTimeout(() => URL.revokeObjectURL(href), 1e4);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  fileName,
+  saveFile
+};