ogm-viewer 0.3.0 → 0.5.0

package/dist/collection/lib/previewers/vector.js

@@ -1,18 +1,5 @@
 import MapLibrePreviewer from "./maplibre";
-const defaultOptions = {
-    fillColor: '#888888',
-    fillOpacity: 0.6,
-    fillHighlightOpacity: 0.8,
-    lineColor: '#000000',
-    labelFont: 'Noto Sans Regular',
-    labelSize: 10,
-    textColor: '#000000',
-};
 export default class VectorPreviewer extends MapLibrePreviewer {
-    constructor(source, map, options) {
-        super(source, map, options);
-        this.options = { ...defaultOptions, ...options };
-    }
     // Set opacity of all layers in this previewer
     async setOpacity(opacity) {
         this.opacity = opacity;
@@ -28,6 +15,7 @@ export default class VectorPreviewer extends MapLibrePreviewer {
         return layerIds.flatMap(layerId => {
             return [
                 this.createPolygonLayer(layerId),
+                this.createPolygonOutlineLayer(layerId),
                 this.createLineLayer(layerId),
                 this.createPointLayer(layerId),
                 this.createPolygonLabelLayer(layerId),
@@ -43,9 +31,35 @@ export default class VectorPreviewer extends MapLibrePreviewer {
             type: 'fill',
             source: this.getSourceId(),
             paint: {
-                'fill-color': this.options.fillColor,
-                'fill-outline-color': this.options.lineColor,
-                'fill-opacity': ['case', ['boolean', ['feature-state', 'hover'], false], this.options.fillHighlightOpacity, this.options.fillOpacity],
+                'fill-color': [
+                    'case',
+                    ['boolean', ['feature-state', 'selected'], false],
+                    this.style.fillSelectedColor,
+                    ['boolean', ['feature-state', 'hover'], false],
+                    this.style.fillHighlightColor,
+                    this.style.fillColor,
+                ],
+                'fill-opacity': ['case', ['boolean', ['feature-state', 'selected'], false], this.style.fillHighlightOpacity, this.style.fillOpacity],
+            },
+            filter: ['==', ['geometry-type'], 'Polygon'],
+        };
+    }
+    // Create a styled layer that will be used to outline polygon geometry
+    createPolygonOutlineLayer(layerId) {
+        return {
+            id: `${this.getSourceId()}-${layerId}-polygon-outlines`,
+            type: 'line',
+            source: this.getSourceId(),
+            paint: {
+                'line-color': [
+                    'case',
+                    ['boolean', ['feature-state', 'selected'], false],
+                    this.style.strokeSelectedColor,
+                    ['boolean', ['feature-state', 'hover'], false],
+                    this.style.strokeHighlightColor,
+                    this.style.strokeColor,
+                ],
+                'line-width': ['case', ['boolean', ['feature-state', 'selected'], false], 2, 1],
             },
             filter: ['==', ['geometry-type'], 'Polygon'],
         };
@@ -57,7 +71,14 @@ export default class VectorPreviewer extends MapLibrePreviewer {
             type: 'line',
             source: this.getSourceId(),
             paint: {
-                'line-color': this.options.lineColor,
+                'line-color': [
+                    'case',
+                    ['boolean', ['feature-state', 'selected'], false],
+                    this.style.strokeSelectedColor,
+                    ['boolean', ['feature-state', 'hover'], false],
+                    this.style.strokeHighlightColor,
+                    this.style.strokeColor,
+                ],
                 'line-width': 4,
             },
             filter: ['==', ['geometry-type'], 'LineString'],
@@ -70,11 +91,25 @@ export default class VectorPreviewer extends MapLibrePreviewer {
             type: 'circle',
             source: this.getSourceId(),
             paint: {
-                'circle-color': this.options.fillColor,
-                'circle-stroke-color': this.options.lineColor,
-                'circle-stroke-width': ['case', ['boolean', ['feature-state', 'hover'], false], 2, 1],
+                'circle-color': [
+                    'case',
+                    ['boolean', ['feature-state', 'selected'], false],
+                    this.style.fillSelectedColor,
+                    ['boolean', ['feature-state', 'hover'], false],
+                    this.style.fillHighlightColor,
+                    this.style.fillColor,
+                ],
+                'circle-stroke-color': [
+                    'case',
+                    ['boolean', ['feature-state', 'selected'], false],
+                    this.style.strokeSelectedColor,
+                    ['boolean', ['feature-state', 'hover'], false],
+                    this.style.strokeHighlightColor,
+                    this.style.strokeColor,
+                ],
+                'circle-stroke-width': ['case', ['boolean', ['feature-state', 'selected'], false], 2, 1],
                 'circle-radius': ['interpolate', ['linear'], ['zoom'], 4, 2, 12, 4],
-                'circle-opacity': ['case', ['boolean', ['feature-state', 'hover'], false], this.options.fillHighlightOpacity, this.options.fillOpacity],
+                'circle-opacity': ['case', ['boolean', ['feature-state', 'selected'], false], this.style.fillHighlightOpacity, this.style.fillOpacity],
             },
             filter: ['==', ['geometry-type'], 'Point'],
         };
@@ -87,9 +122,9 @@ export default class VectorPreviewer extends MapLibrePreviewer {
             source: this.getSourceId(),
             layout: {
                 'text-field': ['get', 'id'],
-                'text-font': [this.options.labelFont],
+                'text-font': [this.style.textFont],
                 'text-max-angle': 85,
-                'text-size': this.options.labelSize,
+                'text-size': this.style.textSize,
                 'text-offset': [0, 1],
                 'text-anchor': 'bottom',
                 'text-rotation-alignment': 'map',
@@ -98,7 +133,7 @@ export default class VectorPreviewer extends MapLibrePreviewer {
                 'symbol-spacing': 250,
             },
             paint: {
-                'text-color': this.options.textColor,
+                'text-color': this.style.textColor,
                 'text-halo-color': 'white',
                 'text-halo-width': 1,
             },
@@ -114,11 +149,11 @@ export default class VectorPreviewer extends MapLibrePreviewer {
             layout: {
                 'symbol-placement': 'line',
                 'text-field': ['get', 'id'],
-                'text-font': [this.options.labelFont],
-                'text-size': this.options.labelSize,
+                'text-font': [this.style.textFont],
+                'text-size': this.style.textSize,
             },
             paint: {
-                'text-color': this.options.textColor,
+                'text-color': this.style.textColor,
                 'text-halo-color': 'white',
                 'text-halo-width': 1,
             },
@@ -133,12 +168,12 @@ export default class VectorPreviewer extends MapLibrePreviewer {
             source: this.getSourceId(),
             layout: {
                 'text-field': ['get', 'id'],
-                'text-font': [this.options.labelFont],
-                'text-size': this.options.labelSize,
+                'text-font': [this.style.textFont],
+                'text-size': this.style.textSize,
                 'text-offset': [0, -1],
             },
             paint: {
-                'text-color': this.options.textColor,
+                'text-color': this.style.textColor,
                 'text-halo-color': 'white',
                 'text-halo-width': 1,
             },

package/dist/collection/lib/previewers/wms.js

@@ -4,7 +4,7 @@ export default class WmsPreviewer extends RasterPreviewer {
     async createSource() {
         return {
             type: 'raster',
-            tiles: [await this.source.getSourceUrl()],
+            tiles: [await this.source.getMapLibreSourceUrl()],
             tileSize: this.source.getTileSize(),
         };
     }

package/dist/collection/lib/record.js

@@ -50,7 +50,7 @@ export const OGM_FIELD_NAMES = {
 /**
  * Class for representing an OGM Aardvark record parsed from JSON data.
  */
-export class OgmRecord {
+export default class OgmRecord {
     // Original JSON data
     json;
     // Required

package/dist/collection/lib/record.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, vi } from "@stencil/vitest";
-import { OgmRecord } from "./record";
 import { LngLatBounds } from "maplibre-gl";
+import OgmRecord from "./record";
 describe('OgmRecord', () => {
     it('errors when initialized with an unsupported version', () => {
         expect(() => {

package/dist/collection/lib/references.js

@@ -35,8 +35,6 @@ const METADATA_REFERENCE_URIS = [
 export class References {
     // Underlying object to hold references
     references;
-    // Cache for fetched IIIF manifest
-    iiifManifest;
     // Create a new instance with the JSON string from a record
     constructor(dct_references_s) {
         try {
@@ -91,33 +89,6 @@ export class References {
     get iiifManifestUrl() {
         return this.references['http://iiif.io/api/presentation#manifest'];
     }
-    // List of IIIF image URLs extracted from the manifest
-    async iiifImageUrls() {
-        if (this.iiifImageUrl)
-            return [this.iiifImageUrl];
-        if (!this.iiifManifestUrl)
-            return [];
-        // Fetch and cache the manifest if we haven't already
-        if (!this.iiifManifest) {
-            try {
-                await this.fetchManifest();
-            }
-            catch (error) {
-                console.error('Failed to fetch IIIF manifest:', error);
-                return [];
-            }
-        }
-        // Try to extract image URLs from the manifest
-        try {
-            if (this.iiifVersion == 3)
-                return this.extractIiif3ImageUrls(this.iiifManifest);
-            return this.extractIiif2ImageUrls(this.iiifManifest);
-        }
-        catch (error) {
-            console.error('Failed to extract IIIF image URLs from manifest:', error);
-            return [];
-        }
-    }
     // List of download links with URL and label, if using multiple downloads
     get downloadLinks() {
         const fieldContents = this.references['http://schema.org/downloadUrl'];
@@ -169,40 +140,4 @@ export class References {
     get iiifReferences() {
         return [this.iiifImageUrl, this.iiifManifestUrl];
     }
-    // Get the IIIF presentation spec version of the manifest, if we have one
-    get iiifVersion() {
-        return this.iiifManifest['@context']?.includes('http://iiif.io/api/presentation/3/context.json') ? 3 : 2;
-    }
-    // Given a v2 manifest, extract all of the IIIF images and format as info.json URLs
-    extractIiif2ImageUrls(manifest) {
-        return (manifest.sequences
-            .flatMap(seq => seq.canvases)
-            .flatMap(can => can.images)
-            .flatMap(img => img.resource)
-            //@ts-ignore
-            .flatMap(res => (res['@type'] === 'dctypes:Image' ? res.service['@id'] + '/info.json' : [])));
-    }
-    // Given a v3 manifest, extract all of the IIIF images and format as info.json URLs
-    extractIiif3ImageUrls(manifest) {
-        // Recursively search the '.items' key until we end up with nodes that have type 'ImageService2'
-        return (manifest.items
-            .flatMap(canvas => canvas.items)
-            .flatMap(annotationPage => annotationPage?.items || [])
-            .flatMap(annotation => (Array.isArray(annotation.body) ? annotation.body : [annotation.body]))
-            //@ts-ignore
-            .flatMap(annotationBody => annotationBody.service)
-            .flatMap(service => service.id + '/info.json'));
-    }
-    // TODO: use navPlace as the bounds source if available
-    // Attempt to fetch and parse the IIIF manifest, if any
-    async fetchManifest() {
-        if (!this.iiifManifestUrl)
-            return;
-        const response = await fetch(this.iiifManifestUrl);
-        if (!response.ok)
-            throw new Error(`Unexpected response fetching IIIF manifest: ${response.statusText}`);
-        const manifest = await response.json();
-        this.iiifManifest = manifest;
-        return manifest;
-    }
 }

package/dist/collection/lib/references.test.js

@@ -74,156 +74,6 @@ describe('References', () => {
             expect(references.iiifManifestUrl).toBe('http://example.com/manifest.json');
         });
     });
-    describe('Fetching IIIF image URLs', () => {
-        it('should return IIIF image URL directly if present', async () => {
-            const contents = { 'http://iiif.io/api/image': 'http://example.com/image1/info.json' };
-            const references = new References(JSON.stringify(contents));
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual(['http://example.com/image1/info.json']);
-        });
-        it('should fetch and extract image URLs from IIIF v2 manifest', async () => {
-            const manifest = {
-                '@context': 'http://iiif.io/api/presentation/2/context.json',
-                '@id': 'http://example.com/manifest.json',
-                '@type': 'sc:Manifest',
-                'sequences': [
-                    {
-                        canvases: [
-                            {
-                                images: [
-                                    {
-                                        resource: {
-                                            '@id': 'http://example.com/image1/full/full/0/default.jpg',
-                                            '@type': 'dctypes:Image',
-                                            'service': {
-                                                '@id': 'http://example.com/image1',
-                                            },
-                                        },
-                                    },
-                                ],
-                            },
-                        ],
-                    },
-                ],
-            };
-            const references = new References(JSON.stringify({ 'http://iiif.io/api/presentation#manifest': 'http://example.com/manifest.json' }));
-            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(manifest)));
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual(['http://example.com/image1/info.json']);
-        });
-        it('should fetch and extract image URLs from IIIF v3 manifest', async () => {
-            const manifest = {
-                '@context': 'http://iiif.io/api/presentation/3/context.json',
-                'id': 'http://example.com/manifest.json',
-                'type': 'Manifest',
-                'items': [
-                    {
-                        id: 'http://example.com/canvas1',
-                        type: 'Canvas',
-                        items: [
-                            {
-                                id: 'http://example.com/annotationpage1',
-                                type: 'AnnotationPage',
-                                items: [
-                                    {
-                                        id: 'http://example.com/annotation1',
-                                        type: 'Annotation',
-                                        body: {
-                                            id: 'http://example.com/image1/full/full/0/default.jpg',
-                                            type: 'Image',
-                                            service: {
-                                                id: 'http://example.com/image1',
-                                                type: 'ImageService2',
-                                            },
-                                        },
-                                    },
-                                ],
-                            },
-                        ],
-                    },
-                ],
-            };
-            const references = new References(JSON.stringify({ 'http://iiif.io/api/presentation#manifest': 'http://example.com/manifest.json' }));
-            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(manifest)));
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual(['http://example.com/image1/info.json']);
-        });
-        it('should not fetch manifest again if already cached', async () => {
-            const manifest = {
-                '@context': 'http://iiif.io/api/presentation/2/context.json',
-                '@id': 'http://example.com/manifest.json',
-                '@type': 'sc:Manifest',
-                'sequences': [
-                    {
-                        canvases: [
-                            {
-                                images: [
-                                    {
-                                        resource: {
-                                            '@id': 'http://example.com/image1/full/full/0/default.jpg',
-                                            '@type': 'dctypes:Image',
-                                            'service': {
-                                                '@id': 'http://example.com/image1',
-                                            },
-                                        },
-                                    },
-                                ],
-                            },
-                        ],
-                    },
-                ],
-            };
-            const references = new References(JSON.stringify({ 'http://iiif.io/api/presentation#manifest': 'http://example.com/manifest.json' }));
-            const fetchSpy = vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(manifest)));
-            const urls1 = await references.iiifImageUrls();
-            const urls2 = await references.iiifImageUrls();
-            expect(fetchSpy).toHaveBeenCalledTimes(1);
-            expect(urls1).toEqual(['http://example.com/image1/info.json']);
-            expect(urls2).toEqual(['http://example.com/image1/info.json']);
-        });
-        it('should return empty array if manifest URL is not present', async () => {
-            const references = new References('{}');
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual([]);
-        });
-        it('should return empty array if manifest has no items', async () => {
-            const manifest = {
-                '@context': 'http://iiif.io/api/presentation/3/context.json',
-                'id': 'http://example.com/manifest.json',
-                'type': 'Manifest',
-                'items': [],
-            };
-            const references = new References(JSON.stringify({ 'http://iiif.io/api/presentation#manifest': 'http://example.com/manifest.json' }));
-            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(manifest)));
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual([]);
-        });
-        it('should return empty array and error if manifest fetch fails', async () => {
-            const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-            const references = new References(JSON.stringify({ 'http://iiif.io/api/presentation#manifest': 'http://example.com/manifest.json' }));
-            vi.spyOn(global, 'fetch').mockRejectedValueOnce(new Error('Network error'));
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual([]);
-            expect(consoleErrorSpy).toHaveBeenCalled();
-        });
-        it('should return empty array and error if manifest does not match spec', async () => {
-            const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-            const manifest = { unexpected: 'structure' };
-            const references = new References(JSON.stringify({ 'http://iiif.io/api/presentation#manifest': 'http://example.com/manifest.json' }));
-            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(manifest)));
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual([]);
-            expect(consoleErrorSpy).toHaveBeenCalled();
-        });
-        it('should return empty array if manifest is not valid JSON', async () => {
-            const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-            const references = new References(JSON.stringify({ 'http://iiif.io/api/presentation#manifest': 'http://example.com/manifest.json' }));
-            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response('invalid json'));
-            const urls = await references.iiifImageUrls();
-            expect(urls).toEqual([]);
-            expect(consoleErrorSpy).toHaveBeenCalled();
-        });
-    });
     describe('downloads', () => {
         it('should return empty links list if no download links are present', () => {
             const references = new References('{}');

package/dist/collection/lib/sources/cog.js

@@ -1,7 +1,10 @@
 import RasterSource from "./raster";
 export default class CogSource extends RasterSource {
+    label() {
+        return 'Cloud Optimized GeoTIFF';
+    }
     // Appends the cog:// protocol; must be registered first to work
-    getSourceUrl() {
+    getMapLibreSourceUrl() {
         return `cog://${this.url}`;
     }
     // COGs have no specific scheme identifier for MapLibre
@@ -10,6 +13,6 @@ export default class CogSource extends RasterSource {
     }
     // TODO: is it possible to read COG metadata to get bounds?
     async getBounds() {
-        return undefined;
+        return super.getBounds();
     }
 }

package/dist/collection/lib/sources/geojson.js

@@ -1,16 +1,20 @@
 import geojsonExtent from "@mapbox/geojson-extent";
 import VectorSource from "./vector";
+import { fetchOrThrow } from "../errors";
 export default class GeoJSONSource extends VectorSource {
     // Data parsed from GeoJSON document
     data;
     // Fetch and memoize data
     async getData() {
         if (!this.data) {
-            const resp = await fetch(this.url);
+            const resp = await fetchOrThrow(this.url);
             this.data = await resp.json();
         }
         return this.data;
     }
+    label() {
+        return 'GeoJSON';
+    }
     // GeoJSON is always a vector source
     async isVector() {
         return true;
@@ -20,14 +24,17 @@ export default class GeoJSONSource extends VectorSource {
         return undefined;
     }
     // GeoJSON has a special source type
-    async getType() {
+    async getMapLibreSourceType() {
         return 'geojson';
     }
     // Only one layer in a GeoJSON document
     async getVectorLayers() {
         return ['geojson'];
     }
+    // Used to zoom the map to the data once loaded
     async getBounds() {
+        if (this.bounds)
+            return this.bounds;
         const data = await this.getData();
         const bounds = geojsonExtent(data);
         return [

package/dist/collection/lib/sources/iiif-manifest.js

@@ -0,0 +1,54 @@
+import IIIFSource from "./iiif";
+import { fetchOrThrow } from "../errors";
+// A manifest containing multiple IIIF image URLs for preview
+export default class IIIFManifestSource extends IIIFSource {
+    // The parsed manifest contents
+    manifest;
+    label() {
+        return 'IIIF Manifest';
+    }
+    // List of IIIF image URLs extracted from the manifest
+    async getIIIFImageUrls() {
+        // Fetch and cache the manifest if we haven't already
+        const manifest = await this.fetchManifest();
+        if (!manifest)
+            return [];
+        // Try to extract image URLs from the manifest
+        if (this.getIIIFVersion(manifest) == 3)
+            return this.extractIiif3ImageUrls(manifest);
+        return this.extractIiif2ImageUrls(manifest);
+    }
+    // Attempt to fetch and parse the IIIF manifest, if any
+    async fetchManifest() {
+        if (this.manifest)
+            return this.manifest;
+        const response = await fetchOrThrow(this.url);
+        const manifest = await response.json();
+        this.manifest = manifest;
+        return manifest;
+    }
+    // Get the IIIF presentation spec version of the manifest
+    getIIIFVersion(manifest) {
+        return manifest['@context']?.includes('http://iiif.io/api/presentation/3/context.json') ? 3 : 2;
+    }
+    // Given a v2 manifest, extract all of the IIIF images and format as info.json URLs
+    extractIiif2ImageUrls(manifest) {
+        return (manifest.sequences
+            .flatMap(seq => seq.canvases)
+            .flatMap(can => can.images)
+            .flatMap(img => img.resource)
+            //@ts-ignore
+            .flatMap(res => (res['@type'] === 'dctypes:Image' ? res.service['@id'] + '/info.json' : [])));
+    }
+    // Given a v3 manifest, extract all of the IIIF images and format as info.json URLs
+    extractIiif3ImageUrls(manifest) {
+        // Recursively search the '.items' key until we end up with nodes that have type 'ImageService2'
+        return (manifest.items
+            .flatMap(canvas => canvas.items)
+            .flatMap(annotationPage => annotationPage?.items || [])
+            .flatMap(annotation => (Array.isArray(annotation.body) ? annotation.body : [annotation.body]))
+            //@ts-ignore
+            .flatMap(annotationBody => annotationBody.service)
+            .flatMap(service => service.id + '/info.json'));
+    }
+}

package/dist/collection/lib/sources/iiif-manifest.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, vi, afterEach } from "@stencil/vitest";
+import IIIFManifestSource from "./iiif-manifest";
+const MANIFEST_URL = 'http://example.com/manifest.json';
+// A source always points at a manifest URL; the manifest itself is fetched lazily
+const createSource = () => new IIIFManifestSource('test-id', MANIFEST_URL);
+// A minimal IIIF v2 manifest with a single image
+const v2Manifest = {
+    '@context': 'http://iiif.io/api/presentation/2/context.json',
+    '@id': MANIFEST_URL,
+    '@type': 'sc:Manifest',
+    'sequences': [
+        {
+            canvases: [
+                {
+                    images: [
+                        {
+                            resource: {
+                                '@id': 'http://example.com/image1/full/full/0/default.jpg',
+                                '@type': 'dctypes:Image',
+                                'service': {
+                                    '@id': 'http://example.com/image1',
+                                },
+                            },
+                        },
+                    ],
+                },
+            ],
+        },
+    ],
+};
+// A minimal IIIF v3 manifest with a single image
+const v3Manifest = {
+    '@context': 'http://iiif.io/api/presentation/3/context.json',
+    'id': MANIFEST_URL,
+    'type': 'Manifest',
+    'items': [
+        {
+            id: 'http://example.com/canvas1',
+            type: 'Canvas',
+            items: [
+                {
+                    id: 'http://example.com/annotationpage1',
+                    type: 'AnnotationPage',
+                    items: [
+                        {
+                            id: 'http://example.com/annotation1',
+                            type: 'Annotation',
+                            body: {
+                                id: 'http://example.com/image1/full/full/0/default.jpg',
+                                type: 'Image',
+                                service: {
+                                    id: 'http://example.com/image1',
+                                    type: 'ImageService2',
+                                },
+                            },
+                        },
+                    ],
+                },
+            ],
+        },
+    ],
+};
+describe('IIIFManifestSource', () => {
+    afterEach(() => vi.restoreAllMocks());
+    describe('getIIIFImageUrls', () => {
+        it('should fetch and extract image URLs from a IIIF v2 manifest', async () => {
+            const fetchSpy = vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(v2Manifest)));
+            const urls = await createSource().getIIIFImageUrls();
+            expect(fetchSpy.mock.calls[0][0]).toBe(MANIFEST_URL);
+            expect(urls).toEqual(['http://example.com/image1/info.json']);
+        });
+        it('should fetch and extract image URLs from a IIIF v3 manifest', async () => {
+            const fetchSpy = vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(v3Manifest)));
+            const urls = await createSource().getIIIFImageUrls();
+            expect(fetchSpy.mock.calls[0][0]).toBe(MANIFEST_URL);
+            expect(urls).toEqual(['http://example.com/image1/info.json']);
+        });
+        it('should not fetch the manifest again if already cached', async () => {
+            const fetchSpy = vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(v2Manifest)));
+            const source = createSource();
+            const urls1 = await source.getIIIFImageUrls();
+            const urls2 = await source.getIIIFImageUrls();
+            expect(fetchSpy).toHaveBeenCalledTimes(1);
+            expect(urls1).toEqual(['http://example.com/image1/info.json']);
+            expect(urls2).toEqual(['http://example.com/image1/info.json']);
+        });
+        it('should return an empty array if the manifest has no items', async () => {
+            const manifest = { ...v3Manifest, items: [] };
+            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(manifest)));
+            const urls = await createSource().getIIIFImageUrls();
+            expect(urls).toEqual([]);
+        });
+        it('should throw if the manifest fetch fails', async () => {
+            vi.spyOn(global, 'fetch').mockRejectedValueOnce(new Error('Network error'));
+            await expect(createSource().getIIIFImageUrls()).rejects.toThrow('Network error');
+        });
+        it('should throw an HttpError if the manifest response is not ok', async () => {
+            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response('Not found', { status: 404, statusText: 'Not Found' }));
+            await expect(createSource().getIIIFImageUrls()).rejects.toMatchObject({ name: 'HttpError', status: 404 });
+        });
+        it('should throw if the manifest is not valid JSON', async () => {
+            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response('invalid json'));
+            await expect(createSource().getIIIFImageUrls()).rejects.toThrow();
+        });
+        it('should throw if the manifest does not match the IIIF spec', async () => {
+            vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify({ unexpected: 'structure' })));
+            await expect(createSource().getIIIFImageUrls()).rejects.toThrow();
+        });
+    });
+});