cozy-iiif 0.3.0 → 0.4.0

package/README.md

@@ -135,6 +135,9 @@ console.log(image.getRegionURL(bounds));
 // With custom minimum shorted dimension
 console.log(image.getRegionURL(bounds, 800));
 
+// Full image with custom minimum shorted dimension
+console.log(image.getImageURL(800));
+
 // Resolves the actual image pixel size from the info.json
 // or the image file (which may **differ**) from the canvas size!
 console.log(image.getPixelSize());

package/dist/core/canvas.d.ts

@@ -1,6 +1,5 @@
 import { Canvas } from '@iiif/presentation-3';
 import { CozyImageResource } from '../types';
 export declare const getThumbnailURL: (canvas: Canvas, images?: CozyImageResource[]) => (minSize?: number) => string | undefined;
-export declare const getImageURL: (canvas: Canvas, images?: CozyImageResource[]) => (minSize?: number) => string | undefined;
 export declare const normalizeServiceUrl: (url: string) => string;
 export declare const getImages: (canvas: Canvas) => CozyImageResource[];

package/dist/core/image-service.d.ts

@@ -1,12 +1,12 @@
 import { ImageService2, ImageService3, Service } from '@iiif/presentation-3';
-import { Bounds, CozyImageResource } from '../types';
+import { Bounds, CozyImageResource, GetRegionURLOpts } from '../types';
 type ImageService = ImageService2 | ImageService3;
 export declare const isImageService: (data: any) => data is ImageService;
 export declare const parseImageService: (service: Service) => {
     majorVersion: number;
     profileLevel: number;
 } | undefined;
-export declare const getImageURLFromService: (service: ImageService2 | ImageService3, width: number, height: number) => string;
-export declare const getRegionURLFromService: (service: ImageService2 | ImageService3, bounds: Bounds, minSize: number) => string | undefined;
-export declare const getRegionURL: (image: CozyImageResource) => (bounds: Bounds, minSize?: number) => string | undefined;
+export declare const getImageURLFromService: (service: Service, width: number, height: number) => string;
+export declare const getRegionURLFromService: (service: Service, bounds: Bounds, opts?: GetRegionURLOpts) => string | undefined;
+export declare const getRegionURL: (image: CozyImageResource) => (bounds: Bounds, opts?: GetRegionURLOpts) => string | undefined;
 export {};

package/dist/index.js

@@ -1,15 +1,15 @@
 import { imageSize as ce } from "image-size";
-import { g as m, a as j, b as S } from "./resource-DS2brz47.js";
-import { c as zt } from "./resource-DS2brz47.js";
-var le = "http://library.stanford.edu/iiif/image-api/compliance.html#level0", pe = "http://library.stanford.edu/iiif/image-api/compliance.html#level1", V = "http://library.stanford.edu/iiif/image-api/compliance.html#level2", ve = "http://library.stanford.edu/iiif/image-api/conformance.html#level0", he = "http://library.stanford.edu/iiif/image-api/conformance.html#level1", F = "http://library.stanford.edu/iiif/image-api/conformance.html#level2", ue = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level0", fe = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level1", W = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level2", me = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level0", ge = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level1", H = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level2", de = "http://iiif.io/api/image/1/level0.json", ye = "http://iiif.io/api/image/1/profiles/level0.json", Ae = "http://iiif.io/api/image/1/level1.json", Ce = "http://iiif.io/api/image/1/profiles/level1.json", J = "http://iiif.io/api/image/1/level2.json", z = "http://iiif.io/api/image/1/profiles/level2.json", be = "http://iiif.io/api/image/2/level0.json", Re = "http://iiif.io/api/image/2/profiles/level0.json", Le = "http://iiif.io/api/image/2/level1.json", we = "http://iiif.io/api/image/2/profiles/level1.json", G = "http://iiif.io/api/image/2/level2.json", K = "http://iiif.io/api/image/2/profiles/level2.json", Ie = "level0", Se = "level1", Q = "level2", xe = "http://iiif.io/api/image/2/level0", Te = "http://iiif.io/api/image/2/level1", X = "http://iiif.io/api/image/2/level2", $e = [X, V, F, W, H, J, z, G, K, Q], Me = [xe, Te, X, le, pe, V, ve, he, F, ue, fe, W, me, ge, H, de, ye, Ae, Ce, J, z, be, Re, Le, we, G, K, Ie, Se, Q], je = Me;
-function g(t) {
+import { g, a as j, b as S } from "./resource-DS2brz47.js";
+import { c as Jt } from "./resource-DS2brz47.js";
+var le = "http://library.stanford.edu/iiif/image-api/compliance.html#level0", pe = "http://library.stanford.edu/iiif/image-api/compliance.html#level1", V = "http://library.stanford.edu/iiif/image-api/compliance.html#level2", ve = "http://library.stanford.edu/iiif/image-api/conformance.html#level0", he = "http://library.stanford.edu/iiif/image-api/conformance.html#level1", F = "http://library.stanford.edu/iiif/image-api/conformance.html#level2", ue = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level0", fe = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level1", W = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level2", me = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level0", ge = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level1", z = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level2", de = "http://iiif.io/api/image/1/level0.json", ye = "http://iiif.io/api/image/1/profiles/level0.json", Ae = "http://iiif.io/api/image/1/level1.json", Ce = "http://iiif.io/api/image/1/profiles/level1.json", H = "http://iiif.io/api/image/1/level2.json", J = "http://iiif.io/api/image/1/profiles/level2.json", be = "http://iiif.io/api/image/2/level0.json", Re = "http://iiif.io/api/image/2/profiles/level0.json", Le = "http://iiif.io/api/image/2/level1.json", we = "http://iiif.io/api/image/2/profiles/level1.json", G = "http://iiif.io/api/image/2/level2.json", K = "http://iiif.io/api/image/2/profiles/level2.json", Ie = "level0", Se = "level1", Q = "level2", xe = "http://iiif.io/api/image/2/level0", Te = "http://iiif.io/api/image/2/level1", X = "http://iiif.io/api/image/2/level2", $e = [X, V, F, W, z, H, J, G, K, Q], Me = [xe, Te, X, le, pe, V, ve, he, F, ue, fe, W, me, ge, z, de, ye, Ae, Ce, H, J, be, Re, Le, we, G, K, Ie, Se, Q], je = Me;
+function d(t) {
   for (let e in t) (typeof t[e] > "u" || t[e] === null) && delete t[e];
   return t;
 }
 function w(t) {
   return Array.isArray(t) ? t : t ? [t] : [];
 }
-var ke = Object.defineProperty, Pe = (t, e, r) => e in t ? ke(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r, b = (t, e, r) => (Pe(t, typeof e != "symbol" ? e + "" : e, r), r), N = ["sc:Collection", "sc:Manifest", "sc:Canvas", "sc:AnnotationList", "oa:Annotation", "sc:Range", "sc:Layer", "sc:Sequence", "oa:Choice", "Service", "ContentResource"];
+var ke = Object.defineProperty, Pe = (t, e, r) => e in t ? ke(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r, R = (t, e, r) => (Pe(t, typeof e != "symbol" ? e + "" : e, r), r), N = ["sc:Collection", "sc:Manifest", "sc:Canvas", "sc:AnnotationList", "oa:Annotation", "sc:Range", "sc:Layer", "sc:Sequence", "oa:Choice", "Service", "ContentResource"];
 function Oe(t) {
   if (typeof t > "u" || t === null) throw new Error("Null or undefined is not a valid entity.");
   if (Array.isArray(t)) throw new Error("Array is not a valid entity");
@@ -24,7 +24,7 @@ function Oe(t) {
 }
 var Ue = class Y {
   constructor(e, r = {}) {
-    b(this, "traversals"), b(this, "options"), this.traversals = { collection: [], manifest: [], canvas: [], annotationList: [], sequence: [], annotation: [], contentResource: [], choice: [], range: [], service: [], layer: [], ...e }, this.options = { convertPropsToArray: !0, mergeMemberProperties: !0, allowUndefinedReturn: !1, ...r };
+    R(this, "traversals"), R(this, "options"), this.traversals = { collection: [], manifest: [], canvas: [], annotationList: [], sequence: [], annotation: [], contentResource: [], choice: [], range: [], service: [], layer: [], ...e }, this.options = { convertPropsToArray: !0, mergeMemberProperties: !0, allowUndefinedReturn: !1, ...r };
   }
   static all(e) {
     return new Y({ collection: [e], manifest: [e], canvas: [e], annotationList: [e], sequence: [e], annotation: [e], contentResource: [e], choice: [e], range: [e], service: [e], layer: [e] });
@@ -153,7 +153,7 @@ var Ue = class Y {
       return typeof n > "u" && !this.options.allowUndefinedReturn ? i : n;
     }, e);
   }
-}, De = "http://library.stanford.edu/iiif/image-api/compliance.html#level1", Ne = "http://library.stanford.edu/iiif/image-api/compliance.html#level2", Ee = "http://library.stanford.edu/iiif/image-api/conformance.html#level1", qe = "http://library.stanford.edu/iiif/image-api/conformance.html#level2", _e = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level1", Be = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level2", Ve = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level1", Fe = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level2", We = "http://iiif.io/api/image/1/level1.json", He = "http://iiif.io/api/image/1/profiles/level1.json", Je = "http://iiif.io/api/image/1/level2.json", ze = "http://iiif.io/api/image/1/profiles/level2.json", Ge = "http://iiif.io/api/image/2/level1.json", Ke = "http://iiif.io/api/image/2/profiles/level1.json", Qe = "http://iiif.io/api/image/2/level2.json", Xe = "http://iiif.io/api/image/2/profiles/level2.json", Ye = "level1", Ze = "level2", et = "http://iiif.io/api/image/2/level1", tt = "http://iiif.io/api/image/2/level2", rt = [et, tt, De, Ne, Ee, qe, _e, Be, Ve, Fe, We, He, Je, ze, Ge, Ke, Qe, Xe, Ye, Ze], k = { attributionLabel: "Attribution", providerId: "http://example.org/provider", providerName: "Unknown" };
+}, De = "http://library.stanford.edu/iiif/image-api/compliance.html#level1", Ne = "http://library.stanford.edu/iiif/image-api/compliance.html#level2", Ee = "http://library.stanford.edu/iiif/image-api/conformance.html#level1", qe = "http://library.stanford.edu/iiif/image-api/conformance.html#level2", _e = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level1", Be = "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level2", Ve = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level1", Fe = "http://library.stanford.edu/iiif/image-api/1.1/conformance.html#level2", We = "http://iiif.io/api/image/1/level1.json", ze = "http://iiif.io/api/image/1/profiles/level1.json", He = "http://iiif.io/api/image/1/level2.json", Je = "http://iiif.io/api/image/1/profiles/level2.json", Ge = "http://iiif.io/api/image/2/level1.json", Ke = "http://iiif.io/api/image/2/profiles/level1.json", Qe = "http://iiif.io/api/image/2/level2.json", Xe = "http://iiif.io/api/image/2/profiles/level2.json", Ye = "level1", Ze = "level2", et = "http://iiif.io/api/image/2/level1", tt = "http://iiif.io/api/image/2/level2", rt = [et, tt, De, Ne, Ee, qe, _e, Be, Ve, Fe, We, ze, He, Je, Ge, Ke, Qe, Xe, Ye, Ze], k = { attributionLabel: "Attribution", providerId: "http://example.org/provider", providerName: "Unknown" };
 function it(t) {
   if (typeof t == "string") return [t];
   if (!t) return [];
@@ -308,13 +308,13 @@ function ee(t, e) {
   let r = encodeURI(t.id || t["@id"] || "").trim();
   return r && e ? `${r}/${e}` : r || (q++, `http://example.org/${t["@type"]}${e ? `/${e}` : ""}/${q}`);
 }
-function A(t) {
+function C(t) {
   let e = [...t.behavior || []];
   t.viewingHint && e.push(t.viewingHint);
   let r;
   return Array.isArray(t.motivation) ? r = t.motivation.map(E) : t.motivation && (r = E(t.motivation)), { "@context": t["@context"] ? vt(t["@context"]) : void 0, id: (t["@id"] || ee(t)).trim(), type: U(t), behavior: e.length ? e : void 0, height: t.height ? t.height : void 0, width: t.width ? t.width : void 0, motivation: r, viewingDirection: t.viewingDirection, profile: t.profile, format: t.format ? t.format : void 0, duration: void 0, timeMode: void 0 };
 }
-function C(t) {
+function b(t) {
   let [e, r] = lt(t.license), i = [...t.metadata ? ht(t.metadata) : [], ...r];
   return { rights: e, metadata: i.length ? i : void 0, label: t.label ? I(t.label) : void 0, requiredStatement: t.attribution ? { label: I(k.attributionLabel), value: I(t.attribution) } : void 0, navDate: t.navDate, summary: t.description ? I(t.description) : void 0, thumbnail: ut(t.thumbnail) };
 }
@@ -333,7 +333,7 @@ function ft(t) {
   } else i["@id"] && r.push({ id: i["@id"], type: U(i) });
   return r.length ? r : void 0;
 }
-function R(t) {
+function L(t) {
   let e = t.related ? Array.isArray(t.related) ? t.related : [t.related] : [], r = t.contentLayer;
   return { provider: t.logo || e.length ? [{ id: k.providerId, type: "Agent", homepage: e.length ? [e[0]] : void 0, logo: t.logo ? Array.isArray(t.logo) ? t.logo : [t.logo] : void 0, label: I(k.providerName) }] : void 0, partOf: ft(t), rendering: t.rendering, seeAlso: t.seeAlso, start: t.startCanvas, service: t.service ? w(t.service) : void 0, supplementary: r ? [r] : void 0 };
 }
@@ -341,13 +341,13 @@ function mt(t) {
   return { chars: t.chars, format: t.format ? t.format : void 0, language: t.language };
 }
 function gt(t) {
-  return g({ ...A(t), ...C(t), ...R(t), items: t.members });
+  return d({ ...C(t), ...b(t), ...L(t), items: t.members });
 }
 function dt(t) {
   let e = [], r = [], i;
   for (let n of t.sequences || []) n.canvases.length && e.push(...n.canvases), n.behavior && r.push(...n.behavior), n.startCanvas && (i = n.startCanvas);
-  let s = A(t);
-  return r.length && (s.behavior ? s.behavior.push(...r) : s.behavior = r), g({ ...s, ...C(t), ...R(t), start: i, items: e, structures: yt(t.structures) });
+  let s = C(t);
+  return r.length && (s.behavior ? s.behavior.push(...r) : s.behavior = r), d({ ...s, ...b(t), ...L(t), start: i, items: e, structures: yt(t.structures) });
 }
 function yt(t) {
   if (!t) return t;
@@ -361,10 +361,10 @@ function yt(t) {
   return t.filter((i) => r.indexOf(i.id) === -1);
 }
 function At(t) {
-  return g({ ...A(t), ...C(t), ...R(t), annotations: t.otherContent && t.otherContent.length ? t.otherContent : void 0, items: t.images && t.images.length ? [{ id: ee(t, "annotation-page"), type: "AnnotationPage", items: t.images }] : void 0 });
+  return d({ ...C(t), ...b(t), ...L(t), annotations: t.otherContent && t.otherContent.length ? t.otherContent : void 0, items: t.images && t.images.length ? [{ id: ee(t, "annotation-page"), type: "AnnotationPage", items: t.images }] : void 0 });
 }
 function Ct(t) {
-  return g({ ...A(t), ...C(t), ...R(t), items: t.resources && t.resources.length ? t.resources : void 0 });
+  return d({ ...C(t), ...b(t), ...L(t), items: t.resources && t.resources.length ? t.resources : void 0 });
 }
 function bt(t) {
   return !t.canvases || t.canvases.length === 0 ? { canvases: [], behavior: [] } : { canvases: t.canvases, behavior: t.viewingHint ? [t.viewingHint] : [], startCanvas: t.startCanvas };
@@ -385,28 +385,28 @@ function Rt(t) {
       return { type: "SpecificResource", source: i, selector: P(r.selector) };
     } else return encodeURI(r["@id"]).trim();
   }
-  return g({ ...A(t), ...C(t), ...R(t), target: e(t.on), body: Array.isArray(t.resource) ? t.resource.map(_) : _(t.resource) });
+  return d({ ...C(t), ...b(t), ...L(t), target: e(t.on), body: Array.isArray(t.resource) ? t.resource.map(_) : _(t.resource) });
 }
 function _(t) {
   return t.type === "Choice" ? t : te(t);
 }
 function te(t) {
   let e = t;
-  return g({ ...A(e), ...C(e), ...R(e), ...mt(e) });
+  return d({ ...C(e), ...b(e), ...L(e), ...mt(e) });
 }
 function Lt(t) {
   let e = [];
-  return t.default && t.default !== "rdf:nil" && e.push(t.default), t.item && t.item !== "rdf:nil" && e.push(...t.item), g({ ...A(t), ...C(t), items: e });
+  return t.default && t.default !== "rdf:nil" && e.push(t.default), t.item && t.item !== "rdf:nil" && e.push(...t.item), d({ ...C(t), ...b(t), items: e });
 }
 function wt(t) {
-  return g({ ...A(t), ...C(t), ...R(t), items: t.members });
+  return d({ ...C(t), ...b(t), ...L(t), items: t.members });
 }
 function It(t) {
   let { "@id": e, "@type": r, "@context": i, profile: s, ...n } = t, o = {};
-  return e && (o["@id"] = e), o["@type"] = U(t), o["@type"] === "unknown" && (i && i.length && (o["@context"] = i), o["@type"] = "Service"), s && (o.profile = Z(s)), g({ ...o, ...n });
+  return e && (o["@id"] = e), o["@type"] = U(t), o["@type"] === "unknown" && (i && i.length && (o["@context"] = i), o["@type"] = "Service"), s && (o.profile = Z(s)), d({ ...o, ...n });
 }
 function St(t) {
-  return g({ ...A(t), ...C(t), ...R(t) });
+  return d({ ...C(t), ...b(t), ...L(t) });
 }
 var xt = new Ue({ collection: [gt], manifest: [dt], canvas: [At], annotationList: [Ct], sequence: [bt], annotation: [Rt], contentResource: [te], choice: [Lt], range: [wt], service: [It], layer: [St] });
 function re(t) {
@@ -442,7 +442,7 @@ function Tt(t, e) {
 }
 var D = class ie {
   constructor(e, r = {}) {
-    b(this, "traversals"), b(this, "options"), b(this, "_traverseManifest", x(this.traverseManifestItems.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this), this.traverseLinkedCanvases.bind(this), this.traverseManifestStructures.bind(this), this.traverseInlineAnnotationPages.bind(this))), b(this, "_traverseCanvas", x(this.traverseCanvasItems.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this), this.traverseLinkedCanvases.bind(this), this.traverseInlineAnnotationPages.bind(this))), b(this, "_traverseAnnotationPage", x(this.traverseAnnotationPageItems.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this))), b(this, "_traverseRange", x(this.traverseRangeRanges.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this), this.traverseLinkedCanvases.bind(this))), this.traversals = { collection: [], manifest: [], canvas: [], annotationCollection: [], annotationPage: [], annotation: [], contentResource: [], choice: [], range: [], service: [], agent: [], specificResource: [], geoJson: [], ...e }, this.options = { allowUndefinedReturn: !1, ...r };
+    R(this, "traversals"), R(this, "options"), R(this, "_traverseManifest", x(this.traverseManifestItems.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this), this.traverseLinkedCanvases.bind(this), this.traverseManifestStructures.bind(this), this.traverseInlineAnnotationPages.bind(this))), R(this, "_traverseCanvas", x(this.traverseCanvasItems.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this), this.traverseLinkedCanvases.bind(this), this.traverseInlineAnnotationPages.bind(this))), R(this, "_traverseAnnotationPage", x(this.traverseAnnotationPageItems.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this))), R(this, "_traverseRange", x(this.traverseRangeRanges.bind(this), this.traverseLinking.bind(this), this.traverseDescriptive.bind(this), this.traverseLinkedCanvases.bind(this))), this.traversals = { collection: [], manifest: [], canvas: [], annotationCollection: [], annotationPage: [], annotation: [], contentResource: [], choice: [], range: [], service: [], agent: [], specificResource: [], geoJson: [], ...e }, this.options = { allowUndefinedReturn: !1, ...r };
   }
   static all(e) {
     return new ie({ collection: [e], manifest: [e], canvas: [e], annotationCollection: [e], annotationPage: [e], annotation: [e], contentResource: [e], choice: [e], range: [e], service: [e], geoJson: [e], specificResource: [e], agent: [e] });
@@ -553,15 +553,15 @@ var D = class ie {
     }
   }
 };
-const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.profile.toString().includes("iiif.io/api/image/"), ne = (t) => {
-  const e = m(t, "type"), r = m(t, "context");
+const se = (t) => g(t, "type").startsWith("ImageService") || t.profile && t.profile.toString().includes("iiif.io/api/image/"), ne = (t) => {
+  const e = g(t, "type"), r = g(t, "context");
   if (e === "ImageService2" || r != null && r.includes("image/2")) {
     const i = t, s = ["level0", "level1", "level2"];
     return { majorVersion: 2, profileLevel: (Array.isArray(i.profile) ? i.profile : [i.profile]).map((c) => s.findIndex((a) => c.toString().includes(a))).filter((c) => c > -1).sort((c, a) => a - c)[0] };
   } else if (e || r)
     return { majorVersion: 3, profileLevel: parseInt(t.profile) };
 }, O = (t, e, r) => {
-  const i = m(t, "id"), s = t.profile || "";
+  const i = g(t, "id"), s = t.profile || "";
   if (typeof s == "string" && (s.includes("level0") || s.includes("level:0"))) {
     if ("sizes" in t && Array.isArray(t.sizes)) {
       const o = t.sizes.sort((c, a) => a.width * a.height - c.width * c.height).filter((c) => c.width * c.height >= e * r)[0];
@@ -571,12 +571,18 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
     return `${i}/full/full/0/default.jpg`;
   }
   return `${i}/full/!${e},${r}/0/default.jpg`;
-}, $t = (t, e, r) => {
-  const i = m(t, "id"), s = t.profile || "";
-  if (typeof s == "string" && (s.includes("level0") || s.includes("level:0"))) return;
-  const { x: o, y: c, w: a, h: l } = e, u = a / l, v = u < 1, d = Math.ceil(v ? r / u : r), p = Math.ceil(v ? r : r / u), f = `${Math.round(o)},${Math.round(c)},${Math.round(a)},${Math.round(l)}`;
-  return `${i}/${f}/!${p},${d}/0/default.jpg`;
-}, Mt = (t) => (e, r = 400) => {
+}, $t = (t, e, r = { minSize: 400 }) => {
+  const i = g(t, "id"), s = t.profile || "";
+  if (typeof s == "string" && (s.includes("level0") || s.includes("level:0"))) {
+    console.warn(`Level 0 image service does not support custom region URLs: ${i}`);
+    return;
+  }
+  const { x: o, y: c, w: a, h: p } = e, { minSize: u = 400, maxSize: v } = r, m = a / p, l = m < 1;
+  let f = Math.ceil(l ? u / m : u), h = Math.ceil(l ? u : u / m);
+  v && (h > v || f > v) && (l ? (f = Math.min(f, v), h = Math.ceil(f * m)) : (h = Math.min(h, v), f = Math.ceil(h / m)));
+  const y = `${Math.round(o)},${Math.round(c)},${Math.round(a)},${Math.round(p)}`;
+  return `${i}/${y}/!${h},${f}/0/default.jpg`;
+}, Mt = (t) => (e, r = { minSize: 400 }) => {
   if (t.type === "dynamic")
     return $t(t.service, e, r);
   console.error("Level 0 or static image canvas: unsupported");
@@ -585,31 +591,25 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
   if (!i || !s) return;
   const n = i / s, o = n < 1, c = Math.ceil(o ? r / n : r), a = Math.ceil(o ? r : r / n);
   if (t.thumbnail && t.thumbnail.length > 0) {
-    const l = t.thumbnail[0];
-    if ("service" in l && Array.isArray(l.service)) {
-      const u = l.service.find((v) => se(v));
+    const p = t.thumbnail[0];
+    if ("service" in p && Array.isArray(p.service)) {
+      const u = p.service.find((v) => se(v));
       if (u)
         return O(u, a, c);
     }
-    if ("id" in l) return l.id;
-  }
-  for (const l of e) {
-    if (l.type === "dynamic" || l.type === "level0")
-      return O(l.service, a, c);
-    if (l.type === "static")
-      return l.url;
-  }
-}, kt = (t, e = []) => (r = 800) => {
-  const { width: i, height: s } = t;
-  if (!i || !s) return;
-  const n = i / s, o = n < 1, c = Math.ceil(o ? r / n : r), a = Math.ceil(o ? r : r / n);
-  for (const l of e) {
-    if (l.type === "dynamic" || l.type === "level0")
-      return O(l.service, a, c);
-    if (l.type === "static")
-      return l.url;
-  }
-}, ae = (t) => t.endsWith("/info.json") ? t : `${t.endsWith("/") ? t : `${t}/`}info.json`, Pt = (t) => () => fetch(t).then((e) => e.json()).then((e) => {
+    if ("id" in p) return p.id;
+  }
+  for (const p of e) {
+    if (p.type === "dynamic" || p.type === "level0")
+      return O(p.service, a, c);
+    if (p.type === "static")
+      return p.url;
+  }
+}, ae = (t) => t.endsWith("/info.json") ? t : `${t.endsWith("/") ? t : `${t}/`}info.json`, kt = (t, e, r) => (i = 800) => {
+  if (!t || !e) return;
+  const s = t / e, n = s < 1, o = Math.ceil(n ? i / s : i), c = Math.ceil(n ? i : i / s);
+  return O(r, c, o);
+}, Pt = (t) => () => fetch(t).then((e) => e.json()).then((e) => {
   const r = e.width, i = e.height;
   return r !== void 0 && i !== void 0 ? { width: r, height: i } : void 0;
 }), Ot = (t) => () => {
@@ -619,9 +619,9 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
     return i.close(), { width: s, height: n };
   }) : r.arrayBuffer().then((i) => ce(new Uint8Array(i))));
 }, Ut = (t) => {
-  const { format: e, height: r, width: i } = t, s = m(t, "id"), n = (t.service || []).find(se), o = n ? ne(n) : void 0;
-  if (o) {
-    const c = ae(m(n, "id")), a = {
+  const { format: e, height: r, width: i } = t, s = g(t, "id"), n = (t.service || []).find(se), o = n ? ne(n) : void 0;
+  if (n && o) {
+    const c = ae(g(n, "id")), a = {
       source: t,
       type: o.profileLevel === 0 ? "level0" : "dynamic",
       service: n,
@@ -629,6 +629,7 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
       height: r,
       majorVersion: o.majorVersion,
       serviceUrl: c,
+      getImageURL: kt(i, r, n),
       getPixelSize: Pt(c)
     };
     return o.profileLevel === 0 ? a : {
@@ -643,6 +644,7 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
       height: r,
       url: s,
       format: e,
+      getImageURL: () => s,
       getPixelSize: Ot(s)
     };
 }, Dt = (t) => {
@@ -656,7 +658,7 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
     }]
   }).traverseCanvas(t), e;
 }, Nt = (t) => () => {
-  const e = /* @__PURE__ */ new Map(), r = (a, l, u = 0) => {
+  const e = /* @__PURE__ */ new Map(), r = (a, p, u = 0) => {
     const v = {
       id: a.id,
       type: "range",
@@ -664,7 +666,7 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
       children: [],
       navItems: [],
       navSections: [],
-      parent: l,
+      parent: p,
       level: u,
       getLabel: a.getLabel
     };
@@ -673,7 +675,7 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
         const T = r(h, v, u + 1);
         v.children.push(T);
       } else {
-        const L = {
+        const y = {
           id: h.id,
           type: "canvas",
           source: h,
@@ -684,23 +686,23 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
           level: u + 1,
           getLabel: h.getLabel
         };
-        v.children.push(L), e.set(L.id, L);
+        v.children.push(y), e.set(y.id, y);
       }
     });
-    const d = v.children.map((h) => h.type === "canvas" ? h.source : h.children.length === 1 && h.children[0].type === "canvas" ? h.children[0].source : h.source), p = d.filter((h) => h.source.type === "Canvas"), f = d.filter((h) => h.source.type === "Range");
-    return v.navItems.push(...p), v.navSections.push(...f), e.set(v.id, v), v;
+    const m = v.children.map((h) => h.type === "canvas" ? h.source : h.children.length === 1 && h.children[0].type === "canvas" ? h.children[0].source : h.source), l = m.filter((h) => h.source.type === "Canvas"), f = m.filter((h) => h.source.type === "Range");
+    return v.navItems.push(...l), v.navSections.push(...f), e.set(v.id, v), v;
   };
   return { root: t.filter((a) => {
-    var l;
-    return (l = a.source.behavior) == null ? void 0 : l.includes("top");
+    var p;
+    return (p = a.source.behavior) == null ? void 0 : p.includes("top");
   }).map((a) => r(a, void 0)), enumerateNodes: (a) => {
-    const l = Array.from(e.values());
-    return a ? l.filter((u) => u.type === a) : l;
+    const p = Array.from(e.values());
+    return a ? p.filter((u) => u.type === a) : p;
   }, getBreadcrumbs: (a) => {
-    const l = e.get(a);
-    if (!l) return [];
-    const u = (v, d = []) => v.parent ? u(v.parent, [v, ...d]) : [v, ...d];
-    return u(l);
+    const p = e.get(a);
+    if (!p) return [];
+    const u = (v, m = []) => v.parent ? u(v.parent, [v, ...m]) : [v, ...m];
+    return u(p);
   }, getNode: (a) => e.get(a) };
 }, Et = async (t) => {
   try {
@@ -756,7 +758,7 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
       code: "INVALID_MANIFEST",
       message: "Missing @context"
     };
-  const i = m(t, "id");
+  const i = g(t, "id");
   if (!i)
     return {
       type: "error",
@@ -765,7 +767,7 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
     };
   if (r.includes("presentation/2") || r.includes("presentation/3")) {
     const s = r.includes("presentation/2") ? 2 : 3;
-    return m(t, "type").includes("Collection") ? {
+    return g(t, "type").includes("Collection") ? {
       type: "collection",
       url: e || i,
       resource: qt(t, s)
@@ -816,40 +818,41 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
   const r = (o) => {
     const c = [], a = [];
     new D({
-      canvas: [(p) => {
-        p.items && c.push(p);
+      canvas: [(l) => {
+        l.items && c.push(l);
       }],
-      range: [(p) => {
-        p.type === "Range" && a.push(p);
+      range: [(l) => {
+        l.type === "Range" && a.push(l);
       }]
     }).traverseManifest(o);
-    const u = c.map((p) => {
-      const f = Dt(p);
+    const u = c.map((l) => {
+      const f = Dt(l);
       return {
-        source: p,
-        id: p.id,
-        width: p.width,
-        height: p.height,
+        source: l,
+        id: l.id,
+        width: l.width,
+        height: l.height,
         images: f,
-        annotations: p.annotations || [],
-        getImageURL: kt(p, f),
-        getLabel: S(p),
-        getMetadata: j(p),
-        getThumbnailURL: jt(p, f)
+        annotations: l.annotations || [],
+        getImageURL: f.length > 0 ? f[0].getImageURL : () => {
+        },
+        getLabel: S(l),
+        getMetadata: j(l),
+        getThumbnailURL: jt(l, f)
       };
-    }), v = (p) => {
-      const f = p.items || [], h = f.filter((y) => y.type === "Canvas").map((y) => u.find(($) => $.id === y.id)).filter(Boolean), L = f.filter((y) => y.type === "Range").map((y) => v(y)), T = [...h, ...L];
+    }), v = (l) => {
+      const f = l.items || [], h = f.filter((A) => A.type === "Canvas").map((A) => u.find(($) => $.id === A.id)).filter(Boolean), y = f.filter((A) => A.type === "Range").map((A) => v(A)), T = [...h, ...y];
       return {
-        source: p,
-        id: p.id,
+        source: l,
+        id: l.id,
         // Maintain original order
-        items: f.map((y) => T.find(($) => $.id === y.id)),
+        items: f.map((A) => T.find(($) => $.id === A.id)),
         canvases: h,
-        ranges: L,
-        getLabel: S(p)
+        ranges: y,
+        getLabel: S(l)
       };
-    }, d = a.map((p) => v(p));
-    return { canvases: u, ranges: d };
+    }, m = a.map((l) => v(l));
+    return { canvases: u, ranges: m };
   }, i = e === 2 ? re(t) : t, { canvases: s, ranges: n } = r(i);
   return {
     source: i,
@@ -870,20 +873,19 @@ const se = (t) => m(t, "type").startsWith("ImageService") || t.profile && t.prof
       width: e,
       height: r,
       majorVersion: i.majorVersion,
-      serviceUrl: ae(m(t, "id"))
+      serviceUrl: ae(g(t, "id"))
     };
 }, Wt = { parse: oe, parseURL: Et };
 export {
   Wt as Cozy,
-  kt as getImageURL,
   O as getImageURLFromService,
   Dt as getImages,
   S as getLabel,
   j as getMetadata,
-  m as getPropertyValue,
+  g as getPropertyValue,
   Mt as getRegionURL,
   $t as getRegionURLFromService,
-  zt as getStringValue,
+  Jt as getStringValue,
   Nt as getTableOfContents,
   jt as getThumbnailURL,
   se as isImageService,

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { Manifest, Canvas, ImageService2, ImageService3, IIIFExternalWebResource, Collection, Range, AnnotationPage } from '@iiif/presentation-3';
+import { Manifest, Canvas, IIIFExternalWebResource, Collection, Range, AnnotationPage, Service } from '@iiif/presentation-3';
 export type CozyParseResult = {
     type: 'collection';
     url: string;
@@ -94,6 +94,7 @@ interface BaseImageResource {
     readonly type: 'static' | 'dynamic' | 'level0';
     readonly width: number;
     readonly height: number;
+    getImageURL(minSize?: number): string;
     getPixelSize(): Promise<{
         width: number;
         height: number;
@@ -105,15 +106,15 @@ export interface StaticImageResource extends BaseImageResource {
 }
 export interface DynamicImageServiceResource extends BaseImageResource {
     readonly type: 'dynamic';
-    readonly service: ImageService2 | ImageService3;
+    readonly service: Service;
     readonly serviceUrl: string;
     readonly majorVersion: number;
-    getRegionURL(bounds: Bounds, minSize?: number): string;
+    getRegionURL(bounds: Bounds, opts?: GetRegionURLOpts): string;
 }
 export interface Level0ImageServiceResource extends BaseImageResource {
     readonly type: 'level0';
     readonly majorVersion: number;
-    readonly service: ImageService2 | ImageService3;
+    readonly service: Service;
     readonly serviceUrl: string;
 }
 export interface ImageRequestOptions {
@@ -134,4 +135,8 @@ export interface Bounds {
     w: number;
     h: number;
 }
+export interface GetRegionURLOpts {
+    minSize?: number;
+    maxSize?: number;
+}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozy-iiif",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "A developer-friendly collection of abstractions and utilities built on top of @iiif/presentation-3 and @iiif/parser",
   "license": "MIT",
   "author": "Rainer Simon",

package/src/Cozy.ts

@@ -2,8 +2,7 @@ import type { Canvas, Collection, Manifest, Range } from '@iiif/presentation-3';
 import { convertPresentation2  } from '@iiif/parser/presentation-2';
 import { Traverse } from '@iiif/parser';
 import { 
-  getImages, 
-  getImageURL, 
+  getImages,
   getLabel, 
   getMetadata, 
   getPropertyValue, 
@@ -15,7 +14,7 @@ import {
 import type { 
   CozyCanvas, 
   CozyCollection, 
-  CozyCollectionItem, 
+  CozyCollectionItem,
   CozyManifest, 
   CozyParseResult, 
   CozyRange, 
@@ -194,7 +193,7 @@ const parseManifestResource = (resource: any, majorVersion: number): CozyManifes
         height: c.height,
         images,
         annotations: (c.annotations || []),
-        getImageURL: getImageURL(c, images),
+        getImageURL: images.length > 0 ? images[0].getImageURL : () => undefined,
         getLabel: getLabel(c),
         getMetadata: getMetadata(c),
         getThumbnailURL: getThumbnailURL(c, images)

package/src/core/canvas.ts

@@ -1,5 +1,5 @@
 import { imageSize } from 'image-size';
-import type { Canvas, IIIFExternalWebResource } from '@iiif/presentation-3';
+import type { Canvas, IIIFExternalWebResource, Service } from '@iiif/presentation-3';
 import { Traverse } from '@iiif/parser';
 import { getPropertyValue } from './resource';
 import { getImageURLFromService, getRegionURL, isImageService, parseImageService } from './image-service';
@@ -43,9 +43,14 @@ export const getThumbnailURL = (canvas: Canvas, images: CozyImageResource[] = []
   }
 }
 
-export const getImageURL = (canvas: Canvas, images: CozyImageResource[] = []) => (minSize = 800) => {
-  const { width, height } = canvas;
+export const normalizeServiceUrl = (url: string) =>
+  url.endsWith('/info.json') ? url : `${url.endsWith('/') ? url : `${url}/`}info.json`;
 
+const getImageURL = (
+  width: number | undefined, 
+  height: number | undefined, 
+  service: Service  
+) => (minSize = 800) => {
   if (!width || !height) return;
 
   const aspect = width / height;
@@ -54,18 +59,9 @@ export const getImageURL = (canvas: Canvas, images: CozyImageResource[] = []) =>
   const h = Math.ceil(isPortrait ? minSize / aspect : minSize);
   const w = Math.ceil(isPortrait ? minSize : minSize / aspect);
 
-  for (const image of images) {
-    if (image.type === 'dynamic' || image.type === 'level0') {
-      return getImageURLFromService(image.service, w, h);
-    } else if (image.type === 'static') {
-      return image.url;
-    }    
-  }
+  return getImageURLFromService(service!, w, h);
 }
 
-export const normalizeServiceUrl = (url: string) =>
-  url.endsWith('/info.json') ? url : `${url.endsWith('/') ? url : `${url}/`}info.json`;
-
 const getPixelSizeFromServiceUrl = (serviceUrl: string) => () =>
   fetch(serviceUrl).then(res => res.json()).then(data => {
     const width: number = data.width;
@@ -83,8 +79,7 @@ const getStaticImagePixelSize = (url: string) => () => {
         bitmap.close(); 
         return { width, height }
       });
-    } else {
-      return blob.arrayBuffer().then(buffer => 
+    } else {      return blob.arrayBuffer().then(buffer => 
         imageSize(new Uint8Array(buffer)));
     }
   });
@@ -99,7 +94,7 @@ const toCozyImageResource = (resource: IIIFExternalWebResource) => {
 
   const service = imageService ? parseImageService(imageService) : undefined; 
 
-  if (service) {
+  if (imageService && service) {
     const serviceUrl = normalizeServiceUrl(getPropertyValue<string>(imageService, 'id'));
 
     const image = {
@@ -110,6 +105,7 @@ const toCozyImageResource = (resource: IIIFExternalWebResource) => {
       height,
       majorVersion: service.majorVersion,
       serviceUrl,
+      getImageURL: getImageURL(width, height, imageService),
       getPixelSize: getPixelSizeFromServiceUrl(serviceUrl)
     } as ImageServiceResource;
 
@@ -129,6 +125,7 @@ const toCozyImageResource = (resource: IIIFExternalWebResource) => {
       height,
       url: id,
       format,
+      getImageURL: () => id,
       getPixelSize: getStaticImagePixelSize(id)
     } as StaticImageResource;
   }

package/src/core/image-service.ts

@@ -1,6 +1,6 @@
 import type { ImageService2, ImageService3, Service } from '@iiif/presentation-3';
 import { getPropertyValue } from './resource';
-import type { Bounds, CozyImageResource } from '../types';
+import type { Bounds, CozyImageResource, GetRegionURLOpts } from '../types';
 
 type ImageService = ImageService2 | ImageService3;
 
@@ -36,7 +36,7 @@ export const parseImageService = (service: Service) => {
 }
 
 export const getImageURLFromService = (
-  service: ImageService2 | ImageService3,
+  service: Service,
   width: number,
   height: number
 ): string => {
@@ -66,9 +66,9 @@ export const getImageURLFromService = (
 }
 
 export const getRegionURLFromService = (
-  service: ImageService2 | ImageService3,
+  service: Service,
   bounds: Bounds,
-  minSize: number
+  opts: GetRegionURLOpts = { minSize: 400 }
 ): string | undefined => {
   const id = getPropertyValue(service, 'id');
   const compliance = service.profile || '';
@@ -76,16 +76,32 @@ export const getRegionURLFromService = (
   const isLevel0 = typeof compliance === 'string' &&
     (compliance.includes('level0') || compliance.includes('level:0'));
 
-  // TODO
-  if (isLevel0) return;
+  if (isLevel0) {
+    console.warn(`Level 0 image service does not support custom region URLs: ${id}`);
+    return;
+  }
 
   const { x, y, w , h } = bounds;
+  const { minSize = 400, maxSize } = opts;
 
   const aspect = w / h;
   const isPortrait = aspect < 1;
   
-  const height = Math.ceil(isPortrait ? minSize / aspect : minSize);
-  const width = Math.ceil(isPortrait ? minSize : minSize / aspect);
+  let height = Math.ceil(isPortrait ? minSize / aspect : minSize);
+  let width = Math.ceil(isPortrait ? minSize : minSize / aspect);
+
+  // Apply maxSize constraint if specified
+  if (maxSize) {
+    if (width > maxSize || height > maxSize) {
+      if (isPortrait) {
+        height = Math.min(height, maxSize);
+        width = Math.ceil(height * aspect);
+      } else {
+        width = Math.min(width, maxSize);
+        height = Math.ceil(width / aspect);
+      }
+    }
+  }
 
   const regionParam = `${Math.round(x)},${Math.round(y)},${Math.round(w)},${Math.round(h)}`;
   return `${id}/${regionParam}/!${width},${height}/0/default.jpg`;
@@ -95,10 +111,10 @@ export const getRegionURL = (
   image: CozyImageResource
 ) => (
   bounds: Bounds,
-  minSize = 400
+  opts: GetRegionURLOpts = { minSize: 400 }
 ): string | undefined => {
   if (image.type === 'dynamic') {
-    return getRegionURLFromService(image.service, bounds, minSize);
+    return getRegionURLFromService(image.service, bounds, opts);
   } else {
     console.error('Level 0 or static image canvas: unsupported');
   }

package/src/types.ts

@@ -1,12 +1,11 @@
 import type {
   Manifest, 
-  Canvas, 
-  ImageService2, 
-  ImageService3, 
+  Canvas,
   IIIFExternalWebResource, 
   Collection, 
   Range, 
-  AnnotationPage 
+  AnnotationPage, 
+  Service
 } from '@iiif/presentation-3';
 
 export type CozyParseResult = 
@@ -169,6 +168,8 @@ interface BaseImageResource {
 
   readonly height: number;
 
+  getImageURL(minSize?: number): string;
+
   getPixelSize(): Promise<{ width: number, height: number }>;
 
 }
@@ -185,13 +186,13 @@ export interface DynamicImageServiceResource extends BaseImageResource {
 
   readonly type: 'dynamic';
 
-  readonly service: ImageService2 | ImageService3;
+  readonly service: Service;
 
   readonly serviceUrl: string;
 
   readonly majorVersion: number;
 
-  getRegionURL(bounds: Bounds, minSize?: number): string;
+  getRegionURL(bounds: Bounds, opts?: GetRegionURLOpts): string;
 
 }
 
@@ -201,7 +202,7 @@ export interface Level0ImageServiceResource extends BaseImageResource {
 
   readonly majorVersion: number;
 
-  readonly service: ImageService2 | ImageService3;
+  readonly service: Service;
 
   readonly serviceUrl: string;
 
@@ -232,4 +233,12 @@ export interface Bounds {
 
   h: number;
 
+}
+
+export interface GetRegionURLOpts {
+
+  minSize?: number;
+
+  maxSize?: number;
+
 }